@treeseed/cli 0.8.7 → 0.8.8

package/dist/cli/handlers/capacity.d.ts

@@ -0,0 +1,2 @@
+import type { TreeseedCommandHandler } from '../types.js';
+export declare const handleCapacity: TreeseedCommandHandler;

package/dist/cli/handlers/capacity.js

@@ -0,0 +1,145 @@
+import { guidedResult } from "./utils.js";
+import { createMarketClientForInvocation } from "./market-utils.js";
+function required(value, message) {
+  if (typeof value === "string" && value.trim()) return value.trim();
+  throw new Error(message);
+}
+const handleCapacity = async (invocation, context) => {
+  const action = invocation.positionals[0] ?? "status";
+  const { profile, client } = createMarketClientForInvocation(invocation, context, { requireAuth: true });
+  const teamId = typeof invocation.args.team === "string" ? invocation.args.team : typeof profile.teamId === "string" ? profile.teamId : null;
+  if (action === "status") {
+    const team = required(teamId, "Usage: treeseed capacity status --team <team-id>");
+    const response = await client.teamCapacity(team);
+    const summary = response.payload.summary;
+    return guidedResult({
+      command: "capacity",
+      summary: "Team helper capacity status",
+      facts: [
+        { label: "Market", value: profile.id },
+        { label: "Team", value: team },
+        { label: "Monthly remaining", value: summary?.monthlyRemainingCredits },
+        { label: "Daily remaining", value: summary?.dailyRemainingCredits },
+        { label: "Active providers", value: summary?.activeProviderCount }
+      ],
+      report: { marketId: profile.id, teamId: team, capacity: response.payload }
+    });
+  }
+  if (action === "providers") {
+    const subcommand = invocation.positionals[1] ?? "list";
+    const team = required(teamId, "Usage: treeseed capacity providers list --team <team-id>");
+    if (subcommand === "list") {
+      const response = await client.teamCapacity(team);
+      const providers = response.payload.providers ?? [];
+      return guidedResult({
+        command: "capacity",
+        summary: `Found ${providers.length} helper capacity provider${providers.length === 1 ? "" : "s"}.`,
+        sections: [{
+          title: "Providers",
+          lines: providers.map((provider) => `${provider.id}  ${provider.name}  ${provider.status}  workers=${provider.maxConcurrentWorkers ?? 0}`)
+        }],
+        report: { marketId: profile.id, teamId: team, providers }
+      });
+    }
+    if (subcommand === "connect") {
+      const response = await client.launchManagedCapacityProvider(team, { launchSource: "cli" });
+      return guidedResult({
+        command: "capacity",
+        summary: "TreeSeed-managed helper capacity is connected.",
+        facts: [
+          { label: "Provider", value: response.payload.provider?.id },
+          { label: "Security code prefix", value: response.payload.apiKey?.keyPrefix }
+        ],
+        report: { marketId: profile.id, teamId: team, result: response.payload }
+      });
+    }
+    if (subcommand === "keys") {
+      const keyAction = invocation.positionals[2] ?? "reset";
+      const providerId = required(invocation.args.provider, "Usage: treeseed capacity providers keys reset --provider <provider-id>");
+      if (keyAction === "reset") {
+        const response = await client.resetCapacityProviderApiKey(providerId, { name: "Provider security code" });
+        return guidedResult({
+          command: "capacity",
+          summary: "Provider security code was reset.",
+          facts: [
+            { label: "Provider", value: providerId },
+            { label: "Prefix", value: response.payload.key?.keyPrefix },
+            { label: "Security access code", value: response.payload.plaintextKey }
+          ],
+          report: { marketId: profile.id, providerId, result: response.payload }
+        });
+      }
+      if (keyAction === "revoke") {
+        const keyId = required(invocation.args.key, "Usage: treeseed capacity providers keys revoke --provider <provider-id> --key <key-id>");
+        const response = await client.revokeCapacityProviderApiKey(providerId, keyId);
+        return guidedResult({
+          command: "capacity",
+          summary: "Provider security code was revoked.",
+          facts: [
+            { label: "Provider", value: providerId },
+            { label: "Key", value: keyId }
+          ],
+          report: { marketId: profile.id, providerId, keyId, result: response.payload }
+        });
+      }
+    }
+    return { exitCode: 1, stderr: [`Unknown capacity providers action: ${subcommand}`] };
+  }
+  if (action === "grants") {
+    const subcommand = invocation.positionals[1] ?? "list";
+    const team = required(teamId, "Usage: treeseed capacity grants list --team <team-id>");
+    if (subcommand === "list") {
+      const response = await client.capacityGrants(team);
+      return guidedResult({
+        command: "capacity",
+        summary: `Found ${response.payload.length} capacity grant${response.payload.length === 1 ? "" : "s"}.`,
+        sections: [{
+          title: "Grants",
+          lines: response.payload.map((grant) => `${grant.id}  ${grant.grantScope}  daily=${grant.dailyCreditLimit ?? "policy"}  monthly=${grant.monthlyCreditLimit ?? "policy"}`)
+        }],
+        report: { marketId: profile.id, teamId: team, grants: response.payload }
+      });
+    }
+    if (subcommand === "create") {
+      const providerId = required(invocation.args.provider, "Usage: treeseed capacity grants create --team <team-id> --provider <provider-id>");
+      const response = await client.createCapacityGrant(team, {
+        capacityProviderId: providerId,
+        projectId: typeof invocation.args.project === "string" ? invocation.args.project : null,
+        environment: typeof invocation.args.environment === "string" ? invocation.args.environment : null,
+        dailyCreditLimit: Number(invocation.args.daily ?? 25),
+        monthlyCreditLimit: Number(invocation.args.monthly ?? 500),
+        overflowPolicy: typeof invocation.args.overflow === "string" ? invocation.args.overflow : "approval_required"
+      });
+      return guidedResult({
+        command: "capacity",
+        summary: "Capacity grant created.",
+        facts: [
+          { label: "Grant", value: response.payload.id },
+          { label: "Provider", value: providerId }
+        ],
+        report: { marketId: profile.id, teamId: team, grant: response.payload }
+      });
+    }
+    return { exitCode: 1, stderr: [`Unknown capacity grants action: ${subcommand}`] };
+  }
+  if (action === "enqueue") {
+    const projectId = required(invocation.args.project, "Usage: treeseed capacity enqueue --project <project-id> --task-kind <kind>");
+    const response = await client.enqueueAgentTask(projectId, {
+      taskKind: typeof invocation.args.taskKind === "string" ? invocation.args.taskKind : typeof invocation.args.task === "string" ? invocation.args.task : "proposal.draft",
+      environment: typeof invocation.args.environment === "string" ? invocation.args.environment : "staging"
+    });
+    return guidedResult({
+      command: "capacity",
+      summary: "Budgeted agent task enqueued.",
+      facts: [
+        { label: "Task", value: response.payload.task?.id },
+        { label: "Reserved credits", value: response.payload.reservation?.reservedCredits }
+      ],
+      report: { marketId: profile.id, projectId, result: response.payload }
+    });
+  }
+  return { exitCode: 1, stderr: [`Unknown capacity action: ${action}`] };
+};
+export {
+  handleCapacity
+};

package/dist/cli/operations-registry.js

@@ -1460,6 +1460,47 @@ const CLI_ONLY_OPERATION_SPECS = [
     executionMode: "handler",
     handlerName: "projects"
   },
+  {
+    id: "market.capacity",
+    name: "capacity",
+    aliases: [],
+    group: "Utilities",
+    summary: "Manage team helper capacity from the selected market.",
+    description: "Inspect team helper credits, connect managed providers, rotate provider security codes, manage grants, and enqueue budgeted agent tasks.",
+    provider: "default",
+    related: ["teams", "projects", "agents"],
+    usage: "treeseed capacity [status|providers|grants|enqueue]",
+    arguments: [{ name: "action", description: "Capacity action.", required: false }],
+    options: [
+      { name: "market", flags: "--market <id-or-url>", description: "Select a configured market id or direct market API URL.", kind: "string" },
+      { name: "team", flags: "--team <team-id>", description: "Team id for capacity status and grants.", kind: "string" },
+      { name: "provider", flags: "--provider <provider-id>", description: "Capacity provider id for grant or key actions.", kind: "string" },
+      { name: "project", flags: "--project <project-id>", description: "Project id for grant allocation or agent enqueue.", kind: "string" },
+      { name: "key", flags: "--key <key-id>", description: "Provider security code id to revoke.", kind: "string" },
+      { name: "taskKind", flags: "--task-kind <kind>", description: "Agent task signature for budgeted enqueue.", kind: "string" },
+      { name: "environment", flags: "--environment <environment>", description: "Project environment for grants or enqueue.", kind: "enum", values: ["local", "staging", "prod"] },
+      { name: "daily", flags: "--daily <credits>", description: "Daily credit limit for a created grant.", kind: "string" },
+      { name: "monthly", flags: "--monthly <credits>", description: "Monthly credit limit for a created grant.", kind: "string" },
+      { name: "json", flags: "--json", description: "Emit machine-readable JSON instead of human-readable text.", kind: "boolean" }
+    ],
+    examples: [
+      "treeseed capacity status --team team_123",
+      "treeseed capacity providers connect --team team_123",
+      "treeseed capacity providers keys reset --provider provider_123",
+      "treeseed capacity grants create --team team_123 --provider provider_123 --daily 25",
+      "treeseed capacity enqueue --project project_123 --task-kind proposal.draft"
+    ],
+    help: {
+      longSummary: ["Capacity talks to the market control plane so technical stewards can inspect helper credits, provider security codes, and budgeted agent task routing without opening the browser."],
+      whenToUse: ["Use this after connecting to a market when provider health, budget allocation, or budgeted agent enqueue needs to be checked from a terminal."],
+      beforeYouRun: ["Authenticate to the selected market and know the team, project, or provider id for the action you are taking."],
+      automationNotes: ["Use `--json` when capturing provider keys, grant ids, task ids, or dashboard summaries in automation."]
+    },
+    helpVisible: true,
+    helpFeatured: false,
+    executionMode: "handler",
+    handlerName: "capacity"
+  },
   {
     id: "market.packs",
     name: "packs",

package/dist/cli/registry.d.ts

@@ -28,6 +28,7 @@ export declare const COMMAND_HANDLERS: {
     readonly market: import("./operations-types.js").TreeseedCommandHandler;
     readonly teams: import("./operations-types.js").TreeseedCommandHandler;
     readonly projects: import("./operations-types.js").TreeseedCommandHandler;
+    readonly capacity: import("./operations-types.js").TreeseedCommandHandler;
     readonly packs: import("./operations-types.js").TreeseedCommandHandler;
     readonly gh: import("./operations-types.js").TreeseedCommandHandler;
     readonly railway: import("./operations-types.js").TreeseedCommandHandler;

package/dist/cli/registry.js

@@ -22,6 +22,7 @@ import { handleAuthWhoAmI } from "./handlers/auth-whoami.js";
 import { handleMarket } from "./handlers/market.js";
 import { handleTeams } from "./handlers/teams.js";
 import { handleProjects } from "./handlers/projects.js";
+import { handleCapacity } from "./handlers/capacity.js";
 import { handlePacks } from "./handlers/packs.js";
 import { handleToolWrapper } from "./handlers/tool-wrapper.js";
 import {
@@ -73,6 +74,7 @@ const COMMAND_HANDLERS = {
   market: handleMarket,
   teams: handleTeams,
   projects: handleProjects,
+  capacity: handleCapacity,
   packs: handlePacks,
   gh: handleToolWrapper,
   railway: handleToolWrapper,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@treeseed/cli",
-  "version": "0.8.7",
+  "version": "0.8.8",
   "description": "Operator-facing Treeseed CLI package.",
   "license": "AGPL-3.0-only",
   "repository": {
@@ -45,7 +45,7 @@
     "release:publish": "node ./scripts/run-ts.mjs ./scripts/publish-package.ts"
   },
   "dependencies": {
-    "@treeseed/sdk": "0.8.7",
+    "@treeseed/sdk": "0.8.8",
     "ink": "^7.0.0",
     "react": "^19.2.5"
   },