@xema/omni-protocol 0.1.97 → 0.1.99

package/dist/validation.d.ts

@@ -1,4 +1,4 @@
-import { type RecordingState, type ProtocolViolation, type UserCapabilities, type UserId } from "./index.js";
+import { type RecordingState, type Channel, type ProtocolViolation, type UserCapabilities, type UserId } from "./index.js";
 export type { ProtocolViolation } from "./index.js";
 export declare class ProtocolConformanceError extends Error {
     readonly violations: readonly ProtocolViolation[];
@@ -45,16 +45,23 @@ export interface TaskValidationContext {
      * carry one of these. Unknown to a host, which never sees the value, and then unchecked.
      */
     locked?: readonly string[];
+    /**
+     * A member's task on the team member list, trimmed by the provider: the workspace -- controls,
+     * their source, browsers, completion terms -- is the member's and may be absent; what is present
+     * is held to the same rules as on the member's own desk.
+     */
+    member?: true;
 }
 export declare function validateTask(task: unknown, context: TaskValidationContext, path?: string): ProtocolViolation[];
 /** Checks break status against the full currently retained task set, after a transaction. */
 export declare function validateBreakStatus(state: unknown, tasks: unknown, path?: string): ProtocolViolation[];
 /**
- * Checks lead break dispatch using current authentication, transport, team member list (`team`) and,
- * for force-break/end-forced-break, the target's full `memberBreak`. The provider must authorize the target
- * and recheck the decision atomically; a team member list is not authority to act after it has changed.
+ * Checks a lead command before dispatch, against the current authentication, transport and team
+ * member list (`team`) and, for force-break and end-forced-break, the target's full `memberBreak`.
+ * The authority is the login's `lead` flag; the provider rechecks the target and the state
+ * atomically, since a team member list is not authority to act after it has changed.
  */
-export declare function validateTeamBreakCommand(request: unknown, context: unknown, path?: string): ProtocolViolation[];
+export declare function validateTeamCommand(request: unknown, context: unknown, path?: string): ProtocolViolation[];
 /** The four agent break methods; this is a validation API, not a wire command. */
 export type BreakMethod = "requestBreak" | "commitBreak" | "cancelBreak" | "endBreak";
 /**
@@ -90,6 +97,13 @@ export interface ReaderContext {
     levels?: readonly string[];
     /** The login's `loginId`. A snapshot or event naming another belongs to a login that is gone. */
     loginId?: string;
+    /**
+     * Whether the lead has the team feature on, as the application last told the provider. On by
+     * default for a lead; off, no team member list is owed or expected. Unknown to a caller without it.
+     */
+    leadFeatures?: boolean;
+    /** The provider's channel, for a member's task that states none. Filled from the manifest by `validateSnapshot` and `validateEventEnvelope`. */
+    channel?: Channel;
     /**
      * The values the queue locked on this login's tasks, as whoever runs the validator knows them:
      * a conformance run states them, a host never has them. Where a task's party stands locked, no
@@ -135,7 +149,7 @@ export declare function validateTaskCommandRequest(request: unknown, task: unkno
  */
 export declare function validateTaskCommand(command: unknown, task?: unknown, path?: string, taskContext?: Omit<TaskValidationContext, "channel">): ProtocolViolation[];
 /** The connection methods whose results `validateResult` knows. */
-export type ResultMethod = "execute" | "dial" | "setCapacity" | "requestBreak" | "commitBreak" | "cancelBreak" | "endBreak" | "executeTeamBreak" | "executeTeamLeadAssist" | "executeTeamListen" | "openMedia" | "setPreference" | "recordStep" | "executeTeamPolicy";
+export type ResultMethod = "execute" | "dial" | "setCapacity" | "requestBreak" | "commitBreak" | "cancelBreak" | "endBreak" | "executeTeam" | "openMedia" | "setPreference" | "recordStep";
 /**
  * Validates what a connection method answered. A result is untrusted for the same reason a
  * snapshot is: it comes from an adapter that may be compiled against another version, and Omni