@topolo/sdk 0.4.10 → 0.6.0

package/dist/index.cjs

@@ -24,7 +24,7 @@ __export(index_exports, {
   APPLICATION_REQUIREMENTS: () => APPLICATION_REQUIREMENTS,
   APPLICATION_REQUIREMENTS_VERSION: () => APPLICATION_REQUIREMENTS_VERSION,
   CrmModule: () => CrmModule,
-  DEFAULT_SERVICE_URLS: () => DEFAULT_SERVICE_URLS,
+  DEFAULT_APP_URLS: () => DEFAULT_APP_URLS,
   IdentityModule: () => IdentityModule,
   P2PModule: () => P2PModule,
   TOPOLO_WIDGET_ENDPOINT: () => TOPOLO_WIDGET_ENDPOINT,
@@ -112,7 +112,7 @@ var TopoloHttpError = class extends TopoloSdkError {
 };
 
 // src/services.generated.ts
-var SERVICES = {
+var APP_API_URLS = {
   agent: "https://agent.topolo.app",
   auth: "https://auth.topolo.app",
   backup: "https://backup.topolo.app",
@@ -180,7 +180,7 @@ var APPLICATIONS = {
           "admin.topolo.app"
         ],
         "routes": [],
-        "serviceId": null
+        "appId": null
       },
       {
         "name": "topolo-admin-api",
@@ -188,7 +188,7 @@ var APPLICATIONS = {
         "apiUrl": null,
         "domains": [],
         "routes": [],
-        "serviceId": null
+        "appId": null
       }
     ]
   },
@@ -210,7 +210,7 @@ var APPLICATIONS = {
           "agent.topolo.app"
         ],
         "routes": [],
-        "serviceId": "agent"
+        "appId": "agent"
       },
       {
         "name": "topolo-agent-api",
@@ -218,7 +218,7 @@ var APPLICATIONS = {
         "apiUrl": null,
         "domains": [],
         "routes": [],
-        "serviceId": null
+        "appId": null
       }
     ]
   },
@@ -242,7 +242,7 @@ var APPLICATIONS = {
         "routes": [
           "auth.topolo.app"
         ],
-        "serviceId": "auth"
+        "appId": "auth"
       }
     ]
   },
@@ -264,7 +264,7 @@ var APPLICATIONS = {
           "backup.topolo.app"
         ],
         "routes": [],
-        "serviceId": "backup"
+        "appId": "backup"
       }
     ]
   },
@@ -286,7 +286,7 @@ var APPLICATIONS = {
           "books.topolo.app"
         ],
         "routes": [],
-        "serviceId": "books"
+        "appId": "books"
       },
       {
         "name": "topolo-books-api",
@@ -294,7 +294,7 @@ var APPLICATIONS = {
         "apiUrl": null,
         "domains": [],
         "routes": [],
-        "serviceId": null
+        "appId": null
       }
     ]
   },
@@ -316,7 +316,7 @@ var APPLICATIONS = {
           "bugfix.topolo.app"
         ],
         "routes": [],
-        "serviceId": "bugfix"
+        "appId": "bugfix"
       }
     ]
   },
@@ -338,7 +338,7 @@ var APPLICATIONS = {
           "bytes.topolo.app"
         ],
         "routes": [],
-        "serviceId": "bytes"
+        "appId": "bytes"
       },
       {
         "name": "topolo-bytes-api",
@@ -346,7 +346,7 @@ var APPLICATIONS = {
         "apiUrl": null,
         "domains": [],
         "routes": [],
-        "serviceId": null
+        "appId": null
       }
     ]
   },
@@ -368,7 +368,7 @@ var APPLICATIONS = {
           "calendar.topolo.app"
         ],
         "routes": [],
-        "serviceId": "calendar"
+        "appId": "calendar"
       },
       {
         "name": "topolo-calendar-api",
@@ -376,7 +376,7 @@ var APPLICATIONS = {
         "apiUrl": null,
         "domains": [],
         "routes": [],
-        "serviceId": null
+        "appId": null
       }
     ]
   },
@@ -398,7 +398,7 @@ var APPLICATIONS = {
           "capacity.topolo.app"
         ],
         "routes": [],
-        "serviceId": "capacity"
+        "appId": "capacity"
       }
     ]
   },
@@ -420,7 +420,7 @@ var APPLICATIONS = {
           "chat.topolo.app"
         ],
         "routes": [],
-        "serviceId": "chat"
+        "appId": "chat"
       },
       {
         "name": "topolo-chat-api",
@@ -428,7 +428,7 @@ var APPLICATIONS = {
         "apiUrl": null,
         "domains": [],
         "routes": [],
-        "serviceId": null
+        "appId": null
       }
     ]
   },
@@ -448,7 +448,7 @@ var APPLICATIONS = {
         "apiUrl": null,
         "domains": [],
         "routes": [],
-        "serviceId": null
+        "appId": null
       },
       {
         "name": "topolo-commerce-guest-web",
@@ -458,7 +458,7 @@ var APPLICATIONS = {
           "guest.topolo.app"
         ],
         "routes": [],
-        "serviceId": null
+        "appId": null
       },
       {
         "name": "topolo-commerce-ops-web",
@@ -468,7 +468,7 @@ var APPLICATIONS = {
           "commerce.topolo.app"
         ],
         "routes": [],
-        "serviceId": "commerce"
+        "appId": "commerce"
       },
       {
         "name": "topolo-commerce-station-web",
@@ -478,7 +478,7 @@ var APPLICATIONS = {
           "station-commerce.topolo.app"
         ],
         "routes": [],
-        "serviceId": null
+        "appId": null
       }
     ]
   },
@@ -500,7 +500,7 @@ var APPLICATIONS = {
           "compose.topolo.app"
         ],
         "routes": [],
-        "serviceId": "compose"
+        "appId": "compose"
       },
       {
         "name": "topolo-compose-api",
@@ -508,7 +508,7 @@ var APPLICATIONS = {
         "apiUrl": null,
         "domains": [],
         "routes": [],
-        "serviceId": null
+        "appId": null
       }
     ]
   },
@@ -530,7 +530,7 @@ var APPLICATIONS = {
           "consent.topolo.app"
         ],
         "routes": [],
-        "serviceId": "consent"
+        "appId": "consent"
       },
       {
         "name": "topolo-consent-api",
@@ -538,7 +538,7 @@ var APPLICATIONS = {
         "apiUrl": null,
         "domains": [],
         "routes": [],
-        "serviceId": null
+        "appId": null
       }
     ]
   },
@@ -558,7 +558,7 @@ var APPLICATIONS = {
         "apiUrl": null,
         "domains": [],
         "routes": [],
-        "serviceId": null
+        "appId": null
       },
       {
         "name": "topolo-crm-app",
@@ -568,7 +568,7 @@ var APPLICATIONS = {
           "crm.topolo.app"
         ],
         "routes": [],
-        "serviceId": "crm"
+        "appId": "crm"
       }
     ]
   },
@@ -588,7 +588,7 @@ var APPLICATIONS = {
         "apiUrl": null,
         "domains": [],
         "routes": [],
-        "serviceId": null
+        "appId": null
       },
       {
         "name": "topolo-developers",
@@ -598,7 +598,7 @@ var APPLICATIONS = {
           "developers.topolo.app"
         ],
         "routes": [],
-        "serviceId": "developers"
+        "appId": "developers"
       },
       {
         "name": "topolo-developers-api",
@@ -606,7 +606,7 @@ var APPLICATIONS = {
         "apiUrl": null,
         "domains": [],
         "routes": [],
-        "serviceId": null
+        "appId": null
       }
     ]
   },
@@ -628,7 +628,7 @@ var APPLICATIONS = {
           "director.topolo.app"
         ],
         "routes": [],
-        "serviceId": "director"
+        "appId": "director"
       },
       {
         "name": "topolo-director-api",
@@ -636,7 +636,7 @@ var APPLICATIONS = {
         "apiUrl": null,
         "domains": [],
         "routes": [],
-        "serviceId": null
+        "appId": null
       }
     ]
   },
@@ -656,7 +656,7 @@ var APPLICATIONS = {
           "docs.topolo.app"
         ],
         "routes": [],
-        "serviceId": null
+        "appId": null
       },
       {
         "name": "topolo-docs-api",
@@ -664,7 +664,7 @@ var APPLICATIONS = {
         "apiUrl": null,
         "domains": [],
         "routes": [],
-        "serviceId": null
+        "appId": null
       }
     ]
   },
@@ -686,7 +686,7 @@ var APPLICATIONS = {
           "feed-analytics-api.topolo.app"
         ],
         "routes": [],
-        "serviceId": null
+        "appId": null
       },
       {
         "name": "topolo-feed-api",
@@ -696,7 +696,7 @@ var APPLICATIONS = {
           "feed-api.topolo.app"
         ],
         "routes": [],
-        "serviceId": null
+        "appId": null
       },
       {
         "name": "topolo-feed-web",
@@ -706,7 +706,7 @@ var APPLICATIONS = {
           "feed.topolo.app"
         ],
         "routes": [],
-        "serviceId": "feed"
+        "appId": "feed"
       }
     ]
   },
@@ -728,7 +728,7 @@ var APPLICATIONS = {
           "flow.topolo.app"
         ],
         "routes": [],
-        "serviceId": "flow"
+        "appId": "flow"
       },
       {
         "name": "topolo-flow-api",
@@ -736,7 +736,7 @@ var APPLICATIONS = {
         "apiUrl": null,
         "domains": [],
         "routes": [],
-        "serviceId": null
+        "appId": null
       }
     ]
   },
@@ -758,7 +758,7 @@ var APPLICATIONS = {
           "forecast.topolo.app"
         ],
         "routes": [],
-        "serviceId": "forecast"
+        "appId": "forecast"
       },
       {
         "name": "topolo-forecast-api",
@@ -766,7 +766,7 @@ var APPLICATIONS = {
         "apiUrl": null,
         "domains": [],
         "routes": [],
-        "serviceId": null
+        "appId": null
       }
     ]
   },
@@ -788,7 +788,7 @@ var APPLICATIONS = {
           "forms.topolo.app"
         ],
         "routes": [],
-        "serviceId": "forms"
+        "appId": "forms"
       },
       {
         "name": "topolo-forms-api",
@@ -796,7 +796,7 @@ var APPLICATIONS = {
         "apiUrl": null,
         "domains": [],
         "routes": [],
-        "serviceId": null
+        "appId": null
       }
     ]
   },
@@ -818,7 +818,7 @@ var APPLICATIONS = {
           "home.topolo.app"
         ],
         "routes": [],
-        "serviceId": "home"
+        "appId": "home"
       },
       {
         "name": "topolo-home-api",
@@ -826,7 +826,7 @@ var APPLICATIONS = {
         "apiUrl": null,
         "domains": [],
         "routes": [],
-        "serviceId": null
+        "appId": null
       }
     ]
   },
@@ -848,7 +848,7 @@ var APPLICATIONS = {
           "insights.topolo.app"
         ],
         "routes": [],
-        "serviceId": "insights"
+        "appId": "insights"
       },
       {
         "name": "topolo-insights-api",
@@ -856,7 +856,7 @@ var APPLICATIONS = {
         "apiUrl": null,
         "domains": [],
         "routes": [],
-        "serviceId": null
+        "appId": null
       }
     ]
   },
@@ -878,7 +878,7 @@ var APPLICATIONS = {
           "inventory.topolo.app"
         ],
         "routes": [],
-        "serviceId": "inventory"
+        "appId": "inventory"
       },
       {
         "name": "topolo-inventory-api",
@@ -886,7 +886,7 @@ var APPLICATIONS = {
         "apiUrl": null,
         "domains": [],
         "routes": [],
-        "serviceId": null
+        "appId": null
       }
     ]
   },
@@ -908,7 +908,7 @@ var APPLICATIONS = {
           "learn.topolo.app"
         ],
         "routes": [],
-        "serviceId": "learn"
+        "appId": "learn"
       },
       {
         "name": "topolo-learn-api",
@@ -916,7 +916,7 @@ var APPLICATIONS = {
         "apiUrl": null,
         "domains": [],
         "routes": [],
-        "serviceId": null
+        "appId": null
       }
     ]
   },
@@ -940,7 +940,7 @@ var APPLICATIONS = {
         "routes": [
           "localize.topolo.app"
         ],
-        "serviceId": "localize"
+        "appId": "localize"
       }
     ]
   },
@@ -962,7 +962,7 @@ var APPLICATIONS = {
           "mail.topolo.app"
         ],
         "routes": [],
-        "serviceId": "mail"
+        "appId": "mail"
       },
       {
         "name": "topolo-mail-api",
@@ -970,7 +970,7 @@ var APPLICATIONS = {
         "apiUrl": null,
         "domains": [],
         "routes": [],
-        "serviceId": null
+        "appId": null
       }
     ]
   },
@@ -990,7 +990,7 @@ var APPLICATIONS = {
         "apiUrl": null,
         "domains": [],
         "routes": [],
-        "serviceId": null
+        "appId": null
       },
       {
         "name": "topolo-mdm-console",
@@ -1000,7 +1000,7 @@ var APPLICATIONS = {
           "mdm.topolo.app"
         ],
         "routes": [],
-        "serviceId": "mdm"
+        "appId": "mdm"
       }
     ]
   },
@@ -1022,7 +1022,7 @@ var APPLICATIONS = {
           "messages.topolo.app"
         ],
         "routes": [],
-        "serviceId": "messages"
+        "appId": "messages"
       },
       {
         "name": "topolo-messages-api",
@@ -1030,7 +1030,7 @@ var APPLICATIONS = {
         "apiUrl": null,
         "domains": [],
         "routes": [],
-        "serviceId": null
+        "appId": null
       },
       {
         "name": "topolo-messages-dispatch",
@@ -1038,7 +1038,7 @@ var APPLICATIONS = {
         "apiUrl": null,
         "domains": [],
         "routes": [],
-        "serviceId": null
+        "appId": null
       }
     ]
   },
@@ -1060,7 +1060,7 @@ var APPLICATIONS = {
           "nexus.topolo.app"
         ],
         "routes": [],
-        "serviceId": null
+        "appId": null
       },
       {
         "name": "topolo-nexus-gateway",
@@ -1070,7 +1070,7 @@ var APPLICATIONS = {
           "nexus.topolo.app"
         ],
         "routes": [],
-        "serviceId": "nexus"
+        "appId": "nexus"
       }
     ]
   },
@@ -1094,7 +1094,7 @@ var APPLICATIONS = {
         "routes": [
           "notify.topolo.app"
         ],
-        "serviceId": "notify"
+        "appId": "notify"
       }
     ]
   },
@@ -1116,7 +1116,7 @@ var APPLICATIONS = {
           "observability-watch.topolo.app"
         ],
         "routes": [],
-        "serviceId": "observability_watch"
+        "appId": "observability_watch"
       }
     ]
   },
@@ -1140,7 +1140,7 @@ var APPLICATIONS = {
         "routes": [
           "one.topolo.app/*"
         ],
-        "serviceId": null
+        "appId": null
       },
       {
         "name": "topolo-one-api",
@@ -1152,7 +1152,7 @@ var APPLICATIONS = {
         "routes": [
           "www.topolo.app/*"
         ],
-        "serviceId": "one"
+        "appId": "one"
       },
       {
         "name": "topolo-one-website",
@@ -1165,7 +1165,7 @@ var APPLICATIONS = {
           "topolo.io",
           "www.topolo.io"
         ],
-        "serviceId": null
+        "appId": null
       }
     ]
   },
@@ -1187,7 +1187,7 @@ var APPLICATIONS = {
           "p2p.topolo.app"
         ],
         "routes": [],
-        "serviceId": "p2p"
+        "appId": "p2p"
       },
       {
         "name": "topolo-p2p-api",
@@ -1195,7 +1195,7 @@ var APPLICATIONS = {
         "apiUrl": null,
         "domains": [],
         "routes": [],
-        "serviceId": null
+        "appId": null
       }
     ]
   },
@@ -1217,7 +1217,7 @@ var APPLICATIONS = {
           "pay.topolo.app"
         ],
         "routes": [],
-        "serviceId": "pay"
+        "appId": "pay"
       },
       {
         "name": "topolo-pay-api",
@@ -1225,7 +1225,7 @@ var APPLICATIONS = {
         "apiUrl": null,
         "domains": [],
         "routes": [],
-        "serviceId": null
+        "appId": null
       }
     ]
   },
@@ -1247,7 +1247,7 @@ var APPLICATIONS = {
           "people.topolo.app"
         ],
         "routes": [],
-        "serviceId": "people"
+        "appId": "people"
       },
       {
         "name": "topolo-people-api",
@@ -1255,7 +1255,7 @@ var APPLICATIONS = {
         "apiUrl": null,
         "domains": [],
         "routes": [],
-        "serviceId": null
+        "appId": null
       }
     ]
   },
@@ -1280,7 +1280,7 @@ var APPLICATIONS = {
         "routes": [
           "api.ol0.me/*"
         ],
-        "serviceId": "quro.api"
+        "appId": "quro.api"
       },
       {
         "name": "quro-redirect-system",
@@ -1292,7 +1292,7 @@ var APPLICATIONS = {
         "routes": [
           "ol0.me/*"
         ],
-        "serviceId": "quro.redirect"
+        "appId": "quro.redirect"
       },
       {
         "name": "quro-ui",
@@ -1302,7 +1302,7 @@ var APPLICATIONS = {
           "quro.topolo.app"
         ],
         "routes": [],
-        "serviceId": null
+        "appId": null
       }
     ]
   },
@@ -1324,7 +1324,7 @@ var APPLICATIONS = {
           "roadmapper.topolo.app"
         ],
         "routes": [],
-        "serviceId": "roadmapper"
+        "appId": "roadmapper"
       },
       {
         "name": "topolo-roadmapper-api",
@@ -1332,7 +1332,7 @@ var APPLICATIONS = {
         "apiUrl": null,
         "domains": [],
         "routes": [],
-        "serviceId": null
+        "appId": null
       }
     ]
   },
@@ -1354,7 +1354,7 @@ var APPLICATIONS = {
           "sign.topolo.app"
         ],
         "routes": [],
-        "serviceId": "sign"
+        "appId": "sign"
       },
       {
         "name": "topolo-sign-api",
@@ -1362,7 +1362,7 @@ var APPLICATIONS = {
         "apiUrl": null,
         "domains": [],
         "routes": [],
-        "serviceId": null
+        "appId": null
       }
     ]
   },
@@ -1384,7 +1384,7 @@ var APPLICATIONS = {
           "studio.topolo.app"
         ],
         "routes": [],
-        "serviceId": "social_studio"
+        "appId": "social_studio"
       },
       {
         "name": "topolo-social-studio-api",
@@ -1392,7 +1392,7 @@ var APPLICATIONS = {
         "apiUrl": null,
         "domains": [],
         "routes": [],
-        "serviceId": null
+        "appId": null
       },
       {
         "name": "topolo-social-studio-queue",
@@ -1400,7 +1400,7 @@ var APPLICATIONS = {
         "apiUrl": null,
         "domains": [],
         "routes": [],
-        "serviceId": null
+        "appId": null
       }
     ]
   },
@@ -1422,7 +1422,7 @@ var APPLICATIONS = {
           "socialize.topolo.app"
         ],
         "routes": [],
-        "serviceId": "socialize"
+        "appId": "socialize"
       },
       {
         "name": "topolo-socialize-api",
@@ -1432,7 +1432,7 @@ var APPLICATIONS = {
           "socialize-api.topolo.app"
         ],
         "routes": [],
-        "serviceId": null
+        "appId": null
       },
       {
         "name": "topolo-socialize-scheduler",
@@ -1440,7 +1440,7 @@ var APPLICATIONS = {
         "apiUrl": null,
         "domains": [],
         "routes": [],
-        "serviceId": null
+        "appId": null
       }
     ]
   },
@@ -1462,7 +1462,7 @@ var APPLICATIONS = {
           "spaces.topolo.app"
         ],
         "routes": [],
-        "serviceId": "spaces"
+        "appId": "spaces"
       },
       {
         "name": "topolo-spaces-api",
@@ -1470,7 +1470,7 @@ var APPLICATIONS = {
         "apiUrl": null,
         "domains": [],
         "routes": [],
-        "serviceId": null
+        "appId": null
       }
     ]
   },
@@ -1492,7 +1492,7 @@ var APPLICATIONS = {
           "status.topolo.app"
         ],
         "routes": [],
-        "serviceId": "status"
+        "appId": "status"
       }
     ]
   },
@@ -1516,7 +1516,7 @@ var APPLICATIONS = {
         "routes": [
           "success.topolo.app"
         ],
-        "serviceId": "success"
+        "appId": "success"
       },
       {
         "name": "topolo-success-api",
@@ -1524,7 +1524,7 @@ var APPLICATIONS = {
         "apiUrl": null,
         "domains": [],
         "routes": [],
-        "serviceId": null
+        "appId": null
       }
     ]
   },
@@ -1548,7 +1548,7 @@ var APPLICATIONS = {
         "routes": [
           "support.topolo.app/*"
         ],
-        "serviceId": "support"
+        "appId": "support"
       },
       {
         "name": "topolo-support-api",
@@ -1556,7 +1556,7 @@ var APPLICATIONS = {
         "apiUrl": null,
         "domains": [],
         "routes": [],
-        "serviceId": null
+        "appId": null
       }
     ]
   },
@@ -1578,7 +1578,7 @@ var APPLICATIONS = {
           "survey.topolo.app"
         ],
         "routes": [],
-        "serviceId": "survey"
+        "appId": "survey"
       },
       {
         "name": "topolo-survey-api",
@@ -1586,7 +1586,7 @@ var APPLICATIONS = {
         "apiUrl": null,
         "domains": [],
         "routes": [],
-        "serviceId": null
+        "appId": null
       }
     ]
   },
@@ -1608,7 +1608,7 @@ var APPLICATIONS = {
           "voice.topolo.app"
         ],
         "routes": [],
-        "serviceId": "voice"
+        "appId": "voice"
       },
       {
         "name": "topolo-voice-api",
@@ -1616,7 +1616,7 @@ var APPLICATIONS = {
         "apiUrl": null,
         "domains": [],
         "routes": [],
-        "serviceId": null
+        "appId": null
       }
     ]
   },
@@ -1636,7 +1636,7 @@ var APPLICATIONS = {
         "apiUrl": null,
         "domains": [],
         "routes": [],
-        "serviceId": null
+        "appId": null
       },
       {
         "name": "topolo-web-runtime",
@@ -1649,7 +1649,7 @@ var APPLICATIONS = {
           "*.sites.topolo.app/*",
           "sites.topolo.app"
         ],
-        "serviceId": null
+        "appId": null
       },
       {
         "name": "topolo-web-studio",
@@ -1659,7 +1659,7 @@ var APPLICATIONS = {
           "web.topolo.app"
         ],
         "routes": [],
-        "serviceId": "web"
+        "appId": "web"
       }
     ]
   }
@@ -1703,12 +1703,12 @@ var APPLICATION_REQUIREMENTS = [
   {
     id: "shared-auth-boundary",
     title: "Use the shared Topolo auth boundary",
-    summary: "Applications must derive identity, organization, scopes, and service entitlement from TopoloAuth rather than inventing parallel auth state.",
+    summary: "Applications must derive identity, organization, scopes, and app entitlement from TopoloAuth rather than inventing parallel auth state.",
     appliesTo: ["browser", "api", "tooling", "agent_surface"],
     evidence: [
       "@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"
+      "App slug and Auth app registration are documented for protected APIs"
     ],
     implementation: [
       "Use shared auth/runtime packages instead of copying token parsing, gateway, or browser storage flows",
@@ -1741,20 +1741,20 @@ var APPLICATION_REQUIREMENTS = [
     ]
   },
   {
-    id: "service-registration-and-scopes",
-    title: "Register protected APIs as platform services",
-    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.",
+    id: "app-registration-and-scopes",
+    title: "Register protected APIs as platform apps",
+    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.",
     appliesTo: ["api"],
     evidence: [
-      "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"
+      "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"
     ],
     implementation: [
-      "Add production Worker api_url metadata and sdk_service_id for every agent-callable API target",
+      "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 service IDs through generated DEFAULT_SERVICE_URLS and live catalog discovery",
+      "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"
     ]
   },
@@ -1863,7 +1863,7 @@ function applicationRequirementScopes(application) {
   const hasBrowserSurface = Boolean(application.productionUrl) || // String() keeps this guard valid after the Pages->Worker migration narrowed
   // the generated kind union to "worker" (no "pages" literal remains).
   application.deployTargets.some((target) => String(target.kind) === "pages");
-  const hasApiSurface = application.services.length > 0 || application.deployTargets.some((target) => Boolean(target.serviceId));
+  const hasApiSurface = application.services.length > 0 || application.deployTargets.some((target) => Boolean(target.appId));
   if (hasBrowserSurface) scopes.add("browser");
   if (hasApiSurface) scopes.add("api");
   if (appId === "cli" || appId === "mcp" || appId === "cloudcontrol") {
@@ -1960,7 +1960,7 @@ function evaluateRequirement(application, requirement) {
         "Catalog metadata cannot verify shared shell, launcher, and account menu adoption.",
         evidence
       );
-    case "service-registration-and-scopes": {
+    case "app-registration-and-scopes": {
       if (application.services.length > 0) {
         evidence.push(`services=${application.services.join(",")}`);
         return finding(
@@ -1970,7 +1970,7 @@ function evaluateRequirement(application, requirement) {
           evidence
         );
       }
-      return finding(requirement, "missing", "No SDK service ID is registered for this callable API surface.", evidence);
+      return finding(requirement, "missing", "No SDK app API id is registered for this callable API surface.", evidence);
     }
     case "organization-scoped-data":
       return finding(
@@ -2057,7 +2057,7 @@ function statusRank(status) {
 }
 
 // src/services.ts
-var DEFAULT_SERVICE_URLS = SERVICES;
+var DEFAULT_APP_URLS = APP_API_URLS;
 function resolveCatalogServiceUrl(entry, options = {}) {
   const keys = catalogServiceKeyCandidates(entry, options.serviceKey);
   const override = resolveServiceUrlOverride(keys, options.overrides);
@@ -2069,10 +2069,10 @@ function resolveCatalogServiceUrl(entry, options = {}) {
 function resolveServiceUrl(service, overrides) {
   const override = resolveServiceUrlOverride([service], overrides);
   if (override) return override;
-  return DEFAULT_SERVICE_URLS[service];
+  return DEFAULT_APP_URLS[service];
 }
 function catalogServiceKeyCandidates(entry, preferred) {
-  const values = [preferred, entry.slug, entry.name, entry.serviceId].filter(
+  const values = [preferred, entry.slug, entry.name, entry.appId].filter(
     (value) => typeof value === "string" && value.trim().length > 0
   );
   const keys = /* @__PURE__ */ new Set();
@@ -2100,7 +2100,7 @@ function resolveServiceUrlOverride(keys, overrides) {
     if (envStyle) return envStyle;
   }
   for (const key of keys) {
-    const envKey = `TOPOLO_SERVICE_URL_${key.replace(/\./g, "_").toUpperCase()}`;
+    const envKey = `TOPOLO_APP_URL_${key.replace(/\./g, "_").toUpperCase()}`;
     const envValue = typeof process !== "undefined" ? process.env?.[envKey] : void 0;
     if (envValue) return envValue;
   }
@@ -2126,7 +2126,7 @@ var TopoloClient = class _TopoloClient {
   credential;
   agent;
   serviceUrls;
-  serviceIds;
+  appIds;
   requireConfirmForWrites;
   timeoutMs;
   fetchImpl;
@@ -2134,18 +2134,18 @@ var TopoloClient = class _TopoloClient {
   serviceCatalogCache = null;
   actionCatalogCache = null;
   /**
-   * 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.
    */
-  static serviceIdCache = /* @__PURE__ */ new Map();
+  static appIdCache = /* @__PURE__ */ new Map();
   /**
-   * 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() {
-    _TopoloClient.serviceIdCache.clear();
+  static clearAppIdCache() {
+    _TopoloClient.appIdCache.clear();
   }
   constructor(options) {
     if (!options.credential) throw new TopoloAuthError("credential is required");
@@ -2153,7 +2153,7 @@ var TopoloClient = class _TopoloClient {
     this.credential = options.credential;
     this.agent = options.agent;
     this.serviceUrls = options.serviceUrls;
-    this.serviceIds = options.serviceIds;
+    this.appIds = options.appIds;
     this.requireConfirmForWrites = options.requireConfirmForWrites !== false;
     this.timeoutMs = options.timeoutMs ?? 3e4;
     this.fetchImpl = options.fetch ?? fetch;
@@ -2189,8 +2189,8 @@ var TopoloClient = class _TopoloClient {
     const headers = new Headers();
     headers.set("Accept", "application/json");
     if (opts.body !== void 0) headers.set("Content-Type", "application/json");
-    const platformServiceId = resolveConfiguredServiceId(resolvedService.serviceKey, this.serviceIds);
-    if (platformServiceId) headers.set("X-Service-ID", platformServiceId);
+    const platformAppId = resolveConfiguredAppId(resolvedService.serviceKey, this.appIds);
+    if (platformAppId) headers.set("X-App-ID", platformAppId);
     applyAuthHeaders(headers, this.credential);
     const requestId = generateRequestId();
     applyAuditHeaders(headers, this.agent, requestId);
@@ -2287,7 +2287,7 @@ var TopoloClient = class _TopoloClient {
         const derived = deriveDevelopersFromAuth(resolveConfiguredServiceUrl("auth", this.serviceUrls));
         if (derived) return { serviceKey, baseUrl: derived };
       }
-      return { serviceKey, baseUrl: DEFAULT_SERVICE_URLS[serviceKey] };
+      return { serviceKey, baseUrl: DEFAULT_APP_URLS[serviceKey] };
     }
     const live = await this.resolveLiveCallableService(serviceKey);
     if (live) {
@@ -2296,7 +2296,7 @@ var TopoloClient = class _TopoloClient {
     }
     throw new TopoloSdkError(
       "unknown_service",
-      `Unknown Topolo service "${service}". Run service discovery first and pass a callable service id or slug.`
+      `Unknown Topolo app API "${service}". Run app discovery first and pass a callable app id or slug.`
     );
   }
   async resolveLiveCallableService(serviceKey) {
@@ -2310,7 +2310,7 @@ var TopoloClient = class _TopoloClient {
     return baseUrl ? { serviceKey, baseUrl } : null;
   }
   /**
-   * 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
@@ -2321,16 +2321,16 @@ var TopoloClient = class _TopoloClient {
    * This keeps the resolver usable during early bootstrap before a caller
    * has acquired an access token.
    */
-  async getServiceIdBySlug(slug) {
+  async getAppIdBySlug(slug) {
     if (typeof slug !== "string") return null;
     const normalized = slug.trim().toLowerCase();
     if (!normalized) return null;
-    const configuredServiceId = resolveConfiguredServiceId(normalized, this.serviceIds);
-    if (configuredServiceId) return configuredServiceId;
+    const configuredAppId = resolveConfiguredAppId(normalized, this.appIds);
+    if (configuredAppId) return configuredAppId;
     const authBase = resolveServiceUrl("developers", this.serviceUrls);
     const cacheKey = `${authBase}|${normalized}`;
     const now = Date.now();
-    const cached = _TopoloClient.serviceIdCache.get(cacheKey);
+    const cached = _TopoloClient.appIdCache.get(cacheKey);
     if (cached && cached.expiresAt > now) {
       return cached.value;
     }
@@ -2348,7 +2348,7 @@ var TopoloClient = class _TopoloClient {
       return null;
     }
     if (res.status === 404) {
-      _TopoloClient.serviceIdCache.set(cacheKey, {
+      _TopoloClient.appIdCache.set(cacheKey, {
         value: null,
         expiresAt: now + NEGATIVE_CACHE_TTL_MS
       });
@@ -2358,9 +2358,9 @@ var TopoloClient = class _TopoloClient {
       return null;
     }
     const body = await res.json().catch(() => null);
-    const serviceId = body?.data?.service_id;
-    const value = typeof serviceId === "string" && serviceId ? serviceId : null;
-    _TopoloClient.serviceIdCache.set(cacheKey, {
+    const appId = body?.data?.app_id;
+    const value = typeof appId === "string" && appId ? appId : null;
+    _TopoloClient.appIdCache.set(cacheKey, {
       value,
       expiresAt: now + POSITIVE_CACHE_TTL_MS
     });
@@ -2392,8 +2392,8 @@ var TopoloClient = class _TopoloClient {
     const entries = [];
     for (const item of raw) {
       const s = item;
-      const serviceId = typeof s.service_id === "string" ? s.service_id : typeof s.id === "string" ? s.id : null;
-      if (!serviceId) continue;
+      const appId = typeof s.app_id === "string" ? s.app_id : typeof s.id === "string" ? s.id : null;
+      if (!appId) continue;
       const permissions = Array.isArray(s.granted_permissions) ? s.granted_permissions.filter((permission) => typeof permission === "string" && permission.trim().length > 0) : [];
       const catalogApiKeyResources = normalizeApiKeyResourceMetadataList(
         s.api_key_resources ?? s.apiKeyResources
@@ -2401,7 +2401,7 @@ var TopoloClient = class _TopoloClient {
       const apiKeyResource = normalizeApiKeyResourceMetadata(s.api_key_resource ?? s.apiKeyResource) ?? catalogApiKeyResources[0] ?? null;
       const apiKeyResources = catalogApiKeyResources.length > 0 ? catalogApiKeyResources : apiKeyResource ? [apiKeyResource] : [];
       entries.push({
-        serviceId,
+        appId,
         slug: typeof s.app_slug === "string" ? s.app_slug : null,
         name: typeof s.name === "string" ? s.name : null,
         description: typeof s.description === "string" ? s.description : null,
@@ -2469,7 +2469,7 @@ var TopoloClient = class _TopoloClient {
   async callAction(action, input = {}, options = {}) {
     const entry = await this.getAction(action);
     const mapped = mapActionInput(entry, input);
-    const service = entry.serviceSlug || entry.serviceId;
+    const service = entry.appSlug || entry.appId;
     return this.request({
       service,
       method: entry.method,
@@ -2490,7 +2490,7 @@ var TopoloClient = class _TopoloClient {
   listBundledServices() {
     const apps = Object.values(APPLICATIONS);
     return apps.map((app) => ({
-      serviceId: app.id,
+      appId: app.id,
       slug: app.id,
       name: app.name ?? app.id,
       description: null,
@@ -2540,11 +2540,11 @@ var TopoloClient = class _TopoloClient {
     };
   }
 };
-function resolveConfiguredServiceId(slug, serviceIds) {
+function resolveConfiguredAppId(slug, appIds) {
   for (const serviceKey of serviceKeyCandidates2(slug)) {
-    const configured = serviceIds?.[serviceKey];
+    const configured = appIds?.[serviceKey];
     if (typeof configured === "string" && configured.trim()) return configured.trim();
-    const envKey = `TOPOLO_SERVICE_ID_${serviceKey.replace(/\./g, "_").toUpperCase()}`;
+    const envKey = `TOPOLO_APP_ID_${serviceKey.replace(/\./g, "_").toUpperCase()}`;
     const envValue = typeof process !== "undefined" ? process.env?.[envKey] : void 0;
     if (typeof envValue === "string" && envValue.trim()) return envValue.trim();
   }
@@ -2628,7 +2628,7 @@ function catalogEntryMatches(entry, needle) {
   return catalogEntryLookupKeys(entry).includes(needle);
 }
 function catalogEntryLookupKeys(entry) {
-  const values = [entry.serviceId, entry.slug, entry.name].filter((value) => typeof value === "string" && value.trim().length > 0);
+  const values = [entry.appId, entry.slug, entry.name].filter((value) => typeof value === "string" && value.trim().length > 0);
   const keys = /* @__PURE__ */ new Set();
   for (const value of values) {
     const normalized = normalizeLookupKey(value);
@@ -2644,10 +2644,10 @@ function normalizeActionCatalogEntry(item) {
   const a = item;
   const actionId = pickActionString(a.action_id) ?? pickActionString(a.actionId);
   const name = pickActionString(a.name);
-  const serviceId = pickActionString(a.service_id) ?? pickActionString(a.serviceId);
+  const appId = pickActionString(a.app_id) ?? pickActionString(a.appId);
   const method = pickActionString(a.method)?.toUpperCase();
   const path = pickActionString(a.path);
-  if (!actionId || !name || !serviceId || !method || !path || !isHttpMethod(method)) {
+  if (!actionId || !name || !appId || !method || !path || !isHttpMethod(method)) {
     return null;
   }
   return {
@@ -2656,9 +2656,9 @@ function normalizeActionCatalogEntry(item) {
     toolName: pickActionString(a.tool_name) ?? pickActionString(a.toolName) ?? null,
     title: pickActionString(a.title) ?? name,
     description: pickActionString(a.description) ?? "",
-    serviceId,
-    serviceSlug: pickActionString(a.service_slug) ?? pickActionString(a.serviceSlug) ?? null,
-    serviceName: pickActionString(a.service_name) ?? pickActionString(a.serviceName) ?? null,
+    appId,
+    appSlug: pickActionString(a.app_slug) ?? pickActionString(a.appSlug) ?? null,
+    appName: pickActionString(a.app_name) ?? pickActionString(a.appName) ?? null,
     method,
     path,
     permissionName: pickActionString(a.permission_name) ?? pickActionString(a.permissionName) ?? "",
@@ -2775,6 +2775,7 @@ var CrmModule = class {
   constructor(client) {
     this.client = client;
   }
+  client;
   async listContacts(options = {}) {
     const res = await this.client.request({
       service: "crm",
@@ -2822,6 +2823,7 @@ var IdentityModule = class {
   constructor(client) {
     this.client = client;
   }
+  client;
   /** Returns the resolved user, organization, and permission set for the
    *  current credential. Equivalent to `TopoloClient.introspect()` — exposed
    *  on this module for symmetry with the other domain modules. */
@@ -2835,6 +2837,7 @@ var P2PModule = class {
   constructor(client) {
     this.client = client;
   }
+  client;
   // Directory ----------------------------------------------------------------
   async listDirectory(options = {}) {
     const res = await this.client.request({
@@ -2866,7 +2869,6 @@ var P2PModule = class {
         capability_id: input.capability_id,
         publisher_org_id: input.publisher_org_id,
         app_id: input.app_id,
-        service_id: input.service_id,
         name: input.name,
         description: input.description,
         category: input.category,
@@ -3144,7 +3146,7 @@ function defineTopoloChartWidget(widget) {
   return { ...widget, type: "chart" };
 }
 function createTopoloWidgetResponse({
-  serviceId,
+  appId,
   serviceName,
   widgets,
   now
@@ -3154,7 +3156,7 @@ function createTopoloWidgetResponse({
     success: true,
     widgets: widgets.map((widget) => ({
       ...widget,
-      serviceId: widget.serviceId?.trim() || serviceId,
+      appId: widget.appId?.trim() || appId,
       serviceName: widget.serviceName?.trim() || serviceName,
       lastUpdated: widget.lastUpdated?.trim() || lastUpdated
     }))
@@ -3192,7 +3194,7 @@ function validateWidget(widget, path, errors) {
     errors.push(`${path} must be an object`);
     return;
   }
-  validateNonEmptyString(widget.serviceId, `${path}.serviceId`, errors);
+  validateNonEmptyString(widget.appId, `${path}.appId`, errors);
   validateNonEmptyString(widget.serviceName, `${path}.serviceName`, errors);
   validateNonEmptyString(widget.lastUpdated, `${path}.lastUpdated`, errors);
   validateSnapshotMetadata(widget.snapshot, `${path}.snapshot`, errors);
@@ -3297,7 +3299,7 @@ function createTopolo(options) {
   APPLICATION_REQUIREMENTS,
   APPLICATION_REQUIREMENTS_VERSION,
   CrmModule,
-  DEFAULT_SERVICE_URLS,
+  DEFAULT_APP_URLS,
   IdentityModule,
   P2PModule,
   TOPOLO_WIDGET_ENDPOINT,