cencori 1.2.1 → 1.3.0

package/dist/index.d.mts

@@ -2,6 +2,8 @@ import { C as CencoriConfig, i as RequestOptions } from './types-kh1whvNH.mjs';
 export { j as ChatMessage, a as ChatRequest, b as ChatResponse, o as CodeInterpreterTool, c as CompletionRequest, E as EmbeddingRequest, d as EmbeddingResponse, F as FileSearchTool, l as ResponseInputItem, k as ResponsesOutputItem, R as ResponsesRequest, g as ResponsesResponse, m as ResponsesTool, U as UrlCitation, n as WebSearchTool } from './types-kh1whvNH.mjs';
 import { AINamespace } from './ai/index.mjs';
 export { StreamChunk } from './ai/index.mjs';
+import { VisionNamespace } from './vision/index.mjs';
+export { VisionClassification, VisionClassifyResult, VisionCost, VisionDescribeResult, VisionImage, VisionOcrResult, VisionProvider, VisionRequest, VisionResult, VisionTask, VisionUsage } from './vision/index.mjs';
 import { ComputeNamespace } from './compute/index.mjs';
 import { WorkflowNamespace } from './workflow/index.mjs';
 import { StorageNamespace } from './storage/index.mjs';
@@ -11,6 +13,171 @@ export { WebTelemetryPayload } from './telemetry/index.mjs';
 export { CencoriChatSettings, CencoriProvider, CencoriProviderSettings, cencori, createCencori } from './vercel/index.mjs';
 import '@ai-sdk/provider';
 
+interface AgentConfig {
+    model: string;
+    system_prompt: string | null;
+    tools: string[];
+    temperature: number | null;
+}
+interface Agent {
+    id: string;
+    name: string;
+    description: string | null;
+    is_active: boolean;
+    shadow_mode: boolean;
+    created_at: string;
+    updated_at?: string;
+    config: AgentConfig;
+}
+interface AgentListItem {
+    id: string;
+    name: string;
+    description: string | null;
+    is_active: boolean;
+    shadow_mode: boolean;
+    created_at: string;
+}
+interface CreateAgentParams {
+    name: string;
+    description?: string;
+    config?: {
+        model?: string;
+        system_prompt?: string;
+        tools?: string[];
+        temperature?: number;
+    };
+}
+interface UpdateAgentParams {
+    name?: string;
+    description?: string;
+    is_active?: boolean;
+    shadow_mode?: boolean;
+    config?: {
+        model?: string;
+        system_prompt?: string;
+        tools?: string[];
+        temperature?: number;
+    };
+}
+interface AgentKey {
+    id: string;
+    name: string;
+    key_prefix: string;
+    full_key?: string;
+    environment: string;
+    key_type: string;
+    agent_id: string;
+    created_at: string;
+}
+interface CreateAgentKeyParams {
+    name?: string;
+    environment?: 'production' | 'test';
+    key_type?: 'secret' | 'publishable';
+    allowed_domains?: string[];
+}
+declare class AgentsNamespace {
+    private config;
+    constructor(config: Required<CencoriConfig>);
+    private request;
+    create(params: CreateAgentParams): Promise<Agent>;
+    list(): Promise<{
+        data: AgentListItem[];
+    }>;
+    get(agentId: string): Promise<Agent>;
+    updateConfig(agentId: string, params: UpdateAgentParams): Promise<Agent>;
+    delete(agentId: string): Promise<void>;
+    createKey(agentId: string, params?: CreateAgentKeyParams): Promise<AgentKey>;
+}
+
+interface Session {
+    id: string;
+    status: 'active' | 'paused' | 'completed' | 'failed';
+    turn_count: number;
+    created_at: string;
+    updated_at: string;
+    agent_id: string | null;
+    metadata: Record<string, unknown>;
+    total_cost: number;
+}
+interface SessionEvent {
+    id: string;
+    session_id: string;
+    turn_number: number;
+    sequence: number;
+    event_type: string;
+    payload: Record<string, unknown>;
+    created_at: string;
+}
+interface CreateSessionParams {
+    agent_id?: string;
+    metadata?: Record<string, unknown>;
+}
+interface TurnParams {
+    input: string | Array<Record<string, unknown>>;
+    tools?: Array<Record<string, unknown>>;
+    instructions?: string;
+    agent_id?: string;
+    model?: string;
+    temperature?: number;
+    max_output_tokens?: number;
+    tool_choice?: 'auto' | 'none' | 'required' | {
+        type: 'function';
+        name: string;
+    };
+    response_format?: Record<string, unknown>;
+    user?: string;
+    pause_on_tool_calls?: boolean;
+}
+interface ApproveRejectParams {
+    action_id: string;
+    tool_results?: Array<{
+        action_id: string;
+        output: string;
+    }>;
+}
+interface PaginatedResponse<T> {
+    data: T[];
+    pagination: {
+        page: number;
+        limit: number;
+        total: number;
+        total_pages: number;
+    };
+}
+interface SessionListParams {
+    page?: number;
+    limit?: number;
+    status?: 'active' | 'paused' | 'completed' | 'failed';
+    agent_id?: string;
+}
+declare class SessionsNamespace {
+    private config;
+    constructor(config: Required<CencoriConfig>);
+    private request;
+    create(params?: CreateSessionParams): Promise<Session>;
+    list(params?: SessionListParams): Promise<PaginatedResponse<Session>>;
+    get(sessionId: string): Promise<Session>;
+    delete(sessionId: string): Promise<{
+        id: string;
+        deleted: boolean;
+    }>;
+    submitTurn(sessionId: string, params: TurnParams): Promise<Response>;
+    submitTurnStream(sessionId: string, params: TurnParams): Promise<ReadableStream<Uint8Array> | null>;
+    getEvents(sessionId: string, params?: {
+        page?: number;
+        limit?: number;
+        turn_number?: number;
+    }): Promise<PaginatedResponse<SessionEvent>>;
+    approve(sessionId: string, params: ApproveRejectParams): Promise<Response>;
+    approveStream(sessionId: string, params: ApproveRejectParams): Promise<ReadableStream<Uint8Array> | null>;
+    reject(sessionId: string, params: ApproveRejectParams): Promise<{
+        id: string;
+        action_id: string;
+        resolution: string;
+        status: string;
+    }>;
+}
+
 /**
  * Cencori - Unified AI Infrastructure SDK
  *
@@ -41,12 +208,40 @@ import '@ai-sdk/provider';
 declare class Cencori {
     private config;
     /**
-     * AI Gateway - Chat, completions, embeddings with security & observability
+     * AI Gateway - Chat, completions, embeddings, responses with security & observability
      *
      * @example
      * await cencori.ai.chat({ model: 'gpt-4o', messages: [...] });
      */
     readonly ai: AINamespace;
+    /**
+     * Vision - Analyze, describe, OCR, and classify images
+     *
+     * @example
+     * const result = await cencori.vision.analyze({
+     *   image: { url: 'https://example.com/photo.jpg' },
+     *   prompt: 'What breed is this dog?'
+     * });
+     *
+     * @example
+     * const { text } = await cencori.vision.ocr({
+     *   image: { base64, mimeType: 'image/png' }
+     * });
+     */
+    readonly vision: VisionNamespace;
+    /**
+     * Agents - Create and manage AI agents programmatically.
+     *
+     * @example
+     * const agent = await cencori.agents.create({
+     *   name: 'my-agent',
+     *   config: { model: 'gpt-4o', system_prompt: 'You are a helpful assistant.' }
+     * });
+     *
+     * @example
+     * const key = await cencori.agents.createKey(agent.id, { name: 'prod-key' });
+     */
+    readonly agents: AgentsNamespace;
     /**
      * Compute - Serverless functions & GPU access
      *
@@ -82,6 +277,15 @@ declare class Cencori {
      * await cencori.memory.search({ namespace: 'conversations', query: '...' });
      */
     readonly memory: MemoryClient;
+    /**
+     * Sessions - Durable execution sessions for AI agents with pause/resume and event sourcing
+     *
+     * @example
+     * const sessions = await cencori.sessions.list({ status: 'active' });
+     * const session = await cencori.sessions.create({ agent_id: 'ag_...' });
+     * await cencori.sessions.submitTurn(session.id, { input: 'Hello' });
+     */
+    readonly sessions: SessionsNamespace;
     /**
      * Telemetry - Report web traffic from your app to the Cencori dashboard
      *
@@ -165,4 +369,4 @@ declare class SafetyError extends CencoriError {
  */
 declare function fetchWithRetry(url: string, options: RequestInit, maxRetries?: number): Promise<Response>;
 
-export { AINamespace, AuthenticationError, Cencori, CencoriConfig, CencoriError, ComputeNamespace, MemoryClient, RateLimitError, RequestOptions, SafetyError, StorageNamespace, TelemetryClient, WorkflowNamespace, Cencori as default, fetchWithRetry };
+export { AINamespace, type Agent, type AgentConfig, type AgentKey, type AgentListItem, AgentsNamespace, AuthenticationError, Cencori, CencoriConfig, CencoriError, ComputeNamespace, type CreateAgentKeyParams, type CreateAgentParams, type CreateSessionParams, MemoryClient, type PaginatedResponse, RateLimitError, RequestOptions, SafetyError, type Session, type SessionEvent, type SessionListParams, SessionsNamespace, StorageNamespace, TelemetryClient, type TurnParams, type UpdateAgentParams, VisionNamespace, WorkflowNamespace, Cencori as default, fetchWithRetry };

package/dist/index.d.ts

@@ -2,6 +2,8 @@ import { C as CencoriConfig, i as RequestOptions } from './types-kh1whvNH.js';
 export { j as ChatMessage, a as ChatRequest, b as ChatResponse, o as CodeInterpreterTool, c as CompletionRequest, E as EmbeddingRequest, d as EmbeddingResponse, F as FileSearchTool, l as ResponseInputItem, k as ResponsesOutputItem, R as ResponsesRequest, g as ResponsesResponse, m as ResponsesTool, U as UrlCitation, n as WebSearchTool } from './types-kh1whvNH.js';
 import { AINamespace } from './ai/index.js';
 export { StreamChunk } from './ai/index.js';
+import { VisionNamespace } from './vision/index.js';
+export { VisionClassification, VisionClassifyResult, VisionCost, VisionDescribeResult, VisionImage, VisionOcrResult, VisionProvider, VisionRequest, VisionResult, VisionTask, VisionUsage } from './vision/index.js';
 import { ComputeNamespace } from './compute/index.js';
 import { WorkflowNamespace } from './workflow/index.js';
 import { StorageNamespace } from './storage/index.js';
@@ -11,6 +13,171 @@ export { WebTelemetryPayload } from './telemetry/index.js';
 export { CencoriChatSettings, CencoriProvider, CencoriProviderSettings, cencori, createCencori } from './vercel/index.js';
 import '@ai-sdk/provider';
 
+interface AgentConfig {
+    model: string;
+    system_prompt: string | null;
+    tools: string[];
+    temperature: number | null;
+}
+interface Agent {
+    id: string;
+    name: string;
+    description: string | null;
+    is_active: boolean;
+    shadow_mode: boolean;
+    created_at: string;
+    updated_at?: string;
+    config: AgentConfig;
+}
+interface AgentListItem {
+    id: string;
+    name: string;
+    description: string | null;
+    is_active: boolean;
+    shadow_mode: boolean;
+    created_at: string;
+}
+interface CreateAgentParams {
+    name: string;
+    description?: string;
+    config?: {
+        model?: string;
+        system_prompt?: string;
+        tools?: string[];
+        temperature?: number;
+    };
+}
+interface UpdateAgentParams {
+    name?: string;
+    description?: string;
+    is_active?: boolean;
+    shadow_mode?: boolean;
+    config?: {
+        model?: string;
+        system_prompt?: string;
+        tools?: string[];
+        temperature?: number;
+    };
+}
+interface AgentKey {
+    id: string;
+    name: string;
+    key_prefix: string;
+    full_key?: string;
+    environment: string;
+    key_type: string;
+    agent_id: string;
+    created_at: string;
+}
+interface CreateAgentKeyParams {
+    name?: string;
+    environment?: 'production' | 'test';
+    key_type?: 'secret' | 'publishable';
+    allowed_domains?: string[];
+}
+declare class AgentsNamespace {
+    private config;
+    constructor(config: Required<CencoriConfig>);
+    private request;
+    create(params: CreateAgentParams): Promise<Agent>;
+    list(): Promise<{
+        data: AgentListItem[];
+    }>;
+    get(agentId: string): Promise<Agent>;
+    updateConfig(agentId: string, params: UpdateAgentParams): Promise<Agent>;
+    delete(agentId: string): Promise<void>;
+    createKey(agentId: string, params?: CreateAgentKeyParams): Promise<AgentKey>;
+}
+
+interface Session {
+    id: string;
+    status: 'active' | 'paused' | 'completed' | 'failed';
+    turn_count: number;
+    created_at: string;
+    updated_at: string;
+    agent_id: string | null;
+    metadata: Record<string, unknown>;
+    total_cost: number;
+}
+interface SessionEvent {
+    id: string;
+    session_id: string;
+    turn_number: number;
+    sequence: number;
+    event_type: string;
+    payload: Record<string, unknown>;
+    created_at: string;
+}
+interface CreateSessionParams {
+    agent_id?: string;
+    metadata?: Record<string, unknown>;
+}
+interface TurnParams {
+    input: string | Array<Record<string, unknown>>;
+    tools?: Array<Record<string, unknown>>;
+    instructions?: string;
+    agent_id?: string;
+    model?: string;
+    temperature?: number;
+    max_output_tokens?: number;
+    tool_choice?: 'auto' | 'none' | 'required' | {
+        type: 'function';
+        name: string;
+    };
+    response_format?: Record<string, unknown>;
+    user?: string;
+    pause_on_tool_calls?: boolean;
+}
+interface ApproveRejectParams {
+    action_id: string;
+    tool_results?: Array<{
+        action_id: string;
+        output: string;
+    }>;
+}
+interface PaginatedResponse<T> {
+    data: T[];
+    pagination: {
+        page: number;
+        limit: number;
+        total: number;
+        total_pages: number;
+    };
+}
+interface SessionListParams {
+    page?: number;
+    limit?: number;
+    status?: 'active' | 'paused' | 'completed' | 'failed';
+    agent_id?: string;
+}
+declare class SessionsNamespace {
+    private config;
+    constructor(config: Required<CencoriConfig>);
+    private request;
+    create(params?: CreateSessionParams): Promise<Session>;
+    list(params?: SessionListParams): Promise<PaginatedResponse<Session>>;
+    get(sessionId: string): Promise<Session>;
+    delete(sessionId: string): Promise<{
+        id: string;
+        deleted: boolean;
+    }>;
+    submitTurn(sessionId: string, params: TurnParams): Promise<Response>;
+    submitTurnStream(sessionId: string, params: TurnParams): Promise<ReadableStream<Uint8Array> | null>;
+    getEvents(sessionId: string, params?: {
+        page?: number;
+        limit?: number;
+        turn_number?: number;
+    }): Promise<PaginatedResponse<SessionEvent>>;
+    approve(sessionId: string, params: ApproveRejectParams): Promise<Response>;
+    approveStream(sessionId: string, params: ApproveRejectParams): Promise<ReadableStream<Uint8Array> | null>;
+    reject(sessionId: string, params: ApproveRejectParams): Promise<{
+        id: string;
+        action_id: string;
+        resolution: string;
+        status: string;
+    }>;
+}
+
 /**
  * Cencori - Unified AI Infrastructure SDK
  *
@@ -41,12 +208,40 @@ import '@ai-sdk/provider';
 declare class Cencori {
     private config;
     /**
-     * AI Gateway - Chat, completions, embeddings with security & observability
+     * AI Gateway - Chat, completions, embeddings, responses with security & observability
      *
      * @example
      * await cencori.ai.chat({ model: 'gpt-4o', messages: [...] });
      */
     readonly ai: AINamespace;
+    /**
+     * Vision - Analyze, describe, OCR, and classify images
+     *
+     * @example
+     * const result = await cencori.vision.analyze({
+     *   image: { url: 'https://example.com/photo.jpg' },
+     *   prompt: 'What breed is this dog?'
+     * });
+     *
+     * @example
+     * const { text } = await cencori.vision.ocr({
+     *   image: { base64, mimeType: 'image/png' }
+     * });
+     */
+    readonly vision: VisionNamespace;
+    /**
+     * Agents - Create and manage AI agents programmatically.
+     *
+     * @example
+     * const agent = await cencori.agents.create({
+     *   name: 'my-agent',
+     *   config: { model: 'gpt-4o', system_prompt: 'You are a helpful assistant.' }
+     * });
+     *
+     * @example
+     * const key = await cencori.agents.createKey(agent.id, { name: 'prod-key' });
+     */
+    readonly agents: AgentsNamespace;
     /**
      * Compute - Serverless functions & GPU access
      *
@@ -82,6 +277,15 @@ declare class Cencori {
      * await cencori.memory.search({ namespace: 'conversations', query: '...' });
      */
     readonly memory: MemoryClient;
+    /**
+     * Sessions - Durable execution sessions for AI agents with pause/resume and event sourcing
+     *
+     * @example
+     * const sessions = await cencori.sessions.list({ status: 'active' });
+     * const session = await cencori.sessions.create({ agent_id: 'ag_...' });
+     * await cencori.sessions.submitTurn(session.id, { input: 'Hello' });
+     */
+    readonly sessions: SessionsNamespace;
     /**
      * Telemetry - Report web traffic from your app to the Cencori dashboard
      *
@@ -165,4 +369,4 @@ declare class SafetyError extends CencoriError {
  */
 declare function fetchWithRetry(url: string, options: RequestInit, maxRetries?: number): Promise<Response>;
 
-export { AINamespace, AuthenticationError, Cencori, CencoriConfig, CencoriError, ComputeNamespace, MemoryClient, RateLimitError, RequestOptions, SafetyError, StorageNamespace, TelemetryClient, WorkflowNamespace, Cencori as default, fetchWithRetry };
+export { AINamespace, type Agent, type AgentConfig, type AgentKey, type AgentListItem, AgentsNamespace, AuthenticationError, Cencori, CencoriConfig, CencoriError, ComputeNamespace, type CreateAgentKeyParams, type CreateAgentParams, type CreateSessionParams, MemoryClient, type PaginatedResponse, RateLimitError, RequestOptions, SafetyError, type Session, type SessionEvent, type SessionListParams, SessionsNamespace, StorageNamespace, TelemetryClient, type TurnParams, type UpdateAgentParams, VisionNamespace, WorkflowNamespace, Cencori as default, fetchWithRetry };