@qduc/term2 0.11.1 → 0.13.0

package/dist/services/handoff/handoff-flow-reducer.d.ts

@@ -0,0 +1,27 @@
+export type HandoffStage = 'entering_message' | 'confirm_model' | 'selecting_model' | 'selecting_effort' | 'confirm_standard_mode';
+export interface HandoffState {
+    capturedText: string;
+    stage: HandoffStage;
+    handoffMessage?: string;
+}
+export type HandoffAction = {
+    type: 'handoff/started';
+    capturedText: string;
+} | {
+    type: 'handoff/message_captured';
+    handoffMessage: string;
+} | {
+    type: 'handoff/model_confirmed';
+} | {
+    type: 'handoff/model_selected';
+} | {
+    type: 'handoff/standard_mode_requested';
+} | {
+    type: 'handoff/sent';
+} | {
+    type: 'handoff/cancelled';
+};
+export declare function createInitialHandoffState(): HandoffState | null;
+export declare function composeHandoffMessage(state: HandoffState): string;
+export declare function handoffFlowReducer(state: HandoffState | null, action: HandoffAction): HandoffState | null;
+//# sourceMappingURL=handoff-flow-reducer.d.ts.map

package/dist/services/handoff/handoff-flow-reducer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handoff-flow-reducer.d.ts","sourceRoot":"","sources":["../../../source/services/handoff/handoff-flow-reducer.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GACpB,kBAAkB,GAClB,eAAe,GACf,iBAAiB,GACjB,kBAAkB,GAClB,uBAAuB,CAAC;AAE5B,MAAM,WAAW,YAAY;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,YAAY,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,MAAM,aAAa,GACrB;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,GACjD;IAAE,IAAI,EAAE,0BAA0B,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,GAC5D;IAAE,IAAI,EAAE,yBAAyB,CAAA;CAAE,GACnC;IAAE,IAAI,EAAE,wBAAwB,CAAA;CAAE,GAClC;IAAE,IAAI,EAAE,iCAAiC,CAAA;CAAE,GAC3C;IAAE,IAAI,EAAE,cAAc,CAAA;CAAE,GACxB;IAAE,IAAI,EAAE,mBAAmB,CAAA;CAAE,CAAC;AAElC,wBAAgB,yBAAyB,IAAI,YAAY,GAAG,IAAI,CAE/D;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CAEjE;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,EAAE,MAAM,EAAE,aAAa,GAAG,YAAY,GAAG,IAAI,CAkBzG"}

package/dist/services/handoff/handoff-flow-reducer.js

@@ -0,0 +1,26 @@
+export function createInitialHandoffState() {
+    return null;
+}
+export function composeHandoffMessage(state) {
+    return `${state.handoffMessage || 'Implement this'}:\n\n${state.capturedText}`;
+}
+export function handoffFlowReducer(state, action) {
+    switch (action.type) {
+        case 'handoff/started':
+            return { capturedText: action.capturedText, stage: 'entering_message' };
+        case 'handoff/message_captured':
+            return state?.stage === 'entering_message'
+                ? { ...state, handoffMessage: action.handoffMessage, stage: 'confirm_model' }
+                : state;
+        case 'handoff/model_confirmed':
+            return state ? { ...state, stage: 'selecting_model' } : state;
+        case 'handoff/model_selected':
+            return state?.stage === 'selecting_model' ? { ...state, stage: 'selecting_effort' } : state;
+        case 'handoff/standard_mode_requested':
+            return state ? { ...state, stage: 'confirm_standard_mode' } : state;
+        case 'handoff/sent':
+        case 'handoff/cancelled':
+            return state ? null : state;
+    }
+}
+//# sourceMappingURL=handoff-flow-reducer.js.map

package/dist/services/handoff/handoff-flow-reducer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handoff-flow-reducer.js","sourceRoot":"","sources":["../../../source/services/handoff/handoff-flow-reducer.ts"],"names":[],"mappings":"AAsBA,MAAM,UAAU,yBAAyB;IACvC,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,KAAmB;IACvD,OAAO,GAAG,KAAK,CAAC,cAAc,IAAI,gBAAgB,QAAQ,KAAK,CAAC,YAAY,EAAE,CAAC;AACjF,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,KAA0B,EAAE,MAAqB;IAClF,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;QACpB,KAAK,iBAAiB;YACpB,OAAO,EAAE,YAAY,EAAE,MAAM,CAAC,YAAY,EAAE,KAAK,EAAE,kBAAkB,EAAE,CAAC;QAC1E,KAAK,0BAA0B;YAC7B,OAAO,KAAK,EAAE,KAAK,KAAK,kBAAkB;gBACxC,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,cAAc,EAAE,MAAM,CAAC,cAAc,EAAE,KAAK,EAAE,eAAe,EAAE;gBAC7E,CAAC,CAAC,KAAK,CAAC;QACZ,KAAK,yBAAyB;YAC5B,OAAO,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,KAAK,EAAE,iBAAiB,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;QAChE,KAAK,wBAAwB;YAC3B,OAAO,KAAK,EAAE,KAAK,KAAK,iBAAiB,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,KAAK,EAAE,kBAAkB,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;QAC9F,KAAK,iCAAiC;YACpC,OAAO,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,KAAK,EAAE,uBAAuB,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;QACtE,KAAK,cAAc,CAAC;QACpB,KAAK,mBAAmB;YACtB,OAAO,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC;IAChC,CAAC;AACH,CAAC"}

package/dist/services/handoff/handoff-session.d.ts

@@ -0,0 +1,35 @@
+import type { SettingsService } from '../settings/settings-service.js';
+import type { ConversationConfigurationService } from '../runtime-setting-router.js';
+import { type HandoffState } from './handoff-flow-reducer.js';
+export type HandoffSessionDeps = {
+    clearConversationAndRefreshBanner: () => Promise<void>;
+    addSystemMessage: (text: string) => void;
+    sendUserMessage: (turn: {
+        text: string;
+    }) => Promise<void>;
+    settingsService: SettingsService;
+    applyRuntimeSetting: (key: string, value: unknown) => void;
+    setModel: (model: string) => void;
+    configurationService?: ConversationConfigurationService;
+};
+/**
+ * Owns handoff policy and effects. React/menu code remains responsible for
+ * presenting this snapshot and for deciding when a controller frame closed.
+ */
+export declare class HandoffSession {
+    #private;
+    constructor(deps: HandoffSessionDeps);
+    getState(): HandoffState | null;
+    subscribe(listener: (state: HandoffState | null) => void): () => void;
+    startHandoff(capturedText: string): void;
+    captureMessage(text: string): boolean;
+    confirmHandoff(): Promise<boolean>;
+    declineHandoff(): Promise<boolean>;
+    cancelHandoff(): boolean;
+    sendCapturedHandoff(): Promise<boolean>;
+    selectModel(text: string): boolean;
+    completeHandoffWithEffort(effort: string): Promise<boolean>;
+    confirmStandardMode(): Promise<boolean>;
+    declineStandardMode(): Promise<boolean>;
+}
+//# sourceMappingURL=handoff-session.d.ts.map

package/dist/services/handoff/handoff-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handoff-session.d.ts","sourceRoot":"","sources":["../../../source/services/handoff/handoff-session.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AACvE,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,8BAA8B,CAAC;AACrF,OAAO,EAKL,KAAK,YAAY,EAClB,MAAM,2BAA2B,CAAC;AAEnC,MAAM,MAAM,kBAAkB,GAAG;IAC/B,iCAAiC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACvD,gBAAgB,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACzC,eAAe,EAAE,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3D,eAAe,EAAE,eAAe,CAAC;IACjC,mBAAmB,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IAC3D,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,oBAAoB,CAAC,EAAE,gCAAgC,CAAC;CACzD,CAAC;AAEF;;;GAGG;AACH,qBAAa,cAAc;;IAKzB,YAAY,IAAI,EAAE,kBAAkB,EAEnC;IAED,QAAQ,IAAI,YAAY,GAAG,IAAI,CAE9B;IAED,SAAS,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,KAAK,IAAI,GAAG,MAAM,IAAI,CAGpE;IAED,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAEvC;IAED,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAIpC;IAEK,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC,CAKvC;IAEK,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC,CAWvC;IAED,aAAa,IAAI,OAAO,CAKvB;IAEK,mBAAmB,IAAI,OAAO,CAAC,OAAO,CAAC,CAS5C;IAED,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAsBjC;IAEK,yBAAyB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAKhE;IAEK,mBAAmB,IAAI,OAAO,CAAC,OAAO,CAAC,CAM5C;IAEK,mBAAmB,IAAI,OAAO,CAAC,OAAO,CAAC,CAI5C;CAqBF"}

package/dist/services/handoff/handoff-session.js

@@ -0,0 +1,136 @@
+import { parseInput } from '../../utils/input-parser.js';
+import { parseModelProviderArg } from '../../utils/ai/model-provider-arg.js';
+import { handoffFlowReducer, createInitialHandoffState, composeHandoffMessage, } from './handoff-flow-reducer.js';
+/**
+ * Owns handoff policy and effects. React/menu code remains responsible for
+ * presenting this snapshot and for deciding when a controller frame closed.
+ */
+export class HandoffSession {
+    #state = createInitialHandoffState();
+    #deps;
+    #listeners = new Set();
+    constructor(deps) {
+        this.#deps = deps;
+    }
+    getState() {
+        return this.#state;
+    }
+    subscribe(listener) {
+        this.#listeners.add(listener);
+        return () => this.#listeners.delete(listener);
+    }
+    startHandoff(capturedText) {
+        this.#dispatch({ type: 'handoff/started', capturedText });
+    }
+    captureMessage(text) {
+        if (this.#state?.stage !== 'entering_message')
+            return false;
+        this.#dispatch({ type: 'handoff/message_captured', handoffMessage: text.trim() || 'Implement this' });
+        return true;
+    }
+    async confirmHandoff() {
+        if (!this.#state)
+            return false;
+        await this.#deps.clearConversationAndRefreshBanner();
+        this.#dispatch({ type: 'handoff/model_confirmed' });
+        return true;
+    }
+    async declineHandoff() {
+        const state = this.#state;
+        if (!state)
+            return false;
+        if (this.#deps.settingsService.get('app.planMode')) {
+            await this.#deps.clearConversationAndRefreshBanner();
+            this.#dispatch({ type: 'handoff/standard_mode_requested' });
+            return true;
+        }
+        await this.#deps.clearConversationAndRefreshBanner();
+        await this.#sendAndFinish(state);
+        return true;
+    }
+    cancelHandoff() {
+        if (!this.#state)
+            return false;
+        this.#dispatch({ type: 'handoff/cancelled' });
+        this.#deps.addSystemMessage('Handoff cancelled');
+        return true;
+    }
+    async sendCapturedHandoff() {
+        const state = this.#state;
+        if (!state || (state.stage !== 'selecting_model' && state.stage !== 'selecting_effort'))
+            return false;
+        if (this.#deps.settingsService.get('app.planMode')) {
+            this.#dispatch({ type: 'handoff/standard_mode_requested' });
+            return true;
+        }
+        await this.#sendAndFinish(state);
+        return true;
+    }
+    selectModel(text) {
+        if (!this.#state || this.#state.stage !== 'selecting_model')
+            return false;
+        const parsedInput = parseInput(text);
+        const modelArg = parsedInput.type === 'slash-command' ? parsedInput.args : text;
+        const { modelId, provider } = parseModelProviderArg(modelArg);
+        if (modelId) {
+            const changes = [{ key: 'agent.model', value: modelId, persistence: 'runtime' }];
+            if (provider)
+                changes.push({ key: 'agent.provider', value: provider, persistence: 'runtime' });
+            if (this.#deps.configurationService) {
+                this.#deps.configurationService.apply(changes);
+            }
+            else {
+                this.#deps.settingsService.set('agent.model', modelId);
+                if (provider) {
+                    this.#deps.settingsService.set('agent.provider', provider);
+                    this.#deps.applyRuntimeSetting('agent.provider', provider);
+                }
+                this.#deps.applyRuntimeSetting('agent.model', modelId);
+                this.#deps.setModel(modelId);
+            }
+        }
+        this.#dispatch({ type: 'handoff/model_selected' });
+        return true;
+    }
+    async completeHandoffWithEffort(effort) {
+        const state = this.#state;
+        if (!state)
+            return false;
+        this.#applyRuntimeSetting('agent.reasoningEffort', effort);
+        return this.#sendAndFinish(state);
+    }
+    async confirmStandardMode() {
+        const state = this.#state;
+        if (!state)
+            return false;
+        this.#applyRuntimeSetting('app.planMode', false);
+        this.#deps.addSystemMessage('Plan mode disabled - switched to Standard mode');
+        return this.#sendAndFinish(state);
+    }
+    async declineStandardMode() {
+        const state = this.#state;
+        if (!state)
+            return false;
+        return this.#sendAndFinish(state);
+    }
+    #dispatch(action) {
+        this.#state = handoffFlowReducer(this.#state, action);
+        for (const listener of this.#listeners)
+            listener(this.#state);
+    }
+    async #sendAndFinish(state) {
+        this.#dispatch({ type: 'handoff/sent' });
+        if (state.capturedText)
+            await this.#deps.sendUserMessage({ text: composeHandoffMessage(state) });
+        return true;
+    }
+    #applyRuntimeSetting(key, value) {
+        if (this.#deps.configurationService) {
+            this.#deps.configurationService.apply([{ key, value, persistence: 'runtime' }]);
+            return;
+        }
+        this.#deps.settingsService.set(key, value);
+        this.#deps.applyRuntimeSetting(key, value);
+    }
+}
+//# sourceMappingURL=handoff-session.js.map

package/dist/services/handoff/handoff-session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handoff-session.js","sourceRoot":"","sources":["../../../source/services/handoff/handoff-session.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAG7E,OAAO,EACL,kBAAkB,EAClB,yBAAyB,EACzB,qBAAqB,GAGtB,MAAM,2BAA2B,CAAC;AAYnC;;;GAGG;AACH,MAAM,OAAO,cAAc;IACzB,MAAM,GAAwB,yBAAyB,EAAE,CAAC;IACjD,KAAK,CAAqB;IAC1B,UAAU,GAAG,IAAI,GAAG,EAAwC,CAAC;IAEtE,YAAY,IAAwB;QAClC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;IACpB,CAAC;IAED,QAAQ;QACN,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,SAAS,CAAC,QAA8C;QACtD,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC9B,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAChD,CAAC;IAED,YAAY,CAAC,YAAoB;QAC/B,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,iBAAiB,EAAE,YAAY,EAAE,CAAC,CAAC;IAC5D,CAAC;IAED,cAAc,CAAC,IAAY;QACzB,IAAI,IAAI,CAAC,MAAM,EAAE,KAAK,KAAK,kBAAkB;YAAE,OAAO,KAAK,CAAC;QAC5D,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,0BAA0B,EAAE,cAAc,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,gBAAgB,EAAE,CAAC,CAAC;QACtG,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,cAAc;QAClB,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,OAAO,KAAK,CAAC;QAC/B,MAAM,IAAI,CAAC,KAAK,CAAC,iCAAiC,EAAE,CAAC;QACrD,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,yBAAyB,EAAE,CAAC,CAAC;QACpD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,cAAc;QAClB,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC;QAC1B,IAAI,CAAC,KAAK;YAAE,OAAO,KAAK,CAAC;QACzB,IAAI,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,GAAG,CAAC,cAAc,CAAC,EAAE,CAAC;YACnD,MAAM,IAAI,CAAC,KAAK,CAAC,iCAAiC,EAAE,CAAC;YACrD,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,iCAAiC,EAAE,CAAC,CAAC;YAC5D,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,IAAI,CAAC,KAAK,CAAC,iCAAiC,EAAE,CAAC;QACrD,MAAM,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;QACjC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,aAAa;QACX,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,OAAO,KAAK,CAAC;QAC/B,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,mBAAmB,EAAE,CAAC,CAAC;QAC9C,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,mBAAmB,CAAC,CAAC;QACjD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,mBAAmB;QACvB,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC;QAC1B,IAAI,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,KAAK,KAAK,iBAAiB,IAAI,KAAK,CAAC,KAAK,KAAK,kBAAkB,CAAC;YAAE,OAAO,KAAK,CAAC;QACtG,IAAI,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,GAAG,CAAC,cAAc,CAAC,EAAE,CAAC;YACnD,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,iCAAiC,EAAE,CAAC,CAAC;YAC5D,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;QACjC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,WAAW,CAAC,IAAY;QACtB,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,KAAK,iBAAiB;YAAE,OAAO,KAAK,CAAC;QAC1E,MAAM,WAAW,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;QACrC,MAAM,QAAQ,GAAG,WAAW,CAAC,IAAI,KAAK,eAAe,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;QAChF,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,qBAAqB,CAAC,QAAQ,CAAC,CAAC;QAC9D,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,OAAO,GAAG,CAAC,EAAE,GAAG,EAAE,aAAa,EAAE,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,SAAkB,EAAE,CAAC,CAAC;YAC1F,IAAI,QAAQ;gBAAE,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,gBAAgB,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,SAAkB,EAAE,CAAC,CAAC;YACxG,IAAI,IAAI,CAAC,KAAK,CAAC,oBAAoB,EAAE,CAAC;gBACpC,IAAI,CAAC,KAAK,CAAC,oBAAoB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YACjD,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,GAAG,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;gBACvD,IAAI,QAAQ,EAAE,CAAC;oBACb,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,GAAG,CAAC,gBAAgB,EAAE,QAAQ,CAAC,CAAC;oBAC3D,IAAI,CAAC,KAAK,CAAC,mBAAmB,CAAC,gBAAgB,EAAE,QAAQ,CAAC,CAAC;gBAC7D,CAAC;gBACD,IAAI,CAAC,KAAK,CAAC,mBAAmB,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;gBACvD,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;YAC/B,CAAC;QACH,CAAC;QACD,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,wBAAwB,EAAE,CAAC,CAAC;QACnD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,yBAAyB,CAAC,MAAc;QAC5C,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC;QAC1B,IAAI,CAAC,KAAK;YAAE,OAAO,KAAK,CAAC;QACzB,IAAI,CAAC,oBAAoB,CAAC,uBAAuB,EAAE,MAAM,CAAC,CAAC;QAC3D,OAAO,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;IAED,KAAK,CAAC,mBAAmB;QACvB,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC;QAC1B,IAAI,CAAC,KAAK;YAAE,OAAO,KAAK,CAAC;QACzB,IAAI,CAAC,oBAAoB,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;QACjD,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,gDAAgD,CAAC,CAAC;QAC9E,OAAO,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;IAED,KAAK,CAAC,mBAAmB;QACvB,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC;QAC1B,IAAI,CAAC,KAAK;YAAE,OAAO,KAAK,CAAC;QACzB,OAAO,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;IAED,SAAS,CAAC,MAAqB;QAC7B,IAAI,CAAC,MAAM,GAAG,kBAAkB,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACtD,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,UAAU;YAAE,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAChE,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,KAAmB;QACtC,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC,CAAC;QACzC,IAAI,KAAK,CAAC,YAAY;YAAE,MAAM,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,EAAE,IAAI,EAAE,qBAAqB,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACjG,OAAO,IAAI,CAAC;IACd,CAAC;IAED,oBAAoB,CAAC,GAAW,EAAE,KAAc;QAC9C,IAAI,IAAI,CAAC,KAAK,CAAC,oBAAoB,EAAE,CAAC;YACpC,IAAI,CAAC,KAAK,CAAC,oBAAoB,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC;YAChF,OAAO;QACT,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,GAAG,CAAC,GAAU,EAAE,KAAY,CAAC,CAAC;QACzD,IAAI,CAAC,KAAK,CAAC,mBAAmB,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAC7C,CAAC;CACF"}

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

@@ -0,0 +1,124 @@
+/** The schema version of the public Term2 hook event contract. */
+export declare const TERM2_HOOK_SCHEMA_VERSION: 1;
+export type Term2HookSchemaVersion = typeof TERM2_HOOK_SCHEMA_VERSION;
+export declare const TERM2_HOOK_EVENT_NAMES: readonly ['session.start', 'session.end', 'status.change', 'turn.start', 'turn.end', 'turn.error', 'tool.before', 'tool.after', 'tool.error', 'approval.requested', 'approval.resolved'];
+export type Term2HookEventName = (typeof TERM2_HOOK_EVENT_NAMES)[number];
+export type Term2HookScope = 'root' | {
+    readonly subagent: Term2SubagentScope;
+};
+export interface Term2SubagentScope {
+    readonly agentId: string;
+    readonly role: string;
+}
+/**
+ * The fields shared by every public hook event.  IDs are opaque to hook
+ * authors; in particular, they are not provider response IDs or queue IDs.
+ */
+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 type Term2HookEventBase<Name extends Term2HookEventName = Term2HookEventName> = HookEventBase<Name>;
+export type Term2SessionMode = 'interactive' | 'non-interactive';
+export interface SessionStartHookEvent extends HookEventBase<'session.start'> {
+    readonly cwd: string;
+    readonly mode: Term2SessionMode;
+    readonly providerName: string;
+    readonly modelName: string;
+}
+export type SessionEndReason = 'normal' | 'fatal_error';
+export interface SessionEndHookEvent extends HookEventBase<'session.end'> {
+    readonly reason: SessionEndReason;
+    readonly sessionDuration: number;
+}
+export type Term2Status = 'idle' | 'working' | 'waiting_for_user' | 'waiting_for_approval';
+/** Stable, coarse reasons for a public status transition. */
+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 interface StatusChangeHookEvent extends HookEventBase<'status.change'> {
+    readonly previous: Term2Status;
+    readonly current: Term2Status;
+    readonly reason: Term2StatusChangeReason;
+}
+export type Term2TurnOrigin = 'user' | 'queued' | 'approval_continuation';
+export interface TurnStartHookEvent extends HookEventBase<'turn.start'> {
+    readonly origin: Term2TurnOrigin;
+    /** Omitted unless the user has opted into sending user text to hooks. */
+    readonly userText?: string;
+}
+export type Term2TurnTerminalKind = 'response' | 'approval_required' | 'stale' | 'failed';
+export interface TurnEndHookEvent extends HookEventBase<'turn.end'> {
+    readonly terminalKind: Term2TurnTerminalKind;
+    readonly duration: number;
+}
+export type Term2ErrorCategory = 'aborted' | 'approval_rejected' | 'authentication' | 'configuration' | 'network' | 'provider' | 'rate_limited' | 'tool' | 'unknown';
+export interface TurnErrorHookEvent extends HookEventBase<'turn.error'> {
+    readonly errorCategory: Term2ErrorCategory;
+    readonly safeMessage: string;
+    readonly recoverable: boolean;
+}
+/** Metadata describing which runtime owns a physical tool invocation. */
+export type Term2ToolOwnership = Term2HookScope;
+export interface ToolBeforeHookEvent extends HookEventBase<'tool.before'> {
+    readonly toolName: string;
+    /** Normalized, privacy-filtered arguments. */
+    readonly normalizedArguments: unknown;
+    readonly attempt: number;
+    readonly ownership: Term2ToolOwnership;
+}
+export interface ToolAfterHookEvent extends HookEventBase<'tool.after'> {
+    readonly toolName: string;
+    readonly duration: number;
+    /** A summary is used by default; full output is an opt-in setting. */
+    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 type Term2ApprovalKind = 'tool' | 'ask_user' | 'preflight' | 'other';
+export type Term2ProposedDecision = 'approve' | 'reject' | 'abort' | 'auto_approve';
+export interface ApprovalRequestedHookEvent extends HookEventBase<'approval.requested'> {
+    readonly toolName: string;
+    readonly normalizedArguments: unknown;
+    readonly approvalKind: Term2ApprovalKind;
+    readonly proposedDecision: Term2ProposedDecision;
+}
+export type Term2ApprovalResolution = 'approved' | 'rejected' | 'aborted' | 'auto_approved';
+export type Term2ApprovalResolutionSource = 'user' | 'policy' | 'system';
+export interface ApprovalResolvedHookEvent extends HookEventBase<'approval.resolved'> {
+    readonly resolution: Term2ApprovalResolution;
+    readonly source: Term2ApprovalResolutionSource;
+    readonly executionFollowed: boolean;
+}
+export interface 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 Term2HookEvent<Name extends Term2HookEventName = Term2HookEventName> = Term2HookEventMap[Name];
+export type Term2HookCallback<Name extends Term2HookEventName> = (event: Term2HookEvent<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 declare function isTerm2HookEventName(value: unknown): value is Term2HookEventName;
+export declare function isTerm2HookScope(value: unknown): value is Term2HookScope;
+export declare function isTerm2HookEvent(value: unknown): value is Term2HookEvent;
+//# sourceMappingURL=hook-contracts.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hook-contracts.d.ts","sourceRoot":"","sources":["../../../source/services/hooks/hook-contracts.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,92 @@
+/** The schema version of the public Term2 hook event contract. */
+export const TERM2_HOOK_SCHEMA_VERSION = 1;
+export const TERM2_HOOK_EVENT_NAMES = [
+    'session.start',
+    'session.end',
+    'status.change',
+    'turn.start',
+    'turn.end',
+    'turn.error',
+    'tool.before',
+    'tool.after',
+    'tool.error',
+    'approval.requested',
+    'approval.resolved',
+];
+export function isTerm2HookEventName(value) {
+    return typeof value === 'string' && TERM2_HOOK_EVENT_NAMES.includes(value);
+}
+export function isTerm2HookScope(value) {
+    if (value === 'root')
+        return true;
+    if (typeof value !== 'object' || value === null)
+        return false;
+    const subagent = value.subagent;
+    return (typeof subagent === 'object' &&
+        subagent !== null &&
+        typeof subagent.agentId === 'string' &&
+        typeof subagent.role === 'string');
+}
+export function isTerm2HookEvent(value) {
+    if (typeof value !== 'object' || value === null)
+        return false;
+    const event = value;
+    const hasString = (key) => typeof value[key] === 'string';
+    const hasFiniteNumber = (key) => {
+        const candidate = value[key];
+        return typeof candidate === 'number' && Number.isFinite(candidate);
+    };
+    const hasBoolean = (key) => typeof value[key] === 'boolean';
+    const oneOf = (key, candidates) => {
+        const candidate = value[key];
+        return typeof candidate === 'string' && candidates.includes(candidate);
+    };
+    if (!(isTerm2HookEventName(event.type) &&
+        event.schemaVersion === TERM2_HOOK_SCHEMA_VERSION &&
+        hasString('eventId') &&
+        hasString('sessionId') &&
+        hasFiniteNumber('timestamp') &&
+        isTerm2HookScope(event.scope)))
+        return false;
+    switch (event.type) {
+        case 'session.start':
+            return (hasString('cwd') &&
+                oneOf('mode', ['interactive', 'non-interactive']) &&
+                hasString('providerName') &&
+                hasString('modelName'));
+        case 'session.end':
+            return oneOf('reason', ['normal', 'fatal_error']) && hasFiniteNumber('sessionDuration');
+        case 'status.change':
+            return (oneOf('previous', ['idle', 'working', 'waiting_for_user', 'waiting_for_approval']) &&
+                oneOf('current', ['idle', 'working', 'waiting_for_user', 'waiting_for_approval']) &&
+                hasString('reason'));
+        case 'turn.start':
+            return oneOf('origin', ['user', 'queued', 'approval_continuation']);
+        case 'turn.end':
+            return oneOf('terminalKind', ['response', 'approval_required', 'stale', 'failed']) && hasFiniteNumber('duration');
+        case 'turn.error':
+            return hasString('errorCategory') && hasString('safeMessage') && hasBoolean('recoverable');
+        case 'tool.before':
+            return (hasString('toolName') &&
+                hasFiniteNumber('attempt') &&
+                isTerm2HookScope(value.ownership));
+        case 'tool.after':
+            return hasString('toolName') && hasFiniteNumber('duration');
+        case 'tool.error':
+            return (hasString('toolName') &&
+                hasFiniteNumber('duration') &&
+                hasString('errorCategory') &&
+                hasString('safeMessage') &&
+                hasBoolean('convertedToModelResult'));
+        case 'approval.requested':
+            return (hasString('toolName') &&
+                oneOf('approvalKind', ['tool', 'ask_user', 'preflight', 'other']) &&
+                oneOf('proposedDecision', ['approve', 'reject', 'abort', 'auto_approve']));
+        case 'approval.resolved':
+            return (oneOf('resolution', ['approved', 'rejected', 'aborted', 'auto_approved']) &&
+                oneOf('source', ['user', 'policy', 'system']) &&
+                hasBoolean('executionFollowed'));
+    }
+    return false;
+}
+//# sourceMappingURL=hook-contracts.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hook-contracts.js","sourceRoot":"","sources":["../../../source/services/hooks/hook-contracts.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAU,CAAC;AAIpD,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,eAAe;IACf,aAAa;IACb,eAAe;IACf,YAAY;IACZ,UAAU;IACV,YAAY;IACZ,aAAa;IACb,YAAY;IACZ,YAAY;IACZ,oBAAoB;IACpB,mBAAmB;CACX,CAAC;AA6KX,MAAM,UAAU,oBAAoB,CAAC,KAAc;IACjD,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAK,sBAA4C,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AACpG,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,IAAI,KAAK,KAAK,MAAM;QAAE,OAAO,IAAI,CAAC;IAClC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC9D,MAAM,QAAQ,GAAI,KAAgC,CAAC,QAAQ,CAAC;IAC5D,OAAO,CACL,OAAO,QAAQ,KAAK,QAAQ;QAC5B,QAAQ,KAAK,IAAI;QACjB,OAAQ,QAAkC,CAAC,OAAO,KAAK,QAAQ;QAC/D,OAAQ,QAA+B,CAAC,IAAI,KAAK,QAAQ,CAC1D,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC9D,MAAM,KAAK,GAAG,KAA+B,CAAC;IAC9C,MAAM,SAAS,GAAG,CAAC,GAAW,EAAW,EAAE,CAAC,OAAQ,KAAiC,CAAC,GAAG,CAAC,KAAK,QAAQ,CAAC;IACxG,MAAM,eAAe,GAAG,CAAC,GAAW,EAAW,EAAE;QAC/C,MAAM,SAAS,GAAI,KAAiC,CAAC,GAAG,CAAC,CAAC;QAC1D,OAAO,OAAO,SAAS,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;IACrE,CAAC,CAAC;IACF,MAAM,UAAU,GAAG,CAAC,GAAW,EAAW,EAAE,CAAC,OAAQ,KAAiC,CAAC,GAAG,CAAC,KAAK,SAAS,CAAC;IAC1G,MAAM,KAAK,GAAG,CAAC,GAAW,EAAE,UAA6B,EAAW,EAAE;QACpE,MAAM,SAAS,GAAI,KAAiC,CAAC,GAAG,CAAC,CAAC;QAC1D,OAAO,OAAO,SAAS,KAAK,QAAQ,IAAI,UAAU,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;IACzE,CAAC,CAAC;IAEF,IACE,CAAC,CACC,oBAAoB,CAAC,KAAK,CAAC,IAAI,CAAC;QAChC,KAAK,CAAC,aAAa,KAAK,yBAAyB;QACjD,SAAS,CAAC,SAAS,CAAC;QACpB,SAAS,CAAC,WAAW,CAAC;QACtB,eAAe,CAAC,WAAW,CAAC;QAC5B,gBAAgB,CAAC,KAAK,CAAC,KAAK,CAAC,CAC9B;QAED,OAAO,KAAK,CAAC;IAEf,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;QACnB,KAAK,eAAe;YAClB,OAAO,CACL,SAAS,CAAC,KAAK,CAAC;gBAChB,KAAK,CAAC,MAAM,EAAE,CAAC,aAAa,EAAE,iBAAiB,CAAC,CAAC;gBACjD,SAAS,CAAC,cAAc,CAAC;gBACzB,SAAS,CAAC,WAAW,CAAC,CACvB,CAAC;QACJ,KAAK,aAAa;YAChB,OAAO,KAAK,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC,IAAI,eAAe,CAAC,iBAAiB,CAAC,CAAC;QAC1F,KAAK,eAAe;YAClB,OAAO,CACL,KAAK,CAAC,UAAU,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,kBAAkB,EAAE,sBAAsB,CAAC,CAAC;gBAClF,KAAK,CAAC,SAAS,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,kBAAkB,EAAE,sBAAsB,CAAC,CAAC;gBACjF,SAAS,CAAC,QAAQ,CAAC,CACpB,CAAC;QACJ,KAAK,YAAY;YACf,OAAO,KAAK,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,uBAAuB,CAAC,CAAC,CAAC;QACtE,KAAK,UAAU;YACb,OAAO,KAAK,CAAC,cAAc,EAAE,CAAC,UAAU,EAAE,mBAAmB,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,IAAI,eAAe,CAAC,UAAU,CAAC,CAAC;QACpH,KAAK,YAAY;YACf,OAAO,SAAS,CAAC,eAAe,CAAC,IAAI,SAAS,CAAC,aAAa,CAAC,IAAI,UAAU,CAAC,aAAa,CAAC,CAAC;QAC7F,KAAK,aAAa;YAChB,OAAO,CACL,SAAS,CAAC,UAAU,CAAC;gBACrB,eAAe,CAAC,SAAS,CAAC;gBAC1B,gBAAgB,CAAE,KAAiC,CAAC,SAAS,CAAC,CAC/D,CAAC;QACJ,KAAK,YAAY;YACf,OAAO,SAAS,CAAC,UAAU,CAAC,IAAI,eAAe,CAAC,UAAU,CAAC,CAAC;QAC9D,KAAK,YAAY;YACf,OAAO,CACL,SAAS,CAAC,UAAU,CAAC;gBACrB,eAAe,CAAC,UAAU,CAAC;gBAC3B,SAAS,CAAC,eAAe,CAAC;gBAC1B,SAAS,CAAC,aAAa,CAAC;gBACxB,UAAU,CAAC,wBAAwB,CAAC,CACrC,CAAC;QACJ,KAAK,oBAAoB;YACvB,OAAO,CACL,SAAS,CAAC,UAAU,CAAC;gBACrB,KAAK,CAAC,cAAc,EAAE,CAAC,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC;gBACjE,KAAK,CAAC,kBAAkB,EAAE,CAAC,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE,cAAc,CAAC,CAAC,CAC1E,CAAC;QACJ,KAAK,mBAAmB;YACtB,OAAO,CACL,KAAK,CAAC,YAAY,EAAE,CAAC,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,eAAe,CAAC,CAAC;gBACzE,KAAK,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;gBAC7C,UAAU,CAAC,mBAAmB,CAAC,CAChC,CAAC;IACN,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

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

@@ -0,0 +1,45 @@
+import type { Dirent, Stats } from 'node:fs';
+import type { HookDiagnostic } from './hook-registry.js';
+export type HookFileScope = 'user' | 'project';
+export interface DiscoveredHookFile {
+    readonly path: string;
+    readonly scope: HookFileScope;
+    readonly root: string;
+}
+export interface HookDiscoveryResult {
+    readonly files: readonly DiscoveredHookFile[];
+    readonly userRoot?: string;
+    readonly projectRoot?: string;
+    readonly diagnostics: readonly HookDiagnostic[];
+}
+export interface HookDiscoveryFileSystem {
+    readonly lstat: (path: string) => Promise<Pick<Stats, 'isDirectory' | 'isFile' | 'isSymbolicLink'>>;
+    readonly realpath: (path: string) => Promise<string>;
+    readonly readdir: (path: string, options: {
+        readonly withFileTypes: true;
+    }) => Promise<readonly Pick<Dirent, 'name' | 'isFile' | 'isDirectory' | 'isSymbolicLink'>[]>;
+}
+export interface HookDiscoveryOptions {
+    /** The process cwd is used when omitted. */
+    readonly cwd?: string;
+    /** os.homedir() is used when omitted. */
+    readonly homeDir?: string;
+    readonly userEnabled?: boolean;
+    readonly projectEnabled?: boolean;
+    /** Canonical project roots trusted to execute project hooks. */
+    readonly trustedProjectRoots?: readonly string[];
+    readonly fileSystem?: HookDiscoveryFileSystem;
+}
+/**
+ * Finds executable hook files without following symlinks. Discovery is kept
+ * independent from SettingsService so its trust and executable-code policy is
+ * not accidentally inherited by another kind of user-authored file.
+ */
+export declare class HookDiscovery {
+    #private;
+    constructor(options?: HookDiscoveryOptions);
+    discover(): Promise<HookDiscoveryResult>;
+}
+export declare function discoverHookFiles(options?: HookDiscoveryOptions): Promise<HookDiscoveryResult>;
+export declare const discoverHooks: typeof discoverHookFiles;
+//# sourceMappingURL=hook-discovery.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hook-discovery.d.ts","sourceRoot":"","sources":["../../../source/services/hooks/hook-discovery.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAI7C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,SAAS,CAAC;AAE/C,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,KAAK,EAAE,SAAS,kBAAkB,EAAE,CAAC;IAC9C,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,SAAS,cAAc,EAAE,CAAC;CACjD;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,aAAa,GAAG,QAAQ,GAAG,gBAAgB,CAAC,CAAC,CAAC;IACpG,QAAQ,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACrD,QAAQ,CAAC,OAAO,EAAE,CAChB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE;QAAE,QAAQ,CAAC,aAAa,EAAE,IAAI,CAAA;KAAE,KACtC,OAAO,CAAC,SAAS,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,GAAG,aAAa,GAAG,gBAAgB,CAAC,EAAE,CAAC,CAAC;CAC7F;AAQD,MAAM,WAAW,oBAAoB;IACnC,4CAA4C;IAC5C,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,yCAAyC;IACzC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;IAClC,gEAAgE;IAChE,QAAQ,CAAC,mBAAmB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACjD,QAAQ,CAAC,UAAU,CAAC,EAAE,uBAAuB,CAAC;CAC/C;AA0BD;;;;GAIG;AACH,qBAAa,aAAa;;IAIxB,YAAY,OAAO,GAAE,oBAAyB,EAG7C;IAEK,QAAQ,IAAI,OAAO,CAAC,mBAAmB,CAAC,CA4C7C;CAwKF;AAED,wBAAsB,iBAAiB,CAAC,OAAO,GAAE,oBAAyB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAExG;AAED,eAAO,MAAM,aAAa,0BAAoB,CAAC"}