@botbotgo/agent-harness 0.0.44 → 0.0.45

package/README.md

@@ -207,6 +207,8 @@ 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`
@@ -216,6 +218,13 @@ Core workspace files:
 - `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:
@@ -239,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/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

@@ -1,20 +1,5 @@
 # agent-harness feature: schema version for reusable MCP server objects.
 apiVersion: agent-harness/v1alpha1
-# This first-layer catalog is the default place to register reusable McpServer objects and MCP-backed Tool objects.
-# Examples:
-# items:
-#   - kind: McpServer
-#     metadata:
-#       name: browser
-#     spec:
-#       command: node
-#       args: ["./mcp-browser-server.mjs"]
-#
-#   - kind: Tool
-#     metadata:
-#       name: browser_navigate
-#     spec:
-#       mcp:
-#         serverRef: mcp/browser
-#         tool: navigate
-items: []
+# 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

@@ -1,19 +1,17 @@
 # agent-harness feature: schema version for reusable persistence presets.
 apiVersion: agent-harness/v1alpha1
-items:
+# 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
-    metadata:
-      name: default
-      description: Default file-backed store preset for runtime-managed agent state.
-    spec:
-      storeKind: FileStore
-      path: store.json
+    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
-    metadata:
-      name: default
-      description: Default in-memory checkpointer preset for lightweight local development.
-    spec:
-      checkpointerKind: MemorySaver
+    name: default
+    description: Default in-memory checkpointer preset for lightweight local development.
+    checkpointerKind: MemorySaver

package/dist/config/tools.yaml

@@ -1,13 +1,5 @@
 # agent-harness feature: schema version for reusable tool objects.
 apiVersion: agent-harness/v1alpha1
-# This first-layer catalog is the default place to register reusable Tool objects that agents can reference.
-# Examples:
-# items:
-#   - kind: Tool
-#     metadata:
-#       name: repo_search
-#       description: Workspace-local repo search tool.
-#     spec:
-#       backend:
-#         operation: repo_search
-items: []
+# 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/package-version.d.ts

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

package/dist/package-version.js

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

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,15 +515,7 @@ async function readNamedModelItems(root) {
         }
         const parsedDocuments = parseAllDocuments(await readYamlOrJson(filePath));
         for (const parsedDocument of parsedDocuments) {
-            const document = parsedDocument.toJSON();
-            const catalogItems = normalizeNamedResourceSpec(document, "model");
-            if (catalogItems.length > 0) {
-                for (const item of catalogItems) {
-                    records.push({ item: normalizeYamlItem(item), sourcePath: filePath });
-                }
-                continue;
-            }
-            for (const item of await objectItemsFromDocument(document, 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/package.json

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

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