@amigo-ai/platform-sdk 0.1.0

package/dist/types/core/errors.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Error hierarchy for the Amigo Platform SDK.
+ * All errors extend AmigoError which can be caught with a single catch.
+ */
+export interface ErrorContext {
+    statusCode?: number;
+    errorCode?: string;
+    requestId?: string;
+    detail?: string;
+}
+/** Base class for all Amigo Platform SDK errors */
+export declare class AmigoError extends Error {
+    readonly statusCode?: number;
+    readonly errorCode?: string;
+    readonly requestId?: string;
+    readonly detail?: string;
+    constructor(message: string, ctx?: ErrorContext);
+}
+/** 400 Bad Request */
+export declare class BadRequestError extends AmigoError {
+    constructor(message: string, ctx?: ErrorContext);
+}
+/** 401 Unauthorized — invalid or missing API key */
+export declare class AuthenticationError extends AmigoError {
+    constructor(message: string, ctx?: ErrorContext);
+}
+/** 403 Forbidden — insufficient permissions */
+export declare class PermissionError extends AmigoError {
+    constructor(message: string, ctx?: ErrorContext);
+}
+/** 404 Not Found */
+export declare class NotFoundError extends AmigoError {
+    constructor(message: string, ctx?: ErrorContext);
+}
+/** 409 Conflict — duplicate slug or resource version conflict */
+export declare class ConflictError extends AmigoError {
+    constructor(message: string, ctx?: ErrorContext);
+}
+/** 422 Unprocessable Entity — validation failure */
+export declare class ValidationError extends AmigoError {
+    constructor(message: string, ctx?: ErrorContext);
+}
+/** 429 Too Many Requests */
+export declare class RateLimitError extends AmigoError {
+    readonly retryAfter?: number;
+    constructor(message: string, ctx?: ErrorContext & {
+        retryAfter?: number;
+    });
+}
+/** 5xx Server Error */
+export declare class ServerError extends AmigoError {
+    constructor(message: string, ctx?: ErrorContext);
+}
+/** 503 Service Unavailable */
+export declare class ServiceUnavailableError extends ServerError {
+    constructor(message: string, ctx?: ErrorContext);
+}
+/** Network or fetch failure (no HTTP status available) */
+export declare class NetworkError extends AmigoError {
+    constructor(message: string, cause?: unknown);
+}
+/** Failed to parse response body */
+export declare class ParseError extends AmigoError {
+    readonly body?: string;
+    constructor(message: string, body?: string);
+}
+/** SDK misconfiguration */
+export declare class ConfigurationError extends AmigoError {
+    constructor(message: string);
+}
+export declare function createApiError(response: Response): Promise<AmigoError>;
+export declare function isAmigoError(err: unknown): err is AmigoError;
+export declare function isNotFoundError(err: unknown): err is NotFoundError;
+export declare function isRateLimitError(err: unknown): err is RateLimitError;
+export declare function isAuthenticationError(err: unknown): err is AuthenticationError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/types/core/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/core/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,YAAY;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,mDAAmD;AACnD,qBAAa,UAAW,SAAQ,KAAK;IACnC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;gBAEZ,OAAO,EAAE,MAAM,EAAE,GAAG,GAAE,YAAiB;CAUpD;AAED,sBAAsB;AACtB,qBAAa,eAAgB,SAAQ,UAAU;gBACjC,OAAO,EAAE,MAAM,EAAE,GAAG,GAAE,YAAiB;CAGpD;AAED,oDAAoD;AACpD,qBAAa,mBAAoB,SAAQ,UAAU;gBACrC,OAAO,EAAE,MAAM,EAAE,GAAG,GAAE,YAAiB;CAGpD;AAED,+CAA+C;AAC/C,qBAAa,eAAgB,SAAQ,UAAU;gBACjC,OAAO,EAAE,MAAM,EAAE,GAAG,GAAE,YAAiB;CAGpD;AAED,oBAAoB;AACpB,qBAAa,aAAc,SAAQ,UAAU;gBAC/B,OAAO,EAAE,MAAM,EAAE,GAAG,GAAE,YAAiB;CAGpD;AAED,iEAAiE;AACjE,qBAAa,aAAc,SAAQ,UAAU;gBAC/B,OAAO,EAAE,MAAM,EAAE,GAAG,GAAE,YAAiB;CAGpD;AAED,oDAAoD;AACpD,qBAAa,eAAgB,SAAQ,UAAU;gBACjC,OAAO,EAAE,MAAM,EAAE,GAAG,GAAE,YAAiB;CAGpD;AAED,4BAA4B;AAC5B,qBAAa,cAAe,SAAQ,UAAU;IAC5C,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;gBAEhB,OAAO,EAAE,MAAM,EAAE,GAAG,GAAE,YAAY,GAAG;QAAE,UAAU,CAAC,EAAE,MAAM,CAAA;KAAO;CAI9E;AAED,uBAAuB;AACvB,qBAAa,WAAY,SAAQ,UAAU;gBAC7B,OAAO,EAAE,MAAM,EAAE,GAAG,GAAE,YAAiB;CAGpD;AAED,8BAA8B;AAC9B,qBAAa,uBAAwB,SAAQ,WAAW;gBAC1C,OAAO,EAAE,MAAM,EAAE,GAAG,GAAE,YAAiB;CAGpD;AAED,0DAA0D;AAC1D,qBAAa,YAAa,SAAQ,UAAU;gBAC9B,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAM7C;AAED,oCAAoC;AACpC,qBAAa,UAAW,SAAQ,UAAU;IACxC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;gBAEV,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM;CAI3C;AAED,2BAA2B;AAC3B,qBAAa,kBAAmB,SAAQ,UAAU;gBACpC,OAAO,EAAE,MAAM;CAG5B;AAWD,wBAAsB,cAAc,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC,CAwC5E;AAgBD,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,UAAU,CAE5D;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,aAAa,CAElE;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,cAAc,CAEpE;AAED,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,mBAAmB,CAE9E"}

package/dist/types/core/openapi-client.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Creates a configured openapi-fetch client with auth, error handling, and retry middleware.
+ */
+import createClient from 'openapi-fetch';
+import type { paths } from '../types/api.js';
+import { type RetryOptions } from './retry.js';
+export type AmigoFetch = ReturnType<typeof createClient<paths>>;
+export interface ClientConfig {
+    apiKey: string;
+    baseUrl: string;
+    retry?: RetryOptions;
+}
+export declare function createAmigoClient(config: ClientConfig): AmigoFetch;
+//# sourceMappingURL=openapi-client.d.ts.map

package/dist/types/core/openapi-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi-client.d.ts","sourceRoot":"","sources":["../../../src/core/openapi-client.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,YAAiC,MAAM,eAAe,CAAA;AAC7D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAA;AAG5C,OAAO,EAAkD,KAAK,YAAY,EAAE,MAAM,YAAY,CAAA;AAE9F,MAAM,MAAM,UAAU,GAAG,UAAU,CAAC,OAAO,YAAY,CAAC,KAAK,CAAC,CAAC,CAAA;AAE/D,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,YAAY,CAAA;CACrB;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,YAAY,GAAG,UAAU,CA6DlE"}

package/dist/types/core/retry.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Exponential backoff with full jitter and Retry-After header support.
+ */
+export interface RetryOptions {
+    /** Maximum number of attempts (including the first). Default: 3 */
+    maxAttempts?: number;
+    /** Base delay in milliseconds. Default: 250 */
+    baseDelayMs?: number;
+    /** Maximum delay cap in milliseconds. Default: 30_000 */
+    maxDelayMs?: number;
+}
+export interface RetryContext {
+    method: string;
+    attempt: number;
+    response: Response;
+    options: Required<RetryOptions>;
+}
+export declare function shouldRetry(ctx: RetryContext): boolean;
+export declare function computeDelay(attempt: number, response: Response, options: Required<RetryOptions>): number;
+export declare function resolveRetryOptions(opts?: RetryOptions): Required<RetryOptions>;
+//# sourceMappingURL=retry.d.ts.map

package/dist/types/core/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../../src/core/retry.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,YAAY;IAC3B,mEAAmE;IACnE,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,+CAA+C;IAC/C,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,yDAAyD;IACzD,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAMD,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,QAAQ,CAAA;IAClB,OAAO,EAAE,QAAQ,CAAC,YAAY,CAAC,CAAA;CAChC;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAYtD;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,CAAC,YAAY,CAAC,GAAG,MAAM,CAUzG;AAYD,wBAAgB,mBAAmB,CAAC,IAAI,CAAC,EAAE,YAAY,GAAG,QAAQ,CAAC,YAAY,CAAC,CAM/E"}

package/dist/types/core/utils.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Shared utilities: response extraction and pagination helpers.
+ */
+/**
+ * Extracts the data payload from an openapi-fetch response,
+ * throwing ParseError if the response is empty or unexpected.
+ */
+export declare function extractData<T>(result: {
+    data?: T;
+    error?: unknown;
+}): T;
+/**
+ * Standard paginated list response shape.
+ */
+export interface PaginatedList<T> {
+    items: T[];
+    has_more: boolean;
+    continuation_token: number | null;
+}
+/**
+ * Standard query params for paginated list endpoints.
+ */
+export interface ListParams {
+    /** Max items per page. Default varies by endpoint. */
+    limit?: number;
+    /** Opaque token from previous response for next page. */
+    continuation_token?: number;
+}
+/**
+ * Async iterator that auto-paginates through all pages.
+ * Yields one item at a time.
+ *
+ * @example
+ * for await (const agent of paginate((token) => client.agents.list({ continuation_token: token }))) {
+ *   console.log(agent)
+ * }
+ */
+export declare function paginate<T>(fetcher: (continuationToken?: number) => Promise<PaginatedList<T>>): AsyncGenerator<T>;
+//# sourceMappingURL=utils.d.ts.map

package/dist/types/core/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/core/utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;;GAGG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE;IAAE,IAAI,CAAC,EAAE,CAAC,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,CAAC,CAMvE;AAED;;GAEG;AACH,MAAM,WAAW,aAAa,CAAC,CAAC;IAC9B,KAAK,EAAE,CAAC,EAAE,CAAA;IACV,QAAQ,EAAE,OAAO,CAAA;IACjB,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAA;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,sDAAsD;IACtD,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,yDAAyD;IACzD,kBAAkB,CAAC,EAAE,MAAM,CAAA;CAC5B;AAED;;;;;;;;GAQG;AACH,wBAAuB,QAAQ,CAAC,CAAC,EAC/B,OAAO,EAAE,CAAC,iBAAiB,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,GACjE,cAAc,CAAC,CAAC,CAAC,CAUnB"}

package/dist/types/index.d.ts

@@ -0,0 +1,114 @@
+/**
+ * @amigo-ai/platform-sdk
+ *
+ * Official TypeScript SDK for the Amigo Platform API.
+ *
+ * @example
+ * ```typescript
+ * import { AmigoClient } from '@amigo-ai/platform-sdk'
+ *
+ * const client = new AmigoClient({
+ *   apiKey: 'your-api-key',
+ *   workspaceId: 'your-workspace-id',
+ * })
+ *
+ * const agents = await client.agents.list()
+ * console.log(agents.items)
+ * ```
+ */
+import type { RetryOptions } from './core/retry.js';
+import { WorkspacesResource } from './resources/workspaces.js';
+import { ApiKeysResource } from './resources/api-keys.js';
+import { AgentsResource } from './resources/agents.js';
+import { SkillsResource } from './resources/skills.js';
+import { ServicesResource } from './resources/services.js';
+import { ContextGraphsResource } from './resources/context-graphs.js';
+import { DataSourcesResource } from './resources/data-sources.js';
+import { WorldResource } from './resources/world.js';
+import { CallsResource } from './resources/calls.js';
+import { PhoneNumbersResource } from './resources/phone-numbers.js';
+import { IntegrationsResource } from './resources/integrations.js';
+import { AnalyticsResource } from './resources/analytics.js';
+import { SimulationsResource } from './resources/simulations.js';
+import { SettingsResource } from './resources/settings.js';
+import { BillingResource } from './resources/billing.js';
+import { MemoryResource } from './resources/memory.js';
+export declare const DEFAULT_BASE_URL = "https://api.platform.amigo.ai";
+export interface AmigoClientConfig {
+    /**
+     * Your Amigo Platform API key.
+     * Create one at: Platform > Workspace Settings > API Keys
+     */
+    apiKey: string;
+    /**
+     * Your workspace ID. All resource operations are scoped to this workspace.
+     */
+    workspaceId: string;
+    /**
+     * Override the base URL. Defaults to https://api.platform.amigo.ai
+     * Useful for pointing at a staging environment.
+     */
+    baseUrl?: string;
+    /**
+     * Retry configuration for failed requests.
+     * Applies exponential backoff with full jitter.
+     */
+    retry?: RetryOptions;
+}
+/**
+ * The main entry point for the Amigo Platform SDK.
+ *
+ * Instantiate once and reuse across your application.
+ */
+export declare class AmigoClient {
+    /** Workspace management */
+    readonly workspaces: WorkspacesResource;
+    /** API key management */
+    readonly apiKeys: ApiKeysResource;
+    /** Agent management — AI agents that handle calls */
+    readonly agents: AgentsResource;
+    /** Skill management — reusable AI capabilities */
+    readonly skills: SkillsResource;
+    /** Service management — external service configurations */
+    readonly services: ServicesResource;
+    /** Context graph management — conversation flow structures */
+    readonly contextGraphs: ContextGraphsResource;
+    /** Data source management — external data connections */
+    readonly dataSources: DataSourcesResource;
+    /** World model — entities, events, and timelines */
+    readonly world: WorldResource;
+    /** Call records and intelligence */
+    readonly calls: CallsResource;
+    /** Phone number provisioning and management */
+    readonly phoneNumbers: PhoneNumbersResource;
+    /** Integration management — EHR, CRM, and other external systems */
+    readonly integrations: IntegrationsResource;
+    /** Analytics — aggregate metrics about calls and conversions */
+    readonly analytics: AnalyticsResource;
+    /** Simulation runs and interactive testing sessions */
+    readonly simulations: SimulationsResource;
+    /** Workspace-level settings (voice, branding, security, outreach, etc.) */
+    readonly settings: SettingsResource;
+    /** Billing — usage summaries and invoices */
+    readonly billing: BillingResource;
+    /** Agent Memory — structured long-term memory for entities */
+    readonly memory: MemoryResource;
+    constructor(config: AmigoClientConfig);
+}
+export type { AmigoClientConfig as AmigoConfig };
+export { AmigoError, BadRequestError, AuthenticationError, PermissionError, NotFoundError, ConflictError, ValidationError, RateLimitError, ServerError, ServiceUnavailableError, NetworkError, ParseError, ConfigurationError, isAmigoError, isNotFoundError, isRateLimitError, isAuthenticationError, } from './core/errors.js';
+export type { WorkspaceId, ApiKeyId, AgentId, SkillId, ServiceId, ContextGraphId, CallId, PhoneNumberId, IntegrationId, EntityId, EventId, SimulationRunId, SimulationSessionId, DataSourceId, } from './core/branded-types.js';
+export { workspaceId, apiKeyId, agentId, skillId, serviceId, contextGraphId, callId, phoneNumberId, integrationId, entityId, eventId, simulationRunId, simulationSessionId, dataSourceId, } from './core/branded-types.js';
+export { paginate } from './core/utils.js';
+export type { PaginatedList, ListParams } from './core/utils.js';
+export type { RetryOptions } from './core/retry.js';
+export type { VoiceSettings, BrandingSettings, BrandingConfig, OutreachSettings, OutreachRule, MemorySettings, MemoryDimensionConfig, SecuritySettings, RetentionSettings, WorkflowSettings, WorkflowConfig, } from './resources/settings.js';
+export type { UpdateDataSourceRequest } from './resources/data-sources.js';
+export type { ContextGraphVersion, } from './resources/context-graphs.js';
+export type { EntityRelationship, EntityGraph, EntityProvenance, EntityLineage, SyncEvent, SyncStatusBySink, SourceBreakdown, EntityStats, SearchEntitiesParams, } from './resources/world.js';
+export type { SimulationIntelligence, } from './resources/simulations.js';
+export type { CallDetail, CallIntelligence, CallTranscriptSegment, CallBenchmarks, } from './resources/calls.js';
+export type { MetricWithDelta, AnalyticsDashboard, CallAnalytics, AgentAnalytics, AgentAnalyticsResponse, CallQualityMetrics, EmotionTrends, LatencyMetrics, ToolPerformance, DataQualityMetrics, AdvancedCallStats, CallComparison, AnalyticsQueryParams, } from './resources/analytics.js';
+export type { DimensionScore, EntityDimensionsResponse, MemoryFact, EntityFactsResponse, DimensionAnalytics, MemoryAnalyticsResponse, } from './resources/memory.js';
+export type { Workspace, CreateWorkspaceRequest, UpdateWorkspaceRequest, ApiKey, ApiKeyRole, CreateApiKeyRequest, CreateApiKeyResponse, RotateApiKeyResponse, AuthMeResponse, Agent, AgentVersion, AgentIdentity, AgentVoiceConfig, CreateAgentRequest, UpdateAgentRequest, CreateAgentVersionRequest, Skill, ExecutionTier, CreateSkillRequest, UpdateSkillRequest, SkillTestRequest, SkillTestResponse, Service, CreateServiceRequest, UpdateServiceRequest, ContextGraph, CreateContextGraphRequest, UpdateContextGraphRequest, DataSource, CreateDataSourceRequest, Entity, EntityType, WorldEvent, TimelineEntry, CreateEntityRequest, UpdateEntityRequest, EmitEventRequest, MergeEntitiesRequest, Call, CallDirection, ListCallsParams, PhoneNumber, PhoneNumberForwarding, ProvisionPhoneNumberRequest, UpdatePhoneNumberRequest, Integration, IntegrationEndpoint, CreateIntegrationRequest, UpdateIntegrationRequest, AgentPerformance, UsageMeter, ServiceVersionSet, ServiceTag, ServiceVoiceConfig, SimulationSession, SimulationSnapshot, SimulationStepResponse, SimulationStepObservation, CreateSimulationSessionRequest, UsageSummary, Invoice, PaginatedResponse, } from './types/api.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,32 @@
+import type { Agent, AgentVersion, CreateAgentRequest, UpdateAgentRequest, CreateAgentVersionRequest, PaginatedResponse } from '../types/api.js';
+import type { AgentId } from '../core/branded-types.js';
+import { WorkspaceScopedResource } from './base.js';
+import type { ListParams } from '../core/utils.js';
+export interface ListAgentsParams extends ListParams {
+    search?: string;
+}
+export interface ListAgentVersionsParams extends ListParams {
+}
+/**
+ * Manage agents — the AI personas that handle calls and interactions.
+ * Each agent can be assigned skills, a persona, and a model.
+ */
+export declare class AgentsResource extends WorkspaceScopedResource {
+    /** Create a new agent */
+    create(body: CreateAgentRequest): Promise<Agent>;
+    /** List agents in the workspace */
+    list(params?: ListAgentsParams): Promise<PaginatedResponse<Agent>>;
+    /** Get a single agent */
+    get(agentId: AgentId | string): Promise<Agent>;
+    /** Update an agent's configuration */
+    update(agentId: AgentId | string, body: UpdateAgentRequest): Promise<Agent>;
+    /** Delete an agent */
+    delete(agentId: AgentId | string): Promise<void>;
+    /** List all versions of an agent */
+    listVersions(agentId: AgentId | string, params?: ListAgentVersionsParams): Promise<PaginatedResponse<AgentVersion>>;
+    /** Get a specific version of an agent — pass `"latest"` to get the most recent */
+    getVersion(agentId: AgentId | string, version: number | 'latest'): Promise<AgentVersion>;
+    /** Create a new version of an agent */
+    createVersion(agentId: AgentId | string, body: CreateAgentVersionRequest): Promise<AgentVersion>;
+}
+//# sourceMappingURL=agents.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../../../src/resources/agents.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,KAAK,EACL,YAAY,EACZ,kBAAkB,EAClB,kBAAkB,EAClB,yBAAyB,EACzB,iBAAiB,EAClB,MAAM,iBAAiB,CAAA;AACxB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAA;AACvD,OAAO,EAAE,uBAAuB,EAAc,MAAM,WAAW,CAAA;AAC/D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAElD,MAAM,WAAW,gBAAiB,SAAQ,UAAU;IAClD,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,uBAAwB,SAAQ,UAAU;CAAG;AAE9D;;;GAGG;AACH,qBAAa,cAAe,SAAQ,uBAAuB;IACzD,yBAAyB;IACnB,MAAM,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,KAAK,CAAC;IAOtD,mCAAmC;IAC7B,IAAI,CAAC,MAAM,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC;IAIxE,yBAAyB;IACnB,GAAG,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IAIpD,sCAAsC;IAChC,MAAM,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,EAAE,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,KAAK,CAAC;IAOjF,sBAAsB;IAChB,MAAM,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAItD,oCAAoC;IAC9B,YAAY,CAChB,OAAO,EAAE,OAAO,GAAG,MAAM,EACzB,MAAM,CAAC,EAAE,uBAAuB,GAC/B,OAAO,CAAC,iBAAiB,CAAC,YAAY,CAAC,CAAC;IAM3C,kFAAkF;IAC5E,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC,YAAY,CAAC;IAI9F,uCAAuC;IACjC,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,EAAE,IAAI,EAAE,yBAAyB,GAAG,OAAO,CAAC,YAAY,CAAC;CAMvG"}

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

@@ -0,0 +1,146 @@
+import { WorkspaceScopedResource } from './base.js';
+/** A metric value paired with its period-over-period change */
+export interface MetricWithDelta {
+    value: number | null;
+    delta_pct: number | null;
+}
+export interface AnalyticsQueryParams {
+    /** Shorthand period, e.g. "7d", "30d" */
+    period?: string;
+    start_date?: string;
+    end_date?: string;
+    agent_id?: string;
+}
+export interface AnalyticsDashboard {
+    call_volume: MetricWithDelta;
+    avg_quality: MetricWithDelta;
+    avg_ttfb_ms: MetricWithDelta;
+    escalation_rate: MetricWithDelta;
+    tool_success_rate: MetricWithDelta;
+    avg_duration_s: MetricWithDelta;
+    period_days: number;
+}
+export interface CallAnalytics {
+    workspace_id: string;
+    period_start: string;
+    period_end: string;
+    total_calls: number;
+    total_duration_seconds: number;
+    avg_duration_seconds: number;
+    calls_by_date: Array<{
+        date: string;
+        count: number;
+    }>;
+}
+export interface AgentAnalytics {
+    agent_id: string;
+    agent_name: string;
+    total_calls: number;
+    completed_calls: number;
+    avg_duration_seconds: number;
+    completion_rate: number;
+}
+export interface AgentAnalyticsResponse {
+    agents: AgentAnalytics[];
+    period: string;
+}
+export interface CallQualityMetrics {
+    avg_sentiment: number | null;
+    positive_pct: number;
+    negative_pct: number;
+    neutral_pct: number;
+    avg_transcription_confidence: number | null;
+    flagged_calls: number;
+}
+export interface EmotionTrends {
+    data: Array<{
+        date: string;
+        emotions: Record<string, number>;
+    }>;
+}
+export interface LatencyMetrics {
+    avg_ttfb_ms: number;
+    p50_ttfb_ms: number;
+    p95_ttfb_ms: number;
+    avg_response_ms: number;
+    p95_response_ms: number;
+}
+export interface ToolPerformance {
+    tool_name: string;
+    call_count: number;
+    success_rate: number;
+    avg_latency_ms: number;
+}
+export interface DataQualityMetrics {
+    completeness_score: number;
+    duplicate_rate: number;
+    missing_canonical_id_pct: number;
+    stale_entities: number;
+}
+export interface AdvancedCallStats {
+    abandonment_rate: number;
+    transfer_rate: number;
+    avg_silence_pct: number;
+    avg_interruptions: number;
+    by_hour_of_day: Array<{
+        hour: number;
+        count: number;
+    }>;
+    by_day_of_week: Array<{
+        day: string;
+        count: number;
+    }>;
+}
+export interface CallComparison {
+    period_a: {
+        start: string;
+        end: string;
+        calls: number;
+        conversion_rate: number;
+    };
+    period_b: {
+        start: string;
+        end: string;
+        calls: number;
+        conversion_rate: number;
+    };
+    change_pct: Record<string, number>;
+}
+/**
+ * Analytics — aggregate metrics about calls, agents, quality, and usage.
+ */
+export declare class AnalyticsResource extends WorkspaceScopedResource {
+    /** High-level dashboard summary — pass `days` (default: 7) for the lookback window */
+    getDashboard(params?: {
+        days?: number;
+    }): Promise<AnalyticsDashboard>;
+    /** Call volume and duration metrics */
+    getCalls(params?: AnalyticsQueryParams): Promise<CallAnalytics>;
+    /** Per-agent performance breakdown */
+    getAgents(params?: {
+        period?: string;
+    }): Promise<AgentAnalyticsResponse>;
+    /** Call quality — sentiment, transcription confidence, flagged calls */
+    getCallQuality(params?: AnalyticsQueryParams): Promise<CallQualityMetrics>;
+    /** Emotion trend data over time */
+    getEmotionTrends(params?: AnalyticsQueryParams): Promise<EmotionTrends>;
+    /** Voice pipeline latency metrics (TTFB, response time) */
+    getLatency(params?: AnalyticsQueryParams): Promise<LatencyMetrics>;
+    /** Tool call performance — success rates and latency per tool */
+    getToolPerformance(params?: AnalyticsQueryParams): Promise<ToolPerformance[]>;
+    /** Data quality metrics for the workspace world model */
+    getDataQuality(params?: AnalyticsQueryParams): Promise<DataQualityMetrics>;
+    /** Usage summary — API requests, call minutes, storage */
+    getUsage(params?: AnalyticsQueryParams): Promise<Record<string, unknown>>;
+    /** Advanced call statistics (abandonment, transfers, silence, hour-of-day) */
+    getAdvancedCallStats(params?: AnalyticsQueryParams): Promise<AdvancedCallStats>;
+    /** Compare two time periods side by side */
+    compareCallPeriods(params: {
+        current_from: string;
+        current_to: string;
+        previous_from: string;
+        previous_to: string;
+        service_id?: string;
+    }): Promise<CallComparison>;
+}
+//# sourceMappingURL=analytics.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"analytics.d.ts","sourceRoot":"","sources":["../../../src/resources/analytics.ts"],"names":[],"mappings":"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"}

package/dist/types/resources/api-keys.d.ts

@@ -0,0 +1,28 @@
+import type { ApiKey, CreateApiKeyRequest, CreateApiKeyResponse, RotateApiKeyResponse, AuthMeResponse, PaginatedResponse } from '../types/api.js';
+import type { ApiKeyId } from '../core/branded-types.js';
+import { WorkspaceScopedResource } from './base.js';
+import type { ListParams } from '../core/utils.js';
+/**
+ * Manage API keys for a workspace.
+ *
+ * API keys are used to authenticate SDK/API requests. Each key has a role
+ * and a set of permissions. Keys expire after 1-90 days.
+ */
+export declare class ApiKeysResource extends WorkspaceScopedResource {
+    /**
+     * Get info about the currently authenticated API key.
+     * Does not require a workspace ID in the path.
+     */
+    me(): Promise<AuthMeResponse>;
+    /** Create a new API key */
+    create(body: CreateApiKeyRequest): Promise<CreateApiKeyResponse>;
+    /** List API keys in the workspace */
+    list(params?: ListParams): Promise<PaginatedResponse<ApiKey>>;
+    /** Get a specific API key */
+    get(keyId: ApiKeyId | string): Promise<ApiKey>;
+    /** Revoke an API key */
+    revoke(keyId: ApiKeyId | string): Promise<void>;
+    /** Rotate an API key — invalidates the old key and issues a new one */
+    rotate(keyId: ApiKeyId | string): Promise<RotateApiKeyResponse>;
+}
+//# sourceMappingURL=api-keys.d.ts.map

package/dist/types/resources/api-keys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-keys.d.ts","sourceRoot":"","sources":["../../../src/resources/api-keys.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,MAAM,EACN,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,EACpB,cAAc,EACd,iBAAiB,EAClB,MAAM,iBAAiB,CAAA;AACxB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAA;AACxD,OAAO,EAAE,uBAAuB,EAAc,MAAM,WAAW,CAAA;AAC/D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAGlD;;;;;GAKG;AACH,qBAAa,eAAgB,SAAQ,uBAAuB;IAC1D;;;OAGG;IACG,EAAE,IAAI,OAAO,CAAC,cAAc,CAAC;IAOnC,2BAA2B;IACrB,MAAM,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAOtE,qCAAqC;IAC/B,IAAI,CAAC,MAAM,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAInE,6BAA6B;IACvB,GAAG,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAIpD,wBAAwB;IAClB,MAAM,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIrD,uEAAuE;IACjE,MAAM,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC;CAGtE"}

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

@@ -0,0 +1,18 @@
+/**
+ * Base class for all workspace-scoped resources.
+ * Handles URL construction, auth headers, and error conversion.
+ */
+export interface ResourceConfig {
+    apiKey: string;
+    baseUrl: string;
+    workspaceId: string;
+}
+export declare abstract class WorkspaceScopedResource {
+    protected readonly config: ResourceConfig;
+    constructor(config: ResourceConfig);
+    protected get headers(): Record<string, string>;
+    protected workspaceUrl(path: string): string;
+    protected fetch<T>(path: string, init?: RequestInit): Promise<T>;
+}
+export declare function buildQuery(params?: any): string;
+//# sourceMappingURL=base.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../src/resources/base.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,EAAE,MAAM,CAAA;CACpB;AAED,8BAAsB,uBAAuB;IAC/B,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,cAAc;gBAAtB,MAAM,EAAE,cAAc;IAErD,SAAS,KAAK,OAAO,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAK9C;IAED,SAAS,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;cAI5B,KAAK,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,WAAgB,GAAG,OAAO,CAAC,CAAC,CAAC;CAe3E;AAGD,wBAAgB,UAAU,CAAC,MAAM,CAAC,EAAE,GAAG,GAAG,MAAM,CAW/C"}

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

@@ -0,0 +1,19 @@
+import type { UsageSummary, Invoice, PaginatedResponse } from '../types/api.js';
+import { WorkspaceScopedResource } from './base.js';
+export interface UsageQueryParams {
+    start_date?: string;
+    end_date?: string;
+}
+/**
+ * Billing — usage summaries and invoices.
+ */
+export declare class BillingResource extends WorkspaceScopedResource {
+    /** Get usage summary for a time period */
+    getUsage(params?: UsageQueryParams): Promise<UsageSummary>;
+    /** List invoices */
+    listInvoices(params?: {
+        limit?: number;
+        continuation_token?: number;
+    }): Promise<PaginatedResponse<Invoice>>;
+}
+//# sourceMappingURL=billing.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"billing.d.ts","sourceRoot":"","sources":["../../../src/resources/billing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AAC/E,OAAO,EAAE,uBAAuB,EAAc,MAAM,WAAW,CAAA;AAE/D,MAAM,WAAW,gBAAgB;IAC/B,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,uBAAuB;IAC1D,0CAA0C;IACpC,QAAQ,CAAC,MAAM,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,YAAY,CAAC;IAIhE,oBAAoB;IACd,YAAY,CAAC,MAAM,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,kBAAkB,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;CAGlH"}

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

@@ -0,0 +1,50 @@
+import type { Call, ListCallsParams, PaginatedResponse } from '../types/api.js';
+import { WorkspaceScopedResource } from './base.js';
+export interface CallIntelligence {
+    summary: string | null;
+    sentiment: string | null;
+    key_moments: Array<{
+        type: string;
+        description: string;
+        timestamp_s: number;
+    }>;
+    action_items: string[];
+    outcomes: string[];
+}
+export interface CallTranscriptSegment {
+    speaker: 'agent' | 'customer';
+    text: string;
+    start_seconds: number;
+    end_seconds: number;
+}
+export interface CallDetail extends Call {
+    intelligence: CallIntelligence | null;
+    transcript: CallTranscriptSegment[];
+}
+export interface CallBenchmarks {
+    workspace_id: string;
+    period_start: string;
+    period_end: string;
+    avg_duration_seconds: number;
+    answer_rate: number | null;
+    completion_rate: number | null;
+}
+/**
+ * Access call records and intelligence.
+ * Calls are read-only in the SDK — they are created by the voice pipeline.
+ */
+export declare class CallsResource extends WorkspaceScopedResource {
+    /** List calls with optional filtering */
+    list(params?: ListCallsParams): Promise<PaginatedResponse<Call>>;
+    /** Get full call detail including transcript and intelligence */
+    get(callSid: string): Promise<CallDetail>;
+    /** Get AI intelligence for a call */
+    getIntelligence(callSid: string): Promise<CallIntelligence>;
+    /** Get active intelligence across all in-progress calls */
+    getActiveIntelligence(): Promise<Record<string, unknown>[]>;
+    /** Get performance benchmarks for a time period */
+    getBenchmarks(params?: {
+        days?: number;
+    }): Promise<CallBenchmarks>;
+}
+//# sourceMappingURL=calls.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"calls.d.ts","sourceRoot":"","sources":["../../../src/resources/calls.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,IAAI,EACJ,eAAe,EACf,iBAAiB,EAClB,MAAM,iBAAiB,CAAA;AACxB,OAAO,EAAE,uBAAuB,EAAc,MAAM,WAAW,CAAA;AAE/D,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,WAAW,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAC9E,YAAY,EAAE,MAAM,EAAE,CAAA;IACtB,QAAQ,EAAE,MAAM,EAAE,CAAA;CACnB;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,OAAO,GAAG,UAAU,CAAA;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,aAAa,EAAE,MAAM,CAAA;IACrB,WAAW,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,UAAW,SAAQ,IAAI;IACtC,YAAY,EAAE,gBAAgB,GAAG,IAAI,CAAA;IACrC,UAAU,EAAE,qBAAqB,EAAE,CAAA;CACpC;AAED,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,MAAM,CAAA;IACpB,YAAY,EAAE,MAAM,CAAA;IACpB,UAAU,EAAE,MAAM,CAAA;IAClB,oBAAoB,EAAE,MAAM,CAAA;IAC5B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,eAAe,EAAE,MAAM,GAAG,IAAI,CAAA;CAC/B;AAED;;;GAGG;AACH,qBAAa,aAAc,SAAQ,uBAAuB;IACxD,yCAAyC;IACnC,IAAI,CAAC,MAAM,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAItE,iEAAiE;IAC3D,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAI/C,qCAAqC;IAC/B,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAIjE,2DAA2D;IACrD,qBAAqB,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IAIjE,mDAAmD;IAC7C,aAAa,CAAC,MAAM,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,cAAc,CAAC;CAGzE"}