@usestratus/sdk 1.7.0 → 1.9.0

package/README.md

@@ -18,12 +18,13 @@ A TypeScript agent SDK purpose-built for Azure OpenAI.
 - **One line to start** — `createModel()` reads your env vars. No config objects, no API version guessing.
 - **One interface, two backends** — Chat Completions and Responses API through the same agent, tool, and session code.
 - **Agents that compose** — handoffs, subagents, guardrails, and hooks in a single run loop. Deny or modify tool calls at runtime.
+- **Workflow orchestration** — fan out bounded parallel agent tasks, stream progress events, resume completed work from snapshots, and synthesize the final answer.
 - **Human-in-the-loop** — permission callbacks, per-tool approval, glob-filtered tools, and graceful mid-run interrupts.
 - **State you own** — save, resume, and fork conversations as JSON. No server-side threads.
 - **Type-safe end to end** — Zod schemas drive parameters, structured output, and validation. Types flow through agents, hooks, and guardrails at compile time.
-- **Zero dep** — only Zod as a peer dep.
+- **Tiny dependency surface** — Zod as a peer dep, with optional Effect integration when you want it.
 
-`agents` `tools` `streaming` `structured output` `handoffs` `subagents` `guardrails` `hooks` `tracing` `sessions` `abort signals` `code mode` `todo tracking` `cost tracking` `human-in-the-loop` `predicted output` `audio` `data sources` `context compaction` `background tasks` `testing utilities` `debug mode`
+`agents` `tools` `streaming` `structured output` `handoffs` `subagents` `workflows` `guardrails` `hooks` `tracing` `sessions` `abort signals` `code mode` `todo tracking` `cost tracking` `human-in-the-loop` `predicted output` `audio` `data sources` `context compaction` `background tasks` `testing utilities` `debug mode`
 
 ## Install
 
@@ -264,6 +265,87 @@ const parentAgent = new Agent({
 });
 ```
 
+### Workflows
+
+Use workflows when the orchestration itself should live in code: audits, migrations, research passes, and verification loops that need many agents without stuffing every intermediate result into one conversation.
+
+```ts
+import { Agent, createModel, runWorkflow, workflow, workflowTask } from "@usestratus/sdk";
+
+const model = createModel();
+
+const reviewer = new Agent({
+  name: "reviewer",
+  instructions: "Review the target carefully and report concrete findings only.",
+  model,
+});
+
+const synthesizer = new Agent({
+  name: "synthesizer",
+  instructions: "Merge independent findings into a concise final report.",
+  model,
+});
+
+const auditWorkflow = workflow({
+  name: "parallel-audit",
+  run: async (ctx, files: string[]) => {
+    const findings = await ctx.phase(
+      "review files",
+      files.map((file) =>
+        workflowTask({
+          id: file,
+          name: `review ${file}`,
+          agent: reviewer,
+          input: `Audit ${file} for correctness, security, and missing tests.`,
+          metadata: { file },
+        }),
+      ),
+      { concurrency: 8, failFast: false },
+    );
+
+    const synthesis = await ctx.synthesize(
+      synthesizer,
+      findings
+        .map((finding) => `## ${finding.name}\n${finding.output || finding.error}`)
+        .join("\n\n"),
+    );
+
+    return synthesis.output;
+  },
+});
+
+const result = await runWorkflow(auditWorkflow, [
+  "src/routes/users.ts",
+  "src/routes/billing.ts",
+]);
+
+console.log(result.output);
+console.log(result.usage.totalTokens);
+```
+
+Workflows support:
+- Bounded parallel phases (`concurrency`, capped by `maxConcurrency`)
+- Progress streaming with `streamWorkflow()`
+- Anthropic-style helpers: `ctx.fanOutAndSynthesize()`, `ctx.adversarialVerify()`, `ctx.generateAndFilter()`, `ctx.tournament()`, and `ctx.loopUntilDone()`
+- Token, cost, and duration guardrails through `budget`
+- Managed runs with `WorkflowRunManager` for event collection, stop, restart, and snapshot resume
+- Generated workflow drafts with `generateWorkflowDraft()` so users can preview the plan and script before running it
+- Saved workflow discovery/loading from `.stratus/workflows`
+- `AbortSignal` cancellation
+- `failFast: false` phases for tolerant audit-style runs
+- `resumeFrom` snapshots that skip completed task IDs
+- Custom function tasks for non-model work alongside agent tasks
+
+```ts
+const result = await runWorkflow(auditWorkflow, files, {
+  concurrency: 8,
+  maxTasks: 1000,
+  budget: { maxTotalTokens: 50_000, maxDurationMs: 10 * 60_000 },
+});
+```
+
+Budget checks run after tasks or synthesis calls complete, so concurrent phases can overshoot a threshold before the workflow stops. Use conservative concurrency for strict spend control.
+
 ### Guardrails
 
 Validate inputs and outputs with guardrails:

package/dist/core/index.d.ts

@@ -39,4 +39,12 @@ export type { AssistantMessage, AudioConfig, AudioFormat, AudioVoice, ChatMessag
 export { zodToJsonSchema } from "./utils/zod";
 export type { ValidationResult } from "./validate-agent";
 export { validateAgent } from "./validate-agent";
+export type { GenerateWorkflowDraftOptions, WorkflowDraft, WorkflowDraftPhase, } from "./workflow-draft";
+export { generateWorkflowDraft } from "./workflow-draft";
+export type { ManagedWorkflowRunStatus, WorkflowRunHandle } from "./workflow-manager";
+export { WorkflowRunManager } from "./workflow-manager";
+export type { DiscoverSavedWorkflowsOptions, LoadedWorkflowModule, SavedWorkflowInfo, SavedWorkflowScope, } from "./workflow-saved";
+export { discoverSavedWorkflows, loadWorkflowModule } from "./workflow-saved";
+export type { StreamedWorkflowResult, Workflow, WorkflowAdversarialVerificationConfig, WorkflowAdversarialVerificationResult, WorkflowAgentTask, WorkflowBudget, WorkflowConfig, WorkflowEvent, WorkflowFanOutAndSynthesizeConfig, WorkflowFanOutAndSynthesizeResult, WorkflowFunctionTask, WorkflowGenerateAndFilterConfig, WorkflowGenerateAndFilterResult, WorkflowLoopStepResult, WorkflowLoopUntilDoneConfig, WorkflowLoopUntilDoneResult, WorkflowOptions, WorkflowPhaseOptions, WorkflowPhaseResult, WorkflowPhaseStatus, WorkflowRunResult, WorkflowRunSnapshot, WorkflowRunStatus, WorkflowRuntimeContext, WorkflowTournamentConfig, WorkflowTournamentResult, WorkflowTask, WorkflowTaskBase, WorkflowTaskExecuteParams, WorkflowTaskResult, WorkflowTaskStatus, } from "./workflow";
+export { runWorkflow, streamWorkflow, workflow, workflowTask } from "./workflow";
 //# sourceMappingURL=index.d.ts.map

package/dist/core/index.d.ts.map

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

package/dist/core/index.js

@@ -19,4 +19,8 @@ export { tool, toolToDefinition } from "./tool";
 export { AzureMonitorTraceExporter, addTraceProcessor, clearTraceProcessors, createAzureMonitorTraceExporter, getCurrentTrace, setTraceProcessors, TraceContext, withTrace, } from "./tracing";
 export { zodToJsonSchema } from "./utils/zod";
 export { validateAgent } from "./validate-agent";
+export { generateWorkflowDraft } from "./workflow-draft";
+export { WorkflowRunManager } from "./workflow-manager";
+export { discoverSavedWorkflows, loadWorkflowModule } from "./workflow-saved";
+export { runWorkflow, streamWorkflow, workflow, workflowTask } from "./workflow";
 //# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAQhC,OAAO,EACN,mBAAmB,EACnB,eAAe,EACf,cAAc,EACd,mBAAmB,EACnB,OAAO,EACP,aAAa,GACb,MAAM,iBAAiB,CAAC;AASzB,OAAO,EACN,kBAAkB,EAClB,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,cAAc,GACd,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAEvC,OAAO,EAAE,mBAAmB,EAAE,MAAM,QAAQ,CAAC;AAE7C,OAAO,EACN,kBAAkB,EAClB,+BAA+B,EAC/B,sBAAsB,EACtB,qBAAqB,EACrB,UAAU,EACV,gCAAgC,EAChC,gBAAgB,EAChB,eAAe,EACf,YAAY,EACZ,gBAAgB,GAChB,MAAM,UAAU,CAAC;AASlB,OAAO,EACN,kBAAkB,EAClB,mBAAmB,EACnB,sBAAsB,EACtB,uBAAuB,GACvB,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAczD,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7D,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAYpD,OAAO,EAAE,oBAAoB,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAe3D,OAAO,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAO/C,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAQvD,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpG,OAAO,EAAE,QAAQ,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5E,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAE5C,OAAO,EAAE,IAAI,EAAE,gBAAgB,EAAE,MAAM,QAAQ,CAAC;AAEhD,OAAO,EACN,yBAAyB,EACzB,iBAAiB,EACjB,oBAAoB,EACpB,+BAA+B,EAC/B,eAAe,EACf,kBAAkB,EAClB,YAAY,EACZ,SAAS,GACT,MAAM,WAAW,CAAC;AAgCnB,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAQhC,OAAO,EACN,mBAAmB,EACnB,eAAe,EACf,cAAc,EACd,mBAAmB,EACnB,OAAO,EACP,aAAa,GACb,MAAM,iBAAiB,CAAC;AASzB,OAAO,EACN,kBAAkB,EAClB,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,cAAc,GACd,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAEvC,OAAO,EAAE,mBAAmB,EAAE,MAAM,QAAQ,CAAC;AAE7C,OAAO,EACN,kBAAkB,EAClB,+BAA+B,EAC/B,sBAAsB,EACtB,qBAAqB,EACrB,UAAU,EACV,gCAAgC,EAChC,gBAAgB,EAChB,eAAe,EACf,YAAY,EACZ,gBAAgB,GAChB,MAAM,UAAU,CAAC;AASlB,OAAO,EACN,kBAAkB,EAClB,mBAAmB,EACnB,sBAAsB,EACtB,uBAAuB,GACvB,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAczD,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7D,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAYpD,OAAO,EAAE,oBAAoB,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAe3D,OAAO,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAO/C,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAQvD,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpG,OAAO,EAAE,QAAQ,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5E,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAE5C,OAAO,EAAE,IAAI,EAAE,gBAAgB,EAAE,MAAM,QAAQ,CAAC;AAEhD,OAAO,EACN,yBAAyB,EACzB,iBAAiB,EACjB,oBAAoB,EACpB,+BAA+B,EAC/B,eAAe,EACf,kBAAkB,EAClB,YAAY,EACZ,SAAS,GACT,MAAM,WAAW,CAAC;AA8BnB,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAMjD,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAEzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAOxD,OAAO,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAkC9E,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}

package/dist/core/workflow-draft.d.ts

@@ -0,0 +1,32 @@
+import type { Agent } from "./agent";
+import type { InterruptedRunResult, RunResult } from "./result";
+import { type RunOptions } from "./run";
+import type { ChatMessage } from "./types";
+export interface WorkflowDraftPhase {
+    name: string;
+    purpose: string;
+    agents?: number;
+    verification?: string;
+}
+export interface WorkflowDraft {
+    name: string;
+    description?: string;
+    phases: WorkflowDraftPhase[];
+    script: string;
+    estimatedTasks?: number;
+    budget?: {
+        maxTotalTokens?: number;
+        maxDurationMs?: number;
+    };
+    warnings: string[];
+    rawOutput: string;
+    runResult: RunResult | InterruptedRunResult;
+}
+export interface GenerateWorkflowDraftOptions<TContext = unknown> extends Omit<RunOptions<TContext>, "context"> {
+    context?: TContext;
+    goal?: string;
+    constraints?: string[];
+    patterns?: string[];
+}
+export declare function generateWorkflowDraft<TContext = unknown>(agent: Agent<TContext>, prompt: string | ChatMessage[], options?: GenerateWorkflowDraftOptions<TContext>): Promise<WorkflowDraft>;
+//# sourceMappingURL=workflow-draft.d.ts.map

package/dist/core/workflow-draft.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-draft.d.ts","sourceRoot":"","sources":["../../src/core/workflow-draft.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,KAAK,EAAE,oBAAoB,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAChE,OAAO,EAAE,KAAK,UAAU,EAAO,MAAM,OAAO,CAAC;AAC7C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C,MAAM,WAAW,kBAAkB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,kBAAkB,EAAE,CAAC;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE;QACR,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,aAAa,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;IACF,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,SAAS,GAAG,oBAAoB,CAAC;CAC5C;AAED,MAAM,WAAW,4BAA4B,CAAC,QAAQ,GAAG,OAAO,CAC/D,SAAQ,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAC;IAC7C,OAAO,CAAC,EAAE,QAAQ,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,wBAAsB,qBAAqB,CAAC,QAAQ,GAAG,OAAO,EAC7D,KAAK,EAAE,KAAK,CAAC,QAAQ,CAAC,EACtB,MAAM,EAAE,MAAM,GAAG,WAAW,EAAE,EAC9B,OAAO,GAAE,4BAA4B,CAAC,QAAQ,CAAM,GAClD,OAAO,CAAC,aAAa,CAAC,CAiBxB"}

package/dist/core/workflow-draft.js

@@ -0,0 +1,84 @@
+import { run } from "./run";
+export async function generateWorkflowDraft(agent, prompt, options = {}) {
+    const result = await run(agent, buildDraftPrompt(prompt, options), {
+        ...options,
+        context: options.context,
+    });
+    const parsed = parseDraft(result.output);
+    return {
+        name: parsed.name,
+        description: parsed.description,
+        phases: parsed.phases,
+        script: parsed.script,
+        estimatedTasks: parsed.estimatedTasks,
+        budget: parsed.budget,
+        warnings: parsed.warnings ?? [],
+        rawOutput: result.output,
+        runResult: result,
+    };
+}
+function buildDraftPrompt(prompt, options) {
+    const body = typeof prompt === "string" ? prompt : JSON.stringify(prompt);
+    const constraints = options.constraints?.map((item) => `- ${item}`).join("\n") ?? "- none";
+    const patterns = options.patterns?.map((item) => `- ${item}`).join("\n") ??
+        "- fan-out-and-synthesize\n- adversarial-verification\n- loop-until-done";
+    return `Create a Stratus dynamic workflow draft for this request.
+
+Return only JSON with this exact shape:
+{
+  "name": "kebab-case-name",
+  "description": "short human summary",
+  "phases": [{"name":"phase name","purpose":"why it exists","agents":3,"verification":"how results are checked"}],
+  "script": "TypeScript workflow code using @usestratus/sdk workflow APIs",
+  "estimatedTasks": 12,
+  "budget": {"maxTotalTokens": 50000, "maxDurationMs": 600000},
+  "warnings": ["token usage can be high"]
+}
+
+Goal:
+${options.goal ?? body}
+
+Requested workflow:
+${body}
+
+Preferred patterns:
+${patterns}
+
+Constraints:
+${constraints}`;
+}
+function parseDraft(output) {
+    const json = extractJsonObject(output);
+    const parsed = JSON.parse(json);
+    return {
+        name: typeof parsed.name === "string" && parsed.name ? parsed.name : "generated-workflow",
+        description: typeof parsed.description === "string" ? parsed.description : undefined,
+        phases: Array.isArray(parsed.phases)
+            ? parsed.phases.map((phase) => ({
+                name: String(phase.name ?? "phase"),
+                purpose: String(phase.purpose ?? ""),
+                agents: typeof phase.agents === "number"
+                    ? phase.agents
+                    : undefined,
+                verification: typeof phase.verification === "string"
+                    ? phase.verification
+                    : undefined,
+            }))
+            : [],
+        script: typeof parsed.script === "string" ? parsed.script : "",
+        estimatedTasks: typeof parsed.estimatedTasks === "number" ? parsed.estimatedTasks : undefined,
+        budget: parsed.budget,
+        warnings: Array.isArray(parsed.warnings) ? parsed.warnings.map(String) : [],
+    };
+}
+function extractJsonObject(output) {
+    const fenced = output.match(/```(?:json)?\s*([\s\S]*?)```/i);
+    if (fenced?.[1])
+        return fenced[1].trim();
+    const start = output.indexOf("{");
+    const end = output.lastIndexOf("}");
+    if (start >= 0 && end > start)
+        return output.slice(start, end + 1);
+    throw new Error("Workflow draft response did not contain a JSON object");
+}
+//# sourceMappingURL=workflow-draft.js.map

package/dist/core/workflow-draft.js.map

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

package/dist/core/workflow-manager.d.ts

@@ -0,0 +1,25 @@
+import type { Workflow, WorkflowEvent, WorkflowOptions, WorkflowRunResult, WorkflowRunSnapshot } from "./workflow";
+export type ManagedWorkflowRunStatus = "running" | "completed" | "failed" | "stopped";
+export interface WorkflowRunHandle<TArgs = unknown, TOutput = string> {
+    readonly id: string;
+    readonly workflow: Workflow<TArgs, TOutput>;
+    readonly args: TArgs;
+    readonly events: WorkflowEvent<TOutput>[];
+    readonly result: Promise<WorkflowRunResult<TOutput>>;
+    readonly status: ManagedWorkflowRunStatus;
+    readonly snapshot: WorkflowRunSnapshot<TOutput>;
+    onEvent(listener: (event: WorkflowEvent<TOutput>) => void): () => void;
+    stop(): void;
+}
+export declare class WorkflowRunManager {
+    private readonly runs;
+    start<TArgs, TOutput = string>(wf: Workflow<TArgs, TOutput>, args: TArgs, options?: WorkflowOptions): WorkflowRunHandle<TArgs, TOutput>;
+    get<TArgs = unknown, TOutput = string>(id: string): WorkflowRunHandle<TArgs, TOutput> | undefined;
+    list(): WorkflowRunHandle[];
+    stop(id: string): boolean;
+    resume<TArgs, TOutput>(run: WorkflowRunHandle<TArgs, TOutput>): WorkflowRunHandle<TArgs, TOutput>;
+    resume<TArgs, TOutput = string>(id: string): WorkflowRunHandle<TArgs, TOutput>;
+    restart<TArgs, TOutput = string>(id: string): WorkflowRunHandle<TArgs, TOutput>;
+    private requireRun;
+}
+//# sourceMappingURL=workflow-manager.d.ts.map

package/dist/core/workflow-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-manager.d.ts","sourceRoot":"","sources":["../../src/core/workflow-manager.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACX,QAAQ,EACR,aAAa,EACb,eAAe,EAEf,iBAAiB,EACjB,mBAAmB,EACnB,MAAM,YAAY,CAAC;AAGpB,MAAM,MAAM,wBAAwB,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEtF,MAAM,WAAW,iBAAiB,CAAC,KAAK,GAAG,OAAO,EAAE,OAAO,GAAG,MAAM;IACnE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAC5C,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,OAAO,CAAC,EAAE,CAAC;IAC1C,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC,CAAC;IACrD,QAAQ,CAAC,MAAM,EAAE,wBAAwB,CAAC;IAC1C,QAAQ,CAAC,QAAQ,EAAE,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAChD,OAAO,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,aAAa,CAAC,OAAO,CAAC,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IACvE,IAAI,IAAI,IAAI,CAAC;CACb;AAQD,qBAAa,kBAAkB;IAC9B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAyD;IAE9E,KAAK,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,EAC5B,EAAE,EAAE,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,EAC5B,IAAI,EAAE,KAAK,EACX,OAAO,GAAE,eAAoB,GAC3B,iBAAiB,CAAC,KAAK,EAAE,OAAO,CAAC;IAoFpC,GAAG,CAAC,KAAK,GAAG,OAAO,EAAE,OAAO,GAAG,MAAM,EACpC,EAAE,EAAE,MAAM,GACR,iBAAiB,CAAC,KAAK,EAAE,OAAO,CAAC,GAAG,SAAS;IAIhD,IAAI,IAAI,iBAAiB,EAAE;IAI3B,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAOzB,MAAM,CAAC,KAAK,EAAE,OAAO,EACpB,GAAG,EAAE,iBAAiB,CAAC,KAAK,EAAE,OAAO,CAAC,GACpC,iBAAiB,CAAC,KAAK,EAAE,OAAO,CAAC;IACpC,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,iBAAiB,CAAC,KAAK,EAAE,OAAO,CAAC;IAW9E,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,iBAAiB,CAAC,KAAK,EAAE,OAAO,CAAC;IAK/E,OAAO,CAAC,UAAU;CAKlB"}

package/dist/core/workflow-manager.js

@@ -0,0 +1,178 @@
+import { RunAbortedError } from "./errors";
+import { streamWorkflow } from "./workflow";
+export class WorkflowRunManager {
+    runs = new Map();
+    start(wf, args, options = {}) {
+        const id = options.id ?? createManagedRunId();
+        const controller = new AbortController();
+        const signal = mergeAbortSignals(controller.signal, options.signal);
+        const listeners = new Set();
+        const events = [];
+        let phases = [];
+        let usage = emptyUsage();
+        let numTurns = 0;
+        let totalCostUsd = 0;
+        const startedAt = new Date();
+        let latestSnapshot;
+        const streamed = streamWorkflow(wf, args, { ...options, id, signal });
+        const handle = {
+            id,
+            workflow: wf,
+            args,
+            events,
+            status: "running",
+            result: streamed.result
+                .then((result) => {
+                handle.status = "completed";
+                latestSnapshot = result;
+                return result;
+            })
+                .catch((error) => {
+                handle.status = error instanceof RunAbortedError ? "stopped" : "failed";
+                throw error;
+            })
+                .finally(() => {
+                this.runs.set(id, handle);
+            }),
+            get snapshot() {
+                if (latestSnapshot)
+                    return latestSnapshot;
+                return buildManagedSnapshot({
+                    id,
+                    name: wf.name,
+                    status: handle.status,
+                    output: "",
+                    phases,
+                    usage,
+                    numTurns,
+                    totalCostUsd,
+                    startedAt,
+                });
+            },
+            onEvent(listener) {
+                listeners.add(listener);
+                return () => listeners.delete(listener);
+            },
+            stop() {
+                controller.abort();
+            },
+            emit(event) {
+                events.push(event);
+                if (event.type === "workflow_phase_completed") {
+                    phases = [...phases, event.phase];
+                    const totals = aggregatePhaseTotals(phases);
+                    usage = totals.usage;
+                    numTurns = totals.numTurns;
+                    totalCostUsd = totals.totalCostUsd;
+                    latestSnapshot = undefined;
+                }
+                if (event.type === "workflow_completed") {
+                    phases = event.result.phases;
+                    usage = event.result.usage;
+                    numTurns = event.result.numTurns;
+                    totalCostUsd = event.result.totalCostUsd;
+                    latestSnapshot = event.result;
+                }
+                for (const listener of listeners)
+                    listener(event);
+            },
+        };
+        this.runs.set(id, handle);
+        void (async () => {
+            for await (const event of streamed.stream) {
+                handle.emit(event);
+            }
+        })();
+        return handle;
+    }
+    get(id) {
+        return this.runs.get(id);
+    }
+    list() {
+        return [...this.runs.values()];
+    }
+    stop(id) {
+        const run = this.runs.get(id);
+        if (!run || run.status !== "running")
+            return false;
+        run.stop();
+        return true;
+    }
+    resume(target) {
+        const run = typeof target === "string" ? this.requireRun(target) : target;
+        return this.start(run.workflow, run.args, {
+            id: createManagedRunId(),
+            resumeFrom: run.snapshot,
+        });
+    }
+    restart(id) {
+        const run = this.requireRun(id);
+        return this.start(run.workflow, run.args, { id: createManagedRunId() });
+    }
+    requireRun(id) {
+        const run = this.runs.get(id);
+        if (!run)
+            throw new Error(`Unknown workflow run: ${id}`);
+        return run;
+    }
+}
+function mergeAbortSignals(primary, secondary) {
+    if (!secondary)
+        return primary;
+    if (secondary.aborted) {
+        const controller = new AbortController();
+        controller.abort();
+        return controller.signal;
+    }
+    const controller = new AbortController();
+    const abort = () => controller.abort();
+    primary.addEventListener("abort", abort, { once: true });
+    secondary.addEventListener("abort", abort, { once: true });
+    return controller.signal;
+}
+function buildManagedSnapshot(params) {
+    const completedAt = new Date();
+    return {
+        id: params.id,
+        name: params.name,
+        status: params.status,
+        output: params.output,
+        phases: params.phases,
+        usage: params.usage,
+        numTurns: params.numTurns,
+        totalCostUsd: params.totalCostUsd,
+        startedAt: params.startedAt.toISOString(),
+        completedAt: completedAt.toISOString(),
+        durationMs: completedAt.getTime() - params.startedAt.getTime(),
+    };
+}
+function aggregatePhaseTotals(phases) {
+    const usage = emptyUsage();
+    let numTurns = 0;
+    let totalCostUsd = 0;
+    for (const phase of phases) {
+        for (const task of phase.tasks) {
+            usage.promptTokens += task.usage.promptTokens;
+            usage.completionTokens += task.usage.completionTokens;
+            usage.totalTokens += task.usage.totalTokens;
+            usage.cacheReadTokens = addOptional(usage.cacheReadTokens, task.usage.cacheReadTokens);
+            usage.cacheCreationTokens = addOptional(usage.cacheCreationTokens, task.usage.cacheCreationTokens);
+            usage.reasoningTokens = addOptional(usage.reasoningTokens, task.usage.reasoningTokens);
+            numTurns += task.numTurns;
+            totalCostUsd += task.totalCostUsd;
+        }
+    }
+    return { usage, numTurns, totalCostUsd };
+}
+function emptyUsage() {
+    return { promptTokens: 0, completionTokens: 0, totalTokens: 0 };
+}
+function addOptional(current, next) {
+    if (next === undefined)
+        return current;
+    return (current ?? 0) + next;
+}
+function createManagedRunId() {
+    return `wf_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 8)}`;
+}
+//# sourceMappingURL=workflow-manager.js.map

package/dist/core/workflow-manager.js.map

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

package/dist/core/workflow-saved.d.ts

@@ -0,0 +1,21 @@
+import type { Workflow } from "./workflow";
+export type SavedWorkflowScope = "project" | "user";
+export interface SavedWorkflowInfo {
+    name: string;
+    path: string;
+    scope: SavedWorkflowScope;
+}
+export interface DiscoverSavedWorkflowsOptions {
+    cwd?: string;
+    includeUser?: boolean;
+    includeProject?: boolean;
+}
+export interface LoadedWorkflowModule<TArgs = unknown, TOutput = string> {
+    workflow?: Workflow<TArgs, TOutput>;
+    workflows: Workflow<TArgs, TOutput>[];
+    module: Record<string, unknown>;
+    path: string;
+}
+export declare function discoverSavedWorkflows(options?: DiscoverSavedWorkflowsOptions): Promise<SavedWorkflowInfo[]>;
+export declare function loadWorkflowModule<TArgs = unknown, TOutput = string>(filePath: string): Promise<LoadedWorkflowModule<TArgs, TOutput>>;
+//# sourceMappingURL=workflow-saved.d.ts.map

package/dist/core/workflow-saved.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-saved.d.ts","sourceRoot":"","sources":["../../src/core/workflow-saved.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,MAAM,CAAC;AAEpD,MAAM,WAAW,iBAAiB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,kBAAkB,CAAC;CAC1B;AAED,MAAM,WAAW,6BAA6B;IAC7C,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,cAAc,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,oBAAoB,CAAC,KAAK,GAAG,OAAO,EAAE,OAAO,GAAG,MAAM;IACtE,QAAQ,CAAC,EAAE,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACpC,SAAS,EAAE,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,CAAC;IACtC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,IAAI,EAAE,MAAM,CAAC;CACb;AAED,wBAAsB,sBAAsB,CAC3C,OAAO,GAAE,6BAAkC,GACzC,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAyB9B;AAED,wBAAsB,kBAAkB,CAAC,KAAK,GAAG,OAAO,EAAE,OAAO,GAAG,MAAM,EACzE,QAAQ,EAAE,MAAM,GACd,OAAO,CAAC,oBAAoB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAU/C"}

package/dist/core/workflow-saved.js

@@ -0,0 +1,79 @@
+import { readdir, stat } from "node:fs/promises";
+import { homedir } from "node:os";
+import { basename, extname, join, resolve } from "node:path";
+import { pathToFileURL } from "node:url";
+export async function discoverSavedWorkflows(options = {}) {
+    const cwd = options.cwd ?? process.cwd();
+    const roots = [];
+    if (options.includeProject !== false) {
+        roots.push({ scope: "project", path: join(cwd, ".stratus", "workflows") });
+    }
+    if (options.includeUser !== false) {
+        roots.push({ scope: "user", path: join(homedir(), ".stratus", "workflows") });
+    }
+    const workflows = [];
+    for (const root of roots) {
+        if (!(await exists(root.path)))
+            continue;
+        for (const entry of await readdir(root.path)) {
+            const filePath = join(root.path, entry);
+            const fileStat = await stat(filePath);
+            if (!fileStat.isFile() || !isWorkflowModule(entry))
+                continue;
+            workflows.push({
+                name: basename(entry, extname(entry)),
+                path: filePath,
+                scope: root.scope,
+            });
+        }
+    }
+    return workflows.sort((left, right) => left.name.localeCompare(right.name));
+}
+export async function loadWorkflowModule(filePath) {
+    const resolved = resolve(filePath);
+    const module = (await import(pathToFileURL(resolved).href));
+    const workflows = collectWorkflows(module);
+    return {
+        workflow: workflows[0],
+        workflows,
+        module,
+        path: resolved,
+    };
+}
+function collectWorkflows(module) {
+    const candidates = [
+        module.default,
+        module.workflow,
+        ...(Array.isArray(module.workflows) ? module.workflows : []),
+        ...Object.values(module),
+    ];
+    const seen = new Set();
+    const workflows = [];
+    for (const candidate of candidates) {
+        if (seen.has(candidate))
+            continue;
+        seen.add(candidate);
+        if (isWorkflow(candidate))
+            workflows.push(candidate);
+    }
+    return workflows;
+}
+function isWorkflow(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        typeof value.name === "string" &&
+        typeof value.run === "function");
+}
+function isWorkflowModule(fileName) {
+    return [".js", ".mjs", ".ts"].includes(extname(fileName));
+}
+async function exists(path) {
+    try {
+        await stat(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=workflow-saved.js.map

package/dist/core/workflow-saved.js.map

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