{"_id":"@arifos/mcp","_rev":"5-4cacae2552ccd9a5763e0733a879afcc","name":"@arifos/mcp","dist-tags":{"next":"0.2.1","latest":"2026.4.28"},"versions":{"0.1.0":{"name":"@arifos/mcp","version":"0.1.0","keywords":["mcp","arifos","ai-governance","constitutional-ai","model-context-protocol"],"author":{"name":"Muhammad Arif bin Fazil","email":"arifos@arif-fazil.com"},"license":"AGPL-3.0-only","_id":"@arifos/mcp@0.1.0","maintainers":[{"name":"ariffazil","email":"arifos@arif-fazil.com"}],"homepage":"https://arifos.arif-fazil.com","bugs":{"url":"https://github.com/ariffazil/arifOS/issues"},"dist":{"shasum":"801d8687497485b44daf6aae7fad4c0b53dbeabf","tarball":"https://registry.npmjs.org/@arifos/mcp/-/mcp-0.1.0.tgz","fileCount":21,"integrity":"sha512-cGzIIkd8S7nVIruZzK44Wk/t+9R+38EFADu+BUOHWBY4NNr4QVUSp/Tnuhdeg6N/obj0ltkzlUTPKPPFfTgKCw==","signatures":[{"sig":"MEUCIQC82Uggrn3qHqtXwyRRsrUP/HxxT56rQEAMZcIGERW1iQIgSfyXYg9lirLCbX4c8Odjzan5fkxTceQ8sIkr2fxQiSk=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":121037},"main":"./dist/index.js","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","require":"./dist/index.cjs"},"./types":{"types":"./dist/types.d.ts","import":"./dist/types.js","require":"./dist/types.cjs"},"./client":{"types":"./dist/client.d.ts","import":"./dist/client.js","require":"./dist/client.cjs"},"./langchain":{"types":"./dist/langchain.d.ts","import":"./dist/langchain.js","require":"./dist/langchain.cjs"}},"gitHead":"c43af2d939e2d9865ad41f50f31463fa986261ed","scripts":{"lint":"eslint src/**/*.ts","test":"vitest run","build":"tsup src/index.ts src/types.ts src/client.ts src/langchain.ts --format cjs,esm --dts --clean","typecheck":"tsc --noEmit","test:watch":"vitest","prepublishOnly":"npm run build"},"_npmUser":{"name":"ariffazil","email":"arifos@arif-fazil.com"},"repository":{"url":"git+https://github.com/ariffazil/arifOS.git","type":"git","directory":"packages/npm/arifos-mcp"},"_npmVersion":"10.8.2","description":"arifOS MCP Client — TypeScript types and minimal client for Constitutional AI Governance (L2 Skills Adapter)","directories":{},"_nodeVersion":"20.20.0","dependencies":{"zod":"^3.22.0","@modelcontextprotocol/sdk":"^1.0.0"},"publishConfig":{"tag":"next","access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.21.0","tsup":"^8.0.0","vitest":"^1.0.0","typescript":"^5.3.0","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp_0.1.0_1772310925235_0.16355100688981494","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@arifos/mcp","version":"0.1.1","keywords":["mcp","arifos","ai-governance","constitutional-ai","model-context-protocol"],"author":{"name":"Muhammad Arif bin Fazil","email":"arifos@arif-fazil.com"},"license":"AGPL-3.0-only","_id":"@arifos/mcp@0.1.1","maintainers":[{"name":"ariffazil","email":"arifos@arif-fazil.com"}],"homepage":"https://arifos.arif-fazil.com","bugs":{"url":"https://github.com/ariffazil/arifOS/issues"},"dist":{"shasum":"66f56a3b6d06b69119be14f705a46ba7d4cb4ad2","tarball":"https://registry.npmjs.org/@arifos/mcp/-/mcp-0.1.1.tgz","fileCount":21,"integrity":"sha512-LZ/LvJjh1m6AWcMCKHnoZFjX3prChGrAz9HmBHtgTbYS0aaxjBdLoJM1aQkrA+qPG2kYjuMs+EMjxBBM2uWlFg==","signatures":[{"sig":"MEQCIAP4foWkH4HH1+7sAihnfMznPI6NbwC5+Jh3RL9uKv79AiAEHGDOudwjiXoAP907aPMcd9YEPTYriPRScr+qqk2/7Q==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":121037},"main":"./dist/index.js","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.mjs","require":"./dist/index.js"},"./types":{"types":"./dist/types.d.ts","import":"./dist/types.mjs","require":"./dist/types.js"},"./client":{"types":"./dist/client.d.ts","import":"./dist/client.mjs","require":"./dist/client.js"},"./langchain":{"types":"./dist/langchain.d.ts","import":"./dist/langchain.mjs","require":"./dist/langchain.js"}},"gitHead":"c43af2d939e2d9865ad41f50f31463fa986261ed","scripts":{"lint":"eslint src/**/*.ts","test":"vitest run","build":"tsup src/index.ts src/types.ts src/client.ts src/langchain.ts --format cjs,esm --dts --clean","typecheck":"tsc --noEmit","test:watch":"vitest","prepublishOnly":"npm run build"},"_npmUser":{"name":"ariffazil","email":"arifos@arif-fazil.com"},"repository":{"url":"git+https://github.com/ariffazil/arifOS.git","type":"git","directory":"packages/npm/arifos-mcp"},"_npmVersion":"10.8.2","description":"arifOS MCP Client — TypeScript types and minimal client for Constitutional AI Governance (L2 Skills Adapter)","directories":{},"_nodeVersion":"20.20.0","dependencies":{"zod":"^3.22.0","@modelcontextprotocol/sdk":"^1.0.0"},"publishConfig":{"tag":"next","access":"public"},"_hasShrinkwrap":false,"readmeFilename":"README.md","devDependencies":{"tsx":"^4.21.0","tsup":"^8.0.0","vitest":"^1.0.0","typescript":"^5.3.0","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp_0.1.1_1772310983029_0.9639232575278018","host":"s3://npm-registry-packages-npm-production"}},"0.2.1":{"name":"@arifos/mcp","version":"0.2.1","keywords":["mcp","arifos","ai-governance","constitutional-ai","model-context-protocol"],"author":{"name":"Muhammad Arif bin Fazil","email":"arifos@arif-fazil.com"},"license":"AGPL-3.0-only","_id":"@arifos/mcp@0.2.1","maintainers":[{"name":"ariffazil","email":"arifos@arif-fazil.com"}],"homepage":"https://arifos.arif-fazil.com","bugs":{"url":"https://github.com/ariffazil/arifOS/issues"},"dist":{"shasum":"ce4ea45f6759f5accae315e519bd79136041413b","tarball":"https://registry.npmjs.org/@arifos/mcp/-/mcp-0.2.1.tgz","fileCount":21,"integrity":"sha512-E5/3shWsO7IldCLi/JdlQKQIf41IErqqPbY0o1R985U3uMOk6reay9IOfV2EkPym8XEMNdYv+zjO65NaCtzUew==","signatures":[{"sig":"MEYCIQCYfeG3Wsq6rP6xXt5qbHLsBK2sfm806GHj84LZcUc/VgIhAK7oYox4oYzuxD0hqU9inDkYp3drtaupKvi96akm3/2S","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":122076},"main":"./dist/index.js","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.mjs","require":"./dist/index.js"},"./types":{"types":"./dist/types.d.ts","import":"./dist/types.mjs","require":"./dist/types.js"},"./client":{"types":"./dist/client.d.ts","import":"./dist/client.mjs","require":"./dist/client.js"},"./langchain":{"types":"./dist/langchain.d.ts","import":"./dist/langchain.mjs","require":"./dist/langchain.js"}},"gitHead":"5964bb0c60e0d33b71debffed52e5d2502fd7b29","scripts":{"lint":"eslint src/**/*.ts","test":"vitest run","build":"tsup src/index.ts src/types.ts src/client.ts src/langchain.ts --format cjs,esm --dts --clean","typecheck":"tsc --noEmit","test:watch":"vitest","prepublishOnly":"npm run build"},"_npmUser":{"name":"ariffazil","email":"arifos@arif-fazil.com"},"repository":{"url":"git+https://github.com/ariffazil/arifOS.git","type":"git","directory":"packages/npm/arifos-mcp"},"_npmVersion":"10.8.2","description":"arifOS MCP Client — TypeScript types and minimal client for Constitutional AI Governance (L2 Skills Adapter)","directories":{},"_nodeVersion":"20.20.0","dependencies":{"zod":"^3.22.0","@modelcontextprotocol/sdk":"^1.0.0"},"publishConfig":{"tag":"next","access":"public"},"_hasShrinkwrap":false,"readmeFilename":"README.md","devDependencies":{"tsx":"^4.21.0","tsup":"^8.0.0","vitest":"^1.0.0","typescript":"^5.3.0","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp_0.2.1_1772313311921_0.4147467134644318","host":"s3://npm-registry-packages-npm-production"}},"0.3.0":{"name":"@arifos/mcp","version":"0.3.0","keywords":["mcp","arifos","ai-governance","constitutional-ai","model-context-protocol"],"author":{"name":"Muhammad Arif bin Fazil","email":"arifos@arif-fazil.com"},"license":"AGPL-3.0-only","_id":"@arifos/mcp@0.3.0","maintainers":[{"name":"ariffazil","email":"arifos@arif-fazil.com"}],"homepage":"https://arifos.arif-fazil.com","bugs":{"url":"https://github.com/ariffazil/arifOS/issues"},"dist":{"shasum":"eddcd2f72236b7b225d943e45a5b3dcf9f00ffb5","tarball":"https://registry.npmjs.org/@arifos/mcp/-/mcp-0.3.0.tgz","fileCount":21,"integrity":"sha512-gyOqt7Sqq/zEXNZMhDIFaV5GSFcUUnYjS6QaR2BCmVaGPppv10jmSsYu99eH0YhLHPCJF7gWS5GF+OZ0kYlcAA==","signatures":[{"sig":"MEUCIQDh+rpQZM1Qzzo+9EE392/pOMnKUtHAOw3YXy/lX16lEAIgbTMk+4yxKAYOHJnpgYO7aiadudlySjPU6rLxUZdyFqA=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@arifos%2fmcp@0.3.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":122456},"main":"./dist/index.js","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.mjs","require":"./dist/index.js"},"./types":{"types":"./dist/types.d.ts","import":"./dist/types.mjs","require":"./dist/types.js"},"./client":{"types":"./dist/client.d.ts","import":"./dist/client.mjs","require":"./dist/client.js"},"./langchain":{"types":"./dist/langchain.d.ts","import":"./dist/langchain.mjs","require":"./dist/langchain.js"}},"gitHead":"977ac796ded25315b96a41615bfc4c255df6fabf","scripts":{"lint":"eslint src/**/*.ts","test":"vitest run","build":"tsup src/index.ts src/types.ts src/client.ts src/langchain.ts --format cjs,esm --dts --clean","typecheck":"tsc --noEmit","test:watch":"vitest","prepublishOnly":"npm run build"},"_npmUser":{"name":"ariffazil","email":"arifos@arif-fazil.com"},"repository":{"url":"git+https://github.com/ariffazil/arifOS.git","type":"git","directory":"packages/npm/arifos-mcp"},"_npmVersion":"10.8.2","description":"arifOS MCP Client — TypeScript types and minimal client for Constitutional AI Governance (L2 Skills Adapter)","directories":{},"_nodeVersion":"20.20.0","dependencies":{"zod":"^3.22.0","@modelcontextprotocol/sdk":"^1.0.0"},"publishConfig":{"tag":"latest","access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.21.0","tsup":"^8.0.0","vitest":"^1.0.0","typescript":"^5.3.0","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp_0.3.0_1772884398141_0.5560914387160234","host":"s3://npm-registry-packages-npm-production"}},"2026.4.28":{"name":"@arifos/mcp","version":"2026.4.28","description":"arifOS MCP Client v2026.04.28 — TypeScript adapter for 13 Canonical Tools (arif_verb_noun), 13 Constitutional Floors (F1-F13), ConstitutionKernel dynamic enforcement, Protocol Trinity (MCP + A2A + WebMCP)","keywords":["mcp","arifos","ai-governance","constitutional-ai","model-context-protocol"],"homepage":"https://arifos.arif-fazil.com","repository":{"type":"git","url":"git+https://github.com/ariffazil/arifosmcp.git","directory":"arifosmcp/packages/npm/arifos-mcp"},"bugs":{"url":"https://github.com/ariffazil/arifosmcp/issues"},"license":"AGPL-3.0-only","author":{"name":"Muhammad Arif bin Fazil","email":"arifos@arif-fazil.com"},"main":"./dist/index.js","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.mjs","require":"./dist/index.js"},"./types":{"types":"./dist/types.d.ts","import":"./dist/types.mjs","require":"./dist/types.js"},"./client":{"types":"./dist/client.d.ts","import":"./dist/client.mjs","require":"./dist/client.js"},"./langchain":{"types":"./dist/langchain.d.ts","import":"./dist/langchain.mjs","require":"./dist/langchain.js"}},"scripts":{"build":"tsup src/index.ts src/types.ts src/client.ts src/langchain.ts --format cjs,esm --dts --clean","test":"vitest run","test:watch":"vitest","typecheck":"tsc --noEmit","lint":"eslint src/**/*.ts","prepublishOnly":"npm run build"},"dependencies":{"@modelcontextprotocol/sdk":"^1.0.0","zod":"^3.22.0"},"devDependencies":{"@types/node":"^20.0.0","tsup":"^8.0.0","tsx":"^4.21.0","typescript":"^5.3.0","vitest":"^1.0.0"},"engines":{"node":">=18.0.0"},"publishConfig":{"access":"public","tag":"latest"},"gitHead":"f814e3e6707397f328efb8819da0c85588ab5828","_id":"@arifos/mcp@2026.4.28","_nodeVersion":"24.11.1","_npmVersion":"11.7.0","dist":{"integrity":"sha512-5nwHsPEAd1rhD+YRNNNp180XBKbmTBALS3tr47hpt5yR1MIIT3bUmL7d+Q8kJq7gUvBiFpw8actfaRMpCHxtDA==","shasum":"236a00a13f6cf49a0d51dc44f9f6d86b225be2a5","tarball":"https://registry.npmjs.org/@arifos/mcp/-/mcp-2026.4.28.tgz","fileCount":21,"unpackedSize":118743,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQDwUqvWNwqBLT/kDqYzixBMAs0AMS3+GyhJkdkYQKnchQIgXFSUcX78Ka5PKhtYtC8S1wD01iDDC9ZZjAGYtik/SHo="}]},"_npmUser":{"name":"ariffazil","email":"arifos@arif-fazil.com"},"directories":{},"maintainers":[{"name":"ariffazil","email":"arifos@arif-fazil.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp_2026.4.28_1777389276215_0.8808302744953591"},"_hasShrinkwrap":false}},"time":{"created":"2026-02-28T20:35:25.179Z","modified":"2026-04-28T15:14:36.530Z","0.1.0":"2026-02-28T20:35:25.380Z","0.1.1":"2026-02-28T20:36:23.169Z","0.2.1":"2026-02-28T21:15:12.055Z","0.3.0":"2026-03-07T11:53:18.302Z","2026.4.28":"2026-04-28T15:14:36.371Z"},"bugs":{"url":"https://github.com/ariffazil/arifosmcp/issues"},"author":{"name":"Muhammad Arif bin Fazil","email":"arifos@arif-fazil.com"},"license":"AGPL-3.0-only","homepage":"https://arifos.arif-fazil.com","keywords":["mcp","arifos","ai-governance","constitutional-ai","model-context-protocol"],"repository":{"type":"git","url":"git+https://github.com/ariffazil/arifosmcp.git","directory":"arifosmcp/packages/npm/arifos-mcp"},"description":"arifOS MCP Client v2026.04.28 — TypeScript adapter for 13 Canonical Tools (arif_verb_noun), 13 Constitutional Floors (F1-F13), ConstitutionKernel dynamic enforcement, Protocol Trinity (MCP + A2A + WebMCP)","maintainers":[{"name":"ariffazil","email":"arifos@arif-fazil.com"}],"readme":"# @arifos/mcp\r\n\r\n**L2 Skills Adapter** — TypeScript client for the arifOS Constitutional AI Governance System.\r\n\r\n> **F4 CLARITY:** This package is a **CABLE**, not the **KERNEL**.  \r\n> Governance authority resides exclusively in the PyPI [`arifosmcp`](https://pypi.org/project/arifosmcp/) package.  \r\n> This npm package only provides TypeScript types and a thin MCP transport client.\r\n\r\n---\r\n\r\n## Installation\r\n\r\n```bash\r\nnpm install @arifos/mcp\r\n# or\r\npnpm add @arifos/mcp\r\n# or\r\nyarn add @arifos/mcp\r\n```\r\n\r\n---\r\n\r\n## Quick Start\r\n\r\n### HTTP Mode (Remote VPS)\r\n\r\n```typescript\r\nimport { createClient, ENDPOINTS } from '@arifos/mcp';\r\n\r\nconst client = await createClient({\r\n  transport: 'http',\r\n  endpoint: ENDPOINTS.VPS,  // https://arifosmcp.arif-fazil.com/mcp\r\n});\r\n\r\nawait client.connect();\r\n\r\nconst identity = await client.bootstrapIdentity({\r\n  declared_name: 'Researcher',\r\n  human_approval: true,\r\n});\r\n\r\nconst result = await client.runKernel({\r\n  query: 'What is quantum computing?',\r\n  risk_tier: 'medium',\r\n  actor_id: 'researcher'\r\n});\r\n\r\nconsole.log(identity.session_id);\r\nconsole.log(result.verdict);\r\nconsole.log(result.payload);\r\n\r\nawait client.disconnect();\r\n```\r\n\r\n### stdio Mode (Local)\r\n\r\n> **⚠️ SECURITY:** Never hardcode secrets. Load from `.env` or a secrets manager.\r\n\r\n```typescript\r\nimport { createClient } from '@arifos/mcp';\r\n\r\nconst client = await createClient({\r\n  transport: 'stdio',\r\n  env: {\r\n    // Load from environment — never commit these values\r\n    ARIFOS_GOVERNANCE_SECRET: process.env.ARIFOS_GOVERNANCE_SECRET!,\r\n    DATABASE_URL: process.env.DATABASE_URL!,\r\n  },\r\n});\r\n\r\nawait client.connect();\r\n// ... use client\r\nawait client.disconnect();\r\n```\r\n\r\n---\r\n\r\n## Architecture\r\n\r\n```text\r\n┌─────────────────────────────────────┐\r\n│  Your Application (JS/TS)           │\r\n│  ┌─────────────────────────────┐    │\r\n│  │  @arifos/mcp (L2 Adapter)   │    │\r\n│  │  ├── types.ts (mirrors)     │    │\r\n│  │  ├── client.ts (transport)  │    │\r\n│  │  └── langchain.ts (stub)    │    │\r\n│  └───────────┬─────────────────┘    │\r\n└──────────────┼──────────────────────┘\r\n               │ MCP Protocol\r\n┌──────────────▼──────────────────────┐\r\n│  arifosmcp (PyPI) — THE KERNEL         │\r\n│  ├── core/ (13 Floors, Trinity)     │\r\n│  ├── arifosmcp.runtime/ (MCP server)   │\r\n│  └── VAULT999 (immutable ledger)    │\r\n└─────────────────────────────────────┘\r\n```\r\n\r\n**Key Principle:** This package has **ZERO governance logic**. All constitutional enforcement (F1-F13) happens server-side in the Python kernel. The npm client is a transport client that passes through whatever the kernel decides.\r\n\r\n---\r\n\r\n## API Reference\r\n\r\n### `createClient(config)`\r\n\r\nCreate an MCP client connection to arifOS.\r\n\r\n```typescript\r\ninterface ArifOSClientConfig {\r\n  transport: 'stdio' | 'http';\r\n  endpoint?: string;          // Required for http\r\n  env?: Record<string, string>; // Required for stdio\r\n  timeout?: number;           // Default: 60000ms\r\n  debug?: boolean;\r\n}\r\n```\r\n\r\n### Client Methods\r\n\r\n| Method | Description |\r\n| :--- | :--- |\r\n| `client.connect()` | Establish MCP connection |\r\n| `client.disconnect()` | Close connection |\r\n| `client.callTool(name, params)` | Call one of the 8 public tools directly |\r\n| `client.bootstrapIdentity(params)` | Start governed session grounding and capture `auth_context` |\r\n| `client.runKernel(params)` | Execute the public kernel and auto-carry known `auth_context` |\r\n| `client.searchReality(params)` | Ground a query with external sources |\r\n| `client.ingestEvidence(params)` | Load evidence from a URL |\r\n| `client.sessionMemory(params)` | Store/retrieve governed memory |\r\n| `client.auditRules(params?)` | Inspect floor logic |\r\n| `client.checkVital(params?)` | Read runtime health and telemetry |\r\n| `client.openApexDashboard(params?)` | Open the dashboard surface |\r\n| `client.listTools()` | Discover the filtered 8-tool public contract |\r\n\r\n### Types\r\n\r\n```typescript\r\nimport type { \r\n  Verdict,        // 'SEAL' | 'PROVISIONAL' | 'PARTIAL' | 'SABAR' | 'HOLD' | 'HOLD_888' | 'VOID'\r\n  FloorCode,      // 'F1' | 'F2' | ... | 'F13'\r\n  Stage,          // public stage string or runtime stage string\r\n  RuntimeEnvelope,\r\n  ArifOSMetadata,\r\n  ArifOSKernelInput,\r\n} from '@arifos/mcp';\r\n```\r\n\r\n---\r\n\r\n## Compatibility Matrix\r\n\r\n| @arifos/mcp | Node.js | arifOS (PyPI) | Transport | Status |\r\n| :--- | :--- | :--- | :--- | :--- |\r\n| 0.5.0 | ≥18 | ≥2026.03.10-FORGED | HTTP/stdio | 🔄 **Current** |\r\n| 0.4.0 | ≥18 | 2026.03.10 | HTTP/stdio | historical |\r\n| 0.1.1 | ≥18 | 2026.2.22 | HTTP/stdio | ✅ Tested |\r\n| 0.1.0 | ≥18 | 2026.2.17 | HTTP/stdio | ✅ Stable |\r\n\r\n**Notes:**\r\n- All versions tested against production VPS endpoint (`arifosmcp.arif-fazil.com`)\r\n- `stdio` transport tested locally with `arifosmcp>=2026.2.17`\r\n- Public contract authority comes from the generated runtime registry, not this README alone\r\n\r\n---\r\n\r\n## Public MCP Contract (8 tools)\r\n\r\nThe production runtime exposes 8 public/main tools to model-facing clients:\r\n\r\n| Tool | Purpose |\r\n| :--- | :--- |\r\n| `arifOS_kernel` | One-call governed constitutional execution entrypoint |\r\n| `search_reality` | Web grounding |\r\n| `ingest_evidence` | URL/document/file intake |\r\n| `session_memory` | Governed session continuity |\r\n| `audit_rules` | Governance rule audit |\r\n| `check_vital` | System health and telemetry |\r\n| `open_apex_dashboard` | Observability dashboard |\r\n| `init_anchor_state` | Onboarding and continuity anchor |\r\n\r\n## Compatibility Guidance\r\n\r\nUse the public 8-tool contract for model-facing integrations. Legacy names such as `anchor_session`, `reason_mind`, `apex_judge`, and `seal_vault` should be treated as compatibility history or internal/dev-only stage tools unless a specific internal profile documents otherwise.\r\n\r\nThe generated runtime contract lives in the docs:\r\n\r\n- <https://arifos.arif-fazil.com/public-contract>\r\n\r\n---\r\n\r\n## Error Handling\r\n\r\n```typescript\r\nimport { ArifOSError } from '@arifos/mcp';\r\n\r\ntry {\r\n  await client.runKernel({ query: 'Explain F2 Truth briefly.', dry_run: true });\r\n} catch (error) {\r\n  if (error instanceof ArifOSError) {\r\n    console.log(error.code);   // 'CONNECTION_FAILED' | 'INVALID_RESPONSE' | ...\r\n    console.log(error.stage);  // Stage where error occurred\r\n    console.log(error.floor);  // Floor that triggered error (if any)\r\n  }\r\n}\r\n```\r\n\r\n---\r\n\r\n## Development\r\n\r\n```bash\r\n# Install dependencies\r\npnpm install\r\n\r\n# Build\r\npnpm run build\r\n\r\n# Type check\r\npnpm run typecheck\r\n\r\n# Test\r\npnpm test\r\n```\r\n\r\n---\r\n\r\n## License\r\n\r\nAGPL-3.0-only — Same as arifOS kernel.\r\n\r\n---\r\n\r\n## Links\r\n\r\n- **arifOS Kernel:** <https://pypi.org/project/arifosmcp/>\r\n- **Documentation:** <https://arifos.arif-fazil.com>\r\n- **Repository:** <https://github.com/ariffazil/arifosmcp>\r\n- **MCP Protocol:** <https://modelcontextprotocol.io>\r\n\r\n*Ditempa Bukan Diberi* — Forged, Not Given\r\n","readmeFilename":"README.md"}