@younndai/lyt-runner 0.9.0

package/dist/hooks/stamp-on-write.js

@@ -0,0 +1,289 @@
+/*
+ * 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.
+ */
+// Pre-write @STAMP hook — auto-injects provenance + audit_log entries
+// whenever an automator writes to a vault filesystem path.
+//
+// Per arc-thoughts §11.4 (LOCKED 2026-05-27), every automator-driven write
+// follows the 6-step contract:
+// 1. Compute content hash (sha256) of what's about to be written
+// 2. Build the provenance entry (src + method + confidence + hash +
+// tokens + cost + model)
+// 3. Markdown writes → update `last_provenance:` frontmatter scalar
+// YON declaration writes → prepend an inline `@STAMP` record
+// 4. Write the file
+// 5. INSERT the provenance row into the per-vault libSQL `provenance` table
+// 6. INSERT an `audit_log` row with `action='automator.write'`,
+// `target_id = provenance.id` (hex)
+//
+// Per arc-thoughts §11.6 the hook fires ONLY under an active automator-run
+// context — handler-written notes (e.g. /lyt-capture, manual edits) pass
+// `runContext: null` and the hook then performs an inert fs write with no
+// provenance recording. This is the "don't @STAMP every keystroke" guard.
+//
+// The hook DOES NOT monkey-patch fs. Automator bodies invoke the
+// `writeMarkdownWithStamp` / `writeYonWithStamp` helpers explicitly; if a
+// body calls `fs.writeFileSync` directly it bypasses the hook (and the
+// brief tolerates that — the body is misbehaving and won't get
+// provenance). This keeps the hook scoped + testable per arc §11.6.
+import { createHash } from "node:crypto";
+import { mkdirSync, writeFileSync } from "node:fs";
+import { dirname, relative, sep, posix } from "node:path";
+import { appendLedgerRecord, closeVaultDb, incrementVaultWritesCount, insertAutomatorWriteAuditLog, newUuidv7Bytes, openLedgerDb, recordProvenance, } from "@younndai/lyt-vault";
+import { upsertLastProvenance } from "./frontmatter.js";
+// v1.A.2 Lock 0.2 — emit `@AUDIT` companion record to ledger
+// when the hook fires under a vaultRoot-aware run. Mirror of
+// `flows/friction.ts` shape. Direct ledger append (not via `recordAudit`)
+// because we have no audit_log row to mirror — the audit row is emitted by
+// `insertAutomatorWriteAuditLog` separately.
+//
+// v1.A.2c DB SPLIT: post-split, the `vaultDb` parameter is semantically the
+// lyt.db client (carries automator_runs / automator_run_events for the
+// incrementVaultWritesCount call). The hook opens audit.db + provenance.db
+// internally per write call — this is the simplest signature-compatible
+// migration but pays a Windows file-lock cost (~400ms × open/close pair)
+// per fired stamp. Threading three clients through the hook signature is
+// a v1.A.3 optimisation candidate (faster batch performance, larger
+// signature change).
+import { join as pathJoin } from "node:path";
+// ---------------------------------------------------------------------------
+// Markdown writer — upserts `last_provenance:` frontmatter scalar.
+// ---------------------------------------------------------------------------
+export async function writeMarkdownWithStamp(runContext, vaultDb, args) {
+    const hash = sha256(args.content);
+    const tsMs = runContext?.startedAt ?? Date.now();
+    const ts = new Date(tsMs).toISOString();
+    // §11.6 guard — handler-written notes get an inert pass-through.
+    if (runContext === null || vaultDb === null) {
+        ensureParentDir(args.path);
+        writeFileSync(args.path, args.content, "utf8");
+        return { provenanceId: null, hash, ts, fired: false };
+    }
+    // Step 3a — upsert last_provenance: line into the frontmatter.
+    const mutated = upsertLastProvenance(args.content, {
+        src: args.stamp.src,
+        ts,
+        ...(args.stamp.method !== undefined ? { method: args.stamp.method } : {}),
+        ...(args.stamp.confidence !== undefined ? { confidence: args.stamp.confidence } : {}),
+        hash: `sha256:${hash}`,
+    });
+    // Step 4 — write the file.
+    ensureParentDir(args.path);
+    writeFileSync(args.path, mutated, "utf8");
+    // Steps 5+6 — record provenance + audit via the split-DB primitive.
+    const provenanceId = newUuidv7Bytes();
+    const targetId = computeTargetId(args.path, args.vaultRoot);
+    await emitProvenanceAndAudit({
+        runContext,
+        vaultDb,
+        args,
+        provenanceId,
+        targetId,
+        targetKind: "note",
+        targetType: "note",
+        hash,
+        ts,
+        tsMs,
+    });
+    return { provenanceId, hash, ts, fired: true };
+}
+// ---------------------------------------------------------------------------
+// YON declaration writer — prepends an inline `@STAMP` record.
+// ---------------------------------------------------------------------------
+export async function writeYonWithStamp(runContext, vaultDb, args) {
+    const hash = sha256(args.content);
+    const tsMs = runContext?.startedAt ?? Date.now();
+    const ts = new Date(tsMs).toISOString();
+    if (runContext === null || vaultDb === null) {
+        ensureParentDir(args.path);
+        writeFileSync(args.path, args.content, "utf8");
+        return { provenanceId: null, hash, ts, fired: false };
+    }
+    // Step 3b — prepend an inline @STAMP record. Per arc §11.4 step 4 the
+    // stamp goes BEFORE the new top-level tag. We treat the content payload
+    // as the "new top-level tag" — emit @STAMP first, then the content.
+    const stampLine = formatYonStampRecord({
+        ts,
+        src: args.stamp.src,
+        ...(args.stamp.method !== undefined ? { method: args.stamp.method } : {}),
+        ...(args.stamp.confidence !== undefined ? { confidence: args.stamp.confidence } : {}),
+        hash: `sha256:${hash}`,
+        ...(args.stamp.tokens !== undefined ? { tokens: args.stamp.tokens } : {}),
+        ...(args.stamp.costUsd !== undefined ? { costUsd: args.stamp.costUsd } : {}),
+        ...(args.stamp.model !== undefined ? { model: args.stamp.model } : {}),
+    });
+    const mutated = `${stampLine}\n\n${args.content}`;
+    ensureParentDir(args.path);
+    writeFileSync(args.path, mutated, "utf8");
+    const provenanceId = newUuidv7Bytes();
+    const targetId = computeTargetId(args.path, args.vaultRoot);
+    await emitProvenanceAndAudit({
+        runContext,
+        vaultDb,
+        args,
+        provenanceId,
+        targetId,
+        targetKind: "declaration",
+        targetType: "declaration",
+        hash,
+        ts,
+        tsMs,
+    });
+    return { provenanceId, hash, ts, fired: true };
+}
+async function emitProvenanceAndAudit(p) {
+    const { runContext, vaultDb, args, provenanceId, targetId, targetKind, targetType, hash, ts, tsMs, } = p;
+    const vaultRoot = args.vaultRoot;
+    if (vaultRoot === undefined || vaultRoot.length === 0) {
+        throw new Error("lyt-runner pre-write hook requires args.vaultRoot post-v1.A.2c DB SPLIT (no libSQL-only fallback).");
+    }
+    const provenanceArgs = {
+        id: provenanceId,
+        targetType,
+        targetId,
+        ts: tsMs,
+        src: args.stamp.src,
+        ...(args.stamp.method !== undefined ? { method: args.stamp.method } : {}),
+        ...(args.stamp.confidence !== undefined ? { confidence: args.stamp.confidence } : {}),
+        hash: `sha256:${hash}`,
+        ...(args.stamp.tokens !== undefined ? { tokens: args.stamp.tokens } : {}),
+        ...(args.stamp.costUsd !== undefined ? { costUsd: args.stamp.costUsd } : {}),
+        ...(args.stamp.model !== undefined ? { model: args.stamp.model } : {}),
+        ...(args.stamp.details !== undefined ? { details: args.stamp.details } : {}),
+    };
+    // v1.A.3 (CR-3 / ALT5 + CR-4 / OPT-1): when the caller threaded open
+    // ledger clients via args.ledgerClients, reuse them and skip the
+    // per-call open/close pair (~400ms × 2 saved on Windows file-lock).
+    // Otherwise fall back to opening + closing our own pair via the
+    // registry-routed openLedgerDb factory. The provenance + audit
+    // emission itself stays content-coupled (audit row carries
+    // provenance id_hex as target_id) — only the DB lifecycle is
+    // optimised.
+    const threaded = args.ledgerClients;
+    const provenanceDb = threaded !== undefined ? threaded.provenanceDb : await openLedgerDb(vaultRoot, "provenance");
+    const auditDb = threaded !== undefined ? threaded.auditDb : await openLedgerDb(vaultRoot, "audit");
+    try {
+        // Provenance: YON-first (recordProvenance wrapper enforces Lock 0.2).
+        await recordProvenance(vaultRoot, provenanceDb, {
+            ...provenanceArgs,
+            stampSrc: "lyt-runner/pre-write-hook",
+        });
+        // Audit: also YON-first per Lock 0.2 (v1.A.2d release review fold — the
+        // previous order ran insertAutomatorWriteAuditLog BEFORE
+        // appendLedgerRecord, which would orphan a row in audit.db if the YON
+        // append failed; rebuild-index --ledger audit walks YON and would
+        // never re-inject the orphan). YON failure is fatal; audit.db upsert
+        // failure (next step) is logged + non-fatal — symmetric with
+        // recordProvenance / recordAudit semantics.
+        const provenanceIdHex = Buffer.from(provenanceId).toString("hex");
+        appendLedgerRecord({
+            ledgerPath: pathJoin(vaultRoot, ".lyt", "ledgers", "audit.yon"),
+            ledgerName: "audit",
+            recordType: "AUDIT",
+            fields: [
+                ["ts", ts],
+                ["actor", args.stamp.src],
+                ["action", "automator.write"],
+                ["target_type", "provenance"],
+                ["target_id", provenanceIdHex],
+                ["result", "success"],
+                [
+                    "details_json",
+                    JSON.stringify({
+                        target_path: targetId,
+                        target_kind: targetKind,
+                        run_id_hex: bytesToHex(runContext.runId),
+                    }),
+                ],
+            ],
+            stampSrc: "lyt-runner/pre-write-hook",
+            ts,
+        });
+        const auditId = newUuidv7Bytes();
+        try {
+            await insertAutomatorWriteAuditLog(auditDb, {
+                id: auditId,
+                ts: tsMs,
+                actor: args.stamp.src,
+                provenanceId,
+                targetPath: targetId,
+                details: { target_kind: targetKind, run_id_hex: bytesToHex(runContext.runId) },
+            });
+        }
+        catch (err) {
+            // .db cache write failed but YON SoT is already on disk; log + continue
+            // per the recordAudit / recordProvenance contract. rebuild-index
+            // --ledger audit reconstructs from audit.yon.
+            // eslint-disable-next-line no-console
+            console.warn("lyt-runner pre-write hook: audit.db upsert failed (YON SoT preserved); recoverable via rebuild-index --ledger audit", err);
+        }
+        // Bump the per-run vault_writes_count so automator_runs telemetry stays
+        // accurate without the caller having to manage it. Uses the lyt.db
+        // client the caller threaded through.
+        await incrementVaultWritesCount(vaultDb, runContext.runId);
+    }
+    finally {
+        // OPT-1: only close DBs we opened ourselves. When the caller threaded
+        // pre-opened clients, they own the lifecycle.
+        if (threaded === undefined) {
+            await closeVaultDb(auditDb);
+            await closeVaultDb(provenanceDb);
+        }
+    }
+}
+export function formatYonStampRecord(args) {
+    // Mirrors yai-domain L399-402 + arc-thoughts §11.4 surface. ts is typed
+    // (`ts:ts=...`) per YON spec L385; confidence is float; tokens is int.
+    // Cost is float; model is a quoted string.
+    const parts = [`@STAMP ts:ts=${args.ts}`, `src="${args.src}"`];
+    if (args.method !== undefined)
+        parts.push(`method=${args.method}`);
+    if (args.confidence !== undefined)
+        parts.push(`confidence:float=${args.confidence}`);
+    if (args.hash !== undefined)
+        parts.push(`hash="${args.hash}"`);
+    if (args.tokens !== undefined)
+        parts.push(`tokens:int=${args.tokens}`);
+    if (args.costUsd !== undefined)
+        parts.push(`cost:float=${args.costUsd}`);
+    if (args.model !== undefined)
+        parts.push(`model="${args.model}"`);
+    return parts.join(" | ");
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function sha256(content) {
+    return createHash("sha256").update(content, "utf8").digest("hex");
+}
+function ensureParentDir(absPath) {
+    const parent = dirname(absPath);
+    if (parent.length === 0)
+        return;
+    mkdirSync(parent, { recursive: true });
+}
+function computeTargetId(absPath, vaultRoot) {
+    if (vaultRoot === undefined || vaultRoot.length === 0)
+        return absPath;
+    const rel = relative(vaultRoot, absPath);
+    // Normalize to posix separators so the stored target_id is portable
+    // across OSes — registered paths grep cleanly on Linux even when written
+    // on Windows.
+    return rel.split(sep).join(posix.sep);
+}
+function bytesToHex(bytes) {
+    return Buffer.from(bytes).toString("hex");
+}
+//# sourceMappingURL=stamp-on-write.js.map

package/dist/hooks/stamp-on-write.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,21 @@
+import { type Runner, type RunnerConfig } from "@younndai/yon-runner";
+import type { LytRuntime } from "./runtime.js";
+export interface LytRunnerConfig extends RunnerConfig {
+    runtime?: LytRuntime;
+}
+export declare function createLytRunner(config?: LytRunnerConfig): Runner;
+export { lytExpand, parseAutomator, parseDirective, automatorToAgentRecords, ExpanderError, } from "./expander/index.js";
+export type { ExpandOptions, ExpandResult, AutomatorRecord, DirectiveRecord, AutomatorArchetype, AutomatorRuntime, AutomatorScope, AutomatorSource, AutomatorTransactionMode, } from "./expander/index.js";
+export { LYT_OPS, LYT_OPS_NAMESPACE, LYT_OPS_VERSION, stdLeaseAcquireV1, stdLeaseReleaseV1, stdLeaseRefreshV1, stdVaultSyncV1, stdVaultCommitV1, stdMeshPullV1, stdMeshPropagateV1, createLeaseOps, createVaultOps, createLlmOps, createMeshOps, } from "./ops/index.js";
+export type { OpStubResult, LeaseAcquireOpArgs, LeaseAcquireOpResult, LeaseReleaseOpArgs, LeaseRefreshOpArgs, LeaseOpResult, VaultSyncOpArgs, VaultSyncOpResult, VaultCommitOpArgs, VaultCommitOpResult, LlmGenerateOpArgs, LlmEmbedOpArgs, LlmStubResult, MeshStubResult, } from "./ops/index.js";
+export { createLytRuntime } from "./runtime.js";
+export type { LytRuntime, LytRuntimeConfig } from "./runtime.js";
+export { runFiveStep } from "./protocol/five-step.js";
+export type { FiveStepOptions, FiveStepResult } from "./protocol/five-step.js";
+export { createRunContext, finalizeContext, finishStep, startStep, } from "./protocol/run-context.js";
+export type { LytRunContext, LytRunStatus, LytRunStepTiming } from "./protocol/run-context.js";
+export { writeMarkdownWithStamp, writeYonWithStamp, formatYonStampRecord, } from "./hooks/stamp-on-write.js";
+export type { StampMeta, WriteWithStampArgs, WriteWithStampResult, YonStampRecordArgs, ProvenanceWriteTargetType, } from "./hooks/stamp-on-write.js";
+export { upsertLastProvenance, formatLastProvenanceValue } from "./hooks/frontmatter.js";
+export type { FrontmatterStampLine } from "./hooks/frontmatter.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":"AA4CA,OAAO,EAAgB,KAAK,MAAM,EAAE,KAAK,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAOpF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE/C,MAAM,WAAW,eAAgB,SAAQ,YAAY;IASnD,OAAO,CAAC,EAAE,UAAU,CAAC;CACtB;AAED,wBAAgB,eAAe,CAAC,MAAM,GAAE,eAAoB,GAAG,MAAM,CAiCpE;AAKD,OAAO,EACL,SAAS,EACT,cAAc,EACd,cAAc,EACd,uBAAuB,EACvB,aAAa,GACd,MAAM,qBAAqB,CAAC;AAE7B,YAAY,EACV,aAAa,EACb,YAAY,EACZ,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,gBAAgB,EAChB,cAAc,EACd,eAAe,EACf,wBAAwB,GACzB,MAAM,qBAAqB,CAAC;AAK7B,OAAO,EACL,OAAO,EACP,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,aAAa,EACb,kBAAkB,EAClB,cAAc,EACd,cAAc,EACd,YAAY,EACZ,aAAa,GACd,MAAM,gBAAgB,CAAC;AAExB,YAAY,EACV,YAAY,EACZ,kBAAkB,EAClB,oBAAoB,EACpB,kBAAkB,EAClB,kBAAkB,EAClB,aAAa,EACb,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,EACnB,iBAAiB,EACjB,cAAc,EACd,aAAa,EACb,cAAc,GACf,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,YAAY,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEjE,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAE/E,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,UAAU,EACV,SAAS,GACV,MAAM,2BAA2B,CAAC;AACnC,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAG/F,OAAO,EACL,sBAAsB,EACtB,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,2BAA2B,CAAC;AACnC,YAAY,EACV,SAAS,EACT,kBAAkB,EAClB,oBAAoB,EACpB,kBAAkB,EAClB,yBAAyB,GAC1B,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EAAE,oBAAoB,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AACzF,YAAY,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/index.js

@@ -0,0 +1,96 @@
+/*
+ * 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.
+ */
+// @younndai/lyt-runner — public entry point.
+//
+// Pattern A (arc-thoughts §6.11 LOCKED 2026-05-27): a thin wrapper on
+// @younndai/yon-runner. createLytRunner() composes:
+// 1. yon-runner's createRunner(config) — base runtime with 39 std ops
+// 2. The yai.lyt expander (Commit 1) — `lytExpand(doc)` is the public
+// surface; the runner does NOT auto-apply it on every run() — callers
+// invoke it explicitly when they have an @AUTOMATOR-bearing doc
+// 3. (Commit 4) LytRuntime + ops registration:
+// - createLeaseOps(runtime) → std:lease.acquire / .release / .refresh
+// - createVaultOps(runtime) → std:vault.sync / .commit
+// - createMeshOps() → std:mesh.pull / .propagate (stubs;
+// block-C consumers)
+// - createLlmOps(gateway) → std:llm.generate / .embed (real when
+// gateway present); std:llm.stream /
+// .generate_object (stubs; block-D)
+//
+// If `config.runtime` is omitted the runner registers the Commit-1 fallback
+// stubs (`LYT_OPS`) so legacy callers + the expander-only test suite still
+// build green. The 5-step protocol orchestrator (`runFiveStep`) is exported
+// separately — it takes its own LytRuntime + automatorRid/vaultRid and
+// orchestrates lease → sync → body → commit → release in TS.
+//
+// Reference: zen-runner/src/index.ts L202-294 is the canonical Pattern A
+// composition template; lyt-runner mirrors its createRunner + registerPlugin
+// shape, extended with conditional real-op registration when a LytRuntime
+// is supplied.
+import { createRunner } from "@younndai/yon-runner";
+import { createLeaseOps } from "./ops/leases.js";
+import { createLlmOps } from "./ops/llm.js";
+import { createMeshOps } from "./ops/mesh.js";
+import { createVaultOps } from "./ops/vault.js";
+import { LYT_OPS, LYT_OPS_NAMESPACE, LYT_OPS_VERSION } from "./ops/index.js";
+export function createLytRunner(config = {}) {
+    const { runtime, ...runnerConfig } = config;
+    // 1. Construct the base yon-runner. Per zen-runner/src/index.ts:233 the
+    // canonical pattern is `createRunner(config)` with no plugins yet;
+    // registerPlugin happens immediately after construction.
+    const runner = createRunner(runnerConfig);
+    // 2. Register the lyt op set. Per yon-runner/src/ops/registry.ts L50-56,
+    // registerPlugin iterates plugin.ops and registers each as
+    // `${namespace}:${name}@${version}` (e.g. `std:lease.acquire@v1`).
+    if (runtime !== undefined) {
+        // Commit-4 path: real ops bound to a LytRuntime + optional LlmGateway.
+        runner.registerPlugin({
+            namespace: LYT_OPS_NAMESPACE,
+            ops: {
+                ...createLeaseOps(runtime),
+                ...createVaultOps(runtime),
+                ...createMeshOps(),
+                ...createLlmOps(runtime.llmGateway),
+            },
+            version: LYT_OPS_VERSION,
+        });
+    }
+    else {
+        // Commit-1 fallback: stub bundle. New callers should pass a runtime.
+        runner.registerPlugin({
+            namespace: LYT_OPS_NAMESPACE,
+            ops: LYT_OPS,
+            version: LYT_OPS_VERSION,
+        });
+    }
+    return runner;
+}
+// Re-export the expander surface so external consumers (test harnesses,
+// future @younndai/lyt-llm, the lyt automator CLI verb group from Commit 6)
+// can reach them without deep-importing from /expander/.
+export { lytExpand, parseAutomator, parseDirective, automatorToAgentRecords, ExpanderError, } from "./expander/index.js";
+// Re-export the op surface — back-compat stubs plus the new real-op
+// factories. Callers can compose ops manually if they need to mix
+// real + stub for a particular test scenario.
+export { LYT_OPS, LYT_OPS_NAMESPACE, LYT_OPS_VERSION, stdLeaseAcquireV1, stdLeaseReleaseV1, stdLeaseRefreshV1, stdVaultSyncV1, stdVaultCommitV1, stdMeshPullV1, stdMeshPropagateV1, createLeaseOps, createVaultOps, createLlmOps, createMeshOps, } from "./ops/index.js";
+// Runtime + protocol surface (Commit 4 new).
+export { createLytRuntime } from "./runtime.js";
+export { runFiveStep } from "./protocol/five-step.js";
+export { createRunContext, finalizeContext, finishStep, startStep, } from "./protocol/run-context.js";
+// Block-B Commit 5: pre-write @STAMP hook surface (arc-thoughts §11.4).
+export { writeMarkdownWithStamp, writeYonWithStamp, formatYonStampRecord, } from "./hooks/stamp-on-write.js";
+export { upsertLastProvenance, formatLastProvenanceValue } from "./hooks/frontmatter.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,6CAA6C;AAC7C,EAAE;AACF,sEAAsE;AACtE,oDAAoD;AACpD,sEAAsE;AACtE,sEAAsE;AACtE,sEAAsE;AACtE,gEAAgE;AAChE,+CAA+C;AAC/C,sEAAsE;AACtE,uDAAuD;AACvD,yDAAyD;AACzD,qBAAqB;AACrB,iEAAiE;AACjE,qCAAqC;AACrC,oCAAoC;AACpC,EAAE;AACF,4EAA4E;AAC5E,2EAA2E;AAC3E,4EAA4E;AAC5E,uEAAuE;AACvE,6DAA6D;AAC7D,EAAE;AACF,yEAAyE;AACzE,6EAA6E;AAC7E,0EAA0E;AAC1E,eAAe;AAEf,OAAO,EAAE,YAAY,EAAkC,MAAM,sBAAsB,CAAC;AAEpF,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAe7E,MAAM,UAAU,eAAe,CAAC,SAA0B,EAAE;IAC1D,MAAM,EAAE,OAAO,EAAE,GAAG,YAAY,EAAE,GAAG,MAAM,CAAC;IAE5C,wEAAwE;IACxE,mEAAmE;IACnE,yDAAyD;IACzD,MAAM,MAAM,GAAG,YAAY,CAAC,YAAY,CAAC,CAAC;IAE1C,yEAAyE;IACzE,2DAA2D;IAC3D,mEAAmE;IACnE,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,uEAAuE;QACvE,MAAM,CAAC,cAAc,CAAC;YACpB,SAAS,EAAE,iBAAiB;YAC5B,GAAG,EAAE;gBACH,GAAG,cAAc,CAAC,OAAO,CAAC;gBAC1B,GAAG,cAAc,CAAC,OAAO,CAAC;gBAC1B,GAAG,aAAa,EAAE;gBAClB,GAAG,YAAY,CAAC,OAAO,CAAC,UAAU,CAAC;aACpC;YACD,OAAO,EAAE,eAAe;SACzB,CAAC,CAAC;IACL,CAAC;SAAM,CAAC;QACN,qEAAqE;QACrE,MAAM,CAAC,cAAc,CAAC;YACpB,SAAS,EAAE,iBAAiB;YAC5B,GAAG,EAAE,OAAO;YACZ,OAAO,EAAE,eAAe;SACzB,CAAC,CAAC;IACL,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,wEAAwE;AACxE,4EAA4E;AAC5E,yDAAyD;AACzD,OAAO,EACL,SAAS,EACT,cAAc,EACd,cAAc,EACd,uBAAuB,EACvB,aAAa,GACd,MAAM,qBAAqB,CAAC;AAc7B,oEAAoE;AACpE,kEAAkE;AAClE,8CAA8C;AAC9C,OAAO,EACL,OAAO,EACP,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,aAAa,EACb,kBAAkB,EAClB,cAAc,EACd,cAAc,EACd,YAAY,EACZ,aAAa,GACd,MAAM,gBAAgB,CAAC;AAmBxB,6CAA6C;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAGhD,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAGtD,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,UAAU,EACV,SAAS,GACV,MAAM,2BAA2B,CAAC;AAGnC,wEAAwE;AACxE,OAAO,EACL,sBAAsB,EACtB,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,2BAA2B,CAAC;AASnC,OAAO,EAAE,oBAAoB,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/ops/index.d.ts

@@ -0,0 +1,24 @@
+import type { OpHandler } from "@younndai/yon-runner";
+export interface OpStubResult {
+    status: "stub";
+    op: string;
+    warning: string;
+    args: Record<string, unknown>;
+}
+export declare const stdLeaseAcquireV1: OpHandler;
+export declare const stdLeaseReleaseV1: OpHandler;
+export declare const stdLeaseRefreshV1: OpHandler;
+export declare const stdVaultSyncV1: OpHandler;
+export declare const stdVaultCommitV1: OpHandler;
+export declare const LYT_OPS: Record<string, OpHandler>;
+export declare const LYT_OPS_NAMESPACE = "std";
+export declare const LYT_OPS_VERSION = "v1";
+export { createLeaseOps } from "./leases.js";
+export { createVaultOps } from "./vault.js";
+export { createLlmOps } from "./llm.js";
+export { createMeshOps, stdMeshPullV1, stdMeshPropagateV1 } from "./mesh.js";
+export type { LeaseAcquireOpArgs, LeaseAcquireOpResult, LeaseReleaseOpArgs, LeaseRefreshOpArgs, LeaseOpResult, } from "./leases.js";
+export type { VaultSyncOpArgs, VaultSyncOpResult, VaultCommitOpArgs, VaultCommitOpResult, } from "./vault.js";
+export type { LlmGenerateOpArgs, LlmEmbedOpArgs, LlmStubResult } from "./llm.js";
+export type { MeshStubResult } from "./mesh.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/ops/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ops/index.ts"],"names":[],"mappings":"AA8CA,OAAO,KAAK,EAAoB,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAIxE,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAyBD,eAAO,MAAM,iBAAiB,WAAkE,CAAC;AACjG,eAAO,MAAM,iBAAiB,WAAkE,CAAC;AACjG,eAAO,MAAM,iBAAiB,WAAkE,CAAC;AACjG,eAAO,MAAM,cAAc,WAA+D,CAAC;AAC3F,eAAO,MAAM,gBAAgB,WAAiE,CAAC;AAE/F,eAAO,MAAM,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAQ7C,CAAC;AAEF,eAAO,MAAM,iBAAiB,QAAQ,CAAC;AACvC,eAAO,MAAM,eAAe,OAAO,CAAC;AAGpC,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAE7E,YAAY,EACV,kBAAkB,EAClB,oBAAoB,EACpB,kBAAkB,EAClB,kBAAkB,EAClB,aAAa,GACd,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,iBAAiB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACjF,YAAY,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC"}

package/dist/ops/index.js

@@ -0,0 +1,56 @@
+/*
+ * 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.
+ */
+import { stdMeshPullV1, stdMeshPropagateV1 } from "./mesh.js";
+// ---------------------------------------------------------------------------
+// Commit 1 back-compat stubs. These are unchanged in shape — every entry
+// here is a `(_ctx, args) => structured-no-op-with-warning` handler. They
+// are kept so any test or downstream import from Commit 1 that referenced
+// `LYT_OPS` keeps working; new callers should use createLytRunner() which
+// invokes the real factories from leases.ts / vault.ts / llm.ts.
+// ---------------------------------------------------------------------------
+function makeStub(op, deferredPhase) {
+    const handler = async (_ctx, args) => {
+        return {
+            status: "stub",
+            op,
+            warning: `${op} is not implemented in the LYT_OPS stub bundle; use createLytRunner() with a configured LytRuntime to register the real impl (${deferredPhase})`,
+            args,
+        };
+    };
+    return handler;
+}
+export const stdLeaseAcquireV1 = makeStub("std:lease.acquire@v1", "via createLeaseOps(runtime)");
+export const stdLeaseReleaseV1 = makeStub("std:lease.release@v1", "via createLeaseOps(runtime)");
+export const stdLeaseRefreshV1 = makeStub("std:lease.refresh@v1", "via createLeaseOps(runtime)");
+export const stdVaultSyncV1 = makeStub("std:vault.sync@v1", "via createVaultOps(runtime)");
+export const stdVaultCommitV1 = makeStub("std:vault.commit@v1", "via createVaultOps(runtime)");
+export const LYT_OPS = {
+    "lease.acquire": stdLeaseAcquireV1,
+    "lease.release": stdLeaseReleaseV1,
+    "lease.refresh": stdLeaseRefreshV1,
+    "vault.sync": stdVaultSyncV1,
+    "vault.commit": stdVaultCommitV1,
+    "mesh.pull": stdMeshPullV1,
+    "mesh.propagate": stdMeshPropagateV1,
+};
+export const LYT_OPS_NAMESPACE = "std";
+export const LYT_OPS_VERSION = "v1";
+// Re-export the real-op factories so createLytRunner() can compose them.
+export { createLeaseOps } from "./leases.js";
+export { createVaultOps } from "./vault.js";
+export { createLlmOps } from "./llm.js";
+export { createMeshOps, stdMeshPullV1, stdMeshPropagateV1 } from "./mesh.js";
+//# sourceMappingURL=index.js.map

package/dist/ops/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ops/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAkCH,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAS9D,8EAA8E;AAC9E,yEAAyE;AACzE,0EAA0E;AAC1E,0EAA0E;AAC1E,0EAA0E;AAC1E,iEAAiE;AACjE,8EAA8E;AAE9E,SAAS,QAAQ,CAAC,EAAU,EAAE,aAAqB;IACjD,MAAM,OAAO,GAAc,KAAK,EAC9B,IAAsB,EACtB,IAA6B,EACN,EAAE;QACzB,OAAO;YACL,MAAM,EAAE,MAAM;YACd,EAAE;YACF,OAAO,EAAE,GAAG,EAAE,iIAAiI,aAAa,GAAG;YAC/J,IAAI;SACL,CAAC;IACJ,CAAC,CAAC;IACF,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,CAAC,MAAM,iBAAiB,GAAG,QAAQ,CAAC,sBAAsB,EAAE,6BAA6B,CAAC,CAAC;AACjG,MAAM,CAAC,MAAM,iBAAiB,GAAG,QAAQ,CAAC,sBAAsB,EAAE,6BAA6B,CAAC,CAAC;AACjG,MAAM,CAAC,MAAM,iBAAiB,GAAG,QAAQ,CAAC,sBAAsB,EAAE,6BAA6B,CAAC,CAAC;AACjG,MAAM,CAAC,MAAM,cAAc,GAAG,QAAQ,CAAC,mBAAmB,EAAE,6BAA6B,CAAC,CAAC;AAC3F,MAAM,CAAC,MAAM,gBAAgB,GAAG,QAAQ,CAAC,qBAAqB,EAAE,6BAA6B,CAAC,CAAC;AAE/F,MAAM,CAAC,MAAM,OAAO,GAA8B;IAChD,eAAe,EAAE,iBAAiB;IAClC,eAAe,EAAE,iBAAiB;IAClC,eAAe,EAAE,iBAAiB;IAClC,YAAY,EAAE,cAAc;IAC5B,cAAc,EAAE,gBAAgB;IAChC,WAAW,EAAE,aAAa;IAC1B,gBAAgB,EAAE,kBAAkB;CACrC,CAAC;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAAG,KAAK,CAAC;AACvC,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,CAAC;AAEpC,yEAAyE;AACzE,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC"}

package/dist/ops/leases.d.ts

@@ -0,0 +1,28 @@
+import type { OpHandler } from "@younndai/yon-runner";
+import type { LytRuntime } from "../runtime.js";
+export interface LeaseAcquireOpArgs {
+    automator_rid: string;
+    vault_rid: string;
+    ttl_ms?: number;
+}
+export interface LeaseAcquireOpResult {
+    status: "acquired";
+    lease_id: string;
+    expires_at: number;
+    acquired_at: number;
+    machine_id: string;
+}
+export interface LeaseReleaseOpArgs {
+    lease_id: string;
+    reason?: string;
+}
+export interface LeaseRefreshOpArgs {
+    lease_id: string;
+    ttl_ms?: number;
+}
+export interface LeaseOpResult {
+    status: "released" | "refreshed" | "not_active";
+    lease_id: string;
+}
+export declare function createLeaseOps(runtime: LytRuntime): Record<string, OpHandler>;
+//# sourceMappingURL=leases.d.ts.map

package/dist/ops/leases.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"leases.d.ts","sourceRoot":"","sources":["../../src/ops/leases.ts"],"names":[],"mappings":"AAoCA,OAAO,KAAK,EAAoB,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAUxE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhD,MAAM,WAAW,kBAAkB;IACjC,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,UAAU,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,UAAU,GAAG,WAAW,GAAG,YAAY,CAAC;IAChD,QAAQ,EAAE,MAAM,CAAC;CAClB;AAmBD,wBAAgB,cAAc,CAAC,OAAO,EAAE,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CA0E7E"}