@aitne/daemon 0.1.0

package/dist/core/custom-routine-scheduler.js

@@ -0,0 +1,335 @@
+import { existsSync, readFileSync, readdirSync } from "node:fs";
+import { join } from "node:path";
+import cron from "node-cron";
+import { createEvent, EventPriority, customRoutineKey, isCustomRoutineKey, customRoutineSlugFromKey, } from "@aitne/shared";
+import { CONTEXT_RELATIVE_PATHS } from "./context-paths.js";
+import { createLogger } from "../logging.js";
+const logger = createLogger("custom-routine-scheduler");
+/**
+ * Extract the frontmatter body between the opening and closing `---`
+ * delimiters. Returns null when the file has no YAML frontmatter.
+ */
+function extractFrontmatter(content) {
+    if (!content.startsWith("---\n") && !content.startsWith("---\r\n")) {
+        return null;
+    }
+    const afterOpen = content.startsWith("---\r\n") ? 5 : 4;
+    const endIdx = content.indexOf("\n---", afterOpen - 1);
+    if (endIdx < 0)
+        return null;
+    return content.slice(afterOpen, endIdx);
+}
+function readScalar(frontmatter, field) {
+    const re = new RegExp(`^${field}\\s*:\\s*(.+?)\\s*$`, "m");
+    const m = frontmatter.match(re);
+    if (!m)
+        return null;
+    let v = m[1].trim();
+    // Strip surrounding quotes (single or double).
+    if ((v.startsWith('"') && v.endsWith('"')) ||
+        (v.startsWith("'") && v.endsWith("'"))) {
+        v = v.slice(1, -1);
+    }
+    return v;
+}
+function hasChecksSection(content) {
+    return /^##\s+Checks\s*$/m.test(content);
+}
+/**
+ * Parse a `routines/custom/<slug>.md` file body into a validated spec.
+ * Pure function — safe to unit-test exhaustively. Returns a discriminated
+ * result so callers can log structured errors without throwing.
+ */
+export function parseCustomRoutineSpec(slug, body) {
+    if (!/^[a-z0-9][a-z0-9-]*[a-z0-9]$|^[a-z0-9]$/.test(slug) || slug.length > 64) {
+        return { ok: false, error: { kind: "invalid_slug", value: slug } };
+    }
+    const fm = extractFrontmatter(body);
+    if (fm === null) {
+        return { ok: false, error: { kind: "no_frontmatter" } };
+    }
+    const typeRaw = readScalar(fm, "type");
+    if (!typeRaw) {
+        return { ok: false, error: { kind: "missing_field", field: "type" } };
+    }
+    if (typeRaw !== "rule") {
+        return { ok: false, error: { kind: "invalid_type", value: typeRaw } };
+    }
+    const slugRaw = readScalar(fm, "slug");
+    if (!slugRaw) {
+        return { ok: false, error: { kind: "missing_field", field: "slug" } };
+    }
+    if (slugRaw !== slug) {
+        return { ok: false, error: { kind: "invalid_slug", value: slugRaw } };
+    }
+    const processKeyRaw = readScalar(fm, "process_key");
+    if (!processKeyRaw) {
+        return { ok: false, error: { kind: "missing_field", field: "process_key" } };
+    }
+    if (processKeyRaw !== customRoutineKey(slug)) {
+        return { ok: false, error: { kind: "invalid_process_key", value: processKeyRaw } };
+    }
+    const cronExpr = readScalar(fm, "cron");
+    if (!cronExpr) {
+        return { ok: false, error: { kind: "missing_field", field: "cron" } };
+    }
+    if (!cron.validate(cronExpr)) {
+        return { ok: false, error: { kind: "invalid_cron", value: cronExpr } };
+    }
+    const tierRaw = readScalar(fm, "backend_tier");
+    if (!tierRaw) {
+        return { ok: false, error: { kind: "missing_field", field: "backend_tier" } };
+    }
+    // Accept the legacy two-tier names ("light" / "heavy") and the canonical
+    // three-tier names ("lite" / "medium" / "high"). Legacy "light" maps to
+    // Sonnet (medium) and "heavy" to Opus (high), preserving behavior of
+    // user-authored routine files written before the rename.
+    const tierAliasMap = {
+        "lite": "lite",
+        "medium": "medium",
+        "high": "high",
+        "light": "medium",
+        "heavy": "high",
+    };
+    const normalizedTier = tierAliasMap[tierRaw];
+    if (!normalizedTier) {
+        return { ok: false, error: { kind: "invalid_tier", value: tierRaw } };
+    }
+    const budgetRaw = readScalar(fm, "max_budget_usd");
+    if (!budgetRaw) {
+        return { ok: false, error: { kind: "missing_field", field: "max_budget_usd" } };
+    }
+    const budget = Number(budgetRaw);
+    if (!Number.isFinite(budget) || budget <= 0) {
+        return { ok: false, error: { kind: "invalid_budget", value: budgetRaw } };
+    }
+    const enabledRaw = readScalar(fm, "enabled");
+    if (!enabledRaw) {
+        return { ok: false, error: { kind: "missing_field", field: "enabled" } };
+    }
+    if (enabledRaw !== "true" && enabledRaw !== "false") {
+        return { ok: false, error: { kind: "invalid_enabled", value: enabledRaw } };
+    }
+    const enabled = enabledRaw === "true";
+    if (!hasChecksSection(body)) {
+        return { ok: false, error: { kind: "missing_checks_section" } };
+    }
+    return {
+        ok: true,
+        spec: {
+            slug,
+            cron: cronExpr,
+            enabled,
+            backendTier: normalizedTier,
+            maxBudgetUsd: budget,
+            processKey: customRoutineKey(slug),
+        },
+    };
+}
+/**
+ * Enumerate every `routines/custom/*.md` file under `contextDir` and
+ * parse each into a spec. Errors are returned alongside the successful
+ * specs so the scheduler can log them without aborting startup.
+ *
+ * `readCustomRoutineDir` is injectable for tests — by default it reads
+ * from disk. Passing null makes the helper return empty results, used
+ * when the context directory has not yet been materialised.
+ */
+export function enumerateCustomRoutines(contextDir, options) {
+    const dir = join(contextDir, CONTEXT_RELATIVE_PATHS.routines.customDir);
+    const readDir = options?.readDir ?? defaultReadDir;
+    const readFile = options?.readFile ?? defaultReadFile;
+    const files = readDir(dir);
+    const specs = [];
+    const errors = [];
+    for (const fileName of files) {
+        if (!fileName.endsWith(".md"))
+            continue;
+        const slug = fileName.slice(0, -3);
+        let body;
+        try {
+            body = readFile(join(dir, fileName));
+        }
+        catch {
+            continue;
+        }
+        const result = parseCustomRoutineSpec(slug, body);
+        if (result.ok) {
+            specs.push(result.spec);
+        }
+        else {
+            errors.push({ slug, error: result.error });
+        }
+    }
+    return { specs, errors };
+}
+function defaultReadDir(dir) {
+    if (!existsSync(dir))
+        return [];
+    return readdirSync(dir);
+}
+function defaultReadFile(path) {
+    return readFileSync(path, "utf-8");
+}
+/**
+ * Compute which slugs to (un)register when reloading from disk. Pure
+ * diff helper so the orchestrator class stays thin and the gate logic
+ * is covered by unit tests without touching `cron.schedule`.
+ */
+export function diffRegistrations(current, next) {
+    const nextBySlug = new Map();
+    for (const spec of next)
+        nextBySlug.set(spec.slug, spec);
+    const toAdd = [];
+    const toReplace = [];
+    const toRemove = [];
+    for (const [slug, spec] of nextBySlug) {
+        const existing = current.get(slug);
+        if (!existing) {
+            if (spec.enabled)
+                toAdd.push(spec);
+            continue;
+        }
+        if (existing.cron !== spec.cron ||
+            existing.enabled !== spec.enabled ||
+            existing.backendTier !== spec.backendTier ||
+            existing.maxBudgetUsd !== spec.maxBudgetUsd) {
+            if (spec.enabled) {
+                toReplace.push(spec);
+            }
+            else {
+                toRemove.push(slug);
+            }
+        }
+    }
+    for (const slug of current.keys()) {
+        if (!nextBySlug.has(slug))
+            toRemove.push(slug);
+    }
+    return { toAdd, toReplace, toRemove };
+}
+/**
+ * Orchestrates custom routine cron registration. Thin wrapper around
+ * `node-cron` so the heavy lifting (parsing, diffing) lives in the
+ * pure helpers above.
+ */
+export class CustomRoutineScheduler {
+    contextDir;
+    eventBus;
+    timezone;
+    scheduleFn;
+    jobs = new Map();
+    started = false;
+    constructor(opts) {
+        this.contextDir = opts.contextDir;
+        this.eventBus = opts.eventBus;
+        this.timezone = opts.timezone;
+        this.scheduleFn =
+            opts.schedule ??
+                ((expr, cb, tz) => cron.schedule(expr, cb, tz ? { timezone: tz } : {}));
+    }
+    start() {
+        if (this.started)
+            return;
+        this.started = true;
+        this.reload();
+    }
+    stop() {
+        for (const { job } of this.jobs.values())
+            job.stop();
+        this.jobs.clear();
+        this.started = false;
+    }
+    /**
+     * Re-enumerate the custom routines on disk and apply the diff.
+     * Safe to call from any thread (API route hooks, startup).
+     */
+    reload() {
+        const { specs, errors } = enumerateCustomRoutines(this.contextDir);
+        for (const { slug, error } of errors) {
+            logger.warn({ slug, error }, "Skipping custom routine with parse error");
+        }
+        const current = new Map(Array.from(this.jobs.entries()).map(([slug, entry]) => [slug, entry.spec]));
+        const { toAdd, toReplace, toRemove } = diffRegistrations(current, specs);
+        for (const slug of toRemove)
+            this.unregister(slug);
+        for (const spec of toReplace) {
+            this.unregister(spec.slug);
+            this.register(spec);
+        }
+        for (const spec of toAdd)
+            this.register(spec);
+        logger.info({
+            added: toAdd.length,
+            replaced: toReplace.length,
+            removed: toRemove.length,
+            errors: errors.length,
+            total: this.jobs.size,
+        }, "Custom routines reloaded");
+        return {
+            added: toAdd.length,
+            replaced: toReplace.length,
+            removed: toRemove.length,
+            errors: errors.length,
+        };
+    }
+    /** Snapshot of currently registered specs — used by dashboard / tests. */
+    listRegistered() {
+        return Array.from(this.jobs.values()).map((entry) => entry.spec);
+    }
+    register(spec) {
+        if (!isCustomRoutineKey(spec.processKey)) {
+            logger.warn({ slug: spec.slug, processKey: spec.processKey }, "Rejecting custom routine with invalid process key");
+            return;
+        }
+        const job = this.scheduleFn(spec.cron, () => this.fire(spec), this.timezone);
+        this.jobs.set(spec.slug, { spec, job });
+        logger.info({ slug: spec.slug, cron: spec.cron }, "Custom routine registered");
+    }
+    unregister(slug) {
+        const entry = this.jobs.get(slug);
+        if (!entry)
+            return;
+        entry.job.stop();
+        this.jobs.delete(slug);
+        logger.info({ slug }, "Custom routine unregistered");
+    }
+    fire(spec) {
+        // The downstream `RoutineEvent.requestedModel` contract is still the
+        // binary `"sonnet" | "opus"` shape (used by the dashboard chat picker
+        // / run-now); collapse the tri-tier `lite` and `medium` to "sonnet"
+        // and `high` to "opus" until that wider contract is migrated.
+        const event = {
+            ...createEvent({
+                type: spec.processKey,
+                source: "custom-routine-scheduler",
+                priority: EventPriority.NORMAL,
+            }),
+            routine: `custom.${spec.slug}`,
+            requestedModel: spec.backendTier === "high" ? "opus" : "sonnet",
+        };
+        void this.eventBus.put(event).catch((err) => {
+            logger.error({ err, slug: spec.slug }, "Failed to enqueue custom routine event");
+        });
+        logger.info({ slug: spec.slug }, "Custom routine fired");
+    }
+}
+/**
+ * Convenience: extract the slug from a `routines/custom/<slug>.md` path.
+ * Returns null if the path is outside the custom-routine directory.
+ * Used by the context API route when deciding whether to call `reload()`.
+ */
+export function slugFromCustomRoutinePath(relativePath) {
+    const prefix = `${CONTEXT_RELATIVE_PATHS.routines.customDir}/`;
+    if (!relativePath.startsWith(prefix))
+        return null;
+    const rest = relativePath.slice(prefix.length);
+    if (!rest.endsWith(".md"))
+        return null;
+    const slug = rest.slice(0, -3);
+    if (slug.includes("/"))
+        return null;
+    return slug;
+}
+export { customRoutineSlugFromKey };
+//# sourceMappingURL=custom-routine-scheduler.js.map

package/dist/core/custom-routine-scheduler.js.map

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

package/dist/core/daemon-api-cli.d.ts

@@ -0,0 +1,33 @@
+export declare const SESSION_DAEMON_API_BIN_DIR: string;
+export declare const SESSION_DAEMON_API_CLI_REL_PATH: string;
+export declare const SESSION_DAEMON_CURL_SHIM_REL_PATH: string;
+export declare const DAEMON_API_BASE_URL_ENV = "PA_DAEMON_API_BASE_URL";
+export declare const DAEMON_API_READ_TOKEN_ENV = "PA_DAEMON_READ_TOKEN";
+export declare const DAEMON_API_SESSION_BACKEND_ENV = "PA_SESSION_BACKEND";
+export declare const DAEMON_API_EVENT_ID_ENV = "PA_EVENT_ID";
+export declare const DAEMON_API_PROCESS_KEY_ENV = "PA_PROCESS_KEY";
+export declare const DAEMON_API_SESSION_ID_ENV = "PA_SESSION_ID";
+export declare const DAEMON_API_EVENT_CORRELATION_ID_ENV = "PA_EVENT_CORRELATION_ID";
+export declare function ensureDaemonApiCli(sessionDir: string): string;
+/**
+ * Identity-bearing env vars consumed by the CLI shims when an invoke call
+ * targets /api/integrations/*\/invoke. Optional — when omitted, the shim
+ * just doesn't attach the corresponding header. Callers pass `sessionBackend`
+ * unconditionally on agent backend spawns; `eventId` / `processKey` flow in
+ * from the dispatcher so `agent_actions` rows get parent attribution.
+ *
+ * DELEGATED-MODE-V2-DESIGN.md §4.2.3.
+ */
+export interface DaemonApiCliEnvOptions {
+    readToken?: string;
+    sessionBackend?: string;
+    eventId?: string;
+    processKey?: string;
+    sessionId?: number | string;
+    /** Event.correlationId for the in-flight dispatcher run. Auto-injected
+     *  by the shims onto /api/notify calls so the dispatcher can suppress
+     *  the implicit final-text DM forward when the agent already notified. */
+    eventCorrelationId?: string;
+}
+export declare function buildDaemonApiCliEnv(sessionDir: string, apiPort: number, optionsOrReadToken?: string | DaemonApiCliEnvOptions): Record<string, string>;
+//# sourceMappingURL=daemon-api-cli.d.ts.map

package/dist/core/daemon-api-cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"daemon-api-cli.d.ts","sourceRoot":"","sources":["../../src/core/daemon-api-cli.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,0BAA0B,QAAqB,CAAC;AAC7D,eAAO,MAAM,+BAA+B,QAG3C,CAAC;AACF,eAAO,MAAM,iCAAiC,QAG7C,CAAC;AACF,eAAO,MAAM,uBAAuB,2BAA2B,CAAC;AAChE,eAAO,MAAM,yBAAyB,yBAAyB,CAAC;AAUhE,eAAO,MAAM,8BAA8B,uBAAuB,CAAC;AACnE,eAAO,MAAM,uBAAuB,gBAAgB,CAAC;AACrD,eAAO,MAAM,0BAA0B,mBAAmB,CAAC;AAC3D,eAAO,MAAM,yBAAyB,kBAAkB,CAAC;AAOzD,eAAO,MAAM,mCAAmC,4BAA4B,CAAC;AAihB7E,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAS7D;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,sBAAsB;IACrC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC5B;;8EAE0E;IAC1E,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,kBAAkB,CAAC,EAAE,MAAM,GAAG,sBAAsB,GACnD,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CA0DxB"}