@mondaydotcomorg/atp-client 0.17.14

package/README.md

@@ -0,0 +1,397 @@
+# @mondaydotcomorg/atp-client
+
+Client library for connecting to Agent Tool Protocol servers and executing code.
+
+## Overview
+
+The ATP client enables agents to connect to ATP servers, execute TypeScript code with runtime APIs, handle pauses for LLM/approval/embedding callbacks, and manage client-side tool execution.
+
+## Installation
+
+```bash
+npm install @mondaydotcomorg/atp-client
+```
+
+## Architecture
+
+```mermaid
+graph TB
+    Client[AgentToolProtocolClient] --> Session[ClientSession]
+    Client --> API[APIOperations]
+    Client --> Exec[ExecutionOperations]
+    Client --> Services[ServiceProviders]
+
+    Services --> LLM[LLM Handler]
+    Services --> Approval[Approval Handler]
+    Services --> Embedding[Embedding Handler]
+    Services --> Tools[Client Tools]
+
+    Exec --> Pause[Pause/Resume]
+    Session --> Hooks[Pre-Request Hooks]
+```
+
+## Quick Start
+
+### Basic Client
+
+```typescript
+import { AgentToolProtocolClient } from '@mondaydotcomorg/atp-client';
+
+const client = new AgentToolProtocolClient({
+	baseUrl: 'http://localhost:3333',
+	headers: {
+		Authorization: 'Bearer your-api-key',
+	},
+});
+
+await client.init();
+
+// Execute code
+const result = await client.execute({
+	code: `
+    const items = ['apple', 'banana', 'cherry'];
+    return items.length;
+  `,
+});
+
+console.log(result.result); // 3
+```
+
+### With LLM Support
+
+```typescript
+import { ChatOpenAI } from '@langchain/openai';
+
+const llm = new ChatOpenAI({ modelName: 'gpt-4' });
+
+const client = new AgentToolProtocolClient({
+	baseUrl: 'http://localhost:3333',
+	headers: { Authorization: 'Bearer key' },
+});
+
+// Provide LLM for atp.llm.* calls
+client.provideLLM({
+	call: async (prompt, options) => {
+		const response = await llm.invoke(prompt);
+		return response.content;
+	},
+});
+
+await client.init();
+
+// Now code can use atp.llm.call()
+const result = await client.execute({
+	code: `
+    const joke = await atp.llm.call({
+      prompt: 'Tell me a programming joke',
+    });
+    return joke;
+  `,
+});
+```
+
+### With Embeddings
+
+```typescript
+import { OpenAIEmbeddings } from '@langchain/openai';
+
+const embeddings = new OpenAIEmbeddings();
+
+client.provideEmbedding({
+	embed: async (text) => {
+		const vector = await embeddings.embedQuery(text);
+		// Store and return ID
+		return 'embedding-id-123';
+	},
+	search: async (query, options) => {
+		const queryVector = await embeddings.embedQuery(query);
+		// Perform similarity search
+		return results;
+	},
+});
+
+// Code can now use atp.embedding.*
+const result = await client.execute({
+	code: `
+    const id = await atp.embedding.embed('Important document');
+    const similar = await atp.embedding.search('document', { topK: 5 });
+    return similar;
+  `,
+});
+```
+
+### With Approval Handler
+
+```typescript
+client.provideApproval({
+	request: async (message, context) => {
+		// Prompt user for approval
+		const approved = await askUser(message);
+		return {
+			approved,
+			response: { reason: 'User decision' },
+			timestamp: Date.now(),
+		};
+	},
+});
+
+// Code can use atp.approval.request()
+const result = await client.execute({
+	code: `
+    const approval = await atp.approval.request(
+      'Delete all files?',
+      { critical: true }
+    );
+    
+    if (!approval.approved) {
+      return { cancelled: true };
+    }
+    
+    return { deleted: true };
+  `,
+});
+```
+
+### Client-Side Tools
+
+Register custom tools that execute on the client:
+
+```typescript
+import { createClientTool } from '@mondaydotcomorg/atp-client';
+
+const fetchTool = createClientTool({
+	name: 'fetch',
+	description: 'Make HTTP requests from client',
+	inputSchema: {
+		type: 'object',
+		properties: {
+			url: { type: 'string' },
+			method: { type: 'string', enum: ['GET', 'POST'] },
+		},
+		required: ['url'],
+	},
+	handler: async (input) => {
+		const response = await fetch(input.url, {
+			method: input.method || 'GET',
+		});
+		return await response.json();
+	},
+});
+
+const client = new AgentToolProtocolClient({
+	baseUrl: 'http://localhost:3333',
+	headers: { Authorization: 'Bearer key' },
+	serviceProviders: {
+		tools: [fetchTool],
+	},
+});
+
+await client.init(); // Registers tools with server
+
+// Code can now use atp.tool.fetch()
+const result = await client.execute({
+	code: `
+    const data = await atp.tool.fetch({
+      url: 'https://api.example.com/data',
+      method: 'GET',
+    });
+    return data;
+  `,
+});
+```
+
+### Pre-Request Hooks
+
+Intercept and modify requests (e.g., token refresh):
+
+```typescript
+const client = new AgentToolProtocolClient({
+	baseUrl: 'http://localhost:3333',
+	hooks: {
+		preRequest: async (context) => {
+			// Refresh token if needed
+			if (tokenExpired()) {
+				const newToken = await refreshToken();
+				return {
+					headers: {
+						...context.currentHeaders,
+						Authorization: `Bearer ${newToken}`,
+					},
+				};
+			}
+			return {};
+		},
+	},
+});
+```
+
+## Core Features
+
+### Execute Code
+
+```typescript
+const result = await client.execute({
+	code: 'return 1 + 1',
+	timeout: 30000,
+	pausable: true,
+});
+
+// Result structure
+interface ExecutionResult {
+	status: 'success' | 'error' | 'paused' | 'timeout';
+	result?: unknown;
+	error?: string;
+	pauseReason?: string;
+	executionId?: string;
+}
+```
+
+### Search APIs
+
+```typescript
+const results = await client.search({
+	query: 'user authentication',
+	limit: 10,
+});
+
+// Search by natural language query
+const searchResults = await client.searchQuery('how to create a user');
+```
+
+### Explore APIs
+
+```typescript
+const schema = await client.explore();
+
+// Returns API structure
+interface ExploreResult {
+	apis: Array<{
+		name: string;
+		description: string;
+		functions: Array<{
+			name: string;
+			description: string;
+			parameters: unknown;
+		}>;
+	}>;
+}
+```
+
+### Type Definitions
+
+```typescript
+const types = await client.getTypeDefinitions();
+// Returns TypeScript definitions for atp.* APIs
+```
+
+## API Reference
+
+### AgentToolProtocolClient
+
+```typescript
+class AgentToolProtocolClient {
+	constructor(options: AgentToolProtocolClientOptions);
+
+	// Initialize session
+	init(clientInfo?: Record<string, unknown>): Promise<{
+		clientId: string;
+		token: string;
+		expiresAt: number;
+		tokenRotateAt: number;
+	}>;
+
+	// Execute code
+	execute(config: ExecutionConfig): Promise<ExecutionResult>;
+
+	// Resume paused execution
+	resume(executionId: string, resumeData: ResumeData): Promise<ExecutionResult>;
+
+	// Provide services
+	provideLLM(handler: ClientLLMHandler): void;
+	provideApproval(handler: ClientApprovalHandler): void;
+	provideEmbedding(handler: ClientEmbeddingHandler): void;
+
+	// API discovery
+	search(options: SearchOptions): Promise<SearchResult[]>;
+	searchQuery(query: string, options?: SearchOptions): Promise<SearchResult[]>;
+	explore(): Promise<ExploreResult>;
+	getTypeDefinitions(): Promise<string>;
+
+	// Session info
+	getClientId(): string;
+}
+```
+
+### Options
+
+```typescript
+interface AgentToolProtocolClientOptions {
+	baseUrl: string;
+	headers?: Record<string, string>;
+	serviceProviders?: {
+		llm?: ClientLLMHandler;
+		approval?: ClientApprovalHandler;
+		embedding?: ClientEmbeddingHandler;
+		tools?: ClientTool[];
+	};
+	hooks?: {
+		preRequest?: (context: HookContext) => Promise<HookResult>;
+	};
+}
+```
+
+## Flow Diagram
+
+```mermaid
+sequenceDiagram
+    participant Agent
+    participant Client
+    participant Server
+    participant LLM
+
+    Agent->>Client: execute(code)
+    Client->>Server: POST /execute
+    Server->>Server: Run code
+
+    alt Code calls atp.llm.call()
+        Server->>Client: Pause (LLM callback)
+        Client->>Agent: Request LLM
+        Agent->>LLM: API call
+        LLM-->>Agent: Response
+        Agent->>Client: Resume with result
+        Client->>Server: POST /resume
+        Server->>Server: Continue execution
+    end
+
+    Server-->>Client: Execution result
+    Client-->>Agent: Return result
+```
+
+## Error Handling
+
+```typescript
+import { ExecutionStatus } from '@mondaydotcomorg/atp-client';
+
+try {
+	const result = await client.execute({ code: '...' });
+
+	if (result.status === ExecutionStatus.ERROR) {
+		console.error('Execution failed:', result.error);
+	} else if (result.status === ExecutionStatus.TIMEOUT) {
+		console.error('Execution timed out');
+	} else if (result.status === ExecutionStatus.PAUSED) {
+		console.log('Execution paused:', result.pauseReason);
+		// Handle pause (resume later)
+	}
+} catch (error) {
+	console.error('Client error:', error);
+}
+```
+
+## TypeScript Support
+
+Full TypeScript definitions with strict typing for all APIs.
+
+## License
+
+MIT

package/dist/client.d.ts

@@ -0,0 +1,125 @@
+import type { ExecutionResult, ExecutionConfig, SearchOptions, SearchResult, ClientTool, ExploreResult } from '@mondaydotcomorg/atp-protocol';
+import { CallbackType } from '@mondaydotcomorg/atp-protocol';
+import { type ClientLLMHandler, type ClientApprovalHandler, type ClientEmbeddingHandler, type ClientServiceProviders, type ClientHooks } from './core/index.js';
+/**
+ * Options for creating an AgentToolProtocolClient
+ */
+export interface AgentToolProtocolClientOptions {
+    /** Base URL of the Agent Tool Protocol server */
+    baseUrl: string;
+    /** Optional headers for authentication (e.g., { Authorization: 'Bearer token' }) */
+    headers?: Record<string, string>;
+    /** Optional client-provided services (LLM, approval, embedding) */
+    serviceProviders?: ClientServiceProviders;
+    /** Optional hooks for intercepting and modifying client behavior */
+    hooks?: ClientHooks;
+}
+/**
+ * AgentToolProtocolClient provides a client interface for connecting to
+ * Agent Tool Protocol servers and executing code.
+ */
+export declare class AgentToolProtocolClient {
+    private session;
+    private apiOps;
+    private execOps;
+    private serviceProviders;
+    /**
+     * Creates a new client instance.
+     *
+     * @example
+     * ```typescript
+     * const client = new AgentToolProtocolClient({
+     *   baseUrl: 'http://localhost:3333',
+     *   headers: { Authorization: 'Bearer token' },
+     *   hooks: {
+     *     preRequest: async (context) => {
+     *       const token = await refreshToken();
+     *       return { headers: { ...context.currentHeaders, Authorization: `Bearer ${token}` } };
+     *     }
+     *   }
+     * });
+     * ```
+     */
+    constructor(options: AgentToolProtocolClientOptions);
+    /**
+     * Initializes the client session with the server.
+     * Automatically registers any client-provided tools with the server.
+     */
+    init(clientInfo?: {
+        name?: string;
+        version?: string;
+        [key: string]: unknown;
+    }): Promise<{
+        clientId: string;
+        token: string;
+        expiresAt: number;
+        tokenRotateAt: number;
+    }>;
+    /**
+     * Gets the unique client ID.
+     */
+    getClientId(): string;
+    /**
+     * Provides an LLM implementation for server to use during execution.
+     */
+    provideLLM(handler: ClientLLMHandler): void;
+    /**
+     * Provides an approval handler for server to request human approval.
+     */
+    provideApproval(handler: ClientApprovalHandler): void;
+    /**
+     * Provides an embedding model for server to use.
+     */
+    provideEmbedding(handler: ClientEmbeddingHandler): void;
+    /**
+     * Provides custom tools that execute on the client side.
+     * Note: Must be called before init() or re-initialize after calling this.
+     */
+    provideTools(tools: ClientTool[]): void;
+    /**
+     * Connects to the server and retrieves API definitions.
+     */
+    connect(options?: {
+        apiGroups?: string[];
+    }): Promise<{
+        serverVersion: string;
+        capabilities: unknown;
+        apiGroups: string[];
+    }>;
+    /**
+     * Gets the TypeScript type definitions for available APIs.
+     */
+    getTypeDefinitions(): string;
+    /**
+     * Searches for available API functions.
+     */
+    searchAPI(query: string, options?: SearchOptions): Promise<SearchResult[]>;
+    /**
+     * Explores the API filesystem at the given path.
+     */
+    exploreAPI(path: string): Promise<ExploreResult>;
+    /**
+     * Executes code on the server with real-time progress updates via SSE.
+     */
+    executeStream(code: string, config?: Partial<ExecutionConfig>, onProgress?: (message: string, fraction: number) => void): Promise<ExecutionResult>;
+    /**
+     * Executes code on the server in a sandboxed environment.
+     */
+    execute(code: string, config?: Partial<ExecutionConfig>): Promise<ExecutionResult>;
+    /**
+     * Resumes a paused execution with a callback result.
+     */
+    resume(executionId: string, callbackResult: unknown): Promise<ExecutionResult>;
+    /**
+     * Handles a callback request from the server during execution.
+     */
+    handleCallback(callbackType: CallbackType, payload: any): Promise<any>;
+    /**
+     * Gets information about the server.
+     */
+    getServerInfo(): Promise<{
+        version: string;
+        capabilities: Record<string, boolean>;
+    }>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

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

package/dist/client.js

@@ -0,0 +1,129 @@
+import { ClientSession, APIOperations, ExecutionOperations, ServiceProviders, } from './core/index.js';
+/**
+ * AgentToolProtocolClient provides a client interface for connecting to
+ * Agent Tool Protocol servers and executing code.
+ */
+export class AgentToolProtocolClient {
+    session;
+    apiOps;
+    execOps;
+    serviceProviders;
+    /**
+     * Creates a new client instance.
+     *
+     * @example
+     * ```typescript
+     * const client = new AgentToolProtocolClient({
+     *   baseUrl: 'http://localhost:3333',
+     *   headers: { Authorization: 'Bearer token' },
+     *   hooks: {
+     *     preRequest: async (context) => {
+     *       const token = await refreshToken();
+     *       return { headers: { ...context.currentHeaders, Authorization: `Bearer ${token}` } };
+     *     }
+     *   }
+     * });
+     * ```
+     */
+    constructor(options) {
+        const { baseUrl, headers, serviceProviders, hooks } = options;
+        this.session = new ClientSession(baseUrl, headers, hooks);
+        this.serviceProviders = new ServiceProviders(serviceProviders);
+        this.apiOps = new APIOperations(this.session);
+        this.execOps = new ExecutionOperations(this.session, this.serviceProviders);
+    }
+    /**
+     * Initializes the client session with the server.
+     * Automatically registers any client-provided tools with the server.
+     */
+    async init(clientInfo) {
+        const toolDefinitions = this.serviceProviders.getToolDefinitions();
+        return await this.session.init(clientInfo, toolDefinitions);
+    }
+    /**
+     * Gets the unique client ID.
+     */
+    getClientId() {
+        return this.session.getClientId();
+    }
+    /**
+     * Provides an LLM implementation for server to use during execution.
+     */
+    provideLLM(handler) {
+        this.serviceProviders.provideLLM(handler);
+    }
+    /**
+     * Provides an approval handler for server to request human approval.
+     */
+    provideApproval(handler) {
+        this.serviceProviders.provideApproval(handler);
+    }
+    /**
+     * Provides an embedding model for server to use.
+     */
+    provideEmbedding(handler) {
+        this.serviceProviders.provideEmbedding(handler);
+    }
+    /**
+     * Provides custom tools that execute on the client side.
+     * Note: Must be called before init() or re-initialize after calling this.
+     */
+    provideTools(tools) {
+        this.serviceProviders.provideTools(tools);
+    }
+    /**
+     * Connects to the server and retrieves API definitions.
+     */
+    async connect(options) {
+        return await this.apiOps.connect(options);
+    }
+    /**
+     * Gets the TypeScript type definitions for available APIs.
+     */
+    getTypeDefinitions() {
+        return this.apiOps.getTypeDefinitions();
+    }
+    /**
+     * Searches for available API functions.
+     */
+    async searchAPI(query, options) {
+        return await this.apiOps.searchAPI(query, options);
+    }
+    /**
+     * Explores the API filesystem at the given path.
+     */
+    async exploreAPI(path) {
+        return await this.apiOps.exploreAPI(path);
+    }
+    /**
+     * Executes code on the server with real-time progress updates via SSE.
+     */
+    async executeStream(code, config, onProgress) {
+        return await this.execOps.executeStream(code, config, onProgress);
+    }
+    /**
+     * Executes code on the server in a sandboxed environment.
+     */
+    async execute(code, config) {
+        return await this.execOps.execute(code, config);
+    }
+    /**
+     * Resumes a paused execution with a callback result.
+     */
+    async resume(executionId, callbackResult) {
+        return await this.execOps.resume(executionId, callbackResult);
+    }
+    /**
+     * Handles a callback request from the server during execution.
+     */
+    async handleCallback(callbackType, payload) {
+        return await this.serviceProviders.handleCallback(callbackType, payload);
+    }
+    /**
+     * Gets information about the server.
+     */
+    async getServerInfo() {
+        return await this.apiOps.getServerInfo();
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/core/api-operations.d.ts

@@ -0,0 +1,37 @@
+import type { SearchOptions, SearchResult, ExploreResult } from '@mondaydotcomorg/atp-protocol';
+import type { ClientSession } from './session.js';
+export declare class APIOperations {
+    private session;
+    private apiDefinitions?;
+    constructor(session: ClientSession);
+    /**
+     * Connects to the server and retrieves API definitions.
+     */
+    connect(options?: {
+        apiGroups?: string[];
+    }): Promise<{
+        serverVersion: string;
+        capabilities: unknown;
+        apiGroups: string[];
+    }>;
+    /**
+     * Gets the TypeScript type definitions for available APIs.
+     */
+    getTypeDefinitions(): string;
+    /**
+     * Searches for available API functions.
+     */
+    searchAPI(query: string, options?: SearchOptions): Promise<SearchResult[]>;
+    /**
+     * Explores the API filesystem at the given path.
+     */
+    exploreAPI(path: string): Promise<ExploreResult>;
+    /**
+     * Gets information about the server.
+     */
+    getServerInfo(): Promise<{
+        version: string;
+        capabilities: Record<string, boolean>;
+    }>;
+}
+//# sourceMappingURL=api-operations.d.ts.map

package/dist/core/api-operations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-operations.d.ts","sourceRoot":"","sources":["../../src/core/api-operations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAChG,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElD,qBAAa,aAAa;IACzB,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,cAAc,CAAC,CAAS;gBAEpB,OAAO,EAAE,aAAa;IAIlC;;OAEG;IACG,OAAO,CAAC,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,OAAO,CAAC;QAC1D,aAAa,EAAE,MAAM,CAAC;QACtB,YAAY,EAAE,OAAO,CAAC;QACtB,SAAS,EAAE,MAAM,EAAE,CAAC;KACpB,CAAC;IA+BF;;OAEG;IACH,kBAAkB,IAAI,MAAM;IAO5B;;OAEG;IACG,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAqBhF;;OAEG;IACG,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAoBtD;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC;QAC9B,OAAO,EAAE,MAAM,CAAC;QAChB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACtC,CAAC;CAiBF"}