Function startServer

src/runtime/server.ts:59–390

(options: ServerOptions)

 * Express + WS, and loads adapters (Web always, IM adapters if configured).
 */
export async function startServer(options: ServerOptions): Promise<void> {
  const {
    rootDir,
    host = process.env.HOST || "127.0.0.1",
    port = Number(process.env.PORT) || 26313,
    runtimeMode = process.env.SKILLPACK_RUNTIME_MODE === "embedded"
      ? "embedded"
      : "standalone",
  } = options;

  // ---------------------------------------------------------------------------
  // Read runtime configuration: data/config.json first, env vars override
  // ---------------------------------------------------------------------------

  const dataConfig = configManager.load(rootDir);
  const apiKey = dataConfig.apiKey || "";
  const provider = dataConfig.provider || "openai";
  const canonicalRootDir = canonicalizeDir(rootDir);
  const packConfig = loadPackConfig(canonicalRootDir);
  const baseUrl = dataConfig.baseUrl?.trim() || undefined;

  const modelId =
    dataConfig.modelId?.trim() ||
    (SUPPORTED_PROVIDERS[provider]?.defaultModelId ?? SUPPORTED_PROVIDERS.openai.defaultModelId);
  const apiProtocol = dataConfig.apiProtocol;
  const reasoning = dataConfig.reasoning;

  // ---------------------------------------------------------------------------
  // Create Express app & HTTP server
  // ---------------------------------------------------------------------------

  // Resolve web directory: prefer rootDir/web, fallback to package-distributed web/
  const packageRoot = path.resolve(__dirname, "..");
  const webDir = fs.existsSync(path.join(rootDir, "web"))
    ? path.join(rootDir, "web")
    : path.join(packageRoot, "web");

  const app = express();
  app.use(express.json());
  app.use(express.static(webDir));

  const server = createServer(app);
  app.get("/api/health", (_req, res) => {
    const address = server.address();
    const actualPort = typeof address === "string" ? port : (address?.port ?? port);
    res.json({
      status: "ok",
      dir: canonicalRootDir,
      name: packConfig.name,
      version: packConfig.version,
      port: actualPort,
      pid: process.pid,
    });
  });

  const lifecycle = new Lifecycle(server);

  // ---------------------------------------------------------------------------