@prisme.ai/sdk 1.0.2 → 2.0.1

package/dist/index.d.ts

@@ -1,7 +1,1129 @@
-export * from './lib/api';
-export * from './lib/ApiError';
-export * from './lib/events';
-export * from './lib/fetcher';
-export * from './lib/HTTPError';
-export * from './lib/types';
-export { default } from './lib/api';
+interface HttpClientOptions {
+    baseURL: string;
+    headers: Record<string, string>;
+    timeout?: number;
+    maxRetries?: number;
+}
+interface RequestOptions {
+    method: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+    path: string;
+    query?: Record<string, unknown>;
+    body?: unknown;
+    headers?: Record<string, string>;
+    timeout?: number;
+    signal?: AbortSignal;
+    raw?: boolean;
+}
+declare class HttpClient {
+    readonly baseURL: string;
+    private readonly defaultHeaders;
+    private readonly timeout;
+    private readonly maxRetries;
+    constructor(options: HttpClientOptions);
+    request<T>(options: RequestOptions): Promise<T>;
+    requestRaw(options: RequestOptions): Promise<Response>;
+    get<T>(path: string, query?: Record<string, unknown>, options?: Partial<RequestOptions>): Promise<T>;
+    post<T>(path: string, body?: unknown, options?: Partial<RequestOptions>): Promise<T>;
+    put<T>(path: string, body?: unknown, options?: Partial<RequestOptions>): Promise<T>;
+    patch<T>(path: string, body?: unknown, options?: Partial<RequestOptions>): Promise<T>;
+    delete<T>(path: string, query?: Record<string, unknown>, options?: Partial<RequestOptions>): Promise<T>;
+    private buildURL;
+    private getRetryDelay;
+    private safeParseBody;
+}
+
+interface PageResponse<T> {
+    data: T[];
+    total?: number;
+    page?: number;
+    limit?: number;
+    hasMore?: boolean;
+}
+interface PaginationParams {
+    page?: number;
+    limit?: number;
+}
+/**
+ * Async-iterable page iterator.
+ * Supports: for await...of (item-by-item), .getPage(), .toArray()
+ */
+declare class PageIterator<T> implements AsyncIterable<T> {
+    private httpClient;
+    private options;
+    private pageSize;
+    private currentPage;
+    private extractData;
+    constructor(httpClient: HttpClient, options: RequestOptions, extractData: (body: unknown) => PageResponse<T>, pageSize?: number, startPage?: number);
+    /**
+     * Fetch a specific page.
+     */
+    getPage(page?: number): Promise<PageResponse<T>>;
+    /**
+     * Collect all items across all pages into a single array.
+     */
+    toArray(): Promise<T[]>;
+    [Symbol.asyncIterator](): AsyncIterator<T>;
+}
+
+type QueryParams = Record<string, any>;
+/**
+ * Abstract base class for all API resource classes.
+ * Provides common HTTP methods and pagination helpers.
+ */
+declare abstract class BaseResource {
+    protected readonly httpClient: HttpClient;
+    constructor(httpClient: HttpClient);
+    protected _get<T>(path: string, query?: QueryParams): Promise<T>;
+    protected _post<T>(path: string, body?: unknown, options?: Partial<RequestOptions>): Promise<T>;
+    protected _put<T>(path: string, body?: unknown): Promise<T>;
+    protected _patch<T>(path: string, body?: unknown): Promise<T>;
+    protected _del<T>(path: string, query?: QueryParams): Promise<T>;
+    protected _paginate<T>(path: string, query?: QueryParams, pagination?: PaginationParams, extractor?: (body: unknown) => PageResponse<T>): PageIterator<T>;
+    /**
+     * Build a path with workspace ID prefix.
+     */
+    protected buildPath(workspaceId: string, ...segments: string[]): string;
+}
+
+/** ISO 8601 timestamp string */
+type Timestamp = string;
+/** Localized text — either a plain string or { en: "...", fr: "...", ... } */
+type LocalizedText = string | Record<string, string>;
+
+interface Agent {
+    id: string;
+    slug: string;
+    name: LocalizedText;
+    description?: LocalizedText;
+    photo?: string;
+    status?: 'draft' | 'published';
+    labels?: string[];
+    model?: string;
+    systemPrompt?: string;
+    temperature?: number;
+    maxTokens?: number;
+    subAgents?: SubAgentConfig[];
+    guardrails?: GuardrailConfig[];
+    toolPermissions?: ToolPermissions;
+    tools?: AgentTool[];
+    discovery?: AgentDiscovery;
+    createdAt?: Timestamp;
+    updatedAt?: Timestamp;
+    createdBy?: string;
+    updatedBy?: string;
+    [key: string]: unknown;
+}
+interface AgentCreateParams {
+    name: LocalizedText;
+    description?: LocalizedText;
+    photo?: string;
+    labels?: string[];
+    model?: string;
+    systemPrompt?: string;
+    temperature?: number;
+    maxTokens?: number;
+    subAgents?: SubAgentConfig[];
+    guardrails?: GuardrailConfig[];
+    toolPermissions?: ToolPermissions;
+    tools?: AgentTool[];
+    discovery?: AgentDiscovery;
+    [key: string]: unknown;
+}
+interface AgentUpdateParams {
+    name?: LocalizedText;
+    description?: LocalizedText;
+    photo?: string;
+    labels?: string[];
+    model?: string;
+    systemPrompt?: string;
+    temperature?: number;
+    maxTokens?: number;
+    subAgents?: SubAgentConfig[];
+    guardrails?: GuardrailConfig[];
+    toolPermissions?: ToolPermissions;
+    tools?: AgentTool[];
+    discovery?: AgentDiscovery;
+    [key: string]: unknown;
+}
+interface AgentListParams {
+    page?: number;
+    limit?: number;
+    labels?: string;
+    search?: string;
+}
+interface SubAgentConfig {
+    agentId: string;
+    name?: string;
+    description?: string;
+}
+type GuardrailType = 'injection-detect' | 'toxicity-check' | 'pii-detect' | 'hallucination-check' | 'topic-guard' | 'action-approval';
+interface GuardrailConfig {
+    id: string;
+    type: 'input' | 'output' | 'action';
+    guardrailType: GuardrailType;
+    config?: Record<string, unknown>;
+    enabled?: boolean;
+}
+type ToolPolicy = 'auto' | 'always_ask' | 'ask_external' | 'ask_first' | 'deny';
+interface ToolPermissions {
+    default: ToolPolicy;
+    tools?: ToolRule[];
+}
+interface ToolRule {
+    tool: string;
+    policy: ToolPolicy;
+    conditions?: Record<string, unknown>;
+    approvers?: Approver[];
+}
+interface Approver {
+    type: 'user' | 'group' | 'owner';
+    id?: string;
+}
+interface AgentTool {
+    id?: string;
+    name: string;
+    description?: string;
+    type?: string;
+    config?: Record<string, unknown>;
+}
+interface AgentDiscovery {
+    enabled?: boolean;
+    categories?: string[];
+    featured?: boolean;
+}
+
+/**
+ * SSE (Server-Sent Events) stream parser.
+ * Implements AsyncIterable<T> for `for await...of` usage.
+ */
+declare class SSEStream<T> implements AsyncIterable<T> {
+    private response;
+    private controller;
+    private _done;
+    constructor(response: Response, controller: AbortController);
+    get done(): boolean;
+    abort(): void;
+    [Symbol.asyncIterator](): AsyncIterator<T>;
+}
+
+interface MessageSendParams {
+    text?: string;
+    parts?: MessagePart[];
+    conversationId?: string;
+    context?: Record<string, unknown>;
+    [key: string]: unknown;
+}
+interface MessagePart {
+    type: 'text' | 'image' | 'file' | 'audio';
+    text?: string;
+    url?: string;
+    mimeType?: string;
+    data?: string;
+}
+interface MessageResponse {
+    output?: string;
+    conversationId?: string;
+    taskId?: string;
+    [key: string]: unknown;
+}
+/**
+ * SSE stream event types emitted during message streaming.
+ */
+type StreamEvent = StreamEventDelta | StreamEventTaskStatus | StreamEventTaskCompleted | StreamEventToolCall | StreamEventToolResult | StreamEventError;
+interface StreamEventDelta {
+    type: 'delta';
+    text?: string;
+    [key: string]: unknown;
+}
+interface StreamEventTaskStatus {
+    type: 'task.status';
+    taskId: string;
+    status: string;
+    [key: string]: unknown;
+}
+interface StreamEventTaskCompleted {
+    type: 'task.completed';
+    taskId: string;
+    output?: string;
+    conversationId?: string;
+    [key: string]: unknown;
+}
+interface StreamEventToolCall {
+    type: 'tool.call';
+    toolName: string;
+    toolId?: string;
+    arguments?: Record<string, unknown>;
+    [key: string]: unknown;
+}
+interface StreamEventToolResult {
+    type: 'tool.result';
+    toolId?: string;
+    result?: unknown;
+    [key: string]: unknown;
+}
+interface StreamEventError {
+    type: 'error';
+    error: string;
+    code?: string;
+    [key: string]: unknown;
+}
+
+declare class Messages extends BaseResource {
+    private readonly workspaceId;
+    constructor(httpClient: HttpClient, workspaceId: string);
+    private path;
+    /** Send a message to an agent and get a complete response. */
+    send(agentId: string, params: MessageSendParams): Promise<MessageResponse>;
+    /** Send a message and receive the response as an SSE stream. */
+    stream(agentId: string, params: MessageSendParams): Promise<SSEStream<StreamEvent>>;
+}
+
+interface Conversation {
+    id: string;
+    agentId?: string;
+    name?: string;
+    userId?: string;
+    metadata?: Record<string, unknown>;
+    createdAt?: Timestamp;
+    updatedAt?: Timestamp;
+    [key: string]: unknown;
+}
+interface ConversationCreateParams {
+    agentId?: string;
+    name?: string;
+    metadata?: Record<string, unknown>;
+}
+interface ConversationUpdateParams {
+    name?: string;
+    metadata?: Record<string, unknown>;
+}
+interface ConversationListParams {
+    page?: number;
+    limit?: number;
+    agentId?: string;
+}
+interface ConversationMessage {
+    id: string;
+    role: 'user' | 'assistant' | 'system';
+    content: string;
+    parts?: Array<{
+        type: string;
+        text?: string;
+        url?: string;
+    }>;
+    createdAt?: Timestamp;
+    [key: string]: unknown;
+}
+interface ConversationShareParams {
+    public?: boolean;
+    users?: string[];
+    groups?: string[];
+}
+
+declare class Conversations extends BaseResource {
+    private readonly workspaceId;
+    constructor(httpClient: HttpClient, workspaceId: string);
+    private path;
+    /** List conversations. */
+    list(params?: ConversationListParams): PageIterator<Conversation>;
+    /** Create a new conversation. */
+    create(params?: ConversationCreateParams): Promise<Conversation>;
+    /** Get a conversation by ID. */
+    get(conversationId: string): Promise<Conversation>;
+    /** Update a conversation. */
+    update(conversationId: string, params: ConversationUpdateParams): Promise<Conversation>;
+    /** Delete a conversation. */
+    delete(conversationId: string): Promise<void>;
+    /** List messages in a conversation. */
+    messages(conversationId: string, params?: {
+        page?: number;
+        limit?: number;
+    }): PageIterator<ConversationMessage>;
+    /** Share a conversation. */
+    share(conversationId: string, params: ConversationShareParams): Promise<void>;
+}
+
+interface Tool {
+    id?: string;
+    name: string;
+    description?: string;
+    type?: string;
+    schema?: Record<string, unknown>;
+    config?: Record<string, unknown>;
+    [key: string]: unknown;
+}
+interface ToolCreateParams {
+    name: string;
+    description?: string;
+    type?: string;
+    schema?: Record<string, unknown>;
+    config?: Record<string, unknown>;
+}
+interface ToolListParams {
+    page?: number;
+    limit?: number;
+}
+
+declare class Tools extends BaseResource {
+    private readonly workspaceId;
+    constructor(httpClient: HttpClient, workspaceId: string);
+    private path;
+    /** List tools available for agents. */
+    list(params?: ToolListParams): PageIterator<Tool>;
+    /** Create a new tool. */
+    create(params: ToolCreateParams): Promise<Tool>;
+    /** Get a tool by ID. */
+    get(toolId: string): Promise<Tool>;
+}
+
+interface AccessEntry {
+    id: string;
+    userId?: string;
+    email?: string;
+    role: string;
+    grantedAt?: Timestamp;
+    grantedBy?: string;
+    [key: string]: unknown;
+}
+interface AccessGrantParams {
+    email?: string;
+    userId?: string;
+    role: string;
+}
+interface AccessRequest {
+    id: string;
+    userId: string;
+    email?: string;
+    status: 'pending' | 'approved' | 'rejected';
+    createdAt?: Timestamp;
+    [key: string]: unknown;
+}
+interface AccessRequestHandleParams {
+    action: 'approve' | 'reject';
+}
+interface AccessListParams {
+    page?: number;
+    limit?: number;
+}
+
+declare class Access extends BaseResource {
+    private readonly workspaceId;
+    constructor(httpClient: HttpClient, workspaceId: string);
+    private path;
+    /** List access entries for an agent. */
+    list(agentId: string, params?: AccessListParams): PageIterator<AccessEntry>;
+    /** Grant access to an agent. */
+    grant(agentId: string, params: AccessGrantParams): Promise<AccessEntry>;
+    /** Revoke access to an agent. */
+    revoke(agentId: string, accessId: string): Promise<void>;
+    /** Request access to an agent. */
+    requestAccess(agentId: string): Promise<AccessRequest>;
+    /** List access requests for an agent. */
+    listRequests(agentId: string, params?: AccessListParams): PageIterator<AccessRequest>;
+    /** Handle an access request (approve/reject). */
+    handleRequest(agentId: string, requestId: string, params: AccessRequestHandleParams): Promise<AccessRequest>;
+}
+
+interface AnalyticsParams {
+    period?: 'day' | 'week' | 'month' | 'year';
+    granularity?: 'hour' | 'day' | 'week' | 'month';
+    startDate?: string;
+    endDate?: string;
+}
+interface AnalyticsResponse {
+    conversations?: number;
+    messages?: number;
+    uniqueUsers?: number;
+    avgResponseTime?: number;
+    timeSeries?: AnalyticsDataPoint[];
+    [key: string]: unknown;
+}
+interface AnalyticsDataPoint {
+    timestamp: string;
+    conversations?: number;
+    messages?: number;
+    uniqueUsers?: number;
+    [key: string]: unknown;
+}
+
+declare class Analytics extends BaseResource {
+    private readonly workspaceId;
+    constructor(httpClient: HttpClient, workspaceId: string);
+    private path;
+    /** Get analytics for an agent. */
+    get(agentId: string, params?: AnalyticsParams): Promise<AnalyticsResponse>;
+}
+
+interface Evaluation {
+    id: string;
+    agentId: string;
+    name?: string;
+    status?: string;
+    results?: Record<string, unknown>;
+    createdAt?: Timestamp;
+    [key: string]: unknown;
+}
+interface EvaluationCreateParams {
+    name?: string;
+    dataset?: Array<{
+        input: string;
+        expectedOutput?: string;
+    }>;
+    config?: Record<string, unknown>;
+}
+interface EvaluationListParams {
+    page?: number;
+    limit?: number;
+}
+declare class Evaluations extends BaseResource {
+    private readonly workspaceId;
+    constructor(httpClient: HttpClient, workspaceId: string);
+    private path;
+    /** List evaluations for an agent. */
+    list(agentId: string, params?: EvaluationListParams): PageIterator<Evaluation>;
+    /** Create a new evaluation. */
+    create(agentId: string, params: EvaluationCreateParams): Promise<Evaluation>;
+}
+
+interface A2ASendParams {
+    message: string;
+    taskId?: string;
+    context?: Record<string, unknown>;
+    [key: string]: unknown;
+}
+interface A2AResponse {
+    taskId: string;
+    output?: string;
+    status?: string;
+    [key: string]: unknown;
+}
+interface A2ACard {
+    name: string;
+    description?: string;
+    url?: string;
+    capabilities?: string[];
+    [key: string]: unknown;
+}
+interface A2AExtendedCard extends A2ACard {
+    tools?: Array<{
+        name: string;
+        description?: string;
+    }>;
+    subAgents?: Array<{
+        name: string;
+        agentId: string;
+    }>;
+    [key: string]: unknown;
+}
+type A2AStreamEvent = {
+    type: string;
+    [key: string]: unknown;
+};
+
+declare class A2A extends BaseResource {
+    private readonly workspaceId;
+    constructor(httpClient: HttpClient, workspaceId: string);
+    private path;
+    /** Send a message via A2A protocol. */
+    send(agentId: string, params: A2ASendParams): Promise<A2AResponse>;
+    /** Send a message and subscribe to SSE events (A2A protocol). */
+    sendSubscribe(agentId: string, params: A2ASendParams): Promise<SSEStream<A2AStreamEvent>>;
+    /** Get the A2A agent card. */
+    getCard(agentId: string): Promise<A2ACard>;
+    /** Get the extended A2A agent card with tools and sub-agents. */
+    getExtendedCard(agentId: string): Promise<A2AExtendedCard>;
+}
+
+declare class Agents extends BaseResource {
+    readonly messages: Messages;
+    readonly conversations: Conversations;
+    readonly tools: Tools;
+    readonly access: Access;
+    readonly analytics: Analytics;
+    readonly evaluations: Evaluations;
+    readonly a2a: A2A;
+    private readonly workspaceId;
+    constructor(httpClient: HttpClient, workspaceId: string);
+    private path;
+    /** List all agents. */
+    list(params?: AgentListParams): PageIterator<Agent>;
+    /** Create a new agent. */
+    create(params: AgentCreateParams): Promise<Agent>;
+    /** Get an agent by ID. */
+    get(agentId: string): Promise<Agent>;
+    /** Update an agent. */
+    update(agentId: string, params: AgentUpdateParams): Promise<Agent>;
+    /** Delete an agent. */
+    delete(agentId: string): Promise<void>;
+    /** Publish an agent (promote draft to published). */
+    publish(agentId: string): Promise<Agent>;
+    /** Discard the current draft. */
+    discardDraft(agentId: string): Promise<Agent>;
+    /** Update agent discovery settings. */
+    discovery(agentId: string, params: {
+        enabled?: boolean;
+        categories?: string[];
+        featured?: boolean;
+    }): Promise<Agent>;
+    /** Export an agent configuration. */
+    export(agentId: string): Promise<Record<string, unknown>>;
+    /** Import an agent configuration. */
+    import(config: Record<string, unknown>): Promise<Agent>;
+}
+
+interface Task {
+    id: string;
+    agentId?: string;
+    conversationId?: string;
+    status: 'pending' | 'running' | 'completed' | 'failed' | 'cancelled';
+    output?: string;
+    error?: string;
+    createdAt?: Timestamp;
+    updatedAt?: Timestamp;
+    [key: string]: unknown;
+}
+interface TaskListParams {
+    page?: number;
+    limit?: number;
+    agentId?: string;
+    status?: string;
+}
+
+declare class Tasks extends BaseResource {
+    private readonly workspaceId;
+    constructor(httpClient: HttpClient, workspaceId: string);
+    private path;
+    /** List tasks. */
+    list(params?: TaskListParams): PageIterator<Task>;
+    /** Get a task by ID. */
+    get(taskId: string): Promise<Task>;
+    /** Cancel a running task. */
+    cancel(taskId: string): Promise<Task>;
+}
+
+interface Artifact {
+    id: string;
+    name?: string;
+    type?: string;
+    content?: unknown;
+    conversationId?: string;
+    taskId?: string;
+    createdAt?: Timestamp;
+    updatedAt?: Timestamp;
+    [key: string]: unknown;
+}
+interface ArtifactUpdateParams {
+    name?: string;
+    content?: unknown;
+    [key: string]: unknown;
+}
+interface ArtifactListParams {
+    page?: number;
+    limit?: number;
+    conversationId?: string;
+}
+interface ArtifactShareParams {
+    public?: boolean;
+    users?: string[];
+}
+
+declare class Artifacts extends BaseResource {
+    private readonly workspaceId;
+    constructor(httpClient: HttpClient, workspaceId: string);
+    private path;
+    list(params?: ArtifactListParams): PageIterator<Artifact>;
+    get(artifactId: string): Promise<Artifact>;
+    update(artifactId: string, params: ArtifactUpdateParams): Promise<Artifact>;
+    delete(artifactId: string): Promise<void>;
+    share(artifactId: string, params: ArtifactShareParams): Promise<void>;
+}
+
+interface Share {
+    id: string;
+    type?: string;
+    resourceId?: string;
+    userId?: string;
+    public?: boolean;
+    createdAt?: Timestamp;
+    [key: string]: unknown;
+}
+interface ShareListParams {
+    page?: number;
+    limit?: number;
+    type?: string;
+}
+
+declare class Shares extends BaseResource {
+    private readonly workspaceId;
+    constructor(httpClient: HttpClient, workspaceId: string);
+    private path;
+    list(params?: ShareListParams): PageIterator<Share>;
+    get(shareId: string): Promise<Share>;
+}
+
+interface RatingCreateParams {
+    agentId: string;
+    conversationId?: string;
+    messageId?: string;
+    rating: number;
+    feedback?: string;
+}
+interface Rating {
+    id: string;
+    rating: number;
+    feedback?: string;
+    [key: string]: unknown;
+}
+declare class Ratings extends BaseResource {
+    private readonly workspaceId;
+    constructor(httpClient: HttpClient, workspaceId: string);
+    private path;
+    /** Submit a rating for an agent response. */
+    create(params: RatingCreateParams): Promise<Rating>;
+}
+
+interface ActivityEntry {
+    id: string;
+    type: string;
+    agentId?: string;
+    userId?: string;
+    description?: string;
+    createdAt?: Timestamp;
+    [key: string]: unknown;
+}
+interface ActivityListParams {
+    page?: number;
+    limit?: number;
+    agentId?: string;
+    type?: string;
+}
+declare class Activity extends BaseResource {
+    private readonly workspaceId;
+    constructor(httpClient: HttpClient, workspaceId: string);
+    private path;
+    /** List recent activity. */
+    list(params?: ActivityListParams): PageIterator<ActivityEntry>;
+}
+
+interface Profile {
+    id: string;
+    name?: string;
+    email?: string;
+    photo?: string;
+    [key: string]: unknown;
+}
+interface ProfileListParams {
+    page?: number;
+    limit?: number;
+    search?: string;
+}
+declare class Profiles extends BaseResource {
+    private readonly workspaceId;
+    constructor(httpClient: HttpClient, workspaceId: string);
+    private path;
+    /** List user profiles. */
+    list(params?: ProfileListParams): PageIterator<Profile>;
+}
+
+interface OrgAgentListParams {
+    page?: number;
+    limit?: number;
+    search?: string;
+}
+declare class Orgs extends BaseResource {
+    private readonly workspaceId;
+    constructor(httpClient: HttpClient, workspaceId: string);
+    private path;
+    /** List agents available in the organization. */
+    listAgents(params?: OrgAgentListParams): PageIterator<Agent>;
+}
+
+/**
+ * Supported input types for file uploads.
+ */
+type FileInput = Buffer | ArrayBuffer | Uint8Array | ReadableStream | Blob | string;
+interface FileUploadOptions {
+    filename?: string;
+    contentType?: string;
+}
+
+interface FileObject {
+    id: string;
+    name: string;
+    url?: string;
+    mimeType?: string;
+    size?: number;
+    metadata?: Record<string, unknown>;
+    createdAt?: Timestamp;
+    updatedAt?: Timestamp;
+    [key: string]: unknown;
+}
+interface FileUploadParams {
+    name?: string;
+    metadata?: Record<string, unknown>;
+}
+interface FileListParams {
+    page?: number;
+    limit?: number;
+    search?: string;
+}
+
+declare class Files extends BaseResource {
+    private readonly workspaceId;
+    constructor(httpClient: HttpClient, workspaceId: string);
+    private path;
+    /** List files. */
+    list(params?: FileListParams): PageIterator<FileObject>;
+    /** Upload a file. */
+    upload(file: FileInput, params?: FileUploadParams & FileUploadOptions): Promise<FileObject>;
+    /** Get file metadata. */
+    get(fileId: string): Promise<FileObject>;
+    /** Delete a file. */
+    delete(fileId: string): Promise<void>;
+    /** Download a file. Returns the raw Response for streaming. */
+    download(fileId: string): Promise<Response>;
+}
+
+interface VectorStore {
+    id: string;
+    name: string;
+    description?: string;
+    status?: string;
+    documentCount?: number;
+    config?: VectorStoreConfig;
+    createdAt?: Timestamp;
+    updatedAt?: Timestamp;
+    [key: string]: unknown;
+}
+interface VectorStoreConfig {
+    embeddingModel?: string;
+    chunkSize?: number;
+    chunkOverlap?: number;
+    [key: string]: unknown;
+}
+interface VectorStoreCreateParams {
+    name: string;
+    description?: string;
+    config?: VectorStoreConfig;
+}
+interface VectorStoreUpdateParams {
+    name?: string;
+    description?: string;
+    config?: VectorStoreConfig;
+}
+interface VectorStoreListParams {
+    page?: number;
+    limit?: number;
+}
+interface VectorStoreSearchParams {
+    query: string;
+    limit?: number;
+    filters?: Record<string, unknown>;
+    scoreThreshold?: number;
+}
+interface VectorStoreSearchResult {
+    id: string;
+    content: string;
+    score: number;
+    metadata?: Record<string, unknown>;
+    [key: string]: unknown;
+}
+interface VSFile {
+    id: string;
+    name: string;
+    vectorStoreId: string;
+    status?: 'pending' | 'processing' | 'completed' | 'failed';
+    chunkCount?: number;
+    createdAt?: Timestamp;
+    [key: string]: unknown;
+}
+interface VSFileAddParams {
+    fileId?: string;
+    url?: string;
+    content?: string;
+    name?: string;
+    metadata?: Record<string, unknown>;
+}
+interface VSFileListParams {
+    page?: number;
+    limit?: number;
+}
+interface VSFileChunk {
+    id: string;
+    content: string;
+    metadata?: Record<string, unknown>;
+    [key: string]: unknown;
+}
+interface VSAccessEntry {
+    id: string;
+    userId?: string;
+    email?: string;
+    role: string;
+    [key: string]: unknown;
+}
+interface VSAccessGrantParams {
+    email?: string;
+    userId?: string;
+    role: string;
+}
+interface VSAccessUpdateParams {
+    role: string;
+}
+
+declare class VSFiles extends BaseResource {
+    private readonly workspaceId;
+    constructor(httpClient: HttpClient, workspaceId: string);
+    private path;
+    /** List files in a vector store. */
+    list(vectorStoreId: string, params?: VSFileListParams): PageIterator<VSFile>;
+    /** Add a file to a vector store. */
+    add(vectorStoreId: string, params: VSFileAddParams): Promise<VSFile>;
+    /** Update a file in a vector store. */
+    update(vectorStoreId: string, fileId: string, params: Partial<VSFileAddParams>): Promise<VSFile>;
+    /** Remove a file from a vector store. */
+    delete(vectorStoreId: string, fileId: string): Promise<void>;
+    /** Get chunks for a file in a vector store. */
+    chunks(vectorStoreId: string, fileId: string): Promise<VSFileChunk[]>;
+    /** Reindex a specific file in a vector store. */
+    reindex(vectorStoreId: string, fileId: string): Promise<void>;
+}
+
+declare class VSAccess extends BaseResource {
+    private readonly workspaceId;
+    constructor(httpClient: HttpClient, workspaceId: string);
+    private path;
+    /** List access entries for a vector store. */
+    list(vectorStoreId: string): PageIterator<VSAccessEntry>;
+    /** Grant access to a vector store. */
+    grant(vectorStoreId: string, params: VSAccessGrantParams): Promise<VSAccessEntry>;
+    /** Update access for a vector store. */
+    update(vectorStoreId: string, accessId: string, params: VSAccessUpdateParams): Promise<VSAccessEntry>;
+    /** Revoke access to a vector store. */
+    revoke(vectorStoreId: string, accessId: string): Promise<void>;
+}
+
+declare class VectorStores extends BaseResource {
+    readonly files: VSFiles;
+    readonly access: VSAccess;
+    private readonly workspaceId;
+    constructor(httpClient: HttpClient, workspaceId: string);
+    private path;
+    /** List vector stores. */
+    list(params?: VectorStoreListParams): PageIterator<VectorStore>;
+    /** Create a new vector store. */
+    create(params: VectorStoreCreateParams): Promise<VectorStore>;
+    /** Get a vector store by ID. */
+    get(vectorStoreId: string): Promise<VectorStore>;
+    /** Update a vector store. */
+    update(vectorStoreId: string, params: VectorStoreUpdateParams): Promise<VectorStore>;
+    /** Delete a vector store. */
+    delete(vectorStoreId: string): Promise<void>;
+    /** Search a vector store. */
+    search(vectorStoreId: string, params: VectorStoreSearchParams): Promise<VectorStoreSearchResult[]>;
+    /** Reindex a vector store. */
+    reindex(vectorStoreId: string): Promise<void>;
+    /** Get crawl status for a vector store. */
+    crawlStatus(vectorStoreId: string): Promise<Record<string, unknown>>;
+    /** Trigger a recrawl for a vector store. */
+    recrawl(vectorStoreId: string): Promise<void>;
+}
+
+interface Skill {
+    id: string;
+    name: string;
+    description?: string;
+    type?: string;
+    config?: Record<string, unknown>;
+    schema?: Record<string, unknown>;
+    createdAt?: Timestamp;
+    updatedAt?: Timestamp;
+    [key: string]: unknown;
+}
+interface SkillCreateParams {
+    name: string;
+    description?: string;
+    type?: string;
+    config?: Record<string, unknown>;
+    schema?: Record<string, unknown>;
+}
+interface SkillUpdateParams {
+    name?: string;
+    description?: string;
+    config?: Record<string, unknown>;
+    schema?: Record<string, unknown>;
+}
+interface SkillListParams {
+    page?: number;
+    limit?: number;
+}
+
+declare class Skills extends BaseResource {
+    private readonly workspaceId;
+    constructor(httpClient: HttpClient, workspaceId: string);
+    private path;
+    list(params?: SkillListParams): PageIterator<Skill>;
+    create(params: SkillCreateParams): Promise<Skill>;
+    get(skillId: string): Promise<Skill>;
+    update(skillId: string, params: SkillUpdateParams): Promise<Skill>;
+    delete(skillId: string): Promise<void>;
+}
+
+interface StorageStats {
+    totalFiles?: number;
+    totalSize?: number;
+    vectorStores?: number;
+    totalDocuments?: number;
+    [key: string]: unknown;
+}
+interface StatsParams {
+    period?: string;
+}
+
+declare class Stats extends BaseResource {
+    private readonly workspaceId;
+    constructor(httpClient: HttpClient, workspaceId: string);
+    private path;
+    /** Get storage statistics. */
+    get(params?: StatsParams): Promise<StorageStats>;
+}
+
+/**
+ * Storage namespace — groups all storage-related resources.
+ */
+declare class Storage {
+    readonly files: Files;
+    readonly vectorStores: VectorStores;
+    readonly skills: Skills;
+    readonly stats: Stats;
+    constructor(httpClient: HttpClient, workspaceId: string);
+}
+
+interface PrismeAIOptions {
+    /** API key for authentication. Uses x-prismeai-api-key header. */
+    apiKey?: string;
+    /** Bearer token for authentication. Uses Authorization header. */
+    bearerToken?: string;
+    /** Environment name ('sandbox', 'production') or custom base URL. */
+    environment?: string;
+    /** Custom base URL. Overrides environment. */
+    baseURL?: string;
+    /** Agent Factory workspace ID. */
+    agentFactoryWorkspaceId: string;
+    /** Storage workspace ID. */
+    storageWorkspaceId?: string;
+    /** Request timeout in milliseconds. Default: 60000. */
+    timeout?: number;
+    /** Max retry attempts for failed requests. Default: 2. */
+    maxRetries?: number;
+}
+/**
+ * Main Prisme.ai SDK client.
+ *
+ * @example
+ * ```typescript
+ * const client = new PrismeAI({
+ *   apiKey: 'sk-...',
+ *   environment: 'sandbox',
+ *   agentFactoryWorkspaceId: '6t5T1iC',
+ *   storageWorkspaceId: 'hl2Xm8u',
+ * });
+ *
+ * // List agents
+ * for await (const agent of client.agents.list()) {
+ *   console.log(agent.name);
+ * }
+ *
+ * // Stream a message
+ * const stream = await client.agents.messages.stream('agent-id', {
+ *   text: 'Hello!',
+ * });
+ * for await (const event of stream) {
+ *   if (event.type === 'delta') console.log(event.text);
+ * }
+ * ```
+ */
+declare class PrismeAI {
+    /** Agent Factory resources. */
+    readonly agents: Agents;
+    readonly tasks: Tasks;
+    readonly artifacts: Artifacts;
+    readonly shares: Shares;
+    readonly ratings: Ratings;
+    readonly activity: Activity;
+    readonly profiles: Profiles;
+    readonly orgs: Orgs;
+    /** Storage resources (files, vector stores, skills, stats). */
+    readonly storage: Storage;
+    private readonly agentFactoryClient;
+    private readonly storageClient;
+    constructor(options: PrismeAIOptions);
+}
+
+declare class PrismeAIError extends Error {
+    readonly status: number | undefined;
+    readonly headers: Headers | undefined;
+    readonly body: unknown;
+    constructor(message: string, { status, headers, body }?: {
+        status?: number;
+        headers?: Headers;
+        body?: unknown;
+    });
+}
+declare class AuthenticationError extends PrismeAIError {
+    readonly status = 401;
+    constructor(message: string, opts?: {
+        headers?: Headers;
+        body?: unknown;
+    });
+}
+declare class PermissionDeniedError extends PrismeAIError {
+    readonly status = 403;
+    constructor(message: string, opts?: {
+        headers?: Headers;
+        body?: unknown;
+    });
+}
+declare class NotFoundError extends PrismeAIError {
+    readonly status = 404;
+    constructor(message: string, opts?: {
+        headers?: Headers;
+        body?: unknown;
+    });
+}
+declare class ConflictError extends PrismeAIError {
+    readonly status = 409;
+    constructor(message: string, opts?: {
+        headers?: Headers;
+        body?: unknown;
+    });
+}
+declare class ValidationError extends PrismeAIError {
+    readonly status = 422;
+    constructor(message: string, opts?: {
+        headers?: Headers;
+        body?: unknown;
+    });
+}
+declare class RateLimitError extends PrismeAIError {
+    readonly status = 429;
+    readonly retryAfter: number | undefined;
+    constructor(message: string, opts?: {
+        headers?: Headers;
+        body?: unknown;
+    });
+}
+declare class InternalServerError extends PrismeAIError {
+    readonly status = 500;
+    constructor(message: string, opts?: {
+        headers?: Headers;
+        body?: unknown;
+    });
+}
+declare class ConnectionError extends PrismeAIError {
+    constructor(message: string);
+}
+declare class TimeoutError extends PrismeAIError {
+    constructor(message: string);
+}
+
+export { type A2ACard, type A2AExtendedCard, type A2AResponse, type A2ASendParams, type A2AStreamEvent, type AccessEntry, type AccessGrantParams, type AccessListParams, type AccessRequest, type AccessRequestHandleParams, type Agent, type AgentCreateParams, type AgentDiscovery, type AgentListParams, type AgentTool, type AgentUpdateParams, type AnalyticsDataPoint, type AnalyticsParams, type AnalyticsResponse, type Approver, type Artifact, type ArtifactListParams, type ArtifactShareParams, type ArtifactUpdateParams, AuthenticationError, ConflictError, ConnectionError, type Conversation, type ConversationCreateParams, type ConversationListParams, type ConversationMessage, type ConversationShareParams, type ConversationUpdateParams, type FileInput, type FileListParams, type FileObject, type FileUploadOptions, type FileUploadParams, type GuardrailConfig, type GuardrailType, InternalServerError, type LocalizedText, type MessagePart, type MessageResponse, type MessageSendParams, NotFoundError, PageIterator, type PageResponse, type PaginationParams, PermissionDeniedError, PrismeAI, PrismeAIError, type PrismeAIOptions, RateLimitError, SSEStream, type Share, type ShareListParams, type Skill, type SkillCreateParams, type SkillListParams, type SkillUpdateParams, type StatsParams, type StorageStats, type StreamEvent, type StreamEventDelta, type StreamEventError, type StreamEventTaskCompleted, type StreamEventTaskStatus, type StreamEventToolCall, type StreamEventToolResult, type SubAgentConfig, type Task, type TaskListParams, TimeoutError, type Timestamp, type Tool, type ToolCreateParams, type ToolListParams, type ToolPermissions, type ToolPolicy, type ToolRule, type VSAccessEntry, type VSAccessGrantParams, type VSAccessUpdateParams, type VSFile, type VSFileAddParams, type VSFileChunk, type VSFileListParams, ValidationError, type VectorStore, type VectorStoreConfig, type VectorStoreCreateParams, type VectorStoreListParams, type VectorStoreSearchParams, type VectorStoreSearchResult, type VectorStoreUpdateParams };