@nac3/forge-cli 0.2.0-alpha.59z.121 → 0.2.0-alpha.59z.158

package/dist/agents/bridge.d.ts

@@ -0,0 +1,69 @@
+import { type AgentMessage, type AgentPairCap } from './types.js';
+export interface BridgeOpts {
+    /** Override ~/.yujin-forge for tests. */
+    root?: string;
+    /** Override clock for deterministic tests. */
+    now?: () => number;
+    /** Slice 1 of N-projects sprint -- bridge sharding. When set,
+     *  reads/writes `bridge/bridge-{project_slug}.json` instead of
+     *  the global `bridge/bridge.json`. Defaults to 'self' so the
+     *  legacy filename (bridge.json) is preserved byte-for-byte
+     *  whenever no project is specified. */
+    project_slug?: string;
+}
+/** List every shard file present under <root>/bridge. Returns
+ *  pairs {project_slug, file}. Used by Activity / scan endpoints
+ *  to read across all projects without knowing the slug list. */
+export declare function listBridgeShards(opts?: BridgeOpts): Promise<Array<{
+    project_slug: string;
+    file: string;
+}>>;
+export type BridgeErrorCode = 'invalid_slug' | 'sender_not_found' | 'receiver_not_found' | 'acl_denied' | 'token_cap_reached' | 'pair_frozen' | 'pair_auto_revoked';
+export declare class BridgeError extends Error {
+    code: BridgeErrorCode;
+    constructor(code: BridgeErrorCode, message: string);
+}
+export interface SendMessageInput {
+    from_slug: string;
+    to_slug: string;
+    payload: unknown;
+    /** Tokens to charge against the pair cap. Caller estimates +
+     *  the bridge subtracts before persisting. */
+    tokens_used: number;
+    /** Slice 1 N-projects sprint -- which project this message
+     *  belongs to. Defaults to 'self' (legacy single-project mode).
+     *  Drives shard file selection + persists on the message row
+     *  for downstream filtering. */
+    project_slug?: string;
+}
+export interface SendMessageResult {
+    message: AgentMessage;
+    pair_state: AgentPairCap;
+}
+/** Send a message from one agent to another. Runs ACL +
+ *  pair-cap + loop-detector checks. Throws BridgeError when a
+ *  gate trips. The caller -- usually agents/runner.ts during a
+ *  run -- catches and surfaces a graceful failure to the brain. */
+export declare function sendMessage(input: SendMessageInput, opts?: BridgeOpts): Promise<SendMessageResult>;
+export interface DrainResult {
+    drained: AgentMessage[];
+    expired_skipped: number;
+}
+/** Pull pending messages for the given agent. Caps the batch at
+ *  agent.bridge.inbox_drain_batch. Marks every returned message
+ *  delivered_at = now. Expired messages are skipped + counted. */
+export declare function drainInbox(slug: string, opts?: BridgeOpts): Promise<DrainResult>;
+/** Mark a delivered message as read (the receiver processed it). */
+export declare function markRead(messageId: number, opts?: BridgeOpts): Promise<boolean>;
+/** Inspect pair-level state (cap window + loop detector + status). */
+export declare function pairState(a: string, b: string, opts?: BridgeOpts): Promise<AgentPairCap | null>;
+/** Manually re-enable a pair that was auto-revoked. Resets the
+ *  loop counter + token window so the next send starts clean.
+ *  Returns false when the pair has no state yet. */
+export declare function reEnablePair(a: string, b: string, opts?: BridgeOpts): Promise<boolean>;
+/** List ALL messages (debug / panel "audit" view). */
+export declare function listAllMessages(opts?: BridgeOpts): Promise<AgentMessage[]>;
+/** Test helper: wipe the bridge file. NOT exported in package
+ *  index -- only tests import from this file directly. */
+export declare function _resetBridgeForTests(opts?: BridgeOpts): Promise<void>;
+//# sourceMappingURL=bridge.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bridge.d.ts","sourceRoot":"","sources":["../../src/agents/bridge.ts"],"names":[],"mappings":"AAqBA,OAAO,EAEL,KAAK,YAAY,EAA2B,KAAK,YAAY,EAC9D,MAAM,YAAY,CAAC;AAIpB,MAAM,WAAW,UAAU;IACzB,yCAAyC;IACzC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,8CAA8C;IAC9C,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB;;;;4CAIwC;IACxC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AA+BD;;iEAEiE;AACjE,wBAAsB,gBAAgB,CAAC,IAAI,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,KAAK,CAAC;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,CAehH;AAmBD,MAAM,MAAM,eAAe,GACvB,cAAc,GACd,kBAAkB,GAClB,oBAAoB,GACpB,YAAY,GACZ,mBAAmB,GACnB,aAAa,GACb,mBAAmB,CAAC;AAExB,qBAAa,WAAY,SAAQ,KAAK;IACjB,IAAI,EAAE,eAAe;gBAArB,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM;CAI1D;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB;kDAC8C;IAC9C,WAAW,EAAE,MAAM,CAAC;IACpB;;;oCAGgC;IAChC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,YAAY,CAAC;IACtB,UAAU,EAAE,YAAY,CAAC;CAC1B;AAED;;;mEAGmE;AACnE,wBAAsB,WAAW,CAC/B,KAAK,EAAE,gBAAgB,EAAE,IAAI,CAAC,EAAE,UAAU,GACzC,OAAO,CAAC,iBAAiB,CAAC,CA6H5B;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;kEAEkE;AAClE,wBAAsB,UAAU,CAC9B,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,UAAU,GAC9B,OAAO,CAAC,WAAW,CAAC,CA0BtB;AAED,oEAAoE;AACpE,wBAAsB,QAAQ,CAC5B,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,UAAU,GACnC,OAAO,CAAC,OAAO,CAAC,CAUlB;AAED,sEAAsE;AACtE,wBAAsB,SAAS,CAC7B,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,UAAU,GACtC,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAI9B;AAED;;oDAEoD;AACpD,wBAAsB,YAAY,CAChC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,UAAU,GACtC,OAAO,CAAC,OAAO,CAAC,CAgBlB;AAED,sDAAsD;AACtD,wBAAsB,eAAe,CAAC,IAAI,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAGhF;AAED;0DAC0D;AAC1D,wBAAsB,oBAAoB,CAAC,IAAI,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAI3E"}

package/dist/agents/bridge.js

@@ -0,0 +1,295 @@
+/**
+ * Inter-agent bridge (Director sprint slice 2).
+ *
+ * Local-only persistence per D3 decision (see
+ * docs/DIRECTOR_DECISIONS_2026_06_04.md): a single JSON file at
+ * `~/.yujin-forge/bridge/bridge.json` holds the message log +
+ * pair-level cap state. SQLite was specced originally but JSON
+ * has zero native-dep cost (no better-sqlite3 compile per arch)
+ * and is plenty for a single-process Node runtime.
+ *
+ * Read-modify-write is atomic via tmp+rename. Single-process,
+ * no concurrent writers expected (`yf chat` is one process).
+ *
+ * Every cap / window / TTL is read from getAgentConfig(...).
+ * Zero hardcoded numbers per the D2 lock.
+ *
+ * ASCII-only.
+ */
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+import { pairIdFor, isValidAgentSlug, } from './types.js';
+import { getAgentConfig } from './config_resolver.js';
+import { getAgentDefinition } from './store.js';
+const EMPTY_BRIDGE = {
+    version: 1,
+    next_message_id: 1,
+    messages: [],
+    pair_state: {},
+};
+function defaultRoot() {
+    const home = process.env.HOME || process.env.USERPROFILE || os.homedir();
+    return path.join(home, '.yujin-forge');
+}
+function bridgeFile(opts) {
+    const root = opts?.root ?? defaultRoot();
+    /* Sharding by project_slug. 'self' (default) maps to the legacy
+     * filename so existing deployments + tests keep working byte-for-
+     * byte; explicit projects shard into bridge-{slug}.json. */
+    const project = opts?.project_slug || 'self';
+    const filename = project === 'self' ? 'bridge.json' : 'bridge-' + project + '.json';
+    return path.join(root, 'bridge', filename);
+}
+/** List every shard file present under <root>/bridge. Returns
+ *  pairs {project_slug, file}. Used by Activity / scan endpoints
+ *  to read across all projects without knowing the slug list. */
+export async function listBridgeShards(opts) {
+    const root = opts?.root ?? defaultRoot();
+    const dir = path.join(root, 'bridge');
+    const out = [];
+    try {
+        const names = await fs.readdir(dir);
+        for (const n of names) {
+            if (n === 'bridge.json')
+                out.push({ project_slug: 'self', file: path.join(dir, n) });
+            else if (n.startsWith('bridge-') && n.endsWith('.json')) {
+                const slug = n.slice('bridge-'.length, n.length - '.json'.length);
+                if (slug)
+                    out.push({ project_slug: slug, file: path.join(dir, n) });
+            }
+        }
+    }
+    catch { /* dir absent -- ok, no shards */ }
+    return out;
+}
+async function readBridge(opts) {
+    try {
+        const raw = await fs.readFile(bridgeFile(opts), 'utf-8');
+        const parsed = JSON.parse(raw);
+        if (parsed && parsed.version === 1)
+            return parsed;
+    }
+    catch { /* missing or malformed -- start fresh */ }
+    return { ...EMPTY_BRIDGE, messages: [], pair_state: {} };
+}
+async function writeBridge(b, opts) {
+    const file = bridgeFile(opts);
+    await fs.mkdir(path.dirname(file), { recursive: true });
+    const tmp = file + '.tmp';
+    await fs.writeFile(tmp, JSON.stringify(b, null, 2), 'utf-8');
+    await fs.rename(tmp, file);
+}
+export class BridgeError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = 'BridgeError';
+    }
+}
+/** Send a message from one agent to another. Runs ACL +
+ *  pair-cap + loop-detector checks. Throws BridgeError when a
+ *  gate trips. The caller -- usually agents/runner.ts during a
+ *  run -- catches and surfaces a graceful failure to the brain. */
+export async function sendMessage(input, opts) {
+    const now = (opts?.now ?? Date.now)();
+    /* Caller may pass project_slug on the input OR opts; the input
+     * wins for the message row (it's what the agent declared) and
+     * the opts is what selects the shard file. We unify them so a
+     * caller can pass it once on either side. */
+    const effectiveProject = input.project_slug || opts?.project_slug || 'self';
+    const bridgeOpts = { ...opts, project_slug: effectiveProject };
+    if (!isValidAgentSlug(input.from_slug)) {
+        throw new BridgeError('invalid_slug', 'from_slug is not a valid agent slug');
+    }
+    if (!isValidAgentSlug(input.to_slug)) {
+        throw new BridgeError('invalid_slug', 'to_slug is not a valid agent slug');
+    }
+    if (input.from_slug === input.to_slug) {
+        throw new BridgeError('acl_denied', 'an agent cannot message itself');
+    }
+    const root = opts?.root;
+    const fromDef = await getAgentDefinition(input.from_slug, root ? { root } : undefined);
+    if (!fromDef) {
+        throw new BridgeError('sender_not_found', 'from_slug "' + input.from_slug + '" not registered');
+    }
+    const toDef = await getAgentDefinition(input.to_slug, root ? { root } : undefined);
+    if (!toDef) {
+        throw new BridgeError('receiver_not_found', 'to_slug "' + input.to_slug + '" not registered');
+    }
+    /* Two-sided ACL handshake:
+     *   from.can_call must include to (or '*')
+     *   to.can_be_called_by must include from (or '*') */
+    const fromAllowsTo = fromDef.can_call.includes('*') ||
+        fromDef.can_call.includes(input.to_slug);
+    const toAcceptsFrom = toDef.can_be_called_by.includes('*') ||
+        toDef.can_be_called_by.includes(input.from_slug);
+    if (!fromAllowsTo || !toAcceptsFrom) {
+        throw new BridgeError('acl_denied', 'ACL: ' + input.from_slug + ' -> ' + input.to_slug + ' is not whitelisted on both ends');
+    }
+    /* Pair cap + loop detector. */
+    const pairId = pairIdFor(input.from_slug, input.to_slug);
+    const b = await readBridge(bridgeOpts);
+    const tokenCap = await getAgentConfig('agent.bridge.tokens_per_pair_hourly');
+    const rtWindowSeconds = await getAgentConfig('agent.bridge.round_trips_window_seconds');
+    const rtMax = await getAgentConfig('agent.bridge.round_trips_max');
+    const ttlSeconds = await getAgentConfig('agent.bridge.message_ttl_seconds');
+    const existing = b.pair_state[pairId];
+    /* Reset rolling 1h cap window when expired. */
+    const windowMs = 60 * 60 * 1000;
+    const rtWindowMs = rtWindowSeconds * 1000;
+    const fresh = existing
+        ? { ...existing }
+        : {
+            pair_id: pairId,
+            tokens_used_window: 0,
+            window_started_at: now,
+            round_trips_60s: 0,
+            last_round_trip_at: 0,
+            status: 'open',
+        };
+    if (fresh.status === 'auto_revoked') {
+        throw new BridgeError('pair_auto_revoked', 'pair ' + pairId + ' auto-revoked; manual re-enable required');
+    }
+    if (now - fresh.window_started_at > windowMs) {
+        fresh.tokens_used_window = 0;
+        fresh.window_started_at = now;
+        fresh.status = 'open';
+    }
+    if (fresh.tokens_used_window + input.tokens_used > tokenCap) {
+        fresh.status = 'frozen';
+        b.pair_state[pairId] = fresh;
+        await writeBridge(b, bridgeOpts);
+        throw new BridgeError('token_cap_reached', 'pair ' + pairId + ' hit token cap (' + tokenCap + ') in current 1h window');
+    }
+    /* Round-trip loop check: a round trip is from->to followed by
+     * to->from inside the window. We count direction flips by
+     * peeking at the most recent message on this pair. */
+    const lastOnPair = [...b.messages].reverse().find((m) => m.pair_id === pairId);
+    if (lastOnPair && lastOnPair.to_slug === input.from_slug) {
+        /* A reply to the previous message = one round trip. */
+        if (now - fresh.last_round_trip_at <= rtWindowMs) {
+            fresh.round_trips_60s += 1;
+        }
+        else {
+            fresh.round_trips_60s = 1;
+        }
+        fresh.last_round_trip_at = now;
+        if (fresh.round_trips_60s >= rtMax) {
+            fresh.status = 'auto_revoked';
+            b.pair_state[pairId] = fresh;
+            await writeBridge(b, bridgeOpts);
+            throw new BridgeError('pair_auto_revoked', 'pair ' + pairId + ' tripped loop detector ('
+                + fresh.round_trips_60s + ' round trips in '
+                + rtWindowSeconds + 's window). Auto-revoked.');
+        }
+    }
+    /* All checks passed. Append the message + update pair state. */
+    fresh.tokens_used_window += input.tokens_used;
+    const msg = {
+        id: b.next_message_id,
+        pair_id: pairId,
+        from_slug: input.from_slug,
+        to_slug: input.to_slug,
+        payload: input.payload,
+        tokens_used: input.tokens_used,
+        status: 'pending',
+        created_at: now,
+        expires_at: now + ttlSeconds * 1000,
+        project_slug: effectiveProject,
+    };
+    b.next_message_id += 1;
+    b.messages.push(msg);
+    b.pair_state[pairId] = fresh;
+    await writeBridge(b, bridgeOpts);
+    return { message: msg, pair_state: fresh };
+}
+/** Pull pending messages for the given agent. Caps the batch at
+ *  agent.bridge.inbox_drain_batch. Marks every returned message
+ *  delivered_at = now. Expired messages are skipped + counted. */
+export async function drainInbox(slug, opts) {
+    if (!isValidAgentSlug(slug)) {
+        throw new BridgeError('invalid_slug', 'invalid slug');
+    }
+    const now = (opts?.now ?? Date.now)();
+    const batchLimit = await getAgentConfig('agent.bridge.inbox_drain_batch');
+    const b = await readBridge(opts);
+    const drained = [];
+    let expired_skipped = 0;
+    for (const m of b.messages) {
+        if (m.to_slug !== slug)
+            continue;
+        if (m.status !== 'pending')
+            continue;
+        if (m.expires_at <= now) {
+            m.status = 'expired';
+            expired_skipped += 1;
+            continue;
+        }
+        if (drained.length >= batchLimit)
+            break;
+        m.status = 'delivered';
+        m.delivered_at = now;
+        drained.push(m);
+    }
+    if (drained.length > 0 || expired_skipped > 0) {
+        await writeBridge(b, opts);
+    }
+    return { drained, expired_skipped };
+}
+/** Mark a delivered message as read (the receiver processed it). */
+export async function markRead(messageId, opts) {
+    const now = (opts?.now ?? Date.now)();
+    const b = await readBridge(opts);
+    const m = b.messages.find((x) => x.id === messageId);
+    if (!m)
+        return false;
+    if (m.status !== 'delivered' && m.status !== 'pending')
+        return false;
+    m.status = 'read';
+    m.read_at = now;
+    await writeBridge(b, opts);
+    return true;
+}
+/** Inspect pair-level state (cap window + loop detector + status). */
+export async function pairState(a, b, opts) {
+    const pid = pairIdFor(a, b);
+    const file = await readBridge(opts);
+    return file.pair_state[pid] ?? null;
+}
+/** Manually re-enable a pair that was auto-revoked. Resets the
+ *  loop counter + token window so the next send starts clean.
+ *  Returns false when the pair has no state yet. */
+export async function reEnablePair(a, b, opts) {
+    const pid = pairIdFor(a, b);
+    const now = (opts?.now ?? Date.now)();
+    const file = await readBridge(opts);
+    const existing = file.pair_state[pid];
+    if (!existing)
+        return false;
+    file.pair_state[pid] = {
+        pair_id: pid,
+        tokens_used_window: 0,
+        window_started_at: now,
+        round_trips_60s: 0,
+        last_round_trip_at: 0,
+        status: 'open',
+    };
+    await writeBridge(file, opts);
+    return true;
+}
+/** List ALL messages (debug / panel "audit" view). */
+export async function listAllMessages(opts) {
+    const b = await readBridge(opts);
+    return b.messages.slice();
+}
+/** Test helper: wipe the bridge file. NOT exported in package
+ *  index -- only tests import from this file directly. */
+export async function _resetBridgeForTests(opts) {
+    try {
+        await fs.rm(bridgeFile(opts), { force: true });
+    }
+    catch { /* ignore */ }
+}
+//# sourceMappingURL=bridge.js.map

package/dist/agents/bridge.js.map

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

package/dist/agents/cli_real.d.ts

@@ -0,0 +1,38 @@
+/**
+ * `yf agent run --real` helper (Director closure pendiente 1).
+ *
+ * Resolves the production wiring (Claude client + runtime +
+ * factory) so the CLI subcommand stays thin + tests can inject
+ * fakes for any of them.
+ *
+ * ASCII-only.
+ */
+import type { AgentDefinition } from './types.js';
+import type { StepFn } from './runner.js';
+import type { Runtime } from './runtime.js';
+import { ClaudeClient } from '../chat/claude.js';
+interface MakeRealStepOpts {
+    def: AgentDefinition;
+    trigger_reason: string;
+    project_root: string;
+    project_name: string;
+    forge_version: string;
+    /** Inject a different Claude client (tests). When unset, the
+     *  real ClaudeClient is constructed from the vault. */
+    claude?: ConstructorParameters<typeof ClaudeClient>[0] extends infer P ? P extends void | undefined ? import('../chat/claude.js').ClaudeClient : import('../chat/claude.js').ClaudeClient : import('../chat/claude.js').ClaudeClient;
+    runtime?: Runtime;
+    /** Where the bridge persists. Tests pass tmp; production lets
+     *  it resolve to ~/.yujin-forge/bridge. */
+    bridge_root?: string;
+}
+export interface CliRealError extends Error {
+    code: 'no_claude_key' | 'unknown';
+}
+/**
+ * Build the live StepFn the runner will execute. Returns the
+ * StepFn directly; the caller (the CLI subcommand) wraps it with
+ * `runAgent(def, {step, ...})`.
+ */
+export declare function makeRealStep(opts: MakeRealStepOpts): Promise<StepFn>;
+export {};
+//# sourceMappingURL=cli_real.d.ts.map

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_schema.d.ts

@@ -20,7 +20,7 @@
  * 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.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 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;

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

@@ -1 +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,GAEhC,kDAAkD,GAClD,mCAAmC,GAEnC,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,EAgGtD,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"}
+{"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

@@ -81,6 +81,22 @@ export const AGENT_CONFIG_SCHEMA = [
         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',

package/dist/agents/config_schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"config_schema.js","sourceRoot":"","sources":["../../src/agents/config_schema.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"config_schema.js","sourceRoot":"","sources":["../../src/agents/config_schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAsCH;;;iBAGiB;AACjB,MAAM,CAAC,MAAM,mBAAmB,GAAqC;IACnE;QACE,GAAG,EAAU,qCAAqC;QAClD,IAAI,EAAS,QAAQ;QACrB,OAAO,EAAM,OAAO;QACpB,WAAW,EAAE,yKAAyK;QACtL,GAAG,EAAU,KAAK;QAClB,GAAG,EAAU,UAAU;KACxB;IACD;QACE,GAAG,EAAU,yCAAyC;QACtD,IAAI,EAAS,QAAQ;QACrB,OAAO,EAAM,EAAE;QACf,WAAW,EAAE,2HAA2H;QACxI,GAAG,EAAU,EAAE;QACf,GAAG,EAAU,IAAI;KAClB;IACD;QACE,GAAG,EAAU,8BAA8B;QAC3C,IAAI,EAAS,QAAQ;QACrB,OAAO,EAAM,EAAE;QACf,WAAW,EAAE,+IAA+I;QAC5J,GAAG,EAAU,CAAC;QACd,GAAG,EAAU,IAAI;KAClB;IACD;QACE,GAAG,EAAU,kCAAkC;QAC/C,IAAI,EAAS,QAAQ;QACrB,OAAO,EAAM,MAAM;QACnB,WAAW,EAAE,wGAAwG;QACrH,GAAG,EAAU,EAAE;QACf,GAAG,EAAU,SAAS,EAAE,aAAa;KACtC;IACD;QACE,GAAG,EAAU,gCAAgC;QAC7C,IAAI,EAAS,QAAQ;QACrB,OAAO,EAAM,EAAE;QACf,WAAW,EAAE,qHAAqH;QAClI,GAAG,EAAU,CAAC;QACd,GAAG,EAAU,IAAI;KAClB;IACD;QACE,GAAG,EAAU,kDAAkD;QAC/D,IAAI,EAAS,QAAQ;QACrB,OAAO,EAAM,CAAC;QACd,WAAW,EAAE,gGAAgG;QAC7G,GAAG,EAAU,CAAC;QACd,GAAG,EAAU,GAAG;KACjB;IACD;QACE,GAAG,EAAU,mCAAmC;QAChD,IAAI,EAAS,QAAQ;QACrB,OAAO,EAAM,IAAI,EAAE,YAAY;QAC/B,WAAW,EAAE,0FAA0F;QACvG,GAAG,EAAU,EAAE;QACf,GAAG,EAAU,MAAM;KACpB;IACD;QACE,GAAG,EAAU,0CAA0C;QACvD,IAAI,EAAS,QAAQ;QACrB,OAAO,EAAM,CAAC;QACd,WAAW,EAAE,+RAA+R;QAC5S,GAAG,EAAU,CAAC;QACd,GAAG,EAAU,GAAG;KACjB;IACD;QACE,GAAG,EAAU,+CAA+C;QAC5D,IAAI,EAAS,QAAQ;QACrB,OAAO,EAAM,CAAC;QACd,WAAW,EAAE,sOAAsO;QACnP,GAAG,EAAU,CAAC;QACd,GAAG,EAAU,GAAG;KACjB;IACD;QACE,GAAG,EAAU,0CAA0C;QACvD,IAAI,EAAS,QAAQ;QACrB,OAAO,EAAM,CAAC;QACd,WAAW,EAAE,iKAAiK;QAC9K,GAAG,EAAU,CAAC;QACd,GAAG,EAAU,GAAG;KACjB;IACD;QACE,GAAG,EAAU,4BAA4B;QACzC,IAAI,EAAS,QAAQ;QACrB,OAAO,EAAM,EAAE;QACf,WAAW,EAAE,gGAAgG;QAC7G,GAAG,EAAU,CAAC;QACd,GAAG,EAAU,IAAI;KAClB;IACD;QACE,GAAG,EAAU,kCAAkC;QAC/C,IAAI,EAAS,QAAQ;QACrB,OAAO,EAAM,EAAE;QACf,WAAW,EAAE,yHAAyH;QACtI,GAAG,EAAU,CAAC;QACd,GAAG,EAAU,IAAI;KAClB;IACD;QACE,GAAG,EAAU,2BAA2B;QACxC,IAAI,EAAS,QAAQ;QACrB,OAAO,EAAM,OAAO;QACpB,WAAW,EAAE,mIAAmI;QAChJ,IAAI,EAAS,CAAC,OAAO,EAAE,QAAQ,EAAE,QAAQ,CAAU;KACpD;IACD;QACE,GAAG,EAAU,kCAAkC;QAC/C,IAAI,EAAS,QAAQ;QACrB,OAAO,EAAM,GAAG;QAChB,WAAW,EAAE,wHAAwH;QACrI,GAAG,EAAU,CAAC;QACd,GAAG,EAAU,OAAO;KACrB;CACO,CAAC;AAEX,0BAA0B;AAC1B,MAAM,aAAa,GAAkD,CAAC,GAAG,EAAE;IACzE,MAAM,GAAG,GAAG,EAAmD,CAAC;IAChE,KAAK,MAAM,CAAC,IAAI,mBAAmB,EAAE,CAAC;QACpC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACjB,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC,CAAC,EAAE,CAAC;AAEL,MAAM,UAAU,wBAAwB,CAAC,GAAmB;IAC1D,MAAM,CAAC,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;IAC7B,IAAI,CAAC,CAAC,EAAE,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,4BAA4B,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9D,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,GAAmB;IACvD,OAAO,wBAAwB,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC;AAC/C,CAAC;AAED;;0CAE0C;AAC1C,MAAM,UAAU,wBAAwB,CACtC,GAAmB,EACnB,GAAY;IAEZ,MAAM,CAAC,GAAG,wBAAwB,CAAC,GAAG,CAAC,CAAC;IACxC,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC;QACf,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,MAAM,CAAC,GAAG,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACtD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;gBACxB,MAAM,IAAI,KAAK,CAAC,eAAe,GAAG,GAAG,GAAG,yBAAyB,GAAG,OAAO,GAAG,CAAC,CAAC;YAClF,CAAC;YACD,IAAI,CAAC,CAAC,GAAG,KAAK,SAAS,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC;gBACrC,MAAM,IAAI,KAAK,CAAC,eAAe,GAAG,GAAG,GAAG,cAAc,GAAG,CAAC,CAAC,GAAG,GAAG,SAAS,GAAG,CAAC,CAAC,CAAC;YAClF,CAAC;YACD,IAAI,CAAC,CAAC,GAAG,KAAK,SAAS,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC;gBACrC,MAAM,IAAI,KAAK,CAAC,eAAe,GAAG,GAAG,GAAG,cAAc,GAAG,CAAC,CAAC,GAAG,GAAG,SAAS,GAAG,CAAC,CAAC,CAAC;YAClF,CAAC;YACD,OAAO,CAAC,CAAC;QACX,CAAC;QACD,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;YACtB,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;gBAClC,MAAM,IAAI,KAAK,CAAC,eAAe,GAAG,GAAG,GAAG,mBAAmB,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;YACnH,CAAC;YACD,OAAO,CAAC,CAAC;QACX,CAAC;QACD,KAAK,SAAS,CAAC,CAAC,CAAC;YACf,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,GAAG,KAAK,GAAG;gBAAE,OAAO,IAAI,CAAC;YAC5E,IAAI,GAAG,KAAK,KAAK,IAAI,GAAG,KAAK,OAAO,IAAI,GAAG,KAAK,CAAC,IAAI,GAAG,KAAK,GAAG;gBAAE,OAAO,KAAK,CAAC;YAC/E,MAAM,IAAI,KAAK,CAAC,eAAe,GAAG,GAAG,GAAG,0BAA0B,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC;QAC5F,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;qDAGqD;AACrD,MAAM,UAAU,uBAAuB;IACrC,MAAM,GAAG,GAA8C,EAAE,CAAC;IAC1D,KAAK,MAAM,CAAC,IAAI,mBAAmB,EAAE,CAAC;QACpC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC;IACzB,CAAC;IACD,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AACtC,CAAC;AAED;;qCAEqC;AACrC,MAAM,UAAU,wBAAwB;IACtC,MAAM,IAAI,GAAG,mBAAmB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACzC,MAAM,MAAM,GAAG,CAAC,CAAC,IAAI,KAAK,QAAQ;YAChC,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,GAAG,GAAG;YAC5D,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,YAAY,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAC3D,OAAO,KAAK,GAAG,CAAC,CAAC,GAAG,GAAG,MAAM,GAAG,CAAC,CAAC,IAAI,GAAG,MAAM,GAAG,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,KAAK,GAAG,CAAC,CAAC,WAAW,GAAG,IAAI,CAAC;IACrH,CAAC,CAAC,CAAC;IACH,OAAO;QACL,wCAAwC;QACxC,mBAAmB;QACnB,GAAG,IAAI;KACR,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}

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

@@ -1 +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;AAEF,eAAO,MAAM,cAAc,EAAE,SAAS,eAAe,EAGpD,CAAC"}
+{"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.map

@@ -1 +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;AAEF,MAAM,CAAC,MAAM,cAAc,GAA+B;IACxD,4BAA4B;IAC5B,gBAAgB;CACjB,CAAC"}
+{"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"}