@inkeep/agents-sdk 0.6.4 → 0.6.6

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { MCPToolConfig as MCPToolConfig$1, CredentialReferenceApiInsert, CredentialReferenceSelect, DataComponentInsert, ArtifactComponentInsert, AgentApiInsert, AgentStopWhen, DataComponentApiInsert, ArtifactComponentApiInsert, AgentConversationHistoryConfig, GraphStopWhen, StatusUpdateSettings, ToolInsert, McpTransportConfig, StopWhen, FullProjectDefinition } from '@inkeep/agents-core';
+import { MCPToolConfig as MCPToolConfig$1, ArtifactComponentInsert, CredentialReferenceApiInsert, DataComponentInsert, CredentialReferenceSelect, AgentApiInsert, AgentStopWhen, DataComponentApiInsert, ArtifactComponentApiInsert, AgentConversationHistoryConfig, GraphStopWhen, StatusUpdateSettings, FullGraphDefinition, ToolInsert, McpTransportConfig, StopWhen, FullProjectDefinition } from '@inkeep/agents-core';
 import { z } from 'zod';
 
 interface ToolInterface {
@@ -31,6 +31,34 @@ declare class Tool implements ToolInterface {
     private upsertTool;
 }
 
+interface ArtifactComponentInterface {
+    config: Omit<ArtifactComponentInsert, 'tenantId' | 'projectId'>;
+    init(): Promise<void>;
+    getId(): ArtifactComponentInsert['id'];
+    getName(): ArtifactComponentInsert['name'];
+    getDescription(): ArtifactComponentInsert['description'];
+    getSummaryProps(): ArtifactComponentInsert['summaryProps'];
+    getFullProps(): ArtifactComponentInsert['fullProps'];
+    setContext(tenantId: string, projectId: string): void;
+}
+declare class ArtifactComponent implements ArtifactComponentInterface {
+    config: Omit<ArtifactComponentInsert, 'tenantId' | 'projectId'>;
+    private baseURL;
+    private tenantId;
+    private projectId;
+    private initialized;
+    private id;
+    constructor(config: Omit<ArtifactComponentInsert, 'tenantId' | 'projectId'>);
+    setContext(tenantId: string, projectId: string): void;
+    getId(): string;
+    getName(): string;
+    getDescription(): string;
+    getSummaryProps(): ArtifactComponentInsert['summaryProps'];
+    getFullProps(): ArtifactComponentInsert['fullProps'];
+    init(): Promise<void>;
+    private upsertArtifactComponent;
+}
+
 /**
  * Function signature for transfer conditions
  */
@@ -95,6 +123,32 @@ type AgentMcpConfig = {
  */
 declare function transfer(targetAgent: Agent, description?: string, condition?: TransferConditionFunction): TransferConfig;
 
+interface DataComponentInterface {
+    config: Omit<DataComponentInsert, 'tenantId' | 'projectId'>;
+    init(): Promise<void>;
+    getId(): DataComponentInsert['id'];
+    getName(): DataComponentInsert['name'];
+    getDescription(): DataComponentInsert['description'];
+    getProps(): DataComponentInsert['props'];
+    setContext(tenantId: string, projectId: string): void;
+}
+declare class DataComponent implements DataComponentInterface {
+    config: Omit<DataComponentInsert, 'tenantId' | 'projectId'>;
+    private baseURL;
+    private tenantId;
+    private projectId;
+    private initialized;
+    private id;
+    constructor(config: Omit<DataComponentInsert, 'tenantId' | 'projectId'>);
+    setContext(tenantId: string, projectId: string): void;
+    getId(): string;
+    getName(): string;
+    getDescription(): string;
+    getProps(): DataComponentInsert['props'];
+    init(): Promise<void>;
+    private upsertDataComponent;
+}
+
 type ExternalAgentConfig = {
     type?: 'external';
     id: string;
@@ -147,60 +201,12 @@ declare function externalAgent(config: ExternalAgentConfig): ExternalAgent;
  */
 declare function externalAgents(configs: Record<string, ExternalAgentConfig>): Record<string, ExternalAgent>;
 
-interface DataComponentInterface {
-    config: Omit<DataComponentInsert, 'tenantId' | 'projectId'>;
-    init(): Promise<void>;
-    getId(): DataComponentInsert['id'];
-    getName(): DataComponentInsert['name'];
-    getDescription(): DataComponentInsert['description'];
-    getProps(): DataComponentInsert['props'];
-    setContext(tenantId: string, projectId: string): void;
-}
-declare class DataComponent implements DataComponentInterface {
-    config: Omit<DataComponentInsert, 'tenantId' | 'projectId'>;
-    private baseURL;
-    private tenantId;
-    private projectId;
-    private initialized;
-    private id;
-    constructor(config: Omit<DataComponentInsert, 'tenantId' | 'projectId'>);
-    setContext(tenantId: string, projectId: string): void;
-    getId(): string;
-    getName(): string;
-    getDescription(): string;
-    getProps(): DataComponentInsert['props'];
-    init(): Promise<void>;
-    private upsertDataComponent;
-}
-
-interface ArtifactComponentInterface {
-    config: Omit<ArtifactComponentInsert, 'tenantId' | 'projectId'>;
-    init(): Promise<void>;
-    getId(): ArtifactComponentInsert['id'];
-    getName(): ArtifactComponentInsert['name'];
-    getDescription(): ArtifactComponentInsert['description'];
-    getSummaryProps(): ArtifactComponentInsert['summaryProps'];
-    getFullProps(): ArtifactComponentInsert['fullProps'];
-    setContext(tenantId: string, projectId: string): void;
-}
-declare class ArtifactComponent implements ArtifactComponentInterface {
-    config: Omit<ArtifactComponentInsert, 'tenantId' | 'projectId'>;
-    private baseURL;
-    private tenantId;
-    private projectId;
-    private initialized;
-    private id;
-    constructor(config: Omit<ArtifactComponentInsert, 'tenantId' | 'projectId'>);
-    setContext(tenantId: string, projectId: string): void;
-    getId(): string;
-    getName(): string;
-    getDescription(): string;
-    getSummaryProps(): ArtifactComponentInsert['summaryProps'];
-    getFullProps(): ArtifactComponentInsert['fullProps'];
-    init(): Promise<void>;
-    private upsertArtifactComponent;
-}
-
+/**
+ * Tool instance that may have additional metadata attached during agent processing
+ */
+type AgentTool = Tool & {
+    selectedTools?: string[];
+};
 interface UserMessage {
     role: 'user';
     content: string;
@@ -401,7 +407,7 @@ interface AgentInterface {
     getName(): string;
     getDescription(): string;
     getInstructions(): string;
-    getTools(): Record<string, any>;
+    getTools(): Record<string, AgentTool>;
     getTransfers(): AgentInterface[];
     getDelegates(): AllAgentInterface[];
     getDataComponents(): DataComponentApiInsert[];
@@ -436,6 +442,7 @@ interface GraphInterface {
     getDefaultAgent(): AgentInterface | undefined;
     getAgent(name: string): AllAgentInterface | undefined;
     getAgents(): AllAgentInterface[];
+    toFullGraphDefinition(): Promise<FullGraphDefinition>;
 }
 interface BuilderToolConfig {
     name: string;
@@ -478,7 +485,7 @@ declare class Agent implements AgentInterface {
      * Get the agent's description (the human-readable description field)
      */
     getDescription(): string;
-    getTools(): Record<string, unknown>;
+    getTools(): Record<string, AgentTool>;
     getModels(): typeof this$1.config.models;
     setModels(models: typeof this$1.config.models): void;
     getTransfers(): AgentInterface[];
@@ -530,7 +537,7 @@ declare class AgentGraph implements GraphInterface {
     /**
      * Convert the AgentGraph to FullGraphDefinition format for the new graph endpoint
      */
-    private toFullGraphDefinition;
+    toFullGraphDefinition(): Promise<FullGraphDefinition>;
     /**
      * Initialize all tools in all agents (especially IPCTools that need MCP server URLs)
      */
@@ -1185,4 +1192,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 ArtifactComponentInterface, type AssistantMessage, type BuilderAgentConfig, type BuilderRelationConfig, type BuilderToolConfig, type CredentialReference, DataComponent, type DataComponentInterface, ExternalAgent, type ExternalAgentInterface, type ExtractCredentialIds, 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 StreamEvent, type StreamResponse, type SystemMessage, Tool, type ToolCall, type ToolConfig, ToolExecutionError, type ToolMessage, type ToolResult, type TransferConfig, TransferError, type UnionCredentialIds, type UserMessage, agent, agentGraph, agentMcp, artifactComponent, createEnvironmentSettings, createFullProjectViaAPI, credential, credentialRef, dataComponent, deleteFullProjectViaAPI, externalAgent, externalAgents, getFullProjectViaAPI, isCredentialReference, mcpServer, mcpTool, project, raceGraphs, registerEnvironmentSettings, run, stream, transfer, updateFullProjectViaAPI };
+export { Agent, type AgentCanUseType, type AgentConfig, AgentError, type AgentInterface, type AgentResponse, type AgentTool, type AllAgentInterface, ArtifactComponent, type ArtifactComponentInterface, type AssistantMessage, type BuilderAgentConfig, type BuilderRelationConfig, type BuilderToolConfig, type CredentialReference, DataComponent, type DataComponentInterface, ExternalAgent, type ExternalAgentInterface, type ExtractCredentialIds, 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 StreamEvent, type StreamResponse, type SystemMessage, Tool, type ToolCall, type ToolConfig, ToolExecutionError, type ToolMessage, type ToolResult, type TransferConfig, TransferError, type UnionCredentialIds, type UserMessage, agent, agentGraph, agentMcp, artifactComponent, createEnvironmentSettings, createFullProjectViaAPI, credential, credentialRef, dataComponent, deleteFullProjectViaAPI, externalAgent, externalAgents, getFullProjectViaAPI, isCredentialReference, mcpServer, mcpTool, project, raceGraphs, registerEnvironmentSettings, run, stream, transfer, updateFullProjectViaAPI };

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { MCPToolConfig as MCPToolConfig$1, CredentialReferenceApiInsert, CredentialReferenceSelect, DataComponentInsert, ArtifactComponentInsert, AgentApiInsert, AgentStopWhen, DataComponentApiInsert, ArtifactComponentApiInsert, AgentConversationHistoryConfig, GraphStopWhen, StatusUpdateSettings, ToolInsert, McpTransportConfig, StopWhen, FullProjectDefinition } from '@inkeep/agents-core';
+import { MCPToolConfig as MCPToolConfig$1, ArtifactComponentInsert, CredentialReferenceApiInsert, DataComponentInsert, CredentialReferenceSelect, AgentApiInsert, AgentStopWhen, DataComponentApiInsert, ArtifactComponentApiInsert, AgentConversationHistoryConfig, GraphStopWhen, StatusUpdateSettings, FullGraphDefinition, ToolInsert, McpTransportConfig, StopWhen, FullProjectDefinition } from '@inkeep/agents-core';
 import { z } from 'zod';
 
 interface ToolInterface {
@@ -31,6 +31,34 @@ declare class Tool implements ToolInterface {
     private upsertTool;
 }
 
+interface ArtifactComponentInterface {
+    config: Omit<ArtifactComponentInsert, 'tenantId' | 'projectId'>;
+    init(): Promise<void>;
+    getId(): ArtifactComponentInsert['id'];
+    getName(): ArtifactComponentInsert['name'];
+    getDescription(): ArtifactComponentInsert['description'];
+    getSummaryProps(): ArtifactComponentInsert['summaryProps'];
+    getFullProps(): ArtifactComponentInsert['fullProps'];
+    setContext(tenantId: string, projectId: string): void;
+}
+declare class ArtifactComponent implements ArtifactComponentInterface {
+    config: Omit<ArtifactComponentInsert, 'tenantId' | 'projectId'>;
+    private baseURL;
+    private tenantId;
+    private projectId;
+    private initialized;
+    private id;
+    constructor(config: Omit<ArtifactComponentInsert, 'tenantId' | 'projectId'>);
+    setContext(tenantId: string, projectId: string): void;
+    getId(): string;
+    getName(): string;
+    getDescription(): string;
+    getSummaryProps(): ArtifactComponentInsert['summaryProps'];
+    getFullProps(): ArtifactComponentInsert['fullProps'];
+    init(): Promise<void>;
+    private upsertArtifactComponent;
+}
+
 /**
  * Function signature for transfer conditions
  */
@@ -95,6 +123,32 @@ type AgentMcpConfig = {
  */
 declare function transfer(targetAgent: Agent, description?: string, condition?: TransferConditionFunction): TransferConfig;
 
+interface DataComponentInterface {
+    config: Omit<DataComponentInsert, 'tenantId' | 'projectId'>;
+    init(): Promise<void>;
+    getId(): DataComponentInsert['id'];
+    getName(): DataComponentInsert['name'];
+    getDescription(): DataComponentInsert['description'];
+    getProps(): DataComponentInsert['props'];
+    setContext(tenantId: string, projectId: string): void;
+}
+declare class DataComponent implements DataComponentInterface {
+    config: Omit<DataComponentInsert, 'tenantId' | 'projectId'>;
+    private baseURL;
+    private tenantId;
+    private projectId;
+    private initialized;
+    private id;
+    constructor(config: Omit<DataComponentInsert, 'tenantId' | 'projectId'>);
+    setContext(tenantId: string, projectId: string): void;
+    getId(): string;
+    getName(): string;
+    getDescription(): string;
+    getProps(): DataComponentInsert['props'];
+    init(): Promise<void>;
+    private upsertDataComponent;
+}
+
 type ExternalAgentConfig = {
     type?: 'external';
     id: string;
@@ -147,60 +201,12 @@ declare function externalAgent(config: ExternalAgentConfig): ExternalAgent;
  */
 declare function externalAgents(configs: Record<string, ExternalAgentConfig>): Record<string, ExternalAgent>;
 
-interface DataComponentInterface {
-    config: Omit<DataComponentInsert, 'tenantId' | 'projectId'>;
-    init(): Promise<void>;
-    getId(): DataComponentInsert['id'];
-    getName(): DataComponentInsert['name'];
-    getDescription(): DataComponentInsert['description'];
-    getProps(): DataComponentInsert['props'];
-    setContext(tenantId: string, projectId: string): void;
-}
-declare class DataComponent implements DataComponentInterface {
-    config: Omit<DataComponentInsert, 'tenantId' | 'projectId'>;
-    private baseURL;
-    private tenantId;
-    private projectId;
-    private initialized;
-    private id;
-    constructor(config: Omit<DataComponentInsert, 'tenantId' | 'projectId'>);
-    setContext(tenantId: string, projectId: string): void;
-    getId(): string;
-    getName(): string;
-    getDescription(): string;
-    getProps(): DataComponentInsert['props'];
-    init(): Promise<void>;
-    private upsertDataComponent;
-}
-
-interface ArtifactComponentInterface {
-    config: Omit<ArtifactComponentInsert, 'tenantId' | 'projectId'>;
-    init(): Promise<void>;
-    getId(): ArtifactComponentInsert['id'];
-    getName(): ArtifactComponentInsert['name'];
-    getDescription(): ArtifactComponentInsert['description'];
-    getSummaryProps(): ArtifactComponentInsert['summaryProps'];
-    getFullProps(): ArtifactComponentInsert['fullProps'];
-    setContext(tenantId: string, projectId: string): void;
-}
-declare class ArtifactComponent implements ArtifactComponentInterface {
-    config: Omit<ArtifactComponentInsert, 'tenantId' | 'projectId'>;
-    private baseURL;
-    private tenantId;
-    private projectId;
-    private initialized;
-    private id;
-    constructor(config: Omit<ArtifactComponentInsert, 'tenantId' | 'projectId'>);
-    setContext(tenantId: string, projectId: string): void;
-    getId(): string;
-    getName(): string;
-    getDescription(): string;
-    getSummaryProps(): ArtifactComponentInsert['summaryProps'];
-    getFullProps(): ArtifactComponentInsert['fullProps'];
-    init(): Promise<void>;
-    private upsertArtifactComponent;
-}
-
+/**
+ * Tool instance that may have additional metadata attached during agent processing
+ */
+type AgentTool = Tool & {
+    selectedTools?: string[];
+};
 interface UserMessage {
     role: 'user';
     content: string;
@@ -401,7 +407,7 @@ interface AgentInterface {
     getName(): string;
     getDescription(): string;
     getInstructions(): string;
-    getTools(): Record<string, any>;
+    getTools(): Record<string, AgentTool>;
     getTransfers(): AgentInterface[];
     getDelegates(): AllAgentInterface[];
     getDataComponents(): DataComponentApiInsert[];
@@ -436,6 +442,7 @@ interface GraphInterface {
     getDefaultAgent(): AgentInterface | undefined;
     getAgent(name: string): AllAgentInterface | undefined;
     getAgents(): AllAgentInterface[];
+    toFullGraphDefinition(): Promise<FullGraphDefinition>;
 }
 interface BuilderToolConfig {
     name: string;
@@ -478,7 +485,7 @@ declare class Agent implements AgentInterface {
      * Get the agent's description (the human-readable description field)
      */
     getDescription(): string;
-    getTools(): Record<string, unknown>;
+    getTools(): Record<string, AgentTool>;
     getModels(): typeof this$1.config.models;
     setModels(models: typeof this$1.config.models): void;
     getTransfers(): AgentInterface[];
@@ -530,7 +537,7 @@ declare class AgentGraph implements GraphInterface {
     /**
      * Convert the AgentGraph to FullGraphDefinition format for the new graph endpoint
      */
-    private toFullGraphDefinition;
+    toFullGraphDefinition(): Promise<FullGraphDefinition>;
     /**
      * Initialize all tools in all agents (especially IPCTools that need MCP server URLs)
      */
@@ -1185,4 +1192,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 ArtifactComponentInterface, type AssistantMessage, type BuilderAgentConfig, type BuilderRelationConfig, type BuilderToolConfig, type CredentialReference, DataComponent, type DataComponentInterface, ExternalAgent, type ExternalAgentInterface, type ExtractCredentialIds, 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 StreamEvent, type StreamResponse, type SystemMessage, Tool, type ToolCall, type ToolConfig, ToolExecutionError, type ToolMessage, type ToolResult, type TransferConfig, TransferError, type UnionCredentialIds, type UserMessage, agent, agentGraph, agentMcp, artifactComponent, createEnvironmentSettings, createFullProjectViaAPI, credential, credentialRef, dataComponent, deleteFullProjectViaAPI, externalAgent, externalAgents, getFullProjectViaAPI, isCredentialReference, mcpServer, mcpTool, project, raceGraphs, registerEnvironmentSettings, run, stream, transfer, updateFullProjectViaAPI };
+export { Agent, type AgentCanUseType, type AgentConfig, AgentError, type AgentInterface, type AgentResponse, type AgentTool, type AllAgentInterface, ArtifactComponent, type ArtifactComponentInterface, type AssistantMessage, type BuilderAgentConfig, type BuilderRelationConfig, type BuilderToolConfig, type CredentialReference, DataComponent, type DataComponentInterface, ExternalAgent, type ExternalAgentInterface, type ExtractCredentialIds, 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 StreamEvent, type StreamResponse, type SystemMessage, Tool, type ToolCall, type ToolConfig, ToolExecutionError, type ToolMessage, type ToolResult, type TransferConfig, TransferError, type UnionCredentialIds, type UserMessage, agent, agentGraph, agentMcp, artifactComponent, createEnvironmentSettings, createFullProjectViaAPI, credential, credentialRef, dataComponent, deleteFullProjectViaAPI, externalAgent, externalAgents, getFullProjectViaAPI, isCredentialReference, mcpServer, mcpTool, project, raceGraphs, registerEnvironmentSettings, run, stream, transfer, updateFullProjectViaAPI };