@kynetic-ai/spec 0.10.0 → 0.12.0

package/dist/agent-runtime/bootstrap.js

@@ -0,0 +1,302 @@
+import { spawnSync } from "node:child_process";
+import { createHash } from "node:crypto";
+import { loadProjectConfig } from "../parser/config.js";
+import { normalizeDispatchBootstrapState, persistDispatchWorkspaceMetadata, } from "./workspace.js";
+export class DispatchBootstrapError extends Error {
+    suggestion;
+    constructor(message, suggestion) {
+        super(message);
+        this.name = "DispatchBootstrapError";
+        this.suggestion = suggestion;
+    }
+}
+function runShell(cwd, command, env) {
+    const result = spawnSync("bash", ["-lc", command], {
+        cwd,
+        env: {
+            ...process.env,
+            ...env,
+        },
+        encoding: "utf-8",
+        stdio: "pipe",
+    });
+    return {
+        status: result.status,
+        stdout: result.stdout ?? "",
+        stderr: result.stderr ?? "",
+    };
+}
+function trackedStatus(cwd) {
+    const result = spawnSync("git", ["status", "--porcelain", "--untracked-files=no"], {
+        cwd,
+        encoding: "utf-8",
+        stdio: "pipe",
+    });
+    return result.status === 0 ? (result.stdout ?? "").trim() : "";
+}
+function summarizeOutput(stdout, stderr) {
+    const combined = [stdout.trim(), stderr.trim()].filter(Boolean).join("\n");
+    if (!combined)
+        return null;
+    return combined.slice(0, 4000);
+}
+function hashConfig(steps) {
+    return createHash("sha256")
+        .update(JSON.stringify(steps.map((step) => ({
+        source: step.source,
+        name: step.name,
+        run: step.run,
+        roles: step.roles ?? null,
+        idempotent: step.idempotent,
+        allowTrackedChanges: step.allowTrackedChanges,
+        reviewerRerunAllowed: step.reviewerRerunAllowed,
+    }))))
+        .digest("hex");
+}
+function resolveBootstrapSteps(agent, dispatchSteps) {
+    const projectSteps = dispatchSteps.map((step, index) => ({
+        source: "dispatch",
+        name: step.name ?? `dispatch-step-${index + 1}`,
+        run: step.run,
+        ...(step.roles ? { roles: step.roles } : {}),
+        idempotent: step.idempotent,
+        allowTrackedChanges: step.allow_tracked_changes,
+        reviewerRerunAllowed: step.reviewer_rerun_allowed,
+    }));
+    const agentSteps = (agent.bootstrap?.steps ?? []).map((step, index) => ({
+        source: "agent",
+        name: step.name ?? `agent-step-${index + 1}`,
+        run: step.run,
+        ...(step.roles ? { roles: step.roles } : {}),
+        idempotent: step.idempotent ?? false,
+        allowTrackedChanges: step.allow_tracked_changes ?? false,
+        reviewerRerunAllowed: step.reviewer_rerun_allowed ?? false,
+    }));
+    return [...projectSteps, ...agentSteps];
+}
+function stepAppliesToRole(step, role) {
+    return !step.roles || step.roles.includes(role);
+}
+function computeInvalidationReasons(state, canonicalBranchHead, configHash) {
+    const reasons = [];
+    if (state.status === "failed") {
+        reasons.push("prior-bootstrap-failed");
+    }
+    if (state.configHash && state.configHash !== configHash) {
+        reasons.push("bootstrap-config-changed");
+    }
+    if (state.canonicalBranchHead && state.canonicalBranchHead !== canonicalBranchHead) {
+        reasons.push("canonical-branch-head-changed");
+    }
+    return reasons;
+}
+async function persistMetadata(projectDir, metadataPath, metadata) {
+    await persistDispatchWorkspaceMetadata(projectDir, metadata);
+}
+function describeTrackedChangeFailure(step) {
+    return [
+        `Bootstrap step "${step.name}" modified tracked files but allow_tracked_changes is false.`,
+        "Mark the step with allow_tracked_changes: true only if tracked source mutations are intentional.",
+    ].join(" ");
+}
+function updateBootstrapState(metadata, role, state) {
+    metadata.bootstrap = {
+        ...state,
+        lastRole: role,
+        roleStates: {
+            ...metadata.bootstrap.roleStates,
+            [role]: state,
+        },
+    };
+    metadata.bootstrapState = metadata.bootstrap;
+}
+export async function ensureWorkspaceBootstrap(options) {
+    const { projectDir, workspaceDir, metadataPath, role, agent, env, } = options;
+    const { config } = await loadProjectConfig(projectDir, projectDir);
+    const steps = resolveBootstrapSteps(agent, config.dispatch.bootstrap.steps);
+    const roleSteps = steps.filter((step) => stepAppliesToRole(step, role));
+    const configHash = hashConfig(steps);
+    const metadata = structuredClone(options.metadata);
+    metadata.bootstrap = normalizeDispatchBootstrapState(metadata.bootstrap);
+    metadata.bootstrapState = metadata.bootstrap;
+    const workerState = metadata.bootstrap.roleStates.worker;
+    const reviewerState = metadata.bootstrap.roleStates.reviewer;
+    const workerInvalidationReasons = computeInvalidationReasons(workerState, metadata.canonicalBranchHead, configHash);
+    const reviewerInvalidationReasons = computeInvalidationReasons(reviewerState, metadata.canonicalBranchHead, configHash);
+    const workerBootstrapSucceeded = workerState.status === "succeeded" &&
+        workerInvalidationReasons.length === 0;
+    const reviewerBootstrapSucceeded = reviewerState.status === "succeeded" &&
+        reviewerInvalidationReasons.length === 0;
+    const canReuseWorkerStateForReviewer = role === "reviewer" &&
+        roleSteps.length === 0 &&
+        workerBootstrapSucceeded;
+    const invalidationReasons = role === "reviewer" && !reviewerBootstrapSucceeded && canReuseWorkerStateForReviewer
+        ? workerInvalidationReasons
+        : role === "reviewer"
+            ? reviewerInvalidationReasons
+            : workerInvalidationReasons;
+    const bootstrapSucceeded = role === "worker" ? workerBootstrapSucceeded : reviewerBootstrapSucceeded;
+    if (bootstrapSucceeded) {
+        const state = role === "worker"
+            ? {
+                ...workerState,
+                invalidationReasons: [],
+                failureMessage: null,
+            }
+            : {
+                ...reviewerState,
+                invalidationReasons: [],
+                failureMessage: null,
+            };
+        updateBootstrapState(metadata, role, state);
+        metadata.healthStatus = "healthy";
+        metadata.healthReason = null;
+        metadata.updatedAt = new Date().toISOString();
+        await persistMetadata(projectDir, metadataPath, metadata);
+        return { metadata, reused: true, ranSteps: false };
+    }
+    if (canReuseWorkerStateForReviewer) {
+        const reusedReviewerState = {
+            status: "succeeded",
+            configHash,
+            canonicalBranchHead: metadata.canonicalBranchHead,
+            lastRunAt: new Date().toISOString(),
+            invalidationReasons: [],
+            steps: [],
+            failureMessage: null,
+        };
+        updateBootstrapState(metadata, role, reusedReviewerState);
+        metadata.healthStatus = "healthy";
+        metadata.healthReason = null;
+        metadata.updatedAt = new Date().toISOString();
+        await persistMetadata(projectDir, metadataPath, metadata);
+        return { metadata, reused: true, ranSteps: false };
+    }
+    const rerunnableSteps = role === "reviewer"
+        ? roleSteps.filter((step) => step.idempotent || step.reviewerRerunAllowed)
+        : roleSteps;
+    if (role === "reviewer" && !bootstrapSucceeded && rerunnableSteps.length !== roleSteps.length) {
+        const blockedSteps = roleSteps
+            .filter((step) => !rerunnableSteps.includes(step))
+            .map((step) => step.name)
+            .join(", ");
+        updateBootstrapState(metadata, role, {
+            status: "failed",
+            configHash,
+            canonicalBranchHead: metadata.canonicalBranchHead,
+            lastRunAt: new Date().toISOString(),
+            invalidationReasons,
+            steps: [],
+            failureMessage: `Reviewer bootstrap cannot safely rerun non-idempotent steps: ${blockedSteps}`,
+        });
+        metadata.healthStatus = "unhealthy";
+        metadata.healthReason = metadata.bootstrap.failureMessage ?? null;
+        metadata.updatedAt = new Date().toISOString();
+        await persistMetadata(projectDir, metadataPath, metadata);
+        const failureMessage = metadata.bootstrap.failureMessage ?? "Reviewer bootstrap rerun was rejected.";
+        throw new DispatchBootstrapError(failureMessage, "Run or repair bootstrap from the worker workspace, or mark the affected reviewer-safe steps as idempotent/reviewer_rerun_allowed.");
+    }
+    const executedSteps = [];
+    for (const step of rerunnableSteps) {
+        const beforeStatus = trackedStatus(workspaceDir);
+        const result = runShell(workspaceDir, step.run, {
+            ...env,
+            KSPEC_DISPATCH_BOOTSTRAP_ROLE: role,
+            KSPEC_DISPATCH_BOOTSTRAP_SOURCE: step.source,
+            KSPEC_DISPATCH_BOOTSTRAP_STEP: step.name,
+        });
+        const afterStatus = trackedStatus(workspaceDir);
+        const output = summarizeOutput(result.stdout, result.stderr);
+        if (result.status !== 0) {
+            const failureMessage = `Bootstrap step "${step.name}" failed with exit code ${result.status ?? "unknown"}.`;
+            updateBootstrapState(metadata, role, {
+                status: "failed",
+                configHash,
+                canonicalBranchHead: metadata.canonicalBranchHead,
+                lastRunAt: new Date().toISOString(),
+                invalidationReasons,
+                steps: [
+                    ...executedSteps,
+                    {
+                        source: step.source,
+                        name: step.name,
+                        run: step.run,
+                        idempotent: step.idempotent,
+                        allowTrackedChanges: step.allowTrackedChanges,
+                        reviewerRerunAllowed: step.reviewerRerunAllowed,
+                        status: "failed",
+                        role,
+                        output,
+                    },
+                ],
+                failureMessage: `${failureMessage}${output ? ` Output: ${output}` : ""}`,
+            });
+            metadata.healthStatus = "unhealthy";
+            metadata.healthReason = failureMessage;
+            metadata.updatedAt = new Date().toISOString();
+            await persistMetadata(projectDir, metadataPath, metadata);
+            const failureMessageWithOutput = metadata.bootstrap.failureMessage ?? failureMessage;
+            throw new DispatchBootstrapError(failureMessageWithOutput, "Inspect the failing bootstrap command, dependency prerequisites, and workspace health before retrying dispatch.");
+        }
+        if (!step.allowTrackedChanges && beforeStatus !== afterStatus) {
+            const failureMessage = describeTrackedChangeFailure(step);
+            updateBootstrapState(metadata, role, {
+                status: "failed",
+                configHash,
+                canonicalBranchHead: metadata.canonicalBranchHead,
+                lastRunAt: new Date().toISOString(),
+                invalidationReasons,
+                steps: [
+                    ...executedSteps,
+                    {
+                        source: step.source,
+                        name: step.name,
+                        run: step.run,
+                        idempotent: step.idempotent,
+                        allowTrackedChanges: step.allowTrackedChanges,
+                        reviewerRerunAllowed: step.reviewerRerunAllowed,
+                        status: "failed",
+                        role,
+                        output: summarizeOutput(output ?? "", `Tracked status before:\n${beforeStatus}\nTracked status after:\n${afterStatus}`),
+                    },
+                ],
+                failureMessage,
+            });
+            metadata.healthStatus = "unhealthy";
+            metadata.healthReason = failureMessage;
+            metadata.updatedAt = new Date().toISOString();
+            await persistMetadata(projectDir, metadataPath, metadata);
+            throw new DispatchBootstrapError(failureMessage, "Update bootstrap configuration to opt in to tracked changes explicitly, or make the bootstrap step avoid tracked source mutations.");
+        }
+        executedSteps.push({
+            source: step.source,
+            name: step.name,
+            run: step.run,
+            idempotent: step.idempotent,
+            allowTrackedChanges: step.allowTrackedChanges,
+            reviewerRerunAllowed: step.reviewerRerunAllowed,
+            status: "succeeded",
+            role,
+            output,
+        });
+    }
+    updateBootstrapState(metadata, role, {
+        status: "succeeded",
+        configHash,
+        canonicalBranchHead: metadata.canonicalBranchHead,
+        lastRunAt: new Date().toISOString(),
+        invalidationReasons,
+        steps: executedSteps,
+        failureMessage: null,
+    });
+    metadata.healthStatus = "healthy";
+    metadata.healthReason = null;
+    metadata.updatedAt = new Date().toISOString();
+    await persistMetadata(projectDir, metadataPath, metadata);
+    return {
+        metadata,
+        reused: false,
+        ranSteps: rerunnableSteps.length > 0,
+    };
+}
+//# sourceMappingURL=bootstrap.js.map

package/dist/agent-runtime/bootstrap.js.map

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

package/dist/agent-runtime/dispatch.d.ts

@@ -10,6 +10,9 @@
  * AC: @agent-dispatch-engine ac-1 through ac-12
  */
 import { type LoadedTask } from "../parser/index.js";
+import type { SessionEventData } from "./session-event-types.js";
+import { interpolateTemplate } from "./prompts.js";
+import { type DispatchWorkspaceMetadata, type DispatchWorkspaceRole, type ProvisionedDispatchWorkspace } from "./workspace.js";
 /**
  * A minimal promise-based mutex for serializing async operations.
  * AC: @agent-dispatch-engine ac-12
@@ -25,20 +28,53 @@ declare class Mutex {
  * Task state as used for dispatch tracking.
  */
 export type TaskStatus = "pending" | "in_progress" | "pending_review" | "needs_work" | "blocked" | "completed" | "cancelled";
+export { interpolateTemplate };
 /**
- * Interpolate {{variable}} placeholders in a prompt template.
- * Unresolved variables pass through unchanged.
+ * Find the examined commit from the most recent closed review for a task.
+ * Returns null when no prior examined commit exists.
  *
- * AC: @agent-dispatch-engine ac-16
+ * AC: @review-fix-cycle-diff ac-2 — find prior review's examined commit
  */
-export declare function interpolateTemplate(template: string, vars: Record<string, string>): string;
+export declare function findPriorExaminedCommit(reviews: Array<{
+    lifecycle_state: string;
+    examined_commit: string | null;
+    subject: {
+        type: string;
+        ref?: string;
+    };
+    related_refs: string[];
+    created_at: string | null;
+}>, taskRef: string): string | null;
+/**
+ * Compute a git diff --stat between two commits. Returns null on any error.
+ *
+ * AC: @review-fix-cycle-diff ac-3 — graceful omission on unreachable commits
+ */
+export declare function computeDiffStat(fromCommit: string, toCommit: string, cwd: string): string | null;
+/**
+ * Compute a diff summary between the prior review's examined commit and the
+ * current canonical branch head. Returns null when no prior examined commit
+ * exists or when the diff cannot be computed (unreachable commits, etc.).
+ *
+ * AC: @review-fix-cycle-diff ac-2 — diff summary for reviewer orientation
+ * AC: @review-fix-cycle-diff ac-3 — graceful omission on unreachable commits
+ */
+export declare function getFixCycleDiffSummary(projectDir: string, taskRef: string, canonicalBranchHead: string | undefined, workspaceCwd?: string): Promise<string | null>;
 /**
  * Build orientation context block for a dispatch prompt.
  * Provides the agent with task title, trigger meaning, and relevant context.
  *
  * AC: @agent-dispatch-engine ac-13, ac-14, ac-15
  */
-export declare function buildOrientationContext(taskRef: string, trigger: string, task?: {
+export declare function buildOrientationContext(taskRef: string, trigger: string, workspaceOrTask: ProvisionedDispatchWorkspace | {
+    title: string;
+    notes?: Array<{
+        created_at: string;
+        author?: string;
+        content: string;
+    }>;
+    review_url?: string;
+}, taskOrMetadata?: {
     title: string;
     notes?: Array<{
         created_at: string;
@@ -46,6 +82,8 @@ export declare function buildOrientationContext(taskRef: string, trigger: string
         content: string;
     }>;
     review_url?: string;
+} | DispatchWorkspaceMetadata, metadataOrRole?: DispatchWorkspaceMetadata | DispatchWorkspaceRole, explicitRole?: DispatchWorkspaceRole, options?: {
+    fixCycleDiffSummary?: string | null;
 }): string;
 /**
  * A state change event for a single task.
@@ -68,6 +106,7 @@ export interface InvocationEvent {
     session_id: string;
     agent_id: string;
     task_id: string | undefined;
+    task_title: string | null;
     status: "started" | "completed" | "failed";
     timestamp: number;
 }
@@ -86,6 +125,21 @@ export interface DispatchEngineOptions {
     cwd?: string;
     /** Deduplication window in milliseconds (default 2000) */
     dedupWindowMs?: number;
+    /**
+     * Periodic reconciliation interval in milliseconds (default 60000).
+     * Re-evaluates all task states against dispatch rules, enqueuing any that
+     * match but have no active or queued invocation. Set to 0 or null to disable.
+     * AC: @agent-dispatch-engine ac-20
+     */
+    reconcileIntervalMs?: number | null;
+    /**
+     * Per-task coalescing window in milliseconds (default 5000).
+     * When a state change event triggers a drain, the drain is deferred by this
+     * window. If another event arrives for the same task within the window, the
+     * timer resets. Set to 0 to disable coalescing (immediate drain behavior).
+     * AC: @per-task-dispatch-drain-coalescing ac-4
+     */
+    coalesceWindowMs?: number;
     /** Path to kspec CLI binary (for task notes) */
     kspecCliPath?: string;
     /**
@@ -94,11 +148,13 @@ export interface DispatchEngineOptions {
      */
     onInvocationEvent?: (event: InvocationEvent) => void;
     /**
-     * Optional callback invoked for each text chunk produced by a running agent.
+     * Optional callback invoked for typed session lifecycle events.
+     * Replaces the old onTextChunk callback with structured event emission.
+     * AC: @session-event-broadcast ac-replaces-text-chunks
      * AC: @cli-agent-commands ac-13 (broadcast to watch subscribers)
      * AC: @daemon-agent-dispatch ac-8
      */
-    onTextChunk?: (sessionId: string, agentId: string, taskId: string | null, text: string) => void;
+    onSessionEvent?: (event: SessionEventData) => void;
 }
 /**
  * The core dispatch runtime.
@@ -116,9 +172,14 @@ export declare class DispatchEngine {
     private specDir;
     private cwd;
     private dedupWindowMs;
+    private reconcileIntervalMs;
+    /** AC: @per-task-dispatch-drain-coalescing ac-4 */
+    private coalesceWindowMs;
     private kspecCliPath?;
     private onInvocationEvent?;
-    private onTextChunk?;
+    private onSessionEvent?;
+    /** Per-session text accumulator for newline-boundary streaming. */
+    private accumulator;
     /** Queue of pending dispatch entries, per agent id */
     private queues;
     /** Count of active (running) invocations per agent id */
@@ -137,8 +198,22 @@ export declare class DispatchEngine {
     private invocationAbortControllers;
     /** Per-invocation tracking records for status display */
     private activeInvocationDetails;
+    /** Task refs currently between queue removal and active tracking registration */
+    private inFlightTaskKeys;
     /** Monotonic enqueue sequence for deterministic queue ordering */
     private nextQueueSequence;
+    /** Last task selected/completed, used as continuity affinity signal. */
+    private recentTaskAffinityRef;
+    /** Timer handle for periodic reconciliation. AC: @agent-dispatch-engine ac-20 */
+    private reconcileTimer;
+    /** All in-flight reconciliation promises so stop() can await every one. */
+    private inFlightReconciles;
+    /** Per-task coalescing timers. AC: @per-task-dispatch-drain-coalescing ac-1 */
+    private coalesceTimers;
+    /** Whether a drain is currently in progress. AC: @per-task-dispatch-drain-coalescing ac-8 */
+    private drainInProgress;
+    /** Whether another drain was requested while one is already running. AC: @per-task-dispatch-drain-coalescing ac-8 */
+    private drainPending;
     constructor(options: DispatchEngineOptions);
     /**
      * Start the dispatch engine.
@@ -171,6 +246,7 @@ export declare class DispatchEngine {
      * AC: @agent-dispatch-engine ac-12
      */
     getShadowMutex(): Mutex;
+    getCwd(): string;
     /**
      * Returns current engine status info including per-invocation details.
      * AC: @cli-agent-commands ac-6
@@ -199,13 +275,51 @@ export declare class DispatchEngine {
      * AC: @agent-dispatch-engine ac-8
      */
     private _bootstrap;
+    /**
+     * Periodic reconciliation: re-evaluate all task states against dispatch rules.
+     * Enqueues tasks that match but have no active or queued invocation.
+     * AC: @agent-dispatch-engine ac-19
+     */
+    private _reconcile;
+    /**
+     * Shared logic for bootstrap and reconciliation: load all tasks, seed
+     * prevTaskStates, and enqueue tasks matching agent dispatch rules.
+     *
+     * When skipIfActive is true (reconciliation), tasks with an existing
+     * active or queued invocation are skipped.
+     *
+     * AC: @agent-dispatch-engine ac-8, ac-19
+     */
+    private _evaluateAllTasks;
+    /**
+     * Check if an agent already has an active or queued invocation for a task.
+     * AC: @agent-dispatch-engine ac-19
+     */
+    private _hasActiveOrQueuedInvocation;
+    private _activeRoleByTaskRef;
+    private _activeTaskRefs;
+    /**
+     * Check whether any agent has an active or in-flight invocation for a task.
+     * Considers both registered active invocations (activeInvocationDetails) and
+     * tasks that are between queue removal and active registration (inFlightTaskKeys).
+     *
+     * AC: @agent-dispatch-engine ac-26
+     */
+    private _hasActiveInvocationForTask;
     /**
      * Load agent definitions from meta context.
      */
     private _loadAgents;
     /**
      * Check if a state change matches a dispatch rule's filters.
+     * Base readiness (deps, blocked_by) is checked before consumer filters
+     * per @trait-task-readiness ac-composable.
+     *
      * AC: @agent-dispatch-engine ac-6
+     * AC: @agent-dispatch-engine ac-21
+     * AC: @trait-task-readiness ac-deps
+     * AC: @trait-task-readiness ac-not-blocked
+     * AC: @trait-task-readiness ac-composable
      */
     private _matchesFilter;
     /**
@@ -234,10 +348,33 @@ export declare class DispatchEngine {
      */
     private _insertQueueEntry;
     /**
-     * Compare queue entries by dispatch precedence, then by enqueue sequence.
+     * Compare queue entries by dispatch precedence, numeric task priority, then FIFO.
      * AC: @dispatch-in-progress-priority ac-1
      */
     private _compareQueueEntries;
+    private _taskPriorityForEntry;
+    private _hasContinuityAffinity;
+    private _compareSchedulerCandidates;
+    private _recordContinuityDeferrals;
+    private _workspaceCandidateHealth;
+    private _pruneIneligibleQueueEntries;
+    private _selectNextCandidate;
+    /**
+     * Schedule a per-task coalesced drain. If a timer already exists for this
+     * task, it is cleared and reset to the full coalescing window.
+     *
+     * AC: @per-task-dispatch-drain-coalescing ac-1, ac-3
+     */
+    private _scheduleCoalescedDrain;
+    /**
+     * Serialize drain execution: if a drain is already running, mark that another
+     * drain is pending and return. When the current drain finishes, it runs the
+     * follow-up drain. This prevents concurrent _drainQueues() calls from
+     * racing on queue state.
+     *
+     * AC: @per-task-dispatch-drain-coalescing ac-8
+     */
+    private _serializedDrain;
     /**
      * Drain queues, spawning invocations up to each agent's max_concurrent limit.
      * AC: @agent-dispatch-engine ac-3, ac-17
@@ -250,6 +387,10 @@ export declare class DispatchEngine {
      * AC: @agent-dispatch-engine ac-13, ac-14, ac-15, ac-16
      */
     private _buildDispatchPrompt;
+    private _runKspecCommand;
+    private _taskCommandError;
+    private _addTaskNote;
+    private _blockTask;
     /**
      * Spawn a single invocation for a queue entry.
      * Returns true if an invocation was actually started, false if skipped.
@@ -257,5 +398,4 @@ export declare class DispatchEngine {
      */
     private _spawnInvocation;
 }
-export {};
 //# sourceMappingURL=dispatch.d.ts.map

package/dist/agent-runtime/dispatch.d.ts.map

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