@alva-ai/toolkit 0.4.1 → 0.4.3

package/dist/cli.js

@@ -637,7 +637,7 @@ var PushSubscriptionsResource = class {
    */
   async subscribePlaybook(params) {
     this.client._requireAuth();
-    const path = `/api/v1/playbook/${encodeURIComponent(params.username)}/${encodeURIComponent(params.name)}/push-subscription`;
+    const path = `/api/v1/push-subscriptions/playbook/${encodeURIComponent(params.username)}/${encodeURIComponent(params.name)}`;
     return this.client._request(
       "POST",
       path
@@ -649,7 +649,7 @@ var PushSubscriptionsResource = class {
    */
   async unsubscribePlaybook(params) {
     this.client._requireAuth();
-    const path = `/api/v1/playbook/${encodeURIComponent(params.username)}/${encodeURIComponent(params.name)}/push-subscription`;
+    const path = `/api/v1/push-subscriptions/playbook/${encodeURIComponent(params.username)}/${encodeURIComponent(params.name)}`;
     return this.client._request(
       "DELETE",
       path
@@ -663,7 +663,7 @@ var PushSubscriptionsResource = class {
    */
   async subscribeFeed(params) {
     this.client._requireAuth();
-    const path = `/api/v1/feed/${encodeURIComponent(params.username)}/${encodeURIComponent(params.name)}/push-subscription`;
+    const path = `/api/v1/push-subscriptions/feed/${encodeURIComponent(params.username)}/${encodeURIComponent(params.name)}`;
     return this.client._request(
       "POST",
       path
@@ -675,7 +675,7 @@ var PushSubscriptionsResource = class {
    */
   async unsubscribeFeed(params) {
     this.client._requireAuth();
-    const path = `/api/v1/feed/${encodeURIComponent(params.username)}/${encodeURIComponent(params.name)}/push-subscription`;
+    const path = `/api/v1/push-subscriptions/feed/${encodeURIComponent(params.username)}/${encodeURIComponent(params.name)}`;
     return this.client._request(
       "DELETE",
       path
@@ -698,6 +698,69 @@ var PushSubscriptionsResource = class {
   }
 };
 
+// src/resources/channelGroupSubscriptions.ts
+var ChannelGroupSubscriptionsResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  async context(params) {
+    this.client._requireAuth();
+    return this.client._request(
+      "GET",
+      "/api/v1/channel/group-subscriptions/context",
+      {
+        query: { session_id: params.session_id }
+      }
+    );
+  }
+  async list(params) {
+    this.client._requireAuth();
+    return this.client._request("GET", "/api/v1/channel/group-subscriptions", {
+      query: { session_id: params.session_id }
+    });
+  }
+  async subscribe(params) {
+    this.client._requireAuth();
+    return this.client._request("POST", "/api/v1/channel/group-subscriptions", {
+      jsonBody: mutationBody(params)
+    });
+  }
+  async unsubscribe(params) {
+    this.client._requireAuth();
+    return this.client._request(
+      "DELETE",
+      "/api/v1/channel/group-subscriptions",
+      {
+        jsonBody: mutationBody(params)
+      }
+    );
+  }
+};
+function mutationBody(params) {
+  return `{"session_id":${idLiteral(params.session_id)},"target_type":${JSON.stringify(params.target_type)},"target_id":${idLiteral(params.target_id)}}`;
+}
+function idLiteral(value) {
+  if (typeof value === "number") {
+    if (!Number.isInteger(value) || value <= 0 || !Number.isSafeInteger(value)) {
+      throw new AlvaError(
+        "INVALID_ARGUMENT",
+        "channel group subscription ids must be positive safe integers; pass large int64 ids as strings",
+        0
+      );
+    }
+    return String(value);
+  }
+  if (!/^[1-9]\d*$/.test(value)) {
+    throw new AlvaError(
+      "INVALID_ARGUMENT",
+      "channel group subscription ids must be positive integer strings",
+      0
+    );
+  }
+  return value;
+}
+
 // src/client.ts
 var DEFAULT_BASE_URL = "https://api-llm.prd.alva.ai";
 var DEFAULT_ARRAYS_BASE_URL = "https://data-tools.prd.space.id";
@@ -721,6 +784,7 @@ var AlvaClient = class {
   _arraysJwt;
   _notifications;
   _pushSubscriptions;
+  _channelGroupSubscriptions;
   constructor(config) {
     this.baseUrl = config.baseUrl ?? DEFAULT_BASE_URL;
     this.arraysBaseUrl = config.arraysBaseUrl ?? DEFAULT_ARRAYS_BASE_URL;
@@ -772,6 +836,9 @@ var AlvaClient = class {
   get pushSubscriptions() {
     return this._pushSubscriptions ??= new PushSubscriptionsResource(this);
   }
+  get channelGroupSubscriptions() {
+    return this._channelGroupSubscriptions ??= new ChannelGroupSubscriptionsResource(this);
+  }
   _requireAuth() {
     if (!this.viewer_token && !this.apiKey) {
       throw new AlvaError(
@@ -808,6 +875,9 @@ var AlvaClient = class {
     if (options?.rawBody !== void 0) {
       headers["Content-Type"] = "application/octet-stream";
       fetchBody = options.rawBody;
+    } else if (options?.jsonBody !== void 0) {
+      headers["Content-Type"] = "application/json";
+      fetchBody = options.jsonBody;
     } else if (options?.body !== void 0) {
       headers["Content-Type"] = "application/json";
       fetchBody = JSON.stringify(options.body);
@@ -1131,7 +1201,7 @@ async function runPostConfigureHooks(client, deps) {
 import * as fs from "fs";
 import * as os2 from "os";
 import * as fsPromises2 from "fs/promises";
-var CLI_VERSION = true ? "0.4.1" : "dev";
+var CLI_VERSION = true ? "0.4.3" : "dev";
 function isVersionOlderThan(a, b) {
   const parse = (v) => {
     if (!v) return null;
@@ -1164,6 +1234,7 @@ Commands:
   skills      Data-skill documentation from the Arrays backend (list, summary, endpoint)
   comments    Playbook comments (create, pin, unpin)
   push-subscriptions  Personal push opt-in (subscribe-playbook, unsubscribe-playbook, subscribe-feed, unsubscribe-feed, list)
+  channel     Channel group operations (group-subscriptions context, list, subscribe, unsubscribe)
   remix       Save playbook remix lineage
   trading     Trading operations (accounts, portfolio, orders, subscriptions, equity-history, risk-rules, subscribe, unsubscribe, execute, update-risk-rules)
   auth        Authentication (login)
@@ -1597,6 +1668,31 @@ Examples:
   alva push-subscriptions subscribe-feed     --username alice --name btc-ema-cross
   alva push-subscriptions unsubscribe-feed   --username alice --name btc-ema-cross
   alva push-subscriptions list --include-history`,
+  channel: `Usage: alva channel group-subscriptions <subcommand> [options]
+
+Manage push notifications delivered into the external group chat attached
+to a channel session. The group can subscribe to public feeds and playbooks.
+Subscribe/unsubscribe are idempotent no-ops unless the authenticated caller
+is that group's Alva admin.
+
+Subcommands:
+  context       Show group admin status and current subscriptions
+  list          List active subscriptions for the group
+  subscribe     Subscribe the group to a public feed or playbook
+  unsubscribe   Unsubscribe the group from a feed or playbook
+
+Common flags:
+  --session-id <id>      Channel session id for the group (required)
+
+Subscribe/unsubscribe flags:
+  --target-type <type>   feed or playbook (required)
+  --target-id <id>       Numeric feed_id or playbook_id (required)
+
+Examples:
+  alva channel group-subscriptions context --session-id 123
+  alva channel group-subscriptions list --session-id 123
+  alva channel group-subscriptions subscribe --session-id 123 --target-type feed --target-id 8169
+  alva channel group-subscriptions unsubscribe --session-id 123 --target-type playbook --target-id 42`,
   remix: `Usage: alva remix --child-username <u> --child-name <n> --parents <json>
 
 Record remix lineage when creating a playbook based on existing playbooks.
@@ -1798,6 +1894,25 @@ function requireNumericFlag(flags, name, command) {
   }
   return n;
 }
+function requirePositiveIntegerStringFlag(flags, name, command) {
+  const val = requireFlag(flags, name, command);
+  if (!/^[1-9]\d*$/.test(val)) {
+    const group = command.split(" ")[0];
+    throw new CliUsageError(
+      `--${name} must be a positive integer for '${command}', got '${val}'`,
+      group
+    );
+  }
+  return val;
+}
+function requireGroupSubscriptionTargetType(flags, command) {
+  const val = requireFlag(flags, "target-type", command).trim().toLowerCase();
+  if (val === "feed" || val === "playbook") return val;
+  throw new CliUsageError(
+    `--target-type must be feed or playbook for '${command}', got '${val}'`,
+    command.split(" ")[0]
+  );
+}
 function num(val) {
   if (val === void 0) return void 0;
   const n = Number(val);
@@ -2240,6 +2355,80 @@ async function dispatch(client, args, meta) {
           );
       }
     }
+    case "channel": {
+      if (!subcommand || subcommand === "--help" || subcommand === "-h") {
+        return { _help: true, text: COMMAND_HELP.channel };
+      }
+      if (subcommand !== "group-subscriptions") {
+        throw new CliUsageError(
+          `Unknown subcommand: channel ${subcommand}`,
+          "channel"
+        );
+      }
+      const leaf = args[2];
+      if (!leaf || leaf === "--help" || leaf === "-h") {
+        return { _help: true, text: COMMAND_HELP.channel };
+      }
+      const channelFlags = parseFlags2(args.slice(3));
+      const commandName = `channel group-subscriptions ${leaf}`;
+      switch (leaf) {
+        case "context":
+          return client.channelGroupSubscriptions.context({
+            session_id: requirePositiveIntegerStringFlag(
+              channelFlags,
+              "session-id",
+              commandName
+            )
+          });
+        case "list":
+          return client.channelGroupSubscriptions.list({
+            session_id: requirePositiveIntegerStringFlag(
+              channelFlags,
+              "session-id",
+              commandName
+            )
+          });
+        case "subscribe":
+          return client.channelGroupSubscriptions.subscribe({
+            session_id: requirePositiveIntegerStringFlag(
+              channelFlags,
+              "session-id",
+              commandName
+            ),
+            target_type: requireGroupSubscriptionTargetType(
+              channelFlags,
+              commandName
+            ),
+            target_id: requirePositiveIntegerStringFlag(
+              channelFlags,
+              "target-id",
+              commandName
+            )
+          });
+        case "unsubscribe":
+          return client.channelGroupSubscriptions.unsubscribe({
+            session_id: requirePositiveIntegerStringFlag(
+              channelFlags,
+              "session-id",
+              commandName
+            ),
+            target_type: requireGroupSubscriptionTargetType(
+              channelFlags,
+              commandName
+            ),
+            target_id: requirePositiveIntegerStringFlag(
+              channelFlags,
+              "target-id",
+              commandName
+            )
+          });
+        default:
+          throw new CliUsageError(
+            `Unknown subcommand: channel group-subscriptions ${leaf}`,
+            "channel"
+          );
+      }
+    }
     case "remix":
       return client.remix.save({
         child: {