@opengeni/contracts 5.5.0 → 5.5.2-canary.40656248492001

package/dist/chunk-UH4K7GP7.js

@@ -0,0 +1,424 @@
+import {
+  nonnegativeInteger,
+  positiveInteger,
+  string
+} from "./chunk-AQYDZUJV.js";
+import {
+  defineSchema
+} from "./chunk-56SNIMDO.js";
+
+// src/retained-output.ts
+import { z } from "zod";
+var RETAINED_OUTPUT_MAX_PAGE_BYTES = 1024 * 1024;
+var RETAINED_OUTPUT_DEFAULT_PAGE_BYTES = 256 * 1024;
+var RETAINED_OUTPUT_RECEIPT_MAX_BYTES = 2 * 1024;
+var COMPUTER_SCREENSHOT_MAX_BYTES = 32 * 1024 * 1024;
+var COMPUTER_SCREENSHOT_MAX_DIMENSION = 16384;
+var COMPUTER_SCREENSHOT_MAX_PIXELS = 67108864;
+var COMPUTER_SCREENSHOT_RETENTION_MS = 30 * 24 * 60 * 60 * 1e3;
+var GENERATED_IMAGE_MAX_BYTES = 64 * 1024 * 1024;
+var GENERATED_VIDEO_MAX_BYTES = 512 * 1024 * 1024;
+var encoder = new TextEncoder();
+var LOWERCASE_UUID = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/;
+var LOWERCASE_SHA256 = /^[0-9a-f]{64}$/;
+var CANONICAL_MEDIA_TYPE = /^[a-z0-9][a-z0-9!#$&^_.+-]{0,62}\/[a-z0-9][a-z0-9!#$&^_.+-]{0,62}$/;
+var WORKSPACE_RETRIEVAL_PATH = /^\/v1\/workspaces\/([0-9a-f-]+)\/artifacts\/([0-9a-f-]+)\/content$/;
+var SESSION_RETRIEVAL_PATH = /^\/v1\/workspaces\/([0-9a-f-]+)\/sessions\/([0-9a-f-]+)\/artifacts\/([0-9a-f-]+)\/content$/;
+var RetainedOutputKind = /* @__PURE__ */ defineSchema(
+  () => z.enum([
+    "tool_result",
+    "assistant_completion",
+    "internal_update",
+    "event_media",
+    "computer_screenshot",
+    "browser_screenshot",
+    "generated_image",
+    "generated_video",
+    "file"
+  ])
+);
+var RetainedOutputUnavailableReason = /* @__PURE__ */ defineSchema(
+  () => z.enum([
+    "not_retained",
+    "pending",
+    "failed",
+    "expired",
+    "deleted",
+    "missing_storage",
+    "storage_write_failed",
+    "quota_exceeded",
+    "invalid_content",
+    "oversized",
+    "unsupported",
+    // The file exists but is Only me for someone else. Never says whose.
+    "private"
+  ])
+);
+var RetainedOutputUnavailableEvidenceSchema = /* @__PURE__ */ defineSchema(
+  () => z.object({
+    available: z.literal(false),
+    reason: RetainedOutputUnavailableReason
+  }).strict()
+);
+var RetainedArtifactReferenceSchema = /* @__PURE__ */ defineSchema(
+  () => z.object({
+    available: z.literal(true),
+    artifactId: string.regex(LOWERCASE_UUID),
+    kind: RetainedOutputKind,
+    contentType: z.string().max(127).regex(CANONICAL_MEDIA_TYPE),
+    originalBytes: nonnegativeInteger.safe(),
+    sha256: string.regex(LOWERCASE_SHA256),
+    retainedAt: string.datetime({ offset: true }),
+    dimensions: z.object({
+      width: positiveInteger.max(COMPUTER_SCREENSHOT_MAX_DIMENSION),
+      height: positiveInteger.max(COMPUTER_SCREENSHOT_MAX_DIMENSION)
+    }).strict().optional(),
+    retention: z.union([
+      z.object({
+        policy: z.literal("workspace_file"),
+        expiresAt: z.null()
+      }).strict(),
+      z.object({
+        policy: z.literal("session_screenshot"),
+        expiresAt: string.datetime({ offset: true })
+      }).strict()
+    ]),
+    retrieval: z.object({
+      method: z.literal("GET"),
+      path: z.string().max(256),
+      acceptRanges: z.literal("bytes"),
+      maxRangeBytes: positiveInteger.max(RETAINED_OUTPUT_MAX_PAGE_BYTES)
+    }).strict()
+  }).strict().superRefine((value, ctx) => {
+    const workspaceMatch = WORKSPACE_RETRIEVAL_PATH.exec(value.retrieval.path);
+    const sessionMatch = SESSION_RETRIEVAL_PATH.exec(value.retrieval.path);
+    const workspaceId = workspaceMatch?.[1] ?? sessionMatch?.[1];
+    const sessionId = sessionMatch?.[2];
+    const artifactId = workspaceMatch?.[2] ?? sessionMatch?.[3];
+    if (!workspaceId || !LOWERCASE_UUID.test(workspaceId) || sessionId !== void 0 && !LOWERCASE_UUID.test(sessionId) || artifactId !== value.artifactId) {
+      ctx.addIssue({
+        code: "custom",
+        path: ["retrieval", "path"],
+        message: "retrieval path must be a workspace/session API content path for this artifact"
+      });
+    }
+    if (value.kind === "computer_screenshot" || value.kind === "browser_screenshot" || value.kind === "generated_image" || value.kind === "generated_video") {
+      if (!value.dimensions) {
+        ctx.addIssue({
+          code: "custom",
+          path: ["dimensions"],
+          message: `${value.kind} receipts require exact dimensions`
+        });
+      } else if (value.dimensions.width * value.dimensions.height > COMPUTER_SCREENSHOT_MAX_PIXELS) {
+        ctx.addIssue({
+          code: "custom",
+          path: ["dimensions"],
+          message: `${value.kind} dimensions exceed the pixel limit`
+        });
+      }
+    }
+    if (value.kind === "generated_image") {
+      if (value.retention.policy !== "workspace_file" || !workspaceMatch || sessionMatch) {
+        ctx.addIssue({
+          code: "custom",
+          path: ["retention"],
+          message: "generated images require permanent workspace-file retrieval"
+        });
+      }
+      if (!["image/png", "image/jpeg", "image/webp"].includes(value.contentType) || value.originalBytes <= 0 || value.originalBytes > GENERATED_IMAGE_MAX_BYTES) {
+        ctx.addIssue({
+          code: "custom",
+          path: ["contentType"],
+          message: "generated image media metadata is invalid"
+        });
+      }
+    }
+    if (value.kind === "generated_video") {
+      if (value.retention.policy !== "workspace_file" || !workspaceMatch || sessionMatch) {
+        ctx.addIssue({
+          code: "custom",
+          path: ["retention"],
+          message: "generated videos require permanent workspace-file retrieval"
+        });
+      }
+      if (value.contentType !== "video/mp4" || value.originalBytes <= 0 || value.originalBytes > GENERATED_VIDEO_MAX_BYTES) {
+        ctx.addIssue({
+          code: "custom",
+          path: ["contentType"],
+          message: "generated video media metadata is invalid"
+        });
+      }
+    }
+    if (value.kind === "computer_screenshot" || value.kind === "browser_screenshot") {
+      if (value.retention.policy !== "session_screenshot" || !sessionMatch) {
+        ctx.addIssue({
+          code: "custom",
+          path: ["retention"],
+          message: "session screenshots require session-scoped expiring retrieval"
+        });
+      }
+    }
+    if (encoder.encode(JSON.stringify(value)).byteLength > RETAINED_OUTPUT_RECEIPT_MAX_BYTES) {
+      ctx.addIssue({
+        code: "custom",
+        message: "retained-output receipt exceeds its byte envelope"
+      });
+    }
+  })
+);
+var RetainedOutputEvidenceSchema = /* @__PURE__ */ defineSchema(
+  () => z.discriminatedUnion("available", [
+    RetainedOutputUnavailableEvidenceSchema,
+    RetainedArtifactReferenceSchema
+  ])
+);
+var RetainedArtifactUnavailableSchema = /* @__PURE__ */ defineSchema(
+  () => z.object({
+    available: z.literal(false),
+    artifactId: string.regex(LOWERCASE_UUID),
+    reason: RetainedOutputUnavailableReason
+  }).strict()
+);
+var RetainedArtifactMetadataSchema = /* @__PURE__ */ defineSchema(
+  () => z.union([RetainedArtifactReferenceSchema, RetainedArtifactUnavailableSchema])
+);
+function retainedSessionScreenshotKindFromObjectKey(objectKey) {
+  const match = /^workspaces\/[0-9a-f-]+\/files\/[0-9a-f-]+\/retained\/(session-image|computer-screenshot|screenshot|browser-screenshot)\.(png|jpg|webp)$/.exec(
+    objectKey
+  );
+  if (!match) return null;
+  return match[1] === "browser-screenshot" ? "browser_screenshot" : "computer_screenshot";
+}
+function retainedArtifactReferenceFromFile(file, kind = "file") {
+  if (file.status !== "ready" || !file.sha256) return null;
+  const value = {
+    available: true,
+    artifactId: file.id,
+    kind,
+    contentType: canonicalRetainedContentType(file.contentType),
+    originalBytes: file.sizeBytes,
+    sha256: file.sha256,
+    retainedAt: file.updatedAt,
+    retention: {
+      policy: "workspace_file",
+      expiresAt: null
+    },
+    retrieval: {
+      method: "GET",
+      path: `/v1/workspaces/${file.workspaceId}/artifacts/${file.id}/content`,
+      acceptRanges: "bytes",
+      maxRangeBytes: RETAINED_OUTPUT_MAX_PAGE_BYTES
+    }
+  };
+  const parsed = RetainedArtifactReferenceSchema.safeParse(value);
+  return parsed.success ? parsed.data : null;
+}
+function retainedScreenshotReferenceFromFile(file) {
+  if (file.status !== "ready" || !file.sha256 || file.sizeBytes <= 0) return null;
+  const value = {
+    available: true,
+    artifactId: file.id,
+    kind: file.kind ?? "computer_screenshot",
+    contentType: canonicalRetainedContentType(file.contentType),
+    originalBytes: file.sizeBytes,
+    sha256: file.sha256,
+    retainedAt: file.updatedAt,
+    dimensions: { width: file.width, height: file.height },
+    retention: {
+      policy: "session_screenshot",
+      expiresAt: file.expiresAt
+    },
+    retrieval: {
+      method: "GET",
+      path: `/v1/workspaces/${file.workspaceId}/sessions/${file.sessionId}/artifacts/${file.id}/content`,
+      acceptRanges: "bytes",
+      maxRangeBytes: RETAINED_OUTPUT_MAX_PAGE_BYTES
+    }
+  };
+  const parsed = RetainedArtifactReferenceSchema.safeParse(value);
+  return parsed.success ? parsed.data : null;
+}
+function retainedGeneratedImageReferenceFromFile(file) {
+  if (file.status !== "ready" || !file.sha256 || file.sizeBytes <= 0 || file.sizeBytes > GENERATED_IMAGE_MAX_BYTES) {
+    return null;
+  }
+  const value = {
+    available: true,
+    artifactId: file.id,
+    kind: "generated_image",
+    contentType: canonicalRetainedContentType(file.contentType),
+    originalBytes: file.sizeBytes,
+    sha256: file.sha256,
+    retainedAt: file.updatedAt,
+    dimensions: { width: file.width, height: file.height },
+    retention: {
+      policy: "workspace_file",
+      expiresAt: null
+    },
+    retrieval: {
+      method: "GET",
+      path: `/v1/workspaces/${file.workspaceId}/artifacts/${file.id}/content`,
+      acceptRanges: "bytes",
+      maxRangeBytes: RETAINED_OUTPUT_MAX_PAGE_BYTES
+    }
+  };
+  const parsed = RetainedArtifactReferenceSchema.safeParse(value);
+  return parsed.success ? parsed.data : null;
+}
+function retainedGeneratedVideoReferenceFromFile(file) {
+  if (file.status !== "ready" || file.contentType !== "video/mp4" || !file.sha256 || file.sizeBytes <= 0 || file.sizeBytes > GENERATED_VIDEO_MAX_BYTES) {
+    return null;
+  }
+  const value = {
+    available: true,
+    artifactId: file.id,
+    kind: "generated_video",
+    contentType: "video/mp4",
+    originalBytes: file.sizeBytes,
+    sha256: file.sha256,
+    retainedAt: file.updatedAt,
+    dimensions: { width: file.width, height: file.height },
+    retention: {
+      policy: "workspace_file",
+      expiresAt: null
+    },
+    retrieval: {
+      method: "GET",
+      path: `/v1/workspaces/${file.workspaceId}/artifacts/${file.id}/content`,
+      acceptRanges: "bytes",
+      maxRangeBytes: RETAINED_OUTPUT_MAX_PAGE_BYTES
+    }
+  };
+  const parsed = RetainedArtifactReferenceSchema.safeParse(value);
+  return parsed.success ? parsed.data : null;
+}
+function canonicalRetainedContentType(value) {
+  const mediaType = value.split(";", 1)[0]?.trim().toLowerCase() ?? "";
+  return CANONICAL_MEDIA_TYPE.test(mediaType) ? mediaType : "application/octet-stream";
+}
+function validateRetainedOutputEvidence(value) {
+  const parsed = RetainedOutputEvidenceSchema.safeParse(value);
+  return parsed.success ? parsed.data : null;
+}
+function retainedOutputUnavailable(reason = "not_retained") {
+  return { available: false, reason };
+}
+function resolveRetainedOutputRange(rangeHeader, totalBytes, maxPageBytes = RETAINED_OUTPUT_DEFAULT_PAGE_BYTES) {
+  assertRangeInputs(totalBytes, maxPageBytes);
+  if (rangeHeader === null || rangeHeader === void 0 || rangeHeader === "") {
+    if (totalBytes === 0) {
+      return {
+        kind: "empty",
+        length: 0,
+        totalBytes: 0,
+        status: 200,
+        contentRange: null,
+        acceptRanges: "bytes"
+      };
+    }
+    const end = Math.min(totalBytes - 1, maxPageBytes - 1);
+    const partial = end + 1 < totalBytes;
+    return resolvedRange(0, end, totalBytes, partial ? 206 : 200);
+  }
+  if (rangeHeader.length > 128 || /[^\x20-\x7e]/.test(rangeHeader)) {
+    return invalidRange("malformed", maxPageBytes);
+  }
+  if (rangeHeader.includes(",")) {
+    return invalidRange("multipart_not_supported", maxPageBytes);
+  }
+  const match = /^bytes=(\d*)-(\d*)$/.exec(rangeHeader);
+  if (!match || !match[1] && !match[2]) {
+    return invalidRange("malformed", maxPageBytes);
+  }
+  const first = parseRangeInteger(match[1]);
+  const second = parseRangeInteger(match[2]);
+  if (first === "overflow" || second === "overflow") {
+    return invalidRange("numeric_overflow", maxPageBytes);
+  }
+  if (first === null) {
+    const suffixLength = second;
+    if (suffixLength === null) return invalidRange("malformed", maxPageBytes);
+    if (suffixLength === 0) return unsatisfiableRange("zero_suffix", totalBytes);
+    if (suffixLength > maxPageBytes) return invalidRange("range_too_large", maxPageBytes);
+    if (totalBytes === 0) return unsatisfiableRange("empty_artifact", totalBytes);
+    const length = Math.min(suffixLength, totalBytes);
+    return resolvedRange(totalBytes - length, totalBytes - 1, totalBytes, 206);
+  }
+  if (totalBytes === 0) return unsatisfiableRange("empty_artifact", totalBytes);
+  if (first >= totalBytes) return unsatisfiableRange("start_out_of_bounds", totalBytes);
+  if (second === null) {
+    const end = Math.min(totalBytes - 1, first + maxPageBytes - 1);
+    return resolvedRange(first, end, totalBytes, 206);
+  }
+  if (second < first) return unsatisfiableRange("end_before_start", totalBytes);
+  if (second - first >= maxPageBytes) {
+    return invalidRange("range_too_large", maxPageBytes);
+  }
+  return resolvedRange(first, Math.min(second, totalBytes - 1), totalBytes, 206);
+}
+function assertRangeInputs(totalBytes, maxPageBytes) {
+  if (!Number.isSafeInteger(totalBytes) || totalBytes < 0) {
+    throw new RangeError("totalBytes must be a nonnegative safe integer");
+  }
+  if (!Number.isSafeInteger(maxPageBytes) || maxPageBytes <= 0 || maxPageBytes > RETAINED_OUTPUT_MAX_PAGE_BYTES) {
+    throw new RangeError(
+      `maxPageBytes must be an integer between 1 and ${RETAINED_OUTPUT_MAX_PAGE_BYTES}`
+    );
+  }
+}
+function parseRangeInteger(value) {
+  if (!value) return null;
+  if (value.length > 16) return "overflow";
+  const parsed = Number(value);
+  return Number.isSafeInteger(parsed) ? parsed : "overflow";
+}
+function resolvedRange(start, end, totalBytes, status) {
+  return {
+    kind: "range",
+    start,
+    end,
+    length: end - start + 1,
+    totalBytes,
+    status,
+    contentRange: status === 206 ? `bytes ${start}-${end}/${totalBytes}` : null,
+    acceptRanges: "bytes"
+  };
+}
+function invalidRange(reason, maxPageBytes) {
+  return { kind: "invalid", reason, maxPageBytes };
+}
+function unsatisfiableRange(reason, totalBytes) {
+  return {
+    kind: "unsatisfiable",
+    reason,
+    totalBytes,
+    contentRange: `bytes */${totalBytes}`
+  };
+}
+
+export {
+  RETAINED_OUTPUT_MAX_PAGE_BYTES,
+  RETAINED_OUTPUT_DEFAULT_PAGE_BYTES,
+  RETAINED_OUTPUT_RECEIPT_MAX_BYTES,
+  COMPUTER_SCREENSHOT_MAX_BYTES,
+  COMPUTER_SCREENSHOT_MAX_DIMENSION,
+  COMPUTER_SCREENSHOT_MAX_PIXELS,
+  COMPUTER_SCREENSHOT_RETENTION_MS,
+  GENERATED_IMAGE_MAX_BYTES,
+  GENERATED_VIDEO_MAX_BYTES,
+  RetainedOutputKind,
+  RetainedOutputUnavailableReason,
+  RetainedArtifactReferenceSchema,
+  RetainedOutputEvidenceSchema,
+  RetainedArtifactUnavailableSchema,
+  RetainedArtifactMetadataSchema,
+  retainedSessionScreenshotKindFromObjectKey,
+  retainedArtifactReferenceFromFile,
+  retainedScreenshotReferenceFromFile,
+  retainedGeneratedImageReferenceFromFile,
+  retainedGeneratedVideoReferenceFromFile,
+  validateRetainedOutputEvidence,
+  retainedOutputUnavailable,
+  resolveRetainedOutputRange
+};
+//# sourceMappingURL=chunk-UH4K7GP7.js.map

package/dist/chunk-UH4K7GP7.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/retained-output.ts"],"sourcesContent":["import * as primitives from \"./primitives\";\nimport { defineSchema } from \"./define-schema\";\nimport { z } from \"zod\";\n\n/** Hard server-side ceiling for one retained-output response body. */\nexport const RETAINED_OUTPUT_MAX_PAGE_BYTES = 1024 * 1024;\n/** Default first page when the client does not send a Range header. */\nexport const RETAINED_OUTPUT_DEFAULT_PAGE_BYTES = 256 * 1024;\n/** Receipts are timeline references, never an extensible metadata bag. */\nexport const RETAINED_OUTPUT_RECEIPT_MAX_BYTES = 2 * 1024;\n\n/** Screenshot bytes are accounted separately from the 10k-token text policy. */\nexport const COMPUTER_SCREENSHOT_MAX_BYTES = 32 * 1024 * 1024;\nexport const COMPUTER_SCREENSHOT_MAX_DIMENSION = 16_384;\nexport const COMPUTER_SCREENSHOT_MAX_PIXELS = 67_108_864;\n/** Canonical ready-object retention window: 30 days from successful settlement. */\nexport const COMPUTER_SCREENSHOT_RETENTION_MS = 30 * 24 * 60 * 60 * 1_000;\n/** Generated images are permanent workspace files, never inline history blobs. */\nexport const GENERATED_IMAGE_MAX_BYTES = 64 * 1024 * 1024;\n/** Generated videos are permanent workspace files and are always streamed. */\nexport const GENERATED_VIDEO_MAX_BYTES = 512 * 1024 * 1024;\n\nconst encoder = new TextEncoder();\nconst LOWERCASE_UUID = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/;\nconst LOWERCASE_SHA256 = /^[0-9a-f]{64}$/;\nconst CANONICAL_MEDIA_TYPE = /^[a-z0-9][a-z0-9!#$&^_.+-]{0,62}\\/[a-z0-9][a-z0-9!#$&^_.+-]{0,62}$/;\nconst WORKSPACE_RETRIEVAL_PATH =\n  /^\\/v1\\/workspaces\\/([0-9a-f-]+)\\/artifacts\\/([0-9a-f-]+)\\/content$/;\nconst SESSION_RETRIEVAL_PATH =\n  /^\\/v1\\/workspaces\\/([0-9a-f-]+)\\/sessions\\/([0-9a-f-]+)\\/artifacts\\/([0-9a-f-]+)\\/content$/;\n\nexport const RetainedOutputKind = /* @__PURE__ */ defineSchema(() =>\n  z.enum([\n    \"tool_result\",\n    \"assistant_completion\",\n    \"internal_update\",\n    \"event_media\",\n    \"computer_screenshot\",\n    \"browser_screenshot\",\n    \"generated_image\",\n    \"generated_video\",\n    \"file\",\n  ]),\n);\nexport type RetainedOutputKind = z.infer<typeof RetainedOutputKind>;\n\nexport const RetainedOutputUnavailableReason = /* @__PURE__ */ defineSchema(() =>\n  z.enum([\n    \"not_retained\",\n    \"pending\",\n    \"failed\",\n    \"expired\",\n    \"deleted\",\n    \"missing_storage\",\n    \"storage_write_failed\",\n    \"quota_exceeded\",\n    \"invalid_content\",\n    \"oversized\",\n    \"unsupported\",\n    // The file exists but is Only me for someone else. Never says whose.\n    \"private\",\n  ]),\n);\nexport type RetainedOutputUnavailableReason = z.infer<typeof RetainedOutputUnavailableReason>;\n\nconst RetainedOutputUnavailableEvidenceSchema = /* @__PURE__ */ defineSchema(() =>\n  z\n    .object({\n      available: z.literal(false),\n      reason: RetainedOutputUnavailableReason,\n    })\n    .strict(),\n);\n\nexport const RetainedArtifactReferenceSchema = /* @__PURE__ */ defineSchema(() =>\n  z\n    .object({\n      available: z.literal(true),\n      artifactId: primitives.string.regex(LOWERCASE_UUID),\n      kind: RetainedOutputKind,\n      contentType: z.string().max(127).regex(CANONICAL_MEDIA_TYPE),\n      originalBytes: primitives.nonnegativeInteger.safe(),\n      sha256: primitives.string.regex(LOWERCASE_SHA256),\n      retainedAt: primitives.string.datetime({ offset: true }),\n      dimensions: z\n        .object({\n          width: primitives.positiveInteger.max(COMPUTER_SCREENSHOT_MAX_DIMENSION),\n          height: primitives.positiveInteger.max(COMPUTER_SCREENSHOT_MAX_DIMENSION),\n        })\n        .strict()\n        .optional(),\n      retention: z.union([\n        z\n          .object({\n            policy: z.literal(\"workspace_file\"),\n            expiresAt: z.null(),\n          })\n          .strict(),\n        z\n          .object({\n            policy: z.literal(\"session_screenshot\"),\n            expiresAt: primitives.string.datetime({ offset: true }),\n          })\n          .strict(),\n      ]),\n      retrieval: z\n        .object({\n          method: z.literal(\"GET\"),\n          path: z.string().max(256),\n          acceptRanges: z.literal(\"bytes\"),\n          maxRangeBytes: primitives.positiveInteger.max(RETAINED_OUTPUT_MAX_PAGE_BYTES),\n        })\n        .strict(),\n    })\n    .strict()\n    .superRefine((value, ctx) => {\n      const workspaceMatch = WORKSPACE_RETRIEVAL_PATH.exec(value.retrieval.path);\n      const sessionMatch = SESSION_RETRIEVAL_PATH.exec(value.retrieval.path);\n      const workspaceId = workspaceMatch?.[1] ?? sessionMatch?.[1];\n      const sessionId = sessionMatch?.[2];\n      const artifactId = workspaceMatch?.[2] ?? sessionMatch?.[3];\n      if (\n        !workspaceId ||\n        !LOWERCASE_UUID.test(workspaceId) ||\n        (sessionId !== undefined && !LOWERCASE_UUID.test(sessionId)) ||\n        artifactId !== value.artifactId\n      ) {\n        ctx.addIssue({\n          code: \"custom\",\n          path: [\"retrieval\", \"path\"],\n          message: \"retrieval path must be a workspace/session API content path for this artifact\",\n        });\n      }\n\n      if (\n        value.kind === \"computer_screenshot\" ||\n        value.kind === \"browser_screenshot\" ||\n        value.kind === \"generated_image\" ||\n        value.kind === \"generated_video\"\n      ) {\n        if (!value.dimensions) {\n          ctx.addIssue({\n            code: \"custom\",\n            path: [\"dimensions\"],\n            message: `${value.kind} receipts require exact dimensions`,\n          });\n        } else if (\n          value.dimensions.width * value.dimensions.height >\n          COMPUTER_SCREENSHOT_MAX_PIXELS\n        ) {\n          ctx.addIssue({\n            code: \"custom\",\n            path: [\"dimensions\"],\n            message: `${value.kind} dimensions exceed the pixel limit`,\n          });\n        }\n      }\n\n      if (value.kind === \"generated_image\") {\n        if (value.retention.policy !== \"workspace_file\" || !workspaceMatch || sessionMatch) {\n          ctx.addIssue({\n            code: \"custom\",\n            path: [\"retention\"],\n            message: \"generated images require permanent workspace-file retrieval\",\n          });\n        }\n        if (\n          ![\"image/png\", \"image/jpeg\", \"image/webp\"].includes(value.contentType) ||\n          value.originalBytes <= 0 ||\n          value.originalBytes > GENERATED_IMAGE_MAX_BYTES\n        ) {\n          ctx.addIssue({\n            code: \"custom\",\n            path: [\"contentType\"],\n            message: \"generated image media metadata is invalid\",\n          });\n        }\n      }\n\n      if (value.kind === \"generated_video\") {\n        if (value.retention.policy !== \"workspace_file\" || !workspaceMatch || sessionMatch) {\n          ctx.addIssue({\n            code: \"custom\",\n            path: [\"retention\"],\n            message: \"generated videos require permanent workspace-file retrieval\",\n          });\n        }\n        if (\n          value.contentType !== \"video/mp4\" ||\n          value.originalBytes <= 0 ||\n          value.originalBytes > GENERATED_VIDEO_MAX_BYTES\n        ) {\n          ctx.addIssue({\n            code: \"custom\",\n            path: [\"contentType\"],\n            message: \"generated video media metadata is invalid\",\n          });\n        }\n      }\n\n      if (value.kind === \"computer_screenshot\" || value.kind === \"browser_screenshot\") {\n        if (value.retention.policy !== \"session_screenshot\" || !sessionMatch) {\n          ctx.addIssue({\n            code: \"custom\",\n            path: [\"retention\"],\n            message: \"session screenshots require session-scoped expiring retrieval\",\n          });\n        }\n      }\n\n      if (encoder.encode(JSON.stringify(value)).byteLength > RETAINED_OUTPUT_RECEIPT_MAX_BYTES) {\n        ctx.addIssue({\n          code: \"custom\",\n          message: \"retained-output receipt exceeds its byte envelope\",\n        });\n      }\n    }),\n);\n\n/**\n * Canonical evidence fact carried by bounded audit/NATS/SSE/UI previews.\n *\n * The available variant is intentionally provider-neutral and closed: no bucket,\n * object key, signed URL, arbitrary metadata, or producer-controlled labels can\n * cross this boundary.\n */\nexport const RetainedOutputEvidenceSchema = /* @__PURE__ */ defineSchema(() =>\n  z.discriminatedUnion(\"available\", [\n    RetainedOutputUnavailableEvidenceSchema,\n    RetainedArtifactReferenceSchema,\n  ]),\n);\nexport type RetainedOutputEvidence = z.infer<typeof RetainedOutputEvidenceSchema>;\nexport type RetainedArtifactReference = z.infer<typeof RetainedArtifactReferenceSchema>;\n/** @deprecated use RetainedArtifactReference. */\nexport type RetainedOutputAvailableEvidence = RetainedArtifactReference;\n\nexport const RetainedArtifactUnavailableSchema = /* @__PURE__ */ defineSchema(() =>\n  z\n    .object({\n      available: z.literal(false),\n      artifactId: primitives.string.regex(LOWERCASE_UUID),\n      reason: RetainedOutputUnavailableReason,\n    })\n    .strict(),\n);\nexport type RetainedArtifactUnavailable = z.infer<typeof RetainedArtifactUnavailableSchema>;\n\n/** Authenticated metadata result for one opaque workspace file identity. */\nexport const RetainedArtifactMetadataSchema = /* @__PURE__ */ defineSchema(() =>\n  z.union([RetainedArtifactReferenceSchema, RetainedArtifactUnavailableSchema]),\n);\nexport type RetainedArtifactMetadata = z.infer<typeof RetainedArtifactMetadataSchema>;\n\nexport type RetainedArtifactFileInput = {\n  id: string;\n  workspaceId: string;\n  status: string;\n  contentType: string;\n  sizeBytes: number;\n  sha256: string | null;\n  updatedAt: string;\n};\n\nexport type RetainedScreenshotArtifactInput = RetainedArtifactFileInput & {\n  sessionId: string;\n  width: number;\n  height: number;\n  expiresAt: string;\n  kind?: \"computer_screenshot\" | \"browser_screenshot\";\n};\n\nexport type RetainedSessionScreenshotKind = \"computer_screenshot\" | \"browser_screenshot\";\n\n/** The persisted, server-authored storage key distinguishes browser captures from legacy computer captures. */\nexport function retainedSessionScreenshotKindFromObjectKey(\n  objectKey: string,\n): RetainedSessionScreenshotKind | null {\n  const match =\n    /^workspaces\\/[0-9a-f-]+\\/files\\/[0-9a-f-]+\\/retained\\/(session-image|computer-screenshot|screenshot|browser-screenshot)\\.(png|jpg|webp)$/.exec(\n      objectKey,\n    );\n  if (!match) return null;\n  return match[1] === \"browser-screenshot\" ? \"browser_screenshot\" : \"computer_screenshot\";\n}\n\nexport type RetainedGeneratedImageArtifactInput = RetainedArtifactFileInput & {\n  width: number;\n  height: number;\n};\n\nexport type RetainedGeneratedVideoArtifactInput = RetainedArtifactFileInput & {\n  width: number;\n  height: number;\n};\n\n/**\n * Convert a ready, integrity-addressed workspace file into the only available\n * retained-output receipt shape. Invalid, pending, or checksum-less files fail\n * closed instead of implying that full evidence is retrievable.\n */\nexport function retainedArtifactReferenceFromFile(\n  file: RetainedArtifactFileInput,\n  kind: RetainedOutputKind = \"file\",\n): RetainedArtifactReference | null {\n  if (file.status !== \"ready\" || !file.sha256) return null;\n  const value = {\n    available: true as const,\n    artifactId: file.id,\n    kind,\n    contentType: canonicalRetainedContentType(file.contentType),\n    originalBytes: file.sizeBytes,\n    sha256: file.sha256,\n    retainedAt: file.updatedAt,\n    retention: {\n      policy: \"workspace_file\" as const,\n      expiresAt: null,\n    },\n    retrieval: {\n      method: \"GET\" as const,\n      path: `/v1/workspaces/${file.workspaceId}/artifacts/${file.id}/content`,\n      acceptRanges: \"bytes\" as const,\n      maxRangeBytes: RETAINED_OUTPUT_MAX_PAGE_BYTES,\n    },\n  };\n  const parsed = RetainedArtifactReferenceSchema.safeParse(value);\n  return parsed.success ? parsed.data : null;\n}\n\n/** Build the closed, session-scoped receipt for one ready screenshot file. */\nexport function retainedScreenshotReferenceFromFile(\n  file: RetainedScreenshotArtifactInput,\n): RetainedArtifactReference | null {\n  if (file.status !== \"ready\" || !file.sha256 || file.sizeBytes <= 0) return null;\n  const value = {\n    available: true as const,\n    artifactId: file.id,\n    kind: file.kind ?? \"computer_screenshot\",\n    contentType: canonicalRetainedContentType(file.contentType),\n    originalBytes: file.sizeBytes,\n    sha256: file.sha256,\n    retainedAt: file.updatedAt,\n    dimensions: { width: file.width, height: file.height },\n    retention: {\n      policy: \"session_screenshot\" as const,\n      expiresAt: file.expiresAt,\n    },\n    retrieval: {\n      method: \"GET\" as const,\n      path: `/v1/workspaces/${file.workspaceId}/sessions/${file.sessionId}/artifacts/${file.id}/content`,\n      acceptRanges: \"bytes\" as const,\n      maxRangeBytes: RETAINED_OUTPUT_MAX_PAGE_BYTES,\n    },\n  };\n  const parsed = RetainedArtifactReferenceSchema.safeParse(value);\n  return parsed.success ? parsed.data : null;\n}\n\n/** Build the permanent workspace receipt for one validated generated image. */\nexport function retainedGeneratedImageReferenceFromFile(\n  file: RetainedGeneratedImageArtifactInput,\n): RetainedArtifactReference | null {\n  if (\n    file.status !== \"ready\" ||\n    !file.sha256 ||\n    file.sizeBytes <= 0 ||\n    file.sizeBytes > GENERATED_IMAGE_MAX_BYTES\n  ) {\n    return null;\n  }\n  const value = {\n    available: true as const,\n    artifactId: file.id,\n    kind: \"generated_image\" as const,\n    contentType: canonicalRetainedContentType(file.contentType),\n    originalBytes: file.sizeBytes,\n    sha256: file.sha256,\n    retainedAt: file.updatedAt,\n    dimensions: { width: file.width, height: file.height },\n    retention: {\n      policy: \"workspace_file\" as const,\n      expiresAt: null,\n    },\n    retrieval: {\n      method: \"GET\" as const,\n      path: `/v1/workspaces/${file.workspaceId}/artifacts/${file.id}/content`,\n      acceptRanges: \"bytes\" as const,\n      maxRangeBytes: RETAINED_OUTPUT_MAX_PAGE_BYTES,\n    },\n  };\n  const parsed = RetainedArtifactReferenceSchema.safeParse(value);\n  return parsed.success ? parsed.data : null;\n}\n\n/** Build the permanent workspace receipt for one validated generated video. */\nexport function retainedGeneratedVideoReferenceFromFile(\n  file: RetainedGeneratedVideoArtifactInput,\n): RetainedArtifactReference | null {\n  if (\n    file.status !== \"ready\" ||\n    file.contentType !== \"video/mp4\" ||\n    !file.sha256 ||\n    file.sizeBytes <= 0 ||\n    file.sizeBytes > GENERATED_VIDEO_MAX_BYTES\n  ) {\n    return null;\n  }\n  const value = {\n    available: true as const,\n    artifactId: file.id,\n    kind: \"generated_video\" as const,\n    contentType: \"video/mp4\" as const,\n    originalBytes: file.sizeBytes,\n    sha256: file.sha256,\n    retainedAt: file.updatedAt,\n    dimensions: { width: file.width, height: file.height },\n    retention: {\n      policy: \"workspace_file\" as const,\n      expiresAt: null,\n    },\n    retrieval: {\n      method: \"GET\" as const,\n      path: `/v1/workspaces/${file.workspaceId}/artifacts/${file.id}/content`,\n      acceptRanges: \"bytes\" as const,\n      maxRangeBytes: RETAINED_OUTPUT_MAX_PAGE_BYTES,\n    },\n  };\n  const parsed = RetainedArtifactReferenceSchema.safeParse(value);\n  return parsed.success ? parsed.data : null;\n}\n\nfunction canonicalRetainedContentType(value: string): string {\n  const mediaType = value.split(\";\", 1)[0]?.trim().toLowerCase() ?? \"\";\n  return CANONICAL_MEDIA_TYPE.test(mediaType) ? mediaType : \"application/octet-stream\";\n}\n\n/** Parse and clone a trusted server receipt; invalid/untrusted data fails closed. */\nexport function validateRetainedOutputEvidence(value: unknown): RetainedOutputEvidence | null {\n  const parsed = RetainedOutputEvidenceSchema.safeParse(value);\n  return parsed.success ? parsed.data : null;\n}\n\nexport function retainedOutputUnavailable(\n  reason: RetainedOutputUnavailableReason = \"not_retained\",\n): RetainedOutputEvidence {\n  return { available: false, reason };\n}\n\nexport type RetainedOutputResolvedRange = {\n  kind: \"range\";\n  start: number;\n  end: number;\n  length: number;\n  totalBytes: number;\n  status: 200 | 206;\n  contentRange: string | null;\n  acceptRanges: \"bytes\";\n};\n\nexport type RetainedOutputRangeResolution =\n  | RetainedOutputResolvedRange\n  | {\n      kind: \"empty\";\n      length: 0;\n      totalBytes: 0;\n      status: 200;\n      contentRange: null;\n      acceptRanges: \"bytes\";\n    }\n  | {\n      kind: \"invalid\";\n      reason: \"malformed\" | \"multipart_not_supported\" | \"numeric_overflow\" | \"range_too_large\";\n      maxPageBytes: number;\n    }\n  | {\n      kind: \"unsatisfiable\";\n      reason: \"empty_artifact\" | \"start_out_of_bounds\" | \"end_before_start\" | \"zero_suffix\";\n      totalBytes: number;\n      contentRange: string;\n    };\n\n/**\n * Resolve one RFC-style bytes range without ever licensing a response larger\n * than `maxPageBytes`. Multipart ranges and oversized explicit/suffix requests\n * fail closed. An omitted or open-ended range becomes one resumable bounded page.\n */\nexport function resolveRetainedOutputRange(\n  rangeHeader: string | null | undefined,\n  totalBytes: number,\n  maxPageBytes = RETAINED_OUTPUT_DEFAULT_PAGE_BYTES,\n): RetainedOutputRangeResolution {\n  assertRangeInputs(totalBytes, maxPageBytes);\n\n  if (rangeHeader === null || rangeHeader === undefined || rangeHeader === \"\") {\n    if (totalBytes === 0) {\n      return {\n        kind: \"empty\",\n        length: 0,\n        totalBytes: 0,\n        status: 200,\n        contentRange: null,\n        acceptRanges: \"bytes\",\n      };\n    }\n    const end = Math.min(totalBytes - 1, maxPageBytes - 1);\n    const partial = end + 1 < totalBytes;\n    return resolvedRange(0, end, totalBytes, partial ? 206 : 200);\n  }\n\n  if (rangeHeader.length > 128 || /[^\\x20-\\x7e]/.test(rangeHeader)) {\n    return invalidRange(\"malformed\", maxPageBytes);\n  }\n  if (rangeHeader.includes(\",\")) {\n    return invalidRange(\"multipart_not_supported\", maxPageBytes);\n  }\n  const match = /^bytes=(\\d*)-(\\d*)$/.exec(rangeHeader);\n  if (!match || (!match[1] && !match[2])) {\n    return invalidRange(\"malformed\", maxPageBytes);\n  }\n\n  const first = parseRangeInteger(match[1]);\n  const second = parseRangeInteger(match[2]);\n  if (first === \"overflow\" || second === \"overflow\") {\n    return invalidRange(\"numeric_overflow\", maxPageBytes);\n  }\n\n  if (first === null) {\n    const suffixLength = second;\n    if (suffixLength === null) return invalidRange(\"malformed\", maxPageBytes);\n    if (suffixLength === 0) return unsatisfiableRange(\"zero_suffix\", totalBytes);\n    if (suffixLength > maxPageBytes) return invalidRange(\"range_too_large\", maxPageBytes);\n    if (totalBytes === 0) return unsatisfiableRange(\"empty_artifact\", totalBytes);\n    const length = Math.min(suffixLength, totalBytes);\n    return resolvedRange(totalBytes - length, totalBytes - 1, totalBytes, 206);\n  }\n\n  if (totalBytes === 0) return unsatisfiableRange(\"empty_artifact\", totalBytes);\n  if (first >= totalBytes) return unsatisfiableRange(\"start_out_of_bounds\", totalBytes);\n\n  if (second === null) {\n    const end = Math.min(totalBytes - 1, first + maxPageBytes - 1);\n    return resolvedRange(first, end, totalBytes, 206);\n  }\n  if (second < first) return unsatisfiableRange(\"end_before_start\", totalBytes);\n  if (second - first >= maxPageBytes) {\n    return invalidRange(\"range_too_large\", maxPageBytes);\n  }\n  return resolvedRange(first, Math.min(second, totalBytes - 1), totalBytes, 206);\n}\n\nfunction assertRangeInputs(totalBytes: number, maxPageBytes: number): void {\n  if (!Number.isSafeInteger(totalBytes) || totalBytes < 0) {\n    throw new RangeError(\"totalBytes must be a nonnegative safe integer\");\n  }\n  if (\n    !Number.isSafeInteger(maxPageBytes) ||\n    maxPageBytes <= 0 ||\n    maxPageBytes > RETAINED_OUTPUT_MAX_PAGE_BYTES\n  ) {\n    throw new RangeError(\n      `maxPageBytes must be an integer between 1 and ${RETAINED_OUTPUT_MAX_PAGE_BYTES}`,\n    );\n  }\n}\n\nfunction parseRangeInteger(value: string | undefined): number | null | \"overflow\" {\n  if (!value) return null;\n  // Avoid both precision loss and work proportional to an adversarial digit run.\n  if (value.length > 16) return \"overflow\";\n  const parsed = Number(value);\n  return Number.isSafeInteger(parsed) ? parsed : \"overflow\";\n}\n\nfunction resolvedRange(\n  start: number,\n  end: number,\n  totalBytes: number,\n  status: 200 | 206,\n): RetainedOutputResolvedRange {\n  return {\n    kind: \"range\",\n    start,\n    end,\n    length: end - start + 1,\n    totalBytes,\n    status,\n    contentRange: status === 206 ? `bytes ${start}-${end}/${totalBytes}` : null,\n    acceptRanges: \"bytes\",\n  };\n}\n\nfunction invalidRange(\n  reason: Extract<RetainedOutputRangeResolution, { kind: \"invalid\" }>[\"reason\"],\n  maxPageBytes: number,\n): RetainedOutputRangeResolution {\n  return { kind: \"invalid\", reason, maxPageBytes };\n}\n\nfunction unsatisfiableRange(\n  reason: Extract<RetainedOutputRangeResolution, { kind: \"unsatisfiable\" }>[\"reason\"],\n  totalBytes: number,\n): RetainedOutputRangeResolution {\n  return {\n    kind: \"unsatisfiable\",\n    reason,\n    totalBytes,\n    contentRange: `bytes */${totalBytes}`,\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-UIZWGPHV.js

@@ -0,0 +1,120 @@
+// src/session-history.ts
+var SESSION_EVENT_CONTENT_STEP_TYPES = [
+  "agent.toolCall.created",
+  "agent.toolCall.output",
+  "agent.reasoning.delta",
+  "sandbox.command.output.delta",
+  "terminal.pty.output.delta"
+];
+var SESSION_EVENT_BOOKKEEPING_STEP_TYPES = [
+  "agent.model.request",
+  "agent.model.usage"
+];
+var SESSION_EVENT_STEP_TYPES = [
+  ...SESSION_EVENT_CONTENT_STEP_TYPES,
+  ...SESSION_EVENT_BOOKKEEPING_STEP_TYPES
+];
+var SESSION_EVENT_CONVERSATION_FILTER_VERSION = 2;
+var SESSION_EVENT_CONVERSATION_FILTER_HEADER = "X-OpenGeni-Conversation-Filter";
+var SESSION_EVENT_COMPAT_EXCLUDED_STEP_TYPES = [
+  "agent.toolCall.output",
+  "agent.reasoning.delta",
+  "sandbox.command.output.delta",
+  "terminal.pty.output.delta"
+];
+function isSessionModelResponsePhase(phase) {
+  return phase === "first_byte" || phase === "first_event";
+}
+var SESSION_EVENT_PRESENTED_TOOL_LEAVES = [
+  "generate_image",
+  "image_generation_call",
+  "sandbox_file_publish",
+  "skill_save",
+  "skill_remove",
+  "skill_install",
+  "skill_publish",
+  "instruction_policy_save",
+  "knowledge_save",
+  "knowledge_retain_file",
+  "knowledge_retain_message",
+  "knowledge_archive",
+  "task_note_promote_knowledge",
+  "remember_confirm",
+  "session_create",
+  "session_send_message"
+];
+function isPresentedSessionToolName(name) {
+  if (typeof name !== "string" || name.length === 0) return false;
+  return SESSION_EVENT_PRESENTED_TOOL_LEAVES.some(
+    (leaf) => name === leaf || name.endsWith(`__${leaf}`)
+  );
+}
+var SESSION_EVENT_APP_ACTION_CALL_LEAF = "admin_action_call";
+var SESSION_EVENT_PRESENTED_APP_ACTIONS = {
+  createBillingCheckout: { route: "POST /v1/billing/checkout", page: "credits" },
+  createSubscriptionCheckout: {
+    route: "POST /v1/billing/subscription/checkout",
+    page: "subscription"
+  },
+  createBillingPortalSession: { route: "POST /v1/billing/portal", page: "portal" },
+  createSubscriptionPortalSession: {
+    route: "POST /v1/billing/subscription/portal",
+    page: "portal"
+  }
+};
+var SESSION_EVENT_APP_ACTION_ID_SPACE = " 	\n\v\f\r\xA0\u1680\u2000\u2001\u2002\u2003\u2004\u2005\u2006\u2007\u2008\u2009\u200A\u2028\u2029\u202F\u205F\u3000\uFEFF";
+var SESSION_EVENT_PRESENTED_APP_ACTION_NAMES = Object.entries(
+  SESSION_EVENT_PRESENTED_APP_ACTIONS
+).flatMap(([id, { route }]) => [id, route]);
+var PRESENTED_APP_ACTION_BY_NAME = new Map(
+  Object.entries(SESSION_EVENT_PRESENTED_APP_ACTIONS).flatMap(([id, { route }]) => [
+    [id, id],
+    [route, id]
+  ])
+);
+function trimActionId(value) {
+  let start = 0;
+  let end = value.length;
+  while (start < end && SESSION_EVENT_APP_ACTION_ID_SPACE.includes(value[start])) start += 1;
+  while (end > start && SESSION_EVENT_APP_ACTION_ID_SPACE.includes(value[end - 1])) end -= 1;
+  return value.slice(start, end);
+}
+function presentedAppActionId(id) {
+  return typeof id === "string" ? PRESENTED_APP_ACTION_BY_NAME.get(trimActionId(id)) : void 0;
+}
+function isPresentedSessionToolCall(call) {
+  if (!call || typeof call !== "object") return false;
+  const { name, arguments: args } = call;
+  if (isPresentedSessionToolName(name)) return true;
+  const leaf = SESSION_EVENT_APP_ACTION_CALL_LEAF;
+  if (typeof name !== "string" || name !== leaf && !name.endsWith(`__${leaf}`)) return false;
+  let parsed = args;
+  if (typeof args === "string") {
+    try {
+      parsed = JSON.parse(args);
+    } catch {
+      return false;
+    }
+  }
+  if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) return false;
+  return presentedAppActionId(parsed.id) !== void 0;
+}
+
+export {
+  SESSION_EVENT_CONTENT_STEP_TYPES,
+  SESSION_EVENT_BOOKKEEPING_STEP_TYPES,
+  SESSION_EVENT_STEP_TYPES,
+  SESSION_EVENT_CONVERSATION_FILTER_VERSION,
+  SESSION_EVENT_CONVERSATION_FILTER_HEADER,
+  SESSION_EVENT_COMPAT_EXCLUDED_STEP_TYPES,
+  isSessionModelResponsePhase,
+  SESSION_EVENT_PRESENTED_TOOL_LEAVES,
+  isPresentedSessionToolName,
+  SESSION_EVENT_APP_ACTION_CALL_LEAF,
+  SESSION_EVENT_PRESENTED_APP_ACTIONS,
+  SESSION_EVENT_APP_ACTION_ID_SPACE,
+  SESSION_EVENT_PRESENTED_APP_ACTION_NAMES,
+  presentedAppActionId,
+  isPresentedSessionToolCall
+};
+//# sourceMappingURL=chunk-UIZWGPHV.js.map

package/dist/chunk-UIZWGPHV.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/session-history.ts"],"sourcesContent":["/**\n * Conversation-first session history: which durable events are the steps of a\n * turn, and which tool results stay visible without opening those steps.\n * Dependency-free so browser packages can import it without the schema bundle.\n */\n/**\n * The bulk of a long agent turn: tool calls, their outputs and streamed\n * reasoning or command output. A turn whose window skips any of these has\n * steps a reader can open.\n */\nexport const SESSION_EVENT_CONTENT_STEP_TYPES = [\n  \"agent.toolCall.created\",\n  \"agent.toolCall.output\",\n  \"agent.reasoning.delta\",\n  \"sandbox.command.output.delta\",\n  \"terminal.pty.output.delta\",\n] as const;\n\n/**\n * Turn bookkeeping that renders nothing in the conversation: a turn writes a\n * few `agent.model.request` rows and an `agent.model.usage` row per model\n * call. Only a turn's request rows up to its first model response draw\n * anything (the \"first model response\" startup phase); a conversation-filter\n * server keeps those, and every bookkeeping row of a turn without other\n * steps, so it never looks like it has steps to open.\n */\nexport const SESSION_EVENT_BOOKKEEPING_STEP_TYPES = [\n  \"agent.model.request\",\n  \"agent.model.usage\",\n] as const;\n\n/**\n * Everything conversation-first history reads exclude and load per turn, only\n * when a reader asks for that turn's steps.\n */\nexport const SESSION_EVENT_STEP_TYPES = [\n  ...SESSION_EVENT_CONTENT_STEP_TYPES,\n  ...SESSION_EVENT_BOOKKEEPING_STEP_TYPES,\n] as const;\n\n/**\n * The conversation-filter behavior a server applies to a read that sends\n * `presentedToolCalls=include`, announced in the `X-OpenGeni-Conversation-Filter`\n * response header. Version 2 keeps presented tool calls and the bookkeeping\n * rows described by {@link SESSION_EVENT_BOOKKEEPING_STEP_TYPES}; excluded\n * turnless output (PTY and command output) stays out, for the sandbox dock to\n * read itself. A server without the header may ignore `presentedToolCalls`\n * entirely.\n */\nexport const SESSION_EVENT_CONVERSATION_FILTER_VERSION = 2;\nexport const SESSION_EVENT_CONVERSATION_FILTER_HEADER = \"X-OpenGeni-Conversation-Filter\";\n\n/**\n * What a reader excludes from a conversation read when the server has not\n * announced {@link SESSION_EVENT_CONVERSATION_FILTER_VERSION}: tool calls stay\n * in (an older server would otherwise drop presented calls with them) and the\n * reader drops the ones that are not presented.\n */\nexport const SESSION_EVENT_COMPAT_EXCLUDED_STEP_TYPES = [\n  \"agent.toolCall.output\",\n  \"agent.reasoning.delta\",\n  \"sandbox.command.output.delta\",\n  \"terminal.pty.output.delta\",\n] as const;\n\n/**\n * Whether an `agent.model.request` phase is the model's first response. A\n * turn's request rows after its first response no longer change what the\n * conversation draws.\n */\nexport function isSessionModelResponsePhase(phase: unknown): boolean {\n  return phase === \"first_byte\" || phase === \"first_event\";\n}\n\n/**\n * Tools whose result is primary output a reader sees without opening the\n * turn's steps: presented images and published files, Skill changes that may\n * need review, learning writes whose refusal is told outside the folded work\n * row, and worker spawns or messages that a turn's wait counts. Matched on the\n * tool name's leaf (`x__leaf` or `leaf`).\n */\nexport const SESSION_EVENT_PRESENTED_TOOL_LEAVES = [\n  \"generate_image\",\n  \"image_generation_call\",\n  \"sandbox_file_publish\",\n  \"skill_save\",\n  \"skill_remove\",\n  \"skill_install\",\n  \"skill_publish\",\n  \"instruction_policy_save\",\n  \"knowledge_save\",\n  \"knowledge_retain_file\",\n  \"knowledge_retain_message\",\n  \"knowledge_archive\",\n  \"task_note_promote_knowledge\",\n  \"remember_confirm\",\n  \"session_create\",\n  \"session_send_message\",\n] as const;\n\n/** Whether a tool name is one of {@link SESSION_EVENT_PRESENTED_TOOL_LEAVES}. */\nexport function isPresentedSessionToolName(name: unknown): boolean {\n  if (typeof name !== \"string\" || name.length === 0) return false;\n  return SESSION_EVENT_PRESENTED_TOOL_LEAVES.some(\n    (leaf) => name === leaf || name.endsWith(`__${leaf}`),\n  );\n}\n\n/** The tool leaf a session runs the app's own actions through. */\nexport const SESSION_EVENT_APP_ACTION_CALL_LEAF = \"admin_action_call\";\n\n/** The page an app action opens: buying credits, starting a subscription, or the billing portal. */\nexport type PresentedAppActionPage = \"credits\" | \"subscription\" | \"portal\";\n\n/**\n * App actions whose call is primary output too: each opens a payment page,\n * and the chat shows it as a button that later confirms the payment, which a\n * person returning to the chat (often in a reloaded tab) needs to see.\n * Keyed by action id, with the \"METHOD /path\" a call may name it by instead\n * (as `findAppAction` accepts) and the page it opens.\n */\nexport const SESSION_EVENT_PRESENTED_APP_ACTIONS = {\n  createBillingCheckout: { route: \"POST /v1/billing/checkout\", page: \"credits\" },\n  createSubscriptionCheckout: {\n    route: \"POST /v1/billing/subscription/checkout\",\n    page: \"subscription\",\n  },\n  createBillingPortalSession: { route: \"POST /v1/billing/portal\", page: \"portal\" },\n  createSubscriptionPortalSession: {\n    route: \"POST /v1/billing/subscription/portal\",\n    page: \"portal\",\n  },\n} as const satisfies Record<string, { route: string; page: PresentedAppActionPage }>;\n\nexport type PresentedAppActionId = keyof typeof SESSION_EVENT_PRESENTED_APP_ACTIONS;\n\n/**\n * The whitespace a call's action id is trimmed of before it's matched: exactly\n * what `String.prototype.trim` removes, as the action runner trims the id\n * (`findAppAction`), spelled out so the history query (Postgres `btrim`) and\n * every client agree.\n */\nexport const SESSION_EVENT_APP_ACTION_ID_SPACE =\n  \" \\t\\n\\v\\f\\r\\u00a0\\u1680\\u2000\\u2001\\u2002\\u2003\\u2004\\u2005\\u2006\\u2007\\u2008\\u2009\\u200a\\u2028\\u2029\\u202f\\u205f\\u3000\\ufeff\";\n\n/** Every name that calls one of {@link SESSION_EVENT_PRESENTED_APP_ACTIONS}: each id and its \"METHOD /path\". */\nexport const SESSION_EVENT_PRESENTED_APP_ACTION_NAMES: readonly string[] = Object.entries(\n  SESSION_EVENT_PRESENTED_APP_ACTIONS,\n).flatMap(([id, { route }]) => [id, route]);\n\nconst PRESENTED_APP_ACTION_BY_NAME: ReadonlyMap<string, PresentedAppActionId> = new Map(\n  Object.entries(SESSION_EVENT_PRESENTED_APP_ACTIONS).flatMap(([id, { route }]) => [\n    [id, id as PresentedAppActionId],\n    [route, id as PresentedAppActionId],\n  ]),\n);\n\nfunction trimActionId(value: string): string {\n  let start = 0;\n  let end = value.length;\n  while (start < end && SESSION_EVENT_APP_ACTION_ID_SPACE.includes(value[start]!)) start += 1;\n  while (end > start && SESSION_EVENT_APP_ACTION_ID_SPACE.includes(value[end - 1]!)) end -= 1;\n  return value.slice(start, end);\n}\n\n/**\n * Which of {@link SESSION_EVENT_PRESENTED_APP_ACTIONS} an app action call's\n * `id` names, by its id or its \"METHOD /path\"; undefined for anything else.\n */\nexport function presentedAppActionId(id: unknown): PresentedAppActionId | undefined {\n  return typeof id === \"string\" ? PRESENTED_APP_ACTION_BY_NAME.get(trimActionId(id)) : undefined;\n}\n\n/**\n * Whether a tool call's result is primary output: a presented tool\n * ({@link isPresentedSessionToolName}), or an app action call that runs one of\n * {@link SESSION_EVENT_PRESENTED_APP_ACTIONS} (its arguments' top-level `id`,\n * see {@link presentedAppActionId}). Takes the `agent.toolCall.created`\n * payload (its `name` and `arguments`, an object or JSON text).\n */\nexport function isPresentedSessionToolCall(call: unknown): boolean {\n  if (!call || typeof call !== \"object\") return false;\n  const { name, arguments: args } = call as { name?: unknown; arguments?: unknown };\n  if (isPresentedSessionToolName(name)) return true;\n  const leaf = SESSION_EVENT_APP_ACTION_CALL_LEAF;\n  if (typeof name !== \"string\" || (name !== leaf && !name.endsWith(`__${leaf}`))) return false;\n  let parsed: unknown = args;\n  if (typeof args === \"string\") {\n    try {\n      parsed = JSON.parse(args);\n    } catch {\n      return false;\n    }\n  }\n  if (!parsed || typeof parsed !== \"object\" || Array.isArray(parsed)) return false;\n  return presentedAppActionId((parsed as { id?: unknown }).id) !== undefined;\n}\n"],"mappings":";AAUO,IAAM,mCAAmC;AAAA,EAC9C;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAUO,IAAM,uCAAuC;AAAA,EAClD;AAAA,EACA;AACF;AAMO,IAAM,2BAA2B;AAAA,EACtC,GAAG;AAAA,EACH,GAAG;AACL;AAWO,IAAM,4CAA4C;AAClD,IAAM,2CAA2C;AAQjD,IAAM,2CAA2C;AAAA,EACtD;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAOO,SAAS,4BAA4B,OAAyB;AACnE,SAAO,UAAU,gBAAgB,UAAU;AAC7C;AASO,IAAM,sCAAsC;AAAA,EACjD;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAGO,SAAS,2BAA2B,MAAwB;AACjE,MAAI,OAAO,SAAS,YAAY,KAAK,WAAW,EAAG,QAAO;AAC1D,SAAO,oCAAoC;AAAA,IACzC,CAAC,SAAS,SAAS,QAAQ,KAAK,SAAS,KAAK,IAAI,EAAE;AAAA,EACtD;AACF;AAGO,IAAM,qCAAqC;AAY3C,IAAM,sCAAsC;AAAA,EACjD,uBAAuB,EAAE,OAAO,6BAA6B,MAAM,UAAU;AAAA,EAC7E,4BAA4B;AAAA,IAC1B,OAAO;AAAA,IACP,MAAM;AAAA,EACR;AAAA,EACA,4BAA4B,EAAE,OAAO,2BAA2B,MAAM,SAAS;AAAA,EAC/E,iCAAiC;AAAA,IAC/B,OAAO;AAAA,IACP,MAAM;AAAA,EACR;AACF;AAUO,IAAM,oCACX;AAGK,IAAM,2CAA8D,OAAO;AAAA,EAChF;AACF,EAAE,QAAQ,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC;AAE1C,IAAM,+BAA0E,IAAI;AAAA,EAClF,OAAO,QAAQ,mCAAmC,EAAE,QAAQ,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM;AAAA,IAC/E,CAAC,IAAI,EAA0B;AAAA,IAC/B,CAAC,OAAO,EAA0B;AAAA,EACpC,CAAC;AACH;AAEA,SAAS,aAAa,OAAuB;AAC3C,MAAI,QAAQ;AACZ,MAAI,MAAM,MAAM;AAChB,SAAO,QAAQ,OAAO,kCAAkC,SAAS,MAAM,KAAK,CAAE,EAAG,UAAS;AAC1F,SAAO,MAAM,SAAS,kCAAkC,SAAS,MAAM,MAAM,CAAC,CAAE,EAAG,QAAO;AAC1F,SAAO,MAAM,MAAM,OAAO,GAAG;AAC/B;AAMO,SAAS,qBAAqB,IAA+C;AAClF,SAAO,OAAO,OAAO,WAAW,6BAA6B,IAAI,aAAa,EAAE,CAAC,IAAI;AACvF;AASO,SAAS,2BAA2B,MAAwB;AACjE,MAAI,CAAC,QAAQ,OAAO,SAAS,SAAU,QAAO;AAC9C,QAAM,EAAE,MAAM,WAAW,KAAK,IAAI;AAClC,MAAI,2BAA2B,IAAI,EAAG,QAAO;AAC7C,QAAM,OAAO;AACb,MAAI,OAAO,SAAS,YAAa,SAAS,QAAQ,CAAC,KAAK,SAAS,KAAK,IAAI,EAAE,EAAI,QAAO;AACvF,MAAI,SAAkB;AACtB,MAAI,OAAO,SAAS,UAAU;AAC5B,QAAI;AACF,eAAS,KAAK,MAAM,IAAI;AAAA,IAC1B,QAAQ;AACN,aAAO;AAAA,IACT;AAAA,EACF;AACA,MAAI,CAAC,UAAU,OAAO,WAAW,YAAY,MAAM,QAAQ,MAAM,EAAG,QAAO;AAC3E,SAAO,qBAAsB,OAA4B,EAAE,MAAM;AACnE;","names":[]}