@aitne/daemon 0.1.10 → 0.1.11

package/dist/api/routes/agents/index.js

@@ -4,13 +4,14 @@ import { dirname, join } from "node:path";
 import { formatSqliteDatetime } from "@aitne/shared";
 import { createLogger } from "../../../logging.js";
 import { readJsonBody } from "../../json-body.js";
-import { deleteAgent, getAgent, getOverrideSnapshot, listAgents, setEnabled, setOverrideSnapshot, } from "../../../db/agents-store.js";
+import { deleteAgent, getAgent, getOverrideSnapshot, getRuntimeWindow, listAgents, setEnabled, setOverrideSnapshot, setRuntimeWindow, } from "../../../db/agents-store.js";
 import { byErrorKind, getExecution, listExecutions, metricsWindow, } from "../../../db/agent-executions-store.js";
 import { deleteRecurringSchedule, getRecurringSchedule, updateRecurringSchedule, } from "../../../db/recurring-schedules.js";
 import { loadEffectiveDefinition } from "../../../core/agents/effective-definition.js";
 import { loadAgents } from "../../../core/agents/loader.js";
 import { buildAgentLoadOptions } from "../../../core/agents/loader-boot.js";
-import { resolveRuntimeWindowCadence } from "../../../core/agents/builtin-registry.js";
+import { getBuiltinRegistryEntry, resolveRuntimeWindowCadence, } from "../../../core/agents/builtin-registry.js";
+import { mergeRuntimeWindow, resolveActivityScanCadence, } from "../../../core/agents/activity-scan-cadence.js";
 import { buildDetail, buildListItem, buildRow, planCreate, planPatch, planRunNow, serializeExecution, } from "./views.js";
 /**
  * `/api/agents/*` route surface (AGENT_DEFINITIONS_DESIGN.md §9). Thin Hono
@@ -22,6 +23,19 @@ import { buildDetail, buildListItem, buildRow, planCreate, planPatch, planRunNow
  * is pinned by the behavioural `agents.test.ts`.
  */
 const logger = createLogger("agents-api");
+/**
+ * v0.1.10 → v0.1.11: the `hourly-check` built-in became `activity-scan`.
+ * Old URLs (`/api/agents/hourly-check`, bookmarks, in-flight skills) keep
+ * working for one deprecation window — same in-process normalization
+ * pattern as `context-vault-aliases.ts` (never an HTTP redirect, so
+ * `curl -X PATCH` without `-L` keeps working). Remove after a minor release.
+ */
+const LEGACY_AGENT_SLUG_ALIASES = {
+    "hourly-check": "activity-scan",
+};
+function normalizeSlug(raw) {
+    return LEGACY_AGENT_SLUG_ALIASES[raw] ?? raw;
+}
 /** Per-Agent 7d-metrics cache (§9.1 — "cached in-memory for 60 seconds"). */
 const METRICS_TTL_MS = 60_000;
 const EXECUTION_RESULTS = new Set([
@@ -34,15 +48,37 @@ export function createAgentDefinitionRoutes(deps) {
     const app = new Hono();
     const { db, config } = deps;
     const dayBoundaryHour = config.dayBoundaryHour;
-    // Live interval cadence for a runtime-window built-in (hourly-check), or null
-    // for every other Agent. Reads `config` at call time — `applyConfigUpdates`
-    // mutates it in place (Object.assign), so a runtime interval/active-hours
-    // change via PATCH /api/config is reflected here without a daemon restart.
-    const cadenceFor = (slug) => resolveRuntimeWindowCadence(slug, {
-        hourlyCheckIntervalMinutes: config.hourlyCheckIntervalMinutes,
-        hourlyCheckActiveStartHour: config.hourlyCheckActiveStartHour,
-        hourlyCheckActiveEndHour: config.hourlyCheckActiveEndHour,
-    });
+    // Live interval cadence for a runtime-window built-in (activity-scan), or null
+    // for every other Agent. The agent row's `runtime_window` overrides win;
+    // the legacy `activityScan*` config keys are the per-field fallback
+    // (AGENTS_HUB_REDESIGN_PLAN §2). Read at call time so a PATCH is reflected
+    // immediately.
+    const cadenceFor = (slug) => {
+        const resolved = resolveActivityScanCadence(getRuntimeWindow(db, "activity-scan"), config);
+        return resolveRuntimeWindowCadence(slug, {
+            activityScanIntervalMinutes: resolved.intervalMinutes,
+            activityScanActiveStartHour: resolved.activeStartHour,
+            activityScanActiveEndHour: resolved.activeEndHour,
+        });
+    };
+    // Runtime-window block for the detail envelope — only for the
+    // runtime-window built-in (registry cron resolver === null).
+    const scheduleWindowFor = (slug) => {
+        const entry = getBuiltinRegistryEntry(slug);
+        if (!entry || entry.cronExpression !== null)
+            return null;
+        const overrides = getRuntimeWindow(db, slug);
+        const resolved = resolveActivityScanCadence(overrides, config);
+        return {
+            overrides: overrides,
+            resolved: {
+                interval_minutes: resolved.intervalMinutes,
+                active_start_hour: resolved.activeStartHour,
+                active_end_hour: resolved.activeEndHour,
+                min_observations: resolved.minObservations,
+            },
+        };
+    };
     const readDefinitionFile = (path) => {
         try {
             return existsSync(path) ? readFileSync(path, "utf-8") : null;
@@ -168,7 +204,7 @@ export function createAgentDefinitionRoutes(deps) {
     });
     // ── GET /agents/:slug (§9.2) ────────────────────────────────────────────
     app.get("/agents/:slug", (c) => {
-        const slug = c.req.param("slug");
+        const slug = normalizeSlug(c.req.param("slug"));
         const dto = getAgent(db, slug);
         if (!dto)
             return c.json({ error: "agent_not_found", slug }, 404);
@@ -185,12 +221,13 @@ export function createAgentDefinitionRoutes(deps) {
             metrics30d: metricsWindow(db, slug, 30),
             byErrorKind7d: byErrorKind(db, slug, 7),
             intervalCadence: cadenceFor(slug),
+            scheduleWindow: scheduleWindowFor(slug),
         });
         return c.json(detail);
     });
     // ── GET /agents/:slug/executions (§9.3) ─────────────────────────────────
     app.get("/agents/:slug/executions", (c) => {
-        const slug = c.req.param("slug");
+        const slug = normalizeSlug(c.req.param("slug"));
         if (!getAgent(db, slug))
             return c.json({ error: "agent_not_found", slug }, 404);
         const limitRaw = Number.parseInt(c.req.query("limit") ?? "25", 10);
@@ -211,7 +248,7 @@ export function createAgentDefinitionRoutes(deps) {
     });
     // ── POST /agents/:slug/run-now (§9.4) ───────────────────────────────────
     app.post("/agents/:slug/run-now", async (c) => {
-        const slug = c.req.param("slug");
+        const slug = normalizeSlug(c.req.param("slug"));
         const dto = getAgent(db, slug);
         if (!dto)
             return c.json({ error: "agent_not_found", slug }, 404);
@@ -288,7 +325,7 @@ export function createAgentDefinitionRoutes(deps) {
     });
     // ── PATCH /agents/:slug (§9.5) ──────────────────────────────────────────
     app.patch("/agents/:slug", async (c) => {
-        const slug = c.req.param("slug");
+        const slug = normalizeSlug(c.req.param("slug"));
         const dto = getAgent(db, slug);
         if (!dto)
             return c.json({ error: "agent_not_found", slug }, 404);
@@ -307,6 +344,15 @@ export function createAgentDefinitionRoutes(deps) {
             return c.json({ error: plan.error, ...(plan.hint ? { hint: plan.hint } : {}), ...(plan.field ? { field: plan.field } : {}) }, 400);
         }
         const now = Date.now();
+        // Validate the schedule_window merge BEFORE applying anything so a bad
+        // window can't leave a half-applied PATCH (enabled flipped, window 400d).
+        let mergedWindow;
+        if (plan.scheduleWindow !== undefined) {
+            mergedWindow = mergeRuntimeWindow(getRuntimeWindow(db, slug), plan.scheduleWindow, config);
+            if (!mergedWindow.ok) {
+                return c.json({ error: mergedWindow.error, field: mergedWindow.field }, 400);
+            }
+        }
         if (plan.setEnabled !== undefined) {
             setEnabled(db, slug, plan.setEnabled, now, now);
             deps.agentEnabledCache?.invalidate();
@@ -337,6 +383,19 @@ export function createAgentDefinitionRoutes(deps) {
                 reset: plan.overrideReset,
             });
         }
+        if (mergedWindow?.ok) {
+            setRuntimeWindow(db, slug, mergedWindow.value, now);
+            recordAudit("agent.schedule_window_changed", slug, {
+                window: mergedWindow.value,
+                cadence_changed: mergedWindow.cadenceChanged,
+            });
+            // Interval / active-hours edits change the registered cron expression;
+            // rebuild live (same mechanism the dashboard config PATCH used for the
+            // legacy keys). min_observations is fire-time-only — no rebuild.
+            if (mergedWindow.cadenceChanged) {
+                deps.onScheduleConfigChanged?.();
+            }
+        }
         if (plan.stripped.length > 0) {
             logger.info({ slug, stripped: plan.stripped }, "PATCH /agents stripped read-only fields");
         }
@@ -346,7 +405,7 @@ export function createAgentDefinitionRoutes(deps) {
     });
     // ── DELETE /agents/:slug (§9.6) ─────────────────────────────────────────
     app.delete("/agents/:slug", async (c) => {
-        const slug = c.req.param("slug");
+        const slug = normalizeSlug(c.req.param("slug"));
         const dto = getAgent(db, slug);
         if (!dto)
             return c.json({ error: "agent_not_found", slug }, 404);

package/dist/api/routes/agents/views.d.ts

@@ -1,6 +1,6 @@
 import type { AgentDefinition, StopWarning } from "@aitne/shared";
 import { OVERRIDE_EDIT_PATHS } from "@aitne/shared";
-import type { IntervalCadence } from "../../../core/agents/builtin-registry.js";
+import type { AgentPolicyFile, IntervalCadence } from "../../../core/agents/builtin-registry.js";
 import type { AgentDTO } from "../../../db/agents-store.js";
 import type { AgentExecutionDTO, AgentMetricsWindow } from "../../../db/agent-executions-store.js";
 /**
@@ -24,13 +24,26 @@ export interface ListItemInputs {
     metrics7d: AgentMetricsWindow;
     lastExecution: AgentExecutionDTO | null;
     /**
-     * Live interval cadence for a runtime-window built-in (hourly-check), or
+     * Live interval cadence for a runtime-window built-in (activity-scan), or
      * `null` for fixed-cron / one-shot / event Agents. Resolved by the route from
      * live config via `resolveRuntimeWindowCadence` so the schedule block carries
      * the REAL cadence rather than the stored placeholder cron (§5.5.1).
      */
     intervalCadence?: IntervalCadence | null;
 }
+/**
+ * Hub category for the `/agents` dashboard grouping
+ * (AGENTS_HUB_REDESIGN_PLAN.md §4.1): built-ins carry their registry
+ * category; every user Agent is `"user"`. An unknown builtin slug (should
+ * not happen — the loader synthesises rows from the registry) degrades to
+ * `"maintenance"` rather than failing the response.
+ */
+export declare function agentCategory(dto: AgentDTO): string;
+/**
+ * The declared Rulebook surface (registry `policyFiles`) for a built-in, or
+ * `[]` for user Agents / undeclared built-ins (AGENTS_HUB_REDESIGN_PLAN §4.2).
+ */
+export declare function agentPolicyFiles(dto: AgentDTO): readonly AgentPolicyFile[];
 /** One row of `GET /api/agents` (§9.1). `kind` mirrors the stored `source`. */
 export declare function buildListItem(dto: AgentDTO, inputs: ListItemInputs): Record<string, unknown>;
 /**
@@ -50,6 +63,21 @@ export interface DetailInputs {
     byErrorKind7d: Record<string, number>;
     /** Live runtime-window cadence for the detail `row.schedule_interval` (§5.5.1). */
     intervalCadence?: IntervalCadence | null;
+    /**
+     * Runtime-window editing block for a runtime-window built-in (activity-scan):
+     * the stored per-field overrides + the fully-resolved effective values the
+     * cadence form prefills with. Null/absent for every other Agent
+     * (AGENTS_HUB_REDESIGN_PLAN §2).
+     */
+    scheduleWindow?: {
+        overrides: Record<string, number>;
+        resolved: {
+            interval_minutes: number;
+            active_start_hour: number;
+            active_end_hour: number;
+            min_observations: number;
+        };
+    } | null;
 }
 /** Full `GET /api/agents/:slug` envelope (§9.2). */
 export declare function buildDetail(inputs: DetailInputs): Record<string, unknown>;
@@ -166,6 +194,13 @@ export type PatchPlan = {
     overrideSet: Record<string, unknown>;
     /** Built-in override-snapshot keys to delete. */
     overrideReset: string[];
+    /**
+     * Raw `schedule_window` patch for a runtime-window built-in
+     * (AGENTS_HUB_REDESIGN_PLAN §2). Field-level validation + the
+     * cross-field window check happen in `mergeRuntimeWindow` at the route
+     * (it needs the stored override + live config). Undefined when absent.
+     */
+    scheduleWindow?: Record<string, unknown>;
     /** For a user Agent enabled toggle: mirror onto its recurring row. */
     mirrorRecurringEnabled?: boolean;
     /** Read-only / unknown body keys ignored (logged in the response). */

package/dist/api/routes/agents/views.js

@@ -1,4 +1,5 @@
-import { AGENT_TIERS, OVERRIDE_EDIT_PATHS, agentDefinitionSchema, recurrenceRuleSchema } from "@aitne/shared";
+import { AGENT_TIERS, BACKEND_IDS, OVERRIDE_EDIT_PATHS, agentDefinitionSchema, recurrenceRuleSchema } from "@aitne/shared";
+import { getBuiltinRegistryEntry } from "../../../core/agents/builtin-registry.js";
 import { recurrenceRuleToCron } from "../../../core/agents/recurrence-convert.js";
 import { renderAgentMarkdown } from "../../../core/agents/agent-frontmatter.js";
 /**
@@ -67,6 +68,27 @@ export function serializeListMetrics(w) {
         criteria_hit_rate: w.criteriaHitRate,
     };
 }
+/**
+ * Hub category for the `/agents` dashboard grouping
+ * (AGENTS_HUB_REDESIGN_PLAN.md §4.1): built-ins carry their registry
+ * category; every user Agent is `"user"`. An unknown builtin slug (should
+ * not happen — the loader synthesises rows from the registry) degrades to
+ * `"maintenance"` rather than failing the response.
+ */
+export function agentCategory(dto) {
+    if (dto.source === "user")
+        return "user";
+    return getBuiltinRegistryEntry(dto.slug)?.category ?? "maintenance";
+}
+/**
+ * The declared Rulebook surface (registry `policyFiles`) for a built-in, or
+ * `[]` for user Agents / undeclared built-ins (AGENTS_HUB_REDESIGN_PLAN §4.2).
+ */
+export function agentPolicyFiles(dto) {
+    if (dto.source !== "builtin")
+        return [];
+    return getBuiltinRegistryEntry(dto.slug)?.policyFiles ?? [];
+}
 /** One row of `GET /api/agents` (§9.1). `kind` mirrors the stored `source`. */
 export function buildListItem(dto, inputs) {
     // Read the parse-error into a camelCase local + emit it via the object-literal
@@ -87,6 +109,7 @@ export function buildListItem(dto, inputs) {
         // string here loses no information (a valid/fallback row always has one).
         description: dto.description ?? "",
         kind: dto.source,
+        category: agentCategory(dto),
         enabled: dto.enabled,
         tags: dto.tags,
         schedule: {
@@ -119,6 +142,7 @@ export function buildRow(dto, intervalCadence = null) {
         // failure via the envelope's separate error field, not this column.
         description: dto.description ?? "",
         source: dto.source,
+        category: agentCategory(dto),
         definition_path: dto.definitionPath,
         definition_hash: dto.definitionHash,
         enabled: dto.enabled,
@@ -154,6 +178,14 @@ export function buildDetail(inputs) {
         },
         definition_yaml: inputs.definitionYaml,
         definition_path: inputs.dto.definitionPath,
+        // Rulebook tab inputs (AGENTS_HUB_REDESIGN_PLAN §4.2): the vault policy
+        // files this Agent reads at prompt-assembly time. The dashboard edits
+        // them through `/api/context/<path>`; this only declares the list.
+        policy_files: agentPolicyFiles(inputs.dto),
+        // Runtime-window editing inputs (§2): stored overrides + resolved
+        // effective values for the activity-scan cadence form. `null` for every
+        // non-runtime-window Agent.
+        schedule_window: inputs.scheduleWindow ?? null,
     };
 }
 /**
@@ -296,6 +328,13 @@ export function planCreate(body, existingSlugs) {
             kind: "cron",
             expression: recurrenceRuleToCron(parsedRule.data),
             ...(timezone !== undefined ? { timezone } : {}),
+            // Quiet-hours opt-in (QUIET_HOURS_HARDENING_PLAN.md §6) — carried
+            // verbatim so the schema validates it (a non-boolean is rejected as
+            // invalid_definition on schedule.defer_in_quiet_hours, same as the raw
+            // cron form, where the whole schedule block passes through).
+            ...(schedule.defer_in_quiet_hours !== undefined
+                ? { defer_in_quiet_hours: schedule.defer_in_quiet_hours }
+                : {}),
         };
     }
     else if (scheduleKind === "cron") {
@@ -382,7 +421,7 @@ export const EDITABLE_NESTED = (() => {
     }
     return acc;
 })();
-const CONTROL_KEYS = new Set(["enabled", "ack_warning", "reset"]);
+const CONTROL_KEYS = new Set(["enabled", "ack_warning", "reset", "schedule_window"]);
 function isAgentTier(v) {
     return typeof v === "string" && AGENT_TIERS.includes(v);
 }
@@ -399,6 +438,8 @@ function isValidOverrideValue(path, value) {
             return value === null || isAgentTier(value);
         case "backend.model":
             return value === null || (typeof value === "string" && value.length > 0);
+        case "backend.backend_id":
+            return value === null || (typeof value === "string" && BACKEND_IDS.includes(value));
         case "limits.max_turns":
         case "limits.timeout_minutes":
             return isPositiveInt(value);
@@ -483,6 +524,26 @@ export function planPatch(dto, body) {
             }
         }
     }
+    // ── schedule_window (runtime-window built-ins only) ──
+    let scheduleWindow;
+    if ("schedule_window" in body) {
+        if (!isPlainObject(body.schedule_window)) {
+            return { ok: false, status: 400, error: "invalid_schedule_window", field: "schedule_window" };
+        }
+        const entry = dto.source === "builtin" ? getBuiltinRegistryEntry(dto.slug) : undefined;
+        // Runtime-window marker: a builtin whose registry cron resolver is null
+        // (today: activity-scan) owns an interval cadence on its agent row.
+        if (!entry || entry.cronExpression !== null) {
+            return {
+                ok: false,
+                status: 400,
+                error: "schedule_window_not_supported",
+                field: "schedule_window",
+                hint: "Only the interval-based activity-scan Agent accepts schedule_window edits.",
+            };
+        }
+        scheduleWindow = body.schedule_window;
+    }
     // ── user Agents: only enabled is editable via this endpoint ──
     if (dto.source === "user" && (edits.length > 0 || reset.length > 0)) {
         return {
@@ -506,6 +567,7 @@ export function planPatch(dto, body) {
         overrideReset: reset,
         stripped,
         ...(setEnabled !== undefined ? { setEnabled } : {}),
+        ...(scheduleWindow !== undefined ? { scheduleWindow } : {}),
     };
     if (dto.source === "user" && setEnabled !== undefined && dto.recurringScheduleId !== null) {
         plan.mirrorRecurringEnabled = setEnabled;

package/dist/api/routes/background-task.d.ts

@@ -0,0 +1,22 @@
+/**
+ * /api/background-task/* — BACKGROUND_TASK_RUNNER_DESIGN.md §7.
+ *
+ * The generic detached-task surface. The DM agent POSTs a self-contained
+ * brief, acks, and ends its turn; the runner runs the worker detached and
+ * writes an artifact; the delivery boundary surfaces it. GET /:id returns
+ * the artifact (the DM agent's "read the result" affordance for precise
+ * follow-ups). /clarify relays the owner's answer; /cancel aborts.
+ *
+ * Routes (§7):
+ *   POST   /api/background-task            spawn (or schedule via scheduleAt)
+ *   GET    /api/background-task            list
+ *   GET    /api/background-task/:id        the artifact (full detail)
+ *   POST   /api/background-task/:id/clarify  answer a pending clarification
+ *   POST   /api/background-task/:id/cancel   abort in-flight task
+ *
+ * Excluded from the 100% coverage gate — route glue. The pure pieces
+ * (budget envelope, slot manager) are 100%-covered peers.
+ */
+import { Hono } from "hono";
+import type { ApiDependencies } from "../server.js";
+export declare function createBackgroundTaskRoutes(deps: ApiDependencies): Hono;