@strands-agents/sdk 1.0.0-rc.5 → 1.1.0

package/dist/src/vended-plugins/context-offloader/__tests__/storage.test.js

@@ -0,0 +1,148 @@
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import { InMemoryStorage, S3Storage } from '../storage.js';
+describe('InMemoryStorage', () => {
+    it('stores and retrieves text content', async () => {
+        const storage = new InMemoryStorage();
+        const content = new TextEncoder().encode('hello world');
+        const ref = await storage.store('key1', content, 'text/plain');
+        const result = await storage.retrieve(ref);
+        expect(new TextDecoder().decode(result.content)).toBe('hello world');
+        expect(result.contentType).toBe('text/plain');
+    });
+    it('stores and retrieves binary content', async () => {
+        const storage = new InMemoryStorage();
+        const content = new Uint8Array([1, 2, 3, 4, 5]);
+        const ref = await storage.store('key1', content, 'image/png');
+        const result = await storage.retrieve(ref);
+        expect(result.content).toEqual(content);
+        expect(result.contentType).toBe('image/png');
+    });
+    it('generates unique references', async () => {
+        const storage = new InMemoryStorage();
+        const content = new TextEncoder().encode('test');
+        const ref1 = await storage.store('key1', content);
+        const ref2 = await storage.store('key2', content);
+        expect(ref1).not.toBe(ref2);
+    });
+    it('uses mem_ prefix in references', async () => {
+        const storage = new InMemoryStorage();
+        const ref = await storage.store('mykey', new TextEncoder().encode('test'));
+        expect(ref).toMatch(/^mem_\d+_mykey$/);
+    });
+    it('throws on missing reference', async () => {
+        const storage = new InMemoryStorage();
+        await expect(storage.retrieve('nonexistent')).rejects.toThrow('Reference not found: nonexistent');
+    });
+    it('clears all stored content', async () => {
+        const storage = new InMemoryStorage();
+        const ref = await storage.store('key1', new TextEncoder().encode('test'));
+        storage.clear();
+        await expect(storage.retrieve(ref)).rejects.toThrow('Reference not found');
+    });
+    it('defaults content type to text/plain', async () => {
+        const storage = new InMemoryStorage();
+        const ref = await storage.store('key1', new TextEncoder().encode('test'));
+        const result = await storage.retrieve(ref);
+        expect(result.contentType).toBe('text/plain');
+    });
+});
+describe('S3Storage', () => {
+    let mockSend;
+    let mockS3Client;
+    beforeEach(() => {
+        mockSend = vi.fn();
+        mockS3Client = { send: mockSend };
+    });
+    describe('store', () => {
+        it('returns s3:// URI as reference', async () => {
+            mockSend.mockResolvedValue({});
+            const storage = new S3Storage('my-bucket', { s3Client: mockS3Client });
+            const ref = await storage.store('key1', new TextEncoder().encode('test'), 'text/plain');
+            expect(ref).toMatch(/^s3:\/\/my-bucket\//);
+            expect(ref).toContain('key1');
+        });
+        it('includes prefix in s3 key', async () => {
+            mockSend.mockResolvedValue({});
+            const storage = new S3Storage('my-bucket', { prefix: 'artifacts', s3Client: mockS3Client });
+            const ref = await storage.store('key1', new TextEncoder().encode('test'));
+            expect(ref).toMatch(/^s3:\/\/my-bucket\/artifacts\//);
+        });
+        it('normalizes trailing slashes on prefix', async () => {
+            mockSend.mockResolvedValue({});
+            const storage = new S3Storage('b', { prefix: 'p///', s3Client: mockS3Client });
+            const ref = await storage.store('k', new TextEncoder().encode('x'));
+            expect(ref).toMatch(/^s3:\/\/b\/p\//);
+            // Check no double slashes in the path portion (after s3://)
+            const pathPortion = ref.replace('s3://', '');
+            expect(pathPortion).not.toContain('//');
+        });
+        it('sends correct PutObject params', async () => {
+            mockSend.mockResolvedValue({});
+            const storage = new S3Storage('my-bucket', { s3Client: mockS3Client });
+            const content = new TextEncoder().encode('hello');
+            await storage.store('key1', content, 'application/json');
+            expect(mockSend).toHaveBeenCalledOnce();
+            const command = mockSend.mock.calls[0][0];
+            expect(command.input.Bucket).toBe('my-bucket');
+            expect(command.input.Body).toBe(content);
+            expect(command.input.ContentType).toBe('application/json');
+        });
+        it('sanitizes keys', async () => {
+            mockSend.mockResolvedValue({});
+            const storage = new S3Storage('b', { s3Client: mockS3Client });
+            const ref = await storage.store('../../etc/passwd', new TextEncoder().encode('x'));
+            expect(ref).not.toContain('..');
+            expect(ref).not.toContain('etc/passwd');
+        });
+    });
+    describe('retrieve', () => {
+        it('retrieves content by s3:// URI', async () => {
+            mockSend.mockResolvedValueOnce({}).mockResolvedValueOnce({
+                Body: { transformToByteArray: () => Promise.resolve(new Uint8Array([1, 2, 3])) },
+                ContentType: 'image/png',
+            });
+            const storage = new S3Storage('my-bucket', { s3Client: mockS3Client });
+            const ref = await storage.store('key1', new Uint8Array([1, 2, 3]), 'image/png');
+            const result = await storage.retrieve(ref);
+            expect(result.content).toEqual(new Uint8Array([1, 2, 3]));
+            expect(result.contentType).toBe('image/png');
+        });
+        it('retrieves content by raw key', async () => {
+            mockSend.mockResolvedValue({
+                Body: { transformToByteArray: () => Promise.resolve(new TextEncoder().encode('hello')) },
+                ContentType: 'text/plain',
+            });
+            const storage = new S3Storage('b', { s3Client: mockS3Client });
+            const result = await storage.retrieve('some/raw/key');
+            expect(new TextDecoder().decode(result.content)).toBe('hello');
+            const command = mockSend.mock.calls[0][0];
+            expect(command.input.Key).toBe('some/raw/key');
+        });
+        it('throws on bucket mismatch', async () => {
+            const storage = new S3Storage('my-bucket', { s3Client: mockS3Client });
+            await expect(storage.retrieve('s3://wrong-bucket/key')).rejects.toThrow('bucket mismatch');
+        });
+        it('throws on NoSuchKey error', async () => {
+            const noSuchKey = new Error('not found');
+            noSuchKey.name = 'NoSuchKey';
+            mockSend.mockRejectedValue(noSuchKey);
+            const storage = new S3Storage('b', { s3Client: mockS3Client });
+            await expect(storage.retrieve('missing-key')).rejects.toThrow('Reference not found');
+        });
+        it('defaults contentType to application/octet-stream when missing', async () => {
+            mockSend.mockResolvedValue({
+                Body: { transformToByteArray: () => Promise.resolve(new Uint8Array([0])) },
+            });
+            const storage = new S3Storage('b', { s3Client: mockS3Client });
+            const result = await storage.retrieve('key');
+            expect(result.contentType).toBe('application/octet-stream');
+        });
+        it('rethrows non-NoSuchKey errors', async () => {
+            const networkError = new Error('network timeout');
+            mockSend.mockRejectedValue(networkError);
+            const storage = new S3Storage('b', { s3Client: mockS3Client });
+            await expect(storage.retrieve('key')).rejects.toThrow('network timeout');
+        });
+    });
+});
+//# sourceMappingURL=storage.test.js.map

package/dist/src/vended-plugins/context-offloader/__tests__/storage.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.test.js","sourceRoot":"","sources":["../../../../../src/vended-plugins/context-offloader/__tests__/storage.test.ts"],"names":[],"mappings":"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"}

package/dist/src/vended-plugins/context-offloader/__tests__/storage.test.node.d.ts

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

package/dist/src/vended-plugins/context-offloader/__tests__/storage.test.node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.test.node.d.ts","sourceRoot":"","sources":["../../../../../src/vended-plugins/context-offloader/__tests__/storage.test.node.ts"],"names":[],"mappings":""}

package/dist/src/vended-plugins/context-offloader/__tests__/storage.test.node.js

@@ -0,0 +1,78 @@
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import { FileStorage } from '../storage.js';
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import * as os from 'node:os';
+describe('FileStorage', () => {
+    let tmpDir;
+    beforeEach(async () => {
+        tmpDir = await fs.mkdtemp(path.join(os.tmpdir(), 'context-offloader-test-'));
+    });
+    afterEach(async () => {
+        await fs.rm(tmpDir, { recursive: true, force: true });
+    });
+    it('stores and retrieves text content', async () => {
+        const storage = new FileStorage(tmpDir);
+        const content = new TextEncoder().encode('hello world');
+        const ref = await storage.store('key1', content, 'text/plain');
+        const result = await storage.retrieve(ref);
+        expect(new TextDecoder().decode(result.content)).toBe('hello world');
+        expect(result.contentType).toBe('text/plain');
+    });
+    it('stores and retrieves binary content', async () => {
+        const storage = new FileStorage(tmpDir);
+        const content = new Uint8Array([1, 2, 3, 4, 5]);
+        const ref = await storage.store('key1', content, 'image/png');
+        const result = await storage.retrieve(ref);
+        expect(result.content).toEqual(content);
+        expect(result.contentType).toBe('image/png');
+    });
+    it('returns file path as reference preserving configured directory', async () => {
+        const storage = new FileStorage(tmpDir);
+        const content = new TextEncoder().encode('test');
+        const ref = await storage.store('k1', content, 'text/plain');
+        expect(ref.startsWith(tmpDir)).toBe(true);
+        expect(ref).toMatch(/\.txt$/);
+    });
+    it('uses correct file extensions', async () => {
+        const storage = new FileStorage(tmpDir);
+        const content = new TextEncoder().encode('test');
+        const txtRef = await storage.store('k1', content, 'text/plain');
+        expect(txtRef).toMatch(/\.txt$/);
+        const jsonRef = await storage.store('k2', content, 'application/json');
+        expect(jsonRef).toMatch(/\.json$/);
+        const pngRef = await storage.store('k3', content, 'image/png');
+        expect(pngRef).toMatch(/\.png$/);
+    });
+    it('throws on missing reference', async () => {
+        const storage = new FileStorage(tmpDir);
+        await expect(storage.retrieve(path.join(tmpDir, 'nonexistent.txt'))).rejects.toThrow('Reference not found');
+    });
+    it('sanitizes keys for safe filenames', async () => {
+        const storage = new FileStorage(tmpDir);
+        const content = new TextEncoder().encode('test');
+        const ref = await storage.store('../../../etc/passwd', content, 'text/plain');
+        expect(ref).not.toContain('..');
+    });
+    it('prevents path traversal on retrieve', async () => {
+        const storage = new FileStorage(tmpDir);
+        await expect(storage.retrieve('../../etc/passwd')).rejects.toThrow('Reference not found');
+    });
+    it('creates artifact directory if it does not exist', async () => {
+        const nestedDir = path.join(tmpDir, 'nested', 'dir');
+        const storage = new FileStorage(nestedDir);
+        const content = new TextEncoder().encode('test');
+        await storage.store('key1', content, 'text/plain');
+        const stat = await fs.stat(nestedDir);
+        expect(stat.isDirectory()).toBe(true);
+    });
+    it('persists metadata across instances', async () => {
+        const storage1 = new FileStorage(tmpDir);
+        const content = new TextEncoder().encode('test');
+        const ref = await storage1.store('key1', content, 'application/json');
+        const storage2 = new FileStorage(tmpDir);
+        const result = await storage2.retrieve(ref);
+        expect(result.contentType).toBe('application/json');
+    });
+});
+//# sourceMappingURL=storage.test.node.js.map

package/dist/src/vended-plugins/context-offloader/__tests__/storage.test.node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.test.node.js","sourceRoot":"","sources":["../../../../../src/vended-plugins/context-offloader/__tests__/storage.test.node.ts"],"names":[],"mappings":"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"}

package/dist/src/vended-plugins/context-offloader/index.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Context offloading plugin for Strands Agents.
+ *
+ * This module provides the ContextOffloader plugin and Storage backends for
+ * automatically offloading oversized tool results to external storage, replacing
+ * them with truncated previews and actionable storage references.
+ *
+ * @example
+ * ```typescript
+ * import { Agent } from '@strands-agents/sdk'
+ * import { ContextOffloader, InMemoryStorage } from '@strands-agents/sdk/vended-plugins/context-offloader'
+ *
+ * const agent = new Agent({
+ *   model,
+ *   plugins: [new ContextOffloader({ storage: new InMemoryStorage() })],
+ * })
+ * ```
+ */
+export { ContextOffloader } from './plugin.js';
+export type { ContextOffloaderConfig } from './plugin.js';
+export type { Storage } from './storage.js';
+export { InMemoryStorage, FileStorage, S3Storage } from './storage.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/vended-plugins/context-offloader/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/vended-plugins/context-offloader/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAC9C,YAAY,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAA;AACzD,YAAY,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAC3C,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA"}

package/dist/src/vended-plugins/context-offloader/index.js

@@ -0,0 +1,21 @@
+/**
+ * Context offloading plugin for Strands Agents.
+ *
+ * This module provides the ContextOffloader plugin and Storage backends for
+ * automatically offloading oversized tool results to external storage, replacing
+ * them with truncated previews and actionable storage references.
+ *
+ * @example
+ * ```typescript
+ * import { Agent } from '@strands-agents/sdk'
+ * import { ContextOffloader, InMemoryStorage } from '@strands-agents/sdk/vended-plugins/context-offloader'
+ *
+ * const agent = new Agent({
+ *   model,
+ *   plugins: [new ContextOffloader({ storage: new InMemoryStorage() })],
+ * })
+ * ```
+ */
+export { ContextOffloader } from './plugin.js';
+export { InMemoryStorage, FileStorage, S3Storage } from './storage.js';
+//# sourceMappingURL=index.js.map

package/dist/src/vended-plugins/context-offloader/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/vended-plugins/context-offloader/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAG9C,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA"}

package/dist/src/vended-plugins/context-offloader/plugin.d.ts

@@ -0,0 +1,48 @@
+import type { Plugin } from '../../plugins/plugin.js';
+import type { Tool } from '../../tools/tool.js';
+import type { LocalAgent } from '../../types/agent.js';
+import type { Storage } from './storage.js';
+/** Configuration for the {@link ContextOffloader} plugin. */
+export interface ContextOffloaderConfig {
+    /** Storage backend for persisting offloaded content. */
+    storage: Storage;
+    /** Token threshold above which tool results are offloaded. Defaults to 2,500. */
+    maxResultTokens?: number;
+    /** Number of tokens to keep as an inline preview. Defaults to 1,000. */
+    previewTokens?: number;
+    /** Whether to register the `retrieve_offloaded_content` tool. Defaults to true. */
+    includeRetrievalTool?: boolean;
+}
+/**
+ * Plugin that offloads oversized tool results to reduce context consumption.
+ *
+ * When a tool result exceeds the configured token threshold, this plugin stores
+ * each content block to a storage backend and replaces the in-context result with
+ * a truncated text preview plus per-block storage references.
+ *
+ * @example
+ * ```typescript
+ * import { ContextOffloader, InMemoryStorage } from '@strands-agents/sdk/vended-plugins/context-offloader'
+ *
+ * const agent = new Agent({
+ *   model,
+ *   plugins: [new ContextOffloader({ storage: new InMemoryStorage() })],
+ * })
+ * ```
+ */
+export declare class ContextOffloader implements Plugin {
+    readonly name = "strands:context-offloader";
+    private readonly _storage;
+    private readonly _maxResultTokens;
+    private readonly _previewTokens;
+    private readonly _includeRetrievalTool;
+    private _retrievalTool;
+    constructor(config: ContextOffloaderConfig);
+    initAgent(agent: LocalAgent): void;
+    getTools(): Tool[];
+    private _createRetrievalTool;
+    private _storeBlock;
+    private _buildPreviewText;
+    private _handleToolResult;
+}
+//# sourceMappingURL=plugin.d.ts.map

package/dist/src/vended-plugins/context-offloader/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../../src/vended-plugins/context-offloader/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAA;AACrD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAA;AAC/C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AAUtD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAmE3C,6DAA6D;AAC7D,MAAM,WAAW,sBAAsB;IACrC,wDAAwD;IACxD,OAAO,EAAE,OAAO,CAAA;IAChB,iFAAiF;IACjF,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,wEAAwE;IACxE,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,mFAAmF;IACnF,oBAAoB,CAAC,EAAE,OAAO,CAAA;CAC/B;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,gBAAiB,YAAW,MAAM;IAC7C,QAAQ,CAAC,IAAI,+BAA8B;IAE3C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAQ;IACzC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAQ;IACvC,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAS;IAC/C,OAAO,CAAC,cAAc,CAAkB;gBAE5B,MAAM,EAAE,sBAAsB;IAc1C,SAAS,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAIlC,QAAQ,IAAI,IAAI,EAAE;IAQlB,OAAO,CAAC,oBAAoB;YAoBd,WAAW;IAiCzB,OAAO,CAAC,iBAAiB;YA4BX,iBAAiB;CA4DhC"}

package/dist/src/vended-plugins/context-offloader/plugin.js

@@ -0,0 +1,244 @@
+import { AfterToolCallEvent } from '../../hooks/events.js';
+import { TextBlock, JsonBlock, ToolResultBlock, Message } from '../../types/messages.js';
+import { ImageBlock, VideoBlock, DocumentBlock } from '../../types/media.js';
+import { tool } from '../../tools/tool-factory.js';
+import { z } from 'zod';
+import { logger } from '../../logging/logger.js';
+const CHARS_PER_TOKEN = 4;
+const DEFAULT_MAX_RESULT_TOKENS = 2_500;
+const DEFAULT_PREVIEW_TOKENS = 1_000;
+const RETRIEVAL_TOOL_NAME = 'retrieve_offloaded_content';
+function slicePreview(text, previewTokens) {
+    const maxChars = previewTokens * CHARS_PER_TOKEN;
+    if (text.length <= maxChars)
+        return text;
+    return text.slice(0, maxChars);
+}
+function getBytes(block) {
+    if (block instanceof ImageBlock && block.source.type === 'imageSourceBytes') {
+        return block.source.bytes;
+    }
+    if (block instanceof VideoBlock && block.source.type === 'videoSourceBytes') {
+        return block.source.bytes;
+    }
+    if (block instanceof DocumentBlock) {
+        if (block.source.type === 'documentSourceBytes')
+            return block.source.bytes;
+        if (block.source.type === 'documentSourceText')
+            return new TextEncoder().encode(block.source.text);
+    }
+    return undefined;
+}
+function decodeStoredContent(content, contentType, reference) {
+    if (contentType.startsWith('text/')) {
+        return new TextDecoder().decode(content);
+    }
+    if (contentType === 'application/json') {
+        const text = new TextDecoder().decode(content);
+        try {
+            return JSON.parse(text);
+        }
+        catch {
+            return text;
+        }
+    }
+    // Return native content blocks for binary types so the agent sees the actual content.
+    // FunctionTool._wrapInToolResult passes ImageBlock/VideoBlock/DocumentBlock through as-is
+    // at runtime, even though the callback type signature only accepts JSONValue.
+    if (contentType.startsWith('image/')) {
+        const format = contentType.split('/').pop();
+        return new ImageBlock({
+            format: format,
+            source: { bytes: content },
+        });
+    }
+    if (contentType.startsWith('video/')) {
+        const format = contentType.split('/').pop();
+        return new VideoBlock({
+            format: format,
+            source: { bytes: content },
+        });
+    }
+    if (contentType.startsWith('application/')) {
+        const format = contentType.split('/').pop();
+        return new DocumentBlock({
+            format: format,
+            name: reference,
+            source: { bytes: content },
+        });
+    }
+    return new TextDecoder('utf-8', { fatal: false }).decode(content);
+}
+/**
+ * Plugin that offloads oversized tool results to reduce context consumption.
+ *
+ * When a tool result exceeds the configured token threshold, this plugin stores
+ * each content block to a storage backend and replaces the in-context result with
+ * a truncated text preview plus per-block storage references.
+ *
+ * @example
+ * ```typescript
+ * import { ContextOffloader, InMemoryStorage } from '@strands-agents/sdk/vended-plugins/context-offloader'
+ *
+ * const agent = new Agent({
+ *   model,
+ *   plugins: [new ContextOffloader({ storage: new InMemoryStorage() })],
+ * })
+ * ```
+ */
+export class ContextOffloader {
+    name = 'strands:context-offloader';
+    _storage;
+    _maxResultTokens;
+    _previewTokens;
+    _includeRetrievalTool;
+    _retrievalTool;
+    constructor(config) {
+        const maxResultTokens = config.maxResultTokens ?? DEFAULT_MAX_RESULT_TOKENS;
+        const previewTokens = config.previewTokens ?? DEFAULT_PREVIEW_TOKENS;
+        if (maxResultTokens <= 0)
+            throw new Error('maxResultTokens must be positive');
+        if (previewTokens < 0)
+            throw new Error('previewTokens must be non-negative');
+        if (previewTokens >= maxResultTokens)
+            throw new Error('previewTokens must be less than maxResultTokens');
+        this._storage = config.storage;
+        this._maxResultTokens = maxResultTokens;
+        this._previewTokens = previewTokens;
+        this._includeRetrievalTool = config.includeRetrievalTool ?? true;
+    }
+    initAgent(agent) {
+        agent.addHook(AfterToolCallEvent, (event) => this._handleToolResult(event));
+    }
+    getTools() {
+        if (!this._includeRetrievalTool)
+            return [];
+        if (!this._retrievalTool) {
+            this._retrievalTool = this._createRetrievalTool();
+        }
+        return [this._retrievalTool];
+    }
+    _createRetrievalTool() {
+        const storage = this._storage;
+        return tool({
+            name: RETRIEVAL_TOOL_NAME,
+            description: 'Retrieve offloaded content by reference. Use this tool when you see a placeholder with a reference (ref: ...) and need the full content. Only use this as a fallback if the data cannot be accessed using your existing tools.',
+            inputSchema: z.object({
+                reference: z.string().describe('The reference string from the offload placeholder.'),
+            }),
+            callback: async (input) => {
+                try {
+                    const result = await storage.retrieve(input.reference);
+                    return decodeStoredContent(result.content, result.contentType, input.reference);
+                }
+                catch {
+                    return `Error: reference not found: ${input.reference}`;
+                }
+            },
+        });
+    }
+    async _storeBlock(block, key) {
+        if (block instanceof TextBlock && block.text) {
+            const ref = await this._storage.store(key, new TextEncoder().encode(block.text), 'text/plain');
+            return { ref, contentType: 'text/plain', description: `text, ${block.text.length.toLocaleString()} chars` };
+        }
+        if (block instanceof JsonBlock) {
+            const jsonStr = JSON.stringify(block.json, null, 2);
+            const jsonBytes = new TextEncoder().encode(jsonStr);
+            const ref = await this._storage.store(key, jsonBytes, 'application/json');
+            return { ref, contentType: 'application/json', description: `json, ${jsonBytes.length.toLocaleString()} bytes` };
+        }
+        if (block instanceof ImageBlock || block instanceof VideoBlock || block instanceof DocumentBlock) {
+            const bytes = getBytes(block);
+            const contentType = block instanceof ImageBlock
+                ? `image/${block.format}`
+                : block instanceof VideoBlock
+                    ? `video/${block.format}`
+                    : `application/${block.format}`;
+            const label = block instanceof DocumentBlock ? block.name : contentType;
+            if (bytes) {
+                const ref = await this._storage.store(key, bytes, contentType);
+                return { ref, contentType, description: `${label}, ${bytes.length.toLocaleString()} bytes` };
+            }
+            return { ref: '', contentType, description: `${label}, 0 bytes` };
+        }
+        logger.warn('unsupported content block type encountered during offloading, skipping');
+        return { ref: '', contentType: 'unknown', description: 'unknown block type' };
+    }
+    _buildPreviewText(content, references, tokenCount, fullText) {
+        const preview = fullText ? slicePreview(fullText, this._previewTokens) : '';
+        const refLines = references
+            .filter((r) => r.ref)
+            .map((r) => `  ${r.ref} (${r.description})`)
+            .join('\n');
+        let guidance = 'Tool result was offloaded to external storage due to size.\n' +
+            'Use the preview below to answer if possible.\n' +
+            'Use your available tools to selectively access the data you need.';
+        if (this._includeRetrievalTool) {
+            guidance += '\nYou can also use retrieve_offloaded_content with a reference to get the full content.';
+        }
+        return (`[Offloaded: ${content.length} blocks, ~${tokenCount.toLocaleString()} tokens]\n` +
+            `${guidance}\n\n` +
+            `${preview}\n\n` +
+            `[Stored references:]\n${refLines}`);
+    }
+    async _handleToolResult(event) {
+        if (event.result.status === 'error')
+            return;
+        // Skip results from the retrieval tool to prevent circular offloading
+        if (this._includeRetrievalTool && event.toolUse.name === RETRIEVAL_TOOL_NAME)
+            return;
+        const content = event.result.content;
+        const toolUseId = event.result.toolUseId;
+        const tokenCount = await event.agent.model.countTokens([new Message({ role: 'user', content: [event.result] })]);
+        if (tokenCount <= this._maxResultTokens)
+            return;
+        // Extract text preview from text/JSON blocks
+        const textParts = [];
+        for (const block of content) {
+            if (block instanceof TextBlock && block.text)
+                textParts.push(block.text);
+            else if (block instanceof JsonBlock)
+                textParts.push(JSON.stringify(block.json, null, 2));
+        }
+        const fullText = textParts.join('\n');
+        // Store each content block to the storage backend
+        let references;
+        try {
+            references = await Promise.all(content.map((block, i) => this._storeBlock(block, `${toolUseId}_${i}`)));
+        }
+        catch (err) {
+            logger.warn(`tool_use_id=<${toolUseId}> | failed to offload tool result, keeping original`, err);
+            return;
+        }
+        logger.debug(`tool_use_id=<${toolUseId}>, blocks=<${references.length}>, tokens=<${tokenCount}> | tool result offloaded`);
+        // Build replacement content: preview text + media placeholders
+        const newContent = [
+            new TextBlock(this._buildPreviewText(content, references, tokenCount, fullText)),
+        ];
+        for (let i = 0; i < content.length; i++) {
+            const block = content[i];
+            const ref = references[i]?.ref ?? '';
+            if (block instanceof TextBlock || block instanceof JsonBlock)
+                continue;
+            const bytes = getBytes(block);
+            const size = bytes ? bytes.length : 0;
+            let label;
+            if (block instanceof ImageBlock)
+                label = `image: ${block.format}`;
+            else if (block instanceof VideoBlock)
+                label = `video: ${block.format}`;
+            else if (block instanceof DocumentBlock)
+                label = `document: ${block.format}, ${block.name}`;
+            if (label) {
+                newContent.push(new TextBlock(`[${label}, ${size} bytes${ref ? ` | ref: ${ref}` : ''}]`));
+            }
+        }
+        event.result = new ToolResultBlock({
+            toolUseId: event.result.toolUseId,
+            status: event.result.status,
+            content: newContent,
+        });
+    }
+}
+//# sourceMappingURL=plugin.js.map

package/dist/src/vended-plugins/context-offloader/plugin.js.map

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