@neus/sdk 1.1.6 → 1.2.0

package/index.js

@@ -57,6 +57,32 @@ export {
 
 export { fetchSponsorGrant } from './sponsor.js';
 
+export {
+  RUNTIME_MOUNT_SCHEMA,
+  normalizeWallet,
+  isDelegationExpired,
+  pickIdentity,
+  pickActiveDelegation,
+  resolveEffectiveRuntime,
+  extractAgentContextFromProofs,
+  buildRuntimeBundle,
+  profileAgentToIdentitySeed,
+  isRuntimeBundle,
+  resolveRuntimeBundleFromMcp,
+  evaluateMountFileHealth
+} from './runtime-mount.js';
+
+export {
+  MOUNT_MANIFEST_RELATIVE,
+  sanitizeAgentIdForFilename,
+  bundleToCursorRules,
+  bundleToClaudeMd,
+  bundleToCodexJson,
+  readMountManifest,
+  writeMountManifest,
+  applyRuntimeBundle
+} from './runtime-adapters.js';
+
 export {
   SDKError,
   ApiError,
@@ -67,7 +93,48 @@ export {
   AuthenticationError
 } from './errors.js';
 
+export {
+  NEUS_MCP_SERVER_NAME,
+  NEUS_MCP_URL,
+  NEUS_SETUP_CLI,
+  NEUS_AUTH_CLI,
+  NEUS_CHECK_CLI,
+  NEUS_DOCTOR_CLI,
+  NEUS_SETUP_NPX,
+  NEUS_CHECK_NPX,
+  NEUS_INSTALL_CLI,
+  NEUS_NPX,
+  NEUS_QUICKSTART_INSTALLED,
+  NEUS_QUICKSTART_NPX,
+  NEUS_MOUNT_WORKFLOW,
+  NEUS_MCP_SETUP_DOCS_URL,
+  MCP_INSTALL_CLIENTS,
+  MCP_INSTALL_HOSTS,
+  IDE_HOST_LABELS,
+  IDE_HOST_BRAND_LOGOS,
+  buildNeusMcpHttpConfig,
+  buildCursorMcpInstallUrl,
+  buildVsCodeMcpInstallUrl,
+  buildSetupCommandForClient,
+  buildSetupCommandForHost,
+  buildSetupNpxOneLiner,
+  buildAuthCommandForClient,
+  supportsMcpInstallDeeplink,
+  neusMountApply,
+  neusMountApplyNpx,
+} from './mcp-hosts.js';
+
+export {
+  NEUS_PKG,
+  NEUS_EXAMPLES_CLI,
+  NEUS_EXAMPLES_NPX,
+  NEUS_AUTH_NPX,
+  NEUS_DOCTOR_NPX,
+  neusCmd,
+  neusNpx,
+} from './cli-commands.js';
+
 export default {
-  NeusClient: () => import('./client.js').then(m => m.NeusClient),
-  toString: () => '[neus/sdk]'
+  NeusClient: () => import('./client.js').then((m) => m.NeusClient),
+  toString: () => '[neus/sdk]',
 };

package/mcp-hosts.js

@@ -3,11 +3,40 @@
  * Browser-safe: no Node-only APIs except the Buffer fallback for non-browser tests.
  */
 
+import {
+  NEUS_AUTH_CLI,
+  NEUS_INSTALL_CLI,
+  NEUS_NPX,
+  NEUS_SETUP_NPX,
+  neusCmd,
+} from './cli-commands.js';
+
+export {
+  NEUS_PKG,
+  NEUS_INSTALL_CLI,
+  NEUS_NPX,
+  NEUS_SETUP_CLI,
+  NEUS_SETUP_NPX,
+  NEUS_AUTH_CLI,
+  NEUS_CHECK_CLI,
+  NEUS_DOCTOR_CLI,
+  NEUS_EXAMPLES_CLI,
+  NEUS_CHECK_NPX,
+  NEUS_AUTH_NPX,
+  NEUS_DOCTOR_NPX,
+  NEUS_EXAMPLES_NPX,
+  NEUS_QUICKSTART_INSTALLED,
+  NEUS_QUICKSTART_NPX,
+  NEUS_MOUNT_WORKFLOW,
+  neusMountApply,
+  neusMountApplyNpx,
+  neusCmd,
+  neusNpx,
+} from './cli-commands.js';
+
 export const NEUS_MCP_SERVER_NAME = 'neus';
 export const NEUS_MCP_URL = 'https://mcp.neus.network/mcp';
-export const NEUS_SETUP_CLI = 'npx -y -p @neus/sdk neus setup';
-export const NEUS_AUTH_CLI = 'npx -y -p @neus/sdk neus auth';
-export const NEUS_MCP_SETUP_DOCS_URL = 'https://docs.neus.network/mcp/ide-plugin';
+export const NEUS_MCP_SETUP_DOCS_URL = 'https://docs.neus.network/mcp/setup';
 
 /** CLI `neus setup --client` values. */
 export const MCP_INSTALL_CLIENTS = ['claude', 'codex', 'cursor', 'vscode'];
@@ -18,13 +47,13 @@ export const MCP_INSTALL_HOSTS = ['cursor', 'claude', 'codex'];
 export const IDE_HOST_LABELS = {
   cursor: 'Cursor',
   claude: 'Claude Code',
-  codex: 'Codex'
+  codex: 'Codex',
 };
 
 export const IDE_HOST_BRAND_LOGOS = {
   cursor: '/images/brandLogos/cursor.svg',
   claude: '/images/brandLogos/anthropic.svg',
-  codex: '/images/brandLogos/openai.svg'
+  codex: '/images/brandLogos/openai.svg',
 };
 
 /**
@@ -36,7 +65,7 @@ export function buildNeusMcpHttpConfig(accessKey) {
   return {
     type: 'http',
     url: NEUS_MCP_URL,
-    ...(key ? { headers: { Authorization: `Bearer ${key}` } } : {})
+    ...(key ? { headers: { Authorization: `Bearer ${key}` } } : {}),
   };
 }
 
@@ -69,7 +98,7 @@ export function buildCursorMcpInstallUrl(accessKey) {
 export function buildVsCodeMcpInstallUrl(accessKey) {
   const payload = {
     name: NEUS_MCP_SERVER_NAME,
-    ...buildNeusMcpHttpConfig(accessKey)
+    ...buildNeusMcpHttpConfig(accessKey),
   };
   return `vscode:mcp/install?${encodeURIComponent(JSON.stringify(payload))}`;
 }
@@ -80,12 +109,13 @@ export function buildVsCodeMcpInstallUrl(accessKey) {
  */
 export function buildAuthCommandForClient(client) {
   if (client === 'codex') {
-    return `${NEUS_AUTH_CLI} --client codex`;
+    return neusCmd(`auth --client codex`);
   }
   return NEUS_AUTH_CLI;
 }
 
 /**
+ * Copy-paste block for Profile / IDE onboarding (install + setup + auth).
  * @param {'claude' | 'codex' | 'cursor' | 'vscode'} client
  * @param {string | null | undefined} accessKey
  * @returns {string}
@@ -93,10 +123,13 @@ export function buildAuthCommandForClient(client) {
 export function buildSetupCommandForClient(client, accessKey) {
   const key = String(accessKey || '').trim();
   const setup = key
-    ? `${NEUS_SETUP_CLI} --client ${client} --access-key ${key}`
-    : `${NEUS_SETUP_CLI} --client ${client}`;
-  if (key) return setup;
-  return `${setup}\n${buildAuthCommandForClient(client)}`;
+    ? neusCmd(`setup --client ${client} --access-key ${key}`)
+    : neusCmd(`setup --client ${client}`);
+  if (key) {
+    return `${NEUS_INSTALL_CLI}\n${setup}`;
+  }
+  const auth = buildAuthCommandForClient(client);
+  return `${NEUS_INSTALL_CLI}\n${setup}\n${auth}`;
 }
 
 /**
@@ -108,6 +141,15 @@ export function buildSetupCommandForHost(host, accessKey) {
   return buildSetupCommandForClient(host, accessKey);
 }
 
+/**
+ * Zero-install one-liner for landing pages and copy buttons.
+ * @param {'claude' | 'codex' | 'cursor' | 'vscode'} [client]
+ */
+export function buildSetupNpxOneLiner(client) {
+  if (!client) return NEUS_SETUP_NPX;
+  return `${NEUS_NPX} setup --client ${client}`;
+}
+
 /**
  * Cursor supports MCP install deeplinks; Codex uses CLI, not VS Code deeplinks.
  * @param {'cursor' | 'claude' | 'codex'} host

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neus/sdk",
-  "version": "1.1.6",
+  "version": "1.2.0",
   "description": "NEUS makes trust portable across the internet — so people, apps, and AI agents can prove what is real before access, payout, or execution.",
   "bin": {
     "neus": "cli/neus.mjs"
@@ -31,10 +31,22 @@
       "import": "./gates.js",
       "require": "./cjs/gates.cjs"
     },
+    "./cli-commands": {
+      "import": "./cli-commands.js",
+      "require": "./cjs/cli-commands.cjs"
+    },
     "./mcp-hosts": {
       "import": "./mcp-hosts.js",
       "require": "./cjs/mcp-hosts.cjs"
     },
+    "./runtime-mount": {
+      "import": "./runtime-mount.js",
+      "require": "./cjs/runtime-mount.cjs"
+    },
+    "./runtime-adapters": {
+      "import": "./runtime-adapters.js",
+      "require": "./cjs/runtime-adapters.cjs"
+    },
     "./widgets": {
       "types": "./types.d.ts",
       "import": "./widgets/index.js",
@@ -54,7 +66,7 @@
     "format": "prettier --write \"**/*.js\"",
     "build": "npm run build:widgets && npm run build:cjs",
     "build:widgets": "npx esbuild widgets/verify-gate/VerifyGate.jsx widgets/verify-gate/ProofBadge.jsx --bundle --platform=browser --format=esm --outdir=widgets/verify-gate/dist --jsx=automatic --legal-comments=none --external:react --external:react-dom --external:react/jsx-runtime --external:@neus/sdk/client",
-    "build:cjs": "npx esbuild index.js client.js utils.js errors.js gates.js mcp-hosts.js --bundle --platform=node --format=cjs --outdir=cjs --out-extension:.js=.cjs --legal-comments=none --external:ethers --external:@zkpassport/sdk --external:react --external:react-dom --external:react/jsx-runtime",
+    "build:cjs": "npx esbuild index.js client.js utils.js errors.js gates.js cli-commands.js mcp-hosts.js runtime-mount.js runtime-adapters.js --bundle --platform=node --format=cjs --outdir=cjs --out-extension:.js=.cjs --legal-comments=none --external:ethers --external:@zkpassport/sdk --external:react --external:react-dom --external:react/jsx-runtime",
     "prepack": "npm run build",
     "prepublishOnly": "npm run lint && npm test && npm run build"
   },
@@ -113,6 +125,9 @@
   "optionalDependencies": {
     "@zkpassport/sdk": "^0.14.0"
   },
+  "overrides": {
+    "ws": "8.21.0"
+  },
   "dependencies": {
     "bs58": "^6.0.0"
   },

package/types.d.ts

@@ -462,7 +462,7 @@
     maxAgeMs?: number;
   }
 
-  /** Public snapshot returned by GET /api/v1/gates/{gateId} — never includes the secret reward value. */
+  /** Public snapshot returned by GET /api/v1/profile/gates/{gateId} — never includes the secret reward value. */
   export interface PublicGateSnapshot {
     schemaVersion: number;
     gateId: string;
@@ -1170,3 +1170,92 @@ declare module '@neus/sdk/mcp-hosts' {
   export function buildSetupCommandForHost(host: McpInstallHost, accessKey?: string | null): string;
   export function supportsMcpInstallDeeplink(host: McpInstallHost): boolean;
 }
+
+declare module '@neus/sdk/runtime-mount' {
+  export const RUNTIME_MOUNT_SCHEMA: 'neus.runtime-mount.v1';
+
+  export interface RuntimeBundleTrust {
+    identityQHash?: string;
+    delegationQHash?: string;
+    identityUrl?: string;
+    delegationUrl?: string;
+  }
+
+  export interface RuntimeBundleIdentity {
+    agentId: string;
+    agentWallet: string;
+    displayName?: string;
+    capabilities?: string[];
+    identityQHash?: string;
+  }
+
+  export interface RuntimeBundleDelegation {
+    delegationQHash?: string;
+    controllerWallet?: string;
+    allowedActions?: string[];
+    deniedActions?: string[];
+    expiresAt?: number | null;
+  }
+
+  export interface RuntimeBundle {
+    schema: typeof RUNTIME_MOUNT_SCHEMA;
+    mountedAt: string;
+    trust: RuntimeBundleTrust;
+    identity: RuntimeBundleIdentity;
+    delegation: RuntimeBundleDelegation;
+    effectiveRuntime?: Record<string, unknown>;
+    tools?: string[];
+    secretBindings?: Array<Record<string, unknown>>;
+    enforce?: Record<string, unknown>;
+    contextPack?: Record<string, unknown>;
+  }
+
+  export function normalizeWallet(value: string | null | undefined): string;
+  export function isDelegationExpired(expiresAt: number | null | undefined): boolean;
+  export function pickIdentity(
+    identities: Array<Record<string, unknown>>,
+    selector: { agentId?: string; agentWallet?: string; identityQHash?: string },
+  ): Record<string, unknown> | null;
+  export function pickActiveDelegation(
+    delegations: Array<Record<string, unknown>>,
+    controllerWallet: string,
+    agentWallet: string,
+    agentId: string,
+  ): Record<string, unknown> | null;
+  export function extractAgentContextFromProofs(proofs: unknown): {
+    identities: Array<Record<string, unknown>>;
+    delegations: Array<Record<string, unknown>>;
+  };
+  export function buildRuntimeBundle(input: Record<string, unknown>): RuntimeBundle;
+  export function resolveRuntimeBundleFromMcp(
+    mcpClient: { callTool: (name: string, args?: Record<string, unknown>) => Promise<unknown> },
+    selector: { agentId?: string; agentWallet?: string; identityQHash?: string }
+  ): Promise<RuntimeBundle>;
+
+  export function evaluateMountFileHealth(
+    manifest: RuntimeBundle | Record<string, unknown> | null | undefined
+  ): {
+    mountFileValid: boolean;
+    missingDelegation: boolean;
+    delegationExpired: boolean;
+    needsRefresh: boolean;
+    reason: string | null;
+  };
+}
+
+declare module '@neus/sdk/runtime-adapters' {
+  import type { RuntimeBundle } from '@neus/sdk/runtime-mount';
+
+  export type RuntimeAdapterHost = 'cursor' | 'claude' | 'codex';
+
+  export interface ApplyRuntimeBundleResult {
+    mountPath: string;
+    adapterFiles: string[];
+  }
+
+  export function applyRuntimeBundle(
+    host: RuntimeAdapterHost,
+    bundle: RuntimeBundle,
+    projectRoot: string
+  ): Promise<ApplyRuntimeBundleResult>;
+}