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

package/dist/harness/types.d.ts

@@ -0,0 +1,276 @@
+/**
+ * Harness adapter interface.
+ *
+ * A "harness" is the host tool that invokes the babysitter SDK (e.g. Claude Code,
+ * Cursor, Windsurf). Each harness has its own session lifecycle, env vars, and
+ * hook input/output formats. The adapter interface abstracts these differences
+ * so the SDK core remains harness-agnostic.
+ */
+import type { AskUserQuestionUiContext } from "../interaction";
+import type { PromptContext } from "@a5c-ai/babysitter-sdk";
+/** Capabilities that a harness adapter may support. */
+export declare enum HarnessCapability {
+    /** Harness supports programmatic (non-interactive) invocation. */
+    Programmatic = "programmatic",
+    /** Harness can bind a babysitter run to a host session. */
+    SessionBinding = "session-binding",
+    /** Harness implements the stop-hook lifecycle event. */
+    StopHook = "stop-hook",
+    /** Harness exposes an MCP (Model Context Protocol) server. */
+    Mcp = "mcp",
+    /** Harness can accept a prompt without a TTY (headless mode). */
+    HeadlessPrompt = "headless-prompt",
+    /** Harness supports concurrent effect execution (GAP-PAR-001). */
+    ConcurrentEffects = "concurrent-effects",
+    /** Harness supports async/background effects (GAP-PAR-002). */
+    BackgroundEffects = "background-effects",
+    /** Harness supports multi-harness parallel dispatch (GAP-PAR-003). */
+    MultiHarnessDispatch = "multi-harness-dispatch"
+}
+/**
+ * Result of probing the local environment for a specific harness CLI.
+ *
+ * This is the **installed-discovery** result — it answers "is this CLI on
+ * PATH?" and "does config exist?".  It does NOT report whether we are
+ * currently running inside this harness; use `CallerHarnessResult` /
+ * `detectCallerHarness()` for that.
+ */
+export interface HarnessDiscoveryResult {
+    /** Harness identifier (matches HarnessAdapter.name). */
+    name: string;
+    /** Whether the CLI binary was found on the system. */
+    installed: boolean;
+    /** Semantic version reported by the CLI, if obtainable. */
+    version?: string;
+    /** Absolute path to the CLI binary, if resolved. */
+    cliPath?: string;
+    /** Shell command used to invoke the CLI. */
+    cliCommand: string;
+    /** Whether harness-specific configuration was found on disk. */
+    configFound: boolean;
+    /** Capabilities advertised by this harness. */
+    capabilities: HarnessCapability[];
+    /** Platform identifier (e.g. "win32", "linux", "darwin"). */
+    platform: string;
+}
+/** Result of detecting which harness spawned the current process, if any. */
+export interface CallerHarnessResult {
+    /** Harness identifier (matches HarnessAdapter.name). */
+    name: string;
+    /** Environment variable names that matched the active caller. */
+    matchedEnvVars: string[];
+    /** Capabilities advertised by the detected caller harness. */
+    capabilities: HarnessCapability[];
+}
+/** Callback invoked with each raw chunk from stdout or stderr. */
+export type StreamingOutputCallback = (chunk: string) => void;
+/** Callback invoked with each complete line and its source stream. */
+export type StreamingLineCallback = (line: string, source: "stdout" | "stderr") => void;
+/** Options for real-time streaming output capture from harness invocations. */
+export interface StreamingOutputOptions {
+    /** Called with each stdout chunk as it arrives. */
+    onStdout?: StreamingOutputCallback;
+    /** Called with each stderr chunk as it arrives. */
+    onStderr?: StreamingOutputCallback;
+    /** Called with each complete line (from either stream) as it becomes available. */
+    onLine?: StreamingLineCallback;
+}
+/** Options for programmatically invoking a harness CLI. */
+export interface HarnessInvokeOptions {
+    /** The prompt to send to the harness. */
+    prompt: string;
+    /** Working directory for the invocation. */
+    workspace?: string;
+    /** Model override (harness-specific). */
+    model?: string;
+    /** Maximum execution time in milliseconds. */
+    timeout?: number;
+    /** Whether to use RPC/structured-output mode. */
+    rpc?: boolean;
+    /** Additional environment variables passed to the child process. */
+    env?: Record<string, string>;
+    /** Real-time streaming output callbacks (GAP-SUBOBS-001). */
+    streaming?: StreamingOutputOptions;
+    /** AbortSignal to cancel the invocation and kill the child process. */
+    signal?: AbortSignal;
+}
+/** Result returned after a harness CLI invocation completes. */
+export interface HarnessInvokeResult {
+    /** Whether the invocation completed without error. */
+    success: boolean;
+    /** Combined stdout/stderr output from the CLI. */
+    output: string;
+    /** Process exit code. */
+    exitCode: number;
+    /** Wall-clock duration of the invocation in milliseconds. */
+    duration: number;
+    /** Name of the harness that was invoked. */
+    harness: string;
+    /** GAP-PERF-004: Whether output was streamed in real-time. */
+    streamed?: boolean;
+    /** GAP-PERF-004: Number of streaming chunks emitted. */
+    streamChunkCount?: number;
+}
+/** Options for creating a Pi harness session (programmatic API). */
+export interface AgentCoreSessionOptions {
+    /** Working directory for the session. */
+    workspace?: string;
+    /** Model identifier string (e.g. "claude-opus-4-5"). */
+    model?: string;
+    /** Maximum time in ms to wait for a single prompt to complete. */
+    timeout?: number;
+    /** Thinking level for the model. */
+    thinkingLevel?: "minimal" | "low" | "medium" | "high" | "xhigh";
+    /** Built-in tool mode to expose to the model. */
+    toolsMode?: "default" | "coding" | "readonly";
+    /** Custom tool definitions to register with the session. */
+    customTools?: unknown[];
+    /** Optional extension-style UI context exposed to custom tools inside the PI loop. */
+    uiContext?: AskUserQuestionUiContext;
+    /** Replace the discovered system prompt with a custom one. */
+    systemPrompt?: string;
+    /** Append custom system prompt instructions. */
+    appendSystemPrompt?: string[];
+    /** Isolate the session from discovered extensions, skills, and AGENTS files. */
+    isolated?: boolean;
+    /** Use an in-memory session manager instead of persistent session files. */
+    ephemeral?: boolean;
+    /** Bash tool execution backend. Defaults to native/local PI execution; "secure" opts into the sandbox backend and "auto" falls back to local. */
+    bashSandbox?: "auto" | "secure" | "local";
+    /** Whether PI session compaction should be enabled for this session. */
+    enableCompaction?: boolean;
+    /** Global pi agent config directory (default: ~/.pi/agent). */
+    agentDir?: string;
+    /** Minimum delay before retrying PI session initialization after a failure. */
+    initFailureBackoffMs?: number;
+}
+/**
+ * Event emitted by a Pi session during prompt execution.
+ * Mirrors the AgentSessionEvent union from `@earendil-works/pi-coding-agent`.
+ */
+export interface AgentCoreSessionEvent {
+    type: string;
+    [key: string]: unknown;
+}
+/** Result of sending a prompt through a Pi session. */
+export interface AgentCorePromptResult {
+    /** Collected text output from the agent response. */
+    output: string;
+    /** Wall-clock duration in milliseconds. */
+    duration: number;
+    /** Whether the prompt completed without error. */
+    success: boolean;
+    /** Exit code (0 = success, 1 = failure). */
+    exitCode: number;
+    /** Provider-reported token usage, when available. */
+    usage?: {
+        inputTokens: number;
+        outputTokens: number;
+        totalTokens: number;
+        provider?: string;
+        model?: string;
+    };
+}
+export interface SessionBindOptions {
+    sessionId: string;
+    runId: string;
+    runDir: string;
+    pluginRoot?: string;
+    stateDir?: string;
+    runsDir?: string;
+    maxIterations?: number;
+    prompt: string;
+    verbose: boolean;
+    json: boolean;
+}
+export interface SessionBindResult {
+    harness: string;
+    sessionId: string;
+    stateFile?: string;
+    error?: string;
+    /** When true, the error is fatal and run:create should exit non-zero. */
+    fatal?: boolean;
+}
+export interface HookHandlerArgs {
+    pluginRoot?: string;
+    stateDir?: string;
+    runsDir?: string;
+    json: boolean;
+    verbose?: boolean;
+}
+export interface HarnessInstallOptions {
+    workspace?: string;
+    json: boolean;
+    dryRun: boolean;
+    verbose: boolean;
+}
+export interface HarnessInstallResult {
+    harness: string;
+    dryRun?: boolean;
+    warning?: string;
+    summary?: string;
+    command?: string;
+    output?: string;
+    location?: string;
+}
+export interface HarnessAdapter {
+    /** Harness identifier (e.g. "claude-code") */
+    readonly name: string;
+    /** Does this harness appear to be active? (env var detection) */
+    isActive(): boolean;
+    /** Resolve session ID from CLI args / env vars / env file */
+    resolveSessionId(parsed: {
+        sessionId?: string;
+    }): string | undefined;
+    /** Resolve state directory from args / env */
+    resolveStateDir(args: {
+        stateDir?: string;
+        pluginRoot?: string;
+    }): string | undefined;
+    /** Resolve plugin root from args / env */
+    resolvePluginRoot(args: {
+        pluginRoot?: string;
+    }): string | undefined;
+    /**
+     * Whether this adapter auto-resolves session IDs from environment variables
+     * or other ambient sources.  When true, explicitly passing `--session-id`
+     * is rejected as a conflict.  Defaults to `false` when not implemented.
+     */
+    autoResolvesSessionId?(): boolean;
+    /** Guidance shown when a harness-specific session ID is required but missing. */
+    getMissingSessionIdHint?(): string;
+    /** Whether this harness truthfully supports a given SDK hook entrypoint. */
+    supportsHookType?(hookType: string): boolean;
+    /** Message shown when a hook type is requested but unsupported by the harness. */
+    getUnsupportedHookMessage?(hookType: string): string;
+    /** Bind a run to the caller's session (run:create flow) */
+    bindSession(opts: SessionBindOptions): Promise<SessionBindResult>;
+    /** Handle the stop hook (decision: approve/block) */
+    handleStopHook(args: HookHandlerArgs): Promise<number>;
+    /** Handle the session-start hook (env file + state file setup) */
+    handleSessionStartHook(args: HookHandlerArgs): Promise<number>;
+    /** Find hook dispatcher path (for shell hook execution) */
+    findHookDispatcherPath(startCwd: string): string | null;
+    /** Check whether the harness CLI binary is installed and reachable. */
+    isCliInstalled?(): Promise<boolean>;
+    /** Return CLI metadata (command name, version, resolved path). */
+    getCliInfo?(): Promise<{
+        command: string;
+        version?: string;
+        path?: string;
+    }>;
+    /** List capabilities supported by this harness adapter. */
+    getCapabilities?(): HarnessCapability[];
+    /** Install the harness CLI itself. */
+    installHarness?(options: HarnessInstallOptions): Promise<HarnessInstallResult>;
+    /** Install or materialize the Babysitter plugin/extension integration for this harness. */
+    installPlugin?(options: HarnessInstallOptions): Promise<HarnessInstallResult>;
+    /**
+     * Return a PromptContext pre-configured for this harness.
+     * Centralizes harness-specific prompt configuration in the adapter itself.
+     */
+    getPromptContext?(opts?: {
+        interactive?: boolean | undefined;
+    }): PromptContext;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/harness/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/harness/types.ts"],"names":[],"mappings":"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"}

package/dist/harness/types.js

@@ -0,0 +1,34 @@
+"use strict";
+/**
+ * Harness adapter interface.
+ *
+ * A "harness" is the host tool that invokes the babysitter SDK (e.g. Claude Code,
+ * Cursor, Windsurf). Each harness has its own session lifecycle, env vars, and
+ * hook input/output formats. The adapter interface abstracts these differences
+ * so the SDK core remains harness-agnostic.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HarnessCapability = void 0;
+// ---------------------------------------------------------------------------
+// Harness capability enum
+// ---------------------------------------------------------------------------
+/** Capabilities that a harness adapter may support. */
+var HarnessCapability;
+(function (HarnessCapability) {
+    /** Harness supports programmatic (non-interactive) invocation. */
+    HarnessCapability["Programmatic"] = "programmatic";
+    /** Harness can bind a babysitter run to a host session. */
+    HarnessCapability["SessionBinding"] = "session-binding";
+    /** Harness implements the stop-hook lifecycle event. */
+    HarnessCapability["StopHook"] = "stop-hook";
+    /** Harness exposes an MCP (Model Context Protocol) server. */
+    HarnessCapability["Mcp"] = "mcp";
+    /** Harness can accept a prompt without a TTY (headless mode). */
+    HarnessCapability["HeadlessPrompt"] = "headless-prompt";
+    /** Harness supports concurrent effect execution (GAP-PAR-001). */
+    HarnessCapability["ConcurrentEffects"] = "concurrent-effects";
+    /** Harness supports async/background effects (GAP-PAR-002). */
+    HarnessCapability["BackgroundEffects"] = "background-effects";
+    /** Harness supports multi-harness parallel dispatch (GAP-PAR-003). */
+    HarnessCapability["MultiHarnessDispatch"] = "multi-harness-dispatch";
+})(HarnessCapability || (exports.HarnessCapability = HarnessCapability = {}));

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+export * from "./harness";
+export * from "./runtime";
+export * from "./api";
+export * from "./daemon";
+export * from "./interaction";
+export * as anycli from "./anycli";
+export * as cost from "./cost";
+export * as governance from "./governance";
+export * from "./observability";
+export * as session from "./session";
+export * as storage from "./storage";
+export * as tasks from "./tasks";
+export * as processes from "./processes";
+export * as skills from "./skills";
+export * as plugins from "./plugins";
+//# 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,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,OAAO,CAAC;AACtB,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC;AAC9B,OAAO,KAAK,MAAM,MAAM,UAAU,CAAC;AACnC,OAAO,KAAK,IAAI,MAAM,QAAQ,CAAC;AAC/B,OAAO,KAAK,UAAU,MAAM,cAAc,CAAC;AAC3C,cAAc,iBAAiB,CAAC;AAChC,OAAO,KAAK,OAAO,MAAM,WAAW,CAAC;AACrC,OAAO,KAAK,OAAO,MAAM,WAAW,CAAC;AACrC,OAAO,KAAK,KAAK,MAAM,SAAS,CAAC;AACjC,OAAO,KAAK,SAAS,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,MAAM,MAAM,UAAU,CAAC;AACnC,OAAO,KAAK,OAAO,MAAM,WAAW,CAAC"}

package/dist/index.js

@@ -0,0 +1,54 @@
+"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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+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);
+};
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.plugins = exports.skills = exports.processes = exports.tasks = exports.storage = exports.session = exports.governance = exports.cost = exports.anycli = void 0;
+__exportStar(require("./harness"), exports);
+__exportStar(require("./runtime"), exports);
+__exportStar(require("./api"), exports);
+__exportStar(require("./daemon"), exports);
+__exportStar(require("./interaction"), exports);
+exports.anycli = __importStar(require("./anycli"));
+exports.cost = __importStar(require("./cost"));
+exports.governance = __importStar(require("./governance"));
+__exportStar(require("./observability"), exports);
+exports.session = __importStar(require("./session"));
+exports.storage = __importStar(require("./storage"));
+exports.tasks = __importStar(require("./tasks"));
+exports.processes = __importStar(require("./processes"));
+exports.skills = __importStar(require("./skills"));
+exports.plugins = __importStar(require("./plugins"));

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

@@ -0,0 +1,8 @@
+import type { AskUserQuestionOption, AskUserQuestionQuestion, AskUserQuestionRequest, AskUserQuestionResponse } from "../askUserQuestion";
+export declare function getQuestionKey(question: AskUserQuestionQuestion, index: number): string;
+export declare function resolveOption(token: string, options: AskUserQuestionOption[]): AskUserQuestionOption | undefined;
+export declare function parseOptionAnswer(rawAnswer: string, question: AskUserQuestionQuestion): string | undefined;
+export declare function validateAskUserQuestionRequest(request: AskUserQuestionRequest): void;
+export declare function createAskUserQuestionResponse(request: AskUserQuestionRequest, answers: Record<string, string>): AskUserQuestionResponse;
+export declare function createDefaultAskUserQuestionResponse(request: AskUserQuestionRequest): AskUserQuestionResponse;
+//# sourceMappingURL=core.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../../src/interaction/askUserQuestion/core.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,qBAAqB,EACrB,uBAAuB,EACvB,sBAAsB,EACtB,uBAAuB,EACxB,MAAM,oBAAoB,CAAC;AAO5B,wBAAgB,cAAc,CAAC,QAAQ,EAAE,uBAAuB,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAMvF;AAED,wBAAgB,aAAa,CAC3B,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,qBAAqB,EAAE,GAC/B,qBAAqB,GAAG,SAAS,CAQnC;AAED,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,uBAAuB,GAChC,MAAM,GAAG,SAAS,CA2BpB;AAED,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,sBAAsB,GAC9B,IAAI,CA0CN;AAED,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,sBAAsB,EAC/B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC9B,uBAAuB,CAUzB;AA0BD,wBAAgB,oCAAoC,CAClD,OAAO,EAAE,sBAAsB,GAC9B,uBAAuB,CAEzB"}

package/dist/interaction/askUserQuestion/core.js

@@ -0,0 +1,112 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getQuestionKey = getQuestionKey;
+exports.resolveOption = resolveOption;
+exports.parseOptionAnswer = parseOptionAnswer;
+exports.validateAskUserQuestionRequest = validateAskUserQuestionRequest;
+exports.createAskUserQuestionResponse = createAskUserQuestionResponse;
+exports.createDefaultAskUserQuestionResponse = createDefaultAskUserQuestionResponse;
+const MIN_QUESTION_COUNT = 1;
+const MAX_QUESTION_COUNT = 4;
+const MIN_OPTION_COUNT = 2;
+const MAX_OPTION_COUNT = 4;
+function getQuestionKey(question, index) {
+    const header = question.header?.trim();
+    if (header) {
+        return header;
+    }
+    return `Question ${index + 1}`;
+}
+function resolveOption(token, options) {
+    if (/^\d+$/.test(token)) {
+        const index = Number(token) - 1;
+        return index >= 0 && index < options.length ? options[index] : undefined;
+    }
+    const normalized = token.trim().toLowerCase();
+    return options.find((option) => option.label.trim().toLowerCase() === normalized);
+}
+function parseOptionAnswer(rawAnswer, question) {
+    const trimmed = rawAnswer.trim();
+    if (!trimmed) {
+        return undefined;
+    }
+    const options = question.options ?? [];
+    const parts = question.multiSelect
+        ? trimmed.split(",").map((part) => part.trim()).filter(Boolean)
+        : [trimmed];
+    const selectedLabels = [];
+    for (const part of parts) {
+        const option = resolveOption(part, options);
+        if (!option) {
+            return question.allowOther === false ? undefined : trimmed;
+        }
+        if (!selectedLabels.includes(option.label)) {
+            selectedLabels.push(option.label);
+        }
+    }
+    if (!question.multiSelect && selectedLabels.length > 1) {
+        return undefined;
+    }
+    return question.multiSelect ? selectedLabels.join(", ") : selectedLabels[0];
+}
+function validateAskUserQuestionRequest(request) {
+    if (!Array.isArray(request.questions)) {
+        throw new Error("AskUserQuestion requires a questions array.");
+    }
+    if (request.questions.length < MIN_QUESTION_COUNT ||
+        request.questions.length > MAX_QUESTION_COUNT) {
+        throw new Error(`AskUserQuestion requires ${MIN_QUESTION_COUNT}-${MAX_QUESTION_COUNT} questions.`);
+    }
+    for (const question of request.questions) {
+        if (!question.question?.trim()) {
+            throw new Error("AskUserQuestion questions must include non-empty question text.");
+        }
+        if (!question.options) {
+            continue;
+        }
+        if (question.options.length < MIN_OPTION_COUNT ||
+            question.options.length > MAX_OPTION_COUNT) {
+            throw new Error(`AskUserQuestion option-based questions require ${MIN_OPTION_COUNT}-${MAX_OPTION_COUNT} options.`);
+        }
+        if (question.multiSelect && question.options.some((option) => option.preview?.trim())) {
+            throw new Error("AskUserQuestion preview is only supported for single-select questions.");
+        }
+        for (const option of question.options) {
+            if (!option.label?.trim()) {
+                throw new Error("AskUserQuestion options must include a non-empty label.");
+            }
+        }
+    }
+}
+function createAskUserQuestionResponse(request, answers) {
+    validateAskUserQuestionRequest(request);
+    const normalizedAnswers = {};
+    for (const [index, question] of request.questions.entries()) {
+        const key = getQuestionKey(question, index);
+        normalizedAnswers[key] = answers[key] ?? "";
+    }
+    return { answers: normalizedAnswers };
+}
+function getDefaultAnswerForQuestion(question) {
+    const options = question.options ?? [];
+    if (question.recommended != null &&
+        options.length > 0 &&
+        options[question.recommended]) {
+        return options[question.recommended].label;
+    }
+    if (options.length > 0) {
+        return options[0].label;
+    }
+    return "";
+}
+function buildDefaultAnswers(request) {
+    const answers = {};
+    for (const [index, question] of request.questions.entries()) {
+        const key = getQuestionKey(question, index);
+        answers[key] = getDefaultAnswerForQuestion(question);
+    }
+    return answers;
+}
+function createDefaultAskUserQuestionResponse(request) {
+    return createAskUserQuestionResponse(request, buildDefaultAnswers(request));
+}

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

@@ -0,0 +1,15 @@
+import type { Readable, Writable } from "node:stream";
+export declare const RESET = "\u001B[0m";
+export declare const BOLD = "\u001B[1m";
+export declare const CYAN = "\u001B[36m";
+export declare const DIM = "\u001B[2m";
+export declare const YELLOW = "\u001B[33m";
+interface ArrowSelectOptions {
+    multiSelect?: boolean;
+}
+export declare function isTTYInput(stream: Readable): stream is NodeJS.ReadStream & {
+    setRawMode: (mode: boolean) => void;
+};
+export declare function promptArrowKeySelect(input: NodeJS.ReadStream, output: Writable, options: string[], opts?: ArrowSelectOptions): Promise<number | number[] | undefined>;
+export {};
+//# sourceMappingURL=terminal.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"terminal.d.ts","sourceRoot":"","sources":["../../../src/interaction/askUserQuestion/terminal.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEtD,eAAO,MAAM,KAAK,cAAY,CAAC;AAC/B,eAAO,MAAM,IAAI,cAAY,CAAC;AAC9B,eAAO,MAAM,IAAI,eAAa,CAAC;AAC/B,eAAO,MAAM,GAAG,cAAY,CAAC;AAC7B,eAAO,MAAM,MAAM,eAAa,CAAC;AAQjC,UAAU,kBAAkB;IAC1B,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,wBAAgB,UAAU,CACxB,MAAM,EAAE,QAAQ,GACf,MAAM,IAAI,MAAM,CAAC,UAAU,GAAG;IAAE,UAAU,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAA;CAAE,CAEvE;AA6CD,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,MAAM,CAAC,UAAU,EACxB,MAAM,EAAE,QAAQ,EAChB,OAAO,EAAE,MAAM,EAAE,EACjB,IAAI,CAAC,EAAE,kBAAkB,GACxB,OAAO,CAAC,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,CAqFxC"}