@2kw/ai 6.3.0-dev.105 → 6.3.0-dev.111

package/dist/commands/installations.js

@@ -1,7 +1,22 @@
 import { Command } from "commander";
 import { getClient, runAction } from "../lib/client.js";
+import { CliUsageError } from "../lib/errors.js";
 import { formatPage, formatDetail, formatList, formatSuccess } from "../lib/output.js";
 import { addPaginationOptions, paginationParams } from "../lib/pagination.js";
+const MIN_MONTHLY_PERCENT = 0;
+const MAX_MONTHLY_PERCENT = 1000;
+/**
+ * Validated inside the action rather than as commander's argument parser, so the refusal
+ * travels through `runAction` and exits 2 like every other usage error (see `parsePort` in
+ * connectors.ts).
+ */
+function parseMonthlyPercent(value) {
+    const percent = /^\d+$/.test(value) ? Number(value) : NaN;
+    if (!Number.isInteger(percent) || percent < MIN_MONTHLY_PERCENT || percent > MAX_MONTHLY_PERCENT) {
+        throw new CliUsageError(`percent must be a whole number between ${MIN_MONTHLY_PERCENT} and ${MAX_MONTHLY_PERCENT}, not '${value}'`);
+    }
+    return percent;
+}
 export function makeInstallationsCommand() {
     const cmd = new Command("installations").description("Manage surface installations");
     const list = new Command("list").description("List installations");
@@ -172,6 +187,36 @@ export function makeInstallationsCommand() {
         });
     });
     cmd.addCommand(keys);
+    const budget = new Command("budget").description("Manage an installation's monthly budget: a share of the organisation's pool");
+    budget
+        .command("get")
+        .description("Read an installation's current budget: percent, period, and usage")
+        .argument("<id>", "Installation ID")
+        .action(async (id, _opts, command) => {
+        await runAction(command, async () => {
+            const client = getClient(command);
+            const { data } = await client.GET("/v1/installations/{id}/budget", {
+                params: { path: { id } },
+            });
+            formatDetail(data, command);
+        });
+    });
+    budget
+        .command("set")
+        .description("Set or change an installation's monthly budget share, 0-1000 percent")
+        .argument("<id>", "Installation ID")
+        .argument("<percent>", "Monthly percent of the organisation's pool, 0-1000")
+        .action(async (id, percent, _opts, command) => {
+        await runAction(command, async () => {
+            const client = getClient(command);
+            const { data } = await client.PUT("/v1/installations/{id}/budget", {
+                params: { path: { id } },
+                body: { monthlyPercent: parseMonthlyPercent(percent) },
+            });
+            formatDetail(data, command);
+        });
+    });
+    cmd.addCommand(budget);
     return cmd;
 }
 //# sourceMappingURL=installations.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@2kw/ai",
-  "version": "6.3.0-dev.105",
+  "version": "6.3.0-dev.111",
   "description": "CLI for 2kw.ai — schema-driven document extraction, an OpenAI-compatible EU LLM gateway, transcription, prompts, datasets, and experiments from your terminal or agentic workflows. Ships as 2kw, backbone, and bb.",
   "keywords": [
     "cli",