@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.
- package/README.md +4 -0
- package/dist/__tests__/cli-baseline.test.d.ts +2 -0
- package/dist/__tests__/cli-baseline.test.d.ts.map +1 -0
- package/dist/__tests__/cli-baseline.test.js +114 -0
- package/dist/__tests__/cli-baseline.test.js.map +1 -0
- package/dist/__tests__/createCodingEngine.forwarding.test.js +2 -1
- package/dist/__tests__/createCodingEngine.forwarding.test.js.map +1 -1
- package/dist/__tests__/workspace-trust.test.js +7 -5
- package/dist/__tests__/workspace-trust.test.js.map +1 -1
- package/dist/agents/AgentLoader.d.ts.map +1 -1
- package/dist/agents/AgentLoader.js +2 -1
- package/dist/agents/AgentLoader.js.map +1 -1
- package/dist/cli/agent-discovery/AgentPackageLoader.d.ts +22 -0
- package/dist/cli/agent-discovery/AgentPackageLoader.d.ts.map +1 -0
- package/dist/cli/agent-discovery/AgentPackageLoader.js +100 -0
- package/dist/cli/agent-discovery/AgentPackageLoader.js.map +1 -0
- package/dist/cli/agent-discovery/RemoteAgentRegistry.d.ts +31 -0
- package/dist/cli/agent-discovery/RemoteAgentRegistry.d.ts.map +1 -0
- package/dist/cli/agent-discovery/RemoteAgentRegistry.js +106 -0
- package/dist/cli/agent-discovery/RemoteAgentRegistry.js.map +1 -0
- package/dist/cli/agent-discovery/__tests__/RemoteAgentRegistry.ssrf.test.d.ts +2 -0
- package/dist/cli/agent-discovery/__tests__/RemoteAgentRegistry.ssrf.test.d.ts.map +1 -0
- package/dist/cli/agent-discovery/__tests__/RemoteAgentRegistry.ssrf.test.js +34 -0
- package/dist/cli/agent-discovery/__tests__/RemoteAgentRegistry.ssrf.test.js.map +1 -0
- package/dist/cli/agent-discovery/__tests__/discoverAgents.test.d.ts +2 -0
- package/dist/cli/agent-discovery/__tests__/discoverAgents.test.d.ts.map +1 -0
- package/dist/cli/agent-discovery/__tests__/discoverAgents.test.js +147 -0
- package/dist/cli/agent-discovery/__tests__/discoverAgents.test.js.map +1 -0
- package/dist/cli/agent-discovery/__tests__/download-guard.test.d.ts +2 -0
- package/dist/cli/agent-discovery/__tests__/download-guard.test.d.ts.map +1 -0
- package/dist/cli/agent-discovery/__tests__/download-guard.test.js +47 -0
- package/dist/cli/agent-discovery/__tests__/download-guard.test.js.map +1 -0
- package/dist/cli/agent-discovery/discoverAgents.d.ts +21 -0
- package/dist/cli/agent-discovery/discoverAgents.d.ts.map +1 -0
- package/dist/cli/agent-discovery/discoverAgents.js +74 -0
- package/dist/cli/agent-discovery/discoverAgents.js.map +1 -0
- package/dist/cli/agent-discovery/download-guard.d.ts +20 -0
- package/dist/cli/agent-discovery/download-guard.d.ts.map +1 -0
- package/dist/cli/agent-discovery/download-guard.js +84 -0
- package/dist/cli/agent-discovery/download-guard.js.map +1 -0
- package/dist/cli/agent-discovery/index.d.ts +5 -0
- package/dist/cli/agent-discovery/index.d.ts.map +1 -0
- package/dist/cli/agent-discovery/index.js +12 -0
- package/dist/cli/agent-discovery/index.js.map +1 -0
- package/dist/cli/agent-discovery/types.d.ts +48 -0
- package/dist/cli/agent-discovery/types.d.ts.map +1 -0
- package/dist/cli/agent-discovery/types.js +3 -0
- package/dist/cli/agent-discovery/types.js.map +1 -0
- package/dist/cli/bootstrap/GlobalSeed.d.ts +46 -0
- package/dist/cli/bootstrap/GlobalSeed.d.ts.map +1 -0
- package/dist/cli/bootstrap/GlobalSeed.js +285 -0
- package/dist/cli/bootstrap/GlobalSeed.js.map +1 -0
- package/dist/cli/bootstrap/config.d.ts +24 -0
- package/dist/cli/bootstrap/config.d.ts.map +1 -0
- package/dist/cli/bootstrap/config.js +71 -0
- package/dist/cli/bootstrap/config.js.map +1 -0
- package/dist/cli/checkpoint/index.d.ts +17 -0
- package/dist/cli/checkpoint/index.d.ts.map +1 -0
- package/dist/cli/checkpoint/index.js +207 -0
- package/dist/cli/checkpoint/index.js.map +1 -0
- package/dist/cli/commands/builtin.d.ts +7 -0
- package/dist/cli/commands/builtin.d.ts.map +1 -0
- package/dist/cli/commands/builtin.js +962 -0
- package/dist/cli/commands/builtin.js.map +1 -0
- package/dist/cli/context/__tests__/formatPipeline.test.d.ts +2 -0
- package/dist/cli/context/__tests__/formatPipeline.test.d.ts.map +1 -0
- package/dist/cli/context/__tests__/formatPipeline.test.js +25 -0
- package/dist/cli/context/__tests__/formatPipeline.test.js.map +1 -0
- package/dist/cli/context/index.d.ts +8 -0
- package/dist/cli/context/index.d.ts.map +1 -0
- package/dist/cli/context/index.js +8 -0
- package/dist/cli/context/index.js.map +1 -0
- package/dist/cli/context/pipeline.d.ts +46 -0
- package/dist/cli/context/pipeline.d.ts.map +1 -0
- package/dist/cli/context/pipeline.js +112 -0
- package/dist/cli/context/pipeline.js.map +1 -0
- package/dist/cli/context/stages/stage-instructions.d.ts +12 -0
- package/dist/cli/context/stages/stage-instructions.d.ts.map +1 -0
- package/dist/cli/context/stages/stage-instructions.js +76 -0
- package/dist/cli/context/stages/stage-instructions.js.map +1 -0
- package/dist/cli/context/stages/stage-lessons.d.ts +13 -0
- package/dist/cli/context/stages/stage-lessons.d.ts.map +1 -0
- package/dist/cli/context/stages/stage-lessons.js +83 -0
- package/dist/cli/context/stages/stage-lessons.js.map +1 -0
- package/dist/cli/context/stages/stage-manifest.d.ts +11 -0
- package/dist/cli/context/stages/stage-manifest.d.ts.map +1 -0
- package/dist/cli/context/stages/stage-manifest.js +62 -0
- package/dist/cli/context/stages/stage-manifest.js.map +1 -0
- package/dist/cli/context/stages/stage-project.d.ts +10 -0
- package/dist/cli/context/stages/stage-project.d.ts.map +1 -0
- package/dist/cli/context/stages/stage-project.js +55 -0
- package/dist/cli/context/stages/stage-project.js.map +1 -0
- package/dist/cli/context/stages/stage-session.d.ts +12 -0
- package/dist/cli/context/stages/stage-session.d.ts.map +1 -0
- package/dist/cli/context/stages/stage-session.js +69 -0
- package/dist/cli/context/stages/stage-session.js.map +1 -0
- package/dist/cli/file-sources.d.ts +17 -0
- package/dist/cli/file-sources.d.ts.map +1 -0
- package/dist/cli/file-sources.js +42 -0
- package/dist/cli/file-sources.js.map +1 -0
- package/dist/cli/index.d.ts +26 -0
- package/dist/cli/index.d.ts.map +1 -0
- package/dist/cli/index.js +55 -0
- package/dist/cli/index.js.map +1 -0
- package/dist/cli/skills/__tests__/SkillLoader.test.d.ts +2 -0
- package/dist/cli/skills/__tests__/SkillLoader.test.d.ts.map +1 -0
- package/dist/cli/skills/__tests__/SkillLoader.test.js +285 -0
- package/dist/cli/skills/__tests__/SkillLoader.test.js.map +1 -0
- package/dist/cli/skills/__tests__/SkillManager.safety.test.d.ts +2 -0
- package/dist/cli/skills/__tests__/SkillManager.safety.test.d.ts.map +1 -0
- package/dist/cli/skills/__tests__/SkillManager.safety.test.js +87 -0
- package/dist/cli/skills/__tests__/SkillManager.safety.test.js.map +1 -0
- package/dist/cli/skills/__tests__/stack.test.d.ts +2 -0
- package/dist/cli/skills/__tests__/stack.test.d.ts.map +1 -0
- package/dist/cli/skills/__tests__/stack.test.js +81 -0
- package/dist/cli/skills/__tests__/stack.test.js.map +1 -0
- package/dist/cli/skills/loader.d.ts +42 -0
- package/dist/cli/skills/loader.d.ts.map +1 -0
- package/dist/cli/skills/loader.js +158 -0
- package/dist/cli/skills/loader.js.map +1 -0
- package/dist/cli/skills/manager.d.ts +97 -0
- package/dist/cli/skills/manager.d.ts.map +1 -0
- package/dist/cli/skills/manager.js +304 -0
- package/dist/cli/skills/manager.js.map +1 -0
- package/dist/cli/skills/parse-md-skill.d.ts +14 -0
- package/dist/cli/skills/parse-md-skill.d.ts.map +1 -0
- package/dist/cli/skills/parse-md-skill.js +86 -0
- package/dist/cli/skills/parse-md-skill.js.map +1 -0
- package/dist/cli/skills/providers/github.d.ts +21 -0
- package/dist/cli/skills/providers/github.d.ts.map +1 -0
- package/dist/cli/skills/providers/github.js +146 -0
- package/dist/cli/skills/providers/github.js.map +1 -0
- package/dist/cli/skills/providers/index.d.ts +6 -0
- package/dist/cli/skills/providers/index.d.ts.map +1 -0
- package/dist/cli/skills/providers/index.js +12 -0
- package/dist/cli/skills/providers/index.js.map +1 -0
- package/dist/cli/skills/providers/local.d.ts +16 -0
- package/dist/cli/skills/providers/local.d.ts.map +1 -0
- package/dist/cli/skills/providers/local.js +91 -0
- package/dist/cli/skills/providers/local.js.map +1 -0
- package/dist/cli/skills/providers/obsidian.d.ts +31 -0
- package/dist/cli/skills/providers/obsidian.d.ts.map +1 -0
- package/dist/cli/skills/providers/obsidian.js +141 -0
- package/dist/cli/skills/providers/obsidian.js.map +1 -0
- package/dist/cli/skills/providers/skills-sh.d.ts +32 -0
- package/dist/cli/skills/providers/skills-sh.d.ts.map +1 -0
- package/dist/cli/skills/providers/skills-sh.js +53 -0
- package/dist/cli/skills/providers/skills-sh.js.map +1 -0
- package/dist/cli/skills/providers/types.d.ts +25 -0
- package/dist/cli/skills/providers/types.d.ts.map +1 -0
- package/dist/cli/skills/providers/types.js +3 -0
- package/dist/cli/skills/providers/types.js.map +1 -0
- package/dist/cli/skills/safe-name.d.ts +2 -0
- package/dist/cli/skills/safe-name.d.ts.map +1 -0
- package/dist/cli/skills/safe-name.js +22 -0
- package/dist/cli/skills/safe-name.js.map +1 -0
- package/dist/cli/skills/stack.d.ts +3 -0
- package/dist/cli/skills/stack.d.ts.map +1 -0
- package/dist/cli/skills/stack.js +64 -0
- package/dist/cli/skills/stack.js.map +1 -0
- package/dist/cli/skills/types.d.ts +28 -0
- package/dist/cli/skills/types.d.ts.map +1 -0
- package/dist/cli/skills/types.js +3 -0
- package/dist/cli/skills/types.js.map +1 -0
- package/dist/cli/trust/__tests__/workspace-trust.test.d.ts +2 -0
- package/dist/cli/trust/__tests__/workspace-trust.test.d.ts.map +1 -0
- package/dist/cli/trust/__tests__/workspace-trust.test.js +252 -0
- package/dist/cli/trust/__tests__/workspace-trust.test.js.map +1 -0
- package/dist/cli/trust/workspace-trust.d.ts +49 -0
- package/dist/cli/trust/workspace-trust.d.ts.map +1 -0
- package/dist/cli/trust/workspace-trust.js +163 -0
- package/dist/cli/trust/workspace-trust.js.map +1 -0
- package/dist/cli/workspace/index.d.ts +68 -0
- package/dist/cli/workspace/index.d.ts.map +1 -0
- package/dist/cli/workspace/index.js +231 -0
- package/dist/cli/workspace/index.js.map +1 -0
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +5 -4
- package/dist/index.js.map +1 -1
- package/dist/store/ProjectStore.d.ts.map +1 -1
- package/dist/store/ProjectStore.js +2 -1
- package/dist/store/ProjectStore.js.map +1 -1
- 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 @@
|
|
|
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 @@
|
|
|
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":";;AAwBA,kCAoBC;AAcD,sDAgCC;AA1FD,6BAAqC;AACrC,2CAAsC;AAkBtC,MAAM,aAAa,GAAa,CAAC,IAAI,EAAE,EAAE,CAAC,IAAA,iBAAM,EAAC,IAAI,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC;AAEtE,MAAM,aAAa,GAAG,+CAA+C,CAAC;AAEtE,iGAAiG;AACjG,SAAgB,WAAW,CAAC,EAAU;IAClC,MAAM,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IACnD,IAAI,IAAA,YAAM,EAAC,CAAC,CAAC;QAAE,OAAO,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;IAC5D,IAAI,CAAC,IAAA,YAAM,EAAC,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC,CAAC,kCAAkC;IAE/D,kFAAkF;IAClF,MAAM,YAAY,GAAG,+BAA+B,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC7D,IAAI,YAAY;QAAE,OAAO,WAAW,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;IAC7E,MAAM,SAAS,GAAG,0CAA0C,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACrE,IAAI,SAAS,EAAE,CAAC;QACZ,MAAM,EAAE,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACtC,MAAM,EAAE,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACtC,OAAO,WAAW,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,EAAE,GAAG,GAAG,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC;IAC/D,CAAC;IAED,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,KAAK;QAAE,OAAO,IAAI,CAAC;IAC3C,MAAM,KAAK,GAAG,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,EAAE,EAAE,CAAC,CAAC;IACnD,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,MAAM;QAAE,OAAO,IAAI,CAAC,CAAC,wBAAwB;IACtE,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,MAAM;QAAE,OAAO,IAAI,CAAC,CAAC,uBAAuB;IACrE,OAAO,KAAK,CAAC;AACjB,CAAC;AAED,SAAS,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAW;IACpC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,GAAG;QAAE,OAAO,IAAI,CAAC;IAClD,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,GAAG;QAAE,OAAO,IAAI,CAAC,CAAW,QAAQ;IACrE,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,GAAG;QAAE,OAAO,IAAI,CAAC,CAAqB,6BAA6B;IAC1F,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE;QAAE,OAAO,IAAI,CAAC;IACjD,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,GAAG;QAAE,OAAO,IAAI,CAAC;IACxC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACjD,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC;QAAE,OAAO,IAAI,CAAC,CAAO,eAAe;IAC3E,IAAI,CAAC,IAAI,GAAG;QAAE,OAAO,IAAI,CAAC,CAAmC,iCAAiC;IAC9F,OAAO,KAAK,CAAC;AACjB,CAAC;AAEM,KAAK,UAAU,qBAAqB,CACvC,GAAW,EACX,WAAmB,EACnB,UAAoB,aAAa;IAEjC,IAAI,GAAQ,CAAC;IACb,IAAI,CAAC;QACD,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;IACvB,CAAC;IAAC,MAAM,CAAC;QACL,MAAM,IAAI,KAAK,CAAC,kCAAkC,GAAG,EAAE,CAAC,CAAC;IAC7D,CAAC;IACD,IAAI,GAAG,CAAC,QAAQ,KAAK,QAAQ,IAAI,GAAG,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;QACxD,MAAM,IAAI,KAAK,CAAC,iCAAiC,GAAG,CAAC,QAAQ,kBAAkB,GAAG,EAAE,CAAC,CAAC;IAC1F,CAAC;IAED,IAAI,CAAC;QACD,IAAI,IAAI,GAAG,CAAC,WAAW,CAAC,CAAC,MAAM,KAAK,GAAG,CAAC,MAAM;YAAE,OAAO;IAC3D,CAAC;IAAC,MAAM,CAAC,CAAC,uDAAuD,CAAC,CAAC;IAEnE,MAAM,IAAI,GAAG,GAAG,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAChE,IAAI,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,KAAK,UAAU,EAAE,CAAC;QAClD,MAAM,IAAI,KAAK,CAAC,6BAA6B,IAAI,kBAAkB,GAAG,EAAE,CAAC,CAAC;IAC9E,CAAC;IACD,MAAM,SAAS,GAAG,IAAA,YAAM,EAAC,IAAI,CAAC,IAAI,IAAA,YAAM,EAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3F,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,wBAAwB,IAAI,sBAAsB,GAAG,EAAE,CAAC,CAAC;IAC7E,CAAC;IACD,KAAK,MAAM,EAAE,OAAO,EAAE,IAAI,SAAS,EAAE,CAAC;QAClC,IAAI,WAAW,CAAC,OAAO,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,wBAAwB,IAAI,mCAAmC,OAAO,MAAM,GAAG,EAAE,CAAC,CAAC;QACvG,CAAC;IACL,CAAC;AACL,CAAC"}
|
|
@@ -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 @@
|
|
|
1
|
+
{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/cli/agent-discovery/types.ts"],"names":[],"mappings":""}
|