@automattic/agenttic-client 0.1.14 → 0.1.15

package/README.md

@@ -10,9 +10,10 @@ npm install @automattic/agenttic-client
 
 ## Key Features
 
--   React hooks for agent communication (`useAgentChat`, `useClientContext`, `useClientTools`)
+-   React hooks for agent communication (`useAgentChat`, `useClientContext`, `useClientTools`, `useClientAbilities`)
 -   Streaming and non-streaming responses
 -   Tool execution system with automatic handling
+-   Compatibility with [WordPress Abilities API](https://github.com/WordPress/abilities-api)
 -   Context injection for each message
 -   Conversation persistence and management
 -   Request cancellation with abort controllers
@@ -102,6 +103,44 @@ function AdvancedChatComponent() {
 }
 ```
 
+### With Abilities
+
+WordPress Abilities API integration allows you to expose WordPress capabilities as tools to agents.
+
+```typescript
+import { useAgentChat, useClientAbilities } from '@automattic/agenttic-client';
+import { getAbilities, executeAbility } from '@wordpress/abilities';
+
+function WordPressChat() {
+  const [abilities, setAbilities] = useState([]);
+
+  useEffect(() => {
+    getAbilities().then(setAbilities);
+  }, []);
+
+  const toolProvider = useClientAbilities(abilities, executeAbility);
+
+  const chat = useAgentChat({
+    agentId: 'wp-assistant',
+    toolProvider,
+    authProvider: async () => ({ Authorization: 'Bearer token' })
+  });
+
+  return <ChatInterface {...chat} />;
+}
+```
+
+You can also combine regular tools with abilities using `useClientToolsWithAbilities`:
+
+```typescript
+const toolProvider = useClientToolsWithAbilities({
+  getClientTools: async () => myCustomTools,
+  executeTool: async (toolId, args) => { /* execute custom tools */ },
+  abilities,
+  executeAbility
+});
+```
+
 ## Core APIs
 
 ### useAgentChat Hook
@@ -189,6 +228,44 @@ const toolProvider = useClientTools(
 );
 ```
 
+### useClientAbilities Hook
+
+Converts WordPress Abilities to Agenttic tools automatically.
+
+```typescript
+import { getAbilities, executeAbility } from '@wordpress/abilities';
+
+const abilities = await getAbilities();
+const toolProvider = useClientAbilities( abilities, executeAbility );
+```
+
+WordPress Abilities can be:
+- **Server-side**: Executed via REST API (no `callback` property)
+- **Client-side**: Executed in browser (has `callback` function)
+
+The API handles both types automatically, routing execution appropriately.
+
+### useClientToolsWithAbilities Hook
+
+Combines regular tools and WordPress Abilities in a single provider.
+
+```typescript
+import { getAbilities, executeAbility } from '@wordpress/abilities';
+
+const abilities = await getAbilities();
+const toolProvider = useClientToolsWithAbilities( {
+	getClientTools: async () => [
+		// Your regular tools
+		{ id: 'calculator', name: 'Calculator', /* ... */ },
+	],
+	executeTool: async ( toolId, args ) => {
+		// Handle regular tool execution
+	},
+	abilities,
+	executeAbility,
+} );
+```
+
 ### createClient Function
 
 Low-level client for direct A2A communication without React.

package/dist/client/types/index.d.ts

@@ -183,6 +183,7 @@ export interface ToolExecutionResult {
 export interface ToolProvider {
     getAvailableTools(): Promise<Tool[]>;
     executeTool(toolId: string, args: any, messageId?: string, toolCallId?: string): Promise<any | ToolExecutionResult>;
+    abilities?: Ability[];
 }
 export interface ToolCallResult {
     toolCallId: string;
@@ -190,6 +191,60 @@ export interface ToolCallResult {
     result: any;
     error?: string;
 }
+/**
+ * WordPress Ability interface
+ *
+ * This is a copy of the Ability interface from @wordpress/abilities.
+ * We maintain our own copy to avoid runtime dependencies. The interface is stable as part of WordPress core.
+ *
+ * @see https://github.com/WordPress/abilities-api
+ */
+export interface Ability {
+    /**
+     * The unique name/identifier of the ability, with its namespace.
+     * Example: 'my-plugin/my-ability'
+     */
+    name: string;
+    /**
+     * The human-readable label for the ability.
+     */
+    label: string;
+    /**
+     * The detailed description of the ability.
+     */
+    description: string;
+    /**
+     * JSON Schema for the ability's input parameters.
+     */
+    input_schema?: Record<string, any>;
+    /**
+     * JSON Schema for the ability's output format.
+     * Note: This is not directly used by Agenttic tools but preserved for validation and used by the Ability API.
+     */
+    output_schema?: Record<string, any>;
+    /**
+     * Callback function for client-side abilities.
+     * If present, the ability will be executed locally in the browser.
+     * If not present, the ability will be executed via REST API on the server.
+     */
+    callback?: (input: any) => any | Promise<any>;
+    /**
+     * Client permission callback for abilities.
+     * Called before executing the ability to check if it's allowed.
+     */
+    permissionCallback?: (input?: any) => boolean | Promise<boolean>;
+    /**
+     * Metadata about the ability.
+     */
+    meta?: {
+        type?: 'resource' | 'tool';
+        [key: string]: any;
+    };
+}
+/**
+ * Type for the executeAbility function from @wordpress/abilities
+ */
+export type ExecuteAbilityFunction = (name: string, input?: any) => Promise<any>;
 export type ClientContext = Record<string, unknown>;
 export interface ContextProvider {
     getClientContext(): ClientContext;

package/dist/client/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/client/types/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/client/types/index.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -4,19 +4,16 @@
  * A TypeScript client library for communication with WPcom Agent API
  */
 export { useClientContext } from './react/useClientContext';
-export { useClientTools } from './react/useClientTools';
+export { useClientTools, useClientAbilities, useClientToolsWithAbilities, type UseClientToolsWithAbilitiesConfig, } from './react/useClientTools';
 export { useAgentChat } from './react/useAgentChat';
 export { createRequestId, createTaskId, createTextMessage, extractToolCallsFromMessage, extractTextFromMessage, createAbortController, } from './client/utils/core';
-export { createMessageRenderer } from './utils/createMessageRenderer';
-export type { JsonRpcId, JsonRpcRequest, JsonRpcResponse, JsonRpcError, TaskState, TextPart, FilePart, DataPart, ToolDataPart, ToolCallDataPart, ContextDataPart, Part, Message, TaskStatus, Artifact, Task, MessageSendParams, SendMessageRequest, SendMessageResponse, TaskStatusUpdateEvent, TaskArtifactUpdateEvent, Client, AuthProvider, ClientConfig, SendMessageParams, TaskUpdate, Tool, ToolProvider, ToolCallResult, ClientContext, ContextProvider, } from './client/types/index';
-export type { UseAgentChatConfig, UseAgentChatReturn, UIMessage, Suggestion, MarkdownComponents, } from './react/useAgentChat';
+export type { JsonRpcId, JsonRpcRequest, JsonRpcResponse, JsonRpcError, TaskState, TextPart, FilePart, DataPart, ToolDataPart, ToolCallDataPart, ContextDataPart, Part, Message, TaskStatus, Artifact, Task, MessageSendParams, SendMessageRequest, SendMessageResponse, TaskStatusUpdateEvent, TaskArtifactUpdateEvent, Client, AuthProvider, ClientConfig, SendMessageParams, TaskUpdate, Tool, ToolProvider, ToolCallResult, Ability, ExecuteAbilityFunction, ClientContext, ContextProvider, } from './client/types/index';
+export type { UseAgentChatConfig, UseAgentChatReturn, UIMessage, Suggestion, } from './react/useAgentChat';
 export { A2AErrorCodes } from './client/types/index';
 export { createClient } from './client/index';
 export { getAgentManager } from './react/agentManager';
 export type { AgentManager, AgentManagerConfig } from './react/agentManager';
-export { BarChart, LineChart, ChartBlock } from './markdown-extensions/charts';
-export type { MarkdownExtensions, ChartExtensionConfig, ChartData, ChartSeries, } from './markdown-extensions/types';
-export { createFeedbackActions, useMessageActions } from './message-actions';
-export type { FeedbackActionsManager } from './message-actions';
+export { useMessageActions } from './message-actions';
 export { createJetpackAuthProvider, type JetpackErrorHandler, type JetpackApiError, } from './auth/jetpack';
+export { convertAbilityToTool, convertAbilitiesToTools, isWordPressAbility, } from './utils/wordpressAbilities';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAGpD,OAAO,EACN,eAAe,EACf,YAAY,EACZ,iBAAiB,EACjB,2BAA2B,EAC3B,sBAAsB,EACtB,qBAAqB,GACrB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAGtE,YAAY,EAEX,SAAS,EACT,cAAc,EACd,eAAe,EACf,YAAY,EACZ,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,IAAI,EACJ,OAAO,EACP,UAAU,EACV,QAAQ,EACR,IAAI,EACJ,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,qBAAqB,EACrB,uBAAuB,EAGvB,MAAM,EACN,YAAY,EACZ,YAAY,EACZ,iBAAiB,EACjB,UAAU,EAGV,IAAI,EACJ,YAAY,EACZ,cAAc,EAGd,aAAa,EACb,eAAe,GACf,MAAM,sBAAsB,CAAC;AAG9B,YAAY,EACX,kBAAkB,EAClB,kBAAkB,EAClB,SAAS,EACT,UAAU,EACV,kBAAkB,GAClB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAGrD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAG9C,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,YAAY,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAG7E,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAC/E,YAAY,EACX,kBAAkB,EAClB,oBAAoB,EACpB,SAAS,EACT,WAAW,GACX,MAAM,6BAA6B,CAAC;AAGrC,OAAO,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC7E,YAAY,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAGhE,OAAO,EACN,yBAAyB,EACzB,KAAK,mBAAmB,EACxB,KAAK,eAAe,GACpB,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EACN,cAAc,EACd,kBAAkB,EAClB,2BAA2B,EAC3B,KAAK,iCAAiC,GACtC,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAGpD,OAAO,EACN,eAAe,EACf,YAAY,EACZ,iBAAiB,EACjB,2BAA2B,EAC3B,sBAAsB,EACtB,qBAAqB,GACrB,MAAM,qBAAqB,CAAC;AAG7B,YAAY,EAEX,SAAS,EACT,cAAc,EACd,eAAe,EACf,YAAY,EACZ,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,IAAI,EACJ,OAAO,EACP,UAAU,EACV,QAAQ,EACR,IAAI,EACJ,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,qBAAqB,EACrB,uBAAuB,EAGvB,MAAM,EACN,YAAY,EACZ,YAAY,EACZ,iBAAiB,EACjB,UAAU,EAGV,IAAI,EACJ,YAAY,EACZ,cAAc,EAGd,OAAO,EACP,sBAAsB,EAGtB,aAAa,EACb,eAAe,GACf,MAAM,sBAAsB,CAAC;AAG9B,YAAY,EACX,kBAAkB,EAClB,kBAAkB,EAClB,SAAS,EACT,UAAU,GACV,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAGrD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAG9C,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,YAAY,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAG7E,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAGtD,OAAO,EACN,yBAAyB,EACzB,KAAK,mBAAmB,EACxB,KAAK,eAAe,GACpB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACN,oBAAoB,EACpB,uBAAuB,EACvB,kBAAkB,GAClB,MAAM,4BAA4B,CAAC"}