agentenkit 0.1.0

package/dist/core/engine.js

@@ -0,0 +1,489 @@
+import { randomUUID } from 'node:crypto';
+import { compactContext } from './context.js';
+import { markPromptCaching } from './cache.js';
+import { mergeProviderOptions } from './types.js';
+import { hitlKey, loadOpenHitls, withHitl, } from './hitl.js';
+import { publish, setThreadState } from './publish.js';
+import { runNestedAgent, spawnSubagentTool } from './subagent.js';
+import { redriveKey, runIdKey } from './keys.js';
+import { withRunState } from './state.js';
+import { runLoop } from './loop.js';
+export { countTokens } from './usage.js';
+// executeStep and the loop live in ./loop.js so a nested run can share them
+// without engine ↔ subagent becoming a cycle (§2.7).
+export { executeStep, isParked, runLoop } from './loop.js';
+const runLockKey = (threadId) => `agent:lock:${threadId}`;
+/** The safety cap (§2.1) must be either absent (unbounded apart from
+ *  maxSteps) or a positive number — `0`/negative/NaN would silently disable
+ *  the cap and let a run spend without bound. */
+export function validateTokenBudget(value, label) {
+    if (value !== undefined && (!Number.isFinite(value) || value <= 0)) {
+        throw new Error(`${label} must be a positive finite number`);
+    }
+}
+/** Tools the engine treats as destructive: parked behind parkForApproval
+ *  (§2.5) instead of executing directly. Purely a marker — see withHitl. */
+export function markRequiresConfirmation(t) {
+    return Object.assign(t, { requiresConfirmation: true });
+}
+/** Is this approval settled yet (§2.7)? Read-only on purpose: with several
+ *  open at once, nothing may be executed until EVERY one is ready, or a
+ *  redelivery would run half of them and then leave the thread parked with
+ *  those verdicts already consumed. */
+async function verdictReady(deps, pending) {
+    if (await deps.kv.get(hitlKey(pending.toolCallId)))
+        return 'answered';
+    return Date.now() - pending.requestedAt >= deps.config.hitlTtlMs ? 'expired' : 'open';
+}
+/** Turn a settled approval into the tool result the conversation will carry
+ *  (§2.5): run the approved tool, record the denial, or convert an expired
+ *  request into the timeout denial ("user had no response").
+ *
+ *  The tool failure is surfaced TO THE MODEL as the tool result — the verdict
+ *  arrives from a different process than the one that ran the model, so the
+ *  conversation always stays executable. */
+async function settleVerdict(deps, threadId, pending, target, signal) {
+    const raw = await deps.kv.get(hitlKey(pending.toolCallId));
+    await deps.kv.del(hitlKey(pending.toolCallId));
+    if (!raw) {
+        await publish(deps, threadId, 'INPUT_EXPIRED', { toolCallId: pending.toolCallId });
+        return { responded: false, cancelled: true, reason: 'timeout' };
+    }
+    const answer = JSON.parse(raw);
+    if (!answer.approved)
+        return { denied: true };
+    try {
+        return target?.execute
+            ? await target.execute(pending.arguments, {
+                toolCallId: pending.toolCallId,
+                abortSignal: signal,
+            })
+            : { error: `Unknown tool: ${pending.toolName}` };
+    }
+    catch (err) {
+        return { error: err instanceof Error ? err.message : String(err) };
+    }
+}
+/** Land a settled verdict and unwind whatever was waiting on it (§2.7).
+ *
+ *  The verdict belongs to the stream that asked — the main agent's, or a
+ *  nested run's. When a nested run asked, its own loop is re-entered from its
+ *  persisted turns and its result is handed to the call waiting one level up,
+ *  repeating until the main agent's `spawnSubagent` call is answered.
+ *
+ *  Returns false when the unwind parked again: the thread stays
+ *  WAITING_FOR_INPUT and a later dispatch picks up from the new request. */
+async function unwindVerdict(deps, threadId, pending, result, subCtx, signal) {
+    await deps.storage.messages.append(threadId, {
+        role: 'tool',
+        agentId: pending.agentId,
+        content: [
+            { type: 'tool-result', toolCallId: pending.toolCallId, toolName: pending.toolName, result },
+        ],
+    });
+    // `producer` is whoever must now run to produce the next result. Undefined
+    // means the main agent, whose loop the caller re-enters itself.
+    let producer = pending.nested;
+    for (let i = 0; i < pending.frames.length; i += 1) {
+        const frame = pending.frames[i];
+        if (!producer || !subCtx)
+            break;
+        const outcome = await runNestedAgent(subCtx, producer, null, signal, pending.frames.slice(i));
+        if (outcome.parked)
+            return false; // parked again, one level down
+        if (outcome.aborted)
+            return false; // user stop mid-unwind (§2.1)
+        await deps.admin.runs.patch(producer.agentId, {
+            state: 'COMPLETED',
+            result: { text: outcome.text },
+            endedAt: new Date(),
+        });
+        await publish(deps, threadId, 'SUBAGENT_COMPLETED', { agentId: producer.agentId });
+        // Hand the capped result to the call one level up (§2.6)
+        await deps.storage.messages.append(threadId, {
+            role: 'tool',
+            agentId: frame.agentId,
+            content: [
+                {
+                    type: 'tool-result',
+                    toolCallId: frame.toolCallId,
+                    toolName: 'spawnSubagent',
+                    result: {
+                        agentId: producer.agentId,
+                        result: outcome.text.slice(0, deps.config.subagentResultCapChars),
+                    },
+                },
+            ],
+        });
+        producer = frame.nested;
+    }
+    return true;
+}
+/** Sum this segment onto the run's record and stamp how it ended (§2.9). */
+async function closeRunRecord(deps, runId, f) {
+    try {
+        const prior = await deps.admin.runs.get(runId);
+        if (!prior)
+            return; // a run started before §2.9, or a foreign dispatch
+        const endedAt = new Date();
+        await deps.admin.runs.patch(runId, {
+            state: f.state,
+            stopReason: f.stopReason,
+            ...(f.error ? { error: f.error } : {}),
+            endedAt,
+            durationMs: endedAt.getTime() - new Date(prior.startedAt).getTime(),
+            steps: prior.steps + (f.steps ?? 0),
+            inputTokens: prior.inputTokens + f.attribution.inputTokens,
+            cachedInputTokens: prior.cachedInputTokens + f.attribution.cachedInputTokens,
+            outputTokens: prior.outputTokens + f.attribution.outputTokens,
+            totalTokens: prior.totalTokens + f.attribution.totalTokens,
+        });
+    }
+    catch {
+        // Observability must never be able to fail a run that otherwise succeeded.
+    }
+}
+/** Finalise a run as FAILED on both homes AND keep why (§2.9). The reason used
+ *  to be dropped entirely, so an operator could see that something failed but
+ *  never what. */
+async function failRun(deps, threadId, runId, error) {
+    await deps.kv.set(`agent:state:${threadId}`, 'FAILED');
+    await setThreadState(deps, threadId, 'FAILED');
+    if (runId) {
+        await closeRunRecord(deps, runId, {
+            state: 'FAILED',
+            stopReason: 'completed',
+            tokensUsed: 0,
+            attribution: { inputTokens: 0, cachedInputTokens: 0, outputTokens: 0, totalTokens: 0 },
+            error,
+            runId,
+        });
+    }
+    await publish(deps, threadId, 'STATE_CHANGE', { state: 'FAILED', error });
+}
+/** Resolve every parked request at segment start (§2.5, §2.7) and flip the
+ *  thread back to RUNNING. Returns false when at least one approval is still
+ *  open within its TTL: the dispatch is an at-least-once redelivery and the
+ *  thread stays parked. `rawTools` must be the UNWRAPPED main toolset. */
+async function resumePendingHitl(deps, threadId, open, rawTools, subCtx, signal) {
+    // Readiness first, side effects second: the thread resumes only when EVERY
+    // open approval has been answered or has expired (§2.7).
+    const states = await Promise.all(open.map((p) => verdictReady(deps, p)));
+    if (states.includes('open'))
+        return false; // redelivery no-op (§2.8)
+    let expiredAny = false;
+    for (const pending of open) {
+        // A nested run's tools come from the delegation config, not the main
+        // agent's set — the approved tool has to be resolved where it lives.
+        const target = pending.agentId === null
+            ? rawTools[pending.toolName]
+            : subCtx?.sub.tools?.[pending.toolName];
+        const result = await settleVerdict(deps, threadId, pending, target, signal);
+        if (result?.reason === 'timeout')
+            expiredAny = true;
+        if (!(await unwindVerdict(deps, threadId, pending, result, subCtx, signal)))
+            return false;
+    }
+    await deps.kv.set(`agent:state:${threadId}`, 'RUNNING');
+    await setThreadState(deps, threadId, 'RUNNING');
+    await publish(deps, threadId, 'STATE_CHANGE', { state: 'RUNNING' });
+    void expiredAny;
+    return true;
+}
+export async function execute(deps, agent, input) {
+    const { threadId, runId } = input;
+    const abort = new AbortController();
+    validateTokenBudget(input.tokenBudget, 'tokenBudget');
+    /** True once the thread has started a NEWER run than this one (§2.1). */
+    const stale = async () => runId !== undefined && (await deps.kv.get(runIdKey(threadId))) !== runId;
+    // The lock carries the run id, so a later conflict can tell a duplicate
+    // delivery of THIS run apart from an older run that is still finishing.
+    const locked = await deps.kv.set(runLockKey(threadId), runId ?? randomUUID(), {
+        onlyIfNotExists: true,
+        exSeconds: deps.config.runLockLeaseSeconds,
+    });
+    if (!locked)
+        return 'lock-conflict'; // another worker owns this thread (§2.8)
+    // Token budget (§2.1 safety cap) — precedence: execute input → spec →
+    // config. Checked BETWEEN steps: the finished step is always kept in full,
+    // nothing is aborted mid-generation. This is NOT a user stop.
+    const tokenBudget = input.tokenBudget ?? agent.spec.tokenBudget ?? deps.config.tokenBudget;
+    // Provider-specific options (§3.1): spec default <- execute input,
+    // shallow per-provider namespace; the execute input wins.
+    // Three levels, widest first: runtime config → agent spec → this run.
+    // Each wins over the one before it, per provider namespace (§3.1).
+    const providerOptions = mergeProviderOptions(mergeProviderOptions(deps.config.providerOptions, agent.spec.providerOptions), input.providerOptions);
+    // Two ways a run ends early, one behavior — everything tears down at once:
+    //   1. the state key reads CANCELLED: the user pressed stop (§2.1);
+    //   2. the run id has moved on: the user pressed stop and then sent another
+    //      message, which put RUNNING back over CANCELLED before this poll could
+    //      read it. The state key lies in that window; the run id never does.
+    const controlPoll = setInterval(async () => {
+        try {
+            if ((await deps.kv.get(`agent:state:${threadId}`)) === 'CANCELLED' || (await stale())) {
+                abort.abort();
+            }
+        }
+        catch {
+            // transient kv errors must never kill the poller
+        }
+    }, deps.config.stopPollMs);
+    try {
+        // At-least-once idempotency (§2.8): a job whose run already ended — or
+        // was stopped — must be a no-op on redelivery. A MISSING thread is the
+        // same no-op: it was deleted (§3.2) and must never be resurrected.
+        // A newer run already owns this thread: this job has nothing to do, and
+        // must not touch state on the live run's behalf (§2.1).
+        if (await stale())
+            return 'stale';
+        const durable = await deps.storage.threads.get(threadId);
+        if (!durable ||
+            durable.state === 'CANCELLED' ||
+            durable.state === 'COMPLETED' ||
+            durable.state === 'FAILED') {
+            return 'executed';
+        }
+        const resume = {
+            agent: agent.name,
+            model: input.model,
+            ...(runId ? { runId } : {}),
+            ...(input.tokenBudget !== undefined ? { tokenBudget: input.tokenBudget } : {}),
+            ...(providerOptions ? { providerOptions } : {}),
+            // Carried so the resumed segment scopes its storage the same way this
+            // one does (§2.10).
+            ...(input.state ? { state: input.state } : {}),
+        };
+        // One ledger for the whole run: a nested run's spend counts against the
+        // same safety cap the main agent is checked against (§2.7).
+        const ledger = { tokensUsed: 0 };
+        // How long the dispatch sat in the queue before a worker took it (§2.9).
+        if (runId && input.enqueuedAt) {
+            await deps.admin.runs
+                .patch(runId, { queuedMs: Date.now() - input.enqueuedAt })
+                .catch(() => undefined);
+        }
+        // Platform-owned toolset: HITL (§2.5) over the user's set; spawnSubagent
+        // added ONLY when the spec opts in (§2.7). rawTools keeps the real
+        // implementations — the resolved park executes the approved tool.
+        const sub = agent.spec.subagents
+            ? agent.spec.subagents === true
+                ? {}
+                : agent.spec.subagents
+            : null;
+        const subCtx = sub
+            ? {
+                threadId,
+                depth: 0,
+                sem: agent.sem,
+                ports: deps,
+                sub,
+                agent,
+                ledger,
+                resume,
+                agentId: null, // spawned by the main agent
+                frames: [],
+                tokenBudget,
+                providerOptions,
+                abortSignal: abort.signal,
+                state: input.state,
+            }
+            : null;
+        const rawTools = {
+            ...(agent.args.tools ?? {}),
+            ...(subCtx ? { spawnSubagent: spawnSubagentTool(subCtx) } : {}),
+        };
+        // The main agent's own toolset: nothing is waiting on its parks (§2.7).
+        // Every tool also sees the run's state (§2.10).
+        const tools = withRunState(withHitl(deps, threadId, rawTools, { resume, agentId: null, frames: [] }), input.state ?? {});
+        // §2.5 resume: a WAITING thread at segment start is either the /respond
+        // continuation or a redelivery of the original job while still parked.
+        if (durable?.state === 'WAITING_FOR_INPUT') {
+            // Every approval still open, not just the latest: one parent step can
+            // park several nested runs at once (§2.7).
+            const open = await loadOpenHitls(deps, threadId);
+            if (open.length === 0) {
+                // WAITING without a pending request cannot be continued — fail into
+                // the §2.8 policy rather than corrupting the conversation.
+                throw new Error(`Thread ${threadId} is WAITING_FOR_INPUT without a pending INPUT_REQUIRED`);
+            }
+            const resumed = await resumePendingHitl(deps, threadId, open, rawTools, subCtx, abort.signal);
+            if (!resumed)
+                return 'executed'; // still parked — nothing to do yet
+        }
+        // Durable compaction pass — history always fits the model budget (§2.6);
+        // the budget uses the resolved model's contextWindow (§3.3)
+        const history = await compactContext(deps, threadId, input.model);
+        const model = deps.resolveModel(input.model);
+        // Prompt caching (§2.6): stamp the stable prefix once — appended step
+        // messages extend the prompt without invalidating the breakpoints.
+        let messages = history.map((m) => ({ role: m.role, content: m.content }));
+        if (deps.config.promptCaching) {
+            messages = markPromptCaching(messages);
+        }
+        const userArgs = agent.args;
+        const loop = await runLoop(deps, agent, threadId, {
+            agentId: null, // the main agent's stream (§2.7)
+            runId,
+            kind: agent.kind,
+            model: model.instance(),
+            messages,
+            tools,
+            maxSteps: deps.config.maxSteps,
+            abortSignal: abort.signal,
+            providerOptions,
+            tokenBudget,
+            cacheSystemPrompt: deps.config.promptCaching,
+            onChunk: async (chunk) => {
+                // One canonical path for every client: durable log + live Pub/Sub (§2.1, §2.2)
+                await publish(deps, threadId, 'CHUNK', chunk);
+                userArgs.onChunk?.({ chunk }); // user callback still fires
+            },
+        }, ledger);
+        const { attribution, parked } = loop;
+        const tokensUsed = ledger.tokensUsed;
+        const lastText = loop.text;
+        const lastFinishReason = loop.finishReason;
+        if (parked) {
+            // The segment ends holding the park: bill the steps up to the park
+            // (§4) — the resumed segment records its own usage. NO state flip:
+            // WAITING_FOR_INPUT (or CANCELLED if the user stopped meanwhile) stands.
+            await deps.storage.usage.record(threadId, { agentId: agent.name, ...attribution });
+            return 'executed';
+        }
+        const stopReason = abort.signal.aborted
+            ? 'cancelled'
+            : tokenBudget && tokensUsed >= tokenBudget
+                ? 'token_budget'
+                : lastFinishReason === 'tool-calls'
+                    ? 'max_steps' // step ceiling hit (§2.1)
+                    : 'completed';
+        await finalize(deps, agent, threadId, {
+            state: abort.signal.aborted ? 'CANCELLED' : 'COMPLETED',
+            stopReason,
+            tokensUsed,
+            attribution,
+            oneShotText: agent.kind === 'generate-text' ? lastText : undefined,
+            runId,
+            steps: loop.steps,
+        });
+        return 'executed';
+    }
+    finally {
+        clearInterval(controlPoll);
+        await deps.kv.del(runLockKey(threadId)); // release — success, failure, or stop
+    }
+}
+/** Finalize a finished run (§5.6): attribute the segment's total tokens
+ *  (input + cached + output, §4), then flip state on both homes and publish.
+ *  Message persistence already happened per step inside the loop — finalize
+ *  never touches messages.
+ *
+ *  A budget break is NOT a user stop: the run completes with stopReason
+ *  'token_budget' and the usage it actually spent. */
+export async function finalize(deps, agent, threadId, f) {
+    // Tokens this segment actually spent are always ours to record (§4), even
+    // when the run was replaced part-way through.
+    await deps.storage.usage.record(threadId, { agentId: agent.name, ...f.attribution });
+    // Close the run's durable record (§2.9). Additive: a run that parked and
+    // resumed finalises once, but its steps and tokens accrued over several
+    // segments, so they are summed onto what is already there. The run lock
+    // (§3.4) makes this read-modify-write single-writer.
+    if (f.runId)
+        await closeRunRecord(deps, f.runId, f);
+    // Past that, a replaced run stays silent. Its CANCELLED would otherwise land
+    // on top of the next run's RUNNING and wedge the thread: the new worker
+    // would read a terminal state and no-op, and nobody would ever answer the
+    // message the user just sent (§2.1).
+    if (f.runId !== undefined && (await deps.kv.get(runIdKey(threadId))) !== f.runId)
+        return;
+    if (f.oneShotText !== undefined) {
+        // One-shot flavor: no CHUNK stream — publish the final text as one event
+        await publish(deps, threadId, 'TEXT_RESULT', { text: f.oneShotText });
+    }
+    await deps.kv.set(`agent:state:${threadId}`, f.state);
+    await setThreadState(deps, threadId, f.state);
+    await publish(deps, threadId, 'STATE_CHANGE', {
+        state: f.state,
+        stopReason: f.stopReason,
+        tokensUsed: f.tokensUsed,
+        usage: f.attribution,
+    });
+}
+/** A lock conflict has two very different causes (§2.8), and only one of them
+ *  is a no-op:
+ *
+ *  - the lock carries THIS run's id → an at-least-once duplicate of a job that
+ *    is already executing. Drop it.
+ *  - the lock belongs to an OLDER run that has not finished tearing down →
+ *    this job never ran. Dropping it strands the message the user just sent,
+ *    so come back once the lock clears. Bounded by maxAttempts, then FAILED,
+ *    so a wedged lock reports itself instead of spinning forever. */
+async function redriveOnLockConflict(deps, agent, input, maxAttempts) {
+    if (!input.runId)
+        return; // legacy dispatch, no identity — old drop behavior
+    if ((await deps.kv.get(runLockKey(input.threadId))) === input.runId)
+        return; // own duplicate
+    if ((await deps.kv.get(runIdKey(input.threadId))) !== input.runId)
+        return; // already replaced
+    const tries = await deps.kv.incr(redriveKey(input.threadId));
+    if (tries <= maxAttempts) {
+        return deps.queue.enqueue({
+            threadId: input.threadId,
+            runId: input.runId,
+            enqueuedAt: Date.now(),
+            model: input.model,
+            agent: agent.name,
+            tokenBudget: input.tokenBudget,
+            providerOptions: input.providerOptions,
+        }, { delaySeconds: deps.config.runRedriveDelaySeconds });
+    }
+    await deps.kv.del(redriveKey(input.threadId));
+    await failRun(deps, input.threadId, input.runId, 'the run lock never cleared');
+}
+/** §2.8 failure policy: transient errors redrive through the queue; exhausted
+ *  attempts finalize FAILED (hot cache + durable). A user stop is never
+ *  retried, and a successful run resets the attempt counter.
+ *
+ *  `exec` is an injection seam for tests (default: the real execute). */
+export async function executeWithPolicy(deps, agent, input, policy, exec = execute) {
+    const maxAttempts = policy?.maxAttempts ?? deps.config.runMaxAttempts;
+    try {
+        const outcome = await exec(deps, agent, input);
+        // Only a run THIS worker executed may reset the retry budget — a
+        // lock-conflict no-op must never clear it while the owning worker runs (§2.8)
+        if (outcome === 'executed') {
+            await deps.kv.del(`agent:attempts:${input.threadId}`);
+            await deps.kv.del(redriveKey(input.threadId));
+            return;
+        }
+        // A newer run owns the thread: this job is a genuine no-op.
+        if (outcome === 'stale')
+            return;
+        await redriveOnLockConflict(deps, agent, input, maxAttempts);
+    }
+    catch (err) {
+        // A user stop already finalized the thread — never retry a stop
+        if ((await deps.kv.get(`agent:state:${input.threadId}`)) === 'CANCELLED')
+            return;
+        const attempts = await deps.kv.incr(`agent:attempts:${input.threadId}`);
+        if (attempts < maxAttempts) {
+            return deps.queue.enqueue({
+                threadId: input.threadId,
+                // A retry is the SAME run trying again (§2.1). Dropping the id here
+                // left the retried job unable to notice it had been replaced, and
+                // unable to redrive if it found the lock held.
+                runId: input.runId,
+                enqueuedAt: Date.now(),
+                model: input.model,
+                agent: agent.name,
+                tokenBudget: input.tokenBudget,
+                providerOptions: input.providerOptions,
+            });
+        }
+        // Attempts exhausted: finalize FAILED on BOTH the hot cache and durable
+        // truth, or subsequent runs would still treat the thread as active (§2.1)
+        await failRun(deps, input.threadId, input.runId, err instanceof Error ? err.message : String(err));
+        await deps.kv.del(`agent:attempts:${input.threadId}`);
+    }
+}
+//# sourceMappingURL=engine.js.map

package/dist/core/engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.js","sourceRoot":"","sources":["../../src/core/engine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAElD,OAAO,EACL,OAAO,EACP,aAAa,EACb,QAAQ,GAET,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAoB,MAAM,eAAe,CAAC;AACpF,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,EAAE,YAAY,EAAsB,MAAM,YAAY,CAAC;AAC9D,OAAO,EAAE,OAAO,EAAkB,MAAM,WAAW,CAAC;AAEpD,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,4EAA4E;AAC5E,qDAAqD;AACrD,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,OAAO,EAAqE,MAAM,WAAW,CAAC;AAE9H,MAAM,UAAU,GAAG,CAAC,QAAgB,EAAE,EAAE,CAAC,cAAc,QAAQ,EAAE,CAAC;AAElE;;iDAEiD;AACjD,MAAM,UAAU,mBAAmB,CAAC,KAAyB,EAAE,KAAa;IAC1E,IAAI,KAAK,KAAK,SAAS,IAAI,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,EAAE,CAAC;QACnE,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,mCAAmC,CAAC,CAAC;IAC/D,CAAC;AACH,CAAC;AAED;4EAC4E;AAC5E,MAAM,UAAU,wBAAwB,CAAmB,CAAI;IAC7D,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,oBAAoB,EAAE,IAAI,EAAE,CAAC,CAAC;AAC1D,CAAC;AAED;;;uCAGuC;AACvC,KAAK,UAAU,YAAY,CACzB,IAAkB,EAClB,OAAoB;IAEpB,IAAI,MAAM,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAAE,OAAO,UAAU,CAAC;IACtE,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,WAAW,IAAI,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC;AACxF,CAAC;AAED;;;;;;4CAM4C;AAC5C,KAAK,UAAU,aAAa,CAC1B,IAAkB,EAClB,QAAgB,EAChB,OAAoB,EACpB,MAAoF,EACpF,MAAmB;IAEnB,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC;IAC3D,MAAM,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC;IAE/C,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,OAAO,CAAC,IAAI,EAAE,QAAQ,EAAE,eAAe,EAAE,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;QACnF,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;IAClE,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAe,CAAC;IAC7C,IAAI,CAAC,MAAM,CAAC,QAAQ;QAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IAE9C,IAAI,CAAC;QACH,OAAO,MAAM,EAAE,OAAO;YACpB,CAAC,CAAC,MAAM,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,EAAE;gBACtC,UAAU,EAAE,OAAO,CAAC,UAAU;gBAC9B,WAAW,EAAE,MAAM;aACpB,CAAC;YACJ,CAAC,CAAC,EAAE,KAAK,EAAE,iBAAiB,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC;IACrD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,EAAE,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;IACrE,CAAC;AACH,CAAC;AAED;;;;;;;;4EAQ4E;AAC5E,KAAK,UAAU,aAAa,CAC1B,IAAkB,EAClB,QAAgB,EAChB,OAAoB,EACpB,MAAe,EACf,MAA0B,EAC1B,MAAmB;IAEnB,MAAM,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE;QAC3C,IAAI,EAAE,MAAM;QACZ,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,OAAO,EAAE;YACP,EAAE,IAAI,EAAE,aAAa,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE;SAC5F;KACF,CAAC,CAAC;IAEH,2EAA2E;IAC3E,gEAAgE;IAChE,IAAI,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC;IAC9B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QAClD,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAE,CAAC;QACjC,IAAI,CAAC,QAAQ,IAAI,CAAC,MAAM;YAAE,MAAM;QAEhC,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAC9F,IAAI,OAAO,CAAC,MAAM;YAAE,OAAO,KAAK,CAAC,CAAC,+BAA+B;QACjE,IAAI,OAAO,CAAC,OAAO;YAAE,OAAO,KAAK,CAAC,CAAC,8BAA8B;QAEjE,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,EAAE;YAC5C,KAAK,EAAE,WAAW;YAClB,MAAM,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE;YAC9B,OAAO,EAAE,IAAI,IAAI,EAAE;SACpB,CAAC,CAAC;QACH,MAAM,OAAO,CAAC,IAAI,EAAE,QAAQ,EAAE,oBAAoB,EAAE,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;QAEnF,yDAAyD;QACzD,MAAM,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE;YAC3C,IAAI,EAAE,MAAM;YACZ,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,aAAa;oBACnB,UAAU,EAAE,KAAK,CAAC,UAAU;oBAC5B,QAAQ,EAAE,eAAe;oBACzB,MAAM,EAAE;wBACN,OAAO,EAAE,QAAQ,CAAC,OAAO;wBACzB,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,sBAAsB,CAAC;qBAClE;iBACF;aACF;SACF,CAAC,CAAC;QACH,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAC;IAC1B,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,4EAA4E;AAC5E,KAAK,UAAU,cAAc,CAC3B,IAAkB,EAClB,KAAa,EACb,CAAgB;IAEhB,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAC/C,IAAI,CAAC,KAAK;YAAE,OAAO,CAAC,mDAAmD;QACvE,MAAM,OAAO,GAAG,IAAI,IAAI,EAAE,CAAC;QAC3B,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE;YACjC,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,UAAU,EAAE,CAAC,CAAC,UAAU;YACxB,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACtC,OAAO;YACP,UAAU,EAAE,OAAO,CAAC,OAAO,EAAE,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE;YACnE,KAAK,EAAE,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC;YACnC,WAAW,EAAE,KAAK,CAAC,WAAW,GAAG,CAAC,CAAC,WAAW,CAAC,WAAW;YAC1D,iBAAiB,EAAE,KAAK,CAAC,iBAAiB,GAAG,CAAC,CAAC,WAAW,CAAC,iBAAiB;YAC5E,YAAY,EAAE,KAAK,CAAC,YAAY,GAAG,CAAC,CAAC,WAAW,CAAC,YAAY;YAC7D,WAAW,EAAE,KAAK,CAAC,WAAW,GAAG,CAAC,CAAC,WAAW,CAAC,WAAW;SAC3D,CAAC,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACP,2EAA2E;IAC7E,CAAC;AACH,CAAC;AAED;;kBAEkB;AAClB,KAAK,UAAU,OAAO,CACpB,IAAkB,EAClB,QAAgB,EAChB,KAAyB,EACzB,KAAa;IAEb,MAAM,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,eAAe,QAAQ,EAAE,EAAE,QAAQ,CAAC,CAAC;IACvD,MAAM,cAAc,CAAC,IAAI,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAC/C,IAAI,KAAK,EAAE,CAAC;QACV,MAAM,cAAc,CAAC,IAAI,EAAE,KAAK,EAAE;YAChC,KAAK,EAAE,QAAQ;YACf,UAAU,EAAE,WAAW;YACvB,UAAU,EAAE,CAAC;YACb,WAAW,EAAE,EAAE,WAAW,EAAE,CAAC,EAAE,iBAAiB,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE;YACtF,KAAK;YACL,KAAK;SACN,CAAC,CAAC;IACL,CAAC;IACD,MAAM,OAAO,CAAC,IAAI,EAAE,QAAQ,EAAE,cAAc,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;AAC5E,CAAC;AAED;;;0EAG0E;AAC1E,KAAK,UAAU,iBAAiB,CAC9B,IAAkB,EAClB,QAAgB,EAChB,IAAmB,EACnB,QAA6B,EAC7B,MAA0B,EAC1B,MAAmB;IAEnB,2EAA2E;IAC3E,yDAAyD;IACzD,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IACzE,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,OAAO,KAAK,CAAC,CAAC,0BAA0B;IAErE,IAAI,UAAU,GAAG,KAAK,CAAC;IACvB,KAAK,MAAM,OAAO,IAAI,IAAI,EAAE,CAAC;QAC3B,qEAAqE;QACrE,qEAAqE;QACrE,MAAM,MAAM,GACV,OAAO,CAAC,OAAO,KAAK,IAAI;YACtB,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC;YAC5B,CAAC,CAAE,MAAM,EAAE,GAAG,CAAC,KAAyC,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QAEjF,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QAC5E,IAAK,MAA8B,EAAE,MAAM,KAAK,SAAS;YAAE,UAAU,GAAG,IAAI,CAAC;QAC7E,IAAI,CAAC,CAAC,MAAM,aAAa,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;YAAE,OAAO,KAAK,CAAC;IAC5F,CAAC;IAED,MAAM,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,eAAe,QAAQ,EAAE,EAAE,SAAS,CAAC,CAAC;IACxD,MAAM,cAAc,CAAC,IAAI,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;IAChD,MAAM,OAAO,CAAC,IAAI,EAAE,QAAQ,EAAE,cAAc,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;IACpE,KAAK,UAAU,CAAC;IAChB,OAAO,IAAI,CAAC;AACd,CAAC;AAyCD,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,IAAkB,EAClB,KAAsB,EACtB,KAAmB;IAEnB,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC;IAClC,MAAM,KAAK,GAAG,IAAI,eAAe,EAAE,CAAC;IAEpC,mBAAmB,CAAC,KAAK,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;IAEtD,yEAAyE;IACzE,MAAM,KAAK,GAAG,KAAK,IAAI,EAAE,CACvB,KAAK,KAAK,SAAS,IAAI,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC;IAE3E,wEAAwE;IACxE,wEAAwE;IACxE,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,KAAK,IAAI,UAAU,EAAE,EAAE;QAC5E,eAAe,EAAE,IAAI;QACrB,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,mBAAmB;KAC3C,CAAC,CAAC;IACH,IAAI,CAAC,MAAM;QAAE,OAAO,eAAe,CAAC,CAAC,yCAAyC;IAE9E,sEAAsE;IACtE,2EAA2E;IAC3E,8DAA8D;IAC9D,MAAM,WAAW,GAAG,KAAK,CAAC,WAAW,IAAI,KAAK,CAAC,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC;IAE3F,mEAAmE;IACnE,0DAA0D;IAC1D,sEAAsE;IACtE,mEAAmE;IACnE,MAAM,eAAe,GAAG,oBAAoB,CAC1C,oBAAoB,CAAC,IAAI,CAAC,MAAM,CAAC,eAAe,EAAE,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,EAC7E,KAAK,CAAC,eAAe,CACtB,CAAC;IAEF,2EAA2E;IAC3E,oEAAoE;IACpE,4EAA4E;IAC5E,6EAA6E;IAC7E,0EAA0E;IAC1E,MAAM,WAAW,GAAG,WAAW,CAAC,KAAK,IAAI,EAAE;QACzC,IAAI,CAAC;YACH,IAAI,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,eAAe,QAAQ,EAAE,CAAC,CAAC,KAAK,WAAW,IAAI,CAAC,MAAM,KAAK,EAAE,CAAC,EAAE,CAAC;gBACtF,KAAK,CAAC,KAAK,EAAE,CAAC;YAChB,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,iDAAiD;QACnD,CAAC;IACH,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAE3B,IAAI,CAAC;QACH,uEAAuE;QACvE,uEAAuE;QACvE,mEAAmE;QACnE,wEAAwE;QACxE,wDAAwD;QACxD,IAAI,MAAM,KAAK,EAAE;YAAE,OAAO,OAAO,CAAC;QAElC,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACzD,IACE,CAAC,OAAO;YACR,OAAO,CAAC,KAAK,KAAK,WAAW;YAC7B,OAAO,CAAC,KAAK,KAAK,WAAW;YAC7B,OAAO,CAAC,KAAK,KAAK,QAAQ,EAC1B,CAAC;YACD,OAAO,UAAU,CAAC;QACpB,CAAC;QAED,MAAM,MAAM,GAAe;YACzB,KAAK,EAAE,KAAK,CAAC,IAAI;YACjB,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC3B,GAAG,CAAC,KAAK,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC9E,GAAG,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC/C,sEAAsE;YACtE,oBAAoB;YACpB,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC/C,CAAC;QAEF,wEAAwE;QACxE,4DAA4D;QAC5D,MAAM,MAAM,GAAc,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC;QAE5C,yEAAyE;QACzE,IAAI,KAAK,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;YAC9B,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI;iBAClB,KAAK,CAAC,KAAK,EAAE,EAAE,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,UAAU,EAAE,CAAC;iBACzD,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAC5B,CAAC;QAED,yEAAyE;QACzE,mEAAmE;QACnE,kEAAkE;QAClE,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,SAAS;YAC9B,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,KAAK,IAAI;gBAC7B,CAAC,CAAC,EAAE;gBACJ,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS;YACxB,CAAC,CAAC,IAAI,CAAC;QACT,MAAM,MAAM,GAAuB,GAAG;YACpC,CAAC,CAAC;gBACE,QAAQ;gBACR,KAAK,EAAE,CAAC;gBACR,GAAG,EAAE,KAAK,CAAC,GAAG;gBACd,KAAK,EAAE,IAAI;gBACX,GAAG;gBACH,KAAK;gBACL,MAAM;gBACN,MAAM;gBACN,OAAO,EAAE,IAAI,EAAE,4BAA4B;gBAC3C,MAAM,EAAE,EAAE;gBACV,WAAW;gBACX,eAAe;gBACf,WAAW,EAAE,KAAK,CAAC,MAAM;gBACzB,KAAK,EAAE,KAAK,CAAC,KAAK;aACnB;YACH,CAAC,CAAC,IAAI,CAAC;QACT,MAAM,QAAQ,GAAwB;YACpC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;YAC3B,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,iBAAiB,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAChE,CAAC;QACF,wEAAwE;QACxE,gDAAgD;QAChD,MAAM,KAAK,GAAG,YAAY,CACxB,QAAQ,CAAC,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,EACzE,KAAK,CAAC,KAAK,IAAI,EAAE,CAClB,CAAC;QAEF,wEAAwE;QACxE,uEAAuE;QACvE,IAAI,OAAO,EAAE,KAAK,KAAK,mBAAmB,EAAE,CAAC;YAC3C,sEAAsE;YACtE,2CAA2C;YAC3C,MAAM,IAAI,GAAG,MAAM,aAAa,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;YACjD,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACtB,oEAAoE;gBACpE,2DAA2D;gBAC3D,MAAM,IAAI,KAAK,CAAC,UAAU,QAAQ,wDAAwD,CAAC,CAAC;YAC9F,CAAC;YACD,MAAM,OAAO,GAAG,MAAM,iBAAiB,CACrC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,CACrD,CAAC;YACF,IAAI,CAAC,OAAO;gBAAE,OAAO,UAAU,CAAC,CAAC,mCAAmC;QACtE,CAAC;QAED,yEAAyE;QACzE,4DAA4D;QAC5D,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;QAClE,MAAM,KAAK,GAAG,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAE7C,sEAAsE;QACtE,mEAAmE;QACnE,IAAI,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAQ,CAAC,CAAC;QACjF,IAAI,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC;YAC9B,QAAQ,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAC;QACzC,CAAC;QAED,MAAM,QAAQ,GAAG,KAAK,CAAC,IAA2B,CAAC;QAEnD,MAAM,IAAI,GAAG,MAAM,OAAO,CACxB,IAAI,EACJ,KAAK,EACL,QAAQ,EACR;YACE,OAAO,EAAE,IAAI,EAAE,iCAAiC;YAChD,KAAK;YACL,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,KAAK,EAAE,KAAK,CAAC,QAAQ,EAAE;YACvB,QAAQ;YACR,KAAK;YACL,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ;YAC9B,WAAW,EAAE,KAAK,CAAC,MAAM;YACzB,eAAe;YACf,WAAW;YACX,iBAAiB,EAAE,IAAI,CAAC,MAAM,CAAC,aAAa;YAC5C,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;gBACvB,+EAA+E;gBAC/E,MAAM,OAAO,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;gBAC9C,QAAQ,CAAC,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,4BAA4B;YAC7D,CAAC;SACF,EACD,MAAM,CACP,CAAC;QAEF,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;QACrC,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;QACrC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC;QAC3B,MAAM,gBAAgB,GAAG,IAAI,CAAC,YAAY,CAAC;QAE3C,IAAI,MAAM,EAAE,CAAC;YACX,mEAAmE;YACnE,mEAAmE;YACnE,yEAAyE;YACzE,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,EAAE,EAAE,OAAO,EAAE,KAAK,CAAC,IAAI,EAAE,GAAG,WAAW,EAAE,CAAC,CAAC;YACnF,OAAO,UAAU,CAAC;QACpB,CAAC;QAED,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC,OAAO;YACrC,CAAC,CAAC,WAAW;YACb,CAAC,CAAC,WAAW,IAAI,UAAU,IAAI,WAAW;gBACxC,CAAC,CAAC,cAAc;gBAChB,CAAC,CAAC,gBAAgB,KAAK,YAAY;oBACjC,CAAC,CAAC,WAAW,CAAC,0BAA0B;oBACxC,CAAC,CAAC,WAAW,CAAC;QAEpB,MAAM,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE;YACpC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,WAAW;YACvD,UAAU;YACV,UAAU;YACV,WAAW;YACX,WAAW,EAAE,KAAK,CAAC,IAAI,KAAK,eAAe,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS;YAClE,KAAK;YACL,KAAK,EAAE,IAAI,CAAC,KAAK;SAClB,CAAC,CAAC;QAEH,OAAO,UAAU,CAAC;IACpB,CAAC;YAAS,CAAC;QACT,aAAa,CAAC,WAAW,CAAC,CAAC;QAC3B,MAAM,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,sCAAsC;IACjF,CAAC;AACH,CAAC;AAkBD;;;;;;sDAMsD;AACtD,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,IAAkB,EAClB,KAAsB,EACtB,QAAgB,EAChB,CAAgB;IAEhB,0EAA0E;IAC1E,8CAA8C;IAC9C,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,EAAE,EAAE,OAAO,EAAE,KAAK,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;IAErF,yEAAyE;IACzE,wEAAwE;IACxE,wEAAwE;IACxE,qDAAqD;IACrD,IAAI,CAAC,CAAC,KAAK;QAAE,MAAM,cAAc,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IAEpD,6EAA6E;IAC7E,wEAAwE;IACxE,0EAA0E;IAC1E,qCAAqC;IACrC,IAAI,CAAC,CAAC,KAAK,KAAK,SAAS,IAAI,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK;QAAE,OAAO;IAEzF,IAAI,CAAC,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;QAChC,yEAAyE;QACzE,MAAM,OAAO,CAAC,IAAI,EAAE,QAAQ,EAAE,aAAa,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;IACxE,CAAC;IAED,MAAM,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,eAAe,QAAQ,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC;IACtD,MAAM,cAAc,CAAC,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC;IAC9C,MAAM,OAAO,CAAC,IAAI,EAAE,QAAQ,EAAE,cAAc,EAAE;QAC5C,KAAK,EAAE,CAAC,CAAC,KAAK;QACd,UAAU,EAAE,CAAC,CAAC,UAAU;QACxB,UAAU,EAAE,CAAC,CAAC,UAAU;QACxB,KAAK,EAAE,CAAC,CAAC,WAAW;KACrB,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;qEAQqE;AACrE,KAAK,UAAU,qBAAqB,CAClC,IAAkB,EAClB,KAAsB,EACtB,KAAmB,EACnB,WAAmB;IAEnB,IAAI,CAAC,KAAK,CAAC,KAAK;QAAE,OAAO,CAAC,mDAAmD;IAC7E,IAAI,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,KAAK;QAAE,OAAO,CAAC,gBAAgB;IAC7F,IAAI,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,KAAK;QAAE,OAAO,CAAC,mBAAmB;IAE9F,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC7D,IAAI,KAAK,IAAI,WAAW,EAAE,CAAC;QACzB,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CACvB;YACE,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE;YACtB,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,KAAK,EAAE,KAAK,CAAC,IAAI;YACjB,WAAW,EAAE,KAAK,CAAC,WAAW;YAC9B,eAAe,EAAE,KAAK,CAAC,eAAe;SACvC,EACD,EAAE,YAAY,EAAE,IAAI,CAAC,MAAM,CAAC,sBAAsB,EAAE,CACrD,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC9C,MAAM,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,KAAK,EAAE,4BAA4B,CAAC,CAAC;AACjF,CAAC;AAED;;;;yEAIyE;AACzE,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,IAAkB,EAClB,KAAsB,EACtB,KAAmB,EACnB,MAAiC,EACjC,OAAuB,OAAO;IAE9B,MAAM,WAAW,GAAG,MAAM,EAAE,WAAW,IAAI,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC;IACtE,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;QAE/C,iEAAiE;QACjE,8EAA8E;QAC9E,IAAI,OAAO,KAAK,UAAU,EAAE,CAAC;YAC3B,MAAM,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,kBAAkB,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;YACtD,MAAM,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;YAC9C,OAAO;QACT,CAAC;QAED,4DAA4D;QAC5D,IAAI,OAAO,KAAK,OAAO;YAAE,OAAO;QAEhC,MAAM,qBAAqB,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC;IAC/D,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,gEAAgE;QAChE,IAAI,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,eAAe,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,KAAK,WAAW;YAAE,OAAO;QAEjF,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,kBAAkB,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;QACxE,IAAI,QAAQ,GAAG,WAAW,EAAE,CAAC;YAC3B,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC;gBACxB,QAAQ,EAAE,KAAK,CAAC,QAAQ;gBACxB,oEAAoE;gBACpE,kEAAkE;gBAClE,+CAA+C;gBAC/C,KAAK,EAAE,KAAK,CAAC,KAAK;gBAClB,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE;gBACtB,KAAK,EAAE,KAAK,CAAC,KAAK;gBAClB,KAAK,EAAE,KAAK,CAAC,IAAI;gBACjB,WAAW,EAAE,KAAK,CAAC,WAAW;gBAC9B,eAAe,EAAE,KAAK,CAAC,eAAe;aACvC,CAAC,CAAC;QACL,CAAC;QAED,wEAAwE;QACxE,0EAA0E;QAC1E,MAAM,OAAO,CACX,IAAI,EACJ,KAAK,CAAC,QAAQ,EACd,KAAK,CAAC,KAAK,EACX,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CACjD,CAAC;QACF,MAAM,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,kBAAkB,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;IACxD,CAAC;AACH,CAAC"}

package/dist/core/follow.d.ts

@@ -0,0 +1,50 @@
+import type { RuntimePorts } from '../ports/runtime.js';
+import type { AgentEvent } from './types.js';
+export interface FollowOptions {
+    /** Resume after this seq. `-1` (the default) replays the thread from the
+     *  start. Comes from the client's cursor — `Last-Event-ID` for SSE. */
+    since?: number;
+    /** Stops the stream and unsubscribes. Wire your request's abort signal to
+     *  it, or the subscription outlives the client. */
+    signal?: AbortSignal;
+}
+/** Every event on a thread, replay first and then live, as one sequence.
+ *
+ *  The ordering here is the whole point, and it is easy to get wrong in a route
+ *  handler:
+ *
+ *   1. **Subscribe before replaying.** An event published between the replay
+ *      finishing and the tail starting is otherwise lost for ever.
+ *   2. **Never emit at or below the cursor.** The client would render it twice.
+ *   3. **`seq === 0` is a bus-only notice** (heartbeats, death notices).
+ *      Always forward it, never let it move the cursor.
+ *
+ *  Framework-neutral on purpose: an async iterable is something Express, Hono,
+ *  Nest, Next and a plain worker can each consume in their own way. */
+export declare function followEvents(deps: RuntimePorts, threadId: string, options?: FollowOptions): AsyncGenerator<AgentEvent>;
+/** Headers an SSE response needs. `X-Accel-Buffering` is for nginx, which
+ *  otherwise buffers the stream and makes it look like nothing is happening. */
+export declare const SSE_HEADERS: Record<string, string>;
+/** One event as an SSE frame.
+ *
+ *  A bus-only notice (`seq === 0`) is sent WITHOUT an `id:` line. EventSource
+ *  stores any id it sees and sends it back as `Last-Event-ID` on reconnect —
+ *  so stamping `id: 0` on a heartbeat would rewind the client's cursor to the
+ *  beginning of the thread and replay everything. */
+export declare function sseFrame(event: AgentEvent): string;
+export interface SseOptions extends FollowOptions {
+    /** Emitted once, up front: how long a browser waits before reconnecting. */
+    retryMs?: number;
+}
+export interface SseStream {
+    /** SSE-encoded bytes. Serve it directly where a web `Response` is native, or
+     *  pipe it where it is not — see the docs for Express and Nest. */
+    stream: ReadableStream<Uint8Array>;
+    headers: Record<string, string>;
+}
+/** The event sequence, encoded as Server-Sent Events.
+ *
+ *  Returns the stream and the headers rather than a `Response`, because half
+ *  the ecosystem does not have one. */
+export declare function toSseStream(events: AsyncGenerator<AgentEvent>, options?: SseOptions): SseStream;
+//# sourceMappingURL=follow.d.ts.map

package/dist/core/follow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"follow.d.ts","sourceRoot":"","sources":["../../src/core/follow.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,MAAM,WAAW,aAAa;IAC5B;2EACuE;IACvE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;uDACmD;IACnD,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED;;;;;;;;;;;;uEAYuE;AACvE,wBAAuB,YAAY,CACjC,IAAI,EAAE,YAAY,EAClB,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,aAAkB,GAC1B,cAAc,CAAC,UAAU,CAAC,CA8E5B;AAED;gFACgF;AAChF,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAK9C,CAAC;AAEF;;;;;qDAKqD;AACrD,wBAAgB,QAAQ,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAGlD;AAED,MAAM,WAAW,UAAW,SAAQ,aAAa;IAC/C,4EAA4E;IAC5E,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,SAAS;IACxB;uEACmE;IACnE,MAAM,EAAE,cAAc,CAAC,UAAU,CAAC,CAAC;IACnC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC;AAED;;;uCAGuC;AACvC,wBAAgB,WAAW,CACzB,MAAM,EAAE,cAAc,CAAC,UAAU,CAAC,EAClC,OAAO,GAAE,UAAe,GACvB,SAAS,CAqCX"}