@sentry/junior 0.114.0 → 0.116.0

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

@@ -2,7 +2,8 @@ import { z, type ZodType, type ZodTypeAny } from "zod";
 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, "identity" | "source" | "description" | "exposure" | "annotations" | "promptSnippet" | "promptGuidelines" | "executionMode"> & {
+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,6 +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 { ToolApprovalMetadata } from "@sentry/junior-plugin-api";
 import type { ConversationPrivacy } from "@/chat/conversation-privacy";
 /**
  * Tool definition boundary for Pi-facing agent tools.
@@ -16,7 +16,7 @@ export interface ToolExecuteOptions {
     conversationPrivacy?: ConversationPrivacy;
     toolCallId?: string;
 }
-interface BaseToolDefinition<TInput, TInputSchema extends ToolInputSchema> {
+interface BaseToolDefinition<TInput, TInputSchema extends ToolInputSchema> extends ToolApprovalMetadata<TInput> {
     /** Stable internal owner-qualified identity for plugin-contributed tools. */
     identity?: {
         id: string;
@@ -33,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
@@ -55,7 +54,7 @@ export interface ToolDefinition<TInputSchema extends TSchema = TSchema> extends
 /**
  * Schema-erased view for heterogeneous registries after Pi validates tool input.
  */
-export interface AnyToolDefinition {
+export interface AnyToolDefinition extends ToolApprovalMetadata {
     /** Stable internal owner-qualified identity for plugin-contributed tools. */
     identity?: {
         id: string;
@@ -72,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-OSKEC4XU.js → chunk-25GU5B5E.js}

@@ -1,6 +1,6 @@
 import {
   createPluginCatalogRuntime
-} from "./chunk-K2W4CK7K.js";
+} from "./chunk-JZPQ5K4V.js";
 
 // src/chat/plugins/catalog-runtime.ts
 var pluginCatalogRuntime = createPluginCatalogRuntime();

package/dist/{chunk-XLFBQJUO.js → chunk-3H45VOBZ.js}

@@ -1,25 +1,26 @@
 import {
   SANDBOX_WORKSPACE_ROOT,
   getStateAdapter
-} from "./chunk-YU6PO42Q.js";
+} from "./chunk-53ZKTQO6.js";
 import {
   sleep
 } from "./chunk-4ZNGQH7C.js";
 import {
   toOptionalTrimmed
-} from "./chunk-ZGXH3REA.js";
+} from "./chunk-PZGPCOSD.js";
 import {
   pluginCatalogRuntime
-} from "./chunk-OSKEC4XU.js";
+} from "./chunk-25GU5B5E.js";
 import {
   setSpanAttributes,
   setSpanStatus,
   withSpan
-} from "./chunk-4FUEG3QY.js";
+} from "./chunk-3JOGUT46.js";
 
 // src/chat/sandbox/runtime-dependencies.ts
 var GLOBAL_RUNTIME_DEPENDENCIES = [
-  { type: "system", package: "docker" }
+  { type: "system", package: "docker" },
+  { type: "system", package: "ripgrep" }
 ];
 
 // src/chat/sandbox/runtime-dependency-snapshots.ts
@@ -344,6 +345,29 @@ function throwSandboxOperationError(action, error, includeMissingPath = false) {
 }
 
 // src/chat/sandbox/workspace.ts
+function bindSandboxFileSystem(fs, signal) {
+  if (!signal) {
+    return fs;
+  }
+  return {
+    readFile(filePath, options) {
+      signal.throwIfAborted();
+      return fs.readFile(filePath, { ...options, signal });
+    },
+    writeFile(filePath, content, options) {
+      signal.throwIfAborted();
+      return fs.writeFile(filePath, content, { ...options, signal });
+    },
+    readdir(filePath) {
+      signal.throwIfAborted();
+      return fs.readdir(filePath, { signal });
+    },
+    stat(filePath) {
+      signal.throwIfAborted();
+      return fs.stat(filePath, { signal });
+    }
+  };
+}
 function createSandboxSession(sandbox, options) {
   const session = sandbox.currentSession();
   const fileSystem = new FileSystem(session);
@@ -362,8 +386,8 @@ function createSandboxSession(sandbox, options) {
     writeFile: async (filePath, content, writeOptions) => await run(
       async () => await fileSystem.writeFile(filePath, content, writeOptions)
     ),
-    readdir: async (filePath) => await run(async () => await fileSystem.readdir(filePath)),
-    stat: async (filePath) => await run(async () => await fileSystem.stat(filePath))
+    readdir: async (filePath, readOptions) => await run(async () => await fileSystem.readdir(filePath, readOptions)),
+    stat: async (filePath, statOptions) => await run(async () => await fileSystem.stat(filePath, statOptions))
   };
   return {
     sandboxId: sandbox.name,
@@ -977,6 +1001,7 @@ export {
   runNonInteractiveCommand,
   getSandboxResources,
   GLOBAL_RUNTIME_DEPENDENCIES,
+  bindSandboxFileSystem,
   createSandboxSession,
   getRuntimeDependencyProfileHash,
   resolveRuntimeDependencySnapshot,

package/dist/{chunk-4FUEG3QY.js → chunk-3JOGUT46.js}

@@ -1,7 +1,7 @@
 import {
   toOptionalNumber,
   toOptionalString
-} from "./chunk-42WRQLJ6.js";
+} from "./chunk-OB42YVAE.js";
 import {
   captureException,
   getActiveSpan,
@@ -13,7 +13,7 @@ import {
 } from "./chunk-6GWA276C.js";
 import {
   getDeploymentTelemetryAttributes
-} from "./chunk-5CZ7RETL.js";
+} from "./chunk-N7TMYLF2.js";
 
 // src/chat/logging.ts
 import path from "path";
@@ -186,11 +186,7 @@ var CONSOLE_ALWAYS_HIDDEN_KEYS = /* @__PURE__ */ new Set([
   "url.path",
   "user_agent.original"
 ]);
-var CONSOLE_DROP_WHEN_COUNTED_KEYS = /* @__PURE__ */ new Set([
-  "app.capability.names",
-  "app.capability.providers",
-  "app.config.keys"
-]);
+var CONSOLE_DROP_WHEN_COUNTED_KEYS = /* @__PURE__ */ new Set(["app.config.keys"]);
 var CONSOLE_PREVIEW_KEYS = /* @__PURE__ */ new Set([
   "gen_ai.input.messages",
   "gen_ai.output.messages",
@@ -677,7 +673,7 @@ function booleanConsoleToken(label, value) {
   return typeof value === "boolean" ? `${label}=${value ? "yes" : "no"}` : void 0;
 }
 function shouldShowPrettyCorrelation(eventName) {
-  return !(eventName === "plugin_loaded" || eventName === "startup_discovery_summary" || eventName === "capability_catalog_loaded" || eventName.endsWith("_loaded"));
+  return !(eventName === "plugin_loaded" || eventName === "startup_discovery_summary" || eventName.endsWith("_loaded"));
 }
 function getPrettyConsoleSummaryTokens(level, eventName, attributes) {
   const tokens = [];
@@ -689,10 +685,6 @@ function getPrettyConsoleSummaryTokens(level, eventName, attributes) {
     tokens,
     eventName.startsWith("plugin_heartbeat") ? stringConsoleToken("plugin", attributes["app.plugin.name"]) : toOptionalString(attributes["app.plugin.name"]) ?? void 0
   );
-  pushPrettyConsoleToken(
-    tokens,
-    numericConsoleToken("caps", attributes["app.plugin.capability_count"])
-  );
   pushPrettyConsoleToken(
     tokens,
     numericConsoleToken("config", attributes["app.plugin.config_key_count"])
@@ -713,10 +705,6 @@ function getPrettyConsoleSummaryTokens(level, eventName, attributes) {
     tokens,
     numericConsoleToken("skills", attributes["app.skill.count"])
   );
-  pushPrettyConsoleToken(
-    tokens,
-    numericConsoleToken("capabilities", attributes["app.capability.count"])
-  );
   pushPrettyConsoleToken(
     tokens,
     numericConsoleToken("config", attributes["app.config.key_count"])

package/dist/chunk-4CODA7P5.js

@@ -0,0 +1,43 @@
+import {
+  getClient
+} from "./chunk-6GWA276C.js";
+
+// src/chat/sentry-links.ts
+function getSentryOrgSlug() {
+  const slug = process.env.SENTRY_ORG_SLUG?.trim();
+  return slug || void 0;
+}
+function isSentrySaasDsnHost(host) {
+  return host === "sentry.io" || host.endsWith(".sentry.io");
+}
+function buildSentryWebBaseUrl(dsn) {
+  if (isSentrySaasDsnHost(dsn.host)) {
+    return "https://sentry.io";
+  }
+  const port = dsn.port ? `:${dsn.port}` : "";
+  const path = dsn.path ? `/${dsn.path}` : "";
+  return `${dsn.protocol}://${dsn.host}${port}${path}`;
+}
+function buildSentryConversationUrl(conversationId) {
+  const client = getClient();
+  const dsn = client?.getDsn();
+  if (!dsn?.host || !dsn.projectId) {
+    return void 0;
+  }
+  const orgSlug = getSentryOrgSlug();
+  if (!orgSlug) {
+    return void 0;
+  }
+  const encodedId = encodeURIComponent(conversationId);
+  const params = new URLSearchParams();
+  params.set("project", dsn.projectId);
+  const path = `explore/conversations/${encodedId}/?${params.toString()}`;
+  if (isSentrySaasDsnHost(dsn.host)) {
+    return `https://${orgSlug}.sentry.io/${path}`;
+  }
+  return `${buildSentryWebBaseUrl(dsn)}/organizations/${orgSlug}/${path}`;
+}
+
+export {
+  buildSentryConversationUrl
+};

package/dist/{chunk-O4GT7LYB.js → chunk-4DD6AOCG.js}

@@ -1,15 +1,12 @@
 import {
   healthReportSchema
-} from "./chunk-2ZTTXTSZ.js";
+} from "./chunk-PE44LDDQ.js";
 import {
   normalizeSlackConversationId
-} from "./chunk-RD7EJI7H.js";
+} from "./chunk-CI3VK7X5.js";
 import {
   parseSlackThreadId
-} from "./chunk-6Y5L4BOM.js";
-import {
-  getClient
-} from "./chunk-6GWA276C.js";
+} from "./chunk-FXOYURO4.js";
 
 // src/handlers/health.ts
 function readHealthReport() {
@@ -23,42 +20,6 @@ function GET() {
   return Response.json(readHealthReport());
 }
 
-// src/chat/sentry-links.ts
-function getSentryOrgSlug() {
-  const slug = process.env.SENTRY_ORG_SLUG?.trim();
-  return slug || void 0;
-}
-function isSentrySaasDsnHost(host) {
-  return host === "sentry.io" || host.endsWith(".sentry.io");
-}
-function buildSentryWebBaseUrl(dsn) {
-  if (isSentrySaasDsnHost(dsn.host)) {
-    return "https://sentry.io";
-  }
-  const port = dsn.port ? `:${dsn.port}` : "";
-  const path = dsn.path ? `/${dsn.path}` : "";
-  return `${dsn.protocol}://${dsn.host}${port}${path}`;
-}
-function buildSentryConversationUrl(conversationId) {
-  const client = getClient();
-  const dsn = client?.getDsn();
-  if (!dsn?.host || !dsn.projectId) {
-    return void 0;
-  }
-  const orgSlug = getSentryOrgSlug();
-  if (!orgSlug) {
-    return void 0;
-  }
-  const encodedId = encodeURIComponent(conversationId);
-  const params = new URLSearchParams();
-  params.set("project", dsn.projectId);
-  const path = `explore/conversations/${encodedId}/?${params.toString()}`;
-  if (isSentrySaasDsnHost(dsn.host)) {
-    return `https://${orgSlug}.sentry.io/${path}`;
-  }
-  return `${buildSentryWebBaseUrl(dsn)}/organizations/${orgSlug}/${path}`;
-}
-
 // src/chat/slack/conversation-context.ts
 function normalizeConversationName(type, channelName) {
   const trimmed = channelName?.trim();
@@ -144,7 +105,6 @@ function formatSlackConversationRedactedLabel(context) {
 export {
   readHealthReport,
   GET,
-  buildSentryConversationUrl,
   conversationVisibilityFromSlackChannelType,
   resolveSlackChannelTypeFromMessage,
   resolveSlackConversationContext,

package/dist/{chunk-YU6PO42Q.js → chunk-53ZKTQO6.js}

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