@ontrails/core 1.0.0-beta.15 → 1.0.0-beta.16

package/dist/result.js

@@ -1,156 +0,0 @@
-/**
- * A type-safe Result monad for representing success/failure without exceptions.
- */
-import { InternalError, ValidationError } from './errors.js';
-class Ok {
-    value;
-    constructor(value) {
-        this.value = value;
-    }
-    // oxlint-disable-next-line class-methods-use-this -- type guard for Result discriminated union
-    isOk() {
-        return true;
-    }
-    // oxlint-disable-next-line class-methods-use-this -- type guard for Result discriminated union
-    isErr() {
-        return false;
-    }
-    map(fn) {
-        return new Ok(fn(this.value));
-    }
-    flatMap(fn) {
-        return fn(this.value);
-    }
-    mapErr(_fn) {
-        return new Ok(this.value);
-    }
-    match(handlers) {
-        return handlers.ok(this.value);
-    }
-    unwrap() {
-        return this.value;
-    }
-    unwrapOr(_fallback) {
-        return this.value;
-    }
-}
-// oxlint-disable-next-line max-classes-per-file -- Result monad requires paired Ok/Err classes
-class Err {
-    error;
-    constructor(error) {
-        this.error = error;
-    }
-    // oxlint-disable-next-line class-methods-use-this -- type guard for Result discriminated union
-    isOk() {
-        return false;
-    }
-    // oxlint-disable-next-line class-methods-use-this -- type guard for Result discriminated union
-    isErr() {
-        return true;
-    }
-    map(_fn) {
-        return new Err(this.error);
-    }
-    flatMap(_fn) {
-        return new Err(this.error);
-    }
-    mapErr(fn) {
-        return new Err(fn(this.error));
-    }
-    match(handlers) {
-        return handlers.err(this.error);
-    }
-    unwrap() {
-        throw this.error instanceof Error
-            ? this.error
-            : new Error(String(this.error));
-    }
-    // oxlint-disable-next-line class-methods-use-this -- symmetric API with Ok.unwrapOr
-    unwrapOr(fallback) {
-        return fallback;
-    }
-}
-// eslint-disable-next-line @typescript-eslint/no-namespace
-export const Result = {
-    combine(results) {
-        const values = [];
-        for (const result of results) {
-            if (result.isErr()) {
-                return new Err(result.error);
-            }
-            values.push(result.value);
-        }
-        return new Ok(values);
-    },
-    err(error) {
-        return new Err(error);
-    },
-    /**
-     * Wrap a fetch call in a Result, mapping failures to TrailsError subclasses.
-     *
-     * Network errors become NetworkError. Abort signals become CancelledError.
-     * HTTP error status codes map to the appropriate error category.
-     */
-    async fromFetch(input, init) {
-        // Lazy import avoids a circular dependency (fetch.ts imports Result)
-        const { fromFetch: fetchImpl } = await import('./fetch.js');
-        return fetchImpl(input, init);
-    },
-    /**
-     * Parse a JSON string, returning a Result instead of throwing.
-     */
-    fromJson(json) {
-        try {
-            return new Ok(JSON.parse(json));
-        }
-        catch (error) {
-            return new Err(new ValidationError('Invalid JSON', {
-                cause: error instanceof Error ? error : new Error(String(error)),
-                context: { input: json.slice(0, 200) },
-            }));
-        }
-    },
-    ok(value) {
-        return new Ok(value);
-    },
-    /**
-     * Stringify a value to JSON, returning a Result. Handles circular references.
-     */
-    toJson(value) {
-        try {
-            // Track the current ancestor chain, not every object ever visited.
-            // This allows shared references in a DAG while still detecting cycles.
-            const stack = [];
-            const keys = [];
-            const json = JSON.stringify(value, function json(key, val) {
-                if (stack.length > 0) {
-                    // `this` is the object that contains `key`. Trim the stack back
-                    // to `this` so we only track the current ancestor path.
-                    const thisIndex = stack.lastIndexOf(this);
-                    stack.splice(thisIndex + 1);
-                    keys.splice(thisIndex);
-                }
-                if (typeof val === 'object' && val !== null) {
-                    if (stack.includes(val)) {
-                        return '[Circular]';
-                    }
-                    stack.push(val);
-                    keys.push(key);
-                }
-                return val;
-            });
-            if (json === undefined) {
-                return new Err(new InternalError('Value is not JSON-serializable', {
-                    context: { type: typeof value },
-                }));
-            }
-            return new Ok(json);
-        }
-        catch (error) {
-            return new Err(new InternalError('Failed to stringify value', {
-                cause: error instanceof Error ? error : new Error(String(error)),
-            }));
-        }
-    },
-};
-//# sourceMappingURL=result.js.map

package/dist/result.js.map

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

package/dist/run.d.ts

@@ -1,28 +0,0 @@
-/**
- * Headless trail execution without mounting a trailhead.
- *
- * Looks up a trail by ID in a topo, then delegates to `executeTrail`.
- * Returns a `Result` and never throws.
- */
-import type { Topo } from './topo.js';
-import type { ExecuteTrailOptions } from './execute.js';
-import { Result } from './result.js';
-/** Options forwarded to `executeTrail` from `run`. */
-export type RunOptions = ExecuteTrailOptions;
-/**
- * Execute a trail by ID from a topo without mounting a trailhead.
- *
- * Resolves the trail from the topo, then runs it through the standard
- * `executeTrail` pipeline with `topo` threaded so `ctx.fire()` is bound
- * to the producer's context inside `executeTrail`. Returns
- * `Result.err(NotFoundError)` if the trail ID is not registered. Never
- * throws — unexpected exceptions are returned as `Result.err(InternalError)`.
- *
- * @example
- * ```typescript
- * const result = await run(myTopo, 'greet', { name: 'Alice' });
- * if (result.isOk()) console.log(result.value);
- * ```
- */
-export declare const run: (topo: Topo, id: string, input: unknown, options?: RunOptions) => Promise<Result<unknown, Error>>;
-//# sourceMappingURL=run.d.ts.map

package/dist/run.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../src/run.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEtC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAExD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAMrC,sDAAsD;AACtD,MAAM,MAAM,UAAU,GAAG,mBAAmB,CAAC;AAM7C;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,GAAG,GACd,MAAM,IAAI,EACV,IAAI,MAAM,EACV,OAAO,OAAO,EACd,UAAU,UAAU,KACnB,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,CAUhC,CAAC"}

package/dist/run.js

@@ -1,35 +0,0 @@
-/**
- * Headless trail execution without mounting a trailhead.
- *
- * Looks up a trail by ID in a topo, then delegates to `executeTrail`.
- * Returns a `Result` and never throws.
- */
-import { executeTrail } from './execute.js';
-import { NotFoundError } from './errors.js';
-import { Result } from './result.js';
-// ---------------------------------------------------------------------------
-// run()
-// ---------------------------------------------------------------------------
-/**
- * Execute a trail by ID from a topo without mounting a trailhead.
- *
- * Resolves the trail from the topo, then runs it through the standard
- * `executeTrail` pipeline with `topo` threaded so `ctx.fire()` is bound
- * to the producer's context inside `executeTrail`. Returns
- * `Result.err(NotFoundError)` if the trail ID is not registered. Never
- * throws — unexpected exceptions are returned as `Result.err(InternalError)`.
- *
- * @example
- * ```typescript
- * const result = await run(myTopo, 'greet', { name: 'Alice' });
- * if (result.isOk()) console.log(result.value);
- * ```
- */
-export const run = (topo, id, input, options) => {
-    const trail = topo.get(id);
-    if (trail === undefined) {
-        return Promise.resolve(Result.err(new NotFoundError(`Trail "${id}" not found in topo "${topo.name}"`)));
-    }
-    return executeTrail(trail, input, { ...options, topo });
-};
-//# sourceMappingURL=run.js.map

package/dist/run.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"run.js","sourceRoot":"","sources":["../src/run.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AASrC,8EAA8E;AAC9E,QAAQ;AACR,8EAA8E;AAE9E;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,GAAG,GAAG,CACjB,IAAU,EACV,EAAU,EACV,KAAc,EACd,OAAoB,EACa,EAAE;IACnC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC3B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO,OAAO,CAAC,OAAO,CACpB,MAAM,CAAC,GAAG,CACR,IAAI,aAAa,CAAC,UAAU,EAAE,wBAAwB,IAAI,CAAC,IAAI,GAAG,CAAC,CACpE,CACF,CAAC;IACJ,CAAC;IACD,OAAO,YAAY,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,GAAG,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;AAC1D,CAAC,CAAC"}

package/dist/serialization.d.ts

@@ -1,27 +0,0 @@
-/**
- * Serialization utilities for @ontrails/core
- *
- * Safe JSON parsing/stringifying and error serialization/deserialization
- * for transport across process boundaries.
- */
-import type { ErrorCategory, TrailsError } from './errors.js';
-import { ValidationError, InternalError } from './errors.js';
-import { Result } from './result.js';
-export interface SerializedError {
-    readonly name: string;
-    readonly message: string;
-    readonly category?: ErrorCategory | undefined;
-    readonly retryable?: boolean | undefined;
-    readonly retryAfter?: number | undefined;
-    readonly context?: Record<string, unknown> | undefined;
-    readonly stack?: string | undefined;
-}
-/** Extract structured data from an Error for transport. */
-export declare const serializeError: (error: Error) => SerializedError;
-/** Reconstruct a TrailsError from serialized data. */
-export declare const deserializeError: (data: SerializedError) => TrailsError;
-/** Parse a JSON string, returning a Result instead of throwing. */
-export declare const safeParse: (json: string) => Result<unknown, ValidationError>;
-/** Stringify a value, returning a Result. Handles circular references. */
-export declare const safeStringify: (value: unknown) => Result<string, InternalError>;
-//# sourceMappingURL=serialization.d.ts.map

package/dist/serialization.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"serialization.d.ts","sourceRoot":"","sources":["../src/serialization.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,EACL,eAAe,EAUf,aAAa,EAKd,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAMrC,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC;IAC9C,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACzC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IACvD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACrC;AAsFD,2DAA2D;AAC3D,eAAO,MAAM,cAAc,GAAI,OAAO,KAAK,KAAG,eAmB7C,CAAC;AAEF,sDAAsD;AACtD,eAAO,MAAM,gBAAgB,GAAI,MAAM,eAAe,KAAG,WAkBxD,CAAC;AAMF,mEAAmE;AACnE,eAAO,MAAM,SAAS,GAAI,MAAM,MAAM,KAAG,MAAM,CAAC,OAAO,EAAE,eAAe,CAWvE,CAAC;AAEF,0EAA0E;AAC1E,eAAO,MAAM,aAAa,GACxB,OAAO,OAAO,KACb,MAAM,CAAC,MAAM,EAAE,aAAa,CAwC9B,CAAC"}

package/dist/serialization.js

@@ -1,154 +0,0 @@
-/**
- * Serialization utilities for @ontrails/core
- *
- * Safe JSON parsing/stringifying and error serialization/deserialization
- * for transport across process boundaries.
- */
-import { ValidationError, AmbiguousError, AssertionError, NotFoundError, AlreadyExistsError, ConflictError, PermissionError, TimeoutError, RateLimitError, NetworkError, InternalError, DerivationError, AuthError, CancelledError, isTrailsError, } from './errors.js';
-import { Result } from './result.js';
-// ---------------------------------------------------------------------------
-// Internal helpers (defined before usage)
-// ---------------------------------------------------------------------------
-/** Build options object without including undefined context. */
-const buildOpts = (context) => {
-    if (context !== undefined) {
-        return { context };
-    }
-    return {};
-};
-const errorFactories = {
-    auth: (msg, opts) => new AuthError(msg, opts),
-    cancelled: (msg, opts) => new CancelledError(msg, opts),
-    conflict: (msg, opts) => new ConflictError(msg, opts),
-    internal: (msg, opts) => new InternalError(msg, opts),
-    network: (msg, opts) => new NetworkError(msg, opts),
-    not_found: (msg, opts) => new NotFoundError(msg, opts),
-    permission: (msg, opts) => new PermissionError(msg, opts),
-    rate_limit: (msg, opts, retryAfter) => {
-        const rlOpts = {
-            ...opts,
-        };
-        if (retryAfter !== undefined) {
-            rlOpts.retryAfter = retryAfter;
-        }
-        return new RateLimitError(msg, rlOpts);
-    },
-    timeout: (msg, opts) => new TimeoutError(msg, opts),
-    validation: (msg, opts) => new ValidationError(msg, opts),
-};
-const createErrorByCategory = (category, message, context, retryAfter) => {
-    const opts = buildOpts(context);
-    const factory = errorFactories[category] ?? errorFactories.internal;
-    return factory(message, opts, retryAfter);
-};
-/** Map error class names to their constructors for precise round-tripping. */
-const errorConstructorsByName = {
-    AlreadyExistsError: (msg, opts) => new AlreadyExistsError(msg, opts),
-    AmbiguousError: (msg, opts) => new AmbiguousError(msg, opts),
-    AssertionError: (msg, opts) => new AssertionError(msg, opts),
-    AuthError: (msg, opts) => new AuthError(msg, opts),
-    CancelledError: (msg, opts) => new CancelledError(msg, opts),
-    ConflictError: (msg, opts) => new ConflictError(msg, opts),
-    DerivationError: (msg, opts) => new DerivationError(msg, opts),
-    InternalError: (msg, opts) => new InternalError(msg, opts),
-    NetworkError: (msg, opts) => new NetworkError(msg, opts),
-    NotFoundError: (msg, opts) => new NotFoundError(msg, opts),
-    PermissionError: (msg, opts) => new PermissionError(msg, opts),
-    RateLimitError: (msg, opts, retryAfter) => {
-        const rlOpts = {
-            ...opts,
-        };
-        if (retryAfter !== undefined) {
-            rlOpts.retryAfter = retryAfter;
-        }
-        return new RateLimitError(msg, rlOpts);
-    },
-    TimeoutError: (msg, opts) => new TimeoutError(msg, opts),
-    ValidationError: (msg, opts) => new ValidationError(msg, opts),
-};
-// ---------------------------------------------------------------------------
-// Error serialization
-// ---------------------------------------------------------------------------
-/** Extract structured data from an Error for transport. */
-export const serializeError = (error) => {
-    const result = {
-        message: error.message,
-        name: error.name,
-        stack: error.stack,
-    };
-    if (isTrailsError(error)) {
-        return {
-            ...result,
-            category: error.category,
-            context: error.context,
-            retryAfter: error instanceof RateLimitError ? error.retryAfter : undefined,
-            retryable: error.retryable,
-        };
-    }
-    return result;
-};
-/** Reconstruct a TrailsError from serialized data. */
-export const deserializeError = (data) => {
-    const opts = buildOpts(data.context);
-    const nameFactory = errorConstructorsByName[data.name];
-    const error = nameFactory
-        ? nameFactory(data.message, opts, data.retryAfter)
-        : createErrorByCategory(data.category ?? 'internal', data.message, data.context, data.retryAfter);
-    if (data.stack) {
-        error.stack = data.stack;
-    }
-    return error;
-};
-// ---------------------------------------------------------------------------
-// Safe JSON
-// ---------------------------------------------------------------------------
-/** Parse a JSON string, returning a Result instead of throwing. */
-export const safeParse = (json) => {
-    try {
-        return Result.ok(JSON.parse(json));
-    }
-    catch (error) {
-        return Result.err(new ValidationError('Invalid JSON', {
-            cause: error instanceof Error ? error : new Error(String(error)),
-            context: { input: json.slice(0, 200) },
-        }));
-    }
-};
-/** Stringify a value, returning a Result. Handles circular references. */
-export const safeStringify = (value) => {
-    try {
-        // Track the current ancestor chain, not every object ever visited.
-        // This allows shared references in a DAG while still detecting cycles.
-        const stack = [];
-        const keys = [];
-        const json = JSON.stringify(value, function json(key, val) {
-            if (stack.length > 0) {
-                // `this` is the object that contains `key`. Trim the stack back
-                // to `this` so we only track the current ancestor path.
-                const thisIndex = stack.lastIndexOf(this);
-                stack.splice(thisIndex + 1);
-                keys.splice(thisIndex);
-            }
-            if (typeof val === 'object' && val !== null) {
-                if (stack.includes(val)) {
-                    return '[Circular]';
-                }
-                stack.push(val);
-                keys.push(key);
-            }
-            return val;
-        });
-        if (json === undefined) {
-            return Result.err(new InternalError('Value is not JSON-serializable', {
-                context: { type: typeof value },
-            }));
-        }
-        return Result.ok(json);
-    }
-    catch (error) {
-        return Result.err(new InternalError('Failed to stringify value', {
-            cause: error instanceof Error ? error : new Error(String(error)),
-        }));
-    }
-};
-//# sourceMappingURL=serialization.js.map

package/dist/serialization.js.map

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

package/dist/signal.d.ts

@@ -1,33 +0,0 @@
-/**
- * Signal — a named payload schema with optional provenance meta.
- */
-import type { z } from 'zod';
-export interface SignalSpec<T> {
-    readonly payload: z.ZodType<T>;
-    readonly description?: string | undefined;
-    readonly meta?: Readonly<Record<string, unknown>> | undefined;
-    /** Trail IDs that produce this signal (e.g. the trails it originates from). */
-    readonly from?: readonly string[] | undefined;
-}
-export interface Signal<T> {
-    readonly id: string;
-    readonly kind: 'signal';
-    readonly payload: z.ZodType<T>;
-    readonly description?: string | undefined;
-    readonly meta?: Readonly<Record<string, unknown>> | undefined;
-    /** Trail IDs that produce this signal (e.g. the trails it originates from). */
-    readonly from?: readonly string[] | undefined;
-}
-/**
- * Create a signal definition.
- *
- * A signal is a named payload schema describing something that happened.
- * Returns a frozen object with `kind: "signal"` and all spec fields.
- */
-export declare function signal<T>(id: string, spec: SignalSpec<T>): Signal<T>;
-export declare function signal<T>(spec: SignalSpec<T> & {
-    readonly id: string;
-}): Signal<T>;
-/** Existential type for heterogeneous signal collections */
-export type AnySignal = Signal<unknown>;
-//# sourceMappingURL=signal.d.ts.map

package/dist/signal.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"signal.d.ts","sourceRoot":"","sources":["../src/signal.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAM7B,MAAM,WAAW,UAAU,CAAC,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAC/B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1C,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IAC9D,+EAA+E;IAC/E,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;CAC/C;AAMD,MAAM,WAAW,MAAM,CAAC,CAAC;IACvB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAC/B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1C,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IAC9D,+EAA+E;IAC/E,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;CAC/C;AAMD;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;AACtE,wBAAgB,MAAM,CAAC,CAAC,EACtB,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG;IAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAC5C,MAAM,CAAC,CAAC,CAAC,CAAC;AAkBb,4DAA4D;AAC5D,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC"}

package/dist/signal.js

@@ -1,17 +0,0 @@
-/**
- * Signal — a named payload schema with optional provenance meta.
- */
-export function signal(idOrSpec, maybeSpec) {
-    const resolvedId = typeof idOrSpec === 'string' ? idOrSpec : idOrSpec.id;
-    // oxlint-disable-next-line no-non-null-assertion -- overload guarantees maybeSpec when idOrSpec is string
-    const resolvedSpec = typeof idOrSpec === 'string' ? maybeSpec : idOrSpec;
-    return Object.freeze({
-        description: resolvedSpec.description,
-        from: resolvedSpec.from ? Object.freeze([...resolvedSpec.from]) : undefined,
-        id: resolvedId,
-        kind: 'signal',
-        meta: resolvedSpec.meta,
-        payload: resolvedSpec.payload,
-    });
-}
-//# sourceMappingURL=signal.js.map

package/dist/signal.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"signal.js","sourceRoot":"","sources":["../src/signal.ts"],"names":[],"mappings":"AAAA;;GAEG;AA4CH,MAAM,UAAU,MAAM,CACpB,QAA4D,EAC5D,SAAyB;IAEzB,MAAM,UAAU,GAAG,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC;IACzE,0GAA0G;IAC1G,MAAM,YAAY,GAAG,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAU,CAAC,CAAC,CAAC,QAAQ,CAAC;IAC1E,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,WAAW,EAAE,YAAY,CAAC,WAAW;QACrC,IAAI,EAAE,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS;QAC3E,EAAE,EAAE,UAAU;QACd,IAAI,EAAE,QAAiB;QACvB,IAAI,EAAE,YAAY,CAAC,IAAI;QACvB,OAAO,EAAE,YAAY,CAAC,OAAO;KAC9B,CAAC,CAAC;AACL,CAAC"}

package/dist/store/accessor-protocol.d.ts

@@ -1,51 +0,0 @@
-/**
- * Structural accessor protocol used by `deriveTrail()` to synthesize default
- * blazes for standard CRUD operations without depending on `@ontrails/store`.
- *
- * @remarks
- * This type is intentionally minimal and structural. `@ontrails/store`'s
- * `StoreAccessor` / `StoreTableAccessor` interfaces satisfy this protocol
- * through a compile-time extends check (see `packages/store/src/types.ts`).
- * Keeping the protocol in core avoids a core → store dependency while still
- * allowing the derivation helper to call accessors by convention.
- *
- * Required methods (`get`, `list`, `upsert`, `remove`) match the
- * connector-agnostic write contract every bound store must expose. Optional
- * methods (`insert`, `update`) are declared by tabular connectors that
- * distinguish create-only and patch-only operations from the generalized
- * `upsert` contract.
- */
-export interface StoreAccessorProtocol<TInput, TEntity, TId, TFilters = unknown> {
-    /** Retrieve a single entity by identity. Returns `null` when not found. */
-    get(id: TId): Promise<TEntity | null>;
-    /** List entities, optionally filtered. Returns `[]` when no rows match. */
-    list(filters?: TFilters): Promise<readonly TEntity[]>;
-    /** Create-or-replace one entity using the connector-agnostic contract. */
-    upsert(input: TInput): Promise<TEntity>;
-    /**
-     * Remove an entity by identity. Returns `{ deleted: true }` when the row
-     * was found and removed, `{ deleted: false }` when no matching row
-     * existed (not an error).
-     */
-    remove(id: TId): Promise<{
-        readonly deleted: boolean;
-    }>;
-    /**
-     * Optional insert — available on tabular connectors that distinguish
-     * create from update. When absent, synthesized blazes fall back to
-     * `upsert`.
-     */
-    insert?(input: TInput): Promise<TEntity>;
-    /**
-     * Optional patch-by-identity — available on tabular connectors. Returns
-     * `null` when no row with the given identity exists. When absent,
-     * synthesized update blazes fall back to `get` + merge + `upsert`.
-     */
-    update?(id: TId, patch: Partial<TInput>): Promise<TEntity | null>;
-}
-/**
- * Record shape returned by a resource's `from(ctx)` call, keyed by accessor
- * name. Used by `deriveTrail()` to resolve an accessor by contour name.
- */
-export type StoreAccessorRecord = Readonly<Record<string, StoreAccessorProtocol<unknown, unknown, unknown, unknown>>>;
-//# sourceMappingURL=accessor-protocol.d.ts.map

package/dist/store/accessor-protocol.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"accessor-protocol.d.ts","sourceRoot":"","sources":["../../src/store/accessor-protocol.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,qBAAqB,CACpC,MAAM,EACN,OAAO,EACP,GAAG,EACH,QAAQ,GAAG,OAAO;IAElB,2EAA2E;IAC3E,GAAG,CAAC,EAAE,EAAE,GAAG,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IACtC,2EAA2E;IAC3E,IAAI,CAAC,OAAO,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC,SAAS,OAAO,EAAE,CAAC,CAAC;IACtD,0EAA0E;IAC1E,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACxC;;;;OAIG;IACH,MAAM,CAAC,EAAE,EAAE,GAAG,GAAG,OAAO,CAAC;QAAE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IACxD;;;;OAIG;IACH,MAAM,CAAC,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACzC;;;;OAIG;IACH,MAAM,CAAC,CAAC,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;CACnE;AAED;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAAG,QAAQ,CACxC,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAC1E,CAAC"}

package/dist/store/accessor-protocol.js

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=accessor-protocol.js.map

package/dist/store/accessor-protocol.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"accessor-protocol.js","sourceRoot":"","sources":["../../src/store/accessor-protocol.ts"],"names":[],"mappings":""}

package/dist/store/index.d.ts

@@ -1,2 +0,0 @@
-export type { StoreAccessorProtocol, StoreAccessorRecord, } from './accessor-protocol.js';
-//# sourceMappingURL=index.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/store/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,wBAAwB,CAAC"}

package/dist/store/index.js

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=index.js.map

package/dist/store/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/store/index.ts"],"names":[],"mappings":""}

package/dist/surface-filter.d.ts

@@ -1,13 +0,0 @@
-import type { Intent, Trail } from './trail.js';
-export interface SurfaceFilterOptions {
-    /** Glob patterns that keep only matching trail IDs when provided. */
-    readonly include?: readonly string[] | undefined;
-    /** Glob patterns that remove matching trail IDs. */
-    readonly exclude?: readonly string[] | undefined;
-    /** Allowed intents for exposed trailheads. Empty arrays act as no filter. */
-    readonly intent?: readonly Intent[] | undefined;
-}
-export declare const matchesTrailPattern: (trailId: string, pattern: string) => boolean;
-export declare const shouldIncludeTrailForSurface: (trail: Trail<unknown, unknown, unknown>, options?: SurfaceFilterOptions) => boolean;
-export declare const filterSurfaceTrails: (trails: readonly Trail<unknown, unknown, unknown>[], options?: SurfaceFilterOptions) => Trail<unknown, unknown, unknown>[];
-//# sourceMappingURL=surface-filter.d.ts.map

package/dist/surface-filter.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"surface-filter.d.ts","sourceRoot":"","sources":["../src/surface-filter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAMhD,MAAM,WAAW,oBAAoB;IACnC,qEAAqE;IACrE,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IACjD,oDAAoD;IACpD,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IACjD,6EAA6E;IAC7E,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;CACjD;AAuED,eAAO,MAAM,mBAAmB,GAC9B,SAAS,MAAM,EACf,SAAS,MAAM,KACd,OAKF,CAAC;AA+DF,eAAO,MAAM,4BAA4B,GACvC,OAAO,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,EACvC,UAAS,oBAAyB,KACjC,OAiBF,CAAC;AAEF,eAAO,MAAM,mBAAmB,GAC9B,QAAQ,SAAS,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,EACnD,UAAS,oBAAyB,KACjC,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,EACqC,CAAC"}