@adrive/mcp-server 0.4.0 → 1.0.0

package/README.md

@@ -1,6 +1,6 @@
 # @adrive/mcp-server
 
-MCP server for **AgentDrive** — the persistent workspace your agents share across Claude Code, Codex, Cursor, and LangGraph. Files, semantic search, run logging, and cross-platform memory.
+MCP server for **AgentDrive** — the cross-agent artifact workspace with provenance and portable storage across Claude Code, Codex, Cursor, and LangGraph. Files, semantic recall, run logging, and cross-platform attribution.
 
 Drop this server into any MCP-compatible client and your agents get a shared filesystem with provenance, semantic search across artifacts written by other agents, and per-run audit. Memory is a feature of the workspace, not the headline.
 
@@ -66,7 +66,7 @@ env = { AGENTDRIVE_API_KEY = "agentdrive_live_...", AGENTDRIVE_AGENT_PLATFORM =
 }
 ```
 
-## Tools (16)
+## Tools (20)
 
 **Files**
 - `drive_write` — create or update a file with versioning

package/dist/api-client.d.ts

@@ -38,7 +38,6 @@ export interface ContextRequestBody {
     task: string;
     workspace_id?: string;
     limit?: number;
-    include_facts?: boolean;
 }
 export interface ContextArtifact extends SearchHit {
 }

package/dist/index.js

@@ -22,10 +22,36 @@ import { driveSandboxCloneSchema, driveSandboxClone } from './tools/drive-sandbo
 import { driveSandboxExecSchema, driveSandboxExec } from './tools/drive-sandbox-exec.js';
 import { driveSandboxReadSchema, driveSandboxRead } from './tools/drive-sandbox-read.js';
 import { driveSandboxCommitSchema, driveSandboxCommit } from './tools/drive-sandbox-commit.js';
+import { createRequire } from 'node:module';
+const require = createRequire(import.meta.url);
+const pkg = require('../package.json');
 const BASE_URL = process.env.AGENTDRIVE_API_URL || 'https://app.agentdrive.sh';
 const API_KEY = process.env.AGENTDRIVE_API_KEY;
 const AGENT_PLATFORM = process.env.AGENTDRIVE_AGENT_PLATFORM || 'claude-code';
 const AGENT_ROLE = process.env.AGENTDRIVE_AGENT_ROLE || '';
+// Cross-host preamble shipped via MCP `instructions` so every MCP-aware
+// client (Claude Code, Codex, Cursor, Zed, Cline, Continue, OpenClaw) gets
+// the same usage guidance at session start without needing a per-host
+// markdown file. Hosts that ALSO read a markdown rules file
+// (~/.claude/CLAUDE.md, ~/.codex/AGENTS.md, ~/.cursor/rules/agentdrive.mdc)
+// continue to get the more verbose adrive init preamble via auto-context.ts.
+const SERVER_INSTRUCTIONS = `AgentDrive — cross-agent artifact workspace with provenance for multi-agent workflows.
+
+Reach for these tools without waiting to be asked:
+
+- **Session start:** call \`drive_context\` with a short summary of the
+  current task. Returns the most relevant artifacts and last_run
+  summaries from prior agents' work in the same workspace, each with
+  an \`attribution\` block explaining *why* it was surfaced.
+- **Cross-agent recall:** call \`drive_search\` (semantic) when the
+  user asks "what did Codex / Cursor / the last session do?"
+- **Saving work:** call \`drive_write\` for any artifact worth keeping
+  so the next agent in the chain can read it back.
+- **Provenance:** call \`drive_log_run\` at the end of meaningful
+  work so the cross-agent timeline stays accurate.
+
+Privacy: if the user has Private Workspace on, written content is
+encrypted client-side; the AgentDrive server only stores ciphertext.`;
 if (!API_KEY) {
     console.error('AGENTDRIVE_API_KEY environment variable is required');
     process.exit(1);
@@ -38,8 +64,10 @@ const client = new ApiClient({
 });
 const server = new McpServer({
     name: 'agentdrive',
-    version: '0.4.0',
+    version: pkg.version,
     description: 'AgentDrive — the persistent workspace your agents share across Claude Code, Codex, Cursor, and LangGraph. Files, semantic search, run logging, cross-platform memory, and per-workspace Linux sandbox with git worktree.',
+}, {
+    instructions: SERVER_INSTRUCTIONS,
 });
 server.tool('drive_write', 'Write a markdown file to a workspace. Creates or updates the file with automatic versioning.', driveWriteSchema, (args) => driveWrite(client, args));
 server.tool('drive_read', 'Read a file\'s content from a workspace.', driveReadSchema, (args) => driveRead(client, args));
@@ -57,10 +85,16 @@ server.tool('drive_search', "Semantic search across your org's artifacts in Agen
 server.tool('drive_recall', 'Recall persistent facts and preferences your agents have written. In v1 this returns semantic search results across artifacts; v1.5 will narrow to auto-extracted facts (preferences, decisions, key entities).', driveRecallSchema, (args) => driveRecall(client, args));
 server.tool('drive_log_run', "Log an agent run to AgentDrive's provenance store. Captures task, status, referenced/produced artifacts, and cross-platform identity (which agent on which tool). Used for retrospective context retrieval and team-wide audit.", driveLogRunSchema, (args) => driveLogRun(client, args));
 server.tool('drive_context', 'Auto-pull the most relevant artifacts from prior agent sessions for the task you are about to do. Combines semantic relevance with recency. Call this at the START of any non-trivial task to ground the agent in prior context — replaces manual copy-paste of artifacts between sessions.', driveContextSchema, (args) => driveContext(client, args));
-server.tool('drive_sandbox_clone', 'Clone a git repo into a per-workspace Linux sandbox. The sandbox persists across MCP sessions for the workspace. Use this to set up a real dev environment your other agents can also drive.', driveSandboxCloneSchema, (args) => driveSandboxClone(client, args));
-server.tool('drive_sandbox_exec', 'Run a shell command inside the per-workspace Linux sandbox. Captures stdout/stderr (64KB cap), exit code, and duration. Use for `npm install`, running tests, file ops — any real dev workflow.', driveSandboxExecSchema, (args) => driveSandboxExec(client, args));
-server.tool('drive_sandbox_read', 'Read a file from the per-workspace sandbox filesystem (e.g., generated build artifacts, test output, log files).', driveSandboxReadSchema, (args) => driveSandboxRead(client, args));
-server.tool('drive_sandbox_commit', 'Stage + commit the current sandbox worktree. The commit surfaces as an AgentDrive artifact at commits/<sha>.json with cross-agent provenance — other agents on other platforms can see who shipped what.', driveSandboxCommitSchema, (args) => driveSandboxCommit(client, args));
+// The four drive_sandbox_* tools are EXPERIMENTAL. They require the
+// Cloudflare Containers plan on the AgentDrive worker; without that
+// binding the API returns 503 and these tools surface a clean
+// "not configured" message. Marked experimental in the description
+// so MCP-aware hosts that surface tool metadata can communicate the
+// status; not part of the v1 cross-agent value prop.
+server.tool('drive_sandbox_clone', '[EXPERIMENTAL] Clone a git repo into a per-workspace Linux sandbox. Requires Cloudflare Containers on the AgentDrive worker; gracefully degrades to a 503 with "sandbox not configured" otherwise.', driveSandboxCloneSchema, (args) => driveSandboxClone(client, args));
+server.tool('drive_sandbox_exec', '[EXPERIMENTAL] Run a shell command inside the per-workspace Linux sandbox. Captures stdout/stderr (64 KB cap), exit code, duration. Requires Cloudflare Containers; degrades to 503 otherwise.', driveSandboxExecSchema, (args) => driveSandboxExec(client, args));
+server.tool('drive_sandbox_read', '[EXPERIMENTAL] Read a file from the per-workspace sandbox filesystem (build artifacts, test output, logs). Requires Cloudflare Containers; degrades to 503 otherwise.', driveSandboxReadSchema, (args) => driveSandboxRead(client, args));
+server.tool('drive_sandbox_commit', '[EXPERIMENTAL] Stage + commit the current sandbox worktree. Surfaces as an AgentDrive artifact at commits/<sha>.json. Requires Cloudflare Containers; degrades to 503 otherwise.', driveSandboxCommitSchema, (args) => driveSandboxCommit(client, args));
 async function main() {
     const transport = new StdioServerTransport();
     await server.connect(transport);

package/dist/tools/drive-context.d.ts

@@ -4,13 +4,11 @@ export declare const driveContextSchema: {
     task: z.ZodString;
     workspace_id: z.ZodOptional<z.ZodString>;
     limit: z.ZodOptional<z.ZodNumber>;
-    include_facts: z.ZodOptional<z.ZodBoolean>;
 };
 export declare function driveContext(client: ApiClient, args: {
     task: string;
     workspace_id?: string;
     limit?: number;
-    include_facts?: boolean;
 }): Promise<{
     content: {
         type: "text";

package/dist/tools/drive-context.js

@@ -3,14 +3,12 @@ export const driveContextSchema = {
     task: z.string().min(1).max(2000).describe('What you are about to do — used to rank prior artifacts by relevance'),
     workspace_id: z.string().optional().describe('Scope to a single workspace; omit for org-wide context'),
     limit: z.number().int().positive().max(20).optional().describe('Max artifacts to return (default 5, max 20)'),
-    include_facts: z.boolean().optional().describe('Include extracted facts alongside artifacts (v1.5+)'),
 };
 export async function driveContext(client, args) {
     const { artifacts } = await client.context({
         task: args.task,
         workspace_id: args.workspace_id,
         limit: args.limit ?? 5,
-        include_facts: args.include_facts ?? false,
     });
     if (artifacts.length === 0) {
         return { content: [{ type: 'text', text: 'No prior context found.' }] };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@adrive/mcp-server",
-  "version": "0.4.0",
-  "description": "MCP server for AgentDrive — the persistent workspace your agents share across Claude Code, Codex, Cursor, and LangGraph. Files, semantic search, run logging, cross-platform memory, and per-workspace agent sandboxing.",
+  "version": "1.0.0",
+  "description": "MCP server for AgentDrive — cross-agent artifact workspace with provenance and portable storage across Claude Code, Codex, Cursor, and LangGraph.",
   "license": "Apache-2.0",
   "type": "module",
   "bin": {