@usine/agents 0.2.0 → 0.4.0

package/dist/protocol/codex.js.map

@@ -1 +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"}
+{"version":3,"file":"codex.js","sourceRoot":"","sources":["../../src/protocol/codex.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AA+DhC,6EAA6E;AAC7E,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,23 +1,28 @@
-import { AgentSession, AgentSessionEvent, ChildSession } from "@usine/core/agent/session";
+import { AgentSession, AgentSessionEvent, AgentSessionId, ChildSession } from "@usine/core/agent/session";
 import * as AttemptChannel from "@usine/core/attempt/channel";
+import { WorkerName } from "@usine/core/worker";
 import { AttemptFailure } from "@usine/core/attempt/failure";
-import { Context, Effect, Schema, Scope, Stream } from "effect";
-/** The checkout directory one Attempt runs in. */
+import { Context, Effect, Option, Schema, Scope, Stream } from "effect";
+/** The checkout directory of an Attempt. */
 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;
+    /** The checkout directory on `host`. */
     readonly cwd: Schema.brand<Schema.NonEmptyString, "AgentWorkingDirectory">;
     readonly prompt: Schema.NonEmptyString;
+    /**
+     * The complete environment of the child process and its commands: the Worker's allowlisted
+     * variables plus the Attempt's credential configuration, with nothing inherited from the launching
+     * process (ADR 0011). On a `RemoteShell` host, the variables are exported on top of the remote
+     * environment, which contains no orchestrator secret.
+     */
+    readonly environment: Schema.$Record<Schema.String, Schema.String>;
+    readonly host: Schema.Union<readonly [typeof import("./child-host/child-host.ts").LocalProcess, typeof import("./child-host/child-host.ts").RemoteShell]>;
+    /** The Worker that `host` runs on; Claude children on one Worker share its Claude login. */
+    readonly worker: Schema.brand<Schema.String, "WorkerName">;
 }>, {}>;
-/** Work delegated to one child, with its assigned identity and the checkout it shares with the parent. */
+/** A task delegated to one child, with its session and the checkout it shares with the parent. */
 export declare class ChildRequest extends ChildRequest_base {
 }
 declare const SessionResult_base: Schema.Class<SessionResult, Schema.Struct<{
@@ -31,7 +36,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 rostered model id is well-formed but the SDK's registry does not list it. */
+/** An error for a well-formed rostered model ID that the SDK's registry does not list. */
 export declare class UnknownModelError extends UnknownModelError_base {
 }
 declare const PoolUnavailableError_base: Schema.Class<PoolUnavailableError, Schema.TaggedStruct<"PoolUnavailableError", {
@@ -40,7 +45,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 credential cannot spend from the billing pool this session needs. */
+/** An error for a credential that cannot use the billing pool the session needs. */
 export declare class PoolUnavailableError extends PoolUnavailableError_base {
 }
 declare const UnsupportedEffortError_base: Schema.Class<UnsupportedEffortError, Schema.TaggedStruct<"UnsupportedEffortError", {
@@ -49,22 +54,52 @@ 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 model exists but does not support the rostered reasoning effort. */
+/** An error for a model that does not support the rostered reasoning effort. */
 export declare class UnsupportedEffortError extends UnsupportedEffortError_base {
 }
+/**
+ * The reserved prefix of a final answer that reports an unresolved blocker. The session fails with
+ * `AgentBlockedError`, whose message is the text after the marker.
+ */
+export declare const BLOCKED_MARKER = "[usine:blocked]";
+/**
+ * The reserved prefix of a final answer that asks the operator for a decision. The session fails
+ * with `AgentQuestionError`, whose message is the text after the marker.
+ */
+export declare const QUESTION_MARKER = "[usine:question]";
+/**
+ * The reserved prefix of a report that relays a harness failure, such as a child's failed Codex
+ * turn, to the parent. The session fails with `AgentResultError`, which ends the Attempt with
+ * `AgentFailure`.
+ */
+export declare const FAILED_MARKER = "[usine:failed]";
 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. */
+/** An error for a session that finished and reported that the work failed. */
 export declare class AgentResultError extends AgentResultError_base {
 }
+declare const AgentBlockedError_base: Schema.Class<AgentBlockedError, Schema.TaggedStruct<"AgentBlockedError", {
+    readonly sessionId: Schema.OptionFromNullOr<Schema.brand<Schema.NonEmptyString, "AgentSessionId">>;
+    readonly message: Schema.NonEmptyString;
+}>, import("effect/Cause").YieldableError>;
+/** An error for a session that finished with the blocker marker; `message` is the blocker text. */
+export declare class AgentBlockedError extends AgentBlockedError_base {
+}
+declare const AgentQuestionError_base: Schema.Class<AgentQuestionError, Schema.TaggedStruct<"AgentQuestionError", {
+    readonly sessionId: Schema.OptionFromNullOr<Schema.brand<Schema.NonEmptyString, "AgentSessionId">>;
+    readonly message: Schema.NonEmptyString;
+}>, import("effect/Cause").YieldableError>;
+/** An error for a session that finished with a question for the operator; `message` is the question. */
+export declare class AgentQuestionError extends AgentQuestionError_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. */
+/** An error for a Pi parent that requested more children than the Attempt's budget allows. */
 export declare class ChildSessionBudgetExceededError extends ChildSessionBudgetExceededError_base {
 }
 export declare const SESSION_OPERATIONS: readonly ["launch", "stream", "steer", "interrupt"];
@@ -76,57 +111,83 @@ declare const SessionOperationError_base: Schema.Class<SessionOperationError, Sc
     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. */
+/** An error for an SDK or process failure 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]>;
+/** Any error that stops a session from starting, continuing, or finishing; the error type determines whether a retry needs the operator. */
+export declare const AgentSessionError: Schema.Union<readonly [typeof UnknownModelError, typeof PoolUnavailableError, typeof UnsupportedEffortError, typeof AgentResultError, typeof AgentBlockedError, typeof AgentQuestionError, 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).
+ * A report that a session ends with: a blocker or question marked in its final answer, or a failure
+ * reported by its harness. A child relays each report to the parent with the same marker.
+ */
+export type AgentReport = AgentResultError | AgentBlockedError | AgentQuestionError;
+/**
+ * Returns the report of a final answer that starts with `[usine:blocked]`, `[usine:question]`, or
+ * `[usine:failed]`; the details can follow on the same line or the next. Returns `None` if the answer
+ * does not start with a marker.
+ */
+export declare const reportedOutcome: (sessionId: Option.Option<AgentSessionId>, answer: string) => Option.Option<AgentReport>;
+/** Returns the final answer that relays `report`, starting with its marker. */
+export declare const reportText: (report: AgentReport) => string;
+/**
+ * Maps a session error to an Attempt failure: SDK and process failures are retryable infrastructure
+ * failures; roster errors and Agent-reported failures wait 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. */
+/** A running parent or child session. */
 export interface RunningSession {
     readonly session: AgentSession;
-    /** Activity to record in the Attempt transcript while waiting for the result. */
+    /** The session activity to record in the Attempt transcript. */
     readonly events: Stream.Stream<AgentSessionEvent, AgentSessionError>;
-    /** Waits for the final message or the failure that ends this session's work. */
+    /** Waits for the session's final message, or fails with the error that ended it. */
     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. */
+    /** Requests that the session stop its current work. */
     readonly interrupt: Effect.Effect<void, AgentSessionError>;
-}
-/** Launches coding sessions for tasks delegated by an Attempt's parent. */
+    /**
+     * Applies a nonterminal operator action; after a child message, the session does not complete
+     * until release. If the harness reads the message only at its next boundary, returns `queued` and
+     * calls `onDelivery` once: with the session state when it is read, or `None` if the session stops
+     * first.
+     */
+    readonly intervene: (action: AttemptChannel.OperatorAction, onDelivery: OnDelivery) => Effect.Effect<AttemptChannel.InterventionState, AgentSessionError>;
+}
+/** A callback, called once for a queued operator message with the session state when it was read, or `None` if the session stopped first. */
+export type OnDelivery = (delivered: Option.Option<AttemptChannel.InterventionState>) => Effect.Effect<void>;
+/** A backend that launches child 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. */
+    /** Starts the child and returns its controls; `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. */
+/** The service that runs tasks delegated by an Attempt's parent. */
 export declare class ChildBackend extends ChildBackend_base {
 }
+declare const ClaudeLoginLock_base: Context.ServiceClass<ClaudeLoginLock, "@usine/agents/ClaudeLoginLock", {
+    /** Runs `effect` with `worker`'s lock, after waiting for any other effect that has the lock. */
+    readonly withLock: (worker: WorkerName) => <A, E, R>(effect: Effect.Effect<A, E, R>) => Effect.Effect<A, E, R>;
+}>;
+/**
+ * A per-Worker lock for Claude commands that can refresh the Worker's shared Claude login: the
+ * preflight login check and the start of a Claude child. Claude Code ends a process that finds
+ * another process refreshing the login (#453). Provide one instance to both the executor and the
+ * Attempt runtime.
+ */
+export declare class ClaudeLoginLock extends ClaudeLoginLock_base {
+}
 declare const ClaudeChildBackend_base: Context.ServiceClass<ClaudeChildBackend, "@usine/agents/ClaudeChildBackend", ChildBackendService>;
-/** Runs delegated coding work with Claude Code. */
+/** The child backend for 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. */
+/** The child backend for 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. */
+/** The child backend for 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

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

package/dist/runtime.js

@@ -1,21 +1,28 @@
 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. */
+import { WorkerName } from "@usine/core/worker";
+import { AgentFailure, AttemptFailure, BlockedFailure, ChildSessionBudgetFailure, InfraFailure, QuestionFailure, } from "@usine/core/attempt/failure";
+import { Context, Effect, Match, Option, Schema, Scope, Stream } from "effect";
+import { ChildHost } from "./child-host/child-host.js";
+/** The checkout directory of an Attempt. */
 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. */
+/** A task delegated to one child, with its session and the checkout it shares with the parent. */
 export class ChildRequest extends Schema.Class("@usine/agents/ChildRequest")({
     session: ChildSession,
+    /** The checkout directory on `host`. */
     cwd: WorkingDirectory,
     prompt: Schema.NonEmptyString,
+    /**
+     * The complete environment of the child process and its commands: the Worker's allowlisted
+     * variables plus the Attempt's credential configuration, with nothing inherited from the launching
+     * process (ADR 0011). On a `RemoteShell` host, the variables are exported on top of the remote
+     * environment, which contains no orchestrator secret.
+     */
+    environment: Schema.Record(Schema.String, Schema.String),
+    host: ChildHost,
+    /** The Worker that `host` runs on; Claude children on one Worker share its Claude login. */
+    worker: WorkerName,
 }) {
 }
 /** The final message a parent or child session returns. */
@@ -23,14 +30,14 @@ 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. */
+/** An error for a well-formed rostered model ID that the SDK's registry does not list. */
 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. */
+/** An error for a credential that cannot use the billing pool the session needs. */
 export class PoolUnavailableError extends Schema.TaggedError("@usine/agents/PoolUnavailableError")("PoolUnavailableError", {
     harness: Harness,
     model: ModelId,
@@ -38,7 +45,7 @@ export class PoolUnavailableError extends Schema.TaggedError("@usine/agents/Pool
     message: Schema.NonEmptyString,
 }) {
 }
-/** The model exists but does not support the rostered reasoning effort. */
+/** An error for a model that does not support the rostered reasoning effort. */
 export class UnsupportedEffortError extends Schema.TaggedError("@usine/agents/UnsupportedEffortError")("UnsupportedEffortError", {
     harness: Harness,
     model: ModelId,
@@ -46,13 +53,41 @@ export class UnsupportedEffortError extends Schema.TaggedError("@usine/agents/Un
     message: Schema.NonEmptyString,
 }) {
 }
-/** The session finished and reported that the work itself failed. */
+/**
+ * The reserved prefix of a final answer that reports an unresolved blocker. The session fails with
+ * `AgentBlockedError`, whose message is the text after the marker.
+ */
+export const BLOCKED_MARKER = "[usine:blocked]";
+/**
+ * The reserved prefix of a final answer that asks the operator for a decision. The session fails
+ * with `AgentQuestionError`, whose message is the text after the marker.
+ */
+export const QUESTION_MARKER = "[usine:question]";
+/**
+ * The reserved prefix of a report that relays a harness failure, such as a child's failed Codex
+ * turn, to the parent. The session fails with `AgentResultError`, which ends the Attempt with
+ * `AgentFailure`.
+ */
+export const FAILED_MARKER = "[usine:failed]";
+/** An error for a session that finished and reported that the work 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. */
+/** An error for a session that finished with the blocker marker; `message` is the blocker text. */
+export class AgentBlockedError extends Schema.TaggedError("@usine/agents/AgentBlockedError")("AgentBlockedError", {
+    sessionId: Schema.OptionFromNullOr(AgentSessionId),
+    message: Schema.NonEmptyString,
+}) {
+}
+/** An error for a session that finished with a question for the operator; `message` is the question. */
+export class AgentQuestionError extends Schema.TaggedError("@usine/agents/AgentQuestionError")("AgentQuestionError", {
+    sessionId: Schema.OptionFromNullOr(AgentSessionId),
+    message: Schema.NonEmptyString,
+}) {
+}
+/** An error for a Pi parent that requested more children than the Attempt's budget allows. */
 export class ChildSessionBudgetExceededError extends Schema.TaggedError("@usine/agents/ChildSessionBudgetExceededError")("ChildSessionBudgetExceededError", {
     maxChildren: ChildSessionBudget,
     attemptedChildren: ChildSessionCount,
@@ -61,7 +96,7 @@ export class ChildSessionBudgetExceededError extends Schema.TaggedError("@usine/
 }
 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. */
+/** An error for an SDK or process failure after the model and harness were validated. */
 export class SessionOperationError extends Schema.TaggedError("@usine/agents/SessionOperationError")("SessionOperationError", {
     operation: SessionOperation,
     sessionId: Schema.OptionFromNullOr(AgentSessionId),
@@ -69,19 +104,58 @@ export class SessionOperationError extends Schema.TaggedError("@usine/agents/Ses
     cause: Schema.Defect(),
 }) {
 }
-/** A session could not start, continue, or finish its work; the failure determines whether retry needs an operator. */
+/** Any error that stops a session from starting, continuing, or finishing; the error type determines whether a retry needs the operator. */
 export const AgentSessionError = Schema.Union([
     UnknownModelError,
     PoolUnavailableError,
     UnsupportedEffortError,
     AgentResultError,
+    AgentBlockedError,
+    AgentQuestionError,
     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).
+ * Returns the report of a final answer that starts with `[usine:blocked]`, `[usine:question]`, or
+ * `[usine:failed]`; the details can follow on the same line or the next. Returns `None` if the answer
+ * does not start with a marker.
+ */
+export const reportedOutcome = (sessionId, answer) => {
+    const trimmed = answer.trim();
+    if (trimmed.startsWith(QUESTION_MARKER)) {
+        return Option.some(new AgentQuestionError({
+            sessionId,
+            message: trimmed.slice(QUESTION_MARKER.length).trim() ||
+                "Agent asked the operator a question without writing it.",
+        }));
+    }
+    if (trimmed.startsWith(BLOCKED_MARKER)) {
+        return Option.some(new AgentBlockedError({
+            sessionId,
+            message: trimmed.slice(BLOCKED_MARKER.length).trim() ||
+                "Agent reported an unresolved blocker without details.",
+        }));
+    }
+    if (trimmed.startsWith(FAILED_MARKER)) {
+        return Option.some(new AgentResultError({
+            sessionId,
+            message: trimmed.slice(FAILED_MARKER.length).trim() || "Agent reported a failure without details.",
+        }));
+    }
+    return Option.none();
+};
+/** Returns the final answer that relays `report`, starting with its marker. */
+export const reportText = (report) => {
+    const marker = Match.valueTags(report, {
+        AgentResultError: () => FAILED_MARKER,
+        AgentBlockedError: () => BLOCKED_MARKER,
+        AgentQuestionError: () => QUESTION_MARKER,
+    });
+    return `${marker}\n${report.message}`;
+};
+/**
+ * Maps a session error to an Attempt failure: SDK and process failures are retryable infrastructure
+ * failures; roster errors and Agent-reported failures wait for the operator (ADR 0002).
  */
 export const toAttemptFailure = (error) => Match.valueTags(error, {
     SessionOperationError: (operation) => new InfraFailure({ message: operation.message, cause: operation.cause }),
@@ -89,21 +163,28 @@ export const toAttemptFailure = (error) => Match.valueTags(error, {
     PoolUnavailableError: ({ message }) => new AgentFailure({ message }),
     UnsupportedEffortError: ({ message }) => new AgentFailure({ message }),
     AgentResultError: ({ message }) => new AgentFailure({ message }),
+    AgentBlockedError: ({ message }) => new BlockedFailure({ message }),
+    AgentQuestionError: ({ message }) => new QuestionFailure({ question: message }),
     ChildSessionBudgetExceededError: ({ attemptedChildren, maxChildren }) => new ChildSessionBudgetFailure({ attemptedChildren, maxChildren }),
 });
-/** Runs the coding work delegated by an Attempt's parent. */
+/** The service that runs tasks delegated by an Attempt's parent. */
 export class ChildBackend extends Context.Service()("@usine/agents/ChildBackend") {
 }
-/** Runs delegated coding work with Claude Code. */
+/**
+ * A per-Worker lock for Claude commands that can refresh the Worker's shared Claude login: the
+ * preflight login check and the start of a Claude child. Claude Code ends a process that finds
+ * another process refreshing the login (#453). Provide one instance to both the executor and the
+ * Attempt runtime.
+ */
+export class ClaudeLoginLock extends Context.Service()("@usine/agents/ClaudeLoginLock") {
+}
+/** The child backend for Claude Code. */
 export class ClaudeChildBackend extends Context.Service()("@usine/agents/ClaudeChildBackend") {
 }
-/** Runs delegated coding work with Codex. */
+/** The child backend for Codex. */
 export class CodexChildBackend extends Context.Service()("@usine/agents/CodexChildBackend") {
 }
-/** Runs delegated coding work with Pi. */
+/** The child backend for 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

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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@usine/agents",
-  "version": "0.2.0",
-  "description": "The usine agent layer: Pi parent adapter, subagents extension, team roster and brain specs.",
+  "version": "0.4.0",
+  "description": "The usine agent layer: Claude Code, Codex, and Pi child backends, Attempt prompts, and harness preflight.",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -9,7 +9,8 @@
     "directory": "packages/agents"
   },
   "files": [
-    "dist"
+    "dist",
+    "!dist/tsconfig.tsbuildinfo"
   ],
   "type": "module",
   "sideEffects": false,
@@ -18,6 +19,10 @@
       "types": "./dist/pi/pi.d.ts",
       "default": "./dist/pi/pi.js"
     },
+    "./child-host": {
+      "types": "./dist/child-host/child-host.d.ts",
+      "default": "./dist/child-host/child-host.js"
+    },
     "./children": {
       "types": "./dist/pi/children.d.ts",
       "default": "./dist/pi/children.js"
@@ -30,9 +35,9 @@
       "types": "./dist/pi/codex/codex.d.ts",
       "default": "./dist/pi/codex/codex.js"
     },
-    "./pi/live": {
-      "types": "./dist/pi/live.d.ts",
-      "default": "./dist/pi/live.js"
+    "./pi/authentication": {
+      "types": "./dist/pi/authentication.d.ts",
+      "default": "./dist/pi/authentication.js"
     },
     "./prompt": {
       "types": "./dist/prompt.d.ts",
@@ -51,10 +56,16 @@
     "access": "public"
   },
   "dependencies": {
-    "@anthropic-ai/claude-agent-sdk": "0.3.261",
-    "@earendil-works/pi-coding-agent": "0.85.1",
-    "typebox": "1.3.7",
-    "@usine/core": "0.2.0"
+    "@anthropic-ai/claude-agent-sdk": "0.3.308",
+    "@earendil-works/chord": "1.1.0",
+    "@earendil-works/pi-agent-core": "1.1.0",
+    "@earendil-works/pi-ai": "1.1.0",
+    "@earendil-works/pi-codemode": "1.1.0",
+    "@earendil-works/pi-coding-agent": "1.1.0",
+    "@earendil-works/pi-mcp": "1.1.0",
+    "@earendil-works/pi-telemetry": "1.1.0",
+    "@earendil-works/pi-tui": "1.1.0",
+    "@usine/core": "0.4.0"
   },
   "devDependencies": {
     "@effect/platform-node": "4.0.0-rc.111",
@@ -75,6 +86,7 @@
     "build": "tsc -b",
     "check": "tsc -p tsconfig.check.json && tsc -p tsconfig.conformance.json",
     "test": "vitest run --exclude 'test/integration/**'",
+    "test:integration:claude": "vitest run test/integration/claude.test.ts",
     "test:integration:codex": "vitest run test/integration/codex.test.ts",
     "test:integration:pi": "vitest run test/integration/pi.test.ts"
   }

package/dist/pi/live.d.ts

@@ -1,4 +0,0 @@
-import { Layer } from "effect";
-/** The Node agent runtime: the Pi parent with the Claude, Codex, and Pi child backends. */
-export declare const layer: Layer.Layer<import("../runtime.ts").AgentRuntime, never, import("effect/unstable/process/ChildProcessSpawner").ChildProcessSpawner>;
-//# sourceMappingURL=live.d.ts.map

package/dist/pi/live.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"live.d.ts","sourceRoot":"","sources":["../../src/pi/live.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAgB/B,2FAA2F;AAC3F,eAAO,MAAM,KAAK,qIAAuE,CAAC"}

package/dist/pi/live.js

@@ -1,11 +0,0 @@
-import { Layer } from "effect";
-import { claudeChildBackendLayer, claudeSdkLive } from "./claude.js";
-import { childDispatcherLayer } from "./children.js";
-import { codexAppServerLive } from "./codex/app-server.js";
-import { codexChildBackendLayer } from "./codex/codex.js";
-import { piChildBackendLayer, piParentLayer, piSdkLive } from "./pi.js";
-const childImplementations = Layer.merge(claudeChildBackendLayer.pipe(Layer.provide(claudeSdkLive)), Layer.merge(codexChildBackendLayer.pipe(Layer.provide(codexAppServerLive)), piChildBackendLayer.pipe(Layer.provide(piSdkLive))));
-const childLive = childDispatcherLayer.pipe(Layer.provide(childImplementations));
-/** The Node agent runtime: the Pi parent with the Claude, Codex, and Pi child backends. */
-export const layer = piParentLayer.pipe(Layer.provide(Layer.merge(piSdkLive, childLive)));
-//# sourceMappingURL=live.js.map

package/dist/pi/live.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"live.js","sourceRoot":"","sources":["../../src/pi/live.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAC/B,OAAO,EAAE,uBAAuB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACrE,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAExE,MAAM,oBAAoB,GAAG,KAAK,CAAC,KAAK,CACtC,uBAAuB,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,EAC1D,KAAK,CAAC,KAAK,CACT,sBAAsB,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC,EAC9D,mBAAmB,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CACnD,CACF,CAAC;AACF,MAAM,SAAS,GAAG,oBAAoB,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAAC,CAAC;AAEjF,2FAA2F;AAC3F,MAAM,CAAC,MAAM,KAAK,GAAG,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC"}

package/dist/pi/subagents.d.ts

@@ -1,27 +0,0 @@
-import { type ExtensionFactory, type InlineExtension } from "@earendil-works/pi-coding-agent";
-import { Agent } from "@usine/core/agent";
-import { AgentSessionEvent, AgentSessionId, ChildSessionBudget } from "@usine/core/agent/session";
-import { Effect } from "effect";
-import { type AgentSessionError, type ChildBackend, ChildSessionBudgetExceededError, type WorkingDirectory } from "../runtime.ts";
-export interface SubagentsExtensionOptions {
-    readonly agent: Agent;
-    readonly backend: ChildBackend["Service"];
-    readonly cwd: WorkingDirectory;
-    readonly emit: (event: AgentSessionEvent) => Effect.Effect<void>;
-    readonly maxChildren: ChildSessionBudget;
-    /** Called on every rejected spawn; the parent decides what a repeat means. */
-    readonly onBudgetExceeded: (error: ChildSessionBudgetExceededError) => Effect.Effect<void>;
-    readonly parentId: AgentSessionId;
-    /**
-     * Runs one child program on the parent launch's services and scope. Pi
-     * calls the tool outside any usine fiber, so the default runtime would lose
-     * the stderr log redirect (corrupting the protocol stdout) and detach the
-     * child from the Attempt's lifetime.
-     */
-    readonly run: <A>(program: Effect.Effect<A, AgentSessionError>) => Promise<A>;
-}
-/** Builds the subagents extension; its single tool creates first-level child sessions only. */
-export declare const createSubagentsExtension: (options: SubagentsExtensionOptions) => ExtensionFactory;
-/** Names the extension so Pi startup diagnostics can identify it. */
-export declare const subagentsExtension: (options: SubagentsExtensionOptions) => InlineExtension;
-//# sourceMappingURL=subagents.d.ts.map