@usine/agents 0.3.0 → 0.5.0

package/dist/prompt.js

@@ -1,5 +1,15 @@
-/** The attribution line every GitHub comment or review written by an Agent ends with. */
-export const githubSignature = (agent) => `— usine agent: ${agent}`;
+import { githubSignature } from "@usine/core/agent";
+import { Option } from "effect";
+import { BLOCKED_MARKER, QUESTION_MARKER } from "./runtime.js";
+const completionInstructions = [
+    "# Task completion",
+    "",
+    "Run gates, tests, and CI watches in the foreground. If a tool starts background work, wait for its result and finish every dependent step before returning your final answer.",
+    "Do not end a turn promising to resume after a background notification. Your final answer returns control to the caller and may end the Attempt and remove its worktree. Push all commits that must survive before returning.",
+    "A running command or pending CI check is unfinished work, not a blocker. Keep waiting and complete the task. For a genuine blocker, record the exact blocker on the issue or pull request and report which work remains incomplete.",
+    `For an unresolved blocker, start your final answer with exactly ${BLOCKED_MARKER} on its own line, followed by the exact blocker and incomplete work. This reserved marker reports a failed Attempt. A child's report that starts with the marker fails the Attempt: return it verbatim as your own final answer. Use an ordinary final answer only after completing the task.`,
+    `When the work needs a decision that only the operator can make, post the question on the task's issue or pull request when it has one, then start your final answer with exactly ${QUESTION_MARKER} on its own line, followed by the question and the options you see. This reserved marker ends the Attempt and asks the operator; usine does not run this task again on the same Item until the operator answers or the Item changes. Return a child's report that starts with this marker verbatim as your own final answer.`,
+];
 const githubInstructions = (agent) => [
     "# GitHub identity",
     "",
@@ -9,11 +19,26 @@ const githubInstructions = (agent) => [
     "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. */
+const resumeLines = (parts) => [
+    ...Option.match(parts.resume, {
+        onNone: () => [],
+        onSome: ({ ref, commit }) => [
+            `Resumes from: ${ref} at ${commit}, the previous Attempt's unfinished work, checked out at HEAD. Its last commit is an automatic work-in-progress snapshot. Continue from this state instead of starting over.`,
+        ],
+    }),
+    ...Option.match(parts.conflictingSalvage, {
+        onNone: () => [],
+        onSome: ({ ref, commit }) => [
+            `Previous work: ${ref} at ${commit}, the previous Attempt's unfinished work, conflicts with the current revision, so the checkout starts without it. Fetch that branch to reuse parts of it.`,
+        ],
+    }),
+];
+/** Returns the parent's instructions, including GitHub attribution. */
 export const assemblePrompt = (parts) => [
     "# Run context",
     "",
     `Repository: ${parts.repository}`,
+    ...resumeLines(parts),
     "",
     "Payload snapshot:",
     "```json",
@@ -28,9 +53,11 @@ export const assemblePrompt = (parts) => [
     "",
     parts.task,
     "",
+    ...completionInstructions,
+    "",
     ...githubInstructions(parts.agent),
 ].join("\n");
-/** Builds a child's instructions from the delegated task and Agent persona, including GitHub attribution. */
+/** Returns a child's instructions, including GitHub attribution. */
 export const assembleChildPrompt = (parts) => [
     "# Agent persona",
     "",
@@ -40,6 +67,8 @@ export const assembleChildPrompt = (parts) => [
     "",
     parts.task,
     "",
+    ...completionInstructions,
+    "",
     ...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":"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"}
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../src/prompt.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAqC,MAAM,mBAAmB,CAAC;AAIvF,OAAO,EAAE,MAAM,EAAe,MAAM,QAAQ,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAuB/D,MAAM,sBAAsB,GAA0B;IACpD,mBAAmB;IACnB,EAAE;IACF,+KAA+K;IAC/K,8NAA8N;IAC9N,qOAAqO;IACrO,mEAAmE,cAAc,+RAA+R;IAChX,oLAAoL,eAAe,8TAA8T;CAClgB,CAAC;AAEF,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,MAAM,WAAW,GAAG,CAAC,KAAkB,EAAyB,EAAE,CAAC;IACjE,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE;QAC5B,MAAM,EAAE,GAAG,EAAE,CAAC,EAAE;QAChB,MAAM,EAAE,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;YAC3B,iBAAiB,GAAG,OAAO,MAAM,8KAA8K;SAChN;KACF,CAAC;IACF,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,kBAAkB,EAAE;QACxC,MAAM,EAAE,GAAG,EAAE,CAAC,EAAE;QAChB,MAAM,EAAE,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;YAC3B,kBAAkB,GAAG,OAAO,MAAM,2JAA2J;SAC9L;KACF,CAAC;CACH,CAAC;AAEF,uEAAuE;AACvE,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,KAAkB,EAAU,EAAE,CAC3D;IACE,eAAe;IACf,EAAE;IACF,eAAe,KAAK,CAAC,UAAU,EAAE;IACjC,GAAG,WAAW,CAAC,KAAK,CAAC;IACrB,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,sBAAsB;IACzB,EAAE;IACF,GAAG,kBAAkB,CAAC,KAAK,CAAC,KAAK,CAAC;CACnC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEf,oEAAoE;AACpE,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,sBAAsB;IACzB,EAAE;IACF,GAAG,kBAAkB,CAAC,KAAK,CAAC,KAAK,CAAC;CACnC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC"}

package/dist/protocol/codex.d.ts

@@ -1,12 +1,10 @@
 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.
+ * The Codex app-server wire types: the request types that usine sends, copied from
+ * `@pwrdrvr/codex-app-server-protocol@0.159.2` (codex-cli 0.159.2) because that package resolves
+ * only under bundler module resolution, and the decoders for the responses and notifications that
+ * usine reads. `protocol-conformance/check.ts` fails `pnpm check` if either drifts from the
+ * package; it compiles this module without Node types, so nothing here imports a Node module.
  */
 export interface InitializeParams {
     readonly clientInfo: {
@@ -66,5 +64,122 @@ export declare const AccountResponse: Schema.Struct<{
 export declare const AccountUpdated: Schema.Struct<{
     readonly authMode: Schema.NullOr<Schema.String>;
 }>;
+/** The model catalog page, used to validate the requested model and reasoning effort. */
+export declare const ModelListResponse: Schema.Struct<{
+    readonly data: Schema.$Array<Schema.Struct<{
+        readonly id: Schema.String;
+        readonly model: Schema.String;
+        readonly supportedReasoningEfforts: Schema.optionalKey<Schema.$Array<Schema.Struct<{
+            readonly reasoningEffort: Schema.String;
+        }>>>;
+    }>>;
+    readonly nextCursor: Schema.NullOr<Schema.String>;
+}>;
+/** The thread ID and effective model returned when a child thread starts. */
+export declare const ThreadStartResponse: Schema.Struct<{
+    readonly thread: Schema.Struct<{
+        readonly id: Schema.brand<Schema.NonEmptyString, "HarnessSessionId">;
+    }>;
+    readonly model: Schema.NonEmptyString;
+    readonly instructionSources: Schema.$Array<Schema.String>;
+}>;
+/** The turn ID, needed to steer or interrupt the turn. */
+export declare const TurnStartResponse: Schema.Struct<{
+    readonly turn: Schema.Struct<{
+        readonly id: Schema.NonEmptyString;
+    }>;
+}>;
+/** An item notification with its thread and turn IDs; `item` is kept as JSON. */
+export declare const ItemNotification: Schema.Struct<{
+    readonly item: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+    readonly threadId: Schema.String;
+    readonly turnId: Schema.String;
+}>;
+/** A user message recorded in the thread: a turn's input, or steered input once the running turn reads it. */
+export declare const UserMessageItem: Schema.Struct<{
+    readonly type: Schema.Literal<"userMessage">;
+    readonly content: Schema.$Array<Schema.Codec<Schema.Json, Schema.Json, never, never>>;
+}>;
+/** The text part of a user message. */
+export declare const UserTextInput: Schema.Struct<{
+    readonly type: Schema.Literal<"text">;
+    readonly text: Schema.String;
+}>;
+/** A completed assistant message; `phase` distinguishes a final answer from commentary. */
+export declare const AgentMessageItem: Schema.Struct<{
+    readonly type: Schema.Literal<"agentMessage">;
+    readonly id: Schema.NonEmptyString;
+    readonly text: Schema.String;
+    readonly phase: Schema.optionalKey<Schema.NullOr<Schema.String>>;
+}>;
+/** A recognized tool item, with the fields needed to match starts and results. */
+export declare const ToolItem: Schema.Struct<{
+    readonly type: Schema.Literals<readonly ["commandExecution", "fileChange", "mcpToolCall", "dynamicToolCall", "webSearch", "imageView", "imageGeneration"]>;
+    readonly id: Schema.NonEmptyString;
+    readonly status: Schema.optionalKey<Schema.String>;
+    readonly success: Schema.optionalKey<Schema.NullOr<Schema.Boolean>>;
+}>;
+/** The outcome of a turn, used to resume a conversation on Hold or report a session failure. */
+export declare const TurnCompleted: Schema.Struct<{
+    readonly turn: Schema.Struct<{
+        readonly id: Schema.String;
+        readonly status: Schema.Literals<readonly ["completed", "interrupted", "failed", "inProgress"]>;
+        readonly error: Schema.NullOr<Schema.Struct<{
+            readonly message: Schema.String;
+            readonly additionalDetails: Schema.NullOr<Schema.String>;
+        }>>;
+    }>;
+}>;
+/** A turn error from the app server; if `willRetry` is set, the model provider request is retried, for example `Reconnecting... 2/5`. */
+export declare const ErrorNotification: Schema.Struct<{
+    readonly error: Schema.Struct<{
+        readonly message: Schema.String;
+        readonly additionalDetails: Schema.optionalKey<Schema.NullOr<Schema.String>>;
+    }>;
+    readonly willRetry: Schema.Boolean;
+    readonly turnId: Schema.String;
+}>;
+/** Any notification for one turn, for example an item or a streaming delta. */
+export declare const TurnActivity: Schema.Struct<{
+    readonly turnId: Schema.String;
+}>;
+export declare const RateLimitWindow: Schema.Struct<{
+    readonly usedPercent: Schema.Number;
+    readonly windowDurationMins: Schema.optionalKey<Schema.NullOr<Schema.Number>>;
+    readonly resetsAt: Schema.optionalKey<Schema.NullOr<Schema.Number>>;
+}>;
+/** A partial account usage update; omitted windows are also absent in the normalized snapshot. */
+export declare const RateLimitsUpdated: Schema.Struct<{
+    readonly rateLimits: Schema.Struct<{
+        readonly limitId: Schema.optionalKey<Schema.NullOr<Schema.String>>;
+        readonly limitName: Schema.optionalKey<Schema.NullOr<Schema.String>>;
+        readonly primary: Schema.optionalKey<Schema.NullOr<Schema.Struct<{
+            readonly usedPercent: Schema.Number;
+            readonly windowDurationMins: Schema.optionalKey<Schema.NullOr<Schema.Number>>;
+            readonly resetsAt: Schema.optionalKey<Schema.NullOr<Schema.Number>>;
+        }>>>;
+        readonly secondary: Schema.optionalKey<Schema.NullOr<Schema.Struct<{
+            readonly usedPercent: Schema.Number;
+            readonly windowDurationMins: Schema.optionalKey<Schema.NullOr<Schema.Number>>;
+            readonly resetsAt: Schema.optionalKey<Schema.NullOr<Schema.Number>>;
+        }>>>;
+    }>;
+}>;
+/**
+ * The Codex thread token usage, cumulative across turns; `inputTokens` includes cache reads and
+ * cache writes.
+ */
+export declare const CodexTokenUsage: Schema.Struct<{
+    readonly threadId: Schema.NonEmptyString;
+    readonly tokenUsage: Schema.Struct<{
+        readonly total: Schema.Struct<{
+            readonly inputTokens: Schema.Int;
+            readonly cachedInputTokens: Schema.Int;
+            readonly cacheWriteInputTokens: Schema.Int;
+            readonly outputTokens: Schema.Int;
+        }>;
+    }>;
+}>;
+export type CodexTokenUsage = typeof CodexTokenUsage.Type;
 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,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"}
+{"version":3,"file":"codex.d.ts","sourceRoot":"","sources":["../../src/protocol/codex.ts"],"names":[],"mappings":"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"}

package/dist/protocol/codex.js

@@ -1,8 +1,116 @@
+import { HarnessSessionId } from "@usine/core/agent/session";
 import { Schema } from "effect";
-// Only authentication mode crosses this boundary; account identity is never logged.
+import { UsageCount } from "./count.js";
+// Decodes only the authentication type, so 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) });
+/** The model catalog page, used to validate the requested model and reasoning effort. */
+export const ModelListResponse = Schema.Struct({
+    data: Schema.Array(Schema.Struct({
+        id: Schema.String,
+        model: Schema.String,
+        supportedReasoningEfforts: Schema.optionalKey(Schema.Array(Schema.Struct({ reasoningEffort: Schema.String }))),
+    })),
+    nextCursor: Schema.NullOr(Schema.String),
+});
+/** The thread ID and effective model returned when a child thread starts. */
+export const ThreadStartResponse = Schema.Struct({
+    thread: Schema.Struct({ id: HarnessSessionId }),
+    model: Schema.NonEmptyString,
+    instructionSources: Schema.Array(Schema.String),
+});
+/** The turn ID, needed to steer or interrupt the turn. */
+export const TurnStartResponse = Schema.Struct({
+    turn: Schema.Struct({ id: Schema.NonEmptyString }),
+});
+/** An item notification with its thread and turn IDs; `item` is kept as JSON. */
+export const ItemNotification = Schema.Struct({
+    item: Schema.Json,
+    threadId: Schema.String,
+    turnId: Schema.String,
+});
+/** A user message recorded in the thread: a turn's input, or steered input once the running turn reads it. */
+export const UserMessageItem = Schema.Struct({
+    type: Schema.Literal("userMessage"),
+    content: Schema.Array(Schema.Json),
+});
+/** The text part of a user message. */
+export const UserTextInput = Schema.Struct({ type: Schema.Literal("text"), text: Schema.String });
+/** A completed assistant message; `phase` distinguishes a final answer from commentary. */
+export const AgentMessageItem = Schema.Struct({
+    type: Schema.Literal("agentMessage"),
+    id: Schema.NonEmptyString,
+    text: Schema.String,
+    phase: Schema.optionalKey(Schema.NullOr(Schema.String)),
+});
+/** A recognized tool item, with the fields needed to match starts and results. */
+export const ToolItem = Schema.Struct({
+    type: Schema.Literals([
+        "commandExecution",
+        "fileChange",
+        "mcpToolCall",
+        "dynamicToolCall",
+        "webSearch",
+        "imageView",
+        "imageGeneration",
+    ]),
+    id: Schema.NonEmptyString,
+    status: Schema.optionalKey(Schema.String),
+    success: Schema.optionalKey(Schema.NullOr(Schema.Boolean)),
+});
+/** The outcome of a turn, used to resume a conversation on Hold or report a session failure. */
+export const TurnCompleted = Schema.Struct({
+    turn: Schema.Struct({
+        id: Schema.String,
+        status: Schema.Literals(["completed", "interrupted", "failed", "inProgress"]),
+        error: Schema.NullOr(Schema.Struct({
+            message: Schema.String,
+            additionalDetails: Schema.NullOr(Schema.String),
+        })),
+    }),
+});
+/** A turn error from the app server; if `willRetry` is set, the model provider request is retried, for example `Reconnecting... 2/5`. */
+export const ErrorNotification = Schema.Struct({
+    error: Schema.Struct({
+        message: Schema.String,
+        additionalDetails: Schema.optionalKey(Schema.NullOr(Schema.String)),
+    }),
+    willRetry: Schema.Boolean,
+    turnId: Schema.String,
+});
+/** Any notification for one turn, for example an item or a streaming delta. */
+export const TurnActivity = Schema.Struct({ turnId: Schema.String });
+// Upstream sends partial updates where any field can be absent, so only `usedPercent` is required.
+export const RateLimitWindow = Schema.Struct({
+    usedPercent: Schema.Number,
+    windowDurationMins: Schema.optionalKey(Schema.NullOr(Schema.Number)),
+    resetsAt: Schema.optionalKey(Schema.NullOr(Schema.Number)),
+});
+/** A partial account usage update; omitted windows are also absent in the normalized snapshot. */
+export const RateLimitsUpdated = Schema.Struct({
+    rateLimits: Schema.Struct({
+        limitId: Schema.optionalKey(Schema.NullOr(Schema.String)),
+        limitName: Schema.optionalKey(Schema.NullOr(Schema.String)),
+        primary: Schema.optionalKey(Schema.NullOr(RateLimitWindow)),
+        secondary: Schema.optionalKey(Schema.NullOr(RateLimitWindow)),
+    }),
+});
+/**
+ * The Codex thread token usage, cumulative across turns; `inputTokens` includes cache reads and
+ * cache writes.
+ */
+export const CodexTokenUsage = Schema.Struct({
+    threadId: Schema.NonEmptyString,
+    tokenUsage: Schema.Struct({
+        total: Schema.Struct({
+            inputTokens: UsageCount,
+            cachedInputTokens: UsageCount,
+            cacheWriteInputTokens: UsageCount,
+            outputTokens: UsageCount,
+        }),
+    }),
+});
 //# 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":"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":"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"}

package/dist/protocol/count.d.ts

@@ -0,0 +1,4 @@
+import { Schema } from "effect";
+/** A non-negative integer in a harness's usage report, such as an input or cached token count. */
+export declare const UsageCount: Schema.Int;
+//# sourceMappingURL=count.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"count.d.ts","sourceRoot":"","sources":["../../src/protocol/count.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,kGAAkG;AAClG,eAAO,MAAM,UAAU,YAAqD,CAAC"}

package/dist/protocol/count.js

@@ -0,0 +1,4 @@
+import { Schema } from "effect";
+/** A non-negative integer in a harness's usage report, such as an input or cached token count. */
+export const UsageCount = Schema.Int.check(Schema.isGreaterThanOrEqualTo(0));
+//# sourceMappingURL=count.js.map

package/dist/protocol/count.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"count.js","sourceRoot":"","sources":["../../src/protocol/count.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,kGAAkG;AAClG,MAAM,CAAC,MAAM,UAAU,GAAG,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC,CAAC"}

package/dist/runtime.d.ts

@@ -1,23 +1,33 @@
-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 { MachineId, 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. */
+    readonly worker: Schema.brand<Schema.String, "WorkerName">;
+    /**
+     * The provider's ID of the machine that a provisioned Worker created for the Attempt, or `None`
+     * on other Workers, whose Attempts share one Claude login.
+     */
+    readonly machine: Schema.Option<Schema.brand<Schema.String, "MachineId">>;
 }>, {}>;
-/** 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 +41,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 +50,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 +59,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,73 +116,88 @@ 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>;
-    /** 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>;
+    /**
+     * 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>;
 }
-/** Launches coding sessions for tasks delegated by an Attempt's parent. */
+/** 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 the lock of the login on `worker`'s provisioned `machine`, or of the
+     * Worker's shared login if `machine` is `None`, after waiting for any other effect that has
+     * the lock.
+     */
+    readonly withLock: (worker: WorkerName, machine: Option.Option<MachineId>) => <A, E, R>(effect: Effect.Effect<A, E, R>) => Effect.Effect<A, E, R>;
+}>;
+/**
+ * A lock per Claude login for the Claude commands that can refresh it: the preflight login check
+ * and the start of a Claude child. Claude Code ends a process that finds another process
+ * refreshing the login (#453). Each machine of a provisioned Worker has its own login; on other
+ * Workers, all Attempts share one. 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. 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>;
-}>;
-/** 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