@scitrera/aether-client 0.2.0 → 0.2.2

package/README.md

@@ -458,7 +458,7 @@ uniqueTaskTopic("prod", "report", "daily");         // "tu.prod.report.daily"
 taskBroadcastTopic("prod", "worker");               // "tb.prod.worker"
 globalAgentsTopic("prod");                          // "ga.prod"
 eventTopic("task.completed");                       // "event.task.completed"
-bridgeTopic("aether-msgbridge", "discord-1");       // "br.aether-msgbridge.discord-1"
+bridgeTopic("example-bridge", "instance-1");        // "br.example-bridge.instance-1"
 ```
 
 ## Principal Types
@@ -574,8 +574,8 @@ import { BridgeClient, MessageType } from "@scitrera/aether-client";
 
 const bridge = new BridgeClient({
   address: "localhost:50051",
-  implementation: "aether-msgbridge",
-  specifier: "discord-1",
+  implementation: "example-bridge",
+  specifier: "instance-1",
 });
 
 bridge.onMessage((msg) => {

package/dist/index.cjs

@@ -71,6 +71,7 @@ __export(index_exports, {
   TOPIC_PREFIX_TASK_BROADCAST: () => TOPIC_PREFIX_TASK_BROADCAST,
   TOPIC_PREFIX_UNIQUE_TASK: () => TOPIC_PREFIX_UNIQUE_TASK,
   TOPIC_PREFIX_USER: () => TOPIC_PREFIX_USER,
+  TOPIC_PREFIX_USER_BROADCAST: () => TOPIC_PREFIX_USER_BROADCAST,
   TOPIC_PREFIX_USER_WORKSPACE: () => TOPIC_PREFIX_USER_WORKSPACE,
   TaskAssignmentMode: () => TaskAssignmentMode,
   TaskClient: () => TaskClient,
@@ -97,6 +98,7 @@ __export(index_exports, {
   taskTopic: () => taskTopic,
   tunnelDial: () => tunnelDial,
   uniqueTaskTopic: () => uniqueTaskTopic,
+  userBroadcastTopic: () => userBroadcastTopic,
   userTopic: () => userTopic,
   userWorkspaceTopic: () => userWorkspaceTopic,
   withAPIKey: () => withAPIKey,
@@ -1451,7 +1453,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",
@@ -1494,9 +1496,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"
@@ -3921,6 +3923,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";
@@ -3948,6 +3951,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}`;
 }
@@ -4189,7 +4195,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 */
       }
     });
   }
@@ -4851,6 +4858,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.
    *
@@ -5071,6 +5092,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
   // ===========================================================================
@@ -5377,6 +5412,7 @@ var AetherFetchTransport = class {
   TOPIC_PREFIX_TASK_BROADCAST,
   TOPIC_PREFIX_UNIQUE_TASK,
   TOPIC_PREFIX_USER,
+  TOPIC_PREFIX_USER_BROADCAST,
   TOPIC_PREFIX_USER_WORKSPACE,
   TaskAssignmentMode,
   TaskClient,
@@ -5403,6 +5439,7 @@ var AetherFetchTransport = class {
   taskTopic,
   tunnelDial,
   uniqueTaskTopic,
+  userBroadcastTopic,
   userTopic,
   userWorkspaceTopic,
   withAPIKey,