@relkit/runtime-hono 0.7.2 → 0.7.6

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

@@ -1,60 +1,30 @@
-import type { ResolvedAgent } from "./agent-rpc-resume.types.js";
+/**
+ * Owns request-level continuation admission through a replaceable Effect service.
+ * Authorization remains supplied by the request; durable lookup, validation and
+ * generation-owned execution use the narrow admission helpers without agent runtime imports.
+ */
 import { type OperationId } from "@relkit/contracts";
-import type { RouteMaterializationOptions } from "./materialize-routes.js";
-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. */
+import { type AgentInput } from "./agent-rpc-support.js";
+import type { RouteMaterializationOptions } from "./materialize-routes.js";
+import type { AgentContinuationOperations, ResolvedAgent } from "./agent-rpc-resume.types.js";
+declare const AgentContinuations_base: Context.ServiceClass<AgentContinuations, "@relkit/runtime-hono/AgentContinuations", AgentContinuationOperations> & {
+    readonly make: Effect.Effect<AgentContinuationOperations, never, never>;
+};
+/** Continuation admission authority captures no per-request authorization during acquisition. */
 export declare class AgentContinuations extends AgentContinuations_base {
 }
-/** Live continuation admission preserves receipt idempotency and revision fencing. */
+/** Builds the concrete continuation service; tests replace the same contract through a Layer. */
 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.
+/**
+ * Runs durable continuation admission at the native oRPC edge.
+ * @param input - Submitted operation input; caller already owns request authorization.
+ * @param threadId - Authorized durable thread identity.
+ * @param operationId - Stable admission/duplicate lookup identity.
+ * @param resolved - Fresh descriptor/provider authority.
+ * @param options - Owning generation dependencies.
+ * @returns Accepted durable receipt, including duplicate status, or original public failure.
  */
-export declare function acceptAgentResume(input: AgentInput, threadId: string, operationId: OperationId, resolved: ResolvedAgent, options: RouteMaterializationOptions): Promise<{
-    operationId: OperationId;
-    threadId: string;
-    runId: string;
-    status: "accepted";
-    duplicate: boolean;
-}>;
+export declare function acceptAgentResume(input: AgentInput, threadId: string, operationId: OperationId, resolved: ResolvedAgent, options: RouteMaterializationOptions): Promise<import("@relkit/agents").AcceptRunReceipt>;
 export {};
 //# sourceMappingURL=agent-rpc-resume.d.ts.map

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":"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"}
+{"version":3,"file":"agent-rpc-resume.d.ts","sourceRoot":"","sources":["../src/agent-rpc-resume.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAA2B,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAC9E,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAIhD,OAAO,EAA8B,KAAK,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAMrF,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAC;AAC3E,OAAO,KAAK,EAAE,2BAA2B,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;;;;AAoD9F,iGAAiG;AACjG,qBAAa,kBAAmB,SAAQ,uBAWtC;CAAG;AAEL,iGAAiG;AACjG,eAAO,MAAM,sBAAsB,+CAA4D,CAAC;AAEhG;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,UAAU,EACjB,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,WAAW,EACxB,QAAQ,EAAE,aAAa,EACvB,OAAO,EAAE,2BAA2B,sDAOrC"}

package/dist/agent-rpc-resume.js

@@ -1,24 +1,27 @@
-import { httpValidation } from "./http-validation.js";
-import { isGraphDescriptor, validateGraphResumeInput, validateNativeAgentResumeInput, } from "@relkit/agents";
+/**
+ * Owns request-level continuation admission through a replaceable Effect service.
+ * Authorization remains supplied by the request; durable lookup, validation and
+ * generation-owned execution use the narrow admission helpers without agent runtime imports.
+ */
 import { REALTIME_RUNTIME_LIMITS } from "@relkit/contracts";
-import { digest, verifiedAgentRequestDigest } from "./agent-rpc-support.js";
-import { startAgentRun } from "./agent-rpc-worker.js";
-import { waitForAgentRun } from "./agent-run-tasks.js";
-import { assertAgentRunWritable } from "./agent-compatibility.js";
 import { Context, Effect, Layer } from "effect";
-import { httpBoundary, HttpBoundaryError, observeHttp, runHttp } 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.
+import { httpValidation } from "./http-validation.js";
+import { httpBoundary, observeHttp, runHttp } from "./http-effect.js";
+import { assertAgentRunWritable } from "./agent-compatibility.js";
+import { verifiedAgentRequestDigest } from "./agent-rpc-support.js";
+import { admitAgentContinuation, lookupAgentContinuation, resumeError, } from "./agent-rpc-resume-admission.js";
+/**
+ * Admits a resume after provider snapshot validation and interrupted-run joining.
+ * @param input - Submitted payload and observed revision.
+ * @param threadId - Authorized durable thread identity.
+ * @param operationId - Stable continuation idempotency identity.
+ * @param resolved - Fresh request descriptor/provider authority.
  * @param options - Generation and runtime dependencies.
- * @returns The accepted continuation receipt, including whether admission was a duplicate.
+ * @returns Lazy accepted receipt or typed public transport failure.
  */
 const resume = Effect.fn("AgentContinuations.resume")(function* (input, threadId, operationId, resolved, options) {
-    if (typeof input.waitingRevision !== "string" || input.waitingRevision.length === 0) {
-        return yield* Effect.fail(resumeError("Agent resume requires the observed waiting revision."));
-    }
+    if (typeof input.waitingRevision !== "string" || input.waitingRevision.length === 0)
+        return yield* resumeError("Agent resume requires the observed waiting revision.");
     const requestDigest = yield* httpValidation("agent.validate", () => verifiedAgentRequestDigest(input));
     const snapshot = yield* httpBoundary("agent.resume.snapshot", () => resolved.provider.loadThread({
         ...resolved.scope,
@@ -27,80 +30,29 @@ const resume = Effect.fn("AgentContinuations.resume")(function* (input, threadId
     }));
     const waiting = snapshot.waiting;
     yield* httpValidation("agent.validate", () => assertAgentRunWritable(snapshot, waiting?.runId));
-    if (waiting === undefined) {
-        const prior = yield* httpBoundary("agent.resume.receipt", () => resolved.provider.lookupContinuationReceipt({
-            ...resolved.scope,
-            operationId,
-            threadId,
-            semanticDigest: requestDigest,
-            now: new Date().toISOString(),
-        }));
-        if (prior.status === "found") {
-            const accepted = asAcceptedRun({ ...prior.receipt, duplicate: true });
-            startAgentRun(resolved, accepted, input.payload, options, true);
-            return accepted;
-        }
-        return yield* Effect.fail(resumeError("Agent has no waiting continuation."));
-    }
-    if (input.waitingRevision !== waiting.revision) {
-        return yield* Effect.fail(resumeError("Agent waiting revision is stale."));
-    }
-    const reply = yield* httpBoundary("agent.resume.validate", async () => isGraphDescriptor(resolved.descriptor)
-        ? validateGraphResumeInput(resolved.descriptor, waiting.requests, input.payload)
-        : 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;
+    if (waiting === undefined)
+        return yield* lookupAgentContinuation(input, threadId, operationId, resolved, options, requestDigest);
+    return yield* admitAgentContinuation(input, threadId, operationId, resolved, options, requestDigest, waiting);
 });
-/** Admits resumptions only after the prior run and its durable waiting revision settle. */
-export class AgentContinuations extends Context.Service()("@relkit/runtime-hono/AgentContinuations") {
+/** Continuation admission authority captures no per-request authorization during acquisition. */
+export class AgentContinuations extends Context.Service()("@relkit/runtime-hono/AgentContinuations", {
+    make: Effect.sync(() => ({
+        resume: (...args) => observeHttp("agent.resume", resume(...args)),
+    })),
+}) {
 }
-/** Live continuation admission preserves receipt idempotency and revision fencing. */
-export const AgentContinuationsLive = Layer.succeed(AgentContinuations, {
-    resume: (...args) => observeHttp("agent.resume", resume(...args)),
-});
-/** 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.
+/** Builds the concrete continuation service; tests replace the same contract through a Layer. */
+export const AgentContinuationsLive = Layer.effect(AgentContinuations, AgentContinuations.make);
+/**
+ * Runs durable continuation admission at the native oRPC edge.
+ * @param input - Submitted operation input; caller already owns request authorization.
+ * @param threadId - Authorized durable thread identity.
+ * @param operationId - Stable admission/duplicate lookup identity.
+ * @param resolved - Fresh descriptor/provider authority.
+ * @param options - Owning generation dependencies.
+ * @returns Accepted durable receipt, including duplicate status, or original public failure.
  */
 export function acceptAgentResume(input, threadId, operationId, resolved, options) {
     return runHttp(Effect.flatMap(AgentContinuations, (service) => service.resume(input, threadId, operationId, resolved, options)).pipe(Effect.provide(AgentContinuationsLive)));
 }
-/** Retains the original validation exception at the public Promise boundary.
- * @param message - Public message included in the resulting value or failure.
- * @returns A typed boundary failure retaining the original public TypeError.
- */
-function resumeError(message) {
-    return new HttpBoundaryError({ operation: "agent.resume", cause: new TypeError(message) });
-}
-/** Projects a continuation receipt into the existing accepted-run response.
- * @param continuation - Durable continuation receipt projected into accepted-run form.
- * @returns An accepted run response retaining operation, thread, run and duplicate fields.
- */
-function asAcceptedRun(continuation) {
-    return {
-        operationId: continuation.operationId,
-        threadId: continuation.threadId,
-        runId: continuation.runId,
-        status: "accepted",
-        duplicate: continuation.duplicate,
-    };
-}
 //# sourceMappingURL=agent-rpc-resume.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"agent-rpc-resume.js","sourceRoot":"","sources":["../src/agent-rpc-resume.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,OAAO,EACL,iBAAiB,EACjB,wBAAwB,EACxB,8BAA8B,GAC/B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,uBAAuB,EAAoB,MAAM,mBAAmB,CAAC;AAE9E,OAAO,EAAE,MAAM,EAAmB,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AAC7F,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAEzF;;;;;;;GAOG;AACH,MAAM,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC,2BAA2B,CAAC,CAAC,QAAQ,CAAC,EAC7D,KAAiB,EACjB,QAAgB,EAChB,WAAwB,EACxB,QAAuB,EACvB,OAAoC;IAEpC,IAAI,OAAO,KAAK,CAAC,eAAe,KAAK,QAAQ,IAAI,KAAK,CAAC,eAAe,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACpF,OAAO,KAAK,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,sDAAsD,CAAC,CAAC,CAAC;IACjG,CAAC;IACD,MAAM,aAAa,GAAG,KAAK,CAAC,CAAC,cAAc,CAAC,gBAAgB,EAAE,GAAG,EAAE,CACjE,0BAA0B,CAAC,KAAK,CAAC,CAClC,CAAC;IACF,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,YAAY,CAAC,uBAAuB,EAAE,GAAG,EAAE,CACjE,QAAQ,CAAC,QAAQ,CAAC,UAAU,CAAC;QAC3B,GAAG,QAAQ,CAAC,KAAK;QACjB,QAAQ;QACR,eAAe,EAAE,uBAAuB,CAAC,oBAAoB;KAC9D,CAAC,CACH,CAAC;IACF,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC;IACjC,KAAK,CAAC,CAAC,cAAc,CAAC,gBAAgB,EAAE,GAAG,EAAE,CAAC,sBAAsB,CAAC,QAAQ,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;IAChG,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,YAAY,CAAC,sBAAsB,EAAE,GAAG,EAAE,CAC7D,QAAQ,CAAC,QAAQ,CAAC,yBAAyB,CAAC;YAC1C,GAAG,QAAQ,CAAC,KAAK;YACjB,WAAW;YACX,QAAQ;YACR,cAAc,EAAE,aAAa;YAC7B,GAAG,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SAC9B,CAAC,CACH,CAAC;QACF,IAAI,KAAK,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;YAC7B,MAAM,QAAQ,GAAG,aAAa,CAAC,EAAE,GAAG,KAAK,CAAC,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACtE,aAAa,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;YAChE,OAAO,QAAQ,CAAC;QAClB,CAAC;QACD,OAAO,KAAK,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,oCAAoC,CAAC,CAAC,CAAC;IAC/E,CAAC;IACD,IAAI,KAAK,CAAC,eAAe,KAAK,OAAO,CAAC,QAAQ,EAAE,CAAC;QAC/C,OAAO,KAAK,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,kCAAkC,CAAC,CAAC,CAAC;IAC7E,CAAC;IACD,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,YAAY,CAAC,uBAAuB,EAAE,KAAK,IAAI,EAAE,CACpE,iBAAiB,CAAC,QAAQ,CAAC,UAAU,CAAC;QACpC,CAAC,CAAC,wBAAwB,CAAC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC;QAChF,CAAC,CAAC,8BAA8B,CAAC,OAAO,CAAC,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,CACpE,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC,WAAW,CAAC,uCAAuC,CAAC,CAAC,CAAC,CAAC;IACpF,KAAK,CAAC,CAAC,YAAY,CAAC,mBAAmB,EAAE,GAAG,EAAE,CAAC,eAAe,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;IAC/E,MAAM,YAAY,GAAG,KAAK,CAAC,CAAC,YAAY,CAAC,oBAAoB,EAAE,GAAG,EAAE,CAClE,QAAQ,CAAC,QAAQ,CAAC,iBAAiB,CAAC;QAClC,GAAG,QAAQ,CAAC,KAAK;QACjB,IAAI,EAAE,QAAQ;QACd,WAAW;QACX,cAAc,EAAE,aAAa;QAC7B,QAAQ;QACR,gBAAgB,EAAE,OAAO,CAAC,KAAK;QAC/B,kBAAkB,EAAE,MAAM,CAAC,OAAO,CAAC;QACnC,eAAe,EAAE,OAAO,CAAC,QAAQ;QACjC,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACpC,gBAAgB,EAAE,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,uBAAuB,CAAC,cAAc,CAAC,CAAC,WAAW,EAAE;KAC9F,CAAC,CACH,CAAC;IACF,MAAM,QAAQ,GAAG,aAAa,CAAC,YAAY,CAAC,CAAC;IAC7C,aAAa,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IACxD,OAAO,QAAQ,CAAC;AAClB,CAAC,CAAC,CAAC;AAEH,2FAA2F;AAC3F,MAAM,OAAO,kBAAmB,SAAQ,OAAO,CAAC,OAAO,EAGpD,CAAC,yCAAyC,CAAC;CAAG;AAEjD,sFAAsF;AACtF,MAAM,CAAC,MAAM,sBAAsB,GAAG,KAAK,CAAC,OAAO,CAAC,kBAAkB,EAAE;IACtE,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,EAAE,CAAC,WAAW,CAAC,cAAc,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC;CAClE,CAAC,CAAC;AAEH;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAC/B,KAAiB,EACjB,QAAgB,EAChB,WAAwB,EACxB,QAAuB,EACvB,OAAoC;IAEpC,OAAO,OAAO,CACZ,MAAM,CAAC,OAAO,CAAC,kBAAkB,EAAE,CAAC,OAAO,EAAE,EAAE,CAC7C,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,QAAQ,EAAE,OAAO,CAAC,CAChE,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,sBAAsB,CAAC,CAAC,CAC/C,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,SAAS,WAAW,CAAC,OAAe;IAClC,OAAO,IAAI,iBAAiB,CAAC,EAAE,SAAS,EAAE,cAAc,EAAE,KAAK,EAAE,IAAI,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;AAC7F,CAAC;AAED;;;GAGG;AACH,SAAS,aAAa,CAAC,YAKtB;IACC,OAAO;QACL,WAAW,EAAE,YAAY,CAAC,WAAW;QACrC,QAAQ,EAAE,YAAY,CAAC,QAAQ;QAC/B,KAAK,EAAE,YAAY,CAAC,KAAK;QACzB,MAAM,EAAE,UAAmB;QAC3B,SAAS,EAAE,YAAY,CAAC,SAAS;KAClC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"agent-rpc-resume.js","sourceRoot":"","sources":["../src/agent-rpc-resume.ts"],"names":[],"mappings":"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"}

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

@@ -1,4 +1,20 @@
-import type { agentContext } from "./agent-rpc-support.js";
+/**
+ * Defines request-owned continuation admission contracts. Provider and descriptor
+ * authority come from authorization; service methods return durable accepted
+ * receipts and preserve typed transport failures without retaining request scope.
+ */
+import type { Effect } from "effect";
+import type { OperationId } from "@relkit/contracts";
+import type { AcceptRunReceipt } from "@relkit/agents";
+import type { HttpBoundaryError } from "./http-effect.js";
+import type { RouteMaterializationOptions } from "./materialize-routes.js";
+import type { AgentInput, agentContext } from "./agent-rpc-support.js";
 /** Authorized agent descriptor, provider and immutable durable request scope. */
 export type ResolvedAgent = Awaited<ReturnType<typeof agentContext>>;
+/** Waiting revision is accepted only from the authorized provider snapshot. */
+export type WaitingAgentContinuation = NonNullable<Awaited<ReturnType<ResolvedAgent["provider"]["loadThread"]>>["waiting"]>;
+/** Replaceable continuation service; each call supplies fresh request authority. */
+export interface AgentContinuationOperations {
+    readonly resume: (input: AgentInput, threadId: string, operationId: OperationId, resolved: ResolvedAgent, options: RouteMaterializationOptions) => Effect.Effect<AcceptRunReceipt, HttpBoundaryError>;
+}
 //# sourceMappingURL=agent-rpc-resume.types.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"agent-rpc-resume.types.d.ts","sourceRoot":"","sources":["../src/agent-rpc-resume.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAE3D,iFAAiF;AACjF,MAAM,MAAM,aAAa,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC,CAAC"}
+{"version":3,"file":"agent-rpc-resume.types.d.ts","sourceRoot":"","sources":["../src/agent-rpc-resume.types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACrC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAC;AAC3E,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAEvE,iFAAiF;AACjF,MAAM,MAAM,aAAa,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC,CAAC;AAErE,+EAA+E;AAC/E,MAAM,MAAM,wBAAwB,GAAG,WAAW,CAChD,OAAO,CAAC,UAAU,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CACxE,CAAC;AAEF,oFAAoF;AACpF,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,MAAM,EAAE,CACf,KAAK,EAAE,UAAU,EACjB,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,WAAW,EACxB,QAAQ,EAAE,aAAa,EACvB,OAAO,EAAE,2BAA2B,KACjC,MAAM,CAAC,MAAM,CAAC,gBAAgB,EAAE,iBAAiB,CAAC,CAAC;CACzD"}

package/dist/api-docs-auth.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Combines application and mounted auth metadata for the shared API document.
+ * Application servers/security remain authoritative; conflicting paths or
+ * component names throw before publishing a misleading document.
+ */
+import { type JsonValue } from "@relkit/contracts";
+import type { OpenApiDocument } from "@relkit/openapi";
+/**
+ * Merges mounted native auth routes without changing application servers or security.
+ * @param document - Application document whose policy and description are preserved.
+ * @param auth - Mounted auth paths and namespaced components.
+ * @returns A detached document with authentication instructions and deduplicated tags.
+ * @throws TypeError When JSON metadata is invalid or path/component names collide.
+ */
+export declare function mergeAuthDocument(document: OpenApiDocument | JsonValue, auth: JsonValue): JsonValue;
+//# sourceMappingURL=api-docs-auth.d.ts.map

package/dist/api-docs-auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-docs-auth.d.ts","sourceRoot":"","sources":["../src/api-docs-auth.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAmB,KAAK,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACpE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEvD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,eAAe,GAAG,SAAS,EACrC,IAAI,EAAE,SAAS,GACd,SAAS,CAiCX"}

package/dist/api-docs-auth.js

@@ -0,0 +1,92 @@
+/**
+ * Combines application and mounted auth metadata for the shared API document.
+ * Application servers/security remain authoritative; conflicting paths or
+ * component names throw before publishing a misleading document.
+ */
+import { assertJsonValue } from "@relkit/contracts";
+/**
+ * Merges mounted native auth routes without changing application servers or security.
+ * @param document - Application document whose policy and description are preserved.
+ * @param auth - Mounted auth paths and namespaced components.
+ * @returns A detached document with authentication instructions and deduplicated tags.
+ * @throws TypeError When JSON metadata is invalid or path/component names collide.
+ */
+export function mergeAuthDocument(document, auth) {
+    assertJsonValue(document);
+    if (!isRecord(document) || !isRecord(auth) || !isRecord(auth.paths))
+        throw new TypeError("Cannot merge an invalid authentication OpenAPI document");
+    const paths = isRecord(document.paths) ? document.paths : {};
+    for (const path of Object.keys(auth.paths)) {
+        if (Object.hasOwn(paths, path))
+            throw new TypeError(`Duplicate authentication OpenAPI path: ${path}`);
+    }
+    const info = isRecord(document.info) ? document.info : {};
+    const tags = [
+        ...(Array.isArray(document.tags) ? document.tags : []),
+        ...(Array.isArray(auth.tags) ? auth.tags : []),
+    ];
+    return {
+        ...document,
+        info: {
+            ...info,
+            description: [
+                typeof info.description === "string" ? info.description : "",
+                authInstructions(auth.paths),
+            ]
+                .filter(Boolean)
+                .join("\n\n"),
+        },
+        paths: { ...paths, ...auth.paths },
+        components: mergeComponents(document.components, auth.components),
+        tags: tags.filter((tag, index) => !isRecord(tag) ||
+            tags.findIndex((entry) => isRecord(entry) && entry.name === tag.name) === index),
+    };
+}
+/**
+ * Preserves application components while rejecting ambiguous native names.
+ * @param application - Optional application component categories.
+ * @param auth - Optional namespaced native component categories.
+ * @returns Categories merged without overwriting application schemas.
+ */
+function mergeComponents(application, auth) {
+    const components = isRecord(application) ? application : {};
+    const authComponents = isRecord(auth) ? auth : {};
+    const merged = { ...components };
+    for (const [category, entries] of Object.entries(authComponents)) {
+        const existing = isRecord(components[category]) ? components[category] : {};
+        if (!isRecord(entries))
+            continue;
+        for (const name of Object.keys(entries)) {
+            if (Object.hasOwn(existing, name))
+                throw new TypeError(`Duplicate authentication component: ${name}`);
+        }
+        merged[category] = { ...existing, ...entries };
+    }
+    return merged;
+}
+/**
+ * Describes only the login/signup endpoints present in the native document.
+ * @param paths - Already mounted authentication endpoint paths.
+ * @returns Markdown instructions for same-origin browser-session requests.
+ */
+function authInstructions(paths) {
+    const signIn = Object.keys(paths).find((path) => path.endsWith("/sign-in/email"));
+    const signUp = Object.keys(paths).find((path) => path.endsWith("/sign-up/email"));
+    return [
+        "### Authentication",
+        signUp === undefined
+            ? ""
+            : `For a new account, send **POST ${signUp}** with name, email and password.`,
+        signIn === undefined
+            ? "Use the Authentication endpoints to sign in."
+            : `Send **POST ${signIn}** with email and password to log in.`,
+        "Use **Test Request** in this reference. The browser stores the session cookie and sends it with subsequent requests to protected endpoints. Keep this reference and requests on the same origin; no token copying is needed.",
+    ]
+        .filter(Boolean)
+        .join("\n\n");
+}
+/** Recognizes validated JSON objects before component/path projection. */
+function isRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+//# sourceMappingURL=api-docs-auth.js.map

package/dist/api-docs-auth.js.map

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

package/dist/api-docs-document.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Owns lazy document generation for JSON and embedded Scalar responses. Shared
+ * application metadata is captured at construction; native auth metadata is
+ * requested per authorized call. Foreign failures remain HttpBoundaryError and
+ * the HTTP transport owns execution/cancellation and its configured logger.
+ */
+import { type JsonValue } from "@relkit/contracts";
+import type { RegistrationPlan } from "@relkit/graph";
+import { Context, Effect } from "effect";
+import type { ApiDocsOptions } from "./api-docs.types.js";
+import { HttpBoundaryError } from "./http-effect.js";
+declare const ApiDocuments_base: Context.ServiceClass<ApiDocuments, "relkit/http/ApiDocuments", {
+    /**
+     * Resolves one application document without capturing request identity.
+     * @returns Lazy JSON metadata, or HttpBoundaryError on native generation/merge failure.
+     */
+    readonly get: () => Effect.Effect<JsonValue, HttpBoundaryError>;
+}> & {
+    readonly make: (base: JsonValue, options: ApiDocsOptions) => Effect.Effect<{
+        /**
+         * Resolves one application document without capturing request identity.
+         * @returns Lazy JSON metadata, or HttpBoundaryError on native generation/merge failure.
+         */
+        readonly get: () => Effect.Effect<JsonValue, HttpBoundaryError>;
+    }, never, never>;
+};
+/** Shared documentation projection; no session/request identity is captured. */
+export declare class ApiDocuments extends ApiDocuments_base {
+}
+/**
+ * Builds application metadata from callable targets and raw HTTP registrations.
+ * @param plan - Validated registration plan supplied by application construction.
+ * @returns A JSON-safe application document without acquiring native services.
+ */
+export declare function documentFrom(plan: RegistrationPlan): JsonValue;
+export {};
+//# sourceMappingURL=api-docs-document.d.ts.map

package/dist/api-docs-document.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-docs-document.d.ts","sourceRoot":"","sources":["../src/api-docs-document.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAmB,KAAK,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACpE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAGtD,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEzC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAgB,iBAAiB,EAAe,MAAM,kBAAkB,CAAC;;IAM5E;;;OAGG;kBACW,MAAM,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,iBAAiB,CAAC;;;QAJ/D;;;WAGG;sBACW,MAAM,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,iBAAiB,CAAC;;;AARnE,gFAAgF;AAChF,qBAAa,YAAa,SAAQ,iBAkChC;CAAG;AAEL;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,gBAAgB,GAAG,SAAS,CAyB9D"}

package/dist/api-docs-document.js

@@ -0,0 +1,109 @@
+/**
+ * Owns lazy document generation for JSON and embedded Scalar responses. Shared
+ * application metadata is captured at construction; native auth metadata is
+ * requested per authorized call. Foreign failures remain HttpBoundaryError and
+ * the HTTP transport owns execution/cancellation and its configured logger.
+ */
+import { assertJsonValue } from "@relkit/contracts";
+import { generateOpenApi } from "@relkit/openapi";
+import { GRAPH_VERSION } from "@relkit/contracts";
+import { Context, Effect } from "effect";
+import { mergeAuthDocument } from "./api-docs-auth.js";
+import { httpBoundary, HttpBoundaryError, observeHttp } from "./http-effect.js";
+/** Shared documentation projection; no session/request identity is captured. */
+export class ApiDocuments extends Context.Service()("relkit/http/ApiDocuments", {
+    /**
+     * Captures static metadata and native lookup policy without calling auth.
+     * @param base - Validated application JSON document.
+     * @param options - Exposure policy, native lookup and excluded service IDs.
+     * @returns Methods that retain HTTP execution context at each request.
+     */
+    make: (base, options) => Effect.succeed({
+        get: Effect.fn("ApiDocuments.get")(function* () {
+            let document = base;
+            const readAuth = options.getAuthDocument;
+            if (readAuth !== undefined) {
+                const auth = yield* httpBoundary("api.docs.auth", () => readAuth());
+                document = yield* Effect.try({
+                    try: () => mergeAuthDocument(base, auth),
+                    catch: (cause) => new HttpBoundaryError({ operation: "api.docs.merge", cause }),
+                });
+            }
+            return filterDomains(document, options.excludeDomains);
+        }, (effect) => observeHttp("api.docs.document", effect)),
+    }),
+}) {
+}
+/**
+ * Builds application metadata from callable targets and raw HTTP registrations.
+ * @param plan - Validated registration plan supplied by application construction.
+ * @returns A JSON-safe application document without acquiring native services.
+ */
+export function documentFrom(plan) {
+    const functions = new Set(plan.functions.map(({ id }) => id));
+    const document = generateOpenApi({
+        contractVersion: GRAPH_VERSION,
+        nodes: [
+            ...plan.functions,
+            ...plan.httpTriggers
+                .filter(({ config, targetFunctionId }) => (config !== null &&
+                typeof config === "object" &&
+                "rawHandler" in config &&
+                config.rawHandler === true) ||
+                functions.has(targetFunctionId))
+                .map((trigger) => {
+                assertJsonValue(trigger.config);
+                return { ...trigger, config: trigger.config };
+            }),
+            ...(plan.services ?? []),
+        ],
+        edges: [],
+    });
+    assertJsonValue(document);
+    return document;
+}
+/**
+ * Removes excluded service operations and their now-unused tags.
+ * @param document - Validated JSON document after optional auth merge.
+ * @param excluded - Service identities hidden from the shared reference.
+ * @returns Detached filtered metadata, or the original when filtering is unnecessary.
+ */
+function filterDomains(document, excluded = []) {
+    if (excluded.length === 0 || !isRecord(document) || !isRecord(document.paths))
+        return document;
+    const domains = new Set(excluded);
+    const methods = new Set(["get", "put", "post", "delete", "options", "head", "patch", "trace"]);
+    const paths = Object.fromEntries(Object.entries(document.paths).flatMap(([path, item]) => {
+        if (!isRecord(item))
+            return [[path, item]];
+        const entries = Object.entries(item);
+        const kept = entries.filter(([method, operation]) => {
+            if (!methods.has(method) || !isRecord(operation))
+                return true;
+            const metadata = operation["x-relkit"];
+            return (!isRecord(metadata) ||
+                typeof metadata.serviceId !== "string" ||
+                !domains.has(metadata.serviceId));
+        });
+        if (kept.length < entries.length && !kept.some(([method]) => methods.has(method)))
+            return [];
+        return [[path, Object.fromEntries(kept)]];
+    }));
+    const usedTags = new Set(Object.values(paths).flatMap((item) => !isRecord(item)
+        ? []
+        : Object.entries(item).flatMap(([method, operation]) => methods.has(method) && isRecord(operation) && Array.isArray(operation.tags)
+            ? operation.tags
+            : [])));
+    return {
+        ...document,
+        paths,
+        ...(Array.isArray(document.tags)
+            ? { tags: document.tags.filter((tag) => isRecord(tag) && usedTags.has(tag.name)) }
+            : {}),
+    };
+}
+/** Recognizes a validated JSON object before path/tag projection. */
+function isRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+//# sourceMappingURL=api-docs-document.js.map

package/dist/api-docs-document.js.map

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

package/dist/api-docs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"api-docs.d.ts","sourceRoot":"","sources":["../src/api-docs.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAoB,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAGxE,OAAO,KAAK,EAAW,IAAI,EAAQ,MAAM,MAAM,CAAC;AAChD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAG1D,YAAY,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D,eAAO,MAAM,YAAY,4BAA2C,CAAC;AACrE,eAAO,MAAM,kBAAkB,6BAA4C,CAAC;AAE5E,qBAAa,yBAA0B,SAAQ,SAAS;gBAC1C,OAAO,EAAE,MAAM;CAI5B;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE,IAAI,EACT,IAAI,EAAE,gBAAgB,EACtB,OAAO,GAAE,cAAmB,GAC3B,IAAI,CAqDN"}
+{"version":3,"file":"api-docs.d.ts","sourceRoot":"","sources":["../src/api-docs.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAGtD,OAAO,KAAK,EAAW,IAAI,EAAQ,MAAM,MAAM,CAAC;AAChD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAK1D,YAAY,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D,eAAO,MAAM,YAAY,4BAA2C,CAAC;AACrE,eAAO,MAAM,kBAAkB,6BAA4C,CAAC;AAE5E,qBAAa,yBAA0B,SAAQ,SAAS;gBAC1C,OAAO,EAAE,MAAM;CAI5B;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE,IAAI,EACT,IAAI,EAAE,gBAAgB,EACtB,OAAO,GAAE,cAAmB,GAC3B,IAAI,CAeN"}