@sublang/slc 0.1.0

package/dist/pipeline.d.ts

@@ -0,0 +1,61 @@
+import { type Phase } from './phase.js';
+/**
+ * Maps a pipeline reference to candidate directories. DR-001 leaves the actual
+ * resolution to the consumer; `slc` only enforces that exactly one resolves.
+ */
+export type PipelineResolver = (reference: string) => string[] | Promise<string[]>;
+/** A resolved pipeline: its directory, ordered phases, passes, and optional link phase. */
+export interface Pipeline {
+    /** The resolved pipeline directory. */
+    dir: string;
+    /** Ordinary compile phases in entry-to-exit order. */
+    phases: Phase[];
+    /**
+     * Format-preserving pass phases, sorted by name. Passes sit outside the
+     * linear chain; a compile schedules them only on request (DR-013).
+     */
+    passes: Phase[];
+    /** Path to the reserved `link.md`, or `null` when absent. */
+    linkFile: string | null;
+}
+/** Machine-readable reason a pipeline was refused. */
+export type PipelineErrorCode = 'unresolved-pipeline' | 'ambiguous-pipeline' | 'chain-incomplete' | 'chain-branch' | 'chain-cycle';
+/** Raised when a pipeline cannot be resolved or its chain is invalid (DR-001). */
+export declare class PipelineError extends Error {
+    readonly code: PipelineErrorCode;
+    constructor(code: PipelineErrorCode, message: string);
+}
+/**
+ * Resolves a pipeline reference to exactly one directory (PIPE-16).
+ *
+ * @throws {PipelineError} when the reference resolves to zero (`unresolved`) or
+ *   more than one (`ambiguous`) directory.
+ */
+export declare function resolvePipeline(reference: string, resolver: PipelineResolver): Promise<string>;
+/**
+ * Lists the `.md` files directly inside a resolved pipeline directory (PIPE-17).
+ *
+ * Subdirectories are not descended into, and `link.md` is returned separately as
+ * the reserved link phase rather than as an ordinary phase file.
+ */
+export declare function discoverPhaseFiles(dir: string): Promise<{
+    phaseFiles: string[];
+    linkFile: string | null;
+}>;
+/**
+ * Infers the single linear phase order by chaining each phase's target format to
+ * the next phase's source format (PIPE-4).
+ *
+ * @throws {PipelineError} when the chain is incomplete, branches, or cycles
+ *   (PIPE-5).
+ */
+export declare function inferChain(phases: readonly Phase[]): Phase[];
+/**
+ * Discovers, loads, and orders the ordinary phases of a pipeline directory,
+ * validating extension consistency (PIPE-3) and chain shape (PIPE-4, PIPE-5).
+ * Format-preserving pass phases are split out of chain inference (DR-013) and
+ * returned sorted by name. Names cannot collide: every phase — chain or pass —
+ * is named by its unique filename, and `link.md` is reserved before loading.
+ */
+export declare function loadPipeline(dir: string): Promise<Pipeline>;
+//# sourceMappingURL=pipeline.d.ts.map

package/dist/pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../src/pipeline.ts"],"names":[],"mappings":"AAgBA,OAAO,EAGL,KAAK,KAAK,EACX,MAAM,YAAY,CAAC;AAEpB;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAC7B,SAAS,EAAE,MAAM,KACd,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;AAElC,2FAA2F;AAC3F,MAAM,WAAW,QAAQ;IACvB,uCAAuC;IACvC,GAAG,EAAE,MAAM,CAAC;IACZ,sDAAsD;IACtD,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB;;;OAGG;IACH,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,6DAA6D;IAC7D,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED,sDAAsD;AACtD,MAAM,MAAM,iBAAiB,GACzB,qBAAqB,GACrB,oBAAoB,GACpB,kBAAkB,GAClB,cAAc,GACd,aAAa,CAAC;AAElB,kFAAkF;AAClF,qBAAa,aAAc,SAAQ,KAAK;IACtC,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;gBAErB,IAAI,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM;CAKrD;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CACnC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,gBAAgB,GACzB,OAAO,CAAC,MAAM,CAAC,CAejB;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,MAAM,GACV,OAAO,CAAC;IAAE,UAAU,EAAE,MAAM,EAAE,CAAC;IAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC,CAe5D;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,SAAS,KAAK,EAAE,GAAG,KAAK,EAAE,CAkD5D;AAED;;;;;;GAMG;AACH,wBAAsB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAiBjE"}

package/dist/pipeline.js

@@ -0,0 +1,147 @@
+// SPDX-License-Identifier: Apache-2.0
+// SPDX-FileCopyrightText: 2026 SubLang International <https://sublang.ai>
+/**
+ * Pipeline resolution, phase discovery, and chain inference (DR-001).
+ *
+ * Implements PIPE-16 (refuse a reference that resolves to other than one
+ * directory), PIPE-17 (discover phase files directly in a pipeline directory,
+ * reserving `link.md`), PIPE-4 (infer the single linear phase order), and
+ * PIPE-5 (refuse incomplete, branching, or cyclic chains). See
+ * specs/dev/pipeline.md.
+ */
+import { readdir } from 'node:fs/promises';
+import { join } from 'node:path';
+import { checkExtensionConsistency, loadPhaseFile, } from './phase.js';
+/** Raised when a pipeline cannot be resolved or its chain is invalid (DR-001). */
+export class PipelineError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.name = 'PipelineError';
+        this.code = code;
+    }
+}
+/**
+ * Resolves a pipeline reference to exactly one directory (PIPE-16).
+ *
+ * @throws {PipelineError} when the reference resolves to zero (`unresolved`) or
+ *   more than one (`ambiguous`) directory.
+ */
+export async function resolvePipeline(reference, resolver) {
+    const candidates = await resolver(reference);
+    if (candidates.length === 0) {
+        throw new PipelineError('unresolved-pipeline', `pipeline reference "${reference}" did not resolve to a pipeline directory`);
+    }
+    if (candidates.length > 1) {
+        throw new PipelineError('ambiguous-pipeline', `pipeline reference "${reference}" resolved to multiple directories: ${candidates.join(', ')}`);
+    }
+    return candidates[0];
+}
+/**
+ * Lists the `.md` files directly inside a resolved pipeline directory (PIPE-17).
+ *
+ * Subdirectories are not descended into, and `link.md` is returned separately as
+ * the reserved link phase rather than as an ordinary phase file.
+ */
+export async function discoverPhaseFiles(dir) {
+    const entries = await readdir(dir, { withFileTypes: true });
+    const phaseFiles = [];
+    let linkFile = null;
+    for (const entry of entries) {
+        if (!entry.isFile() || !entry.name.endsWith('.md'))
+            continue;
+        const full = join(dir, entry.name);
+        if (entry.name === 'link.md') {
+            linkFile = full;
+        }
+        else {
+            phaseFiles.push(full);
+        }
+    }
+    phaseFiles.sort();
+    return { phaseFiles, linkFile };
+}
+/**
+ * Infers the single linear phase order by chaining each phase's target format to
+ * the next phase's source format (PIPE-4).
+ *
+ * @throws {PipelineError} when the chain is incomplete, branches, or cycles
+ *   (PIPE-5).
+ */
+export function inferChain(phases) {
+    if (phases.length === 0) {
+        throw new PipelineError('chain-incomplete', 'pipeline has no phases');
+    }
+    const producers = new Map();
+    const consumers = new Map();
+    for (const phase of phases) {
+        push(producers, phase.target.format, phase);
+        push(consumers, phase.source.format, phase);
+    }
+    branchGuard(producers, 'produced');
+    branchGuard(consumers, 'consumed');
+    const entries = phases.filter((phase) => !producers.has(phase.source.format));
+    if (entries.length === 0) {
+        throw new PipelineError('chain-cycle', 'pipeline chain has no entry phase');
+    }
+    if (entries.length > 1) {
+        throw new PipelineError('chain-branch', `multiple entry phases: ${names(entries)}`);
+    }
+    const ordered = [];
+    const visited = new Set();
+    let current = entries[0];
+    while (current !== undefined) {
+        if (visited.has(current)) {
+            throw new PipelineError('chain-cycle', `pipeline chain revisits phase "${current.name}"`);
+        }
+        visited.add(current);
+        ordered.push(current);
+        current = consumers.get(current.target.format)?.[0];
+    }
+    if (visited.size !== phases.length) {
+        const missing = phases.filter((phase) => !visited.has(phase));
+        throw new PipelineError('chain-incomplete', `phases not connected into a single chain: ${names(missing)}`);
+    }
+    return ordered;
+}
+/**
+ * Discovers, loads, and orders the ordinary phases of a pipeline directory,
+ * validating extension consistency (PIPE-3) and chain shape (PIPE-4, PIPE-5).
+ * Format-preserving pass phases are split out of chain inference (DR-013) and
+ * returned sorted by name. Names cannot collide: every phase — chain or pass —
+ * is named by its unique filename, and `link.md` is reserved before loading.
+ */
+export async function loadPipeline(dir) {
+    const { phaseFiles, linkFile } = await discoverPhaseFiles(dir);
+    const loaded = await Promise.all(phaseFiles.map((file) => loadPhaseFile(file)));
+    checkExtensionConsistency(loaded);
+    const passes = loaded
+        .filter((phase) => phase.pass)
+        .sort((left, right) => left.name < right.name ? -1 : left.name > right.name ? 1 : 0);
+    return {
+        dir,
+        phases: inferChain(loaded.filter((phase) => !phase.pass)),
+        passes,
+        linkFile,
+    };
+}
+function branchGuard(byFormat, verb) {
+    for (const [format, phases] of byFormat) {
+        if (phases.length > 1) {
+            throw new PipelineError('chain-branch', `format "${format}" is ${verb} by multiple phases: ${names(phases)}`);
+        }
+    }
+}
+function push(map, key, value) {
+    const existing = map.get(key);
+    if (existing === undefined) {
+        map.set(key, [value]);
+    }
+    else {
+        existing.push(value);
+    }
+}
+function names(phases) {
+    return phases.map((phase) => phase.name).join(', ');
+}
+//# sourceMappingURL=pipeline.js.map

package/dist/pipeline.js.map

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

package/dist/playbook-contract.d.ts

@@ -0,0 +1,194 @@
+/**
+ * Compatibility types for Playbook's evolving pre-1.0 runtime contract.
+ *
+ * The installed `@sublang/playbook` now supplies the composed six-port
+ * contract, so the retired 0.9 profile is frozen here as local structural
+ * types: legacy artifacts keep executing against the exact shapes they were
+ * compiled for, independent of how the shared contract module evolves
+ * (DR-010, DR-011).
+ */
+/** The frozen 0.9 player result (DR-010 legacy profile). */
+export interface LegacyPlayerResult {
+    status: 'ok' | 'aborted' | 'error';
+    finalText?: string;
+    error?: string;
+}
+/** The frozen 0.9 four-port boundary (DR-010 legacy profile). */
+export interface LegacyPlaybookPorts {
+    callPlayer(playerId: string, prompt: string, signal: AbortSignal): Promise<LegacyPlayerResult>;
+    callJudge(prompt: string, signal: AbortSignal): Promise<string>;
+    emitStatus(message: string, data?: unknown): Promise<void>;
+    emitTelemetry(event: {
+        topic: string;
+        payload: unknown;
+    }): Promise<void>;
+}
+/** The frozen 0.9 runtime surface (DR-010 legacy profile). */
+export interface LegacyPlaybookRuntime {
+    init(ports: LegacyPlaybookPorts): Promise<void>;
+    handleBossInput(turn: {
+        text: string;
+        signal: AbortSignal;
+    }): Promise<void>;
+    dispose(): Promise<void>;
+}
+export interface PlayerCallOptions {
+    resume: string | false;
+}
+export interface PlayerResult extends LegacyPlayerResult {
+    resumeToken?: string;
+}
+export interface CaptainCallOptions {
+    visibility: 'visible' | 'hidden';
+    resume: false;
+    /**
+     * Source-owned tool restriction: an explicitly empty allowlist for
+     * routing-only Captains; absent for transformation-performing Captains,
+     * which work through the host Captain's tools (link.md §PlaybookPorts).
+     */
+    allowedTools?: readonly [];
+}
+export interface CaptainResult {
+    status: 'ok' | 'aborted' | 'error';
+    finalText?: string;
+    error?: string;
+}
+export type RuntimeContractProfile = 'legacy' | 'session-v1' | 'composed-v2';
+export type JsonValue = null | boolean | number | string | readonly JsonValue[] | {
+    readonly [key: string]: JsonValue;
+};
+export interface NormalizedError {
+    name: string;
+    message: string;
+    stack?: string;
+}
+export type PlaybookStateValue = string | {
+    readonly [key: string]: PlaybookStateValue;
+};
+export interface PlaybookState {
+    value: PlaybookStateValue;
+    activeStateIds: readonly string[];
+    tags: readonly string[];
+    status: 'active' | 'done' | 'error' | 'stopped';
+    quiescent: boolean;
+    stateId?: string;
+}
+export interface PlaybookPendingCall {
+    callId: string;
+    playbookId: string;
+    childSessionId: string;
+}
+export interface PlaybookCallRequest {
+    callId: string;
+    playbookId: string;
+    text: string;
+}
+export type PlaybookCallResult = {
+    status: 'ok';
+    playbookId: string;
+    childSessionId: string;
+    state?: PlaybookState;
+    output?: JsonValue;
+} | {
+    status: 'aborted';
+    playbookId: string;
+    childSessionId?: string;
+    state?: PlaybookState;
+    error?: NormalizedError;
+} | {
+    status: 'error';
+    playbookId: string;
+    childSessionId?: string;
+    state?: PlaybookState;
+    error: NormalizedError;
+};
+export type PlaybookCallStart = {
+    state: 'settled';
+    result: PlaybookCallResult;
+} | {
+    state: 'suspended';
+    childSessionId: string;
+};
+export type PlaybookRunResult = {
+    outcome: 'quiescent' | 'no-action';
+    state: PlaybookState;
+} | {
+    outcome: 'failed' | 'aborted';
+    state: PlaybookState;
+    error?: NormalizedError;
+} | {
+    outcome: 'terminal';
+    state: PlaybookState;
+    output?: JsonValue;
+} | {
+    outcome: 'suspended';
+    state: PlaybookState;
+    pendingCall: PlaybookPendingCall;
+};
+/** The six source-owned ports, additive over the locked four-port contract. */
+export interface CompatiblePlaybookPorts extends LegacyPlaybookPorts {
+    callPlayer(playerId: string, prompt: string, signal: AbortSignal, options?: PlayerCallOptions): Promise<PlayerResult>;
+    callCaptain(prompt: string, signal: AbortSignal, options: CaptainCallOptions): Promise<CaptainResult>;
+    callPlaybook(request: PlaybookCallRequest, signal: AbortSignal): Promise<PlaybookCallStart>;
+}
+/** The exact six-port composed-session boundary. */
+export interface ComposedPlaybookPorts {
+    callPlayer(playerId: string, prompt: string, signal: AbortSignal, options: PlayerCallOptions): Promise<PlayerResult>;
+    callCaptain(prompt: string, signal: AbortSignal, options: CaptainCallOptions): Promise<CaptainResult>;
+    callJudge(prompt: string, signal: AbortSignal): Promise<string>;
+    callPlaybook(request: PlaybookCallRequest, signal: AbortSignal): Promise<PlaybookCallStart>;
+    emitStatus(message: string, data?: unknown): Promise<void>;
+    emitTelemetry(event: {
+        topic: string;
+        payload: unknown;
+    }): Promise<void>;
+}
+/** The committed traced-session contract: explicit resume but no child port. */
+export interface SessionV1PlaybookPorts {
+    callPlayer(playerId: string, prompt: string, signal: AbortSignal, options: PlayerCallOptions): Promise<PlayerResult>;
+    callJudge(prompt: string, signal: AbortSignal): Promise<string>;
+    emitStatus(message: string, data?: unknown): Promise<void>;
+    emitTelemetry(event: {
+        topic: string;
+        payload: unknown;
+    }): Promise<void>;
+}
+export interface PlaybookSessionV1 {
+    sessionId: string;
+    playbookId: string;
+    ports: SessionV1PlaybookPorts;
+}
+export interface PlaybookSession {
+    sessionId: string;
+    playbookId: string;
+    rootSessionId: string;
+    parentSessionId?: string;
+    parentCallId?: string;
+    depth: number;
+    ports: ComposedPlaybookPorts;
+}
+export interface SessionPlaybookRuntime {
+    init(session: PlaybookSession): Promise<void>;
+    handleBossInput(turn: {
+        text: string;
+        signal: AbortSignal;
+    }): Promise<PlaybookRunResult | void>;
+    resumePlaybookCall?(input: {
+        callId: string;
+        result: PlaybookCallResult;
+        signal: AbortSignal;
+    }): Promise<PlaybookRunResult>;
+    dispose(): Promise<void>;
+}
+export interface SessionV1PlaybookRuntime {
+    init(session: PlaybookSessionV1): Promise<void>;
+    handleBossInput(turn: {
+        text: string;
+        signal: AbortSignal;
+    }): Promise<void>;
+    dispose(): Promise<void>;
+}
+export type CompatiblePlaybookRuntime = LegacyPlaybookRuntime | SessionV1PlaybookRuntime | SessionPlaybookRuntime;
+export type CompatiblePlaybookRuntimeFactory<Options = unknown> = (options: Options) => CompatiblePlaybookRuntime;
+export declare function isPlaybookRunResult(value: unknown): value is PlaybookRunResult;
+//# sourceMappingURL=playbook-contract.d.ts.map

package/dist/playbook-contract.d.ts.map

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

package/dist/playbook-contract.js

@@ -0,0 +1,180 @@
+// SPDX-License-Identifier: Apache-2.0
+// SPDX-FileCopyrightText: 2026 SubLang International <https://sublang.ai>
+export function isPlaybookRunResult(value) {
+    try {
+        const fields = dataRecord(value);
+        if (fields === null || typeof fields.outcome !== 'string')
+            return false;
+        if (!isPlaybookState(fields.state))
+            return false;
+        switch (fields.outcome) {
+            case 'quiescent':
+            case 'no-action':
+                return hasExactKeys(fields, ['outcome', 'state']);
+            case 'failed':
+            case 'aborted':
+                return (hasExactKeys(fields, ['outcome', 'state', 'error']) &&
+                    (fields.error === undefined || isNormalizedError(fields.error)));
+            case 'terminal':
+                return (hasExactKeys(fields, ['outcome', 'state', 'output']) &&
+                    (fields.output === undefined || isJsonValue(fields.output)));
+            case 'suspended': {
+                const pendingCall = dataRecord(fields.pendingCall);
+                return (hasExactKeys(fields, ['outcome', 'state', 'pendingCall']) &&
+                    pendingCall !== null &&
+                    hasExactKeys(pendingCall, [
+                        'callId',
+                        'playbookId',
+                        'childSessionId',
+                    ]) &&
+                    nonEmptyString(pendingCall.callId) &&
+                    nonEmptyString(pendingCall.playbookId) &&
+                    nonEmptyString(pendingCall.childSessionId));
+            }
+            default:
+                return false;
+        }
+    }
+    catch {
+        // Hostile accessors/proxies are invalid results, not control-plane errors.
+        return false;
+    }
+}
+function isPlaybookState(value) {
+    const fields = dataRecord(value);
+    if (fields === null ||
+        !hasExactKeys(fields, [
+            'value',
+            'activeStateIds',
+            'tags',
+            'status',
+            'quiescent',
+            'stateId',
+        ])) {
+        return false;
+    }
+    if (typeof fields.quiescent !== 'boolean' ||
+        !Array.isArray(fields.activeStateIds) ||
+        !fields.activeStateIds.every((item) => typeof item === 'string') ||
+        !Array.isArray(fields.tags) ||
+        !fields.tags.every((item) => typeof item === 'string') ||
+        typeof fields.status !== 'string' ||
+        !['active', 'done', 'error', 'stopped'].includes(fields.status) ||
+        (fields.stateId !== undefined && !nonEmptyString(fields.stateId))) {
+        return false;
+    }
+    return isPlaybookStateValue(fields.value);
+}
+function isNormalizedError(value) {
+    const fields = dataRecord(value);
+    return (fields !== null &&
+        hasExactKeys(fields, ['name', 'message', 'stack']) &&
+        typeof fields.name === 'string' &&
+        typeof fields.message === 'string' &&
+        (fields.stack === undefined || typeof fields.stack === 'string'));
+}
+function dataRecord(value) {
+    if (!isRecord(value) || !isPlainRecord(value))
+        return null;
+    if (Object.getOwnPropertySymbols(value).length > 0)
+        return null;
+    const out = Object.create(null);
+    for (const [key, descriptor] of Object.entries(Object.getOwnPropertyDescriptors(value))) {
+        if (!Object.prototype.hasOwnProperty.call(descriptor, 'value'))
+            return null;
+        out[key] = descriptor.value;
+    }
+    return out;
+}
+function hasExactKeys(value, allowed) {
+    const keys = Object.keys(value);
+    return ((keys.includes('outcome') || !allowed.includes('outcome')) &&
+        keys.every((key) => allowed.includes(key)));
+}
+function isPlaybookStateValue(value, ancestors = new Set()) {
+    if (typeof value === 'string')
+        return true;
+    if (!isRecord(value) || !isPlainRecord(value))
+        return false;
+    if (ancestors.has(value))
+        return false;
+    const values = enumerableDataValues(value);
+    if (values === null)
+        return false;
+    ancestors.add(value);
+    const valid = values.every((item) => isPlaybookStateValue(item, ancestors));
+    ancestors.delete(value);
+    return valid;
+}
+function isJsonValue(value, ancestors = new Set()) {
+    if (value === null ||
+        typeof value === 'string' ||
+        typeof value === 'boolean') {
+        return true;
+    }
+    if (typeof value === 'number')
+        return Number.isFinite(value);
+    if (typeof value !== 'object')
+        return false;
+    if (ancestors.has(value))
+        return false;
+    ancestors.add(value);
+    let valid;
+    if (Array.isArray(value)) {
+        valid = isJsonArray(value, ancestors);
+    }
+    else {
+        const values = isPlainRecord(value) ? enumerableDataValues(value) : null;
+        valid =
+            values !== null && values.every((item) => isJsonValue(item, ancestors));
+    }
+    ancestors.delete(value);
+    return valid;
+}
+function isJsonArray(value, ancestors) {
+    if (Object.getOwnPropertySymbols(value).length > 0)
+        return false;
+    const descriptors = Object.getOwnPropertyDescriptors(value);
+    for (let index = 0; index < value.length; index++) {
+        const descriptor = descriptors[String(index)];
+        if (descriptor === undefined ||
+            !Object.prototype.hasOwnProperty.call(descriptor, 'value') ||
+            !isJsonValue(descriptor.value, ancestors)) {
+            return false;
+        }
+    }
+    return Object.entries(descriptors).every(([key, descriptor]) => {
+        if (!descriptor.enumerable)
+            return true;
+        const index = Number(key);
+        return (Number.isSafeInteger(index) &&
+            index >= 0 &&
+            index < value.length &&
+            String(index) === key);
+    });
+}
+function enumerableDataValues(value) {
+    if (Object.getOwnPropertySymbols(value).length > 0)
+        return null;
+    const values = [];
+    for (const descriptor of Object.values(Object.getOwnPropertyDescriptors(value))) {
+        if (!descriptor.enumerable)
+            continue;
+        if (!Object.prototype.hasOwnProperty.call(descriptor, 'value')) {
+            return null;
+        }
+        values.push(descriptor.value);
+    }
+    return values;
+}
+function isPlainRecord(value) {
+    const prototype = Object.getPrototypeOf(value);
+    return prototype === Object.prototype || prototype === null;
+}
+function nonEmptyString(value) {
+    return typeof value === 'string' && value.trim().length > 0;
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=playbook-contract.js.map

package/dist/playbook-contract.js.map

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