@inkeep/agents-core 0.1.0

package/dist/data-access/agentGraphs.d.ts

@@ -0,0 +1,406 @@
+import type { DatabaseClient } from '../db/client.js';
+import type { AgentGraphInsert, AgentGraphUpdate, FullGraphDefinition } from '../types/entities.js';
+import type { PaginationConfig, ScopeConfig } from '../types/utility.js';
+export declare const getAgentGraph: (db: DatabaseClient) => (params: {
+    scopes: ScopeConfig;
+    graphId: string;
+}) => Promise<{
+    tenantId: string;
+    projectId: string;
+    id: string;
+    name: string;
+    description: string | null;
+    createdAt: string;
+    updatedAt: string;
+    defaultAgentId: string;
+    models: {
+        base?: {
+            model?: string | undefined;
+            providerOptions?: Record<string, Record<string, unknown>> | undefined;
+        } | undefined;
+        structuredOutput?: {
+            model?: string | undefined;
+            providerOptions?: Record<string, Record<string, unknown>> | undefined;
+        } | undefined;
+        summarizer?: {
+            model?: string | undefined;
+            providerOptions?: Record<string, Record<string, unknown>> | undefined;
+        } | undefined;
+    } | null;
+    stopWhen: {
+        handoffCountIs?: number;
+    } | null;
+    graphPrompt: string | null;
+    statusUpdates: {
+        enabled?: boolean | undefined;
+        numEvents?: number | undefined;
+        timeInSeconds?: number | undefined;
+        prompt?: string | undefined;
+        statusComponents?: {
+            id: string;
+            name: string;
+            schema: {
+                type: "object";
+                properties: Record<string, any>;
+                required?: string[] | undefined;
+            };
+            description?: string | undefined;
+        }[] | undefined;
+    } | null;
+    contextConfigId: string | null;
+} | undefined>;
+export declare const getAgentGraphById: (db: DatabaseClient) => (params: {
+    scopes: ScopeConfig;
+    graphId: string;
+}) => Promise<{
+    tenantId: string;
+    projectId: string;
+    id: string;
+    name: string;
+    description: string | null;
+    createdAt: string;
+    updatedAt: string;
+    defaultAgentId: string;
+    models: {
+        base?: {
+            model?: string | undefined;
+            providerOptions?: Record<string, Record<string, unknown>> | undefined;
+        } | undefined;
+        structuredOutput?: {
+            model?: string | undefined;
+            providerOptions?: Record<string, Record<string, unknown>> | undefined;
+        } | undefined;
+        summarizer?: {
+            model?: string | undefined;
+            providerOptions?: Record<string, Record<string, unknown>> | undefined;
+        } | undefined;
+    } | null;
+    stopWhen: {
+        handoffCountIs?: number;
+    } | null;
+    graphPrompt: string | null;
+    statusUpdates: {
+        enabled?: boolean | undefined;
+        numEvents?: number | undefined;
+        timeInSeconds?: number | undefined;
+        prompt?: string | undefined;
+        statusComponents?: {
+            id: string;
+            name: string;
+            schema: {
+                type: "object";
+                properties: Record<string, any>;
+                required?: string[] | undefined;
+            };
+            description?: string | undefined;
+        }[] | undefined;
+    } | null;
+    contextConfigId: string | null;
+} | null>;
+export declare const getAgentGraphWithDefaultAgent: (db: DatabaseClient) => (params: {
+    scopes: ScopeConfig;
+    graphId: string;
+}) => Promise<{
+    tenantId: string;
+    projectId: string;
+    id: string;
+    name: string;
+    description: string | null;
+    createdAt: string;
+    updatedAt: string;
+    defaultAgentId: string;
+    models: {
+        base?: {
+            model?: string | undefined;
+            providerOptions?: Record<string, Record<string, unknown>> | undefined;
+        } | undefined;
+        structuredOutput?: {
+            model?: string | undefined;
+            providerOptions?: Record<string, Record<string, unknown>> | undefined;
+        } | undefined;
+        summarizer?: {
+            model?: string | undefined;
+            providerOptions?: Record<string, Record<string, unknown>> | undefined;
+        } | undefined;
+    } | null;
+    stopWhen: {
+        handoffCountIs?: number;
+    } | null;
+    graphPrompt: string | null;
+    statusUpdates: {
+        enabled?: boolean | undefined;
+        numEvents?: number | undefined;
+        timeInSeconds?: number | undefined;
+        prompt?: string | undefined;
+        statusComponents?: {
+            id: string;
+            name: string;
+            schema: {
+                type: "object";
+                properties: Record<string, any>;
+                required?: string[] | undefined;
+            };
+            description?: string | undefined;
+        }[] | undefined;
+    } | null;
+    contextConfigId: string | null;
+    defaultAgent: {
+        tenantId: string;
+        projectId: string;
+        id: string;
+        name: string;
+        description: string;
+        instructions: string;
+        createdAt: string;
+        updatedAt: string;
+        models: {
+            base?: {
+                model?: string | undefined;
+                providerOptions?: Record<string, Record<string, unknown>> | undefined;
+            } | undefined;
+            structuredOutput?: {
+                model?: string | undefined;
+                providerOptions?: Record<string, Record<string, unknown>> | undefined;
+            } | undefined;
+            summarizer?: {
+                model?: string | undefined;
+                providerOptions?: Record<string, Record<string, unknown>> | undefined;
+            } | undefined;
+        } | null;
+        stopWhen: {
+            stepCountIs?: number;
+        } | null;
+        conversationHistoryConfig: import("../index.js").ConversationHistoryConfig | null;
+    };
+} | null>;
+export declare const listAgentGraphs: (db: DatabaseClient) => (params: {
+    scopes: ScopeConfig;
+}) => Promise<{
+    tenantId: string;
+    projectId: string;
+    id: string;
+    name: string;
+    description: string | null;
+    createdAt: string;
+    updatedAt: string;
+    defaultAgentId: string;
+    models: {
+        base?: {
+            model?: string | undefined;
+            providerOptions?: Record<string, Record<string, unknown>> | undefined;
+        } | undefined;
+        structuredOutput?: {
+            model?: string | undefined;
+            providerOptions?: Record<string, Record<string, unknown>> | undefined;
+        } | undefined;
+        summarizer?: {
+            model?: string | undefined;
+            providerOptions?: Record<string, Record<string, unknown>> | undefined;
+        } | undefined;
+    } | null;
+    stopWhen: {
+        handoffCountIs?: number;
+    } | null;
+    graphPrompt: string | null;
+    statusUpdates: {
+        enabled?: boolean | undefined;
+        numEvents?: number | undefined;
+        timeInSeconds?: number | undefined;
+        prompt?: string | undefined;
+        statusComponents?: {
+            id: string;
+            name: string;
+            schema: {
+                type: "object";
+                properties: Record<string, any>;
+                required?: string[] | undefined;
+            };
+            description?: string | undefined;
+        }[] | undefined;
+    } | null;
+    contextConfigId: string | null;
+}[]>;
+export declare const listAgentGraphsPaginated: (db: DatabaseClient) => (params: {
+    scopes: ScopeConfig;
+    pagination?: PaginationConfig;
+}) => Promise<{
+    data: {
+        tenantId: string;
+        projectId: string;
+        id: string;
+        name: string;
+        description: string | null;
+        defaultAgentId: string;
+        contextConfigId: string | null;
+        models: {
+            base?: {
+                model?: string | undefined;
+                providerOptions?: Record<string, Record<string, unknown>> | undefined;
+            } | undefined;
+            structuredOutput?: {
+                model?: string | undefined;
+                providerOptions?: Record<string, Record<string, unknown>> | undefined;
+            } | undefined;
+            summarizer?: {
+                model?: string | undefined;
+                providerOptions?: Record<string, Record<string, unknown>> | undefined;
+            } | undefined;
+        } | null;
+        statusUpdates: {
+            enabled?: boolean | undefined;
+            numEvents?: number | undefined;
+            timeInSeconds?: number | undefined;
+            prompt?: string | undefined;
+            statusComponents?: {
+                id: string;
+                name: string;
+                schema: {
+                    type: "object";
+                    properties: Record<string, any>;
+                    required?: string[] | undefined;
+                };
+                description?: string | undefined;
+            }[] | undefined;
+        } | null;
+        graphPrompt: string | null;
+        stopWhen: {
+            handoffCountIs?: number;
+        } | null;
+        createdAt: string;
+        updatedAt: string;
+    }[];
+    pagination: {
+        page: number;
+        limit: number;
+        total: number;
+        pages: number;
+    };
+}>;
+export declare const createAgentGraph: (db: DatabaseClient) => (data: AgentGraphInsert) => Promise<{
+    tenantId: string;
+    projectId: string;
+    id: string;
+    name: string;
+    description: string | null;
+    createdAt: string;
+    updatedAt: string;
+    defaultAgentId: string;
+    models: {
+        base?: {
+            model?: string | undefined;
+            providerOptions?: Record<string, Record<string, unknown>> | undefined;
+        } | undefined;
+        structuredOutput?: {
+            model?: string | undefined;
+            providerOptions?: Record<string, Record<string, unknown>> | undefined;
+        } | undefined;
+        summarizer?: {
+            model?: string | undefined;
+            providerOptions?: Record<string, Record<string, unknown>> | undefined;
+        } | undefined;
+    } | null;
+    stopWhen: {
+        handoffCountIs?: number;
+    } | null;
+    graphPrompt: string | null;
+    statusUpdates: {
+        enabled?: boolean | undefined;
+        numEvents?: number | undefined;
+        timeInSeconds?: number | undefined;
+        prompt?: string | undefined;
+        statusComponents?: {
+            id: string;
+            name: string;
+            schema: {
+                type: "object";
+                properties: Record<string, any>;
+                required?: string[] | undefined;
+            };
+            description?: string | undefined;
+        }[] | undefined;
+    } | null;
+    contextConfigId: string | null;
+}>;
+export declare const updateAgentGraph: (db: DatabaseClient) => (params: {
+    scopes: ScopeConfig;
+    graphId: string;
+    data: AgentGraphUpdate;
+}) => Promise<{
+    tenantId: string;
+    projectId: string;
+    id: string;
+    name: string;
+    description: string | null;
+    createdAt: string;
+    updatedAt: string;
+    defaultAgentId: string;
+    models: {
+        base?: {
+            model?: string | undefined;
+            providerOptions?: Record<string, Record<string, unknown>> | undefined;
+        } | undefined;
+        structuredOutput?: {
+            model?: string | undefined;
+            providerOptions?: Record<string, Record<string, unknown>> | undefined;
+        } | undefined;
+        summarizer?: {
+            model?: string | undefined;
+            providerOptions?: Record<string, Record<string, unknown>> | undefined;
+        } | undefined;
+    } | null;
+    stopWhen: {
+        handoffCountIs?: number;
+    } | null;
+    graphPrompt: string | null;
+    statusUpdates: {
+        enabled?: boolean | undefined;
+        numEvents?: number | undefined;
+        timeInSeconds?: number | undefined;
+        prompt?: string | undefined;
+        statusComponents?: {
+            id: string;
+            name: string;
+            schema: {
+                type: "object";
+                properties: Record<string, any>;
+                required?: string[] | undefined;
+            };
+            description?: string | undefined;
+        }[] | undefined;
+    } | null;
+    contextConfigId: string | null;
+}>;
+export declare const deleteAgentGraph: (db: DatabaseClient) => (params: {
+    scopes: ScopeConfig;
+    graphId: string;
+}) => Promise<boolean>;
+/**
+ * Helper function to fetch component relationships using efficient joins
+ */
+export declare const fetchComponentRelationships: (db: DatabaseClient) => <T extends Record<string, any>>(scopes: ScopeConfig, agentIds: string[], config: {
+    relationTable: any;
+    componentTable: any;
+    relationIdField: any;
+    componentIdField: any;
+    selectFields: Record<string, any>;
+}) => Promise<Record<string, T>>;
+export declare const getGraphAgentInfos: (db: DatabaseClient) => ({ scopes, graphId, agentId, }: {
+    scopes: ScopeConfig;
+    graphId: string;
+    agentId: string;
+}) => Promise<{
+    id: string;
+    name: string;
+    description: string;
+}[]>;
+export declare const getFullGraphDefinition: (db: DatabaseClient) => ({ scopes: { tenantId, projectId }, graphId, }: {
+    scopes: ScopeConfig;
+    graphId: string;
+}) => Promise<FullGraphDefinition | null>;
+/**
+ * Upsert an agent graph (create if it doesn't exist, update if it does)
+ */
+export declare const upsertAgentGraph: (db: DatabaseClient) => (params: {
+    data: AgentGraphInsert;
+}) => Promise<any>;
+//# sourceMappingURL=agentGraphs.d.ts.map

package/dist/data-access/agentGraphs.d.ts.map

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