agent-dir 0.3.0 → 0.4.0

package/dist/src/telemetry/privacy.js

@@ -14,6 +14,17 @@ const SAFE_TOOL_NAME = /^[a-z][a-z0-9_]*$/;
 const SAFE_COMMAND_FAMILY = /^[a-z][a-z0-9_-]*$/;
 const SAFE_OPERATION = /^[a-z][a-z0-9_.-]*$/;
 export function sanitizeAnonymousEvent(event) {
+    if (event.event === "http_request") {
+        return {
+            event: "http_request",
+            method: sanitizeMcpMethod(event.method),
+            route: event.route,
+            status: boundedInteger(event.status),
+            success: event.success === true,
+            durationMs: boundedNumber(event.durationMs),
+            authenticated: event.authenticated === true,
+        };
+    }
     if (event.event === "mcp_request") {
         return {
             event: "mcp_request",
@@ -42,6 +53,18 @@ export function sanitizeAnonymousEvent(event) {
                 : { errorCategory: sanitizeErrorCategory(event.errorCategory) }),
         };
     }
+    if (event.event === "tunnel") {
+        return {
+            event: "tunnel",
+            state: event.state,
+            ...(event.attempt === undefined ? {} : { attempt: boundedInteger(event.attempt) }),
+            ...(event.attempts === undefined ? {} : { attempts: boundedInteger(event.attempts) }),
+            ...(event.durationMs === undefined ? {} : { durationMs: boundedNumber(event.durationMs) }),
+            ...(event.reasonCategory === undefined
+                ? {}
+                : { reasonCategory: sanitizeErrorCategory(event.reasonCategory) }),
+        };
+    }
     if (event.event === "command_call") {
         return {
             event: "command_call",
@@ -76,15 +99,45 @@ export function createTelemetryEnvelope(level, event, runtime, project, configId
         level,
         event: sanitizeAnonymousEvent(event),
     };
-    if (level === "basic" || level === "detailed") {
+    if (level === "basic" || level === "detailed" || level === "diagnostic") {
         if (runtime)
             envelope.runtime = sanitizeRuntimeContext(runtime);
     }
-    if (level === "detailed" && project) {
+    if ((level === "detailed" || level === "diagnostic") && project) {
         envelope.project = sanitizeProjectContext(project);
     }
+    if (level === "diagnostic" && runtime) {
+        envelope.runtime = sanitizeDiagnosticRuntimeContext(runtime);
+    }
+    if (level === "diagnostic" && project) {
+        envelope.project = sanitizeDiagnosticProjectContext(project);
+    }
     return envelope;
 }
+function sanitizeDiagnosticRuntimeContext(context) {
+    return {
+        ...sanitizeRuntimeContext(context),
+        ...(context.nodeVersion === undefined
+            ? {}
+            : { nodeVersion: sanitizeVersion(context.nodeVersion) }),
+        ...(context.hostname === undefined
+            ? {}
+            : { hostname: sanitizeSensitiveIdentifier(context.hostname) }),
+        ...(context.username === undefined
+            ? {}
+            : { username: sanitizeSensitiveIdentifier(context.username) }),
+        ...(context.processId === undefined ? {} : { processId: boundedInteger(context.processId) }),
+        ...(context.parentProcessId === undefined
+            ? {}
+            : { parentProcessId: boundedInteger(context.parentProcessId) }),
+        ...(context.processUptimeMs === undefined
+            ? {}
+            : { processUptimeMs: boundedNumber(context.processUptimeMs) }),
+        ...(context.memoryRssBytes === undefined
+            ? {}
+            : { memoryRssBytes: boundedNumber(context.memoryRssBytes) }),
+    };
+}
 function sanitizeRuntimeContext(context) {
     return {
         agentDirVersion: sanitizeVersion(context.agentDirVersion),
@@ -99,6 +152,17 @@ function sanitizeRuntimeContext(context) {
             : { mcpClientVersion: sanitizeVersion(context.mcpClientVersion) }),
     };
 }
+function sanitizeDiagnosticProjectContext(context) {
+    return {
+        ...sanitizeProjectContext(context),
+        ...(context.projectRoot === undefined
+            ? {}
+            : { projectRoot: sanitizeLocalPath(context.projectRoot) }),
+        ...(context.workingDirectory === undefined
+            ? {}
+            : { workingDirectory: sanitizeLocalPath(context.workingDirectory) }),
+    };
+}
 function sanitizeProjectContext(context) {
     return {
         ...(context.language ? { language: context.language } : {}),
@@ -117,6 +181,16 @@ function sanitizeIdentifier(value, pattern) {
     const normalized = value.trim().toLowerCase();
     return pattern.test(normalized) ? normalized : "unknown";
 }
+function sanitizeSensitiveIdentifier(value) {
+    const normalized = value.trim().slice(0, 128);
+    return /^[a-z0-9][a-z0-9 ._@-]*$/i.test(normalized) ? normalized : "unknown";
+}
+function sanitizeLocalPath(value) {
+    const normalized = value.trim().slice(0, 2048);
+    return normalized.startsWith("/") || /^[A-Za-z]:[\\\\/]/.test(normalized)
+        ? normalized
+        : "unknown";
+}
 function sanitizeFreeIdentifier(value) {
     const normalized = value.trim().slice(0, 64);
     return /^[a-z0-9][a-z0-9 ._-]*$/i.test(normalized) ? normalized : "unknown";
@@ -142,4 +216,3 @@ function boundedInteger(value) {
 function optionalNumber(key, value) {
     return value === undefined ? {} : { [key]: boundedNumber(value) };
 }
-//# sourceMappingURL=privacy.js.map

package/dist/src/telemetry/recorder.d.ts

@@ -27,4 +27,3 @@ export declare class TelemetryRecorder {
     private loadPersisted;
     private persistEvent;
 }
-//# sourceMappingURL=recorder.d.ts.map

package/dist/src/telemetry/recorder.js

@@ -95,4 +95,3 @@ export class TelemetryRecorder {
         }
     }
 }
-//# sourceMappingURL=recorder.js.map

package/dist/src/telemetry/types.d.ts

@@ -1,4 +1,4 @@
-export declare const TELEMETRY_LEVELS: readonly ["none", "anonymous", "basic", "detailed"];
+export declare const TELEMETRY_LEVELS: readonly ["none", "anonymous", "basic", "detailed", "diagnostic"];
 export type TelemetryLevel = (typeof TELEMETRY_LEVELS)[number];
 export interface TelemetryConfig {
     level: TelemetryLevel;
@@ -6,6 +6,15 @@ export interface TelemetryConfig {
     persist?: boolean;
     sessionId?: string;
 }
+export interface TelemetryHttpRequestEvent {
+    event: "http_request";
+    method: string;
+    route: "mcp" | "tree" | "root" | "file" | "other";
+    status: number;
+    success: boolean;
+    durationMs: number;
+    authenticated: boolean;
+}
 export interface TelemetryMcpRequestEvent {
     event: "mcp_request";
     method: string;
@@ -35,6 +44,14 @@ export interface TelemetryCommandEvent {
     outputBytes?: number;
     errorCategory?: string;
 }
+export interface TelemetryTunnelEvent {
+    event: "tunnel";
+    state: "online" | "disconnected" | "reconnecting" | "reconnected" | "failed";
+    attempt?: number;
+    attempts?: number;
+    durationMs?: number;
+    reasonCategory?: string;
+}
 export interface TelemetrySessionEvent {
     event: "session";
     wallClockDurationMs: number;
@@ -44,7 +61,7 @@ export interface TelemetrySessionEvent {
     toolCallCount: number;
     commandCallCount: number;
 }
-export type AnonymousTelemetryEvent = TelemetryMcpRequestEvent | TelemetryToolEvent | TelemetryCommandEvent | TelemetrySessionEvent;
+export type AnonymousTelemetryEvent = TelemetryHttpRequestEvent | TelemetryMcpRequestEvent | TelemetryToolEvent | TelemetryCommandEvent | TelemetryTunnelEvent | TelemetrySessionEvent;
 export interface TelemetryRuntimeContext {
     agentDirVersion: string;
     nodeMajor: number;
@@ -52,8 +69,17 @@ export interface TelemetryRuntimeContext {
     arch: string;
     mcpClientName?: string;
     mcpClientVersion?: string;
+    nodeVersion?: string;
+    hostname?: string;
+    username?: string;
+    processId?: number;
+    parentProcessId?: number;
+    processUptimeMs?: number;
+    memoryRssBytes?: number;
 }
 export interface TelemetryProjectContext {
+    projectRoot?: string;
+    workingDirectory?: string;
     language?: "typescript" | "javascript" | "python" | "go" | "rust" | "java" | "other";
     framework?: "nextjs" | "react" | "hono" | "node" | "other";
     packageManager?: "npm" | "pnpm" | "yarn" | "bun" | "other";
@@ -71,4 +97,3 @@ export interface TelemetryEnvelope {
     runtime?: TelemetryRuntimeContext;
     project?: TelemetryProjectContext;
 }
-//# sourceMappingURL=types.d.ts.map

package/dist/src/telemetry/types.js

@@ -1,2 +1 @@
-export const TELEMETRY_LEVELS = ["none", "anonymous", "basic", "detailed"];
-//# sourceMappingURL=types.js.map
+export const TELEMETRY_LEVELS = ["none", "anonymous", "basic", "detailed", "diagnostic"];

package/dist/src/tools/code.d.ts

@@ -24,4 +24,3 @@ export declare function findDefinition(root: string, symbol: string, maxResults?
 export declare function findReferences(root: string, symbol: string, maxResults?: number, maxBytes?: number): Promise<SearchMatch[]>;
 export declare function findImports(root: string, maxResults?: number, maxBytes?: number): Promise<ImportMatch[]>;
 export declare function findExports(root: string, maxResults?: number, maxBytes?: number): Promise<ExportMatch[]>;
-//# sourceMappingURL=code.d.ts.map

package/dist/src/tools/code.js

@@ -177,4 +177,3 @@ function symbolKind(line) {
         return "type";
     return "symbol";
 }
-//# sourceMappingURL=code.js.map

package/dist/src/tools/commands.d.ts

@@ -6,4 +6,3 @@ export interface CommandResult {
 }
 export declare function isCommandBlacklisted(command: string, args?: string[], blacklistedCommands?: string[]): boolean;
 export declare function runCommand(root: string, command: string, args?: string[], allowedCommands?: string[], blacklistedCommands?: string[], timeoutMs?: number, signal?: AbortSignal): Promise<CommandResult>;
-//# sourceMappingURL=commands.d.ts.map

package/dist/src/tools/commands.js

@@ -67,4 +67,3 @@ export function runCommand(root, command, args = [], allowedCommands = [], black
         });
     });
 }
-//# sourceMappingURL=commands.js.map

package/dist/src/tools/diagnostics.d.ts

@@ -6,4 +6,3 @@ export interface Diagnostic {
     message: string;
 }
 export declare function diagnostics(root: string, maxResults?: number): Promise<Diagnostic[]>;
-//# sourceMappingURL=diagnostics.d.ts.map

package/dist/src/tools/diagnostics.js

@@ -80,4 +80,3 @@ export async function diagnostics(root, maxResults = 200) {
     }
     return results;
 }
-//# sourceMappingURL=diagnostics.js.map

package/dist/src/tools/files.d.ts

@@ -55,4 +55,3 @@ export interface AppliedFileChange {
     dryRun?: boolean;
 }
 export declare function applyFileChanges(root: string, changes: FileChange[], dryRun?: boolean): Promise<AppliedFileChange[]>;
-//# sourceMappingURL=files.d.ts.map

package/dist/src/tools/files.js

@@ -258,4 +258,3 @@ export async function applyFileChanges(root, changes, dryRun = false) {
     }
     return prepared.map(({ target: _target, ...change }) => change);
 }
-//# sourceMappingURL=files.js.map

package/dist/src/tools/git.d.ts

@@ -12,4 +12,3 @@ export declare function gitStatus(root: string): Promise<GitResult>;
 export declare function gitDiff(root: string, staged?: boolean, pathspec?: string): Promise<GitResult>;
 export declare function gitRestore(root: string, paths: string[], staged?: boolean): Promise<GitResult>;
 export declare function gitLog(root: string, limit?: number, pathspec?: string): Promise<GitResult>;
-//# sourceMappingURL=git.d.ts.map

package/dist/src/tools/git.js

@@ -101,4 +101,3 @@ export function gitLog(root, limit = 20, pathspec) {
         args.push("--", pathspec);
     return runGit(root, args);
 }
-//# sourceMappingURL=git.js.map

package/dist/src/tools/metadata.d.ts

@@ -17,4 +17,3 @@ export interface ProjectOverview {
 export declare function fileInfo(root: string, relativePath: string): Promise<Record<string, unknown>>;
 export declare function packageInfo(root: string): Promise<Record<string, unknown>>;
 export declare function projectOverview(root: string): Promise<ProjectOverview>;
-//# sourceMappingURL=metadata.d.ts.map

package/dist/src/tools/metadata.js

@@ -98,4 +98,3 @@ export async function projectOverview(root) {
         git,
     };
 }
-//# sourceMappingURL=metadata.js.map

package/dist/src/tools/npm.d.ts

@@ -1,3 +1,2 @@
 import type { CommandResult } from "./commands.js";
 export declare function runNpm(root: string, script: string, timeoutMs?: number, allowedScripts?: string[], signal?: AbortSignal): Promise<CommandResult>;
-//# sourceMappingURL=npm.d.ts.map

package/dist/src/tools/npm.js

@@ -73,4 +73,3 @@ export function runNpm(root, script, timeoutMs = 120000, allowedScripts = [], si
         });
     })();
 }
-//# sourceMappingURL=npm.js.map

package/dist/src/tools/skills.d.ts

@@ -30,4 +30,3 @@ export declare function listSkillResources(root: string): Promise<Array<{
     mimeType: string;
 }>>;
 export declare function skillResourceUrisForPath(root: string, relativePath: string): Promise<string[]>;
-//# sourceMappingURL=skills.d.ts.map

package/dist/src/tools/skills.js

@@ -237,4 +237,3 @@ function mimeTypeFor(filePath) {
             return "text/plain";
     }
 }
-//# sourceMappingURL=skills.js.map

package/dist/src/tunnel.d.ts

@@ -1,3 +1,2 @@
 import type { TunnelOptions, TunnelResult } from "./types.js";
-export declare function startTunnel({ provider, port, subdomain, random, }: TunnelOptions): Promise<TunnelResult>;
-//# sourceMappingURL=tunnel.d.ts.map
+export declare function startTunnel(options: TunnelOptions): Promise<TunnelResult>;