@hasna/loops 0.3.56 → 0.3.58

package/dist/lib/executor.d.ts

@@ -1,7 +1,9 @@
+import type { LanguageModel } from "ai";
 import type { ExecutableTarget, ExecutorResult, Loop, LoopMachineRef, LoopRun, PersistGuardOptions } from "../types.js";
 export interface ExecuteOptions extends PersistGuardOptions {
     maxOutputBytes?: number;
     env?: NodeJS.ProcessEnv;
+    goalModel?: LanguageModel;
     log?: (message: string) => void;
     signal?: AbortSignal;
     onSpawn?: (pid: number) => void;

package/dist/lib/health.d.ts

@@ -1,6 +1,6 @@
 import type { Loop, LoopRun } from "../types.js";
 import type { Store } from "./store.js";
-export type RunFailureClassification = "rate_limit" | "auth" | "model_not_found" | "context_length" | "schema_response_format" | "node_init" | "preflight" | "timeout" | "sigsegv" | "skipped_previous_active" | "unknown";
+export type RunFailureClassification = "rate_limit" | "auth" | "model_not_found" | "context_length" | "schema_response_format" | "node_init" | "preflight" | "route_functional" | "timeout" | "sigsegv" | "skipped_previous_active" | "unknown";
 export interface RunFailureSignal {
     classification: RunFailureClassification;
     fingerprint: string;
@@ -34,7 +34,7 @@ export interface LoopExpectationResult {
     loop: Pick<Loop, "id" | "name" | "status" | "nextRunAt">;
     ok: boolean;
     check: {
-        id: "latest-run-succeeded";
+        id: "latest-run-succeeded" | "route-functional-health";
         status: "pass" | "fail" | "warn";
         message: string;
     };

package/dist/lib/store.d.ts

@@ -71,6 +71,7 @@ export declare class Store {
     private addColumnIfMissing;
     private createWorkflowRunBackfillIndexes;
     private assertDaemonLeaseFence;
+    private assertNoNestedWorkflowGoal;
     createLoop(input: CreateLoopInput, from?: Date): Loop;
     getLoop(id: string): Loop | undefined;
     findLoopByName(name: string): Loop | undefined;
@@ -140,6 +141,9 @@ export declare class Store {
         project: number;
         projectGroup?: number;
     };
+    requeueWorkflowWorkItem(id: string, patch?: {
+        reason?: string;
+    }): WorkflowWorkItem;
     admitWorkflowWorkItem(id: string, patch: {
         workflowId: string;
         loopId: string;

package/dist/lib/store.js

@@ -459,6 +459,9 @@ function validateTarget(value, label, opts) {
     }
     if (value.model !== undefined)
       assertString(value.model, `${label}.model`);
+    if (value.provider === "opencode" && (typeof value.model !== "string" || value.model.trim() === "")) {
+      throw new Error(`${label}.model is required for provider opencode; pass a provider/model id such as openrouter/google/gemini-2.5-flash`);
+    }
     if (value.variant !== undefined)
       assertString(value.variant, `${label}.variant`);
     if (value.agent !== undefined)
@@ -1255,12 +1258,21 @@ class Store {
     if (!row)
       throw new Error("daemon lease lost");
   }
+  assertNoNestedWorkflowGoal(target, goal) {
+    if (!goal || target.type !== "workflow")
+      return;
+    const workflow = this.getWorkflow(target.workflowId);
+    if (workflow?.goal) {
+      throw new Error(`workflow loop cannot define a loop-level goal when workflow ${workflow.name} already has a top-level goal; remove one goal wrapper`);
+    }
+  }
   createLoop(input, from = new Date) {
     const now = nowIso();
     const target = input.target.type === "workflow" ? input.target : normalizeCreateWorkflowInput({
       name: "loop-target-validation",
       steps: [{ id: "target", target: input.target }]
     }).steps[0].target;
+    this.assertNoNestedWorkflowGoal(target, input.goal);
     const loop = {
       id: genId(),
       name: input.name,
@@ -1432,6 +1444,9 @@ class Store {
       if (this.hasRunningRun(current.id))
         throw new Error(`refusing to retarget running loop: ${current.id}`);
       const workflow = this.requireWorkflow(workflowId);
+      if (current.goal && workflow.goal) {
+        throw new Error(`workflow loop cannot retarget ${current.name} to workflow ${workflow.name} because both define top-level goals`);
+      }
       const target = { ...current.target, workflowId: workflow.id };
       if (opts.workflowTimeoutMs !== undefined)
         target.timeoutMs = opts.workflowTimeoutMs;
@@ -1470,6 +1485,9 @@ class Store {
         throw new Error(`loop is not a workflow loop: ${idOrName}`);
       if (this.hasRunningRun(current.id))
         throw new Error(`refusing to retarget running loop: ${current.id}`);
+      if (current.goal && normalized.goal) {
+        throw new Error(`workflow loop cannot retarget ${current.name} to a workflow that also defines a top-level goal`);
+      }
       const previousWorkflow = this.requireWorkflow(current.target.workflowId);
       const workflow = {
         id: genId(),
@@ -1761,7 +1779,7 @@ class Store {
     if (!sourceDedupeKey)
       throw new Error("cannot refresh workflow invocation without sourceRef.dedupeKey");
     const now = nowIso();
-    const claimableStatuses = ["queued", "deferred", "failed", "dead_letter", "cancelled"];
+    const claimableStatuses = ["queued", "deferred"];
     const statusBindings = Object.fromEntries(claimableStatuses.map((status, index) => [`$status${index}`, status]));
     const placeholders = claimableStatuses.map((_, index) => `$status${index}`).join(",");
     const result = this.db.query(`UPDATE workflow_invocations
@@ -1842,28 +1860,35 @@ class Store {
           project_group=excluded.project_group,
           priority=excluded.priority,
           status=CASE
-            WHEN workflow_work_items.status IN ('succeeded', 'admitted', 'running')
+            WHEN workflow_work_items.status IN ('succeeded', 'admitted', 'running', 'failed', 'dead_letter', 'cancelled')
               THEN workflow_work_items.status
             ELSE excluded.status
           END,
           workflow_id=CASE
-            WHEN workflow_work_items.status IN ('succeeded', 'admitted', 'running') THEN workflow_work_items.workflow_id
+            WHEN workflow_work_items.status IN ('succeeded', 'admitted', 'running', 'failed', 'dead_letter', 'cancelled') THEN workflow_work_items.workflow_id
             ELSE NULL
           END,
           loop_id=CASE
-            WHEN workflow_work_items.status IN ('succeeded', 'admitted', 'running') THEN workflow_work_items.loop_id
+            WHEN workflow_work_items.status IN ('succeeded', 'admitted', 'running', 'failed', 'dead_letter', 'cancelled') THEN workflow_work_items.loop_id
             ELSE NULL
           END,
           workflow_run_id=CASE
-            WHEN workflow_work_items.status IN ('succeeded', 'admitted', 'running') THEN workflow_work_items.workflow_run_id
+            WHEN workflow_work_items.status IN ('succeeded', 'admitted', 'running', 'failed', 'dead_letter', 'cancelled') THEN workflow_work_items.workflow_run_id
             ELSE NULL
           END,
           lease_expires_at=CASE
-            WHEN workflow_work_items.status IN ('succeeded', 'admitted', 'running') THEN workflow_work_items.lease_expires_at
+            WHEN workflow_work_items.status IN ('succeeded', 'admitted', 'running', 'failed', 'dead_letter', 'cancelled') THEN workflow_work_items.lease_expires_at
             ELSE NULL
           END,
           next_attempt_at=excluded.next_attempt_at,
-          last_reason=COALESCE(excluded.last_reason, workflow_work_items.last_reason),
+          last_reason=CASE
+            WHEN workflow_work_items.attempts > 0
+              AND workflow_work_items.status IN ('queued', 'deferred')
+              AND workflow_work_items.last_reason IS NOT NULL
+              AND excluded.last_reason IS NOT NULL
+              THEN workflow_work_items.last_reason || '; ' || excluded.last_reason
+            ELSE COALESCE(excluded.last_reason, workflow_work_items.last_reason)
+          END,
           updated_at=excluded.updated_at`).run({
       $id: id,
       $routeKey: input.routeKey,
@@ -1916,11 +1941,39 @@ class Store {
     const projectGroup = args.projectGroup ? this.db.query(`SELECT COUNT(*) AS count FROM workflow_work_items WHERE status IN (${placeholders}) AND project_group = ?`).get(...active, args.projectGroup)?.count ?? 0 : undefined;
     return { global, project, ...projectGroup !== undefined ? { projectGroup } : {} };
   }
+  requeueWorkflowWorkItem(id, patch = {}) {
+    const current = this.getWorkflowWorkItem(id);
+    if (!current)
+      throw new Error(`workflow work item not found: ${id}`);
+    const requeueableStatuses = ["succeeded", "failed", "dead_letter", "cancelled"];
+    if (!requeueableStatuses.includes(current.status)) {
+      throw new Error(`workflow work item is not requeueable: ${id} status=${current.status}`);
+    }
+    const now = nowIso();
+    const reason = patch.reason?.trim() || `requeued from ${current.status}`;
+    const placeholders = requeueableStatuses.map(() => "?").join(",");
+    const res = this.db.query(`UPDATE workflow_work_items
+         SET status='queued', workflow_id=NULL, loop_id=NULL, workflow_run_id=NULL,
+          next_attempt_at=NULL, lease_expires_at=NULL, last_reason=?, updated_at=?
+         WHERE id=? AND status IN (${placeholders})`).run(reason, now, id, ...requeueableStatuses);
+    const item = this.getWorkflowWorkItem(id);
+    if (!item)
+      throw new Error(`workflow work item not found after requeue: ${id}`);
+    if (res.changes !== 1)
+      throw new Error(`workflow work item was not requeued: ${id} status=${item.status}`);
+    return item;
+  }
   admitWorkflowWorkItem(id, patch) {
     const now = nowIso();
     const res = this.db.query(`UPDATE workflow_work_items
          SET status='admitted', attempts=attempts + 1, workflow_id=$workflowId, loop_id=$loopId,
-          next_attempt_at=NULL, lease_expires_at=NULL, last_reason=$reason, updated_at=$updated
+          next_attempt_at=NULL,
+          lease_expires_at=NULL,
+          last_reason=CASE
+            WHEN last_reason IS NOT NULL AND $reason IS NOT NULL THEN last_reason || '; ' || $reason
+            ELSE COALESCE($reason, last_reason)
+          END,
+          updated_at=$updated
          WHERE id=$id AND status IN ('queued', 'deferred')`).run({
       $id: id,
       $workflowId: patch.workflowId,

package/dist/lib/templates.d.ts

@@ -41,6 +41,8 @@ export interface TodosTaskWorkflowTemplateInput {
     worktreeRoot?: string;
     worktreeBranchPrefix?: string;
     timeoutMs?: TimeoutMs;
+    verifierIdleTimeoutMs?: number;
+    prHandoff?: boolean;
     eventId?: string;
     eventType?: string;
 }
@@ -78,6 +80,7 @@ export interface EventWorkflowTemplateInput {
     worktreeRoot?: string;
     worktreeBranchPrefix?: string;
     timeoutMs?: TimeoutMs;
+    verifierIdleTimeoutMs?: number;
 }
 export interface BoundedAgentWorkflowTemplateInput {
     name?: string;
@@ -110,6 +113,7 @@ export interface BoundedAgentWorkflowTemplateInput {
     worktreeRoot?: string;
     worktreeBranchPrefix?: string;
     timeoutMs?: TimeoutMs;
+    verifierIdleTimeoutMs?: number;
 }
 export type LoopTemplateSourceFilter = LoopTemplateSource | "all";
 export interface ListLoopTemplatesOptions {

package/dist/mcp/index.d.ts

@@ -0,0 +1,12 @@
+#!/usr/bin/env bun
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export interface LoopsMcpToolMetadata {
+    name: string;
+    description: string;
+    readOnly: boolean;
+    guarded?: boolean;
+    requiresEnv?: string;
+}
+export declare const LOOPS_MCP_TOOLS: LoopsMcpToolMetadata[];
+export declare function createLoopsMcpServer(): McpServer;
+export declare function listToolsForCli(): LoopsMcpToolMetadata[];