vana-cli 0.15.0

package/dist/cli/mcp-server.js

@@ -0,0 +1,199 @@
+/**
+ * MCP (Model Context Protocol) server for agent integration.
+ *
+ * Exposes high-level tools over stdio so any MCP-compatible agent
+ * (Claude Code, Cursor, etc.) can discover and call them.
+ *
+ * CRITICAL: All logging/output goes to stderr. stdout is the JSON-RPC transport.
+ */
+import { spawn } from "node:child_process";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { getCliVersion } from "./index.js";
+import { queryStatus, querySources, queryDataShow, queryDoctor, } from "./queries.js";
+/**
+ * Start the MCP server on stdio.
+ *
+ * Returns a promise that resolves when the transport disconnects.
+ */
+export async function startMcpServer() {
+    const version = getCliVersion();
+    const server = new McpServer({
+        name: "vana",
+        version,
+    });
+    // ── Tool: check_status ───────────────────────────────────────────────
+    server.tool("check_status", "Check system health: runtime state, Personal Server connection, and connected source status", async () => {
+        const result = await queryStatus();
+        return {
+            content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+        };
+    });
+    // ── Tool: list_sources ───────────────────────────────────────────────
+    server.tool("list_sources", "List available data sources that can be connected for personal data collection", { filter: z.string().optional().describe("Filter sources by name") }, async ({ filter }) => {
+        const result = await querySources();
+        if (filter) {
+            const lowerFilter = filter.toLowerCase();
+            result.sources = result.sources.filter((s) => s.id.toLowerCase().includes(lowerFilter) ||
+                s.name.toLowerCase().includes(lowerFilter));
+            result.count = result.sources.length;
+        }
+        return {
+            content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+        };
+    });
+    // ── Tool: show_data ──────────────────────────────────────────────────
+    server.tool("show_data", "Inspect collected data for a connected source. Shows data summary, sync status, and file paths", { source: z.string().describe("Source identifier (e.g. github, twitter)") }, async ({ source }) => {
+        const result = await queryDataShow(source);
+        return {
+            content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+        };
+    });
+    // ── Tool: connect_source ─────────────────────────────────────────────
+    server.tool("connect_source", "Connect a platform and collect personal data. Runs the full connect flow: setup, authentication, data collection, and sync", { source: z.string().describe("Source identifier (e.g. github, twitter)") }, async ({ source }) => {
+        // Check auth mode before spawning — legacy sources need a headed
+        // browser and cannot be connected by an agent.
+        const sourcesResult = await querySources();
+        const sourceInfo = sourcesResult.sources?.find((s) => s.id === source || s.name?.toLowerCase() === source.toLowerCase());
+        if (sourceInfo?.authMode === "legacy") {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `${sourceInfo.name ?? source} requires browser login. The user must run this in their own terminal:\n\nvana connect ${source}\n\nThis source cannot be connected by an agent.`,
+                    },
+                ],
+            };
+        }
+        return await runConnectAsChild(source);
+    });
+    // ── Tool: run_diagnostics ────────────────────────────────────────────
+    server.tool("run_diagnostics", "Run detailed system diagnostics: CLI version, runtime paths, browser state, connector cache, and source-level issues", async () => {
+        const result = await queryDoctor();
+        return {
+            content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+        };
+    });
+    // ── Tool: generate_context (placeholder) ─────────────────────────────
+    server.tool("generate_context", "Generate prioritized suggestions for the next agent prompt based on connected personal data (coming soon)", async () => {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: "Not yet implemented. Install with: vana skill install next-prompt",
+                },
+            ],
+        };
+    });
+    // ── Connect transport and run ────────────────────────────────────────
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    // Wait until the transport closes
+    return new Promise((resolve) => {
+        transport.onclose = () => resolve();
+    });
+}
+// ── Child process runner for connect_source ──────────────────────────
+/**
+ * Run `vana connect <source> --json --ipc` as a child process.
+ *
+ * The MCP server's stdout is the JSON-RPC transport, so the connect flow
+ * must run in a separate process. We collect the child's stdout (JSONL events)
+ * and stderr, parse the final outcome, and return a structured summary.
+ *
+ * Uses --ipc instead of --no-input so the connector can pause for
+ * credential input via file-based IPC rather than failing immediately.
+ */
+async function runConnectAsChild(source) {
+    return new Promise((resolve) => {
+        const child = spawn(process.execPath, [process.argv[1], "connect", source, "--json", "--ipc"], {
+            stdio: ["ignore", "pipe", "pipe"],
+            env: { ...process.env },
+        });
+        const stdoutChunks = [];
+        const stderrChunks = [];
+        child.stdout.on("data", (chunk) => stdoutChunks.push(chunk));
+        child.stderr.on("data", (chunk) => stderrChunks.push(chunk));
+        child.on("error", (err) => {
+            resolve({
+                content: [
+                    {
+                        type: "text",
+                        text: `Failed to start connect process: ${err.message}`,
+                    },
+                ],
+                isError: true,
+            });
+        });
+        child.on("close", (code) => {
+            const stdout = Buffer.concat(stdoutChunks).toString("utf8");
+            const stderr = Buffer.concat(stderrChunks).toString("utf8");
+            // Parse JSONL events from stdout
+            const events = [];
+            for (const line of stdout.split("\n")) {
+                const trimmed = line.trim();
+                if (!trimmed)
+                    continue;
+                try {
+                    events.push(JSON.parse(trimmed));
+                }
+                catch {
+                    // Skip non-JSON lines
+                }
+            }
+            // Find the final outcome event (last event with an "outcome" field)
+            const outcomeEvent = [...events]
+                .reverse()
+                .find((e) => "outcome" in e || "event" in e);
+            const summary = buildConnectSummary(source, code, events, outcomeEvent);
+            // If the outcome indicates interactive input is needed, explain
+            if (outcomeEvent &&
+                (outcomeEvent.outcome === "needs_input" ||
+                    outcomeEvent.event === "needs_input")) {
+                summary.push("", `This source requires interactive authentication. Run \`vana connect ${source}\` in a terminal to complete the flow.`);
+            }
+            if (stderr.trim()) {
+                summary.push("", "Stderr:", stderr.trim());
+            }
+            resolve({
+                content: [{ type: "text", text: summary.join("\n") }],
+                isError: code !== 0,
+            });
+        });
+    });
+}
+/**
+ * Build a human-readable summary from connect child process results.
+ */
+function buildConnectSummary(source, exitCode, events, outcomeEvent) {
+    const lines = [];
+    if (exitCode === 0) {
+        lines.push(`Connected ${source} successfully.`);
+    }
+    else {
+        lines.push(`Connect ${source} exited with code ${exitCode ?? "unknown"}.`);
+    }
+    // Summarize collected data from events
+    const scopeEvents = events.filter((e) => e.event === "scope_complete" || e.event === "scope_collected");
+    if (scopeEvents.length > 0) {
+        lines.push("", "Collected data:", ...scopeEvents.map((e) => {
+            const scope = e.scope ?? e.name ?? "unknown";
+            const count = e.count ?? e.itemCount;
+            return count != null ? `  ${scope} (${count} items)` : `  ${scope}`;
+        }));
+    }
+    if (outcomeEvent) {
+        const outcome = outcomeEvent.outcome ?? outcomeEvent.event;
+        if (outcome &&
+            outcome !== "scope_complete" &&
+            outcome !== "scope_collected") {
+            lines.push("", `Outcome: ${outcome}`);
+        }
+        if (outcomeEvent.message) {
+            lines.push(`Detail: ${outcomeEvent.message}`);
+        }
+    }
+    return lines;
+}
+//# sourceMappingURL=mcp-server.js.map

package/dist/cli/mcp-server.js.map

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

package/dist/cli/queries.d.ts

@@ -0,0 +1,128 @@
+/**
+ * Pure data-gathering query functions for CLI commands.
+ *
+ * Each function returns the structured data that the corresponding `run*`
+ * handler needs for both `--json` serialization and human rendering.
+ * No stdout/stderr writes happen here.
+ */
+import type { CliDoctor, CliStatus, SourceStatus } from "../core/cli-types.js";
+import type { AvailableSource } from "../connectors/registry.js";
+/** Result of `queryStatus()`. Contains everything both JSON and human paths need. */
+export interface StatusQueryResult {
+    status: CliStatus;
+    nextSteps: string[];
+}
+/** Result of `querySources()`. Matches the `--json` output shape exactly. */
+export interface SourcesQueryResult {
+    count: number;
+    recommendedSource: (AvailableSource & {
+        installed: boolean;
+        dataState?: SourceStatus["dataState"];
+        lastRunOutcome?: string | null;
+        sessionPresent?: boolean;
+    }) | null;
+    nextSteps: string[];
+    summary: {
+        connectedCount: number;
+        readyCount: number;
+        manualCount: number;
+        installedCount: number;
+    };
+    sources: Array<AvailableSource & {
+        installed: boolean;
+        dataState?: SourceStatus["dataState"];
+        lastRunOutcome?: string | null;
+        sessionPresent?: boolean;
+    }>;
+}
+/** A single dataset record as returned by data-list and data-show queries. */
+export interface DatasetRecord {
+    source: string;
+    name: string | null;
+    authMode: "automated" | "interactive" | "legacy" | null;
+    dataState?: SourceStatus["dataState"];
+    lastRunAt: string | null;
+    path: string | null;
+    summary: {
+        lines: string[];
+    } | null;
+}
+/** Result of `queryDataList()`. Matches the `--json` output shape exactly. */
+export interface DataListQueryResult {
+    count: number;
+    latestDataset: DatasetRecord | null;
+    nextSteps: string[];
+    summary: {
+        localCount: number;
+        syncedCount: number;
+        syncFailedCount: number;
+    };
+    datasets: DatasetRecord[];
+}
+/** Successful result of `queryDataShow()`. */
+export interface DataShowSuccess {
+    ok: true;
+    source: string;
+    name: string;
+    path: string;
+    summary: {
+        lines: string[];
+    } | null;
+    lastRunAt: string | null;
+    dataState: SourceStatus["dataState"] | null;
+    nextSteps: string[];
+    data: Record<string, unknown>;
+    datasetCount: number;
+}
+/** Not-found result of `queryDataShow()`. */
+export interface DataShowNotFound {
+    ok: false;
+    error: "dataset_not_found";
+    source: string;
+    message: string;
+    nextSteps: string[];
+    datasetCount: number;
+}
+/** Read-failure result of `queryDataShow()`. */
+export interface DataShowReadFailed {
+    ok: false;
+    error: "dataset_read_failed";
+    source: string;
+    path: string;
+    message: string;
+}
+export type DataShowQueryResult = DataShowSuccess | DataShowNotFound | DataShowReadFailed;
+/** Result of `queryDoctor()`. Matches the `CliDoctor` type exactly. */
+export type DoctorQueryResult = CliDoctor;
+/**
+ * Gather status data for `vana status`.
+ *
+ * Returns the full `CliStatus` plus computed `nextSteps`.
+ * The `--json` handler selects the compact subset it needs.
+ */
+export declare function queryStatus(): Promise<StatusQueryResult>;
+/**
+ * Gather sources data for `vana sources`.
+ *
+ * Returns the enriched source list with counts and recommendations.
+ */
+export declare function querySources(): Promise<SourcesQueryResult>;
+/**
+ * Gather dataset list for `vana data list`.
+ *
+ * Returns all collected datasets with summaries and counts.
+ */
+export declare function queryDataList(): Promise<DataListQueryResult>;
+/**
+ * Gather data for `vana data show <source>`.
+ *
+ * Returns the dataset contents and metadata, or an error descriptor.
+ */
+export declare function queryDataShow(source: string): Promise<DataShowQueryResult>;
+/**
+ * Gather diagnostic data for `vana doctor`.
+ *
+ * Returns the full `CliDoctor` payload.
+ */
+export declare function queryDoctor(): Promise<DoctorQueryResult>;
+//# sourceMappingURL=queries.d.ts.map

package/dist/cli/queries.d.ts.map

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