@qduc/term2 0.11.1 → 0.12.0

package/dist/services/hooks/hook-editor-shim.js

@@ -0,0 +1,190 @@
+import { mkdir, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+export const HOOK_DECLARATION_SHIM_FILENAME = 'term2-hooks.d.ts';
+export const HOOK_TSCONFIG_FILENAME = 'tsconfig.json';
+export const HOOK_DECLARATION_SHIM_CONTENT = `/**
+ * Type declarations for Term2 hooks.
+ * Auto-generated by Term2 to support editor type resolution.
+ */
+
+declare module '@qduc/term2/hooks' {
+  export type Term2HookSchemaVersion = 1;
+  export type Term2SessionMode = 'interactive' | 'non-interactive';
+  export type Term2Status = 'idle' | 'working' | 'waiting_for_user' | 'waiting_for_approval';
+  export type Term2StatusChangeReason =
+    | 'startup'
+    | 'user_turn'
+    | 'queued_turn'
+    | 'approval_continuation'
+    | 'turn_started'
+    | 'turn_finished'
+    | 'turn_failed'
+    | 'tool_started'
+    | 'tool_finished'
+    | 'approval_requested'
+    | 'approval_resolved'
+    | 'ask_user'
+    | 'reset'
+    | 'undo'
+    | 'provider_changed'
+    | 'tool_retry'
+    | 'shutdown';
+  export type Term2TurnOrigin = 'user' | 'queued' | 'approval_continuation';
+  export type Term2TurnTerminalKind = 'response' | 'approval_required' | 'stale' | 'failed';
+  export type Term2ErrorCategory =
+    | 'aborted'
+    | 'approval_rejected'
+    | 'authentication'
+    | 'configuration'
+    | 'network'
+    | 'provider'
+    | 'rate_limited'
+    | 'tool'
+    | 'unknown';
+  export type Term2ApprovalKind = 'tool' | 'ask_user' | 'preflight' | 'other';
+  export type Term2ProposedDecision = 'approve' | 'reject' | 'abort' | 'auto_approve';
+  export type Term2ApprovalResolution = 'approved' | 'rejected' | 'aborted' | 'auto_approved';
+  export type Term2ApprovalResolutionSource = 'user' | 'policy' | 'system';
+
+  export type Term2SubagentScope = {
+    readonly agentId: string;
+    readonly role: string;
+  };
+
+  export type Term2HookScope = 'root' | { readonly subagent: Term2SubagentScope };
+  export type Term2ToolOwnership = Term2HookScope;
+
+  export interface HookEventBase<Name extends Term2HookEventName = Term2HookEventName> {
+    readonly type: Name;
+    readonly schemaVersion: Term2HookSchemaVersion;
+    readonly eventId: string;
+    readonly sessionId: string;
+    readonly timestamp: number;
+    readonly scope: Term2HookScope;
+    readonly turnId?: string;
+    readonly toolCallId?: string;
+  }
+
+  export interface SessionStartHookEvent extends HookEventBase<'session.start'> {
+    readonly cwd: string;
+    readonly mode: Term2SessionMode;
+    readonly providerName: string;
+    readonly modelName: string;
+  }
+
+  export interface SessionEndHookEvent extends HookEventBase<'session.end'> {
+    readonly reason: 'normal' | 'fatal_error';
+    readonly sessionDuration: number;
+  }
+
+  export interface StatusChangeHookEvent extends HookEventBase<'status.change'> {
+    readonly previous: Term2Status;
+    readonly current: Term2Status;
+    readonly reason: Term2StatusChangeReason;
+  }
+
+  export interface TurnStartHookEvent extends HookEventBase<'turn.start'> {
+    readonly origin: Term2TurnOrigin;
+    readonly userText?: string;
+  }
+
+  export interface TurnEndHookEvent extends HookEventBase<'turn.end'> {
+    readonly terminalKind: Term2TurnTerminalKind;
+    readonly duration: number;
+  }
+
+  export interface TurnErrorHookEvent extends HookEventBase<'turn.error'> {
+    readonly errorCategory: Term2ErrorCategory;
+    readonly safeMessage: string;
+    readonly recoverable: boolean;
+  }
+
+  export interface ToolBeforeHookEvent extends HookEventBase<'tool.before'> {
+    readonly toolName: string;
+    readonly normalizedArguments: unknown;
+    readonly attempt: number;
+    readonly ownership: Term2ToolOwnership;
+  }
+
+  export interface ToolAfterHookEvent extends HookEventBase<'tool.after'> {
+    readonly toolName: string;
+    readonly duration: number;
+    readonly normalizedResultSummary: unknown;
+  }
+
+  export interface ToolErrorHookEvent extends HookEventBase<'tool.error'> {
+    readonly toolName: string;
+    readonly duration: number;
+    readonly errorCategory: Term2ErrorCategory;
+    readonly safeMessage: string;
+    readonly convertedToModelResult: boolean;
+  }
+
+  export interface ApprovalRequestedHookEvent extends HookEventBase<'approval.requested'> {
+    readonly toolName: string;
+    readonly normalizedArguments: unknown;
+    readonly approvalKind: Term2ApprovalKind;
+    readonly proposedDecision: Term2ProposedDecision;
+  }
+
+  export interface ApprovalResolvedHookEvent extends HookEventBase<'approval.resolved'> {
+    readonly resolution: Term2ApprovalResolution;
+    readonly source: Term2ApprovalResolutionSource;
+    readonly executionFollowed: boolean;
+  }
+
+  export type Term2HookEventMap = {
+    readonly 'session.start': SessionStartHookEvent;
+    readonly 'session.end': SessionEndHookEvent;
+    readonly 'status.change': StatusChangeHookEvent;
+    readonly 'turn.start': TurnStartHookEvent;
+    readonly 'turn.end': TurnEndHookEvent;
+    readonly 'turn.error': TurnErrorHookEvent;
+    readonly 'tool.before': ToolBeforeHookEvent;
+    readonly 'tool.after': ToolAfterHookEvent;
+    readonly 'tool.error': ToolErrorHookEvent;
+    readonly 'approval.requested': ApprovalRequestedHookEvent;
+    readonly 'approval.resolved': ApprovalResolvedHookEvent;
+  };
+
+  export type Term2HookEventName = keyof Term2HookEventMap;
+
+  export type Term2HookEvent<Name extends Term2HookEventName = Term2HookEventName> = Term2HookEventMap[Name];
+
+  export type Term2HookCallback<Name extends Term2HookEventName> = (
+    event: Term2HookEventMap[Name],
+  ) => void | Promise<void>;
+
+  export interface Term2Hooks {
+    on<Name extends Term2HookEventName>(event: Name, callback: Term2HookCallback<Name>): () => void;
+  }
+
+  export type Term2HookRegistration = (hooks: Term2Hooks) => void | Promise<void>;
+}
+`;
+export const HOOK_TSCONFIG_CONTENT = JSON.stringify({
+    compilerOptions: {
+        target: 'ES2022',
+        module: 'NodeNext',
+        moduleResolution: 'NodeNext',
+        strict: true,
+        skipLibCheck: true,
+        baseUrl: '.',
+        paths: {
+            '@qduc/term2/hooks': ['./term2-hooks.d.ts'],
+        },
+    },
+    include: ['**/*'],
+}, null, 2);
+export async function ensureHookEditorShim(hookRoot) {
+    try {
+        await mkdir(hookRoot, { recursive: true });
+        await writeFile(join(hookRoot, HOOK_DECLARATION_SHIM_FILENAME), HOOK_DECLARATION_SHIM_CONTENT, 'utf8');
+        await writeFile(join(hookRoot, HOOK_TSCONFIG_FILENAME), HOOK_TSCONFIG_CONTENT, 'utf8');
+    }
+    catch (error) {
+        // Passive editor shim generation fails open if directory permissions restrict writing
+        void error;
+    }
+}
+//# sourceMappingURL=hook-editor-shim.js.map

package/dist/services/hooks/hook-editor-shim.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-editor-shim.js","sourceRoot":"","sources":["../../../source/services/hooks/hook-editor-shim.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,MAAM,CAAC,MAAM,8BAA8B,GAAG,kBAAkB,CAAC;AACjE,MAAM,CAAC,MAAM,sBAAsB,GAAG,eAAe,CAAC;AAEtD,MAAM,CAAC,MAAM,6BAA6B,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+J5C,CAAC;AAEF,MAAM,CAAC,MAAM,qBAAqB,GAAG,IAAI,CAAC,SAAS,CACjD;IACE,eAAe,EAAE;QACf,MAAM,EAAE,QAAQ;QAChB,MAAM,EAAE,UAAU;QAClB,gBAAgB,EAAE,UAAU;QAC5B,MAAM,EAAE,IAAI;QACZ,YAAY,EAAE,IAAI;QAClB,OAAO,EAAE,GAAG;QACZ,KAAK,EAAE;YACL,mBAAmB,EAAE,CAAC,oBAAoB,CAAC;SAC5C;KACF;IACD,OAAO,EAAE,CAAC,MAAM,CAAC;CAClB,EACD,IAAI,EACJ,CAAC,CACF,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,QAAgB;IACzD,IAAI,CAAC;QACH,MAAM,KAAK,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3C,MAAM,SAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,8BAA8B,CAAC,EAAE,6BAA6B,EAAE,MAAM,CAAC,CAAC;QACvG,MAAM,SAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,sBAAsB,CAAC,EAAE,qBAAqB,EAAE,MAAM,CAAC,CAAC;IACzF,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,sFAAsF;QACtF,KAAK,KAAK,CAAC;IACb,CAAC;AACH,CAAC"}

package/dist/services/hooks/hook-event-factory.d.ts

@@ -0,0 +1,19 @@
+import type { Term2HookEvent, Term2HookEventName, Term2HookEventMap, Term2HookScope } from './hook-contracts.js';
+export type HookEventFactoryOptions = {
+    readonly sessionId: string;
+    readonly scope?: Term2HookScope;
+    readonly includeUserText?: boolean;
+    readonly includeToolArguments?: boolean;
+    readonly includeToolResults?: boolean;
+};
+/** Builds the versioned envelope without exposing provider/runtime IDs. */
+export declare class HookEventFactory {
+    #private;
+    constructor(options: HookEventFactoryOptions);
+    create<Name extends Term2HookEventName>(type: Name, payload: Omit<Term2HookEventMap[Name], 'type' | 'schemaVersion' | 'eventId' | 'sessionId' | 'timestamp' | 'scope'>, correlation?: Pick<Term2HookEvent<Name>, 'turnId' | 'toolCallId'>, scope?: Term2HookScope): Term2HookEvent<Name>;
+    get includeUserText(): boolean;
+    get includeToolArguments(): boolean;
+    get includeToolResults(): boolean;
+}
+export declare function summarizeHookValue(value: unknown, maxLength?: number): unknown;
+//# sourceMappingURL=hook-event-factory.d.ts.map

package/dist/services/hooks/hook-event-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-event-factory.d.ts","sourceRoot":"","sources":["../../../source/services/hooks/hook-event-factory.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAEjH,MAAM,MAAM,uBAAuB,GAAG;IACpC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAC;IACnC,QAAQ,CAAC,oBAAoB,CAAC,EAAE,OAAO,CAAC;IACxC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,OAAO,CAAC;CACvC,CAAC;AAEF,2EAA2E;AAC3E,qBAAa,gBAAgB;;IAG3B,YAAY,OAAO,EAAE,uBAAuB,EAE3C;IAED,MAAM,CAAC,IAAI,SAAS,kBAAkB,EACpC,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,GAAG,WAAW,GAAG,WAAW,GAAG,OAAO,CAAC,EAClH,WAAW,GAAE,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,QAAQ,GAAG,YAAY,CAAM,EACrE,KAAK,GAAE,cAA8C,GACpD,cAAc,CAAC,IAAI,CAAC,CAWtB;IAED,IAAI,eAAe,IAAI,OAAO,CAE7B;IAED,IAAI,oBAAoB,IAAI,OAAO,CAElC;IAED,IAAI,kBAAkB,IAAI,OAAO,CAEhC;CACF;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,SAAM,GAAG,OAAO,CAU3E"}

package/dist/services/hooks/hook-event-factory.js

@@ -0,0 +1,45 @@
+import { randomUUID } from 'node:crypto';
+/** Builds the versioned envelope without exposing provider/runtime IDs. */
+export class HookEventFactory {
+    #options;
+    constructor(options) {
+        this.#options = options;
+    }
+    create(type, payload, correlation = {}, scope = this.#options.scope ?? 'root') {
+        return {
+            type,
+            schemaVersion: 1,
+            eventId: randomUUID(),
+            sessionId: this.#options.sessionId,
+            timestamp: Date.now(),
+            scope,
+            ...correlation,
+            ...payload,
+        };
+    }
+    get includeUserText() {
+        return this.#options.includeUserText === true;
+    }
+    get includeToolArguments() {
+        return this.#options.includeToolArguments === true;
+    }
+    get includeToolResults() {
+        return this.#options.includeToolResults === true;
+    }
+}
+export function summarizeHookValue(value, maxLength = 500) {
+    if (typeof value === 'string')
+        return value.length > maxLength ? `${value.slice(0, maxLength)}...` : value;
+    if (value === undefined || value === null || typeof value === 'number' || typeof value === 'boolean')
+        return value;
+    try {
+        const text = JSON.stringify(value);
+        if (text.length <= maxLength)
+            return value;
+        return `${text.slice(0, maxLength)}...`;
+    }
+    catch {
+        return '[unserializable]';
+    }
+}
+//# sourceMappingURL=hook-event-factory.js.map

package/dist/services/hooks/hook-event-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-event-factory.js","sourceRoot":"","sources":["../../../source/services/hooks/hook-event-factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAWzC,2EAA2E;AAC3E,MAAM,OAAO,gBAAgB;IAClB,QAAQ,CAA0B;IAE3C,YAAY,OAAgC;QAC1C,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;IAC1B,CAAC;IAED,MAAM,CACJ,IAAU,EACV,OAAkH,EAClH,WAAW,GAAwD,EAAE,EACrE,KAAK,GAAmB,IAAI,CAAC,QAAQ,CAAC,KAAK,IAAI,MAAM;QAErD,OAAO;YACL,IAAI;YACJ,aAAa,EAAE,CAAC;YAChB,OAAO,EAAE,UAAU,EAAE;YACrB,SAAS,EAAE,IAAI,CAAC,QAAQ,CAAC,SAAS;YAClC,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;YACrB,KAAK;YACL,GAAG,WAAW;YACd,GAAG,OAAO;SACa,CAAC;IAC5B,CAAC;IAED,IAAI,eAAe;QACjB,OAAO,IAAI,CAAC,QAAQ,CAAC,eAAe,KAAK,IAAI,CAAC;IAChD,CAAC;IAED,IAAI,oBAAoB;QACtB,OAAO,IAAI,CAAC,QAAQ,CAAC,oBAAoB,KAAK,IAAI,CAAC;IACrD,CAAC;IAED,IAAI,kBAAkB;QACpB,OAAO,IAAI,CAAC,QAAQ,CAAC,kBAAkB,KAAK,IAAI,CAAC;IACnD,CAAC;CACF;AAED,MAAM,UAAU,kBAAkB,CAAC,KAAc,EAAE,SAAS,GAAG,GAAG;IAChE,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC;IAC3G,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IACnH,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QACnC,IAAI,IAAI,CAAC,MAAM,IAAI,SAAS;YAAE,OAAO,KAAK,CAAC;QAC3C,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,KAAK,CAAC;IAC1C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,kBAAkB,CAAC;IAC5B,CAAC;AACH,CAAC"}

package/dist/services/hooks/hook-module-loader.d.ts

@@ -0,0 +1,38 @@
+import type { Term2HookRegistration } from './hook-contracts.js';
+export interface HookModuleLoader {
+    load(path: string): Promise<Term2HookRegistration>;
+}
+export type HookModuleImporter = (path: string) => unknown | Promise<unknown>;
+export type JitiModuleLoader = (path: string) => unknown | Promise<unknown>;
+export declare class HookModuleLoadError extends Error {
+    readonly path: string;
+    constructor(path: string, message: string, options?: {
+        readonly cause?: unknown;
+    });
+}
+declare function registrationFromModule(path: string, moduleValue: unknown): Term2HookRegistration;
+/**
+ * Loader for environments where Node's native ESM loader can evaluate the
+ * discovered file (notably JavaScript, and TypeScript under an embedding
+ * loader). It is intentionally injected so the application does not depend on
+ * its development-only tsx runner.
+ */
+export declare class NativeHookModuleLoader implements HookModuleLoader {
+    #private;
+    constructor(importer?: HookModuleImporter);
+    load(path: string): Promise<Term2HookRegistration>;
+}
+/**
+ * Adapter for a production jiti instance. jiti is deliberately not imported
+ * here: it is an optional application composition dependency, while tests and
+ * embedders can provide the same small callable interface without installing
+ * it. The adapter supports both jiti's synchronous result and async wrappers.
+ */
+export declare class JitiHookModuleLoader implements HookModuleLoader {
+    #private;
+    constructor(loadWithJiti: JitiModuleLoader);
+    load(path: string): Promise<Term2HookRegistration>;
+}
+export declare const validateHookModuleDefaultExport: typeof registrationFromModule;
+export {};
+//# sourceMappingURL=hook-module-loader.d.ts.map

package/dist/services/hooks/hook-module-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-module-loader.d.ts","sourceRoot":"","sources":["../../../source/services/hooks/hook-module-loader.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAEjE,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC;CACpD;AAED,MAAM,MAAM,kBAAkB,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;AAE9E,MAAM,MAAM,gBAAgB,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;AAE5E,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,YAAY,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,EAIhF;CACF;AAED,iBAAS,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,GAAG,qBAAqB,CAYzF;AAED;;;;;GAKG;AACH,qBAAa,sBAAuB,YAAW,gBAAgB;;IAG7D,YAAY,QAAQ,CAAC,EAAE,kBAAkB,EAExC;IAEK,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAQvD;CACF;AAED;;;;;GAKG;AACH,qBAAa,oBAAqB,YAAW,gBAAgB;;IAG3D,YAAY,YAAY,EAAE,gBAAgB,EAKzC;IAEK,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAQvD;CACF;AAED,eAAO,MAAM,+BAA+B,+BAAyB,CAAC"}

package/dist/services/hooks/hook-module-loader.js

@@ -0,0 +1,69 @@
+import { pathToFileURL } from 'node:url';
+export class HookModuleLoadError extends Error {
+    path;
+    constructor(path, message, options) {
+        super(`${message}: ${path}`, options);
+        this.name = 'HookModuleLoadError';
+        this.path = path;
+    }
+}
+function registrationFromModule(path, moduleValue) {
+    const candidate = typeof moduleValue === 'function'
+        ? moduleValue
+        : typeof moduleValue === 'object' && moduleValue !== null
+            ? moduleValue.default
+            : undefined;
+    if (typeof candidate !== 'function') {
+        throw new HookModuleLoadError(path, 'Hook module must default-export a registration function');
+    }
+    return candidate;
+}
+/**
+ * Loader for environments where Node's native ESM loader can evaluate the
+ * discovered file (notably JavaScript, and TypeScript under an embedding
+ * loader). It is intentionally injected so the application does not depend on
+ * its development-only tsx runner.
+ */
+export class NativeHookModuleLoader {
+    #importer;
+    constructor(importer) {
+        this.#importer = importer ?? ((path) => import(pathToFileURL(path).href));
+    }
+    async load(path) {
+        let moduleValue;
+        try {
+            moduleValue = await this.#importer(path);
+        }
+        catch (error) {
+            throw new HookModuleLoadError(path, 'Could not evaluate hook module', { cause: error });
+        }
+        return registrationFromModule(path, moduleValue);
+    }
+}
+/**
+ * Adapter for a production jiti instance. jiti is deliberately not imported
+ * here: it is an optional application composition dependency, while tests and
+ * embedders can provide the same small callable interface without installing
+ * it. The adapter supports both jiti's synchronous result and async wrappers.
+ */
+export class JitiHookModuleLoader {
+    #loadWithJiti;
+    constructor(loadWithJiti) {
+        if (typeof loadWithJiti !== 'function') {
+            throw new TypeError('A jiti module loader function is required');
+        }
+        this.#loadWithJiti = loadWithJiti;
+    }
+    async load(path) {
+        let moduleValue;
+        try {
+            moduleValue = await this.#loadWithJiti(path);
+        }
+        catch (error) {
+            throw new HookModuleLoadError(path, 'Could not evaluate hook module', { cause: error });
+        }
+        return registrationFromModule(path, moduleValue);
+    }
+}
+export const validateHookModuleDefaultExport = registrationFromModule;
+//# sourceMappingURL=hook-module-loader.js.map

package/dist/services/hooks/hook-module-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-module-loader.js","sourceRoot":"","sources":["../../../source/services/hooks/hook-module-loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAYzC,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IACnC,IAAI,CAAS;IAEtB,YAAY,IAAY,EAAE,OAAe,EAAE,OAAsC;QAC/E,KAAK,CAAC,GAAG,OAAO,KAAK,IAAI,EAAE,EAAE,OAAO,CAAC,CAAC;QACtC,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;QAClC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF;AAED,SAAS,sBAAsB,CAAC,IAAY,EAAE,WAAoB;IAChE,MAAM,SAAS,GACb,OAAO,WAAW,KAAK,UAAU;QAC/B,CAAC,CAAC,WAAW;QACb,CAAC,CAAC,OAAO,WAAW,KAAK,QAAQ,IAAI,WAAW,KAAK,IAAI;YACzD,CAAC,CAAE,WAAqC,CAAC,OAAO;YAChD,CAAC,CAAC,SAAS,CAAC;IAEhB,IAAI,OAAO,SAAS,KAAK,UAAU,EAAE,CAAC;QACpC,MAAM,IAAI,mBAAmB,CAAC,IAAI,EAAE,yDAAyD,CAAC,CAAC;IACjG,CAAC;IACD,OAAO,SAAkC,CAAC;AAC5C,CAAC;AAED;;;;;GAKG;AACH,MAAM,OAAO,sBAAsB;IACxB,SAAS,CAAqB;IAEvC,YAAY,QAA6B;QACvC,IAAI,CAAC,SAAS,GAAG,QAAQ,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAC5E,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,IAAY;QACrB,IAAI,WAAoB,CAAC;QACzB,IAAI,CAAC;YACH,WAAW,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAC3C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,mBAAmB,CAAC,IAAI,EAAE,gCAAgC,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;QAC1F,CAAC;QACD,OAAO,sBAAsB,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IACnD,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,OAAO,oBAAoB;IACtB,aAAa,CAAmB;IAEzC,YAAY,YAA8B;QACxC,IAAI,OAAO,YAAY,KAAK,UAAU,EAAE,CAAC;YACvC,MAAM,IAAI,SAAS,CAAC,2CAA2C,CAAC,CAAC;QACnE,CAAC;QACD,IAAI,CAAC,aAAa,GAAG,YAAY,CAAC;IACpC,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,IAAY;QACrB,IAAI,WAAoB,CAAC;QACzB,IAAI,CAAC;YACH,WAAW,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;QAC/C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,mBAAmB,CAAC,IAAI,EAAE,gCAAgC,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;QAC1F,CAAC;QACD,OAAO,sBAAsB,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IACnD,CAAC;CACF;AAED,MAAM,CAAC,MAAM,+BAA+B,GAAG,sBAAsB,CAAC"}

package/dist/services/hooks/hook-registry.d.ts

@@ -0,0 +1,47 @@
+import type { Term2HookEvent, Term2HookEventName, Term2HookRegistration } from './hook-contracts.js';
+export declare const DEFAULT_HOOK_CALLBACK_TIMEOUT_MS = 5000;
+export interface HookRegistrationSource {
+    readonly path?: string;
+    readonly scope?: 'user' | 'project' | string;
+}
+export interface HookDiagnostic {
+    readonly code: 'registration_rejected' | 'callback_failed' | 'callback_timed_out' | 'diagnostic_logger_failed' | 'duplicate_event' | 'discovery_failed' | 'symlink_rejected' | 'project_hooks_untrusted' | 'hook_disabled' | 'module_load_failed';
+    readonly message: string;
+    readonly source?: HookRegistrationSource;
+    readonly eventType?: Term2HookEventName;
+    readonly callbackIndex?: number;
+    readonly eventId?: string;
+    readonly durationMs?: number;
+    readonly error?: unknown;
+}
+export type HookDiagnosticLogger = (diagnostic: HookDiagnostic) => void;
+export interface HookRegistryOptions {
+    readonly callbackTimeoutMs?: number;
+    readonly logger?: HookDiagnosticLogger;
+}
+export declare class HookRegistrationClosedError extends Error {
+    constructor();
+}
+/**
+ * Ordered, passive callback registry.  A registry deliberately has no
+ * behavior-changing callback result: callbacks are observed and failures are
+ * isolated from the application and from one another.
+ */
+export declare class HookRegistry {
+    #private;
+    constructor(options?: HookRegistryOptions);
+    get callbackTimeoutMs(): number;
+    get size(): number;
+    /**
+     * Load one module's registration function transactionally.  If registration
+     * throws, every callback added by that module is removed before the error is
+     * rethrown to the service, so a broken file cannot leave a partial module.
+     */
+    register(source: string | HookRegistrationSource | Term2HookRegistration, registration?: HookRegistrationSource | Term2HookRegistration): Promise<void>;
+    /** Alias that makes the transactional boundary explicit at call sites. */
+    registerModule(source: string | HookRegistrationSource, registration: Term2HookRegistration): Promise<void>;
+    dispatch<Name extends Term2HookEventName>(event: Term2HookEvent<Name>): Promise<void>;
+    /** Remove all callbacks and make a future service run start cleanly. */
+    clear(): void;
+}
+//# sourceMappingURL=hook-registry.d.ts.map

package/dist/services/hooks/hook-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-registry.d.ts","sourceRoot":"","sources":["../../../source/services/hooks/hook-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,cAAc,EACd,kBAAkB,EAClB,qBAAqB,EAEtB,MAAM,qBAAqB,CAAC;AAE7B,eAAO,MAAM,gCAAgC,OAAQ,CAAC;AAEtD,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC;CAC9C;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EACT,uBAAuB,GACvB,iBAAiB,GACjB,oBAAoB,GACpB,0BAA0B,GAC1B,iBAAiB,GACjB,kBAAkB,GAClB,kBAAkB,GAClB,yBAAyB,GACzB,eAAe,GACf,oBAAoB,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,sBAAsB,CAAC;IACzC,QAAQ,CAAC,SAAS,CAAC,EAAE,kBAAkB,CAAC;IACxC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,MAAM,oBAAoB,GAAG,CAAC,UAAU,EAAE,cAAc,KAAK,IAAI,CAAC;AAExE,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,MAAM,CAAC,EAAE,oBAAoB,CAAC;CACxC;AAED,qBAAa,2BAA4B,SAAQ,KAAK;IACpD,cAGC;CACF;AAoBD;;;;GAIG;AACH,qBAAa,YAAY;;IAOvB,YAAY,OAAO,GAAE,mBAAwB,EAO5C;IAED,IAAI,iBAAiB,IAAI,MAAM,CAE9B;IAED,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;;;OAIG;IACG,QAAQ,CACZ,MAAM,EAAE,MAAM,GAAG,sBAAsB,GAAG,qBAAqB,EAC/D,YAAY,CAAC,EAAE,sBAAsB,GAAG,qBAAqB,GAC5D,OAAO,CAAC,IAAI,CAAC,CAoCf;IAED,0EAA0E;IAC1E,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,sBAAsB,EAAE,YAAY,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAE1G;IAEK,QAAQ,CAAC,IAAI,SAAS,kBAAkB,EAAE,KAAK,EAAE,cAAc,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAmB1F;IAED,wEAAwE;IACxE,KAAK,IAAI,IAAI,CAIZ;CAgFF"}

package/dist/services/hooks/hook-registry.js

@@ -0,0 +1,185 @@
+export const DEFAULT_HOOK_CALLBACK_TIMEOUT_MS = 5_000;
+export class HookRegistrationClosedError extends Error {
+    constructor() {
+        super('Term2Hooks.on() may only be called while a hook registration function is running');
+        this.name = 'HookRegistrationClosedError';
+    }
+}
+function normalizeSource(source) {
+    if (source === undefined)
+        return undefined;
+    return typeof source === 'string' ? { path: source } : source;
+}
+/**
+ * Ordered, passive callback registry.  A registry deliberately has no
+ * behavior-changing callback result: callbacks are observed and failures are
+ * isolated from the application and from one another.
+ */
+export class HookRegistry {
+    #callbacks = [];
+    #seenEventIds = new Set();
+    #timeoutMs;
+    #logger;
+    #activeFrame;
+    constructor(options = {}) {
+        const timeoutMs = options.callbackTimeoutMs ?? DEFAULT_HOOK_CALLBACK_TIMEOUT_MS;
+        if (!Number.isFinite(timeoutMs) || timeoutMs <= 0) {
+            throw new RangeError('Hook callback timeout must be a finite number greater than zero');
+        }
+        this.#timeoutMs = timeoutMs;
+        this.#logger = options.logger;
+    }
+    get callbackTimeoutMs() {
+        return this.#timeoutMs;
+    }
+    get size() {
+        return this.#callbacks.filter((callback) => callback.active).length;
+    }
+    /**
+     * Load one module's registration function transactionally.  If registration
+     * throws, every callback added by that module is removed before the error is
+     * rethrown to the service, so a broken file cannot leave a partial module.
+     */
+    async register(source, registration) {
+        let registrationFunction;
+        let registrationSource;
+        if (typeof source === 'function') {
+            registrationFunction = source;
+            registrationSource = normalizeSource(registration);
+        }
+        else {
+            if (typeof registration !== 'function') {
+                throw new TypeError('A hook registration function is required');
+            }
+            registrationFunction = registration;
+            registrationSource = normalizeSource(source);
+        }
+        if (this.#activeFrame) {
+            throw new Error('Hook registrations cannot run concurrently');
+        }
+        const frame = { source: registrationSource, callbacks: [], active: true };
+        this.#activeFrame = frame;
+        try {
+            await registrationFunction(this.#createRegistrar(frame));
+        }
+        catch (error) {
+            for (const callback of frame.callbacks)
+                callback.active = false;
+            this.#log({
+                code: 'registration_rejected',
+                message: 'Hook registration failed; all callbacks from the module were rolled back',
+                source: frame.source,
+                error,
+            });
+            throw error;
+        }
+        finally {
+            frame.active = false;
+            if (this.#activeFrame === frame)
+                this.#activeFrame = undefined;
+        }
+    }
+    /** Alias that makes the transactional boundary explicit at call sites. */
+    registerModule(source, registration) {
+        return this.register(source, registration);
+    }
+    async dispatch(event) {
+        if (this.#seenEventIds.has(event.eventId)) {
+            this.#log({
+                code: 'duplicate_event',
+                message: 'Skipped a hook event whose eventId had already been dispatched',
+                eventType: event.type,
+                eventId: event.eventId,
+            });
+            return;
+        }
+        this.#seenEventIds.add(event.eventId);
+        // Keep the registration order, but consult active at invocation time so an
+        // unsubscribe from an earlier callback takes effect immediately.
+        for (let index = 0; index < this.#callbacks.length; index += 1) {
+            const registered = this.#callbacks[index];
+            if (!registered.active || registered.event !== event.type)
+                continue;
+            await this.#dispatchOne(registered, event, index);
+        }
+    }
+    /** Remove all callbacks and make a future service run start cleanly. */
+    clear() {
+        for (const callback of this.#callbacks)
+            callback.active = false;
+        this.#callbacks.length = 0;
+        this.#seenEventIds.clear();
+    }
+    #createRegistrar(frame) {
+        return {
+            on: (event, callback) => {
+                if (!frame.active || this.#activeFrame !== frame)
+                    throw new HookRegistrationClosedError();
+                if (typeof callback !== 'function')
+                    throw new TypeError('A hook callback must be a function');
+                const registered = {
+                    event,
+                    callback: callback,
+                    source: frame.source,
+                    active: true,
+                };
+                frame.callbacks.push(registered);
+                this.#callbacks.push(registered);
+                return () => {
+                    registered.active = false;
+                };
+            },
+        };
+    }
+    async #dispatchOne(registered, event, callbackIndex) {
+        const startedAt = Date.now();
+        let timer;
+        // Attach a rejection handler to the callback promise before racing it.  A
+        // timed-out callback may continue running, and its eventual rejection must
+        // not become an unhandled rejection.
+        const callbackPromise = Promise.resolve()
+            .then(() => registered.callback(event))
+            .then(() => undefined, (error) => {
+            this.#log({
+                code: 'callback_failed',
+                message: 'Hook callback failed; continuing with the next callback',
+                source: registered.source,
+                eventType: event.type,
+                callbackIndex,
+                eventId: event.eventId,
+                durationMs: Date.now() - startedAt,
+                error,
+            });
+        });
+        const timeoutPromise = new Promise((resolve) => {
+            timer = setTimeout(() => resolve('timeout'), this.#timeoutMs);
+        });
+        const result = await Promise.race([callbackPromise.then(() => 'callback'), timeoutPromise]);
+        if (timer !== undefined)
+            clearTimeout(timer);
+        if (result === 'timeout') {
+            this.#log({
+                code: 'callback_timed_out',
+                message: 'Hook callback timed out; the in-process callback cannot be cancelled and may continue running',
+                source: registered.source,
+                eventType: event.type,
+                callbackIndex,
+                eventId: event.eventId,
+                durationMs: Date.now() - startedAt,
+            });
+        }
+    }
+    #log(diagnostic) {
+        if (!this.#logger)
+            return;
+        try {
+            this.#logger(diagnostic);
+        }
+        catch (error) {
+            // Diagnostics must never turn a passive hook failure into an application
+            // failure. There is nowhere safe to report a logger failure from here.
+            void error;
+        }
+    }
+}
+//# sourceMappingURL=hook-registry.js.map

package/dist/services/hooks/hook-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-registry.js","sourceRoot":"","sources":["../../../source/services/hooks/hook-registry.ts"],"names":[],"mappings":"AAQA,MAAM,CAAC,MAAM,gCAAgC,GAAG,KAAK,CAAC;AAmCtD,MAAM,OAAO,2BAA4B,SAAQ,KAAK;IACpD;QACE,KAAK,CAAC,kFAAkF,CAAC,CAAC;QAC1F,IAAI,CAAC,IAAI,GAAG,6BAA6B,CAAC;IAC5C,CAAC;CACF;AAeD,SAAS,eAAe,CAAC,MAAwC;IAC/D,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC3C,OAAO,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;AAChE,CAAC;AAED;;;;GAIG;AACH,MAAM,OAAO,YAAY;IACd,UAAU,GAAyB,EAAE,CAAC;IACtC,aAAa,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,UAAU,CAAS;IACnB,OAAO,CAAwB;IACxC,YAAY,CAAgC;IAE5C,YAAY,OAAO,GAAwB,EAAE;QAC3C,MAAM,SAAS,GAAG,OAAO,CAAC,iBAAiB,IAAI,gCAAgC,CAAC;QAChF,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,SAAS,IAAI,CAAC,EAAE,CAAC;YAClD,MAAM,IAAI,UAAU,CAAC,iEAAiE,CAAC,CAAC;QAC1F,CAAC;QACD,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;QAC5B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC;IAChC,CAAC;IAED,IAAI,iBAAiB;QACnB,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC;IACtE,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,QAAQ,CACZ,MAA+D,EAC/D,YAA6D;QAE7D,IAAI,oBAA2C,CAAC;QAChD,IAAI,kBAAsD,CAAC;QAE3D,IAAI,OAAO,MAAM,KAAK,UAAU,EAAE,CAAC;YACjC,oBAAoB,GAAG,MAAM,CAAC;YAC9B,kBAAkB,GAAG,eAAe,CAAC,YAAkD,CAAC,CAAC;QAC3F,CAAC;aAAM,CAAC;YACN,IAAI,OAAO,YAAY,KAAK,UAAU,EAAE,CAAC;gBACvC,MAAM,IAAI,SAAS,CAAC,0CAA0C,CAAC,CAAC;YAClE,CAAC;YACD,oBAAoB,GAAG,YAAY,CAAC;YACpC,kBAAkB,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;QAC/C,CAAC;QAED,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;QAChE,CAAC;QAED,MAAM,KAAK,GAAsB,EAAE,MAAM,EAAE,kBAAkB,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;QAC7F,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC;QAC1B,IAAI,CAAC;YACH,MAAM,oBAAoB,CAAC,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC,CAAC;QAC3D,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,KAAK,MAAM,QAAQ,IAAI,KAAK,CAAC,SAAS;gBAAE,QAAQ,CAAC,MAAM,GAAG,KAAK,CAAC;YAChE,IAAI,CAAC,IAAI,CAAC;gBACR,IAAI,EAAE,uBAAuB;gBAC7B,OAAO,EAAE,0EAA0E;gBACnF,MAAM,EAAE,KAAK,CAAC,MAAM;gBACpB,KAAK;aACN,CAAC,CAAC;YACH,MAAM,KAAK,CAAC;QACd,CAAC;gBAAS,CAAC;YACT,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC;YACrB,IAAI,IAAI,CAAC,YAAY,KAAK,KAAK;gBAAE,IAAI,CAAC,YAAY,GAAG,SAAS,CAAC;QACjE,CAAC;IACH,CAAC;IAED,0EAA0E;IAC1E,cAAc,CAAC,MAAuC,EAAE,YAAmC;QACzF,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAC7C,CAAC;IAED,KAAK,CAAC,QAAQ,CAAkC,KAA2B;QACzE,IAAI,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;YAC1C,IAAI,CAAC,IAAI,CAAC;gBACR,IAAI,EAAE,iBAAiB;gBACvB,OAAO,EAAE,gEAAgE;gBACzE,SAAS,EAAE,KAAK,CAAC,IAAI;gBACrB,OAAO,EAAE,KAAK,CAAC,OAAO;aACvB,CAAC,CAAC;YACH,OAAO;QACT,CAAC;QACD,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAEtC,2EAA2E;QAC3E,iEAAiE;QACjE,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;YAC/D,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;YAC1C,IAAI,CAAC,UAAU,CAAC,MAAM,IAAI,UAAU,CAAC,KAAK,KAAK,KAAK,CAAC,IAAI;gBAAE,SAAS;YACpE,MAAM,IAAI,CAAC,YAAY,CAAC,UAAU,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;QACpD,CAAC;IACH,CAAC;IAED,wEAAwE;IACxE,KAAK;QACH,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,UAAU;YAAE,QAAQ,CAAC,MAAM,GAAG,KAAK,CAAC;QAChE,IAAI,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC;QAC3B,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,CAAC;IAC7B,CAAC;IAED,gBAAgB,CAAC,KAAwB;QACvC,OAAO;YACL,EAAE,EAAE,CAAkC,KAAW,EAAE,QAAiC,EAAgB,EAAE;gBACpG,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,IAAI,CAAC,YAAY,KAAK,KAAK;oBAAE,MAAM,IAAI,2BAA2B,EAAE,CAAC;gBAC1F,IAAI,OAAO,QAAQ,KAAK,UAAU;oBAAE,MAAM,IAAI,SAAS,CAAC,oCAAoC,CAAC,CAAC;gBAE9F,MAAM,UAAU,GAAuB;oBACrC,KAAK;oBACL,QAAQ,EAAE,QAAiD;oBAC3D,MAAM,EAAE,KAAK,CAAC,MAAM;oBACpB,MAAM,EAAE,IAAI;iBACb,CAAC;gBACF,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;gBACjC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;gBACjC,OAAO,GAAG,EAAE;oBACV,UAAU,CAAC,MAAM,GAAG,KAAK,CAAC;gBAC5B,CAAC,CAAC;YACJ,CAAC;SACF,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,YAAY,CAChB,UAA8B,EAC9B,KAA2B,EAC3B,aAAqB;QAErB,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC7B,IAAI,KAAgD,CAAC;QAErD,0EAA0E;QAC1E,2EAA2E;QAC3E,qCAAqC;QACrC,MAAM,eAAe,GAAG,OAAO,CAAC,OAAO,EAAE;aACtC,IAAI,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,KAA2C,CAAC,CAAC;aAC5E,IAAI,CACH,GAAG,EAAE,CAAC,SAAS,EACf,CAAC,KAAc,EAAE,EAAE;YACjB,IAAI,CAAC,IAAI,CAAC;gBACR,IAAI,EAAE,iBAAiB;gBACvB,OAAO,EAAE,yDAAyD;gBAClE,MAAM,EAAE,UAAU,CAAC,MAAM;gBACzB,SAAS,EAAE,KAAK,CAAC,IAAI;gBACrB,aAAa;gBACb,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;gBAClC,KAAK;aACN,CAAC,CAAC;QACL,CAAC,CACF,CAAC;QACJ,MAAM,cAAc,GAAG,IAAI,OAAO,CAAY,CAAC,OAAO,EAAE,EAAE;YACxD,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;QAChE,CAAC,CAAC,CAAC;QAEH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,UAAmB,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC;QACrG,IAAI,KAAK,KAAK,SAAS;YAAE,YAAY,CAAC,KAAK,CAAC,CAAC;QAC7C,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,IAAI,CAAC,IAAI,CAAC;gBACR,IAAI,EAAE,oBAAoB;gBAC1B,OAAO,EAAE,+FAA+F;gBACxG,MAAM,EAAE,UAAU,CAAC,MAAM;gBACzB,SAAS,EAAE,KAAK,CAAC,IAAI;gBACrB,aAAa;gBACb,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;aACnC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,IAAI,CAAC,UAA0B;QAC7B,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO;QAC1B,IAAI,CAAC;YACH,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAC3B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,yEAAyE;YACzE,uEAAuE;YACvE,KAAK,KAAK,CAAC;QACb,CAAC;IACH,CAAC;CACF"}