botmux 3.5.2 → 3.6.0

package/dist/services/codex-app-runner-protocol.d.ts

@@ -0,0 +1,61 @@
+import type { CodexAppTurnInput } from '../types.js';
+export declare const CODEX_APP_INPUT_PREFIX = "::botmux-codex-app:";
+export interface CodexAppRunnerInput {
+    type: 'message';
+    content: string;
+    codexAppInput?: CodexAppTurnInput;
+    /** Immutable botmux/Lark message id used only for reply routing. */
+    replyTurnId?: string;
+}
+export interface CodexAppFinalMarker {
+    content: string;
+    startedAtMs?: number;
+    completedAtMs?: number;
+    /** Codex app-server turn id, used for protocol matching and deduplication. */
+    appTurnId?: string;
+    /** botmux/Lark message id, used to select the Feishu reply destination. */
+    replyTurnId?: string;
+    /** Pre-steer Codex App and Mira markers used one id for both domains. */
+    legacyTurnId?: string;
+}
+interface CodexAppLifecycleBase {
+    atMs: number;
+    queueLength?: number;
+    appTurnId?: string;
+    replyTurnId?: string;
+}
+export type CodexAppLifecycleOperation = 'turn/start' | 'turn/steer' | 'runner';
+export type CodexAppLifecycleCategory = 'definite_rejection' | 'steer_in_flight' | 'transport' | 'rpc' | 'protocol' | 'runtime';
+export type CodexAppLifecycleEvent = (CodexAppLifecycleBase & {
+    kind: 'input_queued' | 'turn_start_attempt';
+    queueLength: number;
+}) | (CodexAppLifecycleBase & {
+    kind: 'turn_started' | 'steer_attempt' | 'steer_accepted';
+    appTurnId: string;
+}) | (CodexAppLifecycleBase & {
+    kind: 'steer_rejected_fallback';
+    appTurnId: string;
+    category: 'definite_rejection';
+}) | (CodexAppLifecycleBase & {
+    kind: 'completion_race';
+    appTurnId: string;
+    category: 'steer_in_flight';
+}) | (CodexAppLifecycleBase & {
+    kind: 'unknown_outcome';
+    operation: 'turn/start' | 'turn/steer';
+    category: 'transport' | 'rpc' | 'protocol';
+}) | (CodexAppLifecycleBase & {
+    kind: 'fatal';
+    operation: CodexAppLifecycleOperation;
+    category: 'transport' | 'rpc' | 'protocol' | 'runtime';
+});
+export interface AppRunnerFinalIds {
+    lastUuid: string;
+    turnId: string;
+}
+export declare function decodeCodexAppRunnerInput(line: string): CodexAppRunnerInput | undefined;
+export declare function normalizeAppRunnerFinalMarker(payload: unknown): CodexAppFinalMarker | undefined;
+export declare function normalizeCodexAppLifecycleEvent(payload: unknown): CodexAppLifecycleEvent | undefined;
+export declare function projectAppRunnerFinalIds(marker: CodexAppFinalMarker, fallbackTurnId: string | undefined, generatedFallbackId: string): AppRunnerFinalIds;
+export {};
+//# sourceMappingURL=codex-app-runner-protocol.d.ts.map

package/dist/services/codex-app-runner-protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-app-runner-protocol.d.ts","sourceRoot":"","sources":["../../src/services/codex-app-runner-protocol.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAGrD,eAAO,MAAM,sBAAsB,wBAAwB,CAAC;AAE5D,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,iBAAiB,CAAC;IAClC,oEAAoE;IACpE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,8EAA8E;IAC9E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2EAA2E;IAC3E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yEAAyE;IACzE,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,UAAU,qBAAqB;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,MAAM,0BAA0B,GAAG,YAAY,GAAG,YAAY,GAAG,QAAQ,CAAC;AAChF,MAAM,MAAM,yBAAyB,GACjC,oBAAoB,GACpB,iBAAiB,GACjB,WAAW,GACX,KAAK,GACL,UAAU,GACV,SAAS,CAAC;AAEd,MAAM,MAAM,sBAAsB,GAC9B,CAAC,qBAAqB,GAAG;IACzB,IAAI,EAAE,cAAc,GAAG,oBAAoB,CAAC;IAC5C,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC,GACA,CAAC,qBAAqB,GAAG;IACzB,IAAI,EAAE,cAAc,GAAG,eAAe,GAAG,gBAAgB,CAAC;IAC1D,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC,GACA,CAAC,qBAAqB,GAAG;IACzB,IAAI,EAAE,yBAAyB,CAAC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,oBAAoB,CAAC;CAChC,CAAC,GACA,CAAC,qBAAqB,GAAG;IACzB,IAAI,EAAE,iBAAiB,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,iBAAiB,CAAC;CAC7B,CAAC,GACA,CAAC,qBAAqB,GAAG;IACzB,IAAI,EAAE,iBAAiB,CAAC;IACxB,SAAS,EAAE,YAAY,GAAG,YAAY,CAAC;IACvC,QAAQ,EAAE,WAAW,GAAG,KAAK,GAAG,UAAU,CAAC;CAC5C,CAAC,GACA,CAAC,qBAAqB,GAAG;IACzB,IAAI,EAAE,OAAO,CAAC;IACd,SAAS,EAAE,0BAA0B,CAAC;IACtC,QAAQ,EAAE,WAAW,GAAG,KAAK,GAAG,UAAU,GAAG,SAAS,CAAC;CACxD,CAAC,CAAC;AAEL,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAwBD,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS,CAkCvF;AAED,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,OAAO,GAAG,mBAAmB,GAAG,SAAS,CAU/F;AAED,wBAAgB,+BAA+B,CAAC,OAAO,EAAE,OAAO,GAAG,sBAAsB,GAAG,SAAS,CA2FpG;AAED,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,mBAAmB,EAC3B,cAAc,EAAE,MAAM,GAAG,SAAS,EAClC,mBAAmB,EAAE,MAAM,GAC1B,iBAAiB,CASnB"}

package/dist/services/codex-app-runner-protocol.js

@@ -0,0 +1,170 @@
+import { Buffer } from 'node:buffer';
+import { isCodexAppTurnInput } from '../adapters/cli/codex-app-turn.js';
+export const CODEX_APP_INPUT_PREFIX = '::botmux-codex-app:';
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function optionalNonEmptyString(value) {
+    return typeof value === 'string' && value.length > 0 ? value : undefined;
+}
+function optionalFiniteNumber(value) {
+    return typeof value === 'number' && Number.isFinite(value) ? value : undefined;
+}
+function optionalLifecycleId(value) {
+    return typeof value === 'string' && value.length > 0 && value.length <= 512
+        ? value
+        : undefined;
+}
+function isNonNegativeInteger(value) {
+    return typeof value === 'number' && Number.isInteger(value) && value >= 0;
+}
+export function decodeCodexAppRunnerInput(line) {
+    const trimmed = line.trim();
+    if (!trimmed.startsWith(CODEX_APP_INPUT_PREFIX))
+        return undefined;
+    let value;
+    try {
+        const encoded = trimmed.slice(CODEX_APP_INPUT_PREFIX.length);
+        value = JSON.parse(Buffer.from(encoded, 'base64').toString('utf8'));
+    }
+    catch {
+        return undefined;
+    }
+    if (!isRecord(value) || value.type !== 'message' || typeof value.content !== 'string') {
+        return undefined;
+    }
+    const allowedKeys = new Set(['type', 'content', 'codexAppInput', 'replyTurnId']);
+    if (Object.keys(value).some(key => !allowedKeys.has(key)))
+        return undefined;
+    if (value.replyTurnId !== undefined && optionalLifecycleId(value.replyTurnId) === undefined) {
+        return undefined;
+    }
+    if (value.codexAppInput !== undefined && !isCodexAppTurnInput(value.codexAppInput)) {
+        return undefined;
+    }
+    const codexAppInput = isCodexAppTurnInput(value.codexAppInput)
+        ? value.codexAppInput
+        : undefined;
+    const replyTurnId = typeof value.replyTurnId === 'string'
+        ? value.replyTurnId
+        : codexAppInput?.clientUserMessageId;
+    return {
+        type: 'message',
+        content: value.content,
+        ...(codexAppInput ? { codexAppInput } : {}),
+        ...(replyTurnId ? { replyTurnId } : {}),
+    };
+}
+export function normalizeAppRunnerFinalMarker(payload) {
+    if (!isRecord(payload) || typeof payload.content !== 'string')
+        return undefined;
+    return {
+        content: payload.content,
+        startedAtMs: optionalFiniteNumber(payload.startedAtMs),
+        completedAtMs: optionalFiniteNumber(payload.completedAtMs),
+        appTurnId: optionalNonEmptyString(payload.appTurnId),
+        replyTurnId: optionalNonEmptyString(payload.replyTurnId),
+        legacyTurnId: optionalNonEmptyString(payload.turnId),
+    };
+}
+export function normalizeCodexAppLifecycleEvent(payload) {
+    if (!isRecord(payload) || typeof payload.kind !== 'string')
+        return undefined;
+    const allowedKeys = new Set([
+        'kind',
+        'atMs',
+        'queueLength',
+        'appTurnId',
+        'replyTurnId',
+        'operation',
+        'category',
+    ]);
+    if (Object.keys(payload).some(key => !allowedKeys.has(key)))
+        return undefined;
+    if (typeof payload.atMs !== 'number' || !Number.isFinite(payload.atMs) || payload.atMs < 0) {
+        return undefined;
+    }
+    if (payload.queueLength !== undefined && !isNonNegativeInteger(payload.queueLength)) {
+        return undefined;
+    }
+    if (payload.appTurnId !== undefined && optionalLifecycleId(payload.appTurnId) === undefined) {
+        return undefined;
+    }
+    if (payload.replyTurnId !== undefined && optionalLifecycleId(payload.replyTurnId) === undefined) {
+        return undefined;
+    }
+    const base = {
+        atMs: payload.atMs,
+        ...(typeof payload.queueLength === 'number' ? { queueLength: payload.queueLength } : {}),
+        ...(typeof payload.appTurnId === 'string' ? { appTurnId: payload.appTurnId } : {}),
+        ...(typeof payload.replyTurnId === 'string' ? { replyTurnId: payload.replyTurnId } : {}),
+    };
+    const appTurnId = optionalLifecycleId(payload.appTurnId);
+    switch (payload.kind) {
+        case 'input_queued':
+        case 'turn_start_attempt':
+            if (!isNonNegativeInteger(payload.queueLength)
+                || payload.appTurnId !== undefined
+                || payload.operation !== undefined
+                || payload.category !== undefined)
+                return undefined;
+            return { ...base, kind: payload.kind, queueLength: payload.queueLength };
+        case 'turn_started':
+        case 'steer_attempt':
+        case 'steer_accepted':
+            if (!appTurnId || payload.operation !== undefined || payload.category !== undefined) {
+                return undefined;
+            }
+            return { ...base, kind: payload.kind, appTurnId };
+        case 'steer_rejected_fallback':
+            if (!appTurnId || payload.operation !== undefined || payload.category !== 'definite_rejection') {
+                return undefined;
+            }
+            return { ...base, kind: payload.kind, appTurnId, category: 'definite_rejection' };
+        case 'completion_race':
+            if (!appTurnId || payload.operation !== undefined || payload.category !== 'steer_in_flight') {
+                return undefined;
+            }
+            return { ...base, kind: payload.kind, appTurnId, category: 'steer_in_flight' };
+        case 'unknown_outcome':
+            if ((payload.operation !== 'turn/start' && payload.operation !== 'turn/steer')
+                || (payload.category !== 'transport'
+                    && payload.category !== 'rpc'
+                    && payload.category !== 'protocol'))
+                return undefined;
+            return {
+                ...base,
+                kind: payload.kind,
+                operation: payload.operation,
+                category: payload.category,
+            };
+        case 'fatal':
+            if ((payload.operation !== 'turn/start'
+                && payload.operation !== 'turn/steer'
+                && payload.operation !== 'runner')
+                || (payload.category !== 'transport'
+                    && payload.category !== 'rpc'
+                    && payload.category !== 'protocol'
+                    && payload.category !== 'runtime'))
+                return undefined;
+            return {
+                ...base,
+                kind: payload.kind,
+                operation: payload.operation,
+                category: payload.category,
+            };
+        default:
+            return undefined;
+    }
+}
+export function projectAppRunnerFinalIds(marker, fallbackTurnId, generatedFallbackId) {
+    if (marker.appTurnId) {
+        return {
+            lastUuid: marker.appTurnId,
+            turnId: marker.replyTurnId ?? fallbackTurnId ?? marker.appTurnId,
+        };
+    }
+    const legacyId = marker.legacyTurnId ?? fallbackTurnId ?? generatedFallbackId;
+    return { lastUuid: legacyId, turnId: legacyId };
+}
+//# sourceMappingURL=codex-app-runner-protocol.js.map

package/dist/services/codex-app-runner-protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-app-runner-protocol.js","sourceRoot":"","sources":["../../src/services/codex-app-runner-protocol.ts"],"names":[],"mappings":"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"}

package/dist/services/codex-app-turn-controller.d.ts

@@ -0,0 +1,72 @@
+import type { CodexAppFinalMarker, CodexAppLifecycleCategory, CodexAppLifecycleEvent, CodexAppRunnerInput } from './codex-app-runner-protocol.js';
+import type { CodexAppTurnInput } from '../types.js';
+export declare class CodexAppRpcResponseError extends Error {
+    readonly method: string;
+    readonly code?: number;
+    readonly data?: unknown;
+    constructor(method: string, error: unknown);
+}
+export declare class CodexAppTransportError extends Error {
+    constructor(message: string);
+}
+export interface CodexAppPreparedInput {
+    input: Array<Record<string, unknown>>;
+    additionalContext?: CodexAppTurnInput['additionalContext'];
+    clientUserMessageId?: string;
+    visibleText: string;
+    structured: boolean;
+    skippedImages?: string[];
+}
+export interface CodexAppTurnControllerDeps {
+    cwd: string;
+    ensureThread(): Promise<string>;
+    request(method: string, params: unknown): Promise<unknown>;
+    prepareInput(input: CodexAppRunnerInput, structuredDisabled: boolean): CodexAppPreparedInput;
+    isStartCapabilityError?(error: unknown): boolean;
+    onTurnInput?(input: CodexAppRunnerInput, prepared: CodexAppPreparedInput): void;
+    onOutput?(text: string): void;
+    onDiagnostic?(message: string): void;
+    onLifecycle?(event: CodexAppLifecycleEvent): void;
+    onFinal(marker: CodexAppFinalMarker & {
+        appTurnId: string;
+    }): void;
+    onPrompt?(): void;
+    now?(): number;
+}
+export declare function isDefiniteSteerRejection(error: CodexAppRpcResponseError): boolean;
+export declare class CodexAppTurnController {
+    private readonly deps;
+    private readonly queue;
+    private readonly closedTurnIds;
+    private active;
+    private fatal;
+    private structuredDisabled;
+    private failureSequence;
+    private driving;
+    private driveAgain;
+    constructor(deps: CodexAppTurnControllerDeps);
+    enqueue(input: CodexAppRunnerInput): void;
+    handleNotification(message: unknown): void;
+    handleFatal(error: unknown, category?: Extract<CodexAppLifecycleCategory, 'transport' | 'rpc' | 'protocol' | 'runtime'>): void;
+    private drive;
+    private startTurn;
+    private beginTurnStart;
+    private steerQueueHead;
+    private performSteer;
+    private turnStartParams;
+    private reportPreparedInput;
+    private adoptAppTurnId;
+    private emitTurnStarted;
+    private emitUnknownOutcome;
+    private finalizeTurn;
+    private emitFailure;
+    private emitStandaloneFailure;
+    private afterTurn;
+    private rememberClosedTurn;
+    private nextFailureId;
+    private now;
+    private emitLifecycle;
+    private activeOperation;
+    private errorCategory;
+}
+//# sourceMappingURL=codex-app-turn-controller.d.ts.map

package/dist/services/codex-app-turn-controller.d.ts.map

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