@ocis/myagent-cli 0.2.5 → 0.2.6

package/README.md

@@ -229,7 +229,7 @@ terminal.
 
 ### Commands
 
-`/help` `/new` `/session [all]` (`/sessions`, `/resume` — aliases) `/plan` `/coding` `/cowork` `/mode` `/edit` `/thinking` `/model` `/compact`
+`/help` `/new` `/session [all]` (`/sessions`, `/resume` — aliases) `/plan` `/coding` `/cowork` `/mode` `/edit` `/thinking` `/model` `/balance` `/compact`
 `/stop` `/reload` `/export` `/config` `/quit`
 
 ## Sessions
@@ -291,8 +291,10 @@ Integrations page (`https://host/integrations/<id>`) — the integration id is d
 Create an integration + API key on the MyAgent **Integrations** page. Recommended settings
 for the CLI:
 
-- **Tools**: leave empty (all coding tools are supplied by the CLI) or enable `web_fetch` for
-  server-side fetching.
+- **Tools**: leave empty (all coding tools are supplied by the CLI) or enable the `web` group for
+  server-side fetching. Server tool groups are extras — the CLI's own tools are client-side.
+- **Skills**: enable the ones you need. The CLI's local tools satisfy their script needs
+  (`bash`/`read`/`write`), so no server tool group is required for them.
 - **Model**: any tool-capable model with a reasonable context window.
 
 The CLI and the server deploy in lockstep — every documented integration-API feature is

package/dist/protocol/client.d.ts

@@ -1,4 +1,4 @@
-import type { AguiEvent, AguiInputMessage, AguiRunRequest, AguiToolDef, IntegrationStatus, ModelInfo, RunStreamResult, SessionDetail, SessionSummary, WorkspaceEntry, WorkspaceFile, WorkspaceWriteResult } from "./types.js";
+import type { AguiEvent, AguiInputMessage, AguiRunRequest, AguiToolDef, BalanceInfo, IntegrationStatus, ModelInfo, RunStreamResult, SessionDetail, SessionSummary, WorkspaceEntry, WorkspaceFile, WorkspaceWriteResult } from "./types.js";
 export interface IntegrationClientOptions {
     baseUrl: string;
     integrationId: string;
@@ -73,6 +73,13 @@ export declare class IntegrationClient {
     getStatus(opts?: {
         signal?: AbortSignal;
     }): Promise<IntegrationStatus>;
+    /**
+     * The user's platform credit balance. Platform mode only — a standalone
+     * server answers 404 with code `platform_only`. Used by `/balance`.
+     */
+    getBalance(opts?: {
+        signal?: AbortSignal;
+    }): Promise<BalanceInfo>;
     /**
      * Models this integration accepts (default first, `default: true` marks it).
      * A forced-model integration returns exactly one entry — there is nothing to

package/dist/protocol/client.js

@@ -126,6 +126,13 @@ export class IntegrationClient {
     async getStatus(opts = {}) {
         return this.json(this.url(""), { method: "GET", signal: opts.signal });
     }
+    /**
+     * The user's platform credit balance. Platform mode only — a standalone
+     * server answers 404 with code `platform_only`. Used by `/balance`.
+     */
+    async getBalance(opts = {}) {
+        return this.json(this.url("/balance"), { method: "GET", signal: opts.signal });
+    }
     /**
      * Models this integration accepts (default first, `default: true` marks it).
      * A forced-model integration returns exactly one entry — there is nothing to

package/dist/protocol/types.d.ts

@@ -39,6 +39,10 @@ export interface IntegrationStatus {
     label: string;
     enabled: boolean;
 }
+/** Response of GET /balance (platform mode only). */
+export interface BalanceInfo {
+    balance: number;
+}
 /** One directory entry from GET /integrations/workspace. */
 export interface WorkspaceEntry {
     name: string;

package/dist/ui/app.js

@@ -8,6 +8,7 @@
 import { writeFile } from "node:fs/promises";
 import { basename, join, resolve } from "node:path";
 import { CombinedAutocompleteProvider, Box, Container, HStack, isViewportTUI, matchesKey, MouseRegion, ProcessTerminal, ScrollView, SelectList, Spacer, TuiAltScreen, VStack, visibleWidth, } from "@earendil-works/pi-tui";
+import { IntegrationApiError } from "../protocol/client.js";
 import { AgentRunner, usageFromSession } from "../agent/turn.js";
 import { MODES, nextMode, stripModeMarker } from "../agent/modes.js";
 import { createSystemPromptBuilder } from "../agent/prompt-builder.js";
@@ -484,6 +485,7 @@ export async function runTui(opts) {
         { name: "edit", description: "toggle auto/ask approval" },
         { name: "thinking", description: "set the thinking level" },
         { name: "model", description: "choose the model (new sessions)" },
+        { name: "balance", description: "show the credit balance" },
         { name: "compact", description: "compact the session history" },
         { name: "stop", description: "force-stop the running turn" },
         { name: "reload", description: "reload context files and skills" },
@@ -628,6 +630,9 @@ export async function runTui(opts) {
             case "model":
                 await showModelPicker();
                 break;
+            case "balance":
+                await showBalance();
+                break;
             case "compact":
                 if (!runner.threadId)
                     addTranscript(new NoticeComponent("No active session.", "warn"));
@@ -668,6 +673,23 @@ export async function runTui(opts) {
                 addTranscript(new NoticeComponent(`Unknown command: /${name} (try /help)`, "warn"));
         }
     }
+    /** `/balance` — the platform credit balance (platform mode only). */
+    async function showBalance() {
+        try {
+            const { balance } = await opts.client.getBalance();
+            const amount = balance < 0 ? `-$${Math.abs(balance).toFixed(2)}` : `$${balance.toFixed(2)}`;
+            addTranscript(new NoticeComponent(`Credit balance: ${amount}`, "info"));
+        }
+        catch (err) {
+            // The server's 404 for a standalone deployment carries code
+            // `platform_only`; show it plainly instead of the generic 404 hint.
+            if (err instanceof IntegrationApiError && err.code === "platform_only") {
+                addTranscript(new NoticeComponent("Credit balance is only available on platform deployments.", "warn"));
+                return;
+            }
+            addTranscript(new NoticeComponent(`Failed to fetch balance: ${err instanceof Error ? err.message : String(err)}`, "error"));
+        }
+    }
     function setMode(mode) {
         runner.setMode(mode);
         editor.mode = mode;

package/dist/ui/help.js

@@ -24,7 +24,8 @@ const COMMANDS = [
     ["/cowork", "general tasks", "/edit", "AUTO/ASK"],
     ["/new", "new session", "/session [all]", "list · switch"],
     ["/thinking /model", "level · model", "/compact /stop", "compact · stop"],
-    ["/reload /export", "reload · export", "/config /quit", "info · exit"],
+    ["/balance", "credit balance", "/reload /export", "reload · export"],
+    ["/config /quit", "info · exit", "", ""],
 ];
 const KEYS = [
     ["Tab", "plan/coding/cowork", "Shift+Tab", "AUTO/ASK"],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ocis/myagent-cli",
-  "version": "0.2.5",
+  "version": "0.2.6",
   "description": "Terminal coding agent for your local repository, powered by a remote MyAgent server",
   "type": "module",
   "bin": {