@backendkit-labs/agent-coding 0.29.0 → 0.31.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 +20 -10
- 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__/createCodingEngine.learning.test.d.ts +2 -0
- package/dist/__tests__/createCodingEngine.learning.test.d.ts.map +1 -0
- package/dist/__tests__/createCodingEngine.learning.test.js +81 -0
- package/dist/__tests__/createCodingEngine.learning.test.js.map +1 -0
- 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 +13 -1
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +17 -7
- package/dist/index.js.map +1 -1
- package/dist/pipeline/index.d.ts +2 -0
- package/dist/pipeline/index.d.ts.map +1 -1
- package/dist/pipeline/index.js +7 -1
- package/dist/pipeline/index.js.map +1 -1
- package/dist/pipeline/learning/__tests__/learning.test.d.ts +2 -0
- package/dist/pipeline/learning/__tests__/learning.test.d.ts.map +1 -0
- package/dist/pipeline/learning/__tests__/learning.test.js +145 -0
- package/dist/pipeline/learning/__tests__/learning.test.js.map +1 -0
- package/dist/pipeline/learning/index.d.ts +33 -0
- package/dist/pipeline/learning/index.d.ts.map +1 -0
- package/dist/pipeline/learning/index.js +131 -0
- package/dist/pipeline/learning/index.js.map +1 -0
- package/dist/pipeline/orchestration/audit/audit-reflection-bridge.d.ts +8 -2
- package/dist/pipeline/orchestration/audit/audit-reflection-bridge.d.ts.map +1 -1
- package/dist/pipeline/orchestration/audit/audit-reflection-bridge.js +19 -3
- package/dist/pipeline/orchestration/audit/audit-reflection-bridge.js.map +1 -1
- package/dist/pipeline/orchestration/audit-reporter.d.ts +5 -1
- package/dist/pipeline/orchestration/audit-reporter.d.ts.map +1 -1
- package/dist/pipeline/orchestration/audit-reporter.js +6 -0
- package/dist/pipeline/orchestration/audit-reporter.js.map +1 -1
- package/dist/pipeline/orchestration/orchestrator.d.ts +9 -0
- package/dist/pipeline/orchestration/orchestrator.d.ts.map +1 -1
- package/dist/pipeline/orchestration/orchestrator.js +15 -0
- package/dist/pipeline/orchestration/orchestrator.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,31 @@
|
|
|
1
|
+
import type { AgentProfile } from '@backendkit-labs/agent-core';
|
|
2
|
+
import type { RemoteRegistryIndex } from './types';
|
|
3
|
+
/**
|
|
4
|
+
* Fetches and caches agent packages from a remote registry.
|
|
5
|
+
*
|
|
6
|
+
* Registry index format (served at registryUrl):
|
|
7
|
+
* {
|
|
8
|
+
* "version": "1",
|
|
9
|
+
* "agents": [
|
|
10
|
+
* { "name": "@bk/agent-devops-aws", "version": "1.0.0",
|
|
11
|
+
* "description": "...", "downloadUrl": "https://..." }
|
|
12
|
+
* ]
|
|
13
|
+
* }
|
|
14
|
+
*
|
|
15
|
+
* Each downloadUrl must return a valid agent.yaml body.
|
|
16
|
+
*/
|
|
17
|
+
export declare class RemoteAgentRegistry {
|
|
18
|
+
private readonly registryUrl;
|
|
19
|
+
private readonly cacheDir;
|
|
20
|
+
constructor(registryUrl: string, cacheDir: string);
|
|
21
|
+
/** Fetch the registry index (cached for 1 hour). */
|
|
22
|
+
fetchIndex(): Promise<RemoteRegistryIndex>;
|
|
23
|
+
/**
|
|
24
|
+
* Download and cache a package by name.
|
|
25
|
+
* Returns null and logs a warning if the package is not found or invalid.
|
|
26
|
+
*/
|
|
27
|
+
installPackage(packageName: string): Promise<AgentProfile | null>;
|
|
28
|
+
private downloadAndCache;
|
|
29
|
+
private parseYamlAgent;
|
|
30
|
+
}
|
|
31
|
+
//# sourceMappingURL=RemoteAgentRegistry.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"RemoteAgentRegistry.d.ts","sourceRoot":"","sources":["../../../src/cli/agent-discovery/RemoteAgentRegistry.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,KAAK,EAAE,mBAAmB,EAAwB,MAAM,SAAS,CAAC;AAIzE;;;;;;;;;;;;;GAaG;AACH,qBAAa,mBAAmB;IAExB,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBADR,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM;IAKrC,oDAAoD;IAC9C,UAAU,IAAI,OAAO,CAAC,mBAAmB,CAAC;IAsBhD;;;OAGG;IACG,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;YA6BzD,gBAAgB;IAmB9B,OAAO,CAAC,cAAc;CAazB"}
|
|
@@ -0,0 +1,106 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.RemoteAgentRegistry = void 0;
|
|
4
|
+
const fs_1 = require("fs");
|
|
5
|
+
const path_1 = require("path");
|
|
6
|
+
const yaml_1 = require("yaml");
|
|
7
|
+
const agent_core_1 = require("@backendkit-labs/agent-core");
|
|
8
|
+
const download_guard_1 = require("./download-guard");
|
|
9
|
+
const INDEX_CACHE_TTL_MS = 60 * 60 * 1000; // 1 hour
|
|
10
|
+
/**
|
|
11
|
+
* Fetches and caches agent packages from a remote registry.
|
|
12
|
+
*
|
|
13
|
+
* Registry index format (served at registryUrl):
|
|
14
|
+
* {
|
|
15
|
+
* "version": "1",
|
|
16
|
+
* "agents": [
|
|
17
|
+
* { "name": "@bk/agent-devops-aws", "version": "1.0.0",
|
|
18
|
+
* "description": "...", "downloadUrl": "https://..." }
|
|
19
|
+
* ]
|
|
20
|
+
* }
|
|
21
|
+
*
|
|
22
|
+
* Each downloadUrl must return a valid agent.yaml body.
|
|
23
|
+
*/
|
|
24
|
+
class RemoteAgentRegistry {
|
|
25
|
+
registryUrl;
|
|
26
|
+
cacheDir;
|
|
27
|
+
constructor(registryUrl, cacheDir) {
|
|
28
|
+
this.registryUrl = registryUrl;
|
|
29
|
+
this.cacheDir = cacheDir;
|
|
30
|
+
(0, fs_1.mkdirSync)(cacheDir, { recursive: true });
|
|
31
|
+
}
|
|
32
|
+
/** Fetch the registry index (cached for 1 hour). */
|
|
33
|
+
async fetchIndex() {
|
|
34
|
+
const cachePath = (0, path_1.join)(this.cacheDir, '_index.json');
|
|
35
|
+
if ((0, fs_1.existsSync)(cachePath)) {
|
|
36
|
+
const wrapper = JSON.parse((0, fs_1.readFileSync)(cachePath, 'utf-8'));
|
|
37
|
+
if (Date.now() - wrapper.fetchedAt < INDEX_CACHE_TTL_MS) {
|
|
38
|
+
return wrapper.data;
|
|
39
|
+
}
|
|
40
|
+
}
|
|
41
|
+
const resp = await fetch(this.registryUrl, { headers: { Accept: 'application/json' } });
|
|
42
|
+
if (!resp.ok) {
|
|
43
|
+
throw new Error(`Registry fetch failed ${resp.status}: ${resp.statusText}`);
|
|
44
|
+
}
|
|
45
|
+
const data = await resp.json();
|
|
46
|
+
(0, agent_core_1.atomicWriteSync)(cachePath, JSON.stringify({ fetchedAt: Date.now(), data }, null, 2));
|
|
47
|
+
return data;
|
|
48
|
+
}
|
|
49
|
+
/**
|
|
50
|
+
* Download and cache a package by name.
|
|
51
|
+
* Returns null and logs a warning if the package is not found or invalid.
|
|
52
|
+
*/
|
|
53
|
+
async installPackage(packageName) {
|
|
54
|
+
const safeName = packageName.replace(/[@/]/g, '_');
|
|
55
|
+
const packageDir = (0, path_1.join)(this.cacheDir, safeName);
|
|
56
|
+
const agentPath = (0, path_1.join)(packageDir, 'agent.yaml');
|
|
57
|
+
// Use cached version if available
|
|
58
|
+
if ((0, fs_1.existsSync)(agentPath)) {
|
|
59
|
+
return this.parseYamlAgent(agentPath, packageName);
|
|
60
|
+
}
|
|
61
|
+
let pkg;
|
|
62
|
+
try {
|
|
63
|
+
const index = await this.fetchIndex();
|
|
64
|
+
pkg = index.agents.find(a => a.name === packageName);
|
|
65
|
+
}
|
|
66
|
+
catch (err) {
|
|
67
|
+
console.warn(`[AgentDiscovery] Registry unavailable for "${packageName}": ${err.message}`);
|
|
68
|
+
return null;
|
|
69
|
+
}
|
|
70
|
+
if (!pkg) {
|
|
71
|
+
console.warn(`[AgentDiscovery] Package "${packageName}" not found in registry`);
|
|
72
|
+
return null;
|
|
73
|
+
}
|
|
74
|
+
return this.downloadAndCache(pkg, packageDir, agentPath);
|
|
75
|
+
}
|
|
76
|
+
// ── Private ────────────────────────────────────────────────────────────────
|
|
77
|
+
async downloadAndCache(pkg, packageDir, agentPath) {
|
|
78
|
+
// downloadUrl comes from the registry index: check it, and refuse redirects (they skip the check).
|
|
79
|
+
await (0, download_guard_1.assertSafeDownloadUrl)(pkg.downloadUrl, this.registryUrl);
|
|
80
|
+
const resp = await fetch(pkg.downloadUrl, { redirect: 'error' });
|
|
81
|
+
if (!resp.ok) {
|
|
82
|
+
throw new Error(`Download failed for "${pkg.name}" (${resp.status}): ${resp.statusText}`);
|
|
83
|
+
}
|
|
84
|
+
const content = await resp.text();
|
|
85
|
+
(0, fs_1.mkdirSync)(packageDir, { recursive: true });
|
|
86
|
+
(0, agent_core_1.atomicWriteSync)(agentPath, content);
|
|
87
|
+
console.log(`[AgentDiscovery] Installed "${pkg.name}@${pkg.version}" → ${agentPath}`);
|
|
88
|
+
return this.parseYamlAgent(agentPath, pkg.name);
|
|
89
|
+
}
|
|
90
|
+
parseYamlAgent(filePath, packageName) {
|
|
91
|
+
try {
|
|
92
|
+
const raw = (0, yaml_1.parse)((0, fs_1.readFileSync)(filePath, 'utf-8'));
|
|
93
|
+
if (!raw?.id || !raw?.systemPrompt || !Array.isArray(raw?.allowedTools)) {
|
|
94
|
+
console.warn(`[AgentDiscovery] Invalid agent.yaml for package "${packageName}"`);
|
|
95
|
+
return null;
|
|
96
|
+
}
|
|
97
|
+
return { ...raw, source: 'registry' };
|
|
98
|
+
}
|
|
99
|
+
catch (err) {
|
|
100
|
+
console.warn(`[AgentDiscovery] Parse error for "${packageName}": ${err.message}`);
|
|
101
|
+
return null;
|
|
102
|
+
}
|
|
103
|
+
}
|
|
104
|
+
}
|
|
105
|
+
exports.RemoteAgentRegistry = RemoteAgentRegistry;
|
|
106
|
+
//# sourceMappingURL=RemoteAgentRegistry.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"RemoteAgentRegistry.js","sourceRoot":"","sources":["../../../src/cli/agent-discovery/RemoteAgentRegistry.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"RemoteAgentRegistry.ssrf.test.d.ts","sourceRoot":"","sources":["../../../../src/cli/agent-discovery/__tests__/RemoteAgentRegistry.ssrf.test.ts"],"names":[],"mappings":""}
|
|
@@ -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"}
|