@younndai/lyt-runner 0.9.0

package/dist/expander/parse-record.js

@@ -0,0 +1,162 @@
+/*
+ * Copyright 2026 MARLINK TRADING SRL (YounndAI)
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+export class ExpanderError extends Error {
+    tag;
+    line;
+    constructor(message, tag, line) {
+        super(`expander: ${message} (tag=@${tag}, line=${line})`);
+        this.tag = tag;
+        this.line = line;
+        this.name = "ExpanderError";
+    }
+}
+function asString(v) {
+    if (v === undefined)
+        return undefined;
+    if (typeof v === "string")
+        return v;
+    return undefined;
+}
+function asList(v) {
+    if (v === undefined)
+        return undefined;
+    if (typeof v === "string")
+        return undefined;
+    if (Array.isArray(v))
+        return undefined; // YonMapPair[] — not a flat list
+    // Per yon-parser/src/types.ts L91-96, YonList = { kind, items[] }
+    if (v.kind === "reference-tokens") {
+        return v.items.filter((it) => typeof it === "string");
+    }
+    if (v.kind === "field-items") {
+        return v.items
+            .map((it) => typeof it === "string" ? it : "key" in it && "value" in it ? `${it.key}` : undefined)
+            .filter((s) => typeof s === "string");
+    }
+    return undefined;
+}
+function asBool(v) {
+    const s = asString(v);
+    if (s === undefined)
+        return undefined;
+    if (s === "true")
+        return true;
+    if (s === "false")
+        return false;
+    return undefined;
+}
+function require(field, value, tag, line) {
+    if (value === undefined || value === "") {
+        throw new ExpanderError(`missing required field "${field}"`, tag, line);
+    }
+    return value;
+}
+const VALID_ARCHETYPES = new Set([
+    "filler",
+    "propagator",
+    "generator",
+    "aggregator",
+    "observer",
+    "validator",
+    "pruner",
+    "integrator",
+    "router",
+    "enricher",
+    "transformer",
+    "scheduler",
+    "notifier",
+    "archiver",
+    "custom",
+]);
+const VALID_RUNTIMES = new Set(["deterministic", "llm", "hybrid"]);
+const VALID_TXN_MODES = new Set(["none", "checkpoint", "atomic"]);
+const VALID_SCOPES = new Set(["vault", "mesh"]);
+const VALID_SOURCES = new Set(["system", "user", "mesh", "marketplace"]);
+export function parseAutomator(record) {
+    if (record.tag !== "AUTOMATOR") {
+        throw new ExpanderError(`expected @AUTOMATOR, got @${record.tag}`, record.tag, record.line);
+    }
+    const f = record.fields;
+    const rid = require("rid", asString(f.get("rid")), "AUTOMATOR", record.line);
+    const name = require("name", asString(f.get("name")), "AUTOMATOR", record.line);
+    const version = require("version", asString(f.get("version")), "AUTOMATOR", record.line);
+    const archetype = require("archetype", asString(f.get("archetype")), "AUTOMATOR", record.line);
+    if (!VALID_ARCHETYPES.has(archetype)) {
+        throw new ExpanderError(`archetype "${archetype}" is not one of the 15 valid archetypes`, "AUTOMATOR", record.line);
+    }
+    const description = require("description", asString(f.get("description")), "AUTOMATOR", record.line);
+    const source = require("source", asString(f.get("source")), "AUTOMATOR", record.line);
+    if (!VALID_SOURCES.has(source)) {
+        throw new ExpanderError(`source "${source}" is not one of system|user|mesh|marketplace`, "AUTOMATOR", record.line);
+    }
+    const runtime = require("runtime", asString(f.get("runtime")), "AUTOMATOR", record.line);
+    if (!VALID_RUNTIMES.has(runtime)) {
+        throw new ExpanderError(`runtime "${runtime}" is not one of deterministic|llm|hybrid`, "AUTOMATOR", record.line);
+    }
+    const transaction_mode = require("transaction_mode", asString(f.get("transaction_mode")), "AUTOMATOR", record.line);
+    if (!VALID_TXN_MODES.has(transaction_mode)) {
+        throw new ExpanderError(`transaction_mode "${transaction_mode}" is not one of none|checkpoint|atomic`, "AUTOMATOR", record.line);
+    }
+    const scope = require("scope", asString(f.get("scope")), "AUTOMATOR", record.line);
+    if (!VALID_SCOPES.has(scope)) {
+        throw new ExpanderError(`scope "${scope}" is not one of vault|mesh`, "AUTOMATOR", record.line);
+    }
+    return {
+        rid,
+        name,
+        version,
+        archetype: archetype,
+        description,
+        source: source,
+        runtime: runtime,
+        transaction_mode: transaction_mode,
+        scope: scope,
+        signed_by: asString(f.get("signed_by")),
+        reads_scope: asList(f.get("reads_scope")),
+        writes_scope: asList(f.get("writes_scope")),
+        external_calls: asList(f.get("external_calls")),
+        field_ownership: asList(f.get("field_ownership")),
+        rules: asList(f.get("rules")),
+        handler_gates: asList(f.get("handler_gates")),
+        llm_capability: asString(f.get("llm_capability")),
+        llm_source_preference: asList(f.get("llm_source_preference")),
+        llm_hard_constraints: asList(f.get("llm_hard_constraints")),
+    };
+}
+export function parseDirective(record) {
+    if (record.tag !== "DIRECTIVE") {
+        throw new ExpanderError(`expected @DIRECTIVE, got @${record.tag}`, record.tag, record.line);
+    }
+    const f = record.fields;
+    const inviolable = asBool(f.get("inviolable"));
+    if (inviolable === undefined) {
+        throw new ExpanderError(`missing required field "inviolable" (bool)`, "DIRECTIVE", record.line);
+    }
+    const precedence = asString(f.get("precedence"));
+    return {
+        rid: require("rid", asString(f.get("rid")), "DIRECTIVE", record.line),
+        scope: require("scope", asString(f.get("scope")), "DIRECTIVE", record.line),
+        subject: require("subject", asString(f.get("subject")), "DIRECTIVE", record.line),
+        rule: require("rule", asString(f.get("rule")), "DIRECTIVE", record.line),
+        inviolable,
+        owner: require("owner", asString(f.get("owner")), "DIRECTIVE", record.line),
+        created: require("created", asString(f.get("created")), "DIRECTIVE", record.line),
+        precedence: precedence !== undefined ? Number.parseInt(precedence, 10) : undefined,
+        applies_to: asList(f.get("applies_to")),
+        enforced_by: asList(f.get("enforced_by")),
+    };
+}
+//# sourceMappingURL=parse-record.js.map

package/dist/expander/parse-record.js.map

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

package/dist/expander/types.d.ts

@@ -0,0 +1,39 @@
+export type AutomatorRuntime = "deterministic" | "llm" | "hybrid";
+export type AutomatorTransactionMode = "none" | "checkpoint" | "atomic";
+export type AutomatorScope = "vault" | "mesh";
+export type AutomatorSource = "system" | "user" | "mesh" | "marketplace";
+export type AutomatorArchetype = "filler" | "propagator" | "generator" | "aggregator" | "observer" | "validator" | "pruner" | "integrator" | "router" | "enricher" | "transformer" | "scheduler" | "notifier" | "archiver" | "custom";
+export interface AutomatorRecord {
+    rid: string;
+    name: string;
+    version: string;
+    archetype: AutomatorArchetype;
+    description: string;
+    source: AutomatorSource;
+    runtime: AutomatorRuntime;
+    transaction_mode: AutomatorTransactionMode;
+    scope: AutomatorScope;
+    signed_by?: string;
+    reads_scope?: string[];
+    writes_scope?: string[];
+    external_calls?: string[];
+    field_ownership?: string[];
+    rules?: string[];
+    handler_gates?: string[];
+    llm_capability?: string;
+    llm_source_preference?: string[];
+    llm_hard_constraints?: string[];
+}
+export interface DirectiveRecord {
+    rid: string;
+    scope: string;
+    subject: string;
+    rule: string;
+    inviolable: boolean;
+    owner: string;
+    created: string;
+    precedence?: number;
+    applies_to?: string[];
+    enforced_by?: string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/expander/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/expander/types.ts"],"names":[],"mappings":"AAoBA,MAAM,MAAM,gBAAgB,GAAG,eAAe,GAAG,KAAK,GAAG,QAAQ,CAAC;AAElE,MAAM,MAAM,wBAAwB,GAAG,MAAM,GAAG,YAAY,GAAG,QAAQ,CAAC;AAExE,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,MAAM,CAAC;AAE9C,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,aAAa,CAAC;AAEzE,MAAM,MAAM,kBAAkB,GAC1B,QAAQ,GACR,YAAY,GACZ,WAAW,GACX,YAAY,GACZ,UAAU,GACV,WAAW,GACX,QAAQ,GACR,YAAY,GACZ,QAAQ,GACR,UAAU,GACV,aAAa,GACb,WAAW,GACX,UAAU,GACV,UAAU,GACV,QAAQ,CAAC;AAMb,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,kBAAkB,CAAC;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,eAAe,CAAC;IACxB,OAAO,EAAE,gBAAgB,CAAC;IAC1B,gBAAgB,EAAE,wBAAwB,CAAC;IAC3C,KAAK,EAAE,cAAc,CAAC;IAEtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,qBAAqB,CAAC,EAAE,MAAM,EAAE,CAAC;IACjC,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;CACjC;AAGD,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,OAAO,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAEhB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB"}

package/dist/expander/types.js

@@ -0,0 +1,17 @@
+/*
+ * Copyright 2026 MARLINK TRADING SRL (YounndAI)
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/expander/types.js.map

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

package/dist/hooks/frontmatter.d.ts

@@ -0,0 +1,10 @@
+export interface FrontmatterStampLine {
+    src: string;
+    ts: string;
+    method?: string;
+    confidence?: number;
+    hash?: string;
+}
+export declare function formatLastProvenanceValue(stamp: FrontmatterStampLine): string;
+export declare function upsertLastProvenance(content: string, stamp: FrontmatterStampLine): string;
+//# sourceMappingURL=frontmatter.d.ts.map

package/dist/hooks/frontmatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.d.ts","sourceRoot":"","sources":["../../src/hooks/frontmatter.ts"],"names":[],"mappings":"AAqCA,MAAM,WAAW,oBAAoB;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,oBAAoB,GAAG,MAAM,CAU7E;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,oBAAoB,GAAG,MAAM,CA8CzF"}

package/dist/hooks/frontmatter.js

@@ -0,0 +1,90 @@
+/*
+ * Copyright 2026 MARLINK TRADING SRL (YounndAI)
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+// Minimal frontmatter mutator — upserts `last_provenance:` into a markdown
+// document's YAML frontmatter block.
+//
+// Scope: line-based, no full YAML parse. The hook never mutates user-managed
+// frontmatter fields — it only inserts/replaces the single `last_provenance:`
+// scalar at the top of the block, per arc-thoughts §11.4 step 3 + §11.6
+// ("Don't materialize full chain in every markdown frontmatter — only the
+// most-recent stamp via `last_provenance:` per arc §11.1"). Full chain stays
+// in the libSQL `provenance` table per arc §11.2.
+//
+// Three cases:
+// 1. No frontmatter block → prepend a fresh `---\nlast_provenance: …\n---\n`
+// 2. Frontmatter contains an existing `last_provenance:` line → replace it
+// 3. Frontmatter without `last_provenance:` → insert before the closing `---`
+//
+// `last_provenance:` value shape:
+// "automator:metadata-filler/v0.1.0 ts=2026-05-29T...Z method=filler conf=1.0 hash=sha256:..."
+// — a single-line scalar (no YAML maps) per arc §11.6 frontmatter ergonomics.
+const FRONTMATTER_DELIM = "---";
+export function formatLastProvenanceValue(stamp) {
+    // Single-line scalar; YAML-safe per ergonomics target. Quote the whole
+    // value to keep colons in src/hash from confusing line-based downstream
+    // tooling (e.g. grep / sed scripts).
+    const parts = [`${stamp.src} ts=${stamp.ts}`];
+    if (stamp.method !== undefined)
+        parts.push(`method=${stamp.method}`);
+    if (stamp.confidence !== undefined)
+        parts.push(`conf=${stamp.confidence}`);
+    if (stamp.hash !== undefined)
+        parts.push(`hash=${stamp.hash}`);
+    const joined = parts.join(" ");
+    return `"${joined.replace(/"/g, '\\"')}"`;
+}
+export function upsertLastProvenance(content, stamp) {
+    const value = formatLastProvenanceValue(stamp);
+    const lineToInsert = `last_provenance: ${value}`;
+    const lines = content.split(/\r?\n/);
+    // Detect frontmatter: first non-empty line must be `---`.
+    let firstNonEmptyIdx = -1;
+    for (let i = 0; i < lines.length; i++) {
+        if (lines[i].length > 0) {
+            firstNonEmptyIdx = i;
+            break;
+        }
+    }
+    if (firstNonEmptyIdx === -1 || lines[firstNonEmptyIdx] !== FRONTMATTER_DELIM) {
+        // Case 1: no frontmatter — prepend a fresh block.
+        const trailing = content.length > 0 && !content.startsWith("\n") ? content : content;
+        return `---\n${lineToInsert}\n---\n${trailing}`;
+    }
+    // Find the closing delimiter.
+    let closeIdx = -1;
+    for (let i = firstNonEmptyIdx + 1; i < lines.length; i++) {
+        if (lines[i] === FRONTMATTER_DELIM) {
+            closeIdx = i;
+            break;
+        }
+    }
+    if (closeIdx === -1) {
+        // Malformed frontmatter (open but no close) — treat as "no frontmatter"
+        // and prepend a fresh block. The handler's broken doc isn't our fix.
+        return `---\n${lineToInsert}\n---\n${content}`;
+    }
+    // Case 2: replace existing last_provenance: line, if present.
+    for (let i = firstNonEmptyIdx + 1; i < closeIdx; i++) {
+        if (lines[i].startsWith("last_provenance:") || lines[i].startsWith("last_provenance :")) {
+            lines[i] = lineToInsert;
+            return lines.join("\n");
+        }
+    }
+    // Case 3: insert before the closing `---`.
+    lines.splice(closeIdx, 0, lineToInsert);
+    return lines.join("\n");
+}
+//# sourceMappingURL=frontmatter.js.map

package/dist/hooks/frontmatter.js.map

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

package/dist/hooks/stamp-on-write.d.ts

@@ -0,0 +1,43 @@
+import type { Client } from "@libsql/client";
+import { type ProvenanceWriteTargetType } from "@younndai/lyt-vault";
+import type { LytRunContext } from "../protocol/run-context.js";
+export interface StampMeta {
+    src: string;
+    method?: string;
+    confidence?: number;
+    tokens?: number;
+    costUsd?: number;
+    model?: string;
+    details?: Record<string, unknown>;
+}
+export interface WriteWithStampArgs {
+    path: string;
+    content: string;
+    stamp: StampMeta;
+    vaultRoot?: string;
+    ledgerClients?: {
+        auditDb: Client;
+        provenanceDb: Client;
+    };
+}
+export interface WriteWithStampResult {
+    provenanceId: Uint8Array | null;
+    hash: string;
+    ts: string;
+    fired: boolean;
+}
+export declare function writeMarkdownWithStamp(runContext: LytRunContext | null, vaultDb: Client | null, args: WriteWithStampArgs): Promise<WriteWithStampResult>;
+export declare function writeYonWithStamp(runContext: LytRunContext | null, vaultDb: Client | null, args: WriteWithStampArgs): Promise<WriteWithStampResult>;
+export interface YonStampRecordArgs {
+    ts: string;
+    src: string;
+    method?: string;
+    confidence?: number;
+    hash?: string;
+    tokens?: number;
+    costUsd?: number;
+    model?: string;
+}
+export declare function formatYonStampRecord(args: YonStampRecordArgs): string;
+export type { ProvenanceWriteTargetType };
+//# sourceMappingURL=stamp-on-write.d.ts.map

package/dist/hooks/stamp-on-write.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stamp-on-write.d.ts","sourceRoot":"","sources":["../../src/hooks/stamp-on-write.ts"],"names":[],"mappings":"AA8CA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAQL,KAAK,yBAAyB,EAC/B,MAAM,qBAAqB,CAAC;AAE7B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAmBhE,MAAM,WAAW,SAAS;IAIxB,GAAG,EAAE,MAAM,CAAC;IAIZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IAIf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,kBAAkB;IAGjC,IAAI,EAAE,MAAM,CAAC;IAEb,OAAO,EAAE,MAAM,CAAC;IAEhB,KAAK,EAAE,SAAS,CAAC;IAIjB,SAAS,CAAC,EAAE,MAAM,CAAC;IASnB,aAAa,CAAC,EAAE;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;CACH;AAED,MAAM,WAAW,oBAAoB;IAGnC,YAAY,EAAE,UAAU,GAAG,IAAI,CAAC;IAEhC,IAAI,EAAE,MAAM,CAAC;IAEb,EAAE,EAAE,MAAM,CAAC;IAGX,KAAK,EAAE,OAAO,CAAC;CAChB;AAMD,wBAAsB,sBAAsB,CAC1C,UAAU,EAAE,aAAa,GAAG,IAAI,EAChC,OAAO,EAAE,MAAM,GAAG,IAAI,EACtB,IAAI,EAAE,kBAAkB,GACvB,OAAO,CAAC,oBAAoB,CAAC,CA0C/B;AAMD,wBAAsB,iBAAiB,CACrC,UAAU,EAAE,aAAa,GAAG,IAAI,EAChC,OAAO,EAAE,MAAM,GAAG,IAAI,EACtB,IAAI,EAAE,kBAAkB,GACvB,OAAO,CAAC,oBAAoB,CAAC,CA6C/B;AAuJD,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,kBAAkB,GAAG,MAAM,CAYrE;AA+BD,YAAY,EAAE,yBAAyB,EAAE,CAAC"}