@loopstack/hitl 0.1.1

package/dist/documents/ask-user-confirm-document.d.ts

@@ -0,0 +1,11 @@
+import { z } from 'zod';
+export declare const AskUserConfirmDocumentSchema: z.ZodObject<{
+    question: z.ZodString;
+    answer: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type AskUserConfirmDocumentType = z.infer<typeof AskUserConfirmDocumentSchema>;
+export declare class AskUserConfirmDocument {
+    question: string;
+    answer?: string;
+}
+//# sourceMappingURL=ask-user-confirm-document.d.ts.map

package/dist/documents/ask-user-confirm-document.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ask-user-confirm-document.d.ts","sourceRoot":"","sources":["../../src/documents/ask-user-confirm-document.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,4BAA4B;;;kBAK9B,CAAC;AAEZ,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAEtF,qBAIa,sBAAsB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB"}

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

@@ -0,0 +1,29 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AskUserConfirmDocument = exports.AskUserConfirmDocumentSchema = void 0;
+const zod_1 = require("zod");
+const common_1 = require("@loopstack/common");
+exports.AskUserConfirmDocumentSchema = zod_1.z
+    .object({
+    question: zod_1.z.string(),
+    answer: zod_1.z.string().optional(),
+})
+    .strict();
+let AskUserConfirmDocument = class AskUserConfirmDocument {
+    question;
+    answer;
+};
+exports.AskUserConfirmDocument = AskUserConfirmDocument;
+exports.AskUserConfirmDocument = AskUserConfirmDocument = __decorate([
+    (0, common_1.Document)({
+        uiConfig: __dirname + '/ask-user-confirm-document.yaml',
+        schema: exports.AskUserConfirmDocumentSchema,
+    })
+], AskUserConfirmDocument);
+//# sourceMappingURL=ask-user-confirm-document.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ask-user-confirm-document.js","sourceRoot":"","sources":["../../src/documents/ask-user-confirm-document.ts"],"names":[],"mappings":";;;;;;;;;AAAA,6BAAwB;AACxB,8CAA6C;AAEhC,QAAA,4BAA4B,GAAG,OAAC;KAC1C,MAAM,CAAC;IACN,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE;IACpB,MAAM,EAAE,OAAC,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,wDAAsB;iCAAtB,sBAAsB;IAJlC,IAAA,iBAAQ,EAAC;QACR,QAAQ,EAAE,SAAS,GAAG,iCAAiC;QACvD,MAAM,EAAE,oCAA4B;KACrC,CAAC;GACW,sBAAsB,CAGlC"}

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

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

package/dist/documents/ask-user-document.d.ts

@@ -0,0 +1,11 @@
+import { z } from 'zod';
+export declare const AskUserDocumentSchema: z.ZodObject<{
+    question: z.ZodString;
+    answer: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type AskUserDocumentType = z.infer<typeof AskUserDocumentSchema>;
+export declare class AskUserDocument {
+    question: string;
+    answer?: string;
+}
+//# sourceMappingURL=ask-user-document.d.ts.map

package/dist/documents/ask-user-document.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ask-user-document.d.ts","sourceRoot":"","sources":["../../src/documents/ask-user-document.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,qBAAqB;;;kBAKvB,CAAC;AAEZ,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAExE,qBAIa,eAAe;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB"}

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

@@ -0,0 +1,29 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AskUserDocument = exports.AskUserDocumentSchema = void 0;
+const zod_1 = require("zod");
+const common_1 = require("@loopstack/common");
+exports.AskUserDocumentSchema = zod_1.z
+    .object({
+    question: zod_1.z.string(),
+    answer: zod_1.z.string().optional(),
+})
+    .strict();
+let AskUserDocument = class AskUserDocument {
+    question;
+    answer;
+};
+exports.AskUserDocument = AskUserDocument;
+exports.AskUserDocument = AskUserDocument = __decorate([
+    (0, common_1.Document)({
+        uiConfig: __dirname + '/ask-user-document.yaml',
+        schema: exports.AskUserDocumentSchema,
+    })
+], AskUserDocument);
+//# sourceMappingURL=ask-user-document.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ask-user-document.js","sourceRoot":"","sources":["../../src/documents/ask-user-document.ts"],"names":[],"mappings":";;;;;;;;;AAAA,6BAAwB;AACxB,8CAA6C;AAEhC,QAAA,qBAAqB,GAAG,OAAC;KACnC,MAAM,CAAC;IACN,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE;IACpB,MAAM,EAAE,OAAC,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,0CAAe;0BAAf,eAAe;IAJ3B,IAAA,iBAAQ,EAAC;QACR,QAAQ,EAAE,SAAS,GAAG,yBAAyB;QAC/C,MAAM,EAAE,6BAAqB;KAC9B,CAAC;GACW,eAAe,CAG3B"}

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

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

package/dist/documents/ask-user-options-document.d.ts

@@ -0,0 +1,15 @@
+import { z } from 'zod';
+export declare const AskUserOptionsDocumentSchema: z.ZodObject<{
+    question: z.ZodString;
+    options: z.ZodArray<z.ZodString>;
+    allowCustomAnswer: z.ZodOptional<z.ZodBoolean>;
+    answer: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type AskUserOptionsDocumentType = z.infer<typeof AskUserOptionsDocumentSchema>;
+export declare class AskUserOptionsDocument {
+    question: string;
+    options: string[];
+    allowCustomAnswer?: boolean;
+    answer?: string;
+}
+//# sourceMappingURL=ask-user-options-document.d.ts.map

package/dist/documents/ask-user-options-document.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ask-user-options-document.d.ts","sourceRoot":"","sources":["../../src/documents/ask-user-options-document.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,4BAA4B;;;;;kBAO9B,CAAC;AAEZ,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAEtF,qBAIa,sBAAsB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB"}

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

@@ -0,0 +1,33 @@
+"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.AskUserOptionsDocument = exports.AskUserOptionsDocumentSchema = void 0;
+const zod_1 = require("zod");
+const common_1 = require("@loopstack/common");
+exports.AskUserOptionsDocumentSchema = zod_1.z
+    .object({
+    question: zod_1.z.string(),
+    options: zod_1.z.array(zod_1.z.string()),
+    allowCustomAnswer: zod_1.z.boolean().optional(),
+    answer: zod_1.z.string().optional(),
+})
+    .strict();
+let AskUserOptionsDocument = class AskUserOptionsDocument {
+    question;
+    options;
+    allowCustomAnswer;
+    answer;
+};
+exports.AskUserOptionsDocument = AskUserOptionsDocument;
+exports.AskUserOptionsDocument = AskUserOptionsDocument = __decorate([
+    (0, common_1.Document)({
+        uiConfig: __dirname + '/ask-user-options-document.yaml',
+        schema: exports.AskUserOptionsDocumentSchema,
+    })
+], AskUserOptionsDocument);
+//# sourceMappingURL=ask-user-options-document.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ask-user-options-document.js","sourceRoot":"","sources":["../../src/documents/ask-user-options-document.ts"],"names":[],"mappings":";;;;;;;;;AAAA,6BAAwB;AACxB,8CAA6C;AAEhC,QAAA,4BAA4B,GAAG,OAAC;KAC1C,MAAM,CAAC;IACN,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE;IACpB,OAAO,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC;IAC5B,iBAAiB,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACzC,MAAM,EAAE,OAAC,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,wDAAsB;iCAAtB,sBAAsB;IAJlC,IAAA,iBAAQ,EAAC;QACR,QAAQ,EAAE,SAAS,GAAG,iCAAiC;QACvD,MAAM,EAAE,oCAA4B;KACrC,CAAC;GACW,sBAAsB,CAKlC"}

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

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

package/dist/documents/confirm-user-document.d.ts

@@ -0,0 +1,9 @@
+import { z } from 'zod';
+export declare const ConfirmUserDocumentSchema: z.ZodObject<{
+    markdown: z.ZodString;
+}, z.core.$strict>;
+export type ConfirmUserDocumentType = z.infer<typeof ConfirmUserDocumentSchema>;
+export declare class ConfirmUserDocument {
+    markdown: string;
+}
+//# sourceMappingURL=confirm-user-document.d.ts.map

package/dist/documents/confirm-user-document.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"confirm-user-document.d.ts","sourceRoot":"","sources":["../../src/documents/confirm-user-document.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,yBAAyB;;kBAI3B,CAAC;AAEZ,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAEhF,qBAIa,mBAAmB;IAC9B,QAAQ,EAAE,MAAM,CAAC;CAClB"}

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

@@ -0,0 +1,27 @@
+"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.ConfirmUserDocument = exports.ConfirmUserDocumentSchema = void 0;
+const zod_1 = require("zod");
+const common_1 = require("@loopstack/common");
+exports.ConfirmUserDocumentSchema = zod_1.z
+    .object({
+    markdown: zod_1.z.string(),
+})
+    .strict();
+let ConfirmUserDocument = class ConfirmUserDocument {
+    markdown;
+};
+exports.ConfirmUserDocument = ConfirmUserDocument;
+exports.ConfirmUserDocument = ConfirmUserDocument = __decorate([
+    (0, common_1.Document)({
+        uiConfig: __dirname + '/confirm-user-document.yaml',
+        schema: exports.ConfirmUserDocumentSchema,
+    })
+], ConfirmUserDocument);
+//# sourceMappingURL=confirm-user-document.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"confirm-user-document.js","sourceRoot":"","sources":["../../src/documents/confirm-user-document.ts"],"names":[],"mappings":";;;;;;;;;AAAA,6BAAwB;AACxB,8CAA6C;AAEhC,QAAA,yBAAyB,GAAG,OAAC;KACvC,MAAM,CAAC;IACN,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE;CACrB,CAAC;KACD,MAAM,EAAE,CAAC;AAQL,IAAM,mBAAmB,GAAzB,MAAM,mBAAmB;IAC9B,QAAQ,CAAS;CAClB,CAAA;AAFY,kDAAmB;8BAAnB,mBAAmB;IAJ/B,IAAA,iBAAQ,EAAC;QACR,QAAQ,EAAE,SAAS,GAAG,6BAA6B;QACnD,MAAM,EAAE,iCAAyB;KAClC,CAAC;GACW,mBAAmB,CAE/B"}

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

@@ -0,0 +1,16 @@
+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/dist/documents/index.d.ts

@@ -0,0 +1,5 @@
+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';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/documents/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAClG,OAAO,EACL,sBAAsB,EACtB,4BAA4B,EAC5B,0BAA0B,GAC3B,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,sBAAsB,EACtB,4BAA4B,EAC5B,0BAA0B,GAC3B,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,mBAAmB,EAAE,yBAAyB,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/documents/index.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConfirmUserDocumentSchema = exports.ConfirmUserDocument = exports.AskUserOptionsDocumentSchema = exports.AskUserOptionsDocument = exports.AskUserConfirmDocumentSchema = exports.AskUserConfirmDocument = exports.AskUserDocumentSchema = exports.AskUserDocument = void 0;
+var ask_user_document_1 = require("./ask-user-document");
+Object.defineProperty(exports, "AskUserDocument", { enumerable: true, get: function () { return ask_user_document_1.AskUserDocument; } });
+Object.defineProperty(exports, "AskUserDocumentSchema", { enumerable: true, get: function () { return ask_user_document_1.AskUserDocumentSchema; } });
+var ask_user_confirm_document_1 = require("./ask-user-confirm-document");
+Object.defineProperty(exports, "AskUserConfirmDocument", { enumerable: true, get: function () { return ask_user_confirm_document_1.AskUserConfirmDocument; } });
+Object.defineProperty(exports, "AskUserConfirmDocumentSchema", { enumerable: true, get: function () { return ask_user_confirm_document_1.AskUserConfirmDocumentSchema; } });
+var ask_user_options_document_1 = require("./ask-user-options-document");
+Object.defineProperty(exports, "AskUserOptionsDocument", { enumerable: true, get: function () { return ask_user_options_document_1.AskUserOptionsDocument; } });
+Object.defineProperty(exports, "AskUserOptionsDocumentSchema", { enumerable: true, get: function () { return ask_user_options_document_1.AskUserOptionsDocumentSchema; } });
+var confirm_user_document_1 = require("./confirm-user-document");
+Object.defineProperty(exports, "ConfirmUserDocument", { enumerable: true, get: function () { return confirm_user_document_1.ConfirmUserDocument; } });
+Object.defineProperty(exports, "ConfirmUserDocumentSchema", { enumerable: true, get: function () { return confirm_user_document_1.ConfirmUserDocumentSchema; } });
+//# sourceMappingURL=index.js.map

package/dist/documents/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/documents/index.ts"],"names":[],"mappings":";;;AAAA,yDAAkG;AAAzF,oHAAA,eAAe,OAAA;AAAE,0HAAA,qBAAqB,OAAA;AAC/C,yEAIqC;AAHnC,mIAAA,sBAAsB,OAAA;AACtB,yIAAA,4BAA4B,OAAA;AAG9B,yEAIqC;AAHnC,mIAAA,sBAAsB,OAAA;AACtB,yIAAA,4BAA4B,OAAA;AAG9B,iEAAkH;AAAzG,4HAAA,mBAAmB,OAAA;AAAE,kIAAA,yBAAyB,OAAA"}

package/dist/hitl.module.d.ts

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

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

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

package/dist/hitl.module.js

@@ -0,0 +1,24 @@
+"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.HitlModule = void 0;
+const common_1 = require("@nestjs/common");
+const core_1 = require("@loopstack/core");
+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 {
+};
+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],
+    })
+], HitlModule);
+//# sourceMappingURL=hitl.module.js.map

package/dist/hitl.module.js.map

@@ -0,0 +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"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export * from './documents';
+export * from './workflows';
+export * from './hitl.module';
+//# 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,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,20 @@
+"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("./documents"), exports);
+__exportStar(require("./workflows"), exports);
+__exportStar(require("./hitl.module"), 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,8CAA4B;AAC5B,8CAA4B;AAC5B,gDAA8B"}

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

@@ -0,0 +1,6 @@
+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/dist/workflows/ask-user/ask-user.workflow.d.ts

@@ -0,0 +1,15 @@
+import { BaseWorkflow } from '@loopstack/common';
+export declare class AskUserWorkflow extends BaseWorkflow {
+    start(): void;
+    showQuestionOptions(): Promise<void>;
+    showQuestionConfirm(): Promise<void>;
+    showQuestionText(): Promise<void>;
+    userAnswered(payload: {
+        answer: string;
+    }): Promise<{
+        answer: string;
+    }>;
+    private isOptionsMode;
+    private isConfirmMode;
+}
+//# sourceMappingURL=ask-user.workflow.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,99 @@
+"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.AskUserWorkflow = void 0;
+const zod_1 = require("zod");
+const common_1 = require("@loopstack/common");
+const ask_user_confirm_document_1 = require("../../documents/ask-user-confirm-document");
+const ask_user_document_1 = require("../../documents/ask-user-document");
+const ask_user_options_document_1 = require("../../documents/ask-user-options-document");
+const AskUserAnswerSchema = zod_1.z.object({
+    answer: zod_1.z.string(),
+});
+let AskUserWorkflow = class AskUserWorkflow extends common_1.BaseWorkflow {
+    start() { }
+    async showQuestionOptions() {
+        const { question, options, allowCustomAnswer } = this.ctx.args;
+        await this.repository.save(ask_user_options_document_1.AskUserOptionsDocument, { question, options: options ?? [], allowCustomAnswer }, { id: 'question' });
+    }
+    async showQuestionConfirm() {
+        const { question } = this.ctx.args;
+        await this.repository.save(ask_user_confirm_document_1.AskUserConfirmDocument, { question }, { id: 'question' });
+    }
+    async showQuestionText() {
+        const { question } = this.ctx.args;
+        await this.repository.save(ask_user_document_1.AskUserDocument, { question }, { id: 'question' });
+    }
+    async userAnswered(payload) {
+        const { question, mode, options, allowCustomAnswer } = this.ctx.args;
+        if (mode === 'options') {
+            await this.repository.save(ask_user_options_document_1.AskUserOptionsDocument, { question, options: options ?? [], allowCustomAnswer, answer: payload.answer }, { id: 'question' });
+        }
+        else if (mode === 'confirm') {
+            await this.repository.save(ask_user_confirm_document_1.AskUserConfirmDocument, { question, answer: payload.answer }, { id: 'question' });
+        }
+        else {
+            await this.repository.save(ask_user_document_1.AskUserDocument, { question, answer: payload.answer }, { id: 'question' });
+        }
+        return { answer: payload.answer };
+    }
+    isOptionsMode() {
+        return this.ctx.args?.mode === 'options';
+    }
+    isConfirmMode() {
+        return this.ctx.args?.mode === 'confirm';
+    }
+};
+exports.AskUserWorkflow = AskUserWorkflow;
+__decorate([
+    (0, common_1.Initial)({ to: 'show_question' }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", void 0)
+], AskUserWorkflow.prototype, "start", null);
+__decorate([
+    (0, common_1.Transition)({ from: 'show_question', to: 'waiting_for_user', priority: 10 }),
+    (0, common_1.Guard)('isOptionsMode'),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", Promise)
+], AskUserWorkflow.prototype, "showQuestionOptions", null);
+__decorate([
+    (0, common_1.Transition)({ from: 'show_question', to: 'waiting_for_user', priority: 10 }),
+    (0, common_1.Guard)('isConfirmMode'),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", Promise)
+], AskUserWorkflow.prototype, "showQuestionConfirm", null);
+__decorate([
+    (0, common_1.Transition)({ from: 'show_question', to: 'waiting_for_user' }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", Promise)
+], AskUserWorkflow.prototype, "showQuestionText", null);
+__decorate([
+    (0, common_1.Final)({ from: 'waiting_for_user', wait: true, schema: AskUserAnswerSchema }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], AskUserWorkflow.prototype, "userAnswered", null);
+exports.AskUserWorkflow = AskUserWorkflow = __decorate([
+    (0, common_1.Workflow)({
+        uiConfig: __dirname + '/ask-user.ui.yaml',
+        schema: zod_1.z.object({
+            question: zod_1.z.string(),
+            mode: zod_1.z.enum(['text', 'options', 'confirm']).optional(),
+            options: zod_1.z.array(zod_1.z.string()).optional(),
+            allowCustomAnswer: zod_1.z.boolean().optional(),
+        }),
+    })
+], AskUserWorkflow);
+//# sourceMappingURL=ask-user.workflow.js.map

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

@@ -0,0 +1 @@
+{"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.ui.yaml

@@ -0,0 +1,5 @@
+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/dist/workflows/confirm-user/confirm-user.workflow.d.ts

@@ -0,0 +1,16 @@
+import { BaseWorkflow } from '@loopstack/common';
+export declare class ConfirmUserWorkflow extends BaseWorkflow {
+    markdown?: string;
+    showContent(args: {
+        markdown: string;
+    }): Promise<void>;
+    userConfirmed(): Promise<{
+        confirmed: boolean;
+        markdown: string;
+    }>;
+    userDenied(): Promise<{
+        confirmed: boolean;
+        markdown: string;
+    }>;
+}
+//# sourceMappingURL=confirm-user.workflow.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"confirm-user.workflow.d.ts","sourceRoot":"","sources":["../../../src/workflows/confirm-user/confirm-user.workflow.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAA4B,MAAM,mBAAmB,CAAC;AAG3E,qBAMa,mBAAoB,SAAQ,YAAY;IACnD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAGZ,WAAW,CAAC,IAAI,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE;IAMtC,aAAa,IAAI,OAAO,CAAC;QAAE,SAAS,EAAE,OAAO,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAKlE,UAAU,IAAI,OAAO,CAAC;QAAE,SAAS,EAAE,OAAO,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;CAGtE"}

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

@@ -0,0 +1,56 @@
+"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.ConfirmUserWorkflow = void 0;
+const zod_1 = require("zod");
+const common_1 = require("@loopstack/common");
+const confirm_user_document_1 = require("../../documents/confirm-user-document");
+let ConfirmUserWorkflow = class ConfirmUserWorkflow extends common_1.BaseWorkflow {
+    markdown;
+    async showContent(args) {
+        this.markdown = args.markdown;
+        await this.repository.save(confirm_user_document_1.ConfirmUserDocument, { markdown: args.markdown }, { id: 'content' });
+    }
+    async userConfirmed() {
+        return Promise.resolve({ confirmed: true, markdown: this.markdown });
+    }
+    async userDenied() {
+        return Promise.resolve({ confirmed: false, markdown: this.markdown });
+    }
+};
+exports.ConfirmUserWorkflow = ConfirmUserWorkflow;
+__decorate([
+    (0, common_1.Initial)({ to: 'waiting_for_confirmation' }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], ConfirmUserWorkflow.prototype, "showContent", null);
+__decorate([
+    (0, common_1.Final)({ from: 'waiting_for_confirmation', wait: true }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", Promise)
+], ConfirmUserWorkflow.prototype, "userConfirmed", null);
+__decorate([
+    (0, common_1.Final)({ from: 'waiting_for_confirmation', wait: true }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", Promise)
+], ConfirmUserWorkflow.prototype, "userDenied", null);
+exports.ConfirmUserWorkflow = ConfirmUserWorkflow = __decorate([
+    (0, common_1.Workflow)({
+        uiConfig: __dirname + '/confirm-user.ui.yaml',
+        schema: zod_1.z.object({
+            markdown: zod_1.z.string(),
+        }),
+    })
+], ConfirmUserWorkflow);
+//# sourceMappingURL=confirm-user.workflow.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"confirm-user.workflow.js","sourceRoot":"","sources":["../../../src/workflows/confirm-user/confirm-user.workflow.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,6BAAwB;AACxB,8CAA2E;AAC3E,iFAA4E;AAQrE,IAAM,mBAAmB,GAAzB,MAAM,mBAAoB,SAAQ,qBAAY;IACnD,QAAQ,CAAU;IAGZ,AAAN,KAAK,CAAC,WAAW,CAAC,IAA0B;QAC1C,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC9B,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,2CAAmB,EAAE,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,EAAE,EAAE,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;IAClG,CAAC;IAGK,AAAN,KAAK,CAAC,aAAa;QACjB,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAS,EAAE,CAAC,CAAC;IACxE,CAAC;IAGK,AAAN,KAAK,CAAC,UAAU;QACd,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAS,EAAE,CAAC,CAAC;IACzE,CAAC;CACF,CAAA;AAlBY,kDAAmB;AAIxB;IADL,IAAA,gBAAO,EAAC,EAAE,EAAE,EAAE,0BAA0B,EAAE,CAAC;;;;sDAI3C;AAGK;IADL,IAAA,cAAK,EAAC,EAAE,IAAI,EAAE,0BAA0B,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;;;;wDAGvD;AAGK;IADL,IAAA,cAAK,EAAC,EAAE,IAAI,EAAE,0BAA0B,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;;;;qDAGvD;8BAjBU,mBAAmB;IAN/B,IAAA,iBAAQ,EAAC;QACR,QAAQ,EAAE,SAAS,GAAG,uBAAuB;QAC7C,MAAM,EAAE,OAAC,CAAC,MAAM,CAAC;YACf,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE;SACrB,CAAC;KACH,CAAC;GACW,mBAAmB,CAkB/B"}

package/dist/workflows/index.d.ts

@@ -0,0 +1,3 @@
+export { AskUserWorkflow } from './ask-user/ask-user.workflow';
+export { ConfirmUserWorkflow } from './confirm-user/confirm-user.workflow';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/workflows/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC"}

package/dist/workflows/index.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConfirmUserWorkflow = exports.AskUserWorkflow = void 0;
+var ask_user_workflow_1 = require("./ask-user/ask-user.workflow");
+Object.defineProperty(exports, "AskUserWorkflow", { enumerable: true, get: function () { return ask_user_workflow_1.AskUserWorkflow; } });
+var confirm_user_workflow_1 = require("./confirm-user/confirm-user.workflow");
+Object.defineProperty(exports, "ConfirmUserWorkflow", { enumerable: true, get: function () { return confirm_user_workflow_1.ConfirmUserWorkflow; } });
+//# sourceMappingURL=index.js.map

package/dist/workflows/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/workflows/index.ts"],"names":[],"mappings":";;;AAAA,kEAA+D;AAAtD,oHAAA,eAAe,OAAA;AACxB,8EAA2E;AAAlE,4HAAA,mBAAmB,OAAA"}

package/package.json

@@ -0,0 +1,72 @@
+{
+  "name": "@loopstack/hitl",
+  "displayName": "Loopstack Human-in-the-Loop",
+  "description": "Human-in-the-loop workflows for Loopstack — ask questions, present options, and request confirmations from users during workflow execution",
+  "keywords": [
+    "loopstack",
+    "hitl",
+    "human-in-the-loop",
+    "workflow",
+    "user-input"
+  ],
+  "version": "0.1.1",
+  "license": "MIT",
+  "author": {
+    "name": "Jakob Klippel",
+    "url": "https://www.linkedin.com/in/jakob-klippel/"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": "./dist/index.js",
+    "./src/*": "./src/*"
+  },
+  "scripts": {
+    "build": "nest build",
+    "compile": "tsc --noEmit",
+    "format": "prettier --write .",
+    "lint": "eslint .",
+    "test": "jest --passWithNoTests",
+    "watch": "nest build --watch"
+  },
+  "dependencies": {
+    "@loopstack/common": "^0.27.0",
+    "@loopstack/core": "^0.27.0",
+    "@nestjs/common": "^11.1.19",
+    "zod": "^4.3.6"
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "jest": {
+    "moduleFileExtensions": [
+      "js",
+      "json",
+      "ts"
+    ],
+    "rootDir": "src",
+    "testRegex": ".*\\.spec\\.ts$",
+    "transform": {
+      "^.+\\.ts$": "ts-jest"
+    },
+    "collectCoverageFrom": [
+      "**/*.(t|j)s"
+    ],
+    "coverageDirectory": "../coverage",
+    "testEnvironment": "node",
+    "maxWorkers": 1
+  },
+  "loopstack": {
+    "modules": [
+      {
+        "path": "src/hitl.module.ts",
+        "className": "HitlModule"
+      }
+    ],
+    "installModes": [
+      "add",
+      "install"
+    ]
+  }
+}

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

@@ -0,0 +1,20 @@
+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

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

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

@@ -0,0 +1,20 @@
+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

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

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

@@ -0,0 +1,24 @@
+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

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

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

@@ -0,0 +1,18 @@
+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

@@ -0,0 +1,16 @@
+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

@@ -0,0 +1,12 @@
+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

@@ -0,0 +1,11 @@
+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

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

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

@@ -0,0 +1,6 @@
+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

@@ -0,0 +1,83 @@
+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

@@ -0,0 +1,5 @@
+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

@@ -0,0 +1,29 @@
+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

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