@zhushanwen/subagent-engine-sdk 0.2.0

package/dist/protocol/index.js

@@ -0,0 +1,89 @@
+import {
+  ENGINE_PROTOCOL_SCHEMAS,
+  FORBIDDEN_CREDENTIAL_KEY_FRAGMENTS,
+  PROTOCOL_METHODS,
+  REVERSE_CHANNELS,
+  REVERSE_CHANNEL_NAMES,
+  REVERSE_CHANNEL_TIMEOUT_CLASS,
+  errorResponseFrameSchema,
+  isHostRoundLifecycleParams,
+  isHostStreamDeltaParams,
+  isNotificationFrame,
+  isRequestFrame,
+  isResponseFrame,
+  isReverseRequestFrame,
+  notificationFrameSchema,
+  protocolErrorSchema,
+  requestFrameSchema,
+  reverseRequestFrameSchema,
+  successResponseFrameSchema
+} from "../chunk-YFSN3D5N.js";
+import {
+  CANCEL_SETTLE_GRACE_MS,
+  CRASH_REBUILD_BACKOFF_MS,
+  CRASH_REBUILD_MAX_ATTEMPTS,
+  ENGINE_ERROR_CODE_PREFIX,
+  ENGINE_EVENT_COALESCE_DEFAULT,
+  ENGINE_EVENT_COALESCE_ENV,
+  ENGINE_PROTOCOL_ERROR_CODES,
+  ENGINE_PROTOCOL_VERSION,
+  ENGINE_TIMEOUT_RECOVERY,
+  EngineSdkError,
+  HANDSHAKE_TIMEOUT_MS,
+  REVERSE_REQUEST_TIMEOUT_MS,
+  STDERR_TAIL_CHARS,
+  STDOUT_TAIL_ECHO_CHARS,
+  SUPPORTED_PROTOCOL_RANGE,
+  assertChatConversationSupported,
+  engineConversationUnsupportedError,
+  engineProtocolMismatchError,
+  engineTimeoutDetail,
+  isEngineErrorPassthroughCode,
+  isEngineProtocolErrorCode,
+  isProtocolVersionCompatible,
+  schemaEmulationFailedDetail
+} from "../chunk-PPEPBVCC.js";
+import "../chunk-JSBRDJBE.js";
+export {
+  CANCEL_SETTLE_GRACE_MS,
+  CRASH_REBUILD_BACKOFF_MS,
+  CRASH_REBUILD_MAX_ATTEMPTS,
+  ENGINE_ERROR_CODE_PREFIX,
+  ENGINE_EVENT_COALESCE_DEFAULT,
+  ENGINE_EVENT_COALESCE_ENV,
+  ENGINE_PROTOCOL_ERROR_CODES,
+  ENGINE_PROTOCOL_SCHEMAS,
+  ENGINE_PROTOCOL_VERSION,
+  ENGINE_TIMEOUT_RECOVERY,
+  EngineSdkError,
+  FORBIDDEN_CREDENTIAL_KEY_FRAGMENTS,
+  HANDSHAKE_TIMEOUT_MS,
+  PROTOCOL_METHODS,
+  REVERSE_CHANNELS,
+  REVERSE_CHANNEL_NAMES,
+  REVERSE_CHANNEL_TIMEOUT_CLASS,
+  REVERSE_REQUEST_TIMEOUT_MS,
+  STDERR_TAIL_CHARS,
+  STDOUT_TAIL_ECHO_CHARS,
+  SUPPORTED_PROTOCOL_RANGE,
+  assertChatConversationSupported,
+  engineConversationUnsupportedError,
+  engineProtocolMismatchError,
+  engineTimeoutDetail,
+  errorResponseFrameSchema,
+  isEngineErrorPassthroughCode,
+  isEngineProtocolErrorCode,
+  isHostRoundLifecycleParams,
+  isHostStreamDeltaParams,
+  isNotificationFrame,
+  isProtocolVersionCompatible,
+  isRequestFrame,
+  isResponseFrame,
+  isReverseRequestFrame,
+  notificationFrameSchema,
+  protocolErrorSchema,
+  requestFrameSchema,
+  reverseRequestFrameSchema,
+  schemaEmulationFailedDetail,
+  successResponseFrameSchema
+};

package/dist/relay-env.cjs

@@ -0,0 +1,71 @@
+"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/relay-env.ts
+var relay_env_exports = {};
+__export(relay_env_exports, {
+  RELAY_ENV_NODE: () => RELAY_ENV_NODE,
+  RELAY_ENV_RECORD_ID: () => RELAY_ENV_RECORD_ID,
+  RELAY_ENV_SCRIPT: () => RELAY_ENV_SCRIPT,
+  RELAY_ENV_SESSION_ID: () => RELAY_ENV_SESSION_ID,
+  RELAY_ENV_SOCKET: () => RELAY_ENV_SOCKET,
+  RELAY_EXIT_CODES: () => RELAY_EXIT_CODES,
+  RELAY_PROTOCOL_VERSION: () => RELAY_PROTOCOL_VERSION,
+  isRelayActive: () => isRelayActive,
+  readRelayForwardEnv: () => readRelayForwardEnv
+});
+module.exports = __toCommonJS(relay_env_exports);
+var RELAY_ENV_SOCKET = "XYZ_SUBAGENT_RELAY_SOCKET";
+var RELAY_ENV_NODE = "XYZ_SUBAGENT_RELAY_NODE";
+var RELAY_ENV_SCRIPT = "XYZ_SUBAGENT_RELAY_SCRIPT";
+var RELAY_ENV_SESSION_ID = "XYZ_SUBAGENT_RELAY_SESSION_ID";
+var RELAY_ENV_RECORD_ID = "XYZ_SUBAGENT_RELAY_RECORD_ID";
+var RELAY_PROTOCOL_VERSION = 1;
+var RELAY_EXIT_CODES = {
+  /** 握手被拒：协议版本不匹配（安装损坏，重装应用）。 */
+  VERSION_MISMATCH: 10,
+  /** relay socket 不可达（runtime 未运行或已重启）。 */
+  SOCKET_UNREACHABLE: 11,
+  /** socket 中途断开（runtime 崩溃等）——代理生命线断即退。 */
+  SOCKET_CLOSED: 12,
+  /** 归属 env（SESSION_ID/RECORD_ID）缺失——防无归属帧污染广播。 */
+  MISSING_IDENTITY: 13
+};
+function isRelayActive(env) {
+  return Boolean(env[RELAY_ENV_SOCKET] && env[RELAY_ENV_NODE] && env[RELAY_ENV_SCRIPT]);
+}
+function readRelayForwardEnv(env) {
+  const socket = env[RELAY_ENV_SOCKET];
+  const node = env[RELAY_ENV_NODE];
+  const script = env[RELAY_ENV_SCRIPT];
+  if (!isRelayActive(env)) return void 0;
+  return { socket, node, script };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  RELAY_ENV_NODE,
+  RELAY_ENV_RECORD_ID,
+  RELAY_ENV_SCRIPT,
+  RELAY_ENV_SESSION_ID,
+  RELAY_ENV_SOCKET,
+  RELAY_EXIT_CODES,
+  RELAY_PROTOCOL_VERSION,
+  isRelayActive,
+  readRelayForwardEnv
+});

package/dist/relay-env.d.cts

@@ -0,0 +1,37 @@
+declare const RELAY_ENV_SOCKET = "XYZ_SUBAGENT_RELAY_SOCKET";
+declare const RELAY_ENV_NODE = "XYZ_SUBAGENT_RELAY_NODE";
+declare const RELAY_ENV_SCRIPT = "XYZ_SUBAGENT_RELAY_SCRIPT";
+declare const RELAY_ENV_SESSION_ID = "XYZ_SUBAGENT_RELAY_SESSION_ID";
+declare const RELAY_ENV_RECORD_ID = "XYZ_SUBAGENT_RELAY_RECORD_ID";
+/** relay 协议版本（握手帧 v 字段；runtime 与代理同包分发，不匹配=安装损坏）。 */
+declare const RELAY_PROTOCOL_VERSION = 1;
+/** 代理专用退出码（extension/引擎侧表现为「子进程非零退出」→ engine_run_failed 语义）。 */
+declare const RELAY_EXIT_CODES: {
+    /** 握手被拒：协议版本不匹配（安装损坏，重装应用）。 */
+    readonly VERSION_MISMATCH: 10;
+    /** relay socket 不可达（runtime 未运行或已重启）。 */
+    readonly SOCKET_UNREACHABLE: 11;
+    /** socket 中途断开（runtime 崩溃等）——代理生命线断即退。 */
+    readonly SOCKET_CLOSED: 12;
+    /** 归属 env（SESSION_ID/RECORD_ID）缺失——防无归属帧污染广播。 */
+    readonly MISSING_IDENTITY: 13;
+};
+/** 激活判定：三 env 同时非空才走 relay，任一缺失回落直连 spawn 真实引擎（TUI/独立引擎零回归）。 */
+declare function isRelayActive(env: NodeJS.ProcessEnv | Record<string, string | undefined>): boolean;
+/**
+ * [W8 H12] 宿主 env → relay 连接三键的转发提取（原样转发语义的单一实现）。
+ *
+ * 三键同时非空（isRelayActive 同判）才返回——全有或全无，无中间态；身份键
+ * SESSION_ID/RECORD_ID 不在本提取面（它们是父身份归属键，引擎子进程 env 由
+ * SDK buildEngineChildEnv L1 deny 剥除、引擎按 run.params.ctx 重写，不靠 env 继承）。
+ *
+ * 消费方：D8 createZcodeEngine 薄壳（zsw 宿主链路的 relay 透传）；宿主 env 形态
+ * 与 SDK EngineRelayEnv 结构等价（字段名 socket/node/script），TS 结构类型直接赋值。
+ */
+declare function readRelayForwardEnv(env: NodeJS.ProcessEnv | Record<string, string | undefined>): {
+    socket: string;
+    node: string;
+    script: string;
+} | undefined;
+
+export { RELAY_ENV_NODE, RELAY_ENV_RECORD_ID, RELAY_ENV_SCRIPT, RELAY_ENV_SESSION_ID, RELAY_ENV_SOCKET, RELAY_EXIT_CODES, RELAY_PROTOCOL_VERSION, isRelayActive, readRelayForwardEnv };

package/dist/relay-env.d.ts

@@ -0,0 +1,37 @@
+declare const RELAY_ENV_SOCKET = "XYZ_SUBAGENT_RELAY_SOCKET";
+declare const RELAY_ENV_NODE = "XYZ_SUBAGENT_RELAY_NODE";
+declare const RELAY_ENV_SCRIPT = "XYZ_SUBAGENT_RELAY_SCRIPT";
+declare const RELAY_ENV_SESSION_ID = "XYZ_SUBAGENT_RELAY_SESSION_ID";
+declare const RELAY_ENV_RECORD_ID = "XYZ_SUBAGENT_RELAY_RECORD_ID";
+/** relay 协议版本（握手帧 v 字段；runtime 与代理同包分发，不匹配=安装损坏）。 */
+declare const RELAY_PROTOCOL_VERSION = 1;
+/** 代理专用退出码（extension/引擎侧表现为「子进程非零退出」→ engine_run_failed 语义）。 */
+declare const RELAY_EXIT_CODES: {
+    /** 握手被拒：协议版本不匹配（安装损坏，重装应用）。 */
+    readonly VERSION_MISMATCH: 10;
+    /** relay socket 不可达（runtime 未运行或已重启）。 */
+    readonly SOCKET_UNREACHABLE: 11;
+    /** socket 中途断开（runtime 崩溃等）——代理生命线断即退。 */
+    readonly SOCKET_CLOSED: 12;
+    /** 归属 env（SESSION_ID/RECORD_ID）缺失——防无归属帧污染广播。 */
+    readonly MISSING_IDENTITY: 13;
+};
+/** 激活判定：三 env 同时非空才走 relay，任一缺失回落直连 spawn 真实引擎（TUI/独立引擎零回归）。 */
+declare function isRelayActive(env: NodeJS.ProcessEnv | Record<string, string | undefined>): boolean;
+/**
+ * [W8 H12] 宿主 env → relay 连接三键的转发提取（原样转发语义的单一实现）。
+ *
+ * 三键同时非空（isRelayActive 同判）才返回——全有或全无，无中间态；身份键
+ * SESSION_ID/RECORD_ID 不在本提取面（它们是父身份归属键，引擎子进程 env 由
+ * SDK buildEngineChildEnv L1 deny 剥除、引擎按 run.params.ctx 重写，不靠 env 继承）。
+ *
+ * 消费方：D8 createZcodeEngine 薄壳（zsw 宿主链路的 relay 透传）；宿主 env 形态
+ * 与 SDK EngineRelayEnv 结构等价（字段名 socket/node/script），TS 结构类型直接赋值。
+ */
+declare function readRelayForwardEnv(env: NodeJS.ProcessEnv | Record<string, string | undefined>): {
+    socket: string;
+    node: string;
+    script: string;
+} | undefined;
+
+export { RELAY_ENV_NODE, RELAY_ENV_RECORD_ID, RELAY_ENV_SCRIPT, RELAY_ENV_SESSION_ID, RELAY_ENV_SOCKET, RELAY_EXIT_CODES, RELAY_PROTOCOL_VERSION, isRelayActive, readRelayForwardEnv };

package/dist/relay-env.js

@@ -0,0 +1,23 @@
+import {
+  RELAY_ENV_NODE,
+  RELAY_ENV_RECORD_ID,
+  RELAY_ENV_SCRIPT,
+  RELAY_ENV_SESSION_ID,
+  RELAY_ENV_SOCKET,
+  RELAY_EXIT_CODES,
+  RELAY_PROTOCOL_VERSION,
+  isRelayActive,
+  readRelayForwardEnv
+} from "./chunk-DSQ7JQKM.js";
+import "./chunk-JSBRDJBE.js";
+export {
+  RELAY_ENV_NODE,
+  RELAY_ENV_RECORD_ID,
+  RELAY_ENV_SCRIPT,
+  RELAY_ENV_SESSION_ID,
+  RELAY_ENV_SOCKET,
+  RELAY_EXIT_CODES,
+  RELAY_PROTOCOL_VERSION,
+  isRelayActive,
+  readRelayForwardEnv
+};