@they-juanreina/compost-cli 0.1.0-rc.1

package/dist/lib/canonicalSessions.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Single source of truth for "is this subdir of `sessions/` a real session?"
+ * Shared between `compost status` and `compost saturate` so they can't disagree
+ * on the session set (#166 — saturate was counting every subdir as a session,
+ * while status correctly skipped non-canonical folders like `Transcripts/`).
+ *
+ * A subdir qualifies when ANY holds:
+ *   - the name matches `S\d+` (canonical id shape from ingest-watcher), OR
+ *   - it contains a `transcript.json` (already transcribed), OR
+ *   - it contains a `source.<ext>` file (queued for transcription).
+ *
+ * `_inbox/` and dotfiles are filtered out by the listing helper, not the
+ * predicate; callers that traverse `sessions/` directly should handle those.
+ */
+export declare const CANONICAL_SESSION_ID_RE: RegExp;
+export declare function isCanonicalSession(absDir: string, name: string): boolean;
+/**
+ * List the canonical session-id directory names under `<seed>/sessions/`,
+ * skipping `_inbox/`, dotfiles, files, and non-canonical folders. Returns the
+ * directory names (not absolute paths). Order is filesystem-dependent — sort
+ * at the call site if chronological ordering matters.
+ */
+export declare function listCanonicalSessionIds(sessionsDir: string): string[];
+//# sourceMappingURL=canonicalSessions.d.ts.map

package/dist/lib/canonicalSessions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canonicalSessions.d.ts","sourceRoot":"","sources":["../../src/lib/canonicalSessions.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,uBAAuB,QAAW,CAAA;AAE/C,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAKxE;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,CAWrE"}

package/dist/lib/canonicalSessions.js

@@ -0,0 +1,48 @@
+import { existsSync, readdirSync, statSync } from 'node:fs';
+import { join } from 'node:path';
+/**
+ * Single source of truth for "is this subdir of `sessions/` a real session?"
+ * Shared between `compost status` and `compost saturate` so they can't disagree
+ * on the session set (#166 — saturate was counting every subdir as a session,
+ * while status correctly skipped non-canonical folders like `Transcripts/`).
+ *
+ * A subdir qualifies when ANY holds:
+ *   - the name matches `S\d+` (canonical id shape from ingest-watcher), OR
+ *   - it contains a `transcript.json` (already transcribed), OR
+ *   - it contains a `source.<ext>` file (queued for transcription).
+ *
+ * `_inbox/` and dotfiles are filtered out by the listing helper, not the
+ * predicate; callers that traverse `sessions/` directly should handle those.
+ */
+export const CANONICAL_SESSION_ID_RE = /^S\d+$/;
+export function isCanonicalSession(absDir, name) {
+    if (CANONICAL_SESSION_ID_RE.test(name))
+        return true;
+    if (existsSync(join(absDir, 'transcript.json')))
+        return true;
+    // source.<ext> is written by processInbox before the dir is canonicalized.
+    return readdirSync(absDir).some((f) => f.startsWith('source.'));
+}
+/**
+ * List the canonical session-id directory names under `<seed>/sessions/`,
+ * skipping `_inbox/`, dotfiles, files, and non-canonical folders. Returns the
+ * directory names (not absolute paths). Order is filesystem-dependent — sort
+ * at the call site if chronological ordering matters.
+ */
+export function listCanonicalSessionIds(sessionsDir) {
+    if (!existsSync(sessionsDir))
+        return [];
+    const out = [];
+    for (const entry of readdirSync(sessionsDir)) {
+        if (entry.startsWith('.') || entry === '_inbox')
+            continue;
+        const abs = join(sessionsDir, entry);
+        if (!statSync(abs).isDirectory())
+            continue;
+        if (!isCanonicalSession(abs, entry))
+            continue;
+        out.push(entry);
+    }
+    return out;
+}
+//# sourceMappingURL=canonicalSessions.js.map

package/dist/lib/canonicalSessions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"canonicalSessions.js","sourceRoot":"","sources":["../../src/lib/canonicalSessions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AAC3D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAEhC;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,QAAQ,CAAA;AAE/C,MAAM,UAAU,kBAAkB,CAAC,MAAc,EAAE,IAAY;IAC7D,IAAI,uBAAuB,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAA;IACnD,IAAI,UAAU,CAAC,IAAI,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;QAAE,OAAO,IAAI,CAAA;IAC5D,2EAA2E;IAC3E,OAAO,WAAW,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAA;AACjE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CAAC,WAAmB;IACzD,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC;QAAE,OAAO,EAAE,CAAA;IACvC,MAAM,GAAG,GAAa,EAAE,CAAA;IACxB,KAAK,MAAM,KAAK,IAAI,WAAW,CAAC,WAAW,CAAC,EAAE,CAAC;QAC7C,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,KAAK,KAAK,QAAQ;YAAE,SAAQ;QACzD,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,EAAE,KAAK,CAAC,CAAA;QACpC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE;YAAE,SAAQ;QAC1C,IAAI,CAAC,kBAAkB,CAAC,GAAG,EAAE,KAAK,CAAC;YAAE,SAAQ;QAC7C,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IACjB,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC"}

package/dist/lib/chat.d.ts

@@ -0,0 +1,24 @@
+import { type Answer, type Chunk } from 'compost-retrieval';
+export interface ChatCitation {
+    utterance_id: string;
+    quote: string;
+    confidence: number;
+}
+export interface ChatResult {
+    answer: string;
+    citations: ChatCitation[];
+    insufficient_evidence: boolean;
+    retrieved: number;
+}
+/** Generates a candidate Answer from the question + retrieved context. The
+ * command wires this to the LLM adapter; tests inject a fake. */
+export type AnswerFn = (question: string, context: Chunk[]) => Promise<Answer>;
+export interface ChatDeps {
+    answerFn: AnswerFn;
+    seed: string;
+    topK?: number;
+    now?: () => Date;
+    chatId?: string;
+}
+export declare function chat(seedPath: string, question: string, deps: ChatDeps): Promise<ChatResult>;
+//# sourceMappingURL=chat.d.ts.map

package/dist/lib/chat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat.d.ts","sourceRoot":"","sources":["../../src/lib/chat.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,MAAM,EAAE,KAAK,KAAK,EAAkB,MAAM,mBAAmB,CAAA;AAI3E,MAAM,WAAW,YAAY;IAC3B,YAAY,EAAE,MAAM,CAAA;IACpB,KAAK,EAAE,MAAM,CAAA;IACb,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,YAAY,EAAE,CAAA;IACzB,qBAAqB,EAAE,OAAO,CAAA;IAC9B,SAAS,EAAE,MAAM,CAAA;CAClB;AAED;iEACiE;AACjE,MAAM,MAAM,QAAQ,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;AAE9E,MAAM,WAAW,QAAQ;IACvB,QAAQ,EAAE,QAAQ,CAAA;IAClB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,GAAG,CAAC,EAAE,MAAM,IAAI,CAAA;IAChB,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,wBAAsB,IAAI,CACxB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,QAAQ,GACb,OAAO,CAAC,UAAU,CAAC,CAMrB"}

package/dist/lib/chat.js

@@ -0,0 +1,50 @@
+import { appendFileSync, mkdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { validateAnswer } from 'compost-retrieval';
+import { buildDenseRetriever, retrieveChunks } from './retrieve.js';
+export async function chat(seedPath, question, deps) {
+    const result = await answerQuestion(seedPath, question, deps);
+    // Every turn is persisted — a conversation happened even when the answer was
+    // "insufficient evidence".
+    persistTurn(seedPath, deps, question, result);
+    return result;
+}
+async function answerQuestion(seedPath, question, deps) {
+    const dense = await buildDenseRetriever(seedPath);
+    const { retrieved, corpus } = await retrieveChunks(seedPath, question, {
+        topK: deps.topK ?? 8,
+        dense,
+    });
+    if (corpus.chunks.length === 0)
+        return insufficient('No indexed sessions in this seed yet.', 0);
+    if (retrieved.length === 0)
+        return insufficient('Nothing in the corpus matched the question.', 0);
+    const evidence = corpus.evidence;
+    const raw = await deps.answerFn(question, retrieved);
+    const validation = validateAnswer(raw, evidence);
+    if (validation.ok && raw.insufficient_evidence !== true) {
+        return {
+            answer: raw.answer,
+            citations: raw.claims.map((c) => ({
+                utterance_id: c.utterance_id,
+                quote: c.quote,
+                confidence: c.confidence,
+            })),
+            insufficient_evidence: false,
+            retrieved: retrieved.length,
+        };
+    }
+    return insufficient(raw.insufficient_evidence === true ? raw.answer : 'Answer failed citation validation.', retrieved.length);
+}
+function insufficient(answer, retrieved) {
+    return { answer, citations: [], insufficient_evidence: true, retrieved };
+}
+function persistTurn(seedPath, deps, question, result) {
+    const now = (deps.now ?? (() => new Date()))();
+    const chatId = deps.chatId ?? 'default';
+    const dir = join(seedPath, '.compost', 'chats', deps.seed);
+    mkdirSync(dir, { recursive: true });
+    const line = JSON.stringify({ ts: now.toISOString(), question, ...result });
+    appendFileSync(join(dir, `${chatId}.jsonl`), `${line}\n`, 'utf8');
+}
+//# sourceMappingURL=chat.js.map

package/dist/lib/chat.js.map

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

package/dist/lib/config.d.ts

@@ -0,0 +1,45 @@
+export interface ProviderSettings {
+    base_url?: string;
+    api_key_env?: string;
+}
+export interface CompostConfig {
+    providers: Record<string, ProviderSettings>;
+    defaults: Record<string, string>;
+    raw: Record<string, unknown>;
+}
+export declare function parseConfig(tomlText: string): CompostConfig;
+export declare function loadConfig(seedPath: string): CompostConfig;
+export declare function providerBaseUrl(config: CompostConfig, providerName: string): string;
+export declare function providerApiKey(config: CompostConfig, providerName: string): string | undefined;
+/** Resolve a dotted key (e.g. `providers.ollama.base_url`) against the raw TOML
+ * object. Returns undefined if any segment is missing. */
+export declare function getConfigValue(raw: Record<string, unknown>, key: string): unknown;
+/** The set of types `compost config set --type=<X>` accepts. */
+export type ConfigValueType = 'string' | 'bool' | 'int' | 'float' | 'json';
+/**
+ * Set a dotted key in the raw TOML object.
+ *
+ * Default behavior: store the value as a **string**. This matches `git config`,
+ * `gh config`, `aws configure`: leaf values are strings unless explicitly
+ * typed otherwise. This eliminates silent type drift (a researcher typing
+ * `compost config set features.beta true` previously stored a boolean and
+ * later confused `cfg.features.beta === "true"` checks).
+ *
+ * To store a non-string type, pass `type`:
+ *   - `bool`  → 'true' | 'false'
+ *   - `int`   → integer (must match /^-?\d+$/)
+ *   - `float` → decimal (must match /^-?\d+(\.\d+)?$/)
+ *   - `json`  → JSON.parse the value (arrays, objects, nested structures)
+ *
+ * Agents writing config programmatically should always pass `type` to be
+ * explicit. Humans typing strings can leave it off.
+ */
+export declare function setConfigValue(raw: Record<string, unknown>, key: string, value: string, type?: ConfigValueType): void;
+/** Write the raw TOML object back to .compost/config.toml. */
+export declare function saveConfig(seedPath: string, raw: Record<string, unknown>): void;
+/** Parse a "provider:model" routing string (model may itself contain colons). */
+export declare function parseRoute(route: string): {
+    provider: string;
+    model: string;
+};
+//# sourceMappingURL=config.d.ts.map

package/dist/lib/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/lib/config.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAA;IAC3C,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC7B;AASD,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa,CAU3D;AAED,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa,CAM1D;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAEnF;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAQ9F;AAED;0DAC0D;AAC1D,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CASjF;AAED,gEAAgE;AAChE,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,MAAM,CAAA;AAE1E;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,IAAI,GAAE,eAA0B,GAC/B,IAAI,CAeN;AAsDD,8DAA8D;AAC9D,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAG/E;AAED,iFAAiF;AACjF,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAS7E"}

package/dist/lib/config.js

@@ -0,0 +1,143 @@
+import { existsSync, readFileSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { parse as parseToml, stringify as stringifyToml } from 'smol-toml';
+import { CompostError } from '../errors.js';
+const DEFAULT_BASE_URLS = {
+    ollama: 'http://localhost:11434',
+    lmstudio: 'http://localhost:1234/v1',
+    openai: 'https://api.openai.com/v1',
+    anthropic: 'https://api.anthropic.com',
+};
+export function parseConfig(tomlText) {
+    let parsed;
+    try {
+        parsed = parseToml(tomlText);
+    }
+    catch (cause) {
+        throw new CompostError('CONFIG_ERROR', 'Could not parse config.toml', { cause });
+    }
+    const providers = parsed.providers ?? {};
+    const defaults = parsed.defaults ?? {};
+    return { providers, defaults, raw: parsed };
+}
+export function loadConfig(seedPath) {
+    const configPath = join(seedPath, '.compost', 'config.toml');
+    if (!existsSync(configPath)) {
+        throw new CompostError('CONFIG_ERROR', `No config.toml at ${configPath}`);
+    }
+    return parseConfig(readFileSync(configPath, 'utf8'));
+}
+export function providerBaseUrl(config, providerName) {
+    return config.providers[providerName]?.base_url ?? DEFAULT_BASE_URLS[providerName] ?? '';
+}
+export function providerApiKey(config, providerName) {
+    const envName = config.providers[providerName]?.api_key_env;
+    if (envName === undefined)
+        return undefined;
+    // A set-but-blank env var (`export ANTHROPIC_API_KEY=`) is effectively no key —
+    // normalize to undefined so the adapter's missing-key guard fires (and we never
+    // send a blank `x-api-key`).
+    const value = process.env[envName];
+    return value && value.trim() !== '' ? value : undefined;
+}
+/** Resolve a dotted key (e.g. `providers.ollama.base_url`) against the raw TOML
+ * object. Returns undefined if any segment is missing. */
+export function getConfigValue(raw, key) {
+    const parts = key.split('.');
+    let cursor = raw;
+    for (const part of parts) {
+        if (typeof cursor !== 'object' || cursor === null)
+            return undefined;
+        cursor = cursor[part];
+        if (cursor === undefined)
+            return undefined;
+    }
+    return cursor;
+}
+/**
+ * Set a dotted key in the raw TOML object.
+ *
+ * Default behavior: store the value as a **string**. This matches `git config`,
+ * `gh config`, `aws configure`: leaf values are strings unless explicitly
+ * typed otherwise. This eliminates silent type drift (a researcher typing
+ * `compost config set features.beta true` previously stored a boolean and
+ * later confused `cfg.features.beta === "true"` checks).
+ *
+ * To store a non-string type, pass `type`:
+ *   - `bool`  → 'true' | 'false'
+ *   - `int`   → integer (must match /^-?\d+$/)
+ *   - `float` → decimal (must match /^-?\d+(\.\d+)?$/)
+ *   - `json`  → JSON.parse the value (arrays, objects, nested structures)
+ *
+ * Agents writing config programmatically should always pass `type` to be
+ * explicit. Humans typing strings can leave it off.
+ */
+export function setConfigValue(raw, key, value, type = 'string') {
+    const parts = key.split('.');
+    if (parts.length === 0) {
+        throw new CompostError('INVALID_INPUT', 'Empty config key');
+    }
+    let cursor = raw;
+    for (let i = 0; i < parts.length - 1; i++) {
+        const part = parts[i];
+        const next = cursor[part];
+        if (next === undefined || typeof next !== 'object' || next === null || Array.isArray(next)) {
+            cursor[part] = {};
+        }
+        cursor = cursor[part];
+    }
+    cursor[parts[parts.length - 1]] = coerceTyped(value, type);
+}
+function coerceTyped(value, type) {
+    switch (type) {
+        case 'string':
+            return value;
+        case 'bool':
+            if (value === 'true')
+                return true;
+            if (value === 'false')
+                return false;
+            throw new CompostError('INVALID_INPUT', `--type=bool requires "true" or "false"; got ${JSON.stringify(value)}`);
+        case 'int': {
+            if (!/^-?\d+$/.test(value)) {
+                throw new CompostError('INVALID_INPUT', `--type=int requires an integer; got ${JSON.stringify(value)}`);
+            }
+            const n = Number(value);
+            if (!Number.isFinite(n) || !Number.isInteger(n)) {
+                throw new CompostError('INVALID_INPUT', `--type=int value out of range: ${JSON.stringify(value)}`);
+            }
+            return n;
+        }
+        case 'float': {
+            if (!/^-?\d+(\.\d+)?$/.test(value)) {
+                throw new CompostError('INVALID_INPUT', `--type=float requires a decimal number; got ${JSON.stringify(value)}`);
+            }
+            const n = Number(value);
+            if (!Number.isFinite(n)) {
+                throw new CompostError('INVALID_INPUT', `--type=float value not finite: ${JSON.stringify(value)}`);
+            }
+            return n;
+        }
+        case 'json':
+            try {
+                return JSON.parse(value);
+            }
+            catch (cause) {
+                throw new CompostError('INVALID_INPUT', `--type=json: invalid JSON: ${value}`, { cause });
+            }
+    }
+}
+/** Write the raw TOML object back to .compost/config.toml. */
+export function saveConfig(seedPath, raw) {
+    const configPath = join(seedPath, '.compost', 'config.toml');
+    writeFileSync(configPath, stringifyToml(raw), 'utf8');
+}
+/** Parse a "provider:model" routing string (model may itself contain colons). */
+export function parseRoute(route) {
+    const idx = route.indexOf(':');
+    if (idx === -1) {
+        throw new CompostError('CONFIG_ERROR', `Invalid route "${route}"; expected "provider:model" (e.g. ollama:llama3.1:8b)`);
+    }
+    return { provider: route.slice(0, idx), model: route.slice(idx + 1) };
+}
+//# sourceMappingURL=config.js.map

package/dist/lib/config.js.map

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

package/dist/lib/dispatch.d.ts

@@ -0,0 +1,10 @@
+import type { JobKind } from './queue.js';
+export interface Dispatch {
+    kind: JobKind;
+    category: 'audio' | 'video' | 'document' | 'tabular' | 'markdown';
+    ext: string;
+}
+/** Classify a file by extension into a worker dispatch, or null if unsupported. */
+export declare function classify(path: string): Dispatch | null;
+export declare const SUPPORTED_EXTENSIONS: string[];
+//# sourceMappingURL=dispatch.d.ts.map

package/dist/lib/dispatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch.d.ts","sourceRoot":"","sources":["../../src/lib/dispatch.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AAEzC,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,OAAO,CAAA;IACb,QAAQ,EAAE,OAAO,GAAG,OAAO,GAAG,UAAU,GAAG,SAAS,GAAG,UAAU,CAAA;IACjE,GAAG,EAAE,MAAM,CAAA;CACZ;AAUD,mFAAmF;AACnF,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAQtD;AAED,eAAO,MAAM,oBAAoB,UAMzB,CAAA"}

package/dist/lib/dispatch.js

@@ -0,0 +1,31 @@
+import { extname } from 'node:path';
+const AUDIO = new Set(['.mp3', '.wav', '.m4a', '.aac', '.flac', '.ogg', '.opus']);
+const VIDEO = new Set(['.mp4', '.mov', '.mkv', '.webm', '.avi', '.m4v']);
+const DOCUMENT = new Set(['.pdf', '.docx', '.pptx']);
+// `.xlsx` lands under tabular (column-mapped via openpyxl in legacy ingest).
+// `.txt` lands under markdown (Otter/Zoom exports often arrive as plain text).
+const TABULAR = new Set(['.csv', '.tsv', '.xlsx']);
+const MARKDOWN = new Set(['.md', '.markdown', '.txt']);
+/** Classify a file by extension into a worker dispatch, or null if unsupported. */
+export function classify(path) {
+    const ext = extname(path).toLowerCase();
+    if (AUDIO.has(ext))
+        return { kind: 'transcribe', category: 'audio', ext };
+    if (VIDEO.has(ext))
+        return { kind: 'transcribe', category: 'video', ext };
+    if (DOCUMENT.has(ext))
+        return { kind: 'legacy-ingest', category: 'document', ext };
+    if (TABULAR.has(ext))
+        return { kind: 'legacy-ingest', category: 'tabular', ext };
+    if (MARKDOWN.has(ext))
+        return { kind: 'legacy-ingest', category: 'markdown', ext };
+    return null;
+}
+export const SUPPORTED_EXTENSIONS = [
+    ...AUDIO,
+    ...VIDEO,
+    ...DOCUMENT,
+    ...TABULAR,
+    ...MARKDOWN,
+].sort();
+//# sourceMappingURL=dispatch.js.map

package/dist/lib/dispatch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch.js","sourceRoot":"","sources":["../../src/lib/dispatch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAUnC,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;AACjF,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;AACxE,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAA;AACpD,6EAA6E;AAC7E,+EAA+E;AAC/E,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;AAClD,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC,CAAA;AAEtD,mFAAmF;AACnF,MAAM,UAAU,QAAQ,CAAC,IAAY;IACnC,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAA;IACvC,IAAI,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAE,CAAA;IACzE,IAAI,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAE,CAAA;IACzE,IAAI,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,eAAe,EAAE,QAAQ,EAAE,UAAU,EAAE,GAAG,EAAE,CAAA;IAClF,IAAI,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,eAAe,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,EAAE,CAAA;IAChF,IAAI,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,eAAe,EAAE,QAAQ,EAAE,UAAU,EAAE,GAAG,EAAE,CAAA;IAClF,OAAO,IAAI,CAAA;AACb,CAAC;AAED,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,GAAG,KAAK;IACR,GAAG,KAAK;IACR,GAAG,QAAQ;IACX,GAAG,OAAO;IACV,GAAG,QAAQ;CACZ,CAAC,IAAI,EAAE,CAAA"}

package/dist/lib/doctor.d.ts

@@ -0,0 +1,19 @@
+import type { LLMAdapter } from '../llm/adapter.js';
+import type { ProviderHealth } from '../llm/types.js';
+import type { CompostConfig } from './config.js';
+export interface TaskReport {
+    task: string;
+    route: string;
+    provider: string;
+    model: string;
+    status: 'ok' | 'provider_down' | 'model_missing' | 'unroutable';
+    suggestion?: string;
+}
+export interface DoctorReport {
+    schema_version: '1.0';
+    providers: Record<string, ProviderHealth>;
+    tasks: TaskReport[];
+    ok: boolean;
+}
+export declare function runDoctor(adapter: LLMAdapter, config: CompostConfig): Promise<DoctorReport>;
+//# sourceMappingURL=doctor.d.ts.map

package/dist/lib/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/lib/doctor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AACnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AACrD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAGhD,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,IAAI,GAAG,eAAe,GAAG,eAAe,GAAG,YAAY,CAAA;IAC/D,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,cAAc,EAAE,KAAK,CAAA;IACrB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAA;IACzC,KAAK,EAAE,UAAU,EAAE,CAAA;IACnB,EAAE,EAAE,OAAO,CAAA;CACZ;AAUD,wBAAsB,SAAS,CAAC,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,CAmCjG"}

package/dist/lib/doctor.js

@@ -0,0 +1,43 @@
+import { parseRoute } from './config.js';
+/** A model is "present" if any reported model id starts with the routed model name. */
+function modelPresent(health, model) {
+    if (health === undefined || !health.ok)
+        return false;
+    return health.model_list.some((m) => m === model || m.startsWith(`${model}:`) || m.startsWith(model));
+}
+export async function runDoctor(adapter, config) {
+    const providers = await adapter.healthAll();
+    const tasks = [];
+    let ok = true;
+    for (const [task, route] of Object.entries(config.defaults)) {
+        let provider = '';
+        let model = '';
+        try {
+            const parsed = parseRoute(route);
+            provider = parsed.provider;
+            model = parsed.model;
+        }
+        catch {
+            tasks.push({ task, route, provider: '', model: '', status: 'unroutable' });
+            ok = false;
+            continue;
+        }
+        const health = providers[provider];
+        if (health === undefined || !health.ok) {
+            tasks.push({ task, route, provider, model, status: 'provider_down' });
+            ok = false;
+            continue;
+        }
+        if (!modelPresent(health, model)) {
+            const report = { task, route, provider, model, status: 'model_missing' };
+            if (provider === 'ollama')
+                report.suggestion = `ollama pull ${model}`;
+            tasks.push(report);
+            ok = false;
+            continue;
+        }
+        tasks.push({ task, route, provider, model, status: 'ok' });
+    }
+    return { schema_version: '1.0', providers, tasks, ok };
+}
+//# sourceMappingURL=doctor.js.map

package/dist/lib/doctor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.js","sourceRoot":"","sources":["../../src/lib/doctor.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAkBxC,uFAAuF;AACvF,SAAS,YAAY,CAAC,MAAkC,EAAE,KAAa;IACrE,IAAI,MAAM,KAAK,SAAS,IAAI,CAAC,MAAM,CAAC,EAAE;QAAE,OAAO,KAAK,CAAA;IACpD,OAAO,MAAM,CAAC,UAAU,CAAC,IAAI,CAC3B,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,UAAU,CAAC,GAAG,KAAK,GAAG,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CACvE,CAAA;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,OAAmB,EAAE,MAAqB;IACxE,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,SAAS,EAAE,CAAA;IAC3C,MAAM,KAAK,GAAiB,EAAE,CAAA;IAC9B,IAAI,EAAE,GAAG,IAAI,CAAA;IAEb,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC5D,IAAI,QAAQ,GAAG,EAAE,CAAA;QACjB,IAAI,KAAK,GAAG,EAAE,CAAA;QACd,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,UAAU,CAAC,KAAK,CAAC,CAAA;YAChC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAA;YAC1B,KAAK,GAAG,MAAM,CAAC,KAAK,CAAA;QACtB,CAAC;QAAC,MAAM,CAAC;YACP,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,CAAA;YAC1E,EAAE,GAAG,KAAK,CAAA;YACV,SAAQ;QACV,CAAC;QAED,MAAM,MAAM,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAA;QAClC,IAAI,MAAM,KAAK,SAAS,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;YACvC,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,eAAe,EAAE,CAAC,CAAA;YACrE,EAAE,GAAG,KAAK,CAAA;YACV,SAAQ;QACV,CAAC;QACD,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,CAAC;YACjC,MAAM,MAAM,GAAe,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,eAAe,EAAE,CAAA;YACpF,IAAI,QAAQ,KAAK,QAAQ;gBAAE,MAAM,CAAC,UAAU,GAAG,eAAe,KAAK,EAAE,CAAA;YACrE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;YAClB,EAAE,GAAG,KAAK,CAAA;YACV,SAAQ;QACV,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAA;IAC5D,CAAC;IAED,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE,EAAE,CAAA;AACxD,CAAC"}

package/dist/lib/events.d.ts

@@ -0,0 +1,42 @@
+import { type Event, EventWriter } from 'compost-provenance';
+/** Open an EventWriter on a seed's .compost/events.sqlite. */
+export declare function openSeedEvents(seedPath: string): EventWriter;
+/** Content-address an artifact's initial state (SHA256 of canonical JSON). */
+export declare function artifactId(initialState: unknown): string;
+/** Emit an agent-authored `create` event (used by ingest + ingest-watcher). */
+export declare function emitAgentCreate(writer: EventWriter, params: {
+    artifactKind: string;
+    initialState: Record<string, unknown>;
+    agentName: string;
+    agentVersion: string;
+    batchId?: string;
+}): Event;
+/**
+ * Author of a researcher- or AI-created artifact. A direct CLI invocation is a
+ * researcher; the MCP wrapper (Claude Code) passes `ai` with an actor_id like
+ * `claude-code:<plugin_ver>:<sha256(prompt)[:8]>` and a prompt_hash so the
+ * suggestion lands as `[draft]` until a researcher endorses it.
+ */
+export interface Author {
+    actorType: 'researcher' | 'ai';
+    actorId: string;
+    model?: string;
+    promptHash?: string;
+}
+/** Emit a researcher- or AI-authored `create` event. artifact_id is the SHA256
+ * of initialState (the provenance content-address); the human-facing file id
+ * lives in initialState.id so blame can map between them. */
+export declare function emitCreate(writer: EventWriter, params: {
+    artifactKind: string;
+    initialState: Record<string, unknown>;
+    author: Author;
+}): Event;
+/** Emit a researcher `endorse` event chaining the artifact's create event.
+ * Promotes an AI `[draft]` to endorsed (snapshot author becomes hybrid). */
+export declare function emitEndorse(writer: EventWriter, params: {
+    artifactKind: string;
+    artifactId: string;
+    parentEventId: string;
+    researcherId: string;
+}): Event;
+//# sourceMappingURL=events.d.ts.map

package/dist/lib/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/lib/events.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,KAAK,EAAmB,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAE7E,8DAA8D;AAC9D,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,CAE5D;AAED,8EAA8E;AAC9E,wBAAgB,UAAU,CAAC,YAAY,EAAE,OAAO,GAAG,MAAM,CAExD;AAED,+EAA+E;AAC/E,wBAAgB,eAAe,CAC7B,MAAM,EAAE,WAAW,EACnB,MAAM,EAAE;IACN,YAAY,EAAE,MAAM,CAAA;IACpB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACrC,SAAS,EAAE,MAAM,CAAA;IACjB,YAAY,EAAE,MAAM,CAAA;IACpB,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB,GACA,KAAK,CAaP;AAED;;;;;GAKG;AACH,MAAM,WAAW,MAAM;IACrB,SAAS,EAAE,YAAY,GAAG,IAAI,CAAA;IAC9B,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED;;6DAE6D;AAC7D,wBAAgB,UAAU,CACxB,MAAM,EAAE,WAAW,EACnB,MAAM,EAAE;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACtF,KAAK,CAaP;AAED;4EAC4E;AAC5E,wBAAgB,WAAW,CACzB,MAAM,EAAE,WAAW,EACnB,MAAM,EAAE;IACN,YAAY,EAAE,MAAM,CAAA;IACpB,UAAU,EAAE,MAAM,CAAA;IAClB,aAAa,EAAE,MAAM,CAAA;IACrB,YAAY,EAAE,MAAM,CAAA;CACrB,GACA,KAAK,CAUP"}

package/dist/lib/events.js

@@ -0,0 +1,57 @@
+import { createHash } from 'node:crypto';
+import { join } from 'node:path';
+import { EventWriter } from 'compost-provenance';
+/** Open an EventWriter on a seed's .compost/events.sqlite. */
+export function openSeedEvents(seedPath) {
+    return new EventWriter({ dbPath: join(seedPath, '.compost', 'events.sqlite') });
+}
+/** Content-address an artifact's initial state (SHA256 of canonical JSON). */
+export function artifactId(initialState) {
+    return createHash('sha256').update(JSON.stringify(initialState)).digest('hex');
+}
+/** Emit an agent-authored `create` event (used by ingest + ingest-watcher). */
+export function emitAgentCreate(writer, params) {
+    const input = {
+        artifact_kind: params.artifactKind,
+        artifact_id: artifactId(params.initialState),
+        action: 'create',
+        actor_type: 'agent',
+        actor_id: `${params.agentName}@${params.agentVersion}`,
+        agent_name: params.agentName,
+        agent_version: params.agentVersion,
+        payload: params.initialState,
+        ...(params.batchId !== undefined ? { batch_id: params.batchId } : {}),
+    };
+    return writer.appendEvent(input);
+}
+/** Emit a researcher- or AI-authored `create` event. artifact_id is the SHA256
+ * of initialState (the provenance content-address); the human-facing file id
+ * lives in initialState.id so blame can map between them. */
+export function emitCreate(writer, params) {
+    const { author } = params;
+    const input = {
+        artifact_kind: params.artifactKind,
+        artifact_id: artifactId(params.initialState),
+        action: 'create',
+        actor_type: author.actorType,
+        actor_id: author.actorId,
+        payload: params.initialState,
+        ...(author.model !== undefined ? { model: author.model } : {}),
+        ...(author.promptHash !== undefined ? { prompt_hash: author.promptHash } : {}),
+    };
+    return writer.appendEvent(input);
+}
+/** Emit a researcher `endorse` event chaining the artifact's create event.
+ * Promotes an AI `[draft]` to endorsed (snapshot author becomes hybrid). */
+export function emitEndorse(writer, params) {
+    return writer.appendEvent({
+        artifact_kind: params.artifactKind,
+        artifact_id: params.artifactId,
+        action: 'endorse',
+        actor_type: 'researcher',
+        actor_id: params.researcherId,
+        parent_event: params.parentEventId,
+        payload: { endorsed: true },
+    });
+}
+//# sourceMappingURL=events.js.map

package/dist/lib/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/lib/events.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AACxC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAEhC,OAAO,EAA+B,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAE7E,8DAA8D;AAC9D,MAAM,UAAU,cAAc,CAAC,QAAgB;IAC7C,OAAO,IAAI,WAAW,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,QAAQ,EAAE,UAAU,EAAE,eAAe,CAAC,EAAE,CAAC,CAAA;AACjF,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,UAAU,CAAC,YAAqB;IAC9C,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;AAChF,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,eAAe,CAC7B,MAAmB,EACnB,MAMC;IAED,MAAM,KAAK,GAAe;QACxB,aAAa,EAAE,MAAM,CAAC,YAAY;QAClC,WAAW,EAAE,UAAU,CAAC,MAAM,CAAC,YAAY,CAAC;QAC5C,MAAM,EAAE,QAAQ;QAChB,UAAU,EAAE,OAAO;QACnB,QAAQ,EAAE,GAAG,MAAM,CAAC,SAAS,IAAI,MAAM,CAAC,YAAY,EAAE;QACtD,UAAU,EAAE,MAAM,CAAC,SAAS;QAC5B,aAAa,EAAE,MAAM,CAAC,YAAY;QAClC,OAAO,EAAE,MAAM,CAAC,YAAY;QAC5B,GAAG,CAAC,MAAM,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACtE,CAAA;IACD,OAAO,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,CAAA;AAClC,CAAC;AAeD;;6DAE6D;AAC7D,MAAM,UAAU,UAAU,CACxB,MAAmB,EACnB,MAAuF;IAEvF,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAAA;IACzB,MAAM,KAAK,GAAe;QACxB,aAAa,EAAE,MAAM,CAAC,YAAY;QAClC,WAAW,EAAE,UAAU,CAAC,MAAM,CAAC,YAAY,CAAC;QAC5C,MAAM,EAAE,QAAQ;QAChB,UAAU,EAAE,MAAM,CAAC,SAAS;QAC5B,QAAQ,EAAE,MAAM,CAAC,OAAO;QACxB,OAAO,EAAE,MAAM,CAAC,YAAY;QAC5B,GAAG,CAAC,MAAM,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9D,GAAG,CAAC,MAAM,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC/E,CAAA;IACD,OAAO,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,CAAA;AAClC,CAAC;AAED;4EAC4E;AAC5E,MAAM,UAAU,WAAW,CACzB,MAAmB,EACnB,MAKC;IAED,OAAO,MAAM,CAAC,WAAW,CAAC;QACxB,aAAa,EAAE,MAAM,CAAC,YAAY;QAClC,WAAW,EAAE,MAAM,CAAC,UAAU;QAC9B,MAAM,EAAE,SAAS;QACjB,UAAU,EAAE,YAAY;QACxB,QAAQ,EAAE,MAAM,CAAC,YAAY;QAC7B,YAAY,EAAE,MAAM,CAAC,aAAa;QAClC,OAAO,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE;KAC5B,CAAC,CAAA;AACJ,CAAC"}

package/dist/lib/export.d.ts

@@ -0,0 +1,14 @@
+import type { Transcript } from './transcript.js';
+export type ExportFormat = 'csv' | 'md' | 'eaf';
+export interface ExportOptions {
+    format: ExportFormat;
+    createdDate?: string;
+}
+export interface ExportResult {
+    format: ExportFormat;
+    session_id: string;
+    content: string;
+}
+export declare function loadTranscript(path: string): Transcript;
+export declare function exportTranscript(transcript: Transcript, opts: ExportOptions): ExportResult;
+//# sourceMappingURL=export.d.ts.map

package/dist/lib/export.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"export.d.ts","sourceRoot":"","sources":["../../src/lib/export.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAEjD,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,IAAI,GAAG,KAAK,CAAA;AAE/C,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,YAAY,CAAA;IACpB,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,YAAY,CAAA;IACpB,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAkBvD;AAED,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,UAAU,EAAE,IAAI,EAAE,aAAa,GAAG,YAAY,CAa1F"}