@forthix/forthic 0.10.0 → 0.12.0

package/dist/esm/grpc/runtime_manager.js.map

@@ -1 +1 @@
-{"version":3,"file":"runtime_manager.js","sourceRoot":"","sources":["../../../src/grpc/runtime_manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC;;GAEG;AACH,MAAM,OAAO,cAAc;IACjB,MAAM,CAAC,QAAQ,GAA0B,IAAI,CAAC;IAC9C,OAAO,CAA0B;IAEzC;QACE,IAAI,CAAC,OAAO,GAAG,IAAI,GAAG,EAAE,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,WAAW;QAChB,IAAI,CAAC,cAAc,CAAC,QAAQ,EAAE,CAAC;YAC7B,cAAc,CAAC,QAAQ,GAAG,IAAI,cAAc,EAAE,CAAC;QACjD,CAAC;QACD,OAAO,cAAc,CAAC,QAAQ,CAAC;IACjC,CAAC;IAED;;;;;;;OAOG;IACH,cAAc,CAAC,WAAmB,EAAE,OAAe;QACjD,sCAAsC;QACtC,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,OAAO,CAAC,CAAC;QAEvC,cAAc;QACd,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;QAEtC,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;;;OAKG;IACH,cAAc,CAAC,WAAmB,EAAE,MAAkB;QACpD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IACxC,CAAC;IAED;;;;;OAKG;IACH,SAAS,CAAC,WAAmB;QAC3B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IACvC,CAAC;IAED;;;;;OAKG;IACH,SAAS,CAAC,WAAmB;QAC3B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IACvC,CAAC;IAED;;;;OAIG;IACH,qBAAqB;QACnB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IACzC,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,oBAAoB;QACpB,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;YAC3C,MAAM,CAAC,KAAK,EAAE,CAAC;QACjB,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,KAAK;QACV,IAAI,cAAc,CAAC,QAAQ,EAAE,CAAC;YAC5B,cAAc,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC;YACnC,cAAc,CAAC,QAAQ,GAAG,IAAI,CAAC;QACjC,CAAC;IACH,CAAC"}
+{"version":3,"file":"runtime_manager.js","sourceRoot":"","sources":["../../../src/grpc/runtime_manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC;;GAEG;AACH,MAAM,OAAO,cAAc;IACjB,MAAM,CAAC,QAAQ,GAA0B,IAAI,CAAC;IAC9C,OAAO,CAA6B;IAE5C;QACE,IAAI,CAAC,OAAO,GAAG,IAAI,GAAG,EAAE,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,WAAW;QAChB,IAAI,CAAC,cAAc,CAAC,QAAQ,EAAE,CAAC;YAC7B,cAAc,CAAC,QAAQ,GAAG,IAAI,cAAc,EAAE,CAAC;QACjD,CAAC;QACD,OAAO,cAAc,CAAC,QAAQ,CAAC;IACjC,CAAC;IAED;;;;;;;OAOG;IACH,cAAc,CAAC,WAAmB,EAAE,OAAe;QACjD,sCAAsC;QACtC,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,OAAO,CAAC,CAAC;QAEvC,cAAc;QACd,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;QAEtC,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;;;OAKG;IACH,cAAc,CAAC,WAAmB,EAAE,MAAqB;QACvD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IACxC,CAAC;IAED;;;;;OAKG;IACH,SAAS,CAAC,WAAmB;QAC3B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IACvC,CAAC;IAED;;;;;OAKG;IACH,SAAS,CAAC,WAAmB;QAC3B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IACvC,CAAC;IAED;;;;OAIG;IACH,qBAAqB;QACnB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IACzC,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,oBAAoB;QACpB,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;YAC3C,MAAM,CAAC,KAAK,EAAE,CAAC;QACjB,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,KAAK;QACV,IAAI,cAAc,CAAC,QAAQ,EAAE,CAAC;YAC5B,cAAc,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC;YACnC,cAAc,CAAC,QAAQ,GAAG,IAAI,CAAC;QACjC,CAAC;IACH,CAAC"}

package/dist/esm/grpc/serializer.d.ts

@@ -37,9 +37,9 @@ interface ZonedDateTimeValue {
  * Serialize a JavaScript value to a StackValue protobuf message
  * Uses shared type detection and maps to protobuf format
  */
-export declare function serializeValue(value: any): StackValue;
+export declare function serializeValue(value: any, path?: string): StackValue;
 /**
  * Deserialize a StackValue protobuf message to a JavaScript value
  */
-export declare function deserializeValue(stackValue: StackValue): any;
+export declare function deserializeValue(stackValue: StackValue, path?: string): any;
 export {};

package/dist/esm/grpc/serializer.js

@@ -3,13 +3,13 @@
  * Converts JavaScript values to/from protobuf StackValue format
  * Uses shared type detection from common/type_utils
  */
-import { getForthicType } from "../common/type_utils.js";
+import { getForthicType, pathSegmentForKey } from "../common/type_utils.js";
 /**
  * Serialize a JavaScript value to a StackValue protobuf message
  * Uses shared type detection and maps to protobuf format
  */
-export function serializeValue(value) {
-    const type = getForthicType(value);
+export function serializeValue(value, path = '') {
+    const type = getForthicType(value, path);
     switch (type) {
         case 'null':
             return { null_value: {} };
@@ -24,15 +24,16 @@ export function serializeValue(value) {
         case 'array':
             return {
                 array_value: {
-                    items: value.map((item) => serializeValue(item)),
+                    items: 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}${pathSegmentForKey(key)}`);
             }
             return { record_value: { fields } };
+        }
         case 'instant':
             return {
                 instant_value: {
@@ -53,13 +54,13 @@ export function serializeValue(value) {
                 },
             };
         default:
-            throw new Error(`Unsupported Forthic type: ${type}`);
+            throw new Error(`Unsupported Forthic type: ${type}${path ? ` at path: ${path}` : ''}`);
     }
 }
 /**
  * Deserialize a StackValue protobuf message to a JavaScript value
  */
-export function deserializeValue(stackValue) {
+export function deserializeValue(stackValue, path = '') {
     if ('int_value' in stackValue) {
         return stackValue.int_value;
     }
@@ -86,15 +87,15 @@ export function deserializeValue(stackValue) {
         return Temporal.ZonedDateTime.from(stackValue.zoned_datetime_value.iso8601);
     }
     if ('array_value' in stackValue && stackValue.array_value) {
-        return stackValue.array_value.items.map((item) => deserializeValue(item));
+        return stackValue.array_value.items.map((item, i) => deserializeValue(item, `${path}[${i}]`));
     }
     if ('record_value' in stackValue && stackValue.record_value) {
         const result = {};
         for (const [key, val] of Object.entries(stackValue.record_value.fields)) {
-            result[key] = deserializeValue(val);
+            result[key] = deserializeValue(val, `${path}${pathSegmentForKey(key)}`);
         }
         return result;
     }
-    throw new Error('Unknown stack value type');
+    throw new Error(`Unknown stack value type${path ? ` at path: ${path}` : ''}`);
 }
 //# sourceMappingURL=serializer.js.map

package/dist/esm/grpc/serializer.js.map

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

package/dist/esm/jsonrpc/browser-stub.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Browser stub for the JSON-RPC server. The JsonRpcClient itself is
+ * fetch-based and works in browsers, but the server depends on Node's
+ * `http` module and is unavailable in browser bundles.
+ */
+export declare function startJsonRpcServer(): never;
+export { JsonRpcClient } from './client.js';
+export { JsonRpcErrorCode } from './errors.js';

package/dist/esm/jsonrpc/browser-stub.js

@@ -0,0 +1,12 @@
+/**
+ * Browser stub for the JSON-RPC server. The JsonRpcClient itself is
+ * fetch-based and works in browsers, but the server depends on Node's
+ * `http` module and is unavailable in browser bundles.
+ */
+const BROWSER_SERVER_ERROR = 'startJsonRpcServer is only available in Node.js environments.';
+export function startJsonRpcServer() {
+    throw new Error(BROWSER_SERVER_ERROR);
+}
+export { JsonRpcClient } from './client.js';
+export { JsonRpcErrorCode } from './errors.js';
+//# sourceMappingURL=browser-stub.js.map

package/dist/esm/jsonrpc/browser-stub.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-stub.js","sourceRoot":"","sources":["../../../src/jsonrpc/browser-stub.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,oBAAoB,GACxB,+DAA+D,CAAC;AAElE,MAAM,UAAU,kBAAkB;IAChC,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;AACxC,CAAC;AAED,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC"}

package/dist/esm/jsonrpc/client.d.ts

@@ -0,0 +1,31 @@
+import type { RuntimeClient, ModuleSummary, GetModuleInfoResponse } from '../common/runtime_client.js';
+export type { ModuleSummary, GetModuleInfoResponse, WordInfo } from '../common/runtime_client.js';
+type FetchLike = (url: string, init?: any) => Promise<{
+    ok: boolean;
+    status: number;
+    statusText: string;
+    text(): Promise<string>;
+}>;
+export interface JsonRpcClientOptions {
+    /** Custom fetch implementation; defaults to global fetch. */
+    fetchImpl?: FetchLike;
+    /** Optional path; defaults to /rpc. */
+    path?: string;
+}
+export declare class JsonRpcClient implements RuntimeClient {
+    private endpoint;
+    private fetchImpl;
+    private nextId;
+    /**
+     * @param address - "host:port" or full URL. "host:port" is rewritten as
+     *                  `http://host:port<path>`. A full URL is used as-is and
+     *                  the `path` option is ignored.
+     */
+    constructor(address?: string, options?: JsonRpcClientOptions);
+    executeWord(wordName: string, stack: any[]): Promise<any[]>;
+    executeSequence(wordNames: string[], stack: any[]): Promise<any[]>;
+    listModules(): Promise<ModuleSummary[]>;
+    getModuleInfo(moduleName: string): Promise<GetModuleInfoResponse>;
+    close(): void;
+    private call;
+}

package/dist/esm/jsonrpc/client.js

@@ -0,0 +1,94 @@
+/**
+ * JSON-RPC 2.0 client for Forthic — speaks the same surface as GrpcClient
+ * (executeWord / executeSequence / listModules / getModuleInfo) so it can
+ * be used interchangeably via the RuntimeClient interface.
+ *
+ * Uses the global `fetch` (Node ≥18). For older Node, inject your own
+ * fetch via the constructor's `fetchImpl` option.
+ */
+import { serializeValue, deserializeValue } from '../grpc/serializer.js';
+import { RemoteRuntimeError, parseErrorInfo } from '../grpc/errors.js';
+import { JsonRpcErrorCode } from './errors.js';
+export class JsonRpcClient {
+    endpoint;
+    fetchImpl;
+    nextId = 1;
+    /**
+     * @param address - "host:port" or full URL. "host:port" is rewritten as
+     *                  `http://host:port<path>`. A full URL is used as-is and
+     *                  the `path` option is ignored.
+     */
+    constructor(address = 'localhost:8765', options = {}) {
+        const path = options.path ?? '/rpc';
+        if (/^https?:\/\//i.test(address)) {
+            this.endpoint = address;
+        }
+        else {
+            this.endpoint = `http://${address}${path}`;
+        }
+        const fetchImpl = options.fetchImpl ?? globalThis.fetch;
+        if (typeof fetchImpl !== 'function') {
+            throw new Error('JsonRpcClient requires a fetch implementation. Use Node ≥18 or pass options.fetchImpl.');
+        }
+        this.fetchImpl = fetchImpl;
+    }
+    async executeWord(wordName, stack) {
+        const result = await this.call('executeWord', {
+            word_name: wordName,
+            stack: stack.map((v) => serializeValue(v)),
+        });
+        return (result.result_stack ?? []).map((v) => deserializeValue(v));
+    }
+    async executeSequence(wordNames, stack) {
+        const result = await this.call('executeSequence', {
+            word_names: wordNames,
+            stack: stack.map((v) => serializeValue(v)),
+        });
+        return (result.result_stack ?? []).map((v) => deserializeValue(v));
+    }
+    async listModules() {
+        const result = await this.call('listModules', {});
+        return result.modules ?? [];
+    }
+    async getModuleInfo(moduleName) {
+        return await this.call('getModuleInfo', { module_name: moduleName });
+    }
+    close() {
+        // Stateless over HTTP — nothing to close.
+    }
+    async call(method, params) {
+        const id = this.nextId++;
+        const body = JSON.stringify({ jsonrpc: '2.0', id, method, params });
+        let response;
+        try {
+            response = await this.fetchImpl(this.endpoint, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body,
+            });
+        }
+        catch (err) {
+            throw new Error(`JSON-RPC transport error: ${err?.message ?? String(err)}`);
+        }
+        const text = await response.text();
+        if (!response.ok && !text) {
+            throw new Error(`JSON-RPC HTTP ${response.status}: ${response.statusText}`);
+        }
+        let envelope;
+        try {
+            envelope = JSON.parse(text);
+        }
+        catch (err) {
+            throw new Error(`JSON-RPC parse error (HTTP ${response.status}): ${err?.message ?? String(err)}`);
+        }
+        if (envelope.error) {
+            const { code, message, data } = envelope.error;
+            if (code === JsonRpcErrorCode.RuntimeError && data && typeof data === 'object') {
+                throw new RemoteRuntimeError(parseErrorInfo(data));
+            }
+            throw new Error(`JSON-RPC error ${code}: ${message}`);
+        }
+        return envelope.result;
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/esm/jsonrpc/client.js.map

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

package/dist/esm/jsonrpc/errors.d.ts

@@ -0,0 +1,18 @@
+/**
+ * JSON-RPC error types — reuses gRPC's RemoteRuntimeError + parseErrorInfo
+ * for the structured `data` payload of code -32000 responses.
+ */
+export { RemoteRuntimeError, parseErrorInfo, type RemoteErrorInfo, } from '../grpc/errors.js';
+/** JSON-RPC standard error codes plus our custom server-defined codes. */
+export declare const JsonRpcErrorCode: {
+    readonly ParseError: -32700;
+    readonly InvalidRequest: -32600;
+    readonly MethodNotFound: -32601;
+    readonly InvalidParams: -32602;
+    readonly InternalError: -32603;
+    /** Forthic runtime error — `data` carries the full ErrorInfo. */
+    readonly RuntimeError: -32000;
+    /** Unknown module name passed to getModuleInfo. */
+    readonly ModuleNotFound: -32001;
+};
+export type JsonRpcErrorCodeValue = (typeof JsonRpcErrorCode)[keyof typeof JsonRpcErrorCode];

package/dist/esm/jsonrpc/errors.js

@@ -0,0 +1,18 @@
+/**
+ * JSON-RPC error types — reuses gRPC's RemoteRuntimeError + parseErrorInfo
+ * for the structured `data` payload of code -32000 responses.
+ */
+export { RemoteRuntimeError, parseErrorInfo, } from '../grpc/errors.js';
+/** JSON-RPC standard error codes plus our custom server-defined codes. */
+export const JsonRpcErrorCode = {
+    ParseError: -32700,
+    InvalidRequest: -32600,
+    MethodNotFound: -32601,
+    InvalidParams: -32602,
+    InternalError: -32603,
+    /** Forthic runtime error — `data` carries the full ErrorInfo. */
+    RuntimeError: -32000,
+    /** Unknown module name passed to getModuleInfo. */
+    ModuleNotFound: -32001,
+};
+//# sourceMappingURL=errors.js.map

package/dist/esm/jsonrpc/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/jsonrpc/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EACL,kBAAkB,EAClB,cAAc,GAEf,MAAM,mBAAmB,CAAC;AAE3B,0EAA0E;AAC1E,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,UAAU,EAAE,CAAC,KAAK;IAClB,cAAc,EAAE,CAAC,KAAK;IACtB,cAAc,EAAE,CAAC,KAAK;IACtB,aAAa,EAAE,CAAC,KAAK;IACrB,aAAa,EAAE,CAAC,KAAK;IACrB,iEAAiE;IACjE,YAAY,EAAE,CAAC,KAAK;IACpB,mDAAmD;IACnD,cAAc,EAAE,CAAC,KAAK;CACd,CAAC"}

package/dist/esm/jsonrpc/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * JSON-RPC module for Node.js multi-runtime execution.
+ * Server uses Node's built-in http; client uses global fetch (Node ≥18).
+ *
+ * Mirrors @forthix/forthic/grpc surface so RuntimeManager / RemoteModule /
+ * RemoteWord work transparently against either transport.
+ */
+export { JsonRpcClient } from './client.js';
+export { serve as startJsonRpcServer } from './server.js';
+export { JsonRpcErrorCode } from './errors.js';
+export { RemoteRuntimeError } from '../grpc/errors.js';
+export { RemoteModule } from '../grpc/remote_module.js';
+export { RuntimeManager } from '../grpc/runtime_manager.js';
+export { ConfigLoader } from '../grpc/config_loader.js';
+export type { ModuleSummary, WordInfo, GetModuleInfoResponse, RuntimeClient, } from '../common/runtime_client.js';
+export type { RuntimeConfig, ForthicRuntimesConfig, ConnectionSettings, RuntimeTransport, } from '../grpc/config_loader.js';

package/dist/esm/jsonrpc/index.js

@@ -0,0 +1,16 @@
+/**
+ * JSON-RPC module for Node.js multi-runtime execution.
+ * Server uses Node's built-in http; client uses global fetch (Node ≥18).
+ *
+ * Mirrors @forthix/forthic/grpc surface so RuntimeManager / RemoteModule /
+ * RemoteWord work transparently against either transport.
+ */
+export { JsonRpcClient } from './client.js';
+export { serve as startJsonRpcServer } from './server.js';
+export { JsonRpcErrorCode } from './errors.js';
+export { RemoteRuntimeError } from '../grpc/errors.js';
+// Reuse existing pieces: they already accept any RuntimeClient implementation.
+export { RemoteModule } from '../grpc/remote_module.js';
+export { RuntimeManager } from '../grpc/runtime_manager.js';
+export { ConfigLoader } from '../grpc/config_loader.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/jsonrpc/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/jsonrpc/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,KAAK,IAAI,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEvD,+EAA+E;AAC/E,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/esm/jsonrpc/serializer.d.ts

@@ -0,0 +1,8 @@
+/**
+ * JSON-RPC serializer — re-exports the gRPC serializer.
+ *
+ * The StackValue tagged-union shape (`{ int_value }`, `{ string_value }`,
+ * `{ array_value: { items: [...] } }`, etc.) is JSON-clean, so the same
+ * (serializeValue, deserializeValue) functions work for both transports.
+ */
+export { serializeValue, deserializeValue } from '../grpc/serializer.js';

package/dist/esm/jsonrpc/serializer.js

@@ -0,0 +1,9 @@
+/**
+ * JSON-RPC serializer — re-exports the gRPC serializer.
+ *
+ * The StackValue tagged-union shape (`{ int_value }`, `{ string_value }`,
+ * `{ array_value: { items: [...] } }`, etc.) is JSON-clean, so the same
+ * (serializeValue, deserializeValue) functions work for both transports.
+ */
+export { serializeValue, deserializeValue } from '../grpc/serializer.js';
+//# sourceMappingURL=serializer.js.map

package/dist/esm/jsonrpc/serializer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serializer.js","sourceRoot":"","sources":["../../../src/jsonrpc/serializer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/esm/jsonrpc/server.d.ts

@@ -0,0 +1,15 @@
+/**
+ * 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.
+ */
+import * as http from 'http';
+export declare function serve(port?: number): Promise<http.Server>;
+export declare function main(): Promise<void>;