@band-ai/sdk 0.1.2

package/dist/index.d.cts

@@ -0,0 +1,63 @@
+import { F as FrameworkAdapter } from './protocols-CInhtFpA.cjs';
+export { A as AdapterToolsProtocol, a as AgentToolsProtocol, C as ContactTools, b as FrameworkAdapterInput, H as HistoryConverter, M as MemoryTools, c as MessagingTools, P as ParticipantTools, d as PeerLookupTools, e as Preprocessor, R as RoomParticipantTools, T as ToolExecutor, f as ToolSchemaProvider } from './protocols-CInhtFpA.cjs';
+import { AgentCredentials } from './config.cjs';
+export { AgentConfigResult, LoadAgentConfigFromEnvOptions, loadAgentConfig, loadAgentConfigFromEnv } from './config.cjs';
+import { P as PlatformRuntime, a as PlatformRuntimeOptions } from './schemas-BpEBkq5V.cjs';
+export { A as AgentRuntime, D as DefaultPreprocessor, E as ExecutionContextOptions, M as MCP_TOOL_PREFIX, T as TOOL_MODELS, b as ThenvoiLink } from './schemas-BpEBkq5V.cjs';
+import { P as PlatformMessage } from './types-CovcHpYf.cjs';
+export { A as AgentConfig, a as AgentInput, C as ContactEvent, b as ContactEventCallback, c as ContactEventConfig, d as ContactEventStrategy, e as ConversationContext, H as HistoryProvider, M as MessageHandler, f as PlatformEvent, S as SessionConfig } from './types-CovcHpYf.cjs';
+export { A as A2AAdapter, a as A2AAdapterOptions, b as A2AGatewayAdapter, c as AnthropicAdapter, d as AnthropicAdapterOptions, C as CODEX_REASONING_EFFORTS, e as CODEX_REASONING_SUMMARIES, f as CODEX_WEB_SEARCH_MODES, g as ClaudePermissionMode, h as ClaudeSDKAdapter, i as ClaudeSDKAdapterOptions, j as CodexAdapter, k as CodexAdapterConfig, l as CodexApprovalPolicy, m as CodexReasoningEffort, n as CodexReasoningSummary, o as CodexSandboxMode, p as CodexWebSearchMode, G as GeminiAdapter, q as GeminiAdapterOptions, r as GenericAdapter, s as GenericAdapterHandler, t as GoogleADKAdapter, u as GoogleADKAdapterOptions, L as LangGraphAdapter, v as LangGraphAdapterOptions, w as LangGraphGraph, x as LettaAdapter, y as LettaAdapterOptions, O as OpenAIAdapter, z as OpenAIAdapterOptions, B as OpencodeAdapter, D as OpencodeAdapterConfig, E as OpencodeApprovalMode, F as OpencodeApprovalReply, H as OpencodeQuestionMode, P as ParlantAdapter, I as ParlantAdapterOptions, T as ToolCallingModel, V as VercelAISDKAdapter, J as VercelAISDKAdapterOptions } from './CodexAdapter-BbZD-nBd.cjs';
+export { S as SimpleAdapter } from './simpleAdapter-DqhvjsGr.cjs';
+export { A as A2AAuth, a as A2AGatewayAdapterOptions } from './opencode-BBcDchcN.cjs';
+import './dtos-DUpbIu8k.cjs';
+import './logger-CABQOnlR.cjs';
+import './types-CSHFipIc.cjs';
+import './pagination-BPiys10t.cjs';
+import 'zod';
+import './customTools-BzF0IISO.cjs';
+import './backends-BnOLsG7w.cjs';
+import './claude-CwTAxhwI.cjs';
+import '@anthropic-ai/claude-agent-sdk';
+
+interface AgentCreateOptions extends Omit<PlatformRuntimeOptions, "agentId" | "apiKey" | "wsUrl" | "restUrl"> {
+    adapter: FrameworkAdapter;
+    config?: AgentCredentials;
+    agentId?: string;
+    apiKey?: string;
+    wsUrl?: string;
+    restUrl?: string;
+    shutdownTimeoutMs?: number | null;
+}
+/**
+ * Top-level handle for a Thenvoi agent.
+ *
+ * Use {@link Agent.create} to build an instance from config + adapter,
+ * then call {@link Agent.run} to connect to the platform and handle messages.
+ */
+declare class Agent {
+    private readonly platformRuntime;
+    private readonly adapter;
+    private started;
+    private startPromise;
+    private shutdownTimeoutMs;
+    constructor(runtime: PlatformRuntime, adapter: FrameworkAdapter);
+    /** Build an Agent from credentials and a framework adapter. */
+    static create(options: AgentCreateOptions): Agent;
+    get isRunning(): boolean;
+    get runtime(): PlatformRuntime;
+    start(): Promise<void>;
+    stop(timeoutMs?: number | null): Promise<boolean>;
+    runForever(): Promise<void>;
+    bootstrapRoomMessage(roomId: string, message: PlatformMessage): Promise<void>;
+    resetRoomSession(roomId: string, timeoutMs?: number): Promise<boolean>;
+    /** Start the agent, listen for messages, and block until shutdown. Registers SIGINT/SIGTERM handlers by default. */
+    run(options?: {
+        shutdownTimeoutMs?: number | null;
+        signals?: boolean;
+    }): Promise<void>;
+    withLifecycle<T>(handler: (agent: Agent) => Promise<T>): Promise<T>;
+}
+
+declare function isDirectExecution(importMetaUrl: string): boolean;
+
+export { Agent, type AgentCreateOptions, AgentCredentials, FrameworkAdapter, PlatformMessage, PlatformRuntime, PlatformRuntimeOptions, isDirectExecution };

package/dist/index.d.ts

@@ -0,0 +1,63 @@
+import { F as FrameworkAdapter } from './protocols-DrhzOH6K.js';
+export { A as AdapterToolsProtocol, a as AgentToolsProtocol, C as ContactTools, b as FrameworkAdapterInput, H as HistoryConverter, M as MemoryTools, c as MessagingTools, P as ParticipantTools, d as PeerLookupTools, e as Preprocessor, R as RoomParticipantTools, T as ToolExecutor, f as ToolSchemaProvider } from './protocols-DrhzOH6K.js';
+import { AgentCredentials } from './config.js';
+export { AgentConfigResult, LoadAgentConfigFromEnvOptions, loadAgentConfig, loadAgentConfigFromEnv } from './config.js';
+import { P as PlatformRuntime, a as PlatformRuntimeOptions } from './schemas-vos1AaBc.js';
+export { A as AgentRuntime, D as DefaultPreprocessor, E as ExecutionContextOptions, M as MCP_TOOL_PREFIX, T as TOOL_MODELS, b as ThenvoiLink } from './schemas-vos1AaBc.js';
+import { P as PlatformMessage } from './types-7jVzOeOP.js';
+export { A as AgentConfig, a as AgentInput, C as ContactEvent, b as ContactEventCallback, c as ContactEventConfig, d as ContactEventStrategy, e as ConversationContext, H as HistoryProvider, M as MessageHandler, f as PlatformEvent, S as SessionConfig } from './types-7jVzOeOP.js';
+export { A as A2AAdapter, a as A2AAdapterOptions, b as A2AGatewayAdapter, c as AnthropicAdapter, d as AnthropicAdapterOptions, C as CODEX_REASONING_EFFORTS, e as CODEX_REASONING_SUMMARIES, f as CODEX_WEB_SEARCH_MODES, g as ClaudePermissionMode, h as ClaudeSDKAdapter, i as ClaudeSDKAdapterOptions, j as CodexAdapter, k as CodexAdapterConfig, l as CodexApprovalPolicy, m as CodexReasoningEffort, n as CodexReasoningSummary, o as CodexSandboxMode, p as CodexWebSearchMode, G as GeminiAdapter, q as GeminiAdapterOptions, r as GenericAdapter, s as GenericAdapterHandler, t as GoogleADKAdapter, u as GoogleADKAdapterOptions, L as LangGraphAdapter, v as LangGraphAdapterOptions, w as LangGraphGraph, x as LettaAdapter, y as LettaAdapterOptions, O as OpenAIAdapter, z as OpenAIAdapterOptions, B as OpencodeAdapter, D as OpencodeAdapterConfig, E as OpencodeApprovalMode, F as OpencodeApprovalReply, H as OpencodeQuestionMode, P as ParlantAdapter, I as ParlantAdapterOptions, T as ToolCallingModel, V as VercelAISDKAdapter, J as VercelAISDKAdapterOptions } from './CodexAdapter-A1k_LMdZ.js';
+export { S as SimpleAdapter } from './simpleAdapter-9OE_p6QW.js';
+export { A as A2AAuth, a as A2AGatewayAdapterOptions } from './opencode-DthQQUsZ.js';
+import './dtos-DUpbIu8k.js';
+import './logger-CABQOnlR.js';
+import './types-CxII3XkA.js';
+import './pagination-CcDkVFxK.js';
+import 'zod';
+import './customTools-BzF0IISO.js';
+import './backends-C4n6cKOf.js';
+import './claude-CcnQ5OUC.js';
+import '@anthropic-ai/claude-agent-sdk';
+
+interface AgentCreateOptions extends Omit<PlatformRuntimeOptions, "agentId" | "apiKey" | "wsUrl" | "restUrl"> {
+    adapter: FrameworkAdapter;
+    config?: AgentCredentials;
+    agentId?: string;
+    apiKey?: string;
+    wsUrl?: string;
+    restUrl?: string;
+    shutdownTimeoutMs?: number | null;
+}
+/**
+ * Top-level handle for a Thenvoi agent.
+ *
+ * Use {@link Agent.create} to build an instance from config + adapter,
+ * then call {@link Agent.run} to connect to the platform and handle messages.
+ */
+declare class Agent {
+    private readonly platformRuntime;
+    private readonly adapter;
+    private started;
+    private startPromise;
+    private shutdownTimeoutMs;
+    constructor(runtime: PlatformRuntime, adapter: FrameworkAdapter);
+    /** Build an Agent from credentials and a framework adapter. */
+    static create(options: AgentCreateOptions): Agent;
+    get isRunning(): boolean;
+    get runtime(): PlatformRuntime;
+    start(): Promise<void>;
+    stop(timeoutMs?: number | null): Promise<boolean>;
+    runForever(): Promise<void>;
+    bootstrapRoomMessage(roomId: string, message: PlatformMessage): Promise<void>;
+    resetRoomSession(roomId: string, timeoutMs?: number): Promise<boolean>;
+    /** Start the agent, listen for messages, and block until shutdown. Registers SIGINT/SIGTERM handlers by default. */
+    run(options?: {
+        shutdownTimeoutMs?: number | null;
+        signals?: boolean;
+    }): Promise<void>;
+    withLifecycle<T>(handler: (agent: Agent) => Promise<T>): Promise<T>;
+}
+
+declare function isDirectExecution(importMetaUrl: string): boolean;
+
+export { Agent, type AgentCreateOptions, AgentCredentials, FrameworkAdapter, PlatformMessage, PlatformRuntime, PlatformRuntimeOptions, isDirectExecution };

package/dist/index.js

@@ -0,0 +1,198 @@
+import {
+  AnthropicAdapter,
+  CODEX_REASONING_EFFORTS,
+  CODEX_REASONING_SUMMARIES,
+  CODEX_WEB_SEARCH_MODES,
+  ClaudeSDKAdapter,
+  CodexAdapter,
+  GeminiAdapter,
+  GenericAdapter,
+  GoogleADKAdapter,
+  LangGraphAdapter,
+  LettaAdapter,
+  OpenAIAdapter,
+  OpencodeAdapter,
+  VercelAISDKAdapter
+} from "./chunk-A3TDK6GP.js";
+import "./chunk-NIAQBANR.js";
+import "./chunk-LY55KYVI.js";
+import "./chunk-5CXIMAH2.js";
+import "./chunk-EDPKUUJL.js";
+import {
+  loadAgentConfig,
+  loadAgentConfigFromEnv
+} from "./chunk-IZPV6QS6.js";
+import {
+  A2AAdapter,
+  A2AGatewayAdapter,
+  ParlantAdapter
+} from "./chunk-FUODYQRE.js";
+import {
+  SimpleAdapter
+} from "./chunk-AVVDPXP4.js";
+import {
+  AgentRuntime,
+  DefaultPreprocessor,
+  PlatformRuntime,
+  ThenvoiLink,
+  runWithGracefulShutdown
+} from "./chunk-6AJA2OPC.js";
+import "./chunk-INA6YZTZ.js";
+import {
+  MCP_TOOL_PREFIX,
+  TOOL_MODELS
+} from "./chunk-GVEQ3RAH.js";
+import "./chunk-SFVKOEQH.js";
+import "./chunk-SG4WLD2H.js";
+import "./chunk-ZZJRRBPQ.js";
+import "./chunk-3BKAC4OZ.js";
+import "./chunk-OD2G5LFQ.js";
+import "./chunk-YR3BOQNW.js";
+
+// src/agent/Agent.ts
+var Agent = class _Agent {
+  platformRuntime;
+  adapter;
+  started = false;
+  startPromise = null;
+  shutdownTimeoutMs = 3e4;
+  constructor(runtime, adapter) {
+    this.platformRuntime = runtime;
+    this.adapter = adapter;
+  }
+  /** Build an Agent from credentials and a framework adapter. */
+  static create(options) {
+    const {
+      adapter,
+      config,
+      agentId,
+      apiKey,
+      wsUrl,
+      restUrl,
+      shutdownTimeoutMs,
+      ...runtimeOptions
+    } = options;
+    const runtime = new PlatformRuntime({
+      ...runtimeOptions,
+      agentId: agentId ?? config?.agentId ?? "",
+      apiKey: apiKey ?? config?.apiKey ?? "",
+      ...wsUrl !== void 0 || config?.wsUrl !== void 0 ? { wsUrl: wsUrl ?? config?.wsUrl } : {},
+      ...restUrl !== void 0 || config?.restUrl !== void 0 ? { restUrl: restUrl ?? config?.restUrl } : {}
+    });
+    const agent = new _Agent(runtime, adapter);
+    agent.shutdownTimeoutMs = shutdownTimeoutMs === void 0 ? 3e4 : shutdownTimeoutMs;
+    return agent;
+  }
+  get isRunning() {
+    return this.started;
+  }
+  get runtime() {
+    return this.platformRuntime;
+  }
+  async start() {
+    if (this.startPromise) {
+      return this.startPromise;
+    }
+    this.startPromise = this.platformRuntime.start(this.adapter).then(() => {
+      this.started = true;
+    }).catch((error) => {
+      this.startPromise = null;
+      throw error;
+    });
+    return this.startPromise;
+  }
+  async stop(timeoutMs) {
+    if (!this.started && !this.startPromise) {
+      return true;
+    }
+    if (!this.started && this.startPromise) {
+      try {
+        await this.startPromise;
+      } catch {
+        return true;
+      }
+    }
+    try {
+      return await this.platformRuntime.stop(timeoutMs ?? void 0);
+    } finally {
+      this.started = false;
+      this.startPromise = null;
+    }
+  }
+  async runForever() {
+    await this.platformRuntime.runForever();
+  }
+  async bootstrapRoomMessage(roomId, message) {
+    await this.platformRuntime.bootstrapRoomMessage(roomId, message);
+  }
+  async resetRoomSession(roomId, timeoutMs) {
+    return await this.platformRuntime.resetRoomSession(roomId, timeoutMs);
+  }
+  /** Start the agent, listen for messages, and block until shutdown. Registers SIGINT/SIGTERM handlers by default. */
+  async run(options) {
+    if (options?.shutdownTimeoutMs !== void 0) {
+      this.shutdownTimeoutMs = options.shutdownTimeoutMs;
+    }
+    const useSignals = options?.signals ?? true;
+    if (useSignals) {
+      await runWithGracefulShutdown(this, {
+        timeoutMs: this.shutdownTimeoutMs
+      });
+    } else {
+      await this.start();
+      try {
+        await this.platformRuntime.runForever();
+      } finally {
+        await this.stop(this.shutdownTimeoutMs);
+      }
+    }
+  }
+  async withLifecycle(handler) {
+    await this.start();
+    try {
+      return await handler(this);
+    } finally {
+      await this.stop(this.shutdownTimeoutMs);
+    }
+  }
+};
+
+// src/core/isDirectExecution.ts
+import { pathToFileURL } from "url";
+function isDirectExecution(importMetaUrl) {
+  const entry = process.argv[1];
+  if (!entry) {
+    return false;
+  }
+  return importMetaUrl === pathToFileURL(entry).href;
+}
+export {
+  A2AAdapter,
+  A2AGatewayAdapter,
+  Agent,
+  AgentRuntime,
+  AnthropicAdapter,
+  CODEX_REASONING_EFFORTS,
+  CODEX_REASONING_SUMMARIES,
+  CODEX_WEB_SEARCH_MODES,
+  ClaudeSDKAdapter,
+  CodexAdapter,
+  DefaultPreprocessor,
+  GeminiAdapter,
+  GenericAdapter,
+  GoogleADKAdapter,
+  LangGraphAdapter,
+  LettaAdapter,
+  MCP_TOOL_PREFIX,
+  OpenAIAdapter,
+  OpencodeAdapter,
+  ParlantAdapter,
+  PlatformRuntime,
+  SimpleAdapter,
+  TOOL_MODELS,
+  ThenvoiLink,
+  VercelAISDKAdapter,
+  isDirectExecution,
+  loadAgentConfig,
+  loadAgentConfigFromEnv
+};