@sandagent/runner-cli 0.1.0

package/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/dist/__tests__/runner.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=runner.test.d.ts.map

package/dist/__tests__/runner.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/runner.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/runner.test.js

@@ -0,0 +1,79 @@
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+// Mock @sandagent/runner-claude
+vi.mock("@sandagent/runner-claude", () => ({
+    createClaudeRunner: vi.fn().mockReturnValue({
+        run: vi.fn().mockImplementation(async function* () {
+            yield "data: test message\n\n";
+        }),
+    }),
+}));
+import { createClaudeRunner } from "@sandagent/runner-claude";
+import { runAgent } from "../runner.js";
+describe("runAgent", () => {
+    let originalWrite;
+    let writtenData;
+    beforeEach(() => {
+        writtenData = [];
+        originalWrite = process.stdout.write;
+        // @ts-ignore - mocking stdout.write
+        process.stdout.write = vi.fn((data) => {
+            writtenData.push(data);
+            return true;
+        });
+    });
+    afterEach(() => {
+        process.stdout.write = originalWrite;
+        vi.clearAllMocks();
+    });
+    it("should create a Claude runner with correct options (with default template)", async () => {
+        await runAgent({
+            model: "claude-sonnet-4-20250514",
+            userInput: "Hello, world!",
+        });
+        // The runner should be called with template values loaded
+        expect(createClaudeRunner).toHaveBeenCalled();
+        const callArgs = vi.mocked(createClaudeRunner).mock.calls[0][0];
+        expect(callArgs.model).toBe("claude-sonnet-4-20250514");
+        // Template provides default allowed tools and maxTurns
+        // (or undefined if template not found)
+        expect(typeof callArgs.maxTurns === "number" || callArgs.maxTurns === undefined).toBe(true);
+    });
+    it("should pass optional parameters to runner (overriding template)", async () => {
+        await runAgent({
+            model: "claude-sonnet-4-20250514",
+            userInput: "Hello, world!",
+            systemPrompt: "You are a helpful assistant",
+            maxTurns: 5,
+            allowedTools: ["bash", "write_file"],
+        });
+        // Explicit parameters override template values
+        expect(createClaudeRunner).toHaveBeenCalledWith({
+            model: "claude-sonnet-4-20250514",
+            systemPrompt: "You are a helpful assistant",
+            maxTurns: 5,
+            allowedTools: ["bash", "write_file"],
+        });
+    });
+    it("should stream output to stdout without modification", async () => {
+        await runAgent({
+            model: "claude-sonnet-4-20250514",
+            userInput: "Hello, world!",
+        });
+        expect(process.stdout.write).toHaveBeenCalledWith("data: test message\n\n");
+        expect(writtenData).toEqual(["data: test message\n\n"]);
+    });
+    it("should call runner.run with user input", async () => {
+        const mockRunner = {
+            run: vi.fn().mockImplementation(async function* () {
+                yield "test";
+            }),
+        };
+        vi.mocked(createClaudeRunner).mockReturnValue(mockRunner);
+        await runAgent({
+            model: "claude-sonnet-4-20250514",
+            userInput: "Create a file",
+        });
+        expect(mockRunner.run).toHaveBeenCalledWith("Create a file", expect.any(AbortSignal));
+    });
+});
+//# sourceMappingURL=runner.test.js.map

package/dist/__tests__/runner.test.js.map

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

package/dist/bundle.mjs

@@ -0,0 +1,544 @@
+#!/usr/bin/env node
+
+// src/cli.ts
+import { parseArgs } from "node:util";
+
+// ../../packages/runner-claude/dist/claude-runner.js
+var SettingSource;
+(function(SettingSource2) {
+  SettingSource2["user"] = "user";
+  SettingSource2["project"] = "project";
+})(SettingSource || (SettingSource = {}));
+function createCanUseToolCallback(claudeOptions) {
+  return async (toolName, input, options) => {
+    const { toolUseID } = options;
+    if (toolName !== "AskUserQuestion") {
+      return {
+        behavior: "allow",
+        updatedInput: input
+      };
+    }
+    const approvalDir = claudeOptions.approvalDir;
+    if (!approvalDir) {
+      return { behavior: "deny", message: "User not answer" };
+    }
+    try {
+      const { execSync } = await import("node:child_process");
+      const path = await import("node:path");
+      const approvalFile = path.join(approvalDir, `${toolUseID}.json`);
+      const timeout = Date.now() + 6e4;
+      let lastApproval = null;
+      while (Date.now() < timeout) {
+        try {
+          const data = execSync(`cat ${approvalFile} 2>/dev/null`, {
+            encoding: "utf-8"
+          });
+          const approval = JSON.parse(data);
+          lastApproval = approval;
+          if (approval.status === "completed") {
+            try {
+              execSync(`rm ${approvalFile} 2>/dev/null`);
+            } catch {
+            }
+            return {
+              behavior: "allow",
+              updatedInput: {
+                questions: approval.questions,
+                answers: approval.answers
+              }
+            };
+          }
+        } catch (error) {
+        }
+        await new Promise((resolve) => setTimeout(resolve, 500));
+      }
+      try {
+        execSync(`rm ${approvalFile} 2>/dev/null`);
+      } catch {
+      }
+      if (lastApproval && Object.keys(lastApproval.answers).length > 0) {
+        return {
+          behavior: "allow",
+          updatedInput: {
+            questions: lastApproval.questions,
+            answers: lastApproval.answers
+          }
+        };
+      }
+      return {
+        behavior: "deny",
+        message: "Timeout waiting for user input"
+      };
+    } catch (error) {
+      console.error("Failed to handle approval flow:", error);
+      return {
+        behavior: "deny",
+        message: "Failed to handle approval flow"
+      };
+    }
+  };
+}
+var OPTIONAL_MODULES = {
+  "claude-agent-sdk": "@anthropic-ai/claude-agent-sdk"
+};
+function createClaudeRunner(options) {
+  return {
+    async *run(userInput, signal) {
+      if (signal?.aborted) {
+        return;
+      }
+      const apiKey = process.env.ANTHROPIC_API_KEY || process.env.AWS_BEARER_TOKEN_BEDROCK;
+      if (!apiKey) {
+        console.error("[SandAgent] Warning: ANTHROPIC_API_KEY or AWS_BEARER_TOKEN_BEDROCK not set. Using mock response.\nTo use the real Claude Agent SDK:\n1. Set ANTHROPIC_API_KEY or AWS_BEARER_TOKEN_BEDROCK environment variable\n2. Install the SDK: npm install @anthropic-ai/claude-agent-sdk");
+        yield* runMockAgent(options, userInput, signal);
+        return;
+      }
+      const sdk = await loadClaudeAgentSDK();
+      if (sdk) {
+        yield* runWithClaudeAgentSDK(sdk, options, userInput, signal);
+      } else {
+        console.error("[SandAgent] Warning: @anthropic-ai/claude-agent-sdk not installed. Using mock response.\nInstall the SDK: npm install @anthropic-ai/claude-agent-sdk");
+        yield* runMockAgent(options, userInput, signal);
+      }
+    }
+  };
+}
+async function loadClaudeAgentSDK() {
+  try {
+    const modulePath = OPTIONAL_MODULES["claude-agent-sdk"];
+    const module = await import(
+      /* webpackIgnore: true */
+      modulePath
+    );
+    return module;
+  } catch {
+    return null;
+  }
+}
+async function* runWithClaudeAgentSDK(sdk, options, userInput, signal) {
+  const usage = { inputTokens: 0, outputTokens: 0 };
+  let systemMessage;
+  let messageId;
+  const sdkOptions = {
+    model: options.model,
+    systemPrompt: options.systemPrompt,
+    maxTurns: options.maxTurns,
+    allowedTools: [...options.allowedTools ?? [], "Skill"],
+    cwd: options.cwd,
+    env: options.env,
+    resume: options.resume,
+    settingSources: [SettingSource.project, SettingSource.user],
+    canUseTool: createCanUseToolCallback(options),
+    // Bypass all permission checks for automated execution
+    permissionMode: "bypassPermissions",
+    allowDangerouslySkipPermissions: true
+  };
+  const queryIterator = sdk.query({
+    prompt: userInput,
+    options: sdkOptions
+  });
+  const abortHandler = async () => {
+    console.error("[ClaudeRunner] Operation aborted, calling query.interrupt()");
+    await queryIterator.interrupt();
+  };
+  if (signal) {
+    console.error("[ClaudeRunner] Signal provided, adding abort listener");
+    signal.addEventListener("abort", abortHandler);
+    if (signal.aborted) {
+      console.error("[ClaudeRunner] Signal already aborted!");
+    }
+  } else {
+    console.error("[ClaudeRunner] No signal provided");
+  }
+  try {
+    for await (const message of queryIterator) {
+      if (message.type === "system" && message.subtype === "init") {
+        systemMessage = message;
+        continue;
+      }
+      if (message.type === "assistant" && !messageId && systemMessage) {
+        messageId = message.message.id;
+        yield formatDataStream({
+          type: "start",
+          messageId
+        });
+        yield formatDataStream({
+          type: "message-metadata",
+          messageMetadata: {
+            tools: systemMessage.tools,
+            model: systemMessage.model,
+            sessionId: systemMessage.session_id
+          }
+        });
+      }
+      const chunks = convertSDKMessageToAISDKUI(message);
+      for (const chunk of chunks) {
+        yield chunk;
+      }
+    }
+  } catch (error) {
+    const errorMessage = error instanceof Error ? error.message : "Unknown error occurred";
+    console.error("[ClaudeRunner] Error:", errorMessage);
+    yield formatDataStream({ type: "error", errorText: errorMessage });
+    yield formatDataStream({
+      type: "finish",
+      finishReason: "error",
+      usage: {
+        promptTokens: usage.inputTokens,
+        completionTokens: usage.outputTokens
+      }
+    });
+  } finally {
+    if (signal) {
+      signal.removeEventListener("abort", abortHandler);
+    }
+    yield `data: [DONE]
+
+`;
+  }
+}
+function convertSDKMessageToAISDKUI(message) {
+  const chunks = [];
+  switch (message.type) {
+    case "assistant": {
+      const assistantMsg = message;
+      if (assistantMsg.error) {
+        const errorDetail = message.message.content.map((c) => c.text).join("\n");
+        chunks.push(formatDataStream({
+          type: "error",
+          errorText: `${assistantMsg.error}: ${errorDetail}`
+        }));
+        break;
+      }
+      if (assistantMsg.message) {
+        if (typeof assistantMsg.message === "string") {
+          const textId = generateId();
+          chunks.push(formatDataStream({ type: "text-start", id: textId }));
+          chunks.push(formatDataStream({
+            type: "text-delta",
+            id: textId,
+            delta: assistantMsg.message
+          }));
+          chunks.push(formatDataStream({ type: "text-end", id: textId }));
+        } else if (assistantMsg.message.content && Array.isArray(assistantMsg.message.content)) {
+          for (const block of assistantMsg.message.content) {
+            if (block.type === "text" && block.text) {
+              const textId = generateId();
+              chunks.push(formatDataStream({ type: "text-start", id: textId }));
+              chunks.push(formatDataStream({
+                type: "text-delta",
+                id: textId,
+                delta: block.text
+              }));
+              chunks.push(formatDataStream({ type: "text-end", id: textId }));
+            } else if (block.type === "tool_use") {
+              const toolCallId = block.id || generateId();
+              chunks.push(formatDataStream({
+                type: "tool-input-start",
+                toolCallId,
+                toolName: block.name,
+                dynamic: true
+              }));
+              if (block.input) {
+                chunks.push(formatDataStream({
+                  type: "tool-input-available",
+                  toolCallId,
+                  toolName: block.name,
+                  dynamic: true,
+                  input: block.input
+                }));
+              }
+            }
+          }
+        }
+      }
+      break;
+    }
+    case "result": {
+      const resultMsg = message;
+      chunks.push(formatDataStream({
+        type: "finish",
+        finishReason: resultMsg.is_error ? "error" : "stop",
+        messageMetadata: {
+          usage: resultMsg.usage,
+          duration_ms: resultMsg.duration_ms,
+          num_turns: resultMsg.num_turns,
+          total_cost_usd: resultMsg.total_cost_usd
+        }
+      }));
+      break;
+    }
+    case "user": {
+      const usrMsg = message;
+      if (usrMsg.isSynthetic) {
+        break;
+      }
+      const contentArray = usrMsg.message.content;
+      if (usrMsg.tool_use_result || Array.isArray(contentArray) && contentArray.some((c) => c.type === "tool_result")) {
+        for (const tool of contentArray) {
+          if (tool.is_error) {
+            chunks.push(formatDataStream({
+              type: "tool-output-error",
+              toolCallId: tool.tool_use_id,
+              errorText: tool.content,
+              dynamic: true
+            }));
+          } else {
+            chunks.push(formatDataStream({
+              type: "tool-output-available",
+              toolCallId: tool.tool_use_id,
+              output: usrMsg.tool_use_result || tool.content,
+              dynamic: true
+            }));
+          }
+        }
+      }
+      break;
+    }
+    default:
+      break;
+  }
+  return chunks;
+}
+function formatDataStream(data) {
+  return `data: ${JSON.stringify(data)}
+
+`;
+}
+function generateId() {
+  return `${Date.now()}-${Math.random().toString(36).substring(2, 9)}`;
+}
+async function* runMockAgent(options, userInput, signal) {
+  if (signal?.aborted) {
+    console.log("[ClaudeRunner] Mock agent: Operation already aborted");
+    return;
+  }
+  try {
+    const response = `I received your request: "${userInput}"
+
+Model: ${options.model}
+
+This is a mock response because:
+- ANTHROPIC_API_KEY is not set, OR
+- @anthropic-ai/claude-agent-sdk is not installed
+
+To use the real Claude Agent SDK:
+1. Set ANTHROPIC_API_KEY environment variable
+2. Install the SDK: npm install @anthropic-ai/claude-agent-sdk
+
+Documentation: https://platform.claude.com/docs/en/agent-sdk/typescript-v2-preview`;
+    const textId = generateId();
+    yield formatDataStream({ type: "text-start", id: textId });
+    const words = response.split(" ");
+    for (const word of words) {
+      yield formatDataStream({
+        type: "text-delta",
+        id: textId,
+        delta: word + " "
+      });
+      await new Promise((resolve) => setTimeout(resolve, 20));
+    }
+    yield formatDataStream({ type: "text-end", id: textId });
+    yield formatDataStream({
+      type: "finish",
+      finishReason: "stop"
+    });
+    yield `data: [DONE]
+
+`;
+  } catch (error) {
+    const errorMessage = error instanceof Error ? error.message : "Unknown error occurred";
+    console.error("[ClaudeRunner] Mock agent error:", errorMessage);
+    yield formatDataStream({ type: "error", errorText: errorMessage });
+    yield formatDataStream({
+      type: "finish",
+      finishReason: "error"
+    });
+    yield `data: [DONE]
+
+`;
+  }
+}
+
+// src/runner.ts
+async function runAgent(options) {
+  const abortController = new AbortController();
+  const signalHandler = () => {
+    console.error("[Runner] Received termination signal, stopping...");
+    abortController.abort();
+    console.error("[Runner] AbortController.abort() called");
+  };
+  process.on("SIGTERM", signalHandler);
+  process.on("SIGINT", signalHandler);
+  console.error("[Runner] Signal handlers registered");
+  try {
+    const runnerOptions = {
+      model: options.model,
+      systemPrompt: options.systemPrompt,
+      maxTurns: options.maxTurns,
+      allowedTools: options.allowedTools,
+      resume: options.resume,
+      approvalDir: options.approvalDir
+    };
+    const runner = createClaudeRunner(runnerOptions);
+    for await (const chunk of runner.run(
+      options.userInput,
+      abortController.signal
+    )) {
+      process.stdout.write(chunk);
+    }
+  } finally {
+    process.off("SIGTERM", signalHandler);
+    process.off("SIGINT", signalHandler);
+  }
+}
+
+// src/cli.ts
+function parseCliArgs() {
+  const { values, positionals } = parseArgs({
+    options: {
+      model: {
+        type: "string",
+        short: "m",
+        default: "claude-sonnet-4-20250514"
+      },
+      cwd: {
+        type: "string",
+        short: "c",
+        default: process.env.SANDAGENT_WORKSPACE ?? process.cwd()
+      },
+      template: {
+        type: "string",
+        short: "T",
+        default: process.env.SANDAGENT_TEMPLATE ?? "default"
+      },
+      "system-prompt": {
+        type: "string",
+        short: "s"
+      },
+      "max-turns": {
+        type: "string",
+        short: "t"
+      },
+      "allowed-tools": {
+        type: "string",
+        short: "a"
+      },
+      resume: {
+        type: "string",
+        short: "r"
+      },
+      "approval-dir": {
+        type: "string"
+      },
+      help: {
+        type: "boolean",
+        short: "h"
+      }
+    },
+    allowPositionals: true,
+    strict: true
+  });
+  if (values.help) {
+    printHelp();
+    process.exit(0);
+  }
+  if (positionals[0] !== "run") {
+    console.error('Error: Expected "run" command');
+    console.error('Usage: sandagent run [options] -- "<user input>"');
+    process.exit(1);
+  }
+  const dashIndex = process.argv.indexOf("--");
+  let userInput = "";
+  if (dashIndex !== -1 && dashIndex < process.argv.length - 1) {
+    userInput = process.argv.slice(dashIndex + 1).join(" ");
+  } else if (positionals.length > 1) {
+    userInput = positionals.slice(1).join(" ");
+  }
+  if (!userInput) {
+    console.error("Error: User input is required");
+    console.error('Usage: sandagent run [options] -- "<user input>"');
+    process.exit(1);
+  }
+  return {
+    model: values.model,
+    cwd: values.cwd,
+    template: values.template,
+    systemPrompt: values["system-prompt"],
+    maxTurns: values["max-turns"] ? Number.parseInt(values["max-turns"], 10) : void 0,
+    allowedTools: values["allowed-tools"]?.split(",").map((t) => t.trim()),
+    resume: values.resume,
+    approvalDir: values["approval-dir"],
+    userInput
+  };
+}
+function printHelp() {
+  console.log(`
+\u{1F916} SandAgent Runner CLI
+
+Like gemini-cli or claude-code - runs locally in your terminal.
+Streams AI SDK UI messages directly to stdout.
+
+Usage:
+  sandagent run [options] -- "<user input>"
+
+  # Or run from a template directory:
+  cd templates/coder
+  sandagent run -- "Build a REST API"
+
+Options:
+  -m, --model <model>          Model to use (default: claude-sonnet-4-20250514)
+  -c, --cwd <path>             Working directory (default: current directory)
+  -T, --template <name>        Template to use (default: default)
+                               Available: default, coder, analyst, researcher
+  -s, --system-prompt <prompt> Custom system prompt (overrides template)
+  -t, --max-turns <n>          Maximum conversation turns
+  -a, --allowed-tools <tools>  Comma-separated list of allowed tools
+  -r, --resume <session-id>    Resume a previous session
+  -h, --help                   Show this help message
+
+Environment Variables:
+  ANTHROPIC_API_KEY           Anthropic API key (required)
+  SANDAGENT_WORKSPACE         Default workspace path
+  SANDAGENT_TEMPLATE          Default template to use
+  SANDAGENT_LOG_LEVEL         Logging level (debug, info, warn, error)
+
+Templates:
+  default     General-purpose assistant
+  coder       Optimized for software development
+  analyst     Optimized for data analysis
+  researcher  Optimized for research tasks
+
+Examples:
+  # Run with default template
+  sandagent run -- "Create a hello world script"
+
+  # Run from a template directory (recommended)
+  cd templates/coder
+  sandagent run -- "Build a REST API with Express"
+
+  # Use a specific template
+  sandagent run --template analyst -- "Analyze sales.csv"
+
+  # Specify working directory
+  sandagent run --cwd ./my-project -- "Fix the bug in main.ts"
+`);
+}
+async function main() {
+  const args = parseCliArgs();
+  process.chdir(args.cwd);
+  await runAgent({
+    model: args.model,
+    template: args.template,
+    userInput: args.userInput,
+    systemPrompt: args.systemPrompt,
+    maxTurns: args.maxTurns,
+    allowedTools: args.allowedTools,
+    resume: args.resume,
+    approvalDir: args.approvalDir
+  });
+}
+main().catch((error) => {
+  console.error("Fatal error:", error.message);
+  process.exit(1);
+});

package/dist/cli.d.ts

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+/**
+ * SandAgent Runner CLI
+ *
+ * Like gemini-cli or claude-code - runs locally in your terminal.
+ * Streams AI SDK UI messages directly to stdout.
+ *
+ * Usage:
+ *   sandagent run [options] -- "<user input>"
+ *
+ * The CLI is designed to be executed in a specific working directory
+ * (e.g., a template directory) and outputs AI SDK UI messages directly.
+ */
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;GAWG"}

package/dist/cli.js

@@ -0,0 +1,172 @@
+#!/usr/bin/env node
+/**
+ * SandAgent Runner CLI
+ *
+ * Like gemini-cli or claude-code - runs locally in your terminal.
+ * Streams AI SDK UI messages directly to stdout.
+ *
+ * Usage:
+ *   sandagent run [options] -- "<user input>"
+ *
+ * The CLI is designed to be executed in a specific working directory
+ * (e.g., a template directory) and outputs AI SDK UI messages directly.
+ */
+import { parseArgs } from "node:util";
+import { runAgent } from "./runner.js";
+function parseCliArgs() {
+    const { values, positionals } = parseArgs({
+        options: {
+            model: {
+                type: "string",
+                short: "m",
+                default: "claude-sonnet-4-20250514",
+            },
+            cwd: {
+                type: "string",
+                short: "c",
+                default: process.env.SANDAGENT_WORKSPACE ?? process.cwd(),
+            },
+            template: {
+                type: "string",
+                short: "T",
+                default: process.env.SANDAGENT_TEMPLATE ?? "default",
+            },
+            "system-prompt": {
+                type: "string",
+                short: "s",
+            },
+            "max-turns": {
+                type: "string",
+                short: "t",
+            },
+            "allowed-tools": {
+                type: "string",
+                short: "a",
+            },
+            resume: {
+                type: "string",
+                short: "r",
+            },
+            "approval-dir": {
+                type: "string",
+            },
+            help: {
+                type: "boolean",
+                short: "h",
+            },
+        },
+        allowPositionals: true,
+        strict: true,
+    });
+    if (values.help) {
+        printHelp();
+        process.exit(0);
+    }
+    // Check for "run" command
+    if (positionals[0] !== "run") {
+        console.error('Error: Expected "run" command');
+        console.error('Usage: sandagent run [options] -- "<user input>"');
+        process.exit(1);
+    }
+    // Get user input from positionals after "--"
+    const dashIndex = process.argv.indexOf("--");
+    let userInput = "";
+    if (dashIndex !== -1 && dashIndex < process.argv.length - 1) {
+        userInput = process.argv.slice(dashIndex + 1).join(" ");
+    }
+    else if (positionals.length > 1) {
+        userInput = positionals.slice(1).join(" ");
+    }
+    if (!userInput) {
+        console.error("Error: User input is required");
+        console.error('Usage: sandagent run [options] -- "<user input>"');
+        process.exit(1);
+    }
+    return {
+        model: values.model,
+        cwd: values.cwd,
+        template: values.template,
+        systemPrompt: values["system-prompt"],
+        maxTurns: values["max-turns"]
+            ? Number.parseInt(values["max-turns"], 10)
+            : undefined,
+        allowedTools: values["allowed-tools"]?.split(",").map((t) => t.trim()),
+        resume: values.resume,
+        approvalDir: values["approval-dir"],
+        userInput,
+    };
+}
+function printHelp() {
+    console.log(`
+🤖 SandAgent Runner CLI
+
+Like gemini-cli or claude-code - runs locally in your terminal.
+Streams AI SDK UI messages directly to stdout.
+
+Usage:
+  sandagent run [options] -- "<user input>"
+
+  # Or run from a template directory:
+  cd templates/coder
+  sandagent run -- "Build a REST API"
+
+Options:
+  -m, --model <model>          Model to use (default: claude-sonnet-4-20250514)
+  -c, --cwd <path>             Working directory (default: current directory)
+  -T, --template <name>        Template to use (default: default)
+                               Available: default, coder, analyst, researcher
+  -s, --system-prompt <prompt> Custom system prompt (overrides template)
+  -t, --max-turns <n>          Maximum conversation turns
+  -a, --allowed-tools <tools>  Comma-separated list of allowed tools
+  -r, --resume <session-id>    Resume a previous session
+  -h, --help                   Show this help message
+
+Environment Variables:
+  ANTHROPIC_API_KEY           Anthropic API key (required)
+  SANDAGENT_WORKSPACE         Default workspace path
+  SANDAGENT_TEMPLATE          Default template to use
+  SANDAGENT_LOG_LEVEL         Logging level (debug, info, warn, error)
+
+Templates:
+  default     General-purpose assistant
+  coder       Optimized for software development
+  analyst     Optimized for data analysis
+  researcher  Optimized for research tasks
+
+Examples:
+  # Run with default template
+  sandagent run -- "Create a hello world script"
+
+  # Run from a template directory (recommended)
+  cd templates/coder
+  sandagent run -- "Build a REST API with Express"
+
+  # Use a specific template
+  sandagent run --template analyst -- "Analyze sales.csv"
+
+  # Specify working directory
+  sandagent run --cwd ./my-project -- "Fix the bug in main.ts"
+`);
+}
+async function main() {
+    const args = parseCliArgs();
+    // Change to the specified working directory
+    process.chdir(args.cwd);
+    // Run the agent and stream output to stdout
+    await runAgent({
+        model: args.model,
+        template: args.template,
+        userInput: args.userInput,
+        systemPrompt: args.systemPrompt,
+        maxTurns: args.maxTurns,
+        allowedTools: args.allowedTools,
+        resume: args.resume,
+        approvalDir: args.approvalDir,
+    });
+}
+main().catch((error) => {
+    // Errors go to stderr, not stdout
+    console.error("Fatal error:", error.message);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAcvC,SAAS,YAAY;IACnB,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,SAAS,CAAC;QACxC,OAAO,EAAE;YACP,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,KAAK,EAAE,GAAG;gBACV,OAAO,EAAE,0BAA0B;aACpC;YACD,GAAG,EAAE;gBACH,IAAI,EAAE,QAAQ;gBACd,KAAK,EAAE,GAAG;gBACV,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,OAAO,CAAC,GAAG,EAAE;aAC1D;YACD,QAAQ,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,KAAK,EAAE,GAAG;gBACV,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,SAAS;aACrD;YACD,eAAe,EAAE;gBACf,IAAI,EAAE,QAAQ;gBACd,KAAK,EAAE,GAAG;aACX;YACD,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,KAAK,EAAE,GAAG;aACX;YACD,eAAe,EAAE;gBACf,IAAI,EAAE,QAAQ;gBACd,KAAK,EAAE,GAAG;aACX;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,KAAK,EAAE,GAAG;aACX;YACD,cAAc,EAAE;gBACd,IAAI,EAAE,QAAQ;aACf;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,SAAS;gBACf,KAAK,EAAE,GAAG;aACX;SACF;QACD,gBAAgB,EAAE,IAAI;QACtB,MAAM,EAAE,IAAI;KACb,CAAC,CAAC;IAEH,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;QAChB,SAAS,EAAE,CAAC;QACZ,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,0BAA0B;IAC1B,IAAI,WAAW,CAAC,CAAC,CAAC,KAAK,KAAK,EAAE,CAAC;QAC7B,OAAO,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAC;QAC/C,OAAO,CAAC,KAAK,CAAC,kDAAkD,CAAC,CAAC;QAClE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,6CAA6C;IAC7C,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7C,IAAI,SAAS,GAAG,EAAE,CAAC;IAEnB,IAAI,SAAS,KAAK,CAAC,CAAC,IAAI,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5D,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC1D,CAAC;SAAM,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAClC,SAAS,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC7C,CAAC;IAED,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAC;QAC/C,OAAO,CAAC,KAAK,CAAC,kDAAkD,CAAC,CAAC;QAClE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,OAAO;QACL,KAAK,EAAE,MAAM,CAAC,KAAM;QACpB,GAAG,EAAE,MAAM,CAAC,GAAI;QAChB,QAAQ,EAAE,MAAM,CAAC,QAAS;QAC1B,YAAY,EAAE,MAAM,CAAC,eAAe,CAAC;QACrC,QAAQ,EAAE,MAAM,CAAC,WAAW,CAAC;YAC3B,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,EAAE,CAAC;YAC1C,CAAC,CAAC,SAAS;QACb,YAAY,EAAE,MAAM,CAAC,eAAe,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACtE,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,WAAW,EAAE,MAAM,CAAC,cAAc,CAAC;QACnC,SAAS;KACV,CAAC;AACJ,CAAC;AAED,SAAS,SAAS;IAChB,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiDb,CAAC,CAAC;AACH,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,MAAM,IAAI,GAAG,YAAY,EAAE,CAAC;IAE5B,4CAA4C;IAC5C,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAExB,4CAA4C;IAC5C,MAAM,QAAQ,CAAC;QACb,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,WAAW,EAAE,IAAI,CAAC,WAAW;KAC9B,CAAC,CAAC;AACL,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,kCAAkC;IAClC,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IAC7C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export { runAgent, type RunAgentOptions } from "./runner.js";
+//# 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":"AAAA,OAAO,EAAE,QAAQ,EAAE,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export { runAgent } from "./runner.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,OAAO,EAAE,QAAQ,EAAwB,MAAM,aAAa,CAAC"}

package/dist/runner.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Options for running the agent
+ */
+export interface RunAgentOptions {
+    /** Model to use */
+    model: string;
+    /** User input/task */
+    userInput: string;
+    /** Template to use (e.g., "default", "coder", "analyst", "researcher") */
+    template?: string;
+    /** Custom system prompt (overrides template) */
+    systemPrompt?: string;
+    /** Maximum conversation turns */
+    maxTurns?: number;
+    /** Allowed tools */
+    allowedTools?: string[];
+    /** Resume session ID for multi-turn conversation */
+    resume?: string;
+    /** Approval file directory for tool approval flow (e.g., "/sandagent/approvals") */
+    approvalDir?: string;
+}
+/**
+ * Run the agent and stream AI SDK UI messages to stdout.
+ *
+ * This function:
+ * 1. Uses process.cwd() as project directory (set by cli.ts via --cwd)
+ * 2. Creates a Claude runner with settingSources: ["project"]
+ * 3. SDK automatically loads CLAUDE.md, .claude/settings.json, .claude/skills/*.skill.md
+ * 4. Streams messages directly to stdout
+ * 5. Handles SIGTERM/SIGINT signals to gracefully stop the runner
+ *
+ * The output is a valid AI SDK UI stream.
+ */
+export declare function runAgent(options: RunAgentOptions): Promise<void>;
+//# sourceMappingURL=runner.d.ts.map

package/dist/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../src/runner.ts"],"names":[],"mappings":"AAKA;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,mBAAmB;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,sBAAsB;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gDAAgD;IAChD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iCAAiC;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oBAAoB;IACpB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,oDAAoD;IACpD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oFAAoF;IACpF,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CA2CtE"}

package/dist/runner.js

@@ -0,0 +1,50 @@
+import { createClaudeRunner, } from "@sandagent/runner-claude";
+/**
+ * Run the agent and stream AI SDK UI messages to stdout.
+ *
+ * This function:
+ * 1. Uses process.cwd() as project directory (set by cli.ts via --cwd)
+ * 2. Creates a Claude runner with settingSources: ["project"]
+ * 3. SDK automatically loads CLAUDE.md, .claude/settings.json, .claude/skills/*.skill.md
+ * 4. Streams messages directly to stdout
+ * 5. Handles SIGTERM/SIGINT signals to gracefully stop the runner
+ *
+ * The output is a valid AI SDK UI stream.
+ */
+export async function runAgent(options) {
+    // Create an AbortController to handle process signals
+    const abortController = new AbortController();
+    // Handle SIGTERM and SIGINT signals
+    const signalHandler = () => {
+        console.error("[Runner] Received termination signal, stopping...");
+        abortController.abort();
+        console.error("[Runner] AbortController.abort() called");
+    };
+    process.on("SIGTERM", signalHandler);
+    process.on("SIGINT", signalHandler);
+    console.error("[Runner] Signal handlers registered");
+    try {
+        // Build runner options - cwd is already set by cli.ts via process.chdir()
+        const runnerOptions = {
+            model: options.model,
+            systemPrompt: options.systemPrompt,
+            maxTurns: options.maxTurns,
+            allowedTools: options.allowedTools,
+            resume: options.resume,
+            approvalDir: options.approvalDir,
+        };
+        const runner = createClaudeRunner(runnerOptions);
+        // Stream AI SDK UI messages to stdout
+        for await (const chunk of runner.run(options.userInput, abortController.signal)) {
+            // Write directly to stdout without modification
+            // This ensures the stream is a valid AI SDK UI stream
+            process.stdout.write(chunk);
+        }
+    }
+    finally {
+        // Clean up signal handlers
+        process.off("SIGTERM", signalHandler);
+        process.off("SIGINT", signalHandler);
+    }
+}
+//# sourceMappingURL=runner.js.map

package/dist/runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.js","sourceRoot":"","sources":["../src/runner.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,kBAAkB,GACnB,MAAM,0BAA0B,CAAC;AAwBlC;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,OAAwB;IACrD,sDAAsD;IACtD,MAAM,eAAe,GAAG,IAAI,eAAe,EAAE,CAAC;IAE9C,oCAAoC;IACpC,MAAM,aAAa,GAAG,GAAG,EAAE;QACzB,OAAO,CAAC,KAAK,CAAC,mDAAmD,CAAC,CAAC;QACnE,eAAe,CAAC,KAAK,EAAE,CAAC;QACxB,OAAO,CAAC,KAAK,CAAC,yCAAyC,CAAC,CAAC;IAC3D,CAAC,CAAC;IAEF,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;IACrC,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;IAEpC,OAAO,CAAC,KAAK,CAAC,qCAAqC,CAAC,CAAC;IAErD,IAAI,CAAC;QACH,0EAA0E;QAC1E,MAAM,aAAa,GAAwB;YACzC,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,YAAY,EAAE,OAAO,CAAC,YAAY;YAClC,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,YAAY,EAAE,OAAO,CAAC,YAAY;YAClC,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,WAAW,EAAE,OAAO,CAAC,WAAW;SACjC,CAAC;QAEF,MAAM,MAAM,GAAG,kBAAkB,CAAC,aAAa,CAAC,CAAC;QAEjD,sCAAsC;QACtC,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,MAAM,CAAC,GAAG,CAClC,OAAO,CAAC,SAAS,EACjB,eAAe,CAAC,MAAM,CACvB,EAAE,CAAC;YACF,gDAAgD;YAChD,sDAAsD;YACtD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC;YAAS,CAAC;QACT,2BAA2B;QAC3B,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;QACtC,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;IACvC,CAAC;AACH,CAAC"}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@sandagent/runner-cli",
+  "version": "0.1.0",
+  "description": "SandAgent Runner CLI - Like gemini-cli or claude-code, runs in your local terminal with AI SDK UI streaming",
+  "type": "module",
+  "bin": {
+    "sandagent": "./dist/cli.js"
+  },
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/vikadata/sandagent.git",
+    "directory": "apps/runner-cli"
+  },
+  "license": "Apache-2.0",
+  "dependencies": {
+    "@sandagent/runner-claude": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.10.0",
+    "esbuild": "^0.27.2",
+    "typescript": "^5.3.0",
+    "vitest": "^1.6.1"
+  },
+  "scripts": {
+    "build": "tsc && pnpm bundle",
+    "build:bundle": "tsc && pnpm bundle",
+    "bundle": "esbuild src/cli.ts --bundle --platform=node --format=esm --outfile=dist/bundle.mjs",
+    "dev": "tsc --watch",
+    "clean": "rm -rf dist",
+    "typecheck": "tsc --noEmit",
+    "lint": "echo 'no lint configured'",
+    "test": "vitest run --passWithNoTests"
+  }
+}