@anthropic-field/core 0.1.0

package/dist/src/cognitive/integration.d.ts

@@ -0,0 +1,57 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * Cognitive Integration with Gemini CLI
+ *
+ * This module provides the integration layer between Cognitive Modules
+ * and the Gemini CLI tool registry.
+ */
+import type { Config } from '../config/config.js';
+import type { MessageBus } from '../confirmation-bus/message-bus.js';
+import { ToolRegistry } from '../tools/tool-registry.js';
+import { type CognitiveConfig } from './tool/cognitive-registry.js';
+import { CognitiveTool } from './tool/cognitive-tool.js';
+import type { LLMCaller } from './runtime/executor.js';
+/**
+ * Extract cognitive config from Gemini CLI config.
+ */
+export declare function getCognitiveConfigFromSettings(_config: Config): Partial<CognitiveConfig> | null;
+/**
+ * Discover and register cognitive modules with the tool registry.
+ */
+export declare function discoverAndRegisterCognitiveTools(toolRegistry: ToolRegistry, messageBus: MessageBus, cognitiveConfig?: Partial<CognitiveConfig>, llmCaller?: LLMCaller): Promise<CognitiveTool[]>;
+/**
+ * Register a single cognitive module with the tool registry.
+ */
+export declare function registerCognitiveModule(toolRegistry: ToolRegistry, tool: CognitiveTool): void;
+/**
+ * Get all cognitive tools from the tool registry.
+ */
+export declare function getCognitiveTools(toolRegistry: ToolRegistry): CognitiveTool[];
+/**
+ * Check if a tool is a cognitive tool.
+ */
+export declare function isCognitiveTool(toolRegistry: ToolRegistry, toolName: string): boolean;
+/**
+ * Create an LLM caller that uses the Gemini CLI's internal API.
+ *
+ * This will be called from the core package to create a caller
+ * that integrates with the existing Gemini infrastructure.
+ */
+export interface GeminiClientAdapter {
+    generateContent(params: {
+        systemInstruction?: string;
+        contents: {
+            role: string;
+            parts: {
+                text: string;
+            }[];
+        }[];
+        model?: string;
+    }): Promise<{
+        text: string;
+    }>;
+}
+export declare function createLLMCallerFromGeminiClient(client: GeminiClientAdapter): LLMCaller;

package/dist/src/cognitive/integration.js

@@ -0,0 +1,103 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * Cognitive Integration with Gemini CLI
+ *
+ * This module provides the integration layer between Cognitive Modules
+ * and the Gemini CLI tool registry.
+ */
+import { ToolRegistry } from '../tools/tool-registry.js';
+import { CognitiveModuleRegistry, } from './tool/cognitive-registry.js';
+import { CognitiveTool } from './tool/cognitive-tool.js';
+import { debugLogger } from '../utils/debugLogger.js';
+// =============================================================================
+// Configuration Helper
+// =============================================================================
+/**
+ * Extract cognitive config from Gemini CLI config.
+ */
+export function getCognitiveConfigFromSettings(_config) {
+    try {
+        // TODO: Integrate with Gemini CLI config system
+        // For now, return null to use defaults
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+// =============================================================================
+// Integration Functions
+// =============================================================================
+/**
+ * Discover and register cognitive modules with the tool registry.
+ */
+export async function discoverAndRegisterCognitiveTools(toolRegistry, messageBus, cognitiveConfig, llmCaller) {
+    // Create cognitive registry
+    const cognitiveRegistry = new CognitiveModuleRegistry(messageBus, cognitiveConfig);
+    // Set LLM caller if provided
+    if (llmCaller) {
+        cognitiveRegistry.setLLMCaller(llmCaller);
+    }
+    // Check if enabled
+    if (!cognitiveRegistry.isEnabled()) {
+        debugLogger.log('Cognitive modules disabled');
+        return [];
+    }
+    // Discover modules
+    let tools;
+    try {
+        tools = await cognitiveRegistry.discoverAndRegister();
+    }
+    catch (error) {
+        debugLogger.error('Failed to discover cognitive modules:', error);
+        return [];
+    }
+    // Register each tool with the tool registry
+    for (const tool of tools) {
+        toolRegistry.registerTool(tool);
+        debugLogger.log(`Registered cognitive module: ${tool.displayName}`);
+    }
+    debugLogger.log(`Discovered ${tools.length} cognitive modules`);
+    return tools;
+}
+/**
+ * Register a single cognitive module with the tool registry.
+ */
+export function registerCognitiveModule(toolRegistry, tool) {
+    toolRegistry.registerTool(tool);
+}
+/**
+ * Get all cognitive tools from the tool registry.
+ */
+export function getCognitiveTools(toolRegistry) {
+    const allTools = toolRegistry.getAllTools();
+    return allTools.filter((tool) => tool instanceof CognitiveTool);
+}
+/**
+ * Check if a tool is a cognitive tool.
+ */
+export function isCognitiveTool(toolRegistry, toolName) {
+    const tool = toolRegistry.getTool(toolName);
+    return tool instanceof CognitiveTool;
+}
+export function createLLMCallerFromGeminiClient(client) {
+    return {
+        async call({ systemPrompt, userPrompt, model }) {
+            const result = await client.generateContent({
+                systemInstruction: systemPrompt,
+                contents: [
+                    {
+                        role: 'user',
+                        parts: [{ text: userPrompt }],
+                    },
+                ],
+                model,
+            });
+            return result.text;
+        },
+    };
+}
+//# sourceMappingURL=integration.js.map

package/dist/src/cognitive/integration.js.map

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

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

@@ -0,0 +1,8 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * Cognitive Module Loader - Public API
+ */
+export { loadModule, findModule, discoverModules, detectFormat, detectV2Version, isValidModulePath, getModuleTier, isOverflowEnabled, shouldAutoWrap, type ModuleFormat, } from './module-loader.js';

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

@@ -0,0 +1,9 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * Cognitive Module Loader - Public API
+ */
+export { loadModule, findModule, discoverModules, detectFormat, detectV2Version, isValidModulePath, getModuleTier, isOverflowEnabled, shouldAutoWrap, } from './module-loader.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/cognitive/loader/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,UAAU,EACV,UAAU,EACV,eAAe,EACf,YAAY,EACZ,eAAe,EACf,iBAAiB,EACjB,aAAa,EACb,iBAAiB,EACjB,cAAc,GAEf,MAAM,oBAAoB,CAAC"}

package/dist/src/cognitive/loader/module-loader.d.ts

@@ -0,0 +1,67 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * Cognitive Module Loader
+ * Loads cognitive modules in v2.2, v2.1, v2.0, v1, and v0 formats.
+ */
+import type { CognitiveModule, ModuleManifest, ModuleTier } from '../types.js';
+export type ModuleFormat = 'v2' | 'v1' | 'v0';
+/**
+ * Detect module format from directory structure.
+ */
+export declare function detectFormat(modulePath: string): ModuleFormat;
+/**
+ * Detect v2.x version from manifest content.
+ */
+export declare function detectV2Version(manifest: ModuleManifest): string;
+interface FrontmatterResult {
+    metadata: Record<string, unknown>;
+    body: string;
+}
+/**
+ * Parse YAML frontmatter from markdown content.
+ */
+export declare function parseFrontmatter(content: string): FrontmatterResult;
+/**
+ * Load module in v2.x format (module.yaml + prompt.md + schema.json).
+ */
+export declare function loadV2Format(modulePath: string): CognitiveModule;
+/**
+ * Load module in v1 format (MODULE.md + schema.json).
+ */
+export declare function loadV1Format(modulePath: string): CognitiveModule;
+/**
+ * Load module in v0 format (old 6-file format).
+ */
+export declare function loadV0Format(modulePath: string): CognitiveModule;
+/**
+ * Load a cognitive module, auto-detecting format.
+ */
+export declare function loadModule(modulePath: string): CognitiveModule;
+/**
+ * Find and load a module by name from search paths.
+ */
+export declare function findModule(name: string, searchPaths: string[]): CognitiveModule | null;
+/**
+ * List all modules in search paths.
+ */
+export declare function discoverModules(searchPaths: string[]): CognitiveModule[];
+/**
+ * Check if a path contains a valid cognitive module.
+ */
+export declare function isValidModulePath(modulePath: string): boolean;
+/**
+ * Get module tier with fallback.
+ */
+export declare function getModuleTier(module: CognitiveModule): ModuleTier;
+/**
+ * Check if overflow (extensions.insights) is enabled.
+ */
+export declare function isOverflowEnabled(module: CognitiveModule): boolean;
+/**
+ * Check if runtime should auto-wrap v2.1 to v2.2.
+ */
+export declare function shouldAutoWrap(module: CognitiveModule): boolean;
+export {};

package/dist/src/cognitive/loader/module-loader.js

@@ -0,0 +1,369 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * Cognitive Module Loader
+ * Loads cognitive modules in v2.2, v2.1, v2.0, v1, and v0 formats.
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import yaml from 'js-yaml';
+/**
+ * Detect module format from directory structure.
+ */
+export function detectFormat(modulePath) {
+    if (fs.existsSync(path.join(modulePath, 'module.yaml'))) {
+        return 'v2';
+    }
+    if (fs.existsSync(path.join(modulePath, 'MODULE.md'))) {
+        return 'v1';
+    }
+    if (fs.existsSync(path.join(modulePath, 'module.md'))) {
+        return 'v0';
+    }
+    throw new Error(`No module.yaml, MODULE.md, or module.md found in ${modulePath}`);
+}
+/**
+ * Detect v2.x version from manifest content.
+ */
+export function detectV2Version(manifest) {
+    // v2.2 indicators
+    if (manifest.tier || manifest.overflow || manifest.enums) {
+        return 'v2.2';
+    }
+    // v2.1 indicators
+    if (manifest.policies || manifest.failure) {
+        return 'v2.1';
+    }
+    // Default v2.0
+    return 'v2.0';
+}
+/**
+ * Parse YAML frontmatter from markdown content.
+ */
+export function parseFrontmatter(content) {
+    if (!content.startsWith('---')) {
+        return { metadata: {}, body: content };
+    }
+    const parts = content.split('---');
+    if (parts.length < 3) {
+        return { metadata: {}, body: content };
+    }
+    const metadata = yaml.load(parts[1]) || {};
+    const body = parts.slice(2).join('---').trim();
+    return { metadata, body };
+}
+// =============================================================================
+// Default Values
+// =============================================================================
+const STRICTNESS_MAX_ITEMS = {
+    high: 0,
+    medium: 5,
+    low: 20,
+};
+function getDefaultOverflow(strictness) {
+    return {
+        enabled: strictness !== 'high',
+        recoverable: true,
+        max_items: STRICTNESS_MAX_ITEMS[strictness],
+        require_suggested_mapping: true,
+    };
+}
+function getDefaultEnums(tier) {
+    return {
+        strategy: tier === 'exec' ? 'strict' : 'extensible',
+        unknown_tag: 'custom',
+    };
+}
+function getDefaultCompat() {
+    return {
+        accepts_v21_payload: true,
+        runtime_auto_wrap: true,
+        schema_output_alias: 'data',
+    };
+}
+// =============================================================================
+// v2 Loader
+// =============================================================================
+/**
+ * Load module in v2.x format (module.yaml + prompt.md + schema.json).
+ */
+export function loadV2Format(modulePath) {
+    // Load module.yaml
+    const manifestPath = path.join(modulePath, 'module.yaml');
+    const manifestContent = fs.readFileSync(manifestPath, 'utf-8');
+    const manifest = yaml.load(manifestContent);
+    // Detect version
+    const formatVersion = detectV2Version(manifest);
+    // Load prompt.md
+    const promptPath = path.join(modulePath, 'prompt.md');
+    let prompt = '';
+    if (fs.existsSync(promptPath)) {
+        prompt = fs.readFileSync(promptPath, 'utf-8');
+    }
+    // Load schema.json
+    const schemaPath = path.join(modulePath, 'schema.json');
+    let schema = {};
+    if (fs.existsSync(schemaPath)) {
+        const schemaContent = fs.readFileSync(schemaPath, 'utf-8');
+        schema = JSON.parse(schemaContent);
+    }
+    // Extract schemas with v2.1/v2.2 compatibility
+    const inputSchema = schema.input || {};
+    const compat = manifest.compat || getDefaultCompat();
+    // Support both "data" (v2.2) and "output" (v2.1) aliases
+    let dataSchema;
+    if (compat.schema_output_alias === 'data' || schema.data) {
+        dataSchema = schema.data || schema.output || {};
+    }
+    else {
+        dataSchema = schema.output || {};
+    }
+    const metaSchema = schema.meta || {};
+    const errorSchema = schema.error || {};
+    const schemaDefs = schema.$defs || {};
+    // Extract tier and strictness
+    const tier = manifest.tier || null;
+    const schemaStrictness = manifest.schema_strictness || 'medium';
+    // Build overflow policy with defaults
+    const overflowRaw = manifest.overflow || {};
+    const defaultOverflow = getDefaultOverflow(schemaStrictness);
+    const overflow = {
+        enabled: overflowRaw.enabled ?? defaultOverflow.enabled,
+        recoverable: overflowRaw.recoverable ?? defaultOverflow.recoverable,
+        max_items: overflowRaw.max_items ?? defaultOverflow.max_items,
+        require_suggested_mapping: overflowRaw.require_suggested_mapping ??
+            defaultOverflow.require_suggested_mapping,
+    };
+    // Build enum policy
+    const enumsRaw = manifest.enums || {};
+    const defaultEnums = getDefaultEnums(tier);
+    const enums = {
+        strategy: enumsRaw.strategy || defaultEnums.strategy,
+        unknown_tag: enumsRaw.unknown_tag || defaultEnums.unknown_tag,
+    };
+    return {
+        // Identity
+        name: manifest.name || path.basename(modulePath),
+        version: manifest.version || '1.0.0',
+        responsibility: manifest.responsibility || '',
+        excludes: manifest.excludes || [],
+        // Path info
+        path: modulePath,
+        format: 'v2',
+        formatVersion,
+        // Raw manifest
+        manifest,
+        // Prompt
+        prompt,
+        // Schemas
+        inputSchema,
+        dataSchema,
+        metaSchema,
+        errorSchema,
+        schemaDefs,
+        // v2.2 policies
+        tier,
+        schemaStrictness,
+        overflow,
+        enums,
+        // Other policies
+        policies: manifest.policies || {},
+        toolsPolicy: manifest.tools || {},
+        failureContract: manifest.failure || {},
+        runtimeRequirements: manifest.runtime_requirements || {},
+        compat: compat,
+    };
+}
+// =============================================================================
+// v1 Loader (Legacy)
+// =============================================================================
+/**
+ * Load module in v1 format (MODULE.md + schema.json).
+ */
+export function loadV1Format(modulePath) {
+    // Load MODULE.md
+    const moduleMdPath = path.join(modulePath, 'MODULE.md');
+    const content = fs.readFileSync(moduleMdPath, 'utf-8');
+    const { metadata, body: prompt } = parseFrontmatter(content);
+    // Load schema.json
+    const schemaPath = path.join(modulePath, 'schema.json');
+    let inputSchema = {};
+    let outputSchema = {};
+    if (fs.existsSync(schemaPath)) {
+        const schemaContent = fs.readFileSync(schemaPath, 'utf-8');
+        const schema = JSON.parse(schemaContent);
+        inputSchema = schema.input || {};
+        outputSchema = schema.output || {};
+    }
+    return {
+        name: metadata['name'] || path.basename(modulePath),
+        version: metadata['version'] || '1.0.0',
+        responsibility: metadata['responsibility'] || '',
+        excludes: metadata['excludes'] || [],
+        path: modulePath,
+        format: 'v1',
+        formatVersion: 'v1.0',
+        manifest: metadata,
+        prompt,
+        inputSchema,
+        dataSchema: outputSchema,
+        metaSchema: {},
+        errorSchema: {},
+        schemaDefs: {},
+        // v2.2 defaults for v1 modules
+        tier: null,
+        schemaStrictness: 'medium',
+        overflow: { enabled: false, recoverable: true, max_items: 0, require_suggested_mapping: false },
+        enums: { strategy: 'strict' },
+        policies: {},
+        toolsPolicy: {},
+        failureContract: {},
+        runtimeRequirements: {},
+        compat: getDefaultCompat(),
+    };
+}
+// =============================================================================
+// v0 Loader (Deprecated)
+// =============================================================================
+/**
+ * Load module in v0 format (old 6-file format).
+ */
+export function loadV0Format(modulePath) {
+    // Load module.md
+    const moduleMdPath = path.join(modulePath, 'module.md');
+    const content = fs.readFileSync(moduleMdPath, 'utf-8');
+    const { metadata } = parseFrontmatter(content);
+    // Load schemas
+    const inputSchemaPath = path.join(modulePath, 'input.schema.json');
+    const outputSchemaPath = path.join(modulePath, 'output.schema.json');
+    const promptPath = path.join(modulePath, 'prompt.txt');
+    const inputSchema = JSON.parse(fs.readFileSync(inputSchemaPath, 'utf-8'));
+    const outputSchema = JSON.parse(fs.readFileSync(outputSchemaPath, 'utf-8'));
+    const prompt = fs.readFileSync(promptPath, 'utf-8');
+    return {
+        name: metadata['name'] || path.basename(modulePath),
+        version: metadata['version'] || '1.0.0',
+        responsibility: metadata['responsibility'] || '',
+        excludes: [],
+        path: modulePath,
+        format: 'v0',
+        formatVersion: 'v0.0',
+        manifest: metadata,
+        prompt,
+        inputSchema,
+        dataSchema: outputSchema,
+        metaSchema: {},
+        errorSchema: {},
+        schemaDefs: {},
+        tier: null,
+        schemaStrictness: 'medium',
+        overflow: { enabled: false, recoverable: true, max_items: 0, require_suggested_mapping: false },
+        enums: { strategy: 'strict' },
+        policies: {},
+        toolsPolicy: {},
+        failureContract: {},
+        runtimeRequirements: {},
+        compat: getDefaultCompat(),
+    };
+}
+// =============================================================================
+// Main Loader
+// =============================================================================
+/**
+ * Load a cognitive module, auto-detecting format.
+ */
+export function loadModule(modulePath) {
+    const format = detectFormat(modulePath);
+    switch (format) {
+        case 'v2':
+            return loadV2Format(modulePath);
+        case 'v1':
+            return loadV1Format(modulePath);
+        case 'v0':
+            return loadV0Format(modulePath);
+        default:
+            throw new Error(`Unknown module format: ${format}`);
+    }
+}
+// =============================================================================
+// Module Discovery
+// =============================================================================
+/**
+ * Find and load a module by name from search paths.
+ */
+export function findModule(name, searchPaths) {
+    for (const basePath of searchPaths) {
+        const modulePath = path.join(basePath, name);
+        if (fs.existsSync(modulePath)) {
+            try {
+                return loadModule(modulePath);
+            }
+            catch {
+                continue;
+            }
+        }
+    }
+    return null;
+}
+/**
+ * List all modules in search paths.
+ */
+export function discoverModules(searchPaths) {
+    const modules = [];
+    for (const basePath of searchPaths) {
+        if (!fs.existsSync(basePath)) {
+            continue;
+        }
+        const entries = fs.readdirSync(basePath, { withFileTypes: true });
+        for (const entry of entries) {
+            if (entry.isDirectory()) {
+                const modulePath = path.join(basePath, entry.name);
+                try {
+                    const module = loadModule(modulePath);
+                    modules.push(module);
+                }
+                catch {
+                    // Not a valid module, skip
+                    continue;
+                }
+            }
+        }
+    }
+    return modules;
+}
+// =============================================================================
+// Utility Functions
+// =============================================================================
+/**
+ * Check if a path contains a valid cognitive module.
+ */
+export function isValidModulePath(modulePath) {
+    try {
+        detectFormat(modulePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Get module tier with fallback.
+ */
+export function getModuleTier(module) {
+    return module.tier || 'decision';
+}
+/**
+ * Check if overflow (extensions.insights) is enabled.
+ */
+export function isOverflowEnabled(module) {
+    return module.overflow.enabled;
+}
+/**
+ * Check if runtime should auto-wrap v2.1 to v2.2.
+ */
+export function shouldAutoWrap(module) {
+    return module.compat.runtime_auto_wrap ?? true;
+}
+//# sourceMappingURL=module-loader.js.map

package/dist/src/cognitive/loader/module-loader.js.map

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

package/dist/src/cognitive/runtime/envelope.d.ts

@@ -0,0 +1,31 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * Cognitive Envelope Conversion
+ * Handles conversion between v2.1 and v2.2 envelope formats.
+ */
+import type { EnvelopeResponse, EnvelopeSuccess, EnvelopeFailure, EnvelopeMeta } from '../types.js';
+/**
+ * Convert v2.1 envelope to v2.2 envelope.
+ * Adds meta field by extracting/computing from data.
+ */
+export declare function wrapV21ToV22(v21Response: Record<string, unknown>): EnvelopeResponse;
+/**
+ * Convert legacy format (no envelope) to v2.2 envelope.
+ */
+export declare function convertLegacyToEnvelope(data: Record<string, unknown>, isError?: boolean): EnvelopeResponse;
+/**
+ * Create a success envelope.
+ */
+export declare function createSuccessEnvelope(data: Record<string, unknown>, meta?: Partial<EnvelopeMeta>): EnvelopeSuccess;
+/**
+ * Create a failure envelope.
+ */
+export declare function createFailureEnvelope(code: string, message: string, meta?: Partial<EnvelopeMeta>, partialData?: Record<string, unknown> | null): EnvelopeFailure;
+export declare function createParseError(_rawResponse: string): EnvelopeFailure;
+export declare function createInvalidInputError(errors: string[]): EnvelopeFailure;
+export declare function createModuleNotFoundError(name: string): EnvelopeFailure;
+export declare function createSchemaValidationError(errors: string[], partialData?: Record<string, unknown> | null): EnvelopeFailure;
+export declare function createInternalError(message: string): EnvelopeFailure;