@topolo/sdk 0.2.11 → 0.3.0

package/dist/index.d.ts

@@ -62,7 +62,6 @@ declare const SERVICES: {
     readonly nexus: "https://nexus-api.topolo.app";
     readonly notify: "https://notify.topolo.app";
     readonly one: "https://one.topolo.app";
-    readonly "one.ai": "https://ai.one.topolo.app";
     readonly p2p: "https://p2p.topolo.app";
     readonly pay: "https://pay.topolo.app";
     readonly people: "https://people.topolo.app";
@@ -79,18 +78,26 @@ declare const SERVICES: {
     readonly web: "https://web-api.topolo.app";
 };
 type ServiceId = keyof typeof SERVICES;
+/**
+ * @deprecated since 0.3.0 — opaque service ids are no longer baked into the
+ * SDK. Use `TopoloClient.getServiceIdBySlug(slug)` which hits
+ * `GET /api/services/by-slug/:slug` on TopoloAuth at runtime. This map is
+ * still populated as a build-time snapshot for backward compatibility and
+ * will be removed in 0.4.0. Stale entries are expected — do not rely on
+ * presence/absence for catalog membership.
+ */
 declare const PLATFORM_SERVICE_IDS: Partial<Record<ServiceId, string>>;
 
 declare const APPLICATIONS: {
     readonly admin: {
         readonly id: "admin";
         readonly appDir: "TopoloAdmin";
-        readonly name: "topoloadmin";
+        readonly name: "topolo-admin";
         readonly packageName: "topolo-admin";
         readonly productionUrl: "https://admin.topolo.app";
         readonly services: readonly [];
         readonly deployTargets: readonly [{
-            readonly name: "topoloadmin";
+            readonly name: "topolo-admin";
             readonly kind: "pages";
             readonly apiUrl: null;
             readonly domains: readonly ["admin.topolo.app"];
@@ -107,7 +114,7 @@ declare const APPLICATIONS: {
         readonly services: readonly ["agent"];
         readonly deployTargets: readonly [{
             readonly name: "topolo-agent";
-            readonly kind: "pages";
+            readonly kind: "worker";
             readonly apiUrl: null;
             readonly domains: readonly ["agent.topolo.app"];
             readonly routes: readonly [];
@@ -343,7 +350,7 @@ declare const APPLICATIONS: {
             readonly serviceId: "crm";
         }, {
             readonly name: "topolo-crm-app";
-            readonly kind: "pages";
+            readonly kind: "worker";
             readonly apiUrl: null;
             readonly domains: readonly ["crm.topolo.app"];
             readonly routes: readonly [];
@@ -485,7 +492,7 @@ declare const APPLICATIONS: {
         readonly services: readonly ["forecast"];
         readonly deployTargets: readonly [{
             readonly name: "topolo-forecast";
-            readonly kind: "pages";
+            readonly kind: "worker";
             readonly apiUrl: null;
             readonly domains: readonly ["forecast.topolo.app"];
             readonly routes: readonly [];
@@ -572,7 +579,7 @@ declare const APPLICATIONS: {
         readonly services: readonly ["learn"];
         readonly deployTargets: readonly [{
             readonly name: "topolo-learn";
-            readonly kind: "pages";
+            readonly kind: "worker";
             readonly apiUrl: null;
             readonly domains: readonly ["learn.topolo.app"];
             readonly routes: readonly [];
@@ -611,7 +618,7 @@ declare const APPLICATIONS: {
         readonly services: readonly ["mail"];
         readonly deployTargets: readonly [{
             readonly name: "topolo-mail";
-            readonly kind: "workers";
+            readonly kind: "worker";
             readonly apiUrl: "https://mail.topolo.app";
             readonly domains: readonly ["mail.topolo.app"];
             readonly routes: readonly ["mail.topolo.app"];
@@ -643,7 +650,7 @@ declare const APPLICATIONS: {
             readonly serviceId: "mdm";
         }, {
             readonly name: "topolo-mdm-console";
-            readonly kind: "pages";
+            readonly kind: "worker";
             readonly apiUrl: null;
             readonly domains: readonly ["mdm.topolo.app"];
             readonly routes: readonly ["mdm.topolo.app"];
@@ -659,14 +666,14 @@ declare const APPLICATIONS: {
         readonly services: readonly ["messaging"];
         readonly deployTargets: readonly [{
             readonly name: "topolo-messaging";
-            readonly kind: "workers";
+            readonly kind: "worker";
             readonly apiUrl: "https://messages.topolo.app";
             readonly domains: readonly ["messages.topolo.app"];
             readonly routes: readonly [];
             readonly serviceId: "messaging";
         }, {
             readonly name: "topolo-messaging-dispatch";
-            readonly kind: "workers";
+            readonly kind: "worker";
             readonly apiUrl: null;
             readonly domains: readonly [];
             readonly routes: readonly [];
@@ -682,7 +689,7 @@ declare const APPLICATIONS: {
         readonly services: readonly ["nexus"];
         readonly deployTargets: readonly [{
             readonly name: "topolo-nexus-dashboard";
-            readonly kind: "pages";
+            readonly kind: "worker";
             readonly apiUrl: null;
             readonly domains: readonly ["nexus.topolo.app"];
             readonly routes: readonly [];
@@ -727,15 +734,8 @@ declare const APPLICATIONS: {
         readonly name: "topolo-oneclick-sso";
         readonly packageName: "topolo-oneclick-sso";
         readonly productionUrl: "https://one.topolo.app";
-        readonly services: readonly ["one", "one.ai"];
+        readonly services: readonly ["one"];
         readonly deployTargets: readonly [{
-            readonly name: "ai-chat-rag";
-            readonly kind: "worker";
-            readonly apiUrl: "https://ai.one.topolo.app";
-            readonly domains: readonly ["ai.one.topolo.app"];
-            readonly routes: readonly [];
-            readonly serviceId: "one.ai";
-        }, {
             readonly name: "topolo-one";
             readonly kind: "pages";
             readonly apiUrl: null;
@@ -838,7 +838,7 @@ declare const APPLICATIONS: {
             readonly serviceId: "quro.redirect";
         }, {
             readonly name: "quro-ui";
-            readonly kind: "pages";
+            readonly kind: "worker";
             readonly apiUrl: null;
             readonly domains: readonly ["quro.topolo.app"];
             readonly routes: readonly [];
@@ -854,7 +854,7 @@ declare const APPLICATIONS: {
         readonly services: readonly ["roadmapper"];
         readonly deployTargets: readonly [{
             readonly name: "topolo-roadmapper";
-            readonly kind: "pages";
+            readonly kind: "worker";
             readonly apiUrl: null;
             readonly domains: readonly ["roadmapper.topolo.app"];
             readonly routes: readonly [];
@@ -893,7 +893,7 @@ declare const APPLICATIONS: {
         readonly services: readonly ["social_studio"];
         readonly deployTargets: readonly [{
             readonly name: "topolo-social-studio";
-            readonly kind: "pages";
+            readonly kind: "worker";
             readonly apiUrl: null;
             readonly domains: readonly ["studio.topolo.app"];
             readonly routes: readonly [];
@@ -969,7 +969,7 @@ declare const APPLICATIONS: {
         readonly services: readonly ["support"];
         readonly deployTargets: readonly [{
             readonly name: "topolo-support";
-            readonly kind: "workers";
+            readonly kind: "worker";
             readonly apiUrl: "https://support.topolo.app";
             readonly domains: readonly ["support.topolo.app"];
             readonly routes: readonly ["support.topolo.app/*"];
@@ -1031,7 +1031,7 @@ declare const APPLICATIONS: {
             readonly serviceId: null;
         }, {
             readonly name: "topolo-web-studio";
-            readonly kind: "pages";
+            readonly kind: "worker";
             readonly apiUrl: null;
             readonly domains: readonly ["web.topolo.app"];
             readonly routes: readonly [];
@@ -1262,6 +1262,18 @@ declare class TopoloClient {
     private readonly timeoutMs;
     private readonly fetchImpl;
     private readonly debug?;
+    /**
+     * Process-wide cache for slug → service-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.
+     */
+    private static readonly serviceIdCache;
+    /**
+     * Drop the slug→service-id cache. Test-only — production callers should
+     * let the 5-minute TTL expire naturally.
+     */
+    static clearServiceIdCache(): void;
     constructor(options: TopoloClientOptions);
     private emit;
     /**
@@ -1270,6 +1282,24 @@ declare class TopoloClient {
      * use and for the generic `topolo api` / MCP passthrough tool.
      */
     request<T = unknown>(opts: RequestOptions): Promise<T>;
+    /**
+     * Resolve a service-slug → opaque service-id via TopoloAuth.
+     *
+     * Replaces the SDK-baked `PLATFORM_SERVICE_IDS` map (deprecated in 0.3.0,
+     * removed in 0.4.0). Slug shape accepted: either the canonical Auth slug
+     * (e.g. `topolo-notify`) or the SDK short id (`notify`) — Auth's resolver
+     * understands both.
+     *
+     * 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
+     * resolver. Returns null when the slug isn't registered — callers decide
+     * whether to throw.
+     *
+     * No credential is sent: the endpoint is public (slugs aren't secret).
+     * This keeps the resolver usable during early bootstrap before a caller
+     * has acquired an access token.
+     */
+    getServiceIdBySlug(slug: string): Promise<string | null>;
     /**
      * Introspect the current credential. Returns the caller's resolved identity,
      * organization, and permission set. Used by CLI `whoami` and by MCP to gate

package/dist/index.js

@@ -88,7 +88,6 @@ var SERVICES = {
   nexus: "https://nexus-api.topolo.app",
   notify: "https://notify.topolo.app",
   one: "https://one.topolo.app",
-  "one.ai": "https://ai.one.topolo.app",
   p2p: "https://p2p.topolo.app",
   pay: "https://pay.topolo.app",
   people: "https://people.topolo.app",
@@ -105,27 +104,27 @@ var SERVICES = {
   web: "https://web-api.topolo.app"
 };
 var PLATFORM_SERVICE_IDS = {
-  books: "srv_topolo_books",
-  bugfix: "srv_topolo_bugfix",
-  compose: "srv_topolo_compose",
-  consent: "srv_topolo_consent",
+  books: "srv_0g260hbN8oqv",
+  bugfix: "srv_kQ1t8qUSDgNs",
+  compose: "srv_aR3ETYmgygmd",
+  consent: "srv_8FIGR7Q7zP9r",
   crm: "srv_iCwM4jGXcwlj",
-  customer_success: "srv_topolo_success",
-  developers: "svc_topolo_developers",
-  director: "srv_topolo_director",
-  flow: "srv_topolo_flow",
-  forms: "srv_topolo_forms",
-  home: "srv_topolo_home",
-  insights: "srv_topolo_insights",
-  inventory: "srv_topolo_inventory",
-  localize: "srv_topolo_localize",
-  notify: "svc_topolo_notify",
-  p2p: "srv_topolo_p2p",
-  people: "srv_topolo_people",
-  sign: "srv_topolo_sign",
+  customer_success: "srv_RWpOxkgZdZbH",
+  developers: "srv_NjDq9G9qyyjr",
+  director: "srv_wRCnLLbtvmVT",
+  flow: "srv_GBCuKkHhnRXv",
+  forms: "srv_UE7IcGe80J5o",
+  home: "srv_hE6HBldVzjth",
+  insights: "srv_DgbBMwWSIhmC",
+  inventory: "srv_hmvjbv3ZxDnh",
+  localize: "srv_Ze1g9OmXuZjF",
+  notify: "srv_9pRdkIjYyKX0",
+  p2p: "srv_4BzeLqH0wCve",
+  people: "srv_VDMBAonA5fKb",
+  sign: "srv_Bd8pRw5ZqRBT",
   status: "srv_topolo_status",
-  survey: "srv_topolo_survey",
-  voice: "srv_topolo_voice"
+  survey: "srv_RCOi7CJkwf7R",
+  voice: "srv_BZANHkshGAK5"
 };
 
 // src/applications.generated.ts
@@ -133,13 +132,13 @@ var APPLICATIONS = {
   "admin": {
     "id": "admin",
     "appDir": "TopoloAdmin",
-    "name": "topoloadmin",
+    "name": "topolo-admin",
     "packageName": "topolo-admin",
     "productionUrl": "https://admin.topolo.app",
     "services": [],
     "deployTargets": [
       {
-        "name": "topoloadmin",
+        "name": "topolo-admin",
         "kind": "pages",
         "apiUrl": null,
         "domains": [
@@ -162,7 +161,7 @@ var APPLICATIONS = {
     "deployTargets": [
       {
         "name": "topolo-agent",
-        "kind": "pages",
+        "kind": "worker",
         "apiUrl": null,
         "domains": [
           "agent.topolo.app"
@@ -496,7 +495,7 @@ var APPLICATIONS = {
       },
       {
         "name": "topolo-crm-app",
-        "kind": "pages",
+        "kind": "worker",
         "apiUrl": null,
         "domains": [
           "crm.topolo.app"
@@ -694,7 +693,7 @@ var APPLICATIONS = {
     "deployTargets": [
       {
         "name": "topolo-forecast",
-        "kind": "pages",
+        "kind": "worker",
         "apiUrl": null,
         "domains": [
           "forecast.topolo.app"
@@ -822,7 +821,7 @@ var APPLICATIONS = {
     "deployTargets": [
       {
         "name": "topolo-learn",
-        "kind": "pages",
+        "kind": "worker",
         "apiUrl": null,
         "domains": [
           "learn.topolo.app"
@@ -878,7 +877,7 @@ var APPLICATIONS = {
     "deployTargets": [
       {
         "name": "topolo-mail",
-        "kind": "workers",
+        "kind": "worker",
         "apiUrl": "https://mail.topolo.app",
         "domains": [
           "mail.topolo.app"
@@ -923,7 +922,7 @@ var APPLICATIONS = {
       },
       {
         "name": "topolo-mdm-console",
-        "kind": "pages",
+        "kind": "worker",
         "apiUrl": null,
         "domains": [
           "mdm.topolo.app"
@@ -947,7 +946,7 @@ var APPLICATIONS = {
     "deployTargets": [
       {
         "name": "topolo-messaging",
-        "kind": "workers",
+        "kind": "worker",
         "apiUrl": "https://messages.topolo.app",
         "domains": [
           "messages.topolo.app"
@@ -957,7 +956,7 @@ var APPLICATIONS = {
       },
       {
         "name": "topolo-messaging-dispatch",
-        "kind": "workers",
+        "kind": "worker",
         "apiUrl": null,
         "domains": [],
         "routes": [],
@@ -977,7 +976,7 @@ var APPLICATIONS = {
     "deployTargets": [
       {
         "name": "topolo-nexus-dashboard",
-        "kind": "pages",
+        "kind": "worker",
         "apiUrl": null,
         "domains": [
           "nexus.topolo.app"
@@ -1037,20 +1036,9 @@ var APPLICATIONS = {
     "packageName": "topolo-oneclick-sso",
     "productionUrl": "https://one.topolo.app",
     "services": [
-      "one",
-      "one.ai"
+      "one"
     ],
     "deployTargets": [
-      {
-        "name": "ai-chat-rag",
-        "kind": "worker",
-        "apiUrl": "https://ai.one.topolo.app",
-        "domains": [
-          "ai.one.topolo.app"
-        ],
-        "routes": [],
-        "serviceId": "one.ai"
-      },
       {
         "name": "topolo-one",
         "kind": "pages",
@@ -1204,7 +1192,7 @@ var APPLICATIONS = {
       },
       {
         "name": "quro-ui",
-        "kind": "pages",
+        "kind": "worker",
         "apiUrl": null,
         "domains": [
           "quro.topolo.app"
@@ -1226,7 +1214,7 @@ var APPLICATIONS = {
     "deployTargets": [
       {
         "name": "topolo-roadmapper",
-        "kind": "pages",
+        "kind": "worker",
         "apiUrl": null,
         "domains": [
           "roadmapper.topolo.app"
@@ -1282,7 +1270,7 @@ var APPLICATIONS = {
     "deployTargets": [
       {
         "name": "topolo-social-studio",
-        "kind": "pages",
+        "kind": "worker",
         "apiUrl": null,
         "domains": [
           "studio.topolo.app"
@@ -1386,7 +1374,7 @@ var APPLICATIONS = {
     "deployTargets": [
       {
         "name": "topolo-support",
-        "kind": "workers",
+        "kind": "worker",
         "apiUrl": "https://support.topolo.app",
         "domains": [
           "support.topolo.app"
@@ -1478,7 +1466,7 @@ var APPLICATIONS = {
       },
       {
         "name": "topolo-web-studio",
-        "kind": "pages",
+        "kind": "worker",
         "apiUrl": null,
         "domains": [
           "web.topolo.app"
@@ -1882,7 +1870,9 @@ function resolveServiceUrl(service, overrides) {
 
 // src/client.ts
 var WRITE_METHODS = /* @__PURE__ */ new Set(["POST", "PUT", "PATCH", "DELETE"]);
-var TopoloClient = class {
+var POSITIVE_CACHE_TTL_MS = 5 * 60 * 1e3;
+var NEGATIVE_CACHE_TTL_MS = 60 * 1e3;
+var TopoloClient = class _TopoloClient {
   credential;
   agent;
   serviceUrls;
@@ -1890,6 +1880,20 @@ var TopoloClient = class {
   timeoutMs;
   fetchImpl;
   debug;
+  /**
+   * Process-wide cache for slug → service-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.
+   */
+  static serviceIdCache = /* @__PURE__ */ new Map();
+  /**
+   * Drop the slug→service-id cache. Test-only — production callers should
+   * let the 5-minute TTL expire naturally.
+   */
+  static clearServiceIdCache() {
+    _TopoloClient.serviceIdCache.clear();
+  }
   constructor(options) {
     if (!options.credential) throw new TopoloAuthError("credential is required");
     if (!options.agent?.clientName) throw new TopoloAuthError("agent.clientName is required");
@@ -2004,6 +2008,66 @@ var TopoloClient = class {
     });
     return parsed;
   }
+  /**
+   * Resolve a service-slug → opaque service-id via TopoloAuth.
+   *
+   * Replaces the SDK-baked `PLATFORM_SERVICE_IDS` map (deprecated in 0.3.0,
+   * removed in 0.4.0). Slug shape accepted: either the canonical Auth slug
+   * (e.g. `topolo-notify`) or the SDK short id (`notify`) — Auth's resolver
+   * understands both.
+   *
+   * 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
+   * resolver. Returns null when the slug isn't registered — callers decide
+   * whether to throw.
+   *
+   * No credential is sent: the endpoint is public (slugs aren't secret).
+   * This keeps the resolver usable during early bootstrap before a caller
+   * has acquired an access token.
+   */
+  async getServiceIdBySlug(slug) {
+    if (typeof slug !== "string") return null;
+    const normalized = slug.trim().toLowerCase();
+    if (!normalized) return null;
+    const authBase = resolveServiceUrl("auth", this.serviceUrls);
+    const cacheKey = `${authBase}|${normalized}`;
+    const now = Date.now();
+    const cached = _TopoloClient.serviceIdCache.get(cacheKey);
+    if (cached && cached.expiresAt > now) {
+      return cached.value;
+    }
+    const url = new URL(
+      `/api/services/by-slug/${encodeURIComponent(normalized)}`,
+      authBase.endsWith("/") ? authBase : `${authBase}/`
+    ).toString();
+    let res;
+    try {
+      res = await this.fetchImpl(url, {
+        method: "GET",
+        headers: { Accept: "application/json" }
+      });
+    } catch {
+      return null;
+    }
+    if (res.status === 404) {
+      _TopoloClient.serviceIdCache.set(cacheKey, {
+        value: null,
+        expiresAt: now + NEGATIVE_CACHE_TTL_MS
+      });
+      return null;
+    }
+    if (!res.ok) {
+      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, {
+      value,
+      expiresAt: now + POSITIVE_CACHE_TTL_MS
+    });
+    return value;
+  }
   /**
    * Introspect the current credential. Returns the caller's resolved identity,
    * organization, and permission set. Used by CLI `whoami` and by MCP to gate

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@topolo/sdk",
-  "version": "0.2.11",
+  "version": "0.3.0",
   "description": "Typed client SDK for the Topolo platform. Used by TopoloCli, TopoloMCP, and third-party agents.",
   "type": "module",
   "main": "./dist/index.js",