@inkeep/agents-sdk 0.0.0-dev-20250912172534 → 0.0.0-dev-20250912184011

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { MCPToolConfig as MCPToolConfig$1, CredentialReferenceApiInsert, MCPTransportType, CredentialReferenceSelect, AgentApiInsert, DataComponentApiInsert, ArtifactComponentApiInsert, AgentConversationHistoryConfig, ToolInsert, McpTransportConfig, ArtifactComponentInsert, DataComponentInsert } from '@inkeep/agents-core';
+import { MCPToolConfig as MCPToolConfig$1, CredentialReferenceApiInsert, MCPTransportType, CredentialReferenceSelect, AgentApiInsert, AgentStopWhen, DataComponentApiInsert, ArtifactComponentApiInsert, AgentConversationHistoryConfig, GraphStopWhen, ToolInsert, McpTransportConfig, ArtifactComponentInsert, DataComponentInsert, StopWhen, FullProjectDefinition } from '@inkeep/agents-core';
 import { z } from 'zod';
 
 interface ToolInterface {
@@ -195,9 +195,7 @@ interface AgentConfig extends Omit<AgentApiInsert, 'projectId'> {
         structuredOutput?: ModelSettings;
         summarizer?: ModelSettings;
     };
-    stopWhen?: {
-        stepCountIs?: number;
-    };
+    stopWhen?: AgentStopWhen;
     memory?: {
         type: 'conversation' | 'episodic' | 'short_term';
         capacity?: number;
@@ -341,9 +339,7 @@ interface GraphConfig {
     tenantId?: string;
     contextConfig?: any;
     credentials?: () => CredentialReferenceApiInsert[];
-    stopWhen?: {
-        transferCountIs?: number;
-    };
+    stopWhen?: GraphStopWhen;
     graphPrompt?: string;
     models?: {
         base?: ModelSettings;
@@ -625,9 +621,7 @@ declare class AgentGraph implements GraphInterface {
     /**
      * Get the graph's stopWhen configuration
      */
-    getStopWhen(): {
-        transferCountIs?: number;
-    };
+    getStopWhen(): GraphStopWhen;
     /**
      * Get the graph's status updates configuration
      */
@@ -709,10 +703,206 @@ declare class AgentGraph implements GraphInterface {
     private createExternalAgents;
 }
 
+/**
+ * Project configuration interface for the SDK
+ */
+interface ProjectConfig {
+    id: string;
+    name: string;
+    description?: string;
+    tenantId?: string;
+    models?: {
+        base?: ModelSettings;
+        structuredOutput?: ModelSettings;
+        summarizer?: ModelSettings;
+    };
+    stopWhen?: StopWhen;
+    graphs?: () => AgentGraph[];
+}
+/**
+ * Project interface for operations
+ */
+interface ProjectInterface {
+    init(): Promise<void>;
+    setConfig(tenantId: string, apiUrl: string): void;
+    getId(): string;
+    getName(): string;
+    getDescription(): string | undefined;
+    getTenantId(): string;
+    getModels(): ProjectConfig['models'];
+    getStopWhen(): ProjectConfig['stopWhen'];
+    getGraphs(): AgentGraph[];
+    addGraph(graph: AgentGraph): void;
+    removeGraph(id: string): boolean;
+    getStats(): {
+        projectId: string;
+        tenantId: string;
+        graphCount: number;
+        initialized: boolean;
+    };
+    validate(): {
+        valid: boolean;
+        errors: string[];
+    };
+}
+/**
+ * Project class for managing agent projects
+ *
+ * Projects are the top-level organizational unit that contains graphs, agents, and shared configurations.
+ * They provide model inheritance and execution limits that cascade down to graphs and agents.
+ *
+ * @example
+ * ```typescript
+ * const myProject = new Project({
+ *   id: 'customer-support-project',
+ *   name: 'Customer Support System',
+ *   description: 'Multi-agent customer support system',
+ *   models: {
+ *     base: { model: 'gpt-4o-mini' },
+ *     structuredOutput: { model: 'gpt-4o' }
+ *   },
+ *   stopWhen: {
+ *     transferCountIs: 10,
+ *     stepCountIs: 50
+ *   }
+ * });
+ *
+ * await myProject.init();
+ * ```
+ */
+declare class Project implements ProjectInterface {
+    private projectId;
+    private projectName;
+    private projectDescription?;
+    private tenantId;
+    private baseURL;
+    private initialized;
+    private models?;
+    private stopWhen?;
+    private graphs;
+    private graphMap;
+    constructor(config: ProjectConfig);
+    /**
+     * Set or update the configuration (tenantId and apiUrl)
+     * This is used by the CLI to inject configuration from inkeep.config.ts
+     */
+    setConfig(tenantId: string, apiUrl: string): void;
+    /**
+     * Initialize the project and create/update it in the backend using full project approach
+     */
+    init(): Promise<void>;
+    /**
+     * Get the project ID
+     */
+    getId(): string;
+    /**
+     * Get the project name
+     */
+    getName(): string;
+    /**
+     * Get the project description
+     */
+    getDescription(): string | undefined;
+    /**
+     * Get the tenant ID
+     */
+    getTenantId(): string;
+    /**
+     * Get the project's model configuration
+     */
+    getModels(): ProjectConfig['models'];
+    /**
+     * Set the project's model configuration
+     */
+    setModels(models: ProjectConfig['models']): void;
+    /**
+     * Get the project's stopWhen configuration
+     */
+    getStopWhen(): ProjectConfig['stopWhen'];
+    /**
+     * Set the project's stopWhen configuration
+     */
+    setStopWhen(stopWhen: ProjectConfig['stopWhen']): void;
+    /**
+     * Get all graphs in the project
+     */
+    getGraphs(): AgentGraph[];
+    /**
+     * Get a graph by ID
+     */
+    getGraph(id: string): AgentGraph | undefined;
+    /**
+     * Add a graph to the project
+     */
+    addGraph(graph: AgentGraph): void;
+    /**
+     * Remove a graph from the project
+     */
+    removeGraph(id: string): boolean;
+    /**
+     * Get project statistics
+     */
+    getStats(): {
+        projectId: string;
+        tenantId: string;
+        graphCount: number;
+        initialized: boolean;
+    };
+    /**
+     * Validate the project configuration
+     */
+    validate(): {
+        valid: boolean;
+        errors: string[];
+    };
+    /**
+     * Convert the Project to FullProjectDefinition format
+     */
+    private toFullProjectDefinition;
+    /**
+     * Convert project configuration to API format
+     */
+    private toApiFormat;
+}
+
 /**
  * Helper function to create graphs - OpenAI style
  */
 declare function agentGraph(config: GraphConfig): AgentGraph;
+/**
+ * Helper function to create projects - OpenAI style
+ *
+ * Projects are the top-level organizational unit that contains graphs, agents, and shared configurations.
+ * They provide model inheritance and execution limits that cascade down to graphs and agents.
+ *
+ * @param config - Project configuration
+ * @returns A new Project instance
+ *
+ * @example
+ * ```typescript
+ * const customerSupport = project({
+ *   id: 'customer-support-project',
+ *   name: 'Customer Support System',
+ *   description: 'Multi-agent customer support system',
+ *   models: {
+ *     base: { model: 'gpt-4o-mini' },
+ *     structuredOutput: { model: 'gpt-4o' }
+ *   },
+ *   stopWhen: {
+ *     transferCountIs: 10,
+ *     stepCountIs: 50
+ *   },
+ *   graphs: () => [
+ *     agentGraph({
+ *       id: 'support-graph',
+ *       name: 'Support Graph',
+ *       // ... graph config
+ *     })
+ *   ]
+ * });
+ * ```
+ */
+declare function project(config: ProjectConfig): Project;
 /**
  * Creates a new agent with stable ID enforcement.
  *
@@ -879,6 +1069,28 @@ declare function createEnvironmentSettings<T extends Record<string, EnvironmentS
  */
 declare function registerEnvironmentSettings<T extends EnvironmentSettingsConfig>(config: T): T;
 
+/**
+ * Client-side functions for interacting with the Full Project API
+ * These functions make HTTP requests to the server instead of direct database calls
+ */
+
+/**
+ * Create a full project via HTTP API
+ */
+declare function createFullProjectViaAPI(tenantId: string, apiUrl: string, projectData: FullProjectDefinition): Promise<FullProjectDefinition>;
+/**
+ * Update a full project via HTTP API (upsert behavior)
+ */
+declare function updateFullProjectViaAPI(tenantId: string, apiUrl: string, projectId: string, projectData: FullProjectDefinition): Promise<FullProjectDefinition>;
+/**
+ * Get a full project via HTTP API
+ */
+declare function getFullProjectViaAPI(tenantId: string, apiUrl: string, projectId: string): Promise<FullProjectDefinition | null>;
+/**
+ * Delete a full project via HTTP API
+ */
+declare function deleteFullProjectViaAPI(tenantId: string, apiUrl: string, projectId: string): Promise<void>;
+
 declare class Runner {
     /**
      * Run a graph until completion, handling transfers and tool calls
@@ -916,4 +1128,4 @@ declare const run: typeof Runner.run;
 declare const stream: typeof Runner.stream;
 declare const raceGraphs: typeof Runner.raceGraphs;
 
-export { Agent, type AgentCanUseType, type AgentConfig, AgentError, type AgentInterface, type AgentResponse, type AllAgentInterface, ArtifactComponent, type AssistantMessage, type BuilderAgentConfig, type BuilderRelationConfig, type BuilderToolConfig, DataComponent, ExternalAgent, type ExternalAgentInterface, type FetchDefinitionConfig, type GenerateOptions, type GraphConfig, type GraphInterface, type MCPToolConfig, MaxTurnsExceededError, type Message, type MessageInput, type ModelSettings, ModelSettingsSchema, type RequestSchemaConfig, type RequestSchemaDefinition, type RunResult, Runner, type ServerConfig, type StatusComponent, type StatusUpdateSettings, type StreamEvent, type StreamResponse, type SystemMessage, Tool, type ToolCall, type ToolConfig, ToolExecutionError, type ToolMessage, type ToolResult, type TransferConfig, TransferError, type UserMessage, agent, agentGraph, agentMcp, artifactComponent, createEnvironmentSettings, credential, dataComponent, externalAgent, externalAgents, mcpServer, mcpTool, raceGraphs, registerEnvironmentSettings, run, stream, transfer };
+export { Agent, type AgentCanUseType, type AgentConfig, AgentError, type AgentInterface, type AgentResponse, type AllAgentInterface, ArtifactComponent, type AssistantMessage, type BuilderAgentConfig, type BuilderRelationConfig, type BuilderToolConfig, DataComponent, ExternalAgent, type ExternalAgentInterface, type FetchDefinitionConfig, type GenerateOptions, type GraphConfig, type GraphInterface, type MCPToolConfig, MaxTurnsExceededError, type Message, type MessageInput, type ModelSettings, ModelSettingsSchema, Project, type RequestSchemaConfig, type RequestSchemaDefinition, type RunResult, Runner, type ServerConfig, type StatusComponent, type StatusUpdateSettings, type StreamEvent, type StreamResponse, type SystemMessage, Tool, type ToolCall, type ToolConfig, ToolExecutionError, type ToolMessage, type ToolResult, type TransferConfig, TransferError, type UserMessage, agent, agentGraph, agentMcp, artifactComponent, createEnvironmentSettings, createFullProjectViaAPI, credential, dataComponent, deleteFullProjectViaAPI, externalAgent, externalAgents, getFullProjectViaAPI, mcpServer, mcpTool, project, raceGraphs, registerEnvironmentSettings, run, stream, transfer, updateFullProjectViaAPI };

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { MCPToolConfig as MCPToolConfig$1, CredentialReferenceApiInsert, MCPTransportType, CredentialReferenceSelect, AgentApiInsert, DataComponentApiInsert, ArtifactComponentApiInsert, AgentConversationHistoryConfig, ToolInsert, McpTransportConfig, ArtifactComponentInsert, DataComponentInsert } from '@inkeep/agents-core';
+import { MCPToolConfig as MCPToolConfig$1, CredentialReferenceApiInsert, MCPTransportType, CredentialReferenceSelect, AgentApiInsert, AgentStopWhen, DataComponentApiInsert, ArtifactComponentApiInsert, AgentConversationHistoryConfig, GraphStopWhen, ToolInsert, McpTransportConfig, ArtifactComponentInsert, DataComponentInsert, StopWhen, FullProjectDefinition } from '@inkeep/agents-core';
 import { z } from 'zod';
 
 interface ToolInterface {
@@ -195,9 +195,7 @@ interface AgentConfig extends Omit<AgentApiInsert, 'projectId'> {
         structuredOutput?: ModelSettings;
         summarizer?: ModelSettings;
     };
-    stopWhen?: {
-        stepCountIs?: number;
-    };
+    stopWhen?: AgentStopWhen;
     memory?: {
         type: 'conversation' | 'episodic' | 'short_term';
         capacity?: number;
@@ -341,9 +339,7 @@ interface GraphConfig {
     tenantId?: string;
     contextConfig?: any;
     credentials?: () => CredentialReferenceApiInsert[];
-    stopWhen?: {
-        transferCountIs?: number;
-    };
+    stopWhen?: GraphStopWhen;
     graphPrompt?: string;
     models?: {
         base?: ModelSettings;
@@ -625,9 +621,7 @@ declare class AgentGraph implements GraphInterface {
     /**
      * Get the graph's stopWhen configuration
      */
-    getStopWhen(): {
-        transferCountIs?: number;
-    };
+    getStopWhen(): GraphStopWhen;
     /**
      * Get the graph's status updates configuration
      */
@@ -709,10 +703,206 @@ declare class AgentGraph implements GraphInterface {
     private createExternalAgents;
 }
 
+/**
+ * Project configuration interface for the SDK
+ */
+interface ProjectConfig {
+    id: string;
+    name: string;
+    description?: string;
+    tenantId?: string;
+    models?: {
+        base?: ModelSettings;
+        structuredOutput?: ModelSettings;
+        summarizer?: ModelSettings;
+    };
+    stopWhen?: StopWhen;
+    graphs?: () => AgentGraph[];
+}
+/**
+ * Project interface for operations
+ */
+interface ProjectInterface {
+    init(): Promise<void>;
+    setConfig(tenantId: string, apiUrl: string): void;
+    getId(): string;
+    getName(): string;
+    getDescription(): string | undefined;
+    getTenantId(): string;
+    getModels(): ProjectConfig['models'];
+    getStopWhen(): ProjectConfig['stopWhen'];
+    getGraphs(): AgentGraph[];
+    addGraph(graph: AgentGraph): void;
+    removeGraph(id: string): boolean;
+    getStats(): {
+        projectId: string;
+        tenantId: string;
+        graphCount: number;
+        initialized: boolean;
+    };
+    validate(): {
+        valid: boolean;
+        errors: string[];
+    };
+}
+/**
+ * Project class for managing agent projects
+ *
+ * Projects are the top-level organizational unit that contains graphs, agents, and shared configurations.
+ * They provide model inheritance and execution limits that cascade down to graphs and agents.
+ *
+ * @example
+ * ```typescript
+ * const myProject = new Project({
+ *   id: 'customer-support-project',
+ *   name: 'Customer Support System',
+ *   description: 'Multi-agent customer support system',
+ *   models: {
+ *     base: { model: 'gpt-4o-mini' },
+ *     structuredOutput: { model: 'gpt-4o' }
+ *   },
+ *   stopWhen: {
+ *     transferCountIs: 10,
+ *     stepCountIs: 50
+ *   }
+ * });
+ *
+ * await myProject.init();
+ * ```
+ */
+declare class Project implements ProjectInterface {
+    private projectId;
+    private projectName;
+    private projectDescription?;
+    private tenantId;
+    private baseURL;
+    private initialized;
+    private models?;
+    private stopWhen?;
+    private graphs;
+    private graphMap;
+    constructor(config: ProjectConfig);
+    /**
+     * Set or update the configuration (tenantId and apiUrl)
+     * This is used by the CLI to inject configuration from inkeep.config.ts
+     */
+    setConfig(tenantId: string, apiUrl: string): void;
+    /**
+     * Initialize the project and create/update it in the backend using full project approach
+     */
+    init(): Promise<void>;
+    /**
+     * Get the project ID
+     */
+    getId(): string;
+    /**
+     * Get the project name
+     */
+    getName(): string;
+    /**
+     * Get the project description
+     */
+    getDescription(): string | undefined;
+    /**
+     * Get the tenant ID
+     */
+    getTenantId(): string;
+    /**
+     * Get the project's model configuration
+     */
+    getModels(): ProjectConfig['models'];
+    /**
+     * Set the project's model configuration
+     */
+    setModels(models: ProjectConfig['models']): void;
+    /**
+     * Get the project's stopWhen configuration
+     */
+    getStopWhen(): ProjectConfig['stopWhen'];
+    /**
+     * Set the project's stopWhen configuration
+     */
+    setStopWhen(stopWhen: ProjectConfig['stopWhen']): void;
+    /**
+     * Get all graphs in the project
+     */
+    getGraphs(): AgentGraph[];
+    /**
+     * Get a graph by ID
+     */
+    getGraph(id: string): AgentGraph | undefined;
+    /**
+     * Add a graph to the project
+     */
+    addGraph(graph: AgentGraph): void;
+    /**
+     * Remove a graph from the project
+     */
+    removeGraph(id: string): boolean;
+    /**
+     * Get project statistics
+     */
+    getStats(): {
+        projectId: string;
+        tenantId: string;
+        graphCount: number;
+        initialized: boolean;
+    };
+    /**
+     * Validate the project configuration
+     */
+    validate(): {
+        valid: boolean;
+        errors: string[];
+    };
+    /**
+     * Convert the Project to FullProjectDefinition format
+     */
+    private toFullProjectDefinition;
+    /**
+     * Convert project configuration to API format
+     */
+    private toApiFormat;
+}
+
 /**
  * Helper function to create graphs - OpenAI style
  */
 declare function agentGraph(config: GraphConfig): AgentGraph;
+/**
+ * Helper function to create projects - OpenAI style
+ *
+ * Projects are the top-level organizational unit that contains graphs, agents, and shared configurations.
+ * They provide model inheritance and execution limits that cascade down to graphs and agents.
+ *
+ * @param config - Project configuration
+ * @returns A new Project instance
+ *
+ * @example
+ * ```typescript
+ * const customerSupport = project({
+ *   id: 'customer-support-project',
+ *   name: 'Customer Support System',
+ *   description: 'Multi-agent customer support system',
+ *   models: {
+ *     base: { model: 'gpt-4o-mini' },
+ *     structuredOutput: { model: 'gpt-4o' }
+ *   },
+ *   stopWhen: {
+ *     transferCountIs: 10,
+ *     stepCountIs: 50
+ *   },
+ *   graphs: () => [
+ *     agentGraph({
+ *       id: 'support-graph',
+ *       name: 'Support Graph',
+ *       // ... graph config
+ *     })
+ *   ]
+ * });
+ * ```
+ */
+declare function project(config: ProjectConfig): Project;
 /**
  * Creates a new agent with stable ID enforcement.
  *
@@ -879,6 +1069,28 @@ declare function createEnvironmentSettings<T extends Record<string, EnvironmentS
  */
 declare function registerEnvironmentSettings<T extends EnvironmentSettingsConfig>(config: T): T;
 
+/**
+ * Client-side functions for interacting with the Full Project API
+ * These functions make HTTP requests to the server instead of direct database calls
+ */
+
+/**
+ * Create a full project via HTTP API
+ */
+declare function createFullProjectViaAPI(tenantId: string, apiUrl: string, projectData: FullProjectDefinition): Promise<FullProjectDefinition>;
+/**
+ * Update a full project via HTTP API (upsert behavior)
+ */
+declare function updateFullProjectViaAPI(tenantId: string, apiUrl: string, projectId: string, projectData: FullProjectDefinition): Promise<FullProjectDefinition>;
+/**
+ * Get a full project via HTTP API
+ */
+declare function getFullProjectViaAPI(tenantId: string, apiUrl: string, projectId: string): Promise<FullProjectDefinition | null>;
+/**
+ * Delete a full project via HTTP API
+ */
+declare function deleteFullProjectViaAPI(tenantId: string, apiUrl: string, projectId: string): Promise<void>;
+
 declare class Runner {
     /**
      * Run a graph until completion, handling transfers and tool calls
@@ -916,4 +1128,4 @@ declare const run: typeof Runner.run;
 declare const stream: typeof Runner.stream;
 declare const raceGraphs: typeof Runner.raceGraphs;
 
-export { Agent, type AgentCanUseType, type AgentConfig, AgentError, type AgentInterface, type AgentResponse, type AllAgentInterface, ArtifactComponent, type AssistantMessage, type BuilderAgentConfig, type BuilderRelationConfig, type BuilderToolConfig, DataComponent, ExternalAgent, type ExternalAgentInterface, type FetchDefinitionConfig, type GenerateOptions, type GraphConfig, type GraphInterface, type MCPToolConfig, MaxTurnsExceededError, type Message, type MessageInput, type ModelSettings, ModelSettingsSchema, type RequestSchemaConfig, type RequestSchemaDefinition, type RunResult, Runner, type ServerConfig, type StatusComponent, type StatusUpdateSettings, type StreamEvent, type StreamResponse, type SystemMessage, Tool, type ToolCall, type ToolConfig, ToolExecutionError, type ToolMessage, type ToolResult, type TransferConfig, TransferError, type UserMessage, agent, agentGraph, agentMcp, artifactComponent, createEnvironmentSettings, credential, dataComponent, externalAgent, externalAgents, mcpServer, mcpTool, raceGraphs, registerEnvironmentSettings, run, stream, transfer };
+export { Agent, type AgentCanUseType, type AgentConfig, AgentError, type AgentInterface, type AgentResponse, type AllAgentInterface, ArtifactComponent, type AssistantMessage, type BuilderAgentConfig, type BuilderRelationConfig, type BuilderToolConfig, DataComponent, ExternalAgent, type ExternalAgentInterface, type FetchDefinitionConfig, type GenerateOptions, type GraphConfig, type GraphInterface, type MCPToolConfig, MaxTurnsExceededError, type Message, type MessageInput, type ModelSettings, ModelSettingsSchema, Project, type RequestSchemaConfig, type RequestSchemaDefinition, type RunResult, Runner, type ServerConfig, type StatusComponent, type StatusUpdateSettings, type StreamEvent, type StreamResponse, type SystemMessage, Tool, type ToolCall, type ToolConfig, ToolExecutionError, type ToolMessage, type ToolResult, type TransferConfig, TransferError, type UserMessage, agent, agentGraph, agentMcp, artifactComponent, createEnvironmentSettings, createFullProjectViaAPI, credential, dataComponent, deleteFullProjectViaAPI, externalAgent, externalAgents, getFullProjectViaAPI, mcpServer, mcpTool, project, raceGraphs, registerEnvironmentSettings, run, stream, transfer, updateFullProjectViaAPI };