contextsliver 0.1.1

package/dist/parser/languages/python.js

@@ -0,0 +1,14 @@
+// Python language plugin.
+//
+// tree-sitter-python's default export is an object exposing the Language via both the object
+// itself and a .language property (both are accepted by Parser.setLanguage and new Query).
+// We pass the object directly — both setLanguage and Query accept it (verified at build time).
+import Python from 'tree-sitter-python';
+import { loadQuery } from './query-loader.js';
+export const pythonPlugin = {
+    id: 'python',
+    extensions: ['.py', '.pyi'],
+    language: Python,
+    query: loadQuery('python'),
+};
+//# sourceMappingURL=python.js.map

package/dist/parser/languages/python.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"python.js","sourceRoot":"","sources":["../../../src/parser/languages/python.ts"],"names":[],"mappings":"AAAA,0BAA0B;AAC1B,EAAE;AACF,6FAA6F;AAC7F,2FAA2F;AAC3F,+FAA+F;AAC/F,OAAO,MAAM,MAAM,oBAAoB,CAAC;AAExC,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAE9C,MAAM,CAAC,MAAM,YAAY,GAAmB;IAC1C,EAAE,EAAE,QAAQ;IACZ,UAAU,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC;IAC3B,QAAQ,EAAE,MAAM;IAChB,KAAK,EAAE,SAAS,CAAC,QAAQ,CAAC;CAC3B,CAAC"}

package/dist/parser/languages/query-loader.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Load a tags.scm query file from the grammars/ directory.
+ *
+ * Resolves relative to the compiled module location so it works both during development
+ * (src/ → grammars/) and after publish (dist/ → grammars/, since grammars/ is in package.json
+ * "files"). We walk up from the current file to find the package root (the dir containing
+ * grammars/).
+ */
+export declare function loadQuery(languageId: string): string;
+//# sourceMappingURL=query-loader.d.ts.map

package/dist/parser/languages/query-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-loader.d.ts","sourceRoot":"","sources":["../../../src/parser/languages/query-loader.ts"],"names":[],"mappings":"AAMA;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAmBpD"}

package/dist/parser/languages/query-loader.js

@@ -0,0 +1,33 @@
+// Standalone tags.scm loader. Kept separate from registry.ts to avoid a circular import:
+// registry.ts imports the plugin modules, which import loadQuery from here (not from registry).
+import { readFileSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { dirname, resolve } from 'node:path';
+/**
+ * Load a tags.scm query file from the grammars/ directory.
+ *
+ * Resolves relative to the compiled module location so it works both during development
+ * (src/ → grammars/) and after publish (dist/ → grammars/, since grammars/ is in package.json
+ * "files"). We walk up from the current file to find the package root (the dir containing
+ * grammars/).
+ */
+export function loadQuery(languageId) {
+    const here = dirname(fileURLToPath(import.meta.url));
+    // dev:  src/parser/languages/query-loader.ts → ../../../grammars
+    // ship: dist/parser/languages/query-loader.js → ../../../grammars
+    const candidates = [
+        resolve(here, '..', '..', '..', 'grammars', languageId, 'tags.scm'),
+        resolve(here, '..', '..', 'grammars', languageId, 'tags.scm'),
+        resolve(process.cwd(), 'grammars', languageId, 'tags.scm'),
+    ];
+    for (const candidate of candidates) {
+        try {
+            return readFileSync(candidate, 'utf-8');
+        }
+        catch {
+            // try next
+        }
+    }
+    throw new Error(`Could not find grammars/${languageId}/tags.scm (looked in ${candidates.join(', ')})`);
+}
+//# sourceMappingURL=query-loader.js.map

package/dist/parser/languages/query-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-loader.js","sourceRoot":"","sources":["../../../src/parser/languages/query-loader.ts"],"names":[],"mappings":"AAAA,yFAAyF;AACzF,gGAAgG;AAChG,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAE7C;;;;;;;GAOG;AACH,MAAM,UAAU,SAAS,CAAC,UAAkB;IAC1C,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACrD,iEAAiE;IACjE,kEAAkE;IAClE,MAAM,UAAU,GAAG;QACjB,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,CAAC;QACnE,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,CAAC;QAC7D,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,CAAC;KAC3D,CAAC;IACF,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,IAAI,CAAC;YACH,OAAO,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAC1C,CAAC;QAAC,MAAM,CAAC;YACP,WAAW;QACb,CAAC;IACH,CAAC;IACD,MAAM,IAAI,KAAK,CACb,2BAA2B,UAAU,wBAAwB,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CACtF,CAAC;AACJ,CAAC"}

package/dist/parser/languages/registry.d.ts

@@ -0,0 +1,25 @@
+import type { LanguageId } from '../types.js';
+export { loadQuery } from './query-loader.js';
+/** What a language plugin provides. `language` is the tree-sitter Language object (typed loosely). */
+export interface LanguagePlugin {
+    /** short id stored in files.language, e.g. 'typescript' */
+    id: LanguageId;
+    /** file extensions (with leading dot) handled by this plugin */
+    extensions: string[];
+    /** tree-sitter Language object (we accept the native binding shape) */
+    language: any;
+    /** the tags.scm query source */
+    query: string;
+}
+/** All registered plugins, in priority order. */
+export declare const PLUGINS: LanguagePlugin[];
+/**
+ * Resolve a plugin for a file path by its extension, or null if unsupported.
+ * (e.g. 'src/auth/Auth.ts' → typescriptPlugin)
+ */
+export declare function pluginForFile(filePath: string): LanguagePlugin | null;
+/** Get a plugin by its language id. */
+export declare function pluginById(id: LanguageId): LanguagePlugin | undefined;
+/** All supported extensions (for the file watcher / indexer). */
+export declare function supportedExtensions(): string[];
+//# sourceMappingURL=registry.d.ts.map

package/dist/parser/languages/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/parser/languages/registry.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAK9C,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAE9C,sGAAsG;AACtG,MAAM,WAAW,cAAc;IAC7B,2DAA2D;IAC3D,EAAE,EAAE,UAAU,CAAC;IACf,gEAAgE;IAChE,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,uEAAuE;IAEvE,QAAQ,EAAE,GAAG,CAAC;IACd,gCAAgC;IAChC,KAAK,EAAE,MAAM,CAAC;CACf;AAED,iDAAiD;AACjD,eAAO,MAAM,OAAO,EAAE,cAAc,EAAqC,CAAC;AAU1E;;;GAGG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAKrE;AAED,uCAAuC;AACvC,wBAAgB,UAAU,CAAC,EAAE,EAAE,UAAU,GAAG,cAAc,GAAG,SAAS,CAErE;AAED,iEAAiE;AACjE,wBAAgB,mBAAmB,IAAI,MAAM,EAAE,CAE9C"}

package/dist/parser/languages/registry.js

@@ -0,0 +1,33 @@
+import { typescriptPlugin } from './typescript.js';
+import { pythonPlugin } from './python.js';
+// Re-export so existing `import { loadQuery } from './registry.js'` keeps working.
+export { loadQuery } from './query-loader.js';
+/** All registered plugins, in priority order. */
+export const PLUGINS = [typescriptPlugin, pythonPlugin];
+/** Map of file extension → plugin, for O(1) lookup by extension. */
+const EXTENSION_MAP = new Map();
+for (const plugin of PLUGINS) {
+    for (const ext of plugin.extensions) {
+        EXTENSION_MAP.set(ext.toLowerCase(), plugin);
+    }
+}
+/**
+ * Resolve a plugin for a file path by its extension, or null if unsupported.
+ * (e.g. 'src/auth/Auth.ts' → typescriptPlugin)
+ */
+export function pluginForFile(filePath) {
+    const dot = filePath.lastIndexOf('.');
+    if (dot < 0)
+        return null;
+    const ext = filePath.slice(dot).toLowerCase();
+    return EXTENSION_MAP.get(ext) ?? null;
+}
+/** Get a plugin by its language id. */
+export function pluginById(id) {
+    return PLUGINS.find((p) => p.id === id);
+}
+/** All supported extensions (for the file watcher / indexer). */
+export function supportedExtensions() {
+    return Array.from(EXTENSION_MAP.keys());
+}
+//# sourceMappingURL=registry.js.map

package/dist/parser/languages/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/parser/languages/registry.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,mFAAmF;AACnF,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAe9C,iDAAiD;AACjD,MAAM,CAAC,MAAM,OAAO,GAAqB,CAAC,gBAAgB,EAAE,YAAY,CAAC,CAAC;AAE1E,oEAAoE;AACpE,MAAM,aAAa,GAAgC,IAAI,GAAG,EAAE,CAAC;AAC7D,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;IAC7B,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;QACpC,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,WAAW,EAAE,EAAE,MAAM,CAAC,CAAC;IAC/C,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,QAAgB;IAC5C,MAAM,GAAG,GAAG,QAAQ,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IACtC,IAAI,GAAG,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IACzB,MAAM,GAAG,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;IAC9C,OAAO,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC;AACxC,CAAC;AAED,uCAAuC;AACvC,MAAM,UAAU,UAAU,CAAC,EAAc;IACvC,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;AAC1C,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,mBAAmB;IACjC,OAAO,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC,CAAC;AAC1C,CAAC"}

package/dist/parser/languages/typescript.d.ts

@@ -0,0 +1,11 @@
+import type { LanguagePlugin } from './registry.js';
+declare const tsxGrammar: unknown;
+/**
+ * Single plugin object covering .ts/.tsx/.js/.jsx/.mjs/.cjs. The query is shared; the grammar
+ * differs for tsx vs the rest (set per-file in the extractor via parse()).
+ */
+export declare const typescriptPlugin: LanguagePlugin;
+/** Choose the right grammar object for a specific TS-family file (tsx vs non-tsx). */
+export declare function typescriptGrammarForFile(filePath: string): unknown;
+export { tsxGrammar };
+//# sourceMappingURL=typescript.d.ts.map

package/dist/parser/languages/typescript.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typescript.d.ts","sourceRoot":"","sources":["../../../src/parser/languages/typescript.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAKpD,QAAA,MAAM,UAAU,SAA+B,CAAC;AAEhD;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,cAK9B,CAAC;AAEF,sFAAsF;AACtF,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAElE;AAED,OAAO,EAAE,UAAU,EAAE,CAAC"}

package/dist/parser/languages/typescript.js

@@ -0,0 +1,26 @@
+// TypeScript / JavaScript / TSX language plugin.
+//
+// tree-sitter-typescript exports two grammars: { typescript, tsx }. JavaScript uses the
+// typescript grammar's JS subset, but for accurate JS parsing we'd want tree-sitter-javascript.
+// For v0.1 we parse .js with the typescript grammar (superset — works fine for symbol extraction).
+import TS from 'tree-sitter-typescript';
+import { loadQuery } from './query-loader.js';
+// The package exports { typescript, tsx }. Use tsx for .tsx so JSX parses.
+const tsGrammar = TS.typescript;
+const tsxGrammar = TS.tsx;
+/**
+ * Single plugin object covering .ts/.tsx/.js/.jsx/.mjs/.cjs. The query is shared; the grammar
+ * differs for tsx vs the rest (set per-file in the extractor via parse()).
+ */
+export const typescriptPlugin = {
+    id: 'typescript',
+    extensions: ['.ts', '.tsx', '.js', '.jsx', '.mjs', '.cjs'],
+    language: tsGrammar,
+    query: loadQuery('typescript'),
+};
+/** Choose the right grammar object for a specific TS-family file (tsx vs non-tsx). */
+export function typescriptGrammarForFile(filePath) {
+    return filePath.toLowerCase().endsWith('.tsx') ? tsxGrammar : tsGrammar;
+}
+export { tsxGrammar };
+//# sourceMappingURL=typescript.js.map

package/dist/parser/languages/typescript.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typescript.js","sourceRoot":"","sources":["../../../src/parser/languages/typescript.ts"],"names":[],"mappings":"AAAA,iDAAiD;AACjD,EAAE;AACF,wFAAwF;AACxF,gGAAgG;AAChG,mGAAmG;AACnG,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAExC,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAE9C,2EAA2E;AAC3E,MAAM,SAAS,GAAI,EAA8B,CAAC,UAAU,CAAC;AAC7D,MAAM,UAAU,GAAI,EAAuB,CAAC,GAAG,CAAC;AAEhD;;;GAGG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAmB;IAC9C,EAAE,EAAE,YAAY;IAChB,UAAU,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;IAC1D,QAAQ,EAAE,SAAS;IACnB,KAAK,EAAE,SAAS,CAAC,YAAY,CAAC;CAC/B,CAAC;AAEF,sFAAsF;AACtF,MAAM,UAAU,wBAAwB,CAAC,QAAgB;IACvD,OAAO,QAAQ,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC;AAC1E,CAAC;AAED,OAAO,EAAE,UAAU,EAAE,CAAC"}

package/dist/parser/types.d.ts

@@ -0,0 +1,36 @@
+import type { SymbolKind, EdgeKind } from '../graph/types.js';
+/** A symbol extracted from source (not yet persisted). */
+export interface ExtractedSymbol {
+    name: string;
+    kind: SymbolKind;
+    line_start: number;
+    line_end: number;
+    /** condensed definition: e.g. "function login(user: string): Token" — NOT the body */
+    signature: string | null;
+    /** base/inherited names referenced by a class (for extends/implements edges) */
+    extends?: string[];
+    implements?: string[];
+}
+/** A reference from this file to something outside it (an import). */
+export interface ExtractedImport {
+    /** the raw specifier as written: './AuthService', '../utils', 'react', '@myorg/ui' */
+    specifier: string;
+    /** names brought in: ['AuthService', 'TokenService'] (best-effort; may be empty for namespace imports) */
+    names: string[];
+}
+/** Full extraction output for one file. */
+export interface ParseResult {
+    symbols: ExtractedSymbol[];
+    imports: ExtractedImport[];
+}
+/** Edge between two symbols, as the indexer builds it. */
+export interface PendingEdge {
+    /** symbol-local name of the source (the importer/caller) */
+    fromName: string;
+    /** name the edge points to (an imported or referenced name) */
+    toName: string;
+    kind: EdgeKind;
+}
+/** Supported language identifiers (stored in files.language). */
+export type LanguageId = 'typescript' | 'javascript' | 'python';
+//# sourceMappingURL=types.d.ts.map

package/dist/parser/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/parser/types.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAE9D,0DAA0D;AAC1D,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,UAAU,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,sFAAsF;IACtF,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,gFAAgF;IAChF,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,sEAAsE;AACtE,MAAM,WAAW,eAAe;IAC9B,sFAAsF;IACtF,SAAS,EAAE,MAAM,CAAC;IAClB,0GAA0G;IAC1G,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,2CAA2C;AAC3C,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,OAAO,EAAE,eAAe,EAAE,CAAC;CAC5B;AAED,0DAA0D;AAC1D,MAAM,WAAW,WAAW;IAC1B,4DAA4D;IAC5D,QAAQ,EAAE,MAAM,CAAC;IACjB,+DAA+D;IAC/D,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,QAAQ,CAAC;CAChB;AAED,iEAAiE;AACjE,MAAM,MAAM,UAAU,GAAG,YAAY,GAAG,YAAY,GAAG,QAAQ,CAAC"}

package/dist/parser/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/parser/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/parser/types.ts"],"names":[],"mappings":""}

package/dist/session/manager.d.ts

@@ -0,0 +1,28 @@
+import type Database from 'better-sqlite3';
+import type { SymbolRow } from '../graph/types.js';
+import type { DeltaResult } from './types.js';
+/** Sessions older than this are eligible for cleanup. */
+export declare const SESSION_TTL_MS: number;
+export declare class SessionManager {
+    private db;
+    constructor(db: Database.Database);
+    /** Create a new session row. Returns its UUID. */
+    createSession(projectRoot: string): string;
+    /** True if the session id exists. */
+    sessionExists(sessionId: string): boolean;
+    /**
+     * Split a list of symbols into those NOT yet sent this session vs. those already sent.
+     * This is the core delta computation.
+     */
+    filterAlreadySent(sessionId: string, symbols: SymbolRow[]): DeltaResult<SymbolRow>;
+    /** Set of symbol ids already sent to a session. */
+    private getSentSymbolIds;
+    /**
+     * Record that these symbols were sent to a session. Call after every successful tool
+     * response that included symbol context. Idempotent (UNIQUE(session_id, symbol_id)).
+     */
+    markAsSent(sessionId: string, symbols: SymbolRow[]): void;
+    /** Delete sessions older than SESSION_TTL_MS (and cascade their ledger entries). */
+    cleanOldSessions(): number;
+}
+//# sourceMappingURL=manager.d.ts.map

package/dist/session/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/session/manager.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAE3C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,yDAAyD;AACzD,eAAO,MAAM,cAAc,QAAsB,CAAC;AAElD,qBAAa,cAAc;IACb,OAAO,CAAC,EAAE;gBAAF,EAAE,EAAE,QAAQ,CAAC,QAAQ;IAEzC,kDAAkD;IAClD,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM;IAU1C,qCAAqC;IACrC,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAKzC;;;OAGG;IACH,iBAAiB,CACf,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,SAAS,EAAE,GACnB,WAAW,CAAC,SAAS,CAAC;IAiBzB,mDAAmD;IACnD,OAAO,CAAC,gBAAgB;IAOxB;;;OAGG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,IAAI;IAezD,oFAAoF;IACpF,gBAAgB,IAAI,MAAM;CAK3B"}

package/dist/session/manager.js

@@ -0,0 +1,82 @@
+import { randomUUID } from 'node:crypto';
+/** Sessions older than this are eligible for cleanup. */
+export const SESSION_TTL_MS = 24 * 60 * 60 * 1000; // 24h
+export class SessionManager {
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    /** Create a new session row. Returns its UUID. */
+    createSession(projectRoot) {
+        const id = randomUUID();
+        this.db
+            .prepare('INSERT INTO sessions (id, created_at, project_root) VALUES (?, ?, ?)')
+            .run(id, Date.now(), projectRoot);
+        return id;
+    }
+    /** True if the session id exists. */
+    sessionExists(sessionId) {
+        const row = this.db.prepare('SELECT 1 AS one FROM sessions WHERE id = ?').get(sessionId);
+        return row !== undefined;
+    }
+    /**
+     * Split a list of symbols into those NOT yet sent this session vs. those already sent.
+     * This is the core delta computation.
+     */
+    filterAlreadySent(sessionId, symbols) {
+        if (symbols.length === 0)
+            return { fresh: [], alreadySent: [] };
+        const sentIds = this.getSentSymbolIds(sessionId);
+        const fresh = [];
+        const alreadySent = [];
+        for (const sym of symbols) {
+            if (sentIds.has(sym.id)) {
+                alreadySent.push(sym);
+            }
+            else {
+                fresh.push(sym);
+            }
+        }
+        return { fresh, alreadySent };
+    }
+    /** Set of symbol ids already sent to a session. */
+    getSentSymbolIds(sessionId) {
+        const rows = this.db
+            .prepare('SELECT symbol_id FROM ledger_entries WHERE session_id = ?')
+            .all(sessionId);
+        return new Set(rows.map((r) => r.symbol_id));
+    }
+    /**
+     * Record that these symbols were sent to a session. Call after every successful tool
+     * response that included symbol context. Idempotent (UNIQUE(session_id, symbol_id)).
+     */
+    markAsSent(sessionId, symbols) {
+        if (symbols.length === 0)
+            return;
+        const insert = this.db.prepare(`INSERT OR REPLACE INTO ledger_entries (session_id, symbol_id, content_hash, sent_at)
+       VALUES (?, ?, ?, ?)`);
+        const insertMany = this.db.transaction((syms) => {
+            const now = Date.now();
+            for (const sym of syms) {
+                insert.run(sessionId, sym.id, contentHashForSymbol(sym), now);
+            }
+        });
+        insertMany(symbols);
+    }
+    /** Delete sessions older than SESSION_TTL_MS (and cascade their ledger entries). */
+    cleanOldSessions() {
+        const cutoff = Date.now() - SESSION_TTL_MS;
+        const result = this.db.prepare('DELETE FROM sessions WHERE created_at < ?').run(cutoff);
+        return result.changes;
+    }
+}
+/**
+ * A stable hash representing "what was sent" for a symbol. We use the name + location so that
+ * a symbol moved to a new line (but otherwise unchanged) re-sends, while an unchanged symbol
+ * at the same location is correctly deduped. (A true content hash would require re-reading the
+ * file; this is a good-enough proxy and keeps the ledger cheap.)
+ */
+function contentHashForSymbol(sym) {
+    return `${sym.name}:${sym.file_path}:${sym.line_start}`;
+}
+//# sourceMappingURL=manager.js.map

package/dist/session/manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.js","sourceRoot":"","sources":["../../src/session/manager.ts"],"names":[],"mappings":"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"}

package/dist/session/pruner.d.ts

@@ -0,0 +1,28 @@
+import type { SymbolRow } from '../graph/types.js';
+import type { SessionManager } from './manager.js';
+export interface PrunedContext {
+    /** callers not yet sent this session */
+    callers: SymbolRow[];
+    /** dependencies not yet sent this session */
+    dependencies: SymbolRow[];
+    /** focal symbol (always included, even if re-sent, so the agent knows what was queried) */
+    symbol: SymbolRow;
+    /** names of symbols skipped because already in context */
+    skipped: string[];
+}
+/**
+ * Apply session dedup to a traversal result. Does NOT mark anything as sent — the caller does
+ * that via sessionManager.markAsSent after building the final response (so a failed/errored
+ * tool call doesn't pollute the ledger).
+ */
+export declare function pruneBySession(sessionManager: SessionManager, sessionId: string, traversal: {
+    symbol: SymbolRow;
+    callers: SymbolRow[];
+    dependencies: SymbolRow[];
+}): PrunedContext;
+/**
+ * Collect every symbol id that would be "sent" in a pruned context, for markAsSent.
+ * Includes the focal symbol (always part of the response).
+ */
+export declare function symbolsToMark(pruned: PrunedContext): SymbolRow[];
+//# sourceMappingURL=pruner.d.ts.map

package/dist/session/pruner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pruner.d.ts","sourceRoot":"","sources":["../../src/session/pruner.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnD,MAAM,WAAW,aAAa;IAC5B,wCAAwC;IACxC,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,6CAA6C;IAC7C,YAAY,EAAE,SAAS,EAAE,CAAC;IAC1B,2FAA2F;IAC3F,MAAM,EAAE,SAAS,CAAC;IAClB,0DAA0D;IAC1D,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,cAAc,EAAE,cAAc,EAC9B,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE;IACT,MAAM,EAAE,SAAS,CAAC;IAClB,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,YAAY,EAAE,SAAS,EAAE,CAAC;CAC3B,GACA,aAAa,CAkBf;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,aAAa,GAAG,SAAS,EAAE,CAEhE"}

package/dist/session/pruner.js

@@ -0,0 +1,24 @@
+/**
+ * Apply session dedup to a traversal result. Does NOT mark anything as sent — the caller does
+ * that via sessionManager.markAsSent after building the final response (so a failed/errored
+ * tool call doesn't pollute the ledger).
+ */
+export function pruneBySession(sessionManager, sessionId, traversal) {
+    const { fresh: freshCallers, alreadySent: sentCallers } = sessionManager.filterAlreadySent(sessionId, traversal.callers);
+    const { fresh: freshDeps, alreadySent: sentDeps } = sessionManager.filterAlreadySent(sessionId, traversal.dependencies);
+    const skipped = [...sentCallers, ...sentDeps].map((s) => s.name);
+    return {
+        symbol: traversal.symbol,
+        callers: freshCallers,
+        dependencies: freshDeps,
+        skipped,
+    };
+}
+/**
+ * Collect every symbol id that would be "sent" in a pruned context, for markAsSent.
+ * Includes the focal symbol (always part of the response).
+ */
+export function symbolsToMark(pruned) {
+    return [pruned.symbol, ...pruned.callers, ...pruned.dependencies];
+}
+//# sourceMappingURL=pruner.js.map

package/dist/session/pruner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pruner.js","sourceRoot":"","sources":["../../src/session/pruner.ts"],"names":[],"mappings":"AAoBA;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAC5B,cAA8B,EAC9B,SAAiB,EACjB,SAIC;IAED,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,GAAG,cAAc,CAAC,iBAAiB,CACxF,SAAS,EACT,SAAS,CAAC,OAAO,CAClB,CAAC;IACF,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE,GAAG,cAAc,CAAC,iBAAiB,CAClF,SAAS,EACT,SAAS,CAAC,YAAY,CACvB,CAAC;IAEF,MAAM,OAAO,GAAG,CAAC,GAAG,WAAW,EAAE,GAAG,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAEjE,OAAO;QACL,MAAM,EAAE,SAAS,CAAC,MAAM;QACxB,OAAO,EAAE,YAAY;QACrB,YAAY,EAAE,SAAS;QACvB,OAAO;KACR,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,MAAqB;IACjD,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,MAAM,CAAC,OAAO,EAAE,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC;AACpE,CAAC"}

package/dist/session/types.d.ts

@@ -0,0 +1,21 @@
+export interface Session {
+    id: string;
+    created_at: number;
+    project_root: string;
+}
+/** A row in `ledger_entries` — proof that a symbol was sent to a session. */
+export interface LedgerEntry {
+    id: number;
+    session_id: string;
+    symbol_id: number;
+    content_hash: string;
+    sent_at: number;
+}
+/** Outcome of delta computation: which symbols are new vs. already sent. */
+export interface DeltaResult<T> {
+    /** symbols NOT yet sent this session — these go into the response */
+    fresh: T[];
+    /** symbols already sent — skipped to save tokens */
+    alreadySent: T[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/session/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/session/types.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,6EAA6E;AAC7E,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,4EAA4E;AAC5E,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B,qEAAqE;IACrE,KAAK,EAAE,CAAC,EAAE,CAAC;IACX,oDAAoD;IACpD,WAAW,EAAE,CAAC,EAAE,CAAC;CAClB"}

package/dist/session/types.js

@@ -0,0 +1,4 @@
+// Session ledger types. A "session" = one agent conversation. The ledger records which
+// symbols' context was already sent to that agent, so subsequent tool calls can skip them.
+export {};
+//# sourceMappingURL=types.js.map

package/dist/session/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/session/types.ts"],"names":[],"mappings":"AAAA,uFAAuF;AACvF,2FAA2F"}

package/dist/utils/logger.d.ts

@@ -0,0 +1,13 @@
+export type LogLevel = 'info' | 'warn' | 'error' | 'debug';
+/**
+ * Write a log line to stderr. Never touches stdout.
+ *
+ * @param message - human-readable message
+ * @param level - severity; 'debug' is suppressed unless SLIVER_DEBUG=1
+ */
+export declare function log(message: string, level?: LogLevel): void;
+/**
+ * Log an error with its stack trace (if available). Used in catch blocks.
+ */
+export declare function logError(err: unknown): void;
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;AAY3D;;;;;GAKG;AACH,wBAAgB,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,GAAE,QAAiB,GAAG,IAAI,CAGnE;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAO3C"}

package/dist/utils/logger.js

@@ -0,0 +1,36 @@
+// CRITICAL: All logging MUST go to stderr.
+// stdout is the MCP protocol channel (JSON-RPC). Any console.log() there corrupts the
+// protocol stream and silently disconnects the client — the agent stops working with no error.
+// The `no-console` eslint rule (allowing only console.error) enforces this in src/.
+// Tests: test/integration/stdout-purity.test.ts asserts stdout stays clean.
+const LEVEL_PREFIX = {
+    info: 'INFO',
+    warn: 'WARN',
+    error: 'ERROR',
+    debug: 'DEBUG',
+};
+// SLIVER_DEBUG=1 enables debug logs. Off by default to keep stderr quiet for clients.
+const DEBUG_ON = process.env.SLIVER_DEBUG === '1' || process.env.SLIVER_DEBUG === 'true';
+/**
+ * Write a log line to stderr. Never touches stdout.
+ *
+ * @param message - human-readable message
+ * @param level - severity; 'debug' is suppressed unless SLIVER_DEBUG=1
+ */
+export function log(message, level = 'info') {
+    if (level === 'debug' && !DEBUG_ON)
+        return;
+    process.stderr.write(`[contextsliver:${LEVEL_PREFIX[level]}] ${message}\n`);
+}
+/**
+ * Log an error with its stack trace (if available). Used in catch blocks.
+ */
+export function logError(err) {
+    const message = err instanceof Error ? err.message : String(err);
+    log(message, 'error');
+    if (err instanceof Error && err.stack) {
+        // stack already includes the message; write it raw for debugging
+        process.stderr.write(`[contextsliver:ERROR] ${err.stack}\n`);
+    }
+}
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA,2CAA2C;AAC3C,sFAAsF;AACtF,+FAA+F;AAC/F,oFAAoF;AACpF,4EAA4E;AAI5E,MAAM,YAAY,GAA6B;IAC7C,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,MAAM;IACZ,KAAK,EAAE,OAAO;IACd,KAAK,EAAE,OAAO;CACf,CAAC;AAEF,sFAAsF;AACtF,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,KAAK,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC,YAAY,KAAK,MAAM,CAAC;AAEzF;;;;;GAKG;AACH,MAAM,UAAU,GAAG,CAAC,OAAe,EAAE,QAAkB,MAAM;IAC3D,IAAI,KAAK,KAAK,OAAO,IAAI,CAAC,QAAQ;QAAE,OAAO;IAC3C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,kBAAkB,YAAY,CAAC,KAAK,CAAC,KAAK,OAAO,IAAI,CAAC,CAAC;AAC9E,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,QAAQ,CAAC,GAAY;IACnC,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACjE,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACtB,IAAI,GAAG,YAAY,KAAK,IAAI,GAAG,CAAC,KAAK,EAAE,CAAC;QACtC,iEAAiE;QACjE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,yBAAyB,GAAG,CAAC,KAAK,IAAI,CAAC,CAAC;IAC/D,CAAC;AACH,CAAC"}

package/dist/utils/paths.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Convert an absolute or project-relative path to a canonical, posix-style, project-relative path.
+ * This is the form stored in `files.path` and used in all graph queries.
+ *
+ * @example toRelativePath('/proj/src/auth/Auth.ts', '/proj') → 'src/auth/Auth.ts'
+ */
+export declare function toRelativePath(absoluteOrRelative: string, projectRoot: string): string;
+/** Normalize a path to posix separators (forward slashes) and strip leading ./ */
+export declare function toPosix(p: string): string;
+/**
+ * Resolve a relative import specifier (e.g. './AuthService', '../utils') against the importing
+ * file's directory, trying the common extensions. Returns a posix project-relative path, or
+ * null if no candidate file exists on disk.
+ *
+ * Bare specifiers (e.g. 'react', '@myorg/ui') are NOT resolved here — monorepo/workspace
+ * resolution handles those separately. Node built-ins ('node:fs', 'fs') never resolve to a file.
+ *
+ * @param specifier - the import path as written in source
+ * @param importerRel - posix project-relative path of the file doing the import
+ * @param projectRoot - absolute project root, for existence checks
+ * @param extensions - candidate extensions to try (with and without /index)
+ */
+export declare function resolveRelativeImport(specifier: string, importerRel: string, projectRoot: string, extensions?: string[]): string | null;
+//# sourceMappingURL=paths.d.ts.map

package/dist/utils/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/utils/paths.ts"],"names":[],"mappings":"AAOA;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,kBAAkB,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAItF;AAED,kFAAkF;AAClF,wBAAgB,OAAO,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAGzC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,UAAU,GAAE,MAAM,EAAmD,GACpE,MAAM,GAAG,IAAI,CAiBf"}

package/dist/utils/paths.js

@@ -0,0 +1,55 @@
+// Path normalization + import-path resolution utilities.
+//
+// All stored file paths are relative to the project root, posix-style (forward slashes),
+// so the index is portable across OSes and the graph query results are stable.
+import { resolve, relative, normalize, sep, posix, isAbsolute } from 'node:path';
+import { existsSync } from 'node:fs';
+/**
+ * Convert an absolute or project-relative path to a canonical, posix-style, project-relative path.
+ * This is the form stored in `files.path` and used in all graph queries.
+ *
+ * @example toRelativePath('/proj/src/auth/Auth.ts', '/proj') → 'src/auth/Auth.ts'
+ */
+export function toRelativePath(absoluteOrRelative, projectRoot) {
+    const abs = isAbsolute(absoluteOrRelative) ? absoluteOrRelative : resolve(projectRoot, absoluteOrRelative);
+    const rel = relative(resolve(projectRoot), abs);
+    return toPosix(rel);
+}
+/** Normalize a path to posix separators (forward slashes) and strip leading ./ */
+export function toPosix(p) {
+    const normalized = sep === '\\' ? p.split(sep).join(posix.sep) : p;
+    return normalized.replace(/^\.\//, '').replace(/\\/g, '/');
+}
+/**
+ * Resolve a relative import specifier (e.g. './AuthService', '../utils') against the importing
+ * file's directory, trying the common extensions. Returns a posix project-relative path, or
+ * null if no candidate file exists on disk.
+ *
+ * Bare specifiers (e.g. 'react', '@myorg/ui') are NOT resolved here — monorepo/workspace
+ * resolution handles those separately. Node built-ins ('node:fs', 'fs') never resolve to a file.
+ *
+ * @param specifier - the import path as written in source
+ * @param importerRel - posix project-relative path of the file doing the import
+ * @param projectRoot - absolute project root, for existence checks
+ * @param extensions - candidate extensions to try (with and without /index)
+ */
+export function resolveRelativeImport(specifier, importerRel, projectRoot, extensions = ['.ts', '.tsx', '.js', '.jsx', '.mjs', '.cjs']) {
+    if (!specifier.startsWith('.'))
+        return null; // bare or builtin
+    const importerDir = posix.dirname(importerRel);
+    const base = toPosix(normalize(posix.join(importerDir, specifier)));
+    // Try the specifier as-is with each extension, then /index.<ext>
+    const candidates = [base, ...extensions.map((ext) => base + ext)];
+    for (const ext of extensions) {
+        candidates.push(posix.join(base, 'index' + ext));
+    }
+    for (const candidate of candidates) {
+        if (candidate.startsWith('..'))
+            continue; // escaped project root
+        const abs = resolve(projectRoot, candidate);
+        if (existsSync(abs))
+            return candidate;
+    }
+    return null;
+}
+//# sourceMappingURL=paths.js.map

package/dist/utils/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/utils/paths.ts"],"names":[],"mappings":"AAAA,yDAAyD;AACzD,EAAE;AACF,yFAAyF;AACzF,+EAA+E;AAC/E,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACjF,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAErC;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,kBAA0B,EAAE,WAAmB;IAC5E,MAAM,GAAG,GAAG,UAAU,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,kBAAkB,CAAC,CAAC;IAC3G,MAAM,GAAG,GAAG,QAAQ,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,GAAG,CAAC,CAAC;IAChD,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC;AACtB,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,OAAO,CAAC,CAAS;IAC/B,MAAM,UAAU,GAAG,GAAG,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACnE,OAAO,UAAU,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AAC7D,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,qBAAqB,CACnC,SAAiB,EACjB,WAAmB,EACnB,WAAmB,EACnB,aAAuB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;IAErE,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC,CAAC,kBAAkB;IAC/D,MAAM,WAAW,GAAG,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IAC/C,MAAM,IAAI,GAAG,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;IAEpE,iEAAiE;IACjE,MAAM,UAAU,GAAG,CAAC,IAAI,EAAE,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC;IAClE,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;QAC7B,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,GAAG,GAAG,CAAC,CAAC,CAAC;IACnD,CAAC;IAED,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,IAAI,SAAS,CAAC,UAAU,CAAC,IAAI,CAAC;YAAE,SAAS,CAAC,uBAAuB;QACjE,MAAM,GAAG,GAAG,OAAO,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;QAC5C,IAAI,UAAU,CAAC,GAAG,CAAC;YAAE,OAAO,SAAS,CAAC;IACxC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/utils/tokens.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Count tokens in a string using cl100k_base, with a chars/4 fallback on any error.
+ * Returns a non-negative integer. Never throws.
+ */
+export declare function countTokens(text: string): number;
+/**
+ * Sum tokens across multiple strings (e.g. a response with several content parts).
+ */
+export declare function countTokensMany(texts: string[]): number;
+//# sourceMappingURL=tokens.d.ts.map