@botbotgo/agent-harness 0.0.182 → 0.0.183

package/README.md

@@ -326,6 +326,19 @@ const runtime: AgentHarnessRuntime = await createAgentHarness("/absolute/path/to
 
 `createAgentHarness(...)` loads the workspace, resolves `resources/`, initializes persistence under `runRoot`, and starts runtime maintenance.
 
+`runtime.spec.resources` may attach multiple extra resource packages. Each entry may point either to a package root that contains `resources/`, or directly to a resource folder that contains its own `package.json`.
+
+```yaml
+apiVersion: agent-harness/v1alpha1
+kind: Runtime
+metadata:
+  name: default
+spec:
+  resources:
+    - ../shared-tools
+    - file:../shared-skills
+```
+
 `createAgentHarness(..., { load })` accepts workspace loading controls.
 
 Merge order is deterministic:

package/README.zh.md

@@ -322,6 +322,19 @@ const runtime: AgentHarnessRuntime = await createAgentHarness("/absolute/path/to
 
 `createAgentHarness(...)` 会加载工作区、解析 `resources/`、在 `runRoot` 下初始化持久化，并启动运行时维护任务。
 
+`runtime.spec.resources` 可以挂载多个额外资源包。每个条目既可以指向“包根目录下带有 `resources/` 的目录”，也可以直接指向“自身带有 `package.json` 的资源目录”。
+
+```yaml
+apiVersion: agent-harness/v1alpha1
+kind: Runtime
+metadata:
+  name: default
+spec:
+  resources:
+    - ../shared-tools
+    - file:../shared-skills
+```
+
 `createAgentHarness(..., { load })` 支持工作区加载控制。
 
 合并顺序是确定性的：

package/dist/package-version.d.ts

@@ -1 +1 @@
-export declare const AGENT_HARNESS_VERSION = "0.0.181";
+export declare const AGENT_HARNESS_VERSION = "0.0.182";

package/dist/package-version.js

@@ -1 +1 @@
-export const AGENT_HARNESS_VERSION = "0.0.181";
+export const AGENT_HARNESS_VERSION = "0.0.182";

package/dist/resource/sources.js

@@ -31,6 +31,15 @@ export function resolveResourcePackageRoot(root) {
     }
     return null;
 }
+function resolveExplicitResourceRoot(root) {
+    if (isDirectoryPath(root)) {
+        const packageJsonPath = path.join(root, "package.json");
+        if (existsSync(packageJsonPath)) {
+            return root;
+        }
+    }
+    return resolveResourcePackageRoot(root);
+}
 export function isExternalSourceLocator(value) {
     return typeof value === "string" && /^(npm|tgz|file):/.test(value);
 }
@@ -198,17 +207,9 @@ export async function ensureExternalResourceSource(locator, workspaceRoot) {
     const parsed = parseExternalSourceLocator(locator);
     const baseLocator = `${parsed.kind}:${parsed.spec}`;
     const packageRoot = await ensureExternalSource(baseLocator, workspaceRoot);
-    const resourcesRoot = path.join(packageRoot, "resources");
-    if (!existsSync(resourcesRoot) || !statSync(resourcesRoot).isDirectory()) {
-        throw new Error(`External source ${baseLocator} is missing resources/.`);
-    }
-    const resourcePackageJson = path.join(resourcesRoot, "package.json");
-    if (!existsSync(resourcePackageJson)) {
-        throw new Error(`External source ${baseLocator} is missing resources/package.json.`);
-    }
-    const resourcePackageRoot = resolveResourcePackageRoot(packageRoot);
+    const resourcePackageRoot = resolveExplicitResourceRoot(packageRoot);
     if (!resourcePackageRoot) {
-        throw new Error(`External source ${baseLocator} is missing resources/package.json.`);
+        throw new Error(`External source ${baseLocator} is missing a resource package root or resources/package.json.`);
     }
     return parsed.subpath ? path.join(resourcePackageRoot, parsed.subpath) : resourcePackageRoot;
 }
@@ -235,17 +236,9 @@ export function resolveExternalResourcePath(locator, workspaceRoot) {
     const parsed = parseExternalSourceLocator(locator);
     const baseLocator = `${parsed.kind}:${parsed.spec}`;
     const packageRoot = resolveExternalSourcePath(baseLocator, workspaceRoot);
-    const resourcesRoot = path.join(packageRoot, "resources");
-    if (!existsSync(resourcesRoot) || !statSync(resourcesRoot).isDirectory()) {
-        throw new Error(`External source ${baseLocator} is missing resources/.`);
-    }
-    const resourcePackageJson = path.join(resourcesRoot, "package.json");
-    if (!existsSync(resourcePackageJson)) {
-        throw new Error(`External source ${baseLocator} is missing resources/package.json.`);
-    }
-    const resourcePackageRoot = resolveResourcePackageRoot(packageRoot);
+    const resourcePackageRoot = resolveExplicitResourceRoot(packageRoot);
     if (!resourcePackageRoot) {
-        throw new Error(`External source ${baseLocator} is missing resources/package.json.`);
+        throw new Error(`External source ${baseLocator} is missing a resource package root or resources/package.json.`);
     }
     return parsed.subpath ? path.join(resourcePackageRoot, parsed.subpath) : resourcePackageRoot;
 }

package/dist/workspace/compile.js

@@ -100,9 +100,10 @@ function validateRoutingTargets(refs, agentsList) {
 }
 function resolveLocalResourceRoot(candidate, workspaceRoot) {
     const resolved = path.resolve(workspaceRoot, candidate);
-    const resourceRoot = resolveResourcePackageRoot(resolved);
+    const directPackageJsonPath = path.join(resolved, "package.json");
+    const resourceRoot = existsSync(directPackageJsonPath) ? resolved : resolveResourcePackageRoot(resolved);
     if (!resourceRoot) {
-        throw new Error(`Workspace resource ${candidate} is missing resources/package.json.`);
+        throw new Error(`Workspace resource ${candidate} is missing package.json or resources/package.json.`);
     }
     return resourceRoot;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@botbotgo/agent-harness",
-  "version": "0.0.182",
+  "version": "0.0.183",
   "description": "Workspace runtime for multi-agent applications",
   "type": "module",
   "packageManager": "npm@10.9.2",