@marifold/core 0.60.0 → 0.64.0

package/dist/agent/AttachmentResources.js

@@ -0,0 +1,192 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AttachmentResource = exports.MAX_ATTACHMENT_SEARCH_RESULTS = exports.DEFAULT_ATTACHMENT_SEARCH_RESULTS = exports.MAX_ATTACHMENT_READ_CHARS = exports.DEFAULT_ATTACHMENT_READ_CHARS = exports.ATTACHMENT_PREVIEW_CHARS = void 0;
+exports.isTextAttachment = isTextAttachment;
+exports.formatAttachmentSearch = formatAttachmentSearch;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+exports.ATTACHMENT_PREVIEW_CHARS = 8_000;
+exports.DEFAULT_ATTACHMENT_READ_CHARS = 8_000;
+exports.MAX_ATTACHMENT_READ_CHARS = 20_000;
+exports.DEFAULT_ATTACHMENT_SEARCH_RESULTS = 8;
+exports.MAX_ATTACHMENT_SEARCH_RESULTS = 20;
+const TEXT_EXTENSIONS = new Set([
+    '.txt', '.md', '.markdown', '.json', '.jsonl', '.yaml', '.yml', '.toml', '.ini',
+    '.csv', '.tsv', '.xml', '.html', '.css', '.js', '.mjs', '.cjs', '.ts', '.tsx',
+    '.jsx', '.py', '.rb', '.go', '.rs', '.java', '.kt', '.swift', '.c', '.h', '.cpp',
+    '.hpp', '.cs', '.sh', '.zsh', '.bash', '.fish', '.sql', '.log', '.diff', '.patch',
+]);
+const FORMAT_LABELS = new Map([
+    ['.xlsx', 'Excel workbook'],
+    ['.xlsm', 'macro-enabled Excel workbook'],
+    ['.xls', 'legacy Excel workbook'],
+    ['.docx', 'Word document'],
+    ['.doc', 'legacy Word document'],
+    ['.odt', 'OpenDocument text'],
+    ['.pptx', 'PowerPoint presentation'],
+    ['.ppt', 'legacy PowerPoint presentation'],
+    ['.odp', 'OpenDocument presentation'],
+    ['.pdf', 'PDF document'],
+    ['.epub', 'EPUB ebook'],
+    ['.mobi', 'Mobipocket ebook'],
+    ['.azw', 'Kindle ebook'],
+    ['.azw3', 'Kindle ebook'],
+    ['.zip', 'ZIP archive'],
+    ['.tar', 'TAR archive'],
+    ['.gz', 'gzip archive'],
+    ['.7z', '7-Zip archive'],
+]);
+/**
+ * Format-neutral attachment facade. Original files remain authoritative and
+ * local; model-visible content is always a bounded derived view.
+ */
+class AttachmentResource {
+    attachment;
+    constructor(attachment) {
+        this.attachment = attachment;
+    }
+    inspect(maxPreviewChars = exports.ATTACHMENT_PREVIEW_CHARS) {
+        const source = this.readableText();
+        const pathLine = this.attachment.path
+            ? `Read-only run path: ${this.attachment.path}`
+            : 'Read-only run path: unavailable';
+        const header = [
+            `Attachment: ${this.attachment.name}`,
+            `Format: ${formatLabel(this.attachment)}`,
+            `Media type: ${this.attachment.mediaType}`,
+            `Size: ${formatBytes(this.attachment.size)}`,
+            pathLine,
+        ];
+        if (source === undefined) {
+            return {
+                hasReadableText: false,
+                content: [
+                    ...header,
+                    'Readable view: unavailable for this format.',
+                    'For a complete-file task, use a format-specific local tool against the read-only run path and write deliverables to $MARIFOLD_OUTPUT_DIR.',
+                ].join('\n'),
+            };
+        }
+        const previewLimit = Math.max(1, Math.min(maxPreviewChars, exports.ATTACHMENT_PREVIEW_CHARS));
+        const preview = source.slice(0, previewLimit);
+        const remainder = source.length - preview.length;
+        return {
+            hasReadableText: true,
+            content: [
+                ...header,
+                `Readable view: ${source.length.toLocaleString('en-US')} characters.`,
+                'Use read_attachment for bounded ranges and search_attachment to find relevant passages.',
+                'For joins, conversions, edits, or other complete-file operations, process the read-only path locally instead of reading the whole document into model context.',
+                '',
+                'Preview:',
+                preview || '(empty)',
+                ...(remainder > 0 ? [`[preview bounded — ${remainder.toLocaleString('en-US')} characters not shown]`] : []),
+            ].join('\n'),
+        };
+    }
+    read(start, maxChars) {
+        const source = this.readableText();
+        if (source === undefined)
+            return undefined;
+        const safeStart = Math.min(Math.max(0, start), source.length);
+        const safeLimit = Math.max(1, Math.min(maxChars, exports.MAX_ATTACHMENT_READ_CHARS));
+        const content = source.slice(safeStart, safeStart + safeLimit);
+        return {
+            content,
+            start: safeStart,
+            end: safeStart + content.length,
+            total: source.length,
+            unit: 'characters',
+        };
+    }
+    search(query, maxResults) {
+        const source = this.readableText();
+        if (source === undefined)
+            return undefined;
+        const needle = query.toLocaleLowerCase();
+        const limit = Math.max(1, Math.min(maxResults, exports.MAX_ATTACHMENT_SEARCH_RESULTS));
+        const matches = [];
+        let totalMatches = 0;
+        for (const [index, line] of source.split(/\r?\n/).entries()) {
+            if (!line.toLocaleLowerCase().includes(needle))
+                continue;
+            totalMatches += 1;
+            if (matches.length < limit) {
+                matches.push({ line: index + 1, text: line.slice(0, 1_000) });
+            }
+        }
+        return { matches, truncated: totalMatches > matches.length };
+    }
+    readableText() {
+        if (this.attachment.inspectionText !== undefined)
+            return this.attachment.inspectionText;
+        if (!this.attachment.path || !isTextAttachment(this.attachment))
+            return undefined;
+        try {
+            return fs.readFileSync(this.attachment.path, 'utf8');
+        }
+        catch {
+            return undefined;
+        }
+    }
+}
+exports.AttachmentResource = AttachmentResource;
+function isTextAttachment(attachment) {
+    return attachment.mediaType.startsWith('text/')
+        || TEXT_EXTENSIONS.has(path.extname(attachment.name).toLowerCase());
+}
+function formatAttachmentSearch(result, query) {
+    if (result.matches.length === 0)
+        return `No matches for ${JSON.stringify(query)}.`;
+    return [
+        ...result.matches.map(match => `Line ${match.line}: ${match.text}`),
+        ...(result.truncated ? ['[additional matches omitted; narrow the query to inspect them]'] : []),
+    ].join('\n');
+}
+function formatLabel(attachment) {
+    if (attachment.image)
+        return 'image';
+    const extension = path.extname(attachment.name).toLowerCase();
+    return FORMAT_LABELS.get(extension) ?? (isTextAttachment(attachment) ? 'text document' : 'binary file');
+}
+function formatBytes(bytes) {
+    if (bytes < 1024)
+        return `${bytes} B`;
+    if (bytes < 1024 * 1024)
+        return `${(bytes / 1024).toFixed(1)} KiB`;
+    return `${(bytes / (1024 * 1024)).toFixed(1)} MiB`;
+}
+//# sourceMappingURL=AttachmentResources.js.map

package/dist/agent/AttachmentResources.js.map

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

package/dist/agent/RunArtifacts.d.ts

@@ -0,0 +1,18 @@
+import type { RunWorkspace } from './RunWorkspace';
+export declare const MAX_RUN_ARTIFACTS = 50;
+export declare const MAX_RUN_ARTIFACT_BYTES: number;
+export interface RunArtifact {
+    id: string;
+    name: string;
+    mediaType: string;
+    size: number;
+}
+export interface ResolvedRunArtifact extends RunArtifact {
+    path: string;
+}
+/** List regular output files without following symlinks. The model can write
+ * only inside the run capability set, but download resolution independently
+ * revalidates containment so an output symlink cannot expose another file. */
+export declare function listRunArtifacts(workspace: Pick<RunWorkspace, 'outputDir'>): RunArtifact[];
+export declare function resolveRunArtifact(runId: string, artifactId: string): ResolvedRunArtifact | undefined;
+//# sourceMappingURL=RunArtifacts.d.ts.map

package/dist/agent/RunArtifacts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RunArtifacts.d.ts","sourceRoot":"","sources":["../../src/agent/RunArtifacts.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnD,eAAO,MAAM,iBAAiB,KAAK,CAAC;AACpC,eAAO,MAAM,sBAAsB,QAAoB,CAAC;AAExD,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,mBAAoB,SAAQ,WAAW;IACtD,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;8EAE8E;AAC9E,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,IAAI,CAAC,YAAY,EAAE,WAAW,CAAC,GACzC,WAAW,EAAE,CAEf;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS,CAIrG"}

package/dist/agent/RunArtifacts.js

@@ -0,0 +1,137 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MAX_RUN_ARTIFACT_BYTES = exports.MAX_RUN_ARTIFACTS = void 0;
+exports.listRunArtifacts = listRunArtifacts;
+exports.resolveRunArtifact = resolveRunArtifact;
+const crypto = __importStar(require("crypto"));
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const WorkspacePaths_1 = require("../workspace/WorkspacePaths");
+exports.MAX_RUN_ARTIFACTS = 50;
+exports.MAX_RUN_ARTIFACT_BYTES = 512 * 1024 * 1024;
+/** List regular output files without following symlinks. The model can write
+ * only inside the run capability set, but download resolution independently
+ * revalidates containment so an output symlink cannot expose another file. */
+function listRunArtifacts(workspace) {
+    return listResolvedArtifacts(workspace.outputDir).map(({ path: _path, ...artifact }) => artifact);
+}
+function resolveRunArtifact(runId, artifactId) {
+    if (!/^[A-Za-z0-9_-]{1,160}$/.test(runId) || !/^[a-f0-9]{24}$/.test(artifactId))
+        return undefined;
+    const outputDir = path.join((0, WorkspacePaths_1.marifoldHome)(), 'runs', runId, 'output');
+    return listResolvedArtifacts(outputDir).find(artifact => artifact.id === artifactId);
+}
+function listResolvedArtifacts(outputDir) {
+    let root;
+    try {
+        root = fs.realpathSync(outputDir);
+    }
+    catch {
+        return [];
+    }
+    const artifacts = [];
+    const pending = [root];
+    while (pending.length > 0 && artifacts.length < exports.MAX_RUN_ARTIFACTS) {
+        const directory = pending.shift();
+        let entries;
+        try {
+            entries = fs.readdirSync(directory, { withFileTypes: true })
+                .sort((left, right) => left.name.localeCompare(right.name));
+        }
+        catch {
+            continue;
+        }
+        for (const entry of entries) {
+            if (artifacts.length >= exports.MAX_RUN_ARTIFACTS)
+                break;
+            const candidate = path.join(directory, entry.name);
+            if (entry.isSymbolicLink())
+                continue;
+            if (entry.isDirectory()) {
+                pending.push(candidate);
+                continue;
+            }
+            if (!entry.isFile())
+                continue;
+            try {
+                const real = fs.realpathSync(candidate);
+                if (!isInside(real, root))
+                    continue;
+                const stat = fs.statSync(real);
+                if (!stat.isFile() || stat.size > exports.MAX_RUN_ARTIFACT_BYTES)
+                    continue;
+                const relative = path.relative(root, real).split(path.sep).join('/');
+                artifacts.push({
+                    id: crypto.createHash('sha256').update(relative).digest('hex').slice(0, 24),
+                    name: relative,
+                    mediaType: mediaTypeFor(relative),
+                    size: stat.size,
+                    path: real,
+                });
+            }
+            catch {
+                // An output may disappear while a process is finishing; omit it.
+            }
+        }
+    }
+    return artifacts;
+}
+function isInside(candidate, root) {
+    const relative = path.relative(root, candidate);
+    return relative === '' || (!relative.startsWith(`..${path.sep}`) && relative !== '..' && !path.isAbsolute(relative));
+}
+function mediaTypeFor(name) {
+    switch (path.extname(name).toLowerCase()) {
+        case '.xlsx': return 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet';
+        case '.xls': return 'application/vnd.ms-excel';
+        case '.docx': return 'application/vnd.openxmlformats-officedocument.wordprocessingml.document';
+        case '.doc': return 'application/msword';
+        case '.pptx': return 'application/vnd.openxmlformats-officedocument.presentationml.presentation';
+        case '.ppt': return 'application/vnd.ms-powerpoint';
+        case '.pdf': return 'application/pdf';
+        case '.epub': return 'application/epub+zip';
+        case '.csv': return 'text/csv; charset=utf-8';
+        case '.txt': return 'text/plain; charset=utf-8';
+        case '.json': return 'application/json';
+        case '.zip': return 'application/zip';
+        case '.png': return 'image/png';
+        case '.jpg':
+        case '.jpeg': return 'image/jpeg';
+        case '.webp': return 'image/webp';
+        default: return 'application/octet-stream';
+    }
+}
+//# sourceMappingURL=RunArtifacts.js.map

package/dist/agent/RunArtifacts.js.map

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

package/dist/agent/tools/InspectAttachmentTool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"InspectAttachmentTool.d.ts","sourceRoot":"","sources":["../../../src/agent/tools/InspectAttachmentTool.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EACL,SAAS,EAGT,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,EACnB,MAAM,iBAAiB,CAAC;AAUzB;gFACgF;AAChF,qBAAa,qBAAsB,YAAW,SAAS;IACrD,QAAQ,CAAC,IAAI,EAAG,MAAM,CAAU;IAChC,QAAQ,CAAC,UAAU;QACjB,IAAI;QACJ,WAAW;QAMX,UAAU;YACR,IAAI;YACJ,UAAU;gBACR,aAAa;oBACX,IAAI;oBACJ,WAAW;;;YAGf,QAAQ;;MAEV;IAEF,aAAa,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,MAAM,CAEtD;IAED,UAAU,IAAI,kBAAkB,CAK/B;IAEK,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,EAAE,GAAG,EAAE,oBAAoB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAuCvG;CACF"}
+{"version":3,"file":"InspectAttachmentTool.d.ts","sourceRoot":"","sources":["../../../src/agent/tools/InspectAttachmentTool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EACL,SAAS,EAET,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,EACnB,MAAM,iBAAiB,CAAC;AAGzB;gFACgF;AAChF,qBAAa,qBAAsB,YAAW,SAAS;IACrD,QAAQ,CAAC,IAAI,EAAG,MAAM,CAAU;IAChC,QAAQ,CAAC,UAAU;QACjB,IAAI;QACJ,WAAW;QAMX,UAAU;YACR,IAAI;YACJ,UAAU;gBACR,aAAa;oBACX,IAAI;oBACJ,WAAW;;;YAGf,QAAQ;;MAEV;IAEF,aAAa,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,MAAM,CAEtD;IAED,UAAU,IAAI,kBAAkB,CAK/B;IAEK,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,EAAE,GAAG,EAAE,oBAAoB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAyBvG;CACF"}

package/dist/agent/tools/InspectAttachmentTool.js

@@ -1,49 +1,8 @@
 "use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.InspectAttachmentTool = void 0;
-const fs = __importStar(require("fs"));
-const path = __importStar(require("path"));
 const ToolRegistry_1 = require("../ToolRegistry");
-const ReadFileTool_1 = require("./ReadFileTool");
-const TEXT_EXTENSIONS = new Set([
-    '.txt', '.md', '.markdown', '.json', '.jsonl', '.yaml', '.yml', '.toml', '.ini',
-    '.csv', '.tsv', '.xml', '.html', '.css', '.js', '.mjs', '.cjs', '.ts', '.tsx',
-    '.jsx', '.py', '.rb', '.go', '.rs', '.java', '.kt', '.swift', '.c', '.h', '.cpp',
-    '.hpp', '.cs', '.sh', '.zsh', '.bash', '.fish', '.sql', '.log', '.diff', '.patch',
-]);
+const AttachmentResources_1 = require("../AttachmentResources");
 /** Attachment-scoped, read-only inspection. The model supplies an opaque ID,
  * never a host path; the run workspace resolves that ID to the exact upload. */
 class InspectAttachmentTool {
@@ -52,7 +11,7 @@ class InspectAttachmentTool {
         name: 'inspect_attachment',
         description: [
             'Inspect one attachment uploaded for the current run by its attachment ID.',
-            'Images become visible to the model; text and pre-extracted documents return bounded readable text; other binaries return safe metadata and their read-only run path.',
+            'Images become visible to the model; documents return metadata, their read-only run path, capabilities, and a small bounded preview when available.',
             'When to use: the objective or skill depends on an attached image, document, spreadsheet, audio file, or other upload.',
             'When NOT to use: arbitrary filesystem paths, bundled skill files, or information already present in the prompt.',
         ].join(' '),
@@ -94,36 +53,12 @@ class InspectAttachmentTool {
                 summary: `opened image ${attachment.name}`,
             };
         }
-        const text = attachment.inspectionText ?? readTextAttachment(attachment.path, attachment.name, attachment.mediaType);
-        if (text !== undefined) {
-            return {
-                content: (0, ToolRegistry_1.capToolOutput)(text, ctx.outputLimit),
-                summary: `inspected ${attachment.name}`,
-            };
-        }
-        const location = attachment.path ? `\nRead-only run path: ${attachment.path}` : '';
+        const inspection = new AttachmentResources_1.AttachmentResource(attachment).inspect(ctx.outputLimit);
         return {
-            content: [
-                `Attachment: ${attachment.name}`,
-                `Media type: ${attachment.mediaType}`,
-                `Size: ${(0, ReadFileTool_1.formatBytes)(attachment.size)}`,
-                location,
-                'No built-in readable preview is available for this format. Use a format-specific local tool against the run path if the task requires deeper inspection.',
-            ].filter(Boolean).join('\n'),
+            content: inspection.content,
             summary: `inspected metadata for ${attachment.name}`,
         };
     }
 }
 exports.InspectAttachmentTool = InspectAttachmentTool;
-function readTextAttachment(filePath, name, mediaType) {
-    if (!filePath || (!mediaType.startsWith('text/') && !TEXT_EXTENSIONS.has(path.extname(name).toLowerCase()))) {
-        return undefined;
-    }
-    try {
-        return fs.readFileSync(filePath, 'utf8');
-    }
-    catch (error) {
-        return `Could not read ${name}: ${error instanceof Error ? error.message : String(error)}`;
-    }
-}
 //# sourceMappingURL=InspectAttachmentTool.js.map

package/dist/agent/tools/InspectAttachmentTool.js.map

@@ -1 +1 @@
-{"version":3,"file":"InspectAttachmentTool.js","sourceRoot":"","sources":["../../../src/agent/tools/InspectAttachmentTool.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"InspectAttachmentTool.js","sourceRoot":"","sources":["../../../src/agent/tools/InspectAttachmentTool.ts"],"names":[],"mappings":";;;AACA,kDAMyB;AACzB,gEAA4D;AAE5D;gFACgF;AAChF;IACW,IAAI,GAAG,MAAe,CAAC;IACvB,UAAU,GAAG;QACpB,IAAI,EAAE,oBAAoB;QAC1B,WAAW,EAAE;YACX,2EAA2E;YAC3E,oJAAoJ;YACpJ,uHAAuH;YACvH,iHAAiH;SAClH,CAAC,IAAI,CAAC,GAAG,CAAC;QACX,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,aAAa,EAAE;oBACb,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,2EAA2E;iBACzF;aACF;YACD,QAAQ,EAAE,CAAC,eAAe,CAAC;SAC5B;KACF,CAAC;IAEF,aAAa,CAAC,KAAgC;QAC5C,OAAO,WAAW,OAAO,KAAK,CAAC,aAAa,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,sBAAsB,EAAE,CAAC;IAC7G,CAAC;IAED,UAAU;QACR,yEAAyE;QACzE,0EAA0E;QAC1E,iCAAiC;QACjC,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC5C,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,KAAgC,EAAE,GAAyB;QACvE,MAAM,EAAE,GAAG,IAAA,iCAAkB,EAAC,KAAK,EAAE,eAAe,EAAE,oBAAoB,CAAC,CAAC;QAC5E,MAAM,UAAU,GAAG,GAAG,CAAC,SAAS,EAAE,WAAW,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;QACrF,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,MAAM,SAAS,GAAG,GAAG,CAAC,SAAS,EAAE,WAAW,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,QAAQ,CAAC;YACnG,OAAO;gBACL,OAAO,EAAE,eAAe,EAAE,6DAA6D,SAAS,GAAG;gBACnG,OAAO,EAAE,cAAc,EAAE,YAAY;gBACrC,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QAED,IAAI,UAAU,CAAC,KAAK,EAAE,CAAC;YACrB,OAAO;gBACL,OAAO,EAAE,cAAc,UAAU,CAAC,EAAE,KAAK,UAAU,CAAC,IAAI,KAAK,UAAU,CAAC,SAAS,6EAA6E;gBAC9J,MAAM,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC;gBAC1B,OAAO,EAAE,gBAAgB,UAAU,CAAC,IAAI,EAAE;aAC3C,CAAC;QACJ,CAAC;QAED,MAAM,UAAU,GAAG,IAAI,wCAAkB,CAAC,UAAU,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QAC/E,OAAO;YACL,OAAO,EAAE,UAAU,CAAC,OAAO;YAC3B,OAAO,EAAE,0BAA0B,UAAU,CAAC,IAAI,EAAE;SACrD,CAAC;IACJ,CAAC;CACF"}

package/dist/agent/tools/ReadAttachmentTool.d.ts

@@ -0,0 +1,34 @@
+import type { JSONValue } from '@priest-ai/core';
+import { AgentTool, ToolExecutionContext, ToolExecutionResult, ToolRiskAssessment } from '../ToolRegistry';
+export declare class ReadAttachmentTool implements AgentTool {
+    readonly kind: 'read';
+    readonly definition: {
+        name: string;
+        description: string;
+        parameters: {
+            type: string;
+            properties: {
+                attachment_id: {
+                    type: string;
+                    description: string;
+                };
+                start: {
+                    type: string;
+                    minimum: number;
+                    description: string;
+                };
+                max_chars: {
+                    type: string;
+                    minimum: number;
+                    maximum: number;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+    };
+    summarizeCall(input: Record<string, JSONValue>): string;
+    assessRisk(): ToolRiskAssessment;
+    execute(input: Record<string, JSONValue>, ctx: ToolExecutionContext): Promise<ToolExecutionResult>;
+}
+//# sourceMappingURL=ReadAttachmentTool.d.ts.map

package/dist/agent/tools/ReadAttachmentTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReadAttachmentTool.d.ts","sourceRoot":"","sources":["../../../src/agent/tools/ReadAttachmentTool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAMjD,OAAO,EACL,SAAS,EAET,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,EACnB,MAAM,iBAAiB,CAAC;AAEzB,qBAAa,kBAAmB,YAAW,SAAS;IAClD,QAAQ,CAAC,IAAI,EAAG,MAAM,CAAU;IAChC,QAAQ,CAAC,UAAU;;;;;;;oBAUI,IAAI;oBAAY,WAAW;;;oBACnC,IAAI;oBAAa,OAAO;oBAAK,WAAW;;;;;;;;;;;MAUrD;IAEF,aAAa,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,MAAM,CAItD;IAED,UAAU,IAAI,kBAAkB,CAE/B;IAEK,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,EAAE,GAAG,EAAE,oBAAoB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CA+BvG;CACF"}

package/dist/agent/tools/ReadAttachmentTool.js

@@ -0,0 +1,84 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReadAttachmentTool = void 0;
+const AttachmentResources_1 = require("../AttachmentResources");
+const ToolRegistry_1 = require("../ToolRegistry");
+class ReadAttachmentTool {
+    kind = 'read';
+    definition = {
+        name: 'read_attachment',
+        description: [
+            'Read one bounded range from the derived readable view of an uploaded attachment.',
+            'When to use: inspect a relevant section after inspect_attachment identified the document structure or search_attachment found a location.',
+            'When NOT to use: load an entire large document, transform a complete file, or access an arbitrary filesystem path. Complete-file operations should use local tools against the read-only run path.',
+        ].join(' '),
+        parameters: {
+            type: 'object',
+            properties: {
+                attachment_id: { type: 'string', description: 'Opaque attachment ID from the current run manifest.' },
+                start: { type: 'integer', minimum: 0, description: 'Zero-based character offset in the readable view. Defaults to 0.' },
+                max_chars: {
+                    type: 'integer',
+                    minimum: 1,
+                    maximum: AttachmentResources_1.MAX_ATTACHMENT_READ_CHARS,
+                    description: `Maximum characters to return. Defaults to ${AttachmentResources_1.DEFAULT_ATTACHMENT_READ_CHARS}.`,
+                },
+            },
+            required: ['attachment_id'],
+        },
+    };
+    summarizeCall(input) {
+        const id = typeof input.attachment_id === 'string' ? input.attachment_id : '<missing attachment>';
+        const start = integerInput(input.start, 0);
+        return `read ${id} from character ${start}`;
+    }
+    assessRisk() {
+        return { escalate: false, trusted: true };
+    }
+    async execute(input, ctx) {
+        const id = (0, ToolRegistry_1.requireStringInput)(input, 'attachment_id', 'read_attachment');
+        const attachment = ctx.workspace?.attachments.find(candidate => candidate.id === id);
+        if (!attachment)
+            return missingAttachment(id, ctx);
+        const start = integerInput(input.start, 0);
+        const maxChars = integerInput(input.max_chars, AttachmentResources_1.DEFAULT_ATTACHMENT_READ_CHARS);
+        if (start < 0 || maxChars < 1 || maxChars > AttachmentResources_1.MAX_ATTACHMENT_READ_CHARS) {
+            return {
+                content: `read_attachment requires start >= 0 and max_chars between 1 and ${AttachmentResources_1.MAX_ATTACHMENT_READ_CHARS}.`,
+                summary: `invalid read range for ${attachment.name}`,
+                isError: true,
+            };
+        }
+        const result = new AttachmentResources_1.AttachmentResource(attachment).read(start, maxChars);
+        if (!result) {
+            return {
+                content: `No built-in readable view is available for ${attachment.name}. Use a format-specific local tool against ${attachment.path ?? 'its staged run path'}.`,
+                summary: `no readable view for ${attachment.name}`,
+                isError: true,
+            };
+        }
+        return {
+            content: [
+                `Attachment: ${attachment.name}`,
+                `Characters ${result.start}-${result.end} of ${result.total}`,
+                '',
+                result.content || '(empty range)',
+                ...(result.end < result.total ? [`[more available; continue with start=${result.end}]`] : []),
+            ].join('\n'),
+            summary: `read characters ${result.start}-${result.end} from ${attachment.name}`,
+        };
+    }
+}
+exports.ReadAttachmentTool = ReadAttachmentTool;
+function integerInput(value, fallback) {
+    return typeof value === 'number' && Number.isInteger(value) ? value : fallback;
+}
+function missingAttachment(id, ctx) {
+    const available = ctx.workspace?.attachments.map(candidate => candidate.id).join(', ') || '(none)';
+    return {
+        content: `Attachment '${id}' is not available in this run. Available attachment IDs: ${available}.`,
+        summary: `attachment ${id} not found`,
+        isError: true,
+    };
+}
+//# sourceMappingURL=ReadAttachmentTool.js.map

package/dist/agent/tools/ReadAttachmentTool.js.map

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