@botbotgo/agent-harness 0.0.43 → 0.0.45

package/README.md

@@ -15,7 +15,7 @@ What it provides:
 
 - a small runtime API centered on `createAgentHarness(...)`, `run(...)`, `subscribe(...)`, inspection methods, and `stop(...)`
 - YAML-defined runtime assembly for hosts, models, routing, recovery, concurrency, MCP, and maintenance policy
-- backend-adapted execution with current DeepAgents-first defaults and LangChain v1 compatibility
+- backend-adapted execution with a generic runtime contract and current LangChain v1 / DeepAgents adapters
 - local `resources/tools/` and `resources/skills/` loading
 - persisted runs, threads, approvals, events, and resumable checkpoints
 
@@ -35,6 +35,9 @@ your-workspace/
     agent-context.md
     workspace.yaml
     models.yaml
+    stores.yaml
+    tools.yaml
+    mcp.yaml
     agents/
       direct.yaml
       orchestra.yaml
@@ -204,12 +207,24 @@ Core workspace files:
 - `config/workspace.yaml`
 - `config/agent-context.md`
 - `config/models.yaml`
+- `config/embedding-models.yaml`
+- `config/vector-stores.yaml`
+- `config/stores.yaml`
+- `config/tools.yaml`
+- `config/mcp.yaml`
 - `config/agents/direct.yaml`
 - `config/agents/orchestra.yaml`
 - `resources/package.json`
 - `resources/tools/`
 - `resources/skills/`
 
+Use Kubernetes-style YAML:
+
+- collection files use `apiVersion`, plural `kind`, and `spec: []`
+- single-object files use `apiVersion`, singular `kind`, `metadata`, and `spec`
+
+Use distinct names for named objects such as models, stores, checkpointers, tools, and MCP servers.
+
 ### `config/workspace.yaml`
 
 Use this file for runtime-level policy:
@@ -233,6 +248,43 @@ Use this file for shared startup context loaded into agents at construction time
 
 Put stable project context here. Do not use it as mutable long-term memory.
 
+### `config/models.yaml`
+
+Use one file for multiple named models:
+
+```yaml
+apiVersion: agent-harness/v1alpha1
+kind: Models
+spec:
+  - name: default
+    provider: openai
+    model: gpt-4.1
+  - name: planner
+    provider: openai
+    model: gpt-4.1-mini
+```
+
+These load as `model/default` and `model/planner`.
+
+### `config/stores.yaml`
+
+Use one file for named persistence presets:
+
+```yaml
+apiVersion: agent-harness/v1alpha1
+kind: Stores
+spec:
+  - kind: Store
+    name: default
+    storeKind: FileStore
+    path: store.json
+  - kind: Checkpointer
+    name: default
+    checkpointerKind: MemorySaver
+```
+
+These load as `store/default` and `checkpointer/default`.
+
 ### `config/agents/*.yaml`
 
 Prefer the generic agent form and declare the current execution backend explicitly:

package/dist/config/agents/direct.yaml

@@ -15,17 +15,17 @@ spec:
   # =====================
   # Runtime Agent Features
   # =====================
-  # Shared LangChain v1 / DeepAgents feature: model ref for the underlying LLM used by the
-  # direct-response agent. This should point at a cheap, fast, general-purpose chat model,
-  # because `direct` is intended to be the low-latency path for simple requests.
+  # Upstream execution feature: model ref for the underlying LLM used by the direct-response agent.
+  # This should point at a cheap, fast, general-purpose chat model, because `direct` is intended
+  # to be the low-latency path for simple requests.
   modelRef: model/default
-  # Shared LangChain v1 / DeepAgents feature: checkpointer config passed into the runtime.
+  # Runtime execution feature: checkpointer config passed into the selected backend adapter.
   # 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:
-    kind: MemorySaver
-  # LangChainAgent aligned feature: system prompt for the lightweight direct-response host.
+    ref: checkpointer/default
+  # Upstream execution feature: system prompt for the lightweight direct-response host.
   # This prompt should keep the agent focused on:
   # - answering simple requests in one turn
   # - staying lightweight instead of planning or orchestrating

package/dist/config/agents/orchestra.yaml

@@ -4,7 +4,7 @@ apiVersion: agent-harness/v1alpha1
 # Prefer the generic `Agent` form and select the concrete execution backend under `spec.execution`.
 kind: Agent
 metadata:
-  # agent-harness feature: stable object id used for refs and default DeepAgents name inference.
+  # agent-harness feature: stable object id used for refs and runtime naming.
   name: orchestra
   # agent-harness feature: human-readable summary for inventory and UI.
   description: Default execution host. Answer directly when possible, use local tools and skills first, and delegate only when a specialist is a better fit. Not a reflex delegation-only planner.
@@ -15,17 +15,17 @@ spec:
   # =====================
   # Runtime Agent Features
   # =====================
-  # DeepAgents aligned feature: model ref for the underlying LLM used by `createDeepAgent(...)`.
+  # Upstream execution feature: model ref for the underlying LLM used by this execution host.
   modelRef: model/default
-  # Shared LangChain v1 / DeepAgents feature: checkpointer config passed into the upstream runtime.
+  # Runtime execution feature: checkpointer config passed into the selected backend adapter.
   # 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:
-    # kind: FileCheckpointer
-    kind: MemorySaver
+    # ref: checkpointer/sqlite
+    ref: checkpointer/default
   memory:
-    # DeepAgents aligned feature: bootstrap memory sources supplied to the deep agent at construction time.
+    # Upstream execution feature: bootstrap memory sources supplied to the selected backend at construction time.
     # These paths resolve relative to the workspace root unless they are already absolute.
     # Treat this as agent-owned startup context, not as a dynamic long-term memory sink:
     # - keep `systemPrompt` for stable role, boundaries, and hard behavioral rules
@@ -35,13 +35,12 @@ spec:
     # Updating these files changes future agent constructions, but they are still bootstrap inputs rather than
     # self-updating runtime memory.
     - path: config/agent-context.md
-  # DeepAgents aligned feature: store config passed into `createDeepAgent({ store })`.
-  # This is the LangGraph store used by `StoreBackend` routes inside the DeepAgents backend.
+  # 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.
   # Available `kind` options in this harness: `FileStore`, `InMemoryStore`, `RedisStore`, `PostgresStore`.
   store:
-    kind: FileStore
-    path: store.json
-  # DeepAgents aligned feature: backend config passed into `createDeepAgent({ backend })`.
+    ref: store/default
+  # Upstream execution feature: backend config passed into the selected backend adapter.
   # This directly defines the backend topology for this agent:
   # - workspace execution uses a lightweight VFS sandbox
   # - long-term memory under `/memories/*` uses `StoreBackend`
@@ -59,8 +58,8 @@ spec:
       /memories/:
         # Available route backend `kind` options today: `StoreBackend`.
         kind: StoreBackend
-  # DeepAgents aligned feature: system prompt for the orchestration deep agent.
-  # This becomes the top-level instruction block for the upstream DeepAgents runtime and should hold the
+  # 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.
   systemPrompt: |-
     You are the orchestra agent.

package/dist/config/embedding-models.yaml

@@ -0,0 +1,28 @@
+# agent-harness feature: schema version for this declarative config object.
+apiVersion: agent-harness/v1alpha1
+# agent-harness feature: object type for named embedding-model presets.
+kind: EmbeddingModels
+spec:
+  # agent-harness feature: named embedding model entry used by refs such as `embedding-model/default`.
+  - name: default
+    # ====================
+    # LangChain v1 Features
+    # ====================
+    # LangChain aligned feature: provider family or integration namespace for an embeddings implementation.
+    provider: ollama
+    # LangChain aligned feature: concrete embedding model identifier passed to the provider integration.
+    model: nomic-embed-text
+    # LangChain aligned feature: provider-specific initialization options for embeddings.
+    baseUrl: https://ollama-rtx-4070.easynet.world/
+
+    # ===================
+    # DeepAgents Features
+    # ===================
+    # DeepAgents does not define a separate embeddings abstraction. Embedding models are consumed indirectly
+    # by retrieval tools that a DeepAgent may call.
+
+    # ======================
+    # agent-harness Features
+    # ======================
+    # This object is packaged and referenced through retrieval-oriented workspace tools such as the RAG index builder
+    # and query tool, not through `agent.modelRef`.

package/dist/config/mcp.yaml

@@ -0,0 +1,5 @@
+# agent-harness feature: schema version for reusable MCP server objects.
+apiVersion: agent-harness/v1alpha1
+# agent-harness feature: object type for named reusable MCP server and MCP-backed tool presets.
+kind: McpServers
+spec: []

package/dist/config/models.yaml

@@ -4,26 +4,26 @@ apiVersion: agent-harness/v1alpha1
 kind: Models
 spec:
   - name: default
-    # ====================
-    # LangChain v1 Features
-    # ====================
-    # LangChain aligned feature: provider family or integration namespace.
-    # Common options in this harness today include:
-    # - `ollama`
-    # - `openai`
-    # - `openai-compatible`
-    # - `anthropic`
-    # - `google` / `google-genai` / `gemini`
-    # The runtime adapter uses this to select the concrete LangChain chat model implementation.
+  # ====================
+  # LangChain v1 Features
+  # ====================
+  # LangChain aligned feature: provider family or integration namespace.
+  # Common options in this harness today include:
+  # - `ollama`
+  # - `openai`
+  # - `openai-compatible`
+  # - `anthropic`
+  # - `google` / `google-genai` / `gemini`
+  # The runtime adapter uses this to select the concrete LangChain chat model implementation.
     provider: ollama
-    # LangChain aligned feature: concrete model identifier passed to the selected provider integration.
-    # Example values depend on `provider`, such as `gpt-oss:latest` for `ollama`.
+  # LangChain aligned feature: concrete model identifier passed to the selected provider integration.
+  # Example values depend on `provider`, such as `gpt-oss:latest` for `ollama`.
     model: gpt-oss:latest
-    # LangChain aligned feature: provider-specific initialization options.
-    # Write these fields directly on the model object.
-    # Common examples include `baseUrl`, `temperature`, and auth/client settings.
-    # `baseUrl` configures the Ollama-compatible endpoint used by the model client.
-    # For `openai-compatible`, `baseUrl` is normalized into the ChatOpenAI `configuration.baseURL` field.
+  # LangChain aligned feature: provider-specific initialization options.
+  # Write these fields directly on the model object.
+  # Common examples include `baseUrl`, `temperature`, and auth/client settings.
+  # `baseUrl` configures the Ollama-compatible endpoint used by the model client.
+  # For `openai-compatible`, `baseUrl` is normalized into the ChatOpenAI `configuration.baseURL` field.
     baseUrl: https://ollama-rtx-4070.easynet.world/
-    # LangChain aligned feature: provider/model initialization option controlling sampling temperature.
+  # LangChain aligned feature: provider/model initialization option controlling sampling temperature.
     temperature: 0.2

package/dist/config/stores.yaml

@@ -0,0 +1,17 @@
+# agent-harness feature: schema version for reusable persistence presets.
+apiVersion: agent-harness/v1alpha1
+# agent-harness feature: object type for named persistence presets.
+kind: Stores
+spec:
+  # agent-harness feature: reusable store preset for agent backends that need a durable key-value store.
+  - kind: Store
+    name: default
+    description: Default file-backed store preset for runtime-managed agent state.
+    storeKind: FileStore
+    path: store.json
+
+  # agent-harness feature: reusable checkpointer preset for resumable execution state.
+  - kind: Checkpointer
+    name: default
+    description: Default in-memory checkpointer preset for lightweight local development.
+    checkpointerKind: MemorySaver

package/dist/config/tools.yaml

@@ -0,0 +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
+spec: []

package/dist/config/vector-stores.yaml

@@ -0,0 +1,25 @@
+# agent-harness feature: schema version for this declarative config object.
+apiVersion: agent-harness/v1alpha1
+# agent-harness feature: object type for named vector-store presets.
+kind: VectorStores
+spec:
+  # agent-harness feature: named vector store entry used by refs such as `vector-store/default`.
+  - name: default
+    # ====================
+    # LangChain v1 Features
+    # ====================
+    # LangChain aligned feature: concrete vector store implementation.
+    # The built-in runtime currently supports `LibSQLVectorStore` for SQLite/libSQL-backed vector retrieval.
+    storeKind: LibSQLVectorStore
+    # LangChain aligned feature: libSQL connection URL.
+    # Local SQLite files use the `file:` prefix.
+    url: file:.agent/vector-store.db
+    # LangChain aligned feature: target table and embedding column.
+    table: rag_chunks
+    column: embedding
+
+    # ======================
+    # agent-harness Features
+    # ======================
+    # Retrieval tools use this to resolve their default embeddings when indexing or querying this vector store.
+    embeddingModelRef: embedding-model/default

package/dist/config/workspace.yaml

@@ -23,21 +23,22 @@ spec:
   runRoot: ./.agent
 
   # agent-harness feature: optional host-router prompt override used when the runtime chooses between
-  # top-level host agents such as a main DeepAgent host and an optional low-latency side host.
+  # top-level host agents such as a main execution host and an optional low-latency side host.
   # Use placeholders so the same prompt can survive host renames:
   # - {{primaryAgentId}}
   # - {{primaryDescription}}
   # - {{secondaryAgentId}}
   # - {{secondaryDescription}}
   routing:
-    # agent-harness feature: DeepAgents-first default host selected when no explicit routing rule matches.
-    # Best practice is to point this at the main DeepAgent entry host and treat lighter agents as explicit opt-in.
+    # agent-harness feature: default host selected when no explicit routing rule matches.
+    # Best practice is to point this at the main execution host and treat lighter agents as explicit opt-in.
     defaultAgentId: orchestra
     # agent-harness feature: optional model-driven host classification fallback.
     # Keep this disabled unless you specifically need host-level model selection.
     modelRouting: false
     # agent-harness feature: ordered host-routing rules evaluated before model-driven classification.
-    # These rules only choose which host profile starts the run; DeepAgents still owns planning, tools, and long-running execution.
+    # These rules only choose which host profile starts the run; the selected backend still owns
+    # planning, tools, and long-running execution behavior after routing picks a host.
     # The first matching rule wins. Use this when you want stable routing behavior in YAML instead of code.
     #
     # Supported match fields on each rule:

package/dist/extensions.js

@@ -1,6 +1,7 @@
 import path from "node:path";
 import { defaultResourceSkillsRoot } from "./resource/resource.js";
 import { isExternalSourceLocator, resolveExternalResourcePath } from "./resource/sources.js";
+import { hasAgentSystemPrompt } from "./workspace/support/agent-capabilities.js";
 const toolKindAdapters = new Map();
 const skillSourceResolvers = new Map();
 const skillInheritancePolicies = new Map();
@@ -231,9 +232,7 @@ registerSkillSourceResolver({
 registerSkillInheritancePolicy({
     kind: "default",
     apply({ agent, ownSkills, parentSkills }) {
-        const systemPrompt = agent.deepAgentConfig?.systemPrompt;
-        const hasSystemPrompt = typeof systemPrompt === "string" && systemPrompt.trim().length > 0;
-        if (hasSystemPrompt && agent.id.includes(".")) {
+        if (hasAgentSystemPrompt(agent) && agent.id.includes(".")) {
             return ownSkills;
         }
         return Array.from(new Set([...parentSkills, ...ownSkills]));

package/dist/package-version.d.ts

@@ -1 +1 @@
-export declare const AGENT_HARNESS_VERSION = "0.0.42";
+export declare const AGENT_HARNESS_VERSION = "0.0.44";

package/dist/package-version.js

@@ -1 +1 @@
-export const AGENT_HARNESS_VERSION = "0.0.42";
+export const AGENT_HARNESS_VERSION = "0.0.44";

package/dist/presentation.d.ts

@@ -1,4 +1,18 @@
 export declare function escapeHtml(value: string): string;
+/** CSS class for anchors that should open in the host app embedded browser (Wallee). */
+export declare const WALLEE_OUTPUT_LINK_CLASS = "wallee-output-link";
+/** `data-wallee-url` — target URL for the embedded browser (http/https only). */
+export declare const WALLEE_BROWSER_URL_ATTR = "data-wallee-url";
+export declare function isAllowedWalleeBrowserUrl(url: string): boolean;
+/**
+ * Escape plain text and wrap http(s) URLs in Wallee output anchors (open in host embedded browser).
+ */
+export declare function linkifyPlainTextForWalleeBrowser(text: string): string;
+/**
+ * Like {@link markdownToHtml} but inline http(s) URLs and markdown links `[label](https://…)` render as
+ * Wallee embedded-browser anchors (`wallee-output-link` + `data-wallee-url`).
+ */
+export declare function markdownToWalleeOutputHtml(markdown: string): string;
 export declare function markdownToHtml(markdown: string): string;
 export declare function markdownToConsole(markdown: string): string;
 export declare function renderTemplate(data: Record<string, unknown>, template: string): string;

package/dist/presentation.js

@@ -8,6 +8,152 @@ export function escapeHtml(value) {
         .replaceAll('"', """)
         .replaceAll("'", "'");
 }
+/** CSS class for anchors that should open in the host app embedded browser (Wallee). */
+export const WALLEE_OUTPUT_LINK_CLASS = "wallee-output-link";
+/** `data-wallee-url` — target URL for the embedded browser (http/https only). */
+export const WALLEE_BROWSER_URL_ATTR = "data-wallee-url";
+export function isAllowedWalleeBrowserUrl(url) {
+    try {
+        const u = new URL(url);
+        return u.protocol === "http:" || u.protocol === "https:";
+    }
+    catch {
+        return false;
+    }
+}
+function walleeOutputAnchor(url, labelEscaped) {
+    return `<a class="${WALLEE_OUTPUT_LINK_CLASS}" ${WALLEE_BROWSER_URL_ATTR}="${escapeHtml(url)}" href="#">${labelEscaped}</a>`;
+}
+/**
+ * Escape plain text and wrap http(s) URLs in Wallee output anchors (open in host embedded browser).
+ */
+export function linkifyPlainTextForWalleeBrowser(text) {
+    const urlRe = /\bhttps?:\/\/[^\s<>"']+/g;
+    const parts = [];
+    let last = 0;
+    let m;
+    while ((m = urlRe.exec(text)) !== null) {
+        parts.push(escapeHtml(text.slice(last, m.index)));
+        const raw = m[0];
+        const trimmed = raw.replace(/[.,;:!?)\]]+$/u, "");
+        const rest = raw.slice(trimmed.length);
+        if (isAllowedWalleeBrowserUrl(trimmed)) {
+            parts.push(walleeOutputAnchor(trimmed, escapeHtml(trimmed)));
+            if (rest) {
+                parts.push(escapeHtml(rest));
+            }
+        }
+        else {
+            parts.push(escapeHtml(raw));
+        }
+        last = m.index + raw.length;
+    }
+    parts.push(escapeHtml(text.slice(last)));
+    return parts.join("");
+}
+function applyBasicInlineMarkdown(escaped) {
+    return escaped
+        .replace(/\*\*(.+?)\*\*/g, "<strong>$1</strong>")
+        .replace(/\*(.+?)\*/g, "<em>$1</em>")
+        .replace(/`([^`]+)`/g, "<code>$1</code>");
+}
+function linkifyPlainTextSegmentWithWalleeMarkdown(text) {
+    const mdLinkPattern = /\[([^\]]*)\]\((https?:\/\/[^)\s]+)\)/g;
+    const segments = [];
+    let lastIndex = 0;
+    let m;
+    while ((m = mdLinkPattern.exec(text)) !== null) {
+        if (m.index > lastIndex) {
+            segments.push({ type: "text", text: text.slice(lastIndex, m.index) });
+        }
+        segments.push({ type: "mdlink", label: m[1], url: m[2] });
+        lastIndex = m.index + m[0].length;
+    }
+    if (lastIndex < text.length) {
+        segments.push({ type: "text", text: text.slice(lastIndex) });
+    }
+    if (segments.length === 0) {
+        segments.push({ type: "text", text });
+    }
+    return segments
+        .map((seg) => {
+        if (seg.type === "mdlink") {
+            if (!isAllowedWalleeBrowserUrl(seg.url)) {
+                return `${escapeHtml(seg.label)} (${escapeHtml(seg.url)})`;
+            }
+            return walleeOutputAnchor(seg.url, escapeHtml(seg.label));
+        }
+        return linkifyBareUrlsWithInlineMarkdown(seg.text);
+    })
+        .join("");
+}
+function linkifyBareUrlsWithInlineMarkdown(text) {
+    const urlRe = /\bhttps?:\/\/[^\s<>"']+/g;
+    const parts = [];
+    let last = 0;
+    let m;
+    while ((m = urlRe.exec(text)) !== null) {
+        parts.push(applyBasicInlineMarkdown(escapeHtml(text.slice(last, m.index))));
+        const raw = m[0];
+        const trimmed = raw.replace(/[.,;:!?)\]]+$/u, "");
+        const rest = raw.slice(trimmed.length);
+        if (isAllowedWalleeBrowserUrl(trimmed)) {
+            parts.push(walleeOutputAnchor(trimmed, escapeHtml(trimmed)));
+            if (rest) {
+                parts.push(applyBasicInlineMarkdown(escapeHtml(rest)));
+            }
+        }
+        else {
+            parts.push(applyBasicInlineMarkdown(escapeHtml(raw)));
+        }
+        last = m.index + raw.length;
+    }
+    parts.push(applyBasicInlineMarkdown(escapeHtml(text.slice(last))));
+    return parts.join("");
+}
+/**
+ * Like {@link markdownToHtml} but inline http(s) URLs and markdown links `[label](https://…)` render as
+ * Wallee embedded-browser anchors (`wallee-output-link` + `data-wallee-url`).
+ */
+export function markdownToWalleeOutputHtml(markdown) {
+    const normalized = markdown.replace(/\r\n/g, "\n");
+    const blocks = normalized.split(/\n\n+/);
+    const html = [];
+    for (const block of blocks) {
+        const trimmed = block.trim();
+        if (!trimmed) {
+            continue;
+        }
+        if (trimmed.startsWith("```") && trimmed.endsWith("```")) {
+            const lines = trimmed.split("\n");
+            const language = lines[0]?.slice(3).trim();
+            const code = lines.slice(1, -1).join("\n");
+            html.push(`<pre class="ah-code"><code${language ? ` data-language="${escapeHtml(language)}"` : ""}>${escapeHtml(code)}</code></pre>`);
+            continue;
+        }
+        if (/^#{1,6}\s/.test(trimmed)) {
+            const match = trimmed.match(/^(#{1,6})\s+(.*)$/);
+            const level = match?.[1].length ?? 1;
+            const content = linkifyPlainTextSegmentWithWalleeMarkdown(match?.[2] ?? trimmed);
+            html.push(`<h${level}>${content}</h${level}>`);
+            continue;
+        }
+        if (trimmed.split("\n").every((line) => /^[-*]\s+/.test(line))) {
+            const items = trimmed
+                .split("\n")
+                .map((line) => line.replace(/^[-*]\s+/, ""))
+                .map((line) => `<li>${linkifyPlainTextSegmentWithWalleeMarkdown(line)}</li>`)
+                .join("");
+            html.push(`<ul>${items}</ul>`);
+            continue;
+        }
+        html.push(`<p>${trimmed
+            .split("\n")
+            .map((line) => linkifyPlainTextSegmentWithWalleeMarkdown(line))
+            .join("<br />")}</p>`);
+    }
+    return html.join("");
+}
 function renderInlineMarkdown(text) {
     const escaped = escapeHtml(text);
     return escaped

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

@@ -3,7 +3,7 @@ import { getSkillInheritancePolicy, resolveToolTargets } from "../extensions.js"
 import { compileModel, compileTool } from "./resource-compilers.js";
 import { inferAgentCapabilities } from "./support/agent-capabilities.js";
 import { discoverSkillPaths } from "./support/discovery.js";
-import { compileAgentMemories, getRuntimeDefaults, resolvePromptValue, resolveRefId } from "./support/workspace-ref-utils.js";
+import { compileAgentMemories, getRuntimeDefaults, getWorkspaceObject, resolvePromptValue, resolveRefId } from "./support/workspace-ref-utils.js";
 const WORKSPACE_BOUNDARY_GUIDANCE = "Keep repository and file exploration bounded to the current workspace root unless the user explicitly asks for broader host or filesystem access. " +
     "Do not inspect absolute paths outside the workspace, system directories, or unrelated repos by default. " +
     "Prefer workspace-local tools, relative paths, and the current repository checkout when analyzing code.";
@@ -133,15 +133,50 @@ function resolveBackendConfig(agent) {
         : undefined;
     return backendConfig ? { config: backendConfig } : undefined;
 }
-function resolveStoreConfig(agent) {
+function isRefConfig(value) {
+    if (typeof value?.ref !== "string" || value.ref.trim().length === 0) {
+        return false;
+    }
+    return Object.keys(value).every((key) => key === "ref");
+}
+function materializeWorkspaceObjectConfig(refs, ref, allowedKinds, ownerLabel) {
+    const object = getWorkspaceObject(refs, ref);
+    if (!object) {
+        throw new Error(`${ownerLabel} references missing object ${ref}`);
+    }
+    if (!allowedKinds.includes(object.kind)) {
+        throw new Error(`${ownerLabel} references ${ref}, but expected one of: ${allowedKinds.join(", ")}`);
+    }
+    const { id: _id, kind: _kind, ...config } = object.value;
+    if (object.kind === "store") {
+        const storeKind = typeof config.storeKind === "string" ? config.storeKind : undefined;
+        const { storeKind: _storeKind, ...rest } = config;
+        return storeKind ? { kind: storeKind, ...rest } : config;
+    }
+    if (object.kind === "checkpointer" || object.kind === "file-checkpointer" || object.kind === "sqlite-saver") {
+        const checkpointerKind = typeof config.checkpointerKind === "string" ? config.checkpointerKind : undefined;
+        const { checkpointerKind: _checkpointerKind, ...rest } = config;
+        return checkpointerKind ? { kind: checkpointerKind, ...rest } : config;
+    }
+    return config;
+}
+function resolveStoreConfig(agent, refs) {
     const inlineStore = typeof agent.deepAgentConfig?.store === "object" && agent.deepAgentConfig.store
         ? agent.deepAgentConfig.store
         : typeof agent.langchainAgentConfig?.store === "object" && agent.langchainAgentConfig.store
             ? agent.langchainAgentConfig.store
             : undefined;
-    return inlineStore ? { config: inlineStore } : undefined;
+    if (!inlineStore) {
+        return undefined;
+    }
+    if (isRefConfig(inlineStore)) {
+        return {
+            config: materializeWorkspaceObjectConfig(refs, inlineStore.ref, ["store"], `Agent ${agent.id} store`),
+        };
+    }
+    return { config: inlineStore };
 }
-function resolveCheckpointerConfig(agent) {
+function resolveCheckpointerConfig(agent, refs) {
     const inlineAgentCheckpointer = typeof agent.deepAgentConfig?.checkpointer === "object" && agent.deepAgentConfig.checkpointer
         ? agent.deepAgentConfig.checkpointer
         : typeof agent.deepAgentConfig?.checkpointer === "boolean"
@@ -151,7 +186,18 @@ function resolveCheckpointerConfig(agent) {
                 : typeof agent.langchainAgentConfig?.checkpointer === "boolean"
                     ? agent.langchainAgentConfig.checkpointer
                     : undefined;
-    return inlineAgentCheckpointer !== undefined ? { config: inlineAgentCheckpointer } : undefined;
+    if (inlineAgentCheckpointer === undefined) {
+        return undefined;
+    }
+    if (typeof inlineAgentCheckpointer === "boolean") {
+        return { config: inlineAgentCheckpointer };
+    }
+    if (isRefConfig(inlineAgentCheckpointer)) {
+        return {
+            config: materializeWorkspaceObjectConfig(refs, inlineAgentCheckpointer.ref, ["checkpointer", "file-checkpointer", "sqlite-saver"], `Agent ${agent.id} checkpointer`),
+        };
+    }
+    return { config: inlineAgentCheckpointer };
 }
 export function compileBinding(workspaceRoot, agent, agents, referencedSubagentIds, refs, models, tools) {
     const internalSubagent = referencedSubagentIds.has(agent.id);
@@ -160,8 +206,8 @@ export function compileBinding(workspaceRoot, agent, agents, referencedSubagentI
     const compiledAgentMemory = compileAgentMemories(workspaceRoot, agent.memorySources);
     const compiledAgentModel = requireModel(models, agent.modelRef || (internalSubagent ? "model/default" : ""), agent.id);
     const backend = resolveBackendConfig(agent);
-    const store = resolveStoreConfig(agent);
-    const checkpointer = resolveCheckpointerConfig(agent);
+    const store = resolveStoreConfig(agent, refs);
+    const checkpointer = resolveCheckpointerConfig(agent, refs);
     const runRoot = typeof agent.runRoot === "string" && agent.runRoot.trim().length > 0
         ? path.resolve(workspaceRoot, agent.runRoot)
         : typeof runtimeDefaults?.runRoot === "string" && runtimeDefaults.runRoot.trim().length > 0

package/dist/workspace/object-loader.js

@@ -61,7 +61,7 @@ function toArray(value) {
 function asObject(value) {
     return typeof value === "object" && value ? value : undefined;
 }
-function normalizeNamedResourceSpec(document, kind) {
+function normalizeCatalogSpec(document, options = {}) {
     const typed = asObject(document);
     const spec = typed?.spec;
     if (!Array.isArray(spec)) {
@@ -75,12 +75,15 @@ function normalizeNamedResourceSpec(document, kind) {
             : typeof item.name === "string" && item.name.trim()
                 ? item.name
                 : undefined;
-        if (!id) {
+        const itemKind = typeof item.kind === "string" && item.kind.trim()
+            ? item.kind
+            : options.defaultKind;
+        if (!id || !itemKind) {
             return null;
         }
         return {
             ...item,
-            kind,
+            kind: itemKind,
             id,
         };
     });
@@ -305,6 +308,21 @@ async function objectItemsFromDocument(document, sourcePath) {
     if (typeof document !== "object" || !document) {
         return [];
     }
+    const catalogKind = typeof document.kind === "string"
+        ? String(document.kind)
+        : undefined;
+    const catalogItems = catalogKind === "Models"
+        ? normalizeCatalogSpec(document, { defaultKind: "Model" })
+        : catalogKind === "Stores"
+            ? normalizeCatalogSpec(document)
+            : catalogKind === "Tools"
+                ? normalizeCatalogSpec(document, { defaultKind: "Tool" })
+                : catalogKind === "McpServers"
+                    ? normalizeCatalogSpec(document)
+                    : [];
+    if (catalogItems.length > 0) {
+        return catalogItems;
+    }
     const items = document.items;
     if (Array.isArray(items)) {
         const records = [];
@@ -497,9 +515,11 @@ async function readNamedModelItems(root) {
         }
         const parsedDocuments = parseAllDocuments(await readYamlOrJson(filePath));
         for (const parsedDocument of parsedDocuments) {
-            const items = normalizeNamedResourceSpec(parsedDocument.toJSON(), "model");
-            for (const item of items) {
-                records.push({ item: normalizeYamlItem(item), sourcePath: filePath });
+            for (const item of await objectItemsFromDocument(parsedDocument.toJSON(), filePath)) {
+                const normalized = normalizeYamlItem(item);
+                if (normalized.kind === "model" && typeof normalized.id === "string" && normalized.id.trim()) {
+                    records.push({ item: normalized, sourcePath: filePath });
+                }
             }
         }
     }

package/dist/workspace/support/agent-capabilities.d.ts

@@ -5,3 +5,5 @@ export declare function isDelegationCapableAgent(agent: ParsedAgentObject): bool
 export declare function isMemoryCapableAgent(agent: ParsedAgentObject): boolean;
 export declare function isDelegationCapableBinding(binding: CompiledAgentBinding): boolean;
 export declare function isMemoryCapableBinding(binding: CompiledAgentBinding): boolean;
+export declare function getAgentSystemPrompt(agent: ParsedAgentObject): string | undefined;
+export declare function hasAgentSystemPrompt(agent: ParsedAgentObject): boolean;

package/dist/workspace/support/agent-capabilities.js

@@ -28,3 +28,14 @@ export function isDelegationCapableBinding(binding) {
 export function isMemoryCapableBinding(binding) {
     return inferBindingCapabilities(binding).memory === true;
 }
+export function getAgentSystemPrompt(agent) {
+    const deepagentPrompt = typeof agent.deepAgentConfig?.systemPrompt === "string" ? agent.deepAgentConfig.systemPrompt.trim() : "";
+    if (deepagentPrompt) {
+        return deepagentPrompt;
+    }
+    const langchainPrompt = typeof agent.langchainAgentConfig?.systemPrompt === "string" ? agent.langchainAgentConfig.systemPrompt.trim() : "";
+    return langchainPrompt || undefined;
+}
+export function hasAgentSystemPrompt(agent) {
+    return typeof getAgentSystemPrompt(agent) === "string";
+}

package/dist/workspace/validate.js

@@ -1,8 +1,5 @@
-import { isDelegationCapableAgent, isMemoryCapableAgent } from "./support/agent-capabilities.js";
+import { hasAgentSystemPrompt, isDelegationCapableAgent, isMemoryCapableAgent, } from "./support/agent-capabilities.js";
 const allowedExecutionModes = new Set(["deepagent", "langchain-v1"]);
-function hasPromptContent(value) {
-    return typeof value === "string" && value.trim().length > 0;
-}
 function validateCheckpointerConfig(agent) {
     const checkpointer = (typeof agent.deepAgentConfig?.checkpointer === "object" && agent.deepAgentConfig.checkpointer) ||
         (typeof agent.deepAgentConfig?.checkpointer === "boolean" ? agent.deepAgentConfig.checkpointer : undefined) ||
@@ -87,8 +84,8 @@ export function validateTopology(agents) {
         if (!isDelegationCapableAgent(agent)) {
             throw new Error(`Subagent ${agent.id} must use a delegation-capable backend`);
         }
-        if (!hasPromptContent(agent.deepAgentConfig?.systemPrompt)) {
-            throw new Error(`Subagent ${agent.id} requires deepagent.systemPrompt`);
+        if (!hasAgentSystemPrompt(agent)) {
+            throw new Error(`Subagent ${agent.id} requires systemPrompt`);
         }
     }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@botbotgo/agent-harness",
-  "version": "0.0.43",
+  "version": "0.0.45",
   "description": "Workspace runtime for multi-agent applications",
   "type": "module",
   "packageManager": "npm@10.9.2",
@@ -26,6 +26,11 @@
       "types": "./dist/tools.d.ts",
       "import": "./dist/tools.js",
       "default": "./dist/tools.js"
+    },
+    "./presentation": {
+      "types": "./dist/presentation.d.ts",
+      "import": "./dist/presentation.js",
+      "default": "./dist/presentation.js"
     }
   },
   "dependencies": {
@@ -50,8 +55,9 @@
   "scripts": {
     "build": "rm -rf dist tsconfig.tsbuildinfo && tsc -p tsconfig.json && cp -R config dist/",
     "check": "tsc -p tsconfig.json --noEmit",
-    "test": "vitest run test/public-api.test.ts test/resource-optional-provider.test.ts test/resource-isolation.test.ts test/stock-research-app-load-harness.test.ts test/stock-research-app-run.test.ts test/release-workflow.test.ts test/release-version.test.ts test/gitignore.test.ts test/package-lock.test.ts test/readme.test.ts test/runtime-adapter-regressions.test.ts test/runtime-recovery.test.ts test/tool-extension-gaps.test.ts test/checkpoint-maintenance.test.ts test/llamaindex-dependency-compat.test.ts test/skill-standard.test.ts test/routing-config.test.ts test/workspace-compat-regressions.test.ts test/upstream-compat-regressions.test.ts",
+    "test": "vitest run test/public-api.test.ts test/resource-optional-provider.test.ts test/resource-isolation.test.ts test/stock-research-app-load-harness.test.ts test/stock-research-app-run.test.ts test/release-workflow.test.ts test/release-version.test.ts test/gitignore.test.ts test/package-lock.test.ts test/readme.test.ts test/runtime-adapter-regressions.test.ts test/runtime-recovery.test.ts test/tool-extension-gaps.test.ts test/checkpoint-maintenance.test.ts test/llamaindex-dependency-compat.test.ts test/skill-standard.test.ts test/routing-config.test.ts test/workspace-compat-regressions.test.ts test/upstream-compat-regressions.test.ts test/embedded-browser-bookmarks.test.ts test/presentation-wallee.test.ts",
     "test:real-providers": "vitest run test/real-provider-harness.test.ts",
+    "test:integration": "npm run build && node scripts/integration-wallee-browser.mjs",
     "release:prepare": "npm version patch --no-git-tag-version && node ./scripts/sync-example-version.mjs",
     "release:pack": "npm pack --dry-run",
     "release:publish": "npm publish --access public --registry https://registry.npmjs.org/"

package/dist/config/embedding-model.yaml

@@ -1,29 +0,0 @@
-# agent-harness feature: schema version for this declarative config object.
-apiVersion: agent-harness/v1alpha1
-# agent-harness feature: object type for a named embedding-model preset.
-kind: EmbeddingModel
-metadata:
-  # agent-harness feature: stable embedding model object id used by refs such as `embedding-model/default`.
-  name: default
-spec:
-  # ====================
-  # LangChain v1 Features
-  # ====================
-  # LangChain aligned feature: provider family or integration namespace for an embeddings implementation.
-  provider: ollama
-  # LangChain aligned feature: concrete embedding model identifier passed to the provider integration.
-  model: nomic-embed-text
-  # LangChain aligned feature: provider-specific initialization options for embeddings.
-  baseUrl: https://ollama-rtx-4070.easynet.world/
-
-  # ===================
-  # DeepAgents Features
-  # ===================
-  # DeepAgents does not define a separate embeddings abstraction. Embedding models are consumed indirectly
-  # by retrieval tools that a DeepAgent may call.
-
-  # ======================
-  # agent-harness Features
-  # ======================
-  # This object is packaged and referenced through retrieval-oriented workspace tools such as the RAG index builder
-  # and query tool, not through `agent.modelRef`.

package/dist/config/vector-store.yaml

@@ -1,26 +0,0 @@
-# agent-harness feature: schema version for this declarative config object.
-apiVersion: agent-harness/v1alpha1
-# agent-harness feature: object type for a named vector-store preset.
-kind: VectorStore
-metadata:
-  # agent-harness feature: stable vector store object id used by refs such as `vector-store/default`.
-  name: default
-spec:
-  # ====================
-  # LangChain v1 Features
-  # ====================
-  # LangChain aligned feature: concrete vector store implementation.
-  # The built-in runtime currently supports `LibSQLVectorStore` for SQLite/libSQL-backed vector retrieval.
-  storeKind: LibSQLVectorStore
-  # LangChain aligned feature: libSQL connection URL.
-  # Local SQLite files use the `file:` prefix.
-  url: file:.agent/vector-store.db
-  # LangChain aligned feature: target table and embedding column.
-  table: rag_chunks
-  column: embedding
-
-  # ======================
-  # agent-harness Features
-  # ======================
-  # Retrieval tools use this to resolve their default embeddings when indexing or querying this vector store.
-  embeddingModelRef: embedding-model/default