@signalwire/sdk 3.5.0 → 3.6.0

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.
@@ -216,6 +216,9 @@ agent.defineTool({
216
216
  call's SWML.
217
217
  - A tool call is a request from the model, not an authorization. Check
218
218
  identity, state and business rules in the handler.
219
+ - \`gates: [new SemanticGate(...)]\` adds semantic gates: yes/no questions a
220
+ decision model answers about the call before the platform runs the tool.
221
+ A platform release without semantic gates runs the tool ungated.
219
222
  `,
220
223
  docs: [
221
224
  ['docs/swaig-reference.md', 'Every FunctionResult method and action'],
@@ -238,6 +241,7 @@ agent.defineTool({
238
241
  'FunctionResult.swmlChangeStep',
239
242
  'FunctionResult.setPostProcess',
240
243
  'SwaigRequest',
244
+ 'SemanticGate',
241
245
  ],
242
246
  related: ['datamap', 'contexts', 'skills', 'security', 'pgi'],
243
247
  };
@@ -1 +1 @@
1
- {"version":3,"file":"topics.js","sourceRoot":"","sources":["../../../src/cli/tsdocs/topics.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"topics.js","sourceRoot":"","sources":["../../../src/cli/tsdocs/topics.ts"],"names":[],"mappings":"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"}
package/dist/index.d.ts CHANGED
@@ -72,6 +72,8 @@ export { FunctionResult } from './FunctionResult.js';
72
72
  export { FunctionResult as SwaigFunctionResult } from './FunctionResult.js';
73
73
  export type { PaymentPrompt, PaymentAction, PaymentParameter } from './FunctionResult.js';
74
74
  export { SwaigFunction } from './SwaigFunction.js';
75
+ export { SemanticGate, gateDefinitions, applyGateFields, MAX_GATES, MAX_QUESTION_BYTES, MAX_CRITERIA_BYTES, MAX_ON_FAIL_BYTES, RESERVED_FUNCTION_NAMES, } from './SemanticGate.js';
76
+ export type { SemanticGateOptions, FillerPhrases } from './SemanticGate.js';
75
77
  export type { SwaigHandler, SwaigFunctionOptions } from './SwaigFunction.js';
76
78
  export { ParameterSchema, paramSchema, RECORD_FORMATS, RECORD_DIRECTIONS, TAP_DIRECTIONS, TAP_CODECS, } from './ParameterSchema.js';
77
79
  export type { ParameterType, ParameterProperty, ParameterSchemaObject, RecordFormat, RecordDirection, TapDirection, TapCodec, } from './ParameterSchema.js';
package/dist/index.js CHANGED
@@ -71,6 +71,7 @@ export { FunctionResult } from './FunctionResult.js';
71
71
  /** @deprecated Use {@link FunctionResult} instead. */
72
72
  export { FunctionResult as SwaigFunctionResult } from './FunctionResult.js';
73
73
  export { SwaigFunction } from './SwaigFunction.js';
74
+ export { SemanticGate, gateDefinitions, applyGateFields, MAX_GATES, MAX_QUESTION_BYTES, MAX_CRITERIA_BYTES, MAX_ON_FAIL_BYTES, RESERVED_FUNCTION_NAMES, } from './SemanticGate.js';
74
75
  // Typed SWAIG tool-parameter builder (Tier-2 flagship affordance for the
75
76
  // explicit-params path; byte-identical to the untyped `parameters` blob).
76
77
  export { ParameterSchema, paramSchema, RECORD_FORMATS, RECORD_DIRECTIONS, TAP_DIRECTIONS, TAP_CODECS, } from './ParameterSchema.js';
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4DG;AAEH,aAAa;AACb,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,mCAAmC;AACnC,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAG/D,oCAAoC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAM7C,2BAA2B;AAC3B,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,sDAAsD;AACtD,OAAO,EAAE,cAAc,IAAI,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE5E,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EACL,YAAY,EACZ,eAAe,EACf,eAAe,EACf,SAAS,EACT,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,uBAAuB,GACxB,MAAM,mBAAmB,CAAC;AAI3B,yEAAyE;AACzE,0EAA0E;AAC1E,OAAO,EACL,eAAe,EACf,WAAW,EACX,cAAc,EACd,iBAAiB,EACjB,cAAc,EACd,UAAU,GACX,MAAM,sBAAsB,CAAC;AAW9B,8BAA8B;AAC9B,OAAO,EACL,OAAO,EACP,mBAAmB,EACnB,oBAAoB,EACpB,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,cAAc,CAAC;AAEtB,sBAAsB;AACtB,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAEzD,OAAO,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAGxE,eAAe;AACf,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,OAAO,gCAAgC,CAAC;AAExC,qBAAqB;AACrB,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAGvF,oBAAoB;AACpB,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,mBAAmB;AACnB,OAAO,EACL,cAAc,EACd,OAAO,EACP,IAAI,EACJ,UAAU,EACV,cAAc,EACd,mBAAmB,EACnB,aAAa,GACd,MAAM,qBAAqB,CAAC;AAG7B,WAAW;AACX,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAGrD,MAAM;AACN,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAG3C,oBAAoB;AACpB,OAAO,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAGtE,OAAO;AACP,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAG/C,yCAAyC;AACzC,OAAO,EAAE,WAAW,EAAE,yBAAyB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAGjG,qBAAqB;AACrB,OAAO,EACL,UAAU,EACV,sBAAsB,EACtB,SAAS,EACT,sBAAsB,EACtB,WAAW,EACX,gBAAgB,GACjB,MAAM,oBAAoB,CAAC;AAE5B,+BAA+B;AAC/B,OAAO,EACL,wBAAwB,EACxB,8BAA8B,EAC9B,eAAe,GAChB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,2BAA2B,EAC3B,QAAQ,EACR,2BAA2B,EAC3B,kCAAkC,EAClC,8BAA8B,GAC/B,MAAM,wBAAwB,CAAC;AAGhC,SAAS;AACT,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,UAAU;AACV,OAAO,EACL,MAAM,EACN,SAAS,EACT,iBAAiB,EACjB,eAAe,EACf,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,yBAAyB,EACzB,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,aAAa,CAAC;AAGrB,aAAa;AACb,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAO3D,SAAS;AACT,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAU5F,kBAAkB;AAClB,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,EACL,aAAa,EACb,SAAS,EACT,SAAS,EACT,eAAe,EACf,uBAAuB,EACvB,iBAAiB,EACjB,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,EACjB,cAAc,EACd,oBAAoB,EACpB,eAAe,EACf,eAAe,EACf,yBAAyB,EACzB,uBAAuB,EACvB,WAAW,EACX,iBAAiB,EACjB,cAAc,EACd,eAAe,GAChB,MAAM,2BAA2B,CAAC;AAEnC,SAAS;AACT,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAG5E,gBAAgB;AAChB,OAAO,EACL,iBAAiB,EACjB,WAAW,EACX,WAAW,EACX,cAAc,EACd,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAoC5B,+DAA+D;AAC/D,cAAc,kBAAkB,CAAC;AAEjC,kEAAkE;AAClE,cAAc,iBAAiB,CAAC;AAEhC,4EAA4E;AAC5E,cAAc,oBAAoB,CAAC;AAEnC,6DAA6D;AAC7D,OAAO,KAAK,QAAQ,MAAM,qBAAqB,CAAC;AAIhD,OAAO,EAAE,aAAa,IAAI,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAG5E,OAAO,EAAE,UAAU,IAAI,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAG5D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAEH,MAAM,UAAU,UAAU,CAAC,IAAqB;IAC9C,2EAA2E;IAC3E,yEAAyE;IACzE,4EAA4E;IAC5E,0CAA0C;IAC1C,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACxB,8CAA8C;QAC9C,MAAM,YAAY,GAAG,SAAS,CAAC,CAAC,CAA+B,CAAC;QAChE,OAAO,IAAI,WAAW,CAAC,YAAY,CAAC,CAAC;IACvC,CAAC;IACD,OAAO,IAAI,WAAW,CAAC,IAAI,CAAC,CAAC;AAC/B,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,UAAU;IACxB,OAAO,cAAc,CAAC,WAAW,EAAE,CAAC,UAAU,EAAE,CAAC;AACnD,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,oBAAoB;IAClC,OAAO,cAAc,CAAC,WAAW,EAAE,CAAC,kBAAkB,EAAE,CAAC;AAC3D,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAAC,UAA6B;IACzD,cAAc,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;AACpD,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,cAAc,CAAC,WAAW,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;AACnD,CAAC;AAED,oDAAoD;AACpD,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvF,OAAO,EACL,cAAc,EACd,oBAAoB,EACpB,aAAa,EACb,mBAAmB,EACnB,mBAAmB,EACnB,cAAc,GACf,MAAM,iBAAiB,CAAC"}
@@ -5,6 +5,7 @@
5
5
  * They define tools, prompt sections, hints, and global data.
6
6
  */
7
7
  import type { SwaigHandler } from '../SwaigFunction.js';
8
+ import type { FillerPhrases, SemanticGate } from '../SemanticGate.js';
8
9
  import type { SwaigRequest } from '../SwaigContracts.js';
9
10
  import type { FunctionResult } from '../FunctionResult.js';
10
11
  import type { AgentBase } from '../AgentBase.js';
@@ -26,7 +27,11 @@ export interface SkillToolDefinition {
26
27
  handler: SwaigHandler;
27
28
  /** Whether the tool requires secure (authenticated) invocation. */
28
29
  secure?: boolean;
29
- /** Filler phrases spoken while the tool executes, keyed by language. */
30
+ /**
31
+ * Phrases the AI says while the tool runs, keyed by language code, `"auto"`
32
+ * or `"default"`; an entry may also be a list of phrases, a wait script
33
+ * (the type predates wait scripts, so one needs a cast).
34
+ */
30
35
  fillers?: Record<string, string[]>;
31
36
  /** List of parameter names that are required. */
32
37
  required?: string[];
@@ -41,6 +46,14 @@ export interface SkillToolDefinition {
41
46
  * The flag is serialised as `"is_hangup_hook": true` in the SWAIG JSON.
42
47
  */
43
48
  isHangupHook?: boolean;
49
+ /**
50
+ * Semantic gates on the tool: yes/no preconditions a decision model checks
51
+ * right before the platform runs it (see {@link SemanticGate}). They win
52
+ * over gates in the skill's `swaig_fields`.
53
+ */
54
+ gates?: ReadonlyArray<SemanticGate | Record<string, unknown>>;
55
+ /** Phrases the AI says while the gates are checked, shaped like `fillers`. */
56
+ gate_fillers?: FillerPhrases;
44
57
  }
45
58
  /**
46
59
  * Build a {@link SkillToolDefinition} whose `handler` args are *inferred* from
@@ -1 +1 @@
1
- {"version":3,"file":"SkillBase.js","sourceRoot":"","sources":["../../src/skills/SkillBase.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"SkillBase.js","sourceRoot":"","sources":["../../src/skills/SkillBase.ts"],"names":[],"mappings":"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"}
@@ -364,7 +364,7 @@ When `parameters` is a flat map of property definitions written inline, TypeScri
364
364
  | `parameters` | `Record<string, unknown>` | `{}` | Property definitions, or a full JSON Schema object |
365
365
  | `handler` | function | (required) | Called with `(args, rawData, agent)` |
366
366
  | `secure` | `boolean` | `true` | Require a per-call token. The rendered SWML gives the tool its own `web_hook_url` with a `__token` for that function and call. Pass `false` to let the tool run without a token. |
367
- | `fillers` | `Record<string, string[]>` | none | Filler phrases by language code, emitted as the function's `fillers` |
367
+ | `fillers` | `Record<string, string[]>` | none | Phrases the AI says while the function runs, keyed by language code, `auto` or `default`, emitted as the function's `fillers`. The current language's own key is used; without one, the `auto` phrases are translated into that language on first use; without either, `default`. An entry may also be a list of phrases, a wait script, spoken one at a time while the call waits; the type predates wait scripts, so one needs a cast |
368
368
  | `waitFile` | `string` | none | Audio URL, emitted as `wait_file` |
369
369
  | `waitFileLoops` | `number` | none | Emitted as `wait_file_loops` |
370
370
  | `required` | `string[]` | `[]` | Required parameter names, used when `parameters` is a flat map |
@@ -373,6 +373,10 @@ When `parameters` is a flat map of property definitions written inline, TypeScri
373
373
  | `onError` | `SwaigErrorHandler` | none | Called when the handler throws; may return a `FunctionResult` to use as the response |
374
374
  | `errorMessage` | `string` | A generic apology | Response used when the handler throws and no error hook returns one |
375
375
  | `isTypedHandler` | `boolean` | `false` | Marks a handler that takes named parameters; `defineTypedTool()` sets it |
376
+ | `gates` | `(SemanticGate \| Record<string, unknown>)[]` | none | Semantic gates, 1 to 8. See [Semantic gates](#semantic-gates) |
377
+ | `gateFillers` | `FillerPhrases` | none | What the AI says while the gates are checked, shaped like `fillers`. Only with `gates` |
378
+
379
+ **Throws:** `Error` for a gate the platform would refuse, or `gateFillers` without `gates`.
376
380
 
377
381
  The handler's third argument is the agent the request was configured on. With a dynamic config callback or `addPerCallConfig()`, that's the per-request copy. The handler's return value is the tool's response: context for the model, which decides what to say. See [SwaigHandler](#swaighandler) for how each return type is serialized.
378
382
 
@@ -393,6 +397,62 @@ agent.defineTool({
393
397
  });
394
398
  ```
395
399
 
400
+ #### Semantic gates
401
+
402
+ A semantic gate is a yes/no question a decision model answers about the call right before the platform dispatches the function. Every gate on the function must pass for it to run. When one doesn't, the function isn't dispatched, and the model gets that gate's `on_fail` output instead, as if a data_map had returned it. The function's `fillers` and `wait_file` start only once its gates pass, so a blocked call never sounds as if the action were under way.
403
+
404
+ Semantic gates need a platform release that supports them. One that doesn't runs the function ungated, and may or may not log a warning about the unknown key, so don't rely on a gate to protect a function until your platform supports them.
405
+
406
+ The decision model sees three things, under these names: `conversation`, the recent dialogue; `semantic_state`, the call's `global_data.semantic_state`, which [`FunctionResult.setSemanticState()`](#data-actions) sets; and `proposed_function`, the function's name, description and arguments. Write each question as one proposition, and name what it's about with those names in backticks. The model reads literally: it doesn't do arithmetic or compare dates, so put a computed result in `semantic_state` instead of asking for it.
407
+
408
+ This tool runs only when the caller has explicitly asked to cancel:
409
+
410
+ ```ts
411
+ import { FunctionResult, SemanticGate } from '@signalwire/sdk';
412
+
413
+ agent.defineTool({
414
+ name: 'cancel_account',
415
+ description: "Cancel the caller's account.",
416
+ handler: () => new FunctionResult('The account is cancelled.'),
417
+ gates: [
418
+ new SemanticGate(
419
+ 'Has the caller explicitly asked to cancel their account in `conversation`?',
420
+ 0.95,
421
+ new FunctionResult()
422
+ .setToolResponse(
423
+ 'cancel_account was not run.',
424
+ 'Ask the caller to confirm that they want to cancel.',
425
+ )
426
+ .updateGlobalData({ cancel_attempted: true }),
427
+ {
428
+ id: 'explicit_request',
429
+ trueMeans: 'The caller says they want to cancel.',
430
+ falseMeans: 'The caller asked about cancelling, or said something else.',
431
+ },
432
+ ),
433
+ ],
434
+ gateFillers: { default: ['Let me verify that.'] },
435
+ });
436
+ ```
437
+
438
+ `new SemanticGate(question, threshold, onFail, opts?)` takes:
439
+
440
+ | Argument | Type | Description |
441
+ |----------|------|-------------|
442
+ | `question` | `string` | The yes/no question, at most 8 KB. Its `${...}` variables are expanded from the call's global data when the gate is checked |
443
+ | `threshold` | `number` | The probability of yes, above 0 and at most 1, at or above which the gate passes |
444
+ | `onFail` | `string \| FunctionResult \| Record<string, unknown>` | What the model gets when this is the first gate that fails: the tool result text, a `FunctionResult`, whose response and actions are used, or a data_map output object. It needs a response, and in the `tool_result`/`tool_prompt` form a `tool_result`: a blocked call must never read as a success. The `tool_prompt` becomes a system message after the tool result; OpenAI Realtime agents don't use it, so put what they need in the `tool_result`. The actions run as written, without template expansion |
445
+ | `opts.id` | `string` | 1 to 64 letters, digits or underscores, unique within the function. Default `gate_<n>`, 1-based |
446
+ | `opts.trueMeans`, `opts.falseMeans` | `string` | What yes and no mean, at most 2 KB each |
447
+
448
+ Gates are checked by the platform's rules when the tool is defined, and once more when the SWML is rendered. The platform refuses the whole function for an invalid gate, so the SDK throws instead. Gates aren't allowed on the hook names `startup_hook`, `hangup_hook` and `check_for_input`, on `end_call`, or on a built-in function's name. A gated function also needs a description, and a `web_hook_url` or `data_map`; tools the SDK builds always have them. A `gates` given as `null` is refused rather than dropped, since the platform refuses that function too.
449
+
450
+ The SDK is stricter than the platform in two ways: it refuses `gateFillers` without `gates`, which the platform would ignore, and it refuses a NUL character or an unpaired surrogate in a gate, which the platform would read differently.
451
+
452
+ When a gate check can't be completed, because the decision model timed out or failed, the call is blocked too, and the model is told the action couldn't be completed right now. [`setSemanticGates()`](#setsemanticgatesopts) sets the time a check may take.
453
+
454
+ The SDK checks the functions it renders. Functions it doesn't build, such as those a `onSwmlRequest` hook writes into the SWML, remote function includes, and functions an MCP server provides, aren't checked.
455
+
396
456
  #### `defineTypedTool(opts)`
397
457
 
398
458
  Register a tool whose handler takes the arguments as named positional parameters instead of an `args` object. When `parameters` is omitted, the SDK infers a schema from the handler's parameter names and default values.
@@ -409,9 +469,13 @@ defineTypedTool(opts: {
409
469
  waitFile?: string;
410
470
  waitFileLoops?: number;
411
471
  required?: string[];
472
+ gates?: ReadonlyArray<SemanticGate | Record<string, unknown>>;
473
+ gateFillers?: FillerPhrases;
412
474
  }): this
413
475
  ```
414
476
 
477
+ `gates` and `gateFillers` work as they do on [`defineTool()`](#semantic-gates).
478
+
415
479
  #### `getTools()`
416
480
 
417
481
  Get every registered `SwaigFunction`. DataMap and other raw function definitions aren't included. Calls `defineTools()` first if it hasn't run.
@@ -441,7 +505,7 @@ getTool(name: string): SwaigFunction | undefined
441
505
 
442
506
  #### `registerSwaigFunction(fn)`
443
507
 
444
- Register a `SwaigFunction`, or a raw function definition such as the output of `DataMap.toSwaigFunction()`. A raw definition is registered under its `function` key and rendered as is.
508
+ Register a `SwaigFunction`, or a raw function definition such as the output of `DataMap.toSwaigFunction()`. A raw definition is registered under its `function` key and rendered as is. A raw definition with `gates` or `gate_fillers` is checked by the platform's rules (see [Semantic gates](#semantic-gates)), and a normalized copy is registered; the object you pass is left as it was.
445
509
 
446
510
  <!-- snippet: no-compile API signature / type reference, not runnable code -->
447
511
  ```ts
@@ -600,6 +664,27 @@ Merge entries into `params`.
600
664
  setParams(params: Record<string, unknown>): this
601
665
  ```
602
666
 
667
+ #### `setSemanticGates(opts?)`
668
+
669
+ Set how the call checks its functions' [semantic gates](#semantic-gates). Each option left out leaves its current setting as it is; the platform's default applies to a setting that was never set.
670
+
671
+ <!-- snippet: no-compile API signature / type reference, not runnable code -->
672
+ ```ts
673
+ setSemanticGates(opts?: { enabled?: boolean; timeoutMs?: number; history?: number }): this
674
+ ```
675
+
676
+ | Option | Type | Default | Description |
677
+ |--------|------|---------|-------------|
678
+ | `enabled` | `boolean` | `true` | `false` dispatches gated functions without checking their gates. Sent as `semantic_gates_enabled` |
679
+ | `timeoutMs` | `number` | `2500` | The time one check may take, 500 to 10000 milliseconds. A check that runs out blocks the call. Sent as `semantic_gate_timeout_ms` |
680
+ | `history` | `number` | `20` | How many recent dialogue entries the decision model sees, 0 to 100. Sent as `semantic_gate_history` |
681
+
682
+ **Throws:** `Error` for a value of the wrong type or out of range; a refused call changes nothing.
683
+
684
+ ```ts
685
+ agent.setSemanticGates({ timeoutMs: 4000, history: 30 });
686
+ ```
687
+
603
688
  #### `setGlobalData(data)`
604
689
 
605
690
  Merge entries into `global_data`. Existing keys, including those a skill added, are kept unless `data` has the same key. To clear the object first, use `replaceGlobalData()`.
@@ -1443,6 +1528,7 @@ console.log(JSON.stringify(result.toDict()));
1443
1528
  | `say` | `(text: string): this` | `{ say: text }` |
1444
1529
  | `playBackgroundFile` | `(filename: string, wait?: boolean): this` | `{ playback_bg: filename }`, or `{ playback_bg: { file, wait: true } }` when `wait` is `true` |
1445
1530
  | `stopBackgroundFile` | `(): this` | `{ stop_playback_bg: true }` |
1531
+ | `changeVoice` | `(voice: string): this` | `{ change_voice: voice }`. Changes the AI's voice for the rest of the call, from the next batch of speech on; `voice` is in the `engine.voice:model` form a language's voice takes. Throws on an empty voice |
1446
1532
 
1447
1533
  ### Speech Actions
1448
1534
 
@@ -1459,6 +1545,7 @@ console.log(JSON.stringify(result.toDict()));
1459
1545
  |--------|-----------|-------|
1460
1546
  | `updateGlobalData` | `(data: Record<string, unknown>): this` | `{ set_global_data: data }` |
1461
1547
  | `removeGlobalData` | `(keys: string \| string[]): this` | `{ unset_global_data: keys }` |
1548
+ | `setSemanticState` | `(state: Record<string, unknown>): this` | `{ set_global_data: { semantic_state: state } }`. Replaces the state [semantic gates](#semantic-gates) judge, as a whole; send `{}` to reset it |
1462
1549
  | `setMetadata` | `(data: Record<string, unknown>): this` | `{ set_meta_data: data }` |
1463
1550
  | `removeMetadata` | `(keys: string \| string[]): this` | `{ unset_meta_data: keys }` |
1464
1551
 
@@ -1791,6 +1878,24 @@ Set `error_keys` on the `data_map`. The platform reads `error_keys` only on a we
1791
1878
  globalErrorKeys(keys: string[]): this
1792
1879
  ```
1793
1880
 
1881
+ #### `gate(gate)`
1882
+
1883
+ Add a [semantic gate](#semantic-gates), a yes/no precondition a decision model checks right before the platform runs the function. Call once per gate, up to 8. When a gate fails, the data_map doesn't run, and the model gets that gate's `on_fail` output. `toSwaigFunction()` throws for a gate the platform would refuse, checking it after environment variables are expanded.
1884
+
1885
+ <!-- snippet: no-compile API signature / type reference, not runnable code -->
1886
+ ```ts
1887
+ gate(gate: SemanticGate | Record<string, unknown>): this
1888
+ ```
1889
+
1890
+ #### `gateFillers(fillers)`
1891
+
1892
+ Set what the AI says while the function's gates are checked, shaped like a function's fillers. Only for a function with gates.
1893
+
1894
+ <!-- snippet: no-compile API signature / type reference, not runnable code -->
1895
+ ```ts
1896
+ gateFillers(fillers: FillerPhrases): this
1897
+ ```
1898
+
1794
1899
  ### DataMap Registration and Serialization
1795
1900
 
1796
1901
  #### `registerWithAgent(agent)`
@@ -3323,7 +3428,7 @@ interface SwaigFunctionOptions
3323
3428
  | `description` | `string` | (required) | Description the model reads |
3324
3429
  | `parameters` | `Record<string, unknown>` | `{}` | Property definitions or a full JSON Schema object |
3325
3430
  | `secure` | `boolean` | `true` | Require a per-call token; `false` lets the tool run without one |
3326
- | `fillers` | `Record<string, string[]>` | none | Filler phrases by language code |
3431
+ | `fillers` | `Record<string, string[]>` | none | Phrases said while the function runs, keyed by language code, `auto` or `default`; an entry may also be a wait script, with a cast |
3327
3432
  | `waitFile` | `string` | none | Wait audio URL |
3328
3433
  | `waitFileLoops` | `number` | none | Wait audio loop count |
3329
3434
  | `webhookUrl` | `string` | none | External URL that runs the tool |
@@ -3332,6 +3437,8 @@ interface SwaigFunctionOptions
3332
3437
  | `isTypedHandler` | `boolean` | `false` | Whether the handler takes named parameters |
3333
3438
  | `onError` | `SwaigErrorHandler` | none | Per-tool error hook |
3334
3439
  | `errorMessage` | `string` | A generic apology | Response when the handler throws and no hook returns one |
3440
+ | `gates` | `(SemanticGate \| Record<string, unknown>)[]` | none | [Semantic gates](#semantic-gates), 1 to 8 |
3441
+ | `gateFillers` | `FillerPhrases` | none | Phrases said while the gates are checked. Only with `gates` |
3335
3442
 
3336
3443
  ### AuthConfig
3337
3444
 
@@ -5,13 +5,14 @@ This page is the reference for the `DataMap` class in the SignalWire AI Agents T
5
5
  <!-- snippet-setup -->
6
6
  ```ts
7
7
  export {}; // treat each runnable example as a module
8
- // Shared context the examples assume: `DataMap`/`FunctionResult` (imported once and
9
- // reused), `agent` (an AgentBase), and `tool` (the DataMap built in the current example).
10
- // Declared as ambient globals so each fragment resolves without repeating the boilerplate.
11
- // A block that constructs or imports its own `const tool`/`DataMap` shadows these.
8
+ // Shared context the examples assume: `DataMap`/`FunctionResult`/`SemanticGate` (imported
9
+ // once and reused), `agent` (an AgentBase), and `tool` (the DataMap built in the current
10
+ // example). Declared as ambient globals so each fragment resolves without repeating the
11
+ // boilerplate. A block that constructs or imports its own `const tool`/`DataMap` shadows these.
12
12
  declare global {
13
13
  const DataMap: typeof import('@signalwire/sdk').DataMap;
14
14
  const FunctionResult: typeof import('@signalwire/sdk').FunctionResult;
15
+ const SemanticGate: typeof import('@signalwire/sdk').SemanticGate;
15
16
  const agent: import('@signalwire/sdk').AgentBase;
16
17
  const tool: import('@signalwire/sdk').DataMap;
17
18
  }
@@ -43,6 +44,9 @@ The page has these sections:
43
44
  - [fallbackOutput](#fallbackoutput)
44
45
  - [errorKeys](#errorkeys)
45
46
  - [globalErrorKeys](#globalerrorkeys)
47
+ - [Semantic Gates](#semantic-gates)
48
+ - [gate](#gate)
49
+ - [gateFillers](#gatefillers)
46
50
  - [Iteration](#iteration)
47
51
  - [foreach](#foreach)
48
52
  - [Environment Variables](#environment-variables)
@@ -629,6 +633,49 @@ With a ZIP code, the platform requests the first webhook. With only a city, it s
629
633
 
630
634
  ---
631
635
 
636
+ ## Semantic Gates
637
+
638
+ A semantic gate is a yes/no question a decision model answers about the call right before the platform runs the function. When a gate fails, the data_map doesn't run at all: no expression or webhook is tried, and the model gets the gate's `on_fail` output. The [API reference](api-reference.md#semantic-gates) describes gates and their limits. They need a platform release that supports them; one that doesn't runs the function ungated.
639
+
640
+ ### gate
641
+
642
+ This method adds a gate. Call it once per gate, up to 8.
643
+
644
+ <!-- snippet: no-compile API signature / illustrative fragment, not runnable -->
645
+ ```typescript
646
+ gate(gate: SemanticGate | Record<string, unknown>): this
647
+ ```
648
+
649
+ `toSwaigFunction()` checks the gates by the platform's rules, after environment variables are expanded, and throws for one the platform would refuse. This tool places an order only once the caller has confirmed it:
650
+
651
+ <!-- snippet: no-run illustrative fragment: references the assumed `DataMap` and `SemanticGate` from the page prelude (declared type-only in the shared snippet-setup), not a standalone program -->
652
+ ```typescript
653
+ const placeOrder = new DataMap('place_order')
654
+ .purpose('Place the order the caller confirmed')
655
+ .webhook('POST', 'https://orders.example.com/orders')
656
+ .params({ item: '${args.item}' })
657
+ .output(new FunctionResult('The order is placed.'))
658
+ .gate(
659
+ new SemanticGate(
660
+ 'Has the caller confirmed the order in `conversation`?',
661
+ 0.9,
662
+ 'place_order was not run.',
663
+ ),
664
+ )
665
+ .gateFillers({ default: ['Let me check that.'] });
666
+ ```
667
+
668
+ ### gateFillers
669
+
670
+ This method sets what the AI says while the gates are checked, shaped like a function's fillers: phrases keyed by language code, `auto` or `default`. It's only for a function with gates.
671
+
672
+ <!-- snippet: no-compile API signature / illustrative fragment, not runnable -->
673
+ ```typescript
674
+ gateFillers(fillers: FillerPhrases): this
675
+ ```
676
+
677
+ ---
678
+
632
679
  ## Iteration
633
680
 
634
681
  ### foreach
@@ -43,6 +43,7 @@ The reference groups the methods by what they do:
43
43
  - [say](#say)
44
44
  - [playBackgroundFile](#playbackgroundfile)
45
45
  - [stopBackgroundFile](#stopbackgroundfile)
46
+ - [changeVoice](#changevoice)
46
47
  - [Speech](#speech)
47
48
  - [addDynamicHints](#adddynamichints)
48
49
  - [clearDynamicHints](#cleardynamichints)
@@ -51,6 +52,7 @@ The reference groups the methods by what they do:
51
52
  - [Data Management](#data-management)
52
53
  - [updateGlobalData](#updateglobaldata)
53
54
  - [removeGlobalData](#removeglobaldata)
55
+ - [setSemanticState](#setsemanticstate)
54
56
  - [setMetadata](#setmetadata)
55
57
  - [removeMetadata](#removemetadata)
56
58
  - [SWML Actions](#swml-actions)
@@ -702,6 +704,29 @@ const result = new FunctionResult('The music is stopped.')
702
704
  .stopBackgroundFile();
703
705
  ```
704
706
 
707
+ ### changeVoice
708
+
709
+ Change the AI's voice for the rest of the call (`change_voice`). The voice takes the `engine.voice:model` form a language's voice takes, and may be on another engine. It replaces the current language's voice from the next batch of speech on, never mid-utterance, and stays for that language for the rest of the call. A voice that won't open falls back to the fallback voice.
710
+
711
+ <!-- snippet: no-compile API signature reference, not runnable code -->
712
+ ```typescript
713
+ changeVoice(voice: string): this
714
+ ```
715
+
716
+ | Parameter | Type | Description |
717
+ |-----------|----------|--------------------------------------------------------|
718
+ | `voice` | `string` | The voice as `engine.voice:model`, such as `elevenlabs.rachel`. |
719
+
720
+ **Returns:** `this` for chaining.
721
+
722
+ **Throws:** `Error` when `voice` is empty or only whitespace. The platform would ignore it.
723
+
724
+ **Example:**
725
+
726
+ ```typescript
727
+ const result = new FunctionResult('The voice is changed.').changeVoice('elevenlabs.rachel');
728
+ ```
729
+
705
730
  ## Speech
706
731
 
707
732
  ### addDynamicHints
@@ -822,6 +847,29 @@ const result = new FunctionResult('The customer record is loaded.')
822
847
  .updateGlobalData({ customer_id: 'C-123', tier: 'premium' });
823
848
  ```
824
849
 
850
+ ### setSemanticState
851
+
852
+ Set the state the call's semantic gates judge, besides the dialogue: `global_data.semantic_state` (sent as `set_global_data`). It replaces the state as a whole: to change one field, send the whole state with that field changed, and send `{}` to reset it. Keep it to what the application has established, such as an order the caller confirmed, rather than what the caller claims. It's the only global data copied into the decision model's state; a gate question can still bring in other global data with a `${global_data.x}` template. See [Semantic gates](api-reference.md#semantic-gates).
853
+
854
+ <!-- snippet: no-compile API signature reference, not runnable code -->
855
+ ```typescript
856
+ setSemanticState(state: Record<string, unknown>): this
857
+ ```
858
+
859
+ | Parameter | Type | Description |
860
+ |-----------|---------------------------|---------------------|
861
+ | `state` | `Record<string, unknown>` | The semantic state. |
862
+
863
+ **Returns:** `this` for chaining.
864
+
865
+ **Example:**
866
+
867
+ ```typescript
868
+ const result = new FunctionResult('The order is confirmed.').setSemanticState({
869
+ order: { item: 'large pepperoni', confirmed: true },
870
+ });
871
+ ```
872
+
825
873
  ### removeGlobalData
826
874
 
827
875
  Remove one or more keys from the global data (`unset_global_data`).
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@signalwire/sdk",
3
- "version": "3.5.0",
3
+ "version": "3.6.0",
4
4
  "description": "SignalWire AI Agents SDK for TypeScript/Node.js",
5
5
  "keywords": [
6
6
  "signalwire",