@opengeni/contracts 0.50.0 → 1.0.1

package/dist/google-drive.d.ts

@@ -8,15 +8,19 @@ export declare const GOOGLE_DRIVE_READONLY_SCOPE: "https://www.googleapis.com/au
 export declare const GOOGLE_DRIVE_CREDENTIAL_ROLE: "google_drive_metadata";
 export declare const GOOGLE_DRIVE_CREDENTIAL_LABEL: "Google Drive read-only source sync";
 export declare const GOOGLE_DRIVE_LEGACY_CREDENTIAL_LABEL: "Google Drive metadata browser";
+export declare const GOOGLE_DRIVE_PUBLICATION_SERVER_ID: "google-drive-publishing";
+export declare const GOOGLE_DRIVE_PUBLICATION_TOOL_NAME: "google_drive_publish_file";
+export declare const GOOGLE_DRIVE_PUBLICATION_CREATE_ACTION: "create";
 export declare const GoogleDriveOAuthCapability: z.ZodEnum<{
     picker_file_read: "picker_file_read";
+    publish_file: "publish_file";
     recursive_source_sync: "recursive_source_sync";
     source_content_read: "source_content_read";
     source_metadata_discovery: "source_metadata_discovery";
 }>;
 export type GoogleDriveOAuthCapability = z.infer<typeof GoogleDriveOAuthCapability>;
 export type GoogleDriveOAuthScopeDecision = {
-    accessMode: "metadata_readonly" | "readonly" | null;
+    accessMode: "file_only" | "metadata_readonly" | "readonly" | null;
     capabilities: GoogleDriveOAuthCapability[];
 };
 /**
@@ -122,6 +126,17 @@ export declare const GoogleDriveSelectedSource: z.ZodObject<{
     selectedAt: z.ZodString;
 }, z.core.$strip>;
 export type GoogleDriveSelectedSource = z.infer<typeof GoogleDriveSelectedSource>;
+export declare const GoogleDriveOutputDestination: z.ZodObject<{
+    folderId: z.ZodString;
+    folderName: z.ZodString;
+    driveId: z.ZodNullable<z.ZodString>;
+    location: z.ZodEnum<{
+        my_drive: "my_drive";
+        shared_drive: "shared_drive";
+    }>;
+    selectedAt: z.ZodString;
+}, z.core.$strict>;
+export type GoogleDriveOutputDestination = z.infer<typeof GoogleDriveOutputDestination>;
 export declare const GoogleDriveConnectionMetadata: z.ZodObject<{
     credentialRole: z.ZodLiteral<"google_drive_metadata">;
     credentialLabel: z.ZodUnion<readonly [z.ZodLiteral<"Google Drive read-only source sync">, z.ZodLiteral<"Google Drive metadata browser">]>;
@@ -130,6 +145,7 @@ export declare const GoogleDriveConnectionMetadata: z.ZodObject<{
     googleDisplayName: z.ZodNullable<z.ZodString>;
     verifiedAt: z.ZodString;
     accessMode: z.ZodEnum<{
+        file_only: "file_only";
         metadata_readonly: "metadata_readonly";
         readonly: "readonly";
     }>;
@@ -162,6 +178,16 @@ export declare const GoogleDriveConnectionMetadata: z.ZodObject<{
         recoverable: z.ZodLiteral<true>;
         observedAt: z.ZodString;
     }, z.core.$strip>], "state">>;
+    outputDestination: z.ZodOptional<z.ZodObject<{
+        folderId: z.ZodString;
+        folderName: z.ZodString;
+        driveId: z.ZodNullable<z.ZodString>;
+        location: z.ZodEnum<{
+            my_drive: "my_drive";
+            shared_drive: "shared_drive";
+        }>;
+        selectedAt: z.ZodString;
+    }, z.core.$strict>>;
     documentDestination: z.ZodOptional<z.ZodObject<{
         authorityKind: z.ZodEnum<{
             organization: "organization";
@@ -247,6 +273,10 @@ export declare const GoogleDriveConnectionMetadata: z.ZodObject<{
 export type GoogleDriveConnectionMetadata = z.infer<typeof GoogleDriveConnectionMetadata>;
 export declare const GoogleDriveOAuthStartRequest: z.ZodObject<{
     connectionId: z.ZodOptional<z.ZodString>;
+    capability: z.ZodDefault<z.ZodEnum<{
+        publish: "publish";
+        source_read: "source_read";
+    }>>;
 }, z.core.$strip>;
 export type GoogleDriveOAuthStartRequest = z.infer<typeof GoogleDriveOAuthStartRequest>;
 export declare const GoogleDriveOAuthStartResponse: z.ZodObject<{
@@ -267,6 +297,63 @@ export declare const GoogleDriveDisconnectRequest: z.ZodObject<{
     idempotencyKey: z.ZodString;
 }, z.core.$strip>;
 export type GoogleDriveDisconnectRequest = z.infer<typeof GoogleDriveDisconnectRequest>;
+export declare const GoogleDrivePublicationExportFile: z.ZodObject<{
+    fileId: z.ZodString;
+    filename: z.ZodString;
+    contentType: z.ZodString;
+    sizeBytes: z.ZodNumber;
+    sha256: z.ZodString;
+    artifactId: z.ZodString;
+    versionId: z.ZodString;
+    materializationJobId: z.ZodString;
+    sourceHeadSequence: z.ZodNumber;
+    sourceStateHash: z.ZodString;
+}, z.core.$strict>;
+export type GoogleDrivePublicationExportFile = z.infer<typeof GoogleDrivePublicationExportFile>;
+export declare const GoogleDrivePublicationToolInput: z.ZodObject<{
+    title: z.ZodString;
+    modality: z.ZodEnum<{
+        document: "document";
+        presentation: "presentation";
+        spreadsheet: "spreadsheet";
+    }>;
+    file: z.ZodObject<{
+        fileId: z.ZodString;
+        filename: z.ZodString;
+        contentType: z.ZodString;
+        sizeBytes: z.ZodNumber;
+        sha256: z.ZodString;
+        artifactId: z.ZodString;
+        versionId: z.ZodString;
+        materializationJobId: z.ZodString;
+        sourceHeadSequence: z.ZodNumber;
+        sourceStateHash: z.ZodString;
+    }, z.core.$strict>;
+    idempotencyKey: z.ZodString;
+}, z.core.$strict>;
+export type GoogleDrivePublicationToolInput = z.infer<typeof GoogleDrivePublicationToolInput>;
+export declare const GoogleDrivePublicationReceipt: z.ZodObject<{
+    connectionId: z.ZodString;
+    providerFileId: z.ZodString;
+    webViewLink: z.ZodString;
+    mimeType: z.ZodEnum<{
+        "application/vnd.google-apps.document": "application/vnd.google-apps.document";
+        "application/vnd.google-apps.presentation": "application/vnd.google-apps.presentation";
+        "application/vnd.google-apps.spreadsheet": "application/vnd.google-apps.spreadsheet";
+    }>;
+    destination: z.ZodObject<{
+        folderId: z.ZodString;
+        folderName: z.ZodString;
+        driveId: z.ZodNullable<z.ZodString>;
+        location: z.ZodEnum<{
+            my_drive: "my_drive";
+            shared_drive: "shared_drive";
+        }>;
+        selectedAt: z.ZodString;
+    }, z.core.$strict>;
+    replayed: z.ZodBoolean;
+}, z.core.$strict>;
+export type GoogleDrivePublicationReceipt = z.infer<typeof GoogleDrivePublicationReceipt>;
 export declare const GoogleDriveBrowseItem: z.ZodObject<{
     id: z.ZodString;
     name: z.ZodString;

package/dist/google-drive.js

@@ -1,6 +1,6 @@
 import {
   ConnectionMetadata
-} from "./chunk-Q6A7XT2N.js";
+} from "./chunk-NX5JNF4L.js";
 import {
   ConnectorDocumentDestination,
   ConnectorDocumentDestinationSelection
@@ -31,8 +31,12 @@ var GOOGLE_DRIVE_READONLY_SCOPE = "https://www.googleapis.com/auth/drive.readonl
 var GOOGLE_DRIVE_CREDENTIAL_ROLE = "google_drive_metadata";
 var GOOGLE_DRIVE_CREDENTIAL_LABEL = "Google Drive read-only source sync";
 var GOOGLE_DRIVE_LEGACY_CREDENTIAL_LABEL = "Google Drive metadata browser";
+var GOOGLE_DRIVE_PUBLICATION_SERVER_ID = "google-drive-publishing";
+var GOOGLE_DRIVE_PUBLICATION_TOOL_NAME = "google_drive_publish_file";
+var GOOGLE_DRIVE_PUBLICATION_CREATE_ACTION = "create";
 var GoogleDriveOAuthCapability = z.enum([
   "picker_file_read",
+  "publish_file",
   "source_metadata_discovery",
   "source_content_read",
   "recursive_source_sync"
@@ -41,16 +45,18 @@ function googleDriveOAuthScopeDecision(grantedScopes) {
   const granted = new Set(grantedScopes);
   const hasFullDrive = granted.has(GOOGLE_DRIVE_FULL_SCOPE);
   const hasSourceContentRead = hasFullDrive || granted.has(GOOGLE_DRIVE_READONLY_SCOPE);
+  const hasFileWrite = hasFullDrive || granted.has(GOOGLE_DRIVE_FILE_SCOPE);
   const hasSourceMetadataDiscovery = hasSourceContentRead || granted.has(GOOGLE_DRIVE_METADATA_READONLY_SCOPE);
-  const hasPickerFileRead = hasSourceContentRead || granted.has(GOOGLE_DRIVE_FILE_SCOPE);
+  const hasPickerFileRead = hasSourceContentRead || hasFileWrite;
   const capabilities = [];
   if (hasPickerFileRead) capabilities.push("picker_file_read");
+  if (hasFileWrite) capabilities.push("publish_file");
   if (hasSourceMetadataDiscovery) capabilities.push("source_metadata_discovery");
   if (hasSourceContentRead) {
     capabilities.push("source_content_read", "recursive_source_sync");
   }
   return {
-    accessMode: hasSourceContentRead ? "readonly" : hasSourceMetadataDiscovery ? "metadata_readonly" : null,
+    accessMode: hasSourceContentRead ? "readonly" : hasSourceMetadataDiscovery ? "metadata_readonly" : hasFileWrite ? "file_only" : null,
     capabilities
   };
 }
@@ -121,6 +127,21 @@ var GoogleDriveSelectedSource = z.object({
   readPolicy: GoogleDriveReadPolicy.default("allow"),
   selectedAt: z.string().datetime({ offset: true })
 });
+var GoogleDriveOutputDestination = z.object({
+  folderId: z.string().min(1).max(256),
+  folderName: z.string().min(1).max(1024),
+  driveId: z.string().min(1).max(256).nullable(),
+  location: z.enum(["my_drive", "shared_drive"]),
+  selectedAt: z.string().datetime({ offset: true })
+}).strict().superRefine((value, context) => {
+  if (value.location === "my_drive" !== (value.driveId === null)) {
+    context.addIssue({
+      code: "custom",
+      path: ["driveId"],
+      message: "Google Drive destination location does not match its drive identity"
+    });
+  }
+});
 var GoogleDriveConnectionMetadata = z.object({
   credentialRole: z.literal(GOOGLE_DRIVE_CREDENTIAL_ROLE),
   credentialLabel: z.union([
@@ -131,15 +152,17 @@ var GoogleDriveConnectionMetadata = z.object({
   googleEmail: z.string().email().max(320),
   googleDisplayName: z.string().min(1).max(512).nullable(),
   verifiedAt: z.string().datetime({ offset: true }),
-  accessMode: z.enum(["metadata_readonly", "readonly"]),
+  accessMode: z.enum(["file_only", "metadata_readonly", "readonly"]),
   lifecycle: GoogleDriveConnectionLifecycle.optional(),
+  outputDestination: GoogleDriveOutputDestination.optional(),
   documentDestination: ConnectorDocumentDestination.optional(),
   selectedSources: z.array(GoogleDriveSelectedSource).max(100).optional(),
   /** @deprecated Read `selectedSources`; retained while existing connections migrate. */
   selectedSource: GoogleDriveSelectedSource.nullable().optional()
 }).passthrough();
 var GoogleDriveOAuthStartRequest = z.object({
-  connectionId: z.string().uuid().optional()
+  connectionId: z.string().uuid().optional(),
+  capability: z.enum(["source_read", "publish"]).default("source_read")
 });
 var GoogleDriveOAuthStartResponse = z.object({
   authorizationUrl: z.string().url(),
@@ -153,6 +176,36 @@ var GoogleDriveDisconnectRequest = z.object({
   expectedVersion: z.number().int().positive(),
   idempotencyKey: z.string().trim().min(1).max(200)
 });
+var GoogleDrivePublicationExportFile = z.object({
+  fileId: z.string().uuid(),
+  filename: z.string().trim().min(1).max(512),
+  contentType: z.string().trim().min(1).max(256),
+  sizeBytes: z.number().int().positive(),
+  sha256: z.string().regex(/^[0-9a-f]{64}$/u),
+  artifactId: z.string().regex(/^[0-9a-f]{32}$/u),
+  versionId: z.string().regex(/^[0-9a-f]{32}$/u),
+  materializationJobId: z.string().regex(/^[0-9a-f]{32}$/u),
+  sourceHeadSequence: z.number().int().nonnegative(),
+  sourceStateHash: z.string().regex(/^sha256:[0-9a-f]{64}$/u)
+}).strict();
+var GoogleDrivePublicationToolInput = z.object({
+  title: z.string().trim().min(1).max(512),
+  modality: z.enum(["document", "spreadsheet", "presentation"]),
+  file: GoogleDrivePublicationExportFile,
+  idempotencyKey: z.string().trim().min(1).max(200)
+}).strict();
+var GoogleDrivePublicationReceipt = z.object({
+  connectionId: z.string().uuid(),
+  providerFileId: z.string().min(1).max(256),
+  webViewLink: z.string().url(),
+  mimeType: z.enum([
+    "application/vnd.google-apps.document",
+    "application/vnd.google-apps.spreadsheet",
+    "application/vnd.google-apps.presentation"
+  ]),
+  destination: GoogleDriveOutputDestination,
+  replayed: z.boolean()
+}).strict();
 var GoogleDriveBrowseItem = z.object({
   id: z.string().min(1).max(256),
   name: z.string().min(1).max(1024),
@@ -231,6 +284,9 @@ export {
   GOOGLE_DRIVE_LEGACY_CREDENTIAL_LABEL,
   GOOGLE_DRIVE_METADATA_READONLY_SCOPE,
   GOOGLE_DRIVE_PROVIDER_DOMAIN,
+  GOOGLE_DRIVE_PUBLICATION_CREATE_ACTION,
+  GOOGLE_DRIVE_PUBLICATION_SERVER_ID,
+  GOOGLE_DRIVE_PUBLICATION_TOOL_NAME,
   GOOGLE_DRIVE_READONLY_SCOPE,
   GoogleDriveBrowseItem,
   GoogleDriveBrowseResponse,
@@ -245,6 +301,10 @@ export {
   GoogleDriveOAuthCapability,
   GoogleDriveOAuthStartRequest,
   GoogleDriveOAuthStartResponse,
+  GoogleDriveOutputDestination,
+  GoogleDrivePublicationExportFile,
+  GoogleDrivePublicationReceipt,
+  GoogleDrivePublicationToolInput,
   GoogleDriveReadPolicy,
   GoogleDriveSelectedSource,
   GoogleDriveSyncCadence,

package/dist/google-drive.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/google-drive.ts"],"sourcesContent":["import { z } from \"zod\";\n\nimport { ConnectionMetadata } from \"./index\";\nimport {\n  ConnectorDocumentDestination,\n  ConnectorDocumentDestinationSelection,\n} from \"./connector-destinations\";\n\nexport const GOOGLE_DRIVE_PROVIDER_DOMAIN = \"googleapis.com\" as const;\nexport const GOOGLE_DRIVE_FULL_SCOPE = \"https://www.googleapis.com/auth/drive\" as const;\nexport const GOOGLE_DRIVE_FILE_SCOPE = \"https://www.googleapis.com/auth/drive.file\" as const;\nexport const GOOGLE_DRIVE_METADATA_READONLY_SCOPE =\n  \"https://www.googleapis.com/auth/drive.metadata.readonly\" as const;\nexport const GOOGLE_DRIVE_READONLY_SCOPE =\n  \"https://www.googleapis.com/auth/drive.readonly\" as const;\n/** Stable serialized role retained for existing connection rows; not product-facing copy. */\nexport const GOOGLE_DRIVE_CREDENTIAL_ROLE = \"google_drive_metadata\" as const;\nexport const GOOGLE_DRIVE_CREDENTIAL_LABEL = \"Google Drive read-only source sync\" as const;\nexport const GOOGLE_DRIVE_LEGACY_CREDENTIAL_LABEL = \"Google Drive metadata browser\" as const;\n\nexport const GoogleDriveOAuthCapability = z.enum([\n  \"picker_file_read\",\n  \"source_metadata_discovery\",\n  \"source_content_read\",\n  \"recursive_source_sync\",\n]);\nexport type GoogleDriveOAuthCapability = z.infer<typeof GoogleDriveOAuthCapability>;\n\nexport type GoogleDriveOAuthScopeDecision = {\n  accessMode: \"metadata_readonly\" | \"readonly\" | null;\n  capabilities: GoogleDriveOAuthCapability[];\n};\n\n/**\n * Converts exact Google OAuth grants into the Drive capabilities OpenGeni may\n * rely on. Unknown or malformed grants add no authority. In particular,\n * drive.file covers only files explicitly opened or shared with the app and\n * never authorizes arbitrary recursive descendant discovery.\n */\nexport function googleDriveOAuthScopeDecision(\n  grantedScopes: readonly string[],\n): GoogleDriveOAuthScopeDecision {\n  const granted = new Set(grantedScopes);\n  const hasFullDrive = granted.has(GOOGLE_DRIVE_FULL_SCOPE);\n  const hasSourceContentRead = hasFullDrive || granted.has(GOOGLE_DRIVE_READONLY_SCOPE);\n  const hasSourceMetadataDiscovery =\n    hasSourceContentRead || granted.has(GOOGLE_DRIVE_METADATA_READONLY_SCOPE);\n  const hasPickerFileRead = hasSourceContentRead || granted.has(GOOGLE_DRIVE_FILE_SCOPE);\n  const capabilities: GoogleDriveOAuthCapability[] = [];\n  if (hasPickerFileRead) capabilities.push(\"picker_file_read\");\n  if (hasSourceMetadataDiscovery) capabilities.push(\"source_metadata_discovery\");\n  if (hasSourceContentRead) {\n    capabilities.push(\"source_content_read\", \"recursive_source_sync\");\n  }\n  return {\n    accessMode: hasSourceContentRead\n      ? \"readonly\"\n      : hasSourceMetadataDiscovery\n        ? \"metadata_readonly\"\n        : null,\n    capabilities,\n  };\n}\n\nexport function googleDriveScopesAllowCapability(\n  grantedScopes: readonly string[],\n  capability: GoogleDriveOAuthCapability,\n): boolean {\n  return googleDriveOAuthScopeDecision(grantedScopes).capabilities.includes(capability);\n}\n\n/** @deprecated Connector document destinations use organization/workspace/personal authority. */\nexport const GoogleDriveTargetScope = z.enum([\"user\", \"workspace\", \"organization\"]);\nexport type GoogleDriveTargetScope = z.infer<typeof GoogleDriveTargetScope>;\n\nexport const GoogleDriveSyncCadence = z.enum([\"manual\", \"hourly\", \"daily\"]);\nexport type GoogleDriveSyncCadence = z.infer<typeof GoogleDriveSyncCadence>;\n\nexport const GoogleDriveReadPolicy = z.enum([\"allow\", \"ask\", \"block\"]);\nexport type GoogleDriveReadPolicy = z.infer<typeof GoogleDriveReadPolicy>;\n\nexport const GoogleDriveConnectionLifecycleState = z.enum([\n  \"active\",\n  \"paused\",\n  \"token_revoked\",\n  \"app_removed\",\n  \"disconnected\",\n  \"reconnect_required\",\n  \"reconsent_required\",\n]);\nexport type GoogleDriveConnectionLifecycleState = z.infer<\n  typeof GoogleDriveConnectionLifecycleState\n>;\n\nconst GoogleDriveLifecycleObservedAt = z.string().datetime({ offset: true });\nexport const GoogleDriveConnectionLifecycle = z.discriminatedUnion(\"state\", [\n  z.object({\n    state: z.literal(\"active\"),\n    recoverable: z.literal(true),\n    observedAt: GoogleDriveLifecycleObservedAt,\n  }),\n  z.object({\n    state: z.literal(\"paused\"),\n    recoverable: z.literal(true),\n    observedAt: GoogleDriveLifecycleObservedAt,\n  }),\n  z.object({\n    state: z.literal(\"token_revoked\"),\n    recoverable: z.literal(true),\n    observedAt: GoogleDriveLifecycleObservedAt,\n  }),\n  z.object({\n    state: z.literal(\"app_removed\"),\n    recoverable: z.literal(false),\n    observedAt: GoogleDriveLifecycleObservedAt,\n  }),\n  z.object({\n    state: z.literal(\"disconnected\"),\n    recoverable: z.literal(true),\n    observedAt: GoogleDriveLifecycleObservedAt,\n  }),\n  z.object({\n    state: z.literal(\"reconnect_required\"),\n    recoverable: z.literal(true),\n    observedAt: GoogleDriveLifecycleObservedAt,\n  }),\n  z.object({\n    state: z.literal(\"reconsent_required\"),\n    recoverable: z.literal(true),\n    observedAt: GoogleDriveLifecycleObservedAt,\n  }),\n]);\nexport type GoogleDriveConnectionLifecycle = z.infer<typeof GoogleDriveConnectionLifecycle>;\n\nexport const GoogleDriveSelectedSource = z.object({\n  id: z.string().min(1).max(256),\n  name: z.string().min(1).max(1024),\n  mimeType: z.string().min(1).max(256),\n  driveId: z.string().min(1).max(256).nullable().default(null),\n  destination: ConnectorDocumentDestination.optional(),\n  /** @deprecated Missing destinations resolve to the current workspace boundary. */\n  targetScope: GoogleDriveTargetScope.optional(),\n  syncCadence: GoogleDriveSyncCadence.default(\"hourly\"),\n  syncEnabled: z.boolean().default(false),\n  configGeneration: z.number().int().positive().default(1),\n  readPolicy: GoogleDriveReadPolicy.default(\"allow\"),\n  selectedAt: z.string().datetime({ offset: true }),\n});\nexport type GoogleDriveSelectedSource = z.infer<typeof GoogleDriveSelectedSource>;\n\nexport const GoogleDriveConnectionMetadata = z\n  .object({\n    credentialRole: z.literal(GOOGLE_DRIVE_CREDENTIAL_ROLE),\n    credentialLabel: z.union([\n      z.literal(GOOGLE_DRIVE_CREDENTIAL_LABEL),\n      z.literal(GOOGLE_DRIVE_LEGACY_CREDENTIAL_LABEL),\n    ]),\n    googlePermissionId: z.string().min(1).max(256),\n    googleEmail: z.string().email().max(320),\n    googleDisplayName: z.string().min(1).max(512).nullable(),\n    verifiedAt: z.string().datetime({ offset: true }),\n    accessMode: z.enum([\"metadata_readonly\", \"readonly\"]),\n    lifecycle: GoogleDriveConnectionLifecycle.optional(),\n    documentDestination: ConnectorDocumentDestination.optional(),\n    selectedSources: z.array(GoogleDriveSelectedSource).max(100).optional(),\n    /** @deprecated Read `selectedSources`; retained while existing connections migrate. */\n    selectedSource: GoogleDriveSelectedSource.nullable().optional(),\n  })\n  .passthrough();\nexport type GoogleDriveConnectionMetadata = z.infer<typeof GoogleDriveConnectionMetadata>;\n\nexport const GoogleDriveOAuthStartRequest = z.object({\n  connectionId: z.string().uuid().optional(),\n});\nexport type GoogleDriveOAuthStartRequest = z.infer<typeof GoogleDriveOAuthStartRequest>;\n\nexport const GoogleDriveOAuthStartResponse = z.object({\n  authorizationUrl: z.string().url(),\n  expiresAt: z.string().datetime({ offset: true }),\n});\nexport type GoogleDriveOAuthStartResponse = z.infer<typeof GoogleDriveOAuthStartResponse>;\n\nexport const GoogleDriveLifecycleActionRequest = z.object({\n  action: z.enum([\"pause\", \"resume\"]),\n  expectedVersion: z.number().int().positive(),\n});\nexport type GoogleDriveLifecycleActionRequest = z.infer<typeof GoogleDriveLifecycleActionRequest>;\n\nexport const GoogleDriveDisconnectRequest = z.object({\n  expectedVersion: z.number().int().positive(),\n  idempotencyKey: z.string().trim().min(1).max(200),\n});\nexport type GoogleDriveDisconnectRequest = z.infer<typeof GoogleDriveDisconnectRequest>;\n\nexport const GoogleDriveBrowseItem = z.object({\n  id: z.string().min(1).max(256),\n  name: z.string().min(1).max(1024),\n  mimeType: z.string().min(1).max(256),\n  kind: z.enum([\"folder\", \"file\"]),\n  driveId: z.string().min(1).max(256).nullable(),\n  modifiedTime: z.string().datetime({ offset: true }).nullable(),\n  size: z.string().regex(/^\\d+$/).nullable(),\n  webViewLink: z.string().url().nullable(),\n});\nexport type GoogleDriveBrowseItem = z.infer<typeof GoogleDriveBrowseItem>;\n\nexport const GoogleDriveBrowseResponse = z.object({\n  connection: z.lazy(() => ConnectionMetadata),\n  parentId: z.string().min(1).max(256),\n  current: GoogleDriveBrowseItem.nullable(),\n  items: z.array(GoogleDriveBrowseItem),\n  nextPageToken: z.string().min(1).max(4096).nullable(),\n  incompleteSearch: z.boolean(),\n});\nexport type GoogleDriveBrowseResponse = z.infer<typeof GoogleDriveBrowseResponse>;\n\nconst GoogleDriveSourceSelection = z\n  .array(\n    GoogleDriveBrowseItem.pick({\n      id: true,\n      name: true,\n      mimeType: true,\n      driveId: true,\n    }),\n  )\n  .max(100)\n  .refine((sources) => new Set(sources.map((source) => source.id)).size === sources.length, {\n    message: \"Google Drive sources must be unique\",\n  });\n\nexport const SaveGoogleDriveSourceRequest = z\n  .object({\n    sources: GoogleDriveSourceSelection,\n    destination: ConnectorDocumentDestinationSelection.optional(),\n    /** @deprecated Legacy requests are accepted but resolve to workspace authority. */\n    targetScope: GoogleDriveTargetScope.optional(),\n    syncCadence: GoogleDriveSyncCadence.default(\"hourly\"),\n    syncEnabled: z.boolean().default(false),\n    readPolicy: GoogleDriveReadPolicy.default(\"allow\"),\n  })\n  .refine((request) => request.destination !== undefined || request.targetScope !== undefined, {\n    message: \"Google Drive document destination is required\",\n  });\nexport type SaveGoogleDriveSourceRequest = z.infer<typeof SaveGoogleDriveSourceRequest>;\n\nexport const GoogleDriveKnowledgeSourceItem = z.object({\n  id: z.string().min(1).max(512),\n  name: z.string().min(1).max(1024),\n  mimeType: z.string().min(1).max(256),\n  driveId: z.string().min(1).max(512).optional(),\n  sourceKind: z.enum([\"my_drive\", \"shared_drive\", \"folder\"]),\n  includeDescendants: z.boolean(),\n});\nexport type GoogleDriveKnowledgeSourceItem = z.infer<typeof GoogleDriveKnowledgeSourceItem>;\n\nexport const GoogleDriveKnowledgeSourceDestination = z.object({\n  authorityKind: z.enum([\"organization\", \"workspace\", \"personal\"]),\n  authorityAccountId: z.string().min(1).max(128),\n  authorityWorkspaceId: z.string().min(1).max(128).optional(),\n  authoritySubjectId: z.string().min(1).max(512).optional(),\n  collectionId: z.string().min(1).max(512).optional(),\n});\nexport type GoogleDriveKnowledgeSourceDestination = z.infer<\n  typeof GoogleDriveKnowledgeSourceDestination\n>;\n\nexport const GoogleDriveKnowledgeSourceConfig = z.object({\n  sources: z.array(GoogleDriveKnowledgeSourceItem).min(1).max(100),\n  destination: GoogleDriveKnowledgeSourceDestination,\n  syncCadence: GoogleDriveSyncCadence,\n  readPolicy: GoogleDriveReadPolicy,\n});\nexport type GoogleDriveKnowledgeSourceConfig = z.infer<typeof GoogleDriveKnowledgeSourceConfig>;\n\nexport const SaveGoogleDriveIntegrationSourceRequest = z.intersection(\n  SaveGoogleDriveSourceRequest,\n  z.object({\n    sources: GoogleDriveSourceSelection.refine((sources) => sources.length > 0, {\n      message: \"At least one Google Drive source is required\",\n    }),\n    expectedVersion: z.number().int().positive().optional(),\n    idempotencyKey: z.string().uuid(),\n  }),\n);\nexport type SaveGoogleDriveIntegrationSourceRequest = z.infer<\n  typeof SaveGoogleDriveIntegrationSourceRequest\n>;\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/google-drive.ts"],"sourcesContent":["import { z } from \"zod\";\n\nimport { ConnectionMetadata } from \"./index\";\nimport {\n  ConnectorDocumentDestination,\n  ConnectorDocumentDestinationSelection,\n} from \"./connector-destinations\";\n\nexport const GOOGLE_DRIVE_PROVIDER_DOMAIN = \"googleapis.com\" as const;\nexport const GOOGLE_DRIVE_FULL_SCOPE = \"https://www.googleapis.com/auth/drive\" as const;\nexport const GOOGLE_DRIVE_FILE_SCOPE = \"https://www.googleapis.com/auth/drive.file\" as const;\nexport const GOOGLE_DRIVE_METADATA_READONLY_SCOPE =\n  \"https://www.googleapis.com/auth/drive.metadata.readonly\" as const;\nexport const GOOGLE_DRIVE_READONLY_SCOPE =\n  \"https://www.googleapis.com/auth/drive.readonly\" as const;\n/** Stable serialized role retained for existing connection rows; not product-facing copy. */\nexport const GOOGLE_DRIVE_CREDENTIAL_ROLE = \"google_drive_metadata\" as const;\nexport const GOOGLE_DRIVE_CREDENTIAL_LABEL = \"Google Drive read-only source sync\" as const;\nexport const GOOGLE_DRIVE_LEGACY_CREDENTIAL_LABEL = \"Google Drive metadata browser\" as const;\nexport const GOOGLE_DRIVE_PUBLICATION_SERVER_ID = \"google-drive-publishing\" as const;\nexport const GOOGLE_DRIVE_PUBLICATION_TOOL_NAME = \"google_drive_publish_file\" as const;\nexport const GOOGLE_DRIVE_PUBLICATION_CREATE_ACTION = \"create\" as const;\n\nexport const GoogleDriveOAuthCapability = z.enum([\n  \"picker_file_read\",\n  \"publish_file\",\n  \"source_metadata_discovery\",\n  \"source_content_read\",\n  \"recursive_source_sync\",\n]);\nexport type GoogleDriveOAuthCapability = z.infer<typeof GoogleDriveOAuthCapability>;\n\nexport type GoogleDriveOAuthScopeDecision = {\n  accessMode: \"file_only\" | \"metadata_readonly\" | \"readonly\" | null;\n  capabilities: GoogleDriveOAuthCapability[];\n};\n\n/**\n * Converts exact Google OAuth grants into the Drive capabilities OpenGeni may\n * rely on. Unknown or malformed grants add no authority. In particular,\n * drive.file covers only files explicitly opened or shared with the app and\n * never authorizes arbitrary recursive descendant discovery.\n */\nexport function googleDriveOAuthScopeDecision(\n  grantedScopes: readonly string[],\n): GoogleDriveOAuthScopeDecision {\n  const granted = new Set(grantedScopes);\n  const hasFullDrive = granted.has(GOOGLE_DRIVE_FULL_SCOPE);\n  const hasSourceContentRead = hasFullDrive || granted.has(GOOGLE_DRIVE_READONLY_SCOPE);\n  const hasFileWrite = hasFullDrive || granted.has(GOOGLE_DRIVE_FILE_SCOPE);\n  const hasSourceMetadataDiscovery =\n    hasSourceContentRead || granted.has(GOOGLE_DRIVE_METADATA_READONLY_SCOPE);\n  const hasPickerFileRead = hasSourceContentRead || hasFileWrite;\n  const capabilities: GoogleDriveOAuthCapability[] = [];\n  if (hasPickerFileRead) capabilities.push(\"picker_file_read\");\n  if (hasFileWrite) capabilities.push(\"publish_file\");\n  if (hasSourceMetadataDiscovery) capabilities.push(\"source_metadata_discovery\");\n  if (hasSourceContentRead) {\n    capabilities.push(\"source_content_read\", \"recursive_source_sync\");\n  }\n  return {\n    accessMode: hasSourceContentRead\n      ? \"readonly\"\n      : hasSourceMetadataDiscovery\n        ? \"metadata_readonly\"\n        : hasFileWrite\n          ? \"file_only\"\n          : null,\n    capabilities,\n  };\n}\n\nexport function googleDriveScopesAllowCapability(\n  grantedScopes: readonly string[],\n  capability: GoogleDriveOAuthCapability,\n): boolean {\n  return googleDriveOAuthScopeDecision(grantedScopes).capabilities.includes(capability);\n}\n\n/** @deprecated Connector document destinations use organization/workspace/personal authority. */\nexport const GoogleDriveTargetScope = z.enum([\"user\", \"workspace\", \"organization\"]);\nexport type GoogleDriveTargetScope = z.infer<typeof GoogleDriveTargetScope>;\n\nexport const GoogleDriveSyncCadence = z.enum([\"manual\", \"hourly\", \"daily\"]);\nexport type GoogleDriveSyncCadence = z.infer<typeof GoogleDriveSyncCadence>;\n\nexport const GoogleDriveReadPolicy = z.enum([\"allow\", \"ask\", \"block\"]);\nexport type GoogleDriveReadPolicy = z.infer<typeof GoogleDriveReadPolicy>;\n\nexport const GoogleDriveConnectionLifecycleState = z.enum([\n  \"active\",\n  \"paused\",\n  \"token_revoked\",\n  \"app_removed\",\n  \"disconnected\",\n  \"reconnect_required\",\n  \"reconsent_required\",\n]);\nexport type GoogleDriveConnectionLifecycleState = z.infer<\n  typeof GoogleDriveConnectionLifecycleState\n>;\n\nconst GoogleDriveLifecycleObservedAt = z.string().datetime({ offset: true });\nexport const GoogleDriveConnectionLifecycle = z.discriminatedUnion(\"state\", [\n  z.object({\n    state: z.literal(\"active\"),\n    recoverable: z.literal(true),\n    observedAt: GoogleDriveLifecycleObservedAt,\n  }),\n  z.object({\n    state: z.literal(\"paused\"),\n    recoverable: z.literal(true),\n    observedAt: GoogleDriveLifecycleObservedAt,\n  }),\n  z.object({\n    state: z.literal(\"token_revoked\"),\n    recoverable: z.literal(true),\n    observedAt: GoogleDriveLifecycleObservedAt,\n  }),\n  z.object({\n    state: z.literal(\"app_removed\"),\n    recoverable: z.literal(false),\n    observedAt: GoogleDriveLifecycleObservedAt,\n  }),\n  z.object({\n    state: z.literal(\"disconnected\"),\n    recoverable: z.literal(true),\n    observedAt: GoogleDriveLifecycleObservedAt,\n  }),\n  z.object({\n    state: z.literal(\"reconnect_required\"),\n    recoverable: z.literal(true),\n    observedAt: GoogleDriveLifecycleObservedAt,\n  }),\n  z.object({\n    state: z.literal(\"reconsent_required\"),\n    recoverable: z.literal(true),\n    observedAt: GoogleDriveLifecycleObservedAt,\n  }),\n]);\nexport type GoogleDriveConnectionLifecycle = z.infer<typeof GoogleDriveConnectionLifecycle>;\n\nexport const GoogleDriveSelectedSource = z.object({\n  id: z.string().min(1).max(256),\n  name: z.string().min(1).max(1024),\n  mimeType: z.string().min(1).max(256),\n  driveId: z.string().min(1).max(256).nullable().default(null),\n  destination: ConnectorDocumentDestination.optional(),\n  /** @deprecated Missing destinations resolve to the current workspace boundary. */\n  targetScope: GoogleDriveTargetScope.optional(),\n  syncCadence: GoogleDriveSyncCadence.default(\"hourly\"),\n  syncEnabled: z.boolean().default(false),\n  configGeneration: z.number().int().positive().default(1),\n  readPolicy: GoogleDriveReadPolicy.default(\"allow\"),\n  selectedAt: z.string().datetime({ offset: true }),\n});\nexport type GoogleDriveSelectedSource = z.infer<typeof GoogleDriveSelectedSource>;\n\nexport const GoogleDriveOutputDestination = z\n  .object({\n    folderId: z.string().min(1).max(256),\n    folderName: z.string().min(1).max(1024),\n    driveId: z.string().min(1).max(256).nullable(),\n    location: z.enum([\"my_drive\", \"shared_drive\"]),\n    selectedAt: z.string().datetime({ offset: true }),\n  })\n  .strict()\n  .superRefine((value, context) => {\n    if ((value.location === \"my_drive\") !== (value.driveId === null)) {\n      context.addIssue({\n        code: \"custom\",\n        path: [\"driveId\"],\n        message: \"Google Drive destination location does not match its drive identity\",\n      });\n    }\n  });\nexport type GoogleDriveOutputDestination = z.infer<typeof GoogleDriveOutputDestination>;\n\nexport const GoogleDriveConnectionMetadata = z\n  .object({\n    credentialRole: z.literal(GOOGLE_DRIVE_CREDENTIAL_ROLE),\n    credentialLabel: z.union([\n      z.literal(GOOGLE_DRIVE_CREDENTIAL_LABEL),\n      z.literal(GOOGLE_DRIVE_LEGACY_CREDENTIAL_LABEL),\n    ]),\n    googlePermissionId: z.string().min(1).max(256),\n    googleEmail: z.string().email().max(320),\n    googleDisplayName: z.string().min(1).max(512).nullable(),\n    verifiedAt: z.string().datetime({ offset: true }),\n    accessMode: z.enum([\"file_only\", \"metadata_readonly\", \"readonly\"]),\n    lifecycle: GoogleDriveConnectionLifecycle.optional(),\n    outputDestination: GoogleDriveOutputDestination.optional(),\n    documentDestination: ConnectorDocumentDestination.optional(),\n    selectedSources: z.array(GoogleDriveSelectedSource).max(100).optional(),\n    /** @deprecated Read `selectedSources`; retained while existing connections migrate. */\n    selectedSource: GoogleDriveSelectedSource.nullable().optional(),\n  })\n  .passthrough();\nexport type GoogleDriveConnectionMetadata = z.infer<typeof GoogleDriveConnectionMetadata>;\n\nexport const GoogleDriveOAuthStartRequest = z.object({\n  connectionId: z.string().uuid().optional(),\n  capability: z.enum([\"source_read\", \"publish\"]).default(\"source_read\"),\n});\nexport type GoogleDriveOAuthStartRequest = z.infer<typeof GoogleDriveOAuthStartRequest>;\n\nexport const GoogleDriveOAuthStartResponse = z.object({\n  authorizationUrl: z.string().url(),\n  expiresAt: z.string().datetime({ offset: true }),\n});\nexport type GoogleDriveOAuthStartResponse = z.infer<typeof GoogleDriveOAuthStartResponse>;\n\nexport const GoogleDriveLifecycleActionRequest = z.object({\n  action: z.enum([\"pause\", \"resume\"]),\n  expectedVersion: z.number().int().positive(),\n});\nexport type GoogleDriveLifecycleActionRequest = z.infer<typeof GoogleDriveLifecycleActionRequest>;\n\nexport const GoogleDriveDisconnectRequest = z.object({\n  expectedVersion: z.number().int().positive(),\n  idempotencyKey: z.string().trim().min(1).max(200),\n});\nexport type GoogleDriveDisconnectRequest = z.infer<typeof GoogleDriveDisconnectRequest>;\n\nexport const GoogleDrivePublicationExportFile = z\n  .object({\n    fileId: z.string().uuid(),\n    filename: z.string().trim().min(1).max(512),\n    contentType: z.string().trim().min(1).max(256),\n    sizeBytes: z.number().int().positive(),\n    sha256: z.string().regex(/^[0-9a-f]{64}$/u),\n    artifactId: z.string().regex(/^[0-9a-f]{32}$/u),\n    versionId: z.string().regex(/^[0-9a-f]{32}$/u),\n    materializationJobId: z.string().regex(/^[0-9a-f]{32}$/u),\n    sourceHeadSequence: z.number().int().nonnegative(),\n    sourceStateHash: z.string().regex(/^sha256:[0-9a-f]{64}$/u),\n  })\n  .strict();\nexport type GoogleDrivePublicationExportFile = z.infer<typeof GoogleDrivePublicationExportFile>;\n\nexport const GoogleDrivePublicationToolInput = z\n  .object({\n    title: z.string().trim().min(1).max(512),\n    modality: z.enum([\"document\", \"spreadsheet\", \"presentation\"]),\n    file: GoogleDrivePublicationExportFile,\n    idempotencyKey: z.string().trim().min(1).max(200),\n  })\n  .strict();\nexport type GoogleDrivePublicationToolInput = z.infer<typeof GoogleDrivePublicationToolInput>;\n\nexport const GoogleDrivePublicationReceipt = z\n  .object({\n    connectionId: z.string().uuid(),\n    providerFileId: z.string().min(1).max(256),\n    webViewLink: z.string().url(),\n    mimeType: z.enum([\n      \"application/vnd.google-apps.document\",\n      \"application/vnd.google-apps.spreadsheet\",\n      \"application/vnd.google-apps.presentation\",\n    ]),\n    destination: GoogleDriveOutputDestination,\n    replayed: z.boolean(),\n  })\n  .strict();\nexport type GoogleDrivePublicationReceipt = z.infer<typeof GoogleDrivePublicationReceipt>;\n\nexport const GoogleDriveBrowseItem = z.object({\n  id: z.string().min(1).max(256),\n  name: z.string().min(1).max(1024),\n  mimeType: z.string().min(1).max(256),\n  kind: z.enum([\"folder\", \"file\"]),\n  driveId: z.string().min(1).max(256).nullable(),\n  modifiedTime: z.string().datetime({ offset: true }).nullable(),\n  size: z.string().regex(/^\\d+$/).nullable(),\n  webViewLink: z.string().url().nullable(),\n});\nexport type GoogleDriveBrowseItem = z.infer<typeof GoogleDriveBrowseItem>;\n\nexport const GoogleDriveBrowseResponse = z.object({\n  connection: z.lazy(() => ConnectionMetadata),\n  parentId: z.string().min(1).max(256),\n  current: GoogleDriveBrowseItem.nullable(),\n  items: z.array(GoogleDriveBrowseItem),\n  nextPageToken: z.string().min(1).max(4096).nullable(),\n  incompleteSearch: z.boolean(),\n});\nexport type GoogleDriveBrowseResponse = z.infer<typeof GoogleDriveBrowseResponse>;\n\nconst GoogleDriveSourceSelection = z\n  .array(\n    GoogleDriveBrowseItem.pick({\n      id: true,\n      name: true,\n      mimeType: true,\n      driveId: true,\n    }),\n  )\n  .max(100)\n  .refine((sources) => new Set(sources.map((source) => source.id)).size === sources.length, {\n    message: \"Google Drive sources must be unique\",\n  });\n\nexport const SaveGoogleDriveSourceRequest = z\n  .object({\n    sources: GoogleDriveSourceSelection,\n    destination: ConnectorDocumentDestinationSelection.optional(),\n    /** @deprecated Legacy requests are accepted but resolve to workspace authority. */\n    targetScope: GoogleDriveTargetScope.optional(),\n    syncCadence: GoogleDriveSyncCadence.default(\"hourly\"),\n    syncEnabled: z.boolean().default(false),\n    readPolicy: GoogleDriveReadPolicy.default(\"allow\"),\n  })\n  .refine((request) => request.destination !== undefined || request.targetScope !== undefined, {\n    message: \"Google Drive document destination is required\",\n  });\nexport type SaveGoogleDriveSourceRequest = z.infer<typeof SaveGoogleDriveSourceRequest>;\n\nexport const GoogleDriveKnowledgeSourceItem = z.object({\n  id: z.string().min(1).max(512),\n  name: z.string().min(1).max(1024),\n  mimeType: z.string().min(1).max(256),\n  driveId: z.string().min(1).max(512).optional(),\n  sourceKind: z.enum([\"my_drive\", \"shared_drive\", \"folder\"]),\n  includeDescendants: z.boolean(),\n});\nexport type GoogleDriveKnowledgeSourceItem = z.infer<typeof GoogleDriveKnowledgeSourceItem>;\n\nexport const GoogleDriveKnowledgeSourceDestination = z.object({\n  authorityKind: z.enum([\"organization\", \"workspace\", \"personal\"]),\n  authorityAccountId: z.string().min(1).max(128),\n  authorityWorkspaceId: z.string().min(1).max(128).optional(),\n  authoritySubjectId: z.string().min(1).max(512).optional(),\n  collectionId: z.string().min(1).max(512).optional(),\n});\nexport type GoogleDriveKnowledgeSourceDestination = z.infer<\n  typeof GoogleDriveKnowledgeSourceDestination\n>;\n\nexport const GoogleDriveKnowledgeSourceConfig = z.object({\n  sources: z.array(GoogleDriveKnowledgeSourceItem).min(1).max(100),\n  destination: GoogleDriveKnowledgeSourceDestination,\n  syncCadence: GoogleDriveSyncCadence,\n  readPolicy: GoogleDriveReadPolicy,\n});\nexport type GoogleDriveKnowledgeSourceConfig = z.infer<typeof GoogleDriveKnowledgeSourceConfig>;\n\nexport const SaveGoogleDriveIntegrationSourceRequest = z.intersection(\n  SaveGoogleDriveSourceRequest,\n  z.object({\n    sources: GoogleDriveSourceSelection.refine((sources) => sources.length > 0, {\n      message: \"At least one Google Drive source is required\",\n    }),\n    expectedVersion: z.number().int().positive().optional(),\n    idempotencyKey: z.string().uuid(),\n  }),\n);\nexport type SaveGoogleDriveIntegrationSourceRequest = z.infer<\n  typeof SaveGoogleDriveIntegrationSourceRequest\n>;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AAAA,SAAS,SAAS;AAQX,IAAM,+BAA+B;AACrC,IAAM,0BAA0B;AAChC,IAAM,0BAA0B;AAChC,IAAM,uCACX;AACK,IAAM,8BACX;AAEK,IAAM,+BAA+B;AACrC,IAAM,gCAAgC;AACtC,IAAM,uCAAuC;AAC7C,IAAM,qCAAqC;AAC3C,IAAM,qCAAqC;AAC3C,IAAM,yCAAyC;AAE/C,IAAM,6BAA6B,EAAE,KAAK;AAAA,EAC/C;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,CAAC;AAcM,SAAS,8BACd,eAC+B;AAC/B,QAAM,UAAU,IAAI,IAAI,aAAa;AACrC,QAAM,eAAe,QAAQ,IAAI,uBAAuB;AACxD,QAAM,uBAAuB,gBAAgB,QAAQ,IAAI,2BAA2B;AACpF,QAAM,eAAe,gBAAgB,QAAQ,IAAI,uBAAuB;AACxE,QAAM,6BACJ,wBAAwB,QAAQ,IAAI,oCAAoC;AAC1E,QAAM,oBAAoB,wBAAwB;AAClD,QAAM,eAA6C,CAAC;AACpD,MAAI,kBAAmB,cAAa,KAAK,kBAAkB;AAC3D,MAAI,aAAc,cAAa,KAAK,cAAc;AAClD,MAAI,2BAA4B,cAAa,KAAK,2BAA2B;AAC7E,MAAI,sBAAsB;AACxB,iBAAa,KAAK,uBAAuB,uBAAuB;AAAA,EAClE;AACA,SAAO;AAAA,IACL,YAAY,uBACR,aACA,6BACE,sBACA,eACE,cACA;AAAA,IACR;AAAA,EACF;AACF;AAEO,SAAS,iCACd,eACA,YACS;AACT,SAAO,8BAA8B,aAAa,EAAE,aAAa,SAAS,UAAU;AACtF;AAGO,IAAM,yBAAyB,EAAE,KAAK,CAAC,QAAQ,aAAa,cAAc,CAAC;AAG3E,IAAM,yBAAyB,EAAE,KAAK,CAAC,UAAU,UAAU,OAAO,CAAC;AAGnE,IAAM,wBAAwB,EAAE,KAAK,CAAC,SAAS,OAAO,OAAO,CAAC;AAG9D,IAAM,sCAAsC,EAAE,KAAK;AAAA,EACxD;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,CAAC;AAKD,IAAM,iCAAiC,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,KAAK,CAAC;AACpE,IAAM,iCAAiC,EAAE,mBAAmB,SAAS;AAAA,EAC1E,EAAE,OAAO;AAAA,IACP,OAAO,EAAE,QAAQ,QAAQ;AAAA,IACzB,aAAa,EAAE,QAAQ,IAAI;AAAA,IAC3B,YAAY;AAAA,EACd,CAAC;AAAA,EACD,EAAE,OAAO;AAAA,IACP,OAAO,EAAE,QAAQ,QAAQ;AAAA,IACzB,aAAa,EAAE,QAAQ,IAAI;AAAA,IAC3B,YAAY;AAAA,EACd,CAAC;AAAA,EACD,EAAE,OAAO;AAAA,IACP,OAAO,EAAE,QAAQ,eAAe;AAAA,IAChC,aAAa,EAAE,QAAQ,IAAI;AAAA,IAC3B,YAAY;AAAA,EACd,CAAC;AAAA,EACD,EAAE,OAAO;AAAA,IACP,OAAO,EAAE,QAAQ,aAAa;AAAA,IAC9B,aAAa,EAAE,QAAQ,KAAK;AAAA,IAC5B,YAAY;AAAA,EACd,CAAC;AAAA,EACD,EAAE,OAAO;AAAA,IACP,OAAO,EAAE,QAAQ,cAAc;AAAA,IAC/B,aAAa,EAAE,QAAQ,IAAI;AAAA,IAC3B,YAAY;AAAA,EACd,CAAC;AAAA,EACD,EAAE,OAAO;AAAA,IACP,OAAO,EAAE,QAAQ,oBAAoB;AAAA,IACrC,aAAa,EAAE,QAAQ,IAAI;AAAA,IAC3B,YAAY;AAAA,EACd,CAAC;AAAA,EACD,EAAE,OAAO;AAAA,IACP,OAAO,EAAE,QAAQ,oBAAoB;AAAA,IACrC,aAAa,EAAE,QAAQ,IAAI;AAAA,IAC3B,YAAY;AAAA,EACd,CAAC;AACH,CAAC;AAGM,IAAM,4BAA4B,EAAE,OAAO;AAAA,EAChD,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG;AAAA,EAC7B,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,IAAI;AAAA,EAChC,UAAU,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG;AAAA,EACnC,SAAS,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG,EAAE,SAAS,EAAE,QAAQ,IAAI;AAAA,EAC3D,aAAa,6BAA6B,SAAS;AAAA;AAAA,EAEnD,aAAa,uBAAuB,SAAS;AAAA,EAC7C,aAAa,uBAAuB,QAAQ,QAAQ;AAAA,EACpD,aAAa,EAAE,QAAQ,EAAE,QAAQ,KAAK;AAAA,EACtC,kBAAkB,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,CAAC;AAAA,EACvD,YAAY,sBAAsB,QAAQ,OAAO;AAAA,EACjD,YAAY,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,KAAK,CAAC;AAClD,CAAC;AAGM,IAAM,+BAA+B,EACzC,OAAO;AAAA,EACN,UAAU,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG;AAAA,EACnC,YAAY,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,IAAI;AAAA,EACtC,SAAS,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG,EAAE,SAAS;AAAA,EAC7C,UAAU,EAAE,KAAK,CAAC,YAAY,cAAc,CAAC;AAAA,EAC7C,YAAY,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,KAAK,CAAC;AAClD,CAAC,EACA,OAAO,EACP,YAAY,CAAC,OAAO,YAAY;AAC/B,MAAK,MAAM,aAAa,gBAAiB,MAAM,YAAY,OAAO;AAChE,YAAQ,SAAS;AAAA,MACf,MAAM;AAAA,MACN,MAAM,CAAC,SAAS;AAAA,MAChB,SAAS;AAAA,IACX,CAAC;AAAA,EACH;AACF,CAAC;AAGI,IAAM,gCAAgC,EAC1C,OAAO;AAAA,EACN,gBAAgB,EAAE,QAAQ,4BAA4B;AAAA,EACtD,iBAAiB,EAAE,MAAM;AAAA,IACvB,EAAE,QAAQ,6BAA6B;AAAA,IACvC,EAAE,QAAQ,oCAAoC;AAAA,EAChD,CAAC;AAAA,EACD,oBAAoB,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG;AAAA,EAC7C,aAAa,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,GAAG;AAAA,EACvC,mBAAmB,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG,EAAE,SAAS;AAAA,EACvD,YAAY,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,KAAK,CAAC;AAAA,EAChD,YAAY,EAAE,KAAK,CAAC,aAAa,qBAAqB,UAAU,CAAC;AAAA,EACjE,WAAW,+BAA+B,SAAS;AAAA,EACnD,mBAAmB,6BAA6B,SAAS;AAAA,EACzD,qBAAqB,6BAA6B,SAAS;AAAA,EAC3D,iBAAiB,EAAE,MAAM,yBAAyB,EAAE,IAAI,GAAG,EAAE,SAAS;AAAA;AAAA,EAEtE,gBAAgB,0BAA0B,SAAS,EAAE,SAAS;AAChE,CAAC,EACA,YAAY;AAGR,IAAM,+BAA+B,EAAE,OAAO;AAAA,EACnD,cAAc,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS;AAAA,EACzC,YAAY,EAAE,KAAK,CAAC,eAAe,SAAS,CAAC,EAAE,QAAQ,aAAa;AACtE,CAAC;AAGM,IAAM,gCAAgC,EAAE,OAAO;AAAA,EACpD,kBAAkB,EAAE,OAAO,EAAE,IAAI;AAAA,EACjC,WAAW,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,KAAK,CAAC;AACjD,CAAC;AAGM,IAAM,oCAAoC,EAAE,OAAO;AAAA,EACxD,QAAQ,EAAE,KAAK,CAAC,SAAS,QAAQ,CAAC;AAAA,EAClC,iBAAiB,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS;AAC7C,CAAC;AAGM,IAAM,+BAA+B,EAAE,OAAO;AAAA,EACnD,iBAAiB,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS;AAAA,EAC3C,gBAAgB,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG;AAClD,CAAC;AAGM,IAAM,mCAAmC,EAC7C,OAAO;AAAA,EACN,QAAQ,EAAE,OAAO,EAAE,KAAK;AAAA,EACxB,UAAU,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG;AAAA,EAC1C,aAAa,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG;AAAA,EAC7C,WAAW,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS;AAAA,EACrC,QAAQ,EAAE,OAAO,EAAE,MAAM,iBAAiB;AAAA,EAC1C,YAAY,EAAE,OAAO,EAAE,MAAM,iBAAiB;AAAA,EAC9C,WAAW,EAAE,OAAO,EAAE,MAAM,iBAAiB;AAAA,EAC7C,sBAAsB,EAAE,OAAO,EAAE,MAAM,iBAAiB;AAAA,EACxD,oBAAoB,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY;AAAA,EACjD,iBAAiB,EAAE,OAAO,EAAE,MAAM,wBAAwB;AAC5D,CAAC,EACA,OAAO;AAGH,IAAM,kCAAkC,EAC5C,OAAO;AAAA,EACN,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG;AAAA,EACvC,UAAU,EAAE,KAAK,CAAC,YAAY,eAAe,cAAc,CAAC;AAAA,EAC5D,MAAM;AAAA,EACN,gBAAgB,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG;AAClD,CAAC,EACA,OAAO;AAGH,IAAM,gCAAgC,EAC1C,OAAO;AAAA,EACN,cAAc,EAAE,OAAO,EAAE,KAAK;AAAA,EAC9B,gBAAgB,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG;AAAA,EACzC,aAAa,EAAE,OAAO,EAAE,IAAI;AAAA,EAC5B,UAAU,EAAE,KAAK;AAAA,IACf;AAAA,IACA;AAAA,IACA;AAAA,EACF,CAAC;AAAA,EACD,aAAa;AAAA,EACb,UAAU,EAAE,QAAQ;AACtB,CAAC,EACA,OAAO;AAGH,IAAM,wBAAwB,EAAE,OAAO;AAAA,EAC5C,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG;AAAA,EAC7B,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,IAAI;AAAA,EAChC,UAAU,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG;AAAA,EACnC,MAAM,EAAE,KAAK,CAAC,UAAU,MAAM,CAAC;AAAA,EAC/B,SAAS,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG,EAAE,SAAS;AAAA,EAC7C,cAAc,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,KAAK,CAAC,EAAE,SAAS;AAAA,EAC7D,MAAM,EAAE,OAAO,EAAE,MAAM,OAAO,EAAE,SAAS;AAAA,EACzC,aAAa,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS;AACzC,CAAC;AAGM,IAAM,4BAA4B,EAAE,OAAO;AAAA,EAChD,YAAY,EAAE,KAAK,MAAM,kBAAkB;AAAA,EAC3C,UAAU,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG;AAAA,EACnC,SAAS,sBAAsB,SAAS;AAAA,EACxC,OAAO,EAAE,MAAM,qBAAqB;AAAA,EACpC,eAAe,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,IAAI,EAAE,SAAS;AAAA,EACpD,kBAAkB,EAAE,QAAQ;AAC9B,CAAC;AAGD,IAAM,6BAA6B,EAChC;AAAA,EACC,sBAAsB,KAAK;AAAA,IACzB,IAAI;AAAA,IACJ,MAAM;AAAA,IACN,UAAU;AAAA,IACV,SAAS;AAAA,EACX,CAAC;AACH,EACC,IAAI,GAAG,EACP,OAAO,CAAC,YAAY,IAAI,IAAI,QAAQ,IAAI,CAAC,WAAW,OAAO,EAAE,CAAC,EAAE,SAAS,QAAQ,QAAQ;AAAA,EACxF,SAAS;AACX,CAAC;AAEI,IAAM,+BAA+B,EACzC,OAAO;AAAA,EACN,SAAS;AAAA,EACT,aAAa,sCAAsC,SAAS;AAAA;AAAA,EAE5D,aAAa,uBAAuB,SAAS;AAAA,EAC7C,aAAa,uBAAuB,QAAQ,QAAQ;AAAA,EACpD,aAAa,EAAE,QAAQ,EAAE,QAAQ,KAAK;AAAA,EACtC,YAAY,sBAAsB,QAAQ,OAAO;AACnD,CAAC,EACA,OAAO,CAAC,YAAY,QAAQ,gBAAgB,UAAa,QAAQ,gBAAgB,QAAW;AAAA,EAC3F,SAAS;AACX,CAAC;AAGI,IAAM,iCAAiC,EAAE,OAAO;AAAA,EACrD,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG;AAAA,EAC7B,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,IAAI;AAAA,EAChC,UAAU,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG;AAAA,EACnC,SAAS,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG,EAAE,SAAS;AAAA,EAC7C,YAAY,EAAE,KAAK,CAAC,YAAY,gBAAgB,QAAQ,CAAC;AAAA,EACzD,oBAAoB,EAAE,QAAQ;AAChC,CAAC;AAGM,IAAM,wCAAwC,EAAE,OAAO;AAAA,EAC5D,eAAe,EAAE,KAAK,CAAC,gBAAgB,aAAa,UAAU,CAAC;AAAA,EAC/D,oBAAoB,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG;AAAA,EAC7C,sBAAsB,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG,EAAE,SAAS;AAAA,EAC1D,oBAAoB,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG,EAAE,SAAS;AAAA,EACxD,cAAc,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG,EAAE,SAAS;AACpD,CAAC;AAKM,IAAM,mCAAmC,EAAE,OAAO;AAAA,EACvD,SAAS,EAAE,MAAM,8BAA8B,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG;AAAA,EAC/D,aAAa;AAAA,EACb,aAAa;AAAA,EACb,YAAY;AACd,CAAC;AAGM,IAAM,0CAA0C,EAAE;AAAA,EACvD;AAAA,EACA,EAAE,OAAO;AAAA,IACP,SAAS,2BAA2B,OAAO,CAAC,YAAY,QAAQ,SAAS,GAAG;AAAA,MAC1E,SAAS;AAAA,IACX,CAAC;AAAA,IACD,iBAAiB,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS;AAAA,IACtD,gBAAgB,EAAE,OAAO,EAAE,KAAK;AAAA,EAClC,CAAC;AACH;","names":[]}

package/dist/index.d.ts

@@ -3877,6 +3877,18 @@ export declare const DocumentSearchResult: z.ZodObject<{
     }>;
     authorityWorkspaceId: z.ZodNullable<z.ZodString>;
     authoritySubjectId: z.ZodNullable<z.ZodString>;
+    citation: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        provider: z.ZodLiteral<"google_drive">;
+        externalObjectId: z.ZodString;
+        providerRevision: z.ZodNullable<z.ZodString>;
+        sourceVersion: z.ZodString;
+        driveId: z.ZodNullable<z.ZodString>;
+        deepLink: z.ZodNullable<z.ZodPipe<z.ZodString, z.ZodString>>;
+        aclRevision: z.ZodString;
+        authorizationObservedAt: z.ZodString;
+        authorizationExpiresAt: z.ZodString;
+        reauthorizedAt: z.ZodString;
+    }, z.core.$strip>>>;
 }, z.core.$strip>;
 export type DocumentSearchResult = z.infer<typeof DocumentSearchResult>;
 export declare const DocumentSearchResponse: z.ZodObject<{
@@ -3923,6 +3935,18 @@ export declare const DocumentSearchResponse: z.ZodObject<{
         }>;
         authorityWorkspaceId: z.ZodNullable<z.ZodString>;
         authoritySubjectId: z.ZodNullable<z.ZodString>;
+        citation: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            provider: z.ZodLiteral<"google_drive">;
+            externalObjectId: z.ZodString;
+            providerRevision: z.ZodNullable<z.ZodString>;
+            sourceVersion: z.ZodString;
+            driveId: z.ZodNullable<z.ZodString>;
+            deepLink: z.ZodNullable<z.ZodPipe<z.ZodString, z.ZodString>>;
+            aclRevision: z.ZodString;
+            authorizationObservedAt: z.ZodString;
+            authorizationExpiresAt: z.ZodString;
+            reauthorizedAt: z.ZodString;
+        }, z.core.$strip>>>;
     }, z.core.$strip>>;
 }, z.core.$strip>;
 export type DocumentSearchResponse = z.infer<typeof DocumentSearchResponse>;
@@ -3959,6 +3983,18 @@ export declare const IndexedDocumentProvenance: z.ZodObject<{
     authoritySubjectId: z.ZodNullable<z.ZodString>;
     createdBy: z.ZodNullable<z.ZodString>;
     createdAt: z.ZodString;
+    citation: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        provider: z.ZodLiteral<"google_drive">;
+        externalObjectId: z.ZodString;
+        providerRevision: z.ZodNullable<z.ZodString>;
+        sourceVersion: z.ZodString;
+        driveId: z.ZodNullable<z.ZodString>;
+        deepLink: z.ZodNullable<z.ZodPipe<z.ZodString, z.ZodString>>;
+        aclRevision: z.ZodString;
+        authorizationObservedAt: z.ZodString;
+        authorizationExpiresAt: z.ZodString;
+        reauthorizedAt: z.ZodString;
+    }, z.core.$strip>>>;
 }, z.core.$strip>;
 export type IndexedDocumentProvenance = z.infer<typeof IndexedDocumentProvenance>;
 export declare const IndexedDocumentSummary: z.ZodObject<{
@@ -4001,6 +4037,18 @@ export declare const IndexedDocumentSummary: z.ZodObject<{
         authoritySubjectId: z.ZodNullable<z.ZodString>;
         createdBy: z.ZodNullable<z.ZodString>;
         createdAt: z.ZodString;
+        citation: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            provider: z.ZodLiteral<"google_drive">;
+            externalObjectId: z.ZodString;
+            providerRevision: z.ZodNullable<z.ZodString>;
+            sourceVersion: z.ZodString;
+            driveId: z.ZodNullable<z.ZodString>;
+            deepLink: z.ZodNullable<z.ZodPipe<z.ZodString, z.ZodString>>;
+            aclRevision: z.ZodString;
+            authorizationObservedAt: z.ZodString;
+            authorizationExpiresAt: z.ZodString;
+            reauthorizedAt: z.ZodString;
+        }, z.core.$strip>>>;
     }, z.core.$strip>;
 }, z.core.$strip>;
 export type IndexedDocumentSummary = z.infer<typeof IndexedDocumentSummary>;
@@ -4050,6 +4098,18 @@ export declare const ListIndexedDocumentsResponse: z.ZodObject<{
             authoritySubjectId: z.ZodNullable<z.ZodString>;
             createdBy: z.ZodNullable<z.ZodString>;
             createdAt: z.ZodString;
+            citation: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                provider: z.ZodLiteral<"google_drive">;
+                externalObjectId: z.ZodString;
+                providerRevision: z.ZodNullable<z.ZodString>;
+                sourceVersion: z.ZodString;
+                driveId: z.ZodNullable<z.ZodString>;
+                deepLink: z.ZodNullable<z.ZodPipe<z.ZodString, z.ZodString>>;
+                aclRevision: z.ZodString;
+                authorizationObservedAt: z.ZodString;
+                authorizationExpiresAt: z.ZodString;
+                reauthorizedAt: z.ZodString;
+            }, z.core.$strip>>>;
         }, z.core.$strip>;
     }, z.core.$strip>>;
     nextCheckpoint: z.ZodString;
@@ -5313,6 +5373,7 @@ export declare const SessionRealtimeInboundEntry: z.ZodObject<{
     delegationItemId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     text: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     payload: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    modelContext: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>;
 export type SessionRealtimeInboundEntry = z.infer<typeof SessionRealtimeInboundEntry>;
 export declare const SyncSessionRealtimeLedgerRequest: z.ZodObject<{
@@ -5338,6 +5399,7 @@ export declare const SyncSessionRealtimeLedgerRequest: z.ZodObject<{
         delegationItemId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         text: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         payload: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        modelContext: z.ZodOptional<z.ZodString>;
     }, z.core.$strict>>>;
     clientAckThroughSequence: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
     providerAckSequences: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
@@ -5923,6 +5985,17 @@ export declare const TimelineAnnotations: z.ZodArray<z.ZodObject<{
 export type TimelineAnnotations = z.infer<typeof TimelineAnnotations>;
 export declare function numberTimelineAnnotations(annotations: readonly SubmittedTimelineAnnotation[]): TimelineAnnotation[];
 export declare function renderTimelineAnnotationsForModel(text: string, annotations: readonly TimelineAnnotation[]): string;
+export declare const MODEL_CONTEXT_LABEL: "[Application context attached to this user message]";
+/**
+ * Build one canonical user-role message body. `modelContext` is ordinary
+ * message content: it is model-visible in the same chronological position as
+ * the visible text, but presentation layers may omit it. It is not a secret or
+ * an instruction-authority boundary.
+ */
+export declare function renderUserMessageContentForModel(text: string, annotations: readonly TimelineAnnotation[], modelContext?: string | null): string | Array<{
+    type: "input_text";
+    text: string;
+}>;
 export declare const SessionTurn: z.ZodObject<{
     id: z.ZodString;
     workspaceId: z.ZodString;
@@ -17782,7 +17855,7 @@ export declare const CreateSessionRequest: z.ZodPreprocess<z.ZodObject<{
     requestedSessionId: z.ZodOptional<z.ZodString>;
     initialMessage: z.ZodOptional<z.ZodString>;
     startMode: z.ZodOptional<z.ZodLiteral<"realtime">>;
-    turnInstructions: z.ZodOptional<z.ZodString>;
+    modelContext: z.ZodOptional<z.ZodString>;
     instructions: z.ZodOptional<z.ZodString>;
     policyRole: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>, z.ZodString>>;
     resources: z.ZodDefault<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -18293,7 +18366,7 @@ export declare const SessionUserMessagePayload: z.ZodObject<{
         quote: z.ZodString;
         note: z.ZodString;
     }, z.core.$strict>>>;
-    turnInstructions: z.ZodOptional<z.ZodString>;
+    modelContext: z.ZodOptional<z.ZodString>;
     resources: z.ZodDefault<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
         kind: z.ZodLiteral<"repository">;
         uri: z.ZodString;
@@ -18374,7 +18447,7 @@ export declare const ClientSessionEvent: z.ZodDiscriminatedUnion<[z.ZodObject<{
             quote: z.ZodString;
             note: z.ZodString;
         }, z.core.$strict>>>;
-        turnInstructions: z.ZodOptional<z.ZodString>;
+        modelContext: z.ZodOptional<z.ZodString>;
         resources: z.ZodDefault<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
             kind: z.ZodLiteral<"repository">;
             uri: z.ZodString;
@@ -18480,7 +18553,7 @@ export declare const SteerSessionMessageRequest: z.ZodObject<{
         quote: z.ZodString;
         note: z.ZodString;
     }, z.core.$strict>>>;
-    turnInstructions: z.ZodOptional<z.ZodString>;
+    modelContext: z.ZodOptional<z.ZodString>;
     resources: z.ZodDefault<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
         kind: z.ZodLiteral<"repository">;
         uri: z.ZodString;
@@ -20907,13 +20980,13 @@ export type WorkspaceModelCatalogResponse = z.infer<typeof WorkspaceModelCatalog
  * that rollout boundary. Mutating clients send this value in
  * `x-opengeni-api-contract`; the API rejects any other value before routing.
  */
-export declare const OPENGENI_API_CONTRACT_REVISION: "2026-08-social-provider-tools-v1";
+export declare const OPENGENI_API_CONTRACT_REVISION: "2026-08-model-context-v1";
 export declare const OPENGENI_API_CONTRACT_HEADER: "x-opengeni-api-contract";
 /** Bounded request/response identifier shared by browser, ingress, and API diagnostics. */
 export declare const OPENGENI_CORRELATION_HEADER: "x-opengeni-correlation-id";
 export declare const ClientConfig: z.ZodObject<{
     deploymentRevision: z.ZodString;
-    apiContractRevision: z.ZodLiteral<"2026-08-social-provider-tools-v1">;
+    apiContractRevision: z.ZodLiteral<"2026-08-model-context-v1">;
     serverVersion: z.ZodOptional<z.ZodString>;
     defaultModel: z.ZodString;
     allowedModels: z.ZodArray<z.ZodString>;

package/dist/index.js

@@ -554,6 +554,7 @@ import {
   KnowledgeMemoryKind,
   KnowledgeMemorySearchRequest,
   KnowledgeMemoryStatus,
+  KnowledgeProviderCitation,
   KnowledgeRecord,
   KnowledgeRecordId,
   KnowledgeRecordKind,
@@ -590,6 +591,7 @@ import {
   MCP_MUTATION_RECEIPT_MAX_BYTES,
   MCP_MUTATION_RECEIPT_VERSION,
   MODEL_ATTACHMENT_REFS_FIELD,
+  MODEL_CONTEXT_LABEL,
   MODEL_TIMELINE_ANNOTATIONS_FIELD,
   MachineKind,
   MachineMetricsSeriesResponse,
@@ -1276,6 +1278,7 @@ import {
   reasoningEffortForMetadata,
   renderSessionSystemUpdateBatch,
   renderTimelineAnnotationsForModel,
+  renderUserMessageContentForModel,
   replayCodexFleetDecisionV1,
   resolveSessionEventTypeFilters,
   resolveWorkspaceAgentHumanInputEnabled,
@@ -1314,7 +1317,7 @@ import {
   workspaceLearningPolicyRouterContext,
   workspaceLearningSourceKey,
   workspaceSlackReactionChannelAllowed
-} from "./chunk-Q6A7XT2N.js";
+} from "./chunk-NX5JNF4L.js";
 import {
   ConnectorDocumentDestination,
   ConnectorDocumentDestinationAuthority,
@@ -2158,6 +2161,7 @@ export {
   KnowledgeMemoryKind,
   KnowledgeMemorySearchRequest,
   KnowledgeMemoryStatus,
+  KnowledgeProviderCitation,
   KnowledgeRecord,
   KnowledgeRecordId,
   KnowledgeRecordKind,
@@ -2199,6 +2203,7 @@ export {
   MCP_MUTATION_RECEIPT_MAX_BYTES,
   MCP_MUTATION_RECEIPT_VERSION,
   MODEL_ATTACHMENT_REFS_FIELD,
+  MODEL_CONTEXT_LABEL,
   MODEL_TIMELINE_ANNOTATIONS_FIELD,
   MachineKind,
   MachineMetricsSeriesResponse,
@@ -3017,6 +3022,7 @@ export {
   reasoningEffortForMetadata,
   renderSessionSystemUpdateBatch,
   renderTimelineAnnotationsForModel,
+  renderUserMessageContentForModel,
   replayCodexFleetDecisionV1,
   resolveConnectorDocumentDestination,
   resolveRetainedOutputRange,