@asermax/tachikoma 2.0.0

package/dist/extensions/skills/reload.js

@@ -0,0 +1,38 @@
+import { Type } from "typebox";
+/**
+ * Mid-session resource reload, pi-style: a /reload command (reload must run in
+ * command context) plus a tool that queues it, so the agent can refresh skills
+ * itself when the user mentions adding or editing one. New sessions always
+ * rediscover skills regardless — this covers the live session.
+ */
+export const registerReload = (pi) => {
+    pi.registerCommand("reload", {
+        description: "Reload skills, prompts, and extensions from disk",
+        handler: async (_args, ctx) => {
+            await ctx.reload();
+        },
+    });
+    pi.registerTool({
+        name: "reload_resources",
+        label: "Reload Resources",
+        description: "Reload skills, prompts, and extensions from disk so additions and edits become available in the current session.",
+        parameters: Type.Object({}),
+        promptSnippet: "Reload skills/prompts/extensions from disk mid-session",
+        promptGuidelines: [
+            "Use reload_resources when the user says they added or changed a skill, so it loads without restarting.",
+        ],
+        async execute() {
+            pi.sendUserMessage("/reload", { deliverAs: "followUp" });
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: "Queued /reload — resources refresh when the current run finishes.",
+                    },
+                ],
+                details: {},
+            };
+        },
+    });
+};
+//# sourceMappingURL=reload.js.map

package/dist/extensions/skills/reload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reload.js","sourceRoot":"","sources":["../../../src/extensions/skills/reload.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAE/B;;;;;GAKG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,EAAgB,EAAQ,EAAE;IACvD,EAAE,CAAC,eAAe,CAAC,QAAQ,EAAE;QAC3B,WAAW,EAAE,kDAAkD;QAC/D,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YAC5B,MAAM,GAAG,CAAC,MAAM,EAAE,CAAC;QACrB,CAAC;KACF,CAAC,CAAC;IAEH,EAAE,CAAC,YAAY,CAAC;QACd,IAAI,EAAE,kBAAkB;QACxB,KAAK,EAAE,kBAAkB;QACzB,WAAW,EACT,kHAAkH;QACpH,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3B,aAAa,EAAE,wDAAwD;QACvE,gBAAgB,EAAE;YAChB,wGAAwG;SACzG;QACD,KAAK,CAAC,OAAO;YACX,EAAE,CAAC,eAAe,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,UAAU,EAAE,CAAC,CAAC;YAEzD,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,mEAAmE;qBAC1E;iBACF;gBACD,OAAO,EAAE,EAAE;aACZ,CAAC;QACJ,CAAC;KACF,CAAC,CAAC;AACL,CAAC,CAAC"}

package/dist/extensions/tasks/executor.d.ts

@@ -0,0 +1,43 @@
+import { type Static, Type } from "typebox";
+import type { SideRunner } from "../../agent/side-run.ts";
+import type { Delivery } from "../../channels/types.ts";
+import type { Logger } from "../../log.ts";
+import type { TaskRepository } from "./repository.ts";
+import type { TaskInstanceRecord } from "./schema.ts";
+export declare const TaskEvaluationSchema: Type.TObject<{
+    status: Type.TUnsafe<"error" | "continue" | "complete">;
+    reason: Type.TString;
+}>;
+export type TaskEvaluation = Static<typeof TaskEvaluationSchema>;
+export interface TaskNotification {
+    source: string;
+    instanceId: string;
+    status: "completed" | "failed";
+    message: string;
+}
+export type BackgroundSide = Pick<SideRunner, "run" | "classify">;
+export interface ExecutorDeps {
+    repository: TaskRepository;
+    side: BackgroundSide;
+    deliver: (delivery: Delivery) => void;
+    notify: (notification: TaskNotification) => void;
+    maxIterations: number;
+    timezone: string | undefined;
+    now: () => Date;
+    log: Logger;
+}
+export declare const evaluateCompletion: (side: Pick<SideRunner, "classify">, taskPrompt: string, agentResponse: string, log: Logger) => Promise<TaskEvaluation>;
+/** Execute one background instance through the iterative evaluator loop. */
+export declare const executeBackgroundInstance: (deps: ExecutorDeps, instance: TaskInstanceRecord) => Promise<void>;
+/**
+ * Tick-driven dispatcher for background instances. In-flight executions are
+ * tracked across ticks so a slow run is never dispatched twice.
+ */
+export declare class BackgroundRunner {
+    private readonly deps;
+    private readonly inFlight;
+    constructor(deps: ExecutorDeps);
+    tick(): void;
+    /** Await in-flight executions (tests and shutdown). */
+    drain(): Promise<void>;
+}

package/dist/extensions/tasks/executor.js

@@ -0,0 +1,179 @@
+import { StringEnum } from "@earendil-works/pi-ai";
+import { defineTool } from "@earendil-works/pi-coding-agent";
+import { Type } from "typebox";
+export const TaskEvaluationSchema = Type.Object({
+    status: StringEnum(["complete", "continue", "error"]),
+    reason: Type.String(),
+});
+const BACKGROUND_TOOLS = ["read", "bash", "edit", "write", "grep", "find", "ls"];
+const RESPONSE_EXCERPT_CHARS = 4000;
+const BACKGROUND_SYSTEM_PROMPT = `You are a background task agent. You are executing a scheduled task autonomously. Complete the task described below. Your work will be saved automatically.
+
+You are operating without direct user interaction. Work through the task methodically, and when you believe the task is complete, provide a clear summary of what was accomplished. Your final summary is delivered to the user when the task completes — failure notices are sent automatically.`;
+const EVALUATOR_SYSTEM = `You are a task completion evaluator for a background task agent. Your ONLY job is to classify the agent's current workflow state using the ordered rules below.
+
+You are a CLASSIFIER, not a reviewer. You MUST NOT:
+- Perform any qualitative analysis of the agent's output (correctness, thoroughness, style, usefulness, depth of investigation)
+- Offer corrective feedback, suggestions, improvements, or opinions about what the agent should have done differently
+- Apply any criteria beyond the rules listed below
+
+The "reason" field explains why you chose this classification and must describe observable facts about what the agent said or did — never advice, critique, or evaluation directed at the agent.
+
+Classification rules (evaluate in order, use the first match):
+
+1. Blocking error: Did the agent report an unrecoverable error, get stuck in a loop, or fail repeatedly without making progress?
+   -> {"status": "error", "reason": "Factual description of the blocking signal the agent reported"}
+
+2. Workflow complete: Did the agent execute the requested actions and announce completion, summarize results, or produce final output? Classify as complete even if the agent mentions optional follow-up actions it could take — completion announcements take precedence over hypothetical next steps.
+   -> {"status": "complete", "reason": "Brief factual summary of what the agent reported accomplishing"}
+
+3. Mid-workflow: Is the agent still working — it announced next steps but hasn't executed them yet, or it's partway through a multi-step process?
+   -> {"status": "continue", "reason": "What the agent said it would do next but has not yet executed"}`;
+const buildSystemPrompt = (now, timezone) => {
+    const formatted = now.toLocaleString("en-US", {
+        timeZone: timezone,
+        weekday: "long",
+        year: "numeric",
+        month: "long",
+        day: "numeric",
+        hour: "2-digit",
+        minute: "2-digit",
+        second: "2-digit",
+        hour12: false,
+    });
+    const zone = timezone != null ? ` ${timezone}` : "";
+    return `Current date and time: ${formatted}${zone}\n\n${BACKGROUND_SYSTEM_PROMPT}`;
+};
+// Side runs are ephemeral (no session continuity), so each continuation
+// carries the task, the previous progress, and the evaluator's observation.
+const buildContinuationPrompt = (taskPrompt, previousResponse, reason) => `You are resuming a background task that is not finished yet.
+
+<task>
+${taskPrompt}
+</task>
+
+<previous-progress>
+${previousResponse.slice(0, RESPONSE_EXCERPT_CHARS)}
+</previous-progress>
+
+An evaluator observed: ${reason}
+
+Continue working on the task from where you left off.`;
+export const evaluateCompletion = async (side, taskPrompt, agentResponse, log) => {
+    try {
+        return await side.classify({
+            system: EVALUATOR_SYSTEM,
+            user: `<task-definition>\n${taskPrompt}\n</task-definition>\n\n<agent-response>\n${agentResponse.slice(0, RESPONSE_EXCERPT_CHARS)}\n</agent-response>`,
+            schema: TaskEvaluationSchema,
+        });
+    }
+    catch (error) {
+        // The evaluator is best-effort: a failure must never abort the run.
+        log.warn({ err: error }, "evaluator failed — continuing");
+        return { status: "continue", reason: "Evaluator failed, continuing" };
+    }
+};
+/** Execute one background instance through the iterative evaluator loop. */
+export const executeBackgroundInstance = async (deps, instance) => {
+    const { repository, side, deliver, notify, maxIterations, timezone, now, log } = deps;
+    const definition = instance.definitionId != null ? repository.getDefinition(instance.definitionId) : null;
+    const source = definition != null
+        ? `Background task: ${definition.name}`
+        : `Background task: ${instance.prompt.slice(0, 100)}`;
+    const fail = (reason, noticeMessage) => {
+        repository.updateInstance(instance.id, {
+            status: "failed",
+            completedAt: now(),
+            result: reason,
+        });
+        deliver({ text: `❌ ${source} — ${noticeMessage}`, gate: "idle" });
+        notify({ source, instanceId: instance.id, status: "failed", message: noticeMessage });
+        log.warn({ instanceId: instance.id, reason }, "background task failed");
+    };
+    repository.updateInstance(instance.id, { status: "running", startedAt: now() });
+    log.info({ instanceId: instance.id }, "executing background task instance");
+    try {
+        const system = buildSystemPrompt(now(), timezone);
+        let prompt = instance.prompt;
+        const notifyTool = defineTool({
+            name: "notify_user",
+            label: "Notify User",
+            description: "Send the user a notification about something important discovered during this background task.",
+            parameters: Type.Object({
+                text: Type.String({ description: "Notification text" }),
+                severity: StringEnum(["info", "warning", "urgent"], { default: "info" }),
+            }),
+            execute: async (_id, params) => {
+                deliver({
+                    text: `${params.severity === "urgent" ? "🚨 " : ""}${source}: ${params.text}`,
+                    gate: params.severity === "urgent" ? "immediate" : "idle",
+                    priority: params.severity === "urgent" ? 10 : 0,
+                });
+                return { content: [{ type: "text", text: "Notification queued." }], details: {} };
+            },
+        });
+        for (let iteration = 1; iteration <= maxIterations; iteration += 1) {
+            const { text } = await side.run({
+                system,
+                prompt,
+                tools: BACKGROUND_TOOLS,
+                customTools: [notifyTool],
+                tier: "processor",
+            });
+            const evaluation = await evaluateCompletion(side, instance.prompt, text, log);
+            log.debug({ instanceId: instance.id, iteration, status: evaluation.status }, "evaluator result");
+            if (evaluation.status === "complete") {
+                repository.updateInstance(instance.id, {
+                    status: "completed",
+                    completedAt: now(),
+                    result: evaluation.reason,
+                });
+                deliver({ text: `✅ ${source} — completed.\n\n${text}`, gate: "idle" });
+                notify({
+                    source,
+                    instanceId: instance.id,
+                    status: "completed",
+                    message: evaluation.reason,
+                });
+                log.info({ instanceId: instance.id }, "background task completed");
+                return;
+            }
+            if (evaluation.status === "error") {
+                fail(`Agent stuck: ${evaluation.reason}`, `Task failed: ${evaluation.reason}`);
+                return;
+            }
+            prompt = buildContinuationPrompt(instance.prompt, text, evaluation.reason);
+        }
+        fail(`Max iterations (${maxIterations}) reached without completion`, `Task failed: reached max iterations (${maxIterations})`);
+    }
+    catch (error) {
+        log.error({ instanceId: instance.id, err: error }, "background task errored");
+        fail(`Task failed: ${error}`, `Task failed with error: ${error}`);
+    }
+};
+/**
+ * Tick-driven dispatcher for background instances. In-flight executions are
+ * tracked across ticks so a slow run is never dispatched twice.
+ */
+export class BackgroundRunner {
+    deps;
+    inFlight = new Map();
+    constructor(deps) {
+        this.deps = deps;
+    }
+    tick() {
+        for (const instance of this.deps.repository.getPendingInstances("background")) {
+            if (this.inFlight.has(instance.id))
+                continue;
+            const run = executeBackgroundInstance(this.deps, instance)
+                .catch((error) => this.deps.log.error({ instanceId: instance.id, err: error }, "background executor crashed"))
+                .finally(() => this.inFlight.delete(instance.id));
+            this.inFlight.set(instance.id, run);
+        }
+    }
+    /** Await in-flight executions (tests and shutdown). */
+    async drain() {
+        await Promise.allSettled(this.inFlight.values());
+    }
+}
+//# sourceMappingURL=executor.js.map

package/dist/extensions/tasks/executor.js.map

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

package/dist/extensions/tasks/expiration.d.ts

@@ -0,0 +1,12 @@
+import type { Logger } from "../../log.ts";
+import type { TaskRepository } from "./repository.ts";
+import type { TaskInstanceRecord } from "./schema.ts";
+export interface ExpirationDeps {
+    repository: TaskRepository;
+    waitTimeoutSeconds: number;
+    now: () => Date;
+    log: Logger;
+    onExpired?: (instance: TaskInstanceRecord, reason: string) => void;
+}
+/** Fail waiting instances whose last update exceeded the wait timeout. */
+export declare const expireWaitingInstances: ({ repository, waitTimeoutSeconds, now, log, onExpired, }: ExpirationDeps) => void;

package/dist/extensions/tasks/expiration.js

@@ -0,0 +1,17 @@
+/** Fail waiting instances whose last update exceeded the wait timeout. */
+export const expireWaitingInstances = ({ repository, waitTimeoutSeconds, now, log, onExpired, }) => {
+    const expired = repository.listExpiredWaitingInstances(waitTimeoutSeconds);
+    for (const instance of expired) {
+        const reason = `Task timed out waiting for user input after ${waitTimeoutSeconds}s`;
+        repository.updateInstance(instance.id, {
+            status: "failed",
+            completedAt: now(),
+            result: reason,
+        });
+        onExpired?.(instance, reason);
+    }
+    if (expired.length > 0) {
+        log.info({ count: expired.length }, "expired waiting instances past timeout");
+    }
+};
+//# sourceMappingURL=expiration.js.map

package/dist/extensions/tasks/expiration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"expiration.js","sourceRoot":"","sources":["../../../src/extensions/tasks/expiration.ts"],"names":[],"mappings":"AAYA,0EAA0E;AAC1E,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,EACrC,UAAU,EACV,kBAAkB,EAClB,GAAG,EACH,GAAG,EACH,SAAS,GACM,EAAQ,EAAE;IACzB,MAAM,OAAO,GAAG,UAAU,CAAC,2BAA2B,CAAC,kBAAkB,CAAC,CAAC;IAE3E,KAAK,MAAM,QAAQ,IAAI,OAAO,EAAE,CAAC;QAC/B,MAAM,MAAM,GAAG,+CAA+C,kBAAkB,GAAG,CAAC;QAEpF,UAAU,CAAC,cAAc,CAAC,QAAQ,CAAC,EAAE,EAAE;YACrC,MAAM,EAAE,QAAQ;YAChB,WAAW,EAAE,GAAG,EAAE;YAClB,MAAM,EAAE,MAAM;SACf,CAAC,CAAC;QAEH,SAAS,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAChC,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,GAAG,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,MAAM,EAAE,EAAE,wCAAwC,CAAC,CAAC;IAChF,CAAC;AACH,CAAC,CAAC"}

package/dist/extensions/tasks/generation.d.ts

@@ -0,0 +1,14 @@
+import type { Logger } from "../../log.ts";
+import type { TaskRepository } from "./repository.ts";
+export interface GenerationDeps {
+    repository: TaskRepository;
+    timezone: string | undefined;
+    now: () => Date;
+    log: Logger;
+}
+/**
+ * One generation pass: evaluate every enabled definition against the current
+ * time, create pending instances for due schedules, and advance bookkeeping.
+ * One-shot definitions are auto-disabled after firing.
+ */
+export declare const generateDueInstances: (deps: GenerationDeps) => void;

package/dist/extensions/tasks/generation.js

@@ -0,0 +1,70 @@
+import { nextCronRun } from "./schedule.js";
+const HOUR_MS = 3_600_000;
+/**
+ * One generation pass: evaluate every enabled definition against the current
+ * time, create pending instances for due schedules, and advance bookkeeping.
+ * One-shot definitions are auto-disabled after firing.
+ */
+export const generateDueInstances = (deps) => {
+    for (const definition of deps.repository.listEnabledDefinitions()) {
+        try {
+            if (definition.schedule.type === "cron") {
+                generateForCron(deps, definition, definition.schedule.expression);
+            }
+            else {
+                generateForOneShot(deps, definition, new Date(definition.schedule.at));
+            }
+        }
+        catch (error) {
+            deps.log.error({ definitionId: definition.id, err: error }, "error processing definition");
+        }
+    }
+};
+const generateForCron = ({ repository, timezone, now, log }, definition, expression) => {
+    const current = now();
+    // First evaluation looks back to the start of the current hour (minus a second
+    // so an exact on-the-hour match still fires); afterwards the last fire anchors.
+    const anchor = definition.lastFiredAt ?? new Date(Math.floor(current.getTime() / HOUR_MS) * HOUR_MS - 1000);
+    let nextFire = nextCronRun(expression, timezone, anchor);
+    // Stale-cron prevention: never fire for occurrences that predate the
+    // definition's latest edit — advance past `since` instead.
+    if (nextFire != null && nextFire <= definition.since) {
+        nextFire = nextCronRun(expression, timezone, definition.since);
+    }
+    if (nextFire == null || nextFire > current)
+        return;
+    const duplicate = repository.getActiveInstanceForDefinition(definition.id, nextFire);
+    if (duplicate != null) {
+        log.debug({ definitionId: definition.id, scheduledFor: nextFire.toISOString() }, "duplicate suppressed — period already covered");
+        return;
+    }
+    const instance = repository.createInstance({
+        definitionId: definition.id,
+        taskType: definition.taskType,
+        prompt: definition.prompt,
+        scheduledFor: nextFire,
+    });
+    // Advance lastFiredAt so the next pass anchors in the future, preventing
+    // catch-up duplicates for the same period.
+    repository.updateDefinition(definition.id, { lastFiredAt: current });
+    log.info({ instanceId: instance.id, name: definition.name, taskType: definition.taskType }, "created task instance");
+};
+const generateForOneShot = ({ repository, now, log }, definition, at) => {
+    const current = now();
+    if (definition.lastFiredAt != null || at > current)
+        return;
+    const active = repository.getActiveInstanceForDefinition(definition.id);
+    if (active != null) {
+        log.debug({ definitionId: definition.id, instanceId: active.id }, "skipping one-shot — already has an active instance");
+        return;
+    }
+    const instance = repository.createInstance({
+        definitionId: definition.id,
+        taskType: definition.taskType,
+        prompt: definition.prompt,
+        scheduledFor: at,
+    });
+    repository.updateDefinition(definition.id, { lastFiredAt: current, enabled: false });
+    log.info({ instanceId: instance.id, name: definition.name, taskType: definition.taskType }, "created one-shot instance and auto-disabled its definition");
+};
+//# sourceMappingURL=generation.js.map

package/dist/extensions/tasks/generation.js.map

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

package/dist/extensions/tasks/index.d.ts

@@ -0,0 +1,14 @@
+interface TasksConfig {
+    timezone?: string;
+    sessionTaskMaxHoldSeconds: number;
+    backgroundMaxIterations: number;
+    waitTimeoutSeconds: number;
+}
+/**
+ * Scheduled tasks: cron or one-shot definitions fire as instances that are
+ * either delivered into the conversation during idle time (session mode) or
+ * executed autonomously through an evaluator loop (background mode). The agent
+ * manages definitions through the task tools.
+ */
+declare const _default: import("../api.ts").TachikomaExtension<TasksConfig>;
+export default _default;

package/dist/extensions/tasks/index.js

@@ -0,0 +1,75 @@
+import { Type } from "typebox";
+import { defineExtension } from "../api.js";
+import { BackgroundRunner } from "./executor.js";
+import { expireWaitingInstances } from "./expiration.js";
+import { generateDueInstances } from "./generation.js";
+import { TaskRepository } from "./repository.js";
+import { deliverSessionTasks } from "./session-delivery.js";
+import { createTaskToolsFactory } from "./tools.js";
+const TICK_INTERVAL_SECONDS = 60;
+/**
+ * Scheduled tasks: cron or one-shot definitions fire as instances that are
+ * either delivered into the conversation during idle time (session mode) or
+ * executed autonomously through an evaluator loop (background mode). The agent
+ * manages definitions through the task tools.
+ */
+export default defineExtension({
+    name: "tasks",
+    configSchema: Type.Object({
+        timezone: Type.Optional(Type.String()),
+        sessionTaskMaxHoldSeconds: Type.Number({ default: 900 }),
+        backgroundMaxIterations: Type.Number({ default: 10 }),
+        waitTimeoutSeconds: Type.Number({ default: 7200 }),
+    }),
+    setup(app) {
+        const repository = new TaskRepository(app.db);
+        const timezone = app.extensionConfig.timezone ?? app.config.scheduler.timezone;
+        const now = () => new Date();
+        app.bootstrap("crash-recovery", () => {
+            const count = repository.markRunningAsFailed("system restart");
+            if (count > 0) {
+                app.log.warn({ count }, "crash recovery: marked running instances as failed");
+            }
+        });
+        const runner = new BackgroundRunner({
+            repository,
+            side: app.agent.side,
+            deliver: (delivery) => app.channels.deliver(delivery),
+            // User-facing output goes through deliver(); this signal is for other extensions.
+            notify: (notification) => app.events.emit("tasks:instance-finished", notification),
+            maxIterations: app.extensionConfig.backgroundMaxIterations,
+            timezone,
+            now,
+            log: app.log,
+        });
+        app.agent.use(createTaskToolsFactory({ repository, timezone, now }));
+        app.scheduler.every("tasks-tick", TICK_INTERVAL_SECONDS, () => {
+            generateDueInstances({ repository, timezone, now, log: app.log });
+            expireWaitingInstances({
+                repository,
+                waitTimeoutSeconds: app.extensionConfig.waitTimeoutSeconds,
+                now,
+                log: app.log,
+                onExpired: (instance, reason) => {
+                    app.channels.deliver({ text: `❌ Background task failed: ${reason}`, gate: "idle" });
+                    app.events.emit("tasks:instance-finished", {
+                        source: "Background task",
+                        instanceId: instance.id,
+                        status: "failed",
+                        message: reason,
+                    });
+                },
+            });
+            deliverSessionTasks({
+                repository,
+                deliver: (delivery) => app.channels.deliver(delivery),
+                maxHoldSeconds: app.extensionConfig.sessionTaskMaxHoldSeconds,
+                now,
+                log: app.log,
+            });
+            // Background executions run detached — the runner tracks them across ticks.
+            runner.tick();
+        });
+    },
+});
+//# sourceMappingURL=index.js.map

package/dist/extensions/tasks/index.js.map

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

package/dist/extensions/tasks/repository.d.ts

@@ -0,0 +1,53 @@
+import type { AppDatabase } from "../../db/index.ts";
+import { type StoredSchedule, type TaskDefinitionRecord, type TaskInstanceRecord, type TaskStatus, type TaskType } from "./schema.ts";
+export interface NewTaskDefinition {
+    name: string;
+    schedule: StoredSchedule;
+    taskType: TaskType;
+    prompt: string;
+    enabled?: boolean;
+}
+export interface NewTaskInstance {
+    definitionId: string | null;
+    taskType: TaskType;
+    prompt: string;
+    scheduledFor: Date;
+}
+export type DefinitionPatch = Partial<Omit<TaskDefinitionRecord, "id" | "createdAt">>;
+export type InstancePatch = Partial<Omit<TaskInstanceRecord, "id" | "createdAt">>;
+export interface InstanceQuery {
+    status?: TaskStatus;
+    taskType?: TaskType;
+    definitionId?: string;
+    limit?: number;
+}
+export declare class TaskRepository {
+    private readonly db;
+    private readonly now;
+    constructor(db: AppDatabase, now?: () => Date);
+    createDefinition(values: NewTaskDefinition): TaskDefinitionRecord;
+    getDefinition(id: string): TaskDefinitionRecord | null;
+    listEnabledDefinitions(): TaskDefinitionRecord[];
+    listDisabledDefinitions(): TaskDefinitionRecord[];
+    /** Stamps `since` on every update (overridable) so schedule edits reset the cron anchor. */
+    updateDefinition(id: string, patch: DefinitionPatch): TaskDefinitionRecord | null;
+    createInstance(values: NewTaskInstance): TaskInstanceRecord;
+    getInstance(id: string): TaskInstanceRecord | null;
+    getPendingInstances(taskType: TaskType): TaskInstanceRecord[];
+    /**
+     * Duplicate prevention. With `scheduledFor`, performs a period-aware check
+     * (pending/running/waiting/completed instances covering that exact cron match);
+     * without it, returns any pending/running/waiting instance for the definition.
+     */
+    getActiveInstanceForDefinition(definitionId: string, scheduledFor?: Date): TaskInstanceRecord | null;
+    /** Waiting instances whose last update is older than `timeoutSeconds`. */
+    listExpiredWaitingInstances(timeoutSeconds: number): TaskInstanceRecord[];
+    /** Stamps `updatedAt` on every update unless the patch overrides it. */
+    updateInstance(id: string, patch: InstancePatch): TaskInstanceRecord | null;
+    queryInstances({ status, taskType, definitionId, limit, }: InstanceQuery): TaskInstanceRecord[];
+    /**
+     * Crash recovery: running instances from a previous process are failed because
+     * their executors are gone. Returns the number of instances marked.
+     */
+    markRunningAsFailed(reason: string): number;
+}