@alva-ai/toolkit 0.1.2 → 0.1.4

package/dist/cli.js

@@ -228,7 +228,8 @@ var ReleaseResource = class {
         display_name: params.display_name,
         description: params.description,
         feeds: params.feeds,
-        trading_symbols: params.trading_symbols
+        trading_symbols: params.trading_symbols,
+        changelog: params.changelog
       }
     });
   }
@@ -390,10 +391,88 @@ var UserResource = class {
   }
 };
 
+// src/resources/trading.ts
+var TradingResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  async accounts() {
+    this.client._requireAuth();
+    return this.client._request("GET", "/api/v1/trading/accounts");
+  }
+  async portfolio(accountId) {
+    this.client._requireAuth();
+    return this.client._request("GET", "/api/v1/trading/portfolio", {
+      query: { accountId }
+    });
+  }
+  async orders(params) {
+    this.client._requireAuth();
+    return this.client._request("GET", "/api/v1/trading/orders", {
+      query: {
+        accountId: params.accountId,
+        source: params.source,
+        since: params.since,
+        limit: params.limit
+      }
+    });
+  }
+  async subscriptions(accountId) {
+    this.client._requireAuth();
+    return this.client._request("GET", "/api/v1/trading/subscriptions", {
+      query: { accountId }
+    });
+  }
+  async equityHistory(params) {
+    this.client._requireAuth();
+    return this.client._request("GET", "/api/v1/trading/equity-history", {
+      query: {
+        accountId: params.accountId,
+        timeframe: params.timeframe,
+        sinceMs: params.sinceMs,
+        untilMs: params.untilMs
+      }
+    });
+  }
+  async riskRules() {
+    this.client._requireAuth();
+    return this.client._request(
+      "GET",
+      "/api/v1/trading/risk-rules"
+    );
+  }
+  async subscribe(params) {
+    this.client._requireAuth();
+    return this.client._request("POST", "/api/v1/trading/subscribe", {
+      body: params
+    });
+  }
+  async unsubscribe(subscriptionId) {
+    this.client._requireAuth();
+    return this.client._request("POST", "/api/v1/trading/unsubscribe", {
+      body: { subscriptionId }
+    });
+  }
+  async execute(params) {
+    this.client._requireAuth();
+    return this.client._request("POST", "/api/v1/trading/execute", {
+      body: params
+    });
+  }
+  async updateRiskRules(rules) {
+    this.client._requireAuth();
+    return this.client._request("PUT", "/api/v1/trading/risk-rules", {
+      body: rules
+    });
+  }
+};
+
 // src/client.ts
 var DEFAULT_BASE_URL = "https://api-llm.prd.alva.ai";
 var AlvaClient = class {
   baseUrl;
+  token;
   apiKey;
   _fs;
   _run;
@@ -405,8 +484,10 @@ var AlvaClient = class {
   _remix;
   _screenshot;
   _user;
+  _trading;
   constructor(config) {
     this.baseUrl = config.baseUrl ?? DEFAULT_BASE_URL;
+    this.token = config.token;
     this.apiKey = config.apiKey;
   }
   get fs() {
@@ -439,11 +520,14 @@ var AlvaClient = class {
   get user() {
     return this._user ??= new UserResource(this);
   }
+  get trading() {
+    return this._trading ??= new TradingResource(this);
+  }
   _requireAuth() {
-    if (!this.apiKey) {
+    if (!this.token && !this.apiKey) {
       throw new AlvaError(
         "UNAUTHENTICATED",
-        "API key is required for this operation. Pass apiKey in the constructor.",
+        "Authentication is required. Pass token or apiKey in the constructor.",
         401
       );
     }
@@ -463,7 +547,9 @@ var AlvaClient = class {
       }
     }
     const headers = {};
-    if (this.apiKey) {
+    if (this.token) {
+      headers.Authorization = `${this.token}`;
+    } else if (this.apiKey) {
       headers["X-Alva-Api-Key"] = this.apiKey;
     }
     let fetchBody;
@@ -628,6 +714,24 @@ function loadConfig(deps) {
 import * as fs from "fs";
 import * as os from "os";
 import * as fsPromises from "fs/promises";
+var CLI_VERSION = true ? "0.1.4" : "dev";
+function isVersionOlderThan(a, b) {
+  const parse = (v) => {
+    if (!v) return null;
+    const parts = v.split(".").map(Number);
+    if (parts.some(isNaN)) return null;
+    while (parts.length < 3) parts.push(0);
+    return parts;
+  };
+  const pa = parse(a);
+  const pb = parse(b);
+  if (!pa || !pb) return false;
+  for (let i = 0; i < 3; i++) {
+    if (pa[i] < pb[i]) return true;
+    if (pa[i] > pb[i]) return false;
+  }
+  return false;
+}
 var HELP_TEXT = `Usage: alva <command> [options]
 
 Commands:
@@ -642,12 +746,14 @@ Commands:
   sdk         SDK documentation (doc, partitions, partition-summary)
   comments    Playbook comments (create, pin, unpin)
   remix       Save playbook remix lineage
+  trading     Trading operations (accounts, portfolio, orders, subscriptions, equity-history, risk-rules, subscribe, unsubscribe, execute, update-risk-rules)
   screenshot  Capture a web screenshot as PNG
 
 Global options:
   --api-key <key>      API key (overrides env and config file)
   --base-url <url>     API base URL (overrides env and config file)
   --profile <name>     Named profile to use (default: "default")
+  -v, --version        Show CLI version
   --help               Show help (use 'alva <command> --help' for command details)
 
 Config resolution: --api-key flag > ALVA_API_KEY env > profile in ~/.config/alva/config.json
@@ -727,7 +833,8 @@ Common flags:
   --path <path>          File or directory path (required for most subcommands)
   --recursive            Enable recursive operation (readdir, remove)
   --no-recursive         Disable recursive operation
-  --mkdir-parents        Create parent directories on write
+  --mkdir-parents        Create parent directories on write (default for write)
+  --no-mkdir-parents     Disable automatic parent directory creation on write
 
 Path conventions:
   ~/...                  Home-relative path (expands to /alva/home/<username>/...)
@@ -876,6 +983,7 @@ Playbook-draft flags:
   --name <name>              URL-safe playbook name, unique per user (required)
   --display-name <name>      Human-readable title, max 40 chars (required)
   --feeds <json>             JSON array of {feed_id, feed_major?} (required)
+  --changelog <text>         Release changelog (required)
   --description <text>       Playbook description
   --trading-symbols <json>   JSON array of tickers, e.g. '["BTC","ETH"]' (max 50)
 
@@ -894,7 +1002,7 @@ Display name conventions:
 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}]' --changelog "Initial release" --trading-symbols '["BTC"]'
   alva release playbook --name btc-dashboard --version v1.0.0 --feeds '[{"feed_id":100}]' --changelog "Initial release"`,
   secrets: `Usage: alva secrets <subcommand> [options]
 
@@ -1010,7 +1118,73 @@ Optional:
 
 Examples:
   alva screenshot --url /playbook/alice/btc-dashboard --out dashboard.png
-  alva screenshot --url /playbook/alice/btc-dashboard --out chart.png --selector ".chart-container"`
+  alva screenshot --url /playbook/alice/btc-dashboard --out chart.png --selector ".chart-container"`,
+  trading: `Usage: alva trading <subcommand> [options]
+
+Manage trading accounts, portfolios, orders, subscriptions, and risk rules.
+
+Subcommands:
+  accounts             List all trading accounts
+  portfolio            Get portfolio for an account
+  orders               List orders for an account
+  subscriptions        List subscriptions for an account
+  equity-history       Get equity history for an account
+  risk-rules           Show risk rules
+  subscribe            Subscribe an account to a source feed
+  unsubscribe          Unsubscribe by subscription ID
+  execute              Execute a signal on an account
+  update-risk-rules    Update risk rules
+
+Portfolio/Orders/Subscriptions/Equity-history flags:
+  --account-id <id>    Trading account ID (required)
+
+Orders optional flags:
+  --limit <n>          Max results
+  --source <source>    Filter by source
+  --since <timestamp>  Filter orders since timestamp
+
+Equity-history optional flags:
+  --timeframe <tf>     Timeframe (e.g. "1d", "1h")
+  --since-ms <ms>      Start timestamp in ms
+  --until-ms <ms>      End timestamp in ms
+
+Subscribe flags:
+  --account-id <id>            Account ID (required)
+  --source-username <user>     Source username (required)
+  --source-feed <feed>         Source feed (required)
+  --playbook-id <id>           Playbook ID (required)
+  --playbook-version <ver>     Playbook version (required)
+  --execute-latest             Execute latest signal on subscribe
+
+Unsubscribe flags:
+  --subscription-id <id>       Subscription ID (required)
+
+Execute flags:
+  --account-id <id>            Account ID (required)
+  --signal <json>              Signal JSON (required)
+  --dry-run                    Dry run mode
+  --source-username <user>     Source username (optional)
+  --source-feed <feed>         Source feed (optional)
+
+Update-risk-rules flags:
+  --max-single-order-value <n>       Max single order value (required)
+  --max-single-order-enabled <bool>  Max single order enabled (required)
+  --max-daily-turnover-value <n>     Max daily turnover value (required)
+  --max-daily-turnover-enabled <bool> Max daily turnover enabled (required)
+  --max-daily-orders-value <n>       Max daily orders value (required)
+  --max-daily-orders-enabled <bool>  Max daily orders enabled (required)
+
+Examples:
+  alva trading accounts
+  alva trading portfolio --account-id acc_123
+  alva trading orders --account-id acc_123 --limit 10
+  alva trading subscriptions --account-id acc_123
+  alva trading equity-history --account-id acc_123 --timeframe 1d
+  alva trading risk-rules
+  alva trading subscribe --account-id acc_123 --source-username alice --source-feed btc-signals --playbook-id pb_1 --playbook-version v1.0.0
+  alva trading unsubscribe --subscription-id sub_456
+  alva trading execute --account-id acc_123 --signal '{"symbol":"BTC","side":"buy","qty":0.1}' --dry-run
+  alva trading update-risk-rules --max-single-order-value 10000 --max-single-order-enabled true --max-daily-turnover-value 50000 --max-daily-turnover-enabled true --max-daily-orders-value 100 --max-daily-orders-enabled true`
 };
 async function handleConfigure(args, deps) {
   const flags = parseFlags(args.slice(1));
@@ -1048,7 +1222,9 @@ var BOOLEAN_FLAGS = /* @__PURE__ */ new Set([
   "recursive",
   "mkdir-parents",
   "push-notify",
-  "help"
+  "help",
+  "execute-latest",
+  "dry-run"
 ]);
 function parseFlags(argv) {
   const flags = {};
@@ -1115,13 +1291,20 @@ async function dispatch(client, args, meta) {
   }
   if (group === "whoami") {
     const user = await client.user.me();
-    return {
-      ...user,
+    const record = user;
+    const version = meta?.cliVersion ?? CLI_VERSION;
+    const result = {
+      ...record,
       _meta: {
         profile: meta?.profile ?? "default",
         endpoint: meta?.baseUrl ?? client.baseUrl
       }
     };
+    const minVersion = record.toolkit_min_version;
+    if (typeof minVersion === "string" && version && version !== "dev" && isVersionOlderThan(version, minVersion)) {
+      result._warning = `Warning: your toolkit version (${version}) is older than the minimum recommended version (${minVersion}). Please upgrade: npm install -g @alva-ai/toolkit`;
+    }
+    return result;
   }
   const subcommand = args[1];
   const flags = parseFlags(
@@ -1153,13 +1336,13 @@ async function dispatch(client, args, meta) {
             return client.fs.rawWrite({
               path: requireFlag(flags, "path", "fs write"),
               body: fileData,
-              mkdir_parents: boolFlag(flags["mkdir-parents"])
+              mkdir_parents: boolFlag(flags["mkdir-parents"]) ?? true
             });
           }
           return client.fs.write({
             path: requireFlag(flags, "path", "fs write"),
             data: requireFlag(flags, "data", "fs write"),
-            mkdir_parents: boolFlag(flags["mkdir-parents"])
+            mkdir_parents: boolFlag(flags["mkdir-parents"]) ?? true
           });
         case "stat":
           return client.fs.stat({
@@ -1293,7 +1476,12 @@ async function dispatch(client, args, meta) {
             feeds: jsonParse(
               requireFlag(flags, "feeds", "release playbook-draft")
             ),
-            trading_symbols: flags["trading-symbols"] ? jsonParse(flags["trading-symbols"]) : void 0
+            trading_symbols: flags["trading-symbols"] ? jsonParse(flags["trading-symbols"]) : void 0,
+            changelog: requireFlag(
+              flags,
+              "changelog",
+              "release playbook-draft"
+            )
           });
         case "playbook":
           return client.release.playbook({
@@ -1397,6 +1585,111 @@ async function dispatch(client, args, meta) {
       fs.writeFileSync(outFile, buf);
       return { written: outFile, bytes: buf.length };
     }
+    case "trading": {
+      if (!subcommand) throw new Error("Missing subcommand for trading");
+      switch (subcommand) {
+        case "accounts":
+          return client.trading.accounts();
+        case "portfolio":
+          return client.trading.portfolio(
+            requireFlag(flags, "account-id", "trading portfolio")
+          );
+        case "orders":
+          return client.trading.orders({
+            accountId: requireFlag(flags, "account-id", "trading orders"),
+            source: flags["source"],
+            since: num(flags["since"]),
+            limit: num(flags["limit"])
+          });
+        case "subscriptions":
+          return client.trading.subscriptions(
+            requireFlag(flags, "account-id", "trading subscriptions")
+          );
+        case "equity-history":
+          return client.trading.equityHistory({
+            accountId: requireFlag(
+              flags,
+              "account-id",
+              "trading equity-history"
+            ),
+            timeframe: flags["timeframe"],
+            sinceMs: num(flags["since-ms"]),
+            untilMs: num(flags["until-ms"])
+          });
+        case "risk-rules":
+          return client.trading.riskRules();
+        case "subscribe":
+          return client.trading.subscribe({
+            accountId: requireFlag(flags, "account-id", "trading subscribe"),
+            sourceUsername: requireFlag(
+              flags,
+              "source-username",
+              "trading subscribe"
+            ),
+            sourceFeed: requireFlag(flags, "source-feed", "trading subscribe"),
+            playbookId: requireFlag(flags, "playbook-id", "trading subscribe"),
+            playbookVersion: requireFlag(
+              flags,
+              "playbook-version",
+              "trading subscribe"
+            ),
+            executeLatest: boolFlag(flags["execute-latest"])
+          });
+        case "unsubscribe":
+          return client.trading.unsubscribe(
+            requireFlag(flags, "subscription-id", "trading unsubscribe")
+          );
+        case "execute":
+          return client.trading.execute({
+            accountId: requireFlag(flags, "account-id", "trading execute"),
+            signalJson: requireFlag(flags, "signal", "trading execute"),
+            dryRun: boolFlag(flags["dry-run"]) ?? false,
+            sourceUsername: flags["source-username"],
+            sourceFeed: flags["source-feed"]
+          });
+        case "update-risk-rules":
+          return client.trading.updateRiskRules({
+            maxSingleOrder: {
+              value: requireNumericFlag(
+                flags,
+                "max-single-order-value",
+                "trading update-risk-rules"
+              ),
+              enabled: requireFlag(
+                flags,
+                "max-single-order-enabled",
+                "trading update-risk-rules"
+              ) === "true"
+            },
+            maxDailyTurnover: {
+              value: requireNumericFlag(
+                flags,
+                "max-daily-turnover-value",
+                "trading update-risk-rules"
+              ),
+              enabled: requireFlag(
+                flags,
+                "max-daily-turnover-enabled",
+                "trading update-risk-rules"
+              ) === "true"
+            },
+            maxDailyOrders: {
+              value: requireNumericFlag(
+                flags,
+                "max-daily-orders-value",
+                "trading update-risk-rules"
+              ),
+              enabled: requireFlag(
+                flags,
+                "max-daily-orders-enabled",
+                "trading update-risk-rules"
+              ) === "true"
+            }
+          });
+        default:
+          throw new Error(`Unknown subcommand: trading ${subcommand}`);
+      }
+    }
     default:
       throw new Error(
         `Unknown command: '${group}'. Run 'alva --help' to see available commands.`
@@ -1406,6 +1699,11 @@ async function dispatch(client, args, meta) {
 async function main() {
   try {
     const rawArgs = process.argv.slice(2);
+    if (rawArgs[0] === "-v" || rawArgs[0] === "--version") {
+      process.stdout.write(`alva version ${CLI_VERSION}
+`);
+      return;
+    }
     if (rawArgs[0] === "configure") {
       if (rawArgs[1] === "--help" || rawArgs[1] === "-h") {
         process.stdout.write(COMMAND_HELP["configure"] + "\n");
@@ -1439,8 +1737,15 @@ async function main() {
     }
     const result = await dispatch(client, cleanArgs, {
       profile: config.profile,
-      baseUrl: config.baseUrl
+      baseUrl: config.baseUrl,
+      cliVersion: CLI_VERSION
     });
+    if (result && typeof result === "object" && "_warning" in result) {
+      process.stderr.write(
+        result._warning + "\n"
+      );
+      delete result._warning;
+    }
     if (result && typeof result === "object" && "_help" in result) {
       const helpResult = result;
       process.stdout.write(helpResult.text + "\n");
@@ -1467,7 +1772,9 @@ if (isDirectRun) {
   main();
 }
 export {
+  CLI_VERSION,
   dispatch,
-  handleConfigure
+  handleConfigure,
+  isVersionOlderThan
 };
 //# sourceMappingURL=cli.js.map