@reminix/sdk 0.9.0 → 0.11.0

package/resources/agents.d.ts

@@ -1,46 +1,53 @@
 import { APIResource } from "../core/resource.js";
 import * as AgentsAPI from "./agents.js";
 import { APIPromise } from "../core/api-promise.js";
+import { Cursor, type CursorParams, PagePromise } from "../core/pagination.js";
 import { Stream } from "../core/streaming.js";
 import { RequestOptions } from "../internal/request-options.js";
 export declare class Agents extends APIResource {
     /**
-     * Have a conversational interaction with an agent. This endpoint maintains
-     * conversation context through the messages array, allowing for multi-turn
-     * conversations.
+     * Get details of a specific agent by name.
      *
-     * **Timeout:** Chat requests have a 60-second timeout. If the agent takes longer
-     * to respond, you will receive a 504 Gateway Timeout error. For long-running
-     * conversations, consider using streaming mode which does not have the same
-     * timeout constraints.
+     * @example
+     * ```ts
+     * const agent = await client.agents.retrieve('x');
+     * ```
+     */
+    retrieve(name: string, options?: RequestOptions): APIPromise<Agent>;
+    /**
+     * List all agents in the project with optional filtering by type and status.
      *
-     * **Idempotency:** For non-streaming requests, send an `Idempotency-Key` header
-     * with a unique value (e.g., UUID) to ensure duplicate requests return the same
-     * response. Keys are valid for 24 hours. Streaming responses are not cached.
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const agent of client.agents.list()) {
+     *   // ...
+     * }
+     * ```
+     */
+    list(query?: AgentListParams | null | undefined, options?: RequestOptions): PagePromise<AgentsCursor, Agent>;
+    /**
+     * Send a chat message to an agent and receive a response.
      *
-     * **Use cases:**
+     * **Supported Agents:**
      *
-     * - Customer support chatbots
-     * - AI assistants with memory
-     * - Multi-step question answering
-     * - Conversational agents that need context
+     * - Managed agents: Always supported
+     * - Custom agents: Only supported if agent has `messages` in both requestKeys and
+     *   responseKeys
      *
-     * **Message format:** Follows OpenAI-compliant message structure with support for:
+     * **Tool Calls:** Messages support the OpenAI tool calling format:
      *
-     * - `system`, `user`, `assistant`, and `tool` roles
-     * - Multimodal content (text + images)
-     * - Tool/function calling
+     * - Assistant messages can include `tool_calls` array with function calls
+     * - Tool result messages use `role: "tool"` with `tool_call_id` and `name`
+     * - Content can be `null` when `tool_calls` is present
      *
-     * **Streaming:** Set `stream: true` in the request body to receive Server-Sent
-     * Events (SSE) stream with incremental chunks. Perfect for ChatGPT-like real-time
-     * chat interfaces.
+     * **Streaming:** Set `stream: true` to receive Server-Sent Events (SSE) for
+     * real-time responses.
      *
      * @example
      * ```ts
      * const response = await client.agents.chat('name', {
-     *   messages: [
-     *     { role: 'user', content: 'What is the weather today?' },
-     *   ],
+     *   messages: [{ content: 'string', role: 'system' }],
      * });
      * ```
      */
@@ -48,10 +55,14 @@ export declare class Agents extends APIResource {
     chat(name: string, body: AgentChatParamsStreaming, options?: RequestOptions): APIPromise<Stream<StreamChunk>>;
     chat(name: string, body: AgentChatParamsBase, options?: RequestOptions): APIPromise<Stream<StreamChunk> | AgentChatResponse>;
     /**
-     * Execute a one-shot task with an agent. This endpoint is designed for
-     * task-oriented operations where you provide input and receive a complete output.
+     * Execute an agent with the provided input.
+     *
+     * **Agent Types:**
+     *
+     * - Task-oriented agents: Pass structured input data
+     * - Chat agents: Pass `{ messages: [...] }` in the input
      *
-     * **Timeout:** Agent invocations have a 60-second timeout. If the agent takes
+     * **Timeout:** Agent executions have a 60-second timeout. If the agent takes
      * longer to respond, you will receive a 504 Gateway Timeout error. For
      * long-running tasks, consider using streaming mode which does not have the same
      * timeout constraints.
@@ -60,203 +71,317 @@ export declare class Agents extends APIResource {
      * with a unique value (e.g., UUID) to ensure duplicate requests return the same
      * response. Keys are valid for 24 hours. Streaming responses are not cached.
      *
-     * **Use cases:**
-     *
-     * - Data analysis and processing
-     * - Content generation (with streaming for long outputs)
-     * - One-time operations that don't require conversation history
-     * - API-like operations
-     *
      * **Streaming:** Set `stream: true` in the request body to receive Server-Sent
      * Events (SSE) stream with incremental chunks. Useful for long-running tasks or
-     * real-time progress updates.
+     * real-time chat interfaces.
      *
      * @example
      * ```ts
-     * const response = await client.agents.invoke('name', {
-     *   input: {
-     *     task: 'analyze this data',
-     *     data: { value: 123, items: ['a', 'b', 'c'] },
-     *   },
-     * });
+     * const response = await client.agents.execute('name');
      * ```
      */
-    invoke(name: string, body: AgentInvokeParamsNonStreaming, options?: RequestOptions): APIPromise<AgentInvokeResponse>;
-    invoke(name: string, body: AgentInvokeParamsStreaming, options?: RequestOptions): APIPromise<Stream<StreamChunk>>;
-    invoke(name: string, body: AgentInvokeParamsBase, options?: RequestOptions): APIPromise<Stream<StreamChunk> | AgentInvokeResponse>;
+    execute(name: string, body?: AgentExecuteParamsNonStreaming, options?: RequestOptions): APIPromise<AgentExecuteResponse>;
+    execute(name: string, body: AgentExecuteParamsStreaming, options?: RequestOptions): APIPromise<Stream<StreamChunk>>;
+    execute(name: string, body?: AgentExecuteParamsBase | undefined, options?: RequestOptions): APIPromise<Stream<StreamChunk> | AgentExecuteResponse>;
+}
+export type AgentsCursor = Cursor<Agent>;
+export interface Agent {
+    /**
+     * Unique agent ID
+     */
+    id: string;
+    /**
+     * Whether agent supports chat interface
+     */
+    canChat: boolean | null;
+    /**
+     * Whether agent supports streaming
+     */
+    canStream: boolean | null;
+    /**
+     * Agent configuration (for managed agents)
+     */
+    config: AgentConfig | null;
+    /**
+     * Creation timestamp
+     */
+    createdAt: string;
+    /**
+     * User who created the agent
+     */
+    createdBy: string | null;
+    /**
+     * Agent description
+     */
+    description: string | null;
+    /**
+     * When the agent was discovered (for custom agents)
+     */
+    discoveredAt: string | null;
+    /**
+     * Agent name
+     */
+    name: string;
+    /**
+     * JSON Schema for agent input parameters
+     */
+    output: Agent.Output | null;
+    /**
+     * JSON Schema for agent input parameters
+     */
+    parameters: Agent.Parameters | null;
+    /**
+     * Project ID
+     */
+    projectId: string;
+    /**
+     * Top-level keys expected in request body
+     */
+    requestKeys: Array<string> | null;
+    /**
+     * Top-level keys returned in response body
+     */
+    responseKeys: Array<string> | null;
+    /**
+     * Agent status
+     */
+    status: 'active' | 'inactive';
+    /**
+     * Agent type: "managed" for UI-created, "{language}" for custom agents (e.g.,
+     * "python"), or "{language}-{adapter}" for adapter-based (e.g.,
+     * "python-langchain")
+     */
+    type: string;
+    /**
+     * Last update timestamp
+     */
+    updatedAt: string;
+}
+export declare namespace Agent {
+    /**
+     * JSON Schema for agent input parameters
+     */
+    interface Output {
+        type: string;
+        properties?: {
+            [key: string]: unknown;
+        };
+        required?: Array<string>;
+        [k: string]: unknown;
+    }
+    /**
+     * JSON Schema for agent input parameters
+     */
+    interface Parameters {
+        type: string;
+        properties?: {
+            [key: string]: unknown;
+        };
+        required?: Array<string>;
+        [k: string]: unknown;
+    }
 }
 /**
- * Optional request context passed to the agent handler.
+ * Agent configuration (for managed agents)
  */
-export interface Context {
+export interface AgentConfig {
     /**
-     * ID to track multi-turn conversations
+     * Model identifier (e.g., "gpt-4o", "claude-sonnet-4-20250514")
      */
-    conversation_id?: string;
+    model: string;
     /**
-     * Additional custom context fields
+     * LLM provider
      */
-    custom?: {
+    provider: 'openai' | 'anthropic';
+    /**
+     * System prompt for the agent
+     */
+    systemPrompt: string;
+    /**
+     * List of tools available to the agent
+     */
+    tools: Array<string>;
+    /**
+     * Maximum tool call iterations
+     */
+    maxIterations?: number;
+    /**
+     * Whether to require approval for tool calls
+     */
+    requireApproval?: boolean;
+}
+export interface ChatMessage {
+    /**
+     * Message content. Can be string, array (multimodal), object (tool), or null (when
+     * tool_calls present).
+     */
+    content: string | Array<ChatMessage.MultimodalContent> | {
         [key: string]: unknown;
-    };
+    } | null;
+    /**
+     * Message role
+     */
+    role: 'system' | 'user' | 'assistant' | 'tool';
+    /**
+     * Tool name (required when role is "tool")
+     */
+    name?: string;
+    /**
+     * Tool call ID (for tool role messages)
+     */
+    tool_call_id?: string;
     /**
-     * ID of the user making the request
+     * Tool calls requested by assistant (for assistant role messages)
      */
-    user_id?: string;
+    tool_calls?: Array<ChatMessage.ToolCall>;
+}
+export declare namespace ChatMessage {
+    interface MultimodalContent {
+        type: 'text' | 'image_url';
+        image_url?: MultimodalContent.ImageURL;
+        text?: string;
+    }
+    namespace MultimodalContent {
+        interface ImageURL {
+            url: string;
+        }
+    }
+    interface ToolCall {
+        id: string;
+        function: ToolCall.Function;
+        type: 'function';
+    }
+    namespace ToolCall {
+        interface Function {
+            arguments: string;
+            name: string;
+        }
+    }
 }
 export interface StreamChunk {
     /**
      * Text chunk from the stream
      */
     chunk: string;
+    [k: string]: unknown;
 }
 export interface AgentChatResponse {
     /**
-     * Full conversation history including the assistant response
+     * Array of assistant response messages
      */
-    messages: Array<AgentChatResponse.Message>;
+    messages: Array<ChatMessage>;
     /**
-     * Final assistant response text
+     * Conversation ID (present when conversation persistence is enabled)
      */
-    output: string;
-}
-export declare namespace AgentChatResponse {
-    interface Message {
-        /**
-         * Message content. Can be string, array (multimodal), or object (tool).
-         */
-        content: string | Array<Message.UnionMember1> | {
-            [key: string]: unknown;
-        };
-        /**
-         * Message role
-         */
-        role: 'system' | 'user' | 'assistant' | 'tool';
-        /**
-         * Tool name (required when role is "tool")
-         */
-        name?: string;
-        /**
-         * Tool call ID (for tool role)
-         */
-        tool_call_id?: string;
-    }
-    namespace Message {
-        interface UnionMember1 {
-            type: 'text' | 'image_url';
-            image_url?: UnionMember1.ImageURL;
-            text?: string;
-        }
-        namespace UnionMember1 {
-            interface ImageURL {
-                url: string;
-            }
-        }
-    }
+    conversation_id?: string;
 }
-export interface AgentInvokeResponse {
+/**
+ * Response with dynamic keys based on agent configuration. Regular agents return {
+ * output: ... }, chat agents return { messages: [...] }.
+ */
+export type AgentExecuteResponse = {
+    [key: string]: unknown;
+};
+export interface AgentListParams extends CursorParams {
+    /**
+     * Filter by agent status
+     */
+    status?: 'active' | 'inactive';
     /**
-     * Output from the agent. Structure depends on agent implementation.
+     * Filter by agent type (managed, python, typescript, python-langchain, etc.)
      */
-    output?: unknown;
+    type?: string;
 }
 export type AgentChatParams = AgentChatParamsNonStreaming | AgentChatParamsStreaming;
 export interface AgentChatParamsBase {
     /**
-     * Conversation history. Must include at least one message.
+     * Array of chat messages
      */
-    messages: Array<AgentChatParams.Message>;
+    messages: Array<ChatMessage>;
     /**
-     * Optional request context passed to the agent handler.
+     * Optional context for the agent execution
      */
-    context?: Context;
+    context?: AgentChatParams.Context;
     /**
-     * Whether to stream the response as SSE.
+     * Conversation ID to continue an existing conversation
+     */
+    conversation_id?: string;
+    /**
+     * Enable streaming response
      */
     stream?: boolean;
 }
 export declare namespace AgentChatParams {
-    interface Message {
+    /**
+     * Optional context for the agent execution
+     */
+    interface Context {
         /**
-         * Message content. Can be string, array (multimodal), or object (tool).
+         * Identity fields for conversation scoping (e.g., user_id, tenant_id)
          */
-        content: string | Array<Message.UnionMember1> | {
+        identity?: {
             [key: string]: unknown;
         };
-        /**
-         * Message role
-         */
-        role: 'system' | 'user' | 'assistant' | 'tool';
-        /**
-         * Tool name (required when role is "tool")
-         */
-        name?: string;
-        /**
-         * Tool call ID (for tool role)
-         */
-        tool_call_id?: string;
-    }
-    namespace Message {
-        interface UnionMember1 {
-            type: 'text' | 'image_url';
-            image_url?: UnionMember1.ImageURL;
-            text?: string;
-        }
-        namespace UnionMember1 {
-            interface ImageURL {
-                url: string;
-            }
-        }
+        [k: string]: unknown;
     }
     type AgentChatParamsNonStreaming = AgentsAPI.AgentChatParamsNonStreaming;
     type AgentChatParamsStreaming = AgentsAPI.AgentChatParamsStreaming;
 }
 export interface AgentChatParamsNonStreaming extends AgentChatParamsBase {
     /**
-     * Whether to stream the response as SSE.
+     * Enable streaming response
      */
     stream?: false;
 }
 export interface AgentChatParamsStreaming extends AgentChatParamsBase {
     /**
-     * Whether to stream the response as SSE.
+     * Enable streaming response
      */
     stream: true;
 }
-export type AgentInvokeParams = AgentInvokeParamsNonStreaming | AgentInvokeParamsStreaming;
-export interface AgentInvokeParamsBase {
-    /**
-     * Input data for the agent. Structure depends on agent implementation.
-     */
-    input: {
-        [key: string]: unknown;
-    };
+export type AgentExecuteParams = AgentExecuteParamsNonStreaming | AgentExecuteParamsStreaming;
+export interface AgentExecuteParamsBase {
     /**
-     * Optional request context passed to the agent handler.
+     * Optional context for the agent execution
      */
-    context?: Context;
+    context?: AgentExecuteParams.Context;
     /**
-     * Whether to stream the response as SSE.
+     * Enable streaming response (SSE)
      */
     stream?: boolean;
+    [k: string]: unknown;
 }
-export declare namespace AgentInvokeParams {
-    type AgentInvokeParamsNonStreaming = AgentsAPI.AgentInvokeParamsNonStreaming;
-    type AgentInvokeParamsStreaming = AgentsAPI.AgentInvokeParamsStreaming;
+export declare namespace AgentExecuteParams {
+    /**
+     * Optional context for the agent execution
+     */
+    interface Context {
+        /**
+         * Identity fields for conversation scoping (e.g., user_id, tenant_id)
+         */
+        identity?: {
+            [key: string]: unknown;
+        };
+        [k: string]: unknown;
+    }
+    type AgentExecuteParamsNonStreaming = AgentsAPI.AgentExecuteParamsNonStreaming;
+    type AgentExecuteParamsStreaming = AgentsAPI.AgentExecuteParamsStreaming;
 }
-export interface AgentInvokeParamsNonStreaming extends AgentInvokeParamsBase {
+export interface AgentExecuteParamsNonStreaming extends AgentExecuteParamsBase {
     /**
-     * Whether to stream the response as SSE.
+     * Enable streaming response (SSE)
      */
     stream?: false;
+    [k: string]: unknown;
 }
-export interface AgentInvokeParamsStreaming extends AgentInvokeParamsBase {
+export interface AgentExecuteParamsStreaming extends AgentExecuteParamsBase {
     /**
-     * Whether to stream the response as SSE.
+     * Enable streaming response (SSE)
      */
     stream: true;
+    [k: string]: unknown;
 }
 export declare namespace Agents {
-    export { type Context as Context, type StreamChunk as StreamChunk, type AgentChatResponse as AgentChatResponse, type AgentInvokeResponse as AgentInvokeResponse, type AgentChatParams as AgentChatParams, type AgentChatParamsNonStreaming as AgentChatParamsNonStreaming, type AgentChatParamsStreaming as AgentChatParamsStreaming, type AgentInvokeParams as AgentInvokeParams, type AgentInvokeParamsNonStreaming as AgentInvokeParamsNonStreaming, type AgentInvokeParamsStreaming as AgentInvokeParamsStreaming, };
+    export { type Agent as Agent, type AgentConfig as AgentConfig, type ChatMessage as ChatMessage, type StreamChunk as StreamChunk, type AgentChatResponse as AgentChatResponse, type AgentExecuteResponse as AgentExecuteResponse, type AgentsCursor as AgentsCursor, type AgentListParams as AgentListParams, type AgentChatParams as AgentChatParams, type AgentChatParamsNonStreaming as AgentChatParamsNonStreaming, type AgentChatParamsStreaming as AgentChatParamsStreaming, type AgentExecuteParams as AgentExecuteParams, type AgentExecuteParamsNonStreaming as AgentExecuteParamsNonStreaming, type AgentExecuteParamsStreaming as AgentExecuteParamsStreaming, };
 }
 //# sourceMappingURL=agents.d.ts.map

package/resources/agents.d.ts.map

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

package/resources/agents.js

@@ -3,8 +3,34 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Agents = void 0;
 const resource_1 = require("../core/resource.js");
+const pagination_1 = require("../core/pagination.js");
 const path_1 = require("../internal/utils/path.js");
 class Agents extends resource_1.APIResource {
+    /**
+     * Get details of a specific agent by name.
+     *
+     * @example
+     * ```ts
+     * const agent = await client.agents.retrieve('x');
+     * ```
+     */
+    retrieve(name, options) {
+        return this._client.get((0, path_1.path) `/agents/${name}`, options);
+    }
+    /**
+     * List all agents in the project with optional filtering by type and status.
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const agent of client.agents.list()) {
+     *   // ...
+     * }
+     * ```
+     */
+    list(query = {}, options) {
+        return this._client.getAPIList('/agents', (pagination_1.Cursor), { query, ...options });
+    }
     chat(name, body, options) {
         return this._client.post((0, path_1.path) `/agents/${name}/chat`, {
             body,
@@ -12,11 +38,11 @@ class Agents extends resource_1.APIResource {
             stream: body.stream ?? false,
         });
     }
-    invoke(name, body, options) {
-        return this._client.post((0, path_1.path) `/agents/${name}/invoke`, {
+    execute(name, body = {}, options) {
+        return this._client.post((0, path_1.path) `/agents/${name}/execute`, {
             body,
             ...options,
-            stream: body.stream ?? false,
+            stream: body?.stream ?? false,
         });
     }
 }

package/resources/agents.js.map

@@ -1 +1 @@
-{"version":3,"file":"agents.js","sourceRoot":"","sources":["../src/resources/agents.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,kDAA+C;AAK/C,oDAA8C;AAE9C,MAAa,MAAO,SAAQ,sBAAW;IAwDrC,IAAI,CACF,IAAY,EACZ,IAAqB,EACrB,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAA,WAAI,EAAA,WAAW,IAAI,OAAO,EAAE;YACnD,IAAI;YACJ,GAAG,OAAO;YACV,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,KAAK;SAC7B,CAAoE,CAAC;IACxE,CAAC;IAmDD,MAAM,CACJ,IAAY,EACZ,IAAuB,EACvB,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAA,WAAI,EAAA,WAAW,IAAI,SAAS,EAAE;YACrD,IAAI;YACJ,GAAG,OAAO;YACV,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,KAAK;SAC7B,CAAsE,CAAC;IAC1E,CAAC;CACF;AAhID,wBAgIC"}
+{"version":3,"file":"agents.js","sourceRoot":"","sources":["../src/resources/agents.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,kDAA+C;AAG/C,sDAA4E;AAG5E,oDAA8C;AAE9C,MAAa,MAAO,SAAQ,sBAAW;IACrC;;;;;;;OAOG;IACH,QAAQ,CAAC,IAAY,EAAE,OAAwB;QAC7C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,WAAW,IAAI,EAAE,EAAE,OAAO,CAAC,CAAC;IAC1D,CAAC;IAED;;;;;;;;;;OAUG;IACH,IAAI,CACF,QAA4C,EAAE,EAC9C,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,SAAS,EAAE,CAAA,mBAAa,CAAA,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAClF,CAAC;IA0CD,IAAI,CACF,IAAY,EACZ,IAAqB,EACrB,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAA,WAAI,EAAA,WAAW,IAAI,OAAO,EAAE;YACnD,IAAI;YACJ,GAAG,OAAO;YACV,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,KAAK;SAC7B,CAAoE,CAAC;IACxE,CAAC;IA2CD,OAAO,CACL,IAAY,EACZ,OAAuC,EAAE,EACzC,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAA,WAAI,EAAA,WAAW,IAAI,UAAU,EAAE;YACtD,IAAI;YACJ,GAAG,OAAO;YACV,MAAM,EAAE,IAAI,EAAE,MAAM,IAAI,KAAK;SAC9B,CAAuE,CAAC;IAC3E,CAAC;CACF;AAvID,wBAuIC"}