llmtxt 2026.4.0

package/dist/client.js

@@ -0,0 +1,143 @@
+/**
+ * Lightweight llmtxt client for agents.
+ * Wraps the ClawMsgr attachment API with typed helpers.
+ * No framework dependencies — uses native fetch.
+ *
+ * When `@cleocode/lafs` is installed, responses are validated
+ * against the LAFS envelope schema. Without it, raw JSON is parsed directly.
+ */
+import { createPatch } from './patch.js';
+// ── LAFS integration (optional) ─────────────────────────────────
+/** Lazy-loaded LAFS parser. Cached after first resolution. */
+let lafsParser;
+/**
+ * Attempt to load parseLafsResponse from @cleocode/lafs.
+ * Returns the parser function, or false if LAFS is not installed.
+ */
+async function getLafsParser() {
+    if (lafsParser !== undefined)
+        return lafsParser;
+    try {
+        const lafs = await import('@cleocode/lafs');
+        lafsParser = lafs.parseLafsResponse;
+        return lafsParser;
+    }
+    catch {
+        lafsParser = false;
+        return false;
+    }
+}
+/**
+ * Parse a JSON response, using LAFS envelope validation when available.
+ */
+async function parseResponse(json) {
+    const envelope = json;
+    const parser = await getLafsParser();
+    if (parser && '$schema' in envelope) {
+        return parser(json);
+    }
+    if (envelope.success === false) {
+        const err = envelope.error;
+        throw new Error(err?.message ?? 'Request failed');
+    }
+    return (envelope.result ?? envelope.data);
+}
+// ── Client ──────────────────────────────────────────────────────
+export function createClient(config) {
+    const headers = {
+        Authorization: `Bearer ${config.apiKey}`,
+        'X-Agent-Id': config.agentId,
+        'Content-Type': 'application/json',
+    };
+    return {
+        /** Upload content as an attachment to a conversation. */
+        async upload(conversationId, content, options = {}) {
+            const { format = 'markdown', title, expiresIn = 3600 } = options;
+            const res = await fetch(`${config.apiBase}/conversations/${conversationId}/attachments`, {
+                method: 'POST',
+                headers,
+                body: JSON.stringify({ content, format, title, expiresIn }),
+            });
+            if (!res.ok)
+                throw new Error(`Upload failed (${res.status}): ${await res.text()}`);
+            return parseResponse(await res.json());
+        },
+        /** Fetch content from a signed URL. */
+        async fetch(signedUrl) {
+            const res = await fetch(signedUrl, { headers });
+            if (!res.ok)
+                throw new Error(`Fetch failed (${res.status}): ${await res.text()}`);
+            return parseResponse(await res.json());
+        },
+        /** Fetch an attachment shared in a conversation without needing a signed URL. */
+        async fetchFromConversation(slug, conversationId) {
+            const url = new URL(`${config.apiBase}/attachments/${slug}`);
+            url.searchParams.set('conv', conversationId);
+            const res = await fetch(url, { headers });
+            if (!res.ok) {
+                throw new Error(`Conversation fetch failed (${res.status}): ${await res.text()}`);
+            }
+            return parseResponse(await res.json());
+        },
+        /** Fetch an attachment owned by the current agent. */
+        async fetchOwned(slug) {
+            const res = await fetch(`${config.apiBase}/attachments/${slug}`, { headers });
+            if (!res.ok)
+                throw new Error(`Owner fetch failed (${res.status}): ${await res.text()}`);
+            return parseResponse(await res.json());
+        },
+        /**
+         * Change how an attachment is shared. For `signed_url` mode the API may
+         * return a fresh `signedUrl`; for `conversation`/`public` it may not.
+         */
+        async reshare(slug, options = {}) {
+            const { expiresIn = 3600, mode = 'signed_url' } = options;
+            const res = await fetch(`${config.apiBase}/attachments/${slug}/reshare`, {
+                method: 'POST',
+                headers,
+                body: JSON.stringify({ expiresIn, mode }),
+            });
+            if (!res.ok)
+                throw new Error(`Reshare failed (${res.status}): ${await res.text()}`);
+            return parseResponse(await res.json());
+        },
+        /** Backward-compatible alias for older API wording. Prefer `reshare`. */
+        async resign(slug, options = {}) {
+            return this.reshare(slug, options);
+        },
+        /** Build a version patch locally using the Rust/WASM core. */
+        createVersionPatch(original, updated) {
+            return createPatch(original, updated);
+        },
+        /** Submit a patch as the next version for an attachment slug. */
+        async addVersion(slug, patchText, options = {}) {
+            const res = await fetch(`${config.apiBase}/attachments/${slug}/versions`, {
+                method: 'POST',
+                headers,
+                body: JSON.stringify({ patchText, ...options }),
+            });
+            if (!res.ok)
+                throw new Error(`Add version failed (${res.status}): ${await res.text()}`);
+            return parseResponse(await res.json());
+        },
+        /** Convenience helper that diffs local content then appends the new version. */
+        async addVersionFromContent(slug, original, updated, options = {}) {
+            const patchText = createPatch(original, updated);
+            return this.addVersion(slug, patchText, options);
+        },
+        /** Check if a signed URL is still valid without fetching content. */
+        isValid(signedUrl) {
+            try {
+                const url = new URL(signedUrl);
+                const exp = url.searchParams.get('exp');
+                if (!exp)
+                    return false;
+                return Date.now() < parseInt(exp, 10);
+            }
+            catch {
+                return false;
+            }
+        },
+    };
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/compression.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Compression, encoding, hashing, and token estimation.
+ *
+ * All portable primitives delegate to the Rust WASM module — single
+ * source of truth, zero drift between TypeScript and Rust consumers.
+ */
+export { encodeBase62, decodeBase62, compress, decompress, generateId, hashContent, calculateTokens, calculateCompressionRatio, computeDiff, } from './wasm.js';
+export type { DiffResult } from './wasm.js';
+//# sourceMappingURL=compression.d.ts.map

package/dist/compression.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compression.d.ts","sourceRoot":"","sources":["../src/compression.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,QAAQ,EACR,UAAU,EACV,UAAU,EACV,WAAW,EACX,eAAe,EACf,yBAAyB,EACzB,WAAW,GACZ,MAAM,WAAW,CAAC;AAEnB,YAAY,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC"}

package/dist/compression.js

@@ -0,0 +1,8 @@
+/**
+ * Compression, encoding, hashing, and token estimation.
+ *
+ * All portable primitives delegate to the Rust WASM module — single
+ * source of truth, zero drift between TypeScript and Rust consumers.
+ */
+export { encodeBase62, decodeBase62, compress, decompress, generateId, hashContent, calculateTokens, calculateCompressionRatio, computeDiff, } from './wasm.js';
+//# sourceMappingURL=compression.js.map

package/dist/compression.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compression.js","sourceRoot":"","sources":["../src/compression.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,QAAQ,EACR,UAAU,EACV,UAAU,EACV,WAAW,EACX,eAAe,EACf,yBAAyB,EACzB,WAAW,GACZ,MAAM,WAAW,CAAC"}

package/dist/disclosure.d.ts

@@ -0,0 +1,215 @@
+/**
+ * A logical section identified within a document.
+ *
+ * @remarks
+ * Sections are detected by format-specific heuristics (headings in
+ * markdown, top-level keys in JSON, function/class declarations in code).
+ */
+export interface Section {
+    /** Display title of the section (heading text, JSON key, or symbol name). */
+    title: string;
+    /** Nesting depth (0-based). Headings use depth = level - 1. */
+    depth: number;
+    /** 1-based line number where the section begins. */
+    startLine: number;
+    /** 1-based line number where the section ends (inclusive). */
+    endLine: number;
+    /** Estimated token count for the section content. */
+    tokenCount: number;
+    /** The structural type of the section. */
+    type: 'heading' | 'json-key' | 'code-block' | 'function' | 'class';
+}
+/**
+ * High-level structural overview of a document.
+ *
+ * @remarks
+ * Produced by {@link generateOverview}. Provides format detection,
+ * token counts, section listings, and format-specific extras (JSON keys
+ * or a markdown table of contents).
+ */
+export interface DocumentOverview {
+    /** The detected document format. */
+    format: 'json' | 'markdown' | 'code' | 'text';
+    /** Total number of lines in the document. */
+    lineCount: number;
+    /** Estimated total token count for the entire document. */
+    tokenCount: number;
+    /** Ordered list of sections found in the document. */
+    sections: Section[];
+    /** Top-level JSON keys with type info and preview (JSON documents only). */
+    keys?: Array<{
+        key: string;
+        type: string;
+        preview: string;
+    }>;
+    /** Markdown table of contents entries (markdown documents only). */
+    toc?: Array<{
+        title: string;
+        depth: number;
+        line: number;
+    }>;
+}
+/**
+ * A single match returned by {@link searchContent}.
+ */
+export interface SearchResult {
+    /** 1-based line number of the matching line. */
+    line: number;
+    /** The full text of the matching line. */
+    content: string;
+    /** Lines immediately preceding the match (up to `contextLines`). */
+    contextBefore: string[];
+    /** Lines immediately following the match (up to `contextLines`). */
+    contextAfter: string[];
+}
+/**
+ * Result of extracting a line range from a document via {@link getLineRange}.
+ */
+export interface LineRangeResult {
+    /** 1-based line number where the extracted range begins. */
+    startLine: number;
+    /** 1-based line number where the extracted range ends (inclusive). */
+    endLine: number;
+    /** The extracted text content for the requested line range. */
+    content: string;
+    /** Estimated token count for the extracted content. */
+    tokenCount: number;
+    /** Total number of lines in the full document. */
+    totalLines: number;
+    /** Estimated total token count for the full document. */
+    totalTokens: number;
+    /** Number of tokens saved by extracting only this range. */
+    tokensSaved: number;
+}
+/**
+ * Extract a range of lines from a document, returning content and token statistics.
+ *
+ * @remarks
+ * Line numbers are 1-based and clamped to the document boundaries. This
+ * enables agents to request only the portion of a document they need,
+ * reducing token consumption.
+ *
+ * @param content - The full document content.
+ * @param start - The 1-based starting line number.
+ * @param end - The 1-based ending line number (inclusive).
+ * @returns A {@link LineRangeResult} with the extracted content and token savings.
+ *
+ * @example
+ * ```ts
+ * const range = getLineRange(doc, 10, 25);
+ * console.log(`Saved ${range.tokensSaved} tokens`);
+ * ```
+ */
+export declare function getLineRange(content: string, start: number, end: number): LineRangeResult;
+/**
+ * Search document content for lines matching a query string or regex.
+ *
+ * @remarks
+ * Supports plain-text substring matching (case-insensitive) and regex
+ * patterns delimited with slashes (e.g. `/pattern/i`). Results include
+ * configurable surrounding context lines to help agents understand each
+ * match in context.
+ *
+ * @param content - The full document content to search.
+ * @param query - A plain-text substring or `/regex/flags` pattern.
+ * @param contextLines - Number of context lines before and after each match (default: 2).
+ * @param maxResults - Maximum number of matches to return (default: 20).
+ * @returns An array of {@link SearchResult} objects for each matching line.
+ *
+ * @example
+ * ```ts
+ * const hits = searchContent(doc, 'TODO', 3, 10);
+ * ```
+ */
+export declare function searchContent(content: string, query: string, contextLines?: number, maxResults?: number): SearchResult[];
+/**
+ * Detect the structural format of a document using content heuristics.
+ *
+ * @remarks
+ * Applies the following precedence: JSON (valid `JSON.parse`), then
+ * markdown (2+ markdown signals such as headings, lists, or links), then
+ * code (2+ code signals such as `import`, `function`, or arrow syntax),
+ * and finally falls back to plain text.
+ *
+ * @param content - The document content to classify.
+ * @returns The detected format: `"json"`, `"markdown"`, `"code"`, or `"text"`.
+ *
+ * @example
+ * ```ts
+ * detectDocumentFormat('# Title\n- item'); // "markdown"
+ * ```
+ */
+export declare function detectDocumentFormat(content: string): 'json' | 'markdown' | 'code' | 'text';
+/**
+ * Generate a structural overview of a document for progressive disclosure.
+ *
+ * @remarks
+ * Detects the document format, splits it into logical sections, computes
+ * token counts, and extracts format-specific metadata (JSON keys or
+ * markdown table of contents). The overview allows agents to decide
+ * which sections to request in full, minimizing total token usage.
+ *
+ * @param content - The full document content to analyze.
+ * @returns A {@link DocumentOverview} with format, sections, and token counts.
+ *
+ * @example
+ * ```ts
+ * const overview = generateOverview(markdownDoc);
+ * console.log(`${overview.sections.length} sections, ${overview.tokenCount} tokens`);
+ * ```
+ */
+export declare function generateOverview(content: string): DocumentOverview;
+/**
+ * Execute a JSONPath-style query against JSON content.
+ *
+ * @remarks
+ * Parses the content as JSON and resolves the dot/bracket path (e.g.
+ * `$.messages[0].content` or `data.items`). Supports wildcard (`*`) for
+ * arrays and objects. Throws on invalid JSON or missing keys to provide
+ * clear error messages to calling agents.
+ *
+ * @param content - A valid JSON string to query.
+ * @param path - A JSONPath expression (e.g. `"$.key"`, `"items[0].name"`).
+ * @returns An object containing the resolved `result`, its `tokenCount`, and the original `path`.
+ * @throws Error if the JSON is invalid or the path cannot be resolved.
+ *
+ * @example
+ * ```ts
+ * const { result } = queryJsonPath('{"a":{"b":42}}', '$.a.b');
+ * // result === 42
+ * ```
+ */
+export declare function queryJsonPath(content: string, path: string): {
+    result: unknown;
+    tokenCount: number;
+    path: string;
+};
+/**
+ * Extract a named section from a document by title.
+ *
+ * @remarks
+ * Searches the document's sections (from {@link generateOverview}) for a
+ * matching title using progressively looser comparisons: exact match,
+ * substring match, and alphanumeric-only substring match. When
+ * `depthAll` is `true`, child sections at deeper nesting levels are
+ * included in the extracted content.
+ *
+ * @param content - The full document content.
+ * @param sectionName - The section title (or substring) to search for.
+ * @param depthAll - When `true`, include all child sections nested under the match (default: `false`).
+ * @returns An object with the matched section, extracted content, and token savings, or `null` if not found.
+ *
+ * @example
+ * ```ts
+ * const section = getSection(doc, 'Installation', true);
+ * if (section) console.log(section.content);
+ * ```
+ */
+export declare function getSection(content: string, sectionName: string, depthAll?: boolean): {
+    section: Section;
+    content: string;
+    tokenCount: number;
+    totalTokens: number;
+    tokensSaved: number;
+} | null;
+//# sourceMappingURL=disclosure.d.ts.map

package/dist/disclosure.d.ts.map

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