@truefoundry/trueforge-core 0.0.0 → 0.1.0

package/dist/request-reply/executor.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/request-reply/executor.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\nimport type { RedisClientType } from 'redis';\nimport type { Logger } from 'winston';\nimport z from 'zod';\nimport { extractErrorLogFields } from '../core/util/errorLogFields';\nimport { ReplyError } from './errors';\nimport type { JSONReply, RequestHandler } from './types';\nimport { publishedRequestSchema } from './types';\nimport { heartbeatKey, requestChannel } from './utils';\n\nexport interface RunExecutorOptions {\n  /** How often to refresh the heartbeat key (ms). */\n  heartbeatIntervalMs: number;\n  /** TTL for the reply value so abandoned keys are reclaimed (ms). */\n  replyTtlMs: number;\n}\n\nconst DEFAULT_HEARTBEAT_INTERVAL_MS = 5_000;\nconst DEFAULT_REPLY_TTL_MS = 120_000;\n\nfunction resolveRunExecutorOptions(options: Partial<RunExecutorOptions> | undefined): RunExecutorOptions {\n  return {\n    heartbeatIntervalMs: options?.heartbeatIntervalMs ?? DEFAULT_HEARTBEAT_INTERVAL_MS,\n    replyTtlMs: options?.replyTtlMs ?? DEFAULT_REPLY_TTL_MS,\n  };\n}\n\n/** Observability hook for subscriber errors, failed SUBSCRIBEs, and malformed messages. */\nexport type RequestReplyErrorHandler = (err: Error, context: { executorId: string; channel: string }) => void;\n\n/**\n * Serving side of the request-reply transport: parses and validates each\n * published message, dispatches it to the request handler, writes the\n * JSONReply to the request's reply key, and refreshes the heartbeat key while\n * subscribed.\n *\n * Connection lifecycle stays with the caller: both clients are supplied\n * connected and are never closed here. `subscriberClient` is the connection to\n * SUBSCRIBE on — a `duplicate()` for standalone Redis, or the shared client\n * for Sentinel — and must have a reconnect strategy so a failed connect\n * self-heals (the executor re-subscribes on every `ready`).\n */\nexport class RequestReplyExecutor {\n  readonly executorId: string;\n  /** `rr:req:<executorId>` — the channel this executor subscribes to. */\n  readonly channel: string;\n  private readonly redis: RedisClientType;\n  private readonly subscriberClient: RedisClientType;\n  private readonly logger: Logger;\n  private readonly heartbeatIntervalMs: number;\n  private readonly heartbeatTtlMs: number;\n  private readonly replyTtlMs: number;\n  private readonly heartbeatKey: string;\n  private readonly requestHandler: RequestHandler;\n  private readonly onError: RequestReplyErrorHandler | undefined;\n  /** Stable reference so node-redis dedupes the listener across re-subscribes. */\n  private readonly subscribeListener = (message: string): void => {\n    this.onMessage(message);\n  };\n\n  private closed = false;\n  private initialized = false;\n  private runningRequests = new Map<string, Promise<void>>();\n  private heartbeatTimer: ReturnType<typeof setInterval> | null = null;\n\n  constructor({\n    executorId,\n    redis,\n    subscriberClient,\n    requestHandler,\n    onError,\n    logger,\n    options,\n  }: {\n    executorId: string;\n    /** Connected command client, used only for SET (reply + heartbeat). Caller owns its lifecycle. */\n    redis: RedisClientType;\n    /** Connected client to SUBSCRIBE on (duplicate or Sentinel). Caller owns its lifecycle. */\n    subscriberClient: RedisClientType;\n    requestHandler: RequestHandler;\n    onError?: RequestReplyErrorHandler | undefined;\n    logger: Logger;\n    options?: Partial<RunExecutorOptions> | undefined;\n  }) {\n    const { heartbeatIntervalMs, replyTtlMs } = resolveRunExecutorOptions(options);\n    this.executorId = executorId;\n    this.redis = redis;\n    this.subscriberClient = subscriberClient;\n    this.logger = logger;\n    this.replyTtlMs = replyTtlMs;\n    this.requestHandler = requestHandler;\n    this.onError = onError;\n    this.channel = requestChannel(executorId);\n    this.heartbeatKey = heartbeatKey(executorId);\n    this.heartbeatIntervalMs = heartbeatIntervalMs;\n    this.heartbeatTtlMs = Math.ceil(this.heartbeatIntervalMs * 1.5);\n  }\n\n  async init(): Promise<void> {\n    if (this.closed || this.initialized) {\n      return;\n    }\n    this.initialized = true;\n\n    this.subscriberClient.on('error', (err: Error) => {\n      this.logger.error('[RequestReplyExecutor] Subscriber error', {\n        executorId: this.executorId,\n        ...extractErrorLogFields(err),\n      });\n      this.onError?.(err, { executorId: this.executorId, channel: this.channel });\n      this.stopHeartbeat();\n    });\n    this.subscriberClient.on('end', () => {\n      this.logger.warn('[RequestReplyExecutor] Subscriber connection ended', { executorId: this.executorId });\n      this.stopHeartbeat();\n    });\n    // ready fires on the first connect and every reconnect; re-subscribing is\n    // safe because node-redis dedupes the stable listener.\n    this.subscriberClient.on('ready', () => {\n      void this.setupSubscriber();\n    });\n\n    // On stable connections we won't get another ready event — if the caller\n    // already connected the client, subscribe now.\n    if (this.subscriberClient.isReady) {\n      await this.setupSubscriber();\n    }\n  }\n\n  private async setupSubscriber(): Promise<void> {\n    if (this.closed) {\n      return;\n    }\n    try {\n      await this.subscriberClient.subscribe(this.channel, this.subscribeListener);\n      this.logger.info('[RequestReplyExecutor] Subscribed to request channel', { executorId: this.executorId });\n      this.stopHeartbeat();\n      this.startHeartbeat();\n    } catch (err) {\n      const error = err instanceof Error ? err : new Error(String(err), { cause: err });\n      this.logger.error('[RequestReplyExecutor] Error subscribing to request channel', {\n        executorId: this.executorId,\n        ...extractErrorLogFields(error),\n      });\n      this.onError?.(error, { executorId: this.executorId, channel: this.channel });\n      this.stopHeartbeat();\n    }\n  }\n\n  private async beat(): Promise<void> {\n    this.logger.debug('[RequestReplyExecutor] Beating heartbeat', { executorId: this.executorId });\n    try {\n      await this.redis.set(this.heartbeatKey, '1', { PX: this.heartbeatTtlMs });\n    } catch (err) {\n      this.logger.error('[RequestReplyExecutor] Heartbeat error', {\n        executorId: this.executorId,\n        ...extractErrorLogFields(err),\n      });\n    }\n  }\n\n  /** Heartbeat only while subscribed. Idempotent (restarts the timer). */\n  private startHeartbeat(): void {\n    if (this.closed) {\n      return;\n    }\n    this.logger.info('[RequestReplyExecutor] Starting heartbeat', { executorId: this.executorId });\n    this.stopHeartbeat();\n    void this.beat();\n    this.heartbeatTimer = setInterval(() => {\n      void this.beat();\n    }, this.heartbeatIntervalMs);\n  }\n\n  /** A stopped heartbeat makes callers fail fast with NoResponderError. */\n  private stopHeartbeat(): void {\n    if (this.heartbeatTimer) {\n      this.logger.info('[RequestReplyExecutor] Stopping heartbeat', { executorId: this.executorId });\n      clearInterval(this.heartbeatTimer);\n      this.heartbeatTimer = null;\n    }\n  }\n\n  private async processRequestFromMessage(message: string): Promise<void> {\n    let raw: unknown;\n    try {\n      raw = JSON.parse(message);\n    } catch (err) {\n      // Drop the request, this should never happen\n      this.logger.warn('[RequestReplyExecutor] Request message is not valid JSON', { executorId: this.executorId });\n      this.onError?.(\n        new Error(`Request message is not valid JSON for executorId: ${this.executorId}`, {\n          cause: err,\n        }),\n        {\n          executorId: this.executorId,\n          channel: this.channel,\n        },\n      );\n      return;\n    }\n\n    const parsedRequest = publishedRequestSchema.safeParse(raw);\n    if (!parsedRequest.success) {\n      // Drop the request, this should never happen\n      const zodError = z.treeifyError(parsedRequest.error);\n      this.logger.warn('[RequestReplyExecutor] Invalid request message shape', {\n        executorId: this.executorId,\n        zod: zodError,\n      });\n      this.onError?.(\n        new Error(\n          `Invalid request message shape for executorId: ${this.executorId}, error: ${JSON.stringify(zodError)}`,\n          { cause: parsedRequest.error },\n        ),\n        { executorId: this.executorId, channel: this.channel },\n      );\n      return;\n    }\n\n    const { replyKey, path, body, headers } = parsedRequest.data;\n    let replyPayload: JSONReply;\n    try {\n      replyPayload = await this.requestHandler(path, { body, headers });\n    } catch (err) {\n      // ReplyError lets handlers choose the reply status; any other throw is an unexpected 500.\n      if (err instanceof ReplyError) {\n        replyPayload = { status: err.status, headers: {}, body: { message: err.message } };\n      } else {\n        const message = err instanceof Error ? err.message : String(err);\n        replyPayload = { status: 500, headers: {}, body: { message } };\n      }\n    }\n\n    try {\n      await this.redis.set(replyKey, JSON.stringify(replyPayload), { PX: this.replyTtlMs });\n    } catch (err) {\n      this.logger.error('[RequestReplyExecutor] Request processing failed', {\n        executorId: this.executorId,\n        replyKey,\n        ...extractErrorLogFields(err),\n      });\n    }\n  }\n\n  /** One raw pub/sub payload. Never throws. */\n  private onMessage(message: string): void {\n    this.logger.debug('[RequestReplyExecutor] Received message', { executorId: this.executorId, message });\n    if (!message) {\n      return;\n    }\n    if (this.closed) {\n      this.logger.warn('[RequestReplyExecutor] Received message after executor is closed', {\n        executorId: this.executorId,\n        message,\n      });\n      return;\n    }\n    const pid = randomUUID();\n    const requestPromise = this.processRequestFromMessage(message).finally(() => {\n      this.runningRequests.delete(pid);\n    });\n    this.runningRequests.set(pid, requestPromise);\n  }\n\n  // This function should never throw!\n  // Stops intake: unsubscribe from the channel and stop the heartbeat. Never\n  // closes the clients — the caller owns their lifecycle.\n  async close(): Promise<void> {\n    if (this.closed) {\n      return;\n    }\n    this.logger.info('[RequestReplyExecutor] Closing', { executorId: this.executorId });\n    this.closed = true;\n    try {\n      await this.subscriberClient.unsubscribe(this.channel);\n    } catch {\n      // ignore: connection may already be closed\n    }\n    this.stopHeartbeat();\n  }\n\n  // This function should never throw!\n  // This is called during graceful shutdown\n  async drain(): Promise<void> {\n    await this.close();\n    await Promise.allSettled(Array.from(this.runningRequests.values()));\n  }\n}\n"],"mappings":"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","names":["message"]}

package/dist/request-reply/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Redis request-reply transport for executor peering: route a command to the
+ * replica addressed by a plain `executorId`. Hosts own the Redis connection
+ * (inject the node-redis client) and their own id grammar — how an executor
+ * id is embedded in / parsed out of resource ids never enters this module.
+ */
+export { redisRequest } from './client';
+export type { SendRequestOptions } from './client';
+export { NoResponderError, ReplyError, RequestTimeoutError } from './errors';
+export { RequestReplyExecutor } from './executor';
+export type { RequestReplyErrorHandler, RunExecutorOptions } from './executor';
+export { RequestReplyRouter } from './router';
+export type { RouteHandler } from './router';
+export { jsonReplySchema } from './types';
+export type { JSONReply, JSONValue, RequestEnvelope, RequestHandler } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/request-reply/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/request-reply/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,YAAY,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAC7E,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAClD,YAAY,EAAE,wBAAwB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAC/E,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAC9C,YAAY,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC1C,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC"}

package/dist/request-reply/index.js

@@ -0,0 +1,47 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/request-reply/index.ts
+var request_reply_exports = {};
+__export(request_reply_exports, {
+  NoResponderError: () => import_errors.NoResponderError,
+  ReplyError: () => import_errors.ReplyError,
+  RequestReplyExecutor: () => import_executor.RequestReplyExecutor,
+  RequestReplyRouter: () => import_router.RequestReplyRouter,
+  RequestTimeoutError: () => import_errors.RequestTimeoutError,
+  jsonReplySchema: () => import_types.jsonReplySchema,
+  redisRequest: () => import_client.redisRequest
+});
+module.exports = __toCommonJS(request_reply_exports);
+var import_client = require("./client.js");
+var import_errors = require("./errors.js");
+var import_executor = require("./executor.js");
+var import_router = require("./router.js");
+var import_types = require("./types.js");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  NoResponderError,
+  ReplyError,
+  RequestReplyExecutor,
+  RequestReplyRouter,
+  RequestTimeoutError,
+  jsonReplySchema,
+  redisRequest
+});
+//# sourceMappingURL=index.js.map

package/dist/request-reply/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/request-reply/index.ts"],"sourcesContent":["/**\n * Redis request-reply transport for executor peering: route a command to the\n * replica addressed by a plain `executorId`. Hosts own the Redis connection\n * (inject the node-redis client) and their own id grammar — how an executor\n * id is embedded in / parsed out of resource ids never enters this module.\n */\n\nexport { redisRequest } from './client';\nexport type { SendRequestOptions } from './client';\nexport { NoResponderError, ReplyError, RequestTimeoutError } from './errors';\nexport { RequestReplyExecutor } from './executor';\nexport type { RequestReplyErrorHandler, RunExecutorOptions } from './executor';\nexport { RequestReplyRouter } from './router';\nexport type { RouteHandler } from './router';\nexport { jsonReplySchema } from './types';\nexport type { JSONReply, JSONValue, RequestEnvelope, RequestHandler } from './types';\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAOA,oBAA6B;AAE7B,oBAAkE;AAClE,sBAAqC;AAErC,oBAAmC;AAEnC,mBAAgC;","names":[]}

package/dist/request-reply/index.mjs

@@ -0,0 +1,16 @@
+// src/request-reply/index.ts
+import { redisRequest } from "./client.mjs";
+import { NoResponderError, ReplyError, RequestTimeoutError } from "./errors.mjs";
+import { RequestReplyExecutor } from "./executor.mjs";
+import { RequestReplyRouter } from "./router.mjs";
+import { jsonReplySchema } from "./types.mjs";
+export {
+  NoResponderError,
+  ReplyError,
+  RequestReplyExecutor,
+  RequestReplyRouter,
+  RequestTimeoutError,
+  jsonReplySchema,
+  redisRequest
+};
+//# sourceMappingURL=index.mjs.map

package/dist/request-reply/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/request-reply/index.ts"],"sourcesContent":["/**\n * Redis request-reply transport for executor peering: route a command to the\n * replica addressed by a plain `executorId`. Hosts own the Redis connection\n * (inject the node-redis client) and their own id grammar — how an executor\n * id is embedded in / parsed out of resource ids never enters this module.\n */\n\nexport { redisRequest } from './client';\nexport type { SendRequestOptions } from './client';\nexport { NoResponderError, ReplyError, RequestTimeoutError } from './errors';\nexport { RequestReplyExecutor } from './executor';\nexport type { RequestReplyErrorHandler, RunExecutorOptions } from './executor';\nexport { RequestReplyRouter } from './router';\nexport type { RouteHandler } from './router';\nexport { jsonReplySchema } from './types';\nexport type { JSONReply, JSONValue, RequestEnvelope, RequestHandler } from './types';\n"],"mappings":";AAOA,SAAS,oBAAoB;AAE7B,SAAS,kBAAkB,YAAY,2BAA2B;AAClE,SAAS,4BAA4B;AAErC,SAAS,0BAA0B;AAEnC,SAAS,uBAAuB;","names":[]}

package/dist/request-reply/router.d.ts

@@ -0,0 +1,20 @@
+import type { JSONReply, RequestEnvelope, RequestHandler } from './types';
+/**
+ * Handlers receive the wire body as unvalidated JSON and must validate it
+ * themselves (the payload crosses process boundaries).
+ */
+export type RouteHandler = (request: RequestEnvelope) => Promise<JSONReply>;
+/**
+ * In-process dispatch table keyed by logical path (e.g. `sessions/cancel`).
+ * The host creates one at boot and passes `createRequestHandler()` to the
+ * executor.
+ */
+export declare class RequestReplyRouter {
+    private readonly routes;
+    /** Throws if the path is already registered. */
+    registerRoute(path: string, fn: RouteHandler): void;
+    dispatchRoute(path: string, request: RequestEnvelope): Promise<JSONReply>;
+    /** Returns the `requestHandler` callback the executor consumes. */
+    createRequestHandler(): RequestHandler;
+}
+//# sourceMappingURL=router.d.ts.map

package/dist/request-reply/router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../../src/request-reply/router.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE1E;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,EAAE,eAAe,KAAK,OAAO,CAAC,SAAS,CAAC,CAAC;AAE5E;;;;GAIG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmC;IAE1D,gDAAgD;IAChD,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,YAAY,GAAG,IAAI,CAQlD;IAEK,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,SAAS,CAAC,CAO9E;IAED,mEAAmE;IACnE,oBAAoB,IAAI,cAAc,CAErC;CACF"}

package/dist/request-reply/router.js

@@ -0,0 +1,55 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/request-reply/router.ts
+var router_exports = {};
+__export(router_exports, {
+  RequestReplyRouter: () => RequestReplyRouter
+});
+module.exports = __toCommonJS(router_exports);
+var import_errors = require("./errors.js");
+var RequestReplyRouter = class {
+  routes = /* @__PURE__ */ new Map();
+  /** Throws if the path is already registered. */
+  registerRoute(path, fn) {
+    const alreadyAddedFn = this.routes.get(path);
+    if (alreadyAddedFn) {
+      throw new Error(
+        `[RequestReplyRouter] Route ${path} already registered for function ${alreadyAddedFn.name || "anonymous"}`
+      );
+    }
+    this.routes.set(path, fn);
+  }
+  async dispatchRoute(path, request) {
+    const fn = this.routes.get(path);
+    if (!fn) {
+      throw new import_errors.ReplyError(500, `Route ${path} not found for executor proxying`);
+    }
+    return fn(request);
+  }
+  /** Returns the `requestHandler` callback the executor consumes. */
+  createRequestHandler() {
+    return (path, request) => this.dispatchRoute(path, request);
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  RequestReplyRouter
+});
+//# sourceMappingURL=router.js.map

package/dist/request-reply/router.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/request-reply/router.ts"],"sourcesContent":["import { ReplyError } from './errors';\nimport type { JSONReply, RequestEnvelope, RequestHandler } from './types';\n\n/**\n * Handlers receive the wire body as unvalidated JSON and must validate it\n * themselves (the payload crosses process boundaries).\n */\nexport type RouteHandler = (request: RequestEnvelope) => Promise<JSONReply>;\n\n/**\n * In-process dispatch table keyed by logical path (e.g. `sessions/cancel`).\n * The host creates one at boot and passes `createRequestHandler()` to the\n * executor.\n */\nexport class RequestReplyRouter {\n  private readonly routes = new Map<string, RouteHandler>();\n\n  /** Throws if the path is already registered. */\n  registerRoute(path: string, fn: RouteHandler): void {\n    const alreadyAddedFn = this.routes.get(path);\n    if (alreadyAddedFn) {\n      throw new Error(\n        `[RequestReplyRouter] Route ${path} already registered for function ${alreadyAddedFn.name || 'anonymous'}`,\n      );\n    }\n    this.routes.set(path, fn);\n  }\n\n  async dispatchRoute(path: string, request: RequestEnvelope): Promise<JSONReply> {\n    const fn = this.routes.get(path);\n    if (!fn) {\n      // ReplyError carries an explicit status onto the wire (see executor error mapping).\n      throw new ReplyError(500, `Route ${path} not found for executor proxying`);\n    }\n    return fn(request);\n  }\n\n  /** Returns the `requestHandler` callback the executor consumes. */\n  createRequestHandler(): RequestHandler {\n    return (path, request) => this.dispatchRoute(path, request);\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,oBAA2B;AAcpB,IAAM,qBAAN,MAAyB;AAAA,EACb,SAAS,oBAAI,IAA0B;AAAA;AAAA,EAGxD,cAAc,MAAc,IAAwB;AAClD,UAAM,iBAAiB,KAAK,OAAO,IAAI,IAAI;AAC3C,QAAI,gBAAgB;AAClB,YAAM,IAAI;AAAA,QACR,8BAA8B,IAAI,oCAAoC,eAAe,QAAQ,WAAW;AAAA,MAC1G;AAAA,IACF;AACA,SAAK,OAAO,IAAI,MAAM,EAAE;AAAA,EAC1B;AAAA,EAEA,MAAM,cAAc,MAAc,SAA8C;AAC9E,UAAM,KAAK,KAAK,OAAO,IAAI,IAAI;AAC/B,QAAI,CAAC,IAAI;AAEP,YAAM,IAAI,yBAAW,KAAK,SAAS,IAAI,kCAAkC;AAAA,IAC3E;AACA,WAAO,GAAG,OAAO;AAAA,EACnB;AAAA;AAAA,EAGA,uBAAuC;AACrC,WAAO,CAAC,MAAM,YAAY,KAAK,cAAc,MAAM,OAAO;AAAA,EAC5D;AACF;","names":[]}

package/dist/request-reply/router.mjs

@@ -0,0 +1,30 @@
+// src/request-reply/router.ts
+import { ReplyError } from "./errors.mjs";
+var RequestReplyRouter = class {
+  routes = /* @__PURE__ */ new Map();
+  /** Throws if the path is already registered. */
+  registerRoute(path, fn) {
+    const alreadyAddedFn = this.routes.get(path);
+    if (alreadyAddedFn) {
+      throw new Error(
+        `[RequestReplyRouter] Route ${path} already registered for function ${alreadyAddedFn.name || "anonymous"}`
+      );
+    }
+    this.routes.set(path, fn);
+  }
+  async dispatchRoute(path, request) {
+    const fn = this.routes.get(path);
+    if (!fn) {
+      throw new ReplyError(500, `Route ${path} not found for executor proxying`);
+    }
+    return fn(request);
+  }
+  /** Returns the `requestHandler` callback the executor consumes. */
+  createRequestHandler() {
+    return (path, request) => this.dispatchRoute(path, request);
+  }
+};
+export {
+  RequestReplyRouter
+};
+//# sourceMappingURL=router.mjs.map

package/dist/request-reply/router.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/request-reply/router.ts"],"sourcesContent":["import { ReplyError } from './errors';\nimport type { JSONReply, RequestEnvelope, RequestHandler } from './types';\n\n/**\n * Handlers receive the wire body as unvalidated JSON and must validate it\n * themselves (the payload crosses process boundaries).\n */\nexport type RouteHandler = (request: RequestEnvelope) => Promise<JSONReply>;\n\n/**\n * In-process dispatch table keyed by logical path (e.g. `sessions/cancel`).\n * The host creates one at boot and passes `createRequestHandler()` to the\n * executor.\n */\nexport class RequestReplyRouter {\n  private readonly routes = new Map<string, RouteHandler>();\n\n  /** Throws if the path is already registered. */\n  registerRoute(path: string, fn: RouteHandler): void {\n    const alreadyAddedFn = this.routes.get(path);\n    if (alreadyAddedFn) {\n      throw new Error(\n        `[RequestReplyRouter] Route ${path} already registered for function ${alreadyAddedFn.name || 'anonymous'}`,\n      );\n    }\n    this.routes.set(path, fn);\n  }\n\n  async dispatchRoute(path: string, request: RequestEnvelope): Promise<JSONReply> {\n    const fn = this.routes.get(path);\n    if (!fn) {\n      // ReplyError carries an explicit status onto the wire (see executor error mapping).\n      throw new ReplyError(500, `Route ${path} not found for executor proxying`);\n    }\n    return fn(request);\n  }\n\n  /** Returns the `requestHandler` callback the executor consumes. */\n  createRequestHandler(): RequestHandler {\n    return (path, request) => this.dispatchRoute(path, request);\n  }\n}\n"],"mappings":";AAAA,SAAS,kBAAkB;AAcpB,IAAM,qBAAN,MAAyB;AAAA,EACb,SAAS,oBAAI,IAA0B;AAAA;AAAA,EAGxD,cAAc,MAAc,IAAwB;AAClD,UAAM,iBAAiB,KAAK,OAAO,IAAI,IAAI;AAC3C,QAAI,gBAAgB;AAClB,YAAM,IAAI;AAAA,QACR,8BAA8B,IAAI,oCAAoC,eAAe,QAAQ,WAAW;AAAA,MAC1G;AAAA,IACF;AACA,SAAK,OAAO,IAAI,MAAM,EAAE;AAAA,EAC1B;AAAA,EAEA,MAAM,cAAc,MAAc,SAA8C;AAC9E,UAAM,KAAK,KAAK,OAAO,IAAI,IAAI;AAC/B,QAAI,CAAC,IAAI;AAEP,YAAM,IAAI,WAAW,KAAK,SAAS,IAAI,kCAAkC;AAAA,IAC3E;AACA,WAAO,GAAG,OAAO;AAAA,EACnB;AAAA;AAAA,EAGA,uBAAuC;AACrC,WAAO,CAAC,MAAM,YAAY,KAAK,cAAc,MAAM,OAAO;AAAA,EAC5D;AACF;","names":[]}

package/dist/request-reply/types.d.ts

@@ -0,0 +1,25 @@
+import { z } from 'zod';
+export type JSONValue = string | number | boolean | null | JSONValue[] | {
+    [key: string]: JSONValue;
+};
+/** Request payload as seen by the caller of redisRequest and by route handlers. */
+export interface RequestEnvelope<T extends JSONValue = JSONValue> {
+    body: T;
+    headers?: Record<string, string> | undefined;
+}
+/** Body of a PUBLISH on the executor request channel (JSON string). */
+export declare const publishedRequestSchema: z.ZodObject<{
+    replyKey: z.ZodString;
+    path: z.ZodString;
+    body: z.ZodType<JSONValue, unknown, z.core.$ZodTypeInternals<JSONValue, unknown>>;
+    headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, z.core.$strip>;
+export type PublishedRequest = z.infer<typeof publishedRequestSchema>;
+export declare const jsonReplySchema: z.ZodObject<{
+    status: z.ZodNumber;
+    headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    body: z.ZodType<JSONValue, unknown, z.core.$ZodTypeInternals<JSONValue, unknown>>;
+}, z.core.$strip>;
+export type JSONReply = z.infer<typeof jsonReplySchema>;
+export type RequestHandler<T extends JSONValue = JSONValue> = (path: string, request: RequestEnvelope<T>) => Promise<JSONReply>;
+//# sourceMappingURL=types.d.ts.map

package/dist/request-reply/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/request-reply/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,EAAE,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AAetG,mFAAmF;AACnF,MAAM,WAAW,eAAe,CAAC,CAAC,SAAS,SAAS,GAAG,SAAS;IAC9D,IAAI,EAAE,CAAC,CAAC;IACR,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;CAC9C;AAED,uEAAuE;AACvE,eAAO,MAAM,sBAAsB;;;;;iBAKjC,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,eAAO,MAAM,eAAe;;;;iBAI1B,CAAC;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAExD,MAAM,MAAM,cAAc,CAAC,CAAC,SAAS,SAAS,GAAG,SAAS,IAAI,CAC5D,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,eAAe,CAAC,CAAC,CAAC,KACxB,OAAO,CAAC,SAAS,CAAC,CAAC"}

package/dist/request-reply/types.js

@@ -0,0 +1,54 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/request-reply/types.ts
+var types_exports = {};
+__export(types_exports, {
+  jsonReplySchema: () => jsonReplySchema,
+  publishedRequestSchema: () => publishedRequestSchema
+});
+module.exports = __toCommonJS(types_exports);
+var import_zod = require("zod");
+var jsonSchema = import_zod.z.lazy(() => {
+  return import_zod.z.union([
+    import_zod.z.string(),
+    import_zod.z.number(),
+    import_zod.z.boolean(),
+    import_zod.z.null(),
+    import_zod.z.array(jsonSchema),
+    import_zod.z.record(import_zod.z.string(), jsonSchema)
+  ]);
+});
+var publishedRequestSchema = import_zod.z.object({
+  replyKey: import_zod.z.string(),
+  path: import_zod.z.string(),
+  body: jsonSchema,
+  headers: import_zod.z.record(import_zod.z.string(), import_zod.z.string()).optional()
+});
+var jsonReplySchema = import_zod.z.object({
+  status: import_zod.z.number().int().min(200).max(599),
+  headers: import_zod.z.record(import_zod.z.string(), import_zod.z.string()).optional(),
+  body: jsonSchema
+});
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  jsonReplySchema,
+  publishedRequestSchema
+});
+//# sourceMappingURL=types.js.map

package/dist/request-reply/types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/request-reply/types.ts"],"sourcesContent":["import { z } from 'zod';\n\nexport type JSONValue = string | number | boolean | null | JSONValue[] | { [key: string]: JSONValue };\n\n// Recursive schema (https://zod.dev/api?id=json); z.lazy needs the explicit\n// annotation, so JSONValue cannot be derived with z.infer.\nconst jsonSchema: z.ZodType<JSONValue> = z.lazy(() => {\n  return z.union([\n    z.string(),\n    z.number(),\n    z.boolean(),\n    z.null(),\n    z.array(jsonSchema),\n    z.record(z.string(), jsonSchema),\n  ]);\n});\n\n/** Request payload as seen by the caller of redisRequest and by route handlers. */\nexport interface RequestEnvelope<T extends JSONValue = JSONValue> {\n  body: T;\n  headers?: Record<string, string> | undefined;\n}\n\n/** Body of a PUBLISH on the executor request channel (JSON string). */\nexport const publishedRequestSchema = z.object({\n  replyKey: z.string(),\n  path: z.string(),\n  body: jsonSchema,\n  headers: z.record(z.string(), z.string()).optional(),\n});\nexport type PublishedRequest = z.infer<typeof publishedRequestSchema>;\n\nexport const jsonReplySchema = z.object({\n  status: z.number().int().min(200).max(599),\n  headers: z.record(z.string(), z.string()).optional(),\n  body: jsonSchema,\n});\nexport type JSONReply = z.infer<typeof jsonReplySchema>;\n\nexport type RequestHandler<T extends JSONValue = JSONValue> = (\n  path: string,\n  request: RequestEnvelope<T>,\n) => Promise<JSONReply>;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,iBAAkB;AAMlB,IAAM,aAAmC,aAAE,KAAK,MAAM;AACpD,SAAO,aAAE,MAAM;AAAA,IACb,aAAE,OAAO;AAAA,IACT,aAAE,OAAO;AAAA,IACT,aAAE,QAAQ;AAAA,IACV,aAAE,KAAK;AAAA,IACP,aAAE,MAAM,UAAU;AAAA,IAClB,aAAE,OAAO,aAAE,OAAO,GAAG,UAAU;AAAA,EACjC,CAAC;AACH,CAAC;AASM,IAAM,yBAAyB,aAAE,OAAO;AAAA,EAC7C,UAAU,aAAE,OAAO;AAAA,EACnB,MAAM,aAAE,OAAO;AAAA,EACf,MAAM;AAAA,EACN,SAAS,aAAE,OAAO,aAAE,OAAO,GAAG,aAAE,OAAO,CAAC,EAAE,SAAS;AACrD,CAAC;AAGM,IAAM,kBAAkB,aAAE,OAAO;AAAA,EACtC,QAAQ,aAAE,OAAO,EAAE,IAAI,EAAE,IAAI,GAAG,EAAE,IAAI,GAAG;AAAA,EACzC,SAAS,aAAE,OAAO,aAAE,OAAO,GAAG,aAAE,OAAO,CAAC,EAAE,SAAS;AAAA,EACnD,MAAM;AACR,CAAC;","names":[]}

package/dist/request-reply/types.mjs

@@ -0,0 +1,28 @@
+// src/request-reply/types.ts
+import { z } from "zod";
+var jsonSchema = z.lazy(() => {
+  return z.union([
+    z.string(),
+    z.number(),
+    z.boolean(),
+    z.null(),
+    z.array(jsonSchema),
+    z.record(z.string(), jsonSchema)
+  ]);
+});
+var publishedRequestSchema = z.object({
+  replyKey: z.string(),
+  path: z.string(),
+  body: jsonSchema,
+  headers: z.record(z.string(), z.string()).optional()
+});
+var jsonReplySchema = z.object({
+  status: z.number().int().min(200).max(599),
+  headers: z.record(z.string(), z.string()).optional(),
+  body: jsonSchema
+});
+export {
+  jsonReplySchema,
+  publishedRequestSchema
+};
+//# sourceMappingURL=types.mjs.map

package/dist/request-reply/types.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/request-reply/types.ts"],"sourcesContent":["import { z } from 'zod';\n\nexport type JSONValue = string | number | boolean | null | JSONValue[] | { [key: string]: JSONValue };\n\n// Recursive schema (https://zod.dev/api?id=json); z.lazy needs the explicit\n// annotation, so JSONValue cannot be derived with z.infer.\nconst jsonSchema: z.ZodType<JSONValue> = z.lazy(() => {\n  return z.union([\n    z.string(),\n    z.number(),\n    z.boolean(),\n    z.null(),\n    z.array(jsonSchema),\n    z.record(z.string(), jsonSchema),\n  ]);\n});\n\n/** Request payload as seen by the caller of redisRequest and by route handlers. */\nexport interface RequestEnvelope<T extends JSONValue = JSONValue> {\n  body: T;\n  headers?: Record<string, string> | undefined;\n}\n\n/** Body of a PUBLISH on the executor request channel (JSON string). */\nexport const publishedRequestSchema = z.object({\n  replyKey: z.string(),\n  path: z.string(),\n  body: jsonSchema,\n  headers: z.record(z.string(), z.string()).optional(),\n});\nexport type PublishedRequest = z.infer<typeof publishedRequestSchema>;\n\nexport const jsonReplySchema = z.object({\n  status: z.number().int().min(200).max(599),\n  headers: z.record(z.string(), z.string()).optional(),\n  body: jsonSchema,\n});\nexport type JSONReply = z.infer<typeof jsonReplySchema>;\n\nexport type RequestHandler<T extends JSONValue = JSONValue> = (\n  path: string,\n  request: RequestEnvelope<T>,\n) => Promise<JSONReply>;\n"],"mappings":";AAAA,SAAS,SAAS;AAMlB,IAAM,aAAmC,EAAE,KAAK,MAAM;AACpD,SAAO,EAAE,MAAM;AAAA,IACb,EAAE,OAAO;AAAA,IACT,EAAE,OAAO;AAAA,IACT,EAAE,QAAQ;AAAA,IACV,EAAE,KAAK;AAAA,IACP,EAAE,MAAM,UAAU;AAAA,IAClB,EAAE,OAAO,EAAE,OAAO,GAAG,UAAU;AAAA,EACjC,CAAC;AACH,CAAC;AASM,IAAM,yBAAyB,EAAE,OAAO;AAAA,EAC7C,UAAU,EAAE,OAAO;AAAA,EACnB,MAAM,EAAE,OAAO;AAAA,EACf,MAAM;AAAA,EACN,SAAS,EAAE,OAAO,EAAE,OAAO,GAAG,EAAE,OAAO,CAAC,EAAE,SAAS;AACrD,CAAC;AAGM,IAAM,kBAAkB,EAAE,OAAO;AAAA,EACtC,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,GAAG,EAAE,IAAI,GAAG;AAAA,EACzC,SAAS,EAAE,OAAO,EAAE,OAAO,GAAG,EAAE,OAAO,CAAC,EAAE,SAAS;AAAA,EACnD,MAAM;AACR,CAAC;","names":[]}

package/dist/request-reply/utils.d.ts

@@ -0,0 +1,9 @@
+export declare function sleep(ms: number): Promise<void>;
+export declare const KEY_PREFIX = "rr";
+/** Liveness key an executor refreshes; callers check it before publishing. */
+export declare function heartbeatKey(executorId: string): string;
+/** Pub/sub channel: executors subscribe; callers publish the JSON request (see publishedRequestSchema). */
+export declare function requestChannel(executorId: string): string;
+/** Per-request key the executor SETs the JSONReply to; the caller polls it with GETDEL. */
+export declare function replyKey(requestId: string): string;
+//# sourceMappingURL=utils.d.ts.map

package/dist/request-reply/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/request-reply/utils.ts"],"names":[],"mappings":"AAAA,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C;AAED,eAAO,MAAM,UAAU,OAAO,CAAC;AAE/B,8EAA8E;AAC9E,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED,2GAA2G;AAC3G,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED,2FAA2F;AAC3F,wBAAgB,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAElD"}

package/dist/request-reply/utils.js

@@ -0,0 +1,51 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/request-reply/utils.ts
+var utils_exports = {};
+__export(utils_exports, {
+  KEY_PREFIX: () => KEY_PREFIX,
+  heartbeatKey: () => heartbeatKey,
+  replyKey: () => replyKey,
+  requestChannel: () => requestChannel,
+  sleep: () => sleep
+});
+module.exports = __toCommonJS(utils_exports);
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+var KEY_PREFIX = "rr";
+function heartbeatKey(executorId) {
+  return `${KEY_PREFIX}:hb:${executorId}`;
+}
+function requestChannel(executorId) {
+  return `${KEY_PREFIX}:req:${executorId}`;
+}
+function replyKey(requestId) {
+  return `${KEY_PREFIX}:reply:${requestId}`;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  KEY_PREFIX,
+  heartbeatKey,
+  replyKey,
+  requestChannel,
+  sleep
+});
+//# sourceMappingURL=utils.js.map

package/dist/request-reply/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/request-reply/utils.ts"],"sourcesContent":["export function sleep(ms: number): Promise<void> {\n  return new Promise(resolve => setTimeout(resolve, ms));\n}\n\nexport const KEY_PREFIX = 'rr';\n\n/** Liveness key an executor refreshes; callers check it before publishing. */\nexport function heartbeatKey(executorId: string): string {\n  return `${KEY_PREFIX}:hb:${executorId}`;\n}\n\n/** Pub/sub channel: executors subscribe; callers publish the JSON request (see publishedRequestSchema). */\nexport function requestChannel(executorId: string): string {\n  return `${KEY_PREFIX}:req:${executorId}`;\n}\n\n/** Per-request key the executor SETs the JSONReply to; the caller polls it with GETDEL. */\nexport function replyKey(requestId: string): string {\n  return `${KEY_PREFIX}:reply:${requestId}`;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAO,SAAS,MAAM,IAA2B;AAC/C,SAAO,IAAI,QAAQ,aAAW,WAAW,SAAS,EAAE,CAAC;AACvD;AAEO,IAAM,aAAa;AAGnB,SAAS,aAAa,YAA4B;AACvD,SAAO,GAAG,UAAU,OAAO,UAAU;AACvC;AAGO,SAAS,eAAe,YAA4B;AACzD,SAAO,GAAG,UAAU,QAAQ,UAAU;AACxC;AAGO,SAAS,SAAS,WAA2B;AAClD,SAAO,GAAG,UAAU,UAAU,SAAS;AACzC;","names":[]}

package/dist/request-reply/utils.mjs

@@ -0,0 +1,22 @@
+// src/request-reply/utils.ts
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+var KEY_PREFIX = "rr";
+function heartbeatKey(executorId) {
+  return `${KEY_PREFIX}:hb:${executorId}`;
+}
+function requestChannel(executorId) {
+  return `${KEY_PREFIX}:req:${executorId}`;
+}
+function replyKey(requestId) {
+  return `${KEY_PREFIX}:reply:${requestId}`;
+}
+export {
+  KEY_PREFIX,
+  heartbeatKey,
+  replyKey,
+  requestChannel,
+  sleep
+};
+//# sourceMappingURL=utils.mjs.map

package/dist/request-reply/utils.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/request-reply/utils.ts"],"sourcesContent":["export function sleep(ms: number): Promise<void> {\n  return new Promise(resolve => setTimeout(resolve, ms));\n}\n\nexport const KEY_PREFIX = 'rr';\n\n/** Liveness key an executor refreshes; callers check it before publishing. */\nexport function heartbeatKey(executorId: string): string {\n  return `${KEY_PREFIX}:hb:${executorId}`;\n}\n\n/** Pub/sub channel: executors subscribe; callers publish the JSON request (see publishedRequestSchema). */\nexport function requestChannel(executorId: string): string {\n  return `${KEY_PREFIX}:req:${executorId}`;\n}\n\n/** Per-request key the executor SETs the JSONReply to; the caller polls it with GETDEL. */\nexport function replyKey(requestId: string): string {\n  return `${KEY_PREFIX}:reply:${requestId}`;\n}\n"],"mappings":";AAAO,SAAS,MAAM,IAA2B;AAC/C,SAAO,IAAI,QAAQ,aAAW,WAAW,SAAS,EAAE,CAAC;AACvD;AAEO,IAAM,aAAa;AAGnB,SAAS,aAAa,YAA4B;AACvD,SAAO,GAAG,UAAU,OAAO,UAAU;AACvC;AAGO,SAAS,eAAe,YAA4B;AACzD,SAAO,GAAG,UAAU,QAAQ,UAAU;AACxC;AAGO,SAAS,SAAS,WAA2B;AAClD,SAAO,GAAG,UAAU,UAAU,SAAS;AACzC;","names":[]}

package/package.json

@@ -1,14 +1,135 @@
 {
   "name": "@truefoundry/trueforge-core",
-  "version": "0.0.0",
-  "description": "Placeholder so trusted publishing can be configured. Do not use.",
+  "version": "0.1.0",
+  "description": "TrueForge core library",
+  "author": "TrueFoundry",
   "license": "MIT",
-  "author": "TrueForge",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/truefoundry/trueforge.git"
+    "url": "git+https://github.com/truefoundry/trueforge.git",
+    "directory": "packages/harness"
+  },
+  "homepage": "https://github.com/truefoundry/trueforge/tree/main/packages/harness#readme",
+  "bugs": {
+    "url": "https://github.com/truefoundry/trueforge/issues"
   },
   "publishConfig": {
-    "access": "public"
+    "access": "public",
+    "provenance": false
+  },
+  "private": false,
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "trueforge-dev": {
+        "types": "./src/index.ts",
+        "default": "./src/index.ts"
+      },
+      "types": "./dist/index.d.ts",
+      "require": "./dist/index.js",
+      "default": "./dist/index.mjs"
+    },
+    "./core": {
+      "trueforge-dev": {
+        "types": "./src/core/index.ts",
+        "default": "./src/core/index.ts"
+      },
+      "types": "./dist/core/index.d.ts",
+      "require": "./dist/core/index.js",
+      "default": "./dist/core/index.mjs"
+    },
+    "./agent-session": {
+      "trueforge-dev": {
+        "types": "./src/agent-session/index.ts",
+        "default": "./src/agent-session/index.ts"
+      },
+      "types": "./dist/agent-session/index.d.ts",
+      "require": "./dist/agent-session/index.js",
+      "default": "./dist/agent-session/index.mjs"
+    },
+    "./request-reply": {
+      "trueforge-dev": {
+        "types": "./src/request-reply/index.ts",
+        "default": "./src/request-reply/index.ts"
+      },
+      "types": "./dist/request-reply/index.d.ts",
+      "require": "./dist/request-reply/index.js",
+      "default": "./dist/request-reply/index.mjs"
+    },
+    "./*.mjs": {
+      "types": "./dist/*.d.ts",
+      "default": "./dist/*.mjs"
+    },
+    "./*.js": {
+      "types": "./dist/*.d.ts",
+      "default": "./dist/*.js"
+    },
+    "./*": {
+      "trueforge-dev": {
+        "types": "./src/*.ts",
+        "default": "./src/*.ts"
+      },
+      "types": "./dist/*.d.ts",
+      "require": "./dist/*.js",
+      "default": "./dist/*.mjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@ai-sdk/alibaba": "^2.0.24",
+    "@ai-sdk/anthropic": "^4.0.25",
+    "@ai-sdk/google": "^4.0.29",
+    "@ai-sdk/moonshotai": "^3.0.25",
+    "@ai-sdk/openai": "^4.0.25",
+    "@ai-sdk/openai-compatible": "^3.0.18",
+    "@ai-sdk/provider": "^4.0.4",
+    "@ai-sdk/provider-utils": "^5.0.16",
+    "@daytona/sdk": "^0.204.1",
+    "@hono/zod-openapi": "^1.5.1",
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "@nats-io/nats-core": "3.0.2",
+    "@opentelemetry/api": "^1.9.0",
+    "@opentelemetry/core": "^2.9.0",
+    "ai": "^7.0.44",
+    "dedent": "^1.7.2",
+    "openai": "^7.2.0",
+    "ulid": "^3.0.2",
+    "winston": "^3.13.0",
+    "ws": "^8.21.0",
+    "zod": "^4.4.3"
+  },
+  "peerDependencies": {
+    "redis": "^5.10.0"
+  },
+  "devDependencies": {
+    "@swc/core": "^1.11.0",
+    "@swc/jest": "^0.2.37",
+    "@types/jest": "^29.5.14",
+    "@types/node": "^24.12.0",
+    "@types/ws": "^8.5.10",
+    "esbuild-plugin-file-path-extensions": "^2.1.4",
+    "jest": "^29.7.0",
+    "redis": "^5.10.0",
+    "tsup": "^8.5.0",
+    "typescript": "^7.0.2"
+  },
+  "scripts": {
+    "build:gen": "node scripts/generate-sandbox-scripts.mjs",
+    "build:gen:watch": "node --watch-path=src/core/sandbox/scripts scripts/generate-sandbox-scripts.mjs",
+    "build": "pnpm run build:gen && tsc --noEmit && pnpm run build:js && pnpm run build:dts && pnpm run build:pkg && pnpm run build:check",
+    "dev": "pnpm run build:gen:watch",
+    "build:js": "tsup",
+    "build:dts": "tsc -p tsconfig.build.json --emitDeclarationOnly",
+    "build:pkg": "node scripts/write-dist-package-json.mjs",
+    "build:check": "node scripts/check-dist.mjs",
+    "typecheck": "pnpm run build:gen && tsc --noEmit",
+    "test": "pnpm run build:gen && jest --config jest.config.cjs",
+    "pack:dry": "pnpm pack --dry-run"
   }
-}
+}

package/README.md

@@ -1,4 +0,0 @@
-# `@truefoundry/trueforge-core`
-
-Placeholder `0.0.0` so npm trusted publishing can be attached to this package.
-Not a functional release. Install a later version.