@noimosai/platform-mcp 0.1.4 → 0.1.5

package/dist/cli/cli.js

@@ -8,15 +8,11 @@ import { CliInputError, cliInputReason, isCliInputFailure, jsonOption } from "./
 import { uploadLocalInput } from "../client/local-input.js";
 import { localProfilePath, runtimeConfig } from "../client/local-profile.js";
 import { localProjectConfig } from "../client/local-projects.js";
-import { runLocalCommand } from "./setup.js";
 import { isTeamResource, teamResourceCommand } from "./team-resources.js";
-import { runWalletCommand } from "./wallet.js";
 import { PLATFORM_CLI_VERSION } from "./version.js";
 import { AgentRun, agentRunSchema, agentParallelSchema, agentResultSchema, agentResultsSchema, agentResumeSchema, resultFilesFor as resultFiles } from "../client/agent-run.js";
 import { platformTeamQuerySchema } from "../client/index.js";
 import { platformProjectStatusQuerySchema } from "../client/index.js";
-import { deactivateProjectFiles } from "./project-files.js";
-import { projectSyncFactory } from "./project-sync.js";
 import { PLATFORM_META_LIMITS, PLATFORM_TOOL_REQUEST_MAX_BYTES, platformMetaSearchSchema, platformMetaSchemasSchema, platformMetaConnectionsSchema, platformMetaExecuteSchema, platformMetaWorkbenchSchema, platformMetaBashSchema, platformIdempotencyKeySchema, platformJsonObjectSchema, withEvidentValues } from "../client/index.js";
 function metaInput(schema, input) {
     const json = platformJsonObjectSchema.safeParse(input);
@@ -427,7 +423,7 @@ export async function runCli(args, env, output, error, transport = fetch, stdin
         else if (args.length === 5 && args[0] === "download" && args[3] === "--out" && args[4].trim()) {
             const id = platformExecutionIdSchema.parse(args[1]);
             const artifactId = platformArtifactIdSchema.parse(args[2]);
-            command = (client) => downloadArtifact(client, id, artifactId, args[4], transport);
+            command = (client) => downloadArtifact(client, id, artifactId, args[4], transport, cliCommand);
         }
         else if (args.length === 3 && args[0] === "artifact-url") {
             const id = platformExecutionIdSchema.parse(args[1]);
@@ -526,7 +522,9 @@ export async function runRelvoCli(args, env, output, error, transport = fetch, s
             const { values } = parseArgs({ args: args.slice(1), options: { profile: { type: "string" }, mode: { type: "string" }, project: { type: "string" } } });
             if (!values.profile)
                 throw new Error("relvo mcp requires the managed --profile path.");
-            const { startPlatformMcp } = await import("../mcp/runtime.js");
+            const [{ startPlatformMcp }, { deactivateProjectFiles }, { projectSyncFactory }] = await Promise.all([
+                import("../mcp/runtime.js"), import("./project-files.js"), import("./project-sync.js")
+            ]);
             const profileHome = dirname(dirname(dirname(values.profile)));
             await startPlatformMcp(options.version, values.profile, values.mode, values.project, id => deactivateProjectFiles(id, env, profileHome), projectSyncFactory(env, profileHome));
             return process.exitCode ? 1 : 0;
@@ -546,7 +544,7 @@ export async function runRelvoCli(args, env, output, error, transport = fetch, s
     };
     if (args[0] === "wallet" && !args.some((arg) => ["--help", "-h"].includes(arg))) {
         try {
-            await runWalletCommand(args, env, output, transport, options);
+            await (await import("./wallet.js")).runWalletCommand(args, env, output, transport, options);
             return 0;
         }
         catch (failure) {
@@ -556,7 +554,7 @@ export async function runRelvoCli(args, env, output, error, transport = fetch, s
     const local = ["setup", "login", "doctor", "logout", "skills"].includes(args[0]) || args[0] === "team-skills" && ["sync", "push", "check", "apply", "dismiss", "auto-sync"].includes(args[1]) || args[0] === "project" && ["list", "add", "use"].includes(args[1]);
     if (local && !args.some((arg) => ["--help", "-h"].includes(arg))) {
         try {
-            await runLocalCommand(args, env, output, transport, options);
+            await (await import("./setup.js")).runLocalCommand(args, env, output, transport, options);
             return 0;
         }
         catch (failure) {

package/dist/cli/download.js

@@ -1,15 +1,23 @@
 import { createHash } from "node:crypto";
-import { link, mkdtemp, rm, writeFile } from "node:fs/promises";
+import { link, lstat, mkdtemp, rm, stat, writeFile } from "node:fs/promises";
 import { dirname, join, resolve } from "node:path";
 import { outputArtifacts } from "../client/agent-run.js";
 const STALL_MS = 60_000;
-export async function downloadArtifact(client, id, artifactId, filename, transport = fetch) {
+const errorCode = (error) => error instanceof Error && "code" in error ? error.code : undefined;
+const existingOutput = (path) => new Error(`The --out file already exists: ${path}. Choose a new file name; nothing was overwritten.`);
+export async function downloadArtifact(client, id, artifactId, filename, transport, cliCommand) {
     const execution = (await client.execution(id)).data;
     if (["queued", "running", "waiting"].includes(execution.status))
-        throw new Error(`This execution is still ${execution.status}. Wait for it with relvo wait ${id}, then download.`);
+        throw new Error(`This execution is still ${execution.status}. Wait for it with ${cliCommand} wait ${id}, then download.`);
     const artifact = outputArtifacts(execution.output).find((entry) => entry.id === artifactId);
     if (!artifact)
         throw new Error("Artifact is not present in this execution. Inspect execution output for available artifact IDs.");
+    const path = resolve(filename);
+    if (!await stat(dirname(path)).then(entry => entry.isDirectory(), () => false))
+        throw new Error(`The folder for --out does not exist: ${dirname(path)}. No file was saved.`);
+    if (await lstat(path).then(() => true, (error) => { if (errorCode(error) === "ENOENT")
+        return false; throw error; }))
+        throw existingOutput(path);
     const { data } = await client.artifactDownload(id, artifactId);
     const url = new URL(data.url);
     if (url.hostname !== "storage.googleapis.com" && !url.hostname.endsWith(".storage.googleapis.com"))
@@ -25,7 +33,7 @@ export async function downloadArtifact(client, id, artifactId, filename, transpo
         clearTimeout(watchdog);
         throw new Error("Artifact download failed. Retrieve a fresh URL and try again.");
     }
-    const reader = response.body.getReader(), chunks = [];
+    const reader = response.body.getReader(), chunks = [], digest = createHash("sha256");
     let bytes = 0, oversized = false;
     try {
         for (;;) {
@@ -40,6 +48,7 @@ export async function downloadArtifact(client, id, artifactId, filename, transpo
                 break;
             }
             chunks.push(part.value);
+            digest.update(part.value);
         }
     }
     catch {
@@ -51,19 +60,17 @@ export async function downloadArtifact(client, id, artifactId, filename, transpo
     }
     if (oversized)
         throw new Error("Artifact exceeded its recorded size; no file was saved.");
-    const buffer = Buffer.concat(chunks);
-    if (bytes !== artifact.sizeBytes || createHash("sha256").update(buffer).digest("hex") !== artifact.sha256)
+    if (bytes !== artifact.sizeBytes || digest.digest("hex") !== artifact.sha256)
         throw new Error("Artifact integrity check failed; no file was saved.");
-    const path = resolve(filename);
     const temporary = await mkdtemp(join(dirname(path), ".noimos-platform-")).catch((error) => {
-        if (error instanceof Error && "code" in error && error.code === "ENOENT")
+        if (errorCode(error) === "ENOENT")
             throw new Error(`The folder for --out does not exist: ${dirname(path)}. No file was saved.`);
         throw error;
     });
     try {
         const staged = join(temporary, "artifact");
-        await writeFile(staged, buffer, { flag: "wx", mode: 0o600 });
-        await link(staged, path);
+        await writeFile(staged, Buffer.concat(chunks, bytes), { flag: "wx", mode: 0o600 });
+        await link(staged, path).catch((error) => { throw errorCode(error) === "EEXIST" ? existingOutput(path) : error; });
     }
     finally {
         await rm(temporary, { recursive: true, force: true });

package/dist/cli/project-sync.js

@@ -140,10 +140,12 @@ async function context(path, env, options = {}) {
     const roots = harnessRoots(home, env, await readCustomHarnesses(home));
     return { profile, roots, clients: await targets(roots, profile, options.selected), state: await readState(path, profile) };
 }
-async function inspect(client, profile) {
-    const { data } = await client.project();
-    if (data.developerProjectId !== profile.grant.developerProjectId || data.developerOrganizationId !== profile.grant.developerOrganizationId)
-        throw new Error("The saved login does not match this project. No project files were changed.");
+async function inspect(client, profile, verifyProject = true) {
+    if (verifyProject) {
+        const { data } = await client.project();
+        if (data.developerProjectId !== profile.grant.developerProjectId || data.developerOrganizationId !== profile.grant.developerOrganizationId)
+            throw new Error("The saved login does not match this project. No project files were changed.");
+    }
     const items = (await client.teamSkills("all")).data.skills.sort((a, b) => a.slug.localeCompare(b.slug));
     if (new Set(items.map(item => item.slug)).size !== items.length)
         throw new Error("The project returned duplicate items. No project files were changed.");
@@ -199,8 +201,12 @@ export function localProjectSync(path, env, options = {}) {
         const client = options.connected?.client ?? new PlatformClient({ apiUrl: ctx.profile.apiUrl, apiKey: ctx.profile.grant.apiKey, local: ctx.profile.local, source: "cli" }, options.transport);
         return { ...ctx, client };
     };
-    const capture = async (ctx) => {
-        const items = (await inspect(ctx.client, ctx.profile)).filter(item => ctx.clients.some(name => teamItemTargets(item.harnesses, harnessView(ctx.roots, name).like)));
+    let polledLogin;
+    const capture = async (ctx, poll = false) => {
+        const login = `${ctx.profile.grant.apiKey}\n${ctx.profile.grant.developerOrganizationId}\n${ctx.profile.grant.developerProjectId}`;
+        const items = (await inspect(ctx.client, ctx.profile, !poll || polledLogin !== login)).filter(item => ctx.clients.some(name => teamItemTargets(item.harnesses, harnessView(ctx.roots, name).like)));
+        if (poll)
+            polledLogin = login;
         const scriptsPreviouslyAllowed = await teamSkillsUseScripts(ctx.roots, ctx.clients, ctx.profile.grant.developerProjectId)
             || await teamHarnessUsesScripts(ctx.roots, ctx.clients, ctx.profile.grant.developerProjectId);
         const current = await readLocalProfile(path);
@@ -222,7 +228,7 @@ export function localProjectSync(path, env, options = {}) {
             if (env.RELVO_PROJECT_AUTO_SYNC === "0")
                 return undefined;
             const ctx = await prepare();
-            return !ctx.state.enabled ? undefined : (await capture(ctx)).review;
+            return !ctx.state.enabled ? undefined : (await capture(ctx, true)).review;
         },
         apply: (snapshot, confirmedByUser, allowScripts, removeExecutableSettings = false) => withProfileLock(path, async () => {
             confirmed(confirmedByUser);

package/dist/client/browser.js

@@ -319,6 +319,10 @@ const publicErrors = {
     platform_voice_provider_unavailable: "The voice provider for this model is unavailable. Choose another model.",
     platform_voice_session_cancelled: "The voice session was cancelled or has ended.",
 };
+const noimosPublicErrors = {
+    platform_invalid_developer_api_key: "This API key is no longer valid: it expired, was revoked or rotated, or its member lost access. Create a new key in the console.",
+    platform_developer_api_key_required: "This is not a valid API key for this service. Check the key in the console.",
+};
 const PLATFORM_ERROR_CODE = /^platform_[a-z0-9_]{1,100}$/;
 const REFUSALS_WITH_DETAILS = new Set(["platform_invalid_tool_arguments", "platform_custom_tool_invalid", "platform_custom_tool_schema_invalid", "platform_custom_tool_version_conflict",
     "platform_team_skill_invalid", "platform_team_skill_version_conflict", "platform_workflow_invalid", "platform_workflow_version_conflict", "platform_workflow_inputs_invalid",
@@ -326,9 +330,9 @@ const REFUSALS_WITH_DETAILS = new Set(["platform_invalid_tool_arguments", "platf
 const refusalDetailsSchema = z.object({ fields: platformInvalidArgumentFieldsSchema.optional(), reason: z.string().max(200).optional(), version: z.number().int().optional(),
     chargeCeilingMicros: z.number().int().nonnegative().optional() });
 const usd = (micros) => `$${(Number(micros) / 1_000_000).toFixed(micros.length > 4 ? 2 : 4)}`;
-function shortfallText({ reason, requiredMicros, availableMicros }) {
+function shortfallText({ reason, requiredMicros, availableMicros }, relvo) {
     if (reason === "balance")
-        return ` It needs ${usd(requiredMicros)} and the balance has ${usd(availableMicros)}. Top up the balance (relvo wallet top-up, or the console), then retry with the same idempotency key.`;
+        return ` It needs ${usd(requiredMicros)} and the balance has ${usd(availableMicros)}. Top up the balance (${relvo ? "relvo wallet top-up, or the console" : "in the console"}), then retry with the same idempotency key.`;
     const scope = reason === "project_monthly_limit" ? "project's monthly" : reason === "member_monthly_limit" ? "member's monthly" : reason === "api_key_daily_limit" ? "API key's daily" : reason === "organization_daily_limit" ? "organization's daily" : "organization's monthly";
     const reset = reason.endsWith("_daily_limit") ? " The daily count starts again at 00:00 UTC." : "";
     return ` It needs ${usd(requiredMicros)} and ${usd(availableMicros)} remains of the ${scope} spending limit.${reset} Topping up does not help; a person must raise the limit in the console.`;
@@ -349,9 +353,11 @@ export class PlatformApiError extends Error {
     summary;
     billing;
     constructor(status, code, productName = PLATFORM_PRODUCT_NAMES.relvo, fields = [], shortfall, provider, scope, reconnectUrl, billingUrl, actionUrl, connectionProviders = [], noExecutionCharge = false, refusal = {}) {
-        const summary = code && Object.hasOwn(publicErrors, code) ? publicErrors[code] : code ? `The API refused this request: ${code}.`
-            : status >= 500 ? "The service failed this request. Retry shortly; the key and project do not need to change." : "Check the developer key, project access and limits in the console.";
-        super(`${productName} API request failed (${status}). ${summary}${refusal.retryAfterSeconds ? ` Retry after ${refusal.retryAfterSeconds} seconds; retrying sooner counts against this key.` : ""}${fields.length ? ` Invalid fields: ${fields.join(", ")}.` : ""}${refusal.reason ? ` Reason: ${refusal.reason}` : ""}${refusal.version === undefined ? "" : ` Current version: ${refusal.version}.`}${refusal.chargeCeilingMicros === undefined ? "" : ` chargeCeilingMicros: ${refusal.chargeCeilingMicros}.`}${shortfall ? shortfallText(shortfall) : ""}${provider ? ` Provider key needed: ${provider}.` : ""}${scope ? ` Missing scope: ${scope}; obtain the user's additional approval before retrying.` : ""}${reconnectUrl ? ` Show the user this page to reconnect it, then retry: ${reconnectUrl}` : ""}${billingUrl ? ` Billing: ${billingUrl}` : ""}${actionUrl ? ` Show the user this page to complete the required approval or configuration, then retry the original request: ${actionUrl}` : ""}`);
+        const relvo = productName === PLATFORM_PRODUCT_NAMES.relvo;
+        const summary = code && !relvo && Object.hasOwn(noimosPublicErrors, code) ? noimosPublicErrors[code]
+            : code && Object.hasOwn(publicErrors, code) ? publicErrors[code] : code ? `The API refused this request: ${code}.`
+                : status >= 500 ? "The service failed this request. Retry shortly; the key and project do not need to change." : "Check the developer key, project access and limits in the console.";
+        super(`${productName} API request failed (${status}). ${summary}${refusal.retryAfterSeconds ? ` Retry after ${refusal.retryAfterSeconds} seconds; retrying sooner counts against this key.` : ""}${fields.length ? ` Invalid fields: ${fields.join(", ")}.` : ""}${refusal.reason ? ` Reason: ${refusal.reason}` : ""}${refusal.version === undefined ? "" : ` Current version: ${refusal.version}.`}${refusal.chargeCeilingMicros === undefined ? "" : ` chargeCeilingMicros: ${refusal.chargeCeilingMicros}.`}${shortfall ? shortfallText(shortfall, relvo) : ""}${provider ? ` Provider key needed: ${provider}.` : ""}${scope ? ` Missing scope: ${scope}; obtain the user's additional approval before retrying.` : ""}${reconnectUrl ? ` Show the user this page to reconnect it, then retry: ${reconnectUrl}` : ""}${billingUrl ? ` Billing: ${billingUrl}` : ""}${actionUrl ? ` Show the user this page to complete the required approval or configuration, then retry the original request: ${actionUrl}` : ""}`);
         this.status = status;
         this.code = code;
         this.fields = fields;

package/dist/mcp/context.js

@@ -1,4 +1,4 @@
-import { PlatformApiError, wrapUntrusted, TOOL_RESULT_CONTEXT_MAX_BYTES, toolResultSelectionSchema } from "../client/index.js";
+import { PlatformApiError, PLATFORM_DISTRIBUTION, wrapUntrusted, TOOL_RESULT_CONTEXT_MAX_BYTES, toolResultSelectionSchema } from "../client/index.js";
 import { RELVO_TOOL_RESULT_RULE } from "./instructions.js";
 export const MCP_RESULT_MAX_BYTES = TOOL_RESULT_CONTEXT_MAX_BYTES - 256;
 const bytes = (value) => Buffer.byteLength(JSON.stringify(value));
@@ -20,7 +20,7 @@ export function fitRows(rows, reply, fits, oversized) {
         kept.pop();
     return oversized && kept.length && !fits(reply(kept)) ? reply(kept.map(oversized)) : reply(kept);
 }
-export function mcpRequestFailure(error, message = error instanceof Error ? error.message : "Relvo request failed.") {
+export function mcpRequestFailure(error, message = error instanceof Error ? error.message : `${PLATFORM_DISTRIBUTION.name} request failed.`) {
     const reply = error instanceof PlatformApiError
         ? boundedMcpResult({ error: { code: error.code, message: error.guidance ? error.summary : message,
                 ...(error.shortfall ? { shortfall: error.shortfall } : {}), ...(error.billingUrl ? { billingUrl: error.billingUrl } : {}),

package/dist/mcp/operations.js

@@ -1,3 +1,4 @@
+import { PLATFORM_DISTRIBUTION } from "../client/index.js";
 import { withUpdateNotice } from "./update-notice.js";
 import { mcpRequestFailure } from "./context.js";
 export class PlatformOperations {
@@ -29,7 +30,7 @@ export class PlatformOperations {
             return await tool.call(input, context);
         }
         catch (error) {
-            return mcpRequestFailure(error, error instanceof Error ? error.message : "Relvo operation failed.");
+            return mcpRequestFailure(error, error instanceof Error ? error.message : `${PLATFORM_DISTRIBUTION.name} operation failed.`);
         }
     }
     attach(server, notice, only) {

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
   "name": "@noimosai/platform-mcp",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@noimosai/platform-mcp",
-      "version": "0.1.4",
+      "version": "0.1.5",
       "license": "MIT",
       "dependencies": {
         "@modelcontextprotocol/server": "^2.0.0",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@noimosai/platform-mcp",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "description": "NoimosAI Developer Platform stdio MCP server for research, SEO, social data and media generation.",
   "type": "module",
   "bin": {