dsh-convert-core 0.1.0-alpha.1

package/lib/contract.d.ts

@@ -0,0 +1,185 @@
+/**
+ * Wire-level contract for the conversion kernel.
+ *
+ * The kernel owns exactly one promise: given an input, produce a
+ * *knowledge-ready* Markdown bundle (`index.md` + `assets/` + `manifest.json`)
+ * plus an `ingest` payload that plugins/dsh-data-domain-knowledge can consume
+ * without the two ever importing each other.
+ *
+ * Boundary rule (issue 0013): the kernel never decides `source_type`. It only
+ * proposes candidates; the ingestion side decides and records
+ * `source_type_source`.
+ */
+/**
+ * `source_format` values from the 0013 contract. The full vocabulary is kept so
+ * the front matter stays wire-compatible, but this version only ever emits
+ * `markdown`, `text`, `pdf` and `office`.
+ */
+export declare const SOURCE_FORMATS: readonly ["markdown", "text", "html", "pdf", "office", "web_page", "video", "audio", "image"];
+export type SourceFormat = (typeof SOURCE_FORMATS)[number];
+/**
+ * This version is documents-only (issue 0015 scope cut): web pages and video
+ * moved to issues/0017, so only `file` and `text` can be requested.
+ */
+export declare const CONVERT_INPUT_KINDS: readonly ["file", "text"];
+export type ConvertInputKind = (typeof CONVERT_INPUT_KINDS)[number];
+export declare const TASK_STATES: readonly ["queued", "running", "succeeded", "failed", "cancelled"];
+export type TaskState = (typeof TASK_STATES)[number];
+/** Lineage mirrors the knowledge plugin so both ends speak one vocabulary. */
+export interface Lineage {
+    sessionId?: string;
+    turnId?: string;
+    intentId?: string;
+    taskId?: string;
+    subtaskId?: string;
+    parentSubtaskId?: string;
+    runId?: string;
+    traceId?: string;
+    domain?: string;
+}
+export type SourceTypeSource = 'agent' | 'user' | 'default';
+/**
+ * Front matter written into `index.md`.
+ *
+ * Required by the knowledge-ready contract: `title`, `created_at`,
+ * `updated_at`. `source_id` and `source_type` are optional here because the
+ * kernel must not invent them — ingestion fills them in and re-writes the file.
+ */
+export interface ConversionFrontMatter {
+    source_id?: string;
+    source_type?: string;
+    title: string;
+    created_at: string;
+    updated_at: string;
+    external_id?: string;
+    source_format?: SourceFormat;
+    content_hash?: string;
+    parser?: string;
+    source_url?: string;
+    source_path?: string;
+    source_type_source?: SourceTypeSource;
+    source_type_candidates?: string[];
+    word_count?: number;
+    asset_count?: number;
+    lineage?: Lineage;
+}
+export interface ConvertAsset {
+    /** Path relative to the delivery directory, e.g. `assets/img-1a2b3c4d.png`. */
+    rel: string;
+    /** Absolute path on disk inside the delivery directory. */
+    path: string;
+    bytes: number;
+    contentType?: string;
+    sha1: string;
+    /** Original remote URL when the asset was downloaded. */
+    sourceUrl?: string;
+    /** `inline` when it came from a data: URI, `remote` when downloaded, `local` when copied. */
+    origin: 'remote' | 'inline' | 'local';
+}
+export interface ConvertWarning {
+    code: string;
+    message: string;
+}
+/** Everything an ingestion side needs to file this bundle, without guessing. */
+export interface IngestPayload {
+    /** Markdown body with a leading front matter block, ready for `add_source`. */
+    markdown: string;
+    /** Same body without front matter. */
+    content: string;
+    title: string;
+    externalId: string;
+    contentHash: string;
+    sourceFormat: SourceFormat;
+    parser: string;
+    sourceUrl?: string;
+    sourcePath?: string;
+    sourceTypeCandidates: string[];
+    /** True when nobody supplied a `source_type` yet. */
+    sourceTypeRequired: boolean;
+    assets: ConvertAsset[];
+    /**
+     * Image references are relative to the delivery `index.md`. A wiki card lives
+     * in `02_wiki/<type>/`, so ingestion must re-base them before a card can feed
+     * the multimodal embedder.
+     */
+    assetRefBase: 'delivery';
+}
+export interface ConvertManifest {
+    version: 1;
+    taskId: string;
+    inputKind: ConvertInputKind;
+    sourceFormat: SourceFormat;
+    parser: string;
+    title: string;
+    createdAt: string;
+    updatedAt: string;
+    deliveryDir: string;
+    contentHash: string;
+    externalId: string;
+    wordCount: number;
+    assets: ConvertAsset[];
+    warnings: ConvertWarning[];
+    /** Version of the external binary / service that did the work, when any. */
+    dependencyVersions: Record<string, string>;
+    lineage?: Lineage;
+    ingest: IngestPayload;
+}
+export interface ConvertTask {
+    id: string;
+    state: TaskState;
+    inputKind: ConvertInputKind;
+    /** Human label shown in the console. */
+    label: string;
+    sourceFormat: SourceFormat;
+    createdAt: string;
+    updatedAt: string;
+    startedAt?: string;
+    finishedAt?: string;
+    /** 0..1, or null when the adapter cannot report a ratio. */
+    progress: number | null;
+    stage: string;
+    message?: string;
+    error?: {
+        code: string;
+        message: string;
+        suggestion?: string;
+    };
+    warnings: ConvertWarning[];
+    deliveryDir?: string;
+    manifest?: ConvertManifest;
+    attempts: number;
+    /** Absolute input path inside the kernel work dir, when the input was a file. */
+    inputPath?: string;
+    request: ConvertRequest;
+}
+export interface ConvertRequest {
+    kind: ConvertInputKind;
+    /** Absolute path on the host for kind=file|video; the kernel reads and stages it. */
+    localPath?: string;
+    /** File name inside the kernel work dir (kind=file|video). */
+    filename?: string;
+    /** Inline text (kind=text). */
+    text?: string;
+    title?: string;
+    /** Caller-supplied business classification; the kernel never invents one. */
+    sourceType?: string;
+    sourceTypeCandidates?: string[];
+    sourceTypeSource?: SourceTypeSource;
+    /** Stable identity for idempotency, e.g. a canonical URL or a file hash. */
+    externalId?: string;
+    lineage?: Lineage;
+    /** Adapter override, mostly for tests and for the high-quality tier. */
+    adapter?: string;
+}
+export interface ConvertError {
+    code: string;
+    message: string;
+    suggestion?: string;
+}
+export interface ConvertResult {
+    task: ConvertTask;
+}
+export declare function isSourceFormat(value: unknown): value is SourceFormat;
+/** Default business-classification hints per carrier format. */
+export declare function defaultSourceTypeCandidates(format: SourceFormat): string[];
+//# sourceMappingURL=contract.d.ts.map

package/lib/contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH;;;;GAIG;AACH,eAAO,MAAM,cAAc,+FAUjB,CAAA;AAEV,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAA;AAE1D;;;GAGG;AACH,eAAO,MAAM,mBAAmB,2BAA4B,CAAA;AAE5D,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAA;AAEnE,eAAO,MAAM,WAAW,oEAAqE,CAAA;AAE7F,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAA;AAEpD,8EAA8E;AAC9E,MAAM,WAAW,OAAO;IACtB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,CAAA;AAE3D;;;;;;GAMG;AACH,MAAM,WAAW,qBAAqB;IACpC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,KAAK,EAAE,MAAM,CAAA;IACb,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;IAClB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,aAAa,CAAC,EAAE,YAAY,CAAA;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,kBAAkB,CAAC,EAAE,gBAAgB,CAAA;IACrC,sBAAsB,CAAC,EAAE,MAAM,EAAE,CAAA;IACjC,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,+EAA+E;IAC/E,GAAG,EAAE,MAAM,CAAA;IACX,2DAA2D;IAC3D,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,IAAI,EAAE,MAAM,CAAA;IACZ,yDAAyD;IACzD,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,6FAA6F;IAC7F,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAA;CACtC;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,gFAAgF;AAChF,MAAM,WAAW,aAAa;IAC5B,+EAA+E;IAC/E,QAAQ,EAAE,MAAM,CAAA;IAChB,sCAAsC;IACtC,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;IACb,UAAU,EAAE,MAAM,CAAA;IAClB,WAAW,EAAE,MAAM,CAAA;IACnB,YAAY,EAAE,YAAY,CAAA;IAC1B,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,oBAAoB,EAAE,MAAM,EAAE,CAAA;IAC9B,qDAAqD;IACrD,kBAAkB,EAAE,OAAO,CAAA;IAC3B,MAAM,EAAE,YAAY,EAAE,CAAA;IACtB;;;;OAIG;IACH,YAAY,EAAE,UAAU,CAAA;CACzB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,CAAC,CAAA;IACV,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,gBAAgB,CAAA;IAC3B,YAAY,EAAE,YAAY,CAAA;IAC1B,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,EAAE,MAAM,CAAA;IACnB,WAAW,EAAE,MAAM,CAAA;IACnB,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,YAAY,EAAE,CAAA;IACtB,QAAQ,EAAE,cAAc,EAAE,CAAA;IAC1B,4EAA4E;IAC5E,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC1C,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,MAAM,EAAE,aAAa,CAAA;CACtB;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,SAAS,CAAA;IAChB,SAAS,EAAE,gBAAgB,CAAA;IAC3B,wCAAwC;IACxC,KAAK,EAAE,MAAM,CAAA;IACb,YAAY,EAAE,YAAY,CAAA;IAC1B,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,4DAA4D;IAC5D,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IAC9D,QAAQ,EAAE,cAAc,EAAE,CAAA;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,EAAE,eAAe,CAAA;IAC1B,QAAQ,EAAE,MAAM,CAAA;IAChB,iFAAiF;IACjF,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,cAAc,CAAA;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,gBAAgB,CAAA;IACtB,qFAAqF;IACrF,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,+BAA+B;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,6EAA6E;IAC7E,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAA;IAC/B,gBAAgB,CAAC,EAAE,gBAAgB,CAAA;IACnC,4EAA4E;IAC5E,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,wEAAwE;IACxE,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,WAAW,CAAA;CAClB;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY,CAEpE;AAED,gEAAgE;AAChE,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,EAAE,CAmB1E"}

package/lib/contract.js

@@ -0,0 +1,59 @@
+/**
+ * Wire-level contract for the conversion kernel.
+ *
+ * The kernel owns exactly one promise: given an input, produce a
+ * *knowledge-ready* Markdown bundle (`index.md` + `assets/` + `manifest.json`)
+ * plus an `ingest` payload that plugins/dsh-data-domain-knowledge can consume
+ * without the two ever importing each other.
+ *
+ * Boundary rule (issue 0013): the kernel never decides `source_type`. It only
+ * proposes candidates; the ingestion side decides and records
+ * `source_type_source`.
+ */
+/**
+ * `source_format` values from the 0013 contract. The full vocabulary is kept so
+ * the front matter stays wire-compatible, but this version only ever emits
+ * `markdown`, `text`, `pdf` and `office`.
+ */
+export const SOURCE_FORMATS = [
+    'markdown',
+    'text',
+    'html',
+    'pdf',
+    'office',
+    'web_page',
+    'video',
+    'audio',
+    'image',
+];
+/**
+ * This version is documents-only (issue 0015 scope cut): web pages and video
+ * moved to issues/0017, so only `file` and `text` can be requested.
+ */
+export const CONVERT_INPUT_KINDS = ['file', 'text'];
+export const TASK_STATES = ['queued', 'running', 'succeeded', 'failed', 'cancelled'];
+export function isSourceFormat(value) {
+    return typeof value === 'string' && SOURCE_FORMATS.includes(value);
+}
+/** Default business-classification hints per carrier format. */
+export function defaultSourceTypeCandidates(format) {
+    switch (format) {
+        case 'pdf':
+            return ['article', 'book', 'prd', 'document'];
+        case 'office':
+            return ['prd', 'document'];
+        case 'markdown':
+        case 'text':
+            return ['document', 'article'];
+        // iddoc 档(issue 0017):音视频与图片的业务归类与文档不同,别让它们默认落到 "document"。
+        case 'video':
+            return ['video', 'course', 'interview', 'document'];
+        case 'audio':
+            return ['audio', 'interview', 'meeting', 'document'];
+        case 'image':
+            return ['image', 'screenshot', 'diagram', 'document'];
+        default:
+            return ['document'];
+    }
+}
+//# sourceMappingURL=contract.js.map

package/lib/contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.js","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,UAAU;IACV,MAAM;IACN,MAAM;IACN,KAAK;IACL,QAAQ;IACR,UAAU;IACV,OAAO;IACP,OAAO;IACP,OAAO;CACC,CAAA;AAIV;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,MAAM,EAAE,MAAM,CAAU,CAAA;AAI5D,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE,WAAW,CAAU,CAAA;AAqK7F,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAK,cAAoC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;AAC3F,CAAC;AAED,gEAAgE;AAChE,MAAM,UAAU,2BAA2B,CAAC,MAAoB;IAC9D,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,KAAK;YACR,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,CAAC,CAAA;QAC/C,KAAK,QAAQ;YACX,OAAO,CAAC,KAAK,EAAE,UAAU,CAAC,CAAA;QAC5B,KAAK,UAAU,CAAC;QAChB,KAAK,MAAM;YACT,OAAO,CAAC,UAAU,EAAE,SAAS,CAAC,CAAA;QAChC,4DAA4D;QAC5D,KAAK,OAAO;YACV,OAAO,CAAC,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,UAAU,CAAC,CAAA;QACrD,KAAK,OAAO;YACV,OAAO,CAAC,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,UAAU,CAAC,CAAA;QACtD,KAAK,OAAO;YACV,OAAO,CAAC,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,UAAU,CAAC,CAAA;QACvD;YACE,OAAO,CAAC,UAAU,CAAC,CAAA;IACvB,CAAC;AACH,CAAC"}

package/lib/delivery.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Delivery bundle writer.
+ *
+ * Layout is fixed by the 0013 knowledge-ready contract:
+ *
+ *   convert-out/<taskId>/
+ *     index.md          front matter + body, images referenced as assets/…
+ *     assets/img-*.ext  content-addressed local images
+ *     manifest.json     provenance, parser/version, warnings, ingest payload
+ *
+ * The kernel never writes into the knowledge store; it only produces this
+ * directory plus the `ingest` payload that the DSH layer forwards.
+ */
+import type { ConvertAsset, ConvertManifest, ConvertRequest, ConvertWarning, IngestPayload, SourceFormat, SourceTypeSource } from './contract.js';
+export interface DeliveryInput {
+    taskId: string;
+    title: string;
+    request: ConvertRequest;
+    /** Markdown body with image references relative to `index.md`. */
+    markdown: string;
+    sourceFormat: SourceFormat;
+    parser: string;
+    sourceUrl?: string;
+    sourcePath?: string;
+    assets: ConvertAsset[];
+    warnings: ConvertWarning[];
+    dependencyVersions: Record<string, string>;
+    externalId: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export declare function buildFrontMatter(input: DeliveryInput, contentHash: string): Record<string, unknown>;
+export declare function buildIngestPayload(input: DeliveryInput, contentHash: string): IngestPayload;
+export declare function writeDelivery(deliveryDir: string, input: DeliveryInput): Promise<ConvertManifest>;
+export declare function sourceTypeSourceOf(value: string | undefined): SourceTypeSource | undefined;
+//# sourceMappingURL=delivery.d.ts.map

package/lib/delivery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delivery.d.ts","sourceRoot":"","sources":["../src/delivery.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,OAAO,KAAK,EACV,YAAY,EACZ,eAAe,EACf,cAAc,EACd,cAAc,EACd,aAAa,EACb,YAAY,EACZ,gBAAgB,EACjB,MAAM,eAAe,CAAA;AAItB,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,cAAc,CAAA;IACvB,kEAAkE;IAClE,QAAQ,EAAE,MAAM,CAAA;IAChB,YAAY,EAAE,YAAY,CAAA;IAC1B,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,YAAY,EAAE,CAAA;IACtB,QAAQ,EAAE,cAAc,EAAE,CAAA;IAC1B,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC1C,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAsBnG;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,GAAG,aAAa,CAmB3F;AAED,wBAAsB,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,eAAe,CAAC,CA4BvG;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,gBAAgB,GAAG,SAAS,CAE1F"}

package/lib/delivery.js

@@ -0,0 +1,97 @@
+/**
+ * Delivery bundle writer.
+ *
+ * Layout is fixed by the 0013 knowledge-ready contract:
+ *
+ *   convert-out/<taskId>/
+ *     index.md          front matter + body, images referenced as assets/…
+ *     assets/img-*.ext  content-addressed local images
+ *     manifest.json     provenance, parser/version, warnings, ingest payload
+ *
+ * The kernel never writes into the knowledge store; it only produces this
+ * directory plus the `ingest` payload that the DSH layer forwards.
+ */
+import { mkdir } from 'node:fs/promises';
+import { join } from 'node:path';
+import { defaultSourceTypeCandidates } from './contract.js';
+import { sha256, toMarkdownDocument, wordCount, writeTextAtomic } from './markdown.js';
+export function buildFrontMatter(input, contentHash) {
+    const candidates = input.request.sourceTypeCandidates?.length
+        ? input.request.sourceTypeCandidates
+        : defaultSourceTypeCandidates(input.sourceFormat);
+    const frontMatter = {
+        title: input.title,
+        created_at: input.createdAt,
+        updated_at: input.updatedAt,
+        external_id: input.externalId,
+        source_format: input.sourceFormat,
+        content_hash: contentHash,
+        parser: input.parser,
+        source_type_candidates: candidates,
+        word_count: wordCount(input.markdown),
+        asset_count: input.assets.length,
+    };
+    if (input.request.sourceType)
+        frontMatter.source_type = input.request.sourceType;
+    if (input.sourceUrl)
+        frontMatter.source_url = input.sourceUrl;
+    if (input.sourcePath)
+        frontMatter.source_path = input.sourcePath;
+    if (input.request.sourceTypeSource)
+        frontMatter.source_type_source = input.request.sourceTypeSource;
+    if (input.request.lineage && Object.keys(input.request.lineage).length > 0)
+        frontMatter.lineage = input.request.lineage;
+    return frontMatter;
+}
+export function buildIngestPayload(input, contentHash) {
+    const candidates = input.request.sourceTypeCandidates?.length
+        ? input.request.sourceTypeCandidates
+        : defaultSourceTypeCandidates(input.sourceFormat);
+    return {
+        markdown: toMarkdownDocument(buildFrontMatter(input, contentHash), input.markdown),
+        content: input.markdown,
+        title: input.title,
+        externalId: input.externalId,
+        contentHash,
+        sourceFormat: input.sourceFormat,
+        parser: input.parser,
+        ...(input.sourceUrl ? { sourceUrl: input.sourceUrl } : {}),
+        ...(input.sourcePath ? { sourcePath: input.sourcePath } : {}),
+        sourceTypeCandidates: candidates,
+        sourceTypeRequired: !input.request.sourceType,
+        assets: input.assets,
+        assetRefBase: 'delivery',
+    };
+}
+export async function writeDelivery(deliveryDir, input) {
+    await mkdir(deliveryDir, { recursive: true });
+    const contentHash = sha256(input.markdown);
+    const frontMatter = buildFrontMatter(input, contentHash);
+    const document = toMarkdownDocument(frontMatter, input.markdown);
+    await writeTextAtomic(join(deliveryDir, 'index.md'), document);
+    const manifest = {
+        version: 1,
+        taskId: input.taskId,
+        inputKind: input.request.kind,
+        sourceFormat: input.sourceFormat,
+        parser: input.parser,
+        title: input.title,
+        createdAt: input.createdAt,
+        updatedAt: input.updatedAt,
+        deliveryDir,
+        contentHash,
+        externalId: input.externalId,
+        wordCount: wordCount(input.markdown),
+        assets: input.assets,
+        warnings: input.warnings,
+        dependencyVersions: input.dependencyVersions,
+        ...(input.request.lineage ? { lineage: input.request.lineage } : {}),
+        ingest: buildIngestPayload(input, contentHash),
+    };
+    await writeTextAtomic(join(deliveryDir, 'manifest.json'), `${JSON.stringify(manifest, null, 2)}\n`);
+    return manifest;
+}
+export function sourceTypeSourceOf(value) {
+    return value === 'agent' || value === 'user' || value === 'default' ? value : undefined;
+}
+//# sourceMappingURL=delivery.js.map

package/lib/delivery.js.map

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

package/lib/http.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Transport for the kernel: a plain `node:http` handler.
+ *
+ * It is mounted three ways — standalone (`bin/tita-convert.mjs`), inside the
+ * DSH web server (`/convert/*`), and from tests — which is exactly why the
+ * kernel owns a handler instead of a server.
+ */
+import type { IncomingMessage, ServerResponse } from 'node:http';
+import type { ConvertTask } from './contract.js';
+import { ConvertService } from './service.js';
+export interface HandlerOptions {
+    service: ConvertService;
+    /** Path prefix the handler answers on, e.g. `/convert`. Empty means `/`. */
+    basePath?: string;
+    /** Directory holding the Vue console. Resolved relative to this module by default. */
+    webRoot?: string;
+    /** Unauthenticated-local default; when set, every /api call must present it. */
+    apiKey?: string;
+}
+export declare function defaultWebRoot(): string;
+interface MultipartPart {
+    name: string;
+    filename?: string;
+    contentType?: string;
+    data: Buffer;
+}
+/** Minimal multipart/form-data reader: no dependency, no streaming, no surprises. */
+export declare function parseMultipart(body: Buffer, boundary: string): MultipartPart[];
+declare function taskSummary(task: ConvertTask): Record<string, unknown>;
+/** Full task view, including the ingest payload the DSH layer forwards. */
+declare function taskDetail(task: ConvertTask): Record<string, unknown>;
+export declare function createRequestHandler(options: HandlerOptions): (req: IncomingMessage, res: ServerResponse) => Promise<void>;
+export { taskSummary, taskDetail };
+//# sourceMappingURL=http.d.ts.map

package/lib/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAIhE,OAAO,KAAK,EAAkB,WAAW,EAAE,MAAM,eAAe,CAAA;AAChE,OAAO,EAAE,cAAc,EAAiB,MAAM,cAAc,CAAA;AAE5D,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,cAAc,CAAA;IACvB,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,sFAAsF;IACtF,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,gFAAgF;IAChF,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAID,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAmCD,UAAU,aAAa;IACrB,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,IAAI,EAAE,MAAM,CAAA;CACb;AAED,qFAAqF;AACrF,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,aAAa,EAAE,CAyB9E;AAED,iBAAS,WAAW,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAyB/D;AAED,2EAA2E;AAC3E,iBAAS,UAAU,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAO9D;AAgBD,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,cAAc,GAAG,CAAC,GAAG,EAAE,eAAe,EAAE,GAAG,EAAE,cAAc,KAAK,OAAO,CAAC,IAAI,CAAC,CA6J1H;AAqFD,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,CAAA"}