llmtxt 2026.4.0

package/dist/validation.js

@@ -0,0 +1,285 @@
+import { jsonFormatSchema, textFormatSchema, getPredefinedSchema, isPredefinedSchema, predefinedSchemas, } from './schemas.js';
+// ── Helpers ─────────────────────────────────────────────────────
+function formatZodErrors(error) {
+    return error.errors.map((err) => ({
+        path: err.path.join('.'),
+        message: err.message,
+        code: err.code,
+    }));
+}
+// ── Validators ──────────────────────────────────────────────────
+/**
+ * Validate content as JSON, optionally against a predefined schema.
+ *
+ * @remarks
+ * When `content` is a string it is first parsed with `JSON.parse`. The
+ * parsed value is then checked against the generic JSON schema and,
+ * when a `schemaName` is provided, against the matching predefined
+ * schema from the registry.
+ *
+ * @param content - The raw content to validate (string or pre-parsed value).
+ * @param schemaName - Optional name of a predefined schema to enforce.
+ * @returns A {@link ValidationResult} indicating success or listing errors.
+ *
+ * @example
+ * ```ts
+ * const result = validateJson('{"key": "value"}');
+ * if (result.success) console.log(result.data);
+ * ```
+ */
+export function validateJson(content, schemaName) {
+    let parsedContent;
+    if (typeof content === 'string') {
+        try {
+            parsedContent = JSON.parse(content);
+        }
+        catch (error) {
+            return {
+                success: false,
+                errors: [{
+                        path: '',
+                        message: `Invalid JSON: ${error instanceof Error ? error.message : 'Unknown error'}`,
+                        code: 'invalid_json',
+                    }],
+            };
+        }
+    }
+    else {
+        parsedContent = content;
+    }
+    const jsonResult = jsonFormatSchema.safeParse(parsedContent);
+    if (!jsonResult.success) {
+        return { success: false, errors: formatZodErrors(jsonResult.error) };
+    }
+    if (schemaName) {
+        if (!isPredefinedSchema(schemaName)) {
+            return {
+                success: false,
+                errors: [{
+                        path: 'schema',
+                        message: `Unknown schema '${schemaName}'. Available schemas: ${Object.keys(predefinedSchemas).join(', ')}`,
+                        code: 'unknown_schema',
+                    }],
+            };
+        }
+        const schema = getPredefinedSchema(schemaName);
+        if (schema) {
+            const schemaResult = schema.safeParse(parsedContent);
+            if (!schemaResult.success) {
+                return { success: false, errors: formatZodErrors(schemaResult.error) };
+            }
+            return { success: true, data: schemaResult.data, format: 'json' };
+        }
+    }
+    return { success: true, data: jsonResult.data, format: 'json' };
+}
+/**
+ * Validate content as plain text or markdown.
+ *
+ * @remarks
+ * Checks that the value is a string using the text format schema.
+ *
+ * @param content - The value to validate as text.
+ * @returns A {@link ValidationResult} with `format` set to `"text"` on success.
+ *
+ * @example
+ * ```ts
+ * const result = validateText('# Hello');
+ * ```
+ */
+export function validateText(content) {
+    const result = textFormatSchema.safeParse(content);
+    if (!result.success) {
+        return { success: false, errors: formatZodErrors(result.error) };
+    }
+    return { success: true, data: result.data, format: 'text' };
+}
+// Markdown signals used by detectFormat — must match disclosure.ts heuristics
+const MARKDOWN_SIGNALS = [
+    /^#{1,6}\s/m, // Headers
+    /^\s*[-*]\s/m, // Unordered lists
+    /^\s*\d+\.\s/m, // Ordered lists
+    /```/, // Code blocks
+    /\[.+\]\(.+\)/, // Links
+];
+/**
+ * Auto-detect whether a string is JSON, markdown, or plain text.
+ *
+ * @remarks
+ * Attempts JSON parsing first. For non-JSON content, applies markdown
+ * heuristics (headings, lists, code blocks, links) — 2+ signals returns
+ * `"markdown"`, otherwise `"text"`. This is now consistent with the
+ * disclosure module's `detectDocumentFormat`.
+ *
+ * @param content - The string to inspect.
+ * @returns The detected format: `"json"`, `"markdown"`, or `"text"`.
+ *
+ * @example
+ * ```ts
+ * detectFormat('{"a":1}');                    // "json"
+ * detectFormat('# Title\n- item');            // "markdown"
+ * detectFormat('Hello');                      // "text"
+ * ```
+ */
+export function detectFormat(content) {
+    try {
+        JSON.parse(content);
+        return 'json';
+    }
+    catch {
+        const markdownScore = MARKDOWN_SIGNALS.filter(r => r.test(content)).length;
+        return markdownScore >= 2 ? 'markdown' : 'text';
+    }
+}
+/** Default maximum content size in bytes (5 MB). */
+export const DEFAULT_MAX_CONTENT_BYTES = 5 * 1024 * 1024;
+/** Default maximum line length in bytes (64 KB). */
+export const DEFAULT_MAX_LINE_BYTES = 64 * 1024;
+/**
+ * Check for binary content by scanning for control characters (0x00-0x08)
+ * in the first 8KB.
+ */
+function containsBinaryContent(content) {
+    const scanLength = Math.min(content.length, 8192);
+    for (let i = 0; i < scanLength; i++) {
+        const code = content.charCodeAt(i);
+        if (code >= 0 && code <= 8)
+            return true;
+    }
+    return false;
+}
+/**
+ * Check if any line exceeds the maximum line length.
+ */
+function findOverlongLine(content, maxBytes) {
+    let lineStart = 0;
+    for (let i = 0; i <= content.length; i++) {
+        if (i === content.length || content[i] === '\n') {
+            const lineLength = i - lineStart;
+            if (lineLength > maxBytes)
+                return lineStart + 1; // 1-indexed
+            lineStart = i + 1;
+        }
+    }
+    return null;
+}
+/**
+ * Validate content for a given format, with optional schema enforcement
+ * and content size limits.
+ *
+ * @remarks
+ * Dispatches to {@link validateJson} for JSON content or
+ * {@link validateText} for text/markdown. Enforces a byte-size limit
+ * (default 5 MB) before format validation. Returns an error result when
+ * an unsupported format string is supplied or content exceeds the limit.
+ *
+ * @param content - The raw content to validate.
+ * @param format - The expected content format.
+ * @param schemaNameOrOptions - A schema name string (backward compat) or options object.
+ * @returns A {@link ValidationResult} indicating success or listing errors.
+ *
+ * @example
+ * ```ts
+ * validateContent(payload, 'json', 'prompt-v1');
+ * validateContent(payload, 'text', { maxBytes: 10 * 1024 * 1024 });
+ * ```
+ */
+export function validateContent(content, format, schemaNameOrOptions) {
+    // Normalize options — backward compat with string schemaName
+    const opts = typeof schemaNameOrOptions === 'string'
+        ? { schemaName: schemaNameOrOptions }
+        : schemaNameOrOptions ?? {};
+    const maxBytes = opts.maxBytes ?? DEFAULT_MAX_CONTENT_BYTES;
+    // Enforce content size limit
+    if (maxBytes > 0 && typeof content === 'string') {
+        const byteLength = Buffer.byteLength(content, 'utf-8');
+        if (byteLength > maxBytes) {
+            const maxMB = (maxBytes / (1024 * 1024)).toFixed(1);
+            const actualMB = (byteLength / (1024 * 1024)).toFixed(2);
+            return {
+                success: false,
+                errors: [{
+                        path: '',
+                        message: `Content size ${actualMB} MB exceeds maximum ${maxMB} MB`,
+                        code: 'content_too_large',
+                    }],
+            };
+        }
+    }
+    // Reject binary content (control chars 0x00-0x08 in first 8KB)
+    const rejectBinary = opts.rejectBinary ?? true;
+    if (rejectBinary && typeof content === 'string' && containsBinaryContent(content)) {
+        return {
+            success: false,
+            errors: [{
+                    path: '',
+                    message: 'Content contains binary control characters (0x00-0x08). Only text content is accepted.',
+                    code: 'binary_content',
+                }],
+        };
+    }
+    // Enforce max line length
+    const maxLineBytes = opts.maxLineBytes ?? DEFAULT_MAX_LINE_BYTES;
+    if (maxLineBytes > 0 && typeof content === 'string') {
+        const overlongLine = findOverlongLine(content, maxLineBytes);
+        if (overlongLine !== null) {
+            const maxKB = (maxLineBytes / 1024).toFixed(0);
+            return {
+                success: false,
+                errors: [{
+                        path: '',
+                        message: `Line near position ${overlongLine} exceeds maximum line length of ${maxKB} KB`,
+                        code: 'line_too_long',
+                    }],
+            };
+        }
+    }
+    switch (format) {
+        case 'json':
+            return validateJson(content, opts.schemaName);
+        case 'text':
+        case 'markdown':
+            return validateText(content);
+        default:
+            return {
+                success: false,
+                errors: [{
+                        path: 'format',
+                        message: `Invalid format '${format}'. Must be 'json', 'text', or 'markdown'`,
+                        code: 'invalid_format',
+                    }],
+            };
+    }
+}
+/**
+ * Auto-detect the content format and then validate accordingly.
+ *
+ * @remarks
+ * Combines {@link detectFormat} and {@link validateContent} into a single
+ * call. The content must be a string; non-string values immediately fail
+ * with an `invalid_type` error.
+ *
+ * @param content - The raw content to auto-detect and validate.
+ * @param schemaName - Optional predefined schema name for JSON validation.
+ * @returns A {@link ValidationResult} with the detected format and validated data.
+ *
+ * @example
+ * ```ts
+ * const result = autoValidate('{"messages":[{"role":"user","content":"hi"}]}', 'prompt-v1');
+ * ```
+ */
+export function autoValidate(content, schemaName) {
+    if (typeof content !== 'string') {
+        return {
+            success: false,
+            errors: [{
+                    path: '',
+                    message: 'Content must be a string',
+                    code: 'invalid_type',
+                }],
+        };
+    }
+    const format = detectFormat(content);
+    return validateContent(content, format, schemaName);
+}
+//# sourceMappingURL=validation.js.map

package/dist/validation.js.map

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

package/dist/wasm.d.ts

@@ -0,0 +1,28 @@
+export declare function compress(data: string): Promise<Buffer>;
+export declare function decompress(data: Buffer): Promise<string>;
+export declare function encodeBase62(num: number): string;
+export declare function decodeBase62(str: string): number;
+export declare function generateId(): string;
+export declare function hashContent(data: string): string;
+export declare function calculateTokens(text: string): number;
+export declare function calculateCompressionRatio(originalSize: number, compressedSize: number): number;
+export declare function computeSignature(slug: string, agentId: string, conversationId: string, expiresAt: number, secret: string): string;
+export declare function computeSignatureWithLength(slug: string, agentId: string, conversationId: string, expiresAt: number, secret: string, sigLength: number): string;
+export declare function computeOrgSignature(slug: string, agentId: string, conversationId: string, orgId: string, expiresAt: number, secret: string): string;
+export declare function computeOrgSignatureWithLength(slug: string, agentId: string, conversationId: string, orgId: string, expiresAt: number, secret: string, sigLength: number): string;
+export declare function deriveSigningKey(apiKey: string): string;
+export declare function createPatch(original: string, modified: string): string;
+export declare function applyPatch(original: string, patchText: string): string;
+export declare function reconstructVersion(base: string, patchesJson: string, target: number): string;
+export declare function squashPatchesWasm(base: string, patchesJson: string): string;
+export declare function wasmTextSimilarity(a: string, b: string): number;
+export declare function wasmTextSimilarityNgram(a: string, b: string, n: number): number;
+export declare function isExpired(expiresAtMs: number): boolean;
+export interface DiffResult {
+    addedLines: number;
+    removedLines: number;
+    addedTokens: number;
+    removedTokens: number;
+}
+export declare function computeDiff(oldText: string, newText: string): DiffResult;
+//# sourceMappingURL=wasm.d.ts.map

package/dist/wasm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wasm.d.ts","sourceRoot":"","sources":["../src/wasm.ts"],"names":[],"mappings":"AAYA,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAG5D;AAED,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAE9D;AAID,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEhD;AAID,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AAID,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEhD;AAID,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEpD;AAID,wBAAgB,yBAAyB,CACvC,YAAY,EAAE,MAAM,EACpB,cAAc,EAAE,MAAM,GACrB,MAAM,CAER;AAID,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,cAAc,EAAE,MAAM,EACtB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GACb,MAAM,CAER;AAED,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,cAAc,EAAE,MAAM,EACtB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,GAChB,MAAM,CAER;AAED,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,cAAc,EAAE,MAAM,EACtB,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GACb,MAAM,CAER;AAED,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,cAAc,EAAE,MAAM,EACtB,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,GAChB,MAAM,CAER;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEvD;AAKD,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEtE;AAED,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAEtE;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAE5F;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAE3E;AAID,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAE/D;AAED,wBAAgB,uBAAuB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAE/E;AAID,wBAAgB,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAEtD;AAID,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,UAAU,CAUxE"}

package/dist/wasm.js

@@ -0,0 +1,92 @@
+/**
+ * WASM bridge — loads the Rust-compiled WASM module and re-exports
+ * portable core functions with TypeScript-friendly signatures.
+ *
+ * This module is the bridge between the Rust single-source-of-truth
+ * and the TypeScript API surface. All portable primitives (compression,
+ * hashing, signing, encoding) are delegated to WASM.
+ */
+import * as wasmModule from '../wasm/llmtxt_core.js';
+// ── Compression ─────────────────────────────────────────────────
+export async function compress(data) {
+    const bytes = wasmModule.compress(data);
+    return Buffer.from(bytes);
+}
+export async function decompress(data) {
+    return wasmModule.decompress(new Uint8Array(data));
+}
+// ── Base62 ──────────────────────────────────────────────────────
+export function encodeBase62(num) {
+    return wasmModule.encode_base62(BigInt(num));
+}
+export function decodeBase62(str) {
+    return Number(wasmModule.decode_base62(str));
+}
+// ── ID Generation ───────────────────────────────────────────────
+export function generateId() {
+    return wasmModule.generate_id();
+}
+// ── Hashing ─────────────────────────────────────────────────────
+export function hashContent(data) {
+    return wasmModule.hash_content(data);
+}
+// ── Token Estimation ────────────────────────────────────────────
+export function calculateTokens(text) {
+    return wasmModule.calculate_tokens(text);
+}
+// ── Compression Ratio ───────────────────────────────────────────
+export function calculateCompressionRatio(originalSize, compressedSize) {
+    return wasmModule.calculate_compression_ratio(originalSize, compressedSize);
+}
+// ── HMAC Signing ────────────────────────────────────────────────
+export function computeSignature(slug, agentId, conversationId, expiresAt, secret) {
+    return wasmModule.compute_signature(slug, agentId, conversationId, expiresAt, secret);
+}
+export function computeSignatureWithLength(slug, agentId, conversationId, expiresAt, secret, sigLength) {
+    return wasmModule.compute_signature_with_length(slug, agentId, conversationId, expiresAt, secret, sigLength);
+}
+export function computeOrgSignature(slug, agentId, conversationId, orgId, expiresAt, secret) {
+    return wasmModule.compute_org_signature(slug, agentId, conversationId, orgId, expiresAt, secret);
+}
+export function computeOrgSignatureWithLength(slug, agentId, conversationId, orgId, expiresAt, secret, sigLength) {
+    return wasmModule.compute_org_signature_with_length(slug, agentId, conversationId, orgId, expiresAt, secret, sigLength);
+}
+export function deriveSigningKey(apiKey) {
+    return wasmModule.derive_signing_key(apiKey);
+}
+// ── Patching ─────────────────────────────────────────────────────
+export function createPatch(original, modified) {
+    return wasmModule.create_patch(original, modified);
+}
+export function applyPatch(original, patchText) {
+    return wasmModule.apply_patch(original, patchText);
+}
+export function reconstructVersion(base, patchesJson, target) {
+    return wasmModule.reconstruct_version(base, patchesJson, target);
+}
+export function squashPatchesWasm(base, patchesJson) {
+    return wasmModule.squash_patches(base, patchesJson);
+}
+// ── Similarity (WASM-backed) ────────────────────────────────────
+export function wasmTextSimilarity(a, b) {
+    return wasmModule.text_similarity(a, b);
+}
+export function wasmTextSimilarityNgram(a, b, n) {
+    return wasmModule.text_similarity_ngram(a, b, n);
+}
+// ── Expiration ──────────────────────────────────────────────────
+export function isExpired(expiresAtMs) {
+    return wasmModule.is_expired(expiresAtMs);
+}
+export function computeDiff(oldText, newText) {
+    const result = wasmModule.compute_diff(oldText, newText);
+    const out = {
+        addedLines: result.added_lines,
+        removedLines: result.removed_lines,
+        addedTokens: result.added_tokens,
+        removedTokens: result.removed_tokens,
+    };
+    result.free();
+    return out;
+}
+//# sourceMappingURL=wasm.js.map

package/dist/wasm.js.map

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

package/package.json

@@ -0,0 +1,98 @@
+{
+  "name": "llmtxt",
+  "version": "2026.4.0",
+  "description": "Primitives and SDK for LLM agent content workflows: compression, patching, progressive disclosure, signed URLs, collaborative document lifecycle, and retrieval planning",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./sdk": {
+      "types": "./dist/sdk/index.d.ts",
+      "import": "./dist/sdk/index.js"
+    },
+    "./disclosure": {
+      "types": "./dist/disclosure.d.ts",
+      "import": "./dist/disclosure.js"
+    },
+    "./similarity": {
+      "types": "./dist/similarity.d.ts",
+      "import": "./dist/similarity.js"
+    },
+    "./graph": {
+      "types": "./dist/graph.d.ts",
+      "import": "./dist/graph.js"
+    }
+  },
+  "files": [
+    "dist",
+    "wasm",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "build:wasm": "bash -lc \"cd ../../crates/llmtxt-core && wasm-pack build --target nodejs --out-dir ../../packages/llmtxt/wasm && rm -f ../../packages/llmtxt/wasm/.gitignore\"",
+    "build:all": "pnpm run build:wasm && pnpm run build",
+    "dev": "tsc --watch",
+    "clean": "rm -rf dist",
+    "typecheck": "tsc --noEmit",
+    "validate": "pnpm run typecheck && pnpm exec forge-ts check && pnpm exec versionguard validate"
+  },
+  "keywords": [
+    "llm",
+    "agent",
+    "compression",
+    "content",
+    "patch",
+    "signed-urls",
+    "versioning",
+    "collaborative-docs",
+    "sdk",
+    "wasm"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "zod": "^3.25.3"
+  },
+  "peerDependencies": {
+    "@cleocode/lafs": ">=2026.3"
+  },
+  "peerDependenciesMeta": {
+    "@cleocode/lafs": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@cleocode/lafs": "^2026.3.74",
+    "@codluv/versionguard": "^0.9.0",
+    "@forge-ts/api": "^0.21.1",
+    "@forge-ts/cli": "^0.21.1",
+    "@forge-ts/doctest": "^0.21.1",
+    "@forge-ts/enforcer": "^0.21.1",
+    "@forge-ts/gen": "^0.21.1",
+    "@types/node": "^22.19.15",
+    "typescript": "^5.9.3",
+    "@forge-ts/core": "^0.21.1"
+  },
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/kryptobaseddev/llmtxt.git",
+    "directory": "packages/llmtxt"
+  },
+  "homepage": "https://github.com/kryptobaseddev/llmtxt/tree/main/packages/llmtxt",
+  "bugs": {
+    "url": "https://github.com/kryptobaseddev/llmtxt/issues"
+  }
+}

package/wasm/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Codluv
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/wasm/README.md

@@ -0,0 +1,63 @@
+# llmtxt-core
+
+Portable Rust primitives for llmtxt content workflows.
+
+`llmtxt-core` is the single source of truth for compression, hashing, signing,
+patch creation/application, and other low-level text utilities used by both:
+
+- native Rust consumers like SignalDock
+- the TypeScript package `llmtxt` via WASM bindings
+
+## Install
+
+```toml
+[dependencies]
+llmtxt-core = "0.3"
+```
+
+During active development you can also pin the GitHub repository directly.
+
+```toml
+[dependencies]
+llmtxt-core = { git = "https://github.com/kryptobaseddev/llmtxt.git", package = "llmtxt-core" }
+```
+
+## What It Provides
+
+- zlib-compatible `compress` / `decompress`
+- SHA-256 content hashing
+- token estimation and compression ratios
+- signed URL generation and verification
+- unified diff `create_patch` / `apply_patch` for attachment versioning
+- base62 encoding helpers
+- WASM-exported functions for TypeScript consumers
+
+## Example
+
+```rust
+use llmtxt_core::{apply_patch, create_patch, generate_signed_url, SignedUrlBuildRequest};
+
+let original = "hello\n";
+let modified = "hello world\n";
+let patch = create_patch(original, modified);
+let rebuilt = apply_patch(original, &patch)?;
+assert_eq!(rebuilt, modified);
+
+let url = generate_signed_url(&SignedUrlBuildRequest {
+    base_url: "https://api.example.com",
+    path_prefix: "attachments",
+    slug: "xK9mP2nQ",
+    agent_id: "agent-1",
+    conversation_id: "conv-1",
+    expires_at: 1_800_000_000_000,
+    secret: "derived-secret",
+    sig_length: 32,
+})?;
+println!("{url}");
+# Ok::<(), String>(())
+```
+
+## Publishing
+
+This crate is designed to be consumable both directly from Rust and indirectly
+through the WASM-backed TypeScript package in `packages/llmtxt`.