@inkeep/agents-sdk 0.0.0-dev-20250910233133

package/dist/data-component.js

@@ -0,0 +1,114 @@
+import { generateIdFromName, getLogger, } from "@inkeep/agents-core";
+const logger = getLogger("dataComponent");
+export class DataComponent {
+    config;
+    baseURL;
+    tenantId;
+    projectId;
+    initialized = false;
+    id;
+    constructor(config) {
+        this.id = generateIdFromName(config.name);
+        this.config = {
+            ...config,
+            id: this.id,
+            tenantId: config.tenantId || "default",
+            projectId: config.projectId || "default",
+        };
+        this.baseURL = process.env.INKEEP_API_URL || "http://localhost:3002";
+        this.tenantId = this.config.tenantId;
+        this.projectId = this.config.projectId;
+        logger.info({
+            dataComponentId: this.getId(),
+            dataComponentName: config.name,
+        }, "DataComponent constructor initialized");
+    }
+    // Compute ID from name using same slug transformation as agents
+    getId() {
+        return this.id;
+    }
+    getName() {
+        return this.config.name;
+    }
+    getDescription() {
+        return this.config.description;
+    }
+    getProps() {
+        return this.config.props;
+    }
+    // Public method to ensure data component exists in backend (with upsert behavior)
+    async init() {
+        if (this.initialized)
+            return;
+        try {
+            // Always attempt to upsert the data component
+            await this.upsertDataComponent();
+            logger.info({
+                dataComponentId: this.getId(),
+            }, "DataComponent initialized successfully");
+            this.initialized = true;
+        }
+        catch (error) {
+            logger.error({
+                dataComponentId: this.getId(),
+                error: error instanceof Error ? error.message : "Unknown error",
+            }, "Failed to initialize data component");
+            throw error;
+        }
+    }
+    // Private method to upsert data component (create or update)
+    async upsertDataComponent() {
+        const dataComponentData = {
+            id: this.getId(),
+            name: this.config.name,
+            description: this.config.description,
+            props: this.config.props,
+        };
+        logger.info({ dataComponentData }, "dataComponentData for create/update");
+        // First try to update (in case data component exists)
+        const updateResponse = await fetch(`${this.baseURL}/tenants/${this.tenantId}/crud/data-components/${this.getId()}`, {
+            method: "PUT",
+            headers: {
+                "Content-Type": "application/json",
+            },
+            body: JSON.stringify(dataComponentData),
+        });
+        logger.info({
+            status: updateResponse.status,
+            dataComponentId: this.getId(),
+        }, "data component updateResponse");
+        if (updateResponse.ok) {
+            logger.info({
+                dataComponentId: this.getId(),
+            }, "DataComponent updated successfully");
+            return;
+        }
+        // If update failed with 404, data component doesn't exist - create it
+        if (updateResponse.status === 404) {
+            logger.info({
+                dataComponentId: this.getId(),
+            }, "DataComponent not found, creating new data component");
+            const createResponse = await fetch(`${this.baseURL}/tenants/${this.tenantId}/crud/data-components`, {
+                method: "POST",
+                headers: {
+                    "Content-Type": "application/json",
+                },
+                body: JSON.stringify(dataComponentData),
+            });
+            if (!createResponse.ok) {
+                const errorText = await createResponse
+                    .text()
+                    .catch(() => "Unknown error");
+                throw new Error(`Failed to create data component: ${createResponse.status} ${createResponse.statusText} - ${errorText}`);
+            }
+            logger.info({
+                dataComponentId: this.getId(),
+            }, "DataComponent created successfully");
+            return;
+        }
+        // If we get here, the update failed for some other reason
+        const errorText = await updateResponse.text().catch(() => "Unknown error");
+        throw new Error(`Failed to update data component: ${updateResponse.status} ${updateResponse.statusText} - ${errorText}`);
+    }
+}
+//# sourceMappingURL=data-component.js.map

package/dist/data-component.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-component.js","sourceRoot":"","sources":["../src/data-component.ts"],"names":[],"mappings":"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"}

package/dist/environment-settings.d.ts

@@ -0,0 +1,28 @@
+import type { CredentialReferenceApiInsert } from "@inkeep/agents-core";
+interface EnvironmentSettingsConfig {
+    credentials?: {
+        [settingId: string]: CredentialReferenceApiInsert;
+    };
+}
+export type ExtractSettingKeys<T> = T extends {
+    credentials: infer B;
+} ? B extends Record<string, any> ? keyof B : never : never;
+/**
+ * Get all registered setting keys across all environments
+ */
+export declare function getAllEnvironmentSettingKeys(): string[];
+/**
+ * Create a setting helper with TypeScript autocomplete
+ * Automatically infers environment names from object keys
+ */
+export declare function createEnvironmentSettings<T extends Record<string, EnvironmentSettingsConfig>>(environments: T): {
+    getEnvironmentSetting: <K extends string>(key: K) => Promise<CredentialReferenceApiInsert>;
+    getEnvironmentSettingKeys: () => string[];
+    hasEnvironmentSetting: (key: string) => key is string;
+};
+/**
+ * Create type-safe environment configurations with setting registration
+ */
+export declare function registerEnvironmentSettings<T extends EnvironmentSettingsConfig>(config: T): T;
+export {};
+//# sourceMappingURL=environment-settings.d.ts.map

package/dist/environment-settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment-settings.d.ts","sourceRoot":"","sources":["../src/environment-settings.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,qBAAqB,CAAC;AAExE,UAAU,yBAAyB;IAClC,WAAW,CAAC,EAAE;QACb,CAAC,SAAS,EAAE,MAAM,GAAG,4BAA4B,CAAC;KAClD,CAAC;CACF;AAGD,MAAM,MAAM,kBAAkB,CAAC,CAAC,IAAI,CAAC,SAAS;IAAE,WAAW,EAAE,MAAM,CAAC,CAAA;CAAE,GACnE,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAC5B,MAAM,CAAC,GACP,KAAK,GACN,KAAK,CAAC;AAYT;;GAEG;AACH,wBAAgB,4BAA4B,IAAI,MAAM,EAAE,CAEvD;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CACxC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,yBAAyB,CAAC,EAClD,YAAY,EAAE,CAAC;4BAUe,CAAC,sBACzB,CAAC,KACJ,OAAO,CAAC,4BAA4B,CAAC;qCA6BT,MAAM,EAAE;iCAmBV,MAAM,KAAG,GAAG,UAAe;EAczD;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAC1C,CAAC,SAAS,yBAAyB,EAClC,MAAM,EAAE,CAAC,GAAG,CAAC,CAQd"}

package/dist/environment-settings.js

@@ -0,0 +1,79 @@
+// Environment settings system for environment-agnostic entities management
+// Global registry to track all setting keys across environments
+const globalSettingKeys = new Set();
+/**
+ * Register setting keys globally for autocomplete and runtime access
+ */
+function registerSettingKeys(settingIds) {
+    settingIds.forEach((id) => globalSettingKeys.add(id));
+}
+/**
+ * Get all registered setting keys across all environments
+ */
+export function getAllEnvironmentSettingKeys() {
+    return Array.from(globalSettingKeys);
+}
+/**
+ * Create a setting helper with TypeScript autocomplete
+ * Automatically infers environment names from object keys
+ */
+export function createEnvironmentSettings(environments) {
+    // Keep environments in their original object structure
+    const environmentMap = environments;
+    const environmentNames = Object.keys(environments);
+    const allEnvironments = Object.values(environments);
+    return {
+        getEnvironmentSetting: async (key) => {
+            if (environmentNames.length === 0) {
+                throw new Error(`No environments provided to createEnvironmentSettings().\n\n` +
+                    `You must pass environments as an object: createEnvironmentSettings({ development, production })`);
+            }
+            const currentEnv = process.env.NODE_ENV || "development";
+            // Find environment that matches the current NODE_ENV exactly
+            const matchingEnv = environmentMap[currentEnv];
+            if (!matchingEnv) {
+                throw new Error(`Environment '${currentEnv}' not found.\n\n` +
+                    `Available environments: ${environmentNames.join(", ")}\n` +
+                    `Set NODE_ENV to one of the available environments or add a '${currentEnv}' environment.`);
+            }
+            if (!matchingEnv.credentials?.[key]) {
+                throw new Error(`Credential environment setting '${key}' not found in environment '${currentEnv}'.\n\n`);
+            }
+            return matchingEnv.credentials[key];
+        },
+        getEnvironmentSettingKeys: () => {
+            if (allEnvironments.length === 0)
+                return [];
+            if (allEnvironments.length === 1)
+                return Object.keys(allEnvironments[0].credentials || {});
+            // Multiple environments - intersection logic
+            let commonKeys = new Set(Object.keys(allEnvironments[0].credentials || {}));
+            for (let i = 1; i < allEnvironments.length; i++) {
+                const envKeys = new Set(Object.keys(allEnvironments[i].credentials || {}));
+                commonKeys = new Set([...commonKeys].filter((key) => envKeys.has(key)));
+            }
+            return Array.from(commonKeys);
+        },
+        hasEnvironmentSetting: (key) => {
+            if (allEnvironments.length === 0)
+                return false;
+            if (allEnvironments.length === 1)
+                return !!(allEnvironments[0].credentials &&
+                    key in allEnvironments[0].credentials);
+            // Multiple environments - must exist in ALL
+            return allEnvironments.every((env) => env.credentials && key in env.credentials);
+        },
+    };
+}
+/**
+ * Create type-safe environment configurations with setting registration
+ */
+export function registerEnvironmentSettings(config) {
+    // Register setting keys globally for autocomplete
+    if (config.credentials) {
+        const settingIds = Object.keys(config.credentials);
+        registerSettingKeys(settingIds);
+    }
+    return config;
+}
+//# sourceMappingURL=environment-settings.js.map

package/dist/environment-settings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment-settings.js","sourceRoot":"","sources":["../src/environment-settings.ts"],"names":[],"mappings":"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"}

package/dist/externalAgent.d.ts

@@ -0,0 +1,58 @@
+import type { CredentialReferenceSelect } from "@inkeep/agents-core";
+import type { ExternalAgentInterface } from "./types";
+export type ExternalAgentConfig = {
+    type?: "external";
+    tenantId?: string;
+    id: string;
+    name: string;
+    description: string;
+    baseUrl: string;
+    credentialReference?: CredentialReferenceSelect;
+    headers?: Record<string, string>;
+};
+export declare class ExternalAgent implements ExternalAgentInterface {
+    config: ExternalAgentConfig;
+    readonly type: "external";
+    private initialized;
+    private tenantId;
+    private baseURL;
+    constructor(config: ExternalAgentConfig);
+    /**
+     * Initialize the external agent by upserting it in the database
+     */
+    init(): Promise<void>;
+    getId(): string;
+    private upsertExternalAgent;
+    /**
+     * Get the external agent configuration
+     */
+    getConfig(): ExternalAgentConfig;
+    /**
+     * Get the external agent name
+     */
+    getName(): string;
+    /**
+     * Get the external agent base URL
+     */
+    getBaseUrl(): string;
+    /**
+     * Get the tenant ID
+     */
+    getTenantId(): string;
+    getDescription(): string;
+    getCredentialReferenceId(): string | undefined;
+    getHeaders(): Record<string, string> | undefined;
+}
+/**
+ * Factory function to create external agents - follows the same pattern as agent()
+ */
+export declare function externalAgent(config: ExternalAgentConfig): ExternalAgent;
+/**
+ * Helper function to create multiple external agents
+ */
+export declare function externalAgents(configs: Record<string, ExternalAgentConfig>): Record<string, ExternalAgent>;
+/**
+ * Helper to batch initialize external agents
+ */
+export declare function initializeExternalAgents(builders: ExternalAgent[]): Promise<void>;
+//# sourceMappingURL=externalAgent.d.ts.map

package/dist/externalAgent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"externalAgent.d.ts","sourceRoot":"","sources":["../src/externalAgent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAErE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAC;AAItD,MAAM,MAAM,mBAAmB,GAAG;IACjC,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,mBAAmB,CAAC,EAAE,yBAAyB,CAAC;IAChD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC,CAAC;AAEF,qBAAa,aAAc,YAAW,sBAAsB;IACpD,MAAM,EAAE,mBAAmB,CAAC;IACnC,SAAgB,IAAI,EAAG,UAAU,CAAU;IAC3C,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,OAAO,CAAS;gBAEZ,MAAM,EAAE,mBAAmB;IAevC;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IA4B3B,KAAK,IAAI,MAAM;YAKD,mBAAmB;IA6EjC;;OAEG;IACH,SAAS,IAAI,mBAAmB;IAIhC;;OAEG;IACH,OAAO,IAAI,MAAM;IAIjB;;OAEG;IACH,UAAU,IAAI,MAAM;IAIpB;;OAEG;IACH,WAAW,IAAI,MAAM;IAIrB,cAAc,IAAI,MAAM;IAIxB,wBAAwB,IAAI,MAAM,GAAG,SAAS;IAI9C,UAAU,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS;CAGhD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,mBAAmB,GAAG,aAAa,CAExE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC7B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,GAC1C,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAQ/B;AAED;;GAEG;AACH,wBAAsB,wBAAwB,CAC7C,QAAQ,EAAE,aAAa,EAAE,GACvB,OAAO,CAAC,IAAI,CAAC,CAqBf"}

package/dist/externalAgent.js

@@ -0,0 +1,163 @@
+import { getLogger } from "@inkeep/agents-core";
+const logger = getLogger("external-agent-builder");
+export class ExternalAgent {
+    config;
+    type = "external";
+    initialized = false;
+    tenantId;
+    baseURL;
+    constructor(config) {
+        this.config = { ...config, type: "external" };
+        this.tenantId = config.tenantId || "default";
+        this.baseURL = process.env.INKEEP_API_URL || "http://localhost:3002";
+        logger.debug({
+            externalAgentName: this.config.name,
+            baseUrl: this.config.baseUrl,
+            tenantId: this.config.tenantId,
+        }, "External Agent constructor initialized");
+    }
+    /**
+     * Initialize the external agent by upserting it in the database
+     */
+    async init() {
+        if (this.initialized)
+            return;
+        try {
+            // Always attempt to upsert the external agent
+            await this.upsertExternalAgent();
+            logger.info({
+                externalAgentId: this.getId(),
+            }, "External agent initialized successfully");
+            this.initialized = true;
+        }
+        catch (error) {
+            logger.error({
+                externalAgentId: this.getId(),
+                error: error instanceof Error ? error.message : "Unknown error",
+            }, "Failed to initialize external agent");
+            throw error;
+        }
+    }
+    // Compute ID from name using a simple slug transformation
+    getId() {
+        return this.config.id;
+    }
+    // Private method to upsert external agent (create or update)
+    async upsertExternalAgent() {
+        const externalAgentData = {
+            id: this.getId(),
+            name: this.config.name,
+            description: this.config.description,
+            baseUrl: this.config.baseUrl,
+            credentialReferenceId: this.config.credentialReference?.id || undefined,
+            headers: this.config.headers || undefined,
+        };
+        // First try to update (in case external agent exists)
+        const updateResponse = await fetch(`${this.baseURL}/tenants/${this.tenantId}/crud/external-agents/${this.getId()}`, {
+            method: "PUT",
+            headers: {
+                "Content-Type": "application/json",
+            },
+            body: JSON.stringify(externalAgentData),
+        });
+        if (updateResponse.ok) {
+            logger.info({
+                externalAgentId: this.getId(),
+            }, "External agent updated successfully");
+            return;
+        }
+        // If update failed with 404, external agent doesn't exist - create it
+        if (updateResponse.status === 404) {
+            logger.info({
+                externalAgentId: this.getId(),
+            }, "External agent not found, creating new external agent");
+            const createResponse = await fetch(`${this.baseURL}/tenants/${this.tenantId}/crud/external-agents`, {
+                method: "POST",
+                headers: {
+                    "Content-Type": "application/json",
+                },
+                body: JSON.stringify(externalAgentData),
+            });
+            if (!createResponse.ok) {
+                const errorText = await createResponse
+                    .text()
+                    .catch(() => "Unknown error");
+                throw new Error(`Failed to create external agent: ${createResponse.status} ${createResponse.statusText} - ${errorText}`);
+            }
+            logger.info({
+                externalAgentId: this.getId(),
+            }, "External agent created successfully");
+            return;
+        }
+        // Update failed for some other reason
+        const errorText = await updateResponse.text().catch(() => "Unknown error");
+        throw new Error(`Failed to update external agent: ${updateResponse.status} ${updateResponse.statusText} - ${errorText}`);
+    }
+    /**
+     * Get the external agent configuration
+     */
+    getConfig() {
+        return { ...this.config };
+    }
+    /**
+     * Get the external agent name
+     */
+    getName() {
+        return this.config.name;
+    }
+    /**
+     * Get the external agent base URL
+     */
+    getBaseUrl() {
+        return this.config.baseUrl;
+    }
+    /**
+     * Get the tenant ID
+     */
+    getTenantId() {
+        return this.tenantId;
+    }
+    getDescription() {
+        return this.config.description || "";
+    }
+    getCredentialReferenceId() {
+        return this.config.credentialReference?.id || undefined;
+    }
+    getHeaders() {
+        return this.config.headers;
+    }
+}
+/**
+ * Factory function to create external agents - follows the same pattern as agent()
+ */
+export function externalAgent(config) {
+    return new ExternalAgent(config);
+}
+/**
+ * Helper function to create multiple external agents
+ */
+export function externalAgents(configs) {
+    const builders = {};
+    for (const [name, config] of Object.entries(configs)) {
+        builders[name] = externalAgent(config);
+    }
+    return builders;
+}
+/**
+ * Helper to batch initialize external agents
+ */
+export async function initializeExternalAgents(builders) {
+    logger.info({ count: builders.length }, "Batch initializing external agents");
+    const initPromises = builders.map(async (builder) => {
+        return await builder.init();
+    });
+    try {
+        await Promise.all(initPromises);
+        logger.info({ count: builders.length }, "All external agents initialized successfully");
+    }
+    catch (error) {
+        logger.error({ error: error instanceof Error ? error.message : "Unknown error" }, "Failed to initialize some external agents");
+        throw error;
+    }
+}
+//# sourceMappingURL=externalAgent.js.map

package/dist/externalAgent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"externalAgent.js","sourceRoot":"","sources":["../src/externalAgent.ts"],"names":[],"mappings":"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"}

package/dist/graph.d.ts

@@ -0,0 +1,200 @@
+import type { AgentInterface, AllAgentInterface, ExternalAgentInterface, GenerateOptions, GraphConfig, GraphInterface, MessageInput, ModelSettings, RunResult, StatusUpdateSettings, StreamResponse } from "./types";
+export declare class AgentGraph implements GraphInterface {
+    private agents;
+    private agentMap;
+    private defaultAgent?;
+    private baseURL;
+    private tenantId;
+    private projectId;
+    private graphId;
+    private graphName;
+    private graphDescription?;
+    private initialized;
+    private contextConfig?;
+    private credentials?;
+    private models?;
+    private statusUpdateSettings?;
+    private graphPrompt?;
+    private stopWhen?;
+    private dbClient;
+    constructor(config: GraphConfig);
+    /**
+     * Set or update the configuration (tenantId, projectId and apiUrl)
+     * This is used by the CLI to inject configuration from inkeep.config.ts
+     */
+    setConfig(tenantId: string, projectId: string, apiUrl: string): void;
+    /**
+     * Convert the AgentGraph to FullGraphDefinition format for the new graph endpoint
+     */
+    private toFullGraphDefinition;
+    /**
+     * Initialize all tools in all agents (especially IPCTools that need MCP server URLs)
+     */
+    private initializeAllTools;
+    /**
+     * Initialize the graph and all agents in the backend using the new graph endpoint
+     */
+    init(): Promise<void>;
+    /**
+     * Legacy initialization method - kept for backward compatibility
+     * Initialize the graph and all agents in the backend using individual endpoints
+     */
+    initLegacy(): Promise<void>;
+    /**
+     * Generate a response using the default agent
+     */
+    generate(input: MessageInput, options?: GenerateOptions): Promise<string>;
+    /**
+     * Stream a response using the default agent
+     */
+    stream(input: MessageInput, options?: GenerateOptions): Promise<StreamResponse>;
+    /**
+     * Alias for stream() method for consistency with naming patterns
+     */
+    generateStream(input: MessageInput, options?: GenerateOptions): Promise<StreamResponse>;
+    /**
+     * Run with a specific agent from the graph
+     */
+    runWith(agentId: string, input: MessageInput, options?: GenerateOptions): Promise<RunResult>;
+    /**
+     * Get an agent by name (unified method for all agent types)
+     */
+    getAgent(name: string): AllAgentInterface | undefined;
+    /**
+     * Add an agent to the graph
+     */
+    addAgent(agent: AgentInterface): void;
+    /**
+     * Remove an agent from the graph
+     */
+    removeAgent(id: string): boolean;
+    /**
+     * Get all agents in the graph
+     */
+    getAgents(): AllAgentInterface[];
+    /**
+     * Get all agent ids (unified method for all agent types)
+     */
+    getAgentIds(): string[];
+    /**
+     * Set the default agent
+     */
+    setDefaultAgent(agent: AgentInterface): void;
+    /**
+     * Get the default agent
+     */
+    getDefaultAgent(): AgentInterface | undefined;
+    /**
+     * Get the graph ID
+     */
+    getId(): string;
+    getName(): string;
+    getDescription(): string | undefined;
+    getTenantId(): string;
+    /**
+     * Get the graph's model settingsuration
+     */
+    getModels(): typeof this.models;
+    /**
+     * Set the graph's model settingsuration
+     */
+    setModels(models: typeof this.models): void;
+    /**
+     * Get the graph's prompt configuration
+     */
+    getGraphPrompt(): string | undefined;
+    /**
+     * Get the graph's stopWhen configuration
+     */
+    getStopWhen(): {
+        transferCountIs?: number;
+    };
+    /**
+     * Get the graph's status updates configuration
+     */
+    getStatusUpdateSettings(): StatusUpdateSettings | undefined;
+    /**
+     * Get the summarizer model from the graph's model settings
+     */
+    getSummarizerModel(): ModelSettings | undefined;
+    /**
+     * Get graph statistics
+     */
+    getStats(): {
+        agentCount: number;
+        defaultAgent: string | null;
+        initialized: boolean;
+        graphId: string;
+        tenantId: string;
+    };
+    /**
+     * Validate the graph configuration
+     */
+    validate(): {
+        valid: boolean;
+        errors: string[];
+    };
+    private _init;
+    /**
+     * Type guard to check if an agent is an internal AgentInterface
+     */
+    isInternalAgent(agent: AllAgentInterface): agent is AgentInterface;
+    /**
+     * Get project-level model settingsuration defaults
+     */
+    private getProjectModelDefaults;
+    /**
+     * Get project-level stopWhen configuration defaults
+     */
+    private getProjectStopWhenDefaults;
+    /**
+     * Apply model inheritance hierarchy: Project -> Graph -> Agent
+     */
+    private applyModelInheritance;
+    /**
+     * Apply stopWhen inheritance hierarchy: Project -> Graph -> Agent
+     */
+    private applyStopWhenInheritance;
+    /**
+     * Propagate graph-level model settings to agents (supporting partial inheritance)
+     */
+    private propagateModelSettingsToAgent;
+    /**
+     * Immediately propagate graph-level models to all agents during construction
+     */
+    private propagateImmediateModelSettings;
+    /**
+     * Type guard to check if an agent is an external AgentInterface
+     */
+    isExternalAgent(agent: AllAgentInterface): agent is ExternalAgentInterface;
+    /**
+     * Execute agent using the backend system instead of local runner
+     */
+    private executeWithBackend;
+    /**
+     * Parse streaming response in SSE format
+     */
+    private parseStreamingResponse;
+    /**
+     * Normalize input messages to the expected format
+     */
+    private normalizeMessages;
+    private saveToDatabase;
+    private saveRelations;
+    private createAgentRelations;
+    private createInternalAgentRelation;
+    private createExternalAgentRelation;
+    /**
+     * Create external agents in the database
+     */
+    private createExternalAgents;
+}
+/**
+ * Helper function to create graphs - OpenAI style
+ */
+export declare function agentGraph(config: GraphConfig): AgentGraph;
+/**
+ * Factory function to create graph from configuration file
+ */
+export declare function generateGraph(configPath: string): Promise<AgentGraph>;
+//# sourceMappingURL=graph.d.ts.map