@kienmatu/inkos-core 0.1.0

package/dist/llm/service-presets.js.map

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

package/dist/llm/service-resolver.d.ts

@@ -0,0 +1,10 @@
+import type { Model, Api } from "@mariozechner/pi-ai";
+export interface ResolvedModel {
+    model: Model<Api>;
+    apiKey: string;
+    writingTemperature?: number;
+    temperatureRange?: readonly [number, number];
+    temperatureHint?: string;
+}
+export declare function resolveServiceModel(service: string, modelId: string, projectRoot: string, customBaseUrl?: string, customApiFormat?: "chat" | "responses"): Promise<ResolvedModel>;
+//# sourceMappingURL=service-resolver.d.ts.map

package/dist/llm/service-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-resolver.d.ts","sourceRoot":"","sources":["../../src/llm/service-resolver.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,qBAAqB,CAAC;AAOtD,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,gBAAgB,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7C,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAaD,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,aAAa,CAAC,EAAE,MAAM,EACtB,eAAe,CAAC,EAAE,MAAM,GAAG,WAAW,GACrC,OAAO,CAAC,aAAa,CAAC,CAyDxB"}

package/dist/llm/service-resolver.js

@@ -0,0 +1,62 @@
+import { getModel } from "@mariozechner/pi-ai";
+import { resolveServicePiProvider, resolveServicePreset } from "./service-presets.js";
+import { getServiceApiKey } from "./secrets.js";
+import { getEndpoint } from "./providers/index.js";
+import { isApiKeyOptionalForEndpoint } from "../utils/llm-endpoint-auth.js";
+function resolveProviderCompat(provider, baseUrl) {
+    const compat = {
+        ...(provider?.compat ?? {}),
+        ...(baseUrl.includes("generativelanguage.googleapis.com") ? { supportsStore: false } : {}),
+    };
+    return Object.keys(compat).length > 0 ? compat : undefined;
+}
+export async function resolveServiceModel(service, modelId, projectRoot, customBaseUrl, customApiFormat) {
+    // Determine pi-ai provider
+    const baseService = service.startsWith("custom:") ? "custom" : service;
+    const preset = resolveServicePreset(baseService);
+    const endpoint = getEndpoint(baseService);
+    const piProvider = baseService === "ollama" ? "ollama" : resolveServicePiProvider(baseService) ?? "openai";
+    const apiType = service.startsWith("custom:")
+        ? (customApiFormat === "responses" ? "openai-responses" : "openai-completions")
+        : (preset?.api ?? "openai-completions");
+    const configuredBaseUrl = customBaseUrl ?? preset?.baseUrl ?? "";
+    const endpointModel = baseService === "minimax"
+        ? endpoint?.models.find((model) => model.id === modelId || model.deploymentName === modelId)
+        : undefined;
+    // Get pi-ai Model — may return undefined for model IDs not in the built-in registry
+    const piModel = getModel(piProvider, modelId);
+    const effectiveBaseUrl = configuredBaseUrl || piModel?.baseUrl || "";
+    const compat = apiType === "openai-completions"
+        ? resolveProviderCompat(endpoint, effectiveBaseUrl)
+        : undefined;
+    if (!effectiveBaseUrl) {
+        throw new Error(`Cannot resolve model "${modelId}" for service "${service}": no baseUrl available.`);
+    }
+    // Resolve API key after baseUrl/provider are known so local/self-hosted endpoints
+    // such as Ollama can be used without forcing a fake secret.
+    const apiKey = await getServiceApiKey(projectRoot, service);
+    if (!apiKey && !isApiKeyOptionalForEndpoint({ provider: preset?.providerFamily, baseUrl: effectiveBaseUrl })) {
+        throw new Error(`API key not found for service "${service}". Add it in .inkos/secrets.json or set the environment variable.`);
+    }
+    const model = {
+        id: modelId,
+        name: piModel?.name ?? modelId,
+        api: apiType,
+        provider: piProvider,
+        baseUrl: effectiveBaseUrl,
+        reasoning: piModel?.reasoning ?? false,
+        input: piModel?.input ?? ["text"],
+        cost: piModel?.cost ?? { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
+        contextWindow: endpointModel?.contextWindowTokens ?? piModel?.contextWindow ?? 0,
+        maxTokens: endpointModel?.maxOutput ?? piModel?.maxTokens ?? 16384,
+        ...(compat ? { compat: compat } : {}),
+    };
+    return {
+        model,
+        apiKey: apiKey ?? "",
+        writingTemperature: preset?.writingTemperature,
+        temperatureRange: preset?.temperatureRange,
+        temperatureHint: preset?.temperatureHint,
+    };
+}
+//# sourceMappingURL=service-resolver.js.map

package/dist/llm/service-resolver.js.map

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

package/dist/llm/think-tag-stripper.d.ts

@@ -0,0 +1,15 @@
+export interface LeadingThinkTagStripper {
+    /** 送入一段增量文本，返回可以安全并入正文的部分（可能为空串，表示还在缓冲判断）。 */
+    readonly push: (chunk: string) => string;
+    /** 流结束时调用：把仍在缓冲的文本原样返回（未闭合的 think 块不剥离）。 */
+    readonly flush: () => string;
+}
+/**
+ * 流式剥离器：只处理响应起始处的完整 <think>...</think> 块。
+ * 在能确定"开头不是 think 块"之前先缓冲，不向外发出任何文本，
+ * 保证思考内容不会先展示再消失以外——根本不会被发出。
+ */
+export declare function createLeadingThinkTagStripper(): LeadingThinkTagStripper;
+/** 非流式版本：剥离字符串起始处的完整 <think>...</think> 块（语义与流式剥离器一致）。 */
+export declare function stripLeadingThinkBlock(text: string): string;
+//# sourceMappingURL=think-tag-stripper.d.ts.map

package/dist/llm/think-tag-stripper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"think-tag-stripper.d.ts","sourceRoot":"","sources":["../../src/llm/think-tag-stripper.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,uBAAuB;IACtC,8CAA8C;IAC9C,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IACzC,4CAA4C;IAC5C,QAAQ,CAAC,KAAK,EAAE,MAAM,MAAM,CAAC;CAC9B;AAED;;;;GAIG;AACH,wBAAgB,6BAA6B,IAAI,uBAAuB,CA4CvE;AAED,0DAA0D;AAC1D,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAG3D"}

package/dist/llm/think-tag-stripper.js

@@ -0,0 +1,60 @@
+// 部分 OpenAI 兼容服务（如 MiniMax M2.x、经网关代理的 DeepSeek-R1 类模型）会把
+// 思考内容以 <think>...</think> 标签内联在 content 字段的开头返回（issue #329）。
+// 这里只剥离"响应起始处的完整 think 块"：正文中间出现的 "<think>" 字样不动，
+// 起始处未闭合的 think 块也原样保留（说明正文根本没生成，剥掉会造成数据丢失）。
+const OPEN_TAG = "<think>";
+const CLOSE_TAG = "</think>";
+/**
+ * 流式剥离器：只处理响应起始处的完整 <think>...</think> 块。
+ * 在能确定"开头不是 think 块"之前先缓冲，不向外发出任何文本，
+ * 保证思考内容不会先展示再消失以外——根本不会被发出。
+ */
+export function createLeadingThinkTagStripper() {
+    let state = "detecting";
+    let pending = "";
+    const push = (chunk) => {
+        if (state === "passthrough")
+            return chunk;
+        pending += chunk;
+        if (state === "detecting") {
+            const leadingWhitespace = /^\s*/.exec(pending)[0];
+            const rest = pending.slice(leadingWhitespace.length);
+            if (rest.length < OPEN_TAG.length) {
+                if (OPEN_TAG.startsWith(rest))
+                    return ""; // 还无法判断，继续缓冲
+                state = "passthrough";
+                const out = pending;
+                pending = "";
+                return out;
+            }
+            if (!rest.startsWith(OPEN_TAG)) {
+                state = "passthrough";
+                const out = pending;
+                pending = "";
+                return out;
+            }
+            state = "insideThink";
+        }
+        // state === "insideThink"：等待闭合标签
+        const closeIndex = pending.indexOf(CLOSE_TAG);
+        if (closeIndex < 0)
+            return "";
+        state = "passthrough";
+        const afterClose = pending.slice(closeIndex + CLOSE_TAG.length).replace(/^\s+/, "");
+        pending = "";
+        return afterClose;
+    };
+    const flush = () => {
+        const out = pending;
+        pending = "";
+        state = "passthrough";
+        return out;
+    };
+    return { push, flush };
+}
+/** 非流式版本：剥离字符串起始处的完整 <think>...</think> 块（语义与流式剥离器一致）。 */
+export function stripLeadingThinkBlock(text) {
+    const stripper = createLeadingThinkTagStripper();
+    return stripper.push(text) + stripper.flush();
+}
+//# sourceMappingURL=think-tag-stripper.js.map

package/dist/llm/think-tag-stripper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"think-tag-stripper.js","sourceRoot":"","sources":["../../src/llm/think-tag-stripper.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAC1D,8DAA8D;AAC9D,kDAAkD;AAClD,6CAA6C;AAE7C,MAAM,QAAQ,GAAG,SAAS,CAAC;AAC3B,MAAM,SAAS,GAAG,UAAU,CAAC;AAW7B;;;;GAIG;AACH,MAAM,UAAU,6BAA6B;IAC3C,IAAI,KAAK,GAAkB,WAAW,CAAC;IACvC,IAAI,OAAO,GAAG,EAAE,CAAC;IAEjB,MAAM,IAAI,GAAG,CAAC,KAAa,EAAU,EAAE;QACrC,IAAI,KAAK,KAAK,aAAa;YAAE,OAAO,KAAK,CAAC;QAC1C,OAAO,IAAI,KAAK,CAAC;QAEjB,IAAI,KAAK,KAAK,WAAW,EAAE,CAAC;YAC1B,MAAM,iBAAiB,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAE,CAAC,CAAC,CAAC,CAAC;YACnD,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC;YACrD,IAAI,IAAI,CAAC,MAAM,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC;gBAClC,IAAI,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC;oBAAE,OAAO,EAAE,CAAC,CAAC,aAAa;gBACvD,KAAK,GAAG,aAAa,CAAC;gBACtB,MAAM,GAAG,GAAG,OAAO,CAAC;gBACpB,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO,GAAG,CAAC;YACb,CAAC;YACD,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC/B,KAAK,GAAG,aAAa,CAAC;gBACtB,MAAM,GAAG,GAAG,OAAO,CAAC;gBACpB,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO,GAAG,CAAC;YACb,CAAC;YACD,KAAK,GAAG,aAAa,CAAC;QACxB,CAAC;QAED,iCAAiC;QACjC,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAC9C,IAAI,UAAU,GAAG,CAAC;YAAE,OAAO,EAAE,CAAC;QAC9B,KAAK,GAAG,aAAa,CAAC;QACtB,MAAM,UAAU,GAAG,OAAO,CAAC,KAAK,CAAC,UAAU,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QACpF,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,UAAU,CAAC;IACpB,CAAC,CAAC;IAEF,MAAM,KAAK,GAAG,GAAW,EAAE;QACzB,MAAM,GAAG,GAAG,OAAO,CAAC;QACpB,OAAO,GAAG,EAAE,CAAC;QACb,KAAK,GAAG,aAAa,CAAC;QACtB,OAAO,GAAG,CAAC;IACb,CAAC,CAAC;IAEF,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;AACzB,CAAC;AAED,0DAA0D;AAC1D,MAAM,UAAU,sBAAsB,CAAC,IAAY;IACjD,MAAM,QAAQ,GAAG,6BAA6B,EAAE,CAAC;IACjD,OAAO,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,KAAK,EAAE,CAAC;AAChD,CAAC"}

package/dist/materials/ingest.d.ts

@@ -0,0 +1,31 @@
+export type MaterialPurpose = "reference" | "worldbuilding" | "script" | "storyboard" | "research" | "general";
+export type MaterialSourceKind = "url" | "file";
+export type MaterialKind = "webpage" | "pdf" | "text";
+export interface IngestMaterialInput {
+    readonly sourceKind: MaterialSourceKind;
+    readonly url?: string;
+    readonly filePath?: string;
+    readonly filename?: string;
+    readonly mimeType?: string;
+    readonly title?: string;
+    readonly purpose?: MaterialPurpose;
+}
+export interface MaterialAsset {
+    readonly id: string;
+    readonly title: string;
+    readonly kind: MaterialKind;
+    readonly purpose: MaterialPurpose;
+    readonly source: string;
+    readonly mimeType: string;
+    readonly markdownPath: string;
+    readonly manifestPath: string;
+    readonly charCount: number;
+    readonly excerpt: string;
+    readonly totalPages?: number;
+}
+export interface IngestMaterialDeps {
+    readonly fetch?: typeof fetch;
+    readonly now?: () => Date;
+}
+export declare function ingestMaterial(projectRoot: string, input: IngestMaterialInput, deps?: IngestMaterialDeps): Promise<MaterialAsset>;
+//# sourceMappingURL=ingest.d.ts.map

package/dist/materials/ingest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ingest.d.ts","sourceRoot":"","sources":["../../src/materials/ingest.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,eAAe,GAAG,WAAW,GAAG,eAAe,GAAG,QAAQ,GAAG,YAAY,GAAG,UAAU,GAAG,SAAS,CAAC;AAC/G,MAAM,MAAM,kBAAkB,GAAG,KAAK,GAAG,MAAM,CAAC;AAChD,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,KAAK,GAAG,MAAM,CAAC;AAEtD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAC;IACxC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,CAAC,EAAE,eAAe,CAAC;CACpC;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IAC9B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;CAC3B;AAKD,wBAAsB,cAAc,CAClC,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,mBAAmB,EAC1B,IAAI,GAAE,kBAAuB,GAC5B,OAAO,CAAC,aAAa,CAAC,CAoCxB"}

package/dist/materials/ingest.js

@@ -0,0 +1,224 @@
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { basename, extname, join, relative } from "node:path";
+import { extractText, getDocumentProxy } from "unpdf";
+import { safeChildPath } from "../utils/path-safety.js";
+import { toPosixPath } from "../utils/posix-path.js";
+const MAX_SOURCE_BYTES = 18 * 1024 * 1024;
+const EXCERPT_CHARS = 1600;
+export async function ingestMaterial(projectRoot, input, deps = {}) {
+    const now = deps.now?.() ?? new Date();
+    const purpose = input.purpose ?? "reference";
+    const source = await readMaterialSource(projectRoot, input, deps);
+    const title = (input.title?.trim() || source.title || titleFromSource(input) || "material").slice(0, 120);
+    const id = `${now.toISOString().replace(/[:.]/g, "-")}-${slug(title)}`;
+    const materialsDir = join(projectRoot, ".inkos", "materials");
+    await mkdir(materialsDir, { recursive: true });
+    const markdown = renderMaterialMarkdown({
+        title,
+        kind: source.kind,
+        purpose,
+        source: source.source,
+        mimeType: source.mimeType,
+        totalPages: source.totalPages,
+        text: source.text,
+    });
+    const markdownPathAbs = join(materialsDir, `${id}.md`);
+    const manifestPathAbs = join(materialsDir, `${id}.json`);
+    await writeFile(markdownPathAbs, markdown, "utf-8");
+    const asset = {
+        id,
+        title,
+        kind: source.kind,
+        purpose,
+        source: source.source,
+        mimeType: source.mimeType,
+        markdownPath: toPosixPath(relative(projectRoot, markdownPathAbs)),
+        manifestPath: toPosixPath(relative(projectRoot, manifestPathAbs)),
+        charCount: source.text.length,
+        excerpt: source.text.slice(0, EXCERPT_CHARS),
+        ...(source.totalPages !== undefined ? { totalPages: source.totalPages } : {}),
+    };
+    await writeFile(manifestPathAbs, JSON.stringify(asset, null, 2), "utf-8");
+    return asset;
+}
+async function readMaterialSource(projectRoot, input, deps) {
+    if (input.sourceKind === "url") {
+        if (!input.url)
+            throw new Error("ingest_material.url is required for URL sources.");
+        return readUrlMaterial(input.url, deps.fetch ?? fetch);
+    }
+    if (!input.filePath)
+        throw new Error("ingest_material.filePath is required for file sources.");
+    const safePath = safeChildPath(projectRoot, input.filePath);
+    const buffer = await readFile(safePath);
+    if (buffer.byteLength > MAX_SOURCE_BYTES) {
+        throw new Error(`Material file is too large (${buffer.byteLength} bytes).`);
+    }
+    const filename = input.filename || basename(safePath);
+    const mimeType = input.mimeType || mimeFromFilename(filename);
+    return extractBufferMaterial(buffer, {
+        source: toPosixPath(relative(projectRoot, safePath)),
+        filename,
+        mimeType,
+    });
+}
+async function readUrlMaterial(url, fetchImpl) {
+    const parsed = new URL(url);
+    if (!["http:", "https:"].includes(parsed.protocol)) {
+        throw new Error(`Unsupported URL protocol: ${parsed.protocol}`);
+    }
+    const response = await fetchImpl(url, {
+        headers: {
+            "User-Agent": "InkOS/1.6 material-ingestion",
+            "Accept": "text/html, text/plain, application/json, application/pdf, */*",
+        },
+        signal: AbortSignal.timeout(20_000),
+    });
+    if (!response.ok) {
+        throw new Error(`Fetch failed: ${response.status} ${response.statusText}`);
+    }
+    const mimeType = response.headers.get("content-type")?.split(";")[0]?.trim() || mimeFromFilename(parsed.pathname);
+    const arrayBuffer = await response.arrayBuffer();
+    const buffer = Buffer.from(arrayBuffer);
+    if (buffer.byteLength > MAX_SOURCE_BYTES) {
+        throw new Error(`Fetched material is too large (${buffer.byteLength} bytes).`);
+    }
+    return extractBufferMaterial(buffer, {
+        source: url,
+        filename: basename(parsed.pathname) || parsed.hostname,
+        mimeType,
+    });
+}
+async function extractBufferMaterial(buffer, meta) {
+    const mimeType = meta.mimeType || mimeFromFilename(meta.filename);
+    if (isPdf(meta.filename, mimeType)) {
+        const pdf = await getDocumentProxy(new Uint8Array(buffer));
+        const extracted = await extractText(pdf, { mergePages: true });
+        const text = normalizeText(extracted.text);
+        if (!text)
+            throw new Error("PDF text extraction returned no text. Scanned PDFs require OCR and are not supported yet.");
+        return {
+            kind: "pdf",
+            source: meta.source,
+            title: stripExtension(meta.filename),
+            mimeType: "application/pdf",
+            text,
+            totalPages: extracted.totalPages,
+        };
+    }
+    const raw = buffer.toString("utf-8");
+    if (isHtml(meta.filename, mimeType)) {
+        return {
+            kind: "webpage",
+            source: meta.source,
+            title: extractHtmlTitle(raw) || stripExtension(meta.filename),
+            mimeType,
+            text: normalizeText(htmlToText(raw)),
+        };
+    }
+    if (isTextLike(meta.filename, mimeType)) {
+        return {
+            kind: "text",
+            source: meta.source,
+            title: stripExtension(meta.filename),
+            mimeType,
+            text: normalizeText(raw),
+        };
+    }
+    throw new Error(`Unsupported material type: ${mimeType || meta.filename}`);
+}
+function renderMaterialMarkdown(input) {
+    return [
+        `# ${input.title}`,
+        "",
+        "## Metadata",
+        `- kind: ${input.kind}`,
+        `- purpose: ${input.purpose}`,
+        `- source: ${input.source}`,
+        `- mime_type: ${input.mimeType}`,
+        input.totalPages !== undefined ? `- total_pages: ${input.totalPages}` : "",
+        `- char_count: ${input.text.length}`,
+        "",
+        "## Extracted content",
+        input.text,
+        "",
+    ].filter((line) => line !== "").join("\n");
+}
+function mimeFromFilename(filename) {
+    const ext = extname(filename).toLowerCase();
+    if (ext === ".pdf")
+        return "application/pdf";
+    if (ext === ".html" || ext === ".htm")
+        return "text/html";
+    if (ext === ".json")
+        return "application/json";
+    if (ext === ".md" || ext === ".markdown")
+        return "text/markdown";
+    if (ext === ".csv")
+        return "text/csv";
+    return "text/plain";
+}
+function isPdf(filename, mimeType) {
+    return mimeType.includes("pdf") || extname(filename).toLowerCase() === ".pdf";
+}
+function isHtml(filename, mimeType) {
+    const ext = extname(filename).toLowerCase();
+    return mimeType.includes("html") || ext === ".html" || ext === ".htm";
+}
+function isTextLike(filename, mimeType) {
+    if (mimeType.startsWith("text/"))
+        return true;
+    if (mimeType.includes("json") || mimeType.includes("xml") || mimeType.includes("yaml"))
+        return true;
+    return [".txt", ".md", ".markdown", ".json", ".csv", ".tsv", ".yaml", ".yml", ".log"].includes(extname(filename).toLowerCase());
+}
+function htmlToText(html) {
+    return html
+        .replace(/<script[\s\S]*?<\/script>/gi, " ")
+        .replace(/<style[\s\S]*?<\/style>/gi, " ")
+        .replace(/<[^>]+>/g, " ");
+}
+function extractHtmlTitle(html) {
+    const match = /<title[^>]*>([\s\S]*?)<\/title>/i.exec(html);
+    return match ? decodeHtml(match[1]).trim().slice(0, 120) : undefined;
+}
+function decodeHtml(value) {
+    return value
+        .replace(/&nbsp;/gi, " ")
+        .replace(/&amp;/gi, "&")
+        .replace(/&lt;/gi, "<")
+        .replace(/&gt;/gi, ">")
+        .replace(/&quot;/gi, "\"")
+        .replace(/&#39;/gi, "'");
+}
+function normalizeText(value) {
+    return decodeHtml(value).replace(/\r\n/g, "\n").replace(/[ \t]+\n/g, "\n").replace(/\n{3,}/g, "\n\n").trim();
+}
+function stripExtension(filename) {
+    const ext = extname(filename);
+    return ext ? filename.slice(0, -ext.length) : filename;
+}
+function titleFromSource(input) {
+    if (input.filename)
+        return stripExtension(input.filename);
+    if (input.filePath)
+        return stripExtension(basename(input.filePath));
+    if (!input.url)
+        return undefined;
+    try {
+        const parsed = new URL(input.url);
+        return stripExtension(basename(parsed.pathname)) || parsed.hostname;
+    }
+    catch {
+        return undefined;
+    }
+}
+function slug(value) {
+    return value
+        .trim()
+        .toLowerCase()
+        .replace(/[^\p{L}\p{N}]+/gu, "-")
+        .replace(/^-+|-+$/g, "")
+        .slice(0, 80) || "material";
+}
+//# sourceMappingURL=ingest.js.map

package/dist/materials/ingest.js.map

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

package/dist/materials/retrieve.d.ts

@@ -0,0 +1,20 @@
+import type { MaterialAsset, MaterialPurpose } from "./ingest.js";
+export interface RetrieveMaterialsInput {
+    readonly query: string;
+    readonly purpose?: MaterialPurpose;
+    readonly limit?: number;
+}
+export interface RetrievedMaterial {
+    readonly id: string;
+    readonly title: string;
+    readonly kind: MaterialAsset["kind"];
+    readonly purpose: MaterialPurpose;
+    readonly source: string;
+    readonly markdownPath: string;
+    readonly score: number;
+    readonly excerpt: string;
+    readonly charStart: number;
+    readonly charEnd: number;
+}
+export declare function retrieveMaterials(projectRoot: string, input: RetrieveMaterialsInput): Promise<RetrievedMaterial[]>;
+//# sourceMappingURL=retrieve.d.ts.map

package/dist/materials/retrieve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retrieve.d.ts","sourceRoot":"","sources":["../../src/materials/retrieve.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAOlE,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,CAAC,EAAE,eAAe,CAAC;IACnC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACrC,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAMD,wBAAsB,iBAAiB,CACrC,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,sBAAsB,GAC5B,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAoD9B"}

package/dist/materials/retrieve.js

@@ -0,0 +1,109 @@
+import { readdir, readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { safeChildPath } from "../utils/path-safety.js";
+import { toPosixPath } from "../utils/posix-path.js";
+import { LocalSearchIndex, splitMarkdownForSearch, } from "../retrieval/local-search.js";
+const DEFAULT_LIMIT = 5;
+const MAX_LIMIT = 12;
+const MATERIAL_SCOPE = "archived-materials";
+export async function retrieveMaterials(projectRoot, input) {
+    const assets = await listMaterialAssets(projectRoot);
+    const documents = [];
+    for (const asset of assets) {
+        const markdownPath = safeChildPath(projectRoot, asset.markdownPath);
+        let markdown = "";
+        try {
+            markdown = await readFile(markdownPath, "utf-8");
+        }
+        catch {
+            continue;
+        }
+        const normalizedPath = toPosixPath(asset.markdownPath);
+        splitMarkdownForSearch(markdown).forEach((segment, index) => {
+            documents.push({
+                id: `material:${asset.id}:${index}`,
+                scope: MATERIAL_SCOPE,
+                kind: `material:${asset.purpose}`,
+                source: `${normalizedPath}:${segment.charStart}-${segment.charEnd}`,
+                title: [asset.title, segment.heading].filter(Boolean).join(" · "),
+                body: segment.body,
+                metadata: {
+                    assetId: asset.id,
+                    assetTitle: asset.title,
+                    assetKind: asset.kind,
+                    purpose: asset.purpose,
+                    source: asset.source,
+                    markdownPath: normalizedPath,
+                    charStart: segment.charStart,
+                    charEnd: segment.charEnd,
+                },
+            });
+        });
+    }
+    const searchIndex = new LocalSearchIndex(join(projectRoot, ".inkos", "retrieval.db"));
+    try {
+        searchIndex.replaceScope(MATERIAL_SCOPE, documents);
+        const limit = normalizeLimit(input.limit);
+        const ranked = searchIndex.search(input.query, {
+            scope: MATERIAL_SCOPE,
+            kinds: input.purpose ? [`material:${input.purpose}`] : undefined,
+            limit: Math.min(MAX_LIMIT * 4, limit * 4),
+        }).map((hit) => materialFromHit(hit.metadata, hit.score, hit.body));
+        const seen = new Set();
+        return ranked.filter((result) => {
+            if (seen.has(result.id))
+                return false;
+            seen.add(result.id);
+            return true;
+        }).slice(0, limit);
+    }
+    finally {
+        searchIndex.close();
+    }
+}
+async function listMaterialAssets(projectRoot) {
+    const materialsDir = join(projectRoot, ".inkos", "materials");
+    let entries = [];
+    try {
+        entries = await readdir(materialsDir);
+    }
+    catch {
+        return [];
+    }
+    const assets = [];
+    for (const entry of entries) {
+        if (!entry.endsWith(".json"))
+            continue;
+        try {
+            const raw = await readFile(join(materialsDir, entry), "utf-8");
+            const asset = JSON.parse(raw);
+            if (asset.id && asset.markdownPath && asset.title)
+                assets.push(asset);
+        }
+        catch {
+            // Ignore corrupt stale manifests; retrieval should not break the chat turn.
+        }
+    }
+    return assets;
+}
+function normalizeLimit(limit) {
+    if (!Number.isFinite(limit ?? DEFAULT_LIMIT))
+        return DEFAULT_LIMIT;
+    return Math.max(1, Math.min(MAX_LIMIT, Math.floor(limit ?? DEFAULT_LIMIT)));
+}
+function materialFromHit(metadata, score, excerpt) {
+    const value = metadata ?? {};
+    return {
+        id: String(value.assetId ?? ""),
+        title: String(value.assetTitle ?? ""),
+        kind: String(value.assetKind ?? "text"),
+        purpose: String(value.purpose ?? "general"),
+        source: String(value.source ?? ""),
+        markdownPath: String(value.markdownPath ?? ""),
+        score,
+        excerpt,
+        charStart: Number(value.charStart ?? 0),
+        charEnd: Number(value.charEnd ?? excerpt.length),
+    };
+}
+//# sourceMappingURL=retrieve.js.map

package/dist/materials/retrieve.js.map

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