agent-dir 0.2.0 → 0.3.1

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

@@ -0,0 +1,4 @@
+import type { AnonymousTelemetryEvent, TelemetryEnvelope, TelemetryLevel, TelemetryProjectContext, TelemetryRuntimeContext } from "./types.js";
+export declare function sanitizeAnonymousEvent(event: AnonymousTelemetryEvent): AnonymousTelemetryEvent;
+export declare function createTelemetryEnvelope(level: Exclude<TelemetryLevel, "none">, event: AnonymousTelemetryEvent, runtime?: TelemetryRuntimeContext, project?: TelemetryProjectContext, configId?: string, sessionId?: string): TelemetryEnvelope;
+//# sourceMappingURL=privacy.d.ts.map

package/dist/src/telemetry/privacy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"privacy.d.ts","sourceRoot":"","sources":["../../../src/telemetry/privacy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,uBAAuB,EACvB,iBAAiB,EACjB,cAAc,EACd,uBAAuB,EACvB,uBAAuB,EACxB,MAAM,YAAY,CAAC;AAmBpB,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,uBAAuB,GAAG,uBAAuB,CAwD9F;AAED,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,OAAO,CAAC,cAAc,EAAE,MAAM,CAAC,EACtC,KAAK,EAAE,uBAAuB,EAC9B,OAAO,CAAC,EAAE,uBAAuB,EACjC,OAAO,CAAC,EAAE,uBAAuB,EACjC,QAAQ,SAAY,EACpB,SAAS,SAAY,GACpB,iBAAiB,CAmBnB"}

package/dist/src/telemetry/privacy.js

@@ -0,0 +1,145 @@
+const SAFE_ERROR_CATEGORIES = new Set([
+    "authentication",
+    "authorization",
+    "invalid_input",
+    "not_found",
+    "conflict",
+    "timeout",
+    "execution",
+    "internal",
+    "startup",
+    "unknown",
+]);
+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 === "mcp_request") {
+        return {
+            event: "mcp_request",
+            method: sanitizeMcpMethod(event.method),
+            success: event.success === true,
+            durationMs: boundedNumber(event.durationMs),
+            ...(event.errorCategory === undefined
+                ? {}
+                : { errorCategory: sanitizeErrorCategory(event.errorCategory) }),
+        };
+    }
+    if (event.event === "tool_call") {
+        return {
+            event: "tool_call",
+            tool: sanitizeIdentifier(event.tool, SAFE_TOOL_NAME),
+            success: event.success === true,
+            durationMs: boundedNumber(event.durationMs),
+            ...optionalNumber("inputBytes", event.inputBytes),
+            ...optionalNumber("outputBytes", event.outputBytes),
+            ...optionalNumber("resultCount", event.resultCount),
+            ...optionalNumber("affectedFiles", event.affectedFiles),
+            ...(event.truncated === undefined ? {} : { truncated: event.truncated === true }),
+            ...(event.paginated === undefined ? {} : { paginated: event.paginated === true }),
+            ...(event.errorCategory === undefined
+                ? {}
+                : { errorCategory: sanitizeErrorCategory(event.errorCategory) }),
+        };
+    }
+    if (event.event === "command_call") {
+        return {
+            event: "command_call",
+            commandFamily: sanitizeIdentifier(event.commandFamily, SAFE_COMMAND_FAMILY),
+            ...(event.operation === undefined
+                ? {}
+                : { operation: sanitizeIdentifier(event.operation, SAFE_OPERATION) }),
+            success: event.success === true,
+            durationMs: boundedNumber(event.durationMs),
+            ...optionalNumber("outputBytes", event.outputBytes),
+            ...(event.errorCategory === undefined
+                ? {}
+                : { errorCategory: sanitizeErrorCategory(event.errorCategory) }),
+        };
+    }
+    return {
+        event: "session",
+        wallClockDurationMs: boundedNumber(event.wallClockDurationMs),
+        activeRequestDurationMs: boundedNumber(event.activeRequestDurationMs),
+        idleGapDurationMs: boundedNumber(event.idleGapDurationMs),
+        requestCount: boundedInteger(event.requestCount),
+        toolCallCount: boundedInteger(event.toolCallCount),
+        commandCallCount: boundedInteger(event.commandCallCount),
+    };
+}
+export function createTelemetryEnvelope(level, event, runtime, project, configId = "default", sessionId = "default") {
+    const envelope = {
+        schemaVersion: 1,
+        timestamp: new Date().toISOString(),
+        configId,
+        sessionId,
+        level,
+        event: sanitizeAnonymousEvent(event),
+    };
+    if (level === "basic" || level === "detailed") {
+        if (runtime)
+            envelope.runtime = sanitizeRuntimeContext(runtime);
+    }
+    if (level === "detailed" && project) {
+        envelope.project = sanitizeProjectContext(project);
+    }
+    return envelope;
+}
+function sanitizeRuntimeContext(context) {
+    return {
+        agentDirVersion: sanitizeVersion(context.agentDirVersion),
+        nodeMajor: boundedInteger(context.nodeMajor),
+        os: ["linux", "macos", "windows", "other"].includes(context.os) ? context.os : "other",
+        arch: sanitizeIdentifier(context.arch, /^[a-z0-9_]+$/),
+        ...(context.mcpClientName === undefined
+            ? {}
+            : { mcpClientName: sanitizeFreeIdentifier(context.mcpClientName) }),
+        ...(context.mcpClientVersion === undefined
+            ? {}
+            : { mcpClientVersion: sanitizeVersion(context.mcpClientVersion) }),
+    };
+}
+function sanitizeProjectContext(context) {
+    return {
+        ...(context.language ? { language: context.language } : {}),
+        ...(context.framework ? { framework: context.framework } : {}),
+        ...(context.packageManager ? { packageManager: context.packageManager } : {}),
+        ...(context.hasGit === undefined ? {} : { hasGit: context.hasGit === true }),
+        ...(context.hasCodegraph === undefined ? {} : { hasCodegraph: context.hasCodegraph === true }),
+        ...(context.projectSize ? { projectSize: context.projectSize } : {}),
+    };
+}
+function sanitizeMcpMethod(value) {
+    const normalized = value.trim().toLowerCase();
+    return /^[a-z][a-z0-9_./-]*$/.test(normalized) ? normalized : "unknown";
+}
+function sanitizeIdentifier(value, pattern) {
+    const normalized = value.trim().toLowerCase();
+    return pattern.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";
+}
+function sanitizeVersion(value) {
+    const normalized = value.trim().slice(0, 32);
+    return /^v?[0-9]+(?:\.[0-9]+){0,3}(?:[-+][a-z0-9.-]+)?$/i.test(normalized)
+        ? normalized
+        : "unknown";
+}
+function sanitizeErrorCategory(value) {
+    const normalized = value.trim().toLowerCase();
+    return SAFE_ERROR_CATEGORIES.has(normalized) ? normalized : "unknown";
+}
+function boundedNumber(value) {
+    if (!Number.isFinite(value))
+        return 0;
+    return Math.max(0, Math.min(Math.round(value), 2_147_483_647));
+}
+function boundedInteger(value) {
+    return Math.max(0, Math.min(Math.round(Number.isFinite(value) ? value : 0), 1_000_000_000));
+}
+function optionalNumber(key, value) {
+    return value === undefined ? {} : { [key]: boundedNumber(value) };
+}
+//# sourceMappingURL=privacy.js.map

package/dist/src/telemetry/privacy.js.map

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

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

@@ -0,0 +1,30 @@
+import type { AnonymousTelemetryEvent, TelemetryEnvelope, TelemetryLevel, TelemetryProjectContext, TelemetryRuntimeContext } from "./types.js";
+export interface TelemetryRecorderOptions {
+    level: TelemetryLevel;
+    maxEvents?: number;
+    runtime?: TelemetryRuntimeContext;
+    project?: TelemetryProjectContext;
+    persist?: boolean;
+    persistPath?: string;
+    configId?: string;
+    sessionId?: string;
+}
+export declare class TelemetryRecorder {
+    private readonly level;
+    private readonly maxEvents;
+    private readonly runtime;
+    private readonly project;
+    private readonly events;
+    private readonly persist;
+    private readonly persistPath;
+    private readonly configId;
+    private readonly sessionId;
+    constructor(options: TelemetryRecorderOptions);
+    record(event: AnonymousTelemetryEvent, runtime?: TelemetryRuntimeContext | undefined, project?: TelemetryProjectContext | undefined): void;
+    snapshot(): TelemetryEnvelope[];
+    clear(): void;
+    get size(): number;
+    private loadPersisted;
+    private persistEvent;
+}
+//# sourceMappingURL=recorder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"recorder.d.ts","sourceRoot":"","sources":["../../../src/telemetry/recorder.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,uBAAuB,EACvB,iBAAiB,EACjB,cAAc,EACd,uBAAuB,EACvB,uBAAuB,EACxB,MAAM,YAAY,CAAC;AAMpB,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,cAAc,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,uBAAuB,CAAC;IAClC,OAAO,CAAC,EAAE,uBAAuB,CAAC;IAClC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAiB;IACvC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsC;IAC9D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsC;IAC9D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA2B;IAClD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;IAClC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IAEnC,YAAY,OAAO,EAAE,wBAAwB,EAU5C;IAED,MAAM,CACJ,KAAK,EAAE,uBAAuB,EAC9B,OAAO,GAAE,uBAAuB,GAAG,SAAwB,EAC3D,OAAO,GAAE,uBAAuB,GAAG,SAAwB,GAC1D,IAAI,CAeN;IAED,QAAQ,IAAI,iBAAiB,EAAE,CAE9B;IAED,KAAK,IAAI,IAAI,CAUZ;IAED,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,OAAO,CAAC,aAAa;IAmBrB,OAAO,CAAC,YAAY;CAqBrB"}

package/dist/src/telemetry/recorder.js

@@ -0,0 +1,98 @@
+import { appendFileSync, chmodSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+import { createTelemetryEnvelope } from "./privacy.js";
+const DEFAULT_MAX_EVENTS = 500;
+const DEFAULT_PERSISTED_EVENTS = 500;
+const TELEMETRY_FILE = join(homedir(), ".config", "agent-dir", "telemetry.jsonl");
+export class TelemetryRecorder {
+    level;
+    maxEvents;
+    runtime;
+    project;
+    events = [];
+    persist;
+    persistPath;
+    configId;
+    sessionId;
+    constructor(options) {
+        this.level = options.level;
+        this.maxEvents = Math.max(1, Math.min(options.maxEvents ?? DEFAULT_MAX_EVENTS, 10_000));
+        this.runtime = options.runtime;
+        this.project = options.project;
+        this.persist = options.persist ?? false;
+        this.persistPath = options.persistPath ?? TELEMETRY_FILE;
+        this.configId = options.configId ?? "default";
+        this.sessionId = options.sessionId ?? "default";
+        if (this.persist && this.level !== "none")
+            this.loadPersisted();
+    }
+    record(event, runtime = this.runtime, project = this.project) {
+        if (this.level === "none")
+            return;
+        const envelope = createTelemetryEnvelope(this.level, event, runtime, project, this.configId, this.sessionId);
+        if (this.events.length >= this.maxEvents)
+            this.events.shift();
+        this.events.push(envelope);
+        if (this.persist)
+            this.persistEvent(envelope);
+    }
+    snapshot() {
+        return structuredClone(this.events);
+    }
+    clear() {
+        this.events.length = 0;
+        if (!this.persist)
+            return;
+        try {
+            mkdirSync(dirname(this.persistPath), { recursive: true, mode: 0o700 });
+            writeFileSync(this.persistPath, "", { encoding: "utf8", mode: 0o600 });
+            chmodSync(this.persistPath, 0o600);
+        }
+        catch {
+            // Telemetry persistence must never affect the MCP request path.
+        }
+    }
+    get size() {
+        return this.events.length;
+    }
+    loadPersisted() {
+        try {
+            const lines = readFileSync(this.persistPath, "utf8").split("\n").filter(Boolean);
+            const persisted = lines
+                .map((line) => JSON.parse(line))
+                .filter((event) => event &&
+                event.schemaVersion === 1 &&
+                event.level === this.level &&
+                event.configId === this.configId)
+                .slice(-Math.min(this.maxEvents, DEFAULT_PERSISTED_EVENTS));
+            this.events.push(...persisted);
+        }
+        catch {
+            // A missing or corrupt telemetry file starts a fresh in-memory buffer.
+        }
+    }
+    persistEvent(envelope) {
+        try {
+            mkdirSync(dirname(this.persistPath), { recursive: true, mode: 0o700 });
+            appendFileSync(this.persistPath, `${JSON.stringify(envelope)}\n`, {
+                encoding: "utf8",
+                mode: 0o600,
+            });
+            chmodSync(this.persistPath, 0o600);
+            if (this.events.length === this.maxEvents) {
+                const lines = readFileSync(this.persistPath, "utf8").split("\n").filter(Boolean);
+                if (lines.length > this.maxEvents) {
+                    writeFileSync(this.persistPath, `${lines.slice(-this.maxEvents).join("\n")}\n`, {
+                        encoding: "utf8",
+                        mode: 0o600,
+                    });
+                }
+            }
+        }
+        catch {
+            // Telemetry persistence must never affect the MCP request path.
+        }
+    }
+}
+//# sourceMappingURL=recorder.js.map

package/dist/src/telemetry/recorder.js.map

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

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

@@ -0,0 +1,74 @@
+export declare const TELEMETRY_LEVELS: readonly ["none", "anonymous", "basic", "detailed"];
+export type TelemetryLevel = (typeof TELEMETRY_LEVELS)[number];
+export interface TelemetryConfig {
+    level: TelemetryLevel;
+    configId?: string;
+    persist?: boolean;
+    sessionId?: string;
+}
+export interface TelemetryMcpRequestEvent {
+    event: "mcp_request";
+    method: string;
+    success: boolean;
+    durationMs: number;
+    errorCategory?: string;
+}
+export interface TelemetryToolEvent {
+    event: "tool_call";
+    tool: string;
+    success: boolean;
+    durationMs: number;
+    inputBytes?: number;
+    outputBytes?: number;
+    resultCount?: number;
+    affectedFiles?: number;
+    truncated?: boolean;
+    paginated?: boolean;
+    errorCategory?: string;
+}
+export interface TelemetryCommandEvent {
+    event: "command_call";
+    commandFamily: string;
+    operation?: string;
+    success: boolean;
+    durationMs: number;
+    outputBytes?: number;
+    errorCategory?: string;
+}
+export interface TelemetrySessionEvent {
+    event: "session";
+    wallClockDurationMs: number;
+    activeRequestDurationMs: number;
+    idleGapDurationMs: number;
+    requestCount: number;
+    toolCallCount: number;
+    commandCallCount: number;
+}
+export type AnonymousTelemetryEvent = TelemetryMcpRequestEvent | TelemetryToolEvent | TelemetryCommandEvent | TelemetrySessionEvent;
+export interface TelemetryRuntimeContext {
+    agentDirVersion: string;
+    nodeMajor: number;
+    os: "linux" | "macos" | "windows" | "other";
+    arch: string;
+    mcpClientName?: string;
+    mcpClientVersion?: string;
+}
+export interface TelemetryProjectContext {
+    language?: "typescript" | "javascript" | "python" | "go" | "rust" | "java" | "other";
+    framework?: "nextjs" | "react" | "hono" | "node" | "other";
+    packageManager?: "npm" | "pnpm" | "yarn" | "bun" | "other";
+    hasGit?: boolean;
+    hasCodegraph?: boolean;
+    projectSize?: "small" | "medium" | "large";
+}
+export interface TelemetryEnvelope {
+    schemaVersion: 1;
+    timestamp: string;
+    configId: string;
+    sessionId: string;
+    level: Exclude<TelemetryLevel, "none">;
+    event: AnonymousTelemetryEvent;
+    runtime?: TelemetryRuntimeContext;
+    project?: TelemetryProjectContext;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/src/telemetry/types.js

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

package/dist/src/telemetry/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/telemetry/types.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,UAAU,CAAU,CAAC"}

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

@@ -4,5 +4,6 @@ export interface CommandResult {
     stdout: string;
     stderr: string;
 }
-export declare function runCommand(root: string, command: string, args?: string[], allowedCommands?: string[], timeoutMs?: number, signal?: AbortSignal): Promise<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.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../../src/tools/commands.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,UAAU,CACxB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,MAAM,EAAO,EACnB,eAAe,GAAE,MAAM,EAAO,EAC9B,SAAS,SAAS,EAClB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,aAAa,CAAC,CAsDxB"}
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../../src/tools/commands.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,MAAM,EAAO,EACnB,mBAAmB,GAAE,MAAM,EAAO,GACjC,OAAO,CAMT;AAED,wBAAgB,UAAU,CACxB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,MAAM,EAAO,EACnB,eAAe,GAAE,MAAM,EAAO,EAC9B,mBAAmB,GAAE,MAAM,EAAO,EAClC,SAAS,SAAS,EAClB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,aAAa,CAAC,CAwDxB"}

package/dist/src/tools/commands.js

@@ -1,10 +1,19 @@
 import { spawn } from "node:child_process";
 const SAFE_NAME = /^[A-Za-z0-9][A-Za-z0-9._:-]*$/;
-export function runCommand(root, command, args = [], allowedCommands = [], timeoutMs = 120000, signal) {
+export function isCommandBlacklisted(command, args = [], blacklistedCommands = []) {
+    const invocation = [command, ...args];
+    return blacklistedCommands.some((entry) => {
+        const tokens = entry.trim().split(/\s+/).filter(Boolean);
+        return tokens.length > 0 && tokens.every((token, index) => invocation[index] === token);
+    });
+}
+export function runCommand(root, command, args = [], allowedCommands = [], blacklistedCommands = [], timeoutMs = 120000, signal) {
     if (!SAFE_NAME.test(command))
         throw new Error("Invalid command name.");
     if (!allowedCommands.includes(command))
         throw new Error(`Command '${command}' is not allowed by this profile.`);
+    if (isCommandBlacklisted(command, args, blacklistedCommands))
+        throw new Error(`Command '${[command, ...args].join(" ")}' is blocked by this profile.`);
     if (!Array.isArray(args) || args.some((arg) => typeof arg !== "string"))
         throw new Error("Command arguments must be strings.");
     return new Promise((resolve, reject) => {

package/dist/src/tools/commands.js.map

@@ -1 +1 @@
-{"version":3,"file":"commands.js","sourceRoot":"","sources":["../../../src/tools/commands.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAE3C,MAAM,SAAS,GAAG,+BAA+B,CAAC;AASlD,MAAM,UAAU,UAAU,CACxB,IAAY,EACZ,OAAe,EACf,IAAI,GAAa,EAAE,EACnB,eAAe,GAAa,EAAE,EAC9B,SAAS,GAAG,MAAM,EAClB,MAAoB;IAEpB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;IACvE,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,OAAO,CAAC;QACpC,MAAM,IAAI,KAAK,CAAC,YAAY,OAAO,mCAAmC,CAAC,CAAC;IAC1E,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,GAAG,KAAK,QAAQ,CAAC;QACrE,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;IAExD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;QAClF,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,IAAI,QAAQ,GAAG,KAAK,CAAC;QACrB,IAAI,KAAoC,CAAC;QACzC,MAAM,KAAK,GAAG,GAAG,EAAE;YACjB,IAAI,QAAQ;gBAAE,OAAO;YACrB,QAAQ,GAAG,IAAI,CAAC;YAChB,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACtB,MAAM,CAAC,IAAI,KAAK,CAAC,YAAY,OAAO,gBAAgB,CAAC,CAAC,CAAC;QACzD,CAAC,CAAC;QACF,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YACtB,IAAI,QAAQ;gBAAE,OAAO;YACrB,QAAQ,GAAG,IAAI,CAAC;YAChB,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACtB,MAAM,EAAE,mBAAmB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;YAC5C,MAAM,CAAC,IAAI,KAAK,CAAC,YAAY,OAAO,qBAAqB,SAAS,KAAK,CAAC,CAAC,CAAC;QAC5E,CAAC,EAAE,SAAS,CAAC,CAAC;QACd,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;YACpB,KAAK,EAAE,CAAC;YACR,OAAO;QACT,CAAC;QACD,MAAM,EAAE,gBAAgB,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QAEzD,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAsB,EAAE,EAAE;YACjD,MAAM,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;QAC7B,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAsB,EAAE,EAAE;YACjD,MAAM,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;QAC7B,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAY,EAAE,EAAE;YACjC,IAAI,QAAQ;gBAAE,OAAO;YACrB,QAAQ,GAAG,IAAI,CAAC;YAChB,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,MAAM,EAAE,mBAAmB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;YAC5C,MAAM,CAAC,KAAK,CAAC,CAAC;QAChB,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAmB,EAAE,EAAE;YACxC,IAAI,QAAQ;gBAAE,OAAO;YACrB,QAAQ,GAAG,IAAI,CAAC;YAChB,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,MAAM,EAAE,mBAAmB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;YAC5C,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,QAAQ,EAAE,IAAI,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QAC1F,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"commands.js","sourceRoot":"","sources":["../../../src/tools/commands.ts"],"names":[],"mappings":"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"}

package/dist/src/types.d.ts

@@ -1,4 +1,5 @@
 import type { ChildProcess } from "node:child_process";
+import type { TelemetryConfig } from "./telemetry/types.js";
 export interface NpmConfig {
     allowedScripts: string[];
 }
@@ -10,20 +11,26 @@ export interface Profile {
     token?: string;
     npm?: NpmConfig;
     commands?: string[];
+    blacklistedCommands?: string[];
+    git?: boolean;
 }
 export interface AgentConfig {
     version: 1;
     profiles: Record<string, Profile>;
+    telemetry?: TelemetryConfig;
 }
 export interface CommandConfig {
     npm?: NpmConfig;
     commands?: string[];
+    blacklistedCommands?: string[];
+    git?: boolean;
 }
 export interface ServerOptions {
     root: string;
     port: number;
     token: string;
     commandConfig?: CommandConfig;
+    telemetry?: TelemetryConfig;
 }
 export interface RequestLog {
     method: string;

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,MAAM,WAAW,SAAS;IACxB,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,OAAO;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,GAAG,UAAU,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,SAAS,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,CAAC,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,aAAa;IAC5B,GAAG,CAAC,EAAE,SAAS,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,UAAU,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,YAAY,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;CACb"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D,MAAM,WAAW,SAAS;IACxB,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,OAAO;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,GAAG,UAAU,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,SAAS,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC/B,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,CAAC,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,SAAS,CAAC,EAAE,eAAe,CAAC;CAC7B;AAED,MAAM,WAAW,aAAa;IAC5B,GAAG,CAAC,EAAE,SAAS,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC/B,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,SAAS,CAAC,EAAE,eAAe,CAAC;CAC7B;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,UAAU,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,YAAY,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;CACb"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-dir",
-  "version": "0.2.0",
+  "version": "0.3.1",
   "description": "Expose a local project to an AI agent through authenticated MCP, filesystem tools, and allowlisted development commands",
   "repository": {
     "type": "git",
@@ -29,11 +29,14 @@
     "lint": "biome lint .",
     "check": "biome check . && tsc --noEmit",
     "check:write": "biome check --write --unsafe .",
-    "prepublishOnly": "npm run check && npm test"
+    "prepublishOnly": "npm run check && npm test",
+    "release": "semantic-release"
   },
   "devDependencies": {
     "@biomejs/biome": "^2.5.15",
+    "@semantic-release/git": "^11.0.1",
     "@types/node": "^24.19.1",
+    "semantic-release": "^25.0.9",
     "typescript": "^7.0.2"
   },
   "keywords": [