export interface ConnectionConfig {
  endpoint: string;
  atespace: string;
  token?: string;
  timeoutMs: number;
  maxBytes: number;
}

export interface CallOptions {
  signal?: AbortSignal;
  timeoutMs?: number;
}

export interface Environment {
  id: string;
  atespace: string;
  status: string;
}

export interface RemoteProcess {
  processId: string;
  status: string;
  exitCode: number;
}

export interface OutputChunk {
  source: "stdout" | "stderr";
  data: Buffer;
}

export interface ProcessOutput {
  stdout: string;
  stderr: string;
  stdoutOffset: number;
  stderrOffset: number;
  truncated: boolean;
}

export interface ProcessRequest {
  command: string[];
  cwd?: string;
  env?: Record<string, string>;
}

export interface SubstrateTransport {
  create(id: string, template?: { name: string; atespace: string }, options?: CallOptions): Promise<Environment>;
  get(id: string, options?: CallOptions): Promise<Environment>;
  suspend(id: string, options?: CallOptions): Promise<void>;
  delete(id: string, options?: CallOptions): Promise<void>;
  start(id: string, request: ProcessRequest, options?: CallOptions): Promise<string>;
  process(id: string, processId: string, options?: CallOptions): Promise<RemoteProcess>;
  kill(id: string, processId: string, options?: CallOptions): Promise<number>;
  outputs(id: string, processId: string, request?: { follow?: boolean; stdoutOffset?: number; stderrOffset?: number }, options?: CallOptions): Promise<ProcessOutput>;
  read(id: string, path: string, options?: CallOptions): Promise<Buffer>;
  write(id: string, path: string, content: Buffer, options?: CallOptions): Promise<number>;
  close(): void;
}

export interface WorkspaceBinding {
  version: 1;
  sessionId: string;
  endpoint: string;
  atespace: string;
  environmentId: string;
  processIds: string[];
  uncertain: boolean;
}

export interface WorkspaceOptions {
  sessionId: string;
  endpoint: string;
  atespace: string;
  idleMs: number;
  persist(binding: WorkspaceBinding | null): void;
  notify(message: string, level: "info" | "warning" | "error"): void;
  changed(binding: WorkspaceBinding | null): void;
}