@oneshot-agent/mcp-server 0.29.0 → 0.29.1

package/README.md

@@ -226,7 +226,7 @@ instead of the wallet variables for a credits-only session on your own machine.
 | Tool | Description |
 |------|-------------|
 | `oneshot_spend_breakdown` | Spend by tool/category over a period |
-| `oneshot_rocs` | Return on Compute Spend analytics |
+| `oneshot_return_on_spend` | Return on spend: cost vs. value produced |
 | `oneshot_receipts_list` | List spend receipts |
 | `oneshot_tag_receipt_value` | Tag a receipt with the value it generated |
 

package/dist/index.js

@@ -52,7 +52,7 @@ async function main() {
     // Create MCP server
     const server = new Server({
         name: "oneshot-mcp",
-        version: "0.29.0", // keep in sync with package.json; guarded by version.test.ts
+        version: "0.29.1", // keep in sync with package.json; guarded by version.test.ts
     }, {
         capabilities: {
             tools: {},

package/dist/tools/analytics.d.ts

@@ -10,3 +10,8 @@ export declare function handleRocs(agent: OneShot, args: Record<string, unknown>
 export declare function handleReceiptsList(agent: OneShot, args: Record<string, unknown>): Promise<import("@oneshot-agent/sdk").ReceiptsListResult>;
 export declare function handleRocsByGoal(agent: OneShot, args: Record<string, unknown>): Promise<import("@oneshot-agent/sdk").RoCSByGoalResult>;
 export declare function handleTagReceiptValue(agent: OneShot, args: Record<string, unknown>): Promise<void>;
+/**
+ * Old tool names (renamed in 0.29.1 because "rocs" was unclear to users and
+ * to ChatGPT's review scan). Still dispatched, never listed.
+ */
+export declare const LEGACY_TOOL_ALIASES: Record<string, (agent: OneShot, args: Record<string, unknown>) => Promise<unknown>>;

package/dist/tools/analytics.js

@@ -9,8 +9,8 @@ export const spendBreakdownTool = {
     },
 };
 export const rocsTool = {
-    name: "oneshot_rocs",
-    description: "Get Return on Compute Spend (RoCS) analytics for the agent over a period. Free.",
+    name: "oneshot_return_on_spend",
+    description: "Get the agent's return on spend over a period: what its tool calls cost compared with the value they produced (return on compute spend). Free.",
     inputSchema: {
         type: "object",
         properties: {
@@ -54,9 +54,9 @@ export const tagReceiptValueTool = {
     },
 };
 export const rocsByGoalTool = {
-    name: "oneshot_rocs_by_goal",
-    description: "Per-cadence RoCS rollup: spend (receipts) vs. value (outcomes) grouped by goal_id. " +
-        "Answers 'what did this cadence cost vs. earn' in one query. Free.",
+    name: "oneshot_return_on_spend_by_goal",
+    description: "Return on spend per goal: what each goal cost (receipts) compared with the value it produced (tagged outcomes), grouped by goal_id. " +
+        "Answers 'what did this goal cost vs. earn' in one query. Free.",
     inputSchema: {
         type: "object",
         properties: {
@@ -98,3 +98,11 @@ export async function handleTagReceiptValue(agent, args) {
         label: args.label,
     });
 }
+/**
+ * Old tool names (renamed in 0.29.1 because "rocs" was unclear to users and
+ * to ChatGPT's review scan). Still dispatched, never listed.
+ */
+export const LEGACY_TOOL_ALIASES = {
+    oneshot_rocs: handleRocs,
+    oneshot_rocs_by_goal: handleRocsByGoal,
+};

package/dist/tools/annotations.js

@@ -64,7 +64,7 @@ export const TOOL_ANNOTATIONS = {
     // LinkedIn
     oneshot_linkedin_connect: write("Connect LinkedIn", OPEN),
     oneshot_linkedin_accounts: read("List LinkedIn accounts", OWN),
-    oneshot_linkedin_sync: read("Sync LinkedIn messages", OPEN),
+    oneshot_linkedin_sync: write("Sync LinkedIn messages", OPEN), // paid; imports history into the account
     oneshot_linkedin_conversations: read("List LinkedIn conversations", OWN),
     oneshot_linkedin_messages: read("Read LinkedIn messages", OWN),
     oneshot_linkedin_reply: write("Send a LinkedIn message", OPEN),
@@ -78,8 +78,8 @@ export const TOOL_ANNOTATIONS = {
     oneshot_resume_domain: write("Resume a sending domain", OWN),
     // Analytics
     oneshot_spend_breakdown: read("Show spending", OWN),
-    oneshot_rocs: read("Show return on spend", OWN),
-    oneshot_rocs_by_goal: read("Show return on spend by goal", OWN),
+    oneshot_return_on_spend: read("Show return on spend", OWN),
+    oneshot_return_on_spend_by_goal: read("Show return on spend by goal", OWN),
     oneshot_receipts_list: read("List receipts", OWN),
     oneshot_tag_receipt_value: write("Tag a receipt's value", OWN),
     // Account

package/dist/tools/index.js

@@ -23,7 +23,7 @@ import { linkedinConnectTool, linkedinAccountsTool, linkedinSyncTool, linkedinCo
 import { computeTool, computeStatusTool, computeTasksTool, computeCancelTool, computeRespondTool, computePauseTool, computeResumeTool, computeFundTool, handleCompute, handleComputeStatus, handleComputeTasks, handleComputeCancel, handleComputeRespond, handleComputePause, handleComputeResume, handleComputeFund } from "./compute.js";
 import { listDomainsTool, pauseDomainTool, resumeDomainTool, handleListDomains, handlePauseDomain, handleResumeDomain } from "./domains.js";
 import { TOOL_ANNOTATIONS } from "./annotations.js";
-import { spendBreakdownTool, rocsTool, rocsByGoalTool, receiptsListTool, tagReceiptValueTool, handleSpendBreakdown, handleRocs, handleRocsByGoal, handleReceiptsList, handleTagReceiptValue } from "./analytics.js";
+import { spendBreakdownTool, rocsTool, rocsByGoalTool, receiptsListTool, tagReceiptValueTool, handleSpendBreakdown, handleRocs, handleRocsByGoal, handleReceiptsList, handleTagReceiptValue, LEGACY_TOOL_ALIASES } from "./analytics.js";
 // All available tools, before annotations
 const toolDefinitions = [
     // Communication
@@ -195,8 +195,10 @@ const handlers = {
     "oneshot_resume_domain": handleResumeDomain,
     // Analytics
     "oneshot_spend_breakdown": handleSpendBreakdown,
-    "oneshot_rocs": handleRocs,
-    "oneshot_rocs_by_goal": handleRocsByGoal,
+    "oneshot_return_on_spend": handleRocs,
+    "oneshot_return_on_spend_by_goal": handleRocsByGoal,
+    // Pre-0.29.1 names: callable, never listed, so existing clients keep working.
+    ...LEGACY_TOOL_ALIASES,
     "oneshot_receipts_list": handleReceiptsList,
     "oneshot_tag_receipt_value": handleTagReceiptValue,
     // Account

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oneshot-agent/mcp-server",
-  "version": "0.29.0",
+  "version": "0.29.1",
   "description": "MCP server for OneShot - 73 tools for AI agents",
   "type": "module",
   "main": "dist/index.js",