@kilocode/sdk 1.0.0

package/dist/v2/gen/types.gen.js

@@ -0,0 +1,2 @@
+// This file is auto-generated by @hey-api/openapi-ts
+export {};

package/dist/v2/index.d.ts

@@ -0,0 +1,10 @@
+export * from "./client.js";
+export * from "./server.js";
+import type { ServerOptions } from "./server.js";
+export declare function createOpencode(options?: ServerOptions): Promise<{
+    client: import("./client.js").OpencodeClient;
+    server: {
+        url: string;
+        close(): void;
+    };
+}>;

package/dist/v2/index.js

@@ -0,0 +1,16 @@
+export * from "./client.js";
+export * from "./server.js";
+import { createOpencodeClient } from "./client.js";
+import { createOpencodeServer } from "./server.js";
+export async function createOpencode(options) {
+    const server = await createOpencodeServer({
+        ...options,
+    });
+    const client = createOpencodeClient({
+        baseUrl: server.url,
+    });
+    return {
+        client,
+        server,
+    };
+}

package/dist/v2/server.d.ts

@@ -0,0 +1,24 @@
+import { type Config } from "./gen/types.gen.js";
+export declare function buildConfigEnv(config?: Config): string;
+export type ServerOptions = {
+    hostname?: string;
+    port?: number;
+    signal?: AbortSignal;
+    timeout?: number;
+    config?: Config;
+};
+export type TuiOptions = {
+    project?: string;
+    model?: string;
+    session?: string;
+    agent?: string;
+    signal?: AbortSignal;
+    config?: Config;
+};
+export declare function createOpencodeServer(options?: ServerOptions): Promise<{
+    url: string;
+    close(): void;
+}>;
+export declare function createOpencodeTui(options?: TuiOptions): {
+    close(): void;
+};

package/dist/v2/server.js

@@ -0,0 +1,125 @@
+import { spawn } from "node:child_process";
+// kilocode_change start - Merge existing OPENCODE_CONFIG_CONTENT with new config
+// This preserves Kilocode-injected modes when spawning nested CLI instances
+function mergeConfig(existing, incoming) {
+    const base = existing ?? {};
+    const override = incoming ?? {};
+    return {
+        ...base,
+        ...override,
+        agent: { ...base.agent, ...override.agent },
+        command: { ...base.command, ...override.command },
+        mcp: { ...base.mcp, ...override.mcp },
+        mode: { ...base.mode, ...override.mode },
+        plugin: [...(base.plugin ?? []), ...(override.plugin ?? [])],
+        instructions: [...(base.instructions ?? []), ...(override.instructions ?? [])],
+    };
+}
+function parseExistingConfig() {
+    const content = process.env.OPENCODE_CONFIG_CONTENT;
+    if (!content)
+        return undefined;
+    try {
+        return JSON.parse(content);
+    }
+    catch {
+        return undefined;
+    }
+}
+export function buildConfigEnv(config) {
+    const merged = mergeConfig(parseExistingConfig(), config);
+    return JSON.stringify(merged);
+}
+export async function createOpencodeServer(options) {
+    options = Object.assign({
+        hostname: "127.0.0.1",
+        port: 4096,
+        timeout: 5000,
+    }, options ?? {});
+    const args = [`serve`, `--hostname=${options.hostname}`, `--port=${options.port}`];
+    if (options.config?.logLevel)
+        args.push(`--log-level=${options.config.logLevel}`);
+    const proc = spawn(`opencode`, args, {
+        signal: options.signal,
+        env: {
+            ...process.env,
+            OPENCODE_CONFIG_CONTENT: buildConfigEnv(options.config), // kilocode_change
+        },
+    });
+    const url = await new Promise((resolve, reject) => {
+        const id = setTimeout(() => {
+            reject(new Error(`Timeout waiting for server to start after ${options.timeout}ms`));
+        }, options.timeout);
+        let output = "";
+        proc.stdout?.on("data", (chunk) => {
+            output += chunk.toString();
+            const lines = output.split("\n");
+            for (const line of lines) {
+                if (line.startsWith("opencode server listening")) {
+                    const match = line.match(/on\s+(https?:\/\/[^\s]+)/);
+                    if (!match) {
+                        throw new Error(`Failed to parse server url from output: ${line}`);
+                    }
+                    clearTimeout(id);
+                    resolve(match[1]);
+                    return;
+                }
+            }
+        });
+        proc.stderr?.on("data", (chunk) => {
+            output += chunk.toString();
+        });
+        proc.on("exit", (code) => {
+            clearTimeout(id);
+            let msg = `Server exited with code ${code}`;
+            if (output.trim()) {
+                msg += `\nServer output: ${output}`;
+            }
+            reject(new Error(msg));
+        });
+        proc.on("error", (error) => {
+            clearTimeout(id);
+            reject(error);
+        });
+        if (options.signal) {
+            options.signal.addEventListener("abort", () => {
+                clearTimeout(id);
+                reject(new Error("Aborted"));
+            });
+        }
+    });
+    return {
+        url,
+        close() {
+            proc.kill();
+        },
+    };
+}
+export function createOpencodeTui(options) {
+    const args = [];
+    if (options?.project) {
+        args.push(`--project=${options.project}`);
+    }
+    if (options?.model) {
+        args.push(`--model=${options.model}`);
+    }
+    if (options?.session) {
+        args.push(`--session=${options.session}`);
+    }
+    if (options?.agent) {
+        args.push(`--agent=${options.agent}`);
+    }
+    const proc = spawn(`opencode`, args, {
+        signal: options?.signal,
+        stdio: "inherit",
+        env: {
+            ...process.env,
+            OPENCODE_CONFIG_CONTENT: buildConfigEnv(options?.config), // kilocode_change
+        },
+    });
+    return {
+        close() {
+            proc.kill();
+        },
+    };
+}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "$schema": "https://json.schemastore.org/package.json",
+  "name": "@kilocode/sdk",
+  "version": "1.0.0",
+  "type": "module",
+  "license": "MIT",
+  "scripts": {
+    "typecheck": "tsgo --noEmit",
+    "build": "./script/build.ts"
+  },
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./client": {
+      "import": "./dist/client.js",
+      "types": "./dist/client.d.ts"
+    },
+    "./server": {
+      "import": "./dist/server.js",
+      "types": "./dist/server.d.ts"
+    },
+    "./v2": {
+      "import": "./dist/v2/index.js",
+      "types": "./dist/v2/index.d.ts"
+    },
+    "./v2/client": {
+      "import": "./dist/v2/client.js",
+      "types": "./dist/v2/client.d.ts"
+    },
+    "./v2/server": {
+      "import": "./dist/v2/server.js",
+      "types": "./dist/v2/server.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "devDependencies": {
+    "@hey-api/openapi-ts": "0.90.10",
+    "@tsconfig/node22": "22.0.2",
+    "@types/node": "22.13.9",
+    "typescript": "5.8.2",
+    "@typescript/native-preview": "7.0.0-dev.20251207.1"
+  },
+  "dependencies": {},
+  "publishConfig": {
+    "directory": "dist"
+  }
+}