@hasna/loops 0.4.1 → 0.4.2

package/dist/lib/format.d.ts

@@ -4,7 +4,9 @@ export declare function textOutputBlocks(value: Pick<LoopRun | WorkflowStepRun,
     indent?: string;
 }): string[];
 export declare function publicLoop(loop: Loop): Record<string, unknown>;
-export declare function publicRun(run: LoopRun, showOutput?: boolean): Record<string, unknown>;
+export declare function publicRun(run: LoopRun, showOutput?: boolean, opts?: {
+    redactError?: boolean;
+}): Record<string, unknown>;
 export declare function publicExecutorResult(result: ExecutorResult, showOutput?: boolean): Record<string, unknown>;
 export declare function publicWorkflow(workflow: WorkflowSpec): Record<string, unknown>;
 export declare function publicWorkflowRun(run: WorkflowRun): Record<string, unknown>;

package/dist/lib/mode.js

@@ -2,7 +2,7 @@
 // package.json
 var package_default = {
   name: "@hasna/loops",
-  version: "0.4.1",
+  version: "0.4.2",
   description: "Persistent local loop and workflow runner for deterministic commands and headless AI coding agents",
   type: "module",
   main: "dist/index.js",
@@ -42,6 +42,22 @@ var package_default = {
     "./storage": {
       types: "./dist/lib/store.d.ts",
       import: "./dist/lib/store.js"
+    },
+    "./storage/contract": {
+      types: "./dist/lib/storage/contract.d.ts",
+      import: "./dist/lib/storage/contract.js"
+    },
+    "./storage/sqlite": {
+      types: "./dist/lib/storage/sqlite.d.ts",
+      import: "./dist/lib/storage/sqlite.js"
+    },
+    "./storage/postgres": {
+      types: "./dist/lib/storage/postgres.d.ts",
+      import: "./dist/lib/storage/postgres.js"
+    },
+    "./storage/postgres-schema": {
+      types: "./dist/lib/storage/postgres-schema.d.ts",
+      import: "./dist/lib/storage/postgres-schema.js"
     }
   },
   files: [
@@ -52,7 +68,7 @@ var package_default = {
     "LICENSE"
   ],
   scripts: {
-    build: "rm -rf dist && bun build src/cli/index.ts src/daemon/index.ts src/api/index.ts src/runner/index.ts src/mcp/index.ts src/index.ts src/sdk/index.ts src/lib/store.ts src/lib/mode.ts --root src --outdir dist --target bun --packages external && chmod +x dist/cli/index.js dist/daemon/index.js dist/api/index.js dist/runner/index.js dist/mcp/index.js && tsc -p tsconfig.build.json --emitDeclarationOnly --outDir dist",
+    build: "rm -rf dist && bun build src/cli/index.ts src/daemon/index.ts src/api/index.ts src/runner/index.ts src/mcp/index.ts src/index.ts src/sdk/index.ts src/lib/store.ts src/lib/mode.ts src/lib/storage/index.ts src/lib/storage/contract.ts src/lib/storage/sqlite.ts src/lib/storage/postgres.ts src/lib/storage/postgres-schema.ts --root src --outdir dist --target bun --packages external && chmod +x dist/cli/index.js dist/daemon/index.js dist/api/index.js dist/runner/index.js dist/mcp/index.js && tsc -p tsconfig.build.json --emitDeclarationOnly --outDir dist",
     "build:bin": "bun build src/cli/index.ts --compile --outfile dist/loops",
     typecheck: "tsc --noEmit",
     test: "bun test",

package/dist/lib/route/todos-cli.d.ts

@@ -11,6 +11,7 @@ export declare function runLocalCommand(command: string, args: string[], opts?:
     input?: string;
     timeoutMs?: number;
     maxBuffer?: number;
+    env?: Record<string, string | undefined>;
 }): LocalCommandResult;
 export declare function runLocalCommandWithStdoutFile(command: string, args: string[], opts?: {
     input?: string;

package/dist/lib/route/types.d.ts

@@ -47,6 +47,11 @@ export interface TodosReadyTask {
     id?: string;
     task_id?: string;
     taskId?: string;
+    source_store_id?: string;
+    source_repo_path?: string;
+    source_db_path?: string;
+    source_task_key?: string;
+    source_selected_by_input?: boolean;
     title?: string;
     description?: string;
     body?: string;
@@ -65,11 +70,16 @@ export interface TodosReadyTask {
     task_list?: {
         id?: string;
         slug?: string;
+        name?: string;
     };
     [key: string]: unknown;
 }
 export interface TodosDrainOptions extends TodosTaskRouteOptions {
     todosProject?: string;
+    todosSourceRoot?: string[];
+    todosSourceStore?: string[];
+    todosSourceInclude?: string[];
+    todosSourceExclude?: string[];
     todosProjectId?: string;
     taskList?: string;
     tags?: string;

package/dist/lib/storage/contract.d.ts

@@ -0,0 +1,133 @@
+import type { Store } from "../store.js";
+export type LoopStorageBackend = "sqlite" | "postgres";
+export type LoopStorageMethodName = "createLoop" | "getLoop" | "findLoopByName" | "requireLoop" | "listLoops" | "dueLoops" | "updateLoop" | "renameLoop" | "archiveLoop" | "unarchiveLoop" | "deleteLoop" | "createWorkflow" | "getWorkflow" | "listWorkflows" | "countWorkflows" | "archiveWorkflow" | "createWorkflowInvocation" | "getWorkflowInvocation" | "listWorkflowInvocations" | "upsertWorkflowWorkItem" | "getWorkflowWorkItem" | "listWorkflowWorkItems" | "countActiveWorkflowWorkItems" | "admitWorkflowWorkItem" | "createGoal" | "getGoal" | "listGoals" | "createGoalPlanNodes" | "listGoalPlanNodes" | "updateGoalStatus" | "updateGoalPlanNode" | "recordGoalEvent" | "listGoalRuns" | "createWorkflowRun" | "getWorkflowRun" | "listWorkflowRuns" | "listWorkflowStepRuns" | "getWorkflowStepRun" | "startWorkflowStepRun" | "recoverWorkflowRun" | "finalizeWorkflowStepRun" | "finalizeWorkflowRun" | "appendWorkflowEvent" | "listWorkflowEvents" | "recordRunProcess" | "createSkippedRun" | "getRun" | "getRunBySlot" | "claimRun" | "finalizeRun" | "heartbeatRunLease" | "listRuns" | "recoverExpiredRunLeases" | "recoverExpiredRunLeasesDetailed" | "countLoops" | "countRuns" | "pruneHistory" | "acquireDaemonLease" | "heartbeatDaemonLease" | "releaseDaemonLease" | "getDaemonLease";
+type AsyncStoreMethod<K extends LoopStorageMethodName> = Store[K] extends (...args: infer Args) => infer Result ? (...args: Args) => Promise<Result> : never;
+export interface LoopStorageContract extends Record<LoopStorageMethodName, (...args: never[]) => Promise<unknown>> {
+    readonly backend: LoopStorageBackend;
+    readonly supportsRemoteRunners: boolean;
+    close(): Promise<void>;
+    createLoop: AsyncStoreMethod<"createLoop">;
+    getLoop: AsyncStoreMethod<"getLoop">;
+    findLoopByName: AsyncStoreMethod<"findLoopByName">;
+    requireLoop: AsyncStoreMethod<"requireLoop">;
+    listLoops: AsyncStoreMethod<"listLoops">;
+    dueLoops: AsyncStoreMethod<"dueLoops">;
+    updateLoop: AsyncStoreMethod<"updateLoop">;
+    renameLoop: AsyncStoreMethod<"renameLoop">;
+    archiveLoop: AsyncStoreMethod<"archiveLoop">;
+    unarchiveLoop: AsyncStoreMethod<"unarchiveLoop">;
+    deleteLoop: AsyncStoreMethod<"deleteLoop">;
+    createWorkflow: AsyncStoreMethod<"createWorkflow">;
+    getWorkflow: AsyncStoreMethod<"getWorkflow">;
+    listWorkflows: AsyncStoreMethod<"listWorkflows">;
+    countWorkflows: AsyncStoreMethod<"countWorkflows">;
+    archiveWorkflow: AsyncStoreMethod<"archiveWorkflow">;
+    createWorkflowInvocation: AsyncStoreMethod<"createWorkflowInvocation">;
+    getWorkflowInvocation: AsyncStoreMethod<"getWorkflowInvocation">;
+    listWorkflowInvocations: AsyncStoreMethod<"listWorkflowInvocations">;
+    upsertWorkflowWorkItem: AsyncStoreMethod<"upsertWorkflowWorkItem">;
+    getWorkflowWorkItem: AsyncStoreMethod<"getWorkflowWorkItem">;
+    listWorkflowWorkItems: AsyncStoreMethod<"listWorkflowWorkItems">;
+    countActiveWorkflowWorkItems: AsyncStoreMethod<"countActiveWorkflowWorkItems">;
+    admitWorkflowWorkItem: AsyncStoreMethod<"admitWorkflowWorkItem">;
+    createGoal: AsyncStoreMethod<"createGoal">;
+    getGoal: AsyncStoreMethod<"getGoal">;
+    listGoals: AsyncStoreMethod<"listGoals">;
+    createGoalPlanNodes: AsyncStoreMethod<"createGoalPlanNodes">;
+    listGoalPlanNodes: AsyncStoreMethod<"listGoalPlanNodes">;
+    updateGoalStatus: AsyncStoreMethod<"updateGoalStatus">;
+    updateGoalPlanNode: AsyncStoreMethod<"updateGoalPlanNode">;
+    recordGoalEvent: AsyncStoreMethod<"recordGoalEvent">;
+    listGoalRuns: AsyncStoreMethod<"listGoalRuns">;
+    createWorkflowRun: AsyncStoreMethod<"createWorkflowRun">;
+    getWorkflowRun: AsyncStoreMethod<"getWorkflowRun">;
+    listWorkflowRuns: AsyncStoreMethod<"listWorkflowRuns">;
+    listWorkflowStepRuns: AsyncStoreMethod<"listWorkflowStepRuns">;
+    getWorkflowStepRun: AsyncStoreMethod<"getWorkflowStepRun">;
+    startWorkflowStepRun: AsyncStoreMethod<"startWorkflowStepRun">;
+    recoverWorkflowRun: AsyncStoreMethod<"recoverWorkflowRun">;
+    finalizeWorkflowStepRun: AsyncStoreMethod<"finalizeWorkflowStepRun">;
+    finalizeWorkflowRun: AsyncStoreMethod<"finalizeWorkflowRun">;
+    appendWorkflowEvent: AsyncStoreMethod<"appendWorkflowEvent">;
+    listWorkflowEvents: AsyncStoreMethod<"listWorkflowEvents">;
+    recordRunProcess: AsyncStoreMethod<"recordRunProcess">;
+    createSkippedRun: AsyncStoreMethod<"createSkippedRun">;
+    getRun: AsyncStoreMethod<"getRun">;
+    getRunBySlot: AsyncStoreMethod<"getRunBySlot">;
+    claimRun: AsyncStoreMethod<"claimRun">;
+    finalizeRun: AsyncStoreMethod<"finalizeRun">;
+    heartbeatRunLease: AsyncStoreMethod<"heartbeatRunLease">;
+    listRuns: AsyncStoreMethod<"listRuns">;
+    recoverExpiredRunLeases: AsyncStoreMethod<"recoverExpiredRunLeases">;
+    recoverExpiredRunLeasesDetailed: AsyncStoreMethod<"recoverExpiredRunLeasesDetailed">;
+    countLoops: AsyncStoreMethod<"countLoops">;
+    countRuns: AsyncStoreMethod<"countRuns">;
+    pruneHistory: AsyncStoreMethod<"pruneHistory">;
+    acquireDaemonLease: AsyncStoreMethod<"acquireDaemonLease">;
+    heartbeatDaemonLease: AsyncStoreMethod<"heartbeatDaemonLease">;
+    releaseDaemonLease: AsyncStoreMethod<"releaseDaemonLease">;
+    getDaemonLease: AsyncStoreMethod<"getDaemonLease">;
+}
+export interface StorageMigration {
+    readonly id: string;
+    readonly checksum: string;
+    readonly sql: string;
+}
+export interface AppliedStorageMigration {
+    readonly id: string;
+    readonly checksum: string;
+    readonly appliedAt: string;
+}
+export interface StorageMigrationPlanItem {
+    readonly migration: StorageMigration;
+    readonly state: "already_applied" | "pending";
+}
+export interface StorageMigrationResult {
+    readonly backend: LoopStorageBackend;
+    readonly dryRun: boolean;
+    readonly applied: AppliedStorageMigration[];
+    readonly plan: StorageMigrationPlanItem[];
+}
+export interface SchemaMigrationStorage {
+    readonly backend: LoopStorageBackend;
+    readonly migrations: readonly StorageMigration[];
+    listAppliedMigrations(): Promise<AppliedStorageMigration[]>;
+    migrate(opts?: {
+        dryRun?: boolean;
+    }): Promise<StorageMigrationResult>;
+    close(): Promise<void>;
+}
+export type RunnerMachineStatus = "active" | "draining" | "offline";
+export type RunnerLeaseStatus = "active" | "released" | "expired" | "stolen";
+export interface RunnerMachineRecord {
+    id: string;
+    hostname: string;
+    labels: Record<string, string>;
+    capabilities: Record<string, unknown>;
+    status: RunnerMachineStatus;
+    lastSeenAt: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface RunnerLeaseRecord {
+    id: string;
+    runnerId: string;
+    loopRunId?: string;
+    workflowRunId?: string;
+    claimToken: string;
+    status: RunnerLeaseStatus;
+    heartbeatAt: string;
+    expiresAt: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface AuditEventRecord {
+    id: string;
+    actor: string;
+    action: string;
+    subjectType: string;
+    subjectId: string;
+    metadata?: Record<string, unknown>;
+    createdAt: string;
+}
+export {};

package/dist/lib/storage/contract.js

@@ -0,0 +1 @@
+// @bun

package/dist/lib/storage/index.d.ts

@@ -0,0 +1,6 @@
+export type { AppliedStorageMigration, AuditEventRecord, LoopStorageBackend, LoopStorageContract, LoopStorageMethodName, RunnerLeaseRecord, RunnerLeaseStatus, RunnerMachineRecord, RunnerMachineStatus, SchemaMigrationStorage, StorageMigration, StorageMigrationPlanItem, StorageMigrationResult, } from "./contract.js";
+export { SqliteLoopStorage, createSqliteLoopStorage } from "./sqlite.js";
+export { PostgresStorage, createPostgresStorage } from "./postgres.js";
+export type { PostgresQueryExecutor } from "./postgres.js";
+export { POSTGRES_MIGRATION_LEDGER_TABLE, POSTGRES_STORAGE_MIGRATIONS, checksumStorageSql, } from "./postgres-schema.js";
+export { Store } from "../store.js";