@a5c-ai/genty-platform 5.1.1-staging.583e3d9a6ed7

package/dist/interaction/askUserQuestion/terminal.js

@@ -0,0 +1,128 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.YELLOW = exports.DIM = exports.CYAN = exports.BOLD = exports.RESET = void 0;
+exports.isTTYInput = isTTYInput;
+exports.promptArrowKeySelect = promptArrowKeySelect;
+exports.RESET = "\x1b[0m";
+exports.BOLD = "\x1b[1m";
+exports.CYAN = "\x1b[36m";
+exports.DIM = "\x1b[2m";
+exports.YELLOW = "\x1b[33m";
+const HIDE_CURSOR = "\x1b[?25l";
+const SHOW_CURSOR = "\x1b[?25h";
+const CLEAR_LINE = "\x1b[2K";
+const CURSOR_COL1 = "\x1b[G";
+const CURSOR_UP = "\x1b[A";
+function isTTYInput(stream) {
+    return "isTTY" in stream && stream.isTTY === true && typeof stream.setRawMode === "function";
+}
+function renderOptions(output, options, cursor, selected, multiSelect) {
+    let lines = 0;
+    for (const [index, label] of options.entries()) {
+        const isCurrent = index === cursor;
+        const prefix = multiSelect
+            ? selected.has(index)
+                ? isCurrent
+                    ? `${exports.CYAN}${exports.BOLD}> [x]${exports.RESET} `
+                    : "  [x] "
+                : isCurrent
+                    ? `${exports.CYAN}${exports.BOLD}> [ ]${exports.RESET} `
+                    : "  [ ] "
+            : isCurrent
+                ? `${exports.CYAN}${exports.BOLD}> ${exports.RESET}`
+                : "  ";
+        const text = isCurrent ? `${exports.CYAN}${exports.BOLD}${label}${exports.RESET}` : label;
+        output.write(`${CLEAR_LINE}${CURSOR_COL1}${prefix}${text}\n`);
+        lines++;
+    }
+    if (multiSelect) {
+        output.write(`${CLEAR_LINE}${CURSOR_COL1}${exports.DIM}(Space to toggle, Enter to confirm, Esc to cancel)${exports.RESET}\n`);
+        lines++;
+    }
+    else {
+        output.write(`${CLEAR_LINE}${CURSOR_COL1}${exports.DIM}(Up/Down to move, Enter to select, 1-9 shortcut, Esc to cancel)${exports.RESET}\n`);
+        lines++;
+    }
+    return lines;
+}
+function moveUp(output, count) {
+    if (count > 0) {
+        output.write(`${CURSOR_UP}`.repeat(count));
+    }
+}
+function promptArrowKeySelect(input, output, options, opts) {
+    const multiSelect = opts?.multiSelect ?? false;
+    return new Promise((resolve) => {
+        let cursor = 0;
+        const selected = new Set();
+        let renderedLines = 0;
+        let resolved = false;
+        const cleanup = () => {
+            if (resolved) {
+                return;
+            }
+            resolved = true;
+            input.removeListener("data", onData);
+            try {
+                input.setRawMode(false);
+            }
+            catch {
+                // Ignore stream cleanup failures.
+            }
+            output.write(SHOW_CURSOR);
+        };
+        const finish = (value) => {
+            cleanup();
+            resolve(value);
+        };
+        const redraw = () => {
+            moveUp(output, renderedLines);
+            renderedLines = renderOptions(output, options, cursor, selected, multiSelect);
+        };
+        const onData = (data) => {
+            if (resolved) {
+                return;
+            }
+            const key = data.toString("utf8");
+            if (key === "\x03" || key === "\x1b" || key === "\x1b\x1b") {
+                finish(undefined);
+                return;
+            }
+            if (key === "\r" || key === "\n") {
+                finish(multiSelect ? [...selected].sort((left, right) => left - right) : cursor);
+                return;
+            }
+            if (key === " " && multiSelect) {
+                if (selected.has(cursor)) {
+                    selected.delete(cursor);
+                }
+                else {
+                    selected.add(cursor);
+                }
+                redraw();
+                return;
+            }
+            if (key === "\x1b[A") {
+                cursor = cursor > 0 ? cursor - 1 : options.length - 1;
+                redraw();
+                return;
+            }
+            if (key === "\x1b[B") {
+                cursor = cursor < options.length - 1 ? cursor + 1 : 0;
+                redraw();
+                return;
+            }
+            if (!multiSelect && /^[1-9]$/.test(key)) {
+                const index = Number(key) - 1;
+                if (index < options.length) {
+                    finish(index);
+                }
+            }
+        };
+        output.write(HIDE_CURSOR);
+        input.setRawMode(true);
+        input.resume();
+        input.on("data", onData);
+        renderedLines = renderOptions(output, options, cursor, selected, multiSelect);
+    });
+}

package/dist/interaction/askUserQuestion.d.ts

@@ -0,0 +1,10 @@
+import * as readline from "node:readline";
+import { createAskUserQuestionResponse, createDefaultAskUserQuestionResponse, validateAskUserQuestionRequest } from "./askUserQuestion/core";
+import type { AskUserQuestionRequest, AskUserQuestionResponse, AskUserQuestionUiContext } from "./askUserQuestionTypes";
+export type { AskUserQuestionOption, AskUserQuestionQuestion, AskUserQuestionRequest, AskUserQuestionResponse, AskUserQuestionUiContext, } from "./askUserQuestionTypes";
+export { createAskUserQuestionResponse, createDefaultAskUserQuestionResponse, validateAskUserQuestionRequest, };
+export declare function createApprovalAskUserQuestion(question: string, header?: string): AskUserQuestionRequest;
+export declare function createReadlineAskUserQuestionUiContext(rl: readline.Interface): AskUserQuestionUiContext;
+export declare function promptAskUserQuestionWithUiContext(ui: AskUserQuestionUiContext, request: AskUserQuestionRequest): Promise<AskUserQuestionResponse>;
+export declare function promptAskUserQuestionWithReadline(rl: readline.Interface, request: AskUserQuestionRequest): Promise<AskUserQuestionResponse>;
+//# sourceMappingURL=askUserQuestion.d.ts.map

package/dist/interaction/askUserQuestion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"askUserQuestion.d.ts","sourceRoot":"","sources":["../../src/interaction/askUserQuestion.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAC;AAC1C,OAAO,EACL,6BAA6B,EAC7B,oCAAoC,EAIpC,8BAA8B,EAC/B,MAAM,wBAAwB,CAAC;AAWhC,OAAO,KAAK,EAGV,sBAAsB,EACtB,uBAAuB,EACvB,wBAAwB,EACzB,MAAM,wBAAwB,CAAC;AAChC,YAAY,EACV,qBAAqB,EACrB,uBAAuB,EACvB,sBAAsB,EACtB,uBAAuB,EACvB,wBAAwB,GACzB,MAAM,wBAAwB,CAAC;AAUhC,OAAO,EACL,6BAA6B,EAC7B,oCAAoC,EACpC,8BAA8B,GAC/B,CAAC;AAEF,wBAAgB,6BAA6B,CAC3C,QAAQ,EAAE,MAAM,EAChB,MAAM,GAAE,MAAmB,GAC1B,sBAAsB,CAqBxB;AAqBD,wBAAgB,sCAAsC,CACpD,EAAE,EAAE,QAAQ,CAAC,SAAS,GACrB,wBAAwB,CA4C1B;AAED,wBAAsB,kCAAkC,CACtD,EAAE,EAAE,wBAAwB,EAC5B,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,uBAAuB,CAAC,CAiGlC;AA8CD,wBAAsB,iCAAiC,CACrD,EAAE,EAAE,QAAQ,CAAC,SAAS,EACtB,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,uBAAuB,CAAC,CAKlC"}

package/dist/interaction/askUserQuestion.js

@@ -0,0 +1,295 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateAskUserQuestionRequest = exports.createDefaultAskUserQuestionResponse = exports.createAskUserQuestionResponse = void 0;
+exports.createApprovalAskUserQuestion = createApprovalAskUserQuestion;
+exports.createReadlineAskUserQuestionUiContext = createReadlineAskUserQuestionUiContext;
+exports.promptAskUserQuestionWithUiContext = promptAskUserQuestionWithUiContext;
+exports.promptAskUserQuestionWithReadline = promptAskUserQuestionWithReadline;
+const core_1 = require("./askUserQuestion/core");
+Object.defineProperty(exports, "createAskUserQuestionResponse", { enumerable: true, get: function () { return core_1.createAskUserQuestionResponse; } });
+Object.defineProperty(exports, "createDefaultAskUserQuestionResponse", { enumerable: true, get: function () { return core_1.createDefaultAskUserQuestionResponse; } });
+Object.defineProperty(exports, "validateAskUserQuestionRequest", { enumerable: true, get: function () { return core_1.validateAskUserQuestionRequest; } });
+const terminal_1 = require("./askUserQuestion/terminal");
+function askLine(rl, prompt) {
+    return new Promise((resolve) => {
+        rl.question(`${terminal_1.CYAN}?${terminal_1.RESET} ${prompt} `, (answer) => {
+            resolve(answer.trim());
+        });
+    });
+}
+function createApprovalAskUserQuestion(question, header = "Decision") {
+    return {
+        questions: [
+            {
+                header,
+                question,
+                options: [
+                    {
+                        label: "Approve",
+                        description: "Continue the orchestration loop.",
+                    },
+                    {
+                        label: "Reject",
+                        description: "Block the breakpoint and return a rejected decision.",
+                    },
+                ],
+                allowOther: false,
+                required: true,
+            },
+        ],
+    };
+}
+function formatUiPromptTitle(question) {
+    const lines = [question.question.trim()];
+    if (question.options?.length) {
+        lines.push("");
+        for (const [index, option] of question.options.entries()) {
+            const detailParts = [option.description?.trim(), option.preview?.trim()].filter(Boolean);
+            const detail = detailParts.length > 0 ? ` - ${detailParts.join(" | ")}` : "";
+            lines.push(`${index + 1}. ${option.label}${detail}`);
+        }
+    }
+    return lines.join("\n");
+}
+function buildUiTitle(question) {
+    const header = question.header?.trim();
+    const body = formatUiPromptTitle(question);
+    return header ? `${header}\n\n${body}` : body;
+}
+function createReadlineAskUserQuestionUiContext(rl) {
+    return {
+        async select(title, options) {
+            process.stderr.write(`${title}\n`);
+            // Use arrow-key selector when stdin is a TTY
+            if ((0, terminal_1.isTTYInput)(process.stdin)) {
+                const idx = await (0, terminal_1.promptArrowKeySelect)(process.stdin, process.stderr, options);
+                if (idx == null || typeof idx !== "number")
+                    return undefined;
+                return options[idx];
+            }
+            // Fallback: line-based prompt
+            for (const [index, option] of options.entries()) {
+                process.stderr.write(`  ${index + 1}. ${option}\n`);
+            }
+            let matched;
+            while (!matched) {
+                const answer = await askLine(rl, "Choose an option (number or label)");
+                if (!answer) {
+                    return undefined;
+                }
+                matched = (0, core_1.resolveOption)(answer, options.map((label) => ({ label })));
+                if (matched) {
+                    return matched.label;
+                }
+                process.stderr.write(`${terminal_1.YELLOW}Please choose a valid option.${terminal_1.RESET}\n`);
+            }
+        },
+        async input(title, placeholder) {
+            process.stderr.write(`${title}\n`);
+            const answer = await askLine(rl, placeholder?.trim() || "Answer");
+            return answer || undefined;
+        },
+        async confirm(title, message) {
+            process.stderr.write(`${title}\n${message}\n`);
+            const answer = await askLine(rl, "Confirm (y/N)");
+            return ["y", "yes"].includes(answer.trim().toLowerCase());
+        },
+    };
+}
+async function promptAskUserQuestionWithUiContext(ui, request) {
+    return runAskUserQuestionPrompt(request, async () => {
+        const answers = {};
+        for (const [index, question] of request.questions.entries()) {
+            const key = (0, core_1.getQuestionKey)(question, index);
+            const options = question.options ?? [];
+            if (options.length === 0) {
+                let resolved = false;
+                while (!resolved) {
+                    const answer = (await ui.input(buildUiTitle(question), question.required ? "Answer (required)" : "Answer"))?.trim();
+                    if (answer) {
+                        answers[key] = answer;
+                        resolved = true;
+                        continue;
+                    }
+                    if (!question.required) {
+                        answers[key] = "";
+                        resolved = true;
+                    }
+                }
+                continue;
+            }
+            if (question.multiSelect) {
+                let resolved = false;
+                while (!resolved) {
+                    const rawAnswer = (await ui.input(buildUiTitle(question), "Enter one or more options (numbers or labels, comma-separated)"))?.trim() ?? "";
+                    if (!rawAnswer && !question.required) {
+                        answers[key] = "";
+                        resolved = true;
+                        continue;
+                    }
+                    const parsed = (0, core_1.parseOptionAnswer)(rawAnswer, question);
+                    if (parsed !== undefined) {
+                        answers[key] = parsed;
+                        resolved = true;
+                    }
+                }
+                continue;
+            }
+            const allowOther = question.allowOther !== false;
+            const optionLabels = options.map((option) => option.label);
+            const selectOptions = allowOther
+                ? [...optionLabels, "Other (type a custom answer)"]
+                : optionLabels;
+            let resolved = false;
+            while (!resolved) {
+                const selection = await ui.select(buildUiTitle(question), selectOptions);
+                if (!selection) {
+                    if (question.required) {
+                        continue;
+                    }
+                    answers[key] = "";
+                    resolved = true;
+                    continue;
+                }
+                if (allowOther && selection === "Other (type a custom answer)") {
+                    const other = (await ui.input(buildUiTitle(question), "Type your answer"))?.trim();
+                    if (other) {
+                        answers[key] = other;
+                        resolved = true;
+                        continue;
+                    }
+                    if (!question.required) {
+                        answers[key] = "";
+                        resolved = true;
+                    }
+                    continue;
+                }
+                const parsed = (0, core_1.parseOptionAnswer)(selection, {
+                    ...question,
+                    allowOther: false,
+                });
+                if (parsed !== undefined) {
+                    answers[key] = parsed;
+                    resolved = true;
+                }
+            }
+        }
+        return (0, core_1.createAskUserQuestionResponse)(request, answers);
+    });
+}
+function runAskUserQuestionPrompt(request, runInteractive) {
+    (0, core_1.validateAskUserQuestionRequest)(request);
+    if (request.timeout == null || request.timeout <= 0) {
+        return runInteractive();
+    }
+    const fallbackResponse = (0, core_1.createDefaultAskUserQuestionResponse)(request);
+    return new Promise((resolve) => {
+        let settled = false;
+        const timer = setTimeout(() => {
+            if (settled) {
+                return;
+            }
+            settled = true;
+            process.stderr.write(`${terminal_1.YELLOW}Ask timeout reached (${request.timeout}ms). Auto-selecting defaults.${terminal_1.RESET}\n`);
+            resolve(fallbackResponse);
+        }, request.timeout);
+        runInteractive()
+            .then((response) => {
+            if (settled) {
+                return;
+            }
+            settled = true;
+            clearTimeout(timer);
+            resolve(response);
+        })
+            .catch(() => {
+            if (settled) {
+                return;
+            }
+            settled = true;
+            clearTimeout(timer);
+            resolve(fallbackResponse);
+        });
+    });
+}
+async function promptAskUserQuestionWithReadline(rl, request) {
+    return runAskUserQuestionPrompt(request, () => promptAskUserQuestionInteractive(rl, request));
+}
+async function promptAskUserQuestionInteractive(rl, request) {
+    const answers = {};
+    for (const [index, question] of request.questions.entries()) {
+        const key = (0, core_1.getQuestionKey)(question, index);
+        const options = question.options ?? [];
+        if (question.header?.trim()) {
+            process.stderr.write(`\n${terminal_1.BOLD}${question.header.trim()}${terminal_1.RESET}\n`);
+        }
+        process.stderr.write(`${question.question}\n`);
+        if (options.length > 0 && (0, terminal_1.isTTYInput)(process.stdin)) {
+            // Arrow-key interactive selection
+            const optionLabels = options.map((o) => {
+                const desc = o.description ? ` ${terminal_1.DIM}${o.description}${terminal_1.RESET}` : "";
+                return `${o.label}${desc}`;
+            });
+            if (question.multiSelect) {
+                const result = await (0, terminal_1.promptArrowKeySelect)(process.stdin, process.stderr, optionLabels, { multiSelect: true });
+                if (Array.isArray(result) && result.length > 0) {
+                    answers[key] = result.map((i) => options[i].label).join(", ");
+                }
+                else if (!question.required) {
+                    answers[key] = "";
+                }
+                else {
+                    // Required but cancelled — use first option as fallback
+                    answers[key] = options[0].label;
+                }
+            }
+            else {
+                const result = await (0, terminal_1.promptArrowKeySelect)(process.stdin, process.stderr, optionLabels);
+                if (typeof result === "number") {
+                    answers[key] = options[result].label;
+                }
+                else if (!question.required) {
+                    answers[key] = "";
+                }
+                else {
+                    answers[key] = options[0].label;
+                }
+            }
+        }
+        else if (options.length > 0) {
+            // Fallback: line-based prompt for non-TTY
+            for (const [optionIndex, option] of options.entries()) {
+                const description = option.description ? ` ${terminal_1.DIM}${option.description}${terminal_1.RESET}` : "";
+                const preview = option.preview ? ` ${terminal_1.YELLOW}[preview]${terminal_1.RESET}` : "";
+                process.stderr.write(`  ${optionIndex + 1}. ${option.label}${description}${preview}\n`);
+            }
+            let answered = false;
+            while (!answered) {
+                const prompt = question.multiSelect
+                    ? "Choose one or more options (numbers or labels, comma-separated)"
+                    : "Choose an option (number or label)";
+                const answer = await askLine(rl, prompt);
+                const parsed = (0, core_1.parseOptionAnswer)(answer, question);
+                if (parsed !== undefined) {
+                    answers[key] = parsed;
+                    answered = true;
+                    continue;
+                }
+                process.stderr.write(`${terminal_1.YELLOW}Please choose a valid option.${terminal_1.RESET}\n`);
+            }
+        }
+        else {
+            let answered = false;
+            while (!answered) {
+                const answer = await askLine(rl, "Answer");
+                if (!answer && question.required) {
+                    process.stderr.write(`${terminal_1.YELLOW}An answer is required.${terminal_1.RESET}\n`);
+                    continue;
+                }
+                answers[key] = answer;
+                answered = true;
+            }
+        }
+    }
+    return (0, core_1.createAskUserQuestionResponse)(request, answers);
+}

package/dist/interaction/askUserQuestionTypes.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Type definitions for askUserQuestion.
+ * Extracted from askUserQuestion.ts for max-lines compliance.
+ */
+export interface AskUserQuestionOption {
+    label: string;
+    description?: string;
+    preview?: string;
+}
+export interface AskUserQuestionQuestion {
+    question: string;
+    header?: string;
+    options?: AskUserQuestionOption[];
+    multiSelect?: boolean;
+    allowOther?: boolean;
+    required?: boolean;
+    recommended?: number;
+}
+export interface AskUserQuestionRequest {
+    questions: AskUserQuestionQuestion[];
+    timeout?: number;
+}
+export interface AskUserQuestionResponse {
+    answers: Record<string, string>;
+}
+export interface AskUserQuestionUiContext {
+    select(title: string, options: string[]): Promise<string | undefined>;
+    input(title: string, placeholder?: string): Promise<string | undefined>;
+    confirm(title: string, message: string): Promise<boolean>;
+}
+//# sourceMappingURL=askUserQuestionTypes.d.ts.map

package/dist/interaction/askUserQuestionTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"askUserQuestionTypes.d.ts","sourceRoot":"","sources":["../../src/interaction/askUserQuestionTypes.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,qBAAqB,EAAE,CAAC;IAClC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,uBAAuB,EAAE,CAAC;IACrC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC;AAED,MAAM,WAAW,wBAAwB;IACvC,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IACtE,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IACxE,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC3D"}

package/dist/interaction/askUserQuestionTypes.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Type definitions for askUserQuestion.
+ * Extracted from askUserQuestion.ts for max-lines compliance.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/interaction/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./askUserQuestion";
+export { resolveInteractionUxHints } from './interactionRouter';
+export type { InteractionUxHints } from './interactionRouter';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/interaction/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,OAAO,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAChE,YAAY,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/interaction/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 });
+exports.resolveInteractionUxHints = void 0;
+__exportStar(require("./askUserQuestion"), exports);
+var interactionRouter_1 = require("./interactionRouter");
+Object.defineProperty(exports, "resolveInteractionUxHints", { enumerable: true, get: function () { return interactionRouter_1.resolveInteractionUxHints; } });

package/dist/interaction/interactionRouter.d.ts

@@ -0,0 +1,25 @@
+/**
+ * GAP-SEC-003: Interaction UX Routing
+ *
+ * Maps InteractionKind values to UX hints that harness adapters
+ * consume for kind-appropriate rendering.
+ *
+ * @module interaction/interactionRouter
+ */
+import type { InteractionKind } from '@a5c-ai/babysitter-sdk';
+/**
+ * UX hints for rendering a specific interaction kind.
+ */
+export interface InteractionUxHints {
+    urgency: 'low' | 'medium' | 'high';
+    requiresDecision: boolean;
+    presentAlwaysApprove: boolean;
+    defaultAutoApprove: boolean;
+    uiStyle: 'qa' | 'confirm' | 'alert' | 'banner' | 'summary';
+}
+/**
+ * Resolve UX hints for a given interaction kind.
+ * Pure function — no I/O.
+ */
+export declare function resolveInteractionUxHints(kind: InteractionKind): InteractionUxHints | undefined;
+//# sourceMappingURL=interactionRouter.d.ts.map

package/dist/interaction/interactionRouter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interactionRouter.d.ts","sourceRoot":"","sources":["../../src/interaction/interactionRouter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAE9D;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IACnC,gBAAgB,EAAE,OAAO,CAAC;IAC1B,oBAAoB,EAAE,OAAO,CAAC;IAC9B,kBAAkB,EAAE,OAAO,CAAC;IAC5B,OAAO,EAAE,IAAI,GAAG,SAAS,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,CAAC;CAC5D;AAwCD;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,eAAe,GAAG,kBAAkB,GAAG,SAAS,CAE/F"}

package/dist/interaction/interactionRouter.js

@@ -0,0 +1,55 @@
+"use strict";
+/**
+ * GAP-SEC-003: Interaction UX Routing
+ *
+ * Maps InteractionKind values to UX hints that harness adapters
+ * consume for kind-appropriate rendering.
+ *
+ * @module interaction/interactionRouter
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveInteractionUxHints = resolveInteractionUxHints;
+const HINTS_MAP = {
+    clarification: {
+        urgency: 'low',
+        requiresDecision: true,
+        presentAlwaysApprove: false,
+        defaultAutoApprove: false,
+        uiStyle: 'qa',
+    },
+    approval: {
+        urgency: 'medium',
+        requiresDecision: true,
+        presentAlwaysApprove: true,
+        defaultAutoApprove: false,
+        uiStyle: 'confirm',
+    },
+    intervention: {
+        urgency: 'high',
+        requiresDecision: true,
+        presentAlwaysApprove: false,
+        defaultAutoApprove: false,
+        uiStyle: 'alert',
+    },
+    notification: {
+        urgency: 'low',
+        requiresDecision: false,
+        presentAlwaysApprove: false,
+        defaultAutoApprove: true,
+        uiStyle: 'banner',
+    },
+    handoff: {
+        urgency: 'low',
+        requiresDecision: false,
+        presentAlwaysApprove: false,
+        defaultAutoApprove: false,
+        uiStyle: 'summary',
+    },
+};
+/**
+ * Resolve UX hints for a given interaction kind.
+ * Pure function — no I/O.
+ */
+function resolveInteractionUxHints(kind) {
+    return HINTS_MAP[kind];
+}

package/dist/mcp/channels/allowlist.d.ts

@@ -0,0 +1,19 @@
+/**
+ * GAP-MCPC-001: Channel Allowlist.
+ *
+ * Controls which MCP channels are active. Channels require explicit opt-in.
+ * Uses atomic write pattern consistent with other SDK state modules.
+ */
+import type { ChannelConfig, ChannelAllowlistFile } from "./types";
+export declare function getChannelAllowlistPath(stateDir: string): string;
+export declare function readChannelAllowlist(stateDir: string): Promise<ChannelAllowlistFile>;
+export declare function writeChannelAllowlist(stateDir: string, allowlist: ChannelAllowlistFile): Promise<void>;
+/** Add or update a channel in the allowlist. */
+export declare function upsertChannel(stateDir: string, channel: ChannelConfig): Promise<ChannelAllowlistFile>;
+/** Remove a channel from the allowlist. Returns true if removed. */
+export declare function removeChannel(stateDir: string, serverName: string, channelId: string): Promise<boolean>;
+/** Toggle a channel's enabled state. Returns the new enabled state. */
+export declare function toggleChannel(stateDir: string, serverName: string, channelId: string, enabled?: boolean): Promise<boolean | undefined>;
+/** Get all enabled channels. */
+export declare function getEnabledChannels(allowlist: ChannelAllowlistFile): ChannelConfig[];
+//# sourceMappingURL=allowlist.d.ts.map

package/dist/mcp/channels/allowlist.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"allowlist.d.ts","sourceRoot":"","sources":["../../../src/mcp/channels/allowlist.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAenE,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEhE;AAED,wBAAsB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC,CA+B1F;AAED,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,oBAAoB,GAC9B,OAAO,CAAC,IAAI,CAAC,CAGf;AAED,gDAAgD;AAChD,wBAAsB,aAAa,CACjC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,oBAAoB,CAAC,CAa/B;AAED,oEAAoE;AACpE,wBAAsB,aAAa,CACjC,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,OAAO,CAAC,CAUlB;AAED,uEAAuE;AACvE,wBAAsB,aAAa,CACjC,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,OAAO,GAChB,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC,CAU9B;AAED,gCAAgC;AAChC,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,oBAAoB,GAAG,aAAa,EAAE,CAEnF"}