@ocis/myagent-cli 0.2.4 → 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/index.js

@@ -10,7 +10,7 @@ import { stdin as input, stdout as output } from "node:process";
 import { homedir } from "node:os";
 import { resolve } from "node:path";
 import pkg from "../package.json" with { type: "json" };
-import { IntegrationClient } from "./protocol/client.js";
+import { IntegrationClient, IntegrationApiError } from "./protocol/client.js";
 import { ToolRegistry } from "./tools/registry.js";
 import { combinedIntegrationUrl, configDir, isConfigured, loadConfig, migrateLegacyConfigDir, resolveConfig, saveConfig, sessionsPath, splitIntegrationUrl, } from "./config.js";
 import { SessionIndex } from "./agent/sessions.js";
@@ -335,15 +335,24 @@ async function main() {
         integrationId: config.integrationId,
         apiKey: config.apiKey,
     });
-    let status;
+    let status = null;
     try {
         // Bounded connect: a hung server must fail (exit 2) instead of hanging CI.
         status = await client.getStatus({ signal: AbortSignal.timeout(30_000) });
     }
     catch (err) {
-        return fail(args.flags.outputFormat, `Could not reach ${config.baseUrl}: ${err instanceof Error ? err.message : String(err)}`, "connection_failed");
+        // A paused platform sandbox answers the status check with 503 — the check
+        // deliberately does not wake it (see the platform's proxy-activator). That
+        // is not a connection failure: the first run wakes the sandbox, so proceed
+        // with a notice instead of failing.
+        if (err instanceof IntegrationApiError && err.status === 503) {
+            process.stderr.write("Sandbox is paused — it will start on your first message.\n");
+        }
+        else {
+            return fail(args.flags.outputFormat, `Could not reach ${config.baseUrl}: ${err instanceof Error ? err.message : String(err)}`, "connection_failed");
+        }
     }
-    if (!status.enabled) {
+    if (status && !status.enabled) {
         return fail(args.flags.outputFormat, `Integration "${status.label}" is disabled on the server.`, "integration_disabled");
     }
     const sessionIndex = await SessionIndex.load(sessionsPath());

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
@@ -231,14 +238,26 @@ export class IntegrationClient {
         let message = `HTTP ${res.status}`;
         let code;
         let details;
+        // Read the body once as text: myagent's error bodies are JSON, but the
+        // platform proxy answers with plain text (e.g. its 503 for a paused
+        // sandbox) — keep that text instead of collapsing it to "HTTP 503".
+        let text = "";
         try {
-            const body = await res.json();
-            if (body.error?.message)
-                message = body.error.message;
-            code = body.error?.code;
-            details = body.error?.details;
+            text = await res.text();
+        }
+        catch { /* unreadable body */ }
+        if (text) {
+            try {
+                const body = JSON.parse(text);
+                if (body.error?.message)
+                    message = body.error.message;
+                code = body.error?.code;
+                details = body.error?.details;
+            }
+            catch {
+                message = text.trim() || message;
+            }
         }
-        catch { /* non-JSON error body */ }
         if (res.status === 404) {
             message += " (check the integration id and that the integration is enabled)";
         }

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.4",
+  "version": "0.2.6",
   "description": "Terminal coding agent for your local repository, powered by a remote MyAgent server",
   "type": "module",
   "bin": {