@backendkit-labs/agent-coding 0.29.0 → 0.30.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 (183) hide show
  1. package/README.md +4 -0
  2. package/dist/__tests__/cli-baseline.test.d.ts +2 -0
  3. package/dist/__tests__/cli-baseline.test.d.ts.map +1 -0
  4. package/dist/__tests__/cli-baseline.test.js +114 -0
  5. package/dist/__tests__/cli-baseline.test.js.map +1 -0
  6. package/dist/__tests__/createCodingEngine.forwarding.test.js +2 -1
  7. package/dist/__tests__/createCodingEngine.forwarding.test.js.map +1 -1
  8. package/dist/__tests__/workspace-trust.test.js +7 -5
  9. package/dist/__tests__/workspace-trust.test.js.map +1 -1
  10. package/dist/agents/AgentLoader.d.ts.map +1 -1
  11. package/dist/agents/AgentLoader.js +2 -1
  12. package/dist/agents/AgentLoader.js.map +1 -1
  13. package/dist/cli/agent-discovery/AgentPackageLoader.d.ts +22 -0
  14. package/dist/cli/agent-discovery/AgentPackageLoader.d.ts.map +1 -0
  15. package/dist/cli/agent-discovery/AgentPackageLoader.js +100 -0
  16. package/dist/cli/agent-discovery/AgentPackageLoader.js.map +1 -0
  17. package/dist/cli/agent-discovery/RemoteAgentRegistry.d.ts +31 -0
  18. package/dist/cli/agent-discovery/RemoteAgentRegistry.d.ts.map +1 -0
  19. package/dist/cli/agent-discovery/RemoteAgentRegistry.js +106 -0
  20. package/dist/cli/agent-discovery/RemoteAgentRegistry.js.map +1 -0
  21. package/dist/cli/agent-discovery/__tests__/RemoteAgentRegistry.ssrf.test.d.ts +2 -0
  22. package/dist/cli/agent-discovery/__tests__/RemoteAgentRegistry.ssrf.test.d.ts.map +1 -0
  23. package/dist/cli/agent-discovery/__tests__/RemoteAgentRegistry.ssrf.test.js +34 -0
  24. package/dist/cli/agent-discovery/__tests__/RemoteAgentRegistry.ssrf.test.js.map +1 -0
  25. package/dist/cli/agent-discovery/__tests__/discoverAgents.test.d.ts +2 -0
  26. package/dist/cli/agent-discovery/__tests__/discoverAgents.test.d.ts.map +1 -0
  27. package/dist/cli/agent-discovery/__tests__/discoverAgents.test.js +147 -0
  28. package/dist/cli/agent-discovery/__tests__/discoverAgents.test.js.map +1 -0
  29. package/dist/cli/agent-discovery/__tests__/download-guard.test.d.ts +2 -0
  30. package/dist/cli/agent-discovery/__tests__/download-guard.test.d.ts.map +1 -0
  31. package/dist/cli/agent-discovery/__tests__/download-guard.test.js +47 -0
  32. package/dist/cli/agent-discovery/__tests__/download-guard.test.js.map +1 -0
  33. package/dist/cli/agent-discovery/discoverAgents.d.ts +21 -0
  34. package/dist/cli/agent-discovery/discoverAgents.d.ts.map +1 -0
  35. package/dist/cli/agent-discovery/discoverAgents.js +74 -0
  36. package/dist/cli/agent-discovery/discoverAgents.js.map +1 -0
  37. package/dist/cli/agent-discovery/download-guard.d.ts +20 -0
  38. package/dist/cli/agent-discovery/download-guard.d.ts.map +1 -0
  39. package/dist/cli/agent-discovery/download-guard.js +84 -0
  40. package/dist/cli/agent-discovery/download-guard.js.map +1 -0
  41. package/dist/cli/agent-discovery/index.d.ts +5 -0
  42. package/dist/cli/agent-discovery/index.d.ts.map +1 -0
  43. package/dist/cli/agent-discovery/index.js +12 -0
  44. package/dist/cli/agent-discovery/index.js.map +1 -0
  45. package/dist/cli/agent-discovery/types.d.ts +48 -0
  46. package/dist/cli/agent-discovery/types.d.ts.map +1 -0
  47. package/dist/cli/agent-discovery/types.js +3 -0
  48. package/dist/cli/agent-discovery/types.js.map +1 -0
  49. package/dist/cli/bootstrap/GlobalSeed.d.ts +46 -0
  50. package/dist/cli/bootstrap/GlobalSeed.d.ts.map +1 -0
  51. package/dist/cli/bootstrap/GlobalSeed.js +285 -0
  52. package/dist/cli/bootstrap/GlobalSeed.js.map +1 -0
  53. package/dist/cli/bootstrap/config.d.ts +24 -0
  54. package/dist/cli/bootstrap/config.d.ts.map +1 -0
  55. package/dist/cli/bootstrap/config.js +71 -0
  56. package/dist/cli/bootstrap/config.js.map +1 -0
  57. package/dist/cli/checkpoint/index.d.ts +17 -0
  58. package/dist/cli/checkpoint/index.d.ts.map +1 -0
  59. package/dist/cli/checkpoint/index.js +207 -0
  60. package/dist/cli/checkpoint/index.js.map +1 -0
  61. package/dist/cli/commands/builtin.d.ts +7 -0
  62. package/dist/cli/commands/builtin.d.ts.map +1 -0
  63. package/dist/cli/commands/builtin.js +962 -0
  64. package/dist/cli/commands/builtin.js.map +1 -0
  65. package/dist/cli/context/__tests__/formatPipeline.test.d.ts +2 -0
  66. package/dist/cli/context/__tests__/formatPipeline.test.d.ts.map +1 -0
  67. package/dist/cli/context/__tests__/formatPipeline.test.js +25 -0
  68. package/dist/cli/context/__tests__/formatPipeline.test.js.map +1 -0
  69. package/dist/cli/context/index.d.ts +8 -0
  70. package/dist/cli/context/index.d.ts.map +1 -0
  71. package/dist/cli/context/index.js +8 -0
  72. package/dist/cli/context/index.js.map +1 -0
  73. package/dist/cli/context/pipeline.d.ts +46 -0
  74. package/dist/cli/context/pipeline.d.ts.map +1 -0
  75. package/dist/cli/context/pipeline.js +112 -0
  76. package/dist/cli/context/pipeline.js.map +1 -0
  77. package/dist/cli/context/stages/stage-instructions.d.ts +12 -0
  78. package/dist/cli/context/stages/stage-instructions.d.ts.map +1 -0
  79. package/dist/cli/context/stages/stage-instructions.js +76 -0
  80. package/dist/cli/context/stages/stage-instructions.js.map +1 -0
  81. package/dist/cli/context/stages/stage-lessons.d.ts +13 -0
  82. package/dist/cli/context/stages/stage-lessons.d.ts.map +1 -0
  83. package/dist/cli/context/stages/stage-lessons.js +83 -0
  84. package/dist/cli/context/stages/stage-lessons.js.map +1 -0
  85. package/dist/cli/context/stages/stage-manifest.d.ts +11 -0
  86. package/dist/cli/context/stages/stage-manifest.d.ts.map +1 -0
  87. package/dist/cli/context/stages/stage-manifest.js +62 -0
  88. package/dist/cli/context/stages/stage-manifest.js.map +1 -0
  89. package/dist/cli/context/stages/stage-project.d.ts +10 -0
  90. package/dist/cli/context/stages/stage-project.d.ts.map +1 -0
  91. package/dist/cli/context/stages/stage-project.js +55 -0
  92. package/dist/cli/context/stages/stage-project.js.map +1 -0
  93. package/dist/cli/context/stages/stage-session.d.ts +12 -0
  94. package/dist/cli/context/stages/stage-session.d.ts.map +1 -0
  95. package/dist/cli/context/stages/stage-session.js +69 -0
  96. package/dist/cli/context/stages/stage-session.js.map +1 -0
  97. package/dist/cli/file-sources.d.ts +17 -0
  98. package/dist/cli/file-sources.d.ts.map +1 -0
  99. package/dist/cli/file-sources.js +42 -0
  100. package/dist/cli/file-sources.js.map +1 -0
  101. package/dist/cli/index.d.ts +26 -0
  102. package/dist/cli/index.d.ts.map +1 -0
  103. package/dist/cli/index.js +55 -0
  104. package/dist/cli/index.js.map +1 -0
  105. package/dist/cli/skills/__tests__/SkillLoader.test.d.ts +2 -0
  106. package/dist/cli/skills/__tests__/SkillLoader.test.d.ts.map +1 -0
  107. package/dist/cli/skills/__tests__/SkillLoader.test.js +285 -0
  108. package/dist/cli/skills/__tests__/SkillLoader.test.js.map +1 -0
  109. package/dist/cli/skills/__tests__/SkillManager.safety.test.d.ts +2 -0
  110. package/dist/cli/skills/__tests__/SkillManager.safety.test.d.ts.map +1 -0
  111. package/dist/cli/skills/__tests__/SkillManager.safety.test.js +87 -0
  112. package/dist/cli/skills/__tests__/SkillManager.safety.test.js.map +1 -0
  113. package/dist/cli/skills/__tests__/stack.test.d.ts +2 -0
  114. package/dist/cli/skills/__tests__/stack.test.d.ts.map +1 -0
  115. package/dist/cli/skills/__tests__/stack.test.js +81 -0
  116. package/dist/cli/skills/__tests__/stack.test.js.map +1 -0
  117. package/dist/cli/skills/loader.d.ts +42 -0
  118. package/dist/cli/skills/loader.d.ts.map +1 -0
  119. package/dist/cli/skills/loader.js +158 -0
  120. package/dist/cli/skills/loader.js.map +1 -0
  121. package/dist/cli/skills/manager.d.ts +97 -0
  122. package/dist/cli/skills/manager.d.ts.map +1 -0
  123. package/dist/cli/skills/manager.js +304 -0
  124. package/dist/cli/skills/manager.js.map +1 -0
  125. package/dist/cli/skills/parse-md-skill.d.ts +14 -0
  126. package/dist/cli/skills/parse-md-skill.d.ts.map +1 -0
  127. package/dist/cli/skills/parse-md-skill.js +86 -0
  128. package/dist/cli/skills/parse-md-skill.js.map +1 -0
  129. package/dist/cli/skills/providers/github.d.ts +21 -0
  130. package/dist/cli/skills/providers/github.d.ts.map +1 -0
  131. package/dist/cli/skills/providers/github.js +146 -0
  132. package/dist/cli/skills/providers/github.js.map +1 -0
  133. package/dist/cli/skills/providers/index.d.ts +6 -0
  134. package/dist/cli/skills/providers/index.d.ts.map +1 -0
  135. package/dist/cli/skills/providers/index.js +12 -0
  136. package/dist/cli/skills/providers/index.js.map +1 -0
  137. package/dist/cli/skills/providers/local.d.ts +16 -0
  138. package/dist/cli/skills/providers/local.d.ts.map +1 -0
  139. package/dist/cli/skills/providers/local.js +91 -0
  140. package/dist/cli/skills/providers/local.js.map +1 -0
  141. package/dist/cli/skills/providers/obsidian.d.ts +31 -0
  142. package/dist/cli/skills/providers/obsidian.d.ts.map +1 -0
  143. package/dist/cli/skills/providers/obsidian.js +141 -0
  144. package/dist/cli/skills/providers/obsidian.js.map +1 -0
  145. package/dist/cli/skills/providers/skills-sh.d.ts +32 -0
  146. package/dist/cli/skills/providers/skills-sh.d.ts.map +1 -0
  147. package/dist/cli/skills/providers/skills-sh.js +53 -0
  148. package/dist/cli/skills/providers/skills-sh.js.map +1 -0
  149. package/dist/cli/skills/providers/types.d.ts +25 -0
  150. package/dist/cli/skills/providers/types.d.ts.map +1 -0
  151. package/dist/cli/skills/providers/types.js +3 -0
  152. package/dist/cli/skills/providers/types.js.map +1 -0
  153. package/dist/cli/skills/safe-name.d.ts +2 -0
  154. package/dist/cli/skills/safe-name.d.ts.map +1 -0
  155. package/dist/cli/skills/safe-name.js +22 -0
  156. package/dist/cli/skills/safe-name.js.map +1 -0
  157. package/dist/cli/skills/stack.d.ts +3 -0
  158. package/dist/cli/skills/stack.d.ts.map +1 -0
  159. package/dist/cli/skills/stack.js +64 -0
  160. package/dist/cli/skills/stack.js.map +1 -0
  161. package/dist/cli/skills/types.d.ts +28 -0
  162. package/dist/cli/skills/types.d.ts.map +1 -0
  163. package/dist/cli/skills/types.js +3 -0
  164. package/dist/cli/skills/types.js.map +1 -0
  165. package/dist/cli/trust/__tests__/workspace-trust.test.d.ts +2 -0
  166. package/dist/cli/trust/__tests__/workspace-trust.test.d.ts.map +1 -0
  167. package/dist/cli/trust/__tests__/workspace-trust.test.js +252 -0
  168. package/dist/cli/trust/__tests__/workspace-trust.test.js.map +1 -0
  169. package/dist/cli/trust/workspace-trust.d.ts +49 -0
  170. package/dist/cli/trust/workspace-trust.d.ts.map +1 -0
  171. package/dist/cli/trust/workspace-trust.js +163 -0
  172. package/dist/cli/trust/workspace-trust.js.map +1 -0
  173. package/dist/cli/workspace/index.d.ts +68 -0
  174. package/dist/cli/workspace/index.d.ts.map +1 -0
  175. package/dist/cli/workspace/index.js +231 -0
  176. package/dist/cli/workspace/index.js.map +1 -0
  177. package/dist/index.d.ts.map +1 -1
  178. package/dist/index.js +5 -4
  179. package/dist/index.js.map +1 -1
  180. package/dist/store/ProjectStore.d.ts.map +1 -1
  181. package/dist/store/ProjectStore.js +2 -1
  182. package/dist/store/ProjectStore.js.map +1 -1
  183. package/package.json +10 -2
@@ -0,0 +1,34 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ const fs_1 = require("fs");
4
+ const os_1 = require("os");
5
+ const path_1 = require("path");
6
+ const RemoteAgentRegistry_1 = require("../RemoteAgentRegistry");
7
+ describe('RemoteAgentRegistry download guard', () => {
8
+ let dir;
9
+ const realFetch = global.fetch;
10
+ let fetchMock;
11
+ beforeEach(() => {
12
+ dir = (0, fs_1.mkdtempSync)((0, path_1.join)((0, os_1.tmpdir)(), 'bk-registry-'));
13
+ fetchMock = jest.fn(async (url) => {
14
+ if (String(url).endsWith('index.json')) {
15
+ return new Response(JSON.stringify({
16
+ version: '1',
17
+ agents: [{ name: 'evil', version: '1', description: 'x', downloadUrl: 'http://169.254.169.254/latest/meta-data' }],
18
+ }));
19
+ }
20
+ return new Response('id: x');
21
+ });
22
+ global.fetch = fetchMock;
23
+ });
24
+ afterEach(() => {
25
+ global.fetch = realFetch;
26
+ (0, fs_1.rmSync)(dir, { recursive: true, force: true });
27
+ });
28
+ it('does not request an internal downloadUrl taken from the index', async () => {
29
+ const registry = new RemoteAgentRegistry_1.RemoteAgentRegistry('https://registry.example.com/index.json', dir);
30
+ await expect(registry.installPackage('evil')).rejects.toThrow(/Unsafe download URL/);
31
+ expect(fetchMock.mock.calls.map(c => String(c[0]))).toEqual(['https://registry.example.com/index.json']);
32
+ });
33
+ });
34
+ //# sourceMappingURL=RemoteAgentRegistry.ssrf.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"RemoteAgentRegistry.ssrf.test.js","sourceRoot":"","sources":["../../../../src/cli/agent-discovery/__tests__/RemoteAgentRegistry.ssrf.test.ts"],"names":[],"mappings":";;AAAA,2BAAyC;AACzC,2BAA4B;AAC5B,+BAA4B;AAC5B,gEAA6D;AAE7D,QAAQ,CAAC,oCAAoC,EAAE,GAAG,EAAE;IAChD,IAAI,GAAW,CAAC;IAChB,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC;IAC/B,IAAI,SAAoB,CAAC;IAEzB,UAAU,CAAC,GAAG,EAAE;QACZ,GAAG,GAAG,IAAA,gBAAW,EAAC,IAAA,WAAI,EAAC,IAAA,WAAM,GAAE,EAAE,cAAc,CAAC,CAAC,CAAC;QAClD,SAAS,GAAG,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,GAAW,EAAE,EAAE;YACtC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;gBACrC,OAAO,IAAI,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC;oBAC/B,OAAO,EAAE,GAAG;oBACZ,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,WAAW,EAAE,GAAG,EAAE,WAAW,EAAE,yCAAyC,EAAE,CAAC;iBACrH,CAAC,CAAC,CAAC;YACR,CAAC;YACD,OAAO,IAAI,QAAQ,CAAC,OAAO,CAAC,CAAC;QACjC,CAAC,CAAC,CAAC;QACH,MAAM,CAAC,KAAK,GAAG,SAAoC,CAAC;IACxD,CAAC,CAAC,CAAC;IACH,SAAS,CAAC,GAAG,EAAE;QACX,MAAM,CAAC,KAAK,GAAG,SAAS,CAAC;QACzB,IAAA,WAAM,EAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+DAA+D,EAAE,KAAK,IAAI,EAAE;QAC3E,MAAM,QAAQ,GAAG,IAAI,yCAAmB,CAAC,yCAAyC,EAAE,GAAG,CAAC,CAAC;QACzF,MAAM,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,qBAAqB,CAAC,CAAC;QACrF,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,yCAAyC,CAAC,CAAC,CAAC;IAC7G,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=discoverAgents.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"discoverAgents.test.d.ts","sourceRoot":"","sources":["../../../../src/cli/agent-discovery/__tests__/discoverAgents.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,147 @@
1
+ "use strict";
2
+ var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
3
+ if (k2 === undefined) k2 = k;
4
+ var desc = Object.getOwnPropertyDescriptor(m, k);
5
+ if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
6
+ desc = { enumerable: true, get: function() { return m[k]; } };
7
+ }
8
+ Object.defineProperty(o, k2, desc);
9
+ }) : (function(o, m, k, k2) {
10
+ if (k2 === undefined) k2 = k;
11
+ o[k2] = m[k];
12
+ }));
13
+ var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
14
+ Object.defineProperty(o, "default", { enumerable: true, value: v });
15
+ }) : function(o, v) {
16
+ o["default"] = v;
17
+ });
18
+ var __importStar = (this && this.__importStar) || (function () {
19
+ var ownKeys = function(o) {
20
+ ownKeys = Object.getOwnPropertyNames || function (o) {
21
+ var ar = [];
22
+ for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
23
+ return ar;
24
+ };
25
+ return ownKeys(o);
26
+ };
27
+ return function (mod) {
28
+ if (mod && mod.__esModule) return mod;
29
+ var result = {};
30
+ if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
31
+ __setModuleDefault(result, mod);
32
+ return result;
33
+ };
34
+ })();
35
+ Object.defineProperty(exports, "__esModule", { value: true });
36
+ const fs = __importStar(require("node:fs"));
37
+ const os = __importStar(require("node:os"));
38
+ const path = __importStar(require("node:path"));
39
+ const discoverAgents_1 = require("../discoverAgents");
40
+ const AgentPackageLoader_1 = require("../AgentPackageLoader");
41
+ const workspace_trust_1 = require("../../trust/workspace-trust");
42
+ const APP = 'disc-test';
43
+ let root;
44
+ let home;
45
+ let project;
46
+ const agentYaml = (id, prompt) => `id: ${id}\nname: ${id}\ndescription: d\nsystemPrompt: ${prompt}\nallowedTools: []\n`;
47
+ function put(dir, file, content) {
48
+ fs.mkdirSync(dir, { recursive: true });
49
+ fs.writeFileSync(path.join(dir, file), content);
50
+ }
51
+ const globalDir = () => (0, AgentPackageLoader_1.globalAgentsDir)(APP);
52
+ const projectDir = () => path.join(project, `.${APP}`, 'agents');
53
+ const discover = (extra = {}) => (0, discoverAgents_1.discoverAgents)({ appName: APP, workingDir: project, ...extra });
54
+ beforeEach(() => {
55
+ root = fs.mkdtempSync(path.join(os.tmpdir(), 'discover-'));
56
+ home = path.join(root, 'home');
57
+ project = path.join(root, 'repo');
58
+ fs.mkdirSync(home);
59
+ fs.mkdirSync(project);
60
+ process.env.USERPROFILE = home;
61
+ process.env.HOME = home;
62
+ delete process.env.BK_TRUST_PROJECT;
63
+ jest.spyOn(console, 'warn').mockImplementation(() => undefined);
64
+ });
65
+ afterEach(() => {
66
+ jest.restoreAllMocks();
67
+ fs.rmSync(root, { recursive: true, force: true });
68
+ delete process.env.USERPROFILE;
69
+ delete process.env.HOME;
70
+ delete process.env.BK_TRUST_PROJECT;
71
+ });
72
+ describe('discoverAgents — the project layer needs the workspace to be trusted', () => {
73
+ it('an untrusted project\'s agents are NOT loaded, and the warning names them', async () => {
74
+ put(projectDir(), 'evil.yaml', agentYaml('evil', 'exfiltrate everything'));
75
+ put(projectDir(), 'ok.yaml', agentYaml('ok', 'fine'));
76
+ const found = await discover();
77
+ expect(found.map(a => a.id)).toEqual([]);
78
+ const warning = console.warn.mock.calls.map(c => String(c[0])).join('\n');
79
+ expect(warning).toContain('not trusted');
80
+ expect(warning).toContain('2 agent(s)');
81
+ expect(warning).toContain('evil');
82
+ expect(warning).toContain('ok');
83
+ });
84
+ it('does not even parse an untrusted project\'s files (a broken one raises no parse warning)', async () => {
85
+ put(projectDir(), 'broken.yaml', ': : not yaml {{{');
86
+ await discover();
87
+ const warnings = console.warn.mock.calls.map(c => String(c[0]));
88
+ expect(warnings.some(w => w.includes('Failed to parse'))).toBe(false);
89
+ });
90
+ it('a trusted project loads (trustProject, or BK_TRUST_PROJECT=1)', async () => {
91
+ put(projectDir(), 'mine.yaml', agentYaml('mine', 'p'));
92
+ (0, workspace_trust_1.trustProject)(APP, project);
93
+ expect((await discover()).map(a => a.id)).toEqual(['mine']);
94
+ fs.rmSync(path.join(home, `.${APP}`), { recursive: true, force: true });
95
+ expect(await discover()).toEqual([]); // trust gone: left out again
96
+ process.env.BK_TRUST_PROJECT = '1';
97
+ expect((await discover()).map(a => a.id)).toEqual(['mine']);
98
+ });
99
+ it('`trusted` passed by the host wins over the trust file, in both directions', async () => {
100
+ put(projectDir(), 'mine.yaml', agentYaml('mine', 'p'));
101
+ expect((await discover({ trusted: true })).map(a => a.id)).toEqual(['mine']);
102
+ (0, workspace_trust_1.trustProject)(APP, project);
103
+ expect(await discover({ trusted: false })).toEqual([]);
104
+ });
105
+ it('global agents always load, untrusted project or not', async () => {
106
+ put(globalDir(), 'shared.yaml', agentYaml('shared', 'g'));
107
+ put(projectDir(), 'repo-agent.yaml', agentYaml('repo-agent', 'r'));
108
+ expect((await discover()).map(a => a.id)).toEqual(['shared']);
109
+ });
110
+ it('an untrusted project with no agents says nothing', async () => {
111
+ await discover();
112
+ expect(console.warn).not.toHaveBeenCalled();
113
+ });
114
+ });
115
+ describe('discoverAgents — precedence: project over global', () => {
116
+ it('the same id in both: the trusted project\'s version wins (as in coding\'s AgentLoader)', async () => {
117
+ put(globalDir(), 'helper.yaml', agentYaml('helper', 'global prompt'));
118
+ put(projectDir(), 'helper.yaml', agentYaml('helper', 'project prompt'));
119
+ (0, workspace_trust_1.trustProject)(APP, project);
120
+ const [helper, ...rest] = await discover();
121
+ expect(rest).toEqual([]);
122
+ expect(helper).toMatchObject({ id: 'helper', systemPrompt: 'project prompt', source: 'project' });
123
+ });
124
+ it('with the project untrusted the global one is what remains', async () => {
125
+ put(globalDir(), 'helper.yaml', agentYaml('helper', 'global prompt'));
126
+ put(projectDir(), 'helper.yaml', agentYaml('helper', 'project prompt'));
127
+ const [helper] = await discover();
128
+ expect(helper).toMatchObject({ systemPrompt: 'global prompt', source: 'global' });
129
+ });
130
+ });
131
+ describe('discoverAgents — one home directory for the framework', () => {
132
+ it('the global directory follows USERPROFILE/HOME like the trust file and AgentLoader', () => {
133
+ expect(globalDir()).toBe(path.join(home, `.${APP}`, 'agents'));
134
+ });
135
+ });
136
+ describe('listAgentEntries', () => {
137
+ it('lists names of yaml/json files and agent.yaml directories, reading nothing', () => {
138
+ put(projectDir(), 'a.yaml', 'x');
139
+ put(projectDir(), 'b.json', 'x');
140
+ put(path.join(projectDir(), 'pkg'), 'agent.yaml', 'x');
141
+ put(path.join(projectDir(), 'notes'), 'readme.md', 'x'); // a directory without agent.yaml
142
+ put(path.join(projectDir(), 'registry'), 'cached.yaml', 'x'); // the registry cache is skipped
143
+ expect((0, AgentPackageLoader_1.listAgentEntries)(projectDir())).toEqual(['a', 'b', 'pkg']);
144
+ expect((0, AgentPackageLoader_1.listAgentEntries)(path.join(root, 'missing'))).toEqual([]);
145
+ });
146
+ });
147
+ //# sourceMappingURL=discoverAgents.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"discoverAgents.test.js","sourceRoot":"","sources":["../../../../src/cli/agent-discovery/__tests__/discoverAgents.test.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=download-guard.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"download-guard.test.d.ts","sourceRoot":"","sources":["../../../../src/cli/agent-discovery/__tests__/download-guard.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,47 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ const download_guard_1 = require("../download-guard");
4
+ const REGISTRY = 'https://registry.example.com/index.json';
5
+ const publicDns = async () => [{ address: '93.184.216.34' }];
6
+ describe('isPrivateIp', () => {
7
+ it.each([
8
+ '127.0.0.1', '10.1.2.3', '172.16.0.1', '172.31.255.255', '192.168.1.1', '169.254.169.254',
9
+ '100.64.0.1', '0.0.0.0', '224.0.0.1', '::1', '::', 'fd00::1', 'fe80::1', '::ffff:127.0.0.1', '::ffff:7f00:1',
10
+ ])('%s is not public', (ip) => {
11
+ expect((0, download_guard_1.isPrivateIp)(ip)).toBe(true);
12
+ });
13
+ it.each(['93.184.216.34', '8.8.8.8', '172.32.0.1', '2606:4700::1111', '::ffff:8.8.8.8'])('%s is public', (ip) => {
14
+ expect((0, download_guard_1.isPrivateIp)(ip)).toBe(false);
15
+ });
16
+ });
17
+ describe('assertSafeDownloadUrl', () => {
18
+ it('accepts a public https URL', async () => {
19
+ await expect((0, download_guard_1.assertSafeDownloadUrl)('https://cdn.example.org/a.yaml', REGISTRY, publicDns)).resolves.toBeUndefined();
20
+ });
21
+ it.each(['file:///etc/passwd', 'ftp://example.org/a', 'javascript:alert(1)', 'not a url'])('rejects %s', async (u) => {
22
+ await expect((0, download_guard_1.assertSafeDownloadUrl)(u, REGISTRY, publicDns)).rejects.toThrow(/Unsafe download URL/);
23
+ });
24
+ it.each([
25
+ 'http://localhost/a', 'http://127.0.0.1/a', 'http://169.254.169.254/latest/meta-data',
26
+ 'http://[::1]/a', 'http://metadata.google.internal/a', 'http://10.0.0.5:8080/a', 'http://[::ffff:7f00:1]/a',
27
+ ])('rejects %s', async (u) => {
28
+ await expect((0, download_guard_1.assertSafeDownloadUrl)(u, REGISTRY, publicDns)).rejects.toThrow(/Unsafe download URL/);
29
+ });
30
+ it('rejects a public-looking name that resolves to a private address', async () => {
31
+ const rebinding = async () => [{ address: '93.184.216.34' }, { address: '10.0.0.7' }];
32
+ await expect((0, download_guard_1.assertSafeDownloadUrl)('https://evil.example.org/a', REGISTRY, rebinding)).rejects.toThrow(/10\.0\.0\.7/);
33
+ });
34
+ it('rejects a host that does not resolve', async () => {
35
+ await expect((0, download_guard_1.assertSafeDownloadUrl)('https://nada.example.org/a', REGISTRY, async () => [])).rejects.toThrow(/did not resolve/);
36
+ });
37
+ it('accepts a private address when it is the registry itself (registry inside the company network)', async () => {
38
+ const internal = 'http://registry.corp.internal:8080/index.json';
39
+ await expect((0, download_guard_1.assertSafeDownloadUrl)('http://registry.corp.internal:8080/agents/a.yaml', internal, publicDns)).resolves.toBeUndefined();
40
+ });
41
+ it('does not extend that trust to another port or host', async () => {
42
+ const internal = 'http://10.0.0.5:8080/index.json';
43
+ await expect((0, download_guard_1.assertSafeDownloadUrl)('http://10.0.0.5:9999/a.yaml', internal, publicDns)).rejects.toThrow(/Unsafe/);
44
+ await expect((0, download_guard_1.assertSafeDownloadUrl)('http://10.0.0.6:8080/a.yaml', internal, publicDns)).rejects.toThrow(/Unsafe/);
45
+ });
46
+ });
47
+ //# sourceMappingURL=download-guard.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"download-guard.test.js","sourceRoot":"","sources":["../../../../src/cli/agent-discovery/__tests__/download-guard.test.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,21 @@
1
+ import type { AgentProfile } from '@backendkit-labs/agent-core';
2
+ import type { AgentDiscoveryConfig } from './types';
3
+ /**
4
+ * Discover agents from local directories and/or a remote registry.
5
+ *
6
+ * Local layout (appName = 'bk-agent'):
7
+ * ~/.bk-agent/agents/ ← global agents (shared across projects)
8
+ * {workingDir}/.bk-agent/agents/ ← project-local agents (git-tracked); only in a TRUSTED project
9
+ *
10
+ * Remote:
11
+ * Fetch the registry index, download requested packages, cache locally.
12
+ * Re-running is fast — cached packages are reused until deleted.
13
+ *
14
+ * Deduplication: if the same agent id appears in multiple sources, the first occurrence wins:
15
+ * project → global → registry → static agents. The project overrides the global one, as in coding's AgentLoader.
16
+ *
17
+ * Format: this loader reads `*.yaml|yml|json` and `<name>/agent.yaml` (a full AgentProfile); coding's AgentLoader
18
+ * reads `*.json` (+ `.md` prompt) from the same directories. They are two formats on purpose, not one divergent copy.
19
+ */
20
+ export declare function discoverAgents(config: AgentDiscoveryConfig): Promise<AgentProfile[]>;
21
+ //# sourceMappingURL=discoverAgents.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"discoverAgents.d.ts","sourceRoot":"","sources":["../../../src/cli/agent-discovery/discoverAgents.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAMpD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,cAAc,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAwD1F"}
@@ -0,0 +1,74 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.discoverAgents = discoverAgents;
4
+ const path_1 = require("path");
5
+ const workspace_trust_1 = require("../trust/workspace-trust");
6
+ const agent_core_1 = require("@backendkit-labs/agent-core");
7
+ const AgentPackageLoader_1 = require("./AgentPackageLoader");
8
+ const RemoteAgentRegistry_1 = require("./RemoteAgentRegistry");
9
+ const DEFAULT_APP_NAME = 'bk-agent';
10
+ /**
11
+ * Discover agents from local directories and/or a remote registry.
12
+ *
13
+ * Local layout (appName = 'bk-agent'):
14
+ * ~/.bk-agent/agents/ ← global agents (shared across projects)
15
+ * {workingDir}/.bk-agent/agents/ ← project-local agents (git-tracked); only in a TRUSTED project
16
+ *
17
+ * Remote:
18
+ * Fetch the registry index, download requested packages, cache locally.
19
+ * Re-running is fast — cached packages are reused until deleted.
20
+ *
21
+ * Deduplication: if the same agent id appears in multiple sources, the first occurrence wins:
22
+ * project → global → registry → static agents. The project overrides the global one, as in coding's AgentLoader.
23
+ *
24
+ * Format: this loader reads `*.yaml|yml|json` and `<name>/agent.yaml` (a full AgentProfile); coding's AgentLoader
25
+ * reads `*.json` (+ `.md` prompt) from the same directories. They are two formats on purpose, not one divergent copy.
26
+ */
27
+ async function discoverAgents(config) {
28
+ const appName = config.appName ?? DEFAULT_APP_NAME;
29
+ const cwd = config.workingDir ?? process.cwd();
30
+ const agents = [];
31
+ const seen = new Set();
32
+ const add = (incoming) => {
33
+ for (const a of incoming) {
34
+ if (!seen.has(a.id)) {
35
+ seen.add(a.id);
36
+ agents.push(a);
37
+ }
38
+ }
39
+ };
40
+ // 1. Local: the project first (it overrides), then the global ones
41
+ if (config.local !== false) {
42
+ const projectDir = (0, AgentPackageLoader_1.projectAgentsDir)(cwd, appName);
43
+ const trusted = config.trusted ?? (0, workspace_trust_1.isProjectTrusted)(appName, cwd).trusted;
44
+ if (trusted) {
45
+ add((0, AgentPackageLoader_1.loadAgentsFromDir)(projectDir, 'project'));
46
+ }
47
+ else {
48
+ const left = (0, AgentPackageLoader_1.listAgentEntries)(projectDir);
49
+ if (left.length > 0) {
50
+ console.warn(`[AgentDiscovery] This project is not trusted, so its own ${left.length} agent(s) (${left.join(', ')}) in ${projectDir} were NOT loaded. ` +
51
+ `Trust it with /trust add (or BK_TRUST_PROJECT=1) only if you trust whoever wrote that repository.`);
52
+ }
53
+ }
54
+ add((0, AgentPackageLoader_1.loadAgentsFromDir)((0, AgentPackageLoader_1.globalAgentsDir)(appName), 'global'));
55
+ }
56
+ // 2. Remote: install packages
57
+ if (config.install?.length) {
58
+ const cacheDir = config.cacheDir ?? (0, path_1.join)((0, agent_core_1.getFrameworkDir)(appName), 'agents', 'registry');
59
+ const registryUrl = config.remote ?? 'https://registry.backendkit.dev/agents';
60
+ const registry = new RemoteAgentRegistry_1.RemoteAgentRegistry(registryUrl, cacheDir);
61
+ const results = await Promise.allSettled(config.install.map(name => registry.installPackage(name)));
62
+ for (let i = 0; i < results.length; i++) {
63
+ const result = results[i];
64
+ if (result.status === 'fulfilled' && result.value) {
65
+ add([result.value]);
66
+ }
67
+ else if (result.status === 'rejected') {
68
+ console.warn(`[AgentDiscovery] Failed to install "${config.install[i]}": ${result.reason.message}`);
69
+ }
70
+ }
71
+ }
72
+ return agents;
73
+ }
74
+ //# sourceMappingURL=discoverAgents.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"discoverAgents.js","sourceRoot":"","sources":["../../../src/cli/agent-discovery/discoverAgents.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,20 @@
1
+ /**
2
+ * SSRF guard for the download URLs of a remote agent registry.
3
+ *
4
+ * The `downloadUrl` of every package comes from the registry index, which is data fetched over the
5
+ * network, so it is not trusted: it may point at localhost, the cloud metadata endpoint
6
+ * (169.254.169.254) or an internal service. A URL is accepted when:
7
+ * - the protocol is http or https, and
8
+ * - it has the same origin as the registry itself (the operator configured that host, so a registry
9
+ * inside the company network keeps working), or every address its host resolves to is public.
10
+ *
11
+ * Not covered: a host whose DNS answer changes between this check and the request (DNS rebinding).
12
+ * Redirects are refused by the caller (`redirect: 'error'`), since they would skip this check.
13
+ */
14
+ export type LookupFn = (host: string) => Promise<Array<{
15
+ address: string;
16
+ }>>;
17
+ /** True for loopback, private, link-local, CGNAT, unspecified and other non-public addresses. */
18
+ export declare function isPrivateIp(ip: string): boolean;
19
+ export declare function assertSafeDownloadUrl(raw: string, registryUrl: string, resolve?: LookupFn): Promise<void>;
20
+ //# sourceMappingURL=download-guard.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"download-guard.d.ts","sourceRoot":"","sources":["../../../src/cli/agent-discovery/download-guard.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;GAYG;AAEH,MAAM,MAAM,QAAQ,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,KAAK,CAAC;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,CAAC;AAM7E,iGAAiG;AACjG,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAoB/C;AAcD,wBAAsB,qBAAqB,CACvC,GAAG,EAAE,MAAM,EACX,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,QAAwB,GAClC,OAAO,CAAC,IAAI,CAAC,CA4Bf"}
@@ -0,0 +1,84 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.isPrivateIp = isPrivateIp;
4
+ exports.assertSafeDownloadUrl = assertSafeDownloadUrl;
5
+ const net_1 = require("net");
6
+ const promises_1 = require("dns/promises");
7
+ const defaultLookup = (host) => (0, promises_1.lookup)(host, { all: true });
8
+ const BLOCKED_HOSTS = /(^|\.)(localhost|local|internal|localdomain)$/;
9
+ /** True for loopback, private, link-local, CGNAT, unspecified and other non-public addresses. */
10
+ function isPrivateIp(ip) {
11
+ const v = ip.toLowerCase().replace(/^\[|\]$/g, '');
12
+ if ((0, net_1.isIPv4)(v))
13
+ return isPrivateV4(v.split('.').map(Number));
14
+ if (!(0, net_1.isIPv6)(v))
15
+ return true; // not an IP we understand: refuse
16
+ // IPv4-mapped (::ffff:a.b.c.d or ::ffff:7f00:1): judge the embedded IPv4 address.
17
+ const mappedDotted = /^::ffff:(\d+\.\d+\.\d+\.\d+)$/.exec(v);
18
+ if (mappedDotted)
19
+ return isPrivateV4(mappedDotted[1].split('.').map(Number));
20
+ const mappedHex = /^::ffff:([0-9a-f]{1,4}):([0-9a-f]{1,4})$/.exec(v);
21
+ if (mappedHex) {
22
+ const hi = parseInt(mappedHex[1], 16);
23
+ const lo = parseInt(mappedHex[2], 16);
24
+ return isPrivateV4([hi >> 8, hi & 255, lo >> 8, lo & 255]);
25
+ }
26
+ if (v === '::' || v === '::1')
27
+ return true;
28
+ const first = parseInt(v.split(':')[0] || '0', 16);
29
+ if ((first & 0xfe00) === 0xfc00)
30
+ return true; // fc00::/7 unique local
31
+ if ((first & 0xffc0) === 0xfe80)
32
+ return true; // fe80::/10 link-local
33
+ return false;
34
+ }
35
+ function isPrivateV4([a, b, c]) {
36
+ if (a === 0 || a === 10 || a === 127)
37
+ return true;
38
+ if (a === 100 && b >= 64 && b <= 127)
39
+ return true; // CGNAT
40
+ if (a === 169 && b === 254)
41
+ return true; // link-local, cloud metadata
42
+ if (a === 172 && b >= 16 && b <= 31)
43
+ return true;
44
+ if (a === 192 && b === 168)
45
+ return true;
46
+ if (a === 192 && b === 0 && c === 0)
47
+ return true;
48
+ if (a === 198 && (b === 18 || b === 19))
49
+ return true; // benchmarking
50
+ if (a >= 224)
51
+ return true; // multicast, reserved, broadcast
52
+ return false;
53
+ }
54
+ async function assertSafeDownloadUrl(raw, registryUrl, resolve = defaultLookup) {
55
+ let url;
56
+ try {
57
+ url = new URL(raw);
58
+ }
59
+ catch {
60
+ throw new Error(`Unsafe download URL (invalid): ${raw}`);
61
+ }
62
+ if (url.protocol !== 'https:' && url.protocol !== 'http:') {
63
+ throw new Error(`Unsafe download URL (protocol ${url.protocol} not allowed): ${raw}`);
64
+ }
65
+ try {
66
+ if (new URL(registryUrl).origin === url.origin)
67
+ return;
68
+ }
69
+ catch { /* an invalid registry URL cannot vouch for anything */ }
70
+ const host = url.hostname.toLowerCase().replace(/^\[|\]$/g, '');
71
+ if (BLOCKED_HOSTS.test(host) || host === 'metadata') {
72
+ throw new Error(`Unsafe download URL (host ${host} is internal): ${raw}`);
73
+ }
74
+ const addresses = (0, net_1.isIPv4)(host) || (0, net_1.isIPv6)(host) ? [{ address: host }] : await resolve(host);
75
+ if (addresses.length === 0) {
76
+ throw new Error(`Unsafe download URL (${host} did not resolve): ${raw}`);
77
+ }
78
+ for (const { address } of addresses) {
79
+ if (isPrivateIp(address)) {
80
+ throw new Error(`Unsafe download URL (${host} resolves to non-public address ${address}): ${raw}`);
81
+ }
82
+ }
83
+ }
84
+ //# sourceMappingURL=download-guard.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"download-guard.js","sourceRoot":"","sources":["../../../src/cli/agent-discovery/download-guard.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,5 @@
1
+ export { discoverAgents } from './discoverAgents';
2
+ export { RemoteAgentRegistry } from './RemoteAgentRegistry';
3
+ export { loadAgentsFromDir, globalAgentsDir, projectAgentsDir } from './AgentPackageLoader';
4
+ export type { AgentDiscoveryConfig, AgentPackageFile, RemotePackageListing, RemoteRegistryIndex, } from './types';
5
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cli/agent-discovery/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC5F,YAAY,EACR,oBAAoB,EACpB,gBAAgB,EAChB,oBAAoB,EACpB,mBAAmB,GACtB,MAAM,SAAS,CAAC"}
@@ -0,0 +1,12 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.projectAgentsDir = exports.globalAgentsDir = exports.loadAgentsFromDir = exports.RemoteAgentRegistry = exports.discoverAgents = void 0;
4
+ var discoverAgents_1 = require("./discoverAgents");
5
+ Object.defineProperty(exports, "discoverAgents", { enumerable: true, get: function () { return discoverAgents_1.discoverAgents; } });
6
+ var RemoteAgentRegistry_1 = require("./RemoteAgentRegistry");
7
+ Object.defineProperty(exports, "RemoteAgentRegistry", { enumerable: true, get: function () { return RemoteAgentRegistry_1.RemoteAgentRegistry; } });
8
+ var AgentPackageLoader_1 = require("./AgentPackageLoader");
9
+ Object.defineProperty(exports, "loadAgentsFromDir", { enumerable: true, get: function () { return AgentPackageLoader_1.loadAgentsFromDir; } });
10
+ Object.defineProperty(exports, "globalAgentsDir", { enumerable: true, get: function () { return AgentPackageLoader_1.globalAgentsDir; } });
11
+ Object.defineProperty(exports, "projectAgentsDir", { enumerable: true, get: function () { return AgentPackageLoader_1.projectAgentsDir; } });
12
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cli/agent-discovery/index.ts"],"names":[],"mappings":";;;AAAA,mDAAkD;AAAzC,gHAAA,cAAc,OAAA;AACvB,6DAA4D;AAAnD,0HAAA,mBAAmB,OAAA;AAC5B,2DAA4F;AAAnF,uHAAA,iBAAiB,OAAA;AAAE,qHAAA,eAAe,OAAA;AAAE,sHAAA,gBAAgB,OAAA"}
@@ -0,0 +1,48 @@
1
+ import type { AgentProfile } from '@backendkit-labs/agent-core';
2
+ /** Raw structure of an agent.yaml / agent.json file. */
3
+ export type AgentPackageFile = Omit<AgentProfile, 'source'> & {
4
+ source?: AgentProfile['source'];
5
+ };
6
+ export interface RemotePackageListing {
7
+ name: string;
8
+ version: string;
9
+ description: string;
10
+ /** URL to download the agent.yaml for this package. */
11
+ downloadUrl: string;
12
+ }
13
+ export interface RemoteRegistryIndex {
14
+ version: string;
15
+ agents: RemotePackageListing[];
16
+ }
17
+ export interface AgentDiscoveryConfig {
18
+ /**
19
+ * Application name used to locate global agent directories.
20
+ * Agents are looked up in ~/.{appName}/agents/.
21
+ * Defaults to 'bk-agent'.
22
+ */
23
+ appName?: string;
24
+ /**
25
+ * Load agents from the global (~/.{appName}/agents/) and
26
+ * project-local ({workingDir}/.{appName}/agents/) directories.
27
+ * Default: true.
28
+ */
29
+ local?: boolean;
30
+ /** Working directory for project-local agent loading. Defaults to process.cwd(). */
31
+ workingDir?: string;
32
+ /**
33
+ * Whether the project layer (`{workingDir}/.{appName}/agents`) may load. Default: asked of the workspace trust
34
+ * (ADR-0006): true only for a project the user trusted or with BK_TRUST_PROJECT=1. The agents of a repository
35
+ * are the repository's own content, so they load only on the user's say-so. Pass it when the host already decided.
36
+ */
37
+ trusted?: boolean;
38
+ /** Remote registry URL (e.g. 'https://registry.backendkit.dev/agents'). */
39
+ remote?: string;
40
+ /** Package names to install/cache from the remote registry. */
41
+ install?: string[];
42
+ /**
43
+ * Override the local cache directory for downloaded packages.
44
+ * Defaults to ~/.{appName}/agents/registry/.
45
+ */
46
+ cacheDir?: string;
47
+ }
48
+ //# sourceMappingURL=types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/cli/agent-discovery/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAIhE,wDAAwD;AACxD,MAAM,MAAM,gBAAgB,GAAG,IAAI,CAAC,YAAY,EAAE,QAAQ,CAAC,GAAG;IAC1D,MAAM,CAAC,EAAE,YAAY,CAAC,QAAQ,CAAC,CAAC;CACnC,CAAC;AAIF,MAAM,WAAW,oBAAoB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,uDAAuD;IACvD,WAAW,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,mBAAmB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,oBAAoB,EAAE,CAAC;CAClC;AAID,MAAM,WAAW,oBAAoB;IACjC;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,oFAAoF;IACpF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,2EAA2E;IAC3E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,+DAA+D;IAC/D,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB"}
@@ -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/cli/agent-discovery/types.ts"],"names":[],"mappings":""}