@aitne/daemon 0.1.2 → 0.1.4

package/dist/core/routine-acquisition-plan.js

@@ -0,0 +1,268 @@
+/**
+ * `<acquisition-plan>` block assembly for the routine pre-pass fetcher.
+ *
+ * ROUTINE_DATA_ACQUISITION_DESIGN.md §6.4 / F5 — pure helper that the
+ * routine dispatchers (Phase 4) call to render the XML block the
+ * `routine.fetch_window` session reads. Stays I/O-free so it can be
+ * tested in isolation against synthetic integration state.
+ *
+ * The block lists one `<fetch>` element per (integration × mode × account)
+ * combination implied by `ROUTINE_WINDOWS[routine]` and the current
+ * integration state. Disabled integrations, unmapped query cells, and
+ * native bindings whose backend does not match the session are skipped.
+ *
+ * Output shape (§6.4 example, but with substituted timestamps and the
+ * resolved mode-suffix the partial filters on):
+ *
+ * ```xml
+ * <acquisition-plan routine="morning_routine" agent_day="2026-05-11">
+ *   <fetch integration="gmail" mode="direct" window="inbox_today"
+ *          account="alice@gmail.com" query="?days=1&amp;limit=20" />
+ *   ...
+ * </acquisition-plan>
+ * ```
+ */
+import { getAgentDayBoundsUtc, getIntegrationDescriptor, parseSqliteUtcMs, } from "@aitne/shared";
+import { ROUTINE_WINDOWS, WINDOW_QUERIES, } from "./routine-windows.js";
+/**
+ * Compute the timestamp set the assembly helper uses. Anchors to the
+ * agent-day boundary `dayBoundaryHour` (configurable; the daemon's
+ * config default is 4 = 04:00 local per CLAUDE.md), so
+ * `day_start_iso` matches the same UTC instant `getAgentDayBoundsUtc`
+ * uses everywhere else in the daemon.
+ *
+ * The parameter has no built-in default — callers MUST thread
+ * `config.dayBoundaryHour` through so a future config change does not
+ * silently desync this layer from the rest of the daemon. Tests can
+ * pass `0` for stable arithmetic against a UTC fixture.
+ */
+export function buildAcquisitionTimestamps(now, timezone, dayBoundaryHour) {
+    const bounds = getAgentDayBoundsUtc(timezone, dayBoundaryHour, now);
+    const dayStartMs = parseSqliteUtcMs(bounds.start);
+    const dayEndMs = dayStartMs + 24 * 60 * 60 * 1000;
+    const day48Ms = dayStartMs + 48 * 60 * 60 * 1000;
+    const weekStartMs = dayStartMs - 7 * 24 * 60 * 60 * 1000;
+    const weekEndMs = dayStartMs + 7 * 24 * 60 * 60 * 1000;
+    const monthEndMs = dayStartMs + 30 * 24 * 60 * 60 * 1000;
+    const nowMs = now.getTime();
+    const hourStartMs = nowMs - (nowMs % (60 * 60 * 1000));
+    const plus2hMs = nowMs + 2 * 60 * 60 * 1000;
+    const dateOnly = (ms) => new Date(ms).toISOString().slice(0, 10);
+    return {
+        now_iso: new Date(nowMs).toISOString(),
+        hour_start_iso: new Date(hourStartMs).toISOString(),
+        day_start_iso: new Date(dayStartMs).toISOString(),
+        day_end_iso: new Date(dayEndMs).toISOString(),
+        day_plus_24h: new Date(dayEndMs).toISOString(),
+        day_plus_48h: new Date(day48Ms).toISOString(),
+        day_plus_2h: new Date(plus2hMs).toISOString(),
+        week_start_iso: new Date(weekStartMs).toISOString(),
+        week_end_iso: new Date(weekEndMs).toISOString(),
+        month_end_iso: new Date(monthEndMs).toISOString(),
+        day_start_date: dateOnly(dayStartMs),
+        week_start_date: dateOnly(weekStartMs),
+        now_date: dateOnly(nowMs),
+    };
+}
+// ── Internal helpers ───────────────────────────────────────────────────────
+/**
+ * The integrations a window symbol applies to. Used to map a routine's
+ * `RoutineWindowSpec.kind` onto concrete integration keys. Walking
+ * `WINDOW_QUERIES[symbol]` keeps the catalog as the single source of
+ * truth — no hardcoded "mail → gmail+outlook_mail" mapping here.
+ */
+function integrationsForWindow(symbol) {
+    return Object.keys(WINDOW_QUERIES[symbol] ?? {});
+}
+/**
+ * Resolve the integration's runtime mode to the predicate string the
+ * partial filters on. Returns `null` when the row should be skipped
+ * (disabled, missing state, native binding on a different backend).
+ *
+ * §6.8 / §3 glossary — for `userManagedConnector` integrations
+ * (today: `outlook_mail`, `outlook_calendar`) the daemon ships no
+ * `/api/integrations/<key>/exec` proxy, so `delegated-cross` is
+ * unreachable. The dispatcher MUST collapse cross-backend delegated to
+ * `delegated-same` for these descriptors — the only viable path is
+ * the session backend's own MCP, identical to same-backend. Without
+ * this collapse, the partial's `delegated-cross` defensive guard
+ * fires every tick instead of remaining dormant.
+ */
+function resolveFetchMode(integration, state, sessionBackend) {
+    if (!state)
+        return null;
+    switch (state.mode) {
+        case "direct":
+            return "direct";
+        case "delegated":
+            if (state.delegatedBackend === sessionBackend) {
+                return "delegated-same";
+            }
+            // Cross-backend delegated requires a non-null `delegatedBackend`.
+            // Missing binding ≈ misconfiguration → skip.
+            if (state.delegatedBackend !== null
+                && state.delegatedBackend !== undefined) {
+                // User-managed integrations have no daemon proxy; collapse to
+                // same-backend so the partial body's main delegated-same prose
+                // runs instead of its defensive delegated-cross fallback.
+                if (getIntegrationDescriptor(integration).userManagedConnector === true) {
+                    return "delegated-same";
+                }
+                return "delegated-cross";
+            }
+            return null;
+        case "native":
+            // Native binding must match the session backend. Otherwise the
+            // partial's `mode:native:<key>` block would be filtered out by
+            // `applyIntegrationModeFilter` anyway — skip the row to avoid
+            // emitting a `<fetch>` that no branch can handle.
+            if (state.nativeBackend === sessionBackend)
+                return "native";
+            return null;
+        case "disabled":
+            return null;
+        default:
+            return null;
+    }
+}
+/**
+ * Resolve the WINDOW_QUERIES cell for a (symbol, integration, mode)
+ * tuple. delegated-same / delegated-cross both look up "delegated" in
+ * the catalog; the predicate distinction is only meaningful at the
+ * partial-filtering layer.
+ */
+function lookupQuery(symbol, integration, fetchMode) {
+    const catalog = WINDOW_QUERIES[symbol]?.[integration];
+    if (!catalog)
+        return undefined;
+    if (fetchMode === "delegated-same" || fetchMode === "delegated-cross") {
+        return catalog.delegated;
+    }
+    return catalog[fetchMode];
+}
+/**
+ * Substitute `{token}` placeholders in a query string with the
+ * pre-computed timestamps. Unknown tokens are left verbatim — they will
+ * surface as `{foo}` in the rendered prompt, which is visible failure
+ * (the partial author can grep for `{` in their query).
+ */
+export function substituteAcquisitionTokens(query, timestamps) {
+    return query.replace(/\{([a-z_][a-z0-9_]*)\}/g, (match, name) => {
+        const value = timestamps[name];
+        return value ?? match;
+    });
+}
+/**
+ * Attribute escaping for non-query `<fetch>` attribute values
+ * (`integration`, `mode`, `window`, `account`, `label`, and the
+ * block's `routine` / `agent_day`). These are short tokens drawn
+ * from controlled vocabularies; the conventional XML escape set
+ * keeps them robust against future authors who slip a special
+ * character in.
+ */
+function xmlAttr(value) {
+    return value
+        .replace(/&/g, "&amp;")
+        .replace(/"/g, "&quot;")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;");
+}
+/**
+ * Escaping for the `<fetch query='…'>` attribute, which uses
+ * single-quote delimiters so URL query strings can be rendered
+ * verbatim.
+ *
+ * The consumer of this block is the LLM, not an XML parser — the
+ * agent is told to use the `query` attribute literally as a URL
+ * query string (`GET .../messages<query>`) or as MCP-tool arguments
+ * (`q="newer_than:1d"`). Two characters in our catalog would
+ * otherwise need entity-decode steps the agent must remember:
+ *  - `&` separates URL query parameters (`?a=1&b=2`),
+ *  - `"` wraps Gmail / Calendar MCP query expressions
+ *    (`q="newer_than:1d"`, `timeMin="…"`).
+ *
+ * Single-quote delimiters let us keep both literal. The only
+ * character that would now break the attribute structure is `'`,
+ * which no query in `WINDOW_QUERIES` uses today. We escape `'` and
+ * `<` / `>` defensively for any future catalog author who uses
+ * them.
+ */
+function xmlQueryAttr(value) {
+    return value
+        .replace(/'/g, "&apos;")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;");
+}
+function renderFetchRow(row) {
+    const parts = [
+        `integration="${xmlAttr(row.integration)}"`,
+        `mode="${xmlAttr(row.mode)}"`,
+        `window="${xmlAttr(row.window)}"`,
+    ];
+    if (row.accountId !== undefined) {
+        parts.push(`account="${xmlAttr(row.accountId)}"`);
+    }
+    if (row.label !== undefined) {
+        parts.push(`label="${xmlAttr(row.label)}"`);
+    }
+    // Single-quote delimiter on `query=` — see `xmlQueryAttr` rationale.
+    parts.push(`query='${xmlQueryAttr(row.query)}'`);
+    return `  <fetch ${parts.join(" ")} />`;
+}
+// ── Public entry point ────────────────────────────────────────────────────
+/**
+ * Build the `<acquisition-plan>` block string for a routine.
+ *
+ * Pure function: deterministic for a given input. Returns the rendered
+ * XML even when no rows survive — an empty plan still gives the
+ * pre-pass an explicit "nothing to do" signal rather than the absence
+ * of a block.
+ */
+export function buildAcquisitionPlan(input) {
+    const rows = [];
+    const specs = ROUTINE_WINDOWS[input.routine];
+    for (const spec of specs) {
+        const integrations = integrationsForWindow(spec.window);
+        for (const integration of integrations) {
+            const state = input.integrations[integration];
+            const fetchMode = resolveFetchMode(integration, state, input.sessionBackend);
+            if (fetchMode === null)
+                continue;
+            const queryTemplate = lookupQuery(spec.window, integration, fetchMode);
+            if (queryTemplate === undefined)
+                continue;
+            const query = substituteAcquisitionTokens(queryTemplate, input.timestamps);
+            if (spec.perAccount) {
+                const accountRows = input.accounts.filter((a) => a.integration === integration);
+                for (const account of accountRows) {
+                    rows.push({
+                        integration,
+                        mode: fetchMode,
+                        window: spec.window,
+                        accountId: account.accountId,
+                        label: account.label,
+                        query,
+                    });
+                }
+            }
+            else {
+                rows.push({
+                    integration,
+                    mode: fetchMode,
+                    window: spec.window,
+                    query,
+                });
+            }
+        }
+    }
+    // Strip the `routine.` prefix in the attribute for compactness; the
+    // surrounding daemon log carries the full ProcessKey.
+    const routineAttr = input.routine.replace(/^routine\./, "");
+    const lines = [
+        `<acquisition-plan routine="${xmlAttr(routineAttr)}" agent_day="${xmlAttr(input.agentDay)}">`,
+        ...rows.map(renderFetchRow),
+        "</acquisition-plan>",
+    ];
+    return lines.join("\n");
+}
+//# sourceMappingURL=routine-acquisition-plan.js.map

package/dist/core/routine-acquisition-plan.js.map

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

package/dist/core/routine-fetch-window-runner.d.ts

@@ -0,0 +1,201 @@
+/**
+ * `RoutineFetchWindowRunner` — Phase 4 / D1 pre-pass orchestration.
+ *
+ * ROUTINE_DATA_ACQUISITION_DESIGN.md §6.1.1 / Phase 4 D1 — every routine
+ * dispatcher (morning_routine, today_refresh, hourly_check, evening /
+ * weekly / monthly review) calls this runner immediately before
+ * dispatching the parent session. The runner:
+ *
+ *  1. Reads the per-routine plan from `ROUTINE_WINDOWS` and the current
+ *     integration state, fans out per-account where applicable, resolves
+ *     each row's predicate (`direct` / `delegated-same` / `delegated-cross`
+ *     / `native` / skip) via `buildAcquisitionPlan`, and renders an
+ *     `<acquisition-plan>` block.
+ *  2. Synthesises a `routine.fetch_window` RoutineEvent, embeds the plan
+ *     block in `event.data.acquisitionPlanBlock` so ContextBuilder folds
+ *     it into the fetcher's prompt context, and routes the event
+ *     synchronously through the standard `IAgentRouter.execute` /
+ *     `PromptAssembler.assemble` pipeline. The session inherits the
+ *     `routine.fetch_window` ProcessKey binding (lite tier per F1 / §6.9)
+ *     and the dedicated `routine-fetch-window` agent profile.
+ *  3. Parses the agent's single-JSON-line output into a structured
+ *     `FetchReport`, renders a `<fetch_report>` block, and logs one
+ *     `agent_actions` row via the dispatcher's audit logger.
+ *  4. Returns the rendered block + parsed report so the caller can graft
+ *     the block into the **parent** routine event's
+ *     `event.data.fetchReportBlock`. ContextBuilder injects that block
+ *     verbatim into the parent session's prompt (mirrors the
+ *     `<gate_decision>` pattern used by hourly_check Stage 3).
+ *
+ * Failure-mode contract (Phase 4 D1 + design §11 R5 / OQ4):
+ *
+ *  - **No applicable rows** (routine has no windows in `ROUTINE_WINDOWS`,
+ *    every integration is disabled, every account list is empty) — the
+ *    runner returns an empty `<fetch_report>` with `status="skipped"` and
+ *    `fetched=posted=duplicates=0`. The parent routine still runs; the
+ *    block is informational only.
+ *  - **Pre-pass session errors** (binding resolve fails, agent throws,
+ *    JSON parse fails) — the runner logs the failure and returns a
+ *    `<fetch_report status="failed">` with one `pre-pass-failed` error.
+ *    Pre-pass cost gains are forfeit for this tick; the parent routine
+ *    continues with whatever observations the rest of the plan produced.
+ *    Throwing here would otherwise propagate up and abort the parent
+ *    routine — the opposite of P3 ("Lite for Fetch, Medium for Decide").
+ *  - **Partial success** — the report's `errors` array carries per-row
+ *    failures (`no-surface`, `fetch-failed`, `budget-exhausted`). The
+ *    block surfaces them so the parent prompt can decide whether to
+ *    treat its observations view as complete.
+ */
+import type Database from "better-sqlite3";
+import type { BackendId, Event, IntegrationKey, IntegrationState } from "@aitne/shared";
+import type { AgentConfig } from "../config.js";
+import type { MailAccount } from "../services/mail/provider.js";
+import type { IAgentRouter } from "./backends/backend-router.js";
+import type { IAuditLogger, IContextBuilder } from "./dispatcher-types.js";
+import type { PromptAssembler } from "./dispatcher-prompt.js";
+import { type RoutineWindowKey } from "./routine-windows.js";
+/**
+ * Structured form of the agent's single-line JSON output. Matches the
+ * contract in `agent-profiles/routine-fetch-window.md`:
+ *
+ * ```json
+ * {"fetched": <int>, "posted": <int>, "duplicates": <int>, "errors": [...]}
+ * ```
+ *
+ * `status` is the runner's classification of the run — `success` /
+ * `partial` (any errors) / `failed` (parse / agent / dispatch failure) /
+ * `skipped` (no applicable rows). Persisted in the `<fetch_report>`
+ * block so the parent routine can branch deterministically without
+ * re-counting the errors array.
+ */
+export interface FetchReport {
+    status: "success" | "partial" | "failed" | "skipped";
+    fetched: number;
+    posted: number;
+    duplicates: number;
+    errors: ReadonlyArray<Record<string, unknown>>;
+    /** True when the runner skipped dispatching a session entirely. */
+    skipped: boolean;
+    /** Set when status === "failed" — the message captured in the audit row. */
+    failureReason?: string;
+    /** Stable ID for telemetry tie-back; mirrors the fetcher event's correlationId. */
+    fetcherCorrelationId?: string;
+}
+export interface RoutineFetchWindowResult {
+    report: FetchReport;
+    /** XML block to graft into the parent routine event's `event.data.fetchReportBlock`. */
+    block: string;
+}
+export interface RoutineFetchWindowRunnerDeps {
+    db: Database.Database;
+    config: AgentConfig;
+    contextBuilder: IContextBuilder;
+    agentRouter: IAgentRouter;
+    audit: IAuditLogger;
+    prompt: PromptAssembler;
+    /**
+     * Returns the active mail account list — used to fan rows out per
+     * account when `RoutineWindowSpec.perAccount === true`. Threads the
+     * dispatcher's existing `getActiveMailAccounts` closure so the runner
+     * doesn't need to depend on the registry directly.
+     */
+    getActiveMailAccounts: () => readonly MailAccount[];
+}
+/**
+ * Compose the per-execute `allowedToolsOverride` for the pre-pass. The
+ * override REPLACES the SDK's default allowlist (no union per
+ * claude-code-core.ts:437) so the list must be exhaustive for every
+ * surface the partials use under any (integration, mode) cell. Mode
+ * coverage:
+ *
+ *  - `direct`: daemon REST → curl prefix.
+ *  - `delegated-same`: session backend MCP → integration tool name.
+ *  - `delegated-cross`: daemon delegation proxy → curl prefix
+ *    (`/api/integrations/<key>/exec`).
+ *  - `native` (descriptor-bound): session backend MCP → integration
+ *    tool name.
+ *  - `native` (user-managed) / no-surface: nothing in the override —
+ *    the partial records `no-surface` and the runner's report carries
+ *    the gap forward to the parent routine.
+ *
+ * Exported for unit testing — the runner consumes it via
+ * `composePrePassAllowedTools` at dispatch time.
+ */
+export declare function composePrePassAllowedTools(apiPort: number, integrations: Partial<Record<IntegrationKey, IntegrationState>>, sessionBackend: BackendId): readonly string[];
+/**
+ * Derive the canonical `RoutineWindowKey` from a routine event. The
+ * caller's intent is conveyed by `event.type` (always `routine.<name>`),
+ * with `RoutineEvent.routine` carrying the same suffix without the
+ * `routine.` prefix. Returns null for routines outside the catalog so
+ * the caller can short-circuit before touching plan assembly.
+ */
+export declare function routineWindowKeyFromEvent(event: Event): RoutineWindowKey | null;
+/**
+ * Walk `text` and return every balanced `{...}` slice (top-level objects
+ * only; nested braces are honoured). Strings are tracked so brace
+ * characters inside `"..."` literals don't unbalance the scan. Used by
+ * `parseFetchWindowOutput` to pick the LAST top-level object on stdout —
+ * agents occasionally emit a think-aloud line carrying a JSON snippet
+ * before the verdict, and the fetcher's contract is "the last
+ * top-level JSON object wins."
+ *
+ * Exported for direct unit testing; the runner consumes it via
+ * `parseFetchWindowOutput`.
+ */
+export declare function extractBalancedJsonObjects(text: string): string[];
+/** Strict-JSON parse of the fetcher's single-line output. */
+export declare function parseFetchWindowOutput(output: string): FetchReport | {
+    parseError: string;
+};
+/**
+ * Render the `<fetch_report>` XML block injected into the parent
+ * routine's prompt. Keep the schema narrow — every additional attribute
+ * costs prompt tokens on the cache-warm parent session.
+ *
+ * `meta.routine` accepts any string so the no-routine-key skip path can
+ * render the parent event's actual type (e.g. `routine.skill_curation`)
+ * instead of borrowing a catalog entry as a placeholder. The renderer
+ * strips the `routine.` prefix verbatim — callers may pass either the
+ * fully-qualified ProcessKey or a bare suffix.
+ */
+export declare function renderFetchReportBlock(report: FetchReport, meta: {
+    routine: RoutineWindowKey | string;
+    agentDay: string;
+}): string;
+export declare class RoutineFetchWindowRunner {
+    private readonly db;
+    private readonly config;
+    private readonly contextBuilder;
+    private readonly agentRouter;
+    private readonly audit;
+    private readonly prompt;
+    private readonly getActiveMailAccounts;
+    constructor(deps: RoutineFetchWindowRunnerDeps);
+    /**
+     * Execute the pre-pass for `parentEvent`. Returns the fetch report
+     * and rendered `<fetch_report>` block; callers graft the block into
+     * the parent event's `event.data.fetchReportBlock` so ContextBuilder
+     * injects it into the parent prompt.
+     *
+     * `routineKey` overrides the auto-derived window key — used by
+     * morning_routine to opt into `routine.morning_routine_initial`'s
+     * plan when `yesterday.md` is absent (their plans currently coincide,
+     * but the seam exists for future divergence).
+     */
+    run(parentEvent: Event, routineKey?: RoutineWindowKey): Promise<RoutineFetchWindowResult>;
+    /**
+     * Helper for the failure paths — renders a `<fetch_report status="failed">`
+     * block and logs the underlying error. Never throws so the caller can
+     * always continue with the parent routine dispatch.
+     */
+    private fail;
+    /**
+     * Translate the mail registry's active-account list into the
+     * `AcquisitionAccount[]` shape `buildAcquisitionPlan` expects. Only
+     * accounts whose integration is currently non-disabled survive — a
+     * disabled gmail integration with five accounts produces zero rows,
+     * matching the partial's `<!-- mode:disabled:gmail -->` no-op.
+     */
+    private collectAccounts;
+}
+//# sourceMappingURL=routine-fetch-window-runner.d.ts.map

package/dist/core/routine-fetch-window-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routine-fetch-window-runner.d.ts","sourceRoot":"","sources":["../../src/core/routine-fetch-window-runner.ts"],"names":[],"mappings":"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"}