@execbox/quickjs 0.4.0 → 0.6.0

package/dist/protocolEndpoint-T_JEz8YY.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"protocolEndpoint-T_JEz8YY.js","names":["activeAbortController: AbortController | undefined","activeExecutionId: string | undefined"],"sources":["../../core/src/protocol/messages.ts","../src/runner/protocolEndpoint.ts"],"sourcesContent":["import type {\n  ExecutorRuntimeOptions,\n  ProviderManifest,\n  ToolCall,\n  ToolCallResult,\n} from \"../runner.ts\";\nimport type { ExecuteResult } from \"../types.ts\";\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null;\n}\n\nfunction isFiniteNumber(value: unknown): value is number {\n  return typeof value === \"number\" && Number.isFinite(value);\n}\n\nfunction isRuntimeOptions(value: unknown): value is ExecutorRuntimeOptions {\n  if (!isRecord(value)) {\n    return false;\n  }\n\n  return (\n    isFiniteNumber(value.maxLogChars) &&\n    isFiniteNumber(value.maxLogLines) &&\n    isFiniteNumber(value.memoryLimitBytes) &&\n    isFiniteNumber(value.timeoutMs)\n  );\n}\n\nfunction isProviderManifest(value: unknown): value is ProviderManifest {\n  if (!isRecord(value) || typeof value.name !== \"string\") {\n    return false;\n  }\n\n  if (!isRecord(value.tools) || typeof value.types !== \"string\") {\n    return false;\n  }\n\n  return Object.values(value.tools).every(\n    (tool) =>\n      isRecord(tool) &&\n      typeof tool.originalName === \"string\" &&\n      typeof tool.safeName === \"string\" &&\n      (tool.description === undefined || typeof tool.description === \"string\"),\n  );\n}\n\nfunction isExecuteError(\n  value: unknown,\n): value is { code: string; message: string } {\n  return (\n    isRecord(value) &&\n    typeof value.code === \"string\" &&\n    typeof value.message === \"string\"\n  );\n}\n\nfunction isDonePayload(value: unknown): value is DoneMessage {\n  if (!isRecord(value) || !isFiniteNumber(value.durationMs)) {\n    return false;\n  }\n\n  if (\n    !Array.isArray(value.logs) ||\n    !value.logs.every((log) => typeof log === \"string\")\n  ) {\n    return false;\n  }\n\n  if (typeof value.ok !== \"boolean\") {\n    return false;\n  }\n\n  return value.ok ? true : isExecuteError(value.error);\n}\n\n/**\n * Message sent from dispatcher to runner to start one execution session.\n */\nexport interface ExecuteMessage {\n  code: string;\n  id: string;\n  options: ExecutorRuntimeOptions;\n  providers: ProviderManifest[];\n  type: \"execute\";\n}\n\n/**\n * Message sent from dispatcher to request prompt cancellation.\n */\nexport interface CancelMessage {\n  id: string;\n  type: \"cancel\";\n}\n\n/**\n * Message sent from a runner when guest code invokes a host tool.\n */\nexport interface ToolCallMessage extends ToolCall {\n  callId: string;\n  type: \"tool_call\";\n}\n\n/**\n * Message carrying a trusted host tool result back to the runner.\n */\nexport type ToolResultMessage = {\n  callId: string;\n  type: \"tool_result\";\n} & ToolCallResult;\n\n/**\n * Message indicating the runner has finished bootstrapping guest execution timing.\n */\nexport interface StartedMessage {\n  id: string;\n  type: \"started\";\n}\n\n/**\n * Final successful execution result returned by a runner.\n *\n * Node IPC can omit `undefined` fields during serialization, so `result`\n * remains optional at the protocol boundary and is normalized by the host.\n */\nexport type DoneSuccessMessage<T = unknown> = {\n  durationMs: number;\n  id: string;\n  logs: string[];\n  ok: true;\n  result?: T;\n  type: \"done\";\n};\n\n/**\n * Final failed execution result returned by a runner.\n */\nexport type DoneFailureMessage = {\n  id: string;\n  type: \"done\";\n} & Extract<ExecuteResult, { ok: false }>;\n\n/**\n * Final execution result returned by a runner.\n */\nexport type DoneMessage = DoneSuccessMessage | DoneFailureMessage;\n\n/**\n * Messages accepted by a runner transport endpoint.\n */\nexport type DispatcherMessage =\n  | CancelMessage\n  | ExecuteMessage\n  | ToolResultMessage;\n\n/**\n * Messages emitted by a runner transport endpoint.\n */\nexport type RunnerMessage = DoneMessage | StartedMessage | ToolCallMessage;\n\n/**\n * Returns whether an unknown value is a dispatcher-to-runner message.\n */\nexport function isDispatcherMessage(\n  value: unknown,\n): value is DispatcherMessage {\n  if (!isRecord(value) || typeof value.type !== \"string\") {\n    return false;\n  }\n\n  switch (value.type) {\n    case \"cancel\":\n      return typeof value.id === \"string\";\n    case \"execute\":\n      return (\n        typeof value.code === \"string\" &&\n        typeof value.id === \"string\" &&\n        isRuntimeOptions(value.options) &&\n        Array.isArray(value.providers) &&\n        value.providers.every(isProviderManifest)\n      );\n    case \"tool_result\":\n      if (typeof value.callId !== \"string\" || typeof value.ok !== \"boolean\") {\n        return false;\n      }\n\n      if (value.ok) {\n        return \"result\" in value;\n      }\n\n      return isExecuteError(value.error);\n    default:\n      return false;\n  }\n}\n\n/**\n * Returns whether an unknown value is a runner-to-dispatcher message.\n */\nexport function isRunnerMessage(value: unknown): value is RunnerMessage {\n  if (!isRecord(value) || typeof value.type !== \"string\") {\n    return false;\n  }\n\n  switch (value.type) {\n    case \"started\":\n      return typeof value.id === \"string\";\n    case \"tool_call\":\n      return (\n        typeof value.callId === \"string\" &&\n        typeof value.providerName === \"string\" &&\n        typeof value.safeToolName === \"string\" &&\n        \"input\" in value\n      );\n    case \"done\":\n      return typeof value.id === \"string\" && isDonePayload(value);\n    default:\n      return false;\n  }\n}\n","/**\n * @packageDocumentation\n * Public API for the `@execbox/quickjs/runner/protocol-endpoint` entrypoint.\n */\nimport { randomUUID } from \"node:crypto\";\n\nimport type {\n  DispatcherMessage,\n  ExecuteMessage,\n  RunnerMessage,\n} from \"@execbox/core/protocol\";\nimport type { ToolCallResult } from \"@execbox/core\";\n// This entrypoint is executed directly from source in worker/process tests before\n// workspace packages are built, so its runtime validator must stay source-local.\nimport { isDispatcherMessage } from \"../../../core/src/protocol/messages.ts\";\n\nimport { runQuickJsSession } from \"./index.ts\";\n\n/**\n * Minimal worker/process-side port used by the shared QuickJS protocol endpoint.\n */\nexport interface QuickJsProtocolPort {\n  onMessage(handler: (message: DispatcherMessage) => void): void | (() => void);\n  send(message: RunnerMessage): void;\n}\n\n/**\n * Attaches the shared QuickJS protocol loop to a worker/process messaging port.\n */\nexport function attachQuickJsProtocolEndpoint(\n  port: QuickJsProtocolPort,\n): () => void {\n  const pendingToolCalls = new Map<string, (result: ToolCallResult) => void>();\n  let activeAbortController: AbortController | undefined;\n  let activeExecutionId: string | undefined;\n\n  async function startExecution(message: ExecuteMessage): Promise<void> {\n    if (activeExecutionId) {\n      port.send({\n        durationMs: 0,\n        error: {\n          code: \"internal_error\",\n          message: \"QuickJS endpoint already has an active execution\",\n        },\n        id: message.id,\n        logs: [],\n        ok: false,\n        type: \"done\",\n      });\n      return;\n    }\n\n    const abortController = new AbortController();\n    activeAbortController = abortController;\n    activeExecutionId = message.id;\n\n    try {\n      const result = await runQuickJsSession(\n        {\n          abortController,\n          code: message.code,\n          onStarted: () => {\n            port.send({\n              id: message.id,\n              type: \"started\",\n            });\n          },\n          onToolCall: (call) =>\n            new Promise<ToolCallResult>((resolve) => {\n              const callId = randomUUID();\n              pendingToolCalls.set(callId, resolve);\n              port.send({\n                ...call,\n                callId,\n                type: \"tool_call\",\n              });\n            }),\n          providers: message.providers,\n        },\n        message.options,\n      );\n\n      port.send({\n        ...result,\n        id: message.id,\n        type: \"done\",\n      });\n    } catch (error) {\n      port.send({\n        durationMs: 0,\n        error: {\n          code: \"internal_error\",\n          message: error instanceof Error ? error.message : String(error),\n        },\n        id: message.id,\n        logs: [],\n        ok: false,\n        type: \"done\",\n      });\n    } finally {\n      pendingToolCalls.clear();\n      activeAbortController = undefined;\n      activeExecutionId = undefined;\n    }\n  }\n\n  const maybeDetach = port.onMessage((message: DispatcherMessage) => {\n    if (!isDispatcherMessage(message)) {\n      return;\n    }\n\n    switch (message.type) {\n      case \"cancel\":\n        if (message.id === activeExecutionId) {\n          activeAbortController?.abort();\n        }\n        break;\n      case \"execute\":\n        void startExecution(message);\n        break;\n      case \"tool_result\": {\n        const resolve = pendingToolCalls.get(message.callId);\n        pendingToolCalls.delete(message.callId);\n        resolve?.(message);\n        break;\n      }\n    }\n  });\n\n  return () => {\n    if (typeof maybeDetach === \"function\") {\n      maybeDetach();\n    }\n    pendingToolCalls.clear();\n    activeAbortController?.abort();\n    activeAbortController = undefined;\n    activeExecutionId = undefined;\n  };\n}\n"],"mappings":";;;;AAQA,SAAS,SAAS,OAAkD;AAClE,QAAO,OAAO,UAAU,YAAY,UAAU;;AAGhD,SAAS,eAAe,OAAiC;AACvD,QAAO,OAAO,UAAU,YAAY,OAAO,SAAS,MAAM;;AAG5D,SAAS,iBAAiB,OAAiD;AACzE,KAAI,CAAC,SAAS,MAAM,CAClB,QAAO;AAGT,QACE,eAAe,MAAM,YAAY,IACjC,eAAe,MAAM,YAAY,IACjC,eAAe,MAAM,iBAAiB,IACtC,eAAe,MAAM,UAAU;;AAInC,SAAS,mBAAmB,OAA2C;AACrE,KAAI,CAAC,SAAS,MAAM,IAAI,OAAO,MAAM,SAAS,SAC5C,QAAO;AAGT,KAAI,CAAC,SAAS,MAAM,MAAM,IAAI,OAAO,MAAM,UAAU,SACnD,QAAO;AAGT,QAAO,OAAO,OAAO,MAAM,MAAM,CAAC,OAC/B,SACC,SAAS,KAAK,IACd,OAAO,KAAK,iBAAiB,YAC7B,OAAO,KAAK,aAAa,aACxB,KAAK,gBAAgB,UAAa,OAAO,KAAK,gBAAgB,UAClE;;AAGH,SAAS,eACP,OAC4C;AAC5C,QACE,SAAS,MAAM,IACf,OAAO,MAAM,SAAS,YACtB,OAAO,MAAM,YAAY;;;;;AA8G7B,SAAgB,oBACd,OAC4B;AAC5B,KAAI,CAAC,SAAS,MAAM,IAAI,OAAO,MAAM,SAAS,SAC5C,QAAO;AAGT,SAAQ,MAAM,MAAd;EACE,KAAK,SACH,QAAO,OAAO,MAAM,OAAO;EAC7B,KAAK,UACH,QACE,OAAO,MAAM,SAAS,YACtB,OAAO,MAAM,OAAO,YACpB,iBAAiB,MAAM,QAAQ,IAC/B,MAAM,QAAQ,MAAM,UAAU,IAC9B,MAAM,UAAU,MAAM,mBAAmB;EAE7C,KAAK;AACH,OAAI,OAAO,MAAM,WAAW,YAAY,OAAO,MAAM,OAAO,UAC1D,QAAO;AAGT,OAAI,MAAM,GACR,QAAO,YAAY;AAGrB,UAAO,eAAe,MAAM,MAAM;EACpC,QACE,QAAO;;;;;;;;;;;;;ACnKb,SAAgB,8BACd,MACY;CACZ,MAAM,mCAAmB,IAAI,KAA+C;CAC5E,IAAIA;CACJ,IAAIC;CAEJ,eAAe,eAAe,SAAwC;AACpE,MAAI,mBAAmB;AACrB,QAAK,KAAK;IACR,YAAY;IACZ,OAAO;KACL,MAAM;KACN,SAAS;KACV;IACD,IAAI,QAAQ;IACZ,MAAM,EAAE;IACR,IAAI;IACJ,MAAM;IACP,CAAC;AACF;;EAGF,MAAM,kBAAkB,IAAI,iBAAiB;AAC7C,0BAAwB;AACxB,sBAAoB,QAAQ;AAE5B,MAAI;GACF,MAAM,SAAS,MAAM,kBACnB;IACE;IACA,MAAM,QAAQ;IACd,iBAAiB;AACf,UAAK,KAAK;MACR,IAAI,QAAQ;MACZ,MAAM;MACP,CAAC;;IAEJ,aAAa,SACX,IAAI,SAAyB,YAAY;KACvC,MAAM,SAAS,YAAY;AAC3B,sBAAiB,IAAI,QAAQ,QAAQ;AACrC,UAAK,KAAK;MACR,GAAG;MACH;MACA,MAAM;MACP,CAAC;MACF;IACJ,WAAW,QAAQ;IACpB,EACD,QAAQ,QACT;AAED,QAAK,KAAK;IACR,GAAG;IACH,IAAI,QAAQ;IACZ,MAAM;IACP,CAAC;WACK,OAAO;AACd,QAAK,KAAK;IACR,YAAY;IACZ,OAAO;KACL,MAAM;KACN,SAAS,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM;KAChE;IACD,IAAI,QAAQ;IACZ,MAAM,EAAE;IACR,IAAI;IACJ,MAAM;IACP,CAAC;YACM;AACR,oBAAiB,OAAO;AACxB,2BAAwB;AACxB,uBAAoB;;;CAIxB,MAAM,cAAc,KAAK,WAAW,YAA+B;AACjE,MAAI,CAAC,oBAAoB,QAAQ,CAC/B;AAGF,UAAQ,QAAQ,MAAhB;GACE,KAAK;AACH,QAAI,QAAQ,OAAO,kBACjB,wBAAuB,OAAO;AAEhC;GACF,KAAK;AACH,IAAK,eAAe,QAAQ;AAC5B;GACF,KAAK,eAAe;IAClB,MAAM,UAAU,iBAAiB,IAAI,QAAQ,OAAO;AACpD,qBAAiB,OAAO,QAAQ,OAAO;AACvC,cAAU,QAAQ;AAClB;;;GAGJ;AAEF,cAAa;AACX,MAAI,OAAO,gBAAgB,WACzB,cAAa;AAEf,mBAAiB,OAAO;AACxB,yBAAuB,OAAO;AAC9B,0BAAwB;AACxB,sBAAoB"}