@asermax/tachikoma 2.0.0

package/dist/extensions/tasks/repository.js

@@ -0,0 +1,147 @@
+import { randomUUID } from "node:crypto";
+import { and, desc, eq, inArray, lt } from "drizzle-orm";
+import { taskDefinitions, taskInstances, } from "./schema.js";
+const ACTIVE_STATUSES = ["pending", "running", "waiting"];
+// Failed is excluded so a retry within the same period stays possible.
+const PERIOD_COVERING_STATUSES = ["pending", "running", "waiting", "completed"];
+export class TaskRepository {
+    db;
+    now;
+    constructor(db, now = () => new Date()) {
+        this.db = db;
+        this.now = now;
+    }
+    // ---- definitions --------------------------------------------------------------
+    createDefinition(values) {
+        const now = this.now();
+        return this.db
+            .insert(taskDefinitions)
+            .values({
+            id: randomUUID(),
+            name: values.name,
+            schedule: values.schedule,
+            taskType: values.taskType,
+            prompt: values.prompt,
+            enabled: values.enabled ?? true,
+            since: now,
+            createdAt: now,
+        })
+            .returning()
+            .get();
+    }
+    getDefinition(id) {
+        return this.db.select().from(taskDefinitions).where(eq(taskDefinitions.id, id)).get() ?? null;
+    }
+    listEnabledDefinitions() {
+        return this.db.select().from(taskDefinitions).where(eq(taskDefinitions.enabled, true)).all();
+    }
+    listDisabledDefinitions() {
+        return this.db.select().from(taskDefinitions).where(eq(taskDefinitions.enabled, false)).all();
+    }
+    /** Stamps `since` on every update (overridable) so schedule edits reset the cron anchor. */
+    updateDefinition(id, patch) {
+        return (this.db
+            .update(taskDefinitions)
+            .set({ since: this.now(), ...patch })
+            .where(eq(taskDefinitions.id, id))
+            .returning()
+            .get() ?? null);
+    }
+    // ---- instances ----------------------------------------------------------------
+    createInstance(values) {
+        const now = this.now();
+        return this.db
+            .insert(taskInstances)
+            .values({
+            id: randomUUID(),
+            definitionId: values.definitionId,
+            taskType: values.taskType,
+            status: "pending",
+            prompt: values.prompt,
+            scheduledFor: values.scheduledFor,
+            updatedAt: now,
+            createdAt: now,
+        })
+            .returning()
+            .get();
+    }
+    getInstance(id) {
+        return this.db.select().from(taskInstances).where(eq(taskInstances.id, id)).get() ?? null;
+    }
+    getPendingInstances(taskType) {
+        return this.db
+            .select()
+            .from(taskInstances)
+            .where(and(eq(taskInstances.status, "pending"), eq(taskInstances.taskType, taskType)))
+            .all();
+    }
+    /**
+     * 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, scheduledFor) {
+        const conditions = [eq(taskInstances.definitionId, definitionId)];
+        if (scheduledFor != null) {
+            conditions.push(eq(taskInstances.scheduledFor, scheduledFor), inArray(taskInstances.status, PERIOD_COVERING_STATUSES));
+        }
+        else {
+            conditions.push(inArray(taskInstances.status, ACTIVE_STATUSES));
+        }
+        return (this.db
+            .select()
+            .from(taskInstances)
+            .where(and(...conditions))
+            .get() ?? null);
+    }
+    /** Waiting instances whose last update is older than `timeoutSeconds`. */
+    listExpiredWaitingInstances(timeoutSeconds) {
+        const threshold = new Date(this.now().getTime() - timeoutSeconds * 1000);
+        return this.db
+            .select()
+            .from(taskInstances)
+            .where(and(eq(taskInstances.status, "waiting"), lt(taskInstances.updatedAt, threshold)))
+            .all();
+    }
+    /** Stamps `updatedAt` on every update unless the patch overrides it. */
+    updateInstance(id, patch) {
+        return (this.db
+            .update(taskInstances)
+            .set({ updatedAt: this.now(), ...patch })
+            .where(eq(taskInstances.id, id))
+            .returning()
+            .get() ?? null);
+    }
+    queryInstances({ status, taskType, definitionId, limit = 20, }) {
+        const conditions = [
+            status != null ? eq(taskInstances.status, status) : null,
+            taskType != null ? eq(taskInstances.taskType, taskType) : null,
+            definitionId != null ? eq(taskInstances.definitionId, definitionId) : null,
+        ].filter((condition) => condition != null);
+        return this.db
+            .select()
+            .from(taskInstances)
+            .where(conditions.length > 0 ? and(...conditions) : undefined)
+            .orderBy(desc(taskInstances.createdAt))
+            .limit(limit)
+            .all();
+    }
+    /**
+     * Crash recovery: running instances from a previous process are failed because
+     * their executors are gone. Returns the number of instances marked.
+     */
+    markRunningAsFailed(reason) {
+        return this.db
+            .update(taskInstances)
+            .set({
+            status: "failed",
+            completedAt: this.now(),
+            updatedAt: this.now(),
+            result: `Task failed: ${reason}`,
+        })
+            .where(eq(taskInstances.status, "running"))
+            .returning()
+            .all().length;
+    }
+}
+//# sourceMappingURL=repository.js.map

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

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

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

@@ -0,0 +1,13 @@
+import type { StoredSchedule } from "./schema.ts";
+export declare class ScheduleError extends Error {
+}
+/**
+ * Parse a schedule string into its stored form: a cron expression (recurring)
+ * or an ISO datetime (one-shot). Bare datetimes are interpreted in the
+ * configured timezone; explicit offsets (including Z) are preserved.
+ */
+export declare const parseSchedule: (raw: string, timezone: string | undefined, now: Date) => StoredSchedule;
+/** Next cron occurrence strictly after `anchor`, or null when none exists. */
+export declare const nextCronRun: (expression: string, timezone: string | undefined, anchor: Date) => Date | null;
+export declare const formatInTimezone: (date: Date, timezone: string | undefined) => string;
+export declare const formatSchedule: (schedule: StoredSchedule, timezone: string | undefined) => string;

package/dist/extensions/tasks/schedule.js

@@ -0,0 +1,32 @@
+import { Cron } from "croner";
+export class ScheduleError extends Error {
+}
+/**
+ * Parse a schedule string into its stored form: a cron expression (recurring)
+ * or an ISO datetime (one-shot). Bare datetimes are interpreted in the
+ * configured timezone; explicit offsets (including Z) are preserved.
+ */
+export const parseSchedule = (raw, timezone, now) => {
+    let probe;
+    try {
+        probe = new Cron(raw, { timezone });
+    }
+    catch {
+        throw new ScheduleError(`Invalid schedule '${raw}'. Use a cron expression (e.g., '0 9 * * *') or an ISO datetime (e.g., '2026-03-22T10:00:00Z').`);
+    }
+    // getPattern() is undefined when croner parsed the input as a one-shot datetime.
+    if (probe.getPattern() != null)
+        return { type: "cron", expression: raw };
+    const at = probe.nextRun(now);
+    if (at == null) {
+        throw new ScheduleError(`One-shot schedule datetime must be in the future. Got: ${raw}`);
+    }
+    return { type: "once", at: at.toISOString() };
+};
+/** Next cron occurrence strictly after `anchor`, or null when none exists. */
+export const nextCronRun = (expression, timezone, anchor) => new Cron(expression, { timezone }).nextRun(anchor);
+export const formatInTimezone = (date, timezone) => date.toLocaleString("sv-SE", { timeZone: timezone, timeZoneName: "short" });
+export const formatSchedule = (schedule, timezone) => schedule.type === "cron"
+    ? `cron: ${schedule.expression}`
+    : `once: ${formatInTimezone(new Date(schedule.at), timezone)}`;
+//# sourceMappingURL=schedule.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schedule.js","sourceRoot":"","sources":["../../../src/extensions/tasks/schedule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAI9B,MAAM,OAAO,aAAc,SAAQ,KAAK;CAAG;AAE3C;;;;GAIG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAC3B,GAAW,EACX,QAA4B,EAC5B,GAAS,EACO,EAAE;IAClB,IAAI,KAAW,CAAC;IAEhB,IAAI,CAAC;QACH,KAAK,GAAG,IAAI,IAAI,CAAC,GAAG,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;IACtC,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,aAAa,CACrB,qBAAqB,GAAG,iGAAiG,CAC1H,CAAC;IACJ,CAAC;IAED,iFAAiF;IACjF,IAAI,KAAK,CAAC,UAAU,EAAE,IAAI,IAAI;QAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC;IAEzE,MAAM,EAAE,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAE9B,IAAI,EAAE,IAAI,IAAI,EAAE,CAAC;QACf,MAAM,IAAI,aAAa,CAAC,0DAA0D,GAAG,EAAE,CAAC,CAAC;IAC3F,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC;AAChD,CAAC,CAAC;AAEF,8EAA8E;AAC9E,MAAM,CAAC,MAAM,WAAW,GAAG,CACzB,UAAkB,EAClB,QAA4B,EAC5B,MAAY,EACC,EAAE,CAAC,IAAI,IAAI,CAAC,UAAU,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;AAErE,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,IAAU,EAAE,QAA4B,EAAU,EAAE,CACnF,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,YAAY,EAAE,OAAO,EAAE,CAAC,CAAC;AAE9E,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,QAAwB,EAAE,QAA4B,EAAU,EAAE,CAC/F,QAAQ,CAAC,IAAI,KAAK,MAAM;IACtB,CAAC,CAAC,SAAS,QAAQ,CAAC,UAAU,EAAE;IAChC,CAAC,CAAC,SAAS,gBAAgB,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,QAAQ,CAAC,EAAE,CAAC"}

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

@@ -0,0 +1,423 @@
+export declare const TASK_TYPES: {
+    readonly session: "session";
+    readonly background: "background";
+};
+export type TaskType = keyof typeof TASK_TYPES;
+export declare const TASK_STATUSES: {
+    readonly pending: "pending";
+    readonly running: "running";
+    readonly waiting: "waiting";
+    readonly completed: "completed";
+    readonly failed: "failed";
+};
+export type TaskStatus = keyof typeof TASK_STATUSES;
+export interface CronSchedule {
+    type: "cron";
+    expression: string;
+}
+export interface OnceSchedule {
+    type: "once";
+    /** ISO instant — JSON columns cannot hold Date objects. */
+    at: string;
+}
+export type StoredSchedule = CronSchedule | OnceSchedule;
+export declare const taskDefinitions: import("drizzle-orm/sqlite-core").SQLiteTableWithColumns<{
+    name: "task_definitions";
+    schema: undefined;
+    columns: {
+        id: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "id";
+            tableName: "task_definitions";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: true;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+        }>;
+        name: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "name";
+            tableName: "task_definitions";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+        }>;
+        schedule: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "schedule";
+            tableName: "task_definitions";
+            dataType: "json";
+            columnType: "SQLiteTextJson";
+            data: StoredSchedule;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            $type: StoredSchedule;
+        }>;
+        taskType: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "task_type";
+            tableName: "task_definitions";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: "session" | "background";
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+            $type: "session" | "background";
+        }>;
+        prompt: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "prompt";
+            tableName: "task_definitions";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+        }>;
+        enabled: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "enabled";
+            tableName: "task_definitions";
+            dataType: "boolean";
+            columnType: "SQLiteBoolean";
+            data: boolean;
+            driverParam: number;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        lastFiredAt: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "last_fired_at";
+            tableName: "task_definitions";
+            dataType: "date";
+            columnType: "SQLiteTimestamp";
+            data: Date;
+            driverParam: number;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        since: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "since";
+            tableName: "task_definitions";
+            dataType: "date";
+            columnType: "SQLiteTimestamp";
+            data: Date;
+            driverParam: number;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        createdAt: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "created_at";
+            tableName: "task_definitions";
+            dataType: "date";
+            columnType: "SQLiteTimestamp";
+            data: Date;
+            driverParam: number;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+    };
+    dialect: "sqlite";
+}>;
+export type TaskDefinitionRecord = typeof taskDefinitions.$inferSelect;
+export declare const taskInstances: import("drizzle-orm/sqlite-core").SQLiteTableWithColumns<{
+    name: "task_instances";
+    schema: undefined;
+    columns: {
+        id: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "id";
+            tableName: "task_instances";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: true;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+        }>;
+        definitionId: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "definition_id";
+            tableName: "task_instances";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+        }>;
+        taskType: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "task_type";
+            tableName: "task_instances";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: "session" | "background";
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+            $type: "session" | "background";
+        }>;
+        status: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "status";
+            tableName: "task_instances";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: "completed" | "failed" | "running" | "pending" | "waiting";
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+            $type: "completed" | "failed" | "running" | "pending" | "waiting";
+        }>;
+        prompt: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "prompt";
+            tableName: "task_instances";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+        }>;
+        scheduledFor: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "scheduled_for";
+            tableName: "task_instances";
+            dataType: "date";
+            columnType: "SQLiteTimestamp";
+            data: Date;
+            driverParam: number;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        startedAt: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "started_at";
+            tableName: "task_instances";
+            dataType: "date";
+            columnType: "SQLiteTimestamp";
+            data: Date;
+            driverParam: number;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        completedAt: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "completed_at";
+            tableName: "task_instances";
+            dataType: "date";
+            columnType: "SQLiteTimestamp";
+            data: Date;
+            driverParam: number;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        result: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "result";
+            tableName: "task_instances";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+        }>;
+        userResponse: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "user_response";
+            tableName: "task_instances";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+        }>;
+        updatedAt: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "updated_at";
+            tableName: "task_instances";
+            dataType: "date";
+            columnType: "SQLiteTimestamp";
+            data: Date;
+            driverParam: number;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        createdAt: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "created_at";
+            tableName: "task_instances";
+            dataType: "date";
+            columnType: "SQLiteTimestamp";
+            data: Date;
+            driverParam: number;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+    };
+    dialect: "sqlite";
+}>;
+export type TaskInstanceRecord = typeof taskInstances.$inferSelect;

package/dist/extensions/tasks/schema.js

@@ -0,0 +1,45 @@
+import { index, integer, sqliteTable, text } from "drizzle-orm/sqlite-core";
+export const TASK_TYPES = {
+    session: "session",
+    background: "background",
+};
+export const TASK_STATUSES = {
+    pending: "pending",
+    running: "running",
+    waiting: "waiting",
+    completed: "completed",
+    failed: "failed",
+};
+export const taskDefinitions = sqliteTable("task_definitions", {
+    id: text("id").primaryKey(),
+    name: text("name").notNull(),
+    schedule: text("schedule", { mode: "json" }).$type().notNull(),
+    taskType: text("task_type").$type().notNull(),
+    prompt: text("prompt").notNull(),
+    enabled: integer("enabled", { mode: "boolean" }).notNull().default(true),
+    lastFiredAt: integer("last_fired_at", { mode: "timestamp" }),
+    // Stamped on every insert and update — anchors stale-cron prevention so a
+    // definition never fires for occurrences that predate its latest edit.
+    since: integer("since", { mode: "timestamp" }).notNull(),
+    createdAt: integer("created_at", { mode: "timestamp" }).notNull(),
+});
+export const taskInstances = sqliteTable("task_instances", {
+    id: text("id").primaryKey(),
+    // Nullable — ad-hoc instances have no parent definition.
+    definitionId: text("definition_id").references(() => taskDefinitions.id),
+    taskType: text("task_type").$type().notNull(),
+    status: text("status").$type().notNull(),
+    prompt: text("prompt").notNull(),
+    scheduledFor: integer("scheduled_for", { mode: "timestamp" }).notNull(),
+    startedAt: integer("started_at", { mode: "timestamp" }),
+    completedAt: integer("completed_at", { mode: "timestamp" }),
+    result: text("result"),
+    userResponse: text("user_response"),
+    // Stamped on every update — anchors the waiting-instance expiration sweep.
+    updatedAt: integer("updated_at", { mode: "timestamp" }).notNull(),
+    createdAt: integer("created_at", { mode: "timestamp" }).notNull(),
+}, (table) => [
+    index("ix_task_instances_status").on(table.status),
+    index("ix_task_instances_task_type").on(table.taskType),
+]);
+//# sourceMappingURL=schema.js.map

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

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