@compilr-dev/sdk 0.2.1 → 0.2.3

package/dist/index.d.ts

@@ -59,5 +59,9 @@ export { STEP_ORDER, GUIDED_STEP_CRITERIA, getNextStep, isValidTransition, getSt
 export { platformSkills, designSkill, sketchSkill, prdSkill, refineSkill, refineItemSkill, architectureSkill, sessionNotesSkill, buildSkill, scaffoldSkill, } from './skills/index.js';
 export { defineTool, createSuccessResult, createErrorResult, mergeHooks, createLoggingHooks, createClaudeProvider, createOpenAIProvider, createGeminiNativeProvider, createOllamaProvider, createTogetherProvider, createGroqProvider, createFireworksProvider, createPerplexityProvider, createOpenRouterProvider, createMockProvider, MockProvider, Agent, ContextManager, DEFAULT_CONTEXT_CONFIG, createTaskTool, createSuggestTool, defaultAgentTypes, TOOL_SETS, BUILTIN_GUARDRAILS, TOOL_NAMES, getDefaultShellManager, builtinSkills, AnchorManager, MCPManager, AgentError, ProviderError, ToolError, ToolTimeoutError, MaxIterationsError, AbortError, } from '@compilr-dev/agents';
 export type { Tool, HooksConfig, AgentEvent, Message, LLMProvider, AnchorInput, ToolExecutionResult, AgentRunResult, PermissionHandler, ToolPermission, AgentTypeConfig, GuardrailTriggeredHandler, BeforeLLMHookResult, BeforeToolHook, BeforeToolHookResult, AfterToolHook, AgentState, AgentConfig, SessionInfo, Anchor, AnchorScope, AnchorClearOptions, AnchorPriority, AnchorQueryOptions, FileAccessType, FileAccess, GuardrailResult, GuardrailContext, MCPClient, MCPToolDefinition, } from '@compilr-dev/agents';
+export { DEFAULT_PERMISSION_RULES, findMatchingRule, permissionModeLabel, permissionLevelLabel, } from './permissions.js';
+export type { PermissionRule, PermissionMode, PermissionLevel } from './permissions.js';
+export { readMCPConfigFile, writeMCPConfigFile, resolveServerEntry, loadMCPServers, saveMCPServerEntry, deleteMCPServerEntry, getServerNames, } from './mcp-config.js';
+export type { MCPServerEntry, MCPConfigFile, ResolvedMCPServer } from './mcp-config.js';
 export { readFileTool, writeFileTool, createBashTool, bashTool, bashOutputTool, killShellTool, grepTool, globTool, editTool, todoWriteTool, todoReadTool, createTodoTools, TodoStore, webFetchTool, suggestTool, } from '@compilr-dev/agents';
 export { gitStatusTool, gitDiffTool, gitLogTool, gitCommitTool, gitBranchTool, gitStashTool, gitBlameTool, gitFileHistoryTool, detectProjectTool, findProjectRootTool, runTestsTool, runLintTool, runBuildTool, runFormatTool, findDefinitionTool, findReferencesTool, findTodosTool, checkOutdatedTool, findVulnerabilitiesTool, analyzeTestCoverageTool, getFileStructureTool, getComplexityTool, allCodingTools, unifiedTools, } from '@compilr-dev/agents-coding';

package/dist/index.js

@@ -153,6 +153,14 @@ MCPManager,
 // Error types
 AgentError, ProviderError, ToolError, ToolTimeoutError, MaxIterationsError, AbortError, } from '@compilr-dev/agents';
 // =============================================================================
+// Shared Permission Defaults & Utilities
+// =============================================================================
+export { DEFAULT_PERMISSION_RULES, findMatchingRule, permissionModeLabel, permissionLevelLabel, } from './permissions.js';
+// =============================================================================
+// Shared MCP Configuration
+// =============================================================================
+export { readMCPConfigFile, writeMCPConfigFile, resolveServerEntry, loadMCPServers, saveMCPServerEntry, deleteMCPServerEntry, getServerNames, } from './mcp-config.js';
+// =============================================================================
 // Individual Tool Re-exports (for consumers that build custom tool registries)
 // =============================================================================
 // Base tools from @compilr-dev/agents

package/dist/mcp-config.d.ts

@@ -0,0 +1,74 @@
+/**
+ * MCP Configuration — shared types and file I/O for mcp.json
+ *
+ * Used by both @compilr-dev/cli and compilr-dev-desktop.
+ * Config format is compatible with Claude Desktop / Gemini CLI.
+ *
+ * File structure:
+ *   { "mcpServers": { "name": { command?, url?, ... } } }
+ */
+/**
+ * Single MCP server entry in the config file.
+ * If `command` is present → stdio transport.
+ * If `url` is present → HTTP transport.
+ */
+export interface MCPServerEntry {
+    command?: string;
+    args?: string[];
+    env?: Record<string, string>;
+    cwd?: string;
+    url?: string;
+    headers?: Record<string, string>;
+    disabled?: boolean;
+    timeout?: number;
+}
+/**
+ * Shape of the mcp.json config file.
+ */
+export interface MCPConfigFile {
+    mcpServers: Record<string, MCPServerEntry>;
+}
+/**
+ * Resolved MCP server config ready for MCPManager.
+ */
+export interface ResolvedMCPServer {
+    name: string;
+    transport: 'stdio' | 'http';
+    command?: string;
+    args?: string[];
+    env?: Record<string, string>;
+    cwd?: string;
+    url?: string;
+    headers?: Record<string, string>;
+    timeout?: number;
+}
+/**
+ * Read and parse an mcp.json file. Returns empty record on any error.
+ */
+export declare function readMCPConfigFile(filePath: string): Record<string, MCPServerEntry>;
+/**
+ * Write servers to an mcp.json file (creates directory if needed).
+ */
+export declare function writeMCPConfigFile(filePath: string, servers: Record<string, MCPServerEntry>): void;
+/**
+ * Convert an MCPServerEntry to a ResolvedMCPServer.
+ * Returns null if the entry is invalid (neither command nor url) or disabled.
+ */
+export declare function resolveServerEntry(name: string, entry: MCPServerEntry): ResolvedMCPServer | null;
+/**
+ * Load and resolve MCP servers from one or more config file paths.
+ * Later paths override earlier ones (by server name).
+ */
+export declare function loadMCPServers(...configPaths: string[]): ResolvedMCPServer[];
+/**
+ * Save a single MCP server entry to a config file (add or overwrite by name).
+ */
+export declare function saveMCPServerEntry(filePath: string, name: string, entry: MCPServerEntry): void;
+/**
+ * Delete a single MCP server entry from a config file.
+ */
+export declare function deleteMCPServerEntry(filePath: string, name: string): void;
+/**
+ * Get all server names from one or more config files.
+ */
+export declare function getServerNames(...configPaths: string[]): Set<string>;

package/dist/mcp-config.js

@@ -0,0 +1,124 @@
+/**
+ * MCP Configuration — shared types and file I/O for mcp.json
+ *
+ * Used by both @compilr-dev/cli and compilr-dev-desktop.
+ * Config format is compatible with Claude Desktop / Gemini CLI.
+ *
+ * File structure:
+ *   { "mcpServers": { "name": { command?, url?, ... } } }
+ */
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'fs';
+import { dirname } from 'path';
+// =============================================================================
+// File I/O
+// =============================================================================
+/**
+ * Read and parse an mcp.json file. Returns empty record on any error.
+ */
+export function readMCPConfigFile(filePath) {
+    try {
+        if (!existsSync(filePath))
+            return {};
+        const data = readFileSync(filePath, 'utf-8');
+        const parsed = JSON.parse(data);
+        if (parsed.mcpServers && typeof parsed.mcpServers === 'object') {
+            return parsed.mcpServers;
+        }
+        return {};
+    }
+    catch {
+        return {};
+    }
+}
+/**
+ * Write servers to an mcp.json file (creates directory if needed).
+ */
+export function writeMCPConfigFile(filePath, servers) {
+    const dir = dirname(filePath);
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+    }
+    const config = { mcpServers: servers };
+    writeFileSync(filePath, JSON.stringify(config, null, 2) + '\n', 'utf-8');
+}
+// =============================================================================
+// Resolution
+// =============================================================================
+/**
+ * Convert an MCPServerEntry to a ResolvedMCPServer.
+ * Returns null if the entry is invalid (neither command nor url) or disabled.
+ */
+export function resolveServerEntry(name, entry) {
+    if (entry.disabled)
+        return null;
+    if (entry.command) {
+        return {
+            name,
+            transport: 'stdio',
+            command: entry.command,
+            args: entry.args,
+            env: entry.env,
+            cwd: entry.cwd,
+            timeout: entry.timeout,
+        };
+    }
+    if (entry.url) {
+        return {
+            name,
+            transport: 'http',
+            url: entry.url,
+            headers: entry.headers,
+            timeout: entry.timeout,
+        };
+    }
+    return null;
+}
+// =============================================================================
+// High-level helpers
+// =============================================================================
+/**
+ * Load and resolve MCP servers from one or more config file paths.
+ * Later paths override earlier ones (by server name).
+ */
+export function loadMCPServers(...configPaths) {
+    const merged = {};
+    for (const p of configPaths) {
+        const servers = readMCPConfigFile(p);
+        Object.assign(merged, servers);
+    }
+    const resolved = [];
+    for (const [name, entry] of Object.entries(merged)) {
+        const server = resolveServerEntry(name, entry);
+        if (server)
+            resolved.push(server);
+    }
+    return resolved;
+}
+/**
+ * Save a single MCP server entry to a config file (add or overwrite by name).
+ */
+export function saveMCPServerEntry(filePath, name, entry) {
+    const servers = readMCPConfigFile(filePath);
+    servers[name] = entry;
+    writeMCPConfigFile(filePath, servers);
+}
+/**
+ * Delete a single MCP server entry from a config file.
+ */
+export function deleteMCPServerEntry(filePath, name) {
+    const servers = readMCPConfigFile(filePath);
+    const { [name]: _, ...rest } = servers;
+    writeMCPConfigFile(filePath, rest);
+}
+/**
+ * Get all server names from one or more config files.
+ */
+export function getServerNames(...configPaths) {
+    const names = new Set();
+    for (const p of configPaths) {
+        for (const name of Object.keys(readMCPConfigFile(p))) {
+            names.add(name);
+        }
+    }
+    return names;
+}

package/dist/permissions.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Shared permission types and defaults for CLI and Desktop.
+ *
+ * Both consumers define the same default rules and modes. This module
+ * provides a single source of truth so they stay in sync.
+ */
+import type { ToolPermission } from '@compilr-dev/agents';
+/**
+ * Permission level for a tool.
+ * Re-exported from agents for convenience.
+ */
+export type PermissionLevel = 'always' | 'session' | 'once' | 'deny';
+/**
+ * Extended permission rule with UI metadata.
+ * Extends ToolPermission with an isDefault flag so UIs can distinguish
+ * built-in rules from user-customized ones (default rules cannot be deleted).
+ */
+export interface PermissionRule extends ToolPermission {
+    /** True for built-in rules (cannot be deleted, only level can be changed) */
+    isDefault?: boolean;
+}
+/**
+ * Global permission mode controlling how the permission system behaves.
+ * - 'normal': Use rule-based checking (check each tool's configured level)
+ * - 'plan': Always prompt before any tool execution (ignores rules)
+ * - 'auto-accept': Allow everything without prompting
+ */
+export type PermissionMode = 'normal' | 'plan' | 'auto-accept';
+/**
+ * Default permission rules shared between CLI and Desktop.
+ *
+ * The model is "allow by default, restrict dangerous tools":
+ * - Read-only tools (read_file, glob, grep) → always allowed
+ * - Write/execute tools (bash, write_file, edit) → ask once per invocation
+ * - Git mutating tools (git_commit, git_branch) → ask once
+ * - Runner tools (run_tests, run_lint) → ask once
+ */
+export declare const DEFAULT_PERMISSION_RULES: PermissionRule[];
+/**
+ * Find the matching permission rule for a tool name.
+ * Checks exact match first, then wildcard patterns (e.g., git_* matches git_commit).
+ */
+export declare function findMatchingRule(rules: PermissionRule[], toolName: string): PermissionRule | null;
+/**
+ * Display label for a permission mode.
+ */
+export declare function permissionModeLabel(mode: PermissionMode): string;
+/**
+ * Display label for a permission level.
+ */
+export declare function permissionLevelLabel(level: PermissionLevel): string;

package/dist/permissions.js

@@ -0,0 +1,85 @@
+/**
+ * Shared permission types and defaults for CLI and Desktop.
+ *
+ * Both consumers define the same default rules and modes. This module
+ * provides a single source of truth so they stay in sync.
+ */
+// =============================================================================
+// Default Rules
+// =============================================================================
+/**
+ * Default permission rules shared between CLI and Desktop.
+ *
+ * The model is "allow by default, restrict dangerous tools":
+ * - Read-only tools (read_file, glob, grep) → always allowed
+ * - Write/execute tools (bash, write_file, edit) → ask once per invocation
+ * - Git mutating tools (git_commit, git_branch) → ask once
+ * - Runner tools (run_tests, run_lint) → ask once
+ */
+export const DEFAULT_PERMISSION_RULES = [
+    { toolName: 'bash', level: 'once', description: 'Execute shell commands', isDefault: true },
+    { toolName: 'write_file', level: 'once', description: 'Write/create files', isDefault: true },
+    { toolName: 'edit', level: 'once', description: 'Edit file contents', isDefault: true },
+    { toolName: 'git_commit', level: 'once', description: 'Create git commits', isDefault: true },
+    { toolName: 'git_branch', level: 'once', description: 'Create/delete branches', isDefault: true },
+    { toolName: 'run_tests', level: 'once', description: 'Run test suite', isDefault: true },
+    {
+        toolName: 'run_lint',
+        level: 'once',
+        description: 'Run linter (may auto-fix)',
+        isDefault: true,
+    },
+    { toolName: 'read_file', level: 'always', description: 'Read files', isDefault: true },
+    { toolName: 'glob', level: 'always', description: 'Find files by pattern', isDefault: true },
+    { toolName: 'grep', level: 'always', description: 'Search file contents', isDefault: true },
+];
+// =============================================================================
+// Utilities
+// =============================================================================
+/**
+ * Find the matching permission rule for a tool name.
+ * Checks exact match first, then wildcard patterns (e.g., git_* matches git_commit).
+ */
+export function findMatchingRule(rules, toolName) {
+    // Exact match first
+    const exact = rules.find((r) => r.toolName === toolName);
+    if (exact)
+        return exact;
+    // Wildcard match (e.g., git_* → /^git_.*$/)
+    for (const rule of rules) {
+        if (rule.toolName.includes('*')) {
+            const pattern = new RegExp('^' + rule.toolName.replace(/\*/g, '.*') + '$');
+            if (pattern.test(toolName))
+                return rule;
+        }
+    }
+    return null;
+}
+/**
+ * Display label for a permission mode.
+ */
+export function permissionModeLabel(mode) {
+    switch (mode) {
+        case 'normal':
+            return 'Normal';
+        case 'plan':
+            return 'Plan (ask for everything)';
+        case 'auto-accept':
+            return 'Auto-accept (no prompts)';
+    }
+}
+/**
+ * Display label for a permission level.
+ */
+export function permissionLevelLabel(level) {
+    switch (level) {
+        case 'always':
+            return 'Always allow';
+        case 'session':
+            return 'Ask once per session';
+        case 'once':
+            return 'Ask every time';
+        case 'deny':
+            return 'Always deny';
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@compilr-dev/sdk",
-  "version": "0.2.1",
+  "version": "0.2.3",
   "description": "Universal agent runtime for building AI-powered applications",
   "type": "module",
   "main": "dist/index.js",