@deepseek-harness-tui/dsh-tui 0.13.0 → 0.14.0

package/lib/types/backends/codex/prefs.d.ts

@@ -0,0 +1,42 @@
+import { type CodexModeId } from './modes.js';
+import { type Rec } from './narrow.js';
+export interface CodexPrefsData {
+    readonly model?: string;
+    readonly effort?: string;
+    readonly mode?: CodexModeId;
+    /** Collaboration mode is independent of the permission preset. */
+    readonly plan?: boolean;
+    /** The thread a bare `dsh-tui --backend codex --resume` opens (the
+     *  launcher reads this field directly). */
+    readonly lastSession?: string;
+    /** This install's last use of each thread (epoch ms; the newest kept). */
+    readonly lastUsed?: Readonly<Record<string, number>>;
+    readonly colors?: Readonly<Record<string, string>>;
+}
+/** A patch: a value sets the field, `null` clears it. */
+export interface CodexPrefsPatch {
+    readonly model?: string | null;
+    readonly effort?: string | null;
+    readonly mode?: CodexModeId | null;
+    readonly plan?: boolean | null;
+    readonly lastSession?: string | null;
+    readonly colors?: Readonly<Record<string, string>>;
+}
+export interface CodexPrefs {
+    read(): CodexPrefsData;
+    write(patch: CodexPrefsPatch): void;
+    touch(threadId: string): void;
+    forget(threadId: string): void;
+}
+/** Per-field start overrides: explicit prefs > config/read > defaults.
+ * An unreadable config is not evidence that a user has no configuration. */
+export declare function resolveCodexStartOptions(prefs: CodexPrefsData, config?: Rec): Rec;
+/** Unwrap config/read without accepting a malformed answer as defaults. */
+export declare function codexConfigOf(answer: unknown): Rec | undefined;
+/** The file-backed prefs under `<dir>` (default `~/.dsh-tui/backends/codex`). */
+export declare function fileCodexPrefs(dir?: string, debug?: (message: string) => void): CodexPrefs;
+/** An in-memory store (tests). */
+export declare function memoryCodexPrefs(initial?: CodexPrefsData): CodexPrefs & {
+    readonly data: CodexPrefsData;
+};
+//# sourceMappingURL=prefs.d.ts.map

package/lib/types/backends/codex/prefs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prefs.d.ts","sourceRoot":"","sources":["../../../../src/backends/codex/prefs.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAwD,KAAK,WAAW,EAAE,MAAM,YAAY,CAAA;AACnG,OAAO,EAAO,KAAK,GAAG,EAAE,MAAM,aAAa,CAAA;AAE3C,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,IAAI,CAAC,EAAE,WAAW,CAAA;IAC3B,kEAAkE;IAClE,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAA;IACvB;+CAC2C;IAC3C,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,0EAA0E;IAC1E,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;IACpD,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;CACnD;AAED,yDAAyD;AACzD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC/B,QAAQ,CAAC,IAAI,CAAC,EAAE,WAAW,GAAG,IAAI,CAAA;IAClC,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAA;IAC9B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACpC,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;CACnD;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,IAAI,cAAc,CAAA;IACtB,KAAK,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI,CAAA;IACnC,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;CAC/B;AAoDD;4EAC4E;AAC5E,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,cAAc,EAAE,MAAM,CAAC,EAAE,GAAG,GAAG,GAAG,CASjF;AAED,2EAA2E;AAC3E,wBAAgB,aAAa,CAAC,MAAM,EAAE,OAAO,GAAG,GAAG,GAAG,SAAS,CAE9D;AAED,iFAAiF;AACjF,wBAAgB,cAAc,CAAC,GAAG,GAAE,MAA4C,EAAE,KAAK,GAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAsB,GAAG,UAAU,CAsBhJ;AAED,kCAAkC;AAClC,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,cAAmB,GAAG,UAAU,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAA;CAAE,CAS7G"}

package/lib/types/backends/codex/prefs.js

@@ -0,0 +1,124 @@
+/**
+ * The Codex backend's persisted user choices
+ * (`~/.dsh-tui/backends/codex/prefs.json`, docs/codex-backend-design.md
+ * §5.18, D6): the model / effort / mode picks a later session starts with,
+ * the session a bare `--backend codex --resume` opens, and this install's
+ * last use of each thread. dsh-tui never writes Codex's own
+ * `config.toml`; these apply per thread through `thread/start` /
+ * `turn/start`.
+ *
+ * Best-effort like every `~/.dsh-tui` preference: a missing or corrupt file
+ * reads as "no choice", a failed write goes to the debug log.
+ */
+import { readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { DATA_DIR } from '../../utils/paths.js';
+import { writeFileAtomic } from '../shared/atomic-file.js';
+import { CODEX_MODE_PARAMS, DEFAULT_CODEX_MODE, isCodexModeId } from './modes.js';
+import { rec } from './narrow.js';
+const FILE = 'prefs.json';
+const LAST_USED_LIMIT = 200;
+function parse(parsed) {
+    if (parsed === null || typeof parsed !== 'object' || Array.isArray(parsed))
+        return {};
+    const record = parsed;
+    const lastUsed = {};
+    const colors = Object.fromEntries(Object.entries(rec(record.colors) ?? {}).filter((entry) => typeof entry[1] === 'string').slice(-LAST_USED_LIMIT));
+    if (record.lastUsed !== null && typeof record.lastUsed === 'object' && !Array.isArray(record.lastUsed)) {
+        for (const [id, value] of Object.entries(record.lastUsed)) {
+            if (typeof value === 'number' && Number.isFinite(value))
+                lastUsed[id] = value;
+        }
+    }
+    return {
+        ...(typeof record.model === 'string' && record.model !== '' ? { model: record.model } : {}),
+        ...(typeof record.effort === 'string' && record.effort !== '' ? { effort: record.effort } : {}),
+        ...(isCodexModeId(record.mode) ? { mode: record.mode } : {}),
+        ...(typeof record.plan === 'boolean' ? { plan: record.plan } : {}),
+        ...(typeof record.lastSession === 'string' && record.lastSession !== '' ? { lastSession: record.lastSession } : {}),
+        ...(Object.keys(lastUsed).length === 0 ? {} : { lastUsed }),
+        ...(Object.keys(colors).length === 0 ? {} : { colors }),
+    };
+}
+function patched(current, patch) {
+    const next = { ...current };
+    for (const key of ['model', 'effort', 'mode', 'plan', 'lastSession']) {
+        const value = patch[key];
+        if (value === undefined)
+            continue;
+        if (value === null)
+            delete next[key];
+        else
+            next[key] = value;
+    }
+    if (patch.colors !== undefined)
+        next.colors = Object.fromEntries(Object.entries(patch.colors).slice(-LAST_USED_LIMIT));
+    return next;
+}
+function touched(current, threadId, now) {
+    const entries = Object.entries({ ...current.lastUsed, [threadId]: now }).sort((a, b) => b[1] - a[1]).slice(0, LAST_USED_LIMIT);
+    return { ...current, lastUsed: Object.fromEntries(entries) };
+}
+function forgotten(current, threadId) {
+    const lastUsed = { ...current.lastUsed };
+    delete lastUsed[threadId];
+    const next = { ...current, lastUsed };
+    if (Object.keys(lastUsed).length === 0)
+        delete next.lastUsed;
+    if (current.lastSession === threadId)
+        delete next.lastSession;
+    return next;
+}
+/** Per-field start overrides: explicit prefs > config/read > defaults.
+ * An unreadable config is not evidence that a user has no configuration. */
+export function resolveCodexStartOptions(prefs, config) {
+    const mode = prefs.mode === undefined ? undefined : CODEX_MODE_PARAMS[prefs.mode];
+    const defaults = CODEX_MODE_PARAMS[DEFAULT_CODEX_MODE];
+    return {
+        ...(mode !== undefined ? { approvalPolicy: mode.approvalPolicy } : config !== undefined && config.approval_policy == null ? { approvalPolicy: defaults.approvalPolicy } : {}),
+        ...(mode !== undefined ? { sandbox: mode.sandbox } : config !== undefined && config.sandbox_mode == null ? { sandbox: defaults.sandbox } : {}),
+        ...(prefs.model === undefined ? {} : { model: prefs.model }),
+        ...(prefs.effort === undefined ? {} : { config: { model_reasoning_effort: prefs.effort } }),
+    };
+}
+/** Unwrap config/read without accepting a malformed answer as defaults. */
+export function codexConfigOf(answer) {
+    return rec(rec(answer)?.config);
+}
+/** The file-backed prefs under `<dir>` (default `~/.dsh-tui/backends/codex`). */
+export function fileCodexPrefs(dir = join(DATA_DIR, 'backends', 'codex'), debug = () => undefined) {
+    const path = join(dir, FILE);
+    const read = () => {
+        try {
+            return parse(JSON.parse(readFileSync(path, 'utf8')));
+        }
+        catch {
+            return {};
+        }
+    };
+    const save = (next) => {
+        try {
+            writeFileAtomic(dir, FILE, `${JSON.stringify(next, null, 2)}\n`);
+        }
+        catch (error) {
+            debug(`codex: prefs write failed (${error instanceof Error ? error.message : String(error)})`);
+        }
+    };
+    return {
+        read,
+        write: patch => { save(patched(read(), patch)); },
+        touch: threadId => { save(touched(read(), threadId, Date.now())); },
+        forget: threadId => { save(forgotten(read(), threadId)); },
+    };
+}
+/** An in-memory store (tests). */
+export function memoryCodexPrefs(initial = {}) {
+    let data = { ...initial };
+    return {
+        get data() { return data; },
+        read: () => data,
+        write(patch) { data = patched(data, patch); },
+        touch(threadId) { data = touched(data, threadId, Date.now()); },
+        forget(threadId) { data = forgotten(data, threadId); },
+    };
+}

package/lib/types/backends/codex/protocol/index.d.ts

@@ -0,0 +1,149 @@
+export type { ClientInfo } from './generated/ClientInfo.js';
+export type { ClientNotification } from './generated/ClientNotification.js';
+export type { ClientRequest } from './generated/ClientRequest.js';
+export type { InitializeCapabilities } from './generated/InitializeCapabilities.js';
+export type { InitializeParams } from './generated/InitializeParams.js';
+export type { InitializeResponse } from './generated/InitializeResponse.js';
+export type { RequestId } from './generated/RequestId.js';
+export type { ServerNotification } from './generated/ServerNotification.js';
+export type { ServerRequest } from './generated/ServerRequest.js';
+export type { AccountRateLimitsUpdatedNotification } from './generated/v2/AccountRateLimitsUpdatedNotification.js';
+export type { CommandAction } from './generated/v2/CommandAction.js';
+export type { CommandExecutionApprovalDecision } from './generated/v2/CommandExecutionApprovalDecision.js';
+export type { CommandExecutionRequestApprovalParams } from './generated/v2/CommandExecutionRequestApprovalParams.js';
+export type { CommandExecutionRequestApprovalResponse } from './generated/v2/CommandExecutionRequestApprovalResponse.js';
+export type { ErrorNotification } from './generated/v2/ErrorNotification.js';
+export type { FileChangeApprovalDecision } from './generated/v2/FileChangeApprovalDecision.js';
+export type { FileChangeRequestApprovalParams } from './generated/v2/FileChangeRequestApprovalParams.js';
+export type { FileChangeRequestApprovalResponse } from './generated/v2/FileChangeRequestApprovalResponse.js';
+export type { FileUpdateChange } from './generated/v2/FileUpdateChange.js';
+export type { PermissionsRequestApprovalParams } from './generated/v2/PermissionsRequestApprovalParams.js';
+export type { PermissionsRequestApprovalResponse } from './generated/v2/PermissionsRequestApprovalResponse.js';
+export type { ThreadItem } from './generated/v2/ThreadItem.js';
+export type { ThreadResumeParams } from './generated/v2/ThreadResumeParams.js';
+export type { ThreadResumeResponse } from './generated/v2/ThreadResumeResponse.js';
+export type { ThreadStartParams } from './generated/v2/ThreadStartParams.js';
+export type { ThreadStartResponse } from './generated/v2/ThreadStartResponse.js';
+export type { ThreadTokenUsageUpdatedNotification } from './generated/v2/ThreadTokenUsageUpdatedNotification.js';
+export type { ThreadTurnsListParams } from './generated/v2/ThreadTurnsListParams.js';
+export type { ThreadTurnsListResponse } from './generated/v2/ThreadTurnsListResponse.js';
+export type { ToolRequestUserInputParams } from './generated/v2/ToolRequestUserInputParams.js';
+export type { ToolRequestUserInputResponse } from './generated/v2/ToolRequestUserInputResponse.js';
+export type { Turn } from './generated/v2/Turn.js';
+export type { TurnInterruptParams } from './generated/v2/TurnInterruptParams.js';
+export type { TurnStartParams } from './generated/v2/TurnStartParams.js';
+export type { TurnStartResponse } from './generated/v2/TurnStartResponse.js';
+export type { TurnSteerParams } from './generated/v2/TurnSteerParams.js';
+export type { TurnSteerResponse } from './generated/v2/TurnSteerResponse.js';
+export type { UserInput } from './generated/v2/UserInput.js';
+/** Client → server requests and notifications the backend sends. */
+export declare const CLIENT: {
+    readonly initialize: "initialize";
+    readonly initialized: "initialized";
+    readonly threadStart: "thread/start";
+    readonly threadResume: "thread/resume";
+    readonly threadFork: "thread/fork";
+    readonly threadUnsubscribe: "thread/unsubscribe";
+    readonly threadList: "thread/list";
+    readonly threadLoadedList: "thread/loaded/list";
+    readonly threadRead: "thread/read";
+    readonly threadTurnsList: "thread/turns/list";
+    readonly threadNameSet: "thread/name/set";
+    readonly threadArchive: "thread/archive";
+    readonly threadCompactStart: "thread/compact/start";
+    readonly threadSettingsUpdate: "thread/settings/update";
+    readonly turnStart: "turn/start";
+    readonly turnSteer: "turn/steer";
+    readonly turnInterrupt: "turn/interrupt";
+    readonly modelList: "model/list";
+    readonly collaborationModeList: "collaborationMode/list";
+    readonly permissionProfileList: "permissionProfile/list";
+    readonly reviewStart: "review/start";
+    readonly skillsList: "skills/list";
+    readonly mcpServerStatusList: "mcpServerStatus/list";
+    readonly mcpServerReload: "config/mcpServer/reload";
+    readonly accountRateLimitsRead: "account/rateLimits/read";
+    readonly gitDiffToRemote: "gitDiffToRemote";
+    readonly threadGoalGet: "thread/goal/get";
+    readonly threadGoalSet: "thread/goal/set";
+    readonly threadGoalClear: "thread/goal/clear";
+    readonly backgroundTerminalsList: "thread/backgroundTerminals/list";
+    readonly backgroundTerminalsTerminate: "thread/backgroundTerminals/terminate";
+    readonly configRead: "config/read";
+    readonly accountRead: "account/read";
+    readonly accountLoginStart: "account/login/start";
+    readonly accountLoginCancel: "account/login/cancel";
+};
+/** Server notifications the backend reads. */
+export declare const NOTIFY: {
+    readonly error: "error";
+    readonly threadStarted: "thread/started";
+    readonly threadStatusChanged: "thread/status/changed";
+    readonly threadArchived: "thread/archived";
+    readonly threadDeleted: "thread/deleted";
+    readonly threadClosed: "thread/closed";
+    readonly threadNameUpdated: "thread/name/updated";
+    readonly threadSettingsUpdated: "thread/settings/updated";
+    readonly threadTokenUsageUpdated: "thread/tokenUsage/updated";
+    readonly threadCompacted: "thread/compacted";
+    readonly threadGoalUpdated: "thread/goal/updated";
+    readonly threadGoalCleared: "thread/goal/cleared";
+    readonly turnStarted: "turn/started";
+    readonly turnCompleted: "turn/completed";
+    readonly turnDiffUpdated: "turn/diff/updated";
+    readonly turnPlanUpdated: "turn/plan/updated";
+    readonly hookStarted: "hook/started";
+    readonly hookCompleted: "hook/completed";
+    readonly itemStarted: "item/started";
+    readonly itemCompleted: "item/completed";
+    readonly agentMessageDelta: "item/agentMessage/delta";
+    readonly planDelta: "item/plan/delta";
+    readonly reasoningSummaryTextDelta: "item/reasoning/summaryTextDelta";
+    readonly reasoningSummaryPartAdded: "item/reasoning/summaryPartAdded";
+    readonly reasoningTextDelta: "item/reasoning/textDelta";
+    readonly commandOutputDelta: "item/commandExecution/outputDelta";
+    readonly terminalInteraction: "item/commandExecution/terminalInteraction";
+    readonly mcpToolCallProgress: "item/mcpToolCall/progress";
+    readonly serverRequestResolved: "serverRequest/resolved";
+    readonly autoApprovalReviewStarted: "item/autoApprovalReview/started";
+    readonly autoApprovalReviewCompleted: "item/autoApprovalReview/completed";
+    readonly strictReviewRequired: "autoApprovalReview/strictReviewRequired";
+    readonly accountRateLimitsUpdated: "account/rateLimits/updated";
+    readonly accountUpdated: "account/updated";
+    readonly accountLoginCompleted: "account/login/completed";
+    readonly mcpServerStartupStatusUpdated: "mcpServer/startupStatus/updated";
+    readonly skillsChanged: "skills/changed";
+    readonly modelRerouted: "model/rerouted";
+    readonly modelVerification: "model/verification";
+    readonly warning: "warning";
+    readonly guardianWarning: "guardianWarning";
+    readonly configWarning: "configWarning";
+    readonly deprecationNotice: "deprecationNotice";
+};
+/** Server → client requests the backend answers. */
+export declare const SERVER_REQUEST: {
+    readonly commandApproval: "item/commandExecution/requestApproval";
+    readonly fileChangeApproval: "item/fileChange/requestApproval";
+    readonly permissionsApproval: "item/permissions/requestApproval";
+    readonly userInput: "item/tool/requestUserInput";
+    readonly elicitation: "mcpServer/elicitation/request";
+    readonly dynamicToolCall: "item/tool/call";
+    readonly chatgptAuthTokensRefresh: "account/chatgptAuthTokens/refresh";
+    readonly attestation: "attestation/generate";
+    readonly currentTime: "currentTime/read";
+    readonly legacyApplyPatchApproval: "applyPatchApproval";
+    readonly legacyExecCommandApproval: "execCommandApproval";
+};
+/**
+ * High-rate notifications the backend never reads, suppressed at
+ * `initialize` (`optOutNotificationMethods`): raw response items, file
+ * watches, realtime, fuzzy search, external-agent import, the app list.
+ */
+export declare const OPT_OUT_NOTIFICATIONS: readonly ["rawResponseItem/completed", "rawResponse/completed", "fs/changed", "thread/realtime/started", "thread/realtime/itemAdded", "thread/realtime/item/started", "thread/realtime/item/transcript/delta", "thread/realtime/item/completed", "thread/realtime/transcript/delta", "thread/realtime/transcript/done", "thread/realtime/outputAudio/delta", "thread/realtime/sdp", "thread/realtime/error", "thread/realtime/closed", "fuzzyFileSearch/sessionUpdated", "fuzzyFileSearch/sessionCompleted", "externalAgentConfig/import/progress", "externalAgentConfig/import/completed", "app/list/updated"];
+/** Every name in the tables above (the contract gate's input). */
+export declare const PROTOCOL_NAMES: {
+    readonly client: ("turn/start" | "initialized" | "initialize" | "thread/start" | "thread/resume" | "thread/fork" | "thread/archive" | "thread/unsubscribe" | "thread/name/set" | "thread/goal/set" | "thread/goal/get" | "thread/goal/clear" | "thread/settings/update" | "thread/compact/start" | "thread/backgroundTerminals/list" | "thread/backgroundTerminals/terminate" | "thread/list" | "thread/loaded/list" | "thread/read" | "thread/turns/list" | "skills/list" | "turn/steer" | "turn/interrupt" | "review/start" | "model/list" | "permissionProfile/list" | "collaborationMode/list" | "config/mcpServer/reload" | "mcpServerStatus/list" | "account/login/start" | "account/login/cancel" | "account/rateLimits/read" | "config/read" | "account/read" | "gitDiffToRemote")[];
+    readonly notifications: readonly [...("error" | "warning" | "thread/started" | "thread/status/changed" | "thread/archived" | "thread/deleted" | "thread/closed" | "skills/changed" | "thread/name/updated" | "thread/goal/updated" | "thread/goal/cleared" | "thread/settings/updated" | "thread/tokenUsage/updated" | "turn/started" | "hook/started" | "turn/completed" | "hook/completed" | "turn/diff/updated" | "turn/plan/updated" | "item/started" | "item/autoApprovalReview/started" | "item/autoApprovalReview/completed" | "autoApprovalReview/strictReviewRequired" | "item/completed" | "item/agentMessage/delta" | "item/plan/delta" | "item/commandExecution/outputDelta" | "item/commandExecution/terminalInteraction" | "serverRequest/resolved" | "item/mcpToolCall/progress" | "mcpServer/startupStatus/updated" | "account/updated" | "account/rateLimits/updated" | "item/reasoning/summaryTextDelta" | "item/reasoning/summaryPartAdded" | "item/reasoning/textDelta" | "thread/compacted" | "model/rerouted" | "model/verification" | "guardianWarning" | "deprecationNotice" | "configWarning" | "account/login/completed")[], "rawResponseItem/completed", "rawResponse/completed", "fs/changed", "thread/realtime/started", "thread/realtime/itemAdded", "thread/realtime/item/started", "thread/realtime/item/transcript/delta", "thread/realtime/item/completed", "thread/realtime/transcript/delta", "thread/realtime/transcript/done", "thread/realtime/outputAudio/delta", "thread/realtime/sdp", "thread/realtime/error", "thread/realtime/closed", "fuzzyFileSearch/sessionUpdated", "fuzzyFileSearch/sessionCompleted", "externalAgentConfig/import/progress", "externalAgentConfig/import/completed", "app/list/updated"];
+    readonly serverRequests: ("item/commandExecution/requestApproval" | "item/fileChange/requestApproval" | "item/tool/requestUserInput" | "mcpServer/elicitation/request" | "item/permissions/requestApproval" | "item/tool/call" | "account/chatgptAuthTokens/refresh" | "attestation/generate" | "currentTime/read" | "applyPatchApproval" | "execCommandApproval")[];
+};
+//# sourceMappingURL=index.d.ts.map

package/lib/types/backends/codex/protocol/index.d.ts.map

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

package/lib/types/backends/codex/protocol/index.js

@@ -0,0 +1,130 @@
+/** Client → server requests and notifications the backend sends. */
+export const CLIENT = {
+    initialize: 'initialize',
+    initialized: 'initialized',
+    threadStart: 'thread/start',
+    threadResume: 'thread/resume',
+    threadFork: 'thread/fork',
+    threadUnsubscribe: 'thread/unsubscribe',
+    threadList: 'thread/list',
+    threadLoadedList: 'thread/loaded/list',
+    threadRead: 'thread/read',
+    threadTurnsList: 'thread/turns/list',
+    threadNameSet: 'thread/name/set',
+    threadArchive: 'thread/archive',
+    threadCompactStart: 'thread/compact/start',
+    threadSettingsUpdate: 'thread/settings/update',
+    turnStart: 'turn/start',
+    turnSteer: 'turn/steer',
+    turnInterrupt: 'turn/interrupt',
+    modelList: 'model/list',
+    collaborationModeList: 'collaborationMode/list',
+    permissionProfileList: 'permissionProfile/list',
+    reviewStart: 'review/start',
+    skillsList: 'skills/list',
+    mcpServerStatusList: 'mcpServerStatus/list',
+    mcpServerReload: 'config/mcpServer/reload',
+    accountRateLimitsRead: 'account/rateLimits/read',
+    gitDiffToRemote: 'gitDiffToRemote',
+    threadGoalGet: 'thread/goal/get',
+    threadGoalSet: 'thread/goal/set',
+    threadGoalClear: 'thread/goal/clear',
+    backgroundTerminalsList: 'thread/backgroundTerminals/list',
+    backgroundTerminalsTerminate: 'thread/backgroundTerminals/terminate',
+    configRead: 'config/read',
+    accountRead: 'account/read',
+    accountLoginStart: 'account/login/start',
+    accountLoginCancel: 'account/login/cancel',
+};
+/** Server notifications the backend reads. */
+export const NOTIFY = {
+    error: 'error',
+    threadStarted: 'thread/started',
+    threadStatusChanged: 'thread/status/changed',
+    threadArchived: 'thread/archived',
+    threadDeleted: 'thread/deleted',
+    threadClosed: 'thread/closed',
+    threadNameUpdated: 'thread/name/updated',
+    threadSettingsUpdated: 'thread/settings/updated',
+    threadTokenUsageUpdated: 'thread/tokenUsage/updated',
+    threadCompacted: 'thread/compacted',
+    threadGoalUpdated: 'thread/goal/updated',
+    threadGoalCleared: 'thread/goal/cleared',
+    turnStarted: 'turn/started',
+    turnCompleted: 'turn/completed',
+    turnDiffUpdated: 'turn/diff/updated',
+    turnPlanUpdated: 'turn/plan/updated',
+    hookStarted: 'hook/started',
+    hookCompleted: 'hook/completed',
+    itemStarted: 'item/started',
+    itemCompleted: 'item/completed',
+    agentMessageDelta: 'item/agentMessage/delta',
+    planDelta: 'item/plan/delta',
+    reasoningSummaryTextDelta: 'item/reasoning/summaryTextDelta',
+    reasoningSummaryPartAdded: 'item/reasoning/summaryPartAdded',
+    reasoningTextDelta: 'item/reasoning/textDelta',
+    commandOutputDelta: 'item/commandExecution/outputDelta',
+    terminalInteraction: 'item/commandExecution/terminalInteraction',
+    mcpToolCallProgress: 'item/mcpToolCall/progress',
+    serverRequestResolved: 'serverRequest/resolved',
+    autoApprovalReviewStarted: 'item/autoApprovalReview/started',
+    autoApprovalReviewCompleted: 'item/autoApprovalReview/completed',
+    strictReviewRequired: 'autoApprovalReview/strictReviewRequired',
+    accountRateLimitsUpdated: 'account/rateLimits/updated',
+    accountUpdated: 'account/updated',
+    accountLoginCompleted: 'account/login/completed',
+    mcpServerStartupStatusUpdated: 'mcpServer/startupStatus/updated',
+    skillsChanged: 'skills/changed',
+    modelRerouted: 'model/rerouted',
+    modelVerification: 'model/verification',
+    warning: 'warning',
+    guardianWarning: 'guardianWarning',
+    configWarning: 'configWarning',
+    deprecationNotice: 'deprecationNotice',
+};
+/** Server → client requests the backend answers. */
+export const SERVER_REQUEST = {
+    commandApproval: 'item/commandExecution/requestApproval',
+    fileChangeApproval: 'item/fileChange/requestApproval',
+    permissionsApproval: 'item/permissions/requestApproval',
+    userInput: 'item/tool/requestUserInput',
+    elicitation: 'mcpServer/elicitation/request',
+    dynamicToolCall: 'item/tool/call',
+    chatgptAuthTokensRefresh: 'account/chatgptAuthTokens/refresh',
+    attestation: 'attestation/generate',
+    currentTime: 'currentTime/read',
+    legacyApplyPatchApproval: 'applyPatchApproval',
+    legacyExecCommandApproval: 'execCommandApproval',
+};
+/**
+ * High-rate notifications the backend never reads, suppressed at
+ * `initialize` (`optOutNotificationMethods`): raw response items, file
+ * watches, realtime, fuzzy search, external-agent import, the app list.
+ */
+export const OPT_OUT_NOTIFICATIONS = [
+    'rawResponseItem/completed',
+    'rawResponse/completed',
+    'fs/changed',
+    'thread/realtime/started',
+    'thread/realtime/itemAdded',
+    'thread/realtime/item/started',
+    'thread/realtime/item/transcript/delta',
+    'thread/realtime/item/completed',
+    'thread/realtime/transcript/delta',
+    'thread/realtime/transcript/done',
+    'thread/realtime/outputAudio/delta',
+    'thread/realtime/sdp',
+    'thread/realtime/error',
+    'thread/realtime/closed',
+    'fuzzyFileSearch/sessionUpdated',
+    'fuzzyFileSearch/sessionCompleted',
+    'externalAgentConfig/import/progress',
+    'externalAgentConfig/import/completed',
+    'app/list/updated',
+];
+/** Every name in the tables above (the contract gate's input). */
+export const PROTOCOL_NAMES = {
+    client: Object.values(CLIENT),
+    notifications: [...Object.values(NOTIFY), ...OPT_OUT_NOTIFICATIONS],
+    serverRequests: Object.values(SERVER_REQUEST),
+};

package/lib/types/backends/codex/rpc/binary.d.ts

@@ -0,0 +1,35 @@
+/** Where the executable came from (`/doctor`). */
+export type CodexExecutableSource = 'env' | 'path';
+export interface CodexExecutable {
+    readonly path: string;
+    readonly source: CodexExecutableSource;
+}
+/** Whether a variable is one the child must not inherit. */
+export declare function scrubbedCodexVariable(name: string): boolean;
+/** The app-server child environment. */
+export declare function buildCodexEnv(base?: NodeJS.ProcessEnv, extra?: Readonly<Record<string, string>>): Record<string, string>;
+/** Run `<executable> --version` (bounded); the parsed version or undefined. */
+export declare function readCodexVersion(executable: string, env?: NodeJS.ProcessEnv): Promise<string | undefined>;
+/**
+ * The native binary behind an npm `codex` shim (`codex.cmd`, `codex.ps1`,
+ * the extensionless script), or undefined. A shim runs `node …/@openai/codex/
+ * bin/codex.js`, which locates `vendor/<triple>/bin/codex[.exe]` (older
+ * packages use `codex/` instead of `bin/`) of the
+ * platform package and spawns it; spawning that binary directly avoids
+ * `cmd.exe` re-parsing the `-c key="value"` arguments. Pure over its I/O
+ * seams (unit-tested with a fake tree).
+ */
+export declare function resolveNpmShim(shim: string, io: {
+    readonly platform: string;
+    readonly arch: string;
+    readonly exists: (path: string) => boolean;
+    readonly read: (path: string) => string | undefined;
+}): string | undefined;
+/** The binary to spawn for a resolved path: an npm shim's native binary
+ *  when one is found, else the path itself. */
+export declare function spawnablePath(path: string): string;
+/** Resolve the executable and its version; undefined when none is usable. */
+export declare function resolveCodexExecutable(env?: NodeJS.ProcessEnv): Promise<(CodexExecutable & {
+    readonly version: string | undefined;
+}) | undefined>;
+//# sourceMappingURL=binary.d.ts.map

package/lib/types/backends/codex/rpc/binary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"binary.d.ts","sourceRoot":"","sources":["../../../../../src/backends/codex/rpc/binary.ts"],"names":[],"mappings":"AAoBA,kDAAkD;AAClD,MAAM,MAAM,qBAAqB,GAAG,KAAK,GAAG,MAAM,CAAA;AAElD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,MAAM,EAAE,qBAAqB,CAAA;CACvC;AAiBD,4DAA4D;AAC5D,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAG3D;AAED,wCAAwC;AACxC,wBAAgB,aAAa,CAAC,IAAI,GAAE,MAAM,CAAC,UAAwB,EAAE,KAAK,GAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAOzI;AAED,+EAA+E;AAC/E,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAgBtH;AAaD;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE;IAC/C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAA;IAC1C,QAAQ,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAA;CACpD,GAAG,MAAM,GAAG,SAAS,CAwBrB;AAED;+CAC+C;AAC/C,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CASlD;AAiBD,6EAA6E;AAC7E,wBAAsB,sBAAsB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,OAAO,CAAC,CAAC,eAAe,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC,GAAG,SAAS,CAAC,CAkBpK"}