@usine/agents 0.0.1 → 0.2.0

package/dist/preflight/command.js

@@ -0,0 +1,42 @@
+import { HarnessUnavailableError } from "@usine/core/agent/capability";
+import { Effect, Option, Stream } from "effect";
+import { ChildProcess, ChildProcessSpawner } from "effect/unstable/process";
+import { homedir } from "node:os";
+import { SessionOperationError } from "../runtime.js";
+/** Runs a bounded readiness command without retaining its potentially sensitive diagnostics. */
+export const probeCommand = Effect.fn("HarnessPreflight.command")(function* (harness, capability, command, args) {
+    yield* Effect.annotateCurrentSpan({ harness, capability });
+    const spawner = yield* ChildProcessSpawner.ChildProcessSpawner;
+    return yield* Effect.scoped(Effect.gen(function* () {
+        const handle = yield* spawner.spawn(ChildProcess.make(command, args, {
+            cwd: homedir(),
+            detached: false,
+            forceKillAfter: "2 seconds",
+        }));
+        const [stdout, , exitCode] = yield* Effect.all([
+            handle.stdout.pipe(Stream.decodeText(), Stream.mkString),
+            handle.stderr.pipe(Stream.runDrain),
+            handle.exitCode,
+        ], { concurrency: "unbounded" });
+        if (exitCode !== 0)
+            return yield* new HarnessUnavailableError({
+                harness,
+                capability,
+                message: `${command} ${args.join(" ")} failed; check the Worker's ${harness} installation and login`,
+            });
+        return stdout.trim();
+    })).pipe(Effect.timeout("30 seconds"), Effect.catchTags({
+        PlatformError: () => new HarnessUnavailableError({
+            harness,
+            capability,
+            message: `Worker cannot execute ${command}`,
+        }),
+        TimeoutError: (cause) => new SessionOperationError({
+            operation: "launch",
+            sessionId: Option.none(),
+            message: `${command} readiness check timed out`,
+            cause,
+        }),
+    }));
+});
+//# sourceMappingURL=command.js.map

package/dist/preflight/command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.js","sourceRoot":"","sources":["../../src/preflight/command.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,uBAAuB,EAA0B,MAAM,8BAA8B,CAAC;AAC/F,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC5E,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAEtD,gGAAgG;AAChG,MAAM,CAAC,MAAM,YAAY,GAAG,MAAM,CAAC,EAAE,CAAC,0BAA0B,CAAC,CAAC,QAAQ,CAAC,EACzE,OAAgB,EAChB,UAA6B,EAC7B,OAAe,EACf,IAA2B;IAE3B,KAAK,CAAC,CAAC,MAAM,CAAC,mBAAmB,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC,CAAC;IAC3D,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,mBAAmB,CAAC,mBAAmB,CAAC;IAC/D,OAAO,KAAK,CAAC,CAAC,MAAM,CAAC,MAAM,CACzB,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;QAClB,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,OAAO,CAAC,KAAK,CACjC,YAAY,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE;YAC/B,GAAG,EAAE,OAAO,EAAE;YACd,QAAQ,EAAE,KAAK;YACf,cAAc,EAAE,WAAW;SAC5B,CAAC,CACH,CAAC;QACF,MAAM,CAAC,MAAM,EAAE,AAAD,EAAG,QAAQ,CAAC,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,GAAG,CAC5C;YACE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,EAAE,MAAM,CAAC,QAAQ,CAAC;YACxD,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC;YACnC,MAAM,CAAC,QAAQ;SAChB,EACD,EAAE,WAAW,EAAE,WAAW,EAAE,CAC7B,CAAC;QACF,IAAI,QAAQ,KAAK,CAAC;YAChB,OAAO,KAAK,CAAC,CAAC,IAAI,uBAAuB,CAAC;gBACxC,OAAO;gBACP,UAAU;gBACV,OAAO,EAAE,GAAG,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,+BAA+B,OAAO,yBAAyB;aACrG,CAAC,CAAC;QACL,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC;IACvB,CAAC,CAAC,CACH,CAAC,IAAI,CACJ,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,EAC5B,MAAM,CAAC,SAAS,CAAC;QACf,aAAa,EAAE,GAAG,EAAE,CAClB,IAAI,uBAAuB,CAAC;YAC1B,OAAO;YACP,UAAU;YACV,OAAO,EAAE,yBAAyB,OAAO,EAAE;SAC5C,CAAC;QACJ,YAAY,EAAE,CAAC,KAAK,EAAE,EAAE,CACtB,IAAI,qBAAqB,CAAC;YACxB,SAAS,EAAE,QAAQ;YACnB,SAAS,EAAE,MAAM,CAAC,IAAI,EAAE;YACxB,OAAO,EAAE,GAAG,OAAO,4BAA4B;YAC/C,KAAK;SACN,CAAC;KACL,CAAC,CACH,CAAC;AACJ,CAAC,CAAC,CAAC"}

package/dist/preflight/preflight.d.ts

@@ -0,0 +1,13 @@
+import type { BrainSpec } from "@usine/core/agent/brain";
+import { HarnessReady, HarnessUnavailableError } from "@usine/core/agent/capability";
+import { Effect } from "effect";
+import { SessionOperationError } from "../runtime.ts";
+import { CodexAppServer } from "../pi/codex/app-server.ts";
+import { PiSdk } from "../pi/sdk.ts";
+/** Baseline Codex CLI version used by the pinned app-server protocol conformance gate. */
+export declare const CODEX_CLI_VERSION = "0.144.0";
+/** Verifies a rostered brain through supplied process and SDK services; starts no prompt. */
+export declare const verifyHarness: (brain: BrainSpec) => Effect.Effect<HarnessReady, HarnessUnavailableError | SessionOperationError, import("effect/unstable/process/ChildProcessSpawner").ChildProcessSpawner | CodexAppServer | PiSdk>;
+/** Checks only the requested brain using the worker user's configuration, without running a prompt or logging in. */
+export declare const preflight: (brain: BrainSpec) => Effect.Effect<HarnessReady, HarnessUnavailableError | SessionOperationError, import("effect/unstable/process/ChildProcessSpawner").ChildProcessSpawner>;
+//# sourceMappingURL=preflight.d.ts.map

package/dist/preflight/preflight.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preflight.d.ts","sourceRoot":"","sources":["../../src/preflight/preflight.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AACrF,OAAO,EAAE,MAAM,EAAkB,MAAM,QAAQ,CAAC;AAEhD,OAAO,EAAE,qBAAqB,EAAoB,MAAM,eAAe,CAAC;AACxE,OAAO,EAAE,cAAc,EAAsB,MAAM,2BAA2B,CAAC;AAE/E,OAAO,EAAE,KAAK,EAAyB,MAAM,cAAc,CAAC;AAG5D,0FAA0F;AAC1F,eAAO,MAAM,iBAAiB,YAAY,CAAC;AAW3C,6FAA6F;AAC7F,eAAO,MAAM,aAAa,wMA4GzB,CAAC;AAEF,qHAAqH;AACrH,eAAO,MAAM,SAAS,UAAW,SAAS,4JACgD,CAAC"}

package/dist/preflight/preflight.js

@@ -0,0 +1,100 @@
+import { HarnessReady, HarnessUnavailableError } from "@usine/core/agent/capability";
+import { Effect, Option, Schema } from "effect";
+import { homedir } from "node:os";
+import { SessionOperationError, WorkingDirectory } from "../runtime.js";
+import { CodexAppServer, codexAppServerLive } from "../pi/codex/app-server.js";
+import { initializeCodex, verifyCodexAccount } from "../pi/codex/account.js";
+import { PiSdk, piSdkLive, usePiStart } from "../pi/sdk.js";
+import { probeCommand } from "./command.js";
+/** Baseline Codex CLI version used by the pinned app-server protocol conformance gate. */
+export const CODEX_CLI_VERSION = "0.144.0";
+// Additional exact builds require generated-type review and the live contracts.
+const supportedCodexVersions = [CODEX_CLI_VERSION, "0.153.4"];
+const ClaudeAuthentication = Schema.Struct({
+    loggedIn: Schema.Boolean,
+    authMethod: Schema.String,
+    apiProvider: Schema.String,
+});
+/** Verifies a rostered brain through supplied process and SDK services; starts no prompt. */
+export const verifyHarness = Effect.fn("HarnessPreflight.verify")(function* (brain) {
+    yield* Effect.annotateCurrentSpan({ harness: brain.harness, model: brain.model });
+    const loginError = (message) => new HarnessUnavailableError({
+        harness: brain.harness,
+        capability: "login",
+        message,
+    });
+    switch (brain.harness) {
+        case "codex": {
+            const version = yield* probeCommand("codex", "binary", "codex", ["--version"]);
+            if (!supportedCodexVersions.some((supported) => version === `codex-cli ${supported}`))
+                return yield* new HarnessUnavailableError({
+                    harness: "codex",
+                    capability: "version",
+                    message: `Worker has ${/^codex-cli [0-9]+\.[0-9]+\.[0-9]+$/u.test(version) ? version : "an unrecognized Codex version"}; supported Codex CLI versions: ${supportedCodexVersions.join(", ")}`,
+                });
+            yield* Effect.scoped(Effect.gen(function* () {
+                const server = yield* CodexAppServer;
+                const connection = yield* server.open({
+                    cwd: WorkingDirectory.make(homedir()),
+                    sessionId: Option.none(),
+                });
+                yield* initializeCodex(connection);
+                yield* verifyCodexAccount(connection, brain.model);
+            })).pipe(Effect.catchTag("PoolUnavailableError", (error) => loginError(error.message)));
+            break;
+        }
+        case "claude": {
+            yield* probeCommand("claude", "binary", "claude", ["--version"]);
+            const response = yield* probeCommand("claude", "login", "claude", [
+                "auth",
+                "status",
+                "--json",
+            ]);
+            const auth = yield* Schema.decodeUnknownEffect(Schema.fromJsonString(ClaudeAuthentication))(response).pipe(Effect.mapError(() => loginError("Claude returned an unrecognized login status")));
+            if (!auth.loggedIn || auth.authMethod !== "claude.ai" || auth.apiProvider !== "firstParty")
+                return yield* loginError("Claude requires a subscription login; run claude auth login on the Worker");
+            break;
+        }
+        case "pi": {
+            // Pi is the SDK installed with this run host, not a separate CLI binary.
+            const sdk = yield* PiSdk;
+            yield* usePiStart((signal) => sdk.start({
+                cwd: homedir(),
+                extensions: [],
+                model: Option.some(brain.model),
+                signal,
+                thinkingLevel: brain.effort,
+                toolMode: "repository",
+            }), (cause) => new SessionOperationError({
+                operation: "launch",
+                sessionId: Option.none(),
+                message: `Pi could not check authentication for ${brain.model}`,
+                cause,
+            }), (acquired) => Effect.gen(function* () {
+                const result = acquired.result;
+                yield* Effect.sync(acquired.dispose);
+                if (result._tag !== "Started" || result.pool !== "apiKeys")
+                    return yield* loginError(`Pi child model ${brain.model} requires an available model, supported effort, and API-key authentication`);
+            }));
+            break;
+        }
+    }
+    yield* Effect.logInfo("Worker harness verified", {
+        harness: brain.harness,
+        model: brain.model,
+    });
+    return new HarnessReady({ harness: brain.harness });
+}, (effect, brain) => effect.pipe(Effect.timeout("60 seconds"), Effect.catchTag("TimeoutError", (cause) => new SessionOperationError({
+    operation: "launch",
+    sessionId: Option.none(),
+    message: `${brain.harness} readiness check timed out`,
+    cause,
+})), Effect.tapError((error) => Effect.logError("Worker harness preflight failed", {
+    harness: brain.harness,
+    model: brain.model,
+    errorTag: error._tag,
+    message: error.message,
+}))));
+/** Checks only the requested brain using the worker user's configuration, without running a prompt or logging in. */
+export const preflight = (brain) => verifyHarness(brain).pipe(Effect.provide(codexAppServerLive), Effect.provide(piSdkLive));
+//# sourceMappingURL=preflight.js.map

package/dist/preflight/preflight.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preflight.js","sourceRoot":"","sources":["../../src/preflight/preflight.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AACrF,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChD,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACxE,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/E,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC7E,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,0FAA0F;AAC1F,MAAM,CAAC,MAAM,iBAAiB,GAAG,SAAS,CAAC;AAE3C,gFAAgF;AAChF,MAAM,sBAAsB,GAAG,CAAC,iBAAiB,EAAE,SAAS,CAAC,CAAC;AAE9D,MAAM,oBAAoB,GAAG,MAAM,CAAC,MAAM,CAAC;IACzC,QAAQ,EAAE,MAAM,CAAC,OAAO;IACxB,UAAU,EAAE,MAAM,CAAC,MAAM;IACzB,WAAW,EAAE,MAAM,CAAC,MAAM;CAC3B,CAAC,CAAC;AAEH,6FAA6F;AAC7F,MAAM,CAAC,MAAM,aAAa,GAAG,MAAM,CAAC,EAAE,CAAC,yBAAyB,CAAC,CAC/D,QAAQ,CAAC,EAAE,KAAgB;IACzB,KAAK,CAAC,CAAC,MAAM,CAAC,mBAAmB,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;IAClF,MAAM,UAAU,GAAG,CAAC,OAAe,EAAE,EAAE,CACrC,IAAI,uBAAuB,CAAC;QAC1B,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,UAAU,EAAE,OAAO;QACnB,OAAO;KACR,CAAC,CAAC;IACL,QAAQ,KAAK,CAAC,OAAO,EAAE,CAAC;QACtB,KAAK,OAAO,EAAE,CAAC;YACb,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,YAAY,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC;YAC/E,IAAI,CAAC,sBAAsB,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,OAAO,KAAK,aAAa,SAAS,EAAE,CAAC;gBACnF,OAAO,KAAK,CAAC,CAAC,IAAI,uBAAuB,CAAC;oBACxC,OAAO,EAAE,OAAO;oBAChB,UAAU,EAAE,SAAS;oBACrB,OAAO,EAAE,cAAc,qCAAqC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,+BAA+B,mCAAmC,sBAAsB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;iBAC7L,CAAC,CAAC;YACL,KAAK,CAAC,CAAC,MAAM,CAAC,MAAM,CAClB,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;gBAClB,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,cAAc,CAAC;gBACrC,MAAM,UAAU,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC;oBACpC,GAAG,EAAE,gBAAgB,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;oBACrC,SAAS,EAAE,MAAM,CAAC,IAAI,EAAE;iBACzB,CAAC,CAAC;gBACH,KAAK,CAAC,CAAC,eAAe,CAAC,UAAU,CAAC,CAAC;gBACnC,KAAK,CAAC,CAAC,kBAAkB,CAAC,UAAU,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;YACrD,CAAC,CAAC,CACH,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,sBAAsB,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;YACtF,MAAM;QACR,CAAC;QACD,KAAK,QAAQ,EAAE,CAAC;YACd,KAAK,CAAC,CAAC,YAAY,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC;YACjE,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE;gBAChE,MAAM;gBACN,QAAQ;gBACR,QAAQ;aACT,CAAC,CAAC;YACH,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,mBAAmB,CAAC,MAAM,CAAC,cAAc,CAAC,oBAAoB,CAAC,CAAC,CACzF,QAAQ,CACT,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,8CAA8C,CAAC,CAAC,CAAC,CAAC;YAC1F,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,UAAU,KAAK,WAAW,IAAI,IAAI,CAAC,WAAW,KAAK,YAAY;gBACxF,OAAO,KAAK,CAAC,CAAC,UAAU,CACtB,2EAA2E,CAC5E,CAAC;YACJ,MAAM;QACR,CAAC;QACD,KAAK,IAAI,EAAE,CAAC;YACV,yEAAyE;YACzE,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,KAAK,CAAC;YACzB,KAAK,CAAC,CAAC,UAAU,CACf,CAAC,MAAM,EAAE,EAAE,CACT,GAAG,CAAC,KAAK,CAAC;gBACR,GAAG,EAAE,OAAO,EAAE;gBACd,UAAU,EAAE,EAAE;gBACd,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC;gBAC/B,MAAM;gBACN,aAAa,EAAE,KAAK,CAAC,MAAM;gBAC3B,QAAQ,EAAE,YAAY;aACvB,CAAC,EACJ,CAAC,KAAK,EAAE,EAAE,CACR,IAAI,qBAAqB,CAAC;gBACxB,SAAS,EAAE,QAAQ;gBACnB,SAAS,EAAE,MAAM,CAAC,IAAI,EAAE;gBACxB,OAAO,EAAE,yCAAyC,KAAK,CAAC,KAAK,EAAE;gBAC/D,KAAK;aACN,CAAC,EACJ,CAAC,QAAQ,EAAE,EAAE,CACX,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;gBAClB,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC;gBAC/B,KAAK,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;gBACrC,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS;oBACxD,OAAO,KAAK,CAAC,CAAC,UAAU,CACtB,kBAAkB,KAAK,CAAC,KAAK,4EAA4E,CAC1G,CAAC;YACN,CAAC,CAAC,CACL,CAAC;YACF,MAAM;QACR,CAAC;IACH,CAAC;IACD,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,yBAAyB,EAAE;QAC/C,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,KAAK,EAAE,KAAK,CAAC,KAAK;KACnB,CAAC,CAAC;IACH,OAAO,IAAI,YAAY,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;AACtD,CAAC,EACD,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAChB,MAAM,CAAC,IAAI,CACT,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,EAC5B,MAAM,CAAC,QAAQ,CACb,cAAc,EACd,CAAC,KAAK,EAAE,EAAE,CACR,IAAI,qBAAqB,CAAC;IACxB,SAAS,EAAE,QAAQ;IACnB,SAAS,EAAE,MAAM,CAAC,IAAI,EAAE;IACxB,OAAO,EAAE,GAAG,KAAK,CAAC,OAAO,4BAA4B;IACrD,KAAK;CACN,CAAC,CACL,EACD,MAAM,CAAC,QAAQ,CAAC,CAAC,KAAK,EAAE,EAAE,CACxB,MAAM,CAAC,QAAQ,CAAC,iCAAiC,EAAE;IACjD,OAAO,EAAE,KAAK,CAAC,OAAO;IACtB,KAAK,EAAE,KAAK,CAAC,KAAK;IAClB,QAAQ,EAAE,KAAK,CAAC,IAAI;IACpB,OAAO,EAAE,KAAK,CAAC,OAAO;CACvB,CAAC,CACH,CACF,CACJ,CAAC;AAEF,qHAAqH;AACrH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,KAAgB,EAAE,EAAE,CAC5C,aAAa,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC"}

package/dist/prompt.d.ts

@@ -0,0 +1,26 @@
+import type { AgentPersona, AgentName } from "@usine/core/agent";
+import type { AttemptTask } from "@usine/core/attempt";
+import type { RepositoryName } from "@usine/core/repository";
+import type { Schema } from "effect";
+/** The recorded trigger context, Agent instructions, and effective task presented to the parent. */
+export interface PromptParts {
+    readonly repository: RepositoryName;
+    readonly payload: Schema.Json;
+    readonly agent: AgentName;
+    readonly persona: AgentPersona;
+    readonly task: AttemptTask;
+}
+/** The Agent's standing instructions and the focused task the parent delegates to a child. */
+export interface ChildPromptParts {
+    readonly agent: AgentName;
+    readonly persona: AgentPersona;
+    /** Free text authored by the parent model, not the rendered loop task. */
+    readonly task: string;
+}
+/** The attribution line every GitHub comment or review written by an Agent ends with. */
+export declare const githubSignature: (agent: AgentName) => string;
+/** Builds the parent's instructions from the saved payload, effective task, and Agent persona, including GitHub attribution. */
+export declare const assemblePrompt: (parts: PromptParts) => string;
+/** Builds a child's instructions from the delegated task and Agent persona, including GitHub attribution. */
+export declare const assembleChildPrompt: (parts: ChildPromptParts) => string;
+//# sourceMappingURL=prompt.d.ts.map

package/dist/prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../src/prompt.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACjE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAErC,oGAAoG;AACpG,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,UAAU,EAAE,cAAc,CAAC;IACpC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;IAC/B,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;CAC5B;AAED,8FAA8F;AAC9F,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;IAC/B,0EAA0E;IAC1E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,yFAAyF;AACzF,eAAO,MAAM,eAAe,UAAW,SAAS,KAAG,MAAmC,CAAC;AAYvF,gIAAgI;AAChI,eAAO,MAAM,cAAc,UAAW,WAAW,KAAG,MAoBtC,CAAC;AAEf,6GAA6G;AAC7G,eAAO,MAAM,mBAAmB,UAAW,gBAAgB,KAAG,MAWhD,CAAC"}

package/dist/prompt.js

@@ -0,0 +1,45 @@
+/** The attribution line every GitHub comment or review written by an Agent ends with. */
+export const githubSignature = (agent) => `— usine agent: ${agent}`;
+const githubInstructions = (agent) => [
+    "# GitHub identity",
+    "",
+    "All factory Agents use the same GitHub App identity, including the Agent that opened a pull request.",
+    "Submit pull request reviews with event COMMENT (gh pr review --comment), never APPROVE or REQUEST_CHANGES. Attach each review to the exact commit you reviewed.",
+    "Use the Loop's outcome labels to report findings or a passed review, and remove the opposite outcome label. A passed label does not satisfy GitHub required approvals; the operator provides any independent approval and merges.",
+    "Append this signature to every GitHub comment, issue, pull request, or review you publish:",
+    githubSignature(agent),
+];
+/** Builds the parent's instructions from the saved payload, effective task, and Agent persona, including GitHub attribution. */
+export const assemblePrompt = (parts) => [
+    "# Run context",
+    "",
+    `Repository: ${parts.repository}`,
+    "",
+    "Payload snapshot:",
+    "```json",
+    JSON.stringify(parts.payload, undefined, 2),
+    "```",
+    "",
+    "# Agent persona",
+    "",
+    parts.persona,
+    "",
+    "# Task",
+    "",
+    parts.task,
+    "",
+    ...githubInstructions(parts.agent),
+].join("\n");
+/** Builds a child's instructions from the delegated task and Agent persona, including GitHub attribution. */
+export const assembleChildPrompt = (parts) => [
+    "# Agent persona",
+    "",
+    parts.persona,
+    "",
+    "# Delegated task",
+    "",
+    parts.task,
+    "",
+    ...githubInstructions(parts.agent),
+].join("\n");
+//# sourceMappingURL=prompt.js.map

package/dist/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../src/prompt.ts"],"names":[],"mappings":"AAsBA,yFAAyF;AACzF,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,KAAgB,EAAU,EAAE,CAAC,kBAAkB,KAAK,EAAE,CAAC;AAEvF,MAAM,kBAAkB,GAAG,CAAC,KAAgB,EAAyB,EAAE,CAAC;IACtE,mBAAmB;IACnB,EAAE;IACF,sGAAsG;IACtG,iKAAiK;IACjK,mOAAmO;IACnO,4FAA4F;IAC5F,eAAe,CAAC,KAAK,CAAC;CACvB,CAAC;AAEF,gIAAgI;AAChI,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,KAAkB,EAAU,EAAE,CAC3D;IACE,eAAe;IACf,EAAE;IACF,eAAe,KAAK,CAAC,UAAU,EAAE;IACjC,EAAE;IACF,mBAAmB;IACnB,SAAS;IACT,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC;IAC3C,KAAK;IACL,EAAE;IACF,iBAAiB;IACjB,EAAE;IACF,KAAK,CAAC,OAAO;IACb,EAAE;IACF,QAAQ;IACR,EAAE;IACF,KAAK,CAAC,IAAI;IACV,EAAE;IACF,GAAG,kBAAkB,CAAC,KAAK,CAAC,KAAK,CAAC;CACnC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEf,6GAA6G;AAC7G,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,KAAuB,EAAU,EAAE,CACrE;IACE,iBAAiB;IACjB,EAAE;IACF,KAAK,CAAC,OAAO;IACb,EAAE;IACF,kBAAkB;IAClB,EAAE;IACF,KAAK,CAAC,IAAI;IACV,EAAE;IACF,GAAG,kBAAkB,CAAC,KAAK,CAAC,KAAK,CAAC;CACnC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC"}

package/dist/protocol/codex.d.ts

@@ -0,0 +1,70 @@
+import { Schema } from "effect";
+/**
+ * The request shapes usine sends to the Codex app server, restated from
+ * `@pwrdrvr/codex-app-server-protocol@0.144.0` (codex-cli 0.144.0) because
+ * that package resolves only under bundler-style resolution.
+ * This is the baseline protocol. Additional supported CLI builds are verified
+ * against their generated types and the live steering/interruption contracts.
+ * `protocol-conformance/check.ts` compiles against the baseline package and fails
+ * `pnpm check` when these shapes drift.
+ */
+export interface InitializeParams {
+    readonly clientInfo: {
+        readonly name: string;
+        readonly title: string | null;
+        readonly version: string;
+    };
+    readonly capabilities: null;
+}
+export interface ModelListParams {
+    readonly cursor?: string | null;
+    readonly limit?: number | null;
+    readonly includeHidden?: boolean | null;
+}
+export interface GetAccountParams {
+    readonly refreshToken?: boolean;
+}
+export interface ThreadStartParams {
+    readonly model?: string | null;
+    readonly allowProviderModelFallback?: boolean;
+    readonly cwd?: string | null;
+    readonly approvalPolicy?: "never" | "on-request" | "untrusted" | null;
+    readonly sandbox?: "read-only" | "workspace-write" | "danger-full-access" | null;
+    readonly serviceName?: string | null;
+    readonly ephemeral?: boolean | null;
+}
+interface TextInput {
+    readonly type: "text";
+    readonly text: string;
+    readonly text_elements: ReadonlyArray<never>;
+}
+export interface TurnStartParams {
+    readonly threadId: string;
+    readonly input: ReadonlyArray<TextInput>;
+    readonly cwd?: string | null;
+    readonly approvalPolicy?: "never" | "on-request" | "untrusted" | null;
+    readonly sandboxPolicy?: {
+        readonly type: "dangerFullAccess";
+    } | null;
+    readonly effort?: string | null;
+}
+export interface TurnSteerParams {
+    readonly threadId: string;
+    readonly expectedTurnId: string;
+    readonly input: ReadonlyArray<TextInput>;
+}
+export interface TurnInterruptParams {
+    readonly threadId: string;
+    readonly turnId: string;
+}
+export declare const AccountResponse: Schema.Struct<{
+    readonly account: Schema.NullOr<Schema.Struct<{
+        readonly type: Schema.String;
+    }>>;
+    readonly requiresOpenaiAuth: Schema.Boolean;
+}>;
+export declare const AccountUpdated: Schema.Struct<{
+    readonly authMode: Schema.NullOr<Schema.String>;
+}>;
+export {};
+//# sourceMappingURL=codex.d.ts.map

package/dist/protocol/codex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex.d.ts","sourceRoot":"","sources":["../../src/protocol/codex.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC;;;;;;;;GAQG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,UAAU,EAAE;QACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;QAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;KAC1B,CAAC;IACF,QAAQ,CAAC,YAAY,EAAE,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;CACzC;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;CACjC;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,QAAQ,CAAC,0BAA0B,CAAC,EAAE,OAAO,CAAC;IAC9C,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,GAAG,YAAY,GAAG,WAAW,GAAG,IAAI,CAAC;IACtE,QAAQ,CAAC,OAAO,CAAC,EAAE,WAAW,GAAG,iBAAiB,GAAG,oBAAoB,GAAG,IAAI,CAAC;IACjF,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;CACrC;AAED,UAAU,SAAS;IACjB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC,KAAK,CAAC,CAAC;CAC9C;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;IACzC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,GAAG,YAAY,GAAG,WAAW,GAAG,IAAI,CAAC;IACtE,QAAQ,CAAC,aAAa,CAAC,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAA;KAAE,GAAG,IAAI,CAAC;IACtE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;CAC1C;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAGD,eAAO,MAAM,eAAe;;;;;EAG1B,CAAC;AACH,eAAO,MAAM,cAAc;;EAA4D,CAAC"}

package/dist/protocol/codex.js

@@ -0,0 +1,8 @@
+import { Schema } from "effect";
+// Only authentication mode crosses this boundary; account identity is never logged.
+export const AccountResponse = Schema.Struct({
+    account: Schema.NullOr(Schema.Struct({ type: Schema.String })),
+    requiresOpenaiAuth: Schema.Boolean,
+});
+export const AccountUpdated = Schema.Struct({ authMode: Schema.NullOr(Schema.String) });
+//# sourceMappingURL=codex.js.map

package/dist/protocol/codex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex.js","sourceRoot":"","sources":["../../src/protocol/codex.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAkEhC,oFAAoF;AACpF,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,CAAC;IAC3C,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IAC9D,kBAAkB,EAAE,MAAM,CAAC,OAAO;CACnC,CAAC,CAAC;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC"}

package/dist/runtime.d.ts

@@ -0,0 +1,132 @@
+import { AgentSession, AgentSessionEvent, ChildSession } from "@usine/core/agent/session";
+import * as AttemptChannel from "@usine/core/attempt/channel";
+import { AttemptFailure } from "@usine/core/attempt/failure";
+import { Context, Effect, Schema, Scope, Stream } from "effect";
+/** The checkout directory one Attempt runs in. */
+export declare const WorkingDirectory: Schema.brand<Schema.NonEmptyString, "AgentWorkingDirectory">;
+export type WorkingDirectory = typeof WorkingDirectory.Type;
+declare const LaunchRequest_base: Schema.Class<LaunchRequest, Schema.Struct<{
+    readonly spec: typeof AttemptChannel.RunSpec;
+    readonly cwd: Schema.brand<Schema.NonEmptyString, "AgentWorkingDirectory">;
+}>, {}>;
+/** The Attempt's task and Agent choices, together with the prepared checkout where its parent starts. */
+export declare class LaunchRequest extends LaunchRequest_base {
+}
+declare const ChildRequest_base: Schema.Class<ChildRequest, Schema.Struct<{
+    readonly session: typeof ChildSession;
+    readonly cwd: Schema.brand<Schema.NonEmptyString, "AgentWorkingDirectory">;
+    readonly prompt: Schema.NonEmptyString;
+}>, {}>;
+/** Work delegated to one child, with its assigned identity and the checkout it shares with the parent. */
+export declare class ChildRequest extends ChildRequest_base {
+}
+declare const SessionResult_base: Schema.Class<SessionResult, Schema.Struct<{
+    readonly message: Schema.NonEmptyString;
+}>, {}>;
+/** The final message a parent or child session returns. */
+export declare class SessionResult extends SessionResult_base {
+}
+declare const UnknownModelError_base: Schema.Class<UnknownModelError, Schema.TaggedStruct<"UnknownModelError", {
+    readonly harness: Schema.Literals<readonly ["claude", "codex", "pi"]>;
+    readonly model: Schema.brand<Schema.String, "ModelId">;
+    readonly message: Schema.NonEmptyString;
+}>, import("effect/Cause").YieldableError>;
+/** The rostered model id is well-formed but the SDK's registry does not list it. */
+export declare class UnknownModelError extends UnknownModelError_base {
+}
+declare const PoolUnavailableError_base: Schema.Class<PoolUnavailableError, Schema.TaggedStruct<"PoolUnavailableError", {
+    readonly harness: Schema.Literals<readonly ["claude", "codex", "pi"]>;
+    readonly model: Schema.brand<Schema.String, "ModelId">;
+    readonly pool: Schema.Literals<readonly ["apiKeys", "claudePlan", "chatgptPlan"]>;
+    readonly message: Schema.NonEmptyString;
+}>, import("effect/Cause").YieldableError>;
+/** The credential cannot spend from the billing pool this session needs. */
+export declare class PoolUnavailableError extends PoolUnavailableError_base {
+}
+declare const UnsupportedEffortError_base: Schema.Class<UnsupportedEffortError, Schema.TaggedStruct<"UnsupportedEffortError", {
+    readonly harness: Schema.Literals<readonly ["claude", "codex", "pi"]>;
+    readonly model: Schema.brand<Schema.String, "ModelId">;
+    readonly effort: Schema.Literals<readonly ["off", "minimal", "low", "medium", "high", "xhigh", "max"]>;
+    readonly message: Schema.NonEmptyString;
+}>, import("effect/Cause").YieldableError>;
+/** The model exists but does not support the rostered reasoning effort. */
+export declare class UnsupportedEffortError extends UnsupportedEffortError_base {
+}
+declare const AgentResultError_base: Schema.Class<AgentResultError, Schema.TaggedStruct<"AgentResultError", {
+    readonly sessionId: Schema.OptionFromNullOr<Schema.brand<Schema.NonEmptyString, "AgentSessionId">>;
+    readonly message: Schema.NonEmptyString;
+}>, import("effect/Cause").YieldableError>;
+/** The session finished and reported that the work itself failed. */
+export declare class AgentResultError extends AgentResultError_base {
+}
+declare const ChildSessionBudgetExceededError_base: Schema.Class<ChildSessionBudgetExceededError, Schema.TaggedStruct<"ChildSessionBudgetExceededError", {
+    readonly maxChildren: Schema.brand<Schema.Int, "ChildSessionBudget">;
+    readonly attemptedChildren: Schema.brand<Schema.Int, "ChildSessionCount">;
+    readonly message: Schema.NonEmptyString;
+}>, import("effect/Cause").YieldableError>;
+/** The Pi parent asked for one more child than this Attempt's budget allows. */
+export declare class ChildSessionBudgetExceededError extends ChildSessionBudgetExceededError_base {
+}
+export declare const SESSION_OPERATIONS: readonly ["launch", "stream", "steer", "interrupt"];
+export declare const SessionOperation: Schema.Literals<readonly ["launch", "stream", "steer", "interrupt"]>;
+export type SessionOperation = typeof SessionOperation.Type;
+declare const SessionOperationError_base: Schema.Class<SessionOperationError, Schema.TaggedStruct<"SessionOperationError", {
+    readonly operation: Schema.Literals<readonly ["launch", "stream", "steer", "interrupt"]>;
+    readonly sessionId: Schema.OptionFromNullOr<Schema.brand<Schema.NonEmptyString, "AgentSessionId">>;
+    readonly message: Schema.NonEmptyString;
+    readonly cause: Schema.Defect;
+}>, import("effect/Cause").YieldableError>;
+/** The SDK or its process failed after the model and harness were validated. */
+export declare class SessionOperationError extends SessionOperationError_base {
+}
+/** A session could not start, continue, or finish its work; the failure determines whether retry needs an operator. */
+export declare const AgentSessionError: Schema.Union<readonly [typeof UnknownModelError, typeof PoolUnavailableError, typeof UnsupportedEffortError, typeof AgentResultError, typeof ChildSessionBudgetExceededError, typeof SessionOperationError]>;
+export type AgentSessionError = typeof AgentSessionError.Type;
+/**
+ * Maps session errors onto the retry taxonomy: an SDK or process failure is
+ * retryable infrastructure, while a bad roster spec or the agent failing its
+ * own work waits for the operator (ADR 0002).
+ */
+export declare const toAttemptFailure: (error: AgentSessionError) => AttemptFailure;
+/** A live parent or child session whose activity can be observed while its work continues. */
+export interface RunningSession {
+    readonly session: AgentSession;
+    /** Activity to record in the Attempt transcript while waiting for the result. */
+    readonly events: Stream.Stream<AgentSessionEvent, AgentSessionError>;
+    /** Waits for the final message or the failure that ends this session's work. */
+    readonly result: Effect.Effect<SessionResult, AgentSessionError>;
+    /** Adds operator guidance to the running session without creating a new Attempt. */
+    readonly steer: (message: string) => Effect.Effect<void, AgentSessionError>;
+    /** Requests that this session stop its current work. */
+    readonly interrupt: Effect.Effect<void, AgentSessionError>;
+}
+/** Launches coding sessions for tasks delegated by an Attempt's parent. */
+export interface ChildBackendService {
+    /** Starts the assigned child and returns its controls; its result is awaited separately. */
+    readonly launch: (request: ChildRequest) => Effect.Effect<RunningSession, AgentSessionError, Scope.Scope>;
+}
+declare const ChildBackend_base: Context.ServiceClass<ChildBackend, "@usine/agents/ChildBackend", ChildBackendService>;
+/** Runs the coding work delegated by an Attempt's parent. */
+export declare class ChildBackend extends ChildBackend_base {
+}
+declare const ClaudeChildBackend_base: Context.ServiceClass<ClaudeChildBackend, "@usine/agents/ClaudeChildBackend", ChildBackendService>;
+/** Runs delegated coding work with Claude Code. */
+export declare class ClaudeChildBackend extends ClaudeChildBackend_base {
+}
+declare const CodexChildBackend_base: Context.ServiceClass<CodexChildBackend, "@usine/agents/CodexChildBackend", ChildBackendService>;
+/** Runs delegated coding work with Codex. */
+export declare class CodexChildBackend extends CodexChildBackend_base {
+}
+declare const PiChildBackend_base: Context.ServiceClass<PiChildBackend, "@usine/agents/PiChildBackend", ChildBackendService>;
+/** Runs delegated coding work with Pi. */
+export declare class PiChildBackend extends PiChildBackend_base {
+}
+declare const AgentRuntime_base: Context.ServiceClass<AgentRuntime, "@usine/agents/AgentRuntime", {
+    /** Starts work in the prepared checkout and returns controls for observing and guiding the parent. */
+    readonly launch: (request: LaunchRequest) => Effect.Effect<RunningSession, AgentSessionError, Scope.Scope>;
+}>;
+/** Starts the parent that coordinates one Attempt's task and delegates coding work to children. */
+export declare class AgentRuntime extends AgentRuntime_base {
+}
+export {};
+//# sourceMappingURL=runtime.d.ts.map

package/dist/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AACA,OAAO,EACL,YAAY,EACZ,iBAAiB,EAGjB,YAAY,EAGb,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,cAAc,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAEL,cAAc,EAGf,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAS,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEvE,kDAAkD;AAClD,eAAO,MAAM,gBAAgB,8DAAoE,CAAC;AAClG,MAAM,MAAM,gBAAgB,GAAG,OAAO,gBAAgB,CAAC,IAAI,CAAC;;;;;AAE5D,yGAAyG;AACzG,qBAAa,aAAc,SAAQ,kBAGjC;CAAG;;;;;;AAEL,0GAA0G;AAC1G,qBAAa,YAAa,SAAQ,iBAIhC;CAAG;;;;AAEL,2DAA2D;AAC3D,qBAAa,aAAc,SAAQ,kBAEjC;CAAG;;;;;;AAEL,oFAAoF;AACpF,qBAAa,iBAAkB,SAAQ,sBAMrC;CAAG;;;;;;;AAEL,4EAA4E;AAC5E,qBAAa,oBAAqB,SAAQ,yBAOxC;CAAG;;;;;;;AAEL,2EAA2E;AAC3E,qBAAa,sBAAuB,SAAQ,2BAO1C;CAAG;;;;;AAEL,qEAAqE;AACrE,qBAAa,gBAAiB,SAAQ,qBAKpC;CAAG;;;;;;AAEL,gFAAgF;AAChF,qBAAa,+BAAgC,SAAQ,oCAMnD;CAAG;AAEL,eAAO,MAAM,kBAAkB,YAAI,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,CAAU,CAAC;AACtF,eAAO,MAAM,gBAAgB,sEAAsC,CAAC;AACpE,MAAM,MAAM,gBAAgB,GAAG,OAAO,gBAAgB,CAAC,IAAI,CAAC;;;;;;;AAE5D,gFAAgF;AAChF,qBAAa,qBAAsB,SAAQ,0BAOzC;CAAG;AAEL,uHAAuH;AACvH,eAAO,MAAM,iBAAiB,8MAO5B,CAAC;AACH,MAAM,MAAM,iBAAiB,GAAG,OAAO,iBAAiB,CAAC,IAAI,CAAC;AAE9D;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,UAAW,iBAAiB,KAAG,cAUxD,CAAC;AAEL,8FAA8F;AAC9F,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;IAC/B,iFAAiF;IACjF,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,iBAAiB,EAAE,iBAAiB,CAAC,CAAC;IACrE,gFAAgF;IAChF,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,aAAa,EAAE,iBAAiB,CAAC,CAAC;IACjE,oFAAoF;IACpF,QAAQ,CAAC,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,iBAAiB,CAAC,CAAC;IAC5E,wDAAwD;IACxD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,iBAAiB,CAAC,CAAC;CAC5D;AAED,2EAA2E;AAC3E,MAAM,WAAW,mBAAmB;IAClC,4FAA4F;IAC5F,QAAQ,CAAC,MAAM,EAAE,CACf,OAAO,EAAE,YAAY,KAClB,MAAM,CAAC,MAAM,CAAC,cAAc,EAAE,iBAAiB,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;CACpE;;AAED,6DAA6D;AAC7D,qBAAa,YAAa,SAAQ,iBAEjC;CAAG;;AAEJ,mDAAmD;AACnD,qBAAa,kBAAmB,SAAQ,uBAEvC;CAAG;;AAEJ,6CAA6C;AAC7C,qBAAa,iBAAkB,SAAQ,sBAEtC;CAAG;;AAEJ,0CAA0C;AAC1C,qBAAa,cAAe,SAAQ,mBAEnC;CAAG;;IAMA,sGAAsG;qBACrF,CACf,OAAO,EAAE,aAAa,KACnB,MAAM,CAAC,MAAM,CAAC,cAAc,EAAE,iBAAiB,EAAE,KAAK,CAAC,KAAK,CAAC;;AAPtE,mGAAmG;AACnG,qBAAa,YAAa,SAAQ,iBAQD;CAAG"}

package/dist/runtime.js

@@ -0,0 +1,109 @@
+import { Effort, Harness, ModelId } from "@usine/core/agent/brain";
+import { AgentSession, AgentSessionEvent, AgentSessionId, BillingPool, ChildSession, ChildSessionBudget, ChildSessionCount, } from "@usine/core/agent/session";
+import * as AttemptChannel from "@usine/core/attempt/channel";
+import { AgentFailure, AttemptFailure, ChildSessionBudgetFailure, InfraFailure, } from "@usine/core/attempt/failure";
+import { Context, Effect, Match, Schema, Scope, Stream } from "effect";
+/** The checkout directory one Attempt runs in. */
+export const WorkingDirectory = Schema.NonEmptyString.pipe(Schema.brand("AgentWorkingDirectory"));
+/** The Attempt's task and Agent choices, together with the prepared checkout where its parent starts. */
+export class LaunchRequest extends Schema.Class("@usine/agents/LaunchRequest")({
+    spec: AttemptChannel.RunSpec,
+    cwd: WorkingDirectory,
+}) {
+}
+/** Work delegated to one child, with its assigned identity and the checkout it shares with the parent. */
+export class ChildRequest extends Schema.Class("@usine/agents/ChildRequest")({
+    session: ChildSession,
+    cwd: WorkingDirectory,
+    prompt: Schema.NonEmptyString,
+}) {
+}
+/** The final message a parent or child session returns. */
+export class SessionResult extends Schema.Class("@usine/agents/SessionResult")({
+    message: Schema.NonEmptyString,
+}) {
+}
+/** The rostered model id is well-formed but the SDK's registry does not list it. */
+export class UnknownModelError extends Schema.TaggedError("@usine/agents/UnknownModelError")("UnknownModelError", {
+    harness: Harness,
+    model: ModelId,
+    message: Schema.NonEmptyString,
+}) {
+}
+/** The credential cannot spend from the billing pool this session needs. */
+export class PoolUnavailableError extends Schema.TaggedError("@usine/agents/PoolUnavailableError")("PoolUnavailableError", {
+    harness: Harness,
+    model: ModelId,
+    pool: BillingPool,
+    message: Schema.NonEmptyString,
+}) {
+}
+/** The model exists but does not support the rostered reasoning effort. */
+export class UnsupportedEffortError extends Schema.TaggedError("@usine/agents/UnsupportedEffortError")("UnsupportedEffortError", {
+    harness: Harness,
+    model: ModelId,
+    effort: Effort,
+    message: Schema.NonEmptyString,
+}) {
+}
+/** The session finished and reported that the work itself failed. */
+export class AgentResultError extends Schema.TaggedError("@usine/agents/AgentResultError")("AgentResultError", {
+    sessionId: Schema.OptionFromNullOr(AgentSessionId),
+    message: Schema.NonEmptyString,
+}) {
+}
+/** The Pi parent asked for one more child than this Attempt's budget allows. */
+export class ChildSessionBudgetExceededError extends Schema.TaggedError("@usine/agents/ChildSessionBudgetExceededError")("ChildSessionBudgetExceededError", {
+    maxChildren: ChildSessionBudget,
+    attemptedChildren: ChildSessionCount,
+    message: Schema.NonEmptyString,
+}) {
+}
+export const SESSION_OPERATIONS = ["launch", "stream", "steer", "interrupt"];
+export const SessionOperation = Schema.Literals(SESSION_OPERATIONS);
+/** The SDK or its process failed after the model and harness were validated. */
+export class SessionOperationError extends Schema.TaggedError("@usine/agents/SessionOperationError")("SessionOperationError", {
+    operation: SessionOperation,
+    sessionId: Schema.OptionFromNullOr(AgentSessionId),
+    message: Schema.NonEmptyString,
+    cause: Schema.Defect(),
+}) {
+}
+/** A session could not start, continue, or finish its work; the failure determines whether retry needs an operator. */
+export const AgentSessionError = Schema.Union([
+    UnknownModelError,
+    PoolUnavailableError,
+    UnsupportedEffortError,
+    AgentResultError,
+    ChildSessionBudgetExceededError,
+    SessionOperationError,
+]);
+/**
+ * Maps session errors onto the retry taxonomy: an SDK or process failure is
+ * retryable infrastructure, while a bad roster spec or the agent failing its
+ * own work waits for the operator (ADR 0002).
+ */
+export const toAttemptFailure = (error) => Match.valueTags(error, {
+    SessionOperationError: (operation) => new InfraFailure({ message: operation.message, cause: operation.cause }),
+    UnknownModelError: ({ message }) => new AgentFailure({ message }),
+    PoolUnavailableError: ({ message }) => new AgentFailure({ message }),
+    UnsupportedEffortError: ({ message }) => new AgentFailure({ message }),
+    AgentResultError: ({ message }) => new AgentFailure({ message }),
+    ChildSessionBudgetExceededError: ({ attemptedChildren, maxChildren }) => new ChildSessionBudgetFailure({ attemptedChildren, maxChildren }),
+});
+/** Runs the coding work delegated by an Attempt's parent. */
+export class ChildBackend extends Context.Service()("@usine/agents/ChildBackend") {
+}
+/** Runs delegated coding work with Claude Code. */
+export class ClaudeChildBackend extends Context.Service()("@usine/agents/ClaudeChildBackend") {
+}
+/** Runs delegated coding work with Codex. */
+export class CodexChildBackend extends Context.Service()("@usine/agents/CodexChildBackend") {
+}
+/** Runs delegated coding work with Pi. */
+export class PiChildBackend extends Context.Service()("@usine/agents/PiChildBackend") {
+}
+/** Starts the parent that coordinates one Attempt's task and delegates coding work to children. */
+export class AgentRuntime extends Context.Service()("@usine/agents/AgentRuntime") {
+}
+//# sourceMappingURL=runtime.js.map

package/dist/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,cAAc,EACd,WAAW,EACX,YAAY,EACZ,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,cAAc,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EACL,YAAY,EACZ,cAAc,EACd,yBAAyB,EACzB,YAAY,GACb,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEvE,kDAAkD;AAClD,MAAM,CAAC,MAAM,gBAAgB,GAAG,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC,CAAC;AAGlG,yGAAyG;AACzG,MAAM,OAAO,aAAc,SAAQ,MAAM,CAAC,KAAK,CAAgB,6BAA6B,CAAC,CAAC;IAC5F,IAAI,EAAE,cAAc,CAAC,OAAO;IAC5B,GAAG,EAAE,gBAAgB;CACtB,CAAC;CAAG;AAEL,0GAA0G;AAC1G,MAAM,OAAO,YAAa,SAAQ,MAAM,CAAC,KAAK,CAAe,4BAA4B,CAAC,CAAC;IACzF,OAAO,EAAE,YAAY;IACrB,GAAG,EAAE,gBAAgB;IACrB,MAAM,EAAE,MAAM,CAAC,cAAc;CAC9B,CAAC;CAAG;AAEL,2DAA2D;AAC3D,MAAM,OAAO,aAAc,SAAQ,MAAM,CAAC,KAAK,CAAgB,6BAA6B,CAAC,CAAC;IAC5F,OAAO,EAAE,MAAM,CAAC,cAAc;CAC/B,CAAC;CAAG;AAEL,oFAAoF;AACpF,MAAM,OAAO,iBAAkB,SAAQ,MAAM,CAAC,WAAW,CACvD,iCAAiC,CAClC,CAAC,mBAAmB,EAAE;IACrB,OAAO,EAAE,OAAO;IAChB,KAAK,EAAE,OAAO;IACd,OAAO,EAAE,MAAM,CAAC,cAAc;CAC/B,CAAC;CAAG;AAEL,4EAA4E;AAC5E,MAAM,OAAO,oBAAqB,SAAQ,MAAM,CAAC,WAAW,CAC1D,oCAAoC,CACrC,CAAC,sBAAsB,EAAE;IACxB,OAAO,EAAE,OAAO;IAChB,KAAK,EAAE,OAAO;IACd,IAAI,EAAE,WAAW;IACjB,OAAO,EAAE,MAAM,CAAC,cAAc;CAC/B,CAAC;CAAG;AAEL,2EAA2E;AAC3E,MAAM,OAAO,sBAAuB,SAAQ,MAAM,CAAC,WAAW,CAC5D,sCAAsC,CACvC,CAAC,wBAAwB,EAAE;IAC1B,OAAO,EAAE,OAAO;IAChB,KAAK,EAAE,OAAO;IACd,MAAM,EAAE,MAAM;IACd,OAAO,EAAE,MAAM,CAAC,cAAc;CAC/B,CAAC;CAAG;AAEL,qEAAqE;AACrE,MAAM,OAAO,gBAAiB,SAAQ,MAAM,CAAC,WAAW,CACtD,gCAAgC,CACjC,CAAC,kBAAkB,EAAE;IACpB,SAAS,EAAE,MAAM,CAAC,gBAAgB,CAAC,cAAc,CAAC;IAClD,OAAO,EAAE,MAAM,CAAC,cAAc;CAC/B,CAAC;CAAG;AAEL,gFAAgF;AAChF,MAAM,OAAO,+BAAgC,SAAQ,MAAM,CAAC,WAAW,CACrE,+CAA+C,CAChD,CAAC,iCAAiC,EAAE;IACnC,WAAW,EAAE,kBAAkB;IAC/B,iBAAiB,EAAE,iBAAiB;IACpC,OAAO,EAAE,MAAM,CAAC,cAAc;CAC/B,CAAC;CAAG;AAEL,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,CAAU,CAAC;AACtF,MAAM,CAAC,MAAM,gBAAgB,GAAG,MAAM,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAC;AAGpE,gFAAgF;AAChF,MAAM,OAAO,qBAAsB,SAAQ,MAAM,CAAC,WAAW,CAC3D,qCAAqC,CACtC,CAAC,uBAAuB,EAAE;IACzB,SAAS,EAAE,gBAAgB;IAC3B,SAAS,EAAE,MAAM,CAAC,gBAAgB,CAAC,cAAc,CAAC;IAClD,OAAO,EAAE,MAAM,CAAC,cAAc;IAC9B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE;CACvB,CAAC;CAAG;AAEL,uHAAuH;AACvH,MAAM,CAAC,MAAM,iBAAiB,GAAG,MAAM,CAAC,KAAK,CAAC;IAC5C,iBAAiB;IACjB,oBAAoB;IACpB,sBAAsB;IACtB,gBAAgB;IAChB,+BAA+B;IAC/B,qBAAqB;CACtB,CAAC,CAAC;AAGH;;;;GAIG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,KAAwB,EAAkB,EAAE,CAC3E,KAAK,CAAC,SAAS,CAAC,KAAK,EAAE;IACrB,qBAAqB,EAAE,CAAC,SAAS,EAAE,EAAE,CACnC,IAAI,YAAY,CAAC,EAAE,OAAO,EAAE,SAAS,CAAC,OAAO,EAAE,KAAK,EAAE,SAAS,CAAC,KAAK,EAAE,CAAC;IAC1E,iBAAiB,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,IAAI,YAAY,CAAC,EAAE,OAAO,EAAE,CAAC;IACjE,oBAAoB,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,IAAI,YAAY,CAAC,EAAE,OAAO,EAAE,CAAC;IACpE,sBAAsB,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,IAAI,YAAY,CAAC,EAAE,OAAO,EAAE,CAAC;IACtE,gBAAgB,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,IAAI,YAAY,CAAC,EAAE,OAAO,EAAE,CAAC;IAChE,+BAA+B,EAAE,CAAC,EAAE,iBAAiB,EAAE,WAAW,EAAE,EAAE,EAAE,CACtE,IAAI,yBAAyB,CAAC,EAAE,iBAAiB,EAAE,WAAW,EAAE,CAAC;CACpE,CAAC,CAAC;AAuBL,6DAA6D;AAC7D,MAAM,OAAO,YAAa,SAAQ,OAAO,CAAC,OAAO,EAAqC,CACpF,4BAA4B,CAC7B;CAAG;AAEJ,mDAAmD;AACnD,MAAM,OAAO,kBAAmB,SAAQ,OAAO,CAAC,OAAO,EAA2C,CAChG,kCAAkC,CACnC;CAAG;AAEJ,6CAA6C;AAC7C,MAAM,OAAO,iBAAkB,SAAQ,OAAO,CAAC,OAAO,EAA0C,CAC9F,iCAAiC,CAClC;CAAG;AAEJ,0CAA0C;AAC1C,MAAM,OAAO,cAAe,SAAQ,OAAO,CAAC,OAAO,EAAuC,CACxF,8BAA8B,CAC/B;CAAG;AAEJ,mGAAmG;AACnG,MAAM,OAAO,YAAa,SAAQ,OAAO,CAAC,OAAO,EAQ9C,CAAC,4BAA4B,CAAC;CAAG"}