@botbotgo/common 1.0.0

package/README.md

@@ -0,0 +1,54 @@
+# @botbotgo/common
+
+## Introduction
+
+`@botbotgo/common` is the shared base package for the BotBotGo agent repos. It owns process-level context, event bus primitives, common config helpers, and a small set of shared subpath APIs used by the other packages.
+
+## Exposed Interfaces
+
+| Export | Type | Purpose |
+| --- | --- | --- |
+| `createAgentContext` | root | Create an isolated agent context. |
+| `getDefaultAgentContext` | root | Access the process default context. |
+| `AgentContextTokens` | root | Stable tokens shared across repos. |
+| `createAgentEventBus` | root | Create the shared event bus. |
+| `createConsoleAgentEventListener` | root | Console event listener. |
+| `createProgressAgentEventListener` | root | Progress-oriented event listener. |
+| `@botbotgo/common/config` | subpath | Config and YAML helpers. |
+| `@botbotgo/common/cli` | subpath | CLI helpers. |
+| `@botbotgo/common/connectivity` | subpath | Connectivity helpers. |
+| `@botbotgo/common/context` | subpath | Context APIs. |
+| `@botbotgo/common/events` | subpath | Event APIs. |
+| `@botbotgo/common/npm` | subpath | npm helpers. |
+| `@botbotgo/common/security-store` | subpath | Secret storage helpers. |
+| `@botbotgo/common/testing` | subpath | Testing helpers. |
+| `@botbotgo/common/utils` | subpath | Shared utilities. |
+
+## Configuration
+
+This repo does not define one fixed YAML schema. It provides shared config helpers used by other repos.
+
+```ts
+import { loadYamlFile } from "@botbotgo/common/config";
+
+const config = await loadYamlFile("./config/app.yaml");
+```
+
+## Usage
+
+```bash
+npm i @botbotgo/common
+```
+
+```ts
+import {
+  createAgentContext,
+  createAgentEventBus,
+  AgentContextTokens,
+} from "@botbotgo/common";
+
+const ctx = createAgentContext();
+const bus = createAgentEventBus();
+
+ctx.set(AgentContextTokens.EventBus, bus);
+```

package/dist/chunk-DIIWJNRE.js

@@ -0,0 +1,51 @@
+// src/context/default-context.ts
+var DefaultAgentContext = class {
+  registry = /* @__PURE__ */ new Map();
+  set(token, value) {
+    this.registry.set(token, value);
+  }
+  get(token) {
+    if (!this.registry.has(token)) {
+      throw new Error(`AgentContext: token not registered: ${token.toString()}`);
+    }
+    return this.registry.get(token);
+  }
+  has(token) {
+    return this.registry.has(token);
+  }
+  tryGet(token) {
+    return this.registry.get(token);
+  }
+};
+var DEFAULT_CONTEXT_KEY = "__botbotgo_agent_default_context__";
+function getGlobalStore() {
+  return globalThis;
+}
+function createAgentContext() {
+  return new DefaultAgentContext();
+}
+function isAgentContext(value) {
+  return typeof value === "object" && value !== null && typeof value.get === "function" && typeof value.set === "function" && typeof value.has === "function";
+}
+function getDefaultAgentContext() {
+  const store = getGlobalStore();
+  const existing = store[DEFAULT_CONTEXT_KEY];
+  if (isAgentContext(existing)) return existing;
+  const created = createAgentContext();
+  store[DEFAULT_CONTEXT_KEY] = created;
+  return created;
+}
+function resetDefaultAgentContext() {
+  const store = getGlobalStore();
+  if (DEFAULT_CONTEXT_KEY in store) {
+    delete store[DEFAULT_CONTEXT_KEY];
+  }
+}
+
+export {
+  createAgentContext,
+  isAgentContext,
+  getDefaultAgentContext,
+  resetDefaultAgentContext
+};
+//# sourceMappingURL=chunk-DIIWJNRE.js.map

package/dist/chunk-DIIWJNRE.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/context/default-context.ts"],"sourcesContent":["export interface AgentContext {\n  set<T>(token: symbol, value: T): void;\n  get<T>(token: symbol): T;\n  has(token: symbol): boolean;\n  tryGet<T>(token: symbol): T | undefined;\n}\n\nclass DefaultAgentContext implements AgentContext {\n  private readonly registry = new Map<symbol, unknown>();\n\n  set<T>(token: symbol, value: T): void {\n    this.registry.set(token, value);\n  }\n\n  get<T>(token: symbol): T {\n    if (!this.registry.has(token)) {\n      throw new Error(`AgentContext: token not registered: ${token.toString()}`);\n    }\n    return this.registry.get(token) as T;\n  }\n\n  has(token: symbol): boolean {\n    return this.registry.has(token);\n  }\n\n  tryGet<T>(token: symbol): T | undefined {\n    return this.registry.get(token) as T | undefined;\n  }\n}\n\nconst DEFAULT_CONTEXT_KEY = \"__botbotgo_agent_default_context__\";\n\nfunction getGlobalStore(): Record<string, unknown> {\n  return globalThis as unknown as Record<string, unknown>;\n}\n\nexport function createAgentContext(): AgentContext {\n  return new DefaultAgentContext();\n}\n\nexport function isAgentContext(value: unknown): value is AgentContext {\n  return (\n    typeof value === \"object\"\n    && value !== null\n    && typeof (value as AgentContext).get === \"function\"\n    && typeof (value as AgentContext).set === \"function\"\n    && typeof (value as AgentContext).has === \"function\"\n  );\n}\n\nexport function getDefaultAgentContext(): AgentContext {\n  const store = getGlobalStore();\n  const existing = store[DEFAULT_CONTEXT_KEY];\n  if (isAgentContext(existing)) return existing;\n  const created = createAgentContext();\n  store[DEFAULT_CONTEXT_KEY] = created;\n  return created;\n}\n\nexport function resetDefaultAgentContext(): void {\n  const store = getGlobalStore();\n  if (DEFAULT_CONTEXT_KEY in store) {\n    delete store[DEFAULT_CONTEXT_KEY];\n  }\n}\n"],"mappings":";AAOA,IAAM,sBAAN,MAAkD;AAAA,EAC/B,WAAW,oBAAI,IAAqB;AAAA,EAErD,IAAO,OAAe,OAAgB;AACpC,SAAK,SAAS,IAAI,OAAO,KAAK;AAAA,EAChC;AAAA,EAEA,IAAO,OAAkB;AACvB,QAAI,CAAC,KAAK,SAAS,IAAI,KAAK,GAAG;AAC7B,YAAM,IAAI,MAAM,uCAAuC,MAAM,SAAS,CAAC,EAAE;AAAA,IAC3E;AACA,WAAO,KAAK,SAAS,IAAI,KAAK;AAAA,EAChC;AAAA,EAEA,IAAI,OAAwB;AAC1B,WAAO,KAAK,SAAS,IAAI,KAAK;AAAA,EAChC;AAAA,EAEA,OAAU,OAA8B;AACtC,WAAO,KAAK,SAAS,IAAI,KAAK;AAAA,EAChC;AACF;AAEA,IAAM,sBAAsB;AAE5B,SAAS,iBAA0C;AACjD,SAAO;AACT;AAEO,SAAS,qBAAmC;AACjD,SAAO,IAAI,oBAAoB;AACjC;AAEO,SAAS,eAAe,OAAuC;AACpE,SACE,OAAO,UAAU,YACd,UAAU,QACV,OAAQ,MAAuB,QAAQ,cACvC,OAAQ,MAAuB,QAAQ,cACvC,OAAQ,MAAuB,QAAQ;AAE9C;AAEO,SAAS,yBAAuC;AACrD,QAAM,QAAQ,eAAe;AAC7B,QAAM,WAAW,MAAM,mBAAmB;AAC1C,MAAI,eAAe,QAAQ,EAAG,QAAO;AACrC,QAAM,UAAU,mBAAmB;AACnC,QAAM,mBAAmB,IAAI;AAC7B,SAAO;AACT;AAEO,SAAS,2BAAiC;AAC/C,QAAM,QAAQ,eAAe;AAC7B,MAAI,uBAAuB,OAAO;AAChC,WAAO,MAAM,mBAAmB;AAAA,EAClC;AACF;","names":[]}

package/dist/chunk-H5BG6SXW.js

@@ -0,0 +1,33 @@
+import {
+  computeChecksum
+} from "./chunk-QG6CT2GZ.js";
+
+// src/context/tokens.ts
+function createChecksummedToken(scope, name) {
+  const seed = `${scope}:${name}`;
+  const checksum = computeChecksum(seed, { length: 12 });
+  return /* @__PURE__ */ Symbol.for(`${scope}.${name}.${checksum}`);
+}
+var AgentContextTokens = {
+  /** The shared AgentEventBus instance */
+  EventBus: createChecksummedToken("botbotgo.agent.context", "eventBus"),
+  /** The primary chat model (BaseChatModel) */
+  ChatModel: createChecksummedToken("botbotgo.agent.context", "chatModel"),
+  /** The embedding model (Embeddings) */
+  EmbedModel: createChecksummedToken("botbotgo.agent.context", "embedModel"),
+  /** The vision-language chat model (BaseChatModel) */
+  VlmModel: createChecksummedToken("botbotgo.agent.context", "vlmModel"),
+  /** The memory client (AgentMemory) */
+  Memory: createChecksummedToken("botbotgo.agent.context", "memory"),
+  /** The initialized tool list */
+  Tools: createChecksummedToken("botbotgo.agent.context", "tools"),
+  /** The loaded skill set (SkillSet | undefined) */
+  SkillSet: createChecksummedToken("botbotgo.agent.context", "skillSet"),
+  /** The initialized agent runtime instance (react/deep) */
+  Runtime: createChecksummedToken("botbotgo.agent.context", "runtime")
+};
+
+export {
+  AgentContextTokens
+};
+//# sourceMappingURL=chunk-H5BG6SXW.js.map

package/dist/chunk-H5BG6SXW.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/context/tokens.ts"],"sourcesContent":["import { computeChecksum } from \"../utils/checksum.js\";\n\nfunction createChecksummedToken(scope: string, name: string): symbol {\n  const seed = `${scope}:${name}`;\n  const checksum = computeChecksum(seed, { length: 12 });\n  return Symbol.for(`${scope}.${name}.${checksum}`);\n}\n\n/**\n * Well-known Symbol tokens for AgentContext.\n * Use these to register and retrieve modules from an AgentContext.\n *\n * @example\n * ```ts\n * ctx.set(AgentContextTokens.ChatModel, llm);\n * const llm = ctx.get<BaseChatModel>(AgentContextTokens.ChatModel);\n * ```\n */\nexport const AgentContextTokens = {\n  /** The shared AgentEventBus instance */\n  EventBus: createChecksummedToken(\"botbotgo.agent.context\", \"eventBus\"),\n  /** The primary chat model (BaseChatModel) */\n  ChatModel: createChecksummedToken(\"botbotgo.agent.context\", \"chatModel\"),\n  /** The embedding model (Embeddings) */\n  EmbedModel: createChecksummedToken(\"botbotgo.agent.context\", \"embedModel\"),\n  /** The vision-language chat model (BaseChatModel) */\n  VlmModel: createChecksummedToken(\"botbotgo.agent.context\", \"vlmModel\"),\n  /** The memory client (AgentMemory) */\n  Memory: createChecksummedToken(\"botbotgo.agent.context\", \"memory\"),\n  /** The initialized tool list */\n  Tools: createChecksummedToken(\"botbotgo.agent.context\", \"tools\"),\n  /** The loaded skill set (SkillSet | undefined) */\n  SkillSet: createChecksummedToken(\"botbotgo.agent.context\", \"skillSet\"),\n  /** The initialized agent runtime instance (react/deep) */\n  Runtime: createChecksummedToken(\"botbotgo.agent.context\", \"runtime\"),\n} as const;\n\nexport type AgentContextTokenKey = (typeof AgentContextTokens)[keyof typeof AgentContextTokens];\n"],"mappings":";;;;;AAEA,SAAS,uBAAuB,OAAe,MAAsB;AACnE,QAAM,OAAO,GAAG,KAAK,IAAI,IAAI;AAC7B,QAAM,WAAW,gBAAgB,MAAM,EAAE,QAAQ,GAAG,CAAC;AACrD,SAAO,uBAAO,IAAI,GAAG,KAAK,IAAI,IAAI,IAAI,QAAQ,EAAE;AAClD;AAYO,IAAM,qBAAqB;AAAA;AAAA,EAEhC,UAAU,uBAAuB,0BAA0B,UAAU;AAAA;AAAA,EAErE,WAAW,uBAAuB,0BAA0B,WAAW;AAAA;AAAA,EAEvE,YAAY,uBAAuB,0BAA0B,YAAY;AAAA;AAAA,EAEzE,UAAU,uBAAuB,0BAA0B,UAAU;AAAA;AAAA,EAErE,QAAQ,uBAAuB,0BAA0B,QAAQ;AAAA;AAAA,EAEjE,OAAO,uBAAuB,0BAA0B,OAAO;AAAA;AAAA,EAE/D,UAAU,uBAAuB,0BAA0B,UAAU;AAAA;AAAA,EAErE,SAAS,uBAAuB,0BAA0B,SAAS;AACrE;","names":[]}

package/dist/chunk-HBCZVEUG.js

@@ -0,0 +1,92 @@
+// src/cli/startup.ts
+import { relative } from "path";
+function toErrorMessage(error) {
+  return error instanceof Error ? error.message : String(error);
+}
+function formatLogPath(pathValue) {
+  const trimmed = pathValue.trim();
+  if (!trimmed) return "(unknown)";
+  const rel = relative(process.cwd(), trimmed);
+  if (!rel || rel.startsWith("..")) return trimmed;
+  return rel;
+}
+function formatDurationMs(durationMs) {
+  return durationMs === null ? "" : ` (${durationMs}ms)`;
+}
+var StartupProgressRenderer = class {
+  isDynamic = Boolean(process.stdout.isTTY);
+  frames = ["|", "/", "-", "\\"];
+  lineByStep = /* @__PURE__ */ new Map();
+  timerByStep = /* @__PURE__ */ new Map();
+  frameIndexByStep = /* @__PURE__ */ new Map();
+  lineCount = 0;
+  start(stepId, title) {
+    const baseLabel = `[startup] ${title}`;
+    if (!this.isDynamic) {
+      console.log(`${baseLabel} ...`);
+      return;
+    }
+    const lineIndex = this.lineCount;
+    this.lineByStep.set(stepId, lineIndex);
+    this.frameIndexByStep.set(stepId, 0);
+    this.lineCount += 1;
+    process.stdout.write(`\r${baseLabel} ${this.frames[0]}
+`);
+    const timer = setInterval(() => {
+      const current = this.frameIndexByStep.get(stepId);
+      if (current === void 0) return;
+      const next = (current + 1) % this.frames.length;
+      this.frameIndexByStep.set(stepId, next);
+      this.renderLine(stepId, `${baseLabel} ${this.frames[next]}`);
+    }, 80);
+    this.timerByStep.set(stepId, timer);
+  }
+  complete(stepId, title, ok, detail, elapsedMs) {
+    const baseLabel = `[startup] ${title}`;
+    const mark = ok ? "OK" : "ERR";
+    const detailPart = detail.trim().length > 0 ? ` ${detail}` : "";
+    const finalLine = `${mark} ${baseLabel}${detailPart}${formatDurationMs(elapsedMs)}`;
+    const timer = this.timerByStep.get(stepId);
+    if (timer) {
+      clearInterval(timer);
+      this.timerByStep.delete(stepId);
+    }
+    this.frameIndexByStep.delete(stepId);
+    if (!this.isDynamic) {
+      console.log(finalLine);
+      return;
+    }
+    this.renderLine(stepId, finalLine);
+  }
+  renderLine(stepId, line) {
+    const lineIndex = this.lineByStep.get(stepId);
+    if (lineIndex === void 0) return;
+    const up = this.lineCount - lineIndex;
+    if (up <= 0) return;
+    process.stdout.write(`\x1B[${up}A\r\x1B[2K${line}\x1B[${up}B\r`);
+  }
+};
+async function runStartupStep(progress, title, fn, formatResult) {
+  const stepId = `${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
+  const startedAt = Date.now();
+  progress.start(stepId, title);
+  try {
+    const result = await fn();
+    const detail = formatResult ? formatResult(result) : "";
+    const elapsed = Date.now() - startedAt;
+    progress.complete(stepId, title, true, detail, elapsed);
+    return result;
+  } catch (error) {
+    const elapsed = Date.now() - startedAt;
+    progress.complete(stepId, title, false, toErrorMessage(error), elapsed);
+    throw error;
+  }
+}
+
+export {
+  toErrorMessage,
+  formatLogPath,
+  StartupProgressRenderer,
+  runStartupStep
+};
+//# sourceMappingURL=chunk-HBCZVEUG.js.map

package/dist/chunk-HBCZVEUG.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli/startup.ts"],"sourcesContent":["import { relative } from \"node:path\";\n\nexport function toErrorMessage(error: unknown): string {\n  return error instanceof Error ? error.message : String(error);\n}\n\nexport function formatLogPath(pathValue: string): string {\n  const trimmed = pathValue.trim();\n  if (!trimmed) return \"(unknown)\";\n  const rel = relative(process.cwd(), trimmed);\n  if (!rel || rel.startsWith(\"..\")) return trimmed;\n  return rel;\n}\n\nfunction formatDurationMs(durationMs: number | null): string {\n  return durationMs === null ? \"\" : ` (${durationMs}ms)`;\n}\n\nexport class StartupProgressRenderer {\n  private readonly isDynamic = Boolean(process.stdout.isTTY);\n  private readonly frames = [\"|\", \"/\", \"-\", \"\\\\\"];\n  private readonly lineByStep = new Map<string, number>();\n  private readonly timerByStep = new Map<string, NodeJS.Timeout>();\n  private readonly frameIndexByStep = new Map<string, number>();\n  private lineCount = 0;\n\n  start(stepId: string, title: string): void {\n    const baseLabel = `[startup] ${title}`;\n    if (!this.isDynamic) {\n      console.log(`${baseLabel} ...`);\n      return;\n    }\n    const lineIndex = this.lineCount;\n    this.lineByStep.set(stepId, lineIndex);\n    this.frameIndexByStep.set(stepId, 0);\n    this.lineCount += 1;\n    process.stdout.write(`\\r${baseLabel} ${this.frames[0]}\\n`);\n    const timer = setInterval(() => {\n      const current = this.frameIndexByStep.get(stepId);\n      if (current === undefined) return;\n      const next = (current + 1) % this.frames.length;\n      this.frameIndexByStep.set(stepId, next);\n      this.renderLine(stepId, `${baseLabel} ${this.frames[next]}`);\n    }, 80);\n    this.timerByStep.set(stepId, timer);\n  }\n\n  complete(stepId: string, title: string, ok: boolean, detail: string, elapsedMs: number): void {\n    const baseLabel = `[startup] ${title}`;\n    const mark = ok ? \"OK\" : \"ERR\";\n    const detailPart = detail.trim().length > 0 ? ` ${detail}` : \"\";\n    const finalLine = `${mark} ${baseLabel}${detailPart}${formatDurationMs(elapsedMs)}`;\n    const timer = this.timerByStep.get(stepId);\n    if (timer) {\n      clearInterval(timer);\n      this.timerByStep.delete(stepId);\n    }\n    this.frameIndexByStep.delete(stepId);\n    if (!this.isDynamic) {\n      console.log(finalLine);\n      return;\n    }\n    this.renderLine(stepId, finalLine);\n  }\n\n  private renderLine(stepId: string, line: string): void {\n    const lineIndex = this.lineByStep.get(stepId);\n    if (lineIndex === undefined) return;\n    const up = this.lineCount - lineIndex;\n    if (up <= 0) return;\n    process.stdout.write(`\\x1b[${up}A\\r\\x1b[2K${line}\\x1b[${up}B\\r`);\n  }\n}\n\nexport async function runStartupStep<T>(\n  progress: StartupProgressRenderer,\n  title: string,\n  fn: () => Promise<T> | T,\n  formatResult?: (result: T) => string,\n): Promise<T> {\n  const stepId = `${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;\n  const startedAt = Date.now();\n  progress.start(stepId, title);\n\n  try {\n    const result = await fn();\n    const detail = formatResult ? formatResult(result) : \"\";\n    const elapsed = Date.now() - startedAt;\n    progress.complete(stepId, title, true, detail, elapsed);\n    return result;\n  } catch (error) {\n    const elapsed = Date.now() - startedAt;\n    progress.complete(stepId, title, false, toErrorMessage(error), elapsed);\n    throw error;\n  }\n}\n\n"],"mappings":"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","names":[]}

package/dist/chunk-OTWARMTU.js

@@ -0,0 +1,182 @@
+import {
+  parseYamlContent
+} from "./chunk-X4TDNR4V.js";
+
+// src/utils/deep-merge.ts
+function deepMerge(target, ...sources) {
+  for (const src of sources) {
+    if (!src || typeof src !== "object") continue;
+    for (const k of Object.keys(src)) {
+      const v = src[k];
+      if (v === void 0) continue;
+      const t = target[k];
+      if (v !== null && typeof v === "object" && !Array.isArray(v) && t !== null && typeof t === "object" && !Array.isArray(t)) {
+        deepMerge(t, v);
+      } else {
+        target[k] = v;
+      }
+    }
+  }
+  return target;
+}
+
+// src/utils/agent-result.ts
+function extractLastMessageText(result) {
+  const r = result;
+  const messages = r?.messages ?? r;
+  const lastContent = Array.isArray(messages) && messages.length > 0 ? messages.slice(-1)[0]?.content : r?.message?.content;
+  if (typeof lastContent === "string") return lastContent;
+  if (typeof lastContent === "object" && lastContent !== null && "text" in lastContent)
+    return String(lastContent.text);
+  return JSON.stringify(r ?? "");
+}
+
+// src/utils/object.ts
+function stripNullishObjectFields(value) {
+  if (Array.isArray(value)) {
+    return value.map((item) => stripNullishObjectFields(item));
+  }
+  if (value && typeof value === "object") {
+    const out = {};
+    for (const [k, v] of Object.entries(value)) {
+      if (v === null || v === void 0) continue;
+      out[k] = stripNullishObjectFields(v);
+    }
+    return out;
+  }
+  return value;
+}
+
+// src/utils/log.ts
+function summarizeForLog(value, maxLen = 220) {
+  const raw = typeof value === "string" ? value : value == null ? "" : (() => {
+    try {
+      return JSON.stringify(value);
+    } catch {
+      return String(value);
+    }
+  })();
+  const compact = raw.replace(/\s+/g, " ").trim();
+  if (!compact) return "(empty)";
+  return compact.length > maxLen ? compact.slice(0, maxLen) + "..." : compact;
+}
+
+// src/utils/parsing.ts
+function asRecord(value) {
+  return value && typeof value === "object" && !Array.isArray(value) ? value : null;
+}
+function asTrimmedString(value) {
+  return typeof value === "string" && value.trim().length > 0 ? value.trim() : null;
+}
+function parseJsonObject(value) {
+  if (typeof value !== "string") return null;
+  try {
+    return asRecord(JSON.parse(value));
+  } catch {
+    return null;
+  }
+}
+function extractTextFromLlmOutput(output) {
+  const content = output?.content;
+  if (typeof content === "string") return content.trim();
+  if (Array.isArray(content)) {
+    return content.map((part) => {
+      if (typeof part === "string") return part;
+      if (part && typeof part === "object" && "text" in part) {
+        const text = part.text;
+        return typeof text === "string" ? text : "";
+      }
+      return "";
+    }).join(" ").trim();
+  }
+  if (typeof output === "string") return output.trim();
+  return "";
+}
+
+// src/utils/selection/tool-registry.ts
+function isToolContainer(value) {
+  return Boolean(value && typeof value === "object" && Array.isArray(value.tools));
+}
+function isNamedToolLike(value) {
+  return Boolean(
+    value && typeof value === "object" && typeof value.name === "string"
+  );
+}
+function normalizeToolList(raw, guard) {
+  if (Array.isArray(raw)) {
+    if (guard) return raw.filter((tool) => guard(tool));
+    return raw.filter((tool) => isNamedToolLike(tool));
+  }
+  if (isToolContainer(raw)) {
+    return normalizeToolList(raw.tools, guard);
+  }
+  return [];
+}
+function shortToolName(name) {
+  const parts = name.split(".");
+  return parts[parts.length - 1] ?? name;
+}
+
+// src/utils/override-with-config.ts
+function overrideWithConfig(defaults, config) {
+  const c = config != null && typeof config === "object" && !Array.isArray(config) ? config : {};
+  const out = { ...defaults };
+  for (const key of Object.keys(defaults)) {
+    if (key in c && c[key] !== void 0) {
+      out[key] = c[key];
+    }
+  }
+  return out;
+}
+
+// src/utils/frontmatter.ts
+function parseMarkdownYamlFrontmatter(content, filePath) {
+  const trimmed = content.trimStart();
+  if (!trimmed.startsWith("---")) {
+    throw new Error(`Markdown must start with YAML frontmatter (---): ${filePath}`);
+  }
+  const endIndex = trimmed.indexOf("\n---", 3);
+  if (endIndex === -1) {
+    throw new Error(`Markdown frontmatter is not closed (missing closing ---): ${filePath}`);
+  }
+  const yamlBlock = trimmed.slice(4, endIndex).trim();
+  let raw;
+  try {
+    raw = parseYamlContent(yamlBlock, { substituteEnv: false });
+  } catch (err) {
+    const message = err instanceof Error ? err.message : String(err);
+    throw new Error(`Invalid YAML frontmatter in ${filePath}: ${message}`);
+  }
+  if (raw == null || typeof raw !== "object" || Array.isArray(raw)) {
+    throw new Error(`YAML frontmatter must be an object (key: value): ${filePath}`);
+  }
+  const body = trimmed.slice(endIndex + 4).trim();
+  return { frontmatter: raw, body };
+}
+
+// src/utils/selection/tool-choice.ts
+function applyDefaultToolChoice(model) {
+  const target = model;
+  const original = target.bindTools?.bind(model);
+  if (!original) return;
+  target.bindTools = function(tools, opts) {
+    return original(tools, { ...opts, tool_choice: "auto" });
+  };
+}
+
+export {
+  deepMerge,
+  extractLastMessageText,
+  stripNullishObjectFields,
+  summarizeForLog,
+  asRecord,
+  asTrimmedString,
+  parseJsonObject,
+  extractTextFromLlmOutput,
+  normalizeToolList,
+  shortToolName,
+  overrideWithConfig,
+  parseMarkdownYamlFrontmatter,
+  applyDefaultToolChoice
+};
+//# sourceMappingURL=chunk-OTWARMTU.js.map

package/dist/chunk-OTWARMTU.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/utils/deep-merge.ts","../src/utils/agent-result.ts","../src/utils/object.ts","../src/utils/log.ts","../src/utils/parsing.ts","../src/utils/selection/tool-registry.ts","../src/utils/override-with-config.ts","../src/utils/frontmatter.ts","../src/utils/selection/tool-choice.ts"],"sourcesContent":["/**\n * Deep merge: overwrite target with each source (only defined values). Nested objects merged recursively.\n */\n\nexport function deepMerge<T extends object>(target: T, ...sources: Partial<T>[]): T {\n  for (const src of sources) {\n    if (!src || typeof src !== \"object\") continue;\n    for (const k of Object.keys(src) as (keyof T)[]) {\n      const v = src[k];\n      if (v === undefined) continue;\n      const t = (target as Record<keyof T, unknown>)[k];\n      if (\n        v !== null &&\n        typeof v === \"object\" &&\n        !Array.isArray(v) &&\n        t !== null &&\n        typeof t === \"object\" &&\n        !Array.isArray(t)\n      ) {\n        deepMerge(t as object, v as object);\n      } else {\n        (target as Record<keyof T, unknown>)[k] = v;\n      }\n    }\n  }\n  return target;\n}\n","/**\n * Extract the final assistant text from a LangChain/DeepAgents invoke result.\n */\nexport function extractLastMessageText(result: unknown): string {\n  const r = result as { messages?: unknown; message?: { content?: string } } | null | undefined;\n  const messages = r?.messages ?? r;\n  const lastContent =\n    Array.isArray(messages) && messages.length > 0\n      ? (messages as { content?: string }[]).slice(-1)[0]?.content\n      : r?.message?.content;\n  if (typeof lastContent === \"string\") return lastContent;\n  if (\n    typeof lastContent === \"object\" &&\n    lastContent !== null &&\n    \"text\" in (lastContent as object)\n  )\n    return String((lastContent as { text: string }).text);\n  return JSON.stringify(r ?? \"\");\n}\n","/**\n * Recursively remove null and undefined fields from object values.\n */\nexport function stripNullishObjectFields(value: unknown): unknown {\n  if (Array.isArray(value)) {\n    return value.map((item) => stripNullishObjectFields(item));\n  }\n  if (value && typeof value === \"object\") {\n    const out: Record<string, unknown> = {};\n    for (const [k, v] of Object.entries(value as Record<string, unknown>)) {\n      if (v === null || v === undefined) continue;\n      out[k] = stripNullishObjectFields(v);\n    }\n    return out;\n  }\n  return value;\n}\n","export function summarizeForLog(value: unknown, maxLen = 220): string {\n  const raw =\n    typeof value === \"string\"\n      ? value\n      : value == null\n        ? \"\"\n        : (() => {\n            try {\n              return JSON.stringify(value);\n            } catch {\n              return String(value);\n            }\n          })();\n  const compact = raw.replace(/\\s+/g, \" \").trim();\n  if (!compact) return \"(empty)\";\n  return compact.length > maxLen ? compact.slice(0, maxLen) + \"...\" : compact;\n}\n\n","export function asRecord(value: unknown): Record<string, unknown> | null {\n  return value && typeof value === \"object\" && !Array.isArray(value)\n    ? (value as Record<string, unknown>)\n    : null;\n}\n\nexport function asTrimmedString(value: unknown): string | null {\n  return typeof value === \"string\" && value.trim().length > 0 ? value.trim() : null;\n}\n\nexport function parseJsonObject(value: unknown): Record<string, unknown> | null {\n  if (typeof value !== \"string\") return null;\n  try {\n    return asRecord(JSON.parse(value));\n  } catch {\n    return null;\n  }\n}\n\nexport function extractTextFromLlmOutput(output: unknown): string {\n  const content = (output as { content?: unknown } | null)?.content;\n  if (typeof content === \"string\") return content.trim();\n  if (Array.isArray(content)) {\n    return content\n      .map((part) => {\n        if (typeof part === \"string\") return part;\n        if (part && typeof part === \"object\" && \"text\" in part) {\n          const text = (part as { text?: unknown }).text;\n          return typeof text === \"string\" ? text : \"\";\n        }\n        return \"\";\n      })\n      .join(\" \")\n      .trim();\n  }\n  if (typeof output === \"string\") return output.trim();\n  return \"\";\n}\n\n","export type NamedToolLike = {\n  name: string;\n};\n\nfunction isToolContainer(value: unknown): value is { tools: unknown[] } {\n  return Boolean(value && typeof value === \"object\" && Array.isArray((value as { tools?: unknown[] }).tools));\n}\n\nfunction isNamedToolLike(value: unknown): value is NamedToolLike {\n  return Boolean(\n    value\n      && typeof value === \"object\"\n      && typeof (value as { name?: unknown }).name === \"string\",\n  );\n}\n\nexport function normalizeToolList<T extends NamedToolLike = NamedToolLike>(\n  raw: unknown,\n  guard?: (value: unknown) => value is T,\n): T[] {\n  if (Array.isArray(raw)) {\n    if (guard) return raw.filter((tool): tool is T => guard(tool));\n    return raw.filter((tool): tool is T => isNamedToolLike(tool));\n  }\n  if (isToolContainer(raw)) {\n    return normalizeToolList(raw.tools, guard);\n  }\n  return [];\n}\n\nexport function shortToolName(name: string): string {\n  const parts = name.split(\".\");\n  return parts[parts.length - 1] ?? name;\n}\n\n","/**\n * Overlay config values on top of typed defaults.\n * Only keys present in `defaults` are eligible for override; values from\n * `config` are applied only when they are not undefined.\n *\n * Typical use: set safe hardcoded defaults, then call overrideWithConfig to\n * let user/extension config win where provided.\n *\n * @example\n * const cfg = overrideWithConfig({ timeoutMs: 5000, maxBytes: 1048576 }, ctx.config);\n */\nexport function overrideWithConfig<T extends Record<string, unknown>>(\n  defaults: T,\n  config: unknown,\n): T {\n  const c =\n    config != null && typeof config === \"object\" && !Array.isArray(config)\n      ? (config as Record<string, unknown>)\n      : {};\n  const out = { ...defaults };\n  for (const key of Object.keys(defaults)) {\n    if (key in c && c[key] !== undefined) {\n      (out as Record<string, unknown>)[key] = c[key];\n    }\n  }\n  return out;\n}\n","import { parseYamlContent } from \"../config/index.js\";\n\nexport interface ParsedMarkdownFrontmatter {\n  frontmatter: Record<string, unknown>;\n  body: string;\n}\n\n/**\n * Parse markdown content with YAML frontmatter:\n * ---\n * key: value\n * ---\n * body...\n */\nexport function parseMarkdownYamlFrontmatter(content: string, filePath: string): ParsedMarkdownFrontmatter {\n  const trimmed = content.trimStart();\n  if (!trimmed.startsWith(\"---\")) {\n    throw new Error(`Markdown must start with YAML frontmatter (---): ${filePath}`);\n  }\n\n  const endIndex = trimmed.indexOf(\"\\n---\", 3);\n  if (endIndex === -1) {\n    throw new Error(`Markdown frontmatter is not closed (missing closing ---): ${filePath}`);\n  }\n\n  const yamlBlock = trimmed.slice(4, endIndex).trim();\n  let raw: unknown;\n  try {\n    raw = parseYamlContent<unknown>(yamlBlock, { substituteEnv: false });\n  } catch (err) {\n    const message = err instanceof Error ? err.message : String(err);\n    throw new Error(`Invalid YAML frontmatter in ${filePath}: ${message}`);\n  }\n\n  if (raw == null || typeof raw !== \"object\" || Array.isArray(raw)) {\n    throw new Error(`YAML frontmatter must be an object (key: value): ${filePath}`);\n  }\n\n  const body = trimmed.slice(endIndex + 4).trim();\n  return { frontmatter: raw as Record<string, unknown>, body };\n}\n","export function applyDefaultToolChoice(model: unknown): void {\n  const target = model as {\n    bindTools?: (tools: unknown, opts?: Record<string, unknown>) => unknown;\n  };\n  const original = target.bindTools?.bind(model);\n  if (!original) return;\n  target.bindTools = function (tools: unknown, opts?: Record<string, unknown>) {\n    return original(tools, { ...opts, tool_choice: \"auto\" });\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-QG6CT2GZ.js

@@ -0,0 +1,31 @@
+// src/utils/checksum.ts
+import { createHash } from "crypto";
+function computeChecksum(input, options = {}) {
+  const algorithm = options.algorithm ?? "sha256";
+  const digest = createHash(algorithm).update(input).digest("hex");
+  const length = options.length;
+  if (!Number.isInteger(length) || length === void 0) return digest;
+  if (length <= 0) return "";
+  return digest.slice(0, length);
+}
+function createChecksumAccumulator(options = {}) {
+  const algorithm = options.algorithm ?? "sha256";
+  const hasher = createHash(algorithm);
+  return {
+    update(input) {
+      hasher.update(input);
+    },
+    digest(length) {
+      const full = hasher.digest("hex");
+      if (!Number.isInteger(length) || length === void 0) return full;
+      if (length <= 0) return "";
+      return full.slice(0, length);
+    }
+  };
+}
+
+export {
+  computeChecksum,
+  createChecksumAccumulator
+};
+//# sourceMappingURL=chunk-QG6CT2GZ.js.map

package/dist/chunk-QG6CT2GZ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/utils/checksum.ts"],"sourcesContent":["import { createHash } from \"node:crypto\";\n\nexport interface ComputeChecksumOptions {\n  algorithm?: \"sha256\";\n  length?: number;\n}\n\nexport interface ChecksumAccumulator {\n  update(input: string | Uint8Array): void;\n  digest(length?: number): string;\n}\n\n/**\n * Deterministic short checksum for signatures/tokens.\n */\nexport function computeChecksum(input: string, options: ComputeChecksumOptions = {}): string {\n  const algorithm = options.algorithm ?? \"sha256\";\n  const digest = createHash(algorithm).update(input).digest(\"hex\");\n  const length = options.length;\n  if (!Number.isInteger(length) || length === undefined) return digest;\n  if (length <= 0) return \"\";\n  return digest.slice(0, length);\n}\n\n/**\n * Create an incremental checksum accumulator for streaming/chunked data.\n */\nexport function createChecksumAccumulator(options: Omit<ComputeChecksumOptions, \"length\"> = {}): ChecksumAccumulator {\n  const algorithm = options.algorithm ?? \"sha256\";\n  const hasher = createHash(algorithm);\n  return {\n    update(input: string | Uint8Array): void {\n      hasher.update(input);\n    },\n    digest(length?: number): string {\n      const full = hasher.digest(\"hex\");\n      if (!Number.isInteger(length) || length === undefined) return full;\n      if (length <= 0) return \"\";\n      return full.slice(0, length);\n    },\n  };\n}\n"],"mappings":";AAAA,SAAS,kBAAkB;AAepB,SAAS,gBAAgB,OAAe,UAAkC,CAAC,GAAW;AAC3F,QAAM,YAAY,QAAQ,aAAa;AACvC,QAAM,SAAS,WAAW,SAAS,EAAE,OAAO,KAAK,EAAE,OAAO,KAAK;AAC/D,QAAM,SAAS,QAAQ;AACvB,MAAI,CAAC,OAAO,UAAU,MAAM,KAAK,WAAW,OAAW,QAAO;AAC9D,MAAI,UAAU,EAAG,QAAO;AACxB,SAAO,OAAO,MAAM,GAAG,MAAM;AAC/B;AAKO,SAAS,0BAA0B,UAAkD,CAAC,GAAwB;AACnH,QAAM,YAAY,QAAQ,aAAa;AACvC,QAAM,SAAS,WAAW,SAAS;AACnC,SAAO;AAAA,IACL,OAAO,OAAkC;AACvC,aAAO,OAAO,KAAK;AAAA,IACrB;AAAA,IACA,OAAO,QAAyB;AAC9B,YAAM,OAAO,OAAO,OAAO,KAAK;AAChC,UAAI,CAAC,OAAO,UAAU,MAAM,KAAK,WAAW,OAAW,QAAO;AAC9D,UAAI,UAAU,EAAG,QAAO;AACxB,aAAO,KAAK,MAAM,GAAG,MAAM;AAAA,IAC7B;AAAA,EACF;AACF;","names":[]}