blun-king-cli 9.1.476 → 9.1.477

package/bin/agent-api-service-process.mjs

@@ -0,0 +1,171 @@
+import path from 'node:path';
+import { pathToFileURL } from 'node:url';
+
+import { startAgentApiServiceFromEnvironment } from './agent-api-service-environment.mjs';
+
+function requireProcessLike(value) {
+  if (value === null
+    || typeof value !== 'object'
+    || typeof value.on !== 'function'
+    || typeof value.removeListener !== 'function') {
+    throw new TypeError('processLike must provide on and removeListener');
+  }
+  return value;
+}
+
+function requireFunction(value, label) {
+  if (typeof value !== 'function') {
+    throw new TypeError(`${label} must be a function`);
+  }
+  return value;
+}
+
+function copyAddress(value) {
+  if (value === null
+    || typeof value !== 'object'
+    || typeof value.address !== 'string'
+    || typeof value.family !== 'string'
+    || !Number.isInteger(value.port)) {
+    throw new TypeError('Agent API service must provide a network address');
+  }
+  return Object.freeze({
+    address: value.address,
+    family: value.family,
+    port: value.port,
+  });
+}
+
+async function runAgentApiServiceProcess(options = {}) {
+  const processLike = requireProcessLike(
+    options.processLike === undefined ? process : options.processLike,
+  );
+  const startService = requireFunction(
+    options.startService === undefined
+      ? startAgentApiServiceFromEnvironment
+      : options.startService,
+    'startService',
+  );
+  const writeStdout = requireFunction(
+    options.writeStdout === undefined
+      ? (value) => process.stdout.write(value)
+      : options.writeStdout,
+    'writeStdout',
+  );
+  const writeStderr = requireFunction(
+    options.writeStderr === undefined
+      ? (value) => process.stderr.write(value)
+      : options.writeStderr,
+    'writeStderr',
+  );
+
+  let running;
+  let requestedSignal;
+  let shutdownPromise;
+  let resolveClosed;
+  let rejectClosed;
+  const closed = new Promise((resolve, reject) => {
+    resolveClosed = resolve;
+    rejectClosed = reject;
+  });
+  closed.catch(() => {});
+
+  function removeSignalHandlers() {
+    processLike.removeListener('SIGINT', onSigint);
+    processLike.removeListener('SIGTERM', onSigterm);
+  }
+
+  function beginShutdown(signal) {
+    if (shutdownPromise !== undefined) return shutdownPromise;
+    removeSignalHandlers();
+    shutdownPromise = (async () => {
+      try {
+        await running.close();
+        if (signal !== undefined) {
+          processLike.exitCode = 0;
+          writeStdout(`Agent API service stopped after ${signal}.\n`);
+        }
+        resolveClosed();
+      } catch (error) {
+        if (signal !== undefined) {
+          processLike.exitCode = 1;
+          writeStderr('Agent API service shutdown failed.\n');
+        }
+        rejectClosed(error);
+        throw error;
+      }
+    })();
+    return shutdownPromise;
+  }
+
+  function requestShutdown(signal) {
+    if (requestedSignal !== undefined) return;
+    requestedSignal = signal;
+    if (running !== undefined) {
+      void beginShutdown(signal).catch(() => {});
+    }
+  }
+
+  function onSigint() {
+    requestShutdown('SIGINT');
+  }
+
+  function onSigterm() {
+    requestShutdown('SIGTERM');
+  }
+
+  processLike.on('SIGINT', onSigint);
+  processLike.on('SIGTERM', onSigterm);
+
+  try {
+    running = await startService({
+      env: options.env === undefined ? process.env : options.env,
+    });
+    if (running === null
+      || typeof running !== 'object'
+      || typeof running.close !== 'function') {
+      throw new TypeError('Agent API service must provide close');
+    }
+    const address = copyAddress(running.address);
+    if (requestedSignal !== undefined) {
+      void beginShutdown(requestedSignal).catch(() => {});
+    } else {
+      writeStdout(`Agent API service listening on ${address.address}:${address.port}.\n`);
+    }
+    return Object.freeze({
+      address,
+      close() {
+        return beginShutdown();
+      },
+      closed,
+    });
+  } catch (error) {
+    removeSignalHandlers();
+    if (running !== undefined
+      && typeof running?.close === 'function'
+      && shutdownPromise === undefined) {
+      try {
+        await running.close();
+      } catch {
+        // The startup error remains the actionable failure.
+      }
+    }
+    rejectClosed(error);
+    throw error;
+  }
+}
+
+function isDirectExecution() {
+  if (typeof process.argv[1] !== 'string' || process.argv[1].length === 0) return false;
+  return pathToFileURL(path.resolve(process.argv[1])).href === import.meta.url;
+}
+
+if (isDirectExecution()) {
+  runAgentApiServiceProcess().catch(() => {
+    process.exitCode = 1;
+    process.stderr.write('Agent API service failed to start.\n');
+  });
+}
+
+export {
+  runAgentApiServiceProcess,
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "blun-king-cli",
-  "version": "9.1.476",
+  "version": "9.1.477",
   "description": "BLUN CLI - your own AI agent with a Telegram channel. Get it done. With BLUN.",
   "license": "MIT",
   "bin": {