@aitne/daemon 0.1.0

package/dist/api/routes/delegated.js

@@ -0,0 +1,250 @@
+import { Hono } from "hono";
+import { BACKEND_IDS, DELEGATED_TASK_HARD_CAPS, validateRunAllowedTools, } from "@aitne/shared";
+import { checkOutputSchema } from "../../services/delegated-task-runtime.js";
+import { readJsonBody } from "../json-body.js";
+import { createLogger } from "../../logging.js";
+const logger = createLogger("delegated-run-api");
+/**
+ * DELEGATED-TASK-MODE-DESIGN.md §4.2 — `POST /api/delegated/run`. Phase 2
+ * generic task mode: the calling agent (or operator) targets an unregistered
+ * MCP installed under one of the daemon's backends with explicit
+ * `allowedTools` patterns. There is no `INTEGRATION_DESCRIPTORS` entry for
+ * the targeted MCP, so the caller carries the entire scoping responsibility.
+ *
+ * Pre-flight order (cheapest first; mirrors `/exec`):
+ *   1. Body is valid JSON (`readJsonBody` guards a 4 KB schema cap via the
+ *      schema check below; the body itself is only marginally larger than
+ *      the schema).
+ *   2. `delegatedBackend ∈ {claude, gemini}`. Codex returns 501
+ *      `task_mode_unsupported` (Phase 1.5 surface).
+ *   3. `allowedTools` is a non-empty array of well-formed MCP patterns
+ *      (`validateRunAllowedTools`). Bare `*`, leading `*`, prefix-too-short
+ *      globs, and shell metacharacters are rejected at the boundary.
+ *   4. `task` is a non-empty string.
+ *   5. `outputSchema` validates (`checkOutputSchema`). Maps to
+ *      `validation_error` / `schema_too_large` per §10.
+ *   6. Numeric caps are within `DELEGATED_TASK_HARD_CAPS`.
+ *   7. Kill switch (`config.delegatedTaskModeEnabled`): 503 if false.
+ *   8. Invoker wired (501 if not).
+ *
+ * Risk tier: **Approve** (Bearer required) per §4.2 "wider blast radius
+ * than /exec, so the dashboard / setup flow gates it." This deliberately
+ * differs from `/api/integrations/:key/invoke` and `/api/integrations/:key/exec`
+ * (Autonomous), where `state.deniedTools` is the chokepoint — `/run` has
+ * no integration to apply a deny list against, so the trust trigger moves
+ * up to Bearer-gated invocation.
+ *
+ * Note on §13 acceptance ("invoked from a Claude DM session"): DM agents do
+ * not carry the dashboard's Bearer token, so the literal acceptance flow is
+ * a dashboard- or operator-driven invocation that exercises the same
+ * delegated-backend wiring. The design is explicit about Approve-tier; we
+ * honor §4.2 over the §13 prose. Future Phase 2.x work could either ship a
+ * narrowly-scoped agent token or relax to Autonomous behind a per-pattern
+ * registry — both are deferrable.
+ */
+export function createDelegatedRunRoutes(deps) {
+    const app = new Hono();
+    app.post("/delegated/run", async (c) => {
+        const parsedBody = await readJsonBody(c);
+        if (!parsedBody.ok)
+            return parsedBody.response;
+        const body = parsedBody.body;
+        // ── delegatedBackend ─────────────────────────────────────────────────
+        const backendRaw = body?.delegatedBackend;
+        if (typeof backendRaw !== "string"
+            || !BACKEND_IDS.includes(backendRaw)) {
+            return c.json({
+                error: "validation_error",
+                message: `\`delegatedBackend\` must be one of: ${BACKEND_IDS.join(", ")}`,
+                field: "delegatedBackend",
+            }, 400);
+        }
+        // Codex /run landed in Phase 1.5 (alongside /exec) via daemon-side
+        // stream pre-emption. The `backendRaw === "codex"` 501 short-circuit
+        // that previously fired here is removed.
+        const delegatedBackend = backendRaw;
+        // ── allowedTools ─────────────────────────────────────────────────────
+        const allowedToolsRaw = body?.allowedTools;
+        if (!Array.isArray(allowedToolsRaw)) {
+            return c.json({
+                error: "bad_allowed_tools",
+                message: "`allowedTools` must be a non-empty array of pattern strings",
+                field: "allowedTools",
+            }, 400);
+        }
+        const patternCheck = validateRunAllowedTools(allowedToolsRaw);
+        if (!patternCheck.ok) {
+            return c.json({
+                error: "bad_allowed_tools",
+                message: patternCheck.message,
+                field: "allowedTools",
+                pattern: patternCheck.pattern,
+                reason: patternCheck.reason,
+            }, 400);
+        }
+        const allowedTools = allowedToolsRaw;
+        // ── task ─────────────────────────────────────────────────────────────
+        if (typeof body?.task !== "string" || body.task.trim().length === 0) {
+            return c.json({
+                error: "validation_error",
+                message: "`task` must be a non-empty string",
+                field: "task",
+            }, 400);
+        }
+        // ── outputSchema ─────────────────────────────────────────────────────
+        const schemaCheck = checkOutputSchema(body.outputSchema);
+        if (!schemaCheck.ok) {
+            const errorCode = schemaCheck.reason === "too_large"
+                ? "schema_too_large"
+                : "validation_error";
+            return c.json({
+                error: errorCode,
+                message: schemaCheck.message,
+                field: "outputSchema",
+            }, 400);
+        }
+        const outputSchema = body.outputSchema;
+        // ── caps ─────────────────────────────────────────────────────────────
+        const config = deps.config;
+        const allowDestructive = body.allowDestructive === true;
+        const maxToolCalls = clampNumber(body.maxToolCalls, config.delegatedTaskDefaultMaxToolCalls, 1, DELEGATED_TASK_HARD_CAPS.maxToolCalls);
+        if (maxToolCalls === null) {
+            return c.json({
+                error: "validation_error",
+                message: `maxToolCalls must be an integer between 1 and ${DELEGATED_TASK_HARD_CAPS.maxToolCalls}`,
+                field: "maxToolCalls",
+            }, 400);
+        }
+        const maxBudgetUsd = clampNumber(body.maxBudgetUsd, config.delegatedTaskDefaultMaxBudgetUsd, 0, DELEGATED_TASK_HARD_CAPS.maxBudgetUsd, true);
+        if (maxBudgetUsd === null) {
+            return c.json({
+                error: "validation_error",
+                message: `maxBudgetUsd must be a number between 0 and ${DELEGATED_TASK_HARD_CAPS.maxBudgetUsd}`,
+                field: "maxBudgetUsd",
+            }, 400);
+        }
+        const timeoutMs = clampNumber(body.timeoutMs, config.delegatedTaskDefaultTimeoutMs, 1000, DELEGATED_TASK_HARD_CAPS.maxTimeoutMs);
+        if (timeoutMs === null) {
+            return c.json({
+                error: "validation_error",
+                message: `timeoutMs must be an integer between 1000 and ${DELEGATED_TASK_HARD_CAPS.maxTimeoutMs}`,
+                field: "timeoutMs",
+            }, 400);
+        }
+        // ── kill switch ──────────────────────────────────────────────────────
+        if (!config.delegatedTaskModeEnabled) {
+            return c.json({
+                error: "task_mode_disabled",
+                message: "Task mode is currently disabled (config.delegatedTaskModeEnabled=false). Re-enable via PATCH /api/config { delegatedTaskModeEnabled: true }, or flip an integration to delegated to auto-enable.",
+                backend: delegatedBackend,
+                mode: "delegated",
+            }, 503);
+        }
+        // ── invoker wired ────────────────────────────────────────────────────
+        if (!deps.delegatedInvoker) {
+            return c.json({
+                error: "unimplemented",
+                message: "delegated invoker is not wired into this daemon instance",
+                backend: delegatedBackend,
+                mode: "delegated",
+            }, 501);
+        }
+        const result = await deps.delegatedInvoker.run({
+            delegatedBackend,
+            allowedTools,
+            task: body.task.trim(),
+            outputSchema,
+            maxToolCalls,
+            maxBudgetUsd,
+            timeoutMs,
+            allowDestructive,
+            cacheable: body.cacheable === true,
+            ...(c.req.header("x-event-id") ? { parentEventId: c.req.header("x-event-id") } : {}),
+            ...(c.req.header("x-process-key")
+                ? { parentProcessKey: c.req.header("x-process-key") }
+                : {}),
+        });
+        if (result.ok) {
+            return c.json({
+                result: result.result,
+                needsConfirmation: result.needsConfirmation,
+                confirmationPlan: result.confirmationPlan,
+                trace: result.trace,
+                cost: result.cost,
+            });
+        }
+        const status = mapTaskErrorClassToHttpStatus(result.errorClass);
+        logger.warn({
+            backend: delegatedBackend,
+            errorClass: result.errorClass,
+            retried: result.retried ?? false,
+        }, "delegated/run failed");
+        return c.json({
+            error: result.errorClass,
+            message: result.message,
+            ...(result.raw !== undefined ? { raw: result.raw } : {}),
+            ...(result.trace ? { trace: result.trace } : {}),
+            ...(result.cost ? { cost: result.cost } : {}),
+            backend: result.backendId ?? delegatedBackend,
+            mode: "delegated",
+        }, status);
+    });
+    return app;
+}
+/**
+ * §10 error → HTTP status. Identical mapping to the `/exec` route — same
+ * error space (the invoker reuses every error class). Kept inline rather
+ * than importing the route's local function to avoid circular imports
+ * between two route files.
+ */
+function mapTaskErrorClassToHttpStatus(errorClass) {
+    switch (errorClass) {
+        case "task_mode_disabled":
+            return 503;
+        case "task_quota_exhausted":
+            return 429;
+        case "task_mode_unsupported":
+            return 501;
+        case "delegated_proxy_busy":
+            return 503;
+        case "denied_tool":
+            return 403;
+        case "precondition":
+            return 409;
+        case "auth_error":
+            return 502;
+        case "tool_failed":
+        case "tool_unavailable":
+        case "parse_error":
+        case "schema_violation":
+        case "policy_violation":
+        case "post_write_format_failure":
+        case "loop_aborted":
+        case "budget_exhausted":
+            return 502;
+        case "timeout":
+        case "cancelled":
+            return 504;
+        case "subprocess_crashed":
+        default:
+            return 500;
+    }
+}
+/**
+ * Clamp a numeric request-body field to [min, max], applying `defaultValue`
+ * when omitted. Returns null on invalid input. Mirrors the helper in
+ * `routes/integrations.ts:clampNumber` — same shape kept local to avoid
+ * cross-route imports of trivial utilities.
+ */
+function clampNumber(raw, defaultValue, min, max, allowFloat = false) {
+    if (raw === undefined || raw === null)
+        return defaultValue;
+    if (typeof raw !== "number" || !Number.isFinite(raw))
+        return null;
+    if (!allowFloat && !Number.isInteger(raw))
+        return null;
+    if (raw < min || raw > max)
+        return null;
+    return raw;
+}
+//# sourceMappingURL=delegated.js.map

package/dist/api/routes/delegated.js.map

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

package/dist/api/routes/docs.d.ts

@@ -0,0 +1,34 @@
+import { Hono } from "hono";
+import type Database from "better-sqlite3";
+import type { ApiDependencies } from "../server.js";
+import type { DocsIndexerHandle } from "../../core/docs/indexer.js";
+import type { DocsQAAdapter } from "../../adapters/docs-qa-adapter.js";
+/**
+ * Internal dependencies — passed into `createDocsRoutes` separately from
+ * `ApiDependencies` because the indexer handle is built late in startup
+ * (after the db is open) and the API surface should not couple to its
+ * concrete type.
+ */
+export interface DocsRoutesDependencies {
+    db: Database.Database;
+    indexer?: DocsIndexerHandle;
+    /**
+     * Docs QA SSE adapter. When wired (B-7+), `POST /docs/qa/messages`
+     * enqueues a docs_qa MessageEvent through it and `GET /docs/qa/stream`
+     * registers an SSE client. When absent (early-startup ordering, tests
+     * that exercise only the read endpoints) the QA routes return 503.
+     */
+    docsQAAdapter?: DocsQAAdapter;
+}
+export declare function createDocsRoutes(deps: DocsRoutesDependencies): Hono;
+/**
+ * Convenience binding helper for callers that only have an `ApiDependencies`
+ * instance. Equivalent to `createDocsRoutes({ db: deps.db })` but kept as
+ * a separate symbol so the call-site in `server.ts` mirrors how the rest
+ * of the routes are mounted.
+ */
+export declare function createDocsRoutesFromDeps(deps: Pick<ApiDependencies, "db">, extra?: {
+    indexer?: DocsIndexerHandle;
+    docsQAAdapter?: DocsQAAdapter;
+}): Hono;
+//# sourceMappingURL=docs.d.ts.map

package/dist/api/routes/docs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.d.ts","sourceRoot":"","sources":["../../../src/api/routes/docs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAG5B,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEpD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAwNvE;;;;;GAKG;AACH,MAAM,WAAW,sBAAsB;IACrC,EAAE,EAAE,QAAQ,CAAC,QAAQ,CAAC;IACtB,OAAO,CAAC,EAAE,iBAAiB,CAAC;IAC5B;;;;;OAKG;IACH,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,sBAAsB,GAAG,IAAI,CA6dnE;AA+ED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,IAAI,CAAC,eAAe,EAAE,IAAI,CAAC,EACjC,KAAK,GAAE;IAAE,OAAO,CAAC,EAAE,iBAAiB,CAAC;IAAC,aAAa,CAAC,EAAE,aAAa,CAAA;CAAO,GACzE,IAAI,CAEN"}