@botbotgo/runtime 1.0.0

package/.github/workflows/ci.yml

@@ -0,0 +1,46 @@
+name: CI
+
+on:
+  push:
+    branches: ["**"]
+  pull_request:
+    branches: ["**"]
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  build-and-test:
+    name: Build & Test
+    runs-on: ubuntu-latest
+    timeout-minutes: 20
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: "22"
+          cache: npm
+
+      - name: Resolve internal package refs
+        run: node scripts/resolve-deps.js
+
+      - name: Install dependencies (root)
+        run: npm install --legacy-peer-deps
+
+      - name: Build (root)
+        run: npm run build --if-present
+
+      - name: Test (root)
+        run: npm test --if-present
+
+      - name: Install dependencies (example)
+        run: npm install --legacy-peer-deps
+        working-directory: example
+
+      - name: Build (example)
+        run: npm run build --if-present
+        working-directory: example

package/.github/workflows/release.yml

@@ -0,0 +1,79 @@
+name: Release
+
+on:
+  push:
+    branches:
+      - main
+  workflow_dispatch:
+  repository_dispatch:
+    types:
+      - botbotgo-package-updated
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+permissions:
+  contents: write
+
+jobs:
+  release:
+    name: Release
+    runs-on: ubuntu-latest
+    timeout-minutes: 30
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          token: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: "22"
+          cache: npm
+          registry-url: "https://registry.npmjs.org"
+
+      - name: Resolve internal package refs
+        run: node scripts/resolve-deps.js
+
+      - name: Install dependencies (root)
+        run: npm install --legacy-peer-deps
+
+      - name: Build (root)
+        run: npm run build --if-present
+
+      - name: Test (root)
+        run: npm test --if-present
+
+      - name: Install dependencies (example)
+        run: npm install --legacy-peer-deps
+        working-directory: example
+
+      - name: Build (example)
+        run: npm run build --if-present
+        working-directory: example
+
+      - name: Detect npm token
+        id: release_gate
+        env:
+          NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
+        run: |
+          if [ -n "${NPM_TOKEN}" ]; then
+            echo "has_npm_token=true" >> "$GITHUB_OUTPUT"
+          else
+            echo "has_npm_token=false" >> "$GITHUB_OUTPUT"
+          fi
+
+      - name: Skip release (missing NPM_TOKEN)
+        if: ${{ steps.release_gate.outputs.has_npm_token == 'false' }}
+        run: echo "NPM_TOKEN is not configured. Skipping semantic-release."
+
+      - name: Release
+        if: ${{ steps.release_gate.outputs.has_npm_token == 'true' }}
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+        run: npx semantic-release

package/README.md

@@ -0,0 +1,71 @@
+# @botbotgo/runtime
+
+## Introduction
+
+`@botbotgo/runtime` is the runtime layer for deepagents-based applications in this workspace. It loads runtime config, wires model and tool dependencies, manages workspace state, and executes agent runs with retry and artifact tracking.
+
+## Exposed Interfaces
+
+| Export | Type | Purpose |
+| --- | --- | --- |
+| `createAgentRuntime2` | function | Create the runtime with framework-managed dependencies. |
+| `AgentRuntimeService` | class | Main runtime service. |
+| `ConsoleHumanLoopService` | class | Console-based human approval flow. |
+| `createRuntime2TreeEventListener` | function | Tree-style runtime event listener. |
+| `loadAgentRuntimeConfig` | function | Load runtime config from `config/`. |
+| `registerAgentRuntimeGlobal` | function | Register runtime global state. |
+| `getAgentRuntimeGlobal` | function | Read runtime global state. |
+
+## Configuration
+
+Typical files:
+
+- `config/runtime.yaml`
+- `config/model.yaml`
+- `config/tool.yaml`
+- `config/memory.yaml`
+
+Minimal runtime config:
+
+```yaml
+apiVersion: botbotgo.world/v1
+kind: AgentRuntimeConfig
+metadata:
+  name: default-runtime
+spec:
+  artifacts:
+    - key: report
+      path: output/report.html
+  stateDirName: .agent
+  systemPrompt: |
+    You are a precise runtime agent.
+```
+
+Main runtime options:
+
+- `rootDir`: workspace root
+- `configDir`: config directory
+- `toolConfigPath`: tool config path
+- `modelConfigPath`: model config path
+- `memoryConfigPath`: memory config path
+- `humanLoop`: human approval service
+
+## Usage
+
+```bash
+npm i @botbotgo/runtime
+```
+
+```ts
+import { createAgentRuntime2 } from "@botbotgo/runtime";
+
+const runtime = await createAgentRuntime2({
+  rootDir: process.cwd(),
+  modelConfigPath: "config/model.yaml",
+  toolConfigPath: "config/tool.yaml",
+  memoryConfigPath: "config/memory.yaml",
+});
+
+await runtime.run("Generate the required report.");
+await runtime.close();
+```

package/config/examples/memory.yaml

@@ -0,0 +1,39 @@
+apiVersion: botbotgo.world/v1
+kind: MemoryConfig
+metadata:
+  name: agent-memory-default
+spec:
+  memory:
+    thread:
+      store:
+        type: in_memory
+      allowWrite: true
+      maxItems: 20
+      sessionCompaction:
+        enabled: true
+        maxTokens: 3000
+        keepRecentTurns: 12
+        summaryKey: __session_summary__
+        checkEveryTurns: 3
+
+    cross_thread:
+      store:
+        type: in_memory
+      allowWrite: true
+      maxItems: 20
+
+    knowledge:
+      store:
+        type: in_memory
+      allowWrite: true
+      maxItems: 20
+
+  observability:
+    trace: false
+
+  privacy:
+    forbiddenMetadataKeys:
+      - password
+      - api_key
+      - secret
+      - token

package/config/examples/model.yaml

@@ -0,0 +1,21 @@
+apiVersion: botbotgo.world/v1
+kind: ModelConfig
+metadata:
+  name: runtime2-default-model
+spec:
+  llm:
+    default: gpt_oss
+    gpt_oss:
+      provider: openai
+      base_url: http://localhost:11434/v1
+      model: gpt-oss:latest
+      apiKey: ollama
+      options:
+        timeoutMs: 60000
+    lfm2:
+      provider: openai
+      base_url: http://localhost:11434/v1
+      model: lfm2:latest
+      apiKey: ollama
+      options:
+        timeoutMs: 60000

package/config/examples/runtime.yaml

@@ -0,0 +1,44 @@
+apiVersion: botbotgo.world/v1
+kind: AgentRuntimeConfig
+metadata:
+  name: default-runtime
+spec:
+  # Artifacts the run must produce before it is considered complete.
+  artifacts:
+    - key: report
+      path: output/report.html
+
+  # Workspace state persisted under the runtime root directory.
+  stateDirName: .agent
+  legacyOutputState: true
+
+  # Default system guidance passed to the runtime agent.
+  systemPrompt: |
+    You are a precise automation runtime agent.
+    Follow skills and produce only the required artifacts.
+  # Allow the built-in task tool unless the skill should fully own planning.
+  blockTaskTool: false
+
+  # Execution limits.
+  executeTimeoutMs: 60000
+  llmIdleTimeoutMs: 300000
+  heartbeatIntervalMs: 10000
+  backend:
+    type: local_shell
+    timeoutMs: 15000
+    maxOutputBytes: 1048576
+
+  # Retry policy for incomplete or malformed model/tool output.
+  incompleteRunMaxRetries: 2
+  emptyRunMaxRetries: 2
+  malformedToolCallMaxRetries: 2
+  idleTimeoutMaxRetries: 1
+
+  # Fine-grained event toggles. Prefer this over eventLogLevel when you need
+  # explicit control over which runtime events are printed.
+  debug:
+    run: true
+    workspace: true
+    toolCall: true
+    stream: false
+    close: true

package/config/examples/skills.yaml

@@ -0,0 +1,8 @@
+apiVersion: botbotgo.world/v1
+kind: SkillsConfig
+metadata:
+  name: default-skills
+spec:
+  cacheDir: ~/.agent/cache/skills
+  skills:
+    github-release:https://github.com/botbotgo/skill-builtin: {}

package/config/examples/tool.yaml

@@ -0,0 +1,16 @@
+apiVersion: botbotgo.world/v1
+kind: ToolConfig
+metadata:
+  name: runtime2-default-tools
+spec:
+  sandboxedPath: .
+  cacheDir: ~/.agent/cache
+  toolPath: dist/src
+  skillPath: skills
+  paths:
+    npm:@botbotgo/kit-builtin: {}
+  allowedHosts:
+    - "*"
+  blockedHosts: []
+  tools:
+    customized: {}

package/dist/config/index.d.ts

@@ -0,0 +1,7 @@
+export { loadFromFile, loadFromDirectory, loadFromString, parseResource, parseAllResources, ConfigError, } from "./loader.js";
+export type { LoadOptions } from "./loader.js";
+export { resolveAgentConfig, buildDeepAgentOptions, } from "./resolveRuntimeConfig.js";
+export type { ResolvedAgentConfig, ResolvedMemoryConfig, ResolvedAgentRuntimeConfig, MemoryStoreResolved, } from "./resolveRuntimeConfig.js";
+export { loadAgentRuntimeConfig, AgentRuntimeConfigService, } from "./runtimeConfigLoader.js";
+export type { LoadAgentRuntimeConfigOptions, AgentRuntimeConfigResult, } from "./runtimeConfigLoader.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/config/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,cAAc,EACd,aAAa,EACb,iBAAiB,EACjB,WAAW,GACZ,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,OAAO,EACL,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,2BAA2B,CAAC;AACnC,YAAY,EACV,mBAAmB,EACnB,oBAAoB,EACpB,0BAA0B,EAC1B,mBAAmB,GACpB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACL,sBAAsB,EACtB,yBAAyB,GAC1B,MAAM,0BAA0B,CAAC;AAClC,YAAY,EACV,6BAA6B,EAC7B,wBAAwB,GACzB,MAAM,0BAA0B,CAAC"}

package/dist/config/index.js

@@ -0,0 +1,4 @@
+export { loadFromFile, loadFromDirectory, loadFromString, parseResource, parseAllResources, ConfigError, } from "./loader.js";
+export { resolveAgentConfig, buildDeepAgentOptions, } from "./resolveRuntimeConfig.js";
+export { loadAgentRuntimeConfig, AgentRuntimeConfigService, } from "./runtimeConfigLoader.js";
+//# sourceMappingURL=index.js.map

package/dist/config/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,cAAc,EACd,aAAa,EACb,iBAAiB,EACjB,WAAW,GACZ,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,2BAA2B,CAAC;AAQnC,OAAO,EACL,sBAAsB,EACtB,yBAAyB,GAC1B,MAAM,0BAA0B,CAAC"}

package/dist/config/loader.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Load K8s-style YAML config from file, directory, or string.
+ */
+import type { Resource } from "./resources.js";
+export interface LoadOptions {
+    /** If true, skip invalid documents and continue; default false */
+    ignoreInvalid?: boolean;
+    /** Optional base directory for resolving relative paths in config (e.g. skill paths) */
+    baseDir?: string;
+}
+export declare class ConfigError extends Error {
+    readonly path?: string | undefined;
+    readonly cause?: unknown | undefined;
+    constructor(message: string, path?: string | undefined, cause?: unknown | undefined);
+}
+/**
+ * Parse a single YAML document into a typed Resource.
+ * Does not validate spec shape per kind; use validators if needed.
+ */
+export declare function parseResource(yamlContent: string): Resource<string, unknown>;
+/**
+ * Parse YAML that may contain multiple documents (--- separated).
+ * Returns the first valid resource; throws if none valid.
+ */
+export declare function parseAllResources(yamlContent: string, options?: LoadOptions): Resource<string, unknown>[];
+/**
+ * Load a single resource from a file path.
+ */
+export declare function loadFromFile(filePath: string, options?: LoadOptions): Promise<Resource<string, unknown>>;
+/**
+ * Load all K8s-style resources from a directory.
+ * Scans for .yaml/.yml files (non-recursive by default).
+ */
+export declare function loadFromDirectory(dirPath: string, options?: LoadOptions & {
+    recursive?: boolean;
+}): Promise<Resource<string, unknown>[]>;
+/**
+ * Parse a single resource from a YAML string.
+ */
+export declare function loadFromString(content: string, options?: LoadOptions): Resource<string, unknown>;
+//# sourceMappingURL=loader.d.ts.map

package/dist/config/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/config/loader.ts"],"names":[],"mappings":"AAAA;;GAEG;AAQH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAM/C,MAAM,WAAW,WAAW;IAC1B,kEAAkE;IAClE,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,wFAAwF;IACxF,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,WAAY,SAAQ,KAAK;aAGlB,IAAI,CAAC,EAAE,MAAM;aACb,KAAK,CAAC,EAAE,OAAO;gBAF/B,OAAO,EAAE,MAAM,EACC,IAAI,CAAC,EAAE,MAAM,YAAA,EACb,KAAK,CAAC,EAAE,OAAO,YAAA;CAKlC;AAyCD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,CAE5E;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,WAAgB,GACxB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAY7B;AAED;;GAEG;AACH,wBAAsB,YAAY,CAChC,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAgBpC;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,WAAW,GAAG;IAAE,SAAS,CAAC,EAAE,OAAO,CAAA;CAAO,GAClD,OAAO,CAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,CAuBtC;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,WAAgB,GACxB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,CAS3B"}

package/dist/config/loader.js

@@ -0,0 +1,140 @@
+/**
+ * Load K8s-style YAML config from file, directory, or string.
+ */
+import { loadYamlFile, parseYamlContent, } from "@botbotgo/common/config";
+import { readFile, readdir } from "node:fs/promises";
+import { join, extname } from "node:path";
+const YAML_EXTS = [".yaml", ".yml"];
+const SUPPORTED_API = "botbotgo.world/v1";
+const SUPPORTED_KINDS = ["MemoryConfig", "SkillsConfig", "AgentRuntimeConfig"];
+export class ConfigError extends Error {
+    path;
+    cause;
+    constructor(message, path, cause) {
+        super(message);
+        this.path = path;
+        this.cause = cause;
+        this.name = "ConfigError";
+    }
+}
+function splitYamlDocuments(yamlContent) {
+    return yamlContent
+        .split(/^---(?:\s+#.*)?\s*$/m)
+        .map((part) => part.trim())
+        .filter((part) => part.length > 0);
+}
+function isRecord(v) {
+    return typeof v === "object" && v !== null && !Array.isArray(v);
+}
+function hasRequiredFields(doc) {
+    if (!isRecord(doc))
+        return false;
+    if (typeof doc.apiVersion !== "string" || typeof doc.kind !== "string")
+        return false;
+    if (!isRecord(doc.metadata) || typeof doc.metadata.name !== "string")
+        return false;
+    if (!(typeof doc.spec === "object" && doc.spec !== null))
+        return false;
+    return true;
+}
+function validateResource(doc) {
+    if (doc === undefined || doc === null)
+        throw new ConfigError("YAML document is empty");
+    if (!hasRequiredFields(doc))
+        throw new ConfigError("Invalid resource: missing or invalid apiVersion, kind, metadata.name, or spec");
+    if (doc.apiVersion !== SUPPORTED_API)
+        throw new ConfigError(`Unsupported apiVersion: ${doc.apiVersion}. Expected ${SUPPORTED_API}`);
+    if (!SUPPORTED_KINDS.includes(doc.kind))
+        throw new ConfigError(`Unsupported kind: ${doc.kind}. Supported: ${SUPPORTED_KINDS.join(", ")}`);
+    return doc;
+}
+/**
+ * Parse a single YAML document into a typed Resource.
+ * Does not validate spec shape per kind; use validators if needed.
+ */
+export function parseResource(yamlContent) {
+    return validateResource(parseYamlContent(yamlContent));
+}
+/**
+ * Parse YAML that may contain multiple documents (--- separated).
+ * Returns the first valid resource; throws if none valid.
+ */
+export function parseAllResources(yamlContent, options = {}) {
+    const out = [];
+    const docs = splitYamlDocuments(yamlContent);
+    for (let i = 0; i < docs.length; i++) {
+        try {
+            out.push(validateResource(parseYamlContent(docs[i])));
+        }
+        catch (e) {
+            if (!options.ignoreInvalid)
+                throw e;
+        }
+    }
+    return out;
+}
+/**
+ * Load a single resource from a file path.
+ */
+export async function loadFromFile(filePath, options = {}) {
+    try {
+        const doc = await loadYamlFile(filePath);
+        if (doc === undefined) {
+            throw new ConfigError(`Failed to read file: ${filePath}`, filePath);
+        }
+        return validateResource(doc);
+    }
+    catch (e) {
+        if (e instanceof ConfigError) {
+            throw new ConfigError(e.message, filePath, e.cause);
+        }
+        if (e?.code === "ENOENT") {
+            throw new ConfigError(`Failed to read file: ${filePath}`, filePath, e);
+        }
+        throw new ConfigError(String(e), filePath, e);
+    }
+}
+/**
+ * Load all K8s-style resources from a directory.
+ * Scans for .yaml/.yml files (non-recursive by default).
+ */
+export async function loadFromDirectory(dirPath, options = {}) {
+    const { recursive = false, ...loadOpts } = options;
+    const entries = await readdir(dirPath, { withFileTypes: true }).catch((e) => {
+        throw new ConfigError(`Failed to read directory: ${dirPath}`, dirPath, e);
+    });
+    const results = [];
+    for (const ent of entries) {
+        const full = join(dirPath, ent.name);
+        if (ent.isDirectory() && recursive) {
+            const sub = await loadFromDirectory(full, options);
+            results.push(...sub);
+        }
+        if (!ent.isFile() || !YAML_EXTS.includes(extname(ent.name)))
+            continue;
+        try {
+            const content = await readFile(full, "utf-8");
+            const resources = parseAllResources(content, loadOpts);
+            results.push(...resources);
+        }
+        catch (e) {
+            if (!loadOpts.ignoreInvalid)
+                throw new ConfigError(String(e), full, e);
+        }
+    }
+    return results;
+}
+/**
+ * Parse a single resource from a YAML string.
+ */
+export function loadFromString(content, options = {}) {
+    const multi = content.includes("---");
+    if (multi) {
+        const list = parseAllResources(content, options);
+        if (list.length === 0)
+            throw new ConfigError("No valid resource found in multi-document YAML");
+        return list[0];
+    }
+    return parseResource(content);
+}
+//# sourceMappingURL=loader.js.map

package/dist/config/loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../../src/config/loader.ts"],"names":[],"mappings":"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"}

package/dist/config/resolveRuntimeConfig.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Map loaded K8s-style configs to options suitable for deepagents (createDeepAgent).
+ * Supports MemoryConfig, SkillsConfig, and AgentRuntimeConfig; memory shape is exposed for app use
+ * until deepagents exposes a matching memory API.
+ */
+import type { AgentBackendConfigSpec, KnownResource } from "./resources.js";
+export interface ResolvedAgentConfig {
+    /** Skill source paths to pass to createDeepAgent({ skills }) */
+    skills: string[];
+    /** Resolved memory config (thread/cross_thread/knowledge). Use for your own store/checkpointer or when deepagents supports it. */
+    memory: ResolvedMemoryConfig | null;
+    /** Observability and privacy from MemoryConfig, if present */
+    observability: {
+        trace: boolean;
+    };
+    privacy: {
+        forbiddenMetadataKeys: string[];
+    };
+    /** Runtime defaults from AgentRuntimeConfig, if present */
+    runtime: ResolvedAgentRuntimeConfig;
+}
+export interface ResolvedMemoryConfig {
+    thread: MemoryStoreResolved;
+    cross_thread: MemoryStoreResolved;
+    knowledge: MemoryStoreResolved;
+}
+export interface MemoryStoreResolved {
+    store: {
+        type: string;
+        options?: Record<string, unknown>;
+    };
+    allowWrite: boolean;
+    maxItems: number;
+    sessionCompaction?: {
+        enabled: boolean;
+        maxTokens: number;
+        keepRecentTurns: number;
+        summaryKey: string;
+        checkEveryTurns: number;
+    };
+}
+export interface ResolvedAgentRuntimeConfig {
+    artifacts?: Array<{
+        key: string;
+        path: string;
+    }>;
+    stateDirName?: string;
+    legacyOutputState?: boolean;
+    executeTimeoutMs?: number;
+    blockTaskTool?: boolean;
+    systemPrompt?: string;
+    llmIdleTimeoutMs?: number;
+    backend?: AgentBackendConfigSpec;
+    incompleteRunMaxRetries?: number;
+    emptyRunMaxRetries?: number;
+    malformedToolCallMaxRetries?: number;
+    idleTimeoutMaxRetries?: number;
+    heartbeatIntervalMs?: number;
+    debug?: {
+        run?: boolean;
+        workspace?: boolean;
+        toolCall?: boolean;
+        stream?: boolean;
+        close?: boolean;
+    };
+    eventLogLevel?: "silent" | "lifecycle" | "tools" | "verbose";
+}
+/**
+ * Reduce an array of loaded resources into a single ResolvedAgentConfig.
+ * - SkillsConfig: parsed for compatibility, but skill roots are resolved outside this module.
+ * - MemoryConfig: first one wins (by name order or array order); optional merge strategy could be added.
+ */
+export declare function resolveAgentConfig(resources: KnownResource[]): ResolvedAgentConfig;
+/**
+ * Build options object for createDeepAgent from resolved config.
+ * Pass skills; use resolvedAgentConfig.memory / observability / privacy in your app as needed.
+ */
+export declare function buildDeepAgentOptions(resolved: ResolvedAgentConfig): {
+    skills: string[];
+    /** Optional: attach to run/config for observability and privacy (app-specific) */
+    _resolved: ResolvedAgentConfig;
+};
+//# sourceMappingURL=resolveRuntimeConfig.d.ts.map

package/dist/config/resolveRuntimeConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveRuntimeConfig.d.ts","sourceRoot":"","sources":["../../src/config/resolveRuntimeConfig.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,sBAAsB,EAEtB,aAAa,EAEd,MAAM,gBAAgB,CAAC;AAGxB,MAAM,WAAW,mBAAmB;IAClC,gEAAgE;IAChE,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,kIAAkI;IAClI,MAAM,EAAE,oBAAoB,GAAG,IAAI,CAAC;IACpC,8DAA8D;IAC9D,aAAa,EAAE;QAAE,KAAK,EAAE,OAAO,CAAA;KAAE,CAAC;IAClC,OAAO,EAAE;QAAE,qBAAqB,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAC7C,2DAA2D;IAC3D,OAAO,EAAE,0BAA0B,CAAC;CACrC;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,mBAAmB,CAAC;IAC5B,YAAY,EAAE,mBAAmB,CAAC;IAClC,SAAS,EAAE,mBAAmB,CAAC;CAChC;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC;IAC3D,UAAU,EAAE,OAAO,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,iBAAiB,CAAC,EAAE;QAClB,OAAO,EAAE,OAAO,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,eAAe,EAAE,MAAM,CAAC;QACxB,UAAU,EAAE,MAAM,CAAC;QACnB,eAAe,EAAE,MAAM,CAAC;KACzB,CAAC;CACH;AAED,MAAM,WAAW,0BAA0B;IACzC,SAAS,CAAC,EAAE,KAAK,CAAC;QAChB,GAAG,EAAE,MAAM,CAAC;QACZ,IAAI,EAAE,MAAM,CAAC;KACd,CAAC,CAAC;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,OAAO,CAAC,EAAE,sBAAsB,CAAC;IACjC,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,2BAA2B,CAAC,EAAE,MAAM,CAAC;IACrC,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,KAAK,CAAC,EAAE;QACN,GAAG,CAAC,EAAE,OAAO,CAAC;QACd,SAAS,CAAC,EAAE,OAAO,CAAC;QACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,KAAK,CAAC,EAAE,OAAO,CAAC;KACjB,CAAC;IACF,aAAa,CAAC,EAAE,QAAQ,GAAG,WAAW,GAAG,OAAO,GAAG,SAAS,CAAC;CAC9D;AAKD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,aAAa,EAAE,GAAG,mBAAmB,CAmClF;AA+BD;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,mBAAmB,GAAG;IACpE,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,kFAAkF;IAClF,SAAS,EAAE,mBAAmB,CAAC;CAChC,CAKA"}