@hasna/loops 0.4.27 → 0.4.29

package/dist/lib/templates.d.ts

@@ -7,6 +7,14 @@ export interface AgentWorkflowTemplateBaseInput {
     projectPath: string;
     routeProjectPath?: string;
     projectGroup?: string;
+    routeScope?: string;
+    routeThrottleLimits?: {
+        maxActive?: number;
+        maxActiveScope?: string;
+        maxActivePerProject?: number;
+        maxActivePerProjectGroup?: number;
+        maxPerProfile?: number;
+    };
     provider?: AgentProvider;
     authProfile?: string;
     authProfilePool?: string[];
@@ -26,6 +34,9 @@ export interface AgentWorkflowTemplateBaseInput {
     addDirs?: string[];
     permissionMode?: AgentPermissionMode;
     sandbox?: AgentSandbox;
+    allowTools?: string[];
+    allowCommands?: string[];
+    safetyReason?: string;
     manualBreakGlass?: boolean;
     worktreeMode?: AgentWorktreeMode;
     worktreeRoot?: string;

package/dist/lib/workflow-events.d.ts

@@ -0,0 +1,6 @@
+import type { AgentSessionContract, PublicWorkflowEvent, StoredWorkflowEvent, WorkflowLifecycleEventType } from "../types.js";
+export declare const WORKFLOW_LIFECYCLE_EVENT_TYPES: readonly ["created", "workflow_archived", "todos_workflow_pointers_synced", "todos_workflow_pointers_sync_failed", "step_started", "step_progress", "recovered", "step_pending", "step_running", "step_succeeded", "step_failed", "step_timed_out", "step_skipped", "step_cancelled", "succeeded", "failed", "timed_out", "cancelled"];
+export declare function isAgentSessionContract(value: unknown): value is AgentSessionContract;
+export declare function isWorkflowLifecycleEventType(value: string): value is WorkflowLifecycleEventType;
+/** Validate a raw storage/API row before exposing the public discriminated union. */
+export declare function publicWorkflowEvent(event: StoredWorkflowEvent | PublicWorkflowEvent): PublicWorkflowEvent;

package/dist/lib/workflow-provenance.d.ts

@@ -0,0 +1,8 @@
+import type { WorkflowSpec } from "../types.js";
+export declare function workflowDefinitionHash(workflow: WorkflowSpec): string;
+export interface InitialAgentSessionContractEvent {
+    eventType: "agent_session_contract";
+    stepId: string;
+    payload: Record<string, unknown>;
+}
+export declare function initialAgentSessionContractEvents(workflow: WorkflowSpec): InitialAgentSessionContractEvent[];

package/dist/lib/workflow-runner.d.ts

@@ -1,6 +1,7 @@
-import type { ExecutorResult, Loop, LoopRun, WorkflowSpec } from "../types.js";
+import type { ExecutorResult, Loop, LoopRun, StoredWorkflowEvent, WorkflowRun, WorkflowRunStatus, WorkflowSpec, WorkflowStepRun } from "../types.js";
 import { preflightTarget, type ExecuteOptions } from "./executor.js";
-import type { Store } from "./store.js";
+import type { CreateWorkflowRunInput, WorkflowRecoveryContext } from "./store.js";
+import type { GoalRunnerStore } from "./goal/runner.js";
 export interface ExecuteWorkflowOptions extends ExecuteOptions {
     loop?: Loop;
     loopRun?: LoopRun;
@@ -11,6 +12,53 @@ export interface ExecuteWorkflowOptions extends ExecuteOptions {
     /** Per-node goal prompt appended to agent step prompts when a goal executes this workflow. */
     goalNodePrompt?: string;
 }
-export declare function executeWorkflow(store: Store, workflow: WorkflowSpec, opts?: ExecuteWorkflowOptions): Promise<ExecutorResult>;
+type MaybePromise<T> = T | Promise<T>;
+export interface WorkflowExecutionStore extends GoalRunnerStore {
+    /** Hosted runners receive server-derived contract events and must not append client-authored copies. */
+    readonly serverDerivedAgentSessionContracts?: boolean;
+    requireWorkflow(idOrName: string): MaybePromise<WorkflowSpec>;
+    createWorkflowRun(input: CreateWorkflowRunInput): MaybePromise<WorkflowRun>;
+    getWorkflowRun(id: string): MaybePromise<WorkflowRun | undefined>;
+    requireWorkflowRun(id: string): MaybePromise<WorkflowRun>;
+    listWorkflowStepRuns(workflowRunId: string): MaybePromise<WorkflowStepRun[]>;
+    getWorkflowStepRun(workflowRunId: string, stepId: string): MaybePromise<WorkflowStepRun | undefined>;
+    isWorkflowRunTerminal(workflowRunId: string): MaybePromise<boolean>;
+    startWorkflowStepRun(workflowRunId: string, stepId: string, opts?: {
+        daemonLeaseId?: string;
+        now?: Date;
+    }): MaybePromise<WorkflowStepRun>;
+    recoverWorkflowRun(workflowRunId: string, reason?: string, context?: WorkflowRecoveryContext): MaybePromise<{
+        run: WorkflowRun;
+        recoveredSteps: WorkflowStepRun[];
+    }>;
+    finalizeWorkflowStepRun(workflowRunId: string, stepId: string, patch: Pick<WorkflowStepRun, "status" | "finishedAt" | "durationMs" | "stdout" | "stderr"> & Partial<Pick<WorkflowStepRun, "exitCode" | "error">>, opts?: {
+        daemonLeaseId?: string;
+        now?: Date;
+    }): MaybePromise<WorkflowStepRun>;
+    finalizeWorkflowRun(workflowRunId: string, status: WorkflowRunStatus, patch?: Partial<Pick<WorkflowRun, "finishedAt" | "durationMs" | "error">>, opts?: {
+        daemonLeaseId?: string;
+        now?: Date;
+    }): MaybePromise<WorkflowRun>;
+    markWorkflowStepPid(workflowRunId: string, stepId: string, pid: number, opts?: {
+        daemonLeaseId?: string;
+        now?: Date;
+    }): MaybePromise<WorkflowStepRun>;
+    recordWorkflowStepProgress(workflowRunId: string, stepId: string, progress: {
+        stdout?: string;
+        stderr?: string;
+        payload?: Record<string, unknown>;
+    }, opts?: {
+        daemonLeaseId?: string;
+        now?: Date;
+    }): MaybePromise<WorkflowStepRun>;
+    appendWorkflowEvent(workflowRunId: string, eventType: string, stepId?: string, payload?: Record<string, unknown>): MaybePromise<unknown>;
+    listWorkflowEvents?(workflowRunId: string, limit?: number): MaybePromise<StoredWorkflowEvent[]>;
+    skipWorkflowStepRun(workflowRunId: string, stepId: string, reason: string, opts?: {
+        daemonLeaseId?: string;
+        now?: Date;
+    }): MaybePromise<WorkflowStepRun>;
+}
+export declare function executeWorkflow(store: WorkflowExecutionStore, workflow: WorkflowSpec, opts?: ExecuteWorkflowOptions): Promise<ExecutorResult>;
 export declare function preflightWorkflow(workflow: WorkflowSpec, opts?: ExecuteOptions): ReturnType<typeof preflightTarget>[];
-export declare function executeLoopTarget(store: Store, loop: Loop, run: LoopRun, opts?: ExecuteOptions): Promise<ExecutorResult>;
+export declare function executeLoopTarget(store: WorkflowExecutionStore, loop: Loop, run: LoopRun, opts?: ExecuteOptions): Promise<ExecutorResult>;
+export {};