@mondaydotcomorg/atp-client 0.17.14

package/dist/tools/explore-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"explore-api.d.ts","sourceRoot":"","sources":["../../src/tools/explore-api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAC5D,OAAO,EAAa,KAAK,IAAI,EAAE,MAAM,YAAY,CAAC;AAElD,QAAA,MAAM,qBAAqB;;;;;;EAIzB,CAAC;AAEH,KAAK,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAE7D,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,uBAAuB,GAAG,IAAI,CAAC,eAAe,CAAC,CAiD3F"}

package/dist/tools/explore-api.js

@@ -0,0 +1,47 @@
+import { z } from 'zod';
+import { zodToJsonSchema } from 'zod-to-json-schema';
+import { ToolNames } from './types.js';
+const exploreApiInputSchema = z.object({
+    path: z
+        .string()
+        .describe('Path to explore (e.g., "/", "/openapi/github", "/mcp/filesystem/read_file")'),
+});
+export function createExploreApiTool(client) {
+    return {
+        name: ToolNames.EXPLORE_API,
+        description: 'Explore APIs using filesystem-like navigation. Navigate through directories to discover available functions. Provide path as string like "/", "/openapi", "/openapi/github", or "/openapi/github/repos/createRepo" to see functions.',
+        inputSchema: zodToJsonSchema(exploreApiInputSchema),
+        zodSchema: exploreApiInputSchema,
+        func: async (input) => {
+            try {
+                const result = await client.exploreAPI(input.path);
+                if (result.type === 'directory') {
+                    return JSON.stringify({
+                        success: true,
+                        type: 'directory',
+                        path: result.path,
+                        items: result.items,
+                    }, null, 2);
+                }
+                else {
+                    return JSON.stringify({
+                        success: true,
+                        type: 'function',
+                        name: result.name,
+                        description: result.description,
+                        definition: result.definition,
+                        group: result.group,
+                        path: result.path,
+                    }, null, 2);
+                }
+            }
+            catch (error) {
+                return JSON.stringify({
+                    success: false,
+                    error: error.message,
+                }, null, 2);
+            }
+        },
+    };
+}
+//# sourceMappingURL=explore-api.js.map

package/dist/tools/explore-api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"explore-api.js","sourceRoot":"","sources":["../../src/tools/explore-api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD,OAAO,EAAE,SAAS,EAAa,MAAM,YAAY,CAAC;AAElD,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,IAAI,EAAE,CAAC;SACL,MAAM,EAAE;SACR,QAAQ,CAAC,6EAA6E,CAAC;CACzF,CAAC,CAAC;AAIH,MAAM,UAAU,oBAAoB,CAAC,MAA+B;IACnE,OAAO;QACN,IAAI,EAAE,SAAS,CAAC,WAAW;QAC3B,WAAW,EACV,sOAAsO;QACvO,WAAW,EAAE,eAAe,CAAC,qBAAqB,CAAQ;QAC1D,SAAS,EAAE,qBAAqB;QAChC,IAAI,EAAE,KAAK,EAAE,KAAsB,EAAE,EAAE;YACtC,IAAI,CAAC;gBACJ,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAEnD,IAAI,MAAM,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;oBACjC,OAAO,IAAI,CAAC,SAAS,CACpB;wBACC,OAAO,EAAE,IAAI;wBACb,IAAI,EAAE,WAAW;wBACjB,IAAI,EAAE,MAAM,CAAC,IAAI;wBACjB,KAAK,EAAE,MAAM,CAAC,KAAK;qBACnB,EACD,IAAI,EACJ,CAAC,CACD,CAAC;gBACH,CAAC;qBAAM,CAAC;oBACP,OAAO,IAAI,CAAC,SAAS,CACpB;wBACC,OAAO,EAAE,IAAI;wBACb,IAAI,EAAE,UAAU;wBAChB,IAAI,EAAE,MAAM,CAAC,IAAI;wBACjB,WAAW,EAAE,MAAM,CAAC,WAAW;wBAC/B,UAAU,EAAE,MAAM,CAAC,UAAU;wBAC7B,KAAK,EAAE,MAAM,CAAC,KAAK;wBACnB,IAAI,EAAE,MAAM,CAAC,IAAI;qBACjB,EACD,IAAI,EACJ,CAAC,CACD,CAAC;gBACH,CAAC;YACF,CAAC;YAAC,OAAO,KAAU,EAAE,CAAC;gBACrB,OAAO,IAAI,CAAC,SAAS,CACpB;oBACC,OAAO,EAAE,KAAK;oBACd,KAAK,EAAE,KAAK,CAAC,OAAO;iBACpB,EACD,IAAI,EACJ,CAAC,CACD,CAAC;YACH,CAAC;QACF,CAAC;KACD,CAAC;AACH,CAAC"}

package/dist/tools/fetch-all-apis.d.ts

@@ -0,0 +1,14 @@
+import { z } from 'zod';
+import type { AgentToolProtocolClient } from '../client.js';
+import { type Tool } from './types';
+declare const fetchAllApisInputSchema: z.ZodObject<{
+    apiGroups: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    apiGroups?: string[] | undefined;
+}, {
+    apiGroups?: string[] | undefined;
+}>;
+type FetchAllApisInput = z.infer<typeof fetchAllApisInputSchema>;
+export declare function createFetchAllApisTool(client: AgentToolProtocolClient): Tool<FetchAllApisInput>;
+export {};
+//# sourceMappingURL=fetch-all-apis.d.ts.map

package/dist/tools/fetch-all-apis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-all-apis.d.ts","sourceRoot":"","sources":["../../src/tools/fetch-all-apis.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAC5D,OAAO,EAAa,KAAK,IAAI,EAAE,MAAM,SAAS,CAAC;AAE/C,QAAA,MAAM,uBAAuB;;;;;;EAE3B,CAAC;AAEH,KAAK,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAEjE,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,uBAAuB,GAAG,IAAI,CAAC,iBAAiB,CAAC,CA+B/F"}

package/dist/tools/fetch-all-apis.js

@@ -0,0 +1,31 @@
+import { z } from 'zod';
+import { zodToJsonSchema } from 'zod-to-json-schema';
+import { ToolNames } from './types';
+const fetchAllApisInputSchema = z.object({
+    apiGroups: z.array(z.string()).optional().describe('Optional: Specific API groups to include'),
+});
+export function createFetchAllApisTool(client) {
+    return {
+        name: ToolNames.FETCH_ALL_APIS,
+        description: 'Get TypeScript definitions of all available APIs. Returns code showing api.add, api.getTodo, etc.',
+        inputSchema: zodToJsonSchema(fetchAllApisInputSchema),
+        zodSchema: fetchAllApisInputSchema,
+        func: async (_input) => {
+            try {
+                const typescript = client.getTypeDefinitions();
+                return JSON.stringify({
+                    success: true,
+                    typescript,
+                    message: 'Use this TypeScript to understand available api.* functions',
+                }, null, 2);
+            }
+            catch (error) {
+                return JSON.stringify({
+                    success: false,
+                    error: error.message,
+                }, null, 2);
+            }
+        },
+    };
+}
+//# sourceMappingURL=fetch-all-apis.js.map

package/dist/tools/fetch-all-apis.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-all-apis.js","sourceRoot":"","sources":["../../src/tools/fetch-all-apis.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD,OAAO,EAAE,SAAS,EAAa,MAAM,SAAS,CAAC;AAE/C,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,0CAA0C,CAAC;CAC9F,CAAC,CAAC;AAIH,MAAM,UAAU,sBAAsB,CAAC,MAA+B;IACrE,OAAO;QACN,IAAI,EAAE,SAAS,CAAC,cAAc;QAC9B,WAAW,EACV,mGAAmG;QACpG,WAAW,EAAE,eAAe,CAAC,uBAAuB,CAAQ;QAC5D,SAAS,EAAE,uBAAuB;QAClC,IAAI,EAAE,KAAK,EAAE,MAAyB,EAAE,EAAE;YACzC,IAAI,CAAC;gBACJ,MAAM,UAAU,GAAG,MAAM,CAAC,kBAAkB,EAAE,CAAC;gBAC/C,OAAO,IAAI,CAAC,SAAS,CACpB;oBACC,OAAO,EAAE,IAAI;oBACb,UAAU;oBACV,OAAO,EAAE,6DAA6D;iBACtE,EACD,IAAI,EACJ,CAAC,CACD,CAAC;YACH,CAAC;YAAC,OAAO,KAAU,EAAE,CAAC;gBACrB,OAAO,IAAI,CAAC,SAAS,CACpB;oBACC,OAAO,EAAE,KAAK;oBACd,KAAK,EAAE,KAAK,CAAC,OAAO;iBACpB,EACD,IAAI,EACJ,CAAC,CACD,CAAC;YACH,CAAC;QACF,CAAC;KACD,CAAC;AACH,CAAC"}

package/dist/tools/index.d.ts

@@ -0,0 +1,6 @@
+export * from './types.js';
+export * from './search-api.js';
+export * from './fetch-all-apis.js';
+export * from './execute-code.js';
+export * from './explore-api.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC"}

package/dist/tools/index.js

@@ -0,0 +1,6 @@
+export * from './types.js';
+export * from './search-api.js';
+export * from './fetch-all-apis.js';
+export * from './execute-code.js';
+export * from './explore-api.js';
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC"}

package/dist/tools/search-api.d.ts

@@ -0,0 +1,14 @@
+import { z } from 'zod';
+import type { AgentToolProtocolClient } from '../client.js';
+import { type Tool } from './types';
+declare const searchApiInputSchema: z.ZodObject<{
+    query: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    query: string;
+}, {
+    query: string;
+}>;
+type SearchApiInput = z.infer<typeof searchApiInputSchema>;
+export declare function createSearchApiTool(client: AgentToolProtocolClient): Tool<SearchApiInput>;
+export {};
+//# sourceMappingURL=search-api.d.ts.map

package/dist/tools/search-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-api.d.ts","sourceRoot":"","sources":["../../src/tools/search-api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAC5D,OAAO,EAAa,KAAK,IAAI,EAAE,MAAM,SAAS,CAAC;AAE/C,QAAA,MAAM,oBAAoB;;;;;;EAExB,CAAC;AAEH,KAAK,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAE3D,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,uBAAuB,GAAG,IAAI,CAAC,cAAc,CAAC,CAoCzF"}

package/dist/tools/search-api.js

@@ -0,0 +1,36 @@
+import { z } from 'zod';
+import { zodToJsonSchema } from 'zod-to-json-schema';
+import { ToolNames } from './types';
+const searchApiInputSchema = z.object({
+    query: z.string().describe('Search query string'),
+});
+export function createSearchApiTool(client) {
+    return {
+        name: ToolNames.SEARCH_API,
+        description: 'Search for APIs by keyword. Provide search term as string like "add", "math", "user", etc.',
+        inputSchema: zodToJsonSchema(searchApiInputSchema),
+        zodSchema: searchApiInputSchema,
+        func: async (input) => {
+            try {
+                const results = await client.searchAPI(input.query);
+                return JSON.stringify({
+                    success: true,
+                    results: results.map((r) => ({
+                        apiGroup: r.apiGroup,
+                        functionName: r.functionName,
+                        description: r.description,
+                        signature: r.signature,
+                    })),
+                    count: results.length,
+                }, null, 2);
+            }
+            catch (error) {
+                return JSON.stringify({
+                    success: false,
+                    error: error.message,
+                }, null, 2);
+            }
+        },
+    };
+}
+//# sourceMappingURL=search-api.js.map

package/dist/tools/search-api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-api.js","sourceRoot":"","sources":["../../src/tools/search-api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD,OAAO,EAAE,SAAS,EAAa,MAAM,SAAS,CAAC;AAE/C,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qBAAqB,CAAC;CACjD,CAAC,CAAC;AAIH,MAAM,UAAU,mBAAmB,CAAC,MAA+B;IAClE,OAAO;QACN,IAAI,EAAE,SAAS,CAAC,UAAU;QAC1B,WAAW,EACV,4FAA4F;QAC7F,WAAW,EAAE,eAAe,CAAC,oBAAoB,CAAQ;QACzD,SAAS,EAAE,oBAAoB;QAC/B,IAAI,EAAE,KAAK,EAAE,KAAqB,EAAE,EAAE;YACrC,IAAI,CAAC;gBACJ,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;gBACpD,OAAO,IAAI,CAAC,SAAS,CACpB;oBACC,OAAO,EAAE,IAAI;oBACb,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;wBAC5B,QAAQ,EAAE,CAAC,CAAC,QAAQ;wBACpB,YAAY,EAAE,CAAC,CAAC,YAAY;wBAC5B,WAAW,EAAE,CAAC,CAAC,WAAW;wBAC1B,SAAS,EAAE,CAAC,CAAC,SAAS;qBACtB,CAAC,CAAC;oBACH,KAAK,EAAE,OAAO,CAAC,MAAM;iBACrB,EACD,IAAI,EACJ,CAAC,CACD,CAAC;YACH,CAAC;YAAC,OAAO,KAAU,EAAE,CAAC;gBACrB,OAAO,IAAI,CAAC,SAAS,CACpB;oBACC,OAAO,EAAE,KAAK;oBACd,KAAK,EAAE,KAAK,CAAC,OAAO;iBACpB,EACD,IAAI,EACJ,CAAC,CACD,CAAC;YACH,CAAC;QACF,CAAC;KACD,CAAC;AACH,CAAC"}

package/dist/tools/types.d.ts

@@ -0,0 +1,23 @@
+export declare const ToolNames: {
+    readonly SEARCH_API: "search_api";
+    readonly FETCH_ALL_APIS: "fetch_all_apis";
+    readonly EXECUTE_CODE: "execute_code";
+    readonly EXPLORE_API: "explore_api";
+};
+export type ToolName = (typeof ToolNames)[keyof typeof ToolNames];
+/**
+ * Tool definition following MCP (Model Context Protocol) convention
+ * with added execution function
+ */
+export interface Tool<TInput = any> {
+    name: string;
+    description?: string;
+    inputSchema: {
+        type: string;
+        properties?: Record<string, unknown>;
+        required?: string[];
+    };
+    zodSchema?: any;
+    func: (input: TInput) => Promise<string>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/tools/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/tools/types.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,SAAS;;;;;CAKZ,CAAC;AAEX,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,OAAO,SAAS,CAAC,CAAC;AAElE;;;GAGG;AACH,MAAM,WAAW,IAAI,CAAC,MAAM,GAAG,GAAG;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACrC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;KACpB,CAAC;IACF,SAAS,CAAC,EAAE,GAAG,CAAC;IAChB,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CACzC"}

package/dist/tools/types.js

@@ -0,0 +1,7 @@
+export const ToolNames = {
+    SEARCH_API: 'search_api',
+    FETCH_ALL_APIS: 'fetch_all_apis',
+    EXECUTE_CODE: 'execute_code',
+    EXPLORE_API: 'explore_api',
+};
+//# sourceMappingURL=types.js.map

package/dist/tools/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/tools/types.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,SAAS,GAAG;IACxB,UAAU,EAAE,YAAY;IACxB,cAAc,EAAE,gBAAgB;IAChC,YAAY,EAAE,cAAc;IAC5B,WAAW,EAAE,aAAa;CACjB,CAAC"}

package/dist/tools.d.ts

@@ -0,0 +1,8 @@
+import type { AgentToolProtocolClient } from './client.js';
+import { type Tool } from './tools/index.js';
+/**
+ * Creates MCP-compliant tool definitions with execution handlers
+ * These tools work with any LLM/agent framework
+ */
+export declare function createToolsFromATPClient(client: AgentToolProtocolClient): Tool[];
+//# sourceMappingURL=tools.d.ts.map

package/dist/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAC3D,OAAO,EACN,KAAK,IAAI,EAKT,MAAM,kBAAkB,CAAC;AAE1B;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,uBAAuB,GAAG,IAAI,EAAE,CAOhF"}

package/dist/tools.js

@@ -0,0 +1,14 @@
+import { createSearchApiTool, createFetchAllApisTool, createExecuteCodeTool, createExploreApiTool, } from './tools/index.js';
+/**
+ * Creates MCP-compliant tool definitions with execution handlers
+ * These tools work with any LLM/agent framework
+ */
+export function createToolsFromATPClient(client) {
+    return [
+        createSearchApiTool(client),
+        createFetchAllApisTool(client),
+        createExecuteCodeTool(client),
+        createExploreApiTool(client),
+    ];
+}
+//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AACA,OAAO,EAEN,mBAAmB,EACnB,sBAAsB,EACtB,qBAAqB,EACrB,oBAAoB,GACpB,MAAM,kBAAkB,CAAC;AAE1B;;;GAGG;AACH,MAAM,UAAU,wBAAwB,CAAC,MAA+B;IACvE,OAAO;QACN,mBAAmB,CAAC,MAAM,CAAC;QAC3B,sBAAsB,CAAC,MAAM,CAAC;QAC9B,qBAAqB,CAAC,MAAM,CAAC;QAC7B,oBAAoB,CAAC,MAAM,CAAC;KAC5B,CAAC;AACH,CAAC"}

package/package.json

@@ -0,0 +1,46 @@
+{
+	"name": "@mondaydotcomorg/atp-client",
+	"version": "0.17.14",
+	"description": "Client SDK for Agent Tool Protocol",
+	"type": "module",
+	"main": "./dist/index.js",
+	"types": "./dist/index.d.ts",
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"import": "./dist/index.js"
+		},
+		"./core": {
+			"types": "./dist/core/index.d.ts",
+			"import": "./dist/core/index.js"
+		}
+	},
+	"files": [
+		"dist",
+		"src"
+	],
+	"scripts": {
+		"build": "tsc -p tsconfig.json",
+		"dev": "tsc -p tsconfig.json --watch",
+		"clean": "rm -rf dist *.tsbuildinfo",
+		"test": "vitest run",
+		"lint": "tsc --noEmit"
+	},
+	"keywords": [
+		"agent",
+		"protocol",
+		"client",
+		"ai",
+		"llm"
+	],
+	"license": "MIT",
+	"dependencies": {
+		"@mondaydotcomorg/atp-protocol": "0.17.14",
+		"zod": "^3.23.8",
+		"zod-to-json-schema": "^3.24.6"
+	},
+	"devDependencies": {
+		"typescript": "^5.3.3",
+		"vitest": "^1.2.1"
+	}
+}

package/src/client.ts

@@ -0,0 +1,194 @@
+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,
+	ClientSession,
+	APIOperations,
+	ExecutionOperations,
+	ServiceProviders,
+} 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 class AgentToolProtocolClient {
+	private session: ClientSession;
+	private apiOps: APIOperations;
+	private execOps: ExecutionOperations;
+	private serviceProviders: 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) {
+		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?: { name?: string; version?: string; [key: string]: unknown }): Promise<{
+		clientId: string;
+		token: string;
+		expiresAt: number;
+		tokenRotateAt: number;
+	}> {
+		const toolDefinitions = this.serviceProviders.getToolDefinitions();
+		return await this.session.init(clientInfo, toolDefinitions);
+	}
+
+	/**
+	 * Gets the unique client ID.
+	 */
+	getClientId(): string {
+		return this.session.getClientId();
+	}
+
+	/**
+	 * Provides an LLM implementation for server to use during execution.
+	 */
+	provideLLM(handler: ClientLLMHandler): void {
+		this.serviceProviders.provideLLM(handler);
+	}
+
+	/**
+	 * Provides an approval handler for server to request human approval.
+	 */
+	provideApproval(handler: ClientApprovalHandler): void {
+		this.serviceProviders.provideApproval(handler);
+	}
+
+	/**
+	 * Provides an embedding model for server to use.
+	 */
+	provideEmbedding(handler: ClientEmbeddingHandler): void {
+		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: ClientTool[]): void {
+		this.serviceProviders.provideTools(tools);
+	}
+
+	/**
+	 * Connects to the server and retrieves API definitions.
+	 */
+	async connect(options?: { apiGroups?: string[] }): Promise<{
+		serverVersion: string;
+		capabilities: unknown;
+		apiGroups: string[];
+	}> {
+		return await this.apiOps.connect(options);
+	}
+
+	/**
+	 * Gets the TypeScript type definitions for available APIs.
+	 */
+	getTypeDefinitions(): string {
+		return this.apiOps.getTypeDefinitions();
+	}
+
+	/**
+	 * Searches for available API functions.
+	 */
+	async searchAPI(query: string, options?: SearchOptions): Promise<SearchResult[]> {
+		return await this.apiOps.searchAPI(query, options);
+	}
+
+	/**
+	 * Explores the API filesystem at the given path.
+	 */
+	async exploreAPI(path: string): Promise<ExploreResult> {
+		return await this.apiOps.exploreAPI(path);
+	}
+
+	/**
+	 * Executes code on the server with real-time progress updates via SSE.
+	 */
+	async executeStream(
+		code: string,
+		config?: Partial<ExecutionConfig>,
+		onProgress?: (message: string, fraction: number) => void
+	): Promise<ExecutionResult> {
+		return await this.execOps.executeStream(code, config, onProgress);
+	}
+
+	/**
+	 * Executes code on the server in a sandboxed environment.
+	 */
+	async execute(code: string, config?: Partial<ExecutionConfig>): Promise<ExecutionResult> {
+		return await this.execOps.execute(code, config);
+	}
+
+	/**
+	 * Resumes a paused execution with a callback result.
+	 */
+	async resume(executionId: string, callbackResult: unknown): Promise<ExecutionResult> {
+		return await this.execOps.resume(executionId, callbackResult);
+	}
+
+	/**
+	 * Handles a callback request from the server during execution.
+	 */
+	async handleCallback(callbackType: CallbackType, payload: any): Promise<any> {
+		return await this.serviceProviders.handleCallback(callbackType, payload);
+	}
+
+	/**
+	 * Gets information about the server.
+	 */
+	async getServerInfo(): Promise<{
+		version: string;
+		capabilities: Record<string, boolean>;
+	}> {
+		return await this.apiOps.getServerInfo();
+	}
+}

package/src/core/api-operations.ts

@@ -0,0 +1,130 @@
+import type { SearchOptions, SearchResult, ExploreResult } from '@mondaydotcomorg/atp-protocol';
+import type { ClientSession } from './session.js';
+
+export class APIOperations {
+	private session: ClientSession;
+	private apiDefinitions?: string;
+
+	constructor(session: ClientSession) {
+		this.session = session;
+	}
+
+	/**
+	 * Connects to the server and retrieves API definitions.
+	 */
+	async connect(options?: { apiGroups?: string[] }): Promise<{
+		serverVersion: string;
+		capabilities: unknown;
+		apiGroups: string[];
+	}> {
+		await this.session.ensureInitialized();
+
+		const params = new URLSearchParams();
+		if (options?.apiGroups) {
+			params.set('apiGroups', options.apiGroups.join(','));
+		}
+
+		const url = `${this.session.getBaseUrl()}/api/definitions?${params}`;
+		const headers = await this.session.prepareHeaders('GET', url);
+
+		const response = await fetch(url, { headers });
+
+		if (!response.ok) {
+			throw new Error(`Connection failed: ${response.status} ${response.statusText}`);
+		}
+
+		const data = (await response.json()) as {
+			typescript: string;
+			version: string;
+			apiGroups: string[];
+		};
+		this.apiDefinitions = data.typescript;
+
+		return {
+			serverVersion: data.version,
+			capabilities: {},
+			apiGroups: data.apiGroups,
+		};
+	}
+
+	/**
+	 * Gets the TypeScript type definitions for available APIs.
+	 */
+	getTypeDefinitions(): string {
+		if (!this.apiDefinitions) {
+			throw new Error('Not connected. Call connect() first.');
+		}
+		return this.apiDefinitions;
+	}
+
+	/**
+	 * Searches for available API functions.
+	 */
+	async searchAPI(query: string, options?: SearchOptions): Promise<SearchResult[]> {
+		await this.session.ensureInitialized();
+
+		const url = `${this.session.getBaseUrl()}/api/search`;
+		const body = JSON.stringify({ query, ...options });
+		const headers = await this.session.prepareHeaders('POST', url, body);
+
+		const response = await fetch(url, {
+			method: 'POST',
+			headers,
+			body,
+		});
+
+		if (!response.ok) {
+			throw new Error(`Search failed: ${response.status} ${response.statusText}`);
+		}
+
+		const data = (await response.json()) as { results: SearchResult[] };
+		return data.results;
+	}
+
+	/**
+	 * Explores the API filesystem at the given path.
+	 */
+	async exploreAPI(path: string): Promise<ExploreResult> {
+		await this.session.ensureInitialized();
+
+		const url = `${this.session.getBaseUrl()}/api/explore`;
+		const body = JSON.stringify({ path });
+		const headers = await this.session.prepareHeaders('POST', url, body);
+
+		const response = await fetch(url, {
+			method: 'POST',
+			headers,
+			body,
+		});
+
+		if (!response.ok) {
+			throw new Error(`Explore failed: ${response.status} ${response.statusText}`);
+		}
+
+		return (await response.json()) as ExploreResult;
+	}
+
+	/**
+	 * Gets information about the server.
+	 */
+	async getServerInfo(): Promise<{
+		version: string;
+		capabilities: Record<string, boolean>;
+	}> {
+		await this.session.ensureInitialized();
+
+		const url = `${this.session.getBaseUrl()}/api/info`;
+		const headers = await this.session.prepareHeaders('GET', url);
+
+		const response = await fetch(url, { headers });
+
+		if (!response.ok) {
+			throw new Error(`Failed to get server info: ${response.status}`);
+		}
+
+		return (await response.json()) as {
+			version: string;
+			capabilities: Record<string, boolean>;
+		};
+	}
+}