@opengeni/contracts 0.39.0 → 0.44.1

package/dist/retained-output.d.ts

@@ -5,10 +5,25 @@ export declare const RETAINED_OUTPUT_MAX_PAGE_BYTES: number;
 export declare const RETAINED_OUTPUT_DEFAULT_PAGE_BYTES: number;
 /** Receipts are timeline references, never an extensible metadata bag. */
 export declare const RETAINED_OUTPUT_RECEIPT_MAX_BYTES: number;
+/** Screenshot bytes are accounted separately from the 10k-token text policy. */
+export declare const COMPUTER_SCREENSHOT_MAX_BYTES: number;
+export declare const COMPUTER_SCREENSHOT_MAX_DIMENSION = 16384;
+export declare const COMPUTER_SCREENSHOT_MAX_PIXELS = 67108864;
+/** Canonical ready-object retention window: 30 days from successful settlement. */
+export declare const COMPUTER_SCREENSHOT_RETENTION_MS: number;
+/** Hard workspace reservation across pending + ready screenshot artifacts. */
+export declare const COMPUTER_SCREENSHOT_WORKSPACE_QUOTA_BYTES: number;
+/** Generated images are permanent workspace files, never inline history blobs. */
+export declare const GENERATED_IMAGE_MAX_BYTES: number;
+/** Generated videos are permanent workspace files and are always streamed. */
+export declare const GENERATED_VIDEO_MAX_BYTES: number;
 export declare const RetainedOutputKind: z.ZodEnum<{
     assistant_completion: "assistant_completion";
+    computer_screenshot: "computer_screenshot";
     event_media: "event_media";
     file: "file";
+    generated_image: "generated_image";
+    generated_video: "generated_video";
     internal_update: "internal_update";
     tool_result: "tool_result";
 }>;
@@ -17,9 +32,12 @@ export declare const RetainedOutputUnavailableReason: z.ZodEnum<{
     deleted: "deleted";
     expired: "expired";
     failed: "failed";
+    invalid_content: "invalid_content";
     missing_storage: "missing_storage";
     not_retained: "not_retained";
+    oversized: "oversized";
     pending: "pending";
+    quota_exceeded: "quota_exceeded";
     storage_write_failed: "storage_write_failed";
     unsupported: "unsupported";
 }>;
@@ -29,8 +47,11 @@ export declare const RetainedArtifactReferenceSchema: z.ZodObject<{
     artifactId: z.ZodString;
     kind: z.ZodEnum<{
         assistant_completion: "assistant_completion";
+        computer_screenshot: "computer_screenshot";
         event_media: "event_media";
         file: "file";
+        generated_image: "generated_image";
+        generated_video: "generated_video";
         internal_update: "internal_update";
         tool_result: "tool_result";
     }>;
@@ -38,10 +59,17 @@ export declare const RetainedArtifactReferenceSchema: z.ZodObject<{
     originalBytes: z.ZodNumber;
     sha256: z.ZodString;
     retainedAt: z.ZodString;
-    retention: z.ZodObject<{
+    dimensions: z.ZodOptional<z.ZodObject<{
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+    }, z.core.$strict>>;
+    retention: z.ZodUnion<readonly [z.ZodObject<{
         policy: z.ZodLiteral<"workspace_file">;
         expiresAt: z.ZodNull;
-    }, z.core.$strict>;
+    }, z.core.$strict>, z.ZodObject<{
+        policy: z.ZodLiteral<"session_screenshot">;
+        expiresAt: z.ZodString;
+    }, z.core.$strict>]>;
     retrieval: z.ZodObject<{
         method: z.ZodLiteral<"GET">;
         path: z.ZodString;
@@ -62,9 +90,12 @@ export declare const RetainedOutputEvidenceSchema: z.ZodDiscriminatedUnion<[z.Zo
         deleted: "deleted";
         expired: "expired";
         failed: "failed";
+        invalid_content: "invalid_content";
         missing_storage: "missing_storage";
         not_retained: "not_retained";
+        oversized: "oversized";
         pending: "pending";
+        quota_exceeded: "quota_exceeded";
         storage_write_failed: "storage_write_failed";
         unsupported: "unsupported";
     }>;
@@ -73,8 +104,11 @@ export declare const RetainedOutputEvidenceSchema: z.ZodDiscriminatedUnion<[z.Zo
     artifactId: z.ZodString;
     kind: z.ZodEnum<{
         assistant_completion: "assistant_completion";
+        computer_screenshot: "computer_screenshot";
         event_media: "event_media";
         file: "file";
+        generated_image: "generated_image";
+        generated_video: "generated_video";
         internal_update: "internal_update";
         tool_result: "tool_result";
     }>;
@@ -82,10 +116,17 @@ export declare const RetainedOutputEvidenceSchema: z.ZodDiscriminatedUnion<[z.Zo
     originalBytes: z.ZodNumber;
     sha256: z.ZodString;
     retainedAt: z.ZodString;
-    retention: z.ZodObject<{
+    dimensions: z.ZodOptional<z.ZodObject<{
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+    }, z.core.$strict>>;
+    retention: z.ZodUnion<readonly [z.ZodObject<{
         policy: z.ZodLiteral<"workspace_file">;
         expiresAt: z.ZodNull;
-    }, z.core.$strict>;
+    }, z.core.$strict>, z.ZodObject<{
+        policy: z.ZodLiteral<"session_screenshot">;
+        expiresAt: z.ZodString;
+    }, z.core.$strict>]>;
     retrieval: z.ZodObject<{
         method: z.ZodLiteral<"GET">;
         path: z.ZodString;
@@ -104,9 +145,12 @@ export declare const RetainedArtifactUnavailableSchema: z.ZodObject<{
         deleted: "deleted";
         expired: "expired";
         failed: "failed";
+        invalid_content: "invalid_content";
         missing_storage: "missing_storage";
         not_retained: "not_retained";
+        oversized: "oversized";
         pending: "pending";
+        quota_exceeded: "quota_exceeded";
         storage_write_failed: "storage_write_failed";
         unsupported: "unsupported";
     }>;
@@ -118,8 +162,11 @@ export declare const RetainedArtifactMetadataSchema: z.ZodUnion<readonly [z.ZodO
     artifactId: z.ZodString;
     kind: z.ZodEnum<{
         assistant_completion: "assistant_completion";
+        computer_screenshot: "computer_screenshot";
         event_media: "event_media";
         file: "file";
+        generated_image: "generated_image";
+        generated_video: "generated_video";
         internal_update: "internal_update";
         tool_result: "tool_result";
     }>;
@@ -127,10 +174,17 @@ export declare const RetainedArtifactMetadataSchema: z.ZodUnion<readonly [z.ZodO
     originalBytes: z.ZodNumber;
     sha256: z.ZodString;
     retainedAt: z.ZodString;
-    retention: z.ZodObject<{
+    dimensions: z.ZodOptional<z.ZodObject<{
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+    }, z.core.$strict>>;
+    retention: z.ZodUnion<readonly [z.ZodObject<{
         policy: z.ZodLiteral<"workspace_file">;
         expiresAt: z.ZodNull;
-    }, z.core.$strict>;
+    }, z.core.$strict>, z.ZodObject<{
+        policy: z.ZodLiteral<"session_screenshot">;
+        expiresAt: z.ZodString;
+    }, z.core.$strict>]>;
     retrieval: z.ZodObject<{
         method: z.ZodLiteral<"GET">;
         path: z.ZodString;
@@ -144,9 +198,12 @@ export declare const RetainedArtifactMetadataSchema: z.ZodUnion<readonly [z.ZodO
         deleted: "deleted";
         expired: "expired";
         failed: "failed";
+        invalid_content: "invalid_content";
         missing_storage: "missing_storage";
         not_retained: "not_retained";
+        oversized: "oversized";
         pending: "pending";
+        quota_exceeded: "quota_exceeded";
         storage_write_failed: "storage_write_failed";
         unsupported: "unsupported";
     }>;
@@ -161,12 +218,32 @@ export type RetainedArtifactFileInput = {
     sha256: string | null;
     updatedAt: string;
 };
+export type RetainedScreenshotArtifactInput = RetainedArtifactFileInput & {
+    sessionId: string;
+    width: number;
+    height: number;
+    expiresAt: string;
+};
+export type RetainedGeneratedImageArtifactInput = RetainedArtifactFileInput & {
+    width: number;
+    height: number;
+};
+export type RetainedGeneratedVideoArtifactInput = RetainedArtifactFileInput & {
+    width: number;
+    height: number;
+};
 /**
  * Convert a ready, integrity-addressed workspace file into the only available
  * retained-output receipt shape. Invalid, pending, or checksum-less files fail
  * closed instead of implying that full evidence is retrievable.
  */
 export declare function retainedArtifactReferenceFromFile(file: RetainedArtifactFileInput, kind?: RetainedOutputKind): RetainedArtifactReference | null;
+/** Build the closed, session-scoped receipt for one ready screenshot file. */
+export declare function retainedScreenshotReferenceFromFile(file: RetainedScreenshotArtifactInput): RetainedArtifactReference | null;
+/** Build the permanent workspace receipt for one validated generated image. */
+export declare function retainedGeneratedImageReferenceFromFile(file: RetainedGeneratedImageArtifactInput): RetainedArtifactReference | null;
+/** Build the permanent workspace receipt for one validated generated video. */
+export declare function retainedGeneratedVideoReferenceFromFile(file: RetainedGeneratedVideoArtifactInput): RetainedArtifactReference | null;
 /** Parse and clone a trusted server receipt; invalid/untrusted data fails closed. */
 export declare function validateRetainedOutputEvidence(value: unknown): RetainedOutputEvidence | null;
 export declare function retainedOutputUnavailable(reason?: RetainedOutputUnavailableReason): RetainedOutputEvidence;

package/dist/sandbox-snapshots.d.ts

@@ -5,6 +5,14 @@ export type WorkspaceTreeFingerprint = {
     entryCount: number;
     fileCount: number;
     totalFileBytes: number;
+    /**
+     * Absent means the original deterministic GNU-tar projection used by remote
+     * sandboxes. Host-backed Local/Docker sessions use the Agents SDK's portable
+     * archive projection, which intentionally contains directories and regular
+     * files only. Keeping the discriminator in the descriptor makes restores
+     * stable when a Docker image changes and preserves old descriptor behavior.
+     */
+    projection?: "sdk_local_archive_v1";
 };
 export type TarWorkspaceArchiveDescriptor = {
     version: 1;
@@ -38,4 +46,5 @@ export declare const NATIVE_SNAPSHOT_PREFIXES: ReadonlyArray<{
 }>;
 export declare function parseWorkspaceArchiveDescriptor(value: unknown): WorkspaceArchiveDescriptor | null;
 export declare function decodeNativeSnapshotRef(bytes: Uint8Array): NativeSnapshotRef | null;
+export declare function encodeNativeSnapshotRef(ref: NativeSnapshotRef): Uint8Array;
 export declare function backendForNativeSnapshotProvider(provider: NativeSnapshotProvider): string;

package/dist/scoped-knowledge.d.ts

@@ -6,19 +6,20 @@ export declare const ScopedKnowledgeScopeKind: z.ZodEnum<{
     workspace: "workspace";
 }>;
 export type ScopedKnowledgeScopeKind = z.infer<typeof ScopedKnowledgeScopeKind>;
-export type ScopedKnowledgeScope = {
-    kind: "organization";
-    workspaceId: null;
-    subjectId: null;
-} | {
-    kind: "workspace";
-    workspaceId: string;
-    subjectId: null;
-} | {
-    kind: "personal";
-    workspaceId: string | null;
-    subjectId: string;
-};
+export declare const ScopedKnowledgeScope: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"organization">;
+    workspaceId: z.ZodNull;
+    subjectId: z.ZodNull;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"workspace">;
+    workspaceId: z.ZodString;
+    subjectId: z.ZodNull;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"personal">;
+    workspaceId: z.ZodNullable<z.ZodString>;
+    subjectId: z.ZodString;
+}, z.core.$strip>], "kind">;
+export type ScopedKnowledgeScope = z.infer<typeof ScopedKnowledgeScope>;
 export declare const ScopedKnowledgeActorKind: z.ZodEnum<{
     human: "human";
     service: "service";

package/dist/slack-bot-scopes.d.ts

@@ -11,6 +11,8 @@ export declare const OPENGENI_SLACK_REACTION_REQUIRED_SCOPE: "reactions:read";
  */
 export declare const OPENGENI_SLACK_BOT_REQUESTED_SCOPES: readonly ["app_mentions:read", "canvases:read", "channels:history", "channels:read", "chat:write", "commands", "files:read", "groups:history", "groups:read", "im:history", "im:read", "im:write", "mpim:history", "mpim:read", "users:read", "reactions:read"];
 export declare const OPENGENI_SLACK_BOT_EVENTS: readonly ["app_mention", "message.channels", "message.groups", "message.im", "message.mpim", "reaction_added"];
+/** Full user-token scope set for every tool currently exposed by Slack's hosted MCP server. */
+export declare const OPENGENI_SLACK_MCP_USER_SCOPES: readonly ["search:read.public", "search:read.private", "search:read.mpim", "search:read.im", "search:read.files", "files:read", "emoji:read", "search:read.users", "chat:write", "channels:history", "groups:history", "mpim:history", "im:history", "channels:write", "groups:write", "im:write", "mpim:write", "reactions:write", "canvases:read", "canvases:write", "users:read", "users:read.email", "channels:read", "groups:read", "mpim:read"];
 export declare const OPENGENI_MANAGED_PUBLIC_BASE_URL: "https://app.opengeni.ai";
 /** Canonical managed/self-hosted Slack app manifest. Slack accepts JSON manifests. */
 export declare function buildOpenGeniSlackBotManifest(publicBaseUrl: string): {
@@ -39,6 +41,7 @@ export declare function buildOpenGeniSlackBotManifest(publicBaseUrl: string): {
         readonly redirect_urls: readonly [`${string}/v1/integrations/oauth/callback`, `${string}/v1/integrations/slack/callback`];
         readonly scopes: {
             readonly bot: readonly ["app_mentions:read", "canvases:read", "channels:history", "channels:read", "chat:write", "commands", "files:read", "groups:history", "groups:read", "im:history", "im:read", "im:write", "mpim:history", "mpim:read", "users:read", "reactions:read"];
+            readonly user: readonly ["search:read.public", "search:read.private", "search:read.mpim", "search:read.im", "search:read.files", "files:read", "emoji:read", "search:read.users", "chat:write", "channels:history", "groups:history", "mpim:history", "im:history", "channels:write", "groups:write", "im:write", "mpim:write", "reactions:write", "canvases:read", "canvases:write", "users:read", "users:read.email", "channels:read", "groups:read", "mpim:read"];
         };
     };
     readonly settings: {
@@ -50,6 +53,7 @@ export declare function buildOpenGeniSlackBotManifest(publicBaseUrl: string): {
             readonly is_enabled: true;
             readonly request_url: `${string}/v1/integrations/slack/interactions`;
         };
+        readonly is_mcp_enabled: true;
         readonly org_deploy_enabled: false;
         readonly socket_mode_enabled: false;
         readonly token_rotation_enabled: false;

package/dist/slack-bot-scopes.js

@@ -5,12 +5,13 @@ import {
   OPENGENI_SLACK_BOT_REQUESTED_SCOPES,
   OPENGENI_SLACK_BOT_REQUIRED_SCOPES,
   OPENGENI_SLACK_BOT_SAFE_OPTIONAL_SCOPES,
+  OPENGENI_SLACK_MCP_USER_SCOPES,
   OPENGENI_SLACK_REACTION_REQUIRED_SCOPE,
   areOpenGeniSlackBotScopesAccepted,
   buildOpenGeniSlackBotManifest,
   evaluateOpenGeniSlackBotScopes,
   hasOpenGeniSlackReactionScope
-} from "./chunk-7JZMI22I.js";
+} from "./chunk-5UDNP7AO.js";
 export {
   OPENGENI_MANAGED_PUBLIC_BASE_URL,
   OPENGENI_SLACK_BOT_EVENTS,
@@ -18,6 +19,7 @@ export {
   OPENGENI_SLACK_BOT_REQUESTED_SCOPES,
   OPENGENI_SLACK_BOT_REQUIRED_SCOPES,
   OPENGENI_SLACK_BOT_SAFE_OPTIONAL_SCOPES,
+  OPENGENI_SLACK_MCP_USER_SCOPES,
   OPENGENI_SLACK_REACTION_REQUIRED_SCOPE,
   areOpenGeniSlackBotScopesAccepted,
   buildOpenGeniSlackBotManifest,

package/dist/spreadsheet-artifact-commands.d.ts

@@ -0,0 +1,101 @@
+/**
+ * Canonical, identity-free spreadsheet mutation commands nested inside
+ * `OGATX001`. Artifact, actor, transaction, delivery, and causal identity must
+ * never be added here: the outer authored-intent envelope is their sole wire
+ * authority.
+ */
+export declare const SPREADSHEET_ARTIFACT_COMMAND_VERSION: 1;
+export declare const SPREADSHEET_ARTIFACT_COMMAND_MAX_BYTES: number;
+export declare const SPREADSHEET_ARTIFACT_COMMAND_MAX_COMMANDS = 4096;
+export declare const SPREADSHEET_ARTIFACT_COMMAND_MAX_CELLS = 1000000;
+export declare const SPREADSHEET_ARTIFACT_COMMAND_MAX_STRING_BYTES: number;
+export declare const SPREADSHEET_ARTIFACT_SHEET_NAME_MAX_UTF16_UNITS = 31;
+declare const stableIdBrand: unique symbol;
+/** Fixed-width lowercase hexadecimal 128-bit id. Runtime helpers enforce use. */
+export type EditableArtifactStableId = string & {
+    readonly [stableIdBrand]: "EditableArtifactStableId";
+};
+/**
+ * A concrete sheet generation. The object id follows the offline allocator
+ * invariant (both 64-bit halves nonzero); a derived operation id reserves only
+ * the all-zero 128-bit value.
+ */
+export type SpreadsheetSheetGeneration = Readonly<{
+    kind: "generation";
+    sheetId: EditableArtifactStableId;
+    creationOperationId: EditableArtifactStableId;
+}>;
+/**
+ * Reference to a sheet created by an earlier command in this same batch.
+ * This avoids recursively embedding the creation operation id, which is
+ * derived from the hash of the complete outer intent.
+ */
+export type SpreadsheetPriorCreatePrecondition = Readonly<{
+    kind: "created-in-batch";
+    sheetId: EditableArtifactStableId;
+    createCommandIndex: number;
+}>;
+export type SpreadsheetSheetPrecondition = SpreadsheetSheetGeneration | SpreadsheetPriorCreatePrecondition;
+export type SpreadsheetCellPoint = Readonly<{
+    row: number;
+    column: number;
+}>;
+export type SpreadsheetCellRange = Readonly<{
+    start: SpreadsheetCellPoint;
+    end: SpreadsheetCellPoint;
+}>;
+export type SpreadsheetFormulaError = Readonly<{
+    error: string;
+}>;
+export type SpreadsheetDateValue = Readonly<{
+    date: string;
+}>;
+export type SpreadsheetCellScalar = null | boolean | number | string | SpreadsheetDateValue | SpreadsheetFormulaError;
+export type SpreadsheetFormulaCell = Readonly<{
+    formula: string;
+    cached: SpreadsheetCellScalar;
+}>;
+export type SpreadsheetCellInput = SpreadsheetCellScalar | SpreadsheetFormulaCell;
+export type SpreadsheetCreateSheetCommand = Readonly<{
+    kind: "sheet.create";
+    sheetId: EditableArtifactStableId;
+    name: string;
+    after: SpreadsheetSheetPrecondition | null;
+}>;
+export type SpreadsheetRenameSheetCommand = Readonly<{
+    kind: "sheet.rename";
+    sheet: SpreadsheetSheetPrecondition;
+    name: string;
+}>;
+export type SpreadsheetDeleteSheetCommand = Readonly<{
+    kind: "sheet.delete";
+    sheet: SpreadsheetSheetPrecondition;
+}>;
+/** Row-major rectangular write; `cells.length === rows * columns`. */
+export type SpreadsheetSetCellsCommand = Readonly<{
+    kind: "cells.set";
+    sheet: SpreadsheetSheetPrecondition;
+    anchor: SpreadsheetCellPoint;
+    rows: number;
+    columns: number;
+    cells: readonly SpreadsheetCellInput[];
+}>;
+export type SpreadsheetClearRangeCommand = Readonly<{
+    kind: "range.clear";
+    sheet: SpreadsheetSheetPrecondition;
+    range: SpreadsheetCellRange;
+}>;
+export type SpreadsheetArtifactCommand = SpreadsheetCreateSheetCommand | SpreadsheetRenameSheetCommand | SpreadsheetDeleteSheetCommand | SpreadsheetSetCellsCommand | SpreadsheetClearRangeCommand;
+export type SpreadsheetArtifactCommandBatch = Readonly<{
+    version: typeof SPREADSHEET_ARTIFACT_COMMAND_VERSION;
+    commands: readonly SpreadsheetArtifactCommand[];
+}>;
+/** Validates a generic nonzero 128-bit id and returns its nominal type. */
+export declare function editableArtifactStableId(value: string): EditableArtifactStableId;
+/** Validates a sheet object id with nonzero allocator namespace and counter. */
+export declare function spreadsheetSheetId(value: string): EditableArtifactStableId;
+export declare function encodeSpreadsheetArtifactCommandBatch(input: SpreadsheetArtifactCommandBatch): Uint8Array;
+export declare function decodeSpreadsheetArtifactCommandBatch(bytes: Uint8Array): SpreadsheetArtifactCommandBatch;
+/** Decodes, re-encodes, and proves byte-for-byte canonicality. */
+export declare function assertCanonicalSpreadsheetArtifactCommandBytes(bytes: Uint8Array): Uint8Array;
+export {};

package/dist/spreadsheet-artifact-commands.js

@@ -0,0 +1,27 @@
+import {
+  SPREADSHEET_ARTIFACT_COMMAND_MAX_BYTES,
+  SPREADSHEET_ARTIFACT_COMMAND_MAX_CELLS,
+  SPREADSHEET_ARTIFACT_COMMAND_MAX_COMMANDS,
+  SPREADSHEET_ARTIFACT_COMMAND_MAX_STRING_BYTES,
+  SPREADSHEET_ARTIFACT_COMMAND_VERSION,
+  SPREADSHEET_ARTIFACT_SHEET_NAME_MAX_UTF16_UNITS,
+  assertCanonicalSpreadsheetArtifactCommandBytes,
+  decodeSpreadsheetArtifactCommandBatch,
+  editableArtifactStableId,
+  encodeSpreadsheetArtifactCommandBatch,
+  spreadsheetSheetId
+} from "./chunk-LSB7GRLG.js";
+export {
+  SPREADSHEET_ARTIFACT_COMMAND_MAX_BYTES,
+  SPREADSHEET_ARTIFACT_COMMAND_MAX_CELLS,
+  SPREADSHEET_ARTIFACT_COMMAND_MAX_COMMANDS,
+  SPREADSHEET_ARTIFACT_COMMAND_MAX_STRING_BYTES,
+  SPREADSHEET_ARTIFACT_COMMAND_VERSION,
+  SPREADSHEET_ARTIFACT_SHEET_NAME_MAX_UTF16_UNITS,
+  assertCanonicalSpreadsheetArtifactCommandBytes,
+  decodeSpreadsheetArtifactCommandBatch,
+  editableArtifactStableId,
+  encodeSpreadsheetArtifactCommandBatch,
+  spreadsheetSheetId
+};
+//# sourceMappingURL=spreadsheet-artifact-commands.js.map

package/dist/spreadsheet-artifact-commands.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/spreadsheet-artifact-date.d.ts

@@ -0,0 +1,4 @@
+/** Parses only the exact string form emitted by `Date.prototype.toISOString`. */
+export declare function canonicalSpreadsheetDateMilliseconds(value: unknown): number;
+/** Converts a signed wire integer to a canonical ISO instant without lossy coercion. */
+export declare function canonicalSpreadsheetDateFromMilliseconds(milliseconds: bigint): string;

package/dist/spreadsheet-artifact-query.d.ts

@@ -0,0 +1,120 @@
+import { type EditableArtifactStableId } from "./spreadsheet-artifact-commands.js";
+/** Canonical private kernel query/projection ABI shared by browser and native bindings. */
+export declare const SPREADSHEET_ARTIFACT_QUERY_VERSION: 1;
+export declare const SPREADSHEET_ARTIFACT_QUERY_MAX_BYTES = 68;
+export declare const SPREADSHEET_ARTIFACT_PROJECTION_MAX_BYTES: number;
+export declare const SPREADSHEET_ARTIFACT_VIEWPORT_MAX_AREA = 1048576;
+export declare const SPREADSHEET_ARTIFACT_VIEWPORT_MAX_CELLS = 262144;
+export declare const SPREADSHEET_ARTIFACT_METADATA_MAX_SHEETS = 10000;
+export declare const SPREADSHEET_ARTIFACT_PROJECTION_MAX_STRING_BYTES: number;
+export declare const SPREADSHEET_ARTIFACT_VIEWPORT_MIN_RESPONSE_BYTES = 92;
+export declare const SPREADSHEET_ARTIFACT_METADATA_MIN_RESPONSE_BYTES = 48;
+export type SpreadsheetArtifactViewportQuery = Readonly<{
+    sheetId: EditableArtifactStableId;
+    startRow: number;
+    startColumn: number;
+    rowCount: number;
+    columnCount: number;
+    maxCells: number;
+    /** Entire OGAKV001 envelope, not merely its payload. */
+    maxBytes: number;
+}>;
+export type SpreadsheetArtifactMetadataQuery = Readonly<{
+    maxSheets: number;
+    /** Entire OGAKV001 envelope, not merely its payload. */
+    maxBytes: number;
+}>;
+export type SpreadsheetArtifactKernelQuery = Readonly<{
+    kind: "viewport";
+    query: SpreadsheetArtifactViewportQuery;
+}> | Readonly<{
+    kind: "workbook-metadata";
+    query: SpreadsheetArtifactMetadataQuery;
+}>;
+export type SpreadsheetArtifactFormulaError = "null" | "divide_by_zero" | "value" | "reference" | "name" | "number" | "not_available" | "spill" | "calculation" | Readonly<{
+    custom: string;
+}>;
+export type SpreadsheetArtifactProjectedCellValue = Readonly<{
+    kind: "empty";
+}> | Readonly<{
+    kind: "boolean";
+    value: boolean;
+}> | Readonly<{
+    kind: "number";
+    value: number;
+}> | Readonly<{
+    kind: "date";
+    value: string;
+}> | Readonly<{
+    kind: "text";
+    value: string;
+}> | Readonly<{
+    kind: "error";
+    value: SpreadsheetArtifactFormulaError;
+}>;
+export type SpreadsheetArtifactProjectedCell = Readonly<{
+    /** Absolute zero-based row, reconstructed from the relative wire coordinate. */
+    row: number;
+    /** Absolute zero-based column, reconstructed from the relative wire coordinate. */
+    column: number;
+    formula: string | null;
+    value: SpreadsheetArtifactProjectedCellValue;
+}>;
+/** Complete and non-truncated. A limit breach is an error, never a partial response. */
+export type SpreadsheetArtifactViewportProjection = Readonly<{
+    revision: bigint;
+    sheetId: EditableArtifactStableId;
+    generationId: EditableArtifactStableId | null;
+    startRow: number;
+    startColumn: number;
+    rowCount: number;
+    columnCount: number;
+    cells: readonly SpreadsheetArtifactProjectedCell[];
+}>;
+export type SpreadsheetArtifactUsedBounds = Readonly<{
+    startRow: number;
+    startColumn: number;
+    endRow: number;
+    endColumn: number;
+}>;
+export type SpreadsheetArtifactSheetMetadata = Readonly<{
+    sheetId: EditableArtifactStableId;
+    generationId: EditableArtifactStableId | null;
+    name: string;
+    usedBounds: SpreadsheetArtifactUsedBounds | null;
+}>;
+/**
+ * Version 1 deliberately models no row/column dimensions, hidden state, or
+ * merges. It also carries no style projection. These are false capability
+ * facts, not omitted authoritative data.
+ */
+export type SpreadsheetArtifactModeledFeatures = Readonly<{
+    dimensions: false;
+    hidden: false;
+    merges: false;
+}>;
+/** Complete ordered workbook catalog; never a truncated prefix. */
+export type SpreadsheetArtifactMetadataProjection = Readonly<{
+    revision: bigint;
+    modeledFeatures: SpreadsheetArtifactModeledFeatures;
+    sheets: readonly SpreadsheetArtifactSheetMetadata[];
+}>;
+export type SpreadsheetArtifactKernelProjection = Readonly<{
+    kind: "viewport";
+    projection: SpreadsheetArtifactViewportProjection;
+}> | Readonly<{
+    kind: "workbook-metadata";
+    projection: SpreadsheetArtifactMetadataProjection;
+}>;
+export declare function encodeSpreadsheetViewportKernelQuery(input: SpreadsheetArtifactViewportQuery): Uint8Array;
+export declare function encodeSpreadsheetMetadataKernelQuery(input: SpreadsheetArtifactMetadataQuery): Uint8Array;
+export declare function encodeSpreadsheetArtifactKernelQuery(input: SpreadsheetArtifactKernelQuery): Uint8Array;
+export declare function decodeSpreadsheetArtifactKernelQuery(bytes: Uint8Array): SpreadsheetArtifactKernelQuery;
+export declare function assertCanonicalSpreadsheetArtifactKernelQueryBytes(bytes: Uint8Array): Uint8Array;
+export declare function encodeSpreadsheetViewportKernelProjection(input: SpreadsheetArtifactViewportProjection, maximumBytes?: number): Uint8Array;
+export declare function encodeSpreadsheetMetadataKernelProjection(input: SpreadsheetArtifactMetadataProjection, maximumBytes?: number): Uint8Array;
+export declare function encodeSpreadsheetArtifactKernelProjection(input: SpreadsheetArtifactKernelProjection, maximumBytes?: number): Uint8Array;
+export declare function decodeSpreadsheetArtifactKernelProjection(bytes: Uint8Array): SpreadsheetArtifactKernelProjection;
+export declare function decodeSpreadsheetViewportKernelProjection(bytes: Uint8Array, expected?: SpreadsheetArtifactViewportQuery): SpreadsheetArtifactViewportProjection;
+export declare function decodeSpreadsheetMetadataKernelProjection(bytes: Uint8Array, expected?: SpreadsheetArtifactMetadataQuery): SpreadsheetArtifactMetadataProjection;
+export declare function assertCanonicalSpreadsheetArtifactKernelProjectionBytes(bytes: Uint8Array): Uint8Array;

package/dist/spreadsheet-artifact-query.js

@@ -0,0 +1,48 @@
+import {
+  SPREADSHEET_ARTIFACT_METADATA_MAX_SHEETS,
+  SPREADSHEET_ARTIFACT_METADATA_MIN_RESPONSE_BYTES,
+  SPREADSHEET_ARTIFACT_PROJECTION_MAX_BYTES,
+  SPREADSHEET_ARTIFACT_PROJECTION_MAX_STRING_BYTES,
+  SPREADSHEET_ARTIFACT_QUERY_MAX_BYTES,
+  SPREADSHEET_ARTIFACT_QUERY_VERSION,
+  SPREADSHEET_ARTIFACT_VIEWPORT_MAX_AREA,
+  SPREADSHEET_ARTIFACT_VIEWPORT_MAX_CELLS,
+  SPREADSHEET_ARTIFACT_VIEWPORT_MIN_RESPONSE_BYTES,
+  assertCanonicalSpreadsheetArtifactKernelProjectionBytes,
+  assertCanonicalSpreadsheetArtifactKernelQueryBytes,
+  decodeSpreadsheetArtifactKernelProjection,
+  decodeSpreadsheetArtifactKernelQuery,
+  decodeSpreadsheetMetadataKernelProjection,
+  decodeSpreadsheetViewportKernelProjection,
+  encodeSpreadsheetArtifactKernelProjection,
+  encodeSpreadsheetArtifactKernelQuery,
+  encodeSpreadsheetMetadataKernelProjection,
+  encodeSpreadsheetMetadataKernelQuery,
+  encodeSpreadsheetViewportKernelProjection,
+  encodeSpreadsheetViewportKernelQuery
+} from "./chunk-CADSX6UN.js";
+import "./chunk-LSB7GRLG.js";
+export {
+  SPREADSHEET_ARTIFACT_METADATA_MAX_SHEETS,
+  SPREADSHEET_ARTIFACT_METADATA_MIN_RESPONSE_BYTES,
+  SPREADSHEET_ARTIFACT_PROJECTION_MAX_BYTES,
+  SPREADSHEET_ARTIFACT_PROJECTION_MAX_STRING_BYTES,
+  SPREADSHEET_ARTIFACT_QUERY_MAX_BYTES,
+  SPREADSHEET_ARTIFACT_QUERY_VERSION,
+  SPREADSHEET_ARTIFACT_VIEWPORT_MAX_AREA,
+  SPREADSHEET_ARTIFACT_VIEWPORT_MAX_CELLS,
+  SPREADSHEET_ARTIFACT_VIEWPORT_MIN_RESPONSE_BYTES,
+  assertCanonicalSpreadsheetArtifactKernelProjectionBytes,
+  assertCanonicalSpreadsheetArtifactKernelQueryBytes,
+  decodeSpreadsheetArtifactKernelProjection,
+  decodeSpreadsheetArtifactKernelQuery,
+  decodeSpreadsheetMetadataKernelProjection,
+  decodeSpreadsheetViewportKernelProjection,
+  encodeSpreadsheetArtifactKernelProjection,
+  encodeSpreadsheetArtifactKernelQuery,
+  encodeSpreadsheetMetadataKernelProjection,
+  encodeSpreadsheetMetadataKernelQuery,
+  encodeSpreadsheetViewportKernelProjection,
+  encodeSpreadsheetViewportKernelQuery
+};
+//# sourceMappingURL=spreadsheet-artifact-query.js.map

package/dist/spreadsheet-artifact-query.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}