@anthropic-field/core 0.1.0

package/dist/src/cognitive/tool/cognitive-registry.d.ts

@@ -0,0 +1,99 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * Cognitive Module Registry
+ * Discovers and registers Cognitive Modules as Gemini CLI tools.
+ */
+import type { MessageBus } from '../../confirmation-bus/message-bus.js';
+import type { CognitiveModule } from '../types.js';
+import { CognitiveTool } from './cognitive-tool.js';
+import type { LLMCaller } from '../runtime/index.js';
+export interface CognitiveConfig {
+    /** Whether cognitive modules are enabled */
+    enabled: boolean;
+    /** Paths to search for modules */
+    modulePaths: string[];
+    /** Default model for cognitive modules */
+    defaultModel?: string;
+}
+/**
+ * Default configuration.
+ */
+export declare function getDefaultConfig(): CognitiveConfig;
+/**
+ * Registry for Cognitive Modules.
+ */
+export declare class CognitiveModuleRegistry {
+    private modules;
+    private tools;
+    private config;
+    private messageBus;
+    private llmCaller;
+    constructor(messageBus: MessageBus, config?: Partial<CognitiveConfig>);
+    /**
+     * Set the LLM caller for all tools.
+     */
+    setLLMCaller(caller: LLMCaller): void;
+    /**
+     * Check if cognitive modules are enabled.
+     */
+    isEnabled(): boolean;
+    /**
+     * Get module search paths.
+     */
+    getSearchPaths(): string[];
+    /**
+     * Discover and register all modules from search paths.
+     */
+    discoverAndRegister(): Promise<CognitiveTool[]>;
+    /**
+     * Register a single module.
+     */
+    registerModule(module: CognitiveModule): CognitiveTool;
+    /**
+     * Register a module from a path.
+     */
+    registerModuleFromPath(modulePath: string): CognitiveTool;
+    /**
+     * Get a module by name.
+     */
+    getModule(name: string): CognitiveModule | undefined;
+    /**
+     * Get a tool by name.
+     */
+    getTool(name: string): CognitiveTool | undefined;
+    /**
+     * Get all registered tools.
+     */
+    getAllTools(): CognitiveTool[];
+    /**
+     * Get all registered modules.
+     */
+    getAllModules(): CognitiveModule[];
+    /**
+     * List module names.
+     */
+    listModuleNames(): string[];
+    /**
+     * Check if a module is registered.
+     */
+    hasModule(name: string): boolean;
+    /**
+     * Clear all registered modules and tools.
+     */
+    clear(): void;
+}
+/**
+ * Get the global registry instance.
+ */
+export declare function getGlobalRegistry(): CognitiveModuleRegistry | null;
+/**
+ * Initialize the global registry.
+ */
+export declare function initGlobalRegistry(messageBus: MessageBus, config?: Partial<CognitiveConfig>): CognitiveModuleRegistry;
+/**
+ * Reset the global registry.
+ */
+export declare function resetGlobalRegistry(): void;

package/dist/src/cognitive/tool/cognitive-registry.js

@@ -0,0 +1,192 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * Cognitive Module Registry
+ * Discovers and registers Cognitive Modules as Gemini CLI tools.
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import * as os from 'node:os';
+import { discoverModules, loadModule } from '../loader/index.js';
+import { CognitiveTool, createCognitiveTool } from './cognitive-tool.js';
+/**
+ * Default configuration.
+ */
+export function getDefaultConfig() {
+    const homeDir = os.homedir();
+    return {
+        enabled: true,
+        modulePaths: [
+            path.join(homeDir, '.cognitive', 'modules'),
+            path.join(homeDir, '.gemini', 'cognitive', 'modules'),
+            './cognitive/modules',
+            './cognitive',
+        ],
+    };
+}
+// =============================================================================
+// Registry
+// =============================================================================
+/**
+ * Registry for Cognitive Modules.
+ */
+export class CognitiveModuleRegistry {
+    modules = new Map();
+    tools = new Map();
+    config;
+    messageBus;
+    llmCaller;
+    constructor(messageBus, config) {
+        this.messageBus = messageBus;
+        this.config = { ...getDefaultConfig(), ...config };
+    }
+    /**
+     * Set the LLM caller for all tools.
+     */
+    setLLMCaller(caller) {
+        this.llmCaller = caller;
+        // Update existing tools
+        for (const tool of this.tools.values()) {
+            tool.setLLMCaller(caller);
+        }
+    }
+    /**
+     * Check if cognitive modules are enabled.
+     */
+    isEnabled() {
+        return this.config.enabled;
+    }
+    /**
+     * Get module search paths.
+     */
+    getSearchPaths() {
+        return this.config.modulePaths;
+    }
+    /**
+     * Discover and register all modules from search paths.
+     */
+    async discoverAndRegister() {
+        if (!this.config.enabled) {
+            return [];
+        }
+        // Resolve paths
+        const resolvedPaths = this.config.modulePaths
+            .map((p) => {
+            if (p.startsWith('~')) {
+                return path.join(os.homedir(), p.slice(1));
+            }
+            return path.resolve(p);
+        })
+            .filter((p) => fs.existsSync(p));
+        // Discover modules
+        const modules = discoverModules(resolvedPaths);
+        // Register each module
+        const tools = [];
+        for (const module of modules) {
+            const tool = this.registerModule(module);
+            tools.push(tool);
+        }
+        return tools;
+    }
+    /**
+     * Register a single module.
+     */
+    registerModule(module) {
+        // Store module
+        this.modules.set(module.name, module);
+        // Create tool
+        const tool = createCognitiveTool(module, this.messageBus);
+        // Set LLM caller if available
+        if (this.llmCaller) {
+            tool.setLLMCaller(this.llmCaller);
+        }
+        // Store tool
+        this.tools.set(module.name, tool);
+        return tool;
+    }
+    /**
+     * Register a module from a path.
+     */
+    registerModuleFromPath(modulePath) {
+        const module = loadModule(modulePath);
+        return this.registerModule(module);
+    }
+    /**
+     * Get a module by name.
+     */
+    getModule(name) {
+        return this.modules.get(name);
+    }
+    /**
+     * Get a tool by name.
+     */
+    getTool(name) {
+        // Try direct name
+        if (this.tools.has(name)) {
+            return this.tools.get(name);
+        }
+        // Try with cognitive_ prefix
+        const prefixedName = name.startsWith('cognitive_') ? name : `cognitive_${name}`;
+        return this.tools.get(name) || Array.from(this.tools.values()).find(t => t.name === prefixedName);
+    }
+    /**
+     * Get all registered tools.
+     */
+    getAllTools() {
+        return Array.from(this.tools.values());
+    }
+    /**
+     * Get all registered modules.
+     */
+    getAllModules() {
+        return Array.from(this.modules.values());
+    }
+    /**
+     * List module names.
+     */
+    listModuleNames() {
+        return Array.from(this.modules.keys());
+    }
+    /**
+     * Check if a module is registered.
+     */
+    hasModule(name) {
+        return this.modules.has(name);
+    }
+    /**
+     * Clear all registered modules and tools.
+     */
+    clear() {
+        this.modules.clear();
+        this.tools.clear();
+    }
+}
+// =============================================================================
+// Singleton Instance
+// =============================================================================
+let globalRegistry = null;
+/**
+ * Get the global registry instance.
+ */
+export function getGlobalRegistry() {
+    return globalRegistry;
+}
+/**
+ * Initialize the global registry.
+ */
+export function initGlobalRegistry(messageBus, config) {
+    globalRegistry = new CognitiveModuleRegistry(messageBus, config);
+    return globalRegistry;
+}
+/**
+ * Reset the global registry.
+ */
+export function resetGlobalRegistry() {
+    if (globalRegistry) {
+        globalRegistry.clear();
+    }
+    globalRegistry = null;
+}
+//# sourceMappingURL=cognitive-registry.js.map

package/dist/src/cognitive/tool/cognitive-registry.js.map

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

package/dist/src/cognitive/tool/cognitive-tool.d.ts

@@ -0,0 +1,56 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * CognitiveTool - Wraps a Cognitive Module as a Gemini CLI Tool
+ *
+ * This makes Cognitive Modules first-class citizens in Gemini CLI,
+ * allowing them to be used like any built-in tool.
+ */
+import type { MessageBus } from '../../confirmation-bus/message-bus.js';
+import { DeclarativeTool, type ToolResult, type ToolInvocation } from '../../tools/tools.js';
+import type { CognitiveModule, EnvelopeResponse } from '../types.js';
+import { type LLMCaller } from '../runtime/index.js';
+export interface CognitiveToolParams {
+    [key: string]: unknown;
+}
+export interface CognitiveToolResult extends ToolResult {
+    data?: {
+        cognitive_envelope?: EnvelopeResponse;
+        cognitive_ok?: boolean;
+        cognitive_meta?: {
+            confidence: number;
+            risk: string;
+            explain: string;
+        };
+    };
+}
+/**
+ * CognitiveTool wraps a Cognitive Module as a Gemini CLI DeclarativeTool.
+ */
+export declare class CognitiveTool extends DeclarativeTool<CognitiveToolParams, CognitiveToolResult> {
+    private readonly module;
+    private llmCaller;
+    constructor(module: CognitiveModule, messageBus: MessageBus);
+    /**
+     * Set the LLM caller for this tool.
+     */
+    setLLMCaller(caller: LLMCaller): void;
+    /**
+     * Get the underlying cognitive module.
+     */
+    getModule(): CognitiveModule;
+    /**
+     * Build a tool invocation from validated parameters.
+     */
+    build(params: CognitiveToolParams): ToolInvocation<CognitiveToolParams, CognitiveToolResult>;
+}
+/**
+ * Create a CognitiveTool from a loaded module.
+ */
+export declare function createCognitiveTool(module: CognitiveModule, messageBus: MessageBus): CognitiveTool;
+/**
+ * Create CognitiveTools from an array of modules.
+ */
+export declare function createCognitiveTools(modules: CognitiveModule[], messageBus: MessageBus): CognitiveTool[];

package/dist/src/cognitive/tool/cognitive-tool.js

@@ -0,0 +1,217 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * CognitiveTool - Wraps a Cognitive Module as a Gemini CLI Tool
+ *
+ * This makes Cognitive Modules first-class citizens in Gemini CLI,
+ * allowing them to be used like any built-in tool.
+ */
+import { DeclarativeTool, BaseToolInvocation, Kind, ToolConfirmationOutcome, } from '../../tools/tools.js';
+import { executeModule, shouldEscalate, } from '../runtime/index.js';
+// =============================================================================
+// Tier to Kind Mapping
+// =============================================================================
+/**
+ * Map Cognitive tier to Gemini CLI tool Kind.
+ */
+function mapTierToKind(tier) {
+    switch (tier) {
+        case 'exec':
+            return Kind.Execute;
+        case 'decision':
+            return Kind.Think;
+        case 'exploration':
+            return Kind.Think;
+        default:
+            return Kind.Other;
+    }
+}
+// =============================================================================
+// CognitiveToolInvocation
+// =============================================================================
+class CognitiveToolInvocation extends BaseToolInvocation {
+    module;
+    llmCaller;
+    constructor(params, messageBus, module, llmCaller, toolName, toolDisplayName) {
+        super(params, messageBus, toolName, toolDisplayName);
+        this.module = module;
+        this.llmCaller = llmCaller;
+    }
+    getDescription() {
+        const inputPreview = JSON.stringify(this.params, null, 2).substring(0, 200);
+        return `Execute cognitive module **${this.module.name}**\n\nInput:\n\`\`\`json\n${inputPreview}${inputPreview.length >= 200 ? '...' : ''}\n\`\`\``;
+    }
+    async getConfirmationDetails(_abortSignal) {
+        // exec tier modules always require confirmation
+        if (this.module.tier === 'exec') {
+            const details = {
+                type: 'info',
+                title: `Execute: ${this.module.name}`,
+                prompt: `This is an **exec** tier module that may produce executable output.\n\n${this.getDescription()}`,
+                onConfirm: async (outcome) => {
+                    await this.publishPolicyUpdate(outcome);
+                },
+            };
+            return details;
+        }
+        // decision/exploration tiers don't require confirmation by default
+        return false;
+    }
+    async execute(signal, _updateOutput, _shellExecutionConfig) {
+        try {
+            // Execute the cognitive module
+            const envelope = await executeModule({
+                module: this.module,
+                input: this.params,
+                options: {
+                    validateInput: true,
+                    validateOutput: true,
+                    useEnvelope: true,
+                    useV22: true,
+                    enableRepair: true,
+                },
+                llmCaller: this.llmCaller,
+            });
+            // Format for LLM context
+            const llmContent = this.formatForLLM(envelope);
+            // Format for user display
+            const returnDisplay = this.formatForDisplay(envelope);
+            // Build result
+            const result = {
+                llmContent,
+                returnDisplay,
+                data: {
+                    cognitive_envelope: envelope,
+                    cognitive_ok: envelope.ok,
+                    cognitive_meta: {
+                        confidence: envelope.meta.confidence,
+                        risk: envelope.meta.risk,
+                        explain: envelope.meta.explain,
+                    },
+                },
+            };
+            // Add error if failed
+            if (!envelope.ok) {
+                result.error = {
+                    message: envelope.error.message,
+                    type: envelope.error.code,
+                };
+            }
+            return result;
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return {
+                llmContent: `Error executing cognitive module: ${message}`,
+                returnDisplay: `**Error:** ${message}`,
+                error: {
+                    message,
+                },
+            };
+        }
+    }
+    formatForLLM(envelope) {
+        // Include full envelope for LLM context
+        return JSON.stringify(envelope, null, 2);
+    }
+    formatForDisplay(envelope) {
+        const lines = [];
+        // Header
+        lines.push(`## Cognitive Module: ${this.module.name}`);
+        lines.push('');
+        // Status
+        if (envelope.ok) {
+            lines.push(`✅ **Success** (confidence: ${(envelope.meta.confidence * 100).toFixed(0)}%, risk: ${envelope.meta.risk})`);
+        }
+        else {
+            lines.push(`❌ **Failed** - ${envelope.error.code}: ${envelope.error.message}`);
+        }
+        // Explain (Control Plane)
+        lines.push('');
+        lines.push(`> ${envelope.meta.explain}`);
+        // Data summary (if success)
+        if (envelope.ok) {
+            lines.push('');
+            lines.push('### Output');
+            lines.push('```json');
+            // Show truncated data
+            const dataStr = JSON.stringify(envelope.data, null, 2);
+            if (dataStr.length > 1000) {
+                lines.push(dataStr.substring(0, 1000));
+                lines.push('... (truncated)');
+            }
+            else {
+                lines.push(dataStr);
+            }
+            lines.push('```');
+            // Escalation warning
+            if (shouldEscalate(envelope)) {
+                lines.push('');
+                lines.push('⚠️ **Review recommended** - Low confidence or high risk detected.');
+            }
+        }
+        return lines.join('\n');
+    }
+}
+// =============================================================================
+// CognitiveTool
+// =============================================================================
+/**
+ * CognitiveTool wraps a Cognitive Module as a Gemini CLI DeclarativeTool.
+ */
+export class CognitiveTool extends DeclarativeTool {
+    module;
+    llmCaller;
+    constructor(module, messageBus) {
+        super(`cognitive_${module.name}`, // name with prefix
+        module.name, // displayName
+        module.responsibility || `Cognitive module: ${module.name}`, // description
+        mapTierToKind(module.tier), // kind
+        module.inputSchema, // parameterSchema
+        messageBus, true, // isOutputMarkdown
+        false // canUpdateOutput
+        );
+        this.module = module;
+    }
+    /**
+     * Set the LLM caller for this tool.
+     */
+    setLLMCaller(caller) {
+        this.llmCaller = caller;
+    }
+    /**
+     * Get the underlying cognitive module.
+     */
+    getModule() {
+        return this.module;
+    }
+    /**
+     * Build a tool invocation from validated parameters.
+     */
+    build(params) {
+        // Validate params
+        const validationError = this.validateToolParams(params);
+        if (validationError) {
+            throw new Error(validationError);
+        }
+        return new CognitiveToolInvocation(params, this.messageBus, this.module, this.llmCaller, this.name, this.displayName);
+    }
+}
+// =============================================================================
+// Factory Functions
+// =============================================================================
+/**
+ * Create a CognitiveTool from a loaded module.
+ */
+export function createCognitiveTool(module, messageBus) {
+    return new CognitiveTool(module, messageBus);
+}
+/**
+ * Create CognitiveTools from an array of modules.
+ */
+export function createCognitiveTools(modules, messageBus) {
+    return modules.map((module) => createCognitiveTool(module, messageBus));
+}
+//# sourceMappingURL=cognitive-tool.js.map

package/dist/src/cognitive/tool/cognitive-tool.js.map

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

package/dist/src/cognitive/tool/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * Cognitive Tool - Public API
+ */
+export { CognitiveTool, createCognitiveTool, createCognitiveTools, type CognitiveToolParams, type CognitiveToolResult, } from './cognitive-tool.js';
+export { CognitiveModuleRegistry, getGlobalRegistry, initGlobalRegistry, resetGlobalRegistry, getDefaultConfig, type CognitiveConfig, } from './cognitive-registry.js';

package/dist/src/cognitive/tool/index.js

@@ -0,0 +1,10 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * Cognitive Tool - Public API
+ */
+export { CognitiveTool, createCognitiveTool, createCognitiveTools, } from './cognitive-tool.js';
+export { CognitiveModuleRegistry, getGlobalRegistry, initGlobalRegistry, resetGlobalRegistry, getDefaultConfig, } from './cognitive-registry.js';
+//# sourceMappingURL=index.js.map

package/dist/src/cognitive/tool/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/cognitive/tool/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,oBAAoB,GAGrB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,uBAAuB,EACvB,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,GAEjB,MAAM,yBAAyB,CAAC"}