@opengeni/api-router 3.0.1 → 3.0.2-canary.38894290271001

package/dist/session-event-view-36GO3IL7.js

@@ -0,0 +1,528 @@
+import "./chunk-OGQDXVXY.js";
+
+// src/mcp/session-event-view.ts
+import { z } from "zod";
+import {
+  assistantMessagePhase
+} from "@opengeni/contracts";
+var SESSION_EVENT_VIEW_MAX_BYTES = 16 * 1024;
+var SESSION_EVENT_NAMED_OUTPUT_MAX_CALLS = 3;
+var directionSchema = z.enum(["before", "after"]);
+var namedResumeSchema = z.object({
+  toolName: z.string().min(1).max(256),
+  includeArguments: z.boolean(),
+  limit: z.number().int().min(1).max(SESSION_EVENT_NAMED_OUTPUT_MAX_CALLS),
+  direction: directionSchema,
+  after: z.number().int().nonnegative(),
+  before: z.number().int().positive().nullable(),
+  more: z.boolean()
+});
+var selectionSchema = z.object({
+  sessionId: z.string().uuid(),
+  view: z.enum(["conversation", "results", "tools"]),
+  includeArguments: z.boolean(),
+  includeOutput: z.boolean(),
+  callId: z.string().max(512).refine(
+    (value) => Buffer.byteLength(JSON.stringify(value), "utf8") <= 2048,
+    "callId exceeds the encoded cursor budget"
+  ).nullable(),
+  toolName: z.string().min(1).max(256).refine(
+    (value) => Buffer.byteLength(JSON.stringify(value), "utf8") <= 512,
+    "toolName exceeds the encoded cursor budget"
+  ).nullable().default(null),
+  limit: z.number().int().min(1).max(50).optional(),
+  direction: directionSchema,
+  after: z.number().int().nonnegative(),
+  before: z.number().int().positive().nullable(),
+  named: namedResumeSchema.optional()
+});
+var cursorSchema = z.object({
+  v: z.union([z.literal(1), z.literal(2)]),
+  selection: selectionSchema,
+  sequence: z.number().int().positive().nullable(),
+  offset: z.number().int().nonnegative().max(2147483647)
+});
+var types = {
+  conversation: ["user.message", "agent.message.completed"],
+  // Final turn output is authoritative: do not repeat message.completed text.
+  results: ["turn.completed", "turn.failed", "goal.completed", "goal.paused", "tool.auth_needed"],
+  tools: ["agent.toolCall.created", "agent.toolCall.output"]
+};
+var record = (value) => value !== null && typeof value === "object" && !Array.isArray(value) ? value : {};
+var bytes = (value) => Buffer.byteLength(JSON.stringify(value, null, 2), "utf8");
+var encode = (selection, sequence = null, offset = 0, v = 2) => Buffer.from(JSON.stringify({ v, selection, sequence, offset })).toString("base64url");
+var MAX_CURSOR_LENGTH = 4096;
+var NAMED_OUTPUT_MIN_BUDGET = 2048;
+var exampleCall = (args) => JSON.stringify(Object.fromEntries(Object.entries(args).filter(([, value]) => value != null)));
+function recoverCursorPosition(cursor) {
+  const text = cursor.trimStart().startsWith("{") ? cursor : Buffer.from(cursor, "base64url").toString("utf8");
+  const pick = (pattern) => pattern.exec(text)?.[1];
+  const number = (pattern) => {
+    const value = pick(pattern);
+    return value === void 0 || value.length > 15 ? void 0 : Number(value);
+  };
+  const string = (key) => {
+    const value = pick(new RegExp(`"${key}"\\s*:\\s*"((?:[^"\\\\]|\\\\.){1,256})"`));
+    if (value === void 0) return void 0;
+    try {
+      return JSON.parse(`"${value}"`);
+    } catch {
+      return void 0;
+    }
+  };
+  const view = pick(/"view"\s*:\s*"(conversation|results|tools)"/);
+  const direction = pick(/"direction"\s*:\s*"(before|after)"/);
+  const sequence = number(/"seq[a-z]*"\s*:\s*(\d+)/i);
+  const after = number(/"after"\s*:\s*(\d+)/);
+  const before = number(/"before"\s*:\s*(\d+)/);
+  const limit = number(/"limit"\s*:\s*(\d+)/);
+  const resolvedDirection = direction ?? (before !== void 0 ? "before" : void 0);
+  const position = resolvedDirection === "after" ? sequence !== void 0 ? { after: Math.max(0, sequence - 1) } : after !== void 0 ? { after } : null : resolvedDirection === "before" ? sequence !== void 0 ? { before: sequence + 1 } : before !== void 0 ? { before } : null : null;
+  if (!position) return null;
+  return {
+    ...view ? { view } : {},
+    ...string("toolName") ? { toolName: string("toolName") } : {},
+    ...string("callId") ? { callId: string("callId") } : {},
+    .../"includeArguments"\s*:\s*true/.test(text) ? { includeArguments: true } : {},
+    .../"includeOutput"\s*:\s*true/.test(text) ? { includeOutput: true } : {},
+    direction: resolvedDirection,
+    ...position,
+    ...limit !== void 0 && limit >= 1 && limit <= 50 ? { limit } : {}
+  };
+}
+function invalidCursorError(input) {
+  const recovered = recoverCursorPosition(input.cursor ?? "");
+  const prefix = "Invalid session_events cursor: it was not issued by session_events or was altered when copied. Pass nextCursor byte-for-byte or not at all; never retype or build one.";
+  if (recovered) {
+    return new Error(
+      `${prefix} Its readable part names a position, so continue without a cursor: ${exampleCall({
+        sessionId: input.sessionId,
+        ...recovered
+      })} (check the position against the previous page's nextBefore/nextAfter).`
+    );
+  }
+  return new Error(
+    `${prefix} Continue without a cursor: repeat the previous call with the same view and selectors plus the last page's position, e.g. ${exampleCall(
+      {
+        sessionId: input.sessionId,
+        view: input.view,
+        direction: "before",
+        before: "<nextBefore>"
+      }
+    )} or ${exampleCall({ sessionId: input.sessionId, view: input.view, direction: "after", after: "<nextAfter>" })}.`
+  );
+}
+function resolveSessionEventView(input) {
+  let continuation = null;
+  if (input.cursor !== void 0) {
+    if (input.cursor.length > MAX_CURSOR_LENGTH)
+      throw new Error("session_events cursor exceeds 4096 characters");
+    try {
+      continuation = cursorSchema.parse(
+        JSON.parse(Buffer.from(input.cursor, "base64url").toString())
+      );
+    } catch {
+      throw invalidCursorError(input);
+    }
+    const previous = continuation.selection;
+    for (const key of [
+      "sessionId",
+      "view",
+      "includeArguments",
+      "includeOutput",
+      "callId",
+      "toolName",
+      "direction",
+      "after",
+      "before"
+    ]) {
+      if (input[key] !== void 0 && input[key] !== previous[key]) {
+        throw new Error(`session_events cursor cannot change ${key}`);
+      }
+    }
+  }
+  const selection = continuation?.selection ?? selectionSchema.parse({
+    sessionId: input.sessionId,
+    view: input.view ?? "conversation",
+    includeArguments: input.includeArguments ?? false,
+    includeOutput: input.includeOutput ?? false,
+    callId: input.callId ?? null,
+    toolName: input.toolName ?? null,
+    direction: input.direction ?? (input.before !== void 0 || input.after === void 0 ? "before" : "after"),
+    after: input.after ?? 0,
+    before: input.before ?? null
+  });
+  let notice;
+  if (selection.view !== "tools" && (selection.callId || selection.toolName || selection.includeArguments || selection.includeOutput)) {
+    if (!continuation && (selection.callId || selection.toolName)) {
+      notice = `view=${selection.view} does not return tool calls; this page is view=tools because callId/toolName select tool calls.`;
+      selection.view = "tools";
+    } else {
+      throw new Error(
+        `includeArguments/includeOutput only apply to view=tools. For a tool's result call ${exampleCall(
+          {
+            sessionId: selection.sessionId,
+            view: "tools",
+            toolName: "<exact tool name>",
+            includeOutput: true,
+            limit: 1
+          }
+        )}; view=${selection.view} already returns complete text, so drop them: ${exampleCall({
+          sessionId: selection.sessionId,
+          view: selection.view
+        })}.`
+      );
+    }
+  }
+  const namedOutputs = selection.toolName !== null && selection.includeOutput;
+  selection.limit = z.number().int().min(1).max(50).transform(
+    (value) => namedOutputs ? Math.min(value, SESSION_EVENT_NAMED_OUTPUT_MAX_CALLS) : value
+  ).parse(input.limit ?? selection.limit ?? (namedOutputs ? 1 : 10));
+  if (namedOutputs && continuation && continuation.sequence !== null)
+    throw new Error("Invalid session_events cursor position");
+  if (continuation && (continuation.sequence === null && continuation.offset !== 0 || continuation.sequence !== null && (continuation.sequence <= selection.after || selection.before !== null && continuation.sequence >= selection.before)))
+    throw new Error("Invalid session_events cursor position");
+  return { selection, continuation, notice };
+}
+function project(event, selection) {
+  if (event.duplicateOfEventId || event.turnAssociation && event.turnAssociation !== "current")
+    return null;
+  const p = record(event.payload);
+  const base = { sequence: event.sequence, ...event.turnId ? { turnId: event.turnId } : {} };
+  if (selection.view === "conversation") {
+    const phase = event.type === "agent.message.completed" ? assistantMessagePhase(p) : null;
+    return typeof p.text === "string" && p.text.length > 0 ? {
+      ...base,
+      role: event.type === "user.message" ? "user" : "assistant",
+      ...phase ? { phase } : {},
+      text: p.text
+    } : null;
+  }
+  if (selection.view === "results") {
+    if (event.type === "turn.completed" && ("maintenance" in p || "segmentLimit" in p)) return null;
+    const value2 = event.type === "turn.completed" ? p.output ?? p.result : p;
+    if (value2 === void 0 || value2 === "") return null;
+    return {
+      ...base,
+      type: event.type,
+      text: typeof value2 === "string" ? value2 : JSON.stringify(value2)
+    };
+  }
+  if (selection.toolName && (event.type !== "agent.toolCall.created" || p.name !== selection.toolName))
+    return null;
+  const callId = p.callId ?? p.call_id ?? p.id;
+  if (selection.callId !== null && selection.callId !== callId) return null;
+  const output = event.type === "agent.toolCall.output";
+  const value = output ? p.output : p.arguments ?? p.args;
+  return {
+    ...base,
+    callId,
+    kind: output ? "result" : "call",
+    ...typeof p.name === "string" ? { name: p.name } : {},
+    ...p.identityOmitted === true ? { identityOmitted: true } : {},
+    ...p.isError === true || record(value).isError === true ? { isError: true } : {},
+    ...(output ? selection.includeOutput : selection.includeArguments) && value !== void 0 ? {
+      text: typeof value === "string" ? value : JSON.stringify(value),
+      encoding: typeof value === "string" ? "text" : "json"
+    } : {}
+  };
+}
+async function readSessionEventView(input, read) {
+  const { selection, continuation, notice } = resolveSessionEventView(input);
+  const scanned = selection.toolName !== null && selection.includeOutput ? await readNamedCallOutputs(selection, read) : await scanSessionEventView(selection, continuation, read);
+  const page = selection.named ? returnToNamedStream(scanned, selection) : scanned;
+  return notice === void 0 ? page : { ...page, notice };
+}
+var incompleteFragment = (item) => record(item.fragment).complete === false;
+var namedSelection = (selection, named) => ({
+  sessionId: selection.sessionId,
+  view: "tools",
+  includeArguments: named.includeArguments,
+  includeOutput: true,
+  callId: null,
+  toolName: named.toolName,
+  limit: named.limit,
+  direction: named.direction,
+  after: named.after,
+  before: named.before
+});
+function returnToNamedStream(page, selection) {
+  const named = selection.named;
+  const position = {
+    view: "tools",
+    effectiveLimit: named.limit,
+    direction: named.direction,
+    nextAfter: named.direction === "after" ? named.after : null,
+    nextBefore: named.direction === "before" ? named.before : null
+  };
+  if (page.events.some(incompleteFragment)) return { ...page, ...position };
+  return {
+    ...page,
+    ...position,
+    hasMore: named.more,
+    nextCursor: named.more ? encode(namedSelection(selection, named)) : null
+  };
+}
+function withNamedResume(cursor, named, limit) {
+  const decoded = cursorSchema.parse(JSON.parse(Buffer.from(cursor, "base64url").toString()));
+  const encoded = encode(
+    { ...decoded.selection, ...limit === void 0 ? {} : { limit }, named },
+    decoded.sequence,
+    decoded.offset,
+    decoded.v
+  );
+  return encoded.length <= MAX_CURSOR_LENGTH ? encoded : null;
+}
+async function readNamedCallOutputs(selection, read) {
+  const calls = await scanSessionEventView({ ...selection, includeOutput: false }, null, read);
+  const ordered = selection.direction === "before" ? [...calls.events].reverse() : calls.events;
+  const events = [];
+  let sourceLoss = calls.sourceLoss;
+  let stop = null;
+  const envelope = (items) => bytes({ ...calls, events: items, nextCursor: null });
+  const empty = envelope([]);
+  const resumePast = (sequence, more) => ({
+    toolName: selection.toolName,
+    includeArguments: selection.includeArguments,
+    limit: selection.limit,
+    direction: selection.direction,
+    after: selection.direction === "after" ? sequence : selection.after,
+    before: selection.direction === "before" ? sequence : selection.before,
+    more
+  });
+  const pastCall = (call) => selection.direction === "before" ? call.sequence - 1 : call.sequence + 1;
+  for (const [index, call] of ordered.entries()) {
+    const later = index + 1 < ordered.length || calls.hasMore;
+    const lookup = selectionSchema.safeParse({
+      sessionId: selection.sessionId,
+      view: "tools",
+      includeArguments: false,
+      includeOutput: true,
+      callId: typeof call.callId === "string" ? call.callId : null,
+      toolName: null,
+      limit: 1,
+      direction: "after",
+      after: call.sequence,
+      before: null
+    });
+    const readOutput = lookup.success && lookup.data.callId !== null ? { readOutput: { view: "tools", callId: lookup.data.callId, includeOutput: true } } : {};
+    if (incompleteFragment(call)) {
+      if (index > 0) {
+        stop = { position: call.sequence, cursor: null };
+        break;
+      }
+      events.push({ ...call, ...readOutput });
+      stop = {
+        position: pastCall(call),
+        cursor: withNamedResume(calls.nextCursor, resumePast(call.sequence, true), 1) ?? calls.nextCursor
+      };
+      break;
+    }
+    if (!lookup.success || lookup.data.callId === null) {
+      events.push({
+        ...call,
+        outputUnavailable: call.identityOmitted === true || typeof call.callId !== "string" ? "call_identity_omitted" : "call_id_exceeds_lookup_budget"
+      });
+      continue;
+    }
+    const used = envelope([...events, call]) - empty;
+    const { text: _arguments, ...identity } = call;
+    if (SESSION_EVENT_VIEW_MAX_BYTES - 6e3 - used < NAMED_OUTPUT_MIN_BUDGET + bytes(identity)) {
+      if (index > 0) {
+        stop = { position: call.sequence, cursor: null };
+        break;
+      }
+      events.push({ ...call, ...readOutput });
+      stop = { position: pastCall(call), cursor: null };
+      break;
+    }
+    const output = await scanSessionEventView(lookup.data, null, read, used);
+    sourceLoss ??= output.sourceLoss;
+    const result = output.events.find((item) => item.kind === "result");
+    if (!result) {
+      events.push({ ...call, outputFound: false, ...output.hasMore ? readOutput : {} });
+      continue;
+    }
+    if (incompleteFragment(result)) {
+      if (index > 0) {
+        stop = { position: call.sequence, cursor: null };
+        break;
+      }
+      const cursor = withNamedResume(output.nextCursor, resumePast(call.sequence, later));
+      events.push(...cursor ? [call, result] : [{ ...call, ...readOutput }]);
+      stop = { position: pastCall(call), cursor };
+      break;
+    }
+    events.push(call, result);
+  }
+  events.sort((a, b) => a.sequence - b.sequence);
+  const position = stop ? selection.direction === "before" ? { after: selection.after, before: stop.position + 1 } : { after: Math.max(0, stop.position - 1), before: selection.before } : selection.direction === "before" ? { after: selection.after, before: calls.nextBefore } : { after: calls.nextAfter ?? selection.after, before: selection.before };
+  const hasMore = stop !== null || calls.hasMore;
+  const { sourceLoss: _callsLoss, ...base } = calls;
+  return {
+    ...base,
+    events,
+    nextAfter: selection.direction === "after" ? position.after : null,
+    nextBefore: selection.direction === "before" ? position.before : null,
+    hasMore,
+    nextCursor: stop?.cursor ?? (hasMore ? encode({ ...selection, ...position }) : null),
+    sourceExact: sourceLoss === void 0,
+    ...sourceLoss ? { sourceLoss } : {}
+  };
+}
+async function scanSessionEventView(selection, continuation, read, reservedBytes = 0) {
+  const limit = selection.limit;
+  let after = continuation?.sequence && selection.direction === "after" ? continuation.sequence - 1 : selection.after;
+  let before = continuation?.sequence && selection.direction === "before" ? continuation.sequence + 1 : selection.before;
+  const events = [];
+  let hasMore = false;
+  let nextCursor = null;
+  let sourceExact = true;
+  let edge = null;
+  let legacyActive = continuation?.v === 1 && continuation.sequence !== null;
+  const page = () => ({
+    view: selection.view,
+    effectiveLimit: limit,
+    direction: selection.direction,
+    events,
+    nextAfter: selection.direction === "after" ? edge ?? selection.after : null,
+    nextBefore: selection.direction === "before" ? edge ?? selection.before : null,
+    hasMore,
+    nextCursor,
+    sourceExact,
+    ...!sourceExact ? {
+      sourceLoss: {
+        reason: "structured_value_exceeds_budget",
+        completeTextAvailable: false,
+        message: "An oversized structured value was omitted. Scalar text remains retrievable through continuation; omitted structured values are not complete JSON results."
+      }
+    } : {},
+    maxBytes: SESSION_EVENT_VIEW_MAX_BYTES
+  });
+  const resume = (sequence, offset = 0) => {
+    hasMore = true;
+    nextCursor = encode(
+      { ...selection, after, before },
+      sequence,
+      offset,
+      legacyActive && sequence === continuation?.sequence ? 1 : 2
+    );
+  };
+  for (let scan = 0; scan < 64; scan += 1) {
+    const source = await read({
+      after,
+      ...before === null ? {} : { before },
+      direction: selection.direction,
+      limit: 8,
+      includeTypes: selection.toolName ? ["agent.toolCall.created"] : types[selection.view],
+      ...selection.toolName ? { toolName: selection.toolName } : {},
+      ...selection.callId ? { callId: selection.callId } : {},
+      payloadMode: "full",
+      excludeUnclaimedHumanPrompts: true,
+      maxBytes: 1024 * 1024,
+      legacyUtf16: legacyActive,
+      view: selection.view,
+      includeArguments: selection.includeArguments,
+      includeOutput: selection.includeOutput,
+      ...continuation?.sequence ? { sourceSequence: continuation.sequence, sourceOffset: continuation.offset } : {}
+    });
+    sourceExact &&= source.fullPayloadsExact;
+    const ordered = selection.direction === "before" ? [...source.events].reverse() : source.events;
+    for (const event of ordered) {
+      const slice = source.slices?.[event.sequence];
+      const item = project(event, selection);
+      if (item) {
+        const offset = continuation?.sequence === event.sequence ? continuation.offset : 0;
+        if (slice?.omitted) {
+          delete item.text;
+          item.sourceOmitted = { reason: "structured_value_exceeds_budget", complete: false };
+        }
+        const advance = (text) => slice?.unit === "codepoint" ? Array.from(text).length : text.length;
+        if (!slice && offset > (item.text?.length ?? 0))
+          throw new Error("Invalid message continuation offset");
+        if (!slice && offset > 0 && item.text && /[\uD800-\uDBFF]/.test(item.text[offset - 1]) && /[\uDC00-\uDFFF]/.test(item.text[offset] ?? "")) {
+          throw new Error("Invalid message continuation offset: splits a surrogate pair");
+        }
+        if (!slice && offset > 0 && item.text) item.text = item.text.slice(offset);
+        events.push(item);
+        if (bytes(page()) > SESSION_EVENT_VIEW_MAX_BYTES - 4096 - reservedBytes) {
+          events.pop();
+          if (events.length > 0) {
+            resume(event.sequence, offset);
+            if (selection.direction === "before") events.reverse();
+            return page();
+          }
+          if (!item.text) throw new Error("Session event identity exceeds page budget");
+          const text = item.text;
+          let low = 0;
+          let high = text.length;
+          while (low < high) {
+            const mid = Math.ceil((low + high) / 2);
+            if (bytes({ ...item, text: text.slice(0, mid) }) <= SESSION_EVENT_VIEW_MAX_BYTES - 6e3 - reservedBytes)
+              low = mid;
+            else high = mid - 1;
+          }
+          if (low > 0 && /[\uD800-\uDBFF]/.test(text[low - 1])) low -= 1;
+          if (low === 0) throw new Error("Session event identity exceeds page budget");
+          events.push({
+            ...item,
+            text: text.slice(0, low),
+            fragment: {
+              offset,
+              nextOffset: offset + advance(text.slice(0, low)),
+              complete: false,
+              unit: slice?.unit ?? "utf16"
+            }
+          });
+          resume(event.sequence, offset + advance(text.slice(0, low)));
+          return page();
+        }
+        const nextOffset = offset + advance(item.text ?? "");
+        if (slice && !slice.omitted && nextOffset < slice.total) {
+          item.fragment = { offset, nextOffset, complete: false, unit: slice.unit };
+          resume(event.sequence, nextOffset);
+          if (selection.direction === "before") events.reverse();
+          return page();
+        }
+        if (offset > 0)
+          item.fragment = {
+            offset,
+            nextOffset,
+            complete: true,
+            unit: slice?.unit ?? "utf16"
+          };
+      }
+      edge = event.sequence;
+      legacyActive = false;
+      if (selection.direction === "after") after = event.sequence;
+      else before = event.sequence;
+      if (events.length >= limit) {
+        hasMore = source.hasMore || event !== ordered.at(-1);
+        nextCursor = hasMore ? encode({ ...selection, after, before }) : null;
+        if (selection.direction === "before") events.reverse();
+        return page();
+      }
+    }
+    if (source.coveredSequence) {
+      if (selection.direction === "after") after = Math.max(after, source.coveredSequence.last);
+      else before = Math.min(before ?? Infinity, source.coveredSequence.first);
+    }
+    if (!source.hasMore) {
+      hasMore = false;
+      nextCursor = null;
+      if (selection.direction === "before") events.reverse();
+      return page();
+    }
+    hasMore = true;
+    nextCursor = encode({ ...selection, after, before });
+  }
+  if (selection.direction === "before") events.reverse();
+  return page();
+}
+export {
+  SESSION_EVENT_NAMED_OUTPUT_MAX_CALLS,
+  SESSION_EVENT_VIEW_MAX_BYTES,
+  readSessionEventView,
+  resolveSessionEventView
+};
+//# sourceMappingURL=session-event-view-36GO3IL7.js.map

package/dist/session-event-view-36GO3IL7.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/mcp/session-event-view.ts"],"sourcesContent":["import { z } from \"zod\";\nimport {\n  assistantMessagePhase,\n  type SessionEvent,\n  type SessionEventType,\n} from \"@opengeni/contracts\";\nimport type {\n  SessionEventSliceOptions,\n  SessionEventSlicePage,\n} from \"@opengeni/db/session-event-slices\";\n\nexport const SESSION_EVENT_VIEW_MAX_BYTES = 16 * 1024;\n/**\n * toolName with includeOutput reads each named call's result through the exact\n * callId path, so one page carries at most this many call/result pairs inside\n * the same 16 KiB envelope. An omitted limit means the newest (or oldest) one.\n */\nexport const SESSION_EVENT_NAMED_OUTPUT_MAX_CALLS = 3;\nconst directionSchema = z.enum([\"before\", \"after\"]);\n// A fragment continuation issued by a named-output page carries the named\n// stream's next position, so finishing the fragment returns to that stream.\nconst namedResumeSchema = z.object({\n  toolName: z.string().min(1).max(256),\n  includeArguments: z.boolean(),\n  limit: z.number().int().min(1).max(SESSION_EVENT_NAMED_OUTPUT_MAX_CALLS),\n  direction: directionSchema,\n  after: z.number().int().nonnegative(),\n  before: z.number().int().positive().nullable(),\n  more: z.boolean(),\n});\nconst selectionSchema = z.object({\n  sessionId: z.string().uuid(),\n  view: z.enum([\"conversation\", \"results\", \"tools\"]),\n  includeArguments: z.boolean(),\n  includeOutput: z.boolean(),\n  callId: z\n    .string()\n    .max(512)\n    .refine(\n      (value) => Buffer.byteLength(JSON.stringify(value), \"utf8\") <= 2048,\n      \"callId exceeds the encoded cursor budget\",\n    )\n    .nullable(),\n  toolName: z\n    .string()\n    .min(1)\n    .max(256)\n    .refine(\n      (value) => Buffer.byteLength(JSON.stringify(value), \"utf8\") <= 512,\n      \"toolName exceeds the encoded cursor budget\",\n    )\n    .nullable()\n    .default(null),\n  limit: z.number().int().min(1).max(50).optional(),\n  direction: directionSchema,\n  after: z.number().int().nonnegative(),\n  before: z.number().int().positive().nullable(),\n  named: namedResumeSchema.optional(),\n});\nconst cursorSchema = z.object({\n  v: z.union([z.literal(1), z.literal(2)]),\n  selection: selectionSchema,\n  sequence: z.number().int().positive().nullable(),\n  offset: z.number().int().nonnegative().max(2_147_483_647),\n});\ntype Selection = z.infer<typeof selectionSchema>;\nexport type SessionEventViewInput = {\n  sessionId: string;\n  view?: Selection[\"view\"] | undefined;\n  after?: number | undefined;\n  before?: number | undefined;\n  direction?: Selection[\"direction\"] | undefined;\n  limit?: number | undefined;\n  cursor?: string | undefined;\n  callId?: string | undefined;\n  toolName?: string | undefined;\n  includeArguments?: boolean | undefined;\n  includeOutput?: boolean | undefined;\n};\ntype Item = { sequence: number; turnId?: string; role?: string; text?: string } & Record<\n  string,\n  unknown\n>;\ntype ReadPage = (options: SessionEventSliceOptions) => Promise<SessionEventSlicePage>;\nconst types: Record<Selection[\"view\"], SessionEventType[]> = {\n  conversation: [\"user.message\", \"agent.message.completed\"],\n  // Final turn output is authoritative: do not repeat message.completed text.\n  results: [\"turn.completed\", \"turn.failed\", \"goal.completed\", \"goal.paused\", \"tool.auth_needed\"],\n  tools: [\"agent.toolCall.created\", \"agent.toolCall.output\"],\n};\nconst record = (value: unknown): Record<string, unknown> =>\n  value !== null && typeof value === \"object\" && !Array.isArray(value)\n    ? (value as Record<string, unknown>)\n    : {};\nconst bytes = (value: unknown) => Buffer.byteLength(JSON.stringify(value, null, 2), \"utf8\");\nconst encode = (selection: Selection, sequence: number | null = null, offset = 0, v = 2) =>\n  Buffer.from(JSON.stringify({ v, selection, sequence, offset })).toString(\"base64url\");\n\nconst MAX_CURSOR_LENGTH = 4096;\n// Below this many bytes an output read could not return a useful fragment.\nconst NAMED_OUTPUT_MIN_BUDGET = 2048;\n\nconst exampleCall = (args: Record<string, unknown>) =>\n  JSON.stringify(Object.fromEntries(Object.entries(args).filter(([, value]) => value != null)));\n\n/**\n * Agents sometimes retype the opaque cursor and corrupt it. Read whatever\n * position survives in the readable part so the refusal can name the exact\n * cursor-free call. Recovered values are advice, never a continuation.\n */\nfunction recoverCursorPosition(cursor: string): Record<string, unknown> | null {\n  const text = cursor.trimStart().startsWith(\"{\")\n    ? cursor\n    : Buffer.from(cursor, \"base64url\").toString(\"utf8\");\n  const pick = (pattern: RegExp) => pattern.exec(text)?.[1];\n  const number = (pattern: RegExp) => {\n    const value = pick(pattern);\n    return value === undefined || value.length > 15 ? undefined : Number(value);\n  };\n  const string = (key: string) => {\n    const value = pick(new RegExp(`\"${key}\"\\\\s*:\\\\s*\"((?:[^\"\\\\\\\\]|\\\\\\\\.){1,256})\"`));\n    if (value === undefined) return undefined;\n    try {\n      return JSON.parse(`\"${value}\"`) as string;\n    } catch {\n      return undefined;\n    }\n  };\n  const view = pick(/\"view\"\\s*:\\s*\"(conversation|results|tools)\"/);\n  const direction = pick(/\"direction\"\\s*:\\s*\"(before|after)\"/) as\n    | Selection[\"direction\"]\n    | undefined;\n  const sequence = number(/\"seq[a-z]*\"\\s*:\\s*(\\d+)/i);\n  const after = number(/\"after\"\\s*:\\s*(\\d+)/);\n  const before = number(/\"before\"\\s*:\\s*(\\d+)/);\n  const limit = number(/\"limit\"\\s*:\\s*(\\d+)/);\n  const resolvedDirection = direction ?? (before !== undefined ? \"before\" : undefined);\n  const position =\n    resolvedDirection === \"after\"\n      ? sequence !== undefined\n        ? { after: Math.max(0, sequence - 1) }\n        : after !== undefined\n          ? { after }\n          : null\n      : resolvedDirection === \"before\"\n        ? sequence !== undefined\n          ? { before: sequence + 1 }\n          : before !== undefined\n            ? { before }\n            : null\n        : null;\n  if (!position) return null;\n  return {\n    ...(view ? { view } : {}),\n    ...(string(\"toolName\") ? { toolName: string(\"toolName\") } : {}),\n    ...(string(\"callId\") ? { callId: string(\"callId\") } : {}),\n    ...(/\"includeArguments\"\\s*:\\s*true/.test(text) ? { includeArguments: true } : {}),\n    ...(/\"includeOutput\"\\s*:\\s*true/.test(text) ? { includeOutput: true } : {}),\n    direction: resolvedDirection,\n    ...position,\n    ...(limit !== undefined && limit >= 1 && limit <= 50 ? { limit } : {}),\n  };\n}\n\nfunction invalidCursorError(input: SessionEventViewInput): Error {\n  const recovered = recoverCursorPosition(input.cursor ?? \"\");\n  const prefix =\n    \"Invalid session_events cursor: it was not issued by session_events or was altered when copied. Pass nextCursor byte-for-byte or not at all; never retype or build one.\";\n  if (recovered) {\n    return new Error(\n      `${prefix} Its readable part names a position, so continue without a cursor: ${exampleCall({\n        sessionId: input.sessionId,\n        ...recovered,\n      })} (check the position against the previous page's nextBefore/nextAfter).`,\n    );\n  }\n  return new Error(\n    `${prefix} Continue without a cursor: repeat the previous call with the same view and selectors plus the last page's position, e.g. ${exampleCall(\n      {\n        sessionId: input.sessionId,\n        view: input.view,\n        direction: \"before\",\n        before: \"<nextBefore>\",\n      },\n    )} or ${exampleCall({ sessionId: input.sessionId, view: input.view, direction: \"after\", after: \"<nextAfter>\" })}.`,\n  );\n}\n\n/** A cursor is a bounded selector, never authority. The caller reauthorizes every read. */\nexport function resolveSessionEventView(input: SessionEventViewInput) {\n  let continuation: z.infer<typeof cursorSchema> | null = null;\n  if (input.cursor !== undefined) {\n    if (input.cursor.length > MAX_CURSOR_LENGTH)\n      throw new Error(\"session_events cursor exceeds 4096 characters\");\n    try {\n      continuation = cursorSchema.parse(\n        JSON.parse(Buffer.from(input.cursor, \"base64url\").toString()),\n      );\n    } catch {\n      throw invalidCursorError(input);\n    }\n    const previous = continuation.selection;\n    for (const key of [\n      \"sessionId\",\n      \"view\",\n      \"includeArguments\",\n      \"includeOutput\",\n      \"callId\",\n      \"toolName\",\n      \"direction\",\n      \"after\",\n      \"before\",\n    ] as const) {\n      if (input[key] !== undefined && input[key] !== previous[key]) {\n        throw new Error(`session_events cursor cannot change ${key}`);\n      }\n    }\n  }\n  const selection =\n    continuation?.selection ??\n    selectionSchema.parse({\n      sessionId: input.sessionId,\n      view: input.view ?? \"conversation\",\n      includeArguments: input.includeArguments ?? false,\n      includeOutput: input.includeOutput ?? false,\n      callId: input.callId ?? null,\n      toolName: input.toolName ?? null,\n      direction:\n        input.direction ??\n        (input.before !== undefined || input.after === undefined ? \"before\" : \"after\"),\n      after: input.after ?? 0,\n      before: input.before ?? null,\n    });\n  let notice: string | undefined;\n  if (\n    selection.view !== \"tools\" &&\n    (selection.callId ||\n      selection.toolName ||\n      selection.includeArguments ||\n      selection.includeOutput)\n  ) {\n    // callId and toolName name tool calls, which only view=tools returns, so\n    // the intent is unambiguous: read them there and say so.\n    if (!continuation && (selection.callId || selection.toolName)) {\n      notice = `view=${selection.view} does not return tool calls; this page is view=tools because callId/toolName select tool calls.`;\n      selection.view = \"tools\";\n    } else {\n      throw new Error(\n        `includeArguments/includeOutput only apply to view=tools. For a tool's result call ${exampleCall(\n          {\n            sessionId: selection.sessionId,\n            view: \"tools\",\n            toolName: \"<exact tool name>\",\n            includeOutput: true,\n            limit: 1,\n          },\n        )}; view=${selection.view} already returns complete text, so drop them: ${exampleCall({\n          sessionId: selection.sessionId,\n          view: selection.view,\n        })}.`,\n      );\n    }\n  }\n  const namedOutputs = selection.toolName !== null && selection.includeOutput;\n  // Named outputs read one exact result per call, so the page size is the\n  // number of calls and is clamped rather than refused; effectiveLimit and\n  // nextCursor report the clamp.\n  selection.limit = z\n    .number()\n    .int()\n    .min(1)\n    .max(50)\n    .transform((value) =>\n      namedOutputs ? Math.min(value, SESSION_EVENT_NAMED_OUTPUT_MAX_CALLS) : value,\n    )\n    .parse(input.limit ?? selection.limit ?? (namedOutputs ? 1 : 10));\n  if (namedOutputs && continuation && continuation.sequence !== null)\n    throw new Error(\"Invalid session_events cursor position\");\n  if (\n    continuation &&\n    ((continuation.sequence === null && continuation.offset !== 0) ||\n      (continuation.sequence !== null &&\n        (continuation.sequence <= selection.after ||\n          (selection.before !== null && continuation.sequence >= selection.before))))\n  )\n    throw new Error(\"Invalid session_events cursor position\");\n  return { selection, continuation, notice };\n}\n\nfunction project(event: SessionEvent, selection: Selection): Item | null {\n  if (event.duplicateOfEventId || (event.turnAssociation && event.turnAssociation !== \"current\"))\n    return null;\n  const p = record(event.payload);\n  const base = { sequence: event.sequence, ...(event.turnId ? { turnId: event.turnId } : {}) };\n  if (selection.view === \"conversation\") {\n    // Commentary stays in the conversation, labelled so a reader can tell a\n    // progress note from an answer.\n    const phase = event.type === \"agent.message.completed\" ? assistantMessagePhase(p) : null;\n    return typeof p.text === \"string\" && p.text.length > 0\n      ? {\n          ...base,\n          role: event.type === \"user.message\" ? \"user\" : \"assistant\",\n          ...(phase ? { phase } : {}),\n          text: p.text,\n        }\n      : null;\n  }\n  if (selection.view === \"results\") {\n    if (event.type === \"turn.completed\" && (\"maintenance\" in p || \"segmentLimit\" in p)) return null;\n    const value = event.type === \"turn.completed\" ? (p.output ?? p.result) : p;\n    if (value === undefined || value === \"\") return null;\n    return {\n      ...base,\n      type: event.type,\n      text: typeof value === \"string\" ? value : JSON.stringify(value),\n    };\n  }\n  if (\n    selection.toolName &&\n    (event.type !== \"agent.toolCall.created\" || p.name !== selection.toolName)\n  )\n    return null;\n  const callId = p.callId ?? p.call_id ?? p.id;\n  if (selection.callId !== null && selection.callId !== callId) return null;\n  const output = event.type === \"agent.toolCall.output\";\n  // Choose one canonical slot. Never ship the raw receipt beside its parsed copy.\n  const value = output ? p.output : (p.arguments ?? p.args);\n  return {\n    ...base,\n    callId,\n    kind: output ? \"result\" : \"call\",\n    ...(typeof p.name === \"string\" ? { name: p.name } : {}),\n    ...(p.identityOmitted === true ? { identityOmitted: true } : {}),\n    ...(p.isError === true || record(value).isError === true ? { isError: true } : {}),\n    ...((output ? selection.includeOutput : selection.includeArguments) && value !== undefined\n      ? {\n          text: typeof value === \"string\" ? value : JSON.stringify(value),\n          encoding: typeof value === \"string\" ? \"text\" : \"json\",\n        }\n      : {}),\n  };\n}\n\n/** Read-only projection over the existing RLS/audit query. No command observations. */\nexport async function readSessionEventView(input: SessionEventViewInput, read: ReadPage) {\n  const { selection, continuation, notice } = resolveSessionEventView(input);\n  const scanned =\n    selection.toolName !== null && selection.includeOutput\n      ? await readNamedCallOutputs(selection, read)\n      : await scanSessionEventView(selection, continuation, read);\n  const page = selection.named ? returnToNamedStream(scanned, selection) : scanned;\n  return notice === undefined ? page : { ...page, notice };\n}\n\ntype Continuation = ReturnType<typeof resolveSessionEventView>[\"continuation\"];\ntype ViewPage = Awaited<ReturnType<typeof scanSessionEventView>>;\ntype NamedResume = z.infer<typeof namedResumeSchema>;\n// An omitted structured value is final; only a text fragment continues.\nconst incompleteFragment = (item: Item) => record(item.fragment).complete === false;\n\nconst namedSelection = (selection: Selection, named: NamedResume): Selection => ({\n  sessionId: selection.sessionId,\n  view: \"tools\",\n  includeArguments: named.includeArguments,\n  includeOutput: true,\n  callId: null,\n  toolName: named.toolName,\n  limit: named.limit,\n  direction: named.direction,\n  after: named.after,\n  before: named.before,\n});\n\n/**\n * A fragment continuation issued by a named-output page reports the named\n * stream's position, and once the fragment is complete its nextCursor returns\n * to that stream instead of ending the read.\n */\nfunction returnToNamedStream(page: ViewPage, selection: Selection): ViewPage {\n  const named = selection.named!;\n  const position = {\n    view: \"tools\" as const,\n    effectiveLimit: named.limit,\n    direction: named.direction,\n    nextAfter: named.direction === \"after\" ? named.after : null,\n    nextBefore: named.direction === \"before\" ? named.before : null,\n  };\n  if (page.events.some(incompleteFragment)) return { ...page, ...position };\n  return {\n    ...page,\n    ...position,\n    hasMore: named.more,\n    nextCursor: named.more ? encode(namedSelection(selection, named)) : null,\n  };\n}\n\n/** Re-issue a fragment cursor so it carries the named stream it came from. */\nfunction withNamedResume(cursor: string, named: NamedResume, limit?: number): string | null {\n  const decoded = cursorSchema.parse(JSON.parse(Buffer.from(cursor, \"base64url\").toString()));\n  const encoded = encode(\n    { ...decoded.selection, ...(limit === undefined ? {} : { limit }), named },\n    decoded.sequence,\n    decoded.offset,\n    decoded.v,\n  );\n  return encoded.length <= MAX_CURSOR_LENGTH ? encoded : null;\n}\n\n/**\n * toolName plus includeOutput: list the named calls, then read each call's\n * result through the exact callId path. One call whose arguments or result do\n * not fit keeps that path's lossless fragment continuation, which returns to\n * the named stream when complete; later calls resume from a positional cursor\n * instead of being dropped.\n */\nasync function readNamedCallOutputs(selection: Selection, read: ReadPage): Promise<ViewPage> {\n  const calls = await scanSessionEventView({ ...selection, includeOutput: false }, null, read);\n  const ordered = selection.direction === \"before\" ? [...calls.events].reverse() : calls.events;\n  const events: Item[] = [];\n  let sourceLoss = calls.sourceLoss;\n  let stop: { position: number; cursor: string | null } | null = null;\n  const envelope = (items: Item[]) => bytes({ ...calls, events: items, nextCursor: null });\n  const empty = envelope([]);\n  // The named stream continues past `sequence`, the call just returned.\n  const resumePast = (sequence: number, more: boolean): NamedResume => ({\n    toolName: selection.toolName!,\n    includeArguments: selection.includeArguments,\n    limit: selection.limit!,\n    direction: selection.direction,\n    after: selection.direction === \"after\" ? sequence : selection.after,\n    before: selection.direction === \"before\" ? sequence : selection.before,\n    more,\n  });\n  // stop.position is the first named call not yet returned (inclusive).\n  const pastCall = (call: Item) =>\n    selection.direction === \"before\" ? call.sequence - 1 : call.sequence + 1;\n  for (const [index, call] of ordered.entries()) {\n    const later = index + 1 < ordered.length || calls.hasMore;\n    const lookup = selectionSchema.safeParse({\n      sessionId: selection.sessionId,\n      view: \"tools\",\n      includeArguments: false,\n      includeOutput: true,\n      callId: typeof call.callId === \"string\" ? call.callId : null,\n      toolName: null,\n      limit: 1,\n      direction: \"after\",\n      after: call.sequence,\n      before: null,\n    });\n    const readOutput =\n      lookup.success && lookup.data.callId !== null\n        ? { readOutput: { view: \"tools\", callId: lookup.data.callId, includeOutput: true } }\n        : {};\n    if (incompleteFragment(call)) {\n      if (index > 0) {\n        stop = { position: call.sequence, cursor: null };\n        break;\n      }\n      // Arguments larger than a page continue losslessly one call at a time\n      // and then return to the named stream; the result is one exact read.\n      events.push({ ...call, ...readOutput });\n      stop = {\n        position: pastCall(call),\n        cursor:\n          withNamedResume(calls.nextCursor!, resumePast(call.sequence, true), 1) ??\n          calls.nextCursor,\n      };\n      break;\n    }\n    if (!lookup.success || lookup.data.callId === null) {\n      events.push({\n        ...call,\n        outputUnavailable:\n          call.identityOmitted === true || typeof call.callId !== \"string\"\n            ? \"call_identity_omitted\"\n            : \"call_id_exceeds_lookup_budget\",\n      });\n      continue;\n    }\n    const used = envelope([...events, call]) - empty;\n    // The result repeats the call's identity, so budget for it plus some text.\n    const { text: _arguments, ...identity } = call;\n    if (SESSION_EVENT_VIEW_MAX_BYTES - 6000 - used < NAMED_OUTPUT_MIN_BUDGET + bytes(identity)) {\n      if (index > 0) {\n        stop = { position: call.sequence, cursor: null };\n        break;\n      }\n      // Huge arguments leave no room: return the call and name the exact read.\n      events.push({ ...call, ...readOutput });\n      stop = { position: pastCall(call), cursor: null };\n      break;\n    }\n    const output = await scanSessionEventView(lookup.data, null, read, used);\n    sourceLoss ??= output.sourceLoss;\n    const result = output.events.find((item) => item.kind === \"result\");\n    if (!result) {\n      events.push({ ...call, outputFound: false, ...(output.hasMore ? readOutput : {}) });\n      continue;\n    }\n    if (incompleteFragment(result)) {\n      if (index > 0) {\n        stop = { position: call.sequence, cursor: null };\n        break;\n      }\n      // The rest of this result continues through its exact callId cursor,\n      // which returns to the named stream when the result is complete.\n      const cursor = withNamedResume(output.nextCursor!, resumePast(call.sequence, later));\n      events.push(...(cursor ? [call, result] : [{ ...call, ...readOutput }]));\n      stop = { position: pastCall(call), cursor };\n      break;\n    }\n    events.push(call, result);\n  }\n  events.sort((a, b) => a.sequence - b.sequence);\n  const position = stop\n    ? selection.direction === \"before\"\n      ? { after: selection.after, before: stop.position + 1 }\n      : { after: Math.max(0, stop.position - 1), before: selection.before }\n    : selection.direction === \"before\"\n      ? { after: selection.after, before: calls.nextBefore }\n      : { after: calls.nextAfter ?? selection.after, before: selection.before };\n  const hasMore = stop !== null || calls.hasMore;\n  const { sourceLoss: _callsLoss, ...base } = calls;\n  return {\n    ...base,\n    events,\n    nextAfter: selection.direction === \"after\" ? position.after : null,\n    nextBefore: selection.direction === \"before\" ? position.before : null,\n    hasMore,\n    nextCursor: stop?.cursor ?? (hasMore ? encode({ ...selection, ...position }) : null),\n    sourceExact: sourceLoss === undefined,\n    ...(sourceLoss ? { sourceLoss } : {}),\n  };\n}\n\nasync function scanSessionEventView(\n  selection: Selection,\n  continuation: Continuation,\n  read: ReadPage,\n  // Bytes a caller already holds for the same envelope (named outputs).\n  reservedBytes = 0,\n) {\n  const limit = selection.limit!;\n  let after =\n    continuation?.sequence && selection.direction === \"after\"\n      ? continuation.sequence - 1\n      : selection.after;\n  let before =\n    continuation?.sequence && selection.direction === \"before\"\n      ? continuation.sequence + 1\n      : selection.before;\n  const events: Item[] = [];\n  let hasMore = false;\n  let nextCursor: string | null = null;\n  let sourceExact = true;\n  let edge: number | null = null;\n  let legacyActive = continuation?.v === 1 && continuation.sequence !== null;\n  const page = () => ({\n    view: selection.view,\n    effectiveLimit: limit,\n    direction: selection.direction,\n    events,\n    nextAfter: selection.direction === \"after\" ? (edge ?? selection.after) : null,\n    nextBefore: selection.direction === \"before\" ? (edge ?? selection.before) : null,\n    hasMore,\n    nextCursor,\n    sourceExact,\n    ...(!sourceExact\n      ? {\n          sourceLoss: {\n            reason: \"structured_value_exceeds_budget\" as const,\n            completeTextAvailable: false as const,\n            message:\n              \"An oversized structured value was omitted. Scalar text remains retrievable through continuation; omitted structured values are not complete JSON results.\",\n          },\n        }\n      : {}),\n    maxBytes: SESSION_EVENT_VIEW_MAX_BYTES,\n  });\n  const resume = (sequence: number, offset = 0) => {\n    hasMore = true;\n    nextCursor = encode(\n      { ...selection, after, before },\n      sequence,\n      offset,\n      legacyActive && sequence === continuation?.sequence ? 1 : 2,\n    );\n  };\n  // Bound work even when a sparse exact callId lookup matches nothing. The\n  // returned cursor advances the scan without claiming the lookup is exhausted.\n  for (let scan = 0; scan < 64; scan += 1) {\n    const source = await read({\n      after,\n      ...(before === null ? {} : { before }),\n      direction: selection.direction,\n      limit: 8,\n      includeTypes: selection.toolName ? [\"agent.toolCall.created\"] : types[selection.view],\n      ...(selection.toolName ? { toolName: selection.toolName } : {}),\n      ...(selection.callId ? { callId: selection.callId } : {}),\n      payloadMode: \"full\",\n      excludeUnclaimedHumanPrompts: true,\n      maxBytes: 1024 * 1024,\n      legacyUtf16: legacyActive,\n      view: selection.view,\n      includeArguments: selection.includeArguments,\n      includeOutput: selection.includeOutput,\n      ...(continuation?.sequence\n        ? { sourceSequence: continuation.sequence, sourceOffset: continuation.offset }\n        : {}),\n    });\n    sourceExact &&= source.fullPayloadsExact;\n    const ordered = selection.direction === \"before\" ? [...source.events].reverse() : source.events;\n    for (const event of ordered) {\n      const slice = source.slices?.[event.sequence];\n      const item = project(event, selection);\n      if (item) {\n        const offset = continuation?.sequence === event.sequence ? continuation.offset : 0;\n        if (slice?.omitted) {\n          delete item.text;\n          item.sourceOmitted = { reason: \"structured_value_exceeds_budget\", complete: false };\n        }\n        const advance = (text: string) =>\n          slice?.unit === \"codepoint\" ? Array.from(text).length : text.length;\n        if (!slice && offset > (item.text?.length ?? 0))\n          throw new Error(\"Invalid message continuation offset\");\n        if (\n          !slice &&\n          offset > 0 &&\n          item.text &&\n          /[\\uD800-\\uDBFF]/.test(item.text[offset - 1]!) &&\n          /[\\uDC00-\\uDFFF]/.test(item.text[offset] ?? \"\")\n        ) {\n          throw new Error(\"Invalid message continuation offset: splits a surrogate pair\");\n        }\n        if (!slice && offset > 0 && item.text) item.text = item.text.slice(offset);\n        events.push(item);\n        // Reserve enough for the bounded cursor and fragment facts.\n        if (bytes(page()) > SESSION_EVENT_VIEW_MAX_BYTES - 4096 - reservedBytes) {\n          events.pop();\n          if (events.length > 0) {\n            resume(event.sequence, offset);\n            if (selection.direction === \"before\") events.reverse();\n            return page();\n          }\n          if (!item.text) throw new Error(\"Session event identity exceeds page budget\");\n          const text = item.text;\n          let low = 0;\n          let high = text.length;\n          while (low < high) {\n            const mid = Math.ceil((low + high) / 2);\n            if (\n              bytes({ ...item, text: text.slice(0, mid) }) <=\n              SESSION_EVENT_VIEW_MAX_BYTES - 6000 - reservedBytes\n            )\n              low = mid;\n            else high = mid - 1;\n          }\n          // Do not split a UTF-16 surrogate pair (UTF-8 remains lossless).\n          if (low > 0 && /[\\uD800-\\uDBFF]/.test(text[low - 1]!)) low -= 1;\n          if (low === 0) throw new Error(\"Session event identity exceeds page budget\");\n          events.push({\n            ...item,\n            text: text.slice(0, low),\n            fragment: {\n              offset,\n              nextOffset: offset + advance(text.slice(0, low)),\n              complete: false,\n              unit: slice?.unit ?? \"utf16\",\n            },\n          });\n          resume(event.sequence, offset + advance(text.slice(0, low)));\n          return page();\n        }\n        const nextOffset = offset + advance(item.text ?? \"\");\n        if (slice && !slice.omitted && nextOffset < slice.total) {\n          item.fragment = { offset, nextOffset, complete: false, unit: slice.unit };\n          resume(event.sequence, nextOffset);\n          if (selection.direction === \"before\") events.reverse();\n          return page();\n        }\n        if (offset > 0)\n          item.fragment = {\n            offset,\n            nextOffset,\n            complete: true,\n            unit: slice?.unit ?? \"utf16\",\n          };\n      }\n      edge = event.sequence;\n      legacyActive = false;\n      if (selection.direction === \"after\") after = event.sequence;\n      else before = event.sequence;\n      if (events.length >= limit) {\n        hasMore = source.hasMore || event !== ordered.at(-1);\n        nextCursor = hasMore ? encode({ ...selection, after, before }) : null;\n        if (selection.direction === \"before\") events.reverse();\n        return page();\n      }\n    }\n    // Metadata selection can advance over stale/duplicate rows without a\n    // projected payload. Use its covered edge rather than repeating the page.\n    if (source.coveredSequence) {\n      if (selection.direction === \"after\") after = Math.max(after, source.coveredSequence.last);\n      else before = Math.min(before ?? Infinity, source.coveredSequence.first);\n    }\n    if (!source.hasMore) {\n      hasMore = false;\n      nextCursor = null;\n      if (selection.direction === \"before\") events.reverse();\n      return page();\n    }\n    hasMore = true;\n    nextCursor = encode({ ...selection, after, before });\n  }\n  if (selection.direction === \"before\") events.reverse();\n  return page();\n}\n"],"mappings":"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","names":["value"]}

package/dist/signed-state-secret.d.ts

@@ -0,0 +1,18 @@
+import type { Settings } from "@opengeni/config";
+export type SignedStateSecretSource = "explicit" | "integrations_state_secret" | "better_auth_secret" | "environments_encryption_key" | "process_random";
+/**
+ * Resolves the key that signs short-lived browser state (GitHub App setup,
+ * Codex device sign-in, PR review install and similar round trips).
+ *
+ * Every API replica must resolve the same key, or a state minted by one
+ * replica is refused by the next. An explicit
+ * `OPENGENI_GITHUB_APP_MANIFEST_STATE_SECRET` is used as-is. Otherwise the key
+ * is derived (HMAC with a fixed label) from the first stable deployment secret
+ * that exists, so multi-replica deployments work without an extra variable.
+ * Only a deployment with no stable secret at all falls back to a per-process
+ * random key, which is correct for a single process only.
+ */
+export declare function resolveSignedStateSecret(settings: Pick<Settings, "githubAppManifestStateSecret" | "integrationsStateSecret" | "betterAuthSecret" | "environmentsEncryptionKey">): {
+    secret: string;
+    source: SignedStateSecretSource;
+};