@fourier-labs/harbour-contracts 0.88.0 → 0.91.0

package/dist/gen-ts/integration-execute-result.d.ts

@@ -286,6 +286,55 @@ export type IntegrationExecuteResult = {
         [k: string]: string;
     };
     body?: unknown;
+    booksDocument?: {
+        id: string;
+        number: string;
+        status: string;
+        currency: string;
+        total: string;
+        vendorId?: string;
+        customerId?: string;
+        /**
+         * @maxItems 100
+         */
+        lineItems: {
+            itemId: string;
+            quantity: string;
+            rate: string;
+            total: string;
+            description?: string;
+        }[];
+    };
+    /**
+     * @maxItems 100
+     */
+    booksContacts?: {
+        id: string;
+        name: string;
+        type: string;
+    }[];
+    /**
+     * @maxItems 100
+     */
+    booksPurchaseOrders?: {
+        id: string;
+        number: string;
+        status: string;
+        currency: string;
+        total: string;
+        vendorId?: string;
+        customerId?: string;
+        /**
+         * @maxItems 100
+         */
+        lineItems: {
+            itemId: string;
+            quantity: string;
+            rate: string;
+            total: string;
+            description?: string;
+        }[];
+    }[];
 };
 /**
  * An event's state (0.86.0): confirmed (Google `confirmed`, Graph not cancelled and not tentative), tentative, or cancelled.

package/dist/gen-ts/integration-operations.d.ts

@@ -567,4 +567,60 @@ export declare const IntegrationOperations: {
         readonly declaredMode: false;
         readonly idempotencyKey: false;
     };
+    readonly "zohobooks.contact.list": {
+        readonly kind: "saas";
+        readonly identities: readonly ["user"];
+        readonly readOnly: true;
+        readonly declaredMode: false;
+        readonly idempotencyKey: false;
+    };
+    readonly "zohobooks.purchaseorder.list": {
+        readonly kind: "saas";
+        readonly identities: readonly ["user"];
+        readonly readOnly: true;
+        readonly declaredMode: false;
+        readonly idempotencyKey: false;
+    };
+    readonly "zohobooks.purchaseorder.read": {
+        readonly kind: "saas";
+        readonly identities: readonly ["user"];
+        readonly readOnly: true;
+        readonly declaredMode: false;
+        readonly idempotencyKey: false;
+    };
+    readonly "zohobooks.bill.create": {
+        readonly kind: "saas";
+        readonly identities: readonly ["user"];
+        readonly readOnly: false;
+        readonly declaredMode: false;
+        readonly idempotencyKey: true;
+    };
+    readonly "zohobooks.bill.read": {
+        readonly kind: "saas";
+        readonly identities: readonly ["user"];
+        readonly readOnly: true;
+        readonly declaredMode: false;
+        readonly idempotencyKey: false;
+    };
+    readonly "zohobooks.invoice.create": {
+        readonly kind: "saas";
+        readonly identities: readonly ["user"];
+        readonly readOnly: false;
+        readonly declaredMode: false;
+        readonly idempotencyKey: true;
+    };
+    readonly "zohobooks.invoice.read": {
+        readonly kind: "saas";
+        readonly identities: readonly ["user"];
+        readonly readOnly: true;
+        readonly declaredMode: false;
+        readonly idempotencyKey: false;
+    };
+    readonly "zohobooks.invoice.pdf": {
+        readonly kind: "saas";
+        readonly identities: readonly ["user"];
+        readonly readOnly: true;
+        readonly declaredMode: false;
+        readonly idempotencyKey: false;
+    };
 };

package/dist/gen-ts/integration-operations.js

@@ -734,5 +734,77 @@ export const IntegrationOperations = {
         "readOnly": false,
         "declaredMode": false,
         "idempotencyKey": false
+    },
+    "zohobooks.contact.list": {
+        "kind": "saas",
+        "identities": [
+            "user"
+        ],
+        "readOnly": true,
+        "declaredMode": false,
+        "idempotencyKey": false
+    },
+    "zohobooks.purchaseorder.list": {
+        "kind": "saas",
+        "identities": [
+            "user"
+        ],
+        "readOnly": true,
+        "declaredMode": false,
+        "idempotencyKey": false
+    },
+    "zohobooks.purchaseorder.read": {
+        "kind": "saas",
+        "identities": [
+            "user"
+        ],
+        "readOnly": true,
+        "declaredMode": false,
+        "idempotencyKey": false
+    },
+    "zohobooks.bill.create": {
+        "kind": "saas",
+        "identities": [
+            "user"
+        ],
+        "readOnly": false,
+        "declaredMode": false,
+        "idempotencyKey": true
+    },
+    "zohobooks.bill.read": {
+        "kind": "saas",
+        "identities": [
+            "user"
+        ],
+        "readOnly": true,
+        "declaredMode": false,
+        "idempotencyKey": false
+    },
+    "zohobooks.invoice.create": {
+        "kind": "saas",
+        "identities": [
+            "user"
+        ],
+        "readOnly": false,
+        "declaredMode": false,
+        "idempotencyKey": true
+    },
+    "zohobooks.invoice.read": {
+        "kind": "saas",
+        "identities": [
+            "user"
+        ],
+        "readOnly": true,
+        "declaredMode": false,
+        "idempotencyKey": false
+    },
+    "zohobooks.invoice.pdf": {
+        "kind": "saas",
+        "identities": [
+            "user"
+        ],
+        "readOnly": true,
+        "declaredMode": false,
+        "idempotencyKey": false
     }
 };

package/dist/gen-ts/resolved-app-serving.d.ts

@@ -19,6 +19,10 @@ export interface ResolvedAppServing {
      * The platform cell (LLD §3.7) whose routing store and template distribution serve this app.
      */
     cellId?: string;
+    /**
+     * How the tenant's cells run the app's server (ADR 0035): `kubernetes`, the cluster cell, or `serverless`, the gateway service with Lambda Web Functions, which serves kit apps only. One choice per tenant, the same in every environment; governance copies it from the tenant's deployment destination, and build and Provision branch on it. Absent means kubernetes.
+     */
+    hosting?: 'kubernetes' | 'serverless';
     /**
      * The cell's CloudFront KeyValueStore ARN; equals edge.routingStoreArn unless the cell record names its own.
      */

package/dist/gen-ts/saas-connection.d.ts

@@ -1,7 +1,7 @@
 /**
  * Slack carries an installation and a channel map; Gmail is user-consent only; Basecamp is user-consent only with an IT-pinned account and a project map in `channels`; SharePoint (0.78.0) is user-consent only, pinned to the company's Microsoft 365 tenant in `account`, with a site map in `channels`. Phone (0.82.0) is app mode only with no installation: the tenant's inbound SMS numbers (E.164) mapped from aliases in `channels`, and the SMS the platform received on them listed by phone.sms.list; since 0.83.0 an app reads the number an alias maps to with phone.number.get. Google Workspace (0.86.0, ADR 0032: calendar, drive, docs, sheets on the Google OAuth client) and Microsoft 365 (outlook, onedrive, excel, teams on the Microsoft client) are user-consent only like Gmail, one connection per provider with its own consent and scopes; the seven personal providers have no `account` and empty `channels` (their one fixed alias is the signed-in person's own calendar, drive, documents, spreadsheets, mailbox or workbooks); teams is pinned to the Microsoft 365 tenant in `account` like SharePoint and maps channel aliases in `channels`.
  */
-export type SaasProvider = 'slack' | 'gmail' | 'basecamp' | 'sharepoint' | 'phone' | 'calendar' | 'drive' | 'docs' | 'sheets' | 'outlook' | 'onedrive' | 'excel' | 'teams';
+export type SaasProvider = 'slack' | 'gmail' | 'basecamp' | 'sharepoint' | 'phone' | 'calendar' | 'drive' | 'docs' | 'sheets' | 'outlook' | 'onedrive' | 'excel' | 'teams' | 'zohobooks';
 /**
  * DISABLED stops every app call immediately (details.code CONNECTION_DISABLED).
  */
@@ -55,9 +55,21 @@ export interface SaasConnection {
      * Operations IT allows apps to request on this connection: the provider's own SaaS operations (Slack: slack.channel.history, slack.message.post, slack.message.update, slack.message.delete, slack.dm.send, slack.user.lookup; Gmail: gmail.thread.list, gmail.thread.read, gmail.message.read, gmail.message.send, gmail.attachment.read; Basecamp (0.76.0): basecamp.project.list, basecamp.todolist.list, basecamp.todo.list, basecamp.todo.create, basecamp.todo.complete, basecamp.message.list, basecamp.message.post, basecamp.comment.list, basecamp.comment.post, basecamp.campfire.post, basecamp.people.list; SharePoint (0.78.0): sharepoint.list.list, sharepoint.item.list, sharepoint.item.create, sharepoint.item.update, sharepoint.drive.list, sharepoint.file.list, sharepoint.file.search, sharepoint.file.read, sharepoint.file.upload; Google Workspace and Microsoft 365 (0.86.0): the calendar.*, drive.*, docs.*, sheets.*, outlook.*, onedrive.*, excel.* and teams.* operations of the connection's provider). Never warehouse.view.read. Phone (0.82.0): phone.sms.list; 0.83.0 adds phone.number.get. Seventy-eight SaaS operations in all since 0.86.0.
      *
      * @minItems 1
-     * @maxItems 78
+     * @maxItems 86
      */
-    operations: ('slack.channel.history' | 'slack.message.post' | 'slack.message.update' | 'slack.message.delete' | 'slack.dm.send' | 'slack.user.lookup' | 'gmail.thread.list' | 'gmail.thread.read' | 'gmail.message.read' | 'gmail.message.send' | 'gmail.attachment.read' | 'basecamp.project.list' | 'basecamp.todolist.list' | 'basecamp.todo.list' | 'basecamp.todo.create' | 'basecamp.todo.complete' | 'basecamp.message.list' | 'basecamp.message.post' | 'basecamp.comment.list' | 'basecamp.comment.post' | 'basecamp.campfire.post' | 'basecamp.people.list' | 'sharepoint.list.list' | 'sharepoint.item.list' | 'sharepoint.item.create' | 'sharepoint.item.update' | 'sharepoint.drive.list' | 'sharepoint.file.list' | 'sharepoint.file.search' | 'sharepoint.file.read' | 'sharepoint.file.upload' | 'phone.sms.list' | 'phone.number.get' | 'calendar.calendar.list' | 'calendar.event.list' | 'calendar.event.read' | 'calendar.event.create' | 'calendar.event.update' | 'calendar.event.cancel' | 'drive.file.list' | 'drive.file.search' | 'drive.file.read' | 'drive.file.upload' | 'drive.folder.create' | 'docs.document.read' | 'docs.document.create' | 'docs.document.append' | 'docs.text.replace' | 'sheets.spreadsheet.read' | 'sheets.values.read' | 'sheets.values.append' | 'sheets.values.update' | 'sheets.values.clear' | 'sheets.spreadsheet.create' | 'outlook.message.list' | 'outlook.message.read' | 'outlook.attachment.read' | 'outlook.message.send' | 'outlook.message.reply' | 'outlook.event.list' | 'outlook.event.read' | 'outlook.event.create' | 'outlook.event.update' | 'outlook.event.cancel' | 'onedrive.file.list' | 'onedrive.file.search' | 'onedrive.file.read' | 'onedrive.file.upload' | 'onedrive.folder.create' | 'excel.worksheet.list' | 'excel.range.read' | 'excel.range.update' | 'excel.table.list' | 'excel.row.add' | 'excel.worksheet.add' | 'teams.message.list' | 'teams.message.post' | 'teams.reply.post' | 'warehouse.view.read' | 'warehouse.table.append' | 'service.request')[];
+    operations: ('slack.channel.history' | 'slack.message.post' | 'slack.message.update' | 'slack.message.delete' | 'slack.dm.send' | 'slack.user.lookup' | 'gmail.thread.list' | 'gmail.thread.read' | 'gmail.message.read' | 'gmail.message.send' | 'gmail.attachment.read' | 'basecamp.project.list' | 'basecamp.todolist.list' | 'basecamp.todo.list' | 'basecamp.todo.create' | 'basecamp.todo.complete' | 'basecamp.message.list' | 'basecamp.message.post' | 'basecamp.comment.list' | 'basecamp.comment.post' | 'basecamp.campfire.post' | 'basecamp.people.list' | 'sharepoint.list.list' | 'sharepoint.item.list' | 'sharepoint.item.create' | 'sharepoint.item.update' | 'sharepoint.drive.list' | 'sharepoint.file.list' | 'sharepoint.file.search' | 'sharepoint.file.read' | 'sharepoint.file.upload' | 'phone.sms.list' | 'phone.number.get' | 'calendar.calendar.list' | 'calendar.event.list' | 'calendar.event.read' | 'calendar.event.create' | 'calendar.event.update' | 'calendar.event.cancel' | 'drive.file.list' | 'drive.file.search' | 'drive.file.read' | 'drive.file.upload' | 'drive.folder.create' | 'docs.document.read' | 'docs.document.create' | 'docs.document.append' | 'docs.text.replace' | 'sheets.spreadsheet.read' | 'sheets.values.read' | 'sheets.values.append' | 'sheets.values.update' | 'sheets.values.clear' | 'sheets.spreadsheet.create' | 'outlook.message.list' | 'outlook.message.read' | 'outlook.attachment.read' | 'outlook.message.send' | 'outlook.message.reply' | 'outlook.event.list' | 'outlook.event.read' | 'outlook.event.create' | 'outlook.event.update' | 'outlook.event.cancel' | 'onedrive.file.list' | 'onedrive.file.search' | 'onedrive.file.read' | 'onedrive.file.upload' | 'onedrive.folder.create' | 'excel.worksheet.list' | 'excel.range.read' | 'excel.range.update' | 'excel.table.list' | 'excel.row.add' | 'excel.worksheet.add' | 'teams.message.list' | 'teams.message.post' | 'teams.reply.post' | 'warehouse.view.read' | 'warehouse.table.append' | 'service.request' | 'zohobooks.contact.list' | 'zohobooks.purchaseorder.list' | 'zohobooks.purchaseorder.read' | 'zohobooks.bill.create' | 'zohobooks.bill.read' | 'zohobooks.invoice.create' | 'zohobooks.invoice.read' | 'zohobooks.invoice.pdf')[];
+    /**
+     * Explicit user-mode operations eligible for automatic app access, subject to the connection operation ceiling and personal consent. Empty means review all; absent inherits company defaults or the existing userModeApproval migration rule. Governance validates provider and mode compatibility. Background execution still requires personal background consent, not a separate admin grant.
+     *
+     * @maxItems 86
+     */
+    automaticUserOperations?: ('slack.channel.history' | 'slack.message.post' | 'slack.message.update' | 'slack.message.delete' | 'slack.dm.send' | 'slack.user.lookup' | 'gmail.thread.list' | 'gmail.thread.read' | 'gmail.message.read' | 'gmail.message.send' | 'gmail.attachment.read' | 'basecamp.project.list' | 'basecamp.todolist.list' | 'basecamp.todo.list' | 'basecamp.todo.create' | 'basecamp.todo.complete' | 'basecamp.message.list' | 'basecamp.message.post' | 'basecamp.comment.list' | 'basecamp.comment.post' | 'basecamp.campfire.post' | 'basecamp.people.list' | 'sharepoint.list.list' | 'sharepoint.item.list' | 'sharepoint.item.create' | 'sharepoint.item.update' | 'sharepoint.drive.list' | 'sharepoint.file.list' | 'sharepoint.file.search' | 'sharepoint.file.read' | 'sharepoint.file.upload' | 'phone.sms.list' | 'phone.number.get' | 'calendar.calendar.list' | 'calendar.event.list' | 'calendar.event.read' | 'calendar.event.create' | 'calendar.event.update' | 'calendar.event.cancel' | 'drive.file.list' | 'drive.file.search' | 'drive.file.read' | 'drive.file.upload' | 'drive.folder.create' | 'docs.document.read' | 'docs.document.create' | 'docs.document.append' | 'docs.text.replace' | 'sheets.spreadsheet.read' | 'sheets.values.read' | 'sheets.values.append' | 'sheets.values.update' | 'sheets.values.clear' | 'sheets.spreadsheet.create' | 'outlook.message.list' | 'outlook.message.read' | 'outlook.attachment.read' | 'outlook.message.send' | 'outlook.message.reply' | 'outlook.event.list' | 'outlook.event.read' | 'outlook.event.create' | 'outlook.event.update' | 'outlook.event.cancel' | 'onedrive.file.list' | 'onedrive.file.search' | 'onedrive.file.read' | 'onedrive.file.upload' | 'onedrive.folder.create' | 'excel.worksheet.list' | 'excel.range.read' | 'excel.range.update' | 'excel.table.list' | 'excel.row.add' | 'excel.worksheet.add' | 'teams.message.list' | 'teams.message.post' | 'teams.reply.post' | 'warehouse.view.read' | 'warehouse.table.append' | 'service.request' | 'zohobooks.contact.list' | 'zohobooks.purchaseorder.list' | 'zohobooks.purchaseorder.read' | 'zohobooks.bill.create' | 'zohobooks.bill.read' | 'zohobooks.invoice.create' | 'zohobooks.invoice.read' | 'zohobooks.invoice.pdf')[];
+    /**
+     * Reusable permissions for admitted builders on explicit shared SaaS resources. Governance checks registered resources, provider/mode compatibility and the connection operation ceiling. Connection version and audit record changes; no per-entry approval metadata.
+     *
+     * @maxItems 128
+     */
+    reusableAccess?: ReusableSaasAccess[];
     developmentPreapproval: DevelopmentPreapproval;
     oauthClient?: SaasOauthClient;
     userModeApproval?: UserModeApproval;
@@ -104,6 +116,10 @@ export interface SaasConnection {
     installations?: {
         [k: string]: LegacySaasInstallation;
     };
+    /**
+     * Zoho data center. Chosen by the connection administrator, never by an app call.
+     */
+    region?: 'us' | 'in' | 'eu' | 'au' | 'jp' | 'ca' | 'sa' | 'cn' | 'ae';
 }
 /**
  * The one bot installation of the platform-owned provider app in this tenant's workspace.
@@ -141,6 +157,21 @@ export interface BasecampAccount {
      */
     name: string;
 }
+export interface ReusableSaasAccess {
+    /**
+     * Tenant-wide logical alias of a connection (governance sourceId) or of a resource under it.
+     */
+    resource: string;
+    /**
+     * Whose authority an operation runs under. Fixed per operation, except the declared-mode Slack operations (slack.message.post; since 0.71.0 also slack.channel.history, slack.message.update, slack.message.delete): declared per app for the access request, and named per call among the app's approved modes (execute request `mode`, 0.55.0).
+     */
+    mode: 'app' | 'user';
+    /**
+     * @minItems 1
+     * @maxItems 86
+     */
+    operations: ('slack.channel.history' | 'slack.message.post' | 'slack.message.update' | 'slack.message.delete' | 'slack.dm.send' | 'slack.user.lookup' | 'gmail.thread.list' | 'gmail.thread.read' | 'gmail.message.read' | 'gmail.message.send' | 'gmail.attachment.read' | 'basecamp.project.list' | 'basecamp.todolist.list' | 'basecamp.todo.list' | 'basecamp.todo.create' | 'basecamp.todo.complete' | 'basecamp.message.list' | 'basecamp.message.post' | 'basecamp.comment.list' | 'basecamp.comment.post' | 'basecamp.campfire.post' | 'basecamp.people.list' | 'sharepoint.list.list' | 'sharepoint.item.list' | 'sharepoint.item.create' | 'sharepoint.item.update' | 'sharepoint.drive.list' | 'sharepoint.file.list' | 'sharepoint.file.search' | 'sharepoint.file.read' | 'sharepoint.file.upload' | 'phone.sms.list' | 'phone.number.get' | 'calendar.calendar.list' | 'calendar.event.list' | 'calendar.event.read' | 'calendar.event.create' | 'calendar.event.update' | 'calendar.event.cancel' | 'drive.file.list' | 'drive.file.search' | 'drive.file.read' | 'drive.file.upload' | 'drive.folder.create' | 'docs.document.read' | 'docs.document.create' | 'docs.document.append' | 'docs.text.replace' | 'sheets.spreadsheet.read' | 'sheets.values.read' | 'sheets.values.append' | 'sheets.values.update' | 'sheets.values.clear' | 'sheets.spreadsheet.create' | 'outlook.message.list' | 'outlook.message.read' | 'outlook.attachment.read' | 'outlook.message.send' | 'outlook.message.reply' | 'outlook.event.list' | 'outlook.event.read' | 'outlook.event.create' | 'outlook.event.update' | 'outlook.event.cancel' | 'onedrive.file.list' | 'onedrive.file.search' | 'onedrive.file.read' | 'onedrive.file.upload' | 'onedrive.folder.create' | 'excel.worksheet.list' | 'excel.range.read' | 'excel.range.update' | 'excel.table.list' | 'excel.row.add' | 'excel.worksheet.add' | 'teams.message.list' | 'teams.message.post' | 'teams.reply.post' | 'warehouse.view.read' | 'warehouse.table.append' | 'service.request' | 'zohobooks.contact.list' | 'zohobooks.purchaseorder.list' | 'zohobooks.purchaseorder.read' | 'zohobooks.bill.create' | 'zohobooks.bill.read' | 'zohobooks.invoice.create' | 'zohobooks.invoice.read' | 'zohobooks.invoice.pdf')[];
+}
 export interface DevelopmentPreapproval {
     /**
      * Auto-approve development requests within the allowlist.

package/gen-ts/app-integrations-declaration.ts

@@ -86,6 +86,14 @@ export type DeclaredConnection = {
     'warehouse.view.read'?: AppModeViewOperation;
     'warehouse.table.append'?: AppModeViewOperation;
     'service.request'?: ServiceOperation;
+    'zohobooks.contact.list'?: UserModeChannelOperation;
+    'zohobooks.purchaseorder.list'?: UserModeChannelOperation;
+    'zohobooks.purchaseorder.read'?: UserModeChannelOperation;
+    'zohobooks.bill.create'?: UserModeChannelOperation;
+    'zohobooks.bill.read'?: UserModeChannelOperation;
+    'zohobooks.invoice.create'?: UserModeChannelOperation;
+    'zohobooks.invoice.read'?: UserModeChannelOperation;
+    'zohobooks.invoice.pdf'?: UserModeChannelOperation;
   };
 };
 export type IntegrationConnectionKind = 'saas' | 'database' | 'service';

package/gen-ts/contract-release.ts

@@ -1,10 +1,10 @@
 /* eslint-disable */
 // Code generated by tools/gen/gen.mjs from schema/*.json. DO NOT EDIT.
 
-export const ContractRepositoryVersion = "0.88.0.0" as const;
-export const ContractPublishVersion = "0.88.0" as const;
-export const ContractPublishTag = "v0.88.0" as const;
-export const ContractSchemasDigest = "sha256:23e1cb0d9f92c4ea5c2b827aeab9266dfee0ed503457ba5bdc101c39212e8c6f" as const;
+export const ContractRepositoryVersion = "0.91.0.0" as const;
+export const ContractPublishVersion = "0.91.0" as const;
+export const ContractPublishTag = "v0.91.0" as const;
+export const ContractSchemasDigest = "sha256:b6ef945b91544184715900ca739d16f3ad8a40d5307a3b04d71cf7ac39c4fb39" as const;
 export const ContractAiFixturesDigest = "sha256:edac31c92e146ca1c40130f2fb5649db82e24b8cd1ac758153b90612052fddb6" as const;
-export const ContractGeneratedGoDigest = "sha256:05eef493dc05e9f7ef4fbbf0aa4dbba5743ceb12a9baded16c875c33e9ed50bb" as const;
-export const ContractGeneratedTypeScriptDigest = "sha256:20e6bfe9e9c7689331b42ea841f6bcc6b0450fb0accc81b451ffba2f1ec2befb" as const;
+export const ContractGeneratedGoDigest = "sha256:7dc23154d2d8cc3a50733c32bc005d71afa877ab327d89a3c3a7dc8dbec7dc5b" as const;
+export const ContractGeneratedTypeScriptDigest = "sha256:ae301b3932627690ffc23da6368dac812e5e33968dbe65fed52716c4896cbfcb" as const;

package/gen-ts/data-grant-v2.ts

@@ -35,7 +35,7 @@ export interface DataGrantV2 {
   /**
    * Approved operations; each must match this grant's mode. Empty until the first approval. At most the seventy-eight SaaS operations (0.86.0: eleven Slack and Gmail, eleven Basecamp, nine SharePoint, two phone, forty-five Google Workspace and Microsoft 365); a database grant holds up to two (warehouse.view.read, warehouse.table.append).
    *
-   * @maxItems 78
+   * @maxItems 86
    */
   operations: (
     | 'slack.channel.history'
@@ -119,6 +119,14 @@ export interface DataGrantV2 {
     | 'warehouse.view.read'
     | 'warehouse.table.append'
     | 'service.request'
+    | 'zohobooks.contact.list'
+    | 'zohobooks.purchaseorder.list'
+    | 'zohobooks.purchaseorder.read'
+    | 'zohobooks.bill.create'
+    | 'zohobooks.bill.read'
+    | 'zohobooks.invoice.create'
+    | 'zohobooks.invoice.read'
+    | 'zohobooks.invoice.pdf'
   )[];
   /**
    * Approved logical resources. Never inherited by wildcard. Empty until the first approval.
@@ -126,6 +134,7 @@ export interface DataGrantV2 {
    * @maxItems 64
    */
   resources: IntegrationResource[];
+  reviewedScope?: ReviewedIntegrationScope;
   /**
    * Absent only for explicitly approved ongoing production access.
    */
@@ -183,6 +192,109 @@ export interface IntegrationResource {
    */
   columns?: string[];
 }
+/**
+ * Only for SaaS grants mixing reviewed and automatic access: the previously human-reviewed scope. The remaining scope must satisfy current automatic rules. Homogeneous grants continue using approvedBy alone. Governance validates this is a subset of the grant; database behaviour is unchanged.
+ */
+export interface ReviewedIntegrationScope {
+  /**
+   * @maxItems 86
+   */
+  operations: (
+    | 'slack.channel.history'
+    | 'slack.message.post'
+    | 'slack.message.update'
+    | 'slack.message.delete'
+    | 'slack.dm.send'
+    | 'slack.user.lookup'
+    | 'gmail.thread.list'
+    | 'gmail.thread.read'
+    | 'gmail.message.read'
+    | 'gmail.message.send'
+    | 'gmail.attachment.read'
+    | 'basecamp.project.list'
+    | 'basecamp.todolist.list'
+    | 'basecamp.todo.list'
+    | 'basecamp.todo.create'
+    | 'basecamp.todo.complete'
+    | 'basecamp.message.list'
+    | 'basecamp.message.post'
+    | 'basecamp.comment.list'
+    | 'basecamp.comment.post'
+    | 'basecamp.campfire.post'
+    | 'basecamp.people.list'
+    | 'sharepoint.list.list'
+    | 'sharepoint.item.list'
+    | 'sharepoint.item.create'
+    | 'sharepoint.item.update'
+    | 'sharepoint.drive.list'
+    | 'sharepoint.file.list'
+    | 'sharepoint.file.search'
+    | 'sharepoint.file.read'
+    | 'sharepoint.file.upload'
+    | 'phone.sms.list'
+    | 'phone.number.get'
+    | 'calendar.calendar.list'
+    | 'calendar.event.list'
+    | 'calendar.event.read'
+    | 'calendar.event.create'
+    | 'calendar.event.update'
+    | 'calendar.event.cancel'
+    | 'drive.file.list'
+    | 'drive.file.search'
+    | 'drive.file.read'
+    | 'drive.file.upload'
+    | 'drive.folder.create'
+    | 'docs.document.read'
+    | 'docs.document.create'
+    | 'docs.document.append'
+    | 'docs.text.replace'
+    | 'sheets.spreadsheet.read'
+    | 'sheets.values.read'
+    | 'sheets.values.append'
+    | 'sheets.values.update'
+    | 'sheets.values.clear'
+    | 'sheets.spreadsheet.create'
+    | 'outlook.message.list'
+    | 'outlook.message.read'
+    | 'outlook.attachment.read'
+    | 'outlook.message.send'
+    | 'outlook.message.reply'
+    | 'outlook.event.list'
+    | 'outlook.event.read'
+    | 'outlook.event.create'
+    | 'outlook.event.update'
+    | 'outlook.event.cancel'
+    | 'onedrive.file.list'
+    | 'onedrive.file.search'
+    | 'onedrive.file.read'
+    | 'onedrive.file.upload'
+    | 'onedrive.folder.create'
+    | 'excel.worksheet.list'
+    | 'excel.range.read'
+    | 'excel.range.update'
+    | 'excel.table.list'
+    | 'excel.row.add'
+    | 'excel.worksheet.add'
+    | 'teams.message.list'
+    | 'teams.message.post'
+    | 'teams.reply.post'
+    | 'warehouse.view.read'
+    | 'warehouse.table.append'
+    | 'service.request'
+    | 'zohobooks.contact.list'
+    | 'zohobooks.purchaseorder.list'
+    | 'zohobooks.purchaseorder.read'
+    | 'zohobooks.bill.create'
+    | 'zohobooks.bill.read'
+    | 'zohobooks.invoice.create'
+    | 'zohobooks.invoice.read'
+    | 'zohobooks.invoice.pdf'
+  )[];
+  /**
+   * @maxItems 64
+   */
+  resources: IntegrationResource[];
+}
 /**
  * App-mode Slack grants only: how the app's posts are presented, as IT approved it. Absent means the posts carry the bot's own name.
  */

package/gen-ts/integration-execute-input-rules.ts

@@ -697,6 +697,76 @@ export const IntegrationExecuteInputRules = {
       body: { kind: "object", required: false },
     },
   },
+  "zohobooks.contact.list": {
+    idempotencyKey: false,
+    fields: {
+      q: { kind: "string", required: false, minLength: 1, maxLength: 256 },
+      pageToken: { kind: "string", required: false, minLength: 1, maxLength: 2048 },
+    },
+  },
+  "zohobooks.purchaseorder.list": {
+    idempotencyKey: false,
+    fields: {
+      vendorId: { kind: "string", required: true, minLength: 0, maxLength: 32, pattern: "^[0-9]{1,32}$" },
+      pageToken: { kind: "string", required: false, minLength: 1, maxLength: 2048 },
+    },
+  },
+  "zohobooks.purchaseorder.read": {
+    idempotencyKey: false,
+    fields: {
+      purchaseOrderId: { kind: "string", required: true, minLength: 0, maxLength: 32, pattern: "^[0-9]{1,32}$" },
+    },
+  },
+  "zohobooks.bill.create": {
+    idempotencyKey: true,
+    fields: {
+      vendorId: { kind: "string", required: true, minLength: 0, maxLength: 32, pattern: "^[0-9]{1,32}$" },
+      documentNumber: { kind: "string", required: true, minLength: 1, maxLength: 100 },
+      documentDate: { kind: "string", required: true, minLength: 0, maxLength: 10, pattern: "^[0-9]{4}-[0-9]{2}-[0-9]{2}$" },
+      purchaseOrderId: { kind: "string", required: false, minLength: 0, maxLength: 32, pattern: "^[0-9]{1,32}$" },
+      lineItems: { kind: "object[]", required: true, minItems: 1, maxItems: 100, fields: {
+        itemId: { kind: "string", required: true, minLength: 0, maxLength: 32, pattern: "^[0-9]{1,32}$" },
+        quantity: { kind: "string", required: true, minLength: 0, maxLength: 17, pattern: "^[0-9]{1,10}(\\.[0-9]{1,6})?$" },
+        rate: { kind: "string", required: true, minLength: 0, maxLength: 17, pattern: "^[0-9]{1,10}(\\.[0-9]{1,6})?$" },
+        taxId: { kind: "string", required: false, minLength: 0, maxLength: 32, pattern: "^[0-9]{1,32}$" },
+        description: { kind: "string", required: false, minLength: 0, maxLength: 2000 },
+      } },
+    },
+  },
+  "zohobooks.bill.read": {
+    idempotencyKey: false,
+    fields: {
+      documentId: { kind: "string", required: true, minLength: 0, maxLength: 32, pattern: "^[0-9]{1,32}$" },
+    },
+  },
+  "zohobooks.invoice.create": {
+    idempotencyKey: true,
+    fields: {
+      customerId: { kind: "string", required: true, minLength: 0, maxLength: 32, pattern: "^[0-9]{1,32}$" },
+      documentNumber: { kind: "string", required: false, minLength: 1, maxLength: 100 },
+      documentDate: { kind: "string", required: true, minLength: 0, maxLength: 10, pattern: "^[0-9]{4}-[0-9]{2}-[0-9]{2}$" },
+      referenceNumber: { kind: "string", required: false, minLength: 1, maxLength: 100 },
+      lineItems: { kind: "object[]", required: true, minItems: 1, maxItems: 100, fields: {
+        itemId: { kind: "string", required: true, minLength: 0, maxLength: 32, pattern: "^[0-9]{1,32}$" },
+        quantity: { kind: "string", required: true, minLength: 0, maxLength: 17, pattern: "^[0-9]{1,10}(\\.[0-9]{1,6})?$" },
+        rate: { kind: "string", required: true, minLength: 0, maxLength: 17, pattern: "^[0-9]{1,10}(\\.[0-9]{1,6})?$" },
+        taxId: { kind: "string", required: false, minLength: 0, maxLength: 32, pattern: "^[0-9]{1,32}$" },
+        description: { kind: "string", required: false, minLength: 0, maxLength: 2000 },
+      } },
+    },
+  },
+  "zohobooks.invoice.read": {
+    idempotencyKey: false,
+    fields: {
+      documentId: { kind: "string", required: true, minLength: 0, maxLength: 32, pattern: "^[0-9]{1,32}$" },
+    },
+  },
+  "zohobooks.invoice.pdf": {
+    idempotencyKey: false,
+    fields: {
+      documentId: { kind: "string", required: true, minLength: 0, maxLength: 32, pattern: "^[0-9]{1,32}$" },
+    },
+  },
 } as const satisfies Record<string, IntegrationExecuteOperationRule>;
 
 export type IntegrationExecuteOperation = keyof typeof IntegrationExecuteInputRules;

package/gen-ts/integration-execute-request.ts

@@ -93,7 +93,15 @@ export type IntegrationExecuteRequest = {
     | 'teams.reply.post'
     | 'warehouse.view.read'
     | 'warehouse.table.append'
-    | 'service.request';
+    | 'service.request'
+    | 'zohobooks.contact.list'
+    | 'zohobooks.purchaseorder.list'
+    | 'zohobooks.purchaseorder.read'
+    | 'zohobooks.bill.create'
+    | 'zohobooks.bill.read'
+    | 'zohobooks.invoice.create'
+    | 'zohobooks.invoice.read'
+    | 'zohobooks.invoice.pdf';
   /**
    * Tenant-wide logical alias of a connection (governance sourceId) or of a resource under it.
    */
@@ -383,7 +391,7 @@ export type IntegrationExecuteRequest = {
      */
     allDay?: boolean;
     /**
-     * docs.document.read / docs.document.append / docs.text.replace (0.86.0): the Google Docs document id (the `/document/d/<id>` path segment, or a docs.document.create result's id).
+     * Google Docs document id or Zoho Books document id; each operation restricts its provider format.
      */
     documentId?: string;
     /**
@@ -443,6 +451,23 @@ export type IntegrationExecuteRequest = {
      * @maxItems 20
      */
     sheets?: string[];
+    vendorId?: string;
+    customerId?: string;
+    purchaseOrderId?: string;
+    documentNumber?: string;
+    documentDate?: string;
+    referenceNumber?: string;
+    /**
+     * @minItems 1
+     * @maxItems 100
+     */
+    lineItems?: {
+      itemId: string;
+      quantity: string;
+      rate: string;
+      taxId?: string;
+      description?: string;
+    }[];
   };
   /**
    * UUID of one explicit Send action; required for the sends (slack.message.post, slack.dm.send, gmail.message.send), the receipted Basecamp writes (basecamp.todo.create, basecamp.message.post, basecamp.comment.post, basecamp.campfire.post; 0.76.0) the receipted SharePoint writes (sharepoint.item.create, sharepoint.file.upload; 0.78.0) the receipted warehouse append (warehouse.table.append; 0.82.0, where it is also the BigQuery load job id) and the receipted Google Workspace and Microsoft 365 writes (0.86.0: calendar.event.create, drive.file.upload, drive.folder.create, docs.document.create, sheets.values.append, sheets.spreadsheet.create, outlook.message.send, outlook.message.reply, outlook.event.create, onedrive.file.upload, onedrive.folder.create, excel.row.add, excel.worksheet.add, teams.message.post, teams.reply.post), refused everywhere else. The same key with the same payload and subject returns the recorded outcome for seven days.

package/gen-ts/integration-execute-result.ts

@@ -289,6 +289,55 @@ export type IntegrationExecuteResult = {
     [k: string]: string;
   };
   body?: unknown;
+  booksDocument?: {
+    id: string;
+    number: string;
+    status: string;
+    currency: string;
+    total: string;
+    vendorId?: string;
+    customerId?: string;
+    /**
+     * @maxItems 100
+     */
+    lineItems: {
+      itemId: string;
+      quantity: string;
+      rate: string;
+      total: string;
+      description?: string;
+    }[];
+  };
+  /**
+   * @maxItems 100
+   */
+  booksContacts?: {
+    id: string;
+    name: string;
+    type: string;
+  }[];
+  /**
+   * @maxItems 100
+   */
+  booksPurchaseOrders?: {
+    id: string;
+    number: string;
+    status: string;
+    currency: string;
+    total: string;
+    vendorId?: string;
+    customerId?: string;
+    /**
+     * @maxItems 100
+     */
+    lineItems: {
+      itemId: string;
+      quantity: string;
+      rate: string;
+      total: string;
+      description?: string;
+    }[];
+  }[];
 };
 /**
  * An event's state (0.86.0): confirmed (Google `confirmed`, Graph not cancelled and not tentative), tentative, or cancelled.