@anthropic-field/core 0.1.0

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

@@ -0,0 +1,234 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * Cognitive Modules - Type Definitions
+ * Implements Cognitive v2.2 Specification
+ */
+/**
+ * Module tier determines schema strictness and overflow policy.
+ * - exec: Auto-execution (patches, commands) - high strictness, no overflow
+ * - decision: Judgment/evaluation - medium strictness, 5 overflow items
+ * - exploration: Research/brainstorming - low strictness, 20 overflow items
+ */
+export type ModuleTier = 'exec' | 'decision' | 'exploration';
+/**
+ * Schema validation strictness level.
+ */
+export type SchemaStrictness = 'high' | 'medium' | 'low';
+/**
+ * Enum extension strategy.
+ * - strict: Only predefined enum values allowed
+ * - extensible: Allow { custom, reason } objects for new values
+ */
+export type EnumStrategy = 'strict' | 'extensible';
+/**
+ * Risk level for Control Plane routing.
+ */
+export type RiskLevel = 'none' | 'low' | 'medium' | 'high';
+/**
+ * Risk aggregation rule.
+ */
+export type RiskRule = 'max_changes_risk' | 'max_issues_risk' | 'explicit';
+export interface OverflowPolicy {
+    enabled: boolean;
+    recoverable: boolean;
+    max_items: number;
+    require_suggested_mapping: boolean;
+}
+export interface EnumPolicy {
+    strategy: EnumStrategy;
+    unknown_tag?: string;
+}
+export interface Policies {
+    network?: 'allow' | 'deny';
+    filesystem_write?: 'allow' | 'deny';
+    side_effects?: 'allow' | 'deny';
+    code_execution?: 'allow' | 'deny';
+}
+export interface ToolsPolicy {
+    policy?: 'deny_by_default' | 'allow_by_default';
+    allowed?: string[];
+    denied?: string[];
+}
+export interface FailureContract {
+    contract?: 'error_union' | 'throw';
+    partial_allowed?: boolean;
+    must_return_error_schema?: boolean;
+}
+export interface RuntimeRequirements {
+    structured_output?: boolean;
+    max_input_tokens?: number;
+    preferred_capabilities?: string[];
+}
+export interface CompatConfig {
+    accepts_v21_payload?: boolean;
+    runtime_auto_wrap?: boolean;
+    schema_output_alias?: 'data' | 'output';
+}
+export interface IOConfig {
+    input?: string;
+    data?: string;
+    meta?: string;
+    error?: string;
+}
+export interface ModuleManifest {
+    name: string;
+    version: string;
+    responsibility: string;
+    excludes?: string[];
+    tier?: ModuleTier;
+    schema_strictness?: SchemaStrictness;
+    policies?: Policies;
+    tools?: ToolsPolicy;
+    overflow?: Partial<OverflowPolicy>;
+    enums?: Partial<EnumPolicy>;
+    failure?: FailureContract;
+    runtime_requirements?: RuntimeRequirements;
+    io?: IOConfig;
+    compat?: CompatConfig;
+    tests?: string[];
+    meta?: {
+        risk_rule?: RiskRule;
+    };
+}
+export interface SchemaContract {
+    $schema?: string;
+    input?: Record<string, unknown>;
+    data?: Record<string, unknown>;
+    output?: Record<string, unknown>;
+    meta?: Record<string, unknown>;
+    error?: Record<string, unknown>;
+    $defs?: Record<string, unknown>;
+}
+export interface CognitiveModule {
+    name: string;
+    version: string;
+    responsibility: string;
+    excludes: string[];
+    path: string;
+    format: 'v2' | 'v1' | 'v0';
+    formatVersion: string;
+    manifest: ModuleManifest;
+    prompt: string;
+    inputSchema: Record<string, unknown>;
+    dataSchema: Record<string, unknown>;
+    metaSchema: Record<string, unknown>;
+    errorSchema: Record<string, unknown>;
+    schemaDefs: Record<string, unknown>;
+    tier: ModuleTier | null;
+    schemaStrictness: SchemaStrictness;
+    overflow: OverflowPolicy;
+    enums: EnumPolicy;
+    policies: Policies;
+    toolsPolicy: ToolsPolicy;
+    failureContract: FailureContract;
+    runtimeRequirements: RuntimeRequirements;
+    compat: CompatConfig;
+}
+/**
+ * Control Plane metadata - unified across all modules.
+ * Used for routing, escalation, and logging without parsing business payload.
+ */
+export interface EnvelopeMeta {
+    /** Confidence score [0, 1] - module's self-assessed contract compliance */
+    confidence: number;
+    /** Aggregated risk level */
+    risk: RiskLevel;
+    /** Short explanation for control plane (≤280 chars) */
+    explain: string;
+    /** Distributed tracing ID */
+    trace_id?: string;
+    /** Provider and model identifier */
+    model?: string;
+    /** Execution latency in milliseconds */
+    latency_ms?: number;
+}
+/**
+ * Overflow insight for schema evolution.
+ */
+export interface Insight {
+    text: string;
+    suggested_mapping: string;
+    evidence?: string;
+}
+/**
+ * Extensions container for recoverable overflow.
+ */
+export interface Extensions {
+    insights?: Insight[];
+}
+/**
+ * Error structure for failure responses.
+ */
+export interface EnvelopeError {
+    code: string;
+    message: string;
+}
+/**
+ * Standard error codes.
+ */
+export type ErrorCode = 'PARSE_ERROR' | 'SCHEMA_VALIDATION_FAILED' | 'INVALID_INPUT' | 'MODULE_NOT_FOUND' | 'UNSUPPORTED_LANGUAGE' | 'NO_SIMPLIFICATION_POSSIBLE' | 'BEHAVIOR_CHANGE_REQUIRED' | 'INTERNAL_ERROR';
+/**
+ * Success response envelope (v2.2).
+ */
+export interface EnvelopeSuccess {
+    ok: true;
+    meta: EnvelopeMeta;
+    data: Record<string, unknown> & {
+        rationale?: string;
+        extensions?: Extensions;
+    };
+}
+/**
+ * Failure response envelope (v2.2).
+ */
+export interface EnvelopeFailure {
+    ok: false;
+    meta: EnvelopeMeta;
+    error: EnvelopeError;
+    partial_data?: Record<string, unknown> | null;
+}
+/**
+ * Unified envelope response type.
+ */
+export type EnvelopeResponse = EnvelopeSuccess | EnvelopeFailure;
+export interface EnvelopeSuccessV21 {
+    ok: true;
+    data: Record<string, unknown>;
+}
+export interface EnvelopeFailureV21 {
+    ok: false;
+    error: EnvelopeError;
+    partial_data?: Record<string, unknown> | null;
+}
+export type EnvelopeResponseV21 = EnvelopeSuccessV21 | EnvelopeFailureV21;
+export interface ValidationResult {
+    valid: boolean;
+    errors: string[];
+}
+export interface RunModuleOptions {
+    /** Validate input against schema */
+    validateInput?: boolean;
+    /** Validate output against schema */
+    validateOutput?: boolean;
+    /** Model override */
+    model?: string;
+    /** Force envelope format */
+    useEnvelope?: boolean;
+    /** Force v2.2 envelope format */
+    useV22?: boolean;
+    /** Enable repair pass for validation failures */
+    enableRepair?: boolean;
+    /** Trace ID for distributed tracing */
+    traceId?: string;
+}
+export interface ModuleSearchPaths {
+    /** User's home cognitive modules */
+    user?: string;
+    /** Project-local modules */
+    project?: string;
+    /** Additional search paths */
+    additional?: string[];
+}

package/dist/src/cognitive/types.js

@@ -0,0 +1,10 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * Cognitive Modules - Type Definitions
+ * Implements Cognitive v2.2 Specification
+ */
+export {};
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/cognitive/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/src/cognitive/validator/envelope-validator.d.ts

@@ -0,0 +1,45 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * Cognitive Envelope Validator
+ * Validates and detects envelope format versions.
+ */
+import type { EnvelopeResponse, EnvelopeSuccess, EnvelopeFailure, EnvelopeMeta } from '../types.js';
+/**
+ * Check if response has envelope structure (v2.1 or v2.2).
+ */
+export declare function isEnvelopeResponse(data: unknown): data is {
+    ok: boolean;
+};
+/**
+ * Check if response is v2.2 envelope (has meta).
+ */
+export declare function isV22Envelope(data: unknown): data is EnvelopeResponse;
+/**
+ * Check if response is success envelope.
+ */
+export declare function isSuccessEnvelope(data: unknown): data is EnvelopeSuccess;
+/**
+ * Check if response is failure envelope.
+ */
+export declare function isFailureEnvelope(data: unknown): data is EnvelopeFailure;
+export interface EnvelopeStructureResult {
+    valid: boolean;
+    errors: string[];
+    isV22: boolean;
+    isSuccess: boolean;
+}
+/**
+ * Validate envelope structure (not schema, just structure).
+ */
+export declare function validateEnvelopeStructure(data: unknown): EnvelopeStructureResult;
+/**
+ * Validate individual meta fields.
+ */
+export declare function validateMetaFields(meta: unknown): {
+    valid: boolean;
+    errors: string[];
+    normalized?: EnvelopeMeta;
+};

package/dist/src/cognitive/validator/envelope-validator.js

@@ -0,0 +1,214 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * Cognitive Envelope Validator
+ * Validates and detects envelope format versions.
+ */
+// =============================================================================
+// Envelope Detection
+// =============================================================================
+/**
+ * Check if response has envelope structure (v2.1 or v2.2).
+ */
+export function isEnvelopeResponse(data) {
+    if (typeof data !== 'object' || data === null)
+        return false;
+    const obj = data;
+    return typeof obj['ok'] === 'boolean';
+}
+/**
+ * Check if response is v2.2 envelope (has meta).
+ */
+export function isV22Envelope(data) {
+    if (!isEnvelopeResponse(data))
+        return false;
+    const obj = data;
+    return 'meta' in obj;
+}
+/**
+ * Check if response is success envelope.
+ */
+export function isSuccessEnvelope(data) {
+    if (!isEnvelopeResponse(data))
+        return false;
+    const obj = data;
+    return obj['ok'] === true && 'data' in obj;
+}
+/**
+ * Check if response is failure envelope.
+ */
+export function isFailureEnvelope(data) {
+    if (!isEnvelopeResponse(data))
+        return false;
+    const obj = data;
+    return obj['ok'] === false && 'error' in obj;
+}
+/**
+ * Validate envelope structure (not schema, just structure).
+ */
+export function validateEnvelopeStructure(data) {
+    const errors = [];
+    if (!isEnvelopeResponse(data)) {
+        return {
+            valid: false,
+            errors: ['Response is not an envelope (missing or invalid "ok" field)'],
+            isV22: false,
+            isSuccess: false,
+        };
+    }
+    const envelope = data;
+    const isV22 = 'meta' in envelope;
+    const isSuccess = envelope['ok'] === true;
+    // v2.2 requires meta
+    if (isV22) {
+        const meta = envelope['meta'];
+        if (typeof meta !== 'object' || meta === null) {
+            errors.push('v2.2 envelope requires "meta" to be an object');
+        }
+        else {
+            const metaObj = meta;
+            // Required meta fields
+            if (typeof metaObj['confidence'] !== 'number') {
+                errors.push('meta.confidence must be a number');
+            }
+            else {
+                const conf = metaObj['confidence'];
+                if (conf < 0 || conf > 1) {
+                    errors.push('meta.confidence must be between 0 and 1');
+                }
+            }
+            if (typeof metaObj['risk'] !== 'string') {
+                errors.push('meta.risk must be a string');
+            }
+            else if (!['none', 'low', 'medium', 'high'].includes(metaObj['risk'])) {
+                errors.push('meta.risk must be one of: none, low, medium, high');
+            }
+            if (typeof metaObj['explain'] !== 'string') {
+                errors.push('meta.explain must be a string');
+            }
+            else if (metaObj['explain'].length > 280) {
+                errors.push('meta.explain must be ≤280 characters');
+            }
+        }
+    }
+    // Success envelope requires data
+    if (isSuccess) {
+        if (!('data' in envelope)) {
+            errors.push('Success envelope requires "data" field');
+        }
+        else if (typeof envelope['data'] !== 'object' || envelope['data'] === null) {
+            errors.push('"data" must be an object');
+        }
+    }
+    // Failure envelope requires error
+    if (!isSuccess) {
+        if (!('error' in envelope)) {
+            errors.push('Failure envelope requires "error" field');
+        }
+        else if (typeof envelope['error'] !== 'object' || envelope['error'] === null) {
+            errors.push('"error" must be an object');
+        }
+        else {
+            const error = envelope['error'];
+            if (typeof error['code'] !== 'string') {
+                errors.push('error.code must be a string');
+            }
+            if (typeof error['message'] !== 'string') {
+                errors.push('error.message must be a string');
+            }
+        }
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+        isV22,
+        isSuccess,
+    };
+}
+// =============================================================================
+// Meta Field Validation
+// =============================================================================
+/**
+ * Validate individual meta fields.
+ */
+export function validateMetaFields(meta) {
+    const errors = [];
+    if (typeof meta !== 'object' || meta === null) {
+        return { valid: false, errors: ['meta must be an object'] };
+    }
+    const m = meta;
+    // Confidence
+    let confidence = 0.5;
+    if ('confidence' in m) {
+        if (typeof m['confidence'] === 'number') {
+            confidence = Math.max(0, Math.min(1, m['confidence']));
+            if (m['confidence'] < 0 || m['confidence'] > 1) {
+                errors.push('meta.confidence clamped to [0, 1] range');
+            }
+        }
+        else {
+            errors.push('meta.confidence must be a number');
+        }
+    }
+    else {
+        errors.push('meta.confidence is required');
+    }
+    // Risk
+    let risk = 'medium';
+    if ('risk' in m) {
+        if (typeof m['risk'] === 'string') {
+            const riskStr = m['risk'].toLowerCase().trim();
+            if (['none', 'low', 'medium', 'high'].includes(riskStr)) {
+                risk = riskStr;
+            }
+            else {
+                errors.push(`meta.risk invalid value: ${m['risk']}`);
+            }
+        }
+        else {
+            errors.push('meta.risk must be a string');
+        }
+    }
+    else {
+        errors.push('meta.risk is required');
+    }
+    // Explain
+    let explain = 'No explanation provided';
+    if ('explain' in m) {
+        if (typeof m['explain'] === 'string') {
+            explain = m['explain'].trim();
+            if (explain.length > 280) {
+                errors.push('meta.explain exceeds 280 characters');
+            }
+        }
+        else {
+            errors.push('meta.explain must be a string');
+        }
+    }
+    else {
+        errors.push('meta.explain is required');
+    }
+    const normalized = {
+        confidence,
+        risk,
+        explain: explain.substring(0, 280),
+    };
+    // Optional fields
+    if ('trace_id' in m && typeof m['trace_id'] === 'string') {
+        normalized.trace_id = m['trace_id'];
+    }
+    if ('model' in m && typeof m['model'] === 'string') {
+        normalized.model = m['model'];
+    }
+    if ('latency_ms' in m && typeof m['latency_ms'] === 'number') {
+        normalized.latency_ms = m['latency_ms'];
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+        normalized,
+    };
+}
+//# sourceMappingURL=envelope-validator.js.map

package/dist/src/cognitive/validator/envelope-validator.js.map

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

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

@@ -0,0 +1,9 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * Cognitive Validator - Public API
+ */
+export { validateInput, validateData, validateMeta, validateError, validateEnvelope, validateOverflow, validateFull, type FullValidationResult, } from './schema-validator.js';
+export { isEnvelopeResponse, isV22Envelope, isSuccessEnvelope, isFailureEnvelope, validateEnvelopeStructure, validateMetaFields, type EnvelopeStructureResult, } from './envelope-validator.js';

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

@@ -0,0 +1,10 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * Cognitive Validator - Public API
+ */
+export { validateInput, validateData, validateMeta, validateError, validateEnvelope, validateOverflow, validateFull, } from './schema-validator.js';
+export { isEnvelopeResponse, isV22Envelope, isSuccessEnvelope, isFailureEnvelope, validateEnvelopeStructure, validateMetaFields, } from './envelope-validator.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/cognitive/validator/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,GAEb,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,kBAAkB,EAClB,aAAa,EACb,iBAAiB,EACjB,iBAAiB,EACjB,yBAAyB,EACzB,kBAAkB,GAEnB,MAAM,yBAAyB,CAAC"}

package/dist/src/cognitive/validator/schema-validator.d.ts

@@ -0,0 +1,46 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * Cognitive Schema Validator
+ * Validates input, data, meta, and error schemas using JSON Schema.
+ */
+import type { CognitiveModule, ValidationResult, EnvelopeResponse, EnvelopeMeta } from '../types.js';
+/**
+ * Validate input data against module's input schema.
+ */
+export declare function validateInput(module: CognitiveModule, input: Record<string, unknown>): ValidationResult;
+/**
+ * Validate data payload against module's data schema.
+ */
+export declare function validateData(module: CognitiveModule, data: Record<string, unknown>): ValidationResult;
+/**
+ * Validate meta against module's meta schema or default.
+ */
+export declare function validateMeta(module: CognitiveModule, meta: EnvelopeMeta): ValidationResult;
+/**
+ * Validate error against module's error schema or default.
+ */
+export declare function validateError(module: CognitiveModule, error: {
+    code: string;
+    message: string;
+}): ValidationResult;
+/**
+ * Validate complete envelope response.
+ */
+export declare function validateEnvelope(module: CognitiveModule, envelope: EnvelopeResponse): ValidationResult;
+/**
+ * Validate overflow insights against module policy.
+ */
+export declare function validateOverflow(module: CognitiveModule, data: Record<string, unknown>): ValidationResult;
+export interface FullValidationResult extends ValidationResult {
+    inputErrors: string[];
+    metaErrors: string[];
+    dataErrors: string[];
+    overflowErrors: string[];
+}
+/**
+ * Run full validation pipeline on an envelope response.
+ */
+export declare function validateFull(module: CognitiveModule, envelope: EnvelopeResponse, input?: Record<string, unknown>): FullValidationResult;