@topolo/sdk 0.2.4 → 0.2.6

package/dist/index.d.cts

@@ -34,14 +34,20 @@ interface AgentIdentity {
 declare const SERVICES: {
     readonly agent: "https://topolo-agent-worker.topolo.workers.dev";
     readonly auth: "https://auth.topolo.app";
+    readonly books: "https://books.topolo.app";
     readonly bugfix: "https://bugfix.topolo.app";
     readonly bytes: "https://r2-media-manager-worker.topolo.workers.dev";
     readonly calendar: "https://calendar.topolo.app";
     readonly chat: "https://chat.topolo.app";
     readonly commerce: "https://topolo-commerce-api.topolo.workers.dev";
     readonly crm: "https://crm-api.topolo.app";
+    readonly customer_success: "https://customer-success.topolo.app";
     readonly feed: "https://topolo-feed-api.topolo.app";
+    readonly flow: "https://flow.topolo.app";
     readonly forecast: "https://forecast-worker-production.topolo.workers.dev";
+    readonly forms: "https://forms.topolo.app";
+    readonly insights: "https://insights.topolo.app";
+    readonly inventory: "https://inventory.topolo.app";
     readonly learn: "https://topololearn-api.topolo.workers.dev";
     readonly mail: "https://mail.topolo.app";
     readonly mdm: "https://topolo-mdm-api.topolo.app";
@@ -49,12 +55,16 @@ declare const SERVICES: {
     readonly nexus: "https://topolo-nexus-gateway.topolo.workers.dev";
     readonly one: "https://one.topolo.app";
     readonly pay: "https://topolo-pay.topolo.workers.dev";
+    readonly people: "https://people.topolo.app";
     readonly "quro.api": "https://api.ol0.me";
     readonly "quro.redirect": "https://ol0.me";
     readonly roadmapper: "https://roadmapper-api.topolo.app";
+    readonly sign: "https://sign.topolo.app";
     readonly social_studio: "https://topolo-social-studio-api.topolo.workers.dev";
     readonly socialize: "https://socialize-prod-api.topolo.workers.dev";
     readonly support: "https://support.topolo.app";
+    readonly survey: "https://survey.topolo.app";
+    readonly voice: "https://voice.topolo.app";
     readonly web: "https://web-api.topolo.app";
 };
 type ServiceId = keyof typeof SERVICES;
@@ -71,10 +81,10 @@ declare const APPLICATIONS: {
         readonly deployTargets: readonly [{
             readonly name: "topoloadmin";
             readonly kind: "pages";
-            readonly apiUrl: any;
+            readonly apiUrl: null;
             readonly domains: readonly [];
             readonly routes: readonly [];
-            readonly serviceId: any;
+            readonly serviceId: null;
         }];
     };
     readonly agent: {
@@ -87,10 +97,10 @@ declare const APPLICATIONS: {
         readonly deployTargets: readonly [{
             readonly name: "topolo-agent";
             readonly kind: "pages";
-            readonly apiUrl: any;
+            readonly apiUrl: null;
             readonly domains: readonly [];
             readonly routes: readonly [];
-            readonly serviceId: any;
+            readonly serviceId: null;
         }, {
             readonly name: "topolo-agent-worker";
             readonly kind: "worker";
@@ -116,6 +126,22 @@ declare const APPLICATIONS: {
             readonly serviceId: "auth";
         }];
     };
+    readonly books: {
+        readonly id: "books";
+        readonly appDir: "TopoloBooks";
+        readonly name: "topolo-books";
+        readonly packageName: "topolo-books";
+        readonly productionUrl: "https://books.topolo.app";
+        readonly services: readonly ["books"];
+        readonly deployTargets: readonly [{
+            readonly name: "topolo-books";
+            readonly kind: "worker";
+            readonly apiUrl: "https://books.topolo.app";
+            readonly domains: readonly ["books.topolo.app"];
+            readonly routes: readonly ["books.topolo.app"];
+            readonly serviceId: "books";
+        }];
+    };
     readonly bugfix: {
         readonly id: "bugfix";
         readonly appDir: "TopoloBugFix";
@@ -142,10 +168,10 @@ declare const APPLICATIONS: {
         readonly deployTargets: readonly [{
             readonly name: "bytes";
             readonly kind: "pages";
-            readonly apiUrl: any;
+            readonly apiUrl: null;
             readonly domains: readonly [];
             readonly routes: readonly [];
-            readonly serviceId: any;
+            readonly serviceId: null;
         }, {
             readonly name: "r2-media-manager-worker";
             readonly kind: "worker";
@@ -192,7 +218,7 @@ declare const APPLICATIONS: {
         readonly appDir: "TopoloCli";
         readonly name: "@topolo/cli";
         readonly packageName: "@topolo/cli";
-        readonly productionUrl: any;
+        readonly productionUrl: null;
         readonly services: readonly [];
         readonly deployTargets: readonly [];
     };
@@ -201,7 +227,7 @@ declare const APPLICATIONS: {
         readonly appDir: "TopoloCloudControl";
         readonly name: "topolo-cloudcontrol";
         readonly packageName: "topolo-cloudcontrol";
-        readonly productionUrl: any;
+        readonly productionUrl: null;
         readonly services: readonly [];
         readonly deployTargets: readonly [];
     };
@@ -222,24 +248,24 @@ declare const APPLICATIONS: {
         }, {
             readonly name: "topolo-commerce-guest-web";
             readonly kind: "pages";
-            readonly apiUrl: any;
+            readonly apiUrl: null;
             readonly domains: readonly ["guest.topolo.app", "topolo-commerce-guest-web.pages.dev"];
             readonly routes: readonly [];
-            readonly serviceId: any;
+            readonly serviceId: null;
         }, {
             readonly name: "topolo-commerce-ops-web";
             readonly kind: "pages";
-            readonly apiUrl: any;
+            readonly apiUrl: null;
             readonly domains: readonly ["commerce.topolo.app", "topolo-commerce-ops-web.pages.dev"];
             readonly routes: readonly [];
-            readonly serviceId: any;
+            readonly serviceId: null;
         }, {
             readonly name: "topolo-commerce-station-web";
             readonly kind: "pages";
-            readonly apiUrl: any;
+            readonly apiUrl: null;
             readonly domains: readonly ["station-commerce.topolo.app", "topolo-commerce-station-web.pages.dev"];
             readonly routes: readonly [];
-            readonly serviceId: any;
+            readonly serviceId: null;
         }];
     };
     readonly crm: {
@@ -252,10 +278,10 @@ declare const APPLICATIONS: {
         readonly deployTargets: readonly [{
             readonly name: "topolo-crm-frontend";
             readonly kind: "pages";
-            readonly apiUrl: any;
+            readonly apiUrl: null;
             readonly domains: readonly [];
             readonly routes: readonly [];
-            readonly serviceId: any;
+            readonly serviceId: null;
         }, {
             readonly name: "topolo-crm-worker";
             readonly kind: "worker";
@@ -265,6 +291,22 @@ declare const APPLICATIONS: {
             readonly serviceId: "crm";
         }];
     };
+    readonly customer_success: {
+        readonly id: "customer_success";
+        readonly appDir: "TopoloCustomerSuccess";
+        readonly name: "topolo-customer-success";
+        readonly packageName: "topolo-customer-success";
+        readonly productionUrl: "https://customer-success.topolo.app";
+        readonly services: readonly ["customer_success"];
+        readonly deployTargets: readonly [{
+            readonly name: "topolo-customer-success";
+            readonly kind: "worker";
+            readonly apiUrl: "https://customer-success.topolo.app";
+            readonly domains: readonly ["customer-success.topolo.app"];
+            readonly routes: readonly ["customer-success.topolo.app"];
+            readonly serviceId: "customer_success";
+        }];
+    };
     readonly developers: {
         readonly id: "developers";
         readonly appDir: "TopoloDevelopers";
@@ -275,10 +317,10 @@ declare const APPLICATIONS: {
         readonly deployTargets: readonly [{
             readonly name: "topolo-developers";
             readonly kind: "pages";
-            readonly apiUrl: any;
+            readonly apiUrl: null;
             readonly domains: readonly ["developers.topolo.app"];
             readonly routes: readonly [];
-            readonly serviceId: any;
+            readonly serviceId: null;
         }];
     };
     readonly docs: {
@@ -291,17 +333,17 @@ declare const APPLICATIONS: {
         readonly deployTargets: readonly [{
             readonly name: "topolo-docs";
             readonly kind: "pages";
-            readonly apiUrl: any;
+            readonly apiUrl: null;
             readonly domains: readonly ["docs.topolo.app"];
             readonly routes: readonly [];
-            readonly serviceId: any;
+            readonly serviceId: null;
         }];
     };
     readonly feed: {
         readonly id: "feed";
         readonly appDir: "TopoloFeed";
         readonly name: "TopoloFeed";
-        readonly packageName: any;
+        readonly packageName: null;
         readonly productionUrl: "https://topolo-feed-api.topolo.app";
         readonly services: readonly ["feed"];
         readonly deployTargets: readonly [{
@@ -310,7 +352,7 @@ declare const APPLICATIONS: {
             readonly apiUrl: "https://topolo-feed-analytics-api.topolo.app";
             readonly domains: readonly ["topolo-feed-analytics-api.topolo.app"];
             readonly routes: readonly ["topolo-feed-analytics-api.topolo.app"];
-            readonly serviceId: any;
+            readonly serviceId: null;
         }, {
             readonly name: "topolo-feed-api";
             readonly kind: "worker";
@@ -320,6 +362,22 @@ declare const APPLICATIONS: {
             readonly serviceId: "feed";
         }];
     };
+    readonly flow: {
+        readonly id: "flow";
+        readonly appDir: "TopoloFlow";
+        readonly name: "topolo-flow";
+        readonly packageName: "topolo-flow";
+        readonly productionUrl: "https://flow.topolo.app";
+        readonly services: readonly ["flow"];
+        readonly deployTargets: readonly [{
+            readonly name: "topolo-flow";
+            readonly kind: "worker";
+            readonly apiUrl: "https://flow.topolo.app";
+            readonly domains: readonly ["flow.topolo.app"];
+            readonly routes: readonly ["flow.topolo.app"];
+            readonly serviceId: "flow";
+        }];
+    };
     readonly forecast: {
         readonly id: "forecast";
         readonly appDir: "TopoloForecast";
@@ -330,10 +388,10 @@ declare const APPLICATIONS: {
         readonly deployTargets: readonly [{
             readonly name: "forecast";
             readonly kind: "pages";
-            readonly apiUrl: any;
+            readonly apiUrl: null;
             readonly domains: readonly [];
             readonly routes: readonly [];
-            readonly serviceId: any;
+            readonly serviceId: null;
         }, {
             readonly name: "forecast-worker-production";
             readonly kind: "worker";
@@ -343,6 +401,54 @@ declare const APPLICATIONS: {
             readonly serviceId: "forecast";
         }];
     };
+    readonly forms: {
+        readonly id: "forms";
+        readonly appDir: "TopoloForms";
+        readonly name: "topolo-forms";
+        readonly packageName: "topolo-forms";
+        readonly productionUrl: "https://forms.topolo.app";
+        readonly services: readonly ["forms"];
+        readonly deployTargets: readonly [{
+            readonly name: "topolo-forms";
+            readonly kind: "worker";
+            readonly apiUrl: "https://forms.topolo.app";
+            readonly domains: readonly ["forms.topolo.app"];
+            readonly routes: readonly ["forms.topolo.app"];
+            readonly serviceId: "forms";
+        }];
+    };
+    readonly insights: {
+        readonly id: "insights";
+        readonly appDir: "TopoloInsights";
+        readonly name: "topolo-insights";
+        readonly packageName: "topolo-insights";
+        readonly productionUrl: "https://insights.topolo.app";
+        readonly services: readonly ["insights"];
+        readonly deployTargets: readonly [{
+            readonly name: "topolo-insights";
+            readonly kind: "worker";
+            readonly apiUrl: "https://insights.topolo.app";
+            readonly domains: readonly ["insights.topolo.app"];
+            readonly routes: readonly ["insights.topolo.app"];
+            readonly serviceId: "insights";
+        }];
+    };
+    readonly inventory: {
+        readonly id: "inventory";
+        readonly appDir: "TopoloInventory";
+        readonly name: "topolo-inventory";
+        readonly packageName: "topolo-inventory";
+        readonly productionUrl: "https://inventory.topolo.app";
+        readonly services: readonly ["inventory"];
+        readonly deployTargets: readonly [{
+            readonly name: "topolo-inventory";
+            readonly kind: "worker";
+            readonly apiUrl: "https://inventory.topolo.app";
+            readonly domains: readonly ["inventory.topolo.app"];
+            readonly routes: readonly ["inventory.topolo.app"];
+            readonly serviceId: "inventory";
+        }];
+    };
     readonly learn: {
         readonly id: "learn";
         readonly appDir: "TopoloLearn";
@@ -353,10 +459,10 @@ declare const APPLICATIONS: {
         readonly deployTargets: readonly [{
             readonly name: "topololearn";
             readonly kind: "pages";
-            readonly apiUrl: any;
+            readonly apiUrl: null;
             readonly domains: readonly ["learn.topolo.app"];
             readonly routes: readonly [];
-            readonly serviceId: any;
+            readonly serviceId: null;
         }, {
             readonly name: "topololearn-api";
             readonly kind: "worker";
@@ -387,7 +493,7 @@ declare const APPLICATIONS: {
         readonly appDir: "TopoloMCP";
         readonly name: "@topolo/mcp";
         readonly packageName: "@topolo/mcp";
-        readonly productionUrl: any;
+        readonly productionUrl: null;
         readonly services: readonly [];
         readonly deployTargets: readonly [];
     };
@@ -395,7 +501,7 @@ declare const APPLICATIONS: {
         readonly id: "mdm";
         readonly appDir: "TopoloMDM";
         readonly name: "TopoloMDM";
-        readonly packageName: any;
+        readonly packageName: null;
         readonly productionUrl: "https://mdm.topolo.app";
         readonly services: readonly ["mdm"];
         readonly deployTargets: readonly [{
@@ -408,10 +514,10 @@ declare const APPLICATIONS: {
         }, {
             readonly name: "topolo-mdm-console";
             readonly kind: "pages";
-            readonly apiUrl: any;
+            readonly apiUrl: null;
             readonly domains: readonly ["mdm.topolo.app", "topolo-mdm-console.pages.dev"];
             readonly routes: readonly ["mdm.topolo.app"];
-            readonly serviceId: any;
+            readonly serviceId: null;
         }];
     };
     readonly messaging: {
@@ -431,10 +537,10 @@ declare const APPLICATIONS: {
         }, {
             readonly name: "topolo-messaging-dispatch";
             readonly kind: "workers";
-            readonly apiUrl: any;
+            readonly apiUrl: null;
             readonly domains: readonly [];
             readonly routes: readonly [];
-            readonly serviceId: any;
+            readonly serviceId: null;
         }];
     };
     readonly nexus: {
@@ -447,10 +553,10 @@ declare const APPLICATIONS: {
         readonly deployTargets: readonly [{
             readonly name: "topolo-nexus-dashboard";
             readonly kind: "pages";
-            readonly apiUrl: any;
+            readonly apiUrl: null;
             readonly domains: readonly ["nexus.topolo.app", "topolo-nexus-dashboard.pages.dev"];
             readonly routes: readonly [];
-            readonly serviceId: any;
+            readonly serviceId: null;
         }, {
             readonly name: "topolo-nexus-gateway";
             readonly kind: "worker";
@@ -470,24 +576,24 @@ declare const APPLICATIONS: {
         readonly deployTargets: readonly [{
             readonly name: "ai-chat-rag";
             readonly kind: "worker";
-            readonly apiUrl: any;
+            readonly apiUrl: null;
             readonly domains: readonly ["ai-chat-rag.topolo.workers.dev"];
             readonly routes: readonly [];
-            readonly serviceId: any;
+            readonly serviceId: null;
         }, {
             readonly name: "topoloone";
             readonly kind: "pages";
-            readonly apiUrl: any;
+            readonly apiUrl: null;
             readonly domains: readonly ["oneclick-dashboard.pages.dev"];
             readonly routes: readonly [];
-            readonly serviceId: any;
+            readonly serviceId: null;
         }, {
             readonly name: "topoloone-website";
             readonly kind: "worker";
-            readonly apiUrl: any;
-            readonly domains: readonly ["one.topolo.io"];
+            readonly apiUrl: null;
+            readonly domains: readonly ["one.topolo.io", "topolo.io", "www.topolo.io"];
             readonly routes: readonly [];
-            readonly serviceId: any;
+            readonly serviceId: null;
         }, {
             readonly name: "topoloone-worker";
             readonly kind: "worker";
@@ -513,11 +619,27 @@ declare const APPLICATIONS: {
             readonly serviceId: "pay";
         }];
     };
+    readonly people: {
+        readonly id: "people";
+        readonly appDir: "TopoloPeople";
+        readonly name: "topolo-people";
+        readonly packageName: "topolo-people";
+        readonly productionUrl: "https://people.topolo.app";
+        readonly services: readonly ["people"];
+        readonly deployTargets: readonly [{
+            readonly name: "topolo-people";
+            readonly kind: "worker";
+            readonly apiUrl: "https://people.topolo.app";
+            readonly domains: readonly ["people.topolo.app"];
+            readonly routes: readonly ["people.topolo.app"];
+            readonly serviceId: "people";
+        }];
+    };
     readonly quro: {
         readonly id: "quro";
         readonly appDir: "TopoloQuro";
         readonly name: "TopoloQuro";
-        readonly packageName: any;
+        readonly packageName: null;
         readonly productionUrl: "https://quro.topolo.app";
         readonly services: readonly ["quro.api", "quro.redirect"];
         readonly deployTargets: readonly [{
@@ -537,10 +659,10 @@ declare const APPLICATIONS: {
         }, {
             readonly name: "quro-ui";
             readonly kind: "pages";
-            readonly apiUrl: any;
+            readonly apiUrl: null;
             readonly domains: readonly [];
             readonly routes: readonly [];
-            readonly serviceId: any;
+            readonly serviceId: null;
         }];
     };
     readonly roadmapper: {
@@ -553,10 +675,10 @@ declare const APPLICATIONS: {
         readonly deployTargets: readonly [{
             readonly name: "roadmapper";
             readonly kind: "pages";
-            readonly apiUrl: any;
+            readonly apiUrl: null;
             readonly domains: readonly ["roadmapper.topolo.app"];
             readonly routes: readonly [];
-            readonly serviceId: any;
+            readonly serviceId: null;
         }, {
             readonly name: "topolo-production-roadmapper";
             readonly kind: "worker";
@@ -566,6 +688,22 @@ declare const APPLICATIONS: {
             readonly serviceId: "roadmapper";
         }];
     };
+    readonly sign: {
+        readonly id: "sign";
+        readonly appDir: "TopoloSign";
+        readonly name: "topolo-sign";
+        readonly packageName: "topolo-sign";
+        readonly productionUrl: "https://sign.topolo.app";
+        readonly services: readonly ["sign"];
+        readonly deployTargets: readonly [{
+            readonly name: "topolo-sign";
+            readonly kind: "worker";
+            readonly apiUrl: "https://sign.topolo.app";
+            readonly domains: readonly ["sign.topolo.app"];
+            readonly routes: readonly ["sign.topolo.app"];
+            readonly serviceId: "sign";
+        }];
+    };
     readonly social_studio: {
         readonly id: "social_studio";
         readonly appDir: "TopoloSocialStudio";
@@ -576,10 +714,10 @@ declare const APPLICATIONS: {
         readonly deployTargets: readonly [{
             readonly name: "topolo-social-studio";
             readonly kind: "pages";
-            readonly apiUrl: any;
+            readonly apiUrl: null;
             readonly domains: readonly [];
             readonly routes: readonly [];
-            readonly serviceId: any;
+            readonly serviceId: null;
         }, {
             readonly name: "topolo-social-studio-api";
             readonly kind: "worker";
@@ -590,10 +728,10 @@ declare const APPLICATIONS: {
         }, {
             readonly name: "topolo-social-studio-queue";
             readonly kind: "worker";
-            readonly apiUrl: any;
+            readonly apiUrl: null;
             readonly domains: readonly [];
             readonly routes: readonly [];
-            readonly serviceId: any;
+            readonly serviceId: null;
         }];
     };
     readonly socialize: {
@@ -606,10 +744,10 @@ declare const APPLICATIONS: {
         readonly deployTargets: readonly [{
             readonly name: "socialize";
             readonly kind: "pages";
-            readonly apiUrl: any;
+            readonly apiUrl: null;
             readonly domains: readonly [];
             readonly routes: readonly [];
-            readonly serviceId: any;
+            readonly serviceId: null;
         }, {
             readonly name: "socialize-prod-api";
             readonly kind: "worker";
@@ -620,10 +758,10 @@ declare const APPLICATIONS: {
         }, {
             readonly name: "socialize-prod-scheduler";
             readonly kind: "worker";
-            readonly apiUrl: any;
+            readonly apiUrl: null;
             readonly domains: readonly [];
             readonly routes: readonly [];
-            readonly serviceId: any;
+            readonly serviceId: null;
         }];
     };
     readonly support: {
@@ -642,6 +780,38 @@ declare const APPLICATIONS: {
             readonly serviceId: "support";
         }];
     };
+    readonly survey: {
+        readonly id: "survey";
+        readonly appDir: "TopoloSurvey";
+        readonly name: "topolo-survey";
+        readonly packageName: "topolo-survey";
+        readonly productionUrl: "https://survey.topolo.app";
+        readonly services: readonly ["survey"];
+        readonly deployTargets: readonly [{
+            readonly name: "topolo-survey";
+            readonly kind: "worker";
+            readonly apiUrl: "https://survey.topolo.app";
+            readonly domains: readonly ["survey.topolo.app"];
+            readonly routes: readonly ["survey.topolo.app"];
+            readonly serviceId: "survey";
+        }];
+    };
+    readonly voice: {
+        readonly id: "voice";
+        readonly appDir: "TopoloVoice";
+        readonly name: "topolo-voice";
+        readonly packageName: "topolo-voice";
+        readonly productionUrl: "https://voice.topolo.app";
+        readonly services: readonly ["voice"];
+        readonly deployTargets: readonly [{
+            readonly name: "topolo-voice";
+            readonly kind: "worker";
+            readonly apiUrl: "https://voice.topolo.app";
+            readonly domains: readonly ["voice.topolo.app"];
+            readonly routes: readonly ["voice.topolo.app"];
+            readonly serviceId: "voice";
+        }];
+    };
     readonly web: {
         readonly id: "web";
         readonly appDir: "TopoloWeb";
@@ -662,14 +832,14 @@ declare const APPLICATIONS: {
             readonly apiUrl: "https://sites.topolo.app";
             readonly domains: readonly ["sites.topolo.app"];
             readonly routes: readonly [];
-            readonly serviceId: any;
+            readonly serviceId: null;
         }, {
             readonly name: "topoloweb-studio";
             readonly kind: "pages";
-            readonly apiUrl: any;
+            readonly apiUrl: null;
             readonly domains: readonly ["web.topolo.app"];
             readonly routes: readonly [];
-            readonly serviceId: any;
+            readonly serviceId: null;
         }];
     };
 };
@@ -677,7 +847,7 @@ type ApplicationId = keyof typeof APPLICATIONS;
 type ApplicationCatalogEntry = (typeof APPLICATIONS)[ApplicationId];
 type ApplicationDeployTarget = ApplicationCatalogEntry['deployTargets'][number];
 
-declare const APPLICATION_REQUIREMENTS_VERSION = "2026-04-22.1";
+declare const APPLICATION_REQUIREMENTS_VERSION = "2026-04-25.1";
 type ApplicationRequirementScope = 'all' | 'browser' | 'api' | 'tooling' | 'agent_surface';
 interface ApplicationRequirement {
     id: string;
@@ -781,6 +951,13 @@ declare const APPLICATION_REQUIREMENTS: readonly [{
     readonly appliesTo: readonly ["api", "tooling", "agent_surface"];
     readonly evidence: readonly ["Read operations have typed SDK/CLI/MCP surfaces once their contract stabilizes", "Mutating generic calls require --confirm or confirm:true", "MCP tools never accept orgId and advertise only appropriate scope-gated tools"];
     readonly implementation: readonly ["Add SDK types first, then CLI commands and MCP tools for durable workflows", "Use generic API passthrough only as a temporary escape hatch", "Keep command output JSON-stable for agents and human-readable with --no-json"];
+}, {
+    readonly id: "native-dashboard-widget";
+    readonly title: "Expose a native dashboard widget contract";
+    readonly summary: "Launchable first-party applications must populate TopoloOne live workspace through an app-owned /api/widget endpoint using the SDK widget response contract.";
+    readonly appliesTo: readonly ["api"];
+    readonly evidence: readonly ["The app-owned API exposes GET /api/widget", "The endpoint returns TopoloWidgetApiResponse from @topolo/sdk", "The endpoint derives organization/user context from the app auth boundary"];
+    readonly implementation: readonly ["Import createTopoloWidgetResponse from @topolo/sdk in the app backend", "Return native app metrics or action widgets instead of generic launch-card fallbacks", "Add a route-level test that validates the response with validateTopoloWidgetResponse"];
 }, {
     readonly id: "observability-and-audit";
     readonly title: "Emit platform audit and debugging signals";
@@ -1065,6 +1242,108 @@ declare class TopoloOAuth {
     }): Promise<TokenResponse>;
 }
 
+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;
+    serviceName: string;
+    serviceIcon?: string;
+    type: TopoloWidgetType;
+    lastUpdated: string;
+}
+interface TopoloWidgetMetric {
+    label: string;
+    value: string | number;
+    change?: number;
+    changeLabel?: string;
+    icon?: string;
+}
+interface TopoloStatsWidget extends TopoloWidgetBase {
+    type: 'stats';
+    stats: TopoloWidgetMetric[];
+}
+interface TopoloWidgetActivityItem {
+    id: string;
+    title: string;
+    description?: string;
+    timestamp: string;
+    icon?: string;
+    link?: string;
+}
+interface TopoloRecentActivityWidget extends TopoloWidgetBase {
+    type: 'recent-activity';
+    activities: TopoloWidgetActivityItem[];
+}
+interface TopoloWidgetActionItem {
+    id: string;
+    label: string;
+    icon?: string;
+    link: string;
+    primary?: boolean;
+}
+interface TopoloQuickActionsWidget extends TopoloWidgetBase {
+    type: 'quick-actions';
+    actions: TopoloWidgetActionItem[];
+}
+interface TopoloWidgetNotificationItem {
+    id: string;
+    title: string;
+    message: string;
+    type: 'info' | 'warning' | 'error' | 'success';
+    timestamp: string;
+    read: boolean;
+    link?: string;
+}
+interface TopoloNotificationsWidget extends TopoloWidgetBase {
+    type: 'notifications';
+    notifications: TopoloWidgetNotificationItem[];
+    unreadCount: number;
+}
+interface TopoloChartWidget extends TopoloWidgetBase {
+    type: 'chart';
+    chartType: 'line' | 'bar' | 'pie' | 'donut';
+    title: string;
+    data: {
+        labels: string[];
+        values: number[];
+    };
+}
+type TopoloWidget = TopoloStatsWidget | TopoloRecentActivityWidget | TopoloQuickActionsWidget | TopoloNotificationsWidget | TopoloChartWidget;
+type TopoloWidgetWithOptionalMetadata<T extends TopoloWidget> = Omit<T, 'serviceId' | 'serviceName' | 'lastUpdated'> & Partial<Pick<TopoloWidgetBase, 'serviceId' | 'serviceName' | 'lastUpdated'>>;
+type TopoloWidgetDraft = TopoloWidget extends infer Widget ? Widget extends TopoloWidget ? TopoloWidgetWithOptionalMetadata<Widget> : never : never;
+interface TopoloWidgetApiResponse {
+    success: boolean;
+    widgets: TopoloWidget[];
+    error?: string;
+}
+interface TopoloWidgetResponseOptions {
+    serviceId: string;
+    serviceName: string;
+    widgets: TopoloWidgetDraft[];
+    now?: Date | string;
+}
+interface TopoloWidgetValidationResult {
+    ok: boolean;
+    errors: string[];
+}
+interface TopoloWidgetConfig {
+    serviceId: string;
+    serviceName: string;
+    baseUrl: string;
+    widgetEndpoint: string;
+    enabled: boolean;
+    refreshInterval: number;
+}
+declare function defineTopoloStatsWidget(widget: Omit<TopoloStatsWidget, 'type'>): TopoloStatsWidget;
+declare function defineTopoloRecentActivityWidget(widget: Omit<TopoloRecentActivityWidget, 'type'>): TopoloRecentActivityWidget;
+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 createTopoloWidgetError(error: string): TopoloWidgetApiResponse;
+declare function validateTopoloWidgetResponse(response: unknown): TopoloWidgetValidationResult;
+
 /**
  * Convenience factory that returns a ready-to-use typed Topolo client plus
  * domain module surfaces (identity, crm, ...).
@@ -1079,4 +1358,4 @@ declare function createTopolo(options: TopoloClientOptions): {
 };
 type Topolo = ReturnType<typeof createTopolo>;
 
-export { APPLICATIONS, APPLICATION_REQUIREMENTS, APPLICATION_REQUIREMENTS_VERSION, type AgentIdentity, type ApplicationCatalogEntry, type ApplicationDeployTarget, type ApplicationId, type ApplicationRequirement, type ApplicationRequirementAudit, type ApplicationRequirementFinding, type ApplicationRequirementMigrationItem, type ApplicationRequirementScope, type ApplicationRequirementScore, type ApplicationRequirementStatus, type ApplicationRequirementsAuditReport, type CredentialIntrospection, type CrmContactSummary, CrmModule, DEFAULT_SERVICE_URLS, type DeviceAuthorizationResponse, IdentityModule, type ListContactsOptions, type ListContactsResult, type OAuthHelperOptions, PLATFORM_SERVICE_IDS, type RequestOptions, type ServiceId, type TokenResponse, type Topolo, TopoloAuthError, TopoloClient, type TopoloClientOptions, type TopoloCredential, type TopoloDebugEvent, TopoloHttpError, TopoloOAuth, TopoloPermissionError, TopoloSdkError, applicationRequirementScopes, auditAllApplicationRequirements, auditApplicationRequirements, createTopolo, requirementsForApplication, resolveServiceUrl };
+export { APPLICATIONS, APPLICATION_REQUIREMENTS, APPLICATION_REQUIREMENTS_VERSION, type AgentIdentity, type ApplicationCatalogEntry, type ApplicationDeployTarget, type ApplicationId, type ApplicationRequirement, type ApplicationRequirementAudit, type ApplicationRequirementFinding, type ApplicationRequirementMigrationItem, type ApplicationRequirementScope, type ApplicationRequirementScore, type ApplicationRequirementStatus, type ApplicationRequirementsAuditReport, type CredentialIntrospection, type CrmContactSummary, CrmModule, DEFAULT_SERVICE_URLS, type DeviceAuthorizationResponse, IdentityModule, type ListContactsOptions, type ListContactsResult, type OAuthHelperOptions, PLATFORM_SERVICE_IDS, type RequestOptions, type ServiceId, TOPOLO_WIDGET_ENDPOINT, TOPOLO_WIDGET_REFRESH_INTERVAL_MS, type TokenResponse, type Topolo, TopoloAuthError, type TopoloChartWidget, TopoloClient, type TopoloClientOptions, type TopoloCredential, type TopoloDebugEvent, TopoloHttpError, type TopoloNotificationsWidget, TopoloOAuth, TopoloPermissionError, type TopoloQuickActionsWidget, type TopoloRecentActivityWidget, TopoloSdkError, type TopoloStatsWidget, type TopoloWidget, type TopoloWidgetActionItem, type TopoloWidgetActivityItem, type TopoloWidgetApiResponse, type TopoloWidgetBase, type TopoloWidgetConfig, type TopoloWidgetDraft, type TopoloWidgetMetric, type TopoloWidgetNotificationItem, type TopoloWidgetResponseOptions, type TopoloWidgetType, type TopoloWidgetValidationResult, applicationRequirementScopes, auditAllApplicationRequirements, auditApplicationRequirements, createTopolo, createTopoloWidgetError, createTopoloWidgetResponse, defineTopoloChartWidget, defineTopoloNotificationsWidget, defineTopoloQuickActionsWidget, defineTopoloRecentActivityWidget, defineTopoloStatsWidget, requirementsForApplication, resolveServiceUrl, validateTopoloWidgetResponse };