@a5c-ai/babysitter-sdk 0.0.183-staging.f48a64a2 → 0.0.183-staging.f4d4d1df

package/dist/cli/commands/sessionCreate.d.ts

@@ -1,5 +1,5 @@
 /**
- * session:create command handler.
+ * harness:create-run command handler.
  *
  * Drives a full babysitter session lifecycle through two agentic phases:
  *   Phase 1 - Unbound interview / intent / process-definition

package/dist/cli/commands/sessionCreate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sessionCreate.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/sessionCreate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAWH,OAAO,KAAK,EACV,sBAAsB,EAKvB,MAAM,qBAAqB,CAAC;AA6B7B,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AA8LD,wBAAgB,aAAa,CAC3B,UAAU,EAAE,sBAAsB,EAAE,EACpC,SAAS,CAAC,EAAE,MAAM,GACjB,sBAAsB,GAAG,SAAS,CAkBpC;AA81HD,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,iBAAiB,GACxB,OAAO,CAAC,MAAM,CAAC,CAgFjB"}
+{"version":3,"file":"sessionCreate.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/sessionCreate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAWH,OAAO,KAAK,EACV,sBAAsB,EAKvB,MAAM,qBAAqB,CAAC;AAgC7B,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAmMD,wBAAgB,aAAa,CAC3B,UAAU,EAAE,sBAAsB,EAAE,EACpC,SAAS,CAAC,EAAE,MAAM,GACjB,sBAAsB,GAAG,SAAS,CAkBpC;AAk4HD,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,iBAAiB,GACxB,OAAO,CAAC,MAAM,CAAC,CAgFjB"}

package/dist/cli/commands/sessionCreate.js

@@ -1,6 +1,6 @@
 "use strict";
 /**
- * session:create command handler.
+ * harness:create-run command handler.
  *
  * Drives a full babysitter session lifecycle through two agentic phases:
  *   Phase 1 - Unbound interview / intent / process-definition
@@ -1592,10 +1592,15 @@ function isApprovalAskRequest(request) {
         labels[1] === "Reject" &&
         question.allowOther === false;
 }
-async function askUserQuestionViaTool(request, interactive, rl) {
+async function askUserQuestionViaTool(request, interactive, rl, toolContext) {
     (0, interaction_1.validateAskUserQuestionRequest)(request);
-    if (interactive && rl) {
-        return (0, interaction_1.promptAskUserQuestionWithReadline)(rl, request);
+    if (interactive) {
+        if (toolContext?.hasUI && toolContext.ui) {
+            return (0, interaction_1.promptAskUserQuestionWithUiContext)(toolContext.ui, request);
+        }
+        if (rl) {
+            return (0, interaction_1.promptAskUserQuestionWithReadline)(rl, request);
+        }
     }
     const answers = {};
     for (const [index, question] of request.questions.entries()) {
@@ -1716,7 +1721,7 @@ function buildExternalProcessDefinitionPrompt(args) {
         "- Keep the process practical for a brand-new directory: it should create the project, build the game, and verify that it runs or tests cleanly.",
     ].join("\n");
     return [
-        "You are running babysitter session:create phase 1 on an external CLI harness in non-interactive mode.",
+        "You are running babysitter harness:create-run phase 1 on an external CLI harness in non-interactive mode.",
         "Do the real process-authoring work in the workspace and write the actual process file to disk.",
         "",
         "Task:",
@@ -1947,6 +1952,9 @@ async function runProcessDefinitionPhase(args) {
     const state = {};
     const phaseOutputs = [];
     let session = null;
+    const interactiveUiContext = args.interactive && args.rl
+        ? (0, interaction_1.createReadlineAskUserQuestionUiContext)(args.rl)
+        : undefined;
     const writeVerbose = (message) => {
         writeVerboseLine(args.verbose, args.json, message);
     };
@@ -2039,9 +2047,9 @@ async function runProcessDefinitionPhase(args) {
             description: "Ask the user one to four structured clarification questions and receive structured answers.",
             promptSnippet: "Ask the user focused clarification questions when you need missing requirements.",
             parameters: ASK_USER_QUESTION_SCHEMA,
-            execute: async (_toolCallId, params) => {
+            execute: async (_toolCallId, params, _signal, _onUpdate, toolContext) => {
                 writeVerboseData("phase1 tool AskUserQuestion request", params);
-                const response = await askUserQuestionViaTool(params, args.interactive, args.rl);
+                const response = await askUserQuestionViaTool(params, args.interactive, args.rl, toolContext);
                 writeVerboseData("phase1 tool AskUserQuestion response", response);
                 emitProgress({
                     phase: "1",
@@ -2102,6 +2110,7 @@ async function runProcessDefinitionPhase(args) {
         thinkingLevel: "low",
         toolsMode: phase1ToolsMode,
         customTools,
+        uiContext: interactiveUiContext,
         systemPrompt: processDefinitionSystemPrompt,
         isolated: true,
         ephemeral: true,
@@ -2551,9 +2560,9 @@ async function runOrchestrationPhase(args) {
             description: "Ask the user one to four structured questions and receive structured answers.",
             promptSnippet: "Use this for breakpoint approvals and required user clarification.",
             parameters: ASK_USER_QUESTION_SCHEMA,
-            execute: async (_toolCallId, params) => {
+            execute: async (_toolCallId, params, _signal, _onUpdate, toolContext) => {
                 writeVerboseData("phase2 tool AskUserQuestion request", params);
-                const response = await askUserQuestionViaTool(params, args.interactive, args.rl);
+                const response = await askUserQuestionViaTool(params, args.interactive, args.rl, toolContext);
                 state.lastAskUserQuestionResponse = response;
                 writeVerboseData("phase2 tool AskUserQuestion response", response);
                 return formatToolResult(response, "AskUserQuestion completed.");
@@ -2910,6 +2919,9 @@ async function runOrchestrationPhase(args) {
                     };
                 }
                 if (!effectResult && action.kind === "breakpoint") {
+                    if (args.interactive && !state.lastAskUserQuestionResponse) {
+                        throw new exceptions_1.BabysitterRuntimeError("InteractiveBreakpointDecisionMissing", "Interactive breakpoint results require AskUserQuestion before babysitter_task_post_result.", { category: exceptions_1.ErrorCategory.Runtime });
+                    }
                     const question = action.taskDef?.question ??
                         action.taskDef?.title ??
                         "Breakpoint reached. Continue?";
@@ -3082,6 +3094,9 @@ async function runOrchestrationPhase(args) {
         model: args.model,
         toolsMode: "coding",
         customTools,
+        uiContext: args.interactive && args.rl
+            ? (0, interaction_1.createReadlineAskUserQuestionUiContext)(args.rl)
+            : undefined,
         appendSystemPrompt: [(0, sessionCreatePrompts_1.buildOrchestrationSystemPrompt)(args.selectedHarnessName, args.promptContext)],
         ephemeral: true,
     });

package/dist/cli/commands/sessionCreatePrompts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sessionCreatePrompts.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/sessionCreatePrompts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAElE,MAAM,WAAW,0BAA0B;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,mBAAmB,EAAE,sBAAsB,EAAE,CAAC;IAC9C,kBAAkB,EAAE,OAAO,CAAC;IAC5B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,oBAAoB,EAAE,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAC;IAClD,kBAAkB,EAAE,OAAO,CAAC;IAC5B,QAAQ,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAClD;AAED,MAAM,WAAW,kCAAkC;IACjD,WAAW,EAAE,OAAO,CAAC;IACrB,mBAAmB,CAAC,EAAE,OAAO,GAAG,WAAW,CAAC;IAC5C,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC7B;AAgFD,wBAAgB,kCAAkC,CAChD,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,0BAA0B,GAClC,MAAM,CAyCR;AAED,wBAAgB,gCAAgC,CAC9C,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,kCAAkC,GAC3C,MAAM,CA6CR;AAED,wBAAgB,8BAA8B,CAC5C,mBAAmB,EAAE,MAAM,EAC3B,OAAO,EAAE,0BAA0B,GAClC,MAAM,CA2BR;AAED,wBAAgB,iCAAiC,CAC/C,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,aAAa,EAAE,MAAM,GACpB,MAAM,CAWR;AAED,wBAAgB,4BAA4B,CAAC,IAAI,EAAE;IACjD,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,KAAK,CAAC;QACrB,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC,CAAC;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,GAAG,MAAM,CA+CT"}
+{"version":3,"file":"sessionCreatePrompts.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/sessionCreatePrompts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAElE,MAAM,WAAW,0BAA0B;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,mBAAmB,EAAE,sBAAsB,EAAE,CAAC;IAC9C,kBAAkB,EAAE,OAAO,CAAC;IAC5B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,oBAAoB,EAAE,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAC;IAClD,kBAAkB,EAAE,OAAO,CAAC;IAC5B,QAAQ,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAClD;AAED,MAAM,WAAW,kCAAkC;IACjD,WAAW,EAAE,OAAO,CAAC;IACrB,mBAAmB,CAAC,EAAE,OAAO,GAAG,WAAW,CAAC;IAC5C,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC7B;AAgFD,wBAAgB,kCAAkC,CAChD,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,0BAA0B,GAClC,MAAM,CA0CR;AAED,wBAAgB,gCAAgC,CAC9C,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,kCAAkC,GAC3C,MAAM,CAwDR;AAED,wBAAgB,8BAA8B,CAC5C,mBAAmB,EAAE,MAAM,EAC3B,OAAO,EAAE,0BAA0B,GAClC,MAAM,CA4BR;AAED,wBAAgB,iCAAiC,CAC/C,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,aAAa,EAAE,MAAM,GACpB,MAAM,CAWR;AAED,wBAAgB,4BAA4B,CAAC,IAAI,EAAE;IACjD,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,KAAK,CAAC;QACrB,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC,CAAC;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,GAAG,MAAM,CA+CT"}

package/dist/cli/commands/sessionCreatePrompts.js

@@ -79,15 +79,16 @@ function formatSharedContext(context) {
 }
 function buildProcessDefinitionSystemPrompt(outputPath, context) {
     return [
-        "You are the babysitter session:create phase 1 agent.",
+        "You are the babysitter harness:create-run phase 1 agent.",
         "Your job is to turn the user's intent into a concrete babysitter process definition before any run is created or bound.",
         "",
         "Rules:",
         "- This phase is unbound. Do not create a run, bind a session, iterate a run, or post task results.",
+        "- In interactive mode, AskUserQuestion is the only in-loop way to ask the user for clarification. If you need missing requirements, call AskUserQuestion instead of asking in plain text.",
         "- Use the AskUserQuestion tool when clarification is useful. Ask focused, high-signal questions in batches when possible.",
-        "- Before authoring the process in any mode, resolve the active shared process-library and conduct a real search against it. In this built-in PI path, use `babysitter_resolve_process_library`, `babysitter_search_process_library`, and `babysitter_read_process_library_file`; those tools are the internal `session:create` harness surface for process-library work. Outside this built-in path, use `babysitter process-library:active --json`, then search the returned `binding.dir`. Do not skip this process-library search step.",
+        "- Before authoring the process in any mode, resolve the active shared process-library and conduct a real search against it. In this built-in PI path, use `babysitter_resolve_process_library`, `babysitter_search_process_library`, and `babysitter_read_process_library_file`; those tools are the internal `harness:create-run` harness surface for process-library work. Outside this built-in path, use `babysitter process-library:active --json`, then search the returned `binding.dir`. Do not skip this process-library search step.",
         "- Treat `binding.dir` as the active process-library root that must be searched first. If you need the cloned repo root itself for adjacent material, use `defaultSpec.cloneDir`. Treat `reference/` under the active root or `defaultSpec.referenceRoot` as the canonical reference area.",
-        "- In interactive mode, follow a real interview phase: inspect the repo/workspace state first, inspect the most relevant process-library references through the active binding, then ask only the next highest-signal question. Do not plan more than one interview step ahead.",
+        "- In interactive mode, follow a real interview phase: inspect the repo/workspace state first, inspect the most relevant process-library references through the active binding, then ask only the next highest-signal AskUserQuestion when material ambiguity remains. Do not plan more than one interview step ahead.",
         "- In non-interactive mode, skip user questions but still parse the request, inspect the repo/workspace structure, resolve the active process-library root, and search that active library for the most relevant specialization or methodology before authoring the process.",
         "- Research the workspace before finalizing the process. Use your available read/search/bash/write tools as needed.",
         "- Treat the provided workspace as the only relevant filesystem root unless the user explicitly points you somewhere else.",
@@ -128,14 +129,21 @@ function buildProcessDefinitionUserPrompt(userPrompt, outputPath, options) {
         : "(no files)";
     const lines = [
         interactive
-            ? "Interactive mode. Ask focused clarification questions only when they materially improve the process."
+            ? "Interactive mode. Run the interview step first. If material requirements are missing, use AskUserQuestion rather than plain-text questions."
             : "Non-interactive mode. Do not call AskUserQuestion; infer missing details from the request and workspace state.",
         "",
         `User request: ${userPrompt}`,
         `Output path: ${outputPath}`,
     ];
     if (workspaceAssessment === "empty") {
-        lines.push("Workspace assessment: empty.", `Workspace entries: ${workspaceSummary}`, "Treat this as a greenfield request and move straight to authoring the process.", "You still must resolve the active shared process-library and search it before writing the process.", "Start with the repo/workspace state, then inspect only the most relevant local babysitter process references or discover output before you author the process.", "Do not inspect unrelated directories, home-directory configs, or irrelevant global skill/plugin folders.", "Keep the process practical for a brand-new workspace: plan, scaffold, implement, verify.", "Write a real babysitter process, not a direct one-shot script. The top-level `process()` should orchestrate work through `defineTask(...)` and `ctx.task(...)`.", "Put the main implementation in one or more `agent` tasks. Use `shell` tasks only for concrete runnable verification or tooling commands.", "Do not add internal worker guardrail metadata such as `task.metadata.bashSandbox`, `task.metadata.isolated`, or `task.metadata.enableCompaction` unless the task truly requires them.", "Keep generated asset strings syntax-safe. If the process writes JS/HTML/CSS files, avoid raw nested template literals inside the process module; prefer arrays joined with \"\\n\", String.raw, or escaped inner backticks and \\${...} sequences.");
+        lines.push("Workspace assessment: empty.", `Workspace entries: ${workspaceSummary}`);
+        if (interactive) {
+            lines.push("Treat this as a greenfield request, but do not skip the interview just because the workspace is empty.", "If material product or delivery constraints remain ambiguous after workspace and process-library inspection, ask the next highest-signal AskUserQuestion before you finalize the process.");
+        }
+        else {
+            lines.push("Treat this as a greenfield request and move straight to authoring the process.");
+        }
+        lines.push("You still must resolve the active shared process-library and search it before writing the process.", "Start with the repo/workspace state, then inspect only the most relevant local babysitter process references or discover output before you author the process.", "Do not inspect unrelated directories, home-directory configs, or irrelevant global skill/plugin folders.", "Keep the process practical for a brand-new workspace: plan, scaffold, implement, verify.", "Write a real babysitter process, not a direct one-shot script. The top-level `process()` should orchestrate work through `defineTask(...)` and `ctx.task(...)`.", "Put the main implementation in one or more `agent` tasks. Use `shell` tasks only for concrete runnable verification or tooling commands.", "Do not add internal worker guardrail metadata such as `task.metadata.bashSandbox`, `task.metadata.isolated`, or `task.metadata.enableCompaction` unless the task truly requires them.", "Keep generated asset strings syntax-safe. If the process writes JS/HTML/CSS files, avoid raw nested template literals inside the process module; prefer arrays joined with \"\\n\", String.raw, or escaped inner backticks and \\${...} sequences.");
     }
     else if (workspaceAssessment === "non-empty") {
         lines.push(`Workspace assessment: non-empty (${workspaceSummary}).`, "Inspect only the workspace files that are relevant to the request before finalizing the process.", "Do not wander through unrelated global directories or repositories.");
@@ -145,20 +153,21 @@ function buildProcessDefinitionUserPrompt(userPrompt, outputPath, options) {
 }
 function buildOrchestrationSystemPrompt(selectedHarnessName, context) {
     return [
-        "You are the babysitter session:create phase 2 orchestration agent.",
+        "You are the babysitter harness:create-run phase 2 orchestration agent.",
         "Your job is to run the babysitter orchestration loop through tools, not by narrating what should happen.",
         "Follow the babysit workflow directly: run one iteration, inspect the returned effects, perform the requested effects through the babysitter effect tools and available coding tools, post the results, and repeat until the run reaches a terminal state.",
         "",
         "Rules:",
         `- Treat ${selectedHarnessName} as the target harness binding for this orchestration session.`,
         "- You have your built-in coding tools (bash/read/write/edit/search) plus the custom babysitter tools below. Use them to do the orchestration work itself.",
+        "- AskUserQuestion is the in-loop user interaction tool for this phase. In interactive mode, use it instead of asking the user in plain text.",
         "- Call babysitter_run_create to create the run if it does not already exist.",
         "- Immediately call babysitter_bind_session after run creation and before the first orchestration iteration.",
         "- Work in bounded turns. In each turn, call babysitter_run_iterate at most once unless the prompt explicitly tells you otherwise.",
         "- When babysitter_run_iterate reports pending effects, resolve each effect through tools.",
-        "- For breakpoint effects, use AskUserQuestion in interactive mode. In non-interactive mode, select the best option according to the user intent and current context. Then call babysitter_task_post_result.",
+        "- For breakpoint effects, use AskUserQuestion in interactive mode with explicit approval options, then call babysitter_task_post_result. Never auto-approve or fabricate an approval response. In non-interactive mode, select the best option according to the user intent and current context, then call babysitter_task_post_result.",
         "- For `shell` effects, prefer `babysitter_run_shell_effect` so the command executes on an internal PI worker that respects task metadata. Use raw bash/coding tools only when the effect payload clearly requires manual inspection or direct intervention before posting the explicit outcome with babysitter_task_post_result.",
-        "- For `agent`, `node`, and `orchestrator_task` effects, prefer babysitter_dispatch_effect_harness so the pending effect is fulfilled through the intended harness wrapper. These babysitter effect tools are the built-in internal `session:create` harness surface for phase 2. If you fulfill an effect directly with your own coding tools, you must still call babysitter_task_post_result with the explicit outcome.",
+        "- For `agent`, `node`, and `orchestrator_task` effects, prefer babysitter_dispatch_effect_harness so the pending effect is fulfilled through the intended harness wrapper. These babysitter effect tools are the built-in internal `harness:create-run` harness surface for phase 2. If you fulfill an effect directly with your own coding tools, you must still call babysitter_task_post_result with the explicit outcome.",
         "- Do not rely on a hidden host-side effect executor. Perform or dispatch each effect intentionally based on the effect payload you received from babysitter_run_iterate.",
         "- Shell effects are first-class pending effects. Do not skip them, narrate them, or assume the host will run them for you.",
         "- When choosing how to execute pending work, respect task-level harness metadata and the installed harness catalog provided below.",
@@ -217,7 +226,7 @@ function buildOrchestrationTurnPrompt(args) {
         lines.push("Handling rules:");
         lines.push("- For `shell` effects, prefer babysitter_run_shell_effect, then call babysitter_task_post_result with explicit status/stdout/stderr/value fields.");
         lines.push("- For `agent`, `node`, or `orchestrator_task` effects, prefer babysitter_dispatch_effect_harness unless direct coding-tool execution is clearly better for the requested effect.");
-        lines.push("- For `breakpoint` effects, use AskUserQuestion in interactive mode or choose the best option non-interactively, then post the result.");
+        lines.push("- For `breakpoint` effects, use AskUserQuestion in interactive mode with explicit approval options or choose the best option non-interactively, then post the result.");
     }
     else {
         lines.push("");

package/dist/cli/main.js

@@ -120,7 +120,7 @@ const USAGE = `Usage:
   babysitter compression:toggle <layer> <on|off> [--json]
   babysitter compression:set <layer.key> <value> [--json]
   babysitter compression:reset [--json]
-  babysitter session:create --prompt <text> [--harness <name>] [--process <path>] [--workspace <dir>] [--model <model>] [--max-iterations <n>] [--runs-dir <dir>] [--interactive|--no-interactive|--non-interactive] [--json] [--verbose]
+  babysitter harness:create-run --prompt <text> [--harness <name>] [--process <path>] [--workspace <dir>] [--model <model>] [--max-iterations <n>] [--runs-dir <dir>] [--interactive|--no-interactive|--non-interactive] [--json] [--verbose]
   babysitter harness:discover [--json]
   babysitter harness:list [--json]
   babysitter harness:install <name> [--workspace <dir>] [--json] [--dry-run] [--verbose]
@@ -1905,7 +1905,7 @@ const VALID_COMMANDS = [
     "session:check-iteration",
     "session:last-message",
     "session:iteration-message",
-    "session:create",
+    "harness:create-run",
     "hook:log",
     "hook:run",
     "skill:discover",
@@ -2407,7 +2407,7 @@ function createBabysitterCli() {
                 if (parsed.command === "harness:invoke") {
                     return await handleHarnessInvoke(parsed);
                 }
-                if (parsed.command === "session:create") {
+                if (parsed.command === "harness:create-run") {
                     const { handleSessionCreate } = await Promise.resolve().then(() => __importStar(require("./commands/sessionCreate")));
                     return await handleSessionCreate({
                         prompt: parsed.prompt,

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

@@ -1 +1 @@
-{"version":3,"file":"claudeCode.d.ts","sourceRoot":"","sources":["../../src/harness/claudeCode.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AA+BH,OAAO,KAAK,EACV,cAAc,EAMf,MAAM,SAAS,CAAC;AAghCjB,wBAAgB,uBAAuB,IAAI,cAAc,CAwExD"}
+{"version":3,"file":"claudeCode.d.ts","sourceRoot":"","sources":["../../src/harness/claudeCode.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AA+BH,OAAO,KAAK,EACV,cAAc,EAMf,MAAM,SAAS,CAAC;AAsjCjB,wBAAgB,uBAAuB,IAAI,cAAc,CAwExD"}

package/dist/harness/claudeCode.js

@@ -155,6 +155,15 @@ function countPendingByKind(records) {
     }
     return Object.fromEntries(Array.from(counts.entries()).sort(([a], [b]) => a.localeCompare(b)));
 }
+/**
+ * Returns true when every pending effect is a breakpoint (human-approval gate).
+ * Breakpoints require external human action, so the stop hook should allow exit
+ * rather than spinning the orchestration loop uselessly.
+ */
+function isOnlyBreakpoints(pendingByKind) {
+    const keys = Object.keys(pendingByKind);
+    return keys.length === 1 && keys[0] === "breakpoint";
+}
 // ---------------------------------------------------------------------------
 // Cleanup helper
 // ---------------------------------------------------------------------------
@@ -407,6 +416,7 @@ async function handleStopHookImpl(args) {
     let runState = "";
     let completionProof = "";
     let pendingKinds = "";
+    let onlyBreakpointsPending = false;
     let entrypointImportPath;
     if (runId) {
         try {
@@ -442,6 +452,7 @@ async function handleStopHookImpl(args) {
             if (kindKeys.length > 0) {
                 pendingKinds = kindKeys.join(", ");
             }
+            onlyBreakpointsPending = pendingRecords.length > 0 && isOnlyBreakpoints(pendingByKind);
             if (hasCompleted) {
                 runState = "completed";
                 completionProof = (0, completionProof_1.resolveCompletionProof)(metadata);
@@ -486,6 +497,29 @@ async function handleStopHookImpl(args) {
             return 0;
         }
     }
+    // 5b. If the run is waiting but ONLY on breakpoints, allow exit.
+    // Breakpoints require human interaction — spinning the orchestration loop
+    // accomplishes nothing and wastes iterations. The user (or an external
+    // system) must resolve breakpoints before the run can proceed.
+    if (runState === "waiting" && onlyBreakpointsPending) {
+        log.info(`Run waiting on breakpoints only (${pendingKinds}) — allowing exit`);
+        if (verbose) {
+            process.stderr.write(`[hook:run stop] Run waiting on breakpoint(s) — allowing exit for human resolution\n`);
+        }
+        if (runId) {
+            await appendStopHookEvent(path.join(runsDir, runId), {
+                sessionId,
+                iteration: state.iteration,
+                decision: "approve",
+                reason: "breakpoint_waiting",
+                runState,
+                pendingKinds,
+                hasPromise,
+            });
+        }
+        process.stdout.write("{}\n");
+        return 0;
+    }
     // 6. If completionProof matches promiseValue → complete
     if (hasPromise) {
         log.info("Detected valid promise tag");

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

@@ -1 +1 @@
-{"version":3,"file":"geminiCli.d.ts","sourceRoot":"","sources":["../../src/harness/geminiCli.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAsBH,OAAO,KAAK,EACV,cAAc,EAMf,MAAM,SAAS,CAAC;AAsxBjB,wBAAgB,sBAAsB,IAAI,cAAc,CA8EvD"}
+{"version":3,"file":"geminiCli.d.ts","sourceRoot":"","sources":["../../src/harness/geminiCli.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAsBH,OAAO,KAAK,EACV,cAAc,EAMf,MAAM,SAAS,CAAC;AA2zBjB,wBAAgB,sBAAsB,IAAI,cAAc,CA8EvD"}

package/dist/harness/geminiCli.js

@@ -175,6 +175,15 @@ function countPendingByKind(records) {
     }
     return Object.fromEntries(Array.from(counts.entries()).sort(([a], [b]) => a.localeCompare(b)));
 }
+/**
+ * Returns true when every pending effect is a breakpoint (human-approval gate).
+ * Breakpoints require external human action, so the stop hook should allow exit
+ * rather than spinning the orchestration loop uselessly.
+ */
+function isOnlyBreakpoints(pendingByKind) {
+    const keys = Object.keys(pendingByKind);
+    return keys.length === 1 && keys[0] === "breakpoint";
+}
 // ---------------------------------------------------------------------------
 // Cleanup helper
 // ---------------------------------------------------------------------------
@@ -362,6 +371,7 @@ async function handleAfterAgentHookImpl(args) {
     let runState = "";
     let completionProof = "";
     let pendingKinds = "";
+    let onlyBreakpointsPending = false;
     try {
         let runDir = path.isAbsolute(runId)
             ? runId
@@ -394,6 +404,7 @@ async function handleAfterAgentHookImpl(args) {
         if (kindKeys.length > 0) {
             pendingKinds = kindKeys.join(", ");
         }
+        onlyBreakpointsPending = pendingRecords.length > 0 && isOnlyBreakpoints(pendingByKind);
         if (hasCompleted) {
             runState = "completed";
             completionProof = (0, completionProof_1.resolveCompletionProof)(metadata);
@@ -430,6 +441,28 @@ async function handleAfterAgentHookImpl(args) {
         process.stdout.write("{}\n");
         return 0;
     }
+    // 9b. If the run is waiting but ONLY on breakpoints, allow exit.
+    // Breakpoints require human interaction — spinning the orchestration loop
+    // accomplishes nothing and wastes iterations.
+    if (runState === "waiting" && onlyBreakpointsPending) {
+        log.info(`Run waiting on breakpoints only (${pendingKinds}) — allowing exit`);
+        if (verbose) {
+            process.stderr.write(`[hook:run after-agent] Run waiting on breakpoint(s) — allowing exit for human resolution\n`);
+        }
+        if (runId) {
+            await appendStopHookEvent(path.join(runsDir, runId), {
+                sessionId,
+                iteration: state.iteration,
+                decision: "approve",
+                reason: "breakpoint_waiting",
+                runState,
+                pendingKinds,
+                hasPromise,
+            });
+        }
+        process.stdout.write("{}\n");
+        return 0;
+    }
     // 10. Check completion proof match
     if (hasPromise && completionProof && promiseValue === completionProof) {
         log.info("Promise matches completion proof — allowing exit");

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

@@ -1 +1 @@
-{"version":3,"file":"piWrapper.d.ts","sourceRoot":"","sources":["../../src/harness/piWrapper.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAYhF,sCAAsC;AACtC,MAAM,MAAM,eAAe,GAAG,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;AAmP9D;;;;;GAKG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmB;IAC3C,OAAO,CAAC,OAAO,CAA+B;IAC9C,OAAO,CAAC,WAAW,CAA8B;IACjD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAyC;gBAE1D,OAAO,GAAE,gBAAqB;IAI1C;;;;;OAKG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAcjC;;;;;OAKG;IACG,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAyGrE;;;;;OAKG;IACG,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKxC;;OAEG;IACG,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAK3C;;;;OAIG;IACH,SAAS,CAAC,QAAQ,EAAE,eAAe,GAAG,MAAM,IAAI;IAKhD;;OAEG;IACG,WAAW,CACf,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GAChC,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;QAAC,SAAS,EAAE,OAAO,CAAA;KAAE,CAAC;IAWhF;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAM5B;;OAEG;IACH,OAAO,IAAI,IAAI;IAcf,oDAAoD;IACpD,IAAI,SAAS,IAAI,MAAM,GAAG,SAAS,CAElC;IAED,6DAA6D;IAC7D,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED,gDAAgD;IAChD,IAAI,aAAa,IAAI,OAAO,CAE3B;YAMa,YAAY;IAmJ1B,OAAO,CAAC,cAAc;CAUvB;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,eAAe,CAE3E"}
+{"version":3,"file":"piWrapper.d.ts","sourceRoot":"","sources":["../../src/harness/piWrapper.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAYhF,sCAAsC;AACtC,MAAM,MAAM,eAAe,GAAG,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;AAoP9D;;;;;GAKG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmB;IAC3C,OAAO,CAAC,OAAO,CAA+B;IAC9C,OAAO,CAAC,WAAW,CAA8B;IACjD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAyC;gBAE1D,OAAO,GAAE,gBAAqB;IAI1C;;;;;OAKG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAcjC;;;;;OAKG;IACG,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAyGrE;;;;;OAKG;IACG,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKxC;;OAEG;IACG,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAK3C;;;;OAIG;IACH,SAAS,CAAC,QAAQ,EAAE,eAAe,GAAG,MAAM,IAAI;IAKhD;;OAEG;IACG,WAAW,CACf,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GAChC,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;QAAC,SAAS,EAAE,OAAO,CAAA;KAAE,CAAC;IAWhF;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAM5B;;OAEG;IACH,OAAO,IAAI,IAAI;IAcf,oDAAoD;IACpD,IAAI,SAAS,IAAI,MAAM,GAAG,SAAS,CAElC;IAED,6DAA6D;IAC7D,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED,gDAAgD;IAChD,IAAI,aAAa,IAAI,OAAO,CAE3B;YAMa,YAAY;IAsJ1B,OAAO,CAAC,cAAc;CAUvB;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,eAAe,CAE3E"}

package/dist/harness/piWrapper.js

@@ -527,6 +527,9 @@ class PiSessionHandle {
         }
         try {
             const { session } = await mod.createAgentSession(createOpts);
+            if (this.options.uiContext && typeof session.bindExtensions === "function") {
+                await session.bindExtensions({ uiContext: this.options.uiContext });
+            }
             this.session = session;
         }
         catch (error) {

package/dist/harness/types.d.ts

@@ -6,6 +6,7 @@
  * hook input/output formats. The adapter interface abstracts these differences
  * so the SDK core remains harness-agnostic.
  */
+import type { AskUserQuestionUiContext } from "../interaction";
 /** Capabilities that a harness adapter may support. */
 export declare enum HarnessCapability {
     /** Harness supports programmatic (non-interactive) invocation. */
@@ -96,6 +97,8 @@ export interface PiSessionOptions {
     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. */

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

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

package/dist/interaction/askUserQuestion.d.ts

@@ -18,8 +18,15 @@ export interface AskUserQuestionRequest {
 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>;
+}
 export declare function validateAskUserQuestionRequest(request: AskUserQuestionRequest): void;
 export declare function createAskUserQuestionResponse(request: AskUserQuestionRequest, answers: Record<string, string>): AskUserQuestionResponse;
 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

@@ -1 +1 @@
-{"version":3,"file":"askUserQuestion.d.ts","sourceRoot":"","sources":["../../src/interaction/askUserQuestion.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAC;AAa1C,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;CACpB;AAED,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,uBAAuB,EAAE,CAAC;CACtC;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC;AA2DD,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,sBAAsB,GAC9B,IAAI,CAuCN;AAED,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,sBAAsB,EAC/B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC9B,uBAAuB,CAUzB;AAED,wBAAgB,6BAA6B,CAC3C,QAAQ,EAAE,MAAM,EAChB,MAAM,GAAE,MAAmB,GAC1B,sBAAsB,CAqBxB;AAED,wBAAsB,iCAAiC,CACrD,EAAE,EAAE,QAAQ,CAAC,SAAS,EACtB,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,uBAAuB,CAAC,CAsDlC"}
+{"version":3,"file":"askUserQuestion.d.ts","sourceRoot":"","sources":["../../src/interaction/askUserQuestion.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAC;AAa1C,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;CACpB;AAED,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,uBAAuB,EAAE,CAAC;CACtC;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;AA2DD,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,sBAAsB,GAC9B,IAAI,CAuCN;AAED,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,sBAAsB,EAC/B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC9B,uBAAuB,CAUzB;AAED,wBAAgB,6BAA6B,CAC3C,QAAQ,EAAE,MAAM,EAChB,MAAM,GAAE,MAAmB,GAC1B,sBAAsB,CAqBxB;AAqBD,wBAAgB,sCAAsC,CACpD,EAAE,EAAE,QAAQ,CAAC,SAAS,GACrB,wBAAwB,CA+B1B;AAED,wBAAsB,kCAAkC,CACtD,EAAE,EAAE,wBAAwB,EAC5B,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,uBAAuB,CAAC,CAiGlC;AAED,wBAAsB,iCAAiC,CACrD,EAAE,EAAE,QAAQ,CAAC,SAAS,EACtB,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,uBAAuB,CAAC,CAsDlC"}

package/dist/interaction/askUserQuestion.js

@@ -3,6 +3,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.validateAskUserQuestionRequest = validateAskUserQuestionRequest;
 exports.createAskUserQuestionResponse = createAskUserQuestionResponse;
 exports.createApprovalAskUserQuestion = createApprovalAskUserQuestion;
+exports.createReadlineAskUserQuestionUiContext = createReadlineAskUserQuestionUiContext;
+exports.promptAskUserQuestionWithUiContext = promptAskUserQuestionWithUiContext;
 exports.promptAskUserQuestionWithReadline = promptAskUserQuestionWithReadline;
 const RESET = "\x1b[0m";
 const BOLD = "\x1b[1m";
@@ -116,6 +118,135 @@ function createApprovalAskUserQuestion(question, header = "Decision") {
         ],
     };
 }
+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`);
+            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 = resolveOption(answer, options.map((label) => ({ label })));
+                if (matched) {
+                    return matched.label;
+                }
+                process.stderr.write(`${YELLOW}Please choose a valid option.${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) {
+    validateAskUserQuestionRequest(request);
+    const answers = {};
+    for (const [index, question] of request.questions.entries()) {
+        const key = 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 = 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 = parseOptionAnswer(selection, {
+                ...question,
+                allowOther: false,
+            });
+            if (parsed !== undefined) {
+                answers[key] = parsed;
+                resolved = true;
+            }
+        }
+    }
+    return createAskUserQuestionResponse(request, answers);
+}
 async function promptAskUserQuestionWithReadline(rl, request) {
     validateAskUserQuestionRequest(request);
     const answers = {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@a5c-ai/babysitter-sdk",
-  "version": "0.0.183-staging.f48a64a2",
+  "version": "0.0.183-staging.f4d4d1df",
   "description": "Storage and run-registry primitives for event-sourced babysitter workflows.",
   "license": "UNLICENSED",
   "type": "commonjs",