@a5c-ai/genty-platform 5.1.1-staging.0007199a1cb2

package/dist/orchestration/defaultOrchestrationProvider.js

@@ -0,0 +1,304 @@
+"use strict";
+/**
+ * Default in-platform OrchestrationProvider implementation.
+ *
+ * Mirrors the BabysitterOrchestrationProvider that lives in the genty plugin
+ * (plugins/babysitter-unified/per-harness/genty/src/provider.ts). It is
+ * registered as a default in createOrchestrationRegistry() so that genty CLI
+ * runtime, API commands, and tests have a working orchestration provider
+ * without requiring the plugin's register.ts to be loaded. See #936.
+ *
+ * Depends only on the babysitter-sdk runtime and node built-ins — no plugin
+ * dependency — so it is safe to host inside the platform package.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DefaultOrchestrationProvider = void 0;
+exports.createDefaultOrchestrationProvider = createDefaultOrchestrationProvider;
+const node_child_process_1 = require("node:child_process");
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const os = __importStar(require("node:os"));
+let _sdk;
+function sdk() {
+    if (!_sdk) {
+        // eslint-disable-next-line @typescript-eslint/no-require-imports
+        _sdk = require("@a5c-ai/babysitter-sdk");
+    }
+    return _sdk;
+}
+function resolveBabysitterBin() {
+    try {
+        return require.resolve("@a5c-ai/babysitter-sdk/dist/cli/main.js");
+    }
+    catch {
+        return "babysitter";
+    }
+}
+function execBabysitterCli(args, cwd) {
+    const bin = resolveBabysitterBin();
+    const isNodeScript = bin.endsWith(".js");
+    const command = isNodeScript ? process.execPath : bin;
+    const fullArgs = isNodeScript ? [bin, ...args] : args;
+    return (0, node_child_process_1.execFileSync)(command, fullArgs, {
+        cwd,
+        encoding: "utf8",
+        timeout: 120_000,
+        env: { ...process.env, FORCE_COLOR: "0" },
+    });
+}
+/**
+ * Run a babysitter CLI command tolerating a controlled non-zero exit. Returns
+ * the captured stdout regardless of exit code, and the exit code, so callers
+ * can distinguish a genuine spawn/command failure from an expected non-zero
+ * status (e.g. `task:post --status error` returns exit 1 by design once it has
+ * successfully committed the error result). See #936.
+ */
+function execBabysitterCliTolerant(args, cwd) {
+    const bin = resolveBabysitterBin();
+    const isNodeScript = bin.endsWith(".js");
+    const command = isNodeScript ? process.execPath : bin;
+    const fullArgs = isNodeScript ? [bin, ...args] : args;
+    try {
+        const stdout = (0, node_child_process_1.execFileSync)(command, fullArgs, {
+            cwd,
+            encoding: "utf8",
+            timeout: 120_000,
+            env: { ...process.env, FORCE_COLOR: "0" },
+        });
+        return { stdout, code: 0 };
+    }
+    catch (err) {
+        const e = err;
+        if (typeof e.status === "number") {
+            const stdout = typeof e.stdout === "string" ? e.stdout : e.stdout?.toString("utf8") ?? "";
+            return { stdout, code: e.status };
+        }
+        throw err;
+    }
+}
+/**
+ * Serialize an arbitrary effect error into a structured `{ name, message, stack }`
+ * payload suitable for `task:post --error <file>` (which JSON-parses the file).
+ * See #936.
+ */
+function serializeEffectError(error) {
+    if (error instanceof Error) {
+        return { name: error.name || "Error", message: error.message, ...(error.stack ? { stack: error.stack } : {}) };
+    }
+    if (error && typeof error === "object") {
+        const record = error;
+        const message = typeof record.message === "string" ? record.message : JSON.stringify(error);
+        const name = typeof record.name === "string" ? record.name : "Error";
+        return { name, message };
+    }
+    return { name: "Error", message: String(error) };
+}
+/**
+ * Parse the committed status from `task:post --json` output. Returns the
+ * `status` field ("ok" | "error") when the command emitted a parseable result,
+ * or undefined when it did not (a genuine failure). See #936.
+ */
+function parsePostStatus(stdout) {
+    const trimmed = stdout.trim();
+    if (!trimmed)
+        return undefined;
+    // The JSON line may be preceded by warnings; scan lines for a JSON object.
+    for (const line of trimmed.split(/\r?\n/).reverse()) {
+        const candidate = line.trim();
+        if (!candidate.startsWith("{"))
+            continue;
+        try {
+            const parsed = JSON.parse(candidate);
+            if (typeof parsed.status === "string")
+                return parsed.status;
+        }
+        catch {
+            // Not the JSON line; keep scanning.
+        }
+    }
+    return undefined;
+}
+class DefaultOrchestrationProvider {
+    name = "babysitter";
+    async createRun(opts) {
+        const { resolveRunsDir, createRun } = sdk();
+        const runsDir = opts.runsDir ?? resolveRunsDir();
+        // Split "path#exportName" on the LAST '#' so directory paths containing '#'
+        // (e.g. /a/my#project/proc.js#process) keep their '#' in the import path.
+        const lastHash = opts.entrypoint.lastIndexOf("#");
+        const importPath = lastHash >= 0 ? opts.entrypoint.slice(0, lastHash) : opts.entrypoint;
+        const exportName = lastHash >= 0 ? opts.entrypoint.slice(lastHash + 1) : undefined;
+        const result = await createRun({
+            runsDir,
+            harness: opts.harness,
+            process: {
+                processId: opts.processId,
+                importPath,
+                exportName,
+            },
+            prompt: opts.prompt,
+            inputs: opts.inputs,
+        });
+        return {
+            runId: result.runId,
+            runDir: result.runDir,
+            processId: opts.processId,
+            status: "pending",
+        };
+    }
+    async iterateRun(handle, iteration) {
+        // CLI signature: run:iterate <runDir> [--iteration <n>] [--json]
+        const args = ["run:iterate", handle.runDir, "--json"];
+        if (iteration !== undefined) {
+            args.push("--iteration", String(iteration));
+        }
+        const output = execBabysitterCli(args);
+        const parsed = JSON.parse(output);
+        return {
+            iteration: parsed.iteration ?? iteration ?? 0,
+            status: parsed.status ?? "none",
+            action: parsed.action ?? "",
+            reason: parsed.reason ?? "",
+            pendingEffects: parsed.pendingEffects ?? [],
+            completionProof: parsed.completionProof,
+        };
+    }
+    async postEffectResult(handle, effectId, result) {
+        // Surface a recognizable "Unknown effectId" error (mapped to UNKNOWN_EFFECT
+        // by the API layer) instead of an opaque CLI failure when the effect's task
+        // definition does not exist.
+        const taskJson = path.join(handle.runDir, "tasks", effectId, "task.json");
+        if (!fs.existsSync(taskJson)) {
+            throw new Error(`Unknown effectId: ${effectId}`);
+        }
+        // CLI signature: task:post <runDir> <effectId> --status <ok|error>
+        //   ok    → --value-inline <json>
+        //   error → --error <file>
+        const args = ["task:post", handle.runDir, effectId, "--status", result.status, "--json"];
+        let errorFile;
+        if (result.status === "ok") {
+            args.push("--value-inline", JSON.stringify(result.value ?? null));
+        }
+        else if (result.error !== undefined) {
+            errorFile = path.join(os.tmpdir(), `genty-effect-error-${effectId}-${Date.now()}.json`);
+            // #936: the CLI `task:post --error <file>` JSON-parses this file. Writing
+            // a bare String(error) (e.g. "Error: Effect failed") produced a cryptic
+            // non-JSON SyntaxError downstream that spun the orchestration loop. Always
+            // emit a structured JSON error payload so the real failure surfaces and
+            // the run can reach a terminal failure promptly.
+            fs.writeFileSync(errorFile, JSON.stringify(serializeEffectError(result.error)));
+            args.push("--error", errorFile);
+        }
+        try {
+            if (result.status === "error") {
+                // #936: `task:post --status error` returns exit 1 BY DESIGN once it has
+                // committed the error result. Tolerate that controlled exit code and
+                // confirm the commit via the emitted JSON — otherwise execFileSync would
+                // throw on every error post, which the in-process loop swallowed and
+                // spun on. A genuine spawn/command failure (no parseable JSON committed)
+                // still surfaces as a thrown error.
+                const { stdout, code } = execBabysitterCliTolerant(args);
+                const committed = parsePostStatus(stdout);
+                if (committed !== "error" && code !== 0) {
+                    throw new Error(`task:post --status error failed for effect ${effectId} (exit ${code}): ${stdout.trim() || "no output"}`);
+                }
+            }
+            else {
+                execBabysitterCli(args);
+            }
+        }
+        finally {
+            if (errorFile) {
+                try {
+                    fs.unlinkSync(errorFile);
+                }
+                catch { /* best effort */ }
+            }
+        }
+    }
+    async getRunStatus(handle) {
+        const { readRunMetadata, loadJournal } = sdk();
+        const metadata = await readRunMetadata(handle.runDir);
+        const events = await loadJournal(handle.runDir);
+        let status = "pending";
+        for (const event of events) {
+            if (event.type === "RUN_COMPLETED")
+                status = "completed";
+            else if (event.type === "RUN_FAILED")
+                status = "failed";
+            else if (event.type === "EFFECT_REQUESTED")
+                status = "waiting";
+            else if (event.type === "ITERATION_EXECUTED")
+                status = "running";
+        }
+        return {
+            runId: handle.runId,
+            runDir: handle.runDir,
+            processId: metadata.processId ?? handle.processId,
+            status,
+        };
+    }
+    async getRunEvents(handle, opts) {
+        const { loadJournal } = sdk();
+        const events = await loadJournal(handle.runDir);
+        let mapped = events.map((e) => ({
+            type: e.type,
+            timestamp: e.recordedAt,
+            data: e.data,
+        }));
+        if (opts?.reverse) {
+            mapped = mapped.reverse();
+        }
+        if (opts?.limit !== undefined && opts.limit > 0) {
+            mapped = mapped.slice(0, opts.limit);
+        }
+        return mapped;
+    }
+    async getPendingEffects(handle) {
+        // CLI signature: task:list <runDir> [--pending] [--json]
+        const args = ["task:list", handle.runDir, "--pending", "--json"];
+        const output = execBabysitterCli(args);
+        const parsed = JSON.parse(output);
+        return Array.isArray(parsed) ? parsed : parsed.effects ?? [];
+    }
+    resolveRunsDir(opts) {
+        return sdk().resolveRunsDir({ cwd: opts?.cwd });
+    }
+}
+exports.DefaultOrchestrationProvider = DefaultOrchestrationProvider;
+function createDefaultOrchestrationProvider() {
+    return new DefaultOrchestrationProvider();
+}

package/dist/orchestration/global.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Global singleton for the orchestration provider registry.
+ *
+ * Modules that need a provider at call time use getGlobalRegistry() rather
+ * than accepting the registry as an explicit argument.  Test code can swap
+ * the instance with setGlobalRegistry() or tear it down with
+ * resetGlobalRegistry().
+ */
+import type { OrchestrationRegistry } from "./registry";
+import type { JournalEvent } from "../types";
+export declare function getGlobalRegistry(): OrchestrationRegistry;
+export declare function setGlobalRegistry(registry: OrchestrationRegistry): void;
+export declare function resetGlobalRegistry(): void;
+/**
+ * Load journal events from the global registry's journal provider,
+ * cast to the full JournalEvent type used by platform code.
+ *
+ * The provider interface declares RunEvent[] (narrow), but concrete
+ * implementations return the full JournalEvent shape with seq, ulid,
+ * recordedAt, etc.  This helper centralises the assertion.
+ */
+export declare function loadJournalEvents(runDir: string): Promise<JournalEvent[]>;
+/**
+ * Append a journal event through the global registry's journal provider.
+ */
+export declare function appendJournalEvent(runDir: string, eventType: string, data: Record<string, unknown>): Promise<void>;
+//# sourceMappingURL=global.d.ts.map

package/dist/orchestration/global.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"global.d.ts","sourceRoot":"","sources":["../../src/orchestration/global.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAI7C,wBAAgB,iBAAiB,IAAI,qBAAqB,CAKzD;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,qBAAqB,GAAG,IAAI,CAEvE;AAED,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C;AAED;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAG/E;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,IAAI,CAAC,CAMf"}

package/dist/orchestration/global.js

@@ -0,0 +1,51 @@
+"use strict";
+/**
+ * Global singleton for the orchestration provider registry.
+ *
+ * Modules that need a provider at call time use getGlobalRegistry() rather
+ * than accepting the registry as an explicit argument.  Test code can swap
+ * the instance with setGlobalRegistry() or tear it down with
+ * resetGlobalRegistry().
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getGlobalRegistry = getGlobalRegistry;
+exports.setGlobalRegistry = setGlobalRegistry;
+exports.resetGlobalRegistry = resetGlobalRegistry;
+exports.loadJournalEvents = loadJournalEvents;
+exports.appendJournalEvent = appendJournalEvent;
+const registry_1 = require("./registry");
+let _registry;
+function getGlobalRegistry() {
+    if (!_registry) {
+        _registry = (0, registry_1.createOrchestrationRegistry)();
+    }
+    return _registry;
+}
+function setGlobalRegistry(registry) {
+    _registry = registry;
+}
+function resetGlobalRegistry() {
+    _registry = undefined;
+}
+/**
+ * Load journal events from the global registry's journal provider,
+ * cast to the full JournalEvent type used by platform code.
+ *
+ * The provider interface declares RunEvent[] (narrow), but concrete
+ * implementations return the full JournalEvent shape with seq, ulid,
+ * recordedAt, etc.  This helper centralises the assertion.
+ */
+async function loadJournalEvents(runDir) {
+    const events = await getGlobalRegistry().getJournal().loadEvents(runDir);
+    return events;
+}
+/**
+ * Append a journal event through the global registry's journal provider.
+ */
+async function appendJournalEvent(runDir, eventType, data) {
+    await getGlobalRegistry().getJournal().appendEvent(runDir, {
+        type: eventType,
+        timestamp: new Date().toISOString(),
+        data,
+    });
+}

package/dist/orchestration/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Orchestration provider abstraction layer.
+ *
+ * Re-exports all interfaces and the registry factory so consumers can
+ * import from `@a5c-ai/genty-platform/orchestration` (or via the
+ * platform barrel) without reaching into individual files.
+ */
+export type { RunStatus, RunHandle, CreateRunOptions, EffectKind, PendingEffect, EffectResult, IterationResult, RunEvent, OrchestrationProvider, JournalProvider, GovernanceProvider, ExternalAgentProvider, SessionProvider, ProcessDefinitionProvider, ApprovalPosture, BreakpointDecision, ProcessValidationResult, AgentInfo, } from "./interfaces";
+export type { OrchestrationRegistry } from "./registry";
+export { createOrchestrationRegistry } from "./registry";
+export { getGlobalRegistry, setGlobalRegistry, resetGlobalRegistry, loadJournalEvents } from "./global";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/orchestration/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,YAAY,EAEV,SAAS,EACT,SAAS,EACT,gBAAgB,EAGhB,UAAU,EACV,aAAa,EACb,YAAY,EAGZ,eAAe,EAGf,QAAQ,EAGR,qBAAqB,EACrB,eAAe,EACf,kBAAkB,EAClB,qBAAqB,EACrB,eAAe,EACf,yBAAyB,EAGzB,eAAe,EACf,kBAAkB,EAGlB,uBAAuB,EAGvB,SAAS,GACV,MAAM,cAAc,CAAC;AAEtB,YAAY,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACxD,OAAO,EAAE,2BAA2B,EAAE,MAAM,YAAY,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC"}

package/dist/orchestration/index.js

@@ -0,0 +1,17 @@
+"use strict";
+/**
+ * Orchestration provider abstraction layer.
+ *
+ * Re-exports all interfaces and the registry factory so consumers can
+ * import from `@a5c-ai/genty-platform/orchestration` (or via the
+ * platform barrel) without reaching into individual files.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadJournalEvents = exports.resetGlobalRegistry = exports.setGlobalRegistry = exports.getGlobalRegistry = exports.createOrchestrationRegistry = void 0;
+var registry_1 = require("./registry");
+Object.defineProperty(exports, "createOrchestrationRegistry", { enumerable: true, get: function () { return registry_1.createOrchestrationRegistry; } });
+var global_1 = require("./global");
+Object.defineProperty(exports, "getGlobalRegistry", { enumerable: true, get: function () { return global_1.getGlobalRegistry; } });
+Object.defineProperty(exports, "setGlobalRegistry", { enumerable: true, get: function () { return global_1.setGlobalRegistry; } });
+Object.defineProperty(exports, "resetGlobalRegistry", { enumerable: true, get: function () { return global_1.resetGlobalRegistry; } });
+Object.defineProperty(exports, "loadJournalEvents", { enumerable: true, get: function () { return global_1.loadJournalEvents; } });

package/dist/orchestration/interfaces.d.ts

@@ -0,0 +1,136 @@
+/**
+ * Orchestration provider abstraction interfaces.
+ *
+ * These interfaces define the contract between genty and any orchestration
+ * backend. Babysitter-SDK is one implementation; other systems (custom
+ * runners, cloud orchestrators, test stubs) can provide their own.
+ *
+ * No babysitter-sdk imports should appear in this file.
+ */
+/** Possible states of a run. */
+export type RunStatus = "pending" | "running" | "waiting" | "completed" | "failed";
+/** Opaque handle to an active run. */
+export interface RunHandle {
+    runId: string;
+    runDir: string;
+    processId: string;
+    status: RunStatus;
+}
+/** Types of effects an orchestration loop can emit. */
+export type EffectKind = "agent" | "skill" | "shell" | "breakpoint" | "sleep";
+/** An effect waiting to be resolved. */
+export interface PendingEffect {
+    effectId: string;
+    kind: EffectKind;
+    label: string;
+    status: string;
+    taskDef: unknown;
+}
+/** Result of an effect execution. */
+export interface EffectResult {
+    status: "ok" | "error";
+    value?: unknown;
+    error?: unknown;
+    startedAt?: string;
+    finishedAt?: string;
+}
+/** Result of a single orchestration iteration. */
+export interface IterationResult {
+    iteration: number;
+    status: "executed" | "waiting" | "completed" | "failed" | "none";
+    action: string;
+    reason: string;
+    pendingEffects: PendingEffect[];
+    completionProof?: string;
+}
+/** A journal event persisted during a run. */
+export interface RunEvent {
+    type: string;
+    timestamp: string;
+    data?: unknown;
+}
+/** Options for creating a new run. */
+export interface CreateRunOptions {
+    processId: string;
+    entrypoint: string;
+    prompt: string;
+    harness?: string;
+    inputs?: Record<string, unknown>;
+    runsDir?: string;
+    nonInteractive?: boolean;
+}
+/**
+ * The main plugin contract for an orchestration backend.
+ *
+ * Implementations translate between genty's framework-agnostic model and
+ * the concrete run mechanics of a particular orchestration system.
+ */
+export interface OrchestrationProvider {
+    readonly name: string;
+    /** Create a new run and return a handle to it. */
+    createRun(opts: CreateRunOptions): Promise<RunHandle>;
+    /** Advance the run by one iteration. */
+    iterateRun(handle: RunHandle, iteration?: number): Promise<IterationResult>;
+    /** Post the result of an effect back to the orchestration system. */
+    postEffectResult(handle: RunHandle, effectId: string, result: EffectResult): Promise<void>;
+    /** Refresh and return the current status of a run. */
+    getRunStatus(handle: RunHandle): Promise<RunHandle>;
+    /** Load journal events for a run. */
+    getRunEvents(handle: RunHandle, opts?: {
+        limit?: number;
+        reverse?: boolean;
+    }): Promise<RunEvent[]>;
+    /** List effects that are waiting for resolution. */
+    getPendingEffects(handle: RunHandle): Promise<PendingEffect[]>;
+    /** Resolve the default runs directory for this provider. */
+    resolveRunsDir(opts?: {
+        cwd?: string;
+    }): string;
+}
+/** Approval stance a governance provider can take. */
+export type ApprovalPosture = "ask" | "auto-approve" | "deny";
+/** Decision returned by governance when evaluating a breakpoint. */
+export interface BreakpointDecision {
+    autoApprove: boolean;
+    reason?: string;
+}
+/** Governance evaluation provider. */
+export interface GovernanceProvider {
+    evaluateBreakpoint(effect: PendingEffect, context: Record<string, unknown>): Promise<BreakpointDecision>;
+    getApprovalPosture(): ApprovalPosture;
+}
+/** Abstraction over event journal storage. */
+export interface JournalProvider {
+    loadEvents(runDir: string): Promise<RunEvent[]>;
+    appendEvent(runDir: string, event: RunEvent): Promise<void>;
+}
+/** Result of validating a process definition. */
+export interface ProcessValidationResult {
+    valid: boolean;
+    errors: string[];
+    warnings: string[];
+}
+/** Provider that can load and validate process definitions. */
+export interface ProcessDefinitionProvider {
+    validateProcess(path: string): Promise<ProcessValidationResult>;
+    loadProcess(path: string): Promise<{
+        entrypoint: string;
+        exportName: string;
+    }>;
+}
+/** Metadata for a discovered external agent. */
+export interface AgentInfo {
+    name: string;
+    path: string;
+    description?: string;
+}
+/** Provider that discovers agents available in a workspace. */
+export interface ExternalAgentProvider {
+    discoverAgents(workspace: string): Promise<AgentInfo[]>;
+}
+/** Provider for session identity and binding. */
+export interface SessionProvider {
+    resolveSessionId(): string | undefined;
+    bindSession(runId: string, sessionId: string): Promise<void>;
+}
+//# sourceMappingURL=interfaces.d.ts.map

package/dist/orchestration/interfaces.d.ts.map

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

package/dist/orchestration/interfaces.js

@@ -0,0 +1,11 @@
+"use strict";
+/**
+ * Orchestration provider abstraction interfaces.
+ *
+ * These interfaces define the contract between genty and any orchestration
+ * backend. Babysitter-SDK is one implementation; other systems (custom
+ * runners, cloud orchestrators, test stubs) can provide their own.
+ *
+ * No babysitter-sdk imports should appear in this file.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/orchestration/registry.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Provider registry for orchestration abstractions.
+ *
+ * Each provider type is stored in a named map. Callers can register
+ * multiple implementations and retrieve them by name. When no name is
+ * supplied, the first registered provider is returned.
+ *
+ * If no provider has been registered for a requested type, the getter
+ * throws immediately -- there are no fallbacks.
+ */
+import type { OrchestrationProvider, JournalProvider, GovernanceProvider, ExternalAgentProvider, SessionProvider, ProcessDefinitionProvider } from "./interfaces";
+export interface OrchestrationRegistry {
+    registerOrchestration(name: string, provider: OrchestrationProvider): void;
+    registerJournal(name: string, provider: JournalProvider): void;
+    registerGovernance(name: string, provider: GovernanceProvider): void;
+    registerAgentDiscovery(name: string, provider: ExternalAgentProvider): void;
+    registerSession(name: string, provider: SessionProvider): void;
+    registerProcessDefinition(name: string, provider: ProcessDefinitionProvider): void;
+    getOrchestration(name?: string): OrchestrationProvider;
+    getJournal(name?: string): JournalProvider;
+    getGovernance(name?: string): GovernanceProvider;
+    getAgentDiscovery(name?: string): ExternalAgentProvider;
+    getSession(name?: string): SessionProvider;
+    getProcessDefinition(name?: string): ProcessDefinitionProvider;
+    /** Names of all registered orchestration providers. */
+    listProviders(): string[];
+}
+/** Create a new orchestration registry with a default filesystem journal. */
+export declare function createOrchestrationRegistry(): OrchestrationRegistry;
+//# sourceMappingURL=registry.d.ts.map

package/dist/orchestration/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/orchestration/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,KAAK,EACV,qBAAqB,EACrB,eAAe,EACf,kBAAkB,EAClB,qBAAqB,EACrB,eAAe,EACf,yBAAyB,EAE1B,MAAM,cAAc,CAAC;AAmCtB,MAAM,WAAW,qBAAqB;IACpC,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,qBAAqB,GAAG,IAAI,CAAC;IAC3E,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,GAAG,IAAI,CAAC;IAC/D,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,kBAAkB,GAAG,IAAI,CAAC;IACrE,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,qBAAqB,GAAG,IAAI,CAAC;IAC5E,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,GAAG,IAAI,CAAC;IAC/D,yBAAyB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,yBAAyB,GAAG,IAAI,CAAC;IAEnF,gBAAgB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,qBAAqB,CAAC;IACvD,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,eAAe,CAAC;IAC3C,aAAa,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,kBAAkB,CAAC;IACjD,iBAAiB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,qBAAqB,CAAC;IACxD,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,eAAe,CAAC;IAC3C,oBAAoB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,yBAAyB,CAAC;IAE/D,uDAAuD;IACvD,aAAa,IAAI,MAAM,EAAE,CAAC;CAC3B;AAoDD,6EAA6E;AAC7E,wBAAgB,2BAA2B,IAAI,qBAAqB,CA+BnE"}