@relkit/runtime-hono 0.5.4 → 0.5.5

package/dist/agent-follow-up.js

@@ -1,22 +1,31 @@
+import { Context, Effect, Layer, Result } from "effect";
+import { httpBoundary, observeHttp, runHttp } from "./http-effect.js";
 import { REALTIME_RUNTIME_LIMITS } from "@relkit/contracts";
 import { agentLimits, agentOwner, digest, validateAgentInput } from "./agent-rpc-support.js";
-export async function processAgentFollowUps(resolved, active, options, startNext) {
-    const snapshot = await resolved.provider.loadThread({
+/** Settles queued follow-ups and admits at most one next run in order.
+ * @param resolved - Authorized agent descriptor, provider and durable request scope.
+ * @param active - Mutable state owned by the accepted run and its continuation chain.
+ * @param options - Application dependencies and configuration for this domain.
+ * @param startNext - Whether successful settlement permits admitting a queued follow-up.
+ * @returns The next admitted run, or undefined when no queued continuation can start.
+ */
+const processAgentFollowUpsEffect = Effect.fn("AgentFollowUps.processAgentFollowUps")(function* (resolved, active, options, startNext) {
+    const snapshot = yield* httpBoundary("agent.followUp.processAgentFollowUps", () => resolved.provider.loadThread({
         ...resolved.scope,
         threadId: active.receipt.threadId,
         maxEncodedBytes: REALTIME_RUNTIME_LIMITS.initialSnapshotBytes,
-    });
+    }));
     const queued = snapshot.controls
         .filter((record) => record.kind === "follow-up" &&
         record.status === "accepted" &&
         active.controlRunIds.includes(record.runId))
         .sort((left, right) => left.acceptedAt.localeCompare(right.acceptedAt));
     if (!startNext) {
-        await Promise.all(queued.map((record) => cancel(resolved, active.receipt.threadId, options.agentRuntime.generationId, record)));
+        yield* Effect.forEach(queued, (record) => cancelEffect(resolved, active.receipt.threadId, options.agentRuntime.generationId, record), { concurrency: 8, discard: true });
         return undefined;
     }
     for (const record of queued) {
-        const claim = await resolved.provider.claimControl({
+        const claim = yield* httpBoundary("agent.followUp.processAgentFollowUps", () => resolved.provider.claimControl({
             ...resolved.scope,
             threadId: active.receipt.threadId,
             runId: record.runId,
@@ -24,13 +33,10 @@ export async function processAgentFollowUps(resolved, active, options, startNext
             workerId: crypto.randomUUID(),
             generationId: options.agentRuntime.generationId,
             expiresAt: new Date(Date.now() + REALTIME_RUNTIME_LIMITS.leaseExpiryMs).toISOString(),
-        });
-        let input;
-        try {
-            input = await validateAgentInput(resolved, record.publicPayload);
-        }
-        catch {
-            await resolved.provider.settleControl({
+        }));
+        const validation = yield* Effect.result(httpBoundary("agent.followUp.validate", () => validateAgentInput(resolved, record.publicPayload)));
+        if (Result.isFailure(validation)) {
+            yield* httpBoundary("agent.followUp.processAgentFollowUps", () => resolved.provider.settleControl({
                 ...resolved.scope,
                 threadId: active.receipt.threadId,
                 runId: record.runId,
@@ -39,19 +45,20 @@ export async function processAgentFollowUps(resolved, active, options, startNext
                 status: "rejected",
                 effect: "not-started",
                 settledAt: new Date().toISOString(),
-            });
+            }));
             continue;
         }
-        await resolved.provider.markControlEffectStarted({
+        const input = validation.success;
+        yield* httpBoundary("agent.followUp.processAgentFollowUps", () => resolved.provider.markControlEffectStarted({
             ...resolved.scope,
             threadId: active.receipt.threadId,
             runId: record.runId,
             operationId: record.controlId,
             claim,
             downstreamOperationId: record.controlId,
-        });
+        }));
         const now = new Date().toISOString();
-        const receipt = await resolved.provider.acceptRun({
+        const receipt = yield* httpBoundary("agent.followUp.processAgentFollowUps", () => resolved.provider.acceptRun({
             ...resolved.scope,
             operationId: record.controlId,
             semanticDigest: digest(record.publicPayload),
@@ -62,8 +69,8 @@ export async function processAgentFollowUps(resolved, active, options, startNext
             acceptedAt: now,
             receiptExpiresAt: new Date(Date.now() + REALTIME_RUNTIME_LIMITS.agentReceiptMs).toISOString(),
             limits: agentLimits,
-        });
-        await resolved.provider.settleControl({
+        }));
+        yield* httpBoundary("agent.followUp.processAgentFollowUps", () => resolved.provider.settleControl({
             ...resolved.scope,
             threadId: active.receipt.threadId,
             runId: record.runId,
@@ -73,7 +80,7 @@ export async function processAgentFollowUps(resolved, active, options, startNext
             effect: "confirmed",
             downstreamOperationId: record.controlId,
             settledAt: now,
-        });
+        }));
         return {
             receipt,
             input,
@@ -81,9 +88,16 @@ export async function processAgentFollowUps(resolved, active, options, startNext
         };
     }
     return undefined;
-}
-async function cancel(resolved, threadId, generationId, record) {
-    const claim = await resolved.provider.claimControl({
+});
+/** Cancels queued follow-ups after their owning run cannot continue.
+ * @param resolved - Authorized agent descriptor, provider and durable request scope.
+ * @param threadId - Stable thread identifier within the authorized agent scope.
+ * @param generationId - generation id supplied by the caller.
+ * @param record - Durable record projected or settled by this operation.
+ * @returns Completion after every queued follow-up is cancelled with bounded concurrency.
+ */
+const cancelEffect = Effect.fn("AgentFollowUps.cancel")(function* (resolved, threadId, generationId, record) {
+    const claim = yield* httpBoundary("agent.followUp.cancel", () => resolved.provider.claimControl({
         ...resolved.scope,
         threadId,
         runId: record.runId,
@@ -91,8 +105,8 @@ async function cancel(resolved, threadId, generationId, record) {
         workerId: crypto.randomUUID(),
         generationId,
         expiresAt: new Date(Date.now() + REALTIME_RUNTIME_LIMITS.leaseExpiryMs).toISOString(),
-    });
-    await resolved.provider.settleControl({
+    }));
+    yield* httpBoundary("agent.followUp.cancel", () => resolved.provider.settleControl({
         ...resolved.scope,
         threadId,
         runId: record.runId,
@@ -101,6 +115,26 @@ async function cancel(resolved, threadId, generationId, record) {
         status: "cancelled",
         effect: "not-started",
         settledAt: new Date().toISOString(),
-    });
+    }));
+});
+/** Sequential continuation admission; cancellation uses a bounded traversal. */
+export class AgentFollowUps extends Context.Service()("@relkit/runtime-hono/AgentFollowUps") {
+}
+/** Live durable follow-up workflow. */
+export const AgentFollowUpsLive = Layer.succeed(AgentFollowUps, {
+    process: (...args) => observeHttp("agent.followUp.process", processAgentFollowUpsEffect(...args)),
+});
+/** Settles queued controls and admits at most one next run.
+ * @param resolved - Authorized agent descriptor, provider and durable request scope.
+ * @param active - Mutable state owned by the accepted run and its continuation chain.
+ * @param options - Application dependencies and configuration for this domain.
+ * @param startNext - Whether successful settlement permits admitting a queued follow-up.
+ * @returns The next admitted run, or undefined when no continuation may start.
+ */
+export function processAgentFollowUps(resolved, active, options, startNext) {
+    return runHttp(Effect.gen(function* () {
+        const service = yield* AgentFollowUps;
+        return yield* service.process(resolved, active, options, startNext);
+    }).pipe(Effect.provide(AgentFollowUpsLive)));
 }
 //# sourceMappingURL=agent-follow-up.js.map

package/dist/agent-follow-up.js.map

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

package/dist/agent-follow-up.types.d.ts

@@ -0,0 +1,10 @@
+import type { agentContext } from "./agent-rpc-support.js";
+/** Authorized agent descriptor, provider and immutable durable request scope. */
+export type ResolvedAgent = Awaited<ReturnType<typeof agentContext>>;
+/** Contract for next agent run used by agent follow up. */
+export interface NextAgentRun {
+    readonly receipt: Awaited<ReturnType<ResolvedAgent["provider"]["acceptRun"]>>;
+    readonly input: unknown;
+    readonly controlRunIds: readonly string[];
+}
+//# sourceMappingURL=agent-follow-up.types.d.ts.map

package/dist/agent-follow-up.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-follow-up.types.d.ts","sourceRoot":"","sources":["../src/agent-follow-up.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;AAErE,2DAA2D;AAC3D,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,UAAU,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IAC9E,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;CAC3C"}

package/dist/agent-follow-up.types.js

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

package/dist/agent-follow-up.types.js.map

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

package/dist/agent-inspector-projection.d.ts

@@ -1,7 +1,30 @@
 import type { JournalRecord, ThreadSnapshot } from "@relkit/agents";
+/** Project run identity, status and compatibility into inspector rows.
+ * @param snapshot - Current thread snapshot.
+ * @returns Run rows with optional completion timestamps.
+ */
 export declare function inspectorRuns(snapshot: ThreadSnapshot): readonly Record<string, unknown>[];
+/** Project nested agent execution state into inspector rows.
+ * @param snapshot - Current thread snapshot.
+ * @returns Execution scope, parent, node and latest sequence rows.
+ */
 export declare function inspectorExecutions(snapshot: ThreadSnapshot): readonly Record<string, unknown>[];
+/** Fold task journal events into numbered attempts for the selected runs.
+ * @param records - Ordered journal records.
+ * @param runs - Run IDs included in this projection.
+ * @returns One row per attempt, updated with its latest task status.
+ */
 export declare function inspectorAttempts(records: readonly JournalRecord[], runs: ReadonlySet<string>): readonly Record<string, unknown>[];
+/** Project lifecycle journal events into inspector transition rows.
+ * @param records - Ordered journal records.
+ * @param runs - Run IDs included in this projection.
+ * @returns Selected transitions with available source and destination nodes.
+ */
 export declare function inspectorTransitions(records: readonly JournalRecord[], runs: ReadonlySet<string>): readonly Record<string, unknown>[];
+/** Select all historical runs or the active set for a live inspector view.
+ * @param snapshot - Current thread snapshot.
+ * @param mode - Live or historical inspector view.
+ * @returns Run IDs, falling back to the last stored run when none are active.
+ */
 export declare function inspectedRunIds(snapshot: ThreadSnapshot, mode: "live" | "history"): Set<string>;
 //# sourceMappingURL=agent-inspector-projection.d.ts.map

package/dist/agent-inspector-projection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-inspector-projection.d.ts","sourceRoot":"","sources":["../src/agent-inspector-projection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAuB,aAAa,EAAa,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAGpG,wBAAgB,aAAa,CAAC,QAAQ,EAAE,cAAc,GAAG,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAQ1F;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,cAAc,GAAG,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAShG;AAED,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,SAAS,aAAa,EAAE,EACjC,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,GACxB,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAgDpC;AAED,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,SAAS,aAAa,EAAE,EACjC,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,GACxB,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAkBpC;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,GAAG,CAAC,MAAM,CAAC,CAI/F"}
+{"version":3,"file":"agent-inspector-projection.d.ts","sourceRoot":"","sources":["../src/agent-inspector-projection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAuB,aAAa,EAAa,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAGpG;;;GAGG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,cAAc,GAAG,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAQ1F;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,cAAc,GAAG,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAShG;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,SAAS,aAAa,EAAE,EACjC,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,GACxB,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAgDpC;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,SAAS,aAAa,EAAE,EACjC,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,GACxB,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAkBpC;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,GAAG,CAAC,MAAM,CAAC,CAI/F"}

package/dist/agent-inspector-projection.js

@@ -1,4 +1,8 @@
 import { agentRunCompatibility } from "./agent-compatibility.js";
+/** Project run identity, status and compatibility into inspector rows.
+ * @param snapshot - Current thread snapshot.
+ * @returns Run rows with optional completion timestamps.
+ */
 export function inspectorRuns(snapshot) {
     return snapshot.currentRuns.map((run) => ({
         runId: run.runId,
@@ -8,6 +12,10 @@ export function inspectorRuns(snapshot) {
         compatibility: agentRunCompatibility(run, snapshot.waiting?.runId),
     }));
 }
+/** Project nested agent execution state into inspector rows.
+ * @param snapshot - Current thread snapshot.
+ * @returns Execution scope, parent, node and latest sequence rows.
+ */
 export function inspectorExecutions(snapshot) {
     return snapshot.executions.map((execution) => ({
         scope: execution.scope,
@@ -18,6 +26,11 @@ export function inspectorExecutions(snapshot) {
         lastEventSequence: execution.lastEventSequence,
     }));
 }
+/** Fold task journal events into numbered attempts for the selected runs.
+ * @param records - Ordered journal records.
+ * @param runs - Run IDs included in this projection.
+ * @returns One row per attempt, updated with its latest task status.
+ */
 export function inspectorAttempts(records, runs) {
     const counters = new Map();
     const attempts = new Map();
@@ -69,6 +82,11 @@ export function inspectorAttempts(records, runs) {
     }
     return [...attempts.values()];
 }
+/** Project lifecycle journal events into inspector transition rows.
+ * @param records - Ordered journal records.
+ * @param runs - Run IDs included in this projection.
+ * @returns Selected transitions with available source and destination nodes.
+ */
 export function inspectorTransitions(records, runs) {
     return records.flatMap((record) => {
         if (record.kind !== "event" || !runs.has(record.runId))
@@ -90,12 +108,21 @@ export function inspectorTransitions(records, runs) {
         ];
     });
 }
+/** Select all historical runs or the active set for a live inspector view.
+ * @param snapshot - Current thread snapshot.
+ * @param mode - Live or historical inspector view.
+ * @returns Run IDs, falling back to the last stored run when none are active.
+ */
 export function inspectedRunIds(snapshot, mode) {
     if (mode === "history")
         return new Set(snapshot.currentRuns.map((run) => run.runId));
     const live = snapshot.currentRuns.filter((run) => !terminal(run)).map((run) => run.runId);
     return new Set(live.length > 0 ? live : snapshot.currentRuns.slice(-1).map((run) => run.runId));
 }
+/** Recognize execution journal events before reading their scoped metadata.
+ * @param value - Value to validate or project.
+ * @returns The execution event when its required fields are present.
+ */
 function executionEvent(value) {
     if (!isRecord(value) || !Array.isArray(value.scope) || typeof value.kind !== "string")
         return;
@@ -103,6 +130,10 @@ function executionEvent(value) {
         return;
     return value;
 }
+/** Read optional task identifiers and a required status from journal data.
+ * @param value - Value to validate or project.
+ * @returns Task metadata, or undefined for unsupported values.
+ */
 function taskValue(value) {
     if (!isRecord(value) || typeof value.status !== "string")
         return;
@@ -112,9 +143,17 @@ function taskValue(value) {
         status: value.status,
     };
 }
+/** Recognize settled run statuses that no longer produce live execution.
+ * @param run - Persisted run being inspected.
+ * @returns Whether the run succeeded, failed, cancelled or lost its worker.
+ */
 function terminal(run) {
     return ["succeeded", "failed", "cancelled", "worker-interrupted"].includes(run.status);
 }
+/** Check whether a value is a non-null object suitable for field inspection.
+ * @param value - Value to validate or project.
+ * @returns Whether object fields can be inspected.
+ */
 function isRecord(value) {
     return value !== null && typeof value === "object" && !Array.isArray(value);
 }

package/dist/agent-inspector-projection.js.map

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

package/dist/agent-inspector.d.ts

@@ -1,5 +1,11 @@
 import type { Hono } from "hono";
 import type { InternalEndpointOptions } from "./internal-endpoints.js";
 import type { RouteMaterializationOptions } from "./materialize-routes.js";
+/** Registers internal agent inspection endpoints under the configured access policy.
+ * @param app - Hono application receiving the configured endpoints or middleware.
+ * @param options - Application dependencies and configuration for this domain.
+ * @param internal - internal supplied by the caller.
+ * @returns Nothing; the requested update is applied to the owned state.
+ */
 export declare function installAgentInspectorEndpoints(app: Hono, options: RouteMaterializationOptions, internal: InternalEndpointOptions): void;
 //# sourceMappingURL=agent-inspector.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"agent-inspector.d.ts","sourceRoot":"","sources":["../src/agent-inspector.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAW,IAAI,EAAE,MAAM,MAAM,CAAC;AAE1C,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAEvE,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAC;AAS3E,wBAAgB,8BAA8B,CAC5C,GAAG,EAAE,IAAI,EACT,OAAO,EAAE,2BAA2B,EACpC,QAAQ,EAAE,uBAAuB,GAChC,IAAI,CA0BN"}
+{"version":3,"file":"agent-inspector.d.ts","sourceRoot":"","sources":["../src/agent-inspector.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAW,IAAI,EAAE,MAAM,MAAM,CAAC;AAE1C,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAEvE,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAC;AAS3E;;;;;GAKG;AACH,wBAAgB,8BAA8B,CAC5C,GAAG,EAAE,IAAI,EACT,OAAO,EAAE,2BAA2B,EACpC,QAAQ,EAAE,uBAAuB,GAChC,IAAI,CA0BN"}

package/dist/agent-inspector.js

@@ -3,6 +3,12 @@ import { API_BASE_PATH, REALTIME_RUNTIME_LIMITS } from "@relkit/contracts";
 import { agentContext, requireAgentThreadId } from "./agent-rpc-support.js";
 import { isAuthorized, jsonResponse } from "./internal-endpoints-utils.js";
 import { inspectedRunIds, inspectorAttempts, inspectorExecutions, inspectorRuns, inspectorTransitions, } from "./agent-inspector-projection.js";
+/** Registers internal agent inspection endpoints under the configured access policy.
+ * @param app - Hono application receiving the configured endpoints or middleware.
+ * @param options - Application dependencies and configuration for this domain.
+ * @param internal - internal supplied by the caller.
+ * @returns Nothing; the requested update is applied to the owned state.
+ */
 export function installAgentInspectorEndpoints(app, options, internal) {
     const mode = internal.environment ?? internal.mode ?? "development";
     if (!(internal.enabled ?? mode !== "production"))
@@ -37,6 +43,11 @@ export function installAgentInspectorEndpoints(app, options, internal) {
         }
     });
 }
+/** Builds the authorized structural execution inspection response.
+ * @param context - Trusted Hono or oRPC request context containing request state and authentication.
+ * @param options - Application dependencies and configuration for this domain.
+ * @returns The authorized structural execution response with private content omitted.
+ */
 async function executionResponse(context, options) {
     const threadId = requireAgentThreadId(context.req.query("threadId"));
     const mode = executionMode(context.req.query("mode"));
@@ -63,6 +74,12 @@ async function executionResponse(context, options) {
         transitions: inspectorTransitions(history.records, runIds),
     });
 }
+/** Reads bounded historical agent state without exposing private payloads.
+ * @param provider - Foreign provider whose native API owns durable state.
+ * @param scope - Authorized provider scope or lifetime scope owning the operation.
+ * @param checkpoint - Resumable observation checkpoint bound to the resource scope.
+ * @returns The bounded historical structural records available to the inspector.
+ */
 async function structuralHistory(provider, scope, checkpoint) {
     let after = { ...checkpoint, sequence: "0" };
     const records = [];
@@ -83,6 +100,10 @@ async function structuralHistory(provider, scope, checkpoint) {
     }
     return { records, truncated: true };
 }
+/** Parses the supported agent execution inspection mode.
+ * @param value - Value inspected, validated or projected by this operation.
+ * @returns The recognized inspection mode, or undefined for an unsupported query.
+ */
 function executionMode(value) {
     if (value === undefined || value === "live")
         return "live";
@@ -90,6 +111,10 @@ function executionMode(value) {
         return value;
     throw new TypeError("mode is invalid");
 }
+/** Projects a protocol error into an internal inspection HTTP status.
+ * @param error - Failure metadata recorded or projected at this boundary.
+ * @returns The HTTP status associated with the public RPC error code.
+ */
 function rpcStatus(error) {
     if (error.code === "UNAUTHORIZED")
         return 401;
@@ -99,6 +124,9 @@ function rpcStatus(error) {
         return 409;
     return 403;
 }
+/** Creates the safe internal-inspection authorization failure response.
+ * @returns A JSON authorization failure that omits private provider details.
+ */
 function unauthorized() {
     return jsonResponse({ error: "RELKIT_INSPECTOR_UNAUTHORIZED" }, 401, {
         "www-authenticate": "Bearer",

package/dist/agent-inspector.js.map

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

package/dist/agent-journal.d.ts

@@ -0,0 +1,118 @@
+import { Context, Effect, Layer } from "effect";
+import type { ResolvedAgent } from "./agent-run-journal.types.js";
+import type { AcceptRunReceipt, ExecutionClaim, RunOwner } from "@relkit/agents";
+import type { BrowserMessage } from "@relkit/contracts";
+/** Projects an agent value into a user or assistant journal message.
+ * @param resolved - Authorized agent descriptor, provider and durable request scope.
+ * @param receipt - Durable accepted-run receipt identifying the thread and run.
+ * @param claim - Current fenced execution claim required by the provider.
+ * @param role - Public message role used to select the configured chat projection.
+ * @param value - Value inspected, validated or projected by this operation.
+ * @param messageId - Stable public message identifier retained across streaming updates.
+ * @param createdAt - Public creation timestamp retained by the journal record.
+ * @param state - State owned by the current request or operation.
+ * @returns Completion after the projected text message is durably journaled.
+ */
+export declare const appendAgentMessageEffect: (resolved: {
+    descriptor: {
+        readonly input: import("@relkit/schema").StandardSchemaV1;
+        readonly output: import("@relkit/schema").StandardSchemaV1;
+        readonly client?: unknown;
+        readonly chat?: {
+            readonly input?: unknown;
+            readonly output?: unknown;
+        };
+    };
+    node: import("@relkit/graph").AgentRegistration;
+    provider: import("@relkit/agents").AgentStateProvider;
+    scope: import("@relkit/contracts").AgentRequestScope;
+    trusted: unknown;
+}, receipt: AcceptRunReceipt, claim: ExecutionClaim, role: "user" | "assistant", value: unknown, messageId?: string | undefined, createdAt?: string | undefined, state?: "streaming" | "complete" | undefined) => Effect.Effect<void, import("./http-effect.js").HttpBoundaryError, never>;
+/** Appends a bounded browser message under the current execution claim.
+ * @param resolved - Authorized agent descriptor, provider and durable request scope.
+ * @param receipt - Durable accepted-run receipt identifying the thread and run.
+ * @param claim - Current fenced execution claim required by the provider.
+ * @param message - Public message included in the resulting value or failure.
+ * @returns Completion after the bounded browser message is durably journaled.
+ */
+export declare const appendBrowserMessageEffect: (resolved: {
+    descriptor: {
+        readonly input: import("@relkit/schema").StandardSchemaV1;
+        readonly output: import("@relkit/schema").StandardSchemaV1;
+        readonly client?: unknown;
+        readonly chat?: {
+            readonly input?: unknown;
+            readonly output?: unknown;
+        };
+    };
+    node: import("@relkit/graph").AgentRegistration;
+    provider: import("@relkit/agents").AgentStateProvider;
+    scope: import("@relkit/contracts").AgentRequestScope;
+    trusted: unknown;
+}, receipt: AcceptRunReceipt, claim: ExecutionClaim, message: BrowserMessage) => Effect.Effect<void, import("./http-effect.js").HttpBoundaryError, never>;
+/** Selects the configured chat field before rendering a public message.
+ * @param resolved - Authorized agent descriptor, provider and durable request scope.
+ * @param role - Public message role used to select the configured chat projection.
+ * @param value - Value inspected, validated or projected by this operation.
+ * @returns The configured chat text field, raw string input, or a JSON representation.
+ */
+export declare function publicAgentText(resolved: ResolvedAgent, role: "user" | "assistant", value: unknown): string;
+/** Persists the terminal run outcome and receipt retention deadline.
+ * @param resolved - Authorized agent descriptor, provider and durable request scope.
+ * @param receipt - Durable accepted-run receipt identifying the thread and run.
+ * @param claim - Current fenced execution claim required by the provider.
+ * @param outcome - Terminal classification used for durable state and telemetry.
+ * @param publicValue - Already projected public value admitted to durable storage.
+ * @returns Completion after the terminal record and receipt retention are persisted.
+ */
+export declare const completeAgentRunEffect: (resolved: {
+    descriptor: {
+        readonly input: import("@relkit/schema").StandardSchemaV1;
+        readonly output: import("@relkit/schema").StandardSchemaV1;
+        readonly client?: unknown;
+        readonly chat?: {
+            readonly input?: unknown;
+            readonly output?: unknown;
+        };
+    };
+    node: import("@relkit/graph").AgentRegistration;
+    provider: import("@relkit/agents").AgentStateProvider;
+    scope: import("@relkit/contracts").AgentRequestScope;
+    trusted: unknown;
+}, receipt: AcceptRunReceipt, claim: ExecutionClaim, outcome: "failed" | "cancelled" | "succeeded", publicValue: unknown) => Effect.Effect<void, import("./http-effect.js").HttpBoundaryError, never>;
+/** Marks an owned run interrupted using its expected generation and fencing claim.
+ * @param resolved - Authorized agent descriptor, provider and durable request scope.
+ * @param receipt - Durable accepted-run receipt identifying the thread and run.
+ * @param claim - Current fenced execution claim required by the provider.
+ * @param expectedOwner - Expected generation and protocol owner used to fence interruption.
+ * @param reason - Cancellation or interruption reason supplied by the owning boundary.
+ * @returns Completion after the provider applies the fenced interruption.
+ */
+export declare const interruptAgentRunEffect: (resolved: {
+    descriptor: {
+        readonly input: import("@relkit/schema").StandardSchemaV1;
+        readonly output: import("@relkit/schema").StandardSchemaV1;
+        readonly client?: unknown;
+        readonly chat?: {
+            readonly input?: unknown;
+            readonly output?: unknown;
+        };
+    };
+    node: import("@relkit/graph").AgentRegistration;
+    provider: import("@relkit/agents").AgentStateProvider;
+    scope: import("@relkit/contracts").AgentRequestScope;
+    trusted: unknown;
+}, receipt: AcceptRunReceipt, claim: ExecutionClaim, expectedOwner: RunOwner, reason?: "claim-expired" | "generation-unavailable" | "process-lost" | undefined) => Effect.Effect<void, import("./http-effect.js").HttpBoundaryError, never>;
+declare const AgentJournal_base: Context.ServiceClass<AgentJournal, "@relkit/runtime-hono/AgentJournal", {
+    readonly appendAgentMessage: typeof appendAgentMessageEffect;
+    readonly appendBrowserMessage: typeof appendBrowserMessageEffect;
+    readonly completeAgentRun: typeof completeAgentRunEffect;
+    readonly interruptAgentRun: typeof interruptAgentRunEffect;
+}>;
+/** Lazy agent domain workflows with typed native failures. */
+export declare class AgentJournal extends AgentJournal_base {
+}
+/** Live operations; tests can replace the same contract. */
+export declare const AgentJournalLive: Layer.Layer<AgentJournal, never, never>;
+export {};
+//# sourceMappingURL=agent-journal.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent-journal.d.ts","sourceRoot":"","sources":["../src/agent-journal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAEhD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AACjF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAKxD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,wBAAwB;;;;;;0BAsFiC,CAAC;2BACvD,CAAC;;;;;;;0RA9Df,CAAC;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,0BAA0B;;;;;;0BAoD+B,CAAC;2BACvD,CAAC;;;;;;;yJA5Bf,CAAC;AAEH;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,aAAa,EACvB,IAAI,EAAE,MAAM,GAAG,WAAW,EAC1B,KAAK,EAAE,OAAO,GACb,MAAM,CAWR;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,sBAAsB;;;;;;0BANmC,CAAC;2BACvD,CAAC;;;;;;;qMAsCf,CAAC;AAEH;;;;;;;GAOG;AACH,eAAO,MAAM,uBAAuB;;;;;;0BAjDkC,CAAC;2BACvD,CAAC;;;;;;;2OAqEf,CAAC;;iCAM8B,OAAO,wBAAwB;mCAC7B,OAAO,0BAA0B;+BACrC,OAAO,sBAAsB;gCAC5B,OAAO,uBAAuB;;AAP9D,8DAA8D;AAC9D,qBAAa,YAAa,SAAQ,iBAQM;CAAG;AAE3C,4DAA4D;AAC5D,eAAO,MAAM,gBAAgB,yCAS3B,CAAC"}