@nac3/forge-cli 0.2.0-alpha.9 → 0.2.1-alpha.60

package/dist/agents/cli_real.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli_real.d.ts","sourceRoot":"","sources":["../../src/agents/cli_real.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAI5C,OAAO,EAAE,YAAY,EAAsB,MAAM,mBAAmB,CAAC;AAErE,UAAU,gBAAgB;IACxB,GAAG,EAAc,eAAe,CAAC;IACjC,cAAc,EAAG,MAAM,CAAC;IACxB,YAAY,EAAK,MAAM,CAAC;IACxB,YAAY,EAAK,MAAM,CAAC;IACxB,aAAa,EAAI,MAAM,CAAC;IACxB;2DACuD;IACvD,MAAM,CAAC,EAAU,qBAAqB,CAAC,OAAO,YAAY,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,CAAC,GAC1E,CAAC,SAAS,IAAI,GAAG,SAAS,GACxB,OAAO,mBAAmB,EAAE,YAAY,GACxC,OAAO,mBAAmB,EAAE,YAAY,GAC1C,OAAO,mBAAmB,EAAE,YAAY,CAAC;IAC7C,OAAO,CAAC,EAAS,OAAO,CAAC;IACzB;+CAC2C;IAC3C,WAAW,CAAC,EAAK,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,YAAa,SAAQ,KAAK;IAAG,IAAI,EAAE,eAAe,GAAG,SAAS,CAAC;CAAE;AAElF;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CAuC1E"}

package/dist/agents/cli_real.js

@@ -0,0 +1,46 @@
+import { buildAgentStepFactory } from './real_step_factory.js';
+import { runNac3Invoke } from '../chat/tools/nac3_invoke.js';
+import { runForgeTool } from '../chat/tools.js';
+import { ClaudeClient, ConfigurationError } from '../chat/claude.js';
+/**
+ * Build the live StepFn the runner will execute. Returns the
+ * StepFn directly; the caller (the CLI subcommand) wraps it with
+ * `runAgent(def, {step, ...})`.
+ */
+export async function makeRealStep(opts) {
+    let claude = opts.claude;
+    if (!claude) {
+        try {
+            claude = new ClaudeClient();
+        }
+        catch (err) {
+            if (err instanceof ConfigurationError) {
+                const e = new Error('No Claude API key available. Set anthropic_api_key in the vault '
+                    + '(`yf keys setup --provider anthropic --key <KEY>`) or pass a '
+                    + 'tenant license via `yf license activate`.');
+                e.code = 'no_claude_key';
+                throw e;
+            }
+            const e = new Error('Failed to instantiate Claude client: '
+                + (err instanceof Error ? err.message : String(err)));
+            e.code = 'unknown';
+            throw e;
+        }
+    }
+    const factory = buildAgentStepFactory({
+        claude,
+        runNac3Invoke: runNac3Invoke,
+        project_root: opts.project_root,
+        project_name: opts.project_name,
+        forge_version: opts.forge_version,
+        runtime: opts.runtime,
+        bridge_root: opts.bridge_root,
+        /* legacy_run wires the original Forge tool dispatcher so the
+         * agent verbs that route through legacy handlers (git, fs,
+         * pizarron, etc) keep working as before. */
+        legacy_run: runForgeTool,
+        nac3_ctx: { projectRoot: opts.project_root },
+    });
+    return factory(opts.def, opts.trigger_reason);
+}
+//# sourceMappingURL=cli_real.js.map

package/dist/agents/cli_real.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli_real.js","sourceRoot":"","sources":["../../src/agents/cli_real.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAuBrE;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,IAAsB;IACvD,IAAI,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;IACzB,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,IAAI,CAAC;YACH,MAAM,GAAG,IAAI,YAAY,EAAE,CAAC;QAC9B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,GAAG,YAAY,kBAAkB,EAAE,CAAC;gBACtC,MAAM,CAAC,GAAG,IAAI,KAAK,CACjB,kEAAkE;sBAChE,+DAA+D;sBAC/D,2CAA2C,CAC9B,CAAC;gBAClB,CAAC,CAAC,IAAI,GAAG,eAAe,CAAC;gBACzB,MAAM,CAAC,CAAC;YACV,CAAC;YACD,MAAM,CAAC,GAAG,IAAI,KAAK,CACjB,uCAAuC;kBACrC,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CACrC,CAAC;YAClB,CAAC,CAAC,IAAI,GAAG,SAAS,CAAC;YACnB,MAAM,CAAC,CAAC;QACV,CAAC;IACH,CAAC;IAED,MAAM,OAAO,GAAG,qBAAqB,CAAC;QACpC,MAAM;QACN,aAAa,EAAE,aAAsB;QACrC,YAAY,EAAG,IAAI,CAAC,YAAY;QAChC,YAAY,EAAG,IAAI,CAAC,YAAY;QAChC,aAAa,EAAE,IAAI,CAAC,aAAa;QACjC,OAAO,EAAQ,IAAI,CAAC,OAAO;QAC3B,WAAW,EAAI,IAAI,CAAC,WAAW;QAC/B;;oDAE4C;QAC5C,UAAU,EAAK,YAAY;QAC3B,QAAQ,EAAO,EAAE,WAAW,EAAE,IAAI,CAAC,YAAY,EAAE;KAClD,CAAC,CAAC;IACH,OAAO,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC;AAChD,CAAC"}

package/dist/agents/config_resolver.d.ts

@@ -0,0 +1,16 @@
+import { type AgentConfigKey } from './config_schema.js';
+export interface ResolveOptions {
+    /** Override the user config path (test isolation). */
+    userConfigPath?: string;
+    /** Disable env layer (test isolation). */
+    noEnv?: boolean;
+}
+export declare function invalidateAgentConfigCache(): void;
+export declare function getAgentConfig<T extends number | string | boolean>(key: AgentConfigKey, opts?: ResolveOptions): Promise<T>;
+export declare function snapshotAgentConfig(opts?: ResolveOptions): Promise<Array<{
+    key: AgentConfigKey;
+    value: unknown;
+    source: 'env' | 'user' | 'default';
+    description: string;
+}>>;
+//# sourceMappingURL=config_resolver.d.ts.map

package/dist/agents/config_resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config_resolver.d.ts","sourceRoot":"","sources":["../../src/agents/config_resolver.ts"],"names":[],"mappings":"AAcA,OAAO,EAEL,KAAK,cAAc,EAIpB,MAAM,oBAAoB,CAAC;AAM5B,MAAM,WAAW,cAAc;IAC7B,sDAAsD;IACtD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,0CAA0C;IAC1C,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAuCD,wBAAgB,0BAA0B,IAAI,IAAI,CAGjD;AAED,wBAAsB,cAAc,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,GAAG,OAAO,EACtE,GAAG,EAAE,cAAc,EACnB,IAAI,GAAE,cAAmB,GACxB,OAAO,CAAC,CAAC,CAAC,CA2BZ;AAKD,wBAAsB,mBAAmB,CACvC,IAAI,GAAE,cAAmB,GACxB,OAAO,CAAC,KAAK,CAAC;IAAE,GAAG,EAAE,cAAc,CAAC;IAAC,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,SAAS,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,CAgClH"}

package/dist/agents/config_resolver.js

@@ -0,0 +1,133 @@
+/**
+ * Agent config resolver. Walks the override chain:
+ *   1. process.env[YF_AGENT_<UPPER_SNAKE>] (highest precedence, dev)
+ *   2. project-level override (left out of slice 1 -- TBD when the
+ *      project store wires in; falls back to user level for now)
+ *   3. user-level ~/.yujin-forge/agents/config.json
+ *   4. published default (config_schema.ts)
+ *
+ * Returns the validated, type-coerced value. Invalid overrides
+ * log a single warning + fall through to the next layer.
+ */
+import { promises as fs } from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { AGENT_CONFIG_SCHEMA, validateAgentConfigValue, getAgentConfigDefault, getAgentConfigDescriptor, } from './config_schema.js';
+let cachedUserConfig = null;
+let cachedAt = 0;
+const USER_CONFIG_TTL_MS = 5_000; /* re-read after 5s so edits show up without restart */
+function envKeyFor(key) {
+    /* `agent.bridge.tokens_per_pair_hourly` ->
+     *  `YF_AGENT_BRIDGE_TOKENS_PER_PAIR_HOURLY` */
+    return 'YF_' + key.replace(/[.\-]/g, '_').toUpperCase();
+}
+function defaultUserConfigPath() {
+    return path.join(os.homedir(), '.yujin-forge', 'agents', 'config.json');
+}
+async function loadUserConfig(p) {
+    const now = Date.now();
+    if (cachedUserConfig !== null && (now - cachedAt) < USER_CONFIG_TTL_MS) {
+        return cachedUserConfig;
+    }
+    try {
+        const raw = await fs.readFile(p, 'utf-8');
+        const obj = JSON.parse(raw);
+        if (obj && typeof obj === 'object' && !Array.isArray(obj)) {
+            cachedUserConfig = obj;
+            cachedAt = now;
+            return cachedUserConfig;
+        }
+        /* JSON parsed but is array / primitive -- treat as empty. */
+        cachedUserConfig = {};
+        cachedAt = now;
+        return cachedUserConfig;
+    }
+    catch {
+        /* File missing or unreadable -- empty override is the safe default. */
+        cachedUserConfig = {};
+        cachedAt = now;
+        return cachedUserConfig;
+    }
+}
+/* Reset the cache. Used by `yf limits set agent.<key>` after a
+ * successful write so subsequent reads see the new value. */
+export function invalidateAgentConfigCache() {
+    cachedUserConfig = null;
+    cachedAt = 0;
+}
+export async function getAgentConfig(key, opts = {}) {
+    /* Layer 1 -- env */
+    if (!opts.noEnv) {
+        const envValue = process.env[envKeyFor(key)];
+        if (envValue !== undefined) {
+            try {
+                return validateAgentConfigValue(key, envValue);
+            }
+            catch {
+                /* fall through; env override invalid */
+                console.warn('[agent-config] env override for ' + key + ' invalid, falling through');
+            }
+        }
+    }
+    /* Layer 2 -- project override (TBD in a later slice when the
+     *  project store exposes a `limits_config` row. Skipping for
+     *  slice 1.) */
+    /* Layer 3 -- user config */
+    const userConfig = await loadUserConfig(opts.userConfigPath ?? defaultUserConfigPath());
+    if (userConfig[key] !== undefined) {
+        try {
+            return validateAgentConfigValue(key, userConfig[key]);
+        }
+        catch {
+            console.warn('[agent-config] user override for ' + key + ' invalid, falling through');
+        }
+    }
+    /* Layer 4 -- published default */
+    return getAgentConfigDefault(key);
+}
+/* Snapshot every key as the resolver would currently see them.
+ * Used by `yf agent doctor` + the panel settings tab to show the
+ * effective config without surprise. */
+export async function snapshotAgentConfig(opts = {}) {
+    const userConfig = await loadUserConfig(opts.userConfigPath ?? defaultUserConfigPath());
+    const out = [];
+    for (const d of AGENT_CONFIG_SCHEMA) {
+        const envValue = opts.noEnv ? undefined : process.env[envKeyFor(d.key)];
+        let value;
+        let source;
+        if (envValue !== undefined) {
+            try {
+                value = validateAgentConfigValue(d.key, envValue);
+                source = 'env';
+            }
+            catch {
+                value = userConfig[d.key] !== undefined
+                    ? (() => { try {
+                        return validateAgentConfigValue(d.key, userConfig[d.key]);
+                    }
+                    catch {
+                        return d.default;
+                    } })()
+                    : d.default;
+                source = userConfig[d.key] !== undefined ? 'user' : 'default';
+            }
+        }
+        else if (userConfig[d.key] !== undefined) {
+            try {
+                value = validateAgentConfigValue(d.key, userConfig[d.key]);
+                source = 'user';
+            }
+            catch {
+                value = d.default;
+                source = 'default';
+            }
+        }
+        else {
+            value = d.default;
+            source = 'default';
+        }
+        out.push({ key: d.key, value, source, description: getAgentConfigDescriptor(d.key).description });
+    }
+    return out;
+}
+//# sourceMappingURL=config_resolver.js.map

package/dist/agents/config_resolver.js.map

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

package/dist/agents/config_schema.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Agent orchestrator config schema (HITO 5 slice 1).
+ *
+ * Source of truth for every threshold / cap / default that the
+ * agent runtime + bridge use. Per Pablo's locked decision:
+ * NOTHING in src/agents/* may hardcode a number. Every dial
+ * lands here, with a published default + a description that the
+ * config-file generator uses as the comment.
+ *
+ * Read order at runtime:
+ *   1. process.env override (`YF_AGENT_<UPPER_SNAKE_CASE>`)
+ *   2. project-level limits_config row (`agent.<key>` namespace)
+ *   3. user-level `~/.yujin-forge/agents/config.json`
+ *   4. published default (this file)
+ *
+ * The published default is the LAST fallback, never inlined into
+ * a handler. Handlers call `getAgentConfig(key)` which walks the
+ * chain. Invalid types log a warning + fall back to default.
+ *
+ * Changes to defaults ship as a config-file edit, not a code
+ * change in src/agents/*.ts.
+ */
+export type AgentConfigKey = 'agent.bridge.tokens_per_pair_hourly' | 'agent.bridge.round_trips_window_seconds' | 'agent.bridge.round_trips_max' | 'agent.bridge.message_ttl_seconds' | 'agent.bridge.inbox_drain_batch' | 'agent.runtime.max_consecutive_rejected_approvals' | 'agent.runtime.run_timeout_seconds' | 'agent.runtime.max_concurrent_runs_global' | 'agent.runtime.max_concurrent_runs_per_project' | 'agent.cron.missed_runs_warning_threshold' | 'agent.audit.retention_days' | 'agent.deletion.grace_period_days' | 'agent.web_search.provider' | 'agent.web_search.daily_query_cap';
+export type AgentConfigType = 'number' | 'string' | 'boolean';
+export interface AgentConfigDescriptor {
+    key: AgentConfigKey;
+    type: AgentConfigType;
+    default: number | string | boolean;
+    description: string;
+    /** Optional enum -- for string keys that must be one of N values. */
+    enum?: readonly string[];
+    /** Optional bounds for number keys. */
+    min?: number;
+    max?: number;
+}
+export declare const AGENT_CONFIG_SCHEMA: readonly AgentConfigDescriptor[];
+export declare function getAgentConfigDescriptor(key: AgentConfigKey): AgentConfigDescriptor;
+export declare function getAgentConfigDefault(key: AgentConfigKey): number | string | boolean;
+export declare function validateAgentConfigValue(key: AgentConfigKey, raw: unknown): number | string | boolean;
+export declare function renderDefaultConfigJson(): string;
+export declare function renderConfigDocsMarkdown(): string;
+//# sourceMappingURL=config_schema.d.ts.map

package/dist/agents/config_schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config_schema.d.ts","sourceRoot":"","sources":["../../src/agents/config_schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,MAAM,MAAM,cAAc,GAEtB,qCAAqC,GACrC,yCAAyC,GACzC,8BAA8B,GAC9B,kCAAkC,GAClC,gCAAgC,GAGhC,kDAAkD,GAClD,mCAAmC,GACnC,0CAA0C,GAC1C,+CAA+C,GAE/C,0CAA0C,GAE1C,4BAA4B,GAC5B,kCAAkC,GAElC,2BAA2B,GAC3B,kCAAkC,CAAC;AAEvC,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;AAE9D,MAAM,WAAW,qBAAqB;IACpC,GAAG,EAAU,cAAc,CAAC;IAC5B,IAAI,EAAS,eAAe,CAAC;IAC7B,OAAO,EAAM,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,qEAAqE;IACrE,IAAI,CAAC,EAAQ,SAAS,MAAM,EAAE,CAAC;IAC/B,uCAAuC;IACvC,GAAG,CAAC,EAAS,MAAM,CAAC;IACpB,GAAG,CAAC,EAAS,MAAM,CAAC;CACrB;AAMD,eAAO,MAAM,mBAAmB,EAAE,SAAS,qBAAqB,EAgHtD,CAAC;AAWX,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,cAAc,GAAG,qBAAqB,CAMnF;AAED,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,cAAc,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAEpF;AAKD,wBAAgB,wBAAwB,CACtC,GAAG,EAAE,cAAc,EACnB,GAAG,EAAE,OAAO,GACX,MAAM,GAAG,MAAM,GAAG,OAAO,CA6B3B;AAMD,wBAAgB,uBAAuB,IAAI,MAAM,CAMhD;AAKD,wBAAgB,wBAAwB,IAAI,MAAM,CAYjD"}

package/dist/agents/config_schema.js

@@ -0,0 +1,220 @@
+/**
+ * Agent orchestrator config schema (HITO 5 slice 1).
+ *
+ * Source of truth for every threshold / cap / default that the
+ * agent runtime + bridge use. Per Pablo's locked decision:
+ * NOTHING in src/agents/* may hardcode a number. Every dial
+ * lands here, with a published default + a description that the
+ * config-file generator uses as the comment.
+ *
+ * Read order at runtime:
+ *   1. process.env override (`YF_AGENT_<UPPER_SNAKE_CASE>`)
+ *   2. project-level limits_config row (`agent.<key>` namespace)
+ *   3. user-level `~/.yujin-forge/agents/config.json`
+ *   4. published default (this file)
+ *
+ * The published default is the LAST fallback, never inlined into
+ * a handler. Handlers call `getAgentConfig(key)` which walks the
+ * chain. Invalid types log a warning + fall back to default.
+ *
+ * Changes to defaults ship as a config-file edit, not a code
+ * change in src/agents/*.ts.
+ */
+/* The canonical schema. The config-file generator + the runtime
+ * validator + the `yf limits` CLI all read from this list. Order
+ * matters for the generated config file (it's the section order
+ * users see). */
+export const AGENT_CONFIG_SCHEMA = [
+    {
+        key: 'agent.bridge.tokens_per_pair_hourly',
+        type: 'number',
+        default: 100_000,
+        description: 'Token cap per (agent_a, agent_b) pair per rolling 1-hour window. When exhausted, both ends receive bridge_token_cap_reached + the pair freezes until the window resets.',
+        min: 1_000,
+        max: 10_000_000,
+    },
+    {
+        key: 'agent.bridge.round_trips_window_seconds',
+        type: 'number',
+        default: 60,
+        description: 'Sliding window in seconds for the round-trip loop detector. Round trips inside this window are counted; outside, ignored.',
+        min: 10,
+        max: 3600,
+    },
+    {
+        key: 'agent.bridge.round_trips_max',
+        type: 'number',
+        default: 10,
+        description: 'Round trips between an (a,b) pair inside the window that trigger auto-revoke. Pair is closed, status=auto_revoked, manual re-enable required.',
+        min: 2,
+        max: 1000,
+    },
+    {
+        key: 'agent.bridge.message_ttl_seconds',
+        type: 'number',
+        default: 86_400,
+        description: 'Inbox message expiry. Undelivered messages older than this are marked expired + skipped on next drain.',
+        min: 60,
+        max: 2_592_000, /* 30 days */
+    },
+    {
+        key: 'agent.bridge.inbox_drain_batch',
+        type: 'number',
+        default: 20,
+        description: 'Max messages an agent drains per wake. Prevents a single agent from blocking the others by processing a huge inbox.',
+        min: 1,
+        max: 1000,
+    },
+    {
+        key: 'agent.runtime.max_consecutive_rejected_approvals',
+        type: 'number',
+        default: 3,
+        description: 'Consecutive rejected approvals that kill an agent run. Resets to 0 on every accepted approval.',
+        min: 1,
+        max: 100,
+    },
+    {
+        key: 'agent.runtime.run_timeout_seconds',
+        type: 'number',
+        default: 1800, /* 30 min */
+        description: 'Hard cap per agent run. Run is force-stopped, status=timeout, partial results preserved.',
+        min: 10,
+        max: 86_400,
+    },
+    {
+        key: 'agent.runtime.max_concurrent_runs_global',
+        type: 'number',
+        default: 6,
+        description: 'Total concurrent agent runs across every project. Once reached, new dispatches block until a slot frees up. Default tuned for a notebook running on a Tier 1 Anthropic key (50 RPM). EC2 deployments should set this to 20-50 via `yf limits set agent.runtime.max_concurrent_runs_global N`.',
+        min: 1,
+        max: 200,
+    },
+    {
+        key: 'agent.runtime.max_concurrent_runs_per_project',
+        type: 'number',
+        default: 2,
+        description: 'Concurrent agent runs per project_slug. Prevents one busy project from starving others. The Director itself counts as one slot, so default=2 means Director + one delegated worker. Lift to 4-5 once you have a paid Anthropic plan.',
+        min: 1,
+        max: 100,
+    },
+    {
+        key: 'agent.cron.missed_runs_warning_threshold',
+        type: 'number',
+        default: 3,
+        description: 'How many missed cron ticks before the panel warns the user. Local-only agents only fire while the panel is open; this catches "I closed the laptop for a week".',
+        min: 1,
+        max: 100,
+    },
+    {
+        key: 'agent.audit.retention_days',
+        type: 'number',
+        default: 90,
+        description: 'How long agent runs + bridge messages stay in audit_log. Matches the global audit-log default.',
+        min: 1,
+        max: 3650,
+    },
+    {
+        key: 'agent.deletion.grace_period_days',
+        type: 'number',
+        default: 30,
+        description: 'When an agent is deleted, runs move to the deleted/ partition for this many days before purge. Lets the user un-delete.',
+        min: 0,
+        max: 3650,
+    },
+    {
+        key: 'agent.web_search.provider',
+        type: 'string',
+        default: 'brave',
+        description: 'Web search provider for the default agent:web-search delegate (managed-only). User-created BYOK web-search agents pick their own.',
+        enum: ['brave', 'tavily', 'google'],
+    },
+    {
+        key: 'agent.web_search.daily_query_cap',
+        type: 'number',
+        default: 100,
+        description: 'Daily query cap for the managed agent:web-search delegate using the central API key. Per-user. Resets at UTC midnight.',
+        min: 1,
+        max: 100_000,
+    },
+];
+/* Map for O(1) lookup. */
+const SCHEMA_BY_KEY = (() => {
+    const out = {};
+    for (const d of AGENT_CONFIG_SCHEMA) {
+        out[d.key] = d;
+    }
+    return out;
+})();
+export function getAgentConfigDescriptor(key) {
+    const d = SCHEMA_BY_KEY[key];
+    if (!d) {
+        throw new Error('Unknown agent config key: ' + String(key));
+    }
+    return d;
+}
+export function getAgentConfigDefault(key) {
+    return getAgentConfigDescriptor(key).default;
+}
+/* Validation -- used by both the runtime config loader + the
+ * `yf limits set agent.<key> <value>` CLI. Returns the coerced
+ * value on success, throws on failure. */
+export function validateAgentConfigValue(key, raw) {
+    const d = getAgentConfigDescriptor(key);
+    switch (d.type) {
+        case 'number': {
+            const n = typeof raw === 'number' ? raw : Number(raw);
+            if (!Number.isFinite(n)) {
+                throw new Error('agent config ' + key + ' must be a number, got ' + typeof raw);
+            }
+            if (d.min !== undefined && n < d.min) {
+                throw new Error('agent config ' + key + ' below min (' + d.min + '): got ' + n);
+            }
+            if (d.max !== undefined && n > d.max) {
+                throw new Error('agent config ' + key + ' above max (' + d.max + '): got ' + n);
+            }
+            return n;
+        }
+        case 'string': {
+            const s = String(raw);
+            if (d.enum && !d.enum.includes(s)) {
+                throw new Error('agent config ' + key + ' must be one of [' + d.enum.join(', ') + '], got ' + JSON.stringify(s));
+            }
+            return s;
+        }
+        case 'boolean': {
+            if (raw === true || raw === 'true' || raw === 1 || raw === '1')
+                return true;
+            if (raw === false || raw === 'false' || raw === 0 || raw === '0')
+                return false;
+            throw new Error('agent config ' + key + ' must be a boolean, got ' + JSON.stringify(raw));
+        }
+    }
+}
+/* Generates the user-facing config file body (json with a leading
+ * comment block listing every key + description + default). The
+ * config file lives at `~/.yujin-forge/agents/config.json` and is
+ * created on first `yf agent install --defaults`. */
+export function renderDefaultConfigJson() {
+    const obj = {};
+    for (const d of AGENT_CONFIG_SCHEMA) {
+        obj[d.key] = d.default;
+    }
+    return JSON.stringify(obj, null, 2);
+}
+/* Generates a markdown doc of every key + description + default
+ * for inclusion in docs/HITO_5_AGENT_ORCHESTRATOR_DESIGN.md or
+ * the user-facing settings panel. */
+export function renderConfigDocsMarkdown() {
+    const rows = AGENT_CONFIG_SCHEMA.map((d) => {
+        const bounds = d.type === 'number'
+            ? ' (range: ' + (d.min ?? '-') + '..' + (d.max ?? '-') + ')'
+            : (d.enum ? ' (one of: ' + d.enum.join(', ') + ')' : '');
+        return '| `' + d.key + '` | ' + d.type + bounds + ' | ' + JSON.stringify(d.default) + ' | ' + d.description + ' |';
+    });
+    return [
+        '| Key | Type | Default | Description |',
+        '|---|---|---|---|',
+        ...rows,
+    ].join('\n');
+}
+//# sourceMappingURL=config_schema.js.map

package/dist/agents/config_schema.js.map

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

package/dist/agents/defaults.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Default agents Forge ships on first install (HITO 5 slice 3).
+ *
+ * Defined in code (not JSON files) so the build does not need
+ * to copy assets + the canonical shape is statically checked
+ * against AgentDefinition. The `yf agent install --defaults`
+ * CLI writes these to `~/.yujin-forge/agents/by-slug/<slug>/`
+ * via `saveAgentDefinition` -- the same path users edit later.
+ *
+ * Per HITO 5 lock 2026-06-04, the two seeded agents are:
+ *   - agent:brain-matrix-nightly-watcher  (the dogfood, #6 in
+ *     the clarification list)
+ *   - agent:web-search                    (the delegate that
+ *     other agents whitelist for web search; resolves the
+ *     "web search as a verb" item)
+ */
+import type { AgentDefinition } from './types.js';
+export declare const BRAIN_MATRIX_NIGHTLY_WATCHER: AgentDefinition;
+export declare const WEB_SEARCH_AGENT: AgentDefinition;
+export declare const DEFAULT_AGENTS: readonly AgentDefinition[];
+//# sourceMappingURL=defaults.d.ts.map

package/dist/agents/defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../src/agents/defaults.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAGlD,eAAO,MAAM,4BAA4B,EAAE,eA6B1C,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,eA+B9B,CAAC;AAGF,eAAO,MAAM,cAAc,EAAE,SAAS,eAAe,EAGpD,CAAC"}

package/dist/agents/defaults.js

@@ -0,0 +1,56 @@
+import { buildAgentDefinitionDraft } from './store.js';
+export const BRAIN_MATRIX_NIGHTLY_WATCHER = buildAgentDefinitionDraft('brain-matrix-nightly-watcher', 'Brain matrix nightly watcher', {
+    description: 'Runs the brain matrix gate every 24h + opens an issue on regression. Dogfood agent.',
+    brain_tier: 'eco',
+    trigger: {
+        kind: 'cron',
+        config: { cron_expr: '0 8 * * *' }, /* 08:00 UTC daily; user can edit. */
+    },
+    can_call: [],
+    can_be_called_by: [],
+    allowed_verbs: [
+        /* Read-only on the local repo + report via Slack/GitHub. */
+        'yujin.fs.read',
+        'yujin.fs.find',
+        'yujin.git.status',
+        'yujin.git.branch-list',
+        'yujin.git.log',
+        'yujin.shell.exec', /* needed to run `pnpm run brain-matrix:gate` */
+    ],
+    prompt_addition: 'Tu trabajo: correr `pnpm run brain-matrix:gate`, parsear el output,'
+        + ' y reportar el conteo de pass/fail/err. Si el conteo de fail o err'
+        + ' creció desde la última corrida, abrir un issue en GitHub con el'
+        + ' diff. Si no, terminar sin posting. NO modificar fixtures ni código.',
+    status: 'active',
+});
+export const WEB_SEARCH_AGENT = buildAgentDefinitionDraft('web-search', 'Web search delegate', {
+    description: 'Web search via Brave/Tavily/Google. Other agents whitelist this slug to delegate searches without owning the API key.',
+    brain_tier: 'managed',
+    trigger: {
+        kind: 'manual', /* invoked by bridge messages from other agents */
+        config: {},
+    },
+    can_call: [],
+    /* Open whitelist: any agent can call us. The pair-level token
+     * cap + loop detector keep abuse in check. */
+    can_be_called_by: ['*'],
+    allowed_verbs: [
+        /* Only the search itself + the JSON helpers needed to
+         * normalize results. */
+        'yujin.json.stringify',
+        'yujin.json.parse',
+        'yujin.url.parse',
+    ],
+    prompt_addition: 'You are the web-search delegate. Other agents send you a search query'
+        + ' via the inter-agent bridge. Use the configured provider'
+        + ' (agent.web_search.provider) to run the search, normalize the top 5'
+        + ' results into {title, url, snippet, published_at}, and reply via'
+        + ' the same bridge. Respect the daily query cap'
+        + ' (agent.web_search.daily_query_cap).',
+    status: 'active',
+});
+export const DEFAULT_AGENTS = [
+    BRAIN_MATRIX_NIGHTLY_WATCHER,
+    WEB_SEARCH_AGENT,
+];
+//# sourceMappingURL=defaults.js.map

package/dist/agents/defaults.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.js","sourceRoot":"","sources":["../../src/agents/defaults.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAEvD,MAAM,CAAC,MAAM,4BAA4B,GAAoB,yBAAyB,CACpF,8BAA8B,EAC9B,8BAA8B,EAC9B;IACE,WAAW,EACT,qFAAqF;IACvF,UAAU,EAAE,KAAK;IACjB,OAAO,EAAE;QACP,IAAI,EAAI,MAAM;QACd,MAAM,EAAE,EAAE,SAAS,EAAE,WAAW,EAAE,EAAG,qCAAqC;KAC3E;IACD,QAAQ,EAAE,EAAE;IACZ,gBAAgB,EAAE,EAAE;IACpB,aAAa,EAAE;QACb,4DAA4D;QAC5D,eAAe;QACf,eAAe;QACf,kBAAkB;QAClB,uBAAuB;QACvB,eAAe;QACf,kBAAkB,EAAG,gDAAgD;KACtE;IACD,eAAe,EACb,qEAAqE;UACnE,oEAAoE;UACpE,kEAAkE;UAClE,sEAAsE;IAC1E,MAAM,EAAE,QAAQ;CACjB,CACF,CAAC;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAAoB,yBAAyB,CACxE,YAAY,EACZ,qBAAqB,EACrB;IACE,WAAW,EACT,uHAAuH;IACzH,UAAU,EAAE,SAAS;IACrB,OAAO,EAAE;QACP,IAAI,EAAI,QAAQ,EAAG,kDAAkD;QACrE,MAAM,EAAE,EAAE;KACX;IACD,QAAQ,EAAE,EAAE;IACZ;kDAC8C;IAC9C,gBAAgB,EAAE,CAAC,GAAG,CAAC;IACvB,aAAa,EAAE;QACb;gCACwB;QACxB,sBAAsB;QACtB,kBAAkB;QAClB,iBAAiB;KAClB;IACD,eAAe,EACb,uEAAuE;UACrE,0DAA0D;UAC1D,qEAAqE;UACrE,kEAAkE;UAClE,+CAA+C;UAC/C,sCAAsC;IAC1C,MAAM,EAAE,QAAQ;CACjB,CACF,CAAC;AAGF,MAAM,CAAC,MAAM,cAAc,GAA+B;IACxD,4BAA4B;IAC5B,gBAAgB;CACjB,CAAC"}

package/dist/agents/delegate.d.ts

@@ -0,0 +1,36 @@
+import type { Runtime } from './runtime.js';
+import type { AgentRunStatus } from './types.js';
+export interface DelegateOpts {
+    from_slug: string;
+    to_slug: string;
+    payload: string;
+    tokens_used: number;
+    /** Override the bridge root for tests. */
+    root?: string;
+    /** Runtime used to dispatch the target agent + await its run.
+     *  When undefined, the delegate just enqueues the bridge
+     *  message + returns ok=true without a run result (fire-and-
+     *  forget mode, used by cron-triggered flows). */
+    runtime?: Runtime;
+}
+export interface DelegateResult {
+    ok: boolean;
+    /** The slug the message was addressed to. */
+    target_slug: string;
+    /** Reason text the runtime saw -- useful for audit. */
+    trigger_reason?: string;
+    /** Status of the agent run that handled the message. Undefined
+     *  in fire-and-forget mode (no runtime). */
+    run_status?: AgentRunStatus;
+    /** The receiver's last_reply_summary. Undefined in fire-and-
+     *  forget mode. */
+    last_reply?: string;
+    /** Tokens consumed by the target run. Undefined in fire-and-
+     *  forget mode. */
+    tokens_in?: number;
+    tokens_out?: number;
+    /** Set when ok=false. */
+    error?: string;
+}
+export declare function delegateToAgent(opts: DelegateOpts): Promise<DelegateResult>;
+//# sourceMappingURL=delegate.d.ts.map

package/dist/agents/delegate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delegate.d.ts","sourceRoot":"","sources":["../../src/agents/delegate.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAI,MAAM,CAAC;IACpB,OAAO,EAAM,MAAM,CAAC;IACpB,OAAO,EAAM,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,0CAA0C;IAC1C,IAAI,CAAC,EAAQ,MAAM,CAAC;IACpB;;;sDAGkD;IAClD,OAAO,CAAC,EAAK,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAY,OAAO,CAAC;IACtB,6CAA6C;IAC7C,WAAW,EAAG,MAAM,CAAC;IACrB,uDAAuD;IACvD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;gDAC4C;IAC5C,UAAU,CAAC,EAAG,cAAc,CAAC;IAC7B;uBACmB;IACnB,UAAU,CAAC,EAAG,MAAM,CAAC;IACrB;uBACmB;IACnB,SAAS,CAAC,EAAI,MAAM,CAAC;IACrB,UAAU,CAAC,EAAG,MAAM,CAAC;IACrB,yBAAyB;IACzB,KAAK,CAAC,EAAQ,MAAM,CAAC;CACtB;AAED,wBAAsB,eAAe,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,cAAc,CAAC,CAoDjF"}