@topolo/sdk 0.4.9 → 0.5.0

package/dist/index.d.cts

@@ -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,7 +133,7 @@ interface TopoloActionCatalogEntry {
     toolName: string | null;
     title: string;
     description: string;
-    serviceId: string;
+    appId: string;
     serviceSlug: string | null;
     serviceName: string | null;
     method: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
@@ -145,6 +145,8 @@ interface TopoloActionCatalogEntry {
     readOnly: boolean;
     destructive: boolean;
     requiresConfirmation: boolean;
+    /** Agent access tier. null/absent when the catalog does not specify one (consumers derive a default). */
+    agentAccess?: 'auto' | 'confirm' | 'off' | null;
     status: string | null;
     sourceRevision: string | null;
 }
@@ -152,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;
@@ -160,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;
     /**
@@ -182,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
@@ -193,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
@@ -206,8 +208,9 @@ declare class TopoloClient {
      */
     listServices(): Promise<TopoloServiceCatalogEntry[]>;
     /**
-     * List callable actions from the live Auth catalog. The response is scoped to
-     * the caller's organization and effective permissions; no bundled/static app
+     * List callable actions from the live registry-canonical catalog (definitions
+     * from the Catalog registry, scoping from Auth). The response is scoped to the
+     * caller's organization and effective permissions; no bundled/static app
      * action list is used as an authorization source.
      */
     listActions(options?: {
@@ -314,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: {
@@ -337,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: {
@@ -360,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: {
@@ -376,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: {
@@ -392,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: {
@@ -415,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: {
@@ -431,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: {
@@ -454,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: {
@@ -477,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: {
@@ -493,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: {
@@ -516,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: {
@@ -553,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: {
@@ -576,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: {
@@ -599,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: {
@@ -622,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: {
@@ -652,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: {
@@ -675,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: {
@@ -698,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: {
@@ -728,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: {
@@ -751,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: {
@@ -774,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: {
@@ -797,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: {
@@ -820,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: {
@@ -843,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: {
@@ -866,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: {
@@ -889,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: {
@@ -905,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: {
@@ -928,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: {
@@ -951,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: {
@@ -981,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: {
@@ -1004,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: {
@@ -1020,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: {
@@ -1036,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: {
@@ -1066,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: {
@@ -1089,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: {
@@ -1112,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: {
@@ -1135,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: {
@@ -1165,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: {
@@ -1188,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: {
@@ -1211,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: {
@@ -1241,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: {
@@ -1271,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: {
@@ -1294,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: {
@@ -1310,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: {
@@ -1333,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: {
@@ -1356,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: {
@@ -1379,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: {
@@ -1402,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";
         }];
     };
 };
@@ -1573,7 +1576,7 @@ declare function auditAllApplicationRequirements(applicationIds?: readonly Appli
 
 declare const DEFAULT_SERVICE_URLS: Record<ServiceId, string>;
 interface ServiceCatalogUrlEntry {
-    serviceId?: string | null;
+    appId?: string | null;
     slug?: string | null;
     name?: string | null;
     apiBaseUrl?: string | null;
@@ -1665,7 +1668,6 @@ interface P2PCapability {
     capability_id: string;
     publisher_org_id: string;
     app_id: string;
-    service_id: string;
     name: string;
     description: string;
     category: string;
@@ -1684,7 +1686,6 @@ interface PublishCapabilityInput {
     capability_id: string;
     publisher_org_id: string;
     app_id: string;
-    service_id: string;
     name: string;
     description: string;
     category: string;
@@ -1958,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;
@@ -2043,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;
@@ -2051,7 +2052,7 @@ interface TopoloWidgetApiResponse {
     error?: string;
 }
 interface TopoloWidgetResponseOptions {
-    serviceId: string;
+    appId: string;
     serviceName: string;
     widgets: TopoloWidgetDraft[];
     now?: Date | string;
@@ -2061,7 +2062,7 @@ interface TopoloWidgetValidationResult {
     errors: string[];
 }
 interface TopoloWidgetConfig {
-    serviceId: string;
+    appId: string;
     serviceName: string;
     baseUrl: string;
     widgetEndpoint: string;
@@ -2073,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;