@sublang/slc 0.1.0

package/dist/app.js

@@ -0,0 +1,233 @@
+// SPDX-License-Identifier: Apache-2.0
+// SPDX-FileCopyrightText: 2026 SubLang International <https://sublang.ai>
+/**
+ * The `slc` bin orchestrator (CLI package).
+ *
+ * `run` is the testable command-line entry: it short-circuits `--version` and
+ * `--help` before touching any pipeline or agent (CLI-1, CLI-2, CLI-9), builds
+ * the run dependencies from environment configuration (CLI-6, CLI-7, CLI-12),
+ * invokes the injectable `runSlc` core under a cancellation signal (CLI-10), and
+ * maps the result onto process streams and an exit code — produced artifact
+ * paths to stdout on success, the failure report to stderr otherwise (CLI-3,
+ * CLI-4, CLI-11). Every IO seam is injectable so the bin is integration-testable
+ * without a real agent; the `cli.ts` shim supplies the process-backed defaults
+ * and signal wiring. See specs/dev/cli.md and specs/user/cli.md.
+ */
+import { createRequire } from 'node:module';
+import { createConfiguredCompiledFactory, createConfiguredExecutor, resolveAgentSelection, } from './config.js';
+import { loadConfigFile } from './config-file.js';
+import { createPipelineResolver, pipelineSearchRoots, withReservedPipelines, } from './resolver.js';
+import { runSlc } from './runner.js';
+const manifest = createRequire(import.meta.url)('../package.json');
+if (typeof manifest.version !== 'string') {
+    throw new TypeError('package.json version must be a string');
+}
+const packageVersion = manifest.version;
+/** The program name. */
+export const name = 'slc';
+/** Returns the slc version string. */
+export function version() {
+    return packageVersion;
+}
+/**
+ * Builds the production {@link SlcDeps}: a pipeline resolver over the resolved
+ * search roots (CLI-6) — with the reserved `slc` reference routed to the
+ * meta-pipeline definitions `@sublang/playbook` provides (SELFHOST-2) — an
+ * interpreted executor for the resolved agent/model (CLI-7), and the
+ * compiled-execution factory a current pinned phase selects (CLI-8, PHEXEC-27).
+ * Configuration is loaded from the config file (DR-006, CLI-20) and
+ * then overridden per key by a non-blank environment variable, so existing
+ * env-only runs are unchanged and the file fills any key the environment leaves
+ * unset.
+ *
+ * @throws {import('./config-file.js').ConfigFileError} when an explicit
+ *   `--config` path is absent or the file is malformed or invalid (CLI-21).
+ * @throws {import('./config.js').ConfigError} when neither source supplies an
+ *   agent, or the resolved agent is unsupported (CLI-12).
+ */
+export async function buildSlcDeps({ env, cwd, signal, configPath, note }, 
+// Injectable so a test can capture the executor options — notably the
+// non-interactive write permission below — without constructing a real
+// adapter, the same seam pattern as `createConfiguredExecutor`'s
+// `adapterFactory`. Defaults to the production factories.
+createExecutor = createConfiguredExecutor, createCompiled = createConfiguredCompiledFactory) {
+    const file = await loadConfigFile({
+        cwd,
+        configPath,
+        env,
+        // First-run seeding (DR-015): name the created user config on stderr.
+        onSeed: (path) => note?.(`slc: seeded ${path} (agent: claude-code)\n`),
+    });
+    const { selection, pipelinePath } = resolveRunConfig(env, file.config);
+    const resolver = withReservedPipelines(createPipelineResolver(pipelineSearchRoots(pipelinePath, cwd)));
+    // Auto-accept the agents' file operations so a non-interactive `slc` run can
+    // write its target artifact; the DR-003 generic checks still guard the
+    // protected inputs (DR-004).
+    const agentOpts = { cwd, permissions: { mode: 'auto' } };
+    const executor = createExecutor(selection, agentOpts);
+    const compiled = createCompiled(selection, agentOpts);
+    return { resolver, executor, compiled, cwd, signal };
+}
+/**
+ * Merges the environment over config-file values per key (DR-006, CLI-20): for
+ * each key a non-blank environment variable wins, otherwise the file value,
+ * otherwise the built-in default. The agent and model go through
+ * {@link resolveAgentSelection} so the supported-agent check stays single-sourced
+ * (CLI-7, CLI-12).
+ */
+export function resolveRunConfig(env, file) {
+    const selection = resolveAgentSelection({
+        SLC_AGENT: nonBlank(env.SLC_AGENT) ?? file.agent,
+        SLC_MODEL: nonBlank(env.SLC_MODEL) ?? file.model,
+        SLC_EFFORT: nonBlank(env.SLC_EFFORT) ?? file.effort,
+    });
+    const pipelinePath = nonBlank(env.SLC_PIPELINE_PATH) ?? file.pipelinePath;
+    return { selection, pipelinePath };
+}
+/** Returns `value` when set and not all-whitespace, else `undefined` (DR-006). */
+function nonBlank(value) {
+    return value !== undefined && value.trim() !== '' ? value : undefined;
+}
+/** Usage text naming the documented invocation forms and configuration (CLI-2). */
+export function usageText() {
+    return [
+        'Usage:',
+        '  slc <pipeline>[.<phase>] <source> [-o <target>]',
+        '  slc <pipeline> <source> [--normalize] [--no-optimize] [--link <target>] [--link-option name=value]...',
+        '  slc <pipeline>.link <object>... <target> [-o <linked>] [--link-option name=value]...',
+        '',
+        'Artifacts land in the working directory (<cwd>/<basename>.<pipeline>/);',
+        'an entry source with a foreign extension is normalized first, and the',
+        'playbook pipeline links against the installed @sublang/playbook runtime',
+        'when --link is omitted, also emitting the runnable <basename>.ts entry.',
+        '',
+        'Options:',
+        '  -o <path>                 final output path override',
+        '  --link <target>           link the full-pipeline output to <target>',
+        '  --link-option name=value  pass an opaque option to the link phase',
+        "  --normalize               rewrite raw input to the entry phase's source form first",
+        "  -O, --optimize            run the pipeline's pass phases (the default)",
+        '  --no-optimize             run the chain without pass phases',
+        '  --config <path>           load configuration from <path> (disables discovery)',
+        '  -v, --version             print version and exit',
+        '  -h, --help                print this help and exit',
+        '',
+        'Configuration:',
+        '  Config file (YAML), discovered in order, then overridden per key by the',
+        '  environment variable below:',
+        '    ./slc.config.yaml',
+        '    ${XDG_CONFIG_HOME:-~/.config}/slc/config.yaml',
+        '  Keys: agent, model, effort, pipelinePath.',
+        '',
+        '  SLC_AGENT          agent CLI: claude-code | codex | gemini | opencode',
+        '  SLC_MODEL          optional model for the agent CLI',
+        '  SLC_EFFORT         optional adapter-scoped reasoning effort (e.g. xhigh)',
+        '  SLC_PIPELINE_PATH  search roots for <pipeline> references (default: cwd)',
+        '',
+    ].join('\n');
+}
+/**
+ * Splits `--config <path>` out of argv, returning the path and the remaining
+ * arguments for `runSlc` (CLI-20). `--config` is a bin-level flag, so it is
+ * removed before the grammar parser, which rejects unknown options.
+ *
+ * @throws {Error} when `--config` is given without a following value.
+ */
+function extractConfigFlag(argv) {
+    const rest = [];
+    let configPath;
+    for (let i = 0; i < argv.length; i++) {
+        if (argv[i] === '--config') {
+            const value = argv[++i];
+            if (value === undefined) {
+                throw new Error('missing value for --config <path>');
+            }
+            configPath = value;
+        }
+        else {
+            rest.push(argv[i]);
+        }
+    }
+    return { configPath, rest };
+}
+/**
+ * Runs the `slc` command line and returns a process exit code (CLI package).
+ * Never rejects: configuration refusals and run failures are reported and
+ * mapped to a non-zero code.
+ */
+export async function run(argv, options = {}) {
+    const stdout = options.stdout ?? ((text) => void process.stdout.write(text));
+    const stderr = options.stderr ?? ((text) => void process.stderr.write(text));
+    // Conveniences short-circuit before any pipeline or agent work (CLI-1, CLI-2, CLI-9).
+    if (hasFlag(argv, '--version', '-v')) {
+        stdout(`${name} ${version()}\n`);
+        return 0;
+    }
+    if (hasFlag(argv, '--help', '-h')) {
+        stdout(usageText());
+        return 0;
+    }
+    const env = options.env ?? process.env;
+    const cwd = options.cwd ?? process.cwd();
+    const signal = options.signal ?? new AbortController().signal;
+    let deps;
+    let rest;
+    try {
+        // `--config <path>` is a bin-level flag: strip it before runSlc, whose
+        // grammar (parseInvocation) rejects unknown options (CLI-20).
+        const extracted = extractConfigFlag(argv);
+        rest = extracted.rest;
+        deps = await (options.buildDeps ?? buildSlcDeps)({
+            env,
+            cwd,
+            signal,
+            configPath: extracted.configPath,
+            note: stderr,
+        });
+    }
+    catch (error) {
+        // Configuration refusals — a bad `--config`, an invalid config file
+        // (CLI-21), or an unset/unsupported agent (CLI-12) — fail the run.
+        stderr(`${name}: ${messageOf(error)}\n`);
+        return 1;
+    }
+    const result = await runSlc(rest, deps);
+    if (result.ok) {
+        if (result.outputs.length > 0)
+            stdout(`${result.outputs.join('\n')}\n`);
+        // Surface any ambiguity the agent resolved without polluting the path output.
+        if (result.diagnostics.length > 0)
+            stderr(`${result.diagnostics.join('\n')}\n`);
+        return 0;
+    }
+    if (result.diagnostics.length > 0)
+        stderr(`${result.diagnostics.join('\n')}\n`);
+    return 1;
+}
+/**
+ * Wires `SIGINT`/`SIGTERM` on `emitter` to abort a fresh controller, returning
+ * its cancellation signal and a disposer that removes the listeners (CLI-10).
+ * The `cli.ts` shim passes `process`; tests pass a fake emitter so the
+ * interrupt-to-abort wiring is exercised without real signals.
+ */
+export function interruptSignal(emitter) {
+    const controller = new AbortController();
+    const onInterrupt = () => controller.abort();
+    emitter.once('SIGINT', onInterrupt);
+    emitter.once('SIGTERM', onInterrupt);
+    return {
+        signal: controller.signal,
+        dispose: () => {
+            emitter.removeListener('SIGINT', onInterrupt);
+            emitter.removeListener('SIGTERM', onInterrupt);
+        },
+    };
+}
+/** True when argv contains any of the given exact flag tokens. */
+function hasFlag(argv, ...flags) {
+    return argv.some((arg) => flags.includes(arg));
+}
+function messageOf(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=app.js.map

package/dist/app.js.map

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

package/dist/artifacts.d.ts

@@ -0,0 +1,61 @@
+import type { Phase } from './phase.js';
+/** Machine-readable reason a source path was refused. */
+export type SourceErrorCode = 'invalid-source-name';
+/** Raised when a source filename matches no applicable form (PIPE-6). */
+export declare class SourceError extends Error {
+    readonly code: SourceErrorCode;
+    constructor(code: SourceErrorCode, message: string);
+}
+/** A source filename decomposed into its basename, plus the raw-input marker. */
+export interface ParsedSource {
+    /** Basename with any trailing `.<source-format>` and extension stripped. */
+    basename: string;
+    /**
+     * True when an entry source carries a foreign extension: a raw input whose
+     * compilation auto-schedules normalization (DR-014, PIPE-6, PIPE-34).
+     */
+    raw: boolean;
+}
+/**
+ * Validates a source path against the consuming phase's source format and
+ * extension, returning its `<basename>` (PIPE-6).
+ *
+ * The non-entry form requires `<basename>.<source-format>.<ext>`; the entry form
+ * also accepts the plain `<basename>.<ext>`, and an entry source with any other
+ * extension is a raw input whose `<basename>` is the name minus its actual
+ * extension (DR-014).
+ *
+ * @throws {SourceError} when the name matches no applicable form.
+ */
+export declare function parseSource(opts: {
+    path: string;
+    sourceFormat: string;
+    ext: string;
+    entry: boolean;
+}): ParsedSource;
+/**
+ * Computes the artifact directory under the invocation working directory,
+ * reusing the working directory itself without nesting when its leaf is
+ * already the canonical `<basename>.<pipeline>` (PIPE-7, DR-014).
+ */
+export declare function artifactDir(cwd: string, basename: string, pipeline: string): string;
+/** Computes the canonical path of a `<basename>.<format>.<ext>` artifact (PIPE-8). */
+export declare function artifactPath(artDir: string, basename: string, format: string, ext: string): string;
+/** A planned artifact: the phase that writes it, its path, and its pipeline role. */
+export interface ArtifactPlan {
+    phase: Phase;
+    path: string;
+    role: 'intermediate' | 'output';
+}
+/**
+ * Plans the target artifact each phase writes: every non-terminal phase writes a
+ * canonical intermediate, and the terminal phase writes the output, overridden by
+ * `output` (`-o`) when provided while intermediates stay canonical (PIPE-8).
+ */
+export declare function planArtifacts(opts: {
+    phases: readonly Phase[];
+    basename: string;
+    artDir: string;
+    output?: string;
+}): ArtifactPlan[];
+//# sourceMappingURL=artifacts.d.ts.map

package/dist/artifacts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifacts.d.ts","sourceRoot":"","sources":["../src/artifacts.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAExC,yDAAyD;AACzD,MAAM,MAAM,eAAe,GAAG,qBAAqB,CAAC;AAEpD,yEAAyE;AACzE,qBAAa,WAAY,SAAQ,KAAK;IACpC,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;gBAEnB,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM;CAKnD;AAED,iFAAiF;AACjF,MAAM,WAAW,YAAY;IAC3B,4EAA4E;IAC5E,QAAQ,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,GAAG,EAAE,OAAO,CAAC;CACd;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,OAAO,CAAC;CAChB,GAAG,YAAY,CA4Cf;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CACzB,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GACf,MAAM,CAMR;AAED,sFAAsF;AACtF,wBAAgB,YAAY,CAC1B,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,GACV,MAAM,CAER;AAED,qFAAqF;AACrF,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,KAAK,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,cAAc,GAAG,QAAQ,CAAC;CACjC;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE;IAClC,MAAM,EAAE,SAAS,KAAK,EAAE,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,YAAY,EAAE,CAgBjB"}

package/dist/artifacts.js

@@ -0,0 +1,97 @@
+// SPDX-License-Identifier: Apache-2.0
+// SPDX-FileCopyrightText: 2026 SubLang International <https://sublang.ai>
+/**
+ * Source-name validation and artifact-path computation (DR-001, DR-014).
+ *
+ * Implements PIPE-6 (the entry/non-entry source filename forms, with a
+ * foreign-extension entry source accepted as a raw input), PIPE-7 (compute the
+ * artifact directory under the invocation working directory, reusing it without
+ * nesting), and PIPE-8 (place intermediates and the output, honoring `-o`). See
+ * specs/dev/pipeline.md.
+ */
+import { basename as pathBasename, extname, join } from 'node:path';
+/** Raised when a source filename matches no applicable form (PIPE-6). */
+export class SourceError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.name = 'SourceError';
+        this.code = code;
+    }
+}
+/**
+ * Validates a source path against the consuming phase's source format and
+ * extension, returning its `<basename>` (PIPE-6).
+ *
+ * The non-entry form requires `<basename>.<source-format>.<ext>`; the entry form
+ * also accepts the plain `<basename>.<ext>`, and an entry source with any other
+ * extension is a raw input whose `<basename>` is the name minus its actual
+ * extension (DR-014).
+ *
+ * @throws {SourceError} when the name matches no applicable form.
+ */
+export function parseSource(opts) {
+    const { path, sourceFormat, ext, entry } = opts;
+    const name = pathBasename(path);
+    if (!name.endsWith(ext)) {
+        if (entry) {
+            const actualExt = extname(name);
+            const basename = actualExt === '' ? name : name.slice(0, -actualExt.length);
+            if (basename.length === 0) {
+                throw new SourceError('invalid-source-name', `source "${name}" has an empty basename`);
+            }
+            return { basename, raw: true };
+        }
+        throw new SourceError('invalid-source-name', `source "${name}" must end with "${ext}"`);
+    }
+    const stem = name.slice(0, name.length - ext.length);
+    const qualifier = `.${sourceFormat}`;
+    let basename;
+    if (stem.endsWith(qualifier)) {
+        basename = stem.slice(0, stem.length - qualifier.length);
+    }
+    else if (entry) {
+        basename = stem;
+    }
+    else {
+        throw new SourceError('invalid-source-name', `source "${name}" must be named "<basename>.${sourceFormat}${ext}"`);
+    }
+    if (basename.length === 0) {
+        throw new SourceError('invalid-source-name', `source "${name}" has an empty basename`);
+    }
+    return { basename, raw: false };
+}
+/**
+ * Computes the artifact directory under the invocation working directory,
+ * reusing the working directory itself without nesting when its leaf is
+ * already the canonical `<basename>.<pipeline>` (PIPE-7, DR-014).
+ */
+export function artifactDir(cwd, basename, pipeline) {
+    const canonicalLeaf = `${basename}.${pipeline}`;
+    if (pathBasename(cwd) === canonicalLeaf) {
+        return cwd;
+    }
+    return join(cwd, canonicalLeaf);
+}
+/** Computes the canonical path of a `<basename>.<format>.<ext>` artifact (PIPE-8). */
+export function artifactPath(artDir, basename, format, ext) {
+    return join(artDir, `${basename}.${format}${ext}`);
+}
+/**
+ * Plans the target artifact each phase writes: every non-terminal phase writes a
+ * canonical intermediate, and the terminal phase writes the output, overridden by
+ * `output` (`-o`) when provided while intermediates stay canonical (PIPE-8).
+ */
+export function planArtifacts(opts) {
+    const { phases, basename, artDir, output } = opts;
+    return phases.map((phase, index) => {
+        const isTerminal = index === phases.length - 1;
+        const canonical = artifactPath(artDir, basename, phase.target.format, phase.target.ext);
+        return {
+            phase,
+            role: isTerminal ? 'output' : 'intermediate',
+            path: isTerminal && output !== undefined ? output : canonical,
+        };
+    });
+}
+//# sourceMappingURL=artifacts.js.map

package/dist/artifacts.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

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

package/dist/cli.js

@@ -0,0 +1,26 @@
+#!/usr/bin/env node
+// SPDX-License-Identifier: Apache-2.0
+// SPDX-FileCopyrightText: 2026 SubLang International <https://sublang.ai>
+/**
+ * The published `slc` executable shim (CLI package).
+ *
+ * It supplies the process-backed defaults `run` falls back to and wires
+ * cancellation through `interruptSignal`: an interrupt aborts the in-flight run
+ * via the signal passed into `runSlc` (CLI-10), and the returned exit code
+ * becomes the process exit status (CLI-11). All behavior lives in the testable
+ * `run`/`interruptSignal`; see app.ts.
+ */
+import { interruptSignal, run } from './index.js';
+const { signal, dispose } = interruptSignal(process);
+run(process.argv.slice(2), { signal })
+    .then((code) => {
+    dispose();
+    process.exit(code);
+})
+    .catch((error) => {
+    dispose();
+    const message = error instanceof Error ? error.message : String(error);
+    process.stderr.write(`slc: ${message}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,sCAAsC;AACtC,0EAA0E;AAE1E;;;;;;;;GAQG;AAEH,OAAO,EAAE,eAAe,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AAElD,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;AAErD,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC;KACnC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE;IACb,OAAO,EAAE,CAAC;IACV,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACrB,CAAC,CAAC;KACD,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;IACxB,OAAO,EAAE,CAAC;IACV,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,OAAO,IAAI,CAAC,CAAC;IAC1C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/cligent-agent.d.ts

@@ -0,0 +1,11 @@
+import type { AgentAdapter, PermissionPolicy } from '@sublang/cligent';
+import type { AgentClient } from './interpreter.js';
+/** Wraps a Cligent adapter as an {@link AgentClient} for the interpreter. */
+export declare function createCligentAgent(opts: {
+    adapter: AgentAdapter;
+    maxTurns?: number;
+    permissions?: PermissionPolicy;
+    /** Adapter-scoped reasoning effort, validated by the configuration layer. */
+    effort?: string;
+}): AgentClient;
+//# sourceMappingURL=cligent-agent.d.ts.map

package/dist/cligent-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cligent-agent.d.ts","sourceRoot":"","sources":["../src/cligent-agent.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EACV,YAAY,EAGZ,gBAAgB,EACjB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,KAAK,EAAE,WAAW,EAAkB,MAAM,kBAAkB,CAAC;AAEpE,6EAA6E;AAC7E,wBAAgB,kBAAkB,CAAC,IAAI,EAAE;IACvC,OAAO,EAAE,YAAY,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,gBAAgB,CAAC;IAC/B,6EAA6E;IAC7E,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,WAAW,CAwDd"}

package/dist/cligent-agent.js

@@ -0,0 +1,66 @@
+// SPDX-License-Identifier: Apache-2.0
+// SPDX-FileCopyrightText: 2026 SubLang International <https://sublang.ai>
+/**
+ * Cligent-backed {@link AgentClient} (DR-004).
+ *
+ * Backs the interpreter's agent transport with Cligent (npm `@sublang/cligent`),
+ * draining its event stream into a normalized {@link AgentRunResult}. The host
+ * supplies the concrete `AgentAdapter` (e.g. Claude Code, Codex) and any write
+ * permissions, keeping agent selection a configuration concern (PHEXEC-13); the
+ * DR-003 write-scope sandbox would be configured here via `permissions`. This
+ * transport is exercised by integration runs, not unit tests, since it drives a
+ * real agent CLI. See specs/dev/phase-execution.md.
+ */
+import { Cligent } from '@sublang/cligent';
+/** Wraps a Cligent adapter as an {@link AgentClient} for the interpreter. */
+export function createCligentAgent(opts) {
+    const cligent = new Cligent(opts.adapter, {
+        maxTurns: opts.maxTurns,
+        permissions: opts.permissions,
+        // Validated adapter-scoped by the configuration layer (CLI-12).
+        ...(opts.effort !== undefined ? { effort: opts.effort } : {}),
+    });
+    return {
+        async run({ prompt, cwd, model, resume, allowedTools, signal, }) {
+            const texts = [];
+            let resultText = '';
+            let status = 'incomplete';
+            let resumeToken;
+            for await (const raw of cligent.run(prompt, {
+                abortSignal: signal,
+                cwd,
+                model,
+                ...(resume !== undefined ? { resume } : {}),
+                ...(allowedTools !== undefined
+                    ? { allowedTools: [...allowedTools] }
+                    : {}),
+            })) {
+                const event = raw;
+                if (event.type === 'text') {
+                    texts.push(event.payload.content);
+                }
+                else if (event.type === 'error') {
+                    status = 'error';
+                    texts.push(event.payload.message);
+                }
+                else if (event.type === 'done') {
+                    status =
+                        event.payload.status === 'success'
+                            ? 'success'
+                            : event.payload.status === 'error'
+                                ? 'error'
+                                : 'incomplete';
+                    if (event.payload.result)
+                        resultText = event.payload.result;
+                    resumeToken = event.payload.resumeToken;
+                }
+            }
+            return {
+                status,
+                text: (resultText || texts.join('\n')).trim(),
+                ...(resumeToken !== undefined ? { resumeToken } : {}),
+            };
+        },
+    };
+}
+//# sourceMappingURL=cligent-agent.js.map

package/dist/cligent-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cligent-agent.js","sourceRoot":"","sources":["../src/cligent-agent.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,0EAA0E;AAE1E;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAU3C,6EAA6E;AAC7E,MAAM,UAAU,kBAAkB,CAAC,IAMlC;IACC,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE;QACxC,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,gEAAgE;QAChE,GAAG,CAAC,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAgB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACxE,CAAC,CAAC;IAEH,OAAO;QACL,KAAK,CAAC,GAAG,CAAC,EACR,MAAM,EACN,GAAG,EACH,KAAK,EACL,MAAM,EACN,YAAY,EACZ,MAAM,GACP;YACC,MAAM,KAAK,GAAa,EAAE,CAAC;YAC3B,IAAI,UAAU,GAAG,EAAE,CAAC;YACpB,IAAI,MAAM,GAA6B,YAAY,CAAC;YACpD,IAAI,WAA+B,CAAC;YAEpC,IAAI,KAAK,EAAE,MAAM,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE;gBAC1C,WAAW,EAAE,MAAM;gBACnB,GAAG;gBACH,KAAK;gBACL,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC3C,GAAG,CAAC,YAAY,KAAK,SAAS;oBAC5B,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,GAAG,YAAY,CAAC,EAAE;oBACrC,CAAC,CAAC,EAAE,CAAC;aACR,CAAC,EAAE,CAAC;gBACH,MAAM,KAAK,GAAe,GAAG,CAAC;gBAC9B,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;oBAC1B,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;gBACpC,CAAC;qBAAM,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;oBAClC,MAAM,GAAG,OAAO,CAAC;oBACjB,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;gBACpC,CAAC;qBAAM,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;oBACjC,MAAM;wBACJ,KAAK,CAAC,OAAO,CAAC,MAAM,KAAK,SAAS;4BAChC,CAAC,CAAC,SAAS;4BACX,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,KAAK,OAAO;gCAChC,CAAC,CAAC,OAAO;gCACT,CAAC,CAAC,YAAY,CAAC;oBACrB,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM;wBAAE,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;oBAC5D,WAAW,GAAG,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC;gBAC1C,CAAC;YACH,CAAC;YAED,OAAO;gBACL,MAAM;gBACN,IAAI,EAAE,CAAC,UAAU,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE;gBAC7C,GAAG,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACtD,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/compiled-executor.d.ts

@@ -0,0 +1,42 @@
+import type { PhaseExecutor } from './execution.js';
+import type { AgentClient } from './interpreter.js';
+import { type CompatiblePlaybookRuntimeFactory, type RuntimeContractProfile } from './playbook-contract.js';
+import { type PlayerTransport } from './playbook-ports.js';
+/**
+ * Imports a compiled `playbook` module and returns its runtime factory
+ * (PHEXEC-23).
+ *
+ * @throws when the module has no callable `createPlaybookRuntime` default export.
+ */
+export declare function loadPlaybookRuntime(artifactPath: string): Promise<CompatiblePlaybookRuntimeFactory>;
+/**
+ * Adapts a compiled `playbook` artifact to the {@link PhaseExecutor} boundary
+ * (PHEXEC-24, PHEXEC-25): build the Cligent-backed Playbook ports, load and
+ * construct the runtime, drive one non-interactive root-session turn, and map
+ * the outcome, appending drained status and non-trace operational telemetry.
+ */
+export declare function createCompiledExecutor(opts: {
+    /** Path to the compiled `playbook` module to load. */
+    artifactPath: string;
+    /** Run root for resolving the phase's workspace paths to absolute host paths. */
+    runRoot: string;
+    /** Agent transport(s) backing `callPlayer`; a factory yields one client per player id. */
+    player: PlayerTransport;
+    /** Shared agent transport backing `callCaptain` and `callJudge`. */
+    judge: AgentClient;
+    /** Per-player model binding, applied as configuration (PHEXEC-13). */
+    models?: Readonly<Record<string, string>>;
+    /** Model for players the `models` binding does not name (PHEXEC-13). */
+    defaultModel?: string;
+    /** Working directory handed to the agent transports. */
+    cwd?: string;
+    /** Stable authored phase identity used as the Playbook session's playbook id. */
+    playbookId?: string;
+    /** Session-id seam for deterministic tests; defaults to {@link randomUUID}. */
+    createSessionId?: () => string;
+    /** Exact pinned runtime boundary; defaults to the current legacy contract. */
+    runtimeContract?: RuntimeContractProfile;
+    /** Loader seam; defaults to {@link loadPlaybookRuntime}. */
+    loadFactory?: (artifactPath: string) => Promise<CompatiblePlaybookRuntimeFactory>;
+}): PhaseExecutor;
+//# sourceMappingURL=compiled-executor.d.ts.map

package/dist/compiled-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compiled-executor.d.ts","sourceRoot":"","sources":["../src/compiled-executor.ts"],"names":[],"mappings":"AAsCA,OAAO,KAAK,EAIV,aAAa,EACd,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAOpD,OAAO,EAKL,KAAK,gCAAgC,EAKrC,KAAK,sBAAsB,EAE5B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAuB,KAAK,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEhF;;;;;GAKG;AACH,wBAAsB,mBAAmB,CACvC,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,gCAAgC,CAAC,CAW3C;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE;IAC3C,sDAAsD;IACtD,YAAY,EAAE,MAAM,CAAC;IACrB,iFAAiF;IACjF,OAAO,EAAE,MAAM,CAAC;IAChB,0FAA0F;IAC1F,MAAM,EAAE,eAAe,CAAC;IACxB,oEAAoE;IACpE,KAAK,EAAE,WAAW,CAAC;IACnB,sEAAsE;IACtE,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC1C,wEAAwE;IACxE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,wDAAwD;IACxD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,iFAAiF;IACjF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,+EAA+E;IAC/E,eAAe,CAAC,EAAE,MAAM,MAAM,CAAC;IAC/B,8EAA8E;IAC9E,eAAe,CAAC,EAAE,sBAAsB,CAAC;IACzC,4DAA4D;IAC5D,WAAW,CAAC,EAAE,CACZ,YAAY,EAAE,MAAM,KACjB,OAAO,CAAC,gCAAgC,CAAC,CAAC;CAChD,GAAG,aAAa,CA+DhB"}