@sly_ai/sdk 0.1.0

package/dist/a2a.js

@@ -0,0 +1,173 @@
+'use strict';
+
+// src/protocols/a2a/client.ts
+var A2AClient = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * Discover an agent's capabilities via its Agent Card.
+   *
+   * @example
+   * ```typescript
+   * const card = await sly.a2a.discover('agent-uuid');
+   * console.log(card.skills);
+   * ```
+   */
+  async discover(agentId) {
+    return this.client.request(
+      `/v1/a2a/${agentId}/.well-known/agent.json`
+    );
+  }
+  /**
+   * Send a message to an agent, creating or continuing a task.
+   *
+   * @example
+   * ```typescript
+   * const task = await sly.a2a.sendMessage('agent-uuid', {
+   *   message: 'Check my wallet balance',
+   * });
+   * console.log(task.status.state); // 'submitted' or 'completed'
+   * ```
+   */
+  async sendMessage(agentId, params) {
+    const parts = typeof params.message === "string" ? [{ text: params.message }] : params.message;
+    const body = {
+      jsonrpc: "2.0",
+      method: "message/send",
+      params: {
+        message: { role: "user", parts, metadata: params.metadata },
+        ...params.contextId && { contextId: params.contextId },
+        ...params.configuration && { configuration: params.configuration },
+        ...params.skillId && { skill_id: params.skillId }
+      },
+      id: crypto.randomUUID()
+    };
+    const response = await this.client.request(
+      `/v1/a2a/${agentId}`,
+      { method: "POST", body: JSON.stringify(body) }
+    );
+    return response.result;
+  }
+  /**
+   * Get a task by ID.
+   *
+   * @example
+   * ```typescript
+   * const task = await sly.a2a.getTask('agent-uuid', 'task-uuid');
+   * console.log(task.status.state);
+   * ```
+   */
+  async getTask(agentId, taskId, historyLength) {
+    const body = {
+      jsonrpc: "2.0",
+      method: "tasks/get",
+      params: { id: taskId, ...historyLength && { historyLength } },
+      id: crypto.randomUUID()
+    };
+    const response = await this.client.request(
+      `/v1/a2a/${agentId}`,
+      { method: "POST", body: JSON.stringify(body) }
+    );
+    return response.result;
+  }
+  /**
+   * Cancel a task.
+   */
+  async cancelTask(agentId, taskId) {
+    const body = {
+      jsonrpc: "2.0",
+      method: "tasks/cancel",
+      params: { id: taskId },
+      id: crypto.randomUUID()
+    };
+    const response = await this.client.request(
+      `/v1/a2a/${agentId}`,
+      { method: "POST", body: JSON.stringify(body) }
+    );
+    return response.result;
+  }
+  /**
+   * List tasks for an agent (REST endpoint).
+   *
+   * @example
+   * ```typescript
+   * const { data, pagination } = await sly.a2a.listTasks({
+   *   agentId: 'agent-uuid',
+   *   state: 'completed',
+   *   limit: 20,
+   * });
+   * ```
+   */
+  async listTasks(options = {}) {
+    const params = new URLSearchParams();
+    if (options.agentId) params.append("agent_id", options.agentId);
+    if (options.state) params.append("state", options.state);
+    if (options.direction) params.append("direction", options.direction);
+    if (options.contextId) params.append("context_id", options.contextId);
+    if (options.page) params.append("page", options.page.toString());
+    if (options.limit) params.append("limit", options.limit.toString());
+    const qs = params.toString();
+    return this.client.request(
+      qs ? `/v1/a2a/tasks?${qs}` : "/v1/a2a/tasks"
+    );
+  }
+  /**
+   * Respond to a task in input-required state (human-in-the-loop).
+   */
+  async respond(taskId, message) {
+    return this.client.request(
+      `/v1/a2a/tasks/${taskId}/respond`,
+      { method: "POST", body: JSON.stringify({ message }) }
+    );
+  }
+  // =========================================================================
+  // Custom Tools (Story 58.15)
+  // =========================================================================
+  /**
+   * Register a custom tool for an agent.
+   *
+   * @example
+   * ```typescript
+   * const tool = await sly.a2a.createCustomTool('agent-uuid', {
+   *   toolName: 'lookup_inventory',
+   *   description: 'Check product inventory levels',
+   *   inputSchema: {
+   *     type: 'object',
+   *     properties: { sku: { type: 'string' } },
+   *     required: ['sku'],
+   *   },
+   *   handlerUrl: 'https://api.example.com/inventory',
+   * });
+   * ```
+   */
+  async createCustomTool(agentId, request) {
+    const response = await this.client.request(
+      `/v1/a2a/agents/${agentId}/tools`,
+      { method: "POST", body: JSON.stringify(request) }
+    );
+    return response.data;
+  }
+  /**
+   * List custom tools for an agent.
+   */
+  async listCustomTools(agentId) {
+    const response = await this.client.request(
+      `/v1/a2a/agents/${agentId}/tools`
+    );
+    return response.data;
+  }
+  /**
+   * Delete a custom tool.
+   */
+  async deleteCustomTool(agentId, toolId) {
+    await this.client.request(
+      `/v1/a2a/agents/${agentId}/tools/${toolId}`,
+      { method: "DELETE" }
+    );
+  }
+};
+
+exports.A2AClient = A2AClient;
+//# sourceMappingURL=a2a.js.map
+//# sourceMappingURL=a2a.js.map

package/dist/a2a.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/protocols/a2a/client.ts"],"names":[],"mappings":"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","file":"a2a.js","sourcesContent":["/**\n * A2A Client - Google Agent-to-Agent Protocol\n *\n * SDK client for sending tasks to Sly-hosted agents, discovering agent\n * capabilities, and managing task lifecycle.\n *\n * @see Epic 57: Google A2A Protocol Integration\n * @see Epic 58: A2A Task Processor Worker (Story 58.11)\n */\n\nimport type { PayOSClient } from '../../client';\nimport type {\n  A2AAgentCard,\n  A2ATask,\n  A2AListTasksOptions,\n  A2AListTasksResponse,\n  A2AConfiguration,\n  A2APart,\n  A2ACustomTool,\n  A2ACreateCustomToolRequest,\n} from '@sly/types';\n\nexport class A2AClient {\n  private client: PayOSClient;\n\n  constructor(client: PayOSClient) {\n    this.client = client;\n  }\n\n  /**\n   * Discover an agent's capabilities via its Agent Card.\n   *\n   * @example\n   * ```typescript\n   * const card = await sly.a2a.discover('agent-uuid');\n   * console.log(card.skills);\n   * ```\n   */\n  async discover(agentId: string): Promise<A2AAgentCard> {\n    return this.client.request<A2AAgentCard>(\n      `/v1/a2a/${agentId}/.well-known/agent.json`,\n    );\n  }\n\n  /**\n   * Send a message to an agent, creating or continuing a task.\n   *\n   * @example\n   * ```typescript\n   * const task = await sly.a2a.sendMessage('agent-uuid', {\n   *   message: 'Check my wallet balance',\n   * });\n   * console.log(task.status.state); // 'submitted' or 'completed'\n   * ```\n   */\n  async sendMessage(\n    agentId: string,\n    params: {\n      message: string | A2APart[];\n      contextId?: string;\n      configuration?: A2AConfiguration;\n      metadata?: Record<string, unknown>;\n      skillId?: string;\n    },\n  ): Promise<A2ATask> {\n    const parts: A2APart[] =\n      typeof params.message === 'string'\n        ? [{ text: params.message }]\n        : params.message;\n\n    const body = {\n      jsonrpc: '2.0' as const,\n      method: 'message/send',\n      params: {\n        message: { role: 'user', parts, metadata: params.metadata },\n        ...(params.contextId && { contextId: params.contextId }),\n        ...(params.configuration && { configuration: params.configuration }),\n        ...(params.skillId && { skill_id: params.skillId }),\n      },\n      id: crypto.randomUUID(),\n    };\n\n    const response = await this.client.request<{ result: A2ATask }>(\n      `/v1/a2a/${agentId}`,\n      { method: 'POST', body: JSON.stringify(body) },\n    );\n    return response.result;\n  }\n\n  /**\n   * Get a task by ID.\n   *\n   * @example\n   * ```typescript\n   * const task = await sly.a2a.getTask('agent-uuid', 'task-uuid');\n   * console.log(task.status.state);\n   * ```\n   */\n  async getTask(\n    agentId: string,\n    taskId: string,\n    historyLength?: number,\n  ): Promise<A2ATask> {\n    const body = {\n      jsonrpc: '2.0' as const,\n      method: 'tasks/get',\n      params: { id: taskId, ...(historyLength && { historyLength }) },\n      id: crypto.randomUUID(),\n    };\n\n    const response = await this.client.request<{ result: A2ATask }>(\n      `/v1/a2a/${agentId}`,\n      { method: 'POST', body: JSON.stringify(body) },\n    );\n    return response.result;\n  }\n\n  /**\n   * Cancel a task.\n   */\n  async cancelTask(agentId: string, taskId: string): Promise<A2ATask> {\n    const body = {\n      jsonrpc: '2.0' as const,\n      method: 'tasks/cancel',\n      params: { id: taskId },\n      id: crypto.randomUUID(),\n    };\n\n    const response = await this.client.request<{ result: A2ATask }>(\n      `/v1/a2a/${agentId}`,\n      { method: 'POST', body: JSON.stringify(body) },\n    );\n    return response.result;\n  }\n\n  /**\n   * List tasks for an agent (REST endpoint).\n   *\n   * @example\n   * ```typescript\n   * const { data, pagination } = await sly.a2a.listTasks({\n   *   agentId: 'agent-uuid',\n   *   state: 'completed',\n   *   limit: 20,\n   * });\n   * ```\n   */\n  async listTasks(options: A2AListTasksOptions = {}): Promise<A2AListTasksResponse> {\n    const params = new URLSearchParams();\n    if (options.agentId) params.append('agent_id', options.agentId);\n    if (options.state) params.append('state', options.state);\n    if (options.direction) params.append('direction', options.direction);\n    if (options.contextId) params.append('context_id', options.contextId);\n    if (options.page) params.append('page', options.page.toString());\n    if (options.limit) params.append('limit', options.limit.toString());\n\n    const qs = params.toString();\n    return this.client.request<A2AListTasksResponse>(\n      qs ? `/v1/a2a/tasks?${qs}` : '/v1/a2a/tasks',\n    );\n  }\n\n  /**\n   * Respond to a task in input-required state (human-in-the-loop).\n   */\n  async respond(taskId: string, message: string): Promise<{ status: string }> {\n    return this.client.request<{ status: string }>(\n      `/v1/a2a/tasks/${taskId}/respond`,\n      { method: 'POST', body: JSON.stringify({ message }) },\n    );\n  }\n\n  // =========================================================================\n  // Custom Tools (Story 58.15)\n  // =========================================================================\n\n  /**\n   * Register a custom tool for an agent.\n   *\n   * @example\n   * ```typescript\n   * const tool = await sly.a2a.createCustomTool('agent-uuid', {\n   *   toolName: 'lookup_inventory',\n   *   description: 'Check product inventory levels',\n   *   inputSchema: {\n   *     type: 'object',\n   *     properties: { sku: { type: 'string' } },\n   *     required: ['sku'],\n   *   },\n   *   handlerUrl: 'https://api.example.com/inventory',\n   * });\n   * ```\n   */\n  async createCustomTool(\n    agentId: string,\n    request: A2ACreateCustomToolRequest,\n  ): Promise<A2ACustomTool> {\n    const response = await this.client.request<{ data: A2ACustomTool }>(\n      `/v1/a2a/agents/${agentId}/tools`,\n      { method: 'POST', body: JSON.stringify(request) },\n    );\n    return response.data;\n  }\n\n  /**\n   * List custom tools for an agent.\n   */\n  async listCustomTools(agentId: string): Promise<A2ACustomTool[]> {\n    const response = await this.client.request<{ data: A2ACustomTool[] }>(\n      `/v1/a2a/agents/${agentId}/tools`,\n    );\n    return response.data;\n  }\n\n  /**\n   * Delete a custom tool.\n   */\n  async deleteCustomTool(agentId: string, toolId: string): Promise<void> {\n    await this.client.request<void>(\n      `/v1/a2a/agents/${agentId}/tools/${toolId}`,\n      { method: 'DELETE' },\n    );\n  }\n}\n"]}

package/dist/a2a.mjs

@@ -0,0 +1,171 @@
+// src/protocols/a2a/client.ts
+var A2AClient = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * Discover an agent's capabilities via its Agent Card.
+   *
+   * @example
+   * ```typescript
+   * const card = await sly.a2a.discover('agent-uuid');
+   * console.log(card.skills);
+   * ```
+   */
+  async discover(agentId) {
+    return this.client.request(
+      `/v1/a2a/${agentId}/.well-known/agent.json`
+    );
+  }
+  /**
+   * Send a message to an agent, creating or continuing a task.
+   *
+   * @example
+   * ```typescript
+   * const task = await sly.a2a.sendMessage('agent-uuid', {
+   *   message: 'Check my wallet balance',
+   * });
+   * console.log(task.status.state); // 'submitted' or 'completed'
+   * ```
+   */
+  async sendMessage(agentId, params) {
+    const parts = typeof params.message === "string" ? [{ text: params.message }] : params.message;
+    const body = {
+      jsonrpc: "2.0",
+      method: "message/send",
+      params: {
+        message: { role: "user", parts, metadata: params.metadata },
+        ...params.contextId && { contextId: params.contextId },
+        ...params.configuration && { configuration: params.configuration },
+        ...params.skillId && { skill_id: params.skillId }
+      },
+      id: crypto.randomUUID()
+    };
+    const response = await this.client.request(
+      `/v1/a2a/${agentId}`,
+      { method: "POST", body: JSON.stringify(body) }
+    );
+    return response.result;
+  }
+  /**
+   * Get a task by ID.
+   *
+   * @example
+   * ```typescript
+   * const task = await sly.a2a.getTask('agent-uuid', 'task-uuid');
+   * console.log(task.status.state);
+   * ```
+   */
+  async getTask(agentId, taskId, historyLength) {
+    const body = {
+      jsonrpc: "2.0",
+      method: "tasks/get",
+      params: { id: taskId, ...historyLength && { historyLength } },
+      id: crypto.randomUUID()
+    };
+    const response = await this.client.request(
+      `/v1/a2a/${agentId}`,
+      { method: "POST", body: JSON.stringify(body) }
+    );
+    return response.result;
+  }
+  /**
+   * Cancel a task.
+   */
+  async cancelTask(agentId, taskId) {
+    const body = {
+      jsonrpc: "2.0",
+      method: "tasks/cancel",
+      params: { id: taskId },
+      id: crypto.randomUUID()
+    };
+    const response = await this.client.request(
+      `/v1/a2a/${agentId}`,
+      { method: "POST", body: JSON.stringify(body) }
+    );
+    return response.result;
+  }
+  /**
+   * List tasks for an agent (REST endpoint).
+   *
+   * @example
+   * ```typescript
+   * const { data, pagination } = await sly.a2a.listTasks({
+   *   agentId: 'agent-uuid',
+   *   state: 'completed',
+   *   limit: 20,
+   * });
+   * ```
+   */
+  async listTasks(options = {}) {
+    const params = new URLSearchParams();
+    if (options.agentId) params.append("agent_id", options.agentId);
+    if (options.state) params.append("state", options.state);
+    if (options.direction) params.append("direction", options.direction);
+    if (options.contextId) params.append("context_id", options.contextId);
+    if (options.page) params.append("page", options.page.toString());
+    if (options.limit) params.append("limit", options.limit.toString());
+    const qs = params.toString();
+    return this.client.request(
+      qs ? `/v1/a2a/tasks?${qs}` : "/v1/a2a/tasks"
+    );
+  }
+  /**
+   * Respond to a task in input-required state (human-in-the-loop).
+   */
+  async respond(taskId, message) {
+    return this.client.request(
+      `/v1/a2a/tasks/${taskId}/respond`,
+      { method: "POST", body: JSON.stringify({ message }) }
+    );
+  }
+  // =========================================================================
+  // Custom Tools (Story 58.15)
+  // =========================================================================
+  /**
+   * Register a custom tool for an agent.
+   *
+   * @example
+   * ```typescript
+   * const tool = await sly.a2a.createCustomTool('agent-uuid', {
+   *   toolName: 'lookup_inventory',
+   *   description: 'Check product inventory levels',
+   *   inputSchema: {
+   *     type: 'object',
+   *     properties: { sku: { type: 'string' } },
+   *     required: ['sku'],
+   *   },
+   *   handlerUrl: 'https://api.example.com/inventory',
+   * });
+   * ```
+   */
+  async createCustomTool(agentId, request) {
+    const response = await this.client.request(
+      `/v1/a2a/agents/${agentId}/tools`,
+      { method: "POST", body: JSON.stringify(request) }
+    );
+    return response.data;
+  }
+  /**
+   * List custom tools for an agent.
+   */
+  async listCustomTools(agentId) {
+    const response = await this.client.request(
+      `/v1/a2a/agents/${agentId}/tools`
+    );
+    return response.data;
+  }
+  /**
+   * Delete a custom tool.
+   */
+  async deleteCustomTool(agentId, toolId) {
+    await this.client.request(
+      `/v1/a2a/agents/${agentId}/tools/${toolId}`,
+      { method: "DELETE" }
+    );
+  }
+};
+
+export { A2AClient };
+//# sourceMappingURL=a2a.mjs.map
+//# sourceMappingURL=a2a.mjs.map

package/dist/a2a.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/protocols/a2a/client.ts"],"names":[],"mappings":"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","file":"a2a.mjs","sourcesContent":["/**\n * A2A Client - Google Agent-to-Agent Protocol\n *\n * SDK client for sending tasks to Sly-hosted agents, discovering agent\n * capabilities, and managing task lifecycle.\n *\n * @see Epic 57: Google A2A Protocol Integration\n * @see Epic 58: A2A Task Processor Worker (Story 58.11)\n */\n\nimport type { PayOSClient } from '../../client';\nimport type {\n  A2AAgentCard,\n  A2ATask,\n  A2AListTasksOptions,\n  A2AListTasksResponse,\n  A2AConfiguration,\n  A2APart,\n  A2ACustomTool,\n  A2ACreateCustomToolRequest,\n} from '@sly/types';\n\nexport class A2AClient {\n  private client: PayOSClient;\n\n  constructor(client: PayOSClient) {\n    this.client = client;\n  }\n\n  /**\n   * Discover an agent's capabilities via its Agent Card.\n   *\n   * @example\n   * ```typescript\n   * const card = await sly.a2a.discover('agent-uuid');\n   * console.log(card.skills);\n   * ```\n   */\n  async discover(agentId: string): Promise<A2AAgentCard> {\n    return this.client.request<A2AAgentCard>(\n      `/v1/a2a/${agentId}/.well-known/agent.json`,\n    );\n  }\n\n  /**\n   * Send a message to an agent, creating or continuing a task.\n   *\n   * @example\n   * ```typescript\n   * const task = await sly.a2a.sendMessage('agent-uuid', {\n   *   message: 'Check my wallet balance',\n   * });\n   * console.log(task.status.state); // 'submitted' or 'completed'\n   * ```\n   */\n  async sendMessage(\n    agentId: string,\n    params: {\n      message: string | A2APart[];\n      contextId?: string;\n      configuration?: A2AConfiguration;\n      metadata?: Record<string, unknown>;\n      skillId?: string;\n    },\n  ): Promise<A2ATask> {\n    const parts: A2APart[] =\n      typeof params.message === 'string'\n        ? [{ text: params.message }]\n        : params.message;\n\n    const body = {\n      jsonrpc: '2.0' as const,\n      method: 'message/send',\n      params: {\n        message: { role: 'user', parts, metadata: params.metadata },\n        ...(params.contextId && { contextId: params.contextId }),\n        ...(params.configuration && { configuration: params.configuration }),\n        ...(params.skillId && { skill_id: params.skillId }),\n      },\n      id: crypto.randomUUID(),\n    };\n\n    const response = await this.client.request<{ result: A2ATask }>(\n      `/v1/a2a/${agentId}`,\n      { method: 'POST', body: JSON.stringify(body) },\n    );\n    return response.result;\n  }\n\n  /**\n   * Get a task by ID.\n   *\n   * @example\n   * ```typescript\n   * const task = await sly.a2a.getTask('agent-uuid', 'task-uuid');\n   * console.log(task.status.state);\n   * ```\n   */\n  async getTask(\n    agentId: string,\n    taskId: string,\n    historyLength?: number,\n  ): Promise<A2ATask> {\n    const body = {\n      jsonrpc: '2.0' as const,\n      method: 'tasks/get',\n      params: { id: taskId, ...(historyLength && { historyLength }) },\n      id: crypto.randomUUID(),\n    };\n\n    const response = await this.client.request<{ result: A2ATask }>(\n      `/v1/a2a/${agentId}`,\n      { method: 'POST', body: JSON.stringify(body) },\n    );\n    return response.result;\n  }\n\n  /**\n   * Cancel a task.\n   */\n  async cancelTask(agentId: string, taskId: string): Promise<A2ATask> {\n    const body = {\n      jsonrpc: '2.0' as const,\n      method: 'tasks/cancel',\n      params: { id: taskId },\n      id: crypto.randomUUID(),\n    };\n\n    const response = await this.client.request<{ result: A2ATask }>(\n      `/v1/a2a/${agentId}`,\n      { method: 'POST', body: JSON.stringify(body) },\n    );\n    return response.result;\n  }\n\n  /**\n   * List tasks for an agent (REST endpoint).\n   *\n   * @example\n   * ```typescript\n   * const { data, pagination } = await sly.a2a.listTasks({\n   *   agentId: 'agent-uuid',\n   *   state: 'completed',\n   *   limit: 20,\n   * });\n   * ```\n   */\n  async listTasks(options: A2AListTasksOptions = {}): Promise<A2AListTasksResponse> {\n    const params = new URLSearchParams();\n    if (options.agentId) params.append('agent_id', options.agentId);\n    if (options.state) params.append('state', options.state);\n    if (options.direction) params.append('direction', options.direction);\n    if (options.contextId) params.append('context_id', options.contextId);\n    if (options.page) params.append('page', options.page.toString());\n    if (options.limit) params.append('limit', options.limit.toString());\n\n    const qs = params.toString();\n    return this.client.request<A2AListTasksResponse>(\n      qs ? `/v1/a2a/tasks?${qs}` : '/v1/a2a/tasks',\n    );\n  }\n\n  /**\n   * Respond to a task in input-required state (human-in-the-loop).\n   */\n  async respond(taskId: string, message: string): Promise<{ status: string }> {\n    return this.client.request<{ status: string }>(\n      `/v1/a2a/tasks/${taskId}/respond`,\n      { method: 'POST', body: JSON.stringify({ message }) },\n    );\n  }\n\n  // =========================================================================\n  // Custom Tools (Story 58.15)\n  // =========================================================================\n\n  /**\n   * Register a custom tool for an agent.\n   *\n   * @example\n   * ```typescript\n   * const tool = await sly.a2a.createCustomTool('agent-uuid', {\n   *   toolName: 'lookup_inventory',\n   *   description: 'Check product inventory levels',\n   *   inputSchema: {\n   *     type: 'object',\n   *     properties: { sku: { type: 'string' } },\n   *     required: ['sku'],\n   *   },\n   *   handlerUrl: 'https://api.example.com/inventory',\n   * });\n   * ```\n   */\n  async createCustomTool(\n    agentId: string,\n    request: A2ACreateCustomToolRequest,\n  ): Promise<A2ACustomTool> {\n    const response = await this.client.request<{ data: A2ACustomTool }>(\n      `/v1/a2a/agents/${agentId}/tools`,\n      { method: 'POST', body: JSON.stringify(request) },\n    );\n    return response.data;\n  }\n\n  /**\n   * List custom tools for an agent.\n   */\n  async listCustomTools(agentId: string): Promise<A2ACustomTool[]> {\n    const response = await this.client.request<{ data: A2ACustomTool[] }>(\n      `/v1/a2a/agents/${agentId}/tools`,\n    );\n    return response.data;\n  }\n\n  /**\n   * Delete a custom tool.\n   */\n  async deleteCustomTool(agentId: string, toolId: string): Promise<void> {\n    await this.client.request<void>(\n      `/v1/a2a/agents/${agentId}/tools/${toolId}`,\n      { method: 'DELETE' },\n    );\n  }\n}\n"]}

package/dist/acp.d.mts

@@ -0,0 +1,201 @@
+import { S as SlyClient } from './client-Cwe2CLU7.mjs';
+import './types-df1EICn_.mjs';
+
+/**
+ * Types for ACP (Agentic Commerce Protocol) - Stripe/OpenAI
+ */
+type CheckoutStatus = 'pending' | 'completed' | 'cancelled' | 'expired' | 'failed';
+interface CheckoutItem {
+    item_id?: string;
+    name: string;
+    description?: string;
+    image_url?: string;
+    quantity: number;
+    unit_price: number;
+    total_price: number;
+    currency?: string;
+    item_data?: Record<string, any>;
+}
+interface Checkout {
+    id: string;
+    checkout_id: string;
+    agent_id: string;
+    agent_name?: string;
+    merchant_id: string;
+    merchant_name?: string;
+    customer_id?: string;
+    customer_email?: string;
+    total_amount: number;
+    currency: string;
+    status: CheckoutStatus;
+    created_at: string;
+    completed_at?: string;
+}
+interface CheckoutWithItems extends Checkout {
+    session_id?: string;
+    account_id: string;
+    merchant_url?: string;
+    subtotal: number;
+    tax_amount: number;
+    shipping_amount: number;
+    discount_amount: number;
+    shared_payment_token?: string;
+    payment_method?: string;
+    transfer_id?: string;
+    checkout_data?: Record<string, any>;
+    shipping_address?: Record<string, any>;
+    metadata?: Record<string, any>;
+    updated_at?: string;
+    cancelled_at?: string;
+    expires_at?: string;
+    items: CheckoutItem[];
+}
+interface CreateCheckoutRequest {
+    checkout_id: string;
+    session_id?: string;
+    agent_id: string;
+    agent_name?: string;
+    customer_id?: string;
+    customer_email?: string;
+    account_id: string;
+    merchant_id: string;
+    merchant_name?: string;
+    merchant_url?: string;
+    items: CheckoutItem[];
+    tax_amount?: number;
+    shipping_amount?: number;
+    discount_amount?: number;
+    currency?: string;
+    shared_payment_token?: string;
+    payment_method?: string;
+    checkout_data?: Record<string, any>;
+    shipping_address?: Record<string, any>;
+    metadata?: Record<string, any>;
+    expires_at?: string;
+}
+interface CompleteCheckoutRequest {
+    shared_payment_token: string;
+    payment_method?: string;
+    idempotency_key?: string;
+}
+interface CompleteCheckoutResponse {
+    checkout_id: string;
+    transfer_id: string;
+    status: CheckoutStatus;
+    completed_at: string;
+    total_amount: number;
+    currency: string;
+}
+interface ListCheckoutsOptions {
+    status?: CheckoutStatus;
+    agent_id?: string;
+    merchant_id?: string;
+    customer_id?: string;
+    limit?: number;
+    offset?: number;
+}
+interface ListCheckoutsResponse {
+    data: Checkout[];
+    pagination: {
+        total: number;
+        limit: number;
+        offset: number;
+    };
+}
+
+/**
+ * ACP Client - Agentic Commerce Protocol (Stripe/OpenAI)
+ *
+ * Wraps PayOS ACP API endpoints for checkout-based payments.
+ */
+
+declare class ACPClient {
+    private client;
+    constructor(client: SlyClient);
+    /**
+     * Create a new ACP checkout session
+     *
+     * @example
+     * ```typescript
+     * const checkout = await payos.acp.createCheckout({
+     *   checkout_id: 'checkout_unique_123',
+     *   agent_id: 'agent_shopping_assistant',
+     *   account_id: 'acct_uuid',
+     *   merchant_id: 'merchant_store',
+     *   items: [
+     *     {
+     *       name: 'Product 1',
+     *       quantity: 2,
+     *       unit_price: 50.00,
+     *       total_price: 100.00,
+     *     },
+     *   ],
+     *   tax_amount: 10.00,
+     *   shipping_amount: 5.00,
+     * });
+     * ```
+     */
+    createCheckout(request: CreateCheckoutRequest): Promise<CheckoutWithItems>;
+    /**
+     * List checkouts with optional filtering
+     *
+     * @example
+     * ```typescript
+     * const { data, pagination } = await payos.acp.listCheckouts({
+     *   status: 'pending',
+     *   agent_id: 'agent_shopping_assistant',
+     *   limit: 20,
+     * });
+     * ```
+     */
+    listCheckouts(options?: ListCheckoutsOptions): Promise<ListCheckoutsResponse>;
+    /**
+     * Get checkout details with items
+     *
+     * @example
+     * ```typescript
+     * const checkout = await payos.acp.getCheckout('checkout_id');
+     * console.log(checkout.items);
+     * console.log(checkout.total_amount);
+     * ```
+     */
+    getCheckout(checkoutId: string): Promise<CheckoutWithItems>;
+    /**
+     * Complete a checkout with SharedPaymentToken
+     *
+     * @example
+     * ```typescript
+     * const result = await payos.acp.completeCheckout('checkout_id', {
+     *   shared_payment_token: 'spt_...',
+     *   payment_method: 'card',
+     * });
+     *
+     * console.log(result.transfer_id);
+     * console.log(result.status); // 'completed'
+     * ```
+     */
+    completeCheckout(checkoutId: string, request: CompleteCheckoutRequest): Promise<CompleteCheckoutResponse>;
+    /**
+     * Cancel a checkout
+     *
+     * @example
+     * ```typescript
+     * const result = await payos.acp.cancelCheckout('checkout_id');
+     * console.log(result.status); // 'cancelled'
+     * ```
+     */
+    cancelCheckout(checkoutId: string): Promise<Checkout>;
+    /**
+     * Get ACP analytics
+     *
+     * @example
+     * ```typescript
+     * const analytics = await payos.acp.getAnalytics('30d');
+     * console.log(analytics.summary.totalRevenue);
+     * console.log(analytics.summary.averageOrderValue);
+     * ```
+     */
+    getAnalytics(period?: '24h' | '7d' | '30d' | '90d' | '1y'): Promise<any>;
+}
+
+export { ACPClient, type Checkout, type CheckoutItem, type CheckoutStatus, type CheckoutWithItems, type CompleteCheckoutRequest, type CompleteCheckoutResponse, type CreateCheckoutRequest, type ListCheckoutsOptions, type ListCheckoutsResponse };