@scitrera/aether-client 0.2.0 → 0.2.2

package/dist/index.d.cts

@@ -109,6 +109,19 @@ declare enum TaskAssignmentMode {
     Targeted = 1,
     Pool = 2
 }
+/**
+ * Dispatch priority for tasks. Higher priority pending tasks are delivered
+ * before lower ones (ties break FIFO). Values are spaced to allow inserting
+ * new levels later. Unspecified (0) is normalized to Normal by the server.
+ */
+declare enum TaskPriority {
+    Unspecified = 0,
+    XLow = 10,
+    Low = 20,
+    Normal = 30,
+    High = 40,
+    Preempt = 50
+}
 /**
  * Signal types from the gateway.
  */
@@ -2787,6 +2800,12 @@ interface CreateTaskOptions {
     metadata?: Record<string, string>;
     /** Assignment mode. Default: SelfAssign. */
     assignmentMode?: TaskAssignmentMode;
+    /**
+     * Optional dispatch priority. Higher priority pending tasks are delivered
+     * before lower ones. Defaults to Unspecified, which the server normalizes
+     * to Normal.
+     */
+    priority?: TaskPriority;
 }
 /**
  * Client for connecting to the Aether gateway as an agent.
@@ -3514,6 +3533,18 @@ declare class WorkflowEngineClient extends AetherClient {
      * Sends a message to a specific user session.
      */
     sendToUser(userId: string, windowId: string, payload: Uint8Array, messageType?: MessageType): void;
+    /**
+     * Sends a message to every one of a user's windows, regardless of which
+     * workspace each window is viewing (topic uu::{userId}).
+     *
+     * This is the workspace-agnostic, non-progress channel for platform→user
+     * notifications.
+     *
+     * @param userId - Target user's ID
+     * @param payload - Message payload (bytes)
+     * @param messageType - Message type. Default: Opaque
+     */
+    sendToUserBroadcast(userId: string, payload: Uint8Array, messageType?: MessageType): void;
     /**
      * Publishes a metric to the metrics bridge.
      *
@@ -3698,6 +3729,18 @@ declare class BridgeClient extends AetherClient {
      * @param messageType - Message type. Default: Chat
      */
     sendToUserWorkspace(userId: string, workspace: string, payload: Uint8Array, messageType?: MessageType): void;
+    /**
+     * Sends a message to every one of a user's windows, regardless of which
+     * workspace each window is viewing (topic uu::{userId}).
+     *
+     * This is the workspace-agnostic, non-progress channel for platform→user
+     * notifications.
+     *
+     * @param userId - Target user's ID
+     * @param payload - Message payload (bytes)
+     * @param messageType - Message type. Default: Opaque
+     */
+    sendToUserBroadcast(userId: string, payload: Uint8Array, messageType?: MessageType): void;
     /**
      * Sends a message to all agents in a workspace.
      *
@@ -3913,6 +3956,12 @@ declare const TOPIC_PREFIX_TASK_BROADCAST = "tb";
 declare const TOPIC_PREFIX_USER = "us";
 /** Prefix for user workspace topics. */
 declare const TOPIC_PREFIX_USER_WORKSPACE = "uw";
+/**
+ * Prefix for per-user broadcast topics (workspace-agnostic; reaches all of a
+ * user's windows). Publishing is restricted to platform principals
+ * (service / workflow-engine / bridge).
+ */
+declare const TOPIC_PREFIX_USER_BROADCAST = "uu";
 /** Prefix for global agent broadcast topics. */
 declare const TOPIC_PREFIX_GLOBAL_AGENTS = "ga";
 /** Prefix for global user broadcast topics. */
@@ -3995,6 +4044,19 @@ declare function userTopic(userId: string, windowId: string): string;
  * @returns Topic string in format: uw::{userId}::{workspace}
  */
 declare function userWorkspaceTopic(userId: string, workspace: string): string;
+/**
+ * Creates a per-user broadcast topic string.
+ *
+ * Messages sent to this topic reach every one of a user's open windows
+ * regardless of which workspace each window is currently viewing — the
+ * workspace-agnostic, non-progress complement to the per-user progress topic.
+ * Only platform principals (service / workflow-engine / bridge) may publish;
+ * the gateway rejects sends from workspace-scoped principals.
+ *
+ * @param userId - The user's unique identifier
+ * @returns Topic string in format: uu::{userId}
+ */
+declare function userBroadcastTopic(userId: string): string;
 /**
  * Creates a broadcast topic for all users in a workspace.
  *
@@ -4060,4 +4122,4 @@ declare function progressTopic(workspace: string): string;
  */
 declare function bridgeTopic(implementation: string, specifier: string): string;
 
-export { type ACLResponse, type ACLResponseHandler, AdminClient, type AdminQueryResponse, type AdminQueryResponseHandler, type AdminTimeoutOptions, AetherClient, type AetherClientOptions, AetherError, AetherFetchTransport, AgentClient, type AgentClientOptions, type AgentResponse, type AgentResponseHandler, type AuditSubmitResponse, type AuditSubmitResponseHandler, AuthenticationError, type AuthorityCacheClient, AuthorityGrantCache, type AuthorityGrantCacheOptions, type AuthorityGrantInfo, type AuthorityGrantPrincipalRef, type AuthorityGrantResourceScope, type AuthorityGrantResponse, type AuthorityGrantResponseHandler, type AuthorityGrantRevocation, type AuthorityGrantRevocationHandler, BaseOrchestrator, type BaseOrchestratorOptions, BridgeClient, type BridgeClientOptions, CheckpointClient, type CheckpointDeleteOptions, CheckpointError, type CheckpointListOptions, type CheckpointLoadOptions, type CheckpointResponse, type CheckpointResponseHandler, type CheckpointSaveOptions, type ConfigHandler, type ConfigSnapshot, type ConnectHandler, type ConnectionAck, ConnectionClosedError, ConnectionError, type ConnectionOptions, type CreateACLRuleOptions, type CreateTaskOptions, type CreateTokenOptions, type CreateWorkspaceOptions, type Credentials, type DeleteACLRuleOptions, type DeleteWorkspaceOptions, type DisconnectHandler, type DisconnectSessionOptions, DuplicateIdentityError, type ErrorHandler, type ErrorResponse, type GetAgentOptions, type IncomingMessage, InvalidArgumentError, KVClient, type KVDecrementIfOptions, type KVDecrementOptions, type KVDeleteOptions, type KVGetOptions, type KVIncrementIfOptions, type KVIncrementOptions, type KVListOptions, KVOperationError, type KVPutOptions, type KVResponse, type KVResponseHandler, KVScope, type ListACLRulesOptions, type ListAgentsOptions, type ListConnectionsOptions, type ListTokensOptions, type ListWorkspacesOptions, MessageError, type MessageHandler, MessageType, type Metric, MetricBuilder, type MetricEntry, MetricsBridgeClient, type MetricsBridgeClientOptions, NotFoundError, OrchestratorClient, type OrchestratorClientOptions, type OutgoingMessage, PermissionDeniedError, PrincipalType, type ProgressHandler, type ProgressStep, type ProgressUpdate, type ProxyError, ProxyErrorKind, ProxyHttpError, type ProxyHttpOptions, type ProxyHttpResponse, type ReconnectingHandler, ReconnectionError, type ReportProgressOptions, type RevokeTokenOptions, type Signal, type SignalHandler, SignalType, type TLSOptions, TOPIC_PREFIX_AGENT, TOPIC_PREFIX_BRIDGE, TOPIC_PREFIX_EVENT, TOPIC_PREFIX_GLOBAL_AGENTS, TOPIC_PREFIX_GLOBAL_USERS, TOPIC_PREFIX_METRIC, TOPIC_PREFIX_PROGRESS, TOPIC_PREFIX_TASK, TOPIC_PREFIX_TASK_BROADCAST, TOPIC_PREFIX_UNIQUE_TASK, TOPIC_PREFIX_USER, TOPIC_PREFIX_USER_WORKSPACE, type TaskAssignment, type TaskAssignmentHandler, TaskAssignmentMode, TaskClient, type TaskClientOptions, type TaskInfo, type TaskOperationResponse, type TaskOperationResponseHandler, type TaskQueryOptions, type TaskQueryResponse, type TaskQueryResponseHandler, TimeoutError, type TokenInfo, type TokenResponse, type TokenResponseHandler, TunnelClosedError, type TunnelDialOptions, type TunnelProtocol, type TunnelStream, UnimplementedError, type UpdateWorkspaceOptions, UserClient, type UserClientOptions, WorkflowEngineClient, type WorkflowEngineClientOptions, type WorkflowResponse, type WorkflowResponseHandler, type WorkspaceResponse, type WorkspaceResponseHandler, agentTopic, bridgeTopic, eventTopic, eventWildcardTopic, globalAgentsTopic, globalUsersTopic, isConnectionError, isRecoverable, isTimeoutError, metricTopic, metricWildcardTopic, newMetric, progressTopic, proxyHttp, taskBroadcastTopic, taskTopic, tunnelDial, uniqueTaskTopic, userTopic, userWorkspaceTopic, withAPIKey, withTaskToken, withTenant, withToken };
+export { type ACLResponse, type ACLResponseHandler, AdminClient, type AdminQueryResponse, type AdminQueryResponseHandler, type AdminTimeoutOptions, AetherClient, type AetherClientOptions, AetherError, AetherFetchTransport, AgentClient, type AgentClientOptions, type AgentResponse, type AgentResponseHandler, type AuditSubmitResponse, type AuditSubmitResponseHandler, AuthenticationError, type AuthorityCacheClient, AuthorityGrantCache, type AuthorityGrantCacheOptions, type AuthorityGrantInfo, type AuthorityGrantPrincipalRef, type AuthorityGrantResourceScope, type AuthorityGrantResponse, type AuthorityGrantResponseHandler, type AuthorityGrantRevocation, type AuthorityGrantRevocationHandler, BaseOrchestrator, type BaseOrchestratorOptions, BridgeClient, type BridgeClientOptions, CheckpointClient, type CheckpointDeleteOptions, CheckpointError, type CheckpointListOptions, type CheckpointLoadOptions, type CheckpointResponse, type CheckpointResponseHandler, type CheckpointSaveOptions, type ConfigHandler, type ConfigSnapshot, type ConnectHandler, type ConnectionAck, ConnectionClosedError, ConnectionError, type ConnectionOptions, type CreateACLRuleOptions, type CreateTaskOptions, type CreateTokenOptions, type CreateWorkspaceOptions, type Credentials, type DeleteACLRuleOptions, type DeleteWorkspaceOptions, type DisconnectHandler, type DisconnectSessionOptions, DuplicateIdentityError, type ErrorHandler, type ErrorResponse, type GetAgentOptions, type IncomingMessage, InvalidArgumentError, KVClient, type KVDecrementIfOptions, type KVDecrementOptions, type KVDeleteOptions, type KVGetOptions, type KVIncrementIfOptions, type KVIncrementOptions, type KVListOptions, KVOperationError, type KVPutOptions, type KVResponse, type KVResponseHandler, KVScope, type ListACLRulesOptions, type ListAgentsOptions, type ListConnectionsOptions, type ListTokensOptions, type ListWorkspacesOptions, MessageError, type MessageHandler, MessageType, type Metric, MetricBuilder, type MetricEntry, MetricsBridgeClient, type MetricsBridgeClientOptions, NotFoundError, OrchestratorClient, type OrchestratorClientOptions, type OutgoingMessage, PermissionDeniedError, PrincipalType, type ProgressHandler, type ProgressStep, type ProgressUpdate, type ProxyError, ProxyErrorKind, ProxyHttpError, type ProxyHttpOptions, type ProxyHttpResponse, type ReconnectingHandler, ReconnectionError, type ReportProgressOptions, type RevokeTokenOptions, type Signal, type SignalHandler, SignalType, type TLSOptions, TOPIC_PREFIX_AGENT, TOPIC_PREFIX_BRIDGE, TOPIC_PREFIX_EVENT, TOPIC_PREFIX_GLOBAL_AGENTS, TOPIC_PREFIX_GLOBAL_USERS, TOPIC_PREFIX_METRIC, TOPIC_PREFIX_PROGRESS, TOPIC_PREFIX_TASK, TOPIC_PREFIX_TASK_BROADCAST, TOPIC_PREFIX_UNIQUE_TASK, TOPIC_PREFIX_USER, TOPIC_PREFIX_USER_BROADCAST, TOPIC_PREFIX_USER_WORKSPACE, type TaskAssignment, type TaskAssignmentHandler, TaskAssignmentMode, TaskClient, type TaskClientOptions, type TaskInfo, type TaskOperationResponse, type TaskOperationResponseHandler, type TaskQueryOptions, type TaskQueryResponse, type TaskQueryResponseHandler, TimeoutError, type TokenInfo, type TokenResponse, type TokenResponseHandler, TunnelClosedError, type TunnelDialOptions, type TunnelProtocol, type TunnelStream, UnimplementedError, type UpdateWorkspaceOptions, UserClient, type UserClientOptions, WorkflowEngineClient, type WorkflowEngineClientOptions, type WorkflowResponse, type WorkflowResponseHandler, type WorkspaceResponse, type WorkspaceResponseHandler, agentTopic, bridgeTopic, eventTopic, eventWildcardTopic, globalAgentsTopic, globalUsersTopic, isConnectionError, isRecoverable, isTimeoutError, metricTopic, metricWildcardTopic, newMetric, progressTopic, proxyHttp, taskBroadcastTopic, taskTopic, tunnelDial, uniqueTaskTopic, userBroadcastTopic, userTopic, userWorkspaceTopic, withAPIKey, withTaskToken, withTenant, withToken };

package/dist/index.d.ts

@@ -109,6 +109,19 @@ declare enum TaskAssignmentMode {
     Targeted = 1,
     Pool = 2
 }
+/**
+ * Dispatch priority for tasks. Higher priority pending tasks are delivered
+ * before lower ones (ties break FIFO). Values are spaced to allow inserting
+ * new levels later. Unspecified (0) is normalized to Normal by the server.
+ */
+declare enum TaskPriority {
+    Unspecified = 0,
+    XLow = 10,
+    Low = 20,
+    Normal = 30,
+    High = 40,
+    Preempt = 50
+}
 /**
  * Signal types from the gateway.
  */
@@ -2787,6 +2800,12 @@ interface CreateTaskOptions {
     metadata?: Record<string, string>;
     /** Assignment mode. Default: SelfAssign. */
     assignmentMode?: TaskAssignmentMode;
+    /**
+     * Optional dispatch priority. Higher priority pending tasks are delivered
+     * before lower ones. Defaults to Unspecified, which the server normalizes
+     * to Normal.
+     */
+    priority?: TaskPriority;
 }
 /**
  * Client for connecting to the Aether gateway as an agent.
@@ -3514,6 +3533,18 @@ declare class WorkflowEngineClient extends AetherClient {
      * Sends a message to a specific user session.
      */
     sendToUser(userId: string, windowId: string, payload: Uint8Array, messageType?: MessageType): void;
+    /**
+     * Sends a message to every one of a user's windows, regardless of which
+     * workspace each window is viewing (topic uu::{userId}).
+     *
+     * This is the workspace-agnostic, non-progress channel for platform→user
+     * notifications.
+     *
+     * @param userId - Target user's ID
+     * @param payload - Message payload (bytes)
+     * @param messageType - Message type. Default: Opaque
+     */
+    sendToUserBroadcast(userId: string, payload: Uint8Array, messageType?: MessageType): void;
     /**
      * Publishes a metric to the metrics bridge.
      *
@@ -3698,6 +3729,18 @@ declare class BridgeClient extends AetherClient {
      * @param messageType - Message type. Default: Chat
      */
     sendToUserWorkspace(userId: string, workspace: string, payload: Uint8Array, messageType?: MessageType): void;
+    /**
+     * Sends a message to every one of a user's windows, regardless of which
+     * workspace each window is viewing (topic uu::{userId}).
+     *
+     * This is the workspace-agnostic, non-progress channel for platform→user
+     * notifications.
+     *
+     * @param userId - Target user's ID
+     * @param payload - Message payload (bytes)
+     * @param messageType - Message type. Default: Opaque
+     */
+    sendToUserBroadcast(userId: string, payload: Uint8Array, messageType?: MessageType): void;
     /**
      * Sends a message to all agents in a workspace.
      *
@@ -3913,6 +3956,12 @@ declare const TOPIC_PREFIX_TASK_BROADCAST = "tb";
 declare const TOPIC_PREFIX_USER = "us";
 /** Prefix for user workspace topics. */
 declare const TOPIC_PREFIX_USER_WORKSPACE = "uw";
+/**
+ * Prefix for per-user broadcast topics (workspace-agnostic; reaches all of a
+ * user's windows). Publishing is restricted to platform principals
+ * (service / workflow-engine / bridge).
+ */
+declare const TOPIC_PREFIX_USER_BROADCAST = "uu";
 /** Prefix for global agent broadcast topics. */
 declare const TOPIC_PREFIX_GLOBAL_AGENTS = "ga";
 /** Prefix for global user broadcast topics. */
@@ -3995,6 +4044,19 @@ declare function userTopic(userId: string, windowId: string): string;
  * @returns Topic string in format: uw::{userId}::{workspace}
  */
 declare function userWorkspaceTopic(userId: string, workspace: string): string;
+/**
+ * Creates a per-user broadcast topic string.
+ *
+ * Messages sent to this topic reach every one of a user's open windows
+ * regardless of which workspace each window is currently viewing — the
+ * workspace-agnostic, non-progress complement to the per-user progress topic.
+ * Only platform principals (service / workflow-engine / bridge) may publish;
+ * the gateway rejects sends from workspace-scoped principals.
+ *
+ * @param userId - The user's unique identifier
+ * @returns Topic string in format: uu::{userId}
+ */
+declare function userBroadcastTopic(userId: string): string;
 /**
  * Creates a broadcast topic for all users in a workspace.
  *
@@ -4060,4 +4122,4 @@ declare function progressTopic(workspace: string): string;
  */
 declare function bridgeTopic(implementation: string, specifier: string): string;
 
-export { type ACLResponse, type ACLResponseHandler, AdminClient, type AdminQueryResponse, type AdminQueryResponseHandler, type AdminTimeoutOptions, AetherClient, type AetherClientOptions, AetherError, AetherFetchTransport, AgentClient, type AgentClientOptions, type AgentResponse, type AgentResponseHandler, type AuditSubmitResponse, type AuditSubmitResponseHandler, AuthenticationError, type AuthorityCacheClient, AuthorityGrantCache, type AuthorityGrantCacheOptions, type AuthorityGrantInfo, type AuthorityGrantPrincipalRef, type AuthorityGrantResourceScope, type AuthorityGrantResponse, type AuthorityGrantResponseHandler, type AuthorityGrantRevocation, type AuthorityGrantRevocationHandler, BaseOrchestrator, type BaseOrchestratorOptions, BridgeClient, type BridgeClientOptions, CheckpointClient, type CheckpointDeleteOptions, CheckpointError, type CheckpointListOptions, type CheckpointLoadOptions, type CheckpointResponse, type CheckpointResponseHandler, type CheckpointSaveOptions, type ConfigHandler, type ConfigSnapshot, type ConnectHandler, type ConnectionAck, ConnectionClosedError, ConnectionError, type ConnectionOptions, type CreateACLRuleOptions, type CreateTaskOptions, type CreateTokenOptions, type CreateWorkspaceOptions, type Credentials, type DeleteACLRuleOptions, type DeleteWorkspaceOptions, type DisconnectHandler, type DisconnectSessionOptions, DuplicateIdentityError, type ErrorHandler, type ErrorResponse, type GetAgentOptions, type IncomingMessage, InvalidArgumentError, KVClient, type KVDecrementIfOptions, type KVDecrementOptions, type KVDeleteOptions, type KVGetOptions, type KVIncrementIfOptions, type KVIncrementOptions, type KVListOptions, KVOperationError, type KVPutOptions, type KVResponse, type KVResponseHandler, KVScope, type ListACLRulesOptions, type ListAgentsOptions, type ListConnectionsOptions, type ListTokensOptions, type ListWorkspacesOptions, MessageError, type MessageHandler, MessageType, type Metric, MetricBuilder, type MetricEntry, MetricsBridgeClient, type MetricsBridgeClientOptions, NotFoundError, OrchestratorClient, type OrchestratorClientOptions, type OutgoingMessage, PermissionDeniedError, PrincipalType, type ProgressHandler, type ProgressStep, type ProgressUpdate, type ProxyError, ProxyErrorKind, ProxyHttpError, type ProxyHttpOptions, type ProxyHttpResponse, type ReconnectingHandler, ReconnectionError, type ReportProgressOptions, type RevokeTokenOptions, type Signal, type SignalHandler, SignalType, type TLSOptions, TOPIC_PREFIX_AGENT, TOPIC_PREFIX_BRIDGE, TOPIC_PREFIX_EVENT, TOPIC_PREFIX_GLOBAL_AGENTS, TOPIC_PREFIX_GLOBAL_USERS, TOPIC_PREFIX_METRIC, TOPIC_PREFIX_PROGRESS, TOPIC_PREFIX_TASK, TOPIC_PREFIX_TASK_BROADCAST, TOPIC_PREFIX_UNIQUE_TASK, TOPIC_PREFIX_USER, TOPIC_PREFIX_USER_WORKSPACE, type TaskAssignment, type TaskAssignmentHandler, TaskAssignmentMode, TaskClient, type TaskClientOptions, type TaskInfo, type TaskOperationResponse, type TaskOperationResponseHandler, type TaskQueryOptions, type TaskQueryResponse, type TaskQueryResponseHandler, TimeoutError, type TokenInfo, type TokenResponse, type TokenResponseHandler, TunnelClosedError, type TunnelDialOptions, type TunnelProtocol, type TunnelStream, UnimplementedError, type UpdateWorkspaceOptions, UserClient, type UserClientOptions, WorkflowEngineClient, type WorkflowEngineClientOptions, type WorkflowResponse, type WorkflowResponseHandler, type WorkspaceResponse, type WorkspaceResponseHandler, agentTopic, bridgeTopic, eventTopic, eventWildcardTopic, globalAgentsTopic, globalUsersTopic, isConnectionError, isRecoverable, isTimeoutError, metricTopic, metricWildcardTopic, newMetric, progressTopic, proxyHttp, taskBroadcastTopic, taskTopic, tunnelDial, uniqueTaskTopic, userTopic, userWorkspaceTopic, withAPIKey, withTaskToken, withTenant, withToken };
+export { type ACLResponse, type ACLResponseHandler, AdminClient, type AdminQueryResponse, type AdminQueryResponseHandler, type AdminTimeoutOptions, AetherClient, type AetherClientOptions, AetherError, AetherFetchTransport, AgentClient, type AgentClientOptions, type AgentResponse, type AgentResponseHandler, type AuditSubmitResponse, type AuditSubmitResponseHandler, AuthenticationError, type AuthorityCacheClient, AuthorityGrantCache, type AuthorityGrantCacheOptions, type AuthorityGrantInfo, type AuthorityGrantPrincipalRef, type AuthorityGrantResourceScope, type AuthorityGrantResponse, type AuthorityGrantResponseHandler, type AuthorityGrantRevocation, type AuthorityGrantRevocationHandler, BaseOrchestrator, type BaseOrchestratorOptions, BridgeClient, type BridgeClientOptions, CheckpointClient, type CheckpointDeleteOptions, CheckpointError, type CheckpointListOptions, type CheckpointLoadOptions, type CheckpointResponse, type CheckpointResponseHandler, type CheckpointSaveOptions, type ConfigHandler, type ConfigSnapshot, type ConnectHandler, type ConnectionAck, ConnectionClosedError, ConnectionError, type ConnectionOptions, type CreateACLRuleOptions, type CreateTaskOptions, type CreateTokenOptions, type CreateWorkspaceOptions, type Credentials, type DeleteACLRuleOptions, type DeleteWorkspaceOptions, type DisconnectHandler, type DisconnectSessionOptions, DuplicateIdentityError, type ErrorHandler, type ErrorResponse, type GetAgentOptions, type IncomingMessage, InvalidArgumentError, KVClient, type KVDecrementIfOptions, type KVDecrementOptions, type KVDeleteOptions, type KVGetOptions, type KVIncrementIfOptions, type KVIncrementOptions, type KVListOptions, KVOperationError, type KVPutOptions, type KVResponse, type KVResponseHandler, KVScope, type ListACLRulesOptions, type ListAgentsOptions, type ListConnectionsOptions, type ListTokensOptions, type ListWorkspacesOptions, MessageError, type MessageHandler, MessageType, type Metric, MetricBuilder, type MetricEntry, MetricsBridgeClient, type MetricsBridgeClientOptions, NotFoundError, OrchestratorClient, type OrchestratorClientOptions, type OutgoingMessage, PermissionDeniedError, PrincipalType, type ProgressHandler, type ProgressStep, type ProgressUpdate, type ProxyError, ProxyErrorKind, ProxyHttpError, type ProxyHttpOptions, type ProxyHttpResponse, type ReconnectingHandler, ReconnectionError, type ReportProgressOptions, type RevokeTokenOptions, type Signal, type SignalHandler, SignalType, type TLSOptions, TOPIC_PREFIX_AGENT, TOPIC_PREFIX_BRIDGE, TOPIC_PREFIX_EVENT, TOPIC_PREFIX_GLOBAL_AGENTS, TOPIC_PREFIX_GLOBAL_USERS, TOPIC_PREFIX_METRIC, TOPIC_PREFIX_PROGRESS, TOPIC_PREFIX_TASK, TOPIC_PREFIX_TASK_BROADCAST, TOPIC_PREFIX_UNIQUE_TASK, TOPIC_PREFIX_USER, TOPIC_PREFIX_USER_BROADCAST, TOPIC_PREFIX_USER_WORKSPACE, type TaskAssignment, type TaskAssignmentHandler, TaskAssignmentMode, TaskClient, type TaskClientOptions, type TaskInfo, type TaskOperationResponse, type TaskOperationResponseHandler, type TaskQueryOptions, type TaskQueryResponse, type TaskQueryResponseHandler, TimeoutError, type TokenInfo, type TokenResponse, type TokenResponseHandler, TunnelClosedError, type TunnelDialOptions, type TunnelProtocol, type TunnelStream, UnimplementedError, type UpdateWorkspaceOptions, UserClient, type UserClientOptions, WorkflowEngineClient, type WorkflowEngineClientOptions, type WorkflowResponse, type WorkflowResponseHandler, type WorkspaceResponse, type WorkspaceResponseHandler, agentTopic, bridgeTopic, eventTopic, eventWildcardTopic, globalAgentsTopic, globalUsersTopic, isConnectionError, isRecoverable, isTimeoutError, metricTopic, metricWildcardTopic, newMetric, progressTopic, proxyHttp, taskBroadcastTopic, taskTopic, tunnelDial, uniqueTaskTopic, userBroadcastTopic, userTopic, userWorkspaceTopic, withAPIKey, withTaskToken, withTenant, withToken };

package/dist/index.js

@@ -1343,7 +1343,7 @@ function extractGrant(response) {
 // package.json
 var package_default = {
   name: "@scitrera/aether-client",
-  version: "0.2.0",
+  version: "0.2.2",
   description: "TypeScript/JavaScript SDK for the Aether distributed control plane",
   license: "Apache-2.0",
   author: "scitrera.ai",
@@ -1386,9 +1386,9 @@ var package_default = {
     "@grpc/proto-loader": "0.8.1"
   },
   devDependencies: {
-    typescript: "^5.4.0",
     tsup: "^8.0.0",
-    vitest: "^1.4.0"
+    typescript: "^5.4.0",
+    vitest: "^3.2.7"
   },
   engines: {
     node: ">=18.0.0"
@@ -3812,6 +3812,7 @@ var TOPIC_PREFIX_TASK = "ta";
 var TOPIC_PREFIX_TASK_BROADCAST = "tb";
 var TOPIC_PREFIX_USER = "us";
 var TOPIC_PREFIX_USER_WORKSPACE = "uw";
+var TOPIC_PREFIX_USER_BROADCAST = "uu";
 var TOPIC_PREFIX_GLOBAL_AGENTS = "ga";
 var TOPIC_PREFIX_GLOBAL_USERS = "gu";
 var TOPIC_PREFIX_EVENT = "event";
@@ -3839,6 +3840,9 @@ function userTopic(userId, windowId) {
 function userWorkspaceTopic(userId, workspace) {
   return `${TOPIC_PREFIX_USER_WORKSPACE}${IDENTITY_SEP}${userId}${IDENTITY_SEP}${workspace}`;
 }
+function userBroadcastTopic(userId) {
+  return `${TOPIC_PREFIX_USER_BROADCAST}${IDENTITY_SEP}${userId}`;
+}
 function globalUsersTopic(workspace) {
   return `${TOPIC_PREFIX_GLOBAL_USERS}${IDENTITY_SEP}${workspace}`;
 }
@@ -4080,7 +4084,8 @@ var AgentClient = class extends AetherClient {
         targetAgentId: opts.targetAgentId ?? "",
         targetImplementation: opts.targetImplementation ?? "",
         launchParamOverrides: opts.launchParamOverrides ?? {},
-        metadata: opts.metadata ?? {}
+        metadata: opts.metadata ?? {},
+        priority: opts.priority ?? 0 /* Unspecified */
       }
     });
   }
@@ -4742,6 +4747,20 @@ var WorkflowEngineClient = class extends AetherClient {
   sendToUser(userId, windowId, payload, messageType = 6 /* Opaque */) {
     this._sendMessage(userTopic(userId, windowId), payload, messageType);
   }
+  /**
+   * Sends a message to every one of a user's windows, regardless of which
+   * workspace each window is viewing (topic uu::{userId}).
+   *
+   * This is the workspace-agnostic, non-progress channel for platform→user
+   * notifications.
+   *
+   * @param userId - Target user's ID
+   * @param payload - Message payload (bytes)
+   * @param messageType - Message type. Default: Opaque
+   */
+  sendToUserBroadcast(userId, payload, messageType = 6 /* Opaque */) {
+    this._sendMessage(userBroadcastTopic(userId), payload, messageType);
+  }
   /**
    * Publishes a metric to the metrics bridge.
    *
@@ -4962,6 +4981,20 @@ var BridgeClient = class extends AetherClient {
   sendToUserWorkspace(userId, workspace, payload, messageType = 6 /* Opaque */) {
     this._sendMessage(userWorkspaceTopic(userId, workspace), payload, messageType);
   }
+  /**
+   * Sends a message to every one of a user's windows, regardless of which
+   * workspace each window is viewing (topic uu::{userId}).
+   *
+   * This is the workspace-agnostic, non-progress channel for platform→user
+   * notifications.
+   *
+   * @param userId - Target user's ID
+   * @param payload - Message payload (bytes)
+   * @param messageType - Message type. Default: Opaque
+   */
+  sendToUserBroadcast(userId, payload, messageType = 6 /* Opaque */) {
+    this._sendMessage(userBroadcastTopic(userId), payload, messageType);
+  }
   // ===========================================================================
   // Broadcast Helpers
   // ===========================================================================
@@ -5267,6 +5300,7 @@ export {
   TOPIC_PREFIX_TASK_BROADCAST,
   TOPIC_PREFIX_UNIQUE_TASK,
   TOPIC_PREFIX_USER,
+  TOPIC_PREFIX_USER_BROADCAST,
   TOPIC_PREFIX_USER_WORKSPACE,
   TaskAssignmentMode,
   TaskClient,
@@ -5293,6 +5327,7 @@ export {
   taskTopic,
   tunnelDial,
   uniqueTaskTopic,
+  userBroadcastTopic,
   userTopic,
   userWorkspaceTopic,
   withAPIKey,