@krischoichoi/channel-files 0.6.0

package/README.md

@@ -0,0 +1,79 @@
+# @krischoichoi/channel-files
+
+**Generic Attachment Compatibility Backend** for DeepSeek Harness Channels.
+
+Stores session-scoped non-image attachments and preserves legacy readable
+extraction while Harness does not yet provide a native generic attachment
+contract. Inbound PDF / DOCX / XLSX / text files are stored and exposed to the
+model through the `read_channel_attachment` tool — without routing raw platform
+payloads through the prompt.
+
+Legacy extraction (PDF / DOCX / XLSX / TXT) is **compatibility behavior**: it
+keeps working for existing users via `read_channel_attachment`, and no new
+"understanding" features (ASR, video analysis, OCR, PPTX parsing) are added
+here — those belong to Harness skills, plugins or MCP.
+
+## Install
+
+```bash
+pnpm add @krischoichoi/channel-files
+```
+
+It is included in the `@krischoichoi/dsh-channels` bundle by default. To disable the
+extension, remove the `channels-files` plugin from the bundle patch; Harness
+native images and plain text messages keep working.
+
+## Features
+
+| Area | Detail |
+| --- | --- |
+| Storage | Private, session-scoped asset store under the channel data directory; reads enforce the channel Session ACL |
+| Extraction (compatibility) | Legacy PDF (`unpdf`), DOCX (`mammoth`), XLSX (`xlsx`), plain text — compatibility behavior, no new understanding features |
+| Tool | `read_channel_attachment` (compatibility tool) installs on the agent so models can read stored files |
+| Limits | 100 MiB inbound per file · 32 MiB parser input · 5 MiB extracted text output |
+
+## How it works
+
+`ChannelFileService` implements the `ChannelAttachmentProvider` port from
+`@krischoichoi/channel-harness` (the former `ChannelFileProvider` name is kept as a
+deprecated alias):
+
+```ts
+ctx.channelFiles.store(channelAttachmentContext, binaryPart); // store + extract
+ctx.channelFiles.resolveAttachment(attachmentId, sessionId);  // Session ACL enforced
+await ctx.channelFiles.installCompatibilityTools(agentContext); // add the read tool
+```
+
+## Roadmap
+
+Harness currently has no native generic attachment surface. Until it ships one,
+this package remains the generic attachment backend. Ahead of that, the following
+infrastructure exists **default-off** and activates only via public capability
+detection once the official API appears:
+
+- Attachment Catalog v2 (`attachments/catalog/v2`) — logical `att-*` id → backend
+  locator index, kept separate from the legacy v1 tree;
+- native capability seam (`src/backends/harness-native.ts`) — interface + fake
+  only, never fooled by the image-only `ctx.attachments` service;
+- lazy copy + verify migration (`src/migration/`) — a failed migration keeps the
+  legacy backend authoritative.
+
+Legacy `attachments/v1` data remains permanently readable and is never rewritten
+or deleted on upgrade.
+
+## Development
+
+```bash
+pnpm --filter @krischoichoi/channel-files build
+pnpm --filter @krischoichoi/channel-files typecheck
+pnpm --filter @krischoichoi/channel-files test
+```
+
+## Related
+
+- [Repository root](../../README.md)
+- [Architecture design](../../docs/architecture.md)
+
+## License
+
+[MIT](../../LICENSE)

package/lib/attachment-resolver.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Outbound attachment resolution.
+ *
+ * `resolveAttachment` turns a private-store `attachment_id` into bounded raw
+ * bytes for an outbound media part, enforcing the Session ACL (the asset's
+ * `sessionId` must equal the sender's session). The outbound path is
+ * by-private-store-id ONLY: there is NO model-visible `file_path` anywhere in
+ * this milestone, so the resolver never touches a filesystem path —
+ * the store owns byte access.
+ */
+import type { ChannelInboundAssetStore } from './attachments/store.js';
+import { type AttachmentPolicy } from './attachments/policy.js';
+import { type ResolvedChannelAttachment } from '@krischoichoi/channel-harness';
+export type ResolvedOutboundAttachment = ResolvedChannelAttachment;
+/**
+ * Resolve a private-store attachment id to bounded bytes for an outbound send
+ * ACL: the asset must be owned by `sessionId`. Oversize reads
+ * surface `ATTACHMENT_TOO_LARGE`; a missing asset `ATTACHMENT_NOT_FOUND`;
+ * a foreign asset `ATTACHMENT_ACCESS_DENIED`.
+ */
+export declare function resolveAttachment(attachmentId: string, sessionId: string, store: ChannelInboundAssetStore, options: {
+    policy?: AttachmentPolicy;
+}): Promise<ResolvedOutboundAttachment>;
+//# sourceMappingURL=attachment-resolver.d.ts.map

package/lib/attachment-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachment-resolver.d.ts","sourceRoot":"","sources":["../src/attachment-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAEvE,OAAO,EAA2C,KAAK,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AACzG,OAAO,EAAe,KAAK,yBAAyB,EAAE,MAAM,+BAA+B,CAAC;AAK5F,MAAM,MAAM,0BAA0B,GAAG,yBAAyB,CAAC;AAEnE;;;;;GAKG;AACH,wBAAsB,iBAAiB,CACrC,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,wBAAwB,EAC/B,OAAO,EAAE;IAAE,MAAM,CAAC,EAAE,gBAAgB,CAAA;CAAE,GACrC,OAAO,CAAC,0BAA0B,CAAC,CAgCrC"}

package/lib/attachment-resolver.js

@@ -0,0 +1,38 @@
+import { AssetStoreError } from './attachments/store.js';
+import { DEFAULT_ATTACHMENT_POLICY, rawReadLimit } from './attachments/policy.js';
+import { OutboxError } from '@krischoichoi/channel-harness';
+/** Byte cap applied when the caller supplies no explicit policy. */
+const DEFAULT_BOUND = DEFAULT_ATTACHMENT_POLICY;
+/**
+ * Resolve a private-store attachment id to bounded bytes for an outbound send
+ * ACL: the asset must be owned by `sessionId`. Oversize reads
+ * surface `ATTACHMENT_TOO_LARGE`; a missing asset `ATTACHMENT_NOT_FOUND`;
+ * a foreign asset `ATTACHMENT_ACCESS_DENIED`.
+ */
+export async function resolveAttachment(attachmentId, sessionId, store, options) {
+    const asset = await store.get(attachmentId);
+    if (!asset) {
+        throw new OutboxError('ATTACHMENT_NOT_FOUND', "no stored asset for '" + attachmentId + "'", { sessionId });
+    }
+    if (asset.sessionId !== sessionId) {
+        throw new OutboxError('ATTACHMENT_ACCESS_DENIED', "attachment '" + attachmentId + "' belongs to a different session", { sessionId });
+    }
+    const limit = rawReadLimit(options.policy ?? DEFAULT_BOUND);
+    let data;
+    try {
+        data = await store.readRaw(attachmentId, { maxBytes: limit });
+    }
+    catch (error) {
+        if (error instanceof AssetStoreError && error.code === 'ASSET_TOO_LARGE') {
+            throw new OutboxError('ATTACHMENT_TOO_LARGE', "attachment '" + attachmentId + "' exceeds the outbound size cap " + limit, { sessionId, cause: error });
+        }
+        throw error;
+    }
+    return {
+        kind: asset.kind,
+        data,
+        name: asset.name,
+        ...(asset.mimeType ? { mimeType: asset.mimeType } : {}),
+    };
+}
+//# sourceMappingURL=attachment-resolver.js.map

package/lib/attachment-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachment-resolver.js","sourceRoot":"","sources":["../src/attachment-resolver.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,yBAAyB,EAAE,YAAY,EAAyB,MAAM,yBAAyB,CAAC;AACzG,OAAO,EAAE,WAAW,EAAkC,MAAM,+BAA+B,CAAC;AAE5F,oEAAoE;AACpE,MAAM,aAAa,GAAqB,yBAAyB,CAAC;AAIlE;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,YAAoB,EACpB,SAAiB,EACjB,KAA+B,EAC/B,OAAsC;IAEtC,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IAC5C,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,WAAW,CAAC,sBAAsB,EAAE,uBAAuB,GAAG,YAAY,GAAG,GAAG,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;IAC7G,CAAC;IACD,IAAI,KAAK,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;QAClC,MAAM,IAAI,WAAW,CACnB,0BAA0B,EAC1B,cAAc,GAAG,YAAY,GAAG,kCAAkC,EAClE,EAAE,SAAS,EAAE,CACd,CAAC;IACJ,CAAC;IACD,MAAM,KAAK,GAAG,YAAY,CAAC,OAAO,CAAC,MAAM,IAAI,aAAa,CAAC,CAAC;IAC5D,IAAI,IAAgB,CAAC;IACrB,IAAI,CAAC;QACH,IAAI,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;IAChE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,eAAe,IAAI,KAAK,CAAC,IAAI,KAAK,iBAAiB,EAAE,CAAC;YACzE,MAAM,IAAI,WAAW,CACnB,sBAAsB,EACtB,cAAc,GAAG,YAAY,GAAG,kCAAkC,GAAG,KAAK,EAC1E,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,CAC5B,CAAC;QACJ,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;IACD,OAAO;QACL,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,IAAI;QACJ,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACxD,CAAC;AACJ,CAAC"}

package/lib/attachments/extractors/docx.d.ts

@@ -0,0 +1,6 @@
+import { type Extractor } from './types.js';
+/** The singleton DOCX extractor. */
+export declare const docxExtractor: Extractor;
+/** Whether a (verified) MIME / extension is served by the DOCX extractor. */
+export declare function docxMimeServed(mime: string | undefined): boolean;
+//# sourceMappingURL=docx.d.ts.map

package/lib/attachments/extractors/docx.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docx.d.ts","sourceRoot":"","sources":["../../../src/attachments/extractors/docx.ts"],"names":[],"mappings":"AAYA,OAAO,EAA4D,KAAK,SAAS,EAAE,MAAM,YAAY,CAAC;AAItG,oCAAoC;AACpC,eAAO,MAAM,aAAa,EAAE,SAoB3B,CAAC;AAEF,6EAA6E;AAC7E,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAEhE"}

package/lib/attachments/extractors/docx.js

@@ -0,0 +1,43 @@
+/**
+ * DOCX text extractor.
+ *
+ * Uses the established, pure-JS mammoth@1.12.1 (exact-pinned) to render the
+ * document to plain text. mammoth understands paragraphs, headers, lists
+ * and embedded styles, which a zip+document.xml unzip would only approximate.
+ *
+ * Capped parsing is enforced by the registry/pipeline (input > maxInputBytes
+ * short-circuits before this extractor runs). Here we only map bytes -> text
+ * and wrap any failure into a stable ExtractionError.
+ */
+import mammoth from 'mammoth';
+import { ExtractionError } from './types.js';
+const DOCX_MIME = 'application/vnd.openxmlformats-officedocument.wordprocessingml.document';
+/** The singleton DOCX extractor. */
+export const docxExtractor = {
+    mimes: [DOCX_MIME],
+    extensions: ['docx'],
+    async extract(data, options) {
+        if (options?.signal?.aborted) {
+            throw new ExtractionError('parser-error', 'extraction aborted');
+        }
+        try {
+            const buffer = Buffer.from(data.buffer, data.byteOffset, data.byteLength);
+            const result = await mammoth.extractRawText({ buffer });
+            const text = result.value.trim();
+            if (text.length === 0) {
+                throw new ExtractionError('unsupported', 'no extractable text in docx');
+            }
+            return { format: 'markdown', text };
+        }
+        catch (error) {
+            if (error instanceof ExtractionError)
+                throw error;
+            throw new ExtractionError('parser-error', 'docx text could not be extracted');
+        }
+    },
+};
+/** Whether a (verified) MIME / extension is served by the DOCX extractor. */
+export function docxMimeServed(mime) {
+    return mime?.toLowerCase() === DOCX_MIME;
+}
+//# sourceMappingURL=docx.js.map

package/lib/attachments/extractors/docx.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docx.js","sourceRoot":"","sources":["../../../src/attachments/extractors/docx.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,OAAO,MAAM,SAAS,CAAC;AAC9B,OAAO,EAAE,eAAe,EAA2D,MAAM,YAAY,CAAC;AAEtG,MAAM,SAAS,GAAG,yEAAyE,CAAC;AAE5F,oCAAoC;AACpC,MAAM,CAAC,MAAM,aAAa,GAAc;IACtC,KAAK,EAAE,CAAC,SAAS,CAAC;IAClB,UAAU,EAAE,CAAC,MAAM,CAAC;IACpB,KAAK,CAAC,OAAO,CAAC,IAAgB,EAAE,OAAwB;QACtD,IAAI,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;YAC7B,MAAM,IAAI,eAAe,CAAC,cAAc,EAAE,oBAAoB,CAAC,CAAC;QAClE,CAAC;QACD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;YAC1E,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;YACxD,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;YACjC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACtB,MAAM,IAAI,eAAe,CAAC,aAAa,EAAE,6BAA6B,CAAC,CAAC;YAC1E,CAAC;YACD,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;QACtC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,eAAe;gBAAE,MAAM,KAAK,CAAC;YAClD,MAAM,IAAI,eAAe,CAAC,cAAc,EAAE,kCAAkC,CAAC,CAAC;QAChF,CAAC;IACH,CAAC;CACF,CAAC;AAEF,6EAA6E;AAC7E,MAAM,UAAU,cAAc,CAAC,IAAwB;IACrD,OAAO,IAAI,EAAE,WAAW,EAAE,KAAK,SAAS,CAAC;AAC3C,CAAC"}

package/lib/attachments/extractors/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Extractors: bytes -> readable text for the private store.
+ */
+export * from './types.js';
+export * from './text.js';
+export * from './pdf.js';
+export * from './docx.js';
+export * from './xlsx.js';
+export * from './registry.js';
+//# sourceMappingURL=index.d.ts.map

package/lib/attachments/extractors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/attachments/extractors/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC"}

package/lib/attachments/extractors/index.js

@@ -0,0 +1,10 @@
+/**
+ * Extractors: bytes -> readable text for the private store.
+ */
+export * from './types.js';
+export * from './text.js';
+export * from './pdf.js';
+export * from './docx.js';
+export * from './xlsx.js';
+export * from './registry.js';
+//# sourceMappingURL=index.js.map

package/lib/attachments/extractors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/attachments/extractors/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC"}

package/lib/attachments/extractors/pdf.d.ts

@@ -0,0 +1,4 @@
+import { type Extractor } from './types.js';
+export declare const pdfExtractor: Extractor;
+export declare function pdfMimeServed(mime: string | undefined): boolean;
+//# sourceMappingURL=pdf.d.ts.map

package/lib/attachments/extractors/pdf.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pdf.d.ts","sourceRoot":"","sources":["../../../src/attachments/extractors/pdf.ts"],"names":[],"mappings":"AACA,OAAO,EAIL,KAAK,SAAS,EACf,MAAM,YAAY,CAAC;AASpB,eAAO,MAAM,YAAY,EAAE,SA8B1B,CAAC;AAEF,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAE/D"}

package/lib/attachments/extractors/pdf.js

@@ -0,0 +1,44 @@
+import { extractText, getDocumentProxy } from 'unpdf';
+import { ExtractionError, } from './types.js';
+const PDF_MIME = 'application/pdf';
+function isPdf(data) {
+    return data.byteLength >= 5
+        && new TextDecoder('latin1').decode(data.subarray(0, 5)) === '%PDF-';
+}
+export const pdfExtractor = {
+    mimes: [PDF_MIME],
+    extensions: ['pdf'],
+    async extract(data, options) {
+        if (options?.signal?.aborted) {
+            throw new ExtractionError('parser-error', 'extraction aborted');
+        }
+        if (!isPdf(data)) {
+            throw new ExtractionError('unsupported', 'input is not a pdf file');
+        }
+        let pdf;
+        try {
+            pdf = await getDocumentProxy(data);
+            const result = await extractText(pdf, { mergePages: true });
+            if (options?.signal?.aborted) {
+                throw new ExtractionError('parser-error', 'extraction aborted');
+            }
+            const text = result.text.trim();
+            if (!text) {
+                throw new ExtractionError('unsupported', 'no extractable text in pdf');
+            }
+            return { format: 'text', text };
+        }
+        catch (error) {
+            if (error instanceof ExtractionError)
+                throw error;
+            throw new ExtractionError('parser-error', 'pdf could not be parsed');
+        }
+        finally {
+            await pdf?.cleanup().catch(() => undefined);
+        }
+    },
+};
+export function pdfMimeServed(mime) {
+    return mime?.toLowerCase() === PDF_MIME;
+}
+//# sourceMappingURL=pdf.js.map

package/lib/attachments/extractors/pdf.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pdf.js","sourceRoot":"","sources":["../../../src/attachments/extractors/pdf.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,OAAO,CAAC;AACtD,OAAO,EACL,eAAe,GAIhB,MAAM,YAAY,CAAC;AAEpB,MAAM,QAAQ,GAAG,iBAAiB,CAAC;AAEnC,SAAS,KAAK,CAAC,IAAgB;IAC7B,OAAO,IAAI,CAAC,UAAU,IAAI,CAAC;WACtB,IAAI,WAAW,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC;AACzE,CAAC;AAED,MAAM,CAAC,MAAM,YAAY,GAAc;IACrC,KAAK,EAAE,CAAC,QAAQ,CAAC;IACjB,UAAU,EAAE,CAAC,KAAK,CAAC;IACnB,KAAK,CAAC,OAAO,CAAC,IAAgB,EAAE,OAAwB;QACtD,IAAI,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;YAC7B,MAAM,IAAI,eAAe,CAAC,cAAc,EAAE,oBAAoB,CAAC,CAAC;QAClE,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YACjB,MAAM,IAAI,eAAe,CAAC,aAAa,EAAE,yBAAyB,CAAC,CAAC;QACtE,CAAC;QAED,IAAI,GAA6D,CAAC;QAClE,IAAI,CAAC;YACH,GAAG,GAAG,MAAM,gBAAgB,CAAC,IAAI,CAAC,CAAC;YACnC,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,GAAG,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC;YAC5D,IAAI,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;gBAC7B,MAAM,IAAI,eAAe,CAAC,cAAc,EAAE,oBAAoB,CAAC,CAAC;YAClE,CAAC;YACD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YAChC,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,MAAM,IAAI,eAAe,CAAC,aAAa,EAAE,4BAA4B,CAAC,CAAC;YACzE,CAAC;YACD,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;QAClC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,eAAe;gBAAE,MAAM,KAAK,CAAC;YAClD,MAAM,IAAI,eAAe,CAAC,cAAc,EAAE,yBAAyB,CAAC,CAAC;QACvE,CAAC;gBAAS,CAAC;YACT,MAAM,GAAG,EAAE,OAAO,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC;CACF,CAAC;AAEF,MAAM,UAAU,aAAa,CAAC,IAAwB;IACpD,OAAO,IAAI,EAAE,WAAW,EAAE,KAAK,QAAQ,CAAC;AAC1C,CAAC"}

package/lib/attachments/extractors/registry.d.ts

@@ -0,0 +1,43 @@
+import { type ExtractResult, type Extractor } from './types.js';
+/** Marker appended when the extracted output is truncated to the output cap. */
+export declare const TRUNCATION_MARKER = "\n\n[...truncated]\n";
+/** Extraction boundaries (parser input cap + extracted output cap). */
+export interface ExtractionCaps {
+    /** Max raw bytes handed to a parser (beyond => too-large, no parse). */
+    maxInputBytes: number;
+    /** Max extracted text bytes surfaced (beyond => truncate with marker). */
+    maxOutputBytes: number;
+}
+/**
+ * Resolve an extractor for a verified mime/extension pair, or undefined.
+ * The filename extension is used for formats whose verified mime is generic
+ * (e.g. plain text); the verified mime wins when it names a concrete format.
+ */
+export declare function pickExtractor(mime: string | undefined, extension: string | undefined): Extractor | undefined;
+/** Whether a (verified) mime/extension is served by ANY extractor. */
+export declare function isExtractable(mime: string | undefined, extension: string | undefined): boolean;
+/** Outcome of attempting extraction against an asset. */
+export type ExtractAttemptResult = {
+    status: 'ready';
+    result: ExtractResult;
+} | {
+    status: 'unsupported';
+} | {
+    status: 'too-large';
+} | {
+    status: 'failed';
+    errorCode: string;
+};
+/**
+ * Guards + runs the extractor for one asset, enforcing input/output caps.
+ * Never throws: every failure collapses to a typed status so the pipeline can
+ * record it and continue (best-effort).
+ */
+export declare function attemptExtraction(input: {
+    mime: string | undefined;
+    extension: string | undefined;
+    data: Uint8Array;
+    caps: ExtractionCaps;
+    signal?: AbortSignal;
+}): Promise<ExtractAttemptResult>;
+//# sourceMappingURL=registry.d.ts.map

package/lib/attachments/extractors/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/attachments/extractors/registry.ts"],"names":[],"mappings":"AAaA,OAAO,EAAwC,KAAK,aAAa,EAAE,KAAK,SAAS,EAAE,MAAM,YAAY,CAAC;AAUtG,gFAAgF;AAChF,eAAO,MAAM,iBAAiB,yBAAyB,CAAC;AAExD,uEAAuE;AACvE,MAAM,WAAW,cAAc;IAC7B,wEAAwE;IACxE,aAAa,EAAE,MAAM,CAAC;IACtB,0EAA0E;IAC1E,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,CAQ5G;AAED,sEAAsE;AACtE,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAE9F;AAED,yDAAyD;AACzD,MAAM,MAAM,oBAAoB,GAC5B;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,aAAa,CAAA;CAAE,GAC1C;IAAE,MAAM,EAAE,aAAa,CAAA;CAAE,GACzB;IAAE,MAAM,EAAE,WAAW,CAAA;CAAE,GACvB;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC;AAE5C;;;;GAIG;AACH,wBAAsB,iBAAiB,CAAC,KAAK,EAAE;IAC7C,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,EAAE,cAAc,CAAC;IACrB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAgBhC"}

package/lib/attachments/extractors/registry.js

@@ -0,0 +1,82 @@
+/**
+ * Extractor registry.
+ *
+ * Picks the right extractor for a stored asset by its VERIFIED mime type and
+ * filename extension, and enforces the parser input cap BEFORE parsing: input
+ * beyond maxInputBytes reports 'too-large' without ever handing bytes to a
+ * parser. Unrecognized formats report 'unsupported'. The output cap is also
+ * enforced here (truncate with a marker).
+ */
+import { textExtractor } from './text.js';
+import { pdfExtractor } from './pdf.js';
+import { docxExtractor } from './docx.js';
+import { xlsxExtractor } from './xlsx.js';
+import { ExtractionError } from './types.js';
+/** The ordered candidate extractors (first match wins). */
+const EXTRACTORS = [
+    textExtractor,
+    pdfExtractor,
+    docxExtractor,
+    xlsxExtractor,
+];
+/** Marker appended when the extracted output is truncated to the output cap. */
+export const TRUNCATION_MARKER = '\n\n[...truncated]\n';
+/**
+ * Resolve an extractor for a verified mime/extension pair, or undefined.
+ * The filename extension is used for formats whose verified mime is generic
+ * (e.g. plain text); the verified mime wins when it names a concrete format.
+ */
+export function pickExtractor(mime, extension) {
+    const mimeLower = mime?.toLowerCase();
+    const extLower = extension?.toLowerCase();
+    for (const extractor of EXTRACTORS) {
+        if (mimeLower && extractor.mimes.includes(mimeLower))
+            return extractor;
+        if (extLower && extractor.extensions.includes(extLower))
+            return extractor;
+    }
+    return undefined;
+}
+/** Whether a (verified) mime/extension is served by ANY extractor. */
+export function isExtractable(mime, extension) {
+    return pickExtractor(mime, extension) !== undefined;
+}
+/**
+ * Guards + runs the extractor for one asset, enforcing input/output caps.
+ * Never throws: every failure collapses to a typed status so the pipeline can
+ * record it and continue (best-effort).
+ */
+export async function attemptExtraction(input) {
+    const { mime, extension, data, caps, signal } = input;
+    if (signal?.aborted) {
+        return { status: 'failed', errorCode: 'aborted' };
+    }
+    const extractor = pickExtractor(mime, extension);
+    if (!extractor)
+        return { status: 'unsupported' };
+    if (data.byteLength > caps.maxInputBytes)
+        return { status: 'too-large' };
+    try {
+        const result = await extractor.extract(data, { signal });
+        const capped = capOutput(result, caps.maxOutputBytes);
+        return { status: 'ready', result: capped };
+    }
+    catch (error) {
+        if (error instanceof ExtractionError)
+            return { status: 'failed', errorCode: error.code };
+        return { status: 'failed', errorCode: 'parser-error' };
+    }
+}
+/** Truncate extracted output to the byte cap, appending a truncation marker. */
+function capOutput(result, maxOutputBytes) {
+    const encoded = new TextEncoder().encode(result.text);
+    if (encoded.byteLength <= maxOutputBytes)
+        return result;
+    // Slide back to a UTF-8 boundary so we never split a multi-byte sequence.
+    let end = maxOutputBytes;
+    while (end > 0 && (encoded[end] & 0xc0) === 0x80)
+        end--;
+    const sliced = new TextDecoder('utf-8').decode(encoded.subarray(0, end));
+    return { format: result.format, text: sliced + TRUNCATION_MARKER };
+}
+//# sourceMappingURL=registry.js.map

package/lib/attachments/extractors/registry.js.map

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

package/lib/attachments/extractors/text.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Pure-text extractor (TXT / MD / JSON / YAML / XML / CSV / LOG / source).
+ *
+ * This is the primary, dependency-free extraction path and must be rock
+ * solid + fully offline-testable. It decodes UTF-8 (honoring a leading BOM),
+ * drops a trailing/blank BOM artifact, sanitizes control characters, and
+ * trims the result. It never fails for well-formed textual bytes — decoding
+ * is lossy for malformed UTF-8 but never throws.
+ */
+import { type Extractor } from './types.js';
+/** The singleton text extractor (registry picks it by mime/extension). */
+export declare const textExtractor: Extractor;
+/** Whether a (verified) MIME is served by the text extractor. */
+export declare function textMimeServed(mime: string | undefined): boolean;
+/** Whether a filename extension is served by the text extractor. */
+export declare function textExtensionServed(extension: string | undefined): boolean;
+//# sourceMappingURL=text.d.ts.map

package/lib/attachments/extractors/text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../../../src/attachments/extractors/text.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAuC,KAAK,SAAS,EAAE,MAAM,YAAY,CAAC;AA4DjF,0EAA0E;AAC1E,eAAO,MAAM,aAAa,EAAE,SAU3B,CAAC;AAEF,iEAAiE;AACjE,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAEhE;AAED,oEAAoE;AACpE,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAE1E"}

package/lib/attachments/extractors/text.js.map

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

package/lib/attachments/extractors/types.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Extractor contracts.
+ *
+ * An extractor turns a supported file's raw bytes into a *readable text*
+ * surface (plain text or markdown) that the private asset store publishes via
+ * `putExtracted`. The output never mutates the stored `raw.bin`; it is a
+ * derived projection written to `extracted.md` for the
+ * `read_channel_attachment` tool.
+ *
+ * Parser caps are enforced OUTSIDE the extractors by the
+ * registry / pipeline: input beyond `maxInputBytes` short-circuits to
+ * `too-large` without parsing, and extracted output beyond
+ * `maxOutputBytes` is truncated by the pipeline with a marker. Extractors
+ * themselves only map bytes -> text and wrap their failures into a stable
+ * `ExtractionError`.
+ */
+import type { ExtractionFormat } from '../types.js';
+/** A successful extraction: the format and the produced text. */
+export interface ExtractResult {
+    format: ExtractionFormat;
+    /** The extracted readable text (never the raw file bytes). */
+    text: string;
+}
+/** Stable, de-identified extraction failure codes (stored as `errorCode`). */
+export type ExtractionErrorCode = 
+/** The parser could not make sense of the input (corrupt / unsupported construct). */
+'parser-error'
+/** The input is a recognized format the extractor does not handle. */
+ | 'unsupported'
+/** Input or output exceeded a configured parser cap (enforced before/after parse). */
+ | 'too-large';
+/**
+ * Raised by an extractor when it cannot produce text. The code is stable and
+ * machine-routable; the message is de-identified (never an exception trace).
+ */
+export declare class ExtractionError extends Error {
+    readonly code: ExtractionErrorCode;
+    constructor(code: ExtractionErrorCode, message: string);
+}
+/** Options passed to an extractor's `extract` call. */
+export interface ExtractOptions {
+    /** Cancellation signal forwarded from the caller (best-effort). */
+    signal?: AbortSignal;
+}
+/** A strategy that extracts text from one file kind. */
+export interface Extractor {
+    /**
+     * Kinds this extractor serves. Each entry is [mime, extension] — matching is
+     * OR'd across entries, so a DOCX extractor lists both
+     * `application/vnd.openxmlformats-officedocument.wordprocessingml.document`
+     * and `docx`.
+     */
+    readonly mimes: readonly string[];
+    /** File extensions this extractor serves (lower-case, no dot, OR'd with mimes). */
+    readonly extensions: readonly string[];
+    /**
+     * Render a textual surface from raw bytes.
+     * @throws ExtractionError with a stable code on failure.
+     */
+    extract(data: Uint8Array, options?: ExtractOptions): Promise<ExtractResult>;
+}
+//# sourceMappingURL=types.d.ts.map

package/lib/attachments/extractors/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/attachments/extractors/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEpD,iEAAiE;AACjE,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,gBAAgB,CAAC;IACzB,8DAA8D;IAC9D,IAAI,EAAE,MAAM,CAAC;CACd;AAED,8EAA8E;AAC9E,MAAM,MAAM,mBAAmB;AAC7B,sFAAsF;AACpF,cAAc;AAChB,sEAAsE;GACpE,aAAa;AACf,sFAAsF;GACpF,WAAW,CAAC;AAEhB;;;GAGG;AACH,qBAAa,eAAgB,SAAQ,KAAK;IACxC,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC;gBACvB,IAAI,EAAE,mBAAmB,EAAE,OAAO,EAAE,MAAM;CAKvD;AAED,uDAAuD;AACvD,MAAM,WAAW,cAAc;IAC7B,mEAAmE;IACnE,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,wDAAwD;AACxD,MAAM,WAAW,SAAS;IACxB;;;;;OAKG;IACH,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,mFAAmF;IACnF,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC;;;OAGG;IACH,OAAO,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;CAC7E"}

package/lib/attachments/extractors/types.js

@@ -0,0 +1,13 @@
+/**
+ * Raised by an extractor when it cannot produce text. The code is stable and
+ * machine-routable; the message is de-identified (never an exception trace).
+ */
+export class ExtractionError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.name = 'ExtractionError';
+        this.code = code;
+    }
+}
+//# sourceMappingURL=types.js.map

package/lib/attachments/extractors/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/attachments/extractors/types.ts"],"names":[],"mappings":"AAoCA;;;GAGG;AACH,MAAM,OAAO,eAAgB,SAAQ,KAAK;IAC/B,IAAI,CAAsB;IACnC,YAAY,IAAyB,EAAE,OAAe;QACpD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;QAC9B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF"}

package/lib/attachments/extractors/xlsx.d.ts

@@ -0,0 +1,6 @@
+import { type Extractor } from './types.js';
+/** The singleton spreadsheet extractor. */
+export declare const xlsxExtractor: Extractor;
+/** Whether a (verified) MIME / extension is served by the spreadsheet extractor. */
+export declare function xlsxMimeServed(mime: string | undefined): boolean;
+//# sourceMappingURL=xlsx.d.ts.map

package/lib/attachments/extractors/xlsx.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xlsx.d.ts","sourceRoot":"","sources":["../../../src/attachments/extractors/xlsx.ts"],"names":[],"mappings":"AAWA,OAAO,EAA4D,KAAK,SAAS,EAAE,MAAM,YAAY,CAAC;AAiCtG,2CAA2C;AAC3C,eAAO,MAAM,aAAa,EAAE,SAgC3B,CAAC;AAEF,oFAAoF;AACpF,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAEhE"}