@relkit/runtime-hono 0.5.3 → 0.5.5

package/dist/agent-protocol-support.js

@@ -1,5 +1,10 @@
 import { ORPCError } from "@orpc/server";
 import { parseOperationId } from "@relkit/realtime";
+/** Expose a lazy async event source as a cancellable SSE response.
+ * @param events - Lazy event producer receiving reader cancellation.
+ * @param extraHeaders - Additional headers for the SSE response.
+ * @returns An SSE response whose reader cancellation aborts and returns the source.
+ */
 export function eventStream(events, extraHeaders = {}) {
     const encoder = new TextEncoder();
     const aborter = new AbortController();
@@ -30,12 +35,30 @@ export function eventStream(events, extraHeaders = {}) {
         },
     });
 }
+/** Attach an optional replay ID to one SSE payload.
+ * @param data - Public event or error payload.
+ * @param id - Optional event or declaration identifier.
+ * @returns The event data and optional ID.
+ */
 export function serverSentEvent(data, id) {
     return { data, ...(id === undefined ? {} : { id }) };
 }
+/** Encode a journal checkpoint for Last-Event-ID transport.
+ * @param checkpoint - Partitioned journal replay position.
+ * @returns URI-encoded checkpoint JSON.
+ * @example
+ * const checkpoint = { applicationId: "app", environment: "test", profile: "local",
+ *   providerEpoch: "epoch-1", threadId: "thread-1", sequence: "42" };
+ * const replay = parseAgentCursor(encodeAgentCursor(checkpoint));
+ * // replay?.sequence === "42"
+ */
 export function encodeAgentCursor(checkpoint) {
     return encodeURIComponent(JSON.stringify(checkpoint));
 }
+/** Decode and validate a journal checkpoint from Last-Event-ID.
+ * @param value - Value to validate or project.
+ * @returns A valid checkpoint, or undefined for an absent or empty header.
+ */
 export function parseAgentCursor(value) {
     if (value === undefined || value === "")
         return undefined;
@@ -51,10 +74,18 @@ export function parseAgentCursor(value) {
     }
     return parsed;
 }
+/** Serialize an event as one SSE data block with an optional ID.
+ * @param event - Native event to translate.
+ * @returns UTF-8-ready SSE text ending in a blank line.
+ */
 function encodeEvent(event) {
     const id = event.id === undefined ? "" : `id: ${event.id}\n`;
     return `${id}data: ${JSON.stringify(event.data)}\n\n`;
 }
+/** Check checkpoint partition identity and decimal sequence fields.
+ * @param value - Value to validate or project.
+ * @returns Whether the value has every required checkpoint field.
+ */
 function isJournalCheckpoint(value) {
     if (!isRecord(value))
         return false;
@@ -62,6 +93,11 @@ function isJournalCheckpoint(value) {
         typeof value.sequence === "string" &&
         /^(0|[1-9]\d*)$/.test(value.sequence));
 }
+/** Map protocol endpoint failures to stable public HTTP errors.
+ * @param context - Current Hono or RPC request context.
+ * @param action - Native operation or lazy stream producer.
+ * @returns The successful response or a sanitized 4xx/5xx JSON response.
+ */
 export async function protocolEndpoint(context, action) {
     try {
         return await action();
@@ -80,20 +116,38 @@ export async function protocolEndpoint(context, action) {
         return context.json({ error: { id: "AGENT_REQUEST_FAILED" } }, 500);
     }
 }
+/** Require and validate the agent operation ID within its receipt window.
+ * @param context - Current Hono or RPC request context.
+ * @returns The parsed operation ID accepted for the 30-day receipt window.
+ */
 export function operationId(context) {
     const value = context.req.header("x-relkit-operation-id");
     if (value === undefined)
         throw new TypeError("x-relkit-operation-id is required.");
     return parseOperationId(value, { receiptWindowMs: 30 * 86_400_000 });
 }
+/** Find the last user message containing string content.
+ * @param messages - Messages in chronological order.
+ * @returns Its content, or undefined when no matching message exists.
+ */
 export function latestUserText(messages) {
     const message = last(messages, (item) => isRecord(item) && item.role === "user" && typeof item.content === "string");
     return isRecord(message) && typeof message.content === "string" ? message.content : undefined;
 }
+/** Read the first text part from an optional browser message.
+ * @param message - Public diagnostic message or browser message.
+ * @returns The text string when the first text part contains one.
+ */
 export function messageText(message) {
     const part = message?.parts.find((item) => isRecord(item) && item.kind === "text");
     return isRecord(part) && typeof part.text === "string" ? part.text : undefined;
 }
+/** Search backward for the last value matching a predicate.
+ * @typeParam Value - Value produced by the source or selected by the predicate.
+ * @param values - Values in their original order.
+ * @param matches - Predicate selecting a matching value.
+ * @returns The final matching value, or undefined.
+ */
 export function last(values, matches) {
     for (let index = values.length - 1; index >= 0; index -= 1) {
         const value = values[index];
@@ -102,6 +156,10 @@ export function last(values, matches) {
     }
     return undefined;
 }
+/** 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.
+ */
 export function isRecord(value) {
     return value !== null && typeof value === "object";
 }

package/dist/agent-protocol-support.js.map

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

package/dist/agent-protocol-support.types.d.ts

@@ -0,0 +1,6 @@
+/** JSON event payload and optional replay ID serialized as one SSE block. */
+export interface ServerSentEvent {
+    readonly data: unknown;
+    readonly id?: string;
+}
+//# sourceMappingURL=agent-protocol-support.types.d.ts.map

package/dist/agent-protocol-support.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-protocol-support.types.d.ts","sourceRoot":"","sources":["../src/agent-protocol-support.types.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;CACtB"}

package/dist/agent-protocol-support.types.js

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

package/dist/agent-protocol-support.types.js.map

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

package/dist/agent-protocol-tool.d.ts

@@ -1,12 +1,20 @@
-import type { AgentToolEvent, BrowserMessage } from "@relkit/agents";
-import type { AgentProtocolFrame } from "./agent-protocol-stream.js";
-type ToolFrame = Extract<AgentProtocolFrame, {
-    kind: "tool";
-}>;
-type ToolPart = Extract<BrowserMessage["parts"][number], {
-    kind: "tool";
-}>;
+import type { AgentToolEvent } from "@relkit/agents";
+import type { ToolFrame, ToolPart } from "./agent-protocol-tool.types.js";
+/** Map a native tool event to its public tool phase and input delta.
+ * @param event - Native event to translate.
+ * @param inputs - Accumulated tool input text indexed by call ID.
+ * @returns A tool frame while updating the accumulated input text.
+ */
 export declare function toolEventFrame(event: AgentToolEvent, inputs: Map<string, string>): ToolFrame;
+/** Project a tool part and compute only newly received input text.
+ * @param part - Tool message part to project.
+ * @param inputs - Accumulated tool input text indexed by call ID.
+ * @returns A frame retaining tool identity, phase, value and optional input delta.
+ * @example
+ * const inputs = new Map<string, string>([["call-1", "hel"]]);
+ * const frame = toolFrame({ kind: "tool", partId: "part-1", toolCallId: "call-1",
+ *   toolId: "search", state: "input-streaming", inputText: "hello" }, inputs);
+ * // frame.inputDelta === "lo"
+ */
 export declare function toolFrame(part: ToolPart, inputs: Map<string, string>): ToolFrame;
-export {};
 //# sourceMappingURL=agent-protocol-tool.d.ts.map

package/dist/agent-protocol-tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-protocol-tool.d.ts","sourceRoot":"","sources":["../src/agent-protocol-tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAiB,MAAM,gBAAgB,CAAC;AACpF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAErE,KAAK,SAAS,GAAG,OAAO,CAAC,kBAAkB,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAC/D,KAAK,QAAQ,GAAG,OAAO,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAE3E,wBAAgB,cAAc,CAAC,KAAK,EAAE,cAAc,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CA0B5F;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAwChF"}
+{"version":3,"file":"agent-protocol-tool.d.ts","sourceRoot":"","sources":["../src/agent-protocol-tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAiB,MAAM,gBAAgB,CAAC;AACpE,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAE1E;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,cAAc,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CA0B5F;AAED;;;;;;;;;GASG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAwChF"}

package/dist/agent-protocol-tool.js

@@ -1,3 +1,8 @@
+/** Map a native tool event to its public tool phase and input delta.
+ * @param event - Native event to translate.
+ * @param inputs - Accumulated tool input text indexed by call ID.
+ * @returns A tool frame while updating the accumulated input text.
+ */
 export function toolEventFrame(event, inputs) {
     const states = {
         "tool-started": "started",
@@ -22,6 +27,16 @@ export function toolEventFrame(event, inputs) {
                 : {}),
     }, inputs);
 }
+/** Project a tool part and compute only newly received input text.
+ * @param part - Tool message part to project.
+ * @param inputs - Accumulated tool input text indexed by call ID.
+ * @returns A frame retaining tool identity, phase, value and optional input delta.
+ * @example
+ * const inputs = new Map<string, string>([["call-1", "hel"]]);
+ * const frame = toolFrame({ kind: "tool", partId: "part-1", toolCallId: "call-1",
+ *   toolId: "search", state: "input-streaming", inputText: "hello" }, inputs);
+ * // frame.inputDelta === "lo"
+ */
 export function toolFrame(part, inputs) {
     const prior = inputs.get(part.toolCallId);
     if (part.state === "started")

package/dist/agent-protocol-tool.js.map

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

package/dist/agent-protocol-tool.types.d.ts

@@ -0,0 +1,11 @@
+import type { BrowserMessage } from "@relkit/agents";
+import type { AgentProtocolFrame } from "./agent-protocol-stream.js";
+/** Public tool frame containing lifecycle phase and incremental input metadata. */
+export type ToolFrame = Extract<AgentProtocolFrame, {
+    kind: "tool";
+}>;
+/** Persisted browser-message tool part used to recover stream state. */
+export type ToolPart = Extract<BrowserMessage["parts"][number], {
+    kind: "tool";
+}>;
+//# sourceMappingURL=agent-protocol-tool.types.d.ts.map

package/dist/agent-protocol-tool.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-protocol-tool.types.d.ts","sourceRoot":"","sources":["../src/agent-protocol-tool.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAErE,mFAAmF;AACnF,MAAM,MAAM,SAAS,GAAG,OAAO,CAAC,kBAAkB,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAEtE,wEAAwE;AACxE,MAAM,MAAM,QAAQ,GAAG,OAAO,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC"}

package/dist/agent-protocol-tool.types.js

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

package/dist/agent-protocol-tool.types.js.map

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

package/dist/agent-protocol.d.ts

@@ -1,4 +1,9 @@
 import type { Hono } from "hono";
 import type { RouteMaterializationOptions } from "./materialize-routes.js";
+/** Registers the existing agent protocol endpoints over generation-owned execution.
+ * @param app - Hono application receiving the configured endpoints or middleware.
+ * @param options - Application dependencies and configuration for this domain.
+ * @returns Nothing; the requested update is applied to the owned state.
+ */
 export declare function installAgentProtocolEndpoints(app: Hono, options: RouteMaterializationOptions): void;
 //# sourceMappingURL=agent-protocol.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"agent-protocol.d.ts","sourceRoot":"","sources":["../src/agent-protocol.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAW,IAAI,EAAE,MAAM,MAAM,CAAC;AAG1C,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAC;AAmB3E,wBAAgB,6BAA6B,CAC3C,GAAG,EAAE,IAAI,EACT,OAAO,EAAE,2BAA2B,GACnC,IAAI,CAKN"}
+{"version":3,"file":"agent-protocol.d.ts","sourceRoot":"","sources":["../src/agent-protocol.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAW,IAAI,EAAE,MAAM,MAAM,CAAC;AAG1C,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAC;AAmB3E;;;;GAIG;AACH,wBAAgB,6BAA6B,CAC3C,GAAG,EAAE,IAAI,EACT,OAAO,EAAE,2BAA2B,GACnC,IAAI,CAKN"}

package/dist/agent-protocol.js

@@ -8,11 +8,21 @@ import { agentProtocolFrames } from "./agent-protocol-stream.js";
 import { encodeAgentCursor, eventStream, isRecord, latestUserText, operationId, parseAgentCursor, protocolEndpoint, serverSentEvent, } from "./agent-protocol-support.js";
 import { assertAgentCapabilities } from "./agent-capability-negotiation.js";
 const AGENT_STREAM_HEADERS = { [AGENT_CAPABILITY_HEADER]: AGENT_CAPABILITY_VALUE };
+/** Registers the existing agent protocol endpoints over generation-owned execution.
+ * @param app - Hono application receiving the configured endpoints or middleware.
+ * @param options - Application dependencies and configuration for this domain.
+ * @returns Nothing; the requested update is applied to the owned state.
+ */
 export function installAgentProtocolEndpoints(app, options) {
     if (options.agentRuntime === undefined || options.clientIdentity === undefined)
         return;
     app.post("/_relkit/v1/agents/:agentId/ag-ui", (context) => protocolEndpoint(context, () => agUi(context, options)));
 }
+/** Admits an agent request and returns its negotiated AG-UI event stream.
+ * @param context - Trusted Hono or oRPC request context containing request state and authentication.
+ * @param options - Application dependencies and configuration for this domain.
+ * @returns An SSE response containing the negotiated run frames, or a sanitized protocol error response.
+ */
 async function agUi(context, options) {
     assertAgentCapabilities(context.req.raw);
     const body = await context.req.json().catch(() => undefined);
@@ -53,6 +63,12 @@ async function agUi(context, options) {
         }
     }, AGENT_STREAM_HEADERS);
 }
+/** Resumes protocol observation from the supplied checkpoint without owning accepted execution.
+ * @param context - Trusted Hono or oRPC request context containing request state and authentication.
+ * @param options - Application dependencies and configuration for this domain.
+ * @param body - body supplied by the caller.
+ * @returns An SSE response resuming authorized observation from its checkpoint.
+ */
 async function observeAgUi(context, options, body) {
     if (!isRecord(body))
         return context.json({ error: "invalid-agent-request" }, 422);
@@ -82,6 +98,11 @@ async function observeAgUi(context, options, body) {
         }
     }, AGENT_STREAM_HEADERS);
 }
+/** Attaches the observation acknowledgement metadata to a protocol frame.
+ * @param frame - frame supplied by the caller.
+ * @param observation - Observation metadata attached to public protocol frames.
+ * @returns The frame with its observation checkpoint and acknowledgement metadata.
+ */
 function withObservation(frame, observation) {
     if (!isRecord(frame) || observation === undefined)
         return frame;
@@ -89,9 +110,18 @@ function withObservation(frame, observation) {
     const relkit = isRecord(metadata.relkit) ? metadata.relkit : {};
     return { ...frame, metadata: { ...metadata, relkit: { ...relkit, observation } } };
 }
+/** Builds the trusted oRPC context from Hono request state and authentication.
+ * @param context - Trusted Hono or oRPC request context containing request state and authentication.
+ * @param options - Application dependencies and configuration for this domain.
+ * @returns The request's Hono context, state and optional authenticated principal.
+ */
 function rpcContext(context, options) {
     return { hono: context, auth: options.auth?.contextFor(context.req.raw) };
 }
+/** Reads the route agent identifier and rejects a missing value.
+ * @param context - Trusted Hono or oRPC request context containing request state and authentication.
+ * @returns The agent route identifier; missing identifiers throw a public validation error.
+ */
 function requiredAgentId(context) {
     const value = context.req.param("agentId");
     if (value === undefined || value === "")

package/dist/agent-protocol.js.map

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

package/dist/agent-reads.d.ts

@@ -0,0 +1,64 @@
+import { Context, Effect, Layer } 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";
+/** Lists bounded thread summaries after resolving the current principal and authorization.
+ * @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 const listAgentThreadsEffect: (input: AgentInput, context: RpcContext, options: RouteMaterializationOptions) => Effect.Effect<import("@relkit/agents").ThreadList, HttpBoundaryError, never>;
+/** Loads the requested thread and applies browser compatibility projection.
+ * @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 const loadAgentEffect: (input: AgentInput, context: RpcContext, options: RouteMaterializationOptions) => Effect.Effect<import("@relkit/contracts").ThreadSnapshot, HttpBoundaryError, never>;
+/** Looks up an operation receipt in its authorized agent and identity scope.
+ * @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 const lookupAgentReceiptEffect: (input: AgentInput, context: RpcContext, options: RouteMaterializationOptions) => Effect.Effect<{
+    readonly status: "not-found";
+    readonly providerEpoch: string;
+} | {
+    readonly status: "expired";
+    readonly expiredAt: string;
+} | {
+    readonly status: "state-lost";
+    readonly previousEpoch?: string;
+} | {
+    readonly status: "found";
+    readonly receipt: import("@relkit/agents").ContinuationReceipt;
+} | {
+    readonly status: "found";
+    readonly receipt: import("@relkit/agents").ControlReceipt;
+} | {
+    readonly status: "found";
+    readonly receipt: import("@relkit/agents").AcceptRunReceipt | import("@relkit/agents").CompletionReceipt;
+}, HttpBoundaryError, never>;
+/** Reads a bounded immutable snapshot page using its snapshot identifier and cursor.
+ * @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 const readAgentHistoryEffect: (input: AgentInput, context: RpcContext, options: RouteMaterializationOptions) => Effect.Effect<import("@relkit/agents").SnapshotHistoryPage, HttpBoundaryError, never>;
+declare const AgentReads_base: Context.ServiceClass<AgentReads, "@relkit/runtime-hono/AgentReads", {
+    readonly listAgentThreads: typeof listAgentThreadsEffect;
+    readonly loadAgent: typeof loadAgentEffect;
+    readonly lookupAgentReceipt: typeof lookupAgentReceiptEffect;
+    readonly readAgentHistory: typeof readAgentHistoryEffect;
+}>;
+/** Lazy agent domain workflows with typed native failures. */
+export declare class AgentReads extends AgentReads_base {
+}
+/** Live operations; tests can replace the same contract. */
+export declare const AgentReadsLive: Layer.Layer<AgentReads, never, never>;
+export {};
+//# sourceMappingURL=agent-reads.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent-reads.d.ts","sourceRoot":"","sources":["../src/agent-reads.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAChD,OAAO,EAAgB,iBAAiB,EAAe,MAAM,kBAAkB,CAAC;AAGhF,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;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,gKAcjC,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,eAAe,uKAuB1B,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;4BAiEnC,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,yKA+BjC,CAAC;;+BAM4B,OAAO,sBAAsB;wBACpC,OAAO,eAAe;iCACb,OAAO,wBAAwB;+BACjC,OAAO,sBAAsB;;AAP5D,8DAA8D;AAC9D,qBAAa,UAAW,SAAQ,eAQM;CAAG;AAEzC,4DAA4D;AAC5D,eAAO,MAAM,cAAc,uCAQzB,CAAC"}

package/dist/agent-reads.js

@@ -0,0 +1,119 @@
+import { httpValidation } from "./http-validation.js";
+import { Context, Effect, Layer } from "effect";
+import { httpBoundary, HttpBoundaryError, observeHttp } from "./http-effect.js";
+import { REALTIME_RUNTIME_LIMITS } from "@relkit/contracts";
+import { assertExpectedIdentity } from "./rpc-identity.js";
+import { agentContext, requireAgentThreadId } from "./agent-rpc-support.js";
+import { clientAgentSnapshot } from "./agent-compatibility.js";
+/** Lists bounded thread summaries after resolving the current principal and authorization.
+ * @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 const listAgentThreadsEffect = Effect.fn("AgentReads.listAgentThreads")(function* (input, context, options) {
+    yield* httpBoundary("agent.listAgentThreads", () => assertExpectedIdentity(context, options.clientIdentity, input.expectedIdentity));
+    const resolved = yield* httpBoundary("agent.listAgentThreads", () => agentContext(input, context, options, "list"));
+    return yield* httpBoundary("agent.listAgentThreads", () => resolved.provider.listThreads({ ...resolved.scope, limit: 100 }));
+});
+/** Loads the requested thread and applies browser compatibility projection.
+ * @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 const loadAgentEffect = Effect.fn("AgentReads.loadAgent")(function* (input, context, options) {
+    yield* httpBoundary("agent.loadAgent", () => assertExpectedIdentity(context, options.clientIdentity));
+    const threadId = yield* httpValidation("agent.validate", () => requireAgentThreadId(input.threadId));
+    const resolved = yield* httpBoundary("agent.loadAgent", () => agentContext({ ...input, threadId }, context, options, "load"));
+    return clientAgentSnapshot(yield* httpBoundary("agent.loadAgent", () => resolved.provider.loadThread({
+        ...resolved.scope,
+        threadId,
+        maxEncodedBytes: REALTIME_RUNTIME_LIMITS.initialSnapshotBytes,
+    })));
+});
+/** Looks up an operation receipt in its authorized agent and identity scope.
+ * @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 const lookupAgentReceiptEffect = Effect.fn("AgentReads.lookupAgentReceipt")(function* (input, context, options) {
+    yield* httpBoundary("agent.lookupAgentReceipt", () => assertExpectedIdentity(context, options.clientIdentity));
+    if (input.operationId === undefined || input.requestDigest === undefined)
+        return yield* Effect.fail(new HttpBoundaryError({
+            operation: "agent.lookupAgentReceipt",
+            cause: new TypeError("Receipt request is invalid."),
+        }));
+    const { operationId, requestDigest } = input;
+    const resolved = yield* httpBoundary("agent.lookupAgentReceipt", () => agentContext(input, context, options, "receipt"));
+    if (input.kind === "continuation") {
+        const threadId = yield* httpValidation("agent.validate", () => requireAgentThreadId(input.threadId));
+        return yield* httpBoundary("agent.lookupAgentReceipt", () => resolved.provider.lookupContinuationReceipt({
+            ...resolved.scope,
+            operationId,
+            threadId,
+            semanticDigest: requestDigest,
+            now: new Date().toISOString(),
+        }));
+    }
+    if (input.kind === "agent-control") {
+        const threadId = yield* httpValidation("agent.validate", () => requireAgentThreadId(input.threadId));
+        if (input.runId === undefined)
+            return yield* Effect.fail(new HttpBoundaryError({
+                operation: "agent.lookupAgentReceipt",
+                cause: new TypeError("Control receipt request is invalid."),
+            }));
+        const runId = input.runId;
+        return yield* httpBoundary("agent.lookupAgentReceipt", () => resolved.provider.lookupControlReceipt({
+            ...resolved.scope,
+            operationId,
+            threadId,
+            runId,
+            semanticDigest: requestDigest,
+            now: new Date().toISOString(),
+        }));
+    }
+    return yield* httpBoundary("agent.lookupAgentReceipt", () => resolved.provider.lookupRunReceipt({
+        ...resolved.scope,
+        operationId,
+        ...(input.threadId === undefined ? {} : { threadId: input.threadId }),
+        semanticDigest: requestDigest,
+        now: new Date().toISOString(),
+    }));
+});
+/** Reads a bounded immutable snapshot page using its snapshot identifier and cursor.
+ * @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 const readAgentHistoryEffect = Effect.fn("AgentReads.readAgentHistory")(function* (input, context, options) {
+    yield* httpBoundary("agent.readAgentHistory", () => assertExpectedIdentity(context, options.clientIdentity));
+    const threadId = yield* httpValidation("agent.validate", () => requireAgentThreadId(input.threadId));
+    if (input.snapshotId === undefined || input.cursor === undefined)
+        return yield* Effect.fail(new HttpBoundaryError({
+            operation: "agent.readAgentHistory",
+            cause: new TypeError("Snapshot and cursor are required."),
+        }));
+    const { snapshotId, cursor } = input;
+    const resolved = yield* httpBoundary("agent.readAgentHistory", () => agentContext({ ...input, threadId }, context, options, "history"));
+    return yield* httpBoundary("agent.readAgentHistory", () => resolved.provider.readSnapshotHistory({
+        ...resolved.scope,
+        threadId,
+        snapshotId,
+        cursor,
+        maxEncodedBytes: REALTIME_RUNTIME_LIMITS.snapshotHistoryPageBytes,
+    }));
+});
+/** Lazy agent domain workflows with typed native failures. */
+export class AgentReads extends Context.Service()("@relkit/runtime-hono/AgentReads") {
+}
+/** Live operations; tests can replace the same contract. */
+export const AgentReadsLive = Layer.succeed(AgentReads, {
+    listAgentThreads: (...args) => observeHttp("agent.listAgentThreads", listAgentThreadsEffect(...args)),
+    loadAgent: (...args) => observeHttp("agent.loadAgent", loadAgentEffect(...args)),
+    lookupAgentReceipt: (...args) => observeHttp("agent.lookupAgentReceipt", lookupAgentReceiptEffect(...args)),
+    readAgentHistory: (...args) => observeHttp("agent.readAgentHistory", readAgentHistoryEffect(...args)),
+});
+//# sourceMappingURL=agent-reads.js.map

package/dist/agent-reads.js.map

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