@mrclrchtr/supi-debug 11.4.0 → 12.0.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## [12.0.0]
+
+- **Breaking:** `debug` rejects unknown parameters instead of ignoring them, and `limit` must be at least 1.
+- The `level` and `operationId` schemas no longer send a stray `~optional` keyword to the provider.
+- Codemode now lists the `debug` tool under a `debug` namespace heading, so scripts can find them with `describeNamespace("debug")` or `searchTools(query, { namespace: "debug" })`. It is annotated read-only ([#582](https://github.com/mrclrchtr/supi/issues/582)).
+
 ## [11.4.0]
 
 - With Debug capture enabled, each session start, reload, resume, or fork records a `runtime-provenance` event with the package version and, when SuPi runs from its own Git checkout, the commit, commit time, and whether tracked files had uncommitted changes.

package/node_modules/@mrclrchtr/supi-core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mrclrchtr/supi-core",
-  "version": "11.4.0",
+  "version": "12.0.0",
   "description": "Shared settings, configuration, reporting, and session infrastructure",
   "license": "MIT",
   "repository": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mrclrchtr/supi-debug",
-  "version": "11.4.0",
+  "version": "12.0.0",
   "description": "Capture and inspect SuPi debug events",
   "license": "MIT",
   "repository": {
@@ -35,7 +35,7 @@
     "README.md"
   ],
   "dependencies": {
-    "@mrclrchtr/supi-core": "11.4.0"
+    "@mrclrchtr/supi-core": "12.0.0"
   },
   "bundledDependencies": [
     "@mrclrchtr/supi-core"

package/src/tool/debug/register.ts

@@ -1,4 +1,5 @@
 import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+import { DEBUG_TOOL_NAMESPACE } from "../namespace.ts";
 import { promptGuidelines, promptSnippet, toolDescription } from "./guidance.ts";
 import { renderDebugToolCall, renderDebugToolResult } from "./render.ts";
 import { debugSpec } from "./spec.ts";
@@ -7,6 +8,7 @@ import { debugSpec } from "./spec.ts";
 export function registerDebugTool(pi: ExtensionAPI): void {
   pi.registerTool({
     ...debugSpec,
+    namespace: DEBUG_TOOL_NAMESPACE,
     description: toolDescription,
     promptSnippet,
     promptGuidelines,

package/src/tool/debug/spec.ts

@@ -1,3 +1,4 @@
+import type { DebugLevel } from "@mrclrchtr/supi-core/debug";
 import { Type } from "typebox";
 import { makeDebugExecute } from "./execute.ts";
 import { debugLevelSchema, debugOperationIdSchema } from "./input.ts";
@@ -10,22 +11,37 @@ export const DEBUG_TOOL_LABEL = "SuPi Debug";
 export const debugSpec = {
   name: DEBUG_TOOL_NAME,
   label: DEBUG_TOOL_LABEL,
-  parameters: Type.Object({
-    operationId: Type.Optional({
-      ...debugOperationIdSchema,
-      description: "Filter by exact Debug Operation ID",
-    }),
-    source: Type.Optional(Type.String({ description: "Filter by extension source, e.g. lsp" })),
-    level: Type.Optional({ ...debugLevelSchema, description: "Filter by debug level" }),
-    category: Type.Optional(Type.String({ description: "Filter by event category" })),
-    limit: Type.Optional(Type.Number({ description: "Maximum number of events to return" })),
-    sessionFile: Type.Optional(
-      Type.String({ description: "PI session JSONL file containing persisted debug events" }),
-    ),
-    includeRaw: Type.Optional(
-      Type.Boolean({ description: "Request raw event data when settings permit it" }),
-    ),
-  }),
+  annotations: {
+    readOnlyHint: true,
+    destructiveHint: false,
+    idempotentHint: true,
+    openWorldHint: false,
+  },
+  parameters: Type.Object(
+    {
+      operationId: Type.Optional(
+        Type.String({
+          ...debugOperationIdSchema,
+          description: "Filter by exact Debug Operation ID",
+        }),
+      ),
+      source: Type.Optional(Type.String({ description: "Filter by extension source, e.g. lsp" })),
+      level: Type.Optional(
+        Type.Unsafe<DebugLevel>({ ...debugLevelSchema, description: "Filter by debug level" }),
+      ),
+      category: Type.Optional(Type.String({ description: "Filter by event category" })),
+      limit: Type.Optional(
+        Type.Integer({ minimum: 1, description: "Maximum number of events to return" }),
+      ),
+      sessionFile: Type.Optional(
+        Type.String({ description: "PI session JSONL file containing persisted debug events" }),
+      ),
+      includeRaw: Type.Optional(
+        Type.Boolean({ description: "Request raw event data when settings permit it" }),
+      ),
+    },
+    { additionalProperties: false },
+  ),
   outputSchema: debugOutputSchema,
   execute: makeDebugExecute(),
 } as const;

package/src/tool/namespace.ts

@@ -0,0 +1,7 @@
+import type { ToolNamespace } from "@earendil-works/pi-coding-agent";
+
+/** Codemode namespace for the SuPi Debug tool. */
+export const DEBUG_TOOL_NAMESPACE: ToolNamespace = {
+  name: "debug",
+  description: "SuPi debug event traces from the live session or a persisted session file.",
+};