@usine/agents 0.0.0 → 0.1.0

package/dist/pi/session.js

@@ -0,0 +1,180 @@
+import { Agent } from "@usine/core";
+import { Cause, Deferred, Effect, Queue, Ref, Schema } from "effect";
+import { SessionResult } from "../runtime.js";
+export const sessionChannel = Effect.fn("SessionChannel.make")(function* (options) {
+    const events = yield* Queue.make();
+    const result = yield* Deferred.make();
+    const terminal = yield* Ref.make(false);
+    const cleanups = [];
+    const runCleanups = Effect.sync(() => {
+        for (const cleanup of cleanups.splice(0))
+            cleanup();
+    });
+    const emit = (event) => Queue.offer(events, event).pipe(Effect.flatMap((accepted) => accepted
+        ? Effect.void
+        : Effect.logWarning(`${options.label} dropped an event after the terminal transition`, {
+            event: event._tag,
+            sessionId: options.sessionId,
+        })));
+    const fail = Effect.fn("SessionChannel.fail")(function* (error) {
+        if (yield* Ref.getAndSet(terminal, true))
+            return;
+        yield* Effect.logError(`${options.label} failed`, {
+            errorTag: error._tag,
+            message: error.message,
+            sessionId: options.sessionId,
+        });
+        yield* Deferred.fail(result, error);
+        yield* Queue.fail(events, error);
+        yield* runCleanups;
+    });
+    const finish = Effect.fn("SessionChannel.finish")(function* (session, message) {
+        if (yield* Ref.getAndSet(terminal, true))
+            return;
+        yield* Queue.offer(events, new Agent.SessionFinished({ session }));
+        yield* Deferred.succeed(result, new SessionResult({ message }));
+        yield* Queue.end(events);
+        yield* runCleanups;
+        yield* Effect.logInfo(`${options.label} finished`, {
+            sessionId: options.sessionId,
+        });
+    });
+    return {
+        events,
+        result,
+        isTerminal: Ref.get(terminal),
+        onTerminal: (cleanup) => {
+            cleanups.push(cleanup);
+        },
+        emit,
+        fail,
+        finish,
+    };
+});
+const PiAssistantMessage = Schema.Struct({
+    role: Schema.Literal("assistant"),
+    content: Schema.Union([Schema.String, Schema.Array(Schema.Json)]),
+});
+const PiTextBlock = Schema.Struct({
+    type: Schema.Literal("text"),
+    text: Schema.String,
+});
+const decodeSerializedJson = Schema.decodeUnknownSync(Schema.fromJsonString(Schema.Json));
+const toolInputJson = (event) => {
+    try {
+        return decodeSerializedJson(JSON.stringify(event.args) ?? "null");
+    }
+    catch {
+        return String(event.args);
+    }
+};
+const toolOutputJson = (event) => {
+    try {
+        return decodeSerializedJson(JSON.stringify(event.result) ?? "null");
+    }
+    catch {
+        return String(event.result);
+    }
+};
+const messageText = (message) => {
+    if (!Schema.is(PiAssistantMessage)(message))
+        return undefined;
+    if (Schema.is(Schema.String)(message.content))
+        return message.content.trim() || undefined;
+    const text = message.content
+        .filter(Schema.is(PiTextBlock))
+        .map(({ text }) => text)
+        .join("")
+        .trim();
+    return text || undefined;
+};
+export const lastPiMessageText = (messages) => {
+    for (let index = messages.length - 1; index >= 0; index -= 1) {
+        const message = messages[index];
+        if (message === undefined)
+            continue;
+        const text = messageText(message);
+        if (text !== undefined)
+            return text;
+    }
+    return undefined;
+};
+const sessionEventFrom = (event, session) => {
+    if (event.type === "message_end") {
+        const text = messageText(event.message);
+        return text === undefined ? undefined : new Agent.TextOutput({ session, text });
+    }
+    if (event.type === "tool_execution_start") {
+        return new Agent.ToolStarted({
+            session,
+            callId: event.toolCallId,
+            tool: event.toolName,
+            input: toolInputJson(event),
+        });
+    }
+    if (event.type === "tool_execution_end") {
+        return new Agent.ToolFinished({
+            session,
+            callId: event.toolCallId,
+            tool: event.toolName,
+            output: toolOutputJson(event),
+            isError: event.isError,
+        });
+    }
+    return undefined;
+};
+/**
+ * Bridges the Pi SDK's synchronous subscriber onto one session channel.
+ * Normalized events reach the queue on the SDK's own tick — no async hop, so
+ * nothing can trail the prompt's resolution — while operational events with
+ * no normalized shape (retry backoffs, compactions) are logged through the
+ * launch fiber's captured services so a silent wait stays explainable.
+ */
+export const subscribePiSession = (piSession, session, channel) => Effect.gen(function* () {
+    const context = yield* Effect.context();
+    const log = Effect.runForkWith(context);
+    let lastText;
+    const unsubscribe = piSession.subscribe((event) => {
+        if (event.type === "auto_retry_start") {
+            log(Effect.logWarning("Pi session is backing off before a retry", {
+                attempt: event.attempt,
+                delayMillis: event.delayMs,
+                errorMessage: event.errorMessage,
+                maxAttempts: event.maxAttempts,
+                sessionId: session.id,
+            }));
+            return;
+        }
+        if (event.type === "auto_retry_end") {
+            log(Effect.logInfo("Pi session finished retrying", {
+                attempt: event.attempt,
+                finalError: event.finalError,
+                sessionId: session.id,
+                success: event.success,
+            }));
+            return;
+        }
+        if (event.type === "compaction_start" || event.type === "compaction_end") {
+            log(Effect.logInfo("Pi session context compaction", {
+                phase: event.type,
+                reason: event.reason,
+                sessionId: session.id,
+            }));
+            return;
+        }
+        const sessionEvent = sessionEventFrom(event, session);
+        if (sessionEvent === undefined)
+            return;
+        if (sessionEvent._tag === "TextOutput")
+            lastText = sessionEvent.text;
+        if (!Queue.offerUnsafe(channel.events, sessionEvent)) {
+            log(Effect.logWarning("Dropped a Pi session event after the terminal transition", {
+                event: sessionEvent._tag,
+                sessionId: session.id,
+            }));
+        }
+    });
+    channel.onTerminal(unsubscribe);
+    return { lastText: () => lastText, unsubscribe };
+});
+//# sourceMappingURL=session.js.map

package/dist/pi/session.js.map

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

package/dist/pi/subagents.d.ts

@@ -0,0 +1,23 @@
+import { type ExtensionFactory, type InlineExtension } from "@earendil-works/pi-coding-agent";
+import { Agent } from "@usine/core";
+import { Effect } from "effect";
+import { type AgentSessionError, type ChildBackend, type WorkingDirectory } from "../runtime.ts";
+export interface SubagentsExtensionOptions {
+    readonly agent: Agent.Agent;
+    readonly backend: ChildBackend["Service"];
+    readonly cwd: WorkingDirectory;
+    readonly emit: (event: Agent.SessionEvent) => Effect.Effect<void>;
+    readonly parentId: Agent.SessionId;
+    /**
+     * Executes one child program on the parent launch's own services and scope.
+     * Pi invokes the tool outside any usine fiber, so running through 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>;
+}
+/** Pi-owned extension factory. Its single tool can only create first-level child descriptors. */
+export declare const createSubagentsExtension: (options: SubagentsExtensionOptions) => ExtensionFactory;
+/** Named wrapper keeps the extension identifiable in Pi startup diagnostics. */
+export declare const subagentsExtension: (options: SubagentsExtensionOptions) => InlineExtension;
+//# sourceMappingURL=subagents.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"subagents.d.ts","sourceRoot":"","sources":["../../src/pi/subagents.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACrB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,MAAM,EAAiB,MAAM,QAAQ,CAAC;AAG/C,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,YAAY,EAEjB,KAAK,gBAAgB,EACtB,MAAM,eAAe,CAAC;AAEvB,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC,SAAS,CAAC,CAAC;IAC1C,QAAQ,CAAC,GAAG,EAAE,gBAAgB,CAAC;IAC/B,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,YAAY,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAClE,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IACnC;;;;;OAKG;IACH,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,iBAAiB,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;CAC/E;AAiBD,iGAAiG;AACjG,eAAO,MAAM,wBAAwB,YAAa,yBAAyB,KAAG,gBA0E7E,CAAC;AAEF,gFAAgF;AAChF,eAAO,MAAM,kBAAkB,YAAa,yBAAyB,KAAG,eAGtE,CAAC"}

package/dist/pi/subagents.js

@@ -0,0 +1,83 @@
+import { defineTool, } from "@earendil-works/pi-coding-agent";
+import { Agent } from "@usine/core";
+import { Effect, Fiber, Stream } from "effect";
+import { Type } from "typebox";
+import { assembleChildPrompt } from "../prompt.js";
+import { ChildRequest, } from "../runtime.js";
+const interrupted = (signal, sessionId) => signal === undefined
+    ? Effect.logWarning("Pi supplied no abort signal; the child outlives only its scope", {
+        sessionId,
+    }).pipe(Effect.andThen(Effect.never))
+    : Effect.callback((resume) => {
+        const onAbort = () => resume(Effect.void);
+        if (signal.aborted)
+            onAbort();
+        else
+            signal.addEventListener("abort", onAbort, { once: true });
+        return Effect.sync(() => signal.removeEventListener("abort", onAbort));
+    });
+/** Pi-owned extension factory. Its single tool can only create first-level child descriptors. */
+export const createSubagentsExtension = (options) => {
+    let childNumber = 0;
+    return (pi) => {
+        pi.registerTool(defineTool({
+            name: "subagent",
+            label: "Subagent",
+            description: "Delegate one focused task to the configured isolated child agent and wait for its report.",
+            promptSnippet: "Delegate a focused task to an isolated child agent.",
+            promptGuidelines: [
+                "Delegate only independent, focused work; the child cannot create more children.",
+            ],
+            parameters: Type.Object({ task: Type.String({ minLength: 1 }) }, { additionalProperties: false }),
+            executionMode: "parallel",
+            execute: (_toolCallId, params, signal, onUpdate) => {
+                childNumber += 1;
+                const session = new Agent.ChildSession({
+                    id: Agent.SessionId.make(`${options.parentId}:child:${childNumber}`),
+                    parentId: options.parentId,
+                    agent: options.agent.name,
+                    brain: options.agent.brain,
+                });
+                const request = new ChildRequest({
+                    session,
+                    cwd: options.cwd,
+                    prompt: assembleChildPrompt({
+                        agent: options.agent.name,
+                        persona: options.agent.persona,
+                        task: params.task,
+                    }),
+                });
+                const program = Effect.scoped(Effect.gen(function* () {
+                    yield* Effect.annotateCurrentSpan({
+                        agent: request.session.agent,
+                        parentSessionId: request.session.parentId,
+                        sessionId: request.session.id,
+                    });
+                    yield* Effect.logInfo("Delegating task to child session");
+                    const child = yield* options.backend.launch(request);
+                    const forward = yield* child.events.pipe(Stream.runForEach(options.emit), Effect.forkScoped);
+                    const result = yield* Effect.raceFirst(child.result, interrupted(signal, request.session.id).pipe(Effect.andThen(child.interrupt), Effect.andThen(Effect.interrupt)));
+                    yield* Fiber.join(forward);
+                    yield* Effect.logInfo("Child session returned to Pi parent", {
+                        sessionId: request.session.id,
+                    });
+                    onUpdate?.({
+                        content: [{ type: "text", text: result.message }],
+                        details: { childSessionId: session.id },
+                    });
+                    return {
+                        content: [{ type: "text", text: result.message }],
+                        details: { childSessionId: session.id },
+                    };
+                }));
+                return options.run(program);
+            },
+        }));
+    };
+};
+/** Named wrapper keeps the extension identifiable in Pi startup diagnostics. */
+export const subagentsExtension = (options) => ({
+    name: "usine-subagents",
+    factory: createSubagentsExtension(options),
+});
+//# sourceMappingURL=subagents.js.map

package/dist/pi/subagents.js.map

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

package/dist/prompt.d.ts

@@ -0,0 +1,22 @@
+import type { Agent, AttemptChannel, Repository } from "@usine/core";
+import type { Schema } from "effect";
+export interface PromptParts {
+    readonly repository: Repository.Name;
+    readonly payload: Schema.Json;
+    readonly agent: Agent.Name;
+    readonly persona: Agent.Persona;
+    readonly task: AttemptChannel.Task;
+}
+export interface ChildPromptParts {
+    readonly agent: Agent.Name;
+    readonly persona: Agent.Persona;
+    /** 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. */
+export declare const assemblePrompt: (parts: PromptParts) => string;
+/** Builds the isolated prompt given to a first-level child session. */
+export declare const assembleChildPrompt: (parts: ChildPromptParts) => string;
+//# sourceMappingURL=prompt.d.ts.map

package/dist/prompt.d.ts.map

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

package/dist/prompt.js

@@ -0,0 +1,42 @@
+/** Human-visible attribution required on GitHub content authored by an Agent. */
+export const githubSignature = (agent) => `— usine agent: ${agent}`;
+/** Builds the complete parent prompt from immutable run context. */
+export const assemblePrompt = (parts) => [
+    "# Run context",
+    "",
+    `Repository: ${parts.repository}`,
+    "",
+    "Payload snapshot:",
+    "```json",
+    JSON.stringify(parts.payload, undefined, 2),
+    "```",
+    "",
+    "# Agent persona",
+    "",
+    parts.persona,
+    "",
+    "# Task",
+    "",
+    parts.task,
+    "",
+    "# GitHub identity",
+    "",
+    "Append this signature to every GitHub comment, issue, or pull request you publish:",
+    githubSignature(parts.agent),
+].join("\n");
+/** Builds the isolated prompt given to a first-level child session. */
+export const assembleChildPrompt = (parts) => [
+    "# Agent persona",
+    "",
+    parts.persona,
+    "",
+    "# Delegated task",
+    "",
+    parts.task,
+    "",
+    "# GitHub identity",
+    "",
+    "Append this signature to every GitHub comment, issue, or pull request you publish:",
+    githubSignature(parts.agent),
+].join("\n");
+//# sourceMappingURL=prompt.js.map

package/dist/prompt.js.map

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

package/dist/protocol/codex.d.ts

@@ -0,0 +1,56 @@
+/**
+ * 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.
+ */
+export interface InitializeParams {
+    readonly clientInfo: {
+        readonly name: string;
+        readonly title: string | null;
+        readonly version: string;
+    };
+    readonly capabilities: null;
+}
+export interface ModelListParams {
+    readonly cursor?: string | null;
+    readonly limit?: number | null;
+    readonly includeHidden?: boolean | null;
+}
+export interface ThreadStartParams {
+    readonly model?: string | null;
+    readonly allowProviderModelFallback?: boolean;
+    readonly cwd?: string | null;
+    readonly approvalPolicy?: "never" | "on-request" | "untrusted" | null;
+    readonly sandbox?: "read-only" | "workspace-write" | "danger-full-access" | null;
+    readonly serviceName?: string | null;
+    readonly ephemeral?: boolean | null;
+}
+interface TextInput {
+    readonly type: "text";
+    readonly text: string;
+    readonly text_elements: ReadonlyArray<never>;
+}
+export interface TurnStartParams {
+    readonly threadId: string;
+    readonly input: ReadonlyArray<TextInput>;
+    readonly cwd?: string | null;
+    readonly approvalPolicy?: "never" | "on-request" | "untrusted" | null;
+    readonly sandboxPolicy?: {
+        readonly type: "dangerFullAccess";
+    } | null;
+    readonly effort?: string | null;
+}
+export interface TurnSteerParams {
+    readonly threadId: string;
+    readonly expectedTurnId: string;
+    readonly input: ReadonlyArray<TextInput>;
+}
+export interface TurnInterruptParams {
+    readonly threadId: string;
+    readonly turnId: string;
+}
+export {};
+//# sourceMappingURL=codex.d.ts.map

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

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

package/dist/protocol/codex.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=codex.js.map

package/dist/protocol/codex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex.js","sourceRoot":"","sources":["../../src/protocol/codex.ts"],"names":[],"mappings":""}

package/dist/runtime.d.ts

@@ -0,0 +1,114 @@
+import { Agent, AttemptChannel, AttemptFailure } from "@usine/core";
+import { Context, Effect, Schema, Scope, Stream } from "effect";
+/** Value object: process-local working directory for one isolated 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">;
+}>, {}>;
+/** Complete input required to start the Pi parent inside one Attempt checkout. */
+export declare class LaunchRequest extends LaunchRequest_base {
+}
+declare const ChildRequest_base: Schema.Class<ChildRequest, Schema.Struct<{
+    readonly session: typeof Agent.ChildSession;
+    readonly cwd: Schema.brand<Schema.NonEmptyString, "AgentWorkingDirectory">;
+    readonly prompt: Schema.NonEmptyString;
+}>, {}>;
+/** Complete input for exactly one first-level child session. */
+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. */
+export declare class SessionResult extends SessionResult_base {
+}
+declare const UnknownModelError_base: Schema.Class<UnknownModelError, Schema.TaggedStruct<"UnknownModelError", {
+    readonly harness: Schema.Literals<readonly ["claude", "codex", "pi"]>;
+    readonly model: Schema.brand<Schema.String, "ModelId">;
+    readonly message: Schema.NonEmptyString;
+}>, import("effect/Cause").YieldableError>;
+/** The configured vendor model id is well-formed but absent from the selected SDK registry. */
+export declare class UnknownModelError extends UnknownModelError_base {
+}
+declare const PoolUnavailableError_base: Schema.Class<PoolUnavailableError, Schema.TaggedStruct<"PoolUnavailableError", {
+    readonly harness: Schema.Literals<readonly ["claude", "codex", "pi"]>;
+    readonly model: Schema.brand<Schema.String, "ModelId">;
+    readonly pool: Schema.Literals<readonly ["apiKeys", "claudePlan", "chatgptPlan"]>;
+    readonly message: Schema.NonEmptyString;
+}>, import("effect/Cause").YieldableError>;
+/** The selected credential cannot draw from the billing pool required by this session. */
+export declare class PoolUnavailableError extends PoolUnavailableError_base {
+}
+declare const UnsupportedEffortError_base: Schema.Class<UnsupportedEffortError, Schema.TaggedStruct<"UnsupportedEffortError", {
+    readonly harness: Schema.Literals<readonly ["claude", "codex", "pi"]>;
+    readonly model: Schema.brand<Schema.String, "ModelId">;
+    readonly effort: Schema.Literals<readonly ["off", "minimal", "low", "medium", "high", "xhigh", "max"]>;
+    readonly message: Schema.NonEmptyString;
+}>, import("effect/Cause").YieldableError>;
+/** The selected 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. */
+export declare class AgentResultError extends AgentResultError_base {
+}
+export declare const SESSION_OPERATIONS: readonly ["launch", "stream", "steer", "interrupt"];
+export declare const SessionOperation: Schema.Literals<readonly ["launch", "stream", "steer", "interrupt"]>;
+export type SessionOperation = typeof SessionOperation.Type;
+declare const SessionOperationError_base: Schema.Class<SessionOperationError, Schema.TaggedStruct<"SessionOperationError", {
+    readonly operation: Schema.Literals<readonly ["launch", "stream", "steer", "interrupt"]>;
+    readonly sessionId: Schema.OptionFromNullOr<Schema.brand<Schema.NonEmptyString, "AgentSessionId">>;
+    readonly message: Schema.NonEmptyString;
+    readonly cause: Schema.Defect;
+}>, import("effect/Cause").YieldableError>;
+/** SDK/process failure after model and harness validation. */
+export declare class SessionOperationError extends SessionOperationError_base {
+}
+export declare const AgentSessionError: Schema.Union<readonly [typeof UnknownModelError, typeof PoolUnavailableError, typeof UnsupportedEffortError, typeof AgentResultError, 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.
+ */
+export declare const toAttemptFailure: (error: AgentSessionError) => AttemptFailure.AttemptFailure;
+/** Live SDK session. Its event stream and controls are backend-independent. */
+export interface RunningSession {
+    readonly session: Agent.Session;
+    readonly events: Stream.Stream<Agent.SessionEvent, AgentSessionError>;
+    readonly result: Effect.Effect<SessionResult, AgentSessionError>;
+    readonly steer: (message: string) => Effect.Effect<void, AgentSessionError>;
+    readonly interrupt: Effect.Effect<void, AgentSessionError>;
+}
+export interface ChildBackendService {
+    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. */
+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. */
+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. */
+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. */
+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>;
+}>;
+/** Stable parent seam consumed by the run host. */
+export declare class AgentRuntime extends AgentRuntime_base {
+}
+export {};
+//# sourceMappingURL=runtime.d.ts.map

package/dist/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACpE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAS,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEvE,8EAA8E;AAC9E,eAAO,MAAM,gBAAgB,8DAAoE,CAAC;AAClG,MAAM,MAAM,gBAAgB,GAAG,OAAO,gBAAgB,CAAC,IAAI,CAAC;;;;;AAE5D,kFAAkF;AAClF,qBAAa,aAAc,SAAQ,kBAGjC;CAAG;;;;;;AAEL,gEAAgE;AAChE,qBAAa,YAAa,SAAQ,iBAIhC;CAAG;;;;AAEL,mEAAmE;AACnE,qBAAa,aAAc,SAAQ,kBAEjC;CAAG;;;;;;AAEL,+FAA+F;AAC/F,qBAAa,iBAAkB,SAAQ,sBAMrC;CAAG;;;;;;;AAEL,0FAA0F;AAC1F,qBAAa,oBAAqB,SAAQ,yBAOxC;CAAG;;;;;;;AAEL,oFAAoF;AACpF,qBAAa,sBAAuB,SAAQ,2BAO1C;CAAG;;;;;AAEL,oFAAoF;AACpF,qBAAa,gBAAiB,SAAQ,qBAKpC;CAAG;AAEL,eAAO,MAAM,kBAAkB,YAAI,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,CAAU,CAAC;AACtF,eAAO,MAAM,gBAAgB,sEAAsC,CAAC;AACpE,MAAM,MAAM,gBAAgB,GAAG,OAAO,gBAAgB,CAAC,IAAI,CAAC;;;;;;;AAE5D,8DAA8D;AAC9D,qBAAa,qBAAsB,SAAQ,0BAOzC;CAAG;AAEL,eAAO,MAAM,iBAAiB,sKAM5B,CAAC;AACH,MAAM,MAAM,iBAAiB,GAAG,OAAO,iBAAiB,CAAC,IAAI,CAAC;AAE9D;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,UAAW,iBAAiB,KAAG,cAAc,CAAC,cAQvE,CAAC;AAEL,+EAA+E;AAC/E,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,EAAE,iBAAiB,CAAC,CAAC;IACtE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,aAAa,EAAE,iBAAiB,CAAC,CAAC;IACjE,QAAQ,CAAC,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,iBAAiB,CAAC,CAAC;IAC5E,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,iBAAiB,CAAC,CAAC;CAC5D;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,MAAM,EAAE,CACf,OAAO,EAAE,YAAY,KAClB,MAAM,CAAC,MAAM,CAAC,cAAc,EAAE,iBAAiB,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;CACpE;;AAED,gFAAgF;AAChF,qBAAa,YAAa,SAAQ,iBAEjC;CAAG;;AAEJ,+EAA+E;AAC/E,qBAAa,kBAAmB,SAAQ,uBAEvC;CAAG;;AAEJ,8EAA8E;AAC9E,qBAAa,iBAAkB,SAAQ,sBAEtC;CAAG;;AAEJ,2EAA2E;AAC3E,qBAAa,cAAe,SAAQ,mBAEnC;CAAG;;qBAMiB,CACf,OAAO,EAAE,aAAa,KACnB,MAAM,CAAC,MAAM,CAAC,cAAc,EAAE,iBAAiB,EAAE,KAAK,CAAC,KAAK,CAAC;;AANtE,mDAAmD;AACnD,qBAAa,YAAa,SAAQ,iBAOD;CAAG"}