@xandout/libra-harness 0.1.119 → 0.1.121

package/dist/extensions/tool-buffer/extension.d.ts

@@ -1,89 +0,0 @@
-import type { Extension } from '../../extension.js';
-/**
- * Config for the tool-buffer extension.
- */
-export interface ToolBufferConfig {
-    /**
-     * Directory to store buffered tool outputs. Created if it doesn't exist.
-     * Default: `./tool-buffers`.
-     */
-    bufferDir?: string;
-    /**
-     * Minimum content length (characters) to trigger buffering. Tool
-     * results shorter than this are passed through unchanged. Default:
-     * `2000`.
-     */
-    threshold?: number;
-    /**
-     * Tool names to buffer (whitelist). If set, only these tools are
-     * buffered. If omitted, all tools are eligible. Default: all tools.
-     */
-    tools?: string[];
-    /**
-     * Tool names to exclude from buffering (blacklist). Takes precedence
-     * over `tools`. Default: none.
-     */
-    excludeTools?: string[];
-    /**
-     * Whether to preserve the first N characters of the original content
-     * in the pointer message, giving the LLM a preview without needing
-     * to grep. Default: `200`.
-     */
-    previewLength?: number;
-    /**
-     * Prefix for buffer file names. A random ID is appended. Default:
-     * `buffer_`.
-     */
-    filePrefix?: string;
-    /**
-     * Name of the no-buffer control tool exposed to the LLM. Default:
-     * `no_buffer`.
-     */
-    noBufferToolName?: string;
-}
-/**
- * Tool-buffer extension — redirects large tool outputs to files.
- *
- * Hooks `afterTool` and checks the result content size. If it exceeds
- * the configured threshold, the content is written to a file in
- * `bufferDir` and the tool result is replaced with a pointer message:
- *
- * ```
- * [tool-buffer] Output saved to tool-buffers/buffer_a1b2c3.txt
- * (234 lines, 12.5 KB). Use grep to search within this file.
- *
- * Preview (first 200 chars):
- * {"jobs":[{"id":"JT-001","name":"Kitchen remodel"},…
- * ```
- *
- * This keeps the LLM context small when tools return large datasets
- * (e.g. list_jobs, list_messages, search results) while preserving
- * full access to the data via a grep tool or filesystem reads.
- *
- * By default, all tools are buffered. Use `excludeTools` to exempt
- * tools whose output the LLM always needs inline (e.g. read_file,
- * send_message, status checks). The LLM can also call `no_buffer`
- * at runtime to bypass buffering on demand.
- *
- * ## LLM-controlled bypass
- *
- * The extension registers a `no_buffer` tool that the LLM can call to
- * disable buffering on demand — either for the next tool call only or
- * for the rest of the turn. This gives the LLM real-time control without
- * any tool knowing about buffering.
- *
- * - `no_buffer({ scope: "next" })` — skip buffering for the next tool
- *   call only. The flag is cleared after one tool executes.
- * - `no_buffer({ scope: "turn" })` — skip buffering for all remaining
- *   tool calls in this turn.
- *
- * The LLM typically calls `no_buffer` before a tool whose full output
- * it needs inline (e.g. reading a file it intends to summarize).
- *
- * ## Priority
- *
- * Uses priority -50 (runs after most extensions) so it sees the final
- * tool result after other extensions have potentially modified it.
- */
-export default function createToolBufferExtension(config?: ToolBufferConfig): Extension;
-//# sourceMappingURL=extension.d.ts.map

package/dist/extensions/tool-buffer/extension.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"extension.d.ts","sourceRoot":"","sources":["../../../src/extensions/tool-buffer/extension.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAIpD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAOD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AACH,MAAM,CAAC,OAAO,UAAU,yBAAyB,CAC/C,MAAM,CAAC,EAAE,gBAAgB,GACxB,SAAS,CAyIX"}

package/dist/extensions/tool-buffer/extension.js

@@ -1,182 +0,0 @@
-import { writeFileSync, mkdirSync, existsSync } from 'node:fs';
-import { join } from 'node:path';
-import { randomBytes } from 'node:crypto';
-// ── Turn-level flag keys (stored in turn.metadata) ──────────────────
-// These are internal to the extension and not part of the public API.
-const FLAG_NEXT = '_toolBuffer_skipNext';
-const FLAG_TURN = '_toolBuffer_skipTurn';
-/**
- * Tool-buffer extension — redirects large tool outputs to files.
- *
- * Hooks `afterTool` and checks the result content size. If it exceeds
- * the configured threshold, the content is written to a file in
- * `bufferDir` and the tool result is replaced with a pointer message:
- *
- * ```
- * [tool-buffer] Output saved to tool-buffers/buffer_a1b2c3.txt
- * (234 lines, 12.5 KB). Use grep to search within this file.
- *
- * Preview (first 200 chars):
- * {"jobs":[{"id":"JT-001","name":"Kitchen remodel"},…
- * ```
- *
- * This keeps the LLM context small when tools return large datasets
- * (e.g. list_jobs, list_messages, search results) while preserving
- * full access to the data via a grep tool or filesystem reads.
- *
- * By default, all tools are buffered. Use `excludeTools` to exempt
- * tools whose output the LLM always needs inline (e.g. read_file,
- * send_message, status checks). The LLM can also call `no_buffer`
- * at runtime to bypass buffering on demand.
- *
- * ## LLM-controlled bypass
- *
- * The extension registers a `no_buffer` tool that the LLM can call to
- * disable buffering on demand — either for the next tool call only or
- * for the rest of the turn. This gives the LLM real-time control without
- * any tool knowing about buffering.
- *
- * - `no_buffer({ scope: "next" })` — skip buffering for the next tool
- *   call only. The flag is cleared after one tool executes.
- * - `no_buffer({ scope: "turn" })` — skip buffering for all remaining
- *   tool calls in this turn.
- *
- * The LLM typically calls `no_buffer` before a tool whose full output
- * it needs inline (e.g. reading a file it intends to summarize).
- *
- * ## Priority
- *
- * Uses priority -50 (runs after most extensions) so it sees the final
- * tool result after other extensions have potentially modified it.
- */
-export default function createToolBufferExtension(config) {
-    const bufferDir = config?.bufferDir ?? './tool-buffers';
-    const threshold = config?.threshold ?? 2000;
-    const whitelist = config?.tools ? new Set(config.tools) : undefined;
-    const blacklist = config?.excludeTools ? new Set(config.excludeTools) : undefined;
-    const previewLength = config?.previewLength ?? 200;
-    const filePrefix = config?.filePrefix ?? 'buffer_';
-    const noBufferToolName = config?.noBufferToolName ?? 'no_buffer';
-    // Ensure buffer directory exists at setup time.
-    if (!existsSync(bufferDir)) {
-        mkdirSync(bufferDir, { recursive: true });
-    }
-    function shouldBuffer(toolName) {
-        if (blacklist?.has(toolName))
-            return false;
-        if (whitelist && !whitelist.has(toolName))
-            return false;
-        return true;
-    }
-    function formatSize(bytes) {
-        if (bytes < 1024)
-            return `${bytes} B`;
-        if (bytes < 1024 * 1024)
-            return `${(bytes / 1024).toFixed(1)} KB`;
-        return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
-    }
-    // ── no_buffer tool ────────────────────────────────────────────────
-    const noBufferTool = {
-        name: noBufferToolName,
-        description: 'Disable tool output buffering. Call this before a tool whose full output you need inline ' +
-            '(e.g. reading a file you intend to summarize or quote). ' +
-            'scope "next" skips buffering for the next tool call only. ' +
-            'scope "turn" skips buffering for all remaining tool calls this turn.',
-        parameters: {
-            type: 'object',
-            properties: {
-                scope: {
-                    type: 'string',
-                    enum: ['next', 'turn'],
-                    description: '"next" = skip buffering for the next tool call only (default). "turn" = skip for all remaining tool calls this turn.',
-                    default: 'next',
-                },
-            },
-        },
-        async execute(args, ctx) {
-            const scope = args.scope ?? 'next';
-            if (scope === 'turn') {
-                ctx.metadata[FLAG_TURN] = true;
-            }
-            else {
-                ctx.metadata[FLAG_NEXT] = true;
-            }
-            return {
-                toolCallId: '',
-                content: `Buffering disabled for ${scope === 'turn' ? 'the rest of this turn' : 'the next tool call'}.`,
-            };
-        },
-    };
-    return {
-        name: 'tool-buffer',
-        priority: -50,
-        install(agent) {
-            // Register the no_buffer tool so the LLM can call it.
-            agent.tool(noBufferTool);
-            agent.hook('afterTool', 'tool-buffer', async (ctx) => {
-                if (!ctx.toolCall || !ctx.toolResult)
-                    return;
-                // The no_buffer tool itself is never buffered.
-                if (ctx.toolCall.name === noBufferToolName)
-                    return;
-                const toolName = ctx.toolCall.name;
-                const result = ctx.toolResult;
-                const meta = ctx.turn.metadata;
-                // Check bypass flags set by the no_buffer tool.
-                const skipTurn = meta[FLAG_TURN] === true;
-                const skipNext = meta[FLAG_NEXT] === true;
-                if (skipTurn || skipNext) {
-                    // Clear the one-shot flag (turn flag persists).
-                    if (skipNext)
-                        delete meta[FLAG_NEXT];
-                    return;
-                }
-                // Don't buffer error results — the LLM needs to see those inline.
-                if (result.isError)
-                    return;
-                // Don't buffer empty or short results.
-                const content = result.content;
-                if (!content || content.length < threshold)
-                    return;
-                // Check whitelist/blacklist.
-                if (!shouldBuffer(toolName))
-                    return;
-                // Generate a unique filename.
-                const id = randomBytes(4).toString('hex');
-                const fileName = `${filePrefix}${id}.txt`;
-                const filePath = join(bufferDir, fileName);
-                // Write the full content to the buffer file.
-                try {
-                    writeFileSync(filePath, content, 'utf-8');
-                }
-                catch (err) {
-                    // If we can't write, pass the result through unchanged.
-                    // Don't break the tool call over a buffering failure.
-                    return;
-                }
-                // Build the pointer message.
-                const lineCount = content.split('\n').length;
-                const sizeBytes = Buffer.byteLength(content, 'utf-8');
-                const preview = content.slice(0, previewLength);
-                const previewTruncated = content.length > previewLength ? '…' : '';
-                const pointer = [
-                    `[tool-buffer] Output saved to ${filePath}`,
-                    `(${lineCount} lines, ${formatSize(sizeBytes)}). Use grep to search within this file.`,
-                    '',
-                    `If you need the full output inline, call no_buffer({ scope: "next" }) and re-run this tool.`,
-                    '',
-                    `Preview (first ${previewLength} chars):`,
-                    preview + previewTruncated,
-                ].join('\n');
-                // Replace the tool result with the pointer.
-                const bufferedResult = {
-                    toolCallId: result.toolCallId,
-                    content: pointer,
-                    isError: false,
-                };
-                return { skip: true, value: bufferedResult };
-            });
-        },
-    };
-}
-//# sourceMappingURL=extension.js.map

package/dist/extensions/tool-buffer/extension.js.map

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

package/dist/extensions/tool-buffer/extension.json

@@ -1,7 +0,0 @@
-{
-  "name": "tool-buffer",
-  "description": "Redirects large tool outputs to files and returns a pointer to the LLM. Keeps context small when tools return large datasets. Pair with a grep tool for searching buffered content.",
-  "enabled": true,
-  "priority": -50,
-  "configKeys": ["bufferDir", "threshold", "tools", "excludeTools", "previewLength", "filePrefix"]
-}

package/dist/extensions/tool-buffer/extension.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=extension.test.d.ts.map

package/dist/extensions/tool-buffer/extension.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"extension.test.d.ts","sourceRoot":"","sources":["../../../src/extensions/tool-buffer/extension.test.ts"],"names":[],"mappings":""}