@xmoxmo/bncr 0.3.3 → 0.3.5

package/dist/index.js

@@ -134,7 +134,6 @@ var BNCR_BRIDGE_OWNER = /* @__PURE__ */ Symbol.for("bncr.bridge.owner");
 var BNCR_GATEWAY_RUNTIME = /* @__PURE__ */ Symbol.for("bncr.gateway.runtime");
 var MODULE_EPOCH = `${process.pid}-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 8)}`;
 var runtime = null;
-var activeServiceStop = null;
 var identityIds = /* @__PURE__ */ new WeakMap();
 var identitySeq = 0;
 var tryExec = (command, args) => {
@@ -288,7 +287,9 @@ var loadRuntimeSync = () => {
     return runtime;
   } catch (error) {
     const detail = error instanceof Error ? `${error.name}: ${error.message}` : String(error);
-    throw new Error(`bncr failed to load channel runtime after dependency bootstrap from ${runtimeSourceDir}: ${detail}`);
+    throw new Error(
+      `bncr failed to load channel runtime after dependency bootstrap from ${runtimeSourceDir}: ${detail}`
+    );
   }
 };
 var getIdentityId = (obj, prefix) => {
@@ -375,6 +376,8 @@ var gatewayMethodDispatchers = {
   "bncr.activity": (bridge, opts) => bridge.handleActivity(opts),
   "bncr.ack": (bridge, opts) => bridge.handleAck(opts),
   "bncr.diagnostics": (bridge, opts) => bridge.handleDiagnostics(opts),
+  "bncr.deadLetter.inspect": (bridge, opts) => bridge.handleDeadLetterInspect(opts),
+  "bncr.deadLetter.prune": (bridge, opts) => bridge.handleDeadLetterPrune(opts),
   "bncr.file.init": (bridge, opts) => bridge.handleFileInit(opts),
   "bncr.file.chunk": (bridge, opts) => bridge.handleFileChunk(opts),
   "bncr.file.complete": (bridge, opts) => bridge.handleFileComplete(opts),
@@ -719,7 +722,6 @@ var plugin = {
         },
         stop: serviceStopHandler
       });
-      activeServiceStop = serviceStopHandler;
       gatewayRuntime.serviceRegistered = true;
       gatewayRuntime.serviceOwnerApiInstanceId = apiInstanceId;
       meta.service = true;
@@ -747,6 +749,8 @@ var plugin = {
     ensureGatewayMethodRegistered(api, "bncr.activity", debugLog);
     ensureGatewayMethodRegistered(api, "bncr.ack", debugLog);
     ensureGatewayMethodRegistered(api, "bncr.diagnostics", debugLog);
+    ensureGatewayMethodRegistered(api, "bncr.deadLetter.inspect", debugLog);
+    ensureGatewayMethodRegistered(api, "bncr.deadLetter.prune", debugLog);
     ensureGatewayMethodRegistered(api, "bncr.file.init", debugLog);
     ensureGatewayMethodRegistered(api, "bncr.file.chunk", debugLog);
     ensureGatewayMethodRegistered(api, "bncr.file.complete", debugLog);

package/index.ts

@@ -76,6 +76,8 @@ type GatewayMethodName =
   | 'bncr.activity'
   | 'bncr.ack'
   | 'bncr.diagnostics'
+  | 'bncr.deadLetter.inspect'
+  | 'bncr.deadLetter.prune'
   | 'bncr.file.init'
   | 'bncr.file.chunk'
   | 'bncr.file.complete'
@@ -111,7 +113,6 @@ type BncrGatewayRuntime = {
 };
 
 let runtime: LoadedRuntime | null = null;
-let activeServiceStop: (() => Promise<void>) | null = null;
 const identityIds = new WeakMap<object, string>();
 let identitySeq = 0;
 
@@ -297,7 +298,9 @@ const loadRuntimeSync = (): LoadedRuntime => {
     return runtime;
   } catch (error) {
     const detail = error instanceof Error ? `${error.name}: ${error.message}` : String(error);
-    throw new Error(`bncr failed to load channel runtime after dependency bootstrap from ${runtimeSourceDir}: ${detail}`);
+    throw new Error(
+      `bncr failed to load channel runtime after dependency bootstrap from ${runtimeSourceDir}: ${detail}`,
+    );
   }
 };
 
@@ -365,14 +368,9 @@ const getGatewayRuntime = (): BncrGatewayRuntime => {
 };
 
 const getProcessOwnerApiInstanceId = (gatewayRuntime: BncrGatewayRuntime) =>
-  gatewayRuntime.serviceOwnerApiInstanceId ||
-  gatewayRuntime.channelOwnerApiInstanceId ||
-  undefined;
+  gatewayRuntime.serviceOwnerApiInstanceId || gatewayRuntime.channelOwnerApiInstanceId || undefined;
 
-const shouldAdoptProcessOwner = (
-  apiInstanceId: string,
-  gatewayRuntime: BncrGatewayRuntime,
-) => {
+const shouldAdoptProcessOwner = (apiInstanceId: string, gatewayRuntime: BncrGatewayRuntime) => {
   const existingOwnerApiInstanceId = getProcessOwnerApiInstanceId(gatewayRuntime);
   const hasSingletonOwner =
     Boolean(gatewayRuntime.serviceRegistered) || Boolean(gatewayRuntime.channelRegistered);
@@ -409,6 +407,8 @@ const gatewayMethodDispatchers: Record<
   'bncr.activity': (bridge, opts) => bridge.handleActivity(opts),
   'bncr.ack': (bridge, opts) => bridge.handleAck(opts),
   'bncr.diagnostics': (bridge, opts) => bridge.handleDiagnostics(opts),
+  'bncr.deadLetter.inspect': (bridge, opts) => bridge.handleDeadLetterInspect(opts),
+  'bncr.deadLetter.prune': (bridge, opts) => bridge.handleDeadLetterPrune(opts),
   'bncr.file.init': (bridge, opts) => bridge.handleFileInit(opts),
   'bncr.file.chunk': (bridge, opts) => bridge.handleFileChunk(opts),
   'bncr.file.complete': (bridge, opts) => bridge.handleFileComplete(opts),
@@ -845,7 +845,6 @@ const plugin = {
         },
         stop: serviceStopHandler,
       });
-      activeServiceStop = serviceStopHandler;
       gatewayRuntime.serviceRegistered = true;
       gatewayRuntime.serviceOwnerApiInstanceId = apiInstanceId;
       meta.service = true;
@@ -875,6 +874,8 @@ const plugin = {
     ensureGatewayMethodRegistered(api, 'bncr.activity', debugLog);
     ensureGatewayMethodRegistered(api, 'bncr.ack', debugLog);
     ensureGatewayMethodRegistered(api, 'bncr.diagnostics', debugLog);
+    ensureGatewayMethodRegistered(api, 'bncr.deadLetter.inspect', debugLog);
+    ensureGatewayMethodRegistered(api, 'bncr.deadLetter.prune', debugLog);
     ensureGatewayMethodRegistered(api, 'bncr.file.init', debugLog);
     ensureGatewayMethodRegistered(api, 'bncr.file.chunk', debugLog);
     ensureGatewayMethodRegistered(api, 'bncr.file.complete', debugLog);

package/openclaw.plugin.json

@@ -22,6 +22,22 @@
         "type": "array",
         "items": { "type": "string" }
       },
+      "debug": {
+        "type": "object",
+        "additionalProperties": true,
+        "properties": {
+          "verbose": {
+            "type": "boolean",
+            "default": false,
+            "description": "Enable verbose debug logs for bncr channel runtime."
+          }
+        }
+      },
+      "allowTool": {
+        "type": "boolean",
+        "default": false,
+        "description": "Allow tool messages to be forwarded when streaming is enabled. Defaults to false; only explicit true enables forwarding. When enabled, bncr also requests upstream tool summaries/results."
+      },
       "requireMention": { "type": "boolean" },
       "outboundRequireAck": { "type": "boolean" },
       "accounts": {
@@ -81,6 +97,11 @@
             "default": false,
             "description": "Whether group messages must explicitly mention the bot before bncr handles them. Default false. Current version keeps this as a reserved field and does not enforce it yet."
           },
+          "outboundRequireAck": {
+            "type": "boolean",
+            "default": true,
+            "description": "Whether outbound text waits for bncr.ack before leaving the retry queue. Default true to preserve current ack/dead-letter behavior."
+          },
           "accounts": {
             "type": "object",
             "additionalProperties": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xmoxmo/bncr",
-  "version": "0.3.3",
+  "version": "0.3.5",
   "private": false,
   "type": "module",
   "license": "MIT",
@@ -39,9 +39,9 @@
     "openclaw": ">=2026.5.27"
   },
   "devDependencies": {
-    "@biomejs/biome": "^1.9.4",
-    "openclaw": ">=2026.5.27",
-    "esbuild": "^0.28.0"
+    "@biomejs/biome": "^2.4.16",
+    "esbuild": "^0.28.0",
+    "openclaw": ">=2026.5.27"
   },
   "openclaw": {
     "extensions": [

package/scripts/check-pack.mjs

@@ -7,35 +7,115 @@ const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 const root = path.resolve(__dirname, '..');
 
-const requiredPackFiles = [
-  'README.md',
-  'index.ts',
-  'openclaw.plugin.json',
-  'package.json',
-  'scripts/selfcheck.mjs',
+const requiredRootFiles = ['index.ts', 'openclaw.plugin.json'];
+
+const requiredScriptFiles = [
+  'scripts/check-pack.mjs',
   'scripts/check-register-drift.mjs',
+  'scripts/selfcheck.mjs',
+];
+
+const requiredSourceFiles = [
   'src/channel.ts',
-  'src/plugin/config.ts',
-  'src/plugin/message-policy.ts',
-  'src/plugin/messaging.ts',
-  'src/plugin/gateway-runtime.ts',
-  'src/plugin/message-send.ts',
-  'src/plugin/outbound.ts',
-  'src/plugin/setup.ts',
-  'src/plugin/status.ts',
-  'src/runtime/outbound-ack-timeout.ts',
-  'src/runtime/outbound-flags.ts',
-  'src/runtime/outbox-transitions.ts',
+  'src/core/types.ts',
+  'src/core/accounts.ts',
+  'src/core/connection-capability.ts',
+  'src/core/connection-reachability.ts',
+  'src/core/dead-letter-diagnostics.ts',
+  'src/core/diagnostic-counters.ts',
+  'src/core/diagnostics.ts',
+  'src/core/downlink-health.ts',
+  'src/core/extended-diagnostics.ts',
+  'src/core/file-ack.ts',
+  'src/core/file-transfer-payloads.ts',
+  'src/core/lease-state.ts',
+  'src/core/logging.ts',
+  'src/core/outbox-enqueue.ts',
+  'src/core/outbox-entry-builders.ts',
+  'src/core/outbox-file-transfer-bookkeeping.ts',
+  'src/core/outbox-file-transfer-failure.ts',
+  'src/core/outbox-file-transfer-guards.ts',
+  'src/core/outbox-file-transfer-prep.ts',
+  'src/core/outbox-file-transfer-success.ts',
+  'src/core/outbox-push-args.ts',
+  'src/core/outbox-queue.ts',
+  'src/core/outbox-summary.ts',
+  'src/core/outbox-text-push-failure.ts',
+  'src/core/outbox-text-push-guards.ts',
+  'src/core/outbox-text-push-prep.ts',
+  'src/core/outbox-text-push-success.ts',
+  'src/core/persisted-outbox-entry.ts',
+  'src/core/targets.ts',
+  'src/core/status.ts',
+  'src/core/status-meta.ts',
+  'src/core/probe.ts',
+  'src/core/config-schema.ts',
+  'src/core/policy.ts',
+  'src/core/permissions.ts',
+  'src/core/register-trace.ts',
+  'src/messaging/inbound/commands.ts',
+  'src/messaging/inbound/context-facts.ts',
+  'src/messaging/inbound/parse.ts',
+  'src/messaging/inbound/gate.ts',
+  'src/messaging/inbound/dispatch.ts',
+  'src/messaging/inbound/last-route.ts',
+  'src/messaging/inbound/native-command.ts',
+  'src/messaging/inbound/native-reply-delivery.ts',
+  'src/messaging/inbound/reply-config.ts',
+  'src/messaging/inbound/runtime-compat.ts',
+  'src/messaging/inbound/session-label.ts',
+  'src/messaging/outbound/send.ts',
+  'src/messaging/outbound/media.ts',
+  'src/messaging/outbound/actions.ts',
+  'src/messaging/outbound/build-send-action.ts',
+  'src/messaging/outbound/diagnostics.ts',
   'src/messaging/outbound/durable-message-adapter.ts',
   'src/messaging/outbound/durable-queue-adapter.ts',
+  'src/messaging/outbound/media-dedupe.ts',
+  'src/messaging/outbound/queue-selectors.ts',
+  'src/messaging/outbound/reasons.ts',
+  'src/messaging/outbound/reply-enqueue.ts',
+  'src/messaging/outbound/reply-target-policy.ts',
+  'src/messaging/outbound/retry-policy.ts',
+  'src/messaging/outbound/send-params.ts',
+  'src/messaging/outbound/session-route.ts',
+  'src/messaging/outbound/target-resolver.ts',
   'src/openclaw/config-runtime.ts',
   'src/openclaw/inbound-session-runtime.ts',
   'src/openclaw/ingress-runtime.ts',
   'src/openclaw/media-runtime.ts',
   'src/openclaw/reply-runtime.ts',
   'src/openclaw/routing-runtime.ts',
+  'src/openclaw/runtime-surface.ts',
   'src/openclaw/sdk-helpers.ts',
   'src/openclaw/session-route-runtime.ts',
+  'src/plugin/capabilities.ts',
+  'src/plugin/config.ts',
+  'src/plugin/gateway-methods.ts',
+  'src/plugin/gateway-runtime.ts',
+  'src/plugin/message-policy.ts',
+  'src/plugin/message-send.ts',
+  'src/plugin/messaging.ts',
+  'src/plugin/meta.ts',
+  'src/plugin/outbound.ts',
+  'src/plugin/setup.ts',
+  'src/plugin/status.ts',
+  'src/runtime/log-dedupe.ts',
+  'src/runtime/outbound-ack-timeout.ts',
+  'src/runtime/outbound-flags.ts',
+  'src/runtime/outbox-transitions.ts',
+  'src/runtime/register-trace-runtime.ts',
+  'src/runtime/status-snapshots.ts',
+  'src/runtime/status-worker.ts',
+];
+
+const requiredPackFiles = [
+  'LICENSE',
+  'README.md',
+  'package.json',
+  ...requiredRootFiles,
+  ...requiredScriptFiles,
+  ...requiredSourceFiles,
 ];
 
 const pkg = JSON.parse(fs.readFileSync(path.join(root, 'package.json'), 'utf8'));
@@ -48,19 +128,29 @@ const [pack] = JSON.parse(output);
 const packedFiles = new Set((pack?.files ?? []).map((file) => file.path));
 const missing = requiredPackFiles.filter((file) => !packedFiles.has(file));
 const channelSource = fs.readFileSync(path.join(root, 'src/channel.ts'), 'utf8');
-const messagePolicySource = fs.readFileSync(path.join(root, 'src/plugin/message-policy.ts'), 'utf8');
+const messagePolicySource = fs.readFileSync(
+  path.join(root, 'src/plugin/message-policy.ts'),
+  'utf8',
+);
 const messageSendSource = fs.readFileSync(path.join(root, 'src/plugin/message-send.ts'), 'utf8');
 const channelMessageChecks = {
   registered: channelSource.includes('message: {'),
-  text: channelSource.includes('createBncrMessageSend') && messageSendSource.includes('channelMessageSendText'),
-  media: channelSource.includes('createBncrMessageSend') && messageSendSource.includes('channelMessageSendMedia'),
-  payload: channelSource.includes('createBncrMessageSend') && messageSendSource.includes('channelMessageSendPayload'),
+  text:
+    channelSource.includes('createBncrMessageSend') &&
+    messageSendSource.includes('channelMessageSendText'),
+  media:
+    channelSource.includes('createBncrMessageSend') &&
+    messageSendSource.includes('channelMessageSendMedia'),
+  payload:
+    channelSource.includes('createBncrMessageSend') &&
+    messageSendSource.includes('channelMessageSendPayload'),
   manualAck:
     channelSource.includes('BNCR_MESSAGE_RECEIVE_POLICY') &&
     messagePolicySource.includes("defaultAckPolicy: 'manual'") &&
     messagePolicySource.includes("supportedAckPolicies: ['manual']"),
   genericActionsPreserved: channelSource.includes('actions: messageActions'),
-  noDurableFinal: !channelSource.includes('durableFinal:') && !messagePolicySource.includes('durableFinal:'),
+  noDurableFinal:
+    !channelSource.includes('durableFinal:') && !messagePolicySource.includes('durableFinal:'),
 };
 const channelMessageOk = Object.values(channelMessageChecks).every(Boolean);
 

package/scripts/check-register-drift.mjs

@@ -1,39 +1,48 @@
 import { execFileSync } from 'node:child_process';
+import { fileURLToPath } from 'node:url';
 
 const readNumber = (value, fallback) => {
   const n = Number(value);
   return Number.isFinite(n) ? n : fallback;
 };
 
-const args = process.argv.slice(2);
-const options = {
+const readText = (value, fallback) => {
+  const text = String(value ?? '').trim();
+  return text || fallback;
+};
+
+const DEFAULT_OPTIONS = {
   durationSec: 300,
   intervalSec: 15,
   accountId: 'Primary',
   gatewayBin: 'openclaw',
 };
 
-for (let i = 0; i < args.length; i += 1) {
-  const arg = args[i];
-  if (arg === '--duration-sec') options.durationSec = readNumber(args[++i], options.durationSec);
-  else if (arg === '--interval-sec')
-    options.intervalSec = readNumber(args[++i], options.intervalSec);
-  else if (arg === '--account-id') options.accountId = args[++i] || options.accountId;
-  else if (arg === '--gateway-bin') options.gatewayBin = args[++i] || options.gatewayBin;
-  else if (arg === '--help' || arg === '-h') {
-    console.log(
-      'Usage: node ./scripts/check-register-drift.mjs [--duration-sec 300] [--interval-sec 15] [--account-id Primary] [--gateway-bin openclaw]\n\nSamples bncr.diagnostics over time and reports whether register counters drift after warmup.',
-    );
-    process.exit(0);
+export function parseCheckRegisterDriftOptions(args, defaults = DEFAULT_OPTIONS) {
+  const options = { ...defaults };
+
+  for (let i = 0; i < args.length; i += 1) {
+    const arg = args[i];
+    if (arg === '--duration-sec') options.durationSec = readNumber(args[++i], options.durationSec);
+    else if (arg === '--interval-sec')
+      options.intervalSec = readNumber(args[++i], options.intervalSec);
+    else if (arg === '--account-id') options.accountId = readText(args[++i], options.accountId);
+    else if (arg === '--gateway-bin') options.gatewayBin = readText(args[++i], options.gatewayBin);
+    else if (arg === '--help' || arg === '-h') options.help = true;
   }
+
+  return options;
 }
 
-if (options.durationSec <= 0) throw new Error('durationSec must be > 0');
-if (options.intervalSec <= 0) throw new Error('intervalSec must be > 0');
+const printHelp = () => {
+  console.log(
+    'Usage: node ./scripts/check-register-drift.mjs [--duration-sec 300] [--interval-sec 15] [--account-id Primary] [--gateway-bin openclaw]\n\nSamples bncr.diagnostics over time and reports whether register counters drift after warmup.',
+  );
+};
 
 const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
 
-const fetchDiagnostics = () => {
+const fetchDiagnostics = (options) => {
   const raw = execFileSync(
     options.gatewayBin,
     [
@@ -63,55 +72,72 @@ const fetchDiagnostics = () => {
   };
 };
 
-const startedAt = Date.now();
-const samples = [];
-const deadline = startedAt + options.durationSec * 1000;
+export async function runCheckRegisterDrift(options) {
+  if (options.durationSec <= 0) throw new Error('durationSec must be > 0');
+  if (options.intervalSec <= 0) throw new Error('intervalSec must be > 0');
+
+  const startedAt = Date.now();
+  const samples = [];
+  const deadline = startedAt + options.durationSec * 1000;
+
+  while (true) {
+    const sample = fetchDiagnostics(options);
+    samples.push(sample);
+    const nextAt = Date.now() + options.intervalSec * 1000;
+    if (nextAt > deadline) break;
+    await sleep(Math.max(0, nextAt - Date.now()));
+  }
 
-while (true) {
-  const sample = fetchDiagnostics();
-  samples.push(sample);
-  const nextAt = Date.now() + options.intervalSec * 1000;
-  if (nextAt > deadline) break;
-  await sleep(Math.max(0, nextAt - Date.now()));
+  const first = samples[0] || {};
+  const last = samples[samples.length - 1] || {};
+  const deltaRegisterCount = (last.registerCount ?? 0) - (first.registerCount ?? 0);
+  const deltaApiGeneration = (last.apiGeneration ?? 0) - (first.apiGeneration ?? 0);
+  const deltaPostWarmupRegisterCount =
+    (last.postWarmupRegisterCount ?? 0) - (first.postWarmupRegisterCount ?? 0);
+  const historicalWarmupExternalDrift = Boolean(first.unexpectedRegisterAfterWarmup);
+  const newWarmupExternalDriftDuringWindow = deltaPostWarmupRegisterCount > 0;
+  const newDriftDuringWindow =
+    deltaRegisterCount > 0 || deltaApiGeneration > 0 || newWarmupExternalDriftDuringWindow;
+  const driftDetected = historicalWarmupExternalDrift || newDriftDuringWindow;
+
+  return {
+    ok: true,
+    accountId: options.accountId,
+    durationSec: options.durationSec,
+    intervalSec: options.intervalSec,
+    startedAt,
+    endedAt: Date.now(),
+    sampleCount: samples.length,
+    first,
+    last,
+    delta: {
+      registerCount: deltaRegisterCount,
+      apiGeneration: deltaApiGeneration,
+      postWarmupRegisterCount: deltaPostWarmupRegisterCount,
+    },
+    historicalWarmupExternalDrift,
+    newWarmupExternalDriftDuringWindow,
+    newDriftDuringWindow,
+    driftDetected,
+    conclusion: newDriftDuringWindow
+      ? 'new register drift was observed during this sampling window'
+      : historicalWarmupExternalDrift
+        ? 'no new drift during this window, but warmup-external drift had already happened before sampling began'
+        : 'register counters stayed stable during this window and no warmup-external drift was flagged',
+    samples,
+  };
 }
 
-const first = samples[0] || {};
-const last = samples[samples.length - 1] || {};
-const deltaRegisterCount = (last.registerCount ?? 0) - (first.registerCount ?? 0);
-const deltaApiGeneration = (last.apiGeneration ?? 0) - (first.apiGeneration ?? 0);
-const deltaPostWarmupRegisterCount =
-  (last.postWarmupRegisterCount ?? 0) - (first.postWarmupRegisterCount ?? 0);
-const historicalWarmupExternalDrift = Boolean(first.unexpectedRegisterAfterWarmup);
-const newWarmupExternalDriftDuringWindow = deltaPostWarmupRegisterCount > 0;
-const newDriftDuringWindow =
-  deltaRegisterCount > 0 || deltaApiGeneration > 0 || newWarmupExternalDriftDuringWindow;
-const driftDetected = historicalWarmupExternalDrift || newDriftDuringWindow;
-
-const result = {
-  ok: true,
-  accountId: options.accountId,
-  durationSec: options.durationSec,
-  intervalSec: options.intervalSec,
-  startedAt,
-  endedAt: Date.now(),
-  sampleCount: samples.length,
-  first,
-  last,
-  delta: {
-    registerCount: deltaRegisterCount,
-    apiGeneration: deltaApiGeneration,
-    postWarmupRegisterCount: deltaPostWarmupRegisterCount,
-  },
-  historicalWarmupExternalDrift,
-  newWarmupExternalDriftDuringWindow,
-  newDriftDuringWindow,
-  driftDetected,
-  conclusion: newDriftDuringWindow
-    ? 'new register drift was observed during this sampling window'
-    : historicalWarmupExternalDrift
-      ? 'no new drift during this window, but warmup-external drift had already happened before sampling began'
-      : 'register counters stayed stable during this window and no warmup-external drift was flagged',
-  samples,
-};
+async function main() {
+  const options = parseCheckRegisterDriftOptions(process.argv.slice(2));
+  if (options.help) {
+    printHelp();
+    return;
+  }
+
+  console.log(JSON.stringify(await runCheckRegisterDrift(options), null, 2));
+}
 
-console.log(JSON.stringify(result, null, 2));
+if (process.argv[1] && fileURLToPath(import.meta.url) === process.argv[1]) {
+  await main();
+}

package/scripts/selfcheck.mjs

@@ -8,36 +8,104 @@ const __dirname = path.dirname(__filename);
 const root = path.resolve(__dirname, '..');
 const require = createRequire(import.meta.url);
 
-const requiredFiles = [
-  'index.ts',
-  'openclaw.plugin.json',
+const requiredRootFiles = ['index.ts', 'openclaw.plugin.json'];
+
+const requiredSourceFiles = [
   'src/channel.ts',
   'src/core/types.ts',
   'src/core/accounts.ts',
+  'src/core/connection-capability.ts',
+  'src/core/connection-reachability.ts',
+  'src/core/dead-letter-diagnostics.ts',
+  'src/core/diagnostic-counters.ts',
+  'src/core/diagnostics.ts',
+  'src/core/downlink-health.ts',
+  'src/core/extended-diagnostics.ts',
+  'src/core/file-ack.ts',
+  'src/core/file-transfer-payloads.ts',
+  'src/core/lease-state.ts',
+  'src/core/logging.ts',
+  'src/core/outbox-enqueue.ts',
+  'src/core/outbox-entry-builders.ts',
+  'src/core/outbox-file-transfer-bookkeeping.ts',
+  'src/core/outbox-file-transfer-failure.ts',
+  'src/core/outbox-file-transfer-guards.ts',
+  'src/core/outbox-file-transfer-prep.ts',
+  'src/core/outbox-file-transfer-success.ts',
+  'src/core/outbox-push-args.ts',
+  'src/core/outbox-queue.ts',
+  'src/core/outbox-summary.ts',
+  'src/core/outbox-text-push-failure.ts',
+  'src/core/outbox-text-push-guards.ts',
+  'src/core/outbox-text-push-prep.ts',
+  'src/core/outbox-text-push-success.ts',
+  'src/core/persisted-outbox-entry.ts',
   'src/core/targets.ts',
   'src/core/status.ts',
+  'src/core/status-meta.ts',
   'src/core/probe.ts',
   'src/core/config-schema.ts',
   'src/core/policy.ts',
   'src/core/permissions.ts',
+  'src/core/register-trace.ts',
+  'src/messaging/inbound/commands.ts',
+  'src/messaging/inbound/context-facts.ts',
   'src/messaging/inbound/parse.ts',
   'src/messaging/inbound/gate.ts',
   'src/messaging/inbound/dispatch.ts',
+  'src/messaging/inbound/last-route.ts',
+  'src/messaging/inbound/native-command.ts',
+  'src/messaging/inbound/native-reply-delivery.ts',
+  'src/messaging/inbound/reply-config.ts',
+  'src/messaging/inbound/runtime-compat.ts',
+  'src/messaging/inbound/session-label.ts',
   'src/messaging/outbound/send.ts',
   'src/messaging/outbound/media.ts',
   'src/messaging/outbound/actions.ts',
+  'src/messaging/outbound/build-send-action.ts',
+  'src/messaging/outbound/diagnostics.ts',
   'src/messaging/outbound/durable-message-adapter.ts',
   'src/messaging/outbound/durable-queue-adapter.ts',
+  'src/messaging/outbound/media-dedupe.ts',
+  'src/messaging/outbound/queue-selectors.ts',
+  'src/messaging/outbound/reasons.ts',
+  'src/messaging/outbound/reply-enqueue.ts',
+  'src/messaging/outbound/reply-target-policy.ts',
+  'src/messaging/outbound/retry-policy.ts',
+  'src/messaging/outbound/send-params.ts',
+  'src/messaging/outbound/session-route.ts',
+  'src/messaging/outbound/target-resolver.ts',
   'src/openclaw/config-runtime.ts',
   'src/openclaw/inbound-session-runtime.ts',
   'src/openclaw/ingress-runtime.ts',
   'src/openclaw/media-runtime.ts',
   'src/openclaw/reply-runtime.ts',
   'src/openclaw/routing-runtime.ts',
+  'src/openclaw/runtime-surface.ts',
   'src/openclaw/sdk-helpers.ts',
   'src/openclaw/session-route-runtime.ts',
+  'src/plugin/capabilities.ts',
+  'src/plugin/config.ts',
+  'src/plugin/gateway-methods.ts',
+  'src/plugin/gateway-runtime.ts',
+  'src/plugin/message-policy.ts',
+  'src/plugin/message-send.ts',
+  'src/plugin/messaging.ts',
+  'src/plugin/meta.ts',
+  'src/plugin/outbound.ts',
+  'src/plugin/setup.ts',
+  'src/plugin/status.ts',
+  'src/runtime/log-dedupe.ts',
+  'src/runtime/outbound-ack-timeout.ts',
+  'src/runtime/outbound-flags.ts',
+  'src/runtime/outbox-transitions.ts',
+  'src/runtime/register-trace-runtime.ts',
+  'src/runtime/status-snapshots.ts',
+  'src/runtime/status-worker.ts',
 ];
 
+const requiredFiles = [...requiredRootFiles, ...requiredSourceFiles];
+
 const readPackageVersion = () => {
   const pkgPath = path.join(root, 'package.json');
   const raw = fs.readFileSync(pkgPath, 'utf8');
@@ -46,12 +114,20 @@ const readPackageVersion = () => {
 };
 
 const requiredOpenClawSdkSubpaths = [
+  'openclaw/plugin-sdk',
+  'openclaw/plugin-sdk/boolean-param',
   'openclaw/plugin-sdk/channel-outbound',
+  'openclaw/plugin-sdk/channel-ingress-runtime',
   'openclaw/plugin-sdk/channel-message',
   'openclaw/plugin-sdk/routing',
   'openclaw/plugin-sdk/conversation-runtime',
   'openclaw/plugin-sdk/session-store-runtime',
   'openclaw/plugin-sdk/core',
+  'openclaw/plugin-sdk/json-store',
+  'openclaw/plugin-sdk/param-readers',
+  'openclaw/plugin-sdk/security-runtime',
+  'openclaw/plugin-sdk/status-helpers',
+  'openclaw/plugin-sdk/tool-send',
 ];
 
 const resolveOpenClawSdkSubpaths = () => {