@topolo/sdk 0.4.7 → 0.4.9

package/src/application-requirements.ts

@@ -125,16 +125,20 @@ export const APPLICATION_REQUIREMENTS = [
       'Browser applications should feel like one platform and should not create isolated navigation or account surfaces.',
     appliesTo: ['browser'],
     evidence: [
-      '@topolo/ui-kit is used for the platform shell where the app has authenticated UI',
-      'The shared launcher/app switcher is reachable from authenticated app chrome',
-      'Account menu and sign-out behavior use TopoloAppShell or TopoloAccountMenu',
+      '@topolo-io/app-shell is used for the platform shell where the app has authenticated UI',
+      '@topolo-io/app-launcher keeps the shared launcher/app switcher reachable from authenticated app chrome',
+      'Account menu and sign-out behavior use TopoloAppShell or the ui-kit TopoloAccountMenu primitive',
+      'Repeated app body surfaces use shared TopoloAppLayout primitives instead of local stat cards, empty states, or status badges',
+      'Local preview supports deterministic visual QA fixtures for overview, list, detail, settings, and empty/loading states',
       'Authenticated app body content stays inside the viewport on mobile and desktop widths',
     ],
     implementation: [
-      'Use TopoloAppShell for authenticated app layouts',
-      'Use TopoloAccountMenu when a partial-shell surface still needs account chrome',
+      'Use @topolo-io/app-shell TopoloAppShell for authenticated app layouts',
+      'Use the @topolo-io/ui-kit TopoloAccountMenu primitive when a partial-shell surface still needs account chrome',
       'Pass app-specific account actions as additive menu items instead of forking dropdowns',
       'Use shared design tokens and platform UI primitives before creating local equivalents',
+      'Use TopoloAppMetricCard, TopoloAppEmptyState, TopoloAppStatusBadge, TopoloAppGrid, and TopoloAppSection for repeated app body patterns',
+      'Keep visual QA fixtures available through visualQa=1 or __devpreview=1 so screenshot checks do not depend on live API state',
       'Keep mobile and desktop shell behavior aligned with the platform UI kit',
       'Constrain app-owned workspace wrappers with min-width: 0, width: auto, and viewport-aware max-width so shell padding cannot create page-level horizontal overflow',
     ],

package/src/applications.generated.ts

@@ -49,17 +49,15 @@ export const APPLICATIONS = {
           "agent.topolo.app"
         ],
         "routes": [],
-        "serviceId": null
+        "serviceId": "agent"
       },
       {
         "name": "topolo-agent-api",
         "kind": "worker",
-        "apiUrl": "https://agent-api.topolo.app",
-        "domains": [
-          "agent-api.topolo.app"
-        ],
+        "apiUrl": null,
+        "domains": [],
         "routes": [],
-        "serviceId": "agent"
+        "serviceId": null
       }
     ]
   },
@@ -179,17 +177,15 @@ export const APPLICATIONS = {
           "bytes.topolo.app"
         ],
         "routes": [],
-        "serviceId": null
+        "serviceId": "bytes"
       },
       {
         "name": "topolo-bytes-api",
         "kind": "worker",
-        "apiUrl": "https://bytes-api.topolo.app",
-        "domains": [
-          "bytes-api.topolo.app"
-        ],
+        "apiUrl": null,
+        "domains": [],
         "routes": [],
-        "serviceId": "bytes"
+        "serviceId": null
       }
     ]
   },
@@ -288,12 +284,10 @@ export const APPLICATIONS = {
       {
         "name": "topolo-commerce-api",
         "kind": "worker",
-        "apiUrl": "https://commerce-api.topolo.app",
-        "domains": [
-          "commerce-api.topolo.app"
-        ],
+        "apiUrl": null,
+        "domains": [],
         "routes": [],
-        "serviceId": "commerce"
+        "serviceId": null
       },
       {
         "name": "topolo-commerce-guest-web",
@@ -313,7 +307,7 @@ export const APPLICATIONS = {
           "commerce.topolo.app"
         ],
         "routes": [],
-        "serviceId": null
+        "serviceId": "commerce"
       },
       {
         "name": "topolo-commerce-station-web",
@@ -400,12 +394,10 @@ export const APPLICATIONS = {
       {
         "name": "topolo-crm-api",
         "kind": "worker",
-        "apiUrl": "https://crm-api.topolo.app",
-        "domains": [
-          "crm-api.topolo.app"
-        ],
+        "apiUrl": null,
+        "domains": [],
         "routes": [],
-        "serviceId": "crm"
+        "serviceId": null
       },
       {
         "name": "topolo-crm-app",
@@ -415,7 +407,7 @@ export const APPLICATIONS = {
           "crm.topolo.app"
         ],
         "routes": [],
-        "serviceId": null
+        "serviceId": "crm"
       }
     ]
   },
@@ -543,7 +535,7 @@ export const APPLICATIONS = {
           "feed-api.topolo.app"
         ],
         "routes": [],
-        "serviceId": "feed"
+        "serviceId": null
       },
       {
         "name": "topolo-feed-web",
@@ -553,7 +545,7 @@ export const APPLICATIONS = {
           "feed.topolo.app"
         ],
         "routes": [],
-        "serviceId": null
+        "serviceId": "feed"
       }
     ]
   },
@@ -605,17 +597,15 @@ export const APPLICATIONS = {
           "forecast.topolo.app"
         ],
         "routes": [],
-        "serviceId": null
+        "serviceId": "forecast"
       },
       {
         "name": "topolo-forecast-api",
         "kind": "worker",
-        "apiUrl": "https://forecast-api.topolo.app",
-        "domains": [
-          "forecast-api.topolo.app"
-        ],
+        "apiUrl": null,
+        "domains": [],
         "routes": [],
-        "serviceId": "forecast"
+        "serviceId": null
       }
     ]
   },
@@ -757,17 +747,15 @@ export const APPLICATIONS = {
           "learn.topolo.app"
         ],
         "routes": [],
-        "serviceId": null
+        "serviceId": "learn"
       },
       {
         "name": "topolo-learn-api",
         "kind": "worker",
-        "apiUrl": "https://learn-api.topolo.app",
-        "domains": [
-          "learn-api.topolo.app"
-        ],
+        "apiUrl": null,
+        "domains": [],
         "routes": [],
-        "serviceId": "learn"
+        "serviceId": null
       }
     ]
   },
@@ -813,17 +801,15 @@ export const APPLICATIONS = {
           "mail.topolo.app"
         ],
         "routes": [],
-        "serviceId": null
+        "serviceId": "mail"
       },
       {
         "name": "topolo-mail-api",
         "kind": "worker",
-        "apiUrl": "https://mail-api.topolo.app",
-        "domains": [
-          "mail-api.topolo.app"
-        ],
+        "apiUrl": null,
+        "domains": [],
         "routes": [],
-        "serviceId": "mail"
+        "serviceId": null
       }
     ]
   },
@@ -840,12 +826,10 @@ export const APPLICATIONS = {
       {
         "name": "topolo-mdm-api",
         "kind": "worker",
-        "apiUrl": "https://mdm-api.topolo.app",
-        "domains": [
-          "mdm-api.topolo.app"
-        ],
+        "apiUrl": null,
+        "domains": [],
         "routes": [],
-        "serviceId": "mdm"
+        "serviceId": null
       },
       {
         "name": "topolo-mdm-console",
@@ -855,7 +839,7 @@ export const APPLICATIONS = {
           "mdm.topolo.app"
         ],
         "routes": [],
-        "serviceId": null
+        "serviceId": "mdm"
       }
     ]
   },
@@ -920,9 +904,9 @@ export const APPLICATIONS = {
       {
         "name": "topolo-nexus-gateway",
         "kind": "worker",
-        "apiUrl": "https://nexus-api.topolo.app",
+        "apiUrl": "https://nexus.topolo.app",
         "domains": [
-          "nexus-api.topolo.app"
+          "nexus.topolo.app"
         ],
         "routes": [],
         "serviceId": "nexus"
@@ -1114,36 +1098,6 @@ export const APPLICATIONS = {
       }
     ]
   },
-  "pulse": {
-    "id": "pulse",
-    "appDir": "TopoloPulse",
-    "name": "topolo-pulse",
-    "packageName": "topolo-pulse",
-    "productionUrl": "https://pulse.topolo.app",
-    "services": [
-      "pulse"
-    ],
-    "deployTargets": [
-      {
-        "name": "topolo-pulse",
-        "kind": "worker",
-        "apiUrl": "https://pulse.topolo.app",
-        "domains": [
-          "pulse.topolo.app"
-        ],
-        "routes": [],
-        "serviceId": "pulse"
-      },
-      {
-        "name": "topolo-pulse-api",
-        "kind": "worker",
-        "apiUrl": null,
-        "domains": [],
-        "routes": [],
-        "serviceId": null
-      }
-    ]
-  },
   "quro": {
     "id": "quro",
     "appDir": "TopoloQuro",
@@ -1209,17 +1163,15 @@ export const APPLICATIONS = {
           "roadmapper.topolo.app"
         ],
         "routes": [],
-        "serviceId": null
+        "serviceId": "roadmapper"
       },
       {
         "name": "topolo-roadmapper-api",
         "kind": "worker",
-        "apiUrl": "https://roadmapper-api.topolo.app",
-        "domains": [
-          "roadmapper-api.topolo.app"
-        ],
+        "apiUrl": null,
+        "domains": [],
         "routes": [],
-        "serviceId": "roadmapper"
+        "serviceId": null
       }
     ]
   },
@@ -1271,17 +1223,15 @@ export const APPLICATIONS = {
           "studio.topolo.app"
         ],
         "routes": [],
-        "serviceId": null
+        "serviceId": "social_studio"
       },
       {
         "name": "topolo-social-studio-api",
         "kind": "worker",
-        "apiUrl": "https://studio-api.topolo.app",
-        "domains": [
-          "studio-api.topolo.app"
-        ],
+        "apiUrl": null,
+        "domains": [],
         "routes": [],
-        "serviceId": "social_studio"
+        "serviceId": null
       },
       {
         "name": "topolo-social-studio-queue",
@@ -1311,7 +1261,7 @@ export const APPLICATIONS = {
           "socialize.topolo.app"
         ],
         "routes": [],
-        "serviceId": null
+        "serviceId": "socialize"
       },
       {
         "name": "topolo-socialize-api",
@@ -1321,7 +1271,7 @@ export const APPLICATIONS = {
           "socialize-api.topolo.app"
         ],
         "routes": [],
-        "serviceId": "socialize"
+        "serviceId": null
       },
       {
         "name": "topolo-socialize-scheduler",
@@ -1522,12 +1472,10 @@ export const APPLICATIONS = {
       {
         "name": "topolo-web-api",
         "kind": "worker",
-        "apiUrl": "https://web-api.topolo.app",
-        "domains": [
-          "web-api.topolo.app"
-        ],
+        "apiUrl": null,
+        "domains": [],
         "routes": [],
-        "serviceId": "web"
+        "serviceId": null
       },
       {
         "name": "topolo-web-runtime",
@@ -1550,7 +1498,7 @@ export const APPLICATIONS = {
           "web.topolo.app"
         ],
         "routes": [],
-        "serviceId": null
+        "serviceId": "web"
       }
     ]
   }

package/src/client.test.ts

@@ -143,6 +143,40 @@ describe('TopoloClient.request', () => {
     expect(headers.get('Authorization')).toBeNull();
   });
 
+  it('adds canonical resource headers for resource-scoped API keys', async () => {
+    const { impl, calls } = stubFetch([MAIL_CATALOG, { body: { ok: true } }]);
+    const client = new TopoloClient({
+      credential: { kind: 'api_key', apiKey: 'dak_xyz' },
+      agent: AGENT,
+      fetch: impl,
+    });
+    await client.request({
+      service: 'mail',
+      path: '/api/mail/mailboxes/mbx_1/messages',
+      resource: { resourceType: 'mailbox', resourceId: 'mbx_1' },
+    });
+    const headers = new Headers(requestCalls(calls)[0]!.init.headers);
+    expect(headers.get('X-Topolo-Resource-Type')).toBe('mailbox');
+    expect(headers.get('X-Topolo-Resource-ID')).toBe('mbx_1');
+  });
+
+  it('passes arbitrary cataloged workspace aliases through resource headers', async () => {
+    const { impl, calls } = stubFetch([MAIL_CATALOG, { body: { ok: true } }]);
+    const client = new TopoloClient({
+      credential: { kind: 'api_key', apiKey: 'dak_xyz' },
+      agent: AGENT,
+      fetch: impl,
+    });
+    await client.request({
+      service: 'mail',
+      path: '/api/example',
+      resource: { resourceType: 'studio_portfolio', resourceId: 'portfolio_1' },
+    });
+    const headers = new Headers(requestCalls(calls)[0]!.init.headers);
+    expect(headers.get('X-Topolo-Resource-Type')).toBe('studio_portfolio');
+    expect(headers.get('X-Topolo-Resource-ID')).toBe('portfolio_1');
+  });
+
   it('refuses mutating requests without confirm', async () => {
     const { impl } = stubFetch([]);
     const client = new TopoloClient({
@@ -367,7 +401,7 @@ describe('TopoloClient.getServiceIdBySlug', () => {
       credential: { kind: 'api_key', apiKey: 'x' },
       agent: AGENT,
       fetch: impl,
-      serviceUrls: { auth: 'https://auth.example.com' } as never,
+      serviceUrls: { auth: 'https://auth.example.com', developers: 'https://auth.example.com' } as never,
       serviceIds: { notify: 'service_notify' },
     });
     const id = await client.getServiceIdBySlug('topolo-notify');
@@ -379,7 +413,7 @@ describe('TopoloClient.getServiceIdBySlug', () => {
     const { impl, calls } = stubFetch([
       { body: { success: true, data: { service_id: 'service_abc123', api_base_url: 'https://x-api' } } },
     ]);
-    const client = freshClient(impl, { auth: 'https://auth.example.com' });
+    const client = freshClient(impl, { auth: 'https://auth.example.com', developers: 'https://auth.example.com' });
     const id = await client.getServiceIdBySlug('external-service');
     expect(id).toBe('service_abc123');
     expect(calls[0]!.url).toBe('https://auth.example.com/api/services/by-slug/external-service');
@@ -391,7 +425,7 @@ describe('TopoloClient.getServiceIdBySlug', () => {
 
   it('returns null on 404 and caches the negative result', async () => {
     const { impl, calls } = stubFetch([{ status: 404, body: { success: false } }]);
-    const client = freshClient(impl, { auth: 'https://auth.example.com' });
+    const client = freshClient(impl, { auth: 'https://auth.example.com', developers: 'https://auth.example.com' });
     expect(await client.getServiceIdBySlug('nope')).toBeNull();
     expect(await client.getServiceIdBySlug('nope')).toBeNull();
     expect(calls.length).toBe(1);
@@ -401,7 +435,7 @@ describe('TopoloClient.getServiceIdBySlug', () => {
     const { impl, calls } = stubFetch([
       { body: { success: true, data: { service_id: 'service_external' } } },
     ]);
-    const client = freshClient(impl, { auth: 'https://auth.example.com' });
+    const client = freshClient(impl, { auth: 'https://auth.example.com', developers: 'https://auth.example.com' });
     expect(await client.getServiceIdBySlug('external-service')).toBe('service_external');
     expect(await client.getServiceIdBySlug('external-service')).toBe('service_external');
     expect(calls.length).toBe(1);
@@ -411,7 +445,7 @@ describe('TopoloClient.getServiceIdBySlug', () => {
     const { impl, calls } = stubFetch([
       { body: { success: true, data: { service_id: 'service_x' } } },
     ]);
-    const client = freshClient(impl, { auth: 'https://auth.example.com' });
+    const client = freshClient(impl, { auth: 'https://auth.example.com', developers: 'https://auth.example.com' });
     await client.getServiceIdBySlug('  EXTERNAL-SERVICE  ');
     expect(calls[0]!.url).toBe('https://auth.example.com/api/services/by-slug/external-service');
   });
@@ -433,7 +467,7 @@ describe('TopoloClient.getServiceIdBySlug', () => {
       credential: { kind: 'api_key', apiKey: 'x' },
       agent: AGENT,
       fetch: impl,
-      serviceUrls: { auth: 'https://auth.example.com' } as never,
+      serviceUrls: { auth: 'https://auth.example.com', developers: 'https://auth.example.com' } as never,
     });
     expect(await client.getServiceIdBySlug('flaky')).toBeNull();
     // Second call retries — earlier null was not cached.
@@ -458,6 +492,26 @@ describe('TopoloClient.listServices', () => {
                 status: 'active',
                 surface_kind: 'application',
                 launchable: true,
+                api_key_resource: {
+                  resourceType: 'brand',
+                  label: 'Brands',
+                  emptyLabel: 'All brands in the organization',
+                  resourceConcept: 'workspace',
+                  canonicalResourceType: 'workspace',
+                  defaultEntitlement: 'enterprise',
+                  exceptionPolicy: 'app_or_organization',
+                },
+                api_key_resources: [
+                  {
+                    resourceType: 'brand',
+                    label: 'Brands',
+                    emptyLabel: 'All brands in the organization',
+                    resourceConcept: 'workspace',
+                    canonicalResourceType: 'workspace',
+                    defaultEntitlement: 'enterprise',
+                    exceptionPolicy: 'app_or_organization',
+                  },
+                ],
                 granted_permissions: ['srv_wRCnLLbtvmVT.dashboard:read'],
               },
             ],
@@ -469,7 +523,7 @@ describe('TopoloClient.listServices', () => {
       credential: { kind: 'access_token', accessToken: 'tok_abc' },
       agent: AGENT,
       fetch: impl,
-      serviceUrls: { auth: 'https://auth.example.com' },
+      serviceUrls: { auth: 'https://auth.example.com', developers: 'https://auth.example.com' },
     });
     const out = await client.listServices();
     expect(out).toEqual([
@@ -483,6 +537,26 @@ describe('TopoloClient.listServices', () => {
         status: 'active',
         surfaceKind: 'application',
         launchable: true,
+        apiKeyResource: {
+          resourceType: 'brand',
+          label: 'Brands',
+          emptyLabel: 'All brands in the organization',
+          resourceConcept: 'workspace',
+          canonicalResourceType: 'workspace',
+          defaultEntitlement: 'enterprise',
+          exceptionPolicy: 'app_or_organization',
+        },
+        apiKeyResources: [
+          {
+            resourceType: 'brand',
+            label: 'Brands',
+            emptyLabel: 'All brands in the organization',
+            resourceConcept: 'workspace',
+            canonicalResourceType: 'workspace',
+            defaultEntitlement: 'enterprise',
+            exceptionPolicy: 'app_or_organization',
+          },
+        ],
         permissions: ['srv_wRCnLLbtvmVT.dashboard:read'],
       },
     ]);
@@ -500,7 +574,7 @@ describe('TopoloClient.listServices', () => {
       credential: { kind: 'api_key', apiKey: 'dak_xyz' },
       agent: AGENT,
       fetch: impl,
-      serviceUrls: { auth: 'https://auth.example.com' },
+      serviceUrls: { auth: 'https://auth.example.com', developers: 'https://auth.example.com' },
     });
     await expect(client.listServices()).rejects.toBeInstanceOf(TopoloHttpError);
   });
@@ -531,7 +605,7 @@ describe('TopoloClient.listServices', () => {
       credential: { kind: 'api_key', apiKey: 'dak_xyz' },
       agent: AGENT,
       fetch: impl,
-      serviceUrls: { auth: 'https://auth.example.com' },
+      serviceUrls: { auth: 'https://auth.example.com', developers: 'https://auth.example.com' },
     });
 
     await client.request({ service: 'mail', path: '/api/health' });
@@ -566,7 +640,7 @@ describe('TopoloClient.listServices', () => {
       credential: { kind: 'api_key', apiKey: 'dak_xyz' },
       agent: AGENT,
       fetch: impl,
-      serviceUrls: { auth: 'https://auth.example.com' },
+      serviceUrls: { auth: 'https://auth.example.com', developers: 'https://auth.example.com' },
     });
 
     await client.request({ service: 'crm', path: '/health' });
@@ -575,6 +649,21 @@ describe('TopoloClient.listServices', () => {
     expect(calls[1]!.url).toBe('https://crm-api.topolo.app/health');
   });
 
+  it('derives the catalog (developers) host from the auth url when developers is unset', async () => {
+    const { impl, calls } = stubFetch([{ body: { data: { services: [] } } }]);
+    const client = new TopoloClient({
+      credential: { kind: 'api_key', apiKey: 'dak_xyz' },
+      agent: AGENT,
+      fetch: impl,
+      // Fleet apps configure only `auth` per-env; the catalog host is derived.
+      serviceUrls: { auth: 'https://auth.stg.topolo.us' },
+    });
+
+    await client.listServices();
+
+    expect(calls[0]!.url).toBe('https://developers.stg.topolo.us/api/services/catalog');
+  });
+
   it('prefers live catalog api_base_url for dynamic services', async () => {
     const { impl, calls } = stubFetch([
       {
@@ -601,7 +690,7 @@ describe('TopoloClient.listServices', () => {
       credential: { kind: 'api_key', apiKey: 'dak_xyz' },
       agent: AGENT,
       fetch: impl,
-      serviceUrls: { auth: 'https://auth.example.com' },
+      serviceUrls: { auth: 'https://auth.example.com', developers: 'https://auth.example.com' },
     });
 
     await client.request({ service: 'future', path: '/health' });
@@ -634,7 +723,7 @@ describe('TopoloClient.listServices', () => {
       credential: { kind: 'api_key', apiKey: 'dak_xyz' },
       agent: AGENT,
       fetch: impl,
-      serviceUrls: { auth: 'https://auth.example.com' },
+      serviceUrls: { auth: 'https://auth.example.com', developers: 'https://auth.example.com' },
     });
 
     await expect(client.request({ service: 'mail', path: '/api/health' })).rejects.toMatchObject({
@@ -668,7 +757,7 @@ describe('TopoloClient.listServices', () => {
       credential: { kind: 'api_key', apiKey: 'dak_xyz' },
       agent: AGENT,
       fetch: impl,
-      serviceUrls: { auth: 'https://auth.example.com' },
+      serviceUrls: { auth: 'https://auth.example.com', developers: 'https://auth.example.com' },
     });
 
     await expect(client.request({ service: 'future-app', path: '/api/health' })).rejects.toMatchObject({
@@ -703,7 +792,7 @@ describe('TopoloClient.listServices', () => {
       credential: { kind: 'api_key', apiKey: 'dak_xyz' },
       agent: AGENT,
       fetch: impl,
-      serviceUrls: { auth: 'https://auth.example.com' },
+      serviceUrls: { auth: 'https://auth.example.com', developers: 'https://auth.example.com' },
     });
 
     await client.request({ service: 'warehouse', path: '/api/one' });
@@ -724,7 +813,7 @@ describe('TopoloClient action catalog', () => {
       credential: { kind: 'access_token', accessToken: 'tok_abc' },
       agent: AGENT,
       fetch: impl,
-      serviceUrls: { auth: 'https://auth.example.com' },
+      serviceUrls: { auth: 'https://auth.example.com', developers: 'https://auth.example.com' },
     });
     const actions = await client.listActions();
     expect(actions.map((action) => action.name)).toEqual([
@@ -741,7 +830,7 @@ describe('TopoloClient action catalog', () => {
       credential: { kind: 'api_key', apiKey: 'dak_xyz' },
       agent: AGENT,
       fetch: impl,
-      serviceUrls: { auth: 'https://auth.example.com' },
+      serviceUrls: { auth: 'https://auth.example.com', developers: 'https://auth.example.com' },
     });
     await client.callAction('messages.list', { mailboxId: 'primary', q: 'Ada', page: 2 });
     const call = requestCalls(calls)[0]!;
@@ -759,7 +848,7 @@ describe('TopoloClient action catalog', () => {
       credential: { kind: 'api_key', apiKey: 'dak_xyz' },
       agent: AGENT,
       fetch: impl,
-      serviceUrls: { auth: 'https://auth.example.com' },
+      serviceUrls: { auth: 'https://auth.example.com', developers: 'https://auth.example.com' },
     });
     await client.callAction('topolo_mail_messages_get', {
       mailboxId: 'primary',
@@ -779,7 +868,7 @@ describe('TopoloClient action catalog', () => {
       credential: { kind: 'api_key', apiKey: 'dak_xyz' },
       agent: AGENT,
       fetch: impl,
-      serviceUrls: { auth: 'https://auth.example.com' },
+      serviceUrls: { auth: 'https://auth.example.com', developers: 'https://auth.example.com' },
     });
     await expect(
       client.callAction('messages.send', { mailboxId: 'primary', subject: 'Hello' }),
@@ -792,7 +881,7 @@ describe('TopoloClient action catalog', () => {
       credential: { kind: 'api_key', apiKey: 'dak_xyz' },
       agent: AGENT,
       fetch: impl,
-      serviceUrls: { auth: 'https://auth.example.com' },
+      serviceUrls: { auth: 'https://auth.example.com', developers: 'https://auth.example.com' },
     });
     await client.callAction('messages.send', { mailboxId: 'primary', subject: 'Hello' }, { confirm: true });
     const call = requestCalls(calls)[0]!;