@wrongstack/tools 0.296.2 → 0.296.3

package/dist/read.d.ts

@@ -1,9 +1,34 @@
 import { type Tool } from '@wrongstack/core/types';
+import type { SymbolKind } from './codebase-index/schema.js';
 interface ReadInput {
     path: string;
     offset?: number | undefined;
     limit?: number | undefined;
     mode?: 'content' | 'summary' | undefined;
+    /**
+     * When true, include the codebase-index symbol list for this file
+     * as a structured `symbols` field in the result. Overrides the
+     * advanced-mode meta flag (`ctx.meta['tools.read.advancedMode']`)
+     * per-call when explicitly set. When omitted, the meta flag governs.
+     */
+    includeSymbols?: boolean | undefined;
+}
+/**
+ * A single indexed code symbol returned alongside file content when
+ * advanced mode is on or `includeSymbols` is set. The LLM must treat
+ * this as a symbol listing — not as file content.
+ */
+interface SymbolEntry {
+    /** Symbol name (e.g. myFunction, MyClass). */
+    name: string;
+    /** Kind of symbol (function, class, interface, const, etc.). */
+    kind: SymbolKind;
+    /** 1-based declaration line in the file. */
+    line: number;
+    /** 0-based column offset. */
+    col: number;
+    /** Full signature or declaration text. */
+    signature: string;
 }
 interface ReadOutput {
     text: string;
@@ -12,6 +37,12 @@ interface ReadOutput {
     truncated: boolean;
     cached?: boolean | undefined;
     note?: string | undefined;
+    /**
+     * Codebase-index symbols for this file, included when advanced mode
+     * is active or `includeSymbols` is set. One entry per indexed symbol,
+     * sorted by line number. This is a symbol listing — NOT file content.
+     */
+    symbols?: SymbolEntry[] | undefined;
 }
 export declare const readTool: Tool<ReadInput, ReadOutput>;
 export {};

package/dist/read.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"read.d.ts","sourceRoot":"","sources":["../src/read.ts"],"names":[],"mappings":"AACA,OAAO,EAAgC,KAAK,IAAI,EAAE,MAAM,wBAAwB,CAAC;AAIjF,UAAU,SAAS;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,IAAI,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;CAC1C;AAED,UAAU,UAAU;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC7B,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3B;AAID,eAAO,MAAM,QAAQ,EAAE,IAAI,CAAC,SAAS,EAAE,UAAU,CAuLhD,CAAC"}
+{"version":3,"file":"read.d.ts","sourceRoot":"","sources":["../src/read.ts"],"names":[],"mappings":"AACA,OAAO,EAAW,KAAK,IAAI,EAAuB,MAAM,wBAAwB,CAAC;AAIjF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAY7D,UAAU,SAAS;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,IAAI,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;IACzC;;;;;OAKG;IACH,cAAc,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACtC;AAED;;;;GAIG;AACH,UAAU,WAAW;IACnB,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAC;IACb,gEAAgE;IAChE,IAAI,EAAE,UAAU,CAAC;IACjB,4CAA4C;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,6BAA6B;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,0CAA0C;IAC1C,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,UAAU,UAAU;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC7B,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B;;;;OAIG;IACH,OAAO,CAAC,EAAE,WAAW,EAAE,GAAG,SAAS,CAAC;CACrC;AAID,eAAO,MAAM,QAAQ,EAAE,IAAI,CAAC,SAAS,EAAE,UAAU,CAqOhD,CAAC"}