@botbotgo/agent-harness 0.0.136 → 0.0.137

package/README.md

@@ -688,10 +688,8 @@ spec:
   subagents: []
   mcpServers: []
   config:
-    checkpointer:
-      ref: checkpointer/default
-    store:
-      ref: store/default
+    checkpointer: default
+    store: default
     interruptOn: {}
     filesystem:
       rootDir: .
@@ -722,12 +720,9 @@ spec:
   subagents: []
   mcpServers: []
   config:
-    store:
-      ref: store/default
-    checkpointer:
-      ref: checkpointer/default
-    backend:
-      ref: backend/default
+    store: default
+    checkpointer: default
+    backend: default
     interruptOn: {}
     middleware: []
 ```

package/README.zh.md

@@ -677,10 +677,8 @@ spec:
   subagents: []
   mcpServers: []
   config:
-    checkpointer:
-      ref: checkpointer/default
-    store:
-      ref: store/default
+    checkpointer: default
+    store: default
     interruptOn: {}
     filesystem:
       rootDir: .
@@ -711,12 +709,9 @@ spec:
   subagents: []
   mcpServers: []
   config:
-    store:
-      ref: store/default
-    checkpointer:
-      ref: checkpointer/default
-    backend:
-      ref: backend/default
+    store: default
+    checkpointer: default
+    backend: default
     interruptOn: {}
     middleware: []
 ```

package/dist/config/agents/direct.yaml

@@ -14,8 +14,7 @@ spec:
     # This matches the workspace default and keeps the default config shape explicit.
     runRoot: ./.agent
     # agent-harness feature: workspace-level durable long-term memory defaults for this host profile.
-    runtimeMemory:
-      ref: runtime-memory/default
+    runtimeMemory: default
   # =====================
   # Runtime Agent Features
   # =====================
@@ -39,12 +38,10 @@ spec:
   # Even the lightweight direct path can benefit from resumable state during interactive use.
   # Available `kind` options in this harness: `FileCheckpointer`, `MemorySaver`, `SqliteSaver`.
   # `path` is only used by `FileCheckpointer` and `SqliteSaver`; omit it for `MemorySaver`.
-  checkpointer:
-    ref: checkpointer/sqlite
+  checkpointer: sqlite
   # Upstream execution feature: LangGraph store available to middleware and runtime context hooks.
   # The default direct host keeps this enabled so middleware can use the same durable store surface as other hosts.
-  store:
-    ref: store/default
+  store: default
   # Upstream execution feature: no declarative HITL tool routing by default.
   interruptOn: {}
   # Upstream execution feature: filesystem middleware settings for LangChain v1 agents.

package/dist/config/agents/orchestra.yaml

@@ -14,8 +14,7 @@ spec:
     # This matches the workspace default and keeps the default config shape explicit.
     runRoot: ./.agent
     # agent-harness feature: workspace-level durable long-term memory defaults for this host profile.
-    runtimeMemory:
-      ref: runtime-memory/default
+    runtimeMemory: default
   # =====================
   # Runtime Agent Features
   # =====================
@@ -46,14 +45,12 @@ spec:
   # This persists resumable graph state for this agent.
   # Available `kind` options in this harness: `FileCheckpointer`, `MemorySaver`, `SqliteSaver`.
   # `path` is only used by `FileCheckpointer` and `SqliteSaver`; omit it for `MemorySaver`.
-  checkpointer:
-    ref: checkpointer/sqlite
+  checkpointer: sqlite
   # Upstream execution feature: store config passed into the selected backend adapter.
   # In the default deepagent adapter this is the LangGraph store used by `StoreBackend` routes.
   # Built-in kinds in this harness today: `FileStore`, `InMemoryStore`.
   # Other store kinds should flow through a custom runtime resolver instead of being claimed as built in.
-  store:
-    ref: store/default
+  store: default
   # Upstream execution feature: backend config passed into the selected backend adapter.
   # Prefer a reusable backend preset via `ref` so backend topology stays declarative and reusable in YAML.
   # The default preset keeps DeepAgent execution semantics upstream-owned:
@@ -78,8 +75,7 @@ spec:
   config:
     # Upstream execution feature: backend config passed into the selected backend adapter.
     # Keep this nested under `config` because `backend` already selects the adapter mode.
-    backend:
-      ref: backend/default
+    backend: default
   # Upstream execution feature: system prompt for the orchestration host.
   # This becomes the top-level instruction block for the selected execution backend and should hold the
   # agent's durable role, priorities, and behavioral guardrails rather than bulky project facts.

package/dist/config/catalogs/tools.yaml

@@ -1,5 +1,5 @@
 # agent-harness feature: schema version for reusable tool objects.
 apiVersion: agent-harness/v1alpha1
 # agent-harness feature: object type for named reusable tool presets.
-kind: Tools
+kind: ToolSets
 spec: []

package/dist/init-project.js

@@ -171,15 +171,14 @@ spec:
 function renderToolsYaml(options) {
     if (!options.withWebSearch) {
         return `apiVersion: agent-harness/v1alpha1
-kind: Tools
+kind: ToolSets
 spec: []
 `;
     }
     return `apiVersion: agent-harness/v1alpha1
-kind: Tools
+kind: ToolSets
 spec:
-  - kind: Tool
-    name: web-search
+  - name: web-search
     type: provider
     description: ${options.provider} web search tool for current research.
     providerTool:
@@ -191,7 +190,7 @@ spec:
 }
 function renderResearchAgentYaml(options) {
     const toolsBlock = options.withWebSearch ? "  tools:\n    - web-search\n" : "  tools: []\n";
-    const subagentsBlock = options.template === "deep-research" ? "  subagents:\n    - ref: agent/research-analyst\n" : "  subagents: []\n";
+    const subagentsBlock = options.template === "deep-research" ? "  subagents:\n    - research-analyst\n" : "  subagents: []\n";
     const prompt = options.withWebSearch
         ? "Break complex research requests into a clear plan, use web search when current information matters, and return a concise synthesis with sources and explicit uncertainty."
         : "Break complex research requests into a clear plan and return a concise synthesis with explicit assumptions and uncertainty.";
@@ -205,15 +204,13 @@ metadata:
   description: Host-facing research agent for investigating and synthesizing answers.
 spec:
   runtime:
-    runtimeMemory:
-      ref: runtime-memory/default
+    runtimeMemory: default
   backend: deepagent
   modelRef: model/default
 ${toolsBlock}  skills:
     - deep-research
 ${subagentsBlock}  config:
-    backend:
-      ref: backend/default
+    backend: default
   systemPrompt: ${prompt}${delegationLine}
 `;
 }
@@ -229,15 +226,13 @@ metadata:
   description: Analyst subagent for source gathering, comparison, and evidence extraction.
 spec:
   runtime:
-    runtimeMemory:
-      ref: runtime-memory/default
+    runtimeMemory: default
   backend: deepagent
   modelRef: model/default
 ${toolsBlock}  skills:
     - deep-research
   config:
-    backend:
-      ref: backend/default
+    backend: default
   systemPrompt: ${prompt}
 `;
 }

package/dist/package-version.d.ts

@@ -1 +1 @@
-export declare const AGENT_HARNESS_VERSION = "0.0.135";
+export declare const AGENT_HARNESS_VERSION = "0.0.136";

package/dist/package-version.js

@@ -1 +1 @@
-export const AGENT_HARNESS_VERSION = "0.0.135";
+export const AGENT_HARNESS_VERSION = "0.0.136";

package/dist/workspace/agent-binding-compiler.js

@@ -131,7 +131,15 @@ function applyToolBindingOverrides(tool, binding) {
         ...(typeof overrides.description === "string" ? { description: overrides.description } : {}),
         ...(typeof overrides.implementationName === "string" ? { implementationName: overrides.implementationName } : {}),
         ...(typeof overrides.inputSchemaRef === "string" ? { inputSchemaRef: overrides.inputSchemaRef } : {}),
-        ...(typeof overrides.embeddingModelRef === "string" ? { embeddingModelRef: overrides.embeddingModelRef } : {}),
+        ...(typeof overrides.embeddingModelRef === "string"
+            ? { embeddingModelRef: overrides.embeddingModelRef }
+            : typeof overrides.embeddingModel === "string"
+                ? {
+                    embeddingModelRef: overrides.embeddingModel.startsWith("embedding-model/")
+                        ? overrides.embeddingModel
+                        : `embedding-model/${overrides.embeddingModel}`,
+                }
+                : {}),
         ...(typeof overrides.backendOperation === "string" ? { backendOperation: overrides.backendOperation } : {}),
         ...(typeof overrides.mcpRef === "string" ? { mcpRef: overrides.mcpRef } : {}),
         ...(typeof overrides.subprocess === "boolean" ? { subprocess: overrides.subprocess } : {}),

package/dist/workspace/compile.js

@@ -184,20 +184,21 @@ function validateToolNameConflicts(tools) {
 function resolveAgentSkillNames(agents, skillRegistry, skillCollectionRoots) {
     for (const agent of agents) {
         agent.skillPathRefs = agent.skillPathRefs.map((entry) => {
-            const registered = skillRegistry.get(entry);
+            const normalizedEntry = entry.startsWith("skill/") ? entry.slice("skill/".length) : entry;
+            const registered = skillRegistry.get(normalizedEntry);
             if (registered) {
                 return registered;
             }
-            if (path.isAbsolute(entry) || entry.includes("/") || entry.startsWith("builtin://")) {
+            if (path.isAbsolute(entry) || entry.startsWith("builtin://") || entry.startsWith("resource://")) {
                 return entry;
             }
             for (const skillsRoot of skillCollectionRoots) {
-                const candidate = path.join(skillsRoot, entry);
+                const candidate = path.join(skillsRoot, normalizedEntry);
                 if (existsSync(path.join(candidate, "SKILL.md"))) {
                     return candidate;
                 }
             }
-            return entry;
+            return normalizedEntry;
         });
     }
 }

package/dist/workspace/object-loader.js

@@ -93,12 +93,30 @@ function readRefArray(items) {
             : undefined)
         .filter((item) => Boolean(item));
 }
+function readPrefixedRefArray(items, prefix) {
+    return toArray(items)
+        .map((item) => {
+        if (typeof item === "string") {
+            const value = item.trim();
+            if (!value) {
+                return undefined;
+            }
+            return value.startsWith(`${prefix}/`) ? value : `${prefix}/${value}`;
+        }
+        if (typeof item === "object" && item && "ref" in item && typeof item.ref === "string") {
+            const value = String(item.ref).trim();
+            return value || undefined;
+        }
+        return undefined;
+    })
+        .filter((item) => Boolean(item));
+}
 function normalizeToolUsageOverrides(value) {
     const record = asMutableObject(value);
     if (!record) {
         return undefined;
     }
-    const directKeys = new Set(["config", "hitl", "retryable", "subprocess", "embeddingModelRef"]);
+    const directKeys = new Set(["config", "hitl", "retryable", "subprocess", "embeddingModel", "embeddingModelRef"]);
     const directOverrides = {};
     const configOverrides = {};
     for (const [key, entry] of Object.entries(record)) {
@@ -177,6 +195,20 @@ function readObjectArray(items) {
         .map((item) => ({ ...item }));
     return records.length > 0 ? records : undefined;
 }
+function readMcpServerArray(items) {
+    const records = toArray(items)
+        .map((item) => {
+        if (typeof item === "string" && item.trim()) {
+            return { ref: item.startsWith("mcp/") ? item : `mcp/${item.trim()}` };
+        }
+        if (typeof item === "object" && item !== null && !Array.isArray(item)) {
+            return { ...item };
+        }
+        return undefined;
+    })
+        .filter((item) => Boolean(item));
+    return records.length > 0 ? records : undefined;
+}
 function readCapabilities(value) {
     if (typeof value !== "object" || value === null || Array.isArray(value)) {
         return undefined;
@@ -285,10 +317,24 @@ function readRuntimeConfig(item) {
     return asMutableObject(item.runtime);
 }
 function readRuntimeMemoryConfig(item, runtime) {
+    if (typeof runtime?.runtimeMemory === "string" && runtime.runtimeMemory.trim()) {
+        return {
+            ref: runtime.runtimeMemory.startsWith("runtime-memory/")
+                ? runtime.runtimeMemory
+                : `runtime-memory/${runtime.runtimeMemory.trim()}`,
+        };
+    }
     if (typeof runtime?.runtimeMemory === "object" && runtime.runtimeMemory && !Array.isArray(runtime.runtimeMemory)) {
         return cloneConfigValue(runtime.runtimeMemory);
     }
     const legacyExecutionConfig = readExecutionAgentConfig(item);
+    if (typeof legacyExecutionConfig.runtimeMemory === "string" && legacyExecutionConfig.runtimeMemory.trim()) {
+        return {
+            ref: legacyExecutionConfig.runtimeMemory.startsWith("runtime-memory/")
+                ? legacyExecutionConfig.runtimeMemory
+                : `runtime-memory/${legacyExecutionConfig.runtimeMemory.trim()}`,
+        };
+    }
     if (typeof legacyExecutionConfig.runtimeMemory === "object" &&
         legacyExecutionConfig.runtimeMemory &&
         !Array.isArray(legacyExecutionConfig.runtimeMemory)) {
@@ -382,14 +428,27 @@ function readSharedAgentConfigFields(config, options = {}) {
 }
 function readSharedAgentConfig(config) {
     const middleware = readMiddlewareArray(config.middleware);
+    const backend = typeof config.backend === "string" && config.backend.trim()
+        ? { ref: config.backend.startsWith("backend/") ? config.backend : `backend/${config.backend.trim()}` }
+        : typeof config.backend === "object" && config.backend
+            ? config.backend
+            : undefined;
+    const checkpointer = typeof config.checkpointer === "string" && config.checkpointer.trim()
+        ? { ref: config.checkpointer.startsWith("checkpointer/") ? config.checkpointer : `checkpointer/${config.checkpointer.trim()}` }
+        : (typeof config.checkpointer === "object" && config.checkpointer) || typeof config.checkpointer === "boolean"
+            ? config.checkpointer
+            : undefined;
+    const store = typeof config.store === "string" && config.store.trim()
+        ? { ref: config.store.startsWith("store/") ? config.store : `store/${config.store.trim()}` }
+        : typeof config.store === "object" && config.store
+            ? config.store
+            : undefined;
     return {
         ...((typeof config.systemPrompt === "string" && config.systemPrompt)
             || (typeof config.systemPrompt === "object" && config.systemPrompt && !Array.isArray(config.systemPrompt))
             ? { systemPrompt: cloneConfigValue(config.systemPrompt) }
             : {}),
-        ...((typeof config.checkpointer === "object" && config.checkpointer) || typeof config.checkpointer === "boolean"
-            ? { checkpointer: config.checkpointer }
-            : {}),
+        ...(checkpointer !== undefined ? { checkpointer } : {}),
         ...(typeof config.interruptOn === "object" && config.interruptOn ? { interruptOn: config.interruptOn } : {}),
         ...(config.stateSchema !== undefined ? { stateSchema: config.stateSchema } : {}),
         ...(config.responseFormat !== undefined ? { responseFormat: config.responseFormat } : {}),
@@ -397,6 +456,8 @@ function readSharedAgentConfig(config) {
         ...(config.includeAgentName === "inline" ? { includeAgentName: "inline" } : {}),
         ...(config.version === "v1" || config.version === "v2" ? { version: config.version } : {}),
         ...(typeof config.filesystem === "object" && config.filesystem ? { filesystem: config.filesystem } : {}),
+        ...(backend ? { backend } : {}),
+        ...(store ? { store } : {}),
         ...(middleware ? { middleware } : {}),
     };
 }
@@ -406,7 +467,6 @@ function readAgentConfig(item, options = {}) {
     return {
         ...readSharedAgentConfig(config),
         ...readSharedAgentConfigFields(config, { includeDelegationControls: options.includeDelegationControls }),
-        ...(options.includeObjectBackend && typeof config.backend === "object" && config.backend ? { backend: config.backend } : {}),
         ...(passthrough ? { passthrough } : {}),
     };
 }
@@ -415,7 +475,9 @@ export function parseAgentItem(item, sourcePath) {
     const moduleRoot = moduleRootForSourcePath(sourcePath, "agents");
     const subagentRefs = readExecutionValue(normalizedItem, "subagents", readRefArray);
     const toolBindings = readExecutionValue(normalizedItem, "tools", readToolBindingArray);
-    const subagentPathRefs = readExecutionValue(normalizedItem, "subagents", readPathArray).map((entry) => resolveModuleRelativePath(entry, moduleRoot));
+    const subagentPathRefs = readExecutionValue(normalizedItem, "subagents", readPathArray)
+        .filter((entry) => path.isAbsolute(entry) || entry.startsWith("./") || entry.startsWith("../"))
+        .map((entry) => resolveModuleRelativePath(entry, moduleRoot));
     const executionMode = String(resolveExecutionBackend(normalizedItem) ?? "deepagent");
     const runtime = readRuntimeConfig(normalizedItem);
     return {
@@ -431,8 +493,8 @@ export function parseAgentItem(item, sourcePath) {
         toolRefs: toolBindings.map((binding) => binding.ref),
         toolBindings,
         inlineTools: undefined,
-        mcpServers: readExecutionValue(normalizedItem, "mcpServers", readObjectArray),
-        skillPathRefs: readExecutionValue(normalizedItem, "skills", readStringArray),
+        mcpServers: readExecutionValue(normalizedItem, "mcpServers", readMcpServerArray),
+        skillPathRefs: readExecutionValue(normalizedItem, "skills", (value) => readPrefixedRefArray(value, "skill")),
         memorySources: readExecutionValue(normalizedItem, "memory", readPathArray).map((entry) => resolveModuleRelativePath(entry, moduleRoot)),
         subagentRefs,
         subagentPathRefs,

package/dist/workspace/resource-compilers.js

@@ -220,7 +220,7 @@ export function parseToolObject(object) {
     const mcpServerConfig = mcp
         ? Object.fromEntries(Object.entries(mcp).filter(([key]) => key !== "ref" && key !== "serverRef" && key !== "tool"))
         : undefined;
-    const bundleRefs = asRefArray(value.refs ?? value.bundle);
+    const bundleRefs = asRefArray(value.tools ?? value.refs ?? value.bundle);
     const inferredType = typeof value.type === "string"
         ? value.type
         : bundleRefs.length > 0
@@ -252,9 +252,11 @@ export function parseToolObject(object) {
         inputSchemaRef: typeof asObject(value.inputSchema)?.ref === "string" ? String(asObject(value.inputSchema)?.ref) : undefined,
         embeddingModelRef: typeof value.embeddingModelRef === "string"
             ? value.embeddingModelRef
-            : typeof asObject(value.embeddingModel)?.ref === "string"
-                ? String(asObject(value.embeddingModel)?.ref)
-                : undefined,
+            : typeof value.embeddingModel === "string"
+                ? `embedding-model/${String(value.embeddingModel).trim()}`
+                : typeof asObject(value.embeddingModel)?.ref === "string"
+                    ? String(asObject(value.embeddingModel)?.ref)
+                    : undefined,
         backendOperation: typeof backend?.operation === "string"
             ? backend.operation
             : typeof value.operation === "string"

package/dist/workspace/yaml-object-reader.js

@@ -144,7 +144,7 @@ async function objectItemsFromDocument(document, sourcePath) {
                 ? normalizeCatalogSpec(document)
                 : catalogKind === "Backends"
                     ? normalizeCatalogSpec(document, { defaultKind: "Backend" })
-                    : catalogKind === "Tools"
+                    : catalogKind === "Tools" || catalogKind === "ToolSets"
                         ? normalizeCatalogSpec(document, { defaultKind: "Tool" })
                         : catalogKind === "McpServers"
                             ? normalizeCatalogSpec(document, { defaultKind: "McpServer" })

package/package.json

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