llmtxt 2026.4.0

package/dist/signed-url.js.map

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

package/dist/similarity.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Lightweight content similarity using n-gram fingerprinting.
+ * No external dependencies — uses only string operations.
+ *
+ * Designed for agent use cases: find similar messages in a conversation
+ * without vector embeddings or external APIs.
+ */
+/**
+ * Extract character-level n-grams from text.
+ * Normalizes whitespace and lowercases before extraction.
+ */
+export declare function extractNgrams(text: string, n?: number): Set<string>;
+/**
+ * Extract word-level n-grams (shingles) from text.
+ * Better for longer content where word order matters.
+ */
+export declare function extractWordShingles(text: string, n?: number): Set<string>;
+/**
+ * Jaccard similarity: |A ∩ B| / |A ∪ B|.
+ * Returns 0.0 (no overlap) to 1.0 (identical).
+ */
+export declare function jaccardSimilarity(a: Set<string>, b: Set<string>): number;
+/**
+ * Compute similarity between two texts using character n-grams.
+ * Returns 0.0 to 1.0.
+ */
+export declare function textSimilarity(a: string, b: string, ngramSize?: number): number;
+/**
+ * Compute similarity using word shingles.
+ * Better for comparing messages or documents where word choice matters more than character patterns.
+ */
+export declare function contentSimilarity(a: string, b: string, shingleSize?: number): number;
+/**
+ * Generate a compact fingerprint for content using MinHash.
+ * The fingerprint is an array of hash values that can be compared
+ * for approximate similarity without storing the full n-gram set.
+ *
+ * Two fingerprints with many matching values indicate similar content.
+ */
+export declare function minHashFingerprint(text: string, numHashes?: number, ngramSize?: number): number[];
+/**
+ * Estimate similarity between two MinHash fingerprints.
+ * Returns approximate Jaccard similarity (0.0 to 1.0).
+ */
+export declare function fingerprintSimilarity(a: number[], b: number[]): number;
+/**
+ * Rank a list of texts by similarity to a query.
+ * Returns indices sorted by descending similarity, with scores.
+ */
+export declare function rankBySimilarity(query: string, candidates: string[], options?: {
+    method?: 'ngram' | 'shingle';
+    threshold?: number;
+}): Array<{
+    index: number;
+    score: number;
+}>;
+//# sourceMappingURL=similarity.d.ts.map

package/dist/similarity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"similarity.d.ts","sourceRoot":"","sources":["../src/similarity.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,SAAI,GAAG,GAAG,CAAC,MAAM,CAAC,CAO9D;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,SAAI,GAAG,GAAG,CAAC,MAAM,CAAC,CAOpE;AAID;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,MAAM,CAaxE;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,SAAS,SAAI,GAAG,MAAM,CAE1E;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,WAAW,SAAI,GAAG,MAAM,CAE/E;AAID;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,SAAK,EAAE,SAAS,SAAI,GAAG,MAAM,EAAE,CAcxF;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,CAStE;AAID;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,EAAE,EACpB,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GACjE,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAczC"}

package/dist/similarity.js

@@ -0,0 +1,134 @@
+/**
+ * Lightweight content similarity using n-gram fingerprinting.
+ * No external dependencies — uses only string operations.
+ *
+ * Designed for agent use cases: find similar messages in a conversation
+ * without vector embeddings or external APIs.
+ */
+// ── N-gram Generation ───────────────────────────────────────────
+/**
+ * Extract character-level n-grams from text.
+ * Normalizes whitespace and lowercases before extraction.
+ */
+export function extractNgrams(text, n = 3) {
+    const normalized = text.toLowerCase().replace(/\s+/g, ' ').trim();
+    const grams = new Set();
+    for (let i = 0; i <= normalized.length - n; i++) {
+        grams.add(normalized.slice(i, i + n));
+    }
+    return grams;
+}
+/**
+ * Extract word-level n-grams (shingles) from text.
+ * Better for longer content where word order matters.
+ */
+export function extractWordShingles(text, n = 2) {
+    const words = text.toLowerCase().replace(/[^\w\s]/g, '').split(/\s+/).filter(Boolean);
+    const shingles = new Set();
+    for (let i = 0; i <= words.length - n; i++) {
+        shingles.add(words.slice(i, i + n).join(' '));
+    }
+    return shingles;
+}
+// ── Similarity Metrics ──────────────────────────────────────────
+/**
+ * Jaccard similarity: |A ∩ B| / |A ∪ B|.
+ * Returns 0.0 (no overlap) to 1.0 (identical).
+ */
+export function jaccardSimilarity(a, b) {
+    if (a.size === 0 && b.size === 0)
+        return 1.0;
+    if (a.size === 0 || b.size === 0)
+        return 0.0;
+    let intersection = 0;
+    const smaller = a.size <= b.size ? a : b;
+    const larger = a.size <= b.size ? b : a;
+    for (const item of smaller) {
+        if (larger.has(item))
+            intersection++;
+    }
+    const union = a.size + b.size - intersection;
+    return union === 0 ? 0 : intersection / union;
+}
+/**
+ * Compute similarity between two texts using character n-grams.
+ * Returns 0.0 to 1.0.
+ */
+export function textSimilarity(a, b, ngramSize = 3) {
+    return jaccardSimilarity(extractNgrams(a, ngramSize), extractNgrams(b, ngramSize));
+}
+/**
+ * Compute similarity using word shingles.
+ * Better for comparing messages or documents where word choice matters more than character patterns.
+ */
+export function contentSimilarity(a, b, shingleSize = 2) {
+    return jaccardSimilarity(extractWordShingles(a, shingleSize), extractWordShingles(b, shingleSize));
+}
+// ── Fingerprinting ──────────────────────────────────────────────
+/**
+ * Generate a compact fingerprint for content using MinHash.
+ * The fingerprint is an array of hash values that can be compared
+ * for approximate similarity without storing the full n-gram set.
+ *
+ * Two fingerprints with many matching values indicate similar content.
+ */
+export function minHashFingerprint(text, numHashes = 64, ngramSize = 3) {
+    const ngrams = extractNgrams(text, ngramSize);
+    const fingerprint = new Array(numHashes).fill(Infinity);
+    for (const gram of ngrams) {
+        for (let i = 0; i < numHashes; i++) {
+            const hash = simpleHash(gram, i);
+            if (hash < fingerprint[i]) {
+                fingerprint[i] = hash;
+            }
+        }
+    }
+    return fingerprint;
+}
+/**
+ * Estimate similarity between two MinHash fingerprints.
+ * Returns approximate Jaccard similarity (0.0 to 1.0).
+ */
+export function fingerprintSimilarity(a, b) {
+    if (a.length !== b.length)
+        return 0;
+    if (a.length === 0)
+        return 0;
+    let matches = 0;
+    for (let i = 0; i < a.length; i++) {
+        if (a[i] === b[i])
+            matches++;
+    }
+    return matches / a.length;
+}
+// ── Ranking ─────────────────────────────────────────────────────
+/**
+ * Rank a list of texts by similarity to a query.
+ * Returns indices sorted by descending similarity, with scores.
+ */
+export function rankBySimilarity(query, candidates, options = {}) {
+    const { method = 'shingle', threshold = 0.0 } = options;
+    const similarityFn = method === 'ngram' ? textSimilarity : contentSimilarity;
+    const results = [];
+    for (let i = 0; i < candidates.length; i++) {
+        const score = similarityFn(query, candidates[i]);
+        if (score > threshold) {
+            results.push({ index: i, score });
+        }
+    }
+    results.sort((a, b) => b.score - a.score);
+    return results;
+}
+// ── Internal ────────────────────────────────────────────────────
+/**
+ * Simple hash function for MinHash. Uses FNV-1a variant with seed mixing.
+ */
+function simpleHash(str, seed) {
+    let hash = 2166136261 ^ seed;
+    for (let i = 0; i < str.length; i++) {
+        hash ^= str.charCodeAt(i);
+        hash = Math.imul(hash, 16777619);
+    }
+    return hash >>> 0;
+}
+//# sourceMappingURL=similarity.js.map

package/dist/similarity.js.map

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

package/dist/snapshot.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Session Snapshot Compression Service.
+ * Compresses/decompresses CLEO session.serialize() JSON snapshots
+ * for efficient storage and cross-session handoff.
+ *
+ * Phase 3: Session continuity infrastructure.
+ */
+export interface SnapshotMeta {
+    sessionId: string;
+    agentId: string;
+    createdAt: string;
+    originalSize: number;
+    compressedSize: number;
+    compressionRatio: number;
+    tokens: number;
+    contentHash: string;
+}
+export interface CompressedSnapshot {
+    meta: SnapshotMeta;
+    data: Buffer;
+}
+export interface SnapshotOptions {
+    /** Include full decision log (default: true) */
+    includeDecisions?: boolean;
+    /** Include brain observations (default: true) */
+    includeObservations?: boolean;
+    /** Max content size before compression in bytes (default: 5MB) */
+    maxSize?: number;
+}
+/**
+ * Compress a session snapshot JSON string.
+ * Returns compressed data + metadata for storage/retrieval.
+ */
+export declare function compressSnapshot(jsonStr: string, sessionId: string, agentId: string): Promise<CompressedSnapshot>;
+/**
+ * Decompress a snapshot back to JSON string.
+ * Verifies integrity via content hash if provided.
+ */
+export declare function decompressSnapshot(data: Buffer, expectedHash?: string): Promise<string>;
+/**
+ * Compress a session snapshot object directly.
+ * Serializes to JSON, then compresses.
+ */
+export declare function compressSessionData(sessionData: Record<string, unknown>, sessionId: string, agentId: string, options?: SnapshotOptions): Promise<CompressedSnapshot>;
+/**
+ * Decompress and parse a snapshot back to an object.
+ */
+export declare function decompressSessionData<T = Record<string, unknown>>(data: Buffer, expectedHash?: string): Promise<T>;
+/**
+ * Generate a human-readable summary of a snapshot for handoff messages.
+ * Useful for agents posting session summaries to ClawMsgr.
+ */
+export declare function snapshotSummary(meta: SnapshotMeta): string;
+//# sourceMappingURL=snapshot.d.ts.map

package/dist/snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../src/snapshot.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,YAAY,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,eAAe;IAC9B,gDAAgD;IAChD,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,iDAAiD;IACjD,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,kEAAkE;IAClE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAID;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,kBAAkB,CAAC,CAyB7B;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,MAAM,EACZ,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,MAAM,CAAC,CAcjB;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,kBAAkB,CAAC,CAmB7B;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrE,IAAI,EAAE,MAAM,EACZ,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,CAAC,CAAC,CAGZ;AAID;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,CAS1D"}

package/dist/snapshot.js

@@ -0,0 +1,94 @@
+/**
+ * Session Snapshot Compression Service.
+ * Compresses/decompresses CLEO session.serialize() JSON snapshots
+ * for efficient storage and cross-session handoff.
+ *
+ * Phase 3: Session continuity infrastructure.
+ */
+import { compress, decompress } from './wasm.js';
+// ── Compression ─────────────────────────────────────────────────
+/**
+ * Compress a session snapshot JSON string.
+ * Returns compressed data + metadata for storage/retrieval.
+ */
+export async function compressSnapshot(jsonStr, sessionId, agentId) {
+    const originalSize = Buffer.byteLength(jsonStr, 'utf-8');
+    const tokens = Math.ceil(originalSize / 4);
+    const data = await compress(jsonStr);
+    const compressedSize = data.length;
+    const compressionRatio = compressedSize > 0 ? originalSize / compressedSize : 1;
+    // Hash for integrity verification
+    const { createHash } = await import('node:crypto');
+    const contentHash = createHash('sha256').update(jsonStr).digest('hex');
+    return {
+        meta: {
+            sessionId,
+            agentId,
+            createdAt: new Date().toISOString(),
+            originalSize,
+            compressedSize,
+            compressionRatio,
+            tokens,
+            contentHash,
+        },
+        data,
+    };
+}
+/**
+ * Decompress a snapshot back to JSON string.
+ * Verifies integrity via content hash if provided.
+ */
+export async function decompressSnapshot(data, expectedHash) {
+    const jsonStr = await decompress(data);
+    if (expectedHash) {
+        const { createHash } = await import('node:crypto');
+        const actualHash = createHash('sha256').update(jsonStr).digest('hex');
+        if (actualHash !== expectedHash) {
+            throw new Error(`Snapshot integrity check failed: expected ${expectedHash.slice(0, 16)}..., got ${actualHash.slice(0, 16)}...`);
+        }
+    }
+    return jsonStr;
+}
+/**
+ * Compress a session snapshot object directly.
+ * Serializes to JSON, then compresses.
+ */
+export async function compressSessionData(sessionData, sessionId, agentId, options = {}) {
+    const { includeDecisions = true, includeObservations = true, maxSize = 5 * 1024 * 1024 } = options;
+    // Optionally strip large fields before compression
+    const filtered = { ...sessionData };
+    if (!includeDecisions && 'decisions' in filtered) {
+        delete filtered.decisions;
+    }
+    if (!includeObservations && 'observations' in filtered) {
+        delete filtered.observations;
+    }
+    const jsonStr = JSON.stringify(filtered);
+    if (Buffer.byteLength(jsonStr, 'utf-8') > maxSize) {
+        throw new Error(`Snapshot exceeds max size: ${Buffer.byteLength(jsonStr, 'utf-8')} > ${maxSize}`);
+    }
+    return compressSnapshot(jsonStr, sessionId, agentId);
+}
+/**
+ * Decompress and parse a snapshot back to an object.
+ */
+export async function decompressSessionData(data, expectedHash) {
+    const jsonStr = await decompressSnapshot(data, expectedHash);
+    return JSON.parse(jsonStr);
+}
+// ── Summary ─────────────────────────────────────────────────────
+/**
+ * Generate a human-readable summary of a snapshot for handoff messages.
+ * Useful for agents posting session summaries to ClawMsgr.
+ */
+export function snapshotSummary(meta) {
+    return [
+        `Session: ${meta.sessionId}`,
+        `Agent: ${meta.agentId}`,
+        `Size: ${meta.originalSize} → ${meta.compressedSize} bytes (${meta.compressionRatio.toFixed(1)}x)`,
+        `Tokens: ~${meta.tokens}`,
+        `Hash: ${meta.contentHash.slice(0, 16)}...`,
+        `Created: ${meta.createdAt}`,
+    ].join('\n');
+}
+//# sourceMappingURL=snapshot.js.map

package/dist/snapshot.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Shared types for llmtxt content workflows.
+ *
+ * These interfaces define the data shapes used across the llmtxt ecosystem.
+ * They are intentionally decoupled from any ORM or database layer.
+ */
+/** Supported content formats. */
+export type ContentFormat = 'json' | 'text' | 'markdown';
+/** Lifecycle state for collaborative documents. */
+export type DocumentMode = 'draft' | 'review' | 'locked' | 'archived';
+/** Metadata for a stored document. */
+export interface DocumentMeta {
+    id: string;
+    slug: string;
+    format: ContentFormat;
+    contentHash: string;
+    originalSize: number;
+    compressedSize: number;
+    tokenCount: number;
+    createdAt: number;
+    expiresAt: number | null;
+    accessCount: number;
+    lastAccessedAt: number | null;
+    /** Lifecycle state (collaborative documents). */
+    mode?: DocumentMode;
+    /** Total number of versions. */
+    versionCount?: number;
+    /** Current version number. */
+    currentVersion?: number;
+    /** Object storage key when content lives in S3 instead of inline. */
+    storageKey?: string;
+}
+/** Metadata for a single document version. */
+export interface VersionMeta {
+    id: string;
+    documentId: string;
+    versionNumber: number;
+    contentHash: string;
+    tokenCount: number;
+    createdAt: number;
+    createdBy?: string;
+    changelog?: string;
+}
+/** Summary of a version for listing (no content). */
+export interface VersionSummary {
+    versionNumber: number;
+    tokenCount: number;
+    createdAt: number;
+    createdBy?: string;
+    changelog?: string;
+}
+/** Result of comparing two versions. */
+export interface VersionDiff {
+    documentId: string;
+    fromVersion: number;
+    toVersion: number;
+    addedTokens: number;
+    removedTokens: number;
+    addedLines: number;
+    removedLines: number;
+}
+/** Reference to an llmtxt document shared in a message. */
+export interface LlmtxtRef {
+    slug: string;
+    url: string;
+    format: ContentFormat;
+    tokenCount: number;
+    preview: string;
+}
+/** Options for creating an attachment via the bridge. */
+export interface AttachmentOptions {
+    content: string;
+    format?: ContentFormat;
+    conversationId: string;
+    fromAgentId: string;
+    expiresInMs?: number;
+}
+/** Attachment fetch mode supported by the bridge/API layer. */
+export type AttachmentAccessMode = 'signed_url' | 'conversation' | 'owner' | 'public';
+/** Share state persisted by the API layer for an attachment. */
+export type AttachmentSharingMode = 'signed_url' | 'conversation' | 'public';
+/** Options for re-sharing an existing attachment. */
+export interface AttachmentReshareOptions {
+    expiresIn?: number;
+    mode?: AttachmentSharingMode;
+}
+/** Options for appending a version to an existing attachment slug. */
+export interface AttachmentVersionOptions {
+    baseVersion?: number;
+    changelog?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,8 @@
+/**
+ * Shared types for llmtxt content workflows.
+ *
+ * These interfaces define the data shapes used across the llmtxt ecosystem.
+ * They are intentionally decoupled from any ORM or database layer.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/validation.d.ts

@@ -0,0 +1,146 @@
+/**
+ * Outcome of a content validation operation.
+ *
+ * @remarks
+ * Returned by every validation function in this module. When `success` is
+ * `true`, `data` holds the parsed value and `format` indicates the detected
+ * content type. When `success` is `false`, `errors` describes what went wrong.
+ *
+ * @typeParam T - The expected shape of the validated data (defaults to `unknown`).
+ */
+export interface ValidationResult<T = unknown> {
+    /** Whether the validation passed without errors. */
+    success: boolean;
+    /** The parsed/validated data, present only when `success` is `true`. */
+    data?: T;
+    /** List of validation errors, present only when `success` is `false`. */
+    errors?: ValidationError[];
+    /** The detected or requested content format, when determinable. */
+    format?: 'json' | 'text' | 'markdown';
+}
+/**
+ * A single validation error with location, message, and error code.
+ *
+ * @remarks
+ * Modeled after Zod issue objects but flattened for easy serialization.
+ * The `path` uses dot-delimited notation (empty string for the root value).
+ */
+export interface ValidationError {
+    /** Dot-delimited path to the field that failed validation (empty string for root). */
+    path: string;
+    /** Human-readable description of the validation failure. */
+    message: string;
+    /** Machine-readable error code (e.g. `"invalid_json"`, `"unknown_schema"`). */
+    code: string;
+}
+/**
+ * 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 declare function validateJson(content: unknown, schemaName?: string): ValidationResult;
+/**
+ * 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 declare function validateText(content: unknown): ValidationResult<string>;
+/**
+ * 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 declare function detectFormat(content: string): 'json' | 'text' | 'markdown';
+/** Default maximum content size in bytes (5 MB). */
+export declare const DEFAULT_MAX_CONTENT_BYTES: number;
+/** Default maximum line length in bytes (64 KB). */
+export declare const DEFAULT_MAX_LINE_BYTES: number;
+/** Options for content validation. */
+export interface ValidateContentOptions {
+    /** Optional predefined schema name for JSON validation. */
+    schemaName?: string;
+    /** Maximum content size in bytes. Set to 0 to disable. Default: 5 MB. */
+    maxBytes?: number;
+    /** Maximum line length in bytes. Set to 0 to disable. Default: 64 KB. */
+    maxLineBytes?: number;
+    /** Reject content with binary control characters (0x00-0x08). Default: true. */
+    rejectBinary?: boolean;
+}
+/**
+ * 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 declare function validateContent(content: unknown, format: 'json' | 'text' | 'markdown', schemaNameOrOptions?: string | ValidateContentOptions): ValidationResult;
+/**
+ * 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 declare function autoValidate(content: unknown, schemaName?: string): ValidationResult;
+//# sourceMappingURL=validation.d.ts.map

package/dist/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"AAeA;;;;;;;;;GASG;AACH,MAAM,WAAW,gBAAgB,CAAC,CAAC,GAAG,OAAO;IAC3C,oDAAoD;IACpD,OAAO,EAAE,OAAO,CAAC;IACjB,wEAAwE;IACxE,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,yEAAyE;IACzE,MAAM,CAAC,EAAE,eAAe,EAAE,CAAC;IAC3B,mEAAmE;IACnE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,UAAU,CAAC;CACvC;AAED;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC9B,sFAAsF;IACtF,IAAI,EAAE,MAAM,CAAC;IACb,4DAA4D;IAC5D,OAAO,EAAE,MAAM,CAAC;IAChB,+EAA+E;IAC/E,IAAI,EAAE,MAAM,CAAC;CACd;AAcD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAgDpF;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAMvE;AAWD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,UAAU,CAQ1E;AAED,oDAAoD;AACpD,eAAO,MAAM,yBAAyB,QAAkB,CAAC;AAEzD,oDAAoD;AACpD,eAAO,MAAM,sBAAsB,QAAY,CAAC;AAEhD,sCAAsC;AACtC,MAAM,WAAW,sBAAsB;IACrC,2DAA2D;IAC3D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yEAAyE;IACzE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yEAAyE;IACzE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gFAAgF;IAChF,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AA8BD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,UAAU,EACpC,mBAAmB,CAAC,EAAE,MAAM,GAAG,sBAAsB,GACpD,gBAAgB,CAuElB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAcpF"}