@excitedjs/tm 1.1.0

package/src/cli/parse.ts

@@ -0,0 +1,265 @@
+import { existsSync, realpathSync, statSync } from 'node:fs'
+import { basename, isAbsolute, join, resolve } from 'node:path'
+
+import { isNonNegativeInteger } from '../engines/claude/clock'
+import { randSuffix } from '../engines/claude/identifiers'
+import { readBaseRecord, readCodexMeta } from '../engines/codex/persistence'
+import { worktreePathFor } from '../persistence/paths'
+import {
+  read as readIdentity,
+  readArchived as readArchivedIdentity,
+  readRawSchema,
+} from '../persistence/identity-store'
+import type { EngineKind } from '../engines/types'
+import type { NativeEnv } from '../env'
+import { validateTeammateName } from '../identity/name'
+import type { TmResult } from '../tm'
+import { die } from './errors'
+
+/**
+ * Whether `tm`'s help pre-scan would intercept these verb arguments.
+ * The scan walks left to right: a `-h`/`--help` triggers help; a
+ * `--prompt` value or the first non-flag positional stops it (help
+ * text must not swallow prompt data that happens to contain `--help`).
+ *
+ * Exported because `main.ts` needs it too: a verb that reads stdin
+ * (only `archive`) must not slurp stdin when the invocation is going
+ * to print help, since the help dispatch never reaches the reader and
+ * a pipe held open by an upstream producer would block the launcher
+ * forever.
+ */
+export function triggersHelp(args: readonly string[]): boolean {
+  for (const arg of args) {
+    if (arg === '-h' || arg === '--help') return true
+    if (arg === '--prompt' || arg.startsWith('--prompt=')) return false
+    if (!arg.startsWith('-')) return false
+  }
+  return false
+}
+
+function isDirectory(path: string): boolean {
+  try {
+    return statSync(path).isDirectory()
+  } catch {
+    return false
+  }
+}
+
+function secondsToMs(value: string | null): number | null {
+  return value === null ? null : Number(value) * 1000
+}
+
+export function parseTimeoutMs(
+  label: string,
+  value: string | null,
+): number | null | { error: TmResult } {
+  if (value === null) return null
+  if (!isNonNegativeInteger(value)) {
+    return { error: die(`${label}: --timeout must be a non-negative integer (got: '${value}')`) }
+  }
+  return secondsToMs(value)
+}
+
+export function codexNameFailure(name: string): string | null {
+  const validation = validateTeammateName(name)
+  return validation.kind === 'ok'
+    ? null
+    : `invalid codex teammate name '${name}': ${validation.reason}`
+}
+
+export async function inferSpawnEngine(
+  requested: EngineKind | null,
+): Promise<EngineKind> {
+  if (requested !== null) return requested
+  // Schema-2 default: no name-based pre-routing — Claude unless --engine codex.
+  // (Resume probes engines explicitly via verbs/resume.ts.)
+  return 'claude'
+}
+
+/**
+ * Resolve a CLI `<path>` positional into an absolute repo path. An
+ * absolute path is taken as-is; a relative path is resolved against
+ * the dispatcher dir. `realpathSync` collapses symlinks so the
+ * recorded `repo` matches what the SessionStart hook will report.
+ */
+export function resolveRepoPath(
+  rawPath: string,
+  env: NativeEnv,
+): { repo: string } | { error: TmResult } {
+  if (rawPath.length === 0) {
+    return { error: die('tm spawn: <path> is required') }
+  }
+  const absolute = isAbsolute(rawPath) ? rawPath : resolve(env.dispatcherDir, rawPath)
+  if (!existsSync(absolute)) {
+    return {
+      error: die(
+        `tm spawn: <path> '${rawPath}' does not exist (resolved to ${absolute})`,
+      ),
+    }
+  }
+  if (!isDirectory(absolute)) {
+    return {
+      error: die(`tm spawn: <path> '${rawPath}' is not a directory (resolved to ${absolute})`),
+    }
+  }
+  return { repo: realpathSync(absolute) }
+}
+
+/**
+ * Generate a default teammate name from a resolved repo path. The
+ * shape is `<leaf>-<rand4>`, where `<leaf>` is `path.basename(repo)`
+ * sanitized to ASCII alnum + `-` / `_`. The trailing `-<rand4>`
+ * ensures a fresh spawn never collides with a prior teammate of the
+ * same leaf even when the user does not pass `--name`.
+ */
+export function autoGenerateName(repo: string): string {
+  const raw = basename(repo)
+  // Drop anything outside the flat-name charset; collapse runs of `-`.
+  let leaf = raw.replace(/[^A-Za-z0-9_-]+/g, '-').replace(/^-+|-+$/g, '')
+  if (leaf.length === 0) leaf = 'tm'
+  // Make sure the result starts with an alnum — the validator rejects
+  // leading `-` / `_`. A sanitized leaf may start with `-` if the
+  // basename was `_foo` or `-foo`; trim until alnum.
+  while (leaf.length > 0 && !/^[A-Za-z0-9]/.test(leaf)) leaf = leaf.slice(1)
+  if (leaf.length === 0) leaf = 'tm'
+  return `${leaf}-${randSuffix()}`
+}
+
+/**
+ * The runtime cwd for a spawn. Worktree mode places the teammate in
+ * `<repo>/.claude/worktrees/<slug>`; `--no-worktree` keeps it at the
+ * repo root.
+ */
+export function spawnCwdFor(
+  repo: string,
+  worktreeSlug: string | null,
+): string {
+  return worktreeSlug === null ? repo : worktreePathFor(repo, worktreeSlug)
+}
+
+/**
+ * Detect a stale schema=1 identity record. Returns a `TmResult`
+ * error that the spawn / send / wait / kill / etc dispatchers can
+ * surface verbatim so the user sees a clear "kill and respawn"
+ * migration hint instead of a silent not-found.
+ */
+export function legacySchemaError(name: string, verb: string): TmResult | null {
+  const schema = readRawSchema(name)
+  if (schema === null) return null
+  if (schema === 2) return null
+  return die(
+    `tm ${verb}: teammate '${name}' has a legacy schema=${schema} identity ` +
+      "record (pre name/repo decoupling). Kill and respawn: " +
+      `'tm kill ${name}' then 'tm spawn <path> --name ${name}'.`,
+  )
+}
+
+function normalizeExistingCwd(cwd: string): string {
+  try {
+    return realpathSync(cwd)
+  } catch {
+    return cwd
+  }
+}
+
+/**
+ * Resolve the runtime cwd for a verb that targets an existing
+ * teammate by name. Reads, in order:
+ *
+ *  1. the live identity record (running or just-spawned teammate);
+ *  2. the archived identity record written at `tm kill` time — so a
+ *     post-kill `tm resume <name> <sid>` or `tm history <name>` lands
+ *     on the worktree-encoded project-dir slug rather than the
+ *     dispatcher's slug;
+ *  3. the Codex registry's cwd hint (Codex daemon meta + base record);
+ *  4. a `<dispatcherDir>/<name>` probe — the shape `tm resume`
+ *     accepts when the source directory lives under the dispatcher;
+ *  5. the dispatcher dir itself, as the last-resort fallback.
+ *
+ * The fallback is **never** `process.cwd()`: a `tm` invocation that
+ * lands here typically runs from somewhere unrelated to the
+ * teammate's repo (vitest runs from the package dir, a dispatcher
+ * may run from a parent), and a `process.cwd()` fallback leaks
+ * the caller's absolute path into resume / history error
+ * messages — which the conformance harness then bakes into goldens.
+ */
+export function cwdForName(name: string, env: NativeEnv): string {
+  const identity = readIdentity(name)
+  if (identity !== null) return normalizeExistingCwd(identity.cwd)
+  const archived = readArchivedIdentity(name)
+  if (archived !== null) return normalizeExistingCwd(archived.cwd)
+  const codexMetaCwd = readCodexMeta(name)?.cwd
+  if (codexMetaCwd !== undefined) return normalizeExistingCwd(codexMetaCwd)
+  const codexBaseCwd = readBaseRecord(name)?.cwd
+  if (codexBaseCwd !== undefined) return normalizeExistingCwd(codexBaseCwd)
+  const dispatcherChild = join(env.dispatcherDir, name)
+  if (isDirectory(dispatcherChild)) return normalizeExistingCwd(dispatcherChild)
+  return normalizeExistingCwd(env.dispatcherDir)
+}
+
+/** Whether `tm resume` can probe a teammate's cwd for resumable history. */
+export function resumeCwdProbeable(name: string, env: NativeEnv): boolean {
+  if (readIdentity(name) !== null) return true
+  if (readArchivedIdentity(name) !== null) return true
+  if (readBaseRecord(name) !== null) return true
+  if (readCodexMeta(name) !== null) return true
+  const dispatcherChild = join(env.dispatcherDir, name)
+  return isDirectory(dispatcherChild)
+}
+
+export type CtxWindowOverride = '' | '200k' | '1m'
+export type CtxArgs =
+  | { repos: string[]; windowOverride: CtxWindowOverride; all: boolean }
+  | { error: TmResult }
+
+export function parseCtxArgs(args: readonly string[]): CtxArgs {
+  const repos: string[] = []
+  let windowOverride: CtxWindowOverride | string = ''
+  let all = false
+  for (let i = 0; i < args.length; i++) {
+    const arg = args[i]!
+    if (arg === '--all') {
+      all = true
+    } else if (arg === '--window') {
+      if (i + 1 >= args.length) return { error: { code: 1, stdout: '', stderr: '' } }
+      windowOverride = args[i + 1]!
+      i++
+    } else if (arg.startsWith('--window=')) {
+      windowOverride = arg.slice('--window='.length)
+    } else if (arg.startsWith('-')) {
+      return { error: die(`tm ctx: unknown flag: ${arg}`) }
+    } else {
+      repos.push(arg)
+    }
+  }
+  if (windowOverride !== '' && windowOverride !== '200k' && windowOverride !== '1m') {
+    return { error: die('tm ctx: --window must be 200k or 1m') }
+  }
+  return { repos, windowOverride: windowOverride as CtxWindowOverride, all }
+}
+
+export type ReloadArgs =
+  | { readonly all: boolean; readonly repos: readonly string[] }
+  | { readonly error: TmResult }
+
+export function parseReloadTargets(rest: readonly string[]): ReloadArgs {
+  let all = false
+  const repos: string[] = []
+  for (const arg of rest) {
+    if (arg === '--all') all = true
+    else if (arg === '-h' || arg === '--help') {
+      return { error: die('usage: tm reload <name>... | --all') }
+    } else if (arg.startsWith('-')) {
+      return { error: die(`tm reload: unknown flag: ${arg}`) }
+    } else {
+      repos.push(arg)
+    }
+  }
+
+  if (all) {
+    if (repos.length > 0) return { error: die('tm reload: --all conflicts with explicit names') }
+  } else if (repos.length === 0) {
+    return { error: die('usage: tm reload <name>... | --all') }
+  }
+  return { all, repos }
+}

package/src/cli.ts

@@ -0,0 +1,12 @@
+/**
+ * Public CLI library surface.
+ *
+ * The implementation lives under `cli/`: `dispatch.ts` owns verb routing,
+ * `parse.ts` owns shared CLI argument parsing, `errors.ts` owns TmResult
+ * error/help shapes, and `context.ts` owns production backend wiring.
+ * This file stays as the stable import path for `main.ts` and tests.
+ */
+
+export { productionEnv } from './cli/context'
+export { runCli } from './cli/dispatch'
+export { triggersHelp } from './cli/parse'

package/src/codex-protocol/AbsolutePathBuf.ts

@@ -0,0 +1,14 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+/**
+ * A path that is guaranteed to be absolute and normalized (though it is not
+ * guaranteed to be canonicalized or exist on the filesystem).
+ *
+ * IMPORTANT: When deserializing an `AbsolutePathBuf`, a base path must be set
+ * using [AbsolutePathBufGuard::new]. If no base path is set, the
+ * deserialization will fail unless the path being deserialized is already
+ * absolute.
+ */
+export type AbsolutePathBuf = string;

package/src/codex-protocol/AgentPath.ts

@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type AgentPath = string;

package/src/codex-protocol/ApplyPatchApprovalParams.ts

@@ -0,0 +1,21 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { FileChange } from "./FileChange";
+import type { ThreadId } from "./ThreadId";
+
+export type ApplyPatchApprovalParams = { conversationId: ThreadId,
+/**
+ * Use to correlate this with [codex_protocol::protocol::PatchApplyBeginEvent]
+ * and [codex_protocol::protocol::PatchApplyEndEvent].
+ */
+callId: string, fileChanges: { [key in string]?: FileChange },
+/**
+ * Optional explanatory reason (e.g. request for extra write access).
+ */
+reason: string | null,
+/**
+ * When set, the agent is asking the user to allow writes under this root
+ * for the remainder of the session (unclear if this is honored today).
+ */
+grantRoot: string | null, };

package/src/codex-protocol/ApplyPatchApprovalResponse.ts

@@ -0,0 +1,6 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { ReviewDecision } from "./ReviewDecision";
+
+export type ApplyPatchApprovalResponse = { decision: ReviewDecision, };

package/src/codex-protocol/AuthMode.ts

@@ -0,0 +1,8 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+/**
+ * Authentication mode for OpenAI-backed providers.
+ */
+export type AuthMode = "apikey" | "chatgpt" | "chatgptAuthTokens" | "agentIdentity";

package/src/codex-protocol/AutoCompactTokenLimitScope.ts

@@ -0,0 +1,9 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+/**
+ * Selects which part of the active context is charged against
+ * `model_auto_compact_token_limit`.
+ */
+export type AutoCompactTokenLimitScope = "total" | "body_after_prefix";

package/src/codex-protocol/ClientInfo.ts

@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type ClientInfo = { name: string, title: string | null, version: string, };

package/src/codex-protocol/ClientNotification.ts

@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type ClientNotification = { "method": "initialized" };

package/src/codex-protocol/ClientRequest.ts

@@ -0,0 +1,110 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { FuzzyFileSearchParams } from "./FuzzyFileSearchParams";
+import type { FuzzyFileSearchSessionStartParams } from "./FuzzyFileSearchSessionStartParams";
+import type { FuzzyFileSearchSessionStopParams } from "./FuzzyFileSearchSessionStopParams";
+import type { FuzzyFileSearchSessionUpdateParams } from "./FuzzyFileSearchSessionUpdateParams";
+import type { GetAuthStatusParams } from "./GetAuthStatusParams";
+import type { GetConversationSummaryParams } from "./GetConversationSummaryParams";
+import type { GitDiffToRemoteParams } from "./GitDiffToRemoteParams";
+import type { InitializeParams } from "./InitializeParams";
+import type { RequestId } from "./RequestId";
+import type { AppsListParams } from "./v2/AppsListParams";
+import type { CancelLoginAccountParams } from "./v2/CancelLoginAccountParams";
+import type { CollaborationModeListParams } from "./v2/CollaborationModeListParams";
+import type { CommandExecParams } from "./v2/CommandExecParams";
+import type { CommandExecResizeParams } from "./v2/CommandExecResizeParams";
+import type { CommandExecTerminateParams } from "./v2/CommandExecTerminateParams";
+import type { CommandExecWriteParams } from "./v2/CommandExecWriteParams";
+import type { ConfigBatchWriteParams } from "./v2/ConfigBatchWriteParams";
+import type { ConfigReadParams } from "./v2/ConfigReadParams";
+import type { ConfigValueWriteParams } from "./v2/ConfigValueWriteParams";
+import type { EnvironmentAddParams } from "./v2/EnvironmentAddParams";
+import type { ExperimentalFeatureEnablementSetParams } from "./v2/ExperimentalFeatureEnablementSetParams";
+import type { ExperimentalFeatureListParams } from "./v2/ExperimentalFeatureListParams";
+import type { ExternalAgentConfigDetectParams } from "./v2/ExternalAgentConfigDetectParams";
+import type { ExternalAgentConfigImportParams } from "./v2/ExternalAgentConfigImportParams";
+import type { FeedbackUploadParams } from "./v2/FeedbackUploadParams";
+import type { FsCopyParams } from "./v2/FsCopyParams";
+import type { FsCreateDirectoryParams } from "./v2/FsCreateDirectoryParams";
+import type { FsGetMetadataParams } from "./v2/FsGetMetadataParams";
+import type { FsReadDirectoryParams } from "./v2/FsReadDirectoryParams";
+import type { FsReadFileParams } from "./v2/FsReadFileParams";
+import type { FsRemoveParams } from "./v2/FsRemoveParams";
+import type { FsUnwatchParams } from "./v2/FsUnwatchParams";
+import type { FsWatchParams } from "./v2/FsWatchParams";
+import type { FsWriteFileParams } from "./v2/FsWriteFileParams";
+import type { GetAccountParams } from "./v2/GetAccountParams";
+import type { HooksListParams } from "./v2/HooksListParams";
+import type { ListMcpServerStatusParams } from "./v2/ListMcpServerStatusParams";
+import type { LoginAccountParams } from "./v2/LoginAccountParams";
+import type { MarketplaceAddParams } from "./v2/MarketplaceAddParams";
+import type { MarketplaceRemoveParams } from "./v2/MarketplaceRemoveParams";
+import type { MarketplaceUpgradeParams } from "./v2/MarketplaceUpgradeParams";
+import type { McpResourceReadParams } from "./v2/McpResourceReadParams";
+import type { McpServerOauthLoginParams } from "./v2/McpServerOauthLoginParams";
+import type { McpServerToolCallParams } from "./v2/McpServerToolCallParams";
+import type { MockExperimentalMethodParams } from "./v2/MockExperimentalMethodParams";
+import type { ModelListParams } from "./v2/ModelListParams";
+import type { ModelProviderCapabilitiesReadParams } from "./v2/ModelProviderCapabilitiesReadParams";
+import type { PermissionProfileListParams } from "./v2/PermissionProfileListParams";
+import type { PluginInstallParams } from "./v2/PluginInstallParams";
+import type { PluginInstalledParams } from "./v2/PluginInstalledParams";
+import type { PluginListParams } from "./v2/PluginListParams";
+import type { PluginReadParams } from "./v2/PluginReadParams";
+import type { PluginShareCheckoutParams } from "./v2/PluginShareCheckoutParams";
+import type { PluginShareDeleteParams } from "./v2/PluginShareDeleteParams";
+import type { PluginShareListParams } from "./v2/PluginShareListParams";
+import type { PluginShareSaveParams } from "./v2/PluginShareSaveParams";
+import type { PluginShareUpdateTargetsParams } from "./v2/PluginShareUpdateTargetsParams";
+import type { PluginSkillReadParams } from "./v2/PluginSkillReadParams";
+import type { PluginUninstallParams } from "./v2/PluginUninstallParams";
+import type { ProcessKillParams } from "./v2/ProcessKillParams";
+import type { ProcessResizePtyParams } from "./v2/ProcessResizePtyParams";
+import type { ProcessSpawnParams } from "./v2/ProcessSpawnParams";
+import type { ProcessWriteStdinParams } from "./v2/ProcessWriteStdinParams";
+import type { ReviewStartParams } from "./v2/ReviewStartParams";
+import type { SendAddCreditsNudgeEmailParams } from "./v2/SendAddCreditsNudgeEmailParams";
+import type { SkillsConfigWriteParams } from "./v2/SkillsConfigWriteParams";
+import type { SkillsListParams } from "./v2/SkillsListParams";
+import type { ThreadApproveGuardianDeniedActionParams } from "./v2/ThreadApproveGuardianDeniedActionParams";
+import type { ThreadArchiveParams } from "./v2/ThreadArchiveParams";
+import type { ThreadBackgroundTerminalsCleanParams } from "./v2/ThreadBackgroundTerminalsCleanParams";
+import type { ThreadCompactStartParams } from "./v2/ThreadCompactStartParams";
+import type { ThreadDecrementElicitationParams } from "./v2/ThreadDecrementElicitationParams";
+import type { ThreadForkParams } from "./v2/ThreadForkParams";
+import type { ThreadGoalClearParams } from "./v2/ThreadGoalClearParams";
+import type { ThreadGoalGetParams } from "./v2/ThreadGoalGetParams";
+import type { ThreadGoalSetParams } from "./v2/ThreadGoalSetParams";
+import type { ThreadIncrementElicitationParams } from "./v2/ThreadIncrementElicitationParams";
+import type { ThreadInjectItemsParams } from "./v2/ThreadInjectItemsParams";
+import type { ThreadListParams } from "./v2/ThreadListParams";
+import type { ThreadLoadedListParams } from "./v2/ThreadLoadedListParams";
+import type { ThreadMemoryModeSetParams } from "./v2/ThreadMemoryModeSetParams";
+import type { ThreadMetadataUpdateParams } from "./v2/ThreadMetadataUpdateParams";
+import type { ThreadReadParams } from "./v2/ThreadReadParams";
+import type { ThreadRealtimeAppendAudioParams } from "./v2/ThreadRealtimeAppendAudioParams";
+import type { ThreadRealtimeAppendTextParams } from "./v2/ThreadRealtimeAppendTextParams";
+import type { ThreadRealtimeListVoicesParams } from "./v2/ThreadRealtimeListVoicesParams";
+import type { ThreadRealtimeStartParams } from "./v2/ThreadRealtimeStartParams";
+import type { ThreadRealtimeStopParams } from "./v2/ThreadRealtimeStopParams";
+import type { ThreadResumeParams } from "./v2/ThreadResumeParams";
+import type { ThreadRollbackParams } from "./v2/ThreadRollbackParams";
+import type { ThreadSetNameParams } from "./v2/ThreadSetNameParams";
+import type { ThreadSettingsUpdateParams } from "./v2/ThreadSettingsUpdateParams";
+import type { ThreadShellCommandParams } from "./v2/ThreadShellCommandParams";
+import type { ThreadStartParams } from "./v2/ThreadStartParams";
+import type { ThreadTurnsItemsListParams } from "./v2/ThreadTurnsItemsListParams";
+import type { ThreadTurnsListParams } from "./v2/ThreadTurnsListParams";
+import type { ThreadUnarchiveParams } from "./v2/ThreadUnarchiveParams";
+import type { ThreadUnsubscribeParams } from "./v2/ThreadUnsubscribeParams";
+import type { TurnInterruptParams } from "./v2/TurnInterruptParams";
+import type { TurnStartParams } from "./v2/TurnStartParams";
+import type { TurnSteerParams } from "./v2/TurnSteerParams";
+import type { WindowsSandboxSetupStartParams } from "./v2/WindowsSandboxSetupStartParams";
+
+/**
+ * Request from the client to the server.
+ */
+export type ClientRequest = { "method": "initialize", id: RequestId, params: InitializeParams, } | { "method": "thread/start", id: RequestId, params: ThreadStartParams, } | { "method": "thread/resume", id: RequestId, params: ThreadResumeParams, } | { "method": "thread/fork", id: RequestId, params: ThreadForkParams, } | { "method": "thread/archive", id: RequestId, params: ThreadArchiveParams, } | { "method": "thread/unsubscribe", id: RequestId, params: ThreadUnsubscribeParams, } | { "method": "thread/increment_elicitation", id: RequestId, params: ThreadIncrementElicitationParams, } | { "method": "thread/decrement_elicitation", id: RequestId, params: ThreadDecrementElicitationParams, } | { "method": "thread/name/set", id: RequestId, params: ThreadSetNameParams, } | { "method": "thread/goal/set", id: RequestId, params: ThreadGoalSetParams, } | { "method": "thread/goal/get", id: RequestId, params: ThreadGoalGetParams, } | { "method": "thread/goal/clear", id: RequestId, params: ThreadGoalClearParams, } | { "method": "thread/metadata/update", id: RequestId, params: ThreadMetadataUpdateParams, } | { "method": "thread/settings/update", id: RequestId, params: ThreadSettingsUpdateParams, } | { "method": "thread/memoryMode/set", id: RequestId, params: ThreadMemoryModeSetParams, } | { "method": "memory/reset", id: RequestId, params: undefined, } | { "method": "thread/unarchive", id: RequestId, params: ThreadUnarchiveParams, } | { "method": "thread/compact/start", id: RequestId, params: ThreadCompactStartParams, } | { "method": "thread/shellCommand", id: RequestId, params: ThreadShellCommandParams, } | { "method": "thread/approveGuardianDeniedAction", id: RequestId, params: ThreadApproveGuardianDeniedActionParams, } | { "method": "thread/backgroundTerminals/clean", id: RequestId, params: ThreadBackgroundTerminalsCleanParams, } | { "method": "thread/rollback", id: RequestId, params: ThreadRollbackParams, } | { "method": "thread/list", id: RequestId, params: ThreadListParams, } | { "method": "thread/loaded/list", id: RequestId, params: ThreadLoadedListParams, } | { "method": "thread/read", id: RequestId, params: ThreadReadParams, } | { "method": "thread/turns/list", id: RequestId, params: ThreadTurnsListParams, } | { "method": "thread/turns/items/list", id: RequestId, params: ThreadTurnsItemsListParams, } | { "method": "thread/inject_items", id: RequestId, params: ThreadInjectItemsParams, } | { "method": "skills/list", id: RequestId, params: SkillsListParams, } | { "method": "hooks/list", id: RequestId, params: HooksListParams, } | { "method": "marketplace/add", id: RequestId, params: MarketplaceAddParams, } | { "method": "marketplace/remove", id: RequestId, params: MarketplaceRemoveParams, } | { "method": "marketplace/upgrade", id: RequestId, params: MarketplaceUpgradeParams, } | { "method": "plugin/list", id: RequestId, params: PluginListParams, } | { "method": "plugin/installed", id: RequestId, params: PluginInstalledParams, } | { "method": "plugin/read", id: RequestId, params: PluginReadParams, } | { "method": "plugin/skill/read", id: RequestId, params: PluginSkillReadParams, } | { "method": "plugin/share/save", id: RequestId, params: PluginShareSaveParams, } | { "method": "plugin/share/updateTargets", id: RequestId, params: PluginShareUpdateTargetsParams, } | { "method": "plugin/share/list", id: RequestId, params: PluginShareListParams, } | { "method": "plugin/share/checkout", id: RequestId, params: PluginShareCheckoutParams, } | { "method": "plugin/share/delete", id: RequestId, params: PluginShareDeleteParams, } | { "method": "app/list", id: RequestId, params: AppsListParams, } | { "method": "fs/readFile", id: RequestId, params: FsReadFileParams, } | { "method": "fs/writeFile", id: RequestId, params: FsWriteFileParams, } | { "method": "fs/createDirectory", id: RequestId, params: FsCreateDirectoryParams, } | { "method": "fs/getMetadata", id: RequestId, params: FsGetMetadataParams, } | { "method": "fs/readDirectory", id: RequestId, params: FsReadDirectoryParams, } | { "method": "fs/remove", id: RequestId, params: FsRemoveParams, } | { "method": "fs/copy", id: RequestId, params: FsCopyParams, } | { "method": "fs/watch", id: RequestId, params: FsWatchParams, } | { "method": "fs/unwatch", id: RequestId, params: FsUnwatchParams, } | { "method": "skills/config/write", id: RequestId, params: SkillsConfigWriteParams, } | { "method": "plugin/install", id: RequestId, params: PluginInstallParams, } | { "method": "plugin/uninstall", id: RequestId, params: PluginUninstallParams, } | { "method": "turn/start", id: RequestId, params: TurnStartParams, } | { "method": "turn/steer", id: RequestId, params: TurnSteerParams, } | { "method": "turn/interrupt", id: RequestId, params: TurnInterruptParams, } | { "method": "thread/realtime/start", id: RequestId, params: ThreadRealtimeStartParams, } | { "method": "thread/realtime/appendAudio", id: RequestId, params: ThreadRealtimeAppendAudioParams, } | { "method": "thread/realtime/appendText", id: RequestId, params: ThreadRealtimeAppendTextParams, } | { "method": "thread/realtime/stop", id: RequestId, params: ThreadRealtimeStopParams, } | { "method": "thread/realtime/listVoices", id: RequestId, params: ThreadRealtimeListVoicesParams, } | { "method": "review/start", id: RequestId, params: ReviewStartParams, } | { "method": "model/list", id: RequestId, params: ModelListParams, } | { "method": "modelProvider/capabilities/read", id: RequestId, params: ModelProviderCapabilitiesReadParams, } | { "method": "experimentalFeature/list", id: RequestId, params: ExperimentalFeatureListParams, } | { "method": "permissionProfile/list", id: RequestId, params: PermissionProfileListParams, } | { "method": "experimentalFeature/enablement/set", id: RequestId, params: ExperimentalFeatureEnablementSetParams, } | { "method": "remoteControl/enable", id: RequestId, params: undefined, } | { "method": "remoteControl/disable", id: RequestId, params: undefined, } | { "method": "remoteControl/status/read", id: RequestId, params: undefined, } | { "method": "collaborationMode/list", id: RequestId, params: CollaborationModeListParams, } | { "method": "mock/experimentalMethod", id: RequestId, params: MockExperimentalMethodParams, } | { "method": "environment/add", id: RequestId, params: EnvironmentAddParams, } | { "method": "mcpServer/oauth/login", id: RequestId, params: McpServerOauthLoginParams, } | { "method": "config/mcpServer/reload", id: RequestId, params: undefined, } | { "method": "mcpServerStatus/list", id: RequestId, params: ListMcpServerStatusParams, } | { "method": "mcpServer/resource/read", id: RequestId, params: McpResourceReadParams, } | { "method": "mcpServer/tool/call", id: RequestId, params: McpServerToolCallParams, } | { "method": "windowsSandbox/setupStart", id: RequestId, params: WindowsSandboxSetupStartParams, } | { "method": "windowsSandbox/readiness", id: RequestId, params: undefined, } | { "method": "account/login/start", id: RequestId, params: LoginAccountParams, } | { "method": "account/login/cancel", id: RequestId, params: CancelLoginAccountParams, } | { "method": "account/logout", id: RequestId, params: undefined, } | { "method": "account/rateLimits/read", id: RequestId, params: undefined, } | { "method": "account/sendAddCreditsNudgeEmail", id: RequestId, params: SendAddCreditsNudgeEmailParams, } | { "method": "feedback/upload", id: RequestId, params: FeedbackUploadParams, } | { "method": "command/exec", id: RequestId, params: CommandExecParams, } | { "method": "command/exec/write", id: RequestId, params: CommandExecWriteParams, } | { "method": "command/exec/terminate", id: RequestId, params: CommandExecTerminateParams, } | { "method": "command/exec/resize", id: RequestId, params: CommandExecResizeParams, } | { "method": "process/spawn", id: RequestId, params: ProcessSpawnParams, } | { "method": "process/writeStdin", id: RequestId, params: ProcessWriteStdinParams, } | { "method": "process/kill", id: RequestId, params: ProcessKillParams, } | { "method": "process/resizePty", id: RequestId, params: ProcessResizePtyParams, } | { "method": "config/read", id: RequestId, params: ConfigReadParams, } | { "method": "externalAgentConfig/detect", id: RequestId, params: ExternalAgentConfigDetectParams, } | { "method": "externalAgentConfig/import", id: RequestId, params: ExternalAgentConfigImportParams, } | { "method": "config/value/write", id: RequestId, params: ConfigValueWriteParams, } | { "method": "config/batchWrite", id: RequestId, params: ConfigBatchWriteParams, } | { "method": "configRequirements/read", id: RequestId, params: undefined, } | { "method": "account/read", id: RequestId, params: GetAccountParams, } | { "method": "getConversationSummary", id: RequestId, params: GetConversationSummaryParams, } | { "method": "gitDiffToRemote", id: RequestId, params: GitDiffToRemoteParams, } | { "method": "getAuthStatus", id: RequestId, params: GetAuthStatusParams, } | { "method": "fuzzyFileSearch", id: RequestId, params: FuzzyFileSearchParams, } | { "method": "fuzzyFileSearch/sessionStart", id: RequestId, params: FuzzyFileSearchSessionStartParams, } | { "method": "fuzzyFileSearch/sessionUpdate", id: RequestId, params: FuzzyFileSearchSessionUpdateParams, } | { "method": "fuzzyFileSearch/sessionStop", id: RequestId, params: FuzzyFileSearchSessionStopParams, };

package/src/codex-protocol/CollaborationMode.ts

@@ -0,0 +1,10 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { ModeKind } from "./ModeKind";
+import type { Settings } from "./Settings";
+
+/**
+ * Collaboration mode for a Codex session.
+ */
+export type CollaborationMode = { mode: ModeKind, settings: Settings, };

package/src/codex-protocol/ContentItem.ts

@@ -0,0 +1,6 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { ImageDetail } from "./ImageDetail";
+
+export type ContentItem = { "type": "input_text", text: string, } | { "type": "input_image", image_url: string, detail?: ImageDetail, } | { "type": "output_text", text: string, };

package/src/codex-protocol/ConversationGitInfo.ts

@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type ConversationGitInfo = { sha: string | null, branch: string | null, origin_url: string | null, };

package/src/codex-protocol/ConversationSummary.ts

@@ -0,0 +1,8 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { ConversationGitInfo } from "./ConversationGitInfo";
+import type { SessionSource } from "./SessionSource";
+import type { ThreadId } from "./ThreadId";
+
+export type ConversationSummary = { conversationId: ThreadId, path: string, preview: string, timestamp: string | null, updatedAt: string | null, modelProvider: string, cwd: string, cliVersion: string, source: SessionSource, gitInfo: ConversationGitInfo | null, };

package/src/codex-protocol/ExecCommandApprovalParams.ts

@@ -0,0 +1,16 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { ParsedCommand } from "./ParsedCommand";
+import type { ThreadId } from "./ThreadId";
+
+export type ExecCommandApprovalParams = { conversationId: ThreadId,
+/**
+ * Use to correlate this with [codex_protocol::protocol::ExecCommandBeginEvent]
+ * and [codex_protocol::protocol::ExecCommandEndEvent].
+ */
+callId: string,
+/**
+ * Identifier for this specific approval callback.
+ */
+approvalId: string | null, command: Array<string>, cwd: string, reason: string | null, parsedCmd: Array<ParsedCommand>, };

package/src/codex-protocol/ExecCommandApprovalResponse.ts

@@ -0,0 +1,6 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { ReviewDecision } from "./ReviewDecision";
+
+export type ExecCommandApprovalResponse = { decision: ReviewDecision, };

package/src/codex-protocol/ExecPolicyAmendment.ts

@@ -0,0 +1,12 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+/**
+ * Proposed execpolicy change to allow commands starting with this prefix.
+ *
+ * The `command` tokens form the prefix that would be added as an execpolicy
+ * `prefix_rule(..., decision="allow")`, letting the agent bypass approval for
+ * commands that start with this token sequence.
+ */
+export type ExecPolicyAmendment = Array<string>;

package/src/codex-protocol/FileChange.ts

@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type FileChange = { "type": "add", content: string, } | { "type": "delete", content: string, } | { "type": "update", unified_diff: string, move_path: string | null, };

package/src/codex-protocol/ForcedLoginMethod.ts

@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type ForcedLoginMethod = "chatgpt" | "api";

package/src/codex-protocol/FunctionCallOutputBody.ts

@@ -0,0 +1,6 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { FunctionCallOutputContentItem } from "./FunctionCallOutputContentItem";
+
+export type FunctionCallOutputBody = string | Array<FunctionCallOutputContentItem>;

package/src/codex-protocol/FunctionCallOutputContentItem.ts

@@ -0,0 +1,10 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { ImageDetail } from "./ImageDetail";
+
+/**
+ * Responses API compatible content items that can be returned by a tool call.
+ * This is a subset of ContentItem with the types we support as function call outputs.
+ */
+export type FunctionCallOutputContentItem = { "type": "input_text", text: string, } | { "type": "input_image", image_url: string, detail?: ImageDetail, } | { "type": "encrypted_content", encrypted_content: string, };

package/src/codex-protocol/FuzzyFileSearchMatchType.ts

@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type FuzzyFileSearchMatchType = "file" | "directory";

package/src/codex-protocol/FuzzyFileSearchParams.ts

@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type FuzzyFileSearchParams = { query: string, roots: Array<string>, cancellationToken: string | null, };

package/src/codex-protocol/FuzzyFileSearchResponse.ts

@@ -0,0 +1,6 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { FuzzyFileSearchResult } from "./FuzzyFileSearchResult";
+
+export type FuzzyFileSearchResponse = { files: Array<FuzzyFileSearchResult>, };

package/src/codex-protocol/FuzzyFileSearchResult.ts

@@ -0,0 +1,9 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { FuzzyFileSearchMatchType } from "./FuzzyFileSearchMatchType";
+
+/**
+ * Superset of [`codex_file_search::FileMatch`]
+ */
+export type FuzzyFileSearchResult = { root: string, path: string, match_type: FuzzyFileSearchMatchType, file_name: string, score: number, indices: Array<number> | null, };