@agentwares/agentguard 0.1.7 → 0.1.10

package/dist/chunk-JSELR4SG.js

@@ -0,0 +1,780 @@
+import {
+  createHttpHandler,
+  createToolContext,
+  defineTool,
+  listToolManifest,
+  localhostHosts,
+  toolError
+} from "./chunk-IS3DAHZI.js";
+import {
+  RUN
+} from "./chunk-XPNBYSIN.js";
+import {
+  registrationPath,
+  version
+} from "./chunk-4WTFMFRY.js";
+
+// src/proxy/own-tools.ts
+import {
+  buildReport,
+  latestRunId,
+  listRuns,
+  parseAuditJsonl,
+  renderReportMarkdown,
+  resolveToolName,
+  verifyChain
+} from "@agentwares/agentguard-core";
+import { existsSync, readFileSync } from "fs";
+import { z } from "zod";
+var INIT_COMMAND = `${RUN} init`;
+var READ_ONLY = {
+  readOnlyHint: true,
+  destructiveHint: false,
+  idempotentHint: true,
+  openWorldHint: false
+};
+var runIdInput = z.string().min(1).max(128).optional().describe(
+  "Run to read, as it appears in the audit log (for example run_20261007093015_ab12, or the X-Run-Id an HTTP client sent). Omit it for the most recent run."
+);
+var counters = z.record(z.string(), z.number()).describe(
+  "counter name (tool_calls, writes, deletes, emails, spend_usd or a custom one) \u2192 value"
+);
+function readAudit(path) {
+  if (!existsSync(path)) return { exists: false, entries: [] };
+  try {
+    return { exists: true, entries: parseAuditJsonl(readFileSync(path, "utf8")) };
+  } catch (err) {
+    return { exists: true, entries: [], error: err instanceof Error ? err.message : String(err) };
+  }
+}
+function unreadable(path, error) {
+  return toolError({
+    code: "AUDIT_UNREADABLE",
+    cause: `the audit log at ${path} could not be read: ${error}`,
+    fix: "call okgate_verify_audit_log to see where it breaks; a hand-edited or truncated line has to be restored from a copy",
+    retryable: false
+  });
+}
+function numbers(caps) {
+  const out = {};
+  for (const [k, v] of Object.entries(caps)) if (typeof v === "number") out[k] = v;
+  return out;
+}
+function nextStep(runtime) {
+  if (!runtime.configured)
+    return `okgate is guarding nothing: no policy file at ${runtime.loaded.path}. Run \`${INIT_COMMAND}\` in the project directory: it writes okgate.yaml in dry-run mode and routes the project's MCP servers through okgate (backup kept, \`--undo\` restores). Then restart the MCP client.`;
+  if (runtime.policy.upstreams.length === 0)
+    return `${runtime.loaded.path} lists no upstream servers, so okgate is guarding nothing. Add the MCP servers your agent uses under \`upstreams:\` in that file (it has commented examples), then restart the MCP client.`;
+  return "okgate is running; run your agent, then read okgate_get_report.";
+}
+var StatusOutput = z.object({
+  configured: z.boolean().describe("true when a policy file was found and loaded; false means okgate guards nothing"),
+  policy_path: z.string().describe("absolute path of the policy file read, or looked for"),
+  mode: z.enum(["dry-run", "enforce"]).describe("dry-run fakes writes and spends and records them; enforce lets allowed calls run"),
+  upstreams: z.array(
+    z.object({
+      name: z.string().describe("upstream name from the policy"),
+      connected: z.boolean().describe("whether okgate is connected to it"),
+      tools: z.number().int().describe("tools it exposes"),
+      transport: z.enum(["stdio", "http"]).describe("how okgate reaches it"),
+      error: z.string().optional().describe("why it is not connected")
+    })
+  ).describe("the MCP servers this proxy fronts; empty means none are configured"),
+  run_id: z.string().nullable().describe(
+    "run the usage is for: the requested run_id, else the latest run in the log, else null"
+  ),
+  caps: z.object({ per_run: counters, per_day: counters }).describe("limits from the policy; a counter that is absent has no cap"),
+  used: z.object({ per_run: counters, per_day: counters }).describe("what that run, and today, have used against the caps"),
+  remaining: z.record(
+    z.string(),
+    z.object({ per_run: z.number().optional(), per_day: z.number().optional() })
+  ).describe("budget left per capped counter, per run and per day"),
+  kill_switch: z.object({
+    on: z.boolean().describe("true halts every tool call with KILLED"),
+    reason: z.string().optional().describe("why it was pulled"),
+    source: z.string().optional().describe("file, env or memory")
+  }).describe("the kill switch state"),
+  pending_approvals: z.number().int().describe("destructive calls waiting for a human decision"),
+  audit_log: z.object({
+    path: z.string().describe("absolute path of the hash-chained JSONL audit log"),
+    entries: z.number().int().describe("entries in it; 0 when it does not exist yet")
+  }).describe("where every tool call is recorded"),
+  next_step: z.string().describe("the one thing to do next, with the command when there is one")
+});
+var ReportOutput = z.object({
+  configured: z.boolean().describe("false when no policy file was found (okgate guards nothing)"),
+  audit_log_path: z.string().describe("absolute path of the audit log the report was built from"),
+  run_id: z.string().nullable().describe("the run reported on; null when the log has no runs"),
+  runs_in_log: z.number().int().describe("how many runs the audit log holds"),
+  tool_calls: z.number().int().describe("tool calls in this run"),
+  would_have: z.object({
+    creates: z.number().int(),
+    updates: z.number().int(),
+    deletes: z.number().int(),
+    sends: z.number().int(),
+    executes: z.number().int(),
+    spends: z.number().int(),
+    spend_usd: z.number()
+  }).describe("what dry-run mode faked: what the run would have done had the calls executed"),
+  did: z.object({
+    writes: z.number().int(),
+    deletes: z.number().int(),
+    sends: z.number().int(),
+    spend_usd: z.number()
+  }).describe("what actually executed upstream"),
+  halts: z.array(
+    z.object({
+      seq: z.number().int().describe("audit entry number"),
+      ts: z.string().describe("ISO time of the call"),
+      code: z.string().describe("CAP_EXCEEDED, LOOP_DETECTED, KILLED, APPROVAL_REQUIRED, \u2026"),
+      tool: z.string().describe("the tool that was stopped"),
+      cause: z.string().describe("why")
+    })
+  ).describe("every call okgate stopped, in order"),
+  top_tools: z.array(z.object({ tool: z.string(), calls: z.number().int(), class: z.string() })).describe("the most-called tools with their class (read, write, spend)"),
+  markdown: z.string().describe("the same report `okgate report` prints, as Markdown")
+});
+var VerifyOutput = z.object({
+  configured: z.boolean().describe("false when no policy file was found (okgate guards nothing)"),
+  path: z.string().describe("absolute path of the audit log checked"),
+  exists: z.boolean().describe("false when no call has been recorded yet; an absent log verifies"),
+  ok: z.boolean().describe("true when every entry's hash and prev_hash recompute"),
+  entries: z.number().int().describe("entries checked"),
+  head_hash: z.string().nullable().describe(
+    "hash of the last entry; record it with the count to detect entries cut from the end"
+  ),
+  broken_at: z.number().int().nullable().describe("seq of the first entry that does not verify"),
+  reason: z.string().nullable().describe("why verification failed")
+});
+function createOwnTools(runtime) {
+  const status = defineTool({
+    name: "okgate_get_status",
+    title: "okgate status",
+    description: "Report what okgate is guarding right now: the policy file it loaded (or that none was found), dry-run or enforce mode, each upstream MCP server and whether it connected, a run's cap usage and remaining budget, the kill switch, and pending approvals. Call it first to learn whether okgate is set up; next_step says what to do when it is not. For what a run did, use okgate_get_report; to check the log was not edited, okgate_verify_audit_log. Reads local files only and changes nothing.",
+    input: z.strictObject({ run_id: runIdInput }),
+    output: StatusOutput,
+    annotations: { title: "okgate status", ...READ_ONLY },
+    async handler({ run_id }) {
+      const { loaded, guard } = runtime;
+      const audit = readAudit(loaded.auditPath);
+      if (audit.error) throw unreadable(loaded.auditPath, audit.error);
+      const runId = run_id ?? latestRunId(audit.entries) ?? null;
+      const state = await guard.status(runId ?? "(none yet)");
+      const pending = await guard.approvals.list("pending");
+      return {
+        configured: runtime.configured,
+        policy_path: loaded.path,
+        mode: runtime.policy.mode,
+        upstreams: runtime.upstreamStatus(),
+        run_id: runId,
+        caps: { per_run: numbers(state.caps.per_run), per_day: numbers(state.caps.per_day) },
+        used: state.usage,
+        remaining: state.remaining,
+        kill_switch: {
+          on: state.killed.killed,
+          ...state.killed.reason ? { reason: state.killed.reason } : {},
+          ...state.killed.source ? { source: state.killed.source } : {}
+        },
+        pending_approvals: pending.length,
+        audit_log: { path: loaded.auditPath, entries: audit.entries.length },
+        next_step: nextStep(runtime)
+      };
+    }
+  });
+  const report = defineTool({
+    name: "okgate_get_report",
+    title: "okgate run report",
+    description: "Summarize one run from okgate's audit log: how many tool calls, what dry-run mode faked (records it would have created, updated or deleted, messages sent, dollars spent), what really ran upstream, and every call okgate halted with its code and cause. Defaults to the most recent run. Use it after an agent run, before switching a policy from dry-run to enforce; for live caps and the kill switch use okgate_get_status. Read-only: reads the audit file and does not record this call.",
+    input: z.strictObject({ run_id: runIdInput }),
+    output: ReportOutput,
+    annotations: { title: "okgate run report", ...READ_ONLY },
+    handler({ run_id }) {
+      const { loaded } = runtime;
+      const audit = readAudit(loaded.auditPath);
+      if (audit.error) throw unreadable(loaded.auditPath, audit.error);
+      const runs = listRuns(audit.entries);
+      if (run_id && !runs.some((r) => r.runId === run_id)) {
+        throw toolError({
+          code: "NOT_FOUND",
+          cause: `no run "${run_id}" in the audit log at ${loaded.auditPath}`,
+          fix: `call again without run_id for the latest run${runs.length ? `; runs in the log: ${runs.slice(0, 5).map((r) => r.runId).join(", ")}` : "; the log has no runs yet"}`,
+          retryable: false
+        });
+      }
+      const runId = run_id ?? latestRunId(audit.entries) ?? null;
+      const built = buildReport(audit.entries, { runId: runId ?? void 0 });
+      const markdown = runId ? renderReportMarkdown(built) : `# okgate report
+
+No runs recorded in ${loaded.auditPath} yet. ${nextStep(runtime)}`;
+      return {
+        configured: runtime.configured,
+        audit_log_path: loaded.auditPath,
+        run_id: runId,
+        runs_in_log: runs.length,
+        tool_calls: runId ? audit.entries.filter((e) => e.run_id === runId).length : 0,
+        would_have: {
+          creates: built.wouldHave.creates,
+          updates: built.wouldHave.updates,
+          deletes: built.wouldHave.deletes,
+          sends: built.wouldHave.sends,
+          executes: built.wouldHave.executes,
+          spends: built.wouldHave.spends,
+          spend_usd: built.wouldHave.spendUsd
+        },
+        did: {
+          writes: built.did.writes,
+          deletes: built.did.deletes,
+          sends: built.did.sends,
+          spend_usd: built.did.spendUsd
+        },
+        halts: built.halts,
+        top_tools: built.topTools,
+        markdown
+      };
+    }
+  });
+  const verify = defineTool({
+    name: "okgate_verify_audit_log",
+    title: "Verify okgate audit log",
+    description: "Recompute the hash chain of okgate's audit log (JSONL, one entry per tool call) and say whether any entry was edited, removed from the middle or reordered, naming the first broken entry. Returns the entry count and head hash; record both elsewhere, because entries cut from the end of the file still verify. Use it before trusting okgate_get_report. Takes no arguments: it checks the log the loaded policy names. Read-only; a log that does not exist yet verifies as empty.",
+    input: z.strictObject({}),
+    output: VerifyOutput,
+    annotations: { title: "Verify okgate audit log", ...READ_ONLY },
+    async handler() {
+      const { loaded } = runtime;
+      const audit = readAudit(loaded.auditPath);
+      if (audit.error) {
+        return {
+          configured: runtime.configured,
+          path: loaded.auditPath,
+          exists: true,
+          ok: false,
+          entries: 0,
+          head_hash: null,
+          broken_at: null,
+          reason: audit.error
+        };
+      }
+      const result = await verifyChain(audit.entries);
+      return {
+        configured: runtime.configured,
+        path: loaded.auditPath,
+        exists: audit.exists,
+        ok: result.ok,
+        entries: result.entries,
+        // an empty chain's head is the genesis hash, which is not an entry anyone can record
+        head_hash: result.entries > 0 ? result.head ?? null : null,
+        broken_at: result.brokenAt ?? null,
+        reason: result.reason ?? null
+      };
+    }
+  });
+  return [status, report, verify];
+}
+function ownToolsActive(runtime) {
+  return runtime.upstreamStatus().length === 0;
+}
+function ownToolList(tools) {
+  return listToolManifest(tools);
+}
+async function callOwnTool(tools, name, args, requestId, now = /* @__PURE__ */ new Date()) {
+  const resolved = resolveToolName(name, (n) => tools.some((t) => t.name === n), now);
+  if (resolved.kind === "expired")
+    return {
+      isError: true,
+      content: [{ type: "text", text: JSON.stringify(resolved.error) }],
+      _meta: { httpStatus: 404 }
+    };
+  const tool = tools.find((t) => t.name === resolved.name);
+  if (!tool) return void 0;
+  const result = await tool.invoke(args, createToolContext({ requestId }));
+  if (resolved.kind === "renamed")
+    return { ...result, _meta: { ...result._meta, ...resolved.meta } };
+  return result;
+}
+
+// src/proxy/server.ts
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import {
+  CallToolRequestSchema,
+  CompleteRequestSchema,
+  GetPromptRequestSchema,
+  ListPromptsRequestSchema,
+  ListResourceTemplatesRequestSchema,
+  ListResourcesRequestSchema,
+  ListToolsRequestSchema,
+  ReadResourceRequestSchema,
+  SetLevelRequestSchema,
+  SubscribeRequestSchema,
+  UnsubscribeRequestSchema
+} from "@modelcontextprotocol/sdk/types.js";
+import {
+  keyFromHeaders,
+  resolveAgent
+} from "@agentwares/agentguard-core";
+var PROXY_VERSION = version();
+function headerValue(extra, name) {
+  const raw = extra.requestInfo?.headers?.[name] ?? extra.requestInfo?.headers?.[name.toLowerCase()];
+  if (Array.isArray(raw)) return raw[0];
+  return typeof raw === "string" ? raw : void 0;
+}
+function headersOf(extra) {
+  const out = {};
+  for (const [k, v] of Object.entries(extra.requestInfo?.headers ?? {}))
+    out[k.toLowerCase()] = Array.isArray(v) ? v[0] : v;
+  return out;
+}
+function runIdFor(extra, meta, fallback) {
+  const header = headerValue(extra, "x-run-id");
+  if (header && header.trim()) return header.trim().slice(0, 128);
+  const fromMeta = meta?.runId ?? meta?.["okgate/runId"] ?? meta?.["agentguard/runId"] ?? meta?.run_id;
+  if (typeof fromMeta === "string" && fromMeta.trim()) return fromMeta.trim().slice(0, 128);
+  if (extra.sessionId) return `sess_${extra.sessionId.slice(0, 12)}`;
+  return fallback;
+}
+function toCallToolResult(result, tool) {
+  const verdict = {
+    class: result.decision.classification.class,
+    verb: result.decision.classification.verb,
+    mode: result.decision.mode,
+    outcome: result.outcome,
+    dryRun: result.faked,
+    seq: result.entry.seq,
+    run_id: result.entry.run_id
+  };
+  const meta = { okgate: verdict, agentguard: verdict };
+  const hasOutputSchema = Boolean(tool?.tool.outputSchema);
+  if (result.error) {
+    const upstream2 = result.value;
+    if (upstream2 && upstream2.content) {
+      return { ...upstream2, isError: true, _meta: { ...upstream2._meta ?? {}, ...meta } };
+    }
+    const body = result.error;
+    return {
+      isError: true,
+      content: [{ type: "text", text: JSON.stringify(body) }],
+      ...hasOutputSchema ? {} : { structuredContent: body },
+      _meta: { ...meta, httpStatus: httpStatusFor(body.code) }
+    };
+  }
+  if (result.faked) {
+    const value = result.value;
+    const isObject = value !== null && typeof value === "object" && !Array.isArray(value);
+    return {
+      content: [
+        { type: "text", text: typeof value === "string" ? value : JSON.stringify(value, null, 2) }
+      ],
+      ...isObject ? { structuredContent: value } : {},
+      _meta: meta
+    };
+  }
+  const upstream = result.value;
+  return { ...upstream, _meta: { ...upstream._meta ?? {}, ...meta } };
+}
+function httpStatusFor(code) {
+  switch (code) {
+    case "KILLED":
+    case "TOOL_DENIED":
+    case "APPROVAL_DENIED":
+      return 403;
+    case "APPROVAL_REQUIRED":
+      return 202;
+    case "CAP_EXCEEDED":
+    case "LOOP_DETECTED":
+      return 429;
+    case "UNKNOWN_TOOL":
+      return 404;
+    case "UPSTREAM_ERROR":
+      return 502;
+    default:
+      return 500;
+  }
+}
+function annotateTool(t, mode) {
+  return {
+    ...t.tool,
+    name: t.name,
+    _meta: {
+      ...t.tool._meta ?? {},
+      okgate: {
+        upstream: t.upstream,
+        class: t.classification.class,
+        verb: t.classification.verb,
+        mode
+      }
+    }
+  };
+}
+function killedError(state) {
+  return Object.assign(
+    new Error(`okgate kill switch is on (${state.source ?? "?"}: ${state.reason ?? ""})`),
+    { code: -32e3 }
+  );
+}
+function serverInstructions(runtime) {
+  if (ownToolsActive(runtime))
+    return `okgate is an MCP policy proxy, and this one fronts no upstream MCP servers${runtime.configured ? "" : ` (no policy file at ${runtime.loaded.path})`}, so it serves only its own read-only tools: okgate_get_status (what it guards, caps, kill switch), okgate_get_report (what a run did or would have done) and okgate_verify_audit_log. To guard the user's MCP servers, run \`${INIT_COMMAND}\` in the project directory and restart the client.`;
+  return `Tool calls pass through okgate (${runtime.policy.mode} mode). Errors carry { code, cause, fix, retryable }; follow "fix". CAP_EXCEEDED, LOOP_DETECTED and KILLED are not retryable: stop and report to the user. APPROVAL_REQUIRED: relay the approval command to the user, then retry the identical call once.`;
+}
+function createDownstreamServer(runtime, opts = {}) {
+  const server = new McpServer(
+    { name: "okgate", version: PROXY_VERSION, title: "okgate policy proxy" },
+    {
+      capabilities: {
+        tools: { listChanged: true },
+        resources: { subscribe: true, listChanged: true },
+        prompts: { listChanged: true },
+        logging: {},
+        completions: {}
+      },
+      instructions: serverInstructions(runtime)
+    }
+  );
+  const ownTools = createOwnTools(runtime);
+  const session = {
+    id: crypto.randomUUID(),
+    server,
+    lastActive: Date.now(),
+    inflight: /* @__PURE__ */ new Map()
+  };
+  runtime.attach(session);
+  const previousOnClose = server.server.onclose;
+  server.server.onclose = () => {
+    previousOnClose?.();
+    runtime.detach(session);
+  };
+  const touch = () => {
+    session.lastActive = Date.now();
+  };
+  const agentFor = async (extra) => {
+    const key = keyFromHeaders(headersOf(extra));
+    if (!key) return { agent: void 0 };
+    const resolved = await resolveAgent(runtime.policy, { key });
+    if (resolved.error) {
+      return {
+        agent: null,
+        error: {
+          code: "TOOL_DENIED",
+          cause: "the agent key in Authorization / X-Agentguard-Key is not in okgate.yaml",
+          fix: "use a key created with `okgate key create <agent>`, or omit the key to use the global policy",
+          retryable: false
+        }
+      };
+    }
+    return { agent: resolved.agent };
+  };
+  const low = server.server;
+  low.setRequestHandler(ListToolsRequestSchema, async (_req, extra) => {
+    touch();
+    const { agent } = await agentFor(extra);
+    const scope = agent === void 0 ? runtime.agent : agent;
+    if (ownToolsActive(runtime)) return { tools: ownToolList(ownTools) };
+    return {
+      tools: runtime.listTools(scope).map((t) => annotateTool(t, scope?.mode ?? runtime.policy.mode))
+    };
+  });
+  low.setRequestHandler(CallToolRequestSchema, async (req, extra) => {
+    touch();
+    if (ownToolsActive(runtime)) {
+      const own = await callOwnTool(
+        ownTools,
+        req.params.name,
+        req.params.arguments ?? {},
+        String(extra.requestId)
+      );
+      if (own) return own;
+    }
+    const { agent, error } = await agentFor(extra);
+    const runId = runIdFor(extra, req.params._meta, opts.defaultRunId ?? runtime.defaultRunId);
+    if (error) {
+      return {
+        isError: true,
+        content: [{ type: "text", text: JSON.stringify(error) }],
+        structuredContent: error,
+        _meta: { httpStatus: 401 }
+      };
+    }
+    const progressToken = req.params._meta?.progressToken;
+    const { result, tool } = await runtime.callTool(req.params.name, req.params.arguments ?? {}, {
+      runId,
+      agent,
+      sessionId: extra.sessionId ?? session.id,
+      session,
+      requestId: extra.requestId,
+      onprogress: progressToken === void 0 ? void 0 : (p) => {
+        void extra.sendNotification({
+          method: "notifications/progress",
+          params: { progressToken, ...p }
+        });
+      }
+    });
+    return toCallToolResult(result, tool);
+  });
+  const guardRead = async () => {
+    const state = await runtime.guard.killState();
+    if (state.killed) throw killedError(state);
+  };
+  low.setRequestHandler(ListResourcesRequestSchema, async () => {
+    touch();
+    return runtime.listResources();
+  });
+  low.setRequestHandler(ListResourceTemplatesRequestSchema, async () => {
+    touch();
+    return runtime.listResourceTemplates();
+  });
+  low.setRequestHandler(ReadResourceRequestSchema, async (req) => {
+    touch();
+    await guardRead();
+    return runtime.readResource(req.params.uri);
+  });
+  low.setRequestHandler(SubscribeRequestSchema, async (req) => {
+    await runtime.subscribe(req.params.uri, true);
+    return {};
+  });
+  low.setRequestHandler(UnsubscribeRequestSchema, async (req) => {
+    await runtime.subscribe(req.params.uri, false);
+    return {};
+  });
+  low.setRequestHandler(ListPromptsRequestSchema, async () => {
+    touch();
+    return runtime.listPrompts();
+  });
+  low.setRequestHandler(GetPromptRequestSchema, async (req) => {
+    touch();
+    await guardRead();
+    return runtime.getPrompt(req.params.name, req.params.arguments);
+  });
+  low.setRequestHandler(CompleteRequestSchema, async (req) => {
+    touch();
+    return runtime.complete(req.params);
+  });
+  low.setRequestHandler(SetLevelRequestSchema, async (req) => {
+    await runtime.setLevel(req.params.level);
+    return {};
+  });
+  return server;
+}
+
+// src/proxy/http.ts
+import { writeFileSync, unlinkSync, existsSync as existsSync2, mkdirSync } from "fs";
+import { createServer } from "http";
+import { killSwitchFor } from "@agentwares/agentguard-core/node";
+function json(res, status, body) {
+  res.writeHead(status, { "Content-Type": "application/json", "Cache-Control": "no-store" });
+  res.end(JSON.stringify(body));
+}
+function html(res, status, body) {
+  res.writeHead(status, {
+    "Content-Type": "text/html; charset=utf-8",
+    "Cache-Control": "no-store"
+  });
+  res.end(
+    `<!doctype html><meta name="viewport" content="width=device-width"><body style="font:16px system-ui;padding:2rem;max-width:40rem">${body}</body>`
+  );
+}
+async function readBody(req) {
+  if (req.method === "GET" || req.method === "HEAD") return void 0;
+  const chunks = [];
+  for await (const chunk of req) chunks.push(chunk);
+  return new Uint8Array(Buffer.concat(chunks));
+}
+function isLoopback(host) {
+  return host === "127.0.0.1" || host === "localhost" || host === "::1" || host === "[::1]";
+}
+async function startHttpProxy(opts) {
+  const { runtime } = opts;
+  const host = opts.host ?? "127.0.0.1";
+  const path = opts.path ?? "/mcp";
+  const token = opts.token ?? crypto.randomUUID().replace(/-/g, "");
+  const kill = killSwitchFor(runtime.loaded);
+  const holder = {};
+  const server = createServer((req, res) => {
+    void (async () => {
+      const url2 = new URL(req.url ?? "/", `http://${req.headers.host ?? host}`);
+      const authorized = () => {
+        const q = url2.searchParams.get("token");
+        const h = req.headers.authorization?.replace(/^Bearer\s+/i, "");
+        return q === token || h === token;
+      };
+      if (url2.pathname === path && holder.mcp) {
+        const headers = new Headers();
+        for (const [k, v] of Object.entries(req.headers)) {
+          if (Array.isArray(v)) for (const item of v) headers.append(k, item);
+          else if (typeof v === "string") headers.set(k, v);
+        }
+        const controller = new AbortController();
+        res.on("close", () => {
+          if (!res.writableFinished) controller.abort();
+        });
+        const response = await holder.mcp(
+          new Request(url2, {
+            method: req.method ?? "GET",
+            headers,
+            body: await readBody(req),
+            signal: controller.signal
+          })
+        );
+        const out = {};
+        response.headers.forEach((v, k) => {
+          out[k] = v;
+        });
+        res.writeHead(response.status, out);
+        if (!response.body) return res.end();
+        const reader = response.body.getReader();
+        try {
+          for (; ; ) {
+            const { done, value } = await reader.read();
+            if (done) break;
+            res.write(value);
+          }
+        } catch {
+        }
+        return res.end();
+      }
+      if (url2.pathname === "/health") {
+        const killed = await runtime.guard.killState();
+        return json(res, 200, {
+          ok: true,
+          name: "okgate",
+          version: PROXY_VERSION,
+          mode: runtime.policy.mode,
+          killed: killed.killed,
+          upstreams: runtime.upstreamStatus(),
+          tools: runtime.listTools().length,
+          mcp: `${url2.origin}${path}`
+        });
+      }
+      if (url2.pathname === "/status") {
+        if (!authorized()) return json(res, 401, unauthorized());
+        const runId = url2.searchParams.get("run") ?? runtime.defaultRunId;
+        return json(res, 200, { runId, ...await runtime.guard.status(runId) });
+      }
+      if (url2.pathname === "/kill" && req.method === "POST") {
+        if (!authorized()) return json(res, 401, unauthorized());
+        const body = await readBody(req);
+        let reason = "killed via HTTP";
+        try {
+          const parsed = JSON.parse(Buffer.from(body ?? []).toString("utf8") || "{}");
+          if (parsed.reason) reason = String(parsed.reason).slice(0, 200);
+        } catch {
+        }
+        kill.kill(reason);
+        await runtime.guard.halt(reason);
+        return json(res, 200, { killed: true, reason });
+      }
+      if (url2.pathname === "/resume" && req.method === "POST") {
+        if (!authorized()) return json(res, 401, unauthorized());
+        kill.resume();
+        await runtime.guard.resume();
+        return json(res, 200, { killed: false });
+      }
+      const decision = /^\/(approve|deny)\/([A-Za-z0-9_-]+)$/.exec(url2.pathname);
+      if (decision) {
+        if (!authorized()) return json(res, 401, unauthorized());
+        const [, action, id] = decision;
+        const record = await runtime.guard.decide(
+          id,
+          action === "approve" ? "approved" : "denied",
+          "http"
+        );
+        if (!record)
+          return json(res, 404, {
+            code: "NOT_FOUND",
+            cause: `no approval ${id}`,
+            fix: "list pending approvals with `okgate approvals`",
+            retryable: false
+          });
+        if (req.headers.accept?.includes("text/html")) {
+          return html(
+            res,
+            200,
+            `<h1>${record.status === "approved" ? "Approved" : record.status === "denied" ? "Denied" : record.status}</h1><p><code>${record.tool}</code> \u2014 approval <code>${record.id}</code>.</p><p>The agent may now retry the call once.</p>`
+          );
+        }
+        return json(res, 200, record);
+      }
+      if (url2.pathname === "/approvals") {
+        if (!authorized()) return json(res, 401, unauthorized());
+        return json(res, 200, {
+          approvals: await runtime.guard.approvals.list(
+            url2.searchParams.get("all") ? void 0 : "pending"
+          )
+        });
+      }
+      return json(res, 404, {
+        code: "NOT_FOUND",
+        cause: `no route for ${url2.pathname}`,
+        fix: `POST JSON-RPC to ${path}; GET /health`,
+        retryable: false
+      });
+    })().catch((err) => {
+      if (!res.headersSent)
+        json(res, 500, {
+          code: "INTERNAL",
+          cause: err instanceof Error ? err.message : String(err),
+          fix: "retry; if it persists, report the request",
+          retryable: false
+        });
+      else res.end();
+    });
+  });
+  await new Promise((resolve, reject) => {
+    server.once("error", reject);
+    server.listen(opts.port ?? 8788, host, () => resolve());
+  });
+  const address = server.address();
+  const port = typeof address === "object" && address ? address.port : opts.port ?? 8788;
+  holder.mcp = createHttpHandler(() => createDownstreamServer(runtime), {
+    sessions: true,
+    jsonResponse: false,
+    cors: true,
+    allowedHosts: isLoopback(host) ? localhostHosts(port) : void 0,
+    enableDnsRebindingProtection: isLoopback(host)
+  });
+  const baseUrl = `http://${host}:${port}`;
+  const url = `${baseUrl}${path}`;
+  const regFile = registrationPath(runtime.loaded.stateDir);
+  if (opts.registerFile !== false) {
+    mkdirSync(runtime.loaded.stateDir, { recursive: true });
+    const reg = {
+      url,
+      baseUrl,
+      token,
+      pid: process.pid,
+      startedAt: (/* @__PURE__ */ new Date()).toISOString()
+    };
+    writeFileSync(regFile, JSON.stringify(reg, null, 2));
+  }
+  return {
+    url,
+    port,
+    token,
+    close: () => new Promise((resolve, reject) => {
+      if (opts.registerFile !== false && existsSync2(regFile)) {
+        try {
+          unlinkSync(regFile);
+        } catch {
+        }
+      }
+      server.closeAllConnections();
+      server.close((err) => err ? reject(err) : resolve());
+    })
+  };
+}
+function unauthorized() {
+  return {
+    code: "UNAUTHORIZED",
+    cause: "missing or wrong control token",
+    fix: "pass ?token=<token> or Authorization: Bearer <token> from <state>/http.json",
+    retryable: false
+  };
+}
+
+export {
+  INIT_COMMAND,
+  runIdFor,
+  toCallToolResult,
+  createDownstreamServer,
+  startHttpProxy
+};
+//# sourceMappingURL=chunk-JSELR4SG.js.map