@alva-ai/toolkit 0.7.0-beta.0 → 0.8.0

package/dist/cli.js

@@ -285,7 +285,8 @@ var ReleaseResource = class {
         description: params.description,
         feeds: params.feeds,
         trading_symbols: params.trading_symbols,
-        template_id: params.template_id
+        skill_id: params.skill_id,
+        tags: params.tags
       }
     });
   }
@@ -303,6 +304,32 @@ var ReleaseResource = class {
   }
 };
 
+// src/resources/feed.ts
+var FeedResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  /**
+   * Soft-delete a feed and all its active majors. Cascades:
+   *   - all active feed_majors are soft-deleted in the same transaction
+   *   - associated producer cronjobs are removed best-effort (the cronjob
+   *     scavenger reconciles any leftover rows on its next sweep)
+   *
+   * Auth: caller must own the feed (uid match), enforced by the backend.
+   */
+  async delete(params) {
+    this.client._requireAuth();
+    if (!Number.isInteger(params.id) || params.id <= 0) {
+      throw new Error("feed id must be a positive integer");
+    }
+    return this.client._request(
+      "DELETE",
+      `/api/v1/feed/${encodeURIComponent(String(params.id))}`
+    );
+  }
+};
+
 // src/resources/secrets.ts
 var SecretsResource = class {
   constructor(client) {
@@ -1864,16 +1891,16 @@ var PushSubscriptionsResource = class {
     );
   }
   /**
-   * List the caller's personal push subscriptions across all targets
-   * (playbook + feed). Defaults to currently-active rows only; pass
-   * `include_history=true` to also return previously-unsubscribed rows.
+   * List the caller's currently active personal push subscriptions.
+   * Results are cursor-paginated.
    */
   async list(params = {}) {
     this.client._requireAuth();
     const query = {};
-    if (params.include_history !== void 0) {
-      query.include_history = String(params.include_history);
+    if (params.first !== void 0 && params.first > 0) {
+      query.first = String(params.first);
     }
+    if (params.cursor) query.cursor = params.cursor;
     return this.client._request("GET", "/api/v1/me/push-subscriptions", {
       query
     });
@@ -1955,6 +1982,7 @@ var AlvaClient = class {
   _run;
   _deploy;
   _release;
+  _feed;
   _secrets;
   _sdk;
   _dataSkills;
@@ -1986,6 +2014,9 @@ var AlvaClient = class {
   get release() {
     return this._release ??= new ReleaseResource(this);
   }
+  get feed() {
+    return this._feed ??= new FeedResource(this);
+  }
   get secrets() {
     return this._secrets ??= new SecretsResource(this);
   }
@@ -2432,12 +2463,12 @@ function formatEndpointMetadataTable(endpoints) {
     const key = ["method", "path", "file", "tier", "access"][i];
     return Math.max(h.length, ...rows.map((r) => String(r[key]).length));
   });
-  const pad2 = (s, w) => s + " ".repeat(Math.max(0, w - s.length));
+  const pad = (s, w) => s + " ".repeat(Math.max(0, w - s.length));
   const lines = [
-    headers.map((h, i) => pad2(h, widths[i])).join("  "),
+    headers.map((h, i) => pad(h, widths[i])).join("  "),
     widths.map((w) => "-".repeat(w)).join("  "),
     ...rows.map(
-      (r) => [r.method, r.path, r.file, r.tier, r.access].map((v, i) => pad2(String(v), widths[i])).join("  ")
+      (r) => [r.method, r.path, r.file, r.tier, r.access].map((v, i) => pad(String(v), widths[i])).join("  ")
     )
   ];
   return lines.join("\n");
@@ -2488,28 +2519,17 @@ function formatSkillEndpoint(doc) {
 }
 
 // src/cli/playbookSkillsFormat.ts
-function pad(s, w) {
-  return s + " ".repeat(Math.max(0, w - s.length));
-}
 function formatPlaybookSkillsList(result) {
   const skills = result.skills ?? [];
   if (skills.length === 0) return "No playbook skills found.\n";
-  const rows = skills.map((s) => ({
-    id: `${s.username}/${s.name}`,
-    description: s.description ?? "",
-    tags: (s.tags ?? []).join(","),
-    updated_at: s.updated_at ?? ""
-  }));
-  const headers = ["USERNAME/NAME", "DESCRIPTION", "TAGS", "UPDATED_AT"];
-  const keys = ["id", "description", "tags", "updated_at"];
-  const widths = headers.map(
-    (h, i) => Math.max(h.length, ...rows.map((r) => r[keys[i]].length))
-  );
-  const lines = [
-    headers.map((h, i) => pad(h, widths[i])).join("  "),
-    widths.map((w) => "-".repeat(w)).join("  "),
-    ...rows.map((r) => keys.map((k, i) => pad(r[k], widths[i])).join("  "))
-  ];
+  const lines = [];
+  for (const s of skills) {
+    lines.push(`\u2022 ${s.username}/${s.name}`);
+    if (s.description) lines.push(`  ${s.description}`);
+    const tags = (s.tags ?? []).join(", ");
+    if (tags) lines.push(`  tags: ${tags}`);
+    if (s.updated_at) lines.push(`  updated: ${s.updated_at}`);
+  }
   return lines.join("\n") + "\n";
 }
 function formatPlaybookSkillsTags(result) {
@@ -2544,7 +2564,7 @@ function formatPlaybookSkillFile(file) {
 import * as fs from "fs";
 import * as os2 from "os";
 import * as fsPromises2 from "fs/promises";
-var CLI_VERSION = true ? "0.7.0-beta.0" : "dev";
+var CLI_VERSION = true ? "0.8.0" : "dev";
 function isVersionOlderThan(a, b) {
   const parse = (v) => {
     if (!v) return null;
@@ -2572,11 +2592,13 @@ Commands:
   run         Execute code in the Alva runtime
   deploy      Cronjob management (create, list, get, update, delete, pause, resume, runs, run-logs)
   release     Feed and playbook releases (feed, playbook-draft, playbook)
+  feed        Feed lifecycle management (delete)
   secrets     Secret management (create, list, get, update, delete)
   sdk         SDK documentation (doc, partitions, partition-summary)
   skillhub    Playbook skills (list, tags, get, file)
   data-skills Data-skill documentation from the Arrays backend (list, summary, endpoint)
   comments    Playbook comments (create, pin, unpin)
+  notification-history  Notification delivery history (list-playbook, list-feed)
   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
@@ -2849,6 +2871,24 @@ Build-time verify (fire once, then poll until your run completes):
   STATUS=$(echo "$ROW" | jq -r .status)
   [ "$STATUS" = completed ] || alva deploy run-logs --id 42 \\
                                   --run-id "$(echo "$ROW" | jq -r .id)"`,
+  feed: `Usage: alva feed <subcommand> [options]
+
+Feed lifecycle management. Currently exposes a single subcommand:
+
+Subcommands:
+  delete    Soft-delete a feed and all its active majors
+
+Delete flags:
+  --id <feed_id>   Numeric feed id (required, positive integer)
+
+Notes:
+  - Cascades to all active feed_majors in the same DB transaction.
+  - Producer cronjobs are removed best-effort; the cronjob scavenger
+    reconciles any leftover rows on its next sweep.
+  - Auth: caller must own the feed (uid match), enforced by the backend.
+
+Examples:
+  alva feed delete --id 42`,
   release: `Usage: alva release <subcommand> [options]
 
 Publish feeds and playbooks to the Alva platform. The typical workflow:
@@ -2878,8 +2918,12 @@ Playbook-draft flags:
   --feeds <json>             JSON array of {feed_id, feed_major?} (required)
   --description <text>       Playbook description
   --trading-symbols <json>   JSON array of tickers, e.g. '["BTC","ETH"]' (max 50)
-  --template-id <id>         Source-template reference "username/name", e.g.
-                             "alva/screener". Persisted set-once on first draft.
+  --skill-id <id>            Source-skill reference "username/name", e.g.
+                             "alva/screener". Discover skills via
+                             "alva skillhub list". Persisted set-once on first draft.
+  --tags <json>              JSON array of discovery tags, e.g. '["btc","macro"]'
+                             (max 10, each up to 32 chars). First draft merges
+                             with skill tags; re-draft replaces the tag set.
 
 Playbook flags:
   --name <name>          Playbook name, must already exist as draft (required)
@@ -2902,7 +2946,8 @@ Examples:
   alva release feed --name btc-ema --version 1.0.0 --cronjob-id 42
   alva release feed --name nvda-insiders --version 1.0.0 --cronjob-id 43 --description "NVDA insider trading activity"
   alva release playbook-draft --name btc-dashboard --display-name "BTC Trend Dashboard" --feeds '[{"feed_id":100}]' --trading-symbols '["BTC"]'
-  alva release playbook-draft --name btc-dashboard --display-name "BTC Trend Dashboard" --feeds '[{"feed_id":100}]' --template-id alva/screener
+  alva release playbook-draft --name btc-dashboard --display-name "BTC Trend Dashboard" --feeds '[{"feed_id":100}]' --skill-id alva/screener
+  alva release playbook-draft --name btc-dashboard --display-name "BTC Trend Dashboard" --feeds '[{"feed_id":100}]' --tags '["btc","macro"]'
   alva release playbook --name btc-dashboard --version v1.0.0 --feeds '[{"feed_id":100}]' --changelog "Initial release" --readme-url "/alva/home/<username>/playbooks/btc-dashboard/README.md"`,
   secrets: `Usage: alva secrets <subcommand> [options]
 
@@ -2958,7 +3003,7 @@ Key partitions:
 Examples:
   alva sdk partitions
   alva sdk partition-summary --partition feed_widgets
-  alva sdk doc --name "@arrays/data/widget-scrap/twitter:v1.0.0"
+  alva sdk doc --name "@arrays/data/widget-scrap/news:v1.0.0"
   alva sdk doc --name "@arrays/data/search/search-grok-x:v1.0.0"`,
   "data-skills": `Usage: alva data-skills <subcommand> [args]
 
@@ -3038,12 +3083,33 @@ Examples:
   alva comments create --username alice --name btc-dashboard --content "Thanks!" --parent-id 5
   alva comments pin --comment-id 12
   alva comments unpin --comment-id 12`,
+  "notification-history": `Usage: alva notification-history <subcommand> [options]
+
+Read the caller's delivered notification history scoped to a playbook or feed.
+This is an audit/history surface, not a subscription toggle.
+
+Subcommands:
+  list-playbook      List notification history for a playbook
+  list-feed          List notification history for a feed
+
+Common flags:
+  --username <user>  Owner's username (required)
+  --name <name>      URL-safe playbook or feed name (required)
+  --channel <name>   Optional delivery channel filter (telegram, web, ...)
+  --status <status>  Optional status filter (sent, failed, filtered)
+  --since <seconds>  Optional Unix seconds lower bound
+  --first <n>        Optional page size (default 50, max 200 server-side)
+  --cursor <token>   Optional cursor from the previous page
+
+Examples:
+  alva notification-history list-playbook --username alice --name btc-dashboard --first 5
+  alva notification-history list-feed --username alice --name btc-ema --status sent`,
   "push-subscriptions": `Usage: alva push-subscriptions <subcommand> [options]
 
 Personal opt-in for DM/web push notifications. Independent of social
 follow: subscribing does not start following, unsubscribing does not
-unfollow. Following a playbook elsewhere will compound-subscribe
-automatically.
+unfollow. Following a playbook elsewhere does not create or revive a
+push subscription.
 
 Subcommands:
   subscribe-playbook     Opt into push for a playbook (any of its feeds)
@@ -3057,13 +3123,14 @@ Subscribe/unsubscribe flags (playbook + feed):
   --name <name>          URL-safe playbook or feed name (required)
 
 List flags:
-  --include-history      Also return rows previously unsubscribed (default: false)
+  --first <n>            Optional page size
+  --cursor <token>       Optional cursor from the previous page
 
 Examples:
   alva push-subscriptions subscribe-playbook --username alice --name btc-dashboard
   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`,
+  alva push-subscriptions list --first 20`,
   channel: `Usage: alva channel group-subscriptions <subcommand> [options]
 
 Manage push notifications delivered into the external group chat attached
@@ -3544,6 +3611,21 @@ async function dispatch(client, args, meta) {
           );
       }
     }
+    case "feed": {
+      if (!subcommand)
+        throw new CliUsageError("Missing subcommand for feed", "feed");
+      switch (subcommand) {
+        case "delete":
+          return client.feed.delete({
+            id: requireNumericFlag(flags, "id", "feed delete")
+          });
+        default:
+          throw new CliUsageError(
+            `Unknown subcommand: feed ${subcommand}`,
+            "feed"
+          );
+      }
+    }
     case "release": {
       if (!subcommand)
         throw new CliUsageError("Missing subcommand for release", "release");
@@ -3570,7 +3652,8 @@ async function dispatch(client, args, meta) {
               requireFlag(flags, "feeds", "release playbook-draft")
             ),
             trading_symbols: flags["trading-symbols"] ? jsonParse(flags["trading-symbols"]) : void 0,
-            template_id: flags["template-id"]
+            skill_id: flags["skill-id"],
+            tags: flags["tags"] ? jsonParse(flags["tags"]) : void 0
           });
         case "playbook":
           return client.release.playbook({
@@ -3771,6 +3854,37 @@ async function dispatch(client, args, meta) {
           );
       }
     }
+    case "notification-history": {
+      if (!subcommand)
+        throw new CliUsageError(
+          "Missing subcommand for notification-history",
+          "notification-history"
+        );
+      const params = {
+        username: requireFlag(
+          flags,
+          "username",
+          `notification-history ${subcommand}`
+        ),
+        name: requireFlag(flags, "name", `notification-history ${subcommand}`),
+        channel: flags["channel"],
+        status: flags["status"],
+        since_time: num(flags["since"]),
+        first: num(flags["first"]),
+        cursor: flags["cursor"]
+      };
+      switch (subcommand) {
+        case "list-playbook":
+          return client.notifications.listPlaybook(params);
+        case "list-feed":
+          return client.notifications.listFeed(params);
+        default:
+          throw new CliUsageError(
+            `Unknown subcommand: notification-history ${subcommand}`,
+            "notification-history"
+          );
+      }
+    }
     case "push-subscriptions": {
       if (!subcommand)
         throw new CliUsageError(
@@ -3832,7 +3946,8 @@ async function dispatch(client, args, meta) {
           });
         case "list":
           return client.pushSubscriptions.list({
-            include_history: flags["include-history"] !== void 0
+            first: num(flags["first"]),
+            cursor: flags["cursor"]
           });
         default:
           throw new CliUsageError(