@caspian2026/agent-sdk 0.0.2 → 0.0.4

package/dist/sdk/query.js

@@ -0,0 +1,372 @@
+// @bun
+import {
+  __require
+} from "../chunk-qp2qdcda.js";
+
+// src/entrypoints/sdk/query.ts
+import { spawn } from "child_process";
+import { createInterface } from "readline";
+var require_ = __require;
+function resolveCliPath(options) {
+  if (options.pathToClaudeCodeExecutable) {
+    return options.pathToClaudeCodeExecutable;
+  }
+  try {
+    return require_.resolve("@caspian2026/agent-sdk/dist/cli.js");
+  } catch {
+    throw new Error("Cannot resolve CLI path. Set options.pathToClaudeCodeExecutable or install @caspian2026/agent-sdk.");
+  }
+}
+function buildCliArgs(options) {
+  const args = ["-p", "--output-format", "stream-json", "--input-format", "stream-json", "--verbose"];
+  if (options.model) {
+    args.push("--model", options.model);
+  }
+  if (options.resume) {
+    args.push("--resume", options.resume);
+  }
+  if (options.continue) {
+    args.push("--continue");
+  }
+  if (options.permissionMode) {
+    args.push("--permission-mode", options.permissionMode);
+  }
+  if (options.maxTurns !== undefined) {
+    args.push("--max-turns", String(options.maxTurns));
+  }
+  if (options.maxBudgetUsd !== undefined) {
+    args.push("--max-budget-usd", String(options.maxBudgetUsd));
+  }
+  if (options.thinking) {
+    args.push("--thinking", options.thinking);
+  }
+  if (options.allowedTools?.length) {
+    args.push("--allowed-tools", ...options.allowedTools);
+  }
+  if (options.includePartialMessages) {
+    args.push("--include-partial-messages");
+  }
+  if (options.allowDangerouslySkipPermissions) {
+    args.push("--dangerously-skip-permissions");
+  }
+  if (options.permissionPromptToolName) {
+    args.push("--permission-prompt-tool", options.permissionPromptToolName);
+  }
+  if (options.plugins?.length) {
+    for (const plugin of options.plugins) {
+      args.push("--plugin-dir", plugin.path);
+    }
+  }
+  if (options.additionalDirectories?.length) {
+    args.push("--add-dir", ...options.additionalDirectories);
+  }
+  if (options.settingSources?.length) {
+    args.push("--setting-sources", ...options.settingSources);
+  }
+  if (typeof options.systemPrompt === "string") {
+    args.push("--system-prompt", options.systemPrompt);
+  } else if (options.systemPrompt && typeof options.systemPrompt === "object") {
+    if (options.systemPrompt.type === "preset" && options.systemPrompt.append) {
+      args.push("--append-system-prompt", options.systemPrompt.append);
+    }
+  }
+  if (options.fallbackModel) {
+    args.push("--fallback-model", options.fallbackModel);
+  }
+  if (options.mcpServers && Object.keys(options.mcpServers).length > 0) {
+    args.push("--mcp-config", JSON.stringify(options.mcpServers));
+  }
+  if (options.extraArgs) {
+    for (const [key, value] of Object.entries(options.extraArgs)) {
+      if (value === null) {
+        args.push(key);
+      } else {
+        args.push(key, value);
+      }
+    }
+  }
+  return args;
+}
+function ndjsonParse(line) {
+  if (!line.trim())
+    return;
+  return JSON.parse(line);
+}
+function ndjsonStringify(obj) {
+  return JSON.stringify(obj) + `
+`;
+}
+function buildHookCallbackMap(hooks) {
+  const map = new Map;
+  if (!hooks)
+    return map;
+  for (const [_event, matchers] of Object.entries(hooks)) {
+    if (!matchers)
+      continue;
+    for (const matcher of matchers) {
+      for (const hook of matcher.hooks) {
+        const id = `hook_${_event}_${matcher.matcher || "all"}_${map.size}`;
+        map.set(id, { callback: hook, timeout: matcher.timeout });
+      }
+    }
+  }
+  return map;
+}
+function buildHooksConfig(hooks) {
+  if (!hooks)
+    return;
+  const config = {};
+  for (const [event, matchers] of Object.entries(hooks)) {
+    if (!matchers)
+      continue;
+    const eventHooks = [];
+    for (const matcher of matchers) {
+      const callbackIds = [];
+      for (let i = 0;i < matcher.hooks.length; i++) {
+        callbackIds.push(`hook_${event}_${matcher.matcher || "all"}_${eventHooks.length * matcher.hooks.length + i}`);
+      }
+      eventHooks.push({
+        matcher: matcher.matcher,
+        hookCallbackIds: callbackIds,
+        timeout: matcher.timeout
+      });
+    }
+    if (eventHooks.length > 0) {
+      config[event] = eventHooks;
+    }
+  }
+  return Object.keys(config).length > 0 ? config : undefined;
+}
+async function* query(params) {
+  const { prompt, options } = params;
+  const abortController = options.abortController ?? new AbortController;
+  const signal = abortController.signal;
+  const cliPath = resolveCliPath(options);
+  const cliArgs = buildCliArgs(options);
+  const cliDir = options.cwd ?? process.cwd();
+  const env = {
+    ...process.env,
+    ...options.env,
+    ELECTRON_RUN_AS_NODE: "1"
+  };
+  const child = spawn(process.execPath, [cliPath, ...cliArgs], {
+    cwd: cliDir,
+    env,
+    stdio: ["pipe", "pipe", "pipe"],
+    signal
+  });
+  const stdin = child.stdin;
+  const stdout = child.stdout;
+  const stderr = child.stderr;
+  if (options.stderr) {
+    stderr.on("data", (chunk) => {
+      options.stderr(chunk.toString());
+    });
+  } else {
+    stderr.resume();
+  }
+  const hookCallbacks = buildHookCallbackMap(options.hooks);
+  const pendingControlRequests = new Map;
+  const hooksConfig = buildHooksConfig(options.hooks);
+  if (hooksConfig) {
+    const initRequestId = "sdk-init-hooks";
+    const initRequest = {
+      type: "control_request",
+      request_id: initRequestId,
+      request: {
+        subtype: "initialize",
+        hooks: hooksConfig
+      }
+    };
+    stdin.write(ndjsonStringify(initRequest));
+  }
+  const promptQueue = [];
+  async function writePrompt() {
+    if (typeof prompt === "string") {
+      const msg = {
+        type: "user",
+        content: prompt,
+        uuid: "",
+        session_id: "",
+        message: { role: "user", content: prompt },
+        parent_tool_use_id: null
+      };
+      stdin.write(ndjsonStringify(msg));
+    } else {
+      for await (const userMsg of prompt) {
+        if (signal.aborted)
+          break;
+        stdin.write(ndjsonStringify(userMsg));
+      }
+    }
+  }
+  const promptPromise = writePrompt().catch((err) => {
+    if (!signal.aborted) {
+      throw err;
+    }
+  });
+  const rl = createInterface({ input: stdout });
+  async function handleControlRequest(msg) {
+    const { request_id, request } = msg;
+    try {
+      switch (request.subtype) {
+        case "can_use_tool": {
+          if (!options.canUseTool) {
+            const response2 = {
+              type: "control_response",
+              response: { subtype: "success", request_id, response: { behavior: "deny", message: "No permission handler configured" } }
+            };
+            stdin.write(ndjsonStringify(response2));
+            break;
+          }
+          const toolName = request.tool_name;
+          const toolInput = request.input ?? {};
+          const toolUseID = request.tool_use_id;
+          const suggestions = request.permission_suggestions;
+          const blockedPath = request.blocked_path;
+          const decisionReason = request.decision_reason;
+          const agentID = request.agent_id;
+          const result = await options.canUseTool(toolName, toolInput, {
+            signal,
+            suggestions,
+            blockedPath,
+            decisionReason,
+            toolUseID,
+            agentID
+          });
+          const response = {
+            type: "control_response",
+            response: {
+              subtype: "success",
+              request_id,
+              response: result
+            }
+          };
+          stdin.write(ndjsonStringify(response));
+          break;
+        }
+        case "hook_callback": {
+          const callbackId = request.callback_id;
+          const hookInput = request.input;
+          const toolUseId = request.tool_use_id;
+          const hookEntry = hookCallbacks.get(callbackId);
+          if (hookEntry) {
+            const result = await hookEntry.callback(hookInput, toolUseId, { signal });
+            const response = {
+              type: "control_response",
+              response: {
+                subtype: "success",
+                request_id,
+                response: result
+              }
+            };
+            stdin.write(ndjsonStringify(response));
+          } else {
+            const response = {
+              type: "control_response",
+              response: {
+                subtype: "success",
+                request_id,
+                response: {}
+              }
+            };
+            stdin.write(ndjsonStringify(response));
+          }
+          break;
+        }
+        case "initialize": {
+          const response = {
+            type: "control_response",
+            response: { subtype: "success", request_id, response: {} }
+          };
+          stdin.write(ndjsonStringify(response));
+          break;
+        }
+        default: {
+          const response = {
+            type: "control_response",
+            response: { subtype: "success", request_id, response: {} }
+          };
+          stdin.write(ndjsonStringify(response));
+        }
+      }
+    } catch (err) {
+      const errorMsg = err instanceof Error ? err.message : String(err);
+      const response = {
+        type: "control_response",
+        response: { subtype: "error", request_id, error: errorMsg }
+      };
+      try {
+        stdin.write(ndjsonStringify(response));
+      } catch {}
+    }
+  }
+  try {
+    for await (const line of rl) {
+      if (signal.aborted)
+        break;
+      let msg;
+      try {
+        msg = ndjsonParse(line);
+      } catch {
+        continue;
+      }
+      if (!msg || typeof msg !== "object")
+        continue;
+      const typed = msg;
+      switch (typed.type) {
+        case "control_request": {
+          handleControlRequest(typed).catch(() => {});
+          break;
+        }
+        case "control_response": {
+          const resp = typed;
+          const pending = pendingControlRequests.get(resp.response.request_id);
+          if (pending) {
+            pendingControlRequests.delete(resp.response.request_id);
+            if (resp.response.subtype === "error") {
+              pending.reject(new Error(resp.response.error));
+            } else {
+              pending.resolve(resp.response);
+            }
+          }
+          break;
+        }
+        case "control_cancel_request": {
+          const cancel = typed;
+          const pending = pendingControlRequests.get(cancel.request_id);
+          if (pending) {
+            pendingControlRequests.delete(cancel.request_id);
+            pending.reject(new Error("Request cancelled"));
+          }
+          break;
+        }
+        case "keep_alive": {
+          stdin.write(ndjsonStringify({ type: "keep_alive" }));
+          break;
+        }
+        default: {
+          if (typed.type === "assistant" || typed.type === "user" || typed.type === "system" || typed.type === "result" || typed.type === "stream_event" || typed.type === "tool_progress") {
+            yield typed;
+          }
+        }
+      }
+    }
+  } finally {
+    rl.close();
+    try {
+      stdin.end();
+    } catch {}
+    if (!child.killed) {
+      child.kill();
+    }
+    for (const pending of pendingControlRequests.values()) {
+      pending.reject(new Error("Query ended"));
+    }
+    pendingControlRequests.clear();
+    await promptPromise.catch(() => {});
+  }
+}
+export {
+  query
+};

package/package.json

@@ -1,122 +1,129 @@
-{
-  "name": "@caspian2026/agent-sdk",
-  "version": "0.0.2",
-  "description": "AI-powered agent SDK for the terminal",
-  "type": "module",
-  "engines": {
-    "bun": ">=1.2.0"
-  },
-  "bin": {
-    "ccb": "dist/cli.js",
-    "agent-sdk": "dist/cli.js"
-  },
-  "workspaces": [
-    "packages/*",
-    "packages/@ant/*"
-  ],
-  "files": [
-    "dist",
-    "scripts/postinstall.cjs"
-  ],
-  "scripts": {
-    "build": "bun run build.ts",
-    "dev": "bun run scripts/dev.ts",
-    "dev:inspect": "bun run scripts/dev-debug.ts",
-    "prepublishOnly": "bun run build",
-    "lint": "biome lint src/",
-    "lint:fix": "biome lint --fix src/",
-    "format": "biome format --write src/",
-    "prepare": "git config core.hooksPath .githooks",
-    "test": "bun test",
-    "check:unused": "knip-bun",
-    "health": "bun run scripts/health-check.ts",
-    "postinstall": "node scripts/postinstall.cjs",
-    "docs:dev": "npx mintlify dev"
-  },
-  "dependencies": {},
-  "devDependencies": {
-    "@alcalzone/ansi-tokenize": "^0.3.0",
-    "@ant/claude-for-chrome-mcp": "workspace:*",
-    "@ant/computer-use-input": "workspace:*",
-    "@ant/computer-use-mcp": "workspace:*",
-    "@ant/computer-use-swift": "workspace:*",
-    "@anthropic-ai/claude-agent-sdk": "^0.2.87",
-    "@anthropic-ai/mcpb": "^2.1.2",
-    "@anthropic-ai/sandbox-runtime": "^0.0.44",
-    "@anthropic-ai/sdk": "^0.80.0",
-    "@anthropic/ink": "workspace:*",
-    "@biomejs/biome": "^2.4.10",
-    "@commander-js/extra-typings": "^14.0.0",
-    "@modelcontextprotocol/sdk": "^1.29.0",
-    "@types/bun": "^1.3.11",
-    "@types/cacache": "^20.0.1",
-    "@types/plist": "^3.0.5",
-    "@types/react": "^19.2.14",
-    "@types/react-reconciler": "^0.33.0",
-    "@types/sharp": "^0.32.0",
-    "@types/turndown": "^5.0.6",
-    "ajv": "^8.18.0",
-    "asciichart": "^1.5.25",
-    "audio-capture-napi": "workspace:*",
-    "auto-bind": "^5.0.1",
-    "axios": "^1.14.0",
-    "bidi-js": "^1.0.3",
-    "cacache": "^20.0.4",
-    "chalk": "^5.6.2",
-    "chokidar": "^5.0.0",
-    "cli-boxes": "^4.0.1",
-    "cli-highlight": "^2.1.11",
-    "code-excerpt": "^4.0.0",
-    "color-diff-napi": "workspace:*",
-    "diff": "^8.0.4",
-    "emoji-regex": "^10.6.0",
-    "env-paths": "^4.0.0",
-    "execa": "^9.6.1",
-    "fflate": "^0.8.2",
-    "figures": "^6.1.0",
-    "fuse.js": "^7.1.0",
-    "get-east-asian-width": "^1.5.0",
-    "he": "^1.2.0",
-    "highlight.js": "^11.11.1",
-    "https-proxy-agent": "^8.0.0",
-    "ignore": "^7.0.5",
-    "image-processor-napi": "workspace:*",
-    "indent-string": "^5.0.0",
-    "jsonc-parser": "^3.3.1",
-    "knip": "^6.1.1",
-    "lodash-es": "^4.17.23",
-    "lru-cache": "^11.2.7",
-    "marked": "^17.0.5",
-    "modifiers-napi": "workspace:*",
-    "openai": "^6.33.0",
-    "p-map": "^7.0.4",
-    "picomatch": "^4.0.4",
-    "plist": "^3.1.0",
-    "proper-lockfile": "^4.1.2",
-    "react": "^19.2.4",
-    "react-compiler-runtime": "^1.0.0",
-    "react-reconciler": "^0.33.0",
-    "semver": "^7.7.4",
-    "sharp": "^0.34.5",
-    "shell-quote": "^1.8.3",
-    "signal-exit": "^4.1.0",
-    "stack-utils": "^2.0.6",
-    "strip-ansi": "^7.2.0",
-    "supports-hyperlinks": "^4.4.0",
-    "tree-kill": "^1.2.2",
-    "turndown": "^7.2.2",
-    "type-fest": "^5.5.0",
-    "typescript": "^6.0.2",
-    "undici": "^7.24.6",
-    "url-handler-napi": "workspace:*",
-    "usehooks-ts": "^3.1.1",
-    "vscode-jsonrpc": "^8.2.1",
-    "vscode-languageserver-protocol": "^3.17.5",
-    "vscode-languageserver-types": "^3.17.5",
-    "wrap-ansi": "^10.0.0",
-    "ws": "^8.20.0",
-    "xss": "^1.0.15",
-    "yaml": "^2.8.3",
-    "zod": "^4.3.6"
-  }
-}
+{
+  "name": "@caspian2026/agent-sdk",
+  "version": "0.0.4",
+  "description": "AI-powered agent SDK for the terminal",
+  "type": "module",
+  "engines": {
+    "bun": ">=1.2.0"
+  },
+  "main": "dist/sdk/query.cjs",
+  "exports": {
+    ".": {
+      "import": "./dist/sdk/query.js",
+      "require": "./dist/sdk/query.cjs",
+      "default": "./dist/sdk/query.cjs"
+    }
+  },
+  "bin": {
+    "ccb": "dist/cli.js",
+    "agent-sdk": "dist/cli.js"
+  },
+  "workspaces": [
+    "packages/*",
+    "packages/@ant/*"
+  ],
+  "files": [
+    "dist",
+    "scripts/postinstall.cjs"
+  ],
+  "scripts": {
+    "build": "bun run build.ts",
+    "dev": "bun run scripts/dev.ts",
+    "dev:inspect": "bun run scripts/dev-debug.ts",
+    "prepublishOnly": "bun run build",
+    "lint": "biome lint src/",
+    "lint:fix": "biome lint --fix src/",
+    "format": "biome format --write src/",
+    "prepare": "git config core.hooksPath .githooks",
+    "test": "bun test",
+    "check:unused": "knip-bun",
+    "health": "bun run scripts/health-check.ts",
+    "postinstall": "node scripts/postinstall.cjs",
+    "docs:dev": "npx mintlify dev"
+  },
+  "dependencies": {},
+  "devDependencies": {
+    "@alcalzone/ansi-tokenize": "^0.3.0",
+    "@ant/claude-for-chrome-mcp": "workspace:*",
+    "@ant/computer-use-input": "workspace:*",
+    "@ant/computer-use-mcp": "workspace:*",
+    "@ant/computer-use-swift": "workspace:*",
+    "@anthropic-ai/mcpb": "^2.1.2",
+    "@anthropic-ai/sandbox-runtime": "^0.0.44",
+    "@anthropic-ai/sdk": "^0.80.0",
+    "@anthropic/ink": "workspace:*",
+    "@biomejs/biome": "^2.4.10",
+    "@commander-js/extra-typings": "^14.0.0",
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "@types/bun": "^1.3.11",
+    "@types/cacache": "^20.0.1",
+    "@types/plist": "^3.0.5",
+    "@types/react": "^19.2.14",
+    "@types/react-reconciler": "^0.33.0",
+    "@types/sharp": "^0.32.0",
+    "@types/turndown": "^5.0.6",
+    "ajv": "^8.18.0",
+    "asciichart": "^1.5.25",
+    "audio-capture-napi": "workspace:*",
+    "auto-bind": "^5.0.1",
+    "axios": "^1.14.0",
+    "bidi-js": "^1.0.3",
+    "cacache": "^20.0.4",
+    "chalk": "^5.6.2",
+    "chokidar": "^5.0.0",
+    "cli-boxes": "^4.0.1",
+    "cli-highlight": "^2.1.11",
+    "code-excerpt": "^4.0.0",
+    "color-diff-napi": "workspace:*",
+    "diff": "^8.0.4",
+    "emoji-regex": "^10.6.0",
+    "env-paths": "^4.0.0",
+    "execa": "^9.6.1",
+    "fflate": "^0.8.2",
+    "figures": "^6.1.0",
+    "fuse.js": "^7.1.0",
+    "get-east-asian-width": "^1.5.0",
+    "he": "^1.2.0",
+    "highlight.js": "^11.11.1",
+    "https-proxy-agent": "^8.0.0",
+    "ignore": "^7.0.5",
+    "image-processor-napi": "workspace:*",
+    "indent-string": "^5.0.0",
+    "jsonc-parser": "^3.3.1",
+    "knip": "^6.1.1",
+    "lodash-es": "^4.17.23",
+    "lru-cache": "^11.2.7",
+    "marked": "^17.0.5",
+    "modifiers-napi": "workspace:*",
+    "openai": "^6.33.0",
+    "p-map": "^7.0.4",
+    "picomatch": "^4.0.4",
+    "plist": "^3.1.0",
+    "proper-lockfile": "^4.1.2",
+    "react": "^19.2.4",
+    "react-compiler-runtime": "^1.0.0",
+    "react-reconciler": "^0.33.0",
+    "semver": "^7.7.4",
+    "sharp": "^0.34.5",
+    "shell-quote": "^1.8.3",
+    "signal-exit": "^4.1.0",
+    "stack-utils": "^2.0.6",
+    "strip-ansi": "^7.2.0",
+    "supports-hyperlinks": "^4.4.0",
+    "tree-kill": "^1.2.2",
+    "turndown": "^7.2.2",
+    "type-fest": "^5.5.0",
+    "typescript": "^6.0.2",
+    "undici": "^7.24.6",
+    "url-handler-napi": "workspace:*",
+    "usehooks-ts": "^3.1.1",
+    "vscode-jsonrpc": "^8.2.1",
+    "vscode-languageserver-protocol": "^3.17.5",
+    "vscode-languageserver-types": "^3.17.5",
+    "wrap-ansi": "^10.0.0",
+    "ws": "^8.20.0",
+    "xss": "^1.0.15",
+    "yaml": "^2.8.3",
+    "zod": "^4.3.6"
+  }
+}