promptspeak-mcp-server 0.1.0

package/dist/agents/types.d.ts

@@ -0,0 +1,513 @@
+/**
+ * Multi-Agent Data Intelligence Framework (MADIF) - Core Types
+ *
+ * This module defines the type system for the agent orchestration layer,
+ * including agent definitions, instances, proposals, and lifecycle management.
+ */
+import type { SymbolCategory } from '../symbols/types.js';
+/**
+ * Capabilities that agents can request for their operations.
+ * Each capability grants specific permissions to the agent.
+ */
+export type AgentCapability = 'web_scraping' | 'api_rest' | 'api_graphql' | 'api_soap' | 'auth_oauth2' | 'auth_api_key' | 'auth_bearer' | 'auth_basic' | 'file_read' | 'file_write' | 'database_read' | 'database_write' | 'symbol_create' | 'symbol_update' | 'symbol_delete' | 'delegation_spawn' | 'external_service' | 'llm_inference';
+/**
+ * Classification of data source types.
+ */
+export type DataSourceType = 'rest_api' | 'graphql' | 'soap' | 'web_page' | 'rss_feed' | 'file' | 'database' | 'github' | 'huggingface';
+/**
+ * Authentication configuration for a data source.
+ */
+export interface DataSourceAuth {
+    type: 'none' | 'api_key' | 'oauth2' | 'bearer' | 'basic';
+    /** Reference to credential in secure storage (never the actual secret) */
+    credentialRef?: string;
+    /** Header name for API key (e.g., 'X-Api-Key') */
+    headerName?: string;
+    /** OAuth2 specific config */
+    oauth2Config?: {
+        authorizationUrl?: string;
+        tokenUrl?: string;
+        scopes?: string[];
+    };
+}
+/**
+ * Rate limiting configuration for a data source.
+ */
+export interface RateLimitConfig {
+    requestsPerMinute: number;
+    requestsPerHour?: number;
+    requestsPerDay?: number;
+    /** Minimum delay between requests in ms */
+    minDelayMs?: number;
+}
+/**
+ * Specification for a data source that an agent will access.
+ */
+export interface DataSourceSpec {
+    /** Unique identifier for this source */
+    id: string;
+    /** Human-readable name */
+    name: string;
+    /** Source type classification */
+    type: DataSourceType;
+    /** Base URL or connection string */
+    endpoint: string;
+    /** Authentication requirements */
+    auth?: DataSourceAuth;
+    /** Rate limiting from source */
+    rateLimit?: RateLimitConfig;
+    /** Whether to respect robots.txt (for web scraping) */
+    respectRobotsTxt?: boolean;
+    /** Schema or structure hint for parsing */
+    schema?: Record<string, unknown>;
+    /** Additional metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Resource limit configuration for agent execution.
+ * These limits are enforced by the AgentRegistry.
+ */
+export interface AgentResourceLimits {
+    /** Maximum requests per minute to external APIs */
+    rateLimitPerMinute: number;
+    /** Maximum tokens (LLM) per execution session */
+    tokenBudget: number;
+    /** Maximum execution time in milliseconds */
+    timeoutMs: number;
+    /** Maximum memory usage in MB */
+    maxMemoryMb: number;
+    /** Maximum concurrent operations */
+    maxConcurrency: number;
+    /** Maximum retry attempts for failed operations */
+    maxRetries: number;
+    /** Base backoff delay for retries in ms */
+    retryBackoffMs: number;
+    /** Maximum symbols this agent can create */
+    maxSymbolsCreated?: number;
+}
+/**
+ * Default resource limits for agents.
+ */
+export declare const DEFAULT_RESOURCE_LIMITS: AgentResourceLimits;
+/**
+ * Success criteria for agent completion validation.
+ */
+export interface AgentSuccessCriteria {
+    /** Required symbol patterns that must be created (supports wildcards) */
+    requiredSymbolPatterns?: string[];
+    /** Minimum number of symbols to create */
+    minSymbolsCreated?: number;
+    /** Maximum data age in hours (for freshness validation) */
+    maxDataAgeHours?: number;
+    /** Minimum confidence score for extracted data */
+    minConfidenceScore?: number;
+    /** Minimum field coverage percentage (0-1) */
+    minFieldCoverage?: number;
+    /** Custom validation function name */
+    customValidator?: string;
+}
+/**
+ * Agent dependency specification.
+ */
+export interface AgentDependency {
+    /** ID of dependent agent definition */
+    agentDefinitionId: string;
+    /** Required output symbol patterns from dependency */
+    requiredSymbolPatterns?: string[];
+    /** Whether dependency must complete successfully */
+    required: boolean;
+    /** Maximum wait time for dependency (ms) */
+    timeoutMs?: number;
+}
+/**
+ * Expected output symbol specification.
+ */
+export interface ExpectedOutputSymbol {
+    /** Symbol ID pattern (supports wildcards like Ξ.C.GOV.*) */
+    pattern: string;
+    /** Symbol category */
+    category: SymbolCategory;
+    /** Whether this output is required or optional */
+    required: boolean;
+    /** Description of what this symbol represents */
+    description: string;
+}
+/**
+ * Agent category for organization.
+ */
+export type AgentCategory = 'data_acquisition' | 'data_processing' | 'analysis' | 'monitoring' | 'integration';
+/**
+ * Risk level assessment for an agent.
+ */
+export type RiskLevel = 'low' | 'medium' | 'high' | 'critical';
+/**
+ * Complete Agent Definition Schema.
+ * Defines what an agent is, what it can do, and its constraints.
+ */
+export interface AgentDefinition {
+    /** Unique agent definition identifier (e.g., "agent.usaspending-fetcher") */
+    agentId: string;
+    /** Human-readable name */
+    name: string;
+    /** Version string (semver) */
+    version: string;
+    /** Detailed purpose description */
+    purpose: string;
+    /** Agent category for organization */
+    category: AgentCategory;
+    /** Target data sources this agent accesses */
+    dataSources: DataSourceSpec[];
+    /** Required capabilities */
+    requiredCapabilities: AgentCapability[];
+    /** Optional capabilities (nice to have) */
+    optionalCapabilities?: AgentCapability[];
+    /** Expected output symbol patterns */
+    expectedOutputSymbols: ExpectedOutputSymbol[];
+    /** Resource constraints */
+    resourceLimits: AgentResourceLimits;
+    /** How to determine if agent succeeded */
+    successCriteria: AgentSuccessCriteria;
+    /** Other agent definitions this depends on */
+    dependencies?: AgentDependency[];
+    /** PromptSpeak frame for agent governance */
+    governingFrame: string;
+    /** Risk level assessment */
+    riskLevel: RiskLevel;
+    /** Requires human approval before spawning */
+    requiresApproval: boolean;
+    /** Namespace isolation (agents can only see symbols in their namespace) */
+    namespace?: string;
+    /** Creation timestamp */
+    createdAt: string;
+    /** Last update timestamp */
+    updatedAt?: string;
+    /** Created by (user/system) */
+    createdBy: string;
+    /** Tags for filtering */
+    tags?: string[];
+    /** Template this was created from */
+    templateId?: string;
+}
+/**
+ * Agent instance status.
+ */
+export type AgentStatus = 'proposed' | 'pending_approval' | 'approved' | 'spawning' | 'running' | 'paused' | 'reporting' | 'completed' | 'failed' | 'abandoned' | 'archived';
+/**
+ * Agent execution scope - defines what an agent can access.
+ */
+export interface AgentScope {
+    /** Allowed symbol patterns (supports wildcards) */
+    allowedSymbolPatterns: string[];
+    /** Denied symbol patterns (takes precedence) */
+    deniedSymbolPatterns: string[];
+    /** Allowed MCP tools */
+    allowedTools: string[];
+    /** Denied MCP tools (takes precedence) */
+    deniedTools: string[];
+    /** Namespace isolation */
+    namespace: string;
+    /** Parent agent instance ID (for delegation chain) */
+    parentInstanceId?: string;
+    /** Maximum delegation depth */
+    maxDelegationDepth: number;
+}
+/**
+ * Resource usage tracking for an agent instance.
+ */
+export interface AgentResourceUsage {
+    /** Number of API calls made */
+    apiCallsMade: number;
+    /** Number of tokens used (LLM) */
+    tokensUsed: number;
+    /** Total execution time in ms */
+    executionTimeMs: number;
+    /** Symbols created by this agent */
+    symbolsCreated: string[];
+    /** Symbols updated by this agent */
+    symbolsUpdated: string[];
+    /** Symbols deleted by this agent */
+    symbolsDeleted: string[];
+}
+/**
+ * Performance metrics for an agent instance.
+ */
+export interface AgentMetrics {
+    /** Success rate (0-1) */
+    successRate: number;
+    /** Average latency per operation in ms */
+    avgLatencyMs: number;
+    /** Total error count */
+    errorCount: number;
+    /** Last error message */
+    lastError?: string;
+    /** Last error timestamp */
+    lastErrorAt?: string;
+}
+/**
+ * Agent instance represents a running or completed agent.
+ */
+export interface AgentInstance {
+    /** Unique instance identifier */
+    instanceId: string;
+    /** Reference to agent definition */
+    definitionId: string;
+    /** Campaign this instance belongs to */
+    campaignId?: string;
+    /** Current status */
+    status: AgentStatus;
+    /** Human-readable status message */
+    statusMessage?: string;
+    /** Execution scope */
+    scope: AgentScope;
+    /** Resource usage */
+    resourceUsage: AgentResourceUsage;
+    /** When instance was created */
+    createdAt: string;
+    /** When instance started executing */
+    startedAt?: string;
+    /** When instance completed */
+    completedAt?: string;
+    /** Who approved this instance */
+    approvedBy?: string;
+    /** When it was approved */
+    approvedAt?: string;
+    /** Hold ID if pending approval */
+    holdId?: string;
+    /** Proposal ID if created from proposal */
+    proposalId?: string;
+    /** Delegation ID from ps_delegate */
+    delegationId?: string;
+    /** Delegation chain (parent instance IDs) */
+    delegationChain: string[];
+    /** Performance metrics */
+    metrics: AgentMetrics;
+    /** PromptSpeak frame governing this instance */
+    governingFrame: string;
+    /** Whether agent is enabled */
+    enabled: boolean;
+    /** Reason if paused */
+    pausedReason?: string;
+    /** Final result summary */
+    resultSummary?: string;
+    /** Error details if failed */
+    errorDetails?: {
+        code: string;
+        message: string;
+        stack?: string;
+        retryable: boolean;
+    };
+}
+/**
+ * Campaign status.
+ */
+export type CampaignStatus = 'active' | 'paused' | 'completed' | 'failed' | 'aborted';
+/**
+ * Scope constraints for a campaign.
+ */
+export interface CampaignScopeConstraints {
+    /** Allowed data source types */
+    allowedSourceTypes?: DataSourceType[];
+    /** Date range for data */
+    dateRange?: {
+        start: string;
+        end: string;
+    };
+    /** Geographic constraints */
+    geographies?: string[];
+    /** Maximum concurrent agents */
+    maxConcurrentAgents?: number;
+    /** Maximum total agents */
+    maxTotalAgents?: number;
+    /** Token budget for entire campaign */
+    campaignTokenBudget?: number;
+}
+/**
+ * Acquisition campaign for a topic.
+ */
+export interface AcquisitionCampaign {
+    /** Unique campaign identifier */
+    campaignId: string;
+    /** Topic being researched */
+    topic: string;
+    /** Current status */
+    status: CampaignStatus;
+    /** Scope constraints */
+    scopeConstraints: CampaignScopeConstraints;
+    /** Priority level */
+    priority: 'low' | 'medium' | 'high';
+    /** Who created the campaign */
+    createdBy: string;
+    /** When campaign was created */
+    createdAt: string;
+    /** When campaign was last updated */
+    updatedAt?: string;
+    /** When campaign completed */
+    completedAt?: string;
+    /** Total agents spawned */
+    agentsSpawned: number;
+    /** Agents completed successfully */
+    agentsCompleted: number;
+    /** Agents failed */
+    agentsFailed: number;
+    /** Total symbols created */
+    symbolsCreated: number;
+    /** Circuit breaker state */
+    circuitBreakerState: 'closed' | 'open' | 'half-open';
+    /** Consecutive failures */
+    consecutiveFailures: number;
+    /** Last failure time */
+    lastFailureAt?: string;
+}
+/**
+ * Risk assessment for an agent proposal.
+ */
+export interface AgentRiskAssessment {
+    /** Overall risk score (0-1) */
+    overallRiskScore: number;
+    /** Risk by category */
+    categoryRisks: {
+        dataAccess: {
+            score: number;
+            factors: string[];
+        };
+        externalCalls: {
+            score: number;
+            factors: string[];
+        };
+        resourceUsage: {
+            score: number;
+            factors: string[];
+        };
+        symbolCreation: {
+            score: number;
+            factors: string[];
+        };
+        privilegeLevel: {
+            score: number;
+            factors: string[];
+        };
+    };
+    /** Specific concerns flagged */
+    concerns: string[];
+    /** Mitigations in place */
+    mitigations: string[];
+    /** Recommended approval level */
+    recommendedApprovalLevel: 'auto' | 'human' | 'elevated';
+}
+/**
+ * Resource usage estimate for an agent.
+ */
+export interface ResourceEstimate {
+    apiCalls: {
+        min: number;
+        max: number;
+        typical: number;
+    };
+    tokenUsage: {
+        min: number;
+        max: number;
+        typical: number;
+    };
+    executionTime: {
+        min: number;
+        max: number;
+        typical: number;
+    };
+    symbolsCreated: {
+        min: number;
+        max: number;
+        typical: number;
+    };
+}
+/**
+ * Justification for why an agent is needed.
+ */
+export interface ProposalJustification {
+    /** What triggered this proposal */
+    trigger: 'new_data_source' | 'user_request' | 'scheduled' | 'dependency' | 'system';
+    /** Detailed explanation */
+    explanation: string;
+    /** Expected business value */
+    businessValue: string;
+    /** Alternative approaches considered */
+    alternatives?: string[];
+}
+/**
+ * Agent proposal for human approval.
+ */
+export interface AgentProposal {
+    /** Unique proposal ID */
+    proposalId: string;
+    /** The agent definition being proposed */
+    agentDefinition: AgentDefinition;
+    /** Campaign this proposal belongs to */
+    campaignId?: string;
+    /** Justification for the proposal */
+    justification: ProposalJustification;
+    /** Risk assessment */
+    riskAssessment: AgentRiskAssessment;
+    /** Resource estimates */
+    resourceEstimate: ResourceEstimate;
+    /** Summary of data access */
+    dataAccessSummary: {
+        dataAccessed: string[];
+        dataModified: string[];
+        symbolsCreated: string[];
+        externalServices: string[];
+    };
+    /** Current state */
+    state: 'pending' | 'approved' | 'rejected' | 'expired';
+    /** When proposal was created */
+    createdAt: string;
+    /** When proposal expires */
+    expiresAt: string;
+    /** Hold ID for approval workflow */
+    holdId?: string;
+    /** Decision details if decided */
+    decision?: {
+        decidedBy: string;
+        decidedAt: string;
+        reason: string;
+        modifiedConfig?: Partial<AgentDefinition>;
+    };
+}
+/**
+ * Webhook notification channel type.
+ */
+export type WebhookChannelType = 'slack' | 'discord' | 'email' | 'custom';
+/**
+ * Webhook channel configuration.
+ */
+export interface WebhookChannel {
+    type: WebhookChannelType;
+    name: string;
+    enabled: boolean;
+    webhookUrl?: string;
+    email?: {
+        to: string[];
+        from: string;
+        smtpConfig?: Record<string, unknown>;
+    };
+}
+/**
+ * Webhook payload for agent approval requests.
+ */
+export interface AgentApprovalWebhookPayload {
+    type: 'agent_approval_request';
+    proposalId: string;
+    agent: {
+        name: string;
+        purpose: string;
+        riskLevel: RiskLevel;
+        riskScore: number;
+    };
+    dataSources: string[];
+    estimatedResources: {
+        apiCalls: string;
+        timeout: string;
+    };
+    expiresAt: string;
+    approveUrl: string;
+    rejectUrl: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/agents/types.d.ts.map

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

package/dist/agents/types.js

@@ -0,0 +1,20 @@
+/**
+ * Multi-Agent Data Intelligence Framework (MADIF) - Core Types
+ *
+ * This module defines the type system for the agent orchestration layer,
+ * including agent definitions, instances, proposals, and lifecycle management.
+ */
+/**
+ * Default resource limits for agents.
+ */
+export const DEFAULT_RESOURCE_LIMITS = {
+    rateLimitPerMinute: 60,
+    tokenBudget: 50000,
+    timeoutMs: 300000, // 5 minutes
+    maxMemoryMb: 512,
+    maxConcurrency: 5,
+    maxRetries: 3,
+    retryBackoffMs: 1000,
+    maxSymbolsCreated: 1000,
+};
+//# sourceMappingURL=types.js.map

package/dist/agents/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/agents/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAiIH;;GAEG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAwB;IAC1D,kBAAkB,EAAE,EAAE;IACtB,WAAW,EAAE,KAAK;IAClB,SAAS,EAAE,MAAM,EAAE,YAAY;IAC/B,WAAW,EAAE,GAAG;IAChB,cAAc,EAAE,CAAC;IACjB,UAAU,EAAE,CAAC;IACb,cAAc,EAAE,IAAI;IACpB,iBAAiB,EAAE,IAAI;CACxB,CAAC"}

package/dist/auth/api-key.d.ts

@@ -0,0 +1,37 @@
+/**
+ * API Key Management
+ *
+ * Handles API key generation, validation, and storage.
+ * Keys are stored hashed in SQLite with bcrypt.
+ */
+export interface ApiKeyInfo {
+    id: number;
+    keyPrefix: string;
+    userId: string;
+    name: string | null;
+    scopes: string[];
+    rateLimitTier: 'free' | 'pro' | 'enterprise';
+    createdAt: string;
+    lastUsedAt: string | null;
+    expiresAt: string | null;
+    revoked: boolean;
+}
+export interface CreateApiKeyRequest {
+    userId: string;
+    name?: string;
+    scopes?: string[];
+    rateLimitTier?: 'free' | 'pro' | 'enterprise';
+    expiresInDays?: number;
+}
+export interface CreateApiKeyResult {
+    key: string;
+    keyPrefix: string;
+    keyInfo: ApiKeyInfo;
+}
+export declare function initializeApiKeyTable(): void;
+export declare function createApiKey(request: CreateApiKeyRequest): Promise<CreateApiKeyResult>;
+export declare function validateApiKey(apiKey: string): Promise<ApiKeyInfo | null>;
+export declare function listApiKeys(userId: string): ApiKeyInfo[];
+export declare function revokeApiKey(keyId: number, userId: string): boolean;
+export declare function ensureDefaultApiKey(): Promise<string | null>;
+//# sourceMappingURL=api-key.d.ts.map

package/dist/auth/api-key.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-key.d.ts","sourceRoot":"","sources":["../../src/auth/api-key.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAaH,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,aAAa,EAAE,MAAM,GAAG,KAAK,GAAG,YAAY,CAAC;IAC7C,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,YAAY,CAAC;IAC9C,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,UAAU,CAAC;CACrB;AAQD,wBAAgB,qBAAqB,IAAI,IAAI,CA2B5C;AAaD,wBAAsB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAwD5F;AAMD,wBAAsB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CA0D/E;AAMD,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,EAAE,CAqCxD;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAYnE;AAMD,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAgClE"}