@loopstack/hitl 0.4.3 → 0.4.5

package/README.md

@@ -41,12 +41,10 @@ export class MyModule {}
 
 ```typescript
 import { z } from 'zod';
-import { BaseWorkflow, CallbackSchema, MessageDocument, Transition, Workflow } from '@loopstack/common';
+import { BaseWorkflow, MessageDocument, Transition, type TransitionInput, Workflow } from '@loopstack/common';
 import { AskUserWorkflow } from '@loopstack/hitl';
 
-const AnswerCallback = CallbackSchema.extend({
-  data: z.object({ answer: z.string() }),
-});
+const AnswerSchema = z.object({ answer: z.string() });
 
 @Workflow({ title: 'My Workflow' })
 export class MyWorkflow extends BaseWorkflow {
@@ -55,21 +53,19 @@ export class MyWorkflow extends BaseWorkflow {
   }
 
   @Transition({ to: 'waiting' })
-  async start(state: Record<string, unknown>): Promise<Record<string, unknown>> {
+  async start(state: Record<string, unknown>) {
     await this.askUser.run(
       { question: 'What is your name?' },
       { callback: { transition: 'answerReceived' }, show: 'inline', label: 'Waiting for answer...' },
     );
-    return state;
   }
 
-  @Transition({ from: 'waiting', to: 'end', wait: true, schema: AnswerCallback })
-  async answerReceived(state: Record<string, unknown>, payload: z.infer<typeof AnswerCallback>): Promise<unknown> {
+  @Transition({ from: 'waiting', to: 'end', wait: true, schema: AnswerSchema })
+  async answerReceived(state: Record<string, unknown>, input: TransitionInput<{ answer: string }>) {
     await this.documentStore.save(MessageDocument, {
       role: 'assistant',
-      text: `Hello, ${payload.data.answer}!`,
+      text: `Hello, ${input.data.answer}!`,
     });
-    return {};
   }
 }
 ```
@@ -117,7 +113,11 @@ The `show_question` state uses guard-based routing to save the correct document
 - **options** — saves `AskUserOptionsDocument`, renders a choice list
 - **confirm** — saves `AskUserConfirmDocument`, renders yes/no buttons
 
-**Returns:** `{ answer: string }`
+**Immediate return from `.run()`:** `QueueResult` — `{ workflowId: string }`. `.run()` schedules the child and returns synchronously; it does **not** wait for the user. Use `workflowId` to embed the child in the parent's UI via `LinkDocument` (or pass `show: 'inline'` on `.run()` to do this automatically).
+
+**Callback `input.data`:** `{ answer: string }` — delivered as the `data` field of a `TransitionInput<{ answer: string }>` to the wait transition named in `options.callback.transition`. The `schema:` on the wait transition validates `input.data` only; the surrounding envelope (`workflowId`, `status`, `hasError`, `errorMessage`) is added by the framework.
+
+For the full sub-workflow callback pattern — typing `data` via the wait transition schema, branching on `input.hasError` / `input.status`, and embedding the child UI with `show: 'inline'` — see [`@loopstack/run-sub-workflow-example`](https://loopstack.ai/registry/loopstack-run-sub-workflow-example).
 
 #### Multiple-choice and confirmation modes
 
@@ -153,7 +153,9 @@ start → waiting_for_confirmation → end
 
 Two wait transitions (`userConfirmed` / `userDenied`) resolve to different results.
 
-**Returns:** `{ confirmed: boolean, markdown: string }`
+**Immediate return from `.run()`:** `QueueResult` — `{ workflowId: string }`.
+
+**Callback `input.data`:** `{ confirmed: boolean, markdown: string }` — accessed as `input.data.confirmed` / `input.data.markdown` in the wait transition.
 
 ```typescript
 import { ConfirmUserWorkflow } from '@loopstack/hitl';
@@ -179,7 +181,8 @@ Both tools follow the same pattern: launch the corresponding sub-workflow, retur
 | `options`           | `string[]`                         | no       | Choices when mode is `'options'`       |
 | `allowCustomAnswer` | `boolean`                          | no       | Show free-text input alongside options |
 
-**Returns:** `{ answer: string }`
+**Immediate return from `.run()`:** `QueueResult` — `{ workflowId: string }`
+**Callback `input.data`:** `{ answer: string }`
 
 ### ConfirmUserWorkflow
 
@@ -187,7 +190,8 @@ Both tools follow the same pattern: launch the corresponding sub-workflow, retur
 | ---------- | -------- | -------- | ----------------------------------- |
 | `markdown` | `string` | yes      | Markdown content to show for review |
 
-**Returns:** `{ confirmed: boolean, markdown: string }`
+**Immediate return from `.run()`:** `QueueResult` — `{ workflowId: string }`
+**Callback `input.data`:** `{ confirmed: boolean, markdown: string }`
 
 ## Tools Reference
 
@@ -229,8 +233,7 @@ Present markdown content to the user for approval. Pauses the agent until the us
 ## Related
 
 - [Human-in-the-Loop Patterns](https://loopstack.ai/docs/build/patterns/human-in-the-loop) — wait transitions, document actions, conditional widgets
-- [hitl-ask-user-example-workflow](https://loopstack.ai/registry/loopstack-hitl-ask-user-example-workflow) — AskUserWorkflow example with callback
-- [hitl-confirm-example-workflow](https://loopstack.ai/registry/loopstack-hitl-confirm-example-workflow) — ConfirmUserWorkflow example with confirm/deny
+- [hitl-examples](https://loopstack.ai/registry/loopstack-hitl-examples) — comprehensive HITL examples: custom document with widget, AskUserWorkflow / ConfirmUserWorkflow shortcuts, and agent-tool flows
 
 ## About
 

package/dist/documents/ask-user-confirm-document.js

@@ -18,7 +18,7 @@ let AskUserConfirmDocument = class AskUserConfirmDocument {
 };
 AskUserConfirmDocument = __decorate([
     Document({
-        widget: import.meta.dirname + '/ask-user-confirm-document.yaml',
+        widget: './ask-user-confirm-document.yaml',
         schema: AskUserConfirmDocumentSchema,
     })
 ], AskUserConfirmDocument);

package/dist/documents/ask-user-confirm-document.js.map

@@ -1 +1 @@
-{"version":3,"file":"ask-user-confirm-document.js","sourceRoot":"","sources":["../../src/documents/ask-user-confirm-document.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAE7C,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC;KAC1C,MAAM,CAAC;IACN,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC9B,CAAC;KACD,MAAM,EAAE,CAAC;AAQL,IAAM,sBAAsB,GAA5B,MAAM,sBAAsB;IACjC,QAAQ,CAAS;IACjB,MAAM,CAAU;CACjB,CAAA;AAHY,sBAAsB;IAJlC,QAAQ,CAAC;QACR,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,GAAG,iCAAiC;QAC/D,MAAM,EAAE,4BAA4B;KACrC,CAAC;GACW,sBAAsB,CAGlC"}
+{"version":3,"file":"ask-user-confirm-document.js","sourceRoot":"","sources":["../../src/documents/ask-user-confirm-document.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAE7C,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC;KAC1C,MAAM,CAAC;IACN,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC9B,CAAC;KACD,MAAM,EAAE,CAAC;AAQL,IAAM,sBAAsB,GAA5B,MAAM,sBAAsB;IACjC,QAAQ,CAAS;IACjB,MAAM,CAAU;CACjB,CAAA;AAHY,sBAAsB;IAJlC,QAAQ,CAAC;QACR,MAAM,EAAE,kCAAkC;QAC1C,MAAM,EAAE,4BAA4B;KACrC,CAAC;GACW,sBAAsB,CAGlC"}

package/dist/documents/ask-user-document.js

@@ -18,7 +18,7 @@ let AskUserDocument = class AskUserDocument {
 };
 AskUserDocument = __decorate([
     Document({
-        widget: import.meta.dirname + '/ask-user-document.yaml',
+        widget: './ask-user-document.yaml',
         schema: AskUserDocumentSchema,
     })
 ], AskUserDocument);

package/dist/documents/ask-user-document.js.map

@@ -1 +1 @@
-{"version":3,"file":"ask-user-document.js","sourceRoot":"","sources":["../../src/documents/ask-user-document.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAE7C,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC;KACnC,MAAM,CAAC;IACN,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC9B,CAAC;KACD,MAAM,EAAE,CAAC;AAQL,IAAM,eAAe,GAArB,MAAM,eAAe;IAC1B,QAAQ,CAAS;IACjB,MAAM,CAAU;CACjB,CAAA;AAHY,eAAe;IAJ3B,QAAQ,CAAC;QACR,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,GAAG,yBAAyB;QACvD,MAAM,EAAE,qBAAqB;KAC9B,CAAC;GACW,eAAe,CAG3B"}
+{"version":3,"file":"ask-user-document.js","sourceRoot":"","sources":["../../src/documents/ask-user-document.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAE7C,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC;KACnC,MAAM,CAAC;IACN,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC9B,CAAC;KACD,MAAM,EAAE,CAAC;AAQL,IAAM,eAAe,GAArB,MAAM,eAAe;IAC1B,QAAQ,CAAS;IACjB,MAAM,CAAU;CACjB,CAAA;AAHY,eAAe;IAJ3B,QAAQ,CAAC;QACR,MAAM,EAAE,0BAA0B;QAClC,MAAM,EAAE,qBAAqB;KAC9B,CAAC;GACW,eAAe,CAG3B"}

package/dist/documents/ask-user-options-document.js

@@ -22,7 +22,7 @@ let AskUserOptionsDocument = class AskUserOptionsDocument {
 };
 AskUserOptionsDocument = __decorate([
     Document({
-        widget: import.meta.dirname + '/ask-user-options-document.yaml',
+        widget: './ask-user-options-document.yaml',
         schema: AskUserOptionsDocumentSchema,
     })
 ], AskUserOptionsDocument);

package/dist/documents/ask-user-options-document.js.map

@@ -1 +1 @@
-{"version":3,"file":"ask-user-options-document.js","sourceRoot":"","sources":["../../src/documents/ask-user-options-document.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAE7C,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC;KAC1C,MAAM,CAAC;IACN,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAC5B,iBAAiB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACzC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC9B,CAAC;KACD,MAAM,EAAE,CAAC;AAQL,IAAM,sBAAsB,GAA5B,MAAM,sBAAsB;IACjC,QAAQ,CAAS;IACjB,OAAO,CAAW;IAClB,iBAAiB,CAAW;IAC5B,MAAM,CAAU;CACjB,CAAA;AALY,sBAAsB;IAJlC,QAAQ,CAAC;QACR,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,GAAG,iCAAiC;QAC/D,MAAM,EAAE,4BAA4B;KACrC,CAAC;GACW,sBAAsB,CAKlC"}
+{"version":3,"file":"ask-user-options-document.js","sourceRoot":"","sources":["../../src/documents/ask-user-options-document.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAE7C,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC;KAC1C,MAAM,CAAC;IACN,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAC5B,iBAAiB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACzC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC9B,CAAC;KACD,MAAM,EAAE,CAAC;AAQL,IAAM,sBAAsB,GAA5B,MAAM,sBAAsB;IACjC,QAAQ,CAAS;IACjB,OAAO,CAAW;IAClB,iBAAiB,CAAW;IAC5B,MAAM,CAAU;CACjB,CAAA;AALY,sBAAsB;IAJlC,QAAQ,CAAC;QACR,MAAM,EAAE,kCAAkC;QAC1C,MAAM,EAAE,4BAA4B;KACrC,CAAC;GACW,sBAAsB,CAKlC"}

package/dist/documents/confirm-user-document.js

@@ -16,7 +16,7 @@ let ConfirmUserDocument = class ConfirmUserDocument {
 };
 ConfirmUserDocument = __decorate([
     Document({
-        widget: import.meta.dirname + '/confirm-user-document.yaml',
+        widget: './confirm-user-document.yaml',
         schema: ConfirmUserDocumentSchema,
     })
 ], ConfirmUserDocument);

package/dist/documents/confirm-user-document.js.map

@@ -1 +1 @@
-{"version":3,"file":"confirm-user-document.js","sourceRoot":"","sources":["../../src/documents/confirm-user-document.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAE7C,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC;KACvC,MAAM,CAAC;IACN,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;CACrB,CAAC;KACD,MAAM,EAAE,CAAC;AAQL,IAAM,mBAAmB,GAAzB,MAAM,mBAAmB;IAC9B,QAAQ,CAAS;CAClB,CAAA;AAFY,mBAAmB;IAJ/B,QAAQ,CAAC;QACR,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,GAAG,6BAA6B;QAC3D,MAAM,EAAE,yBAAyB;KAClC,CAAC;GACW,mBAAmB,CAE/B"}
+{"version":3,"file":"confirm-user-document.js","sourceRoot":"","sources":["../../src/documents/confirm-user-document.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAE7C,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC;KACvC,MAAM,CAAC;IACN,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;CACrB,CAAC;KACD,MAAM,EAAE,CAAC;AAQL,IAAM,mBAAmB,GAAzB,MAAM,mBAAmB;IAC9B,QAAQ,CAAS;CAClB,CAAA;AAFY,mBAAmB;IAJ/B,QAAQ,CAAC;QACR,MAAM,EAAE,8BAA8B;QACtC,MAAM,EAAE,yBAAyB;KAClC,CAAC;GACW,mBAAmB,CAE/B"}

package/dist/tools/ask-clarification.tool.d.ts

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { BaseTool, ToolCallOptions, ToolResult } from '@loopstack/common';
+import { BaseTool, ToolCallOptions, ToolEnvelope } from '@loopstack/common';
 import type { RunContext } from '@loopstack/common';
 import { AskUserWorkflow } from '../workflows/ask-user/ask-user.workflow.js';
 declare const AskClarificationInputSchema: z.ZodObject<{
@@ -19,8 +19,8 @@ export type AskClarificationResult = {
 export declare class AskClarificationTool extends BaseTool<AskClarificationInput, object, AskClarificationResult> {
     private readonly askUserWorkflow;
     constructor(askUserWorkflow: AskUserWorkflow);
-    protected handle(args: AskClarificationInput, ctx: RunContext, options?: ToolCallOptions): Promise<ToolResult<AskClarificationResult>>;
-    complete(result: Record<string, unknown>): Promise<ToolResult<AskClarificationResult>>;
+    protected handle(args: AskClarificationInput, ctx: RunContext, options?: ToolCallOptions): Promise<ToolEnvelope<AskClarificationResult>>;
+    complete(result: Record<string, unknown>): Promise<ToolEnvelope<AskClarificationResult>>;
 }
 export {};
 //# sourceMappingURL=ask-clarification.tool.d.ts.map

package/dist/tools/ask-clarification.tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ask-clarification.tool.d.ts","sourceRoot":"","sources":["../../src/tools/ask-clarification.tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAQ,eAAe,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAChF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,4CAA4C,CAAC;AAE7E,QAAA,MAAM,2BAA2B;;;;;;;;;kBAyBtB,CAAC;AAEZ,KAAK,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEzE,MAAM,MAAM,sBAAsB,GAAG;IAAE,UAAU,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE/F,qBAQa,oBAAqB,SAAQ,QAAQ,CAAC,qBAAqB,EAAE,MAAM,EAAE,sBAAsB,CAAC;IAC3F,OAAO,CAAC,QAAQ,CAAC,eAAe;gBAAf,eAAe,EAAE,eAAe;cAI7C,MAAM,CACpB,IAAI,EAAE,qBAAqB,EAC3B,GAAG,EAAE,UAAU,EACf,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,UAAU,CAAC,sBAAsB,CAAC,CAAC;IAiBxC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC,sBAAsB,CAAC,CAAC;CAI7F"}
+{"version":3,"file":"ask-clarification.tool.d.ts","sourceRoot":"","sources":["../../src/tools/ask-clarification.tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAQ,eAAe,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAClF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,4CAA4C,CAAC;AAE7E,QAAA,MAAM,2BAA2B;;;;;;;;;kBAyBtB,CAAC;AAEZ,KAAK,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEzE,MAAM,MAAM,sBAAsB,GAAG;IAAE,UAAU,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE/F,qBAQa,oBAAqB,SAAQ,QAAQ,CAAC,qBAAqB,EAAE,MAAM,EAAE,sBAAsB,CAAC;IAC3F,OAAO,CAAC,QAAQ,CAAC,eAAe;gBAAf,eAAe,EAAE,eAAe;cAI7C,MAAM,CACpB,IAAI,EAAE,qBAAqB,EAC3B,GAAG,EAAE,UAAU,EACf,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,YAAY,CAAC,sBAAsB,CAAC,CAAC;IAiB1C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC,sBAAsB,CAAC,CAAC;CAI/F"}

package/dist/tools/ask-clarification.tool.js.map

@@ -1 +1 @@
-{"version":3,"file":"ask-clarification.tool.js","sourceRoot":"","sources":["../../src/tools/ask-clarification.tool.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,IAAI,EAA+B,MAAM,mBAAmB,CAAC;AAEhF,OAAO,EAAE,eAAe,EAAE,MAAM,4CAA4C,CAAC;AAE7E,MAAM,2BAA2B,GAAG,CAAC;KAClC,MAAM,CAAC;IACN,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,QAAQ,CAAC,kGAAkG,CAAC;IAC/G,IAAI,EAAE,CAAC;SACJ,IAAI,CAAC,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;SACpC,QAAQ,EAAE;SACV,QAAQ,CACP,2EAA2E;QACzE,+DAA+D;QAC/D,mCAAmC,CACtC;IACH,OAAO,EAAE,CAAC;SACP,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;SACjB,QAAQ,EAAE;SACV,QAAQ,CAAC,8EAA8E,CAAC;IAC3F,iBAAiB,EAAE,CAAC;SACjB,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,QAAQ,CACP,4EAA4E;QAC1E,0DAA0D,CAC7D;CACJ,CAAC;KACD,MAAM,EAAE,CAAC;AAcL,IAAM,oBAAoB,GAA1B,MAAM,oBAAqB,SAAQ,QAA+D;IAC1E;IAA7B,YAA6B,eAAgC;QAC3D,KAAK,EAAE,CAAC;QADmB,oBAAe,GAAf,eAAe,CAAiB;IAE7D,CAAC;IAES,KAAK,CAAC,MAAM,CACpB,IAA2B,EAC3B,GAAe,EACf,OAAyB;QAEzB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,GAAG,CAC3C;YACE,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,iBAAiB,EAAE,IAAI,CAAC,iBAAiB;SAC1C,EACD,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,4BAA4B,EAAE,CACrF,CAAC;QAEF,OAAO;YACL,IAAI,EAAE,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE;YACvC,OAAO,EAAE,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE;SAC3C,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,MAA+B;QAC5C,MAAM,IAAI,GAAG,MAAwC,CAAC;QACtD,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,IAAI,MAAM,EAAE,CAAC;IAC/C,CAAC;CACF,CAAA;AA9BY,oBAAoB;IARhC,IAAI,CAAC;QACJ,IAAI,EAAE,mBAAmB;QACzB,WAAW,EACT,mEAAmE;YACnE,gFAAgF;YAChF,8DAA8D;QAChE,MAAM,EAAE,2BAA2B;KACpC,CAAC;qCAE8C,eAAe;GADlD,oBAAoB,CA8BhC"}
+{"version":3,"file":"ask-clarification.tool.js","sourceRoot":"","sources":["../../src/tools/ask-clarification.tool.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAiC,MAAM,mBAAmB,CAAC;AAElF,OAAO,EAAE,eAAe,EAAE,MAAM,4CAA4C,CAAC;AAE7E,MAAM,2BAA2B,GAAG,CAAC;KAClC,MAAM,CAAC;IACN,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,QAAQ,CAAC,kGAAkG,CAAC;IAC/G,IAAI,EAAE,CAAC;SACJ,IAAI,CAAC,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;SACpC,QAAQ,EAAE;SACV,QAAQ,CACP,2EAA2E;QACzE,+DAA+D;QAC/D,mCAAmC,CACtC;IACH,OAAO,EAAE,CAAC;SACP,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;SACjB,QAAQ,EAAE;SACV,QAAQ,CAAC,8EAA8E,CAAC;IAC3F,iBAAiB,EAAE,CAAC;SACjB,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,QAAQ,CACP,4EAA4E;QAC1E,0DAA0D,CAC7D;CACJ,CAAC;KACD,MAAM,EAAE,CAAC;AAcL,IAAM,oBAAoB,GAA1B,MAAM,oBAAqB,SAAQ,QAA+D;IAC1E;IAA7B,YAA6B,eAAgC;QAC3D,KAAK,EAAE,CAAC;QADmB,oBAAe,GAAf,eAAe,CAAiB;IAE7D,CAAC;IAES,KAAK,CAAC,MAAM,CACpB,IAA2B,EAC3B,GAAe,EACf,OAAyB;QAEzB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,GAAG,CAC3C;YACE,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,iBAAiB,EAAE,IAAI,CAAC,iBAAiB;SAC1C,EACD,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,4BAA4B,EAAE,CACrF,CAAC;QAEF,OAAO;YACL,IAAI,EAAE,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE;YACvC,OAAO,EAAE,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE;SAC3C,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,MAA+B;QAC5C,MAAM,IAAI,GAAG,MAAwC,CAAC;QACtD,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,IAAI,MAAM,EAAE,CAAC;IAC/C,CAAC;CACF,CAAA;AA9BY,oBAAoB;IARhC,IAAI,CAAC;QACJ,IAAI,EAAE,mBAAmB;QACzB,WAAW,EACT,mEAAmE;YACnE,gFAAgF;YAChF,8DAA8D;QAChE,MAAM,EAAE,2BAA2B;KACpC,CAAC;qCAE8C,eAAe;GADlD,oBAAoB,CA8BhC"}

package/dist/tools/ask-for-approval.tool.d.ts

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { BaseTool, ToolCallOptions, ToolResult } from '@loopstack/common';
+import { BaseTool, ToolCallOptions, ToolEnvelope } from '@loopstack/common';
 import type { RunContext } from '@loopstack/common';
 import { ConfirmUserWorkflow } from '../workflows/confirm-user/confirm-user.workflow.js';
 declare const AskForApprovalInputSchema: z.ZodObject<{
@@ -16,8 +16,8 @@ export type AskForApprovalResult = {
 export declare class AskForApprovalTool extends BaseTool<AskForApprovalInput, object, AskForApprovalResult> {
     private readonly confirmUserWorkflow;
     constructor(confirmUserWorkflow: ConfirmUserWorkflow);
-    protected handle(args: AskForApprovalInput, ctx: RunContext, options?: ToolCallOptions): Promise<ToolResult<AskForApprovalResult>>;
-    complete(result: Record<string, unknown>): Promise<ToolResult<AskForApprovalResult>>;
+    protected handle(args: AskForApprovalInput, ctx: RunContext, options?: ToolCallOptions): Promise<ToolEnvelope<AskForApprovalResult>>;
+    complete(result: Record<string, unknown>): Promise<ToolEnvelope<AskForApprovalResult>>;
 }
 export {};
 //# sourceMappingURL=ask-for-approval.tool.d.ts.map

package/dist/tools/ask-for-approval.tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ask-for-approval.tool.d.ts","sourceRoot":"","sources":["../../src/tools/ask-for-approval.tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAQ,eAAe,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAChF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,oDAAoD,CAAC;AAEzF,QAAA,MAAM,yBAAyB;;kBAIpB,CAAC;AAEZ,KAAK,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAErE,MAAM,MAAM,oBAAoB,GAAG;IAAE,UAAU,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,OAAO,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,GAAG;IAAE,MAAM,EAAE,IAAI,CAAA;CAAE,CAAC;AAE/G,qBAQa,kBAAmB,SAAQ,QAAQ,CAAC,mBAAmB,EAAE,MAAM,EAAE,oBAAoB,CAAC;IACrF,OAAO,CAAC,QAAQ,CAAC,mBAAmB;gBAAnB,mBAAmB,EAAE,mBAAmB;cAIrD,MAAM,CACpB,IAAI,EAAE,mBAAmB,EACzB,GAAG,EAAE,UAAU,EACf,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,UAAU,CAAC,oBAAoB,CAAC,CAAC;IAYtC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC,oBAAoB,CAAC,CAAC;CAK3F"}
+{"version":3,"file":"ask-for-approval.tool.d.ts","sourceRoot":"","sources":["../../src/tools/ask-for-approval.tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAQ,eAAe,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAClF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,oDAAoD,CAAC;AAEzF,QAAA,MAAM,yBAAyB;;kBAIpB,CAAC;AAEZ,KAAK,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAErE,MAAM,MAAM,oBAAoB,GAAG;IAAE,UAAU,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,OAAO,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,GAAG;IAAE,MAAM,EAAE,IAAI,CAAA;CAAE,CAAC;AAE/G,qBAQa,kBAAmB,SAAQ,QAAQ,CAAC,mBAAmB,EAAE,MAAM,EAAE,oBAAoB,CAAC;IACrF,OAAO,CAAC,QAAQ,CAAC,mBAAmB;gBAAnB,mBAAmB,EAAE,mBAAmB;cAIrD,MAAM,CACpB,IAAI,EAAE,mBAAmB,EACzB,GAAG,EAAE,UAAU,EACf,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,YAAY,CAAC,oBAAoB,CAAC,CAAC;IAYxC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC,oBAAoB,CAAC,CAAC;CAK7F"}

package/dist/tools/ask-for-approval.tool.js.map

@@ -1 +1 @@
-{"version":3,"file":"ask-for-approval.tool.js","sourceRoot":"","sources":["../../src/tools/ask-for-approval.tool.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,IAAI,EAA+B,MAAM,mBAAmB,CAAC;AAEhF,OAAO,EAAE,mBAAmB,EAAE,MAAM,oDAAoD,CAAC;AAEzF,MAAM,yBAAyB,GAAG,CAAC;KAChC,MAAM,CAAC;IACN,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sEAAsE,CAAC;CACrG,CAAC;KACD,MAAM,EAAE,CAAC;AAcL,IAAM,kBAAkB,GAAxB,MAAM,kBAAmB,SAAQ,QAA2D;IACpE;IAA7B,YAA6B,mBAAwC;QACnE,KAAK,EAAE,CAAC;QADmB,wBAAmB,GAAnB,mBAAmB,CAAqB;IAErE,CAAC;IAES,KAAK,CAAC,MAAM,CACpB,IAAyB,EACzB,GAAe,EACf,OAAyB;QAEzB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAC/C,EAAE,QAAQ,EAAE,IAAI,CAAC,OAAO,EAAE,EAC1B,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,yBAAyB,EAAE,CAClF,CAAC;QAEF,OAAO;YACL,IAAI,EAAE,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE;YACvC,OAAO,EAAE,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE;SAC3C,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,MAA+B;QAC5C,MAAM,IAAI,GAAG,MAA8D,CAAC;QAC5E,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,EAAE,SAAS,IAAI,KAAK,CAAC;QAC/C,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC;IAClF,CAAC;CACF,CAAA;AA1BY,kBAAkB;IAR9B,IAAI,CAAC;QACJ,IAAI,EAAE,kBAAkB;QACxB,WAAW,EACT,iGAAiG;YACjG,oFAAoF;YACpF,8DAA8D;QAChE,MAAM,EAAE,yBAAyB;KAClC,CAAC;qCAEkD,mBAAmB;GAD1D,kBAAkB,CA0B9B"}
+{"version":3,"file":"ask-for-approval.tool.js","sourceRoot":"","sources":["../../src/tools/ask-for-approval.tool.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAiC,MAAM,mBAAmB,CAAC;AAElF,OAAO,EAAE,mBAAmB,EAAE,MAAM,oDAAoD,CAAC;AAEzF,MAAM,yBAAyB,GAAG,CAAC;KAChC,MAAM,CAAC;IACN,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sEAAsE,CAAC;CACrG,CAAC;KACD,MAAM,EAAE,CAAC;AAcL,IAAM,kBAAkB,GAAxB,MAAM,kBAAmB,SAAQ,QAA2D;IACpE;IAA7B,YAA6B,mBAAwC;QACnE,KAAK,EAAE,CAAC;QADmB,wBAAmB,GAAnB,mBAAmB,CAAqB;IAErE,CAAC;IAES,KAAK,CAAC,MAAM,CACpB,IAAyB,EACzB,GAAe,EACf,OAAyB;QAEzB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAC/C,EAAE,QAAQ,EAAE,IAAI,CAAC,OAAO,EAAE,EAC1B,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,yBAAyB,EAAE,CAClF,CAAC;QAEF,OAAO;YACL,IAAI,EAAE,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE;YACvC,OAAO,EAAE,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE;SAC3C,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,MAA+B;QAC5C,MAAM,IAAI,GAAG,MAA8D,CAAC;QAC5E,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,EAAE,SAAS,IAAI,KAAK,CAAC;QAC/C,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC;IAClF,CAAC;CACF,CAAA;AA1BY,kBAAkB;IAR9B,IAAI,CAAC;QACJ,IAAI,EAAE,kBAAkB;QACxB,WAAW,EACT,iGAAiG;YACjG,oFAAoF;YACpF,8DAA8D;QAChE,MAAM,EAAE,yBAAyB;KAClC,CAAC;qCAEkD,mBAAmB;GAD1D,kBAAkB,CA0B9B"}

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

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import type { RunContext } from '@loopstack/common';
+import type { RunContext, TransitionInput } from '@loopstack/common';
 import { BaseWorkflow } from '@loopstack/common';
 declare const AskUserArgsSchema: z.ZodObject<{
     question: z.ZodString;
@@ -13,16 +13,14 @@ declare const AskUserArgsSchema: z.ZodObject<{
 }, z.core.$strip>;
 type AskUserArgs = z.infer<typeof AskUserArgsSchema>;
 type AskUserState = AskUserArgs;
-export declare class AskUserWorkflow extends BaseWorkflow<AskUserArgs, AskUserState> {
-    start(state: AskUserState, ctx: RunContext): Promise<AskUserState>;
-    showQuestionOptions(state: AskUserState): Promise<AskUserState>;
-    showQuestionConfirm(state: AskUserState): Promise<AskUserState>;
-    showQuestionText(state: AskUserState): Promise<AskUserState>;
-    userAnswered(state: AskUserState, payload: {
+export declare class AskUserWorkflow extends BaseWorkflow<AskUserArgs> {
+    start(state: AskUserState, ctx: RunContext<AskUserArgs>): void;
+    showQuestionOptions(state: AskUserState): Promise<void>;
+    showQuestionConfirm(state: AskUserState): Promise<void>;
+    showQuestionText(state: AskUserState): Promise<void>;
+    userAnswered(state: AskUserState, input: TransitionInput<{
         answer: string;
-    }): Promise<{
-        answer: string;
-    }>;
+    }>): Promise<void>;
     private isOptionsMode;
     private isConfirmMode;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"ask-user.workflow.d.ts","sourceRoot":"","sources":["../../../src/workflows/ask-user/ask-user.workflow.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,YAAY,EAA+B,MAAM,mBAAmB,CAAC;AAK9E,QAAA,MAAM,iBAAiB;;;;;;;;;iBAKrB,CAAC;AAEH,KAAK,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAMrD,KAAK,YAAY,GAAG,WAAW,CAAC;AAEhC,qBAMa,eAAgB,SAAQ,YAAY,CAAC,WAAW,EAAE,YAAY,CAAC;IAEpE,KAAK,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,YAAY,CAAC;IAOlE,mBAAmB,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;IAW/D,mBAAmB,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;IAM/D,gBAAgB,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;IAM5D,YAAY,CAAC,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IA6BjG,OAAO,CAAC,aAAa;IAMrB,OAAO,CAAC,aAAa;CAGtB"}
+{"version":3,"file":"ask-user.workflow.d.ts","sourceRoot":"","sources":["../../../src/workflows/ask-user/ask-user.workflow.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACrE,OAAO,EAAE,YAAY,EAA+B,MAAM,mBAAmB,CAAC;AAK9E,QAAA,MAAM,iBAAiB;;;;;;;;;iBAKrB,CAAC;AAEH,KAAK,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAMrD,KAAK,YAAY,GAAG,WAAW,CAAC;AAEhC,qBAOa,eAAgB,SAAQ,YAAY,CAAC,WAAW,CAAC;IAE5D,KAAK,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,EAAE,UAAU,CAAC,WAAW,CAAC;IAMjD,mBAAmB,CAAC,KAAK,EAAE,YAAY;IAUvC,mBAAmB,CAAC,KAAK,EAAE,YAAY;IAKvC,gBAAgB,CAAC,KAAK,EAAE,YAAY;IAKpC,YAAY,CAAC,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,eAAe,CAAC;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IA6BlF,OAAO,CAAC,aAAa;IAMrB,OAAO,CAAC,aAAa;CAGtB"}

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

@@ -22,38 +22,34 @@ const AskUserAnswerSchema = z.object({
     answer: z.string(),
 });
 let AskUserWorkflow = class AskUserWorkflow extends BaseWorkflow {
-    async start(state, ctx) {
-        const args = ctx.args;
-        return { ...state, ...args };
+    start(state, ctx) {
+        this.assignState({ ...ctx.args });
     }
     async showQuestionOptions(state) {
-        await this.documentStore.save(AskUserOptionsDocument, { question: state.question, options: state.options ?? [], allowCustomAnswer: state.allowCustomAnswer }, { id: 'question' });
-        return state;
+        await this.documentStore.save(AskUserOptionsDocument, { question: state.question, options: state.options ?? [], allowCustomAnswer: state.allowCustomAnswer }, { key: 'question' });
     }
     async showQuestionConfirm(state) {
-        await this.documentStore.save(AskUserConfirmDocument, { question: state.question }, { id: 'question' });
-        return state;
+        await this.documentStore.save(AskUserConfirmDocument, { question: state.question }, { key: 'question' });
     }
     async showQuestionText(state) {
-        await this.documentStore.save(AskUserDocument, { question: state.question }, { id: 'question' });
-        return state;
+        await this.documentStore.save(AskUserDocument, { question: state.question }, { key: 'question' });
     }
-    async userAnswered(state, payload) {
+    async userAnswered(state, input) {
         if (state.mode === 'options') {
             await this.documentStore.save(AskUserOptionsDocument, {
                 question: state.question,
                 options: state.options ?? [],
                 allowCustomAnswer: state.allowCustomAnswer,
-                answer: payload.answer,
-            }, { id: 'question' });
+                answer: input.data.answer,
+            }, { key: 'question' });
         }
         else if (state.mode === 'confirm') {
-            await this.documentStore.save(AskUserConfirmDocument, { question: state.question, answer: payload.answer }, { id: 'question' });
+            await this.documentStore.save(AskUserConfirmDocument, { question: state.question, answer: input.data.answer }, { key: 'question' });
         }
         else {
-            await this.documentStore.save(AskUserDocument, { question: state.question, answer: payload.answer }, { id: 'question' });
+            await this.documentStore.save(AskUserDocument, { question: state.question, answer: input.data.answer }, { key: 'question' });
         }
-        return { answer: payload.answer };
+        this.setResult({ answer: input.data.answer });
     }
     isOptionsMode(state) {
         return (state.mode === 'options' || (state.mode === undefined && Array.isArray(state.options) && state.options.length > 0));
@@ -66,7 +62,7 @@ __decorate([
     Transition({ to: 'show_question' }),
     __metadata("design:type", Function),
     __metadata("design:paramtypes", [Object, Object]),
-    __metadata("design:returntype", Promise)
+    __metadata("design:returntype", void 0)
 ], AskUserWorkflow.prototype, "start", null);
 __decorate([
     Transition({ from: 'show_question', to: 'waiting_for_user', priority: 10 }),
@@ -96,6 +92,7 @@ __decorate([
 ], AskUserWorkflow.prototype, "userAnswered", null);
 AskUserWorkflow = __decorate([
     Workflow({
+        name: 'ask_user',
         title: 'Ask User',
         description: 'Generic sub-workflow that presents a question to the user and waits for their answer.\nUsed by async tool calls (e.g. askClarification) to interrupt an agent loop for user input.\nSupports three modes: text (default), options (pick from a list), and confirm (yes/no).',
         schema: AskUserArgsSchema,

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

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

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

@@ -1,20 +1,17 @@
+import { z } from 'zod';
 import type { RunContext } from '@loopstack/common';
 import { BaseWorkflow } from '@loopstack/common';
 interface ConfirmUserState {
     markdown: string;
 }
-export declare class ConfirmUserWorkflow extends BaseWorkflow<{
-    markdown: string;
-}, ConfirmUserState> {
-    showContent(state: ConfirmUserState, ctx: RunContext): Promise<ConfirmUserState>;
-    userConfirmed(state: ConfirmUserState): Promise<{
-        confirmed: boolean;
-        markdown: string;
-    }>;
-    userDenied(state: ConfirmUserState): Promise<{
-        confirmed: boolean;
-        markdown: string;
-    }>;
+declare const ConfirmUserArgsSchema: z.ZodObject<{
+    markdown: z.ZodString;
+}, z.core.$strip>;
+type ConfirmUserArgs = z.infer<typeof ConfirmUserArgsSchema>;
+export declare class ConfirmUserWorkflow extends BaseWorkflow<ConfirmUserArgs> {
+    showContent(state: ConfirmUserState, ctx: RunContext<ConfirmUserArgs>): Promise<void>;
+    userConfirmed(state: ConfirmUserState): void;
+    userDenied(state: ConfirmUserState): void;
 }
 export {};
 //# sourceMappingURL=confirm-user.workflow.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"confirm-user.workflow.d.ts","sourceRoot":"","sources":["../../../src/workflows/confirm-user/confirm-user.workflow.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAwB,MAAM,mBAAmB,CAAC;AAGvE,UAAU,gBAAgB;IACxB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,qBAQa,mBAAoB,SAAQ,YAAY,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,EAAE,gBAAgB,CAAC;IAErF,WAAW,CAAC,KAAK,EAAE,gBAAgB,EAAE,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAOhF,aAAa,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC;QAAE,SAAS,EAAE,OAAO,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAKzF,UAAU,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC;QAAE,SAAS,EAAE,OAAO,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;CAG7F"}
+{"version":3,"file":"confirm-user.workflow.d.ts","sourceRoot":"","sources":["../../../src/workflows/confirm-user/confirm-user.workflow.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAwB,MAAM,mBAAmB,CAAC;AAGvE,UAAU,gBAAgB;IACxB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,QAAA,MAAM,qBAAqB;;iBAEzB,CAAC;AAEH,KAAK,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAE7D,qBAOa,mBAAoB,SAAQ,YAAY,CAAC,eAAe,CAAC;IAE9D,WAAW,CAAC,KAAK,EAAE,gBAAgB,EAAE,GAAG,EAAE,UAAU,CAAC,eAAe,CAAC;IAM3E,aAAa,CAAC,KAAK,EAAE,gBAAgB;IAKrC,UAAU,CAAC,KAAK,EAAE,gBAAgB;CAGnC"}

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

@@ -10,17 +10,19 @@ var __metadata = (this && this.__metadata) || function (k, v) {
 import { z } from 'zod';
 import { BaseWorkflow, Transition, Workflow } from '@loopstack/common';
 import { ConfirmUserDocument } from '../../documents/confirm-user-document.js';
+const ConfirmUserArgsSchema = z.object({
+    markdown: z.string(),
+});
 let ConfirmUserWorkflow = class ConfirmUserWorkflow extends BaseWorkflow {
     async showContent(state, ctx) {
-        const args = ctx.args;
-        await this.documentStore.save(ConfirmUserDocument, { markdown: args.markdown }, { id: 'content' });
-        return { ...state, markdown: args.markdown };
+        await this.documentStore.save(ConfirmUserDocument, { markdown: ctx.args.markdown }, { key: 'content' });
+        this.assignState({ markdown: ctx.args.markdown });
     }
-    async userConfirmed(state) {
-        return Promise.resolve({ confirmed: true, markdown: state.markdown });
+    userConfirmed(state) {
+        this.setResult({ confirmed: true, markdown: state.markdown });
     }
-    async userDenied(state) {
-        return Promise.resolve({ confirmed: false, markdown: state.markdown });
+    userDenied(state) {
+        this.setResult({ confirmed: false, markdown: state.markdown });
     }
 };
 __decorate([
@@ -33,21 +35,20 @@ __decorate([
     Transition({ from: 'waiting_for_confirmation', to: 'end', wait: true }),
     __metadata("design:type", Function),
     __metadata("design:paramtypes", [Object]),
-    __metadata("design:returntype", Promise)
+    __metadata("design:returntype", void 0)
 ], ConfirmUserWorkflow.prototype, "userConfirmed", null);
 __decorate([
     Transition({ from: 'waiting_for_confirmation', to: 'end', wait: true }),
     __metadata("design:type", Function),
     __metadata("design:paramtypes", [Object]),
-    __metadata("design:returntype", Promise)
+    __metadata("design:returntype", void 0)
 ], ConfirmUserWorkflow.prototype, "userDenied", null);
 ConfirmUserWorkflow = __decorate([
     Workflow({
+        name: 'confirm_user',
         title: 'Confirm User',
         description: 'Generic sub-workflow that presents markdown content to the user and waits for confirmation.\nUsed by async tool calls (e.g. askForApproval) to get explicit user confirmation.',
-        schema: z.object({
-            markdown: z.string(),
-        }),
+        schema: ConfirmUserArgsSchema,
     })
 ], ConfirmUserWorkflow);
 export { ConfirmUserWorkflow };

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

@@ -1 +1 @@
-{"version":3,"file":"confirm-user.workflow.js","sourceRoot":"","sources":["../../../src/workflows/confirm-user/confirm-user.workflow.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AACvE,OAAO,EAAE,mBAAmB,EAAE,MAAM,0CAA0C,CAAC;AAcxE,IAAM,mBAAmB,GAAzB,MAAM,mBAAoB,SAAQ,YAAoD;IAErF,AAAN,KAAK,CAAC,WAAW,CAAC,KAAuB,EAAE,GAAe;QACxD,MAAM,IAAI,GAAG,GAAG,CAAC,IAA4B,CAAC;QAC9C,MAAM,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,mBAAmB,EAAE,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,EAAE,EAAE,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;QACnG,OAAO,EAAE,GAAG,KAAK,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC;IAC/C,CAAC;IAGK,AAAN,KAAK,CAAC,aAAa,CAAC,KAAuB;QACzC,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;IACxE,CAAC;IAGK,AAAN,KAAK,CAAC,UAAU,CAAC,KAAuB;QACtC,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;IACzE,CAAC;CACF,CAAA;AAfO;IADL,UAAU,CAAC,EAAE,EAAE,EAAE,0BAA0B,EAAE,CAAC;;;;sDAK9C;AAGK;IADL,UAAU,CAAC,EAAE,IAAI,EAAE,0BAA0B,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;;;;wDAGvE;AAGK;IADL,UAAU,CAAC,EAAE,IAAI,EAAE,0BAA0B,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;;;;qDAGvE;AAhBU,mBAAmB;IAR/B,QAAQ,CAAC;QACR,KAAK,EAAE,cAAc;QACrB,WAAW,EACT,gLAAgL;QAClL,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;YACf,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;SACrB,CAAC;KACH,CAAC;GACW,mBAAmB,CAiB/B"}
+{"version":3,"file":"confirm-user.workflow.js","sourceRoot":"","sources":["../../../src/workflows/confirm-user/confirm-user.workflow.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AACvE,OAAO,EAAE,mBAAmB,EAAE,MAAM,0CAA0C,CAAC;AAM/E,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;CACrB,CAAC,CAAC;AAWI,IAAM,mBAAmB,GAAzB,MAAM,mBAAoB,SAAQ,YAA6B;IAE9D,AAAN,KAAK,CAAC,WAAW,CAAC,KAAuB,EAAE,GAAgC;QACzE,MAAM,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,mBAAmB,EAAE,EAAE,QAAQ,EAAE,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC,CAAC;QACxG,IAAI,CAAC,WAAW,CAAC,EAAE,QAAQ,EAAE,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;IACpD,CAAC;IAGD,aAAa,CAAC,KAAuB;QACnC,IAAI,CAAC,SAAS,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAwC,CAAC,CAAC;IACtG,CAAC;IAGD,UAAU,CAAC,KAAuB;QAChC,IAAI,CAAC,SAAS,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAwC,CAAC,CAAC;IACvG,CAAC;CACF,CAAA;AAdO;IADL,UAAU,CAAC,EAAE,EAAE,EAAE,0BAA0B,EAAE,CAAC;;;;sDAI9C;AAGD;IADC,UAAU,CAAC,EAAE,IAAI,EAAE,0BAA0B,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;;;;wDAGvE;AAGD;IADC,UAAU,CAAC,EAAE,IAAI,EAAE,0BAA0B,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;;;;qDAGvE;AAfU,mBAAmB;IAP/B,QAAQ,CAAC;QACR,IAAI,EAAE,cAAc;QACpB,KAAK,EAAE,cAAc;QACrB,WAAW,EACT,gLAAgL;QAClL,MAAM,EAAE,qBAAqB;KAC9B,CAAC;GACW,mBAAmB,CAgB/B"}

package/package.json

@@ -9,7 +9,7 @@
     "workflow",
     "user-input"
   ],
-  "version": "0.4.3",
+  "version": "0.4.5",
   "license": "MIT",
   "author": {
     "name": "Jakob Klippel",
@@ -32,8 +32,8 @@
     "watch": "nest build --watch"
   },
   "dependencies": {
-    "@loopstack/common": "^0.34.0",
-    "@loopstack/core": "^0.34.0"
+    "@loopstack/common": "^0.36.0",
+    "@loopstack/core": "^0.36.0"
   },
   "devDependencies": {
     "@nestjs/common": "^11.1.19",