@amigo-ai/platform-sdk 0.26.0 → 0.29.0

package/dist/types/resources/command-center.d.ts

@@ -0,0 +1,55 @@
+import { WorkspaceScopedResource } from './base.js';
+/**
+ * Command Center — single rolled-up snapshot used to drive the developer
+ * console's homepage tiles (active calls, queue depth, alerting status,
+ * recent escalations, etc.). One endpoint, refreshed on demand.
+ *
+ * @beta New in this release; surface may evolve.
+ */
+export declare class CommandCenterResource extends WorkspaceScopedResource {
+    /** Get the current command-center snapshot */
+    get(): Promise<{
+        alerts?: {
+            code: string;
+            level: "info" | "warning" | "critical";
+            message: string;
+            section: string;
+        }[] | undefined;
+        cached?: boolean | undefined;
+        data_quality?: {
+            approval_rate_7d?: number | null | undefined;
+            avg_confidence?: number | null | undefined;
+            entities_merged_7d?: number | undefined;
+            entities_total?: number | undefined;
+            pending_reviews?: number | undefined;
+        } | undefined;
+        degraded_sections?: string[] | undefined;
+        generated_at: string;
+        identity?: {
+            active_api_keys?: number | undefined;
+            active_sessions?: number | null | undefined;
+            failed_auths_1h?: number | null | undefined;
+            locked_accounts?: number | null | undefined;
+            mfa_coverage_pct?: number | null | undefined;
+        } | undefined;
+        pipeline?: {
+            connector_status?: "healthy" | "degraded" | "unavailable" | undefined;
+            events_last_hour?: number | undefined;
+            outbound_failed?: number | undefined;
+            outbound_pending?: number | undefined;
+            sources_degraded?: number | undefined;
+            sources_failing?: number | undefined;
+            sources_healthy?: number | undefined;
+            sources_total?: number | undefined;
+        } | undefined;
+        voice?: {
+            active_calls?: number | undefined;
+            active_escalated?: number | undefined;
+            avg_quality_score_today?: number | null | undefined;
+            calls_today?: number | undefined;
+            escalation_rate_today?: number | undefined;
+        } | undefined;
+        workspace_id: string;
+    } & import("../index.js").ResponseMetadata>;
+}
+//# sourceMappingURL=command-center.d.ts.map

package/dist/types/resources/command-center.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-center.d.ts","sourceRoot":"","sources":["../../../src/resources/command-center.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAe,MAAM,WAAW,CAAA;AAEhE;;;;;;GAMG;AACH,qBAAa,qBAAsB,SAAQ,uBAAuB;IAChE,8CAA8C;IACxC,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAOV"}

package/dist/types/resources/crm.d.ts

@@ -0,0 +1,207 @@
+import type { paths } from '../generated/api.js';
+import { WorkspaceScopedResource } from './base.js';
+export type CrmContactSearchParams = NonNullable<paths['/v1/{workspace_id}/crm/contacts']['get']['parameters']['query']>;
+export type CrmCompanySearchParams = NonNullable<paths['/v1/{workspace_id}/crm/companies']['get']['parameters']['query']>;
+export type CrmDealSearchParams = NonNullable<paths['/v1/{workspace_id}/crm/deals']['get']['parameters']['query']>;
+/**
+ * CRM — read-mostly view of contacts, companies, deals, and pipeline state
+ * sourced from the connected CRM integration (HubSpot/Salesforce/etc.).
+ *
+ * The platform refreshes this view in the background; the SDK exposes search
+ * + detail endpoints plus a per-contact activity timeline. Writes happen
+ * upstream in the CRM itself, not here.
+ *
+ * @beta New in this release; surface may evolve.
+ */
+export declare class CrmResource extends WorkspaceScopedResource {
+    /** Health/status of the workspace's CRM integration sync */
+    getStatus(): Promise<{
+        company_count?: number | undefined;
+        configured: boolean;
+        connector_type?: string | null | undefined;
+        contact_count?: number | undefined;
+        data_source_id?: string | null | undefined;
+        deal_count?: number | undefined;
+        last_sync_at?: string | null | undefined;
+        last_sync_status?: ("success" | "error") | null | undefined;
+        sync_failure_count?: number | undefined;
+        sync_healthy?: boolean | null | undefined;
+    } & import("../index.js").ResponseMetadata>;
+    readonly contacts: {
+        list: (params?: CrmContactSearchParams) => Promise<{
+            contacts: {
+                address?: {
+                    [x: string]: unknown;
+                } | null | undefined;
+                birth_date?: string | null | undefined;
+                company?: string | null | undefined;
+                confidence?: number | undefined;
+                created_at?: string | null | undefined;
+                email?: string | null | undefined;
+                entity_id: string;
+                event_count?: number | undefined;
+                first_name?: string | null | undefined;
+                gender?: string | null | undefined;
+                hubspot_id?: string | null | undefined;
+                last_activity_at?: string | null | undefined;
+                last_name?: string | null | undefined;
+                lifecycle_stage?: string | null | undefined;
+                mrn?: string | null | undefined;
+                name?: string | null | undefined;
+                phone?: string | null | undefined;
+                source_system?: string | null | undefined;
+            }[];
+            has_more?: boolean | undefined;
+            next_offset?: number | null | undefined;
+            total: number;
+        } & import("../index.js").ResponseMetadata>;
+        get: (contactId: string) => Promise<{
+            address?: {
+                [x: string]: unknown;
+            } | null | undefined;
+            birth_date?: string | null | undefined;
+            canonical_id?: string | null | undefined;
+            clinical?: {
+                [x: string]: unknown;
+            } | undefined;
+            company?: string | null | undefined;
+            confidence?: number | undefined;
+            created_at?: string | null | undefined;
+            email?: string | null | undefined;
+            entity_id: string;
+            event_count?: number | undefined;
+            external_ids?: {
+                [x: string]: unknown;
+            } | undefined;
+            first_name?: string | null | undefined;
+            gender?: string | null | undefined;
+            hubspot_id?: string | null | undefined;
+            last_activity_at?: string | null | undefined;
+            last_name?: string | null | undefined;
+            lifecycle_stage?: string | null | undefined;
+            merged_with?: {
+                address?: {
+                    [x: string]: unknown;
+                } | null | undefined;
+                birth_date?: string | null | undefined;
+                company?: string | null | undefined;
+                confidence?: number | undefined;
+                created_at?: string | null | undefined;
+                email?: string | null | undefined;
+                entity_id: string;
+                event_count?: number | undefined;
+                first_name?: string | null | undefined;
+                gender?: string | null | undefined;
+                hubspot_id?: string | null | undefined;
+                last_activity_at?: string | null | undefined;
+                last_name?: string | null | undefined;
+                lifecycle_stage?: string | null | undefined;
+                mrn?: string | null | undefined;
+                name?: string | null | undefined;
+                phone?: string | null | undefined;
+                source_system?: string | null | undefined;
+            }[] | undefined;
+            mrn?: string | null | undefined;
+            name?: string | null | undefined;
+            operational?: {
+                [x: string]: unknown;
+            } | undefined;
+            phone?: string | null | undefined;
+            source_system?: string | null | undefined;
+        } & import("../index.js").ResponseMetadata>;
+        /** Per-contact activity timeline (calls, emails, deal events) */
+        getTimeline: (contactId: string) => Promise<{
+            activities: {
+                activity_type: string;
+                confidence?: number | undefined;
+                data?: {
+                    [x: string]: unknown;
+                } | undefined;
+                description?: string | null | undefined;
+                direction?: string | null | undefined;
+                id: string;
+                occurred_at?: string | null | undefined;
+                source?: string | undefined;
+                source_system?: string | null | undefined;
+            }[];
+            entity_id: string;
+            has_more?: boolean | undefined;
+            total: number;
+        } & import("../index.js").ResponseMetadata>;
+    };
+    readonly companies: {
+        list: (params?: CrmCompanySearchParams) => Promise<{
+            companies: {
+                address?: {
+                    [x: string]: unknown;
+                } | null | undefined;
+                created_at?: string | null | undefined;
+                domain?: string | null | undefined;
+                entity_id: string;
+                event_count?: number | undefined;
+                hubspot_id?: string | null | undefined;
+                industry?: string | null | undefined;
+                last_activity_at?: string | null | undefined;
+                name?: string | null | undefined;
+                phone?: string | null | undefined;
+                source_system?: string | null | undefined;
+            }[];
+            has_more?: boolean | undefined;
+            next_offset?: number | null | undefined;
+            total: number;
+        } & import("../index.js").ResponseMetadata>;
+        get: (companyId: string) => Promise<{
+            address?: {
+                [x: string]: unknown;
+            } | null | undefined;
+            created_at?: string | null | undefined;
+            domain?: string | null | undefined;
+            entity_id: string;
+            event_count?: number | undefined;
+            hubspot_id?: string | null | undefined;
+            industry?: string | null | undefined;
+            last_activity_at?: string | null | undefined;
+            name?: string | null | undefined;
+            phone?: string | null | undefined;
+            source_system?: string | null | undefined;
+        } & import("../index.js").ResponseMetadata>;
+    };
+    readonly deals: {
+        list: (params?: CrmDealSearchParams) => Promise<{
+            deals: {
+                amount?: number | null | undefined;
+                close_date?: string | null | undefined;
+                created_at?: string | null | undefined;
+                deal_type?: string | null | undefined;
+                entity_id: string;
+                event_count?: number | undefined;
+                hubspot_id?: string | null | undefined;
+                last_activity_at?: string | null | undefined;
+                name?: string | null | undefined;
+                pipeline?: string | null | undefined;
+                stage?: string | null | undefined;
+            }[];
+            has_more?: boolean | undefined;
+            next_offset?: number | null | undefined;
+            total: number;
+        } & import("../index.js").ResponseMetadata>;
+        get: (dealId: string) => Promise<{
+            amount?: number | null | undefined;
+            close_date?: string | null | undefined;
+            created_at?: string | null | undefined;
+            deal_type?: string | null | undefined;
+            entity_id: string;
+            event_count?: number | undefined;
+            hubspot_id?: string | null | undefined;
+            last_activity_at?: string | null | undefined;
+            name?: string | null | undefined;
+            pipeline?: string | null | undefined;
+            stage?: string | null | undefined;
+        } & import("../index.js").ResponseMetadata>;
+        /** Aggregated pipeline view: deals grouped by stage with rolled-up totals */
+        getPipeline: () => Promise<{
+            [x: string]: unknown;
+        } & import("../index.js").ResponseMetadata>;
+    };
+}
+//# sourceMappingURL=crm.d.ts.map

package/dist/types/resources/crm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crm.d.ts","sourceRoot":"","sources":["../../../src/resources/crm.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAA;AAChD,OAAO,EAAE,uBAAuB,EAAe,MAAM,WAAW,CAAA;AAEhE,MAAM,MAAM,sBAAsB,GAAG,WAAW,CAC9C,KAAK,CAAC,iCAAiC,CAAC,CAAC,KAAK,CAAC,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC,CACvE,CAAA;AACD,MAAM,MAAM,sBAAsB,GAAG,WAAW,CAC9C,KAAK,CAAC,kCAAkC,CAAC,CAAC,KAAK,CAAC,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC,CACxE,CAAA;AACD,MAAM,MAAM,mBAAmB,GAAG,WAAW,CAC3C,KAAK,CAAC,8BAA8B,CAAC,CAAC,KAAK,CAAC,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC,CACpE,CAAA;AAED;;;;;;;;;GASG;AACH,qBAAa,WAAY,SAAQ,uBAAuB;IACtD,4DAA4D;IACtD,SAAS;;;;;;;;;;;;IAQf,QAAQ,CAAC,QAAQ;wBACO,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;yBAOrB,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAO7B,iEAAiE;iCAClC,MAAM;;;;;;;;;;;;;;;;;;MAMtC;IAED,QAAQ,CAAC,SAAS;wBACM,sBAAsB;;;;;;;;;;;;;;;;;;;;yBAOrB,MAAM;;;;;;;;;;;;;;;MAM9B;IAED,QAAQ,CAAC,KAAK;wBACU,mBAAmB;;;;;;;;;;;;;;;;;;sBAOrB,MAAM;;;;;;;;;;;;;QAO1B,6EAA6E;;;;MAO9E;CACF"}

package/dist/types/resources/data-query.d.ts

@@ -0,0 +1,23 @@
+import type { paths } from '../generated/api.js';
+import { WorkspaceScopedResource } from './base.js';
+export type DataQueryParams = NonNullable<paths['/v1/{workspace_id}/query/{schema}/{table}']['get']['parameters']['query']>;
+/**
+ * Generic typed data query — read rows from any whitelisted schema/table the
+ * workspace exposes. Backed by the platform's catalog of analytics-grade
+ * datasets; the schema and table are validated server-side.
+ *
+ * Used by the developer console's data-explorer surface.
+ *
+ * @beta New in this release; surface may evolve.
+ */
+export declare class DataQueryResource extends WorkspaceScopedResource {
+    /** Run a tabular query against a workspace dataset */
+    run(schema: string, table: string, params?: DataQueryParams): Promise<{
+        count: number;
+        has_more: boolean;
+        items: {
+            [x: string]: unknown;
+        }[];
+    } & import("../index.js").ResponseMetadata>;
+}
+//# sourceMappingURL=data-query.d.ts.map

package/dist/types/resources/data-query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-query.d.ts","sourceRoot":"","sources":["../../../src/resources/data-query.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAA;AAChD,OAAO,EAAE,uBAAuB,EAAe,MAAM,WAAW,CAAA;AAEhE,MAAM,MAAM,eAAe,GAAG,WAAW,CACvC,KAAK,CAAC,2CAA2C,CAAC,CAAC,KAAK,CAAC,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC,CACjF,CAAA;AAED;;;;;;;;GAQG;AACH,qBAAa,iBAAkB,SAAQ,uBAAuB;IAC5D,sDAAsD;IAChD,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,eAAe;;;;;;;CAUlE"}

package/dist/types/resources/desktop-sessions.d.ts

@@ -0,0 +1,38 @@
+import type { components } from '../generated/api.js';
+import { WorkspaceScopedResource } from './base.js';
+type CreateDesktopSessionRequest = components['schemas']['src__routes__desktop_sessions__CreateSessionRequest'];
+/**
+ * Desktop sessions — remote-controlled desktop instances the agent can use
+ * to drive third-party apps (EHRs, CRMs) that lack APIs. Created on demand
+ * and torn down when the agent finishes the workflow.
+ *
+ * @beta New in this release; surface may evolve.
+ */
+export declare class DesktopSessionsResource extends WorkspaceScopedResource {
+    /** Spin up a new desktop session */
+    create(body: CreateDesktopSessionRequest): Promise<{
+        connected: boolean;
+        display_size: number[];
+        session_id: string;
+    } & import("../index.js").ResponseMetadata>;
+    /** Disconnect / tear down a desktop session */
+    disconnect(sessionId: string): Promise<{
+        ok: boolean;
+    } & import("../index.js").ResponseMetadata>;
+    /** Drive a click / type / scroll action against the session */
+    sendAction(sessionId: string, body: components['schemas']['ActionRequest']): Promise<{
+        ok: boolean;
+    } & import("../index.js").ResponseMetadata>;
+    /** Get the latest screenshot for a session */
+    getScreenshot(sessionId: string): Promise<unknown>;
+    /** Get the session's current connection + activity status */
+    getStatus(sessionId: string): Promise<{
+        connected: boolean;
+        created_at: number;
+        healthy: boolean;
+        idle_seconds: number;
+        session_id: string;
+    } & import("../index.js").ResponseMetadata>;
+}
+export {};
+//# sourceMappingURL=desktop-sessions.d.ts.map

package/dist/types/resources/desktop-sessions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"desktop-sessions.d.ts","sourceRoot":"","sources":["../../../src/resources/desktop-sessions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AACrD,OAAO,EAAE,uBAAuB,EAAe,MAAM,WAAW,CAAA;AAUhE,KAAK,2BAA2B,GAC9B,UAAU,CAAC,SAAS,CAAC,CAAC,qDAAqD,CAAC,CAAA;AAE9E;;;;;;GAMG;AACH,qBAAa,uBAAwB,SAAQ,uBAAuB;IAClE,oCAAoC;IAC9B,MAAM,CAAC,IAAI,EAAE,2BAA2B;;;;;IAS9C,+CAA+C;IACzC,UAAU,CAAC,SAAS,EAAE,MAAM;;;IAQlC,+DAA+D;IACzD,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC,eAAe,CAAC;;;IAShF,8CAA8C;IACxC,aAAa,CAAC,SAAS,EAAE,MAAM;IAQrC,6DAA6D;IACvD,SAAS,CAAC,SAAS,EAAE,MAAM;;;;;;;CAOlC"}