@younndai/lyt-runner 0.9.0

package/dist/protocol/five-step.js

@@ -0,0 +1,312 @@
+/*
+ * 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.
+ */
+// 5-step protocol orchestrator (block-B Commit 4).
+//
+// Per arc-thoughts §6.6:201-216 (LOCKED 2026-05-27) every automator run
+// follows the same five-step shape regardless of archetype:
+//
+// 1. Acquire machine lease (libSQL row with TTL)
+// 2. Sync own vault (git pull --ff-only)
+// 3. Run automator body (the @AUTOMATOR @STEPs after yai.lyt expansion)
+// 4. Commit + push vault changes (gated --no-push for tests + dry-runs)
+// 5. Release lease (clean status) OR mark released_reason='error' on
+// failure path
+//
+// This orchestrator implements the protocol in TypeScript rather than as a
+// YON document because the protocol IS framework: every automator inherits
+// it. Per arc §6.6 "5-step covers ~95% of automators"; 6-step (cross-vault
+// writes) is v3. v1 transaction_mode is `none` (arc §6.8) — failed body
+// step leaves the vault in whatever state the body got it to, with
+// automator_runs.status='failed' carrying the error trail.
+//
+// Crash recovery: any error in steps 2-4 produces a `failed_*` status,
+// surfaces an error summary, and best-effort releases the lease with
+// reason='error'. Step 5 release failure is non-fatal — the auto-expiry
+// sweep on the next acquireLease() call collects the orphan.
+//
+// Block-B Commit 5 wires this into the `automator_runs` + `provenance` +
+// `audit_log` per-vault libSQL tables. Commit 4's orchestrator is the
+// stable skeleton those writes hook into.
+import { acquireLease, insertAutomatorRun, insertAutomatorRunEvent, newUuidv7Bytes, releaseLease, updateAutomatorRunStatus, } from "@younndai/lyt-vault";
+import { createVaultOps } from "../ops/vault.js";
+import { createRunContext, finalizeContext, finishStep, startStep, } from "./run-context.js";
+export async function runFiveStep(runtime, opts) {
+    if (runtime.db === undefined && opts.dryRun !== true) {
+        throw new Error("runFiveStep: LytRuntime.db is undefined; either pass config.db to createLytRunner() or invoke with { dryRun: true }");
+    }
+    const startedAt = runtime.getNow();
+    const runId = opts.runIdOverride ?? newUuidv7Bytes();
+    const ctx = createRunContext({
+        runId,
+        automatorRid: opts.automatorRid,
+        vaultRid: opts.vaultRid,
+        vaultPath: opts.vaultPath,
+        machineId: runtime.machineId,
+        startedAt,
+    });
+    // Block-B Commit 5: INSERT automator_runs row at orchestrator entry so
+    // every event written downstream (incl. body-side @STAMP audit rows) has
+    // a parent row to FK-reference. Skipped when no vault-side DB has been
+    // supplied (unit-test path) or when dryRun is set (no-write contract).
+    const vaultDb = opts.vaultDb;
+    const persistRunLedger = vaultDb !== undefined && opts.dryRun !== true;
+    if (persistRunLedger) {
+        await insertAutomatorRun(vaultDb, {
+            id: runId,
+            automatorName: opts.automatorName ?? "automator:unknown",
+            vaultRid: opts.vaultRid,
+            startedAt,
+            status: "pending",
+        });
+    }
+    // Steps 1 + 5 use leases-repo directly. Step 2 + 4 reuse the registered
+    // vault ops so the protocol invokes the same code path as an
+    // automator-body @STEP that references `std:vault.sync@v1` /
+    // `std:vault.commit@v1`. Single source of truth for the git shell.
+    const vaultOps = createVaultOps({ ...runtime, vaultPath: opts.vaultPath });
+    const vaultSync = vaultOps["vault.sync"];
+    const vaultCommit = vaultOps["vault.commit"];
+    // Dummy ExecutionContext for the in-protocol direct invocation. Runtime
+    // ops only read .args; the other fields aren't touched. Cast through
+    // unknown to satisfy the structural contract without inventing a sandbox.
+    const dummyCtx = {
+        sandboxRoot: opts.vaultPath,
+        env: {},
+        blocks: {
+            get: () => undefined,
+            set: () => undefined,
+            has: () => false,
+            keys: () => [],
+        },
+        args: {},
+        inputs: new Map(),
+        signal: new AbortController().signal,
+    };
+    // ---- Step 1 — acquire lease ----------------------------------------
+    const stepAcquire = startStep(ctx, "acquire", runtime.getNow());
+    await recordStepStarted(persistRunLedger ? vaultDb : null, runId, stepAcquire, runtime.getNow());
+    if (opts.dryRun === true) {
+        // Skip — record the step as ok so the trace still shows 5 entries.
+        finishStep(stepAcquire, runtime.getNow(), true);
+        ctx.status = "lease_acquired";
+    }
+    else {
+        try {
+            const lease = await acquireLease(runtime.db, {
+                automatorRid: opts.automatorRid,
+                vaultRid: opts.vaultRid,
+                machineId: runtime.machineId,
+                ...(opts.ttlMs !== undefined ? { ttlMs: opts.ttlMs } : {}),
+                now: runtime.getNow(),
+            });
+            ctx.leaseId = lease.leaseId;
+            finishStep(stepAcquire, runtime.getNow(), true);
+            ctx.status = "lease_acquired";
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            finishStep(stepAcquire, runtime.getNow(), false, msg);
+            await recordStepFinished(persistRunLedger ? vaultDb : null, runId, stepAcquire, runtime.getNow());
+            finalizeContext(ctx, runtime.getNow(), "failed_lease", msg);
+            await recordTerminalStatus(persistRunLedger ? vaultDb : null, ctx);
+            return { context: ctx, ok: false };
+        }
+    }
+    await recordStepFinished(persistRunLedger ? vaultDb : null, runId, stepAcquire, runtime.getNow());
+    // ---- Step 2 — vault sync -------------------------------------------
+    const stepSync = startStep(ctx, "sync", runtime.getNow());
+    await recordStepStarted(persistRunLedger ? vaultDb : null, runId, stepSync, runtime.getNow());
+    if (opts.dryRun === true) {
+        finishStep(stepSync, runtime.getNow(), true);
+        ctx.status = "synced";
+    }
+    else {
+        try {
+            await vaultSync(dummyCtx, { vault_path: opts.vaultPath });
+            finishStep(stepSync, runtime.getNow(), true);
+            ctx.status = "synced";
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            finishStep(stepSync, runtime.getNow(), false, msg);
+            await recordStepFinished(persistRunLedger ? vaultDb : null, runId, stepSync, runtime.getNow());
+            await releaseOnError(runtime, ctx, "sync_failed");
+            finalizeContext(ctx, runtime.getNow(), "failed_sync", msg);
+            await recordTerminalStatus(persistRunLedger ? vaultDb : null, ctx);
+            return { context: ctx, ok: false };
+        }
+    }
+    await recordStepFinished(persistRunLedger ? vaultDb : null, runId, stepSync, runtime.getNow());
+    // ---- Step 3 — run body ---------------------------------------------
+    const stepBody = startStep(ctx, "body", runtime.getNow());
+    await recordStepStarted(persistRunLedger ? vaultDb : null, runId, stepBody, runtime.getNow());
+    ctx.status = "body_running";
+    try {
+        ctx.bodyResult = await opts.runBody(ctx);
+        finishStep(stepBody, runtime.getNow(), true);
+        ctx.status = "body_completed";
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        finishStep(stepBody, runtime.getNow(), false, msg);
+        await recordStepFinished(persistRunLedger ? vaultDb : null, runId, stepBody, runtime.getNow());
+        await releaseOnError(runtime, ctx, "body_failed");
+        finalizeContext(ctx, runtime.getNow(), "failed_body", msg);
+        await recordTerminalStatus(persistRunLedger ? vaultDb : null, ctx);
+        return { context: ctx, ok: false };
+    }
+    await recordStepFinished(persistRunLedger ? vaultDb : null, runId, stepBody, runtime.getNow());
+    // ---- Step 4 — vault commit -----------------------------------------
+    const stepCommit = startStep(ctx, "commit", runtime.getNow());
+    await recordStepStarted(persistRunLedger ? vaultDb : null, runId, stepCommit, runtime.getNow());
+    if (opts.dryRun === true) {
+        finishStep(stepCommit, runtime.getNow(), true);
+        ctx.status = "committed";
+    }
+    else {
+        try {
+            const commitArgs = { vault_path: opts.vaultPath };
+            if (opts.commitMessage !== undefined)
+                commitArgs["message"] = opts.commitMessage;
+            if (opts.noPush === true)
+                commitArgs["no_push"] = true;
+            await vaultCommit(dummyCtx, commitArgs);
+            finishStep(stepCommit, runtime.getNow(), true);
+            ctx.status = "committed";
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            finishStep(stepCommit, runtime.getNow(), false, msg);
+            await recordStepFinished(persistRunLedger ? vaultDb : null, runId, stepCommit, runtime.getNow());
+            await releaseOnError(runtime, ctx, "commit_failed");
+            finalizeContext(ctx, runtime.getNow(), "failed_commit", msg);
+            await recordTerminalStatus(persistRunLedger ? vaultDb : null, ctx);
+            return { context: ctx, ok: false };
+        }
+    }
+    await recordStepFinished(persistRunLedger ? vaultDb : null, runId, stepCommit, runtime.getNow());
+    // ---- Step 5 — release lease ----------------------------------------
+    const stepRelease = startStep(ctx, "release", runtime.getNow());
+    await recordStepStarted(persistRunLedger ? vaultDb : null, runId, stepRelease, runtime.getNow());
+    if (opts.dryRun === true || ctx.leaseId === null) {
+        finishStep(stepRelease, runtime.getNow(), true);
+        finalizeContext(ctx, runtime.getNow(), "completed");
+        await recordStepFinished(persistRunLedger ? vaultDb : null, runId, stepRelease, runtime.getNow());
+        await recordTerminalStatus(persistRunLedger ? vaultDb : null, ctx);
+        return { context: ctx, ok: true };
+    }
+    try {
+        await releaseLease(runtime.db, {
+            leaseId: ctx.leaseId,
+            reason: "completed",
+            now: runtime.getNow(),
+        });
+        finishStep(stepRelease, runtime.getNow(), true);
+        finalizeContext(ctx, runtime.getNow(), "completed");
+        await recordStepFinished(persistRunLedger ? vaultDb : null, runId, stepRelease, runtime.getNow());
+        await recordTerminalStatus(persistRunLedger ? vaultDb : null, ctx);
+        return { context: ctx, ok: true };
+    }
+    catch (err) {
+        // Release failure is non-fatal — the auto-expiry sweep on the next
+        // acquireLease() call collects the orphan. Surface the error but
+        // declare the run completed (body + commit succeeded).
+        const msg = err instanceof Error ? err.message : String(err);
+        finishStep(stepRelease, runtime.getNow(), false, msg);
+        await recordStepFinished(persistRunLedger ? vaultDb : null, runId, stepRelease, runtime.getNow());
+        finalizeContext(ctx, runtime.getNow(), "failed_release", msg);
+        await recordTerminalStatus(persistRunLedger ? vaultDb : null, ctx);
+        return { context: ctx, ok: false };
+    }
+}
+// ---------------------------------------------------------------------------
+// Block-B Commit 5 — per-vault automator_runs ledger helpers. All three
+// are no-ops when `vaultDb` is null (no per-vault DB supplied, or dryRun).
+// Each catches its own errors and logs to stderr rather than propagating
+// — the goal is observability, not blocking the protocol path on a logged
+// event write failure. The five-step contract surface (lease + git + body)
+// already drives the user-visible status.
+// ---------------------------------------------------------------------------
+async function recordStepStarted(vaultDb, runId, step, ts) {
+    if (vaultDb === null)
+        return;
+    try {
+        await insertAutomatorRunEvent(vaultDb, {
+            id: newUuidv7Bytes(),
+            runId,
+            ts,
+            level: "info",
+            message: `step.${step.step}.started`,
+        });
+    }
+    catch (err) {
+        // eslint-disable-next-line no-console
+        console.warn(`runFiveStep: recordStepStarted(${step.step}) failed`, err instanceof Error ? err.message : err);
+    }
+}
+async function recordStepFinished(vaultDb, runId, step, ts) {
+    if (vaultDb === null)
+        return;
+    try {
+        const outcome = step.ok === true ? "completed" : "failed";
+        await insertAutomatorRunEvent(vaultDb, {
+            id: newUuidv7Bytes(),
+            runId,
+            ts,
+            level: step.ok === true ? "info" : "error",
+            message: `step.${step.step}.${outcome}`,
+            data: {
+                duration_ms: step.durationMs ?? 0,
+                ...(step.errorSummary !== null ? { error: step.errorSummary } : {}),
+            },
+        });
+    }
+    catch (err) {
+        // eslint-disable-next-line no-console
+        console.warn(`runFiveStep: recordStepFinished(${step.step}) failed`, err instanceof Error ? err.message : err);
+    }
+}
+async function recordTerminalStatus(vaultDb, ctx) {
+    if (vaultDb === null)
+        return;
+    try {
+        await updateAutomatorRunStatus(vaultDb, {
+            id: ctx.runId,
+            status: ctx.status,
+            ...(ctx.endedAt !== null ? { endedAt: ctx.endedAt } : {}),
+            ...(ctx.errorSummary !== null ? { errorSummary: ctx.errorSummary } : {}),
+        });
+    }
+    catch (err) {
+        // eslint-disable-next-line no-console
+        console.warn("runFiveStep: recordTerminalStatus failed", err instanceof Error ? err.message : err);
+    }
+}
+async function releaseOnError(runtime, ctx, reason) {
+    if (runtime.db === undefined || ctx.leaseId === null)
+        return;
+    try {
+        await releaseLease(runtime.db, {
+            leaseId: ctx.leaseId,
+            reason,
+            now: runtime.getNow(),
+        });
+    }
+    catch {
+        // Best-effort cleanup; the auto-expiry sweep is the safety net.
+    }
+}
+//# sourceMappingURL=five-step.js.map

package/dist/protocol/five-step.js.map

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

package/dist/protocol/run-context.d.ts

@@ -0,0 +1,35 @@
+export type LytRunStatus = "pending" | "lease_acquired" | "synced" | "body_running" | "body_completed" | "committed" | "completed" | "failed_lease" | "failed_sync" | "failed_body" | "failed_commit" | "failed_release";
+export interface LytRunStepTiming {
+    step: "acquire" | "sync" | "body" | "commit" | "release";
+    startedAt: number;
+    endedAt: number | null;
+    durationMs: number | null;
+    ok: boolean | null;
+    errorSummary: string | null;
+}
+export interface LytRunContext {
+    runId: Uint8Array;
+    automatorRid: Uint8Array;
+    vaultRid: Uint8Array;
+    vaultPath: string;
+    machineId: string;
+    leaseId: Uint8Array | null;
+    startedAt: number;
+    endedAt: number | null;
+    status: LytRunStatus;
+    steps: LytRunStepTiming[];
+    errorSummary: string | null;
+    bodyResult: unknown;
+}
+export declare function createRunContext(args: {
+    runId: Uint8Array;
+    automatorRid: Uint8Array;
+    vaultRid: Uint8Array;
+    vaultPath: string;
+    machineId: string;
+    startedAt: number;
+}): LytRunContext;
+export declare function startStep(ctx: LytRunContext, step: LytRunStepTiming["step"], now: number): LytRunStepTiming;
+export declare function finishStep(timing: LytRunStepTiming, now: number, ok: boolean, errorSummary?: string | null): void;
+export declare function finalizeContext(ctx: LytRunContext, now: number, status: LytRunStatus, errorSummary?: string | null): void;
+//# sourceMappingURL=run-context.d.ts.map

package/dist/protocol/run-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-context.d.ts","sourceRoot":"","sources":["../../src/protocol/run-context.ts"],"names":[],"mappings":"AAiCA,MAAM,MAAM,YAAY,GACpB,SAAS,GACT,gBAAgB,GAChB,QAAQ,GACR,cAAc,GACd,gBAAgB,GAChB,WAAW,GACX,WAAW,GACX,cAAc,GACd,aAAa,GACb,aAAa,GACb,eAAe,GACf,gBAAgB,CAAC;AAErB,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC;IACzD,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,EAAE,EAAE,OAAO,GAAG,IAAI,CAAC;IACnB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,UAAU,CAAC;IAClB,YAAY,EAAE,UAAU,CAAC;IACzB,QAAQ,EAAE,UAAU,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,UAAU,GAAG,IAAI,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,MAAM,EAAE,YAAY,CAAC;IACrB,KAAK,EAAE,gBAAgB,EAAE,CAAC;IAC1B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAI5B,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE;IACrC,KAAK,EAAE,UAAU,CAAC;IAClB,YAAY,EAAE,UAAU,CAAC;IACzB,QAAQ,EAAE,UAAU,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB,GAAG,aAAa,CAehB;AAED,wBAAgB,SAAS,CACvB,GAAG,EAAE,aAAa,EAClB,IAAI,EAAE,gBAAgB,CAAC,MAAM,CAAC,EAC9B,GAAG,EAAE,MAAM,GACV,gBAAgB,CAWlB;AAED,wBAAgB,UAAU,CACxB,MAAM,EAAE,gBAAgB,EACxB,GAAG,EAAE,MAAM,EACX,EAAE,EAAE,OAAO,EACX,YAAY,GAAE,MAAM,GAAG,IAAW,GACjC,IAAI,CAKN;AAED,wBAAgB,eAAe,CAC7B,GAAG,EAAE,aAAa,EAClB,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,YAAY,EACpB,YAAY,GAAE,MAAM,GAAG,IAAW,GACjC,IAAI,CAIN"}

package/dist/protocol/run-context.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.
+ */
+export function createRunContext(args) {
+    return {
+        runId: args.runId,
+        automatorRid: args.automatorRid,
+        vaultRid: args.vaultRid,
+        vaultPath: args.vaultPath,
+        machineId: args.machineId,
+        leaseId: null,
+        startedAt: args.startedAt,
+        endedAt: null,
+        status: "pending",
+        steps: [],
+        errorSummary: null,
+        bodyResult: undefined,
+    };
+}
+export function startStep(ctx, step, now) {
+    const timing = {
+        step,
+        startedAt: now,
+        endedAt: null,
+        durationMs: null,
+        ok: null,
+        errorSummary: null,
+    };
+    ctx.steps.push(timing);
+    return timing;
+}
+export function finishStep(timing, now, ok, errorSummary = null) {
+    timing.endedAt = now;
+    timing.durationMs = Math.max(0, now - timing.startedAt);
+    timing.ok = ok;
+    timing.errorSummary = errorSummary;
+}
+export function finalizeContext(ctx, now, status, errorSummary = null) {
+    ctx.endedAt = now;
+    ctx.status = status;
+    if (errorSummary !== null)
+        ctx.errorSummary = errorSummary;
+}
+//# sourceMappingURL=run-context.js.map

package/dist/protocol/run-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-context.js","sourceRoot":"","sources":["../../src/protocol/run-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AA4DH,MAAM,UAAU,gBAAgB,CAAC,IAOhC;IACC,OAAO;QACL,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,OAAO,EAAE,IAAI;QACb,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,OAAO,EAAE,IAAI;QACb,MAAM,EAAE,SAAS;QACjB,KAAK,EAAE,EAAE;QACT,YAAY,EAAE,IAAI;QAClB,UAAU,EAAE,SAAS;KACtB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,SAAS,CACvB,GAAkB,EAClB,IAA8B,EAC9B,GAAW;IAEX,MAAM,MAAM,GAAqB;QAC/B,IAAI;QACJ,SAAS,EAAE,GAAG;QACd,OAAO,EAAE,IAAI;QACb,UAAU,EAAE,IAAI;QAChB,EAAE,EAAE,IAAI;QACR,YAAY,EAAE,IAAI;KACnB,CAAC;IACF,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACvB,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,UAAU,CACxB,MAAwB,EACxB,GAAW,EACX,EAAW,EACX,eAA8B,IAAI;IAElC,MAAM,CAAC,OAAO,GAAG,GAAG,CAAC;IACrB,MAAM,CAAC,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC;IACxD,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC;IACf,MAAM,CAAC,YAAY,GAAG,YAAY,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,GAAkB,EAClB,GAAW,EACX,MAAoB,EACpB,eAA8B,IAAI;IAElC,GAAG,CAAC,OAAO,GAAG,GAAG,CAAC;IAClB,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC;IACpB,IAAI,YAAY,KAAK,IAAI;QAAE,GAAG,CAAC,YAAY,GAAG,YAAY,CAAC;AAC7D,CAAC"}

package/dist/runtime.d.ts

@@ -0,0 +1,18 @@
+import type { Client } from "@libsql/client";
+import type { LlmGateway } from "@younndai/lyt-llm";
+export interface LytRuntime {
+    db: Client | undefined;
+    vaultPath: string | undefined;
+    machineId: string;
+    llmGateway: LlmGateway | undefined;
+    getNow: () => number;
+}
+export interface LytRuntimeConfig {
+    db?: Client;
+    vaultPath?: string;
+    machineId: string;
+    llmGateway?: LlmGateway;
+    getNow?: () => number;
+}
+export declare function createLytRuntime(config: LytRuntimeConfig): LytRuntime;
+//# sourceMappingURL=runtime.d.ts.map

package/dist/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAsCA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,GAAG,SAAS,CAAC;IACvB,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,UAAU,GAAG,SAAS,CAAC;IACnC,MAAM,EAAE,MAAM,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,UAAU,CAAC;IAGxB,MAAM,CAAC,EAAE,MAAM,MAAM,CAAC;CACvB;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,GAAG,UAAU,CAWrE"}

package/dist/runtime.js

@@ -0,0 +1,28 @@
+/*
+ * 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 function createLytRuntime(config) {
+    if (typeof config.machineId !== "string" || config.machineId.length === 0) {
+        throw new Error("createLytRuntime: machineId is required and must be non-empty");
+    }
+    return {
+        db: config.db,
+        vaultPath: config.vaultPath,
+        machineId: config.machineId,
+        llmGateway: config.llmGateway,
+        getNow: config.getNow ?? (() => Date.now()),
+    };
+}
+//# sourceMappingURL=runtime.js.map

package/dist/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AA6CH,MAAM,UAAU,gBAAgB,CAAC,MAAwB;IACvD,IAAI,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ,IAAI,MAAM,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1E,MAAM,IAAI,KAAK,CAAC,+DAA+D,CAAC,CAAC;IACnF,CAAC;IACD,OAAO;QACL,EAAE,EAAE,MAAM,CAAC,EAAE;QACb,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;KAC5C,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,74 @@
+{
+  "name": "@younndai/lyt-runner",
+  "version": "0.9.0",
+  "description": "Lyt automation runner — a thin layer on @younndai/yon-runner that expands declarative @AUTOMATOR + @DIRECTIVE records into core YON before execution and registers the vault-aware std:vault.* + std:mesh.* + std:lease.* ops.",
+  "homepage": "https://linkyourthink.com",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/younndai/lyt",
+    "directory": "packages/lyt-runner"
+  },
+  "author": {
+    "name": "MARLINK TRADING SRL (YounndAI)",
+    "url": "https://younndai.com"
+  },
+  "contributors": [
+    {
+      "name": "Alexandru Mareș",
+      "url": "https://allemaar.com"
+    }
+  ],
+  "license": "Apache-2.0",
+  "engines": {
+    "node": ">=20.9",
+    "npm": ">=10"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "NOTICE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "clean": "rimraf --glob dist .turbo *.tsbuildinfo",
+    "prepack": "npm run clean && npm run build",
+    "prepublishOnly": "node ../../scripts/check-no-vendored-deps.mjs --root ../.."
+  },
+  "dependencies": {
+    "@younndai/yon-runner": "^2.0.0",
+    "@younndai/yon-parser": "^2.0.0",
+    "@younndai/lyt-vault": "^0.9.0",
+    "@younndai/lyt-llm": "^0.9.0",
+    "@libsql/client": "^0.15.15"
+  },
+  "devDependencies": {
+    "@lyt/typescript-config": "*",
+    "@types/node": "^22.10.5",
+    "rimraf": "*",
+    "typescript": "*",
+    "vitest": "*"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "lyt",
+    "runner",
+    "yon",
+    "automator",
+    "younndai"
+  ]
+}