@code-yeongyu/senpi 2026.9.9 → 2026.9.10

package/dist/core/extensions/builtin/ask-user/params.d.ts

@@ -0,0 +1,27 @@
+import { Type } from "typebox";
+export declare const CODEX_PARAMS: Type.TObject<{
+    questions: Type.TArray<Type.TObject<{
+        id: Type.TString;
+        header: Type.TString;
+        question: Type.TString;
+        options: Type.TArray<Type.TObject<{
+            label: Type.TString;
+            description: Type.TString;
+        }>>;
+        multiSelect: Type.TOptional<Type.TBoolean>;
+    }>>;
+    wait_for_answer: Type.TBoolean;
+}>;
+export declare const CLAUDE_PARAMS: Type.TObject<{
+    questions: Type.TArray<Type.TObject<{
+        question: Type.TString;
+        header: Type.TString;
+        options: Type.TOptional<Type.TArray<Type.TObject<{
+            label: Type.TString;
+            description: Type.TOptional<Type.TString>;
+        }>>>;
+        multiSelect: Type.TBoolean;
+    }>>;
+    waitForAnswer: Type.TBoolean;
+}>;
+//# sourceMappingURL=params.d.ts.map

package/dist/core/extensions/builtin/ask-user/params.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"params.d.ts","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/ask-user/params.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AA0C/B,eAAO,MAAM,YAAY;;;;;;;;;;;;EAaxB,CAAC;AAyCF,eAAO,MAAM,aAAa;;;;;;;;;;;EAUxB,CAAC"}

package/dist/core/extensions/builtin/ask-user/params.js

@@ -0,0 +1,78 @@
+import { Type } from "typebox";
+const CODEX_OPTION = Type.Object({
+    label: Type.String({ description: "User-facing label (1-5 words)." }),
+    description: Type.String({
+        description: "One short sentence explaining impact/tradeoff if selected.",
+    }),
+}, { additionalProperties: false });
+const CODEX_QUESTION = Type.Object({
+    id: Type.String({
+        pattern: "^[a-z][a-z0-9]*(_[a-z0-9]+)*$",
+        description: "Stable identifier for mapping answers (snake_case).",
+    }),
+    header: Type.String({
+        minLength: 1,
+        maxLength: 12,
+        description: "Short header label shown in the UI (12 or fewer chars).",
+    }),
+    question: Type.String({
+        minLength: 1,
+        description: "Single-sentence prompt shown to the user.",
+    }),
+    options: Type.Array(CODEX_OPTION, {
+        minItems: 2,
+        maxItems: 3,
+        description: 'Provide 2-3 mutually exclusive choices. Put the recommended option first and suffix its label with "(Recommended)". Do not include an "Other" option in this list; the client will add a free-form "Other" option automatically.',
+    }),
+    multiSelect: Type.Optional(Type.Boolean({
+        description: "Set to true to allow the user to select multiple options instead of just one.",
+    })),
+}, { additionalProperties: false });
+export const CODEX_PARAMS = Type.Object({
+    questions: Type.Array(CODEX_QUESTION, {
+        minItems: 1,
+        maxItems: 3,
+        description: "Questions to show the user. Prefer 1 and do not exceed 3",
+    }),
+    wait_for_answer: Type.Boolean({
+        description: "Set true to pause here until the user answers; set false to keep working and receive the answer later as a user message.",
+    }),
+}, { additionalProperties: false });
+const CLAUDE_OPTION = Type.Object({
+    label: Type.String({
+        description: "The display text for this option that the user will see and select. Should be concise (1-5 words) and clearly describe the choice.",
+    }),
+    description: Type.Optional(Type.String({
+        description: "Explanation of what this option means or what will happen if chosen. Useful for providing context about trade-offs or implications.",
+    })),
+});
+const CLAUDE_QUESTION = Type.Object({
+    question: Type.String({
+        minLength: 1,
+        description: 'The complete question to ask the user. Should be clear, specific, and end with a question mark. Example: "Which library should we use for date formatting?" If multiSelect is true, phrase it accordingly, e.g. "Which features do you want to enable?"',
+    }),
+    header: Type.String({
+        minLength: 1,
+        maxLength: 12,
+        description: 'Very short label displayed as a chip/tag (max 12 chars). Examples: "Auth method", "Library", "Approach".',
+    }),
+    options: Type.Optional(Type.Array(CLAUDE_OPTION, {
+        minItems: 2,
+        maxItems: 4,
+        description: "The available choices for this question. Must have 2-4 options. Each option should be a distinct, mutually exclusive choice (unless multiSelect is enabled). There should be no Other option, that will be provided automatically.",
+    })),
+    multiSelect: Type.Boolean({
+        description: "Set to true to allow the user to select multiple options instead of just one. Use when choices are not mutually exclusive.",
+    }),
+});
+export const CLAUDE_PARAMS = Type.Object({
+    questions: Type.Array(CLAUDE_QUESTION, {
+        minItems: 1,
+        maxItems: 4,
+        description: "Questions to ask the user (1-4 questions)",
+    }),
+    waitForAnswer: Type.Boolean({
+        description: "Set true to pause here until the user answers; set false to keep working and receive the answer later as a user message.",
+    }),
+});
+//# sourceMappingURL=params.js.map

package/dist/core/extensions/builtin/ask-user/params.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"params.js","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/ask-user/params.ts"],"names":[],"mappings":"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","sourcesContent":["import { Type } from \"typebox\";\n\nconst CODEX_OPTION = Type.Object(\n\t{\n\t\tlabel: Type.String({ description: \"User-facing label (1-5 words).\" }),\n\t\tdescription: Type.String({\n\t\t\tdescription: \"One short sentence explaining impact/tradeoff if selected.\",\n\t\t}),\n\t},\n\t{ additionalProperties: false },\n);\n\nconst CODEX_QUESTION = Type.Object(\n\t{\n\t\tid: Type.String({\n\t\t\tpattern: \"^[a-z][a-z0-9]*(_[a-z0-9]+)*$\",\n\t\t\tdescription: \"Stable identifier for mapping answers (snake_case).\",\n\t\t}),\n\t\theader: Type.String({\n\t\t\tminLength: 1,\n\t\t\tmaxLength: 12,\n\t\t\tdescription: \"Short header label shown in the UI (12 or fewer chars).\",\n\t\t}),\n\t\tquestion: Type.String({\n\t\t\tminLength: 1,\n\t\t\tdescription: \"Single-sentence prompt shown to the user.\",\n\t\t}),\n\t\toptions: Type.Array(CODEX_OPTION, {\n\t\t\tminItems: 2,\n\t\t\tmaxItems: 3,\n\t\t\tdescription:\n\t\t\t\t'Provide 2-3 mutually exclusive choices. Put the recommended option first and suffix its label with \"(Recommended)\". Do not include an \"Other\" option in this list; the client will add a free-form \"Other\" option automatically.',\n\t\t}),\n\t\tmultiSelect: Type.Optional(\n\t\t\tType.Boolean({\n\t\t\t\tdescription: \"Set to true to allow the user to select multiple options instead of just one.\",\n\t\t\t}),\n\t\t),\n\t},\n\t{ additionalProperties: false },\n);\n\nexport const CODEX_PARAMS = Type.Object(\n\t{\n\t\tquestions: Type.Array(CODEX_QUESTION, {\n\t\t\tminItems: 1,\n\t\t\tmaxItems: 3,\n\t\t\tdescription: \"Questions to show the user. Prefer 1 and do not exceed 3\",\n\t\t}),\n\t\twait_for_answer: Type.Boolean({\n\t\t\tdescription:\n\t\t\t\t\"Set true to pause here until the user answers; set false to keep working and receive the answer later as a user message.\",\n\t\t}),\n\t},\n\t{ additionalProperties: false },\n);\n\nconst CLAUDE_OPTION = Type.Object({\n\tlabel: Type.String({\n\t\tdescription:\n\t\t\t\"The display text for this option that the user will see and select. Should be concise (1-5 words) and clearly describe the choice.\",\n\t}),\n\tdescription: Type.Optional(\n\t\tType.String({\n\t\t\tdescription:\n\t\t\t\t\"Explanation of what this option means or what will happen if chosen. Useful for providing context about trade-offs or implications.\",\n\t\t}),\n\t),\n});\n\nconst CLAUDE_QUESTION = Type.Object({\n\tquestion: Type.String({\n\t\tminLength: 1,\n\t\tdescription:\n\t\t\t'The complete question to ask the user. Should be clear, specific, and end with a question mark. Example: \"Which library should we use for date formatting?\" If multiSelect is true, phrase it accordingly, e.g. \"Which features do you want to enable?\"',\n\t}),\n\theader: Type.String({\n\t\tminLength: 1,\n\t\tmaxLength: 12,\n\t\tdescription:\n\t\t\t'Very short label displayed as a chip/tag (max 12 chars). Examples: \"Auth method\", \"Library\", \"Approach\".',\n\t}),\n\toptions: Type.Optional(\n\t\tType.Array(CLAUDE_OPTION, {\n\t\t\tminItems: 2,\n\t\t\tmaxItems: 4,\n\t\t\tdescription:\n\t\t\t\t\"The available choices for this question. Must have 2-4 options. Each option should be a distinct, mutually exclusive choice (unless multiSelect is enabled). There should be no Other option, that will be provided automatically.\",\n\t\t}),\n\t),\n\tmultiSelect: Type.Boolean({\n\t\tdescription:\n\t\t\t\"Set to true to allow the user to select multiple options instead of just one. Use when choices are not mutually exclusive.\",\n\t}),\n});\n\nexport const CLAUDE_PARAMS = Type.Object({\n\tquestions: Type.Array(CLAUDE_QUESTION, {\n\t\tminItems: 1,\n\t\tmaxItems: 4,\n\t\tdescription: \"Questions to ask the user (1-4 questions)\",\n\t}),\n\twaitForAnswer: Type.Boolean({\n\t\tdescription:\n\t\t\t\"Set true to pause here until the user answers; set false to keep working and receive the answer later as a user message.\",\n\t}),\n});\n"]}

package/dist/core/extensions/builtin/ask-user/pending.d.ts

@@ -0,0 +1,58 @@
+export type QuestionOption = {
+    label: string;
+    description?: string;
+};
+export type QuestionItem = {
+    id: string;
+    header: string;
+    question: string;
+    options: QuestionOption[];
+    multiSelect: boolean;
+};
+export type QuestionRequest = {
+    requestId: string;
+    questions: QuestionItem[];
+    waitForAnswer: boolean;
+    timeoutMs: number;
+};
+export type QuestionAnswer = {
+    selected: string[];
+    text?: string;
+};
+export type QuestionAnswers = Record<string, QuestionAnswer>;
+export type QuestionResponseStatus = "answered" | "comment-submitted" | "timed_out" | "cancelled" | "orphaned-after-restart" | "unavailable";
+export type QuestionResponse = {
+    status: QuestionResponseStatus;
+    answers: QuestionAnswers;
+    comment?: string;
+    unanswered: string[];
+    autoResolvedAfterMs?: number;
+};
+export type QuestionDraft = {
+    answers: QuestionAnswers;
+    comment?: string;
+};
+export type CancelReason = "cancelled" | "orphaned-after-restart" | "unavailable";
+export type PendingTimerHandle = ReturnType<typeof setTimeout>;
+export type PendingQuestionOptions = {
+    request: QuestionRequest;
+    now: () => number;
+    idleTimeoutMs: number;
+    hardCapMs?: number;
+    onTimeout?: (result: QuestionResponse) => void;
+    setTimeout?: (handler: () => void, delayMs: number) => PendingTimerHandle;
+    clearTimeout?: (handle: PendingTimerHandle) => void;
+};
+export type PendingQuestionState = "pending" | QuestionResponseStatus;
+export type PendingQuestion = {
+    touch(draft?: QuestionDraft): void;
+    submit(answers: QuestionAnswers, comment?: string): QuestionResponse | false;
+    cancel(reason?: CancelReason): QuestionResponse;
+    timeout(): QuestionResponse;
+    readonly state: PendingQuestionState;
+    readonly deadlineAtMs: number;
+    remainingMs(now: number): number;
+    readonly result: QuestionResponse | undefined;
+};
+export declare function createPendingQuestion(options: PendingQuestionOptions): PendingQuestion;
+//# sourceMappingURL=pending.d.ts.map

package/dist/core/extensions/builtin/ask-user/pending.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pending.d.ts","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/ask-user/pending.ts"],"names":[],"mappings":"AACA,MAAM,MAAM,cAAc,GAAG;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,WAAW,EAAE,OAAO,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,YAAY,EAAE,CAAC;IAC1B,aAAa,EAAE,OAAO,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC5B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;AAE7D,MAAM,MAAM,sBAAsB,GAC/B,UAAU,GACV,mBAAmB,GACnB,WAAW,GACX,WAAW,GACX,wBAAwB,GACxB,aAAa,CAAC;AAEjB,MAAM,MAAM,gBAAgB,GAAG;IAC9B,MAAM,EAAE,sBAAsB,CAAC;IAC/B,OAAO,EAAE,eAAe,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC3B,OAAO,EAAE,eAAe,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG,WAAW,GAAG,wBAAwB,GAAG,aAAa,CAAC;AAIlF,MAAM,MAAM,kBAAkB,GAAG,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC;AAE/D,MAAM,MAAM,sBAAsB,GAAG;IACpC,OAAO,EAAE,eAAe,CAAC;IACzB,GAAG,EAAE,MAAM,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,gBAAgB,KAAK,IAAI,CAAC;IAC/C,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,IAAI,EAAE,OAAO,EAAE,MAAM,KAAK,kBAAkB,CAAC;IAC1E,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,kBAAkB,KAAK,IAAI,CAAC;CACpD,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG,SAAS,GAAG,sBAAsB,CAAC;AAEtE,MAAM,MAAM,eAAe,GAAG;IAC7B,KAAK,CAAC,KAAK,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;IACnC,MAAM,CAAC,OAAO,EAAE,eAAe,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,gBAAgB,GAAG,KAAK,CAAC;IAC7E,MAAM,CAAC,MAAM,CAAC,EAAE,YAAY,GAAG,gBAAgB,CAAC;IAChD,OAAO,IAAI,gBAAgB,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,oBAAoB,CAAC;IACrC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,gBAAgB,GAAG,SAAS,CAAC;CAC9C,CAAC;AA+CF,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,sBAAsB,GAAG,eAAe,CA0FtF"}

package/dist/core/extensions/builtin/ask-user/pending.js

@@ -0,0 +1,130 @@
+const DEFAULT_HARD_CAP_MS = 7_200_000;
+function copyAnswers(answers) {
+    const copied = {};
+    for (const [id, answer] of Object.entries(answers)) {
+        copied[id] = {
+            selected: [...answer.selected],
+            ...(answer.text !== undefined ? { text: answer.text } : {}),
+        };
+    }
+    return copied;
+}
+function hasAnswer(answer) {
+    if (answer === undefined)
+        return false;
+    if (answer.selected.length > 0)
+        return true;
+    return answer.text !== undefined && answer.text.trim() !== "";
+}
+function unansweredIds(request, answers) {
+    const unanswered = [];
+    for (const question of request.questions) {
+        if (!hasAnswer(answers[question.id]))
+            unanswered.push(question.id);
+    }
+    return unanswered;
+}
+function isCommentPresent(comment) {
+    return comment !== undefined && comment.trim() !== "";
+}
+function buildResponse(status, request, answers, comment, autoResolvedAfterMs) {
+    return {
+        status,
+        answers: copyAnswers(answers),
+        ...(isCommentPresent(comment) ? { comment } : {}),
+        unanswered: unansweredIds(request, answers),
+        ...(autoResolvedAfterMs !== undefined ? { autoResolvedAfterMs } : {}),
+    };
+}
+export function createPendingQuestion(options) {
+    const createdAtMs = options.now();
+    const hardCapMs = options.hardCapMs ?? DEFAULT_HARD_CAP_MS;
+    const hardDeadlineAtMs = createdAtMs + hardCapMs;
+    const schedule = options.setTimeout ?? ((handler, delayMs) => setTimeout(handler, delayMs));
+    const unsched = options.clearTimeout ?? clearTimeout;
+    let deadlineAtMs = Math.min(createdAtMs + options.idleTimeoutMs, hardDeadlineAtMs);
+    let draftAnswers = {};
+    let draftComment;
+    let terminal;
+    let timer;
+    const disarm = () => {
+        if (timer === undefined)
+            return;
+        unsched(timer);
+        timer = undefined;
+    };
+    const settle = (response, notifyTimeout) => {
+        if (terminal !== undefined)
+            return terminal;
+        terminal = response;
+        disarm();
+        if (notifyTimeout)
+            options.onTimeout?.(response);
+        return response;
+    };
+    const fireTimeout = () => {
+        const elapsedMs = Math.max(0, options.now() - createdAtMs);
+        return settle(buildResponse("timed_out", options.request, draftAnswers, draftComment, elapsedMs), true);
+    };
+    const arm = () => {
+        disarm();
+        if (terminal !== undefined)
+            return;
+        const delayMs = deadlineAtMs - options.now();
+        if (delayMs <= 0) {
+            fireTimeout();
+            return;
+        }
+        timer = schedule(() => {
+            timer = undefined;
+            fireTimeout();
+        }, delayMs);
+    };
+    arm();
+    return {
+        touch(draft) {
+            if (terminal !== undefined)
+                return;
+            if (draft !== undefined) {
+                draftAnswers = copyAnswers(draft.answers);
+                draftComment = draft.comment;
+            }
+            deadlineAtMs = Math.min(options.now() + options.idleTimeoutMs, hardDeadlineAtMs);
+            arm();
+        },
+        submit(answers, comment) {
+            if (terminal !== undefined)
+                return terminal;
+            if (isCommentPresent(comment)) {
+                return settle(buildResponse("comment-submitted", options.request, answers, comment), false);
+            }
+            if (unansweredIds(options.request, answers).length === 0) {
+                return settle(buildResponse("answered", options.request, answers, comment), false);
+            }
+            return false;
+        },
+        cancel(reason = "cancelled") {
+            if (terminal !== undefined)
+                return terminal;
+            return settle(buildResponse(reason, options.request, draftAnswers, draftComment), false);
+        },
+        timeout() {
+            if (terminal !== undefined)
+                return terminal;
+            return fireTimeout();
+        },
+        get state() {
+            return terminal?.status ?? "pending";
+        },
+        get deadlineAtMs() {
+            return deadlineAtMs;
+        },
+        remainingMs(now) {
+            return Math.max(0, deadlineAtMs - now);
+        },
+        get result() {
+            return terminal;
+        },
+    };
+}
+//# sourceMappingURL=pending.js.map

package/dist/core/extensions/builtin/ask-user/pending.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pending.js","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/ask-user/pending.ts"],"names":[],"mappings":"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","sourcesContent":["// TODO(t1-merge): import from ./schema.ts\nexport type QuestionOption = {\n\tlabel: string;\n\tdescription?: string;\n};\n\nexport type QuestionItem = {\n\tid: string;\n\theader: string;\n\tquestion: string;\n\toptions: QuestionOption[];\n\tmultiSelect: boolean;\n};\n\nexport type QuestionRequest = {\n\trequestId: string;\n\tquestions: QuestionItem[];\n\twaitForAnswer: boolean;\n\ttimeoutMs: number;\n};\n\nexport type QuestionAnswer = {\n\tselected: string[];\n\ttext?: string;\n};\n\nexport type QuestionAnswers = Record<string, QuestionAnswer>;\n\nexport type QuestionResponseStatus =\n\t| \"answered\"\n\t| \"comment-submitted\"\n\t| \"timed_out\"\n\t| \"cancelled\"\n\t| \"orphaned-after-restart\"\n\t| \"unavailable\";\n\nexport type QuestionResponse = {\n\tstatus: QuestionResponseStatus;\n\tanswers: QuestionAnswers;\n\tcomment?: string;\n\tunanswered: string[];\n\tautoResolvedAfterMs?: number;\n};\n\nexport type QuestionDraft = {\n\tanswers: QuestionAnswers;\n\tcomment?: string;\n};\n\nexport type CancelReason = \"cancelled\" | \"orphaned-after-restart\" | \"unavailable\";\n\nconst DEFAULT_HARD_CAP_MS = 7_200_000;\n\nexport type PendingTimerHandle = ReturnType<typeof setTimeout>;\n\nexport type PendingQuestionOptions = {\n\trequest: QuestionRequest;\n\tnow: () => number;\n\tidleTimeoutMs: number;\n\thardCapMs?: number;\n\tonTimeout?: (result: QuestionResponse) => void;\n\tsetTimeout?: (handler: () => void, delayMs: number) => PendingTimerHandle;\n\tclearTimeout?: (handle: PendingTimerHandle) => void;\n};\n\nexport type PendingQuestionState = \"pending\" | QuestionResponseStatus;\n\nexport type PendingQuestion = {\n\ttouch(draft?: QuestionDraft): void;\n\tsubmit(answers: QuestionAnswers, comment?: string): QuestionResponse | false;\n\tcancel(reason?: CancelReason): QuestionResponse;\n\ttimeout(): QuestionResponse;\n\treadonly state: PendingQuestionState;\n\treadonly deadlineAtMs: number;\n\tremainingMs(now: number): number;\n\treadonly result: QuestionResponse | undefined;\n};\n\nfunction copyAnswers(answers: QuestionAnswers): QuestionAnswers {\n\tconst copied: QuestionAnswers = {};\n\tfor (const [id, answer] of Object.entries(answers)) {\n\t\tcopied[id] = {\n\t\t\tselected: [...answer.selected],\n\t\t\t...(answer.text !== undefined ? { text: answer.text } : {}),\n\t\t};\n\t}\n\treturn copied;\n}\n\nfunction hasAnswer(answer: QuestionAnswer | undefined): boolean {\n\tif (answer === undefined) return false;\n\tif (answer.selected.length > 0) return true;\n\treturn answer.text !== undefined && answer.text.trim() !== \"\";\n}\n\nfunction unansweredIds(request: QuestionRequest, answers: QuestionAnswers): string[] {\n\tconst unanswered: string[] = [];\n\tfor (const question of request.questions) {\n\t\tif (!hasAnswer(answers[question.id])) unanswered.push(question.id);\n\t}\n\treturn unanswered;\n}\n\nfunction isCommentPresent(comment: string | undefined): comment is string {\n\treturn comment !== undefined && comment.trim() !== \"\";\n}\n\nfunction buildResponse(\n\tstatus: QuestionResponseStatus,\n\trequest: QuestionRequest,\n\tanswers: QuestionAnswers,\n\tcomment: string | undefined,\n\tautoResolvedAfterMs?: number,\n): QuestionResponse {\n\treturn {\n\t\tstatus,\n\t\tanswers: copyAnswers(answers),\n\t\t...(isCommentPresent(comment) ? { comment } : {}),\n\t\tunanswered: unansweredIds(request, answers),\n\t\t...(autoResolvedAfterMs !== undefined ? { autoResolvedAfterMs } : {}),\n\t};\n}\n\nexport function createPendingQuestion(options: PendingQuestionOptions): PendingQuestion {\n\tconst createdAtMs = options.now();\n\tconst hardCapMs = options.hardCapMs ?? DEFAULT_HARD_CAP_MS;\n\tconst hardDeadlineAtMs = createdAtMs + hardCapMs;\n\tconst schedule: NonNullable<PendingQuestionOptions[\"setTimeout\"]> =\n\t\toptions.setTimeout ?? ((handler, delayMs) => setTimeout(handler, delayMs));\n\tconst unsched: NonNullable<PendingQuestionOptions[\"clearTimeout\"]> = options.clearTimeout ?? clearTimeout;\n\n\tlet deadlineAtMs = Math.min(createdAtMs + options.idleTimeoutMs, hardDeadlineAtMs);\n\tlet draftAnswers: QuestionAnswers = {};\n\tlet draftComment: string | undefined;\n\tlet terminal: QuestionResponse | undefined;\n\tlet timer: PendingTimerHandle | undefined;\n\n\tconst disarm = () => {\n\t\tif (timer === undefined) return;\n\t\tunsched(timer);\n\t\ttimer = undefined;\n\t};\n\n\tconst settle = (response: QuestionResponse, notifyTimeout: boolean): QuestionResponse => {\n\t\tif (terminal !== undefined) return terminal;\n\t\tterminal = response;\n\t\tdisarm();\n\t\tif (notifyTimeout) options.onTimeout?.(response);\n\t\treturn response;\n\t};\n\n\tconst fireTimeout = (): QuestionResponse => {\n\t\tconst elapsedMs = Math.max(0, options.now() - createdAtMs);\n\t\treturn settle(buildResponse(\"timed_out\", options.request, draftAnswers, draftComment, elapsedMs), true);\n\t};\n\n\tconst arm = () => {\n\t\tdisarm();\n\t\tif (terminal !== undefined) return;\n\t\tconst delayMs = deadlineAtMs - options.now();\n\t\tif (delayMs <= 0) {\n\t\t\tfireTimeout();\n\t\t\treturn;\n\t\t}\n\t\ttimer = schedule(() => {\n\t\t\ttimer = undefined;\n\t\t\tfireTimeout();\n\t\t}, delayMs);\n\t};\n\n\tarm();\n\n\treturn {\n\t\ttouch(draft) {\n\t\t\tif (terminal !== undefined) return;\n\t\t\tif (draft !== undefined) {\n\t\t\t\tdraftAnswers = copyAnswers(draft.answers);\n\t\t\t\tdraftComment = draft.comment;\n\t\t\t}\n\t\t\tdeadlineAtMs = Math.min(options.now() + options.idleTimeoutMs, hardDeadlineAtMs);\n\t\t\tarm();\n\t\t},\n\t\tsubmit(answers, comment) {\n\t\t\tif (terminal !== undefined) return terminal;\n\t\t\tif (isCommentPresent(comment)) {\n\t\t\t\treturn settle(buildResponse(\"comment-submitted\", options.request, answers, comment), false);\n\t\t\t}\n\t\t\tif (unansweredIds(options.request, answers).length === 0) {\n\t\t\t\treturn settle(buildResponse(\"answered\", options.request, answers, comment), false);\n\t\t\t}\n\t\t\treturn false;\n\t\t},\n\t\tcancel(reason = \"cancelled\") {\n\t\t\tif (terminal !== undefined) return terminal;\n\t\t\treturn settle(buildResponse(reason, options.request, draftAnswers, draftComment), false);\n\t\t},\n\t\ttimeout() {\n\t\t\tif (terminal !== undefined) return terminal;\n\t\t\treturn fireTimeout();\n\t\t},\n\t\tget state() {\n\t\t\treturn terminal?.status ?? \"pending\";\n\t\t},\n\t\tget deadlineAtMs() {\n\t\t\treturn deadlineAtMs;\n\t\t},\n\t\tremainingMs(now) {\n\t\t\treturn Math.max(0, deadlineAtMs - now);\n\t\t},\n\t\tget result() {\n\t\t\treturn terminal;\n\t\t},\n\t};\n}\n"]}

package/dist/core/extensions/builtin/ask-user/registry.d.ts

@@ -0,0 +1,21 @@
+import type { ExtensionUIDialogOptions } from "../../types.ts";
+import type { PendingQuestion } from "./pending.ts";
+import type { QuestionRequest, QuestionResponse } from "./schema.ts";
+/** Additive options consumed by question-capable UI bridges. Delivery belongs to the UI. */
+export interface QuestionDialogOptions extends ExtensionUIDialogOptions {
+    deliver: "tool-result" | "user-message";
+    hardDeadlineAtMs: number;
+    onProgress: (draft: {
+        answers?: QuestionResponse["answers"];
+        comment?: string;
+    }) => void;
+}
+export interface PendingQuestionEntry {
+    request: QuestionRequest;
+    pending: PendingQuestion;
+    completion: Promise<QuestionResponse>;
+    cancel(message?: string): void;
+}
+export declare function getPendingQuestions(sessionId: string): readonly PendingQuestionEntry[];
+export declare function registerPendingQuestion(sessionId: string, entry: PendingQuestionEntry): () => void;
+//# sourceMappingURL=registry.d.ts.map

package/dist/core/extensions/builtin/ask-user/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/ask-user/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAC/D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAErE,4FAA4F;AAC5F,MAAM,WAAW,qBAAsB,SAAQ,wBAAwB;IACtE,OAAO,EAAE,aAAa,GAAG,cAAc,CAAC;IACxC,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,CAAC,KAAK,EAAE;QAAE,OAAO,CAAC,EAAE,gBAAgB,CAAC,SAAS,CAAC,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;CACzF;AACD,MAAM,WAAW,oBAAoB;IACpC,OAAO,EAAE,eAAe,CAAC;IACzB,OAAO,EAAE,eAAe,CAAC;IACzB,UAAU,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACtC,MAAM,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,oBAAoB,EAAE,CAEtF;AACD,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,oBAAoB,GAAG,MAAM,IAAI,CAYlG"}

package/dist/core/extensions/builtin/ask-user/registry.js

@@ -0,0 +1,20 @@
+const sessions = new Map();
+export function getPendingQuestions(sessionId) {
+    return [...(sessions.get(sessionId)?.values() ?? [])];
+}
+export function registerPendingQuestion(sessionId, entry) {
+    let entries = sessions.get(sessionId);
+    if (!entries) {
+        entries = new Map();
+        sessions.set(sessionId, entries);
+    }
+    entries.set(entry.request.requestId, entry);
+    return () => {
+        if (entries.get(entry.request.requestId) !== entry)
+            return;
+        entries.delete(entry.request.requestId);
+        if (entries.size === 0)
+            sessions.delete(sessionId);
+    };
+}
+//# sourceMappingURL=registry.js.map

package/dist/core/extensions/builtin/ask-user/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/ask-user/registry.ts"],"names":[],"mappings":"AAgBA,MAAM,QAAQ,GAAG,IAAI,GAAG,EAA6C,CAAC;AACtE,MAAM,UAAU,mBAAmB,CAAC,SAAiB;IACpD,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AACvD,CAAC;AACD,MAAM,UAAU,uBAAuB,CAAC,SAAiB,EAAE,KAA2B;IACrF,IAAI,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACtC,IAAI,CAAC,OAAO,EAAE,CAAC;QACd,OAAO,GAAG,IAAI,GAAG,EAAE,CAAC;QACpB,QAAQ,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAClC,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IAC5C,OAAO,GAAG,EAAE;QACX,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,KAAK,KAAK;YAAE,OAAO;QAC3D,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QACxC,IAAI,OAAO,CAAC,IAAI,KAAK,CAAC;YAAE,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACpD,CAAC,CAAC;AACH,CAAC","sourcesContent":["import type { ExtensionUIDialogOptions } from \"../../types.ts\";\nimport type { PendingQuestion } from \"./pending.ts\";\nimport type { QuestionRequest, QuestionResponse } from \"./schema.ts\";\n\n/** Additive options consumed by question-capable UI bridges. Delivery belongs to the UI. */\nexport interface QuestionDialogOptions extends ExtensionUIDialogOptions {\n\tdeliver: \"tool-result\" | \"user-message\";\n\thardDeadlineAtMs: number;\n\tonProgress: (draft: { answers?: QuestionResponse[\"answers\"]; comment?: string }) => void;\n}\nexport interface PendingQuestionEntry {\n\trequest: QuestionRequest;\n\tpending: PendingQuestion;\n\tcompletion: Promise<QuestionResponse>;\n\tcancel(message?: string): void;\n}\nconst sessions = new Map<string, Map<string, PendingQuestionEntry>>();\nexport function getPendingQuestions(sessionId: string): readonly PendingQuestionEntry[] {\n\treturn [...(sessions.get(sessionId)?.values() ?? [])];\n}\nexport function registerPendingQuestion(sessionId: string, entry: PendingQuestionEntry): () => void {\n\tlet entries = sessions.get(sessionId);\n\tif (!entries) {\n\t\tentries = new Map();\n\t\tsessions.set(sessionId, entries);\n\t}\n\tentries.set(entry.request.requestId, entry);\n\treturn () => {\n\t\tif (entries.get(entry.request.requestId) !== entry) return;\n\t\tentries.delete(entry.request.requestId);\n\t\tif (entries.size === 0) sessions.delete(sessionId);\n\t};\n}\n"]}

package/dist/core/extensions/builtin/ask-user/render.d.ts

@@ -0,0 +1,4 @@
+import type { ToolDefinition } from "../../types.ts";
+export declare const renderCall: NonNullable<ToolDefinition["renderCall"]>;
+export declare const renderResult: NonNullable<ToolDefinition["renderResult"]>;
+//# sourceMappingURL=render.d.ts.map

package/dist/core/extensions/builtin/ask-user/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/ask-user/render.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErD,eAAO,MAAM,UAAU,EAAE,WAAW,CAAC,cAAc,CAAC,YAAY,CAAC,CAchE,CAAC;AACF,eAAO,MAAM,YAAY,EAAE,WAAW,CAAC,cAAc,CAAC,cAAc,CAAC,CAepE,CAAC"}

package/dist/core/extensions/builtin/ask-user/render.js

@@ -0,0 +1,25 @@
+import { Text } from "@earendil-works/pi-tui";
+export const renderCall = (args, theme) => {
+    const values = typeof args === "object" && args !== null ? args : {};
+    const headers = "questions" in values && Array.isArray(values.questions)
+        ? values.questions
+            .map((q) => typeof q === "object" && q !== null && "header" in q ? `[${q.header}]` : "[Question]")
+            .join(" ")
+        : "Question";
+    const wait = ("waitForAnswer" in values && values.waitForAnswer === true) ||
+        ("wait_for_answer" in values && values.wait_for_answer === true);
+    return new Text(`${theme.fg("toolTitle", headers)} ${wait ? "wait for answer" : "answer later"}`, 0, 0);
+};
+export const renderResult = (result) => {
+    const details = result.details;
+    let summary = "";
+    if (typeof details === "object" && details !== null && "status" in details) {
+        summary = String(details.status);
+        if ("answers" in details && typeof details.answers === "object" && details.answers !== null)
+            summary += `; ${Object.keys(details.answers).length} answered`;
+        if ("unanswered" in details && Array.isArray(details.unanswered))
+            summary += `; ${details.unanswered.length} unanswered`;
+    }
+    return new Text([summary, ...result.content.flatMap((c) => (c.type === "text" ? [c.text] : []))].filter(Boolean).join("\n"), 0, 0);
+};
+//# sourceMappingURL=render.js.map

package/dist/core/extensions/builtin/ask-user/render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.js","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/ask-user/render.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AAG9C,MAAM,CAAC,MAAM,UAAU,GAA8C,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;IACpF,MAAM,MAAM,GAAG,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IACrE,MAAM,OAAO,GACZ,WAAW,IAAI,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC;QACvD,CAAC,CAAC,MAAM,CAAC,SAAS;aACf,GAAG,CAAC,CAAC,CAAU,EAAE,EAAE,CACnB,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,IAAI,QAAQ,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,YAAY,CACrF;aACA,IAAI,CAAC,GAAG,CAAC;QACZ,CAAC,CAAC,UAAU,CAAC;IACf,MAAM,IAAI,GACT,CAAC,eAAe,IAAI,MAAM,IAAI,MAAM,CAAC,aAAa,KAAK,IAAI,CAAC;QAC5D,CAAC,iBAAiB,IAAI,MAAM,IAAI,MAAM,CAAC,eAAe,KAAK,IAAI,CAAC,CAAC;IAClE,OAAO,IAAI,IAAI,CAAC,GAAG,KAAK,CAAC,EAAE,CAAC,WAAW,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,cAAc,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;AACzG,CAAC,CAAC;AACF,MAAM,CAAC,MAAM,YAAY,GAAgD,CAAC,MAAM,EAAE,EAAE;IACnF,MAAM,OAAO,GAAY,MAAM,CAAC,OAAO,CAAC;IACxC,IAAI,OAAO,GAAG,EAAE,CAAC;IACjB,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,IAAI,QAAQ,IAAI,OAAO,EAAE,CAAC;QAC5E,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACjC,IAAI,SAAS,IAAI,OAAO,IAAI,OAAO,OAAO,CAAC,OAAO,KAAK,QAAQ,IAAI,OAAO,CAAC,OAAO,KAAK,IAAI;YAC1F,OAAO,IAAI,KAAK,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,WAAW,CAAC;QAChE,IAAI,YAAY,IAAI,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC;YAC/D,OAAO,IAAI,KAAK,OAAO,CAAC,UAAU,CAAC,MAAM,aAAa,CAAC;IACzD,CAAC;IACD,OAAO,IAAI,IAAI,CACd,CAAC,OAAO,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAC3G,CAAC,EACD,CAAC,CACD,CAAC;AACH,CAAC,CAAC","sourcesContent":["import { Text } from \"@earendil-works/pi-tui\";\nimport type { ToolDefinition } from \"../../types.ts\";\n\nexport const renderCall: NonNullable<ToolDefinition[\"renderCall\"]> = (args, theme) => {\n\tconst values = typeof args === \"object\" && args !== null ? args : {};\n\tconst headers =\n\t\t\"questions\" in values && Array.isArray(values.questions)\n\t\t\t? values.questions\n\t\t\t\t\t.map((q: unknown) =>\n\t\t\t\t\t\ttypeof q === \"object\" && q !== null && \"header\" in q ? `[${q.header}]` : \"[Question]\",\n\t\t\t\t\t)\n\t\t\t\t\t.join(\" \")\n\t\t\t: \"Question\";\n\tconst wait =\n\t\t(\"waitForAnswer\" in values && values.waitForAnswer === true) ||\n\t\t(\"wait_for_answer\" in values && values.wait_for_answer === true);\n\treturn new Text(`${theme.fg(\"toolTitle\", headers)} ${wait ? \"wait for answer\" : \"answer later\"}`, 0, 0);\n};\nexport const renderResult: NonNullable<ToolDefinition[\"renderResult\"]> = (result) => {\n\tconst details: unknown = result.details;\n\tlet summary = \"\";\n\tif (typeof details === \"object\" && details !== null && \"status\" in details) {\n\t\tsummary = String(details.status);\n\t\tif (\"answers\" in details && typeof details.answers === \"object\" && details.answers !== null)\n\t\t\tsummary += `; ${Object.keys(details.answers).length} answered`;\n\t\tif (\"unanswered\" in details && Array.isArray(details.unanswered))\n\t\t\tsummary += `; ${details.unanswered.length} unanswered`;\n\t}\n\treturn new Text(\n\t\t[summary, ...result.content.flatMap((c) => (c.type === \"text\" ? [c.text] : []))].filter(Boolean).join(\"\\n\"),\n\t\t0,\n\t\t0,\n\t);\n};\n"]}

package/dist/core/extensions/builtin/ask-user/resume.d.ts

@@ -0,0 +1,4 @@
+import type { ExtensionAPI, ExtensionContext, SessionStartEvent } from "../../types.ts";
+export declare const ASK_USER_RESUMED_ENTRY = "ask-user:resumed";
+export declare function resumeDanglingQuestion(pi: Pick<ExtensionAPI, "appendEntry" | "sendUserMessage">, event: Pick<SessionStartEvent, "reason">, ctx: Pick<ExtensionContext, "sessionManager" | "ui" | "getAskUserSettings">): Promise<void>;
+//# sourceMappingURL=resume.d.ts.map

package/dist/core/extensions/builtin/ask-user/resume.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resume.d.ts","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/ask-user/resume.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAWxF,eAAO,MAAM,sBAAsB,qBAAqB,CAAC;AAqEzD,wBAAsB,sBAAsB,CAC3C,EAAE,EAAE,IAAI,CAAC,YAAY,EAAE,aAAa,GAAG,iBAAiB,CAAC,EACzD,KAAK,EAAE,IAAI,CAAC,iBAAiB,EAAE,QAAQ,CAAC,EACxC,GAAG,EAAE,IAAI,CAAC,gBAAgB,EAAE,gBAAgB,GAAG,IAAI,GAAG,oBAAoB,CAAC,GACzE,OAAO,CAAC,IAAI,CAAC,CAkBf"}

package/dist/core/extensions/builtin/ask-user/resume.js

@@ -0,0 +1,85 @@
+import { TOOL_NAMES } from "./family.js";
+import { formatUserMessage } from "./format.js";
+import { DEFAULT_ASK_USER_TIMEOUT_MS, toCanonical, } from "./schema.js";
+export const ASK_USER_RESUMED_ENTRY = "ask-user:resumed";
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function variantFor(name) {
+    if (name === TOOL_NAMES.claude)
+        return "claude";
+    if (name === TOOL_NAMES.codex)
+        return "codex";
+    return undefined;
+}
+function findDanglingQuestion(entries) {
+    const results = new Set();
+    const resumed = new Set();
+    for (const entry of entries) {
+        if (entry.type === "custom" && entry.customType === ASK_USER_RESUMED_ENTRY && isRecord(entry.data)) {
+            const toolCallId = entry.data.toolCallId;
+            if (typeof toolCallId === "string")
+                resumed.add(toolCallId);
+        }
+        if (entry.type === "message" && entry.message.role === "toolResult") {
+            results.add(entry.message.toolCallId);
+        }
+    }
+    for (let index = entries.length - 1; index >= 0; index--) {
+        const entry = entries[index];
+        if (entry?.type !== "message" || entry.message.role !== "assistant")
+            continue;
+        const content = entry.message.content;
+        for (let blockIndex = content.length - 1; blockIndex >= 0; blockIndex--) {
+            const block = content[blockIndex];
+            if (block?.type !== "toolCall" || block.incomplete === true)
+                continue;
+            const variant = variantFor(block.name);
+            if (!variant || results.has(block.id) || resumed.has(block.id))
+                continue;
+            return { toolCallId: block.id, variant, args: block.arguments };
+        }
+    }
+    return undefined;
+}
+function requestFromCall(dangling, timeoutMs) {
+    try {
+        return toCanonical(dangling.variant, dangling.args, { requestId: dangling.toolCallId, timeoutMs });
+    }
+    catch {
+        return { requestId: dangling.toolCallId, questions: [], waitForAnswer: false, timeoutMs };
+    }
+}
+function orphaned(request) {
+    return {
+        status: "orphaned-after-restart",
+        answers: {},
+        unanswered: request.questions.map((question) => question.id),
+    };
+}
+function deliver(pi, request, response) {
+    pi.sendUserMessage(formatUserMessage(response, request.requestId, request.questions));
+}
+export async function resumeDanglingQuestion(pi, event, ctx) {
+    if (event.reason !== "resume" && event.reason !== "reload")
+        return;
+    const dangling = findDanglingQuestion(ctx.sessionManager.getBranch());
+    if (!dangling)
+        return;
+    pi.appendEntry(ASK_USER_RESUMED_ENTRY, { toolCallId: dangling.toolCallId });
+    const timeoutMs = (ctx.getAskUserSettings?.().timeoutMinutes ?? DEFAULT_ASK_USER_TIMEOUT_MS / 60_000) * 60_000;
+    const request = requestFromCall(dangling, timeoutMs);
+    const question = ctx.ui.question;
+    if (!question) {
+        deliver(pi, request, orphaned(request));
+        return;
+    }
+    try {
+        const response = await question.call(ctx.ui, request, { timeout: request.timeoutMs });
+        deliver(pi, request, response);
+    }
+    catch {
+        deliver(pi, request, orphaned(request));
+    }
+}
+//# sourceMappingURL=resume.js.map

package/dist/core/extensions/builtin/ask-user/resume.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resume.js","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/ask-user/resume.ts"],"names":[],"mappings":"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","sourcesContent":["import type { SessionEntry } from \"../../../session-manager.ts\";\nimport type { ExtensionAPI, ExtensionContext, SessionStartEvent } from \"../../types.ts\";\nimport { TOOL_NAMES } from \"./family.ts\";\nimport { formatUserMessage } from \"./format.ts\";\nimport {\n\ttype AskUserVariant,\n\tDEFAULT_ASK_USER_TIMEOUT_MS,\n\ttype QuestionRequest,\n\ttype QuestionResponse,\n\ttoCanonical,\n} from \"./schema.ts\";\n\nexport const ASK_USER_RESUMED_ENTRY = \"ask-user:resumed\";\n\ntype DanglingQuestion = {\n\ttoolCallId: string;\n\tvariant: AskUserVariant;\n\targs: unknown;\n};\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n\treturn typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nfunction variantFor(name: string): AskUserVariant | undefined {\n\tif (name === TOOL_NAMES.claude) return \"claude\";\n\tif (name === TOOL_NAMES.codex) return \"codex\";\n\treturn undefined;\n}\n\nfunction findDanglingQuestion(entries: readonly SessionEntry[]): DanglingQuestion | undefined {\n\tconst results = new Set<string>();\n\tconst resumed = new Set<string>();\n\tfor (const entry of entries) {\n\t\tif (entry.type === \"custom\" && entry.customType === ASK_USER_RESUMED_ENTRY && isRecord(entry.data)) {\n\t\t\tconst toolCallId = entry.data.toolCallId;\n\t\t\tif (typeof toolCallId === \"string\") resumed.add(toolCallId);\n\t\t}\n\t\tif (entry.type === \"message\" && entry.message.role === \"toolResult\") {\n\t\t\tresults.add(entry.message.toolCallId);\n\t\t}\n\t}\n\tfor (let index = entries.length - 1; index >= 0; index--) {\n\t\tconst entry = entries[index];\n\t\tif (entry?.type !== \"message\" || entry.message.role !== \"assistant\") continue;\n\t\tconst content = entry.message.content;\n\t\tfor (let blockIndex = content.length - 1; blockIndex >= 0; blockIndex--) {\n\t\t\tconst block = content[blockIndex];\n\t\t\tif (block?.type !== \"toolCall\" || block.incomplete === true) continue;\n\t\t\tconst variant = variantFor(block.name);\n\t\t\tif (!variant || results.has(block.id) || resumed.has(block.id)) continue;\n\t\t\treturn { toolCallId: block.id, variant, args: block.arguments };\n\t\t}\n\t}\n\treturn undefined;\n}\n\nfunction requestFromCall(dangling: DanglingQuestion, timeoutMs: number): QuestionRequest {\n\ttry {\n\t\treturn toCanonical(dangling.variant, dangling.args, { requestId: dangling.toolCallId, timeoutMs });\n\t} catch {\n\t\treturn { requestId: dangling.toolCallId, questions: [], waitForAnswer: false, timeoutMs };\n\t}\n}\n\nfunction orphaned(request: QuestionRequest): QuestionResponse {\n\treturn {\n\t\tstatus: \"orphaned-after-restart\",\n\t\tanswers: {},\n\t\tunanswered: request.questions.map((question) => question.id),\n\t};\n}\n\nfunction deliver(\n\tpi: Pick<ExtensionAPI, \"sendUserMessage\">,\n\trequest: QuestionRequest,\n\tresponse: QuestionResponse,\n): void {\n\tpi.sendUserMessage(formatUserMessage(response, request.requestId, request.questions));\n}\n\nexport async function resumeDanglingQuestion(\n\tpi: Pick<ExtensionAPI, \"appendEntry\" | \"sendUserMessage\">,\n\tevent: Pick<SessionStartEvent, \"reason\">,\n\tctx: Pick<ExtensionContext, \"sessionManager\" | \"ui\" | \"getAskUserSettings\">,\n): Promise<void> {\n\tif (event.reason !== \"resume\" && event.reason !== \"reload\") return;\n\tconst dangling = findDanglingQuestion(ctx.sessionManager.getBranch());\n\tif (!dangling) return;\n\tpi.appendEntry(ASK_USER_RESUMED_ENTRY, { toolCallId: dangling.toolCallId });\n\tconst timeoutMs = (ctx.getAskUserSettings?.().timeoutMinutes ?? DEFAULT_ASK_USER_TIMEOUT_MS / 60_000) * 60_000;\n\tconst request = requestFromCall(dangling, timeoutMs);\n\tconst question = ctx.ui.question;\n\tif (!question) {\n\t\tdeliver(pi, request, orphaned(request));\n\t\treturn;\n\t}\n\ttry {\n\t\tconst response = await question.call(ctx.ui, request, { timeout: request.timeoutMs });\n\t\tdeliver(pi, request, response);\n\t} catch {\n\t\tdeliver(pi, request, orphaned(request));\n\t}\n}\n"]}

package/dist/core/extensions/builtin/ask-user/schema.d.ts

@@ -0,0 +1,40 @@
+export { CLAUDE_PARAMS, CODEX_PARAMS } from "./params.ts";
+export interface QuestionRequest {
+    requestId: string;
+    questions: Array<{
+        id: string;
+        header: string;
+        question: string;
+        options: Array<{
+            label: string;
+            description?: string;
+        }>;
+        multiSelect: boolean;
+    }>;
+    waitForAnswer: boolean;
+    timeoutMs: number;
+}
+export interface QuestionResponse {
+    status: "answered" | "comment-submitted" | "timed_out" | "cancelled" | "orphaned-after-restart" | "unavailable";
+    answers: Record<string, {
+        selected: string[];
+        text?: string;
+    }>;
+    comment?: string;
+    unanswered: string[];
+    autoResolvedAfterMs?: number;
+}
+export type AskUserVariant = "codex" | "claude";
+export type Question = QuestionRequest["questions"][number];
+export type QuestionOption = Question["options"][number];
+export declare const WAIT_FLAG_STEER_TEXT = "This call omitted wait_for_answer (or waitForAnswer). Set true to pause here until the user answers, false to keep working and receive the answer later as a user message.";
+export declare const DEFAULT_ASK_USER_TIMEOUT_MS: number;
+export declare class AskUserSchemaError extends Error {
+    constructor(message: string);
+}
+export type ToCanonicalOptions = {
+    requestId?: string;
+    timeoutMs?: number;
+};
+export declare function toCanonical(variant: AskUserVariant, args: unknown, options?: ToCanonicalOptions): QuestionRequest;
+//# sourceMappingURL=schema.d.ts.map

package/dist/core/extensions/builtin/ask-user/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/ask-user/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG1D,MAAM,WAAW,eAAe;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,KAAK,CAAC;QAChB,EAAE,EAAE,MAAM,CAAC;QACX,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,KAAK,CAAC;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,WAAW,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QACxD,WAAW,EAAE,OAAO,CAAC;KACrB,CAAC,CAAC;IACH,aAAa,EAAE,OAAO,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;CAClB;AAGD,MAAM,WAAW,gBAAgB;IAChC,MAAM,EAAE,UAAU,GAAG,mBAAmB,GAAG,WAAW,GAAG,WAAW,GAAG,wBAAwB,GAAG,aAAa,CAAC;IAChH,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,QAAQ,CAAC;AAChD,MAAM,MAAM,QAAQ,GAAG,eAAe,CAAC,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAC5D,MAAM,MAAM,cAAc,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC;AAEzD,eAAO,MAAM,oBAAoB,+KAC4I,CAAC;AAE9K,eAAO,MAAM,2BAA2B,QAAiB,CAAC;AAS1D,qBAAa,kBAAmB,SAAQ,KAAK;IAC5C,YAAY,OAAO,EAAE,MAAM,EAG1B;CACD;AAED,MAAM,MAAM,kBAAkB,GAAG;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AA+EF,wBAAgB,WAAW,CAAC,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,eAAe,CAajH"}