@inkeep/agents-core 0.0.0-dev-20251009194333 → 0.0.0-dev-20251009215610

package/README.md

@@ -35,7 +35,7 @@ All data access functions follow a consistent functional pattern with dependency
 export const getAgentById = (db: DatabaseClient) => async (params: {
   tenantId: string;
   projectId: string;
-  agentId: string;
+  subAgentId: string;
 }) => {
   // Implementation
 };
@@ -76,7 +76,7 @@ const getAgent = getAgentById(db);
 const agent = await getAgent({
   tenantId: 'tenant-1',
   projectId: 'project-1',
-  agentId: 'agent-1'
+  subAgentId: 'agent-1'
 });
 ```
 

package/dist/{chunk-VPJ6Z5QZ.js → chunk-5LRSB445.js}

@@ -5,18 +5,9 @@ import { sqliteTable, text, primaryKey, foreignKey, blob, integer, index, unique
 // src/db/schema.ts
 var schema_exports = {};
 __export(schema_exports, {
-  agentArtifactComponents: () => agentArtifactComponents,
-  agentArtifactComponentsRelations: () => agentArtifactComponentsRelations,
-  agentDataComponents: () => agentDataComponents,
-  agentDataComponentsRelations: () => agentDataComponentsRelations,
   agentGraph: () => agentGraph,
   agentGraphRelations: () => agentGraphRelations,
-  agentRelations: () => agentRelations,
-  agentRelationsRelations: () => agentRelationsRelations,
-  agentToolRelations: () => agentToolRelations,
   agentToolRelationsRelations: () => agentToolRelationsRelations,
-  agents: () => agents,
-  agentsRelations: () => agentsRelations,
   apiKeys: () => apiKeys,
   apiKeysRelations: () => apiKeysRelations,
   artifactComponents: () => artifactComponents,
@@ -41,6 +32,15 @@ __export(schema_exports, {
   messagesRelations: () => messagesRelations,
   projects: () => projects,
   projectsRelations: () => projectsRelations,
+  subAgentArtifactComponents: () => subAgentArtifactComponents,
+  subAgentArtifactComponentsRelations: () => subAgentArtifactComponentsRelations,
+  subAgentDataComponents: () => subAgentDataComponents,
+  subAgentDataComponentsRelations: () => subAgentDataComponentsRelations,
+  subAgentRelations: () => subAgentRelations,
+  subAgentRelationsRelations: () => subAgentRelationsRelations,
+  subAgentToolRelations: () => subAgentToolRelations,
+  subAgents: () => subAgents,
+  subAgentsRelations: () => subAgentsRelations,
   taskRelations: () => taskRelations,
   taskRelationsRelations: () => taskRelationsRelations,
   tasks: () => tasks,
@@ -60,9 +60,9 @@ var graphScoped = {
   ...projectScoped,
   graphId: text("graph_id").notNull()
 };
-var agentScoped = {
+var subAgentScoped = {
   ...graphScoped,
-  agentId: text("agent_id").notNull()
+  subAgentId: text("sub_agent_id").notNull()
 };
 var uiProperties = {
   name: text("name").notNull(),
@@ -93,7 +93,7 @@ var agentGraph = sqliteTable(
     ...projectScoped,
     name: text("name").notNull(),
     description: text("description"),
-    defaultAgentId: text("default_agent_id"),
+    defaultSubAgentId: text("default_sub_agent_id"),
     // Reference to shared context configuration for all agents in this graph
     contextConfigId: text("context_config_id"),
     // add fk relationship
@@ -172,8 +172,8 @@ var contextCache = sqliteTable(
     )
   ]
 );
-var agents = sqliteTable(
-  "agents",
+var subAgents = sqliteTable(
+  "sub_agents",
   {
     ...graphScoped,
     ...uiProperties,
@@ -195,17 +195,16 @@ var agents = sqliteTable(
     }).onDelete("cascade")
   ]
 );
-var agentRelations = sqliteTable(
-  "agent_relations",
+var subAgentRelations = sqliteTable(
+  "sub_agent_relations",
   {
     ...graphScoped,
-    sourceAgentId: text("source_agent_id").notNull(),
+    sourceSubAgentId: text("source_sub_agent_id").notNull(),
     // For internal relationships
-    targetAgentId: text("target_agent_id"),
+    targetSubAgentId: text("target_sub_agent_id"),
     // For external relationships
-    externalAgentId: text("external_agent_id"),
+    externalSubAgentId: text("external_sub_agent_id"),
     relationType: text("relation_type"),
-    // 'transfer' | 'delegate'
     ...timestamps
   },
   (table) => [
@@ -213,7 +212,7 @@ var agentRelations = sqliteTable(
     foreignKey({
       columns: [table.tenantId, table.projectId, table.graphId],
       foreignColumns: [agentGraph.tenantId, agentGraph.projectId, agentGraph.id],
-      name: "agent_relations_graph_fk"
+      name: "sub_agent_relations_graph_fk"
     }).onDelete("cascade")
   ]
 );
@@ -249,7 +248,7 @@ var externalAgents = sqliteTable(
 var tasks = sqliteTable(
   "tasks",
   {
-    ...agentScoped,
+    ...subAgentScoped,
     contextId: text("context_id").notNull(),
     status: text("status").notNull(),
     metadata: blob("metadata", { mode: "json" }).$type(),
@@ -258,9 +257,9 @@ var tasks = sqliteTable(
   (table) => [
     primaryKey({ columns: [table.tenantId, table.projectId, table.id] }),
     foreignKey({
-      columns: [table.tenantId, table.projectId, table.graphId, table.agentId],
-      foreignColumns: [agents.tenantId, agents.projectId, agents.graphId, agents.id],
-      name: "tasks_agent_fk"
+      columns: [table.tenantId, table.projectId, table.graphId, table.subAgentId],
+      foreignColumns: [subAgents.tenantId, subAgents.projectId, subAgents.graphId, subAgents.id],
+      name: "tasks_sub_agent_fk"
     }).onDelete("cascade")
   ]
 );
@@ -300,10 +299,10 @@ var dataComponents = sqliteTable(
     }).onDelete("cascade")
   ]
 );
-var agentDataComponents = sqliteTable(
-  "agent_data_components",
+var subAgentDataComponents = sqliteTable(
+  "sub_agent_data_components",
   {
-    ...agentScoped,
+    ...subAgentScoped,
     dataComponentId: text("data_component_id").notNull(),
     createdAt: text("created_at").notNull().default(sql`CURRENT_TIMESTAMP`)
   },
@@ -311,15 +310,15 @@ var agentDataComponents = sqliteTable(
     primaryKey({ columns: [table.tenantId, table.projectId, table.id] }),
     // Foreign key constraint to agents table (ensures graph and project exist via cascade)
     foreignKey({
-      columns: [table.tenantId, table.projectId, table.graphId, table.agentId],
-      foreignColumns: [agents.tenantId, agents.projectId, agents.graphId, agents.id],
-      name: "agent_data_components_agent_fk"
+      columns: [table.tenantId, table.projectId, table.graphId, table.subAgentId],
+      foreignColumns: [subAgents.tenantId, subAgents.projectId, subAgents.graphId, subAgents.id],
+      name: "sub_agent_data_components_sub_agent_fk"
     }).onDelete("cascade"),
     // Foreign key constraint to data_components table
     foreignKey({
       columns: [table.tenantId, table.projectId, table.dataComponentId],
       foreignColumns: [dataComponents.tenantId, dataComponents.projectId, dataComponents.id],
-      name: "agent_data_components_data_component_fk"
+      name: "sub_agent_data_components_data_component_fk"
     }).onDelete("cascade")
   ]
 );
@@ -340,22 +339,22 @@ var artifactComponents = sqliteTable(
     }).onDelete("cascade")
   ]
 );
-var agentArtifactComponents = sqliteTable(
-  "agent_artifact_components",
+var subAgentArtifactComponents = sqliteTable(
+  "sub_agent_artifact_components",
   {
-    ...agentScoped,
+    ...subAgentScoped,
     artifactComponentId: text("artifact_component_id").notNull(),
     createdAt: text("created_at").notNull().default(sql`CURRENT_TIMESTAMP`)
   },
   (table) => [
     primaryKey({
-      columns: [table.tenantId, table.projectId, table.graphId, table.agentId, table.id]
+      columns: [table.tenantId, table.projectId, table.graphId, table.subAgentId, table.id]
     }),
     // Foreign key constraint to agents table (ensures graph and project exist via cascade)
     foreignKey({
-      columns: [table.tenantId, table.projectId, table.graphId, table.agentId],
-      foreignColumns: [agents.tenantId, agents.projectId, agents.graphId, agents.id],
-      name: "agent_artifact_components_agent_fk"
+      columns: [table.tenantId, table.projectId, table.graphId, table.subAgentId],
+      foreignColumns: [subAgents.tenantId, subAgents.projectId, subAgents.graphId, subAgents.id],
+      name: "sub_agent_artifact_components_sub_agent_fk"
     }).onDelete("cascade"),
     // Foreign key constraint to artifact_components table
     foreignKey({
@@ -365,7 +364,7 @@ var agentArtifactComponents = sqliteTable(
         artifactComponents.projectId,
         artifactComponents.id
       ],
-      name: "agent_artifact_components_artifact_component_fk"
+      name: "sub_agent_artifact_components_artifact_component_fk"
     }).onDelete("cascade")
   ]
 );
@@ -421,10 +420,10 @@ var functions = sqliteTable(
     }).onDelete("cascade")
   ]
 );
-var agentToolRelations = sqliteTable(
-  "agent_tool_relations",
+var subAgentToolRelations = sqliteTable(
+  "sub_agent_tool_relations",
   {
-    ...agentScoped,
+    ...subAgentScoped,
     toolId: text("tool_id").notNull(),
     selectedTools: blob("selected_tools", { mode: "json" }).$type(),
     headers: blob("headers", { mode: "json" }).$type(),
@@ -434,15 +433,15 @@ var agentToolRelations = sqliteTable(
     primaryKey({ columns: [table.tenantId, table.projectId, table.graphId, table.id] }),
     // Foreign key constraint to agents table (which includes project and graph scope)
     foreignKey({
-      columns: [table.tenantId, table.projectId, table.graphId, table.agentId],
-      foreignColumns: [agents.tenantId, agents.projectId, agents.graphId, agents.id],
-      name: "agent_tool_relations_agent_fk"
+      columns: [table.tenantId, table.projectId, table.graphId, table.subAgentId],
+      foreignColumns: [subAgents.tenantId, subAgents.projectId, subAgents.graphId, subAgents.id],
+      name: "sub_agent_tool_relations_agent_fk"
     }).onDelete("cascade"),
     // Foreign key constraint to tools table
     foreignKey({
       columns: [table.tenantId, table.projectId, table.toolId],
       foreignColumns: [tools.tenantId, tools.projectId, tools.id],
-      name: "agent_tool_relations_tool_fk"
+      name: "sub_agent_tool_relations_tool_fk"
     }).onDelete("cascade")
   ]
 );
@@ -451,7 +450,7 @@ var conversations = sqliteTable(
   {
     ...projectScoped,
     userId: text("user_id"),
-    activeAgentId: text("active_agent_id").notNull(),
+    activeSubAgentId: text("active_sub_agent_id").notNull(),
     title: text("title"),
     lastContextResolution: text("last_context_resolution"),
     metadata: blob("metadata", { mode: "json" }).$type(),
@@ -475,15 +474,15 @@ var messages = sqliteTable(
     role: text("role").notNull(),
     // 'user' | 'agent' | 'system'
     // Agent sender/recipient tracking (nullable - only populated when relevant)
-    fromAgentId: text("from_agent_id"),
+    fromSubAgentId: text("from_sub_agent_id"),
     // Populated when message is from an agent
-    toAgentId: text("to_agent_id"),
+    toSubAgentId: text("to_sub_agent_id"),
     // Populated when message is directed to a specific agent (e.g., transfers/delegations)
     // External agent sender tracking
-    fromExternalAgentId: text("from_external_agent_id"),
+    fromExternalAgentId: text("from_external_sub_agent_id"),
     // Populated when message is directed from an external agent
     // External agent recipient tracking
-    toExternalAgentId: text("to_external_agent_id"),
+    toExternalAgentId: text("to_external_sub_agent_id"),
     // Populated when message is directed to an external agent
     // Message content stored as JSON to support both formats
     content: blob("content", { mode: "json" }).$type().notNull(),
@@ -492,8 +491,6 @@ var messages = sqliteTable(
     // 'user-facing' | 'internal' | 'system' | 'external'
     messageType: text("message_type").notNull().default("chat"),
     // 'chat' | 'a2a-request' | 'a2a-response' | 'task-update' | 'tool-call'
-    // Legacy agent association (consider deprecating in favor of fromAgentId/toAgentId)
-    agentId: text("agent_id"),
     taskId: text("task_id"),
     parentMessageId: text("parent_message_id"),
     // Remove self-reference constraint here
@@ -620,10 +617,9 @@ var tasksRelations = relations(tasks, ({ one, many }) => ({
   childRelations: many(taskRelations, {
     relationName: "parentTask"
   }),
-  // A task belongs to one agent
-  agent: one(agents, {
-    fields: [tasks.agentId],
-    references: [agents.id]
+  subAgent: one(subAgents, {
+    fields: [tasks.subAgentId],
+    references: [subAgents.id]
   }),
   // A task can have many messages associated with it
   messages: many(messages),
@@ -631,7 +627,7 @@ var tasksRelations = relations(tasks, ({ one, many }) => ({
   ledgerArtifacts: many(ledgerArtifacts)
 }));
 var projectsRelations = relations(projects, ({ many }) => ({
-  agents: many(agents),
+  subAgents: many(subAgents),
   agentGraphs: many(agentGraph),
   tools: many(tools),
   contextConfigs: many(contextConfigs),
@@ -669,17 +665,17 @@ var contextCacheRelations = relations(contextCache, ({ one }) => ({
     references: [contextConfigs.id]
   })
 }));
-var agentsRelations = relations(agents, ({ many, one }) => ({
+var subAgentsRelations = relations(subAgents, ({ many, one }) => ({
   project: one(projects, {
-    fields: [agents.tenantId, agents.projectId],
+    fields: [subAgents.tenantId, subAgents.projectId],
     references: [projects.tenantId, projects.id]
   }),
   tasks: many(tasks),
   defaultForGraphs: many(agentGraph),
-  sourceRelations: many(agentRelations, {
+  sourceRelations: many(subAgentRelations, {
     relationName: "sourceRelations"
   }),
-  targetRelations: many(agentRelations, {
+  targetRelations: many(subAgentRelations, {
     relationName: "targetRelations"
   }),
   sentMessages: many(messages, {
@@ -691,18 +687,18 @@ var agentsRelations = relations(agents, ({ many, one }) => ({
   associatedMessages: many(messages, {
     relationName: "associatedAgent"
   }),
-  toolRelations: many(agentToolRelations),
-  dataComponentRelations: many(agentDataComponents),
-  artifactComponentRelations: many(agentArtifactComponents)
+  toolRelations: many(subAgentToolRelations),
+  dataComponentRelations: many(subAgentDataComponents),
+  artifactComponentRelations: many(subAgentArtifactComponents)
 }));
 var agentGraphRelations = relations(agentGraph, ({ one }) => ({
   project: one(projects, {
     fields: [agentGraph.tenantId, agentGraph.projectId],
     references: [projects.tenantId, projects.id]
   }),
-  defaultAgent: one(agents, {
-    fields: [agentGraph.defaultAgentId],
-    references: [agents.id]
+  defaultSubAgent: one(subAgents, {
+    fields: [agentGraph.defaultSubAgentId],
+    references: [subAgents.id]
   }),
   contextConfig: one(contextConfigs, {
     fields: [agentGraph.contextConfigId],
@@ -714,7 +710,7 @@ var externalAgentsRelations = relations(externalAgents, ({ one, many }) => ({
     fields: [externalAgents.tenantId, externalAgents.projectId],
     references: [projects.tenantId, projects.id]
   }),
-  agentRelations: many(agentRelations),
+  subAgentRelations: many(subAgentRelations),
   credentialReference: one(credentialReferences, {
     fields: [externalAgents.credentialReferenceId],
     references: [credentialReferences.id]
@@ -730,13 +726,13 @@ var apiKeysRelations = relations(apiKeys, ({ one }) => ({
     references: [agentGraph.id]
   })
 }));
-var agentToolRelationsRelations = relations(agentToolRelations, ({ one }) => ({
-  agent: one(agents, {
-    fields: [agentToolRelations.agentId],
-    references: [agents.id]
+var agentToolRelationsRelations = relations(subAgentToolRelations, ({ one }) => ({
+  subAgent: one(subAgents, {
+    fields: [subAgentToolRelations.subAgentId],
+    references: [subAgents.id]
   }),
   tool: one(tools, {
-    fields: [agentToolRelations.toolId],
+    fields: [subAgentToolRelations.toolId],
     references: [tools.id]
   })
 }));
@@ -748,7 +744,7 @@ var toolsRelations = relations(tools, ({ one, many }) => ({
     fields: [tools.tenantId, tools.projectId],
     references: [projects.tenantId, projects.id]
   }),
-  agentRelations: many(agentToolRelations),
+  subAgentRelations: many(subAgentToolRelations),
   credentialReference: one(credentialReferences, {
     fields: [tools.credentialReferenceId],
     references: [credentialReferences.id]
@@ -764,9 +760,9 @@ var conversationsRelations = relations(conversations, ({ one, many }) => ({
     references: [projects.tenantId, projects.id]
   }),
   messages: many(messages),
-  activeAgent: one(agents, {
-    fields: [conversations.activeAgentId],
-    references: [agents.id]
+  activeSubAgent: one(subAgents, {
+    fields: [conversations.activeSubAgentId],
+    references: [subAgents.id]
   })
 }));
 var messagesRelations = relations(messages, ({ one, many }) => ({
@@ -774,20 +770,14 @@ var messagesRelations = relations(messages, ({ one, many }) => ({
     fields: [messages.conversationId],
     references: [conversations.id]
   }),
-  // Legacy agent association (consider deprecating)
-  agent: one(agents, {
-    fields: [messages.agentId],
-    references: [agents.id],
-    relationName: "associatedAgent"
-  }),
-  fromAgent: one(agents, {
-    fields: [messages.fromAgentId],
-    references: [agents.id],
+  fromSubAgent: one(subAgents, {
+    fields: [messages.fromSubAgentId],
+    references: [subAgents.id],
     relationName: "sentMessages"
   }),
-  toAgent: one(agents, {
-    fields: [messages.toAgentId],
-    references: [agents.id],
+  toSubAgent: one(subAgents, {
+    fields: [messages.toSubAgentId],
+    references: [subAgents.id],
     relationName: "receivedMessages"
   }),
   fromExternalAgent: one(externalAgents, {
@@ -813,33 +803,40 @@ var messagesRelations = relations(messages, ({ one, many }) => ({
     relationName: "parentChild"
   })
 }));
-var artifactComponentsRelations = relations(artifactComponents, ({ many }) => ({
-  agentRelations: many(agentArtifactComponents)
+var artifactComponentsRelations = relations(artifactComponents, ({ many, one }) => ({
+  project: one(projects, {
+    fields: [artifactComponents.tenantId, artifactComponents.projectId],
+    references: [projects.tenantId, projects.id]
+  }),
+  subAgentRelations: many(subAgentArtifactComponents)
 }));
-var agentArtifactComponentsRelations = relations(agentArtifactComponents, ({ one }) => ({
-  agent: one(agents, {
-    fields: [agentArtifactComponents.agentId],
-    references: [agents.id]
-  }),
-  artifactComponent: one(artifactComponents, {
-    fields: [agentArtifactComponents.artifactComponentId],
-    references: [artifactComponents.id]
+var subAgentArtifactComponentsRelations = relations(
+  subAgentArtifactComponents,
+  ({ one }) => ({
+    subAgent: one(subAgents, {
+      fields: [subAgentArtifactComponents.subAgentId],
+      references: [subAgents.id]
+    }),
+    artifactComponent: one(artifactComponents, {
+      fields: [subAgentArtifactComponents.artifactComponentId],
+      references: [artifactComponents.id]
+    })
   })
-}));
+);
 var dataComponentsRelations = relations(dataComponents, ({ many, one }) => ({
   project: one(projects, {
     fields: [dataComponents.tenantId, dataComponents.projectId],
     references: [projects.tenantId, projects.id]
   }),
-  agentRelations: many(agentDataComponents)
+  subAgentRelations: many(subAgentDataComponents)
 }));
-var agentDataComponentsRelations = relations(agentDataComponents, ({ one }) => ({
-  agent: one(agents, {
-    fields: [agentDataComponents.agentId],
-    references: [agents.id]
+var subAgentDataComponentsRelations = relations(subAgentDataComponents, ({ one }) => ({
+  subAgent: one(subAgents, {
+    fields: [subAgentDataComponents.subAgentId],
+    references: [subAgents.id]
   }),
   dataComponent: one(dataComponents, {
-    fields: [agentDataComponents.dataComponentId],
+    fields: [subAgentDataComponents.dataComponentId],
     references: [dataComponents.id]
   })
 }));
@@ -856,25 +853,25 @@ var ledgerArtifactsRelations = relations(ledgerArtifacts, ({ one }) => ({
 var functionsRelations = relations(functions, ({ many }) => ({
   tools: many(tools)
 }));
-var agentRelationsRelations = relations(agentRelations, ({ one }) => ({
+var subAgentRelationsRelations = relations(subAgentRelations, ({ one }) => ({
   graph: one(agentGraph, {
-    fields: [agentRelations.graphId],
+    fields: [subAgentRelations.graphId],
     references: [agentGraph.id]
   }),
-  sourceAgent: one(agents, {
-    fields: [agentRelations.sourceAgentId],
-    references: [agents.id],
+  sourceSubAgent: one(subAgents, {
+    fields: [subAgentRelations.sourceSubAgentId],
+    references: [subAgents.id],
     relationName: "sourceRelations"
   }),
-  targetAgent: one(agents, {
-    fields: [agentRelations.targetAgentId],
-    references: [agents.id],
+  targetSubAgent: one(subAgents, {
+    fields: [subAgentRelations.targetSubAgentId],
+    references: [subAgents.id],
     relationName: "targetRelations"
   }),
   externalAgent: one(externalAgents, {
-    fields: [agentRelations.externalAgentId],
+    fields: [subAgentRelations.externalSubAgentId],
     references: [externalAgents.id]
   })
 }));
 
-export { agentArtifactComponents, agentArtifactComponentsRelations, agentDataComponents, agentDataComponentsRelations, agentGraph, agentGraphRelations, agentRelations, agentRelationsRelations, agentToolRelations, agentToolRelationsRelations, agents, agentsRelations, apiKeys, apiKeysRelations, artifactComponents, artifactComponentsRelations, contextCache, contextCacheRelations, contextConfigs, contextConfigsRelations, conversations, conversationsRelations, credentialReferences, credentialReferencesRelations, dataComponents, dataComponentsRelations, externalAgents, externalAgentsRelations, functions, functionsRelations, ledgerArtifacts, ledgerArtifactsRelations, messages, messagesRelations, projects, projectsRelations, schema_exports, taskRelations, taskRelationsRelations, tasks, tasksRelations, tools, toolsRelations };
+export { agentGraph, agentGraphRelations, agentToolRelationsRelations, apiKeys, apiKeysRelations, artifactComponents, artifactComponentsRelations, contextCache, contextCacheRelations, contextConfigs, contextConfigsRelations, conversations, conversationsRelations, credentialReferences, credentialReferencesRelations, dataComponents, dataComponentsRelations, externalAgents, externalAgentsRelations, functions, functionsRelations, ledgerArtifacts, ledgerArtifactsRelations, messages, messagesRelations, projects, projectsRelations, schema_exports, subAgentArtifactComponents, subAgentArtifactComponentsRelations, subAgentDataComponents, subAgentDataComponentsRelations, subAgentRelations, subAgentRelationsRelations, subAgentToolRelations, subAgents, subAgentsRelations, taskRelations, taskRelationsRelations, tasks, tasksRelations, tools, toolsRelations };