@corenel/harness 0.10.0 → 0.12.0

package/dist/audit/recorder.js

@@ -0,0 +1,185 @@
+import { argsHash } from './canonical.js';
+import { newSpanId, newTraceId } from './ids.js';
+/** Loop stop-reason assignments (packages/harness/core/loop.ts), the sidecar
+ * executor's 'budget' override (packages/sidecar/src/runner/executor.ts), and
+ * the provider finish reasons the loop passes through verbatim as
+ * `streamed.finishReason` -- recorded rather than bucketed, per review.
+ * Anything else (an arbitrary caller-supplied outcome) becomes 'other' so
+ * free text can never smuggle content into the log. */
+const OUTCOMES = new Set([
+    'stop', 'aborted', 'policy', 'error', 'stuck', 'max_turns', 'budget',
+    'length', 'tool_calls', 'end_turn', 'content_filter',
+]);
+const safeOutcome = (s) => (OUTCOMES.has(s) ? s : 'other');
+/** Tool names that delegate to another agent. A callee spawned while one of
+ * these is open on its spawning frame nests under THAT call's span; see
+ * AgentFrame.openDelegation. */
+const DELEGATION_TOOLS = new Set(['call_agent', 'spawn_agent', 'spawn_agents']);
+export function createAuditRecorder(opts) {
+    const now = opts.now ?? (() => Date.now());
+    const ids = opts.ids ?? { trace: newTraceId, span: newSpanId };
+    const hash = opts.hash ?? argsHash;
+    const trace = ids.trace();
+    const base = { v: 1, trace, host: opts.ctx.host, ...(opts.ctx.session ? { session: opts.ctx.session } : {}), ...(opts.ctx.run ? { run: opts.ctx.run } : {}) };
+    const iso = () => new Date(now()).toISOString();
+    /** Never let a caller-supplied `emit` break the recorder: a throw is
+     * caught and swallowed on the spot, per call -- there is no retry or
+     * fallback re-emit, so a failing emit can never double-emit a line under a
+     * different payload. */
+    const safeEmit = (d) => {
+        try {
+            opts.emit(d);
+        }
+        catch { /* swallowed: an emit failure is the host's problem, never the run's */ }
+    };
+    const root = { span: ids.span(), agent: opts.ctx.agent, started: now(), turn: 0, depth: 0, tools: new Map() };
+    const children = new Map();
+    let finished = false;
+    const agentOf = (f) => (f.agent ? { agent: f.agent } : {});
+    const draft = (f, d) => ({ ...base, ts: iso(), ...agentOf(f), ...(f.turn ? { turn: f.turn } : {}), ...d });
+    /** Every public call is queued here so the emitted order always matches
+     * call order, even across an async hash (see the module comment). A step
+     * that throws (should never happen -- every emit already goes through
+     * `safeEmit`) is swallowed too: a bad step must never break the chain for
+     * whatever was queued after it, and must never surface as an unhandled
+     * rejection. */
+    let chain = Promise.resolve();
+    const enqueue = (step) => {
+        chain = chain.then(async () => { try {
+            await step();
+        }
+        catch { /* swallowed, see above */ } });
+    };
+    safeEmit(draft(root, { span: root.span, kind: 'invoke_agent', phase: 'start',
+        ...(opts.ctx.agent ? { 'gen_ai.agent.name': opts.ctx.agent } : {}),
+        ...(opts.ctx.model ? { 'gen_ai.request.model': opts.ctx.model } : {}) }));
+    async function toolCallStep(f, e) {
+        const span = ids.span();
+        f.tools.set(e.id, { span, started: now(), name: e.name });
+        if (DELEGATION_TOOLS.has(e.name))
+            f.openDelegation = { span, callId: e.id };
+        let h;
+        try {
+            h = await hash(e.args);
+        }
+        catch {
+            h = 'unhashable';
+        }
+        safeEmit(draft(f, { span, parent: f.span, kind: 'execute_tool', phase: 'start',
+            'gen_ai.tool.name': e.name, 'gen_ai.tool.call.id': e.id, argsHash: h }));
+    }
+    function toolResultStep(f, e) {
+        // Clear the open-delegation marker on ITS call's result regardless of
+        // whether a callee ever actually spawned (e.g. call_agent refused before
+        // reaching ctx.spawn) -- otherwise a dead marker would wrongly parent the
+        // next, unrelated spawn on this frame.
+        if (f.openDelegation?.callId === e.id)
+            f.openDelegation = undefined;
+        const t = f.tools.get(e.id);
+        if (!t)
+            return;
+        f.tools.delete(e.id);
+        const status = e.isError ? 'failed' : 'completed';
+        safeEmit(draft(f, { span: t.span, parent: f.span, kind: 'execute_tool', phase: 'end',
+            'gen_ai.tool.name': t.name, 'gen_ai.tool.call.id': e.id, status, durMs: e.durationMs ?? now() - t.started }));
+    }
+    function usageStep(f, e) {
+        safeEmit(draft(f, { span: ids.span(), parent: f.span, kind: 'chat', phase: 'point',
+            ...(e.model ? { 'gen_ai.request.model': e.model } : {}),
+            'gen_ai.usage.input_tokens': e.usage.promptTokens, 'gen_ai.usage.output_tokens': e.usage.completionTokens }));
+    }
+    async function onAgentEventStep(f, e) {
+        if (finished)
+            return;
+        if (e.type === 'turn') {
+            f.turn = e.turn;
+            return;
+        }
+        if (e.type === 'tool-call') {
+            await toolCallStep(f, e);
+            return;
+        }
+        if (e.type === 'tool-result') {
+            toolResultStep(f, e);
+            return;
+        }
+        if (e.type === 'usage') {
+            usageStep(f, e);
+            return;
+        }
+    }
+    function closeChildStep(nodeId, outcome) {
+        const c = children.get(nodeId);
+        if (!c)
+            return;
+        children.delete(nodeId);
+        safeEmit(draft(c, { span: c.span, ...(c.parent ? { parent: c.parent } : {}), kind: 'invoke_agent', phase: 'end', outcome, durMs: now() - c.started }));
+    }
+    /** Resolve which frame SPAWNED this child (by `parentId`, falling back to
+     * root when it names no live child -- e.g. the root's own node id, or a
+     * frame that already closed), then nest the child under that frame's
+     * currently open delegation-tool span, or the frame's own span otherwise.
+     * A node-start with no `parentId` at all is the host's own synthetic root
+     * marker (workerHandler.ts's 'Session' start) -- not a delegation, so it is
+     * ignored: the recorder already has its own `root`. */
+    function nodeStartStep(e) {
+        if (e.parentId === undefined)
+            return;
+        const spawningFrame = children.get(e.parentId) ?? root;
+        const parentSpan = spawningFrame.openDelegation?.span ?? spawningFrame.span;
+        const c = { span: ids.span(), parent: parentSpan, ...(e.agentName ? { agent: e.agentName } : {}), started: now(), turn: 0, depth: spawningFrame.depth + 1, tools: new Map() };
+        children.set(e.nodeId, c);
+        safeEmit(draft(c, { span: c.span, parent: c.parent, kind: 'invoke_agent', phase: 'start', ...(e.agentName ? { 'gen_ai.agent.name': e.agentName } : {}) }));
+    }
+    return {
+        trace,
+        whenIdle: () => chain,
+        onEvent(e) { enqueue(() => onAgentEventStep(root, e)); },
+        onNodeEvent(e) {
+            enqueue(async () => {
+                if (finished)
+                    return;
+                if (e.type === 'node-start') {
+                    nodeStartStep(e);
+                    return;
+                }
+                if (e.type === 'node-event') {
+                    const c = children.get(e.nodeId);
+                    if (c)
+                        await onAgentEventStep(c, e.event);
+                    return;
+                }
+                if (e.type === 'node-done') {
+                    closeChildStep(e.nodeId, safeOutcome(e.output.stopReason));
+                    return;
+                }
+                if (e.type === 'node-error')
+                    closeChildStep(e.nodeId, 'error');
+            });
+        },
+        onDecision(e) {
+            enqueue(() => {
+                if (finished)
+                    return;
+                const f = (e.nodeId ? children.get(e.nodeId) : undefined) ?? root;
+                safeEmit(draft(f, { span: ids.span(), parent: f.span, kind: 'permission', phase: 'point',
+                    'gen_ai.tool.name': e.subject.name, level: e.level, decision: e.decision,
+                    decidedBy: e.by, ...(e.policy ? { policy: e.policy } : {}) }));
+            });
+        },
+        finish(outcome) {
+            enqueue(() => {
+                if (finished)
+                    return;
+                finished = true;
+                // Deepest callee first: closing a parent before its still-open child
+                // would read as though the child outlived it.
+                const order = [...children.entries()].sort((a, b) => b[1].depth - a[1].depth).map(([id]) => id);
+                for (const id of order)
+                    closeChildStep(id, 'aborted');
+                safeEmit(draft(root, { span: root.span, kind: 'invoke_agent', phase: 'end', outcome: safeOutcome(outcome), durMs: now() - root.started }));
+            });
+        },
+    };
+}
+//# sourceMappingURL=recorder.js.map

package/dist/audit/recorder.js.map

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

package/dist/audit/runAudit.d.ts

@@ -0,0 +1,38 @@
+import type { AgentEvent, AuditSettings, DecisionEvent, NodeEvent } from '@corenel/protocol';
+import { type AuditRunContext } from './recorder';
+import type { AuditLog } from './log';
+/** The host side of the audit bridge. The host owns the log (one writer per
+ * location), so `logFor` must hand back the SAME AuditLog for the same
+ * location on every run; a run never creates one. */
+export interface AuditBridgeHost {
+    /** A log for this run's location, or null when auditing is off or unavailable. */
+    logFor(ctx: {
+        session?: string;
+    }): Promise<AuditLog | null>;
+    settings(): AuditSettings;
+}
+/** How long a finished run may wait for its audit lines to be written before
+ * it resolves anyway. */
+export declare const AUDIT_FINISH_BOUND_MS = 5000;
+/** The event a run emits when its audit lost lines or could not confirm them. */
+export type AuditIncompleteEvent = Extract<AgentEvent, {
+    type: 'audit-incomplete';
+}>;
+export interface RunAudit {
+    onEvent(e: AgentEvent): void;
+    onNodeEvent(e: NodeEvent): void;
+    onDecision(e: DecisionEvent): void;
+    /** Close the run's lines, wait for them to be written and flush the log.
+     * Never rejects and resolves within AUDIT_FINISH_BOUND_MS. Returns the
+     * `audit-incomplete` event to surface, or null when nothing was lost. */
+    finish(outcome: string): Promise<AuditIncompleteEvent | null>;
+}
+/** Start a run's audit, or null when there is no host. The recorder writes
+ * its first line at once, before the host's log (async) can arrive, so lines
+ * are buffered until it resolves, then drained in order (see RunAuditState).
+ * A `logFor` that throws or rejects means auditing was wanted and failed, so
+ * every line counts as lost. Nothing here can fail the run. */
+export declare function startRunAudit(host: AuditBridgeHost | null, ctx: AuditRunContext & {
+    run: string;
+}): RunAudit | null;
+//# sourceMappingURL=runAudit.d.ts.map

package/dist/audit/runAudit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runAudit.d.ts","sourceRoot":"","sources":["../../audit/runAudit.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,UAAU,EAAc,aAAa,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACzG,OAAO,EAA2C,KAAK,eAAe,EAAE,MAAM,YAAY,CAAC;AAC3F,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAEtC;;qDAEqD;AACrD,MAAM,WAAW,eAAe;IAC9B,kFAAkF;IAClF,MAAM,CAAC,GAAG,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC;IAC5D,QAAQ,IAAI,aAAa,CAAC;CAC3B;AAED;yBACyB;AACzB,eAAO,MAAM,qBAAqB,OAAO,CAAC;AAE1C,iFAAiF;AACjF,MAAM,MAAM,oBAAoB,GAAG,OAAO,CAAC,UAAU,EAAE;IAAE,IAAI,EAAE,kBAAkB,CAAA;CAAE,CAAC,CAAC;AAErF,MAAM,WAAW,QAAQ;IACvB,OAAO,CAAC,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;IAC7B,WAAW,CAAC,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC;IAChC,UAAU,CAAC,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;IACnC;;6EAEyE;IACzE,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAAC;CAC/D;AAuCD;;;;+DAI+D;AAC/D,wBAAgB,aAAa,CAAC,IAAI,EAAE,eAAe,GAAG,IAAI,EAAE,GAAG,EAAE,eAAe,GAAG;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,QAAQ,GAAG,IAAI,CA+DnH"}

package/dist/audit/runAudit.js

@@ -0,0 +1,99 @@
+import { createAuditRecorder } from './recorder.js';
+/** How long a finished run may wait for its audit lines to be written before
+ * it resolves anyway. */
+export const AUDIT_FINISH_BOUND_MS = 5000;
+/** What a run's audit lost, once its lines have been written (or not). */
+function auditLoss(state, timedOut) {
+    if (!state.settled) {
+        // The log never arrived (only the bound gets here): everything buffered
+        // is lost, and so is every line after this -- the count is a lower
+        // bound, so the finish is also unconfirmed.
+        const lost = state.pending?.length ?? 0;
+        state.pending = null;
+        state.released = true;
+        return { lost, unconfirmed: true };
+    }
+    if (state.failed)
+        return { lost: state.pending?.length ?? 0 };
+    if (!state.log)
+        return null;
+    const lost = Math.max(0, state.log.lost() - state.baseline);
+    return timedOut ? { lost, unconfirmed: true } : { lost };
+}
+/** Start a run's audit, or null when there is no host. The recorder writes
+ * its first line at once, before the host's log (async) can arrive, so lines
+ * are buffered until it resolves, then drained in order (see RunAuditState).
+ * A `logFor` that throws or rejects means auditing was wanted and failed, so
+ * every line counts as lost. Nothing here can fail the run. */
+export function startRunAudit(host, ctx) {
+    if (!host)
+        return null;
+    const state = { settled: false, log: null, failed: false, released: false, pending: [], baseline: 0 };
+    const ready = Promise.resolve()
+        .then(() => host.logFor({ session: ctx.session }))
+        .then((l) => {
+        if (state.released)
+            return;
+        state.settled = true;
+        if (!l) {
+            state.pending = null;
+            return;
+        }
+        state.baseline = l.lost();
+        state.log = l;
+        const buffered = state.pending ?? [];
+        state.pending = null;
+        for (const d of buffered)
+            l.append(d);
+    }, () => { state.settled = true; state.failed = true; })
+        .catch(() => { state.settled = true; state.failed = true; });
+    const recorder = createAuditRecorder({
+        ctx: {
+            host: ctx.host, run: ctx.run,
+            ...(ctx.session ? { session: ctx.session } : {}),
+            ...(ctx.agent ? { agent: ctx.agent } : {}),
+            ...(ctx.model ? { model: ctx.model } : {}),
+        },
+        emit: (d) => {
+            if (state.released)
+                return;
+            if (state.pending)
+                state.pending.push(d);
+            else
+                state.log?.append(d);
+        },
+    });
+    return {
+        onEvent: (e) => recorder.onEvent(e),
+        onNodeEvent: (e) => recorder.onNodeEvent(e),
+        onDecision: (e) => recorder.onDecision(e),
+        /* The whole sequence is bounded by AUDIT_FINISH_BOUND_MS and never
+         * rejects, so it can neither fail the run nor hold it longer than the
+         * bound. A sequence cut off by the bound still reports: the buffered lines
+         * as lost when the log never arrived (a lower bound, so `unconfirmed`
+         * too), else just `unconfirmed` (whenIdle or flush hung). */
+        async finish(outcome) {
+            let timer;
+            const deadline = new Promise((r) => { timer = setTimeout(() => r('timeout'), AUDIT_FINISH_BOUND_MS); });
+            try {
+                recorder.finish(outcome);
+                const written = (async () => {
+                    await recorder.whenIdle();
+                    await ready;
+                    await state.log?.flush();
+                    return 'written';
+                })().catch(() => 'written');
+                const how = await Promise.race([written, deadline]);
+                const loss = auditLoss(state, how === 'timeout');
+                return loss && (loss.lost > 0 || loss.unconfirmed) ? { type: 'audit-incomplete', ...loss } : null;
+            }
+            catch {
+                return null; // swallowed: the audit must never fail or delay a run
+            }
+            finally {
+                clearTimeout(timer);
+            }
+        },
+    };
+}
+//# sourceMappingURL=runAudit.js.map

package/dist/audit/runAudit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runAudit.js","sourceRoot":"","sources":["../../audit/runAudit.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,mBAAmB,EAA4C,MAAM,YAAY,CAAC;AAY3F;yBACyB;AACzB,MAAM,CAAC,MAAM,qBAAqB,GAAG,IAAI,CAAC;AAmC1C,0EAA0E;AAC1E,SAAS,SAAS,CAAC,KAAoB,EAAE,QAAiB;IACxD,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;QACnB,wEAAwE;QACxE,mEAAmE;QACnE,4CAA4C;QAC5C,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC,CAAC;QACxC,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC;QACrB,KAAK,CAAC,QAAQ,GAAG,IAAI,CAAC;QACtB,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;IACrC,CAAC;IACD,IAAI,KAAK,CAAC,MAAM;QAAE,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC,EAAE,CAAC;IAC9D,IAAI,CAAC,KAAK,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC;IAC5B,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC5D,OAAO,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;AAC3D,CAAC;AAED;;;;+DAI+D;AAC/D,MAAM,UAAU,aAAa,CAAC,IAA4B,EAAE,GAAsC;IAChG,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IACvB,MAAM,KAAK,GAAkB,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;IACrH,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,EAAE;SAC5B,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;SACjD,IAAI,CACH,CAAC,CAAC,EAAE,EAAE;QACJ,IAAI,KAAK,CAAC,QAAQ;YAAE,OAAO;QAC3B,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC;QACrB,IAAI,CAAC,CAAC,EAAE,CAAC;YAAC,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC;YAAC,OAAO;QAAC,CAAC;QACzC,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;QAC1B,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC;QACd,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC;QACrC,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC;QACrB,KAAK,MAAM,CAAC,IAAI,QAAQ;YAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IACxC,CAAC,EACD,GAAG,EAAE,GAAG,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,CACrD;SACA,KAAK,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/D,MAAM,QAAQ,GAAkB,mBAAmB,CAAC;QAClD,GAAG,EAAE;YACH,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG;YAC5B,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAChD,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC1C,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC3C;QACD,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE;YACV,IAAI,KAAK,CAAC,QAAQ;gBAAE,OAAO;YAC3B,IAAI,KAAK,CAAC,OAAO;gBAAE,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;;gBACpC,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;QAC5B,CAAC;KACF,CAAC,CAAC;IAEH,OAAO;QACL,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;QACnC,WAAW,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC;QAC3C,UAAU,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC;QACzC;;;;qEAI6D;QAC7D,KAAK,CAAC,MAAM,CAAC,OAAO;YAClB,IAAI,KAAgD,CAAC;YACrD,MAAM,QAAQ,GAAG,IAAI,OAAO,CAAY,CAAC,CAAC,EAAE,EAAE,GAAG,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,qBAAqB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACnH,IAAI,CAAC;gBACH,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;gBACzB,MAAM,OAAO,GAAG,CAAC,KAAK,IAAwB,EAAE;oBAC9C,MAAM,QAAQ,CAAC,QAAQ,EAAE,CAAC;oBAC1B,MAAM,KAAK,CAAC;oBACZ,MAAM,KAAK,CAAC,GAAG,EAAE,KAAK,EAAE,CAAC;oBACzB,OAAO,SAAS,CAAC;gBACnB,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAkB,CAAC,CAAC;gBACrC,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;gBACpD,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,EAAE,GAAG,KAAK,SAAS,CAAC,CAAC;gBACjD,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,IAAI,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,kBAAkB,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;YACpG,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,IAAI,CAAC,CAAC,sDAAsD;YACrE,CAAC;oBAAS,CAAC;gBACT,YAAY,CAAC,KAAK,CAAC,CAAC;YACtB,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/audit/verify.d.ts

@@ -0,0 +1,14 @@
+import type { AuditHost, FileService } from '@corenel/protocol';
+export type ChainResult = {
+    ok: true;
+    lines: number;
+} | {
+    ok: false;
+    at: {
+        file: string;
+        line: number;
+    };
+    reason: 'prev-mismatch' | 'missing-segment' | 'unparseable';
+};
+export declare function verifyAuditChain(files: FileService, root: string, host: AuditHost, writerId?: string): Promise<ChainResult>;
+//# sourceMappingURL=verify.d.ts.map

package/dist/audit/verify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify.d.ts","sourceRoot":"","sources":["../../audit/verify.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGhE,MAAM,MAAM,WAAW,GACnB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC3B;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,EAAE,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAAC,MAAM,EAAE,eAAe,GAAG,iBAAiB,GAAG,aAAa,CAAA;CAAE,CAAC;AAEnH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,CAAC,EAAE,MAAM,GACnE,OAAO,CAAC,WAAW,CAAC,CA0CtB"}

package/dist/audit/verify.js

@@ -0,0 +1,47 @@
+import { activeSegmentName, auditFileNames, lineHash, sortedAuditArchives } from './log.js';
+export async function verifyAuditChain(files, root, host, writerId) {
+    const names = auditFileNames(await files.list(root));
+    const archives = sortedAuditArchives(names, host, writerId);
+    const order = [...archives];
+    const active = activeSegmentName(host, writerId);
+    if (names.includes(active))
+        order.push({ name: active });
+    let prevHash = null;
+    let total = 0;
+    for (let f = 0; f < order.length; f++) {
+        const seg = order[f];
+        const file = `${root}/${seg.name}`;
+        const before = f > 0 ? order[f - 1] : null;
+        if (before && seg.date !== undefined && before.date === seg.date && seg.n !== (before.n ?? 0) + 1) {
+            return { ok: false, at: { file, line: 1 }, reason: 'missing-segment' };
+        }
+        const raw = (await files.read(file)).split('\n');
+        /* A well-formed segment ends with '\n', leaving one empty tail element;
+         * anything else in that last slot is a torn line. */
+        if (raw.length && raw[raw.length - 1] === '')
+            raw.pop();
+        let first = true;
+        for (let i = 0; i < raw.length; i++) {
+            const line = raw[i];
+            let parsed;
+            try {
+                parsed = JSON.parse(line);
+            }
+            catch {
+                return { ok: false, at: { file, line: i + 1 }, reason: 'unparseable' };
+            }
+            if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
+                return { ok: false, at: { file, line: i + 1 }, reason: 'unparseable' };
+            }
+            const prev = parsed.prev;
+            if (prevHash !== null && prev !== prevHash) {
+                return { ok: false, at: { file, line: i + 1 }, reason: first ? 'missing-segment' : 'prev-mismatch' };
+            }
+            prevHash = await lineHash(line);
+            first = false;
+            total += 1;
+        }
+    }
+    return { ok: true, lines: total };
+}
+//# sourceMappingURL=verify.js.map

package/dist/audit/verify.js.map

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

package/dist/conversation.d.ts

@@ -1,10 +1,19 @@
 import type { ChatCompletionMessageParam } from 'openai/resources/chat/completions';
+import type { TurnVerification } from '@corenel/protocol';
 /** Per-turn telemetry shown under an assistant turn (tokens / cost / wall-clock). */
 export interface TurnStats {
+    /** Prompt tokens summed over every model call in the turn -- what was billed,
+     * NOT the context size (each call resends the whole prompt). */
     inTok: number;
     outTok: number;
     cost: number;
     ms: number;
+    /** The largest single request's prompt tokens: the context the turn occupied. */
+    ctxTok?: number;
+    /** Of `inTok`, how many the provider served from its prompt cache. */
+    cachedTok?: number;
+    /** Model calls the turn made. */
+    calls?: number;
 }
 /** One assistant conversation turn — the live-buffer data shape. Owned by the
  * kernel (the UI Transcript renders it; runtime/AgentPanel pass it around). */
@@ -20,6 +29,16 @@ export interface ConversationTurn {
      * about the conversation in front of you, and because the file only exists
      * for a run that had a session to write beside. Absent on every other turn. */
     checkpoint?: string;
+    /** What the turn's mutating tool calls OBSERVABLY changed, from the loop's
+     * `turn-verified` event. Runtime data shown beside the reply; absent when the
+     * turn made no mutating calls. */
+    verification?: TurnVerification;
+    /** Set when the run's audit log lost entries, or could not confirm them
+     * written (the run's `audit-incomplete` event). Absent otherwise. */
+    auditIncomplete?: {
+        lost: number;
+        unconfirmed?: boolean;
+    };
 }
 /** Is this turn a COMPACTION SEAM rather than something said?
  *
@@ -30,4 +49,16 @@ export interface ConversationTurn {
  * reports (a seam is an unsent note; counting it would inflate the very number
  * the panel exists to give), and the runtime writes them. */
 export declare function isCheckpointTurn(t: ConversationTurn): boolean;
+/**
+ * A stored session's `messages` as conversation turns.
+ *
+ * TWO SHAPES REACH THIS. A browser session stores `ConversationTurn[]` (nested:
+ * each entry has its own `messages`), while a daemon run and a delegated
+ * subagent's saved session store the flat `{ role, content }` list. Casting the
+ * flat list to turns made every turn's `messages` undefined, and the chat threw
+ * on the first render that read one. Flat messages are grouped into turns, one
+ * per user message (anything before the first user message forms its own turn).
+ * Anything that is not an object is dropped.
+ */
+export declare function turnsFromSessionMessages(raw: unknown): ConversationTurn[];
 //# sourceMappingURL=conversation.d.ts.map

package/dist/conversation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"conversation.d.ts","sourceRoot":"","sources":["../conversation.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,mCAAmC,CAAC;AAGpF,qFAAqF;AACrF,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;CACZ;AAED;+EAC+E;AAC/E,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,0BAA0B,EAAE,CAAC;IACvC,4EAA4E;IAC5E,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB;;;;mFAI+E;IAC/E,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;6DAO6D;AAC7D,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAG7D"}
+{"version":3,"file":"conversation.d.ts","sourceRoot":"","sources":["../conversation.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,mCAAmC,CAAC;AACpF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAG1D,qFAAqF;AACrF,MAAM,WAAW,SAAS;IACxB;oEACgE;IAChE,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,iFAAiF;IACjF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iCAAiC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;+EAC+E;AAC/E,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,0BAA0B,EAAE,CAAC;IACvC,4EAA4E;IAC5E,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB;;;;mFAI+E;IAC/E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;sCAEkC;IAClC,YAAY,CAAC,EAAE,gBAAgB,CAAC;IAChC;yEACqE;IACrE,eAAe,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;CAC3D;AAED;;;;;;;6DAO6D;AAC7D,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAG7D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,OAAO,GAAG,gBAAgB,EAAE,CAmBzE"}

package/dist/conversation.js

@@ -11,4 +11,37 @@ export function isCheckpointTurn(t) {
     const first = t.messages[0];
     return typeof first?.content === 'string' && first.content.startsWith(CHECKPOINT_MARKER);
 }
+/**
+ * A stored session's `messages` as conversation turns.
+ *
+ * TWO SHAPES REACH THIS. A browser session stores `ConversationTurn[]` (nested:
+ * each entry has its own `messages`), while a daemon run and a delegated
+ * subagent's saved session store the flat `{ role, content }` list. Casting the
+ * flat list to turns made every turn's `messages` undefined, and the chat threw
+ * on the first render that read one. Flat messages are grouped into turns, one
+ * per user message (anything before the first user message forms its own turn).
+ * Anything that is not an object is dropped.
+ */
+export function turnsFromSessionMessages(raw) {
+    if (!Array.isArray(raw))
+        return [];
+    const items = raw.filter((m) => !!m && typeof m === 'object');
+    if (items.every((m) => Array.isArray(m.messages)))
+        return items;
+    const turns = [];
+    let current = null;
+    items.forEach((m, i) => {
+        if (Array.isArray(m.messages)) {
+            current = null;
+            turns.push(m);
+            return;
+        }
+        if (!current || m.role === 'user') {
+            current = { id: `stored-${i}`, included: true, messages: [] };
+            turns.push(current);
+        }
+        current.messages.push(m);
+    });
+    return turns;
+}
 //# sourceMappingURL=conversation.js.map

package/dist/conversation.js.map

@@ -1 +1 @@
-{"version":3,"file":"conversation.js","sourceRoot":"","sources":["../conversation.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AA0B1D;;;;;;;6DAO6D;AAC7D,MAAM,UAAU,gBAAgB,CAAC,CAAmB;IAClD,MAAM,KAAK,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IAC5B,OAAO,OAAO,KAAK,EAAE,OAAO,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAC;AAC3F,CAAC"}
+{"version":3,"file":"conversation.js","sourceRoot":"","sources":["../conversation.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAyC1D;;;;;;;6DAO6D;AAC7D,MAAM,UAAU,gBAAgB,CAAC,CAAmB;IAClD,MAAM,KAAK,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IAC5B,OAAO,OAAO,KAAK,EAAE,OAAO,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAC;AAC3F,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,wBAAwB,CAAC,GAAY;IACnD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,CAAC;IACnC,MAAM,KAAK,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAgC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC;IAC5F,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;QAAE,OAAO,KAAsC,CAAC;IACjG,MAAM,KAAK,GAAuB,EAAE,CAAC;IACrC,IAAI,OAAO,GAA4B,IAAI,CAAC;IAC5C,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACrB,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC9B,OAAO,GAAG,IAAI,CAAC;YACf,KAAK,CAAC,IAAI,CAAC,CAAgC,CAAC,CAAC;YAC7C,OAAO;QACT,CAAC;QACD,IAAI,CAAC,OAAO,IAAI,CAAC,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YAClC,OAAO,GAAG,EAAE,EAAE,EAAE,UAAU,CAAC,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;YAC9D,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACtB,CAAC;QACD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAA0C,CAAC,CAAC;IACpE,CAAC,CAAC,CAAC;IACH,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/core/hash.d.ts

@@ -0,0 +1,2 @@
+export declare function sha256Hex(text: string): Promise<string>;
+//# sourceMappingURL=hash.d.ts.map

package/dist/core/hash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.d.ts","sourceRoot":"","sources":["../../core/hash.ts"],"names":[],"mappings":"AAGA,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAI7D"}

package/dist/core/hash.js

@@ -0,0 +1,9 @@
+/* sha-256 as lowercase hex, for the turn verifier's before/after comparison.
+ * WebCrypto, so the same code runs in the browser worker and in Node >= 19
+ * (the sidecar), which is why it lives in the kernel rather than in src/lib. */
+export async function sha256Hex(text) {
+    const bytes = new TextEncoder().encode(text);
+    const digest = await globalThis.crypto.subtle.digest('SHA-256', bytes);
+    return Array.from(new Uint8Array(digest), (b) => b.toString(16).padStart(2, '0')).join('');
+}
+//# sourceMappingURL=hash.js.map

package/dist/core/hash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.js","sourceRoot":"","sources":["../../core/hash.ts"],"names":[],"mappings":"AAAA;;gFAEgF;AAChF,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,IAAY;IAC1C,MAAM,KAAK,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC7C,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IACvE,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAC7F,CAAC"}

package/dist/core/loop.d.ts

@@ -5,6 +5,7 @@ import { type RecoveryConfig } from './recovery';
 import type { Policy } from '@corenel/protocol';
 import type { PermissionService } from '../guardrail/permission-service';
 import { type CompressionConfig } from '../compression';
+import { type SkillEntry } from '../tools/skillTool';
 export interface RunAgentArgs {
     client: OpenAI;
     model: string;
@@ -22,12 +23,21 @@ export interface RunAgentArgs {
     /** Deferred tool names this conversation loaded on earlier runs. Names no
      *  longer among `deferredTools` are dropped and reported via `tools-loaded`. */
     loadedTools?: string[];
+    /** Enabled skills, read in full by the host. When non-empty the system prompt
+     *  gains a one-line-per-skill index and the run gains `use_skill`, which
+     *  returns a body on demand (tools/skillTool.ts) -- bodies never ride every
+     *  request. Data rather than file access, because a run does not always
+     *  execute where the skill files can be read (the browser worker). */
+    skills?: SkillEntry[];
     toolCtx: ToolContext;
     maxTurns?: number;
     /** Governance policy for the run (guardrail gates). Defaults to STANDARD_POLICY. */
     policy?: Policy;
     /** Per-tool permission resolver. When omitted, tools run without an approval gate. */
     permission?: PermissionService;
+    /** The spawned child this run is, stamped onto every permission decision it
+     * reports (`DecisionEvent.nodeId`). Absent for a root run. */
+    decisionNodeId?: string;
     /** Customize the tool-result text a refused tool call gets. The kernel is
      * host-agnostic and cannot know WHY a decision came back "deny" — a real
      * person declining an interactive prompt, and a non-interactive host that
@@ -98,6 +108,14 @@ export interface RunAgentResult {
      * checkpoint reports only what survives: those messages are genuinely gone
      * from the array, and the seam in the transcript is what stands in for them. */
     appended: number;
+    /** The largest single request's prompt tokens -- the context this run actually
+     * occupied. `usage.promptTokens` is the SUM over every call (what was billed),
+     * and each call resends the whole prompt, so a three-call turn at 46K sums to
+     * 138K; showing that sum as "in" reads as a context problem that isn't one.
+     * Optional because hand-built runners (tests, delegating hosts) don't measure it. */
+    contextTokens?: number;
+    /** Model calls this run made. */
+    calls?: number;
 }
 /** The most tools one request may carry.
  *

package/dist/core/loop.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loop.d.ts","sourceRoot":"","sources":["../../core/loop.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AACjC,OAAO,KAAK,EAAE,0BAA0B,EAAsB,MAAM,mCAAmC,CAAC;AACxG,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,UAAU,EAAE,KAAK,EAA4B,MAAM,mBAAmB,CAAC;AAE7G,OAAO,EACY,KAAK,cAAc,EAErC,MAAM,YAAY,CAAC;AAMpB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACzE,OAAO,EAA0D,KAAK,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAMhH,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd;kDAC8C;IAC9C,QAAQ,CAAC,EAAE,MAAM,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,0BAA0B,EAAE,CAAC;IACvC,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB;;;kFAG8E;IAC9E,aAAa,CAAC,EAAE,SAAS,EAAE,CAAC;IAC5B;oFACgF;IAChF,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,OAAO,EAAE,WAAW,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oFAAoF;IACpF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sFAAsF;IACtF,UAAU,CAAC,EAAE,iBAAiB,CAAC;IAC/B;;;;;;;;6EAQyE;IACzE,wBAAwB,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAC;IACxD,oEAAoE;IACpE,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAChC;;;;;iCAK6B;IAC7B,UAAU,CAAC,EAAE;QACX,SAAS,EAAE,CAAC,SAAS,EAAE,0BAA0B,EAAE,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;QACxE,MAAM,CAAC,EAAE,CACP,IAAI,EAAE,0BAA0B,EAChC,QAAQ,EAAE,0BAA0B,GAAG,IAAI,KACxC,OAAO,CAAC,MAAM,CAAC,CAAC;QACrB,YAAY,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;KAC7D,CAAC;IACF,oFAAoF;IACpF,QAAQ,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;IACnC;0FACsF;IACtF,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,4EAA4E;IAC5E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;;;yEAOqE;IACrE,aAAa,CAAC,EAAE,MAAM,0BAA0B,EAAE,CAAC;IACnD;;4DAEwD;IACxD,mBAAmB,CAAC,EAAE,MAAM,OAAO,CAAC;IACpC;;;0EAGsE;IACtE,iBAAiB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,IAAI,KAAK,IAAI,CAAC;IACpD,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,OAAO,CAAC,EAAE,CAAC,CAAC,EAAE,UAAU,KAAK,IAAI,CAAC;CACnC;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,0BAA0B,EAAE,CAAC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,KAAK,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB;;;;;;;;;;;;oFAYgF;IAChF,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;gEAWgE;AAChE,eAAO,MAAM,kBAAkB,MAAM,CAAC;AAEtC,wBAAsB,QAAQ,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,cAAc,CAAC,CAykB1E"}
+{"version":3,"file":"loop.d.ts","sourceRoot":"","sources":["../../core/loop.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AACjC,OAAO,KAAK,EAAE,0BAA0B,EAAsB,MAAM,mCAAmC,CAAC;AACxG,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,UAAU,EAAE,KAAK,EAA4B,MAAM,mBAAmB,CAAC;AAE7G,OAAO,EACY,KAAK,cAAc,EAErC,MAAM,YAAY,CAAC;AAMpB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACzE,OAAO,EAA0D,KAAK,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAKhH,OAAO,EAA+B,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAIlF,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd;kDAC8C;IAC9C,QAAQ,CAAC,EAAE,MAAM,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,0BAA0B,EAAE,CAAC;IACvC,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB;;;kFAG8E;IAC9E,aAAa,CAAC,EAAE,SAAS,EAAE,CAAC;IAC5B;oFACgF;IAChF,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB;;;;0EAIsE;IACtE,MAAM,CAAC,EAAE,UAAU,EAAE,CAAC;IACtB,OAAO,EAAE,WAAW,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oFAAoF;IACpF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sFAAsF;IACtF,UAAU,CAAC,EAAE,iBAAiB,CAAC;IAC/B;kEAC8D;IAC9D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;;;;;6EAQyE;IACzE,wBAAwB,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAC;IACxD,oEAAoE;IACpE,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAChC;;;;;iCAK6B;IAC7B,UAAU,CAAC,EAAE;QACX,SAAS,EAAE,CAAC,SAAS,EAAE,0BAA0B,EAAE,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;QACxE,MAAM,CAAC,EAAE,CACP,IAAI,EAAE,0BAA0B,EAChC,QAAQ,EAAE,0BAA0B,GAAG,IAAI,KACxC,OAAO,CAAC,MAAM,CAAC,CAAC;QACrB,YAAY,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;KAC7D,CAAC;IACF,oFAAoF;IACpF,QAAQ,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;IACnC;0FACsF;IACtF,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,4EAA4E;IAC5E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;;;yEAOqE;IACrE,aAAa,CAAC,EAAE,MAAM,0BAA0B,EAAE,CAAC;IACnD;;4DAEwD;IACxD,mBAAmB,CAAC,EAAE,MAAM,OAAO,CAAC;IACpC;;;0EAGsE;IACtE,iBAAiB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,IAAI,KAAK,IAAI,CAAC;IACpD,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,OAAO,CAAC,EAAE,CAAC,CAAC,EAAE,UAAU,KAAK,IAAI,CAAC;CACnC;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,0BAA0B,EAAE,CAAC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,KAAK,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB;;;;;;;;;;;;oFAYgF;IAChF,QAAQ,EAAE,MAAM,CAAC;IACjB;;;;yFAIqF;IACrF,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iCAAiC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;gEAWgE;AAChE,eAAO,MAAM,kBAAkB,MAAM,CAAC;AAEtC,wBAAsB,QAAQ,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,cAAc,CAAC,CA+nB1E"}