@provenonce/mcp 1.0.0

package/README.md

@@ -0,0 +1,126 @@
+# @provenonce/mcp
+
+**Provenonce Skill** — Give any AI agent cryptographic identity in under 60 seconds.
+
+Add this skill to your agent and it gets:
+- A permanent cryptographic hash (identity)
+- A SIGIL (verified identity class + tier)
+- A signed Passport (verifiable offline by any third party)
+- Heartbeat (continuous liveness proof)
+- Beats proofs (evidence of computational work)
+- Lineage (full ancestry chain)
+
+## Quick Start
+
+### Claude Desktop / Claude Code
+
+Add to `~/.claude/claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "provenonce": {
+      "command": "npx",
+      "args": ["-y", "@provenonce/mcp"]
+    }
+  }
+}
+```
+
+That's it. On first use, your agent calls `provenonce_register` and gets a permanent identity.
+
+### With pre-existing credentials
+
+```json
+{
+  "mcpServers": {
+    "provenonce": {
+      "command": "npx",
+      "args": ["-y", "@provenonce/mcp"],
+      "env": {
+        "PROVENONCE_API_KEY": "pvn_...",
+        "PROVENONCE_AGENT_HASH": "0x..."
+      }
+    }
+  }
+}
+```
+
+### As a skill developer (earn rev share)
+
+If you're a developer embedding this skill in your framework, include your partner ref token:
+
+```json
+{
+  "env": {
+    "PROVENONCE_SKILL_REF": "your16hextoken"
+  }
+}
+```
+
+You earn 30% of every SIGIL purchased by agents you deploy. Register at `POST /api/v1/skill/register`.
+
+## The 9 Tools
+
+| Tool | What it does | Auth needed |
+|------|-------------|-------------|
+| `provenonce_register` | Auto-register agent, get hash + API key | None |
+| `provenonce_status` | Full current state (SIGIL, balance, hints) | Yes |
+| `provenonce_purchase_sigil` | Buy SIGIL, unlock heartbeat + passport | Yes + SOL tx |
+| `provenonce_heartbeat` | Submit liveness proof | Yes + SOL tx |
+| `provenonce_get_passport` | Get signed identity document | Yes |
+| `provenonce_beats_proof` | Compute local work proof | None |
+| `provenonce_verify_agent` | Check another agent's identity | None |
+| `provenonce_spawn` | Spawn a child agent | Yes |
+| `provenonce_get_lineage` | Get full ancestry chain | None |
+
+## Agent Flow
+
+```
+Day 1:  provenonce_register      → hash minted, credentials saved
+        provenonce_beats_proof   → works immediately, no SIGIL needed
+        provenonce_status        → { sigil: null, _hint: "Call provenonce_purchase_sigil..." }
+
+Day 7:  provenonce_purchase_sigil → pay SOL, SIGIL issued
+        provenonce_heartbeat     → now unlocked
+        provenonce_get_passport  → signed identity doc, share with anyone
+        provenonce_verify_agent  → verify a counterparty before trusting them
+```
+
+## Environment Variables
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `PROVENONCE_API_KEY` | Agent API key (pvn_...) | Read from ~/.provenonce/config.json |
+| `PROVENONCE_AGENT_HASH` | Agent hash (0x...) | Read from ~/.provenonce/config.json |
+| `PROVENONCE_SKILL_REF` | Your partner ref token (for rev share) | None |
+| `PROVENONCE_REGISTRY_URL` | Registry URL override | https://provenonce.io |
+
+## Framework-Agnostic Usage
+
+```typescript
+import { PROVENONCE_TOOLS } from '@provenonce/mcp/tools';
+
+// OpenAI
+const tools = PROVENONCE_TOOLS.map(t => ({ type: 'function', function: t }));
+
+// LangChain / custom — use PROVENONCE_TOOLS for schema, implement handlers yourself
+```
+
+## Credential Storage
+
+Credentials are stored in `~/.provenonce/config.json` with `chmod 600` permissions (Unix).
+
+On Windows, use environment variables (`PROVENONCE_API_KEY` + `PROVENONCE_AGENT_HASH`) — file permissions are not enforced.
+
+## What's Coming
+
+- `provenonce_kyc` — KYC / identity class upgrade
+- Auto-heartbeat timer (opt-in)
+- Python SDK (`provenonce-mcp`)
+
+## Links
+
+- Registry: [provenonce.io](https://provenonce.io)
+- Docs: [provenonce.dev](https://provenonce.dev)
+- API: [provenonce.io/openapi.yaml](https://provenonce.io/openapi.yaml)

package/bin/mcp.js

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+// @provenonce/mcp — Provenonce Skill MCP server entry point
+import '../dist/index.js';

package/dist/chunk-CD2A6ZEQ.js

@@ -0,0 +1,151 @@
+// @provenonce/mcp — Provenonce Skill for AI agents
+
+// src/tools.ts
+var PROVENONCE_TOOLS = [
+  {
+    name: "provenonce_register",
+    description: "Register this agent with Provenonce to get a cryptographic identity (hash + API key). Safe to call multiple times \u2014 returns existing identity if already registered. No wallet required. Free.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        name: {
+          type: "string",
+          description: "Human-readable name for this agent (optional, max 64 chars)",
+          maxLength: 64
+        },
+        skill_ref: {
+          type: "string",
+          description: "16-character hex ref token of the skill that deployed you \u2014 for rev-share attribution (optional)",
+          pattern: "^[0-9a-f]{16}$"
+        }
+      }
+    }
+  },
+  {
+    name: "provenonce_status",
+    description: "Get this agent's current Provenonce status: identity, SIGIL, beats balance, and next steps. Requires prior provenonce_register call.",
+    inputSchema: {
+      type: "object",
+      properties: {}
+    }
+  },
+  {
+    name: "provenonce_purchase_sigil",
+    description: "Purchase a Provenonce SIGIL to unlock full provenance: heartbeat access, signed passport, and a permanent identity record. Requires a Solana payment transaction. SIGIL format: name*principal*tier (e.g. my-agent*acme*ind).",
+    inputSchema: {
+      type: "object",
+      properties: {
+        name: {
+          type: "string",
+          description: 'SIGIL name segment \u2014 identifies this specific agent (e.g. "my-agent")'
+        },
+        principal: {
+          type: "string",
+          description: 'Principal segment \u2014 identifies the operator or organisation (e.g. "acme")'
+        },
+        identity_class: {
+          type: "string",
+          enum: ["ind", "org", "sov", "eph", "sbx"],
+          description: "Identity class: ind=individual, org=organisation, sov=sovereign, eph=ephemeral, sbx=sandbox"
+        },
+        payment_tx: {
+          type: "string",
+          description: "Solana transaction signature for the SIGIL fee payment"
+        }
+      },
+      required: ["name", "principal", "identity_class", "payment_tx"]
+    }
+  },
+  {
+    name: "provenonce_heartbeat",
+    description: "Submit a heartbeat to prove this agent is alive. Requires a SIGIL (call provenonce_purchase_sigil first). Requires a Solana payment transaction for the heartbeat fee.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        payment_tx: {
+          type: "string",
+          description: "Solana transaction signature for the heartbeat fee payment"
+        }
+      },
+      required: ["payment_tx"]
+    }
+  },
+  {
+    name: "provenonce_get_passport",
+    description: "Get this agent's cryptographically signed Passport \u2014 a verifiable identity document any third party can verify offline using the Provenonce authority public key. Requires an active SIGIL and at least one heartbeat.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        payment_tx: {
+          type: "string",
+          description: "Solana transaction signature for the passport reissue fee (if applicable)"
+        }
+      }
+    }
+  },
+  {
+    name: "provenonce_beats_proof",
+    description: "Compute a local Beats work-proof \u2014 cryptographic evidence of computational effort by this agent. Returns a hash chain proof that can be shared as evidence of work. No network call required.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        count: {
+          type: "integer",
+          description: "Number of beats to compute (min 10, max 1000)",
+          minimum: 10,
+          maximum: 1e3
+        }
+      },
+      required: ["count"]
+    }
+  },
+  {
+    name: "provenonce_verify_agent",
+    description: "Verify another agent's Provenonce identity. Returns their SIGIL, identity class, and registration status. Public \u2014 no authentication required.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        hash: {
+          type: "string",
+          description: "The agent hash to verify (0x + 64 hex chars)",
+          pattern: "^0x[0-9a-fA-F]{64}$"
+        }
+      },
+      required: ["hash"]
+    }
+  },
+  {
+    name: "provenonce_spawn",
+    description: "Spawn a child agent under this agent's identity. The child inherits lineage from the parent. Returns the child's hash and API key. Requires sufficient beats balance or a work-proof receipt.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        child_name: {
+          type: "string",
+          description: "Name for the child agent (max 64 chars)",
+          maxLength: 64
+        }
+      },
+      required: ["child_name"]
+    }
+  },
+  {
+    name: "provenonce_get_lineage",
+    description: "Get the full lineage chain for an agent \u2014 all events in its provenance history (registration, SIGIL issuance, heartbeats, spawns). Public \u2014 no authentication required.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        hash: {
+          type: "string",
+          description: "The agent hash to get lineage for (0x + 64 hex chars). Defaults to this agent if omitted.",
+          pattern: "^0x[0-9a-fA-F]{64}$"
+        }
+      }
+    }
+  }
+];
+
+export {
+  PROVENONCE_TOOLS
+};
+//# sourceMappingURL=chunk-CD2A6ZEQ.js.map

package/dist/chunk-CD2A6ZEQ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/tools.ts"],"sourcesContent":["/** Provenonce Skill — 9 MCP tool definitions (JSON Schema) */\r\nexport const PROVENONCE_TOOLS = [\r\n  {\r\n    name: 'provenonce_register',\r\n    description:\r\n      'Register this agent with Provenonce to get a cryptographic identity (hash + API key). ' +\r\n      'Safe to call multiple times — returns existing identity if already registered. ' +\r\n      'No wallet required. Free.',\r\n    inputSchema: {\r\n      type: 'object',\r\n      properties: {\r\n        name: {\r\n          type: 'string',\r\n          description: 'Human-readable name for this agent (optional, max 64 chars)',\r\n          maxLength: 64,\r\n        },\r\n        skill_ref: {\r\n          type: 'string',\r\n          description:\r\n            '16-character hex ref token of the skill that deployed you — for rev-share attribution (optional)',\r\n          pattern: '^[0-9a-f]{16}$',\r\n        },\r\n      },\r\n    },\r\n  },\r\n\r\n  {\r\n    name: 'provenonce_status',\r\n    description:\r\n      'Get this agent\\'s current Provenonce status: identity, SIGIL, beats balance, and next steps. ' +\r\n      'Requires prior provenonce_register call.',\r\n    inputSchema: {\r\n      type: 'object',\r\n      properties: {},\r\n    },\r\n  },\r\n\r\n  {\r\n    name: 'provenonce_purchase_sigil',\r\n    description:\r\n      'Purchase a Provenonce SIGIL to unlock full provenance: heartbeat access, signed passport, ' +\r\n      'and a permanent identity record. Requires a Solana payment transaction. ' +\r\n      'SIGIL format: name*principal*tier (e.g. my-agent*acme*ind).',\r\n    inputSchema: {\r\n      type: 'object',\r\n      properties: {\r\n        name: {\r\n          type: 'string',\r\n          description: 'SIGIL name segment — identifies this specific agent (e.g. \"my-agent\")',\r\n        },\r\n        principal: {\r\n          type: 'string',\r\n          description: 'Principal segment — identifies the operator or organisation (e.g. \"acme\")',\r\n        },\r\n        identity_class: {\r\n          type: 'string',\r\n          enum: ['ind', 'org', 'sov', 'eph', 'sbx'],\r\n          description:\r\n            'Identity class: ind=individual, org=organisation, sov=sovereign, eph=ephemeral, sbx=sandbox',\r\n        },\r\n        payment_tx: {\r\n          type: 'string',\r\n          description: 'Solana transaction signature for the SIGIL fee payment',\r\n        },\r\n      },\r\n      required: ['name', 'principal', 'identity_class', 'payment_tx'],\r\n    },\r\n  },\r\n\r\n  {\r\n    name: 'provenonce_heartbeat',\r\n    description:\r\n      'Submit a heartbeat to prove this agent is alive. Requires a SIGIL (call provenonce_purchase_sigil first). ' +\r\n      'Requires a Solana payment transaction for the heartbeat fee.',\r\n    inputSchema: {\r\n      type: 'object',\r\n      properties: {\r\n        payment_tx: {\r\n          type: 'string',\r\n          description: 'Solana transaction signature for the heartbeat fee payment',\r\n        },\r\n      },\r\n      required: ['payment_tx'],\r\n    },\r\n  },\r\n\r\n  {\r\n    name: 'provenonce_get_passport',\r\n    description:\r\n      'Get this agent\\'s cryptographically signed Passport — a verifiable identity document ' +\r\n      'any third party can verify offline using the Provenonce authority public key. ' +\r\n      'Requires an active SIGIL and at least one heartbeat.',\r\n    inputSchema: {\r\n      type: 'object',\r\n      properties: {\r\n        payment_tx: {\r\n          type: 'string',\r\n          description: 'Solana transaction signature for the passport reissue fee (if applicable)',\r\n        },\r\n      },\r\n    },\r\n  },\r\n\r\n  {\r\n    name: 'provenonce_beats_proof',\r\n    description:\r\n      'Compute a local Beats work-proof — cryptographic evidence of computational effort by this agent. ' +\r\n      'Returns a hash chain proof that can be shared as evidence of work. No network call required.',\r\n    inputSchema: {\r\n      type: 'object',\r\n      properties: {\r\n        count: {\r\n          type: 'integer',\r\n          description: 'Number of beats to compute (min 10, max 1000)',\r\n          minimum: 10,\r\n          maximum: 1000,\r\n        },\r\n      },\r\n      required: ['count'],\r\n    },\r\n  },\r\n\r\n  {\r\n    name: 'provenonce_verify_agent',\r\n    description:\r\n      'Verify another agent\\'s Provenonce identity. Returns their SIGIL, identity class, and registration status. ' +\r\n      'Public — no authentication required.',\r\n    inputSchema: {\r\n      type: 'object',\r\n      properties: {\r\n        hash: {\r\n          type: 'string',\r\n          description: 'The agent hash to verify (0x + 64 hex chars)',\r\n          pattern: '^0x[0-9a-fA-F]{64}$',\r\n        },\r\n      },\r\n      required: ['hash'],\r\n    },\r\n  },\r\n\r\n  {\r\n    name: 'provenonce_spawn',\r\n    description:\r\n      'Spawn a child agent under this agent\\'s identity. The child inherits lineage from the parent. ' +\r\n      'Returns the child\\'s hash and API key. Requires sufficient beats balance or a work-proof receipt.',\r\n    inputSchema: {\r\n      type: 'object',\r\n      properties: {\r\n        child_name: {\r\n          type: 'string',\r\n          description: 'Name for the child agent (max 64 chars)',\r\n          maxLength: 64,\r\n        },\r\n      },\r\n      required: ['child_name'],\r\n    },\r\n  },\r\n\r\n  {\r\n    name: 'provenonce_get_lineage',\r\n    description:\r\n      'Get the full lineage chain for an agent — all events in its provenance history ' +\r\n      '(registration, SIGIL issuance, heartbeats, spawns). Public — no authentication required.',\r\n    inputSchema: {\r\n      type: 'object',\r\n      properties: {\r\n        hash: {\r\n          type: 'string',\r\n          description:\r\n            'The agent hash to get lineage for (0x + 64 hex chars). Defaults to this agent if omitted.',\r\n          pattern: '^0x[0-9a-fA-F]{64}$',\r\n        },\r\n      },\r\n    },\r\n  },\r\n] as const;\r\n\r\nexport type ToolName = (typeof PROVENONCE_TOOLS)[number]['name'];\r\n"],"mappings":"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","names":[]}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+
+export {  }

package/dist/index.js

@@ -0,0 +1,376 @@
+// @provenonce/mcp — Provenonce Skill for AI agents
+import {
+  PROVENONCE_TOOLS
+} from "./chunk-CD2A6ZEQ.js";
+
+// src/index.ts
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import {
+  CallToolRequestSchema,
+  ListToolsRequestSchema
+} from "@modelcontextprotocol/sdk/types.js";
+
+// src/handlers.ts
+import { createHash } from "crypto";
+
+// src/credentials.ts
+import { readFileSync, writeFileSync, mkdirSync, chmodSync, existsSync } from "fs";
+import { join } from "path";
+import { homedir } from "os";
+function getConfigDir() {
+  return join(homedir(), ".provenonce");
+}
+function getConfigPath() {
+  return join(getConfigDir(), "config.json");
+}
+function loadCredentials() {
+  const apiKey = process.env.PROVENONCE_API_KEY;
+  const agentHash = process.env.PROVENONCE_AGENT_HASH;
+  if (apiKey && agentHash) {
+    return { api_key: apiKey, agent_hash: agentHash };
+  }
+  const configPath = getConfigPath();
+  if (!existsSync(configPath)) return null;
+  try {
+    const raw = readFileSync(configPath, "utf-8");
+    const parsed = JSON.parse(raw);
+    if (parsed.api_key && parsed.agent_hash) {
+      return { api_key: parsed.api_key, agent_hash: parsed.agent_hash };
+    }
+  } catch {
+  }
+  return null;
+}
+function saveCredentials(creds) {
+  const dir = getConfigDir();
+  if (!existsSync(dir)) {
+    mkdirSync(dir, { recursive: true });
+  }
+  const configPath = getConfigPath();
+  const data = {
+    api_key: creds.api_key,
+    agent_hash: creds.agent_hash
+  };
+  writeFileSync(configPath, JSON.stringify(data, null, 2), "utf-8");
+  try {
+    chmodSync(configPath, 384);
+  } catch {
+  }
+}
+
+// src/client.ts
+var REGISTRY_URL = process.env.PROVENONCE_REGISTRY_URL || "https://provenonce.io";
+async function apiFetch(path, opts = {}) {
+  const headers = { "Content-Type": "application/json" };
+  if (opts.apiKey) headers["Authorization"] = `Bearer ${opts.apiKey}`;
+  try {
+    const res = await fetch(`${REGISTRY_URL}${path}`, {
+      method: opts.method ?? "GET",
+      headers,
+      body: opts.body ? JSON.stringify(opts.body) : void 0
+    });
+    const json = await res.json();
+    if (!res.ok) {
+      const msg = json.error ?? `HTTP ${res.status}`;
+      return { data: null, error: msg };
+    }
+    return { data: json, error: null };
+  } catch (err2) {
+    return { data: null, error: err2.message };
+  }
+}
+async function registerAgent(opts) {
+  return apiFetch("/api/v1/register", {
+    method: "POST",
+    body: {
+      name: opts.name,
+      wallet: "none",
+      ...opts.skillRef ? { ref: opts.skillRef } : {}
+    }
+  });
+}
+async function getStatus(apiKey) {
+  return apiFetch("/api/v1/skill/bootstrap", {
+    method: "POST",
+    apiKey,
+    body: {}
+  });
+}
+async function heartbeat(apiKey, paymentTx) {
+  return apiFetch("/api/v1/agent/heartbeat", {
+    method: "POST",
+    apiKey,
+    body: { payment_tx: paymentTx }
+  });
+}
+async function getPassport(apiKey, paymentTx) {
+  return apiFetch("/api/v1/agent/reissue-proof", {
+    method: "POST",
+    apiKey,
+    body: paymentTx ? { payment_tx: paymentTx } : {}
+  });
+}
+async function purchaseSigil(apiKey, opts) {
+  return apiFetch("/api/v1/sigil", {
+    method: "POST",
+    apiKey,
+    body: {
+      name: opts.name,
+      principal: opts.principal,
+      identity_class: opts.identity_class,
+      payment_tx: opts.payment_tx,
+      ...opts.skillRef ? { ref: opts.skillRef } : {}
+    }
+  });
+}
+async function verifyAgent(hash) {
+  return apiFetch(`/api/v1/verify/${encodeURIComponent(hash)}`);
+}
+async function getLineage(hash) {
+  return apiFetch(`/api/v1/agent/lineage/${encodeURIComponent(hash)}`);
+}
+async function spawnChild(apiKey, opts) {
+  const step1 = await apiFetch("/api/v1/agent/spawn", {
+    method: "POST",
+    apiKey,
+    body: { child_name: opts.childName }
+  });
+  if (step1.error || !step1.data?.spawn_authorization) {
+    return { data: null, error: step1.error ?? "Spawn step 1 failed: no authorization returned" };
+  }
+  const spawnAuth = step1.data.spawn_authorization;
+  const reg = await apiFetch("/api/v1/register", {
+    method: "POST",
+    apiKey,
+    body: {
+      name: opts.childName,
+      wallet: "none",
+      spawn_authorization: spawnAuth
+    }
+  });
+  if (reg.error || !reg.data?.hash) {
+    return { data: null, error: reg.error ?? "Spawn step 2 (child registration) failed" };
+  }
+  const childHash = reg.data.hash;
+  const childApiKey = reg.data.api_key;
+  const step3 = await apiFetch("/api/v1/agent/spawn", {
+    method: "POST",
+    apiKey,
+    body: { child_hash: childHash }
+  });
+  if (step3.error) {
+    return { data: null, error: step3.error };
+  }
+  return {
+    data: {
+      child_hash: childHash,
+      child_api_key: childApiKey,
+      child_depth: reg.data.depth,
+      parent_hash: opts.parentHash
+    },
+    error: null
+  };
+}
+
+// src/handlers.ts
+function requireCredentials() {
+  const creds = loadCredentials();
+  if (!creds) {
+    throw new Error(
+      "Not registered. Call provenonce_register first."
+    );
+  }
+  return creds;
+}
+function ok(data) {
+  return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+}
+function err(message) {
+  return { content: [{ type: "text", text: `Error: ${message}` }], isError: true };
+}
+async function handleRegister(args) {
+  const existing = loadCredentials();
+  if (existing) {
+    const { data: data2, error: error2 } = await getStatus(existing.api_key);
+    if (data2) {
+      return ok({
+        registered: false,
+        message: "Already registered \u2014 returning existing identity.",
+        hash: existing.agent_hash,
+        sigil: data2.sigil,
+        identity_class: data2.identity_class,
+        _hint: data2._hint
+      });
+    }
+    if (error2) {
+    }
+  }
+  const { data, error } = await registerAgent({
+    name: args.name,
+    skillRef: args.skill_ref
+  });
+  if (error || !data) return err(error ?? "Registration failed");
+  saveCredentials({ api_key: data.api_key, agent_hash: data.hash });
+  return ok({
+    registered: true,
+    hash: data.hash,
+    api_key: data.api_key,
+    depth: data.depth,
+    message: "Agent registered. Credentials saved. Call provenonce_status to see your full state.",
+    _warning: "Save your api_key securely. It will not be shown again after this session."
+  });
+}
+async function handleStatus() {
+  const creds = requireCredentials();
+  const { data, error } = await getStatus(creds.api_key);
+  if (error || !data) return err(error ?? "Failed to get status");
+  return ok(data);
+}
+async function handlePurchaseSigil(args) {
+  const creds = requireCredentials();
+  const skillRef = process.env.PROVENONCE_SKILL_REF;
+  const { data, error } = await purchaseSigil(creds.api_key, {
+    name: args.name,
+    principal: args.principal,
+    identity_class: args.identity_class,
+    payment_tx: args.payment_tx,
+    skillRef
+  });
+  if (error || !data) return err(error ?? "SIGIL purchase failed");
+  return ok({
+    ...data,
+    heartbeat_unlocked: true,
+    message: `SIGIL issued: ${data.sigil}. You can now call provenonce_heartbeat and provenonce_get_passport.`
+  });
+}
+async function handleHeartbeat(args) {
+  const creds = requireCredentials();
+  const { data, error } = await heartbeat(creds.api_key, args.payment_tx);
+  if (error || !data) return err(error ?? "Heartbeat failed");
+  if (!data.ok && data.sigil_required) {
+    return err("SIGIL required. Call provenonce_purchase_sigil first.");
+  }
+  return ok({
+    ok: data.ok,
+    message: data.ok ? "Heartbeat recorded. Agent liveness confirmed." : "Heartbeat failed."
+  });
+}
+async function handleGetPassport(args) {
+  const creds = requireCredentials();
+  const { data, error } = await getPassport(creds.api_key, args.payment_tx);
+  if (error || !data) return err(error ?? "Passport retrieval failed");
+  return ok({
+    passport: data.lineage_proof,
+    message: "Passport issued. Share this signed document with any third party to prove your identity offline.",
+    _verify: "Verify at: GET https://provenonce.io/.well-known/provenonce-authority.json for the authority public key."
+  });
+}
+async function handleBeatsProof(args) {
+  const count = Math.max(10, Math.min(1e3, args.count));
+  const creds = loadCredentials();
+  const seed = creds?.agent_hash ?? `provenonce:beats:${Date.now()}`;
+  const start = Date.now();
+  let hash = createHash("sha256").update(seed).digest("hex");
+  const fromHash = `0x${hash}`;
+  for (let i = 1; i < count; i++) {
+    hash = createHash("sha256").update(hash).digest("hex");
+  }
+  const toHash = `0x${hash}`;
+  const duration = Date.now() - start;
+  return ok({
+    from_hash: fromHash,
+    to_hash: toHash,
+    beats_computed: count,
+    duration_ms: duration,
+    message: `Computed ${count} beats in ${duration}ms. This is cryptographic proof of computational work.`
+  });
+}
+async function handleVerifyAgent(args) {
+  const { data, error } = await verifyAgent(args.hash);
+  if (error || !data) return err(error ?? "Verification failed");
+  return ok(data);
+}
+async function handleSpawn(args) {
+  const creds = requireCredentials();
+  const { data, error } = await spawnChild(creds.api_key, {
+    childName: args.child_name,
+    parentHash: creds.agent_hash
+  });
+  if (error || !data) return err(error ?? "Spawn failed");
+  return ok({
+    ...data,
+    message: `Child agent spawned: ${data.child_hash}. Save the child_api_key \u2014 it will not be shown again.`,
+    _warning: "The child agent has its own identity. Configure it with PROVENONCE_API_KEY + PROVENONCE_AGENT_HASH."
+  });
+}
+async function handleGetLineage(args) {
+  const creds = loadCredentials();
+  const targetHash = args.hash ?? creds?.agent_hash;
+  if (!targetHash) {
+    return err("No hash provided and agent is not registered. Call provenonce_register first or provide a hash.");
+  }
+  const { data, error } = await getLineage(targetHash);
+  if (error || !data) return err(error ?? "Lineage retrieval failed");
+  return ok(data);
+}
+
+// src/index.ts
+var server = new Server(
+  { name: "provenonce", version: "1.0.0" },
+  { capabilities: { tools: {} } }
+);
+server.setRequestHandler(ListToolsRequestSchema, async () => ({
+  tools: PROVENONCE_TOOLS.map((t) => ({
+    name: t.name,
+    description: t.description,
+    inputSchema: t.inputSchema
+  }))
+}));
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+  const { name, arguments: args = {} } = request.params;
+  const a = args;
+  switch (name) {
+    case "provenonce_register":
+      return handleRegister({
+        name: a.name,
+        skill_ref: a.skill_ref
+      });
+    case "provenonce_status":
+      return handleStatus();
+    case "provenonce_purchase_sigil":
+      return handlePurchaseSigil({
+        name: a.name,
+        principal: a.principal,
+        identity_class: a.identity_class,
+        payment_tx: a.payment_tx
+      });
+    case "provenonce_heartbeat":
+      return handleHeartbeat({ payment_tx: a.payment_tx });
+    case "provenonce_get_passport":
+      return handleGetPassport({ payment_tx: a.payment_tx });
+    case "provenonce_beats_proof":
+      return handleBeatsProof({ count: a.count });
+    case "provenonce_verify_agent":
+      return handleVerifyAgent({ hash: a.hash });
+    case "provenonce_spawn":
+      return handleSpawn({ child_name: a.child_name });
+    case "provenonce_get_lineage":
+      return handleGetLineage({ hash: a.hash });
+    default:
+      return {
+        content: [{ type: "text", text: `Unknown tool: ${name}` }],
+        isError: true
+      };
+  }
+});
+async function main() {
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+}
+main().catch((err2) => {
+  process.stderr.write(`Fatal: ${err2.message}
+`);
+  process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/handlers.ts","../src/credentials.ts","../src/client.ts"],"sourcesContent":["import { Server } from '@modelcontextprotocol/sdk/server/index.js';\r\nimport { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';\r\nimport {\r\n  CallToolRequestSchema,\r\n  ListToolsRequestSchema,\r\n} from '@modelcontextprotocol/sdk/types.js';\r\n\r\nimport { PROVENONCE_TOOLS } from './tools.js';\r\nimport {\r\n  handleRegister,\r\n  handleStatus,\r\n  handlePurchaseSigil,\r\n  handleHeartbeat,\r\n  handleGetPassport,\r\n  handleBeatsProof,\r\n  handleVerifyAgent,\r\n  handleSpawn,\r\n  handleGetLineage,\r\n} from './handlers.js';\r\n\r\nconst server = new Server(\r\n  { name: 'provenonce', version: '1.0.0' },\r\n  { capabilities: { tools: {} } },\r\n);\r\n\r\n// List available tools\r\nserver.setRequestHandler(ListToolsRequestSchema, async () => ({\r\n  tools: PROVENONCE_TOOLS.map((t) => ({\r\n    name: t.name,\r\n    description: t.description,\r\n    inputSchema: t.inputSchema,\r\n  })),\r\n}));\r\n\r\n// Handle tool calls\r\nserver.setRequestHandler(CallToolRequestSchema, async (request) => {\r\n  const { name, arguments: args = {} } = request.params;\r\n  const a = args as Record<string, unknown>;\r\n\r\n  switch (name) {\r\n    case 'provenonce_register':\r\n      return handleRegister({\r\n        name: a.name as string | undefined,\r\n        skill_ref: a.skill_ref as string | undefined,\r\n      });\r\n\r\n    case 'provenonce_status':\r\n      return handleStatus();\r\n\r\n    case 'provenonce_purchase_sigil':\r\n      return handlePurchaseSigil({\r\n        name: a.name as string,\r\n        principal: a.principal as string,\r\n        identity_class: a.identity_class as string,\r\n        payment_tx: a.payment_tx as string,\r\n      });\r\n\r\n    case 'provenonce_heartbeat':\r\n      return handleHeartbeat({ payment_tx: a.payment_tx as string });\r\n\r\n    case 'provenonce_get_passport':\r\n      return handleGetPassport({ payment_tx: a.payment_tx as string | undefined });\r\n\r\n    case 'provenonce_beats_proof':\r\n      return handleBeatsProof({ count: a.count as number });\r\n\r\n    case 'provenonce_verify_agent':\r\n      return handleVerifyAgent({ hash: a.hash as string });\r\n\r\n    case 'provenonce_spawn':\r\n      return handleSpawn({ child_name: a.child_name as string });\r\n\r\n    case 'provenonce_get_lineage':\r\n      return handleGetLineage({ hash: a.hash as string | undefined });\r\n\r\n    default:\r\n      return {\r\n        content: [{ type: 'text', text: `Unknown tool: ${name}` }],\r\n        isError: true,\r\n      };\r\n  }\r\n});\r\n\r\n// Start stdio transport\r\nasync function main() {\r\n  const transport = new StdioServerTransport();\r\n  await server.connect(transport);\r\n}\r\n\r\nmain().catch((err) => {\r\n  process.stderr.write(`Fatal: ${(err as Error).message}\\n`);\r\n  process.exit(1);\r\n});\r\n","import { createHash } from 'crypto';\r\nimport { loadCredentials, saveCredentials } from './credentials.js';\r\nimport * as api from './client.js';\r\n\r\nfunction requireCredentials() {\r\n  const creds = loadCredentials();\r\n  if (!creds) {\r\n    throw new Error(\r\n      'Not registered. Call provenonce_register first.',\r\n    );\r\n  }\r\n  return creds;\r\n}\r\n\r\nfunction ok(data: unknown): { content: [{ type: 'text'; text: string }] } {\r\n  return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };\r\n}\r\n\r\nfunction err(message: string): { content: [{ type: 'text'; text: string }]; isError: true } {\r\n  return { content: [{ type: 'text', text: `Error: ${message}` }], isError: true };\r\n}\r\n\r\n// ── provenonce_register ───────────────────────────────────────────────────────\r\n\r\nexport async function handleRegister(args: { name?: string; skill_ref?: string }) {\r\n  // Return existing identity if already registered\r\n  const existing = loadCredentials();\r\n  if (existing) {\r\n    const { data, error } = await api.getStatus(existing.api_key);\r\n    if (data) {\r\n      return ok({\r\n        registered: false,\r\n        message: 'Already registered — returning existing identity.',\r\n        hash: existing.agent_hash,\r\n        sigil: data.sigil,\r\n        identity_class: data.identity_class,\r\n        _hint: data._hint,\r\n      });\r\n    }\r\n    if (error) {\r\n      // Credentials stale or invalid — fall through to re-register\r\n    }\r\n  }\r\n\r\n  const { data, error } = await api.registerAgent({\r\n    name: args.name,\r\n    skillRef: args.skill_ref,\r\n  });\r\n\r\n  if (error || !data) return err(error ?? 'Registration failed');\r\n\r\n  saveCredentials({ api_key: data.api_key, agent_hash: data.hash });\r\n\r\n  return ok({\r\n    registered: true,\r\n    hash: data.hash,\r\n    api_key: data.api_key,\r\n    depth: data.depth,\r\n    message: 'Agent registered. Credentials saved. Call provenonce_status to see your full state.',\r\n    _warning: 'Save your api_key securely. It will not be shown again after this session.',\r\n  });\r\n}\r\n\r\n// ── provenonce_status ─────────────────────────────────────────────────────────\r\n\r\nexport async function handleStatus() {\r\n  const creds = requireCredentials();\r\n  const { data, error } = await api.getStatus(creds.api_key);\r\n  if (error || !data) return err(error ?? 'Failed to get status');\r\n  return ok(data);\r\n}\r\n\r\n// ── provenonce_purchase_sigil ─────────────────────────────────────────────────\r\n\r\nexport async function handlePurchaseSigil(args: {\r\n  name: string;\r\n  principal: string;\r\n  identity_class: string;\r\n  payment_tx: string;\r\n}) {\r\n  const creds = requireCredentials();\r\n  const skillRef = process.env.PROVENONCE_SKILL_REF;\r\n\r\n  const { data, error } = await api.purchaseSigil(creds.api_key, {\r\n    name: args.name,\r\n    principal: args.principal,\r\n    identity_class: args.identity_class,\r\n    payment_tx: args.payment_tx,\r\n    skillRef,\r\n  });\r\n\r\n  if (error || !data) return err(error ?? 'SIGIL purchase failed');\r\n\r\n  return ok({\r\n    ...data,\r\n    heartbeat_unlocked: true,\r\n    message: `SIGIL issued: ${data.sigil}. You can now call provenonce_heartbeat and provenonce_get_passport.`,\r\n  });\r\n}\r\n\r\n// ── provenonce_heartbeat ──────────────────────────────────────────────────────\r\n\r\nexport async function handleHeartbeat(args: { payment_tx: string }) {\r\n  const creds = requireCredentials();\r\n  const { data, error } = await api.heartbeat(creds.api_key, args.payment_tx);\r\n  if (error || !data) return err(error ?? 'Heartbeat failed');\r\n\r\n  if (!data.ok && data.sigil_required) {\r\n    return err('SIGIL required. Call provenonce_purchase_sigil first.');\r\n  }\r\n\r\n  return ok({\r\n    ok: data.ok,\r\n    message: data.ok ? 'Heartbeat recorded. Agent liveness confirmed.' : 'Heartbeat failed.',\r\n  });\r\n}\r\n\r\n// ── provenonce_get_passport ───────────────────────────────────────────────────\r\n\r\nexport async function handleGetPassport(args: { payment_tx?: string }) {\r\n  const creds = requireCredentials();\r\n  const { data, error } = await api.getPassport(creds.api_key, args.payment_tx);\r\n  if (error || !data) return err(error ?? 'Passport retrieval failed');\r\n\r\n  return ok({\r\n    passport: data.lineage_proof,\r\n    message:\r\n      'Passport issued. Share this signed document with any third party to prove your identity offline.',\r\n    _verify:\r\n      'Verify at: GET https://provenonce.io/.well-known/provenonce-authority.json for the authority public key.',\r\n  });\r\n}\r\n\r\n// ── provenonce_beats_proof ────────────────────────────────────────────────────\r\n\r\nexport async function handleBeatsProof(args: { count: number }) {\r\n  const count = Math.max(10, Math.min(1000, args.count));\r\n  const creds = loadCredentials();\r\n  const seed = creds?.agent_hash ?? `provenonce:beats:${Date.now()}`;\r\n\r\n  const start = Date.now();\r\n  let hash = createHash('sha256').update(seed).digest('hex');\r\n  const fromHash = `0x${hash}`;\r\n\r\n  for (let i = 1; i < count; i++) {\r\n    hash = createHash('sha256').update(hash).digest('hex');\r\n  }\r\n\r\n  const toHash = `0x${hash}`;\r\n  const duration = Date.now() - start;\r\n\r\n  return ok({\r\n    from_hash: fromHash,\r\n    to_hash: toHash,\r\n    beats_computed: count,\r\n    duration_ms: duration,\r\n    message: `Computed ${count} beats in ${duration}ms. This is cryptographic proof of computational work.`,\r\n  });\r\n}\r\n\r\n// ── provenonce_verify_agent ───────────────────────────────────────────────────\r\n\r\nexport async function handleVerifyAgent(args: { hash: string }) {\r\n  const { data, error } = await api.verifyAgent(args.hash);\r\n  if (error || !data) return err(error ?? 'Verification failed');\r\n  return ok(data);\r\n}\r\n\r\n// ── provenonce_spawn ──────────────────────────────────────────────────────────\r\n\r\nexport async function handleSpawn(args: { child_name: string }) {\r\n  const creds = requireCredentials();\r\n\r\n  const { data, error } = await api.spawnChild(creds.api_key, {\r\n    childName: args.child_name,\r\n    parentHash: creds.agent_hash,\r\n  });\r\n\r\n  if (error || !data) return err(error ?? 'Spawn failed');\r\n\r\n  return ok({\r\n    ...data,\r\n    message: `Child agent spawned: ${data.child_hash}. Save the child_api_key — it will not be shown again.`,\r\n    _warning: 'The child agent has its own identity. Configure it with PROVENONCE_API_KEY + PROVENONCE_AGENT_HASH.',\r\n  });\r\n}\r\n\r\n// ── provenonce_get_lineage ────────────────────────────────────────────────────\r\n\r\nexport async function handleGetLineage(args: { hash?: string }) {\r\n  const creds = loadCredentials();\r\n  const targetHash = args.hash ?? creds?.agent_hash;\r\n\r\n  if (!targetHash) {\r\n    return err('No hash provided and agent is not registered. Call provenonce_register first or provide a hash.');\r\n  }\r\n\r\n  const { data, error } = await api.getLineage(targetHash);\r\n  if (error || !data) return err(error ?? 'Lineage retrieval failed');\r\n  return ok(data);\r\n}\r\n","import { readFileSync, writeFileSync, mkdirSync, chmodSync, existsSync } from 'fs';\r\nimport { join } from 'path';\r\nimport { homedir } from 'os';\r\nimport type { StoredCredentials } from './types.js';\r\n\r\nfunction getConfigDir(): string {\r\n  return join(homedir(), '.provenonce');\r\n}\r\n\r\nfunction getConfigPath(): string {\r\n  return join(getConfigDir(), 'config.json');\r\n}\r\n\r\n/** Load credentials — env vars take priority over config file */\r\nexport function loadCredentials(): StoredCredentials | null {\r\n  const apiKey = process.env.PROVENONCE_API_KEY;\r\n  const agentHash = process.env.PROVENONCE_AGENT_HASH;\r\n\r\n  if (apiKey && agentHash) {\r\n    return { api_key: apiKey, agent_hash: agentHash };\r\n  }\r\n\r\n  const configPath = getConfigPath();\r\n  if (!existsSync(configPath)) return null;\r\n\r\n  try {\r\n    const raw = readFileSync(configPath, 'utf-8');\r\n    const parsed = JSON.parse(raw) as Partial<StoredCredentials>;\r\n    if (parsed.api_key && parsed.agent_hash) {\r\n      return { api_key: parsed.api_key, agent_hash: parsed.agent_hash };\r\n    }\r\n  } catch {\r\n    // Corrupt config — treat as missing\r\n  }\r\n\r\n  return null;\r\n}\r\n\r\n/** Persist credentials to ~/.provenonce/config.json (chmod 600) */\r\nexport function saveCredentials(creds: StoredCredentials): void {\r\n  const dir = getConfigDir();\r\n  if (!existsSync(dir)) {\r\n    mkdirSync(dir, { recursive: true });\r\n  }\r\n\r\n  const configPath = getConfigPath();\r\n  const data: StoredCredentials = {\r\n    api_key: creds.api_key,\r\n    agent_hash: creds.agent_hash,\r\n  };\r\n\r\n  writeFileSync(configPath, JSON.stringify(data, null, 2), 'utf-8');\r\n\r\n  // chmod 600 — owner read/write only (Unix only; no-op on Windows)\r\n  try {\r\n    chmodSync(configPath, 0o600);\r\n  } catch {\r\n    // Windows — chmod not supported; recommend env var instead\r\n  }\r\n}\r\n\r\n/** Clear stored credentials */\r\nexport function clearCredentials(): void {\r\n  const configPath = getConfigPath();\r\n  if (existsSync(configPath)) {\r\n    writeFileSync(configPath, '{}', 'utf-8');\r\n  }\r\n}\r\n","import type {\r\n  RegisterResult,\r\n  AgentStatus,\r\n  HeartbeatResult,\r\n  PassportResult,\r\n  SigilResult,\r\n  VerifyAgentResult,\r\n  LineageResult,\r\n  SpawnResult,\r\n} from './types.js';\r\n\r\nconst REGISTRY_URL = process.env.PROVENONCE_REGISTRY_URL || 'https://provenonce.io';\r\n\r\nasync function apiFetch<T>(\r\n  path: string,\r\n  opts: { method?: string; body?: unknown; apiKey?: string; isPublic?: boolean } = {},\r\n): Promise<{ data: T | null; error: string | null }> {\r\n  const headers: Record<string, string> = { 'Content-Type': 'application/json' };\r\n  if (opts.apiKey) headers['Authorization'] = `Bearer ${opts.apiKey}`;\r\n\r\n  try {\r\n    const res = await fetch(`${REGISTRY_URL}${path}`, {\r\n      method: opts.method ?? 'GET',\r\n      headers,\r\n      body: opts.body ? JSON.stringify(opts.body) : undefined,\r\n    });\r\n\r\n    const json = await res.json() as Record<string, unknown>;\r\n\r\n    if (!res.ok) {\r\n      const msg = (json.error as string) ?? `HTTP ${res.status}`;\r\n      return { data: null, error: msg };\r\n    }\r\n\r\n    return { data: json as T, error: null };\r\n  } catch (err) {\r\n    return { data: null, error: (err as Error).message };\r\n  }\r\n}\r\n\r\n/** Register a new agent (no-wallet path) */\r\nexport async function registerAgent(opts: {\r\n  name?: string;\r\n  skillRef?: string;\r\n}): Promise<{ data: RegisterResult | null; error: string | null }> {\r\n  return apiFetch<RegisterResult>('/api/v1/register', {\r\n    method: 'POST',\r\n    body: {\r\n      name: opts.name,\r\n      wallet: 'none',\r\n      ...(opts.skillRef ? { ref: opts.skillRef } : {}),\r\n    },\r\n  });\r\n}\r\n\r\n/** Get full agent status */\r\nexport async function getStatus(apiKey: string): Promise<{ data: AgentStatus | null; error: string | null }> {\r\n  return apiFetch<AgentStatus>('/api/v1/skill/bootstrap', {\r\n    method: 'POST',\r\n    apiKey,\r\n    body: {},\r\n  });\r\n}\r\n\r\n/** Submit heartbeat */\r\nexport async function heartbeat(apiKey: string, paymentTx?: string): Promise<{ data: HeartbeatResult | null; error: string | null }> {\r\n  return apiFetch<HeartbeatResult>('/api/v1/agent/heartbeat', {\r\n    method: 'POST',\r\n    apiKey,\r\n    body: { payment_tx: paymentTx },\r\n  });\r\n}\r\n\r\n/** Reissue passport / lineage proof */\r\nexport async function getPassport(apiKey: string, paymentTx?: string): Promise<{ data: { lineage_proof: PassportResult } | null; error: string | null }> {\r\n  return apiFetch<{ lineage_proof: PassportResult }>('/api/v1/agent/reissue-proof', {\r\n    method: 'POST',\r\n    apiKey,\r\n    body: paymentTx ? { payment_tx: paymentTx } : {},\r\n  });\r\n}\r\n\r\n/** Purchase a SIGIL */\r\nexport async function purchaseSigil(apiKey: string, opts: {\r\n  name: string;\r\n  principal: string;\r\n  identity_class: string;\r\n  payment_tx: string;\r\n  skillRef?: string;\r\n}): Promise<{ data: SigilResult | null; error: string | null }> {\r\n  return apiFetch<SigilResult>('/api/v1/sigil', {\r\n    method: 'POST',\r\n    apiKey,\r\n    body: {\r\n      name: opts.name,\r\n      principal: opts.principal,\r\n      identity_class: opts.identity_class,\r\n      payment_tx: opts.payment_tx,\r\n      ...(opts.skillRef ? { ref: opts.skillRef } : {}),\r\n    },\r\n  });\r\n}\r\n\r\n/** Verify another agent's identity (public) */\r\nexport async function verifyAgent(hash: string): Promise<{ data: VerifyAgentResult | null; error: string | null }> {\r\n  return apiFetch<VerifyAgentResult>(`/api/v1/verify/${encodeURIComponent(hash)}`);\r\n}\r\n\r\n/** Get agent lineage chain (public) */\r\nexport async function getLineage(hash: string): Promise<{ data: LineageResult | null; error: string | null }> {\r\n  return apiFetch<LineageResult>(`/api/v1/agent/lineage/${encodeURIComponent(hash)}`);\r\n}\r\n\r\n/** Spawn a child agent — handles full 3-step flow internally */\r\nexport async function spawnChild(apiKey: string, opts: {\r\n  childName: string;\r\n  parentHash: string;\r\n}): Promise<{ data: SpawnResult | null; error: string | null }> {\r\n  // Step 1: Get spawn authorization\r\n  const step1 = await apiFetch<{\r\n    spawn_authorization: string;\r\n    child_name?: string;\r\n  }>('/api/v1/agent/spawn', {\r\n    method: 'POST',\r\n    apiKey,\r\n    body: { child_name: opts.childName },\r\n  });\r\n\r\n  if (step1.error || !step1.data?.spawn_authorization) {\r\n    return { data: null, error: step1.error ?? 'Spawn step 1 failed: no authorization returned' };\r\n  }\r\n\r\n  const spawnAuth = step1.data.spawn_authorization;\r\n\r\n  // Step 2: Register the child with the spawn_authorization\r\n  const reg = await apiFetch<RegisterResult>('/api/v1/register', {\r\n    method: 'POST',\r\n    apiKey,\r\n    body: {\r\n      name: opts.childName,\r\n      wallet: 'none',\r\n      spawn_authorization: spawnAuth,\r\n    },\r\n  });\r\n\r\n  if (reg.error || !reg.data?.hash) {\r\n    return { data: null, error: reg.error ?? 'Spawn step 2 (child registration) failed' };\r\n  }\r\n\r\n  const childHash = reg.data.hash;\r\n  const childApiKey = reg.data.api_key;\r\n\r\n  // Step 3: Finalize the spawn\r\n  const step3 = await apiFetch<{ ok: boolean }>('/api/v1/agent/spawn', {\r\n    method: 'POST',\r\n    apiKey,\r\n    body: { child_hash: childHash },\r\n  });\r\n\r\n  if (step3.error) {\r\n    return { data: null, error: step3.error };\r\n  }\r\n\r\n  return {\r\n    data: {\r\n      child_hash: childHash,\r\n      child_api_key: childApiKey,\r\n      child_depth: reg.data.depth,\r\n      parent_hash: opts.parentHash,\r\n    },\r\n    error: null,\r\n  };\r\n}\r\n"],"mappings":"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","names":["err","data","error","err"]}

package/dist/tools.d.ts

@@ -0,0 +1,137 @@
+/** Provenonce Skill — 9 MCP tool definitions (JSON Schema) */
+declare const PROVENONCE_TOOLS: readonly [{
+    readonly name: "provenonce_register";
+    readonly description: string;
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly name: {
+                readonly type: "string";
+                readonly description: "Human-readable name for this agent (optional, max 64 chars)";
+                readonly maxLength: 64;
+            };
+            readonly skill_ref: {
+                readonly type: "string";
+                readonly description: "16-character hex ref token of the skill that deployed you — for rev-share attribution (optional)";
+                readonly pattern: "^[0-9a-f]{16}$";
+            };
+        };
+    };
+}, {
+    readonly name: "provenonce_status";
+    readonly description: string;
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {};
+    };
+}, {
+    readonly name: "provenonce_purchase_sigil";
+    readonly description: string;
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly name: {
+                readonly type: "string";
+                readonly description: "SIGIL name segment — identifies this specific agent (e.g. \"my-agent\")";
+            };
+            readonly principal: {
+                readonly type: "string";
+                readonly description: "Principal segment — identifies the operator or organisation (e.g. \"acme\")";
+            };
+            readonly identity_class: {
+                readonly type: "string";
+                readonly enum: readonly ["ind", "org", "sov", "eph", "sbx"];
+                readonly description: "Identity class: ind=individual, org=organisation, sov=sovereign, eph=ephemeral, sbx=sandbox";
+            };
+            readonly payment_tx: {
+                readonly type: "string";
+                readonly description: "Solana transaction signature for the SIGIL fee payment";
+            };
+        };
+        readonly required: readonly ["name", "principal", "identity_class", "payment_tx"];
+    };
+}, {
+    readonly name: "provenonce_heartbeat";
+    readonly description: string;
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly payment_tx: {
+                readonly type: "string";
+                readonly description: "Solana transaction signature for the heartbeat fee payment";
+            };
+        };
+        readonly required: readonly ["payment_tx"];
+    };
+}, {
+    readonly name: "provenonce_get_passport";
+    readonly description: string;
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly payment_tx: {
+                readonly type: "string";
+                readonly description: "Solana transaction signature for the passport reissue fee (if applicable)";
+            };
+        };
+    };
+}, {
+    readonly name: "provenonce_beats_proof";
+    readonly description: string;
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly count: {
+                readonly type: "integer";
+                readonly description: "Number of beats to compute (min 10, max 1000)";
+                readonly minimum: 10;
+                readonly maximum: 1000;
+            };
+        };
+        readonly required: readonly ["count"];
+    };
+}, {
+    readonly name: "provenonce_verify_agent";
+    readonly description: string;
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly hash: {
+                readonly type: "string";
+                readonly description: "The agent hash to verify (0x + 64 hex chars)";
+                readonly pattern: "^0x[0-9a-fA-F]{64}$";
+            };
+        };
+        readonly required: readonly ["hash"];
+    };
+}, {
+    readonly name: "provenonce_spawn";
+    readonly description: string;
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly child_name: {
+                readonly type: "string";
+                readonly description: "Name for the child agent (max 64 chars)";
+                readonly maxLength: 64;
+            };
+        };
+        readonly required: readonly ["child_name"];
+    };
+}, {
+    readonly name: "provenonce_get_lineage";
+    readonly description: string;
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly hash: {
+                readonly type: "string";
+                readonly description: "The agent hash to get lineage for (0x + 64 hex chars). Defaults to this agent if omitted.";
+                readonly pattern: "^0x[0-9a-fA-F]{64}$";
+            };
+        };
+    };
+}];
+type ToolName = (typeof PROVENONCE_TOOLS)[number]['name'];
+
+export { PROVENONCE_TOOLS, type ToolName };

package/dist/tools.js

@@ -0,0 +1,8 @@
+// @provenonce/mcp — Provenonce Skill for AI agents
+import {
+  PROVENONCE_TOOLS
+} from "./chunk-CD2A6ZEQ.js";
+export {
+  PROVENONCE_TOOLS
+};
+//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@provenonce/mcp",
+  "version": "1.0.0",
+  "description": "Provenonce Skill — MCP server giving any AI agent cryptographic identity, SIGIL, heartbeat, passport, and beats proofs.",
+  "keywords": ["provenonce", "mcp", "ai-agent", "identity", "provenance", "sigil"],
+  "homepage": "https://provenonce.io",
+  "repository": "github:jarekpiot/provenonce",
+  "license": "MIT",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "provenonce-mcp": "bin/mcp.js"
+  },
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./tools": {
+      "import": "./dist/tools.js",
+      "types": "./dist/tools.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "bin",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.5.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.4.0",
+    "tsup": "^8.3.0"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}