@backendkit-labs/agent-core 0.27.1 → 0.29.0

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 (77) hide show
  1. package/README.md +1262 -1168
  2. package/dist/engine/AgentEngine.d.ts +25 -0
  3. package/dist/engine/AgentEngine.d.ts.map +1 -1
  4. package/dist/engine/AgentEngine.js +365 -27
  5. package/dist/engine/AgentEngine.js.map +1 -1
  6. package/dist/engine/ContextManager.d.ts +106 -0
  7. package/dist/engine/ContextManager.d.ts.map +1 -0
  8. package/dist/engine/ContextManager.js +257 -0
  9. package/dist/engine/ContextManager.js.map +1 -0
  10. package/dist/engine/HistoryManager.d.ts +8 -0
  11. package/dist/engine/HistoryManager.d.ts.map +1 -1
  12. package/dist/engine/HistoryManager.js +19 -0
  13. package/dist/engine/HistoryManager.js.map +1 -1
  14. package/dist/engine/contextOverflow.d.ts +7 -0
  15. package/dist/engine/contextOverflow.d.ts.map +1 -0
  16. package/dist/engine/contextOverflow.js +40 -0
  17. package/dist/engine/contextOverflow.js.map +1 -0
  18. package/dist/engine/createBaseEngine.d.ts +43 -0
  19. package/dist/engine/createBaseEngine.d.ts.map +1 -1
  20. package/dist/engine/createBaseEngine.js +13 -0
  21. package/dist/engine/createBaseEngine.js.map +1 -1
  22. package/dist/engine/secrets.d.ts +9 -0
  23. package/dist/engine/secrets.d.ts.map +1 -0
  24. package/dist/engine/secrets.js +24 -0
  25. package/dist/engine/secrets.js.map +1 -0
  26. package/dist/guardrails/GuardrailRunner.d.ts +13 -0
  27. package/dist/guardrails/GuardrailRunner.d.ts.map +1 -0
  28. package/dist/guardrails/GuardrailRunner.js +64 -0
  29. package/dist/guardrails/GuardrailRunner.js.map +1 -0
  30. package/dist/guardrails/builtins.d.ts +82 -0
  31. package/dist/guardrails/builtins.d.ts.map +1 -0
  32. package/dist/guardrails/builtins.js +232 -0
  33. package/dist/guardrails/builtins.js.map +1 -0
  34. package/dist/guardrails/index.d.ts +5 -0
  35. package/dist/guardrails/index.d.ts.map +1 -0
  36. package/dist/guardrails/index.js +15 -0
  37. package/dist/guardrails/index.js.map +1 -0
  38. package/dist/guardrails/types.d.ts +70 -0
  39. package/dist/guardrails/types.d.ts.map +1 -0
  40. package/dist/guardrails/types.js +3 -0
  41. package/dist/guardrails/types.js.map +1 -0
  42. package/dist/index.d.ts +9 -1
  43. package/dist/index.d.ts.map +1 -1
  44. package/dist/index.js +28 -4
  45. package/dist/index.js.map +1 -1
  46. package/dist/jobs/JobRegistry.d.ts +53 -0
  47. package/dist/jobs/JobRegistry.d.ts.map +1 -0
  48. package/dist/jobs/JobRegistry.js +121 -0
  49. package/dist/jobs/JobRegistry.js.map +1 -0
  50. package/dist/jobs/tools.d.ts +5 -0
  51. package/dist/jobs/tools.d.ts.map +1 -0
  52. package/dist/jobs/tools.js +51 -0
  53. package/dist/jobs/tools.js.map +1 -0
  54. package/dist/mcp/MCPClientManager.js +2 -2
  55. package/dist/mcp/MCPClientManager.js.map +1 -1
  56. package/dist/observability/MetricsCollector.d.ts +2 -0
  57. package/dist/observability/MetricsCollector.d.ts.map +1 -1
  58. package/dist/observability/MetricsCollector.js +15 -0
  59. package/dist/observability/MetricsCollector.js.map +1 -1
  60. package/dist/observability/ObservabilityManager.d.ts +2 -0
  61. package/dist/observability/ObservabilityManager.d.ts.map +1 -1
  62. package/dist/observability/ObservabilityManager.js +45 -0
  63. package/dist/observability/ObservabilityManager.js.map +1 -1
  64. package/dist/observability/Tracer.d.ts +12 -0
  65. package/dist/observability/Tracer.d.ts.map +1 -1
  66. package/dist/observability/Tracer.js +19 -0
  67. package/dist/observability/Tracer.js.map +1 -1
  68. package/dist/observability/types.d.ts +6 -0
  69. package/dist/observability/types.d.ts.map +1 -1
  70. package/dist/observability/types.js.map +1 -1
  71. package/dist/tools/defineTool.d.ts +2 -0
  72. package/dist/tools/defineTool.d.ts.map +1 -1
  73. package/dist/tools/defineTool.js +1 -0
  74. package/dist/tools/defineTool.js.map +1 -1
  75. package/dist/types/index.d.ts +97 -6
  76. package/dist/types/index.d.ts.map +1 -1
  77. package/package.json +87 -87
@@ -1 +1 @@
1
- {"version":3,"file":"HistoryManager.js","sourceRoot":"","sources":["../../src/engine/HistoryManager.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"HistoryManager.js","sourceRoot":"","sources":["../../src/engine/HistoryManager.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,7 @@
1
+ /**
2
+ * True when a provider rejected the request because it did not fit the model's context window
3
+ * (OpenAI-compatible incl. DeepSeek, Anthropic, Ollama). Rate limits, 5xx and unrelated 400s are not overflow.
4
+ * Providers that wrap the failure in a plain `Error` (no status) are matched on the message alone.
5
+ */
6
+ export declare function isContextOverflowError(err: unknown): boolean;
7
+ //# sourceMappingURL=contextOverflow.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"contextOverflow.d.ts","sourceRoot":"","sources":["../../src/engine/contextOverflow.ts"],"names":[],"mappings":"AAmBA;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAQ5D"}
@@ -0,0 +1,40 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.isContextOverflowError = isContextOverflowError;
4
+ const OVERFLOW_PATTERNS = [
5
+ /maximum context length/i,
6
+ /context[_ ]length/i,
7
+ /prompt is too long/i,
8
+ /too many tokens/i,
9
+ /exceeds? the (model|context) (limit|window)/i,
10
+ /reduce the length/i,
11
+ /input is too long/i,
12
+ ];
13
+ function statusOf(err) {
14
+ if (typeof err !== 'object' || err === null)
15
+ return undefined;
16
+ const e = err;
17
+ for (const v of [e.status, e.statusCode, e.response?.status]) {
18
+ if (typeof v === 'number')
19
+ return v;
20
+ }
21
+ return undefined;
22
+ }
23
+ /**
24
+ * True when a provider rejected the request because it did not fit the model's context window
25
+ * (OpenAI-compatible incl. DeepSeek, Anthropic, Ollama). Rate limits, 5xx and unrelated 400s are not overflow.
26
+ * Providers that wrap the failure in a plain `Error` (no status) are matched on the message alone.
27
+ */
28
+ function isContextOverflowError(err) {
29
+ const message = err instanceof Error ? err.message : typeof err === 'string' ? err : err?.message;
30
+ const code = err?.code;
31
+ if (code === 'context_length_exceeded')
32
+ return true;
33
+ if (typeof message !== 'string')
34
+ return false;
35
+ const status = statusOf(err);
36
+ if (status !== undefined && status !== 400 && status !== 413)
37
+ return false;
38
+ return OVERFLOW_PATTERNS.some(p => p.test(message));
39
+ }
40
+ //# sourceMappingURL=contextOverflow.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"contextOverflow.js","sourceRoot":"","sources":["../../src/engine/contextOverflow.ts"],"names":[],"mappings":";;AAwBA,wDAQC;AAhCD,MAAM,iBAAiB,GAAa;IAChC,yBAAyB;IACzB,oBAAoB;IACpB,qBAAqB;IACrB,kBAAkB;IAClB,8CAA8C;IAC9C,oBAAoB;IACpB,oBAAoB;CACvB,CAAC;AAEF,SAAS,QAAQ,CAAC,GAAY;IAC1B,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IAC9D,MAAM,CAAC,GAAG,GAAkF,CAAC;IAC7F,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE,CAAC;QAC3D,IAAI,OAAO,CAAC,KAAK,QAAQ;YAAE,OAAO,CAAC,CAAC;IACxC,CAAC;IACD,OAAO,SAAS,CAAC;AACrB,CAAC;AAED;;;;GAIG;AACH,SAAgB,sBAAsB,CAAC,GAAY;IAC/C,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAE,GAAoC,EAAE,OAAO,CAAC;IACpI,MAAM,IAAI,GAAI,GAAiC,EAAE,IAAI,CAAC;IACtD,IAAI,IAAI,KAAK,yBAAyB;QAAE,OAAO,IAAI,CAAC;IACpD,IAAI,OAAO,OAAO,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC9C,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;IAC7B,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,GAAG,IAAI,MAAM,KAAK,GAAG;QAAE,OAAO,KAAK,CAAC;IAC3E,OAAO,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;AACxD,CAAC"}
@@ -1,4 +1,5 @@
1
1
  import { AgentEngine } from './AgentEngine';
2
+ import type { JobRegistryOptions } from '../jobs/JobRegistry';
2
3
  import type { AgentProfile, LLMProvider, ToolDefinition, ToolApprovalDecision, SessionMemoryData, ProjectStoreData, Skill } from '../types';
3
4
  import type { Transport } from '../transport/Transport';
4
5
  import type { Orchestrator } from '../orchestration/orchestrator';
@@ -8,6 +9,8 @@ import type { ObservabilityConfig } from '../observability/types';
8
9
  import type { MemorySystem } from '../agent-memory/MemorySystem';
9
10
  import type { AgentDiscoveryConfig } from '../agent-discovery/types';
10
11
  import type { IterationMode, IterationStats } from './IterationManager';
12
+ import type { ContextOptions } from './ContextManager';
13
+ import type { Guardrail } from '../guardrails/types';
11
14
  export interface BaseEngineOptions {
12
15
  /**
13
16
  * Pre-instantiated LLM providers keyed by provider ID.
@@ -30,6 +33,22 @@ export interface BaseEngineOptions {
30
33
  transport?: Transport;
31
34
  /** Max LLM iterations per run() call. Default: 100. */
32
35
  maxIterations?: number;
36
+ /**
37
+ * Default time limit for one tool call, in ms (a tool's own `timeoutMs` wins). On expiry the call's
38
+ * `ctx.signal` is aborted and the model receives `Error: TOOL_TIMEOUT …`; a late result is discarded.
39
+ * Time waiting for approval does not count. Default: no limit.
40
+ */
41
+ toolTimeoutMs?: number;
42
+ /**
43
+ * Enables background jobs: registers `job_output`, `job_list` and `job_kill` (add them to `allowedTools`
44
+ * of the agents that use them) and gives tools `ctx.jobs`. `true` uses the defaults (8 live jobs per agent,
45
+ * 64 KB of output each, finished jobs kept 10 min). Each agent only sees its own jobs.
46
+ */
47
+ jobs?: boolean | JobRegistryOptions;
48
+ /** Resolves `AgentProfile.secrets` references whose env var is unset (see EngineOptions.secretResolver). */
49
+ secretResolver?: (name: string, agentId: string) => string | undefined | Promise<string | undefined>;
50
+ /** Wait for a tool to wind down after its signal is aborted, before answering. Default 2000 ms. */
51
+ toolTimeoutGraceMs?: number;
33
52
  /** Max parallel agent delegations via ask_agent. Default: 6. */
34
53
  maxParallelAgents?: number;
35
54
  /**
@@ -57,6 +76,30 @@ export interface BaseEngineOptions {
57
76
  * long-running autonomous agents.
58
77
  */
59
78
  maxContextMessages?: number;
79
+ /**
80
+ * Token-aware context control (see ContextOptions): truncates old bulky tool results, then summarizes
81
+ * (or drops) the oldest turns to keep the history under `context.maxTokens`. Can be combined with
82
+ * `maxContextMessages`.
83
+ *
84
+ * @example
85
+ * context: { maxTokens: 60_000, summarizer: { provider: 'deepseek', model: 'deepseek-chat' } }
86
+ */
87
+ context?: ContextOptions;
88
+ /**
89
+ * Guardrails on user input, tool arguments, tool results and model answers; applied to the main agent
90
+ * and every sub-agent. Ready-made: piiGuardrail, secretLeakGuardrail, promptInjectionGuardrail,
91
+ * maxLengthGuardrail, denyListGuardrail, llmJudgeGuardrail.
92
+ *
93
+ * @example
94
+ * guardrails: [secretLeakGuardrail(), piiGuardrail({ mode: 'redact' }), promptInjectionGuardrail()]
95
+ */
96
+ guardrails?: Guardrail[];
97
+ /**
98
+ * `after` (default): stream the answer and, if an output guardrail changes it, correct the stored
99
+ * history and emit a `guardrail` event carrying the `replacement`. `buffer`: hold the tokens until the
100
+ * answer is checked, so nothing unchecked is shown (no streaming).
101
+ */
102
+ guardrailOutputMode?: 'after' | 'buffer';
60
103
  /** Absolute path used as the working directory for tool calls. */
61
104
  workingDir?: string;
62
105
  /**
@@ -1 +1 @@
1
- {"version":3,"file":"createBaseEngine.d.ts","sourceRoot":"","sources":["../../src/engine/createBaseEngine.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"createBaseEngine.d.ts","sourceRoot":"","sources":["../../src/engine/createBaseEngine.ts"],"names":[],"mappings":"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"}
@@ -6,6 +6,8 @@ const AgentRegistry_1 = require("./AgentRegistry");
6
6
  const ToolRegistry_1 = require("./ToolRegistry");
7
7
  const ProviderRegistry_1 = require("./ProviderRegistry");
8
8
  const StdoutTransport_1 = require("../transport/StdoutTransport");
9
+ const JobRegistry_1 = require("../jobs/JobRegistry");
10
+ const tools_1 = require("../jobs/tools");
9
11
  const MCPClientManager_1 = require("../mcp/MCPClientManager");
10
12
  const ObservabilityManager_1 = require("../observability/ObservabilityManager");
11
13
  const discoverAgents_1 = require("../agent-discovery/discoverAgents");
@@ -32,6 +34,10 @@ function createBaseEngine(opts) {
32
34
  for (const tool of opts.memorySystem.getTools())
33
35
  tools.register(tool);
34
36
  }
37
+ const jobs = opts.jobs ? (0, JobRegistry_1.createJobRegistry)(opts.jobs === true ? {} : opts.jobs) : undefined;
38
+ if (jobs)
39
+ for (const tool of tools_1.JOB_TOOLS)
40
+ tools.register(tool);
35
41
  const providers = new ProviderRegistry_1.ProviderRegistry();
36
42
  for (const [id, provider] of Object.entries(opts.providers)) {
37
43
  providers.register(id, provider);
@@ -92,10 +98,17 @@ function createBaseEngine(opts) {
92
98
  ...(opts.onToolApproval ? { onToolApproval: opts.onToolApproval } : {}),
93
99
  ...(opts.iterationMode ? { iterationMode: opts.iterationMode } : {}),
94
100
  ...(opts.maxParallelTools ? { maxParallelTools: opts.maxParallelTools } : {}),
101
+ ...(opts.toolTimeoutMs ? { toolTimeoutMs: opts.toolTimeoutMs } : {}),
102
+ ...(opts.secretResolver ? { secretResolver: opts.secretResolver } : {}),
103
+ ...(jobs ? { jobs } : {}),
104
+ ...(opts.toolTimeoutGraceMs !== undefined ? { toolTimeoutGraceMs: opts.toolTimeoutGraceMs } : {}),
95
105
  ...(opts.abortOnBudget ? { abortOnBudget: true } : {}),
96
106
  ...(opts.onIterationLimit ? { onIterationLimit: opts.onIterationLimit } : {}),
97
107
  ...(opts.onStep ? { onStep: opts.onStep } : {}),
98
108
  ...(opts.maxContextMessages ? { maxContextMessages: opts.maxContextMessages } : {}),
109
+ ...(opts.context ? { context: opts.context } : {}),
110
+ ...(opts.guardrails?.length ? { guardrails: opts.guardrails } : {}),
111
+ ...(opts.guardrailOutputMode ? { guardrailOutputMode: opts.guardrailOutputMode } : {}),
99
112
  ...(opts.subAgentContextMessages ? { subAgentContextMessages: opts.subAgentContextMessages } : {}),
100
113
  ...(opts.historyPath ? { historyPath: opts.historyPath } : {}),
101
114
  projectContext: opts.projectContext,
@@ -1 +1 @@
1
- {"version":3,"file":"createBaseEngine.js","sourceRoot":"","sources":["../../src/engine/createBaseEngine.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"createBaseEngine.js","sourceRoot":"","sources":["../../src/engine/createBaseEngine.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,9 @@
1
+ import type { AgentProfile } from '../types';
2
+ export type SecretResolver = (name: string, agentId: string) => string | undefined | Promise<string | undefined>;
3
+ /**
4
+ * Resolves a profile's `secrets` to plain strings, on every call so a rotated env var or vault value applies
5
+ * without a restart. A string is used as is; `{ env }` reads `process.env`; when that is empty the
6
+ * `resolver` is asked. Names that end with no value are left out (the tool decides how to fail).
7
+ */
8
+ export declare function resolveSecrets(profile: AgentProfile | undefined, resolver?: SecretResolver): Promise<Record<string, string>>;
9
+ //# sourceMappingURL=secrets.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"secrets.d.ts","sourceRoot":"","sources":["../../src/engine/secrets.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAa,MAAM,UAAU,CAAC;AAExD,MAAM,MAAM,cAAc,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;AAEjH;;;;GAIG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,YAAY,GAAG,SAAS,EAAE,QAAQ,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAUlI"}
@@ -0,0 +1,24 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.resolveSecrets = resolveSecrets;
4
+ /**
5
+ * Resolves a profile's `secrets` to plain strings, on every call so a rotated env var or vault value applies
6
+ * without a restart. A string is used as is; `{ env }` reads `process.env`; when that is empty the
7
+ * `resolver` is asked. Names that end with no value are left out (the tool decides how to fail).
8
+ */
9
+ async function resolveSecrets(profile, resolver) {
10
+ const out = {};
11
+ for (const [name, spec] of Object.entries(profile?.secrets ?? {})) {
12
+ let value;
13
+ if (typeof spec === 'string')
14
+ value = spec;
15
+ else
16
+ value = process.env[spec.env];
17
+ if (!value && typeof spec !== 'string')
18
+ value = await resolver?.(name, profile.id);
19
+ if (value)
20
+ out[name] = value;
21
+ }
22
+ return out;
23
+ }
24
+ //# sourceMappingURL=secrets.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"secrets.js","sourceRoot":"","sources":["../../src/engine/secrets.ts"],"names":[],"mappings":";;AASA,wCAUC;AAfD;;;;GAIG;AACI,KAAK,UAAU,cAAc,CAAC,OAAiC,EAAE,QAAyB;IAC7F,MAAM,GAAG,GAA2B,EAAE,CAAC;IACvC,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,IAAI,EAAE,CAAC,EAAE,CAAC;QAChE,IAAI,KAAyB,CAAC;QAC9B,IAAI,OAAO,IAAI,KAAK,QAAQ;YAAE,KAAK,GAAG,IAAI,CAAC;;YACtC,KAAK,GAAG,OAAO,CAAC,GAAG,CAAE,IAAkB,CAAC,GAAG,CAAC,CAAC;QAClD,IAAI,CAAC,KAAK,IAAI,OAAO,IAAI,KAAK,QAAQ;YAAE,KAAK,GAAG,MAAM,QAAQ,EAAE,CAAC,IAAI,EAAE,OAAQ,CAAC,EAAE,CAAC,CAAC;QACpF,IAAI,KAAK;YAAE,GAAG,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;IACjC,CAAC;IACD,OAAO,GAAG,CAAC;AACf,CAAC"}
@@ -0,0 +1,13 @@
1
+ import type { Guardrail, GuardrailContext, GuardrailOutcome, GuardrailPhase } from './types';
2
+ /**
3
+ * Runs the guardrails of one phase in order. A `redact` feeds its text to the next guardrail; the first
4
+ * `block` wins. Guardrails in `dryRun` report but never change or block anything.
5
+ * Everything that happened comes back in `outcome.events`; the caller decides how to surface it.
6
+ */
7
+ export declare class GuardrailRunner {
8
+ private readonly byPhase;
9
+ constructor(guardrails: Guardrail[]);
10
+ has(phase: GuardrailPhase): boolean;
11
+ run(ctx: GuardrailContext): Promise<GuardrailOutcome>;
12
+ }
13
+ //# sourceMappingURL=GuardrailRunner.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"GuardrailRunner.d.ts","sourceRoot":"","sources":["../../src/guardrails/GuardrailRunner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACR,SAAS,EACT,gBAAgB,EAEhB,gBAAgB,EAChB,cAAc,EACjB,MAAM,SAAS,CAAC;AAEjB;;;;GAIG;AACH,qBAAa,eAAe;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA0C;gBAEtD,UAAU,EAAE,SAAS,EAAE;IAUnC,GAAG,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO;IAI7B,GAAG,CAAC,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAwC9D"}
@@ -0,0 +1,64 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.GuardrailRunner = void 0;
4
+ /**
5
+ * Runs the guardrails of one phase in order. A `redact` feeds its text to the next guardrail; the first
6
+ * `block` wins. Guardrails in `dryRun` report but never change or block anything.
7
+ * Everything that happened comes back in `outcome.events`; the caller decides how to surface it.
8
+ */
9
+ class GuardrailRunner {
10
+ byPhase = new Map();
11
+ constructor(guardrails) {
12
+ for (const g of guardrails) {
13
+ for (const phase of g.phases) {
14
+ const list = this.byPhase.get(phase) ?? [];
15
+ list.push(g);
16
+ this.byPhase.set(phase, list);
17
+ }
18
+ }
19
+ }
20
+ has(phase) {
21
+ return (this.byPhase.get(phase)?.length ?? 0) > 0;
22
+ }
23
+ async run(ctx) {
24
+ const guardrails = this.byPhase.get(ctx.phase);
25
+ const events = [];
26
+ if (!guardrails?.length)
27
+ return { content: ctx.content, changed: false, events };
28
+ let content = ctx.content;
29
+ let changed = false;
30
+ const base = { phase: ctx.phase, agentId: ctx.agentId, ...(ctx.toolName ? { tool: ctx.toolName } : {}) };
31
+ for (const g of guardrails) {
32
+ const dryRun = g.dryRun === true;
33
+ let decision;
34
+ try {
35
+ decision = await g.check({ ...ctx, content });
36
+ }
37
+ catch (err) {
38
+ const reason = `guardrail error: ${err instanceof Error ? err.message : String(err)}`;
39
+ if ((g.failMode ?? 'closed') === 'open' || dryRun) {
40
+ events.push({ ...base, name: g.name, action: 'error', reason, dryRun });
41
+ continue;
42
+ }
43
+ events.push({ ...base, name: g.name, action: 'block', reason, dryRun: false });
44
+ return { content, changed, blocked: { guardrail: g.name, reason }, events };
45
+ }
46
+ if (decision.action === 'allow')
47
+ continue;
48
+ if (decision.action === 'redact') {
49
+ events.push({ ...base, name: g.name, action: 'redact', reason: decision.reason, dryRun });
50
+ if (!dryRun && decision.content !== content) {
51
+ content = decision.content;
52
+ changed = true;
53
+ }
54
+ continue;
55
+ }
56
+ events.push({ ...base, name: g.name, action: 'block', reason: decision.reason, dryRun });
57
+ if (!dryRun)
58
+ return { content, changed, blocked: { guardrail: g.name, reason: decision.reason }, events };
59
+ }
60
+ return { content, changed, events };
61
+ }
62
+ }
63
+ exports.GuardrailRunner = GuardrailRunner;
64
+ //# sourceMappingURL=GuardrailRunner.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"GuardrailRunner.js","sourceRoot":"","sources":["../../src/guardrails/GuardrailRunner.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,82 @@
1
+ import type { LLMProvider } from '../types';
2
+ import type { Guardrail, GuardrailPhase } from './types';
3
+ export type PiiKind = 'email' | 'phone' | 'card' | 'iban' | 'ssn';
4
+ export interface PiiGuardrailOptions {
5
+ /** Default: all kinds. */
6
+ kinds?: PiiKind[];
7
+ /** `redact` (default) replaces the match with `[REDACTED:kind]`; `block` rejects the whole text. */
8
+ mode?: 'redact' | 'block';
9
+ /** Default `['tool_result', 'output']`: user input often needs its own data (e.g. "email Ana at …"). */
10
+ phases?: GuardrailPhase[];
11
+ dryRun?: boolean;
12
+ }
13
+ /** Finds emails, phone numbers (heuristic), payment cards (Luhn), IBANs (mod 97) and US SSNs. */
14
+ export declare function piiGuardrail(options?: PiiGuardrailOptions): Guardrail;
15
+ export interface SecretLeakGuardrailOptions {
16
+ /** Secret values shorter than this are ignored to avoid false positives. Default 8. */
17
+ minLength?: number;
18
+ /** Extra patterns for credentials that are not agent secrets. Default: common key formats. */
19
+ patterns?: RegExp[];
20
+ /** For `tool_result` and `output`. `redact` (default) masks the secret; `block` drops the text. */
21
+ mode?: 'redact' | 'block';
22
+ /** Default: `tool_call`, `tool_result`, `output`. */
23
+ phases?: GuardrailPhase[];
24
+ dryRun?: boolean;
25
+ }
26
+ export declare const COMMON_SECRET_PATTERNS: RegExp[];
27
+ /**
28
+ * Keeps credentials out of the model's reach and the user's screen. The literal values of every agent's
29
+ * `AgentProfile.secrets` (not only the active agent's) plus common key formats are masked in tool results
30
+ * and answers, and blocked in tool arguments: a secret the model passes to a tool means it already saw it.
31
+ */
32
+ export declare function secretLeakGuardrail(options?: SecretLeakGuardrailOptions): Guardrail;
33
+ export interface PromptInjectionGuardrailOptions {
34
+ /** `mark` (default) wraps the content as untrusted data with a warning; `block` withholds it. */
35
+ mode?: 'mark' | 'block';
36
+ /** Extra patterns on top of the built-in ones. */
37
+ patterns?: RegExp[];
38
+ /** Default `['tool_result']`. */
39
+ phases?: GuardrailPhase[];
40
+ dryRun?: boolean;
41
+ }
42
+ export declare const INJECTION_PATTERNS: RegExp[];
43
+ /**
44
+ * Heuristic defence against instructions hidden in content the model reads (web pages, files, emails).
45
+ * It cannot prove content is safe: it flags well-known attack phrasings and marks the text as data.
46
+ */
47
+ export declare function promptInjectionGuardrail(options?: PromptInjectionGuardrailOptions): Guardrail;
48
+ export interface MaxLengthGuardrailOptions {
49
+ max: number;
50
+ /** `truncate` (default) cuts the text; `block` rejects it. */
51
+ mode?: 'truncate' | 'block';
52
+ /** Default `['tool_result']`. */
53
+ phases?: GuardrailPhase[];
54
+ dryRun?: boolean;
55
+ }
56
+ export declare function maxLengthGuardrail(options: MaxLengthGuardrailOptions): Guardrail;
57
+ export interface DenyListGuardrailOptions {
58
+ /** Strings (case-insensitive substring) or regular expressions. */
59
+ patterns: Array<string | RegExp>;
60
+ /** `block` (default) rejects the text; `redact` masks the matches. */
61
+ mode?: 'block' | 'redact';
62
+ /** Default: all phases. */
63
+ phases?: GuardrailPhase[];
64
+ name?: string;
65
+ dryRun?: boolean;
66
+ }
67
+ export declare function denyListGuardrail(options: DenyListGuardrailOptions): Guardrail;
68
+ export interface LlmJudgeGuardrailOptions {
69
+ provider: LLMProvider;
70
+ /** What is and is not acceptable, in plain language. */
71
+ policy: string;
72
+ model?: string;
73
+ /** Default `['output']`. Each checked text costs one extra LLM call. */
74
+ phases?: GuardrailPhase[];
75
+ name?: string;
76
+ /** Default `open`: a judge outage should not stop the agent unless you say so. */
77
+ failMode?: 'open' | 'closed';
78
+ dryRun?: boolean;
79
+ }
80
+ /** Asks another model whether the text complies with `policy`. Adds latency and cost: use sparingly. */
81
+ export declare function llmJudgeGuardrail(options: LlmJudgeGuardrailOptions): Guardrail;
82
+ //# sourceMappingURL=builtins.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"builtins.d.ts","sourceRoot":"","sources":["../../src/guardrails/builtins.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,KAAK,EAAE,SAAS,EAAuC,cAAc,EAAE,MAAM,SAAS,CAAC;AAM9F,MAAM,MAAM,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC;AAElE,MAAM,WAAW,mBAAmB;IAChC,0BAA0B;IAC1B,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC;IAClB,oGAAoG;IACpG,IAAI,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC;IAC1B,wGAAwG;IACxG,MAAM,CAAC,EAAE,cAAc,EAAE,CAAC;IAC1B,MAAM,CAAC,EAAE,OAAO,CAAC;CACpB;AAwDD,iGAAiG;AACjG,wBAAgB,YAAY,CAAC,OAAO,GAAE,mBAAwB,GAAG,SAAS,CAmBzE;AAID,MAAM,WAAW,0BAA0B;IACvC,uFAAuF;IACvF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8FAA8F;IAC9F,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,mGAAmG;IACnG,IAAI,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC;IAC1B,qDAAqD;IACrD,MAAM,CAAC,EAAE,cAAc,EAAE,CAAC;IAC1B,MAAM,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,eAAO,MAAM,sBAAsB,EAAE,MAAM,EAO1C,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,0BAA+B,GAAG,SAAS,CA0BvF;AAID,MAAM,WAAW,+BAA+B;IAC5C,iGAAiG;IACjG,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACxB,kDAAkD;IAClD,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,iCAAiC;IACjC,MAAM,CAAC,EAAE,cAAc,EAAE,CAAC;IAC1B,MAAM,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,eAAO,MAAM,kBAAkB,EAAE,MAAM,EAStC,CAAC;AAEF;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,GAAE,+BAAoC,GAAG,SAAS,CAuBjG;AAID,MAAM,WAAW,yBAAyB;IACtC,GAAG,EAAE,MAAM,CAAC;IACZ,8DAA8D;IAC9D,IAAI,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC;IAC5B,iCAAiC;IACjC,MAAM,CAAC,EAAE,cAAc,EAAE,CAAC;IAC1B,MAAM,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,yBAAyB,GAAG,SAAS,CAgBhF;AAED,MAAM,WAAW,wBAAwB;IACrC,mEAAmE;IACnE,QAAQ,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;IACjC,sEAAsE;IACtE,IAAI,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC;IAC1B,2BAA2B;IAC3B,MAAM,CAAC,EAAE,cAAc,EAAE,CAAC;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,OAAO,CAAC;CACpB;AAMD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,wBAAwB,GAAG,SAAS,CAkB9E;AAID,MAAM,WAAW,wBAAwB;IACrC,QAAQ,EAAE,WAAW,CAAC;IACtB,wDAAwD;IACxD,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wEAAwE;IACxE,MAAM,CAAC,EAAE,cAAc,EAAE,CAAC;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kFAAkF;IAClF,QAAQ,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;IAC7B,MAAM,CAAC,EAAE,OAAO,CAAC;CACpB;AAKD,wGAAwG;AACxG,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,wBAAwB,GAAG,SAAS,CAoB9E"}