@inkeep/agents-core 0.0.0-dev-20260124111014 → 0.0.0-dev-20260126093157

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (35) hide show
  1. package/dist/auth/auth.d.ts +57 -57
  2. package/dist/auth/permissions.d.ts +13 -13
  3. package/dist/client-exports.d.ts +2 -3
  4. package/dist/context/TemplateEngine.d.ts +0 -6
  5. package/dist/context/TemplateEngine.js +4 -18
  6. package/dist/data-access/index.d.ts +2 -2
  7. package/dist/data-access/index.js +2 -2
  8. package/dist/data-access/manage/functionTools.d.ts +4 -4
  9. package/dist/data-access/manage/subAgentExternalAgentRelations.d.ts +12 -12
  10. package/dist/data-access/manage/subAgentRelations.d.ts +6 -6
  11. package/dist/data-access/manage/subAgentTeamAgentRelations.d.ts +6 -6
  12. package/dist/data-access/manage/tools.d.ts +19 -13
  13. package/dist/data-access/manage/tools.js +24 -7
  14. package/dist/data-access/runtime/messages.d.ts +9 -9
  15. package/dist/data-access/runtime/tasks.d.ts +1 -1
  16. package/dist/db/manage/manage-schema.d.ts +301 -301
  17. package/dist/db/runtime/runtime-schema.d.ts +157 -157
  18. package/dist/index.d.ts +3 -3
  19. package/dist/index.js +3 -3
  20. package/dist/utils/JsonTransformer.d.ts +1 -3
  21. package/dist/utils/JsonTransformer.js +14 -23
  22. package/dist/utils/index.d.ts +2 -2
  23. package/dist/utils/index.js +2 -2
  24. package/dist/utils/jmespath-utils.d.ts +152 -0
  25. package/dist/utils/jmespath-utils.js +213 -0
  26. package/dist/utils/signature-validation.d.ts +2 -39
  27. package/dist/utils/signature-validation.js +1 -69
  28. package/dist/utils/third-party-mcp-servers/composio-client.d.ts +13 -1
  29. package/dist/utils/third-party-mcp-servers/composio-client.js +24 -6
  30. package/dist/utils/third-party-mcp-servers/index.d.ts +2 -2
  31. package/dist/utils/third-party-mcp-servers/index.js +2 -2
  32. package/dist/utils/trigger-auth.js +3 -5
  33. package/dist/validation/schemas.d.ts +1102 -1102
  34. package/dist/validation/schemas.js +32 -36
  35. package/package.json +1 -1
@@ -11,12 +11,12 @@ declare const getSubAgentExternalAgentRelationById: (db: AgentsManageDatabaseCli
11
11
  id: string;
12
12
  createdAt: string;
13
13
  updatedAt: string;
14
- headers: Record<string, string> | null;
15
14
  agentId: string;
16
15
  projectId: string;
17
16
  tenantId: string;
18
- subAgentId: string;
17
+ headers: Record<string, string> | null;
19
18
  externalAgentId: string;
19
+ subAgentId: string;
20
20
  } | undefined>;
21
21
  declare const listSubAgentExternalAgentRelations: (db: AgentsManageDatabaseClient) => (params: {
22
22
  scopes: SubAgentScopeConfig;
@@ -46,12 +46,12 @@ declare const getSubAgentExternalAgentRelations: (db: AgentsManageDatabaseClient
46
46
  id: string;
47
47
  createdAt: string;
48
48
  updatedAt: string;
49
- headers: Record<string, string> | null;
50
49
  agentId: string;
51
50
  projectId: string;
52
51
  tenantId: string;
53
- subAgentId: string;
52
+ headers: Record<string, string> | null;
54
53
  externalAgentId: string;
54
+ subAgentId: string;
55
55
  }[]>;
56
56
  declare const getSubAgentExternalAgentRelationsByAgent: (db: AgentsManageDatabaseClient) => (params: {
57
57
  scopes: AgentScopeConfig;
@@ -59,12 +59,12 @@ declare const getSubAgentExternalAgentRelationsByAgent: (db: AgentsManageDatabas
59
59
  id: string;
60
60
  createdAt: string;
61
61
  updatedAt: string;
62
- headers: Record<string, string> | null;
63
62
  agentId: string;
64
63
  projectId: string;
65
64
  tenantId: string;
66
- subAgentId: string;
65
+ headers: Record<string, string> | null;
67
66
  externalAgentId: string;
67
+ subAgentId: string;
68
68
  }[]>;
69
69
  declare const getSubAgentExternalAgentRelationsByExternalAgent: (db: AgentsManageDatabaseClient) => (params: {
70
70
  scopes: AgentScopeConfig;
@@ -182,12 +182,12 @@ declare const createSubAgentExternalAgentRelation: (db: AgentsManageDatabaseClie
182
182
  id: string;
183
183
  createdAt: string;
184
184
  updatedAt: string;
185
- headers: Record<string, string> | null;
186
185
  agentId: string;
187
186
  projectId: string;
188
187
  tenantId: string;
189
- subAgentId: string;
188
+ headers: Record<string, string> | null;
190
189
  externalAgentId: string;
190
+ subAgentId: string;
191
191
  }>;
192
192
  /**
193
193
  * Check if sub-agent external agent relation exists by params
@@ -199,12 +199,12 @@ declare const getSubAgentExternalAgentRelationByParams: (db: AgentsManageDatabas
199
199
  id: string;
200
200
  createdAt: string;
201
201
  updatedAt: string;
202
- headers: Record<string, string> | null;
203
202
  agentId: string;
204
203
  projectId: string;
205
204
  tenantId: string;
206
- subAgentId: string;
205
+ headers: Record<string, string> | null;
207
206
  externalAgentId: string;
207
+ subAgentId: string;
208
208
  } | undefined>;
209
209
  /**
210
210
  * Upsert sub-agent external agent relation (create if it doesn't exist, update if it does)
@@ -220,12 +220,12 @@ declare const upsertSubAgentExternalAgentRelation: (db: AgentsManageDatabaseClie
220
220
  id: string;
221
221
  createdAt: string;
222
222
  updatedAt: string;
223
- headers: Record<string, string> | null;
224
223
  agentId: string;
225
224
  projectId: string;
226
225
  tenantId: string;
227
- subAgentId: string;
226
+ headers: Record<string, string> | null;
228
227
  externalAgentId: string;
228
+ subAgentId: string;
229
229
  }>;
230
230
  declare const updateSubAgentExternalAgentRelation: (db: AgentsManageDatabaseClient) => (params: {
231
231
  scopes: SubAgentScopeConfig;
@@ -206,15 +206,15 @@ declare const createAgentToolRelation: (db: AgentsManageDatabaseClient) => (para
206
206
  id: string;
207
207
  createdAt: string;
208
208
  updatedAt: string;
209
- headers: Record<string, string> | null;
210
209
  agentId: string;
211
210
  projectId: string;
212
211
  tenantId: string;
213
- subAgentId: string;
212
+ toolId: string;
213
+ headers: Record<string, string> | null;
214
214
  toolPolicies: Record<string, {
215
215
  needsApproval?: boolean;
216
216
  }> | null;
217
- toolId: string;
217
+ subAgentId: string;
218
218
  selectedTools: string[] | null;
219
219
  }>;
220
220
  declare const updateAgentToolRelation: (db: AgentsManageDatabaseClient) => (params: {
@@ -250,15 +250,15 @@ declare const getAgentToolRelationById: (db: AgentsManageDatabaseClient) => (par
250
250
  id: string;
251
251
  createdAt: string;
252
252
  updatedAt: string;
253
- headers: Record<string, string> | null;
254
253
  agentId: string;
255
254
  projectId: string;
256
255
  tenantId: string;
257
- subAgentId: string;
256
+ toolId: string;
257
+ headers: Record<string, string> | null;
258
258
  toolPolicies: Record<string, {
259
259
  needsApproval?: boolean;
260
260
  }> | null;
261
- toolId: string;
261
+ subAgentId: string;
262
262
  selectedTools: string[] | null;
263
263
  } | undefined>;
264
264
  declare const getAgentToolRelationByAgent: (db: AgentsManageDatabaseClient) => (params: {
@@ -11,10 +11,10 @@ declare const getSubAgentTeamAgentRelationById: (db: AgentsManageDatabaseClient)
11
11
  id: string;
12
12
  createdAt: string;
13
13
  updatedAt: string;
14
- headers: Record<string, string> | null;
15
14
  agentId: string;
16
15
  projectId: string;
17
16
  tenantId: string;
17
+ headers: Record<string, string> | null;
18
18
  subAgentId: string;
19
19
  targetAgentId: string;
20
20
  } | undefined>;
@@ -46,10 +46,10 @@ declare const getSubAgentTeamAgentRelations: (db: AgentsManageDatabaseClient) =>
46
46
  id: string;
47
47
  createdAt: string;
48
48
  updatedAt: string;
49
- headers: Record<string, string> | null;
50
49
  agentId: string;
51
50
  projectId: string;
52
51
  tenantId: string;
52
+ headers: Record<string, string> | null;
53
53
  subAgentId: string;
54
54
  targetAgentId: string;
55
55
  }[]>;
@@ -59,10 +59,10 @@ declare const getSubAgentTeamAgentRelationsByAgent: (db: AgentsManageDatabaseCli
59
59
  id: string;
60
60
  createdAt: string;
61
61
  updatedAt: string;
62
- headers: Record<string, string> | null;
63
62
  agentId: string;
64
63
  projectId: string;
65
64
  tenantId: string;
65
+ headers: Record<string, string> | null;
66
66
  subAgentId: string;
67
67
  targetAgentId: string;
68
68
  }[]>;
@@ -212,10 +212,10 @@ declare const createSubAgentTeamAgentRelation: (db: AgentsManageDatabaseClient)
212
212
  id: string;
213
213
  createdAt: string;
214
214
  updatedAt: string;
215
- headers: Record<string, string> | null;
216
215
  agentId: string;
217
216
  projectId: string;
218
217
  tenantId: string;
218
+ headers: Record<string, string> | null;
219
219
  subAgentId: string;
220
220
  targetAgentId: string;
221
221
  }>;
@@ -229,10 +229,10 @@ declare const getSubAgentTeamAgentRelationByParams: (db: AgentsManageDatabaseCli
229
229
  id: string;
230
230
  createdAt: string;
231
231
  updatedAt: string;
232
- headers: Record<string, string> | null;
233
232
  agentId: string;
234
233
  projectId: string;
235
234
  tenantId: string;
235
+ headers: Record<string, string> | null;
236
236
  subAgentId: string;
237
237
  targetAgentId: string;
238
238
  } | undefined>;
@@ -250,10 +250,10 @@ declare const upsertSubAgentTeamAgentRelation: (db: AgentsManageDatabaseClient)
250
250
  id: string;
251
251
  createdAt: string;
252
252
  updatedAt: string;
253
- headers: Record<string, string> | null;
254
253
  agentId: string;
255
254
  projectId: string;
256
255
  tenantId: string;
256
+ headers: Record<string, string> | null;
257
257
  subAgentId: string;
258
258
  targetAgentId: string;
259
259
  }>;
@@ -7,6 +7,12 @@ import "../../index.js";
7
7
  import { McpTool, ToolInsert, ToolSelect, ToolUpdate } from "../../types/entities.js";
8
8
 
9
9
  //#region src/data-access/manage/tools.d.ts
10
+ /**
11
+ * Convert DB result to McpTool skeleton WITHOUT MCP discovery.
12
+ * This is a fast path that returns status='unknown' and empty availableTools.
13
+ * Use this for list views where you want instant page load.
14
+ */
15
+ declare const dbResultToMcpToolSkeleton: (dbResult: ToolSelect, relationshipId?: string) => McpTool;
10
16
  declare const dbResultToMcpTool: (dbResult: ToolSelect, dbClient: AgentsManageDatabaseClient, credentialStoreRegistry?: CredentialStoreRegistry, relationshipId?: string, userId?: string) => Promise<McpTool>;
11
17
  declare const getToolById: (db: AgentsManageDatabaseClient) => (params: {
12
18
  scopes: ProjectScopeConfig;
@@ -17,7 +23,6 @@ declare const getToolById: (db: AgentsManageDatabaseClient) => (params: {
17
23
  createdAt: string;
18
24
  updatedAt: string;
19
25
  description: string | null;
20
- headers: Record<string, string> | null;
21
26
  projectId: string;
22
27
  tenantId: string;
23
28
  config: {
@@ -25,6 +30,7 @@ declare const getToolById: (db: AgentsManageDatabaseClient) => (params: {
25
30
  mcp: ToolMcpConfig;
26
31
  };
27
32
  credentialReferenceId: string | null;
33
+ headers: Record<string, string> | null;
28
34
  credentialScope: string;
29
35
  imageUrl: string | null;
30
36
  capabilities: ToolServerCapabilities | null;
@@ -73,7 +79,6 @@ declare const createTool: (db: AgentsManageDatabaseClient) => (params: ToolInser
73
79
  createdAt: string;
74
80
  updatedAt: string;
75
81
  description: string | null;
76
- headers: Record<string, string> | null;
77
82
  projectId: string;
78
83
  tenantId: string;
79
84
  config: {
@@ -81,6 +86,7 @@ declare const createTool: (db: AgentsManageDatabaseClient) => (params: ToolInser
81
86
  mcp: ToolMcpConfig;
82
87
  };
83
88
  credentialReferenceId: string | null;
89
+ headers: Record<string, string> | null;
84
90
  credentialScope: string;
85
91
  imageUrl: string | null;
86
92
  capabilities: ToolServerCapabilities | null;
@@ -126,15 +132,15 @@ declare const addToolToAgent: (db: AgentsManageDatabaseClient) => (params: {
126
132
  id: string;
127
133
  createdAt: string;
128
134
  updatedAt: string;
129
- headers: Record<string, string> | null;
130
135
  agentId: string;
131
136
  projectId: string;
132
137
  tenantId: string;
133
- subAgentId: string;
138
+ toolId: string;
139
+ headers: Record<string, string> | null;
134
140
  toolPolicies: Record<string, {
135
141
  needsApproval?: boolean;
136
142
  }> | null;
137
- toolId: string;
143
+ subAgentId: string;
138
144
  selectedTools: string[] | null;
139
145
  }>;
140
146
  declare const removeToolFromAgent: (db: AgentsManageDatabaseClient) => (params: {
@@ -145,15 +151,15 @@ declare const removeToolFromAgent: (db: AgentsManageDatabaseClient) => (params:
145
151
  id: string;
146
152
  createdAt: string;
147
153
  updatedAt: string;
148
- headers: Record<string, string> | null;
149
154
  agentId: string;
150
155
  projectId: string;
151
156
  tenantId: string;
152
- subAgentId: string;
157
+ toolId: string;
158
+ headers: Record<string, string> | null;
153
159
  toolPolicies: Record<string, {
154
160
  needsApproval?: boolean;
155
161
  }> | null;
156
- toolId: string;
162
+ subAgentId: string;
157
163
  selectedTools: string[] | null;
158
164
  }>;
159
165
  /**
@@ -173,15 +179,15 @@ declare const upsertSubAgentToolRelation: (db: AgentsManageDatabaseClient) => (p
173
179
  id: string;
174
180
  createdAt: string;
175
181
  updatedAt: string;
176
- headers: Record<string, string> | null;
177
182
  agentId: string;
178
183
  projectId: string;
179
184
  tenantId: string;
180
- subAgentId: string;
185
+ toolId: string;
186
+ headers: Record<string, string> | null;
181
187
  toolPolicies: Record<string, {
182
188
  needsApproval?: boolean;
183
189
  }> | null;
184
- toolId: string;
190
+ subAgentId: string;
185
191
  selectedTools: string[] | null;
186
192
  }>;
187
193
  /**
@@ -195,7 +201,6 @@ declare const upsertTool: (db: AgentsManageDatabaseClient) => (params: {
195
201
  createdAt: string;
196
202
  updatedAt: string;
197
203
  description: string | null;
198
- headers: Record<string, string> | null;
199
204
  projectId: string;
200
205
  tenantId: string;
201
206
  config: {
@@ -203,10 +208,11 @@ declare const upsertTool: (db: AgentsManageDatabaseClient) => (params: {
203
208
  mcp: ToolMcpConfig;
204
209
  };
205
210
  credentialReferenceId: string | null;
211
+ headers: Record<string, string> | null;
206
212
  credentialScope: string;
207
213
  imageUrl: string | null;
208
214
  capabilities: ToolServerCapabilities | null;
209
215
  lastError: string | null;
210
216
  }>;
211
217
  //#endregion
212
- export { addToolToAgent, createTool, dbResultToMcpTool, deleteTool, getMcpToolById, getToolById, listTools, removeToolFromAgent, updateTool, upsertSubAgentToolRelation, upsertTool };
218
+ export { addToolToAgent, createTool, dbResultToMcpTool, dbResultToMcpToolSkeleton, deleteTool, getMcpToolById, getToolById, listTools, removeToolFromAgent, updateTool, upsertSubAgentToolRelation, upsertTool };
@@ -9,6 +9,7 @@ import { generateId } from "../../utils/conversations.js";
9
9
  import { updateAgentToolRelation } from "./subAgentRelations.js";
10
10
  import { toISODateString } from "../../utils/date.js";
11
11
  import { McpClient } from "../../utils/mcp-client.js";
12
+ import { buildComposioMCPUrl } from "../../utils/third-party-mcp-servers/composio-client.js";
12
13
  import { isThirdPartyMCPServerAuthenticated } from "../../utils/third-party-mcp-servers/third-party-check.js";
13
14
  import "../../utils/index.js";
14
15
  import { getCredentialReference, getUserScopedCredentialReference } from "./credentialReferences.js";
@@ -97,12 +98,7 @@ const discoverToolsFromServer = async (tool, credentialReference, credentialStor
97
98
  reconnectionOptions: tool.config.mcp.transport?.reconnectionOptions,
98
99
  sessionId: tool.config.mcp.transport?.sessionId
99
100
  };
100
- if (serverConfig.url?.toString().includes("composio.dev")) {
101
- const urlObj = new URL(serverConfig.url.toString());
102
- if (tool.credentialScope === "user" && userId) urlObj.searchParams.set("user_id", userId);
103
- else urlObj.searchParams.set("user_id", `${tool.tenantId}||${tool.projectId}`);
104
- serverConfig.url = urlObj.toString();
105
- }
101
+ if (serverConfig.url) serverConfig.url = buildComposioMCPUrl(serverConfig.url.toString(), tool.tenantId, tool.projectId, tool.credentialScope === "user" ? "user" : "project", userId);
106
102
  const client = new McpClient({
107
103
  name: tool.name,
108
104
  server: serverConfig
@@ -127,6 +123,27 @@ const discoverToolsFromServer = async (tool, credentialReference, credentialStor
127
123
  throw error;
128
124
  }
129
125
  };
126
+ /**
127
+ * Convert DB result to McpTool skeleton WITHOUT MCP discovery.
128
+ * This is a fast path that returns status='unknown' and empty availableTools.
129
+ * Use this for list views where you want instant page load.
130
+ */
131
+ const dbResultToMcpToolSkeleton = (dbResult, relationshipId) => {
132
+ const { headers, capabilities, credentialReferenceId, imageUrl, createdAt, ...rest } = dbResult;
133
+ return {
134
+ ...rest,
135
+ status: "unknown",
136
+ availableTools: [],
137
+ capabilities: capabilities || void 0,
138
+ credentialReferenceId: credentialReferenceId || void 0,
139
+ createdAt: toISODateString(createdAt),
140
+ updatedAt: toISODateString(dbResult.updatedAt),
141
+ lastError: dbResult.lastError || null,
142
+ headers: headers || void 0,
143
+ imageUrl: imageUrl || void 0,
144
+ relationshipId
145
+ };
146
+ };
130
147
  const dbResultToMcpTool = async (dbResult, dbClient, credentialStoreRegistry, relationshipId, userId) => {
131
148
  const { headers, capabilities, credentialReferenceId, imageUrl, createdAt, ...rest } = dbResult;
132
149
  if (dbResult.config.type !== "mcp") return {
@@ -337,4 +354,4 @@ const upsertTool = (db) => async (params) => {
337
354
  };
338
355
 
339
356
  //#endregion
340
- export { addToolToAgent, createTool, dbResultToMcpTool, deleteTool, getMcpToolById, getToolById, listTools, removeToolFromAgent, updateTool, upsertSubAgentToolRelation, upsertTool };
357
+ export { addToolToAgent, createTool, dbResultToMcpTool, dbResultToMcpToolSkeleton, deleteTool, getMcpToolById, getToolById, listTools, removeToolFromAgent, updateTool, upsertSubAgentToolRelation, upsertTool };
@@ -17,18 +17,18 @@ declare const getMessageById: (db: AgentsRunDatabaseClient) => (params: {
17
17
  projectId: string;
18
18
  tenantId: string;
19
19
  content: MessageContent;
20
+ conversationId: string;
20
21
  fromSubAgentId: string | null;
21
22
  toSubAgentId: string | null;
22
23
  fromExternalAgentId: string | null;
23
24
  toExternalAgentId: string | null;
24
- taskId: string | null;
25
- a2aTaskId: string | null;
26
- conversationId: string;
27
25
  fromTeamAgentId: string | null;
28
26
  toTeamAgentId: string | null;
29
27
  visibility: string;
30
28
  messageType: string;
29
+ taskId: string | null;
31
30
  parentMessageId: string | null;
31
+ a2aTaskId: string | null;
32
32
  a2aSessionId: string | null;
33
33
  } | undefined>;
34
34
  declare const listMessages: (db: AgentsRunDatabaseClient) => (params: {
@@ -148,18 +148,18 @@ declare const createMessage: (db: AgentsRunDatabaseClient) => (params: MessageIn
148
148
  projectId: string;
149
149
  tenantId: string;
150
150
  content: MessageContent;
151
+ conversationId: string;
151
152
  fromSubAgentId: string | null;
152
153
  toSubAgentId: string | null;
153
154
  fromExternalAgentId: string | null;
154
155
  toExternalAgentId: string | null;
155
- taskId: string | null;
156
- a2aTaskId: string | null;
157
- conversationId: string;
158
156
  fromTeamAgentId: string | null;
159
157
  toTeamAgentId: string | null;
160
158
  visibility: string;
161
159
  messageType: string;
160
+ taskId: string | null;
162
161
  parentMessageId: string | null;
162
+ a2aTaskId: string | null;
163
163
  a2aSessionId: string | null;
164
164
  }>;
165
165
  declare const updateMessage: (db: AgentsRunDatabaseClient) => (params: {
@@ -201,18 +201,18 @@ declare const deleteMessage: (db: AgentsRunDatabaseClient) => (params: {
201
201
  projectId: string;
202
202
  tenantId: string;
203
203
  content: MessageContent;
204
+ conversationId: string;
204
205
  fromSubAgentId: string | null;
205
206
  toSubAgentId: string | null;
206
207
  fromExternalAgentId: string | null;
207
208
  toExternalAgentId: string | null;
208
- taskId: string | null;
209
- a2aTaskId: string | null;
210
- conversationId: string;
211
209
  fromTeamAgentId: string | null;
212
210
  toTeamAgentId: string | null;
213
211
  visibility: string;
214
212
  messageType: string;
213
+ taskId: string | null;
215
214
  parentMessageId: string | null;
215
+ a2aTaskId: string | null;
216
216
  a2aSessionId: string | null;
217
217
  }>;
218
218
  declare const countMessagesByConversation: (db: AgentsRunDatabaseClient) => (params: {
@@ -19,8 +19,8 @@ declare const createTask: (db: AgentsRunDatabaseClient) => (params: TaskInsert)
19
19
  agentId: string;
20
20
  projectId: string;
21
21
  tenantId: string;
22
- subAgentId: string;
23
22
  contextId: string;
23
+ subAgentId: string;
24
24
  }>;
25
25
  declare const getTask: (db: AgentsRunDatabaseClient) => (params: {
26
26
  id: string;