@relkit/runtime-hono 0.5.4 → 0.5.6

package/dist/agent-rpc-worker.js

@@ -1,5 +1,6 @@
-import { REALTIME_RUNTIME_LIMITS } from "@relkit/contracts";
-import {} from "./agent-rpc-support.js";
+import { Context, Effect, Layer, Result } from "effect";
+import { httpBoundary, observeHttp, runHttp } from "./http-effect.js";
+import { invokeHttpEngine } from "./http-invocation.js";
 import { consumeAgentControls } from "./agent-control-worker.js";
 import { AgentApprovalCoordinator, claimRun } from "./agent-approval-coordinator.js";
 import { createAgentSteeringBuffer } from "./agent-active-execution.js";
@@ -8,128 +9,130 @@ import { createAgentContentSink } from "./agent-content-sink.js";
 import { processAgentFollowUps } from "./agent-follow-up.js";
 import { agentRunOwner, appendAgentMessage, completeAgentRun, interruptAgentRun, } from "./agent-run-journal.js";
 import { trackAgentRun } from "./agent-run-tasks.js";
+import { startAgentSupervision } from "./agent-run-supervision.js";
+import { previousMessages } from "./agent-conversation.js";
+/** Starts accepted work under its generation; the submitting connection owns only observation.
+ * @param resolved - Authorized agent and durable provider scope.
+ * @param receipt - Accepted run receipt, used to coalesce duplicate starts.
+ * @param input - Validated run input.
+ * @param options - Active generation dependencies.
+ * @param resume - Whether the durable checkpoint supplies prior state.
+ * @param controlRunIds - Runs whose queued follow-ups belong to this continuation.
+ * @returns Nothing; generation tracking owns and joins the accepted task.
+ */
 export function startAgentRun(resolved, receipt, input, options, resume = false, controlRunIds = [receipt.runId]) {
-    trackAgentRun(receipt.runId, () => {
-        const task = execute(resolved, receipt, input, options, new AbortController(), resume, controlRunIds);
-        options.agentRuntime?.track?.(task);
-        return task;
-    });
+    const task = trackAgentRun(receipt.runId, () => runHttp(Effect.gen(function* () {
+        const execution = yield* AgentExecution;
+        yield* execution.execute(resolved, receipt, input, options, resume, controlRunIds);
+    }).pipe(Effect.provide(AgentExecutionLive))), options.agentRuntime ?? options, options.agentRuntime?.signal);
+    options.agentRuntime?.track?.(task);
 }
-async function execute(resolved, receipt, input, options, controller, resume, controlRunIds) {
+/** Executes and durably settles one run before admitting any follow-up.
+ * @param resolved - Authorized agent descriptor, provider and durable request scope.
+ * @param receipt - Durable accepted-run receipt identifying the thread and run.
+ * @param input - Submitted operation input; validation and authorization occur before effects are admitted.
+ * @param options - Application dependencies and configuration for this domain.
+ * @param resume - Whether execution resumes from an admitted durable checkpoint.
+ * @param controlRunIds - Run identifiers whose queued controls belong to this continuation chain.
+ * @returns Completion after durable settlement, owned task cleanup and any follow-up admission.
+ */
+const execute = Effect.fn("AgentExecution.execute")(function* (resolved, receipt, input, options, resume, controlRunIds) {
+    const controller = new AbortController();
     const runtimeSignal = options.agentRuntime?.signal;
-    const stopForGeneration = () => controller.abort(new Error("Owning generation is unavailable."));
-    if (runtimeSignal?.aborted)
-        stopForGeneration();
-    else
-        runtimeSignal?.addEventListener("abort", stopForGeneration, { once: true });
-    const claim = await claimRun(resolved.provider, resolved, receipt, options).catch(() => undefined);
-    if (claim === undefined)
-        return;
-    const active = {
-        receipt,
-        claim,
-        controlRunIds: [...controlRunIds],
-        steering: createAgentSteeringBuffer(),
-    };
-    const approvals = new AgentApprovalCoordinator(resolved, active, options);
-    const progressSink = createAgentProgressSink(resolved, active);
-    const assistantMessageId = crypto.randomUUID();
-    const assistantCreatedAt = new Date().toISOString();
-    const contentSink = createAgentContentSink(resolved, active, assistantMessageId, assistantCreatedAt);
-    let renewing = false;
-    const renewal = setInterval(() => {
-        if (renewing || controller.signal.aborted)
-            return;
-        renewing = true;
-        void resolved.provider
-            .renewRunClaim({
-            ...resolved.scope,
-            threadId: active.receipt.threadId,
-            runId: active.receipt.runId,
-            claim: active.claim,
-            expiresAt: new Date(Date.now() + 45_000).toISOString(),
-        })
-            .then((next) => {
-            active.claim = next;
-        })
-            .catch((error) => controller.abort(error))
-            .finally(() => {
-            renewing = false;
-        });
-    }, 15_000);
-    renewal.unref?.();
-    const controls = new AbortController();
-    const controlWorker = consumeAgentControls(resolved, active, options, controller, approvals, controls.signal);
-    let startNext = false;
-    try {
-        const messages = resume ? [] : await previousMessages(resolved, active.receipt.threadId);
-        if (!resume)
-            await appendAgentMessage(resolved, active.receipt, active.claim, "user", input);
-        const output = await options.engine.invoke({
-            functionId: `relkit.agent.${resolved.node.id}.invoke`,
-            input,
-            source: "http",
-            signal: controller.signal,
-            progressSink,
-            trigger: {
-                kind: "agent-run",
-                threadId: active.receipt.threadId,
-                resume,
-                approval: approvals.request,
-                progressSink,
-                contentSink,
-                messages,
-                steering: active.steering,
+    const active = yield* Effect.scoped(Effect.gen(function* () {
+        /** Aborts active work when its owning generation retires.
+         * @returns Nothing; engine cancellation performs durable settlement.
+         */
+        const stop = () => controller.abort(new Error("Owning generation is unavailable."));
+        if (runtimeSignal?.aborted)
+            stop();
+        else
+            runtimeSignal?.addEventListener("abort", stop, { once: true });
+        yield* Effect.addFinalizer(() => Effect.sync(() => runtimeSignal?.removeEventListener("abort", stop)));
+        const claimed = yield* Effect.result(httpBoundary("agent.claim", () => claimRun(resolved.provider, resolved, receipt, options)));
+        if (Result.isFailure(claimed))
+            return undefined;
+        const active = {
+            receipt,
+            claim: claimed.success,
+            controlRunIds: [...controlRunIds],
+            steering: createAgentSteeringBuffer(),
+        };
+        const approvals = new AgentApprovalCoordinator(resolved, active, options);
+        yield* Effect.addFinalizer(() => Effect.promise(() => approvals.close()));
+        const progressSink = createAgentProgressSink(resolved, active);
+        const contentSink = createAgentContentSink(resolved, active, crypto.randomUUID(), new Date().toISOString());
+        const closeSupervision = yield* httpBoundary("agent.supervision.start", () => startAgentSupervision({
+            renew: async () => {
+                if (controller.signal.aborted)
+                    return;
+                active.claim = await resolved.provider.renewRunClaim({
+                    ...resolved.scope,
+                    threadId: active.receipt.threadId,
+                    runId: active.receipt.runId,
+                    claim: active.claim,
+                    expiresAt: new Date(Date.now() + 45_000).toISOString(),
+                });
             },
-        });
-        await contentSink.ensureOutput(output, controller.signal);
-        await completeAgentRun(resolved, active.receipt, active.claim, "succeeded", { output });
-        startNext = true;
-    }
-    catch (error) {
-        try {
-            if (runtimeSignal?.aborted) {
-                await interruptAgentRun(resolved, active.receipt, active.claim, agentRunOwner(options, resolved.scope.profile), "generation-unavailable");
-            }
-            else if (!contentSink.isWaiting()) {
-                await completeAgentRun(resolved, active.receipt, active.claim, controller.signal.aborted ? "cancelled" : "failed", { error: "Agent execution failed." });
-                startNext = !controller.signal.aborted;
+            abort: (cause) => controller.abort(cause),
+            controls: (signal) => consumeAgentControls(resolved, active, options, controller, approvals, signal),
+        }));
+        yield* Effect.addFinalizer(() => Effect.promise(closeSupervision));
+        const result = yield* Effect.result(Effect.gen(function* () {
+            const messages = resume
+                ? []
+                : yield* httpBoundary("agent.history", () => previousMessages(resolved, active.receipt.threadId));
+            if (!resume)
+                yield* httpBoundary("agent.input.journal", () => appendAgentMessage(resolved, active.receipt, active.claim, "user", input));
+            const output = yield* httpBoundary("agent.invoke", () => invokeHttpEngine(options.engine, {
+                functionId: `relkit.agent.${resolved.node.id}.invoke`,
+                input,
+                source: "http",
+                signal: controller.signal,
+                progressSink,
+                trigger: {
+                    kind: "agent-run",
+                    threadId: active.receipt.threadId,
+                    resume,
+                    approval: approvals.request,
+                    progressSink,
+                    contentSink,
+                    messages,
+                    steering: active.steering,
+                },
+            }));
+            yield* httpBoundary("agent.output", () => contentSink.ensureOutput(output, controller.signal));
+            yield* httpBoundary("agent.complete", () => completeAgentRun(resolved, active.receipt, active.claim, "succeeded", { output }));
+        }));
+        let startNext = Result.isSuccess(result);
+        if (Result.isFailure(result)) {
+            const settlement = yield* Effect.result(Effect.gen(function* () {
+                if (runtimeSignal?.aborted) {
+                    yield* httpBoundary("agent.interrupt", () => interruptAgentRun(resolved, active.receipt, active.claim, agentRunOwner(options, resolved.scope.profile), "generation-unavailable"));
+                }
+                else if (!contentSink.isWaiting()) {
+                    yield* httpBoundary("agent.complete", () => completeAgentRun(resolved, active.receipt, active.claim, controller.signal.aborted ? "cancelled" : "failed", { error: "Agent execution failed." }));
+                    startNext = !controller.signal.aborted;
+                }
+            }));
+            if (Result.isFailure(settlement)) {
+                yield* httpBoundary("agent.interrupt", () => interruptAgentRun(resolved, active.receipt, active.claim, agentRunOwner(options, resolved.scope.profile))).pipe(Effect.catch(() => Effect.logWarning("Agent durable settlement requires recovery")));
+                startNext = false;
             }
         }
-        catch {
-            await interruptAgentRun(resolved, active.receipt, active.claim, agentRunOwner(options, resolved.scope.profile)).catch(() => undefined);
-            startNext = false;
-        }
-    }
-    finally {
-        runtimeSignal?.removeEventListener("abort", stopForGeneration);
-        clearInterval(renewal);
-        controls.abort();
-        await controlWorker.catch(() => undefined);
-    }
-    const next = await processAgentFollowUps(resolved, active, options, startNext).catch(() => undefined);
+        return { active, startNext };
+    }));
+    if (active === undefined)
+        return;
+    const next = yield* httpBoundary("agent.followUps", () => processAgentFollowUps(resolved, active.active, options, active.startNext)).pipe(Effect.catch(() => Effect.logWarning("Agent follow-up admission requires recovery").pipe(Effect.as(undefined))));
     if (next !== undefined)
         startAgentRun(resolved, next.receipt, next.input, options, false, next.controlRunIds);
+});
+/** Generation-owned execution with scoped controls, renewal, approvals and durable settlement. */
+export class AgentExecution extends Context.Service()("@relkit/runtime-hono/AgentExecution") {
 }
-async function previousMessages(resolved, threadId) {
-    const chat = resolved.descriptor.chat;
-    if (typeof chat?.input !== "string" || typeof chat.output !== "string")
-        return [];
-    const mapping = { input: chat.input, output: chat.output };
-    const snapshot = await resolved.provider.loadThread({
-        ...resolved.scope,
-        threadId,
-        maxEncodedBytes: REALTIME_RUNTIME_LIMITS.initialSnapshotBytes,
-    });
-    return snapshot.currentMessages.flatMap((message) => modelMessage(message, mapping));
-}
-function modelMessage(message, chat) {
-    if (message.role !== "user" && message.role !== "assistant")
-        return [];
-    const part = message.parts.find((candidate) => candidate.kind === "text" && (message.role === "user" || candidate.state !== "streaming"));
-    if (part?.kind !== "text")
-        return [];
-    const field = message.role === "user" ? chat.input : chat.output;
-    return [{ role: message.role, content: JSON.stringify({ [field]: part.text }) }];
-}
+/** Live accepted-run workflow; tests may provide the same contract for generation coordination. */
+export const AgentExecutionLive = Layer.succeed(AgentExecution, {
+    execute: (...args) => observeHttp("agent.execute", execute(...args)),
+});
 //# sourceMappingURL=agent-rpc-worker.js.map

package/dist/agent-rpc-worker.js.map

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

package/dist/agent-rpc-worker.types.d.ts

@@ -0,0 +1,4 @@
+import type { agentContext } from "./agent-rpc-support.js";
+/** Authorized agent descriptor, provider and immutable durable request scope. */
+export type ResolvedAgent = Awaited<ReturnType<typeof agentContext>>;
+//# sourceMappingURL=agent-rpc-worker.types.d.ts.map

package/dist/agent-rpc-worker.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-rpc-worker.types.d.ts","sourceRoot":"","sources":["../src/agent-rpc-worker.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAE3D,iFAAiF;AACjF,MAAM,MAAM,aAAa,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC,CAAC"}

package/dist/agent-rpc-worker.types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=agent-rpc-worker.types.js.map

package/dist/agent-rpc-worker.types.js.map

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

package/dist/agent-rpc-write.d.ts

@@ -1,6 +1,31 @@
+import { Context, Layer } from "effect";
 import type { RouteMaterializationOptions } from "./materialize-routes.js";
 import type { RpcContext } from "./rpc.js";
 import { type AgentInput } from "./agent-rpc-support.js";
+import { acceptAgentRunEffect } from "./agent-run-admission.js";
+import { acceptAgentControlEffect } from "./agent-control-admission.js";
+/** Executes acceptAgentRun at the native Promise boundary.
+ * @param input - Submitted operation input; validation and authorization occur before effects are admitted.
+ * @param context - Trusted Hono or oRPC request context containing request state and authentication.
+ * @param options - Application dependencies and configuration for this domain.
+ * @returns The durable admission receipt after generation-owned execution has been started.
+ */
 export declare function acceptAgentRun(input: AgentInput, context: RpcContext, options: RouteMaterializationOptions): Promise<import("@relkit/agents").AcceptRunReceipt>;
+/** Executes acceptAgentControl at the native Promise boundary.
+ * @param input - Submitted operation input; validation and authorization occur before effects are admitted.
+ * @param context - Trusted Hono or oRPC request context containing request state and authentication.
+ * @param options - Application dependencies and configuration for this domain.
+ * @returns The accepted control receipt for the current writable run.
+ */
 export declare function acceptAgentControl(input: AgentInput, context: RpcContext, options: RouteMaterializationOptions): Promise<import("@relkit/agents").ControlReceipt>;
+declare const AgentCommands_base: Context.ServiceClass<AgentCommands, "@relkit/runtime-hono/AgentCommands", {
+    readonly acceptAgentRun: typeof acceptAgentRunEffect;
+    readonly acceptAgentControl: typeof acceptAgentControlEffect;
+}>;
+/** Lazy agent domain workflows with typed native failures. */
+export declare class AgentCommands extends AgentCommands_base {
+}
+/** Live operations; tests can replace the same contract. */
+export declare const AgentCommandsLive: Layer.Layer<AgentCommands, never, never>;
+export {};
 //# sourceMappingURL=agent-rpc-write.d.ts.map

package/dist/agent-rpc-write.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-rpc-write.d.ts","sourceRoot":"","sources":["../src/agent-rpc-write.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAC;AAC3E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,EAKL,KAAK,UAAU,EAGhB,MAAM,wBAAwB,CAAC;AAKhC,wBAAsB,cAAc,CAClC,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,UAAU,EACnB,OAAO,EAAE,2BAA2B,sDA+CrC;AAED,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,UAAU,EACnB,OAAO,EAAE,2BAA2B,oDA+CrC"}
+{"version":3,"file":"agent-rpc-write.d.ts","sourceRoot":"","sources":["../src/agent-rpc-write.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAU,KAAK,EAAE,MAAM,QAAQ,CAAC;AAGhD,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAC;AAC3E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AACxE;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,UAAU,EACnB,OAAO,EAAE,2BAA2B,sDAQrC;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,UAAU,EACnB,OAAO,EAAE,2BAA2B,oDAQrC;;6BAM4B,OAAO,oBAAoB;iCACvB,OAAO,wBAAwB;;AALhE,8DAA8D;AAC9D,qBAAa,aAAc,SAAQ,kBAMM;CAAG;AAE5C,4DAA4D;AAC5D,eAAO,MAAM,iBAAiB,0CAI5B,CAAC"}

package/dist/agent-rpc-write.js

@@ -1,109 +1,38 @@
-import { AGENT_STATE_SCHEMA_VERSION, AGENT_STREAM_VERSION, REALTIME_RUNTIME_LIMITS, } from "@relkit/contracts";
-import { createOperationId, parseOperationId } from "@relkit/realtime";
-import { ORPCError } from "@orpc/server";
-import { assertExpectedIdentity, assertRpcSecurity } from "./rpc-identity.js";
-import { agentContext, agentLimits, digest, requireAgentThreadId, validateAgentInput, verifiedAgentRequestDigest, } from "./agent-rpc-support.js";
-import { acceptAgentResume } from "./agent-rpc-resume.js";
-import { startAgentRun } from "./agent-rpc-worker.js";
-import { assertAgentRunWritable } from "./agent-compatibility.js";
-export async function acceptAgentRun(input, context, options) {
-    await assertWrite(input, context, options);
-    const threadId = requireAgentThreadId(input.threadId);
-    if (input.resume !== undefined && input.resume !== true)
-        throw new TypeError("resume must be true when supplied.");
-    const operationId = requiredOperationId(input.operationId);
-    const resolved = await agentContext({ ...input, threadId }, context, options, input.resume === true ? "resume" : "run");
-    if (input.resume === true) {
-        return acceptAgentResume(input, threadId, operationId, resolved, options);
-    }
-    const requestDigest = verifiedAgentRequestDigest(input);
-    const value = await validateAgentInput(resolved, input.payload);
-    const now = new Date().toISOString();
-    await resolved.provider.createThread({
-        ...resolved.scope,
-        operationId,
-        threadId,
-        semanticDigest: digest({ agentId: input.agentId, threadId }),
-        now,
-        limits: agentLimits,
-    });
-    const accepted = await resolved.provider.acceptRun({
-        ...resolved.scope,
-        operationId,
-        semanticDigest: requestDigest,
-        threadId,
-        owner: {
-            generationId: options.agentRuntime.generationId,
-            publicFingerprint: options.agentRuntime.publicFingerprint,
-            protocolVersion: AGENT_STREAM_VERSION,
-            schemaVersion: AGENT_STATE_SCHEMA_VERSION,
-            providerScope: resolved.scope.profile,
-        },
-        input: value,
-        inputDigest: digest(value),
-        acceptedAt: now,
-        receiptExpiresAt: new Date(Date.now() + REALTIME_RUNTIME_LIMITS.agentReceiptMs).toISOString(),
-        limits: agentLimits,
-    });
-    startAgentRun(resolved, accepted, value, options, false);
-    return accepted;
+import { Context, Effect, Layer } from "effect";
+import { observeHttp, runHttp } from "./http-effect.js";
+import {} from "./agent-rpc-support.js";
+import { acceptAgentRunEffect } from "./agent-run-admission.js";
+import { acceptAgentControlEffect } from "./agent-control-admission.js";
+/** Executes acceptAgentRun at the native Promise boundary.
+ * @param input - Submitted operation input; validation and authorization occur before effects are admitted.
+ * @param context - Trusted Hono or oRPC request context containing request state and authentication.
+ * @param options - Application dependencies and configuration for this domain.
+ * @returns The durable admission receipt after generation-owned execution has been started.
+ */
+export function acceptAgentRun(input, context, options) {
+    return runHttp(Effect.gen(function* () {
+        const service = yield* AgentCommands;
+        return yield* service.acceptAgentRun(input, context, options);
+    }).pipe(Effect.provide(AgentCommandsLive)));
 }
-export async function acceptAgentControl(input, context, options) {
-    await assertWrite(input, context, options);
-    const threadId = requireAgentThreadId(input.threadId);
-    if (!isControlPayload(input.kind, input.payload))
-        throw new TypeError("Control request is invalid.");
-    const operationId = requiredOperationId(input.operationId);
-    const resolved = await agentContext({ ...input, threadId }, context, options, input.kind);
-    const requestDigest = verifiedAgentRequestDigest(input);
-    if (!Array.isArray(resolved.node.controls) || !resolved.node.controls.includes(input.kind))
-        throw new Error("Agent control is not declared.");
-    const snapshot = await resolved.provider.loadThread({
-        ...resolved.scope,
-        threadId,
-        maxEncodedBytes: REALTIME_RUNTIME_LIMITS.initialSnapshotBytes,
-    });
-    const runId = snapshot.activeRun?.runId ??
-        [...snapshot.currentRuns].sort((left, right) => right.acceptedAt.localeCompare(left.acceptedAt))[0]?.runId;
-    if (runId === undefined)
-        throw new Error("Agent has no active run.");
-    assertAgentRunWritable(snapshot, runId);
-    if (snapshot.thread.status === "worker-interrupted" &&
-        snapshot.activeRun?.owner.generationId !== options.agentRuntime.generationId) {
-        throw new ORPCError("GENERATION_UNAVAILABLE", {
-            message: "The run's owning generation is unavailable.",
-        });
-    }
-    const now = new Date().toISOString();
-    return resolved.provider.acceptControl({
-        ...resolved.scope,
-        operationId,
-        semanticDigest: requestDigest,
-        threadId,
-        runId,
-        kind: input.kind,
-        publicPayload: input.payload,
-        acceptedAt: now,
-        receiptExpiresAt: new Date(Date.now() + REALTIME_RUNTIME_LIMITS.agentReceiptMs).toISOString(),
-        limits: {
-            maxQueuedPerRun: REALTIME_RUNTIME_LIMITS.controlsPerRun,
-            maxQueuedPerApplication: REALTIME_RUNTIME_LIMITS.controlsPerApplication,
-        },
-    });
+/** Executes acceptAgentControl at the native Promise boundary.
+ * @param input - Submitted operation input; validation and authorization occur before effects are admitted.
+ * @param context - Trusted Hono or oRPC request context containing request state and authentication.
+ * @param options - Application dependencies and configuration for this domain.
+ * @returns The accepted control receipt for the current writable run.
+ */
+export function acceptAgentControl(input, context, options) {
+    return runHttp(Effect.gen(function* () {
+        const service = yield* AgentCommands;
+        return yield* service.acceptAgentControl(input, context, options);
+    }).pipe(Effect.provide(AgentCommandsLive)));
 }
-async function assertWrite(input, context, options) {
-    await assertExpectedIdentity(context, options.clientIdentity, input.expectedIdentity);
-    if (options.transportSecurity !== undefined)
-        await assertRpcSecurity(context, options.transportSecurity);
-}
-function requiredOperationId(value) {
-    return parseOperationId(value ?? createOperationId(), {
-        receiptWindowMs: REALTIME_RUNTIME_LIMITS.agentReceiptMs,
-    });
-}
-function isControlPayload(kind, value) {
-    if (kind === "steer" || kind === "follow-up")
-        return typeof value === "string";
-    return value !== null && typeof value === "object";
+/** Lazy agent domain workflows with typed native failures. */
+export class AgentCommands extends Context.Service()("@relkit/runtime-hono/AgentCommands") {
 }
+/** Live operations; tests can replace the same contract. */
+export const AgentCommandsLive = Layer.succeed(AgentCommands, {
+    acceptAgentRun: (...args) => observeHttp("agent.acceptAgentRun", acceptAgentRunEffect(...args)),
+    acceptAgentControl: (...args) => observeHttp("agent.acceptAgentControl", acceptAgentControlEffect(...args)),
+});
 //# sourceMappingURL=agent-rpc-write.js.map

package/dist/agent-rpc-write.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent-rpc-write.js","sourceRoot":"","sources":["../src/agent-rpc-write.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"agent-rpc-write.js","sourceRoot":"","sources":["../src/agent-rpc-write.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAIxD,OAAO,EAAmB,MAAM,wBAAwB,CAAC;AAEzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AACxE;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAC5B,KAAiB,EACjB,OAAmB,EACnB,OAAoC;IAEpC,OAAO,OAAO,CACZ,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;QAClB,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,aAAa,CAAC;QACrC,OAAO,KAAK,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAChE,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAC3C,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAChC,KAAiB,EACjB,OAAmB,EACnB,OAAoC;IAEpC,OAAO,OAAO,CACZ,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;QAClB,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,aAAa,CAAC;QACrC,OAAO,KAAK,CAAC,CAAC,OAAO,CAAC,kBAAkB,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IACpE,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAC3C,CAAC;AACJ,CAAC;AAED,8DAA8D;AAC9D,MAAM,OAAO,aAAc,SAAQ,OAAO,CAAC,OAAO,EAM/C,CAAC,oCAAoC,CAAC;CAAG;AAE5C,4DAA4D;AAC5D,MAAM,CAAC,MAAM,iBAAiB,GAAG,KAAK,CAAC,OAAO,CAAC,aAAa,EAAE;IAC5D,cAAc,EAAE,CAAC,GAAG,IAAI,EAAE,EAAE,CAAC,WAAW,CAAC,sBAAsB,EAAE,oBAAoB,CAAC,GAAG,IAAI,CAAC,CAAC;IAC/F,kBAAkB,EAAE,CAAC,GAAG,IAAI,EAAE,EAAE,CAC9B,WAAW,CAAC,0BAA0B,EAAE,wBAAwB,CAAC,GAAG,IAAI,CAAC,CAAC;CAC7E,CAAC,CAAC"}

package/dist/agent-rpc.d.ts

@@ -1,5 +1,9 @@
 import { type AnyProcedure } from "@orpc/server";
 import type { RouteMaterializationOptions } from "./materialize-routes.js";
+/** Builds the negotiated agent command and observation procedures.
+ * @param options - Application dependencies and configuration for this domain.
+ * @returns The agent command, query and observation procedures for this application.
+ */
 export declare function agentProcedures(options: RouteMaterializationOptions): Readonly<Record<string, AnyProcedure>>;
 export declare const agentErrorStatuses: {
     readonly AGENT_CAPABILITIES_UNSUPPORTED: 409;

package/dist/agent-rpc.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-rpc.d.ts","sourceRoot":"","sources":["../src/agent-rpc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAM,KAAK,YAAY,EAAiB,MAAM,cAAc,CAAC;AACpE,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAC;AAc3E,wBAAgB,eAAe,CAC7B,OAAO,EAAE,2BAA2B,GACnC,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAwCxC;AAED,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;CAgBrB,CAAC"}
+{"version":3,"file":"agent-rpc.d.ts","sourceRoot":"","sources":["../src/agent-rpc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAM,KAAK,YAAY,EAAiB,MAAM,cAAc,CAAC;AACpE,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAC;AAc3E;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,2BAA2B,GACnC,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAwCxC;AAED,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;CAgBrB,CAAC"}

package/dist/agent-rpc.js

@@ -3,6 +3,10 @@ import { listAgentThreads, loadAgent, lookupAgentReceipt, observeAgent, readAgen
 import { acceptAgentControl, acceptAgentRun } from "./agent-rpc-write.js";
 import { agentRpcCall, agentRpcStream } from "./agent-rpc-errors.js";
 import { assertAgentCapabilities } from "./agent-capability-negotiation.js";
+/** Builds the negotiated agent command and observation procedures.
+ * @param options - Application dependencies and configuration for this domain.
+ * @returns The agent command, query and observation procedures for this application.
+ */
 export function agentProcedures(options) {
     if (options.agentRuntime === undefined || options.clientIdentity === undefined)
         return {};
@@ -34,6 +38,12 @@ export const agentErrorStatuses = {
     IDEMPOTENCY_WINDOW_EXPIRED: 409,
     PROVIDER_STATE_LOST: 503,
 };
+/** Executes an agent protocol action under its negotiated capability contract.
+ * @param context - Trusted Hono or oRPC request context containing request state and authentication.
+ * @param action - Lazy protocol action executed after capability negotiation.
+ * @typeParam Value - Value type retained by this operation.
+ * @returns The action result after required protocol capabilities have been checked.
+ */
 function negotiated(context, action) {
     assertAgentCapabilities(context.hono.req.raw);
     return action();

package/dist/agent-rpc.js.map

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

package/dist/agent-run-admission.d.ts

@@ -0,0 +1,13 @@
+import { Effect } from "effect";
+import { HttpBoundaryError } from "./http-effect.js";
+import type { RouteMaterializationOptions } from "./materialize-routes.js";
+import type { RpcContext } from "./rpc.js";
+import { type AgentInput } from "./agent-rpc-support.js";
+/** Authorizes input, persists admission and starts work under the owning generation.
+ * @param input - Submitted operation input; validation and authorization occur before effects are admitted.
+ * @param context - Trusted Hono or oRPC request context containing request state and authentication.
+ * @param options - Application dependencies and configuration for this domain.
+ * @returns The durable admission receipt after generation-owned execution has been started.
+ */
+export declare const acceptAgentRunEffect: (input: AgentInput, context: RpcContext, options: RouteMaterializationOptions) => Effect.Effect<import("@relkit/agents").AcceptRunReceipt, HttpBoundaryError, never>;
+//# sourceMappingURL=agent-run-admission.d.ts.map

package/dist/agent-run-admission.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-run-admission.d.ts","sourceRoot":"","sources":["../src/agent-run-admission.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAgB,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAOnE,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAC;AAC3E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,EAKL,KAAK,UAAU,EAGhB,MAAM,wBAAwB,CAAC;AAKhC;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,sKAuE/B,CAAC"}