nterminal 1.3.3 → 1.3.5

package/dist/server/hooks/hookInstallation.d.ts

@@ -0,0 +1,79 @@
+export type HookProvider = 'codex' | 'claude';
+export interface ProviderHookInstallation {
+    provider: HookProvider;
+    installed: boolean;
+    configPath: string;
+    notifyConfigPath?: string;
+    approvalRequired: boolean | null;
+    reason?: string;
+    /** Offending path for `unsafe_path`; never file contents. */
+    unsafePath?: string;
+    /** Non-fatal, bounded reason codes that can explain why installed hooks may not run. */
+    warnings?: string[];
+}
+export interface HookInstallationOptions {
+    stateDir: string;
+    homeDir?: string;
+    /** Explicit effective provider homes, including values loaded from a runtime env file. */
+    providerHomes?: Partial<Record<HookProvider, string>>;
+    /** Resolve relative homes/state paths against the runtime's working directory. */
+    baseDir?: string;
+    /** Procfs identity source; isolated tests provide a synthetic tree. */
+    procRoot?: string;
+    /** Optional stable host identity source; unavailable IDs restrict recovery to this boot. */
+    machineIdPath?: string;
+    previewMode?: boolean;
+    /** Path to the packaged standalone helper, not JavaScript source text. */
+    helperSource?: string;
+    nodeExecutable?: string;
+    /** Read-only managed policy locations; isolated tests provide synthetic directories. */
+    codexSystemDir?: string;
+    claudeManagedDir?: string;
+}
+export interface ManagedHelperRefresh {
+    updated: boolean;
+    reason?: string;
+}
+export declare class HookInstallation {
+    private readonly options;
+    private hooksDir;
+    private readonly lexicalHooksDir;
+    private helperPath;
+    private helperOwnershipPath;
+    private helperJournal;
+    private endpointPath;
+    private readonly nodeExecutable;
+    private readonly homes;
+    private resolved;
+    constructor(options: HookInstallationOptions);
+    /**
+     * Resolve symlinks once per operation. The receiver authenticates the helper
+     * by comparing its argv with realpath(stateDir)/hooks, so commands must use the
+     * resolved path. Provider homes may be user-owned symlinks (dotfiles); all I/O
+     * then targets the resolved path, which has no symlink components left.
+     */
+    private prepare;
+    status(provider: HookProvider): Promise<ProviderHookInstallation>;
+    install(provider: HookProvider): Promise<ProviderHookInstallation>;
+    remove(provider: HookProvider): Promise<ProviderHookInstallation>;
+    refreshManagedHelper(): Promise<ManagedHelperRefresh>;
+    private helperReferenced;
+    private displayPaths;
+    private context;
+    private result;
+    /** Current definitions: guarded POSIX command, async where the response is unused. */
+    private entries;
+    private argv;
+    /** Every definition shape an earlier NTerminal version could have written for this node. */
+    private generations;
+    /** Exact argv arrays of NTerminal's own legacy notify commands recorded in this manifest. */
+    private ownedNotify;
+    /** Root `notify = [...]` whose decoded argv exactly equals an owned legacy command, however Codex reformatted it. */
+    private isOwnedNotify;
+    private referencesHelper;
+    private manifest;
+    /** Cheap, read-only policy checks. Unknown managed state is a warning, never an install blocker. */
+    private codexPolicy;
+    private claudePolicy;
+    private change;
+}