@usine/agents 0.1.0 → 0.3.0

package/dist/pi/usage.js

@@ -0,0 +1,72 @@
+import { TokenCount } from "@usine/core/agent/session";
+import { Option, Schema } from "effect";
+const Count = Schema.Int.check(Schema.isGreaterThanOrEqualTo(0));
+const PiUsage = Schema.Struct({
+    role: Schema.Literal("assistant"),
+    usage: Schema.Struct({ totalTokens: Count }),
+});
+/** Pi assistant usage is per completed message, including cache tokens. */
+export const piMessageTokens = Schema.decodeUnknownOption(PiUsage);
+const ClaudeAssistantUsage = Schema.Struct({
+    type: Schema.Literal("assistant"),
+    message: Schema.Struct({
+        id: Schema.NonEmptyString,
+        usage: Schema.Struct({
+            input_tokens: Count,
+            output_tokens: Count,
+            cache_read_input_tokens: Schema.optionalKey(Schema.NullOr(Count)),
+            cache_creation_input_tokens: Schema.optionalKey(Schema.NullOr(Count)),
+        }),
+    }),
+});
+const ClaudeModelUsage = Schema.Struct({
+    inputTokens: Count,
+    outputTokens: Count,
+    cacheReadInputTokens: Count,
+    cacheCreationInputTokens: Count,
+});
+const ClaudeResultUsage = Schema.Struct({
+    type: Schema.Literal("result"),
+    modelUsage: Schema.Record(Schema.String, ClaudeModelUsage),
+});
+const decodeAssistant = Schema.decodeUnknownOption(ClaudeAssistantUsage);
+const decodeResult = Schema.decodeUnknownOption(ClaudeResultUsage);
+/** Tracks Claude's live message usage and reconciles its cumulative query meter at each result.
+ * Repeated blocks with the same message id count only their additional tokens.
+ * The SDK's result.usage is per-turn and excludes auxiliary work; modelUsage
+ * includes that work and stays cumulative across streaming-input turns.
+ */
+export const claudeTokenMeter = () => {
+    let total = 0;
+    const messages = new Map();
+    return (message) => {
+        const assistant = decodeAssistant(message);
+        if (Option.isSome(assistant)) {
+            const { id, usage } = assistant.value.message;
+            const consumed = usage.input_tokens +
+                usage.output_tokens +
+                (usage.cache_read_input_tokens ?? 0) +
+                (usage.cache_creation_input_tokens ?? 0);
+            const previous = messages.get(id) ?? 0;
+            total += Math.max(0, consumed - previous);
+            messages.set(id, Math.max(previous, consumed));
+            return Option.some(TokenCount.make(total));
+        }
+        const result = decodeResult(message);
+        if (Option.isNone(result))
+            return Option.none();
+        const consumed = Object.values(result.value.modelUsage).reduce((sum, usage) => sum +
+            usage.inputTokens +
+            usage.outputTokens +
+            usage.cacheReadInputTokens +
+            usage.cacheCreationInputTokens, 0);
+        total = Math.max(total, consumed);
+        return Option.some(TokenCount.make(total));
+    };
+};
+/** Codex's thread meter is cumulative across turns on the same thread. */
+export const CodexTokenUsage = Schema.Struct({
+    threadId: Schema.NonEmptyString,
+    tokenUsage: Schema.Struct({ total: Schema.Struct({ totalTokens: TokenCount }) }),
+});
+//# sourceMappingURL=usage.js.map

package/dist/pi/usage.js.map

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

package/dist/preflight/command.d.ts

@@ -0,0 +1,7 @@
+import { HarnessUnavailableError } from "@usine/core/agent/capability";
+import { Effect } from "effect";
+import { ChildProcessSpawner } from "effect/unstable/process";
+import { SessionOperationError } from "../runtime.ts";
+/** Runs a bounded readiness command without retaining its potentially sensitive diagnostics. */
+export declare const probeCommand: (harness: "claude" | "codex" | "pi", capability: "binary" | "login" | "version", command: string, args: readonly string[]) => Effect.Effect<string, HarnessUnavailableError | SessionOperationError, ChildProcessSpawner.ChildProcessSpawner>;
+//# sourceMappingURL=command.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../src/preflight/command.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,uBAAuB,EAA0B,MAAM,8BAA8B,CAAC;AAC/F,OAAO,EAAE,MAAM,EAAkB,MAAM,QAAQ,CAAC;AAChD,OAAO,EAAgB,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAE5E,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAEtD,gGAAgG;AAChG,eAAO,MAAM,YAAY,+OAmDvB,CAAC"}

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":"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"}

package/dist/prompt.d.ts

@@ -1,22 +1,26 @@
-import type { Agent, AttemptChannel, Repository } from "@usine/core";
+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: Repository.Name;
+    readonly repository: RepositoryName;
     readonly payload: Schema.Json;
-    readonly agent: Agent.Name;
-    readonly persona: Agent.Persona;
-    readonly task: AttemptChannel.Task;
+    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: Agent.Name;
-    readonly persona: Agent.Persona;
+    readonly agent: AgentName;
+    readonly persona: AgentPersona;
     /** Free text authored by the parent model, not the rendered loop task. */
     readonly task: string;
 }
-/** Human-visible attribution required on GitHub content authored by an Agent. */
-export declare const githubSignature: (agent: Agent.Name) => string;
-/** Builds the complete parent prompt from immutable run context. */
+/** 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 the isolated prompt given to a first-level child session. */
+/** 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

@@ -1 +1 @@
-{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../src/prompt.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACrE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAErC,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC,IAAI,CAAC;IACrC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC;IAChC,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC,IAAI,CAAC;CACpC;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC;IAChC,0EAA0E;IAC1E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,iFAAiF;AACjF,eAAO,MAAM,eAAe,UAAW,KAAK,CAAC,IAAI,KAAG,MAAmC,CAAC;AAExF,oEAAoE;AACpE,eAAO,MAAM,cAAc,UAAW,WAAW,KAAG,MAuBtC,CAAC;AAEf,uEAAuE;AACvE,eAAO,MAAM,mBAAmB,UAAW,gBAAgB,KAAG,MAchD,CAAC"}
+{"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

@@ -1,6 +1,15 @@
-/** Human-visible attribution required on GitHub content authored by an Agent. */
+/** The attribution line every GitHub comment or review written by an Agent ends with. */
 export const githubSignature = (agent) => `— usine agent: ${agent}`;
-/** Builds the complete parent prompt from immutable run context. */
+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",
     "",
@@ -19,12 +28,9 @@ export const assemblePrompt = (parts) => [
     "",
     parts.task,
     "",
-    "# GitHub identity",
-    "",
-    "Append this signature to every GitHub comment, issue, or pull request you publish:",
-    githubSignature(parts.agent),
+    ...githubInstructions(parts.agent),
 ].join("\n");
-/** Builds the isolated prompt given to a first-level child session. */
+/** Builds a child's instructions from the delegated task and Agent persona, including GitHub attribution. */
 export const assembleChildPrompt = (parts) => [
     "# Agent persona",
     "",
@@ -34,9 +40,6 @@ export const assembleChildPrompt = (parts) => [
     "",
     parts.task,
     "",
-    "# GitHub identity",
-    "",
-    "Append this signature to every GitHub comment, issue, or pull request you publish:",
-    githubSignature(parts.agent),
+    ...githubInstructions(parts.agent),
 ].join("\n");
 //# sourceMappingURL=prompt.js.map

package/dist/prompt.js.map

@@ -1 +1 @@
-{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../src/prompt.ts"],"names":[],"mappings":"AAkBA,iFAAiF;AACjF,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,KAAiB,EAAU,EAAE,CAAC,kBAAkB,KAAK,EAAE,CAAC;AAExF,oEAAoE;AACpE,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,mBAAmB;IACnB,EAAE;IACF,oFAAoF;IACpF,eAAe,CAAC,KAAK,CAAC,KAAK,CAAC;CAC7B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEf,uEAAuE;AACvE,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,mBAAmB;IACnB,EAAE;IACF,oFAAoF;IACpF,eAAe,CAAC,KAAK,CAAC,KAAK,CAAC;CAC7B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC"}
+{"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

@@ -1,10 +1,12 @@
+import { Schema } from "effect";
 /**
- * NodeNext-compatible view of the exact-pinned generated app-server protocol
- * (`@pwrdrvr/codex-app-server-protocol@0.144.0`, mirroring codex-cli 0.144.0).
- * The upstream package omits extensions in its generated source, so it only
- * resolves under bundler-style resolution; these are the request shapes usine
- * sends on that pinned wire version. `protocol-conformance/check.ts` compiles
- * against the real package and fails `pnpm check` when this view drifts.
+ * 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: {
@@ -19,6 +21,9 @@ export interface ModelListParams {
     readonly limit?: number | null;
     readonly includeHidden?: boolean | null;
 }
+export interface GetAccountParams {
+    readonly refreshToken?: boolean;
+}
 export interface ThreadStartParams {
     readonly model?: string | null;
     readonly allowProviderModelFallback?: boolean;
@@ -52,5 +57,14 @@ 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

@@ -1 +1 @@
-{"version":3,"file":"codex.d.ts","sourceRoot":"","sources":["../../src/protocol/codex.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;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,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"}
+{"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

@@ -1,2 +1,8 @@
-export {};
+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

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

@@ -1,27 +1,29 @@
-import { Agent, AttemptChannel, AttemptFailure } from "@usine/core";
+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";
-/** Value object: process-local working directory for one isolated Attempt. */
+/** 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">;
 }>, {}>;
-/** Complete input required to start the Pi parent inside one Attempt checkout. */
+/** 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 Agent.ChildSession;
+    readonly session: typeof ChildSession;
     readonly cwd: Schema.brand<Schema.NonEmptyString, "AgentWorkingDirectory">;
     readonly prompt: Schema.NonEmptyString;
 }>, {}>;
-/** Complete input for exactly one first-level child session. */
+/** 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;
 }>, {}>;
-/** Terminal semantic output from a parent or child SDK session. */
+/** 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", {
@@ -29,7 +31,7 @@ declare const UnknownModelError_base: Schema.Class<UnknownModelError, Schema.Tag
     readonly model: Schema.brand<Schema.String, "ModelId">;
     readonly message: Schema.NonEmptyString;
 }>, import("effect/Cause").YieldableError>;
-/** The configured vendor model id is well-formed but absent from the selected SDK registry. */
+/** 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", {
@@ -38,7 +40,7 @@ declare const PoolUnavailableError_base: Schema.Class<PoolUnavailableError, Sche
     readonly pool: Schema.Literals<readonly ["apiKeys", "claudePlan", "chatgptPlan"]>;
     readonly message: Schema.NonEmptyString;
 }>, import("effect/Cause").YieldableError>;
-/** The selected credential cannot draw from the billing pool required by this session. */
+/** 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", {
@@ -47,16 +49,24 @@ declare const UnsupportedEffortError_base: Schema.Class<UnsupportedEffortError,
     readonly effort: Schema.Literals<readonly ["off", "minimal", "low", "medium", "high", "xhigh", "max"]>;
     readonly message: Schema.NonEmptyString;
 }>, import("effect/Cause").YieldableError>;
-/** The selected model exists but does not support the rostered reasoning effort. */
+/** 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 ran to a terminal state and reported that the work itself failed. */
+/** 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;
@@ -66,48 +76,72 @@ declare const SessionOperationError_base: Schema.Class<SessionOperationError, Sc
     readonly message: Schema.NonEmptyString;
     readonly cause: Schema.Defect;
 }>, import("effect/Cause").YieldableError>;
-/** SDK/process failure after model and harness validation. */
+/** The SDK or its process failed after the model and harness were validated. */
 export declare class SessionOperationError extends SessionOperationError_base {
 }
-export declare const AgentSessionError: Schema.Union<readonly [typeof UnknownModelError, typeof PoolUnavailableError, typeof UnsupportedEffortError, typeof AgentResultError, typeof SessionOperationError]>;
+/** 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;
 /**
- * The one place the session error union meets the ADR 0002 retry taxonomy:
- * SDK/process trouble is retryable infrastructure; a bad roster spec or the
- * agent failing its own work always waits for the operator.
+ * 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.AttemptFailure;
-/** Live SDK session. Its event stream and controls are backend-independent. */
+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: Agent.Session;
-    readonly events: Stream.Stream<Agent.SessionEvent, AgentSessionError>;
+    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>;
+    /** Applies a nonterminal operator action; child messages hold completion until release. */
+    readonly intervene: (action: AttemptChannel.OperatorAction) => Effect.Effect<AttemptChannel.InterventionState, AgentSessionError>;
+}
+/**
+ * Records each live child session so the run host can route operator input
+ * (steer, interrupt, or a takeover message) to one by the id it reports in the
+ * normalized event stream. The parent registers no child; it is addressed
+ * directly. Registration is scoped: the entry is removed when the child's scope
+ * closes, so a returned child is no longer addressable (ADR 0018).
+ */
+export interface ChildSessions {
+    readonly register: (session: RunningSession) => Effect.Effect<void, never, Scope.Scope>;
 }
+/** 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>;
-/** Stable first-level child seam selected by the authored BrainSpec harness. */
+/** 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>;
-/** Concrete Claude child implementation consumed by the harness dispatcher. */
+/** 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>;
-/** Concrete Codex child implementation consumed by the harness dispatcher. */
+/** Runs delegated coding work with Codex. */
 export declare class CodexChildBackend extends CodexChildBackend_base {
 }
 declare const PiChildBackend_base: Context.ServiceClass<PiChildBackend, "@usine/agents/PiChildBackend", ChildBackendService>;
-/** Concrete Pi child implementation consumed by the harness dispatcher. */
+/** Runs delegated coding work with Pi. */
 export declare class PiChildBackend extends PiChildBackend_base {
 }
 declare const AgentRuntime_base: Context.ServiceClass<AgentRuntime, "@usine/agents/AgentRuntime", {
-    readonly launch: (request: LaunchRequest) => Effect.Effect<RunningSession, AgentSessionError, Scope.Scope>;
+    /**
+     * Starts work in the prepared checkout and returns controls for observing and
+     * guiding the parent. Each child it spawns registers with `children` so the
+     * run host can address a takeover to it by id.
+     */
+    readonly launch: (request: LaunchRequest, children: ChildSessions) => Effect.Effect<RunningSession, AgentSessionError, Scope.Scope>;
 }>;
-/** Stable parent seam consumed by the run host. */
+/** Starts the parent that coordinates one Attempt's task and delegates coding work to children. */
 export declare class AgentRuntime extends AgentRuntime_base {
 }
 export {};