@sublang/slc 0.5.0 → 0.7.0

package/dist/config.d.ts

@@ -1,52 +1,69 @@
 import type { AgentAdapter, PermissionPolicy } from '@sublang/cligent';
 import type { PhaseExecutor } from './execution.js';
 import type { AgentClient } from './interpreter.js';
+import type { RuntimeContractProfile } from './playbook-contract.js';
 import type { CompiledSelection } from './runner.js';
-/** Agent CLI ids the executable registers (CLI-7). */
+/** Agent CLI ids the executable registers (cli-7). */
 export declare const SUPPORTED_AGENTS: readonly ["claude-code", "codex", "gemini", "opencode"];
-/** One of the registered agent CLI ids (CLI-7). */
+/** One of the registered agent CLI ids (cli-7). */
 export type SupportedAgent = (typeof SUPPORTED_AGENTS)[number];
-/** Constructs the Cligent adapter for a supported agent id (CLI-7). */
-export type AdapterFactory = (agent: SupportedAgent) => AgentAdapter;
-/** Default factory: Cligent's built-in adapters, constructed on demand (CLI-7). */
+/**
+ * Constructs the Cligent adapter for a supported agent id (cli-7). Cligent
+ * types each adapter by its own effort vocabulary and fast-mode support, so
+ * the factory is typed at the widest adapter shape; the configuration layer
+ * validates effort against Cligent's per-agent support metadata (cli-12).
+ */
+export type AdapterFactory = (agent: SupportedAgent) => AgentAdapter<string, boolean>;
+/** Default factory: Cligent's built-in adapters, constructed on demand (cli-7). */
 export declare const defaultAdapterFactory: AdapterFactory;
-/** A resolved Coder and optional Reviewer selection (CLI-7, DR-022). */
+/** A resolved Coder and optional Reviewer selection (cli-7, DR-022). */
 export interface AgentSelection {
     agent: SupportedAgent;
     /** Optional model; omitted so the agent CLI uses its own default. */
     model?: string;
     /** Optional adapter-scoped reasoning effort; omitted for the default. */
     effort?: string;
+    /**
+     * Literal adapter-scoped fast-mode request: `false` asks for it off, and
+     * omission leaves the agent CLI's own default. Validated against Cligent's
+     * fast-mode capability contract, which slc does not duplicate (cli-7).
+     */
+    fastMode?: boolean;
     /** Optional independent Reviewer selection; presence enables DR-022. */
     reviewer?: Omit<AgentSelection, 'reviewer'>;
 }
-/** Machine-readable reason agent configuration was refused (CLI-12). */
-export type ConfigErrorCode = 'agent-unset' | 'agent-unsupported' | 'effort-unsupported' | 'reviewer-agent-unset' | 'reviewer-agent-unsupported' | 'reviewer-effort-unsupported';
+/** Machine-readable reason agent configuration was refused (cli-12). */
+export type ConfigErrorCode = 'agent-unset' | 'agent-unsupported' | 'effort-unsupported' | 'fast-mode-invalid' | 'fast-mode-unsupported' | 'reviewer-agent-unset' | 'reviewer-agent-unsupported' | 'reviewer-effort-unsupported' | 'reviewer-fast-mode-invalid' | 'reviewer-fast-mode-unsupported';
 /** Raised when a required Coder or Reviewer selection is invalid. */
 export declare class ConfigError extends Error {
     readonly code: ConfigErrorCode;
     constructor(code: ConfigErrorCode, message: string);
 }
-/** Reports whether `agent` is one of the registered ids (CLI-7). */
+/** Reports whether `agent` is one of the registered ids (cli-7). */
 export declare function isSupportedAgent(agent: string): agent is SupportedAgent;
 /**
  * Resolves the Coder and optional Reviewer selections from environment configuration
- * (CLI-7, CLI-12): `SLC_AGENT` names a registered agent CLI, `SLC_MODEL`
- * optionally names a model, and `SLC_EFFORT` optionally selects an
+ * (cli-7, cli-12): `SLC_AGENT` names a registered agent CLI, `SLC_MODEL`
+ * optionally names a model, `SLC_EFFORT` optionally selects an
  * adapter-scoped reasoning effort validated against Cligent's support
- * metadata.
+ * metadata, and `SLC_FAST_MODE` — exactly `true` or `false` — optionally
+ * requests adapter-scoped fast mode, accepted or refused by Cligent's
+ * fast-mode capability contract before any agent call.
  *
  * @throws {ConfigError} when `SLC_AGENT` is unset/blank (`agent-unset`) or
- *   outside the registered set (`agent-unsupported`), or when `SLC_EFFORT`
+ *   outside the registered set (`agent-unsupported`), when `SLC_EFFORT`
  *   names a value the selected agent does not support
- *   (`effort-unsupported`); no implicit default agent is applied.
+ *   (`effort-unsupported`), when `SLC_FAST_MODE` is neither `true` nor
+ *   `false` (`fast-mode-invalid`), or when it is set for an agent Cligent
+ *   reports without fast-mode request support (`fast-mode-unsupported`); no
+ *   implicit default agent is applied.
  */
 export declare function resolveAgentSelection(env: Record<string, string | undefined>): AgentSelection;
 /**
- * Builds the interpreted {@link PhaseExecutor} for a selection (CLI-7, CLI-8):
+ * Builds the interpreted {@link PhaseExecutor} for a selection (cli-7, cli-8):
  * constructs the agent CLI's adapter, wraps it as a Cligent-backed transport,
  * and binds the optional model as configuration, not phase semantics
- * (PHEXEC-13). The adapter factory is injectable so tests can fake adapter
+ * (phase-execution-13). The adapter factory is injectable so tests can fake adapter
  * construction; `permissions` is where a host configures the DR-003 write-scope
  * sandbox.
  */
@@ -59,7 +76,7 @@ export declare function createConfiguredExecutor(selection: AgentSelection, opts
     stallTimeoutMs?: number;
 }): PhaseExecutor;
 /**
- * Builds one Cligent-backed {@link AgentClient} for a selection (CLI-7): a fresh
+ * Builds one Cligent-backed {@link AgentClient} for a selection (cli-7): a fresh
  * adapter wrapped as a transport. Each client is a single-flight Cligent
  * instance that resumes its own agent session across calls, so callers wanting
  * isolated sessions construct one client per role or player.
@@ -73,11 +90,16 @@ export declare function createConfiguredAgentClient(selection: AgentSelection, o
 }): AgentClient;
 /**
  * Builds the compiled-execution factory the bin injects as `SlcDeps.compiled`
- * (CLI-8, PHEXEC-27): for a current pinned phase it drives the pinned `playbook`
- * artifact — resolved against its pipeline directory — through the compiled
- * executor, backing the runtime's player ports with one agent transport per
- * player id and its Captain/judge ports with one shared transport (PHEXEC-25),
- * and applying the selected model as the default per-player model (PHEXEC-13).
+ * (cli-8, phase-execution-27): for a current pinned phase it selects the
+ * runtime contract profile ({@link runtimeContractForPin}) and drives the
+ * pinned `playbook` artifact — resolved against its pipeline directory —
+ * through the compiled executor, backing the runtime's player ports with one
+ * agent transport per player id and its Captain/judge ports with one shared
+ * transport; the roleless composed-v3 path rejects its player port before that
+ * lazy player transport is constructed (phase-execution-25). The factory
+ * applies the selected model as the default per-player model
+ * (phase-execution-13). A rejected selection rejects the returned promise
+ * before any artifact loads or transport is built (phase-execution-30).
  */
 export declare function createConfiguredCompiledFactory(selection: AgentSelection, opts?: {
     adapterFactory?: AdapterFactory;
@@ -86,7 +108,38 @@ export declare function createConfiguredCompiledFactory(selection: AgentSelectio
     permissions?: PermissionPolicy;
     /** Agent-stall watchdog window in milliseconds; 0/absent disables (DR-019). */
     stallTimeoutMs?: number;
-    /** Live status sink streaming the runtime's non-trace status (DR-019, PHEXEC-25). */
+    /** Live status sink streaming the runtime's non-trace status (DR-019, phase-execution-25). */
     onStatus?: (line: string) => void;
-}): (choice: CompiledSelection) => PhaseExecutor;
+}): (choice: CompiledSelection) => Promise<PhaseExecutor>;
+/**
+ * The exact historical provenance maps, retained as recorded (DR-028):
+ * absent or Playbook 0.9.0 provenance is the `legacy` contract, and the
+ * reviewed six-port generation is `composed-v2`. Every other provenance is
+ * decided by the installed engine's declaration instead.
+ *
+ * Playbook 0.10 ships the composed six-port contract (DR-011); 1.0.0 is the
+ * published release of that same generation — 0.10.0 was cut locally and
+ * superseded before it reached the registry. 2.0.0 keeps the six-port
+ * boundary and structured results while moving Captain host failures onto
+ * the resolved `failed` path and emitting thin linked modules (DR-017).
+ * 3.1.0 ships runtime.ts byte-identical to 2.0.0 and only adds the additive
+ * DR-022 compat self-report (DR-018), and 4.0.0 keeps runtime.ts and the
+ * engine byte-identical to 3.1.0's — its major marks the SDK-topology break,
+ * not a contract change (DR-020) — so all five select `composed-v2`.
+ */
+export declare function historicalRuntimeContract(provenance: string | undefined): 'legacy' | 'composed-v2' | undefined;
+/**
+ * Selects the runtime contract profile a current pin runs under
+ * (phase-execution-30; DR-010, DR-028). The historical exact maps decide
+ * `legacy` and `composed-v2`; every other provenance selects `composed-v3`
+ * exactly when the pin's link target resolves inside an installed
+ * `@sublang/playbook` whose engine declares `RUNTIME_ABI` `1` and
+ * `SUPPORTED_ARTIFACT_SCHEMAS` containing `3`, whatever its release version.
+ *
+ * @throws naming the declaration — or its absence — when the link target
+ *   lies outside such a package, its engine cannot be read, or it declares
+ *   another ABI or no schema 3; no profile is inferred from callable members
+ *   and no other profile is retried.
+ */
+export declare function runtimeContractForPin(choice: CompiledSelection): Promise<RuntimeContractProfile>;
 //# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AA0BA,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAIvE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAGpD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAErD,sDAAsD;AACtD,eAAO,MAAM,gBAAgB,yDAKnB,CAAC;AAEX,mDAAmD;AACnD,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE/D,uEAAuE;AACvE,MAAM,MAAM,cAAc,GAAG,CAAC,KAAK,EAAE,cAAc,KAAK,YAAY,CAAC;AAErE,mFAAmF;AACnF,eAAO,MAAM,qBAAqB,EAAE,cAWnC,CAAC;AAEF,wEAAwE;AACxE,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,cAAc,CAAC;IACtB,qEAAqE;IACrE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yEAAyE;IACzE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wEAAwE;IACxE,QAAQ,CAAC,EAAE,IAAI,CAAC,cAAc,EAAE,UAAU,CAAC,CAAC;CAC7C;AAED,wEAAwE;AACxE,MAAM,MAAM,eAAe,GACvB,aAAa,GACb,mBAAmB,GACnB,oBAAoB,GACpB,sBAAsB,GACtB,4BAA4B,GAC5B,6BAA6B,CAAC;AAElC,qEAAqE;AACrE,qBAAa,WAAY,SAAQ,KAAK;IACpC,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;gBAEnB,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM;CAKnD;AAED,oEAAoE;AACpE,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,cAAc,CAEvE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,GACtC,cAAc,CAuBhB;AA6CD;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,cAAc,EACzB,IAAI,GAAE;IACJ,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,gBAAgB,CAAC;IAC/B,+EAA+E;IAC/E,cAAc,CAAC,EAAE,MAAM,CAAC;CACpB,GACL,aAAa,CAOf;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CACzC,SAAS,EAAE,cAAc,EACzB,IAAI,GAAE;IACJ,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,gBAAgB,CAAC;IAC/B,+EAA+E;IAC/E,cAAc,CAAC,EAAE,MAAM,CAAC;CACpB,GACL,WAAW,CAWb;AAED;;;;;;;GAOG;AACH,wBAAgB,+BAA+B,CAC7C,SAAS,EAAE,cAAc,EACzB,IAAI,GAAE;IACJ,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,gBAAgB,CAAC;IAC/B,+EAA+E;IAC/E,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,qFAAqF;IACrF,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9B,GACL,CAAC,MAAM,EAAE,iBAAiB,KAAK,aAAa,CAiB9C"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}

package/dist/config.js

@@ -1,38 +1,40 @@
 // SPDX-License-Identifier: Apache-2.0
 // SPDX-FileCopyrightText: 2026 SubLang International <https://sublang.ai>
 /**
- * Agent/model configuration and executor construction for the `slc` bin (CLI-7,
- * CLI-8, CLI-12, DR-004, DR-005).
+ * Agent/model configuration and executor construction for the `slc` bin (cli-7,
+ * cli-8, cli-12, DR-004, DR-005).
  *
  * `resolveAgentSelection` reads the Coder and optional Reviewer selections from
- * the environment and refuses unset or unsupported required values (CLI-12,
+ * the environment and refuses unset or unsupported required values (cli-12,
  * DR-022).
  * `createConfiguredExecutor` builds the interpreted executor and
  * `createConfiguredCompiledFactory` the compiled-execution factory pinned phases
  * select, both over Cligent-backed transports for the selected agent, binding
- * the optional model as configuration — not phase semantics (PHEXEC-13);
+ * the optional model as configuration — not phase semantics (phase-execution-13);
  * credentials are left for the agent CLI to read from the inherited process
  * environment. The adapter factory is injectable so tests can fake adapter
- * construction. See specs/dev/cli.md.
+ * construction. See specs/packages/cli.md.
  */
 import { resolve } from 'node:path';
 import { ClaudeCodeAdapter } from '@sublang/cligent/adapters/claude-code';
 import { CodexAdapter } from '@sublang/cligent/adapters/codex';
 import { GeminiAdapter } from '@sublang/cligent/adapters/gemini';
 import { OpenCodeAdapter } from '@sublang/cligent/adapters/opencode';
-import { isEffortSupported, supportedEffortValues } from '@sublang/cligent';
+import { assertFastModeSupported, isEffortSupported, supportedEffortValues, } from '@sublang/cligent';
 import { createCligentAgent } from './cligent-agent.js';
 import { createCompiledExecutor } from './compiled-executor.js';
+import { messageOf } from './errors.js';
 import { createInterpretedExecutor } from './interpreter.js';
 import { createReviewingAgent } from './reviewing-agent.js';
-/** Agent CLI ids the executable registers (CLI-7). */
+import { declaresComposedV3, describeRuntimeDeclaration, PLAYBOOK_PACKAGE, readPlaybookRuntimeDeclaration, } from './runtime-contract.js';
+/** Agent CLI ids the executable registers (cli-7). */
 export const SUPPORTED_AGENTS = [
     'claude-code',
     'codex',
     'gemini',
     'opencode',
 ];
-/** Default factory: Cligent's built-in adapters, constructed on demand (CLI-7). */
+/** Default factory: Cligent's built-in adapters, constructed on demand (cli-7). */
 export const defaultAdapterFactory = (agent) => {
     switch (agent) {
         case 'claude-code':
@@ -54,30 +56,38 @@ export class ConfigError extends Error {
         this.code = code;
     }
 }
-/** Reports whether `agent` is one of the registered ids (CLI-7). */
+/** Reports whether `agent` is one of the registered ids (cli-7). */
 export function isSupportedAgent(agent) {
     return SUPPORTED_AGENTS.includes(agent);
 }
 /**
  * Resolves the Coder and optional Reviewer selections from environment configuration
- * (CLI-7, CLI-12): `SLC_AGENT` names a registered agent CLI, `SLC_MODEL`
- * optionally names a model, and `SLC_EFFORT` optionally selects an
+ * (cli-7, cli-12): `SLC_AGENT` names a registered agent CLI, `SLC_MODEL`
+ * optionally names a model, `SLC_EFFORT` optionally selects an
  * adapter-scoped reasoning effort validated against Cligent's support
- * metadata.
+ * metadata, and `SLC_FAST_MODE` — exactly `true` or `false` — optionally
+ * requests adapter-scoped fast mode, accepted or refused by Cligent's
+ * fast-mode capability contract before any agent call.
  *
  * @throws {ConfigError} when `SLC_AGENT` is unset/blank (`agent-unset`) or
- *   outside the registered set (`agent-unsupported`), or when `SLC_EFFORT`
+ *   outside the registered set (`agent-unsupported`), when `SLC_EFFORT`
  *   names a value the selected agent does not support
- *   (`effort-unsupported`); no implicit default agent is applied.
+ *   (`effort-unsupported`), when `SLC_FAST_MODE` is neither `true` nor
+ *   `false` (`fast-mode-invalid`), or when it is set for an agent Cligent
+ *   reports without fast-mode request support (`fast-mode-unsupported`); no
+ *   implicit default agent is applied.
  */
 export function resolveAgentSelection(env) {
     const selection = resolveOneSelection(env, {
         agent: 'SLC_AGENT',
         model: 'SLC_MODEL',
         effort: 'SLC_EFFORT',
+        fastMode: 'SLC_FAST_MODE',
         unsetCode: 'agent-unset',
         unsupportedCode: 'agent-unsupported',
         effortCode: 'effort-unsupported',
+        fastModeInvalidCode: 'fast-mode-invalid',
+        fastModeCode: 'fast-mode-unsupported',
         required: true,
     });
     if (selection === undefined) {
@@ -87,9 +97,12 @@ export function resolveAgentSelection(env) {
         agent: 'SLC_REVIEWER_AGENT',
         model: 'SLC_REVIEWER_MODEL',
         effort: 'SLC_REVIEWER_EFFORT',
+        fastMode: 'SLC_REVIEWER_FAST_MODE',
         unsetCode: 'reviewer-agent-unset',
         unsupportedCode: 'reviewer-agent-unsupported',
         effortCode: 'reviewer-effort-unsupported',
+        fastModeInvalidCode: 'reviewer-fast-mode-invalid',
+        fastModeCode: 'reviewer-fast-mode-unsupported',
         required: false,
     });
     return reviewer === undefined ? selection : { ...selection, reviewer };
@@ -98,12 +111,14 @@ function resolveOneSelection(env, names) {
     const agent = (env[names.agent] ?? '').trim();
     const model = (env[names.model] ?? '').trim();
     const effort = (env[names.effort] ?? '').trim();
+    const fastMode = (env[names.fastMode] ?? '').trim();
     if (agent === '') {
-        if (!names.required && model === '' && effort === '')
+        if (!names.required && model === '' && effort === '' && fastMode === '') {
             return undefined;
+        }
         throw new ConfigError(names.unsetCode, names.required
             ? `${names.agent} is not set; set it to one of: ${SUPPORTED_AGENTS.join(', ')}`
-            : `${names.agent} is not set; ${names.model} and ${names.effort} require a reviewer agent; set ${names.agent} to one of: ${SUPPORTED_AGENTS.join(', ')}`);
+            : `${names.agent} is not set; ${names.model}, ${names.effort}, and ${names.fastMode} require a reviewer agent; set ${names.agent} to one of: ${SUPPORTED_AGENTS.join(', ')}`);
     }
     if (!isSupportedAgent(agent)) {
         throw new ConfigError(names.unsupportedCode, `${names.agent} "${agent}" is not a supported agent CLI; choose one of: ${SUPPORTED_AGENTS.join(', ')}`);
@@ -111,17 +126,31 @@ function resolveOneSelection(env, names) {
     if (effort !== '' && !isEffortSupported(agent, effort)) {
         throw new ConfigError(names.effortCode, `${names.effort} "${effort}" is not supported by ${agent}; choose one of: ${(supportedEffortValues(agent) ?? []).join(', ')}`);
     }
+    if (fastMode !== '' && fastMode !== 'true' && fastMode !== 'false') {
+        throw new ConfigError(names.fastModeInvalidCode, `${names.fastMode} "${fastMode}" must be exactly true or false`);
+    }
+    if (fastMode !== '') {
+        // Cligent owns adapter capability: a literal request — `false` included —
+        // is accepted or refused by its contract, naming the adapter (cli-7).
+        try {
+            assertFastModeSupported(agent, names.fastMode);
+        }
+        catch (error) {
+            throw new ConfigError(names.fastModeCode, messageOf(error));
+        }
+    }
     return {
         agent,
         model: model === '' ? undefined : model,
         effort: effort === '' ? undefined : effort,
+        fastMode: fastMode === '' ? undefined : fastMode === 'true',
     };
 }
 /**
- * Builds the interpreted {@link PhaseExecutor} for a selection (CLI-7, CLI-8):
+ * Builds the interpreted {@link PhaseExecutor} for a selection (cli-7, cli-8):
  * constructs the agent CLI's adapter, wraps it as a Cligent-backed transport,
  * and binds the optional model as configuration, not phase semantics
- * (PHEXEC-13). The adapter factory is injectable so tests can fake adapter
+ * (phase-execution-13). The adapter factory is injectable so tests can fake adapter
  * construction; `permissions` is where a host configures the DR-003 write-scope
  * sandbox.
  */
@@ -134,7 +163,7 @@ export function createConfiguredExecutor(selection, opts = {}) {
     });
 }
 /**
- * Builds one Cligent-backed {@link AgentClient} for a selection (CLI-7): a fresh
+ * Builds one Cligent-backed {@link AgentClient} for a selection (cli-7): a fresh
  * adapter wrapped as a transport. Each client is a single-flight Cligent
  * instance that resumes its own agent session across calls, so callers wanting
  * isolated sessions construct one client per role or player.
@@ -146,33 +175,42 @@ export function createConfiguredAgentClient(selection, opts = {}) {
         maxTurns: opts.maxTurns,
         permissions: opts.permissions,
         effort: selection.effort,
+        fastMode: selection.fastMode,
         stallTimeoutMs: opts.stallTimeoutMs,
     });
 }
 /**
  * Builds the compiled-execution factory the bin injects as `SlcDeps.compiled`
- * (CLI-8, PHEXEC-27): for a current pinned phase it drives the pinned `playbook`
- * artifact — resolved against its pipeline directory — through the compiled
- * executor, backing the runtime's player ports with one agent transport per
- * player id and its Captain/judge ports with one shared transport (PHEXEC-25),
- * and applying the selected model as the default per-player model (PHEXEC-13).
+ * (cli-8, phase-execution-27): for a current pinned phase it selects the
+ * runtime contract profile ({@link runtimeContractForPin}) and drives the
+ * pinned `playbook` artifact — resolved against its pipeline directory —
+ * through the compiled executor, backing the runtime's player ports with one
+ * agent transport per player id and its Captain/judge ports with one shared
+ * transport; the roleless composed-v3 path rejects its player port before that
+ * lazy player transport is constructed (phase-execution-25). The factory
+ * applies the selected model as the default per-player model
+ * (phase-execution-13). A rejected selection rejects the returned promise
+ * before any artifact loads or transport is built (phase-execution-30).
  */
 export function createConfiguredCompiledFactory(selection, opts = {}) {
     const client = () => {
         const coder = createConfiguredAgentClient(selection, opts);
         return configuredReviewingClient(selection, coder, opts);
     };
-    return (choice) => createCompiledExecutor({
-        artifactPath: resolve(choice.pipelineDir, choice.record.artifact.path),
-        runRoot: opts.cwd ?? process.cwd(),
-        playbookId: choice.phase,
-        runtimeContract: runtimeContractForPin(choice),
-        player: () => client(),
-        judge: client(),
-        defaultModel: selection.model,
-        cwd: opts.cwd,
-        onStatus: opts.onStatus,
-    });
+    return async (choice) => {
+        const runtimeContract = await runtimeContractForPin(choice);
+        return createCompiledExecutor({
+            artifactPath: resolve(choice.pipelineDir, choice.record.artifact.path),
+            runRoot: opts.cwd ?? process.cwd(),
+            playbookId: choice.phase,
+            runtimeContract,
+            player: () => client(),
+            judge: client(),
+            defaultModel: selection.model,
+            cwd: opts.cwd,
+            onStatus: opts.onStatus,
+        });
+    };
 }
 function configuredReviewingClient(selection, coder, opts) {
     const reviewer = selection.reviewer;
@@ -193,25 +231,26 @@ function configuredReviewingClient(selection, coder, opts) {
         reviewerModel: reviewer.model,
     });
 }
-function runtimeContractForPin(choice) {
-    const provenance = choice.record.linkTarget.provenance;
+/**
+ * The exact historical provenance maps, retained as recorded (DR-028):
+ * absent or Playbook 0.9.0 provenance is the `legacy` contract, and the
+ * reviewed six-port generation is `composed-v2`. Every other provenance is
+ * decided by the installed engine's declaration instead.
+ *
+ * Playbook 0.10 ships the composed six-port contract (DR-011); 1.0.0 is the
+ * published release of that same generation — 0.10.0 was cut locally and
+ * superseded before it reached the registry. 2.0.0 keeps the six-port
+ * boundary and structured results while moving Captain host failures onto
+ * the resolved `failed` path and emitting thin linked modules (DR-017).
+ * 3.1.0 ships runtime.ts byte-identical to 2.0.0 and only adds the additive
+ * DR-022 compat self-report (DR-018), and 4.0.0 keeps runtime.ts and the
+ * engine byte-identical to 3.1.0's — its major marks the SDK-topology break,
+ * not a contract change (DR-020) — so all five select `composed-v2`.
+ */
+export function historicalRuntimeContract(provenance) {
     if (provenance === undefined || provenance === '@sublang/playbook@0.9.0') {
         return 'legacy';
     }
-    // Playbook 0.10 ships the composed six-port contract (DR-011); artifacts
-    // linked against it run through the composed session profile. 1.0.0 is the
-    // published release of that same contract generation — 0.10.0 was cut
-    // locally and superseded before it ever reached the registry. 2.0.0 keeps
-    // the six-port boundary and structured results while moving Captain host
-    // failures onto the resolved `failed` path and emitting thin linked
-    // modules (DR-017), so all three provenances select the composed profile.
-    // 3.1.0 ships runtime.ts byte-identical to 2.0.0 and only adds the
-    // additive DR-022 compat self-report on the shared engine, so it selects
-    // the same profile (DR-018). 4.0.0 keeps runtime.ts and the engine
-    // byte-identical to 3.1.0's — its major marks the SDK-topology break,
-    // with cligent owning runtime versions, not a contract change — so it
-    // selects the same profile (DR-020). 1.3.0 and 3.0.0 were never
-    // installed or reviewed here and stay fail-closed.
     if (provenance === '@sublang/playbook@0.10.0' ||
         provenance === '@sublang/playbook@1.0.0' ||
         provenance === '@sublang/playbook@2.0.0' ||
@@ -219,6 +258,43 @@ function runtimeContractForPin(choice) {
         provenance === '@sublang/playbook@4.0.0') {
         return 'composed-v2';
     }
-    throw new Error(`unsupported pinned Playbook runtime contract: ${provenance}`);
+    return undefined;
+}
+/**
+ * Selects the runtime contract profile a current pin runs under
+ * (phase-execution-30; DR-010, DR-028). The historical exact maps decide
+ * `legacy` and `composed-v2`; every other provenance selects `composed-v3`
+ * exactly when the pin's link target resolves inside an installed
+ * `@sublang/playbook` whose engine declares `RUNTIME_ABI` `1` and
+ * `SUPPORTED_ARTIFACT_SCHEMAS` containing `3`, whatever its release version.
+ *
+ * @throws naming the declaration — or its absence — when the link target
+ *   lies outside such a package, its engine cannot be read, or it declares
+ *   another ABI or no schema 3; no profile is inferred from callable members
+ *   and no other profile is retried.
+ */
+export async function runtimeContractForPin(choice) {
+    const provenance = choice.record.linkTarget.provenance;
+    const historical = historicalRuntimeContract(provenance);
+    if (historical !== undefined)
+        return historical;
+    const locator = choice.record.linkTarget.locator;
+    const reject = (reason) => {
+        throw new Error(`unsupported pinned Playbook runtime contract: ${provenance} (${reason})`);
+    };
+    let declaration;
+    try {
+        declaration = await readPlaybookRuntimeDeclaration(resolve(choice.pipelineDir, locator));
+    }
+    catch (error) {
+        return reject(messageOf(error));
+    }
+    if (declaration === undefined) {
+        return reject(`link target ${locator} is not inside an installed ${PLAYBOOK_PACKAGE} package`);
+    }
+    if (!declaresComposedV3(declaration)) {
+        return reject(`${describeRuntimeDeclaration(declaration)}; composed-v3 requires RUNTIME_ABI 1 and artifact schema 3`);
+    }
+    return 'composed-v3';
 }
 //# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/emitted-imports.d.ts

@@ -1,3 +1,17 @@
+/** One deterministic extension correction applied to an emitted import. */
+export interface ImportSpecifierRewrite {
+    from: string;
+    to: string;
+}
+/**
+ * Settles relative `.js`/`.ts` imports of the link's object artifacts from the
+ * files that actually exist beside an emitted module. A materialized
+ * JavaScript sibling wins; otherwise the declared TypeScript object's sibling
+ * is used when present. Unrelated imports and object specifiers with neither
+ * sibling are left for
+ * {@link unresolvableRelativeImports} to reject.
+ */
+export declare function reconcileLinkObjectImportSpecifiers(modulePath: string, objectPaths: readonly string[]): Promise<ImportSpecifierRewrite[]>;
 /**
  * The relative import specifiers of a `.ts`/`.js` module that do not resolve
  * to an existing file from the module's own directory, in source order.

package/dist/emitted-imports.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"emitted-imports.d.ts","sourceRoot":"","sources":["../src/emitted-imports.ts"],"names":[],"mappings":"AAqBA;;;GAGG;AACH,wBAAsB,2BAA2B,CAC/C,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,EAAE,CAAC,CAWnB"}
+{"version":3,"file":"emitted-imports.d.ts","sourceRoot":"","sources":["../src/emitted-imports.ts"],"names":[],"mappings":"AAuBA,2EAA2E;AAC3E,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;CACZ;AAKD;;;;;;;GAOG;AACH,wBAAsB,mCAAmC,CACvD,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,SAAS,MAAM,EAAE,GAC7B,OAAO,CAAC,sBAAsB,EAAE,CAAC,CA8CnC;AAED;;;GAGG;AACH,wBAAsB,2BAA2B,CAC/C,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,EAAE,CAAC,CAWnB"}

package/dist/emitted-imports.js

@@ -1,19 +1,75 @@
 // SPDX-License-Identifier: Apache-2.0
 // SPDX-FileCopyrightText: 2026 SubLang International <https://sublang.ai>
 /**
- * Deterministic load-integrity check for emitted modules (VERIFY-18).
+ * Deterministic link-object import settlement and load-integrity checks for
+ * emitted modules (pipeline-40, verification-18).
  *
  * A linked artifact is code whose relative imports Node resolves with exact
  * specifiers — `./workflow.fsm.js` does not find `workflow.fsm.ts`. An
- * agent-performed link can emit the wrong extension, and a compile that
- * reports success for a module that cannot load defers the failure to the
- * first `playbook run`. This check reads the emitted module and requires
- * every relative specifier to name an existing file beside it.
+ * agent-performed link can emit the wrong extension for its object import. The
+ * host settles that exact edge mechanically against a `.js` or `.ts` sibling
+ * that currently exists, then requires every relative specifier to name an
+ * existing file beside it. A genuinely unloadable module still fails before
+ * the first `playbook run`.
  */
-import { existsSync } from 'node:fs';
-import { readFile } from 'node:fs/promises';
+import { existsSync, statSync } from 'node:fs';
+import { readFile, writeFile } from 'node:fs/promises';
 import { dirname, resolve } from 'node:path';
 const IMPORT_SPECIFIER = /\bfrom\s+(['"])([^'"\n]+)\1|\bimport\s*\(\s*(['"])([^'"\n]+)\3\s*\)|\bimport\s+(['"])([^'"\n]+)\5/g;
+const isRegularFile = (path) => statSync(path, { throwIfNoEntry: false })?.isFile() ?? false;
+/**
+ * Settles relative `.js`/`.ts` imports of the link's object artifacts from the
+ * files that actually exist beside an emitted module. A materialized
+ * JavaScript sibling wins; otherwise the declared TypeScript object's sibling
+ * is used when present. Unrelated imports and object specifiers with neither
+ * sibling are left for
+ * {@link unresolvableRelativeImports} to reject.
+ */
+export async function reconcileLinkObjectImportSpecifiers(modulePath, objectPaths) {
+    const source = await readFile(modulePath, 'utf8');
+    const dir = dirname(modulePath);
+    const emittedPath = resolve(modulePath);
+    const objectStems = new Set(objectPaths
+        .map((path) => resolve(path))
+        .filter((path) => path.endsWith('.js') || path.endsWith('.ts'))
+        .map((path) => path.slice(0, -3)));
+    const rewrites = [];
+    let cursor = 0;
+    let reconciled = '';
+    for (const match of source.matchAll(IMPORT_SPECIFIER)) {
+        const specifier = match[2] ?? match[4] ?? match[6];
+        if (specifier === undefined || match.index === undefined)
+            continue;
+        if (!specifier.startsWith('./') && !specifier.startsWith('../'))
+            continue;
+        if (!specifier.endsWith('.js') && !specifier.endsWith('.ts'))
+            continue;
+        const stem = specifier.slice(0, -3);
+        if (!objectStems.has(resolve(dir, stem)))
+            continue;
+        const jsSpecifier = `${stem}.js`;
+        const tsSpecifier = `${stem}.ts`;
+        const jsPath = resolve(dir, jsSpecifier);
+        const tsPath = resolve(dir, tsSpecifier);
+        const preferred = jsPath !== emittedPath && isRegularFile(jsPath)
+            ? jsSpecifier
+            : tsPath !== emittedPath && isRegularFile(tsPath)
+                ? tsSpecifier
+                : specifier;
+        if (preferred === specifier)
+            continue;
+        const specifierIndex = match[0].indexOf(specifier);
+        const start = match.index + specifierIndex;
+        reconciled += source.slice(cursor, start) + preferred;
+        cursor = start + specifier.length;
+        rewrites.push({ from: specifier, to: preferred });
+    }
+    if (rewrites.length > 0) {
+        reconciled += source.slice(cursor);
+        await writeFile(modulePath, reconciled, 'utf8');
+    }
+    return rewrites;
+}
 /**
  * The relative import specifiers of a `.ts`/`.js` module that do not resolve
  * to an existing file from the module's own directory, in source order.