@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
@@ -122,7 +122,15 @@ export class WikipediaSearchSkill extends SkillBase {
122
122
  return this._formatNoResults(trimmedQuery);
123
123
  }
124
124
  try {
125
- const baseUrl = 'https://en.wikipedia.org/w/api.php';
125
+ // Default to en.wikipedia.org's REST API entry. The porting-sdk's
126
+ // `audit_skills_dispatch.py` overrides via `WIKIPEDIA_BASE_URL` so
127
+ // a loopback fixture can stand in for Wikipedia. We append `/api.php`
128
+ // when the override is just the host, so the audit's expected
129
+ // `expected_path_substring="api.php"` still matches.
130
+ const wikiBase = process.env['WIKIPEDIA_BASE_URL'];
131
+ const baseUrl = wikiBase
132
+ ? `${wikiBase.replace(/\/+$/, '')}/api.php`
133
+ : 'https://en.wikipedia.org/w/api.php';
126
134
  const searchUrl = `${baseUrl}?action=query&list=search&format=json` +
127
135
  `&srsearch=${encodeURIComponent(trimmedQuery)}` +
128
136
  `&srlimit=${this.numResults}`;
@@ -146,6 +154,15 @@ export class WikipediaSearchSkill extends SkillBase {
146
154
  if (extract.length > 0) {
147
155
  articles.push(`**${title}**\n\n${extract}`);
148
156
  }
157
+ else if (result.snippet && result.snippet.trim().length > 0) {
158
+ // Fall back to the search-result snippet so we surface
159
+ // *something* about the article when the extract endpoint
160
+ // returns nothing useful (e.g. permissions error, audit
161
+ // fixture, or a stub page). Strip HTML the search API
162
+ // sometimes wraps around match terms.
163
+ const cleanSnippet = result.snippet.replace(/<[^>]+>/g, '').trim();
164
+ articles.push(`**${title}**\n\n${cleanSnippet}`);
165
+ }
149
166
  else {
150
167
  articles.push(`**${title}**\n\nNo summary available for this article.`);
151
168
  }
@@ -1 +1 @@
1
- {"version":3,"file":"wikipedia_search.js","sourceRoot":"","sources":["../../../src/skills/builtin/wikipedia_search.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"wikipedia_search.js","sourceRoot":"","sources":["../../../src/skills/builtin/wikipedia_search.ts"],"names":[],"mappings":"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"}
package/dist/types.d.ts CHANGED
@@ -104,12 +104,18 @@ export interface FunctionInclude {
104
104
  }
105
105
  /**
106
106
  * Callback invoked on each SWML request to dynamically modify an ephemeral copy of the agent.
107
+ *
108
+ * The ephemeral agent is typed as `import('./AgentBase.js').AgentBase` at
109
+ * call sites but kept as a generic type parameter here to avoid a circular
110
+ * import between `types.ts` and `AgentBase.ts`. Cast or import the type
111
+ * explicitly at the call site if you need specific methods.
112
+ *
107
113
  * @param queryParams - URL query parameters from the incoming request.
108
114
  * @param bodyParams - Parsed JSON body of the incoming request.
109
115
  * @param headers - HTTP headers from the incoming request.
110
116
  * @param agent - Ephemeral AgentBase copy that can be mutated without affecting the original.
111
117
  */
112
- export type DynamicConfigCallback = (queryParams: Record<string, string>, bodyParams: Record<string, unknown>, headers: Record<string, string>, agent: unknown) => void | Promise<void>;
118
+ export type DynamicConfigCallback<TAgent = import('./AgentBase.js').AgentBase> = (queryParams: Record<string, string>, bodyParams: Record<string, unknown>, headers: Record<string, string>, agent: TAgent) => void | Promise<void>;
113
119
  /**
114
120
  * Callback invoked when a post-prompt summary is received at the end of a call.
115
121
  * @param summary - Parsed summary object, or null if extraction failed.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@signalwire/sdk",
3
- "version": "2.0.4",
3
+ "version": "2.0.5",
4
4
  "description": "SignalWire AI Agents SDK for TypeScript/Node.js",
5
5
  "type": "module",
6
6
  "main": "dist/index.js",
@@ -20,7 +20,9 @@
20
20
  "prepublishOnly": "npm run build",
21
21
  "test": "vitest run",
22
22
  "test:watch": "vitest",
23
- "dev": "tsc --watch"
23
+ "test:examples": "tsc --noEmit --project tsconfig.examples.json",
24
+ "dev": "tsc --watch",
25
+ "enumerate:doc-surface": "npx tsx scripts/enumerate-doc-surface.ts"
24
26
  },
25
27
  "engines": {
26
28
  "node": ">=18.0.0"
@@ -38,6 +40,7 @@
38
40
  "@types/js-yaml": "^4.0.9",
39
41
  "@types/node": "^20.14.0",
40
42
  "@types/ws": "^8.5.10",
43
+ "tsx": "^4.21.0",
41
44
  "typescript": "^5.5.0",
42
45
  "vitest": "^4.1.5"
43
46
  }