thinkwell 0.1.0

package/README.md

@@ -0,0 +1,30 @@
+<p>
+  <img src="assets/logo.jpg" alt="Thinkwell Logo" width="200">
+</p>
+
+A TypeScript library for easy scripting of AI agents. Thinkwell provides a fluent API for blending deterministic code with LLM-powered reasoning.
+
+## Quick Start
+
+```typescript
+import { Agent, schemaOf } from "thinkwell";
+
+const agent = await Agent.connect("npx -y @zed-industries/claude-code-acp");
+
+const result = await agent
+  .think(schemaOf<{ greeting: string }>({
+    type: "object",
+    properties: { greeting: { type: "string" } },
+    required: ["greeting"]
+  }))
+  .text("Say hello!")
+  .run();
+
+console.log(result.greeting);
+
+agent.close();
+```
+
+# License
+
+MIT

package/dist/agent.d.ts

@@ -0,0 +1,188 @@
+import { type ChildProcess } from "node:child_process";
+import { ClientSideConnection } from "@agentclientprotocol/sdk";
+import { McpOverAcpHandler, type SchemaProvider, type SessionUpdate } from "@thinkwell/acp";
+import { ThinkBuilder } from "./think-builder.js";
+import { Session } from "./session.js";
+/**
+ * Options for connecting to an agent
+ */
+export interface ConnectOptions {
+    /**
+     * Path to the conductor binary.
+     * If not specified, uses SACP_CONDUCTOR_PATH env var or searches PATH.
+     */
+    conductorPath?: string;
+    /**
+     * Environment variables for the agent process
+     */
+    env?: Record<string, string>;
+    /**
+     * Connection timeout in milliseconds
+     */
+    timeout?: number;
+}
+/**
+ * Options for creating a session
+ */
+export interface SessionOptions {
+    /**
+     * Working directory for the session
+     */
+    cwd?: string;
+    /**
+     * System prompt for the session
+     */
+    systemPrompt?: string;
+}
+/**
+ * Interface for handling session updates
+ * @internal
+ */
+export interface SessionHandler {
+    pushUpdate(update: SessionUpdate): void;
+}
+/**
+ * Internal connection state shared between Agent and Session
+ * @internal
+ */
+export interface AgentConnection {
+    process: ChildProcess;
+    connection: ClientSideConnection;
+    mcpHandler: McpOverAcpHandler;
+    sessionHandlers: Map<string, SessionHandler>;
+    initialized: boolean;
+}
+/**
+ * The main entry point for Patchwork.
+ *
+ * Agent represents a connection to an AI agent (like Claude Code) and provides
+ * a fluent API for blending deterministic code with LLM-powered reasoning.
+ *
+ * @example Simple usage with ephemeral sessions
+ * ```typescript
+ * import { Agent, schemaOf } from "@anthropic/patchwork";
+ *
+ * const agent = await Agent.connect("npx -y @zed-industries/claude-code-acp");
+ *
+ * const summary = await agent
+ *   .think(schemaOf<{ title: string; points: string[] }>({
+ *     type: "object",
+ *     properties: {
+ *       title: { type: "string" },
+ *       points: { type: "array", items: { type: "string" } }
+ *     },
+ *     required: ["title", "points"]
+ *   }))
+ *   .text("Summarize this document:")
+ *   .quote(document)
+ *   .run();
+ *
+ * agent.close();
+ * ```
+ *
+ * @example Multi-turn conversation with explicit session
+ * ```typescript
+ * const agent = await Agent.connect("npx -y @zed-industries/claude-code-acp");
+ * const session = await agent.createSession({ cwd: "/my/project" });
+ *
+ * const analysis = await session
+ *   .think(AnalysisSchema)
+ *   .text("Analyze this codebase")
+ *   .run();
+ *
+ * // Same session - agent remembers context
+ * const fixes = await session
+ *   .think(FixesSchema)
+ *   .text("Suggest fixes for the top issues")
+ *   .run();
+ *
+ * session.close();
+ * agent.close();
+ * ```
+ */
+export declare class Agent {
+    private readonly _conn;
+    private constructor();
+    /**
+     * Connect to an agent.
+     *
+     * @param command - The command to spawn the agent process (e.g., "npx -y @zed-industries/claude-code-acp")
+     * @param options - Connection options
+     * @returns A connected Agent instance
+     *
+     * @example
+     * ```typescript
+     * const agent = await Agent.connect("npx -y @zed-industries/claude-code-acp");
+     * ```
+     */
+    static connect(command: string, options?: ConnectOptions): Promise<Agent>;
+    /**
+     * Create a new think builder for constructing a prompt with tools.
+     *
+     * Each call to `think()` creates an ephemeral session that is automatically
+     * closed when the prompt completes. For multi-turn conversations, use
+     * `createSession()` instead.
+     *
+     * @param schema - A SchemaProvider that defines the expected output structure
+     *
+     * @example
+     * ```typescript
+     * const result = await agent
+     *   .think(schemaOf<{ answer: string }>({
+     *     type: "object",
+     *     properties: { answer: { type: "string" } },
+     *     required: ["answer"]
+     *   }))
+     *   .text("What is 2 + 2?")
+     *   .run();
+     * ```
+     */
+    think<Output>(schema: SchemaProvider<Output>): ThinkBuilder<Output>;
+    /**
+     * Create a new think builder without a schema.
+     *
+     * @deprecated Use `think(schemaOf<T>(schema))` instead to provide a typed schema.
+     */
+    think<Output>(): ThinkBuilder<Output>;
+    /**
+     * Create a new session for multi-turn conversations.
+     *
+     * Sessions maintain conversation context across multiple `think()` calls,
+     * allowing the agent to remember previous interactions.
+     *
+     * @param options - Session configuration options
+     * @returns A Session instance
+     *
+     * @example
+     * ```typescript
+     * const session = await agent.createSession({ cwd: "/my/project" });
+     *
+     * // First turn
+     * const result1 = await session.think(Schema1).text("...").run();
+     *
+     * // Second turn - agent remembers context
+     * const result2 = await session.think(Schema2).text("...").run();
+     *
+     * session.close();
+     * ```
+     */
+    createSession(options?: SessionOptions): Promise<Session>;
+    /**
+     * Close the connection to the agent.
+     *
+     * This terminates the conductor process. Any active sessions will be
+     * invalidated.
+     */
+    close(): void;
+    /**
+     * Get the internal connection for use by ThinkBuilder
+     * @internal
+     */
+    get _connection(): AgentConnection;
+    /**
+     * Initialize the connection (negotiate protocol version)
+     * @internal
+     */
+    _initialize(): Promise<void>;
+}
+//# sourceMappingURL=agent.d.ts.map

package/dist/agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAE9D,OAAO,EACL,oBAAoB,EAWrB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,iBAAiB,EACjB,KAAK,cAAc,EACnB,KAAK,aAAa,EACnB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE7B;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,UAAU,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAAC;CACzC;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,YAAY,CAAC;IACtB,UAAU,EAAE,oBAAoB,CAAC;IACjC,UAAU,EAAE,iBAAiB,CAAC;IAC9B,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAC7C,WAAW,EAAE,OAAO,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AACH,qBAAa,KAAK;IAChB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAkB;IAExC,OAAO;IAIP;;;;;;;;;;;OAWG;WACU,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,KAAK,CAAC;IAiD/E;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,cAAc,CAAC,MAAM,CAAC,GAAG,YAAY,CAAC,MAAM,CAAC;IAEnE;;;;OAIG;IACH,KAAK,CAAC,MAAM,KAAK,YAAY,CAAC,MAAM,CAAC;IAMrC;;;;;;;;;;;;;;;;;;;;;OAqBG;IACG,aAAa,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC;IAY/D;;;;;OAKG;IACH,KAAK,IAAI,IAAI;IAIb;;;OAGG;IACH,IAAI,WAAW,IAAI,eAAe,CAEjC;IAED;;;OAGG;IACG,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;CAUnC"}

package/dist/agent.js

@@ -0,0 +1,298 @@
+import { spawn } from "node:child_process";
+import { ClientSideConnection, ndJsonStream, } from "@agentclientprotocol/sdk";
+import { McpOverAcpHandler, } from "@thinkwell/acp";
+import { ThinkBuilder } from "./think-builder.js";
+import { Session } from "./session.js";
+/**
+ * The main entry point for Patchwork.
+ *
+ * Agent represents a connection to an AI agent (like Claude Code) and provides
+ * a fluent API for blending deterministic code with LLM-powered reasoning.
+ *
+ * @example Simple usage with ephemeral sessions
+ * ```typescript
+ * import { Agent, schemaOf } from "@anthropic/patchwork";
+ *
+ * const agent = await Agent.connect("npx -y @zed-industries/claude-code-acp");
+ *
+ * const summary = await agent
+ *   .think(schemaOf<{ title: string; points: string[] }>({
+ *     type: "object",
+ *     properties: {
+ *       title: { type: "string" },
+ *       points: { type: "array", items: { type: "string" } }
+ *     },
+ *     required: ["title", "points"]
+ *   }))
+ *   .text("Summarize this document:")
+ *   .quote(document)
+ *   .run();
+ *
+ * agent.close();
+ * ```
+ *
+ * @example Multi-turn conversation with explicit session
+ * ```typescript
+ * const agent = await Agent.connect("npx -y @zed-industries/claude-code-acp");
+ * const session = await agent.createSession({ cwd: "/my/project" });
+ *
+ * const analysis = await session
+ *   .think(AnalysisSchema)
+ *   .text("Analyze this codebase")
+ *   .run();
+ *
+ * // Same session - agent remembers context
+ * const fixes = await session
+ *   .think(FixesSchema)
+ *   .text("Suggest fixes for the top issues")
+ *   .run();
+ *
+ * session.close();
+ * agent.close();
+ * ```
+ */
+export class Agent {
+    _conn;
+    constructor(conn) {
+        this._conn = conn;
+    }
+    /**
+     * Connect to an agent.
+     *
+     * @param command - The command to spawn the agent process (e.g., "npx -y @zed-industries/claude-code-acp")
+     * @param options - Connection options
+     * @returns A connected Agent instance
+     *
+     * @example
+     * ```typescript
+     * const agent = await Agent.connect("npx -y @zed-industries/claude-code-acp");
+     * ```
+     */
+    static async connect(command, options) {
+        const conductorPath = findConductor(options?.conductorPath);
+        const conductorArgs = ["agent", command];
+        const childProcess = spawn(conductorPath, conductorArgs, {
+            stdio: ["pipe", "pipe", "pipe"],
+            env: options?.env ? { ...process.env, ...options.env } : process.env,
+        });
+        if (!childProcess.stdout || !childProcess.stdin) {
+            throw new Error("Conductor process must have stdio");
+        }
+        // Log stderr for debugging
+        childProcess.stderr?.on("data", (data) => {
+            console.error("[conductor stderr]", data.toString());
+        });
+        // Convert Node streams to Web streams for the SDK
+        const { readable, writable } = nodeToWebStreams(childProcess.stdout, childProcess.stdin);
+        // Create the ndjson stream
+        const stream = ndJsonStream(writable, readable);
+        // Create the MCP handler
+        const mcpHandler = new McpOverAcpHandler();
+        // Build the connection state
+        const conn = {
+            process: childProcess,
+            connection: null, // Set below after creating the client
+            mcpHandler,
+            sessionHandlers: new Map(),
+            initialized: false,
+        };
+        // Create the ACP client connection
+        const clientConnection = new ClientSideConnection((_agent) => createClient(conn, mcpHandler), stream);
+        conn.connection = clientConnection;
+        return new Agent(conn);
+    }
+    think(schema) {
+        return new ThinkBuilder(this._conn, schema);
+    }
+    /**
+     * Create a new session for multi-turn conversations.
+     *
+     * Sessions maintain conversation context across multiple `think()` calls,
+     * allowing the agent to remember previous interactions.
+     *
+     * @param options - Session configuration options
+     * @returns A Session instance
+     *
+     * @example
+     * ```typescript
+     * const session = await agent.createSession({ cwd: "/my/project" });
+     *
+     * // First turn
+     * const result1 = await session.think(Schema1).text("...").run();
+     *
+     * // Second turn - agent remembers context
+     * const result2 = await session.think(Schema2).text("...").run();
+     *
+     * session.close();
+     * ```
+     */
+    async createSession(options) {
+        await this._initialize();
+        const request = {
+            cwd: options?.cwd ?? process.cwd(),
+            mcpServers: [],
+        };
+        const response = await this._conn.connection.newSession(request);
+        return new Session(this._conn, response.sessionId, options);
+    }
+    /**
+     * Close the connection to the agent.
+     *
+     * This terminates the conductor process. Any active sessions will be
+     * invalidated.
+     */
+    close() {
+        this._conn.process.kill();
+    }
+    /**
+     * Get the internal connection for use by ThinkBuilder
+     * @internal
+     */
+    get _connection() {
+        return this._conn;
+    }
+    /**
+     * Initialize the connection (negotiate protocol version)
+     * @internal
+     */
+    async _initialize() {
+        if (this._conn.initialized)
+            return;
+        await this._conn.connection.initialize({
+            protocolVersion: 1,
+            clientCapabilities: {},
+        });
+        this._conn.initialized = true;
+    }
+}
+/**
+ * Find the conductor binary
+ */
+function findConductor(explicitPath) {
+    // 1. Use explicit path if provided
+    if (explicitPath) {
+        return explicitPath;
+    }
+    // 2. Check environment variable
+    const envPath = process.env.SACP_CONDUCTOR_PATH;
+    if (envPath) {
+        return envPath;
+    }
+    // 3. Assume it's in PATH
+    return "sacp-conductor";
+}
+/**
+ * Convert Node.js streams to Web Streams for the ACP SDK
+ */
+function nodeToWebStreams(stdout, stdin) {
+    const readable = new ReadableStream({
+        start(controller) {
+            stdout.on("data", (chunk) => {
+                controller.enqueue(new Uint8Array(chunk));
+            });
+            stdout.on("end", () => {
+                controller.close();
+            });
+            stdout.on("error", (err) => {
+                controller.error(err);
+            });
+        },
+        cancel() {
+            stdout.destroy();
+        },
+    });
+    const writable = new WritableStream({
+        write(chunk) {
+            return new Promise((resolve, reject) => {
+                stdin.write(Buffer.from(chunk), (err) => {
+                    if (err)
+                        reject(err);
+                    else
+                        resolve();
+                });
+            });
+        },
+        close() {
+            return new Promise((resolve) => {
+                stdin.end(() => resolve());
+            });
+        },
+        abort(reason) {
+            stdin.destroy(reason instanceof Error ? reason : new Error(String(reason)));
+        },
+    });
+    return { readable, writable };
+}
+/**
+ * Create a Client implementation that handles incoming agent requests
+ */
+function createClient(conn, mcpHandler) {
+    return {
+        sessionUpdate(notification) {
+            const { sessionId } = notification;
+            const handler = conn.sessionHandlers.get(sessionId);
+            if (!handler) {
+                console.error(`No handler for session: ${sessionId}`);
+                return Promise.resolve();
+            }
+            const update = convertNotification(notification);
+            if (update) {
+                handler.pushUpdate(update);
+            }
+            return Promise.resolve();
+        },
+        requestPermission(request) {
+            const firstOption = request.options[0];
+            return Promise.resolve({
+                outcome: {
+                    outcome: "selected",
+                    optionId: firstOption?.optionId ?? "approve",
+                },
+            });
+        },
+        async extMethod(method, params) {
+            if (mcpHandler.isMcpRequest(method)) {
+                const result = await mcpHandler.routeRequest(method, params);
+                return result ?? {};
+            }
+            throw new Error(`Unknown extension method: ${method}`);
+        },
+        async extNotification(method, params) {
+            if (mcpHandler.isMcpRequest(method)) {
+                await mcpHandler.routeRequest(method, params);
+            }
+        },
+    };
+}
+/**
+ * Convert ACP notification to SessionUpdate
+ */
+function convertNotification(notification) {
+    const { update } = notification;
+    switch (update.sessionUpdate) {
+        case "agent_message_chunk":
+        case "user_message_chunk":
+        case "agent_thought_chunk": {
+            const content = update.content;
+            if (content.type === "text") {
+                return { type: "text", content: content.text };
+            }
+            break;
+        }
+        case "tool_call": {
+            return {
+                type: "tool_use",
+                id: update.toolCallId,
+                name: update.title,
+                input: update.rawInput ?? {},
+            };
+        }
+        case "plan":
+        case "tool_call_update":
+        case "available_commands_update":
+        case "current_mode_update":
+            break;
+    }
+    return null;
+}
+//# sourceMappingURL=agent.js.map

package/dist/agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.js","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { Agent } from "./agent.js";
+export type { ConnectOptions, SessionOptions } from "./agent.js";
+export { Session } from "./session.js";
+export { ThinkBuilder } from "./think-builder.js";
+export { schemaOf } from "./schema.js";
+export type { JsonSchema, SchemaProvider, JsonValue, JsonObject } from "@thinkwell/acp";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjE,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAGvC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGlD,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAGvC,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,8 @@
+// New API
+export { Agent } from "./agent.js";
+export { Session } from "./session.js";
+// Think builder
+export { ThinkBuilder } from "./think-builder.js";
+// Schema helpers
+export { schemaOf } from "./schema.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,UAAU;AACV,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,gBAAgB;AAChB,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,iBAAiB;AACjB,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC"}

package/dist/patchwork.d.ts

@@ -0,0 +1,55 @@
+import { Agent } from "./agent.js";
+import type { SchemaProvider } from "@thinkwell/acp";
+import { ThinkBuilder } from "./think-builder.js";
+/**
+ * Main entry point for creating patchwork instances.
+ *
+ * @deprecated Use Agent instead. This class will be removed in the next major version.
+ *
+ * Patchwork provides a fluent API for blending deterministic code
+ * with LLM-powered reasoning.
+ */
+export declare class Patchwork {
+    private readonly _agent;
+    /** @internal */
+    constructor(agent: Agent);
+    /**
+     * Create a new think builder for constructing a prompt with tools.
+     *
+     * @param schema - A SchemaProvider that defines the expected output structure
+     *
+     * @deprecated Use Agent.think() instead.
+     */
+    think<Output>(schema: SchemaProvider<Output>): ThinkBuilder<Output>;
+    /**
+     * Create a new think builder without a schema.
+     *
+     * @deprecated Use `think(schemaOf<T>(schema))` instead to provide a typed schema.
+     */
+    think<Output>(): ThinkBuilder<Output>;
+    /**
+     * Close the connection to the conductor
+     *
+     * @deprecated Use Agent.close() instead.
+     */
+    close(): void;
+}
+/**
+ * Connect to an agent via the conductor.
+ *
+ * @deprecated Use Agent.connect() instead. This function will be removed in the next major version.
+ *
+ * @param conductorCommand - The command to spawn the conductor process
+ * @returns A Patchwork instance connected to the conductor
+ *
+ * @example
+ * ```typescript
+ * // Old API (deprecated):
+ * const patchwork = await connect(["sacp-conductor", "agent", "npx ..."]);
+ *
+ * // New API:
+ * const agent = await Agent.connect("npx ...");
+ * ```
+ */
+export declare function connect(conductorCommand: string[]): Promise<Patchwork>;
+//# sourceMappingURL=patchwork.d.ts.map

package/dist/patchwork.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"patchwork.d.ts","sourceRoot":"","sources":["../src/patchwork.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD;;;;;;;GAOG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAQ;IAE/B,gBAAgB;gBACJ,KAAK,EAAE,KAAK;IAIxB;;;;;;OAMG;IACH,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,cAAc,CAAC,MAAM,CAAC,GAAG,YAAY,CAAC,MAAM,CAAC;IAEnE;;;;OAIG;IACH,KAAK,CAAC,MAAM,KAAK,YAAY,CAAC,MAAM,CAAC;IAMrC;;;;OAIG;IACH,KAAK,IAAI,IAAI;CAGd;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,OAAO,CAAC,gBAAgB,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,SAAS,CAAC,CAkB5E"}

package/dist/patchwork.js

@@ -0,0 +1,64 @@
+import { Agent } from "./agent.js";
+/**
+ * Main entry point for creating patchwork instances.
+ *
+ * @deprecated Use Agent instead. This class will be removed in the next major version.
+ *
+ * Patchwork provides a fluent API for blending deterministic code
+ * with LLM-powered reasoning.
+ */
+export class Patchwork {
+    _agent;
+    /** @internal */
+    constructor(agent) {
+        this._agent = agent;
+    }
+    think(schema) {
+        return this._agent.think(schema);
+    }
+    /**
+     * Close the connection to the conductor
+     *
+     * @deprecated Use Agent.close() instead.
+     */
+    close() {
+        this._agent.close();
+    }
+}
+/**
+ * Connect to an agent via the conductor.
+ *
+ * @deprecated Use Agent.connect() instead. This function will be removed in the next major version.
+ *
+ * @param conductorCommand - The command to spawn the conductor process
+ * @returns A Patchwork instance connected to the conductor
+ *
+ * @example
+ * ```typescript
+ * // Old API (deprecated):
+ * const patchwork = await connect(["sacp-conductor", "agent", "npx ..."]);
+ *
+ * // New API:
+ * const agent = await Agent.connect("npx ...");
+ * ```
+ */
+export async function connect(conductorCommand) {
+    // Extract the agent command from the conductor command
+    // Old format: ["sacp-conductor", "agent", "npx -y @zed-industries/claude-code-acp"]
+    // New format: just the agent command string
+    const agentIndex = conductorCommand.indexOf("agent");
+    let agentCommand;
+    if (agentIndex !== -1 && conductorCommand.length > agentIndex + 1) {
+        agentCommand = conductorCommand[agentIndex + 1];
+    }
+    else if (conductorCommand.length > 0) {
+        // Fallback: join remaining args as the command
+        agentCommand = conductorCommand.slice(1).join(" ");
+    }
+    else {
+        throw new Error("Invalid conductor command format");
+    }
+    const agent = await Agent.connect(agentCommand);
+    return new Patchwork(agent);
+}
+//# sourceMappingURL=patchwork.js.map

package/dist/patchwork.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"patchwork.js","sourceRoot":"","sources":["../src/patchwork.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAInC;;;;;;;GAOG;AACH,MAAM,OAAO,SAAS;IACH,MAAM,CAAQ;IAE/B,gBAAgB;IAChB,YAAY,KAAY;QACtB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;IACtB,CAAC;IAkBD,KAAK,CAAS,MAA+B;QAC3C,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,MAAO,CAAC,CAAC;IACpC,CAAC;IAED;;;;OAIG;IACH,KAAK;QACH,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;IACtB,CAAC;CACF;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,gBAA0B;IACtD,uDAAuD;IACvD,oFAAoF;IACpF,4CAA4C;IAC5C,MAAM,UAAU,GAAG,gBAAgB,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACrD,IAAI,YAAoB,CAAC;IAEzB,IAAI,UAAU,KAAK,CAAC,CAAC,IAAI,gBAAgB,CAAC,MAAM,GAAG,UAAU,GAAG,CAAC,EAAE,CAAC;QAClE,YAAY,GAAG,gBAAgB,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC;IAClD,CAAC;SAAM,IAAI,gBAAgB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvC,+CAA+C;QAC/C,YAAY,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACrD,CAAC;SAAM,CAAC;QACN,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;IACtD,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IAChD,OAAO,IAAI,SAAS,CAAC,KAAK,CAAC,CAAC;AAC9B,CAAC"}