@relkit/runtime-hono 0.7.1 → 0.7.4

package/dist/agent-observation-pages.d.ts

@@ -0,0 +1,15 @@
+import { Effect, Option } from "effect";
+import type { AgentObservationFrame, ObservationAuthorize, ObservationPageState } from "./agent-observation.types.js";
+/**
+ * Fetches one page after optional owned wait and current authorization.
+ * @param authorize - Refreshes request identity and provider scope each time.
+ * @param threadId - Already validated requested thread identity.
+ * @param state - Complete decoded page checkpoint and wait policy.
+ * @param signal - Optional native transport cancellation combined with fiber cancellation.
+ * @returns Ordered frames and next state, or typed provider/authorization failure.
+ */
+export declare const readObservationPage: (authorize: ObservationAuthorize, threadId: string, state: ObservationPageState, signal?: AbortSignal | undefined) => Effect.Effect<readonly [AgentObservationFrame[], Option.Option<{
+    after: import("@relkit/contracts").JournalCheckpoint;
+    wait: boolean;
+}>] | readonly [readonly [], Option.Option<ObservationPageState>], import("./http-effect.js").HttpBoundaryError, never>;
+//# sourceMappingURL=agent-observation-pages.d.ts.map

package/dist/agent-observation-pages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-observation-pages.d.ts","sourceRoot":"","sources":["../src/agent-observation-pages.ts"],"names":[],"mappings":"AAOA,OAAO,EAAS,MAAM,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAG/C,OAAO,KAAK,EACV,qBAAqB,EAErB,oBAAoB,EACpB,oBAAoB,EACrB,MAAM,8BAA8B,CAAC;AAEtC;;;;;;;GAOG;AACH,eAAO,MAAM,mBAAmB;;;uHAkD9B,CAAC"}

package/dist/agent-observation-pages.js

@@ -0,0 +1,69 @@
+/**
+ * Reads authorized journal pages and projects bounded public frames. This module
+ * imports the small event projection entrypoint rather than agent execution;
+ * the stream consumer owns waits, cancellation and fresh frame authorization.
+ */
+import { agentClientEvents } from "@relkit/agents/client-events";
+import { REALTIME_RUNTIME_LIMITS } from "@relkit/contracts";
+import { Clock, Effect, Option } from "effect";
+import { httpBoundary, observeHttp } from "./http-effect.js";
+import { clientAgentSnapshot } from "./agent-compatibility.js";
+/**
+ * Fetches one page after optional owned wait and current authorization.
+ * @param authorize - Refreshes request identity and provider scope each time.
+ * @param threadId - Already validated requested thread identity.
+ * @param state - Complete decoded page checkpoint and wait policy.
+ * @param signal - Optional native transport cancellation combined with fiber cancellation.
+ * @returns Ordered frames and next state, or typed provider/authorization failure.
+ */
+export const readObservationPage = Effect.fn("AgentObservation.readPage")(function* (authorize, threadId, state, signal) {
+    if (signal?.aborted)
+        return [[], Option.none()];
+    const resolved = yield* authorize();
+    if (state.wait) {
+        const now = yield* Clock.currentTimeMillis;
+        yield* httpBoundary("agent.observe.wait", (fiberSignal) => resolved.provider.waitForJournal({
+            ...resolved.scope,
+            threadId,
+            after: state.after,
+            deadlineMs: now + 15_000,
+            signal: signal === undefined ? fiberSignal : AbortSignal.any([signal, fiberSignal]),
+        }));
+    }
+    const page = yield* observeHttp("agent.observe.read", httpBoundary("agent.observe.read", () => resolved.provider.readJournal({
+        ...resolved.scope,
+        threadId,
+        after: state.after,
+        limit: 100,
+        maxEncodedBytes: 1024 * 1024,
+    })));
+    const frames = [];
+    if (page.gap !== undefined) {
+        const snapshot = yield* readObservationSnapshot(resolved, threadId);
+        frames.push({ kind: "gap", reason: page.gap, snapshot });
+        return [frames, Option.some({ after: snapshot.checkpoint, wait: false })];
+    }
+    for (const record of page.records)
+        for (const event of agentClientEvents(record))
+            frames.push({ kind: "event", event });
+    if (page.records.some((record) => ["approval", "control", "terminal", "interruption"].includes(record.kind)))
+        frames.push({
+            kind: "snapshot",
+            snapshot: yield* readObservationSnapshot(resolved, threadId),
+        });
+    return [frames, Option.some({ after: page.checkpoint, wait: !page.hasMore })];
+});
+/**
+ * Loads a bounded public snapshot through the already authorized provider scope.
+ * @param resolved - Fresh request identity and provider lease from the current page.
+ * @param threadId - Validated requested thread identity.
+ * @returns Compatibility-projected snapshot or typed native provider failure.
+ */
+const readObservationSnapshot = Effect.fn("AgentObservation.snapshot")(function* (resolved, threadId) {
+    return clientAgentSnapshot(yield* httpBoundary("agent.observe.snapshot", () => resolved.provider.loadThread({
+        ...resolved.scope,
+        threadId,
+        maxEncodedBytes: REALTIME_RUNTIME_LIMITS.initialSnapshotBytes,
+    })));
+});
+//# sourceMappingURL=agent-observation-pages.js.map

package/dist/agent-observation-pages.js.map

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

package/dist/agent-observation.d.ts

@@ -1,31 +1,28 @@
-import { Context, Layer, Stream } from "effect";
-import { HttpBoundaryError } from "./http-effect.js";
+/**
+ * Opens request-owned authorized journal streams through a replaceable Effect
+ * service. The native iterable edge preserves scoped waits and cancellation;
+ * page projection loads no agent execution or language-model runtime.
+ */
+import { Context, Effect, Layer } from "effect";
 import { type AgentInput } from "./agent-rpc-support.js";
 import type { RpcContext } from "./rpc.js";
 import type { RouteMaterializationOptions } from "./materialize-routes.js";
-import type { AgentObservationFrame } from "./agent-observation.types.js";
-/** Builds a journal feed whose waits and iterator scope are owned by its consumer.
- * @param input - Agent identity, thread and required resume checkpoint.
- * @param context - Trusted transport request context.
- * @param options - Active generation and provider configuration.
- * @param signal - Optional transport cancellation signal.
- * @returns A lazy stream with typed native failures and fresh authorization before every frame.
- */
-declare function observation(input: AgentInput, context: RpcContext, options: RouteMaterializationOptions, signal?: AbortSignal): Stream.Stream<AgentObservationFrame, HttpBoundaryError, never>;
-declare const AgentObservation_base: Context.ServiceClass<AgentObservation, "@relkit/runtime-hono/AgentObservation", {
-    readonly observe: typeof observation;
-}>;
-/** Journal observations preserve fresh authorization, bounded pages and cancellable waits. */
+import type { AgentObservationFrame, AgentObservationOperations } from "./agent-observation.types.js";
+declare const AgentObservation_base: Context.ServiceClass<AgentObservation, "@relkit/runtime-hono/AgentObservation", AgentObservationOperations> & {
+    readonly make: Effect.Effect<AgentObservationOperations, never, never>;
+};
+/** Per-request journal observations; service acquisition captures no request context. */
 export declare class AgentObservation extends AgentObservation_base {
 }
-/** Live observation implementation; each consumer owns its stream scope. */
+/** Builds the concrete service; callers can supply the same contract through a test Layer. */
 export declare const AgentObservationLive: Layer.Layer<AgentObservation, never, never>;
-/** Opens an authorized agent journal at the native transport edge.
- * @param input - Agent identity, thread and checkpoint.
+/**
+ * Opens an authorized journal at the native transport edge.
+ * @param input - Submitted agent identity, thread and checkpoint.
  * @param context - Trusted transport context.
- * @param options - Generation dependencies.
- * @param signal - Optional transport cancellation.
- * @returns A lazy iterable; returning releases its pending provider wait.
+ * @param options - Active generation dependencies.
+ * @param signal - Optional native cancellation.
+ * @returns Lazy iterable; returning joins the pending provider wait through its scope.
  */
 export declare function observeAgent(input: AgentInput, context: RpcContext, options: RouteMaterializationOptions, signal?: AbortSignal): AsyncIterable<AgentObservationFrame>;
 export {};

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

@@ -1 +1 @@
-{"version":3,"file":"agent-observation.d.ts","sourceRoot":"","sources":["../src/agent-observation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,OAAO,EAAU,KAAK,EAAU,MAAM,EAAE,MAAM,QAAQ,CAAC;AAGvE,OAAO,EAA8B,iBAAiB,EAAe,MAAM,kBAAkB,CAAC;AAC9F,OAAO,EAAsC,KAAK,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAG7F,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAC;AAC3E,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAG1E;;;;;;GAMG;AACH,iBAAS,WAAW,CAClB,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,UAAU,EACnB,OAAO,EAAE,2BAA2B,EACpC,MAAM,CAAC,EAAE,WAAW,kEA2FrB;;sBAKqB,OAAO,WAAW;;AAHxC,8FAA8F;AAC9F,qBAAa,gBAAiB,SAAQ,qBAGM;CAAG;AAE/C,4EAA4E;AAC5E,eAAO,MAAM,oBAAoB,6CAE/B,CAAC;AAEH;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,UAAU,EACnB,OAAO,EAAE,2BAA2B,EACpC,MAAM,CAAC,EAAE,WAAW,GACnB,aAAa,CAAC,qBAAqB,CAAC,CAMtC"}
+{"version":3,"file":"agent-observation.d.ts","sourceRoot":"","sources":["../src/agent-observation.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAkB,MAAM,QAAQ,CAAC;AAEhE,OAAO,EAAsC,KAAK,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAK7F,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAC;AAC3E,OAAO,KAAK,EACV,qBAAqB,EACrB,0BAA0B,EAC3B,MAAM,8BAA8B,CAAC;;;;AAkDtC,yFAAyF;AACzF,qBAAa,gBAAiB,SAAQ,qBAWpC;CAAG;AAEL,8FAA8F;AAC9F,eAAO,MAAM,oBAAoB,6CAAwD,CAAC;AAE1F;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,UAAU,EACnB,OAAO,EAAE,2BAA2B,EACpC,MAAM,CAAC,EAAE,WAAW,GACnB,aAAa,CAAC,qBAAqB,CAAC,CAMtC"}

package/dist/agent-observation.js

@@ -1,94 +1,60 @@
-import { Clock, Context, Effect, Layer, Option, Stream } from "effect";
-import { agentClientEvents } from "@relkit/agents";
-import { REALTIME_RUNTIME_LIMITS } from "@relkit/contracts";
-import { httpBoundary, httpIterable, HttpBoundaryError, observeHttp } from "./http-effect.js";
+/**
+ * Opens request-owned authorized journal streams through a replaceable Effect
+ * service. The native iterable edge preserves scoped waits and cancellation;
+ * page projection loads no agent execution or language-model runtime.
+ */
+import { Context, Effect, Layer, Schema, Stream } from "effect";
+import { httpBoundary, httpIterable, HttpBoundaryError } from "./http-effect.js";
 import { agentContext, requireAgentThreadId } from "./agent-rpc-support.js";
 import { assertExpectedIdentity } from "./rpc-identity.js";
-import { clientAgentSnapshot } from "./agent-compatibility.js";
+import { ObservationCheckpoint } from "./agent-observation.schemas.js";
+import { readObservationPage } from "./agent-observation-pages.js";
 import { observeHttpStream } from "./http-stream-observation.js";
-/** Builds a journal feed whose waits and iterator scope are owned by its consumer.
- * @param input - Agent identity, thread and required resume checkpoint.
- * @param context - Trusted transport request context.
- * @param options - Active generation and provider configuration.
- * @param signal - Optional transport cancellation signal.
- * @returns A lazy stream with typed native failures and fresh authorization before every frame.
+/**
+ * Builds a journal feed with fresh authorization before pages and frames.
+ * @param input - Request agent/thread identity and submitted checkpoint.
+ * @param context - Trusted transport context for this consumer.
+ * @param options - Active generation and provider authority.
+ * @param signal - Optional native transport cancellation.
+ * @returns Lazy scoped stream with typed boundary failures and decoded cursors.
  */
 function observation(input, context, options, signal) {
     return Stream.unwrap(Effect.gen(function* () {
         const threadId = requireAgentThreadId(input.threadId);
         if (input.after === undefined)
-            return yield* Effect.fail(new HttpBoundaryError({
+            return yield* new HttpBoundaryError({
                 operation: "agent.observe",
                 cause: new TypeError("checkpoint is required."),
-            }));
-        /** Refreshes the principal and checks observation authorization before a page or frame.
-         * @returns The currently authorized agent provider scope.
-         */
+            });
+        /** Refreshes request identity and provider authorization. @returns The current authorized provider scope. */
         const authorize = Effect.fn("AgentObservation.authorize")(function* () {
             yield* httpBoundary("agent.observe.identity", () => assertExpectedIdentity(context, options.clientIdentity, input.expectedIdentity));
             return yield* httpBoundary("agent.observe.authorize", () => agentContext({ ...input, threadId }, context, options, "observe"));
         });
-        const initial = yield* authorize();
-        const checkpoint = input.after;
-        return Stream.paginate({ after: checkpoint, wait: false }, Effect.fn("AgentObservation.readPage")(function* (state) {
-            if (signal?.aborted)
-                return [[], Option.none()];
-            const resolved = yield* authorize();
-            if (state.wait) {
-                const now = yield* Clock.currentTimeMillis;
-                yield* httpBoundary("agent.observe.wait", (fiberSignal) => resolved.provider.waitForJournal({
-                    ...resolved.scope,
-                    threadId,
-                    after: state.after,
-                    deadlineMs: now + 15_000,
-                    signal: signal === undefined ? fiberSignal : AbortSignal.any([signal, fiberSignal]),
-                }));
-            }
-            const page = yield* observeHttp("agent.observe.read", httpBoundary("agent.observe.read", () => resolved.provider.readJournal({
-                ...resolved.scope,
-                threadId,
-                after: state.after,
-                limit: 100,
-                maxEncodedBytes: 1024 * 1024,
-            })));
-            const frames = [];
-            if (page.gap !== undefined) {
-                const snapshot = clientAgentSnapshot(yield* httpBoundary("agent.observe.snapshot", () => resolved.provider.loadThread({
-                    ...resolved.scope,
-                    threadId,
-                    maxEncodedBytes: REALTIME_RUNTIME_LIMITS.initialSnapshotBytes,
-                })));
-                frames.push({ kind: "gap", reason: page.gap, snapshot });
-                return [frames, Option.some({ after: snapshot.checkpoint, wait: false })];
-            }
-            for (const record of page.records)
-                for (const event of agentClientEvents(record))
-                    frames.push({ kind: "event", event });
-            if (page.records.some((record) => ["approval", "control", "terminal", "interruption"].includes(record.kind))) {
-                const snapshot = clientAgentSnapshot(yield* httpBoundary("agent.observe.snapshot", () => resolved.provider.loadThread({
-                    ...resolved.scope,
-                    threadId,
-                    maxEncodedBytes: REALTIME_RUNTIME_LIMITS.initialSnapshotBytes,
-                })));
-                frames.push({ kind: "snapshot", snapshot });
-            }
-            return [frames, Option.some({ after: page.checkpoint, wait: !page.hasMore })];
-        })).pipe(Stream.mapEffect((frame) => authorize().pipe(Effect.as(frame))));
+        yield* authorize();
+        const checkpoint = yield* Schema.decodeUnknownEffect(ObservationCheckpoint)(input.after).pipe(Effect.mapError(() => new HttpBoundaryError({
+            operation: "agent.observe",
+            cause: new TypeError("checkpoint is invalid."),
+        })));
+        return Stream.paginate({ after: checkpoint, wait: false }, (state) => readObservationPage(authorize, threadId, state, signal)).pipe(Stream.mapEffect((frame) => authorize().pipe(Effect.as(frame))));
     }));
 }
-/** Journal observations preserve fresh authorization, bounded pages and cancellable waits. */
-export class AgentObservation extends Context.Service()("@relkit/runtime-hono/AgentObservation") {
+/** Per-request journal observations; service acquisition captures no request context. */
+export class AgentObservation extends Context.Service()("@relkit/runtime-hono/AgentObservation", {
+    make: Effect.sync(() => ({
+        observe: (...args) => observeHttpStream("agent.observe", observation(...args)),
+    })),
+}) {
 }
-/** Live observation implementation; each consumer owns its stream scope. */
-export const AgentObservationLive = Layer.succeed(AgentObservation, {
-    observe: (...args) => observeHttpStream("agent.observe", observation(...args)),
-});
-/** Opens an authorized agent journal at the native transport edge.
- * @param input - Agent identity, thread and checkpoint.
+/** Builds the concrete service; callers can supply the same contract through a test Layer. */
+export const AgentObservationLive = Layer.effect(AgentObservation, AgentObservation.make);
+/**
+ * Opens an authorized journal at the native transport edge.
+ * @param input - Submitted agent identity, thread and checkpoint.
  * @param context - Trusted transport context.
- * @param options - Generation dependencies.
- * @param signal - Optional transport cancellation.
- * @returns A lazy iterable; returning releases its pending provider wait.
+ * @param options - Active generation dependencies.
+ * @param signal - Optional native cancellation.
+ * @returns Lazy iterable; returning joins the pending provider wait through its scope.
  */
 export function observeAgent(input, context, options, signal) {
     return httpIterable(Stream.unwrap(Effect.map(AgentObservation, (service) => service.observe(input, context, options, signal))).pipe(Stream.provide(AgentObservationLive)));

package/dist/agent-observation.js.map

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

package/dist/agent-observation.schemas.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Validates incoming journal checkpoints before observation reaches a provider.
+ * The codec mirrors the owner contract's partition fields and decimal sequence;
+ * authentication remains ahead of this promotion in the request-owned stream.
+ */
+import { Schema } from "effect";
+/** Full journal identity required by provider read/wait methods. */
+export declare const ObservationCheckpoint: Schema.Struct<{
+    readonly applicationId: Schema.String;
+    readonly environment: Schema.String;
+    readonly profile: Schema.String;
+    readonly providerEpoch: Schema.String;
+    readonly threadId: Schema.String;
+    readonly sequence: Schema.String;
+}>;
+//# sourceMappingURL=agent-observation.schemas.d.ts.map

package/dist/agent-observation.schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-observation.schemas.d.ts","sourceRoot":"","sources":["../src/agent-observation.schemas.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAKhC,oEAAoE;AACpE,eAAO,MAAM,qBAAqB;;;;;;;EAOhC,CAAC"}

package/dist/agent-observation.schemas.js

@@ -0,0 +1,18 @@
+/**
+ * Validates incoming journal checkpoints before observation reaches a provider.
+ * The codec mirrors the owner contract's partition fields and decimal sequence;
+ * authentication remains ahead of this promotion in the request-owned stream.
+ */
+import { Schema } from "effect";
+/** Partition names are required nonempty strings, matching the transport cursor guard. */
+const CheckpointIdentity = Schema.String.check(Schema.isMinLength(1));
+/** Full journal identity required by provider read/wait methods. */
+export const ObservationCheckpoint = Schema.Struct({
+    applicationId: CheckpointIdentity,
+    environment: CheckpointIdentity,
+    profile: CheckpointIdentity,
+    providerEpoch: CheckpointIdentity,
+    threadId: CheckpointIdentity,
+    sequence: Schema.String.check(Schema.isPattern(/^(0|[1-9]\d*)$/)),
+});
+//# sourceMappingURL=agent-observation.schemas.js.map

package/dist/agent-observation.schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-observation.schemas.js","sourceRoot":"","sources":["../src/agent-observation.schemas.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,0FAA0F;AAC1F,MAAM,kBAAkB,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;AAEtE,oEAAoE;AACpE,MAAM,CAAC,MAAM,qBAAqB,GAAG,MAAM,CAAC,MAAM,CAAC;IACjD,aAAa,EAAE,kBAAkB;IACjC,WAAW,EAAE,kBAAkB;IAC/B,OAAO,EAAE,kBAAkB;IAC3B,aAAa,EAAE,kBAAkB;IACjC,QAAQ,EAAE,kBAAkB;IAC5B,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAC;CAClE,CAAC,CAAC"}

package/dist/agent-observation.types.d.ts

@@ -1,5 +1,16 @@
-import type { agentClientEvents } from "@relkit/agents";
+/**
+ * Shares precise public frames, page state and per-request authorization between
+ * observation workflows. Checkpoints enter these contracts only after decoding;
+ * live provider/context authority is never persisted or captured across requests.
+ */
+import type { agentClientEvents } from "@relkit/agents/client-events";
+import type { JournalCheckpoint } from "@relkit/contracts";
+import type { Effect, Stream } from "effect";
 import type { agentContext } from "./agent-rpc-support.js";
+import type { AgentInput } from "./agent-rpc-support.js";
+import type { HttpBoundaryError } from "./http-effect.js";
+import type { RpcContext } from "./rpc.js";
+import type { RouteMaterializationOptions } from "./materialize-routes.js";
 import type { clientAgentSnapshot } from "./agent-compatibility.js";
 /** Public observation frames after compatibility projection and fresh authorization. */
 export type AgentObservationFrame = {
@@ -13,4 +24,17 @@ export type AgentObservationFrame = {
     readonly reason: NonNullable<Awaited<ReturnType<Awaited<ReturnType<typeof agentContext>>["provider"]["readJournal"]>>["gap"]>;
     readonly snapshot: ReturnType<typeof clientAgentSnapshot>;
 };
+/** Cursor plus whether the following page must wait for new journal content. */
+export interface ObservationPageState {
+    readonly after: JournalCheckpoint;
+    readonly wait: boolean;
+}
+/** Freshly authorized native provider scope for this request only. */
+export type ObservationAccess = Awaited<ReturnType<typeof agentContext>>;
+/** Reauthorization is repeated before pages and individual emitted frames. */
+export type ObservationAuthorize = () => Effect.Effect<ObservationAccess, HttpBoundaryError>;
+/** Stream service contract shared by live implementation and deterministic test Layers. */
+export interface AgentObservationOperations {
+    readonly observe: (input: AgentInput, context: RpcContext, options: RouteMaterializationOptions, signal?: AbortSignal) => Stream.Stream<AgentObservationFrame, HttpBoundaryError>;
+}
 //# sourceMappingURL=agent-observation.types.d.ts.map

package/dist/agent-observation.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-observation.types.d.ts","sourceRoot":"","sources":["../src/agent-observation.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAEpE,wFAAwF;AACxF,MAAM,MAAM,qBAAqB,GAC7B;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAA;CAAE,GACxF;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAA;CAAE,GACxF;IACE,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAC1B,OAAO,CACL,UAAU,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,aAAa,CAAC,CAAC,CAChF,CAAC,KAAK,CAAC,CACT,CAAC;IACF,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC;CAC3D,CAAC"}
+{"version":3,"file":"agent-observation.types.d.ts","sourceRoot":"","sources":["../src/agent-observation.types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACtE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC7C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAC;AAC3E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAEpE,wFAAwF;AACxF,MAAM,MAAM,qBAAqB,GAC7B;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAA;CAAE,GACxF;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAA;CAAE,GACxF;IACE,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAC1B,OAAO,CACL,UAAU,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,aAAa,CAAC,CAAC,CAChF,CAAC,KAAK,CAAC,CACT,CAAC;IACF,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC;CAC3D,CAAC;AAEN,gFAAgF;AAChF,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,KAAK,EAAE,iBAAiB,CAAC;IAClC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;CACxB;AAED,sEAAsE;AACtE,MAAM,MAAM,iBAAiB,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC,CAAC;AAEzE,8EAA8E;AAC9E,MAAM,MAAM,oBAAoB,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,iBAAiB,EAAE,iBAAiB,CAAC,CAAC;AAE7F,2FAA2F;AAC3F,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,OAAO,EAAE,CAChB,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,UAAU,EACnB,OAAO,EAAE,2BAA2B,EACpC,MAAM,CAAC,EAAE,WAAW,KACjB,MAAM,CAAC,MAAM,CAAC,qBAAqB,EAAE,iBAAiB,CAAC,CAAC;CAC9D"}

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

@@ -0,0 +1,80 @@
+/**
+ * Performs durable duplicate lookup and revision-fenced continuation admission.
+ * The caller supplies authorized request/provider scope; validators load through
+ * their narrow entrypoint and accepted execution stays owned by generation tasks.
+ */
+import { type OperationId } from "@relkit/contracts";
+import { Effect } from "effect";
+import { HttpBoundaryError } from "./http-effect.js";
+import { type AgentInput } from "./agent-rpc-support.js";
+import type { RouteMaterializationOptions } from "./materialize-routes.js";
+/**
+ * Recovers an already admitted receipt without creating a second continuation.
+ * @param input - Submitted payload used only to resume an existing accepted run.
+ * @param threadId - Authorized durable thread identity.
+ * @param operationId - Stable idempotency identity.
+ * @param resolved - Current descriptor/provider authority.
+ * @param options - Generation task owner and execution dependencies.
+ * @param requestDigest - Verified request identity for duplicate comparison.
+ * @returns Existing accepted receipt or typed missing-continuation rejection.
+ */
+export declare const lookupAgentContinuation: (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, requestDigest: string) => Effect.Effect<{
+    operationId: OperationId;
+    threadId: string;
+    runId: string;
+    status: "accepted";
+    duplicate: boolean;
+}, HttpBoundaryError, never>;
+/**
+ * Validates the waiting revision and reply before joining and admitting a new run.
+ * @param input - Submitted revision and reply.
+ * @param threadId - Authorized durable thread identity.
+ * @param operationId - Stable idempotency identity.
+ * @param resolved - Current descriptor/provider authority.
+ * @param options - Owning generation dependencies.
+ * @param requestDigest - Verified request digest for durable admission.
+ * @param waiting - Provider-owned waiting state, never a caller assertion.
+ * @returns Accepted receipt after the interrupted run joins; typed failures preserve fencing.
+ */
+export declare const admitAgentContinuation: (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, requestDigest: string, waiting: import("@relkit/contracts").AgentWaitingState) => Effect.Effect<{
+    operationId: OperationId;
+    threadId: string;
+    runId: string;
+    status: "accepted";
+    duplicate: boolean;
+}, HttpBoundaryError, never>;
+/**
+ * Retains the existing public validation failure at the native compatibility edge.
+ * @param message - Fixed public validation message.
+ * @returns Typed failure retaining the original public TypeError.
+ */
+export declare function resumeError(message: string): HttpBoundaryError;
+//# sourceMappingURL=agent-rpc-resume-admission.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent-rpc-resume-admission.d.ts","sourceRoot":"","sources":["../src/agent-rpc-resume-admission.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAA2B,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAE9E,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAgB,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACnE,OAAO,EAAU,KAAK,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAGjE,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAC;AAG3E;;;;;;;;;GASG;AACH,eAAO,MAAM,uBAAuB;;;;;;0BAmEc,CAAC;2BAEnD,CAAA;;;;;;;;;;;;;4BAhDE,CAAC;AAEH;;;;;;;;;;GAUG;AACH,eAAO,MAAM,sBAAsB;;;;;;0BAiCe,CAAC;2BAEnD,CAAA;;;;;;;;;;;;;4BAAE,CAAC;AAEH;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,iBAAiB,CAE9D"}

package/dist/agent-rpc-resume-admission.js

@@ -0,0 +1,95 @@
+/**
+ * Performs durable duplicate lookup and revision-fenced continuation admission.
+ * The caller supplies authorized request/provider scope; validators load through
+ * their narrow entrypoint and accepted execution stays owned by generation tasks.
+ */
+import { REALTIME_RUNTIME_LIMITS } from "@relkit/contracts";
+import { Effect } from "effect";
+import { httpBoundary, HttpBoundaryError } from "./http-effect.js";
+import { digest } from "./agent-rpc-support.js";
+import { startAgentRun } from "./agent-rpc-worker.js";
+import { waitForAgentRun } from "./agent-run-tasks.js";
+/**
+ * Recovers an already admitted receipt without creating a second continuation.
+ * @param input - Submitted payload used only to resume an existing accepted run.
+ * @param threadId - Authorized durable thread identity.
+ * @param operationId - Stable idempotency identity.
+ * @param resolved - Current descriptor/provider authority.
+ * @param options - Generation task owner and execution dependencies.
+ * @param requestDigest - Verified request identity for duplicate comparison.
+ * @returns Existing accepted receipt or typed missing-continuation rejection.
+ */
+export const lookupAgentContinuation = Effect.fn("AgentContinuations.lookup")(function* (input, threadId, operationId, resolved, options, requestDigest) {
+    const prior = yield* httpBoundary("agent.resume.receipt", () => resolved.provider.lookupContinuationReceipt({
+        ...resolved.scope,
+        operationId,
+        threadId,
+        semanticDigest: requestDigest,
+        now: new Date().toISOString(),
+    }));
+    if (prior.status !== "found")
+        return yield* resumeError("Agent has no waiting continuation.");
+    const accepted = asAcceptedRun({ ...prior.receipt, duplicate: true });
+    startAgentRun(resolved, accepted, input.payload, options, true);
+    return accepted;
+});
+/**
+ * Validates the waiting revision and reply before joining and admitting a new run.
+ * @param input - Submitted revision and reply.
+ * @param threadId - Authorized durable thread identity.
+ * @param operationId - Stable idempotency identity.
+ * @param resolved - Current descriptor/provider authority.
+ * @param options - Owning generation dependencies.
+ * @param requestDigest - Verified request digest for durable admission.
+ * @param waiting - Provider-owned waiting state, never a caller assertion.
+ * @returns Accepted receipt after the interrupted run joins; typed failures preserve fencing.
+ */
+export const admitAgentContinuation = Effect.fn("AgentContinuations.admit")(function* (input, threadId, operationId, resolved, options, requestDigest, waiting) {
+    if (input.waitingRevision !== waiting.revision)
+        return yield* resumeError("Agent waiting revision is stale.");
+    const reply = yield* httpBoundary("agent.resume.validate", async () => {
+        const validators = await import("@relkit/agents/continuation-validation");
+        return validators.isGraphDescriptor(resolved.descriptor)
+            ? validators.validateGraphResumeInput(resolved.descriptor, waiting.requests, input.payload)
+            : validators.validateNativeAgentResumeInput(waiting.requests, input.payload);
+    }).pipe(Effect.mapError(() => resumeError("Agent resume input validation failed.")));
+    yield* httpBoundary("agent.resume.join", () => waitForAgentRun(waiting.runId));
+    const continuation = yield* httpBoundary("agent.resume.admit", () => resolved.provider.admitContinuation({
+        ...resolved.scope,
+        kind: "resume",
+        operationId,
+        semanticDigest: requestDigest,
+        threadId,
+        interruptedRunId: waiting.runId,
+        interruptSetDigest: digest(waiting),
+        waitingRevision: waiting.revision,
+        admittedAt: new Date().toISOString(),
+        receiptExpiresAt: new Date(Date.now() + REALTIME_RUNTIME_LIMITS.agentReceiptMs).toISOString(),
+    }));
+    const accepted = asAcceptedRun(continuation);
+    startAgentRun(resolved, accepted, reply, options, true);
+    return accepted;
+});
+/**
+ * Retains the existing public validation failure at the native compatibility edge.
+ * @param message - Fixed public validation message.
+ * @returns Typed failure retaining the original public TypeError.
+ */
+export function resumeError(message) {
+    return new HttpBoundaryError({ operation: "agent.resume", cause: new TypeError(message) });
+}
+/**
+ * Projects a provider continuation receipt to the existing accepted-run response.
+ * @param continuation - Provider-owned durable receipt, including duplicate status.
+ * @returns Complete accepted run identity with the existing status discriminant.
+ */
+function asAcceptedRun(continuation) {
+    return {
+        operationId: continuation.operationId,
+        threadId: continuation.threadId,
+        runId: continuation.runId,
+        status: "accepted",
+        duplicate: continuation.duplicate,
+    };
+}
+//# sourceMappingURL=agent-rpc-resume-admission.js.map

package/dist/agent-rpc-resume-admission.js.map

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