@openape/apes 1.25.1 → 1.26.0

package/dist/chunk-L2V3CW5B.js

@@ -1,605 +0,0 @@
-#!/usr/bin/env node
-
-// src/errors.ts
-var CliError = class extends Error {
-  constructor(message, exitCode = 1) {
-    super(message);
-    this.exitCode = exitCode;
-    this.name = "CliError";
-  }
-  exitCode;
-};
-var CliExit = class extends Error {
-  constructor(exitCode = 0) {
-    super("");
-    this.exitCode = exitCode;
-    this.name = "CliExit";
-  }
-  exitCode;
-};
-
-// src/duration.ts
-function parseDuration(value) {
-  const match = value.match(/^(\d+)\s*([smhd])$/);
-  if (!match) {
-    throw new Error(`Invalid duration format: "${value}". Use e.g. 30m, 1h, 7d`);
-  }
-  const amount = Number.parseInt(match[1], 10);
-  switch (match[2]) {
-    case "s":
-      return amount;
-    case "m":
-      return amount * 60;
-    case "h":
-      return amount * 3600;
-    case "d":
-      return amount * 86400;
-    default:
-      throw new Error(`Unknown duration unit: ${match[2]}`);
-  }
-}
-
-// src/lib/agent-tools/bash.ts
-import { spawn } from "child_process";
-var DEFAULT_TIMEOUT_MS = 5 * 60 * 1e3;
-var MAX_STDIO_BYTES = 64 * 1024;
-var BIN = "ape-shell";
-function capStdio(s) {
-  const buf = Buffer.from(s, "utf8");
-  if (buf.byteLength <= MAX_STDIO_BYTES) return s;
-  return `${buf.subarray(0, MAX_STDIO_BYTES).toString("utf8")}
-[truncated to ${MAX_STDIO_BYTES} bytes]`;
-}
-var bashTools = [
-  {
-    name: "bash",
-    description: "Run a shell command on the agent host. Every invocation goes through the OpenApe DDISA grant cycle \u2014 auto-approved if the owner has a matching YOLO scope, otherwise the owner gets a push notification to approve. Runs as the agent's macOS user, so file/network access is limited to what that user can see. Returns stdout, stderr, and exit code. For repeated command patterns ask the owner to set up a YOLO scope so approvals don't pile up.",
-    parameters: {
-      type: "object",
-      properties: {
-        cmd: {
-          type: "string",
-          description: "Shell command to run, e.g. `ls -la ~/Documents`, `git status`, `curl -fsSL https://example.com`. The whole string is passed to `bash -c`; quote internally as needed."
-        },
-        timeout_ms: {
-          type: "number",
-          description: "Wall-clock cap for the whole approval-and-run cycle in milliseconds. Default 300000 (5 min). Approval waits count against this budget."
-        }
-      },
-      required: ["cmd"]
-    },
-    execute: async (args) => {
-      const a = args;
-      if (typeof a.cmd !== "string" || a.cmd.trim() === "") {
-        throw new Error("cmd must be a non-empty string");
-      }
-      const timeout = typeof a.timeout_ms === "number" && a.timeout_ms > 0 ? a.timeout_ms : DEFAULT_TIMEOUT_MS;
-      return await new Promise((resolveResult) => {
-        const child = spawn(BIN, ["-c", a.cmd], {
-          env: { ...process.env, APE_WAIT: "1" },
-          stdio: ["ignore", "pipe", "pipe"]
-        });
-        let stdout = "";
-        let stderr = "";
-        let timedOut = false;
-        let spawnError = null;
-        child.stdout.on("data", (chunk) => {
-          stdout += chunk.toString("utf8");
-        });
-        child.stderr.on("data", (chunk) => {
-          stderr += chunk.toString("utf8");
-        });
-        child.on("error", (err) => {
-          spawnError = err;
-        });
-        const timer = setTimeout(() => {
-          timedOut = true;
-          child.kill("SIGTERM");
-          setTimeout(() => {
-            try {
-              child.kill("SIGKILL");
-            } catch {
-            }
-          }, 5e3);
-        }, timeout);
-        child.on("close", (code) => {
-          clearTimeout(timer);
-          if (spawnError) {
-            resolveResult({
-              error: spawnError.message,
-              hint: `Could not exec '${BIN}'. The agent host needs @openape/apes installed globally so ape-shell is on PATH.`
-            });
-            return;
-          }
-          resolveResult({
-            stdout: capStdio(stdout),
-            stderr: capStdio(stderr),
-            exit_code: code ?? -1,
-            ...timedOut ? { timed_out: true } : {}
-          });
-        });
-      });
-    }
-  }
-];
-
-// src/lib/agent-tools/file.ts
-import { mkdirSync, readFileSync, writeFileSync } from "fs";
-import { homedir } from "os";
-import { dirname, normalize, resolve } from "path";
-var MAX_BYTES = 1024 * 1024;
-function jailPath(input) {
-  if (typeof input !== "string" || input === "") {
-    throw new Error("path must be a non-empty string");
-  }
-  const home = homedir();
-  const candidate = input.startsWith("~/") ? resolve(home, input.slice(2)) : input.startsWith("/") ? normalize(input) : resolve(home, input);
-  if (candidate !== home && !candidate.startsWith(`${home}/`)) {
-    throw new Error(`path "${input}" resolves outside the agent's home`);
-  }
-  return candidate;
-}
-var fileTools = [
-  {
-    name: "file.read",
-    description: "Read a UTF-8 file from the agent's home directory ($HOME). Capped at 1MB. Path traversal blocked.",
-    parameters: {
-      type: "object",
-      properties: {
-        path: { type: "string", description: "Path relative to $HOME (or absolute under $HOME). `..` segments are rejected." }
-      },
-      required: ["path"]
-    },
-    execute: async (args) => {
-      const a = args;
-      const p = jailPath(a.path);
-      const content = readFileSync(p, "utf8");
-      if (Buffer.byteLength(content, "utf8") > MAX_BYTES) {
-        return { path: p, truncated: true, content: content.slice(0, MAX_BYTES) };
-      }
-      return { path: p, truncated: false, content };
-    }
-  },
-  {
-    name: "file.write",
-    description: "Write a UTF-8 file under the agent's home directory. Creates parent dirs as needed. 1MB max.",
-    parameters: {
-      type: "object",
-      properties: {
-        path: { type: "string", description: "Path relative to $HOME (or absolute under $HOME)." },
-        content: { type: "string", description: "File body. Existing files are overwritten." }
-      },
-      required: ["path", "content"]
-    },
-    execute: async (args) => {
-      const a = args;
-      if (typeof a.content !== "string") throw new Error("content must be a string");
-      if (Buffer.byteLength(a.content, "utf8") > MAX_BYTES) {
-        throw new Error(`content exceeds ${MAX_BYTES} byte cap`);
-      }
-      const p = jailPath(a.path);
-      mkdirSync(dirname(p), { recursive: true });
-      writeFileSync(p, a.content, { encoding: "utf8" });
-      return { path: p, bytes: Buffer.byteLength(a.content, "utf8") };
-    }
-  }
-];
-
-// src/lib/agent-tools/http.ts
-var MAX_BYTES2 = 1024 * 1024;
-var FORBIDDEN_HEADERS = /* @__PURE__ */ new Set([
-  "host",
-  "authorization",
-  "cookie",
-  "connection",
-  "transfer-encoding",
-  "upgrade",
-  "proxy-authorization"
-]);
-function sanitizeHeaders(input) {
-  if (!input || typeof input !== "object") return {};
-  const out = {};
-  for (const [k, v] of Object.entries(input)) {
-    if (typeof v !== "string") continue;
-    if (FORBIDDEN_HEADERS.has(k.toLowerCase())) continue;
-    out[k] = v;
-  }
-  return out;
-}
-async function readCappedBody(res) {
-  const buf = new Uint8Array(MAX_BYTES2 + 1);
-  let written = 0;
-  const reader = res.body?.getReader();
-  if (!reader) return await res.text();
-  while (true) {
-    const { value, done } = await reader.read();
-    if (done) break;
-    if (written + value.byteLength > MAX_BYTES2) {
-      buf.set(value.subarray(0, MAX_BYTES2 - written), written);
-      written = MAX_BYTES2;
-      try {
-        await reader.cancel();
-      } catch {
-      }
-      break;
-    }
-    buf.set(value, written);
-    written += value.byteLength;
-  }
-  return new TextDecoder().decode(buf.subarray(0, written));
-}
-var httpTools = [
-  {
-    name: "http.get",
-    description: "GET an HTTPS URL and return the response body (capped at 1MB). Useful for reading public APIs, RSS feeds, web pages.",
-    parameters: {
-      type: "object",
-      properties: {
-        url: { type: "string", description: "Absolute HTTPS URL." },
-        headers: { type: "object", description: "Optional headers (Host, Authorization, Cookie are stripped)." }
-      },
-      required: ["url"]
-    },
-    execute: async (args) => {
-      const a = args;
-      if (typeof a.url !== "string" || !a.url.startsWith("http")) {
-        throw new Error("url must be an http(s) URL");
-      }
-      const res = await fetch(a.url, { method: "GET", headers: sanitizeHeaders(a.headers) });
-      const body = await readCappedBody(res);
-      return { status: res.status, headers: Object.fromEntries(res.headers), body };
-    }
-  },
-  {
-    name: "http.post",
-    description: "POST JSON to an HTTPS URL and return the response body (capped at 1MB).",
-    parameters: {
-      type: "object",
-      properties: {
-        url: { type: "string", description: "Absolute HTTPS URL." },
-        body: { description: "JSON-serialisable payload." },
-        headers: { type: "object", description: "Optional headers (Host, Authorization, Cookie are stripped)." }
-      },
-      required: ["url", "body"]
-    },
-    execute: async (args) => {
-      const a = args;
-      if (typeof a.url !== "string" || !a.url.startsWith("http")) {
-        throw new Error("url must be an http(s) URL");
-      }
-      const res = await fetch(a.url, {
-        method: "POST",
-        headers: { "content-type": "application/json", ...sanitizeHeaders(a.headers) },
-        body: JSON.stringify(a.body)
-      });
-      const body = await readCappedBody(res);
-      return { status: res.status, headers: Object.fromEntries(res.headers), body };
-    }
-  }
-];
-
-// src/lib/agent-tools/mail.ts
-import { execFileSync } from "child_process";
-function o365(args) {
-  try {
-    return execFileSync("o365-cli", args, { encoding: "utf8", stdio: ["ignore", "pipe", "pipe"] });
-  } catch (err) {
-    const e = err;
-    if (e.code === "ENOENT") {
-      throw new Error("o365-cli is not installed on this agent host");
-    }
-    const stderr = typeof e.stderr === "string" ? e.stderr : e.stderr?.toString("utf8");
-    throw new Error(`o365-cli failed: ${stderr ?? e.message ?? err}`);
-  }
-}
-var mailTools = [
-  {
-    name: "mail.list",
-    description: "List recent inbox messages via o365-cli. Optional `unread_only` and `limit`.",
-    parameters: {
-      type: "object",
-      properties: {
-        limit: { type: "integer", minimum: 1, maximum: 100, default: 20 },
-        unread_only: { type: "boolean", default: false }
-      },
-      required: []
-    },
-    execute: async (args) => {
-      const a = args ?? {};
-      const argv = ["mail", "list", "--json", "--limit", String(a.limit ?? 20)];
-      if (a.unread_only) argv.push("--unread");
-      const out = o365(argv);
-      try {
-        return JSON.parse(out);
-      } catch {
-        return { raw: out };
-      }
-    }
-  },
-  {
-    name: "mail.search",
-    description: "Search the inbox via o365-cli using a free-form query string.",
-    parameters: {
-      type: "object",
-      properties: {
-        q: { type: "string" },
-        limit: { type: "integer", minimum: 1, maximum: 100, default: 20 }
-      },
-      required: ["q"]
-    },
-    execute: async (args) => {
-      const a = args;
-      if (typeof a.q !== "string" || a.q.length === 0) throw new Error("q is required");
-      const argv = ["mail", "search", a.q, "--json", "--limit", String(a.limit ?? 20)];
-      const out = o365(argv);
-      try {
-        return JSON.parse(out);
-      } catch {
-        return { raw: out };
-      }
-    }
-  }
-];
-
-// src/lib/agent-tools/tasks.ts
-import { execFileSync as execFileSync2 } from "child_process";
-function ape(args) {
-  try {
-    return execFileSync2("ape-tasks", args, { encoding: "utf8", stdio: ["ignore", "pipe", "pipe"] });
-  } catch (err) {
-    const e = err;
-    const stderr = typeof e.stderr === "string" ? e.stderr : e.stderr?.toString("utf8");
-    throw new Error(`ape-tasks failed: ${stderr ?? e.message ?? err}`);
-  }
-}
-var tasksTools = [
-  {
-    name: "tasks.list",
-    description: "List the owner's open ape-tasks (the user's personal task list at tasks.openape.ai).",
-    parameters: {
-      type: "object",
-      properties: {
-        status: { type: "string", enum: ["open", "doing", "done", "archived"] },
-        team_id: { type: "string" }
-      },
-      required: []
-    },
-    execute: async (args) => {
-      const a = args ?? {};
-      const argv = ["list", "--json"];
-      if (a.status) argv.push("--status", a.status);
-      if (a.team_id) argv.push("--team", a.team_id);
-      const out = ape(argv);
-      try {
-        return JSON.parse(out);
-      } catch {
-        return { raw: out };
-      }
-    }
-  },
-  {
-    name: "tasks.create",
-    description: "Create a new ape-task on the owner's task list at tasks.openape.ai.",
-    parameters: {
-      type: "object",
-      properties: {
-        title: { type: "string" },
-        notes: { type: "string" },
-        priority: { type: "string", enum: ["low", "med", "high"] },
-        due_at: { type: "string", description: "ISO date or +Nh/+Nd shorthand." }
-      },
-      required: ["title"]
-    },
-    execute: async (args) => {
-      const a = args;
-      const argv = ["new", "--title", a.title, "--json"];
-      if (a.notes) argv.push("--notes", a.notes);
-      if (a.priority) argv.push("--priority", a.priority);
-      if (a.due_at) argv.push("--due", a.due_at);
-      const out = ape(argv);
-      try {
-        return JSON.parse(out);
-      } catch {
-        return { raw: out };
-      }
-    }
-  }
-];
-
-// src/lib/agent-tools/time.ts
-var timeTools = [
-  {
-    name: "time.now",
-    description: "Returns the current UTC date and time as ISO 8601 plus epoch seconds. No inputs.",
-    parameters: { type: "object", properties: {}, required: [] },
-    execute: async () => {
-      const now = /* @__PURE__ */ new Date();
-      return {
-        iso: now.toISOString(),
-        epoch_seconds: Math.floor(now.getTime() / 1e3),
-        timezone_offset_minutes: -now.getTimezoneOffset()
-      };
-    }
-  }
-];
-
-// src/lib/agent-tools/index.ts
-var ALL_TOOLS = [
-  ...timeTools,
-  ...httpTools,
-  ...fileTools,
-  ...tasksTools,
-  ...mailTools,
-  ...bashTools
-];
-var TOOLS = Object.fromEntries(
-  ALL_TOOLS.map((t) => [t.name, t])
-);
-function taskTools(names) {
-  const out = [];
-  const missing = [];
-  for (const name of names) {
-    const tool = TOOLS[name];
-    if (!tool) missing.push(name);
-    else out.push(tool);
-  }
-  if (missing.length > 0) {
-    throw new Error(`unknown tool(s): ${missing.join(", ")}`);
-  }
-  return out;
-}
-function asOpenAiTools(tools) {
-  return tools.map((t) => ({
-    type: "function",
-    function: { name: wireToolName(t.name), description: t.description, parameters: t.parameters }
-  }));
-}
-function wireToolName(local) {
-  return local.replace(/\./g, "_");
-}
-function localToolName(wire) {
-  for (const t of Object.values(TOOLS)) {
-    if (wireToolName(t.name) === wire) return t.name;
-  }
-  return wire;
-}
-
-// src/lib/agent-runtime.ts
-function previewJson(value, max = 500) {
-  let s;
-  try {
-    s = JSON.stringify(value);
-  } catch {
-    s = String(value);
-  }
-  return s.length > max ? `${s.slice(0, max)}\u2026` : s;
-}
-async function runLoop(opts) {
-  const fetchFn = opts.fetchImpl ?? fetch;
-  const trace = [];
-  const messages = [
-    { role: "system", content: opts.systemPrompt },
-    ...opts.history ?? [],
-    { role: "user", content: opts.userMessage }
-  ];
-  const tools = asOpenAiTools(opts.tools);
-  for (let step = 1; step <= opts.maxSteps; step++) {
-    const res = await fetchFn(`${opts.config.apiBase}/chat/completions`, {
-      method: "POST",
-      headers: {
-        "authorization": `Bearer ${opts.config.apiKey}`,
-        "content-type": "application/json"
-      },
-      body: JSON.stringify({
-        model: opts.config.model,
-        messages,
-        ...tools.length > 0 ? { tools, tool_choice: "auto" } : {}
-      })
-    });
-    if (!res.ok) {
-      const text = await res.text().catch(() => "");
-      throw new Error(`LiteLLM ${res.status}: ${text.slice(0, 500)}`);
-    }
-    const data = await res.json();
-    const choice = data.choices?.[0];
-    if (!choice) throw new Error("LiteLLM response had no choices");
-    const assistant = choice.message;
-    messages.push(assistant);
-    if (assistant.content) opts.handlers?.onTextDelta?.(assistant.content);
-    trace.push({
-      step,
-      type: "assistant",
-      preview: previewJson({ content: assistant.content, tool_calls: assistant.tool_calls?.length ?? 0 })
-    });
-    if (!assistant.tool_calls || assistant.tool_calls.length === 0) {
-      const result2 = {
-        status: "ok",
-        finalMessage: assistant.content,
-        stepCount: step,
-        trace
-      };
-      opts.handlers?.onDone?.(result2);
-      return result2;
-    }
-    for (const call of assistant.tool_calls) {
-      const wireName = call.function.name;
-      const localName = localToolName(wireName);
-      const tool = opts.tools.find((t) => t.name === localName);
-      let parsedArgs;
-      try {
-        parsedArgs = JSON.parse(call.function.arguments);
-      } catch {
-        parsedArgs = {};
-      }
-      opts.handlers?.onToolCall?.({ name: localName, args: parsedArgs });
-      trace.push({ step, type: "tool_call", tool: localName, preview: previewJson(parsedArgs) });
-      let result2;
-      let isError = false;
-      if (!tool) {
-        result2 = `unknown tool: ${localName}`;
-        isError = true;
-      } else {
-        try {
-          result2 = await tool.execute(parsedArgs);
-        } catch (err) {
-          result2 = err?.message ?? String(err);
-          isError = true;
-        }
-      }
-      if (isError) {
-        opts.handlers?.onToolError?.({ name: localName, error: String(result2) });
-        trace.push({ step, type: "tool_error", tool: localName, preview: previewJson(result2) });
-      } else {
-        opts.handlers?.onToolResult?.({ name: localName, result: result2 });
-        trace.push({ step, type: "tool_result", tool: localName, preview: previewJson(result2) });
-      }
-      messages.push({
-        role: "tool",
-        tool_call_id: call.id,
-        name: wireToolName(localName),
-        content: typeof result2 === "string" ? result2 : JSON.stringify(result2)
-      });
-    }
-  }
-  const result = {
-    status: "error",
-    finalMessage: `max_steps (${opts.maxSteps}) reached without completion`,
-    stepCount: opts.maxSteps,
-    trace
-  };
-  opts.handlers?.onDone?.(result);
-  return result;
-}
-var RPC_SESSION_TTL_MS = 60 * 60 * 1e3;
-var RpcSessionMap = class {
-  sessions = /* @__PURE__ */ new Map();
-  get(id) {
-    const s = this.sessions.get(id);
-    if (s) s.lastTouched = Date.now();
-    return s;
-  }
-  put(id, s) {
-    s.lastTouched = Date.now();
-    this.sessions.set(id, s);
-  }
-  evictStale() {
-    const cutoff = Date.now() - RPC_SESSION_TTL_MS;
-    for (const [k, v] of this.sessions) {
-      if (v.lastTouched < cutoff) this.sessions.delete(k);
-    }
-  }
-  size() {
-    return this.sessions.size;
-  }
-};
-
-export {
-  CliError,
-  CliExit,
-  parseDuration,
-  TOOLS,
-  taskTools,
-  runLoop,
-  RpcSessionMap
-};
-//# sourceMappingURL=chunk-L2V3CW5B.js.map