@inkeep/agents-api 0.0.0-dev-20260304143104 → 0.0.0-dev-20260304183117

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 (33) hide show
  1. package/dist/.well-known/workflow/v1/manifest.json +26 -26
  2. package/dist/createApp.d.ts +2 -2
  3. package/dist/data/db/manageDbClient.d.ts +2 -2
  4. package/dist/data/db/runDbClient.d.ts +2 -2
  5. package/dist/domains/evals/routes/datasetTriggers.d.ts +2 -2
  6. package/dist/domains/evals/routes/index.d.ts +2 -2
  7. package/dist/domains/evals/workflow/routes.d.ts +2 -2
  8. package/dist/domains/manage/routes/availableAgents.d.ts +2 -2
  9. package/dist/domains/manage/routes/conversations.d.ts +2 -2
  10. package/dist/domains/manage/routes/index.d.ts +2 -2
  11. package/dist/domains/manage/routes/invitations.d.ts +2 -2
  12. package/dist/domains/manage/routes/passwordResetLinks.d.ts +2 -2
  13. package/dist/domains/manage/routes/signoz.d.ts +2 -2
  14. package/dist/domains/mcp/routes/mcp.d.ts +2 -2
  15. package/dist/domains/run/agents/Agent.d.ts +7 -0
  16. package/dist/domains/run/agents/Agent.js +14 -0
  17. package/dist/domains/run/agents/generateTaskHandler.js +9 -0
  18. package/dist/domains/run/tools/distill-conversation-history-tool.d.ts +1 -1
  19. package/dist/domains/run/types/chat.d.ts +4 -4
  20. package/dist/domains/run/utils/token-estimator.d.ts +2 -2
  21. package/dist/domains/run/workflow/steps/scheduledTriggerSteps.d.ts +5 -5
  22. package/dist/env.d.ts +2 -2
  23. package/dist/factory.d.ts +323 -323
  24. package/dist/index.d.ts +322 -322
  25. package/dist/middleware/evalsAuth.d.ts +2 -2
  26. package/dist/middleware/manageAuth.d.ts +3 -3
  27. package/dist/middleware/projectConfig.d.ts +3 -3
  28. package/dist/middleware/requirePermission.d.ts +2 -2
  29. package/dist/middleware/runAuth.d.ts +4 -4
  30. package/dist/middleware/sessionAuth.d.ts +3 -3
  31. package/dist/middleware/tenantAccess.d.ts +2 -2
  32. package/dist/middleware/tracing.d.ts +3 -3
  33. package/package.json +5 -5
@@ -1,6 +1,22 @@
1
1
  {
2
2
  "version": "1.0.0",
3
3
  "steps": {
4
+ "node_modules/.pnpm/workflow@4.1.0-beta.54_@aws-sdk+client-sts@3.970.0_@nestjs+common@11.1.13_reflect-metad_f85281f2580d7065fc514e637f5f5e1f/node_modules/workflow/dist/internal/builtins.js": {
5
+ "__builtin_response_array_buffer": {
6
+ "stepId": "__builtin_response_array_buffer"
7
+ },
8
+ "__builtin_response_json": {
9
+ "stepId": "__builtin_response_json"
10
+ },
11
+ "__builtin_response_text": {
12
+ "stepId": "__builtin_response_text"
13
+ }
14
+ },
15
+ "node_modules/.pnpm/workflow@4.1.0-beta.54_@aws-sdk+client-sts@3.970.0_@nestjs+common@11.1.13_reflect-metad_f85281f2580d7065fc514e637f5f5e1f/node_modules/workflow/dist/stdlib.js": {
16
+ "fetch": {
17
+ "stepId": "step//workflow@4.1.0-beta.54//fetch"
18
+ }
19
+ },
4
20
  "src/domains/evals/workflow/functions/evaluateConversation.ts": {
5
21
  "executeEvaluatorStep": {
6
22
  "stepId": "step//./src/domains/evals/workflow/functions/evaluateConversation//executeEvaluatorStep"
@@ -15,20 +31,18 @@
15
31
  "stepId": "step//./src/domains/evals/workflow/functions/evaluateConversation//logStep"
16
32
  }
17
33
  },
18
- "node_modules/.pnpm/workflow@4.1.0-beta.54_@aws-sdk+client-sts@3.970.0_@nestjs+common@11.1.13_reflect-metad_f85281f2580d7065fc514e637f5f5e1f/node_modules/workflow/dist/internal/builtins.js": {
19
- "__builtin_response_array_buffer": {
20
- "stepId": "__builtin_response_array_buffer"
34
+ "src/domains/evals/workflow/functions/runDatasetItem.ts": {
35
+ "callChatApiStep": {
36
+ "stepId": "step//./src/domains/evals/workflow/functions/runDatasetItem//callChatApiStep"
21
37
  },
22
- "__builtin_response_json": {
23
- "stepId": "__builtin_response_json"
38
+ "createRelationStep": {
39
+ "stepId": "step//./src/domains/evals/workflow/functions/runDatasetItem//createRelationStep"
24
40
  },
25
- "__builtin_response_text": {
26
- "stepId": "__builtin_response_text"
27
- }
28
- },
29
- "node_modules/.pnpm/workflow@4.1.0-beta.54_@aws-sdk+client-sts@3.970.0_@nestjs+common@11.1.13_reflect-metad_f85281f2580d7065fc514e637f5f5e1f/node_modules/workflow/dist/stdlib.js": {
30
- "fetch": {
31
- "stepId": "step//workflow@4.1.0-beta.54//fetch"
41
+ "executeEvaluatorStep": {
42
+ "stepId": "step//./src/domains/evals/workflow/functions/runDatasetItem//executeEvaluatorStep"
43
+ },
44
+ "logStep": {
45
+ "stepId": "step//./src/domains/evals/workflow/functions/runDatasetItem//logStep"
32
46
  }
33
47
  },
34
48
  "src/domains/run/workflow/steps/scheduledTriggerSteps.ts": {
@@ -74,20 +88,6 @@
74
88
  "markRunningStep": {
75
89
  "stepId": "step//./src/domains/run/workflow/steps/scheduledTriggerSteps//markRunningStep"
76
90
  }
77
- },
78
- "src/domains/evals/workflow/functions/runDatasetItem.ts": {
79
- "callChatApiStep": {
80
- "stepId": "step//./src/domains/evals/workflow/functions/runDatasetItem//callChatApiStep"
81
- },
82
- "createRelationStep": {
83
- "stepId": "step//./src/domains/evals/workflow/functions/runDatasetItem//createRelationStep"
84
- },
85
- "executeEvaluatorStep": {
86
- "stepId": "step//./src/domains/evals/workflow/functions/runDatasetItem//executeEvaluatorStep"
87
- },
88
- "logStep": {
89
- "stepId": "step//./src/domains/evals/workflow/functions/runDatasetItem//logStep"
90
- }
91
91
  }
92
92
  },
93
93
  "workflows": {
@@ -1,10 +1,10 @@
1
1
  import { AppConfig } from "./types/app.js";
2
2
  import "./types/index.js";
3
3
  import { Hono } from "hono";
4
- import * as hono_types0 from "hono/types";
4
+ import * as hono_types8 from "hono/types";
5
5
 
6
6
  //#region src/createApp.d.ts
7
7
  declare const isWebhookRoute: (path: string) => boolean;
8
- declare function createAgentsHono(config: AppConfig): Hono<hono_types0.BlankEnv, hono_types0.BlankSchema, "/">;
8
+ declare function createAgentsHono(config: AppConfig): Hono<hono_types8.BlankEnv, hono_types8.BlankSchema, "/">;
9
9
  //#endregion
10
10
  export { createAgentsHono, isWebhookRoute };
@@ -1,6 +1,6 @@
1
- import * as _inkeep_agents_core0 from "@inkeep/agents-core";
1
+ import * as _inkeep_agents_core2 from "@inkeep/agents-core";
2
2
 
3
3
  //#region src/data/db/manageDbClient.d.ts
4
- declare const manageDbClient: _inkeep_agents_core0.AgentsManageDatabaseClient;
4
+ declare const manageDbClient: _inkeep_agents_core2.AgentsManageDatabaseClient;
5
5
  //#endregion
6
6
  export { manageDbClient as default };
@@ -1,6 +1,6 @@
1
- import * as _inkeep_agents_core3 from "@inkeep/agents-core";
1
+ import * as _inkeep_agents_core0 from "@inkeep/agents-core";
2
2
 
3
3
  //#region src/data/db/runDbClient.d.ts
4
- declare const runDbClient: _inkeep_agents_core3.AgentsRunDatabaseClient;
4
+ declare const runDbClient: _inkeep_agents_core0.AgentsRunDatabaseClient;
5
5
  //#endregion
6
6
  export { runDbClient as default };
@@ -1,7 +1,7 @@
1
1
  import { OpenAPIHono } from "@hono/zod-openapi";
2
- import * as hono14 from "hono";
2
+ import * as hono12 from "hono";
3
3
 
4
4
  //#region src/domains/evals/routes/datasetTriggers.d.ts
5
- declare const app: OpenAPIHono<hono14.Env, {}, "/">;
5
+ declare const app: OpenAPIHono<hono12.Env, {}, "/">;
6
6
  //#endregion
7
7
  export { app as default };
@@ -1,7 +1,7 @@
1
1
  import { OpenAPIHono } from "@hono/zod-openapi";
2
- import * as hono16 from "hono";
2
+ import * as hono15 from "hono";
3
3
 
4
4
  //#region src/domains/evals/routes/index.d.ts
5
- declare const app: OpenAPIHono<hono16.Env, {}, "/">;
5
+ declare const app: OpenAPIHono<hono15.Env, {}, "/">;
6
6
  //#endregion
7
7
  export { app as default };
@@ -1,7 +1,7 @@
1
1
  import { Hono } from "hono";
2
- import * as hono_types10 from "hono/types";
2
+ import * as hono_types1 from "hono/types";
3
3
 
4
4
  //#region src/domains/evals/workflow/routes.d.ts
5
- declare const workflowRoutes: Hono<hono_types10.BlankEnv, hono_types10.BlankSchema, "/">;
5
+ declare const workflowRoutes: Hono<hono_types1.BlankEnv, hono_types1.BlankSchema, "/">;
6
6
  //#endregion
7
7
  export { workflowRoutes };
@@ -1,7 +1,7 @@
1
1
  import { OpenAPIHono } from "@hono/zod-openapi";
2
- import * as hono17 from "hono";
2
+ import * as hono16 from "hono";
3
3
 
4
4
  //#region src/domains/manage/routes/availableAgents.d.ts
5
- declare const app: OpenAPIHono<hono17.Env, {}, "/">;
5
+ declare const app: OpenAPIHono<hono16.Env, {}, "/">;
6
6
  //#endregion
7
7
  export { app as default };
@@ -1,7 +1,7 @@
1
1
  import { OpenAPIHono } from "@hono/zod-openapi";
2
- import * as hono18 from "hono";
2
+ import * as hono17 from "hono";
3
3
 
4
4
  //#region src/domains/manage/routes/conversations.d.ts
5
- declare const app: OpenAPIHono<hono18.Env, {}, "/">;
5
+ declare const app: OpenAPIHono<hono17.Env, {}, "/">;
6
6
  //#endregion
7
7
  export { app as default };
@@ -1,7 +1,7 @@
1
1
  import { OpenAPIHono } from "@hono/zod-openapi";
2
- import * as hono15 from "hono";
2
+ import * as hono18 from "hono";
3
3
 
4
4
  //#region src/domains/manage/routes/index.d.ts
5
- declare const app: OpenAPIHono<hono15.Env, {}, "/">;
5
+ declare const app: OpenAPIHono<hono18.Env, {}, "/">;
6
6
  //#endregion
7
7
  export { app as default };
@@ -1,10 +1,10 @@
1
1
  import { ManageAppVariables } from "../../../types/app.js";
2
2
  import { Hono } from "hono";
3
- import * as hono_types12 from "hono/types";
3
+ import * as hono_types11 from "hono/types";
4
4
 
5
5
  //#region src/domains/manage/routes/invitations.d.ts
6
6
  declare const invitationsRoutes: Hono<{
7
7
  Variables: ManageAppVariables;
8
- }, hono_types12.BlankSchema, "/">;
8
+ }, hono_types11.BlankSchema, "/">;
9
9
  //#endregion
10
10
  export { invitationsRoutes as default };
@@ -1,10 +1,10 @@
1
1
  import { ManageAppVariables } from "../../../types/app.js";
2
2
  import { Hono } from "hono";
3
- import * as hono_types5 from "hono/types";
3
+ import * as hono_types10 from "hono/types";
4
4
 
5
5
  //#region src/domains/manage/routes/passwordResetLinks.d.ts
6
6
  declare const passwordResetLinksRoutes: Hono<{
7
7
  Variables: ManageAppVariables;
8
- }, hono_types5.BlankSchema, "/">;
8
+ }, hono_types10.BlankSchema, "/">;
9
9
  //#endregion
10
10
  export { passwordResetLinksRoutes as default };
@@ -1,10 +1,10 @@
1
1
  import { ManageAppVariables } from "../../../types/app.js";
2
2
  import { Hono } from "hono";
3
- import * as hono_types6 from "hono/types";
3
+ import * as hono_types12 from "hono/types";
4
4
 
5
5
  //#region src/domains/manage/routes/signoz.d.ts
6
6
  declare const app: Hono<{
7
7
  Variables: ManageAppVariables;
8
- }, hono_types6.BlankSchema, "/">;
8
+ }, hono_types12.BlankSchema, "/">;
9
9
  //#endregion
10
10
  export { app as default };
@@ -1,7 +1,7 @@
1
1
  import { Hono } from "hono";
2
- import * as hono_types8 from "hono/types";
2
+ import * as hono_types3 from "hono/types";
3
3
 
4
4
  //#region src/domains/mcp/routes/mcp.d.ts
5
- declare const app: Hono<hono_types8.BlankEnv, hono_types8.BlankSchema, "/">;
5
+ declare const app: Hono<hono_types3.BlankEnv, hono_types3.BlankSchema, "/">;
6
6
  //#endregion
7
7
  export { app as default };
@@ -136,6 +136,7 @@ declare class Agent {
136
136
  private currentCompressor;
137
137
  private executionContext;
138
138
  private functionToolRelationshipIdByName;
139
+ private taskDenialRedirects;
139
140
  constructor(config: AgentConfig, executionContext: FullExecutionContext, credentialStoreRegistry?: CredentialStoreRegistry);
140
141
  /**
141
142
  * Get the maximum number of generation steps for this agent
@@ -174,6 +175,12 @@ declare class Agent {
174
175
  * Set delegation ID for this agent instance
175
176
  */
176
177
  setDelegationId(delegationId: string | undefined): void;
178
+ private recordDenial;
179
+ getTaskDenialRedirects(): Array<{
180
+ toolName: string;
181
+ toolCallId: string;
182
+ reason: string;
183
+ }>;
177
184
  /**
178
185
  * Get streaming helper if this agent should stream to user
179
186
  * Returns undefined for delegated agents to prevent streaming data operations to user
@@ -107,6 +107,7 @@ var Agent = class {
107
107
  currentCompressor = null;
108
108
  executionContext;
109
109
  functionToolRelationshipIdByName = /* @__PURE__ */ new Map();
110
+ taskDenialRedirects = [];
110
111
  constructor(config, executionContext, credentialStoreRegistry) {
111
112
  this.artifactComponents = config.artifactComponents || [];
112
113
  this.executionContext = executionContext;
@@ -245,6 +246,16 @@ var Agent = class {
245
246
  setDelegationId(delegationId) {
246
247
  this.delegationId = delegationId;
247
248
  }
249
+ recordDenial(toolName, toolCallId, reason) {
250
+ this.taskDenialRedirects.push({
251
+ toolName,
252
+ toolCallId,
253
+ reason: reason ?? "Tool call was denied by the user."
254
+ });
255
+ }
256
+ getTaskDenialRedirects() {
257
+ return this.taskDenialRedirects;
258
+ }
248
259
  /**
249
260
  * Get streaming helper if this agent should stream to user
250
261
  * Returns undefined for delegated agents to prevent streaming data operations to user
@@ -375,6 +386,7 @@ var Agent = class {
375
386
  toolCallId,
376
387
  output: result
377
388
  });
389
+ if (isDeniedResult) return result.reason ?? "Tool call was denied by the user.";
378
390
  return result;
379
391
  } catch (error) {
380
392
  const duration = Date.now() - startTime;
@@ -545,6 +557,7 @@ var Agent = class {
545
557
  toolCallId,
546
558
  reason: approvalResult.reason
547
559
  }, "Tool execution denied by user");
560
+ this.recordDenial(toolName, toolCallId, approvalResult.reason);
548
561
  denialSpan.setStatus({ code: SpanStatusCode.OK });
549
562
  denialSpan.end();
550
563
  return createDeniedToolResult(toolCallId, approvalResult.reason);
@@ -772,6 +785,7 @@ var Agent = class {
772
785
  toolCallId,
773
786
  reason: approvalResult.reason
774
787
  }, "Function tool execution denied by user");
788
+ this.recordDenial(functionToolDef.name, toolCallId, approvalResult.reason);
775
789
  denialSpan.setStatus({ code: SpanStatusCode.OK });
776
790
  denialSpan.end();
777
791
  return createDeniedToolResult(toolCallId, approvalResult.reason);
@@ -321,6 +321,15 @@ const createTaskHandler = (config, credentialStoreRegistry) => {
321
321
  text: part.text
322
322
  };
323
323
  });
324
+ const denialRedirects = agent?.getTaskDenialRedirects() ?? [];
325
+ if (denialRedirects.length > 0) {
326
+ const sanitize = (s) => s.replace(/\n/g, " ").slice(0, 200);
327
+ const redirectNote = denialRedirects.map((d) => `- ${d.toolName} (${d.toolCallId}): ${sanitize(d.reason)}`).join("\n");
328
+ parts.unshift({
329
+ kind: "text",
330
+ text: `[NOTE: Some tool calls were denied during task execution, which may have changed the original request:\n${redirectNote}\nThe result below reflects the actual execution.]\n\n`
331
+ });
332
+ }
324
333
  return {
325
334
  status: { state: TaskState.Completed },
326
335
  artifacts: [{
@@ -29,9 +29,9 @@ declare const ConversationHistorySummarySchema: z.ZodObject<{
29
29
  tool_call_id: z.ZodString;
30
30
  content_summary: z.ZodString;
31
31
  relevance: z.ZodEnum<{
32
+ low: "low";
32
33
  high: "high";
33
34
  medium: "medium";
34
- low: "low";
35
35
  }>;
36
36
  }, z.core.$strip>>>;
37
37
  conversation_flow: z.ZodObject<{
@@ -9,9 +9,9 @@ declare const ImageUrlSchema: z.ZodUnion<readonly [z.ZodURL, z.ZodString]>;
9
9
  /** OpenAI-specific image detail level. Has no effect on other providers. */
10
10
  declare const ImageDetailEnum: readonly ["auto", "low", "high"];
11
11
  declare const ImageDetailSchema: z.ZodEnum<{
12
- high: "high";
13
- low: "low";
14
12
  auto: "auto";
13
+ low: "low";
14
+ high: "high";
15
15
  }>;
16
16
  type ImageDetail = z.infer<typeof ImageDetailSchema>;
17
17
  declare const ImageContentItemSchema: z.ZodObject<{
@@ -19,9 +19,9 @@ declare const ImageContentItemSchema: z.ZodObject<{
19
19
  image_url: z.ZodObject<{
20
20
  url: z.ZodUnion<readonly [z.ZodURL, z.ZodString]>;
21
21
  detail: z.ZodOptional<z.ZodEnum<{
22
- high: "high";
23
- low: "low";
24
22
  auto: "auto";
23
+ low: "low";
24
+ high: "high";
25
25
  }>>;
26
26
  }, z.core.$strip>;
27
27
  }, z.core.$strip>;
@@ -1,4 +1,4 @@
1
- import * as _inkeep_agents_core2 from "@inkeep/agents-core";
1
+ import * as _inkeep_agents_core3 from "@inkeep/agents-core";
2
2
  import { BreakdownComponentDef, ContextBreakdown, calculateBreakdownTotal, createEmptyBreakdown } from "@inkeep/agents-core";
3
3
 
4
4
  //#region src/domains/run/utils/token-estimator.d.ts
@@ -17,7 +17,7 @@ interface AssembleResult {
17
17
  /** The assembled prompt string */
18
18
  prompt: string;
19
19
  /** Token breakdown for each component */
20
- breakdown: _inkeep_agents_core2.ContextBreakdown;
20
+ breakdown: _inkeep_agents_core3.ContextBreakdown;
21
21
  }
22
22
  //#endregion
23
23
  export { AssembleResult, type BreakdownComponentDef, type ContextBreakdown, calculateBreakdownTotal, createEmptyBreakdown, estimateTokens };
@@ -107,7 +107,7 @@ declare function createInvocationIdempotentStep(params: {
107
107
  projectId: string;
108
108
  tenantId: string;
109
109
  id: string;
110
- status: "pending" | "completed" | "failed" | "running" | "cancelled";
110
+ status: "pending" | "completed" | "running" | "failed" | "cancelled";
111
111
  resolvedPayload?: Record<string, unknown> | null | undefined;
112
112
  };
113
113
  alreadyExists: boolean;
@@ -147,7 +147,7 @@ declare function markRunningStep(params: {
147
147
  projectId: string;
148
148
  tenantId: string;
149
149
  id: string;
150
- status: "pending" | "completed" | "failed" | "running" | "cancelled";
150
+ status: "pending" | "completed" | "running" | "failed" | "cancelled";
151
151
  resolvedPayload?: Record<string, unknown> | null | undefined;
152
152
  }>;
153
153
  /**
@@ -174,7 +174,7 @@ declare function addConversationIdStep(params: {
174
174
  projectId: string;
175
175
  tenantId: string;
176
176
  id: string;
177
- status: "pending" | "completed" | "failed" | "running" | "cancelled";
177
+ status: "pending" | "completed" | "running" | "failed" | "cancelled";
178
178
  resolvedPayload?: Record<string, unknown> | null | undefined;
179
179
  } | undefined>;
180
180
  /**
@@ -199,7 +199,7 @@ declare function markCompletedStep(params: {
199
199
  projectId: string;
200
200
  tenantId: string;
201
201
  id: string;
202
- status: "pending" | "completed" | "failed" | "running" | "cancelled";
202
+ status: "pending" | "completed" | "running" | "failed" | "cancelled";
203
203
  resolvedPayload?: Record<string, unknown> | null | undefined;
204
204
  } | undefined>;
205
205
  /**
@@ -224,7 +224,7 @@ declare function markFailedStep(params: {
224
224
  projectId: string;
225
225
  tenantId: string;
226
226
  id: string;
227
- status: "pending" | "completed" | "failed" | "running" | "cancelled";
227
+ status: "pending" | "completed" | "running" | "failed" | "cancelled";
228
228
  resolvedPayload?: Record<string, unknown> | null | undefined;
229
229
  } | undefined>;
230
230
  /**
package/dist/env.d.ts CHANGED
@@ -14,11 +14,11 @@ declare const envSchema: z.ZodObject<{
14
14
  pentest: "pentest";
15
15
  }>>;
16
16
  LOG_LEVEL: z.ZodDefault<z.ZodEnum<{
17
- error: "error";
18
17
  trace: "trace";
19
18
  debug: "debug";
20
19
  info: "info";
21
20
  warn: "warn";
21
+ error: "error";
22
22
  }>>;
23
23
  INKEEP_AGENTS_MANAGE_DATABASE_URL: z.ZodString;
24
24
  INKEEP_AGENTS_RUN_DATABASE_URL: z.ZodString;
@@ -71,7 +71,7 @@ declare const envSchema: z.ZodObject<{
71
71
  declare const env: {
72
72
  NODE_ENV: "development" | "production" | "test";
73
73
  ENVIRONMENT: "development" | "production" | "test" | "pentest";
74
- LOG_LEVEL: "error" | "trace" | "debug" | "info" | "warn";
74
+ LOG_LEVEL: "trace" | "debug" | "info" | "warn" | "error";
75
75
  INKEEP_AGENTS_MANAGE_DATABASE_URL: string;
76
76
  INKEEP_AGENTS_RUN_DATABASE_URL: string;
77
77
  INKEEP_AGENTS_API_URL: string;