@harnessio/ai-chat-core 0.0.20 → 0.0.22

package/dist/react/hooks/index.d.ts

@@ -8,3 +8,6 @@ export { useContentFocus } from './useContentFocus';
 export { useCapability } from './useCapability';
 export { useCapabilityExecution } from './useCapabilityExecution';
 export { usePageContext } from './usePageContext';
+export { useQuickActionScope } from './useQuickActionScope';
+export { useQuickAction } from './useQuickAction';
+export { useQuickActions } from './useQuickActions';

package/dist/react/hooks/useQuickAction.d.ts

@@ -0,0 +1,26 @@
+import { QuickActionConfig } from '../../types/quick-action';
+/**
+ * Register a quick action that appears in the welcome screen.
+ * Automatically unregisters when the component unmounts.
+ *
+ * @param config - Quick action configuration
+ * @param scope - The scope to register this action in (defaults to current active scope)
+ *
+ * @example
+ * ```tsx
+ * function PipelineQuickActions() {
+ *   useQuickActionScope('pipelines', 'merge')
+ *
+ *   useQuickAction({
+ *     id: 'list-pipelines',
+ *     label: 'List pipelines',
+ *     prompt: 'Show me all pipelines in this project',
+ *     icon: 'pipeline',
+ *     priority: 10
+ *   }, 'pipelines')
+ *
+ *   return null
+ * }
+ * ```
+ */
+export declare function useQuickAction(config: QuickActionConfig, scope?: string): void;

package/dist/react/hooks/useQuickActionScope.d.ts

@@ -0,0 +1,21 @@
+import { QuickActionScopeMode } from '../../types/quick-action';
+/**
+ * Activate a quick action scope for the duration of this component's lifecycle.
+ * When the component unmounts, the scope is deactivated and the previous scope is restored.
+ *
+ * Use this at the page/module level to declare "this page owns quick actions".
+ *
+ * @param scope - Unique identifier for this scope (e.g., "pipelines", "dashboards")
+ * @param mode - How to display actions: 'merge' (global + current), 'replace' (only current), 'append' (all scopes)
+ *
+ * @example
+ * ```tsx
+ * function PipelinePage() {
+ *   useQuickActionScope('pipelines', 'merge')
+ *
+ *   // Component automatically cleans up on unmount
+ *   return <div>Pipeline content</div>
+ * }
+ * ```
+ */
+export declare function useQuickActionScope(scope: string, mode?: QuickActionScopeMode): void;

package/dist/react/hooks/useQuickActions.d.ts

@@ -0,0 +1,25 @@
+import { QuickAction, QuickActionFilter } from '../../types/quick-action';
+/**
+ * Get all visible quick actions, respecting their condition functions and the active scope.
+ *
+ * @param filter - Optional filter by scope
+ * @returns Array of visible quick actions, sorted by priority
+ *
+ * @example
+ * ```tsx
+ * function WelcomeScreen() {
+ *   const quickActions = useQuickActions()
+ *
+ *   return (
+ *     <div>
+ *       {quickActions.map(action => (
+ *         <Button key={action.id} onClick={() => send(action.prompt)}>
+ *           {action.label}
+ *         </Button>
+ *       ))}
+ *     </div>
+ *   )
+ * }
+ * ```
+ */
+export declare function useQuickActions(filter?: QuickActionFilter): QuickAction[];

package/dist/runtime/AssistantRuntime/AssistantRuntime.d.ts

@@ -1,5 +1,6 @@
 import { CapabilityExecutionManager, CapabilityRegistry } from '../../core';
 import { PluginRegistry } from '../../core/PluginRegistry';
+import { QuickActionRegistry } from '../../core/QuickActionRegistry';
 import { ChatPlugin } from '../../types/plugin';
 import { BaseSubscribable } from '../../utils/Subscribable';
 import { ContentFocusRuntime } from '../ContentFocusRuntime/ContentFocusRuntime';
@@ -13,6 +14,7 @@ export declare class AssistantRuntime extends BaseSubscribable {
     readonly pluginRegistry: PluginRegistry;
     readonly capabilityRegistry: CapabilityRegistry;
     readonly capabilityExecutionManager: CapabilityExecutionManager;
+    readonly quickActionRegistry: QuickActionRegistry;
     private _contentFocusRuntime;
     private _currentThreadUnsubscribe?;
     constructor(config: AssistantRuntimeConfig);

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

@@ -1,5 +1,5 @@
 import { SystemEvent } from '../../types/adapters';
-import { AppendMessage, Message } from '../../types/message';
+import { AppendMessage, Message, MessageContent } from '../../types/message';
 import { RuntimeCapabilities, ThreadState } from '../../types/thread';
 import { BaseSubscribable, Unsubscribe } from '../../utils/Subscribable';
 import { default as ComposerRuntime } from '../ComposerRuntime/ComposerRuntime';
@@ -22,11 +22,24 @@ export declare class ThreadRuntime extends BaseSubscribable {
     getState(): ThreadState;
     append(message: AppendMessage): void;
     send(text: string): Promise<void>;
+    /**
+     * Dispatches a system event (e.g. a user click on an elicitation card).
+     *
+     * Prior to this change, this method wrapped startSystemEventRun in a
+     * try/catch that silently swallowed the "A run is already in progress"
+     * error thrown by the core when _isRunning was still true — causing
+     * clicks fired during the tail of the previous run to disappear.
+     *
+     * Now we await waitForIdle() before dispatching so the event is
+     * reliably delivered as soon as the in-flight run completes. Callers
+     * do not need their own queueing primitive.
+     */
     sendSystemEvent(systemEvent: SystemEvent): Promise<void>;
     cancelRun(): void;
     clear(): void;
     reset(messages?: Message[]): void;
     setConversationId(conversationId: string | undefined): void;
     setTitle(title: string | undefined): void;
+    updateMessageContent(messageId: string, updater: (content: MessageContent[]) => MessageContent[]): void;
     subscribe(callback: () => void): Unsubscribe;
 }

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

@@ -1,6 +1,6 @@
 import { CapabilityExecutionManager } from '../../core';
 import { StreamAdapter, SystemEvent } from '../../types/adapters';
-import { AppendMessage, Message } from '../../types/message';
+import { AppendMessage, Message, MessageContent } from '../../types/message';
 import { RuntimeCapabilities } from '../../types/thread';
 import { BaseSubscribable } from '../../utils/Subscribable';
 export interface ThreadRuntimeCoreConfig {
@@ -19,6 +19,7 @@ export declare class ThreadRuntimeCore extends BaseSubscribable {
     private _abortController;
     private _conversationId?;
     private _title?;
+    private _idleWaiters;
     private _currentPart;
     constructor(config: ThreadRuntimeCoreConfig);
     get messages(): readonly Message[];
@@ -34,6 +35,16 @@ export declare class ThreadRuntimeCore extends BaseSubscribable {
     get capabilities(): RuntimeCapabilities;
     private updateMessages;
     append(message: AppendMessage): void;
+    /**
+     * Resolves when _isRunning flips to false. Use this to queue a
+     * follow-on dispatch (e.g. a system event from a card click that
+     * fires during the tail of the previous run) without racing the
+     * in-progress run's guard.
+     *
+     * Resolves immediately if nothing is running.
+     */
+    waitForIdle(): Promise<void>;
+    private drainIdleWaiters;
     startSystemEventRun(systemEvent: SystemEvent): Promise<void>;
     startRun(userMessage: AppendMessage): Promise<void>;
     private handleStreamEvent;
@@ -47,4 +58,5 @@ export declare class ThreadRuntimeCore extends BaseSubscribable {
     reset(messages?: Message[]): void;
     setConversationId(conversationId: string | undefined): void;
     setTitle(title: string | undefined): void;
+    updateMessageContent(messageId: string, updater: (content: MessageContent[]) => MessageContent[]): void;
 }

package/dist/types/index.d.ts

@@ -5,3 +5,4 @@ export type { StreamAdapter, ThreadListAdapter, StreamEvent, StreamRequest, Stre
 export type { SSEEvent } from '../utils/BaseSSEStreamAdapter';
 export type { CapabilityStatus, CapabilityExecutionContext, CapabilityExecution, CapabilityHandler, CapabilityRendererProps, CapabilityRenderer, CapabilityConfig, CapabilityContent } from './capability';
 export type { ChatContextItem, ChatContextMap, ChatContextData, ChatContextValue } from './context';
+export type { QuickAction, QuickActionConfig, QuickActionScopeMode, QuickActionScopeConfig, QuickActionFilter } from './quick-action';

package/dist/types/quick-action.d.ts

@@ -0,0 +1,21 @@
+export interface QuickAction {
+    id: string;
+    label: string;
+    prompt: string;
+    icon?: string;
+    description?: string;
+    priority?: number;
+    scope?: string;
+}
+export interface QuickActionConfig extends QuickAction {
+    condition?: () => boolean | Promise<boolean>;
+}
+export type QuickActionScopeMode = 'replace' | 'append' | 'merge';
+export interface QuickActionScopeConfig {
+    scope: string;
+    mode?: QuickActionScopeMode;
+}
+export interface QuickActionFilter {
+    scope?: string;
+    visible?: boolean;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@harnessio/ai-chat-core",
-  "version": "0.0.20",
+  "version": "0.0.22",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "private": false,
@@ -52,6 +52,7 @@
     "build": "vite build",
     "build:ci": "vite build",
     "build:watch": "vite build --watch",
+    "test": "jest",
     "pretty": "prettier --check ./src",
     "pre-commit": "lint-staged"
   }