@loopstack/llm-examples 0.1.1

package/README.md

@@ -0,0 +1,204 @@
+---
+title: LLM Examples
+description: Workflow examples for LLM integration in Loopstack — simple prompts, structured output with Zod schemas, multi-provider comparison, web fetch with summarization
+---
+
+# @loopstack/llm-examples
+
+> LLM workflow examples for the [Loopstack](https://loopstack.ai) automation framework.
+
+A collection of workflow examples that demonstrate how to integrate LLMs into Loopstack workflows. Use these as starting points for prompts, structured output, multi-provider setups, and fetching web content.
+
+## Install as Source (Recommended)
+
+Examples are meant to be read, copied, and adapted. Pull the source straight into your project with [giget](https://github.com/unjs/giget):
+
+```bash
+npx giget@latest gh:loopstack-ai/loopstack/registry/examples/llm-examples src/llm-examples
+```
+
+This copies the full `src/` tree into `src/llm-examples/` so you can read the workflow files, edit prompts, swap providers, and ship them as your own. Drop or keep individual workflows as you like.
+
+After copying, register the module in your app:
+
+```typescript
+import { Module } from '@nestjs/common';
+import { LoopstackModule } from '@loopstack/loopstack-module';
+import { LlmExamplesModule } from './llm-examples/llm-examples.module';
+
+@Module({
+  imports: [LoopstackModule.forRoot(), LlmExamplesModule],
+})
+export class AppModule {}
+```
+
+## Install as a Dependency
+
+If you just want to run the examples as-is without modifying source:
+
+```bash
+npm install @loopstack/llm-examples
+```
+
+```typescript
+import { LlmExamplesModule } from '@loopstack/llm-examples';
+```
+
+## Environment
+
+Set provider API keys for the workflows you want to run:
+
+```bash
+ANTHROPIC_API_KEY=sk-ant-...   # required for Claude examples
+OPENAI_API_KEY=sk-...          # required for the multi-provider example
+```
+
+## Examples
+
+| Example                                 | Studio title                                           | Description                                                            |
+| --------------------------------------- | ------------------------------------------------------ | ---------------------------------------------------------------------- |
+| [Prompt](#prompt)                       | `LLM - Prompt Example (Write a haiku)`                 | Single-shot LLM call with a Handlebars-rendered prompt template        |
+| [Structured Output](#structured-output) | `LLM - Structured Output Example (Hello World Script)` | Generate Zod-validated structured output with a custom document widget |
+| [Multi-Provider](#multi-provider)       | `LLM - Multi-Provider Example`                         | Run the same prompt through Claude and OpenAI side by side             |
+| [Web Fetch](#web-fetch)                 | `LLM - Web Fetch Example`                              | Fetch a URL, convert HTML to Markdown, summarize with Claude           |
+
+---
+
+## Prompt
+
+Single-shot LLM call using a Handlebars-rendered prompt template. Generates a haiku about a user-provided subject.
+
+### What it demonstrates
+
+- Defining workflow input arguments with a Zod schema and default values
+- Using the `prompt` parameter for a simple LLM call
+- Rendering Handlebars templates with `this.render(path, vars)`
+- Automatic assistant message persistence via `LlmGenerateTextTool`
+
+### Key code
+
+```ts
+@Transition({ to: 'end' })
+async prompt(state, ctx: RunContext<PromptExampleArgs>) {
+  await this.llmGenerateText.call(
+    { prompt: this.render(join(__dirname, 'templates', 'prompt.md'), { subject: ctx.args.subject }) },
+    { config: { provider: 'claude', model: 'claude-sonnet-4-6' } },
+  );
+}
+```
+
+`LlmGenerateTextTool` saves the assistant message to the document store automatically — no manual `documentStore.save()` needed. Pass `config: { save: false }` to opt out.
+
+### Files
+
+- `prompt-example.workflow.ts` — workflow class
+- `templates/prompt.md` — Handlebars prompt template
+
+## Structured Output
+
+Generates a Zod-validated object (a `FileDocument` with `filename`, `description`, `code`) using `LlmGenerateObjectTool`. Renders in Studio via a custom widget.
+
+### What it demonstrates
+
+- Defining a `@Document` class with a Zod schema and a YAML widget
+- Calling `LlmGenerateObjectTool` with `outputSchema` for Zod-validated JSON output
+- Persisting the structured result via `this.documentStore.save(FileDocument, result.data.data)`
+- Multi-transition state flow: `start` → `ready` → `prompt_executed` → `end`
+
+### Key code
+
+```ts
+const result = await this.llmGenerateObject.call(
+  {
+    outputSchema: FileDocumentSchema,
+    prompt: this.render(join(__dirname, 'templates', 'prompt.md'), { language: state.language }),
+  },
+  { config: { provider: 'claude', model: 'claude-sonnet-4-6' } },
+);
+
+const llmResult = await this.documentStore.save(FileDocument, result.data.data as FileDocumentType);
+this.assignState({ llmResult });
+```
+
+### Files
+
+- `structured-output-example.workflow.ts` — workflow class
+- `documents/file-document.ts` — `@Document` class + Zod schema
+- `documents/file-document.yaml` — Studio widget definition
+- `templates/prompt.md` — Handlebars prompt template
+
+## Multi-Provider
+
+Sends the same prompt to Claude and OpenAI and renders responses side by side for comparison.
+
+### What it demonstrates
+
+- Using the same tool class (`LlmGenerateTextTool`) for multiple providers
+- Selecting provider and model at call time via `{ config: { provider, model } }`
+- Opting out of auto-save with `config: { save: false }` to control message formatting
+- Custom start-form widget via `widget: './multi-provider.ui.yaml'`
+
+### Key code
+
+```ts
+const result = await this.llmGenerateText.call(
+  { prompt: ctx.args.prompt },
+  {
+    config: {
+      save: false,
+      provider: 'claude',
+      model: 'claude-sonnet-4-6',
+    },
+  },
+);
+
+await this.documentStore.save(LlmMessageDocument, {
+  role: 'assistant',
+  text: `**Claude:** ${result.data.message.text}`,
+});
+```
+
+The `save: false` opt-out lets us prefix each response with the provider name so the comparison is clear in the Studio chat view.
+
+### Files
+
+- `multi-provider-example.workflow.ts` — workflow class
+- `multi-provider.ui.yaml` — Studio start-form widget
+
+## Web Fetch
+
+Fetches a URL, converts HTML to Markdown, and optionally summarizes it against a user-provided prompt using a small Claude model.
+
+### What it demonstrates
+
+- Using `WebFetchTool` from `@loopstack/web-module`
+- HTML → Markdown conversion with size caps and same-origin redirect handling
+- Optional prompt-based summarization built into the tool
+
+### Key code
+
+```ts
+const result = await this.webFetch.call({
+  url: ctx.args.url,
+  prompt: ctx.args.prompt,
+});
+
+this.assignState({ summary: result.data.result });
+```
+
+When `prompt` is omitted, `WebFetchTool` returns the raw Markdown (truncated if very long). When provided, the tool summarizes the content with a small Claude model.
+
+### Files
+
+- `web-fetch-example.workflow.ts` — workflow class
+
+### Related modules
+
+- `@loopstack/web-module` — fetch + Markdown conversion + summarization
+- `@loopstack/claude-tools-module` — Claude server-side web search (alternative when you want the LLM to search rather than fetch a specific URL)
+
+## About
+
+Author: [Jakob Klippel](https://www.linkedin.com/in/jakob-klippel/)
+
+License: MIT

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export * from './llm-examples.module';
+export * from './workflows/prompt/prompt-example.workflow';
+export * from './workflows/structured-output/structured-output-example.workflow';
+export * from './workflows/multi-provider/multi-provider-example.workflow';
+export * from './workflows/web-fetch/web-fetch-example.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,uBAAuB,CAAC;AACtC,cAAc,4CAA4C,CAAC;AAC3D,cAAc,kEAAkE,CAAC;AACjF,cAAc,4DAA4D,CAAC;AAC3E,cAAc,kDAAkD,CAAC"}

package/dist/index.js

@@ -0,0 +1,22 @@
+"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("./llm-examples.module"), exports);
+__exportStar(require("./workflows/prompt/prompt-example.workflow"), exports);
+__exportStar(require("./workflows/structured-output/structured-output-example.workflow"), exports);
+__exportStar(require("./workflows/multi-provider/multi-provider-example.workflow"), exports);
+__exportStar(require("./workflows/web-fetch/web-fetch-example.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,wDAAsC;AACtC,6EAA2D;AAC3D,mGAAiF;AACjF,6FAA2E;AAC3E,mFAAiE"}

package/dist/llm-examples.module.d.ts

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

package/dist/llm-examples.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-examples.module.d.ts","sourceRoot":"","sources":["../src/llm-examples.module.ts"],"names":[],"mappings":"AAYA,qBAyBa,iBAAiB;CAAG"}

package/dist/llm-examples.module.js

@@ -0,0 +1,51 @@
+"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.LlmExamplesModule = void 0;
+const common_1 = require("@nestjs/common");
+const claude_module_1 = require("@loopstack/claude-module");
+const claude_tools_module_1 = require("@loopstack/claude-tools-module");
+const common_2 = require("@loopstack/common");
+const openai_module_1 = require("@loopstack/openai-module");
+const web_module_1 = require("@loopstack/web-module");
+const multi_provider_example_workflow_1 = require("./workflows/multi-provider/multi-provider-example.workflow");
+const prompt_example_workflow_1 = require("./workflows/prompt/prompt-example.workflow");
+const file_document_1 = require("./workflows/structured-output/documents/file-document");
+const structured_output_example_workflow_1 = require("./workflows/structured-output/structured-output-example.workflow");
+const web_fetch_example_workflow_1 = require("./workflows/web-fetch/web-fetch-example.workflow");
+let LlmExamplesModule = class LlmExamplesModule {
+};
+exports.LlmExamplesModule = LlmExamplesModule;
+exports.LlmExamplesModule = LlmExamplesModule = __decorate([
+    (0, common_2.StudioApp)({
+        title: 'LLM Examples',
+        workflows: [
+            prompt_example_workflow_1.PromptExampleWorkflow,
+            structured_output_example_workflow_1.StructuredOutputExampleWorkflow,
+            multi_provider_example_workflow_1.MultiProviderExampleWorkflow,
+            web_fetch_example_workflow_1.WebFetchExampleWorkflow,
+        ],
+    }),
+    (0, common_1.Module)({
+        imports: [claude_module_1.ClaudeModule, claude_tools_module_1.ClaudeToolsModule, openai_module_1.OpenAiModule, web_module_1.WebModule],
+        providers: [
+            file_document_1.FileDocument,
+            prompt_example_workflow_1.PromptExampleWorkflow,
+            structured_output_example_workflow_1.StructuredOutputExampleWorkflow,
+            multi_provider_example_workflow_1.MultiProviderExampleWorkflow,
+            web_fetch_example_workflow_1.WebFetchExampleWorkflow,
+        ],
+        exports: [
+            prompt_example_workflow_1.PromptExampleWorkflow,
+            structured_output_example_workflow_1.StructuredOutputExampleWorkflow,
+            multi_provider_example_workflow_1.MultiProviderExampleWorkflow,
+            web_fetch_example_workflow_1.WebFetchExampleWorkflow,
+        ],
+    })
+], LlmExamplesModule);
+//# sourceMappingURL=llm-examples.module.js.map

package/dist/llm-examples.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-examples.module.js","sourceRoot":"","sources":["../src/llm-examples.module.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAAwC;AACxC,4DAAwD;AACxD,wEAAmE;AACnE,8CAA8C;AAC9C,4DAAwD;AACxD,sDAAkD;AAClD,gHAA0G;AAC1G,wFAAmF;AACnF,yFAAqF;AACrF,yHAAmH;AACnH,iGAA2F;AA2BpF,IAAM,iBAAiB,GAAvB,MAAM,iBAAiB;CAAG,CAAA;AAApB,8CAAiB;4BAAjB,iBAAiB;IAzB7B,IAAA,kBAAS,EAAC;QACT,KAAK,EAAE,cAAc;QACrB,SAAS,EAAE;YACT,+CAAqB;YACrB,oEAA+B;YAC/B,8DAA4B;YAC5B,oDAAuB;SACxB;KACF,CAAC;IACD,IAAA,eAAM,EAAC;QACN,OAAO,EAAE,CAAC,4BAAY,EAAE,uCAAiB,EAAE,4BAAY,EAAE,sBAAS,CAAC;QACnE,SAAS,EAAE;YACT,4BAAY;YACZ,+CAAqB;YACrB,oEAA+B;YAC/B,8DAA4B;YAC5B,oDAAuB;SACxB;QACD,OAAO,EAAE;YACP,+CAAqB;YACrB,oEAA+B;YAC/B,8DAA4B;YAC5B,oDAAuB;SACxB;KACF,CAAC;GACW,iBAAiB,CAAG"}

package/dist/workflows/multi-provider/multi-provider-example.workflow.d.ts

@@ -0,0 +1,20 @@
+import { z } from 'zod';
+import { BaseWorkflow } from '@loopstack/common';
+import type { RunContext } from '@loopstack/common';
+import { LlmGenerateTextTool } from '@loopstack/llm-provider-module';
+interface MultiProviderState {
+    prompt: string;
+}
+declare const MultiProviderArgsSchema: z.ZodObject<{
+    prompt: z.ZodDefault<z.ZodString>;
+}, z.core.$strip>;
+type MultiProviderArgs = z.infer<typeof MultiProviderArgsSchema>;
+export declare class MultiProviderExampleWorkflow extends BaseWorkflow<MultiProviderArgs> {
+    private readonly llmGenerateText;
+    constructor(llmGenerateText: LlmGenerateTextTool);
+    askClaude(state: MultiProviderState, ctx: RunContext<MultiProviderArgs>): Promise<void>;
+    askOpenAi(state: MultiProviderState): Promise<void>;
+    done(_state: MultiProviderState): void;
+}
+export {};
+//# sourceMappingURL=multi-provider-example.workflow.d.ts.map

package/dist/workflows/multi-provider/multi-provider-example.workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"multi-provider-example.workflow.d.ts","sourceRoot":"","sources":["../../../src/workflows/multi-provider/multi-provider-example.workflow.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAAwB,MAAM,mBAAmB,CAAC;AACvE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAsB,MAAM,gCAAgC,CAAC;AAEzF,UAAU,kBAAkB;IAC1B,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,QAAA,MAAM,uBAAuB;;iBAE3B,CAAC;AAEH,KAAK,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAEjE,qBAOa,4BAA6B,SAAQ,YAAY,CAAC,iBAAiB,CAAC;IACnE,OAAO,CAAC,QAAQ,CAAC,eAAe;gBAAf,eAAe,EAAE,mBAAmB;IAK3D,SAAS,CAAC,KAAK,EAAE,kBAAkB,EAAE,GAAG,EAAE,UAAU,CAAC,iBAAiB,CAAC;IAuBvE,SAAS,CAAC,KAAK,EAAE,kBAAkB;IAoBzC,IAAI,CAAC,MAAM,EAAE,kBAAkB;CAChC"}

package/dist/workflows/multi-provider/multi-provider-example.workflow.js

@@ -0,0 +1,85 @@
+"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.MultiProviderExampleWorkflow = void 0;
+const zod_1 = require("zod");
+const common_1 = require("@loopstack/common");
+const llm_provider_module_1 = require("@loopstack/llm-provider-module");
+const MultiProviderArgsSchema = zod_1.z.object({
+    prompt: zod_1.z.string().default('What is the meaning of life? Answer in one sentence.'),
+});
+let MultiProviderExampleWorkflow = class MultiProviderExampleWorkflow extends common_1.BaseWorkflow {
+    llmGenerateText;
+    constructor(llmGenerateText) {
+        super();
+        this.llmGenerateText = llmGenerateText;
+    }
+    async askClaude(state, ctx) {
+        await this.documentStore.save(llm_provider_module_1.LlmMessageDocument, { role: 'user', text: ctx.args.prompt });
+        const result = await this.llmGenerateText.call({ prompt: ctx.args.prompt }, {
+            config: {
+                save: false,
+                provider: 'claude',
+                model: 'claude-sonnet-4-6',
+                system: 'You are a helpful assistant. Keep your response brief.',
+            },
+        });
+        await this.documentStore.save(llm_provider_module_1.LlmMessageDocument, {
+            role: 'assistant',
+            text: `**Claude:** ${result.data.message.text}`,
+        });
+        this.assignState({ prompt: ctx.args.prompt });
+    }
+    async askOpenAi(state) {
+        const result = await this.llmGenerateText.call({ prompt: state.prompt }, {
+            config: {
+                save: false,
+                provider: 'openai',
+                model: 'gpt-4o-mini',
+                system: 'You are a helpful assistant. Keep your response brief.',
+            },
+        });
+        await this.documentStore.save(llm_provider_module_1.LlmMessageDocument, {
+            role: 'assistant',
+            text: `**OpenAI:** ${result.data.message.text}`,
+        });
+    }
+    done(_state) { }
+};
+exports.MultiProviderExampleWorkflow = MultiProviderExampleWorkflow;
+__decorate([
+    (0, common_1.Transition)({ to: 'claude_done' }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, Object]),
+    __metadata("design:returntype", Promise)
+], MultiProviderExampleWorkflow.prototype, "askClaude", null);
+__decorate([
+    (0, common_1.Transition)({ from: 'claude_done', to: 'openai_done' }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], MultiProviderExampleWorkflow.prototype, "askOpenAi", null);
+__decorate([
+    (0, common_1.Transition)({ from: 'openai_done', to: 'end' }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", void 0)
+], MultiProviderExampleWorkflow.prototype, "done", null);
+exports.MultiProviderExampleWorkflow = MultiProviderExampleWorkflow = __decorate([
+    (0, common_1.Workflow)({
+        title: 'LLM - Multi-Provider Example',
+        description: 'Runs the same prompt through Claude and OpenAI side by side. Demonstrates that the same tool class (LlmGenerateTextTool) works with any registered provider by passing provider/model via config at call time.',
+        widget: './multi-provider.ui.yaml',
+        schema: MultiProviderArgsSchema,
+    }),
+    __metadata("design:paramtypes", [llm_provider_module_1.LlmGenerateTextTool])
+], MultiProviderExampleWorkflow);
+//# sourceMappingURL=multi-provider-example.workflow.js.map

package/dist/workflows/multi-provider/multi-provider-example.workflow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"multi-provider-example.workflow.js","sourceRoot":"","sources":["../../../src/workflows/multi-provider/multi-provider-example.workflow.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,6BAAwB;AACxB,8CAAuE;AAEvE,wEAAyF;AAMzF,MAAM,uBAAuB,GAAG,OAAC,CAAC,MAAM,CAAC;IACvC,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,sDAAsD,CAAC;CACnF,CAAC,CAAC;AAWI,IAAM,4BAA4B,GAAlC,MAAM,4BAA6B,SAAQ,qBAA+B;IAClD;IAA7B,YAA6B,eAAoC;QAC/D,KAAK,EAAE,CAAC;QADmB,oBAAe,GAAf,eAAe,CAAqB;IAEjE,CAAC;IAGK,AAAN,KAAK,CAAC,SAAS,CAAC,KAAyB,EAAE,GAAkC;QAC3E,MAAM,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,wCAAkB,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;QAE3F,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,IAAI,CAC5C,EAAE,MAAM,EAAE,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,EAC3B;YACE,MAAM,EAAE;gBACN,IAAI,EAAE,KAAK;gBACX,QAAQ,EAAE,QAAQ;gBAClB,KAAK,EAAE,mBAAmB;gBAC1B,MAAM,EAAE,wDAAwD;aACjE;SACF,CACF,CAAC;QAEF,MAAM,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,wCAAkB,EAAE;YAChD,IAAI,EAAE,WAAW;YACjB,IAAI,EAAE,eAAe,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE;SAChD,CAAC,CAAC;QACH,IAAI,CAAC,WAAW,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IAChD,CAAC;IAGK,AAAN,KAAK,CAAC,SAAS,CAAC,KAAyB;QACvC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,IAAI,CAC5C,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,EACxB;YACE,MAAM,EAAE;gBACN,IAAI,EAAE,KAAK;gBACX,QAAQ,EAAE,QAAQ;gBAClB,KAAK,EAAE,aAAa;gBACpB,MAAM,EAAE,wDAAwD;aACjE;SACF,CACF,CAAC;QAEF,MAAM,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,wCAAkB,EAAE;YAChD,IAAI,EAAE,WAAW;YACjB,IAAI,EAAE,eAAe,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE;SAChD,CAAC,CAAC;IACL,CAAC;IAGD,IAAI,CAAC,MAA0B,IAAG,CAAC;CACpC,CAAA;AAlDY,oEAA4B;AAMjC;IADL,IAAA,mBAAU,EAAC,EAAE,EAAE,EAAE,aAAa,EAAE,CAAC;;;;6DAqBjC;AAGK;IADL,IAAA,mBAAU,EAAC,EAAE,IAAI,EAAE,aAAa,EAAE,EAAE,EAAE,aAAa,EAAE,CAAC;;;;6DAkBtD;AAGD;IADC,IAAA,mBAAU,EAAC,EAAE,IAAI,EAAE,aAAa,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC;;;;wDACZ;uCAjDxB,4BAA4B;IAPxC,IAAA,iBAAQ,EAAC;QACR,KAAK,EAAE,8BAA8B;QACrC,WAAW,EACT,gNAAgN;QAClN,MAAM,EAAE,0BAA0B;QAClC,MAAM,EAAE,uBAAuB;KAChC,CAAC;qCAE8C,yCAAmB;GADtD,4BAA4B,CAkDxC"}

package/dist/workflows/multi-provider/multi-provider.ui.yaml

@@ -0,0 +1,4 @@
+widget: start-form
+options:
+  title: Multi-Provider LLM
+  subtitle: Compare responses from different LLM providers.

package/dist/workflows/prompt/prompt-example.workflow.d.ts

@@ -0,0 +1,15 @@
+import { z } from 'zod';
+import { BaseWorkflow } from '@loopstack/common';
+import type { RunContext } from '@loopstack/common';
+import { LlmGenerateTextTool } from '@loopstack/llm-provider-module';
+declare const PromptExampleSchema: z.ZodObject<{
+    subject: z.ZodDefault<z.ZodString>;
+}, z.core.$strip>;
+type PromptExampleArgs = z.infer<typeof PromptExampleSchema>;
+export declare class PromptExampleWorkflow extends BaseWorkflow<PromptExampleArgs> {
+    private readonly llmGenerateText;
+    constructor(llmGenerateText: LlmGenerateTextTool);
+    prompt(state: Record<string, unknown>, ctx: RunContext<PromptExampleArgs>): Promise<void>;
+}
+export {};
+//# sourceMappingURL=prompt-example.workflow.d.ts.map

package/dist/workflows/prompt/prompt-example.workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-example.workflow.d.ts","sourceRoot":"","sources":["../../../src/workflows/prompt/prompt-example.workflow.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAAwB,MAAM,mBAAmB,CAAC;AACvE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAErE,QAAA,MAAM,mBAAmB;;iBAEvB,CAAC;AACH,KAAK,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAE7D,qBAMa,qBAAsB,SAAQ,YAAY,CAAC,iBAAiB,CAAC;IAC5D,OAAO,CAAC,QAAQ,CAAC,eAAe;gBAAf,eAAe,EAAE,mBAAmB;IAK3D,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,UAAU,CAAC,iBAAiB,CAAC;CAQhF"}

package/dist/workflows/prompt/prompt-example.workflow.js

@@ -0,0 +1,47 @@
+"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.PromptExampleWorkflow = void 0;
+const node_path_1 = require("node:path");
+const zod_1 = require("zod");
+const common_1 = require("@loopstack/common");
+const llm_provider_module_1 = require("@loopstack/llm-provider-module");
+const PromptExampleSchema = zod_1.z.object({
+    subject: zod_1.z.string().default('coffee'),
+});
+let PromptExampleWorkflow = class PromptExampleWorkflow extends common_1.BaseWorkflow {
+    llmGenerateText;
+    constructor(llmGenerateText) {
+        super();
+        this.llmGenerateText = llmGenerateText;
+    }
+    async prompt(state, ctx) {
+        await this.llmGenerateText.call({
+            prompt: this.render((0, node_path_1.join)(__dirname, 'templates', 'prompt.md'), { subject: ctx.args.subject }),
+        }, { config: { provider: 'claude', model: 'claude-sonnet-4-6' } });
+    }
+};
+exports.PromptExampleWorkflow = PromptExampleWorkflow;
+__decorate([
+    (0, common_1.Transition)({ to: 'end' }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, Object]),
+    __metadata("design:returntype", Promise)
+], PromptExampleWorkflow.prototype, "prompt", null);
+exports.PromptExampleWorkflow = PromptExampleWorkflow = __decorate([
+    (0, common_1.Workflow)({
+        title: 'LLM - Prompt Example (Write a haiku)',
+        description: 'Demonstrates the simplest LLM call pattern: a single prompt rendered from a Handlebars template, generating a haiku about a user-provided subject.',
+        schema: PromptExampleSchema,
+    }),
+    __metadata("design:paramtypes", [llm_provider_module_1.LlmGenerateTextTool])
+], PromptExampleWorkflow);
+//# sourceMappingURL=prompt-example.workflow.js.map

package/dist/workflows/prompt/prompt-example.workflow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-example.workflow.js","sourceRoot":"","sources":["../../../src/workflows/prompt/prompt-example.workflow.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,yCAAiC;AACjC,6BAAwB;AACxB,8CAAuE;AAEvE,wEAAqE;AAErE,MAAM,mBAAmB,GAAG,OAAC,CAAC,MAAM,CAAC;IACnC,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC;CACtC,CAAC,CAAC;AASI,IAAM,qBAAqB,GAA3B,MAAM,qBAAsB,SAAQ,qBAA+B;IAC3C;IAA7B,YAA6B,eAAoC;QAC/D,KAAK,EAAE,CAAC;QADmB,oBAAe,GAAf,eAAe,CAAqB;IAEjE,CAAC;IAGK,AAAN,KAAK,CAAC,MAAM,CAAC,KAA8B,EAAE,GAAkC;QAC7E,MAAM,IAAI,CAAC,eAAe,CAAC,IAAI,CAC7B;YACE,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,IAAA,gBAAI,EAAC,SAAS,EAAE,WAAW,EAAE,WAAW,CAAC,EAAE,EAAE,OAAO,EAAE,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;SAC9F,EACD,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,mBAAmB,EAAE,EAAE,CAC/D,CAAC;IACJ,CAAC;CACF,CAAA;AAdY,sDAAqB;AAM1B;IADL,IAAA,mBAAU,EAAC,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC;;;;mDAQzB;gCAbU,qBAAqB;IANjC,IAAA,iBAAQ,EAAC;QACR,KAAK,EAAE,sCAAsC;QAC7C,WAAW,EACT,oJAAoJ;QACtJ,MAAM,EAAE,mBAAmB;KAC5B,CAAC;qCAE8C,yCAAmB;GADtD,qBAAqB,CAcjC"}

package/dist/workflows/prompt/templates/prompt.md

@@ -0,0 +1 @@
+Write a haiku about {{ subject }}

package/dist/workflows/structured-output/documents/file-document.d.ts

@@ -0,0 +1,13 @@
+import { z } from 'zod';
+export declare const FileDocumentSchema: z.ZodObject<{
+    filename: z.ZodString;
+    description: z.ZodString;
+    code: z.ZodString;
+}, z.core.$strict>;
+export type FileDocumentType = z.infer<typeof FileDocumentSchema>;
+export declare class FileDocument {
+    filename: string;
+    description: string;
+    code: string;
+}
+//# sourceMappingURL=file-document.d.ts.map

package/dist/workflows/structured-output/documents/file-document.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-document.d.ts","sourceRoot":"","sources":["../../../../src/workflows/structured-output/documents/file-document.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,kBAAkB;;;;kBAMpB,CAAC;AAEZ,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAElE,qBAIa,YAAY;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;CACd"}

package/dist/workflows/structured-output/documents/file-document.js

@@ -0,0 +1,31 @@
+"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.FileDocument = exports.FileDocumentSchema = void 0;
+const zod_1 = require("zod");
+const common_1 = require("@loopstack/common");
+exports.FileDocumentSchema = zod_1.z
+    .object({
+    filename: zod_1.z.string(),
+    description: zod_1.z.string(),
+    code: zod_1.z.string(),
+})
+    .strict();
+let FileDocument = class FileDocument {
+    filename;
+    description;
+    code;
+};
+exports.FileDocument = FileDocument;
+exports.FileDocument = FileDocument = __decorate([
+    (0, common_1.Document)({
+        schema: exports.FileDocumentSchema,
+        widget: './file-document.yaml',
+    })
+], FileDocument);
+//# sourceMappingURL=file-document.js.map

package/dist/workflows/structured-output/documents/file-document.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-document.js","sourceRoot":"","sources":["../../../../src/workflows/structured-output/documents/file-document.ts"],"names":[],"mappings":";;;;;;;;;AAAA,6BAAwB;AACxB,8CAA6C;AAEhC,QAAA,kBAAkB,GAAG,OAAC;KAChC,MAAM,CAAC;IACN,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE;IACpB,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE;IACvB,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE;CACjB,CAAC;KACD,MAAM,EAAE,CAAC;AAQL,IAAM,YAAY,GAAlB,MAAM,YAAY;IACvB,QAAQ,CAAS;IACjB,WAAW,CAAS;IACpB,IAAI,CAAS;CACd,CAAA;AAJY,oCAAY;uBAAZ,YAAY;IAJxB,IAAA,iBAAQ,EAAC;QACR,MAAM,EAAE,0BAAkB;QAC1B,MAAM,EAAE,sBAAsB;KAC/B,CAAC;GACW,YAAY,CAIxB"}

package/dist/workflows/structured-output/documents/file-document.yaml

@@ -0,0 +1,16 @@
+widget: form
+options:
+  order:
+    - filename
+    - description
+    - code
+  properties:
+    filename:
+      title: File Name
+      readonly: true
+    description:
+      title: Description
+      readonly: true
+    code:
+      title: Code
+      widget: code-view

package/dist/workflows/structured-output/structured-output-example.workflow.d.ts

@@ -0,0 +1,30 @@
+import { z } from 'zod';
+import { BaseWorkflow, DocumentEntity } from '@loopstack/common';
+import type { RunContext } from '@loopstack/common';
+import { LlmGenerateObjectTool } from '@loopstack/llm-provider-module';
+import { FileDocumentType } from './documents/file-document';
+interface StructuredOutputState {
+    language?: string;
+    llmResult?: DocumentEntity<FileDocumentType>;
+}
+declare const StructuredOutputArgsSchema: z.ZodObject<{
+    language: z.ZodDefault<z.ZodEnum<{
+        python: "python";
+        javascript: "javascript";
+        java: "java";
+        cpp: "cpp";
+        ruby: "ruby";
+        go: "go";
+        php: "php";
+    }>>;
+}, z.core.$strip>;
+type StructuredOutputArgs = z.infer<typeof StructuredOutputArgsSchema>;
+export declare class StructuredOutputExampleWorkflow extends BaseWorkflow<StructuredOutputArgs> {
+    private readonly llmGenerateObject;
+    constructor(llmGenerateObject: LlmGenerateObjectTool);
+    greeting(state: StructuredOutputState, ctx: RunContext<StructuredOutputArgs>): Promise<void>;
+    prompt(state: StructuredOutputState): Promise<void>;
+    respond(state: StructuredOutputState): Promise<void>;
+}
+export {};
+//# sourceMappingURL=structured-output-example.workflow.d.ts.map

package/dist/workflows/structured-output/structured-output-example.workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"structured-output-example.workflow.d.ts","sourceRoot":"","sources":["../../../src/workflows/structured-output/structured-output-example.workflow.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,cAAc,EAAwB,MAAM,mBAAmB,CAAC;AACvF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,qBAAqB,EAAsB,MAAM,gCAAgC,CAAC;AAC3F,OAAO,EAAoC,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAE/F,UAAU,qBAAqB;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,cAAc,CAAC,gBAAgB,CAAC,CAAC;CAC9C;AAED,QAAA,MAAM,0BAA0B;;;;;;;;;;iBAE9B,CAAC;AAEH,KAAK,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAEvE,qBAMa,+BAAgC,SAAQ,YAAY,CAAC,oBAAoB,CAAC;IACzE,OAAO,CAAC,QAAQ,CAAC,iBAAiB;gBAAjB,iBAAiB,EAAE,qBAAqB;IAK/D,QAAQ,CAAC,KAAK,EAAE,qBAAqB,EAAE,GAAG,EAAE,UAAU,CAAC,oBAAoB,CAAC;IAU5E,MAAM,CAAC,KAAK,EAAE,qBAAqB;IAcnC,OAAO,CAAC,KAAK,EAAE,qBAAqB;CAO3C"}

package/dist/workflows/structured-output/structured-output-example.workflow.js

@@ -0,0 +1,70 @@
+"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.StructuredOutputExampleWorkflow = void 0;
+const node_path_1 = require("node:path");
+const zod_1 = require("zod");
+const common_1 = require("@loopstack/common");
+const llm_provider_module_1 = require("@loopstack/llm-provider-module");
+const file_document_1 = require("./documents/file-document");
+const StructuredOutputArgsSchema = zod_1.z.object({
+    language: zod_1.z.enum(['python', 'javascript', 'java', 'cpp', 'ruby', 'go', 'php']).default('python'),
+});
+let StructuredOutputExampleWorkflow = class StructuredOutputExampleWorkflow extends common_1.BaseWorkflow {
+    llmGenerateObject;
+    constructor(llmGenerateObject) {
+        super();
+        this.llmGenerateObject = llmGenerateObject;
+    }
+    async greeting(state, ctx) {
+        await this.documentStore.save(llm_provider_module_1.LlmMessageDocument, { role: 'assistant', text: `Creating a 'Hello, World!' script in ${ctx.args.language}...` }, { key: 'status' });
+        this.assignState({ language: ctx.args.language });
+    }
+    async prompt(state) {
+        const result = await this.llmGenerateObject.call({
+            outputSchema: file_document_1.FileDocumentSchema,
+            prompt: this.render((0, node_path_1.join)(__dirname, 'templates', 'prompt.md'), { language: state.language }),
+        }, { config: { provider: 'claude', model: 'claude-sonnet-4-6' } });
+        const llmResult = await this.documentStore.save(file_document_1.FileDocument, result.data.data);
+        this.assignState({ llmResult });
+    }
+    async respond(state) {
+        await this.documentStore.save(llm_provider_module_1.LlmMessageDocument, { role: 'assistant', text: `Successfully generated: ${state.llmResult?.content?.description ?? ''}` }, { key: 'status' });
+    }
+};
+exports.StructuredOutputExampleWorkflow = StructuredOutputExampleWorkflow;
+__decorate([
+    (0, common_1.Transition)({ to: 'ready' }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, Object]),
+    __metadata("design:returntype", Promise)
+], StructuredOutputExampleWorkflow.prototype, "greeting", null);
+__decorate([
+    (0, common_1.Transition)({ from: 'ready', to: 'prompt_executed' }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], StructuredOutputExampleWorkflow.prototype, "prompt", null);
+__decorate([
+    (0, common_1.Transition)({ from: 'prompt_executed', to: 'end' }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], StructuredOutputExampleWorkflow.prototype, "respond", null);
+exports.StructuredOutputExampleWorkflow = StructuredOutputExampleWorkflow = __decorate([
+    (0, common_1.Workflow)({
+        title: 'LLM - Structured Output Example (Hello World Script)',
+        description: 'Demonstrates generating structured LLM output using LlmGenerateObjectTool with a custom document schema. Generates a "Hello, World!" script in a chosen programming language.',
+        schema: StructuredOutputArgsSchema,
+    }),
+    __metadata("design:paramtypes", [llm_provider_module_1.LlmGenerateObjectTool])
+], StructuredOutputExampleWorkflow);
+//# sourceMappingURL=structured-output-example.workflow.js.map

package/dist/workflows/structured-output/structured-output-example.workflow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"structured-output-example.workflow.js","sourceRoot":"","sources":["../../../src/workflows/structured-output/structured-output-example.workflow.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,yCAAiC;AACjC,6BAAwB;AACxB,8CAAuF;AAEvF,wEAA2F;AAC3F,6DAA+F;AAO/F,MAAM,0BAA0B,GAAG,OAAC,CAAC,MAAM,CAAC;IAC1C,QAAQ,EAAE,OAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;CACjG,CAAC,CAAC;AAUI,IAAM,+BAA+B,GAArC,MAAM,+BAAgC,SAAQ,qBAAkC;IACxD;IAA7B,YAA6B,iBAAwC;QACnE,KAAK,EAAE,CAAC;QADmB,sBAAiB,GAAjB,iBAAiB,CAAuB;IAErE,CAAC;IAGK,AAAN,KAAK,CAAC,QAAQ,CAAC,KAA4B,EAAE,GAAqC;QAChF,MAAM,IAAI,CAAC,aAAa,CAAC,IAAI,CAC3B,wCAAkB,EAClB,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,wCAAwC,GAAG,CAAC,IAAI,CAAC,QAAQ,KAAK,EAAE,EAC3F,EAAE,GAAG,EAAE,QAAQ,EAAE,CAClB,CAAC;QACF,IAAI,CAAC,WAAW,CAAC,EAAE,QAAQ,EAAE,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;IACpD,CAAC;IAGK,AAAN,KAAK,CAAC,MAAM,CAAC,KAA4B;QACvC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAC9C;YACE,YAAY,EAAE,kCAAkB;YAChC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,IAAA,gBAAI,EAAC,SAAS,EAAE,WAAW,EAAE,WAAW,CAAC,EAAE,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC;SAC7F,EACD,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,mBAAmB,EAAE,EAAE,CAC/D,CAAC;QAEF,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,4BAAY,EAAE,MAAM,CAAC,IAAI,CAAC,IAAwB,CAAC,CAAC;QACpG,IAAI,CAAC,WAAW,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC;IAClC,CAAC;IAGK,AAAN,KAAK,CAAC,OAAO,CAAC,KAA4B;QACxC,MAAM,IAAI,CAAC,aAAa,CAAC,IAAI,CAC3B,wCAAkB,EAClB,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,2BAA2B,KAAK,CAAC,SAAS,EAAE,OAAO,EAAE,WAAW,IAAI,EAAE,EAAE,EAAE,EACrG,EAAE,GAAG,EAAE,QAAQ,EAAE,CAClB,CAAC;IACJ,CAAC;CACF,CAAA;AArCY,0EAA+B;AAMpC;IADL,IAAA,mBAAU,EAAC,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC;;;;+DAQ3B;AAGK;IADL,IAAA,mBAAU,EAAC,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,iBAAiB,EAAE,CAAC;;;;6DAYpD;AAGK;IADL,IAAA,mBAAU,EAAC,EAAE,IAAI,EAAE,iBAAiB,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC;;;;8DAOlD;0CApCU,+BAA+B;IAN3C,IAAA,iBAAQ,EAAC;QACR,KAAK,EAAE,sDAAsD;QAC7D,WAAW,EACT,+KAA+K;QACjL,MAAM,EAAE,0BAA0B;KACnC,CAAC;qCAEgD,2CAAqB;GAD1D,+BAA+B,CAqC3C"}

package/dist/workflows/structured-output/templates/prompt.md

@@ -0,0 +1,2 @@
+Create a {{ language }} script that prints 'Hello, World!' to the console.
+Wrap the code in triple-backticks including language identifier.

package/dist/workflows/web-fetch/web-fetch-example.workflow.d.ts

@@ -0,0 +1,22 @@
+import { z } from 'zod';
+import { BaseWorkflow } from '@loopstack/common';
+import type { RunContext } from '@loopstack/common';
+import { WebFetchTool } from '@loopstack/web-module';
+interface WebFetchState {
+    url?: string;
+    summary?: string;
+}
+declare const WebFetchArgsSchema: z.ZodObject<{
+    url: z.ZodDefault<z.ZodURL>;
+    prompt: z.ZodDefault<z.ZodString>;
+}, z.core.$strip>;
+type WebFetchArgs = z.infer<typeof WebFetchArgsSchema>;
+export declare class WebFetchExampleWorkflow extends BaseWorkflow<WebFetchArgs> {
+    private readonly webFetch;
+    constructor(webFetch: WebFetchTool);
+    announce(state: WebFetchState, ctx: RunContext<WebFetchArgs>): Promise<void>;
+    fetch(state: WebFetchState, ctx: RunContext<WebFetchArgs>): Promise<void>;
+    respond(state: WebFetchState): Promise<void>;
+}
+export {};
+//# sourceMappingURL=web-fetch-example.workflow.d.ts.map

package/dist/workflows/web-fetch/web-fetch-example.workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-fetch-example.workflow.d.ts","sourceRoot":"","sources":["../../../src/workflows/web-fetch/web-fetch-example.workflow.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAAwB,MAAM,mBAAmB,CAAC;AACvE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAErD,UAAU,aAAa;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,QAAA,MAAM,kBAAkB;;;iBAMtB,CAAC;AAEH,KAAK,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAEvD,qBAMa,uBAAwB,SAAQ,YAAY,CAAC,YAAY,CAAC;IACzD,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,YAAY;IAK7C,QAAQ,CAAC,KAAK,EAAE,aAAa,EAAE,GAAG,EAAE,UAAU,CAAC,YAAY,CAAC;IAS5D,KAAK,CAAC,KAAK,EAAE,aAAa,EAAE,GAAG,EAAE,UAAU,CAAC,YAAY,CAAC;IAUzD,OAAO,CAAC,KAAK,EAAE,aAAa;CAMnC"}

package/dist/workflows/web-fetch/web-fetch-example.workflow.js

@@ -0,0 +1,74 @@
+"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.WebFetchExampleWorkflow = void 0;
+const zod_1 = require("zod");
+const common_1 = require("@loopstack/common");
+const llm_provider_module_1 = require("@loopstack/llm-provider-module");
+const web_module_1 = require("@loopstack/web-module");
+const WebFetchArgsSchema = zod_1.z.object({
+    url: zod_1.z.url().default('https://loopstack.ai'),
+    prompt: zod_1.z
+        .string()
+        .default('Summarize this page in 3 bullet points.')
+        .describe('Optional instruction applied to the fetched content. Leave empty for raw Markdown.'),
+});
+let WebFetchExampleWorkflow = class WebFetchExampleWorkflow extends common_1.BaseWorkflow {
+    webFetch;
+    constructor(webFetch) {
+        super();
+        this.webFetch = webFetch;
+    }
+    async announce(state, ctx) {
+        await this.documentStore.save(llm_provider_module_1.LlmMessageDocument, { role: 'assistant', text: `Fetching ${ctx.args.url}...` }, { key: 'status' });
+    }
+    async fetch(state, ctx) {
+        const result = await this.webFetch.call({
+            url: ctx.args.url,
+            prompt: ctx.args.prompt,
+        });
+        this.assignState({ url: ctx.args.url, summary: result.data.result });
+    }
+    async respond(state) {
+        await this.documentStore.save(llm_provider_module_1.LlmMessageDocument, {
+            role: 'assistant',
+            text: state.summary ?? '(no content)',
+        });
+    }
+};
+exports.WebFetchExampleWorkflow = WebFetchExampleWorkflow;
+__decorate([
+    (0, common_1.Transition)({ to: 'fetching' }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, Object]),
+    __metadata("design:returntype", Promise)
+], WebFetchExampleWorkflow.prototype, "announce", null);
+__decorate([
+    (0, common_1.Transition)({ from: 'fetching', to: 'fetched' }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, Object]),
+    __metadata("design:returntype", Promise)
+], WebFetchExampleWorkflow.prototype, "fetch", null);
+__decorate([
+    (0, common_1.Transition)({ from: 'fetched', to: 'end' }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], WebFetchExampleWorkflow.prototype, "respond", null);
+exports.WebFetchExampleWorkflow = WebFetchExampleWorkflow = __decorate([
+    (0, common_1.Workflow)({
+        title: 'LLM - Web Fetch Example',
+        description: 'Fetches a URL, converts HTML to Markdown, and summarizes it with Claude using a user-provided prompt. Demonstrates the WebFetchTool from @loopstack/web-module.',
+        schema: WebFetchArgsSchema,
+    }),
+    __metadata("design:paramtypes", [web_module_1.WebFetchTool])
+], WebFetchExampleWorkflow);
+//# sourceMappingURL=web-fetch-example.workflow.js.map

package/dist/workflows/web-fetch/web-fetch-example.workflow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-fetch-example.workflow.js","sourceRoot":"","sources":["../../../src/workflows/web-fetch/web-fetch-example.workflow.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,6BAAwB;AACxB,8CAAuE;AAEvE,wEAAoE;AACpE,sDAAqD;AAOrD,MAAM,kBAAkB,GAAG,OAAC,CAAC,MAAM,CAAC;IAClC,GAAG,EAAE,OAAC,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,sBAAsB,CAAC;IAC5C,MAAM,EAAE,OAAC;SACN,MAAM,EAAE;SACR,OAAO,CAAC,yCAAyC,CAAC;SAClD,QAAQ,CAAC,oFAAoF,CAAC;CAClG,CAAC,CAAC;AAUI,IAAM,uBAAuB,GAA7B,MAAM,uBAAwB,SAAQ,qBAA0B;IACxC;IAA7B,YAA6B,QAAsB;QACjD,KAAK,EAAE,CAAC;QADmB,aAAQ,GAAR,QAAQ,CAAc;IAEnD,CAAC;IAGK,AAAN,KAAK,CAAC,QAAQ,CAAC,KAAoB,EAAE,GAA6B;QAChE,MAAM,IAAI,CAAC,aAAa,CAAC,IAAI,CAC3B,wCAAkB,EAClB,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,YAAY,GAAG,CAAC,IAAI,CAAC,GAAG,KAAK,EAAE,EAC1D,EAAE,GAAG,EAAE,QAAQ,EAAE,CAClB,CAAC;IACJ,CAAC;IAGK,AAAN,KAAK,CAAC,KAAK,CAAC,KAAoB,EAAE,GAA6B;QAC7D,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;YACtC,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,GAAG;YACjB,MAAM,EAAE,GAAG,CAAC,IAAI,CAAC,MAAM;SACxB,CAAC,CAAC;QAEH,IAAI,CAAC,WAAW,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IACvE,CAAC;IAGK,AAAN,KAAK,CAAC,OAAO,CAAC,KAAoB;QAChC,MAAM,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,wCAAkB,EAAE;YAChD,IAAI,EAAE,WAAW;YACjB,IAAI,EAAE,KAAK,CAAC,OAAO,IAAI,cAAc;SACtC,CAAC,CAAC;IACL,CAAC;CACF,CAAA;AA/BY,0DAAuB;AAM5B;IADL,IAAA,mBAAU,EAAC,EAAE,EAAE,EAAE,UAAU,EAAE,CAAC;;;;uDAO9B;AAGK;IADL,IAAA,mBAAU,EAAC,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,SAAS,EAAE,CAAC;;;;oDAQ/C;AAGK;IADL,IAAA,mBAAU,EAAC,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC;;;;sDAM1C;kCA9BU,uBAAuB;IANnC,IAAA,iBAAQ,EAAC;QACR,KAAK,EAAE,yBAAyB;QAChC,WAAW,EACT,iKAAiK;QACnK,MAAM,EAAE,kBAAkB;KAC3B,CAAC;qCAEuC,yBAAY;GADxC,uBAAuB,CA+BnC"}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@loopstack/llm-examples",
+  "displayName": "Loopstack LLM Examples",
+  "description": "Workflow examples for LLM integration in Loopstack — simple prompts, structured output, multi-provider, and web fetch with summarization.",
+  "keywords": [
+    "loopstack",
+    "example",
+    "llm",
+    "prompt",
+    "claude",
+    "openai",
+    "web-fetch"
+  ],
+  "version": "0.1.1",
+  "license": "MIT",
+  "author": {
+    "name": "Jakob Klippel",
+    "url": "https://www.linkedin.com/in/jakob-klippel/"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": "./dist/index.js",
+    "./src/*": "./src/*"
+  },
+  "scripts": {
+    "build": "nest build",
+    "compile": "tsc --noEmit",
+    "format": "prettier --write .",
+    "lint": "eslint .",
+    "test": "vitest run --passWithNoTests",
+    "watch": "nest build --watch"
+  },
+  "dependencies": {
+    "@loopstack/claude-module": "*",
+    "@loopstack/claude-tools-module": "*",
+    "@loopstack/common": "*",
+    "@loopstack/llm-provider-module": "*",
+    "@loopstack/openai-module": "*",
+    "@loopstack/web-module": "*",
+    "@nestjs/common": "^11.1.19",
+    "zod": "^4.3.6"
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "devDependencies": {
+    "vitest": "^4.1.6",
+    "@swc/core": "^1.15.33",
+    "unplugin-swc": "^1.5.9"
+  }
+}

package/src/index.ts

@@ -0,0 +1,5 @@
+export * from './llm-examples.module';
+export * from './workflows/prompt/prompt-example.workflow';
+export * from './workflows/structured-output/structured-output-example.workflow';
+export * from './workflows/multi-provider/multi-provider-example.workflow';
+export * from './workflows/web-fetch/web-fetch-example.workflow';

package/src/llm-examples.module.ts

@@ -0,0 +1,38 @@
+import { Module } from '@nestjs/common';
+import { ClaudeModule } from '@loopstack/claude-module';
+import { ClaudeToolsModule } from '@loopstack/claude-tools-module';
+import { StudioApp } from '@loopstack/common';
+import { OpenAiModule } from '@loopstack/openai-module';
+import { WebModule } from '@loopstack/web-module';
+import { MultiProviderExampleWorkflow } from './workflows/multi-provider/multi-provider-example.workflow';
+import { PromptExampleWorkflow } from './workflows/prompt/prompt-example.workflow';
+import { FileDocument } from './workflows/structured-output/documents/file-document';
+import { StructuredOutputExampleWorkflow } from './workflows/structured-output/structured-output-example.workflow';
+import { WebFetchExampleWorkflow } from './workflows/web-fetch/web-fetch-example.workflow';
+
+@StudioApp({
+  title: 'LLM Examples',
+  workflows: [
+    PromptExampleWorkflow,
+    StructuredOutputExampleWorkflow,
+    MultiProviderExampleWorkflow,
+    WebFetchExampleWorkflow,
+  ],
+})
+@Module({
+  imports: [ClaudeModule, ClaudeToolsModule, OpenAiModule, WebModule],
+  providers: [
+    FileDocument,
+    PromptExampleWorkflow,
+    StructuredOutputExampleWorkflow,
+    MultiProviderExampleWorkflow,
+    WebFetchExampleWorkflow,
+  ],
+  exports: [
+    PromptExampleWorkflow,
+    StructuredOutputExampleWorkflow,
+    MultiProviderExampleWorkflow,
+    WebFetchExampleWorkflow,
+  ],
+})
+export class LlmExamplesModule {}

package/src/workflows/multi-provider/multi-provider-example.workflow.ts

@@ -0,0 +1,73 @@
+import { z } from 'zod';
+import { BaseWorkflow, Transition, Workflow } from '@loopstack/common';
+import type { RunContext } from '@loopstack/common';
+import { LlmGenerateTextTool, LlmMessageDocument } from '@loopstack/llm-provider-module';
+
+interface MultiProviderState {
+  prompt: string;
+}
+
+const MultiProviderArgsSchema = z.object({
+  prompt: z.string().default('What is the meaning of life? Answer in one sentence.'),
+});
+
+type MultiProviderArgs = z.infer<typeof MultiProviderArgsSchema>;
+
+@Workflow({
+  title: 'LLM - Multi-Provider Example',
+  description:
+    'Runs the same prompt through Claude and OpenAI side by side. Demonstrates that the same tool class (LlmGenerateTextTool) works with any registered provider by passing provider/model via config at call time.',
+  widget: './multi-provider.ui.yaml',
+  schema: MultiProviderArgsSchema,
+})
+export class MultiProviderExampleWorkflow extends BaseWorkflow<MultiProviderArgs> {
+  constructor(private readonly llmGenerateText: LlmGenerateTextTool) {
+    super();
+  }
+
+  @Transition({ to: 'claude_done' })
+  async askClaude(state: MultiProviderState, ctx: RunContext<MultiProviderArgs>) {
+    await this.documentStore.save(LlmMessageDocument, { role: 'user', text: ctx.args.prompt });
+
+    const result = await this.llmGenerateText.call(
+      { prompt: ctx.args.prompt },
+      {
+        config: {
+          save: false,
+          provider: 'claude',
+          model: 'claude-sonnet-4-6',
+          system: 'You are a helpful assistant. Keep your response brief.',
+        },
+      },
+    );
+
+    await this.documentStore.save(LlmMessageDocument, {
+      role: 'assistant',
+      text: `**Claude:** ${result.data.message.text}`,
+    });
+    this.assignState({ prompt: ctx.args.prompt });
+  }
+
+  @Transition({ from: 'claude_done', to: 'openai_done' })
+  async askOpenAi(state: MultiProviderState) {
+    const result = await this.llmGenerateText.call(
+      { prompt: state.prompt },
+      {
+        config: {
+          save: false,
+          provider: 'openai',
+          model: 'gpt-4o-mini',
+          system: 'You are a helpful assistant. Keep your response brief.',
+        },
+      },
+    );
+
+    await this.documentStore.save(LlmMessageDocument, {
+      role: 'assistant',
+      text: `**OpenAI:** ${result.data.message.text}`,
+    });
+  }
+
+  @Transition({ from: 'openai_done', to: 'end' })
+  done(_state: MultiProviderState) {}
+}

package/src/workflows/multi-provider/multi-provider.ui.yaml

@@ -0,0 +1,4 @@
+widget: start-form
+options:
+  title: Multi-Provider LLM
+  subtitle: Compare responses from different LLM providers.

package/src/workflows/prompt/prompt-example.workflow.ts

@@ -0,0 +1,32 @@
+import { join } from 'node:path';
+import { z } from 'zod';
+import { BaseWorkflow, Transition, Workflow } from '@loopstack/common';
+import type { RunContext } from '@loopstack/common';
+import { LlmGenerateTextTool } from '@loopstack/llm-provider-module';
+
+const PromptExampleSchema = z.object({
+  subject: z.string().default('coffee'),
+});
+type PromptExampleArgs = z.infer<typeof PromptExampleSchema>;
+
+@Workflow({
+  title: 'LLM - Prompt Example (Write a haiku)',
+  description:
+    'Demonstrates the simplest LLM call pattern: a single prompt rendered from a Handlebars template, generating a haiku about a user-provided subject.',
+  schema: PromptExampleSchema,
+})
+export class PromptExampleWorkflow extends BaseWorkflow<PromptExampleArgs> {
+  constructor(private readonly llmGenerateText: LlmGenerateTextTool) {
+    super();
+  }
+
+  @Transition({ to: 'end' })
+  async prompt(state: Record<string, unknown>, ctx: RunContext<PromptExampleArgs>) {
+    await this.llmGenerateText.call(
+      {
+        prompt: this.render(join(__dirname, 'templates', 'prompt.md'), { subject: ctx.args.subject }),
+      },
+      { config: { provider: 'claude', model: 'claude-sonnet-4-6' } },
+    );
+  }
+}

package/src/workflows/prompt/templates/prompt.md

@@ -0,0 +1 @@
+Write a haiku about {{ subject }}

package/src/workflows/structured-output/documents/file-document.ts

@@ -0,0 +1,22 @@
+import { z } from 'zod';
+import { Document } from '@loopstack/common';
+
+export const FileDocumentSchema = z
+  .object({
+    filename: z.string(),
+    description: z.string(),
+    code: z.string(),
+  })
+  .strict();
+
+export type FileDocumentType = z.infer<typeof FileDocumentSchema>;
+
+@Document({
+  schema: FileDocumentSchema,
+  widget: './file-document.yaml',
+})
+export class FileDocument {
+  filename: string;
+  description: string;
+  code: string;
+}

package/src/workflows/structured-output/documents/file-document.yaml

@@ -0,0 +1,16 @@
+widget: form
+options:
+  order:
+    - filename
+    - description
+    - code
+  properties:
+    filename:
+      title: File Name
+      readonly: true
+    description:
+      title: Description
+      readonly: true
+    code:
+      title: Code
+      widget: code-view

package/src/workflows/structured-output/structured-output-example.workflow.ts

@@ -0,0 +1,62 @@
+import { join } from 'node:path';
+import { z } from 'zod';
+import { BaseWorkflow, DocumentEntity, Transition, Workflow } from '@loopstack/common';
+import type { RunContext } from '@loopstack/common';
+import { LlmGenerateObjectTool, LlmMessageDocument } from '@loopstack/llm-provider-module';
+import { FileDocument, FileDocumentSchema, FileDocumentType } from './documents/file-document';
+
+interface StructuredOutputState {
+  language?: string;
+  llmResult?: DocumentEntity<FileDocumentType>;
+}
+
+const StructuredOutputArgsSchema = z.object({
+  language: z.enum(['python', 'javascript', 'java', 'cpp', 'ruby', 'go', 'php']).default('python'),
+});
+
+type StructuredOutputArgs = z.infer<typeof StructuredOutputArgsSchema>;
+
+@Workflow({
+  title: 'LLM - Structured Output Example (Hello World Script)',
+  description:
+    'Demonstrates generating structured LLM output using LlmGenerateObjectTool with a custom document schema. Generates a "Hello, World!" script in a chosen programming language.',
+  schema: StructuredOutputArgsSchema,
+})
+export class StructuredOutputExampleWorkflow extends BaseWorkflow<StructuredOutputArgs> {
+  constructor(private readonly llmGenerateObject: LlmGenerateObjectTool) {
+    super();
+  }
+
+  @Transition({ to: 'ready' })
+  async greeting(state: StructuredOutputState, ctx: RunContext<StructuredOutputArgs>) {
+    await this.documentStore.save(
+      LlmMessageDocument,
+      { role: 'assistant', text: `Creating a 'Hello, World!' script in ${ctx.args.language}...` },
+      { key: 'status' },
+    );
+    this.assignState({ language: ctx.args.language });
+  }
+
+  @Transition({ from: 'ready', to: 'prompt_executed' })
+  async prompt(state: StructuredOutputState) {
+    const result = await this.llmGenerateObject.call(
+      {
+        outputSchema: FileDocumentSchema,
+        prompt: this.render(join(__dirname, 'templates', 'prompt.md'), { language: state.language }),
+      },
+      { config: { provider: 'claude', model: 'claude-sonnet-4-6' } },
+    );
+
+    const llmResult = await this.documentStore.save(FileDocument, result.data.data as FileDocumentType);
+    this.assignState({ llmResult });
+  }
+
+  @Transition({ from: 'prompt_executed', to: 'end' })
+  async respond(state: StructuredOutputState) {
+    await this.documentStore.save(
+      LlmMessageDocument,
+      { role: 'assistant', text: `Successfully generated: ${state.llmResult?.content?.description ?? ''}` },
+      { key: 'status' },
+    );
+  }
+}

package/src/workflows/structured-output/templates/prompt.md

@@ -0,0 +1,2 @@
+Create a {{ language }} script that prints 'Hello, World!' to the console.
+Wrap the code in triple-backticks including language identifier.

package/src/workflows/web-fetch/web-fetch-example.workflow.ts

@@ -0,0 +1,59 @@
+import { z } from 'zod';
+import { BaseWorkflow, Transition, Workflow } from '@loopstack/common';
+import type { RunContext } from '@loopstack/common';
+import { LlmMessageDocument } from '@loopstack/llm-provider-module';
+import { WebFetchTool } from '@loopstack/web-module';
+
+interface WebFetchState {
+  url?: string;
+  summary?: string;
+}
+
+const WebFetchArgsSchema = z.object({
+  url: z.url().default('https://loopstack.ai'),
+  prompt: z
+    .string()
+    .default('Summarize this page in 3 bullet points.')
+    .describe('Optional instruction applied to the fetched content. Leave empty for raw Markdown.'),
+});
+
+type WebFetchArgs = z.infer<typeof WebFetchArgsSchema>;
+
+@Workflow({
+  title: 'LLM - Web Fetch Example',
+  description:
+    'Fetches a URL, converts HTML to Markdown, and summarizes it with Claude using a user-provided prompt. Demonstrates the WebFetchTool from @loopstack/web-module.',
+  schema: WebFetchArgsSchema,
+})
+export class WebFetchExampleWorkflow extends BaseWorkflow<WebFetchArgs> {
+  constructor(private readonly webFetch: WebFetchTool) {
+    super();
+  }
+
+  @Transition({ to: 'fetching' })
+  async announce(state: WebFetchState, ctx: RunContext<WebFetchArgs>) {
+    await this.documentStore.save(
+      LlmMessageDocument,
+      { role: 'assistant', text: `Fetching ${ctx.args.url}...` },
+      { key: 'status' },
+    );
+  }
+
+  @Transition({ from: 'fetching', to: 'fetched' })
+  async fetch(state: WebFetchState, ctx: RunContext<WebFetchArgs>) {
+    const result = await this.webFetch.call({
+      url: ctx.args.url,
+      prompt: ctx.args.prompt,
+    });
+
+    this.assignState({ url: ctx.args.url, summary: result.data.result });
+  }
+
+  @Transition({ from: 'fetched', to: 'end' })
+  async respond(state: WebFetchState) {
+    await this.documentStore.save(LlmMessageDocument, {
+      role: 'assistant',
+      text: state.summary ?? '(no content)',
+    });
+  }
+}