@forthix/forthic 0.10.0 → 0.11.0

package/dist/cjs/jsonrpc/server.js

@@ -0,0 +1,386 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.serve = serve;
+exports.main = main;
+/**
+ * TypeScript JSON-RPC 2.0 Server for Forthic
+ *
+ * Mirrors the four methods of the gRPC server:
+ *   executeWord, executeSequence, listModules, getModuleInfo
+ *
+ * Transport: HTTP POST /rpc with JSON-RPC 2.0 envelopes.
+ * Uses Node's built-in `http` module — zero new dependencies.
+ *
+ * `executeSequence` is a single JSON-RPC call with an array of words; it is
+ * NOT a JSON-RPC batch. Batch envelopes are rejected with code -32600.
+ */
+const http = __importStar(require("http"));
+const interpreter_js_1 = require("../forthic/interpreter.js");
+const serializer_js_1 = require("../grpc/serializer.js");
+const fs_module_js_1 = require("../forthic/modules/typescript/fs_module.js");
+const errors_js_1 = require("./errors.js");
+class ForthicJsonRpcServicer {
+    runtimeModules;
+    constructor() {
+        this.runtimeModules = {
+            fs: new fs_module_js_1.FsModule(),
+        };
+    }
+    async executeWord(params) {
+        const wordName = params?.word_name;
+        if (typeof wordName !== 'string') {
+            throw makeInvalidParams('executeWord requires string "word_name"');
+        }
+        const stackParam = params?.stack;
+        if (!Array.isArray(stackParam)) {
+            throw makeInvalidParams('executeWord requires array "stack"');
+        }
+        const stack = stackParam.map((sv) => (0, serializer_js_1.deserializeValue)(sv));
+        const resultStack = await this._executeWithStack(wordName, stack);
+        return { result_stack: resultStack.map((v) => (0, serializer_js_1.serializeValue)(v)) };
+    }
+    async executeSequence(params) {
+        const wordNames = params?.word_names;
+        if (!Array.isArray(wordNames) || !wordNames.every((w) => typeof w === 'string')) {
+            throw makeInvalidParams('executeSequence requires string[] "word_names"');
+        }
+        const stackParam = params?.stack;
+        if (!Array.isArray(stackParam)) {
+            throw makeInvalidParams('executeSequence requires array "stack"');
+        }
+        const stack = stackParam.map((sv) => (0, serializer_js_1.deserializeValue)(sv));
+        const resultStack = await this._executeSequenceWithStack(wordNames, stack);
+        return { result_stack: resultStack.map((v) => (0, serializer_js_1.serializeValue)(v)) };
+    }
+    async listModules(_params) {
+        const modules = [];
+        for (const [name, mod] of Object.entries(this.runtimeModules)) {
+            modules.push({
+                name,
+                description: `TypeScript-specific ${name} module`,
+                word_count: this._getModuleWordCount(mod),
+                runtime_specific: true,
+            });
+        }
+        return { modules };
+    }
+    async getModuleInfo(params) {
+        const moduleName = params?.module_name;
+        if (typeof moduleName !== 'string') {
+            throw makeInvalidParams('getModuleInfo requires string "module_name"');
+        }
+        if (!(moduleName in this.runtimeModules)) {
+            throw new JsonRpcMethodError(errors_js_1.JsonRpcErrorCode.ModuleNotFound, `Module '${moduleName}' not found`);
+        }
+        const mod = this.runtimeModules[moduleName];
+        const words = [];
+        if (typeof mod.getWordDocs === 'function') {
+            for (const doc of mod.getWordDocs()) {
+                words.push({
+                    name: doc.name,
+                    stack_effect: doc.stackEffect,
+                    description: doc.description,
+                });
+            }
+        }
+        else {
+            const exportedWords = mod.exportable || {};
+            for (const [name, _word] of Object.entries(exportedWords)) {
+                words.push({
+                    name,
+                    stack_effect: '( -- )',
+                    description: `${name} word from ${moduleName} module`,
+                });
+            }
+        }
+        return {
+            name: moduleName,
+            description: `TypeScript-specific ${moduleName} module`,
+            words,
+        };
+    }
+    buildRuntimeError(exception, wordName = null, context = {}) {
+        const stackTrace = exception?.stack ? String(exception.stack).split('\n') : [];
+        const errorType = exception?.constructor?.name || 'Error';
+        const errorContext = {};
+        if (wordName)
+            errorContext['word_name'] = wordName;
+        Object.assign(errorContext, context);
+        const errorInfo = {
+            message: exception?.message ?? String(exception),
+            runtime: 'typescript',
+            stack_trace: stackTrace,
+            error_type: errorType,
+            context: errorContext,
+        };
+        if (stackTrace.length > 0) {
+            const m = stackTrace[0].match(/\((.*):(\d+):\d+\)/);
+            if (m)
+                errorInfo.word_location = `${m[1]}:${m[2]}`;
+        }
+        return errorInfo;
+    }
+    getRegisteredModuleNames() {
+        return Object.keys(this.runtimeModules);
+    }
+    async _executeWithStack(wordName, stack) {
+        const interp = new interpreter_js_1.StandardInterpreter();
+        for (const [_n, m] of Object.entries(this.runtimeModules)) {
+            interp.register_module(m);
+        }
+        if (Object.keys(this.runtimeModules).length > 0) {
+            interp.use_modules(Object.keys(this.runtimeModules));
+        }
+        for (const item of stack)
+            interp.stack_push(item);
+        await interp.run(wordName);
+        return interp.get_stack().get_items();
+    }
+    async _executeSequenceWithStack(wordNames, stack) {
+        const interp = new interpreter_js_1.StandardInterpreter();
+        for (const [_n, m] of Object.entries(this.runtimeModules)) {
+            interp.register_module(m);
+        }
+        if (Object.keys(this.runtimeModules).length > 0) {
+            interp.use_modules(Object.keys(this.runtimeModules));
+        }
+        for (const item of stack)
+            interp.stack_push(item);
+        for (const wordName of wordNames) {
+            await interp.run(wordName);
+        }
+        return interp.get_stack().get_items();
+    }
+    _getModuleWordCount(mod) {
+        if (typeof mod.getWordDocs === 'function')
+            return mod.getWordDocs().length;
+        if (mod.exportable)
+            return Object.keys(mod.exportable).length;
+        return 0;
+    }
+}
+class JsonRpcMethodError extends Error {
+    code;
+    data;
+    constructor(code, message, data) {
+        super(message);
+        this.code = code;
+        this.data = data;
+        this.name = 'JsonRpcMethodError';
+    }
+}
+function makeInvalidParams(message) {
+    return new JsonRpcMethodError(errors_js_1.JsonRpcErrorCode.InvalidParams, message);
+}
+async function readBody(req) {
+    return new Promise((resolve, reject) => {
+        const chunks = [];
+        req.on('data', (c) => chunks.push(c));
+        req.on('end', () => resolve(Buffer.concat(chunks).toString('utf-8')));
+        req.on('error', reject);
+    });
+}
+function writeJsonRpc(res, status, payload) {
+    const body = JSON.stringify(payload);
+    res.writeHead(status, {
+        'Content-Type': 'application/json',
+        'Content-Length': Buffer.byteLength(body),
+    });
+    res.end(body);
+}
+async function dispatch(servicer, request) {
+    const id = request.id ?? null;
+    const method = request.method;
+    const params = request.params ?? {};
+    try {
+        let result;
+        switch (method) {
+            case 'executeWord':
+                try {
+                    result = await servicer.executeWord(params);
+                }
+                catch (err) {
+                    if (err instanceof JsonRpcMethodError)
+                        throw err;
+                    // Treat as Forthic runtime error with rich data
+                    const data = servicer.buildRuntimeError(err, params?.word_name ?? null);
+                    throw new JsonRpcMethodError(errors_js_1.JsonRpcErrorCode.RuntimeError, data.message, data);
+                }
+                break;
+            case 'executeSequence':
+                try {
+                    result = await servicer.executeSequence(params);
+                }
+                catch (err) {
+                    if (err instanceof JsonRpcMethodError)
+                        throw err;
+                    const seqContext = Array.isArray(params?.word_names)
+                        ? { word_sequence: params.word_names.join(', ') }
+                        : {};
+                    const data = servicer.buildRuntimeError(err, null, seqContext);
+                    throw new JsonRpcMethodError(errors_js_1.JsonRpcErrorCode.RuntimeError, data.message, data);
+                }
+                break;
+            case 'listModules':
+                result = await servicer.listModules(params);
+                break;
+            case 'getModuleInfo':
+                result = await servicer.getModuleInfo(params);
+                break;
+            default:
+                throw new JsonRpcMethodError(errors_js_1.JsonRpcErrorCode.MethodNotFound, `Method not found: ${method}`);
+        }
+        return { jsonrpc: '2.0', id, result };
+    }
+    catch (err) {
+        if (err instanceof JsonRpcMethodError) {
+            const error = { code: err.code, message: err.message };
+            if (err.data !== undefined)
+                error.data = err.data;
+            return { jsonrpc: '2.0', id, error };
+        }
+        return {
+            jsonrpc: '2.0',
+            id,
+            error: {
+                code: errors_js_1.JsonRpcErrorCode.InternalError,
+                message: err?.message ?? String(err),
+            },
+        };
+    }
+}
+async function serve(port = 8765) {
+    const servicer = new ForthicJsonRpcServicer();
+    const server = http.createServer(async (req, res) => {
+        if (req.method !== 'POST') {
+            res.writeHead(405, { 'Content-Type': 'text/plain', Allow: 'POST' });
+            res.end('Method Not Allowed');
+            return;
+        }
+        if (req.url !== '/rpc' && req.url !== '/') {
+            res.writeHead(404, { 'Content-Type': 'text/plain' });
+            res.end('Not Found');
+            return;
+        }
+        const ctype = (req.headers['content-type'] || '').toString().toLowerCase();
+        if (!ctype.includes('application/json')) {
+            res.writeHead(415, { 'Content-Type': 'text/plain' });
+            res.end('Unsupported Media Type');
+            return;
+        }
+        let raw;
+        try {
+            raw = await readBody(req);
+        }
+        catch {
+            writeJsonRpc(res, 200, {
+                jsonrpc: '2.0',
+                id: null,
+                error: { code: errors_js_1.JsonRpcErrorCode.ParseError, message: 'Failed to read request body' },
+            });
+            return;
+        }
+        let parsed;
+        try {
+            parsed = JSON.parse(raw);
+        }
+        catch (err) {
+            writeJsonRpc(res, 200, {
+                jsonrpc: '2.0',
+                id: null,
+                error: { code: errors_js_1.JsonRpcErrorCode.ParseError, message: `Parse error: ${err.message}` },
+            });
+            return;
+        }
+        if (Array.isArray(parsed)) {
+            writeJsonRpc(res, 200, {
+                jsonrpc: '2.0',
+                id: null,
+                error: {
+                    code: errors_js_1.JsonRpcErrorCode.InvalidRequest,
+                    message: 'Batch requests are not supported',
+                },
+            });
+            return;
+        }
+        if (!parsed ||
+            parsed.jsonrpc !== '2.0' ||
+            typeof parsed.method !== 'string' ||
+            !('id' in parsed)) {
+            writeJsonRpc(res, 200, {
+                jsonrpc: '2.0',
+                id: parsed?.id ?? null,
+                error: {
+                    code: errors_js_1.JsonRpcErrorCode.InvalidRequest,
+                    message: 'Invalid JSON-RPC 2.0 request',
+                },
+            });
+            return;
+        }
+        const response = await dispatch(servicer, parsed);
+        writeJsonRpc(res, 200, response);
+    });
+    return new Promise((resolve, reject) => {
+        server.once('error', reject);
+        server.listen(port, '0.0.0.0', () => {
+            const loaded = servicer.getRegisteredModuleNames();
+            if (loaded.length > 0) {
+                console.log(`  - Available runtime modules: ${loaded.join(', ')}`);
+            }
+            else {
+                console.log('  - No runtime-specific modules loaded');
+            }
+            resolve(server);
+        });
+    });
+}
+async function main() {
+    const args = process.argv.slice(2);
+    let port = 8765;
+    const portIndex = args.indexOf('--port');
+    if (portIndex !== -1 && args[portIndex + 1]) {
+        port = parseInt(args[portIndex + 1], 10);
+    }
+    await serve(port);
+    console.log(`Forthic JSON-RPC server listening on port ${port}`);
+}
+if (require.main === module) {
+    main().catch((error) => {
+        console.error('Fatal error:', error);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=server.js.map

package/dist/cjs/jsonrpc/server.js.map

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

package/dist/cjs/websocket/serializer.d.ts

@@ -12,16 +12,16 @@ export interface StackValue {
  * Serialize a JavaScript value to a JSON StackValue
  * Uses shared type detection and maps to JSON format
  */
-export declare function serializeValue(value: any): StackValue;
+export declare function serializeValue(value: any, path?: string): StackValue;
 /**
  * Deserialize a JSON StackValue to a JavaScript value
  */
-export declare function deserializeValue(stackValue: StackValue): any;
+export declare function deserializeValue(stackValue: StackValue, path?: string): any;
 /**
  * Serialize an array of values (stack)
  */
-export declare function serializeStack(stack: any[]): StackValue[];
+export declare function serializeStack(stack: any[], pathPrefix?: string): StackValue[];
 /**
  * Deserialize an array of StackValues (stack)
  */
-export declare function deserializeStack(stackValues: StackValue[]): any[];
+export declare function deserializeStack(stackValues: StackValue[], pathPrefix?: string): any[];

package/dist/cjs/websocket/serializer.js

@@ -15,8 +15,8 @@ const type_utils_js_1 = require("../common/type_utils.js");
  * Serialize a JavaScript value to a JSON StackValue
  * Uses shared type detection and maps to JSON format
  */
-function serializeValue(value) {
-    const type = (0, type_utils_js_1.getForthicType)(value);
+function serializeValue(value, path = '') {
+    const type = (0, type_utils_js_1.getForthicType)(value, path);
     switch (type) {
         case 'null':
             return { type: 'null', value: null };
@@ -31,17 +31,18 @@ function serializeValue(value) {
         case 'array':
             return {
                 type: 'array',
-                value: value.map((item) => serializeValue(item)),
+                value: value.map((item, i) => serializeValue(item, `${path}[${i}]`)),
             };
-        case 'record':
+        case 'record': {
             const fields = {};
             for (const [key, val] of Object.entries(value)) {
-                fields[key] = serializeValue(val);
+                fields[key] = serializeValue(val, `${path}${(0, type_utils_js_1.pathSegmentForKey)(key)}`);
             }
             return {
                 type: 'record',
                 value: fields,
             };
+        }
         case 'instant':
             return {
                 type: 'instant',
@@ -58,13 +59,13 @@ function serializeValue(value) {
                 value: value.toString(),
             };
         default:
-            throw new Error(`Unsupported Forthic type: ${type}`);
+            throw new Error(`Unsupported Forthic type: ${type}${path ? ` at path: ${path}` : ''}`);
     }
 }
 /**
  * Deserialize a JSON StackValue to a JavaScript value
  */
-function deserializeValue(stackValue) {
+function deserializeValue(stackValue, path = '') {
     switch (stackValue.type) {
         case 'int':
         case 'float':
@@ -74,10 +75,10 @@ function deserializeValue(stackValue) {
         case 'null':
             return null;
         case 'array':
-            return stackValue.value.map((v) => deserializeValue(v));
+            return stackValue.value.map((v, i) => deserializeValue(v, `${path}[${i}]`));
         case 'record':
             return Object.entries(stackValue.value).reduce((acc, [k, v]) => {
-                acc[k] = deserializeValue(v);
+                acc[k] = deserializeValue(v, `${path}${(0, type_utils_js_1.pathSegmentForKey)(k)}`);
                 return acc;
             }, {});
         case 'instant':
@@ -87,19 +88,19 @@ function deserializeValue(stackValue) {
         case 'zoned_datetime':
             return Temporal.ZonedDateTime.from(stackValue.value);
         default:
-            throw new Error(`Unknown stack value type: ${stackValue.type}`);
+            throw new Error(`Unknown stack value type: ${stackValue.type}${path ? ` at path: ${path}` : ''}`);
     }
 }
 /**
  * Serialize an array of values (stack)
  */
-function serializeStack(stack) {
-    return stack.map((value) => serializeValue(value));
+function serializeStack(stack, pathPrefix = '') {
+    return stack.map((value, i) => serializeValue(value, `${pathPrefix}[${i}]`));
 }
 /**
  * Deserialize an array of StackValues (stack)
  */
-function deserializeStack(stackValues) {
-    return stackValues.map((value) => deserializeValue(value));
+function deserializeStack(stackValues, pathPrefix = '') {
+    return stackValues.map((value, i) => deserializeValue(value, `${pathPrefix}[${i}]`));
 }
 //# sourceMappingURL=serializer.js.map

package/dist/cjs/websocket/serializer.js.map

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

package/dist/esm/common/runtime_client.d.ts

@@ -0,0 +1,30 @@
+/**
+ * RuntimeClient - Transport-agnostic interface for remote Forthic runtime clients.
+ *
+ * Implemented by both GrpcClient (src/grpc/client.ts) and JsonRpcClient
+ * (src/jsonrpc/client.ts) so RemoteModule, RemoteWord, and RuntimeManager
+ * work the same way regardless of underlying transport.
+ */
+export interface ModuleSummary {
+    name: string;
+    description: string;
+    word_count: number;
+    runtime_specific: boolean;
+}
+export interface WordInfo {
+    name: string;
+    stack_effect: string;
+    description: string;
+}
+export interface GetModuleInfoResponse {
+    name: string;
+    description: string;
+    words: WordInfo[];
+}
+export interface RuntimeClient {
+    executeWord(wordName: string, stack: any[]): Promise<any[]>;
+    executeSequence(wordNames: string[], stack: any[]): Promise<any[]>;
+    listModules(): Promise<ModuleSummary[]>;
+    getModuleInfo(moduleName: string): Promise<GetModuleInfoResponse>;
+    close(): void;
+}

package/dist/esm/common/runtime_client.js

@@ -0,0 +1,9 @@
+/**
+ * RuntimeClient - Transport-agnostic interface for remote Forthic runtime clients.
+ *
+ * Implemented by both GrpcClient (src/grpc/client.ts) and JsonRpcClient
+ * (src/jsonrpc/client.ts) so RemoteModule, RemoteWord, and RuntimeManager
+ * work the same way regardless of underlying transport.
+ */
+export {};
+//# sourceMappingURL=runtime_client.js.map

package/dist/esm/common/runtime_client.js.map

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

package/dist/esm/common/type_utils.d.ts

@@ -16,7 +16,13 @@ export type ForthicType = 'null' | 'boolean' | 'integer' | 'float' | 'string' |
  * - Check boolean BEFORE number (to avoid typeof confusion)
  * - Check array BEFORE object (arrays are objects)
  */
-export declare function getForthicType(value: any): ForthicType;
+export declare function getForthicType(value: any, path?: string): ForthicType;
+/**
+ * Format a record key as a path segment.
+ * Valid JS identifiers become `.key`; everything else becomes `["key"]` (JSON-escaped)
+ * so the path is unambiguous and copy-pasteable.
+ */
+export declare function pathSegmentForKey(key: string): string;
 /**
  * Check if a value is a temporal type
  */

package/dist/esm/common/type_utils.js

@@ -13,7 +13,7 @@ import { isPlainDate, isInstant, isZonedDateTime } from './temporal_utils.js';
  * - Check boolean BEFORE number (to avoid typeof confusion)
  * - Check array BEFORE object (arrays are objects)
  */
-export function getForthicType(value) {
+export function getForthicType(value, path = '') {
     // Handle null/undefined
     if (value === null || value === undefined) {
         return 'null';
@@ -48,7 +48,17 @@ export function getForthicType(value) {
     if (typeof value === 'object') {
         return 'record';
     }
-    throw new Error(`Unsupported value type: ${typeof value}`);
+    throw new Error(`Unsupported value type: ${typeof value}${path ? ` at path: ${path}` : ''}`);
+}
+/**
+ * Format a record key as a path segment.
+ * Valid JS identifiers become `.key`; everything else becomes `["key"]` (JSON-escaped)
+ * so the path is unambiguous and copy-pasteable.
+ */
+export function pathSegmentForKey(key) {
+    return /^[A-Za-z_$][A-Za-z0-9_$]*$/.test(key)
+        ? `.${key}`
+        : `[${JSON.stringify(key)}]`;
 }
 /**
  * Check if a value is a temporal type

package/dist/esm/common/type_utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"type_utils.js","sourceRoot":"","sources":["../../../src/common/type_utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAiB9E;;;;;;;;;GASG;AACH,MAAM,UAAU,cAAc,CAAC,KAAU;IACvC,wBAAwB;IACxB,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QAC1C,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,6DAA6D;IAC7D,IAAI,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3B,OAAO,gBAAgB,CAAC;IAC1B,CAAC;IAED,IAAI,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;QACrB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,YAAY,CAAC;IACtB,CAAC;IAED,uCAAuC;IACvC,IAAI,OAAO,KAAK,KAAK,SAAS,EAAE,CAAC;QAC/B,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,+CAA+C;IAC/C,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC;IACvD,CAAC;IAED,gBAAgB;IAChB,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,qCAAqC;IACrC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,uBAAuB;IACvB,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,2BAA2B,OAAO,KAAK,EAAE,CAAC,CAAC;AAC7D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,KAAU;IACvC,OAAO,SAAS,CAAC,KAAK,CAAC,IAAI,WAAW,CAAC,KAAK,CAAC,IAAI,eAAe,CAAC,KAAK,CAAC,CAAC;AAC1E,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,KAAU;IACpC,MAAM,IAAI,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;IACnC,OAAO,IAAI,KAAK,OAAO,IAAI,IAAI,KAAK,QAAQ,CAAC;AAC/C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,KAAU;IACpC,MAAM,IAAI,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;IACnC,OAAO,IAAI,KAAK,OAAO,IAAI,IAAI,KAAK,QAAQ,CAAC;AAC/C,CAAC"}
+{"version":3,"file":"type_utils.js","sourceRoot":"","sources":["../../../src/common/type_utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAiB9E;;;;;;;;;GASG;AACH,MAAM,UAAU,cAAc,CAAC,KAAU,EAAE,OAAe,EAAE;IAC1D,wBAAwB;IACxB,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QAC1C,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,6DAA6D;IAC7D,IAAI,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3B,OAAO,gBAAgB,CAAC;IAC1B,CAAC;IAED,IAAI,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;QACrB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,YAAY,CAAC;IACtB,CAAC;IAED,uCAAuC;IACvC,IAAI,OAAO,KAAK,KAAK,SAAS,EAAE,CAAC;QAC/B,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,+CAA+C;IAC/C,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC;IACvD,CAAC;IAED,gBAAgB;IAChB,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,qCAAqC;IACrC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,uBAAuB;IACvB,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,2BAA2B,OAAO,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,aAAa,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAC/F,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,GAAW;IAC3C,OAAO,4BAA4B,CAAC,IAAI,CAAC,GAAG,CAAC;QAC3C,CAAC,CAAC,IAAI,GAAG,EAAE;QACX,CAAC,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC;AACjC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,KAAU;IACvC,OAAO,SAAS,CAAC,KAAK,CAAC,IAAI,WAAW,CAAC,KAAK,CAAC,IAAI,eAAe,CAAC,KAAK,CAAC,CAAC;AAC1E,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,KAAU;IACpC,MAAM,IAAI,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;IACnC,OAAO,IAAI,KAAK,OAAO,IAAI,IAAI,KAAK,QAAQ,CAAC;AAC/C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,KAAU;IACpC,MAAM,IAAI,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;IACnC,OAAO,IAAI,KAAK,OAAO,IAAI,IAAI,KAAK,QAAQ,CAAC;AAC/C,CAAC"}

package/dist/esm/forthic/interpreter.js

@@ -12,6 +12,7 @@ import { BooleanModule } from "./modules/standard/boolean_module.js";
 import { JsonModule } from "./modules/standard/json_module.js";
 import { DateTimeModule } from "./modules/standard/datetime_module.js";
 import { serializeValue, deserializeValue, serializeStack, deserializeStack } from "../websocket/serializer.js";
+import { pathSegmentForKey } from "../common/type_utils.js";
 /**
  * StartModuleWord - Handles module creation and switching
  *
@@ -894,13 +895,13 @@ export function dup_interpreter(interp) {
  */
 export function export_state(interp) {
     const internal = interp;
-    // Serialize the stack
-    const stack = serializeStack(internal.stack.get_items());
+    // Serialize the stack (annotate path so errors point at the offending stack entry)
+    const stack = serializeStack(internal.stack.get_items(), 'stack:');
     // Serialize variables
     const variables = {};
     const appModule = internal.app_module;
     for (const [name, variable] of Object.entries(appModule.variables)) {
-        variables[name] = serializeValue(variable.get_value());
+        variables[name] = serializeValue(variable.get_value(), `var:${pathSegmentForKey(name)}`);
     }
     // Collect source text from user-defined words
     const word_definitions = [];