@qduc/term2 0.11.1 → 0.13.0

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

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