@sentry/junior 0.197.0 → 0.199.0

package/dist/chat/agent/handoff.d.ts

@@ -1,73 +0,0 @@
-/**
- * Model-profile handoff helpers for one agent run slice.
- *
- * Owns the durable handoff commit, Pi apply shape, tool control, and the few
- * loop checks that only care about handoff tool calls.
- */
-import { type Agent, type AgentLoopTurnUpdate, type AgentTool } from "@earendil-works/pi-agent-core";
-import type { ResumeState } from "@/chat/agent/resume";
-import { type ModelProfile } from "@/chat/model-profile";
-import { resolveGatewayModel } from "@/chat/pi/client";
-import type { PiMessage } from "@/chat/pi/messages";
-import { type CompactContextArgs } from "@/chat/services/context-compaction";
-import { type TurnRoute } from "@/chat/services/turn-router";
-import type { ToolRuntimeContext } from "@/chat/tools/types";
-import { type AgentTurnUsage } from "@/chat/usage";
-/** Staged handoff waiting for the next Pi turn boundary. */
-export type PendingHandoff = {
-    messages: PiMessage[];
-    model: ReturnType<typeof resolveGatewayModel>;
-    modelId: string;
-    modelProfile: ModelProfile;
-    phaseUsage?: AgentTurnUsage;
-    thinkingLevel: NonNullable<AgentLoopTurnUpdate["thinkingLevel"]>;
-    turnRoute: TurnRoute;
-};
-/** Return the exclusive tool name when one is present among the calls. */
-export declare function exclusiveToolName(toolCalls: ReadonlyArray<{
-    name: string;
-}>): string | undefined;
-/** Build the tool control for every configured profile except the active one. */
-export declare function handoffControl(args: {
-    activeProfile: ModelProfile;
-    enabled: boolean;
-    execute: NonNullable<ToolRuntimeContext["handoff"]>["execute"];
-}): ToolRuntimeContext["handoff"];
-/**
- * Rebind the handoff tool description and schema for the active profile.
- * Other tools stay as wired.
- */
-export declare function toolsForHandoffProfile(args: {
-    activeProfile: ModelProfile;
-    agentTools: AgentTool[];
-    enabled: boolean;
-    execute: NonNullable<ToolRuntimeContext["handoff"]>["execute"];
-}): AgentTool[];
-/**
- * Commit the durable handoff epoch and return the staged Pi swap.
- * No-op when the requested profile is already active.
- */
-export declare function commitHandoff(args: {
-    activeModelProfile: ModelProfile;
-    beforeMessageCount: number;
-    conversationContext?: string;
-    conversationId: string;
-    metadata?: CompactContextArgs["metadata"];
-    onStatus?: (status: {
-        text: string;
-    }) => void | Promise<void>;
-    profile: ModelProfile;
-    runtimeContextSourceMessages?: PiMessage[];
-    signal?: AbortSignal;
-    sourceMessages: PiMessage[];
-    triggeringToolCallId?: string;
-    turnRoute: TurnRoute;
-}): Promise<PendingHandoff | undefined>;
-/** Apply a committed handoff to Pi and reset its durable resume baseline. */
-export declare function applyHandoff(args: {
-    agent: Agent;
-    baseInstructions: string;
-    pending: PendingHandoff;
-    resume: ResumeState;
-    tools: AgentTool[];
-}): AgentLoopTurnUpdate;

package/dist/chat/agent/index.d.ts

@@ -1,22 +0,0 @@
-/**
- * Agent executor.
- *
- * Composition root and execution loop for one agent run slice after
- * runtime/ingress code has parsed and routed the request. Wires the phase
- * modules (session restore, skills, tools, prompt, resume), runs the Pi agent
- * with inline retry handling, and translates expected run endings into
- * `AgentRunOutcome` values. It emits every completed, tool-free visible
- * assistant message through the delivery port; the result carries diagnostics,
- * artifacts, and transcript state for destination-owned completion.
- */
-import { type StreamFn } from "@earendil-works/pi-agent-core";
-import type { AgentRunOutcome } from "@/chat/runtime/agent-run-outcome";
-import { type AgentRun } from "@/chat/agent/types";
-/**
- * Run a full agent turn, optionally using a caller-provided model stream.
- *
- * Prefer binding `streamFn` through `createAgentRunner`. The stream changes
- * model output only; prompt assembly, persistence, tools, delivery, and
- * completion still use the normal agent runtime.
- */
-export declare function executeAgentRun(run: AgentRun, streamFn?: StreamFn): Promise<AgentRunOutcome>;

package/dist/chat/agent/prompt.d.ts

@@ -1,86 +0,0 @@
-import type { PiMessage } from "@/chat/pi/messages";
-import { type LogContext } from "@/chat/logging";
-import type { ConversationPrivacy } from "@/chat/conversation-privacy";
-import type { Skill, SkillMetadata } from "@/chat/skills";
-import type { ActiveMcpCatalogSummary } from "@/chat/tool-support/skill/mcp-tool-summary";
-import type { ToolRuntimeContext } from "@/chat/tools/types";
-import type { AnyToolDefinition } from "@/chat/tools/definition";
-import { type Actor } from "@/chat/actor";
-import type { PluginTurnContext } from "@/chat/plugins/prompt";
-import type { AgentInstruction, AgentInstructionActor, AgentRun, AgentSteeringMessage } from "@/chat/agent/types";
-export type UserContentPart = {
-    type: "text";
-    text: string;
-} | {
-    type: "image";
-    data: string;
-    mimeType: string;
-};
-/** User-turn content parts plus the plain-text blocks used for routing decisions. */
-export interface PromptInput {
-    contextContentParts: UserContentPart[];
-    routerBlocks: string[];
-    userContentParts: UserContentPart[];
-}
-/** Fully assembled prompt state for one run slice. */
-export interface PromptAssembly {
-    baseInstructions: string;
-    contextContentParts: UserContentPart[];
-    inputMessages: Array<{
-        role: string;
-        content: Record<string, unknown>[];
-    }>;
-    inputMessagesAttribute: string | undefined;
-    promptTimestamp?: number;
-    promptHistoryMessages: PiMessage[];
-    shouldPromptAgent: boolean;
-    turnContexts: PluginTurnContext[];
-    userContentParts: UserContentPart[];
-}
-/** Render the current actor's instruction without host-owned thread context. */
-export declare function buildUserTurnText(userInput: string, actor?: AgentInstructionActor): string;
-/** Render an explicitly selected skill as instructions for the current turn. */
-export declare function renderExplicitSkillInstructions(skill: Skill): string;
-/** Encode a non-image attachment as base64 XML for the prompt. */
-export declare function encodeNonImageAttachmentForPrompt(attachment: {
-    data: Buffer;
-    mediaType: string;
-    filename?: string;
-}): string;
-/** Redact image data from prompt content parts for observability. */
-export declare function toObservablePromptPart(part: UserContentPart): Record<string, unknown>;
-/** Build the prompt-facing user input, keeping router text aligned with Pi content. */
-export declare function buildPromptInput(args: {
-    instruction: AgentInstruction;
-    history?: readonly import("@/chat/pi/messages").PiMessage[];
-}): PromptInput;
-/**
- * Convert a mid-run user message into the Pi user message shape used for
- * steering injection and parked-conversation event-log appends, so both
- * paths store identical durable history.
- */
-export declare function buildSteeringPiMessage(message: AgentSteeringMessage): PiMessage;
-/** Assemble prompt history, instructions, and telemetry input for one slice. */
-export declare function assemblePrompt(args: {
-    activeMcpCatalogs: ActiveMcpCatalogSummary[];
-    currentActor?: Actor;
-    availableSkills: SkillMetadata[];
-    configurationValues: Record<string, unknown>;
-    contextContentParts: UserContentPart[];
-    conversationPrivacy?: ConversationPrivacy;
-    existingSessionPiMessages?: PiMessage[];
-    existingTurnStartMessageIndex?: number;
-    explicitSkill: Skill | null;
-    priorPiMessages?: PiMessage[];
-    resumedFromSessionRecord: boolean;
-    run: Pick<AgentRun, "source" | "destination" | "dispatch" | "slackConversation" | "location" | "delivery">;
-    spanContext: LogContext;
-    turnId: string;
-    toolGuidance: Array<{
-        name: string;
-        promptGuidelines: AnyToolDefinition["promptGuidelines"];
-        promptSnippet: AnyToolDefinition["promptSnippet"];
-    }>;
-    toolRuntimeContext: ToolRuntimeContext;
-    userContentParts: UserContentPart[];
-}): Promise<PromptAssembly>;

package/dist/chat/agent/repository-context.d.ts

@@ -1,21 +0,0 @@
-import type { AgentContext, AgentLoopTurnUpdate } from "@earendil-works/pi-agent-core";
-import type { ConversationMessageProvenance } from "@/chat/conversations/provenance";
-import type { UserContentPart } from "@/chat/agent/prompt";
-import type { PiMessage } from "@/chat/pi/messages";
-import { type RepositoryInstructions } from "@/chat/repository-instructions";
-type RepositoryInstructionsContextOptions = {
-    capture(): Promise<RepositoryInstructions | undefined>;
-    hasSandbox(): boolean;
-    initialInstructions?: RepositoryInstructions;
-    onTransition?: (instructions: RepositoryInstructions | undefined) => void | Promise<void>;
-    restoredMessages?: PiMessage[];
-    restoredProvenance?: ConversationMessageProvenance[];
-    promptContextContentParts: UserContentPart[];
-    setMessages(messages: PiMessage[]): void;
-    shouldPromptAgent: boolean;
-};
-/** Track model-visible AGENTS.md state and append updates before later samples. */
-export declare function createRepositoryInstructionsContext(options: RepositoryInstructionsContextOptions): {
-    applyUpdate(currentUpdate: AgentLoopTurnUpdate | undefined, currentContext: AgentContext): Promise<AgentLoopTurnUpdate | undefined>;
-};
-export {};

package/dist/chat/agent/resume.d.ts

@@ -1,60 +0,0 @@
-/**
- * In-memory resume helpers for one execution slice.
- *
- * Durable writes go through `saveTurnCheckpoint` only.
- */
-import type { Destination, Source } from "@sentry/junior-plugin-api";
-import type { PiMessage } from "@/chat/pi/messages";
-import type { ConversationMessageProvenance } from "@/chat/conversations/provenance";
-import { CooperativeTurnYieldError } from "@/chat/runtime/turn";
-import type { AgentRunOutcome } from "@/chat/runtime/agent-run-outcome";
-import type { Actor } from "@/chat/actor";
-import { type AgentTurnSurface, type TurnCheckpoint } from "@/chat/task-execution/checkpoint";
-import { type AuthorizationPauseError } from "@/chat/services/auth-pause";
-import { type AgentTurnUsage } from "@/chat/usage";
-import { type AgentDurability } from "@/chat/agent/types";
-import type { PluginTurnContext } from "@/chat/plugins/prompt";
-interface ResumeStateArgs {
-    channelName?: string;
-    destination: Destination;
-    dispatchId?: string;
-    durability: AgentDurability;
-    recordActiveMcpProviders: () => Promise<void>;
-    actor?: Actor;
-    runSource: Source;
-    conversationId: string;
-    turnId: string;
-    checkpoint: TurnCheckpoint;
-    startedAtMs: number;
-    surface: AgentTurnSurface;
-}
-type AuthPauseOutcome = Extract<AgentRunOutcome, {
-    status: "awaiting_auth";
-}>;
-/** Create resume state for one slice. */
-export declare function createResumeState(args: ResumeStateArgs): {
-    readonly inputCommitted: boolean;
-    readonly beforeMessageCount: number;
-    readonly timedOut: boolean;
-    setTurnStartMessageIndex(index: number | undefined): void;
-    setBeforeMessageCount(count: number): void;
-    /** Admit one tool call against the durable turn total, or throw the limit. */
-    admitToolCall(): void;
-    setTurnContexts(contexts: PluginTurnContext[]): void;
-    /** Use an already committed boundary as the resume baseline. */
-    adoptCommittedBoundary(messages: PiMessage[]): void;
-    captureResumeSnapshot(messages: PiMessage[]): void;
-    getResumeSnapshot(currentMessages: PiMessage[]): PiMessage[];
-    markTimedOut(): void;
-    commitInput(): Promise<void>;
-    persistSafeBoundary(messages: PiMessage[], trailingMessageProvenance?: ConversationMessageProvenance[]): Promise<boolean>;
-    requireDurableInputCheckpoint(messages: PiMessage[], trailingMessageProvenance?: ConversationMessageProvenance[]): Promise<boolean>;
-    prepareYieldIfDue(currentMessages: PiMessage[]): CooperativeTurnYieldError | undefined;
-    parkForAuth(pause: AuthorizationPauseError, currentUsage?: AgentTurnUsage): Promise<AuthPauseOutcome>;
-    translateSuspension(ending: {
-        currentUsage?: AgentTurnUsage;
-        error: unknown;
-    }): Promise<AgentRunOutcome | undefined>;
-};
-export type ResumeState = ReturnType<typeof createResumeState>;
-export {};

package/dist/chat/agent/retry-usage.d.ts

@@ -1,8 +0,0 @@
-import type { PiMessage } from "@/chat/pi/messages";
-import { type AgentTurnUsage } from "@/chat/usage";
-/**
- * Return usage discarded when a retry keeps an exact prefix of agent history.
- *
- * Retained messages stay in the next phase and must not be counted again here.
- */
-export declare function getDiscardedRetryUsage(messages: PiMessage[], retryMessages: PiMessage[]): AgentTurnUsage | undefined;

package/dist/chat/agent/sandbox.d.ts

@@ -1,55 +0,0 @@
-/**
- * Agent-facing sandbox adaptation.
- *
- * The sandbox module owns provider lifecycle and recovery. This module adds
- * agent-specific preparation, durable reference propagation, custom command
- * routing, and generated-artifact materialization.
- */
-import type { FileUpload } from "chat";
-import type { PluginSandbox } from "@sentry/junior-plugin-api";
-import { type Actor } from "@/chat/actor";
-import type { LocationConfigurationService } from "@/chat/configuration/types";
-import type { CredentialContext } from "@/chat/credentials/context";
-import type { LogContext } from "@/chat/logging";
-import type { SandboxEgressTracePropagationConfig } from "@/chat/sandbox/egress/tracing";
-import type { SandboxEgressSignalTransport } from "@/chat/sandbox/egress/signals";
-import type { SandboxRef } from "@/chat/sandbox/ref";
-import type { RepositoryInstructions } from "@/chat/repository-instructions";
-import { type SandboxTools } from "@/chat/sandbox/sandbox";
-import type { SandboxWorkspace } from "@/chat/sandbox/workspace";
-import type { Skill, SkillMetadata } from "@/chat/skills";
-import type { Workspace } from "@/chat/workspaces/types";
-import type { GeneratedArtifactFileRef } from "@/chat/tools/sandbox/file-uploads";
-export interface AgentSandboxOptions {
-    sandboxRef?: SandboxRef;
-    workspace?: Workspace;
-    skills: SkillMetadata[];
-    traceContext: LogContext;
-    tracePropagation?: SandboxEgressTracePropagationConfig;
-    egressSignals?: SandboxEgressSignalTransport;
-    credentialEgress?: CredentialContext;
-    actor?: Actor;
-    locationConfiguration?: LocationConfigurationService;
-    configurationValues: Record<string, unknown>;
-    getActiveSkill(): Skill | null;
-    prepareSandbox(workspace: SandboxWorkspace): void | Promise<void>;
-    prepareWorkspace?(workspace: SandboxWorkspace, recipe: Workspace, signal?: AbortSignal): Promise<void>;
-    onSandboxRefChanged(sandboxRef: SandboxRef): void;
-    persistSandboxRef?(sandboxRef: SandboxRef): void | Promise<void>;
-}
-export interface AgentSandbox {
-    /** Resolve the AGENTS.md bundle for the selected repository directory. */
-    captureRepositoryInstructions(): Promise<RepositoryInstructions | undefined>;
-    readonly tools: SandboxTools;
-    readonly workspace: SandboxWorkspace;
-    sandboxRef(): SandboxRef | undefined;
-    switchWorkspace(workspace: Workspace, signal?: AbortSignal): Promise<void>;
-    close(): void;
-    writeGeneratedArtifacts(files: FileUpload[]): Promise<GeneratedArtifactFileRef[]>;
-}
-/** Adapt agent sandbox execution for plugin-owned workspace tools. */
-export declare function createPluginToolSandbox(sandbox: Pick<AgentSandbox, "tools" | "workspace">, options: {
-    handleAuthSignal(details: unknown): Promise<void>;
-}): PluginSandbox;
-/** Create run-scoped sandbox capabilities adapted to the current agent context. */
-export declare function createAgentSandbox(options: AgentSandboxOptions): AgentSandbox;

package/dist/chat/agent/skills.d.ts

@@ -1,17 +0,0 @@
-import { type Skill, type SkillMetadata } from "@/chat/skills";
-import { SkillSandbox } from "@/chat/sandbox/skill-sandbox";
-import type { PiMessage } from "@/chat/pi/messages";
-/** Upsert a skill into the active skills list by name. */
-export declare function upsertActiveSkill(activeSkills: Skill[], next: Skill): void;
-/** Discover skills for one slice; emits the startup discovery summary once per process. */
-export declare function discoverRunSkills(args: {
-    skillDirs?: string[];
-}): Promise<SkillMetadata[]>;
-/** Load the explicit skill, or recover the last skill loaded in a resumed turn. */
-export declare function loadRunSkill(args: {
-    activeSkills: Skill[];
-    currentTurnMessages: readonly PiMessage[];
-    invokedSkill: SkillMetadata | null;
-    resumed: boolean;
-    skillSandbox: SkillSandbox;
-}): Promise<Skill | null>;

package/dist/chat/agent/tools.d.ts

@@ -1,91 +0,0 @@
-/**
- * Run tool wiring.
- *
- * Builds everything the agent can act through for one run slice: the sandbox
- * access, MCP and plugin auth orchestration, credential-subject-owned MCP
- * provider
- * restoration, and the Pi-facing tool surfaces (main-agent tools plus runtime
- * control tools). Auth pauses raised while restoring providers are thrown
- * here so the run parks before prompting.
- */
-import type { AgentTool } from "@earendil-works/pi-agent-core";
-import type { FileUpload } from "chat";
-import { SkillSandbox } from "@/chat/sandbox/skill-sandbox";
-import type { Skill, SkillMetadata } from "@/chat/skills";
-import { type PluginHookRunner } from "@/chat/plugins/agent-hooks";
-import { McpToolManager } from "@/chat/mcp/tool-manager";
-import type { AnyToolDefinition } from "@/chat/tools/definition";
-import type { ToolRuntimeContext } from "@/chat/tools/types";
-import { type ActiveMcpCatalogSummary } from "@/chat/tool-support/skill/mcp-tool-summary";
-import type { SandboxRef } from "@/chat/sandbox/ref";
-import type { RepositoryInstructions } from "@/chat/repository-instructions";
-import type { PiMessage } from "@/chat/pi/messages";
-import type { LogContext } from "@/chat/logging";
-import type { ConversationPrivacy } from "@/chat/conversation-privacy";
-import type { OAuthAuthorization } from "@/chat/oauth-authorization";
-import type { Actor } from "@/chat/actor";
-import type { AuthorizationPauseError } from "@/chat/services/auth-pause";
-import type { AgentTurnSurface } from "@/chat/task-execution/checkpoint";
-import { type AgentDurability, type AgentEvent, type AgentRun, type AgentRunState } from "@/chat/agent/types";
-import type { ResumeState } from "@/chat/agent/resume";
-interface ToolWiringArgs {
-    abortAgent: () => void;
-    activeSkills: Skill[];
-    currentActor?: Actor;
-    /** Live projection of the run's committed instruction-authority actors so far. */
-    currentActors?: () => Actor[];
-    /** Live Pi transcript used to give Guardian bounded action context. */
-    currentAgentMessages: () => PiMessage[];
-    /** Durable transcript for this turn only, used to restore rejection state. */
-    currentTurnMessages: readonly PiMessage[];
-    /** Live same-actor instructions that authorize the pending action. */
-    currentUserIntent: () => string;
-    availableSkills: SkillMetadata[];
-    configurationValues: Record<string, unknown>;
-    connectedMcpProviders: Set<string>;
-    conversationPrivacy?: ConversationPrivacy;
-    durability: AgentDurability;
-    authorization?: OAuthAuthorization;
-    generatedFiles: FileUpload[];
-    invokedSkill: SkillMetadata | null;
-    onEvent?: (event: AgentEvent) => void | Promise<void>;
-    onFatalToolError(error: Error): void;
-    onSandboxRefChanged: (sandboxRef: SandboxRef) => void;
-    preAgentPromptMessages: () => PiMessage[];
-    recordConnectedMcpProvider: (provider: string) => Promise<void>;
-    requestHandoff?: ToolRuntimeContext["handoff"];
-    resume: ResumeState;
-    run: AgentRun;
-    skillSandbox: SkillSandbox;
-    spanContext: LogContext;
-    state: AgentRunState;
-    supportsImageInput: () => boolean;
-    surface: AgentTurnSurface;
-    toolCalls: string[];
-    userInput: string;
-}
-export interface ToolWiring {
-    activeMcpCatalogs: ActiveMcpCatalogSummary[];
-    agentTools: AgentTool[];
-    getPendingAuthPause: () => AuthorizationPauseError | undefined;
-    mcpToolManager: McpToolManager;
-    pluginHooks: PluginHookRunner;
-    /** Project core-owned review state into one durable Pi tool result. */
-    projectActionReviewResult<TResult extends {
-        details?: unknown;
-        isError?: boolean;
-    }>(toolCallId: string, result: TResult): TResult;
-    getSandboxRef: () => SandboxRef | undefined;
-    /** Resolve the AGENTS.md bundle selected by the sandbox workspace. */
-    captureRepositoryInstructions: () => Promise<RepositoryInstructions | undefined>;
-    close(): Promise<void>;
-    toolGuidance: Array<{
-        name: string;
-        promptGuidelines: AnyToolDefinition["promptGuidelines"];
-        promptSnippet: AnyToolDefinition["promptSnippet"];
-    }>;
-    toolRuntimeContext: ToolRuntimeContext;
-}
-/** Wire sandbox, auth orchestration, MCP restoration, and Pi tool surfaces for one slice. */
-export declare function wireAgentTools(args: ToolWiringArgs): Promise<ToolWiring>;
-export {};

package/dist/chat/agent/types.d.ts

@@ -1,224 +0,0 @@
-/** Input for one Run through Junior's agent. */
-import type { Destination, ReplyAttribution, Source, SystemActor } from "@sentry/junior-plugin-api";
-import type { Location } from "@/chat/conversations/location";
-import type { LocationConfigurationService } from "@/chat/configuration/types";
-import type { CredentialContext } from "@/chat/credentials/context";
-import type { PiMessage } from "@/chat/pi/messages";
-import type { Actor } from "@/chat/actor";
-import type { SandboxRef } from "@/chat/sandbox/ref";
-import type { SandboxEgressTracePropagationConfig } from "@/chat/sandbox/egress/tracing";
-import type { SandboxEgressSignalTransport } from "@/chat/sandbox/egress/signals";
-import type { OAuthAuthorization } from "@/chat/oauth-authorization";
-import type { SlackConversationContext } from "@/chat/slack/conversation-context";
-import type { ConversationPendingAuthState } from "@/chat/state/conversation";
-import type { ConversationMessageProvenance } from "@/chat/conversations/provenance";
-import type { AgentTurnSurface } from "@/chat/task-execution/checkpoint";
-import type { ToolExecutionReport } from "@/chat/tool-support/tool-execution-report";
-import type { SlackActionToken } from "@/chat/slack/action-token";
-import type { TurnReasoningLevel } from "@/chat/reasoning-level";
-import type { ImageGenerateToolDeps, ViewImageToolDeps, WebFetchToolDeps, WebSearchToolDeps } from "@/chat/tools/types";
-import type { AssistantMessage } from "@earendil-works/pi-ai";
-import type { AttachmentStorage } from "@/chat/attachments/storage";
-/** One attachment the model may see for the current instruction. */
-export type AgentAttachment = {
-    data?: Buffer;
-    mediaType: string;
-    filename?: string;
-    promptText?: string;
-};
-/** Instruction author metadata used for prompt labels and provenance. */
-export type AgentInstructionActor = {
-    authorId?: string;
-    authorName?: string;
-    /**
-     * Slack message ts for the instruction when known.
-     * TODO(dcramer): Use a provider-neutral message id after prompt attributes no
-     * longer require the Slack timestamp.
-     */
-    slackTs?: string;
-};
-/** One mid-turn steered user message drained from the durable mailbox. */
-export type AgentSteeringMessage = {
-    actor?: AgentInstructionActor;
-    /** Provenance of this queued/steered message, carrying its original author. */
-    provenance: ConversationMessageProvenance;
-    omittedImageAttachmentCount?: number;
-    text: string;
-    timestampMs?: number;
-    attachments?: AgentAttachment[];
-};
-/** Model-safe input for one asynchronously delegated child-agent task. */
-export type SpawnAgentInput = {
-    name?: string;
-    reasoningLevel?: TurnReasoningLevel;
-    task: string;
-};
-/** Handle returned after a child-agent task is durably scheduled. */
-export type SpawnAgentResult = {
-    invocationId: string;
-};
-/** Runtime-bound child-agent capability exposed to model-facing tool wiring. */
-export type SpawnAgent = (input: SpawnAgentInput, options: {
-    signal?: AbortSignal;
-    toolCallId: string;
-}) => Promise<SpawnAgentResult>;
-/** Current user instruction for one agent-run slice. */
-export type AgentInstruction = {
-    text: string;
-    attachments?: readonly AgentAttachment[];
-    inboundAttachmentCount?: number;
-    omittedImageAttachmentCount?: number;
-    /** Host-owned turn context shown to the model near the instruction. */
-    context?: string;
-    actor?: AgentInstructionActor;
-    /**
-     * When history is present, still include `context` in the prompt. Default is
-     * to omit conversation context once durable history already carries it.
-     */
-    includeConversationContextWithHistory?: boolean;
-};
-/** Dispatch identity carried on plugin-authored runs. */
-export type AgentDispatch = {
-    actor?: SystemActor;
-    id: string;
-    metadata?: Record<string, string>;
-    plugin?: string;
-    replyAttribution?: ReplyAttribution;
-};
-/** Optional agent capabilities that a run slice can turn off. */
-export declare const AGENT_RUN_FEATURES: readonly ["handoff", "interactive-auth", "subagents"];
-/** One optional agent capability controlled per run. */
-export type AgentFeature = (typeof AGENT_RUN_FEATURES)[number];
-/** Already-loaded resume state for this conversation. */
-export type AgentRunState = {
-    pendingAuth?: ConversationPendingAuthState;
-    /** Persisted sandbox reuse state from prior slices of this conversation. */
-    sandboxRef?: SandboxRef;
-};
-/**
- * Delivers completed tool-free assistant messages in model order.
- *
- * The runner must commit the preceding agent boundary before invoking this
- * port; the accepted reply transaction appends only this message.
- *
- * TODO(dcramer): Remove Conversation Message persistence from Delivery
- * implementations after the core Turn lifecycle stores each completed
- * assistant Message.
- */
-export type Delivery = (message: AssistantMessage) => void | Promise<void>;
-/** Resume the agent turn after a transient or ambiguous delivery failure. */
-export declare class RetryableDeliveryError extends Error {
-    constructor(cause: unknown);
-}
-/** Durable-worker ports that commit or update resumable run state. */
-export type AgentDurability = {
-    /** Schedule delegated work with authority bound by the active parent run. */
-    spawnAgent?: SpawnAgent;
-    onInputCommitted?: () => void | Promise<void>;
-    /** Return true when the durable worker should pause at the next Pi boundary. */
-    shouldYield?: () => boolean;
-    drainSteeringMessages?: (accept: (messages: AgentSteeringMessage[]) => Promise<void>) => Promise<AgentSteeringMessage[]>;
-    recordPendingAuth?: (pendingAuth: ConversationPendingAuthState | undefined) => void | Promise<void>;
-    onSandboxRefChanged?: (sandboxRef: SandboxRef) => void | Promise<void>;
-};
-/** Best-effort progress events. Failures here never affect the run. */
-export type AgentEvent = {
-    type: "status";
-    text: string;
-} | {
-    type: "tool_started";
-    toolCallId: string;
-    toolName: string;
-    params: Record<string, unknown>;
-} | {
-    type: "tool_finished";
-    report: ToolExecutionReport;
-};
-/** Resolved environment and optional per-run tool test overrides. */
-export type AgentEnvironment = {
-    attachmentStorage?: AttachmentStorage;
-    configuration?: Record<string, unknown>;
-    locationConfiguration?: LocationConfigurationService;
-    skillDirs?: string[];
-    /** Per-slice override for app-owned sandbox egress trace propagation. */
-    sandboxTracePropagation?: SandboxEgressTracePropagationConfig;
-    /** Per-slice sandbox egress signal storage override. */
-    sandboxEgressSignals?: SandboxEgressSignalTransport;
-    toolOverrides?: {
-        imageGenerate?: ImageGenerateToolDeps;
-        viewImage?: ViewImageToolDeps;
-        webFetch?: WebFetchToolDeps;
-        webSearch?: WebSearchToolDeps;
-    };
-};
-/**
- * One bounded attempt to advance a Turn.
- *
- * Build identity, instruction, history, delivery, and durability here. Bind
- * stable model/stream composition when creating the runner, not on each run.
- */
-export type AgentRun = {
-    /** Durable conversation advanced by this run. */
-    conversationId: string;
-    /** Stable turn advanced across this run and any continuation runs. */
-    turnId: string;
-    /** Optional bounded-run identifier used only for observability. */
-    runId?: string;
-    instruction: AgentInstruction;
-    /** Durable Pi transcript for this conversation, excluding ephemeral turn context. */
-    history?: readonly PiMessage[];
-    /**
-     * Who this run executes as. Prefer always setting this. Derive
-     * `credentialContext` with `credentialContextForActor(actor, subject?)`
-     * unless a caller already bound credentials.
-     */
-    actor?: Actor;
-    /** Credential authority projected from actor (plus optional subject). */
-    credentialContext?: CredentialContext;
-    source: Source;
-    /** Conversation Location available to this Run. */
-    location?: Location;
-    destination: Destination;
-    surface?: AgentTurnSurface;
-    dispatch?: AgentDispatch;
-    /**
-     * TODO(dcramer): Move ephemeral Slack credentials and conversation labels into
-     * provider-owned tool/prompt context so the shared run edge stays neutral.
-     */
-    slackConversation?: SlackConversationContext;
-    slackActionToken?: SlackActionToken;
-    toolChannelId?: string;
-    /** Surface-owned OAuth state and private delivery capabilities. */
-    authorization?: OAuthAuthorization;
-    /**
-     * Optional agent capabilities disabled for this run slice.
-     * `interactive-auth` blocks pausing to send an OAuth link; missing credentials
-     * hard-fail instead. Default is enabled when omitted.
-     * TODO(dcramer): Issues #881 and #883 track a path for child invocations to
-     * force interactive auth when a delegated tool requires credentials the
-     * parent can already request. Children currently disable it.
-     */
-    disabledFeatures?: readonly AgentFeature[];
-    /** Absolute wall-clock deadline for this host request, in milliseconds. */
-    deadlineAtMs?: number;
-    /** Cancels provider work when the owning host request is abandoned. */
-    signal?: AbortSignal;
-    /** Explicit per-agent reasoning level. When set, adaptive routing is disabled. */
-    reasoning?: TurnReasoningLevel;
-    environment?: AgentEnvironment;
-    state?: AgentRunState;
-    /** Best-effort progress only. */
-    onEvent?: (event: AgentEvent) => void | Promise<void>;
-    delivery?: Delivery;
-    durability?: AgentDurability;
-};
-/** Return whether one optional agent capability is disabled for this run. */
-export declare function isAgentRunFeatureDisabled(disabledFeatures: readonly AgentFeature[] | undefined, feature: AgentFeature): boolean;
-/** Resolve the explicit actor, dispatch actor, or credential actor for this run. */
-export declare function actorFromRun(run: Pick<AgentRun, "actor" | "dispatch" | "credentialContext">): Actor | undefined;
-/** Reject contradictory provider coordinates before the run touches state. */
-export declare function assertRunConsistency(run: Pick<AgentRun, "conversationId" | "source" | "location" | "destination" | "surface" | "actor" | "dispatch">): void;
-/** Route tool side effects to the tool channel when one overrides the destination. */
-export declare function toolInvocationDestination(run: Pick<AgentRun, "destination" | "toolChannelId">): Destination;
-/** Infer the run surface when the caller did not state one. */
-export declare function surfaceFromRun(run: Pick<AgentRun, "surface" | "source">): AgentTurnSurface;