@stacknet/stacks 0.2.0 → 0.2.2

package/src/clients/coder.ts

@@ -1,655 +0,0 @@
-/**
- * Coder Client
- * Client for interacting with the GeoffCoder AI coding agent API
- */
-
-import { DEFAULT_TASK_NETWORK_URL, JSON_HEADERS, SSE_HEADERS } from '../utils/constants';
-import { StacksSDKError } from '../utils/errors';
-import type {
-  CoderClientConfig,
-  CoderSession,
-  CoderSessionResponse,
-  CoderSessionsListResponse,
-  CoderExecuteRequest,
-  CoderExecuteResponse,
-  CoderStreamEvent,
-  CoderTool,
-  CoderToolsResponse,
-  CoderFileInfo,
-  CoderFileContent,
-  CoderFileWriteInput,
-  CoderFilesResponse,
-  CoderSearchResult,
-  CoderDiffInput,
-  CoderCommandInput,
-  CoderCommandResult,
-  CoderSandbox,
-  CoderSandboxCreateInput,
-  CoderSandboxResponse,
-  CoderSandboxExecInput,
-  CoderSandboxExecResult,
-  CoderToolResult,
-} from '../types/coder';
-
-export type { CoderClientConfig } from '../types/coder';
-
-export class CoderClient {
-  private baseUrl: string;
-  private apiKey?: string;
-  private timeout: number;
-  private defaultModel: string;
-  private defaultMaxIterations: number;
-
-  constructor(config: CoderClientConfig = {}) {
-    this.baseUrl = config.baseUrl || DEFAULT_TASK_NETWORK_URL;
-    this.apiKey = config.apiKey;
-    this.timeout = config.timeout || 300000; // 5 minutes default
-    this.defaultModel = config.defaultModel || 'geoff-code-1:1';
-    this.defaultMaxIterations = config.defaultMaxIterations || 20;
-  }
-
-  private get coderUrl(): string {
-    return `${this.baseUrl}/coder`;
-  }
-
-  private get headers(): HeadersInit {
-    const headers: HeadersInit = { ...JSON_HEADERS };
-    if (this.apiKey) {
-      headers['Authorization'] = `Bearer ${this.apiKey}`;
-    }
-    return headers;
-  }
-
-  // ============================================================================
-  // Session Management
-  // ============================================================================
-
-  /**
-   * Create a new coder session
-   */
-  async createSession(workingDirectory: string, sandboxConfig?: CoderSandboxCreateInput): Promise<CoderSession> {
-    const response = await fetch(`${this.coderUrl}/sessions`, {
-      method: 'POST',
-      headers: this.headers,
-      body: JSON.stringify({
-        workingDirectory,
-        sandbox: sandboxConfig,
-      }),
-    });
-
-    if (!response.ok) {
-      const data = await response.json().catch(() => ({}));
-      throw new StacksSDKError(
-        'bad_request:api',
-        data.error || `Failed to create coder session: ${response.statusText}`
-      );
-    }
-
-    const result: CoderSessionResponse = await response.json();
-    return result.session;
-  }
-
-  /**
-   * Get a session by ID
-   */
-  async getSession(sessionId: string): Promise<CoderSession> {
-    const response = await fetch(`${this.coderUrl}/sessions/${sessionId}`, {
-      headers: this.headers,
-    });
-
-    if (!response.ok) {
-      throw new StacksSDKError(
-        response.status === 404 ? 'not_found:api' : 'bad_request:api',
-        `Failed to get coder session: ${response.statusText}`
-      );
-    }
-
-    const result: CoderSessionResponse = await response.json();
-    return result.session;
-  }
-
-  /**
-   * List all sessions
-   */
-  async listSessions(options: { status?: string; limit?: number } = {}): Promise<CoderSession[]> {
-    const params = new URLSearchParams();
-    if (options.status) params.set('status', options.status);
-    if (options.limit) params.set('limit', options.limit.toString());
-
-    const queryString = params.toString();
-    const url = `${this.coderUrl}/sessions${queryString ? `?${queryString}` : ''}`;
-
-    const response = await fetch(url, { headers: this.headers });
-
-    if (!response.ok) {
-      throw new StacksSDKError(
-        'bad_request:api',
-        `Failed to list coder sessions: ${response.statusText}`
-      );
-    }
-
-    const result: CoderSessionsListResponse = await response.json();
-    return result.sessions;
-  }
-
-  /**
-   * Abort a running session
-   */
-  async abortSession(sessionId: string): Promise<CoderSession> {
-    const response = await fetch(`${this.coderUrl}/sessions/${sessionId}/abort`, {
-      method: 'POST',
-      headers: this.headers,
-    });
-
-    if (!response.ok) {
-      throw new StacksSDKError(
-        'bad_request:api',
-        `Failed to abort coder session: ${response.statusText}`
-      );
-    }
-
-    const result: CoderSessionResponse = await response.json();
-    return result.session;
-  }
-
-  // ============================================================================
-  // Execution
-  // ============================================================================
-
-  /**
-   * Execute a coder prompt (non-streaming)
-   */
-  async execute(request: CoderExecuteRequest): Promise<CoderExecuteResponse> {
-    const payload = {
-      prompt: request.prompt,
-      workingDirectory: request.workingDirectory,
-      maxIterations: request.maxIterations || this.defaultMaxIterations,
-      model: request.model || this.defaultModel,
-      maxTokens: request.maxTokens,
-      temperature: request.temperature,
-      sessionId: request.sessionId,
-      sandboxId: request.sandboxId,
-      sandbox: request.sandbox,
-      stream: false,
-    };
-
-    const response = await fetch(`${this.coderUrl}/execute`, {
-      method: 'POST',
-      headers: this.headers,
-      body: JSON.stringify(payload),
-      signal: AbortSignal.timeout(this.timeout),
-    });
-
-    if (!response.ok) {
-      const data = await response.json().catch(() => ({}));
-      throw new StacksSDKError(
-        'bad_request:api',
-        data.error || `Failed to execute coder: ${response.statusText}`
-      );
-    }
-
-    return response.json();
-  }
-
-  /**
-   * Execute a coder prompt with streaming
-   */
-  async *executeStream(request: CoderExecuteRequest): AsyncGenerator<CoderStreamEvent, void, unknown> {
-    const payload = {
-      prompt: request.prompt,
-      workingDirectory: request.workingDirectory,
-      maxIterations: request.maxIterations || this.defaultMaxIterations,
-      model: request.model || this.defaultModel,
-      maxTokens: request.maxTokens,
-      temperature: request.temperature,
-      sessionId: request.sessionId,
-      sandboxId: request.sandboxId,
-      sandbox: request.sandbox,
-      stream: true,
-    };
-
-    // Use abort controller with longer timeout for SSE streams
-    const controller = new AbortController();
-    const timeoutId = setTimeout(() => controller.abort(), this.timeout);
-
-    const response = await fetch(`${this.coderUrl}/execute`, {
-      method: 'POST',
-      headers: {
-        ...this.headers,
-        'Accept': 'text/event-stream',
-        'Connection': 'keep-alive',
-        'Cache-Control': 'no-cache',
-      },
-      body: JSON.stringify(payload),
-      signal: controller.signal,
-      // @ts-ignore - undici-specific option for keep-alive
-      keepalive: true,
-    });
-
-    if (!response.ok) {
-      const data = await response.json().catch(() => ({}));
-      throw new StacksSDKError(
-        'bad_request:api',
-        data.error || `Failed to execute coder stream: ${response.statusText}`
-      );
-    }
-
-    const reader = response.body?.getReader();
-    if (!reader) {
-      throw new StacksSDKError('bad_request:stream', 'No response body');
-    }
-
-    const decoder = new TextDecoder();
-    let buffer = '';
-
-    try {
-      while (true) {
-        const { done, value } = await reader.read();
-        if (done) break;
-
-        buffer += decoder.decode(value, { stream: true });
-        const lines = buffer.split('\n');
-        buffer = lines.pop() || '';
-
-        for (const line of lines) {
-          if (line.startsWith('data: ')) {
-            const data = line.slice(6);
-            if (data === '[DONE]') return;
-
-            try {
-              const event: CoderStreamEvent = JSON.parse(data);
-              yield event;
-            } catch {
-              // Skip malformed JSON
-            }
-          }
-        }
-      }
-    } finally {
-      clearTimeout(timeoutId);
-      reader.releaseLock();
-    }
-  }
-
-  // ============================================================================
-  // Tool Operations (Direct tool calls without agentic loop)
-  // ============================================================================
-
-  /**
-   * Get available coder tools
-   */
-  async getTools(): Promise<CoderTool[]> {
-    const response = await fetch(`${this.coderUrl}/tools`, {
-      headers: this.headers,
-    });
-
-    if (!response.ok) {
-      throw new StacksSDKError(
-        'bad_request:api',
-        `Failed to get coder tools: ${response.statusText}`
-      );
-    }
-
-    const result: CoderToolsResponse = await response.json();
-    return result.tools;
-  }
-
-  /**
-   * Execute a specific tool directly
-   */
-  async callTool(
-    toolName: string,
-    args: Record<string, unknown>,
-    options: { sessionId?: string; sandboxId?: string } = {}
-  ): Promise<CoderToolResult> {
-    const response = await fetch(`${this.coderUrl}/tools/${toolName}`, {
-      method: 'POST',
-      headers: this.headers,
-      body: JSON.stringify({
-        arguments: args,
-        sessionId: options.sessionId,
-        sandboxId: options.sandboxId,
-      }),
-    });
-
-    if (!response.ok) {
-      const data = await response.json().catch(() => ({}));
-      throw new StacksSDKError(
-        'bad_request:api',
-        data.error || `Failed to call tool ${toolName}: ${response.statusText}`
-      );
-    }
-
-    return response.json();
-  }
-
-  // ============================================================================
-  // File Operations
-  // ============================================================================
-
-  /**
-   * Read a file
-   */
-  async readFile(path: string, options: { sessionId?: string; sandboxId?: string } = {}): Promise<CoderFileContent> {
-    const params = new URLSearchParams({ path });
-    if (options.sessionId) params.set('sessionId', options.sessionId);
-    if (options.sandboxId) params.set('sandboxId', options.sandboxId);
-
-    const response = await fetch(`${this.coderUrl}/files/read?${params}`, {
-      headers: this.headers,
-    });
-
-    if (!response.ok) {
-      throw new StacksSDKError(
-        response.status === 404 ? 'not_found:api' : 'bad_request:api',
-        `Failed to read file: ${response.statusText}`
-      );
-    }
-
-    return response.json();
-  }
-
-  /**
-   * Write a file
-   */
-  async writeFile(
-    input: CoderFileWriteInput,
-    options: { sessionId?: string; sandboxId?: string } = {}
-  ): Promise<{ success: boolean; path: string }> {
-    const response = await fetch(`${this.coderUrl}/files/write`, {
-      method: 'POST',
-      headers: this.headers,
-      body: JSON.stringify({
-        ...input,
-        sessionId: options.sessionId,
-        sandboxId: options.sandboxId,
-      }),
-    });
-
-    if (!response.ok) {
-      const data = await response.json().catch(() => ({}));
-      throw new StacksSDKError(
-        'bad_request:api',
-        data.error || `Failed to write file: ${response.statusText}`
-      );
-    }
-
-    return response.json();
-  }
-
-  /**
-   * List files in a directory
-   */
-  async listFiles(
-    path: string,
-    options: { recursive?: boolean; maxDepth?: number; sessionId?: string; sandboxId?: string } = {}
-  ): Promise<CoderFileInfo[]> {
-    const params = new URLSearchParams({ path });
-    if (options.recursive) params.set('recursive', 'true');
-    if (options.maxDepth) params.set('maxDepth', options.maxDepth.toString());
-    if (options.sessionId) params.set('sessionId', options.sessionId);
-    if (options.sandboxId) params.set('sandboxId', options.sandboxId);
-
-    const response = await fetch(`${this.coderUrl}/files/list?${params}`, {
-      headers: this.headers,
-    });
-
-    if (!response.ok) {
-      throw new StacksSDKError(
-        'bad_request:api',
-        `Failed to list files: ${response.statusText}`
-      );
-    }
-
-    const result: CoderFilesResponse = await response.json();
-    return result.files;
-  }
-
-  /**
-   * Search for patterns in files
-   */
-  async searchFiles(
-    pattern: string,
-    options: { path?: string; filePattern?: string; sessionId?: string; sandboxId?: string } = {}
-  ): Promise<CoderSearchResult[]> {
-    const params = new URLSearchParams({ pattern });
-    if (options.path) params.set('path', options.path);
-    if (options.filePattern) params.set('filePattern', options.filePattern);
-    if (options.sessionId) params.set('sessionId', options.sessionId);
-    if (options.sandboxId) params.set('sandboxId', options.sandboxId);
-
-    const response = await fetch(`${this.coderUrl}/files/search?${params}`, {
-      headers: this.headers,
-    });
-
-    if (!response.ok) {
-      throw new StacksSDKError(
-        'bad_request:api',
-        `Failed to search files: ${response.statusText}`
-      );
-    }
-
-    const result: { results: CoderSearchResult[] } = await response.json();
-    return result.results;
-  }
-
-  /**
-   * Apply a diff to a file
-   */
-  async applyDiff(
-    input: CoderDiffInput,
-    options: { sessionId?: string; sandboxId?: string } = {}
-  ): Promise<{ success: boolean; changes: number }> {
-    const response = await fetch(`${this.coderUrl}/files/diff`, {
-      method: 'POST',
-      headers: this.headers,
-      body: JSON.stringify({
-        ...input,
-        sessionId: options.sessionId,
-        sandboxId: options.sandboxId,
-      }),
-    });
-
-    if (!response.ok) {
-      const data = await response.json().catch(() => ({}));
-      throw new StacksSDKError(
-        'bad_request:api',
-        data.error || `Failed to apply diff: ${response.statusText}`
-      );
-    }
-
-    return response.json();
-  }
-
-  // ============================================================================
-  // Command Execution
-  // ============================================================================
-
-  /**
-   * Execute a shell command
-   */
-  async executeCommand(
-    input: CoderCommandInput,
-    options: { sessionId?: string; sandboxId?: string } = {}
-  ): Promise<CoderCommandResult> {
-    const response = await fetch(`${this.coderUrl}/exec`, {
-      method: 'POST',
-      headers: this.headers,
-      body: JSON.stringify({
-        ...input,
-        sessionId: options.sessionId,
-        sandboxId: options.sandboxId,
-      }),
-    });
-
-    if (!response.ok) {
-      const data = await response.json().catch(() => ({}));
-      throw new StacksSDKError(
-        'bad_request:api',
-        data.error || `Failed to execute command: ${response.statusText}`
-      );
-    }
-
-    return response.json();
-  }
-
-  /**
-   * Execute a command with streaming output
-   */
-  async *executeCommandStream(
-    input: CoderCommandInput,
-    options: { sessionId?: string; sandboxId?: string } = {}
-  ): AsyncGenerator<{ type: 'stdout' | 'stderr' | 'exit'; content: string; exitCode?: number }, void, unknown> {
-    const response = await fetch(`${this.coderUrl}/exec/stream`, {
-      method: 'POST',
-      headers: {
-        ...this.headers,
-        'Accept': 'text/event-stream',
-      },
-      body: JSON.stringify({
-        ...input,
-        sessionId: options.sessionId,
-        sandboxId: options.sandboxId,
-      }),
-    });
-
-    if (!response.ok) {
-      const data = await response.json().catch(() => ({}));
-      throw new StacksSDKError(
-        'bad_request:api',
-        data.error || `Failed to execute command stream: ${response.statusText}`
-      );
-    }
-
-    const reader = response.body?.getReader();
-    if (!reader) {
-      throw new StacksSDKError('bad_request:stream', 'No response body');
-    }
-
-    const decoder = new TextDecoder();
-    let buffer = '';
-
-    try {
-      while (true) {
-        const { done, value } = await reader.read();
-        if (done) break;
-
-        buffer += decoder.decode(value, { stream: true });
-        const lines = buffer.split('\n');
-        buffer = lines.pop() || '';
-
-        for (const line of lines) {
-          if (line.startsWith('data: ')) {
-            const data = line.slice(6);
-            if (data === '[DONE]') return;
-
-            try {
-              yield JSON.parse(data);
-            } catch {
-              // Skip malformed JSON
-            }
-          }
-        }
-      }
-    } finally {
-      reader.releaseLock();
-    }
-  }
-
-  // ============================================================================
-  // Sandbox Management
-  // ============================================================================
-
-  /**
-   * Create a new sandbox
-   */
-  async createSandbox(input: CoderSandboxCreateInput = {}): Promise<CoderSandbox> {
-    const response = await fetch(`${this.coderUrl}/sandbox`, {
-      method: 'POST',
-      headers: this.headers,
-      body: JSON.stringify(input),
-    });
-
-    if (!response.ok) {
-      const data = await response.json().catch(() => ({}));
-      throw new StacksSDKError(
-        'bad_request:api',
-        data.error || `Failed to create sandbox: ${response.statusText}`
-      );
-    }
-
-    const result: CoderSandboxResponse = await response.json();
-    return result.sandbox;
-  }
-
-  /**
-   * Get sandbox status
-   */
-  async getSandbox(sandboxId: string): Promise<CoderSandbox> {
-    const response = await fetch(`${this.coderUrl}/sandbox/${sandboxId}`, {
-      headers: this.headers,
-    });
-
-    if (!response.ok) {
-      throw new StacksSDKError(
-        response.status === 404 ? 'not_found:api' : 'bad_request:api',
-        `Failed to get sandbox: ${response.statusText}`
-      );
-    }
-
-    const result: CoderSandboxResponse = await response.json();
-    return result.sandbox;
-  }
-
-  /**
-   * Execute code in a sandbox
-   */
-  async sandboxExec(sandboxId: string, input: CoderSandboxExecInput): Promise<CoderSandboxExecResult> {
-    const response = await fetch(`${this.coderUrl}/sandbox/${sandboxId}/exec`, {
-      method: 'POST',
-      headers: this.headers,
-      body: JSON.stringify(input),
-    });
-
-    if (!response.ok) {
-      const data = await response.json().catch(() => ({}));
-      throw new StacksSDKError(
-        'bad_request:api',
-        data.error || `Failed to execute in sandbox: ${response.statusText}`
-      );
-    }
-
-    return response.json();
-  }
-
-  /**
-   * Destroy a sandbox
-   */
-  async destroySandbox(sandboxId: string): Promise<{ success: boolean }> {
-    const response = await fetch(`${this.coderUrl}/sandbox/${sandboxId}`, {
-      method: 'DELETE',
-      headers: this.headers,
-    });
-
-    if (!response.ok) {
-      throw new StacksSDKError(
-        'bad_request:api',
-        `Failed to destroy sandbox: ${response.statusText}`
-      );
-    }
-
-    return response.json();
-  }
-}
-
-/**
- * Create a CoderClient instance
- */
-export function createCoderClient(config: CoderClientConfig = {}): CoderClient {
-  return new CoderClient(config);
-}
-
-/**
- * Default coder client instance
- */
-export const coderClient = createCoderClient();