@petepetrash/circuit 0.1.0

package/dist/shared/result-path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result-path.d.ts","sourceRoot":"","sources":["../../src/shared/result-path.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,wBAAwB,wBAAwB,CAAC;AAE9D,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEvD"}

package/dist/shared/result-path.js

@@ -0,0 +1,6 @@
+import { join } from 'node:path';
+export const RUN_RESULT_RELATIVE_PATH = 'reports/result.json';
+export function runResultPath(runFolder) {
+    return join(runFolder, RUN_RESULT_RELATIVE_PATH);
+}
+//# sourceMappingURL=result-path.js.map

package/dist/shared/result-path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"result-path.js","sourceRoot":"","sources":["../../src/shared/result-path.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,MAAM,CAAC,MAAM,wBAAwB,GAAG,qBAAqB,CAAC;AAE9D,MAAM,UAAU,aAAa,CAAC,SAAiB;IAC7C,OAAO,IAAI,CAAC,SAAS,EAAE,wBAAwB,CAAC,CAAC;AACnD,CAAC"}

package/dist/shared/run-artifact-io.d.ts

@@ -0,0 +1,3 @@
+export declare function runRelativePath(runFolder: string, path: string): string;
+export declare function mtimeMs(path: string): number;
+//# sourceMappingURL=run-artifact-io.d.ts.map

package/dist/shared/run-artifact-io.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-artifact-io.d.ts","sourceRoot":"","sources":["../../src/shared/run-artifact-io.ts"],"names":[],"mappings":"AAOA,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAEvE;AAMD,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE5C"}

package/dist/shared/run-artifact-io.js

@@ -0,0 +1,17 @@
+import { statSync } from 'node:fs';
+import { isAbsolute, relative } from 'node:path';
+// Run-folder-relative path for an artifact reference: when the path is absolute
+// it is rebased onto the run folder; an already-relative path is returned as-is.
+// Verbatim consolidation of the byte-identical copies formerly in
+// process-evidence/projection.ts and run-envelope/source-record.ts.
+export function runRelativePath(runFolder, path) {
+    return isAbsolute(path) ? relative(runFolder, path) : path;
+}
+// Modification time of an artifact in whole milliseconds. Truncated to an
+// integer so source fingerprints stay stable across platforms whose statSync
+// reports sub-millisecond precision. Verbatim consolidation of history's
+// mtimeMs (extract.ts) and indexer.ts's inline statSync(...).mtimeMs read.
+export function mtimeMs(path) {
+    return Math.trunc(statSync(path).mtimeMs);
+}
+//# sourceMappingURL=run-artifact-io.js.map

package/dist/shared/run-artifact-io.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-artifact-io.js","sourceRoot":"","sources":["../../src/shared/run-artifact-io.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACnC,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAEjD,gFAAgF;AAChF,iFAAiF;AACjF,kEAAkE;AAClE,oEAAoE;AACpE,MAAM,UAAU,eAAe,CAAC,SAAiB,EAAE,IAAY;IAC7D,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAC7D,CAAC;AAED,0EAA0E;AAC1E,6EAA6E;AAC7E,yEAAyE;AACzE,2EAA2E;AAC3E,MAAM,UAAU,OAAO,CAAC,IAAY;IAClC,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC;AAC5C,CAAC"}

package/dist/shared/run-file-paths.d.ts

@@ -0,0 +1,3 @@
+export declare function validateRunFilePath(runRelativePath: string): readonly string[];
+export declare function resolveRunFilePath(runDir: string, runRelativePath: string): string;
+//# sourceMappingURL=run-file-paths.d.ts.map

package/dist/shared/run-file-paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-file-paths.d.ts","sourceRoot":"","sources":["../../src/shared/run-file-paths.ts"],"names":[],"mappings":"AAaA,wBAAgB,mBAAmB,CAAC,eAAe,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAsB9E;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,MAAM,CAuClF"}

package/dist/shared/run-file-paths.js

@@ -0,0 +1,72 @@
+// Run file path authority.
+//
+// Runtime files are addressed as POSIX paths relative to a run folder.
+// This module rejects absolute, parent, drive-letter, and symlink-escaping
+// forms before any executor reads or writes run-owned files.
+import { existsSync, lstatSync, realpathSync } from 'node:fs';
+import { isAbsolute, relative, resolve, sep } from 'node:path';
+function isInsideOrSame(root, target) {
+    const fromRoot = relative(root, target);
+    return fromRoot === '' || (!fromRoot.startsWith('..') && !isAbsolute(fromRoot));
+}
+export function validateRunFilePath(runRelativePath) {
+    const issues = [];
+    if (runRelativePath.trim().length === 0) {
+        issues.push('must be non-empty');
+    }
+    if (isAbsolute(runRelativePath)) {
+        issues.push('must be relative');
+    }
+    if (runRelativePath.includes('\\')) {
+        issues.push('must use POSIX "/" separators');
+    }
+    if (runRelativePath.includes(':')) {
+        issues.push('must not contain drive-letter or colon forms');
+    }
+    if (runRelativePath
+        .split('/')
+        .some((segment) => segment.length === 0 || segment === '.' || segment === '..')) {
+        issues.push('must not contain empty, current-directory, or parent-directory segments');
+    }
+    return issues;
+}
+export function resolveRunFilePath(runDir, runRelativePath) {
+    if (runRelativePath.trim().length === 0) {
+        throw new Error('run file path must be non-empty');
+    }
+    if (isAbsolute(runRelativePath)) {
+        throw new Error(`run file path must be relative: ${runRelativePath}`);
+    }
+    const root = resolve(runDir);
+    const fullPath = resolve(root, runRelativePath);
+    if (fullPath !== root && !fullPath.startsWith(`${root}${sep}`)) {
+        throw new Error(`run file path escapes run directory: ${runRelativePath}`);
+    }
+    if (fullPath === root) {
+        throw new Error(`run file path must name a file: ${runRelativePath}`);
+    }
+    const validation = validateRunFilePath(runRelativePath);
+    if (validation.length > 0) {
+        throw new Error(`run file path ${validation[0]}: ${runRelativePath}`);
+    }
+    if (existsSync(root)) {
+        if (lstatSync(root).isSymbolicLink()) {
+            throw new Error(`run file path crosses symlink: ${runRelativePath}`);
+        }
+        const rootReal = realpathSync.native(root);
+        let cursor = root;
+        for (const segment of runRelativePath.split('/')) {
+            cursor = resolve(cursor, segment);
+            if (!existsSync(cursor))
+                break;
+            if (lstatSync(cursor).isSymbolicLink()) {
+                throw new Error(`run file path crosses symlink: ${runRelativePath}`);
+            }
+            if (!isInsideOrSame(rootReal, realpathSync.native(cursor))) {
+                throw new Error(`run file path escapes run directory through symlink: ${runRelativePath}`);
+            }
+        }
+    }
+    return fullPath;
+}
+//# sourceMappingURL=run-file-paths.js.map

package/dist/shared/run-file-paths.js.map

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

package/dist/shared/run-relative-path.d.ts

@@ -0,0 +1,2 @@
+export declare function resolveRunRelative(runFolder: string, relPath: string): string;
+//# sourceMappingURL=run-relative-path.d.ts.map

package/dist/shared/run-relative-path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-relative-path.d.ts","sourceRoot":"","sources":["../../src/shared/run-relative-path.ts"],"names":[],"mappings":"AAcA,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAoC7E"}

package/dist/shared/run-relative-path.js

@@ -0,0 +1,43 @@
+// Run-relative projection path helper.
+//
+// Operator-facing projections read files by paths stored in run outputs. This
+// helper keeps those reads inside the run folder, including when existing path
+// segments are symlinks.
+import { existsSync, lstatSync, realpathSync } from 'node:fs';
+import { isAbsolute, relative, resolve } from 'node:path';
+import { RunRelativePath } from '../schemas/scalars.js';
+function isInside(root, target) {
+    const fromRoot = relative(root, target);
+    return fromRoot !== '' && !fromRoot.startsWith('..') && !isAbsolute(fromRoot);
+}
+export function resolveRunRelative(runFolder, relPath) {
+    const parsed = RunRelativePath.safeParse(relPath);
+    if (!parsed.success) {
+        const detail = parsed.error.issues.map((issue) => issue.message).join('; ');
+        throw new Error(`run-relative path rejected: ${JSON.stringify(relPath)} (${detail})`);
+    }
+    const rootAbs = resolve(runFolder);
+    const targetAbs = resolve(rootAbs, parsed.data);
+    if (!isInside(rootAbs, targetAbs)) {
+        throw new Error(`run-relative path rejected: ${JSON.stringify(relPath)} escapes run folder`);
+    }
+    if (!existsSync(rootAbs))
+        return targetAbs;
+    const rootReal = realpathSync.native(rootAbs);
+    let cursor = rootAbs;
+    for (const segment of parsed.data.split('/')) {
+        cursor = resolve(cursor, segment);
+        if (!existsSync(cursor))
+            break;
+        const stat = lstatSync(cursor);
+        if (stat.isSymbolicLink()) {
+            throw new Error(`run-relative path rejected: ${JSON.stringify(relPath)} crosses symlink ${JSON.stringify(cursor)}`);
+        }
+        const cursorReal = realpathSync.native(cursor);
+        if (!isInside(rootReal, cursorReal)) {
+            throw new Error(`run-relative path rejected: ${JSON.stringify(relPath)} escapes real run folder through ${JSON.stringify(cursor)}`);
+        }
+    }
+    return targetAbs;
+}
+//# sourceMappingURL=run-relative-path.js.map

package/dist/shared/run-relative-path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-relative-path.js","sourceRoot":"","sources":["../../src/shared/run-relative-path.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,EAAE;AACF,8EAA8E;AAC9E,+EAA+E;AAC/E,yBAAyB;AACzB,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,SAAS,QAAQ,CAAC,IAAY,EAAE,MAAc;IAC5C,MAAM,QAAQ,GAAG,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACxC,OAAO,QAAQ,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;AAChF,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,SAAiB,EAAE,OAAe;IACnE,MAAM,MAAM,GAAG,eAAe,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IAClD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC5E,MAAM,IAAI,KAAK,CAAC,+BAA+B,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,KAAK,MAAM,GAAG,CAAC,CAAC;IACxF,CAAC;IAED,MAAM,OAAO,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IACnC,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;IAChD,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC,EAAE,CAAC;QAClC,MAAM,IAAI,KAAK,CAAC,+BAA+B,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,qBAAqB,CAAC,CAAC;IAC/F,CAAC;IACD,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC;QAAE,OAAO,SAAS,CAAC;IAE3C,MAAM,QAAQ,GAAG,YAAY,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC9C,IAAI,MAAM,GAAG,OAAO,CAAC;IACrB,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QAC7C,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAClC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC;YAAE,MAAM;QAE/B,MAAM,IAAI,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;QAC/B,IAAI,IAAI,CAAC,cAAc,EAAE,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CACb,+BAA+B,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,oBAAoB,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CACnG,CAAC;QACJ,CAAC;QAED,MAAM,UAAU,GAAG,YAAY,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC/C,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAC,EAAE,CAAC;YACpC,MAAM,IAAI,KAAK,CACb,+BAA+B,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,oCAAoC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CACnH,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/shared/runtime-source.d.ts

@@ -0,0 +1,24 @@
+import { type Axes } from '../schemas/axes.js';
+import type { CheckpointChoiceSource, ReportItemsSource, RuntimeNumberSource } from '../schemas/runtime-source.js';
+export interface RuntimeSourceFileReader {
+    readJson(path: string): Promise<unknown>;
+}
+export interface CheckpointChoice {
+    readonly id: string;
+    readonly label?: string;
+    readonly description?: string;
+}
+export declare function resolveRuntimeNumberSource(source: RuntimeNumberSource, axes?: Axes): number;
+export declare function resolveReportItemsSource(input: {
+    readonly source: ReportItemsSource;
+    readonly files: RuntimeSourceFileReader;
+    readonly axes?: Axes;
+    readonly owner: string;
+}): Promise<readonly unknown[]>;
+export declare function resolveCheckpointChoicesSource(input: {
+    readonly source: CheckpointChoiceSource;
+    readonly files: RuntimeSourceFileReader;
+    readonly axes?: Axes;
+    readonly owner: string;
+}): Promise<readonly CheckpointChoice[]>;
+//# sourceMappingURL=runtime-source.d.ts.map

package/dist/shared/runtime-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-source.d.ts","sourceRoot":"","sources":["../../src/shared/runtime-source.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,IAAI,EAAgB,MAAM,oBAAoB,CAAC;AAC7D,OAAO,KAAK,EACV,sBAAsB,EACtB,iBAAiB,EACjB,mBAAmB,EACpB,MAAM,8BAA8B,CAAC;AAGtC,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC1C;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,mBAAmB,EAC3B,IAAI,GAAE,IAAmB,GACxB,MAAM,CAGR;AAOD,wBAAsB,wBAAwB,CAAC,KAAK,EAAE;IACpD,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IACnC,QAAQ,CAAC,KAAK,EAAE,uBAAuB,CAAC;IACxC,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB,GAAG,OAAO,CAAC,SAAS,OAAO,EAAE,CAAC,CAkB9B;AA4BD,wBAAsB,8BAA8B,CAAC,KAAK,EAAE;IAC1D,QAAQ,CAAC,MAAM,EAAE,sBAAsB,CAAC;IACxC,QAAQ,CAAC,KAAK,EAAE,uBAAuB,CAAC;IACxC,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB,GAAG,OAAO,CAAC,SAAS,gBAAgB,EAAE,CAAC,CAiCvC"}

package/dist/shared/runtime-source.js

@@ -0,0 +1,75 @@
+import { DEFAULT_AXES } from '../schemas/axes.js';
+import { resolveDottedPath } from './fanout-branch-template.js';
+export function resolveRuntimeNumberSource(source, axes = DEFAULT_AXES) {
+    if (source.kind === 'constant')
+        return source.value;
+    return axes[source.axis];
+}
+function resolvedCountLabel(source) {
+    if (source.kind === 'constant')
+        return String(source.value);
+    return `axes.${source.axis}`;
+}
+export async function resolveReportItemsSource(input) {
+    const sourceRaw = await input.files.readJson(input.source.source_report);
+    const rawItems = resolveDottedPath(sourceRaw, input.source.items_path);
+    if (!Array.isArray(rawItems)) {
+        throw new Error(`${input.owner}: items_path '${input.source.items_path}' did not resolve to an array (got ${typeof rawItems})`);
+    }
+    const items = filterItems(rawItems, input.source.filter);
+    if (input.source.required_count !== undefined) {
+        const expected = resolveRuntimeNumberSource(input.source.required_count, input.axes);
+        if (items.length !== expected) {
+            throw new Error(`${input.owner}: expected ${expected} items from ${input.source.source_report}.${input.source.items_path} (${resolvedCountLabel(input.source.required_count)}) but found ${items.length}`);
+        }
+    }
+    return items;
+}
+function filterItems(items, filter) {
+    if (filter === undefined)
+        return items;
+    if (filter.kind === 'path_equals') {
+        return items.filter((item) => resolveDottedPath(item, filter.path) === filter.value);
+    }
+    return items;
+}
+function requireItemString(input) {
+    const value = resolveDottedPath(input.item, input.path);
+    if (typeof value !== 'string' || value.length === 0) {
+        throw new Error(`${input.owner}: item ${input.index} field '${input.path}' must be a non-empty string`);
+    }
+    return value;
+}
+export async function resolveCheckpointChoicesSource(input) {
+    const items = await resolveReportItemsSource(input);
+    return items.map((item, index) => {
+        const id = requireItemString({
+            item,
+            path: input.source.id_path,
+            owner: input.owner,
+            index,
+        });
+        const label = input.source.label_path === undefined
+            ? undefined
+            : requireItemString({
+                item,
+                path: input.source.label_path,
+                owner: input.owner,
+                index,
+            });
+        const description = input.source.description_path === undefined
+            ? undefined
+            : requireItemString({
+                item,
+                path: input.source.description_path,
+                owner: input.owner,
+                index,
+            });
+        return {
+            id,
+            ...(label === undefined ? {} : { label }),
+            ...(description === undefined ? {} : { description }),
+        };
+    });
+}
+//# sourceMappingURL=runtime-source.js.map

package/dist/shared/runtime-source.js.map

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

package/dist/shared/runtime-touched-files.d.ts

@@ -0,0 +1,12 @@
+import { type RuntimeGitStateSnapshot, type RuntimeTouchedFilesProjection as RuntimeTouchedFilesProjectionValue } from '../schemas/runtime-evidence.js';
+export type { RuntimeGitStateEntry, RuntimeGitStateSnapshot, RuntimeHiddenIndexFlag, RuntimeTouchedFile, RuntimeTouchedFileStatus, RuntimeTouchedFilesProjection, } from '../schemas/runtime-evidence.js';
+export type ProjectRuntimeTouchedFilesOptions = {
+    readonly baseline: RuntimeGitStateSnapshot;
+    readonly post: RuntimeGitStateSnapshot;
+    readonly workerDeclaredPaths?: readonly string[];
+    readonly ignoredPathPrefixes?: readonly string[];
+    readonly generatedSurfacePathPrefixes?: readonly string[];
+    readonly protectedPathPrefixes?: readonly string[];
+};
+export declare function projectRuntimeTouchedFiles(options: ProjectRuntimeTouchedFilesOptions): RuntimeTouchedFilesProjectionValue;
+//# sourceMappingURL=runtime-touched-files.d.ts.map

package/dist/shared/runtime-touched-files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-touched-files.d.ts","sourceRoot":"","sources":["../../src/shared/runtime-touched-files.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,uBAAuB,EAI5B,KAAK,6BAA6B,IAAI,kCAAkC,EACzE,MAAM,gCAAgC,CAAC;AAExC,YAAY,EACV,oBAAoB,EACpB,uBAAuB,EACvB,sBAAsB,EACtB,kBAAkB,EAClB,wBAAwB,EACxB,6BAA6B,GAC9B,MAAM,gCAAgC,CAAC;AAExC,MAAM,MAAM,iCAAiC,GAAG;IAC9C,QAAQ,CAAC,QAAQ,EAAE,uBAAuB,CAAC;IAC3C,QAAQ,CAAC,IAAI,EAAE,uBAAuB,CAAC;IACvC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACjD,QAAQ,CAAC,mBAAmB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACjD,QAAQ,CAAC,4BAA4B,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1D,QAAQ,CAAC,qBAAqB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACpD,CAAC;AAwEF,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,iCAAiC,GACzC,kCAAkC,CA8DpC"}

package/dist/shared/runtime-touched-files.js

@@ -0,0 +1,106 @@
+import { RuntimeTouchedFilesProjection, } from '../schemas/runtime-evidence.js';
+function isPathInPrefix(path, prefixes) {
+    return prefixes.some((prefix) => path === prefix || path.startsWith(`${prefix}/`));
+}
+function filterEntries(entries, prefixes) {
+    if (prefixes.length === 0)
+        return [...entries];
+    return entries.filter((entry) => !isPathInPrefix(entry.path, prefixes));
+}
+function filterHiddenFlags(flags, prefixes) {
+    if (prefixes.length === 0)
+        return [...flags];
+    return flags.filter((flag) => !isPathInPrefix(flag.path, prefixes));
+}
+function entriesByPath(entries) {
+    const map = new Map();
+    for (const entry of entries) {
+        map.set(entry.path, entry);
+    }
+    return map;
+}
+function hiddenPaths(flags) {
+    return new Set(flags.map((flag) => flag.path));
+}
+function uniqueSorted(paths) {
+    return [...new Set(paths)].sort((a, b) => a.localeCompare(b));
+}
+function statusFromEntry(baseline, post) {
+    if (post?.from !== undefined || post?.status_code.includes('R')) {
+        return 'renamed';
+    }
+    if (post?.status_code.includes('D')) {
+        return 'deleted';
+    }
+    if (baseline === undefined &&
+        post !== undefined &&
+        (post.status_code.includes('?') || post.status_code.includes('A'))) {
+        return 'added';
+    }
+    return 'modified';
+}
+function uniqueFlags(flags) {
+    const seen = new Set();
+    const out = [];
+    for (const flag of flags) {
+        const key = `${flag.tag}\0${flag.path}`;
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        out.push(flag);
+    }
+    return out.sort((a, b) => a.path.localeCompare(b.path) || a.tag.localeCompare(b.tag));
+}
+export function projectRuntimeTouchedFiles(options) {
+    const ignoredPathPrefixes = options.ignoredPathPrefixes ?? [];
+    const baselineEntries = filterEntries(options.baseline.entries, ignoredPathPrefixes);
+    const postEntries = filterEntries(options.post.entries, ignoredPathPrefixes);
+    const baselineHiddenFlags = filterHiddenFlags(options.baseline.hidden_index_flags, ignoredPathPrefixes);
+    const postHiddenFlags = filterHiddenFlags(options.post.hidden_index_flags, ignoredPathPrefixes);
+    const baselineByPath = entriesByPath(baselineEntries);
+    const postByPath = entriesByPath(postEntries);
+    const baselinePaths = new Set(baselineByPath.keys());
+    const postPaths = new Set(postByPath.keys());
+    const hiddenBaselinePaths = hiddenPaths(baselineHiddenFlags);
+    const newDirt = [...postPaths].filter((path) => !baselinePaths.has(path));
+    const baselineDirtyMutated = [...baselinePaths].filter((path) => {
+        if (hiddenBaselinePaths.has(path))
+            return false;
+        const before = baselineByPath.get(path);
+        const after = postByPath.get(path);
+        return before?.fingerprint !== after?.fingerprint;
+    });
+    const observed = uniqueSorted([...newDirt, ...baselineDirtyMutated]);
+    const workerDeclared = uniqueSorted((options.workerDeclaredPaths ?? []).filter((path) => !isPathInPrefix(path, ignoredPathPrefixes)));
+    const observedSet = new Set(observed);
+    const workerDeclaredSet = new Set(workerDeclared);
+    const undeclaredWorkerExtras = observed.filter((path) => !workerDeclaredSet.has(path));
+    const missingWorkerDeclared = workerDeclared.filter((path) => !observedSet.has(path));
+    return RuntimeTouchedFilesProjection.parse({
+        baseline_head_sha: options.baseline.head_sha,
+        head_sha: options.post.head_sha,
+        head_diverged: options.baseline.head_sha !== options.post.head_sha,
+        files: observed.map((path) => {
+            const baseline = baselineByPath.get(path);
+            const post = postByPath.get(path);
+            return {
+                path,
+                status: statusFromEntry(baseline, post),
+                source: 'runtime_diff',
+                generated_surface: isPathInPrefix(path, options.generatedSurfacePathPrefixes ?? []),
+                protected: isPathInPrefix(path, options.protectedPathPrefixes ?? []),
+                // Carry the rename/copy source so a path-containment consumer can check
+                // both endpoints. This does NOT enter `observed` or the worker-claim
+                // comparison above, so the change-set verdict (Fix) is unchanged.
+                ...(post?.from === undefined ? {} : { from: post.from }),
+            };
+        }),
+        worker_declared: workerDeclared,
+        worker_claim_matches_runtime: undeclaredWorkerExtras.length === 0 && missingWorkerDeclared.length === 0,
+        undeclared_worker_extras: undeclaredWorkerExtras,
+        missing_worker_declared: missingWorkerDeclared,
+        baseline_dirty_mutated: uniqueSorted(baselineDirtyMutated),
+        hidden_index_flags: uniqueFlags([...baselineHiddenFlags, ...postHiddenFlags]),
+    });
+}
+//# sourceMappingURL=runtime-touched-files.js.map

package/dist/shared/runtime-touched-files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-touched-files.js","sourceRoot":"","sources":["../../src/shared/runtime-touched-files.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,6BAA6B,GAE9B,MAAM,gCAAgC,CAAC;AAoBxC,SAAS,cAAc,CAAC,IAAY,EAAE,QAA2B;IAC/D,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,KAAK,MAAM,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,MAAM,GAAG,CAAC,CAAC,CAAC;AACrF,CAAC;AAED,SAAS,aAAa,CACpB,OAAwC,EACxC,QAA2B;IAE3B,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC;IAC/C,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,cAAc,CAAC,KAAK,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC;AAC1E,CAAC;AAED,SAAS,iBAAiB,CACxB,KAAwC,EACxC,QAA2B;IAE3B,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC;IAC7C,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC;AACtE,CAAC;AAED,SAAS,aAAa,CACpB,OAAwC;IAExC,MAAM,GAAG,GAAG,IAAI,GAAG,EAAgC,CAAC;IACpD,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAC7B,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,WAAW,CAAC,KAAwC;IAC3D,OAAO,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;AACjD,CAAC;AAED,SAAS,YAAY,CAAC,KAAuB;IAC3C,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;AAChE,CAAC;AAED,SAAS,eAAe,CACtB,QAA0C,EAC1C,IAAsC;IAEtC,IAAI,IAAI,EAAE,IAAI,KAAK,SAAS,IAAI,IAAI,EAAE,WAAW,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAChE,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IAAI,IAAI,EAAE,WAAW,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACpC,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IACE,QAAQ,KAAK,SAAS;QACtB,IAAI,KAAK,SAAS;QAClB,CAAC,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,EAClE,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,SAAS,WAAW,CAAC,KAAwC;IAC3D,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,GAAG,GAA6B,EAAE,CAAC;IACzC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,GAAG,KAAK,IAAI,CAAC,IAAI,EAAE,CAAC;QACxC,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,SAAS;QAC5B,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACd,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjB,CAAC;IACD,OAAO,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;AACxF,CAAC;AAED,MAAM,UAAU,0BAA0B,CACxC,OAA0C;IAE1C,MAAM,mBAAmB,GAAG,OAAO,CAAC,mBAAmB,IAAI,EAAE,CAAC;IAC9D,MAAM,eAAe,GAAG,aAAa,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,EAAE,mBAAmB,CAAC,CAAC;IACrF,MAAM,WAAW,GAAG,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,mBAAmB,CAAC,CAAC;IAC7E,MAAM,mBAAmB,GAAG,iBAAiB,CAC3C,OAAO,CAAC,QAAQ,CAAC,kBAAkB,EACnC,mBAAmB,CACpB,CAAC;IACF,MAAM,eAAe,GAAG,iBAAiB,CAAC,OAAO,CAAC,IAAI,CAAC,kBAAkB,EAAE,mBAAmB,CAAC,CAAC;IAEhG,MAAM,cAAc,GAAG,aAAa,CAAC,eAAe,CAAC,CAAC;IACtD,MAAM,UAAU,GAAG,aAAa,CAAC,WAAW,CAAC,CAAC;IAC9C,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC,CAAC;IACrD,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC;IAC7C,MAAM,mBAAmB,GAAG,WAAW,CAAC,mBAAmB,CAAC,CAAC;IAE7D,MAAM,OAAO,GAAG,CAAC,GAAG,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;IAC1E,MAAM,oBAAoB,GAAG,CAAC,GAAG,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE;QAC9D,IAAI,mBAAmB,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,OAAO,KAAK,CAAC;QAChD,MAAM,MAAM,GAAG,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACxC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACnC,OAAO,MAAM,EAAE,WAAW,KAAK,KAAK,EAAE,WAAW,CAAC;IACpD,CAAC,CAAC,CAAC;IAEH,MAAM,QAAQ,GAAG,YAAY,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,oBAAoB,CAAC,CAAC,CAAC;IACrE,MAAM,cAAc,GAAG,YAAY,CACjC,CAAC,OAAO,CAAC,mBAAmB,IAAI,EAAE,CAAC,CAAC,MAAM,CACxC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,cAAc,CAAC,IAAI,EAAE,mBAAmB,CAAC,CACrD,CACF,CAAC;IACF,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC;IACtC,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAC,cAAc,CAAC,CAAC;IAClD,MAAM,sBAAsB,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,iBAAiB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;IACvF,MAAM,qBAAqB,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;IAEtF,OAAO,6BAA6B,CAAC,KAAK,CAAC;QACzC,iBAAiB,EAAE,OAAO,CAAC,QAAQ,CAAC,QAAQ;QAC5C,QAAQ,EAAE,OAAO,CAAC,IAAI,CAAC,QAAQ;QAC/B,aAAa,EAAE,OAAO,CAAC,QAAQ,CAAC,QAAQ,KAAK,OAAO,CAAC,IAAI,CAAC,QAAQ;QAClE,KAAK,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;YAC3B,MAAM,QAAQ,GAAG,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAC1C,MAAM,IAAI,GAAG,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAClC,OAAO;gBACL,IAAI;gBACJ,MAAM,EAAE,eAAe,CAAC,QAAQ,EAAE,IAAI,CAAC;gBACvC,MAAM,EAAE,cAAc;gBACtB,iBAAiB,EAAE,cAAc,CAAC,IAAI,EAAE,OAAO,CAAC,4BAA4B,IAAI,EAAE,CAAC;gBACnF,SAAS,EAAE,cAAc,CAAC,IAAI,EAAE,OAAO,CAAC,qBAAqB,IAAI,EAAE,CAAC;gBACpE,wEAAwE;gBACxE,qEAAqE;gBACrE,kEAAkE;gBAClE,GAAG,CAAC,IAAI,EAAE,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;aACzD,CAAC;QACJ,CAAC,CAAC;QACF,eAAe,EAAE,cAAc;QAC/B,4BAA4B,EAC1B,sBAAsB,CAAC,MAAM,KAAK,CAAC,IAAI,qBAAqB,CAAC,MAAM,KAAK,CAAC;QAC3E,wBAAwB,EAAE,sBAAsB;QAChD,uBAAuB,EAAE,qBAAqB;QAC9C,sBAAsB,EAAE,YAAY,CAAC,oBAAoB,CAAC;QAC1D,kBAAkB,EAAE,WAAW,CAAC,CAAC,GAAG,mBAAmB,EAAE,GAAG,eAAe,CAAC,CAAC;KAC9E,CAAC,CAAC;AACL,CAAC"}

package/dist/shared/skill-loading.d.ts

@@ -0,0 +1,22 @@
+import type { LayeredConfig } from '../schemas/config.js';
+import type { CompiledFlowId, SkillId } from '../schemas/ids.js';
+import type { ResolvedSelection } from '../schemas/selection-policy.js';
+import type { SkillSlot } from '../schemas/skill.js';
+import type { LoadedSkillEvidence } from '../schemas/trace-entry.js';
+import { type UserSkillRegistry } from './user-skill-registry.js';
+export interface LoadedRelaySkill extends LoadedSkillEvidence {
+    readonly body: string;
+}
+interface ResolveLoadedRelaySkillsInput {
+    readonly flowId: CompiledFlowId;
+    readonly stepId: string;
+    readonly skillSlots: readonly SkillSlot[];
+    readonly resolvedSelection: ResolvedSelection;
+    readonly configLayers?: readonly LayeredConfig[];
+    readonly registry?: UserSkillRegistry;
+    readonly injectedSkillIds?: readonly SkillId[];
+}
+export declare function resolveSkillBindingsForFlow(flowId: CompiledFlowId, configLayers?: readonly LayeredConfig[]): ReadonlyMap<string, SkillId>;
+export declare function resolveLoadedRelaySkills(input: ResolveLoadedRelaySkillsInput): readonly LoadedRelaySkill[];
+export {};
+//# sourceMappingURL=skill-loading.d.ts.map

package/dist/shared/skill-loading.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-loading.d.ts","sourceRoot":"","sources":["../../src/shared/skill-loading.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,cAAc,EAAE,OAAO,EAAe,MAAM,mBAAmB,CAAC;AAC9E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,KAAK,EAAoB,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AACvF,OAAO,EAAE,KAAK,iBAAiB,EAA2B,MAAM,0BAA0B,CAAC;AAE3F,MAAM,WAAW,gBAAiB,SAAQ,mBAAmB;IAC3D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,UAAU,6BAA6B;IACrC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,SAAS,SAAS,EAAE,CAAC;IAC1C,QAAQ,CAAC,iBAAiB,EAAE,iBAAiB,CAAC;IAC9C,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,aAAa,EAAE,CAAC;IACjD,QAAQ,CAAC,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IAKtC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;CAChD;AAED,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,cAAc,EACtB,YAAY,GAAE,SAAS,aAAa,EAAO,GAC1C,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,CAoB9B;AAED,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,6BAA6B,GACnC,SAAS,gBAAgB,EAAE,CAwD7B"}

package/dist/shared/skill-loading.js

@@ -0,0 +1,75 @@
+import { createUserSkillRegistry } from './user-skill-registry.js';
+export function resolveSkillBindingsForFlow(flowId, configLayers = []) {
+    const globalBindings = new Map();
+    const flowBindings = new Map();
+    const flowKey = flowId;
+    for (const layer of configLayers) {
+        for (const [slot, skill] of Object.entries(layer.config.skills.bindings)) {
+            if (skill === undefined)
+                continue;
+            globalBindings.set(slot, skill);
+        }
+        const circuit = layer.config.flows[flowKey];
+        if (circuit === undefined)
+            continue;
+        for (const [slot, skill] of Object.entries(circuit.skill_bindings)) {
+            if (skill === undefined)
+                continue;
+            flowBindings.set(slot, skill);
+        }
+    }
+    return new Map([...globalBindings, ...flowBindings]);
+}
+export function resolveLoadedRelaySkills(input) {
+    const registry = input.registry ?? createUserSkillRegistry();
+    const bindings = resolveSkillBindingsForFlow(input.flowId, input.configLayers);
+    const loaded = [];
+    const seen = new Set();
+    // `cause` is stamped here, at load time, where the source is known for
+    // certain: the selection loop knows it loaded a declared default, the slot
+    // loop knows it bound a slot, the injection loop knows it actuated a hook. A
+    // later reader cannot recover that distinction from id and path alone, so we
+    // record it now and let the trace schema verify it (slot <=> binding) and the
+    // run schema cross-check skill-hook causes against real hook events.
+    const addSkill = (id, cause, slot) => {
+        const key = id;
+        if (seen.has(key))
+            return;
+        let resolved;
+        try {
+            resolved = registry.resolve(id);
+        }
+        catch (err) {
+            const slotText = slot === undefined ? '' : ` for slot '${slot}'`;
+            throw new Error(`relay step '${input.stepId}' selected skill '${key}'${slotText} could not be resolved:\n${err.message}`);
+        }
+        seen.add(key);
+        loaded.push({
+            id: resolved.entry.id,
+            cause,
+            ...(slot === undefined ? {} : { slot }),
+            path: resolved.entry.path,
+            sha256: resolved.entry.sha256,
+            bytes: resolved.entry.bytes,
+            body: resolved.body,
+        });
+    };
+    for (const id of input.resolvedSelection.skills) {
+        addSkill(id, 'selection');
+    }
+    for (const slot of input.skillSlots) {
+        const skill = bindings.get(slot.id);
+        if (skill === undefined)
+            continue;
+        addSkill(skill, 'binding', slot.id);
+    }
+    // Skill-hook injected skills come last and carry no slot: they are run-time
+    // actuation, not a declared selection or slot binding. `seen` dedup means an
+    // injected skill that the step already loads (via selection or a binding) is
+    // not added again.
+    for (const id of input.injectedSkillIds ?? []) {
+        addSkill(id, 'skill-hook');
+    }
+    return loaded;
+}
+//# sourceMappingURL=skill-loading.js.map

package/dist/shared/skill-loading.js.map

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

package/dist/shared/status-block-renderer.d.ts

@@ -0,0 +1,16 @@
+import type { ProgressEvent } from '../schemas/progress-event.js';
+export type StatusBlockRenderMode = 'append-transcript' | 'live-snapshot';
+export interface StatusBlockLine {
+    readonly blockId: string;
+    readonly lineMode: 'append' | 'replace_slot';
+    readonly slotId?: string;
+    readonly statusText: string;
+    readonly depth: number;
+}
+export declare function statusBlockLineFromProgressEvent(event: Pick<ProgressEvent, 'presentation'>): StatusBlockLine | undefined;
+export declare function renderStatusLine(line: StatusBlockLine): string;
+export declare function renderStatusBlocks(lines: readonly StatusBlockLine[], input: {
+    readonly mode: StatusBlockRenderMode;
+    readonly title?: string;
+}): string;
+//# sourceMappingURL=status-block-renderer.d.ts.map

package/dist/shared/status-block-renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status-block-renderer.d.ts","sourceRoot":"","sources":["../../src/shared/status-block-renderer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAElE,MAAM,MAAM,qBAAqB,GAAG,mBAAmB,GAAG,eAAe,CAAC;AAE1E,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,GAAG,cAAc,CAAC;IAC7C,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,wBAAgB,gCAAgC,CAC9C,KAAK,EAAE,IAAI,CAAC,aAAa,EAAE,cAAc,CAAC,GACzC,eAAe,GAAG,SAAS,CAc7B;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,CAG9D;AAyBD,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,SAAS,eAAe,EAAE,EACjC,KAAK,EAAE;IACL,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAC;IACrC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB,GACA,MAAM,CAyBR"}