@dexto/server 1.4.0 → 1.5.0

package/dist/hono/start-server.d.ts

@@ -0,0 +1,61 @@
+import type { Server } from 'node:http';
+import type { DextoAgent, AgentCard } from '@dexto/core';
+import type { DextoApp } from './types.js';
+import type { WebUIRuntimeConfig } from './routes/static.js';
+export type StartDextoServerOptions = {
+    /** Port to listen on. Defaults to 3000 or process.env.PORT */
+    port?: number;
+    /** Hostname to bind to. Defaults to 0.0.0.0 */
+    hostname?: string;
+    /** Override agent card metadata (name, version, etc.) */
+    agentCard?: Partial<AgentCard>;
+    /** Absolute path to WebUI build output. If provided, static files will be served. */
+    webRoot?: string;
+    /** Runtime configuration to inject into WebUI (analytics, etc.) */
+    webUIConfig?: WebUIRuntimeConfig;
+    /** Base URL for agent card. Defaults to http://localhost:{port} */
+    baseUrl?: string;
+};
+export type StartDextoServerResult = {
+    /** HTTP server instance */
+    server: Server;
+    /** Hono app instance */
+    app: DextoApp;
+    /** Stop the server and agent gracefully */
+    stop: () => Promise<void>;
+    /** Agent card with resolved metadata */
+    agentCard: AgentCard;
+};
+/**
+ * Start a Dexto server with minimal configuration.
+ *
+ * This is a high-level helper that:
+ * 1. Creates event subscribers and approval coordinator
+ * 2. Creates and configures the Hono app
+ * 3. Wires up all the infrastructure (SSE, webhooks, approvals)
+ * 4. Starts the agent
+ * 5. Starts the HTTP server
+ *
+ * @example
+ * ```typescript
+ * // Register providers (filesystem-tools, process-tools, etc.)
+ * import '@dexto/image-local';
+ *
+ * import { DextoAgent } from '@dexto/core';
+ * import { loadAgentConfig } from '@dexto/agent-management';
+ * import { startDextoServer } from '@dexto/server';
+ *
+ * const config = await loadAgentConfig('./agents/default.yml');
+ * const agent = new DextoAgent(config, './agents/default.yml');
+ *
+ * const { server, stop } = await startDextoServer(agent, {
+ *   port: 3000,
+ *   agentCard: { name: 'My Agent' }
+ * });
+ *
+ * // Server is now running at http://localhost:3000
+ * // To stop: await stop();
+ * ```
+ */
+export declare function startDextoServer(agent: DextoAgent, options?: StartDextoServerOptions): Promise<StartDextoServerResult>;
+//# sourceMappingURL=start-server.d.ts.map

package/dist/hono/start-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"start-server.d.ts","sourceRoot":"","sources":["../../src/hono/start-server.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAExC,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAIzD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAM7D,MAAM,MAAM,uBAAuB,GAAG;IAClC,8DAA8D;IAC9D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yDAAyD;IACzD,SAAS,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;IAC/B,qFAAqF;IACrF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mEAAmE;IACnE,WAAW,CAAC,EAAE,kBAAkB,CAAC;IACjC,mEAAmE;IACnE,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACjC,2BAA2B;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,wBAAwB;IACxB,GAAG,EAAE,QAAQ,CAAC;IACd,2CAA2C;IAC3C,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,wCAAwC;IACxC,SAAS,EAAE,SAAS,CAAC;CACxB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAsB,gBAAgB,CAClC,KAAK,EAAE,UAAU,EACjB,OAAO,GAAE,uBAA4B,GACtC,OAAO,CAAC,sBAAsB,CAAC,CA2FjC"}

package/dist/hono/start-server.js

@@ -0,0 +1,78 @@
+import { createAgentCard, logger } from "@dexto/core";
+import { createDextoApp } from "./index.js";
+import { createNodeServer } from "./node/index.js";
+import { WebhookEventSubscriber } from "../events/webhook-subscriber.js";
+import { A2ASseEventSubscriber } from "../events/a2a-sse-subscriber.js";
+import { ApprovalCoordinator } from "../approval/approval-coordinator.js";
+import { createManualApprovalHandler } from "../approval/manual-approval-handler.js";
+async function startDextoServer(agent, options = {}) {
+  const {
+    port: requestedPort,
+    hostname = "0.0.0.0",
+    agentCard: agentCardOverride = {},
+    webRoot,
+    webUIConfig,
+    baseUrl: baseUrlOverride
+  } = options;
+  const resolvedPort = requestedPort ?? (process.env.PORT ? Number(process.env.PORT) : 3e3);
+  const baseUrl = baseUrlOverride ?? `http://localhost:${resolvedPort}`;
+  logger.info(`Initializing Dexto server on ${hostname}:${resolvedPort}...`);
+  const agentCard = createAgentCard(
+    {
+      defaultName: agentCardOverride.name ?? "dexto-agent",
+      defaultVersion: agentCardOverride.version ?? "1.0.0",
+      defaultBaseUrl: baseUrl
+    },
+    agentCardOverride
+  );
+  logger.debug("Creating event infrastructure...");
+  const webhookSubscriber = new WebhookEventSubscriber();
+  const sseSubscriber = new A2ASseEventSubscriber();
+  const approvalCoordinator = new ApprovalCoordinator();
+  logger.debug("Creating Hono application...");
+  const app = createDextoApp({
+    getAgent: (_ctx) => agent,
+    getAgentCard: () => agentCard,
+    approvalCoordinator,
+    webhookSubscriber,
+    sseSubscriber,
+    ...webRoot ? { webRoot } : {},
+    ...webUIConfig ? { webUIConfig } : {}
+  });
+  logger.debug("Creating Node.js HTTP server...");
+  const { server, webhookSubscriber: bridgeWebhookSubscriber } = createNodeServer(app, {
+    getAgent: () => agent,
+    port: resolvedPort,
+    hostname
+  });
+  if (bridgeWebhookSubscriber) {
+    logger.debug("Registering webhook subscriber with agent...");
+    agent.registerSubscriber(bridgeWebhookSubscriber);
+  }
+  const needsHandler = agent.config.toolConfirmation?.mode === "manual" || agent.config.elicitation.enabled;
+  if (needsHandler) {
+    logger.debug("Setting up manual approval handler...");
+    const handler = createManualApprovalHandler(approvalCoordinator);
+    agent.setApprovalHandler(handler);
+  }
+  logger.debug("Wiring event subscribers to agent...");
+  webhookSubscriber.subscribe(agent.agentEventBus);
+  sseSubscriber.subscribe(agent.agentEventBus);
+  logger.info("Starting agent...");
+  await agent.start();
+  logger.info(`Server running at http://${hostname}:${resolvedPort}`, null, "green");
+  return {
+    server,
+    app,
+    agentCard,
+    stop: async () => {
+      logger.info("Stopping Dexto server...");
+      await agent.stop();
+      server.close();
+      logger.info("Server stopped", null, "yellow");
+    }
+  };
+}
+export {
+  startDextoServer
+};

package/dist/index.cjs

@@ -17,6 +17,7 @@ var index_exports = {};
 module.exports = __toCommonJS(index_exports);
 __reExport(index_exports, require("./hono/index.js"), module.exports);
 __reExport(index_exports, require("./hono/node/index.js"), module.exports);
+__reExport(index_exports, require("./hono/start-server.js"), module.exports);
 __reExport(index_exports, require("./events/webhook-subscriber.js"), module.exports);
 __reExport(index_exports, require("./events/a2a-sse-subscriber.js"), module.exports);
 __reExport(index_exports, require("./events/webhook-types.js"), module.exports);
@@ -28,6 +29,7 @@ __reExport(index_exports, require("./approval/approval-coordinator.js"), module.
 0 && (module.exports = {
   ...require("./hono/index.js"),
   ...require("./hono/node/index.js"),
+  ...require("./hono/start-server.js"),
   ...require("./events/webhook-subscriber.js"),
   ...require("./events/a2a-sse-subscriber.js"),
   ...require("./events/webhook-types.js"),

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 export * from './hono/index.js';
 export * from './hono/node/index.js';
+export * from './hono/start-server.js';
 export type { DextoApp } from './hono/types.js';
 export * from './events/webhook-subscriber.js';
 export * from './events/a2a-sse-subscriber.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC;AACrC,YAAY,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAChD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uCAAuC,CAAC;AACtD,cAAc,oCAAoC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,YAAY,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAChD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uCAAuC,CAAC;AACtD,cAAc,oCAAoC,CAAC"}

package/dist/index.js

@@ -1,5 +1,6 @@
 export * from "./hono/index.js";
 export * from "./hono/node/index.js";
+export * from "./hono/start-server.js";
 export * from "./events/webhook-subscriber.js";
 export * from "./events/a2a-sse-subscriber.js";
 export * from "./events/webhook-types.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dexto/server",
-  "version": "1.4.0",
+  "version": "1.5.0",
   "private": false,
   "type": "module",
   "main": "./dist/index.cjs",
@@ -30,9 +30,10 @@
     "hono": "^4.6.8",
     "ws": "^8.18.1",
     "yaml": "^2.7.1",
-    "@modelcontextprotocol/sdk": "^1.17.2",
-    "@dexto/agent-management": "1.4.0",
-    "@dexto/core": "1.4.0"
+    "@modelcontextprotocol/sdk": "^1.25.2",
+    "@dexto/agent-management": "1.5.0",
+    "@dexto/core": "1.5.0",
+    "@dexto/image-local": "1.5.0"
   },
   "files": [
     "dist",