@loopstack/advanced-workflows-examples 0.1.1

package/README.md

@@ -0,0 +1,176 @@
+---
+title: Advanced Workflows Examples
+description: In-depth examples of advanced Loopstack workflow patterns — state, dynamic routing, error retry, sub-workflows (parent, fan-out, sequence, show modes, error handling), batch processing, custom tools, configurable modules, and built-in UI documents.
+---
+
+# @loopstack/advanced-workflows-examples
+
+> Advanced workflow pattern examples for the [Loopstack](https://loopstack.ai) automation framework.
+
+Deep-dive examples for framework patterns authors reach for less often but want available when they need them. Pick the example that matches your problem.
+
+## Install as Source (Recommended)
+
+```bash
+npx giget@latest gh:loopstack-ai/loopstack/registry/examples/advanced-workflows-examples src/advanced-workflows-examples
+```
+
+Register the module:
+
+```typescript
+import { Module } from '@nestjs/common';
+import { LoopstackModule } from '@loopstack/loopstack-module';
+import { AdvancedWorkflowsExamplesModule } from './advanced-workflows-examples/advanced-workflows-examples.module';
+
+@Module({
+  imports: [LoopstackModule.forRoot(), AdvancedWorkflowsExamplesModule],
+})
+export class AppModule {}
+```
+
+## Install as a Dependency
+
+```bash
+npm install @loopstack/advanced-workflows-examples
+```
+
+```typescript
+import { AdvancedWorkflowsExamplesModule } from '@loopstack/advanced-workflows-examples';
+```
+
+## Examples
+
+| Example                               | Studio title                                    | Description                                                                             |
+| ------------------------------------- | ----------------------------------------------- | --------------------------------------------------------------------------------------- |
+| [Workflow State](#workflow-state)     | `Advanced - Workflow State Example`             | Persist typed state across transitions via `assignState()`                              |
+| [Dynamic Routing](#dynamic-routing)   | `Advanced - Dynamic Routing Example`            | Conditional routing with `@Guard` decorators and transition priorities                  |
+| [Error Retry](#error-retry)           | `Advanced - Error Retry Example`                | Auto-retry, manual retry, custom error places, timeouts, hybrid                         |
+| [Sub-Workflow](#sub-workflow)         | `Advanced - Sub-Workflow Example`               | Launch a child workflow via `.run()` and resume on callback                             |
+| [Fan-Out](#fan-out)                   | `Advanced - Fan-Out Example`                    | Parallel sub-workflows with single aggregated callback (`FanOutWorkflow`)               |
+| [Sequence](#sequence)                 | `Advanced - Sequence Example`                   | Sequential sub-workflows with single aggregated callback (`SequenceWorkflow`)           |
+| [Batch Processing](#batch-processing) | `Advanced - Batch Processing Example`           | Chunked processing of a list in fixed-size batches                                      |
+| [Custom Tool](#custom-tool)           | `Advanced - Custom Tool Example`                | Authoring custom tools — stateless + stateful, `@Tool()`, Zod schemas, NestJS injection |
+| [Module Config](#module-config)       | `Advanced - Module Config (Default/German/...)` | `forRoot` / `forFeature` patterns for configurable modules                              |
+| [UI Documents](#ui-documents)         | `Advanced - UI Documents Example`               | Smoke test for built-in document types (Message, Error, Markdown, Plain)                |
+
+---
+
+## Workflow State
+
+Two related workflows demonstrating state management:
+
+- `WorkflowStateWorkflow` — minimal pattern: assign state, read it in the next transition.
+- `WorkflowToolResultsWorkflow` — store tool results in state and reference them later.
+
+### Files
+
+- `workflow-state-example.workflow.ts`
+- `tool-results-example.workflow.ts`
+
+## Dynamic Routing
+
+Demonstrates `@Guard`-based conditional routing — multiple transitions out of one state, evaluated in priority order, the first one whose guard returns true wins.
+
+### Files
+
+- `dynamic-routing-example.workflow.ts`
+
+## Error Retry
+
+Demonstrates every retry/error mode in one workflow:
+
+1. **Auto-retry** with exponential backoff
+2. **Manual retry** via Retry button
+3. **Custom error place** with recovery transition
+4. **Timeout** with manual retry
+5. **Hybrid** (auto-retry + custom error place)
+
+### Files
+
+- `error-retry-example.workflow.ts`
+- `error-retry-example.ui.yaml`
+- `tools/{step1,step2,slow}.tool.ts`
+
+## Sub-Workflow
+
+Five workflow files demonstrating sub-workflow composition:
+
+- `sub-workflow-parent.workflow.ts` — basic parent that launches a child via `.run()`
+- `sub-workflow-sub.workflow.ts` — the child workflow
+- `sub-workflow-failing-sub.workflow.ts` — a child that always fails (used by error-handling)
+- `sub-workflow-error-handling.workflow.ts` — parent handles failed children via `input.hasError` / `input.errorMessage`
+- `sub-workflow-show-modes.workflow.ts` — every `show` mode (`inline`, `link`, `hidden`) in one flow
+
+For parallel and sequential composition see [Fan-Out](../fan-out/README.md) and [Sequence](../sequence/README.md).
+
+## Fan-Out
+
+Launches multiple sub-workflows in parallel via `FanOutWorkflow` from `@loopstack/core`. The parent receives a single callback once all children complete.
+
+### Files
+
+- `fan-out-example.workflow.ts`
+
+## Sequence
+
+Runs multiple sub-workflows one at a time via `SequenceWorkflow` from `@loopstack/core`. The parent receives a single aggregated callback after the last child completes.
+
+### Files
+
+- `sequence-example.workflow.ts`
+
+## Batch Processing
+
+Processes a list of items in fixed-size batches. Items within a batch run concurrently (`Promise.all`), batches run sequentially via a state-machine loop. Distinct from `FanOutWorkflow` which runs all sub-workflows simultaneously.
+
+Useful for rate-limited APIs, memory-bounded processing, or quota-constrained operations.
+
+### Files
+
+- `batch-processing-example.workflow.ts`
+
+## Custom Tool
+
+Demonstrates authoring custom tools by extending `BaseTool`:
+
+- `MathSumTool` — stateless, computes `a + b`
+- `CounterTool` — stateful, persists across checkpoints
+- `MathService` — supporting NestJS service injected into a tool
+
+### Files
+
+- `custom-tool-example.workflow.ts`
+- `custom-tool-example.ui.yaml`
+- `tools/math-sum.tool.ts` (stateless)
+- `tools/counter.tool.ts` (stateful)
+- `services/math.service.ts`
+
+## Module Config
+
+Four scenarios for configurable modules:
+
+1. **Default Greeting** — no `forFeature` override; uses `forRoot` global defaults
+2. **German Greeting** — `forFeature` override per module
+3. **French Greeting** — independent `forFeature`, proves per-module isolation
+4. **Nested Greeting** — config passed through a wrapper module (`GreeterAgentModule.forFeature`)
+
+Each consumer module registers its own `@Workflow` so all four show up in the sidebar.
+
+### Files
+
+- `greeter/` — configurable module (`forRoot`, `forFeature`, constants, tool)
+- `consumers/` — four module + workflow pairs, one per scenario
+
+## UI Documents
+
+A small workflow that saves one of each built-in document type so you can verify Studio renders them correctly.
+
+### Files
+
+- `ui-documents-example.workflow.ts`
+
+## About
+
+Author: [Jakob Klippel](https://www.linkedin.com/in/jakob-klippel/)
+
+License: MIT

package/dist/advanced-workflows-examples.module.d.ts

@@ -0,0 +1,3 @@
+export declare class AdvancedWorkflowsExamplesModule {
+}
+//# sourceMappingURL=advanced-workflows-examples.module.d.ts.map

package/dist/advanced-workflows-examples.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"advanced-workflows-examples.module.d.ts","sourceRoot":"","sources":["../src/advanced-workflows-examples.module.ts"],"names":[],"mappings":"AAmDA,qBA+Ba,+BAA+B;CAAG"}

package/dist/advanced-workflows-examples.module.js

@@ -0,0 +1,95 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AdvancedWorkflowsExamplesModule = void 0;
+const common_1 = require("@nestjs/common");
+const claude_module_1 = require("@loopstack/claude-module");
+const common_2 = require("@loopstack/common");
+const agent_error_handling_failing_sub_workflow_1 = require("./workflows/agent-error-handling/agent-error-handling-failing-sub.workflow");
+const agent_error_handling_workflow_1 = require("./workflows/agent-error-handling/agent-error-handling.workflow");
+const failing_sub_workflow_tool_1 = require("./workflows/agent-error-handling/tools/failing-sub-workflow.tool");
+const runtime_error_tool_1 = require("./workflows/agent-error-handling/tools/runtime-error.tool");
+const strict_schema_tool_1 = require("./workflows/agent-error-handling/tools/strict-schema.tool");
+const batch_processing_example_workflow_1 = require("./workflows/batch-processing/batch-processing-example.workflow");
+const custom_tool_example_workflow_1 = require("./workflows/custom-tool/custom-tool-example.workflow");
+const math_service_1 = require("./workflows/custom-tool/services/math.service");
+const counter_tool_1 = require("./workflows/custom-tool/tools/counter.tool");
+const math_sum_tool_1 = require("./workflows/custom-tool/tools/math-sum.tool");
+const dynamic_routing_example_workflow_1 = require("./workflows/dynamic-routing/dynamic-routing-example.workflow");
+const error_retry_example_workflow_1 = require("./workflows/error-retry/error-retry-example.workflow");
+const failing_child_workflow_1 = require("./workflows/error-retry/failing-child.workflow");
+const slow_tool_1 = require("./workflows/error-retry/tools/slow.tool");
+const step1_tool_1 = require("./workflows/error-retry/tools/step1.tool");
+const step2_tool_1 = require("./workflows/error-retry/tools/step2.tool");
+const fan_out_example_workflow_1 = require("./workflows/fan-out/fan-out-example.workflow");
+const default_greeting_module_1 = require("./workflows/module-config/consumers/default-greeting.module");
+const french_greeting_module_1 = require("./workflows/module-config/consumers/french-greeting.module");
+const german_greeting_module_1 = require("./workflows/module-config/consumers/german-greeting.module");
+const nested_greeting_module_1 = require("./workflows/module-config/consumers/nested-greeting.module");
+const greeter_module_1 = require("./workflows/module-config/greeter/greeter.module");
+const sequence_example_workflow_1 = require("./workflows/sequence/sequence-example.workflow");
+const sub_workflow_error_handling_workflow_1 = require("./workflows/sub-workflow/sub-workflow-error-handling.workflow");
+const sub_workflow_failing_sub_workflow_1 = require("./workflows/sub-workflow/sub-workflow-failing-sub.workflow");
+const sub_workflow_parent_workflow_1 = require("./workflows/sub-workflow/sub-workflow-parent.workflow");
+const sub_workflow_show_modes_workflow_1 = require("./workflows/sub-workflow/sub-workflow-show-modes.workflow");
+const sub_workflow_sub_workflow_1 = require("./workflows/sub-workflow/sub-workflow-sub.workflow");
+const ui_documents_example_workflow_1 = require("./workflows/ui-documents/ui-documents-example.workflow");
+const tool_results_example_workflow_1 = require("./workflows/workflow-state/tool-results-example.workflow");
+const workflow_state_example_workflow_1 = require("./workflows/workflow-state/workflow-state-example.workflow");
+const WORKFLOWS = [
+    workflow_state_example_workflow_1.WorkflowStateWorkflow,
+    tool_results_example_workflow_1.WorkflowToolResultsWorkflow,
+    dynamic_routing_example_workflow_1.DynamicRoutingExampleWorkflow,
+    error_retry_example_workflow_1.ErrorRetryWorkflow,
+    sub_workflow_parent_workflow_1.RunSubWorkflowExampleParentWorkflow,
+    sub_workflow_error_handling_workflow_1.RunSubWorkflowExampleErrorHandlingWorkflow,
+    sub_workflow_show_modes_workflow_1.RunSubWorkflowExampleShowModesWorkflow,
+    fan_out_example_workflow_1.RunSubWorkflowExampleFanOutWorkflow,
+    sequence_example_workflow_1.RunSubWorkflowExampleSequenceWorkflow,
+    batch_processing_example_workflow_1.BatchProcessingExampleWorkflow,
+    custom_tool_example_workflow_1.CustomToolExampleWorkflow,
+    ui_documents_example_workflow_1.TestUiDocumentsWorkflow,
+    agent_error_handling_workflow_1.AgentErrorHandlingWorkflow,
+];
+let AdvancedWorkflowsExamplesModule = class AdvancedWorkflowsExamplesModule {
+};
+exports.AdvancedWorkflowsExamplesModule = AdvancedWorkflowsExamplesModule;
+exports.AdvancedWorkflowsExamplesModule = AdvancedWorkflowsExamplesModule = __decorate([
+    (0, common_2.StudioApp)({
+        title: 'Advanced Workflows Examples',
+        workflows: WORKFLOWS,
+    }),
+    (0, common_1.Module)({
+        imports: [
+            claude_module_1.ClaudeModule,
+            greeter_module_1.GreeterModule.forRoot({ language: 'en', greeting: 'Hello' }),
+            default_greeting_module_1.DefaultGreetingModule,
+            german_greeting_module_1.GermanGreetingModule,
+            french_greeting_module_1.FrenchGreetingModule,
+            nested_greeting_module_1.NestedGreetingModule,
+        ],
+        providers: [
+            math_service_1.MathService,
+            math_sum_tool_1.MathSumTool,
+            counter_tool_1.CounterTool,
+            step1_tool_1.Step1Tool,
+            step2_tool_1.Step2Tool,
+            slow_tool_1.SlowTool,
+            strict_schema_tool_1.StrictSchemaTool,
+            runtime_error_tool_1.RuntimeErrorTool,
+            failing_sub_workflow_tool_1.FailingSubWorkflowTool,
+            failing_child_workflow_1.ErrorRetryFailingChildWorkflow,
+            sub_workflow_sub_workflow_1.RunSubWorkflowExampleSubWorkflow,
+            sub_workflow_failing_sub_workflow_1.RunSubWorkflowExampleFailingSubWorkflow,
+            agent_error_handling_failing_sub_workflow_1.AgentErrorHandlingFailingSubWorkflow,
+            ...WORKFLOWS,
+        ],
+        exports: WORKFLOWS,
+    })
+], AdvancedWorkflowsExamplesModule);
+//# sourceMappingURL=advanced-workflows-examples.module.js.map

package/dist/advanced-workflows-examples.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"advanced-workflows-examples.module.js","sourceRoot":"","sources":["../src/advanced-workflows-examples.module.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAAwC;AACxC,4DAAwD;AACxD,8CAA8C;AAC9C,0IAAkI;AAClI,kHAA4G;AAC5G,gHAA0G;AAC1G,kGAA6F;AAC7F,kGAA6F;AAC7F,sHAAgH;AAChH,uGAAiG;AACjG,gFAA4E;AAC5E,6EAAyE;AACzE,+EAA0E;AAC1E,mHAA6G;AAC7G,uGAA0F;AAC1F,2FAAgG;AAChG,uEAAmE;AACnE,yEAAqE;AACrE,yEAAqE;AACrE,2FAAmG;AACnG,yGAAoG;AACpG,uGAAkG;AAClG,uGAAkG;AAClG,uGAAkG;AAClG,qFAAiF;AACjF,8FAAuG;AACvG,wHAA2H;AAC3H,kHAAqH;AACrH,wGAA4G;AAC5G,gHAAmH;AACnH,kGAAsG;AACtG,0GAAiG;AACjG,4GAAuG;AACvG,gHAAmG;AAEnG,MAAM,SAAS,GAAG;IAChB,uDAAqB;IACrB,2DAA2B;IAC3B,gEAA6B;IAC7B,iDAAkB;IAClB,kEAAmC;IACnC,iFAA0C;IAC1C,yEAAsC;IACtC,8DAAmC;IACnC,iEAAqC;IACrC,kEAA8B;IAC9B,wDAAyB;IACzB,uDAAuB;IACvB,0DAA0B;CAC3B,CAAC;AAiCK,IAAM,+BAA+B,GAArC,MAAM,+BAA+B;CAAG,CAAA;AAAlC,0EAA+B;0CAA/B,+BAA+B;IA/B3C,IAAA,kBAAS,EAAC;QACT,KAAK,EAAE,6BAA6B;QACpC,SAAS,EAAE,SAAS;KACrB,CAAC;IACD,IAAA,eAAM,EAAC;QACN,OAAO,EAAE;YACP,4BAAY;YACZ,8BAAa,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;YAC5D,+CAAqB;YACrB,6CAAoB;YACpB,6CAAoB;YACpB,6CAAoB;SACrB;QACD,SAAS,EAAE;YACT,0BAAW;YACX,2BAAW;YACX,0BAAW;YACX,sBAAS;YACT,sBAAS;YACT,oBAAQ;YACR,qCAAgB;YAChB,qCAAgB;YAChB,kDAAsB;YACtB,uDAA8B;YAC9B,4DAAgC;YAChC,2EAAuC;YACvC,gFAAoC;YACpC,GAAG,SAAS;SACb;QACD,OAAO,EAAE,SAAS;KACnB,CAAC;GACW,+BAA+B,CAAG"}

package/dist/index.d.ts

@@ -0,0 +1,18 @@
+export * from './advanced-workflows-examples.module';
+export * from './workflows/workflow-state/workflow-state-example.workflow';
+export * from './workflows/workflow-state/tool-results-example.workflow';
+export * from './workflows/dynamic-routing/dynamic-routing-example.workflow';
+export * from './workflows/error-retry/error-retry-example.workflow';
+export * from './workflows/sub-workflow/sub-workflow-parent.workflow';
+export * from './workflows/sub-workflow/sub-workflow-sub.workflow';
+export * from './workflows/sub-workflow/sub-workflow-failing-sub.workflow';
+export * from './workflows/sub-workflow/sub-workflow-error-handling.workflow';
+export * from './workflows/sub-workflow/sub-workflow-show-modes.workflow';
+export * from './workflows/fan-out/fan-out-example.workflow';
+export * from './workflows/sequence/sequence-example.workflow';
+export * from './workflows/batch-processing/batch-processing-example.workflow';
+export * from './workflows/custom-tool/custom-tool-example.workflow';
+export * from './workflows/ui-documents/ui-documents-example.workflow';
+export * from './workflows/agent-error-handling/agent-error-handling.workflow';
+export * from './workflows/agent-error-handling/agent-error-handling-failing-sub.workflow';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,sCAAsC,CAAC;AACrD,cAAc,4DAA4D,CAAC;AAC3E,cAAc,0DAA0D,CAAC;AACzE,cAAc,8DAA8D,CAAC;AAC7E,cAAc,sDAAsD,CAAC;AACrE,cAAc,uDAAuD,CAAC;AACtE,cAAc,oDAAoD,CAAC;AACnE,cAAc,4DAA4D,CAAC;AAC3E,cAAc,+DAA+D,CAAC;AAC9E,cAAc,2DAA2D,CAAC;AAC1E,cAAc,8CAA8C,CAAC;AAC7D,cAAc,gDAAgD,CAAC;AAC/D,cAAc,gEAAgE,CAAC;AAC/E,cAAc,sDAAsD,CAAC;AACrE,cAAc,wDAAwD,CAAC;AACvE,cAAc,gEAAgE,CAAC;AAC/E,cAAc,4EAA4E,CAAC"}

package/dist/index.js

@@ -0,0 +1,34 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./advanced-workflows-examples.module"), exports);
+__exportStar(require("./workflows/workflow-state/workflow-state-example.workflow"), exports);
+__exportStar(require("./workflows/workflow-state/tool-results-example.workflow"), exports);
+__exportStar(require("./workflows/dynamic-routing/dynamic-routing-example.workflow"), exports);
+__exportStar(require("./workflows/error-retry/error-retry-example.workflow"), exports);
+__exportStar(require("./workflows/sub-workflow/sub-workflow-parent.workflow"), exports);
+__exportStar(require("./workflows/sub-workflow/sub-workflow-sub.workflow"), exports);
+__exportStar(require("./workflows/sub-workflow/sub-workflow-failing-sub.workflow"), exports);
+__exportStar(require("./workflows/sub-workflow/sub-workflow-error-handling.workflow"), exports);
+__exportStar(require("./workflows/sub-workflow/sub-workflow-show-modes.workflow"), exports);
+__exportStar(require("./workflows/fan-out/fan-out-example.workflow"), exports);
+__exportStar(require("./workflows/sequence/sequence-example.workflow"), exports);
+__exportStar(require("./workflows/batch-processing/batch-processing-example.workflow"), exports);
+__exportStar(require("./workflows/custom-tool/custom-tool-example.workflow"), exports);
+__exportStar(require("./workflows/ui-documents/ui-documents-example.workflow"), exports);
+__exportStar(require("./workflows/agent-error-handling/agent-error-handling.workflow"), exports);
+__exportStar(require("./workflows/agent-error-handling/agent-error-handling-failing-sub.workflow"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,uEAAqD;AACrD,6FAA2E;AAC3E,2FAAyE;AACzE,+FAA6E;AAC7E,uFAAqE;AACrE,wFAAsE;AACtE,qFAAmE;AACnE,6FAA2E;AAC3E,gGAA8E;AAC9E,4FAA0E;AAC1E,+EAA6D;AAC7D,iFAA+D;AAC/D,iGAA+E;AAC/E,uFAAqE;AACrE,yFAAuE;AACvE,iGAA+E;AAC/E,6GAA2F"}

package/dist/workflows/agent-error-handling/agent-error-handling-failing-sub.workflow.d.ts

@@ -0,0 +1,5 @@
+import { BaseWorkflow } from '@loopstack/common';
+export declare class AgentErrorHandlingFailingSubWorkflow extends BaseWorkflow {
+    start(_state: Record<string, unknown>): Promise<never>;
+}
+//# sourceMappingURL=agent-error-handling-failing-sub.workflow.d.ts.map

package/dist/workflows/agent-error-handling/agent-error-handling-failing-sub.workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-error-handling-failing-sub.workflow.d.ts","sourceRoot":"","sources":["../../../src/workflows/agent-error-handling/agent-error-handling-failing-sub.workflow.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAwB,MAAM,mBAAmB,CAAC;AAMvE,qBACa,oCAAqC,SAAQ,YAAY;IAEpE,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAGtC"}

package/dist/workflows/agent-error-handling/agent-error-handling-failing-sub.workflow.js

@@ -0,0 +1,29 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentErrorHandlingFailingSubWorkflow = void 0;
+const common_1 = require("@loopstack/common");
+let AgentErrorHandlingFailingSubWorkflow = class AgentErrorHandlingFailingSubWorkflow extends common_1.BaseWorkflow {
+    start(_state) {
+        return Promise.reject(new Error('Simulated sub-workflow failure.'));
+    }
+};
+exports.AgentErrorHandlingFailingSubWorkflow = AgentErrorHandlingFailingSubWorkflow;
+__decorate([
+    (0, common_1.Transition)({ to: 'done' }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", void 0)
+], AgentErrorHandlingFailingSubWorkflow.prototype, "start", null);
+exports.AgentErrorHandlingFailingSubWorkflow = AgentErrorHandlingFailingSubWorkflow = __decorate([
+    (0, common_1.Workflow)({ title: 'Agent Error Handling - Failing Sub-Workflow' })
+], AgentErrorHandlingFailingSubWorkflow);
+//# sourceMappingURL=agent-error-handling-failing-sub.workflow.js.map

package/dist/workflows/agent-error-handling/agent-error-handling-failing-sub.workflow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-error-handling-failing-sub.workflow.js","sourceRoot":"","sources":["../../../src/workflows/agent-error-handling/agent-error-handling-failing-sub.workflow.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,8CAAuE;AAOhE,IAAM,oCAAoC,GAA1C,MAAM,oCAAqC,SAAQ,qBAAY;IAEpE,KAAK,CAAC,MAA+B;QACnC,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC,CAAC;IACtE,CAAC;CACF,CAAA;AALY,oFAAoC;AAE/C;IADC,IAAA,mBAAU,EAAC,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC;;;;iEAG1B;+CAJU,oCAAoC;IADhD,IAAA,iBAAQ,EAAC,EAAE,KAAK,EAAE,6CAA6C,EAAE,CAAC;GACtD,oCAAoC,CAKhD"}

package/dist/workflows/agent-error-handling/agent-error-handling.ui.yaml

@@ -0,0 +1,6 @@
+widget: button
+showWhen:
+  - awaiting_tools
+options:
+  transition: cancelPendingTools
+  label: Cancel pending tools

package/dist/workflows/agent-error-handling/agent-error-handling.workflow.d.ts

@@ -0,0 +1,34 @@
+import { BaseWorkflow } from '@loopstack/common';
+import type { RunContext, TransitionInput, WorkflowOrchestrator } from '@loopstack/common';
+import type { LlmDelegateResult, LlmGenerateTextResult } from '@loopstack/llm-provider-module';
+import { LlmDelegateToolCallsTool, LlmGenerateTextTool, LlmUpdateToolResultTool } from '@loopstack/llm-provider-module';
+import { FailingSubWorkflowTool } from './tools/failing-sub-workflow.tool';
+import { RuntimeErrorTool } from './tools/runtime-error.tool';
+import { StrictSchemaTool } from './tools/strict-schema.tool';
+interface AgentErrorHandlingState {
+    llmResult?: LlmGenerateTextResult;
+    delegateResult?: LlmDelegateResult;
+    turnCount: number;
+}
+export declare class AgentErrorHandlingWorkflow extends BaseWorkflow {
+    private readonly llmGenerateText;
+    private readonly llmDelegateToolCalls;
+    private readonly llmUpdateToolResult;
+    private readonly strictSchema;
+    private readonly runtimeError;
+    private readonly failingSubWorkflow;
+    private readonly orchestrator;
+    constructor(llmGenerateText: LlmGenerateTextTool, llmDelegateToolCalls: LlmDelegateToolCallsTool, llmUpdateToolResult: LlmUpdateToolResultTool, strictSchema: StrictSchemaTool, runtimeError: RuntimeErrorTool, failingSubWorkflow: FailingSubWorkflowTool, orchestrator: WorkflowOrchestrator);
+    setup(_state: AgentErrorHandlingState): Promise<void>;
+    llmTurn(state: AgentErrorHandlingState): Promise<void>;
+    executeToolCalls(state: AgentErrorHandlingState): Promise<void>;
+    toolResultReceived(state: AgentErrorHandlingState, input: TransitionInput): Promise<void>;
+    toolsComplete(_state: AgentErrorHandlingState): void;
+    cancelPendingTools(state: AgentErrorHandlingState, ctx: RunContext): Promise<void>;
+    respond(_state: AgentErrorHandlingState): void;
+    private hasToolCalls;
+    private allToolsComplete;
+    private isEndTurn;
+}
+export {};
+//# sourceMappingURL=agent-error-handling.workflow.d.ts.map

package/dist/workflows/agent-error-handling/agent-error-handling.workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-error-handling.workflow.d.ts","sourceRoot":"","sources":["../../../src/workflows/agent-error-handling/agent-error-handling.workflow.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAuE,MAAM,mBAAmB,CAAC;AACtH,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC3F,OAAO,KAAK,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AAC/F,OAAO,EACL,wBAAwB,EACxB,mBAAmB,EAEnB,uBAAuB,EACxB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAC3E,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAE9D,UAAU,uBAAuB;IAC/B,SAAS,CAAC,EAAE,qBAAqB,CAAC;IAClC,cAAc,CAAC,EAAE,iBAAiB,CAAC;IACnC,SAAS,EAAE,MAAM,CAAC;CACnB;AAUD,qBAMa,0BAA2B,SAAQ,YAAY;IAExD,OAAO,CAAC,QAAQ,CAAC,eAAe;IAChC,OAAO,CAAC,QAAQ,CAAC,oBAAoB;IACrC,OAAO,CAAC,QAAQ,CAAC,mBAAmB;IACpC,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,kBAAkB;IACJ,OAAO,CAAC,QAAQ,CAAC,YAAY;gBAN3C,eAAe,EAAE,mBAAmB,EACpC,oBAAoB,EAAE,wBAAwB,EAC9C,mBAAmB,EAAE,uBAAuB,EAC5C,YAAY,EAAE,gBAAgB,EAC9B,YAAY,EAAE,gBAAgB,EAC9B,kBAAkB,EAAE,sBAAsB,EACX,YAAY,EAAE,oBAAoB;IAM9E,KAAK,CAAC,MAAM,EAAE,uBAAuB;IAmBrC,OAAO,CAAC,KAAK,EAAE,uBAAuB;IAoBtC,gBAAgB,CAAC,KAAK,EAAE,uBAAuB;IAS/C,kBAAkB,CAAC,KAAK,EAAE,uBAAuB,EAAE,KAAK,EAAE,eAAe;IAU/E,aAAa,CAAC,MAAM,EAAE,uBAAuB;IAGvC,kBAAkB,CAAC,KAAK,EAAE,uBAAuB,EAAE,GAAG,EAAE,UAAU;IAMxE,OAAO,CAAC,MAAM,EAAE,uBAAuB;IAEvC,OAAO,CAAC,YAAY;IAIpB,OAAO,CAAC,gBAAgB;IAIxB,OAAO,CAAC,SAAS;CAGlB"}

package/dist/workflows/agent-error-handling/agent-error-handling.workflow.js

@@ -0,0 +1,158 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentErrorHandlingWorkflow = void 0;
+const common_1 = require("@nestjs/common");
+const node_path_1 = require("node:path");
+const common_2 = require("@loopstack/common");
+const llm_provider_module_1 = require("@loopstack/llm-provider-module");
+const failing_sub_workflow_tool_1 = require("./tools/failing-sub-workflow.tool");
+const runtime_error_tool_1 = require("./tools/runtime-error.tool");
+const strict_schema_tool_1 = require("./tools/strict-schema.tool");
+let AgentErrorHandlingWorkflow = class AgentErrorHandlingWorkflow extends common_2.BaseWorkflow {
+    llmGenerateText;
+    llmDelegateToolCalls;
+    llmUpdateToolResult;
+    strictSchema;
+    runtimeError;
+    failingSubWorkflow;
+    orchestrator;
+    constructor(llmGenerateText, llmDelegateToolCalls, llmUpdateToolResult, strictSchema, runtimeError, failingSubWorkflow, orchestrator) {
+        super();
+        this.llmGenerateText = llmGenerateText;
+        this.llmDelegateToolCalls = llmDelegateToolCalls;
+        this.llmUpdateToolResult = llmUpdateToolResult;
+        this.strictSchema = strictSchema;
+        this.runtimeError = runtimeError;
+        this.failingSubWorkflow = failingSubWorkflow;
+        this.orchestrator = orchestrator;
+    }
+    async setup(_state) {
+        await this.documentStore.save(common_2.MessageDocument, {
+            role: 'assistant',
+            text: '# Agent Error Handling Example\n\n' +
+                'This workflow tests how tool errors are handled and fed back to the LLM.\n\n' +
+                'The LLM will deliberately trigger errors, then self-correct.',
+        });
+        await this.documentStore.save(llm_provider_module_1.LlmMessageDocument, {
+            role: 'user',
+            text: 'Follow the instructions in your system prompt exactly. ' +
+                'Start with step 1: call strictSchema with no arguments.',
+        });
+        this.assignState({ turnCount: 0 });
+    }
+    async llmTurn(state) {
+        const result = await this.llmGenerateText.call({}, {
+            config: {
+                provider: 'claude',
+                model: 'claude-sonnet-4-6',
+                system: this.render((0, node_path_1.join)(__dirname, 'templates', 'system.md')),
+                tools: ['strict_schema', 'runtime_error', 'failing_sub_workflow'],
+            },
+        });
+        this.assignState({
+            turnCount: state.turnCount + 1,
+            llmResult: result.data,
+        });
+    }
+    async executeToolCalls(state) {
+        const result = await this.llmDelegateToolCalls.call({
+            message: state.llmResult.message,
+            callback: { transition: 'toolResultReceived' },
+        });
+        this.assignState({ delegateResult: result.data });
+    }
+    async toolResultReceived(state, input) {
+        const result = await this.llmUpdateToolResult.call({
+            delegateResult: state.delegateResult,
+            completedTool: input,
+        });
+        this.assignState({ delegateResult: result.data });
+    }
+    toolsComplete(_state) { }
+    async cancelPendingTools(state, ctx) {
+        await this.orchestrator.cancelChildren(ctx.workflowId);
+    }
+    respond(_state) { }
+    hasToolCalls(state) {
+        return state.llmResult?.message.stopReason === 'tool_use';
+    }
+    allToolsComplete(state) {
+        return !!state.delegateResult?.allCompleted;
+    }
+    isEndTurn(state) {
+        return state.llmResult?.message.stopReason === 'end_turn';
+    }
+};
+exports.AgentErrorHandlingWorkflow = AgentErrorHandlingWorkflow;
+__decorate([
+    (0, common_2.Transition)({ to: 'ready' }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], AgentErrorHandlingWorkflow.prototype, "setup", null);
+__decorate([
+    (0, common_2.Transition)({ from: 'ready', to: 'prompt_executed' }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], AgentErrorHandlingWorkflow.prototype, "llmTurn", null);
+__decorate([
+    (0, common_2.Transition)({ from: 'prompt_executed', to: 'awaiting_tools', priority: 10 }),
+    (0, common_2.Guard)('hasToolCalls'),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], AgentErrorHandlingWorkflow.prototype, "executeToolCalls", null);
+__decorate([
+    (0, common_2.Transition)({ from: 'awaiting_tools', to: 'awaiting_tools', wait: true }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, Object]),
+    __metadata("design:returntype", Promise)
+], AgentErrorHandlingWorkflow.prototype, "toolResultReceived", null);
+__decorate([
+    (0, common_2.Transition)({ from: 'awaiting_tools', to: 'ready' }),
+    (0, common_2.Guard)('allToolsComplete'),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", void 0)
+], AgentErrorHandlingWorkflow.prototype, "toolsComplete", null);
+__decorate([
+    (0, common_2.Transition)({ from: 'awaiting_tools', to: 'ready', wait: true }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, Object]),
+    __metadata("design:returntype", Promise)
+], AgentErrorHandlingWorkflow.prototype, "cancelPendingTools", null);
+__decorate([
+    (0, common_2.Transition)({ from: 'prompt_executed', to: 'end' }),
+    (0, common_2.Guard)('isEndTurn'),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", void 0)
+], AgentErrorHandlingWorkflow.prototype, "respond", null);
+exports.AgentErrorHandlingWorkflow = AgentErrorHandlingWorkflow = __decorate([
+    (0, common_2.Workflow)({
+        title: 'Advanced Workflows - Agent Error Handling Example',
+        description: 'Exercises every tool-error path in an agent loop — schema validation failures, runtime exceptions, failed sub-workflows — and verifies the LLM receives identical is_error tool_results and can self-correct.',
+        widget: './agent-error-handling.ui.yaml',
+    }),
+    __param(6, (0, common_1.Inject)(common_2.WORKFLOW_ORCHESTRATOR)),
+    __metadata("design:paramtypes", [llm_provider_module_1.LlmGenerateTextTool,
+        llm_provider_module_1.LlmDelegateToolCallsTool,
+        llm_provider_module_1.LlmUpdateToolResultTool,
+        strict_schema_tool_1.StrictSchemaTool,
+        runtime_error_tool_1.RuntimeErrorTool,
+        failing_sub_workflow_tool_1.FailingSubWorkflowTool, Object])
+], AgentErrorHandlingWorkflow);
+//# sourceMappingURL=agent-error-handling.workflow.js.map

package/dist/workflows/agent-error-handling/agent-error-handling.workflow.js.map

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

package/dist/workflows/agent-error-handling/templates/system.md

@@ -0,0 +1,12 @@
+You are a test assistant that follows instructions precisely. You are fully autonomous — do NOT ask the user for input or confirmation. Just proceed through each step on your own.
+
+Complete these steps IN ORDER. Do exactly one step per turn:
+
+1. Call the `strictSchema` tool with NO arguments (empty object {}). This will fail — that is expected.
+2. After seeing the validation error, call `strictSchema` correctly with { "name": "World" }.
+3. Call the `runtimeError` tool with { "shouldFail": true }. This will fail — that is expected.
+4. After seeing the runtime error, call `runtimeError` with { "shouldFail": false }.
+5. Call the `failingSubWorkflow` tool with {}. This launches a sub-workflow that will fail — that is expected.
+6. After seeing the sub-workflow error, respond with a brief summary of what happened (do NOT call any tools).
+
+IMPORTANT: Only perform ONE step per turn. Do NOT skip steps. Do NOT wait for user input between steps.

package/dist/workflows/agent-error-handling/tools/failing-sub-workflow.tool.d.ts

@@ -0,0 +1,12 @@
+import { BaseTool, ToolCallOptions, ToolEnvelope } from '@loopstack/common';
+import type { RunContext } from '@loopstack/common';
+import { AgentErrorHandlingFailingSubWorkflow } from '../agent-error-handling-failing-sub.workflow';
+export type FailingSubWorkflowToolResult = {
+    workflowId: string;
+};
+export declare class FailingSubWorkflowTool extends BaseTool<object, object, FailingSubWorkflowToolResult> {
+    private readonly failingWorkflow;
+    constructor(failingWorkflow: AgentErrorHandlingFailingSubWorkflow);
+    protected handle(_args: object, _ctx: RunContext, options?: ToolCallOptions): Promise<ToolEnvelope<FailingSubWorkflowToolResult>>;
+}
+//# sourceMappingURL=failing-sub-workflow.tool.d.ts.map