AgentFeatures

Parameters and properties

• nameRequired
  string
  Native agent identifier used in execution events and diagnostics.
• bootstrapOptional
  string | undefined
  Built-in agent whose pinned CLI Outpost installs on a remote sandbox when the executable is missing: an npm package, or a SHA-512-verified archive for antigravity. An unknown name fails.
• requiresFinishedEventOptional
  boolean | undefined
  Require the native final event: without it, completion markers do not match and the turn fails with code process, even when the process exits with 0.
• usageOptional
  "events" | "session" | "unavailable" | undefined
  How token usage is measured: events reads it from the output stream, session reads the session after the process exits, unavailable records none. Missing counters then mark usage incomplete; omitted, reported events are counted without that check.
• variablesOptional
  Readonly<Record<string, string>> | undefined
  Environment variables added to every command of this agent, over the values from .outpost/.env. A name also set by the sandbox provider fails with code configuration.
• storageOptional
  ConversationStore | undefined
  Conversation store that captures, locates and restores this agent’s sessions; absent when its conversations are not portable.
• captureOptional
  boolean | undefined
  Save the conversation to storage after each turn; false skips it. Omitted, a turn is saved whenever storage is present.
• resumableOptional
  boolean | undefined
  Whether the agent can continue a conversation, as continuation, response repairs and resume-based steering require; false rejects continuation before allocation. Cold continuation also needs storage.
• forkableOptional
  boolean | undefined
  Whether the agent can fork a conversation; false rejects fork before allocation. Omitted, fork is attempted through request() or the fork hook.
• transcriptUsageOptional
  ((text: string) => Usage | undefined) | undefined
  Read token usage from the transcript captured after the turn; a result replaces the usage reported by events, undefined keeps it.

Signature

export interface AgentFeatures {
  readonly name: string;
  readonly bootstrap?: string;
  readonly requiresFinishedEvent?: boolean;
  readonly usage?: "events" | "session" | "unavailable";
  readonly variables?: Variables;
  readonly storage?: ConversationStore;
  readonly capture?: boolean;
  readonly resumable?: boolean;
  readonly forkable?: boolean;
  transcriptUsage?(text: string): Usage | undefined;
}

Related contracts

• ConversationStore
• Usage
• Variables