@modular-prompt/extract 0.2.0

package/dist/cli/manifest.d.ts

@@ -0,0 +1,12 @@
+import type { MaterialInput } from '../extract-elements.js';
+export interface ExtractCacheManifest {
+    version: 1;
+    model: string;
+    materials: MaterialInput[];
+    createdAt: string;
+}
+export declare function manifestPath(cacheDir: string): string;
+export declare function manifestExists(cacheDir: string): Promise<boolean>;
+export declare function readManifest(cacheDir: string): Promise<ExtractCacheManifest>;
+export declare function writeManifest(cacheDir: string, manifest: ExtractCacheManifest): Promise<void>;
+//# sourceMappingURL=manifest.d.ts.map

package/dist/cli/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../src/cli/manifest.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAG5D,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,CAAC,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,aAAa,EAAE,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAErD;AAED,wBAAsB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAOvE;AAED,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAOlF;AAED,wBAAsB,aAAa,CACjC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,oBAAoB,GAC7B,OAAO,CAAC,IAAI,CAAC,CAMf"}

package/dist/cli/manifest.js

@@ -0,0 +1,27 @@
+import { readFile, writeFile, access } from 'node:fs/promises';
+import { join } from 'node:path';
+import { MANIFEST_FILENAME } from './constants.js';
+export function manifestPath(cacheDir) {
+    return join(cacheDir, MANIFEST_FILENAME);
+}
+export async function manifestExists(cacheDir) {
+    try {
+        await access(manifestPath(cacheDir));
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export async function readManifest(cacheDir) {
+    const raw = await readFile(manifestPath(cacheDir), 'utf-8');
+    const parsed = JSON.parse(raw);
+    if (parsed.version !== 1 || !parsed.model || !Array.isArray(parsed.materials)) {
+        throw new Error(`Invalid manifest: ${manifestPath(cacheDir)}`);
+    }
+    return parsed;
+}
+export async function writeManifest(cacheDir, manifest) {
+    await writeFile(manifestPath(cacheDir), `${JSON.stringify(manifest, null, 2)}\n`, 'utf-8');
+}
+//# sourceMappingURL=manifest.js.map

package/dist/cli/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../../src/cli/manifest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC/D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AASnD,MAAM,UAAU,YAAY,CAAC,QAAgB;IAC3C,OAAO,IAAI,CAAC,QAAQ,EAAE,iBAAiB,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,QAAgB;IACnD,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC;QACrC,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,QAAgB;IACjD,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,YAAY,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC,CAAC;IAC5D,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAyB,CAAC;IACvD,IAAI,MAAM,CAAC,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC;QAC9E,MAAM,IAAI,KAAK,CAAC,qBAAqB,YAAY,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IACjE,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,QAAgB,EAChB,QAA8B;IAE9B,MAAM,SAAS,CACb,YAAY,CAAC,QAAQ,CAAC,EACtB,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EACxC,OAAO,CACR,CAAC;AACJ,CAAC"}

package/dist/cli/render-prompt.d.ts

@@ -0,0 +1,6 @@
+import type { ExtractCorpus, ExtractRequest } from '../types.js';
+/**
+ * compile + completion 形式で抽出プロンプト全文をレンダリングする（MLX 不要）。
+ */
+export declare function renderExtractPrompt(corpus: ExtractCorpus, request: ExtractRequest): string;
+//# sourceMappingURL=render-prompt.d.ts.map

package/dist/cli/render-prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-prompt.d.ts","sourceRoot":"","sources":["../../src/cli/render-prompt.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAEjE;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,aAAa,EACrB,OAAO,EAAE,cAAc,GACtB,MAAM,CAQR"}

package/dist/cli/render-prompt.js

@@ -0,0 +1,11 @@
+import { formatCompletionPrompt } from '@modular-prompt/driver';
+import { compileExtractPrompt } from '../compile-extract-prompt.js';
+import { defaultExtractBaseModule } from '../modules/default-base-module.js';
+/**
+ * compile + completion 形式で抽出プロンプト全文をレンダリングする（MLX 不要）。
+ */
+export function renderExtractPrompt(corpus, request) {
+    const compiled = compileExtractPrompt(defaultExtractBaseModule, corpus, request, undefined);
+    return formatCompletionPrompt(compiled);
+}
+//# sourceMappingURL=render-prompt.js.map

package/dist/cli/render-prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-prompt.js","sourceRoot":"","sources":["../../src/cli/render-prompt.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,EAAE,wBAAwB,EAAE,MAAM,mCAAmC,CAAC;AAG7E;;GAEG;AACH,MAAM,UAAU,mBAAmB,CACjC,MAAqB,EACrB,OAAuB;IAEvB,MAAM,QAAQ,GAAG,oBAAoB,CACnC,wBAAwB,EACxB,MAAM,EACN,OAAO,EACP,SAAS,CACV,CAAC;IACF,OAAO,sBAAsB,CAAC,QAAQ,CAAC,CAAC;AAC1C,CAAC"}

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,127 @@
+#!/usr/bin/env node
+import { readFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { DEFAULT_CACHE_DIR, DEFAULT_MAX_TOKENS, DEFAULT_MODEL } from './cli/constants.js';
+import { runCreateCommand } from './cli/create-command.js';
+import { runExtractCommand } from './cli/extract-command.js';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const packageJson = JSON.parse(readFileSync(join(__dirname, '../package.json'), 'utf-8'));
+function printHelp() {
+    console.log(`modular-extract v${packageJson.version}
+
+Usage:
+  modular-extract create [-d <cache-dir>] [-m <model>] [--dry-run] <files...>
+  modular-extract extract -d <cache-dir> [--max-tokens <n>] [--dry-run] <query...>
+
+Commands:
+  create    Load input files and prepare KV cache in <cache-dir>
+  extract   Run extraction query against a prepared cache directory
+
+Options:
+  -d, --cache-dir <path>   Cache directory (create default: ${DEFAULT_CACHE_DIR})
+  -m, --model <model>      MLX model id (create default: ${DEFAULT_MODEL})
+  --max-tokens <n>         Max tokens for extract (default: ${DEFAULT_MAX_TOKENS})
+  --dry-run                Compile and print full prompt text (no MLX / no cache write)
+  -h, --help               Show help
+
+Cache cleanup:
+  rm -rf <cache-dir>
+
+Note:
+  MLX backend is fixed to mlx-lm (backend: lm) for prompt cache support.
+`);
+}
+function parseArgs(argv) {
+    const result = { positional: [] };
+    let index = 0;
+    while (index < argv.length) {
+        const arg = argv[index];
+        if (arg === '-h' || arg === '--help') {
+            result.command = 'help';
+            return result;
+        }
+        if (!result.command && !arg.startsWith('-')) {
+            if (arg === 'create' || arg === 'extract') {
+                result.command = arg;
+                index += 1;
+                continue;
+            }
+        }
+        if (arg === '-d' || arg === '--cache-dir') {
+            result.cacheDir = argv[index + 1];
+            if (!result.cacheDir) {
+                throw new Error(`${arg} requires a path`);
+            }
+            index += 2;
+            continue;
+        }
+        if (arg === '-m' || arg === '--model') {
+            result.model = argv[index + 1];
+            if (!result.model) {
+                throw new Error(`${arg} requires a model id`);
+            }
+            index += 2;
+            continue;
+        }
+        if (arg === '--dry-run') {
+            result.dryRun = true;
+            index += 1;
+            continue;
+        }
+        if (arg === '--max-tokens') {
+            const value = argv[index + 1];
+            const parsed = Number.parseInt(value ?? '', 10);
+            if (!Number.isFinite(parsed) || parsed < 1) {
+                throw new Error('--max-tokens must be a positive integer');
+            }
+            result.maxTokens = parsed;
+            index += 2;
+            continue;
+        }
+        if (arg.startsWith('-')) {
+            throw new Error(`Unknown option: ${arg}`);
+        }
+        result.positional.push(arg);
+        index += 1;
+    }
+    return result;
+}
+async function main() {
+    const parsed = parseArgs(process.argv.slice(2));
+    if (!parsed.command || parsed.command === 'help') {
+        printHelp();
+        if (!parsed.command) {
+            process.exitCode = 1;
+        }
+        return;
+    }
+    if (parsed.command === 'create') {
+        const output = await runCreateCommand({
+            cacheDir: parsed.cacheDir ?? DEFAULT_CACHE_DIR,
+            model: parsed.model ?? DEFAULT_MODEL,
+            files: parsed.positional,
+            dryRun: parsed.dryRun,
+        });
+        if (typeof output === 'string') {
+            process.stdout.write(`${output}\n`);
+        }
+        return;
+    }
+    if (!parsed.cacheDir) {
+        throw new Error('extract requires -d <cache-dir>');
+    }
+    const text = await runExtractCommand({
+        cacheDir: parsed.cacheDir,
+        query: parsed.positional.join(' '),
+        maxTokens: parsed.maxTokens,
+        dryRun: parsed.dryRun,
+    });
+    process.stdout.write(`${text}\n`);
+}
+main().catch((error) => {
+    const message = error instanceof Error ? error.message : String(error);
+    console.error(message);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/compile-extract-prompt.d.ts

@@ -0,0 +1,6 @@
+import type { PromptModule } from '@modular-prompt/core';
+import type { ExtractCorpus, ExtractRequest } from './types.js';
+export declare function usesDefaultDataTemplates(baseModule?: PromptModule): boolean;
+export declare function buildCompileModule<TContext>(sessionBaseModule: PromptModule<TContext>, corpus: ExtractCorpus, request: ExtractRequest, baseModule?: PromptModule<TContext>): PromptModule<TContext>;
+export declare function compileExtractPrompt<TContext>(sessionBaseModule: PromptModule<TContext>, corpus: ExtractCorpus, request: ExtractRequest, baseModule?: PromptModule<TContext>): import("@modular-prompt/core").CompiledPrompt;
+//# sourceMappingURL=compile-extract-prompt.d.ts.map

package/dist/compile-extract-prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compile-extract-prompt.d.ts","sourceRoot":"","sources":["../src/compile-extract-prompt.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEzD,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAGhE,wBAAgB,wBAAwB,CACtC,UAAU,CAAC,EAAE,YAAY,GACxB,OAAO,CAET;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EACzC,iBAAiB,EAAE,YAAY,CAAC,QAAQ,CAAC,EACzC,MAAM,EAAE,aAAa,EACrB,OAAO,EAAE,cAAc,EACvB,UAAU,CAAC,EAAE,YAAY,CAAC,QAAQ,CAAC,GAClC,YAAY,CAAC,QAAQ,CAAC,CAUxB;AAED,wBAAgB,oBAAoB,CAAC,QAAQ,EAC3C,iBAAiB,EAAE,YAAY,CAAC,QAAQ,CAAC,EACzC,MAAM,EAAE,aAAa,EACrB,OAAO,EAAE,cAAc,EACvB,UAAU,CAAC,EAAE,YAAY,CAAC,QAAQ,CAAC,iDAKpC"}

package/dist/compile-extract-prompt.js

@@ -0,0 +1,18 @@
+import { merge, compile } from '@modular-prompt/core';
+import { buildCorpusModule, buildRequestModule } from './build-modules.js';
+import { buildExtractContext } from './extract-context.js';
+export function usesDefaultDataTemplates(baseModule) {
+    return baseModule === undefined;
+}
+export function buildCompileModule(sessionBaseModule, corpus, request, baseModule) {
+    if (usesDefaultDataTemplates(baseModule)) {
+        return sessionBaseModule;
+    }
+    return merge(sessionBaseModule, buildCorpusModule(corpus), buildRequestModule(request));
+}
+export function compileExtractPrompt(sessionBaseModule, corpus, request, baseModule) {
+    const context = buildExtractContext(corpus, request);
+    const module = buildCompileModule(sessionBaseModule, corpus, request, baseModule);
+    return compile(module, context);
+}
+//# sourceMappingURL=compile-extract-prompt.js.map

package/dist/compile-extract-prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compile-extract-prompt.js","sourceRoot":"","sources":["../src/compile-extract-prompt.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAEtD,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAE3E,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAE3D,MAAM,UAAU,wBAAwB,CACtC,UAAyB;IAEzB,OAAO,UAAU,KAAK,SAAS,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,iBAAyC,EACzC,MAAqB,EACrB,OAAuB,EACvB,UAAmC;IAEnC,IAAI,wBAAwB,CAAC,UAAU,CAAC,EAAE,CAAC;QACzC,OAAO,iBAAiB,CAAC;IAC3B,CAAC;IAED,OAAO,KAAK,CACV,iBAAiB,EACjB,iBAAiB,CAAC,MAAM,CAAC,EACzB,kBAAkB,CAAC,OAAO,CAAC,CACF,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,iBAAyC,EACzC,MAAqB,EACrB,OAAuB,EACvB,UAAmC;IAEnC,MAAM,OAAO,GAAG,mBAAmB,CAAC,MAAM,EAAE,OAAO,CAAa,CAAC;IACjE,MAAM,MAAM,GAAG,kBAAkB,CAAC,iBAAiB,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;IAClF,OAAO,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAClC,CAAC"}

package/dist/create-extract-session.d.ts

@@ -0,0 +1,4 @@
+import type { ExtractContext } from './extract-context.js';
+import type { ExtractSession, ExtractSessionOptions } from './types.js';
+export declare function createExtractSession<TContext = ExtractContext>(options: ExtractSessionOptions<TContext>): ExtractSession;
+//# sourceMappingURL=create-extract-session.d.ts.map

package/dist/create-extract-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-extract-session.d.ts","sourceRoot":"","sources":["../src/create-extract-session.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAiC,cAAc,EAA8B,qBAAqB,EAAE,MAAM,YAAY,CAAC;AA0BnI,wBAAgB,oBAAoB,CAAC,QAAQ,GAAG,cAAc,EAC5D,OAAO,EAAE,qBAAqB,CAAC,QAAQ,CAAC,GACvC,cAAc,CA0EhB"}

package/dist/create-extract-session.js

@@ -0,0 +1,63 @@
+import { merge } from '@modular-prompt/core';
+import { resolveSessionModules } from './resolve-session-modules.js';
+import { compileExtractPrompt } from './compile-extract-prompt.js';
+import { ensureCacheControllerReady, prepareSessionCache, releaseSessionCache, resolveModelName, } from './cache-lifecycle.js';
+function buildSessionBaseModule(baseModule, schema) {
+    if (!schema) {
+        return baseModule;
+    }
+    const schemaModule = {
+        schema: [{ type: 'json', content: schema }],
+    };
+    return merge(baseModule, schemaModule);
+}
+export function createExtractSession(options) {
+    const { driver, corpus, schema, cacheController, baseModule } = options;
+    const model = resolveModelName(options.model);
+    const sessionBaseModule = buildSessionBaseModule(resolveSessionModules(options), schema);
+    const history = [];
+    const cacheState = {
+        handle: null,
+        controllerReady: false,
+    };
+    let closed = false;
+    return {
+        async extract(request) {
+            if (closed) {
+                throw new Error('ExtractSession is closed');
+            }
+            await ensureCacheControllerReady(driver, cacheState);
+            await prepareSessionCache(cacheController, model, sessionBaseModule, corpus, request, baseModule, cacheState);
+            const compiled = compileExtractPrompt(sessionBaseModule, corpus, request, baseModule);
+            const queryOptions = cacheState.handle
+                ? {
+                    ...request.options,
+                    cache: false,
+                    cacheHandle: cacheState.handle,
+                }
+                : request.options;
+            const queryResult = await driver.query(compiled, queryOptions);
+            const result = {
+                text: queryResult.content,
+                structured: queryResult.structuredOutput,
+                usage: queryResult.usage,
+                index: history.length,
+            };
+            history.push(result);
+            return result;
+        },
+        getHistory() {
+            return [...history];
+        },
+        async close(options) {
+            if (closed) {
+                return;
+            }
+            closed = true;
+            if (options?.releaseCache !== false) {
+                releaseSessionCache(cacheController, cacheState);
+            }
+        },
+    };
+}
+//# sourceMappingURL=create-extract-session.js.map

package/dist/create-extract-session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-extract-session.js","sourceRoot":"","sources":["../src/create-extract-session.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAI7C,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EACL,0BAA0B,EAC1B,mBAAmB,EACnB,mBAAmB,EACnB,gBAAgB,GAEjB,MAAM,sBAAsB,CAAC;AAE9B,SAAS,sBAAsB,CAC7B,UAAkC,EAClC,MAAe;IAEf,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,MAAM,YAAY,GAAiB;QACjC,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;KAC5C,CAAC;IAEF,OAAO,KAAK,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,OAAwC;IAExC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC;IACxE,MAAM,KAAK,GAAG,gBAAgB,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAE9C,MAAM,iBAAiB,GAAG,sBAAsB,CAC9C,qBAAqB,CAAC,OAAO,CAAC,EAC9B,MAAM,CACP,CAAC;IACF,MAAM,OAAO,GAAoB,EAAE,CAAC;IACpC,MAAM,UAAU,GAAwB;QACtC,MAAM,EAAE,IAAI;QACZ,eAAe,EAAE,KAAK;KACvB,CAAC;IACF,IAAI,MAAM,GAAG,KAAK,CAAC;IAEnB,OAAO;QACL,KAAK,CAAC,OAAO,CAAC,OAAuB;YACnC,IAAI,MAAM,EAAE,CAAC;gBACX,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;YAC9C,CAAC;YAED,MAAM,0BAA0B,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;YACrD,MAAM,mBAAmB,CACvB,eAAe,EACf,KAAK,EACL,iBAAiB,EACjB,MAAM,EACN,OAAO,EACP,UAAU,EACV,UAAU,CACX,CAAC;YAEF,MAAM,QAAQ,GAAG,oBAAoB,CACnC,iBAAiB,EACjB,MAAM,EACN,OAAO,EACP,UAAU,CACX,CAAC;YACF,MAAM,YAAY,GAAG,UAAU,CAAC,MAAM;gBACpC,CAAC,CAAC;oBACE,GAAG,OAAO,CAAC,OAAO;oBAClB,KAAK,EAAE,KAAc;oBACrB,WAAW,EAAE,UAAU,CAAC,MAAM;iBAC/B;gBACH,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC;YAEpB,MAAM,WAAW,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;YAE/D,MAAM,MAAM,GAAkB;gBAC5B,IAAI,EAAE,WAAW,CAAC,OAAO;gBACzB,UAAU,EAAE,WAAW,CAAC,gBAAgB;gBACxC,KAAK,EAAE,WAAW,CAAC,KAAK;gBACxB,KAAK,EAAE,OAAO,CAAC,MAAM;aACtB,CAAC;YAEF,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACrB,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,UAAU;YACR,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC;QACtB,CAAC;QAED,KAAK,CAAC,KAAK,CAAC,OAAoC;YAC9C,IAAI,MAAM,EAAE,CAAC;gBACX,OAAO;YACT,CAAC;YACD,MAAM,GAAG,IAAI,CAAC;YAEd,IAAI,OAAO,EAAE,YAAY,KAAK,KAAK,EAAE,CAAC;gBACpC,mBAAmB,CAAC,eAAe,EAAE,UAAU,CAAC,CAAC;YACnD,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/create-mlx-extract-runtime.d.ts

@@ -0,0 +1,20 @@
+import { type AIDriver, type PromptCacheController } from '@modular-prompt/driver';
+export interface MlxExtractRuntimeOptions {
+    model: string;
+    /** Fixed cache directory. When omitted, a managed temp directory is used. */
+    cacheDir?: string;
+}
+/**
+ * MLX driver + cache controller bundle for extract sessions.
+ * Always uses mlx-lm backend (`backend: 'lm'`) — VLM auto-selection disables prompt cache.
+ * Lifecycle (close) is owned by the caller — not by ExtractSession.
+ */
+export interface MlxExtractRuntime {
+    driver: AIDriver;
+    cacheController: PromptCacheController;
+    model: string;
+    /** Release driver and cache controller when all sessions using this runtime are done. */
+    close(): Promise<void>;
+}
+export declare function createMlxExtractRuntime(options: MlxExtractRuntimeOptions): Promise<MlxExtractRuntime>;
+//# sourceMappingURL=create-mlx-extract-runtime.d.ts.map

package/dist/create-mlx-extract-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-mlx-extract-runtime.d.ts","sourceRoot":"","sources":["../src/create-mlx-extract-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,QAAQ,EACb,KAAK,qBAAqB,EAC3B,MAAM,wBAAwB,CAAC;AAEhC,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,QAAQ,CAAC;IACjB,eAAe,EAAE,qBAAqB,CAAC;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,yFAAyF;IACzF,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,iBAAiB,CAAC,CAuB5B"}

package/dist/create-mlx-extract-runtime.js

@@ -0,0 +1,22 @@
+import { MlxCacheController, MlxDriver, } from '@modular-prompt/driver';
+export async function createMlxExtractRuntime(options) {
+    const cacheController = new MlxCacheController(options.cacheDir ? { cacheDir: options.cacheDir } : undefined);
+    const driver = new MlxDriver({
+        model: options.model,
+        backend: 'lm',
+        cacheController,
+    });
+    if ('getCapabilities' in driver && typeof driver.getCapabilities === 'function') {
+        await driver.getCapabilities();
+    }
+    return {
+        driver,
+        cacheController,
+        model: options.model,
+        async close() {
+            await driver.close();
+            await cacheController.close();
+        },
+    };
+}
+//# sourceMappingURL=create-mlx-extract-runtime.js.map

package/dist/create-mlx-extract-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-mlx-extract-runtime.js","sourceRoot":"","sources":["../src/create-mlx-extract-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,SAAS,GAGV,MAAM,wBAAwB,CAAC;AAqBhC,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,OAAiC;IAEjC,MAAM,eAAe,GAAG,IAAI,kBAAkB,CAC5C,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,SAAS,CAC9D,CAAC;IACF,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,OAAO,EAAE,IAAI;QACb,eAAe;KAChB,CAAC,CAAC;IAEH,IAAI,iBAAiB,IAAI,MAAM,IAAI,OAAO,MAAM,CAAC,eAAe,KAAK,UAAU,EAAE,CAAC;QAChF,MAAM,MAAM,CAAC,eAAe,EAAE,CAAC;IACjC,CAAC;IAED,OAAO;QACL,MAAM;QACN,eAAe;QACf,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,KAAK,CAAC,KAAK;YACT,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;YACrB,MAAM,eAAe,CAAC,KAAK,EAAE,CAAC;QAChC,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/extract-context.d.ts

@@ -0,0 +1,15 @@
+import type { ChunkElement, MaterialElement, MessageElement, SectionContent, TextElement } from '@modular-prompt/core';
+import type { ExtractCorpus, ExtractRequest } from './types.js';
+/** compile() に渡す抽出セッションのコンテキスト。 */
+export interface ExtractContext {
+    materials?: readonly MaterialElement[];
+    messages?: readonly MessageElement[];
+    inputs?: readonly ChunkElement[];
+    cue: string | SectionContent;
+}
+export declare function normalizeCue(cue: string | SectionContent): SectionContent;
+export declare function buildExtractContext(corpus: ExtractCorpus, request: ExtractRequest): ExtractContext;
+export declare function sectionHasContent<T>(content?: readonly T[]): content is readonly T[];
+export declare function expandCueContent(cue: string | SectionContent): TextElement[];
+export declare function sectionTemplateHeader(content: string): TextElement;
+//# sourceMappingURL=extract-context.d.ts.map

package/dist/extract-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract-context.d.ts","sourceRoot":"","sources":["../src/extract-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,eAAe,EACf,cAAc,EACd,cAAc,EACd,WAAW,EACZ,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAOhE,mCAAmC;AACnC,MAAM,WAAW,cAAc;IAC7B,SAAS,CAAC,EAAE,SAAS,eAAe,EAAE,CAAC;IACvC,QAAQ,CAAC,EAAE,SAAS,cAAc,EAAE,CAAC;IACrC,MAAM,CAAC,EAAE,SAAS,YAAY,EAAE,CAAC;IACjC,GAAG,EAAE,MAAM,GAAG,cAAc,CAAC;CAC9B;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,GAAG,cAAc,CAEzE;AAED,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,aAAa,EACrB,OAAO,EAAE,cAAc,GACtB,cAAc,CAOhB;AAED,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,SAAS,CAAC,EAAE,GAAG,OAAO,IAAI,SAAS,CAAC,EAAE,CAEpF;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,GAAG,WAAW,EAAE,CAqB5E;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,CAElE"}

package/dist/extract-context.js

@@ -0,0 +1,39 @@
+import { normalizeInputs, normalizeMaterials, normalizeMessages, } from './extract-elements.js';
+export function normalizeCue(cue) {
+    return typeof cue === 'string' ? [cue] : cue;
+}
+export function buildExtractContext(corpus, request) {
+    return {
+        materials: normalizeMaterials(corpus.materials),
+        messages: normalizeMessages(corpus.messages),
+        inputs: normalizeInputs(request.inputs),
+        cue: request.cue,
+    };
+}
+export function sectionHasContent(content) {
+    return content != null && content.length > 0;
+}
+export function expandCueContent(cue) {
+    const content = normalizeCue(cue);
+    const result = [];
+    for (const item of content) {
+        if (typeof item === 'string') {
+            result.push({ type: 'text', content: item, cacheHint: 'contextual' });
+            continue;
+        }
+        if (typeof item === 'function') {
+            continue;
+        }
+        if (item && typeof item === 'object' && item.type === 'text') {
+            result.push({
+                ...item,
+                cacheHint: item.cacheHint ?? 'contextual',
+            });
+        }
+    }
+    return result;
+}
+export function sectionTemplateHeader(content) {
+    return { type: 'text', content, cacheHint: 'static' };
+}
+//# sourceMappingURL=extract-context.js.map

package/dist/extract-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract-context.js","sourceRoot":"","sources":["../src/extract-context.ts"],"names":[],"mappings":"AAQA,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,uBAAuB,CAAC;AAU/B,MAAM,UAAU,YAAY,CAAC,GAA4B;IACvD,OAAO,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,MAAqB,EACrB,OAAuB;IAEvB,OAAO;QACL,SAAS,EAAE,kBAAkB,CAAC,MAAM,CAAC,SAAS,CAAC;QAC/C,QAAQ,EAAE,iBAAiB,CAAC,MAAM,CAAC,QAAQ,CAAC;QAC5C,MAAM,EAAE,eAAe,CAAC,OAAO,CAAC,MAAM,CAAC;QACvC,GAAG,EAAE,OAAO,CAAC,GAAG;KACjB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAI,OAAsB;IACzD,OAAO,OAAO,IAAI,IAAI,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,GAA4B;IAC3D,MAAM,OAAO,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;IAClC,MAAM,MAAM,GAAkB,EAAE,CAAC;IAEjC,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;QAC3B,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC7B,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,YAAY,EAAE,CAAC,CAAC;YACtE,SAAS;QACX,CAAC;QACD,IAAI,OAAO,IAAI,KAAK,UAAU,EAAE,CAAC;YAC/B,SAAS;QACX,CAAC;QACD,IAAI,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YAC7D,MAAM,CAAC,IAAI,CAAC;gBACV,GAAG,IAAI;gBACP,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,YAAY;aAC1C,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,OAAe;IACnD,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC;AACxD,CAAC"}

package/dist/extract-elements.d.ts

@@ -0,0 +1,48 @@
+import type { Attachment, ChunkElement, MaterialElement, MessageElement, ToolCall, ToolResultKind } from '@modular-prompt/core';
+/** 資料の最小入力。`id` 省略時は `title` を使用する。 */
+export interface MaterialInput {
+    title: string;
+    content: string | Attachment[];
+    id?: string;
+    usage?: number;
+}
+/** 標準メッセージの最小入力。 */
+export interface StandardMessageInput {
+    role: 'system' | 'assistant' | 'user';
+    content: string | Attachment[];
+    name?: string;
+    toolCalls?: ToolCall[];
+}
+/** ツール結果メッセージの最小入力。 */
+export interface ToolResultMessageInput {
+    role: 'tool';
+    toolCallId: string;
+    name: string;
+    kind: ToolResultKind;
+    value: unknown;
+}
+export type MessageInput = StandardMessageInput | ToolResultMessageInput;
+/** 補強情報（chunk）の最小入力。`partOf` 省略時は `inputs`。 */
+export interface ChunkInput {
+    content: string | Attachment[];
+    partOf?: string;
+    index?: number;
+    total?: number;
+    usage?: number;
+}
+/** 文字列は `content` の省略記法。 */
+export type ChunkInputValue = string | ChunkInput;
+export type MaterialsInput = MaterialInput | readonly MaterialInput[];
+export type MessagesInput = MessageInput | readonly MessageInput[];
+export type InputsInput = ChunkInputValue | readonly ChunkInputValue[];
+export declare function normalizeMaterial(input: MaterialInput, _index: number): MaterialElement;
+export declare function normalizeMessage(input: MessageInput): MessageElement;
+export declare function normalizeChunkInput(input: ChunkInputValue, _index: number): ChunkElement;
+export declare function normalizeMaterials(materials?: MaterialsInput): readonly MaterialElement[] | undefined;
+export declare function normalizeMessages(messages?: MessagesInput): readonly MessageElement[] | undefined;
+export declare function normalizeInputs(inputs?: InputsInput): readonly ChunkElement[] | undefined;
+/** 補強情報の単一 chunk 入力ヘルパー。 */
+export declare function inputChunk(content: ChunkInput['content'], options?: Pick<ChunkInput, 'partOf' | 'index' | 'total' | 'usage'>): ChunkInput;
+/** JSON オブジェクトを chunk 入力に変換するヘルパー。 */
+export declare function inputChunksFromJson(data: unknown, partOf?: string): ChunkInput[];
+//# sourceMappingURL=extract-elements.d.ts.map

package/dist/extract-elements.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract-elements.d.ts","sourceRoot":"","sources":["../src/extract-elements.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EAEV,YAAY,EACZ,eAAe,EACf,cAAc,EACd,QAAQ,EACR,cAAc,EACf,MAAM,sBAAsB,CAAC;AAE9B,uCAAuC;AACvC,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,GAAG,UAAU,EAAE,CAAC;IAC/B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,oBAAoB;AACpB,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,QAAQ,GAAG,WAAW,GAAG,MAAM,CAAC;IACtC,OAAO,EAAE,MAAM,GAAG,UAAU,EAAE,CAAC;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAC;CACxB;AAED,uBAAuB;AACvB,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,cAAc,CAAC;IACrB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,MAAM,YAAY,GAAG,oBAAoB,GAAG,sBAAsB,CAAC;AAEzE,+CAA+C;AAC/C,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,GAAG,UAAU,EAAE,CAAC;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,4BAA4B;AAC5B,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,UAAU,CAAC;AAElD,MAAM,MAAM,cAAc,GAAG,aAAa,GAAG,SAAS,aAAa,EAAE,CAAC;AACtE,MAAM,MAAM,aAAa,GAAG,YAAY,GAAG,SAAS,YAAY,EAAE,CAAC;AACnE,MAAM,MAAM,WAAW,GAAG,eAAe,GAAG,SAAS,eAAe,EAAE,CAAC;AAgBvE,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,aAAa,EACpB,MAAM,EAAE,MAAM,GACb,eAAe,CASjB;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,YAAY,GAAG,cAAc,CAqBpE;AAED,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,eAAe,EACtB,MAAM,EAAE,MAAM,GACb,YAAY,CAcd;AAED,wBAAgB,kBAAkB,CAChC,SAAS,CAAC,EAAE,cAAc,GACzB,SAAS,eAAe,EAAE,GAAG,SAAS,CAKxC;AAED,wBAAgB,iBAAiB,CAC/B,QAAQ,CAAC,EAAE,aAAa,GACvB,SAAS,cAAc,EAAE,GAAG,SAAS,CAKvC;AAED,wBAAgB,eAAe,CAC7B,MAAM,CAAC,EAAE,WAAW,GACnB,SAAS,YAAY,EAAE,GAAG,SAAS,CAKrC;AAED,4BAA4B;AAC5B,wBAAgB,UAAU,CACxB,OAAO,EAAE,UAAU,CAAC,SAAS,CAAC,EAC9B,OAAO,CAAC,EAAE,IAAI,CAAC,UAAU,EAAE,QAAQ,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC,GACjE,UAAU,CAQZ;AAED,sCAAsC;AACtC,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,OAAO,EACb,MAAM,SAAW,GAChB,UAAU,EAAE,CAEd"}

package/dist/extract-elements.js

@@ -0,0 +1,87 @@
+function toInputArray(value) {
+    return (Array.isArray(value) ? value : [value]);
+}
+function withCacheHint(element, defaultHint) {
+    return {
+        ...element,
+        cacheHint: defaultHint,
+    };
+}
+export function normalizeMaterial(input, _index) {
+    const element = {
+        type: 'material',
+        id: input.id ?? input.title,
+        title: input.title,
+        content: input.content,
+        ...(input.usage !== undefined ? { usage: input.usage } : {}),
+    };
+    return withCacheHint(element, 'immutable');
+}
+export function normalizeMessage(input) {
+    if (input.role === 'tool') {
+        const element = {
+            type: 'message',
+            role: 'tool',
+            toolCallId: input.toolCallId,
+            name: input.name,
+            kind: input.kind,
+            value: input.value,
+        };
+        return withCacheHint(element, 'contextual');
+    }
+    const element = {
+        type: 'message',
+        role: input.role,
+        content: input.content,
+        ...(input.name !== undefined ? { name: input.name } : {}),
+        ...(input.toolCalls !== undefined ? { toolCalls: input.toolCalls } : {}),
+    };
+    return withCacheHint(element, 'immutable');
+}
+export function normalizeChunkInput(input, _index) {
+    const chunk = typeof input === 'string'
+        ? { content: input }
+        : input;
+    const element = {
+        type: 'chunk',
+        partOf: chunk.partOf ?? 'inputs',
+        content: chunk.content,
+        ...(chunk.index !== undefined ? { index: chunk.index } : {}),
+        ...(chunk.total !== undefined ? { total: chunk.total } : {}),
+        ...(chunk.usage !== undefined ? { usage: chunk.usage } : {}),
+    };
+    return withCacheHint(element, 'contextual');
+}
+export function normalizeMaterials(materials) {
+    if (materials === undefined) {
+        return undefined;
+    }
+    return toInputArray(materials).map((input, index) => normalizeMaterial(input, index));
+}
+export function normalizeMessages(messages) {
+    if (messages === undefined) {
+        return undefined;
+    }
+    return toInputArray(messages).map((input) => normalizeMessage(input));
+}
+export function normalizeInputs(inputs) {
+    if (inputs === undefined) {
+        return undefined;
+    }
+    return toInputArray(inputs).map((input, index) => normalizeChunkInput(input, index));
+}
+/** 補強情報の単一 chunk 入力ヘルパー。 */
+export function inputChunk(content, options) {
+    return {
+        content,
+        partOf: options?.partOf ?? 'inputs',
+        ...(options?.index !== undefined ? { index: options.index } : {}),
+        ...(options?.total !== undefined ? { total: options.total } : {}),
+        ...(options?.usage !== undefined ? { usage: options.usage } : {}),
+    };
+}
+/** JSON オブジェクトを chunk 入力に変換するヘルパー。 */
+export function inputChunksFromJson(data, partOf = 'inputs') {
+    return [inputChunk(JSON.stringify(data, null, 2), { partOf })];
+}
+//# sourceMappingURL=extract-elements.js.map

package/dist/extract-elements.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+export { createExtractSession } from './create-extract-session.js';
+export { createMlxExtractRuntime } from './create-mlx-extract-runtime.js';
+export { resolveSessionModules } from './resolve-session-modules.js';
+export { compileExtractPrompt } from './compile-extract-prompt.js';
+export { buildExtractContext } from './extract-context.js';
+export { inputChunk, inputChunksFromJson, normalizeChunkInput, normalizeInputs, normalizeMaterial, normalizeMaterials, normalizeMessage, normalizeMessages, } from './extract-elements.js';
+export { defaultExtractBaseModule, mergeExtractBaseModule } from './modules/index.js';
+export { buildPreviousExtractionsInputs, formatPreviousExtractions, } from './previous-extractions.js';
+export type { ExtractContext } from './extract-context.js';
+export type { ChunkInput, ChunkInputValue, InputsInput, MaterialInput, MaterialsInput, MessageInput, MessagesInput, StandardMessageInput, ToolResultMessageInput, } from './extract-elements.js';
+export type { ExtractCorpus, ExtractRequest, ExtractResult, ExtractSession, ExtractSessionCloseOptions, ExtractSessionOptions, } from './types.js';
+export type { MlxExtractRuntime, MlxExtractRuntimeOptions, } from './create-mlx-extract-runtime.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EACL,UAAU,EACV,mBAAmB,EACnB,mBAAmB,EACnB,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,wBAAwB,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AACtF,OAAO,EACL,8BAA8B,EAC9B,yBAAyB,GAC1B,MAAM,2BAA2B,CAAC;AACnC,YAAY,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,YAAY,EACV,UAAU,EACV,eAAe,EACf,WAAW,EACX,aAAa,EACb,cAAc,EACd,YAAY,EACZ,aAAa,EACb,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EACV,aAAa,EACb,cAAc,EACd,aAAa,EACb,cAAc,EACd,0BAA0B,EAC1B,qBAAqB,GACtB,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,iBAAiB,EACjB,wBAAwB,GACzB,MAAM,iCAAiC,CAAC"}