@backendkit-labs/agent-core 0.37.1 → 0.38.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 (87) hide show
  1. package/README.md +219 -43
  2. package/dist/delegation/DelegationBus.d.ts +8 -1
  3. package/dist/delegation/DelegationBus.d.ts.map +1 -1
  4. package/dist/delegation/DelegationBus.js +2 -1
  5. package/dist/delegation/DelegationBus.js.map +1 -1
  6. package/dist/engine/AgentEngine.d.ts +108 -3
  7. package/dist/engine/AgentEngine.d.ts.map +1 -1
  8. package/dist/engine/AgentEngine.js +463 -43
  9. package/dist/engine/AgentEngine.js.map +1 -1
  10. package/dist/engine/createBaseEngine.d.ts +28 -0
  11. package/dist/engine/createBaseEngine.d.ts.map +1 -1
  12. package/dist/engine/createBaseEngine.js +7 -0
  13. package/dist/engine/createBaseEngine.js.map +1 -1
  14. package/dist/engine/package-install.d.ts +7 -0
  15. package/dist/engine/package-install.d.ts.map +1 -1
  16. package/dist/engine/package-install.js +17 -0
  17. package/dist/engine/package-install.js.map +1 -1
  18. package/dist/governance/approval-store.d.ts +32 -0
  19. package/dist/governance/approval-store.d.ts.map +1 -0
  20. package/dist/governance/approval-store.js +129 -0
  21. package/dist/governance/approval-store.js.map +1 -0
  22. package/dist/governance/approval.d.ts +35 -0
  23. package/dist/governance/approval.d.ts.map +1 -0
  24. package/dist/governance/approval.js +65 -0
  25. package/dist/governance/approval.js.map +1 -0
  26. package/dist/governance/approvers.d.ts +24 -0
  27. package/dist/governance/approvers.d.ts.map +1 -0
  28. package/dist/governance/approvers.js +69 -0
  29. package/dist/governance/approvers.js.map +1 -0
  30. package/dist/governance/audit.d.ts +101 -0
  31. package/dist/governance/audit.d.ts.map +1 -0
  32. package/dist/governance/audit.js +178 -0
  33. package/dist/governance/audit.js.map +1 -0
  34. package/dist/governance/hooks.d.ts +60 -0
  35. package/dist/governance/hooks.d.ts.map +1 -0
  36. package/dist/governance/hooks.js +26 -0
  37. package/dist/governance/hooks.js.map +1 -0
  38. package/dist/governance/policy.d.ts +28 -0
  39. package/dist/governance/policy.d.ts.map +1 -0
  40. package/dist/governance/policy.js +101 -0
  41. package/dist/governance/policy.js.map +1 -0
  42. package/dist/governance/types.d.ts +162 -0
  43. package/dist/governance/types.d.ts.map +1 -0
  44. package/dist/governance/types.js +3 -0
  45. package/dist/governance/types.js.map +1 -0
  46. package/dist/index.d.ts +21 -2
  47. package/dist/index.d.ts.map +1 -1
  48. package/dist/index.js +49 -3
  49. package/dist/index.js.map +1 -1
  50. package/dist/mcp/MCPClientManager.d.ts.map +1 -1
  51. package/dist/mcp/MCPClientManager.js +20 -1
  52. package/dist/mcp/MCPClientManager.js.map +1 -1
  53. package/dist/mcp/index.d.ts +6 -0
  54. package/dist/mcp/index.d.ts.map +1 -1
  55. package/dist/mcp/index.js +15 -1
  56. package/dist/mcp/index.js.map +1 -1
  57. package/dist/mcp/tool-server-cli.d.ts +48 -0
  58. package/dist/mcp/tool-server-cli.d.ts.map +1 -0
  59. package/dist/mcp/tool-server-cli.js +106 -0
  60. package/dist/mcp/tool-server-cli.js.map +1 -0
  61. package/dist/mcp/tool-server-http.d.ts +37 -0
  62. package/dist/mcp/tool-server-http.d.ts.map +1 -0
  63. package/dist/mcp/tool-server-http.js +117 -0
  64. package/dist/mcp/tool-server-http.js.map +1 -0
  65. package/dist/mcp/tool-server.d.ts +104 -0
  66. package/dist/mcp/tool-server.d.ts.map +1 -0
  67. package/dist/mcp/tool-server.js +312 -0
  68. package/dist/mcp/tool-server.js.map +1 -0
  69. package/dist/shared/utils/canonical-json.d.ts +12 -0
  70. package/dist/shared/utils/canonical-json.d.ts.map +1 -0
  71. package/dist/shared/utils/canonical-json.js +29 -0
  72. package/dist/shared/utils/canonical-json.js.map +1 -0
  73. package/dist/shared/utils/loopback.d.ts +10 -0
  74. package/dist/shared/utils/loopback.d.ts.map +1 -0
  75. package/dist/shared/utils/loopback.js +25 -0
  76. package/dist/shared/utils/loopback.js.map +1 -0
  77. package/dist/tools/createToolContext.d.ts +15 -0
  78. package/dist/tools/createToolContext.d.ts.map +1 -0
  79. package/dist/tools/createToolContext.js +34 -0
  80. package/dist/tools/createToolContext.js.map +1 -0
  81. package/dist/tools/defineTool.d.ts +43 -7
  82. package/dist/tools/defineTool.d.ts.map +1 -1
  83. package/dist/tools/defineTool.js +68 -10
  84. package/dist/tools/defineTool.js.map +1 -1
  85. package/dist/types/index.d.ts +32 -0
  86. package/dist/types/index.d.ts.map +1 -1
  87. package/package.json +1 -1
@@ -0,0 +1 @@
1
+ {"version":3,"file":"audit.js","sourceRoot":"","sources":["../../src/governance/audit.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,60 @@
1
+ import type { AgentEvent, AgentProfile } from '../types';
2
+ import type { Principal, ToolCall } from './types';
3
+ /**
4
+ * What every hook of one turn (`engine.run(input)`) shares. `state` lives for the turn: a `beforeRun` hook can
5
+ * put a classification there and a `systemPrompt` or `afterTurn` hook read it back.
6
+ */
7
+ export interface RunContext {
8
+ /** The principal of the turn (the active agent). Tool hooks receive the principal of the agent making the call. */
9
+ principal: Principal;
10
+ input: string;
11
+ state: Map<string, unknown>;
12
+ /** Aborted when the engine is aborted. */
13
+ signal: AbortSignal;
14
+ emit(event: AgentEvent): void;
15
+ }
16
+ /** What `afterTurn` may ask for: another pass, optionally as another agent and with a message for it. */
17
+ export interface ContinueTurn {
18
+ action: 'continue';
19
+ /** Agent that takes the next pass. Default: the same agent. */
20
+ agentId?: string;
21
+ /** Added to the conversation as a user message before the next pass. */
22
+ message?: string;
23
+ }
24
+ /**
25
+ * Points where a vertical hooks into the engine without new engine options (SPEC-0014 §3). Hooks of the same point
26
+ * run in registration order. An error thrown by a hook fails the turn (fail-closed), like a failing orchestrator.
27
+ */
28
+ export interface EngineHooks {
29
+ /** Name used in error messages. */
30
+ name?: string;
31
+ /** Before the turn starts, after input guardrails. */
32
+ beforeRun?(ctx: RunContext): void | Promise<void>;
33
+ /** A section appended to the system prompt of `profile` (the active agent or a delegate), in registration order. */
34
+ systemPrompt?(ctx: RunContext, profile: AgentProfile): string | undefined | Promise<string | undefined>;
35
+ /**
36
+ * The model answered without asking for tools. Return `{ action: 'continue' }` to force another pass, for
37
+ * example as a reviewing agent. Capped per turn (see `maxHookContinues`), and every pass counts against
38
+ * `maxIterations`. The first hook that asks to continue wins.
39
+ */
40
+ afterTurn?(ctx: RunContext, turn: {
41
+ text: string;
42
+ profile: AgentProfile;
43
+ }): void | ContinueTurn | Promise<void | ContinueTurn>;
44
+ /** A call the policy allowed is about to run. */
45
+ beforeTool?(ctx: RunContext, call: ToolCall): void | Promise<void>;
46
+ /** A call ran (successfully or not). */
47
+ afterTool?(ctx: RunContext, call: ToolCall, result: {
48
+ text: string;
49
+ success: boolean;
50
+ }): void | Promise<void>;
51
+ /** The turn is over. `text` is the last answer of the model. */
52
+ afterRun?(ctx: RunContext, result: {
53
+ text: string;
54
+ }): void | Promise<void>;
55
+ }
56
+ /** Default cap of `continue` passes requested by `afterTurn` hooks in one turn (same as the QA rework cap). */
57
+ export declare const DEFAULT_MAX_HOOK_CONTINUES = 5;
58
+ /** Runs `fn` for every hook that defines `point`, in order; a throw becomes an error naming the hook and point. */
59
+ export declare function runHooks<T>(hooks: EngineHooks[], point: keyof EngineHooks, fn: (hook: EngineHooks) => T | Promise<T> | undefined): Promise<T[]>;
60
+ //# sourceMappingURL=hooks.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/governance/hooks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACzD,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAEnD;;;GAGG;AACH,MAAM,WAAW,UAAU;IACvB,mHAAmH;IACnH,SAAS,EAAE,SAAS,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC5B,0CAA0C;IAC1C,MAAM,EAAE,WAAW,CAAC;IACpB,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC;CACjC;AAED,yGAAyG;AACzG,MAAM,WAAW,YAAY;IACzB,MAAM,EAAE,UAAU,CAAC;IACnB,+DAA+D;IAC/D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wEAAwE;IACxE,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IACxB,mCAAmC;IACnC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sDAAsD;IACtD,SAAS,CAAC,CAAC,GAAG,EAAE,UAAU,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClD,oHAAoH;IACpH,YAAY,CAAC,CAAC,GAAG,EAAE,UAAU,EAAE,OAAO,EAAE,YAAY,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IACxG;;;;OAIG;IACH,SAAS,CAAC,CAAC,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,YAAY,CAAA;KAAE,GAAG,IAAI,GAAG,YAAY,GAAG,OAAO,CAAC,IAAI,GAAG,YAAY,CAAC,CAAC;IAC/H,iDAAiD;IACjD,UAAU,CAAC,CAAC,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnE,wCAAwC;IACxC,SAAS,CAAC,CAAC,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9G,gEAAgE;IAChE,QAAQ,CAAC,CAAC,GAAG,EAAE,UAAU,EAAE,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9E;AAED,+GAA+G;AAC/G,eAAO,MAAM,0BAA0B,IAAI,CAAC;AAE5C,mHAAmH;AACnH,wBAAsB,QAAQ,CAAC,CAAC,EAC5B,KAAK,EAAE,WAAW,EAAE,EAAE,KAAK,EAAE,MAAM,WAAW,EAAE,EAAE,EAAE,CAAC,IAAI,EAAE,WAAW,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,SAAS,GACtG,OAAO,CAAC,CAAC,EAAE,CAAC,CAcd"}
@@ -0,0 +1,26 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.DEFAULT_MAX_HOOK_CONTINUES = void 0;
4
+ exports.runHooks = runHooks;
5
+ /** Default cap of `continue` passes requested by `afterTurn` hooks in one turn (same as the QA rework cap). */
6
+ exports.DEFAULT_MAX_HOOK_CONTINUES = 5;
7
+ /** Runs `fn` for every hook that defines `point`, in order; a throw becomes an error naming the hook and point. */
8
+ async function runHooks(hooks, point, fn) {
9
+ const out = [];
10
+ for (let i = 0; i < hooks.length; i++) {
11
+ const hook = hooks[i];
12
+ if (typeof hook[point] !== 'function')
13
+ continue;
14
+ try {
15
+ const value = await fn(hook);
16
+ if (value !== undefined)
17
+ out.push(value);
18
+ }
19
+ catch (err) {
20
+ const name = hook.name ?? `#${i}`;
21
+ throw new Error(`Hook ${name} failed in ${String(point)}: ${err instanceof Error ? err.message : String(err)}`);
22
+ }
23
+ }
24
+ return out;
25
+ }
26
+ //# sourceMappingURL=hooks.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../src/governance/hooks.ts"],"names":[],"mappings":";;;AAuDA,4BAgBC;AApBD,+GAA+G;AAClG,QAAA,0BAA0B,GAAG,CAAC,CAAC;AAE5C,mHAAmH;AAC5G,KAAK,UAAU,QAAQ,CAC1B,KAAoB,EAAE,KAAwB,EAAE,EAAqD;IAErG,MAAM,GAAG,GAAQ,EAAE,CAAC;IACpB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACpC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACtB,IAAI,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,UAAU;YAAE,SAAS;QAChD,IAAI,CAAC;YACD,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,CAAC;YAC7B,IAAI,KAAK,KAAK,SAAS;gBAAE,GAAG,CAAC,IAAI,CAAC,KAAU,CAAC,CAAC;QAClD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,EAAE,CAAC;YAClC,MAAM,IAAI,KAAK,CAAC,QAAQ,IAAI,cAAc,MAAM,CAAC,KAAK,CAAC,KAAK,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACpH,CAAC;IACL,CAAC;IACD,OAAO,GAAG,CAAC;AACf,CAAC"}
@@ -0,0 +1,28 @@
1
+ import type { PolicyDecision, Principal, ToolCall, ToolPolicy } from './types';
2
+ /**
3
+ * The rule the engine applies when no `policy` is configured but there is someone to ask (an `approver` or an
4
+ * `approvals` store) — SPEC-0014 §4, decided by facts the tool declares, never by its name:
5
+ *
6
+ * - `readOnly` → allow.
7
+ * - `destructive` → ask, and only a person may approve (`accepts: ['human']`). Never covered by "approve all".
8
+ * - anything else → ask. A tool that declares nothing asks: forgetting a fact asks too much, never too little.
9
+ */
10
+ export declare const defaultToolPolicy: ToolPolicy;
11
+ /**
12
+ * Combines decisions of several policies: any `deny` wins; otherwise any `ask` asks (reasons joined, the accepted
13
+ * approver kinds intersected, so the strictest requirement holds); otherwise `allow`. For `allow`, the most
14
+ * restrictive mode wins (`dry_run` over `sandboxed` over `run`). No decisions at all means allow.
15
+ */
16
+ export declare function combineDecisions(decisions: PolicyDecision[]): PolicyDecision;
17
+ /**
18
+ * Rule 3 of SPEC-0014 §6.2 on a decision taken with the approving agent as principal: the agent could do the call
19
+ * itself if it is allowed, or if it would only need an approval an agent may give. A deny, or an ask reserved for
20
+ * other kinds (e.g. people only), means it cannot approve it either.
21
+ */
22
+ export declare function agentCouldPerform(asAgent: PolicyDecision): boolean;
23
+ /**
24
+ * Asks every policy and combines the answers. A policy that throws denies (fail-closed): a decision that cannot
25
+ * be made is not a permission.
26
+ */
27
+ export declare function evaluatePolicies(policies: ToolPolicy[], principal: Principal, call: ToolCall): Promise<PolicyDecision>;
28
+ //# sourceMappingURL=policy.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"policy.d.ts","sourceRoot":"","sources":["../../src/governance/policy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAgB,cAAc,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE7F;;;;;;;GAOG;AACH,eAAO,MAAM,iBAAiB,EAAE,UAQ/B,CAAC;AASF;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,cAAc,EAAE,GAAG,cAAc,CA6B5E;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAIlE;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,UAAU,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,cAAc,CAAC,CAU5H"}
@@ -0,0 +1,101 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.defaultToolPolicy = void 0;
4
+ exports.combineDecisions = combineDecisions;
5
+ exports.agentCouldPerform = agentCouldPerform;
6
+ exports.evaluatePolicies = evaluatePolicies;
7
+ /**
8
+ * The rule the engine applies when no `policy` is configured but there is someone to ask (an `approver` or an
9
+ * `approvals` store) — SPEC-0014 §4, decided by facts the tool declares, never by its name:
10
+ *
11
+ * - `readOnly` → allow.
12
+ * - `destructive` → ask, and only a person may approve (`accepts: ['human']`). Never covered by "approve all".
13
+ * - anything else → ask. A tool that declares nothing asks: forgetting a fact asks too much, never too little.
14
+ */
15
+ exports.defaultToolPolicy = {
16
+ decide(_principal, call) {
17
+ if (call.tool.readOnly)
18
+ return { effect: 'allow', reason: 'read-only tool' };
19
+ if (call.tool.destructive) {
20
+ return { effect: 'ask', reason: `"${call.tool.name}" is destructive`, accepts: ['human'] };
21
+ }
22
+ return { effect: 'ask', reason: `"${call.tool.name}" is not declared read-only` };
23
+ },
24
+ };
25
+ /** Kinds accepted by both sets; `undefined` means any. An empty result means nobody can approve. */
26
+ function intersectAccepts(a, b) {
27
+ if (!a)
28
+ return b;
29
+ if (!b)
30
+ return a;
31
+ return a.filter(k => b.includes(k));
32
+ }
33
+ /**
34
+ * Combines decisions of several policies: any `deny` wins; otherwise any `ask` asks (reasons joined, the accepted
35
+ * approver kinds intersected, so the strictest requirement holds); otherwise `allow`. For `allow`, the most
36
+ * restrictive mode wins (`dry_run` over `sandboxed` over `run`). No decisions at all means allow.
37
+ */
38
+ function combineDecisions(decisions) {
39
+ const deny = decisions.find(d => d.effect === 'deny');
40
+ if (deny)
41
+ return deny;
42
+ const asks = decisions.filter((d) => d.effect === 'ask');
43
+ if (asks.length > 0) {
44
+ let accepts;
45
+ let constrained = false;
46
+ for (const a of asks) {
47
+ if (a.accepts) {
48
+ accepts = constrained ? intersectAccepts(accepts, a.accepts) : a.accepts;
49
+ constrained = true;
50
+ }
51
+ }
52
+ const approver = asks.find(a => a.approver)?.approver;
53
+ return {
54
+ effect: 'ask',
55
+ reason: asks.map(a => a.reason).join('; '),
56
+ ...(approver ? { approver } : {}),
57
+ ...(constrained ? { accepts } : {}),
58
+ };
59
+ }
60
+ const rank = { run: 0, sandboxed: 1, dry_run: 2 };
61
+ let mode = 'run';
62
+ const reasons = [];
63
+ for (const d of decisions) {
64
+ if (d.effect !== 'allow')
65
+ continue;
66
+ if (d.mode && rank[d.mode] > rank[mode])
67
+ mode = d.mode;
68
+ if (d.reason)
69
+ reasons.push(d.reason);
70
+ }
71
+ return { effect: 'allow', ...(reasons.length ? { reason: reasons.join('; ') } : {}), ...(mode !== 'run' ? { mode } : {}) };
72
+ }
73
+ /**
74
+ * Rule 3 of SPEC-0014 §6.2 on a decision taken with the approving agent as principal: the agent could do the call
75
+ * itself if it is allowed, or if it would only need an approval an agent may give. A deny, or an ask reserved for
76
+ * other kinds (e.g. people only), means it cannot approve it either.
77
+ */
78
+ function agentCouldPerform(asAgent) {
79
+ if (asAgent.effect === 'allow')
80
+ return true;
81
+ if (asAgent.effect === 'deny')
82
+ return false;
83
+ return !asAgent.accepts || asAgent.accepts.includes('agent');
84
+ }
85
+ /**
86
+ * Asks every policy and combines the answers. A policy that throws denies (fail-closed): a decision that cannot
87
+ * be made is not a permission.
88
+ */
89
+ async function evaluatePolicies(policies, principal, call) {
90
+ const decisions = [];
91
+ for (const p of policies) {
92
+ try {
93
+ decisions.push(await p.decide(principal, call));
94
+ }
95
+ catch (err) {
96
+ decisions.push({ effect: 'deny', reason: `policy failed: ${err instanceof Error ? err.message : String(err)}` });
97
+ }
98
+ }
99
+ return combineDecisions(decisions);
100
+ }
101
+ //# sourceMappingURL=policy.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"policy.js","sourceRoot":"","sources":["../../src/governance/policy.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,162 @@
1
+ /**
2
+ * Governance contracts of the engine (SPEC-0014 §3): who acts, what a policy decides about a tool call, who may
3
+ * approve what, and what gets audited. They name no tool, agent or domain: verticals and products (the coding
4
+ * pipeline, Steward, Hermes) implement them.
5
+ */
6
+ import type { ToolDefinition } from '../types';
7
+ export interface Principal {
8
+ /** The agent that executes. */
9
+ agentId: string;
10
+ sessionId: string;
11
+ /** Delegation chain from whoever started the work to the agent that executes, e.g. [user?, orchestrator, specialist]. */
12
+ chain: string[];
13
+ tenantId?: string;
14
+ /** On whose behalf the agent acts. */
15
+ userId?: string;
16
+ roles?: string[];
17
+ scopes?: string[];
18
+ /** Free-form: department, scope, cost centre... */
19
+ attributes?: Record<string, unknown>;
20
+ }
21
+ /** The part of a principal the engine does not compute: who the engine acts for. */
22
+ export type Identity = Omit<Principal, 'agentId' | 'sessionId' | 'chain'>;
23
+ export type ApproverKind = 'human' | 'agent' | 'service';
24
+ export interface ApproverRef {
25
+ kind: ApproverKind;
26
+ /** User id, agent id or service name. */
27
+ id: string;
28
+ /** When the approver is an agent: its delegation chain. */
29
+ chain?: string[];
30
+ }
31
+ export interface ToolCall {
32
+ /** The tool, with its declared facts (readOnly, destructive, idempotent, openWorld, meta). */
33
+ tool: ToolDefinition;
34
+ args: Record<string, unknown>;
35
+ /**
36
+ * Someone already approved exactly this call (resubmission, SPEC-0014 §6). Only whoever holds the approval
37
+ * sets it when executing it; the engine never derives it from what the model sent.
38
+ */
39
+ approved?: {
40
+ by: ApproverRef;
41
+ approvalId: string;
42
+ };
43
+ }
44
+ export type PolicyDecision = {
45
+ effect: 'allow';
46
+ reason?: string;
47
+ /**
48
+ * How an allowed call runs. 'sandboxed' forces the sandbox runner; 'dry_run' runs with `ctx.dryRun = true`
49
+ * (the tool simulates and writes nothing). Default 'run'.
50
+ */
51
+ mode?: 'run' | 'sandboxed' | 'dry_run';
52
+ } | {
53
+ effect: 'deny';
54
+ reason: string;
55
+ } | {
56
+ effect: 'ask';
57
+ reason: string;
58
+ /** Whom to route the request to (role, level, department). Free text, read by whoever routes it. */
59
+ approver?: string;
60
+ /** Which kinds of approver are accepted. Default: any. Destructive tools require ['human']. */
61
+ accepts?: ApproverKind[];
62
+ };
63
+ export interface ToolPolicy {
64
+ decide(principal: Principal, call: ToolCall): PolicyDecision | Promise<PolicyDecision>;
65
+ }
66
+ /** What can be put up for approval: a tool call, a workflow step, a learned rule, or anything a vertical defines. */
67
+ export type ApprovalSubject = {
68
+ kind: 'tool_call';
69
+ call: ToolCall;
70
+ } | {
71
+ kind: 'workflow_step';
72
+ workflow: string;
73
+ step: string;
74
+ input: unknown;
75
+ } | {
76
+ kind: 'rule_proposal';
77
+ rule: unknown;
78
+ evidence: string;
79
+ } | {
80
+ kind: string;
81
+ payload: unknown;
82
+ summary: string;
83
+ };
84
+ export interface ApprovalRequest {
85
+ id: string;
86
+ principal: Principal;
87
+ subject: ApprovalSubject;
88
+ reason: string;
89
+ approver?: string;
90
+ accepts?: ApproverKind[];
91
+ /** ISO time. */
92
+ createdAt: string;
93
+ }
94
+ export interface ApprovalOutcome {
95
+ decision: 'approve' | 'reject';
96
+ by: ApproverRef;
97
+ reason?: string;
98
+ /** ISO time. */
99
+ at: string;
100
+ }
101
+ export interface Approver {
102
+ /** Who this approver is; checked against the approval rules before its answer is accepted. */
103
+ readonly ref?: ApproverRef;
104
+ /** Answers now (a CLI prompt, a connected UI, a supervising agent). */
105
+ request(req: ApprovalRequest): Promise<ApprovalOutcome>;
106
+ }
107
+ export type ApprovalStatus = 'pending' | 'approved' | 'rejected' | 'executed';
108
+ export interface StoredApproval extends ApprovalRequest {
109
+ status: ApprovalStatus;
110
+ outcome?: ApprovalOutcome;
111
+ /** ISO time when the approved action was executed (at most once). */
112
+ executedAt?: string;
113
+ }
114
+ /** Durable approvals (SPEC-0014 §6, option A: resubmission). */
115
+ export interface ApprovalStore {
116
+ put(req: ApprovalRequest): Promise<void>;
117
+ get(id: string): Promise<StoredApproval | undefined>;
118
+ /** Records the decision once; a second decision for the same id fails. */
119
+ resolve(id: string, outcome: ApprovalOutcome): Promise<StoredApproval>;
120
+ /** Marks an approved request executed, atomically and at most once; returns false if it already was. */
121
+ markExecuted(id: string): Promise<boolean>;
122
+ list(filter?: {
123
+ status?: ApprovalStatus;
124
+ agentId?: string;
125
+ }): Promise<StoredApproval[]>;
126
+ }
127
+ export type AuditDecision = PolicyDecision['effect'] | 'not_found' | 'not_allowed' | 'sandbox_denied' | 'guardrail_blocked';
128
+ export type AuditOutcome = 'ok' | 'error' | 'timeout' | 'aborted' | 'too_large';
129
+ /** What the sandbox decided while a call ran (it may run several commands or touch several paths). */
130
+ export interface AuditSandboxDecision {
131
+ outcome: 'allowed' | 'SANDBOX_DENIED' | 'SANDBOX_UNAVAILABLE';
132
+ mode?: string;
133
+ network?: string;
134
+ backend?: string;
135
+ reason?: string;
136
+ }
137
+ /** One record per tool call, accepted or refused. Arguments travel only as a hash. */
138
+ export interface AuditEvent {
139
+ /** ISO time when the call started. */
140
+ at: string;
141
+ principal: Pick<Principal, 'agentId' | 'sessionId' | 'chain' | 'tenantId' | 'userId'>;
142
+ tool: string;
143
+ /** SHA-256 of the canonical JSON of the arguments (`hashArgs`). */
144
+ argsHash: string;
145
+ decision: AuditDecision;
146
+ reason?: string;
147
+ /** Present when the call ran. */
148
+ outcome?: AuditOutcome;
149
+ durationMs: number;
150
+ /** Who approved the call, when it needed approval. */
151
+ approval?: {
152
+ id: string;
153
+ by: ApproverRef;
154
+ };
155
+ sandbox?: AuditSandboxDecision[];
156
+ /** The tool's declared `meta`. */
157
+ meta?: Record<string, unknown>;
158
+ }
159
+ export interface AuditSink {
160
+ write(event: AuditEvent): void | Promise<void>;
161
+ }
162
+ //# sourceMappingURL=types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/governance/types.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,3 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ //# sourceMappingURL=types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/governance/types.ts"],"names":[],"mappings":""}
package/dist/index.d.ts CHANGED
@@ -24,10 +24,12 @@ export { SessionMemory } from './memory/SessionMemory';
24
24
  export type { Transport, Unsubscribe } from './transport/Transport';
25
25
  export { StdoutTransport } from './transport/StdoutTransport';
26
26
  export { CallbackTransport } from './transport/CallbackTransport';
27
- export { defineTool, z, zodToParameters } from './tools/defineTool';
27
+ export { defineTool, z, zodToParameters, validateToolDefinition, getToolInputSchema, ToolDefinitionError } from './tools/defineTool';
28
+ export { createToolContext, createInMemorySessionMemory } from './tools/createToolContext';
28
29
  export { generateObject, generateObjectWith, StructuredOutputError } from './structured/generateObject';
29
30
  export type { GenerateObjectOptions, StructuredChat } from './structured/generateObject';
30
- export type { TypedToolOptions } from './tools/defineTool';
31
+ export type { TypedToolOptions, ToolMetadata } from './tools/defineTool';
32
+ export type { ToolContextOptions } from './tools/createToolContext';
31
33
  export { SkillLoader } from './skills/loader';
32
34
  export { SkillManager, createSkillManager } from './skills/manager';
33
35
  export type { InstallOptions, InstalledPack } from './skills/manager';
@@ -61,6 +63,23 @@ export type { ReviewAgentIds } from './orchestration/orchestrator';
61
63
  export type { OrchestratorConfig, OrchestrationResult, AgentPipelinePhase, PolicyRule, CapabilityMatrix, } from './orchestration/types';
62
64
  export { MCPClientManager } from './mcp/MCPClientManager';
63
65
  export type { MCPServerConfig } from './mcp/types';
66
+ export type { Principal, Identity, ToolCall, PolicyDecision, ToolPolicy, ApproverKind, ApproverRef, ApprovalSubject, ApprovalRequest, ApprovalOutcome, Approver, ApprovalStatus, StoredApproval, ApprovalStore, AuditDecision, AuditOutcome, AuditSandboxDecision, AuditEvent, AuditSink, } from './governance/types';
67
+ export { MemoryAuditSink, NdjsonAuditSink, HashChainAuditSink, verifyAuditChain, verifyAuditSegment, GENESIS_HASH, } from './governance/audit';
68
+ export type { ChainedAuditEntry, ChainVerification, SegmentVerification } from './governance/audit';
69
+ export { defaultToolPolicy, combineDecisions, evaluatePolicies, agentCouldPerform } from './governance/policy';
70
+ export { approverFromCallback, approvalProblem } from './governance/approval';
71
+ export type { CallbackApprover } from './governance/approval';
72
+ export { FileApprovalStore } from './governance/approval-store';
73
+ export { agentApprover, consoleApprover, describeApproval } from './governance/approvers';
74
+ export { DEFAULT_MAX_HOOK_CONTINUES } from './governance/hooks';
75
+ export type { EngineHooks, RunContext, ContinueTurn } from './governance/hooks';
76
+ export { canonicalJson } from './shared/utils/canonical-json';
77
+ export { createToolServer, createToolServerFactory, createToolRegistrar, hashArgs } from './mcp/tool-server';
78
+ export type { ToolServerOptions, ToolCallInfo, ToolCallRecord, ToolCallOutcome } from './mcp/tool-server';
79
+ export { startToolServerHttp, isBearerAuthorized, isLoopbackRequest } from './mcp/tool-server-http';
80
+ export type { ToolServerHttpOptions, RunningToolServer } from './mcp/tool-server-http';
81
+ export { runToolServer, parseToolServerArgs, toolServerUsage } from './mcp/tool-server-cli';
82
+ export type { ToolServerCliArgs, ToolServerCliOptions, RunningToolServerCli } from './mcp/tool-server-cli';
64
83
  export { workflow, agent, WorkflowBuilder } from './workflow/WorkflowBuilder';
65
84
  export type { StepOptions } from './workflow/WorkflowBuilder';
66
85
  export { WorkflowRunner } from './workflow/WorkflowRunner';
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
package/dist/index.js CHANGED
@@ -1,8 +1,9 @@
1
1
  "use strict";
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
- exports.ObsidianProvider = exports.SkillsShProvider = exports.LocalProvider = exports.GitHubProvider = exports.skillToMd = exports.parseMdSkill = exports.SkillActivator = exports.SkillRegistry = exports.createSkillManager = exports.SkillManager = exports.SkillLoader = exports.StructuredOutputError = exports.generateObjectWith = exports.generateObject = exports.zodToParameters = exports.z = exports.defineTool = exports.CallbackTransport = exports.StdoutTransport = exports.SessionMemory = exports.DelegationBus = exports.GLOBAL_LIMIT = exports.DEFAULT_BATCH_SIZE = exports.DEFAULT_MAX_ITERATIONS = exports.IterationManager = exports.INJECTION_PATTERNS = exports.COMMON_SECRET_PATTERNS = exports.llmJudgeGuardrail = exports.denyListGuardrail = exports.maxLengthGuardrail = exports.promptInjectionGuardrail = exports.secretLeakGuardrail = exports.piiGuardrail = exports.GuardrailRunner = exports.jobKillTool = exports.jobListTool = exports.jobOutputTool = exports.JOB_TOOLS = exports.JobLimitError = exports.createJobRegistry = exports.EngineControlError = exports.createEngineControl = exports.isContextOverflowError = exports.defaultEstimateTokens = exports.ContextManager = exports.createBaseEngine = exports.ProviderRegistry = exports.ToolRegistry = exports.AgentRegistry = exports.AgentEngine = void 0;
4
- exports.TriggerManager = exports.EventBus = exports.createAutonomousAgent = exports.WorkflowRunner = exports.WorkflowBuilder = exports.agent = exports.workflow = exports.MCPClientManager = exports.adaptProviderToLLMClient = exports.Orchestrator = exports.ResilientLLMClient = exports.untrustedLayerWarning = exports.projectLayerContents = exports.untrustProject = exports.trustProject = exports.isProjectTrusted = exports.listTrustedProjects = exports.canonicalProjectPath = exports.trustFilePath = exports.TRUST_FILE = exports.atomicWriteSync = exports.atomicWrite = exports.getProjectDir = exports.getFrameworkDir = exports.cwdToProjectKey = exports.DEFAULT_CONFIG = exports.loadFrameworkConfig = exports.runGlobalSeed = exports.detectCommonRoot = exports.setCommonRoot = exports.migrateFromLegacy = exports.deriveProjectName = exports.buildWorkspaceContext = exports.setActiveProject = exports.deleteWorkspace = exports.removeProject = exports.importProject = exports.addProject = exports.createWorkspace = exports.saveWorkspaces = exports.loadWorkspaces = exports.compactSessionContent = exports.compactSession = exports.extractSessionFromCheckpoint = exports.getLatestCheckpoints = exports.readCheckpoint = exports.listCheckpoints = exports.createCheckpoint = exports.registerBuiltinCommands = exports.SlashCommandRegistry = void 0;
5
- exports.QAService = exports.BUILTIN_DOMAINS = exports.DomainRegistry = exports.ReflectionEngine = exports.projectAgentsDir = exports.globalAgentsDir = exports.loadAgentsFromDir = exports.RemoteAgentRegistry = exports.discoverAgents = exports.JsonFileStore = exports.InMemoryStore = exports.buildMemoryTools = exports.ProceduralMemory = exports.SemanticMemory = exports.EpisodicMemory = exports.createMemorySystem = exports.MemorySystem = exports.MODEL_PRICING = exports.Tracer = exports.MetricsCollector = exports.CostTracker = exports.ObservabilityManager = void 0;
3
+ exports.parseMdSkill = exports.SkillActivator = exports.SkillRegistry = exports.createSkillManager = exports.SkillManager = exports.SkillLoader = exports.StructuredOutputError = exports.generateObjectWith = exports.generateObject = exports.createInMemorySessionMemory = exports.createToolContext = exports.ToolDefinitionError = exports.getToolInputSchema = exports.validateToolDefinition = exports.zodToParameters = exports.z = exports.defineTool = exports.CallbackTransport = exports.StdoutTransport = exports.SessionMemory = exports.DelegationBus = exports.GLOBAL_LIMIT = exports.DEFAULT_BATCH_SIZE = exports.DEFAULT_MAX_ITERATIONS = exports.IterationManager = exports.INJECTION_PATTERNS = exports.COMMON_SECRET_PATTERNS = exports.llmJudgeGuardrail = exports.denyListGuardrail = exports.maxLengthGuardrail = exports.promptInjectionGuardrail = exports.secretLeakGuardrail = exports.piiGuardrail = exports.GuardrailRunner = exports.jobKillTool = exports.jobListTool = exports.jobOutputTool = exports.JOB_TOOLS = exports.JobLimitError = exports.createJobRegistry = exports.EngineControlError = exports.createEngineControl = exports.isContextOverflowError = exports.defaultEstimateTokens = exports.ContextManager = exports.createBaseEngine = exports.ProviderRegistry = exports.ToolRegistry = exports.AgentRegistry = exports.AgentEngine = void 0;
4
+ exports.NdjsonAuditSink = exports.MemoryAuditSink = exports.MCPClientManager = exports.adaptProviderToLLMClient = exports.Orchestrator = exports.ResilientLLMClient = exports.untrustedLayerWarning = exports.projectLayerContents = exports.untrustProject = exports.trustProject = exports.isProjectTrusted = exports.listTrustedProjects = exports.canonicalProjectPath = exports.trustFilePath = exports.TRUST_FILE = exports.atomicWriteSync = exports.atomicWrite = exports.getProjectDir = exports.getFrameworkDir = exports.cwdToProjectKey = exports.DEFAULT_CONFIG = exports.loadFrameworkConfig = exports.runGlobalSeed = exports.detectCommonRoot = exports.setCommonRoot = exports.migrateFromLegacy = exports.deriveProjectName = exports.buildWorkspaceContext = exports.setActiveProject = exports.deleteWorkspace = exports.removeProject = exports.importProject = exports.addProject = exports.createWorkspace = exports.saveWorkspaces = exports.loadWorkspaces = exports.compactSessionContent = exports.compactSession = exports.extractSessionFromCheckpoint = exports.getLatestCheckpoints = exports.readCheckpoint = exports.listCheckpoints = exports.createCheckpoint = exports.registerBuiltinCommands = exports.SlashCommandRegistry = exports.ObsidianProvider = exports.SkillsShProvider = exports.LocalProvider = exports.GitHubProvider = exports.skillToMd = void 0;
5
+ exports.globalAgentsDir = exports.loadAgentsFromDir = exports.RemoteAgentRegistry = exports.discoverAgents = exports.JsonFileStore = exports.InMemoryStore = exports.buildMemoryTools = exports.ProceduralMemory = exports.SemanticMemory = exports.EpisodicMemory = exports.createMemorySystem = exports.MemorySystem = exports.MODEL_PRICING = exports.Tracer = exports.MetricsCollector = exports.CostTracker = exports.ObservabilityManager = exports.TriggerManager = exports.EventBus = exports.createAutonomousAgent = exports.WorkflowRunner = exports.WorkflowBuilder = exports.agent = exports.workflow = exports.toolServerUsage = exports.parseToolServerArgs = exports.runToolServer = exports.isLoopbackRequest = exports.isBearerAuthorized = exports.startToolServerHttp = exports.hashArgs = exports.createToolRegistrar = exports.createToolServerFactory = exports.createToolServer = exports.canonicalJson = exports.DEFAULT_MAX_HOOK_CONTINUES = exports.describeApproval = exports.consoleApprover = exports.agentApprover = exports.FileApprovalStore = exports.approvalProblem = exports.approverFromCallback = exports.agentCouldPerform = exports.evaluatePolicies = exports.combineDecisions = exports.defaultToolPolicy = exports.GENESIS_HASH = exports.verifyAuditSegment = exports.verifyAuditChain = exports.HashChainAuditSink = void 0;
6
+ exports.QAService = exports.BUILTIN_DOMAINS = exports.DomainRegistry = exports.ReflectionEngine = exports.projectAgentsDir = void 0;
6
7
  // ── Engine ─────────────────────────────────────────────────────────────────────
7
8
  var AgentEngine_1 = require("./engine/AgentEngine");
8
9
  Object.defineProperty(exports, "AgentEngine", { enumerable: true, get: function () { return AgentEngine_1.AgentEngine; } });
@@ -60,6 +61,12 @@ var defineTool_1 = require("./tools/defineTool");
60
61
  Object.defineProperty(exports, "defineTool", { enumerable: true, get: function () { return defineTool_1.defineTool; } });
61
62
  Object.defineProperty(exports, "z", { enumerable: true, get: function () { return defineTool_1.z; } });
62
63
  Object.defineProperty(exports, "zodToParameters", { enumerable: true, get: function () { return defineTool_1.zodToParameters; } });
64
+ Object.defineProperty(exports, "validateToolDefinition", { enumerable: true, get: function () { return defineTool_1.validateToolDefinition; } });
65
+ Object.defineProperty(exports, "getToolInputSchema", { enumerable: true, get: function () { return defineTool_1.getToolInputSchema; } });
66
+ Object.defineProperty(exports, "ToolDefinitionError", { enumerable: true, get: function () { return defineTool_1.ToolDefinitionError; } });
67
+ var createToolContext_1 = require("./tools/createToolContext");
68
+ Object.defineProperty(exports, "createToolContext", { enumerable: true, get: function () { return createToolContext_1.createToolContext; } });
69
+ Object.defineProperty(exports, "createInMemorySessionMemory", { enumerable: true, get: function () { return createToolContext_1.createInMemorySessionMemory; } });
63
70
  var generateObject_1 = require("./structured/generateObject");
64
71
  Object.defineProperty(exports, "generateObject", { enumerable: true, get: function () { return generateObject_1.generateObject; } });
65
72
  Object.defineProperty(exports, "generateObjectWith", { enumerable: true, get: function () { return generateObject_1.generateObjectWith; } });
@@ -145,6 +152,45 @@ Object.defineProperty(exports, "adaptProviderToLLMClient", { enumerable: true, g
145
152
  // ── MCP client — MCPClientManager in AgentEngineOptions, MCPServerConfig in coding config ─
146
153
  var MCPClientManager_1 = require("./mcp/MCPClientManager");
147
154
  Object.defineProperty(exports, "MCPClientManager", { enumerable: true, get: function () { return MCPClientManager_1.MCPClientManager; } });
155
+ var audit_1 = require("./governance/audit");
156
+ Object.defineProperty(exports, "MemoryAuditSink", { enumerable: true, get: function () { return audit_1.MemoryAuditSink; } });
157
+ Object.defineProperty(exports, "NdjsonAuditSink", { enumerable: true, get: function () { return audit_1.NdjsonAuditSink; } });
158
+ Object.defineProperty(exports, "HashChainAuditSink", { enumerable: true, get: function () { return audit_1.HashChainAuditSink; } });
159
+ Object.defineProperty(exports, "verifyAuditChain", { enumerable: true, get: function () { return audit_1.verifyAuditChain; } });
160
+ Object.defineProperty(exports, "verifyAuditSegment", { enumerable: true, get: function () { return audit_1.verifyAuditSegment; } });
161
+ Object.defineProperty(exports, "GENESIS_HASH", { enumerable: true, get: function () { return audit_1.GENESIS_HASH; } });
162
+ var policy_1 = require("./governance/policy");
163
+ Object.defineProperty(exports, "defaultToolPolicy", { enumerable: true, get: function () { return policy_1.defaultToolPolicy; } });
164
+ Object.defineProperty(exports, "combineDecisions", { enumerable: true, get: function () { return policy_1.combineDecisions; } });
165
+ Object.defineProperty(exports, "evaluatePolicies", { enumerable: true, get: function () { return policy_1.evaluatePolicies; } });
166
+ Object.defineProperty(exports, "agentCouldPerform", { enumerable: true, get: function () { return policy_1.agentCouldPerform; } });
167
+ var approval_1 = require("./governance/approval");
168
+ Object.defineProperty(exports, "approverFromCallback", { enumerable: true, get: function () { return approval_1.approverFromCallback; } });
169
+ Object.defineProperty(exports, "approvalProblem", { enumerable: true, get: function () { return approval_1.approvalProblem; } });
170
+ var approval_store_1 = require("./governance/approval-store");
171
+ Object.defineProperty(exports, "FileApprovalStore", { enumerable: true, get: function () { return approval_store_1.FileApprovalStore; } });
172
+ var approvers_1 = require("./governance/approvers");
173
+ Object.defineProperty(exports, "agentApprover", { enumerable: true, get: function () { return approvers_1.agentApprover; } });
174
+ Object.defineProperty(exports, "consoleApprover", { enumerable: true, get: function () { return approvers_1.consoleApprover; } });
175
+ Object.defineProperty(exports, "describeApproval", { enumerable: true, get: function () { return approvers_1.describeApproval; } });
176
+ var hooks_1 = require("./governance/hooks");
177
+ Object.defineProperty(exports, "DEFAULT_MAX_HOOK_CONTINUES", { enumerable: true, get: function () { return hooks_1.DEFAULT_MAX_HOOK_CONTINUES; } });
178
+ var canonical_json_1 = require("./shared/utils/canonical-json");
179
+ Object.defineProperty(exports, "canonicalJson", { enumerable: true, get: function () { return canonical_json_1.canonicalJson; } });
180
+ // ── MCP tool server — ToolDefinitions served directly over MCP, no model in between
181
+ var tool_server_1 = require("./mcp/tool-server");
182
+ Object.defineProperty(exports, "createToolServer", { enumerable: true, get: function () { return tool_server_1.createToolServer; } });
183
+ Object.defineProperty(exports, "createToolServerFactory", { enumerable: true, get: function () { return tool_server_1.createToolServerFactory; } });
184
+ Object.defineProperty(exports, "createToolRegistrar", { enumerable: true, get: function () { return tool_server_1.createToolRegistrar; } });
185
+ Object.defineProperty(exports, "hashArgs", { enumerable: true, get: function () { return tool_server_1.hashArgs; } });
186
+ var tool_server_http_1 = require("./mcp/tool-server-http");
187
+ Object.defineProperty(exports, "startToolServerHttp", { enumerable: true, get: function () { return tool_server_http_1.startToolServerHttp; } });
188
+ Object.defineProperty(exports, "isBearerAuthorized", { enumerable: true, get: function () { return tool_server_http_1.isBearerAuthorized; } });
189
+ Object.defineProperty(exports, "isLoopbackRequest", { enumerable: true, get: function () { return tool_server_http_1.isLoopbackRequest; } });
190
+ var tool_server_cli_1 = require("./mcp/tool-server-cli");
191
+ Object.defineProperty(exports, "runToolServer", { enumerable: true, get: function () { return tool_server_cli_1.runToolServer; } });
192
+ Object.defineProperty(exports, "parseToolServerArgs", { enumerable: true, get: function () { return tool_server_cli_1.parseToolServerArgs; } });
193
+ Object.defineProperty(exports, "toolServerUsage", { enumerable: true, get: function () { return tool_server_cli_1.toolServerUsage; } });
148
194
  // ── Workflow — WorkflowBuilder/Def in AgentEngine.runWorkflow public API ────────
149
195
  var WorkflowBuilder_1 = require("./workflow/WorkflowBuilder");
150
196
  Object.defineProperty(exports, "workflow", { enumerable: true, get: function () { return WorkflowBuilder_1.workflow; } });