vgxness 1.20.4 → 1.20.6

package/dist/mcp/stdio-server.js

@@ -1,116 +1 @@
-import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
-import { runBootAgentSeedUpgrade } from '../agents/boot-upgrade.js';
-import { createVgxMcpControlPlane } from './control-plane.js';
-import { EXPOSED_VGX_MCP_TOOL_NAMES, toInternalVgxMcpToolName, VGX_MCP_TOOL_INPUT_SCHEMAS, VGX_MCP_TOOL_OUTPUT_SCHEMAS, } from './schema.js';
-export async function startVgxMcpStdioServer(options = {}) {
-    const controlPlane = createVgxMcpControlPlane(options.databasePath === undefined ? {} : { databasePath: options.databasePath });
-    runBootAgentSeedUpgrade(controlPlane.database);
-    const mcpServer = new McpServer({ name: 'vgxness', version: '0.1.0' });
-    const transport = new StdioServerTransport();
-    let closed = false;
-    const close = async () => {
-        if (closed)
-            return;
-        closed = true;
-        process.off('SIGINT', closeOnSignal);
-        process.off('SIGTERM', closeOnSignal);
-        try {
-            await mcpServer.close();
-        }
-        finally {
-            controlPlane.close();
-        }
-    };
-    const closeOnSignal = () => {
-        void close().finally(() => {
-            process.exitCode = 0;
-        });
-    };
-    mcpServer.server.onclose = () => {
-        controlPlane.close();
-    };
-    registerVgxTools(mcpServer, controlPlane);
-    process.once('SIGINT', closeOnSignal);
-    process.once('SIGTERM', closeOnSignal);
-    await mcpServer.connect(transport);
-    return { close };
-}
-function registerVgxTools(server, controlPlane) {
-    for (const publicToolName of EXPOSED_VGX_MCP_TOOL_NAMES) {
-        const toolName = toInternalVgxMcpToolName(publicToolName);
-        const outputSchema = VGX_MCP_TOOL_OUTPUT_SCHEMAS[toolName];
-        server.registerTool(publicToolName, {
-            title: publicToolName,
-            description: descriptionForTool(publicToolName),
-            inputSchema: VGX_MCP_TOOL_INPUT_SCHEMAS[toolName],
-            ...(outputSchema === undefined ? {} : { outputSchema }),
-        }, async (args) => toMcpTextResult(controlPlane.callVgxTool(toolName, argsForTool(args))));
-    }
-}
-function descriptionForTool(publicToolName) {
-    if (publicToolName === 'provider_status')
-        return 'Agent-callable read-only provider status report; inspects expected config paths without installing, repairing, or writing provider config, and does not verify true host tool presence. Use it to decide whether to inspect doctor output or request explicit setup consent.';
-    if (publicToolName === 'provider_doctor')
-        return 'Agent-callable read-only provider doctor advisory; checks VGXNESS-known provider config health without install/repair/config writes and without proving true host tool presence. Use it to decide the next setup or troubleshooting recommendation.';
-    if (publicToolName === 'provider_change_plan')
-        return 'Read-only provider change plan preview; composes status, doctor, and OpenCode install planning without writing provider config.';
-    if (publicToolName === 'opencode_handoff_preview')
-        return 'Read-only OpenCode handoff preview; returns compact context for continuing in OpenCode conversation with VGXNESS MCP and hidden SDD subagents, does not execute/control OpenCode, write .opencode/provider config, or create runs, checkpoints, events, sessions, or skill-usage records. Request verbose manager payload separately when artifact bodies are needed.';
-    if (publicToolName === 'verification_plan')
-        return 'Read-only verification plan recommendations only; does not execute commands, write provider config, persist results, create checkpoints, or infer SDD acceptance.';
-    if (publicToolName === 'run_resume_candidates')
-        return 'Read-only interrupted run resume candidate discovery by project; lists bounded failed, blocked, and needs-human runs without mutation, retry admission, provider execution, artifact/config/openspec writes, sandboxes, worktrees, or sessions.';
-    if (publicToolName === 'run_resume_inspect')
-        return 'Read-only run resume advisory inspect; plan-only and does not execute resume logic, invoke providers, write provider config, mutate retry/abandon/attempt state, or reconstruct sandboxes, worktrees, sessions, or transcripts.';
-    if (publicToolName === 'run_resume_gate')
-        return 'Read-only run resume gate advisory; plan-only and does not execute resume logic, invoke providers, write provider config, admit retries, abandon or mutate attempts, or reconstruct sandboxes, worktrees, sessions, or transcripts.';
-    if (publicToolName === 'context_cockpit')
-        return 'Read-only context cockpit for start/resume/recovery; change is optional and should be omitted when unknown; returns latest restorable session plus bounded memory previews without traces, provider config writes, repository writes, runs, artifacts, or session mutations.';
-    if (publicToolName === 'resume_context')
-        return 'Read-only no-trace/no-mutation resume gate required before generic resume prompts; decides explicit change, interrupted run inspect, single active-work, or ask-change without provider execution, repository inspection, traces, runs, artifacts, sessions, memory writes, or provider config writes.';
-    if (publicToolName === 'skill_index')
-        return 'Read-only skill registry index for a project and scope; returns SkillIndexOutput without provider config writes, native skill file writes, URL fetches, usage records, startup refresh, or plugin refresh.';
-    if (publicToolName === 'skill_create_draft')
-        return 'Creates a draft skill version and lifecycle event without publishing, activation, provider config writes, or native skill installation.';
-    if (publicToolName === 'skill_update_draft')
-        return 'Updates only draft skill versions with optional optimistic revision checking; rejects active, deprecated, or archived version mutation.';
-    if (publicToolName === 'skill_publish_version')
-        return 'Publishes a draft skill version as active/current with explicit actor and reason; publication is not activation, SDD acceptance, or correctness proof.';
-    if (publicToolName === 'sdd_cockpit')
-        return 'Agent-callable read-only SDD cockpit summary; returns phase metadata/readModel without artifact bodies or state changes and preserves explicit human acceptance semantics. Use it to decide the next safe SDD action or blocker.';
-    if (publicToolName === 'sdd_continue')
-        return 'Agent-callable read-only SDD continuation advisory; returns blocker actions, suggested next steps, interrupted-run context, and safety notes without provider execution, run creation, artifact mutation, provider config writes, or openspec writes. Use it to choose the next manual or agent-safe action.';
-    if (publicToolName === 'sdd_status')
-        return 'Agent-callable read-only SDD status summary; reports phase presence/state and next ready phase without creating, accepting, or mutating artifacts. Use it to decide whether to inspect, draft, mark ready, or wait for human acceptance.';
-    if (publicToolName === 'sdd_get_readiness')
-        return 'Agent-callable read-only SDD readiness check; reports whether a phase can proceed and why, without marking ready or changing artifacts. Use it to decide whether to call sdd_ready or resolve prerequisites first.';
-    if (publicToolName === 'sdd_ready')
-        return 'Agent-callable state-changing SDD readiness marker; marks an existing phase artifact ready when prerequisites allow, but does not human-accept it. Use only after readiness is clear, then ask a human to accept when governance requires acceptance.';
-    if (publicToolName === 'sdd_accept_artifact')
-        return 'Human-only mutating SDD acceptance gate; records explicit human acceptance for an artifact and must not be called by agents on their own behalf. Use only after a human approval decision, then continue to the next phase.';
-    if (publicToolName === 'sdd_reopen_artifact')
-        return 'Human-only mutating SDD reopen gate; records an explicit human decision to reopen an artifact and must not be called by agents on their own behalf. Use only after human instruction, then revise or re-review the phase.';
-    if (publicToolName === 'run_preflight')
-        return 'Agent-callable advisory/planning-only run preflight; evaluates permissions, records a plan, and returns a workspace strategy recommendation, but does not execute the checked shell/git/install/network/provider/secrets operation and does not create branches, worktrees, or pull requests. Use it to decide whether human approval or a separate executor step is required.';
-    if (publicToolName === 'run_task_grant_create')
-        return 'Human-approved lifecycle tool that creates a task-scoped command grant for bounded allowlisted external command operations.';
-    if (publicToolName === 'run_task_grant_list' || publicToolName === 'run_task_grant_get' || publicToolName === 'run_task_grant_preview_match')
-        return 'Read-only task-scoped command grant lifecycle tool; does not execute commands, write provider config, or consume grant usage.';
-    if (publicToolName === 'run_task_grant_revoke')
-        return 'Revokes a task-scoped command grant with an explicit human or system actor and reason.';
-    const toolName = toInternalVgxMcpToolName(publicToolName);
-    return `VGX control-plane tool ${toolName}`;
-}
-function argsForTool(args) {
-    return args;
-}
-function toMcpTextResult(envelope) {
-    const result = {
-        content: [{ type: 'text', text: JSON.stringify(envelope, null, 2) }],
-        structuredContent: envelope,
-    };
-    if (!envelope.ok)
-        result.isError = true;
-    return result;
-}
+export * from '../interfaces/mcp/stdio-server.js';