@isomorph.ai/app-sdk 1.18.0 → 1.20.0

package/dist/index.d.ts

@@ -176,14 +176,14 @@ export interface WarehouseViewReadRequest {
 export type WarehouseAppendRow = Record<string, string | number | boolean | null>;
 /**
  * Land rows in the warehouse. The resource is an alias IT approved with access `append` (an alias reads or
- * appends, never both). Up to 500 rows per call; a larger report is several calls, each with its own fresh key.
+ * appends, never both). Up to 5000 rows per call; a larger report is several calls, each with its own fresh key.
  * On a lane without a warehouse binding the rows are validated and answered as a dry run; nothing is written.
  */
 export interface WarehouseTableAppendRequest {
     operation: 'warehouse.table.append';
     resource: string;
     input: {
-        /** 1 to 500 rows. */
+        /** 1 to 5000 rows. */
         rows: WarehouseAppendRow[];
     };
     /** A fresh UUID per append, reused only to retry that same append. */
@@ -204,6 +204,17 @@ export interface PhoneSmsListRequest {
         from?: string;
     };
 }
+/**
+ * The number a phone alias maps to (contracts 0.83.0, ADR 0029). The resource is a number alias of a `phone`
+ * connection, declared like `phone.sms.list`'s; the answer is the E.164 number IT mapped it to, so the app (or an
+ * agent it drives) can type it into a portal that signs in by mobile number. It takes no input: leave `input`
+ * out and the client sends `input: {}`, which the platform requires on the wire.
+ */
+export interface PhoneNumberGetRequest {
+    operation: 'phone.number.get';
+    resource: string;
+    input?: Record<string, never>;
+}
 /** Gmail runs as the signed-in person after their consent. Resources are approved mailbox aliases (`inbox`). */
 export interface GmailThreadListRequest {
     operation: 'gmail.thread.list';
@@ -529,7 +540,7 @@ export interface ServiceRequestResult {
     headers: Record<string, string>;
     body: unknown;
 }
-export type IntegrationRequest = ServiceRequest | SlackChannelHistoryRequest | SlackMessagePostRequest | SlackMessageUpdateRequest | SlackMessageDeleteRequest | SlackDmSendRequest | SlackUserLookupRequest | WarehouseViewReadRequest | WarehouseTableAppendRequest | PhoneSmsListRequest | GmailThreadListRequest | GmailThreadReadRequest | GmailMessageReadRequest | GmailAttachmentReadRequest | GmailMessageSendRequest | BasecampProjectListRequest | BasecampTodolistListRequest | BasecampTodoListRequest | BasecampTodoCreateRequest | BasecampTodoCompleteRequest | BasecampMessageListRequest | BasecampMessagePostRequest | BasecampCommentListRequest | BasecampCommentPostRequest | BasecampCampfirePostRequest | BasecampPeopleListRequest | SharePointListListRequest | SharePointItemListRequest | SharePointItemCreateRequest | SharePointItemUpdateRequest | SharePointDriveListRequest | SharePointFileListRequest | SharePointFileSearchRequest | SharePointFileReadRequest | SharePointFileUploadRequest;
+export type IntegrationRequest = ServiceRequest | SlackChannelHistoryRequest | SlackMessagePostRequest | SlackMessageUpdateRequest | SlackMessageDeleteRequest | SlackDmSendRequest | SlackUserLookupRequest | WarehouseViewReadRequest | WarehouseTableAppendRequest | PhoneSmsListRequest | PhoneNumberGetRequest | GmailThreadListRequest | GmailThreadReadRequest | GmailMessageReadRequest | GmailAttachmentReadRequest | GmailMessageSendRequest | BasecampProjectListRequest | BasecampTodolistListRequest | BasecampTodoListRequest | BasecampTodoCreateRequest | BasecampTodoCompleteRequest | BasecampMessageListRequest | BasecampMessagePostRequest | BasecampCommentListRequest | BasecampCommentPostRequest | BasecampCampfirePostRequest | BasecampPeopleListRequest | SharePointListListRequest | SharePointItemListRequest | SharePointItemCreateRequest | SharePointItemUpdateRequest | SharePointDriveListRequest | SharePointFileListRequest | SharePointFileSearchRequest | SharePointFileReadRequest | SharePointFileUploadRequest;
 export type IntegrationOperation = IntegrationRequest['operation'];
 export interface SlackMessage {
     id: string;
@@ -583,6 +594,10 @@ export interface PhoneSmsMessage {
 export interface PhoneSmsListResult {
     messages: PhoneSmsMessage[];
 }
+export interface PhoneNumberGetResult {
+    /** The E.164 number the alias maps to, e.g. `+919876543210`. */
+    number: string;
+}
 export interface GmailThreadSummary {
     id: string;
     messageId: string;
@@ -802,7 +817,7 @@ export interface SharePointFileUploadResult {
     filename: string;
     webUrl: string;
 }
-export type IntegrationResult<R extends IntegrationRequest> = R extends ServiceRequest ? ServiceRequestResult : R extends SlackChannelHistoryRequest ? SlackChannelHistoryResult : R extends SlackMessagePostRequest | SlackMessageUpdateRequest | SlackMessageDeleteRequest ? SlackMessagePostResult : R extends SlackDmSendRequest ? SlackDmSendResult : R extends SlackUserLookupRequest ? SlackUserLookupResult : R extends WarehouseViewReadRequest ? WarehouseViewReadResult : R extends WarehouseTableAppendRequest ? WarehouseTableAppendResult : R extends PhoneSmsListRequest ? PhoneSmsListResult : R extends GmailThreadListRequest ? GmailThreadListResult : R extends GmailThreadReadRequest ? GmailThreadReadResult : R extends GmailMessageReadRequest ? GmailMessageReadResult : R extends GmailAttachmentReadRequest ? GmailAttachmentReadResult : R extends GmailMessageSendRequest ? GmailMessageSendResult : R extends BasecampProjectListRequest ? BasecampProjectListResult : R extends BasecampTodolistListRequest ? BasecampTodolistListResult : R extends BasecampTodoListRequest ? BasecampTodoListResult : R extends BasecampMessageListRequest ? BasecampMessageListResult : R extends BasecampCommentListRequest ? BasecampCommentListResult : R extends BasecampPeopleListRequest ? BasecampPeopleListResult : R extends BasecampTodoCreateRequest | BasecampMessagePostRequest | BasecampCommentPostRequest | BasecampCampfirePostRequest ? BasecampRecordingResult : R extends BasecampTodoCompleteRequest ? BasecampTodoCompleteResult : R extends SharePointListListRequest ? SharePointListListResult : R extends SharePointItemListRequest ? SharePointItemListResult : R extends SharePointItemCreateRequest ? SharePointItemCreateResult : R extends SharePointItemUpdateRequest ? SharePointItemUpdateResult : R extends SharePointDriveListRequest ? SharePointDriveListResult : R extends SharePointFileListRequest | SharePointFileSearchRequest ? SharePointFileListResult : R extends SharePointFileReadRequest ? SharePointFileReadResult : R extends SharePointFileUploadRequest ? SharePointFileUploadResult : never;
+export type IntegrationResult<R extends IntegrationRequest> = R extends ServiceRequest ? ServiceRequestResult : R extends SlackChannelHistoryRequest ? SlackChannelHistoryResult : R extends SlackMessagePostRequest | SlackMessageUpdateRequest | SlackMessageDeleteRequest ? SlackMessagePostResult : R extends SlackDmSendRequest ? SlackDmSendResult : R extends SlackUserLookupRequest ? SlackUserLookupResult : R extends WarehouseViewReadRequest ? WarehouseViewReadResult : R extends WarehouseTableAppendRequest ? WarehouseTableAppendResult : R extends PhoneSmsListRequest ? PhoneSmsListResult : R extends PhoneNumberGetRequest ? PhoneNumberGetResult : R extends GmailThreadListRequest ? GmailThreadListResult : R extends GmailThreadReadRequest ? GmailThreadReadResult : R extends GmailMessageReadRequest ? GmailMessageReadResult : R extends GmailAttachmentReadRequest ? GmailAttachmentReadResult : R extends GmailMessageSendRequest ? GmailMessageSendResult : R extends BasecampProjectListRequest ? BasecampProjectListResult : R extends BasecampTodolistListRequest ? BasecampTodolistListResult : R extends BasecampTodoListRequest ? BasecampTodoListResult : R extends BasecampMessageListRequest ? BasecampMessageListResult : R extends BasecampCommentListRequest ? BasecampCommentListResult : R extends BasecampPeopleListRequest ? BasecampPeopleListResult : R extends BasecampTodoCreateRequest | BasecampMessagePostRequest | BasecampCommentPostRequest | BasecampCampfirePostRequest ? BasecampRecordingResult : R extends BasecampTodoCompleteRequest ? BasecampTodoCompleteResult : R extends SharePointListListRequest ? SharePointListListResult : R extends SharePointItemListRequest ? SharePointItemListResult : R extends SharePointItemCreateRequest ? SharePointItemCreateResult : R extends SharePointItemUpdateRequest ? SharePointItemUpdateResult : R extends SharePointDriveListRequest ? SharePointDriveListResult : R extends SharePointFileListRequest | SharePointFileSearchRequest ? SharePointFileListResult : R extends SharePointFileReadRequest ? SharePointFileReadResult : R extends SharePointFileUploadRequest ? SharePointFileUploadResult : never;
 export type IntegrationConnectResult = {
     status: 'connected';
     accountLabel: string;

package/dist/index.js

@@ -31,15 +31,15 @@ function warehouseReadProblem({ columns, aggregates }) {
     return undefined;
 }
 const UUID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
-// The append rules governance states in prose: 1 to 500 rows per call (a
+// The append rules governance states in prose: 1 to 5000 rows per call (a
 // larger report is several calls) and a UUID idempotency key per call.
 // Governance checks the columns and the value types against the catalog.
 function warehouseAppendProblem({ input, idempotencyKey }) {
     const rows = input?.rows;
     if (!Array.isArray(rows) || rows.length === 0)
-        return { field: 'rows', message: 'a warehouse append needs 1 to 500 rows' };
-    if (rows.length > 500)
-        return { field: 'rows', message: 'a warehouse append takes at most 500 rows per call; send a larger report as several calls, each with its own idempotencyKey' };
+        return { field: 'rows', message: 'a warehouse append needs 1 to 5000 rows' };
+    if (rows.length > 5000)
+        return { field: 'rows', message: 'a warehouse append takes at most 5000 rows per call; send a larger report as several calls, each with its own idempotencyKey' };
     if (typeof idempotencyKey !== 'string' || !UUID_PATTERN.test(idempotencyKey))
         return { field: 'idempotencyKey', message: 'a warehouse append needs a fresh UUID idempotencyKey per call' };
     return undefined;
@@ -773,7 +773,10 @@ export function createClient(options = {}) {
                 }
                 // Exactly the contract's fields go on the wire: metadata declares which
                 // operations accept `mode`; identity and stray fields are not sent.
-                const { operation, resource, input, idempotencyKey, mode } = request;
+                // phone.number.get takes no input, but the contract keeps `input`
+                // required on the wire (ADR 0029), so an omitted one goes out as {}.
+                const { operation, resource, input: given, idempotencyKey, mode } = request;
+                const input = given === undefined && operation === 'phone.number.get' ? {} : given;
                 return transport.json('/_harbour/integrations/execute', {
                     method: 'POST', body: JSON.stringify({ connection, operation, ...(operation !== 'service.request' ? { resource } : {}), ...(input !== undefined ? { input } : {}), ...(idempotencyKey !== undefined ? { idempotencyKey } : {}), ...(IntegrationOperations[operation]?.declaredMode && mode !== undefined ? { mode } : {}) }),
                 });

package/dist/integration-execute-input-rules.d.ts

@@ -797,6 +797,10 @@ export declare const IntegrationExecuteInputRules: {
             };
         };
     };
+    readonly "phone.number.get": {
+        readonly idempotencyKey: false;
+        readonly fields: {};
+    };
     readonly "warehouse.view.read": {
         readonly idempotencyKey: false;
         readonly fields: {
@@ -913,7 +917,7 @@ export declare const IntegrationExecuteInputRules: {
                 readonly kind: "record[]";
                 readonly required: true;
                 readonly minItems: 1;
-                readonly maxItems: 500;
+                readonly maxItems: 5000;
                 readonly minProperties: 1;
                 readonly maxProperties: 64;
                 readonly types: readonly ["string", "number", "boolean", "null"];

package/dist/integration-execute-input-rules.js

@@ -248,6 +248,10 @@ export const IntegrationExecuteInputRules = {
             from: { kind: "string", required: false, minLength: 0, maxLength: 32 },
         },
     },
+    "phone.number.get": {
+        idempotencyKey: false,
+        fields: {},
+    },
     "warehouse.view.read": {
         idempotencyKey: false,
         fields: {
@@ -273,7 +277,7 @@ export const IntegrationExecuteInputRules = {
     "warehouse.table.append": {
         idempotencyKey: true,
         fields: {
-            rows: { kind: "record[]", required: true, minItems: 1, maxItems: 500, minProperties: 1, maxProperties: 64, types: ["string", "number", "boolean", "null"], maxLength: 4000 },
+            rows: { kind: "record[]", required: true, minItems: 1, maxItems: 5000, minProperties: 1, maxProperties: 64, types: ["string", "number", "boolean", "null"], maxLength: 4000 },
         },
     },
     "service.request": {

package/dist/integration-operations.d.ts

@@ -224,6 +224,13 @@ export declare const IntegrationOperations: {
         readonly declaredMode: false;
         readonly idempotencyKey: false;
     };
+    readonly "phone.number.get": {
+        readonly kind: "saas";
+        readonly identities: readonly ["app"];
+        readonly readOnly: true;
+        readonly declaredMode: false;
+        readonly idempotencyKey: false;
+    };
     readonly "warehouse.view.read": {
         readonly kind: "database";
         readonly identities: readonly ["app"];

package/dist/integration-operations.js

@@ -294,6 +294,15 @@ export const IntegrationOperations = {
         "declaredMode": false,
         "idempotencyKey": false
     },
+    "phone.number.get": {
+        "kind": "saas",
+        "identities": [
+            "app"
+        ],
+        "readOnly": true,
+        "declaredMode": false,
+        "idempotencyKey": false
+    },
     "warehouse.view.read": {
         "kind": "database",
         "identities": [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@isomorph.ai/app-sdk",
-  "version": "1.18.0",
+  "version": "1.20.0",
   "type": "module",
   "repository": {
     "type": "git",