@loopstack/hitl-examples 0.1.1

package/README.md

@@ -0,0 +1,165 @@
+---
+title: HITL Examples
+description: Workflow examples for Human-in-the-Loop patterns in Loopstack — custom Document with a form widget, AskUserWorkflow / ConfirmUserWorkflow sub-workflow shortcuts, LLM agent loops with ask_clarification / ask_for_approval, and an end-to-end meeting-notes review flow.
+---
+
+# @loopstack/hitl-examples
+
+> Human-in-the-Loop workflow examples for the [Loopstack](https://loopstack.ai) automation framework.
+
+Side-by-side examples of every way to pause a Loopstack workflow for the user. The point of this package is to answer one question: **when do I design a custom document with a widget, vs. delegate to a HITL sub-workflow, vs. let an LLM agent ask the user?**
+
+## Decision matrix
+
+| You are building...                                                                                                                     | Use                                                                                                 | Examples                                                           |
+| --------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------ |
+| A predefined workflow with known user-input steps — form fields, structured data, a record the user edits                               | **Custom document with a widget** — your workflow owns the document and the `wait: true` transition | Inline Form, Prompt Input Chat, Meeting Notes                      |
+| An LLM agent loop where the LLM dynamically decides to ask the user something or request approval                                       | **Agent tools** `ask_clarification` / `ask_for_approval` from `@loopstack/hitl`                     | Agent Ask Clarification, Agent Ask For Approval                    |
+| A predefined workflow that just needs a quick generic ask — one free-text field, yes/no, pick-one — and you don't want to design a form | **Sub-workflow shortcut** — `AskUserWorkflow` / `ConfirmUserWorkflow` from `@loopstack/hitl`        | Ask User Text, Ask User Options, Ask User Confirm, Confirm Content |
+
+## Install as Source (Recommended)
+
+```bash
+npx giget@latest gh:loopstack-ai/loopstack/registry/examples/hitl-examples src/hitl-examples
+```
+
+Then register the module in your app:
+
+```typescript
+import { Module } from '@nestjs/common';
+import { LoopstackModule } from '@loopstack/loopstack-module';
+import { HitlExamplesModule } from './hitl-examples/hitl-examples.module';
+
+@Module({
+  imports: [LoopstackModule.forRoot(), HitlExamplesModule],
+})
+export class AppModule {}
+```
+
+## Install as a Dependency
+
+```bash
+npm install @loopstack/hitl-examples
+```
+
+```typescript
+import { HitlExamplesModule } from '@loopstack/hitl-examples';
+```
+
+## Environment
+
+The agent and meeting-notes examples require Claude credentials:
+
+```bash
+ANTHROPIC_API_KEY=sk-ant-...
+```
+
+The non-agent examples (Inline Form, Prompt Input Chat, Ask User \*, Confirm Content) work without any LLM provider.
+
+## Examples
+
+| Example                                             | Studio title                             | Description                                                                           |
+| --------------------------------------------------- | ---------------------------------------- | ------------------------------------------------------------------------------------- |
+| [Inline Form](#inline-form)                         | `HITL - Inline Form Example`             | Custom Document with a form widget, `wait: true` payload typed by the document schema |
+| [Prompt Input Chat](#prompt-input-chat)             | `HITL - Prompt Input Chat Example`       | Workflow-level prompt-input widget; loops on user messages without an LLM             |
+| [Ask User Text](#ask-user-text)                     | `HITL - Ask User Text Example`           | `AskUserWorkflow` for a generic free-text question                                    |
+| [Ask User Options](#ask-user-options)               | `HITL - Ask User Options Example`        | `AskUserWorkflow` with `mode: 'options'` and `allowCustomAnswer`                      |
+| [Ask User Confirm](#ask-user-confirm)               | `HITL - Ask User Confirm Example`        | `AskUserWorkflow` with `mode: 'confirm'` for yes/no decisions                         |
+| [Confirm Content](#confirm-content)                 | `HITL - Confirm Content Example`         | `ConfirmUserWorkflow` to show a pre-rendered markdown blob for explicit approval      |
+| [Agent Ask Clarification](#agent-ask-clarification) | `HITL - Agent Ask Clarification Example` | LLM agent with `ask_clarification` tool — pauses to request missing info              |
+| [Agent Ask For Approval](#agent-ask-for-approval)   | `HITL - Agent Ask For Approval Example`  | LLM agent with `ask_for_approval` tool — drafts content and pauses for confirm/deny   |
+| [Meeting Notes](#meeting-notes)                     | `HITL - Meeting Notes Example`           | End-to-end document-review flow: user notes → LLM-extracted structure → user approval |
+
+---
+
+## Inline Form
+
+The workflow owns a `FeedbackFormDocument` whose schema doubles as the `wait: true` transition payload. The form's Submit button triggers the transition with typed data — no wrapping or unpacking.
+
+### Files
+
+- `inline-form-example.workflow.ts` — workflow class
+- `feedback-form-document.ts` — `@Document` with Zod schema
+- `feedback-form-document.yaml` — form widget definition
+
+## Prompt Input Chat
+
+Workflow-level `widget: prompt-input` with `enabledWhen: [waiting_for_user]`. Loops on user messages and echoes them back — no LLM and no sub-workflow involved. Demonstrates the chat-style entry pattern that LLM agent loops are built on.
+
+### Files
+
+- `prompt-input-chat-example.workflow.ts` — workflow class
+- `prompt-input-chat-example.workflow.yaml` — workflow-level prompt-input widget
+
+## Ask User Text
+
+Delegate a generic free-text question to `AskUserWorkflow`. The parent workflow only owns the callback transition that receives the answer. Use the inline-form pattern instead when you need a structured form.
+
+### Files
+
+- `ask-user-text-example.workflow.ts` — workflow class
+
+## Ask User Options
+
+Delegate a "pick one from a list" question to `AskUserWorkflow` with `mode: 'options'`. `allowCustomAnswer: true` adds a free-text field next to the choices.
+
+### Files
+
+- `ask-user-options-example.workflow.ts` — workflow class
+
+## Ask User Confirm
+
+Delegate a yes/no decision to `AskUserWorkflow` with `mode: 'confirm'`. The answer comes back as the literal string `'yes'` or `'no'`.
+
+### Files
+
+- `ask-user-confirm-example.workflow.ts` — workflow class
+
+## Confirm Content
+
+Hand a pre-rendered markdown blob to `ConfirmUserWorkflow` for a user-facing review. The callback receives `{ confirmed: boolean, markdown: string }`. Useful for showing a release plan, summary, or diff for explicit approval.
+
+### Files
+
+- `confirm-content-example.workflow.ts` — workflow class
+
+## Agent Ask Clarification
+
+Launches `AgentWorkflow` with `tools: ['ask_clarification']`. When the LLM lacks information, it issues an `ask_clarification` tool call — the loop pauses and prompts the user, then the answer flows back into the agent context.
+
+### Files
+
+- `agent-ask-clarification-example.workflow.ts` — workflow class
+
+## Agent Ask For Approval
+
+Launches `AgentWorkflow` with `tools: ['ask_for_approval']`. The LLM drafts content (release notes, in this example), then calls `ask_for_approval` with the markdown — the loop pauses until the user explicitly confirms or denies.
+
+### Files
+
+- `agent-ask-for-approval-example.workflow.ts` — workflow class
+
+## Meeting Notes
+
+A complete HITL document-review flow:
+
+1. Save a `MeetingNotesDocument` with the user's raw notes (form widget for edits)
+2. User reviews/edits and submits via `wait: true` transition
+3. `LlmGenerateObjectTool` extracts structured data via Zod schema
+4. Save `OptimizedNotesDocument` for the user to review/approve
+5. Final approval via second `wait: true` transition
+
+Combines custom documents, LLM-driven structured output, and two HITL review steps.
+
+### Files
+
+- `meeting-notes-example.workflow.ts` — workflow class
+- `documents/meeting-notes-document.{ts,yaml}` — input form document
+- `documents/optimized-notes-document.{ts,yaml}` — structured output document
+- `templates/extract-notes.md` — LLM prompt template
+
+## About
+
+Author: [Jakob Klippel](https://www.linkedin.com/in/jakob-klippel/)
+
+License: MIT

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"hitl-examples.module.d.ts","sourceRoot":"","sources":["../src/hitl-examples.module.ts"],"names":[],"mappings":"AA8BA,qBASa,kBAAkB;CAAG"}

package/dist/hitl-examples.module.js

@@ -0,0 +1,52 @@
+"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.HitlExamplesModule = void 0;
+const common_1 = require("@nestjs/common");
+const agent_1 = require("@loopstack/agent");
+const claude_module_1 = require("@loopstack/claude-module");
+const common_2 = require("@loopstack/common");
+const hitl_1 = require("@loopstack/hitl");
+const agent_ask_clarification_example_workflow_1 = require("./workflows/agent-ask-clarification/agent-ask-clarification-example.workflow");
+const agent_ask_for_approval_example_workflow_1 = require("./workflows/agent-ask-for-approval/agent-ask-for-approval-example.workflow");
+const ask_user_confirm_example_workflow_1 = require("./workflows/ask-user-confirm/ask-user-confirm-example.workflow");
+const ask_user_options_example_workflow_1 = require("./workflows/ask-user-options/ask-user-options-example.workflow");
+const ask_user_text_example_workflow_1 = require("./workflows/ask-user-text/ask-user-text-example.workflow");
+const confirm_content_example_workflow_1 = require("./workflows/confirm-content/confirm-content-example.workflow");
+const feedback_form_document_1 = require("./workflows/inline-form/feedback-form-document");
+const inline_form_example_workflow_1 = require("./workflows/inline-form/inline-form-example.workflow");
+const meeting_notes_document_1 = require("./workflows/meeting-notes/documents/meeting-notes-document");
+const optimized_notes_document_1 = require("./workflows/meeting-notes/documents/optimized-notes-document");
+const meeting_notes_example_workflow_1 = require("./workflows/meeting-notes/meeting-notes-example.workflow");
+const prompt_input_chat_example_workflow_1 = require("./workflows/prompt-input-chat/prompt-input-chat-example.workflow");
+const WORKFLOWS = [
+    inline_form_example_workflow_1.InlineFormExampleWorkflow,
+    prompt_input_chat_example_workflow_1.PromptInputChatExampleWorkflow,
+    ask_user_text_example_workflow_1.AskUserTextExampleWorkflow,
+    ask_user_options_example_workflow_1.AskUserOptionsExampleWorkflow,
+    ask_user_confirm_example_workflow_1.AskUserConfirmExampleWorkflow,
+    confirm_content_example_workflow_1.ConfirmContentExampleWorkflow,
+    agent_ask_clarification_example_workflow_1.AgentAskClarificationExampleWorkflow,
+    agent_ask_for_approval_example_workflow_1.AgentAskForApprovalExampleWorkflow,
+    meeting_notes_example_workflow_1.MeetingNotesExampleWorkflow,
+];
+let HitlExamplesModule = class HitlExamplesModule {
+};
+exports.HitlExamplesModule = HitlExamplesModule;
+exports.HitlExamplesModule = HitlExamplesModule = __decorate([
+    (0, common_2.StudioApp)({
+        title: 'HITL Examples',
+        workflows: WORKFLOWS,
+    }),
+    (0, common_1.Module)({
+        imports: [hitl_1.HitlModule, agent_1.AgentModule, claude_module_1.ClaudeModule],
+        providers: [feedback_form_document_1.FeedbackFormDocument, meeting_notes_document_1.MeetingNotesDocument, optimized_notes_document_1.OptimizedNotesDocument, ...WORKFLOWS],
+        exports: WORKFLOWS,
+    })
+], HitlExamplesModule);
+//# sourceMappingURL=hitl-examples.module.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hitl-examples.module.js","sourceRoot":"","sources":["../src/hitl-examples.module.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAAwC;AACxC,4CAA+C;AAC/C,4DAAwD;AACxD,8CAA8C;AAC9C,0CAA6C;AAC7C,2IAAoI;AACpI,wIAAgI;AAChI,sHAA+G;AAC/G,sHAA+G;AAC/G,6GAAsG;AACtG,mHAA6G;AAC7G,2FAAsF;AACtF,uGAAiG;AACjG,uGAAkG;AAClG,2GAAsG;AACtG,6GAAuG;AACvG,yHAAkH;AAElH,MAAM,SAAS,GAAG;IAChB,wDAAyB;IACzB,mEAA8B;IAC9B,2DAA0B;IAC1B,iEAA6B;IAC7B,iEAA6B;IAC7B,gEAA6B;IAC7B,+EAAoC;IACpC,4EAAkC;IAClC,4DAA2B;CAC5B,CAAC;AAWK,IAAM,kBAAkB,GAAxB,MAAM,kBAAkB;CAAG,CAAA;AAArB,gDAAkB;6BAAlB,kBAAkB;IAT9B,IAAA,kBAAS,EAAC;QACT,KAAK,EAAE,eAAe;QACtB,SAAS,EAAE,SAAS;KACrB,CAAC;IACD,IAAA,eAAM,EAAC;QACN,OAAO,EAAE,CAAC,iBAAU,EAAE,mBAAW,EAAE,4BAAY,CAAC;QAChD,SAAS,EAAE,CAAC,6CAAoB,EAAE,6CAAoB,EAAE,iDAAsB,EAAE,GAAG,SAAS,CAAC;QAC7F,OAAO,EAAE,SAAS;KACnB,CAAC;GACW,kBAAkB,CAAG"}

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+export * from './hitl-examples.module';
+export * from './workflows/inline-form/inline-form-example.workflow';
+export * from './workflows/inline-form/feedback-form-document';
+export * from './workflows/prompt-input-chat/prompt-input-chat-example.workflow';
+export * from './workflows/ask-user-text/ask-user-text-example.workflow';
+export * from './workflows/ask-user-options/ask-user-options-example.workflow';
+export * from './workflows/ask-user-confirm/ask-user-confirm-example.workflow';
+export * from './workflows/confirm-content/confirm-content-example.workflow';
+export * from './workflows/agent-ask-clarification/agent-ask-clarification-example.workflow';
+export * from './workflows/agent-ask-for-approval/agent-ask-for-approval-example.workflow';
+export * from './workflows/meeting-notes/meeting-notes-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,wBAAwB,CAAC;AAEvC,cAAc,sDAAsD,CAAC;AACrE,cAAc,gDAAgD,CAAC;AAE/D,cAAc,kEAAkE,CAAC;AAEjF,cAAc,0DAA0D,CAAC;AACzE,cAAc,gEAAgE,CAAC;AAC/E,cAAc,gEAAgE,CAAC;AAC/E,cAAc,8DAA8D,CAAC;AAE7E,cAAc,8EAA8E,CAAC;AAC7F,cAAc,4EAA4E,CAAC;AAE3F,cAAc,0DAA0D,CAAC"}

package/dist/index.js

@@ -0,0 +1,28 @@
+"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("./hitl-examples.module"), exports);
+__exportStar(require("./workflows/inline-form/inline-form-example.workflow"), exports);
+__exportStar(require("./workflows/inline-form/feedback-form-document"), exports);
+__exportStar(require("./workflows/prompt-input-chat/prompt-input-chat-example.workflow"), exports);
+__exportStar(require("./workflows/ask-user-text/ask-user-text-example.workflow"), exports);
+__exportStar(require("./workflows/ask-user-options/ask-user-options-example.workflow"), exports);
+__exportStar(require("./workflows/ask-user-confirm/ask-user-confirm-example.workflow"), exports);
+__exportStar(require("./workflows/confirm-content/confirm-content-example.workflow"), exports);
+__exportStar(require("./workflows/agent-ask-clarification/agent-ask-clarification-example.workflow"), exports);
+__exportStar(require("./workflows/agent-ask-for-approval/agent-ask-for-approval-example.workflow"), exports);
+__exportStar(require("./workflows/meeting-notes/meeting-notes-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,yDAAuC;AAEvC,uFAAqE;AACrE,iFAA+D;AAE/D,mGAAiF;AAEjF,2FAAyE;AACzE,iGAA+E;AAC/E,iGAA+E;AAC/E,+FAA6E;AAE7E,+GAA6F;AAC7F,6GAA2F;AAE3F,2FAAyE"}

package/dist/workflows/agent-ask-clarification/agent-ask-clarification-example.workflow.d.ts

@@ -0,0 +1,9 @@
+import { type AgentResult, AgentWorkflow } from '@loopstack/agent';
+import { BaseWorkflow, type TransitionInput } from '@loopstack/common';
+export declare class AgentAskClarificationExampleWorkflow extends BaseWorkflow {
+    private readonly agentWorkflow;
+    constructor(agentWorkflow: AgentWorkflow);
+    start(_state: Record<string, unknown>): Promise<void>;
+    agentComplete(_state: Record<string, unknown>, input: TransitionInput<AgentResult>): Promise<void>;
+}
+//# sourceMappingURL=agent-ask-clarification-example.workflow.d.ts.map

package/dist/workflows/agent-ask-clarification/agent-ask-clarification-example.workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-ask-clarification-example.workflow.d.ts","sourceRoot":"","sources":["../../../src/workflows/agent-ask-clarification/agent-ask-clarification-example.workflow.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,WAAW,EAAqB,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtF,OAAO,EAAE,YAAY,EAA+B,KAAK,eAAe,EAAY,MAAM,mBAAmB,CAAC;AAU9G,qBAMa,oCAAqC,SAAQ,YAAY;IACxD,OAAO,CAAC,QAAQ,CAAC,aAAa;gBAAb,aAAa,EAAE,aAAa;IAKnD,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAiBrC,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,eAAe,CAAC,WAAW,CAAC;CAOzF"}

package/dist/workflows/agent-ask-clarification/agent-ask-clarification-example.workflow.js

@@ -0,0 +1,69 @@
+"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.AgentAskClarificationExampleWorkflow = void 0;
+const agent_1 = require("@loopstack/agent");
+const common_1 = require("@loopstack/common");
+const SYSTEM_PROMPT = `You are a trip-planning assistant.
+
+CRITICAL RULES — your response MUST follow these:
+- Before recommending a destination, you MUST know BOTH the user's budget AND their preferred climate.
+- If EITHER is missing from the conversation, your response MUST be exactly ONE tool call to "ask_clarification".
+- Do NOT guess. Do NOT recommend a destination based on partial info.
+- Only after you have received BOTH pieces of information, recommend a single destination as a short paragraph.`;
+let AgentAskClarificationExampleWorkflow = class AgentAskClarificationExampleWorkflow extends common_1.BaseWorkflow {
+    agentWorkflow;
+    constructor(agentWorkflow) {
+        super();
+        this.agentWorkflow = agentWorkflow;
+    }
+    async start(_state) {
+        await this.agentWorkflow.run({
+            system: SYSTEM_PROMPT,
+            tools: ['ask_clarification'],
+            userMessage: 'Where should I go on holiday next month?',
+        }, { callback: { transition: 'agentComplete' }, show: 'inline', label: 'Trip planner working...' });
+    }
+    async agentComplete(_state, input) {
+        await this.documentStore.save(common_1.MessageDocument, {
+            role: 'assistant',
+            text: input.data.response,
+        });
+        this.setResult(input.data);
+    }
+};
+exports.AgentAskClarificationExampleWorkflow = AgentAskClarificationExampleWorkflow;
+__decorate([
+    (0, common_1.Transition)({ to: 'running' }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], AgentAskClarificationExampleWorkflow.prototype, "start", null);
+__decorate([
+    (0, common_1.Transition)({
+        from: 'running',
+        to: 'end',
+        wait: true,
+        schema: agent_1.AgentResultSchema,
+    }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, Object]),
+    __metadata("design:returntype", Promise)
+], AgentAskClarificationExampleWorkflow.prototype, "agentComplete", null);
+exports.AgentAskClarificationExampleWorkflow = AgentAskClarificationExampleWorkflow = __decorate([
+    (0, common_1.Workflow)({
+        title: 'HITL - Agent Ask Clarification Example',
+        description: 'Agent HITL: an LLM agent runs with the ask_clarification tool. When it lacks information, ' +
+            'it pauses the loop and prompts the user; the answer flows back into the agent context.',
+    }),
+    __metadata("design:paramtypes", [agent_1.AgentWorkflow])
+], AgentAskClarificationExampleWorkflow);
+//# sourceMappingURL=agent-ask-clarification-example.workflow.js.map

package/dist/workflows/agent-ask-clarification/agent-ask-clarification-example.workflow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-ask-clarification-example.workflow.js","sourceRoot":"","sources":["../../../src/workflows/agent-ask-clarification/agent-ask-clarification-example.workflow.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,4CAAsF;AACtF,8CAA8G;AAE9G,MAAM,aAAa,GAAG;;;;;;gHAM0F,CAAC;AAQ1G,IAAM,oCAAoC,GAA1C,MAAM,oCAAqC,SAAQ,qBAAY;IACvC;IAA7B,YAA6B,aAA4B;QACvD,KAAK,EAAE,CAAC;QADmB,kBAAa,GAAb,aAAa,CAAe;IAEzD,CAAC;IAGK,AAAN,KAAK,CAAC,KAAK,CAAC,MAA+B;QACzC,MAAM,IAAI,CAAC,aAAa,CAAC,GAAG,CAC1B;YACE,MAAM,EAAE,aAAa;YACrB,KAAK,EAAE,CAAC,mBAAmB,CAAC;YAC5B,WAAW,EAAE,0CAA0C;SACxD,EACD,EAAE,QAAQ,EAAE,EAAE,UAAU,EAAE,eAAe,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,yBAAyB,EAAE,CAChG,CAAC;IACJ,CAAC;IAQK,AAAN,KAAK,CAAC,aAAa,CAAC,MAA+B,EAAE,KAAmC;QACtF,MAAM,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,wBAAe,EAAE;YAC7C,IAAI,EAAE,WAAW;YACjB,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,QAAQ;SAC1B,CAAC,CAAC;QACH,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC;CACF,CAAA;AA9BY,oFAAoC;AAMzC;IADL,IAAA,mBAAU,EAAC,EAAE,EAAE,EAAE,SAAS,EAAE,CAAC;;;;iEAU7B;AAQK;IANL,IAAA,mBAAU,EAAC;QACV,IAAI,EAAE,SAAS;QACf,EAAE,EAAE,KAAK;QACT,IAAI,EAAE,IAAI;QACV,MAAM,EAAE,yBAAiB;KAC1B,CAAC;;;;yEAOD;+CA7BU,oCAAoC;IANhD,IAAA,iBAAQ,EAAC;QACR,KAAK,EAAE,wCAAwC;QAC/C,WAAW,EACT,4FAA4F;YAC5F,wFAAwF;KAC3F,CAAC;qCAE4C,qBAAa;GAD9C,oCAAoC,CA8BhD"}

package/dist/workflows/agent-ask-for-approval/agent-ask-for-approval-example.workflow.d.ts

@@ -0,0 +1,9 @@
+import { type AgentResult, AgentWorkflow } from '@loopstack/agent';
+import { BaseWorkflow, type TransitionInput } from '@loopstack/common';
+export declare class AgentAskForApprovalExampleWorkflow extends BaseWorkflow {
+    private readonly agentWorkflow;
+    constructor(agentWorkflow: AgentWorkflow);
+    start(_state: Record<string, unknown>): Promise<void>;
+    agentComplete(_state: Record<string, unknown>, input: TransitionInput<AgentResult>): Promise<void>;
+}
+//# sourceMappingURL=agent-ask-for-approval-example.workflow.d.ts.map

package/dist/workflows/agent-ask-for-approval/agent-ask-for-approval-example.workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-ask-for-approval-example.workflow.d.ts","sourceRoot":"","sources":["../../../src/workflows/agent-ask-for-approval/agent-ask-for-approval-example.workflow.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,WAAW,EAAqB,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtF,OAAO,EAAE,YAAY,EAAgC,KAAK,eAAe,EAAY,MAAM,mBAAmB,CAAC;AAW/G,qBAMa,kCAAmC,SAAQ,YAAY;IACtD,OAAO,CAAC,QAAQ,CAAC,aAAa;gBAAb,aAAa,EAAE,aAAa;IAKnD,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAkBrC,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,eAAe,CAAC,WAAW,CAAC;CAIzF"}

package/dist/workflows/agent-ask-for-approval/agent-ask-for-approval-example.workflow.js

@@ -0,0 +1,67 @@
+"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.AgentAskForApprovalExampleWorkflow = void 0;
+const agent_1 = require("@loopstack/agent");
+const common_1 = require("@loopstack/common");
+const SYSTEM_PROMPT = `You are a release-notes drafting assistant.
+
+Your task: produce a concise release-notes markdown draft, get explicit user approval via the "ask_for_approval" tool, then output the approved markdown as your final response.
+
+CRITICAL RULES — your response MUST follow these:
+- First turn: respond with exactly ONE tool call to "ask_for_approval". The "concept" argument IS the markdown draft. Do NOT write the draft as plain text in this turn.
+- After approval: your final text response MUST be the approved markdown verbatim, with no preamble, commentary, or trailing text.
+- After denial: respond with a brief one-line note that the draft was rejected.`;
+let AgentAskForApprovalExampleWorkflow = class AgentAskForApprovalExampleWorkflow extends common_1.BaseWorkflow {
+    agentWorkflow;
+    constructor(agentWorkflow) {
+        super();
+        this.agentWorkflow = agentWorkflow;
+    }
+    async start(_state) {
+        await this.agentWorkflow.run({
+            system: SYSTEM_PROMPT,
+            tools: ['ask_for_approval'],
+            userMessage: 'Draft release notes for v1.2.3: added webhook signature verification; fixed a date-parsing bug in the importer.',
+        }, { callback: { transition: 'agentComplete' }, show: 'inline', label: 'Drafting release notes...' });
+    }
+    async agentComplete(_state, input) {
+        await this.documentStore.save(common_1.MarkdownDocument, { markdown: input.data.response });
+        this.setResult(input.data);
+    }
+};
+exports.AgentAskForApprovalExampleWorkflow = AgentAskForApprovalExampleWorkflow;
+__decorate([
+    (0, common_1.Transition)({ to: 'running' }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], AgentAskForApprovalExampleWorkflow.prototype, "start", null);
+__decorate([
+    (0, common_1.Transition)({
+        from: 'running',
+        to: 'end',
+        wait: true,
+        schema: agent_1.AgentResultSchema,
+    }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, Object]),
+    __metadata("design:returntype", Promise)
+], AgentAskForApprovalExampleWorkflow.prototype, "agentComplete", null);
+exports.AgentAskForApprovalExampleWorkflow = AgentAskForApprovalExampleWorkflow = __decorate([
+    (0, common_1.Workflow)({
+        title: 'HITL - Agent Ask For Approval Example',
+        description: 'Agent HITL: an LLM agent drafts content, then calls the ask_for_approval tool to show the markdown ' +
+            'to the user and pause until they confirm or deny.',
+    }),
+    __metadata("design:paramtypes", [agent_1.AgentWorkflow])
+], AgentAskForApprovalExampleWorkflow);
+//# sourceMappingURL=agent-ask-for-approval-example.workflow.js.map

package/dist/workflows/agent-ask-for-approval/agent-ask-for-approval-example.workflow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-ask-for-approval-example.workflow.js","sourceRoot":"","sources":["../../../src/workflows/agent-ask-for-approval/agent-ask-for-approval-example.workflow.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,4CAAsF;AACtF,8CAA+G;AAE/G,MAAM,aAAa,GAAG;;;;;;;gFAO0D,CAAC;AAQ1E,IAAM,kCAAkC,GAAxC,MAAM,kCAAmC,SAAQ,qBAAY;IACrC;IAA7B,YAA6B,aAA4B;QACvD,KAAK,EAAE,CAAC;QADmB,kBAAa,GAAb,aAAa,CAAe;IAEzD,CAAC;IAGK,AAAN,KAAK,CAAC,KAAK,CAAC,MAA+B;QACzC,MAAM,IAAI,CAAC,aAAa,CAAC,GAAG,CAC1B;YACE,MAAM,EAAE,aAAa;YACrB,KAAK,EAAE,CAAC,kBAAkB,CAAC;YAC3B,WAAW,EACT,iHAAiH;SACpH,EACD,EAAE,QAAQ,EAAE,EAAE,UAAU,EAAE,eAAe,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,2BAA2B,EAAE,CAClG,CAAC;IACJ,CAAC;IAQK,AAAN,KAAK,CAAC,aAAa,CAAC,MAA+B,EAAE,KAAmC;QACtF,MAAM,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,yBAAgB,EAAE,EAAE,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;QACnF,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC;CACF,CAAA;AA5BY,gFAAkC;AAMvC;IADL,IAAA,mBAAU,EAAC,EAAE,EAAE,EAAE,SAAS,EAAE,CAAC;;;;+DAW7B;AAQK;IANL,IAAA,mBAAU,EAAC;QACV,IAAI,EAAE,SAAS;QACf,EAAE,EAAE,KAAK;QACT,IAAI,EAAE,IAAI;QACV,MAAM,EAAE,yBAAiB;KAC1B,CAAC;;;;uEAID;6CA3BU,kCAAkC;IAN9C,IAAA,iBAAQ,EAAC;QACR,KAAK,EAAE,uCAAuC;QAC9C,WAAW,EACT,qGAAqG;YACrG,mDAAmD;KACtD,CAAC;qCAE4C,qBAAa;GAD9C,kCAAkC,CA4B9C"}

package/dist/workflows/ask-user-confirm/ask-user-confirm-example.workflow.d.ts

@@ -0,0 +1,11 @@
+import { BaseWorkflow, type TransitionInput } from '@loopstack/common';
+import { AskUserWorkflow } from '@loopstack/hitl';
+export declare class AskUserConfirmExampleWorkflow extends BaseWorkflow {
+    private readonly askUserWorkflow;
+    constructor(askUserWorkflow: AskUserWorkflow);
+    askToSend(_state: Record<string, unknown>): Promise<void>;
+    decisionReceived(state: Record<string, unknown>, input: TransitionInput<{
+        answer: string;
+    }>): Promise<void>;
+}
+//# sourceMappingURL=ask-user-confirm-example.workflow.d.ts.map

package/dist/workflows/ask-user-confirm/ask-user-confirm-example.workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ask-user-confirm-example.workflow.d.ts","sourceRoot":"","sources":["../../../src/workflows/ask-user-confirm/ask-user-confirm-example.workflow.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAA+B,KAAK,eAAe,EAAY,MAAM,mBAAmB,CAAC;AAC9G,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAIlD,qBAMa,6BAA8B,SAAQ,YAAY;IACjD,OAAO,CAAC,QAAQ,CAAC,eAAe;gBAAf,eAAe,EAAE,eAAe;IAKvD,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAazC,gBAAgB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,eAAe,CAAC;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAQlG"}

package/dist/workflows/ask-user-confirm/ask-user-confirm-example.workflow.js

@@ -0,0 +1,61 @@
+"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.AskUserConfirmExampleWorkflow = void 0;
+const zod_1 = require("zod");
+const common_1 = require("@loopstack/common");
+const hitl_1 = require("@loopstack/hitl");
+const AnswerSchema = zod_1.z.object({ answer: zod_1.z.string() });
+let AskUserConfirmExampleWorkflow = class AskUserConfirmExampleWorkflow extends common_1.BaseWorkflow {
+    askUserWorkflow;
+    constructor(askUserWorkflow) {
+        super();
+        this.askUserWorkflow = askUserWorkflow;
+    }
+    async askToSend(_state) {
+        await this.askUserWorkflow.run({ question: 'Send the email now?', mode: 'confirm' }, { callback: { transition: 'decisionReceived' }, show: 'inline', label: 'Waiting for yes/no...' });
+    }
+    async decisionReceived(state, input) {
+        const accepted = input.data.answer === 'yes';
+        await this.documentStore.save(common_1.MessageDocument, {
+            role: 'assistant',
+            text: accepted ? 'Sending the email now.' : 'Skipping — email was not sent.',
+        });
+        this.setResult({ sent: accepted });
+    }
+};
+exports.AskUserConfirmExampleWorkflow = AskUserConfirmExampleWorkflow;
+__decorate([
+    (0, common_1.Transition)({ to: 'waiting_for_yes_no' }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], AskUserConfirmExampleWorkflow.prototype, "askToSend", null);
+__decorate([
+    (0, common_1.Transition)({
+        from: 'waiting_for_yes_no',
+        to: 'end',
+        wait: true,
+        schema: AnswerSchema,
+    }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, Object]),
+    __metadata("design:returntype", Promise)
+], AskUserConfirmExampleWorkflow.prototype, "decisionReceived", null);
+exports.AskUserConfirmExampleWorkflow = AskUserConfirmExampleWorkflow = __decorate([
+    (0, common_1.Workflow)({
+        title: 'HITL - Ask User Confirm Example',
+        description: 'Shortcut HITL: delegate a yes/no decision to AskUserWorkflow with mode "confirm". ' +
+            'The answer comes back as the literal string "yes" or "no".',
+    }),
+    __metadata("design:paramtypes", [hitl_1.AskUserWorkflow])
+], AskUserConfirmExampleWorkflow);
+//# sourceMappingURL=ask-user-confirm-example.workflow.js.map

package/dist/workflows/ask-user-confirm/ask-user-confirm-example.workflow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ask-user-confirm-example.workflow.js","sourceRoot":"","sources":["../../../src/workflows/ask-user-confirm/ask-user-confirm-example.workflow.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,6BAAwB;AACxB,8CAA8G;AAC9G,0CAAkD;AAElD,MAAM,YAAY,GAAG,OAAC,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AAQ/C,IAAM,6BAA6B,GAAnC,MAAM,6BAA8B,SAAQ,qBAAY;IAChC;IAA7B,YAA6B,eAAgC;QAC3D,KAAK,EAAE,CAAC;QADmB,oBAAe,GAAf,eAAe,CAAiB;IAE7D,CAAC;IAGK,AAAN,KAAK,CAAC,SAAS,CAAC,MAA+B;QAC7C,MAAM,IAAI,CAAC,eAAe,CAAC,GAAG,CAC5B,EAAE,QAAQ,EAAE,qBAAqB,EAAE,IAAI,EAAE,SAAS,EAAE,EACpD,EAAE,QAAQ,EAAE,EAAE,UAAU,EAAE,kBAAkB,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,uBAAuB,EAAE,CACjG,CAAC;IACJ,CAAC;IAQK,AAAN,KAAK,CAAC,gBAAgB,CAAC,KAA8B,EAAE,KAA0C;QAC/F,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,KAAK,KAAK,CAAC;QAC7C,MAAM,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,wBAAe,EAAE;YAC7C,IAAI,EAAE,WAAW;YACjB,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,wBAAwB,CAAC,CAAC,CAAC,gCAAgC;SAC7E,CAAC,CAAC;QACH,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAwC,CAAC,CAAC;IAC3E,CAAC;CACF,CAAA;AA3BY,sEAA6B;AAMlC;IADL,IAAA,mBAAU,EAAC,EAAE,EAAE,EAAE,oBAAoB,EAAE,CAAC;;;;8DAMxC;AAQK;IANL,IAAA,mBAAU,EAAC;QACV,IAAI,EAAE,oBAAoB;QAC1B,EAAE,EAAE,KAAK;QACT,IAAI,EAAE,IAAI;QACV,MAAM,EAAE,YAAY;KACrB,CAAC;;;;qEAQD;wCA1BU,6BAA6B;IANzC,IAAA,iBAAQ,EAAC;QACR,KAAK,EAAE,iCAAiC;QACxC,WAAW,EACT,oFAAoF;YACpF,4DAA4D;KAC/D,CAAC;qCAE8C,sBAAe;GADlD,6BAA6B,CA2BzC"}

package/dist/workflows/ask-user-options/ask-user-options-example.workflow.d.ts

@@ -0,0 +1,11 @@
+import { BaseWorkflow, type TransitionInput } from '@loopstack/common';
+import { AskUserWorkflow } from '@loopstack/hitl';
+export declare class AskUserOptionsExampleWorkflow extends BaseWorkflow {
+    private readonly askUserWorkflow;
+    constructor(askUserWorkflow: AskUserWorkflow);
+    askEnvironment(_state: Record<string, unknown>): Promise<void>;
+    choiceReceived(state: Record<string, unknown>, input: TransitionInput<{
+        answer: string;
+    }>): Promise<void>;
+}
+//# sourceMappingURL=ask-user-options-example.workflow.d.ts.map

package/dist/workflows/ask-user-options/ask-user-options-example.workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ask-user-options-example.workflow.d.ts","sourceRoot":"","sources":["../../../src/workflows/ask-user-options/ask-user-options-example.workflow.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAA+B,KAAK,eAAe,EAAY,MAAM,mBAAmB,CAAC;AAC9G,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAMlD,qBAMa,6BAA8B,SAAQ,YAAY;IACjD,OAAO,CAAC,QAAQ,CAAC,eAAe;gBAAf,eAAe,EAAE,eAAe;IAKvD,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAkB9C,cAAc,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,eAAe,CAAC;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAShG"}

package/dist/workflows/ask-user-options/ask-user-options-example.workflow.js

@@ -0,0 +1,68 @@
+"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.AskUserOptionsExampleWorkflow = void 0;
+const zod_1 = require("zod");
+const common_1 = require("@loopstack/common");
+const hitl_1 = require("@loopstack/hitl");
+const AnswerSchema = zod_1.z.object({ answer: zod_1.z.string() });
+const ENV_OPTIONS = ['staging', 'production'];
+let AskUserOptionsExampleWorkflow = class AskUserOptionsExampleWorkflow extends common_1.BaseWorkflow {
+    askUserWorkflow;
+    constructor(askUserWorkflow) {
+        super();
+        this.askUserWorkflow = askUserWorkflow;
+    }
+    async askEnvironment(_state) {
+        await this.askUserWorkflow.run({
+            question: 'Which environment should we deploy to?',
+            mode: 'options',
+            options: ENV_OPTIONS,
+            allowCustomAnswer: true,
+        }, { callback: { transition: 'choiceReceived' }, show: 'inline', label: 'Waiting for choice...' });
+    }
+    async choiceReceived(state, input) {
+        const choice = input.data.answer;
+        const isCustom = !ENV_OPTIONS.includes(choice);
+        await this.documentStore.save(common_1.MessageDocument, {
+            role: 'assistant',
+            text: isCustom ? `Custom environment selected: ${choice}` : `Deploying to ${choice}.`,
+        });
+        this.setResult({ environment: choice, custom: isCustom });
+    }
+};
+exports.AskUserOptionsExampleWorkflow = AskUserOptionsExampleWorkflow;
+__decorate([
+    (0, common_1.Transition)({ to: 'waiting_for_choice' }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], AskUserOptionsExampleWorkflow.prototype, "askEnvironment", null);
+__decorate([
+    (0, common_1.Transition)({
+        from: 'waiting_for_choice',
+        to: 'end',
+        wait: true,
+        schema: AnswerSchema,
+    }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, Object]),
+    __metadata("design:returntype", Promise)
+], AskUserOptionsExampleWorkflow.prototype, "choiceReceived", null);
+exports.AskUserOptionsExampleWorkflow = AskUserOptionsExampleWorkflow = __decorate([
+    (0, common_1.Workflow)({
+        title: 'HITL - Ask User Options Example',
+        description: 'Shortcut HITL: delegate a generic "pick from a list" ask to AskUserWorkflow with mode "options". ' +
+            'allowCustomAnswer adds a free-text field next to the choices.',
+    }),
+    __metadata("design:paramtypes", [hitl_1.AskUserWorkflow])
+], AskUserOptionsExampleWorkflow);
+//# sourceMappingURL=ask-user-options-example.workflow.js.map