@picahq/toolkit 0.1.0

package/dist/prompts/knowledge.js

@@ -0,0 +1,109 @@
+/**
+ * Pica ToolKit - Knowledge Agent System Prompt
+ *
+ * This is the knowledge agent system prompt for the Pica ToolKit.
+ * Used when knowledgeAgent mode is enabled to generate Edge Function prompts.
+ *
+ * @fileoverview Knowledge agent system prompt for the Pica ToolKit
+ * @author Pica
+ */
+const KNOWLEDGE_AGENT_SYSTEM_PROMPT = `
+=== PICA: KNOWLEDGE AGENT ===
+
+Generate a complete Edge Function prompt in markdown format for integrating with external APIs through Pica's passthrough system.
+
+Current Time: ${new Date().toLocaleString('en-US', { timeZone: 'GMT' })} (GMT)
+
+You have access to all available actions across all platforms. You can explore any platform's actions and generate prompts without needing actual connections.
+
+**IMPORTANT**: You are in Knowledge Agent mode - you can only retrieve knowledge and generate prompts, never execute actual API calls.
+
+## Your Tasks:
+1. **Load Knowledge**: Retrieve the necessary API documentation for all requested actions on the specified platforms
+2. **Generate API Call Prompt**: Construct a detailed prompt that helps developers create an **Edge Function** to call the appropriate endpoint(s)
+3. **Inform User**: Tell the user you are processing their request and will provide a prompt shortly
+4. **Use Pica Passthrough API**: Structure all API calls through the Pica Passthrough system with correct endpoints and headers
+
+## Workflow rules you MUST follow for every request:
+
+Step 1: **searchPlatformActions** - Find available actions on a platform  
+  - Search by platform name (e.g., 'gmail', 'shopify', 'notion')
+  - When passing the query, pass a descriptive intent phrase without the platform name. 
+    For example, if the platform is 'gmail', and the user's main query is 
+    "Generate code to fetch my 5 latest emails from Gmail",
+    then the query for getting Gmail actions should be {platform: gmail, query: "Fetch my 5 latest emails"}.
+  - When you are selecting the action, select the action that is most relevant to the user's query. 
+    If you are between two very similar actions and one has a 'custom' tag, select the action with the 'custom' tag.
+  - Returns actions with system IDs and basic info
+
+Step 2: **getActionsKnowledge** - Get detailed documentation for actions
+  - Takes array of system IDs from search results
+  - Returns comprehensive API documentation and usage examples
+  - Essential before generating request configuration
+
+Step 3: **execute** - Generate request configuration (no actual execution)   
+  IMPORTANT: Must always call getActionsKnowledge before generating configuration.
+
+  Required Parameters:
+  * actionSystemId: The action system ID from searchPlatformActions results
+  * connectionKey: Use placeholder connection key (will be replaced with environment variable)
+  * data: The request payload
+
+  Optional Parameters:
+  * pathVariables: Values for path template variables like {{spreadsheetId}}
+  * queryParams: Query parameters to append to the URL
+  * headers: Additional HTTP headers
+  * isFormData: Set to true to send data as multipart/form-data
+  * isFormUrlEncoded: Set to true to send data as application/x-www-form-urlencoded
+
+## Pica Passthrough API Structure:
+All integration API calls must be structured through the Pica Passthrough system:
+
+- **Base URL**: \`https://api.picaos.com/v1/passthrough/{path}\` (path from action object)
+- **Method**: \`GET | POST | PUT | DELETE | etc.\` (method from action object)
+- **Required Headers**:
+  - \`x-pica-secret: <PICA_SECRET_KEY>\` (from environment variables)
+  - \`x-pica-connection-key: <PICA_[PLATFORM]_CONNECTION_KEY>\` (from environment variables)
+  - \`x-pica-action-id: <ACTION_ID>\` (from action object)
+  - \`Content-Type: application/json\` (unless using form data)
+
+## Output Requirements:
+Generate a properly formatted **Edge Function prompt** in Markdown with:
+- **API Endpoint**: Complete endpoint URL for each action
+- **HTTP Method**: (GET, POST, PUT, DELETE, etc.)
+- **Required Headers**: All necessary authentication and request headers
+- **Request Body**: Complete schema (if applicable)
+- **Response Body**: Expected response structure from action knowledge
+- **Example Code**: Working TypeScript implementation for Edge Functions
+
+**Output Guidelines:**
+- Print ONLY the Markdown without additional explanations
+- Include complete JSON schemas for all inputs and outputs
+- Never expose secret values - reference environment variables
+- Use TypeScript unless user specifies another language
+
+## Best Practices:
+- **Follow the workflow**: search → knowledge → generate config for best results
+- **Use Pica Passthrough API**: All integration calls must use the Pica Passthrough structure with correct base URL and headers
+- **Use keys VERBATIM**: Action system IDs must be used exactly as returned
+- **Handle templates**: Path variables like {{spreadsheetId}} need actual values provided in pathVariables
+- **Use correct data format**: Check if action requires isFormData or isFormUrlEncoded based on API requirements
+- **Include complete schemas**: Provide full JSON schemas for inputs and outputs when available
+- **Reference environment variables**: Never expose actual secret values in generated code
+- **Structure API calls correctly**: Always use \`https://api.picaos.com/v1/passthrough/{path}\` with required Pica headers
+
+## Error Handling:
+- If actions fail, read the error message and provide helpful guidance
+- Always provide clear error messages and next steps
+- Ask the user for additional information if needed
+
+Be thorough, accurate, and helpful in generating comprehensive Edge Function prompts.
+`;
+/**
+ * Generates the knowledge agent system prompt
+ * Knowledge agents have access to all actions by default and don't need connection management
+ * @returns The formatted knowledge agent system prompt string
+ */
+export const generateKnowledgeAgentSystemPrompt = () => {
+    return KNOWLEDGE_AGENT_SYSTEM_PROMPT;
+};

package/dist/schemas/actions.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Pica ToolKit - Actions Schema
+ *
+ * These are the schemas for the actions tool for the Pica ToolKit.
+ *
+ * @fileoverview Actions schema for the Pica ToolKit
+ * @author Pica
+ */
+import { z } from "zod/v4";
+export declare const searchPlatformActionsSchema: z.ZodObject<{
+    platform: z.ZodString;
+    query: z.ZodString;
+}, z.core.$strip>;
+export type SearchPlatformActionsParams = z.infer<typeof searchPlatformActionsSchema>;
+export declare const ActionSystemIdSchema: z.ZodObject<{
+    fullId: z.ZodString;
+    parts: z.ZodObject<{
+        prefix: z.ZodString;
+        metadata: z.ZodString;
+        suffix: z.ZodString;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export declare const ActionReferenceSchema: z.ZodObject<{
+    title: z.ZodString;
+    method: z.ZodString;
+    path: z.ZodString;
+    systemId: z.ZodObject<{
+        fullId: z.ZodString;
+        parts: z.ZodObject<{
+            prefix: z.ZodString;
+            metadata: z.ZodString;
+            suffix: z.ZodString;
+        }, z.core.$strip>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export declare const getActionsKnowledgeSchema: z.ZodObject<{
+    systemIds: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export type GetActionsKnowledgeParams = z.infer<typeof getActionsKnowledgeSchema>;
+export declare const ActionsKnowledgeResponseSchema: z.ZodRecord<z.ZodString, z.ZodString>;
+export declare const SEARCH_PLATFORM_ACTIONS_TOOL_CONFIG: {
+    name: string;
+    description: string;
+    schema: z.ZodObject<{
+        platform: z.ZodString;
+        query: z.ZodString;
+    }, z.core.$strip>;
+    outputSchema: z.ZodArray<z.ZodObject<{
+        title: z.ZodString;
+        method: z.ZodString;
+        path: z.ZodString;
+        systemId: z.ZodObject<{
+            fullId: z.ZodString;
+            parts: z.ZodObject<{
+                prefix: z.ZodString;
+                metadata: z.ZodString;
+                suffix: z.ZodString;
+            }, z.core.$strip>;
+        }, z.core.$strip>;
+    }, z.core.$strip>>;
+};
+export declare const GET_ACTIONS_KNOWLEDGE_TOOL_CONFIG: {
+    name: string;
+    description: string;
+    schema: z.ZodObject<{
+        systemIds: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>;
+    outputSchema: z.ZodRecord<z.ZodString, z.ZodString>;
+};

package/dist/schemas/actions.js

@@ -0,0 +1,43 @@
+/**
+ * Pica ToolKit - Actions Schema
+ *
+ * These are the schemas for the actions tool for the Pica ToolKit.
+ *
+ * @fileoverview Actions schema for the Pica ToolKit
+ * @author Pica
+ */
+import { z } from "zod/v4";
+export const searchPlatformActionsSchema = z.object({
+    platform: z.string().describe("Platform name to search actions for (e.g., 'google-sheets', 'shopify')"),
+    query: z.string().describe("Search query to find relevant actions")
+});
+export const ActionSystemIdSchema = z.object({
+    fullId: z.string().describe("Opaque system ID. MUST be displayed exactly as provided. Do not trim."),
+    parts: z.object({
+        prefix: z.string(), // e.g. 'conn_mod_def'
+        metadata: z.string(), // e.g. 'GEoTH7-tRU0'
+        suffix: z.string(), // e.g. 'RbyDQmffR5C14QTGEdELhg'
+    }),
+});
+export const ActionReferenceSchema = z.object({
+    title: z.string(),
+    method: z.string(),
+    path: z.string(),
+    systemId: ActionSystemIdSchema,
+});
+export const getActionsKnowledgeSchema = z.object({
+    systemIds: z.array(z.string()).describe("Array of full system IDs to get knowledge for")
+});
+export const ActionsKnowledgeResponseSchema = z.record(z.string(), z.string());
+export const SEARCH_PLATFORM_ACTIONS_TOOL_CONFIG = {
+    name: "searchPlatformActions",
+    description: "Search for available actions on a specific platform. Use this to find APIs and operations you can perform on integrated platforms. Results are filtered based on your permission level: 'read' shows only GET methods, 'write' shows POST/PUT/PATCH methods, 'admin' shows all methods.",
+    schema: searchPlatformActionsSchema,
+    outputSchema: z.array(ActionReferenceSchema)
+};
+export const GET_ACTIONS_KNOWLEDGE_TOOL_CONFIG = {
+    name: "getActionsKnowledge",
+    description: "Get detailed knowledge and documentation for specific actions using their system IDs. Call this after searching for actions to get comprehensive information about how to use them.",
+    schema: getActionsKnowledgeSchema,
+    outputSchema: ActionsKnowledgeResponseSchema
+};

package/dist/schemas/connections.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Pica ToolKit - Connections Schema
+ *
+ * These are the schemas for the connections tool for the Pica ToolKit.
+ *
+ * @fileoverview Connections schema for the Pica ToolKit
+ * @author Pica
+ */
+import { z } from "zod/v4";
+export declare const ConnectionKeySchema: z.ZodObject<{
+    fullKey: z.ZodString;
+    parts: z.ZodObject<{
+        environment: z.ZodString;
+        platform: z.ZodString;
+        namespace: z.ZodString;
+        id: z.ZodString;
+        identity: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export declare const ConnectionReferenceSchema: z.ZodObject<{
+    platform: z.ZodString;
+    key: z.ZodObject<{
+        fullKey: z.ZodString;
+        parts: z.ZodObject<{
+            environment: z.ZodString;
+            platform: z.ZodString;
+            namespace: z.ZodString;
+            id: z.ZodString;
+            identity: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export declare const listPicaIntegrationsSchema: z.ZodObject<{}, z.core.$strip>;
+export type ListPicaIntegrationsParams = z.infer<typeof listPicaIntegrationsSchema>;
+export declare const LIST_PICA_INTEGRATIONS_TOOL_CONFIG: {
+    name: string;
+    description: string;
+    schema: z.ZodObject<{}, z.core.$strip>;
+    outputSchema: z.ZodArray<z.ZodObject<{
+        platform: z.ZodString;
+        key: z.ZodObject<{
+            fullKey: z.ZodString;
+            parts: z.ZodObject<{
+                environment: z.ZodString;
+                platform: z.ZodString;
+                namespace: z.ZodString;
+                id: z.ZodString;
+                identity: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>;
+        }, z.core.$strip>;
+    }, z.core.$strip>>;
+};
+export declare const promptToConnectIntegrationSchema: z.ZodObject<{
+    platformName: z.ZodString;
+}, z.core.$strip>;
+export type PromptToConnectIntegrationParams = z.infer<typeof promptToConnectIntegrationSchema>;
+export declare const PromptToConnectIntegrationResponseSchema: z.ZodObject<{
+    response: z.ZodString;
+}, z.core.$strip>;
+export declare const PROMPT_TO_CONNECT_INTEGRATION_TOOL_CONFIG: {
+    name: string;
+    description: string;
+    schema: z.ZodObject<{
+        platformName: z.ZodString;
+    }, z.core.$strip>;
+    outputSchema: z.ZodObject<{
+        response: z.ZodString;
+    }, z.core.$strip>;
+};

package/dist/schemas/connections.js

@@ -0,0 +1,42 @@
+/**
+ * Pica ToolKit - Connections Schema
+ *
+ * These are the schemas for the connections tool for the Pica ToolKit.
+ *
+ * @fileoverview Connections schema for the Pica ToolKit
+ * @author Pica
+ */
+import { z } from "zod/v4";
+export const ConnectionKeySchema = z.object({
+    fullKey: z.string().describe("Opaque connection key. MUST be displayed exactly as provided, including prefixes like 'test::...'. Do not trim."),
+    parts: z.object({
+        environment: z.string(), // e.g. 'test'
+        platform: z.string(), // e.g. 'postgresql'
+        namespace: z.string(), // e.g. 'default'
+        id: z.string(), // e.g. 'c76d7a...'
+        identity: z.string().optional(), // e.g. 'user-abc'
+    }),
+});
+export const ConnectionReferenceSchema = z.object({
+    platform: z.string(),
+    key: ConnectionKeySchema,
+});
+export const listPicaIntegrationsSchema = z.object({});
+export const LIST_PICA_INTEGRATIONS_TOOL_CONFIG = {
+    name: "listPicaConnections",
+    description: "List all connected integrations in the user's Pica account. IMPORTANT: Keys are opaque identifiers and must be shown VERBATIM. Do NOT drop prefixes (e.g., 'test::'). When summarizing, include the `fullKey` exactly as returned.",
+    schema: listPicaIntegrationsSchema,
+    outputSchema: z.array(ConnectionReferenceSchema)
+};
+export const promptToConnectIntegrationSchema = z.object({
+    platformName: z.string(),
+});
+export const PromptToConnectIntegrationResponseSchema = z.object({
+    response: z.string(),
+});
+export const PROMPT_TO_CONNECT_INTEGRATION_TOOL_CONFIG = {
+    name: "promptToConnectIntegration",
+    description: "Prompt the user to connect to a platform that they do not currently have access to via AuthKit",
+    schema: promptToConnectIntegrationSchema,
+    outputSchema: PromptToConnectIntegrationResponseSchema
+};

package/dist/schemas/execute.d.ts

@@ -0,0 +1,128 @@
+/**
+ * Pica ToolKit - Execute Schema
+ *
+ * These are the schemas for the execute tool for the Pica ToolKit.
+ *
+ * @fileoverview Execute schema for the Pica ToolKit
+ * @author Pica
+ */
+import { z } from "zod/v4";
+export declare const executeActionSchema: z.ZodObject<{
+    actionSystemId: z.ZodString;
+    connectionKey: z.ZodString;
+    data: z.ZodAny;
+    pathVariables: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
+    queryParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    isFormData: z.ZodOptional<z.ZodBoolean>;
+    isFormUrlEncoded: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type ExecuteActionParams = z.infer<typeof executeActionSchema>;
+export declare const ExecuteActionResponseSchema: z.ZodUnion<readonly [z.ZodObject<{
+    success: z.ZodBoolean;
+    responseData: z.ZodOptional<z.ZodAny>;
+    requestConfig: z.ZodObject<{
+        url: z.ZodString;
+        method: z.ZodOptional<z.ZodString>;
+        headers: z.ZodRecord<z.ZodString, z.ZodAny>;
+        params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+        data: z.ZodOptional<z.ZodAny>;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    success: z.ZodBoolean;
+    error: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    executed: z.ZodBoolean;
+    requestConfig: z.ZodObject<{
+        url: z.ZodString;
+        method: z.ZodOptional<z.ZodString>;
+        headers: z.ZodRecord<z.ZodString, z.ZodAny>;
+        params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+        data: z.ZodOptional<z.ZodAny>;
+    }, z.core.$strip>;
+}, z.core.$strip>]>;
+export declare const EXECUTE_ACTION_TOOL_CONFIG: {
+    name: string;
+    description: string;
+    schema: z.ZodObject<{
+        actionSystemId: z.ZodString;
+        connectionKey: z.ZodString;
+        data: z.ZodAny;
+        pathVariables: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
+        queryParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+        headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+        isFormData: z.ZodOptional<z.ZodBoolean>;
+        isFormUrlEncoded: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>;
+    outputSchema: z.ZodUnion<readonly [z.ZodObject<{
+        success: z.ZodBoolean;
+        responseData: z.ZodOptional<z.ZodAny>;
+        requestConfig: z.ZodObject<{
+            url: z.ZodString;
+            method: z.ZodOptional<z.ZodString>;
+            headers: z.ZodRecord<z.ZodString, z.ZodAny>;
+            params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+            data: z.ZodOptional<z.ZodAny>;
+        }, z.core.$strip>;
+    }, z.core.$strip>, z.ZodObject<{
+        success: z.ZodBoolean;
+        error: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        executed: z.ZodBoolean;
+        requestConfig: z.ZodObject<{
+            url: z.ZodString;
+            method: z.ZodOptional<z.ZodString>;
+            headers: z.ZodRecord<z.ZodString, z.ZodAny>;
+            params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+            data: z.ZodOptional<z.ZodAny>;
+        }, z.core.$strip>;
+    }, z.core.$strip>]>;
+};
+export declare const knowledgeAgentExecuteActionSchema: z.ZodObject<{
+    actionSystemId: z.ZodString;
+    connectionKey: z.ZodString;
+    data: z.ZodAny;
+    pathVariables: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
+    queryParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    isFormData: z.ZodOptional<z.ZodBoolean>;
+    isFormUrlEncoded: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type KnowledgeAgentExecuteActionParams = z.infer<typeof knowledgeAgentExecuteActionSchema>;
+export declare const KNOWLEDGE_AGENT_EXECUTE_ACTION_TOOL_CONFIG: {
+    name: string;
+    description: string;
+    schema: z.ZodObject<{
+        actionSystemId: z.ZodString;
+        connectionKey: z.ZodString;
+        data: z.ZodAny;
+        pathVariables: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
+        queryParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+        headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+        isFormData: z.ZodOptional<z.ZodBoolean>;
+        isFormUrlEncoded: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>;
+    outputSchema: z.ZodUnion<readonly [z.ZodObject<{
+        success: z.ZodBoolean;
+        responseData: z.ZodOptional<z.ZodAny>;
+        requestConfig: z.ZodObject<{
+            url: z.ZodString;
+            method: z.ZodOptional<z.ZodString>;
+            headers: z.ZodRecord<z.ZodString, z.ZodAny>;
+            params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+            data: z.ZodOptional<z.ZodAny>;
+        }, z.core.$strip>;
+    }, z.core.$strip>, z.ZodObject<{
+        success: z.ZodBoolean;
+        error: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        executed: z.ZodBoolean;
+        requestConfig: z.ZodObject<{
+            url: z.ZodString;
+            method: z.ZodOptional<z.ZodString>;
+            headers: z.ZodRecord<z.ZodString, z.ZodAny>;
+            params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+            data: z.ZodOptional<z.ZodAny>;
+        }, z.core.$strip>;
+    }, z.core.$strip>]>;
+};

package/dist/schemas/execute.js

@@ -0,0 +1,69 @@
+/**
+ * Pica ToolKit - Execute Schema
+ *
+ * These are the schemas for the execute tool for the Pica ToolKit.
+ *
+ * @fileoverview Execute schema for the Pica ToolKit
+ * @author Pica
+ */
+import { z } from "zod/v4";
+export const executeActionSchema = z.object({
+    actionSystemId: z.string().describe("The action system ID from searchPlatformActions results - method and path will be fetched automatically"),
+    connectionKey: z.string().describe("The connection key for authentication - use the full connection key exactly"),
+    data: z.any().describe("The request payload/body data"),
+    pathVariables: z.record(z.string(), z.union([z.string(), z.number(), z.boolean()])).optional().describe("Values for path variables like {{spreadsheetId}} - optional if no template variables"),
+    queryParams: z.record(z.string(), z.any()).optional().describe("Query parameters to append to the URL - optional"),
+    headers: z.record(z.string(), z.any()).optional().describe("Additional HTTP headers - optional"),
+    isFormData: z.boolean().optional().describe("Set to true to send data as multipart/form-data - optional, defaults to false"),
+    isFormUrlEncoded: z.boolean().optional().describe("Set to true to send data as application/x-www-form-urlencoded - optional, defaults to false"),
+});
+export const ExecuteActionResponseSchema = z.union([
+    z.object({
+        success: z.boolean(),
+        responseData: z.any().optional(),
+        requestConfig: z.object({
+            url: z.string(),
+            method: z.string().optional(),
+            headers: z.record(z.string(), z.any()),
+            params: z.record(z.string(), z.any()).optional(),
+            data: z.any().optional()
+        })
+    }),
+    z.object({
+        success: z.boolean(),
+        error: z.string().optional()
+    }),
+    z.object({
+        executed: z.boolean(),
+        requestConfig: z.object({
+            url: z.string(),
+            method: z.string().optional(),
+            headers: z.record(z.string(), z.any()),
+            params: z.record(z.string(), z.any()).optional(),
+            data: z.any().optional()
+        })
+    })
+]);
+export const EXECUTE_ACTION_TOOL_CONFIG = {
+    name: "execute",
+    description: "Execute an action on a connected platform. Automatically fetches method and path from the knowledge endpoint using actionSystemId. Provide the actionSystemId, connection key, and any required data.",
+    schema: executeActionSchema,
+    outputSchema: ExecuteActionResponseSchema
+};
+// Knowledge Agent Execute Tool - returns request config without execution
+export const knowledgeAgentExecuteActionSchema = z.object({
+    actionSystemId: z.string().describe("The action system ID from searchPlatformActions results - method and path will be fetched automatically"),
+    connectionKey: z.string().describe("The connection key for authentication - use the full connection key exactly"),
+    data: z.any().describe("The request payload/body data"),
+    pathVariables: z.record(z.string(), z.union([z.string(), z.number(), z.boolean()])).optional().describe("Values for path variables like {{spreadsheetId}} - optional if no template variables"),
+    queryParams: z.record(z.string(), z.any()).optional().describe("Query parameters to append to the URL - optional"),
+    headers: z.record(z.string(), z.any()).optional().describe("Additional HTTP headers - optional"),
+    isFormData: z.boolean().optional().describe("Set to true to send data as multipart/form-data - optional, defaults to false"),
+    isFormUrlEncoded: z.boolean().optional().describe("Set to true to send data as application/x-www-form-urlencoded - optional, defaults to false"),
+});
+export const KNOWLEDGE_AGENT_EXECUTE_ACTION_TOOL_CONFIG = {
+    name: "execute",
+    description: "Generate request configuration for an action without executing it. Returns the complete request config that can be used to create Edge Function code. Automatically fetches method and path from the knowledge endpoint using actionSystemId.",
+    schema: knowledgeAgentExecuteActionSchema,
+    outputSchema: ExecuteActionResponseSchema
+};

package/dist/schemas/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./connections";
+export * from "./actions";
+export * from "./execute";

package/dist/schemas/index.js

@@ -0,0 +1,3 @@
+export * from "./connections";
+export * from "./actions";
+export * from "./execute";