@xema/omni-protocol 0.1.105 → 0.1.107

package/README.md

@@ -11,7 +11,8 @@ system.
 
 | Path | |
 | --- | --- |
-| `guide.md` | **The protocol.** Rules, shapes, and the reasoning behind them. |
+| `guide.md` | **The protocol.** The terms, the shapes, the rules, and how an adapter is declared, connected and held to them. |
+| `guide/` | One file per role and channel: `agent.md`, `lead.md`, `breaks.md`, `phone.md`, `voice.md`, `chat.md`, `email.md`. Each points back into `guide.md` for what it relies on. |
 | `src/index.ts` | The TypeScript declarations. |
 | `src/validation.ts` | Runtime validators Omni applies to adapter output. |
 | `src/testing.ts` | Conformance helpers an adapter runs against its own test state. |

package/dist/testing.d.ts

@@ -1,4 +1,4 @@
-import { type Adapter, type AuthenticationState, type ProviderEventEnvelope, type Snapshot, type Task, type TaskCompletion, type BreakStatus, type BrowserSessionKeyInput, type Channel, type ConnectContext, type Host, type HostGuarantees, type HostMute, type LoginStore, type HostReport, type Manifest, type ProviderEvent } from "./index.js";
+import { type Adapter, type AuthenticationState, type ProviderEventEnvelope, type Snapshot, type Task, type BreakStatus, type BrowserSessionKeyInput, type Channel, type ConnectContext, type Host, type HostGuarantees, type HostMute, type LoginStore, type HostReport, type Manifest, type ProviderEvent } from "./index.js";
 import { type ProtocolViolation } from "./validation.js";
 export { ProtocolConformanceError, assertNoViolations, type ProtocolViolation } from "./validation.js";
 /**
@@ -276,15 +276,6 @@ export interface BreakOnTaskStep {
  * outstanding -- never beside a task, and never later than the step that has none.
  */
 export declare function assertBreakBeginsAfterTask(steps: readonly BreakOnTaskStep[]): void;
-/**
- * Validates the deadline derived from audio end and the task's fixed wrap allowance.
- *
- * A task with no allowance has no deadline, so `observedDeadline` must then be `undefined`: a
- * host counting down what the provider left open is the violation, and so is a host counting
- * nothing down when the provider set a clock. `toleranceMs` absorbs scheduler jitter in a real
- * implementation; pass 0 to demand an exact match.
- */
-export declare function assertWrapTimeout(task: Pick<TaskCompletion, "completionMode" | "wrapAllowance">, audioEndedAt: string, observedDeadline: string | undefined, toleranceMs?: number): void;
 /** One browser in one task of one provider. `providerId` is `Manifest.id`, never `displayName`. */
 export type BrowserIsolationScenario = BrowserSessionKeyInput;
 /** Validates whether two task-browser definitions should share one browser session. */

package/dist/testing.js

@@ -2207,33 +2207,6 @@ export function assertBreakBeginsAfterTask(steps) {
         throw new Error(`Break-on-task scenario must end in effect, ended ${String(steps.at(-1)?.approval)}`);
     }
 }
-/**
- * Validates the deadline derived from audio end and the task's fixed wrap allowance.
- *
- * A task with no allowance has no deadline, so `observedDeadline` must then be `undefined`: a
- * host counting down what the provider left open is the violation, and so is a host counting
- * nothing down when the provider set a clock. `toleranceMs` absorbs scheduler jitter in a real
- * implementation; pass 0 to demand an exact match.
- */
-export function assertWrapTimeout(task, audioEndedAt, observedDeadline, toleranceMs = 1_000) {
-    if (task.wrapAllowance === undefined) {
-        if (observedDeadline !== undefined) {
-            throw new Error(`Wrap deadline mismatch: the task states no allowance, so there is no deadline, received ${observedDeadline}`);
-        }
-        return;
-    }
-    if (observedDeadline === undefined) {
-        throw new Error(`Wrap deadline mismatch: the task allows ${task.wrapAllowance}s, but no deadline was observed`);
-    }
-    const ended = Date.parse(audioEndedAt);
-    const deadline = Date.parse(observedDeadline);
-    if (Number.isNaN(ended) || Number.isNaN(deadline))
-        throw new Error("Wrap scenario requires valid ISO-8601 times");
-    const expected = ended + task.wrapAllowance * 1_000;
-    if (Math.abs(deadline - expected) > toleranceMs) {
-        throw new Error(`Wrap deadline mismatch: expected ${new Date(expected).toISOString()} within ${toleranceMs}ms, received ${observedDeadline}`);
-    }
-}
 /** The session key one scenario derives, or `undefined` where the browser shares nothing. */
 const sessionKeyFor = (scenario) => browserSessionKey(scenario);
 /** Validates whether two task-browser definitions should share one browser session. */