@agent-compose/sdk 0.8.4 → 0.8.6

package/src/index.ts

@@ -100,8 +100,14 @@ export type {
   AgentMessageDone,
   AgentMessageError,
   AgentMessageUsage,
+  AgentMessageModelUsage,
+  AgentMessagePlanLimits,
   AgentMessageTaskNotification,
+  AgentMessageTaskProgress,
+  WorkflowProgressEntry,
   AgentMessageHarnessNotice,
+  AgentMessageCompaction,
+  AgentMessageSubagentUserMessage,
   AgentStatus,
 } from "./types/protocol.js";
 
@@ -121,7 +127,7 @@ export type {
   InlineWorkflowPayload, InvokeInlineOptions, InvokeInlineAndWaitOptions,
   ListSnapshotsOptions, TemplateRow, ListTemplatesOptions,
   CreateFactoryInput, UpdateFactoryInput,
-  SecretOptions, SetSecretResult, SecretListEntry, SessionSecretEntry, SessionSecretInput, SessionSecretRequestCreated, SessionSecretRequestStatus,
+  SecretOptions, SetSecretResult, SecretListEntry, SessionSecretEntry, SessionSecretInput, SessionSecretRequestCreated, SessionSecretRequestStatus, SessionSecretRequestSummary, VaultRequestKind, VaultKeyShape, VaultCatalogEntry,
   CreateApiKeyInput, StreamRunLogsOptions,
   TeamMember, Mention, CreateMentionsInput,
   EventSubjectType, EventRow, ReportEventInput, ListEventsOptions, ListEventsResult,
@@ -137,16 +143,24 @@ export type {
   SendAgentMessageOptions, SendAgentMessageResponse,
   AnswerSteerOptions,
   ResumePauseOptions, ResumePauseResponse, ResumePauseSuccess, ResumePausePending, ResumePauseActor,
-  ConversationMessagePart, ConversationRow, ConversationMessageRow,
+  ConversationMessagePart, ConversationRow, ConversationProject, ConversationMessageRow,
+  CreateChatInput, ChannelIvyState, IvyConnection, HiddenIvyConnection, IvyConnectionsView, IvyConnectionScope, ListingPage,
+  DriveShareItem, DriveShare, HiddenDriveShare, DriveSharesView,
+  WorkspaceConnection, WorkspaceConnectionAudienceEntry, WorkspaceConnectionsScopeView,
   ConversationsPage, ConversationDetail, ConversationThread,
+  ConversationUnreadSummary, ConversationUnreadThreads, ConversationReadInput, ConversationReadResult,
   ConversationPageContext, SendConversationMessageInput, SendConversationMessageResult,
   UnnotifiedMention,
   ConversationTurnState, ConversationPresenceSnapshot, StreamConversationOptions, AgentListRow,
   CreateCloudSessionInput, CloudSessionCreated,
   // Cloud-session developer surface (ADR-0052)
   SessionPreview, PreviewOpened, OpenPreviewInput, SessionForked, BackgroundWorkHeld,
+  BackgroundWorkChildDecl, BackgroundWorkStatus,
+  // Session waits (owner ruling 2026-09-23: the platform senses, the session is woken)
+  SessionWaitKind, SessionWaitState, CreateSessionWaitInput, SessionWait, SessionWaitCheck, SessionWaitCheckResult, SessionWaitCheckReview, SessionWaitCreated, SessionWaitList,
   // Session branch proposals (ADR-0053)
   SessionFileChange, SessionChangeSet, SessionChangeStats, SessionDiffReviewBound, ReviewSuggestion,
+  SessionFileHold, SessionFilePlane,
   ReviewSuggestionInput, ReviewNotesPublished, ReviewGitCredential, SessionReviewDocument,
   ReviewSuggestionDecision, ReviewSuggestionDecisions,
   SessionMergeReportDetail, SessionMergeReport, SessionMergeGated, SessionDiscardReport,
@@ -154,23 +168,29 @@ export type {
   // User drive mounts (`agentc files mount` on a human's own machine)
   DriveMountSession, CreateDriveMountSessionInput,
   // Channel-attached sessions (ADR-0057)
-  ChannelSessionStatus, ChannelSessionRow, ChannelSessionsResponse, SessionChannelMessagePosted,
+  ChannelSessionStatus, ChannelSessionRow, ChannelWorkerFacts, ChannelSessionsResponse,
   // Session→session messaging + branch claims
   SessionDirectMessageSent, BranchClaimInfo, BranchClaimGranted, BranchClaimsReleased, BranchClaimState,
   // Sandbox perf history (session_perf_rollups)
   SessionPerfBucket, SessionPerfHistoryPage, FactoryPerfSummary,
   FactoryFileSearchRow, FactoryFolderSearchRow, SearchFactoryFilesOptions, FactoryFileSearchResult, PublicFileLinkState,
   // Drive file listing (live + browse-at-head)
-  FactoryFileListRow, ListFactoryFilesOptions, FactoryFileListPage,
+  FactoryFileListRow, ListFactoryFilesOptions, FactoryFileListPage, FactoryFileConflict, FactoryFileConflictList, ProjectSecretMeta, ProjectSecretList,
   // Membership-scoped authorization (ADR-0045)
   ConversationMemberRole, ConversationMember,
   DocumentCapability, TemplateCapability, ScopeGrant, ArtifactScope,
   RunContext, SetScopeGrantsInput, SetTemplateScopeInput, TemplateDetail,
   // Projects (ADR-0045 projects extension)
-  Project, ProjectsPage, ProjectRole, ProjectMember,
-  ProjectObject, ProjectObjectsPage, ProjectSkippedFile, ProjectPreviewFile,
+  Project, ProjectUpdate, ProjectsPage, ProjectRole, ProjectMember,
+  ProjectObject, ProjectObjectsPage, ProjectObjectCounts, ProjectSkippedFile, ProjectPreviewFile,
   ProjectAddPreview, AddProjectObjectInput, AddProjectObjectResult,
   RefreshProjectObjectResult,
+  ProjectStatus, ProjectStatusThread, ProjectStatusTask, ProjectStatusPerson, ProjectStatusWorker, ProjectStatusActivity,
+  ProjectStatusActivityKind, ProjectStatusWaitingOn, ProjectStatusWaitingCount, ProjectStatusCounts,
+  ThreadStatus, ThreadStatusWorker, ThreadStatusWorkerState, ThreadStatusWorkerEffort, ThreadStatusTodo, ThreadStatusDirector, ThreadStatusOutput, ThreadStatusEvent,
+  ThreadStatusWaitingOn, ThreadStatusAssignee, ThreadStatusTodoActivity, ChatTodoPatch, ChatTodoComment,
+  ChatWork, ChatWorkThread,
+  MeStatus, MeStatusCounts,
   // Break-glass compliance sessions (ADR-0051)
   ComplianceScopeKind, ComplianceStatus, ComplianceSession, ComplianceAccess,
   RequestComplianceSessionInput, ListComplianceSessionsOptions, ComplianceSessionsPage,
@@ -188,7 +208,7 @@ export {
   REVISION_SELECTOR_RE,
   ASK_DIRECTIVE_PROMPT_MAX, ASK_DIRECTIVE_MAX_OPTIONS,
   ASK_DIRECTIVE_OPTION_ID_MAX, ASK_DIRECTIVE_OPTION_LABEL_MAX,
-  ASK_APPROVER_MIN, ASK_APPROVER_MAX,
+  ASK_APPROVER_MIN, ASK_APPROVER_MAX, TAKEOVER_NOTE_MAX_CHARS,
 } from "./directives.js";
 export type { CloudDirective } from "./directives.js";
 
@@ -253,7 +273,9 @@ export type { GatewayModelId } from "ai";
 // CLI-agent runtimes — drive an external agentic CLI (codex / amp) inside the
 // sandbox and stream-parse its JSONL. No heavy npm deps (the CLI lives in the
 // sandbox image), so these are root-exported like claudeRuntime.
-export { createCodexRuntime, codexSpec } from "./runtimes/codex.js";
+export {
+  createCodexRuntime, codexSpec, CODEX_PLATFORM_HOOKS, RTK_CODEX_HOOK_COMMAND, CODEX_MID_TURN_HOOK_COMMAND,
+} from "./runtimes/codex.js";
 export type { CodexRuntimeConfig, CodexReasoningEffort } from "./runtimes/codex.js";
 export { default as codexRuntime } from "./runtimes/codex.js";
 // Reasoning-effort level a CLI runtime turn may carry (claude-code / codex).
@@ -264,27 +286,34 @@ export type { CliReasoningEffort } from "./runtimes/_cli-agent.js";
 // of truth for the guest file contract. Server-side consumers only (these
 // modules read process.env at load; never import them into a workflow VM).
 export {
-  shellQuote, uniquePromptPath,
+  shellQuote, uniquePromptPath, recoverLaunchPid,
   turnLivenessProbeCommand, parseTurnProbeOutput, livenessVerdictFromReading,
   runnerBusySentinelFragment, exitEventPushCommand,
   injectAppendAndAckCommand, INJECT_ACK_EXEC_TIMEOUT_MS, wrapMidTurnUserMessage,
-  streamInputFeederFragment, sessionEnvSourceFragment, credEnvSourceFragment,
+  stdinStreamInputOf, toolHookInboxFragment, MID_TURN_INBOX_ENV, MID_TURN_DELIVERED_ENV,
+  streamInputFeederFragment, sessionEnvSourceFragment, sessionEnvFingerprintCommand, credEnvSourceFragment,
   residentFeederFragment, residentIdleCheckFragment, residentIdleWatchdogFragment,
-  residentResultCountCommand, deferredExitEventPushCommand,
-  RESIDENT_IDLE_TTL_S, RESIDENT_WATCHDOG_POLL_S, RESIDENT_RESULT_LINE_PREFIX,
+  residentResultCountCommand, residentLastResultCommand, cliResultCountCommand,
+  deferredExitEventPushCommand,
+  RESIDENT_IDLE_TTL_S, RESIDENT_WATCHDOG_POLL_S, CLI_RESULT_LINE_AWK,
   SESSION_ENV_FILE_RELPATH,
   LAUNCH_EXEC_TIMEOUT_MS, TURN_PROBE_TIMEOUT_MS,
   INSTALL_PROBE_TIMEOUT_MS, CLI_INSTALL_TIMEOUT_MS,
   RUNNER_HEARTBEAT_INTERVAL_SECONDS, RUNNER_HEARTBEAT_STALE_MS,
+  RUNNER_BUSY_TASK_FRESH_MINUTES,
+} from "./runtimes/_cli-agent.js";
+export type {
+  TurnProbeReading, CliAgentSpec, MidTurnEnvelopeOptions,
+  MidTurnInputSpec, StdinStreamInputSpec, ToolHookInputSpec,
 } from "./runtimes/_cli-agent.js";
-export type { TurnProbeReading, CliAgentSpec } from "./runtimes/_cli-agent.js";
 // Guest perf sampling (the `.perf` token contract riding the durable trio).
 export {
   perfSamplerFunctionFragment, standalonePerfProbeCommand,
-  parsePerfToken, parsePerfProbeOutput,
+  parsePerfToken, parsePerfProbeOutput, parseTopProcesses,
   PERF_SAMPLE_EVERY_BEATS, PERF_PROBE_WINDOW_SECONDS, PERF_TOKEN_MAX_CHARS,
+  PERF_TOP_PROCESSES, PERF_TOP_NAME_MAX,
 } from "./agent/perf-sampler.js";
-export type { GuestPerfSample } from "./agent/perf-sampler.js";
+export type { GuestPerfSample, GuestTopProcess } from "./agent/perf-sampler.js";
 export { createAmpRuntime } from "./runtimes/amp.js";
 export type { AmpRuntimeConfig } from "./runtimes/amp.js";
 export { default as ampRuntime } from "./runtimes/amp.js";
@@ -304,7 +333,10 @@ export { default as droidRuntime } from "./runtimes/droid.js";
 // adapter) — the cloud-hostable counterpart of `claudeRuntime` (claude.ts,
 // which drives the Agent SDK in the calling process and so can never run a
 // server-driven cloud-session turn).
-export { createClaudeCodeRuntime, claudeCodeSpec, CLAUDE_CODE_ACP_ADAPTER, CLAUDE_CODE_EFFORT_LEVELS } from "./runtimes/claude-code.js";
+export {
+  createClaudeCodeRuntime, claudeCodeSpec, CLAUDE_CODE_ACP_ADAPTER, CLAUDE_CODE_EFFORT_LEVELS,
+  CLAUDE_CODE_PLATFORM_SETTINGS, RTK_BASH_HOOK_COMMAND,
+} from "./runtimes/claude-code.js";
 export type { ClaudeCodeRuntimeConfig } from "./runtimes/claude-code.js";
 export { default as claudeCodeRuntime } from "./runtimes/claude-code.js";
 
@@ -318,6 +350,7 @@ export type { RunEvent } from "./types/events.js";
 // Sandbox providers
 export { createSandbox, reconnectSandbox, killAllSandboxes, killSandboxById,
   getSandboxQuotas, listOwnedSandboxes, deleteSandboxSnapshot, snapshotResolves,
+  isSandboxSourceNotFoundError, openEgressExcept,
   makeSandboxProvider, makeDesktopSandboxProvider,
   parseSseExecStream, AGENT_COMPOSE_TAG,
   SANDBOX_SIZES, SANDBOX_MACHINES, SANDBOX_VCPUS, DEFAULT_SANDBOX_SIZE, SESSION_DEFAULT_SANDBOX_SIZE,
@@ -328,7 +361,14 @@ export { createSandbox, reconnectSandbox, killAllSandboxes, killSandboxById,
   isPlatformE2bTemplateAlias,
   // ADR-0038 "Computer" — the per-member persistent desktop machine template.
   E2B_DEVBOX_TEMPLATE, E2B_DEVBOX_SPEC, E2B_DEVBOX_RECIPE_VERSION,
-  e2bDevboxTemplateRef } from "./sandbox.js";
+  e2bDevboxTemplateRef,
+  // Harness CLI versions the E2B session image bakes (one source for the
+  // image recipe and the runtime specs' on-demand installs), the rtk the
+  // sessions' shell hooks call, and the switches that keep each CLI from
+  // updating itself inside a machine.
+  CLAUDE_CODE_VERSION, CODEX_CLI_VERSION, OPENCODE_CLI_VERSION, RTK_VERSION,
+  CLAUDE_CODE_NO_SELF_UPDATE_ENV, CODEX_NO_SELF_UPDATE_CONFIG_LINE, OPENCODE_NO_SELF_UPDATE_CONFIG,
+} from "./sandbox.js";
 export { SandboxUnavailableError, SANDBOX_UNAVAILABLE_PREFIX } from "./sandbox-errors.js";
 export type {
   SandboxCreateOpts, SandboxNetworkPolicy, SandboxNetworkHeaderTransform,
@@ -427,6 +467,13 @@ export { agent } from "./agent/run-agent.js";
 export type { AgentOpts } from "./agent/run-agent.js";
 export { AGENT_COMPOSE_MANUAL, buildAgentContextDoc, writeAgentContext, buildAddedSessionBrief } from "./agent/agent-context.js";
 export type { AgentConnectorInfo, AddedSessionBriefParams } from "./agent/agent-context.js";
+// The complete `agentc` verb list, GENERATED from the CLI's commander
+// registry (cli/scripts/generate-command-list.ts) and checked in. Both
+// agent-facing contexts ship it verbatim — the in-sandbox manual above and
+// the server's cloud-session prompt — so a verb can never drift out of what
+// agents believe the CLI can do. Never hand-edit the generated module.
+export { AGENTC_COMMANDS, AGENTC_COMMAND_LIST, AGENTC_COMMAND_LIST_MD } from "./generated/agentc-commands.js";
+export type { AgentcCommand } from "./generated/agentc-commands.js";
 export {
   AC_OPEN_PATH, AC_OPEN_STATE_DIR, AC_OPEN_SHIM_PATHS, AC_OPEN_SCRIPT, AC_OPEN_SHIM,
   installDesktopOpenCmd,
@@ -464,7 +511,7 @@ export {
   DRIVE_PATH_MAX_CHARS, isPlausibleDrivePath,
   serializeDisplayMarker, parseDisplayMarker, findDisplayMarker, clampPlanEntries,
   clampTableData, clampChartSeries, clampChartAxisLabel, clampAskOptions,
-  detectAgentcInvocation, shellWords, createDisplayPromoter,
+  detectAgentcInvocation, shellWords, createDisplayPromoter, DISPLAY_PROMOTED_TOOL_NAMES,
 } from "./display.js";
 export type {
   DisplayMarker, DisplayPlanEntry, DisplayPlanStatus,

package/src/pause/pause-core.ts

@@ -169,7 +169,8 @@ function scopeOf(coord: PauseCoordinate): string {
 
 // Per-scope ordinal. Module-level so it resets on a fresh subprocess (the
 // resume boundary) — which is exactly what makes the k-th pause in a scope
-// recompute the same id across re-entry. Mirrors `nextAgentCallIndexByStep`.
+// recompute the same id across re-entry. Mirrors the per-step agent-call
+// counter (`nextAgentCallInActiveStep`).
 const pauseOrdinalByScope = new Map<string, number>();
 
 function nextPauseOrdinal(scope: string): number {

package/src/request-context/request-context.ts

@@ -1,7 +1,7 @@
 /**
  * RequestContext — one typed bag carrying tenant identity + freeform
  * per-run state across the boundary between server, dispatch, runner,
- * workflow body, agent loop, and (future) processors.
+ * workflow body, agent loop, and processors.
  *
  * Two halves:
  *