@loopstack/hitl 0.1.1 → 0.2.0

package/README.md

@@ -0,0 +1,110 @@
+# @loopstack/hitl
+
+> A module for the [Loopstack AI](https://loopstack.ai) automation framework.
+
+Human-in-the-loop (HITL) building blocks for Loopstack workflows. Pause a running workflow, ask the user a question, and resume once they answer.
+
+## Overview
+
+Most non-trivial workflows need a human decision at some point — "is this the right file?", "do you want to proceed?", "pick one of these options". This module provides two ready-to-use workflows that handle the wait-for-user pattern, along with the document types that render the prompts in the UI.
+
+By using this module you'll get:
+
+- **`AskUserWorkflow`** — asks a free-text question, a yes/no confirmation, or a multiple-choice question (mode is a runtime arg)
+- **`ConfirmUserWorkflow`** — shows markdown content and waits for a confirm / deny response
+- **4 document types** that render the prompts: `AskUserDocument`, `AskUserConfirmDocument`, `AskUserOptionsDocument`, `ConfirmUserDocument`
+
+## Installation
+
+```sh
+npm install @loopstack/hitl
+```
+
+Register the module:
+
+```ts
+import { HitlModule } from '@loopstack/hitl';
+
+@Module({
+  imports: [HitlModule /* ... */],
+})
+export class AppModule {}
+```
+
+## How It Works
+
+### Asking a text question as a sub-workflow
+
+Use `@InjectWorkflow()` to launch `AskUserWorkflow` from a parent workflow. The call resolves with the user's answer once they respond in the UI:
+
+```ts
+import { BaseWorkflow, InjectWorkflow, Transition, Workflow } from '@loopstack/common';
+import { AskUserWorkflow } from '@loopstack/hitl';
+
+@Workflow({ uiConfig: __dirname + '/my.ui.yaml' })
+export class MyWorkflow extends BaseWorkflow {
+  @InjectWorkflow() askUser: AskUserWorkflow;
+
+  @Transition({ from: 'ready', to: 'done' })
+  async collectName() {
+    const { answer } = await this.askUser.run({ question: 'What is your name?' }, { alias: 'askName' });
+    // use `answer`
+  }
+}
+```
+
+### Multiple-choice and confirmation modes
+
+`AskUserWorkflow` takes an optional `mode`:
+
+```ts
+await this.askUser.run({
+  question: 'Which environment?',
+  mode: 'options',
+  options: ['staging', 'production'],
+  allowCustomAnswer: false,
+});
+
+await this.askUser.run({
+  question: 'Proceed with deletion?',
+  mode: 'confirm',
+});
+```
+
+### Showing long-form content for confirmation
+
+`ConfirmUserWorkflow` is for "review and confirm" flows where you want to render markdown (e.g. a summary) and get a confirm / deny response:
+
+```ts
+import { ConfirmUserWorkflow } from '@loopstack/hitl';
+
+const { confirmed } = await this.confirmUser.run({
+  markdown: '## About to commit\n\n- 3 files changed',
+});
+```
+
+### Documents
+
+Each workflow saves one of the document types on the workflow repository — the Studio UI picks up those documents and renders the corresponding input widget. You generally don't need to interact with the document classes directly, but they're exported if you want to query or post-process answers.
+
+## Public API
+
+- **Module:** `HitlModule`
+- **Workflows:** `AskUserWorkflow`, `ConfirmUserWorkflow`
+- **Documents:** `AskUserDocument`, `AskUserConfirmDocument`, `AskUserOptionsDocument`, `ConfirmUserDocument`
+
+## Dependencies
+
+- `@loopstack/common` — `BaseWorkflow`, decorators
+- `@loopstack/core` — `LoopCoreModule`
+
+## About
+
+Author: [Jakob Klippel](https://www.linkedin.com/in/jakob-klippel/)
+
+License: MIT
+
+### Additional Resources
+
+- [Loopstack Documentation](https://loopstack.ai/docs)
+- Find more Loopstack modules in the [Loopstack Registry](https://loopstack.ai/registry)

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

@@ -1 +1 @@
-{"version":3,"file":"hitl.module.d.ts","sourceRoot":"","sources":["../src/hitl.module.ts"],"names":[],"mappings":"AAKA,qBAKa,UAAU;CAAG"}
+{"version":3,"file":"hitl.module.d.ts","sourceRoot":"","sources":["../src/hitl.module.ts"],"names":[],"mappings":"AAOA,qBAKa,UAAU;CAAG"}

package/dist/hitl.module.js

@@ -9,6 +9,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.HitlModule = void 0;
 const common_1 = require("@nestjs/common");
 const core_1 = require("@loopstack/core");
+const ask_clarification_tool_1 = require("./tools/ask-clarification.tool");
+const ask_for_approval_tool_1 = require("./tools/ask-for-approval.tool");
 const ask_user_workflow_1 = require("./workflows/ask-user/ask-user.workflow");
 const confirm_user_workflow_1 = require("./workflows/confirm-user/confirm-user.workflow");
 let HitlModule = class HitlModule {
@@ -17,8 +19,8 @@ exports.HitlModule = HitlModule;
 exports.HitlModule = HitlModule = __decorate([
     (0, common_1.Module)({
         imports: [core_1.LoopCoreModule],
-        providers: [ask_user_workflow_1.AskUserWorkflow, confirm_user_workflow_1.ConfirmUserWorkflow],
-        exports: [ask_user_workflow_1.AskUserWorkflow, confirm_user_workflow_1.ConfirmUserWorkflow],
+        providers: [ask_user_workflow_1.AskUserWorkflow, confirm_user_workflow_1.ConfirmUserWorkflow, ask_clarification_tool_1.AskClarificationTool, ask_for_approval_tool_1.AskForApprovalTool],
+        exports: [ask_user_workflow_1.AskUserWorkflow, confirm_user_workflow_1.ConfirmUserWorkflow, ask_clarification_tool_1.AskClarificationTool, ask_for_approval_tool_1.AskForApprovalTool],
     })
 ], HitlModule);
 //# sourceMappingURL=hitl.module.js.map

package/dist/hitl.module.js.map

@@ -1 +1 @@
-{"version":3,"file":"hitl.module.js","sourceRoot":"","sources":["../src/hitl.module.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAAwC;AACxC,0CAAiD;AACjD,8EAAyE;AACzE,0FAAqF;AAO9E,IAAM,UAAU,GAAhB,MAAM,UAAU;CAAG,CAAA;AAAb,gCAAU;qBAAV,UAAU;IALtB,IAAA,eAAM,EAAC;QACN,OAAO,EAAE,CAAC,qBAAc,CAAC;QACzB,SAAS,EAAE,CAAC,mCAAe,EAAE,2CAAmB,CAAC;QACjD,OAAO,EAAE,CAAC,mCAAe,EAAE,2CAAmB,CAAC;KAChD,CAAC;GACW,UAAU,CAAG"}
+{"version":3,"file":"hitl.module.js","sourceRoot":"","sources":["../src/hitl.module.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAAwC;AACxC,0CAAiD;AACjD,2EAAsE;AACtE,yEAAmE;AACnE,8EAAyE;AACzE,0FAAqF;AAO9E,IAAM,UAAU,GAAhB,MAAM,UAAU;CAAG,CAAA;AAAb,gCAAU;qBAAV,UAAU;IALtB,IAAA,eAAM,EAAC;QACN,OAAO,EAAE,CAAC,qBAAc,CAAC;QACzB,SAAS,EAAE,CAAC,mCAAe,EAAE,2CAAmB,EAAE,6CAAoB,EAAE,0CAAkB,CAAC;QAC3F,OAAO,EAAE,CAAC,mCAAe,EAAE,2CAAmB,EAAE,6CAAoB,EAAE,0CAAkB,CAAC;KAC1F,CAAC;GACW,UAAU,CAAG"}

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 export * from './documents';
+export * from './tools';
 export * from './workflows';
 export * from './hitl.module';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC"}

package/dist/index.js

@@ -15,6 +15,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./documents"), exports);
+__exportStar(require("./tools"), exports);
 __exportStar(require("./workflows"), exports);
 __exportStar(require("./hitl.module"), exports);
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8CAA4B;AAC5B,8CAA4B;AAC5B,gDAA8B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8CAA4B;AAC5B,0CAAwB;AACxB,8CAA4B;AAC5B,gDAA8B"}

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

@@ -0,0 +1,20 @@
+import { z } from 'zod';
+import { BaseTool, ToolCallOptions, ToolResult } from '@loopstack/common';
+declare const AskClarificationInputSchema: z.ZodObject<{
+    question: z.ZodString;
+    mode: z.ZodOptional<z.ZodEnum<{
+        options: "options";
+        text: "text";
+        confirm: "confirm";
+    }>>;
+    options: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    allowCustomAnswer: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>;
+type AskClarificationInput = z.infer<typeof AskClarificationInputSchema>;
+export declare class AskClarificationTool extends BaseTool {
+    private askUser;
+    call(args: AskClarificationInput, options?: ToolCallOptions): Promise<ToolResult>;
+    complete(result: Record<string, unknown>): Promise<ToolResult>;
+}
+export {};
+//# sourceMappingURL=ask-clarification.tool.d.ts.map

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

@@ -0,0 +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,EAAsC,eAAe,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAG9G,QAAA,MAAM,2BAA2B;;;;;;;;;kBAyBtB,CAAC;AAEZ,KAAK,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEzE,qBASa,oBAAqB,SAAQ,QAAQ;IAC9B,OAAO,CAAC,OAAO,CAAkB;IAE7C,IAAI,CAAC,IAAI,EAAE,qBAAqB,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC;IAyBjF,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC;CAWrE"}

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

@@ -0,0 +1,75 @@
+"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.AskClarificationTool = void 0;
+const zod_1 = require("zod");
+const common_1 = require("@loopstack/common");
+const ask_user_workflow_1 = require("../workflows/ask-user/ask-user.workflow");
+const AskClarificationInputSchema = zod_1.z
+    .object({
+    question: zod_1.z
+        .string()
+        .describe('The clarification question to ask the user. Be specific about what information you need and why.'),
+    mode: zod_1.z
+        .enum(['text', 'options', 'confirm'])
+        .optional()
+        .describe('How the question is presented. "text" (default) shows a free-text input. ' +
+        '"options" shows a list of choices for the user to pick from. ' +
+        '"confirm" shows Yes / No buttons.'),
+    options: zod_1.z
+        .array(zod_1.z.string())
+        .optional()
+        .describe('The list of choices when mode is "options". Required when mode is "options".'),
+    allowCustomAnswer: zod_1.z
+        .boolean()
+        .optional()
+        .describe('When mode is "options", set to true to show an additional free-text input ' +
+        'so the user can provide a custom answer not in the list.'),
+})
+    .strict();
+let AskClarificationTool = class AskClarificationTool extends common_1.BaseTool {
+    askUser;
+    async call(args, options) {
+        const result = await this.askUser.run({
+            question: args.question,
+            mode: args.mode,
+            options: args.options,
+            allowCustomAnswer: args.allowCustomAnswer,
+        }, { alias: 'askUser', callback: options?.callback });
+        const workflowId = result.workflowId;
+        await this.repository.save(common_1.LinkDocument, { status: 'pending', label: 'Waiting for user answer...', workflowId, embed: true, expanded: true }, { id: `ask_clarification_link_${workflowId}` });
+        return {
+            data: { workflowId },
+            pending: { workflowId },
+        };
+    }
+    async complete(result) {
+        const data = result;
+        await this.repository.save(common_1.LinkDocument, { status: 'success', label: 'User answered', workflowId: data.workflowId, embed: true, expanded: false }, { id: `ask_clarification_link_${data.workflowId}` });
+        return { data: data.data?.answer ?? result };
+    }
+};
+exports.AskClarificationTool = AskClarificationTool;
+__decorate([
+    (0, common_1.InjectWorkflow)(),
+    __metadata("design:type", ask_user_workflow_1.AskUserWorkflow)
+], AskClarificationTool.prototype, "askUser", void 0);
+exports.AskClarificationTool = AskClarificationTool = __decorate([
+    (0, common_1.Tool)({
+        uiConfig: {
+            description: 'Ask the user a clarification question and wait for their answer. ' +
+                'Use this when you need more information from the user before you can proceed. ' +
+                'IMPORTANT: This must be the only tool call in your response.',
+        },
+        schema: AskClarificationInputSchema,
+    })
+], AskClarificationTool);
+//# sourceMappingURL=ask-clarification.tool.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ask-clarification.tool.js","sourceRoot":"","sources":["../../src/tools/ask-clarification.tool.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,6BAAwB;AACxB,8CAA8G;AAC9G,+EAA0E;AAE1E,MAAM,2BAA2B,GAAG,OAAC;KAClC,MAAM,CAAC;IACN,QAAQ,EAAE,OAAC;SACR,MAAM,EAAE;SACR,QAAQ,CAAC,kGAAkG,CAAC;IAC/G,IAAI,EAAE,OAAC;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,OAAC;SACP,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC;SACjB,QAAQ,EAAE;SACV,QAAQ,CAAC,8EAA8E,CAAC;IAC3F,iBAAiB,EAAE,OAAC;SACjB,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,QAAQ,CACP,4EAA4E;QAC1E,0DAA0D,CAC7D;CACJ,CAAC;KACD,MAAM,EAAE,CAAC;AAaL,IAAM,oBAAoB,GAA1B,MAAM,oBAAqB,SAAQ,iBAAQ;IACtB,OAAO,CAAkB;IAEnD,KAAK,CAAC,IAAI,CAAC,IAA2B,EAAE,OAAyB;QAC/D,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CACnC;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,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,CAClD,CAAC;QAEF,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;QAErC,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,CACxB,qBAAY,EACZ,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,4BAA4B,EAAE,UAAU,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,EACnG,EAAE,EAAE,EAAE,0BAA0B,UAAU,EAAE,EAAE,CAC/C,CAAC;QAEF,OAAO;YACL,IAAI,EAAE,EAAE,UAAU,EAAE;YACpB,OAAO,EAAE,EAAE,UAAU,EAAE;SACxB,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,MAA+B;QAC5C,MAAM,IAAI,GAAG,MAA6D,CAAC;QAE3E,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,CACxB,qBAAY,EACZ,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,eAAe,EAAE,UAAU,EAAE,IAAI,CAAC,UAAW,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,EACzG,EAAE,EAAE,EAAE,0BAA0B,IAAI,CAAC,UAAU,EAAE,EAAE,CACpD,CAAC;QAEF,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,IAAI,MAAM,EAAE,CAAC;IAC/C,CAAC;CACF,CAAA;AAvCY,oDAAoB;AACL;IAAzB,IAAA,uBAAc,GAAE;8BAAkB,mCAAe;qDAAC;+BADxC,oBAAoB;IAThC,IAAA,aAAI,EAAC;QACJ,QAAQ,EAAE;YACR,WAAW,EACT,mEAAmE;gBACnE,gFAAgF;gBAChF,8DAA8D;SACjE;QACD,MAAM,EAAE,2BAA2B;KACpC,CAAC;GACW,oBAAoB,CAuChC"}

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

@@ -0,0 +1,13 @@
+import { z } from 'zod';
+import { BaseTool, ToolCallOptions, ToolResult } from '@loopstack/common';
+declare const AskForApprovalInputSchema: z.ZodObject<{
+    concept: z.ZodString;
+}, z.core.$strict>;
+type AskForApprovalInput = z.infer<typeof AskForApprovalInputSchema>;
+export declare class AskForApprovalTool extends BaseTool {
+    private confirmUser;
+    call(args: AskForApprovalInput, options?: ToolCallOptions): Promise<ToolResult>;
+    complete(result: Record<string, unknown>): Promise<ToolResult>;
+}
+export {};
+//# sourceMappingURL=ask-for-approval.tool.d.ts.map

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

@@ -0,0 +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,EAAsC,eAAe,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAG9G,QAAA,MAAM,yBAAyB;;kBAIpB,CAAC;AAEZ,KAAK,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAErE,qBASa,kBAAmB,SAAQ,QAAQ;IAC5B,OAAO,CAAC,WAAW,CAAsB;IAErD,IAAI,CAAC,IAAI,EAAE,mBAAmB,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC;IAoB/E,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC;CAkBrE"}

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

@@ -0,0 +1,60 @@
+"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.AskForApprovalTool = void 0;
+const zod_1 = require("zod");
+const common_1 = require("@loopstack/common");
+const confirm_user_workflow_1 = require("../workflows/confirm-user/confirm-user.workflow");
+const AskForApprovalInputSchema = zod_1.z
+    .object({
+    concept: zod_1.z.string().describe('The final concept as a markdown string to present for user approval.'),
+})
+    .strict();
+let AskForApprovalTool = class AskForApprovalTool extends common_1.BaseTool {
+    confirmUser;
+    async call(args, options) {
+        const result = await this.confirmUser.run({ markdown: args.concept }, { alias: 'confirmUser', callback: options?.callback });
+        const workflowId = result.workflowId;
+        await this.repository.save(common_1.LinkDocument, { status: 'pending', label: 'Waiting for approval...', workflowId, embed: true, expanded: true }, { id: `ask_for_approval_link_${workflowId}` });
+        return {
+            data: { workflowId },
+            pending: { workflowId },
+        };
+    }
+    async complete(result) {
+        const data = result;
+        const approved = data.data?.confirmed ?? false;
+        await this.repository.save(common_1.LinkDocument, {
+            status: approved ? 'success' : 'failure',
+            label: approved ? 'Concept approved' : 'Concept denied',
+            workflowId: data.workflowId,
+            embed: true,
+            expanded: false,
+        }, { id: `ask_for_approval_link_${data.workflowId}` });
+        return { data: approved ? { concept: data.data?.markdown } : { denied: true } };
+    }
+};
+exports.AskForApprovalTool = AskForApprovalTool;
+__decorate([
+    (0, common_1.InjectWorkflow)(),
+    __metadata("design:type", confirm_user_workflow_1.ConfirmUserWorkflow)
+], AskForApprovalTool.prototype, "confirmUser", void 0);
+exports.AskForApprovalTool = AskForApprovalTool = __decorate([
+    (0, common_1.Tool)({
+        uiConfig: {
+            description: 'Present the final concept to the user for approval. The concept is shown as formatted markdown ' +
+                'with a confirm button. Call this when the user indicates the concept is complete. ' +
+                'IMPORTANT: This must be the only tool call in your response.',
+        },
+        schema: AskForApprovalInputSchema,
+    })
+], AskForApprovalTool);
+//# sourceMappingURL=ask-for-approval.tool.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ask-for-approval.tool.js","sourceRoot":"","sources":["../../src/tools/ask-for-approval.tool.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,6BAAwB;AACxB,8CAA8G;AAC9G,2FAAsF;AAEtF,MAAM,yBAAyB,GAAG,OAAC;KAChC,MAAM,CAAC;IACN,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sEAAsE,CAAC;CACrG,CAAC;KACD,MAAM,EAAE,CAAC;AAaL,IAAM,kBAAkB,GAAxB,MAAM,kBAAmB,SAAQ,iBAAQ;IACpB,WAAW,CAAsB;IAE3D,KAAK,CAAC,IAAI,CAAC,IAAyB,EAAE,OAAyB;QAC7D,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,GAAG,CACvC,EAAE,QAAQ,EAAE,IAAI,CAAC,OAAO,EAAE,EAC1B,EAAE,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,CACtD,CAAC;QAEF,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;QAErC,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,CACxB,qBAAY,EACZ,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,yBAAyB,EAAE,UAAU,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,EAChG,EAAE,EAAE,EAAE,yBAAyB,UAAU,EAAE,EAAE,CAC9C,CAAC;QAEF,OAAO;YACL,IAAI,EAAE,EAAE,UAAU,EAAE;YACpB,OAAO,EAAE,EAAE,UAAU,EAAE;SACxB,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,MAA+B;QAC5C,MAAM,IAAI,GAAG,MAAmF,CAAC;QACjG,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,EAAE,SAAS,IAAI,KAAK,CAAC;QAE/C,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,CACxB,qBAAY,EACZ;YACE,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS;YACxC,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,gBAAgB;YACvD,UAAU,EAAE,IAAI,CAAC,UAAW;YAC5B,KAAK,EAAE,IAAI;YACX,QAAQ,EAAE,KAAK;SAChB,EACD,EAAE,EAAE,EAAE,yBAAyB,IAAI,CAAC,UAAU,EAAE,EAAE,CACnD,CAAC;QAEF,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;AAzCY,gDAAkB;AACH;IAAzB,IAAA,uBAAc,GAAE;8BAAsB,2CAAmB;uDAAC;6BADhD,kBAAkB;IAT9B,IAAA,aAAI,EAAC;QACJ,QAAQ,EAAE;YACR,WAAW,EACT,iGAAiG;gBACjG,oFAAoF;gBACpF,8DAA8D;SACjE;QACD,MAAM,EAAE,yBAAyB;KAClC,CAAC;GACW,kBAAkB,CAyC9B"}

package/dist/tools/index.d.ts

@@ -0,0 +1,3 @@
+export { AskClarificationTool } from './ask-clarification.tool';
+export { AskForApprovalTool } from './ask-for-approval.tool';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/tools/index.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AskForApprovalTool = exports.AskClarificationTool = void 0;
+var ask_clarification_tool_1 = require("./ask-clarification.tool");
+Object.defineProperty(exports, "AskClarificationTool", { enumerable: true, get: function () { return ask_clarification_tool_1.AskClarificationTool; } });
+var ask_for_approval_tool_1 = require("./ask-for-approval.tool");
+Object.defineProperty(exports, "AskForApprovalTool", { enumerable: true, get: function () { return ask_for_approval_tool_1.AskForApprovalTool; } });
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":";;;AAAA,mEAAgE;AAAvD,8HAAA,oBAAoB,OAAA;AAC7B,iEAA6D;AAApD,2HAAA,kBAAkB,OAAA"}

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":"AACA,OAAO,EAAE,YAAY,EAA+C,MAAM,mBAAmB,CAAC;AAS9F,qBASa,eAAgB,SAAQ,YAAY;IAE/C,KAAK;IAIC,mBAAmB;IAenB,mBAAmB;IAMnB,gBAAgB;IAMhB,YAAY,CAAC,OAAO,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAuB5E,OAAO,CAAC,aAAa;IAIrB,OAAO,CAAC,aAAa;CAGtB"}
+{"version":3,"file":"ask-user.workflow.d.ts","sourceRoot":"","sources":["../../../src/workflows/ask-user/ask-user.workflow.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAA+C,MAAM,mBAAmB,CAAC;AAS9F,qBASa,eAAgB,SAAQ,YAAY;IAE/C,KAAK;IAIC,mBAAmB;IAenB,mBAAmB;IAMnB,gBAAgB;IAMhB,YAAY,CAAC,OAAO,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAuB5E,OAAO,CAAC,aAAa;IAOrB,OAAO,CAAC,aAAa;CAGtB"}

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

@@ -46,7 +46,8 @@ let AskUserWorkflow = class AskUserWorkflow extends common_1.BaseWorkflow {
         return { answer: payload.answer };
     }
     isOptionsMode() {
-        return this.ctx.args?.mode === 'options';
+        const args = this.ctx.args;
+        return (args?.mode === 'options' || (args?.mode === undefined && Array.isArray(args?.options) && args.options.length > 0));
     }
     isConfirmMode() {
         return this.ctx.args?.mode === 'confirm';

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/package.json

@@ -9,7 +9,7 @@
     "workflow",
     "user-input"
   ],
-  "version": "0.1.1",
+  "version": "0.2.0",
   "license": "MIT",
   "author": {
     "name": "Jakob Klippel",
@@ -18,8 +18,7 @@
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "exports": {
-    ".": "./dist/index.js",
-    "./src/*": "./src/*"
+    ".": "./dist/index.js"
   },
   "scripts": {
     "build": "nest build",
@@ -30,14 +29,13 @@
     "watch": "nest build --watch"
   },
   "dependencies": {
-    "@loopstack/common": "^0.27.0",
-    "@loopstack/core": "^0.27.0",
+    "@loopstack/common": "^0.28.0",
+    "@loopstack/core": "^0.28.0",
     "@nestjs/common": "^11.1.19",
     "zod": "^4.3.6"
   },
   "files": [
-    "dist",
-    "src"
+    "dist"
   ],
   "jest": {
     "moduleFileExtensions": [
@@ -65,7 +63,6 @@
       }
     ],
     "installModes": [
-      "add",
       "install"
     ]
   }

package/src/documents/ask-user-confirm-document.ts

@@ -1,20 +0,0 @@
-import { z } from 'zod';
-import { Document } from '@loopstack/common';
-
-export const AskUserConfirmDocumentSchema = z
-  .object({
-    question: z.string(),
-    answer: z.string().optional(),
-  })
-  .strict();
-
-export type AskUserConfirmDocumentType = z.infer<typeof AskUserConfirmDocumentSchema>;
-
-@Document({
-  uiConfig: __dirname + '/ask-user-confirm-document.yaml',
-  schema: AskUserConfirmDocumentSchema,
-})
-export class AskUserConfirmDocument {
-  question: string;
-  answer?: string;
-}

package/src/documents/ask-user-confirm-document.yaml

@@ -1,6 +0,0 @@
-type: document
-ui:
-  widgets:
-    - widget: confirm-prompt
-      options:
-        transition: userAnswered

package/src/documents/ask-user-document.ts

@@ -1,20 +0,0 @@
-import { z } from 'zod';
-import { Document } from '@loopstack/common';
-
-export const AskUserDocumentSchema = z
-  .object({
-    question: z.string(),
-    answer: z.string().optional(),
-  })
-  .strict();
-
-export type AskUserDocumentType = z.infer<typeof AskUserDocumentSchema>;
-
-@Document({
-  uiConfig: __dirname + '/ask-user-document.yaml',
-  schema: AskUserDocumentSchema,
-})
-export class AskUserDocument {
-  question: string;
-  answer?: string;
-}

package/src/documents/ask-user-document.yaml

@@ -1,6 +0,0 @@
-type: document
-ui:
-  widgets:
-    - widget: text-prompt
-      options:
-        transition: userAnswered

package/src/documents/ask-user-options-document.ts

@@ -1,24 +0,0 @@
-import { z } from 'zod';
-import { Document } from '@loopstack/common';
-
-export const AskUserOptionsDocumentSchema = z
-  .object({
-    question: z.string(),
-    options: z.array(z.string()),
-    allowCustomAnswer: z.boolean().optional(),
-    answer: z.string().optional(),
-  })
-  .strict();
-
-export type AskUserOptionsDocumentType = z.infer<typeof AskUserOptionsDocumentSchema>;
-
-@Document({
-  uiConfig: __dirname + '/ask-user-options-document.yaml',
-  schema: AskUserOptionsDocumentSchema,
-})
-export class AskUserOptionsDocument {
-  question: string;
-  options: string[];
-  allowCustomAnswer?: boolean;
-  answer?: string;
-}

package/src/documents/ask-user-options-document.yaml

@@ -1,6 +0,0 @@
-type: document
-ui:
-  widgets:
-    - widget: choices
-      options:
-        transition: userAnswered

package/src/documents/confirm-user-document.ts

@@ -1,18 +0,0 @@
-import { z } from 'zod';
-import { Document } from '@loopstack/common';
-
-export const ConfirmUserDocumentSchema = z
-  .object({
-    markdown: z.string(),
-  })
-  .strict();
-
-export type ConfirmUserDocumentType = z.infer<typeof ConfirmUserDocumentSchema>;
-
-@Document({
-  uiConfig: __dirname + '/confirm-user-document.yaml',
-  schema: ConfirmUserDocumentSchema,
-})
-export class ConfirmUserDocument {
-  markdown: string;
-}

package/src/documents/confirm-user-document.yaml

@@ -1,16 +0,0 @@
-type: document
-ui:
-  widgets:
-    - widget: form
-      options:
-        properties:
-          markdown:
-            widget: markdown-view
-        actions:
-          - type: button
-            transition: userDenied
-            label: 'Deny'
-            variant: outline
-          - type: button
-            transition: userConfirmed
-            label: 'Confirm'

package/src/documents/index.ts

@@ -1,12 +0,0 @@
-export { AskUserDocument, AskUserDocumentSchema, AskUserDocumentType } from './ask-user-document';
-export {
-  AskUserConfirmDocument,
-  AskUserConfirmDocumentSchema,
-  AskUserConfirmDocumentType,
-} from './ask-user-confirm-document';
-export {
-  AskUserOptionsDocument,
-  AskUserOptionsDocumentSchema,
-  AskUserOptionsDocumentType,
-} from './ask-user-options-document';
-export { ConfirmUserDocument, ConfirmUserDocumentSchema, ConfirmUserDocumentType } from './confirm-user-document';

package/src/hitl.module.ts

@@ -1,11 +0,0 @@
-import { Module } from '@nestjs/common';
-import { LoopCoreModule } from '@loopstack/core';
-import { AskUserWorkflow } from './workflows/ask-user/ask-user.workflow';
-import { ConfirmUserWorkflow } from './workflows/confirm-user/confirm-user.workflow';
-
-@Module({
-  imports: [LoopCoreModule],
-  providers: [AskUserWorkflow, ConfirmUserWorkflow],
-  exports: [AskUserWorkflow, ConfirmUserWorkflow],
-})
-export class HitlModule {}

package/src/index.ts

@@ -1,3 +0,0 @@
-export * from './documents';
-export * from './workflows';
-export * from './hitl.module';

package/src/workflows/ask-user/ask-user.ui.yaml

@@ -1,6 +0,0 @@
-title: 'Ask User'
-
-description: |
-  Generic sub-workflow that presents a question to the user and waits for their answer.
-  Used by async tool calls (e.g. askClarification) to interrupt an agent loop for user input.
-  Supports three modes: text (default), options (pick from a list), and confirm (yes/no).

package/src/workflows/ask-user/ask-user.workflow.ts

@@ -1,83 +0,0 @@
-import { z } from 'zod';
-import { BaseWorkflow, Final, Guard, Initial, Transition, Workflow } from '@loopstack/common';
-import { AskUserConfirmDocument } from '../../documents/ask-user-confirm-document';
-import { AskUserDocument } from '../../documents/ask-user-document';
-import { AskUserOptionsDocument } from '../../documents/ask-user-options-document';
-
-const AskUserAnswerSchema = z.object({
-  answer: z.string(),
-});
-
-@Workflow({
-  uiConfig: __dirname + '/ask-user.ui.yaml',
-  schema: z.object({
-    question: z.string(),
-    mode: z.enum(['text', 'options', 'confirm']).optional(),
-    options: z.array(z.string()).optional(),
-    allowCustomAnswer: z.boolean().optional(),
-  }),
-})
-export class AskUserWorkflow extends BaseWorkflow {
-  @Initial({ to: 'show_question' })
-  start() {}
-
-  @Transition({ from: 'show_question', to: 'waiting_for_user', priority: 10 })
-  @Guard('isOptionsMode')
-  async showQuestionOptions() {
-    const { question, options, allowCustomAnswer } = this.ctx.args as {
-      question: string;
-      options?: string[];
-      allowCustomAnswer?: boolean;
-    };
-    await this.repository.save(
-      AskUserOptionsDocument,
-      { question, options: options ?? [], allowCustomAnswer },
-      { id: 'question' },
-    );
-  }
-
-  @Transition({ from: 'show_question', to: 'waiting_for_user', priority: 10 })
-  @Guard('isConfirmMode')
-  async showQuestionConfirm() {
-    const { question } = this.ctx.args as { question: string };
-    await this.repository.save(AskUserConfirmDocument, { question }, { id: 'question' });
-  }
-
-  @Transition({ from: 'show_question', to: 'waiting_for_user' })
-  async showQuestionText() {
-    const { question } = this.ctx.args as { question: string };
-    await this.repository.save(AskUserDocument, { question }, { id: 'question' });
-  }
-
-  @Final({ from: 'waiting_for_user', wait: true, schema: AskUserAnswerSchema })
-  async userAnswered(payload: { answer: string }): Promise<{ answer: string }> {
-    const { question, mode, options, allowCustomAnswer } = this.ctx.args as {
-      question: string;
-      mode?: string;
-      options?: string[];
-      allowCustomAnswer?: boolean;
-    };
-
-    if (mode === 'options') {
-      await this.repository.save(
-        AskUserOptionsDocument,
-        { question, options: options ?? [], allowCustomAnswer, answer: payload.answer },
-        { id: 'question' },
-      );
-    } else if (mode === 'confirm') {
-      await this.repository.save(AskUserConfirmDocument, { question, answer: payload.answer }, { id: 'question' });
-    } else {
-      await this.repository.save(AskUserDocument, { question, answer: payload.answer }, { id: 'question' });
-    }
-
-    return { answer: payload.answer };
-  }
-
-  private isOptionsMode(): boolean {
-    return (this.ctx.args as { mode?: string })?.mode === 'options';
-  }
-
-  private isConfirmMode(): boolean {
-    return (this.ctx.args as { mode?: string })?.mode === 'confirm';
-  }
-}

package/src/workflows/confirm-user/confirm-user.ui.yaml

@@ -1,5 +0,0 @@
-title: 'Confirm User'
-
-description: |
-  Generic sub-workflow that presents markdown content to the user and waits for confirmation.
-  Used by async tool calls (e.g. askForApproval) to get explicit user confirmation.

package/src/workflows/confirm-user/confirm-user.workflow.ts

@@ -1,29 +0,0 @@
-import { z } from 'zod';
-import { BaseWorkflow, Final, Initial, Workflow } from '@loopstack/common';
-import { ConfirmUserDocument } from '../../documents/confirm-user-document';
-
-@Workflow({
-  uiConfig: __dirname + '/confirm-user.ui.yaml',
-  schema: z.object({
-    markdown: z.string(),
-  }),
-})
-export class ConfirmUserWorkflow extends BaseWorkflow {
-  markdown?: string;
-
-  @Initial({ to: 'waiting_for_confirmation' })
-  async showContent(args: { markdown: string }) {
-    this.markdown = args.markdown;
-    await this.repository.save(ConfirmUserDocument, { markdown: args.markdown }, { id: 'content' });
-  }
-
-  @Final({ from: 'waiting_for_confirmation', wait: true })
-  async userConfirmed(): Promise<{ confirmed: boolean; markdown: string }> {
-    return Promise.resolve({ confirmed: true, markdown: this.markdown! });
-  }
-
-  @Final({ from: 'waiting_for_confirmation', wait: true })
-  async userDenied(): Promise<{ confirmed: boolean; markdown: string }> {
-    return Promise.resolve({ confirmed: false, markdown: this.markdown! });
-  }
-}

package/src/workflows/index.ts

@@ -1,2 +0,0 @@
-export { AskUserWorkflow } from './ask-user/ask-user.workflow';
-export { ConfirmUserWorkflow } from './confirm-user/confirm-user.workflow';