@band-ai/sdk 0.3.4 → 0.4.1

package/dist/index.d.cts

@@ -1,25 +1,27 @@
-import { F as FrameworkAdapter } from './protocols-Bz1rxcUg.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-Bz1rxcUg.cjs';
+import { F as FrameworkAdapter } from './protocols-CabgO52c.cjs';
+export { A as AdapterToolsProtocol, b as AgentToolsProtocol, C as ContactTools, c as FAILURE_EVENT_TYPE, d as FAILURE_METADATA_KEY, a as FrameworkAdapterInput, H as HistoryConverter, M as MemoryTools, e as MessagingTools, f as ParticipantTools, g as PeerLookupTools, h as Preprocessor, R as RoomParticipantTools, T as ToolExecutor, i as ToolSchemaProvider, t as toFailureEvent } from './protocols-CabgO52c.cjs';
 import { AgentCredentials } from './config.cjs';
 export { AgentConfigResult, LoadAgentConfigFromEnvOptions, loadAgentConfig, loadAgentConfigFromEnv } from './config.cjs';
-import { P as PlatformRuntime, a as PlatformRuntimeOptions } from './schemas-BgJhlqqO.cjs';
-export { A as AgentRuntime, B as BandLink, D as DefaultPreprocessor, E as ExecutionContextOptions, M as MCP_SERVER_NAME, b as MCP_TOOL_PREFIX, T as TOOL_MODELS, d as deriveDefaultRestUrl } from './schemas-BgJhlqqO.cjs';
-import { P as PlatformMessage } from './types-BNNtOXu3.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-BNNtOXu3.cjs';
-export { W as WebSocketConflictPolicy, a as WebSocketDisconnectError, b as WebSocketDisconnectReason } from './disconnectReason-IuADl6TH.cjs';
-export { C as CustomToolDef } from './customTools-BzF0IISO.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 './ClaudeSDKAdapter-Cx6zhSaG.cjs';
-export { S as SimpleAdapter } from './simpleAdapter-BpT4XbZC.cjs';
-export { A as A2AAuth, a as A2AGatewayAdapterOptions } from './opencode-2YdscIc1.cjs';
-import './dtos-B8KU_q4d.cjs';
-import './logger-CABQOnlR.cjs';
-import './types-BgYFd_Yw.cjs';
-import './pagination-DqdkQArT.cjs';
-import '@band-ai/band-sdk-core';
+import { L as Logger } from './logger-CABQOnlR.cjs';
+import { P as PlatformRuntime, a as PlatformRuntimeOptions, R as RuntimeLifecycleState } from './schemas-BKnh4fKR.cjs';
+export { A as AgentRuntime, B as BandLink, D as DefaultPreprocessor, E as ExecutionContextOptions, b as ExecutionLifecycleState, M as MCP_SERVER_NAME, c as MCP_TOOL_PREFIX, T as TOOL_MODELS, d as deriveDefaultRestUrl } from './schemas-BKnh4fKR.cjs';
+import { P as PlatformMessage } from './types-DtcOLALn.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, R as ReconnectedEvent, S as SessionConfig } from './types-DtcOLALn.cjs';
+export { W as WebSocketConflictPolicy, a as WebSocketDisconnectError, b as WebSocketDisconnectReason } from './disconnectReason-Cctmg1SN.cjs';
+export { C as CustomToolDef } from './customTools-Bfecd0mJ.cjs';
+export { A as A2AAdapter, a as A2AAdapterOptions, b as A2AGatewayAdapter, c as ACPClientAdapter, d as ACPClientAdapterBaseOptions, e as ACPClientAdapterOptions, f as ACPClientStdioOptions, g as ACPClientTcpOptions, h as ACPConfigRequest, i as ACPConfigSelections, j as AnthropicAdapter, k as AnthropicAdapterOptions, C as CODEX_REASONING_EFFORTS, l as CODEX_REASONING_SUMMARIES, m as CODEX_WEB_SEARCH_MODES, n as ClaudePermissionMode, o as ClaudeSDKAdapter, p as ClaudeSDKAdapterOptions, q as CodexAdapter, r as CodexAdapterConfig, s as CodexApprovalPolicy, t as CodexReasoningEffort, u as CodexReasoningSummary, v as CodexSandboxMode, w as CodexWebSearchMode, x as CopilotACPAdapter, y as CopilotACPAdapterOptions, z as CopilotACPStdioOptions, B as CopilotACPTcpOptions, D as DEFAULT_COPILOT_ACP_COMMAND, E as DEFAULT_OMP_ACP_COMMAND, G as GeminiAdapter, F as GeminiAdapterOptions, H as GenericAdapter, I as GenericAdapterHandler, J as GoogleADKAdapter, K as GoogleADKAdapterOptions, L as LangGraphAdapter, M as LangGraphAdapterOptions, N as LangGraphGraph, O as LettaAdapter, P as LettaAdapterOptions, Q as OmpACPAdapter, R as OmpACPAdapterOptions, S as OpenAIAdapter, T as OpenAIAdapterOptions, U as OpencodeAdapter, V as OpencodeAdapterConfig, W as OpencodeApprovalMode, X as OpencodeApprovalReply, Y as OpencodeQuestionMode, Z as ParlantAdapter, _ as ParlantAdapterOptions, $ as ToolCallingModel, a0 as VercelAISDKAdapter, a1 as VercelAISDKAdapterOptions } from './CopilotACPAdapter-Clid9xGR.cjs';
+export { S as SimpleAdapter } from './simpleAdapter-D75rcz9n.cjs';
+export { A as A2AAuth, a as A2AGatewayAdapterOptions } from './acp-client-D-I_5lK-.cjs';
+export { AgentFailure } from '@band-ai/band-sdk-core';
+export { DeliveryFailedError, ProviderTurnFailedError, RecoverableTurnError, agentFailure, deliverReply, reportTurnFailure } from './core.cjs';
+import './dtos-CjQsN1_h.cjs';
+import './types-42-HWeX8.cjs';
+import './pagination-BZDhB_nO.cjs';
 import 'zod';
-import './backends-ZLxmQrTZ.cjs';
-import './sdk-BTciSLRQ.cjs';
+import './backends-Dh2WXcHQ.cjs';
+import './sdk-CXNqzoY1.cjs';
 import '@anthropic-ai/claude-agent-sdk';
+import '@agentclientprotocol/sdk';
 
 interface AgentCreateOptions extends Omit<PlatformRuntimeOptions, "agentId" | "apiKey" | "wsUrl" | "restUrl"> {
     adapter: FrameworkAdapter;
@@ -39,16 +41,53 @@ interface AgentCreateOptions extends Omit<PlatformRuntimeOptions, "agentId" | "a
 declare class Agent {
     private readonly platformRuntime;
     private readonly adapter;
-    private started;
-    private startPromise;
+    private readonly lifecycle;
+    private readonly logger;
+    private readonly startGate;
+    private readonly stopGate;
     private shutdownTimeoutMs;
-    constructor(runtime: PlatformRuntime, adapter: FrameworkAdapter);
+    constructor(runtime: PlatformRuntime, adapter: FrameworkAdapter, logger?: Logger);
     /** Build an Agent from credentials and a framework adapter. */
     static create(options: AgentCreateOptions): Agent;
+    /**
+     * Whether the agent is currently started.
+     *
+     * `false` while a `start()` call is still in flight — it only turns `true`
+     * once that call has resolved — and `false` again once the agent is stopped.
+     *
+     * @deprecated Read {@link Agent.state} instead, which also distinguishes
+     * `"starting"`, `"stopping"` and `"failed"` from a plain `"not_started"`.
+     */
     get isRunning(): boolean;
+    /** Current lifecycle state of this agent. */
+    get state(): RuntimeLifecycleState;
+    /**
+     * The underlying `PlatformRuntime`, for reading its `link`/`getContext()`/etc.
+     *
+     * Do not call `runtime.start()`/`runtime.stop()` directly: `Agent` keeps its
+     * own lifecycle tracker, so driving `PlatformRuntime`'s independently leaves
+     * `agent.state` reporting stale information. Use {@link Agent.start}/
+     * {@link Agent.stop} instead.
+     */
     get runtime(): PlatformRuntime;
+    /**
+     * Start the agent.
+     *
+     * Repeated or concurrent calls join the in-flight start. Calling `start()`
+     * while a `stop()` is still in flight rejects with a `RuntimeStateError`.
+     */
     start(): Promise<void>;
+    private runStart;
+    /**
+     * Stop the agent.
+     *
+     * A concurrent second call joins the in-flight teardown and mirrors its
+     * outcome — including rejecting with the *same* `Error` instance. A rejected
+     * `stop()` is not treated as a completed one: the next `stop()` reports the
+     * same failure, and a `start()` re-arms teardown.
+     */
     stop(timeoutMs?: number | null): Promise<boolean>;
+    private runStop;
     runForever(): Promise<void>;
     bootstrapRoomMessage(roomId: string, message: PlatformMessage): Promise<void>;
     resetRoomSession(roomId: string, timeoutMs?: number): Promise<boolean>;
@@ -62,4 +101,4 @@ declare class Agent {
 
 declare function isDirectExecution(importMetaUrl: string): boolean;
 
-export { Agent, type AgentCreateOptions, AgentCredentials, FrameworkAdapter, PlatformMessage, PlatformRuntime, PlatformRuntimeOptions, isDirectExecution };
+export { Agent, type AgentCreateOptions, AgentCredentials, FrameworkAdapter, PlatformMessage, PlatformRuntime, PlatformRuntimeOptions, RuntimeLifecycleState, isDirectExecution };

package/dist/index.d.ts

@@ -1,25 +1,27 @@
-import { F as FrameworkAdapter } from './protocols-Bwwcql0h.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-Bwwcql0h.js';
+import { F as FrameworkAdapter } from './protocols-Dpci6uae.js';
+export { A as AdapterToolsProtocol, b as AgentToolsProtocol, C as ContactTools, c as FAILURE_EVENT_TYPE, d as FAILURE_METADATA_KEY, a as FrameworkAdapterInput, H as HistoryConverter, M as MemoryTools, e as MessagingTools, f as ParticipantTools, g as PeerLookupTools, h as Preprocessor, R as RoomParticipantTools, T as ToolExecutor, i as ToolSchemaProvider, t as toFailureEvent } from './protocols-Dpci6uae.js';
 import { AgentCredentials } from './config.js';
 export { AgentConfigResult, LoadAgentConfigFromEnvOptions, loadAgentConfig, loadAgentConfigFromEnv } from './config.js';
-import { P as PlatformRuntime, a as PlatformRuntimeOptions } from './schemas-C4mK1WSs.js';
-export { A as AgentRuntime, B as BandLink, D as DefaultPreprocessor, E as ExecutionContextOptions, M as MCP_SERVER_NAME, b as MCP_TOOL_PREFIX, T as TOOL_MODELS, d as deriveDefaultRestUrl } from './schemas-C4mK1WSs.js';
-import { P as PlatformMessage } from './types-DFUtpxah.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-DFUtpxah.js';
-export { W as WebSocketConflictPolicy, a as WebSocketDisconnectError, b as WebSocketDisconnectReason } from './disconnectReason-IuADl6TH.js';
-export { C as CustomToolDef } from './customTools-BzF0IISO.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 './ClaudeSDKAdapter-CXud2DBE.js';
-export { S as SimpleAdapter } from './simpleAdapter--wznuoOw.js';
-export { A as A2AAuth, a as A2AGatewayAdapterOptions } from './opencode-Bld62x5t.js';
-import './dtos-B8KU_q4d.js';
-import './logger-CABQOnlR.js';
-import './types-BivGO7I9.js';
-import './pagination-BgEx-HeL.js';
-import '@band-ai/band-sdk-core';
+import { L as Logger } from './logger-CABQOnlR.js';
+import { P as PlatformRuntime, a as PlatformRuntimeOptions, R as RuntimeLifecycleState } from './schemas-CDa3V_I5.js';
+export { A as AgentRuntime, B as BandLink, D as DefaultPreprocessor, E as ExecutionContextOptions, b as ExecutionLifecycleState, M as MCP_SERVER_NAME, c as MCP_TOOL_PREFIX, T as TOOL_MODELS, d as deriveDefaultRestUrl } from './schemas-CDa3V_I5.js';
+import { P as PlatformMessage } from './types-CKU1N0SK.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, R as ReconnectedEvent, S as SessionConfig } from './types-CKU1N0SK.js';
+export { W as WebSocketConflictPolicy, a as WebSocketDisconnectError, b as WebSocketDisconnectReason } from './disconnectReason-Cctmg1SN.js';
+export { C as CustomToolDef } from './customTools-Bfecd0mJ.js';
+export { A as A2AAdapter, a as A2AAdapterOptions, b as A2AGatewayAdapter, c as ACPClientAdapter, d as ACPClientAdapterBaseOptions, e as ACPClientAdapterOptions, f as ACPClientStdioOptions, g as ACPClientTcpOptions, h as ACPConfigRequest, i as ACPConfigSelections, j as AnthropicAdapter, k as AnthropicAdapterOptions, C as CODEX_REASONING_EFFORTS, l as CODEX_REASONING_SUMMARIES, m as CODEX_WEB_SEARCH_MODES, n as ClaudePermissionMode, o as ClaudeSDKAdapter, p as ClaudeSDKAdapterOptions, q as CodexAdapter, r as CodexAdapterConfig, s as CodexApprovalPolicy, t as CodexReasoningEffort, u as CodexReasoningSummary, v as CodexSandboxMode, w as CodexWebSearchMode, x as CopilotACPAdapter, y as CopilotACPAdapterOptions, z as CopilotACPStdioOptions, B as CopilotACPTcpOptions, D as DEFAULT_COPILOT_ACP_COMMAND, E as DEFAULT_OMP_ACP_COMMAND, G as GeminiAdapter, F as GeminiAdapterOptions, H as GenericAdapter, I as GenericAdapterHandler, J as GoogleADKAdapter, K as GoogleADKAdapterOptions, L as LangGraphAdapter, M as LangGraphAdapterOptions, N as LangGraphGraph, O as LettaAdapter, P as LettaAdapterOptions, Q as OmpACPAdapter, R as OmpACPAdapterOptions, S as OpenAIAdapter, T as OpenAIAdapterOptions, U as OpencodeAdapter, V as OpencodeAdapterConfig, W as OpencodeApprovalMode, X as OpencodeApprovalReply, Y as OpencodeQuestionMode, Z as ParlantAdapter, _ as ParlantAdapterOptions, $ as ToolCallingModel, a0 as VercelAISDKAdapter, a1 as VercelAISDKAdapterOptions } from './CopilotACPAdapter-B_AVyAl6.js';
+export { S as SimpleAdapter } from './simpleAdapter-eLvsAQNo.js';
+export { A as A2AAuth, a as A2AGatewayAdapterOptions } from './acp-client-DUXyczlF.js';
+export { AgentFailure } from '@band-ai/band-sdk-core';
+export { DeliveryFailedError, ProviderTurnFailedError, RecoverableTurnError, agentFailure, deliverReply, reportTurnFailure } from './core.js';
+import './dtos-CjQsN1_h.js';
+import './types-CjxZekMH.js';
+import './pagination-CPz0J_vQ.js';
 import 'zod';
-import './backends-D-dBdDm-.js';
-import './sdk-qKJtMma_.js';
+import './backends-CgsPQa9B.js';
+import './sdk-Cin80BTC.js';
 import '@anthropic-ai/claude-agent-sdk';
+import '@agentclientprotocol/sdk';
 
 interface AgentCreateOptions extends Omit<PlatformRuntimeOptions, "agentId" | "apiKey" | "wsUrl" | "restUrl"> {
     adapter: FrameworkAdapter;
@@ -39,16 +41,53 @@ interface AgentCreateOptions extends Omit<PlatformRuntimeOptions, "agentId" | "a
 declare class Agent {
     private readonly platformRuntime;
     private readonly adapter;
-    private started;
-    private startPromise;
+    private readonly lifecycle;
+    private readonly logger;
+    private readonly startGate;
+    private readonly stopGate;
     private shutdownTimeoutMs;
-    constructor(runtime: PlatformRuntime, adapter: FrameworkAdapter);
+    constructor(runtime: PlatformRuntime, adapter: FrameworkAdapter, logger?: Logger);
     /** Build an Agent from credentials and a framework adapter. */
     static create(options: AgentCreateOptions): Agent;
+    /**
+     * Whether the agent is currently started.
+     *
+     * `false` while a `start()` call is still in flight — it only turns `true`
+     * once that call has resolved — and `false` again once the agent is stopped.
+     *
+     * @deprecated Read {@link Agent.state} instead, which also distinguishes
+     * `"starting"`, `"stopping"` and `"failed"` from a plain `"not_started"`.
+     */
     get isRunning(): boolean;
+    /** Current lifecycle state of this agent. */
+    get state(): RuntimeLifecycleState;
+    /**
+     * The underlying `PlatformRuntime`, for reading its `link`/`getContext()`/etc.
+     *
+     * Do not call `runtime.start()`/`runtime.stop()` directly: `Agent` keeps its
+     * own lifecycle tracker, so driving `PlatformRuntime`'s independently leaves
+     * `agent.state` reporting stale information. Use {@link Agent.start}/
+     * {@link Agent.stop} instead.
+     */
     get runtime(): PlatformRuntime;
+    /**
+     * Start the agent.
+     *
+     * Repeated or concurrent calls join the in-flight start. Calling `start()`
+     * while a `stop()` is still in flight rejects with a `RuntimeStateError`.
+     */
     start(): Promise<void>;
+    private runStart;
+    /**
+     * Stop the agent.
+     *
+     * A concurrent second call joins the in-flight teardown and mirrors its
+     * outcome — including rejecting with the *same* `Error` instance. A rejected
+     * `stop()` is not treated as a completed one: the next `stop()` reports the
+     * same failure, and a `start()` re-arms teardown.
+     */
     stop(timeoutMs?: number | null): Promise<boolean>;
+    private runStop;
     runForever(): Promise<void>;
     bootstrapRoomMessage(roomId: string, message: PlatformMessage): Promise<void>;
     resetRoomSession(roomId: string, timeoutMs?: number): Promise<boolean>;
@@ -62,4 +101,4 @@ declare class Agent {
 
 declare function isDirectExecution(importMetaUrl: string): boolean;
 
-export { Agent, type AgentCreateOptions, AgentCredentials, FrameworkAdapter, PlatformMessage, PlatformRuntime, PlatformRuntimeOptions, isDirectExecution };
+export { Agent, type AgentCreateOptions, AgentCredentials, FrameworkAdapter, PlatformMessage, PlatformRuntime, PlatformRuntimeOptions, RuntimeLifecycleState, isDirectExecution };

package/dist/index.js

@@ -1,68 +1,102 @@
 import {
+  ACPClientAdapter,
   AnthropicAdapter,
   CODEX_REASONING_EFFORTS,
   CODEX_REASONING_SUMMARIES,
   CODEX_WEB_SEARCH_MODES,
   ClaudeSDKAdapter,
   CodexAdapter,
+  CopilotACPAdapter,
+  DEFAULT_COPILOT_ACP_COMMAND,
+  DEFAULT_OMP_ACP_COMMAND,
   GeminiAdapter,
   GenericAdapter,
   GoogleADKAdapter,
   LangGraphAdapter,
   LettaAdapter,
+  OmpACPAdapter,
   OpenAIAdapter,
   OpencodeAdapter,
   VercelAISDKAdapter
-} from "./chunk-MQBBWYRP.js";
-import "./chunk-WA7CHXUS.js";
-import "./chunk-XWHWJP4I.js";
+} from "./chunk-UFO6XMCV.js";
+import "./chunk-UL3Y5C4J.js";
+import "./chunk-JDW5WSGF.js";
 import {
   loadAgentConfig,
   loadAgentConfigFromEnv
-} from "./chunk-WL2HNJZ6.js";
+} from "./chunk-VOMJRQOM.js";
 import {
   A2AAdapter,
   A2AGatewayAdapter,
   ParlantAdapter
-} from "./chunk-K5KAEYPF.js";
+} from "./chunk-HNWZZXAE.js";
 import {
-  SimpleAdapter
-} from "./chunk-AVVDPXP4.js";
+  AgentFailure
+} from "./chunk-I34SXMTJ.js";
+import {
+  DeliveryFailedError,
+  ProviderTurnFailedError,
+  SimpleAdapter,
+  agentFailure,
+  deliverReply,
+  reportTurnFailure
+} from "./chunk-OGOXY43L.js";
 import {
   AgentRuntime,
   BandLink,
   DefaultPreprocessor,
+  LifecycleTracker,
   PlatformRuntime,
+  SingleFlight,
   deriveDefaultRestUrl,
-  runWithGracefulShutdown
-} from "./chunk-U6AFCLYZ.js";
-import "./chunk-OH6VVVKT.js";
-import "./chunk-YJ42AZO4.js";
+  isLegalRuntimeTransition,
+  runWithGracefulShutdown,
+  startWithGate
+} from "./chunk-6TGXV5TE.js";
+import "./chunk-CBCHTTUY.js";
+import "./chunk-RJNJUISR.js";
 import {
   MCP_SERVER_NAME,
   MCP_TOOL_PREFIX,
   TOOL_MODELS
-} from "./chunk-MQY74R7D.js";
-import "./chunk-F63TPOI3.js";
+} from "./chunk-SHZBLLDQ.js";
 import {
   WebSocketDisconnectError
-} from "./chunk-US226AS4.js";
-import "./chunk-W5IAI6Z4.js";
-import "./chunk-KXJ74J73.js";
-import "./chunk-JADCAMZY.js";
-import "./chunk-OD2G5LFQ.js";
-import "./chunk-JY75VSQK.js";
+} from "./chunk-UENIC5FJ.js";
+import "./chunk-OVXVZUPO.js";
+import "./chunk-JIZE4EC6.js";
+import "./chunk-6BE2EG5P.js";
+import {
+  FAILURE_EVENT_TYPE,
+  FAILURE_METADATA_KEY,
+  toFailureEvent
+} from "./chunk-TGDDFBYS.js";
+import {
+  resolveLogger
+} from "./chunk-ZYOXI4JL.js";
+import {
+  RecoverableTurnError
+} from "./chunk-4OVNFDD7.js";
 
 // src/agent/Agent.ts
 var Agent = class _Agent {
   platformRuntime;
   adapter;
-  started = false;
-  startPromise = null;
+  lifecycle;
+  logger;
+  startGate = new SingleFlight();
+  stopGate = new SingleFlight();
   shutdownTimeoutMs = 3e4;
-  constructor(runtime, adapter) {
+  constructor(runtime, adapter, logger) {
     this.platformRuntime = runtime;
     this.adapter = adapter;
+    this.logger = resolveLogger(logger);
+    this.lifecycle = new LifecycleTracker({ status: "not_started" }, {
+      owner: "Agent",
+      logContext: { agentId: runtime.agentId },
+      logger: this.logger,
+      isLegalTransition: isLegalRuntimeTransition
+    });
   }
   /** Build an Agent from credentials and a framework adapter. */
   static create(options) {
@@ -83,44 +117,103 @@ var Agent = class _Agent {
       ...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);
+    const agent = new _Agent(runtime, adapter, runtimeOptions.logger);
     agent.shutdownTimeoutMs = shutdownTimeoutMs === void 0 ? 3e4 : shutdownTimeoutMs;
     return agent;
   }
+  /**
+   * Whether the agent is currently started.
+   *
+   * `false` while a `start()` call is still in flight — it only turns `true`
+   * once that call has resolved — and `false` again once the agent is stopped.
+   *
+   * @deprecated Read {@link Agent.state} instead, which also distinguishes
+   * `"starting"`, `"stopping"` and `"failed"` from a plain `"not_started"`.
+   */
   get isRunning() {
-    return this.started;
+    return this.lifecycle.is("running");
+  }
+  /** Current lifecycle state of this agent. */
+  get state() {
+    return this.lifecycle.state;
   }
+  /**
+   * The underlying `PlatformRuntime`, for reading its `link`/`getContext()`/etc.
+   *
+   * Do not call `runtime.start()`/`runtime.stop()` directly: `Agent` keeps its
+   * own lifecycle tracker, so driving `PlatformRuntime`'s independently leaves
+   * `agent.state` reporting stale information. Use {@link Agent.start}/
+   * {@link Agent.stop} instead.
+   */
   get runtime() {
     return this.platformRuntime;
   }
+  /**
+   * Start the agent.
+   *
+   * Repeated or concurrent calls join the in-flight start. Calling `start()`
+   * while a `stop()` is still in flight rejects with a `RuntimeStateError`.
+   */
   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;
+    await startWithGate({
+      lifecycle: this.lifecycle,
+      startGate: this.startGate,
+      stopGate: this.stopGate,
+      ownerName: "Agent",
+      runStart: () => this.runStart()
     });
-    return this.startPromise;
   }
+  async runStart() {
+    const startState = this.lifecycle.state;
+    try {
+      await this.platformRuntime.start(this.adapter);
+    } catch (error) {
+      if (this.lifecycle.isCurrent(startState)) {
+        this.lifecycle.fail(error, "start-failed");
+      }
+      throw error;
+    }
+    if (this.lifecycle.isCurrent(startState)) {
+      this.lifecycle.transition({ status: "running" }, "started");
+    }
+  }
+  /**
+   * Stop the agent.
+   *
+   * A concurrent second call joins the in-flight teardown and mirrors its
+   * outcome — including rejecting with the *same* `Error` instance. A rejected
+   * `stop()` is not treated as a completed one: the next `stop()` reports the
+   * same failure, and a `start()` re-arms teardown.
+   */
   async stop(timeoutMs) {
-    if (!this.started && !this.startPromise) {
+    return await this.stopGate.run(() => this.runStop(timeoutMs));
+  }
+  async runStop(timeoutMs) {
+    if (this.lifecycle.is("failed")) {
+      this.logger.debug("Agent stop is resurfacing the recorded start failure", { error: this.lifecycle.state.error });
+      throw this.lifecycle.state.error;
+    }
+    if (!this.lifecycle.is("starting") && !this.lifecycle.is("running")) {
       return true;
     }
-    if (!this.started && this.startPromise) {
+    const pendingStart = this.lifecycle.is("starting") ? this.startGate.pending : null;
+    this.startGate.reset();
+    this.lifecycle.transition({ status: "stopping" }, "stop");
+    const stopping = this.platformRuntime.stop(timeoutMs ?? void 0);
+    if (pendingStart) {
       try {
-        await this.startPromise;
-      } catch {
-        return true;
+        await pendingStart;
+      } catch (error) {
+        this.logger.debug("Agent stop superseded the in-flight start", { error });
       }
     }
     try {
-      return await this.platformRuntime.stop(timeoutMs ?? void 0);
-    } finally {
-      this.started = false;
-      this.startPromise = null;
+      const graceful = await stopping;
+      this.lifecycle.transition({ status: "stopped" }, "stopped");
+      return graceful;
+    } catch (error) {
+      this.lifecycle.fail(error, "stop-failed");
+      throw error;
     }
   }
   async runForever() {
@@ -173,7 +266,9 @@ function isDirectExecution(importMetaUrl) {
 export {
   A2AAdapter,
   A2AGatewayAdapter,
+  ACPClientAdapter,
   Agent,
+  AgentFailure,
   AgentRuntime,
   AnthropicAdapter,
   BandLink,
@@ -182,7 +277,13 @@ export {
   CODEX_WEB_SEARCH_MODES,
   ClaudeSDKAdapter,
   CodexAdapter,
+  CopilotACPAdapter,
+  DEFAULT_COPILOT_ACP_COMMAND,
+  DEFAULT_OMP_ACP_COMMAND,
   DefaultPreprocessor,
+  DeliveryFailedError,
+  FAILURE_EVENT_TYPE,
+  FAILURE_METADATA_KEY,
   GeminiAdapter,
   GenericAdapter,
   GoogleADKAdapter,
@@ -190,16 +291,23 @@ export {
   LettaAdapter,
   MCP_SERVER_NAME,
   MCP_TOOL_PREFIX,
+  OmpACPAdapter,
   OpenAIAdapter,
   OpencodeAdapter,
   ParlantAdapter,
   PlatformRuntime,
+  ProviderTurnFailedError,
+  RecoverableTurnError,
   SimpleAdapter,
   TOOL_MODELS,
   VercelAISDKAdapter,
   WebSocketDisconnectError,
+  agentFailure,
+  deliverReply,
   deriveDefaultRestUrl,
   isDirectExecution,
   loadAgentConfig,
-  loadAgentConfigFromEnv
+  loadAgentConfigFromEnv,
+  reportTurnFailure,
+  toFailureEvent
 };

package/dist/linear.cjs

@@ -81,14 +81,52 @@ var UnsupportedFeatureError = class extends BandSdkError {
   }
 };
 
+// src/core/sensitiveTerms.ts
+var SENSITIVE_KEY_TERMS = "authorization|api[-_ ]?key|token|secret|password|cookie";
+var GATEWAY_FREE_TEXT_SENSITIVE_KEY_TERMS = `${SENSITIVE_KEY_TERMS}|session`;
+
 // src/core/logger.ts
 var noop = () => void 0;
+var SENSITIVE_KEY_PATTERN = new RegExp(`(${SENSITIVE_KEY_TERMS})`, "i");
 var NoopLogger = class {
   debug = noop;
   info = noop;
   warn = noop;
   error = noop;
 };
+function resolveLogger(logger) {
+  if (!logger) {
+    return new NoopLogger();
+  }
+  return logger instanceof GuardedLogger ? logger : new GuardedLogger(logger);
+}
+var GuardedLogger = class {
+  constructor(inner) {
+    this.inner = inner;
+  }
+  debug(message, context) {
+    return this.emit("debug", message, context);
+  }
+  info(message, context) {
+    return this.emit("info", message, context);
+  }
+  warn(message, context) {
+    return this.emit("warn", message, context);
+  }
+  error(message, context) {
+    return this.emit("error", message, context);
+  }
+  emit(level, message, context) {
+    try {
+      const result = this.inner[level](message, context);
+      if (result instanceof Promise) {
+        result.catch(noop);
+      }
+      return result;
+    } catch {
+    }
+  }
+};
 
 // src/integrations/linear/handles.ts
 function stripHandlePrefix(handle) {
@@ -210,7 +248,7 @@ var StaleSessionGuard = class {
   constructor(options) {
     this.store = options.store;
     this.linearClient = options.linearClient;
-    this.logger = options.logger ?? new NoopLogger();
+    this.logger = resolveLogger(options.logger);
     this.checkIntervalMs = options.checkIntervalMs ?? STALE_SESSION_CHECK_INTERVAL_MS;
     this.staleThresholdMs = options.staleThresholdMs ?? STALE_SESSION_THRESHOLD_MS;
     this.keepAliveMessage = options.keepAliveMessage ?? DEFAULT_KEEPALIVE_MESSAGE;
@@ -521,7 +559,7 @@ function getAgentSessionEventKey(payload) {
   ].join(":");
 }
 async function handleAgentSessionEvent(input, options) {
-  const logger = input.deps.logger ?? new NoopLogger();
+  const logger = resolveLogger(input.deps.logger);
   const config = normalizeConfig(input.config);
   const action = normalizeAction(input.payload.action);
   const runtime = options?.runtime ?? createLinearBridgeRuntime();
@@ -1912,9 +1950,9 @@ function createLinearTools(options) {
     session_id: import_zod.z.string().describe("The Linear agent session ID"),
     body: import_zod.z.string().describe("The message body in Markdown format")
   });
-  const issueIdInputSchema = import_zod.z.object({
+  const issueIdInputSchema = import_zod.z.looseObject({
     issue_id: import_zod.z.string().optional().describe("The Linear issue ID (UUID) from the session context")
-  }).passthrough();
+  });
   const issueCommentLimitSchema = import_zod.z.number().int().min(1).max(50).optional().describe("Maximum number of recent comments to return");
   const requiredIssueIdSchema = issueIdInputSchema;
   const optionalIssueIdSchema = issueIdInputSchema;
@@ -2604,7 +2642,7 @@ var import_webhooks = require("@linear/sdk/webhooks");
 var DISPATCH_RETRY_LIMIT = 2;
 var DISPATCH_RETRY_BASE_DELAY_MS = 1e3;
 function createInlineLinearBridgeDispatcher(options) {
-  const logger = options?.logger ?? new NoopLogger();
+  const logger = resolveLogger(options?.logger);
   const runtime = createLinearBridgeRuntime();
   return {
     dispatch: async (job) => {
@@ -2646,7 +2684,7 @@ function createInlineLinearBridgeDispatcher(options) {
   };
 }
 function createInProcessLinearBridgeDispatcher(options) {
-  const logger = options?.logger ?? new NoopLogger();
+  const logger = resolveLogger(options?.logger);
   const runtime = createLinearBridgeRuntime();
   const queued = /* @__PURE__ */ new Set();
   const inFlight = /* @__PURE__ */ new Set();
@@ -2728,7 +2766,7 @@ function createInProcessLinearBridgeDispatcher(options) {
   };
 }
 function createLinearWebhookHandler(options) {
-  const logger = options.deps.logger ?? new NoopLogger();
+  const logger = resolveLogger(options.deps.logger);
   const runtime = createLinearBridgeRuntime();
   const dispatcher = options.dispatcher ?? createInlineLinearBridgeDispatcher({ logger });
   const webhookClient = new import_webhooks.LinearWebhookClient(options.config.linearWebhookSecret);

package/dist/linear.d.cts

@@ -1,10 +1,11 @@
 import { LinearClient, LinearDocument } from '@linear/sdk';
-import { R as RestApi } from './types-BgYFd_Yw.cjs';
+import { R as RestApi } from './types-42-HWeX8.cjs';
 import { AppUserNotificationWebhookPayloadWithNotification, AgentSessionEventWebhookPayload, AppUserTeamAccessChangedWebhookPayload, OAuthAppWebhookPayload } from '@linear/sdk/webhooks';
 import { L as Logger } from './logger-CABQOnlR.cjs';
-import { C as CustomToolDef } from './customTools-BzF0IISO.cjs';
+import { C as CustomToolDef } from './customTools-Bfecd0mJ.cjs';
 import { IncomingMessage, ServerResponse } from 'node:http';
-import './dtos-B8KU_q4d.cjs';
+import './dtos-CjQsN1_h.cjs';
+import '@band-ai/band-sdk-core';
 import 'zod';
 
 interface CandidateRepositoryInput {