@itaila/archetype 0.3.30

package/dist/managed/autonomous-loop.js

@@ -0,0 +1,451 @@
+/**
+ * Autonomous loop — Layer 2 primitive for multi-turn, tool-using flows.
+ *
+ * Parallel to `withStorage()` (Layer 2 for conversation-oriented personas),
+ * `runAutonomousLoop()` is the Layer 2 wrapper for personas that drive a
+ * workflow across many turns by emitting typed actions and consuming tool
+ * results.
+ *
+ * What this primitive owns — consumers do NOT re-implement these:
+ *   - Turn-by-turn history (literal transcript by default; no rebuilt briefs)
+ *   - History storage policy (assistant entries store compact outcome-aware
+ *     continuity, never the raw JSON response — raw JSON blows up context by
+ *     turn ~4 when an action carries a large file body)
+ *   - Completion detection (explicit completion actions only; "empty actions"
+ *     is treated as a stall, not a success)
+ *   - Max-turn budget + per-turn timeout + model retry
+ *   - ChatInput assembly (`message`, `history`, pass-through persona options)
+ *
+ * What consumers own — the hooks:
+ *   - `initialMessage`   → the first turn's user prompt
+ *   - `formatToolResult` → how the prior turn's tool result becomes the next
+ *                          turn's user prompt. THIS IS THE DIFFERENTIATOR
+ *                          between autonomous-loop integrations. It's where
+ *                          you decide how much workspace context the model
+ *                          sees, and in what shape.
+ *   - `executeAction`    → run the action, produce a structured result
+ *   - `completionActionNames` → which action names (e.g. `returnToSession`)
+ *                          should terminate the loop; defaults to empty, and
+ *                          consumers can also return an explicit `finish`
+ *                          from `executeAction`.
+ *   - `onBeforeChat`     → observer hook invoked with the assembled chat
+ *                          request before calling the provider. Use for
+ *                          prompt tracing.
+ *   - `onTurn`           → observer hook invoked after each turn's result is
+ *                          recorded. Use for logging/evidence gathering.
+ *
+ * Design note: the primitive deliberately does NOT expose a knob for
+ * "synthetic history" or "rebuilt task-frame every turn." Those anti-patterns
+ * are the problem this primitive solves — they force the model to re-enter a
+ * reconstructed situation on every turn instead of extending its own trace,
+ * and the race post-mortem (`foundry/docs/PI_VS_FOUNDRY_WHAT_ARE_WE_MISSING.md`)
+ * showed that's a material loss of momentum. If the hypothesis changes,
+ * change this primitive; don't patch around it at the consumer layer.
+ */
+import { buildChatLLMRequest } from '../core/request-builder.js';
+import { buildAssistantContinuityMessage } from '../engine/continuity.js';
+const DEFAULT_TURN_TIMEOUT_MS = 90_000;
+const DEFAULT_MODEL_RETRIES = 2;
+const DEFAULT_RETRY_DELAY_MS = 2_000;
+const MAX_CONSECUTIVE_STALLS = 3;
+export async function runAutonomousLoop(input) {
+    validateHooks(input.hooks);
+    const state = {
+        history: [],
+        records: [],
+        finish: null,
+        turnsUsed: 0,
+        consecutiveStalls: 0,
+    };
+    const turnTimeoutMs = input.turnTimeoutMs ?? DEFAULT_TURN_TIMEOUT_MS;
+    const modelRetries = input.modelRetries ?? DEFAULT_MODEL_RETRIES;
+    const retryDelayMs = input.modelRetryDelayMs ?? DEFAULT_RETRY_DELAY_MS;
+    const completionNames = new Set(input.hooks.completionActionNames ?? []);
+    for (let turn = 1; turn <= input.maxTurns; turn += 1) {
+        const ctx = {
+            turn,
+            maxTurns: input.maxTurns,
+            run: input.run,
+        };
+        const message = buildTurnMessage(state, input.hooks, ctx);
+        // Collect any multimodal attachments the previous turn's tool result
+        // set. Attachments are delivered once (this turn) and intentionally not
+        // persisted in history — future turns see only the text outcome, not
+        // the bytes. A browserScreenshot returning a PNG is the canonical case.
+        const priorAttachments = collectPriorToolAttachments(state);
+        const chatOptions = await resolveLoopChatOptions(input.hooks.chatOptions, ctx, state);
+        const chatInput = {
+            ...chatOptions,
+            message,
+            history: [...state.history],
+            ...(priorAttachments.length > 0 ? { attachments: priorAttachments } : {}),
+        };
+        const turnPersona = typeof input.persona === 'function'
+            ? await input.persona(ctx)
+            : input.persona;
+        let result;
+        try {
+            result = await callPersonaWithRetry({
+                persona: turnPersona,
+                chatInput,
+                turn,
+                turnTimeoutMs,
+                modelRetries,
+                retryDelayMs,
+                onBeforeChat: input.hooks.onBeforeChat,
+            });
+        }
+        catch (error) {
+            // Provider-level error (MALFORMED_FUNCTION_CALL, empty response, timeout,
+            // etc.). Surface only factual continuity to the next turn. Do not turn
+            // infrastructure load/timeouts into strategy advice for the agent.
+            const summary = error instanceof Error ? error.message : String(error);
+            const infrastructureLoad = isInfrastructureLoadError(summary);
+            if (infrastructureLoad) {
+                console.error(`\x1b[33m[archetype PROVIDER LOAD]\x1b[0m Turn ${turn}: ${summary}. `
+                    + `No actions ran. The next turn will retry the same active work after recording the timeout.`);
+            }
+            else {
+                console.error(`\x1b[31m[archetype PROVIDER ERROR]\x1b[0m Turn ${turn}: ${summary}. `
+                    + `No actions ran. If this repeats, inspect the prompt dump and provider payload.`);
+            }
+            state.records.push({
+                turn,
+                message,
+                assistantMessage: '',
+                action: null,
+                toolResult: null,
+                rawAssistantResponse: null,
+                providerError: summary,
+            });
+            state.turnsUsed = turn;
+            state.consecutiveStalls += 1;
+            if (state.consecutiveStalls >= MAX_CONSECUTIVE_STALLS) {
+                state.finish = {
+                    outcome: 'blocked',
+                    summary: `Autonomous loop: ${MAX_CONSECUTIVE_STALLS} consecutive provider failures. Last: ${summary}`,
+                };
+                break;
+            }
+            continue;
+        }
+        const actions = Array.isArray(result.actions) ? result.actions : [];
+        // Execute all emitted actions sequentially. Gemini's native function-
+        // calling API natively returns multiple `functionCall` parts per turn,
+        // and pi's coding agent supports this; rejecting multi-action turns was a
+        // holdover from the focus-mode assumption of one-action-per-turn. Each
+        // action executes in emission order, its tool result feeds into the
+        // aggregate. Early-exit if any action's result sets `finish`.
+        const actionResults = input.hooks.executeActions
+            ? await input.hooks.executeActions(actions, ctx)
+            : [];
+        if (!input.hooks.executeActions) {
+            for (const a of actions) {
+                const r = await input.hooks.executeAction(a, ctx);
+                actionResults.push({ action: a, result: r });
+                if (r.finish)
+                    break;
+            }
+        }
+        const action = actions[0] ?? null;
+        const toolResult = actionResults[0]?.result ?? null;
+        // Validation errors: the model emitted actions the contract rejected
+        // (unknown_action, invalid). Archetype's chat.ts puts these on
+        // ChatResult.trace.actions but by default they disappear into the void —
+        // the model sees no tool result and no explanation. Log strongly AND
+        // attach to the record so the next turn can surface the error to the
+        // model.
+        const validationErrors = (result.trace?.actions ?? [])
+            .filter(a => a.status === 'invalid' || a.status === 'unknown_action')
+            .map(a => ({ name: a.name, status: a.status, error: a.error }));
+        if (validationErrors.length > 0) {
+            console.error(`\x1b[31m[archetype CONFUSED PROMPT]\x1b[0m Turn ${turn}: model emitted ${validationErrors.length} action(s) the contract rejected. `
+                + `This means the prompt / tool schema we gave the model was ambiguous or misleading — the model made a reasonable try and we said no. `
+                + `Surfacing to the model as feedback.\n`
+                + validationErrors.map(e => `  - ${e.status} "${e.name}": ${e.error ?? '(no detail)'}`).join('\n'));
+        }
+        // Update history: user message, then a compact assistant-history entry.
+        // Future turns should see outcome continuity, not raw assistant JSON.
+        // Providers that reconstruct native function-call history opt into a
+        // compact JSON transport that preserves action references while dropping
+        // large payload bodies.
+        state.history.push({ role: 'user', content: message });
+        state.history.push({
+            role: 'assistant',
+            content: buildAssistantContinuityMessage({
+                message: result.message,
+                modelOutcomeNotes: result.outcomeNotes,
+                actionOutcomes: actionResults.map(({ action, result: toolResult }) => ({
+                    action,
+                    outcomeNote: toolResult.outcomeNote,
+                    text: toolResult.text,
+                    status: toolResult.finish ? `finish:${toolResult.finish.outcome}` : undefined,
+                    success: toolResult.finish ? toolResult.finish.outcome === 'success' : undefined,
+                })),
+                actionsForHistory: actionResults.map(({ action }) => action),
+                historyTransport: turnPersona.config.provider.historyTransport,
+            }),
+        });
+        const record = {
+            turn,
+            message,
+            assistantMessage: result.message,
+            action,
+            toolResult,
+            rawAssistantResponse: result.raw ?? null,
+            trace: result.trace,
+            validationErrors: validationErrors.length > 0 ? validationErrors : undefined,
+            extraActionResults: actionResults.length > 1
+                ? actionResults.slice(1)
+                : undefined,
+        };
+        state.records.push(record);
+        state.turnsUsed = turn;
+        // Don't count validation-rejected as a stall: the model DID emit an
+        // action, we just rejected it. Reset the stall counter so the model has
+        // full budget to adapt.
+        state.consecutiveStalls = (action || validationErrors.length > 0) ? 0 : state.consecutiveStalls + 1;
+        if (input.hooks.onTurn) {
+            await input.hooks.onTurn(record, state);
+        }
+        // Completion checks, in priority order. Scan ALL action results for a
+        // finish signal or a completion-action-name match — any of the multi-
+        // action emissions can signal done.
+        const finishFromResults = actionResults.find(r => r.result.finish)?.result.finish;
+        if (finishFromResults) {
+            state.finish = finishFromResults;
+            break;
+        }
+        const completionAction = actionResults.find(r => r.result.executed !== false && completionNames.has(r.action.name));
+        if (completionAction) {
+            state.finish = finishFromCompletionAction(completionAction.action);
+            break;
+        }
+        if (state.consecutiveStalls >= MAX_CONSECUTIVE_STALLS) {
+            state.finish = {
+                outcome: 'blocked',
+                summary: `Autonomous loop: model stalled (returned no action for ${MAX_CONSECUTIVE_STALLS} consecutive turns).`,
+            };
+            break;
+        }
+    }
+    const finish = state.finish ?? {
+        outcome: 'blocked',
+        summary: `Reached max turns (${input.maxTurns}) without completion.`,
+    };
+    return { state, finish };
+}
+/**
+ * Translate a validation rejection into plain English. Zod's raw JSON
+ * (`[{code:"too_small",minimum:1,path:["edits",0,"oldText"],message:"String
+ * must contain at least 1 character(s)"}]`) is technically correct but
+ * reads like stack trace — the model repeated the same empty-oldText
+ * mistake four turns in a row on 2026-04-21 despite seeing that JSON each
+ * turn. Format each error to say what the field represents and why the
+ * value was invalid, without prescribing the next move.
+ */
+function formatValidationError(e) {
+    if (e.status === 'unknown_action') {
+        return (`  - Unknown action "${e.name}": not in the AVAILABLE ACTIONS list. `
+            + `The valid set is fixed by the contract above — no other names exist.`);
+    }
+    let parsed = [];
+    if (e.error) {
+        try {
+            const maybe = JSON.parse(e.error);
+            if (Array.isArray(maybe))
+                parsed = maybe;
+        }
+        catch {
+            // raw string — keep as-is
+        }
+    }
+    if (parsed.length === 0) {
+        return `  - Invalid action "${e.name}": ${e.error ?? '(no detail)'}`;
+    }
+    const details = parsed.map((issue) => {
+        const fieldPath = (issue.path ?? []).map(String).join('.');
+        const fieldRef = fieldPath || '(root)';
+        switch (issue.code) {
+            case 'too_small':
+                if (issue.expected === 'array') {
+                    return `${fieldRef} was empty — the schema requires at least ${issue.minimum ?? 1} entr${(issue.minimum ?? 1) === 1 ? 'y' : 'ies'}.`;
+                }
+                return `${fieldRef} was empty or too short — the schema requires at least ${issue.minimum ?? 1} character${(issue.minimum ?? 1) === 1 ? '' : 's'}.`;
+            case 'invalid_type':
+                return `${fieldRef} had the wrong type — expected ${issue.expected ?? '?'}, got ${issue.received ?? '?'}.`;
+            case 'unrecognized_keys':
+                return `${fieldRef} contained unrecognized keys — only the declared param names are accepted.`;
+            case 'invalid_enum_value':
+                return `${fieldRef} was not one of the allowed values — see the action's schema above.`;
+            default:
+                return `${fieldRef}: ${issue.message ?? issue.code ?? 'invalid'}.`;
+        }
+    }).join(' ');
+    return `  - "${e.name}" was rejected: ${details}`;
+}
+/**
+ * Gather attachments from the most recent turn's tool results. Only the
+ * "prior turn" contributes. We deliver only the latest attachment once,
+ * on the turn after it was produced; screenshot-heavy tool batches should
+ * carry the final visual state without bloating the next model request.
+ */
+function collectPriorToolAttachments(state) {
+    if (state.records.length === 0)
+        return [];
+    const prior = state.records[state.records.length - 1];
+    const attachments = [];
+    if (prior.toolResult?.attachments && prior.toolResult.attachments.length > 0) {
+        attachments.push(...prior.toolResult.attachments);
+    }
+    if (prior.extraActionResults) {
+        for (const extra of prior.extraActionResults) {
+            if (extra.result.attachments && extra.result.attachments.length > 0) {
+                attachments.push(...extra.result.attachments);
+            }
+        }
+    }
+    const latest = attachments.at(-1);
+    return latest ? [latest] : [];
+}
+function validateHooks(hooks) {
+    if (typeof hooks.initialMessage !== 'function') {
+        throw new Error('runAutonomousLoop: hooks.initialMessage must be a function');
+    }
+    if (typeof hooks.formatToolResult !== 'function') {
+        throw new Error('runAutonomousLoop: hooks.formatToolResult must be a function');
+    }
+    if (typeof hooks.executeAction !== 'function') {
+        throw new Error('runAutonomousLoop: hooks.executeAction must be a function');
+    }
+    if (hooks.chatOptions) {
+        if (typeof hooks.chatOptions === 'function')
+            return;
+        const options = hooks.chatOptions;
+        if ('message' in options || 'history' in options) {
+            throw new Error('runAutonomousLoop: hooks.chatOptions may not include `message` or `history` — those are primitive-owned.');
+        }
+    }
+}
+async function resolveLoopChatOptions(chatOptions, ctx, state) {
+    const resolved = typeof chatOptions === 'function'
+        ? await chatOptions(ctx, state)
+        : (chatOptions ?? {});
+    if ('message' in resolved || 'history' in resolved) {
+        throw new Error('runAutonomousLoop: hooks.chatOptions may not include `message` or `history` — those are primitive-owned.');
+    }
+    return resolved;
+}
+function buildTurnMessage(state, hooks, ctx) {
+    // Turn 1 — initial message.
+    if (state.records.length === 0) {
+        return hooks.initialMessage(ctx);
+    }
+    const prior = state.records[state.records.length - 1];
+    // Provider error: preserve the active work and add neutral continuity.
+    // Timeouts/load are infrastructure facts, not evidence that the agent chose
+    // a bad strategy or needs to make the artifact smaller.
+    if (prior.providerError) {
+        return (`${prior.message}\n\n`
+            + `The LLM request timed out or the provider was under heavy load. No actions ran.\n`
+            + `${prior.providerError}\n\n`
+            + `Please try again from the same active work.`);
+    }
+    // Validation errors: the model emitted actions that the contract rejected.
+    // Translate each rejection into plain language so the model can see WHY
+    // the call was invalid and what the field is. Echoing the raw Zod JSON
+    // is not enough — we saw the same model emit the same empty-oldText
+    // editFile four turns in a row, because the tail "pick closest available
+    // shape" read as guess-advice, not as "your oldText field was empty."
+    if (prior.validationErrors && prior.validationErrors.length > 0 && !prior.action) {
+        const lines = prior.validationErrors.map((e) => formatValidationError(e)).join('\n');
+        return `Previous action(s) rejected by the tool contract:\n${lines}`;
+    }
+    // Normal tool result — single or multi-action. For multi-action turns,
+    // format each result and join; the model then sees all its tool calls'
+    // outputs in emission order.
+    if (prior.action && prior.toolResult) {
+        const head = hooks.formatToolResult(prior.action, prior.toolResult, ctx);
+        if (!prior.extraActionResults || prior.extraActionResults.length === 0) {
+            return head;
+        }
+        const tail = prior.extraActionResults
+            .map(({ action, result }) => hooks.formatToolResult(action, result, ctx))
+            .join('\n\n');
+        return `${head}\n\n${tail}`;
+    }
+    // Fallback — no action, no error, no tool result (shouldn't happen but keep
+    // a factual nudge).
+    return '(your previous turn produced no action — continue with a concrete next step or call the completion action if you are done)';
+}
+async function callPersonaWithRetry(args) {
+    let lastError = null;
+    for (let attempt = 1; attempt <= args.modelRetries + 1; attempt += 1) {
+        try {
+            if (args.onBeforeChat) {
+                const { request } = buildChatLLMRequest(args.persona.config, args.chatInput);
+                await args.onBeforeChat({
+                    request: {
+                        systemPrompt: request.systemPrompt,
+                        message: request.message,
+                        history: request.history,
+                        attachments: request.attachments,
+                        responseSchema: request.responseSchema,
+                        promptMode: request.promptMode,
+                    },
+                    turn: args.turn,
+                    attempt,
+                });
+            }
+            return await withTimeout(args.persona.chat(args.chatInput), args.turnTimeoutMs, `Autonomous loop turn ${args.turn} timed out after ${args.turnTimeoutMs}ms`);
+        }
+        catch (error) {
+            lastError = error;
+            const message = error instanceof Error ? error.message : String(error);
+            if (attempt > args.modelRetries || !shouldRetry(message)) {
+                throw error;
+            }
+            await sleep(args.retryDelayMs * attempt);
+        }
+    }
+    throw lastError ?? new Error(`Autonomous loop turn ${args.turn} failed`);
+}
+function withTimeout(promise, ms, message) {
+    return new Promise((resolve, reject) => {
+        const timer = setTimeout(() => reject(new Error(message)), ms);
+        promise.then(value => {
+            clearTimeout(timer);
+            resolve(value);
+        }, error => {
+            clearTimeout(timer);
+            reject(error);
+        });
+    });
+}
+function shouldRetry(message) {
+    return /timed out|timeout|ECONNRESET|ETIMEDOUT|socket hang up|fetch failed|503|504|429/i.test(message);
+}
+function isInfrastructureLoadError(message) {
+    return /timed out|timeout|ECONNRESET|ETIMEDOUT|socket hang up|fetch failed|503|504|429|overloaded|unavailable|resource exhausted/i.test(message);
+}
+function sleep(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
+function normalizeOutcome(value) {
+    if (value === 'success' || value === 'blocked' || value === 'failed')
+        return value;
+    return 'blocked';
+}
+function finishFromCompletionAction(action) {
+    const params = action.params;
+    return {
+        outcome: normalizeCompletionState(params.outcome ?? params.state),
+        summary: params.summary ?? params.message ?? `Completion action ${action.name} called.`,
+    };
+}
+function normalizeCompletionState(value) {
+    if (value === 'ready')
+        return 'success';
+    return normalizeOutcome(value);
+}
+//# sourceMappingURL=autonomous-loop.js.map

package/dist/managed/autonomous-loop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"autonomous-loop.js","sourceRoot":"","sources":["../../src/managed/autonomous-loop.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AAIH,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAA;AAChE,OAAO,EAAE,+BAA+B,EAAE,MAAM,yBAAyB,CAAA;AA8JzE,MAAM,uBAAuB,GAAG,MAAM,CAAA;AACtC,MAAM,qBAAqB,GAAG,CAAC,CAAA;AAC/B,MAAM,sBAAsB,GAAG,KAAK,CAAA;AACpC,MAAM,sBAAsB,GAAG,CAAC,CAAA;AAEhC,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,KAAmC;IAEnC,aAAa,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;IAE1B,MAAM,KAAK,GAAc;QACvB,OAAO,EAAE,EAAE;QACX,OAAO,EAAE,EAAE;QACX,MAAM,EAAE,IAAI;QACZ,SAAS,EAAE,CAAC;QACZ,iBAAiB,EAAE,CAAC;KACrB,CAAA;IAED,MAAM,aAAa,GAAG,KAAK,CAAC,aAAa,IAAI,uBAAuB,CAAA;IACpE,MAAM,YAAY,GAAG,KAAK,CAAC,YAAY,IAAI,qBAAqB,CAAA;IAChE,MAAM,YAAY,GAAG,KAAK,CAAC,iBAAiB,IAAI,sBAAsB,CAAA;IACtE,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,qBAAqB,IAAI,EAAE,CAAC,CAAA;IAExE,KAAK,IAAI,IAAI,GAAG,CAAC,EAAE,IAAI,IAAI,KAAK,CAAC,QAAQ,EAAE,IAAI,IAAI,CAAC,EAAE,CAAC;QACrD,MAAM,GAAG,GAA0B;YACjC,IAAI;YACJ,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,GAAG,EAAE,KAAK,CAAC,GAAG;SACf,CAAA;QAED,MAAM,OAAO,GAAG,gBAAgB,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC,CAAA;QAEzD,qEAAqE;QACrE,wEAAwE;QACxE,qEAAqE;QACrE,wEAAwE;QACxE,MAAM,gBAAgB,GAAG,2BAA2B,CAAC,KAAK,CAAC,CAAA;QAE3D,MAAM,WAAW,GAAG,MAAM,sBAAsB,CAAC,KAAK,CAAC,KAAK,CAAC,WAAW,EAAE,GAAG,EAAE,KAAK,CAAC,CAAA;QACrF,MAAM,SAAS,GAAc;YAC3B,GAAG,WAAW;YACd,OAAO;YACP,OAAO,EAAE,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC;YAC3B,GAAG,CAAC,gBAAgB,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,gBAAgB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC1E,CAAA;QAED,MAAM,WAAW,GAAG,OAAO,KAAK,CAAC,OAAO,KAAK,UAAU;YACrD,CAAC,CAAC,MAAM,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;YAC1B,CAAC,CAAC,KAAK,CAAC,OAAO,CAAA;QAEjB,IAAI,MAAkB,CAAA;QACtB,IAAI,CAAC;YACH,MAAM,GAAG,MAAM,oBAAoB,CAAC;gBAClC,OAAO,EAAE,WAAW;gBACpB,SAAS;gBACT,IAAI;gBACJ,aAAa;gBACb,YAAY;gBACZ,YAAY;gBACZ,YAAY,EAAE,KAAK,CAAC,KAAK,CAAC,YAAY;aACvC,CAAC,CAAA;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,0EAA0E;YAC1E,uEAAuE;YACvE,mEAAmE;YACnE,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;YACtE,MAAM,kBAAkB,GAAG,yBAAyB,CAAC,OAAO,CAAC,CAAA;YAC7D,IAAI,kBAAkB,EAAE,CAAC;gBACvB,OAAO,CAAC,KAAK,CACX,iDAAiD,IAAI,KAAK,OAAO,IAAI;sBACnE,4FAA4F,CAC/F,CAAA;YACH,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,KAAK,CACX,kDAAkD,IAAI,KAAK,OAAO,IAAI;sBACpE,gFAAgF,CACnF,CAAA;YACH,CAAC;YACD,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;gBACjB,IAAI;gBACJ,OAAO;gBACP,gBAAgB,EAAE,EAAE;gBACpB,MAAM,EAAE,IAAI;gBACZ,UAAU,EAAE,IAAI;gBAChB,oBAAoB,EAAE,IAAI;gBAC1B,aAAa,EAAE,OAAO;aACvB,CAAC,CAAA;YACF,KAAK,CAAC,SAAS,GAAG,IAAI,CAAA;YACtB,KAAK,CAAC,iBAAiB,IAAI,CAAC,CAAA;YAC5B,IAAI,KAAK,CAAC,iBAAiB,IAAI,sBAAsB,EAAE,CAAC;gBACtD,KAAK,CAAC,MAAM,GAAG;oBACb,OAAO,EAAE,SAAS;oBAClB,OAAO,EAAE,oBAAoB,sBAAsB,yCAAyC,OAAO,EAAE;iBACtG,CAAA;gBACD,MAAK;YACP,CAAC;YACD,SAAQ;QACV,CAAC;QAED,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAA;QAEnE,sEAAsE;QACtE,uEAAuE;QACvE,0EAA0E;QAC1E,uEAAuE;QACvE,oEAAoE;QACpE,8DAA8D;QAC9D,MAAM,aAAa,GAA4D,KAAK,CAAC,KAAK,CAAC,cAAc;YACvG,CAAC,CAAC,MAAM,KAAK,CAAC,KAAK,CAAC,cAAc,CAAC,OAAO,EAAE,GAAG,CAAC;YAChD,CAAC,CAAC,EAAE,CAAA;QACN,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,cAAc,EAAE,CAAC;YAChC,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;gBACxB,MAAM,CAAC,GAAG,MAAM,KAAK,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,EAAE,GAAG,CAAC,CAAA;gBACjD,aAAa,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,CAAA;gBAC5C,IAAI,CAAC,CAAC,MAAM;oBAAE,MAAK;YACrB,CAAC;QACH,CAAC;QACD,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,IAAI,IAAI,CAAA;QACjC,MAAM,UAAU,GAAG,aAAa,CAAC,CAAC,CAAC,EAAE,MAAM,IAAI,IAAI,CAAA;QAEnD,qEAAqE;QACrE,+DAA+D;QAC/D,yEAAyE;QACzE,qEAAqE;QACrE,qEAAqE;QACrE,SAAS;QACT,MAAM,gBAAgB,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,IAAI,EAAE,CAAC;aACnD,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,IAAI,CAAC,CAAC,MAAM,KAAK,gBAAgB,CAAC;aACpE,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,MAAgB,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAA;QAC3E,IAAI,gBAAgB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAChC,OAAO,CAAC,KAAK,CACX,mDAAmD,IAAI,mBAAmB,gBAAgB,CAAC,MAAM,oCAAoC;kBACnI,sIAAsI;kBACtI,uCAAuC;kBACvC,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,KAAK,IAAI,aAAa,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CACnG,CAAA;QACH,CAAC;QAED,wEAAwE;QACxE,sEAAsE;QACtE,qEAAqE;QACrE,yEAAyE;QACzE,wBAAwB;QACxB,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAA;QACtD,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;YACjB,IAAI,EAAE,WAAW;YACjB,OAAO,EAAE,+BAA+B,CAAC;gBACvC,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,iBAAiB,EAAE,MAAM,CAAC,YAAY;gBACtC,cAAc,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC,CAAC;oBACrE,MAAM;oBACN,WAAW,EAAE,UAAU,CAAC,WAAW;oBACnC,IAAI,EAAE,UAAU,CAAC,IAAI;oBACrB,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,UAAU,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,SAAS;oBAC7E,OAAO,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS;iBACjF,CAAC,CAAC;gBACH,iBAAiB,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC;gBAC5D,gBAAgB,EAAE,WAAW,CAAC,MAAM,CAAC,QAAQ,CAAC,gBAAgB;aAC/D,CAAC;SACH,CAAC,CAAA;QAEF,MAAM,MAAM,GAAmB;YAC7B,IAAI;YACJ,OAAO;YACP,gBAAgB,EAAE,MAAM,CAAC,OAAO;YAChC,MAAM;YACN,UAAU;YACV,oBAAoB,EAAE,MAAM,CAAC,GAAG,IAAI,IAAI;YACxC,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,gBAAgB,EAAE,gBAAgB,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,SAAS;YAC5E,kBAAkB,EAAE,aAAa,CAAC,MAAM,GAAG,CAAC;gBAC1C,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC;gBACxB,CAAC,CAAC,SAAS;SACd,CAAA;QACD,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QAC1B,KAAK,CAAC,SAAS,GAAG,IAAI,CAAA;QACtB,oEAAoE;QACpE,wEAAwE;QACxE,wBAAwB;QACxB,KAAK,CAAC,iBAAiB,GAAG,CAAC,MAAM,IAAI,gBAAgB,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,iBAAiB,GAAG,CAAC,CAAA;QAEnG,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;YACvB,MAAM,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;QACzC,CAAC;QAED,sEAAsE;QACtE,sEAAsE;QACtE,oCAAoC;QACpC,MAAM,iBAAiB,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,CAAA;QACjF,IAAI,iBAAiB,EAAE,CAAC;YACtB,KAAK,CAAC,MAAM,GAAG,iBAAiB,CAAA;YAChC,MAAK;QACP,CAAC;QACD,MAAM,gBAAgB,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,KAAK,KAAK,IAAI,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAA;QACnH,IAAI,gBAAgB,EAAE,CAAC;YACrB,KAAK,CAAC,MAAM,GAAG,0BAA0B,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAA;YAClE,MAAK;QACP,CAAC;QACD,IAAI,KAAK,CAAC,iBAAiB,IAAI,sBAAsB,EAAE,CAAC;YACtD,KAAK,CAAC,MAAM,GAAG;gBACb,OAAO,EAAE,SAAS;gBAClB,OAAO,EAAE,0DAA0D,sBAAsB,sBAAsB;aAChH,CAAA;YACD,MAAK;QACP,CAAC;IACH,CAAC;IAED,MAAM,MAAM,GAAe,KAAK,CAAC,MAAM,IAAI;QACzC,OAAO,EAAE,SAAS;QAClB,OAAO,EAAE,sBAAsB,KAAK,CAAC,QAAQ,uBAAuB;KACrE,CAAA;IACD,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAA;AAC1B,CAAC;AAED;;;;;;;;GAQG;AACH,SAAS,qBAAqB,CAC5B,CAAmD;IAEnD,IAAI,CAAC,CAAC,MAAM,KAAK,gBAAgB,EAAE,CAAC;QAClC,OAAO,CACL,uBAAuB,CAAC,CAAC,IAAI,wCAAwC;cACnE,sEAAsE,CACzE,CAAA;IACH,CAAC;IAID,IAAI,MAAM,GAAe,EAAE,CAAA;IAC3B,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC;QACZ,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAY,CAAA;YAC5C,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;gBAAE,MAAM,GAAG,KAAmB,CAAA;QACxD,CAAC;QAAC,MAAM,CAAC;YACP,0BAA0B;QAC5B,CAAC;IACH,CAAC;IACD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,uBAAuB,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,KAAK,IAAI,aAAa,EAAE,CAAA;IACtE,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QACnC,MAAM,SAAS,GAAG,CAAC,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QAC1D,MAAM,QAAQ,GAAG,SAAS,IAAI,QAAQ,CAAA;QACtC,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;YACnB,KAAK,WAAW;gBACd,IAAI,KAAK,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;oBAC/B,OAAO,GAAG,QAAQ,6CAA6C,KAAK,CAAC,OAAO,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,GAAG,CAAA;gBACtI,CAAC;gBACD,OAAO,GAAG,QAAQ,0DAA0D,KAAK,CAAC,OAAO,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,CAAA;YACrJ,KAAK,cAAc;gBACjB,OAAO,GAAG,QAAQ,kCAAkC,KAAK,CAAC,QAAQ,IAAI,GAAG,SAAS,KAAK,CAAC,QAAQ,IAAI,GAAG,GAAG,CAAA;YAC5G,KAAK,mBAAmB;gBACtB,OAAO,GAAG,QAAQ,4EAA4E,CAAA;YAChG,KAAK,oBAAoB;gBACvB,OAAO,GAAG,QAAQ,qEAAqE,CAAA;YACzF;gBACE,OAAO,GAAG,QAAQ,KAAK,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,IAAI,IAAI,SAAS,GAAG,CAAA;QACtE,CAAC;IACH,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IACZ,OAAO,QAAQ,CAAC,CAAC,IAAI,mBAAmB,OAAO,EAAE,CAAA;AACnD,CAAC;AAED;;;;;GAKG;AACH,SAAS,2BAA2B,CAAC,KAAgB;IACnD,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAA;IACzC,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;IACrD,MAAM,WAAW,GAAqB,EAAE,CAAA;IACxC,IAAI,KAAK,CAAC,UAAU,EAAE,WAAW,IAAI,KAAK,CAAC,UAAU,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC7E,WAAW,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,UAAU,CAAC,WAAW,CAAC,CAAA;IACnD,CAAC;IACD,IAAI,KAAK,CAAC,kBAAkB,EAAE,CAAC;QAC7B,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,kBAAkB,EAAE,CAAC;YAC7C,IAAI,KAAK,CAAC,MAAM,CAAC,WAAW,IAAI,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACpE,WAAW,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,CAAA;YAC/C,CAAC;QACH,CAAC;IACH,CAAC;IACD,MAAM,MAAM,GAAG,WAAW,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAA;IACjC,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;AAC/B,CAAC;AAED,SAAS,aAAa,CAAO,KAAgC;IAC3D,IAAI,OAAO,KAAK,CAAC,cAAc,KAAK,UAAU,EAAE,CAAC;QAC/C,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAA;IAC/E,CAAC;IACD,IAAI,OAAO,KAAK,CAAC,gBAAgB,KAAK,UAAU,EAAE,CAAC;QACjD,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAA;IACjF,CAAC;IACD,IAAI,OAAO,KAAK,CAAC,aAAa,KAAK,UAAU,EAAE,CAAC;QAC9C,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,CAAA;IAC9E,CAAC;IACD,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC;QACtB,IAAI,OAAO,KAAK,CAAC,WAAW,KAAK,UAAU;YAAE,OAAM;QACnD,MAAM,OAAO,GAAG,KAAK,CAAC,WAAsC,CAAA;QAC5D,IAAI,SAAS,IAAI,OAAO,IAAI,SAAS,IAAI,OAAO,EAAE,CAAC;YACjD,MAAM,IAAI,KAAK,CACb,0GAA0G,CAC3G,CAAA;QACH,CAAC;IACH,CAAC;AACH,CAAC;AAED,KAAK,UAAU,sBAAsB,CACnC,WAAqD,EACrD,GAA0B,EAC1B,KAAgB;IAEhB,MAAM,QAAQ,GAAG,OAAO,WAAW,KAAK,UAAU;QAChD,CAAC,CAAC,MAAM,WAAW,CAAC,GAAG,EAAE,KAAK,CAAC;QAC/B,CAAC,CAAC,CAAC,WAAW,IAAI,EAAE,CAAC,CAAA;IACvB,IAAI,SAAS,IAAI,QAAQ,IAAI,SAAS,IAAI,QAAQ,EAAE,CAAC;QACnD,MAAM,IAAI,KAAK,CACb,0GAA0G,CAC3G,CAAA;IACH,CAAC;IACD,OAAO,QAAQ,CAAA;AACjB,CAAC;AAED,SAAS,gBAAgB,CACvB,KAAgB,EAChB,KAAgC,EAChC,GAA0B;IAE1B,4BAA4B;IAC5B,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,OAAO,KAAK,CAAC,cAAc,CAAC,GAAG,CAAC,CAAA;IAClC,CAAC;IACD,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;IACrD,uEAAuE;IACvE,4EAA4E;IAC5E,wDAAwD;IACxD,IAAI,KAAK,CAAC,aAAa,EAAE,CAAC;QACxB,OAAO,CACL,GAAG,KAAK,CAAC,OAAO,MAAM;cACpB,mFAAmF;cACnF,GAAG,KAAK,CAAC,aAAa,MAAM;cAC5B,6CAA6C,CAChD,CAAA;IACH,CAAC;IACD,2EAA2E;IAC3E,wEAAwE;IACxE,uEAAuE;IACvE,oEAAoE;IACpE,yEAAyE;IACzE,sEAAsE;IACtE,IAAI,KAAK,CAAC,gBAAgB,IAAI,KAAK,CAAC,gBAAgB,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;QACjF,MAAM,KAAK,GAAG,KAAK,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACpF,OAAO,sDAAsD,KAAK,EAAE,CAAA;IACtE,CAAC;IACD,uEAAuE;IACvE,uEAAuE;IACvE,6BAA6B;IAC7B,IAAI,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;QACrC,MAAM,IAAI,GAAG,KAAK,CAAC,gBAAgB,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,UAAU,EAAE,GAAG,CAAC,CAAA;QACxE,IAAI,CAAC,KAAK,CAAC,kBAAkB,IAAI,KAAK,CAAC,kBAAkB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvE,OAAO,IAAI,CAAA;QACb,CAAC;QACD,MAAM,IAAI,GAAG,KAAK,CAAC,kBAAkB;aAClC,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC;aACxE,IAAI,CAAC,MAAM,CAAC,CAAA;QACf,OAAO,GAAG,IAAI,OAAO,IAAI,EAAE,CAAA;IAC7B,CAAC;IACD,4EAA4E;IAC5E,oBAAoB;IACpB,OAAO,4HAA4H,CAAA;AACrI,CAAC;AAED,KAAK,UAAU,oBAAoB,CAAC,IAQnC;IACC,IAAI,SAAS,GAAY,IAAI,CAAA;IAC7B,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,IAAI,CAAC,YAAY,GAAG,CAAC,EAAE,OAAO,IAAI,CAAC,EAAE,CAAC;QACrE,IAAI,CAAC;YACH,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;gBACtB,MAAM,EAAE,OAAO,EAAE,GAAG,mBAAmB,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,CAAA;gBAC5E,MAAM,IAAI,CAAC,YAAY,CAAC;oBACtB,OAAO,EAAE;wBACP,YAAY,EAAE,OAAO,CAAC,YAAY;wBAClC,OAAO,EAAE,OAAO,CAAC,OAAO;wBACxB,OAAO,EAAE,OAAO,CAAC,OAAO;wBACxB,WAAW,EAAE,OAAO,CAAC,WAAW;wBAChC,cAAc,EAAE,OAAO,CAAC,cAAc;wBACtC,UAAU,EAAE,OAAO,CAAC,UAAU;qBAC/B;oBACD,IAAI,EAAE,IAAI,CAAC,IAAI;oBACf,OAAO;iBACR,CAAC,CAAA;YACJ,CAAC;YACD,OAAO,MAAM,WAAW,CACtB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,EACjC,IAAI,CAAC,aAAa,EAClB,wBAAwB,IAAI,CAAC,IAAI,oBAAoB,IAAI,CAAC,aAAa,IAAI,CAC5E,CAAA;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,SAAS,GAAG,KAAK,CAAA;YACjB,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;YACtE,IAAI,OAAO,GAAG,IAAI,CAAC,YAAY,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE,CAAC;gBACzD,MAAM,KAAK,CAAA;YACb,CAAC;YACD,MAAM,KAAK,CAAC,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,CAAA;QAC1C,CAAC;IACH,CAAC;IACD,MAAM,SAAS,IAAI,IAAI,KAAK,CAAC,wBAAwB,IAAI,CAAC,IAAI,SAAS,CAAC,CAAA;AAC1E,CAAC;AAED,SAAS,WAAW,CAAI,OAAmB,EAAE,EAAU,EAAE,OAAe;IACtE,OAAO,IAAI,OAAO,CAAI,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACxC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;QAC9D,OAAO,CAAC,IAAI,CACV,KAAK,CAAC,EAAE;YACN,YAAY,CAAC,KAAK,CAAC,CAAA;YACnB,OAAO,CAAC,KAAK,CAAC,CAAA;QAChB,CAAC,EACD,KAAK,CAAC,EAAE;YACN,YAAY,CAAC,KAAK,CAAC,CAAA;YACnB,MAAM,CAAC,KAAK,CAAC,CAAA;QACf,CAAC,CACF,CAAA;IACH,CAAC,CAAC,CAAA;AACJ,CAAC;AAED,SAAS,WAAW,CAAC,OAAe;IAClC,OAAO,iFAAiF,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;AACxG,CAAC;AAED,SAAS,yBAAyB,CAAC,OAAe;IAChD,OAAO,2HAA2H,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;AAClJ,CAAC;AAED,SAAS,KAAK,CAAC,EAAU;IACvB,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAA;AACxD,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAc;IACtC,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAA;IAClF,OAAO,SAAS,CAAA;AAClB,CAAC;AAED,SAAS,0BAA0B,CAAC,MAAoB;IACtD,MAAM,MAAM,GAAG,MAAM,CAAC,MAKrB,CAAA;IACD,OAAO;QACL,OAAO,EAAE,wBAAwB,CAAC,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,KAAK,CAAC;QACjE,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,OAAO,IAAI,qBAAqB,MAAM,CAAC,IAAI,UAAU;KACxF,CAAA;AACH,CAAC;AAED,SAAS,wBAAwB,CAAC,KAAc;IAC9C,IAAI,KAAK,KAAK,OAAO;QAAE,OAAO,SAAS,CAAA;IACvC,OAAO,gBAAgB,CAAC,KAAK,CAAC,CAAA;AAChC,CAAC"}

package/dist/managed/conversation.d.ts

@@ -0,0 +1,20 @@
+import type { StorageAdapter } from '../types.js';
+/**
+ * Resolve or create a conversation.
+ * Returns the conversation ID (existing or newly created).
+ */
+export declare function resolveConversation(adapter: StorageAdapter, conversationId?: string | null, trigger?: string, metadata?: Record<string, unknown>): Promise<string>;
+/**
+ * Load conversation history for LLM input.
+ * Returns non-note messages in chronological order, up to limit.
+ */
+export declare function loadHistory(adapter: StorageAdapter, conversationId: string, limit: number): Promise<Array<{
+    role: 'user' | 'assistant';
+    content: string;
+}>>;
+export declare function loadAttachmentCarryForwardSections(adapter: StorageAdapter, conversationId: string, limit: number): Promise<string[]>;
+/**
+ * End a conversation by setting its endedAt timestamp.
+ */
+export declare function endConversation(adapter: StorageAdapter, conversationId: string): Promise<void>;
+//# sourceMappingURL=conversation.d.ts.map

package/dist/managed/conversation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation.d.ts","sourceRoot":"","sources":["../../src/managed/conversation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAyB,MAAM,aAAa,CAAA;AAMxE;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,cAAc,EACvB,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,EAC9B,OAAO,CAAC,EAAE,MAAM,EAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,OAAO,CAAC,MAAM,CAAC,CASjB;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,OAAO,EAAE,cAAc,EACvB,cAAc,EAAE,MAAM,EACtB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,CAKjE;AAED,wBAAsB,kCAAkC,CACtD,OAAO,EAAE,cAAc,EACvB,cAAc,EAAE,MAAM,EACtB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,MAAM,EAAE,CAAC,CAOnB;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,cAAc,EACvB,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,IAAI,CAAC,CAEf"}

package/dist/managed/conversation.js

@@ -0,0 +1,40 @@
+import { buildAttachmentCarryForwardSection, collectAttachmentCarryForwardNotes, } from '../core/attachment-notes.js';
+/**
+ * Resolve or create a conversation.
+ * Returns the conversation ID (existing or newly created).
+ */
+export async function resolveConversation(adapter, conversationId, trigger, metadata) {
+    if (conversationId)
+        return conversationId;
+    // Try to find an active conversation
+    const active = await adapter.getActiveConversation();
+    if (active)
+        return active.id;
+    // Create a new one
+    return adapter.createConversation(trigger ?? 'manual', metadata);
+}
+/**
+ * Load conversation history for LLM input.
+ * Returns non-note messages in chronological order, up to limit.
+ */
+export async function loadHistory(adapter, conversationId, limit) {
+    const messages = await adapter.getMessages(conversationId, limit);
+    return messages
+        .filter(m => !m.isNote && (m.role === 'user' || m.role === 'assistant'))
+        .map(m => ({ role: m.role, content: m.content }));
+}
+export async function loadAttachmentCarryForwardSections(adapter, conversationId, limit) {
+    const messages = await adapter.getMessages(conversationId, limit);
+    const notes = collectAttachmentCarryForwardNotes(messages);
+    if (notes.length === 0)
+        return [];
+    const section = buildAttachmentCarryForwardSection(notes);
+    return section ? [section] : [];
+}
+/**
+ * End a conversation by setting its endedAt timestamp.
+ */
+export async function endConversation(adapter, conversationId) {
+    await adapter.endConversation(conversationId);
+}
+//# sourceMappingURL=conversation.js.map

package/dist/managed/conversation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation.js","sourceRoot":"","sources":["../../src/managed/conversation.ts"],"names":[],"mappings":"AACA,OAAO,EACL,kCAAkC,EAClC,kCAAkC,GACnC,MAAM,6BAA6B,CAAA;AAEpC;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,OAAuB,EACvB,cAA8B,EAC9B,OAAgB,EAChB,QAAkC;IAElC,IAAI,cAAc;QAAE,OAAO,cAAc,CAAA;IAEzC,qCAAqC;IACrC,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,qBAAqB,EAAE,CAAA;IACpD,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC,EAAE,CAAA;IAE5B,mBAAmB;IACnB,OAAO,OAAO,CAAC,kBAAkB,CAAC,OAAO,IAAI,QAAQ,EAAE,QAAQ,CAAC,CAAA;AAClE,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,OAAuB,EACvB,cAAsB,EACtB,KAAa;IAEb,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,WAAW,CAAC,cAAc,EAAE,KAAK,CAAC,CAAA;IACjE,OAAO,QAAQ;SACZ,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,IAAI,CAAC,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC;SACvE,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAA4B,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAA;AAC7E,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kCAAkC,CACtD,OAAuB,EACvB,cAAsB,EACtB,KAAa;IAEb,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,WAAW,CAAC,cAAc,EAAE,KAAK,CAAC,CAAA;IACjE,MAAM,KAAK,GAAG,kCAAkC,CAAC,QAAQ,CAAC,CAAA;IAC1D,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAA;IAEjC,MAAM,OAAO,GAAG,kCAAkC,CAAC,KAAK,CAAC,CAAA;IACzD,OAAO,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;AACjC,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,OAAuB,EACvB,cAAsB;IAEtB,MAAM,OAAO,CAAC,eAAe,CAAC,cAAc,CAAC,CAAA;AAC/C,CAAC"}

package/dist/managed/knowledge.d.ts

@@ -0,0 +1,7 @@
+import type { KnowledgeAdapter } from '../types.js';
+export interface MarkdownKnowledgeAdapterOptions {
+    rootDir: string;
+    includeDrafts?: boolean;
+}
+export declare function createMarkdownKnowledgeAdapter(options: MarkdownKnowledgeAdapterOptions): KnowledgeAdapter;
+//# sourceMappingURL=knowledge.d.ts.map

package/dist/managed/knowledge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge.d.ts","sourceRoot":"","sources":["../../src/managed/knowledge.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAA2C,MAAM,aAAa,CAAA;AAE5F,MAAM,WAAW,+BAA+B;IAC9C,OAAO,EAAE,MAAM,CAAA;IACf,aAAa,CAAC,EAAE,OAAO,CAAA;CACxB;AAUD,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,+BAA+B,GACvC,gBAAgB,CAiClB"}