@sentry/junior 0.115.0 → 0.116.1

package/dist/chat/conversations/projection.d.ts

@@ -33,7 +33,7 @@ export declare function loadTurnProjection(args: {
 /** Load MCP providers connected in the current agent-history version. */
 export declare function loadConnectedMcpProviders(args: ScopedConversation): Promise<string[]>;
 /**
- * Append newly stable agent steps. A shorter or changed prefix indicates
+ * Append newly stable native history items. A shorter or changed prefix indicates
  * that a caller persisted volatile Pi state; only compaction and handoff may
  * intentionally replace active model history.
  */
@@ -51,7 +51,7 @@ export declare function commitMessages(args: {
 }): Promise<{
     committedSeq: number;
     historyVersion: number;
-    /** Event sequence for every projected agent step. */
+    /** Event sequence for every projected agent history item. */
     messageSeqs: number[];
     /** Normalized durable messages after volatile runtime context is removed. */
     messages: PiMessage[];

package/dist/chat/mcp/tool-manager.d.ts

@@ -8,6 +8,7 @@
  */
 import type { ImageContent, TextContent } from "@earendil-works/pi-ai";
 import type { OAuthClientProvider } from "@modelcontextprotocol/sdk/client/auth.js";
+import type { ToolAnnotations } from "@sentry/junior-plugin-api";
 import type { ConversationPrivacy } from "@/chat/conversation-privacy";
 import type { SkillMetadata } from "@/chat/skills";
 import type { PluginDefinition } from "@/chat/plugins/types";
@@ -27,7 +28,7 @@ export interface ManagedMcpToolDescriptor {
     description: string;
     parameters: Record<string, unknown>;
     outputSchema?: Record<string, unknown>;
-    annotations?: Record<string, unknown>;
+    annotations?: ToolAnnotations;
     provider: string;
 }
 type ActiveMcpSkill = Pick<SkillMetadata, "name" | "pluginProvider">;

package/dist/chat/pi/conversation-events.d.ts

@@ -5,7 +5,7 @@
  * stored messages into the active Pi context.
  */
 import type { ModelProfile } from "@/chat/model-profile";
-import type { ConversationEvent } from "@/chat/conversations/history";
+import type { ConversationEvent, AgentHistoryItem } from "@/chat/conversations/history";
 import { type PiMessage } from "@/chat/pi/messages";
 import { type ConversationMessageProvenance } from "@/chat/conversations/provenance";
 /** Pi context projected from one Junior model-history version. */
@@ -19,10 +19,14 @@ export interface PiConversationProjection {
 export interface PiConversationEventProjection extends PiConversationProjection {
     seqs: number[];
 }
+/** Translate one Pi message into Junior's native durable history item. */
+export declare function historyItemFromPiMessage(message: PiMessage, provenance: ConversationMessageProvenance): AgentHistoryItem;
+/** Translate one Junior-native history item into the Pi message it represents. */
+export declare function piMessageFromHistoryItem(data: AgentHistoryItem): PiMessage;
 /**
  * Project ordered Junior events into Pi context.
  *
- * Compaction and handoff start with replacement history. Later agent-step
+ * Compaction and handoff start with replacement history. Later native history
  * events append after it.
  *
  * Host-only events are filtered, completed authorization becomes a synthetic

package/dist/chat/plugins/annotations.d.ts

@@ -0,0 +1,8 @@
+import { type ConversationAnnotation, type PluginAnnotations } from "@sentry/junior-plugin-api";
+import type { JuniorDatabase } from "@/db/db";
+export declare function createPluginAnnotations(args: {
+    conversationId: string;
+    db: JuniorDatabase;
+    plugin: string;
+}): PluginAnnotations;
+export declare function listConversationAnnotations(db: JuniorDatabase, conversationId: string): Promise<ConversationAnnotation[]>;

package/dist/chat/plugins/registry.d.ts

@@ -1,10 +1,8 @@
-import type { CapabilityProviderDefinition } from "@/chat/capabilities/catalog";
 import type { CredentialBroker } from "@/chat/credentials/broker";
 import { type InstalledPluginPackageContent } from "./package-discovery";
 import type { InlinePluginManifestDefinition, PluginBrokerDeps, PluginCatalogConfig, PluginDefinition, OAuthProviderConfig, PluginRuntimeDependency, PluginRuntimePostinstallCommand } from "./types";
 export interface PluginCatalogRuntime {
     createBroker(provider: string, deps: PluginBrokerDeps): CredentialBroker;
-    getCapabilityProviders(): CapabilityProviderDefinition[];
     getDefinition(provider: string): PluginDefinition | undefined;
     getDisplayName(provider: string): string | undefined;
     getForSkillPath(skillPath: string): PluginDefinition | undefined;
@@ -20,7 +18,6 @@ export interface PluginCatalogRuntime {
     getRuntimePostinstall(): PluginRuntimePostinstallCommand[];
     getSignature(): string;
     getSkillRoots(): string[];
-    isCapability(capability: string): boolean;
     isConfigKey(key: string): boolean;
     isProvider(provider: string): boolean;
     parseConfiguredInlineManifest(manifest: InlinePluginManifestDefinition["manifest"], dir: string): PluginDefinition["manifest"];

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

@@ -63,7 +63,6 @@ export interface PluginManifest {
     name: string;
     displayName: string;
     description: string;
-    capabilities: string[];
     configKeys: string[];
     domains?: string[];
     apiHeaders?: Record<string, string>;
@@ -109,7 +108,6 @@ type PluginCredentialConfig = PluginCredentialConfigBase & {
 export interface PluginManifestConfig {
     displayName?: string;
     description?: string;
-    capabilities?: string[];
     configKeys?: string[];
     domains?: string[] | null;
     apiHeaders?: Record<string, string | null> | null;

package/dist/chat/runtime/agent-continue-runner.d.ts

@@ -1,9 +1,13 @@
 import { resumeSlackTurn } from "@/chat/runtime/slack-resume";
 import { type AgentContinueRequest } from "@/chat/services/agent-continue";
 import type { AgentRunner } from "@/chat/runtime/agent-runner";
+import type { AgentRunRouting } from "@/chat/agent/request";
 /** Runtime ports for agent continuation scheduling. */
 export interface AgentContinueRunnerOptions {
     agentRunner: AgentRunner;
+    /** Exact persisted input ids accepted for a non-interactive continuation. */
+    inputMessageIds?: readonly string[];
+    routingContext?: Pick<AgentRunRouting, "actor" | "credentialContext" | "destinationVisibility" | "dispatch" | "surface">;
     resumeTurn?: typeof resumeSlackTurn;
     scheduleAgentContinue?: (request: AgentContinueRequest) => Promise<void>;
     scheduleSessionCompletedPluginTasks?: (params: {

package/dist/chat/runtime/reply-executor.d.ts

@@ -17,6 +17,7 @@ import type { ContextCompactor } from "@/chat/services/context-compaction";
 import { lookupSlackUser } from "@/chat/slack/user";
 import type { AgentContinueRequest } from "@/chat/services/agent-continue";
 import type { ConversationTurnLifecycle } from "@/chat/conversations/turn-lifecycle";
+import type { DispatchTurnContext, DispatchTurnResult } from "@/chat/agent-dispatch/types";
 export interface ReplyExecutorServices {
     agentRunner: AgentRunner;
     contextCompactor: ContextCompactor;
@@ -51,7 +52,7 @@ interface ReplyExecutorDeps {
     prepareTurnState: (args: PrepareTurnStateInput) => Promise<PreparedTurnState>;
     services: ReplyExecutorServices;
 }
-/** Build the Slack reply handler that prepares state, runs Pi, and delivers replies. */
+/** Build the shared reply handler that prepares, advances, and commits a turn. */
 export declare function createReplyToThread(deps: ReplyExecutorDeps): (thread: Thread, message: Message, options: {
     beforeFirstResponsePost?: () => Promise<void>;
     destination: Destination;
@@ -59,9 +60,13 @@ export declare function createReplyToThread(deps: ReplyExecutorDeps): (thread: T
     ack?: () => Promise<void>;
     onToolInvocation?: (invocation: TurnToolInvocation) => void;
     onTurnCompleted?: () => Promise<void>;
+    onTurnDeliveryAccepted?: (messageId?: string) => void;
+    onTurnOutcome?: (result: DispatchTurnResult) => void;
     onTurnStatePersisted?: () => Promise<void>;
     preparedState?: PreparedTurnState;
     queuedMessages?: QueuedTurnMessage[];
+    execution?: DispatchTurnContext;
+    skipBackfill?: boolean;
     drainSteeringMessages?: (accept: (messages: QueuedTurnMessage[]) => Promise<void>, context?: {
         conversationContext?: string;
     }) => Promise<QueuedTurnMessage[]>;

package/dist/chat/runtime/slack-resume.d.ts

@@ -12,8 +12,10 @@ interface ResumeSlackTurnArgs {
     messageText: string;
     conversationId: string;
     turnId: string;
+    /** Active durable execution slice being resumed. */
+    sliceId?: number;
     channelId: string;
-    threadTs: string;
+    threadTs?: string;
     messageTs?: SlackMessageTs;
     replyContext?: ResumeReplyContext;
     lockKey?: string;
@@ -41,6 +43,8 @@ type ResumeReplyContext = Omit<AgentRunRequest, "conversationId" | "turnId" | "r
 };
 interface ResumePreparedTurn {
     messageText: string;
+    /** Active durable execution slice being resumed. */
+    sliceId?: number;
     messageTs?: SlackMessageTs;
     inputMessageIds?: string[];
     initialStatus?: AssistantStatusSpec;

package/dist/chat/runtime/turn-input.d.ts

@@ -1,4 +1,5 @@
 import type { Message, Thread } from "chat";
+import type { ChannelConfigurationService } from "@/chat/configuration/types";
 export interface TurnContext {
     channelId?: string;
     actorId?: string;
@@ -18,10 +19,12 @@ export interface QueuedTurnMessage extends TurnMessageText {
     message: Message;
 }
 export interface PrepareTurnStateInput {
+    channelConfiguration?: ChannelConfigurationService;
     context: TurnContext;
     explicitMention: boolean;
     message: Message;
     queuedMessages?: QueuedTurnMessage[];
+    skipBackfill?: boolean;
     text: TurnMessageText;
     thread: Thread;
 }

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

@@ -3,7 +3,7 @@ import type { SandboxEgressSignalTransport } from "@/chat/sandbox/egress/signals
 import type { SandboxEgressTracePropagationConfig } from "@/chat/sandbox/egress/tracing";
 import type { CredentialContext } from "@/chat/credentials/context";
 import type { SandboxRef } from "@/chat/sandbox/ref";
-import type { SandboxWorkspace } from "@/chat/sandbox/workspace";
+import { type SandboxWorkspace } from "@/chat/sandbox/workspace";
 import type { SkillMetadata } from "@/chat/skills";
 export interface SandboxToolCall {
     toolName: string;
@@ -18,6 +18,7 @@ export interface SandboxAccess {
     readonly tools: SandboxTools;
     readonly workspace: SandboxWorkspace;
     sandboxRef(): SandboxRef | undefined;
+    close(): void;
 }
 export interface SandboxOptions {
     sandboxRef?: SandboxRef;

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

@@ -19,24 +19,15 @@ interface SandboxToolExecutors {
         aborted?: boolean;
         timedOut?: boolean;
     }>;
-    readFile: (input: {
-        path: string;
-    }) => Promise<{
-        content: string;
-    }>;
-    writeFile: (input: {
-        path: string;
-        content: string;
-    }) => Promise<{
-        success: boolean;
-    }>;
     fs: SandboxFileSystem;
+    runCommand: SandboxSession["runCommand"];
 }
 interface SandboxRuntime {
     sandboxRef(): SandboxRef | undefined;
     acquire(): Promise<SandboxSession>;
     tools(): Promise<SandboxToolExecutors>;
     refreshNetworkPolicy(traceHeaders?: TracePropagationHeaders): Promise<void>;
+    close(): void;
 }
 interface SandboxRuntimeOptions {
     sandboxRef?: SandboxRef;

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

@@ -18,13 +18,21 @@ export interface SandboxFileStat {
 export interface SandboxFileSystem {
     readFile(filePath: string, options: {
         encoding: BufferEncoding;
+        signal?: AbortSignal;
     }): Promise<string>;
     writeFile(filePath: string, content: string, options?: {
         encoding?: BufferEncoding;
+        signal?: AbortSignal;
     }): Promise<void>;
-    readdir(filePath: string): Promise<string[]>;
-    stat(filePath: string): Promise<SandboxFileStat>;
+    readdir(filePath: string, options?: {
+        signal?: AbortSignal;
+    }): Promise<string[]>;
+    stat(filePath: string, options?: {
+        signal?: AbortSignal;
+    }): Promise<SandboxFileStat>;
 }
+/** Bind one tool call's cancellation to every sandbox filesystem operation. */
+export declare function bindSandboxFileSystem(fs: SandboxFileSystem, signal?: AbortSignal): SandboxFileSystem;
 export interface SandboxWorkspace {
     readFileToBuffer(input: {
         cwd?: string;

package/dist/chat/services/turn-session-record.d.ts

@@ -1,4 +1,4 @@
-import { type AgentTurnSessionRecord, type AgentTurnSurface } from "@/chat/state/turn-session";
+import { type AgentDispatchOutcome, type AgentTurnSessionRecord, type AgentTurnSurface } from "@/chat/state/turn-session";
 import type { ConversationPrivacy } from "@/chat/conversation-privacy";
 import type { Destination, Actor, Source } from "@sentry/junior-plugin-api";
 import type { PiMessage } from "@/chat/pi/messages";
@@ -27,6 +27,7 @@ export declare function persistRunningSessionRecord(args: {
     channelName?: string;
     conversationId: string;
     destination?: Destination;
+    dispatchId?: string;
     source?: Source;
     sessionId: string;
     sliceId: number;
@@ -56,8 +57,13 @@ export declare function persistCompletedSessionRecord(args: {
     currentDurationMs?: number;
     currentUsage?: AgentTurnUsage;
     destination?: Destination;
+    dispatchId?: string;
+    dispatchOutcome?: AgentDispatchOutcome;
+    errorMessage?: string;
     /** Source-confirmed destination visibility from the current event's signal. */
     destinationVisibility?: ConversationPrivacy;
+    /** Provider-owned identifier returned after visible delivery is accepted. */
+    resultMessageId?: string;
     source?: Source;
     sessionId: string;
     /** Defaults to the latest stored slice when the deliverer does not know it. */
@@ -76,12 +82,16 @@ export declare function completeDeliveredTurn(args: {
     conversationId: string;
     destination: Destination;
     destinationVisibility?: ConversationPrivacy;
+    dispatchId?: string;
+    dispatchOutcome?: AgentDispatchOutcome;
+    errorMessage?: string;
     durationMs?: number;
     loadedSkillNames?: string[];
     messages: PiMessage[];
     modelId: string;
     actor?: Actor;
     reasoningLevel?: string;
+    resultMessageId?: string;
     sessionId: string;
     sliceId: number;
     source: Source;
@@ -101,6 +111,7 @@ export declare function persistAuthPauseSessionRecord(args: {
     currentDurationMs?: number;
     currentUsage?: AgentTurnUsage;
     destination?: Destination;
+    dispatchId?: string;
     source?: Source;
     messages: PiMessage[];
     loadedSkillNames?: string[];
@@ -119,6 +130,7 @@ interface ContinuationRecordInput {
     currentDurationMs?: number;
     currentUsage?: AgentTurnUsage;
     destination?: Destination;
+    dispatchId?: string;
     source?: Source;
     messages: PiMessage[];
     loadedSkillNames?: string[];
@@ -144,6 +156,7 @@ export declare function persistYieldSessionRecord(args: {
     currentDurationMs?: number;
     currentUsage?: AgentTurnUsage;
     destination?: Destination;
+    dispatchId?: string;
     source?: Source;
     messages: PiMessage[];
     loadedSkillNames?: string[];

package/dist/chat/slack/dispatch-turn.d.ts

@@ -0,0 +1,25 @@
+import { Message, ThreadImpl } from "chat";
+import type { SlackAdapter } from "@chat-adapter/slack";
+import type { DispatchTurnContext, DispatchTurnResult } from "@/chat/agent-dispatch/types";
+import type { DispatchRecord } from "@/chat/agent-dispatch/types";
+interface DispatchReplyToThread {
+    (thread: ThreadImpl, message: Message, options: {
+        ack?: () => Promise<void>;
+        destination: DispatchRecord["destination"];
+        execution: DispatchTurnContext;
+        onTurnDeliveryAccepted?: (messageId?: string) => void;
+        onTurnOutcome?: (result: DispatchTurnResult) => void;
+        shouldYield?: () => boolean;
+        skipBackfill?: boolean;
+    }): Promise<void>;
+}
+/** Build the Slack provider adapter for plugin-dispatched conversation turns. */
+export declare function createSlackDispatchTurnRunner(options: {
+    getChannelConfiguration: (channelId: string) => DispatchTurnContext["channelConfiguration"];
+    getSlackAdapter: () => SlackAdapter;
+    replyToThread: DispatchReplyToThread;
+}): (dispatch: DispatchRecord, hooks: {
+    ack: () => Promise<void>;
+    shouldYield?: () => boolean;
+}) => Promise<DispatchTurnResult>;
+export {};

package/dist/chat/state/turn-session.d.ts

@@ -18,6 +18,7 @@ import type { ConversationStore } from "@/chat/conversations/store";
 export type AgentTurnSessionStatus = "running" | "awaiting_resume" | "completed" | "failed" | "abandoned";
 export type AgentTurnSurface = "slack" | "api" | "scheduler" | "internal";
 export type AgentTurnResumeReason = "timeout" | "auth" | "yield" | "retry";
+export type AgentDispatchOutcome = "blocked" | "completed" | "failed";
 export interface AgentTurnSessionRecord {
     channelName?: string;
     version: number;
@@ -25,6 +26,10 @@ export interface AgentTurnSessionRecord {
     cumulativeDurationMs: number;
     cumulativeUsage?: AgentTurnUsage;
     destination?: Destination;
+    dispatchId?: string;
+    dispatchOutcome?: AgentDispatchOutcome;
+    /** Provider-owned identifier returned after visible delivery is accepted. */
+    resultMessageId?: string;
     source?: Source;
     errorMessage?: string;
     lastProgressAtMs: number;
@@ -66,6 +71,9 @@ export declare function upsertAgentTurnSessionRecord(args: {
     cumulativeDurationMs?: number;
     cumulativeUsage?: AgentTurnUsage;
     destination?: Destination;
+    dispatchId?: string;
+    dispatchOutcome?: AgentDispatchOutcome;
+    resultMessageId?: string;
     /** Source-confirmed destination visibility from the current event's signal. */
     destinationVisibility?: ConversationPrivacy;
     source?: Source;
@@ -97,6 +105,9 @@ export declare function recordAgentTurnSessionSummary(args: {
     cumulativeDurationMs?: number;
     cumulativeUsage?: AgentTurnUsage;
     destination?: Destination;
+    dispatchId?: string;
+    dispatchOutcome?: AgentDispatchOutcome;
+    resultMessageId?: string;
     /**
      * Source-confirmed destination visibility from the current event's signal
      * (Slack `channel_type`). Leave unset when no live signal exists so an

package/dist/chat/tool-support/text-range-result.d.ts

@@ -13,8 +13,11 @@ interface TextRangeResult {
             path: string;
             start_line: number;
             total_lines: number;
+            truncation_reasons?: string[];
         };
         truncated: boolean;
+        character_limit_reached?: number;
+        line_truncated?: boolean;
         continuation?: {
             arguments: {
                 offset: number;

package/dist/chat/tool-support/zod-tool.d.ts

@@ -3,6 +3,7 @@ import { type JuniorToolResult } from "@/chat/tool-support/structured-result";
 import type { ImageContent, TextContent } from "@earendil-works/pi-ai";
 import type { AnyToolDefinition, JsonSchemaObject, ToolExecuteOptions } from "@/chat/tools/definition";
 type ZodToolDefinitionBase<TInputSchema extends ZodTypeAny> = Pick<AnyToolDefinition, "approvalMode" | "identity" | "source" | "description" | "exposure" | "annotations" | "promptSnippet" | "promptGuidelines" | "executionMode"> & {
+    describeProposal?(input: z.output<TInputSchema>): string;
     inputSchema: TInputSchema;
     prepareArguments?: (args: unknown) => z.input<TInputSchema>;
 };

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

@@ -1,7 +1,6 @@
-import type { ToolAnnotations } from "@modelcontextprotocol/sdk/types.js";
 import { type Static, type TSchema } from "@sinclair/typebox";
 import type { ToolExecutionMode } from "@earendil-works/pi-agent-core";
-import type { ToolApprovalMode } from "@sentry/junior-plugin-api";
+import type { ToolApprovalMetadata } from "@sentry/junior-plugin-api";
 import type { ConversationPrivacy } from "@/chat/conversation-privacy";
 /**
  * Tool definition boundary for Pi-facing agent tools.
@@ -17,9 +16,7 @@ export interface ToolExecuteOptions {
     conversationPrivacy?: ConversationPrivacy;
     toolCallId?: string;
 }
-interface BaseToolDefinition<TInput, TInputSchema extends ToolInputSchema> {
-    /** Optional declared approval mode; omission delegates to core defaults. */
-    approvalMode?: ToolApprovalMode;
+interface BaseToolDefinition<TInput, TInputSchema extends ToolInputSchema> extends ToolApprovalMetadata<TInput> {
     /** Stable internal owner-qualified identity for plugin-contributed tools. */
     identity?: {
         id: string;
@@ -36,7 +33,6 @@ interface BaseToolDefinition<TInput, TInputSchema extends ToolInputSchema> {
     inputSchema: TInputSchema;
     outputSchema?: ToolInputSchema;
     privateTraceResult?(result: unknown): unknown;
-    annotations?: ToolAnnotations;
     /**
      * @deprecated Put tool-selection and usage guidance directly in `description`
      * and parameter descriptions. Retained for plugin compatibility; may be
@@ -58,9 +54,7 @@ export interface ToolDefinition<TInputSchema extends TSchema = TSchema> extends
 /**
  * Schema-erased view for heterogeneous registries after Pi validates tool input.
  */
-export interface AnyToolDefinition {
-    /** Optional declared approval mode; omission delegates to core defaults. */
-    approvalMode?: ToolApprovalMode;
+export interface AnyToolDefinition extends ToolApprovalMetadata {
     /** Stable internal owner-qualified identity for plugin-contributed tools. */
     identity?: {
         id: string;
@@ -77,7 +71,6 @@ export interface AnyToolDefinition {
     inputSchema: ToolInputSchema;
     outputSchema?: ToolInputSchema;
     privateTraceResult?(result: unknown): unknown;
-    annotations?: ToolAnnotations;
     /**
      * @deprecated Put tool-selection and usage guidance directly in `description`
      * and parameter descriptions. Retained for plugin compatibility; may be

package/dist/chat/tools/query-conversation-events.d.ts

@@ -0,0 +1,68 @@
+import { type KnownConversationEventType } from "@/chat/conversations/history";
+import type { ToolRuntimeContext } from "@/chat/tools/types";
+/** Create a deferred tool that returns a bounded raw conversation event page. */
+export declare function createQueryConversationEventsTool(context: ToolRuntimeContext): Omit<import("./definition").AnyToolDefinition, "inputSchema" | "outputSchema" | "prepareArguments" | "execute"> & {
+    inputSchema: import("./definition").JsonSchemaObject;
+    outputSchema: import("./definition").JsonSchemaObject;
+    prepareArguments(args: unknown): {
+        conversation_id: string;
+        after_seq?: number | null | undefined;
+        before_seq?: number | null | undefined;
+        limit?: number | null | undefined;
+        types?: ("message" | "handoff" | "user_message" | "assistant_message" | "tool_result" | "compaction" | "mcp_provider_connected" | "authorization_requested" | "authorization_completed" | "tool_execution_started" | "message_updated" | "message_handled" | "messages_summarized" | "turn_started" | "turn_routed" | "turn_completed" | "turn_failed" | "subagent_started" | "subagent_ended")[] | null | undefined;
+    };
+    execute?: ((input: unknown, options: import("./definition").ToolExecuteOptions) => {
+        [x: string]: unknown;
+        ok: boolean;
+        status: "error" | "success";
+        conversation_id: string;
+        events: {
+            seq: number;
+            history_version: number;
+            created_at: string;
+            data: Record<string, unknown>;
+            idempotency_key?: string | undefined;
+        }[];
+        has_older: boolean;
+        has_newer: boolean;
+        target?: string | undefined;
+        data?: unknown;
+        truncated?: boolean | undefined;
+        continuation?: {
+            arguments: Record<string, unknown>;
+            reason?: string | undefined;
+        } | undefined;
+        error?: string | {
+            kind: string;
+            message: string;
+            retryable?: boolean | undefined;
+        } | undefined;
+    } | Promise<{
+        [x: string]: unknown;
+        ok: boolean;
+        status: "error" | "success";
+        conversation_id: string;
+        events: {
+            seq: number;
+            history_version: number;
+            created_at: string;
+            data: Record<string, unknown>;
+            idempotency_key?: string | undefined;
+        }[];
+        has_older: boolean;
+        has_newer: boolean;
+        target?: string | undefined;
+        data?: unknown;
+        truncated?: boolean | undefined;
+        continuation?: {
+            arguments: Record<string, unknown>;
+            reason?: string | undefined;
+        } | undefined;
+        error?: string | {
+            kind: string;
+            message: string;
+            retryable?: boolean | undefined;
+        } | undefined;
+    }>) | undefined;
+};
+export type { KnownConversationEventType };

package/dist/chat/tools/sandbox/file-utils.d.ts

@@ -1,6 +1,8 @@
-import type { SandboxFileSystem } from "@/chat/sandbox/workspace";
+import type { SandboxCommandInput, SandboxCommandResult, SandboxFileSystem } from "@/chat/sandbox/workspace";
 export type { SandboxFileSystem };
+export type SandboxCommandRunner = (input: SandboxCommandInput) => Promise<SandboxCommandResult>;
 export declare const MAX_TEXT_CHARS = 60000;
+export declare const RIPGREP_EXCLUDED_GLOBS: readonly ["!**/.git/**", "!**/node_modules/**"];
 export type TextSearchResultDetails = {
     ok: true;
     status?: "success";
@@ -47,6 +49,11 @@ export declare function missingPathSearchResult(params: {
 }): TextSearchToolResult;
 /** Keep sandbox filesystem tools scoped to the mounted workspace root. */
 export declare function resolveWorkspacePath(input: string | undefined, fallback?: string): string;
+/** Anchor ripgrep paths and globs to the requested search root. */
+export declare function getRipgrepSearchLocation(root: string, rootIsDirectory: boolean): {
+    cwd: string;
+    target: string;
+};
 /** Share bounded workspace traversal across search tools so their skip rules stay aligned. */
 export declare function collectFiles(params: {
     fs: SandboxFileSystem;

package/dist/chat/tools/sandbox/find-files.d.ts

@@ -1,4 +1,4 @@
-import { type SandboxFileSystem, type TextSearchResultDetails, type TextSearchToolResult } from "@/chat/tools/sandbox/file-utils";
+import { type SandboxCommandRunner, type SandboxFileSystem, type TextSearchResultDetails, type TextSearchToolResult } from "@/chat/tools/sandbox/file-utils";
 import { type JuniorToolResultEnvelope } from "@/chat/tool-support/structured-result";
 interface FindFilesSuccessResult {
     content: JuniorToolResultEnvelope["content"];
@@ -19,6 +19,7 @@ export declare function findFiles(params: {
     limit?: unknown;
     path?: string;
     pattern: string;
+    runCommand?: SandboxCommandRunner;
 }): Promise<FindFilesResult>;
 /** Create the sandbox file discovery tool definition exposed to the agent. */
 export declare function createFindFilesTool(): Omit<import("../definition").AnyToolDefinition, "inputSchema" | "outputSchema" | "prepareArguments" | "execute"> & {

package/dist/chat/tools/sandbox/grep.d.ts

@@ -1,4 +1,4 @@
-import { type SandboxFileSystem, type TextSearchResultDetails, type TextSearchToolResult } from "@/chat/tools/sandbox/file-utils";
+import { type SandboxCommandRunner, type SandboxFileSystem, type TextSearchResultDetails, type TextSearchToolResult } from "@/chat/tools/sandbox/file-utils";
 interface GrepResultData {
     context: number;
     glob?: string;
@@ -33,6 +33,7 @@ export declare function grepFiles(params: {
     literal?: boolean;
     path?: string;
     pattern: string;
+    runCommand?: SandboxCommandRunner;
 }): Promise<GrepResult>;
 /** Create the sandbox grep tool definition exposed to the agent. */
 export declare function createGrepTool(): Omit<import("../definition").AnyToolDefinition, "inputSchema" | "outputSchema" | "prepareArguments" | "execute"> & {

package/dist/{chunk-6V762AB4.js → chunk-2YYPXQNQ.js}

@@ -1,6 +1,6 @@
 import {
   pluginCatalogRuntime
-} from "./chunk-6FKLPVF3.js";
+} from "./chunk-OY2PQQ4P.js";
 
 // src/chat/plugins/validation.ts
 import { isDeepStrictEqual } from "util";

package/dist/{chunk-MIAKQNYX.js → chunk-6ZK6FZIV.js}

@@ -1,6 +1,6 @@
 import {
   createVercelQueueClient
-} from "./chunk-KNFROR7R.js";
+} from "./chunk-5I6ORJUY.js";
 
 // src/chat/task-execution/queue-signing.ts
 import { createHmac, timingSafeEqual } from "crypto";

package/dist/{chunk-67CVNDJ7.js → chunk-7CSVG54J.js}

@@ -1,6 +1,6 @@
 import {
   getChatConfig
-} from "./chunk-SYJT7AKB.js";
+} from "./chunk-CY7NXM32.js";
 
 // src/chat/state/adapter.ts
 import { createMemoryState } from "@chat-adapter/state-memory";