@signalwire/sdk 2.0.4 → 2.0.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (61) hide show
  1. package/dist/AgentBase.d.ts +72 -40
  2. package/dist/AgentBase.js +147 -85
  3. package/dist/AgentBase.js.map +1 -1
  4. package/dist/POM/PromptObjectModel.d.ts +152 -0
  5. package/dist/POM/PromptObjectModel.js +465 -0
  6. package/dist/POM/PromptObjectModel.js.map +1 -0
  7. package/dist/PomBuilder.d.ts +10 -0
  8. package/dist/PomBuilder.js +28 -0
  9. package/dist/PomBuilder.js.map +1 -1
  10. package/dist/PromptManager.d.ts +7 -0
  11. package/dist/PromptManager.js +9 -0
  12. package/dist/PromptManager.js.map +1 -1
  13. package/dist/SWMLService.d.ts +121 -22
  14. package/dist/SWMLService.js +249 -17
  15. package/dist/SWMLService.js.map +1 -1
  16. package/dist/SecurityUtils.d.ts +7 -0
  17. package/dist/SecurityUtils.js +11 -0
  18. package/dist/SecurityUtils.js.map +1 -1
  19. package/dist/ServerlessAdapter.d.ts +4 -4
  20. package/dist/ServerlessAdapter.js.map +1 -1
  21. package/dist/cli/agent-loader.js +3 -1
  22. package/dist/cli/agent-loader.js.map +1 -1
  23. package/dist/cli/swaig-test.js +7 -3
  24. package/dist/cli/swaig-test.js.map +1 -1
  25. package/dist/index.d.ts +86 -2
  26. package/dist/index.js +107 -1
  27. package/dist/index.js.map +1 -1
  28. package/dist/relay/RelayClient.d.ts +38 -0
  29. package/dist/relay/RelayClient.js +99 -2
  30. package/dist/relay/RelayClient.js.map +1 -1
  31. package/dist/relay/types.d.ts +11 -0
  32. package/dist/rest/callHandler.d.ts +60 -0
  33. package/dist/rest/callHandler.js +59 -0
  34. package/dist/rest/callHandler.js.map +1 -0
  35. package/dist/rest/index.d.ts +3 -1
  36. package/dist/rest/index.js +3 -1
  37. package/dist/rest/index.js.map +1 -1
  38. package/dist/rest/namespaces/fabric.d.ts +59 -5
  39. package/dist/rest/namespaces/fabric.js +81 -5
  40. package/dist/rest/namespaces/fabric.js.map +1 -1
  41. package/dist/rest/namespaces/phone-numbers.d.ts +141 -1
  42. package/dist/rest/namespaces/phone-numbers.js +169 -1
  43. package/dist/rest/namespaces/phone-numbers.js.map +1 -1
  44. package/dist/skills/SkillRegistry.d.ts +29 -0
  45. package/dist/skills/SkillRegistry.js +42 -0
  46. package/dist/skills/SkillRegistry.js.map +1 -1
  47. package/dist/skills/builtin/api_ninjas_trivia.js +6 -2
  48. package/dist/skills/builtin/api_ninjas_trivia.js.map +1 -1
  49. package/dist/skills/builtin/datasphere.js +13 -3
  50. package/dist/skills/builtin/datasphere.js.map +1 -1
  51. package/dist/skills/builtin/spider.d.ts +7 -0
  52. package/dist/skills/builtin/spider.js +45 -2
  53. package/dist/skills/builtin/spider.js.map +1 -1
  54. package/dist/skills/builtin/weather_api.js +19 -1
  55. package/dist/skills/builtin/weather_api.js.map +1 -1
  56. package/dist/skills/builtin/web_search.js +28 -5
  57. package/dist/skills/builtin/web_search.js.map +1 -1
  58. package/dist/skills/builtin/wikipedia_search.js +18 -1
  59. package/dist/skills/builtin/wikipedia_search.js.map +1 -1
  60. package/dist/types.d.ts +7 -1
  61. package/package.json +5 -2
@@ -147,8 +147,54 @@ export class CxmlApplicationsResource extends FabricResourcePUT {
147
147
  throw new Error('cXML applications cannot be created via this API');
148
148
  }
149
149
  }
150
+ /**
151
+ * Fabric webhook resource that is normally auto-materialized by the
152
+ * corresponding `phoneNumbers.set*Webhook` helper.
153
+ *
154
+ * Creating directly produces an orphan Fabric resource that isn't bound to
155
+ * any phone number — the API's binding model configures the webhook on the
156
+ * phone number, and the server materializes the Fabric resource as a
157
+ * side-effect. `create` remains for backwards compatibility but emits a
158
+ * one-time deprecation warning on first call.
159
+ *
160
+ * See the porting-sdk's `phone-binding.md` for the full model.
161
+ */
162
+ export class AutoMaterializedWebhookResource extends FabricResource {
163
+ /** Label used in the deprecation warning (subclasses override). */
164
+ _autoHelperName = 'phoneNumbers.set*Webhook';
165
+ static _warned = new WeakSet();
166
+ constructor(http, basePath) {
167
+ super(http, basePath);
168
+ }
169
+ /**
170
+ * @deprecated Creating a webhook Fabric resource directly produces an
171
+ * orphan that is not bound to any phone number. Use the
172
+ * `phoneNumbers.setSwmlWebhook` / `setCxmlWebhook` helper instead — it
173
+ * updates the phone number and the server auto-materializes the
174
+ * resource. Kept for backwards compatibility.
175
+ */
176
+ async create(body = {}) {
177
+ if (!AutoMaterializedWebhookResource._warned.has(this)) {
178
+ AutoMaterializedWebhookResource._warned.add(this);
179
+ console.warn(`[signalwire] Creating a webhook Fabric resource directly produces ` +
180
+ `an orphan not bound to any phone number. Use ${this._autoHelperName} ` +
181
+ `instead; it updates the phone number and the server auto-materializes ` +
182
+ `the resource. See porting-sdk's phone-binding.md.`);
183
+ }
184
+ return super.create(body);
185
+ }
186
+ }
187
+ /** Auto-materialized SWML webhook — normally created via `phoneNumbers.setSwmlWebhook`. */
188
+ export class SwmlWebhooksResource extends AutoMaterializedWebhookResource {
189
+ _autoHelperName = 'phoneNumbers.setSwmlWebhook(sid, url)';
190
+ }
191
+ /** Auto-materialized cXML webhook — normally created via `phoneNumbers.setCxmlWebhook`. */
192
+ export class CxmlWebhooksResource extends AutoMaterializedWebhookResource {
193
+ _autoHelperName = 'phoneNumbers.setCxmlWebhook(sid, { url })';
194
+ }
150
195
  /** Generic resource operations across all fabric resource types. */
151
196
  export class GenericResources extends BaseResource {
197
+ static _assignPhoneRouteWarned = new WeakSet();
152
198
  constructor(http, basePath) {
153
199
  super(http, basePath);
154
200
  }
@@ -196,12 +242,31 @@ export class GenericResources extends BaseResource {
196
242
  /**
197
243
  * Assign a phone route to a fabric resource.
198
244
  *
245
+ * @deprecated For the common cases — SWML webhooks, cXML webhooks, AI
246
+ * agents — this endpoint **does not work**. Bindings for those are
247
+ * configured on the phone number via {@link PhoneNumbersResource.setSwmlWebhook}
248
+ * / `setCxmlWebhook` / `setAiAgent`, and the Fabric resource is
249
+ * auto-materialized by the server. Calling this method against
250
+ * `swml_webhook`, `cxml_webhook`, or `ai_agent` resource IDs returns
251
+ * `404` or `422`. The endpoint (`POST /api/fabric/resources/{id}/phone_routes`)
252
+ * applies only to a narrow set of legacy resource types listed in
253
+ * `rest-apis/relay-rest/openapi.yaml`. Emits a one-time deprecation
254
+ * warning on first call; kept for backwards compatibility.
255
+ *
199
256
  * @param resourceId - Unique identifier of the resource.
200
- * @param body - Phone route payload (typically `{ phone_number_id }`).
257
+ * @param body - Phone route payload.
201
258
  * @returns The phone-route assignment record.
202
259
  * @throws {RestError} On any non-2xx HTTP response.
203
260
  */
204
261
  async assignPhoneRoute(resourceId, body) {
262
+ if (!GenericResources._assignPhoneRouteWarned.has(this)) {
263
+ GenericResources._assignPhoneRouteWarned.add(this);
264
+ console.warn('[signalwire] assignPhoneRoute does not bind phone numbers to ' +
265
+ 'swml_webhook / cxml_webhook / ai_agent resources — those are ' +
266
+ 'configured via phoneNumbers.setSwmlWebhook / setCxmlWebhook / ' +
267
+ 'setAiAgent. This method applies only to a narrow set of legacy ' +
268
+ "resource types. See porting-sdk's phone-binding.md.");
269
+ }
205
270
  return this._http.post(this._path(resourceId, 'phone_routes'), body);
206
271
  }
207
272
  /**
@@ -332,13 +397,21 @@ export class FabricNamespace {
332
397
  /** cXML application read / update / delete (no create). */
333
398
  cxmlApplications;
334
399
  // PATCH-update resources
335
- /** SWML webhook CRUD (partial-update `PATCH` semantics). */
400
+ /**
401
+ * SWML webhook CRUD. **Auto-materialized** as a side-effect of
402
+ * {@link PhoneNumbersResource.setSwmlWebhook}; direct `create` produces
403
+ * an orphan resource and emits a deprecation warning.
404
+ */
336
405
  swmlWebhooks;
337
406
  /** AI Agent CRUD — the platform-managed agent registration resource. */
338
407
  aiAgents;
339
408
  /** SIP Gateway CRUD. */
340
409
  sipGateways;
341
- /** cXML webhook CRUD. */
410
+ /**
411
+ * cXML webhook CRUD. **Auto-materialized** as a side-effect of
412
+ * {@link PhoneNumbersResource.setCxmlWebhook}; direct `create` produces
413
+ * an orphan resource and emits a deprecation warning.
414
+ */
342
415
  cxmlWebhooks;
343
416
  // Special resources
344
417
  /** Generic operations across all resource types (list, get, delete, phone route assignment). */
@@ -360,10 +433,13 @@ export class FabricNamespace {
360
433
  this.cxmlScripts = new FabricResourcePUT(http, `${base}/cxml_scripts`);
361
434
  this.cxmlApplications = new CxmlApplicationsResource(http, `${base}/cxml_applications`);
362
435
  // PATCH-update resources
363
- this.swmlWebhooks = new FabricResource(http, `${base}/swml_webhooks`);
436
+ // swmlWebhooks and cxmlWebhooks are normally auto-materialized by
437
+ // phoneNumbers.setSwmlWebhook / setCxmlWebhook. Direct create still
438
+ // works for backcompat but emits a deprecation warning.
439
+ this.swmlWebhooks = new SwmlWebhooksResource(http, `${base}/swml_webhooks`);
364
440
  this.aiAgents = new FabricResource(http, `${base}/ai_agents`);
365
441
  this.sipGateways = new FabricResource(http, `${base}/sip_gateways`);
366
- this.cxmlWebhooks = new FabricResource(http, `${base}/cxml_webhooks`);
442
+ this.cxmlWebhooks = new CxmlWebhooksResource(http, `${base}/cxml_webhooks`);
367
443
  // Special resources
368
444
  this.resources = new GenericResources(http, base);
369
445
  this.addresses = new FabricAddresses(http, '/api/fabric/addresses');
@@ -1 +1 @@
1
- {"version":3,"file":"fabric.js","sourceRoot":"","sources":["../../../src/rest/namespaces/fabric.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"fabric.js","sourceRoot":"","sources":["../../../src/rest/namespaces/fabric.ts"],"names":[],"mappings":"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"}
@@ -1,12 +1,58 @@
1
1
  /**
2
- * Phone Numbers namespace — list, search, purchase, get, update, release.
2
+ * Phone Numbers namespace — list, search, purchase, get, update, release, bind.
3
3
  */
4
4
  import type { HttpClient } from '../HttpClient.js';
5
5
  import type { QueryParams } from '../types.js';
6
6
  import { CrudResource } from '../base/CrudResource.js';
7
+ /** Optional companion fields for {@link PhoneNumbersResource.setSwmlWebhook}. */
8
+ export interface SetSwmlWebhookExtra {
9
+ [key: string]: unknown;
10
+ }
11
+ /** Parameters for {@link PhoneNumbersResource.setCxmlWebhook}. */
12
+ export interface SetCxmlWebhookParams {
13
+ /** Primary cXML document URL. Serialized as `call_request_url`. */
14
+ url: string;
15
+ /** Fallback URL if the primary request fails. Serialized as `call_fallback_url`. */
16
+ fallbackUrl?: string;
17
+ /** Status callback URL for call status updates. Serialized as `call_status_callback_url`. */
18
+ statusCallbackUrl?: string;
19
+ /** Any additional wire-level fields are passed through verbatim. */
20
+ [key: string]: unknown;
21
+ }
22
+ /** Parameters for {@link PhoneNumbersResource.setCallFlow}. */
23
+ export interface SetCallFlowParams {
24
+ /** Call Flow resource ID. Serialized as `call_flow_id`. */
25
+ flowId: string;
26
+ /**
27
+ * Optional pinned version — `"working_copy"` or `"current_deployed"`
28
+ * (server default when omitted). Serialized as `call_flow_version`.
29
+ */
30
+ version?: string;
31
+ /** Any additional wire-level fields are passed through verbatim. */
32
+ [key: string]: unknown;
33
+ }
34
+ /** Parameters for {@link PhoneNumbersResource.setRelayTopic}. */
35
+ export interface SetRelayTopicParams {
36
+ /** RELAY topic name. Serialized as `call_relay_topic`. */
37
+ topic: string;
38
+ /**
39
+ * Optional status callback URL for RELAY topic delivery updates.
40
+ * Serialized as `call_relay_topic_status_callback_url`.
41
+ */
42
+ statusCallbackUrl?: string;
43
+ /** Any additional wire-level fields are passed through verbatim. */
44
+ [key: string]: unknown;
45
+ }
7
46
  /**
8
47
  * Phone number management.
9
48
  *
49
+ * Supports the standard CRUD surface plus typed helpers for binding an
50
+ * inbound call to a handler (SWML webhook, cXML webhook, AI agent, call
51
+ * flow, RELAY application/topic). The binding model is: set `call_handler`
52
+ * + the handler-specific companion field on the phone number; the server
53
+ * auto-materializes the matching Fabric resource. See
54
+ * {@link PhoneCallHandler} for the enum of valid `call_handler` values.
55
+ *
10
56
  * `create` and `update` accept an untyped body object (`body: any = {}`).
11
57
  * No `PhoneNumberCreateParams` / `PhoneNumberUpdateParams` interfaces are
12
58
  * defined because the Python reference SDK uses bare `**kwargs` with no
@@ -37,6 +83,11 @@ export declare class PhoneNumbersResource extends CrudResource {
37
83
  /**
38
84
  * Update a phone number resource by ID. Body is optional to match Python `**kwargs`.
39
85
  *
86
+ * Setting `call_handler` + the matching companion field (see
87
+ * {@link PhoneCallHandler}) on the phone number auto-materializes the
88
+ * matching Fabric resource on the server; prefer the `set*` helpers
89
+ * below for the common cases.
90
+ *
40
91
  * @param resourceId - Unique phone-number resource ID.
41
92
  * @param body - Partial update payload. Defaults to `{}`.
42
93
  * @returns The updated phone-number resource.
@@ -57,4 +108,93 @@ export declare class PhoneNumbersResource extends CrudResource {
57
108
  * ```
58
109
  */
59
110
  search(params?: QueryParams): Promise<any>;
111
+ /**
112
+ * Route inbound calls to an SWML webhook URL.
113
+ *
114
+ * Your backend returns an SWML document per call. The server
115
+ * auto-creates a `swml_webhook` Fabric resource keyed off this URL —
116
+ * you do **not** need to call `fabric.swmlWebhooks.create` or
117
+ * `fabric.resources.assignPhoneRoute`.
118
+ *
119
+ * @param resourceId - Unique phone-number resource ID.
120
+ * @param url - Your backend's SWML endpoint.
121
+ * @param extra - Additional wire-level fields (e.g. `name`) merged into
122
+ * the PUT body.
123
+ * @returns The updated phone-number resource.
124
+ *
125
+ * @example
126
+ * ```ts
127
+ * await client.phoneNumbers.setSwmlWebhook('pn-1', 'https://example.com/swml');
128
+ * ```
129
+ */
130
+ setSwmlWebhook(resourceId: string, url: string, extra?: SetSwmlWebhookExtra): Promise<any>;
131
+ /**
132
+ * Route inbound calls to a cXML (Twilio-compat / LAML) webhook.
133
+ *
134
+ * Despite the wire value `laml_webhooks` being plural, this creates a
135
+ * single `cxml_webhook` Fabric resource. `fallbackUrl` is used when the
136
+ * primary URL fails; `statusCallbackUrl` receives call status updates.
137
+ *
138
+ * @param resourceId - Unique phone-number resource ID.
139
+ * @param params - URL and optional fallback/status URLs plus any extra
140
+ * wire-level fields.
141
+ * @returns The updated phone-number resource.
142
+ *
143
+ * @example
144
+ * ```ts
145
+ * await client.phoneNumbers.setCxmlWebhook('pn-1', {
146
+ * url: 'https://example.com/voice.xml',
147
+ * fallbackUrl: 'https://example.com/fallback.xml',
148
+ * });
149
+ * ```
150
+ */
151
+ setCxmlWebhook(resourceId: string, params: SetCxmlWebhookParams): Promise<any>;
152
+ /**
153
+ * Route inbound calls to an existing cXML application by ID.
154
+ *
155
+ * @param resourceId - Unique phone-number resource ID.
156
+ * @param applicationId - cXML application ID.
157
+ * @param extra - Additional wire-level fields merged into the body.
158
+ * @returns The updated phone-number resource.
159
+ */
160
+ setCxmlApplication(resourceId: string, applicationId: string, extra?: Record<string, unknown>): Promise<any>;
161
+ /**
162
+ * Route inbound calls to an AI Agent Fabric resource by ID.
163
+ *
164
+ * @param resourceId - Unique phone-number resource ID.
165
+ * @param agentId - AI agent Fabric resource ID.
166
+ * @param extra - Additional wire-level fields merged into the body.
167
+ * @returns The updated phone-number resource.
168
+ */
169
+ setAiAgent(resourceId: string, agentId: string, extra?: Record<string, unknown>): Promise<any>;
170
+ /**
171
+ * Route inbound calls to a Call Flow by ID.
172
+ *
173
+ * `version` accepts `"working_copy"` or `"current_deployed"` (server
174
+ * default when omitted).
175
+ *
176
+ * @param resourceId - Unique phone-number resource ID.
177
+ * @param params - Flow ID and optional pinned version plus any extra
178
+ * wire-level fields.
179
+ * @returns The updated phone-number resource.
180
+ */
181
+ setCallFlow(resourceId: string, params: SetCallFlowParams): Promise<any>;
182
+ /**
183
+ * Route inbound calls to a named RELAY application.
184
+ *
185
+ * @param resourceId - Unique phone-number resource ID.
186
+ * @param name - RELAY application name.
187
+ * @param extra - Additional wire-level fields merged into the body.
188
+ * @returns The updated phone-number resource.
189
+ */
190
+ setRelayApplication(resourceId: string, name: string, extra?: Record<string, unknown>): Promise<any>;
191
+ /**
192
+ * Route inbound calls to a RELAY topic (client subscription).
193
+ *
194
+ * @param resourceId - Unique phone-number resource ID.
195
+ * @param params - Topic name and optional status-callback URL plus any
196
+ * extra wire-level fields.
197
+ * @returns The updated phone-number resource.
198
+ */
199
+ setRelayTopic(resourceId: string, params: SetRelayTopicParams): Promise<any>;
60
200
  }
@@ -1,10 +1,18 @@
1
1
  /**
2
- * Phone Numbers namespace — list, search, purchase, get, update, release.
2
+ * Phone Numbers namespace — list, search, purchase, get, update, release, bind.
3
3
  */
4
4
  import { CrudResource } from '../base/CrudResource.js';
5
+ import { PhoneCallHandler } from '../callHandler.js';
5
6
  /**
6
7
  * Phone number management.
7
8
  *
9
+ * Supports the standard CRUD surface plus typed helpers for binding an
10
+ * inbound call to a handler (SWML webhook, cXML webhook, AI agent, call
11
+ * flow, RELAY application/topic). The binding model is: set `call_handler`
12
+ * + the handler-specific companion field on the phone number; the server
13
+ * auto-materializes the matching Fabric resource. See
14
+ * {@link PhoneCallHandler} for the enum of valid `call_handler` values.
15
+ *
8
16
  * `create` and `update` accept an untyped body object (`body: any = {}`).
9
17
  * No `PhoneNumberCreateParams` / `PhoneNumberUpdateParams` interfaces are
10
18
  * defined because the Python reference SDK uses bare `**kwargs` with no
@@ -39,6 +47,11 @@ export class PhoneNumbersResource extends CrudResource {
39
47
  /**
40
48
  * Update a phone number resource by ID. Body is optional to match Python `**kwargs`.
41
49
  *
50
+ * Setting `call_handler` + the matching companion field (see
51
+ * {@link PhoneCallHandler}) on the phone number auto-materializes the
52
+ * matching Fabric resource on the server; prefer the `set*` helpers
53
+ * below for the common cases.
54
+ *
42
55
  * @param resourceId - Unique phone-number resource ID.
43
56
  * @param body - Partial update payload. Defaults to `{}`.
44
57
  * @returns The updated phone-number resource.
@@ -63,5 +76,160 @@ export class PhoneNumbersResource extends CrudResource {
63
76
  async search(params) {
64
77
  return this._http.get(this._path('search'), params);
65
78
  }
79
+ // -- Typed binding helpers ----------------------------------------------
80
+ //
81
+ // Each helper is a one-line wrapper over `update` with the right
82
+ // `call_handler` value and companion field already set. Pass through
83
+ // extra fields for cases the helper doesn't name explicitly (e.g.
84
+ // `call_fallback_url` on cXML webhooks).
85
+ /**
86
+ * Route inbound calls to an SWML webhook URL.
87
+ *
88
+ * Your backend returns an SWML document per call. The server
89
+ * auto-creates a `swml_webhook` Fabric resource keyed off this URL —
90
+ * you do **not** need to call `fabric.swmlWebhooks.create` or
91
+ * `fabric.resources.assignPhoneRoute`.
92
+ *
93
+ * @param resourceId - Unique phone-number resource ID.
94
+ * @param url - Your backend's SWML endpoint.
95
+ * @param extra - Additional wire-level fields (e.g. `name`) merged into
96
+ * the PUT body.
97
+ * @returns The updated phone-number resource.
98
+ *
99
+ * @example
100
+ * ```ts
101
+ * await client.phoneNumbers.setSwmlWebhook('pn-1', 'https://example.com/swml');
102
+ * ```
103
+ */
104
+ async setSwmlWebhook(resourceId, url, extra = {}) {
105
+ return this.update(resourceId, {
106
+ call_handler: PhoneCallHandler.RELAY_SCRIPT,
107
+ call_relay_script_url: url,
108
+ ...extra,
109
+ });
110
+ }
111
+ /**
112
+ * Route inbound calls to a cXML (Twilio-compat / LAML) webhook.
113
+ *
114
+ * Despite the wire value `laml_webhooks` being plural, this creates a
115
+ * single `cxml_webhook` Fabric resource. `fallbackUrl` is used when the
116
+ * primary URL fails; `statusCallbackUrl` receives call status updates.
117
+ *
118
+ * @param resourceId - Unique phone-number resource ID.
119
+ * @param params - URL and optional fallback/status URLs plus any extra
120
+ * wire-level fields.
121
+ * @returns The updated phone-number resource.
122
+ *
123
+ * @example
124
+ * ```ts
125
+ * await client.phoneNumbers.setCxmlWebhook('pn-1', {
126
+ * url: 'https://example.com/voice.xml',
127
+ * fallbackUrl: 'https://example.com/fallback.xml',
128
+ * });
129
+ * ```
130
+ */
131
+ async setCxmlWebhook(resourceId, params) {
132
+ const { url, fallbackUrl, statusCallbackUrl, ...extra } = params;
133
+ const body = {
134
+ call_handler: PhoneCallHandler.LAML_WEBHOOKS,
135
+ call_request_url: url,
136
+ ...extra,
137
+ };
138
+ if (fallbackUrl !== undefined) {
139
+ body['call_fallback_url'] = fallbackUrl;
140
+ }
141
+ if (statusCallbackUrl !== undefined) {
142
+ body['call_status_callback_url'] = statusCallbackUrl;
143
+ }
144
+ return this.update(resourceId, body);
145
+ }
146
+ /**
147
+ * Route inbound calls to an existing cXML application by ID.
148
+ *
149
+ * @param resourceId - Unique phone-number resource ID.
150
+ * @param applicationId - cXML application ID.
151
+ * @param extra - Additional wire-level fields merged into the body.
152
+ * @returns The updated phone-number resource.
153
+ */
154
+ async setCxmlApplication(resourceId, applicationId, extra = {}) {
155
+ return this.update(resourceId, {
156
+ call_handler: PhoneCallHandler.LAML_APPLICATION,
157
+ call_laml_application_id: applicationId,
158
+ ...extra,
159
+ });
160
+ }
161
+ /**
162
+ * Route inbound calls to an AI Agent Fabric resource by ID.
163
+ *
164
+ * @param resourceId - Unique phone-number resource ID.
165
+ * @param agentId - AI agent Fabric resource ID.
166
+ * @param extra - Additional wire-level fields merged into the body.
167
+ * @returns The updated phone-number resource.
168
+ */
169
+ async setAiAgent(resourceId, agentId, extra = {}) {
170
+ return this.update(resourceId, {
171
+ call_handler: PhoneCallHandler.AI_AGENT,
172
+ call_ai_agent_id: agentId,
173
+ ...extra,
174
+ });
175
+ }
176
+ /**
177
+ * Route inbound calls to a Call Flow by ID.
178
+ *
179
+ * `version` accepts `"working_copy"` or `"current_deployed"` (server
180
+ * default when omitted).
181
+ *
182
+ * @param resourceId - Unique phone-number resource ID.
183
+ * @param params - Flow ID and optional pinned version plus any extra
184
+ * wire-level fields.
185
+ * @returns The updated phone-number resource.
186
+ */
187
+ async setCallFlow(resourceId, params) {
188
+ const { flowId, version, ...extra } = params;
189
+ const body = {
190
+ call_handler: PhoneCallHandler.CALL_FLOW,
191
+ call_flow_id: flowId,
192
+ ...extra,
193
+ };
194
+ if (version !== undefined) {
195
+ body['call_flow_version'] = version;
196
+ }
197
+ return this.update(resourceId, body);
198
+ }
199
+ /**
200
+ * Route inbound calls to a named RELAY application.
201
+ *
202
+ * @param resourceId - Unique phone-number resource ID.
203
+ * @param name - RELAY application name.
204
+ * @param extra - Additional wire-level fields merged into the body.
205
+ * @returns The updated phone-number resource.
206
+ */
207
+ async setRelayApplication(resourceId, name, extra = {}) {
208
+ return this.update(resourceId, {
209
+ call_handler: PhoneCallHandler.RELAY_APPLICATION,
210
+ call_relay_application: name,
211
+ ...extra,
212
+ });
213
+ }
214
+ /**
215
+ * Route inbound calls to a RELAY topic (client subscription).
216
+ *
217
+ * @param resourceId - Unique phone-number resource ID.
218
+ * @param params - Topic name and optional status-callback URL plus any
219
+ * extra wire-level fields.
220
+ * @returns The updated phone-number resource.
221
+ */
222
+ async setRelayTopic(resourceId, params) {
223
+ const { topic, statusCallbackUrl, ...extra } = params;
224
+ const body = {
225
+ call_handler: PhoneCallHandler.RELAY_TOPIC,
226
+ call_relay_topic: topic,
227
+ ...extra,
228
+ };
229
+ if (statusCallbackUrl !== undefined) {
230
+ body['call_relay_topic_status_callback_url'] = statusCallbackUrl;
231
+ }
232
+ return this.update(resourceId, body);
233
+ }
66
234
  }
67
235
  //# sourceMappingURL=phone-numbers.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"phone-numbers.js","sourceRoot":"","sources":["../../../src/rest/namespaces/phone-numbers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAEvD;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,oBAAqB,SAAQ,YAAY;IACjC,aAAa,GAAoB,KAAK,CAAC;IAE1D,YAAY,IAAgB;QAC1B,KAAK,CAAC,IAAI,EAAE,+BAA+B,CAAC,CAAC;IAC/C,CAAC;IAED;;;;;;;;;;;;;OAaG;IACM,KAAK,CAAC,MAAM,CAAC,OAAY,EAAE;QAClC,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IAC/C,CAAC;IAED;;;;;;;OAOG;IACM,KAAK,CAAC,MAAM,CAAC,UAAkB,EAAE,OAAY,EAAE;QACtD,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,IAAI,CAAC,CAAC;IACtD,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,KAAK,CAAC,MAAM,CAAC,MAAoB;QAC/B,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,CAAC;IACtD,CAAC;CACF"}
1
+ {"version":3,"file":"phone-numbers.js","sourceRoot":"","sources":["../../../src/rest/namespaces/phone-numbers.ts"],"names":[],"mappings":"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"}
@@ -51,6 +51,11 @@ export declare class SkillRegistry {
51
51
  private registry;
52
52
  private lockedNames;
53
53
  private searchPaths;
54
+ /**
55
+ * External skill directories registered via {@link addSkillDirectory}.
56
+ * Mirrors Python's `SkillRegistry._external_paths` (`registry.py:373`).
57
+ */
58
+ private externalPaths;
54
59
  constructor();
55
60
  /**
56
61
  * Get the global singleton instance, creating it on first access.
@@ -123,6 +128,30 @@ export declare class SkillRegistry {
123
128
  * @param path - Absolute path to a directory containing skill files.
124
129
  */
125
130
  addSearchPath(path: string): void;
131
+ /**
132
+ * Add a directory to search for skills.
133
+ *
134
+ * Mirrors Python's
135
+ * `signalwire.skills.registry.SkillRegistry.add_skill_directory`
136
+ * (`registry.py:350-375`): validate that the path exists and is a
137
+ * directory, then append it (de-duplicated) to `externalPaths`. Throws
138
+ * `Error` (the JS analog of Python's `ValueError`) for non-existent
139
+ * paths or non-directories. Distinct from `addSearchPath`, which
140
+ * silently accepts anything; `addSkillDirectory` is the strict
141
+ * Python-parity surface and the recommended entry point for
142
+ * registering third-party skill directories.
143
+ *
144
+ * @param path - Absolute or relative path to a directory containing
145
+ * skill subdirectories.
146
+ * @throws Error when the path doesn't exist or isn't a directory.
147
+ */
148
+ addSkillDirectory(path: string): void;
149
+ /**
150
+ * Returns a copy of the external skill directories registered via
151
+ * {@link addSkillDirectory}. Parity surface for Python's
152
+ * `_external_paths`.
153
+ */
154
+ getExternalPaths(): string[];
126
155
  /**
127
156
  * Get all configured search paths for skill discovery.
128
157
  * @returns Copy of the search paths array.
@@ -15,6 +15,7 @@
15
15
  */
16
16
  import { SkillBase } from './SkillBase.js';
17
17
  import { getLogger } from '../Logger.js';
18
+ import { existsSync, statSync } from 'node:fs';
18
19
  const log = getLogger('SkillRegistry');
19
20
  let _instance = null;
20
21
  /**
@@ -31,6 +32,11 @@ export class SkillRegistry {
31
32
  registry = new Map();
32
33
  lockedNames = new Set();
33
34
  searchPaths;
35
+ /**
36
+ * External skill directories registered via {@link addSkillDirectory}.
37
+ * Mirrors Python's `SkillRegistry._external_paths` (`registry.py:373`).
38
+ */
39
+ externalPaths = [];
34
40
  constructor() {
35
41
  const envPaths = process.env['SIGNALWIRE_SKILL_PATHS'];
36
42
  this.searchPaths = envPaths ? envPaths.split(':').filter(Boolean) : [];
@@ -175,6 +181,42 @@ export class SkillRegistry {
175
181
  this.searchPaths.push(path);
176
182
  }
177
183
  }
184
+ /**
185
+ * Add a directory to search for skills.
186
+ *
187
+ * Mirrors Python's
188
+ * `signalwire.skills.registry.SkillRegistry.add_skill_directory`
189
+ * (`registry.py:350-375`): validate that the path exists and is a
190
+ * directory, then append it (de-duplicated) to `externalPaths`. Throws
191
+ * `Error` (the JS analog of Python's `ValueError`) for non-existent
192
+ * paths or non-directories. Distinct from `addSearchPath`, which
193
+ * silently accepts anything; `addSkillDirectory` is the strict
194
+ * Python-parity surface and the recommended entry point for
195
+ * registering third-party skill directories.
196
+ *
197
+ * @param path - Absolute or relative path to a directory containing
198
+ * skill subdirectories.
199
+ * @throws Error when the path doesn't exist or isn't a directory.
200
+ */
201
+ addSkillDirectory(path) {
202
+ if (!existsSync(path)) {
203
+ throw new Error(`Skill directory does not exist: ${path}`);
204
+ }
205
+ if (!statSync(path).isDirectory()) {
206
+ throw new Error(`Path is not a directory: ${path}`);
207
+ }
208
+ if (!this.externalPaths.includes(path)) {
209
+ this.externalPaths.push(path);
210
+ }
211
+ }
212
+ /**
213
+ * Returns a copy of the external skill directories registered via
214
+ * {@link addSkillDirectory}. Parity surface for Python's
215
+ * `_external_paths`.
216
+ */
217
+ getExternalPaths() {
218
+ return [...this.externalPaths];
219
+ }
178
220
  /**
179
221
  * Get all configured search paths for skill discovery.
180
222
  * @returns Copy of the search paths array.