@harnessio/ai-chat-core 0.0.23 → 0.0.25

package/dist/runtime/ThreadRuntime/ThreadRuntime.d.ts

@@ -35,6 +35,21 @@ export declare class ThreadRuntime extends BaseSubscribable {
      * do not need their own queueing primitive.
      */
     sendSystemEvent(systemEvent: SystemEvent): Promise<void>;
+    /**
+     * Registers a generic background task that keeps the thread reported as
+     * running for as long as it is active, even when no stream run is in
+     * flight. Use this for UI-driven async work (e.g. a card polling a status
+     * API) so the composer shows a running/stop affordance. The work is
+     * cancelled when the user presses stop (cancelRun), which invokes the
+     * provided onCancel callback. Returns an opaque id for stopBackgroundTask.
+     */
+    startBackgroundTask(options?: {
+        onCancel?: () => void;
+    }): string;
+    /**
+     * Removes a previously registered background task by its id.
+     */
+    stopBackgroundTask(id: string): void;
     cancelRun(): void;
     clear(): void;
     reset(messages?: Message[]): void;

package/dist/runtime/ThreadRuntime/ThreadRuntimeCore.d.ts

@@ -20,6 +20,7 @@ export declare class ThreadRuntimeCore extends BaseSubscribable {
     private _conversationId?;
     private _title?;
     private _idleWaiters;
+    private _backgroundTasks;
     private _currentPart;
     constructor(config: ThreadRuntimeCoreConfig);
     get messages(): readonly Message[];
@@ -45,6 +46,26 @@ export declare class ThreadRuntimeCore extends BaseSubscribable {
      */
     waitForIdle(): Promise<void>;
     private drainIdleWaiters;
+    /**
+     * Registers a generic background task that keeps the thread reported as
+     * running (isRunning === true) for as long as it is active, even when no
+     * stream run is in flight. Use this for UI-driven async work — e.g. a card
+     * that polls a status API — so the composer shows a running/stop
+     * affordance and the work is cancelled when the user presses stop.
+     *
+     * Returns an opaque id to pass to stopBackgroundTask. The optional onCancel
+     * callback is invoked if the task is cancelled via cancelRun (stop button).
+     */
+    startBackgroundTask(options?: {
+        onCancel?: () => void;
+    }): string;
+    /**
+     * Removes a previously registered background task. Once the last task is
+     * removed (and no run is in flight) any idle waiters are drained so queued
+     * dispatches can proceed.
+     */
+    stopBackgroundTask(id: string): void;
+    private cancelBackgroundTasks;
     startSystemEventRun(systemEvent: SystemEvent): Promise<void>;
     startRun(userMessage: AppendMessage): Promise<void>;
     private handleStreamEvent;

package/dist/types/adapters.d.ts

@@ -38,12 +38,12 @@ export type StreamEvent = {
     readonly parentId?: string;
     [key: string]: any;
 };
-export type SystemEventType = 'action_completed' | 'action_cancelled';
+export type SystemEventType = 'action_completed' | 'action_cancelled' | 'pipeline_status_updated';
 export interface SystemEvent {
     event_type: SystemEventType;
     capability_id: string;
     result?: {
-        success: boolean;
+        success?: boolean;
         [key: string]: unknown;
     };
     target_page_id?: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@harnessio/ai-chat-core",
-  "version": "0.0.23",
+  "version": "0.0.25",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "private": false,