@scotthuang/agent-knock-knock 0.12.11 → 0.12.13

package/dist/src/terminal-status-facts.js

@@ -0,0 +1,199 @@
+import { isExecutorKind } from "./executors.js";
+import { executorForConversation, sessionIdForConversation, turnIdForConversation } from "./protocol.js";
+import { isRecord, nonBlankString as stringValue } from "./value-guards.js";
+export function summarizeConversation(conversation, ports) {
+    const executor = executorForConversation(conversation);
+    const callbackDelivery = isRecord(conversation.callback_delivery)
+        ? conversation.callback_delivery
+        : undefined;
+    const callbackDisposition = callbackDelivery
+        ? ports.callbackRetryDisposition(callbackDelivery)
+        : undefined;
+    return {
+        session_id: sessionIdForConversation(conversation),
+        turn_id: turnIdForConversation(conversation),
+        conversation_id: conversation.conversation_id,
+        agent: executor.kind,
+        executor,
+        session: executor.session,
+        status: conversation.status,
+        request: conversation.user_request,
+        workspace: conversation.workspace,
+        openclaw_session: conversation.openclaw_session,
+        response_rounds_used: conversation.response_rounds_used,
+        soft_limit: conversation.soft_limit,
+        hard_limit: conversation.hard_limit,
+        created_at: conversation.created_at,
+        updated_at: conversation.updated_at,
+        idle_since: conversation.idle_since,
+        closed_at: conversation.closed_at,
+        ...(callbackDelivery
+            ? {
+                callback_delivery: {
+                    status: callbackDelivery.status,
+                    attempts: callbackDelivery.attempts,
+                    attempt_state: callbackDisposition?.state,
+                    attempt_pid: callbackDelivery.attempt_pid,
+                    lease_expires_at: callbackDelivery.attempt_lease_expires_at,
+                    next_attempt_at: callbackDelivery.next_attempt_at,
+                    last_error: callbackDelivery.last_error === undefined
+                        ? undefined
+                        : ports.textSummary(String(callbackDelivery.last_error))
+                }
+            }
+            : {}),
+        state_path: conversation.state_path,
+        event_log_path: conversation.event_log_path
+    };
+}
+export function isDiscoverableTmuxConversation(conversation) {
+    if (!isRecord(conversation) || !isRecord(conversation.executor)) {
+        return false;
+    }
+    const kind = stringValue(conversation.executor.kind)?.toLowerCase();
+    return kind !== undefined &&
+        isExecutorKind(kind) &&
+        conversation.executor.transport === "tmux";
+}
+export function persistedExecutorLogFields(conversation) {
+    if (isDiscoverableTmuxConversation(conversation)) {
+        const executor = executorForConversation(conversation);
+        return {
+            agent: executor.kind,
+            executor_session: executor.session
+        };
+    }
+    const rawExecutor = isRecord(conversation?.executor) ? conversation.executor : {};
+    return {
+        agent: stringValue(rawExecutor.kind) ?? "unsupported",
+        executor_session: stringValue(rawExecutor.session)
+    };
+}
+export function summarizeEvent(event) {
+    return {
+        ts: event.ts,
+        event: event.event,
+        from: event.from,
+        to: event.to,
+        type: event.type,
+        status: event.status,
+        round: event.round,
+        body: typeof event.body === "string" ? event.body.slice(0, 500) : undefined
+    };
+}
+export function codexTerminalContextFromHistory(input) {
+    const { id, confidence, match, process, context, terminalControl, terminalStatus, limitations, candidates } = input;
+    return {
+        conversation_id: id,
+        source: "terminal_control",
+        confidence,
+        match,
+        about: rolloutAbout(context, terminalStatus),
+        codex_session: context.source,
+        evidence: {
+            process,
+            terminal_control: terminalControl,
+            terminal_status: terminalStatus,
+            initial_request: bestSessionIntent(context),
+            title: context.source.title,
+            recent_messages: visibleRolloutMessages(context).slice(-8),
+            recent_commands: context.commands.slice(-8),
+            candidates
+        },
+        limitations
+    };
+}
+export function managedConversationAbout(conversation, events, terminalStatus) {
+    const request = truncateText(String(conversation.user_request ?? "").trim(), 220);
+    const recent = recentMessageEvidence(events).at(-1)?.body;
+    const parts = [
+        request ? `Initial request: ${request}` : undefined,
+        recent ? `Latest visible message: ${truncateText(recent, 180)}` : undefined,
+        terminalStatus?.activity_state
+            ? `Current terminal state: ${terminalStatus.activity_state}.`
+            : undefined
+    ].filter(Boolean);
+    return parts.length > 0
+        ? parts.join(" ")
+        : "No durable task content is available for this AKK-managed session.";
+}
+export function rolloutAbout(context, terminalStatus) {
+    const title = truncateText(String(context.source.title ?? "").trim(), 180);
+    const intent = bestSessionIntent(context);
+    const latestAssistant = [...visibleRolloutMessages(context)].reverse()
+        .find((message) => message.role === "assistant")?.text;
+    const latestCommand = context.commands.at(-1)?.command;
+    const parts = [
+        intent
+            ? `Initial request: ${truncateText(intent, 220)}`
+            : title ? `Codex title: ${title}` : undefined,
+        latestAssistant
+            ? `Latest visible progress: ${truncateText(latestAssistant, 180)}`
+            : undefined,
+        latestCommand
+            ? `Recent command: ${truncateText(latestCommand, 140)}`
+            : undefined,
+        terminalStatus?.activity_state
+            ? `Current terminal state: ${terminalStatus.activity_state}.`
+            : undefined
+    ].filter(Boolean);
+    return parts.length > 0
+        ? parts.join(" ")
+        : "Codex history was found, but it did not include enough visible message content to summarize the session.";
+}
+export function screenOnlyAbout(input) {
+    const { process, terminalStatus } = input;
+    const activity = terminalStatus?.activity_reason ?? terminalStatus?.activity_state;
+    const excerpt = terminalStatus?.screen?.excerpt;
+    const parts = [
+        process?.cwd ? `This Codex process is running in ${process.cwd}.` : undefined,
+        activity ? `Terminal activity: ${truncateText(String(activity), 180)}` : undefined,
+        excerpt ? `Visible screen: ${truncateText(String(excerpt), 220)}` : undefined
+    ].filter(Boolean);
+    return parts.length > 0
+        ? parts.join(" ")
+        : "Only active process metadata is available; no Codex conversation history or terminal screen content could be read.";
+}
+export function bestSessionIntent(context) {
+    const firstUser = visibleRolloutMessages(context)
+        .find((message) => message.role === "user")?.text;
+    if (firstUser) {
+        return firstUser;
+    }
+    const title = cleanIntentText(context.source.title);
+    if (title) {
+        return title;
+    }
+    return undefined;
+}
+export function visibleRolloutMessages(context) {
+    return context.messages.filter((message) => !isEnvironmentContextMessage(message.text));
+}
+export function cleanIntentText(value) {
+    const text = String(value ?? "").replace(/\s+/g, " ").trim();
+    return text && !isEnvironmentContextMessage(text) ? text : undefined;
+}
+export function isEnvironmentContextMessage(value) {
+    return /^\s*<environment_context[\s>]/u.test(String(value ?? ""));
+}
+function recentMessageEvidence(events) {
+    return events
+        .filter((event) => event.event === "message" && typeof event.body === "string")
+        .slice(-8)
+        .map((event) => ({
+        ts: event.ts,
+        from: event.from,
+        to: event.to,
+        type: event.type,
+        round: event.round,
+        body: truncateText(event.body, 800)
+    }));
+}
+export function truncateText(value, maxLength) {
+    const text = String(value ?? "").replace(/\s+/g, " ").trim();
+    if (text.length <= maxLength) {
+        return text;
+    }
+    return `${text.slice(0, Math.max(0, maxLength - 3))}...`;
+}
+//# sourceMappingURL=terminal-status-facts.js.map

package/dist/src/terminal-status-facts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-status-facts.js","sourceRoot":"","sources":["../../src/terminal-status-facts.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,cAAc,EACf,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,uBAAuB,EACvB,wBAAwB,EACxB,qBAAqB,EAEtB,MAAM,eAAe,CAAC;AAQvB,OAAO,EACL,QAAQ,EACR,cAAc,IAAI,WAAW,EAC9B,MAAM,mBAAmB,CAAC;AAyB3B,MAAM,UAAU,qBAAqB,CACnC,YAA0B,EAC1B,KAAiC;IAEjC,MAAM,QAAQ,GAAG,uBAAuB,CAAC,YAAY,CAAC,CAAC;IACvD,MAAM,gBAAgB,GAAG,QAAQ,CAAC,YAAY,CAAC,iBAAiB,CAAC;QAC/D,CAAC,CAAC,YAAY,CAAC,iBAAiB;QAChC,CAAC,CAAC,SAAS,CAAC;IACd,MAAM,mBAAmB,GAAG,gBAAgB;QAC1C,CAAC,CAAC,KAAK,CAAC,wBAAwB,CAAC,gBAAgB,CAAC;QAClD,CAAC,CAAC,SAAS,CAAC;IACd,OAAO;QACL,UAAU,EAAE,wBAAwB,CAAC,YAAY,CAAC;QAClD,OAAO,EAAE,qBAAqB,CAAC,YAAY,CAAC;QAC5C,eAAe,EAAE,YAAY,CAAC,eAAe;QAC7C,KAAK,EAAE,QAAQ,CAAC,IAAI;QACpB,QAAQ;QACR,OAAO,EAAE,QAAQ,CAAC,OAAO;QACzB,MAAM,EAAE,YAAY,CAAC,MAAM;QAC3B,OAAO,EAAE,YAAY,CAAC,YAAY;QAClC,SAAS,EAAE,YAAY,CAAC,SAAS;QACjC,gBAAgB,EAAE,YAAY,CAAC,gBAAgB;QAC/C,oBAAoB,EAAE,YAAY,CAAC,oBAAoB;QACvD,UAAU,EAAE,YAAY,CAAC,UAAU;QACnC,UAAU,EAAE,YAAY,CAAC,UAAU;QACnC,UAAU,EAAE,YAAY,CAAC,UAAU;QACnC,UAAU,EAAE,YAAY,CAAC,UAAU;QACnC,UAAU,EAAE,YAAY,CAAC,UAAU;QACnC,SAAS,EAAE,YAAY,CAAC,SAAS;QACjC,GAAG,CAAC,gBAAgB;YAClB,CAAC,CAAC;gBACE,iBAAiB,EAAE;oBACjB,MAAM,EAAE,gBAAgB,CAAC,MAAM;oBAC/B,QAAQ,EAAE,gBAAgB,CAAC,QAAQ;oBACnC,aAAa,EAAE,mBAAmB,EAAE,KAAK;oBACzC,WAAW,EAAE,gBAAgB,CAAC,WAAW;oBACzC,gBAAgB,EAAE,gBAAgB,CAAC,wBAAwB;oBAC3D,eAAe,EAAE,gBAAgB,CAAC,eAAe;oBACjD,UAAU,EAAE,gBAAgB,CAAC,UAAU,KAAK,SAAS;wBACnD,CAAC,CAAC,SAAS;wBACX,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,gBAAgB,CAAC,UAAU,CAAC,CAAC;iBAC3D;aACF;YACH,CAAC,CAAC,EAAE,CAAC;QACP,UAAU,EAAE,YAAY,CAAC,UAAU;QACnC,cAAc,EAAE,YAAY,CAAC,cAAc;KAC5C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,8BAA8B,CAC5C,YAA0B;IAE1B,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,QAAQ,CAAC,EAAE,CAAC;QAChE,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,IAAI,GAAG,WAAW,CAAC,YAAY,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,WAAW,EAAE,CAAC;IACpE,OAAO,IAAI,KAAK,SAAS;QACvB,cAAc,CAAC,IAAI,CAAC;QACpB,YAAY,CAAC,QAAQ,CAAC,SAAS,KAAK,MAAM,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,YAA0B;IAInE,IAAI,8BAA8B,CAAC,YAAY,CAAC,EAAE,CAAC;QACjD,MAAM,QAAQ,GAAG,uBAAuB,CAAC,YAAY,CAAC,CAAC;QACvD,OAAO;YACL,KAAK,EAAE,QAAQ,CAAC,IAAI;YACpB,gBAAgB,EAAE,QAAQ,CAAC,OAAO;SACnC,CAAC;IACJ,CAAC;IACD,MAAM,WAAW,GACf,QAAQ,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;IAChE,OAAO;QACL,KAAK,EAAE,WAAW,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,aAAa;QACrD,gBAAgB,EAAE,WAAW,CAAC,WAAW,CAAC,OAAO,CAAC;KACnD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAsB;IACnD,OAAO;QACL,EAAE,EAAE,KAAK,CAAC,EAAE;QACZ,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,EAAE,EAAE,KAAK,CAAC,EAAE;QACZ,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,IAAI,EAAE,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS;KAC5E,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,+BAA+B,CAAC,KAU/C;IACC,MAAM,EACJ,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,cAAc,EACxE,WAAW,EAAE,UAAU,EACxB,GAAG,KAAK,CAAC;IACV,OAAO;QACL,eAAe,EAAE,EAAE;QACnB,MAAM,EAAE,kBAAkB;QAC1B,UAAU;QACV,KAAK;QACL,KAAK,EAAE,YAAY,CAAC,OAAO,EAAE,cAAc,CAAC;QAC5C,aAAa,EAAE,OAAO,CAAC,MAAM;QAC7B,QAAQ,EAAE;YACR,OAAO;YACP,gBAAgB,EAAE,eAAe;YACjC,eAAe,EAAE,cAAc;YAC/B,eAAe,EAAE,iBAAiB,CAAC,OAAO,CAAC;YAC3C,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,KAAK;YAC3B,eAAe,EAAE,sBAAsB,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAC1D,eAAe,EAAE,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAC3C,UAAU;SACX;QACD,WAAW;KACZ,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,wBAAwB,CACtC,YAA0B,EAC1B,MAAyB,EACzB,cAAqC;IAErC,MAAM,OAAO,GAAG,YAAY,CAAC,MAAM,CAAC,YAAY,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,GAAG,CAAC,CAAC;IAClF,MAAM,MAAM,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC;IAC1D,MAAM,KAAK,GAAG;QACZ,OAAO,CAAC,CAAC,CAAC,oBAAoB,OAAO,EAAE,CAAC,CAAC,CAAC,SAAS;QACnD,MAAM,CAAC,CAAC,CAAC,2BAA2B,YAAY,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS;QAC3E,cAAc,EAAE,cAAc;YAC5B,CAAC,CAAC,2BAA2B,cAAc,CAAC,cAAc,GAAG;YAC7D,CAAC,CAAC,SAAS;KACd,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAClB,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC;QACrB,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC;QACjB,CAAC,CAAC,oEAAoE,CAAC;AAC3E,CAAC;AAED,MAAM,UAAU,YAAY,CAC1B,OAA2B,EAC3B,cAAqC;IAErC,MAAM,KAAK,GAAG,YAAY,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,GAAG,CAAC,CAAC;IAC3E,MAAM,MAAM,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;IAC1C,MAAM,eAAe,GAAG,CAAC,GAAG,sBAAsB,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,EAAE;SACnE,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,KAAK,WAAW,CAAC,EAAE,IAAI,CAAC;IACzD,MAAM,aAAa,GAAG,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC;IACvD,MAAM,KAAK,GAAG;QACZ,MAAM;YACJ,CAAC,CAAC,oBAAoB,YAAY,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE;YACjD,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,gBAAgB,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS;QAC/C,eAAe;YACb,CAAC,CAAC,4BAA4B,YAAY,CAAC,eAAe,EAAE,GAAG,CAAC,EAAE;YAClE,CAAC,CAAC,SAAS;QACb,aAAa;YACX,CAAC,CAAC,mBAAmB,YAAY,CAAC,aAAa,EAAE,GAAG,CAAC,EAAE;YACvD,CAAC,CAAC,SAAS;QACb,cAAc,EAAE,cAAc;YAC5B,CAAC,CAAC,2BAA2B,cAAc,CAAC,cAAc,GAAG;YAC7D,CAAC,CAAC,SAAS;KACd,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAClB,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC;QACrB,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC;QACjB,CAAC,CAAC,0GAA0G,CAAC;AACjH,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAG/B;IACC,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE,GAAG,KAAK,CAAC;IAC1C,MAAM,QAAQ,GAAG,cAAc,EAAE,eAAe,IAAI,cAAc,EAAE,cAAc,CAAC;IACnF,MAAM,OAAO,GAAG,cAAc,EAAE,MAAM,EAAE,OAAO,CAAC;IAChD,MAAM,KAAK,GAAG;QACZ,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,oCAAoC,OAAO,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,SAAS;QAC7E,QAAQ,CAAC,CAAC,CAAC,sBAAsB,YAAY,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS;QAClF,OAAO,CAAC,CAAC,CAAC,mBAAmB,YAAY,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS;KAC9E,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAClB,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC;QACrB,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC;QACjB,CAAC,CAAC,oHAAoH,CAAC;AAC3H,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,OAA2B;IAE3B,MAAM,SAAS,GAAG,sBAAsB,CAAC,OAAO,CAAC;SAC9C,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,KAAK,MAAM,CAAC,EAAE,IAAI,CAAC;IACpD,IAAI,SAAS,EAAE,CAAC;QACd,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,KAAK,GAAG,eAAe,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACpD,IAAI,KAAK,EAAE,CAAC;QACV,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,OAA2B;IAChE,OAAO,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CACzC,CAAC,2BAA2B,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAAyB;IACvD,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IAC7D,OAAO,IAAI,IAAI,CAAC,2BAA2B,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;AACvE,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,KAAyB;IACnE,OAAO,gCAAgC,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC;AACpE,CAAC;AAED,SAAS,qBAAqB,CAAC,MAAyB;IACtD,OAAO,MAAM;SACV,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,KAAK,SAAS,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC;SAC9E,KAAK,CAAC,CAAC,CAAC,CAAC;SACT,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACf,EAAE,EAAE,KAAK,CAAC,EAAE;QACZ,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,EAAE,EAAE,KAAK,CAAC,EAAE;QACZ,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,IAAI,EAAE,YAAY,CAAC,KAAK,CAAC,IAAI,EAAE,GAAG,CAAC;KACpC,CAAC,CAAC,CAAC;AACR,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAc,EAAE,SAAiB;IAC5D,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IAC7D,IAAI,IAAI,CAAC,MAAM,IAAI,SAAS,EAAE,CAAC;QAC7B,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC;AAC3D,CAAC"}

package/dist/src/terminal-submission-acceptance.d.ts

@@ -1,101 +1,8 @@
-import type { CodexOpenRootRolloutIdentity, CodexOpenRootRolloutInventory } from "./agent-session-provider.js";
+import type { CodexOpenRootRolloutInventory } from "./agent-session-provider.js";
 import type { TerminalCompletionEvidence } from "./terminal-agent-adapter.js";
-export interface TerminalSubmissionAcceptanceEvidence {
-    source: "codex_rollout" | "claude_transcript";
-    kind: "native_user_turn";
-    nativeThreadId: string;
-    requestHash: string;
-    acceptanceId: string;
-    acceptedAt?: string;
-    anchorFingerprint: string;
-    evidenceFingerprint: string;
-    metadata?: Record<string, string | number>;
-}
-export interface CodexRolloutIdentity {
-    fd: string;
-    device: string;
-    inode: string;
-    path: string;
-}
-interface CodexRolloutAcceptanceAnchorBase {
-    schema: "agent-knock-knock/codex-rollout-acceptance-anchor";
-    process_uuid: string;
-    process_birth: string;
-    captured_at: string;
-    file_existed: boolean;
-    offset_bytes: number;
-    anchor_fingerprint: string;
-}
-export interface CodexBoundRolloutAcceptanceAnchor extends CodexRolloutAcceptanceAnchorBase {
-    version: 1;
-    native_thread_id: string;
-    mode: "existing" | "pre_materialization";
-    rollout?: CodexRolloutIdentity;
-    expected_empty_native_session?: true;
-}
-/**
- * A process-bound anchor for a genuinely virgin Codex TUI. Codex does not
- * assign a native thread UUID or open a rollout until its first prompt is
- * submitted, so the UUID cannot safely be named before transport. The exact
- * process incarnation is still pinned here; acceptance must additionally
- * prove the newly materialized UUID, rollout, and request hash.
- */
-export interface CodexVirginRolloutAcceptanceAnchor extends CodexRolloutAcceptanceAnchorBase {
-    version: 2;
-    mode: "pre_materialization";
-    native_thread_id?: never;
-    native_thread_binding: "post_submission";
-    file_existed: false;
-    offset_bytes: 0;
-    rollout?: never;
-    expected_empty_native_session: true;
-}
-export interface CodexCandidateRolloutAcceptanceAnchorEntry {
-    native_thread_id: string;
-    rollout: CodexRolloutIdentity;
-    offset_bytes: number;
-}
-/**
- * A process-bound pre-submit snapshot for a terminal whose open-root
- * inventory is exact but cannot name one foreground root. Existing roots are
- * fenced at their byte offsets; roots opened after capture are admitted only
- * with a fresh exact session_meta header. No candidate is selected by mtime.
- */
-export interface CodexCandidateSetRolloutAcceptanceAnchor extends CodexRolloutAcceptanceAnchorBase {
-    version: 3;
-    mode: "candidate_set";
-    native_thread_binding: "post_submission";
-    file_existed: false;
-    offset_bytes: 0;
-    zero_file_baseline: boolean;
-    inventory_pid: number;
-    inventory_cwd?: string;
-    inventory_fingerprint: string;
-    candidate_rollouts: CodexCandidateRolloutAcceptanceAnchorEntry[];
-}
-export type CodexRolloutAcceptanceAnchor = CodexBoundRolloutAcceptanceAnchor | CodexVirginRolloutAcceptanceAnchor | CodexCandidateSetRolloutAcceptanceAnchor;
-export type CodexCandidateSetRolloutAcceptanceResult = {
-    status: "accepted";
-    identity: CodexOpenRootRolloutIdentity;
-    evidence: TerminalSubmissionAcceptanceEvidence;
-} | {
-    status: "pending";
-    inspected_candidates: number;
-    exact_matches: number;
-    incomplete_candidates?: number;
-} | {
-    status: "uncertain";
-    code: "multiple_exact_request_acceptances" | "candidate_inventory_changed" | "candidate_scan_invalid";
-    reason: string;
-    inspected_candidates: number;
-    exact_matches: number;
-};
-export interface CodexRolloutAcceptanceIdentity {
-    sessionId: string;
-    processUuid?: string;
-    processBirth?: string;
-    rollout?: CodexRolloutIdentity;
-}
+import { validateCodexRolloutAcceptanceAnchor, validateTerminalSubmissionAcceptanceEvidence, type CaptureCodexRolloutAcceptanceAnchorOptions, type CodexCandidateSetRolloutAcceptanceAnchor, type CodexCandidateSetRolloutAcceptanceRequest, type CodexCandidateSetRolloutAcceptanceResult, type CodexRolloutAcceptanceAnchor, type CodexRolloutAcceptanceIdentity, type CodexRolloutAcceptanceRequest, type CodexRolloutIdentity, type TerminalSubmissionAcceptanceEvidence } from "./terminal-submission-facts.js";
+export { validateCodexRolloutAcceptanceAnchor, validateTerminalSubmissionAcceptanceEvidence };
+export type { CodexBoundRolloutAcceptanceAnchor, CodexCandidateRolloutAcceptanceAnchorEntry, CodexCandidateSetRolloutAcceptanceAnchor, CodexRolloutAcceptanceAnchor, CodexCandidateSetRolloutAcceptanceResult, CodexRolloutAcceptanceIdentity, CodexRolloutIdentity, TerminalSubmissionAcceptanceEvidence, CodexVirginRolloutAcceptanceAnchor } from "./terminal-submission-facts.js";
 export type CodexBoundRolloutCompletionCode = "completion_found" | "exact_turn_not_complete" | "partial_rollout_record" | "rollout_changed_during_scan" | "invalid_anchor" | "invalid_acceptance_evidence" | "acceptance_anchor_mismatch" | "acceptance_turn_mismatch" | "binding_identity_mismatch" | "rollout_identity_mismatch" | "rollout_unreadable" | "rollout_truncated" | "scan_limit_exceeded" | "invalid_rollout_jsonl" | "duplicate_exact_completion" | "invalid_exact_completion";
 export interface CodexBoundRolloutCompletionDiagnostics {
     detector: "codex_exact_bound_rollout";
@@ -121,60 +28,72 @@ export type CodexBoundRolloutCompletionResult = {
     status: "failure";
     diagnostics: CodexBoundRolloutCompletionDiagnostics;
 };
-export declare function validateTerminalSubmissionAcceptanceEvidence(value: unknown, expected: {
-    source: TerminalSubmissionAcceptanceEvidence["source"];
-    nativeThreadId: string;
-    requestHash: string;
-}): TerminalSubmissionAcceptanceEvidence;
-export declare function terminalSubmissionReplayReceipt(options: {
-    proofLevel: "submitted" | "enter_dispatched" | "agent_accepted";
-    evidence?: unknown;
-    expected: {
-        source: TerminalSubmissionAcceptanceEvidence["source"];
-        nativeThreadId: string;
-        requestHash: string;
-    };
-}): {
-    replayed: true;
-    delivered: boolean;
-    status: "async_pending" | "submission_pending_acceptance" | "submission_uncertain";
-    submission_outcome: "agent_accepted" | "pending_acceptance" | "uncertain";
-    delivery_receipt: "agent_accepted" | "enter_dispatched" | "submitted";
-    do_not_retry?: true;
-    evidence_error?: string;
-};
-type CaptureCodexRolloutAcceptanceAnchorOptions = {
-    processUuid: string;
-    processBirth: string;
-    now?: Date;
-} & ({
-    nativeThreadId: string;
-    mode: "existing";
+/**
+ * Durable identity for one already-running Codex task that was started by the
+ * human in the TUI. The prompt itself is deliberately omitted; the exact root
+ * user row is represented only by its SHA-256 digest and native turn UUID.
+ */
+export interface CodexHumanStartedActiveTaskAnchor {
+    schema: "agent-knock-knock/codex-human-started-active-task-anchor";
+    version: 1;
+    native_thread_id: string;
+    process_uuid: string;
+    process_birth: string;
+    captured_at: string;
     rollout: CodexRolloutIdentity;
+    turn_id: string;
+    request_hash: string;
+    codex_version: string;
+    task_started_offset_bytes: number;
+    user_message_offset_bytes: number;
+    observed_end_offset_bytes: number;
+    anchor_fingerprint: string;
+}
+export interface CaptureCodexHumanStartedActiveTaskOptions {
+    currentIdentity: CodexRolloutAcceptanceIdentity;
+    now?: Date;
+    maxBytes?: number;
+}
+export interface ObserveCodexHumanStartedActiveTaskOptions {
+    anchor: CodexHumanStartedActiveTaskAnchor;
+    currentIdentity: CodexRolloutAcceptanceIdentity;
+    maxBytes?: number;
+    /** Last complete, stable JSONL boundary returned by a prior observation. */
+    resumeOffsetBytes?: number;
+}
+export type CodexHumanStartedActiveTaskObservation = {
+    status: "pending";
+    observedEndOffsetBytes: number;
+    safeResumeOffsetBytes: number;
 } | {
-    nativeThreadId: string;
-    mode: "pre_materialization";
-    expectedEmptyNativeSession: true;
+    status: "completed";
+    completion: TerminalCompletionEvidence & {
+        outcome: "success" | "failure";
+    };
 } | {
-    nativeThreadId?: undefined;
-    mode: "pre_materialization";
-    expectedEmptyNativeSession: true;
-});
+    status: "invalidated";
+    reason: string;
+} | {
+    status: "unavailable";
+    reason: string;
+    retryable: true;
+};
+/**
+ * Capture the latest active native task in an exact open Codex rollout.
+ * This is intentionally separate from the pre-send acceptance anchor: all
+ * task-start and root-user evidence already exists when this function runs.
+ */
+export declare function captureCodexHumanStartedActiveTaskAnchor(options: CaptureCodexHumanStartedActiveTaskOptions): CodexHumanStartedActiveTaskAnchor | undefined;
+/** Observe only the exact human-started task named by the persisted anchor. */
+export declare function observeCodexHumanStartedActiveTask(options: ObserveCodexHumanStartedActiveTaskOptions): CodexHumanStartedActiveTaskObservation;
+export declare function validateCodexHumanStartedActiveTaskAnchor(value: unknown): CodexHumanStartedActiveTaskAnchor;
 export declare function captureCodexRolloutAcceptanceAnchor(options: CaptureCodexRolloutAcceptanceAnchorOptions): CodexRolloutAcceptanceAnchor;
 export declare function captureCodexCandidateSetRolloutAcceptanceAnchor({ inventory: inventoryValue, now }: {
     inventory: CodexOpenRootRolloutInventory;
     now?: Date;
 }): CodexCandidateSetRolloutAcceptanceAnchor;
-export declare function detectCodexCandidateSetRolloutAcceptance({ anchor: anchorValue, currentInventory: inventoryValue, requestHash: requestHashValue }: {
-    anchor: CodexCandidateSetRolloutAcceptanceAnchor;
-    currentInventory: CodexOpenRootRolloutInventory;
-    requestHash: string;
-}): CodexCandidateSetRolloutAcceptanceResult;
-export declare function detectCodexRolloutAcceptance(options: {
-    anchor: CodexRolloutAcceptanceAnchor;
-    currentIdentity: CodexRolloutAcceptanceIdentity;
-    requestHash: string;
-}): TerminalSubmissionAcceptanceEvidence | undefined;
+export declare function detectCodexCandidateSetRolloutAcceptance({ anchor: anchorValue, currentInventory: inventoryValue, requestHash: requestHashValue }: CodexCandidateSetRolloutAcceptanceRequest): CodexCandidateSetRolloutAcceptanceResult;
+export declare function detectCodexRolloutAcceptance(options: CodexRolloutAcceptanceRequest): TerminalSubmissionAcceptanceEvidence | undefined;
 /**
  * Scans the exact rollout and native turn proven by terminal acceptance.
  *
@@ -189,5 +108,3 @@ export declare function detectCodexBoundRolloutCompletion(options: {
     currentIdentity: CodexRolloutAcceptanceIdentity;
     requestHash: string;
 }): CodexBoundRolloutCompletionResult;
-export declare function validateCodexRolloutAcceptanceAnchor(value: CodexRolloutAcceptanceAnchor): CodexRolloutAcceptanceAnchor;
-export {};