@topolo/sdk 0.4.10 → 0.6.0

package/dist/index.d.ts

@@ -36,8 +36,8 @@ interface TopoloClientOptions {
     agent: AgentIdentity;
     /** Per-service URL overrides. Useful for staging/dev. */
     serviceUrls?: Record<string, string>;
-    /** Per-service TopoloAuth service id overrides from the owning app/deployment. */
-    serviceIds?: Record<string, string>;
+    /** Per-service TopoloAuth app id overrides from the owning app/deployment. */
+    appIds?: Record<string, string>;
     /**
      * When true, mutating helpers (POST/PUT/PATCH/DELETE) require callers to pass
      * `{ confirm: true }`. Defaults to true. Set false only for trusted surfaces.
@@ -105,7 +105,7 @@ interface RequestOptions {
  * from TopoloAuth `GET /api/services/catalog`.
  */
 interface TopoloServiceCatalogEntry {
-    serviceId: string;
+    appId: string;
     slug: string | null;
     name: string | null;
     description: string | null;
@@ -133,9 +133,9 @@ interface TopoloActionCatalogEntry {
     toolName: string | null;
     title: string;
     description: string;
-    serviceId: string;
-    serviceSlug: string | null;
-    serviceName: string | null;
+    appId: string;
+    appSlug: string | null;
+    appName: string | null;
     method: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
     path: string;
     permissionName: string;
@@ -154,7 +154,7 @@ declare class TopoloClient {
     private readonly credential;
     private readonly agent;
     private readonly serviceUrls?;
-    private readonly serviceIds?;
+    private readonly appIds?;
     private readonly requireConfirmForWrites;
     private readonly timeoutMs;
     private readonly fetchImpl;
@@ -162,17 +162,17 @@ declare class TopoloClient {
     private serviceCatalogCache;
     private actionCatalogCache;
     /**
-     * Process-wide cache for slug → service-id lookups. Keyed by
+     * Process-wide cache for slug → app-id lookups. Keyed by
      * `${authBaseUrl}|${slug}` so multiple `TopoloClient` instances pointing at
      * the same Auth share, but staging vs prod don't poison each other.
-     * Cleared via `TopoloClient.clearServiceIdCache()` if a test needs it.
+     * Cleared via `TopoloClient.clearAppIdCache()` if a test needs it.
      */
-    private static readonly serviceIdCache;
+    private static readonly appIdCache;
     /**
-     * Drop the slug→service-id cache. Test-only — production callers should
+     * Drop the slug→app-id cache. Test-only — production callers should
      * let the 5-minute TTL expire naturally.
      */
-    static clearServiceIdCache(): void;
+    static clearAppIdCache(): void;
     constructor(options: TopoloClientOptions);
     private emit;
     /**
@@ -184,7 +184,7 @@ declare class TopoloClient {
     private resolveRequestService;
     private resolveLiveCallableService;
     /**
-     * Resolve a service-slug → opaque service-id via caller config or TopoloAuth.
+     * Resolve a service-slug → opaque app-id via caller config or TopoloAuth.
      *
      * Cache: 5 minutes per process per `(slug, auth_base_url)`. Negative
      * results (404) are cached for 60s so a typo doesn't hot-loop the
@@ -195,7 +195,7 @@ declare class TopoloClient {
      * This keeps the resolver usable during early bootstrap before a caller
      * has acquired an access token.
      */
-    getServiceIdBySlug(slug: string): Promise<string | null>;
+    getAppIdBySlug(slug: string): Promise<string | null>;
     /**
      * List the platform service catalog from the live registry
      * (`GET /api/services/catalog` on TopoloAuth). Credential-aware: the
@@ -252,7 +252,7 @@ interface CredentialIntrospection {
     } | null;
 }
 
-declare const SERVICES: {
+declare const APP_API_URLS: {
     readonly agent: "https://agent.topolo.app";
     readonly auth: "https://auth.topolo.app";
     readonly backup: "https://backup.topolo.app";
@@ -301,7 +301,7 @@ declare const SERVICES: {
     readonly voice: "https://voice.topolo.app";
     readonly web: "https://web.topolo.app";
 };
-type ServiceId = keyof typeof SERVICES;
+type AppApiId = keyof typeof APP_API_URLS;
 
 declare const APPLICATIONS: {
     readonly admin: {
@@ -317,14 +317,14 @@ declare const APPLICATIONS: {
             readonly apiUrl: "https://admin.topolo.app";
             readonly domains: readonly ["admin.topolo.app"];
             readonly routes: readonly [];
-            readonly serviceId: null;
+            readonly appId: null;
         }, {
             readonly name: "topolo-admin-api";
             readonly kind: "worker";
             readonly apiUrl: null;
             readonly domains: readonly [];
             readonly routes: readonly [];
-            readonly serviceId: null;
+            readonly appId: null;
         }];
     };
     readonly agent: {
@@ -340,14 +340,14 @@ declare const APPLICATIONS: {
             readonly apiUrl: "https://agent.topolo.app";
             readonly domains: readonly ["agent.topolo.app"];
             readonly routes: readonly [];
-            readonly serviceId: "agent";
+            readonly appId: "agent";
         }, {
             readonly name: "topolo-agent-api";
             readonly kind: "worker";
             readonly apiUrl: null;
             readonly domains: readonly [];
             readonly routes: readonly [];
-            readonly serviceId: null;
+            readonly appId: null;
         }];
     };
     readonly auth: {
@@ -363,7 +363,7 @@ declare const APPLICATIONS: {
             readonly apiUrl: "https://auth.topolo.app";
             readonly domains: readonly ["auth.topolo.app"];
             readonly routes: readonly ["auth.topolo.app"];
-            readonly serviceId: "auth";
+            readonly appId: "auth";
         }];
     };
     readonly backup: {
@@ -379,7 +379,7 @@ declare const APPLICATIONS: {
             readonly apiUrl: "https://backup.topolo.app";
             readonly domains: readonly ["backup.topolo.app"];
             readonly routes: readonly [];
-            readonly serviceId: "backup";
+            readonly appId: "backup";
         }];
     };
     readonly books: {
@@ -395,14 +395,14 @@ declare const APPLICATIONS: {
             readonly apiUrl: "https://books.topolo.app";
             readonly domains: readonly ["books.topolo.app"];
             readonly routes: readonly [];
-            readonly serviceId: "books";
+            readonly appId: "books";
         }, {
             readonly name: "topolo-books-api";
             readonly kind: "worker";
             readonly apiUrl: null;
             readonly domains: readonly [];
             readonly routes: readonly [];
-            readonly serviceId: null;
+            readonly appId: null;
         }];
     };
     readonly bugfix: {
@@ -418,7 +418,7 @@ declare const APPLICATIONS: {
             readonly apiUrl: "https://bugfix.topolo.app";
             readonly domains: readonly ["bugfix.topolo.app"];
             readonly routes: readonly [];
-            readonly serviceId: "bugfix";
+            readonly appId: "bugfix";
         }];
     };
     readonly bytes: {
@@ -434,14 +434,14 @@ declare const APPLICATIONS: {
             readonly apiUrl: "https://bytes.topolo.app";
             readonly domains: readonly ["bytes.topolo.app"];
             readonly routes: readonly [];
-            readonly serviceId: "bytes";
+            readonly appId: "bytes";
         }, {
             readonly name: "topolo-bytes-api";
             readonly kind: "worker";
             readonly apiUrl: null;
             readonly domains: readonly [];
             readonly routes: readonly [];
-            readonly serviceId: null;
+            readonly appId: null;
         }];
     };
     readonly calendar: {
@@ -457,14 +457,14 @@ declare const APPLICATIONS: {
             readonly apiUrl: "https://calendar.topolo.app";
             readonly domains: readonly ["calendar.topolo.app"];
             readonly routes: readonly [];
-            readonly serviceId: "calendar";
+            readonly appId: "calendar";
         }, {
             readonly name: "topolo-calendar-api";
             readonly kind: "worker";
             readonly apiUrl: null;
             readonly domains: readonly [];
             readonly routes: readonly [];
-            readonly serviceId: null;
+            readonly appId: null;
         }];
     };
     readonly capacity: {
@@ -480,7 +480,7 @@ declare const APPLICATIONS: {
             readonly apiUrl: "https://capacity.topolo.app";
             readonly domains: readonly ["capacity.topolo.app"];
             readonly routes: readonly [];
-            readonly serviceId: "capacity";
+            readonly appId: "capacity";
         }];
     };
     readonly chat: {
@@ -496,14 +496,14 @@ declare const APPLICATIONS: {
             readonly apiUrl: "https://chat.topolo.app";
             readonly domains: readonly ["chat.topolo.app"];
             readonly routes: readonly [];
-            readonly serviceId: "chat";
+            readonly appId: "chat";
         }, {
             readonly name: "topolo-chat-api";
             readonly kind: "worker";
             readonly apiUrl: null;
             readonly domains: readonly [];
             readonly routes: readonly [];
-            readonly serviceId: null;
+            readonly appId: null;
         }];
     };
     readonly commerce: {
@@ -519,28 +519,28 @@ declare const APPLICATIONS: {
             readonly apiUrl: null;
             readonly domains: readonly [];
             readonly routes: readonly [];
-            readonly serviceId: null;
+            readonly appId: null;
         }, {
             readonly name: "topolo-commerce-guest-web";
             readonly kind: "worker";
             readonly apiUrl: "https://guest.topolo.app";
             readonly domains: readonly ["guest.topolo.app"];
             readonly routes: readonly [];
-            readonly serviceId: null;
+            readonly appId: null;
         }, {
             readonly name: "topolo-commerce-ops-web";
             readonly kind: "worker";
             readonly apiUrl: "https://commerce.topolo.app";
             readonly domains: readonly ["commerce.topolo.app"];
             readonly routes: readonly [];
-            readonly serviceId: "commerce";
+            readonly appId: "commerce";
         }, {
             readonly name: "topolo-commerce-station-web";
             readonly kind: "worker";
             readonly apiUrl: "https://station-commerce.topolo.app";
             readonly domains: readonly ["station-commerce.topolo.app"];
             readonly routes: readonly [];
-            readonly serviceId: null;
+            readonly appId: null;
         }];
     };
     readonly compose: {
@@ -556,14 +556,14 @@ declare const APPLICATIONS: {
             readonly apiUrl: "https://compose.topolo.app";
             readonly domains: readonly ["compose.topolo.app"];
             readonly routes: readonly [];
-            readonly serviceId: "compose";
+            readonly appId: "compose";
         }, {
             readonly name: "topolo-compose-api";
             readonly kind: "worker";
             readonly apiUrl: null;
             readonly domains: readonly [];
             readonly routes: readonly [];
-            readonly serviceId: null;
+            readonly appId: null;
         }];
     };
     readonly consent: {
@@ -579,14 +579,14 @@ declare const APPLICATIONS: {
             readonly apiUrl: "https://consent.topolo.app";
             readonly domains: readonly ["consent.topolo.app"];
             readonly routes: readonly [];
-            readonly serviceId: "consent";
+            readonly appId: "consent";
         }, {
             readonly name: "topolo-consent-api";
             readonly kind: "worker";
             readonly apiUrl: null;
             readonly domains: readonly [];
             readonly routes: readonly [];
-            readonly serviceId: null;
+            readonly appId: null;
         }];
     };
     readonly crm: {
@@ -602,14 +602,14 @@ declare const APPLICATIONS: {
             readonly apiUrl: null;
             readonly domains: readonly [];
             readonly routes: readonly [];
-            readonly serviceId: null;
+            readonly appId: null;
         }, {
             readonly name: "topolo-crm-app";
             readonly kind: "worker";
             readonly apiUrl: "https://crm.topolo.app";
             readonly domains: readonly ["crm.topolo.app"];
             readonly routes: readonly [];
-            readonly serviceId: "crm";
+            readonly appId: "crm";
         }];
     };
     readonly developers: {
@@ -625,21 +625,21 @@ declare const APPLICATIONS: {
             readonly apiUrl: null;
             readonly domains: readonly [];
             readonly routes: readonly [];
-            readonly serviceId: null;
+            readonly appId: null;
         }, {
             readonly name: "topolo-developers";
             readonly kind: "worker";
             readonly apiUrl: "https://developers.topolo.app";
             readonly domains: readonly ["developers.topolo.app"];
             readonly routes: readonly [];
-            readonly serviceId: "developers";
+            readonly appId: "developers";
         }, {
             readonly name: "topolo-developers-api";
             readonly kind: "worker";
             readonly apiUrl: null;
             readonly domains: readonly [];
             readonly routes: readonly [];
-            readonly serviceId: null;
+            readonly appId: null;
         }];
     };
     readonly director: {
@@ -655,14 +655,14 @@ declare const APPLICATIONS: {
             readonly apiUrl: "https://director.topolo.app";
             readonly domains: readonly ["director.topolo.app"];
             readonly routes: readonly [];
-            readonly serviceId: "director";
+            readonly appId: "director";
         }, {
             readonly name: "topolo-director-api";
             readonly kind: "worker";
             readonly apiUrl: null;
             readonly domains: readonly [];
             readonly routes: readonly [];
-            readonly serviceId: null;
+            readonly appId: null;
         }];
     };
     readonly docs: {
@@ -678,14 +678,14 @@ declare const APPLICATIONS: {
             readonly apiUrl: "https://docs.topolo.app";
             readonly domains: readonly ["docs.topolo.app"];
             readonly routes: readonly [];
-            readonly serviceId: null;
+            readonly appId: null;
         }, {
             readonly name: "topolo-docs-api";
             readonly kind: "worker";
             readonly apiUrl: null;
             readonly domains: readonly [];
             readonly routes: readonly [];
-            readonly serviceId: null;
+            readonly appId: null;
         }];
     };
     readonly feed: {
@@ -701,21 +701,21 @@ declare const APPLICATIONS: {
             readonly apiUrl: "https://feed-analytics-api.topolo.app";
             readonly domains: readonly ["feed-analytics-api.topolo.app"];
             readonly routes: readonly [];
-            readonly serviceId: null;
+            readonly appId: null;
         }, {
             readonly name: "topolo-feed-api";
             readonly kind: "worker";
             readonly apiUrl: "https://feed-api.topolo.app";
             readonly domains: readonly ["feed-api.topolo.app"];
             readonly routes: readonly [];
-            readonly serviceId: null;
+            readonly appId: null;
         }, {
             readonly name: "topolo-feed-web";
             readonly kind: "worker";
             readonly apiUrl: "https://feed.topolo.app";
             readonly domains: readonly ["feed.topolo.app"];
             readonly routes: readonly [];
-            readonly serviceId: "feed";
+            readonly appId: "feed";
         }];
     };
     readonly flow: {
@@ -731,14 +731,14 @@ declare const APPLICATIONS: {
             readonly apiUrl: "https://flow.topolo.app";
             readonly domains: readonly ["flow.topolo.app"];
             readonly routes: readonly [];
-            readonly serviceId: "flow";
+            readonly appId: "flow";
         }, {
             readonly name: "topolo-flow-api";
             readonly kind: "worker";
             readonly apiUrl: null;
             readonly domains: readonly [];
             readonly routes: readonly [];
-            readonly serviceId: null;
+            readonly appId: null;
         }];
     };
     readonly forecast: {
@@ -754,14 +754,14 @@ declare const APPLICATIONS: {
             readonly apiUrl: "https://forecast.topolo.app";
             readonly domains: readonly ["forecast.topolo.app"];
             readonly routes: readonly [];
-            readonly serviceId: "forecast";
+            readonly appId: "forecast";
         }, {
             readonly name: "topolo-forecast-api";
             readonly kind: "worker";
             readonly apiUrl: null;
             readonly domains: readonly [];
             readonly routes: readonly [];
-            readonly serviceId: null;
+            readonly appId: null;
         }];
     };
     readonly forms: {
@@ -777,14 +777,14 @@ declare const APPLICATIONS: {
             readonly apiUrl: "https://forms.topolo.app";
             readonly domains: readonly ["forms.topolo.app"];
             readonly routes: readonly [];
-            readonly serviceId: "forms";
+            readonly appId: "forms";
         }, {
             readonly name: "topolo-forms-api";
             readonly kind: "worker";
             readonly apiUrl: null;
             readonly domains: readonly [];
             readonly routes: readonly [];
-            readonly serviceId: null;
+            readonly appId: null;
         }];
     };
     readonly home: {
@@ -800,14 +800,14 @@ declare const APPLICATIONS: {
             readonly apiUrl: "https://home.topolo.app";
             readonly domains: readonly ["home.topolo.app"];
             readonly routes: readonly [];
-            readonly serviceId: "home";
+            readonly appId: "home";
         }, {
             readonly name: "topolo-home-api";
             readonly kind: "worker";
             readonly apiUrl: null;
             readonly domains: readonly [];
             readonly routes: readonly [];
-            readonly serviceId: null;
+            readonly appId: null;
         }];
     };
     readonly insights: {
@@ -823,14 +823,14 @@ declare const APPLICATIONS: {
             readonly apiUrl: "https://insights.topolo.app";
             readonly domains: readonly ["insights.topolo.app"];
             readonly routes: readonly [];
-            readonly serviceId: "insights";
+            readonly appId: "insights";
         }, {
             readonly name: "topolo-insights-api";
             readonly kind: "worker";
             readonly apiUrl: null;
             readonly domains: readonly [];
             readonly routes: readonly [];
-            readonly serviceId: null;
+            readonly appId: null;
         }];
     };
     readonly inventory: {
@@ -846,14 +846,14 @@ declare const APPLICATIONS: {
             readonly apiUrl: "https://inventory.topolo.app";
             readonly domains: readonly ["inventory.topolo.app"];
             readonly routes: readonly [];
-            readonly serviceId: "inventory";
+            readonly appId: "inventory";
         }, {
             readonly name: "topolo-inventory-api";
             readonly kind: "worker";
             readonly apiUrl: null;
             readonly domains: readonly [];
             readonly routes: readonly [];
-            readonly serviceId: null;
+            readonly appId: null;
         }];
     };
     readonly learn: {
@@ -869,14 +869,14 @@ declare const APPLICATIONS: {
             readonly apiUrl: "https://learn.topolo.app";
             readonly domains: readonly ["learn.topolo.app"];
             readonly routes: readonly [];
-            readonly serviceId: "learn";
+            readonly appId: "learn";
         }, {
             readonly name: "topolo-learn-api";
             readonly kind: "worker";
             readonly apiUrl: null;
             readonly domains: readonly [];
             readonly routes: readonly [];
-            readonly serviceId: null;
+            readonly appId: null;
         }];
     };
     readonly localize: {
@@ -892,7 +892,7 @@ declare const APPLICATIONS: {
             readonly apiUrl: "https://localize.topolo.app";
             readonly domains: readonly ["localize.topolo.app"];
             readonly routes: readonly ["localize.topolo.app"];
-            readonly serviceId: "localize";
+            readonly appId: "localize";
         }];
     };
     readonly mail: {
@@ -908,14 +908,14 @@ declare const APPLICATIONS: {
             readonly apiUrl: "https://mail.topolo.app";
             readonly domains: readonly ["mail.topolo.app"];
             readonly routes: readonly [];
-            readonly serviceId: "mail";
+            readonly appId: "mail";
         }, {
             readonly name: "topolo-mail-api";
             readonly kind: "worker";
             readonly apiUrl: null;
             readonly domains: readonly [];
             readonly routes: readonly [];
-            readonly serviceId: null;
+            readonly appId: null;
         }];
     };
     readonly mdm: {
@@ -931,14 +931,14 @@ declare const APPLICATIONS: {
             readonly apiUrl: null;
             readonly domains: readonly [];
             readonly routes: readonly [];
-            readonly serviceId: null;
+            readonly appId: null;
         }, {
             readonly name: "topolo-mdm-console";
             readonly kind: "worker";
             readonly apiUrl: "https://mdm.topolo.app";
             readonly domains: readonly ["mdm.topolo.app"];
             readonly routes: readonly [];
-            readonly serviceId: "mdm";
+            readonly appId: "mdm";
         }];
     };
     readonly messages: {
@@ -954,21 +954,21 @@ declare const APPLICATIONS: {
             readonly apiUrl: "https://messages.topolo.app";
             readonly domains: readonly ["messages.topolo.app"];
             readonly routes: readonly [];
-            readonly serviceId: "messages";
+            readonly appId: "messages";
         }, {
             readonly name: "topolo-messages-api";
             readonly kind: "worker";
             readonly apiUrl: null;
             readonly domains: readonly [];
             readonly routes: readonly [];
-            readonly serviceId: null;
+            readonly appId: null;
         }, {
             readonly name: "topolo-messages-dispatch";
             readonly kind: "worker";
             readonly apiUrl: null;
             readonly domains: readonly [];
             readonly routes: readonly [];
-            readonly serviceId: null;
+            readonly appId: null;
         }];
     };
     readonly nexus: {
@@ -984,14 +984,14 @@ declare const APPLICATIONS: {
             readonly apiUrl: null;
             readonly domains: readonly ["nexus.topolo.app"];
             readonly routes: readonly [];
-            readonly serviceId: null;
+            readonly appId: null;
         }, {
             readonly name: "topolo-nexus-gateway";
             readonly kind: "worker";
             readonly apiUrl: "https://nexus.topolo.app";
             readonly domains: readonly ["nexus.topolo.app"];
             readonly routes: readonly [];
-            readonly serviceId: "nexus";
+            readonly appId: "nexus";
         }];
     };
     readonly notify: {
@@ -1007,7 +1007,7 @@ declare const APPLICATIONS: {
             readonly apiUrl: "https://notify.topolo.app";
             readonly domains: readonly ["notify.topolo.app"];
             readonly routes: readonly ["notify.topolo.app"];
-            readonly serviceId: "notify";
+            readonly appId: "notify";
         }];
     };
     readonly observability_watch: {
@@ -1023,7 +1023,7 @@ declare const APPLICATIONS: {
             readonly apiUrl: "https://observability-watch.topolo.app";
             readonly domains: readonly ["observability-watch.topolo.app"];
             readonly routes: readonly [];
-            readonly serviceId: "observability_watch";
+            readonly appId: "observability_watch";
         }];
     };
     readonly one: {
@@ -1039,21 +1039,21 @@ declare const APPLICATIONS: {
             readonly apiUrl: "https://one.topolo.app";
             readonly domains: readonly ["one.topolo.app"];
             readonly routes: readonly ["one.topolo.app/*"];
-            readonly serviceId: null;
+            readonly appId: null;
         }, {
             readonly name: "topolo-one-api";
             readonly kind: "worker";
             readonly apiUrl: "https://www.topolo.app";
             readonly domains: readonly ["www.topolo.app"];
             readonly routes: readonly ["www.topolo.app/*"];
-            readonly serviceId: "one";
+            readonly appId: "one";
         }, {
             readonly name: "topolo-one-website";
             readonly kind: "worker";
             readonly apiUrl: "https://topolo.io";
             readonly domains: readonly ["topolo.io"];
             readonly routes: readonly ["topolo.io", "www.topolo.io"];
-            readonly serviceId: null;
+            readonly appId: null;
         }];
     };
     readonly p2p: {
@@ -1069,14 +1069,14 @@ declare const APPLICATIONS: {
             readonly apiUrl: "https://p2p.topolo.app";
             readonly domains: readonly ["p2p.topolo.app"];
             readonly routes: readonly [];
-            readonly serviceId: "p2p";
+            readonly appId: "p2p";
         }, {
             readonly name: "topolo-p2p-api";
             readonly kind: "worker";
             readonly apiUrl: null;
             readonly domains: readonly [];
             readonly routes: readonly [];
-            readonly serviceId: null;
+            readonly appId: null;
         }];
     };
     readonly pay: {
@@ -1092,14 +1092,14 @@ declare const APPLICATIONS: {
             readonly apiUrl: "https://pay.topolo.app";
             readonly domains: readonly ["pay.topolo.app"];
             readonly routes: readonly [];
-            readonly serviceId: "pay";
+            readonly appId: "pay";
         }, {
             readonly name: "topolo-pay-api";
             readonly kind: "worker";
             readonly apiUrl: null;
             readonly domains: readonly [];
             readonly routes: readonly [];
-            readonly serviceId: null;
+            readonly appId: null;
         }];
     };
     readonly people: {
@@ -1115,14 +1115,14 @@ declare const APPLICATIONS: {
             readonly apiUrl: "https://people.topolo.app";
             readonly domains: readonly ["people.topolo.app"];
             readonly routes: readonly [];
-            readonly serviceId: "people";
+            readonly appId: "people";
         }, {
             readonly name: "topolo-people-api";
             readonly kind: "worker";
             readonly apiUrl: null;
             readonly domains: readonly [];
             readonly routes: readonly [];
-            readonly serviceId: null;
+            readonly appId: null;
         }];
     };
     readonly quro: {
@@ -1138,21 +1138,21 @@ declare const APPLICATIONS: {
             readonly apiUrl: "https://api.ol0.me";
             readonly domains: readonly ["api.ol0.me"];
             readonly routes: readonly ["api.ol0.me/*"];
-            readonly serviceId: "quro.api";
+            readonly appId: "quro.api";
         }, {
             readonly name: "quro-redirect-system";
             readonly kind: "worker";
             readonly apiUrl: "https://ol0.me";
             readonly domains: readonly ["ol0.me"];
             readonly routes: readonly ["ol0.me/*"];
-            readonly serviceId: "quro.redirect";
+            readonly appId: "quro.redirect";
         }, {
             readonly name: "quro-ui";
             readonly kind: "worker";
             readonly apiUrl: "https://quro.topolo.app";
             readonly domains: readonly ["quro.topolo.app"];
             readonly routes: readonly [];
-            readonly serviceId: null;
+            readonly appId: null;
         }];
     };
     readonly roadmapper: {
@@ -1168,14 +1168,14 @@ declare const APPLICATIONS: {
             readonly apiUrl: "https://roadmapper.topolo.app";
             readonly domains: readonly ["roadmapper.topolo.app"];
             readonly routes: readonly [];
-            readonly serviceId: "roadmapper";
+            readonly appId: "roadmapper";
         }, {
             readonly name: "topolo-roadmapper-api";
             readonly kind: "worker";
             readonly apiUrl: null;
             readonly domains: readonly [];
             readonly routes: readonly [];
-            readonly serviceId: null;
+            readonly appId: null;
         }];
     };
     readonly sign: {
@@ -1191,14 +1191,14 @@ declare const APPLICATIONS: {
             readonly apiUrl: "https://sign.topolo.app";
             readonly domains: readonly ["sign.topolo.app"];
             readonly routes: readonly [];
-            readonly serviceId: "sign";
+            readonly appId: "sign";
         }, {
             readonly name: "topolo-sign-api";
             readonly kind: "worker";
             readonly apiUrl: null;
             readonly domains: readonly [];
             readonly routes: readonly [];
-            readonly serviceId: null;
+            readonly appId: null;
         }];
     };
     readonly social_studio: {
@@ -1214,21 +1214,21 @@ declare const APPLICATIONS: {
             readonly apiUrl: "https://studio.topolo.app";
             readonly domains: readonly ["studio.topolo.app"];
             readonly routes: readonly [];
-            readonly serviceId: "social_studio";
+            readonly appId: "social_studio";
         }, {
             readonly name: "topolo-social-studio-api";
             readonly kind: "worker";
             readonly apiUrl: null;
             readonly domains: readonly [];
             readonly routes: readonly [];
-            readonly serviceId: null;
+            readonly appId: null;
         }, {
             readonly name: "topolo-social-studio-queue";
             readonly kind: "worker";
             readonly apiUrl: null;
             readonly domains: readonly [];
             readonly routes: readonly [];
-            readonly serviceId: null;
+            readonly appId: null;
         }];
     };
     readonly socialize: {
@@ -1244,21 +1244,21 @@ declare const APPLICATIONS: {
             readonly apiUrl: "https://socialize.topolo.app";
             readonly domains: readonly ["socialize.topolo.app"];
             readonly routes: readonly [];
-            readonly serviceId: "socialize";
+            readonly appId: "socialize";
         }, {
             readonly name: "topolo-socialize-api";
             readonly kind: "worker";
             readonly apiUrl: "https://socialize-api.topolo.app";
             readonly domains: readonly ["socialize-api.topolo.app"];
             readonly routes: readonly [];
-            readonly serviceId: null;
+            readonly appId: null;
         }, {
             readonly name: "topolo-socialize-scheduler";
             readonly kind: "worker";
             readonly apiUrl: null;
             readonly domains: readonly [];
             readonly routes: readonly [];
-            readonly serviceId: null;
+            readonly appId: null;
         }];
     };
     readonly spaces: {
@@ -1274,14 +1274,14 @@ declare const APPLICATIONS: {
             readonly apiUrl: "https://spaces.topolo.app";
             readonly domains: readonly ["spaces.topolo.app"];
             readonly routes: readonly [];
-            readonly serviceId: "spaces";
+            readonly appId: "spaces";
         }, {
             readonly name: "topolo-spaces-api";
             readonly kind: "worker";
             readonly apiUrl: null;
             readonly domains: readonly [];
             readonly routes: readonly [];
-            readonly serviceId: null;
+            readonly appId: null;
         }];
     };
     readonly status: {
@@ -1297,7 +1297,7 @@ declare const APPLICATIONS: {
             readonly apiUrl: "https://status.topolo.app";
             readonly domains: readonly ["status.topolo.app"];
             readonly routes: readonly [];
-            readonly serviceId: "status";
+            readonly appId: "status";
         }];
     };
     readonly success: {
@@ -1313,14 +1313,14 @@ declare const APPLICATIONS: {
             readonly apiUrl: "https://success.topolo.app";
             readonly domains: readonly ["success.topolo.app"];
             readonly routes: readonly ["success.topolo.app"];
-            readonly serviceId: "success";
+            readonly appId: "success";
         }, {
             readonly name: "topolo-success-api";
             readonly kind: "worker";
             readonly apiUrl: null;
             readonly domains: readonly [];
             readonly routes: readonly [];
-            readonly serviceId: null;
+            readonly appId: null;
         }];
     };
     readonly support: {
@@ -1336,14 +1336,14 @@ declare const APPLICATIONS: {
             readonly apiUrl: "https://support.topolo.app";
             readonly domains: readonly ["support.topolo.app"];
             readonly routes: readonly ["support.topolo.app/*"];
-            readonly serviceId: "support";
+            readonly appId: "support";
         }, {
             readonly name: "topolo-support-api";
             readonly kind: "worker";
             readonly apiUrl: null;
             readonly domains: readonly [];
             readonly routes: readonly [];
-            readonly serviceId: null;
+            readonly appId: null;
         }];
     };
     readonly survey: {
@@ -1359,14 +1359,14 @@ declare const APPLICATIONS: {
             readonly apiUrl: "https://survey.topolo.app";
             readonly domains: readonly ["survey.topolo.app"];
             readonly routes: readonly [];
-            readonly serviceId: "survey";
+            readonly appId: "survey";
         }, {
             readonly name: "topolo-survey-api";
             readonly kind: "worker";
             readonly apiUrl: null;
             readonly domains: readonly [];
             readonly routes: readonly [];
-            readonly serviceId: null;
+            readonly appId: null;
         }];
     };
     readonly voice: {
@@ -1382,14 +1382,14 @@ declare const APPLICATIONS: {
             readonly apiUrl: "https://voice.topolo.app";
             readonly domains: readonly ["voice.topolo.app"];
             readonly routes: readonly [];
-            readonly serviceId: "voice";
+            readonly appId: "voice";
         }, {
             readonly name: "topolo-voice-api";
             readonly kind: "worker";
             readonly apiUrl: null;
             readonly domains: readonly [];
             readonly routes: readonly [];
-            readonly serviceId: null;
+            readonly appId: null;
         }];
     };
     readonly web: {
@@ -1405,21 +1405,21 @@ declare const APPLICATIONS: {
             readonly apiUrl: null;
             readonly domains: readonly [];
             readonly routes: readonly [];
-            readonly serviceId: null;
+            readonly appId: null;
         }, {
             readonly name: "topolo-web-runtime";
             readonly kind: "worker";
             readonly apiUrl: "https://sites.topolo.app";
             readonly domains: readonly ["sites.topolo.app"];
             readonly routes: readonly ["*.sites.topolo.app/*", "sites.topolo.app"];
-            readonly serviceId: null;
+            readonly appId: null;
         }, {
             readonly name: "topolo-web-studio";
             readonly kind: "worker";
             readonly apiUrl: "https://web.topolo.app";
             readonly domains: readonly ["web.topolo.app"];
             readonly routes: readonly [];
-            readonly serviceId: "web";
+            readonly appId: "web";
         }];
     };
 };
@@ -1492,9 +1492,9 @@ declare const APPLICATION_REQUIREMENTS: readonly [{
 }, {
     readonly id: "shared-auth-boundary";
     readonly title: "Use the shared Topolo auth boundary";
-    readonly summary: "Applications must derive identity, organization, scopes, and service entitlement from TopoloAuth rather than inventing parallel auth state.";
+    readonly summary: "Applications must derive identity, organization, scopes, and app entitlement from TopoloAuth rather than inventing parallel auth state.";
     readonly appliesTo: readonly ["browser", "api", "tooling", "agent_surface"];
-    readonly evidence: readonly ["@topolo/auth-client or @topolo-io/worker-runtime is used where applicable", "No public command, tool, or SDK method accepts orgId", "Service slug and Auth service registration are documented for protected services"];
+    readonly evidence: readonly ["@topolo/auth-client or @topolo-io/worker-runtime is used where applicable", "No public command, tool, or SDK method accepts orgId", "App slug and Auth app registration are documented for protected APIs"];
     readonly implementation: readonly ["Use shared auth/runtime packages instead of copying token parsing, gateway, or browser storage flows", "Derive organization from the credential on every request", "Route OAuth, refresh, logout, and SSO paths according to the shared Auth contract"];
 }, {
     readonly id: "shared-shell-and-launcher";
@@ -1504,12 +1504,12 @@ declare const APPLICATION_REQUIREMENTS: readonly [{
     readonly evidence: readonly ["@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"];
     readonly implementation: readonly ["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"];
 }, {
-    readonly id: "service-registration-and-scopes";
-    readonly title: "Register protected APIs as platform services";
-    readonly summary: "Callable app APIs need a stable service ID, service slug, permissions, role bundles, and API-key scopes before agents or users rely on them.";
+    readonly id: "app-registration-and-scopes";
+    readonly title: "Register protected APIs as platform apps";
+    readonly summary: "Callable app APIs need a stable app ID, app slug, permissions, role bundles, and API-key scopes before agents or users rely on them.";
     readonly appliesTo: readonly ["api"];
-    readonly evidence: readonly ["Auth service catalog contains the service ID and slug", "Permissions, role bundles, and API-key scopes exist for the service", "SDK, CLI, and MCP service discovery include the callable production API", "CloudControl production HTTP targets classify agent reachability with sdk_service_id or agent_callable:false"];
-    readonly implementation: readonly ["Add production Worker api_url metadata and sdk_service_id for every agent-callable API target", "Mark browser, documentation, and runtime-only Worker targets with agent_callable:false", "Expose stable service IDs through generated DEFAULT_SERVICE_URLS and live catalog discovery", "Keep typed SDK/CLI/MCP surfaces in sync when an API contract stabilizes"];
+    readonly evidence: readonly ["Auth app catalog contains the app ID and slug", "Permissions, role bundles, and API-key scopes exist for the app", "SDK, CLI, and MCP app discovery include the callable production API", "CloudControl production HTTP targets classify agent reachability with sdk_app_id or agent_callable:false"];
+    readonly implementation: readonly ["Add production Worker api_url metadata and sdk_app_id for every agent-callable API target", "Mark browser, documentation, and runtime-only Worker targets with agent_callable:false", "Expose stable app IDs through generated DEFAULT_APP_URLS and live catalog discovery", "Keep typed SDK/CLI/MCP surfaces in sync when an API contract stabilizes"];
 }, {
     readonly id: "organization-scoped-data";
     readonly title: "Keep application data organization-scoped";
@@ -1559,24 +1559,24 @@ declare function auditApplicationRequirements(applicationOrId: ApplicationCatalo
 declare function auditAllApplicationRequirements(applicationIds?: readonly ApplicationId[]): ApplicationRequirementsAuditReport;
 
 /**
- * Service registry — base URLs for every Topolo platform service.
+ * App API registry — base URLs for callable Topolo platform APIs.
  *
  * Source of truth lives in each app's `topolo.cloudcontrol.json`. The
- * `SERVICES` map is regenerated from those files via
+ * `APP_API_URLS` map is regenerated from those files via
  * `scripts/generate-services.mjs`; edit the JSON, not the generated file.
  *
  * Any entry can be overridden per-call via `TopoloClient` options, or globally
- * via env vars like `TOPOLO_SERVICE_URL_MAIL` or `TOPOLO_SERVICE_URL_WEB_API`
- * (dots in service IDs become underscores in env vars).
+ * via env vars like `TOPOLO_APP_URL_MAIL` or `TOPOLO_APP_URL_WEB_API`
+ * (dots in app API keys become underscores in env vars).
  *
  * IMPORTANT: The SDK NEVER accepts `orgId` as a parameter. Every request is
  * scoped to the organization embedded in the auth credential (JWT claim or
  * API-key binding). This is the load-bearing cross-org isolation guarantee.
  */
 
-declare const DEFAULT_SERVICE_URLS: Record<ServiceId, string>;
+declare const DEFAULT_APP_URLS: Record<AppApiId, string>;
 interface ServiceCatalogUrlEntry {
-    serviceId?: string | null;
+    appId?: string | null;
     slug?: string | null;
     name?: string | null;
     apiBaseUrl?: string | null;
@@ -1586,9 +1586,9 @@ interface ServiceCatalogUrlEntry {
 }
 declare function resolveCatalogServiceUrl(entry: ServiceCatalogUrlEntry, options?: {
     serviceKey?: string;
-    overrides?: Record<string, string> | Partial<Record<ServiceId, string>>;
+    overrides?: Record<string, string> | Partial<Record<AppApiId, string>>;
 }): string | null;
-declare function resolveServiceUrl(service: ServiceId, overrides?: Partial<Record<ServiceId, string>>): string;
+declare function resolveServiceUrl(service: AppApiId, overrides?: Partial<Record<AppApiId, string>>): string;
 
 declare class TopoloSdkError extends Error {
     readonly code: string;
@@ -1668,7 +1668,6 @@ interface P2PCapability {
     capability_id: string;
     publisher_org_id: string;
     app_id: string;
-    service_id: string;
     name: string;
     description: string;
     category: string;
@@ -1687,7 +1686,6 @@ interface PublishCapabilityInput {
     capability_id: string;
     publisher_org_id: string;
     app_id: string;
-    service_id: string;
     name: string;
     description: string;
     category: string;
@@ -1906,7 +1904,7 @@ interface TokenResponse {
 }
 interface OAuthHelperOptions {
     /** Overrides for TopoloAuth URL. Staging/dev should pass a mapping. */
-    serviceUrls?: Partial<Record<ServiceId, string>>;
+    serviceUrls?: Partial<Record<AppApiId, string>>;
     /** Injected fetch. Defaults to global fetch. */
     fetch?: typeof fetch;
 }
@@ -1961,7 +1959,7 @@ declare const TOPOLO_WIDGET_ENDPOINT = "/api/widget";
 declare const TOPOLO_WIDGET_REFRESH_INTERVAL_MS = 60000;
 type TopoloWidgetType = "stats" | "recent-activity" | "quick-actions" | "notifications" | "chart";
 interface TopoloWidgetBase {
-    serviceId: string;
+    appId: string;
     serviceName: string;
     serviceIcon?: string;
     type: TopoloWidgetType;
@@ -2046,7 +2044,7 @@ interface TopoloChartWidget extends TopoloWidgetBase {
     };
 }
 type TopoloWidget = TopoloStatsWidget | TopoloRecentActivityWidget | TopoloQuickActionsWidget | TopoloNotificationsWidget | TopoloChartWidget;
-type TopoloWidgetWithOptionalMetadata<T extends TopoloWidget> = Omit<T, "serviceId" | "serviceName" | "lastUpdated"> & Partial<Pick<TopoloWidgetBase, "serviceId" | "serviceName" | "lastUpdated">>;
+type TopoloWidgetWithOptionalMetadata<T extends TopoloWidget> = Omit<T, "appId" | "serviceName" | "lastUpdated"> & Partial<Pick<TopoloWidgetBase, "appId" | "serviceName" | "lastUpdated">>;
 type TopoloWidgetDraft = TopoloWidget extends infer Widget ? Widget extends TopoloWidget ? TopoloWidgetWithOptionalMetadata<Widget> : never : never;
 interface TopoloWidgetApiResponse {
     success: boolean;
@@ -2054,7 +2052,7 @@ interface TopoloWidgetApiResponse {
     error?: string;
 }
 interface TopoloWidgetResponseOptions {
-    serviceId: string;
+    appId: string;
     serviceName: string;
     widgets: TopoloWidgetDraft[];
     now?: Date | string;
@@ -2064,7 +2062,7 @@ interface TopoloWidgetValidationResult {
     errors: string[];
 }
 interface TopoloWidgetConfig {
-    serviceId: string;
+    appId: string;
     serviceName: string;
     baseUrl: string;
     widgetEndpoint: string;
@@ -2076,7 +2074,7 @@ declare function defineTopoloRecentActivityWidget(widget: Omit<TopoloRecentActiv
 declare function defineTopoloQuickActionsWidget(widget: Omit<TopoloQuickActionsWidget, "type">): TopoloQuickActionsWidget;
 declare function defineTopoloNotificationsWidget(widget: Omit<TopoloNotificationsWidget, "type">): TopoloNotificationsWidget;
 declare function defineTopoloChartWidget(widget: Omit<TopoloChartWidget, "type">): TopoloChartWidget;
-declare function createTopoloWidgetResponse({ serviceId, serviceName, widgets, now, }: TopoloWidgetResponseOptions): TopoloWidgetApiResponse;
+declare function createTopoloWidgetResponse({ appId, serviceName, widgets, now, }: TopoloWidgetResponseOptions): TopoloWidgetApiResponse;
 declare function createTopoloWidgetError(error: string): TopoloWidgetApiResponse;
 declare function validateTopoloWidgetResponse(response: unknown): TopoloWidgetValidationResult;
 
@@ -2094,4 +2092,4 @@ declare function createTopolo(options: TopoloClientOptions): {
 };
 type Topolo = ReturnType<typeof createTopolo>;
 
-export { APPLICATIONS, APPLICATION_REQUIREMENTS, APPLICATION_REQUIREMENTS_VERSION, type AgentIdentity, type ApplicationCatalogEntry, type ApplicationDeployTarget, type ApplicationId, type ApplicationRequirement, type ApplicationRequirementAudit, type ApplicationRequirementFinding, type ApplicationRequirementMigrationItem, type ApplicationRequirementScope, type ApplicationRequirementScore, type ApplicationRequirementStatus, type ApplicationRequirementsAuditReport, type CredentialIntrospection, type CrmContactSummary, CrmModule, DEFAULT_SERVICE_URLS, type DeviceAuthorizationResponse, IdentityModule, type ListContactsOptions, type ListContactsResult, type OAuthHelperOptions, type P2PActionDetail, type P2PActionRequestInput, type P2PActionRequestResult, type P2PActionRow, type P2PActionRun, type P2PCapability, type P2PConnection, type P2PHold, type P2PLedgerEntry, P2PModule, type P2PPolicy, type P2PPricingModel, type P2PSettlementBatch, type P2PSettlementGroup, type PublishCapabilityInput, type RequestOptions, type ServiceCatalogUrlEntry, type ServiceId, TOPOLO_WIDGET_ENDPOINT, TOPOLO_WIDGET_REFRESH_INTERVAL_MS, type TokenResponse, type Topolo, type TopoloActionCatalogEntry, type TopoloApiKeyResourceMetadata, TopoloAuthError, type TopoloChartWidget, TopoloClient, type TopoloClientOptions, type TopoloCredential, type TopoloDebugEvent, TopoloHttpError, type TopoloNotificationsWidget, TopoloOAuth, TopoloPermissionError, type TopoloQuickActionsWidget, type TopoloRecentActivityWidget, TopoloSdkError, type TopoloServiceCatalogEntry, type TopoloStatsWidget, type TopoloWidget, type TopoloWidgetActionItem, type TopoloWidgetActivityItem, type TopoloWidgetApiResponse, type TopoloWidgetBase, type TopoloWidgetConfig, type TopoloWidgetDraft, type TopoloWidgetMetric, type TopoloWidgetNotificationItem, type TopoloWidgetResponseOptions, type TopoloWidgetSnapshotMetadata, type TopoloWidgetSnapshotMetric, type TopoloWidgetType, type TopoloWidgetValidationResult, applicationRequirementScopes, auditAllApplicationRequirements, auditApplicationRequirements, createTopolo, createTopoloWidgetError, createTopoloWidgetResponse, defineTopoloChartWidget, defineTopoloNotificationsWidget, defineTopoloQuickActionsWidget, defineTopoloRecentActivityWidget, defineTopoloStatsWidget, requirementsForApplication, resolveCatalogServiceUrl, resolveServiceUrl, validateTopoloWidgetResponse };
+export { APPLICATIONS, APPLICATION_REQUIREMENTS, APPLICATION_REQUIREMENTS_VERSION, type AgentIdentity, type AppApiId, type ApplicationCatalogEntry, type ApplicationDeployTarget, type ApplicationId, type ApplicationRequirement, type ApplicationRequirementAudit, type ApplicationRequirementFinding, type ApplicationRequirementMigrationItem, type ApplicationRequirementScope, type ApplicationRequirementScore, type ApplicationRequirementStatus, type ApplicationRequirementsAuditReport, type CredentialIntrospection, type CrmContactSummary, CrmModule, DEFAULT_APP_URLS, type DeviceAuthorizationResponse, IdentityModule, type ListContactsOptions, type ListContactsResult, type OAuthHelperOptions, type P2PActionDetail, type P2PActionRequestInput, type P2PActionRequestResult, type P2PActionRow, type P2PActionRun, type P2PCapability, type P2PConnection, type P2PHold, type P2PLedgerEntry, P2PModule, type P2PPolicy, type P2PPricingModel, type P2PSettlementBatch, type P2PSettlementGroup, type PublishCapabilityInput, type RequestOptions, type ServiceCatalogUrlEntry, TOPOLO_WIDGET_ENDPOINT, TOPOLO_WIDGET_REFRESH_INTERVAL_MS, type TokenResponse, type Topolo, type TopoloActionCatalogEntry, type TopoloApiKeyResourceMetadata, TopoloAuthError, type TopoloChartWidget, TopoloClient, type TopoloClientOptions, type TopoloCredential, type TopoloDebugEvent, TopoloHttpError, type TopoloNotificationsWidget, TopoloOAuth, TopoloPermissionError, type TopoloQuickActionsWidget, type TopoloRecentActivityWidget, TopoloSdkError, type TopoloServiceCatalogEntry, type TopoloStatsWidget, type TopoloWidget, type TopoloWidgetActionItem, type TopoloWidgetActivityItem, type TopoloWidgetApiResponse, type TopoloWidgetBase, type TopoloWidgetConfig, type TopoloWidgetDraft, type TopoloWidgetMetric, type TopoloWidgetNotificationItem, type TopoloWidgetResponseOptions, type TopoloWidgetSnapshotMetadata, type TopoloWidgetSnapshotMetric, type TopoloWidgetType, type TopoloWidgetValidationResult, applicationRequirementScopes, auditAllApplicationRequirements, auditApplicationRequirements, createTopolo, createTopoloWidgetError, createTopoloWidgetResponse, defineTopoloChartWidget, defineTopoloNotificationsWidget, defineTopoloQuickActionsWidget, defineTopoloRecentActivityWidget, defineTopoloStatsWidget, requirementsForApplication, resolveCatalogServiceUrl, resolveServiceUrl, validateTopoloWidgetResponse };