@botbotgo/agent-harness 0.0.474 → 0.0.476

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

@@ -1,285 +1 @@
-import path from "node:path";
-import { existsSync, readFileSync } from "node:fs";
-import { readdir } from "node:fs/promises";
-import { parseAllDocuments } from "yaml";
-import { fileExists, listFilesRecursive, readYamlOrJson } from "../utils/fs.js";
-const ENV_PLACEHOLDER_PATTERN = /\$\{env:([A-Za-z_][A-Za-z0-9_]*)(?::-(.*?))?\}/g;
-const DOTENV_LINE_PATTERN = /^\s*(?:export\s+)?([A-Za-z_][A-Za-z0-9_]*)\s*=\s*(.*)?\s*$/;
-function asObject(value) {
-    return typeof value === "object" && value ? value : undefined;
-}
-function stripMatchingQuotes(value) {
-    const trimmed = value.trim();
-    if (trimmed.length >= 2 &&
-        ((trimmed.startsWith("\"") && trimmed.endsWith("\"")) || (trimmed.startsWith("'") && trimmed.endsWith("'")))) {
-        return trimmed.slice(1, -1);
-    }
-    return trimmed;
-}
-function parseDotenvFile(content) {
-    const parsed = {};
-    for (const rawLine of content.split(/\r?\n/u)) {
-        const line = rawLine.trim();
-        if (!line || line.startsWith("#")) {
-            continue;
-        }
-        const match = DOTENV_LINE_PATTERN.exec(rawLine);
-        if (!match) {
-            continue;
-        }
-        const [, key, rawValue = ""] = match;
-        parsed[key] = stripMatchingQuotes(rawValue);
-    }
-    return parsed;
-}
-function readNearestDotenvSync(startDirectory) {
-    const normalizedStart = path.resolve(startDirectory);
-    let current = normalizedStart;
-    while (true) {
-        const dotenvPath = path.join(current, ".env");
-        if (existsSync(dotenvPath)) {
-            return Object.freeze(parseDotenvFile(readFileSync(dotenvPath, "utf8")));
-        }
-        const parent = path.dirname(current);
-        if (parent === current) {
-            break;
-        }
-        current = parent;
-    }
-    return Object.freeze({});
-}
-function resolveInterpolationEnv(sourcePath, envOverrides) {
-    const merged = { ...readNearestDotenvSync(path.dirname(sourcePath)) };
-    for (const [key, value] of Object.entries(process.env)) {
-        if (typeof value === "string") {
-            merged[key] = value;
-        }
-    }
-    if (envOverrides) {
-        for (const [key, value] of Object.entries(envOverrides)) {
-            if (typeof value === "string") {
-                merged[key] = value;
-            }
-            else {
-                delete merged[key];
-            }
-        }
-    }
-    return merged;
-}
-function interpolateEnvString(value, sourcePath, envValues) {
-    return value.replaceAll(ENV_PLACEHOLDER_PATTERN, (_match, envName, defaultValue) => {
-        const resolved = envValues[envName];
-        if (typeof resolved === "string" && resolved.length > 0) {
-            return resolved;
-        }
-        if (typeof defaultValue === "string") {
-            return defaultValue;
-        }
-        if (typeof resolved !== "string" || resolved.length === 0) {
-            throw new Error(`YAML document ${sourcePath} references missing environment variable ${envName}`);
-        }
-        return resolved;
-    });
-}
-export function interpolateEnvPlaceholders(value, sourcePath, envOverrides) {
-    const envValues = resolveInterpolationEnv(sourcePath, envOverrides);
-    return interpolateEnvPlaceholdersWithEnv(value, sourcePath, envValues);
-}
-function interpolateEnvPlaceholdersWithEnv(value, sourcePath, envValues) {
-    if (typeof value === "string") {
-        return interpolateEnvString(value, sourcePath, envValues);
-    }
-    if (Array.isArray(value)) {
-        return value.map((entry) => interpolateEnvPlaceholdersWithEnv(entry, sourcePath, envValues));
-    }
-    if (typeof value === "object" && value !== null) {
-        return Object.fromEntries(Object.entries(value).map(([key, entry]) => [
-            key,
-            interpolateEnvPlaceholdersWithEnv(entry, sourcePath, envValues),
-        ]));
-    }
-    return value;
-}
-function normalizeCatalogSpec(document, options = {}) {
-    const typed = asObject(document);
-    const spec = typed?.spec;
-    if (!Array.isArray(spec)) {
-        return [];
-    }
-    const normalized = spec
-        .filter((item) => typeof item === "object" && item !== null && !Array.isArray(item))
-        .map((item) => {
-        const id = typeof item.id === "string" && item.id.trim()
-            ? item.id
-            : typeof item.name === "string" && item.name.trim()
-                ? item.name
-                : undefined;
-        const itemKind = typeof item.kind === "string" && item.kind.trim()
-            ? item.kind
-            : options.defaultKind;
-        if (!id || !itemKind) {
-            return null;
-        }
-        return {
-            ...item,
-            kind: itemKind,
-            id,
-        };
-    });
-    return normalized.filter((item) => item !== null);
-}
-function normalizeKind(kind) {
-    switch (kind) {
-        case "Agent":
-            return "agent";
-        case "FileStore":
-            return "file-store";
-        case "SqliteStore":
-            return "sqlite-store";
-        case "InMemoryStore":
-            return "in-memory-store";
-        case "RedisStore":
-            return "redis-store";
-        case "PostgresStore":
-            return "postgres-store";
-        case "SqliteSaver":
-            return "sqlite-saver";
-        case "FileCheckpointer":
-            return "file-checkpointer";
-        case "Checkpointer":
-            return "checkpointer";
-        case "Model":
-            return "model";
-        case "EmbeddingModel":
-            return "embedding-model";
-        case "VectorStore":
-            return "vector-store";
-        case "ResponseFormat":
-            return "response-format";
-        case "Backend":
-            return "backend";
-        case "Store":
-            return "store";
-        case "Memory":
-            return "memory";
-        case "Tool":
-            return "tool";
-        case "Skill":
-            return "skill";
-        case "Runtime":
-            return "runtime";
-        case "RuntimeMemory":
-            return "runtime-memory";
-        case "ProceduralMemoryRuntime":
-            return "procedural-memory";
-        case "Prompt":
-            return "prompt";
-        case "McpServer":
-            return "mcp";
-        default:
-            return kind;
-    }
-}
-export function normalizeYamlItem(item) {
-    if (item.kind === "DeepAgent" || item.kind === "LangChainAgent") {
-        throw new Error(`YAML object kind ${String(item.kind)} is no longer supported; use kind: Agent with spec.backend instead`);
-    }
-    const metadata = asObject(item.metadata);
-    const spec = asObject(item.spec);
-    const kind = typeof item.kind === "string" ? normalizeKind(item.kind) : undefined;
-    const name = typeof metadata?.name === "string" ? metadata.name : undefined;
-    const description = typeof metadata?.description === "string" ? metadata.description : undefined;
-    if (!spec && !metadata) {
-        return kind ? { ...item, kind } : item;
-    }
-    if (!spec && metadata) {
-        return {
-            ...item,
-            ...(description ? { description } : {}),
-            ...(name ? { id: name } : {}),
-            ...(kind ? { kind } : {}),
-        };
-    }
-    return {
-        ...(spec ?? {}),
-        ...(description ? { description } : {}),
-        ...(name ? { id: name } : {}),
-        ...(kind ? { kind } : {}),
-    };
-}
-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 === "EmbeddingModels"
-            ? normalizeCatalogSpec(document, { defaultKind: "EmbeddingModel" })
-            : catalogKind === "VectorStores"
-                ? normalizeCatalogSpec(document, { defaultKind: "VectorStore" })
-                : catalogKind === "ResponseFormats"
-                    ? normalizeCatalogSpec(document, { defaultKind: "ResponseFormat" })
-                    : catalogKind === "Stores"
-                        ? normalizeCatalogSpec(document)
-                        : catalogKind === "Backends"
-                            ? normalizeCatalogSpec(document, { defaultKind: "Backend" })
-                            : catalogKind === "Tools" || catalogKind === "ToolSets"
-                                ? normalizeCatalogSpec(document, { defaultKind: "Tool" })
-                                : catalogKind === "McpServers"
-                                    ? normalizeCatalogSpec(document, { defaultKind: "McpServer" })
-                                    : [];
-    if (catalogItems.length > 0) {
-        return catalogItems;
-    }
-    if ("items" in document) {
-        throw new Error(`YAML document ${sourcePath} uses unsupported legacy items wrapper; use kind/spec catalog documents or metadata/spec objects instead`);
-    }
-    return [document];
-}
-export async function readYamlItems(root, relativeDir, options = {}) {
-    const targetRoot = relativeDir ? path.join(root, relativeDir) : root;
-    if (!(await fileExists(targetRoot))) {
-        return [];
-    }
-    const files = options.recursive
-        ? Array.from(new Set([
-            ...(await listFilesRecursive(targetRoot, ".yaml")),
-            ...(await listFilesRecursive(targetRoot, ".yml")),
-        ])).sort()
-        : (await readdir(targetRoot, { withFileTypes: true }))
-            .filter((entry) => entry.isFile() && /\.ya?ml$/i.test(entry.name))
-            .map((entry) => path.join(targetRoot, entry.name))
-            .sort();
-    const records = [];
-    for (const filePath of files) {
-        const parsedDocuments = parseAllDocuments(await readYamlOrJson(filePath));
-        for (const parsedDocument of parsedDocuments) {
-            const resolvedDocument = interpolateEnvPlaceholders(parsedDocument.toJSON(), filePath);
-            for (const item of await objectItemsFromDocument(resolvedDocument, filePath)) {
-                records.push({ item: normalizeYamlItem(item), sourcePath: filePath });
-            }
-        }
-    }
-    return records;
-}
-export async function readNamedYamlItems(root, filenames) {
-    const records = [];
-    for (const filename of filenames) {
-        const filePath = path.join(root, filename);
-        if (!(await fileExists(filePath))) {
-            continue;
-        }
-        const parsedDocuments = parseAllDocuments(await readYamlOrJson(filePath));
-        for (const parsedDocument of parsedDocuments) {
-            const resolvedDocument = interpolateEnvPlaceholders(parsedDocument.toJSON(), filePath);
-            for (const item of await objectItemsFromDocument(resolvedDocument, filePath)) {
-                records.push({ item: normalizeYamlItem(item), sourcePath: filePath });
-            }
-        }
-    }
-    return records;
-}
+import c from"node:path";import{existsSync as b,readFileSync as E}from"node:fs";import{readdir as j}from"node:fs/promises";import{parseAllDocuments as p}from"yaml";import{fileExists as m,listFilesRecursive as y,readYamlOrJson as g}from"../utils/fs.js";const M=/\$\{env:([A-Za-z_][A-Za-z0-9_]*)(?::-(.*?))?\}/g,v=/^\s*(?:export\s+)?([A-Za-z_][A-Za-z0-9_]*)\s*=\s*(.*)?\s*$/;function u(e){return typeof e=="object"&&e?e:void 0}function z(e){const r=e.trim();return r.length>=2&&(r.startsWith('"')&&r.endsWith('"')||r.startsWith("'")&&r.endsWith("'"))?r.slice(1,-1):r}function D(e){const r={};for(const t of e.split(/\r?\n/u)){const n=t.trim();if(!n||n.startsWith("#"))continue;const s=v.exec(t);if(!s)continue;const[,o,i=""]=s;r[o]=z(i)}return r}function R(e){let t=c.resolve(e);for(;;){const n=c.join(t,".env");if(b(n))return Object.freeze(D(E(n,"utf8")));const s=c.dirname(t);if(s===t)break;t=s}return Object.freeze({})}function F(e,r){const t={...R(c.dirname(e))};for(const[n,s]of Object.entries(process.env))typeof s=="string"&&(t[n]=s);if(r)for(const[n,s]of Object.entries(r))typeof s=="string"?t[n]=s:delete t[n];return t}function K(e,r,t){return e.replaceAll(M,(n,s,o)=>{const i=t[s];if(typeof i=="string"&&i.length>0)return i;if(typeof o=="string")return o;if(typeof i!="string"||i.length===0)throw new Error(`YAML document ${r} references missing environment variable ${s}`);return i})}function h(e,r,t){const n=F(r,t);return l(e,r,n)}function l(e,r,t){return typeof e=="string"?K(e,r,t):Array.isArray(e)?e.map(n=>l(n,r,t)):typeof e=="object"&&e!==null?Object.fromEntries(Object.entries(e).map(([n,s])=>[n,l(s,r,t)])):e}function a(e,r={}){const n=u(e)?.spec;return Array.isArray(n)?n.filter(o=>typeof o=="object"&&o!==null&&!Array.isArray(o)).map(o=>{const i=typeof o.id=="string"&&o.id.trim()?o.id:typeof o.name=="string"&&o.name.trim()?o.name:void 0,d=typeof o.kind=="string"&&o.kind.trim()?o.kind:r.defaultKind;return!i||!d?null:{...o,kind:d,id:i}}).filter(o=>o!==null):[]}function O(e){switch(e){case"Agent":return"agent";case"FileStore":return"file-store";case"SqliteStore":return"sqlite-store";case"InMemoryStore":return"in-memory-store";case"RedisStore":return"redis-store";case"PostgresStore":return"postgres-store";case"SqliteSaver":return"sqlite-saver";case"FileCheckpointer":return"file-checkpointer";case"Checkpointer":return"checkpointer";case"Model":return"model";case"EmbeddingModel":return"embedding-model";case"VectorStore":return"vector-store";case"ResponseFormat":return"response-format";case"Backend":return"backend";case"Store":return"store";case"Memory":return"memory";case"Tool":return"tool";case"Skill":return"skill";case"Runtime":return"runtime";case"RuntimeMemory":return"runtime-memory";case"ProceduralMemoryRuntime":return"procedural-memory";case"Prompt":return"prompt";case"McpServer":return"mcp";default:return e}}function S(e){if(e.kind==="DeepAgent"||e.kind==="LangChainAgent")throw new Error(`YAML object kind ${String(e.kind)} is no longer supported; use kind: Agent with spec.backend instead`);const r=u(e.metadata),t=u(e.spec),n=typeof e.kind=="string"?O(e.kind):void 0,s=typeof r?.name=="string"?r.name:void 0,o=typeof r?.description=="string"?r.description:void 0;return!t&&!r?n?{...e,kind:n}:e:!t&&r?{...e,...o?{description:o}:{},...s?{id:s}:{},...n?{kind:n}:{}}:{...t??{},...o?{description:o}:{},...s?{id:s}:{},...n?{kind:n}:{}}}async function k(e,r){if(typeof e!="object"||!e)return[];const t=typeof e.kind=="string"?String(e.kind):void 0,n=t==="Models"?a(e,{defaultKind:"Model"}):t==="EmbeddingModels"?a(e,{defaultKind:"EmbeddingModel"}):t==="VectorStores"?a(e,{defaultKind:"VectorStore"}):t==="ResponseFormats"?a(e,{defaultKind:"ResponseFormat"}):t==="Stores"?a(e):t==="Backends"?a(e,{defaultKind:"Backend"}):t==="Tools"||t==="ToolSets"?a(e,{defaultKind:"Tool"}):t==="McpServers"?a(e,{defaultKind:"McpServer"}):[];if(n.length>0)return n;if("items"in e)throw new Error(`YAML document ${r} uses unsupported legacy items wrapper; use kind/spec catalog documents or metadata/spec objects instead`);return[e]}async function L(e,r,t={}){const n=r?c.join(e,r):e;if(!await m(n))return[];const s=t.recursive?Array.from(new Set([...await y(n,".yaml"),...await y(n,".yml")])).sort():(await j(n,{withFileTypes:!0})).filter(i=>i.isFile()&&/\.ya?ml$/i.test(i.name)).map(i=>c.join(n,i.name)).sort(),o=[];for(const i of s){const d=p(await g(i));for(const f of d){const w=h(f.toJSON(),i);for(const A of await k(w,i))o.push({item:S(A),sourcePath:i})}}return o}async function N(e,r){const t=[];for(const n of r){const s=c.join(e,n);if(!await m(s))continue;const o=p(await g(s));for(const i of o){const d=h(i.toJSON(),s);for(const f of await k(d,s))t.push({item:S(f),sourcePath:s})}}return t}export{h as interpolateEnvPlaceholders,S as normalizeYamlItem,N as readNamedYamlItems,L as readYamlItems};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@botbotgo/agent-harness",
-  "version": "0.0.474",
+  "version": "0.0.476",
   "description": "Workspace runtime for multi-agent applications",
   "license": "MIT",
   "type": "module",
@@ -67,7 +67,7 @@
   "scripts": {
     "agent-harness": "npm run build --silent && node dist/cli.js",
     "chat": "npm run build --silent && node dist/cli.js chat",
-    "build": "rm -rf dist tsconfig.tsbuildinfo && tsc -p tsconfig.json && cp -R config resources dist/ && chmod +x dist/cli.js",
+    "build": "rm -rf dist tsconfig.tsbuildinfo && tsc -p tsconfig.json && cp -R config resources dist/ && node ./scripts/minify-dist-js.mjs && chmod +x dist/cli.js",
     "check": "tsc -p tsconfig.json --noEmit",
     "test": "vitest run $(find test -name '*.test.ts' -print | sort)",
     "test:ci:runtime": "node ./scripts/run-vitest-suite.mjs ci-runtime",
@@ -82,13 +82,17 @@
     "docs:sync-dev-nav": "node ./scripts/sync-developer-docs-nav.mjs",
     "docs:sync-release-notes": "node ./scripts/sync-release-notes-html.mjs",
     "docs:sync-docs-html": "node ./scripts/sync-release-notes-html.mjs && node ./scripts/sync-developer-docs-nav.mjs",
+    "prepublishOnly": "node ./scripts/npm-package-readme.mjs apply",
+    "postpack": "node ./scripts/npm-package-readme.mjs restore",
+    "postpublish": "node ./scripts/npm-package-readme.mjs restore",
     "release:prepare": "node ./scripts/prepare-release-version.mjs && node ./scripts/sync-example-version.mjs && node ./scripts/archive-release-notes.mjs && node ./scripts/sync-release-notes-html.mjs",
-    "release:pack": "npm pack --dry-run",
+    "release:pack": "node ./scripts/npm-package-readme.mjs apply && npm pack --dry-run",
     "release:publish": "npm publish --access public --registry https://registry.npmjs.org/"
   },
   "devDependencies": {
     "@langchain/community": "^1.1.27",
     "@types/node": "^25.6.0",
+    "esbuild": "^0.27.7",
     "typescript": "^6.0.2",
     "vite": "^8.0.10",
     "vitest": "^4.1.5"