@qduc/term2 0.11.0 → 0.12.0

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":"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"}

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":"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"}

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"}

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

@@ -0,0 +1,255 @@
+import { lstat as fsLstat, readdir as fsReaddir, realpath as fsRealpath } from 'node:fs/promises';
+import { homedir } from 'node:os';
+import { dirname, extname, join, resolve, sep } from 'node:path';
+const DEFAULT_FILE_SYSTEM = {
+    lstat: async (path) => fsLstat(path),
+    realpath: async (path) => fsRealpath(path),
+    readdir: async (path, options) => fsReaddir(path, options),
+};
+const HOOK_EXTENSIONS = new Set(['.js', '.mjs', '.ts']);
+function isHookFileName(name) {
+    return !name.endsWith('.d.ts') && HOOK_EXTENSIONS.has(extname(name));
+}
+function errorCode(error) {
+    if (typeof error !== 'object' || error === null)
+        return undefined;
+    const code = error.code;
+    return typeof code === 'string' ? code : undefined;
+}
+function isMissing(error) {
+    return errorCode(error) === 'ENOENT' || errorCode(error) === 'ENOTDIR';
+}
+function lexicalCompare(left, right) {
+    return left < right ? -1 : left > right ? 1 : 0;
+}
+function isWithin(root, candidate) {
+    return candidate === root || candidate.startsWith(root.endsWith(sep) ? root : `${root}${sep}`);
+}
+/**
+ * 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 class HookDiscovery {
+    #options;
+    #fs;
+    constructor(options = {}) {
+        this.#options = options;
+        this.#fs = options.fileSystem ?? DEFAULT_FILE_SYSTEM;
+    }
+    async discover() {
+        const files = [];
+        const diagnostics = [];
+        const seen = new Set();
+        let userRoot;
+        let projectRoot;
+        if (this.#options.userEnabled !== false) {
+            const userBase = await this.#canonicalBase(this.#options.homeDir ?? homedir(), 'user', diagnostics);
+            if (userBase) {
+                userRoot = join(userBase, '.term2', 'hooks');
+                await this.#scanRoot(userRoot, 'user', files, diagnostics, seen);
+            }
+        }
+        else {
+            diagnostics.push({
+                code: 'hook_disabled',
+                message: 'User hooks are disabled',
+                source: { scope: 'user' },
+            });
+        }
+        if (this.#options.projectEnabled !== false) {
+            const projectBase = await this.#canonicalBase(this.#options.cwd ?? process.cwd(), 'project', diagnostics);
+            if (projectBase) {
+                projectRoot = join(projectBase, '.term2', 'hooks');
+                if (await this.#isTrustedProject(projectBase)) {
+                    await this.#scanRoot(projectRoot, 'project', files, diagnostics, seen);
+                }
+                else {
+                    diagnostics.push({
+                        code: 'project_hooks_untrusted',
+                        message: 'Project hooks were skipped because the canonical project root is not trusted',
+                        source: { path: projectBase, scope: 'project' },
+                    });
+                }
+            }
+        }
+        else {
+            diagnostics.push({
+                code: 'hook_disabled',
+                message: 'Project hooks are disabled',
+                source: { scope: 'project' },
+            });
+        }
+        return { files, userRoot, projectRoot, diagnostics };
+    }
+    #canonicalBase(candidate, scope, diagnostics) {
+        return this.#canonicalBaseAsync(candidate, scope, diagnostics);
+    }
+    async #canonicalBaseAsync(candidate, scope, diagnostics) {
+        const resolved = resolve(candidate);
+        try {
+            const stats = await this.#fs.lstat(resolved);
+            if (stats.isSymbolicLink()) {
+                diagnostics.push({
+                    code: 'symlink_rejected',
+                    message: 'Hook base directory symlinks are rejected',
+                    source: { path: resolved, scope },
+                });
+                return undefined;
+            }
+            if (!stats.isDirectory()) {
+                diagnostics.push({
+                    code: 'discovery_failed',
+                    message: 'Hook base path is not a directory',
+                    source: { path: resolved, scope },
+                });
+                return undefined;
+            }
+            return await this.#fs.realpath(resolved);
+        }
+        catch (error) {
+            if (isMissing(error))
+                return undefined;
+            diagnostics.push({
+                code: 'discovery_failed',
+                message: 'Could not canonicalize hook base directory',
+                source: { path: resolved, scope },
+                error,
+            });
+            return undefined;
+        }
+    }
+    async #isTrustedProject(canonicalProjectRoot) {
+        const roots = this.#options.trustedProjectRoots ?? [];
+        for (const root of roots) {
+            const resolved = resolve(root);
+            try {
+                if ((await this.#fs.realpath(resolved)) === canonicalProjectRoot)
+                    return true;
+            }
+            catch (error) {
+                if (!isMissing(error))
+                    continue;
+                // A missing persisted trust entry cannot match an existing canonical
+                // cwd, but retaining this comparison makes injected filesystems with
+                // virtual paths behave predictably.
+                if (resolved === canonicalProjectRoot)
+                    return true;
+            }
+        }
+        return false;
+    }
+    async #scanRoot(root, scope, files, diagnostics, seen) {
+        try {
+            const parentStats = await this.#fs.lstat(dirname(root));
+            if (parentStats.isSymbolicLink()) {
+                diagnostics.push({
+                    code: 'symlink_rejected',
+                    message: 'Hook directory ancestors are rejected when symlinked',
+                    source: { path: dirname(root), scope },
+                });
+                return;
+            }
+            const rootStats = await this.#fs.lstat(root);
+            if (rootStats.isSymbolicLink()) {
+                diagnostics.push({
+                    code: 'symlink_rejected',
+                    message: 'Hook directory symlinks are rejected',
+                    source: { path: root, scope },
+                });
+                return;
+            }
+            if (!rootStats.isDirectory()) {
+                diagnostics.push({
+                    code: 'discovery_failed',
+                    message: 'Hook path is not a directory',
+                    source: { path: root, scope },
+                });
+                return;
+            }
+        }
+        catch (error) {
+            if (isMissing(error))
+                return;
+            diagnostics.push({
+                code: 'discovery_failed',
+                message: 'Could not inspect hook directory',
+                source: { path: root, scope },
+                error,
+            });
+            return;
+        }
+        let entries;
+        try {
+            entries = await this.#fs.readdir(root, { withFileTypes: true });
+        }
+        catch (error) {
+            if (isMissing(error))
+                return;
+            diagnostics.push({
+                code: 'discovery_failed',
+                message: 'Could not scan hook directory',
+                source: { path: root, scope },
+                error,
+            });
+            return;
+        }
+        const sortedEntries = [...entries].sort((left, right) => lexicalCompare(left.name, right.name));
+        for (const entry of sortedEntries) {
+            const candidate = join(root, entry.name);
+            if (entry.isSymbolicLink()) {
+                diagnostics.push({
+                    code: 'symlink_rejected',
+                    message: 'Symlinked hook files are rejected',
+                    source: { path: candidate, scope },
+                });
+                continue;
+            }
+            if (!entry.isFile() || !isHookFileName(entry.name))
+                continue;
+            try {
+                // Re-check with lstat after readdir to avoid following a replacement
+                // symlink if a hook directory changes during discovery.
+                const stats = await this.#fs.lstat(candidate);
+                if (stats.isSymbolicLink()) {
+                    diagnostics.push({
+                        code: 'symlink_rejected',
+                        message: 'Symlinked hook files are rejected',
+                        source: { path: candidate, scope },
+                    });
+                    continue;
+                }
+                if (!stats.isFile())
+                    continue;
+                const canonical = await this.#fs.realpath(candidate);
+                if (!isWithin(root, canonical)) {
+                    diagnostics.push({
+                        code: 'symlink_rejected',
+                        message: 'Hook path resolved outside its canonical hook directory',
+                        source: { path: candidate, scope },
+                    });
+                    continue;
+                }
+                if (seen.has(canonical))
+                    continue;
+                seen.add(canonical);
+                files.push({ path: canonical, scope, root });
+            }
+            catch (error) {
+                if (isMissing(error))
+                    continue;
+                diagnostics.push({
+                    code: 'discovery_failed',
+                    message: 'Could not inspect hook file',
+                    source: { path: candidate, scope },
+                    error,
+                });
+            }
+        }
+    }
+}
+export async function discoverHookFiles(options = {}) {
+    return new HookDiscovery(options).discover();
+}
+export const discoverHooks = discoverHookFiles;
+//# sourceMappingURL=hook-discovery.js.map

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

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

package/dist/services/hooks/hook-editor-shim.d.ts

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

package/dist/services/hooks/hook-editor-shim.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-editor-shim.d.ts","sourceRoot":"","sources":["../../../source/services/hooks/hook-editor-shim.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,8BAA8B,qBAAqB,CAAC;AACjE,eAAO,MAAM,sBAAsB,kBAAkB,CAAC;AAEtD,eAAO,MAAM,6BAA6B,6gLA+JzC,CAAC;AAEF,eAAO,MAAM,qBAAqB,QAiBjC,CAAC;AAEF,wBAAsB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAS1E"}