promptspeak-mcp-server 0.1.0

package/dist/tools/registry.js

@@ -0,0 +1,456 @@
+/**
+ * ═══════════════════════════════════════════════════════════════════════════════
+ * MCP TOOL REGISTRY
+ * ═══════════════════════════════════════════════════════════════════════════════
+ *
+ * Central registry for all MCP tool definitions.
+ * Separates tool metadata from routing logic for maintainability.
+ *
+ * Tool categories:
+ * - VALIDATION_TOOLS: Frame validation (ps_validate, ps_validate_batch)
+ * - EXECUTION_TOOLS: Governed execution (ps_execute, ps_execute_dry_run)
+ * - DELEGATION_TOOLS: Task delegation (ps_delegate, ps_delegate_*)
+ * - STATE_TOOLS: Agent state management (ps_state_*)
+ * - CONFIG_TOOLS: Operator configuration (ps_config_*)
+ * - CONFIDENCE_TOOLS: Confidence thresholds (ps_confidence_*)
+ * - FEATURE_TOOLS: Feature flags (ps_feature_*)
+ * - AUDIT_TOOLS: Audit logging (ps_audit_*)
+ *
+ * External tool definitions are imported from their respective modules.
+ * ═══════════════════════════════════════════════════════════════════════════════
+ */
+// Import external tool definitions
+import { holdToolDefinitions } from './ps_hold.js';
+import { legalToolDefinitions } from './ps_legal.js';
+import { calendarToolDefinitions } from './ps_calendar.js';
+import { symbolToolDefinitions } from '../symbols/index.js';
+import { translationToolDefinitions } from '../translation/index.js';
+import { multiAgentToolDefinitions } from '../multi_agent/index.js';
+import { swarmToolDefinitions, intelligenceToolDefinitions } from '../swarm/index.js';
+import { reconToolDefinitions } from '../handlers/recon-tools.js';
+// ─────────────────────────────────────────────────────────────────────────────
+// VALIDATION TOOLS
+// ─────────────────────────────────────────────────────────────────────────────
+export const VALIDATION_TOOLS = [
+    {
+        name: 'ps_validate',
+        description: 'Validate a PromptSpeak frame. Returns validation report with errors, warnings, and suggestions.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                frame: { type: 'string', description: 'The PromptSpeak frame to validate (e.g., "⊕◊▶β")' },
+                parentFrame: { type: 'string', description: 'Optional parent frame for chain validation' },
+                validationLevel: {
+                    type: 'string',
+                    enum: ['structural', 'semantic', 'chain', 'full'],
+                    description: 'Level of validation to perform'
+                },
+                strict: { type: 'boolean', description: 'If true, warnings also cause validation failure' }
+            },
+            required: ['frame']
+        }
+    },
+    {
+        name: 'ps_validate_batch',
+        description: 'Validate multiple frames at once. Useful for validating delegation chains.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                frames: {
+                    type: 'array',
+                    items: {
+                        type: 'object',
+                        properties: {
+                            frame: { type: 'string' },
+                            parentFrame: { type: 'string' }
+                        },
+                        required: ['frame']
+                    }
+                },
+                validationLevel: { type: 'string', enum: ['structural', 'semantic', 'chain', 'full'] },
+                strict: { type: 'boolean' },
+                stopOnFirstError: { type: 'boolean' }
+            },
+            required: ['frames']
+        }
+    }
+];
+// ─────────────────────────────────────────────────────────────────────────────
+// EXECUTION TOOLS
+// ─────────────────────────────────────────────────────────────────────────────
+export const EXECUTION_TOOLS = [
+    {
+        name: 'ps_execute',
+        description: 'Execute an action under PromptSpeak frame governance. The gatekeeper validates and enforces constraints.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                agentId: { type: 'string', description: 'Unique identifier for the executing agent' },
+                frame: { type: 'string', description: 'The governing PromptSpeak frame' },
+                action: {
+                    type: 'object',
+                    properties: {
+                        tool: { type: 'string', description: 'The tool/action to execute' },
+                        arguments: { type: 'object', description: 'Arguments for the tool' },
+                        description: { type: 'string' }
+                    },
+                    required: ['tool', 'arguments']
+                },
+                parentFrame: { type: 'string', description: 'Parent frame if part of delegation chain' }
+            },
+            required: ['agentId', 'frame', 'action']
+        }
+    },
+    {
+        name: 'ps_execute_dry_run',
+        description: 'Check if an action would succeed without executing. Returns decision and coverage analysis.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                agentId: { type: 'string' },
+                frame: { type: 'string' },
+                action: {
+                    type: 'object',
+                    properties: {
+                        tool: { type: 'string' },
+                        arguments: { type: 'object' }
+                    },
+                    required: ['tool', 'arguments']
+                },
+                parentFrame: { type: 'string' }
+            },
+            required: ['agentId', 'frame', 'action']
+        }
+    }
+];
+// ─────────────────────────────────────────────────────────────────────────────
+// DELEGATION TOOLS
+// ─────────────────────────────────────────────────────────────────────────────
+export const DELEGATION_TOOLS = [
+    {
+        name: 'ps_delegate',
+        description: 'Delegate a task from parent agent to child agent. Enforces inheritance rules and constraint propagation.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                parentAgentId: { type: 'string' },
+                childAgentId: { type: 'string' },
+                parentFrame: { type: 'string' },
+                childFrame: { type: 'string' },
+                task: {
+                    type: 'object',
+                    properties: {
+                        description: { type: 'string' },
+                        constraints: { type: 'array', items: { type: 'string' } },
+                        deadline: { type: 'number' }
+                    }
+                },
+                inheritanceMode: { type: 'string', enum: ['strict', 'relaxed', 'custom'] }
+            },
+            required: ['parentAgentId', 'childAgentId', 'parentFrame', 'childFrame']
+        }
+    },
+    {
+        name: 'ps_delegate_revoke',
+        description: 'Revoke an active delegation.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                delegationId: { type: 'string' },
+                parentAgentId: { type: 'string' },
+                reason: { type: 'string' }
+            },
+            required: ['delegationId', 'parentAgentId']
+        }
+    },
+    {
+        name: 'ps_delegate_list',
+        description: 'List delegations for an agent.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                agentId: { type: 'string' },
+                role: { type: 'string', enum: ['parent', 'child', 'both'] },
+                status: { type: 'string', enum: ['active', 'completed', 'revoked', 'all'] }
+            },
+            required: ['agentId']
+        }
+    }
+];
+// ─────────────────────────────────────────────────────────────────────────────
+// STATE TOOLS
+// ─────────────────────────────────────────────────────────────────────────────
+export const STATE_TOOLS = [
+    {
+        name: 'ps_state_get',
+        description: 'Get current state of an agent including drift metrics and circuit breaker status.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                agentId: { type: 'string' }
+            },
+            required: ['agentId']
+        }
+    },
+    {
+        name: 'ps_state_system',
+        description: 'Get overall system state including all agents, operations, and drift alerts.',
+        inputSchema: {
+            type: 'object',
+            properties: {}
+        }
+    },
+    {
+        name: 'ps_state_reset',
+        description: 'Reset agent state. Can reset circuit breaker, drift metrics, and/or baseline.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                agentId: { type: 'string' },
+                resetCircuitBreaker: { type: 'boolean' },
+                resetDriftMetrics: { type: 'boolean' },
+                resetBaseline: { type: 'boolean' },
+                reason: { type: 'string' }
+            },
+            required: ['agentId', 'reason']
+        }
+    },
+    {
+        name: 'ps_state_halt',
+        description: 'Immediately halt an agent by opening its circuit breaker.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                agentId: { type: 'string' },
+                reason: { type: 'string' }
+            },
+            required: ['agentId', 'reason']
+        }
+    },
+    {
+        name: 'ps_state_resume',
+        description: 'Resume a halted agent.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                agentId: { type: 'string' },
+                reason: { type: 'string' },
+                resetMetrics: { type: 'boolean' }
+            },
+            required: ['agentId', 'reason']
+        }
+    },
+    {
+        name: 'ps_state_drift_history',
+        description: 'Get drift history for an agent.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                agentId: { type: 'string' },
+                since: { type: 'number', description: 'Unix timestamp' },
+                limit: { type: 'number' }
+            },
+            required: ['agentId']
+        }
+    }
+];
+// ─────────────────────────────────────────────────────────────────────────────
+// CONFIG TOOLS (Operator)
+// ─────────────────────────────────────────────────────────────────────────────
+export const CONFIG_TOOLS = [
+    {
+        name: 'ps_config_set',
+        description: 'Register a new policy overlay.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                overlayId: { type: 'string' },
+                overlay: { type: 'object' }
+            },
+            required: ['overlayId', 'overlay']
+        }
+    },
+    {
+        name: 'ps_config_activate',
+        description: 'Activate a registered policy overlay.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                overlayId: { type: 'string' }
+            },
+            required: ['overlayId']
+        }
+    },
+    {
+        name: 'ps_config_get',
+        description: 'Get current configuration including active overlay and thresholds.',
+        inputSchema: {
+            type: 'object',
+            properties: {}
+        }
+    },
+    {
+        name: 'ps_config_export',
+        description: 'Export current configuration for backup.',
+        inputSchema: {
+            type: 'object',
+            properties: {}
+        }
+    },
+    {
+        name: 'ps_config_import',
+        description: 'Import configuration from backup.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                data: { type: 'string' },
+                expectedChecksum: { type: 'string' }
+            },
+            required: ['data']
+        }
+    }
+];
+// ─────────────────────────────────────────────────────────────────────────────
+// CONFIDENCE TOOLS (Operator)
+// ─────────────────────────────────────────────────────────────────────────────
+export const CONFIDENCE_TOOLS = [
+    {
+        name: 'ps_confidence_set',
+        description: 'Set a confidence threshold. This is the hidden knob for operators.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                threshold: {
+                    type: 'string',
+                    enum: ['parseConfidence', 'coverageConfidence', 'chainConfidence', 'driftThreshold', 'tripwireThreshold']
+                },
+                value: { type: 'number', minimum: 0, maximum: 1 }
+            },
+            required: ['threshold', 'value']
+        }
+    },
+    {
+        name: 'ps_confidence_get',
+        description: 'Get all confidence thresholds.',
+        inputSchema: {
+            type: 'object',
+            properties: {}
+        }
+    },
+    {
+        name: 'ps_confidence_bulk_set',
+        description: 'Set multiple confidence thresholds at once.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                thresholds: { type: 'object' }
+            },
+            required: ['thresholds']
+        }
+    }
+];
+// ─────────────────────────────────────────────────────────────────────────────
+// FEATURE TOOLS
+// ─────────────────────────────────────────────────────────────────────────────
+export const FEATURE_TOOLS = [
+    {
+        name: 'ps_feature_set',
+        description: 'Set a feature flag.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                flag: { type: 'string' },
+                enabled: { type: 'boolean' }
+            },
+            required: ['flag', 'enabled']
+        }
+    },
+    {
+        name: 'ps_feature_get',
+        description: 'Get all feature flags.',
+        inputSchema: {
+            type: 'object',
+            properties: {}
+        }
+    }
+];
+// ─────────────────────────────────────────────────────────────────────────────
+// AUDIT TOOLS
+// ─────────────────────────────────────────────────────────────────────────────
+export const AUDIT_TOOLS = [
+    {
+        name: 'ps_audit_get',
+        description: 'Get audit log entries.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                since: { type: 'number' },
+                action: { type: 'string' },
+                limit: { type: 'number' }
+            }
+        }
+    }
+];
+// ─────────────────────────────────────────────────────────────────────────────
+// EXTERNAL TOOL DEFINITIONS (re-exported for convenience)
+// ─────────────────────────────────────────────────────────────────────────────
+export { holdToolDefinitions, legalToolDefinitions, calendarToolDefinitions, symbolToolDefinitions, translationToolDefinitions, multiAgentToolDefinitions, swarmToolDefinitions, intelligenceToolDefinitions, reconToolDefinitions, };
+// ─────────────────────────────────────────────────────────────────────────────
+// REGISTRY BUILDER
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Build the complete tool registry.
+ * Groups tools by category for organization and returns a flat array.
+ *
+ * @returns Complete array of all MCP tool definitions
+ */
+export function buildToolRegistry() {
+    return [
+        // Core tool schemas
+        ...VALIDATION_TOOLS,
+        ...EXECUTION_TOOLS,
+        ...DELEGATION_TOOLS,
+        ...STATE_TOOLS,
+        ...CONFIG_TOOLS,
+        ...CONFIDENCE_TOOLS,
+        ...FEATURE_TOOLS,
+        ...AUDIT_TOOLS,
+        // External tool definitions
+        ...holdToolDefinitions, // Hold Management (Human-in-the-Loop)
+        ...legalToolDefinitions, // Legal Citation Verification
+        ...calendarToolDefinitions, // Legal Calendar
+        ...symbolToolDefinitions, // Directive Symbol Registry
+        ...translationToolDefinitions, // Translation Layer
+        ...multiAgentToolDefinitions, // Multi-Agent / Commander's Intent
+        ...swarmToolDefinitions, // Market Agent Swarm
+        ...intelligenceToolDefinitions, // Market Intelligence (Swarm)
+        ...reconToolDefinitions, // Marine Recon Agent
+    ];
+}
+/**
+ * Get tool count by category for diagnostics.
+ * Category names match those in handlers/tool-registry.ts for consistency.
+ */
+export function getToolStats() {
+    return {
+        validation: VALIDATION_TOOLS.length,
+        execution: EXECUTION_TOOLS.length,
+        delegation: DELEGATION_TOOLS.length,
+        state: STATE_TOOLS.length,
+        config: CONFIG_TOOLS.length,
+        confidence: CONFIDENCE_TOOLS.length,
+        feature: FEATURE_TOOLS.length,
+        audit: AUDIT_TOOLS.length,
+        hold: holdToolDefinitions.length,
+        legal: legalToolDefinitions.length,
+        calendar: calendarToolDefinitions.length,
+        symbol: symbolToolDefinitions.length,
+        translation: translationToolDefinitions.length,
+        multiAgent: multiAgentToolDefinitions.length,
+        swarm: swarmToolDefinitions.length,
+        intel: intelligenceToolDefinitions.length,
+        recon: reconToolDefinitions.length,
+        total: buildToolRegistry().length
+    };
+}
+//# sourceMappingURL=registry.js.map

package/dist/tools/registry.js.map

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

package/dist/translation/compiler.d.ts

@@ -0,0 +1,37 @@
+import type { NLCompileRequest, NLCompileResponse } from './types.js';
+export declare class NLCompiler {
+    /**
+     * Compile natural language into PromptSpeak symbol and/or frame.
+     */
+    compile(request: NLCompileRequest): Promise<NLCompileResponse>;
+    /**
+     * Infer frame from natural language and LLM extraction.
+     */
+    private inferFrame;
+    /**
+     * Generate symbol ID and metadata.
+     */
+    private generateSymbol;
+    /**
+     * Generate a symbol ID from extracted content.
+     */
+    private generateSymbolId;
+    /**
+     * Build reasoning explanation.
+     */
+    private buildReasoning;
+    /**
+     * Generate alternative interpretations if confidence is low.
+     */
+    private generateAlternatives;
+    /**
+     * Simple hash function for content.
+     */
+    private simpleHash;
+}
+export declare const nlCompiler: NLCompiler;
+/**
+ * Compile natural language to PromptSpeak symbols and frames.
+ */
+export declare function compileNL(naturalLanguage: string, options?: Partial<NLCompileRequest>): Promise<NLCompileResponse>;
+//# sourceMappingURL=compiler.d.ts.map

package/dist/translation/compiler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compiler.d.ts","sourceRoot":"","sources":["../../src/translation/compiler.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACV,gBAAgB,EAChB,iBAAiB,EAIlB,MAAM,YAAY,CAAC;AAWpB,qBAAa,UAAU;IACrB;;OAEG;IACG,OAAO,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IA4DpE;;OAEG;IACH,OAAO,CAAC,UAAU;IA+DlB;;OAEG;YACW,cAAc;IA0C5B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IA0BxB;;OAEG;IACH,OAAO,CAAC,cAAc;IAuBtB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IA+B5B;;OAEG;IACH,OAAO,CAAC,UAAU;CASnB;AAMD,eAAO,MAAM,UAAU,YAAmB,CAAC;AAM3C;;GAEG;AACH,wBAAsB,SAAS,CAC7B,eAAe,EAAE,MAAM,EACvB,OAAO,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAClC,OAAO,CAAC,iBAAiB,CAAC,CAY5B"}