@reminix/sdk 0.11.0 → 0.13.0

package/src/resources/execution-logs.ts

@@ -22,7 +22,7 @@ export class ExecutionLogs extends APIResource {
    *
    * **Filters:**
    *
-   * - `type`: Filter by execution type (agent_execute, tool_execute)
+   * - `type`: Filter by execution type (agent_invoke, agent_chat, tool_call)
    * - `source`: Filter by request source (api, cli, dashboard, widget, sdk)
    * - `name`: Filter by agent or tool name
    * - `status`: Filter by result status (success, error, timeout)
@@ -81,7 +81,7 @@ export interface ExecutionLog {
   /**
    * Type of execution
    */
-  type: 'agent_execute' | 'agent_chat' | 'tool_execute';
+  type: 'agent_invoke' | 'agent_chat' | 'tool_call';
 
   /**
    * Input parameters
@@ -113,7 +113,7 @@ export interface ExecutionLogListParams extends CursorParams {
   /**
    * Filter by execution type
    */
-  type?: 'agent_execute' | 'agent_chat' | 'tool_execute';
+  type?: 'agent_invoke' | 'agent_chat' | 'tool_call';
 }
 
 export declare namespace ExecutionLogs {

package/src/resources/index.ts

@@ -4,17 +4,19 @@ export {
   Agents,
   type Agent,
   type AgentConfig,
+  type AgentKnowledgeBaseConfig,
+  type AgentMemoryConfig,
   type ChatMessage,
   type StreamChunk,
   type AgentChatResponse,
-  type AgentExecuteResponse,
+  type AgentInvokeResponse,
   type AgentListParams,
   type AgentChatParams,
   type AgentChatParamsNonStreaming,
   type AgentChatParamsStreaming,
-  type AgentExecuteParams,
-  type AgentExecuteParamsNonStreaming,
-  type AgentExecuteParamsStreaming,
+  type AgentInvokeParams,
+  type AgentInvokeParamsNonStreaming,
+  type AgentInvokeParamsStreaming,
   type AgentsCursor,
 } from './agents';
 export { ClientTokens, type ClientTokenCreateResponse, type ClientTokenCreateParams } from './client-tokens';
@@ -31,12 +33,20 @@ export {
   type ExecutionLogListParams,
   type ExecutionLogsCursor,
 } from './execution-logs';
+export { Knowledge, type KnowledgeSearchResponse, type KnowledgeSearchParams } from './knowledge/knowledge';
+export {
+  MemoryResource,
+  type Memory,
+  type MemoryListResponse,
+  type MemoryDeleteAllResponse,
+  type MemoryStoreParams,
+} from './memory';
 export { Projects, type Project } from './projects';
 export {
   Tools,
   type Tool,
-  type ToolExecuteResponse,
+  type ToolCallResponse,
   type ToolListParams,
-  type ToolExecuteParams,
+  type ToolCallParams,
   type ToolsCursor,
 } from './tools';

package/src/resources/knowledge/collections/collections.ts

@@ -0,0 +1,167 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../../core/resource';
+import * as DocumentsAPI from './documents';
+import {
+  DocumentDeleteParams,
+  DocumentListParams,
+  DocumentProcessParams,
+  DocumentProcessResponse,
+  DocumentRetrieveParams,
+  DocumentUploadParams,
+  DocumentUploadResponse,
+  Documents,
+  KnowledgeDocument,
+  KnowledgeDocumentsCursor,
+} from './documents';
+import { APIPromise } from '../../../core/api-promise';
+import { Cursor, type CursorParams, PagePromise } from '../../../core/pagination';
+import { buildHeaders } from '../../../internal/headers';
+import { RequestOptions } from '../../../internal/request-options';
+import { path } from '../../../internal/utils/path';
+
+export class Collections extends APIResource {
+  documents: DocumentsAPI.Documents = new DocumentsAPI.Documents(this._client);
+
+  /**
+   * Create a new knowledge collection for storing documents.
+   */
+  create(body: CollectionCreateParams, options?: RequestOptions): APIPromise<KnowledgeCollection> {
+    return this._client.post('/knowledge/collections', { body, ...options });
+  }
+
+  /**
+   * Get details of a knowledge collection including document stats.
+   */
+  retrieve(id: string, options?: RequestOptions): APIPromise<KnowledgeCollection> {
+    return this._client.get(path`/knowledge/collections/${id}`, options);
+  }
+
+  /**
+   * Update a knowledge collection name or description.
+   */
+  update(
+    id: string,
+    body: CollectionUpdateParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<KnowledgeCollection> {
+    return this._client.patch(path`/knowledge/collections/${id}`, { body, ...options });
+  }
+
+  /**
+   * List all knowledge collections for the project.
+   */
+  list(
+    query: CollectionListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): PagePromise<KnowledgeCollectionsCursor, KnowledgeCollection> {
+    return this._client.getAPIList('/knowledge/collections', Cursor<KnowledgeCollection>, {
+      query,
+      ...options,
+    });
+  }
+
+  /**
+   * Delete a knowledge collection and all its documents.
+   */
+  delete(id: string, options?: RequestOptions): APIPromise<void> {
+    return this._client.delete(path`/knowledge/collections/${id}`, {
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+}
+
+export type KnowledgeCollectionsCursor = Cursor<KnowledgeCollection>;
+
+export interface KnowledgeCollection {
+  /**
+   * Unique collection ID
+   */
+  id: string;
+
+  /**
+   * When the collection was created
+   */
+  createdAt: string;
+
+  /**
+   * Collection description
+   */
+  description: string | null;
+
+  /**
+   * Embedding model used
+   */
+  embeddingModel: string;
+
+  /**
+   * Collection name
+   */
+  name: string;
+
+  /**
+   * Project ID
+   */
+  projectId: string;
+
+  /**
+   * When the collection was last updated
+   */
+  updatedAt: string;
+
+  /**
+   * Total number of documents
+   */
+  documentCount?: number;
+
+  /**
+   * Number of processed documents
+   */
+  readyDocumentCount?: number;
+}
+
+export interface CollectionCreateParams {
+  /**
+   * Collection name
+   */
+  name: string;
+
+  /**
+   * Collection description
+   */
+  description?: string;
+}
+
+export interface CollectionUpdateParams {
+  description?: string;
+
+  name?: string;
+}
+
+export interface CollectionListParams extends CursorParams {}
+
+Collections.Documents = Documents;
+
+export declare namespace Collections {
+  export {
+    type KnowledgeCollection as KnowledgeCollection,
+    type KnowledgeCollectionsCursor as KnowledgeCollectionsCursor,
+    type CollectionCreateParams as CollectionCreateParams,
+    type CollectionUpdateParams as CollectionUpdateParams,
+    type CollectionListParams as CollectionListParams,
+  };
+
+  export {
+    Documents as Documents,
+    type KnowledgeDocument as KnowledgeDocument,
+    type DocumentProcessResponse as DocumentProcessResponse,
+    type DocumentUploadResponse as DocumentUploadResponse,
+    type KnowledgeDocumentsCursor as KnowledgeDocumentsCursor,
+    type DocumentRetrieveParams as DocumentRetrieveParams,
+    type DocumentListParams as DocumentListParams,
+    type DocumentDeleteParams as DocumentDeleteParams,
+    type DocumentProcessParams as DocumentProcessParams,
+    type DocumentUploadParams as DocumentUploadParams,
+  };
+}

package/src/resources/knowledge/collections/documents.ts

@@ -0,0 +1,200 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../../core/resource';
+import { APIPromise } from '../../../core/api-promise';
+import { Cursor, type CursorParams, PagePromise } from '../../../core/pagination';
+import { buildHeaders } from '../../../internal/headers';
+import { RequestOptions } from '../../../internal/request-options';
+import { path } from '../../../internal/utils/path';
+
+export class Documents extends APIResource {
+  /**
+   * Get details of a document.
+   */
+  retrieve(
+    documentID: string,
+    params: DocumentRetrieveParams,
+    options?: RequestOptions,
+  ): APIPromise<KnowledgeDocument> {
+    const { collectionId } = params;
+    return this._client.get(path`/knowledge/collections/${collectionId}/documents/${documentID}`, options);
+  }
+
+  /**
+   * List all documents in a knowledge collection.
+   */
+  list(
+    id: string,
+    query: DocumentListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): PagePromise<KnowledgeDocumentsCursor, KnowledgeDocument> {
+    return this._client.getAPIList(path`/knowledge/collections/${id}/documents`, Cursor<KnowledgeDocument>, {
+      query,
+      ...options,
+    });
+  }
+
+  /**
+   * Delete a document and its associated data.
+   */
+  delete(documentID: string, params: DocumentDeleteParams, options?: RequestOptions): APIPromise<void> {
+    const { collectionId } = params;
+    return this._client.delete(path`/knowledge/collections/${collectionId}/documents/${documentID}`, {
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+
+  /**
+   * Trigger processing for a document after upload.
+   *
+   * This extracts text from the document, splits it into chunks, generates
+   * embeddings, and stores them for search.
+   *
+   * The document status will transition: pending → processing → ready (or failed).
+   */
+  process(
+    documentID: string,
+    params: DocumentProcessParams,
+    options?: RequestOptions,
+  ): APIPromise<DocumentProcessResponse> {
+    const { collectionId, ...body } = params;
+    return this._client.post(path`/knowledge/collections/${collectionId}/documents/${documentID}/process`, {
+      body,
+      ...options,
+    });
+  }
+
+  /**
+   * Create a document record and get a presigned URL for upload.
+   *
+   * After receiving the response, upload the file to the presigned URL using a PUT
+   * request. The document will be processed automatically after upload.
+   */
+  upload(
+    id: string,
+    body: DocumentUploadParams,
+    options?: RequestOptions,
+  ): APIPromise<DocumentUploadResponse> {
+    return this._client.post(path`/knowledge/collections/${id}/documents`, { body, ...options });
+  }
+}
+
+export type KnowledgeDocumentsCursor = Cursor<KnowledgeDocument>;
+
+export interface KnowledgeDocument {
+  /**
+   * Unique document ID
+   */
+  id: string;
+
+  /**
+   * Collection ID
+   */
+  collectionId: string;
+
+  /**
+   * When the document was created
+   */
+  createdAt: string;
+
+  /**
+   * MIME type
+   */
+  mimeType: string;
+
+  /**
+   * Document name
+   */
+  name: string;
+
+  /**
+   * S3 URL of the document
+   */
+  sourceUrl: string;
+
+  /**
+   * Processing status
+   */
+  status: 'pending' | 'processing' | 'ready' | 'failed';
+
+  /**
+   * When the document was last updated
+   */
+  updatedAt: string;
+
+  /**
+   * Document metadata
+   */
+  metadata?: unknown;
+}
+
+export interface DocumentProcessResponse {
+  document: KnowledgeDocument;
+
+  message: string;
+}
+
+export interface DocumentUploadResponse {
+  document: KnowledgeDocument;
+
+  /**
+   * Presigned URL for uploading the file
+   */
+  uploadUrl: string;
+}
+
+export interface DocumentRetrieveParams {
+  collectionId: string;
+}
+
+export interface DocumentListParams extends CursorParams {
+  status?: 'pending' | 'processing' | 'ready' | 'failed';
+}
+
+export interface DocumentDeleteParams {
+  collectionId: string;
+}
+
+export interface DocumentProcessParams {
+  /**
+   * Path param
+   */
+  collectionId: string;
+
+  /**
+   * Body param: Use Unstructured.io for extraction if available
+   */
+  preferUnstructured?: boolean;
+}
+
+export interface DocumentUploadParams {
+  /**
+   * MIME type of the document
+   */
+  mimeType: string;
+
+  /**
+   * Document name (filename)
+   */
+  name: string;
+
+  /**
+   * File size in bytes
+   */
+  size?: number;
+}
+
+export declare namespace Documents {
+  export {
+    type KnowledgeDocument as KnowledgeDocument,
+    type DocumentProcessResponse as DocumentProcessResponse,
+    type DocumentUploadResponse as DocumentUploadResponse,
+    type KnowledgeDocumentsCursor as KnowledgeDocumentsCursor,
+    type DocumentRetrieveParams as DocumentRetrieveParams,
+    type DocumentListParams as DocumentListParams,
+    type DocumentDeleteParams as DocumentDeleteParams,
+    type DocumentProcessParams as DocumentProcessParams,
+    type DocumentUploadParams as DocumentUploadParams,
+  };
+}

package/src/resources/knowledge/collections/index.ts

@@ -0,0 +1,22 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export {
+  Collections,
+  type KnowledgeCollection,
+  type CollectionCreateParams,
+  type CollectionUpdateParams,
+  type CollectionListParams,
+  type KnowledgeCollectionsCursor,
+} from './collections';
+export {
+  Documents,
+  type KnowledgeDocument,
+  type DocumentProcessResponse,
+  type DocumentUploadResponse,
+  type DocumentRetrieveParams,
+  type DocumentListParams,
+  type DocumentDeleteParams,
+  type DocumentProcessParams,
+  type DocumentUploadParams,
+  type KnowledgeDocumentsCursor,
+} from './documents';

package/src/resources/knowledge/collections.ts

@@ -0,0 +1,3 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export * from './collections/index';

package/src/resources/knowledge/index.ts

@@ -0,0 +1,11 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export {
+  Collections,
+  type KnowledgeCollection,
+  type CollectionCreateParams,
+  type CollectionUpdateParams,
+  type CollectionListParams,
+  type KnowledgeCollectionsCursor,
+} from './collections/index';
+export { Knowledge, type KnowledgeSearchResponse, type KnowledgeSearchParams } from './knowledge';

package/src/resources/knowledge/knowledge.ts

@@ -0,0 +1,101 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../core/resource';
+import * as CollectionsAPI from './collections/collections';
+import {
+  CollectionCreateParams,
+  CollectionListParams,
+  CollectionUpdateParams,
+  Collections,
+  KnowledgeCollection,
+  KnowledgeCollectionsCursor,
+} from './collections/collections';
+import { APIPromise } from '../../core/api-promise';
+import { RequestOptions } from '../../internal/request-options';
+
+export class Knowledge extends APIResource {
+  collections: CollectionsAPI.Collections = new CollectionsAPI.Collections(this._client);
+
+  /**
+   * Search across one or more knowledge collections using semantic similarity.
+   *
+   * The search uses vector embeddings to find the most relevant content. Results are
+   * ordered by relevance score (0-1, higher is more similar).
+   */
+  search(body: KnowledgeSearchParams, options?: RequestOptions): APIPromise<KnowledgeSearchResponse> {
+    return this._client.post('/knowledge/search', { body, ...options });
+  }
+}
+
+export interface KnowledgeSearchResponse {
+  chunks: Array<KnowledgeSearchResponse.Chunk>;
+
+  /**
+   * Number of results found
+   */
+  count: number;
+}
+
+export namespace KnowledgeSearchResponse {
+  export interface Chunk {
+    /**
+     * Position in document
+     */
+    chunkIndex: number;
+
+    /**
+     * Chunk text content
+     */
+    content: string;
+
+    /**
+     * Source document ID
+     */
+    documentId: string;
+
+    /**
+     * Similarity score (0-1)
+     */
+    score: number;
+  }
+}
+
+export interface KnowledgeSearchParams {
+  /**
+   * Collection IDs to search
+   */
+  collectionIds: Array<string>;
+
+  /**
+   * Natural language search query
+   */
+  query: string;
+
+  /**
+   * Maximum number of results
+   */
+  limit?: number;
+
+  /**
+   * Minimum similarity score (0-1)
+   */
+  threshold?: number;
+}
+
+Knowledge.Collections = Collections;
+
+export declare namespace Knowledge {
+  export {
+    type KnowledgeSearchResponse as KnowledgeSearchResponse,
+    type KnowledgeSearchParams as KnowledgeSearchParams,
+  };
+
+  export {
+    Collections as Collections,
+    type KnowledgeCollection as KnowledgeCollection,
+    type KnowledgeCollectionsCursor as KnowledgeCollectionsCursor,
+    type CollectionCreateParams as CollectionCreateParams,
+    type CollectionUpdateParams as CollectionUpdateParams,
+    type CollectionListParams as CollectionListParams,
+  };
+}

package/src/resources/knowledge.ts

@@ -0,0 +1,3 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export * from './knowledge/index';