@dollhousemcp/mcp-server 2.0.29 → 2.0.31

package/dist/utils/permissionHookShared.d.ts

@@ -0,0 +1,165 @@
+export interface PermissionHookMarker {
+    host: string;
+    scriptPath: string;
+    settingsPath?: string;
+    additionalPaths?: string[];
+    configured?: boolean;
+    assetsPrepared?: boolean;
+    installedAt: string;
+}
+export interface PermissionHookStatus {
+    installed: boolean;
+    configured?: boolean;
+    assetsPrepared?: boolean;
+    assetsCurrent?: boolean;
+    autoRepaired?: boolean;
+    needsRepair?: boolean;
+    repairError?: string;
+    host?: string;
+    scriptPath?: string;
+    settingsPath?: string;
+    additionalPaths?: string[];
+}
+/** Latest JSONL diagnostic event emitted by a local permission hook wrapper. */
+export interface PermissionHookDiagnosticRecord {
+    timestamp: string;
+    invocationId: string;
+    event: string;
+    platform: string;
+    stage: string;
+    outcome?: string;
+    reason?: string;
+    hookPath?: string;
+    diagnosticsLogPath?: string;
+    sessionId?: string;
+    toolName?: string;
+    toolInput?: string;
+    rawInput?: string;
+    authorityHost?: string;
+    authorityMode?: string;
+    endpoint?: string;
+    port?: string;
+    payload?: string;
+    response?: string;
+    normalizedResponse?: string;
+    emittedResponse?: string;
+    attempt?: string;
+    maxRetries?: string;
+    timeoutSeconds?: string;
+    curlExit?: string;
+    rawInputLength?: number;
+    normalizedResponseLength?: number;
+    emittedResponseLength?: number;
+    responseLength?: number;
+}
+export interface InstallPermissionHookResult {
+    supported: boolean;
+    installed: boolean;
+    configured: boolean;
+    assetsPrepared?: boolean;
+    host: string;
+    scriptPath?: string;
+    settingsPath?: string;
+    additionalPaths?: string[];
+    markerPath?: string;
+    backupPath?: string;
+    message: string;
+}
+export interface InstallPermissionHookOptions {
+    homeDir?: string;
+    sourceScriptPath?: string;
+    now?: Date;
+}
+export interface ReconcilePermissionHookOptions {
+    homeDir?: string;
+    sourceScriptPath?: string;
+    autoRepair?: boolean;
+}
+/** Aggregate health and repair state for all managed local hook hosts. */
+export interface PermissionHookAuditSummary {
+    installedHosts: string[];
+    currentHosts: string[];
+    repairedHosts: string[];
+    needsRepairHosts: string[];
+    diagnosticsPath: string;
+    lastDiagnostic: PermissionHookDiagnosticRecord | null;
+    lastStartupRepair: PermissionHookStartupRepairSummary | null;
+}
+/** Condensed health view surfaced in setup, permissions, and build info. */
+export interface PermissionHookHealthSummary {
+    status: 'ok' | 'warning' | 'error';
+    message: string;
+    repairedCount: number;
+    needsRepairCount: number;
+    lastCheckedAt?: string;
+}
+export interface PermissionHookStartupRepairHostResult extends PermissionHookStatus {
+    host: string;
+    outcome: 'current' | 'repaired' | 'needs_repair' | 'not_installed' | 'error';
+}
+/** Result summary for the most recent startup-time hook asset repair pass. */
+export interface PermissionHookStartupRepairSummary {
+    startedAt: string;
+    completedAt: string;
+    durationMs: number;
+    repairedCount: number;
+    needsRepairCount: number;
+    hostResults: PermissionHookStartupRepairHostResult[];
+}
+export interface HookAssetDescriptor {
+    kind: 'bridge' | 'port-helper' | 'config-helper' | 'wrapper';
+    sourcePath: string;
+    targetPath: string;
+}
+export interface HookAssetAuditResult {
+    assetsPrepared: boolean;
+    assetsCurrent: boolean;
+    staleAssets: HookAssetDescriptor[];
+}
+export declare const MANAGED_HOOK_WRAPPER_BASENAMES: {
+    readonly vscode: "pretooluse-vscode.sh";
+    readonly cursor: "pretooluse-cursor.sh";
+    readonly windsurf: "pretooluse-windsurf.sh";
+    readonly 'gemini-cli': "pretooluse-gemini.sh";
+    readonly codex: "pretooluse-codex.sh";
+};
+export declare const WRAPPER_HOOK_HOSTS: Array<keyof typeof MANAGED_HOOK_WRAPPER_BASENAMES>;
+export declare const AUTO_REPAIRABLE_HOOK_HOSTS: readonly ["claude-code", ...("cursor" | "vscode" | "windsurf" | "gemini-cli" | "codex")[]];
+export declare function isMissingFileError(error: unknown): boolean;
+export declare function detectIndent(raw: string): number | string;
+export declare function getPermissionHookScriptPath(homeDir?: string): string;
+export declare function getPermissionHookDiagnosticsPath(homeDir?: string): string;
+export declare function normalizeHookHost(host: string): string;
+export declare function readHostSpecificHookStatus(homeDir: string, host: string): PermissionHookStatus;
+export declare function collectHookMarkerPaths(homeDir: string): Set<string>;
+export declare function collectHookMarkerPathsAsync(homeDir: string): Promise<Set<string>>;
+export declare function summarizeMarkerStatuses(markerPaths: Iterable<string>): PermissionHookStatus;
+export declare function getHookWrapperBasename(host: string): string | null;
+export declare function getHookWrapperPath(host: string, homeDir?: string): string | null;
+export declare function getHookSourcePath(host: string): string;
+export declare function supportsManagedHookAssets(host: string): boolean;
+export declare function getPrimaryHookScriptPath(host: string, homeDir?: string): string;
+export declare function readLastPermissionHookDiagnostic(homeDir?: string): Promise<PermissionHookDiagnosticRecord | null>;
+export declare function getManagedHookAssets(host: string, homeDir?: string, sourceScriptPath?: string): HookAssetDescriptor[];
+export declare function auditHookAssets(host: string, homeDir?: string, sourceScriptPath?: string): Promise<HookAssetAuditResult>;
+export declare function getPermissionHookMarkerPath(homeDir?: string, host?: string): string;
+export declare function getClaudeHookSettingsPath(homeDir?: string): string;
+export declare function getVsCodeHookSettingsPath(homeDir?: string): string;
+export declare function getVsCodeUserSettingsPath(homeDir?: string): string;
+export declare function getGeminiHookSettingsPath(homeDir?: string): string;
+export declare function getCursorHookSettingsPath(homeDir?: string): string;
+export declare function getWindsurfHookSettingsPath(homeDir?: string): string;
+export declare function getCodexHookSettingsPath(homeDir?: string): string;
+export declare function getCodexConfigPath(homeDir?: string): string;
+export declare function normalizeHooksRoot(parsed: Record<string, unknown>): Record<string, unknown[]>;
+export declare function ensureCommandHook(parsed: Record<string, unknown>, eventName: string, command: string, matcher: string, extraHookFields?: Record<string, unknown>): {
+    changed: boolean;
+    parsed: Record<string, unknown>;
+};
+export declare function readOptionalUtf8(filePath: string, fallback: string): Promise<string>;
+export declare function writeBackupIfPresent(filePath: string, raw: string): Promise<string | undefined>;
+export declare function writeHookMarker(homeDir: string, marker: PermissionHookMarker): Promise<string>;
+export declare function installHookAssetsForHost(client: string, homeDir: string, sourceScriptPath?: string): Promise<{
+    scriptPath: string;
+}>;
+//# sourceMappingURL=permissionHookShared.d.ts.map

package/dist/utils/permissionHookShared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"permissionHookShared.d.ts","sourceRoot":"","sources":["../../src/utils/permissionHookShared.ts"],"names":[],"mappings":"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"}