@with-logic/elwood 0.1.2 → 0.2.0

package/dist/core/questions/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/core/questions/adapter.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAChE,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACzD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACxD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAE7D,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAEzD,MAAM,WAAW,eAAe;IAC9B,gFAAgF;IAChF,OAAO,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC;IAC7C,MAAM,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI,CAAC;IACnC,WAAW,IAAI,OAAO,CAAC;IACvB,gGAAgG;IAChG,MAAM,CACJ,OAAO,EAAE,qBAAqB,EAC9B,6BAA6B,EAAE,SAAS,uBAAuB,EAAE,EACjE,EAAE,EAAE,UAAU,GACb,OAAO,CAAC,IAAI,CAAC,CAAC;CAClB"}

package/dist/core/questions/adapter.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=adapter.js.map

package/dist/core/questions/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../../src/core/questions/adapter.ts"],"names":[],"mappings":""}

package/dist/core/questions/attempt.d.ts

@@ -0,0 +1,26 @@
+import type { QuestionAdapter } from "./adapter.ts";
+import { type QuestionFailureCategory } from "./errors.ts";
+import type { QuestionIo } from "./io.ts";
+import type { QuestionRegistry } from "./registry.ts";
+import type { ElwoodQuestionRequest } from "./types.ts";
+import type { ValidatedQuestionAnswer } from "./validate.ts";
+export declare class QuestionAttempt {
+    writeAttempted: boolean;
+    failureCategory: QuestionFailureCategory;
+    private nativeAccepted;
+    private adapterFinished;
+    private wake;
+    private readonly stopDeadline;
+    private readonly off;
+    private readonly request;
+    private readonly operation;
+    private readonly signal;
+    private readonly registry;
+    constructor(request: ElwoodQuestionRequest, operation: AbortController, signal: AbortSignal, registry: QuestionRegistry, timeoutMs: number);
+    assertLive(): void;
+    execute(adapter: QuestionAdapter, answers: readonly ValidatedQuestionAnswer[], io: QuestionIo): Promise<void>;
+    failure(): Error;
+    dispose(): void;
+    private waitForNativeAcceptance;
+}
+//# sourceMappingURL=attempt.d.ts.map

package/dist/core/questions/attempt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attempt.d.ts","sourceRoot":"","sources":["../../../src/core/questions/attempt.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEpD,OAAO,EAAE,KAAK,uBAAuB,EAAwB,MAAM,aAAa,CAAC;AACjF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACxD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAE7D,qBAAa,eAAe;IAC1B,cAAc,UAAS;IACvB,eAAe,EAAE,uBAAuB,CAAgB;IACxD,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,IAAI,CAA2B;IACvC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAa;IAC1C,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAa;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwB;IAChD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAkB;IAC5C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;IACrC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmB;gBAE1C,OAAO,EAAE,qBAAqB,EAC9B,SAAS,EAAE,eAAe,EAC1B,MAAM,EAAE,WAAW,EACnB,QAAQ,EAAE,gBAAgB,EAC1B,SAAS,EAAE,MAAM;IAgBnB,UAAU,IAAI,IAAI;IAKZ,OAAO,CACX,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE,SAAS,uBAAuB,EAAE,EAC3C,EAAE,EAAE,UAAU,GACb,OAAO,CAAC,IAAI,CAAC;IAUhB,OAAO,IAAI,KAAK;IAYhB,OAAO,IAAI,IAAI;YAMD,uBAAuB;CAWtC"}

package/dist/core/questions/attempt.js

@@ -0,0 +1,85 @@
+/** Track one answer's execution, native acknowledgement, and failure cleanup (PRD §4). */
+import { untilQuestionAbort } from "./abort.js";
+import { questionDeadline } from "./deadline.js";
+import { questionAnswerFailed } from "./errors.js";
+export class QuestionAttempt {
+    writeAttempted = false;
+    failureCategory = "frame_wait";
+    nativeAccepted = false;
+    adapterFinished = false;
+    wake;
+    stopDeadline;
+    off;
+    request;
+    operation;
+    signal;
+    registry;
+    constructor(request, operation, signal, registry, timeoutMs) {
+        this.request = request;
+        this.operation = operation;
+        this.signal = signal;
+        this.registry = registry;
+        this.stopDeadline = questionDeadline(timeoutMs, () => operation.abort(questionAnswerFailed()));
+        this.off = registry.onEvent((event) => {
+            if (event.phase !== "closed" || event.request.id !== request.id)
+                return;
+            if (event.reason === "answered") {
+                this.nativeAccepted = true;
+                if (this.adapterFinished)
+                    this.stopDeadline();
+                this.wake?.();
+            }
+            else
+                operation.abort(questionAnswerFailed());
+        });
+    }
+    assertLive() {
+        const requestAvailable = this.registry.get(this.request.id) !== undefined;
+        const requestAvailableOrAccepted = this.nativeAccepted || requestAvailable;
+        if (this.signal.aborted || !requestAvailableOrAccepted)
+            throw questionAnswerFailed();
+    }
+    async execute(adapter, answers, io) {
+        this.assertLive();
+        await io.wait(() => true);
+        this.failureCategory = "adapter";
+        await untilQuestionAbort(adapter.answer(this.request, answers, io), this.signal);
+        this.adapterFinished = true;
+        this.failureCategory = "native_acceptance";
+        await this.waitForNativeAcceptance();
+        this.assertLive();
+    }
+    failure() {
+        // Retirement emits a closed edge that aborts this operation; retain its original category.
+        const category = this.signal.aborted ? "aborted" : this.failureCategory;
+        if (this.writeAttempted && !this.nativeAccepted) {
+            try {
+                this.registry.retireUnconfirmed(this.request.id);
+            }
+            catch {
+                // Observer failures cannot restore native authority or expose answer-bearing causes.
+            }
+        }
+        return questionAnswerFailed(category);
+    }
+    dispose() {
+        if (this.wake)
+            this.signal.removeEventListener("abort", this.wake);
+        this.operation.abort();
+        this.stopDeadline();
+        this.off();
+    }
+    async waitForNativeAcceptance() {
+        if (this.nativeAccepted) {
+            this.stopDeadline();
+            return;
+        }
+        await new Promise((resolve) => {
+            this.wake = () => resolve();
+            this.signal.addEventListener("abort", this.wake, { once: true });
+            if (this.signal.aborted)
+                resolve();
+        });
+    }
+}
+//# sourceMappingURL=attempt.js.map

package/dist/core/questions/attempt.js.map

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

package/dist/core/questions/controller.d.ts

@@ -0,0 +1,24 @@
+import type { ElwoodTerminal } from "../../terminal/headless.ts";
+import type { ElwoodActivityEvent, ElwoodAgentKind } from "../activity/index.ts";
+import type { Unsubscribe } from "../types.ts";
+import type { QuestionAdapter } from "./adapter.ts";
+import { type QuestionObservationEmitter } from "./observers.ts";
+import { QuestionRegistry } from "./registry.ts";
+import type { ElwoodQuestionAnswer, ElwoodQuestionAnswerOptions } from "./types.ts";
+type Events = QuestionObservationEmitter & {
+    on(event: "activity", handler: (event: ElwoodActivityEvent) => void): Unsubscribe;
+};
+export declare class SessionQuestions {
+    readonly registry: QuestionRegistry;
+    private adapter;
+    private readonly transaction;
+    private readonly closing;
+    constructor(agent: ElwoodAgentKind, elwoodSessionId: string, events: Events, terminal: ElwoodTerminal, inputSignal: () => AbortSignal, closing: AbortSignal);
+    configure(factory: (registry: QuestionRegistry) => QuestionAdapter): void;
+    blocksInput(): boolean;
+    revoke(): void;
+    list(): readonly import("./types.ts").ElwoodQuestionRequest[];
+    answer(requestId: string, answers: readonly ElwoodQuestionAnswer[], options?: ElwoodQuestionAnswerOptions): Promise<void>;
+}
+export {};
+//# sourceMappingURL=controller.d.ts.map

package/dist/core/questions/controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"controller.d.ts","sourceRoot":"","sources":["../../../src/core/questions/controller.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,KAAK,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACjF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAGpD,OAAO,EAAgC,KAAK,0BAA0B,EAAE,MAAM,gBAAgB,CAAC;AAC/F,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEjD,OAAO,KAAK,EAAE,oBAAoB,EAAE,2BAA2B,EAAE,MAAM,YAAY,CAAC;AAEpF,KAAK,MAAM,GAAG,0BAA0B,GAAG;IACzC,EAAE,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,mBAAmB,KAAK,IAAI,GAAG,WAAW,CAAC;CACnF,CAAC;AACF,qBAAa,gBAAgB;IAC3B,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IACpC,OAAO,CAAC,OAAO,CAA8B;IAC7C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAsB;IAClD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAc;gBAEpC,KAAK,EAAE,eAAe,EACtB,eAAe,EAAE,MAAM,EACvB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,cAAc,EACxB,WAAW,EAAE,MAAM,WAAW,EAC9B,OAAO,EAAE,WAAW;IAgDtB,SAAS,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,gBAAgB,KAAK,eAAe,GAAG,IAAI;IAGzE,WAAW,IAAI,OAAO;IAKtB,MAAM,IAAI,IAAI;IAGd,IAAI;IAGJ,MAAM,CACJ,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,SAAS,oBAAoB,EAAE,EACxC,OAAO,CAAC,EAAE,2BAA2B;CAIxC"}

package/dist/core/questions/controller.js

@@ -0,0 +1,83 @@
+/** Bind public question discovery, guarded answers and shutdown (PRD §5.10). */
+import { subscribeRender } from "../../terminal/cursor.js";
+import { readQuestionFrame } from "./input.js";
+import { QuestionObserverFailure } from "./notification-errors.js";
+import { observeQuestionNotifications } from "./observers.js";
+import { QuestionRegistry } from "./registry.js";
+import { QuestionTransaction } from "./transaction.js";
+export class SessionQuestions {
+    registry;
+    adapter;
+    transaction;
+    closing;
+    constructor(agent, elwoodSessionId, events, terminal, inputSignal, closing) {
+        this.closing = closing;
+        const notifications = observeQuestionNotifications(events, elwoodSessionId, agent);
+        this.registry = new QuestionRegistry(agent, elwoodSessionId, notifications);
+        this.transaction = new QuestionTransaction(this.registry, terminal, inputSignal, closing);
+        const refresh = () => {
+            if (closing.aborted)
+                return;
+            const frame = readQuestionFrame(terminal);
+            if (frame) {
+                try {
+                    this.adapter?.render(frame);
+                }
+                catch (error) {
+                    if (error instanceof QuestionObserverFailure)
+                        notifications.reportFailure();
+                    /* Observers cannot turn a completed native render into render failure. */
+                }
+            }
+        };
+        const offActivity = events.on("activity", (event) => {
+            // Feeding our own notifications or failure diagnostic back into discovery can recurse.
+            if (closing.aborted ||
+                event.kind === "question" ||
+                (event.kind === "warning" && event.label === "question_observer_failed"))
+                return;
+            try {
+                if (!this.adapter?.observe(event))
+                    return;
+            }
+            catch (error) {
+                if (error instanceof QuestionObserverFailure)
+                    notifications.reportFailure();
+                /* Native state may already have changed before a public observer failed. */
+            }
+            refresh();
+        });
+        const offRender = subscribeRender(terminal, refresh);
+        const shutdown = () => {
+            this.transaction.revoke();
+            offRender();
+            offActivity();
+            try {
+                this.registry.shutdown();
+            }
+            catch {
+                /* Shutdown owns cleanup even when a question observer throws. */
+            }
+        };
+        closing.addEventListener("abort", shutdown, { once: true });
+        if (closing.aborted)
+            shutdown();
+    }
+    configure(factory) {
+        if (!this.closing.aborted)
+            this.adapter = factory(this.registry);
+    }
+    blocksInput() {
+        return (this.transaction.busy() || this.registry.hasPending() || this.adapter?.blocksInput() === true);
+    }
+    revoke() {
+        this.transaction.revoke();
+    }
+    list() {
+        return this.registry.list();
+    }
+    answer(requestId, answers, options) {
+        return this.transaction.run(this.adapter, requestId, answers, options);
+    }
+}
+//# sourceMappingURL=controller.js.map

package/dist/core/questions/controller.js.map

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

package/dist/core/questions/correlation.d.ts

@@ -0,0 +1,8 @@
+/** Preserve agent and lifecycle discriminants in native question envelopes (PRD §5.10). */
+import type { ElwoodAgentKind } from "../activity/index.ts";
+import type { ElwoodQuestionEvent, ElwoodQuestionRequest } from "./types.ts";
+type Lifecycle<Event = ElwoodQuestionEvent> = Event extends ElwoodQuestionEvent ? Omit<Event, "agent" | "request"> : never;
+export declare function requestWithAgent(agent: ElwoodAgentKind, fields: Omit<ElwoodQuestionRequest, "agent">): ElwoodQuestionRequest;
+export declare function eventWithAgent(request: ElwoodQuestionRequest, fields: Lifecycle): ElwoodQuestionEvent;
+export {};
+//# sourceMappingURL=correlation.d.ts.map

package/dist/core/questions/correlation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"correlation.d.ts","sourceRoot":"","sources":["../../../src/core/questions/correlation.ts"],"names":[],"mappings":"AAAA,2FAA2F;AAC3F,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,KAAK,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAE7E,KAAK,SAAS,CAAC,KAAK,GAAG,mBAAmB,IAAI,KAAK,SAAS,mBAAmB,GAC3E,IAAI,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,CAAC,GAChC,KAAK,CAAC;AACV,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,eAAe,EACtB,MAAM,EAAE,IAAI,CAAC,qBAAqB,EAAE,OAAO,CAAC,GAC3C,qBAAqB,CAIvB;AACD,wBAAgB,cAAc,CAC5B,OAAO,EAAE,qBAAqB,EAC9B,MAAM,EAAE,SAAS,GAChB,mBAAmB,CAIrB"}

package/dist/core/questions/correlation.js

@@ -0,0 +1,11 @@
+export function requestWithAgent(agent, fields) {
+    return agent === "claude"
+        ? Object.freeze({ ...fields, agent })
+        : Object.freeze({ ...fields, agent });
+}
+export function eventWithAgent(request, fields) {
+    return request.agent === "claude"
+        ? { ...fields, agent: request.agent, request }
+        : { ...fields, agent: request.agent, request };
+}
+//# sourceMappingURL=correlation.js.map

package/dist/core/questions/correlation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"correlation.js","sourceRoot":"","sources":["../../../src/core/questions/correlation.ts"],"names":[],"mappings":"AAOA,MAAM,UAAU,gBAAgB,CAC9B,KAAsB,EACtB,MAA4C;IAE5C,OAAO,KAAK,KAAK,QAAQ;QACvB,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,MAAM,EAAE,KAAK,EAAE,CAAC;QACrC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;AAC1C,CAAC;AACD,MAAM,UAAU,cAAc,CAC5B,OAA8B,EAC9B,MAAiB;IAEjB,OAAO,OAAO,CAAC,KAAK,KAAK,QAAQ;QAC/B,CAAC,CAAC,EAAE,GAAG,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,OAAO,EAAE;QAC9C,CAAC,CAAC,EAAE,GAAG,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,OAAO,EAAE,CAAC;AACnD,CAAC"}

package/dist/core/questions/cursor-provenance.d.ts

@@ -0,0 +1,12 @@
+/** Capture private editor cursor evidence from the same completed frame (PRD §4). */
+import type { ElwoodTerminal, TerminalSnapshot } from "../../terminal/headless.ts";
+import type { QuestionFrame } from "./adapter.ts";
+/**
+ * Call with this terminal's completed snapshot, before any intervening render.
+ * The prefix covers only the physical cursor row before cursorX, not a complete
+ * logical answer: clipped or multirow text cannot be reconstructed from it.
+ * Cursor-cell dimming is omitted when no cell is addressable (including deferred
+ * wrap); an unavailable row leaves both provenance fields absent.
+ */
+export declare function questionCursorProvenance(terminal: ElwoodTerminal, frame: TerminalSnapshot): Pick<QuestionFrame, "cursorCellDimmed" | "cursorLineBefore">;
+//# sourceMappingURL=cursor-provenance.d.ts.map

package/dist/core/questions/cursor-provenance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor-provenance.d.ts","sourceRoot":"","sources":["../../../src/core/questions/cursor-provenance.ts"],"names":[],"mappings":"AAAA,qFAAqF;AACrF,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AACnF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElD;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,cAAc,EACxB,KAAK,EAAE,gBAAgB,GACtB,IAAI,CAAC,aAAa,EAAE,kBAAkB,GAAG,kBAAkB,CAAC,CAS9D"}

package/dist/core/questions/cursor-provenance.js

@@ -0,0 +1,19 @@
+/**
+ * Call with this terminal's completed snapshot, before any intervening render.
+ * The prefix covers only the physical cursor row before cursorX, not a complete
+ * logical answer: clipped or multirow text cannot be reconstructed from it.
+ * Cursor-cell dimming is omitted when no cell is addressable (including deferred
+ * wrap); an unavailable row leaves both provenance fields absent.
+ */
+export function questionCursorProvenance(terminal, frame) {
+    const buffer = terminal.xterm.buffer.active;
+    const row = buffer.getLine(buffer.baseY + frame.cursorY);
+    if (row === undefined)
+        return {};
+    const cell = row.getCell(frame.cursorX);
+    return {
+        cursorLineBefore: row.translateToString(false, 0, frame.cursorX),
+        ...(cell === undefined ? {} : { cursorCellDimmed: Boolean(cell.isDim()) }),
+    };
+}
+//# sourceMappingURL=cursor-provenance.js.map

package/dist/core/questions/cursor-provenance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor-provenance.js","sourceRoot":"","sources":["../../../src/core/questions/cursor-provenance.ts"],"names":[],"mappings":"AAIA;;;;;;GAMG;AACH,MAAM,UAAU,wBAAwB,CACtC,QAAwB,EACxB,KAAuB;IAEvB,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC;IAC5C,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC;IACzD,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IACjC,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACxC,OAAO;QACL,gBAAgB,EAAE,GAAG,CAAC,iBAAiB,CAAC,KAAK,EAAE,CAAC,EAAE,KAAK,CAAC,OAAO,CAAC;QAChE,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,gBAAgB,EAAE,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC;KAC3E,CAAC;AACJ,CAAC"}

package/dist/core/questions/deadline.d.ts

@@ -0,0 +1,2 @@
+export declare function questionDeadline(timeoutMs: number, expire: () => void): () => void;
+//# sourceMappingURL=deadline.d.ts.map

package/dist/core/questions/deadline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deadline.d.ts","sourceRoot":"","sources":["../../../src/core/questions/deadline.ts"],"names":[],"mappings":"AASA,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAMlF"}

package/dist/core/questions/deadline.js

@@ -0,0 +1,11 @@
+/** Keep positive finite answer deadlines within Node's timer range (PRD §4). */
+import { scheduleDeadline } from "../timers.js";
+const clock = {
+    now: () => performance.now(),
+    setTimer: (handler, delayMs) => setTimeout(handler, delayMs),
+    clearTimer: (timer) => clearTimeout(timer),
+};
+export function questionDeadline(timeoutMs, expire) {
+    return scheduleDeadline({ deadlineAtMs: clock.now() + timeoutMs, initialDelayMs: timeoutMs }, expire, clock);
+}
+//# sourceMappingURL=deadline.js.map

package/dist/core/questions/deadline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deadline.js","sourceRoot":"","sources":["../../../src/core/questions/deadline.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,OAAO,EAAsB,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEpE,MAAM,KAAK,GAAkB;IAC3B,GAAG,EAAE,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE;IAC5B,QAAQ,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC;IAC5D,UAAU,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,YAAY,CAAC,KAAsC,CAAC;CAC5E,CAAC;AAEF,MAAM,UAAU,gBAAgB,CAAC,SAAiB,EAAE,MAAkB;IACpE,OAAO,gBAAgB,CACrB,EAAE,YAAY,EAAE,KAAK,CAAC,GAAG,EAAE,GAAG,SAAS,EAAE,cAAc,EAAE,SAAS,EAAE,EACpE,MAAM,EACN,KAAK,CACN,CAAC;AACJ,CAAC"}

package/dist/core/questions/dispatch.d.ts

@@ -0,0 +1,17 @@
+/** Serialize lifecycle notifications while registry mutations stay synchronous (PRD §5.10). */
+import type { QuestionActivityEvent } from "./activity.ts";
+import type { ElwoodQuestionEvent } from "./types.ts";
+export type QuestionEmitter = {
+    emit(event: "question", payload: ElwoodQuestionEvent): void;
+    emit(event: "activity", payload: QuestionActivityEvent): void;
+};
+export declare class QuestionDispatch {
+    private readonly pending;
+    private readonly listeners;
+    private delivering;
+    private readonly emitter;
+    constructor(emitter: QuestionEmitter);
+    onEvent(listener: (event: ElwoodQuestionEvent) => void): () => void;
+    emit(event: ElwoodQuestionEvent): void;
+}
+//# sourceMappingURL=dispatch.d.ts.map

package/dist/core/questions/dispatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch.d.ts","sourceRoot":"","sources":["../../../src/core/questions/dispatch.ts"],"names":[],"mappings":"AAAA,+FAA+F;AAE/F,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAE3D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEtD,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAC5D,IAAI,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,qBAAqB,GAAG,IAAI,CAAC;CAC/D,CAAC;AAEF,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6B;IACrD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAmD;IAC7E,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkB;gBAC9B,OAAO,EAAE,eAAe;IAIpC,OAAO,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,mBAAmB,KAAK,IAAI,GAAG,MAAM,IAAI;IASnE,IAAI,CAAC,KAAK,EAAE,mBAAmB,GAAG,IAAI;CAgBvC"}

package/dist/core/questions/dispatch.js

@@ -0,0 +1,46 @@
+/** Serialize lifecycle notifications while registry mutations stay synchronous (PRD §5.10). */
+import { questionActivity } from "./activity-fields.js";
+export class QuestionDispatch {
+    pending = [];
+    listeners = new Set();
+    delivering = false;
+    emitter;
+    constructor(emitter) {
+        this.emitter = emitter;
+    }
+    onEvent(listener) {
+        this.listeners.add(listener);
+        return () => {
+            this.listeners.delete(listener);
+        };
+    }
+    // Synchronous observers may mutate the registry while a raised edge is being delivered.
+    // Queue nested edges so every observer and its activity mirror see raised before closed.
+    emit(event) {
+        const errors = [];
+        this.pending.push(Object.freeze(event));
+        if (!this.delivering) {
+            this.delivering = true;
+            while (this.pending.length > 0) {
+                const next = this.pending.shift();
+                for (const listener of this.listeners)
+                    attempt(() => listener(next), errors);
+                attempt(() => this.emitter.emit("question", next), errors);
+                const activity = questionActivity(next);
+                attempt(() => this.emitter.emit("activity", activity), errors);
+            }
+            this.delivering = false;
+        }
+        if (errors.length > 0)
+            throw errors[0];
+    }
+}
+function attempt(action, errors) {
+    try {
+        action();
+    }
+    catch (error) {
+        errors.push(error);
+    }
+}
+//# sourceMappingURL=dispatch.js.map

package/dist/core/questions/dispatch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch.js","sourceRoot":"","sources":["../../../src/core/questions/dispatch.ts"],"names":[],"mappings":"AAAA,+FAA+F;AAG/F,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAQxD,MAAM,OAAO,gBAAgB;IACV,OAAO,GAA0B,EAAE,CAAC;IACpC,SAAS,GAAG,IAAI,GAAG,EAAwC,CAAC;IACrE,UAAU,GAAG,KAAK,CAAC;IACV,OAAO,CAAkB;IAC1C,YAAY,OAAwB;QAClC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,OAAO,CAAC,QAA8C;QACpD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC7B,OAAO,GAAG,EAAE;YACV,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAClC,CAAC,CAAC;IACJ,CAAC;IAED,wFAAwF;IACxF,yFAAyF;IACzF,IAAI,CAAC,KAA0B;QAC7B,MAAM,MAAM,GAAc,EAAE,CAAC;QAC7B,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QACxC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;YACrB,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;YACvB,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC/B,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAG,CAAC;gBACnC,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS;oBAAE,OAAO,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC;gBAC7E,OAAO,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC;gBAC3D,MAAM,QAAQ,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;gBACxC,OAAO,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,CAAC;YACjE,CAAC;YACD,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;QAC1B,CAAC;QACD,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC;YAAE,MAAM,MAAM,CAAC,CAAC,CAAC,CAAC;IACzC,CAAC;CACF;AAED,SAAS,OAAO,CAAC,MAAkB,EAAE,MAAiB;IACpD,IAAI,CAAC;QACH,MAAM,EAAE,CAAC;IACX,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrB,CAAC;AACH,CAAC"}

package/dist/core/questions/errors.d.ts

@@ -0,0 +1,8 @@
+/** Public question failures for provider-independent control code (PRD §10). */
+import { type ElwoodError } from "../errors.ts";
+export type QuestionErrorCode = "question_not_found" | "invalid_question_answer" | "question_answer_failed";
+export declare function questionError(code: QuestionErrorCode, message: string, details?: Readonly<Record<string, unknown>>): ElwoodError;
+export type QuestionFailureCategory = "frame_wait" | "adapter" | "terminal_write" | "native_acceptance" | "aborted";
+/** Fixed diagnostic categories never carry a caller's answer or a raw exception. */
+export declare function questionAnswerFailed(category?: QuestionFailureCategory): ElwoodError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/core/questions/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/core/questions/errors.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,OAAO,EAAE,KAAK,WAAW,EAAe,MAAM,cAAc,CAAC;AAC7D,MAAM,MAAM,iBAAiB,GACzB,oBAAoB,GACpB,yBAAyB,GACzB,wBAAwB,CAAC;AAE7B,wBAAgB,aAAa,CAC3B,IAAI,EAAE,iBAAiB,EACvB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAM,GAC9C,WAAW,CAEb;AAED,MAAM,MAAM,uBAAuB,GAC/B,YAAY,GACZ,SAAS,GACT,gBAAgB,GAChB,mBAAmB,GACnB,SAAS,CAAC;AAEd,oFAAoF;AACpF,wBAAgB,oBAAoB,CAAC,QAAQ,CAAC,EAAE,uBAAuB,eAMtE"}

package/dist/core/questions/errors.js

@@ -0,0 +1,10 @@
+/** Public question failures for provider-independent control code (PRD §10). */
+import { elwoodError } from "../errors.js";
+export function questionError(code, message, details = {}) {
+    return elwoodError(code, message, details);
+}
+/** Fixed diagnostic categories never carry a caller's answer or a raw exception. */
+export function questionAnswerFailed(category) {
+    return questionError("question_answer_failed", "The native question answer could not be confirmed. Refresh pending questions and inspect the terminal before retrying.", category === undefined ? {} : { category });
+}
+//# sourceMappingURL=errors.js.map

package/dist/core/questions/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/core/questions/errors.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,OAAO,EAAoB,WAAW,EAAE,MAAM,cAAc,CAAC;AAM7D,MAAM,UAAU,aAAa,CAC3B,IAAuB,EACvB,OAAe,EACf,UAA6C,EAAE;IAE/C,OAAO,WAAW,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;AAC7C,CAAC;AASD,oFAAoF;AACpF,MAAM,UAAU,oBAAoB,CAAC,QAAkC;IACrE,OAAO,aAAa,CAClB,wBAAwB,EACxB,wHAAwH,EACxH,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAC3C,CAAC;AACJ,CAAC"}

package/dist/core/questions/input.d.ts

@@ -0,0 +1,13 @@
+import type { ElwoodTerminal } from "../../terminal/headless.ts";
+import type { QuestionFrame, QuestionIo } from "./io.ts";
+import type { QuestionRegistry } from "./registry.ts";
+import type { ElwoodQuestionRequest } from "./types.ts";
+type WriteObserver = {
+    readonly started: () => void;
+    readonly settled: () => void;
+    readonly failed: () => void;
+};
+export declare function readQuestionFrame(terminal: ElwoodTerminal): QuestionFrame | undefined;
+export declare function questionInput(terminal: ElwoodTerminal, registry: QuestionRegistry, request: ElwoodQuestionRequest, signal: AbortSignal, assertLive: () => void, observer: WriteObserver): QuestionIo;
+export {};
+//# sourceMappingURL=input.d.ts.map

package/dist/core/questions/input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"input.d.ts","sourceRoot":"","sources":["../../../src/core/questions/input.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAKjE,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACzD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAExD,KAAK,aAAa,GAAG;IACnB,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,IAAI,CAAC;CAC7B,CAAC;AAEF,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,cAAc,GAAG,aAAa,GAAG,SAAS,CAYrF;AAED,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,cAAc,EACxB,QAAQ,EAAE,gBAAgB,EAC1B,OAAO,EAAE,qBAAqB,EAC9B,MAAM,EAAE,WAAW,EACnB,UAAU,EAAE,MAAM,IAAI,EACtB,QAAQ,EAAE,aAAa,GACtB,UAAU,CAkEZ"}

package/dist/core/questions/input.js

@@ -0,0 +1,93 @@
+/** Guard native writes with settled, fresh terminal evidence (PRD §4). */
+import { cursorViewportRow } from "../../terminal/coordinates.js";
+import { captureRenderProgress, currentRenderedFrame, settledCursorVisible, subscribeRender, } from "../../terminal/cursor.js";
+import { RenderWakeup } from "../input/render-wakeup.js";
+import { untilQuestionAbort } from "./abort.js";
+import { questionCursorProvenance } from "./cursor-provenance.js";
+import { questionAnswerFailed } from "./errors.js";
+export function readQuestionFrame(terminal) {
+    const frame = currentRenderedFrame(terminal);
+    const buffer = terminal.xterm.buffer.active;
+    return (frame && {
+        ...frame,
+        // Snapshot rows use the viewport; xterm cursorY is relative to the scrollback base.
+        cursorRow: cursorViewportRow(frame.cursorY, buffer),
+        cursorVisible: settledCursorVisible(terminal.xterm),
+        ...questionCursorProvenance(terminal, frame),
+    });
+}
+export function questionInput(terminal, registry, request, signal, assertLive, observer) {
+    let hasOutputSinceWrite;
+    const assertActive = () => {
+        assertLive();
+        if (signal.aborted)
+            throw questionAnswerFailed();
+    };
+    const assertOwned = () => {
+        assertActive();
+        if (registry.get(request.id) !== request)
+            throw questionAnswerFailed();
+    };
+    const io = {
+        signal,
+        frame: () => readQuestionFrame(terminal),
+        wait: async (test) => {
+            const wakeup = new RenderWakeup((listener) => {
+                const offRender = subscribeRender(terminal, listener);
+                const resize = terminal.xterm.onResize(listener);
+                return () => {
+                    offRender();
+                    resize.dispose();
+                };
+            });
+            try {
+                for (;;) {
+                    wakeup.consume();
+                    assertActive();
+                    const frame = readQuestionFrame(terminal);
+                    const postWriteProgressSatisfied = !hasOutputSinceWrite || hasOutputSinceWrite();
+                    if (frame && postWriteProgressSatisfied && test(frame))
+                        return frame;
+                    assertActive();
+                    await wakeup.wait(signal);
+                }
+            }
+            finally {
+                wakeup.dispose();
+            }
+        },
+        write: async (input, matchesBeforeWrite, onDispatch) => {
+            assertOwned();
+            let frame = readQuestionFrame(terminal);
+            if (!frame) {
+                await io.wait(() => true);
+                assertOwned();
+                frame = readQuestionFrame(terminal);
+            }
+            if (!(frame && matchesBeforeWrite(frame)))
+                throw questionAnswerFailed();
+            assertOwned();
+            hasOutputSinceWrite = captureRenderProgress(terminal);
+            observer.started();
+            try {
+                const send = async () => {
+                    try {
+                        onDispatch?.();
+                        await terminal.sendInput(input);
+                    }
+                    finally {
+                        observer.settled();
+                    }
+                };
+                await untilQuestionAbort(send(), signal);
+            }
+            catch {
+                observer.failed();
+                throw questionAnswerFailed();
+            }
+            assertActive();
+        },
+    };
+    return io;
+}
+//# sourceMappingURL=input.js.map

package/dist/core/questions/input.js.map

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

package/dist/core/questions/io.d.ts

@@ -0,0 +1,23 @@
+/** Private native-frame and guarded-I/O contract (PRD §4.1). */
+import type { TerminalSnapshot } from "../../terminal/headless.ts";
+export type QuestionFrame = TerminalSnapshot & {
+    /** Zero-based row in snapshot lines; cursorY=3, baseY=10, viewportY=8 gives row5. */
+    readonly cursorRow: number;
+    /** Live completed frames supply visibility; partial/older captures may omit it.
+     * Unknown visibility never proves that a composer is clear. */
+    readonly cursorVisible?: boolean;
+    /** Native cursor-cell style and prefix, captured with the completed snapshot. */
+    readonly cursorCellDimmed?: boolean;
+    readonly cursorLineBefore?: string;
+};
+export type QuestionIo = {
+    readonly signal: AbortSignal;
+    frame(): QuestionFrame | undefined;
+    /** Recheck the predicate after completed renders or resize; abort rejects.
+     * After a write, require completed output progress before accepting a frame. */
+    wait(test: (frame: QuestionFrame) => boolean): Promise<QuestionFrame>;
+    /** Await only the send; callers must wait between state-changing writes.
+     * onDispatch runs after live/frame guards, immediately before physical send. */
+    write(input: string, matchesBeforeWrite: (frame: QuestionFrame) => boolean, onDispatch?: () => void): Promise<void>;
+};
+//# sourceMappingURL=io.d.ts.map

package/dist/core/questions/io.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"io.d.ts","sourceRoot":"","sources":["../../../src/core/questions/io.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAEnE,MAAM,MAAM,aAAa,GAAG,gBAAgB,GAAG;IAC7C,qFAAqF;IACrF,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B;mEAC+D;IAC/D,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;IACjC,iFAAiF;IACjF,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IACpC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CACpC,CAAC;AACF,MAAM,MAAM,UAAU,GAAG;IACvB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,KAAK,IAAI,aAAa,GAAG,SAAS,CAAC;IACnC;oFACgF;IAChF,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,OAAO,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IACtE;oFACgF;IAChF,KAAK,CACH,KAAK,EAAE,MAAM,EACb,kBAAkB,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,OAAO,EACrD,UAAU,CAAC,EAAE,MAAM,IAAI,GACtB,OAAO,CAAC,IAAI,CAAC,CAAC;CAClB,CAAC"}

package/dist/core/questions/io.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=io.js.map

package/dist/core/questions/io.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"io.js","sourceRoot":"","sources":["../../../src/core/questions/io.ts"],"names":[],"mappings":""}