@harnessio/ai-chat-core 0.0.21 → 0.0.23

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

@@ -8,3 +8,7 @@ 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';
+export { useRegisterQuickActions } from './useRegisterQuickActions';

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/react/hooks/useRegisterQuickActions.d.ts

@@ -0,0 +1,25 @@
+import { QuickActionConfig } from '../../types/quick-action';
+/**
+ * Register multiple quick actions at once.
+ *
+ * All actions are automatically registered when the component mounts and
+ * unregistered when it unmounts. This hook is useful for registering
+ * multiple quick actions from a centralized configuration array.
+ *
+ * @param actions - Array of quick action configurations to register
+ * @param scope - Optional scope for the actions (defaults to active scope)
+ *
+ * @example
+ * ```tsx
+ * const GLOBAL_ACTIONS = [
+ *   { id: 'action-1', label: 'Action 1', prompt: 'Do action 1', icon: 'star' },
+ *   { id: 'action-2', label: 'Action 2', prompt: 'Do action 2', icon: 'heart' },
+ * ]
+ *
+ * function MyQuickActions() {
+ *   useRegisterQuickActions(GLOBAL_ACTIONS, 'global')
+ *   return null
+ * }
+ * ```
+ */
+export declare function useRegisterQuickActions(actions: QuickActionConfig[], scope?: string): void;

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';
@@ -40,5 +40,6 @@ export declare class ThreadRuntime extends BaseSubscribable {
     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 {
@@ -58,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.21",
+  "version": "0.0.23",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "private": false,