mcard-js 2.1.12 → 2.1.13

package/dist/ptr/node/clm/runner.js

@@ -0,0 +1,324 @@
+/**
+ * CLMRunner - Execute JavaScript logic from CLM specifications
+ *
+ * Node.js PTR runtime for interpreting Cubical Logic Models.
+ *
+ * Refactored to use modular components from ./clm/
+ */
+import * as path from 'path';
+import { RuntimeFactory } from '../runtimes/index.js';
+// Utilities
+import { asObject, buildBaseContext, buildExecutionResult, isRecursiveCLM, isMultiRuntime, } from './utils.js';
+// Builtins
+import { isNetworkBuiltin, isLoaderBuiltin, getHandleBuiltinType } from './builtins/index.js';
+import { executeHandleVersion, executeHandlePrune } from './builtins/handle.js';
+// Other modules
+import { CLMLoader } from './loader.js';
+import { executeMultiRuntime } from './multiruntime.js';
+export class CLMRunner {
+    loader;
+    timeout;
+    collection;
+    constructor(basePath = process.cwd(), timeout = 5000, collection) {
+        this.loader = new CLMLoader(basePath);
+        this.timeout = timeout;
+        this.collection = collection;
+    }
+    /**
+     * Run a CLM directly from a file path.
+     */
+    async runFile(clmPath, input) {
+        const fullPath = path.isAbsolute(clmPath)
+            ? clmPath
+            : path.resolve(this.loader.basePath, clmPath);
+        const clm = this.loader.load(fullPath);
+        const chapterDir = path.dirname(fullPath);
+        return this.executeCLM(clm, chapterDir, input || {});
+    }
+    /**
+     * Execute a CLM specification with given input.
+     */
+    async executeCLM(clm, chapterDir, input) {
+        const startTime = Date.now();
+        const config = clm.clm.concrete;
+        const runtimeName = config.runtime || 'javascript';
+        // Handle recursive CLM
+        if (isRecursiveCLM(runtimeName)) {
+            return this.executeRecursive(runtimeName, config, chapterDir, input, clm);
+        }
+        try {
+            const builtin = config.builtin;
+            const operation = config.operation;
+            // Route to appropriate handler
+            if (isLoaderBuiltin(builtin, operation) || runtimeName === 'loader' || runtimeName === 'collection_loader') {
+                return this.executeLoader(runtimeName, config, clm, chapterDir, input, startTime);
+            }
+            if (isNetworkBuiltin(builtin)) {
+                return this.executeNetwork(config, clm, chapterDir, input, startTime);
+            }
+            const handleType = getHandleBuiltinType(builtin, operation);
+            if (handleType) {
+                const result = handleType === 'version'
+                    ? await executeHandleVersion(input)
+                    : await executeHandlePrune(input);
+                return buildExecutionResult(true, result, startTime, clm);
+            }
+            // Standard runtime execution
+            return this.executeStandard(runtimeName, config, clm, chapterDir, input, startTime);
+        }
+        catch (err) {
+            return buildExecutionResult(false, undefined, startTime, clm, err instanceof Error ? err.message : String(err));
+        }
+    }
+    /**
+     * Execute a CLM across multiple runtimes and verify consensus.
+     */
+    async executeMultiRuntime(clm, chapterDir, input) {
+        return executeMultiRuntime(clm, chapterDir, input);
+    }
+    /**
+     * Check if a CLM is a multi-runtime CLM.
+     */
+    isMultiRuntime(clm) {
+        return isMultiRuntime(clm);
+    }
+    /**
+     * Verify CLM output against expected result.
+     */
+    async verifyCLM(clm, chapterDir, input, expected) {
+        const executionResult = await this.executeCLM(clm, chapterDir, input);
+        return {
+            verified: executionResult.success &&
+                JSON.stringify(executionResult.result) === JSON.stringify(expected),
+            expected,
+            actual: executionResult.result,
+            executionResult,
+        };
+    }
+    /**
+     * Run all examples from a CLM specification.
+     */
+    async runExamples(clm, chapterDir) {
+        const examples = clm.examples || [];
+        const results = [];
+        for (const example of examples) {
+            const result = await this.executeCLM(clm, chapterDir, example.input);
+            results.push({ name: example.name, result });
+        }
+        return results;
+    }
+    /**
+     * Summarize example runs.
+     */
+    summarizeExampleRuns(clm, results) {
+        let passed = 0;
+        const summaryResults = results.map((res, index) => {
+            const example = clm.examples?.[index];
+            const expected = example?.expected_output;
+            const resultContains = example?.result_contains;
+            let match = false;
+            if (res.result.success) {
+                if (resultContains !== undefined) {
+                    const resultStr = typeof res.result.result === 'string'
+                        ? res.result.result
+                        : JSON.stringify(res.result.result);
+                    match = resultStr.includes(String(resultContains));
+                }
+                else if (expected === undefined) {
+                    match = true;
+                }
+                else {
+                    match = JSON.stringify(res.result.result) === JSON.stringify(expected);
+                }
+            }
+            if (match)
+                passed += 1;
+            return {
+                case: index + 1,
+                name: res.name,
+                input: example?.input,
+                result: res.result.result,
+                error: res.result.error,
+                expected: resultContains !== undefined ? `contains: ${resultContains}` : expected,
+                match,
+            };
+        });
+        return { total: summaryResults.length, passed, results: summaryResults };
+    }
+    /**
+     * Build CLM banner for display.
+     */
+    buildCLMBanner(clm) {
+        return {
+            header: [
+                `--- Executing ${clm.chapter.title} ---`,
+                `🧊 CLM Cube:`,
+                `  - Abstract (Why): ${clm.clm.abstract.concept}`,
+                `  - Concrete (How): ${clm.clm.concrete.manifestation}`,
+                `  - Balanced (What): ${clm.clm.balanced.expectation}`,
+            ],
+        };
+    }
+    /**
+     * Build execution report.
+     */
+    buildExecutionReport(clm, execution) {
+        return {
+            status: execution.success ? 'success' : 'failure',
+            result: execution.result,
+            error: execution.error,
+            chapter_id: clm.chapter.id,
+            chapter_title: clm.chapter.title,
+        };
+    }
+    /**
+     * Build summary report.
+     */
+    buildSummaryReport(clm, summary) {
+        return {
+            status: summary.passed === summary.total ? 'success' : 'failure',
+            result: {
+                success: summary.passed === summary.total,
+                total: summary.total,
+                results: summary.results.map((r) => ({
+                    case: r.case,
+                    name: r.name,
+                    result: r.result,
+                    error: r.error,
+                })),
+            },
+            chapter_id: clm.chapter.id,
+            chapter_title: clm.chapter.title,
+        };
+    }
+    // ─── Private Execution Methods ───────────────────────────────────────────
+    async executeLoader(runtimeName, config, clm, chapterDir, input, startTime) {
+        const targetRuntime = (runtimeName === 'collection_loader') ? 'collection_loader' : 'loader';
+        const loaderRuntime = RuntimeFactory.getRuntime(targetRuntime);
+        const loaderContext = buildBaseContext(clm, input);
+        const result = await loaderRuntime.execute('', loaderContext, config, chapterDir);
+        return buildExecutionResult(true, result, startTime, clm);
+    }
+    async executeNetwork(config, clm, chapterDir, input, startTime) {
+        const networkRuntime = RuntimeFactory.getRuntime('network', { collection: this.collection });
+        const networkContext = this.buildNetworkContext(clm, input, chapterDir);
+        const result = await networkRuntime.execute('', networkContext, config, chapterDir);
+        return buildExecutionResult(true, result, startTime, clm);
+    }
+    async executeStandard(runtimeName, config, clm, chapterDir, input, startTime) {
+        const runtime = RuntimeFactory.getRuntime(runtimeName, { collection: this.collection });
+        const codeOrPath = this.resolveCodeOrPath(runtimeName, config, clm, chapterDir, input);
+        if (!codeOrPath) {
+            if (runtimeName === 'lambda')
+                throw new Error(`Lambda runtime requires input expression or term`);
+            throw new Error(`Execution source not found for runtime ${runtimeName}`);
+        }
+        let executionContext = input;
+        if (runtimeName === 'javascript') {
+            executionContext = this.buildJavaScriptContext(input, chapterDir);
+        }
+        const result = await runtime.execute(codeOrPath, executionContext, config, chapterDir);
+        return buildExecutionResult(true, result, startTime, clm);
+    }
+    async executeRecursive(runtimePath, config, chapterDir, input, originalClm) {
+        const startTime = Date.now();
+        const boundary = config.boundary || 'intrinsic';
+        try {
+            const metaClmPath = path.resolve(chapterDir, runtimePath);
+            const metaClm = this.loader.load(metaClmPath);
+            const metaDir = path.dirname(metaClmPath);
+            const metaContext = {
+                ...asObject(input),
+                source_pcard_title: originalClm.chapter.title,
+                concrete: originalClm.clm.concrete,
+                abstract: originalClm.clm.abstract,
+                __input_content__: input
+            };
+            let metaResult;
+            if (boundary === 'extrinsic') {
+                const isolatedRunner = new CLMRunner(this.loader.basePath, this.timeout, this.collection);
+                metaResult = await isolatedRunner.executeCLM(metaClm, metaDir, metaContext);
+            }
+            else {
+                metaResult = await this.executeCLM(metaClm, metaDir, metaContext);
+            }
+            return {
+                success: metaResult.success,
+                result: metaResult.result,
+                error: metaResult.error,
+                executionTime: Date.now() - startTime + metaResult.executionTime,
+                clm: {
+                    chapter: originalClm.chapter.title,
+                    concept: originalClm.clm.abstract.concept,
+                    manifestation: originalClm.clm.concrete.manifestation,
+                    boundary
+                }
+            };
+        }
+        catch (e) {
+            return buildExecutionResult(false, undefined, startTime, originalClm, e instanceof Error ? e.message : String(e), boundary);
+        }
+    }
+    // ─── Private Helpers ─────────────────────────────────────────────────────
+    resolveCodeOrPath(runtimeName, config, clm, chapterDir, input) {
+        if (['rust', 'c'].includes(runtimeName)) {
+            let binaryPath = config.binary_path;
+            if (!binaryPath && config.runtimes_config) {
+                const rc = config.runtimes_config.find((r) => r.name === runtimeName);
+                binaryPath = rc?.binary;
+            }
+            return binaryPath || null;
+        }
+        if (runtimeName === 'wasm') {
+            let mod = config.wasm_module;
+            if (!mod && config.runtimes_config) {
+                const rc = config.runtimes_config.find((r) => r.name === runtimeName);
+                mod = rc?.module;
+            }
+            return mod || null;
+        }
+        if (runtimeName === 'llm')
+            return "llm-prompt";
+        if (runtimeName === 'lambda') {
+            const inputObj = asObject(input);
+            return inputObj.expression || inputObj.term || "lambda-op";
+        }
+        return this.loader.loadLogicFile(clm, chapterDir);
+    }
+    buildNetworkContext(clm, input, chapterDir) {
+        const baseContext = buildBaseContext(clm, input);
+        return {
+            ...baseContext,
+            input,
+            user_input: input,
+            secrets: process.env,
+            process,
+            runCLM: this.buildRunCLM(chapterDir),
+        };
+    }
+    buildJavaScriptContext(input, chapterDir) {
+        return {
+            ...asObject(input),
+            console,
+            setTimeout,
+            clearTimeout,
+            setInterval,
+            clearInterval,
+            process,
+            runCLM: async (clmFile, clmInput) => {
+                const fullPath = path.resolve(chapterDir, clmFile);
+                const res = await this.runFile(fullPath, clmInput);
+                if (!res.success)
+                    throw new Error(res.error || 'CLM execution failed');
+                return res.result;
+            }
+        };
+    }
+    buildRunCLM(chapterDir) {
+        return async (clmFile, clmInput) => {
+            const fullPath = path.resolve(chapterDir, clmFile);
+            return this.runFile(fullPath, clmInput);
+        };
+    }
+}
+//# sourceMappingURL=runner.js.map

package/dist/ptr/node/clm/runner.js.map

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

package/dist/ptr/node/clm/types.d.ts

@@ -0,0 +1,166 @@
+/**
+ * Type definitions for CLM (Cubical Logic Model) execution.
+ */
+/**
+ * CLM specification structure (parsed from YAML).
+ */
+export interface CLMSpec {
+    version: string;
+    chapter: {
+        id: number;
+        title: string;
+        mvp_card?: string;
+        pkc_task?: string;
+    };
+    clm: {
+        abstract: {
+            concept: string;
+            description: string;
+            math_model?: string;
+        };
+        concrete: {
+            manifestation: string;
+            description: string;
+            logic_source?: string;
+            runtime?: string;
+            code_file?: string;
+            entry_point?: string;
+            boundary?: 'intrinsic' | 'extrinsic';
+            runtimes_config?: RuntimeConfig[];
+            [key: string]: unknown;
+        };
+        balanced: {
+            expectation: string;
+            description: string;
+            test_cases?: unknown[];
+            examples?: unknown[];
+        };
+    };
+    examples?: CLMExample[];
+}
+/**
+ * Runtime configuration for multi-runtime CLMs.
+ */
+export interface RuntimeConfig {
+    name: string;
+    file?: string;
+    binary?: string;
+    module?: string;
+    entry?: string;
+}
+/**
+ * CLM example definition.
+ */
+export interface CLMExample {
+    name: string;
+    input?: unknown;
+    expected_output?: unknown;
+    result_contains?: string;
+    [key: string]: unknown;
+}
+/**
+ * Result of executing a single CLM.
+ */
+export interface ExecutionResult {
+    success: boolean;
+    result?: unknown;
+    error?: string;
+    executionTime: number;
+    clm: {
+        chapter: string;
+        concept: string;
+        manifestation: string;
+        boundary?: string;
+    };
+}
+/**
+ * Result of executing on a single runtime (for multi-runtime).
+ */
+export interface RuntimeResult {
+    runtime: string;
+    success: boolean;
+    result?: unknown;
+    error?: string;
+    executionTime: number;
+}
+/**
+ * Result of multi-runtime consensus execution.
+ */
+export interface MultiRuntimeResult {
+    success: boolean;
+    consensus: boolean;
+    results: RuntimeResult[];
+    consensusValue?: unknown;
+    error?: string;
+    executionTime: number;
+    clm: {
+        chapter: string;
+        concept: string;
+        manifestation: string;
+        boundary?: string;
+    };
+}
+/**
+ * Verification result (comparing actual vs expected).
+ */
+export interface VerificationResult {
+    verified: boolean;
+    expected: unknown;
+    actual: unknown;
+    executionResult: ExecutionResult;
+}
+/**
+ * Summary of running all examples in a CLM.
+ */
+export interface RunExamplesSummary {
+    total: number;
+    passed: number;
+    results: ExampleRunResult[];
+}
+/**
+ * Result of running a single example.
+ */
+export interface ExampleRunResult {
+    case: number;
+    name: string;
+    input: unknown;
+    result: unknown;
+    error?: string;
+    expected: unknown;
+    match: boolean;
+}
+/**
+ * Execution report for external reporting.
+ */
+export interface ExecutionReport {
+    status: 'success' | 'failure';
+    result?: unknown;
+    error?: string;
+    chapter_id: number;
+    chapter_title: string;
+}
+/**
+ * Summary report for external reporting.
+ */
+export interface SummaryReport {
+    status: 'success' | 'failure';
+    result: {
+        success: boolean;
+        total: number;
+        results: Array<{
+            case: number;
+            name: string;
+            result: unknown;
+            error?: string;
+        }>;
+    };
+    chapter_id: number;
+    chapter_title: string;
+}
+/**
+ * CLM banner lines for display.
+ */
+export interface CLMBannerLines {
+    header: string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/ptr/node/clm/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/ptr/node/clm/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,WAAW,OAAO;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE;QACL,EAAE,EAAE,MAAM,CAAC;QACX,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,GAAG,EAAE;QACD,QAAQ,EAAE;YACN,OAAO,EAAE,MAAM,CAAC;YAChB,WAAW,EAAE,MAAM,CAAC;YACpB,UAAU,CAAC,EAAE,MAAM,CAAC;SACvB,CAAC;QACF,QAAQ,EAAE;YACN,aAAa,EAAE,MAAM,CAAC;YACtB,WAAW,EAAE,MAAM,CAAC;YACpB,YAAY,CAAC,EAAE,MAAM,CAAC;YACtB,OAAO,CAAC,EAAE,MAAM,CAAC;YACjB,SAAS,CAAC,EAAE,MAAM,CAAC;YACnB,WAAW,CAAC,EAAE,MAAM,CAAC;YACrB,QAAQ,CAAC,EAAE,WAAW,GAAG,WAAW,CAAC;YACrC,eAAe,CAAC,EAAE,aAAa,EAAE,CAAC;YAClC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;SAC1B,CAAC;QACF,QAAQ,EAAE;YACN,WAAW,EAAE,MAAM,CAAC;YACpB,WAAW,EAAE,MAAM,CAAC;YACpB,UAAU,CAAC,EAAE,OAAO,EAAE,CAAC;YACvB,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;SACxB,CAAC;KACL,CAAC;IACF,QAAQ,CAAC,EAAE,UAAU,EAAE,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,GAAG,EAAE;QACD,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,aAAa,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;CACL;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,GAAG,EAAE;QACD,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,aAAa,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;CACL;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAC/B,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;IAChB,eAAe,EAAE,eAAe,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,gBAAgB,EAAE,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC5B,MAAM,EAAE,SAAS,GAAG,SAAS,CAAC;IAC9B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC1B,MAAM,EAAE,SAAS,GAAG,SAAS,CAAC;IAC9B,MAAM,EAAE;QACJ,OAAO,EAAE,OAAO,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,KAAK,CAAC;YACX,IAAI,EAAE,MAAM,CAAC;YACb,IAAI,EAAE,MAAM,CAAC;YACb,MAAM,EAAE,OAAO,CAAC;YAChB,KAAK,CAAC,EAAE,MAAM,CAAC;SAClB,CAAC,CAAC;KACN,CAAC;IACF,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC3B,MAAM,EAAE,MAAM,EAAE,CAAC;CACpB"}

package/dist/ptr/node/clm/types.js

@@ -0,0 +1,5 @@
+/**
+ * Type definitions for CLM (Cubical Logic Model) execution.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/ptr/node/clm/types.js.map

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

package/dist/ptr/node/clm/utils.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Utility functions for CLM execution.
+ */
+import type { CLMSpec, ExecutionResult } from './types.js';
+/**
+ * Compare two values with floating-point tolerance for numeric types.
+ */
+export declare function resultsEqual(a: unknown, b: unknown, tolerance?: number): boolean;
+/**
+ * Safely convert input to object.
+ */
+export declare function asObject(input: unknown): Record<string, any>;
+/**
+ * Build base context for execution.
+ */
+export declare function buildBaseContext(clm: CLMSpec, input: unknown): Record<string, any>;
+/**
+ * Build execution result object.
+ */
+export declare function buildExecutionResult(success: boolean, result: unknown, startTime: number, clm: CLMSpec, error?: string, boundary?: string): ExecutionResult;
+/**
+ * Check if runtime name indicates a recursive CLM.
+ */
+export declare function isRecursiveCLM(runtimeName: string): boolean;
+/**
+ * Check if CLM has multi-runtime configuration.
+ */
+export declare function isMultiRuntime(clm: CLMSpec): boolean;
+//# sourceMappingURL=utils.d.ts.map

package/dist/ptr/node/clm/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../../src/ptr/node/clm/utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE3D;;GAEG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,SAAS,GAAE,MAAa,GAAG,OAAO,CA+BtF;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAE5D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAOlF;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAChC,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,OAAO,EACf,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,OAAO,EACZ,KAAK,CAAC,EAAE,MAAM,EACd,QAAQ,CAAC,EAAE,MAAM,GAClB,eAAe,CAajB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAI3D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAGpD"}

package/dist/ptr/node/clm/utils.js

@@ -0,0 +1,88 @@
+/**
+ * Utility functions for CLM execution.
+ */
+/**
+ * Compare two values with floating-point tolerance for numeric types.
+ */
+export function resultsEqual(a, b, tolerance = 1e-9) {
+    // Both null or undefined
+    if (a === b)
+        return true;
+    if (a == null || b == null)
+        return false;
+    // Numbers - use tolerance
+    if (typeof a === 'number' && typeof b === 'number') {
+        if (Number.isNaN(a) && Number.isNaN(b))
+            return true;
+        if (!Number.isFinite(a) || !Number.isFinite(b))
+            return a === b;
+        return Math.abs(a - b) <= tolerance * Math.max(1, Math.abs(a), Math.abs(b));
+    }
+    // Arrays - compare element by element
+    if (Array.isArray(a) && Array.isArray(b)) {
+        if (a.length !== b.length)
+            return false;
+        return a.every((val, i) => resultsEqual(val, b[i], tolerance));
+    }
+    // Objects - compare properties
+    if (typeof a === 'object' && typeof b === 'object') {
+        const keysA = Object.keys(a);
+        const keysB = Object.keys(b);
+        if (keysA.length !== keysB.length)
+            return false;
+        return keysA.every(key => keysB.includes(key) &&
+            resultsEqual(a[key], b[key], tolerance));
+    }
+    // Strings and other types - strict equality
+    return a === b;
+}
+/**
+ * Safely convert input to object.
+ */
+export function asObject(input) {
+    return typeof input === 'object' && input !== null ? input : {};
+}
+/**
+ * Build base context for execution.
+ */
+export function buildBaseContext(clm, input) {
+    const inputObj = asObject(input);
+    return {
+        balanced: clm.clm.balanced,
+        params: inputObj,
+        ...inputObj,
+    };
+}
+/**
+ * Build execution result object.
+ */
+export function buildExecutionResult(success, result, startTime, clm, error, boundary) {
+    return {
+        success,
+        result,
+        error,
+        executionTime: Date.now() - startTime,
+        clm: {
+            chapter: clm.chapter.title,
+            concept: clm.clm.abstract.concept,
+            manifestation: clm.clm.concrete.manifestation,
+            boundary,
+        }
+    };
+}
+/**
+ * Check if runtime name indicates a recursive CLM.
+ */
+export function isRecursiveCLM(runtimeName) {
+    return runtimeName.endsWith('.clm') ||
+        runtimeName.endsWith('.yaml') ||
+        runtimeName.endsWith('.yml');
+}
+/**
+ * Check if CLM has multi-runtime configuration.
+ */
+export function isMultiRuntime(clm) {
+    const runtimesConfig = clm.clm?.concrete?.runtimes_config;
+    return Array.isArray(runtimesConfig) && runtimesConfig.length > 0;
+}
+//# sourceMappingURL=utils.js.map

package/dist/ptr/node/clm/utils.js.map

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

package/dist/ptr/node/network/HttpClient.d.ts

@@ -0,0 +1,14 @@
+import { HttpSuccessResponse, HttpErrorResponse, RetryConfig, CacheConfig, ResponseType } from '../NetworkConfig.js';
+import { RateLimiter, NetworkCache } from './NetworkInfrastructure.js';
+export declare class HttpClient {
+    private rateLimiter;
+    private cache;
+    constructor(rateLimiter: RateLimiter, cache: NetworkCache);
+    request(url: string, method: string, headers: Record<string, string>, body: BodyInit | undefined, config: {
+        retry?: RetryConfig;
+        cache?: CacheConfig;
+        timeout?: number;
+        responseType?: ResponseType;
+    }): Promise<HttpSuccessResponse | HttpErrorResponse>;
+}
+//# sourceMappingURL=HttpClient.d.ts.map