@xema/omni-protocol 0.1.120 → 0.1.121

package/dist/index.d.ts

@@ -1022,12 +1022,13 @@ export interface Locked {
  */
 export type Lockable<T> = T | Locked;
 /**
- * Who chose a task's capabilities. `not-yet-read` is a fault the provider states on the task rather
- * than hides: the platform's terms could not be read, and the set published is what the provider
- * will honour, not what the platform permits.
+ * Who chose a task's capabilities: the queue that handed the work over, the dialer that declared
+ * outbound work, or nobody for an agent's own outbound. `not-yet-read` is a fault the provider
+ * states on the task rather than hides: the platform's terms could not be read, and the set
+ * published is what the provider will honour, not what the platform permits.
  */
-export type CapabilitySource = "queue" | "nobody" | "not-yet-read";
-export declare const CAPABILITY_SOURCES: readonly ["queue", "nobody", "not-yet-read"];
+export type CapabilitySource = "queue" | "dialer" | "nobody" | "not-yet-read";
+export declare const CAPABILITY_SOURCES: readonly ["queue", "dialer", "nobody", "not-yet-read"];
 export type Task<C extends Channel = Channel> = {
     /** The assignment this task is the record of, and its one identity. See `AssignmentId`. */
     assignmentId: AssignmentId;

package/dist/index.js

@@ -77,7 +77,7 @@ export const DEFAULT_LEVELS = [
 export function effectiveLevels(declared) {
     return [...(declared ?? DEFAULT_LEVELS)];
 }
-export const CAPABILITY_SOURCES = ["queue", "nobody", "not-yet-read"];
+export const CAPABILITY_SOURCES = ["queue", "dialer", "nobody", "not-yet-read"];
 // ---------------------------------------------------------------------------
 // Task commands.
 // ---------------------------------------------------------------------------

package/dist/validation.js

@@ -41,7 +41,7 @@ const TASK_PHASES = membersOf({
     pending: true, confirmed: true, preview: true, "in-progress": true, paused: true, completing: true,
 });
 const COMPLETION_MODES = membersOf({ "agent-command": true, "provider-automatic": true });
-const CAPABILITY_SOURCES = membersOf({ queue: true, nobody: true, "not-yet-read": true });
+const CAPABILITY_SOURCES = membersOf({ queue: true, dialer: true, nobody: true, "not-yet-read": true });
 const ACCEPTANCE_MODES = membersOf({
     "no-preference": true, "consent": true, "automatic": true,
 });

package/guide/agent.md

@@ -154,7 +154,7 @@ time. Runtime conformance checks also require the task channel to match its prov
 | `channel` | Channel used for this task. It must equal the source provider's manifest channel. |
 | `taskType` | Required provider-defined source or category of work, such as a voice `Queue Name`, `Mailbox Folder`, `Chat Source`, `Support`, `Billing`, or `Returns`. |
 | `capabilities` | Controls and workspace features available for this specific task. |
-| `capabilitySource` | Required. Who chose the capabilities: `queue` when somebody configured these terms, `nobody` when nothing handed the work over -- an agent's own outbound -- and `not-yet-read` when a queue was named and its terms could not be read, in which case `capabilities` is what the provider will honour, not what the platform permits. An agent application shows `not-yet-read` where the agent works. See **Task capabilities**. |
+| `capabilitySource` | Required. Who chose the capabilities: `queue` when the queue that handed the work over carries these terms, `dialer` when the dialer that declared outbound work does -- a manual dialer may permit everything, another state narrower terms -- `nobody` when nothing handed the work over -- an agent's own outbound -- and `not-yet-read` when a queue was named and its terms could not be read, in which case `capabilities` is what the provider will honour, not what the platform permits. An agent application shows `not-yet-read` where the agent works. See **Task capabilities**. |
 | `browsers` | Named browser definitions for the task workspace: at least one when the task declares the `browsers` capability, empty when it does not. |
 | `party` | The person or entity on the other end of this task, as a `Contact`: often a name and one address; a withheld caller ID may leave nothing to send at all. Optional. The party is who the task is *with*; `contacts` is the directory. |
 | `phase` | Current canonical task phase: `pending`, `confirmed`, `preview`, `in-progress`, `paused`, or `completing`. `preview` is voice only. |
@@ -387,6 +387,7 @@ Migration from the earlier spellings:
 | a `callback-requested` step, and a callback task starting its history afresh | a `callback-requested` step (`by` when an agent arranged it); a callback's task carries the earlier call's steps, oldest first |
 | a recording state with an observation id, an observation instant and a validity window, and the helpers that aged it | `recordings` on the task and on `HostRecordingReport`: a list, each recording with `id`, `follows` (`party` or `agent`), `status` (`starting`, `recording`, `paused`, `not-recording`, `unknown`) and a `reason` where paused or unknown; nothing expires; commands name `follows` for a start and `recordingId` otherwise; `validateRecordings` (`recording.task.renamed` refuses the former field) |
 | a refusal on hold under `omni.command-not-permitted` | `omni.on-hold` |
+| outbound work's terms reported as `queue` | `dialer`: the dialer that declared the task chose its capabilities |
 | an `end-call` while the caller was on hold | refused: a `paused` task is resumed first (`command.endCall.held`), the agent computer shows End call disabled on hold, the provider answers `failed`, and the test names an adapter that ends from hold (`test.command.held`); `terminate-call` is not gated, it ends the caller's channel too |
 | the handset spelled by its place on a desk | `hardphone`, on the manifest's `phones` and the login's `phone`; the former spelling is refused |
 | the desk | the agent computer, in the guide's prose |

package/guide.md

@@ -755,7 +755,7 @@ type Lockable<T> = T | Locked;
 
 type TaskAudioState = "started" | "ended";
 
-type CapabilitySource = "queue" | "nobody" | "not-yet-read";
+type CapabilitySource = "queue" | "dialer" | "nobody" | "not-yet-read";
 
 type Task<C extends Channel = Channel> = {
   assignmentId: AssignmentId;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xema/omni-protocol",
-  "version": "0.1.120",
+  "version": "0.1.121",
   "description": "The Omni protocol: the contract every provider adapter implements",
   "type": "module",
   "license": "MIT",