@poolzin/pool-bot 2026.1.33 → 2026.1.34

package/dist/agents/pi-embedded-helpers/errors.js

@@ -342,9 +342,7 @@ const ERROR_PATTERNS = {
         "string should match pattern",
         "tool_use.id",
         "tool_use_id",
-        "tool_use.name",
         "messages.1.content.1.tool_use.id",
-        "messages.1.content.1.tool_use.name",
         "invalid request format",
     ],
 };

package/dist/agents/session-tool-result-guard.js

@@ -1,4 +1,4 @@
-import { makeMissingToolResult, sanitizeToolName } from "./session-transcript-repair.js";
+import { makeMissingToolResult } from "./session-transcript-repair.js";
 import { emitSessionTranscriptUpdate } from "../sessions/transcript-events.js";
 function extractAssistantToolCalls(msg) {
     const content = msg.content;
@@ -14,7 +14,7 @@ function extractAssistantToolCalls(msg) {
         if (rec.type === "toolCall" || rec.type === "toolUse" || rec.type === "functionCall") {
             toolCalls.push({
                 id: rec.id,
-                name: sanitizeToolName(typeof rec.name === "string" ? rec.name : undefined),
+                name: typeof rec.name === "string" ? rec.name : undefined,
             });
         }
     }

package/dist/agents/session-transcript-repair.js

@@ -1,22 +1,3 @@
-import { logWarn } from "../logger.js";
-/**
- * Maximum allowed tool name length per Anthropic API spec.
- * Names exceeding this will cause "tool_use.name > 200 chars" validation errors.
- */
-export const MAX_TOOL_NAME_LENGTH = 64;
-/**
- * Truncate tool names that exceed the API limit.
- * This prevents "tool_use.name > 200 chars" validation errors when
- * the model hallucinates overly long tool names.
- */
-export function sanitizeToolName(name) {
-    if (!name)
-        return name;
-    if (name.length <= MAX_TOOL_NAME_LENGTH)
-        return name;
-    logWarn(`[transcript-repair] truncating tool name from ${name.length} to ${MAX_TOOL_NAME_LENGTH} chars: ${name.slice(0, 50)}...`);
-    return name.slice(0, MAX_TOOL_NAME_LENGTH);
-}
 function extractToolCallsFromAssistant(msg) {
     const content = msg.content;
     if (!Array.isArray(content))
@@ -31,7 +12,7 @@ function extractToolCallsFromAssistant(msg) {
         if (rec.type === "toolCall" || rec.type === "toolUse" || rec.type === "functionCall") {
             toolCalls.push({
                 id: rec.id,
-                name: sanitizeToolName(typeof rec.name === "string" ? rec.name : undefined),
+                name: typeof rec.name === "string" ? rec.name : undefined,
             });
         }
     }

package/dist/build-info.json

@@ -1,5 +1,5 @@
 {
-  "version": "2026.1.33",
-  "commit": "e1bdb6f2a583877b7491c951af6ff5d69636befe",
-  "builtAt": "2026-02-04T17:02:44.196Z"
+  "version": "2026.1.34",
+  "commit": "84710f9a55bc3eca77fd7ffa882d9f11b9f92acc",
+  "builtAt": "2026-02-05T14:57:54.102Z"
 }

package/dist/gateway/hooks/index.js

@@ -24,8 +24,6 @@ defaultOnSessionStart, defaultOnSessionEnd, registerDefaultHooks,
 clearAllHooks, } from "./lifecycle-hooks.js";
 // Integration with agent events
 export { startLifecycleHooksIntegration, getIntegrationStats, isSessionTracked, getTrackedSessionInfo, clearTrackedSessions, removeTrackedSession, } from "./lifecycle-hooks-integration.js";
-// Tool usage capture (Day 2 - ACTIVE, feature-flagged)
-export { toolUsageCaptureHook, loadSessionToolUsage, saveSessionToolUsage, } from "./tool-usage-capture.js";
 // Progressive disclosure (Day 3 - ACTIVE, feature-flagged, OPT-IN)
 // Feature flag: PROGRESSIVE_DISCLOSURE_FLAGS.ENABLED = false (OFF by default)
 // Safe: Returns error "feature disabled" if called without enabling flag

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@poolzin/pool-bot",
-  "version": "2026.1.33",
+  "version": "2026.1.34",
   "description": "🎱 Pool Bot - AI assistant with PLCODE integrations",
   "type": "module",
   "main": "dist/index.js",
@@ -76,81 +76,12 @@
     "dist/pairing/**",
     "dist/whatsapp/**"
   ],
-  "scripts": {
-    "dev": "node scripts/run-node.mjs",
-    "postinstall": "node scripts/postinstall.js",
-    "prepack": "pnpm build && pnpm ui:build",
-    "docs:list": "node scripts/docs-list.js",
-    "docs:bin": "node scripts/build-docs-list.mjs",
-    "docs:dev": "cd docs && mint dev",
-    "docs:build": "cd docs && pnpm dlx --reporter append-only mint broken-links",
-    "build": "tsc -p tsconfig.json && node --import tsx scripts/canvas-a2ui-copy.ts && node --import tsx scripts/copy-hook-metadata.ts && node --import tsx scripts/write-build-info.ts",
-    "plugins:sync": "node --import tsx scripts/sync-plugin-versions.ts",
-    "release:check": "node --import tsx scripts/release-check.ts",
-    "ui:install": "node scripts/ui.js install",
-    "ui:dev": "node scripts/ui.js dev",
-    "ui:build": "node scripts/ui.js build",
-    "start": "node scripts/run-node.mjs",
-    "poolbot": "node scripts/run-node.mjs",
-    "gateway:watch": "node scripts/watch-node.mjs gateway --force",
-    "gateway:dev": "CLAWDBOT_SKIP_CHANNELS=1 node scripts/run-node.mjs --dev gateway",
-    "gateway:dev:reset": "CLAWDBOT_SKIP_CHANNELS=1 node scripts/run-node.mjs --dev gateway --reset",
-    "tui": "node scripts/run-node.mjs tui",
-    "tui:dev": "CLAWDBOT_PROFILE=dev node scripts/run-node.mjs tui",
-    "poolbot:rpc": "node scripts/run-node.mjs agent --mode rpc --json",
-    "ios:gen": "cd apps/ios && xcodegen generate",
-    "ios:open": "cd apps/ios && xcodegen generate && open Moltbot.xcodeproj",
-    "ios:build": "bash -lc 'cd apps/ios && xcodegen generate && xcodebuild -project Moltbot.xcodeproj -scheme Moltbot -destination \"${IOS_DEST:-platform=iOS Simulator,name=iPhone 17}\" -configuration Debug build'",
-    "ios:run": "bash -lc 'cd apps/ios && xcodegen generate && xcodebuild -project Moltbot.xcodeproj -scheme Moltbot -destination \"${IOS_DEST:-platform=iOS Simulator,name=iPhone 17}\" -configuration Debug build && xcrun simctl boot \"${IOS_SIM:-iPhone 17}\" || true && xcrun simctl launch booted com.poolbot.ios'",
-    "android:assemble": "cd apps/android && ./gradlew :app:assembleDebug",
-    "android:install": "cd apps/android && ./gradlew :app:installDebug",
-    "android:run": "cd apps/android && ./gradlew :app:installDebug && adb shell am start -n com.poolbot.android/.MainActivity",
-    "android:test": "cd apps/android && ./gradlew :app:testDebugUnitTest",
-    "mac:restart": "bash scripts/restart-mac.sh",
-    "mac:package": "bash scripts/package-mac-app.sh",
-    "mac:open": "open dist/Moltbot.app",
-    "lint": "oxlint --type-aware src test",
-    "lint:swift": "swiftlint lint --config .swiftlint.yml && (cd apps/ios && swiftlint lint --config .swiftlint.yml)",
-    "lint:all": "pnpm lint && pnpm lint:swift",
-    "lint:fix": "pnpm format:fix && oxlint --type-aware --fix src test",
-    "format": "oxfmt --check src test",
-    "format:swift": "swiftformat --lint --config .swiftformat apps/macos/Sources apps/ios/Sources apps/shared/ClawdbotKit/Sources",
-    "format:all": "pnpm format && pnpm format:swift",
-    "format:fix": "oxfmt --write src test",
-    "test": "node scripts/test-parallel.mjs",
-    "test:watch": "vitest",
-    "test:ui": "pnpm --dir ui test",
-    "test:force": "node --import tsx scripts/test-force.ts",
-    "test:coverage": "vitest run --coverage",
-    "test:e2e": "vitest run --config vitest.e2e.config.ts",
-    "test:live": "CLAWDBOT_LIVE_TEST=1 vitest run --config vitest.live.config.ts",
-    "test:docker:onboard": "bash scripts/e2e/onboard-docker.sh",
-    "test:docker:gateway-network": "bash scripts/e2e/gateway-network-docker.sh",
-    "test:docker:live-models": "bash scripts/test-live-models-docker.sh",
-    "test:docker:live-gateway": "bash scripts/test-live-gateway-models-docker.sh",
-    "test:docker:qr": "bash scripts/e2e/qr-import-docker.sh",
-    "test:docker:doctor-switch": "bash scripts/e2e/doctor-install-switch-docker.sh",
-    "test:docker:plugins": "bash scripts/e2e/plugins-docker.sh",
-    "test:docker:cleanup": "bash scripts/test-cleanup-docker.sh",
-    "test:docker:all": "pnpm test:docker:live-models && pnpm test:docker:live-gateway && pnpm test:docker:onboard && pnpm test:docker:gateway-network && pnpm test:docker:qr && pnpm test:docker:doctor-switch && pnpm test:docker:plugins && pnpm test:docker:cleanup",
-    "test:all": "pnpm lint && pnpm build && pnpm test && pnpm test:e2e && pnpm test:live && pnpm test:docker:all",
-    "test:install:e2e": "bash scripts/test-install-sh-e2e-docker.sh",
-    "test:install:smoke": "bash scripts/test-install-sh-docker.sh",
-    "test:install:e2e:openai": "CLAWDBOT_E2E_MODELS=openai bash scripts/test-install-sh-e2e-docker.sh",
-    "test:install:e2e:anthropic": "CLAWDBOT_E2E_MODELS=anthropic bash scripts/test-install-sh-e2e-docker.sh",
-    "protocol:gen": "node --import tsx scripts/protocol-gen.ts",
-    "protocol:gen:swift": "node --import tsx scripts/protocol-gen-swift.ts",
-    "protocol:check": "pnpm protocol:gen && pnpm protocol:gen:swift && git diff --exit-code -- dist/protocol.schema.json apps/macos/Sources/ClawdbotProtocol/GatewayModels.swift",
-    "canvas:a2ui:bundle": "bash scripts/bundle-a2ui.sh",
-    "check:loc": "node --import tsx scripts/check-ts-max-loc.ts --max 500"
-  },
   "keywords": [],
   "author": "João Vitor Cunha <jvsantos.cunha@gmail.com>",
   "license": "MIT",
   "engines": {
     "node": ">=22.12.0"
   },
-  "packageManager": "pnpm@10.23.0",
   "dependencies": {
     "@agentclientprotocol/sdk": "0.13.1",
     "@aws-sdk/client-bedrock": "^3.975.0",
@@ -242,14 +173,6 @@
   "overrides": {
     "tar": "7.5.4"
   },
-  "pnpm": {
-    "minimumReleaseAge": 2880,
-    "overrides": {
-      "@sinclair/typebox": "0.34.47",
-      "hono": "4.11.4",
-      "tar": "7.5.4"
-    }
-  },
   "vitest": {
     "coverage": {
       "provider": "v8",
@@ -281,5 +204,72 @@
       "apps/macos/.build/**",
       "dist/Moltbot.app/**"
     ]
+  },
+  "scripts": {
+    "dev": "node scripts/run-node.mjs",
+    "postinstall": "node scripts/postinstall.js",
+    "docs:list": "node scripts/docs-list.js",
+    "docs:bin": "node scripts/build-docs-list.mjs",
+    "docs:dev": "cd docs && mint dev",
+    "docs:build": "cd docs && pnpm dlx --reporter append-only mint broken-links",
+    "build": "tsc -p tsconfig.json && node --import tsx scripts/canvas-a2ui-copy.ts && node --import tsx scripts/copy-hook-metadata.ts && node --import tsx scripts/write-build-info.ts",
+    "plugins:sync": "node --import tsx scripts/sync-plugin-versions.ts",
+    "release:check": "node --import tsx scripts/release-check.ts",
+    "ui:install": "node scripts/ui.js install",
+    "ui:dev": "node scripts/ui.js dev",
+    "ui:build": "node scripts/ui.js build",
+    "start": "node scripts/run-node.mjs",
+    "poolbot": "node scripts/run-node.mjs",
+    "gateway:watch": "node scripts/watch-node.mjs gateway --force",
+    "gateway:dev": "CLAWDBOT_SKIP_CHANNELS=1 node scripts/run-node.mjs --dev gateway",
+    "gateway:dev:reset": "CLAWDBOT_SKIP_CHANNELS=1 node scripts/run-node.mjs --dev gateway --reset",
+    "tui": "node scripts/run-node.mjs tui",
+    "tui:dev": "CLAWDBOT_PROFILE=dev node scripts/run-node.mjs tui",
+    "poolbot:rpc": "node scripts/run-node.mjs agent --mode rpc --json",
+    "ios:gen": "cd apps/ios && xcodegen generate",
+    "ios:open": "cd apps/ios && xcodegen generate && open Moltbot.xcodeproj",
+    "ios:build": "bash -lc 'cd apps/ios && xcodegen generate && xcodebuild -project Moltbot.xcodeproj -scheme Moltbot -destination \"${IOS_DEST:-platform=iOS Simulator,name=iPhone 17}\" -configuration Debug build'",
+    "ios:run": "bash -lc 'cd apps/ios && xcodegen generate && xcodebuild -project Moltbot.xcodeproj -scheme Moltbot -destination \"${IOS_DEST:-platform=iOS Simulator,name=iPhone 17}\" -configuration Debug build && xcrun simctl boot \"${IOS_SIM:-iPhone 17}\" || true && xcrun simctl launch booted com.poolbot.ios'",
+    "android:assemble": "cd apps/android && ./gradlew :app:assembleDebug",
+    "android:install": "cd apps/android && ./gradlew :app:installDebug",
+    "android:run": "cd apps/android && ./gradlew :app:installDebug && adb shell am start -n com.poolbot.android/.MainActivity",
+    "android:test": "cd apps/android && ./gradlew :app:testDebugUnitTest",
+    "mac:restart": "bash scripts/restart-mac.sh",
+    "mac:package": "bash scripts/package-mac-app.sh",
+    "mac:open": "open dist/Moltbot.app",
+    "lint": "oxlint --type-aware src test",
+    "lint:swift": "swiftlint lint --config .swiftlint.yml && (cd apps/ios && swiftlint lint --config .swiftlint.yml)",
+    "lint:all": "pnpm lint && pnpm lint:swift",
+    "lint:fix": "pnpm format:fix && oxlint --type-aware --fix src test",
+    "format": "oxfmt --check src test",
+    "format:swift": "swiftformat --lint --config .swiftformat apps/macos/Sources apps/ios/Sources apps/shared/ClawdbotKit/Sources",
+    "format:all": "pnpm format && pnpm format:swift",
+    "format:fix": "oxfmt --write src test",
+    "test": "node scripts/test-parallel.mjs",
+    "test:watch": "vitest",
+    "test:ui": "pnpm --dir ui test",
+    "test:force": "node --import tsx scripts/test-force.ts",
+    "test:coverage": "vitest run --coverage",
+    "test:e2e": "vitest run --config vitest.e2e.config.ts",
+    "test:live": "CLAWDBOT_LIVE_TEST=1 vitest run --config vitest.live.config.ts",
+    "test:docker:onboard": "bash scripts/e2e/onboard-docker.sh",
+    "test:docker:gateway-network": "bash scripts/e2e/gateway-network-docker.sh",
+    "test:docker:live-models": "bash scripts/test-live-models-docker.sh",
+    "test:docker:live-gateway": "bash scripts/test-live-gateway-models-docker.sh",
+    "test:docker:qr": "bash scripts/e2e/qr-import-docker.sh",
+    "test:docker:doctor-switch": "bash scripts/e2e/doctor-install-switch-docker.sh",
+    "test:docker:plugins": "bash scripts/e2e/plugins-docker.sh",
+    "test:docker:cleanup": "bash scripts/test-cleanup-docker.sh",
+    "test:docker:all": "pnpm test:docker:live-models && pnpm test:docker:live-gateway && pnpm test:docker:onboard && pnpm test:docker:gateway-network && pnpm test:docker:qr && pnpm test:docker:doctor-switch && pnpm test:docker:plugins && pnpm test:docker:cleanup",
+    "test:all": "pnpm lint && pnpm build && pnpm test && pnpm test:e2e && pnpm test:live && pnpm test:docker:all",
+    "test:install:e2e": "bash scripts/test-install-sh-e2e-docker.sh",
+    "test:install:smoke": "bash scripts/test-install-sh-docker.sh",
+    "test:install:e2e:openai": "CLAWDBOT_E2E_MODELS=openai bash scripts/test-install-sh-e2e-docker.sh",
+    "test:install:e2e:anthropic": "CLAWDBOT_E2E_MODELS=anthropic bash scripts/test-install-sh-e2e-docker.sh",
+    "protocol:gen": "node --import tsx scripts/protocol-gen.ts",
+    "protocol:gen:swift": "node --import tsx scripts/protocol-gen-swift.ts",
+    "protocol:check": "pnpm protocol:gen && pnpm protocol:gen:swift && git diff --exit-code -- dist/protocol.schema.json apps/macos/Sources/ClawdbotProtocol/GatewayModels.swift",
+    "canvas:a2ui:bundle": "bash scripts/bundle-a2ui.sh",
+    "check:loc": "node --import tsx scripts/check-ts-max-loc.ts --max 500"
   }
-}
+}

package/dist/gateway/hooks/tool-usage-capture.js

@@ -1,253 +0,0 @@
-/**
- * Tool Usage Capture Hook
- *
- * Captures tool usage automatically via lifecycle hooks.
- * Safe: never throws, async operations, feature-flagged.
- *
- * Integration:
- * - Registers as onToolUse hook
- * - Captures all tool calls automatically
- * - Stores compressed data in SessionEntry
- */
-import { TOOL_USAGE_ENABLED, TOOL_USAGE_MAX_RECORDS, createToolUsageRecord, updateToolStats, addToHistory, } from "./tool-usage-storage.js";
-// ============================================================================
-// Configuration
-// ============================================================================
-const TOOL_USAGE_BUFFER_FLUSH_INTERVAL = 30000; // 30 seconds
-const TOOL_USAGE_BUFFER_MAX_SIZE = 50; // Flush after 50 tool calls
-const toolUsageBuffer = new Map();
-let bufferFlushScheduled = false;
-// ============================================================================
-// SessionEntry Extension (Type-safe, backward compatible)
-// ============================================================================
-/**
- * Load tool usage from SessionEntry
- * Safe: handles missing data, validates structure
- */
-export async function loadSessionToolUsage(sessionKey) {
-    try {
-        // TODO: Integrate with actual SessionEntry in Phase 4
-        // For now, return in-memory placeholder
-        const existing = toolUsageBuffer.get(sessionKey);
-        if (existing && existing.length > 0) {
-            // Return computed stats from buffer
-            const tools = {};
-            for (const record of existing) {
-                if (!tools[record.toolName]) {
-                    tools[record.toolName] = {
-                        count: 0,
-                        totalMs: 0,
-                        avgMs: 0,
-                        lastUsed: record.timestamp,
-                    };
-                }
-                tools[record.toolName] = updateToolStats(tools[record.toolName], record.executionTimeMs);
-            }
-            return {
-                version: 2,
-                sessionKey,
-                sessionId: sessionKey, // Placeholder
-                tools,
-                history: existing,
-                lastCaptured: Date.now(),
-            };
-        }
-        // Return empty usage
-        return {
-            version: 2,
-            sessionKey,
-            sessionId: sessionKey,
-            tools: {},
-            history: [],
-            lastCaptured: Date.now(),
-        };
-    }
-    catch (err) {
-        console.error("[tool-usage-capture] Failed to load tool usage:", err);
-        // Return empty usage on error
-        return {
-            version: 2,
-            sessionKey,
-            sessionId: sessionKey,
-            tools: {},
-            history: [],
-            lastCaptured: Date.now(),
-        };
-    }
-}
-/**
- * Save tool usage to SessionEntry
- * Safe: validates data, handles errors gracefully
- */
-export async function saveSessionToolUsage(sessionKey, usage) {
-    try {
-        // TODO: Integrate with actual SessionEntry in Phase 4
-        // For now, just update in-memory buffer
-        const existing = toolUsageBuffer.get(sessionKey) || [];
-        const newRecords = usage.history.slice(existing.length);
-        if (newRecords.length > 0) {
-            toolUsageBuffer.set(sessionKey, [...existing, ...newRecords]);
-        }
-        if (TOOL_USAGE_ENABLED) {
-            console.log(`[tool-usage-capture] Saved ${newRecords.length} records for ${sessionKey}`);
-        }
-    }
-    catch (err) {
-        console.error("[tool-usage-capture] Failed to save tool usage:", err);
-        // Never throw - errors are logged only
-    }
-}
-// ============================================================================
-// Hook Implementation
-// ============================================================================
-/**
- * Main hook: captures tool usage automatically
- * Safe: validates all inputs, never throws, handles all edge cases
- */
-export const toolUsageCaptureHook = async (ctx) => {
-    // Feature flag check (safe exit)
-    if (!TOOL_USAGE_ENABLED) {
-        return;
-    }
-    try {
-        // Validate inputs (safe defaults)
-        const toolName = ctx.toolName || "unknown_tool";
-        const executionTimeMs = ctx.executionTimeMs || 0;
-        const success = ctx.success !== undefined ? ctx.success : true;
-        // Create compressed record
-        const record = createToolUsageRecord(toolName, ctx.toolInput, ctx.toolOutput, executionTimeMs, success, ctx.error);
-        // Load existing usage
-        const usage = await loadSessionToolUsage(ctx.sessionKey);
-        // Update stats
-        if (!usage.tools[toolName]) {
-            usage.tools[toolName] = {
-                count: 0,
-                totalMs: 0,
-                avgMs: 0,
-                lastUsed: record.timestamp,
-            };
-        }
-        usage.tools[toolName] = updateToolStats(usage.tools[toolName], executionTimeMs);
-        // Add to history (respects max limit)
-        usage.history = addToHistory(usage.history, record, TOOL_USAGE_MAX_RECORDS);
-        usage.lastCaptured = Date.now();
-        // Save (async, non-blocking)
-        await saveSessionToolUsage(ctx.sessionKey, usage).catch((err) => {
-            // Save errors are logged in saveSessionToolUsage
-            // This catch is just for extra safety
-            console.error("[tool-usage-capture] Unhandled save error:", err);
-        });
-        // Debug logging (can be disabled)
-        if (success && TOOL_USAGE_ENABLED) {
-            console.log(`[tool-usage-capture] ${toolName} (${executionTimeMs}ms) - ${ctx.sessionKey}`);
-        }
-    }
-    catch (err) {
-        // NEVER throw from hook - would break the tool call
-        console.error("[tool-usage-capture] Hook error:", err);
-    }
-};
-// ============================================================================
-// Buffer Management (performance optimization)
-// ============================================================================
-/**
- * Flush in-memory buffer to storage
- * Safe: handles errors, never throws
- */
-export async function flushToolUsageBuffer() {
-    try {
-        if (toolUsageBuffer.size === 0) {
-            return; // Nothing to flush
-        }
-        let flushed = 0;
-        for (const [sessionKey, records] of toolUsageBuffer.entries()) {
-            try {
-                // TODO: Actually persist to SessionEntry in Phase 4
-                // For now, buffer stays in-memory
-                flushed += records.length;
-            }
-            catch (err) {
-                console.error(`[tool-usage-capture] Failed to flush buffer for ${sessionKey}:`, err);
-            }
-        }
-        if (flushed > 0 && TOOL_USAGE_ENABLED) {
-            console.log(`[tool-usage-capture] Flushed ${flushed} records from buffer`);
-        }
-    }
-    catch (err) {
-        console.error("[tool-usage-capture] Buffer flush error:", err);
-    }
-}
-/**
- * Schedule buffer flush
- * Safe: debounced, only schedules once
- */
-function scheduleBufferFlush() {
-    if (bufferFlushScheduled) {
-        return; // Already scheduled
-    }
-    bufferFlushScheduled = true;
-    // Flush after 30 seconds
-    setTimeout(async () => {
-        await flushToolUsageBuffer();
-        bufferFlushScheduled = false;
-    }, TOOL_USAGE_BUFFER_FLUSH_INTERVAL);
-}
-// ============================================================================
-// Query API (for future use)
-// ============================================================================
-/**
- * Get tool usage statistics for a session
- * Safe: returns empty object if no data
- */
-export async function getSessionToolUsage(sessionKey) {
-    try {
-        const usage = await loadSessionToolUsage(sessionKey);
-        return usage;
-    }
-    catch (err) {
-        console.error(`[tool-usage-capture] Failed to get usage for ${sessionKey}:`, err);
-        return undefined;
-    }
-}
-/**
- * Get recent tool usage (last N records)
- * Safe: returns empty array if no data
- */
-export async function getRecentToolUsage(sessionKey, count = 10) {
-    try {
-        const usage = await loadSessionToolUsage(sessionKey);
-        return usage.history.slice(-count);
-    }
-    catch (err) {
-        console.error(`[tool-usage-capture] Failed to get recent usage for ${sessionKey}:`, err);
-        return [];
-    }
-}
-// ============================================================================
-// Cleanup
-// ============================================================================
-/**
- * Clear tool usage buffer (for testing)
- * Safe: never throws
- */
-export function clearToolUsageBuffer() {
-    try {
-        toolUsageBuffer.clear();
-    }
-    catch (err) {
-        console.error("[tool-usage-capture] Buffer clear error:", err);
-    }
-}
-/**
- * Clear tool usage for a specific session
- * Safe: never throws
- */
-export function clearSessionToolUsage(sessionKey) {
-    try {
-        toolUsageBuffer.delete(sessionKey);
-    }
-    catch (err) {
-        console.error(`[tool-usage-capture] Failed to clear usage for ${sessionKey}:`, err);
-    }
-}

package/dist/gateway/hooks/tool-usage-storage.js

@@ -1,144 +0,0 @@
-/**
- * Tool Usage Capture - Storage Layer
- *
- * Safe, efficient storage for tool usage data.
- * Phase 2a: Type definitions and interfaces (NO breaking changes)
- *
- * Safety measures:
- * - All fields optional (backward compatible)
- * - Version field for future migrations
- * - No modifications to existing SessionEntry fields
- */
-// ============================================================================
-// Constants
-// ============================================================================
-export const TOOL_USAGE_MAX_RECORDS = 100; // Keep only last 100 records
-export const TOOL_USAGE_MAX_SUMMARY_LEN = 100; // Max 100 chars per summary
-export const TOOL_USAGE_ENABLED = true; // Feature flag (master switch)
-// ============================================================================
-// Compression Functions (safe, no side effects)
-// ============================================================================
-/**
- * Compress a tool input/output value to a short summary
- * Safe: never throws, handles all types gracefully
- */
-export function compressToolValue(value, maxLen = TOOL_USAGE_MAX_SUMMARY_LEN) {
-    try {
-        // Handle primitives
-        if (value === null)
-            return "null";
-        if (value === undefined)
-            return "undefined";
-        if (typeof value === "string") {
-            return value.length > maxLen ? value.slice(0, maxLen) + "..." : value;
-        }
-        if (typeof value === "number")
-            return String(value);
-        if (typeof value === "boolean")
-            return String(value);
-        // Handle objects and arrays
-        if (typeof value === "object") {
-            const json = JSON.stringify(value);
-            return json.length > maxLen ? json.slice(0, maxLen) + "..." : json;
-        }
-        // Fallback
-        return String(value);
-    }
-    catch (err) {
-        // If compression fails, return safe fallback
-        return "[compression_error]";
-    }
-}
-/**
- * Create a tool usage record from hook context
- * Safe: validates all inputs, never throws
- */
-export function createToolUsageRecord(toolName, toolInput, toolOutput, executionTimeMs, success, error) {
-    // Validate inputs (safe defaults)
-    const safeToolName = typeof toolName === "string" && toolName.length > 0 ? toolName : "unknown_tool";
-    const safeInput = typeof toolInput === "object" && toolInput !== null ? toolInput : {};
-    const safeTime = typeof executionTimeMs === "number" && executionTimeMs >= 0 ? executionTimeMs : 0;
-    const safeSuccess = Boolean(success);
-    return {
-        toolName: safeToolName,
-        timestamp: Date.now(),
-        executionTimeMs: safeTime,
-        success: safeSuccess,
-        inputSummary: compressToolValue(safeInput),
-        outputSummary: compressToolValue(toolOutput),
-        error: error ? String(error).slice(0, 200) : undefined,
-    };
-}
-// ============================================================================
-// Statistics Update (pure function, no side effects)
-// ============================================================================
-/**
- * Update tool statistics with a new record
- * Safe: never mutates input, returns new object
- */
-export function updateToolStats(existingStats, executionTimeMs) {
-    const count = (existingStats?.count ?? 0) + 1;
-    const totalMs = (existingStats?.totalMs ?? 0) + executionTimeMs;
-    const avgMs = count > 0 ? Math.round((totalMs / count) * 100) / 100 : 0;
-    return {
-        count,
-        totalMs,
-        avgMs,
-        lastUsed: Date.now(),
-    };
-}
-// ============================================================================
-// History Management (pure functions)
-// ============================================================================
-/**
- * Add record to history, respecting max limit
- * Safe: never exceeds max records, returns new array
- */
-export function addToHistory(history, record, maxRecords = TOOL_USAGE_MAX_RECORDS) {
-    const newHistory = [...history, record];
-    // Keep only last N records
-    if (newHistory.length > maxRecords) {
-        return newHistory.slice(-maxRecords);
-    }
-    return newHistory;
-}
-/**
- * Get recent tool usage (last N records)
- * Safe: never mutates input, returns slice
- */
-export function getRecentToolUsage(history, count = 10) {
-    return history.slice(-count);
-}
-// ============================================================================
-// Query Functions (for future use)
-// ============================================================================
-/**
- * Get statistics for a specific tool
- * Safe: returns undefined if tool not found
- */
-export function getToolStats(usage, toolName) {
-    return usage?.tools[toolName];
-}
-/**
- * Get all tool names sorted by usage frequency
- * Safe: returns empty array if no data
- */
-export function getToolsByFrequency(usage) {
-    if (!usage?.tools)
-        return [];
-    return Object.entries(usage.tools)
-        .map(([toolName, stats]) => ({ toolName, count: stats.count }))
-        .sort((a, b) => b.count - a.count);
-}
-/**
- * Get slowest tools (by average execution time)
- * Safe: returns empty array if no data
- */
-export function getSlowestTools(usage, limit = 5) {
-    if (!usage?.tools)
-        return [];
-    return Object.entries(usage.tools)
-        .map(([toolName, stats]) => ({ toolName, avgMs: stats.avgMs }))
-        .sort((a, b) => b.avgMs - a.avgMs)
-        .slice(0, limit);
-}