@orion-agents/orion-code 0.1.8 → 0.2.0

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

@@ -0,0 +1,78 @@
+import { type QueryEvent, type QueryParams } from '../framework/query';
+import type { ToolContext } from '../framework/tool';
+import type { LoopBudget } from '../framework/query';
+import type { LLMService, Message, StreamCallbacks } from '../services/llm';
+import type { TaskContextCompletionDecisionV1, TaskContextService } from './task-context-service';
+import type { StepSnapshotV1, ToolBindingV1 } from './step-snapshot';
+import type { ThreadEventStore } from './thread-event-store';
+import type { ThreadTurnExecutionContextV1, ThreadTurnOutcomeV1, ThreadTurnRunnerV1 } from './thread-runtime';
+import { ToolGateway } from './tool-gateway';
+export interface AgentLoopPreparedStepV1 {
+    readonly stepId: string;
+    readonly toolBindings: readonly ToolBindingV1[];
+    readonly capture: (input: {
+        readonly messages: readonly Message[];
+        readonly taskContextRevision: number;
+    }) => StepSnapshotV1 | Promise<StepSnapshotV1>;
+}
+export interface AgentLoopStepFactoryV1 {
+    prepare(input: {
+        readonly threadId: string;
+        readonly turnId: string;
+        readonly requestIndex: number;
+        readonly input: string;
+        readonly mode: ThreadTurnExecutionContextV1['mode'];
+        readonly messages: readonly Message[];
+        readonly taskContextRevision: number;
+        readonly abortSignal: AbortSignal;
+    }): AgentLoopPreparedStepV1 | Promise<AgentLoopPreparedStepV1>;
+}
+export interface AgentLoopTurnCommitV1 {
+    readonly threadId: string;
+    readonly turnId: string;
+    readonly queryComplete: Extract<QueryEvent, {
+        type: 'complete';
+    }>;
+    readonly taskContextState: ReturnType<TaskContextService['exportState']>;
+    readonly taskContextRevision: number;
+    readonly taskContextCompletion?: TaskContextCompletionDecisionV1;
+    readonly history: readonly Message[];
+    readonly digest: string;
+}
+export interface AgentLoopOptionsV1 {
+    readonly llm: LLMService;
+    readonly taskContext: TaskContextService;
+    readonly steps: AgentLoopStepFactoryV1;
+    readonly gateway: ToolGateway;
+    /** Load system and prior history. The current user input is appended by AgentLoop. */
+    readonly loadBaseMessages: (context: ThreadTurnExecutionContextV1) => readonly Message[] | Promise<readonly Message[]>;
+    readonly toolContext?: (context: ThreadTurnExecutionContextV1, snapshot: StepSnapshotV1) => ToolContext;
+    readonly streamCallbacks?: StreamCallbacks;
+    readonly loopBudget?: Partial<LoopBudget>;
+    readonly onStepCaptured?: (snapshot: StepSnapshotV1) => void | Promise<void>;
+    readonly commitTurn?: (commit: AgentLoopTurnCommitV1) => void | Promise<void>;
+    readonly compactCoordinator?: QueryParams['compactCoordinator'];
+}
+/**
+ * The single production model -> tool recursion adapter.
+ *
+ * It deliberately reuses query()'s mature budget/provider/compact logic while
+ * replacing its turn-scoped registry with a frozen StepSnapshot and ToolGateway
+ * binding at every provider request.
+ */
+export declare class AgentLoopV1 implements ThreadTurnRunnerV1 {
+    private readonly options;
+    readonly serviceId: "agent-loop";
+    constructor(options: AgentLoopOptionsV1);
+    run(context: ThreadTurnExecutionContextV1): Promise<ThreadTurnOutcomeV1>;
+    private bindStep;
+    private invokeTool;
+}
+/** Persist the frozen step before its provider request is allowed to start. */
+export declare class ThreadStepSnapshotJournalV1 {
+    private readonly store;
+    constructor(store: ThreadEventStore);
+    commit(snapshot: StepSnapshotV1): void;
+}
+export declare function deterministicRuntimeId(parts: readonly string[]): string;
+//# sourceMappingURL=agent-loop.d.ts.map

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

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

package/dist/runtime/agent-loop.js

@@ -0,0 +1,418 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ThreadStepSnapshotJournalV1 = exports.AgentLoopV1 = void 0;
+exports.deterministicRuntimeId = deterministicRuntimeId;
+const crypto_1 = require("crypto");
+const query_1 = require("../framework/query");
+const tool_serializer_1 = require("../framework/tool-serializer");
+const canonical_1 = require("./protocol/canonical");
+const thread_compact_persistence_1 = require("./thread-compact-persistence");
+const step_snapshot_1 = require("./step-snapshot");
+/**
+ * The single production model -> tool recursion adapter.
+ *
+ * It deliberately reuses query()'s mature budget/provider/compact logic while
+ * replacing its turn-scoped registry with a frozen StepSnapshot and ToolGateway
+ * binding at every provider request.
+ */
+class AgentLoopV1 {
+    constructor(options) {
+        this.options = options;
+        this.serviceId = 'agent-loop';
+    }
+    async run(context) {
+        this.options.taskContext.observeUserInput(context.input);
+        const messages = (await this.options.loadBaseMessages(context)).map(message => ({
+            ...message,
+        }));
+        messages.push({ role: 'user', content: context.input });
+        let activeStep;
+        let assistantItem;
+        let assistantContent = '';
+        let reasoningItem;
+        let completeEvent;
+        let taskContextCompletion;
+        const finishReasoning = () => {
+            if (!reasoningItem)
+                return;
+            context.completeItem(reasoningItem, { summary: 'Model reasoning started' });
+            reasoningItem = undefined;
+        };
+        const ensureAssistantItem = () => {
+            if (assistantItem)
+                return assistantItem;
+            assistantItem = context.startItem({
+                kind: 'message',
+                role: 'assistant',
+                stepId: activeStep?.stepId,
+            });
+            return assistantItem;
+        };
+        const completeAssistant = (content) => {
+            if (!assistantItem && !content)
+                return;
+            const item = ensureAssistantItem();
+            context.completeItem(item, { content, summary: compactSummary(content) });
+            assistantItem = undefined;
+            assistantContent = '';
+        };
+        const streamCallbacks = {
+            onThinking: () => {
+                this.options.streamCallbacks?.onThinking?.();
+                if (!reasoningItem) {
+                    reasoningItem = context.startItem({ kind: 'reasoning', stepId: activeStep?.stepId });
+                }
+            },
+            onChunk: chunk => {
+                finishReasoning();
+                assistantContent += chunk;
+                context.emitDelta(ensureAssistantItem(), chunk, 'content');
+                this.options.streamCallbacks?.onChunk?.(chunk);
+            },
+        };
+        const harness = createQueryTaskContextAdapter(this.options.taskContext, decision => {
+            taskContextCompletion = decision;
+        }, context.mode === 'plan');
+        try {
+            for await (const event of (0, query_1.query)({
+                messages,
+                tools: [],
+                toolExecutor: async () => {
+                    throw new Error('AgentLoop tool execution was requested before StepSnapshot binding');
+                },
+                resolveStep: async (stepInput) => {
+                    const prepared = await this.options.steps.prepare({
+                        threadId: context.threadId,
+                        turnId: context.turnId,
+                        requestIndex: stepInput.requestIndex,
+                        input: context.input,
+                        mode: context.mode,
+                        messages: stepInput.messages,
+                        taskContextRevision: this.options.taskContext.revision,
+                        abortSignal: context.abortSignal,
+                    });
+                    const router = new step_snapshot_1.ToolRouterSnapshotV1(prepared.toolBindings);
+                    const tools = router.descriptors.map(createSnapshotToolFacade);
+                    return {
+                        tools,
+                        toolExecutor: async () => {
+                            throw new Error('AgentLoop tool execution was requested before model binding');
+                        },
+                        bindModelRequest: async (bindingInput) => {
+                            activeStep = await this.bindStep(context, prepared, router, bindingInput);
+                            return {
+                                receiptDigest: activeStep.digest,
+                                toolExecutor: (name, args, abortSignal, metadata) => this.invokeTool(context, activeStep, name, args, abortSignal, metadata),
+                            };
+                        },
+                    };
+                },
+                llm: this.options.llm,
+                abortSignal: context.abortSignal,
+                streamCallbacks,
+                harness,
+                input: context.input,
+                toolContext: {
+                    cwd: process.cwd(),
+                    config: { name: 'orion-code', mode: context.mode },
+                },
+                loopBudget: this.options.loopBudget,
+                compactCoordinator: this.options.compactCoordinator,
+            })) {
+                switch (event.type) {
+                    case 'request_start':
+                        finishReasoning();
+                        completeAssistant(assistantContent);
+                        activeStep = undefined;
+                        break;
+                    case 'assistant_tool_calls':
+                        finishReasoning();
+                        completeAssistant(assistantContent || event.content);
+                        break;
+                    case 'message':
+                        finishReasoning();
+                        completeAssistant(assistantContent || event.content);
+                        break;
+                    case 'warning':
+                    case 'strategy_exhausted': {
+                        const content = event.type === 'warning' ? event.message : event.suggestion;
+                        const item = context.startItem({ kind: 'reasoning', stepId: activeStep?.stepId });
+                        context.completeItem(item, { content, summary: compactSummary(content) });
+                        break;
+                    }
+                    case 'complete':
+                        completeEvent = event;
+                        break;
+                    case 'prompt_assembly':
+                    case 'tool_call':
+                    case 'permission_decision':
+                    case 'tool_result':
+                        break;
+                }
+            }
+        }
+        catch (error) {
+            finishReasoning();
+            if (assistantItem)
+                context.failItem(assistantItem, errorMessage(error));
+            return context.abortSignal.aborted
+                ? { status: 'interrupted', reason: abortReason(context.abortSignal) }
+                : { status: 'failed', error: errorMessage(error) };
+        }
+        finishReasoning();
+        completeAssistant(assistantContent);
+        if (!completeEvent) {
+            return context.abortSignal.aborted
+                ? { status: 'interrupted', reason: abortReason(context.abortSignal) }
+                : { status: 'failed', error: 'AgentLoop ended without a terminal Query event' };
+        }
+        const commitContent = {
+            threadId: context.threadId,
+            turnId: context.turnId,
+            queryComplete: completeEvent,
+            taskContextState: this.options.taskContext.exportState(),
+            taskContextRevision: this.options.taskContext.revision,
+            ...(taskContextCompletion ? { taskContextCompletion } : {}),
+            history: (completeEvent.compact?.uncompactedHistory ?? messages).map(message => ({
+                ...message,
+            })),
+        };
+        await this.options.commitTurn?.({
+            ...commitContent,
+            digest: (0, canonical_1.digestRuntimeValue)(commitContent),
+        });
+        if (context.abortSignal.aborted || completeEvent.stats?.finishReason === 'cancelled') {
+            return { status: 'interrupted', reason: abortReason(context.abortSignal) };
+        }
+        if (completeEvent.stats?.finishReason === 'failed') {
+            return { status: 'failed', error: completeEvent.content || 'AgentLoop failed' };
+        }
+        const maintenance = completeEvent.compact
+            ? createAutomaticCompactMaintenance(completeEvent.compact)
+            : undefined;
+        return {
+            status: 'completed',
+            outcome: (0, canonical_1.canonicalRuntimeJson)({
+                finishReason: completeEvent.stats?.finishReason ?? 'completed',
+                stopDecision: completeEvent.stats?.stopDecision,
+            }),
+            ...(maintenance ? { maintenance } : {}),
+        };
+    }
+    async bindStep(context, prepared, expectedRouter, bindingInput) {
+        const snapshot = await prepared.capture({
+            messages: bindingInput.messages,
+            taskContextRevision: this.options.taskContext.revision,
+        });
+        if (snapshot.threadId !== context.threadId ||
+            snapshot.turnId !== context.turnId ||
+            snapshot.stepId !== prepared.stepId) {
+            throw new Error('StepSnapshot identity does not match the active Thread/Turn/Step');
+        }
+        if (snapshot.toolRouter.digest !== expectedRouter.digest) {
+            throw new Error('StepSnapshot router differs from the model-visible tool set');
+        }
+        if (snapshot.taskContextRevision !== this.options.taskContext.revision) {
+            throw new Error('StepSnapshot TaskContext revision is stale at the model boundary');
+        }
+        snapshot.toolRouter.assertIntegrity();
+        await this.options.onStepCaptured?.(snapshot);
+        return snapshot;
+    }
+    async invokeTool(context, snapshot, name, args, abortSignal, metadata) {
+        if (!metadata)
+            throw new Error('ToolGateway execution requires provider call identity');
+        const invocationId = deterministicRuntimeId([
+            context.threadId,
+            context.turnId,
+            snapshot.stepId,
+            metadata.callId,
+            String(metadata.index),
+        ]);
+        const toolContext = this.options.toolContext?.(context, snapshot) ?? {
+            cwd: snapshot.environment.cwd,
+            config: { name: 'orion-code', mode: context.mode },
+        };
+        const invoked = await this.options.gateway.invoke({
+            invocationId,
+            snapshot,
+            toolName: name,
+            args,
+            context: toolContext,
+            abortSignal,
+        });
+        const permissionDecision = projectPermissionDecision(invoked.receipt);
+        return {
+            result: (0, tool_serializer_1.serializeToolResult)(invoked.result),
+            ...(permissionDecision ? { permissionDecision } : {}),
+        };
+    }
+}
+exports.AgentLoopV1 = AgentLoopV1;
+function projectPermissionDecision(receipt) {
+    const policy = receipt.policy;
+    if (!policy)
+        return undefined;
+    const approval = receipt.approval;
+    return {
+        behavior: policy.behavior,
+        approved: policy.behavior === 'allow' || (policy.behavior === 'ask' && approval?.approved === true),
+        source: normalizePermissionSource(policy.behavior, policy.source, approval?.source),
+        reason: approval?.reason ?? policy.reason,
+    };
+}
+function normalizePermissionSource(behavior, policySource, approvalSource) {
+    if (approvalSource === 'user')
+        return 'user';
+    if (approvalSource === 'authority')
+        return behavior === 'deny' ? 'config_deny' : 'config_allow';
+    if (approvalSource === 'unavailable')
+        return 'missing_confirmation';
+    if (policySource.startsWith('allowlist:')) {
+        return behavior === 'allow'
+            ? 'allowlist_allow'
+            : behavior === 'deny'
+                ? 'allowlist_deny'
+                : 'allowlist_ask';
+    }
+    return 'tool_policy';
+}
+function createAutomaticCompactMaintenance(compact) {
+    const uncompactedHistory = compact.uncompactedHistory.map(message => ({ ...message }));
+    const modelVisibleHistory = compact.modelHistory.map(message => ({ ...message }));
+    const sourceHistoryDigest = (0, canonical_1.digestRuntimeValue)(uncompactedHistory);
+    const payload = {
+        version: 1,
+        mode: compact.mode,
+        summary: structuredClone(compact.summary),
+        before: structuredClone(compact.before),
+        after: structuredClone(compact.after),
+        fingerprint: compact.fingerprint,
+        beforeTokens: compact.beforeTokens,
+        afterTokens: compact.afterTokens,
+        plan: structuredClone(compact.plan),
+        semanticSummary: structuredClone(compact.semanticSummary),
+        diagnostics: compact.diagnostics.map(diagnostic => ({ ...diagnostic })),
+    };
+    return Object.freeze({
+        type: 'compact',
+        source: 'automatic',
+        prepare: ({ source }) => {
+            if (source.historyDigest !== sourceHistoryDigest) {
+                throw new Error('Automatic compact source changed before its maintenance turn');
+            }
+            return (0, thread_compact_persistence_1.createThreadCompactCandidateDraftV1)({
+                source: 'automatic',
+                sourceHistoryDigest,
+                modelVisibleHistory,
+                payload,
+            });
+        },
+    });
+}
+/** Persist the frozen step before its provider request is allowed to start. */
+class ThreadStepSnapshotJournalV1 {
+    constructor(store) {
+        this.store = store;
+    }
+    commit(snapshot) {
+        if (snapshot.threadId !== this.store.threadId) {
+            throw new Error('StepSnapshot thread does not match ThreadEventStore');
+        }
+        const receiptContent = {
+            version: 1,
+            snapshotId: snapshot.stepId,
+            threadId: snapshot.threadId,
+            turnId: snapshot.turnId,
+            stepId: snapshot.stepId,
+            snapshotDigest: snapshot.digest,
+            toolRouter: snapshot.toolRouter.toReceipt(),
+            promptDigest: snapshot.prompt.digest,
+            taskContextRevision: snapshot.taskContextRevision,
+        };
+        const receipt = {
+            ...receiptContent,
+            digest: (0, canonical_1.digestRuntimeValue)(receiptContent),
+        };
+        this.store.appendDurable({
+            turnId: snapshot.turnId,
+            stepId: snapshot.stepId,
+            payload: {
+                type: 'step.snapshot',
+                data: {
+                    snapshotId: snapshot.stepId,
+                    digest: snapshot.digest,
+                    receipt: (0, canonical_1.canonicalRuntimeJson)(receipt),
+                },
+            },
+        });
+    }
+}
+exports.ThreadStepSnapshotJournalV1 = ThreadStepSnapshotJournalV1;
+function deterministicRuntimeId(parts) {
+    const hex = (0, crypto_1.createHash)('sha256')
+        .update(parts.join('\u0000'))
+        .digest('hex')
+        .slice(0, 32)
+        .split('');
+    hex[12] = '5';
+    hex[16] = ((Number.parseInt(hex[16], 16) & 0x3) | 0x8).toString(16);
+    const value = hex.join('');
+    return `${value.slice(0, 8)}-${value.slice(8, 12)}-${value.slice(12, 16)}-${value.slice(16, 20)}-${value.slice(20)}`;
+}
+function createSnapshotToolFacade(descriptor) {
+    return {
+        name: descriptor.name,
+        aliases: [...descriptor.aliases],
+        description: descriptor.description,
+        parameters: structuredClone(descriptor.inputSchema),
+        execute: async () => {
+            throw new Error(`Tool ${descriptor.name} can only execute through ToolGateway`);
+        },
+        checkPermissions: () => ({ behavior: 'allow' }),
+        isConcurrencySafe: () => descriptor.risk.readOnly &&
+            descriptor.risk.effect !== 'external_write' &&
+            descriptor.risk.network === 'none',
+        isReadOnly: () => descriptor.risk.readOnly,
+        isDestructive: () => descriptor.risk.destructive,
+        isFileEdit: () => descriptor.risk.fileEdit,
+    };
+}
+function createQueryTaskContextAdapter(taskContext, onCompletion, planningPhase = false) {
+    return {
+        updateCapabilityProfile: input => structuredClone(taskContext.observeCapability(input)),
+        assembleMessages: (messages, options) => taskContext.assembleMessages(messages, options),
+        getCapsule: () => {
+            const capsule = taskContext.getCapsule();
+            return capsule
+                ? structuredClone(capsule)
+                : undefined;
+        },
+        toJSON: () => taskContext.exportState(),
+        recordAssistantResponse: response => taskContext.observeAssistantResponse(response),
+        beforeToolUse: input => structuredClone(taskContext.checkToolUse(input)),
+        asToolBlockedResult: result => taskContext.toolBlockedResult(result),
+        recordToolResult: input => taskContext.observeToolResult(input),
+        beforeComplete: () => {
+            const decision = taskContext.auditCompletion();
+            onCompletion(decision);
+            // PLAN completes a planning phase, not the parent implementation task.
+            // Persist the unmodified audit for the PlanReceipt, while allowing the
+            // query to stop after its decision-complete plan. BUILD/AUTO will enforce
+            // the same TaskContext criteria in the following logical turn.
+            const queryDecision = planningPhase ? { ...decision, canComplete: true } : decision;
+            return structuredClone(queryDecision);
+        },
+        asCompletionBlockedMessage: result => taskContext.completionBlockedMessage(result),
+    };
+}
+function compactSummary(content) {
+    return content.replace(/\s+/gu, ' ').trim().slice(0, 240);
+}
+function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+function abortReason(signal) {
+    return typeof signal.reason === 'string' ? signal.reason : 'AgentLoop interrupted';
+}
+//# sourceMappingURL=agent-loop.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent-loop.js","sourceRoot":"","sources":["../../src/runtime/agent-loop.ts"],"names":[],"mappings":";;;AAwcA,wDAUC;AAldD,mCAAoC;AAEpC,8CAM4B;AAE5B,kEAAmE;AAGnE,oDAAgF;AAChF,6EAAmF;AAGnF,mDAAuD;AAsEvD;;;;;;GAMG;AACH,MAAa,WAAW;IAGtB,YAA6B,OAA2B;QAA3B,YAAO,GAAP,OAAO,CAAoB;QAF/C,cAAS,GAAG,YAAqB,CAAC;IAEgB,CAAC;IAE5D,KAAK,CAAC,GAAG,CAAC,OAAqC;QAC7C,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,gBAAgB,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACzD,MAAM,QAAQ,GAAG,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;YAC9E,GAAG,OAAO;SACX,CAAC,CAAC,CAAC;QACJ,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;QAExD,IAAI,UAAsC,CAAC;QAC3C,IAAI,aAA6C,CAAC;QAClD,IAAI,gBAAgB,GAAG,EAAE,CAAC;QAC1B,IAAI,aAA6C,CAAC;QAClD,IAAI,aAAoE,CAAC;QACzE,IAAI,qBAAkE,CAAC;QAEvE,MAAM,eAAe,GAAG,GAAS,EAAE;YACjC,IAAI,CAAC,aAAa;gBAAE,OAAO;YAC3B,OAAO,CAAC,YAAY,CAAC,aAAa,EAAE,EAAE,OAAO,EAAE,yBAAyB,EAAE,CAAC,CAAC;YAC5E,aAAa,GAAG,SAAS,CAAC;QAC5B,CAAC,CAAC;QACF,MAAM,mBAAmB,GAAG,GAAuB,EAAE;YACnD,IAAI,aAAa;gBAAE,OAAO,aAAa,CAAC;YACxC,aAAa,GAAG,OAAO,CAAC,SAAS,CAAC;gBAChC,IAAI,EAAE,SAAS;gBACf,IAAI,EAAE,WAAW;gBACjB,MAAM,EAAE,UAAU,EAAE,MAAM;aAC3B,CAAC,CAAC;YACH,OAAO,aAAa,CAAC;QACvB,CAAC,CAAC;QACF,MAAM,iBAAiB,GAAG,CAAC,OAAe,EAAQ,EAAE;YAClD,IAAI,CAAC,aAAa,IAAI,CAAC,OAAO;gBAAE,OAAO;YACvC,MAAM,IAAI,GAAG,mBAAmB,EAAE,CAAC;YACnC,OAAO,CAAC,YAAY,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,cAAc,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;YAC1E,aAAa,GAAG,SAAS,CAAC;YAC1B,gBAAgB,GAAG,EAAE,CAAC;QACxB,CAAC,CAAC;QACF,MAAM,eAAe,GAAoB;YACvC,UAAU,EAAE,GAAG,EAAE;gBACf,IAAI,CAAC,OAAO,CAAC,eAAe,EAAE,UAAU,EAAE,EAAE,CAAC;gBAC7C,IAAI,CAAC,aAAa,EAAE,CAAC;oBACnB,aAAa,GAAG,OAAO,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC,CAAC;gBACvF,CAAC;YACH,CAAC;YACD,OAAO,EAAE,KAAK,CAAC,EAAE;gBACf,eAAe,EAAE,CAAC;gBAClB,gBAAgB,IAAI,KAAK,CAAC;gBAC1B,OAAO,CAAC,SAAS,CAAC,mBAAmB,EAAE,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;gBAC3D,IAAI,CAAC,OAAO,CAAC,eAAe,EAAE,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC;YACjD,CAAC;SACF,CAAC;QAEF,MAAM,OAAO,GAAG,6BAA6B,CAC3C,IAAI,CAAC,OAAO,CAAC,WAAW,EACxB,QAAQ,CAAC,EAAE;YACT,qBAAqB,GAAG,QAAQ,CAAC;QACnC,CAAC,EACD,OAAO,CAAC,IAAI,KAAK,MAAM,CACxB,CAAC;QACF,IAAI,CAAC;YACH,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,IAAA,aAAK,EAAC;gBAC9B,QAAQ;gBACR,KAAK,EAAE,EAAE;gBACT,YAAY,EAAE,KAAK,IAAI,EAAE;oBACvB,MAAM,IAAI,KAAK,CAAC,oEAAoE,CAAC,CAAC;gBACxF,CAAC;gBACD,WAAW,EAAE,KAAK,EAAC,SAAS,EAAC,EAAE;oBAC7B,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC;wBAChD,QAAQ,EAAE,OAAO,CAAC,QAAQ;wBAC1B,MAAM,EAAE,OAAO,CAAC,MAAM;wBACtB,YAAY,EAAE,SAAS,CAAC,YAAY;wBACpC,KAAK,EAAE,OAAO,CAAC,KAAK;wBACpB,IAAI,EAAE,OAAO,CAAC,IAAI;wBAClB,QAAQ,EAAE,SAAS,CAAC,QAAQ;wBAC5B,mBAAmB,EAAE,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,QAAQ;wBACtD,WAAW,EAAE,OAAO,CAAC,WAAW;qBACjC,CAAC,CAAC;oBACH,MAAM,MAAM,GAAG,IAAI,oCAAoB,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;oBAC/D,MAAM,KAAK,GAAG,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;oBAC/D,OAAO;wBACL,KAAK;wBACL,YAAY,EAAE,KAAK,IAAI,EAAE;4BACvB,MAAM,IAAI,KAAK,CAAC,6DAA6D,CAAC,CAAC;wBACjF,CAAC;wBACD,gBAAgB,EAAE,KAAK,EAAC,YAAY,EAAC,EAAE;4BACrC,UAAU,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC;4BAC1E,OAAO;gCACL,aAAa,EAAE,UAAU,CAAC,MAAM;gCAChC,YAAY,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,EAAE,CAClD,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,UAAW,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,CAAC;6BAC3E,CAAC;wBACJ,CAAC;qBACF,CAAC;gBACJ,CAAC;gBACD,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG;gBACrB,WAAW,EAAE,OAAO,CAAC,WAAW;gBAChC,eAAe;gBACf,OAAO;gBACP,KAAK,EAAE,OAAO,CAAC,KAAK;gBACpB,WAAW,EAAE;oBACX,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE;oBAClB,MAAM,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE;iBACnD;gBACD,UAAU,EAAE,IAAI,CAAC,OAAO,CAAC,UAAU;gBACnC,kBAAkB,EAAE,IAAI,CAAC,OAAO,CAAC,kBAAkB;aACpD,CAAC,EAAE,CAAC;gBACH,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;oBACnB,KAAK,eAAe;wBAClB,eAAe,EAAE,CAAC;wBAClB,iBAAiB,CAAC,gBAAgB,CAAC,CAAC;wBACpC,UAAU,GAAG,SAAS,CAAC;wBACvB,MAAM;oBACR,KAAK,sBAAsB;wBACzB,eAAe,EAAE,CAAC;wBAClB,iBAAiB,CAAC,gBAAgB,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC;wBACrD,MAAM;oBACR,KAAK,SAAS;wBACZ,eAAe,EAAE,CAAC;wBAClB,iBAAiB,CAAC,gBAAgB,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC;wBACrD,MAAM;oBACR,KAAK,SAAS,CAAC;oBACf,KAAK,oBAAoB,CAAC,CAAC,CAAC;wBAC1B,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC;wBAC5E,MAAM,IAAI,GAAG,OAAO,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC,CAAC;wBAClF,OAAO,CAAC,YAAY,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,cAAc,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;wBAC1E,MAAM;oBACR,CAAC;oBACD,KAAK,UAAU;wBACb,aAAa,GAAG,KAAK,CAAC;wBACtB,MAAM;oBACR,KAAK,iBAAiB,CAAC;oBACvB,KAAK,WAAW,CAAC;oBACjB,KAAK,qBAAqB,CAAC;oBAC3B,KAAK,aAAa;wBAChB,MAAM;gBACV,CAAC;YACH,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,eAAe,EAAE,CAAC;YAClB,IAAI,aAAa;gBAAE,OAAO,CAAC,QAAQ,CAAC,aAAa,EAAE,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC;YACxE,OAAO,OAAO,CAAC,WAAW,CAAC,OAAO;gBAChC,CAAC,CAAC,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE;gBACrE,CAAC,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;QACvD,CAAC;QAED,eAAe,EAAE,CAAC;QAClB,iBAAiB,CAAC,gBAAgB,CAAC,CAAC;QACpC,IAAI,CAAC,aAAa,EAAE,CAAC;YACnB,OAAO,OAAO,CAAC,WAAW,CAAC,OAAO;gBAChC,CAAC,CAAC,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE;gBACrE,CAAC,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,gDAAgD,EAAE,CAAC;QACpF,CAAC;QAED,MAAM,aAAa,GAAG;YACpB,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,aAAa,EAAE,aAAa;YAC5B,gBAAgB,EAAE,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,WAAW,EAAE;YACxD,mBAAmB,EAAE,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,QAAQ;YACtD,GAAG,CAAC,qBAAqB,CAAC,CAAC,CAAC,EAAE,qBAAqB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC3D,OAAO,EAAE,CAAC,aAAa,CAAC,OAAO,EAAE,kBAAkB,IAAI,QAAQ,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;gBAC/E,GAAG,OAAO;aACX,CAAC,CAAC;SACJ,CAAC;QACF,MAAM,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;YAC9B,GAAG,aAAa;YAChB,MAAM,EAAE,IAAA,8BAAkB,EAAC,aAAa,CAAC;SAC1C,CAAC,CAAC;QAEH,IAAI,OAAO,CAAC,WAAW,CAAC,OAAO,IAAI,aAAa,CAAC,KAAK,EAAE,YAAY,KAAK,WAAW,EAAE,CAAC;YACrF,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;QAC7E,CAAC;QACD,IAAI,aAAa,CAAC,KAAK,EAAE,YAAY,KAAK,QAAQ,EAAE,CAAC;YACnD,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,aAAa,CAAC,OAAO,IAAI,kBAAkB,EAAE,CAAC;QAClF,CAAC;QACD,MAAM,WAAW,GAAG,aAAa,CAAC,OAAO;YACvC,CAAC,CAAC,iCAAiC,CAAC,aAAa,CAAC,OAAO,CAAC;YAC1D,CAAC,CAAC,SAAS,CAAC;QACd,OAAO;YACL,MAAM,EAAE,WAAW;YACnB,OAAO,EAAE,IAAA,gCAAoB,EAAC;gBAC5B,YAAY,EAAE,aAAa,CAAC,KAAK,EAAE,YAAY,IAAI,WAAW;gBAC9D,YAAY,EAAE,aAAa,CAAC,KAAK,EAAE,YAAY;aAChD,CAAC;YACF,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACxC,CAAC;IACJ,CAAC;IAEO,KAAK,CAAC,QAAQ,CACpB,OAAqC,EACrC,QAAiC,EACjC,cAAoC,EACpC,YAA2C;QAE3C,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC;YACtC,QAAQ,EAAE,YAAY,CAAC,QAAQ;YAC/B,mBAAmB,EAAE,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,QAAQ;SACvD,CAAC,CAAC;QACH,IACE,QAAQ,CAAC,QAAQ,KAAK,OAAO,CAAC,QAAQ;YACtC,QAAQ,CAAC,MAAM,KAAK,OAAO,CAAC,MAAM;YAClC,QAAQ,CAAC,MAAM,KAAK,QAAQ,CAAC,MAAM,EACnC,CAAC;YACD,MAAM,IAAI,KAAK,CAAC,kEAAkE,CAAC,CAAC;QACtF,CAAC;QACD,IAAI,QAAQ,CAAC,UAAU,CAAC,MAAM,KAAK,cAAc,CAAC,MAAM,EAAE,CAAC;YACzD,MAAM,IAAI,KAAK,CAAC,6DAA6D,CAAC,CAAC;QACjF,CAAC;QACD,IAAI,QAAQ,CAAC,mBAAmB,KAAK,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,QAAQ,EAAE,CAAC;YACvE,MAAM,IAAI,KAAK,CAAC,kEAAkE,CAAC,CAAC;QACtF,CAAC;QACD,QAAQ,CAAC,UAAU,CAAC,eAAe,EAAE,CAAC;QACtC,MAAM,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC,QAAQ,CAAC,CAAC;QAC9C,OAAO,QAAQ,CAAC;IAClB,CAAC;IAEO,KAAK,CAAC,UAAU,CACtB,OAAqC,EACrC,QAAwB,EACxB,IAAY,EACZ,IAA6B,EAC7B,WAAyB,EACzB,QAAgC;QAEhC,IAAI,CAAC,QAAQ;YAAE,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;QACxF,MAAM,YAAY,GAAG,sBAAsB,CAAC;YAC1C,OAAO,CAAC,QAAQ;YAChB,OAAO,CAAC,MAAM;YACd,QAAQ,CAAC,MAAM;YACf,QAAQ,CAAC,MAAM;YACf,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;SACvB,CAAC,CAAC;QACH,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,OAAO,EAAE,QAAQ,CAAC,IAAI;YACnE,GAAG,EAAE,QAAQ,CAAC,WAAW,CAAC,GAAG;YAC7B,MAAM,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE;SACnD,CAAC;QACF,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC;YAChD,YAAY;YACZ,QAAQ;YACR,QAAQ,EAAE,IAAI;YACd,IAAI;YACJ,OAAO,EAAE,WAAW;YACpB,WAAW;SACZ,CAAC,CAAC;QACH,MAAM,kBAAkB,GAAG,yBAAyB,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACtE,OAAO;YACL,MAAM,EAAE,IAAA,qCAAmB,EAAC,OAAO,CAAC,MAAM,CAAC;YAC3C,GAAG,CAAC,kBAAkB,CAAC,CAAC,CAAC,EAAE,kBAAkB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACtD,CAAC;IACJ,CAAC;CACF;AA7PD,kCA6PC;AAED,SAAS,yBAAyB,CAChC,OAA8D;IAE9D,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAC9B,IAAI,CAAC,MAAM;QAAE,OAAO,SAAS,CAAC;IAC9B,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;IAClC,OAAO;QACL,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,QAAQ,EACN,MAAM,CAAC,QAAQ,KAAK,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,KAAK,KAAK,IAAI,QAAQ,EAAE,QAAQ,KAAK,IAAI,CAAC;QAC3F,MAAM,EAAE,yBAAyB,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC;QACnF,MAAM,EAAE,QAAQ,EAAE,MAAM,IAAI,MAAM,CAAC,MAAM;KAC1C,CAAC;AACJ,CAAC;AAED,SAAS,yBAAyB,CAChC,QAAyD,EACzD,YAAoB,EACpB,cAAuB;IAEvB,IAAI,cAAc,KAAK,MAAM;QAAE,OAAO,MAAM,CAAC;IAC7C,IAAI,cAAc,KAAK,WAAW;QAAE,OAAO,QAAQ,KAAK,MAAM,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,cAAc,CAAC;IAChG,IAAI,cAAc,KAAK,aAAa;QAAE,OAAO,sBAAsB,CAAC;IACpE,IAAI,YAAY,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QAC1C,OAAO,QAAQ,KAAK,OAAO;YACzB,CAAC,CAAC,iBAAiB;YACnB,CAAC,CAAC,QAAQ,KAAK,MAAM;gBACnB,CAAC,CAAC,gBAAgB;gBAClB,CAAC,CAAC,eAAe,CAAC;IACxB,CAAC;IACD,OAAO,aAAa,CAAC;AACvB,CAAC;AAED,SAAS,iCAAiC,CACxC,OAA0E;IAE1E,MAAM,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC,CAAC;IACvF,MAAM,mBAAmB,GAAG,OAAO,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC,CAAC;IAClF,MAAM,mBAAmB,GAAG,IAAA,8BAAkB,EAAC,kBAAkB,CAAC,CAAC;IACnE,MAAM,OAAO,GAAG;QACd,OAAO,EAAE,CAAU;QACnB,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,OAAO,EAAE,eAAe,CAAC,OAAO,CAAC,OAAO,CAAC;QACzC,MAAM,EAAE,eAAe,CAAC,OAAO,CAAC,MAAM,CAAC;QACvC,KAAK,EAAE,eAAe,CAAC,OAAO,CAAC,KAAK,CAAC;QACrC,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,YAAY,EAAE,OAAO,CAAC,YAAY;QAClC,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,IAAI,EAAE,eAAe,CAAC,OAAO,CAAC,IAAI,CAAC;QACnC,eAAe,EAAE,eAAe,CAAC,OAAO,CAAC,eAAe,CAAC;QACzD,WAAW,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,UAAU,EAAE,CAAC,CAAC;KACxE,CAAC;IACF,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,IAAI,EAAE,SAAkB;QACxB,MAAM,EAAE,WAAoB;QAC5B,OAAO,EAAE,CAAC,EAAE,MAAM,EAAsD,EAAE,EAAE;YAC1E,IAAI,MAAM,CAAC,aAAa,KAAK,mBAAmB,EAAE,CAAC;gBACjD,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAC;YAClF,CAAC;YACD,OAAO,IAAA,gEAAmC,EAAC;gBACzC,MAAM,EAAE,WAAW;gBACnB,mBAAmB;gBACnB,mBAAmB;gBACnB,OAAO;aACR,CAAC,CAAC;QACL,CAAC;KACF,CAAC,CAAC;AACL,CAAC;AAED,+EAA+E;AAC/E,MAAa,2BAA2B;IACtC,YAA6B,KAAuB;QAAvB,UAAK,GAAL,KAAK,CAAkB;IAAG,CAAC;IAExD,MAAM,CAAC,QAAwB;QAC7B,IAAI,QAAQ,CAAC,QAAQ,KAAK,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;YAC9C,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;QACzE,CAAC;QACD,MAAM,cAAc,GAAG;YACrB,OAAO,EAAE,CAAU;YACnB,UAAU,EAAE,QAAQ,CAAC,MAAM;YAC3B,QAAQ,EAAE,QAAQ,CAAC,QAAQ;YAC3B,MAAM,EAAE,QAAQ,CAAC,MAAM;YACvB,MAAM,EAAE,QAAQ,CAAC,MAAM;YACvB,cAAc,EAAE,QAAQ,CAAC,MAAM;YAC/B,UAAU,EAAE,QAAQ,CAAC,UAAU,CAAC,SAAS,EAAE;YAC3C,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM;YACpC,mBAAmB,EAAE,QAAQ,CAAC,mBAAmB;SAClD,CAAC;QACF,MAAM,OAAO,GAAG;YACd,GAAG,cAAc;YACjB,MAAM,EAAE,IAAA,8BAAkB,EAAC,cAAc,CAAC;SAC3C,CAAC;QACF,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC;YACvB,MAAM,EAAE,QAAQ,CAAC,MAAM;YACvB,MAAM,EAAE,QAAQ,CAAC,MAAM;YACvB,OAAO,EAAE;gBACP,IAAI,EAAE,eAAe;gBACrB,IAAI,EAAE;oBACJ,UAAU,EAAE,QAAQ,CAAC,MAAM;oBAC3B,MAAM,EAAE,QAAQ,CAAC,MAAM;oBACvB,OAAO,EAAE,IAAA,gCAAoB,EAAC,OAAO,CAAC;iBACvC;aACF;SACF,CAAC,CAAC;IACL,CAAC;CACF;AAnCD,kEAmCC;AAED,SAAgB,sBAAsB,CAAC,KAAwB;IAC7D,MAAM,GAAG,GAAG,IAAA,mBAAU,EAAC,QAAQ,CAAC;SAC7B,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;SAC5B,MAAM,CAAC,KAAK,CAAC;SACb,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;SACZ,KAAK,CAAC,EAAE,CAAC,CAAC;IACb,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC;IACd,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IACpE,MAAM,KAAK,GAAG,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC3B,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;AACvH,CAAC;AAED,SAAS,wBAAwB,CAAC,UAAmC;IACnE,OAAO;QACL,IAAI,EAAE,UAAU,CAAC,IAAI;QACrB,OAAO,EAAE,CAAC,GAAG,UAAU,CAAC,OAAO,CAAC;QAChC,WAAW,EAAE,UAAU,CAAC,WAAW;QACnC,UAAU,EAAE,eAAe,CAAC,UAAU,CAAC,WAAW,CAAC;QACnD,OAAO,EAAE,KAAK,IAAI,EAAE;YAClB,MAAM,IAAI,KAAK,CAAC,QAAQ,UAAU,CAAC,IAAI,uCAAuC,CAAC,CAAC;QAClF,CAAC;QACD,gBAAgB,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;QAC/C,iBAAiB,EAAE,GAAG,EAAE,CACtB,UAAU,CAAC,IAAI,CAAC,QAAQ;YACxB,UAAU,CAAC,IAAI,CAAC,MAAM,KAAK,gBAAgB;YAC3C,UAAU,CAAC,IAAI,CAAC,OAAO,KAAK,MAAM;QACpC,UAAU,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ;QAC1C,aAAa,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,WAAW;QAChD,UAAU,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ;KAC3C,CAAC;AACJ,CAAC;AAED,SAAS,6BAA6B,CACpC,WAA+B,EAC/B,YAAiE,EACjE,aAAa,GAAG,KAAK;IAErB,OAAO;QACL,uBAAuB,EAAE,KAAK,CAAC,EAAE,CAC/B,eAAe,CAAC,WAAW,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAEnD;QACH,gBAAgB,EAAE,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,CAAC,WAAW,CAAC,gBAAgB,CAAC,QAAQ,EAAE,OAAO,CAAC;QACxF,UAAU,EAAE,GAAG,EAAE;YACf,MAAM,OAAO,GAAG,WAAW,CAAC,UAAU,EAAE,CAAC;YACzC,OAAO,OAAO;gBACZ,CAAC,CAAE,eAAe,CAAC,OAAO,CAA2D;gBACrF,CAAC,CAAC,SAAS,CAAC;QAChB,CAAC;QACD,MAAM,EAAE,GAAG,EAAE,CAAC,WAAW,CAAC,WAAW,EAAE;QACvC,uBAAuB,EAAE,QAAQ,CAAC,EAAE,CAAC,WAAW,CAAC,wBAAwB,CAAC,QAAQ,CAAC;QACnF,aAAa,EAAE,KAAK,CAAC,EAAE,CAAC,eAAe,CAAC,WAAW,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;QACxE,mBAAmB,EAAE,MAAM,CAAC,EAAE,CAAC,WAAW,CAAC,iBAAiB,CAAC,MAAM,CAAC;QACpE,gBAAgB,EAAE,KAAK,CAAC,EAAE,CAAC,WAAW,CAAC,iBAAiB,CAAC,KAAK,CAAC;QAC/D,cAAc,EAAE,GAAG,EAAE;YACnB,MAAM,QAAQ,GAAG,WAAW,CAAC,eAAe,EAAE,CAAC;YAC/C,YAAY,CAAC,QAAQ,CAAC,CAAC;YACvB,uEAAuE;YACvE,uEAAuE;YACvE,0EAA0E;YAC1E,+DAA+D;YAC/D,MAAM,aAAa,GAAG,aAAa,CAAC,CAAC,CAAC,EAAE,GAAG,QAAQ,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC;YACpF,OAAO,eAAe,CAAC,aAAa,CAEnC,CAAC;QACJ,CAAC;QACD,0BAA0B,EAAE,MAAM,CAAC,EAAE,CAAC,WAAW,CAAC,wBAAwB,CAAC,MAAM,CAAC;KACnF,CAAC;AACJ,CAAC;AAED,SAAS,cAAc,CAAC,OAAe;IACrC,OAAO,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AAC5D,CAAC;AAED,SAAS,YAAY,CAAC,KAAc;IAClC,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAChE,CAAC;AAED,SAAS,WAAW,CAAC,MAAmB;IACtC,OAAO,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,uBAAuB,CAAC;AACrF,CAAC"}

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

@@ -1,16 +1,12 @@
 import type { AgentRuntimeEventSink, AgentRuntimeInput, AgentRuntimeInputResult, AgentRuntimeInterruptResult, AgentRuntimeSubmitResult } from './agent-runtime-protocol';
-import { type AgentChatControllerOptions, type RunInputOptions } from './chat-controller';
+import type { AgentRuntimeRunnerV1, AgentRuntimeRunInputOptionsV1 } from './agent-runtime-runner';
 import type { OrionCodeUiRuntime, FollowupQueueItem, UiEventSink, UiRendererCapabilities } from './ui-events';
 import type { CommandUiRenderer } from '../commands/types';
 import { type TurnControllerOptions } from './turn-controller';
-import type { AgentTurnRequest, GoalEvidenceRecord } from './goals/types';
-import { type GoalToolExecutionContext } from './goals/tools';
 import { AgentModeLifecycleController } from '../framework/agent-mode';
 export type { AgentRuntimeInput, AgentRuntimeInputResult, AgentRuntimeInterruptResult, AgentRuntimeSubmitResult, } from './agent-runtime-protocol';
-export interface AgentRuntimeRunner {
-    runInput(input: string, options?: RunInputOptions): Promise<void>;
-    runRequest?(request: AgentTurnRequest, options?: RunInputOptions): Promise<void>;
-}
+export type AgentRuntimeRunner = AgentRuntimeRunnerV1;
+export type RunInputOptions = AgentRuntimeRunInputOptionsV1;
 export interface AgentRuntimeToolPermissionRequest {
     name: string;
     args: Record<string, unknown>;
@@ -26,7 +22,6 @@ export interface AgentRuntimeControllerOptions extends TurnControllerOptions {
     uiCapabilities?: UiRendererCapabilities;
     /** Active renderer adapter identity for renderer-layer diagnostics. */
     uiRenderer?: CommandUiRenderer;
-    chatOptions?: AgentChatControllerOptions;
     echoSubmittedInput?: boolean;
     runningStatus?: string | ((input: string) => string);
     readyStatus?: string | (() => string);
@@ -42,13 +37,6 @@ export interface AgentRuntimeControllerOptions extends TurnControllerOptions {
     /** Optional lifecycle injection for deterministic runtime tests and embedders. */
     agentModeLifecycle?: AgentModeLifecycleController;
 }
-export declare function goalProviderError(finishReason: string | undefined, errorType: string | undefined): import('./goals/types').AgentTurnOutcome['providerError'];
-export declare function goalTurnMadeProgress(input: {
-    evidenceRecords?: GoalEvidenceRecord[];
-    pendingPlanUpdate?: GoalToolExecutionContext['pendingPlanUpdate'];
-    workspaceFingerprintBefore?: string;
-    workspaceFingerprintAfter?: string;
-}): boolean;
 /**
  * UI-independent turn runner for interactive Orion Code surfaces.
  *
@@ -66,30 +54,23 @@ export declare class AgentRuntimeController {
     private readonly agentModeLifecycle;
     private readonly pendingPermissions;
     private activeRun;
+    private readonly goalControlRuns;
     private stopping;
-    private continuationScheduleEpoch;
-    /** Conservative reservations for every provider attempt in the current root turn. */
-    private goalProviderReservedTokens;
     private nextPermissionRequestId;
     private readonly queuedCommands;
     private readonly followupQueue;
     private readonly followupQueueLimit;
     private nextFollowupId;
-    /** v0.2.24: optional goal coordinator for /target mode. */
-    private goalCoordinator;
-    private goalCoordinatorSessionId;
-    /** v0.2.24: set the goal coordinator for /target mode. */
-    setGoalCoordinator(coord: import('./goals/coordinator').GoalCoordinator): void;
     constructor(options: AgentRuntimeControllerOptions);
     hasActiveTurn(): boolean;
     getFollowupQueue(): readonly FollowupQueueItem[];
-    /** v0.1.1: shared /target command handling for all renderers. */
+    /** Thin /goal control surface; GoalRuntimeCoordinatorV2 owns every mutation. */
     handleTargetInput(rawInput: string): {
         handled: boolean;
         statusText?: string;
         runtimeResult: AgentRuntimeSubmitResult;
     };
-    /** v0.1.1: shared /target intercept check for all renderers. */
+    /** Goal controls remain available while a turn is active only when they can stop or inspect it. */
     canInterceptTargetCommand(input: string, duringActiveTurn: boolean): boolean;
     /** v0.1.1: emit clear_view event through the renderer protocol. */
     emitClearView(): void;
@@ -103,30 +84,11 @@ export declare class AgentRuntimeController {
     private manageFollowupQueue;
     submit(input: string): AgentRuntimeSubmitResult;
     private emitImmediateCommandSnapshot;
+    private runCommand;
+    private createCommandContext;
     private submitTurnRequest;
-    private submitGoalContinuation;
-    private scheduleGoalContinuation;
-    /** v0.2.26: finalize goal turn with usage data from the last loop. */
-    private finalizeGoalTurn;
-    /**
-     * Leave Goal mode after a passed completion audit while retaining the
-     * terminal sidecar as the durable completion receipt. The conditional
-     * session mutation prevents a stale completion from clearing a newer Goal.
-     */
-    private autoExitCompletedGoal;
-    private failClosedGoalPersistence;
-    private recordGoalTraceState;
     interrupt(): AgentRuntimeInterruptResult;
     stopActiveTurn(): Promise<void>;
-    private deferGoalContinuation;
-    /** Revoke all Goal-owned execution before mutating a lifecycle boundary. */
-    private abortGoalOwnedExecution;
-    /**
-     * Contain a failed Goal mutation without writing the restored disk state back.
-     * The coordinator advances its generation so every in-flight request becomes
-     * stale, then preserves complete or deleted disk authority as-is.
-     */
-    private failClosedGoalMutation;
     waitForIdle(): Promise<void>;
     private runTurn;
     private handleRunLoopError;
@@ -136,21 +98,12 @@ export declare class AgentRuntimeController {
     private emitFollowupQueue;
     private emitAgentModeSnapshot;
     private cycleAgentMode;
-    private emitGoalEvent;
     private requestIsCurrent;
-    private verificationSummary;
-    private captureGoalEvidence;
-    private restoreGoalForSession;
     requestToolPermission(request: AgentRuntimeToolPermissionRequest): Promise<boolean>;
-    private handleGoalControl;
-    private emitGoalMutationError;
-    private ensureGoalCoordinator;
-    private bindGoalCoordinator;
-    private activeProjectPath;
-    private formatTargetStatus;
+    private startGoalControl;
+    private renderGoalControl;
     private recordPermissionDecision;
     private applyPermissionModeChange;
     private rejectPendingPermissions;
-    private createChatOptions;
 }
 //# sourceMappingURL=agent-runtime-controller.d.ts.map