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

package/dist/agents/real_step_factory.js

@@ -0,0 +1,51 @@
+import { buildIterativeLlmStep } from './iterative_step.js';
+import { delegateToAgent } from './delegate.js';
+export function buildAgentStepFactory(opts) {
+    return (def, trigger_reason) => {
+        /* Wire the delegate callback only when a runtime is provided.
+         * Without a runtime, yujin.agent.delegate falls through to the
+         * runNac3Invoke path (which the chat server may handle via a
+         * server-side handler, or which simply 404s). */
+        let delegate;
+        if (opts.runtime) {
+            const runtime = opts.runtime;
+            const bridgeRoot = opts.bridge_root;
+            delegate = async (to_slug, payload) => {
+                const r = await delegateToAgent({
+                    from_slug: def.slug,
+                    to_slug,
+                    payload,
+                    tokens_used: Math.ceil(payload.length / 4),
+                    root: bridgeRoot,
+                    runtime,
+                });
+                return {
+                    ok: r.ok,
+                    target_slug: r.target_slug,
+                    run_status: r.run_status,
+                    last_reply: r.last_reply,
+                    tokens_in: r.tokens_in,
+                    tokens_out: r.tokens_out,
+                    error: r.error,
+                };
+            };
+        }
+        return buildIterativeLlmStep({
+            def,
+            claude: opts.claude,
+            runNac3Invoke: opts.runNac3Invoke,
+            project_root: opts.project_root,
+            project_name: opts.project_name,
+            forge_version: opts.forge_version,
+            trigger_reason,
+            graph_snapshot_section: opts.graph_snapshot_section,
+            workflow_section: opts.workflow_section,
+            nac3_ctx: opts.nac3_ctx,
+            legacy_run: opts.legacy_run,
+            delegate,
+            conversation_id: opts.conversation_id,
+            conversation_root: opts.conversation_root,
+        });
+    };
+}
+//# sourceMappingURL=real_step_factory.js.map

package/dist/agents/real_step_factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"real_step_factory.js","sourceRoot":"","sources":["../../src/agents/real_step_factory.ts"],"names":[],"mappings":"AAwBA,OAAO,EAAE,qBAAqB,EAAmB,MAAM,qBAAqB,CAAC;AAC7E,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAqDhD,MAAM,UAAU,qBAAqB,CAAC,IAA0B;IAC9D,OAAO,CAAC,GAAoB,EAAE,cAAsB,EAAU,EAAE;QAC9D;;;yDAGiD;QACjD,IAAI,QAAgC,CAAC;QACrC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;YAC7B,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,CAAC;YACpC,QAAQ,GAAG,KAAK,EAAE,OAAe,EAAE,OAAe,EAAE,EAAE;gBACpD,MAAM,CAAC,GAAG,MAAM,eAAe,CAAC;oBAC9B,SAAS,EAAI,GAAG,CAAC,IAAI;oBACrB,OAAO;oBACP,OAAO;oBACP,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;oBAC1C,IAAI,EAAS,UAAU;oBACvB,OAAO;iBACR,CAAC,CAAC;gBACH,OAAO;oBACL,EAAE,EAAY,CAAC,CAAC,EAAE;oBAClB,WAAW,EAAG,CAAC,CAAC,WAAW;oBAC3B,UAAU,EAAI,CAAC,CAAC,UAAU;oBAC1B,UAAU,EAAI,CAAC,CAAC,UAAU;oBAC1B,SAAS,EAAK,CAAC,CAAC,SAAS;oBACzB,UAAU,EAAI,CAAC,CAAC,UAAU;oBAC1B,KAAK,EAAS,CAAC,CAAC,KAAK;iBACtB,CAAC;YACJ,CAAC,CAAC;QACJ,CAAC;QAED,OAAO,qBAAqB,CAAC;YAC3B,GAAG;YACH,MAAM,EAAkB,IAAI,CAAC,MAAM;YACnC,aAAa,EAAW,IAAI,CAAC,aAAa;YAC1C,YAAY,EAAY,IAAI,CAAC,YAAY;YACzC,YAAY,EAAY,IAAI,CAAC,YAAY;YACzC,aAAa,EAAW,IAAI,CAAC,aAAa;YAC1C,cAAc;YACd,sBAAsB,EAAE,IAAI,CAAC,sBAAsB;YACnD,gBAAgB,EAAQ,IAAI,CAAC,gBAAgB;YAC7C,QAAQ,EAAgB,IAAI,CAAC,QAAQ;YACrC,UAAU,EAAc,IAAI,CAAC,UAAU;YACvC,QAAQ;YACR,eAAe,EAAS,IAAI,CAAC,eAAe;YAC5C,iBAAiB,EAAO,IAAI,CAAC,iBAAiB;SAC/C,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC"}

package/dist/agents/runner.d.ts

@@ -0,0 +1,108 @@
+/**
+ * Agent runner (HITO 5 slice 4).
+ *
+ * Drives a single agent through one execution attempt:
+ *   1. Read config (timeout, max rejected approvals).
+ *   2. Loop: call the injected `step` function, accumulate
+ *      tokens/tool_calls/rejected_approvals.
+ *   3. Watch for kill conditions (timeout, max rejections,
+ *      external kill signal, step returning done=true).
+ *   4. Persist the final AgentRun via the store.
+ *
+ * The `step` function is injected -- this slice does NOT call
+ * the brain directly. Slice 5 wires `step` to the real brain
+ * dispatch (cost router, tool catalog, manifest filtering).
+ * Keeping it injected here makes the runner unit-testable
+ * without LLM calls.
+ *
+ * Per HITO 5 lock 2026-06-04: NO hardcoded numbers. Every
+ * threshold comes from getAgentConfig().
+ */
+import type { AgentDefinition, AgentRun, AgentRunStatus, AgentTriggerKind } from './types.js';
+/** State passed to the injected step function each iteration. */
+export interface RunState {
+    iteration: number;
+    tokens_in: number;
+    tokens_out: number;
+    tool_calls: number;
+    consecutive_rejected: number;
+    last_reply: string;
+    /** Wall-clock ms since run start. The step function can use
+     *  this to back off / take checkpoints. */
+    elapsed_ms: number;
+}
+/** Result returned by one step. */
+export interface StepResult {
+    /** Free-text reply the step produced (the brain's chat output). */
+    text?: string;
+    /** Tokens consumed THIS step (added to running totals). */
+    tokens_in?: number;
+    tokens_out?: number;
+    /** Tool calls THIS step made. */
+    tool_calls?: number;
+    /** True iff this step's approval was rejected. Increments the
+     *  consecutive_rejected counter; an accepted (or no-approval)
+     *  step resets it to 0. */
+    rejected_approval?: boolean;
+    /** True iff the step says "I am done, stop looping". */
+    done?: boolean;
+    /** Director sprint slice 15c -- set when one of the nac3_invoke
+     *  tool results carried `nac3_panel_approval_required:true`. The
+     *  runner records it in the AgentRun so the panel / CLI can
+     *  surface "waiting for user". Resumption happens through
+     *  /api/agent/approve (slice 10), not by re-entering this run. */
+    pending_approval?: boolean;
+}
+export type StepFn = (state: RunState) => Promise<StepResult>;
+export interface RunAgentOptions {
+    trigger_kind: AgentTriggerKind;
+    trigger_reason: string;
+    /** Injected step function. Slice 5 wires this to the real
+     *  brain dispatch. Slice 4 + tests inject mocks. */
+    step: StepFn;
+    /** External kill signal. If the AbortController is aborted
+     *  during a run, the next step boundary returns
+     *  status='killed_user'. */
+    abort?: AbortSignal;
+    /** Override `agent.runtime.run_timeout_seconds` for this call.
+     *  Tests use it; production callers should let config resolve. */
+    timeout_seconds_override?: number;
+    /** Override `agent.runtime.max_consecutive_rejected_approvals`
+     *  for this call. Same constraint as above. */
+    max_rejected_override?: number;
+    /** Hard cap on iterations regardless of timeout. Prevents an
+     *  infinite-loop step from running forever even if it claims
+     *  not done. Default 100; configurable per-call. */
+    max_iterations?: number;
+    /** Persist the resulting AgentRun via the store. Default true.
+     *  Tests pass false to keep the filesystem clean. */
+    persist?: boolean;
+    /** Director sprint phase II, slice 11 -- the project graph
+     *  snapshot section the LLM step will splice into the agent's
+     *  system prompt. The runner does NOT build the section itself
+     *  to keep this layer agnostic; the caller (chat server / CLI)
+     *  builds it via buildGraphSnapshotSection + filterSnapshotForRole
+     *  and hands the rendered text in. Empty string = no panorama
+     *  (graceful no-op). */
+    graph_snapshot_section?: string;
+}
+/** Run one agent through its lifecycle. */
+export declare function runAgent(def: AgentDefinition, opts: RunAgentOptions): Promise<AgentRun>;
+declare function runWithoutId(run: AgentRun): {
+    trigger_kind: AgentTriggerKind;
+    trigger_reason: string;
+    started_at: number;
+    ended_at: number | undefined;
+    status: AgentRunStatus;
+    tokens_in: number;
+    tokens_out: number;
+    tool_calls: number;
+    rejected_approvals: number;
+    last_reply_summary: string;
+    kill_reason: string | undefined;
+};
+export declare const __internals: {
+    runWithoutId: typeof runWithoutId;
+};
+export {};
+//# sourceMappingURL=runner.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/agents/runner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,QAAQ,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAI9F,iEAAiE;AACjE,MAAM,WAAW,QAAQ;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB;+CAC2C;IAC3C,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,mCAAmC;AACnC,MAAM,WAAW,UAAU;IACzB,mEAAmE;IACnE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,2DAA2D;IAC3D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iCAAiC;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;+BAE2B;IAC3B,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,wDAAwD;IACxD,IAAI,CAAC,EAAE,OAAO,CAAC;IACf;;;;sEAIkE;IAClE,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,MAAM,MAAM,GAAG,CAAC,KAAK,EAAE,QAAQ,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;AAE9D,MAAM,WAAW,eAAe;IAC9B,YAAY,EAAE,gBAAgB,CAAC;IAC/B,cAAc,EAAE,MAAM,CAAC;IACvB;wDACoD;IACpD,IAAI,EAAE,MAAM,CAAC;IACb;;gCAE4B;IAC5B,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB;sEACkE;IAClE,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC;mDAC+C;IAC/C,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B;;wDAEoD;IACpD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;yDACqD;IACrD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;;;4BAMwB;IACxB,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACjC;AAqBD,2CAA2C;AAC3C,wBAAsB,QAAQ,CAC5B,GAAG,EAAE,eAAe,EACpB,IAAI,EAAE,eAAe,GACpB,OAAO,CAAC,QAAQ,CAAC,CA2InB;AAID,iBAAS,YAAY,CAAC,GAAG,EAAE,QAAQ;;;;;;;;;;;;EAclC;AAGD,eAAO,MAAM,WAAW;;CAAmB,CAAC"}

package/dist/agents/runner.js

@@ -0,0 +1,174 @@
+import { appendAgentRun } from './store.js';
+import { getAgentConfig } from './config_resolver.js';
+/** Single source of truth for run termination. */
+function kill(reason, status, state, startedAt) {
+    return {
+        id: 'run-' + startedAt.toString(36) + '-' + Math.random().toString(36).slice(2, 8),
+        slug: 'placeholder', /* caller fills in before persist */
+        trigger_kind: 'manual',
+        trigger_reason: 'placeholder',
+        started_at: startedAt,
+        ended_at: Date.now(),
+        status,
+        tokens_in: state.tokens_in,
+        tokens_out: state.tokens_out,
+        tool_calls: state.tool_calls,
+        rejected_approvals: state.consecutive_rejected,
+        last_reply_summary: state.last_reply.slice(0, 500),
+        kill_reason: reason,
+    };
+}
+/** Run one agent through its lifecycle. */
+export async function runAgent(def, opts) {
+    const startedAt = Date.now();
+    /* Resolve config (or use overrides for tests). */
+    const timeoutSeconds = opts.timeout_seconds_override
+        ?? (await getAgentConfig('agent.runtime.run_timeout_seconds'));
+    const maxRejected = opts.max_rejected_override
+        ?? (await getAgentConfig('agent.runtime.max_consecutive_rejected_approvals'));
+    const maxIterations = opts.max_iterations ?? 100;
+    const persist = opts.persist ?? true;
+    const state = {
+        iteration: 0,
+        tokens_in: 0,
+        tokens_out: 0,
+        tool_calls: 0,
+        consecutive_rejected: 0,
+        last_reply: '',
+        elapsed_ms: 0,
+    };
+    /* Check status pre-flight: paused / deleted / auto-revoked
+     *  agents do not run. */
+    if (def.status !== 'active') {
+        const run = {
+            id: 'run-' + startedAt.toString(36) + '-' + Math.random().toString(36).slice(2, 8),
+            slug: def.slug,
+            trigger_kind: opts.trigger_kind,
+            trigger_reason: opts.trigger_reason,
+            started_at: startedAt,
+            ended_at: Date.now(),
+            status: 'failed',
+            tokens_in: 0,
+            tokens_out: 0,
+            tool_calls: 0,
+            rejected_approvals: 0,
+            last_reply_summary: '',
+            kill_reason: 'agent_status_' + def.status,
+        };
+        if (persist)
+            await appendAgentRun(def.slug, runWithoutId(run), {});
+        return run;
+    }
+    let finalStatus = 'failed';
+    let killReason;
+    try {
+        for (state.iteration = 0; state.iteration < maxIterations; state.iteration++) {
+            state.elapsed_ms = Date.now() - startedAt;
+            /* Timeout */
+            if (state.elapsed_ms / 1000 >= timeoutSeconds) {
+                finalStatus = 'timeout';
+                killReason = 'run_timeout_seconds=' + timeoutSeconds + ' exceeded';
+                break;
+            }
+            /* External kill signal */
+            if (opts.abort?.aborted) {
+                finalStatus = 'killed_user';
+                killReason = 'abort signal received';
+                break;
+            }
+            /* Run one step */
+            let result;
+            try {
+                result = await opts.step(state);
+            }
+            catch (err) {
+                finalStatus = 'failed';
+                killReason = err instanceof Error ? err.message : String(err);
+                break;
+            }
+            /* Apply telemetry */
+            state.tokens_in += result.tokens_in ?? 0;
+            state.tokens_out += result.tokens_out ?? 0;
+            state.tool_calls += result.tool_calls ?? 0;
+            if (result.text !== undefined)
+                state.last_reply = result.text;
+            if (result.rejected_approval) {
+                state.consecutive_rejected++;
+            }
+            else {
+                state.consecutive_rejected = 0;
+            }
+            /* Max consecutive rejections */
+            if (state.consecutive_rejected >= maxRejected) {
+                finalStatus = 'killed_rejections';
+                killReason = state.consecutive_rejected + ' consecutive rejected approvals (max=' + maxRejected + ')';
+                break;
+            }
+            /* Step says done */
+            if (result.done) {
+                /* Director closure pendiente 3 -- when the step surfaces
+                 * pending_approval, the run is concluded but the agent
+                 * is WAITING for the user to resolve via the R8 modal /
+                 * POST /api/agent/approve. The status distinguishes this
+                 * from a clean succeeded run so the panel + CLI can show
+                 * a different visual state. */
+                finalStatus = result.pending_approval ? 'paused_for_approval' : 'succeeded';
+                if (result.pending_approval) {
+                    killReason = 'pending R8 approval -- resolve via /api/agent/approve';
+                }
+                break;
+            }
+        }
+        /* Loop exhausted without done: treat as success if no other
+         *  termination already fired (the step just kept going).
+         *  Operators can crank max_iterations if they need more. */
+        if (state.iteration >= maxIterations && finalStatus === 'failed') {
+            finalStatus = 'succeeded';
+            killReason = 'max_iterations reached (' + maxIterations + ')';
+        }
+    }
+    catch (err) {
+        /* This catches errors from outside opts.step -- config
+         *  resolver failures, etc. Step errors are caught above. */
+        finalStatus = 'failed';
+        killReason = err instanceof Error ? err.message : String(err);
+    }
+    const run = {
+        id: 'run-' + startedAt.toString(36) + '-' + Math.random().toString(36).slice(2, 8),
+        slug: def.slug,
+        trigger_kind: opts.trigger_kind,
+        trigger_reason: opts.trigger_reason,
+        started_at: startedAt,
+        ended_at: Date.now(),
+        status: finalStatus,
+        tokens_in: state.tokens_in,
+        tokens_out: state.tokens_out,
+        tool_calls: state.tool_calls,
+        rejected_approvals: state.consecutive_rejected,
+        last_reply_summary: state.last_reply.slice(0, 500),
+        kill_reason: killReason,
+    };
+    if (persist)
+        await appendAgentRun(def.slug, runWithoutId(run), {});
+    return run;
+}
+/* Strip id+slug for the store's `Omit<AgentRun, 'id' | 'slug'>`
+ * input shape. The store generates a fresh id if absent. */
+function runWithoutId(run) {
+    return {
+        trigger_kind: run.trigger_kind,
+        trigger_reason: run.trigger_reason,
+        started_at: run.started_at,
+        ended_at: run.ended_at,
+        status: run.status,
+        tokens_in: run.tokens_in,
+        tokens_out: run.tokens_out,
+        tool_calls: run.tool_calls,
+        rejected_approvals: run.rejected_approvals,
+        last_reply_summary: run.last_reply_summary,
+        kill_reason: run.kill_reason,
+    };
+}
+/* Suppress the lint about runWithoutId being unused-once. */
+export const __internals = { runWithoutId };
+//# sourceMappingURL=runner.js.map

package/dist/agents/runner.js.map

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

package/dist/agents/runtime.d.ts

@@ -0,0 +1,115 @@
+import type { AgentRun, AgentRunStatus } from './types.js';
+export type RuntimeEvent = {
+    kind: 'agent_run_started';
+    slug: string;
+    trigger_reason: string;
+    at: number;
+    project_slug?: string;
+} | {
+    kind: 'agent_run_finished';
+    slug: string;
+    run_id: string;
+    status: AgentRunStatus;
+    at: number;
+    project_slug?: string;
+} | {
+    kind: 'agent_run_skipped';
+    slug: string;
+    reason: string;
+    at: number;
+    project_slug?: string;
+} | {
+    kind: 'bridge_drain';
+    slug: string;
+    message_count: number;
+    at: number;
+    project_slug?: string;
+}
+/** Director closure pendiente 5 followup -- emitted by the server
+ *  /api/agent/approve handler when a pending R8 approval row
+ *  resolves AND the row carries an agent_slug. The panel uses
+ *  this to clear the persistent .paused-for-approval marker on
+ *  the SVG node WITHOUT waiting for a new run to start. */
+ | {
+    kind: 'agent_run_paused_resolved';
+    slug: string;
+    trace_id: string;
+    decision: 'approved' | 'rejected';
+    at: number;
+    project_slug?: string;
+}
+/** Slice 2 of N-projects sprint -- emitted when a dispatch hits
+ *  the global or per-project semaphore and the caller has to
+ *  wait. The Activity panel surfaces this as a throttle badge
+ *  so the operator understands why a click did not fire
+ *  instantly. `cap` is the limit that tripped; `running` is
+ *  the live counter for that scope at the moment of throttle. */
+ | {
+    kind: 'agent_run_throttled';
+    slug: string;
+    project_slug?: string;
+    scope: 'global' | 'per_project';
+    running: number;
+    cap: number;
+    at: number;
+} | {
+    kind: 'tick';
+    at: number;
+};
+/** Slice 1 of N-projects sprint -- dispatch options.
+ *  project_slug defaults to 'self' (single-project legacy mode).
+ *  Callers that know the project (CLI, Activity inject endpoint,
+ *  panel switcher) pass an explicit slug. */
+export interface DispatchOpts {
+    project_slug?: string;
+}
+export type RunnerFn = (slug: string, trigger_reason: string, opts?: DispatchOpts) => Promise<AgentRun>;
+export interface RuntimeOpts {
+    /** Override ~/.yujin-forge for tests. */
+    root?: string;
+    /** Override Date.now for deterministic tests. */
+    clock?: () => number;
+    /** Inject the runner (real or stub). When omitted, falls back
+     *  to the canonical src/agents/runner.ts (dynamic import to
+     *  avoid pulling Anthropic deps in tests). */
+    runner?: RunnerFn;
+    /** Tick cadence in ms. Defaults to 5000ms. */
+    tickIntervalMs?: number;
+}
+export interface RuntimeStatus {
+    running: boolean;
+    tick_interval_ms: number;
+    last_tick_at: number | null;
+    /** Slice 2 of N-projects sprint -- live concurrency snapshot. */
+    concurrency: {
+        /** Total runs in-flight (sum across all projects). */
+        global_running: number;
+        /** Cap for global runs (config: agent.runtime.max_concurrent_runs_global). */
+        global_max: number;
+        /** Per-project running counters keyed by project_slug. */
+        per_project_running: Record<string, number>;
+        /** Cap per project (config: agent.runtime.max_concurrent_runs_per_project). */
+        per_project_max: number;
+    };
+}
+export interface Runtime {
+    start(): void;
+    stop(): Promise<void>;
+    status(): RuntimeStatus;
+    dispatchAgent(slug: string, trigger_reason: string, opts?: DispatchOpts): Promise<AgentRun>;
+    tickNow(): Promise<void>;
+    on(event: 'event', cb: (e: RuntimeEvent) => void): void;
+    off(event: 'event', cb: (e: RuntimeEvent) => void): void;
+    /** Director sprint slice 5 -- the agent-store root the runtime
+     *  was constructed with. The panel endpoints need this so they
+     *  can list the same definitions the runtime sees. */
+    getAgentsRoot(): string;
+    /** Director closure pendiente 5 followup -- the
+     *  /api/agent/approve handler emits agent_run_paused_resolved
+     *  via this method when a pending row carrying agent_slug
+     *  resolves. The SSE bus forwards it to the panel SVG which
+     *  clears the amber dashed marker. */
+    emitExternal(e: RuntimeEvent): void;
+}
+export declare function createRuntime(opts?: RuntimeOpts): Runtime;
+//# sourceMappingURL=runtime.d.ts.map

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

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