@relkit/runtime-hono 0.5.4 → 0.5.6

package/dist/agent-request-validation.d.ts

@@ -0,0 +1,50 @@
+import type { AgentInput } from "./agent-rpc-support.types.js";
+import type { AgentStateLimits, RunOwner } from "@relkit/agents";
+import { type StandardSchemaV1 } from "@relkit/schema";
+import type { RouteMaterializationOptions } from "./materialize-routes.js";
+/** Validates a nonempty thread identifier without silently trimming its identity.
+ * @param value - Value inspected, validated or projected by this operation.
+ * @returns The original nonempty thread identifier with no surrounding whitespace.
+ */
+export declare function requireAgentThreadId(value: unknown): string;
+export declare const agentLimits: AgentStateLimits;
+/** Computes the canonical digest used for idempotency and durable admission fencing.
+ * @param value - Value inspected, validated or projected by this operation.
+ * @returns The canonical JSON SHA-256 digest with its sha256 prefix.
+ */
+export declare function digest(value: unknown): string;
+/** Checks a supplied semantic digest against the submitted agent payload.
+ * @param input - Submitted operation input; validation and authorization occur before effects are admitted.
+ * @returns The computed digest, throwing when a supplied digest disagrees with the payload.
+ */
+export declare function verifiedAgentRequestDigest(input: AgentInput): string;
+/** Measures the UTF-8 byte size used by transport or journal limits.
+ * @param value - Value inspected, validated or projected by this operation.
+ * @returns The UTF-8 byte length of the JSON encoding.
+ */
+export declare function encodedBytes(value: unknown): number;
+/** Builds the generation identity required by durable agent admission.
+ * @param options - Application dependencies and configuration for this domain.
+ * @param profile - Configured provider profile used to select durable state.
+ * @returns The generation, protocol, schema and provider-scope ownership descriptor.
+ */
+export declare function agentOwner(options: RouteMaterializationOptions, profile: string): RunOwner;
+/** Recognizes the runtime agent descriptor and its required input/output schemas.
+ * @param value - Value inspected, validated or projected by this operation.
+ * @returns Whether the inspected value satisfies the declared type guard.
+ */
+export declare function isAgent(value: unknown): value is {
+    readonly input: StandardSchemaV1;
+    readonly output: StandardSchemaV1;
+    readonly client?: unknown;
+    readonly chat?: {
+        readonly input?: unknown;
+        readonly output?: unknown;
+    };
+};
+/** Recognizes the Standard Schema contract required by runtime validation.
+ * @param value - Value inspected, validated or projected by this operation.
+ * @returns Whether the inspected value satisfies the declared type guard.
+ */
+export declare function isSchema(value: unknown): value is StandardSchemaV1;
+//# sourceMappingURL=agent-request-validation.d.ts.map

package/dist/agent-request-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-request-validation.d.ts","sourceRoot":"","sources":["../src/agent-request-validation.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAS/D,OAAO,KAAK,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AACjE,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAEvD,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAC;AAG3E;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAK3D;AAED,eAAO,MAAM,WAAW,EAAE,gBAWzB,CAAC;AAEF;;;GAGG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAI7C;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAUpE;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEnD;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,2BAA2B,EAAE,OAAO,EAAE,MAAM,GAAG,QAAQ,CAQ1F;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI;IAChD,QAAQ,CAAC,KAAK,EAAE,gBAAgB,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;CACzE,CAEA;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,gBAAgB,CAElE"}

package/dist/agent-request-validation.js

@@ -0,0 +1,87 @@
+import { Schema } from "effect";
+import { AgentThreadId } from "./agent-rpc-support.schemas.js";
+import { createHash } from "node:crypto";
+import { AGENT_STATE_SCHEMA_VERSION, AGENT_STREAM_VERSION, canonicalJson, REALTIME_RUNTIME_LIMITS, } from "@relkit/contracts";
+import {} from "@relkit/schema";
+import { isRecord } from "./materialize-routes-utils.js";
+/** Validates a nonempty thread identifier without silently trimming its identity.
+ * @param value - Value inspected, validated or projected by this operation.
+ * @returns The original nonempty thread identifier with no surrounding whitespace.
+ */
+export function requireAgentThreadId(value) {
+    if (!Schema.is(AgentThreadId)(value)) {
+        throw new TypeError("threadId must be a non-empty string without surrounding whitespace.");
+    }
+    return value;
+}
+export const agentLimits = {
+    maxSnapshotBytes: REALTIME_RUNTIME_LIMITS.initialSnapshotBytes,
+    maxHistoryPageBytes: REALTIME_RUNTIME_LIMITS.snapshotHistoryPageBytes,
+    maxJournalRecordBytes: REALTIME_RUNTIME_LIMITS.progressRecordBytes,
+    maxJournalBytesPerThread: REALTIME_RUNTIME_LIMITS.journalBytesPerThread,
+    maxStateBytesPerApplication: REALTIME_RUNTIME_LIMITS.agentStateBytes,
+    maxThreadsPerPrincipal: REALTIME_RUNTIME_LIMITS.threadsPerPrincipal,
+    maxActiveRunsPerPrincipal: REALTIME_RUNTIME_LIMITS.activeRunsPerPrincipal,
+    maxActiveRunsPerApplication: REALTIME_RUNTIME_LIMITS.activeRunsPerApplication,
+    terminalReserveBytes: REALTIME_RUNTIME_LIMITS.terminalReserveBytes,
+    terminalReserveRecords: REALTIME_RUNTIME_LIMITS.terminalReserveRecords,
+};
+/** Computes the canonical digest used for idempotency and durable admission fencing.
+ * @param value - Value inspected, validated or projected by this operation.
+ * @returns The canonical JSON SHA-256 digest with its sha256 prefix.
+ */
+export function digest(value) {
+    return `sha256:${createHash("sha256")
+        .update(canonicalJson(value))
+        .digest("hex")}`;
+}
+/** Checks a supplied semantic digest against the submitted agent payload.
+ * @param input - Submitted operation input; validation and authorization occur before effects are admitted.
+ * @returns The computed digest, throwing when a supplied digest disagrees with the payload.
+ */
+export function verifiedAgentRequestDigest(input) {
+    const value = input.resume === true
+        ? { payload: input.payload, waitingRevision: input.waitingRevision }
+        : input.payload;
+    const actual = digest(value);
+    if (input.requestDigest !== undefined && input.requestDigest !== actual) {
+        throw new TypeError("Agent request digest does not match its payload.");
+    }
+    return actual;
+}
+/** Measures the UTF-8 byte size used by transport or journal limits.
+ * @param value - Value inspected, validated or projected by this operation.
+ * @returns The UTF-8 byte length of the JSON encoding.
+ */
+export function encodedBytes(value) {
+    return new TextEncoder().encode(JSON.stringify(value)).byteLength;
+}
+/** Builds the generation identity required by durable agent admission.
+ * @param options - Application dependencies and configuration for this domain.
+ * @param profile - Configured provider profile used to select durable state.
+ * @returns The generation, protocol, schema and provider-scope ownership descriptor.
+ */
+export function agentOwner(options, profile) {
+    return {
+        generationId: options.agentRuntime.generationId,
+        publicFingerprint: options.agentRuntime.publicFingerprint,
+        protocolVersion: AGENT_STREAM_VERSION,
+        schemaVersion: AGENT_STATE_SCHEMA_VERSION,
+        providerScope: profile,
+    };
+}
+/** Recognizes the runtime agent descriptor and its required input/output schemas.
+ * @param value - Value inspected, validated or projected by this operation.
+ * @returns Whether the inspected value satisfies the declared type guard.
+ */
+export function isAgent(value) {
+    return isRecord(value) && isSchema(value.input) && isSchema(value.output);
+}
+/** Recognizes the Standard Schema contract required by runtime validation.
+ * @param value - Value inspected, validated or projected by this operation.
+ * @returns Whether the inspected value satisfies the declared type guard.
+ */
+export function isSchema(value) {
+    return isRecord(value) && isRecord(value["~standard"]) && value["~standard"].version === 1;
+}
+//# sourceMappingURL=agent-request-validation.js.map

package/dist/agent-request-validation.js.map

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

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

@@ -1,5 +1,19 @@
 import { ORPCError } from "@orpc/server";
+/** Translate native call failures into the public agent RPC error contract.
+ * @typeParam Value - Value produced by the source or selected by the predicate.
+ * @param action - Native operation or lazy stream producer.
+ * @returns The action result; failures reject with a sanitized ORPCError.
+ */
 export declare function agentRpcCall<Value>(action: () => Promise<Value>): Promise<Value>;
+/** Translate failures raised while iterating an agent RPC source.
+ * @typeParam Value - Value produced by the source or selected by the predicate.
+ * @param action - Native operation or lazy stream producer.
+ * @returns The source values, preserving lazy iteration and public error mapping.
+ */
 export declare function agentRpcStream<Value>(action: () => AsyncIterable<Value>): AsyncIterable<Value>;
+/** Retain known public errors and redact unsupported native failures.
+ * @param error - Native failure or public error identifier.
+ * @returns An ORPCError safe to expose at the agent RPC boundary.
+ */
 export declare function agentRpcError(error: unknown): ORPCError<string, unknown>;
 //# sourceMappingURL=agent-rpc-errors.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"agent-rpc-errors.d.ts","sourceRoot":"","sources":["../src/agent-rpc-errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAqBzC,wBAAsB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,CAMtF;AAED,wBAAuB,cAAc,CAAC,KAAK,EACzC,MAAM,EAAE,MAAM,aAAa,CAAC,KAAK,CAAC,GACjC,aAAa,CAAC,KAAK,CAAC,CAMtB;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,CAQxE"}
+{"version":3,"file":"agent-rpc-errors.d.ts","sourceRoot":"","sources":["../src/agent-rpc-errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAqBzC;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,CAMtF;AAED;;;;GAIG;AACH,wBAAuB,cAAc,CAAC,KAAK,EACzC,MAAM,EAAE,MAAM,aAAa,CAAC,KAAK,CAAC,GACjC,aAAa,CAAC,KAAK,CAAC,CAMtB;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,CAQxE"}

package/dist/agent-rpc-errors.js

@@ -17,6 +17,11 @@ const publicCodes = new Set([
     "PROVIDER_STATE_LOST",
     "NOT_FOUND",
 ]);
+/** Translate native call failures into the public agent RPC error contract.
+ * @typeParam Value - Value produced by the source or selected by the predicate.
+ * @param action - Native operation or lazy stream producer.
+ * @returns The action result; failures reject with a sanitized ORPCError.
+ */
 export async function agentRpcCall(action) {
     try {
         return await action();
@@ -25,6 +30,11 @@ export async function agentRpcCall(action) {
         throw agentRpcError(error);
     }
 }
+/** Translate failures raised while iterating an agent RPC source.
+ * @typeParam Value - Value produced by the source or selected by the predicate.
+ * @param action - Native operation or lazy stream producer.
+ * @returns The source values, preserving lazy iteration and public error mapping.
+ */
 export async function* agentRpcStream(action) {
     try {
         yield* action();
@@ -33,6 +43,10 @@ export async function* agentRpcStream(action) {
         throw agentRpcError(error);
     }
 }
+/** Retain known public errors and redact unsupported native failures.
+ * @param error - Native failure or public error identifier.
+ * @returns An ORPCError safe to expose at the agent RPC boundary.
+ */
 export function agentRpcError(error) {
     if (error instanceof ORPCError)
         return error;
@@ -44,6 +58,10 @@ export function agentRpcError(error) {
     }
     return new ORPCError("INTERNAL_SERVER_ERROR");
 }
+/** Read a string error code without requiring a native Error instance.
+ * @param error - Native failure or public error identifier.
+ * @returns The code when present, otherwise undefined.
+ */
 function errorCode(error) {
     if (error === null || typeof error !== "object")
         return undefined;
@@ -51,6 +69,10 @@ function errorCode(error) {
         ? error.code
         : undefined;
 }
+/** Provide stable public wording for allowed agent error codes.
+ * @param code - Stable public error or mapping issue code.
+ * @returns A safe message derived from the allowlisted code.
+ */
 function publicMessage(code) {
     if (code === "NOT_FOUND")
         return "Agent resource was not found.";

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

@@ -1 +1 @@
-{"version":3,"file":"agent-rpc-errors.js","sourceRoot":"","sources":["../src/agent-rpc-errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC;IAC1B,gCAAgC;IAChC,yBAAyB;IACzB,YAAY;IACZ,0BAA0B;IAC1B,wBAAwB;IACxB,4BAA4B;IAC5B,2BAA2B;IAC3B,gBAAgB;IAChB,0BAA0B;IAC1B,qBAAqB;IACrB,wBAAwB;IACxB,8BAA8B;IAC9B,sBAAsB;IACtB,4BAA4B;IAC5B,qBAAqB;IACrB,WAAW;CACZ,CAAC,CAAC;AAEH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAQ,MAA4B;IACpE,IAAI,CAAC;QACH,OAAO,MAAM,MAAM,EAAE,CAAC;IACxB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,aAAa,CAAC,KAAK,CAAC,CAAC;IAC7B,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,cAAc,CACnC,MAAkC;IAElC,IAAI,CAAC;QACH,KAAK,CAAC,CAAC,MAAM,EAAE,CAAC;IAClB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,aAAa,CAAC,KAAK,CAAC,CAAC;IAC7B,CAAC;AACH,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,IAAI,KAAK,YAAY,SAAS;QAAE,OAAO,KAAK,CAAC;IAC7C,IAAI,KAAK,YAAY,SAAS;QAAE,OAAO,IAAI,SAAS,CAAC,aAAa,EAAE,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IAChG,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;IAC9B,IAAI,IAAI,KAAK,SAAS,IAAI,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;QAChD,OAAO,IAAI,SAAS,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC/D,CAAC;IACD,OAAO,IAAI,SAAS,CAAC,uBAAuB,CAAC,CAAC;AAChD,CAAC;AAED,SAAS,SAAS,CAAC,KAAc;IAC/B,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IAClE,OAAO,OAAQ,KAAqC,CAAC,IAAI,KAAK,QAAQ;QACpE,CAAC,CAAE,KAAmC,CAAC,IAAI;QAC3C,CAAC,CAAC,SAAS,CAAC;AAChB,CAAC;AAED,SAAS,aAAa,CAAC,IAAY;IACjC,IAAI,IAAI,KAAK,WAAW;QAAE,OAAO,+BAA+B,CAAC;IACjE,IAAI,IAAI,KAAK,qBAAqB;QAAE,OAAO,+BAA+B,CAAC;IAC3E,IAAI,IAAI,KAAK,4BAA4B;QAAE,OAAO,iCAAiC,CAAC;IACpF,IAAI,IAAI,KAAK,sBAAsB;QAAE,OAAO,qDAAqD,CAAC;IAClG,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;AACjD,CAAC"}
+{"version":3,"file":"agent-rpc-errors.js","sourceRoot":"","sources":["../src/agent-rpc-errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC;IAC1B,gCAAgC;IAChC,yBAAyB;IACzB,YAAY;IACZ,0BAA0B;IAC1B,wBAAwB;IACxB,4BAA4B;IAC5B,2BAA2B;IAC3B,gBAAgB;IAChB,0BAA0B;IAC1B,qBAAqB;IACrB,wBAAwB;IACxB,8BAA8B;IAC9B,sBAAsB;IACtB,4BAA4B;IAC5B,qBAAqB;IACrB,WAAW;CACZ,CAAC,CAAC;AAEH;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAQ,MAA4B;IACpE,IAAI,CAAC;QACH,OAAO,MAAM,MAAM,EAAE,CAAC;IACxB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,aAAa,CAAC,KAAK,CAAC,CAAC;IAC7B,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,cAAc,CACnC,MAAkC;IAElC,IAAI,CAAC;QACH,KAAK,CAAC,CAAC,MAAM,EAAE,CAAC;IAClB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,aAAa,CAAC,KAAK,CAAC,CAAC;IAC7B,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,IAAI,KAAK,YAAY,SAAS;QAAE,OAAO,KAAK,CAAC;IAC7C,IAAI,KAAK,YAAY,SAAS;QAAE,OAAO,IAAI,SAAS,CAAC,aAAa,EAAE,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IAChG,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;IAC9B,IAAI,IAAI,KAAK,SAAS,IAAI,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;QAChD,OAAO,IAAI,SAAS,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC/D,CAAC;IACD,OAAO,IAAI,SAAS,CAAC,uBAAuB,CAAC,CAAC;AAChD,CAAC;AAED;;;GAGG;AACH,SAAS,SAAS,CAAC,KAAc;IAC/B,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IAClE,OAAO,OAAQ,KAAqC,CAAC,IAAI,KAAK,QAAQ;QACpE,CAAC,CAAE,KAAmC,CAAC,IAAI;QAC3C,CAAC,CAAC,SAAS,CAAC;AAChB,CAAC;AAED;;;GAGG;AACH,SAAS,aAAa,CAAC,IAAY;IACjC,IAAI,IAAI,KAAK,WAAW;QAAE,OAAO,+BAA+B,CAAC;IACjE,IAAI,IAAI,KAAK,qBAAqB;QAAE,OAAO,+BAA+B,CAAC;IAC3E,IAAI,IAAI,KAAK,4BAA4B;QAAE,OAAO,iCAAiC,CAAC;IACpF,IAAI,IAAI,KAAK,sBAAsB;QAAE,OAAO,qDAAqD,CAAC;IAClG,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;AACjD,CAAC"}

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

@@ -1,24 +1,28 @@
 import type { RouteMaterializationOptions } from "./materialize-routes.js";
 import type { RpcContext } from "./rpc.js";
 import { type AgentInput } from "./agent-rpc-support.js";
+export { AgentReads, AgentReadsLive } from "./agent-reads.js";
+/** Executes listAgentThreads 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 Up to 100 authorized thread summaries.
+ */
 export declare function listAgentThreads(input: AgentInput, context: RpcContext, options: RouteMaterializationOptions): Promise<import("@relkit/agents").ThreadList>;
+/** Executes loadAgent 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 compatible browser snapshot within the initial snapshot byte limit.
+ */
 export declare function loadAgent(input: AgentInput, context: RpcContext, options: RouteMaterializationOptions): Promise<import("@relkit/contracts").ThreadSnapshot>;
-export declare function observeAgent(input: AgentInput, context: RpcContext, options: RouteMaterializationOptions, signal?: AbortSignal): AsyncGenerator<{
-    kind: "gap";
-    reason: "expired" | "foreign" | "future" | "session" | "provider-reset";
-    snapshot: import("@relkit/contracts").ThreadSnapshot;
-    event?: never;
-} | {
-    kind: "event";
-    event: import("@relkit/contracts").AgentClientEvent;
-    reason?: never;
-    snapshot?: never;
-} | {
-    kind: "snapshot";
-    snapshot: import("@relkit/contracts").ThreadSnapshot;
-    reason?: never;
-    event?: never;
-}, void, unknown>;
+export { observeAgent } from "./agent-observation.js";
+/** Executes lookupAgentReceipt 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 matching scoped receipt, or the provider's missing or expired result.
+ */
 export declare function lookupAgentReceipt(input: AgentInput, context: RpcContext, options: RouteMaterializationOptions): Promise<{
     readonly status: "not-found";
     readonly providerEpoch: string;
@@ -38,5 +42,11 @@ export declare function lookupAgentReceipt(input: AgentInput, context: RpcContex
     readonly status: "found";
     readonly receipt: import("@relkit/agents").AcceptRunReceipt | import("@relkit/agents").CompletionReceipt;
 }>;
+/** Executes readAgentHistory 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 requested immutable snapshot page within the history byte limit.
+ */
 export declare function readAgentHistory(input: AgentInput, context: RpcContext, options: RouteMaterializationOptions): Promise<import("@relkit/agents").SnapshotHistoryPage>;
 //# sourceMappingURL=agent-rpc-read.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"agent-rpc-read.d.ts","sourceRoot":"","sources":["../src/agent-rpc-read.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAC;AAC3E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,EAAsC,KAAK,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAG7F,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,UAAU,EACnB,OAAO,EAAE,2BAA2B,gDAKrC;AAED,wBAAsB,SAAS,CAC7B,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,UAAU,EACnB,OAAO,EAAE,2BAA2B,uDAYrC;AAED,wBAAuB,YAAY,CACjC,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,UAAU,EACnB,OAAO,EAAE,2BAA2B,EACpC,MAAM,CAAC,EAAE,WAAW;;;;;;;;;;;;;;;kBAoDrB;AAWD,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,UAAU,EACnB,OAAO,EAAE,2BAA2B;;;;;;;;;;;;;;;;;;GAmCrC;AAED,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,UAAU,EACnB,OAAO,EAAE,2BAA2B,yDAcrC"}
+{"version":3,"file":"agent-rpc-read.d.ts","sourceRoot":"","sources":["../src/agent-rpc-read.ts"],"names":[],"mappings":"AAGA,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;AAGzD,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAC9D;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,UAAU,EACnB,OAAO,EAAE,2BAA2B,gDAQrC;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CACvB,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,UAAU,EACnB,OAAO,EAAE,2BAA2B,uDAQrC;AAED,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAEtD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,UAAU,EACnB,OAAO,EAAE,2BAA2B;;;;;;;;;;;;;;;;;;GAQrC;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,UAAU,EACnB,OAAO,EAAE,2BAA2B,yDAQrC"}

package/dist/agent-rpc-read.js

@@ -1,127 +1,55 @@
-import { REALTIME_RUNTIME_LIMITS } from "@relkit/contracts";
-import { agentClientEvents } from "@relkit/agents";
-import { assertExpectedIdentity } from "./rpc-identity.js";
-import { agentContext, requireAgentThreadId } from "./agent-rpc-support.js";
-import { clientAgentSnapshot } from "./agent-compatibility.js";
-export async function listAgentThreads(input, context, options) {
-    await assertExpectedIdentity(context, options.clientIdentity, input.expectedIdentity);
-    const resolved = await agentContext(input, context, options, "list");
-    return resolved.provider.listThreads({ ...resolved.scope, limit: 100 });
+import { Effect } from "effect";
+import { runHttp } from "./http-effect.js";
+import {} from "./agent-rpc-support.js";
+import { AgentReads, AgentReadsLive } from "./agent-reads.js";
+export { AgentReads, AgentReadsLive } from "./agent-reads.js";
+/** Executes listAgentThreads 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 Up to 100 authorized thread summaries.
+ */
+export function listAgentThreads(input, context, options) {
+    return runHttp(Effect.gen(function* () {
+        const service = yield* AgentReads;
+        return yield* service.listAgentThreads(input, context, options);
+    }).pipe(Effect.provide(AgentReadsLive)));
 }
-export async function loadAgent(input, context, options) {
-    await assertExpectedIdentity(context, options.clientIdentity);
-    const threadId = requireAgentThreadId(input.threadId);
-    const resolved = await agentContext({ ...input, threadId }, context, options, "load");
-    return clientAgentSnapshot(await resolved.provider.loadThread({
-        ...resolved.scope,
-        threadId,
-        maxEncodedBytes: REALTIME_RUNTIME_LIMITS.initialSnapshotBytes,
-    }));
+/** Executes loadAgent 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 compatible browser snapshot within the initial snapshot byte limit.
+ */
+export function loadAgent(input, context, options) {
+    return runHttp(Effect.gen(function* () {
+        const service = yield* AgentReads;
+        return yield* service.loadAgent(input, context, options);
+    }).pipe(Effect.provide(AgentReadsLive)));
 }
-export async function* observeAgent(input, context, options, signal) {
-    await assertExpectedIdentity(context, options.clientIdentity, input.expectedIdentity);
-    const threadId = requireAgentThreadId(input.threadId);
-    if (input.after === undefined)
-        throw new TypeError("checkpoint is required.");
-    let resolved = await agentContext({ ...input, threadId }, context, options, "observe");
-    let after = input.after;
-    const controller = signal ?? new AbortController().signal;
-    while (!controller.aborted) {
-        await assertExpectedIdentity(context, options.clientIdentity, input.expectedIdentity);
-        resolved = await agentContext({ ...input, threadId }, context, options, "observe");
-        const page = await resolved.provider.readJournal({
-            ...resolved.scope,
-            threadId,
-            after,
-            limit: 100,
-            maxEncodedBytes: 1024 * 1024,
-        });
-        if (page.gap !== undefined) {
-            const snapshot = clientAgentSnapshot(await resolved.provider.loadThread({
-                ...resolved.scope,
-                threadId,
-                maxEncodedBytes: REALTIME_RUNTIME_LIMITS.initialSnapshotBytes,
-            }));
-            after = snapshot.checkpoint;
-            yield { kind: "gap", reason: page.gap, snapshot };
-            continue;
-        }
-        after = page.checkpoint;
-        for (const record of page.records)
-            for (const event of agentClientEvents(record))
-                yield { kind: "event", event };
-        if (page.records.some(requiresSnapshot)) {
-            const snapshot = clientAgentSnapshot(await resolved.provider.loadThread({
-                ...resolved.scope,
-                threadId,
-                maxEncodedBytes: REALTIME_RUNTIME_LIMITS.initialSnapshotBytes,
-            }));
-            yield { kind: "snapshot", snapshot };
-        }
-        if (!page.hasMore)
-            await resolved.provider.waitForJournal({
-                ...resolved.scope,
-                threadId,
-                after,
-                deadlineMs: Date.now() + 15_000,
-                signal: controller,
-            });
-    }
+export { observeAgent } from "./agent-observation.js";
+/** Executes lookupAgentReceipt 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 matching scoped receipt, or the provider's missing or expired result.
+ */
+export function lookupAgentReceipt(input, context, options) {
+    return runHttp(Effect.gen(function* () {
+        const service = yield* AgentReads;
+        return yield* service.lookupAgentReceipt(input, context, options);
+    }).pipe(Effect.provide(AgentReadsLive)));
 }
-function requiresSnapshot(record) {
-    return (record.kind === "approval" ||
-        record.kind === "control" ||
-        record.kind === "terminal" ||
-        record.kind === "interruption");
-}
-export async function lookupAgentReceipt(input, context, options) {
-    await assertExpectedIdentity(context, options.clientIdentity);
-    if (input.operationId === undefined || input.requestDigest === undefined)
-        throw new TypeError("Receipt request is invalid.");
-    const resolved = await agentContext(input, context, options, "receipt");
-    if (input.kind === "continuation") {
-        const threadId = requireAgentThreadId(input.threadId);
-        return resolved.provider.lookupContinuationReceipt({
-            ...resolved.scope,
-            operationId: input.operationId,
-            threadId,
-            semanticDigest: input.requestDigest,
-            now: new Date().toISOString(),
-        });
-    }
-    if (input.kind === "agent-control") {
-        const threadId = requireAgentThreadId(input.threadId);
-        if (input.runId === undefined)
-            throw new TypeError("Control receipt request is invalid.");
-        return resolved.provider.lookupControlReceipt({
-            ...resolved.scope,
-            operationId: input.operationId,
-            threadId,
-            runId: input.runId,
-            semanticDigest: input.requestDigest,
-            now: new Date().toISOString(),
-        });
-    }
-    return resolved.provider.lookupRunReceipt({
-        ...resolved.scope,
-        operationId: input.operationId,
-        ...(input.threadId === undefined ? {} : { threadId: input.threadId }),
-        semanticDigest: input.requestDigest,
-        now: new Date().toISOString(),
-    });
-}
-export async function readAgentHistory(input, context, options) {
-    await assertExpectedIdentity(context, options.clientIdentity);
-    const threadId = requireAgentThreadId(input.threadId);
-    if (input.snapshotId === undefined || input.cursor === undefined)
-        throw new TypeError("Snapshot and cursor are required.");
-    const resolved = await agentContext({ ...input, threadId }, context, options, "history");
-    return resolved.provider.readSnapshotHistory({
-        ...resolved.scope,
-        threadId,
-        snapshotId: input.snapshotId,
-        cursor: input.cursor,
-        maxEncodedBytes: REALTIME_RUNTIME_LIMITS.snapshotHistoryPageBytes,
-    });
+/** Executes readAgentHistory 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 requested immutable snapshot page within the history byte limit.
+ */
+export function readAgentHistory(input, context, options) {
+    return runHttp(Effect.gen(function* () {
+        const service = yield* AgentReads;
+        return yield* service.readAgentHistory(input, context, options);
+    }).pipe(Effect.provide(AgentReadsLive)));
 }
 //# sourceMappingURL=agent-rpc-read.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"agent-rpc-read.js","sourceRoot":"","sources":["../src/agent-rpc-read.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"agent-rpc-read.js","sourceRoot":"","sources":["../src/agent-rpc-read.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAI3C,OAAO,EAAmB,MAAM,wBAAwB,CAAC;AAEzD,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAC9D;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAC9B,KAAiB,EACjB,OAAmB,EACnB,OAAoC;IAEpC,OAAO,OAAO,CACZ,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;QAClB,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,UAAU,CAAC;QAClC,OAAO,KAAK,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAClE,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,CACxC,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CACvB,KAAiB,EACjB,OAAmB,EACnB,OAAoC;IAEpC,OAAO,OAAO,CACZ,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;QAClB,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,UAAU,CAAC;QAClC,OAAO,KAAK,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAC3D,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,CACxC,CAAC;AACJ,CAAC;AAED,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAEtD;;;;;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,UAAU,CAAC;QAClC,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,cAAc,CAAC,CAAC,CACxC,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAC9B,KAAiB,EACjB,OAAmB,EACnB,OAAoC;IAEpC,OAAO,OAAO,CACZ,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;QAClB,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,UAAU,CAAC;QAClC,OAAO,KAAK,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAClE,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,CACxC,CAAC;AACJ,CAAC"}

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

@@ -1,7 +1,54 @@
+import type { ResolvedAgent } from "./agent-rpc-resume.types.js";
 import { type OperationId } from "@relkit/contracts";
 import type { RouteMaterializationOptions } from "./materialize-routes.js";
-import { agentContext, type AgentInput } from "./agent-rpc-support.js";
-type ResolvedAgent = Awaited<ReturnType<typeof agentContext>>;
+import { type AgentInput } from "./agent-rpc-support.js";
+import { Context, Effect, Layer } from "effect";
+import { HttpBoundaryError } from "./http-effect.js";
+/** Admits a resume only after revision validation and joining the interrupted run.
+ * @param input - Public resume payload and observed revision.
+ * @param threadId - Authorized durable thread identifier.
+ * @param operationId - Idempotency identifier for continuation admission.
+ * @param resolved - Authorized descriptor, provider and scope.
+ * @param options - Generation and runtime dependencies.
+ * @returns The accepted continuation receipt, including whether admission was a duplicate.
+ */
+declare const resume: (input: AgentInput, threadId: string, operationId: OperationId, 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;
+}, options: RouteMaterializationOptions) => Effect.Effect<{
+    operationId: OperationId;
+    threadId: string;
+    runId: string;
+    status: "accepted";
+    duplicate: boolean;
+}, HttpBoundaryError, never>;
+declare const AgentContinuations_base: Context.ServiceClass<AgentContinuations, "@relkit/runtime-hono/AgentContinuations", {
+    readonly resume: typeof resume;
+}>;
+/** Admits resumptions only after the prior run and its durable waiting revision settle. */
+export declare class AgentContinuations extends AgentContinuations_base {
+}
+/** Live continuation admission preserves receipt idempotency and revision fencing. */
+export declare const AgentContinuationsLive: Layer.Layer<AgentContinuations, never, never>;
+/** Executes durable resume admission at the native oRPC boundary.
+ * @param input - Submitted operation input; validation and authorization occur before effects are admitted.
+ * @param threadId - Stable thread identifier within the authorized agent scope.
+ * @param operationId - Idempotency identifier for durable admission or lookup.
+ * @param resolved - Authorized agent descriptor, provider and durable request scope.
+ * @param options - Application dependencies and configuration for this domain.
+ * @returns The accepted continuation receipt, including whether admission was a duplicate.
+ */
 export declare function acceptAgentResume(input: AgentInput, threadId: string, operationId: OperationId, resolved: ResolvedAgent, options: RouteMaterializationOptions): Promise<{
     operationId: OperationId;
     threadId: string;

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

@@ -1 +1 @@
-{"version":3,"file":"agent-rpc-resume.d.ts","sourceRoot":"","sources":["../src/agent-rpc-resume.ts"],"names":[],"mappings":"AAKA,OAAO,EAA2B,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAC9E,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAC;AAC3E,OAAO,EACL,YAAY,EAEZ,KAAK,UAAU,EAEhB,MAAM,wBAAwB,CAAC;AAKhC,KAAK,aAAa,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC,CAAC;AAE9D,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,UAAU,EACjB,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,WAAW,EACxB,QAAQ,EAAE,aAAa,EACvB,OAAO,EAAE,2BAA2B;;;;;;GAuDrC"}
+{"version":3,"file":"agent-rpc-resume.d.ts","sourceRoot":"","sources":["../src/agent-rpc-resume.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAMjE,OAAO,EAA2B,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAC9E,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAC;AAC3E,OAAO,EAAU,KAAK,UAAU,EAA8B,MAAM,wBAAwB,CAAC;AAI7F,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAChD,OAAO,EAAgB,iBAAiB,EAAwB,MAAM,kBAAkB,CAAC;AAEzF;;;;;;;GAOG;AACH,QAAA,MAAM,MAAM;;;;;;0BA0EG,CAAC;2BAA0B,CAAC;;;;;;;;;;;;;4BATzC,CAAC;;qBAKkB,OAAO,MAAM;;AAHlC,2FAA2F;AAC3F,qBAAa,kBAAmB,SAAQ,uBAGM;CAAG;AAEjD,sFAAsF;AACtF,eAAO,MAAM,sBAAsB,+CAEjC,CAAC;AAEH;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,UAAU,EACjB,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,WAAW,EACxB,QAAQ,EAAE,aAAa,EACvB,OAAO,EAAE,2BAA2B;;;;;;GAOrC"}