@mysten-incubation/sui-agent-pass 0.1.7 → 0.1.8

package/dist/mcp.js

@@ -6,7 +6,7 @@ import { fileURLToPath } from 'node:url';
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { z } from 'zod';
 import { clientFor, deepbookSizes, readAllHoldings, readStatus } from './chain.js';
-import { coinInfo } from './domain.js';
+import { coinInfo, DAY_MS } from './domain.js';
 export const result = (value) => ({
     content: [{ type: 'text', text: JSON.stringify(value) }],
 });
@@ -45,14 +45,51 @@ async function sdkInfo(directory) {
         note: published ? null : `${root} must be built (npm run build) before installing from it`,
     };
 }
-/** Which code answers: the package version and when it was built, so a stale server shows. */
-async function serverInfo() {
+let latest = null;
+/** The newest version on npm, asked at most once a day per process; null when npm is unreachable. */
+async function latestVersion(name) {
+    if (latest && Date.now() - latest.at < DAY_MS)
+        return latest.version;
+    const version = await fetch(`https://registry.npmjs.org/${name.replace('/', '%2F')}/latest`, {
+        signal: AbortSignal.timeout(2_000),
+    })
+        .then((r) => (r.ok ? r.json() : null))
+        .then((j) => j?.version ?? null)
+        .catch(() => null);
+    latest = { at: Date.now(), version };
+    return version;
+}
+const newer = (a, b) => {
+    const [x, y] = [a, b].map((v) => v.split('-')[0].split('.').map(Number));
+    for (let i = 0; i < 3; i++)
+        if (x[i] !== y[i])
+            return (x[i] ?? 0) > (y[i] ?? 0);
+    return false;
+};
+/**
+ * Which code answers: the package version and when it was built, so a stale server shows, and
+ * for an installed package a newer release on npm with the command that takes it.
+ */
+export async function serverInfo() {
     const pkg = JSON.parse(await readFile(new URL('../package.json', import.meta.url), 'utf8'));
     const built = await stat(fileURLToPath(import.meta.url)).then((s) => s.mtime.toISOString());
+    const installed = fileURLToPath(import.meta.url)
+        .split(sep)
+        .includes('node_modules');
+    const available = installed ? await latestVersion(pkg.name) : null;
     return {
         version: pkg.version,
         builtAt: built,
         note: 'This process keeps the code it started with. After this package is rebuilt or upgraded, restart the agent client so it starts a new server; compare builtAt.',
+        ...(available && newer(available, pkg.version)
+            ? {
+                update: {
+                    latest: available,
+                    command: `npm install -g ${pkg.name}@latest`,
+                    then: 'Restart the agent client so it starts the new server; the agent-pass skill is linked to the package and follows it.',
+                },
+            }
+            : {}),
     };
 }
 /**

package/dist/plugin.js

@@ -25,7 +25,7 @@ import { describePolicy, describeSetup, renderRows } from './describe.js';
 import { address, coinBySymbol, coinInfo, DAY_MS, defaultGasDaily, DeploymentSchema, display, isStable, limitUnits, poolsFor, recipientName, sameCoin, SetupSchema, showCoin, units, VenueSchema, } from './domain.js';
 import { passesByAgent } from './explorer.js';
 import { passEnded, returnGasFloat } from './float.js';
-import { failure, INSTRUCTIONS, registerDocs, result, sessionInfo, SIGN_ANNOTATIONS, SIGN_DESCRIPTION, } from './mcp.js';
+import { failure, INSTRUCTIONS, registerDocs, result, serverInfo, sessionInfo, SIGN_ANNOTATIONS, SIGN_DESCRIPTION, } from './mcp.js';
 import { authenticated, body, ownerPageUrl, startServer } from './server.js';
 import { SessionSigner } from './signer.js';
 import { SessionStore, token } from './storage.js';
@@ -465,6 +465,7 @@ export function createPluginMcp(registry) {
                 }
                 : {}),
             deployment: { path, exists: own.length > 0 },
+            server: await serverInfo(),
             networks: [...own, ...bundled.filter((b) => !own.some((o) => o.network === b.network))],
         });
     });

package/docs/PLAYBOOK.md

@@ -122,6 +122,10 @@ Start with `session_info`. It returns:
 - `directory`, `sdk` and `server`: the session directory, how to install and import the SDK,
   and this server's version (after an upgrade the client must restart the server).
 
+**Updates.** When `server.update` is present in `list_passes` or `session_info`, a newer release
+is out. Tell the owner once per conversation, with `server.update.command` and the reminder to
+restart the agent afterwards, then carry on with the task; never run the command yourself.
+
 Act by writing a Node script against the SDK. Run `sdk.install` once in your working directory,
 then:
 

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@mysten-incubation/sui-agent-pass",
-	"version": "0.1.7",
+	"version": "0.1.8",
 	"type": "module",
 	"description": "AI builds transactions. A session signer signs. Your pass enforces the rules.",
 	"repository": {

package/skills/agent-pass/SKILL.md

@@ -127,6 +127,10 @@ Start with `session_info`. It returns:
 - `directory`, `sdk` and `server`: the session directory, how to install and import the SDK,
   and this server's version (after an upgrade the client must restart the server).
 
+**Updates.** When `server.update` is present in `list_passes` or `session_info`, a newer release
+is out. Tell the owner once per conversation, with `server.update.command` and the reminder to
+restart the agent afterwards, then carry on with the task; never run the command yourself.
+
 Act by writing a Node script against the SDK. Run `sdk.install` once in your working directory,
 then: