@mindstudio-ai/agent 0.1.164 → 0.1.165

package/CHANGELOG.md

@@ -4,6 +4,12 @@ What changed in `@mindstudio-ai/agent`, newest first, each version under its own
 
 Versions before 0.1.163 aren't recorded here.
 
+## 0.1.165
+
+### New
+
+- The CLI can log what each call costs. When `MINDSTUDIO_USAGE_LOG` names a file, every billed call from an action, `batch` (a line per step) or `ask` appends one JSON line to it: `{ ts, action, billingCost, billingEvents?, durationMs }`, with `billingCost` in nano-dollars. It's for a tool that runs the CLI and keeps its own record of spend, whatever happens to the command's output. App code isn't affected.
+
 ## 0.1.164
 
 ### New

package/dist/cli.js

@@ -9,6 +9,31 @@ var __export = (target, all) => {
     __defProp(target, name, { get: all[name], enumerable: true });
 };
 
+// src/usageLog.ts
+import { appendFileSync } from "fs";
+function logUsage(entry) {
+  const file = process.env.MINDSTUDIO_USAGE_LOG;
+  if (!file || typeof entry.billingCost !== "number") {
+    return;
+  }
+  const line = {
+    ts: Date.now(),
+    action: entry.action,
+    billingCost: entry.billingCost,
+    ...entry.billingEvents?.length && { billingEvents: entry.billingEvents },
+    durationMs: Date.now() - entry.startedAt
+  };
+  try {
+    appendFileSync(file, JSON.stringify(line) + "\n");
+  } catch {
+  }
+}
+var init_usageLog = __esm({
+  "src/usageLog.ts"() {
+    "use strict";
+  }
+});
+
 // src/generated/metadata.ts
 var metadata_exports = {};
 __export(metadata_exports, {
@@ -9307,6 +9332,7 @@ function summarizeInput(input) {
 async function cmdAsk(question, options) {
   try {
     let lineBuffer = "";
+    const startedAt = Date.now();
     const result = await runAsk(question, options, (event) => {
       switch (event.type) {
         case "text":
@@ -9336,6 +9362,12 @@ async function cmdAsk(question, options) {
     if (lineBuffer) {
       process.stderr.write(lineBuffer);
     }
+    logUsage({
+      action: "ask",
+      billingCost: result.billingCost,
+      billingEvents: result.billingEvents,
+      startedAt
+    });
     if (options.json) {
       process.stdout.write(
         JSON.stringify({
@@ -9360,6 +9392,7 @@ var init_ask = __esm({
   async "src/ask/index.ts"() {
     "use strict";
     await init_client();
+    init_usageLog();
     init_context2();
     init_sse();
     init_tools();
@@ -9434,7 +9467,7 @@ async function startMcpServer(options) {
           capabilities: { tools: {} },
           serverInfo: {
             name: "mindstudio-agent",
-            version: "0.1.164"
+            version: "0.1.165"
           },
           instructions: 'Welcome to MindStudio \u2014 a platform with 200+ AI models, 850+ third-party integrations, and pre-built agents.\n\nGetting started:\n1. Call `ask` with any question about the SDK \u2014 it knows every action, model, and connector and returns working code with real model IDs and config options. Examples: ask("generate an image with FLUX"), ask("what models support vision?"), ask("how do I send a Slack message?").\n2. Call `changeName` to set your display name \u2014 use your name or whatever your user calls you. This is how you\'ll appear in MindStudio request logs.\n3. If you have a profile picture, pass its public image URL to `changeProfilePicture`.\n4. For manual browsing, call `listActions` to discover all available actions.\n\nThen use the tools to generate text, images, video, audio, search the web, work with data sources, run agents, and more.\n\nImportant:\n- AI-powered actions (text generation, image generation, video, audio, etc.) cost money. Before running these, call `estimateActionCost` and confirm with the user before proceeding \u2014 unless they\'ve explicitly told you to go ahead.\n- Not all agents from `listAgents` are configured for API use. Do not try to run an agent just because it appears in the list \u2014 it will likely fail. Only run agents the user specifically asks you to run.'
         });
@@ -9885,6 +9918,7 @@ var init_mcp = __esm({
 });
 
 // src/cli.ts
+init_usageLog();
 import { parseArgs } from "util";
 import { execSync } from "child_process";
 import { readFileSync as readFileSync3 } from "fs";
@@ -10204,11 +10238,18 @@ async function cmdExec(method, input, options) {
 `);
     };
   }
+  const startedAt = Date.now();
   const result = await agent.executeStep(meta.stepType, input, {
     appId: options.appId,
     threadId: options.threadId,
     onLog
   });
+  logUsage({
+    action: camelToKebab(method),
+    billingCost: result.$billingCost,
+    billingEvents: result.$billingEvents,
+    startedAt
+  });
   if (options.outputKey) {
     const val = result[options.outputKey];
     if (typeof val === "string") {
@@ -10384,10 +10425,18 @@ Example: mindstudio batch '[{"stepType":"generateImage","step":{"prompt":"a cat"
     return { stepType: item.stepType, step: item.step };
   });
   const agent = await createAgent(options);
+  const startedAt = Date.now();
   const result = await agent.executeStepBatch(steps, {
     appId: options.appId,
     threadId: options.threadId
   });
+  for (const step of result.results) {
+    logUsage({
+      action: `batch:${step.stepType}`,
+      billingCost: step.billingCost,
+      startedAt
+    });
+  }
   if (options.noMeta) {
     process.stdout.write(JSON.stringify(result.results, null, 2) + "\n");
   } else {
@@ -10458,7 +10507,7 @@ function isNewerVersion(current, latest) {
   return false;
 }
 async function checkForUpdate() {
-  const currentVersion = "0.1.164";
+  const currentVersion = "0.1.165";
   if (!currentVersion || process.env.MINDSTUDIO_NO_UPDATE_CHECK) {
     return null;
   }
@@ -10493,7 +10542,7 @@ async function checkForUpdate() {
   }
 }
 function printUpdateNotice(latestVersion) {
-  const currentVersion = "0.1.164";
+  const currentVersion = "0.1.165";
   process.stderr.write(
     `
   ${ansi2.cyanBright("Update available")} ${ansi2.gray(currentVersion + " \u2192")} ${ansi2.cyanBold(latestVersion)}
@@ -10506,7 +10555,7 @@ function isStandaloneBinary() {
   return !argv1.includes("node_modules");
 }
 async function cmdUpdate() {
-  const currentVersion = "0.1.164";
+  const currentVersion = "0.1.165";
   process.stderr.write(
     `  ${ansi2.gray("Current version:")} ${currentVersion}
 `
@@ -10647,7 +10696,7 @@ async function cmdLogin(options) {
   process.stderr.write("\n");
   printLogo();
   process.stderr.write("\n");
-  const ver = "0.1.164";
+  const ver = "0.1.165";
   process.stderr.write(
     `  ${ansi2.bold("MindStudio Agent")} ${ver ? " " + ansi2.gray("v" + ver) : ""}
 `
@@ -10975,7 +11024,7 @@ async function main() {
   const updatePromise = command !== "mcp" && command !== "login" && command !== "update" ? checkForUpdate() : Promise.resolve(null);
   try {
     if (command === "version" || command === "-v") {
-      process.stdout.write("0.1.164\n");
+      process.stdout.write("0.1.165\n");
       return;
     }
     if (command === "login") {

package/dist/postinstall.js

@@ -9,6 +9,31 @@ var __export = (target, all) => {
     __defProp(target, name, { get: all[name], enumerable: true });
 };
 
+// src/usageLog.ts
+import { appendFileSync } from "fs";
+function logUsage(entry) {
+  const file = process.env.MINDSTUDIO_USAGE_LOG;
+  if (!file || typeof entry.billingCost !== "number") {
+    return;
+  }
+  const line = {
+    ts: Date.now(),
+    action: entry.action,
+    billingCost: entry.billingCost,
+    ...entry.billingEvents?.length && { billingEvents: entry.billingEvents },
+    durationMs: Date.now() - entry.startedAt
+  };
+  try {
+    appendFileSync(file, JSON.stringify(line) + "\n");
+  } catch {
+  }
+}
+var init_usageLog = __esm({
+  "src/usageLog.ts"() {
+    "use strict";
+  }
+});
+
 // src/generated/metadata.ts
 var metadata_exports = {};
 __export(metadata_exports, {
@@ -9307,6 +9332,7 @@ function summarizeInput(input) {
 async function cmdAsk(question, options) {
   try {
     let lineBuffer = "";
+    const startedAt = Date.now();
     const result = await runAsk(question, options, (event) => {
       switch (event.type) {
         case "text":
@@ -9336,6 +9362,12 @@ async function cmdAsk(question, options) {
     if (lineBuffer) {
       process.stderr.write(lineBuffer);
     }
+    logUsage({
+      action: "ask",
+      billingCost: result.billingCost,
+      billingEvents: result.billingEvents,
+      startedAt
+    });
     if (options.json) {
       process.stdout.write(
         JSON.stringify({
@@ -9360,6 +9392,7 @@ var init_ask = __esm({
   async "src/ask/index.ts"() {
     "use strict";
     await init_client();
+    init_usageLog();
     init_context2();
     init_sse();
     init_tools();
@@ -9434,7 +9467,7 @@ async function startMcpServer(options) {
           capabilities: { tools: {} },
           serverInfo: {
             name: "mindstudio-agent",
-            version: "0.1.164"
+            version: "0.1.165"
           },
           instructions: 'Welcome to MindStudio \u2014 a platform with 200+ AI models, 850+ third-party integrations, and pre-built agents.\n\nGetting started:\n1. Call `ask` with any question about the SDK \u2014 it knows every action, model, and connector and returns working code with real model IDs and config options. Examples: ask("generate an image with FLUX"), ask("what models support vision?"), ask("how do I send a Slack message?").\n2. Call `changeName` to set your display name \u2014 use your name or whatever your user calls you. This is how you\'ll appear in MindStudio request logs.\n3. If you have a profile picture, pass its public image URL to `changeProfilePicture`.\n4. For manual browsing, call `listActions` to discover all available actions.\n\nThen use the tools to generate text, images, video, audio, search the web, work with data sources, run agents, and more.\n\nImportant:\n- AI-powered actions (text generation, image generation, video, audio, etc.) cost money. Before running these, call `estimateActionCost` and confirm with the user before proceeding \u2014 unless they\'ve explicitly told you to go ahead.\n- Not all agents from `listAgents` are configured for API use. Do not try to run an agent just because it appears in the list \u2014 it will likely fail. Only run agents the user specifically asks you to run.'
         });
@@ -10134,11 +10167,18 @@ async function cmdExec(method, input, options) {
 `);
     };
   }
+  const startedAt = Date.now();
   const result = await agent.executeStep(meta.stepType, input, {
     appId: options.appId,
     threadId: options.threadId,
     onLog
   });
+  logUsage({
+    action: camelToKebab(method),
+    billingCost: result.$billingCost,
+    billingEvents: result.$billingEvents,
+    startedAt
+  });
   if (options.outputKey) {
     const val = result[options.outputKey];
     if (typeof val === "string") {
@@ -10314,10 +10354,18 @@ Example: mindstudio batch '[{"stepType":"generateImage","step":{"prompt":"a cat"
     return { stepType: item.stepType, step: item.step };
   });
   const agent = await createAgent(options);
+  const startedAt = Date.now();
   const result = await agent.executeStepBatch(steps, {
     appId: options.appId,
     threadId: options.threadId
   });
+  for (const step of result.results) {
+    logUsage({
+      action: `batch:${step.stepType}`,
+      billingCost: step.billingCost,
+      startedAt
+    });
+  }
   if (options.noMeta) {
     process.stdout.write(JSON.stringify(result.results, null, 2) + "\n");
   } else {
@@ -10361,7 +10409,7 @@ function isNewerVersion(current, latest) {
   return false;
 }
 async function checkForUpdate() {
-  const currentVersion = "0.1.164";
+  const currentVersion = "0.1.165";
   if (!currentVersion || process.env.MINDSTUDIO_NO_UPDATE_CHECK) {
     return null;
   }
@@ -10396,7 +10444,7 @@ async function checkForUpdate() {
   }
 }
 function printUpdateNotice(latestVersion) {
-  const currentVersion = "0.1.164";
+  const currentVersion = "0.1.165";
   process.stderr.write(
     `
   ${ansi2.cyanBright("Update available")} ${ansi2.gray(currentVersion + " \u2192")} ${ansi2.cyanBold(latestVersion)}
@@ -10409,7 +10457,7 @@ function isStandaloneBinary() {
   return !argv1.includes("node_modules");
 }
 async function cmdUpdate() {
-  const currentVersion = "0.1.164";
+  const currentVersion = "0.1.165";
   process.stderr.write(
     `  ${ansi2.gray("Current version:")} ${currentVersion}
 `
@@ -10530,7 +10578,7 @@ async function cmdLogin(options) {
   process.stderr.write("\n");
   printLogo();
   process.stderr.write("\n");
-  const ver = "0.1.164";
+  const ver = "0.1.165";
   process.stderr.write(
     `  ${ansi2.bold("MindStudio Agent")} ${ver ? " " + ansi2.gray("v" + ver) : ""}
 `
@@ -10842,7 +10890,7 @@ async function main() {
   const updatePromise = command !== "mcp" && command !== "login" && command !== "update" ? checkForUpdate() : Promise.resolve(null);
   try {
     if (command === "version" || command === "-v") {
-      process.stdout.write("0.1.164\n");
+      process.stdout.write("0.1.165\n");
       return;
     }
     if (command === "login") {
@@ -11302,6 +11350,7 @@ var HELP, MIME_TYPES2, ansi2, UPDATE_CHECK_INTERVAL, LOGO, DEFAULT_BASE_URL2, SP
 var init_cli = __esm({
   "src/cli.ts"() {
     "use strict";
+    init_usageLog();
     HELP = `Usage: mindstudio <command> [options]
 
 Ask:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mindstudio-ai/agent",
-  "version": "0.1.164",
+  "version": "0.1.165",
   "description": "TypeScript SDK for MindStudio direct step execution",
   "type": "module",
   "main": "./dist/index.js",