@polos/sdk 0.2.1 → 0.2.3

package/dist/index.d.cts

@@ -657,8 +657,11 @@ interface Channel {
     /**
      * Send a notification when an agent suspends for user input.
      * Implementations should throw on failure — the SDK catches and logs errors.
+     *
+     * May return channel-specific metadata (e.g., Slack message_ts) so the
+     * orchestrator can update the notification later (e.g., after approval via UI).
      */
-    notify(notification: SuspendNotification): Promise<void>;
+    notify(notification: SuspendNotification): Promise<Record<string, unknown> | undefined>;
     /** Default output mode for this channel. */
     readonly outputMode?: ChannelOutputMode;
     /** Send output events back to the originating channel. */
@@ -1641,6 +1644,10 @@ interface BatchInvokeWorkflowsRequest {
     rootWorkflowId?: string | undefined;
     waitForSubworkflow?: boolean | undefined;
     otelTraceparent?: string | undefined;
+    channelContext?: {
+        channelId: string;
+        source: Record<string, unknown>;
+    } | undefined;
 }
 /**
  * Response from batch workflow invocation.
@@ -2927,6 +2934,8 @@ declare class Worker {
     private state;
     private heartbeatInterval;
     private activeExecutions;
+    /** Tracks running channel bridges so we don't start duplicates on re-dispatch. */
+    private activeChannelBridges;
     private signalHandler;
     constructor(config: WorkerConfig);
     /**
@@ -4795,7 +4804,7 @@ declare function createExecTool(getEnv: () => Promise<ExecutionEnvironment>, con
  */
 
 /**
- * Configuration for path-restricted approval on read-only tools.
+ * Configuration for path-restricted approval on sandbox tools.
  */
 interface PathRestrictionConfig {
     /** Directory to allow without approval. Paths outside require approval. */
@@ -4950,7 +4959,7 @@ declare class SlackChannel implements Channel {
     readonly outputMode: ChannelOutputMode;
     private readonly config;
     constructor(config: SlackChannelConfig);
-    notify(notification: SuspendNotification): Promise<void>;
+    notify(notification: SuspendNotification): Promise<Record<string, unknown> | undefined>;
     sendOutput(context: ChannelContext, event: StreamEvent): Promise<void>;
     private postMessage;
     private formatOutputEvent;

package/dist/index.d.ts

@@ -657,8 +657,11 @@ interface Channel {
     /**
      * Send a notification when an agent suspends for user input.
      * Implementations should throw on failure — the SDK catches and logs errors.
+     *
+     * May return channel-specific metadata (e.g., Slack message_ts) so the
+     * orchestrator can update the notification later (e.g., after approval via UI).
      */
-    notify(notification: SuspendNotification): Promise<void>;
+    notify(notification: SuspendNotification): Promise<Record<string, unknown> | undefined>;
     /** Default output mode for this channel. */
     readonly outputMode?: ChannelOutputMode;
     /** Send output events back to the originating channel. */
@@ -1641,6 +1644,10 @@ interface BatchInvokeWorkflowsRequest {
     rootWorkflowId?: string | undefined;
     waitForSubworkflow?: boolean | undefined;
     otelTraceparent?: string | undefined;
+    channelContext?: {
+        channelId: string;
+        source: Record<string, unknown>;
+    } | undefined;
 }
 /**
  * Response from batch workflow invocation.
@@ -2927,6 +2934,8 @@ declare class Worker {
     private state;
     private heartbeatInterval;
     private activeExecutions;
+    /** Tracks running channel bridges so we don't start duplicates on re-dispatch. */
+    private activeChannelBridges;
     private signalHandler;
     constructor(config: WorkerConfig);
     /**
@@ -4795,7 +4804,7 @@ declare function createExecTool(getEnv: () => Promise<ExecutionEnvironment>, con
  */
 
 /**
- * Configuration for path-restricted approval on read-only tools.
+ * Configuration for path-restricted approval on sandbox tools.
  */
 interface PathRestrictionConfig {
     /** Directory to allow without approval. Paths outside require approval. */
@@ -4950,7 +4959,7 @@ declare class SlackChannel implements Channel {
     readonly outputMode: ChannelOutputMode;
     private readonly config;
     constructor(config: SlackChannelConfig);
-    notify(notification: SuspendNotification): Promise<void>;
+    notify(notification: SuspendNotification): Promise<Record<string, unknown> | undefined>;
     sendOutput(context: ChannelContext, event: StreamEvent): Promise<void>;
     private postMessage;
     private formatOutputEvent;