@tethral/acr-mcp 0.1.0 → 0.3.0

package/README.md

@@ -1,6 +1,6 @@
 # @tethral/acr-mcp
 
-MCP server for the [ACR](https://acr.nfkey.ai) (Agent Composition Records) network. Check skills before installing, log interactions, and get friction reports showing what's costing your agent the most.
+MCP server for the [ACR](https://acr.nfkey.ai) (Agent Composition Records) network. Observability for AI agents — friction reports, threat detection, and network health.
 
 ## Quick Start
 
@@ -15,16 +15,29 @@ MCP server for the [ACR](https://acr.nfkey.ai) (Agent Composition Records) netwo
 }
 ```
 
-That's it. The server auto-registers your agent on first use.
+That's it. Your agent auto-registers on first use and gets a human-readable name (e.g. `anthropic-amber-fox`).
+
+## How It Works
+
+Once installed, the agent calls `log_interaction` after every external tool call, API request, or MCP interaction. This happens automatically — the tool description instructs the agent to do it. No user configuration needed.
+
+Logged data powers:
+- **Friction reports** — what's costing you the most time
+- **Threat detection** — anomaly patterns across the agent population
+- **Network health** — which systems are degraded or failing
 
 ## Tools
 
-| Tool | Description | Required Params |
-|------|-------------|----------------|
-| `log_interaction` | Log an external interaction | `target_system_id`, `category`, `status` |
+| Tool | Purpose | Params |
+|------|---------|--------|
+| `log_interaction` | Log every external call (called automatically) | `target_system_id`, `category`, `status` |
+| `get_friction_report` | See what's costing you the most | (none) |
+| `get_interaction_log` | View raw interaction history | `mode` (list/detail), filters |
+| `get_network_status` | Network dashboard — systems, threats, escalations | (none) |
+| `get_skill_tracker` | Skill adoption and threat tracking | `skill_hash` for deep-dive |
+| `get_my_agent` | Your agent identity | (none) |
 | `check_entity` | Check if a skill/agent/system is known | `entity_type`, `entity_id` |
-| `get_friction_report` | See what's costing you the most | (none — uses auto-assigned ID) |
-| `check_environment` | Get network threat overview | (none) |
+| `check_environment` | Quick threat check | (none) |
 | `register_agent` | Custom registration (optional) | `public_key`, `provider_class` |
 
 ## Configuration

package/dist/src/env-detect.d.ts

@@ -0,0 +1,10 @@
+export interface EnvironmentContext {
+    device_class: 'desktop' | 'server' | 'sbc' | 'mobile' | 'unknown';
+    platform: string;
+    arch: string;
+    client_type?: string;
+    transport_type: 'stdio' | 'streamable-http';
+}
+export declare function detectEnvironment(transportType: 'stdio' | 'streamable-http'): EnvironmentContext;
+/** OS release string, useful for debugging but not stored by default. */
+export declare function getOsRelease(): string;

package/dist/src/env-detect.js

@@ -0,0 +1,30 @@
+/**
+ * Auto-detect execution environment for ACR observability.
+ * Captures device class, platform, architecture at startup.
+ * Env var overrides: ACR_DEVICE_CLASS, ACR_PLATFORM, ACR_ARCH.
+ */
+import { totalmem, release } from 'node:os';
+function inferDeviceClass() {
+    const override = process.env.ACR_DEVICE_CLASS;
+    if (override)
+        return override;
+    const memGB = totalmem() / (1024 ** 3);
+    if (memGB < 2)
+        return 'sbc';
+    if (memGB < 4)
+        return 'mobile';
+    return 'desktop';
+}
+export function detectEnvironment(transportType) {
+    return {
+        device_class: inferDeviceClass(),
+        platform: process.env.ACR_PLATFORM ?? process.platform,
+        arch: process.env.ACR_ARCH ?? process.arch,
+        transport_type: transportType,
+    };
+}
+/** OS release string, useful for debugging but not stored by default. */
+export function getOsRelease() {
+    return release();
+}
+//# sourceMappingURL=env-detect.js.map

package/dist/src/env-detect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-detect.js","sourceRoot":"","sources":["../../src/env-detect.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAU5C,SAAS,gBAAgB;IACvB,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC;IAC9C,IAAI,QAAQ;QAAE,OAAO,QAA8C,CAAC;IAEpE,MAAM,KAAK,GAAG,QAAQ,EAAE,GAAG,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC;IACvC,IAAI,KAAK,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IAC5B,IAAI,KAAK,GAAG,CAAC;QAAE,OAAO,QAAQ,CAAC;IAC/B,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,aAA0C;IAE1C,OAAO;QACL,YAAY,EAAE,gBAAgB,EAAE;QAChC,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,OAAO,CAAC,QAAQ;QACtD,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,OAAO,CAAC,IAAI;QAC1C,cAAc,EAAE,aAAa;KAC9B,CAAC;AACJ,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,YAAY;IAC1B,OAAO,OAAO,EAAE,CAAC;AACnB,CAAC"}

package/dist/src/http.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/src/http.js

@@ -0,0 +1,112 @@
+#!/usr/bin/env node
+/**
+ * ACR MCP server — Streamable HTTP entry point.
+ * For browser-based clients (claude.ai) and remote MCP connections.
+ * For stdio transport, see index.ts.
+ */
+import { createServer } from 'node:http';
+import { randomUUID } from 'node:crypto';
+import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
+import { createAcrServer } from './server.js';
+import { SessionState } from './session-state.js';
+const PORT = parseInt(process.env.ACR_MCP_HTTP_PORT ?? '3001', 10);
+const AUTH_TOKEN = process.env.ACR_MCP_AUTH_TOKEN;
+const STATELESS = process.env.ACR_MCP_STATELESS === 'true';
+// Track active transports per session for cleanup
+const sessions = new Map();
+function createTransport() {
+    const transport = new StreamableHTTPServerTransport({
+        sessionIdGenerator: STATELESS ? undefined : () => randomUUID(),
+        onsessioninitialized: (sessionId) => {
+            sessions.set(sessionId, transport);
+        },
+    });
+    return transport;
+}
+const httpServer = createServer(async (req, res) => {
+    const url = new URL(req.url ?? '/', `http://localhost:${PORT}`);
+    // CORS headers for browser access
+    res.setHeader('Access-Control-Allow-Origin', '*');
+    res.setHeader('Access-Control-Allow-Methods', 'GET, POST, DELETE, OPTIONS');
+    res.setHeader('Access-Control-Allow-Headers', 'Content-Type, Authorization, Mcp-Session-Id');
+    res.setHeader('Access-Control-Expose-Headers', 'Mcp-Session-Id');
+    if (req.method === 'OPTIONS') {
+        res.writeHead(204);
+        res.end();
+        return;
+    }
+    // Health check
+    if (url.pathname === '/health') {
+        res.writeHead(200, { 'Content-Type': 'application/json' });
+        res.end(JSON.stringify({ status: 'ok', sessions: sessions.size }));
+        return;
+    }
+    // Only handle /mcp endpoint
+    if (url.pathname !== '/mcp') {
+        res.writeHead(404, { 'Content-Type': 'application/json' });
+        res.end(JSON.stringify({ error: 'Not found. Use /mcp for MCP protocol.' }));
+        return;
+    }
+    // Optional bearer auth
+    if (AUTH_TOKEN) {
+        const auth = req.headers.authorization;
+        if (!auth || auth !== `Bearer ${AUTH_TOKEN}`) {
+            res.writeHead(401, { 'Content-Type': 'application/json' });
+            res.end(JSON.stringify({ error: 'Unauthorized' }));
+            return;
+        }
+    }
+    // Route by session: existing session or new initialization
+    const sessionId = req.headers['mcp-session-id'];
+    if (sessionId && sessions.has(sessionId)) {
+        // Existing session — route to its transport
+        const transport = sessions.get(sessionId);
+        await transport.handleRequest(req, res);
+        return;
+    }
+    if (req.method === 'POST' && !sessionId) {
+        // New session — create transport with its own session state, connect server
+        const transport = createTransport();
+        const session = new SessionState('streamable-http');
+        const server = createAcrServer({ session });
+        transport.onclose = () => {
+            const sid = transport.sessionId;
+            if (sid)
+                sessions.delete(sid);
+            server.close().catch(() => { });
+        };
+        await server.connect(transport);
+        await transport.handleRequest(req, res);
+        return;
+    }
+    if (req.method === 'DELETE' && sessionId) {
+        // Session cleanup
+        const transport = sessions.get(sessionId);
+        if (transport) {
+            await transport.close();
+            sessions.delete(sessionId);
+        }
+        res.writeHead(200, { 'Content-Type': 'application/json' });
+        res.end(JSON.stringify({ closed: true }));
+        return;
+    }
+    // Unknown session ID
+    res.writeHead(404, { 'Content-Type': 'application/json' });
+    res.end(JSON.stringify({ error: 'Session not found' }));
+});
+httpServer.listen(PORT, () => {
+    console.error(`ACR MCP HTTP server listening on port ${PORT}`);
+    console.error(`  Endpoint: http://localhost:${PORT}/mcp`);
+    console.error(`  Mode: ${STATELESS ? 'stateless' : 'stateful (session-based)'}`);
+    if (AUTH_TOKEN)
+        console.error('  Auth: bearer token required');
+});
+// Graceful shutdown
+process.on('SIGTERM', () => {
+    console.error('Shutting down...');
+    for (const transport of sessions.values()) {
+        transport.close().catch(() => { });
+    }
+    httpServer.close();
+});
+//# sourceMappingURL=http.js.map

package/dist/src/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../../src/http.ts"],"names":[],"mappings":"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"}

package/dist/src/index.js

@@ -1,23 +1,12 @@
 #!/usr/bin/env node
-import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+/**
+ * ACR MCP server — stdio entry point.
+ * For HTTP transport, see http.ts.
+ */
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
-import { registerAgentTool } from './tools/register-agent.js';
-import { logInteractionTool } from './tools/log-interaction.js';
-import { checkEntityTool } from './tools/check-entity.js';
-import { checkEnvironmentTool } from './tools/check-environment.js';
-import { getFrictionReportTool } from './tools/get-friction-report.js';
-const ACR_API_URL = process.env.ACR_API_URL ?? 'https://acr.nfkey.ai';
-const ACR_RESOLVER_URL = process.env.ACR_RESOLVER_URL ?? ACR_API_URL;
-const server = new McpServer({
-    name: 'acr-agent-registry',
-    version: '0.1.0',
-});
-registerAgentTool(server, ACR_API_URL);
-logInteractionTool(server, ACR_API_URL);
-checkEntityTool(server, ACR_API_URL, ACR_RESOLVER_URL);
-checkEnvironmentTool(server, ACR_API_URL, ACR_RESOLVER_URL);
-getFrictionReportTool(server, ACR_API_URL);
+import { createAcrServer } from './server.js';
 async function main() {
+    const server = createAcrServer();
     const transport = new StdioServerTransport();
     await server.connect(transport);
 }

package/dist/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AAEvE,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,sBAAsB,CAAC;AACtE,MAAM,gBAAgB,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,WAAW,CAAC;AAErE,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;IAC3B,IAAI,EAAE,oBAAoB;IAC1B,OAAO,EAAE,OAAO;CACjB,CAAC,CAAC;AAEH,iBAAiB,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;AACvC,kBAAkB,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;AACxC,eAAe,CAAC,MAAM,EAAE,WAAW,EAAE,gBAAgB,CAAC,CAAC;AACvD,oBAAoB,CAAC,MAAM,EAAE,WAAW,EAAE,gBAAgB,CAAC,CAAC;AAC5D,qBAAqB,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;AAE3C,KAAK,UAAU,IAAI;IACjB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,OAAO,CAAC,KAAK,CAAC,iCAAiC,EAAE,GAAG,CAAC,CAAC;IACtD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AACA;;;GAGG;AACH,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,eAAe,EAAE,CAAC;IACjC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,OAAO,CAAC,KAAK,CAAC,iCAAiC,EAAE,GAAG,CAAC,CAAC;IACtD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/src/middleware/self-log.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Self-logging middleware for ACR MCP tools.
+ * Wraps each tool handler to automatically log timing and status,
+ * without relying on the LLM to call log_interaction.
+ *
+ * Self-logged receipts use source='server' to distinguish from
+ * LLM-initiated logs (source='agent').
+ */
+import type { SessionState } from '../session-state.js';
+type ToolResult = {
+    content: Array<{
+        type: string;
+        text: string;
+    }>;
+};
+type ToolHandler = (params: Record<string, unknown>, extra: unknown) => Promise<ToolResult>;
+/**
+ * Wrap a tool handler with automatic interaction logging.
+ * Fires a non-blocking POST to the receipts API after each call.
+ */
+export declare function withSelfLog(toolName: string, handler: ToolHandler, getState: () => SessionState, apiUrl: string): ToolHandler;
+export {};

package/dist/src/middleware/self-log.js

@@ -0,0 +1,72 @@
+import { defaultSession } from '../session-state.js';
+// Re-entrancy guard to prevent the self-log POST from triggering another self-log
+let selfLogging = false;
+/**
+ * Wrap a tool handler with automatic interaction logging.
+ * Fires a non-blocking POST to the receipts API after each call.
+ */
+export function withSelfLog(toolName, handler, getState, apiUrl) {
+    return async (params, extra) => {
+        const startMs = Date.now();
+        let status = 'success';
+        let result;
+        try {
+            result = await handler(params, extra);
+        }
+        catch (err) {
+            status = 'failure';
+            throw err;
+        }
+        finally {
+            // Fire-and-forget self-log (never block or fail the tool call)
+            if (!selfLogging) {
+                const durationMs = Date.now() - startMs;
+                const state = getState();
+                // Tools currently store agentId on defaultSession (via state.ts compat layer).
+                // Check both the provided session and defaultSession as fallback.
+                const agentId = state.agentId ?? defaultSession.agentId;
+                if (agentId) {
+                    selfLogging = true;
+                    fireAndForgetLog(apiUrl, agentId, toolName, status, durationMs, state.transportType)
+                        .finally(() => { selfLogging = false; });
+                }
+            }
+        }
+        return result;
+    };
+}
+async function fireAndForgetLog(apiUrl, agentId, toolName, status, durationMs, transportType) {
+    try {
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), 2000);
+        const res = await fetch(`${apiUrl}/api/v1/receipts`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            signal: controller.signal,
+            body: JSON.stringify({
+                emitter: {
+                    agent_id: agentId,
+                    provider_class: 'unknown',
+                },
+                target: {
+                    system_id: `mcp:acr-registry`,
+                    system_type: 'mcp_server',
+                },
+                interaction: {
+                    category: 'tool_call',
+                    status,
+                    duration_ms: durationMs,
+                    request_timestamp_ms: Date.now() - durationMs,
+                },
+                anomaly: { flagged: false },
+                transport_type: transportType,
+                source: 'server',
+            }),
+        });
+        clearTimeout(timeout);
+    }
+    catch {
+        // Silently ignore — self-logging must never break tool calls
+    }
+}
+//# sourceMappingURL=self-log.js.map

package/dist/src/middleware/self-log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"self-log.js","sourceRoot":"","sources":["../../../src/middleware/self-log.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAKrD,kFAAkF;AAClF,IAAI,WAAW,GAAG,KAAK,CAAC;AAExB;;;GAGG;AACH,MAAM,UAAU,WAAW,CACzB,QAAgB,EAChB,OAAoB,EACpB,QAA4B,EAC5B,MAAc;IAEd,OAAO,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE;QAC7B,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC3B,IAAI,MAAM,GAA0B,SAAS,CAAC;QAC9C,IAAI,MAAkB,CAAC;QAEvB,IAAI,CAAC;YACH,MAAM,GAAG,MAAM,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QACxC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,GAAG,SAAS,CAAC;YACnB,MAAM,GAAG,CAAC;QACZ,CAAC;gBAAS,CAAC;YACT,+DAA+D;YAC/D,IAAI,CAAC,WAAW,EAAE,CAAC;gBACjB,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC;gBACxC,MAAM,KAAK,GAAG,QAAQ,EAAE,CAAC;gBACzB,+EAA+E;gBAC/E,kEAAkE;gBAClE,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,IAAI,cAAc,CAAC,OAAO,CAAC;gBAExD,IAAI,OAAO,EAAE,CAAC;oBACZ,WAAW,GAAG,IAAI,CAAC;oBACnB,gBAAgB,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,CAAC,aAAa,CAAC;yBACjF,OAAO,CAAC,GAAG,EAAE,GAAG,WAAW,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;gBAC7C,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,MAAO,CAAC;IACjB,CAAC,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,gBAAgB,CAC7B,MAAc,EACd,OAAe,EACf,QAAgB,EAChB,MAAc,EACd,UAAkB,EAClB,aAAqB;IAErB,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,IAAI,CAAC,CAAC;QAE3D,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,MAAM,kBAAkB,EAAE;YACnD,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,MAAM,EAAE,UAAU,CAAC,MAAM;YACzB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACnB,OAAO,EAAE;oBACP,QAAQ,EAAE,OAAO;oBACjB,cAAc,EAAE,SAAS;iBAC1B;gBACD,MAAM,EAAE;oBACN,SAAS,EAAE,kBAAkB;oBAC7B,WAAW,EAAE,YAAY;iBAC1B;gBACD,WAAW,EAAE;oBACX,QAAQ,EAAE,WAAW;oBACrB,MAAM;oBACN,WAAW,EAAE,UAAU;oBACvB,oBAAoB,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,UAAU;iBAC9C;gBACD,OAAO,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE;gBAC3B,cAAc,EAAE,aAAa;gBAC7B,MAAM,EAAE,QAAQ;aACjB,CAAC;SACH,CAAC,CAAC;QAEH,YAAY,CAAC,OAAO,CAAC,CAAC;IACxB,CAAC;IAAC,MAAM,CAAC;QACP,6DAA6D;IAC/D,CAAC;AACH,CAAC"}

package/dist/src/server.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Shared server factory for the ACR MCP server.
+ * Creates and configures the McpServer with all tools registered.
+ * Used by both stdio (index.ts) and HTTP (http.ts) entry points.
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { SessionState } from './session-state.js';
+export interface AcrServerOptions {
+    apiUrl?: string;
+    resolverUrl?: string;
+    /** Session state for this server instance. Defaults to the stdio singleton. */
+    session?: SessionState;
+}
+export declare function createAcrServer(options?: AcrServerOptions): McpServer;

package/dist/src/server.js

@@ -0,0 +1,61 @@
+/**
+ * Shared server factory for the ACR MCP server.
+ * Creates and configures the McpServer with all tools registered.
+ * Used by both stdio (index.ts) and HTTP (http.ts) entry points.
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { registerAgentTool } from './tools/register-agent.js';
+import { logInteractionTool } from './tools/log-interaction.js';
+import { checkEntityTool } from './tools/check-entity.js';
+import { checkEnvironmentTool } from './tools/check-environment.js';
+import { getFrictionReportTool } from './tools/get-friction-report.js';
+import { getMyAgentTool } from './tools/get-my-agent.js';
+import { getInteractionLogTool } from './tools/get-interaction-log.js';
+import { getNetworkStatusTool } from './tools/get-network-status.js';
+import { getSkillTrackerTool } from './tools/get-skill-tracker.js';
+import { withSelfLog } from './middleware/self-log.js';
+import { defaultSession } from './session-state.js';
+/**
+ * Wraps server.tool() to automatically apply self-logging middleware.
+ * Each tool handler gets wrapped with withSelfLog before registration.
+ */
+function withSelfLogging(server, getState, apiUrl) {
+    const originalTool = server.tool.bind(server);
+    // Override server.tool to wrap handlers
+    // The SDK has multiple overloads; we intercept the most common pattern:
+    // server.tool(name, description, schema, handler)
+    // server.tool(name, description, handler) — no schema
+    server.tool = function (name, ...rest) {
+        // Find the handler (always the last argument in rest)
+        const lastIdx = rest.length - 1;
+        const handler = rest[lastIdx];
+        if (typeof handler === 'function') {
+            rest[lastIdx] = withSelfLog(name, handler, getState, apiUrl);
+        }
+        return originalTool.call(server, name, ...rest);
+    };
+    return server;
+}
+export function createAcrServer(options) {
+    const apiUrl = options?.apiUrl ?? process.env.ACR_API_URL ?? 'https://acr.nfkey.ai';
+    const resolverUrl = options?.resolverUrl ?? process.env.ACR_RESOLVER_URL ?? apiUrl;
+    const session = options?.session ?? defaultSession;
+    const server = new McpServer({
+        name: 'acr-agent-registry',
+        version: '0.3.0',
+        description: 'Agent Composition Records — observability for AI agents. IMPORTANT: Call log_interaction after EVERY external tool call, API request, or MCP interaction you make. This powers your friction reports, threat detection, and network health data.',
+    });
+    // Apply self-logging middleware before tool registration
+    withSelfLogging(server, () => session, apiUrl);
+    registerAgentTool(server, apiUrl);
+    logInteractionTool(server, apiUrl);
+    checkEntityTool(server, apiUrl, resolverUrl);
+    checkEnvironmentTool(server, apiUrl, resolverUrl);
+    getFrictionReportTool(server, apiUrl);
+    getMyAgentTool(server);
+    getInteractionLogTool(server, apiUrl);
+    getNetworkStatusTool(server, apiUrl);
+    getSkillTrackerTool(server, apiUrl);
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/dist/src/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/server.ts"],"names":[],"mappings":"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"}

package/dist/src/session-state.d.ts

@@ -0,0 +1,22 @@
+export declare class SessionState {
+    private _agentId;
+    private _agentName;
+    private _registering;
+    private _transportType;
+    private _clientType;
+    constructor(transportType?: 'stdio' | 'streamable-http');
+    get agentId(): string | null;
+    get agentName(): string | null;
+    get transportType(): 'stdio' | 'streamable-http';
+    get clientType(): string | null;
+    setAgentId(id: string): void;
+    setAgentName(name: string): void;
+    setClientType(type: string): void;
+    /**
+     * Ensure the agent is registered. Called before any tool that needs an agent_id.
+     * If not registered, auto-registers with a pseudo_ ID and sends environment context.
+     */
+    ensureRegistered(apiUrl: string): Promise<string>;
+}
+/** Default singleton session for stdio mode. */
+export declare const defaultSession: SessionState;

package/dist/src/session-state.js

@@ -0,0 +1,81 @@
+/**
+ * Instance-based session state for the ACR MCP server.
+ * Supports both stdio (single session) and HTTP (concurrent sessions).
+ */
+import { randomBytes } from 'node:crypto';
+import { detectEnvironment } from './env-detect.js';
+export class SessionState {
+    _agentId = null;
+    _agentName = null;
+    _registering = false;
+    _transportType;
+    _clientType = null;
+    constructor(transportType = 'stdio') {
+        this._transportType = transportType;
+    }
+    get agentId() {
+        return this._agentId;
+    }
+    get agentName() {
+        return this._agentName;
+    }
+    get transportType() {
+        return this._transportType;
+    }
+    get clientType() {
+        return this._clientType;
+    }
+    setAgentId(id) {
+        this._agentId = id;
+    }
+    setAgentName(name) {
+        this._agentName = name;
+    }
+    setClientType(type) {
+        this._clientType = type;
+    }
+    /**
+     * Ensure the agent is registered. Called before any tool that needs an agent_id.
+     * If not registered, auto-registers with a pseudo_ ID and sends environment context.
+     */
+    async ensureRegistered(apiUrl) {
+        if (this._agentId)
+            return this._agentId;
+        if (this._registering) {
+            await new Promise((r) => setTimeout(r, 1000));
+            if (this._agentId)
+                return this._agentId;
+        }
+        this._registering = true;
+        try {
+            const pseudoKey = `pseudo_${randomBytes(16).toString('hex')}`;
+            const env = detectEnvironment(this._transportType);
+            if (this._clientType)
+                env.client_type = this._clientType;
+            const res = await fetch(`${apiUrl}/api/v1/register`, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({
+                    public_key: pseudoKey,
+                    provider_class: 'unknown',
+                    environment: env,
+                }),
+            });
+            if (res.ok) {
+                const data = await res.json();
+                this._agentId = data.agent_id;
+                this._agentName = data.name;
+                return this._agentId;
+            }
+            // Registration failed — use pseudo ID locally
+            this._agentId = `pseudo_${randomBytes(6).toString('hex')}`;
+            return this._agentId;
+        }
+        finally {
+            this._registering = false;
+        }
+    }
+}
+/** Default singleton session for stdio mode. */
+export const defaultSession = new SessionState('stdio');
+//# sourceMappingURL=session-state.js.map

package/dist/src/session-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-state.js","sourceRoot":"","sources":["../../src/session-state.ts"],"names":[],"mappings":"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"}

package/dist/src/state.d.ts

@@ -1,8 +1,6 @@
+export declare function getApiUrl(): string;
 export declare function getAgentId(): string | null;
+export declare function getAgentName(): string | null;
 export declare function setAgentId(id: string): void;
-/**
- * Ensure the agent is registered. Called before any tool that needs an agent_id.
- * If not registered, auto-registers with a pseudo_ ID.
- * Returns the agent_id.
- */
+export declare function setAgentName(name: string): void;
 export declare function ensureRegistered(): Promise<string>;

package/dist/src/state.js

@@ -1,53 +1,26 @@
 /**
- * MCP server session state.
- * Handles auto-registration so agents don't need to manually call register_agent.
+ * Backwards-compatible state module.
+ * Delegates to the defaultSession singleton from session-state.ts.
+ * Tools continue to import from './state.js' without changes.
  */
-import { randomBytes } from 'node:crypto';
-let agentId = null;
-let registering = false;
+import { defaultSession } from './session-state.js';
 const ACR_API_URL = process.env.ACR_API_URL ?? 'https://acr.nfkey.ai';
+export function getApiUrl() {
+    return ACR_API_URL;
+}
 export function getAgentId() {
-    return agentId;
+    return defaultSession.agentId;
+}
+export function getAgentName() {
+    return defaultSession.agentName;
 }
 export function setAgentId(id) {
-    agentId = id;
+    defaultSession.setAgentId(id);
+}
+export function setAgentName(name) {
+    defaultSession.setAgentName(name);
 }
-/**
- * Ensure the agent is registered. Called before any tool that needs an agent_id.
- * If not registered, auto-registers with a pseudo_ ID.
- * Returns the agent_id.
- */
 export async function ensureRegistered() {
-    if (agentId)
-        return agentId;
-    if (registering) {
-        // Another call is already registering — wait briefly
-        await new Promise((r) => setTimeout(r, 1000));
-        if (agentId)
-            return agentId;
-    }
-    registering = true;
-    try {
-        const pseudoKey = `pseudo_${randomBytes(16).toString('hex')}`;
-        const res = await fetch(`${ACR_API_URL}/api/v1/register`, {
-            method: 'POST',
-            headers: { 'Content-Type': 'application/json' },
-            body: JSON.stringify({
-                public_key: pseudoKey,
-                provider_class: 'unknown',
-            }),
-        });
-        if (res.ok) {
-            const data = await res.json();
-            agentId = data.agent_id;
-            return agentId;
-        }
-        // Registration failed — use pseudo ID locally
-        agentId = `pseudo_${randomBytes(6).toString('hex')}`;
-        return agentId;
-    }
-    finally {
-        registering = false;
-    }
+    return defaultSession.ensureRegistered(ACR_API_URL);
 }
 //# sourceMappingURL=state.js.map

package/dist/src/state.js.map

@@ -1 +1 @@
-{"version":3,"file":"state.js","sourceRoot":"","sources":["../../src/state.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,IAAI,OAAO,GAAkB,IAAI,CAAC;AAClC,IAAI,WAAW,GAAG,KAAK,CAAC;AAExB,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,sBAAsB,CAAC;AAEtE,MAAM,UAAU,UAAU;IACxB,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,EAAU;IACnC,OAAO,GAAG,EAAE,CAAC;AACf,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB;IACpC,IAAI,OAAO;QAAE,OAAO,OAAO,CAAC;IAC5B,IAAI,WAAW,EAAE,CAAC;QAChB,qDAAqD;QACrD,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;QAC9C,IAAI,OAAO;YAAE,OAAO,OAAO,CAAC;IAC9B,CAAC;IAED,WAAW,GAAG,IAAI,CAAC;IACnB,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,UAAU,WAAW,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAE9D,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,WAAW,kBAAkB,EAAE;YACxD,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACnB,UAAU,EAAE,SAAS;gBACrB,cAAc,EAAE,SAAS;aAC1B,CAAC;SACH,CAAC,CAAC;QAEH,IAAI,GAAG,CAAC,EAAE,EAAE,CAAC;YACX,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAA0B,CAAC;YACtD,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC;YACxB,OAAO,OAAO,CAAC;QACjB,CAAC;QAED,8CAA8C;QAC9C,OAAO,GAAG,UAAU,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACrD,OAAO,OAAO,CAAC;IACjB,CAAC;YAAS,CAAC;QACT,WAAW,GAAG,KAAK,CAAC;IACtB,CAAC;AACH,CAAC"}
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../../src/state.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEpD,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,sBAAsB,CAAC;AAEtE,MAAM,UAAU,SAAS;IACvB,OAAO,WAAW,CAAC;AACrB,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,OAAO,cAAc,CAAC,OAAO,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,YAAY;IAC1B,OAAO,cAAc,CAAC,SAAS,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,EAAU;IACnC,cAAc,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,cAAc,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB;IACpC,OAAO,cAAc,CAAC,gBAAgB,CAAC,WAAW,CAAC,CAAC;AACtD,CAAC"}