@amigo-ai/platform-sdk 0.26.0 → 0.27.0

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

@@ -1,6 +1,8 @@
-import type { components } from '../generated/api.js';
-import type { SimulationSessionId } from '../core/branded-types.js';
+import type { components, paths } from '../generated/api.js';
+import type { ServiceId, SimulationRunId, SimulationSessionId } from '../core/branded-types.js';
 import { WorkspaceScopedResource } from './base.js';
+type CreateSimulationSessionRequest = components['schemas']['src__routes__simulations__CreateSessionRequest'];
+export type ListSimulationRunsParams = NonNullable<paths['/v1/{workspace_id}/simulations/runs']['get']['parameters']['query']>;
 /**
  * Simulations — interactive agent testing via the Playground.
  *
@@ -10,7 +12,7 @@ import { WorkspaceScopedResource } from './base.js';
  */
 export declare class SimulationsResource extends WorkspaceScopedResource {
     /** Start a simulation session — returns the agent's greeting and initial snapshot */
-    createSession(body: components['schemas']['src__routes__simulations__CreateSessionRequest']): Promise<{
+    createSession(body: CreateSimulationSessionRequest): Promise<{
         greeting: string;
         is_terminal: boolean;
         session_id: string;
@@ -192,5 +194,186 @@ export declare class SimulationsResource extends WorkspaceScopedResource {
         };
         session_id: string;
     } & import("../index.js").ResponseMetadata>;
+    /**
+     * Multi-session simulation runs — orchestrate a batch of scenarios against
+     * a service to compute coverage and surface regressions. Use this when you
+     * want to compare branch behavior or measure drift between versions.
+     *
+     * @beta New in this release; surface may evolve.
+     */
+    readonly runs: {
+        /** List simulation runs in the workspace */
+        list: (params?: ListSimulationRunsParams) => Promise<{
+            [x: string]: unknown;
+        } & import("../index.js").ResponseMetadata>;
+        /** Create a new simulation run */
+        create: (body: components["schemas"]["CreateRunRequest"]) => Promise<{
+            [x: string]: unknown;
+        } & import("../index.js").ResponseMetadata>;
+        /** Get a simulation run with its scenarios + status */
+        get: (runId: SimulationRunId | string) => Promise<{
+            branch_name?: string | null | undefined;
+            bridge_request?: {
+                [x: string]: unknown;
+            } | null | undefined;
+            completed_at?: string | null | undefined;
+            created_at?: string | null | undefined;
+            id: string;
+            objective?: string | null | undefined;
+            scenarios?: {
+                [x: string]: unknown;
+            }[] | null | undefined;
+            service_id: string;
+            status: "running" | "completed" | "failed";
+            tags?: string[] | undefined;
+            total_scenarios_requested?: number | null | undefined;
+            total_sessions?: number | undefined;
+            total_turns?: number | undefined;
+        } & import("../index.js").ResponseMetadata>;
+        /** Mark a run as complete (used by the harness once all sessions finish) */
+        complete: (runId: SimulationRunId | string) => Promise<{
+            [x: string]: string;
+        } & import("../index.js").ResponseMetadata>;
+        /** Spin up a session under a run (single scenario inside the run's batch) */
+        createSession: (runId: SimulationRunId | string, body: CreateSimulationSessionRequest) => Promise<{
+            greeting: string;
+            is_terminal: boolean;
+            session_id: string;
+            snapshot: {
+                [x: string]: unknown;
+                context_graph_topology?: {
+                    [x: string]: string;
+                }[] | undefined;
+                conversation_history?: {
+                    [x: string]: unknown;
+                }[] | undefined;
+                current_state: {
+                    [x: string]: unknown;
+                    action_guidelines?: string[] | undefined;
+                    actions?: {
+                        [x: string]: unknown;
+                    }[] | undefined;
+                    boundary_constraints?: string[] | undefined;
+                    exit_conditions?: {
+                        [x: string]: unknown;
+                    }[] | undefined;
+                    guardrails?: {
+                        [x: string]: unknown;
+                    }[] | undefined;
+                    name: string;
+                    objective?: string | undefined;
+                    tools?: string[] | undefined;
+                    type: string;
+                };
+                reachable_states?: {
+                    [x: string]: unknown;
+                }[] | undefined;
+                state_transitions?: string[][] | undefined;
+                states_visited?: string[] | undefined;
+                terminal_reached?: boolean | undefined;
+                terminal_state?: string | null | undefined;
+                tools_called?: string[] | undefined;
+                total_turns?: number | undefined;
+                turn_policy?: {
+                    barge_in_enabled?: boolean | undefined;
+                    block_forward_call?: boolean | undefined;
+                    block_forward_call_after_turns?: number | undefined;
+                    context_strategy?: string | undefined;
+                    greeting_shield_s?: number | undefined;
+                    safety_response?: string | undefined;
+                } | undefined;
+            };
+        } & import("../index.js").ResponseMetadata>;
+    };
+    /**
+     * Bridge — convert recorded production calls into simulation scenarios so
+     * they can be replayed against a candidate version. ``plan`` returns a
+     * preview of which calls would be selected; ``run`` executes the plan.
+     */
+    readonly bridge: {
+        /** Plan a bridge run — returns the candidate scenarios without executing */
+        plan: (body: components["schemas"]["BridgePlanRequest"]) => Promise<{
+            available_states?: string[] | undefined;
+            available_tools?: string[] | undefined;
+            rationale: string;
+            target_spec: {
+                completion_criteria?: {
+                    state_based?: string[] | undefined;
+                    tool_based?: string[] | undefined;
+                } | undefined;
+                desired_states?: string[] | undefined;
+                non_desired_states?: {
+                    mode?: "hard" | "soft" | undefined;
+                    state: string;
+                }[] | undefined;
+                ordered_pathways?: {
+                    id: string;
+                    sequence: string[];
+                }[] | undefined;
+            };
+        } & import("../index.js").ResponseMetadata>;
+        /** Execute a bridge run and return the resulting run handle */
+        run: (body: components["schemas"]["BridgeRequest"]) => Promise<{
+            inferred_target_spec?: {
+                completion_criteria?: {
+                    state_based?: string[] | undefined;
+                    tool_based?: string[] | undefined;
+                } | undefined;
+                desired_states?: string[] | undefined;
+                non_desired_states?: {
+                    mode?: "hard" | "soft" | undefined;
+                    state: string;
+                }[] | undefined;
+                ordered_pathways?: {
+                    id: string;
+                    sequence: string[];
+                }[] | undefined;
+            } | null | undefined;
+            inferred_target_spec_rationale?: string | null | undefined;
+            run_id: string;
+            scenarios: {
+                description: string;
+                initial_message: string;
+                persona?: {
+                    background?: string | undefined;
+                    communication_style?: string | undefined;
+                    default_language?: string | undefined;
+                    name?: string | undefined;
+                    role?: string | undefined;
+                } | undefined;
+                scenario_instructions: string;
+                temperament?: string | undefined;
+            }[];
+            status: "running" | "completed" | "failed";
+        } & import("../index.js").ResponseMetadata>;
+    };
+    /**
+     * Per-service simulation views — graph of explored conversation paths,
+     * recorded sessions, and per-turn telemetry. Used by the developer console's
+     * coverage tab to visualize what scenarios have been exercised.
+     */
+    readonly services: {
+        /** Get the conversation graph (nodes/edges) for a service */
+        getGraph: (serviceId: ServiceId | string) => Promise<{
+            [x: string]: unknown;
+        } & import("../index.js").ResponseMetadata>;
+        /** Reset / delete the service's accumulated graph */
+        deleteGraph: (serviceId: ServiceId | string) => Promise<{
+            [x: string]: unknown;
+        } & import("../index.js").ResponseMetadata>;
+        /** Get the set of explored conversation paths through the graph */
+        getGraphPaths: (serviceId: ServiceId | string) => Promise<{
+            [x: string]: unknown;
+        } & import("../index.js").ResponseMetadata>;
+        /** List recorded sessions for the service */
+        listSessions: (serviceId: ServiceId | string) => Promise<{
+            [x: string]: unknown;
+        } & import("../index.js").ResponseMetadata>;
+        /** List per-turn observations for the service */
+        listTurns: (serviceId: ServiceId | string) => Promise<{
+            [x: string]: unknown;
+        } & import("../index.js").ResponseMetadata>;
+    };
 }
+export {};
 //# sourceMappingURL=simulations.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"simulations.d.ts","sourceRoot":"","sources":["../../../src/resources/simulations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AACrD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAA;AACnE,OAAO,EAAE,uBAAuB,EAAe,MAAM,WAAW,CAAA;AAEhE;;;;;;GAMG;AACH,qBAAa,mBAAoB,SAAQ,uBAAuB;IAC9D,qFAAqF;IAC/E,aAAa,CACjB,IAAI,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC,gDAAgD,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAU/E,4CAA4C;IACtC,UAAU,CAAC,SAAS,EAAE,mBAAmB,GAAG,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAQxD,kCAAkC;IAC5B,aAAa,CAAC,SAAS,EAAE,mBAAmB,GAAG,MAAM;;;IAQ3D;;;OAGG;IACG,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC,aAAa,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IASrD;;;OAGG;IACG,SAAS,CAAC,IAAI,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC,kBAAkB,CAAC;;;IAS/D,iEAAiE;IAC3D,eAAe,CAAC,SAAS,EAAE,mBAAmB,GAAG,MAAM;;;;;;CAO9D"}
+{"version":3,"file":"simulations.d.ts","sourceRoot":"","sources":["../../../src/resources/simulations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAA;AAC5D,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAA;AAC/F,OAAO,EAAE,uBAAuB,EAAe,MAAM,WAAW,CAAA;AAMhE,KAAK,8BAA8B,GACjC,UAAU,CAAC,SAAS,CAAC,CAAC,gDAAgD,CAAC,CAAA;AAEzE,MAAM,MAAM,wBAAwB,GAAG,WAAW,CAChD,KAAK,CAAC,qCAAqC,CAAC,CAAC,KAAK,CAAC,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC,CAC3E,CAAA;AAED;;;;;;GAMG;AACH,qBAAa,mBAAoB,SAAQ,uBAAuB;IAC9D,qFAAqF;IAC/E,aAAa,CACjB,IAAI,EAAE,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAUtC,4CAA4C;IACtC,UAAU,CAAC,SAAS,EAAE,mBAAmB,GAAG,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAQxD,kCAAkC;IAC5B,aAAa,CAAC,SAAS,EAAE,mBAAmB,GAAG,MAAM;;;IAQ3D;;;OAGG;IACG,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC,aAAa,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IASrD;;;OAGG;IACG,SAAS,CAAC,IAAI,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC,kBAAkB,CAAC;;;IAS/D,iEAAiE;IAC3D,eAAe,CAAC,SAAS,EAAE,mBAAmB,GAAG,MAAM;;;;;;IAQ7D;;;;;;OAMG;IACH,QAAQ,CAAC,IAAI;QACX,4CAA4C;wBACtB,wBAAwB;;;QAO9C,kCAAkC;uBACb,UAAU,CAAC,SAAS,CAAC,CAAC,kBAAkB,CAAC;;;QAQ9D,uDAAuD;qBACpC,eAAe,GAAG,MAAM;;;;;;;;;;;;;;;;;;;QAO3C,4EAA4E;0BACpD,eAAe,GAAG,MAAM;;;QAOhD,6EAA6E;+BAEpE,eAAe,GAAG,MAAM,QACzB,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAQvC;IAED;;;;OAIG;IACH,QAAQ,CAAC,MAAM;QACb,4EAA4E;qBACzD,UAAU,CAAC,SAAS,CAAC,CAAC,mBAAmB,CAAC;;;;;;;;;;;;;;;;;;;;QAQ7D,+DAA+D;oBAC7C,UAAU,CAAC,SAAS,CAAC,CAAC,eAAe,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAOzD;IAED;;;;OAIG;IACH,QAAQ,CAAC,QAAQ;QACf,6DAA6D;8BACjC,SAAS,GAAG,MAAM;;;QAO9C,qDAAqD;iCACtB,SAAS,GAAG,MAAM;;;QAOjD,mEAAmE;mCAClC,SAAS,GAAG,MAAM;;;QAUnD,6CAA6C;kCACb,SAAS,GAAG,MAAM;;;QAOlD,iDAAiD;+BACpB,SAAS,GAAG,MAAM;;;MAMhD;CACF"}

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

@@ -0,0 +1,240 @@
+import type { components, paths } from '../generated/api.js';
+import { WorkspaceScopedResource } from './base.js';
+export type ListSurfacesParams = NonNullable<paths['/v1/{workspace_id}/surfaces']['get']['parameters']['query']>;
+/** `/surfaces/review` is a narrower paged feed without the workspace-list filters. */
+export type ListSurfacesForReviewParams = NonNullable<paths['/v1/{workspace_id}/surfaces/review']['get']['parameters']['query']>;
+/**
+ * Surfaces — short-lived form/intake experiences the platform delivers via
+ * SMS / email / web. The full lifecycle is exposed: create, deliver, monitor
+ * progress, gate for review, approve / reject / reshape, and archive.
+ *
+ * @beta New in this release; surface may evolve as the operator review flow
+ * stabilizes.
+ */
+export declare class SurfacesResource extends WorkspaceScopedResource {
+    /** List surfaces in the workspace */
+    list(params?: ListSurfacesParams): Promise<{
+        continuation_token?: number | null | undefined;
+        has_more: boolean;
+        items: {
+            channel?: ("sms" | "whatsapp" | "imessage" | "email" | "voice" | "web") | null | undefined;
+            context?: {
+                [x: string]: unknown;
+            } | undefined;
+            created_at?: string | null | undefined;
+            delivered_at?: string | null | undefined;
+            delivery_metadata?: {
+                [x: string]: unknown;
+            } | null | undefined;
+            description?: string | null | undefined;
+            entity_id?: string | null | undefined;
+            event_id: string;
+            expires_at?: string | null | undefined;
+            fields?: {
+                [x: string]: unknown;
+            }[] | undefined;
+            fields_count: number;
+            id: string;
+            opened_at?: string | null | undefined;
+            resource_type?: string | null | undefined;
+            status: "created" | "pending_review" | "delivered" | "opened" | "partial" | "completed" | "expired" | "archived";
+            submitted_at?: string | null | undefined;
+            submitted_data?: {
+                [x: string]: unknown;
+            } | null | undefined;
+            title?: string | null | undefined;
+        }[];
+        total?: number | null | undefined;
+    } & import("../index.js").ResponseMetadata>;
+    listAutoPaging(params?: ListSurfacesParams): AsyncGenerator<{
+        channel?: ("sms" | "whatsapp" | "imessage" | "email" | "voice" | "web") | null | undefined;
+        context?: {
+            [x: string]: unknown;
+        } | undefined;
+        created_at?: string | null | undefined;
+        delivered_at?: string | null | undefined;
+        delivery_metadata?: {
+            [x: string]: unknown;
+        } | null | undefined;
+        description?: string | null | undefined;
+        entity_id?: string | null | undefined;
+        event_id: string;
+        expires_at?: string | null | undefined;
+        fields?: {
+            [x: string]: unknown;
+        }[] | undefined;
+        fields_count: number;
+        id: string;
+        opened_at?: string | null | undefined;
+        resource_type?: string | null | undefined;
+        status: "created" | "pending_review" | "delivered" | "opened" | "partial" | "completed" | "expired" | "archived";
+        submitted_at?: string | null | undefined;
+        submitted_data?: {
+            [x: string]: unknown;
+        } | null | undefined;
+        title?: string | null | undefined;
+    }, any, any>;
+    /** Surfaces awaiting review (pending approval / rejection) */
+    listForReview(params?: ListSurfacesForReviewParams): Promise<{
+        continuation_token?: number | null | undefined;
+        has_more: boolean;
+        items: {
+            channel?: ("sms" | "whatsapp" | "imessage" | "email" | "voice" | "web") | null | undefined;
+            context?: {
+                [x: string]: unknown;
+            } | undefined;
+            created_at?: string | null | undefined;
+            delivered_at?: string | null | undefined;
+            delivery_metadata?: {
+                [x: string]: unknown;
+            } | null | undefined;
+            description?: string | null | undefined;
+            entity_id?: string | null | undefined;
+            event_id: string;
+            expires_at?: string | null | undefined;
+            fields?: {
+                [x: string]: unknown;
+            }[] | undefined;
+            fields_count: number;
+            id: string;
+            opened_at?: string | null | undefined;
+            resource_type?: string | null | undefined;
+            status: "created" | "pending_review" | "delivered" | "opened" | "partial" | "completed" | "expired" | "archived";
+            submitted_at?: string | null | undefined;
+            submitted_data?: {
+                [x: string]: unknown;
+            } | null | undefined;
+            title?: string | null | undefined;
+        }[];
+        total?: number | null | undefined;
+    } & import("../index.js").ResponseMetadata>;
+    /** Create a surface (form definition + delivery config) */
+    create(body: components['schemas']['CreateSurfaceRequest']): Promise<{
+        channel: "sms" | "whatsapp" | "imessage" | "email" | "voice" | "web";
+        created_at: string;
+        description?: string | null | undefined;
+        entity_id: string;
+        event_id: string;
+        expires_at: string;
+        fields_count: number;
+        id: string;
+        status: "created" | "pending_review" | "delivered" | "opened" | "partial" | "completed" | "expired" | "archived";
+        title: string;
+        token?: string | null | undefined;
+        url?: string | null | undefined;
+    } & import("../index.js").ResponseMetadata>;
+    /** Get a single surface */
+    get(surfaceId: string): Promise<{
+        channel?: ("sms" | "whatsapp" | "imessage" | "email" | "voice" | "web") | null | undefined;
+        context?: {
+            [x: string]: unknown;
+        } | undefined;
+        created_at?: string | null | undefined;
+        delivered_at?: string | null | undefined;
+        delivery_metadata?: {
+            [x: string]: unknown;
+        } | null | undefined;
+        description?: string | null | undefined;
+        entity_id?: string | null | undefined;
+        event_id: string;
+        expires_at?: string | null | undefined;
+        fields?: {
+            [x: string]: unknown;
+        }[] | undefined;
+        fields_count: number;
+        id: string;
+        opened_at?: string | null | undefined;
+        resource_type?: string | null | undefined;
+        status: "created" | "pending_review" | "delivered" | "opened" | "partial" | "completed" | "expired" | "archived";
+        submitted_at?: string | null | undefined;
+        submitted_data?: {
+            [x: string]: unknown;
+        } | null | undefined;
+        title?: string | null | undefined;
+    } & import("../index.js").ResponseMetadata>;
+    /** Update surface metadata or fields */
+    update(surfaceId: string, body: components['schemas']['UpdateSurfaceRequest']): Promise<{
+        channel?: ("sms" | "whatsapp" | "imessage" | "email" | "voice" | "web") | null | undefined;
+        context?: {
+            [x: string]: unknown;
+        } | undefined;
+        created_at?: string | null | undefined;
+        delivered_at?: string | null | undefined;
+        delivery_metadata?: {
+            [x: string]: unknown;
+        } | null | undefined;
+        description?: string | null | undefined;
+        entity_id?: string | null | undefined;
+        event_id: string;
+        expires_at?: string | null | undefined;
+        fields?: {
+            [x: string]: unknown;
+        }[] | undefined;
+        fields_count: number;
+        id: string;
+        opened_at?: string | null | undefined;
+        resource_type?: string | null | undefined;
+        status: "created" | "pending_review" | "delivered" | "opened" | "partial" | "completed" | "expired" | "archived";
+        submitted_at?: string | null | undefined;
+        submitted_data?: {
+            [x: string]: unknown;
+        } | null | undefined;
+        title?: string | null | undefined;
+    } & import("../index.js").ResponseMetadata>;
+    /** Archive (soft-delete) a surface */
+    archive(surfaceId: string): Promise<{
+        status: "archived";
+        surface_id: string;
+    } & import("../index.js").ResponseMetadata>;
+    /** Deliver the surface to the recipient (SMS/email/etc.) */
+    deliver(surfaceId: string, body: components['schemas']['DeliverSurfaceRequest']): Promise<{
+        channel?: ("sms" | "whatsapp" | "imessage" | "email" | "voice" | "web") | null | undefined;
+        channel_address: string;
+        delivered_at?: string | null | undefined;
+        delivery_provider?: string | null | undefined;
+        from_address?: string | null | undefined;
+        from_number?: string | null | undefined;
+        message_id?: string | null | undefined;
+        status: "delivered" | "pending_review";
+        surface_id: string;
+        url?: string | null | undefined;
+    } & import("../index.js").ResponseMetadata>;
+    /** Get fill / completion progress for a surface */
+    getProgress(surfaceId: string): Promise<{
+        empty_count: number;
+        empty_keys: string[];
+        filled_count: number;
+        filled_keys: string[];
+        required_empty_keys: string[];
+        surface_id: string;
+        total_fields: number;
+    } & import("../index.js").ResponseMetadata>;
+    /** Approve a pending-review surface */
+    approve(surfaceId: string): Promise<{
+        action: "approved" | "rejected";
+        status: "created" | "pending_review" | "delivered" | "opened" | "partial" | "completed" | "expired" | "archived";
+        surface_id: string;
+    } & import("../index.js").ResponseMetadata>;
+    /** Reject a pending-review surface */
+    reject(surfaceId: string, body: components['schemas']['RejectSurfaceRequest']): Promise<{
+        action: "approved" | "rejected";
+        status: "created" | "pending_review" | "delivered" | "opened" | "partial" | "completed" | "expired" | "archived";
+        surface_id: string;
+    } & import("../index.js").ResponseMetadata>;
+    /** Reshape — clone the surface with refined fields (review redirect) */
+    reshape(surfaceId: string): Promise<{
+        channel: "sms" | "whatsapp" | "imessage" | "email" | "voice" | "web";
+        created_at: string;
+        description?: string | null | undefined;
+        entity_id: string;
+        event_id: string;
+        expires_at: string;
+        fields_count: number;
+        id: string;
+        status: "created" | "pending_review" | "delivered" | "opened" | "partial" | "completed" | "expired" | "archived";
+        title: string;
+        token?: string | null | undefined;
+        url?: string | null | undefined;
+    } & import("../index.js").ResponseMetadata>;
+}
+//# sourceMappingURL=surfaces.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"surfaces.d.ts","sourceRoot":"","sources":["../../../src/resources/surfaces.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAA;AAC5D,OAAO,EAAE,uBAAuB,EAAe,MAAM,WAAW,CAAA;AAEhE,MAAM,MAAM,kBAAkB,GAAG,WAAW,CAC1C,KAAK,CAAC,6BAA6B,CAAC,CAAC,KAAK,CAAC,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC,CACnE,CAAA;AACD,sFAAsF;AACtF,MAAM,MAAM,2BAA2B,GAAG,WAAW,CACnD,KAAK,CAAC,oCAAoC,CAAC,CAAC,KAAK,CAAC,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC,CAC1E,CAAA;AAED;;;;;;;GAOG;AACH,qBAAa,gBAAiB,SAAQ,uBAAuB;IAC3D,qCAAqC;IAC/B,IAAI,CAAC,MAAM,CAAC,EAAE,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAQtC,cAAc,CAAC,MAAM,CAAC,EAAE,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAI1C,8DAA8D;IACxD,aAAa,CAAC,MAAM,CAAC,EAAE,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAQxD,2DAA2D;IACrD,MAAM,CAAC,IAAI,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC,sBAAsB,CAAC;;;;;;;;;;;;;;IAShE,2BAA2B;IACrB,GAAG,CAAC,SAAS,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAQ3B,wCAAwC;IAClC,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC,sBAAsB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;IASnF,sCAAsC;IAChC,OAAO,CAAC,SAAS,EAAE,MAAM;;;;IAQ/B,4DAA4D;IACtD,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC,uBAAuB,CAAC;;;;;;;;;;;;IASrF,mDAAmD;IAC7C,WAAW,CAAC,SAAS,EAAE,MAAM;;;;;;;;;IAQnC,uCAAuC;IACjC,OAAO,CAAC,SAAS,EAAE,MAAM;;;;;IAQ/B,sCAAsC;IAChC,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC,sBAAsB,CAAC;;;;;IASnF,wEAAwE;IAClE,OAAO,CAAC,SAAS,EAAE,MAAM;;;;;;;;;;;;;;CAOhC"}

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

@@ -0,0 +1,55 @@
+import { WorkspaceScopedResource } from './base.js';
+/**
+ * Tasks — long-running async jobs the platform spawns (intake processing,
+ * tool executions, voice imports). The SDK exposes get-by-id and a
+ * by-call lookup for retrieving every task tied to a specific call.
+ *
+ * @beta New in this release; surface may evolve.
+ */
+export declare class TasksResource extends WorkspaceScopedResource {
+    /** Get the current state of a single task */
+    get(taskId: string): Promise<{
+        cached_tokens?: number | undefined;
+        call_sid: string;
+        completed_at?: string | null | undefined;
+        dispatched_at?: string | null | undefined;
+        duration_ms?: number | null | undefined;
+        error?: string | null | undefined;
+        error_type?: string | null | undefined;
+        input_tokens?: number | undefined;
+        output_tokens?: number | undefined;
+        progress_message?: string | null | undefined;
+        progress_step?: number | null | undefined;
+        result?: string | null | undefined;
+        skill: string;
+        status: "pending" | "dispatched" | "running" | "completed" | "failed" | "cancelled" | "timeout";
+        sub_tool_count?: number | undefined;
+        task_id: string;
+        tier: "direct" | "companion" | "desktop" | "computer_use";
+        workspace_id: string;
+    } & import("../index.js").ResponseMetadata>;
+    /** List every task associated with a call (by Twilio call sid) */
+    listByCall(callSid: string): Promise<{
+        tasks: {
+            cached_tokens?: number | undefined;
+            call_sid: string;
+            completed_at?: string | null | undefined;
+            dispatched_at?: string | null | undefined;
+            duration_ms?: number | null | undefined;
+            error?: string | null | undefined;
+            error_type?: string | null | undefined;
+            input_tokens?: number | undefined;
+            output_tokens?: number | undefined;
+            progress_message?: string | null | undefined;
+            progress_step?: number | null | undefined;
+            result?: string | null | undefined;
+            skill: string;
+            status: "pending" | "dispatched" | "running" | "completed" | "failed" | "cancelled" | "timeout";
+            sub_tool_count?: number | undefined;
+            task_id: string;
+            tier: "direct" | "companion" | "desktop" | "computer_use";
+            workspace_id: string;
+        }[];
+    } & import("../index.js").ResponseMetadata>;
+}
+//# sourceMappingURL=tasks.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tasks.d.ts","sourceRoot":"","sources":["../../../src/resources/tasks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAe,MAAM,WAAW,CAAA;AAEhE;;;;;;GAMG;AACH,qBAAa,aAAc,SAAQ,uBAAuB;IACxD,6CAA6C;IACvC,GAAG,CAAC,MAAM,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;IAQxB,kEAAkE;IAC5D,UAAU,CAAC,OAAO,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;;CAOjC"}

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

@@ -0,0 +1,53 @@
+import type { components } from '../generated/api.js';
+import type { ServiceId } from '../core/branded-types.js';
+import { WorkspaceScopedResource } from './base.js';
+/**
+ * Tools — manual execution of integration-backed tool calls (used by the
+ * tool-testing surface in the developer console) and per-service resolution
+ * of which concrete tool implementations bind to a service's tool slots.
+ *
+ * @beta New in this release; surface may evolve.
+ */
+export declare class ToolsResource extends WorkspaceScopedResource {
+    /** Manually execute a tool call against the workspace's integrations */
+    execute(body: components['schemas']['ToolExecuteRequest']): Promise<{
+        blocked_side_effects?: string[] | undefined;
+        dry_run?: boolean | undefined;
+        duration_ms?: number | undefined;
+        error?: string | null | undefined;
+        is_write?: boolean | undefined;
+        result?: unknown;
+        source?: string | undefined;
+        sub_tool_logs?: {
+            duration_ms?: number | undefined;
+            input?: {
+                [x: string]: unknown;
+            } | undefined;
+            output?: string | undefined;
+            succeeded?: boolean | undefined;
+            tool_name?: string | undefined;
+        }[] | undefined;
+        tier?: string | undefined;
+        tool_type?: string | undefined;
+    } & import("../index.js").ResponseMetadata>;
+    /** Resolve the bound tool implementations for a service */
+    resolveForService(serviceId: ServiceId | string): Promise<{
+        service_id: string;
+        tools: {
+            additional_instructions?: {
+                [x: string]: string;
+            } | undefined;
+            description?: string | undefined;
+            input_schema?: {
+                [x: string]: unknown;
+            } | undefined;
+            is_write?: boolean | undefined;
+            states?: string[] | undefined;
+            tier?: string | undefined;
+            tool_name: string;
+            tool_type: string;
+        }[];
+        workspace_id: string;
+    } & import("../index.js").ResponseMetadata>;
+}
+//# sourceMappingURL=tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../src/resources/tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AACrD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAA;AACzD,OAAO,EAAE,uBAAuB,EAAe,MAAM,WAAW,CAAA;AAEhE;;;;;;GAMG;AACH,qBAAa,aAAc,SAAQ,uBAAuB;IACxD,wEAAwE;IAClE,OAAO,CAAC,IAAI,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC,oBAAoB,CAAC;;;;;;;;;;;;;;;;;;;;IAS/D,2DAA2D;IACrD,iBAAiB,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM;;;;;;;;;;;;;;;;;;CAOtD"}