parasor 0.1.0

package/server/agent-detector/event-map.js

@@ -0,0 +1,136 @@
+/*
+ * Per-agent hook event normalization. Each supported coding agent has its
+ * own hook vocabulary; this module is the single source of truth that
+ * translates them to parasor's lifecycle/source/confidence observations.
+ *
+ * Architectural pattern (single normalization layer, agent-specific event
+ * dictionaries) re-derived from the same shape the runtime-only wrapper uses in their
+ * notify-hook + mapEventType flow. The actual mapping tables and parasor's
+ * agent enum are independent.
+ */
+const AGENT_NAME_LIST = ["claude", "codex", "manual"];
+const AGENT_NAMES = new Set(AGENT_NAME_LIST);
+const NOOP = { kind: "noop" };
+function hookState(lifecycle) {
+    return {
+        kind: "state",
+        state: {
+            lifecycle,
+            source: "hook",
+            confidence: "high",
+        },
+    };
+}
+function notifyState(lifecycle) {
+    return {
+        kind: "state",
+        state: {
+            lifecycle,
+            source: "notify",
+            confidence: "high",
+        },
+    };
+}
+/*
+ * Claude Code event -> AgentStatus dictionary.
+ *
+ * We keep the primary status model close to the user's requested 3-way
+ * split and to the OSS references we studied:
+ *
+ *   - `running`  = Claude is thinking / acting autonomously
+ *   - `waiting`  = Claude explicitly needs a human response or approval
+ *   - `completed`/`idle` fold to sidebar `other`
+ *
+ * The important consequence is that ordinary tool execution stays
+ * `running`. `attention` should be reserved for explicit human hand-off
+ * moments, not every autonomous tool loop. That keeps the sidebar calmer
+ * and avoids red pulses / notifications for routine edits or shell calls.
+ *
+ * Notification subtypes come in as discriminated keys (see cli/hook.ts).
+ * We only elevate the documented user-input-required types to `waiting`;
+ * everything else is ignored conservatively rather than over-alerting.
+ */
+const CLAUDE_EVENTS = {
+    // SessionStart is a noop: in other tools it registered the agent PID,
+    // and we don't want it to flash "running" before the first user turn.
+    sessionstart: NOOP,
+    userpromptsubmit: hookState("running"),
+    pretooluse: hookState("running"),
+    "pretooluse:askuserquestion": hookState("waiting"),
+    "pretooluse:exitplanmode": hookState("waiting"),
+    permissionrequest: hookState("waiting"),
+    permissiondenied: hookState("running"),
+    posttooluse: hookState("running"),
+    stop: hookState("completed"),
+    notification: NOOP,
+    "notification:auth_success": NOOP,
+    "notification:permission_prompt": hookState("waiting"),
+    "notification:idle_prompt": hookState("waiting"),
+    "notification:elicitation_dialog": hookState("waiting"),
+    elicitation: hookState("waiting"),
+    elicitationresult: hookState("running"),
+    sessionend: hookState("idle"),
+};
+const CODEX_EVENTS = {
+    sessionstart: NOOP,
+    userpromptsubmit: hookState("running"),
+    stop: hookState("completed"),
+    // Codex CLI uses a different event vocabulary. Names re-derived from
+    // public docs and the public Codex hook examples
+    // (their bash case statement, not their TS code).
+    task_started: hookState("running"),
+    turn_started: hookState("running"),
+    agent_turn_started: hookState("running"),
+    // Both naming conventions appear in the wild; accept dash and underscore.
+    "agent-turn-started": hookState("running"),
+    exec_command_begin: hookState("running"),
+    task_complete: hookState("completed"),
+    turn_complete: hookState("completed"),
+    agent_turn_complete: hookState("completed"),
+    "agent-turn-complete": hookState("completed"),
+    exec_approval_request: hookState("waiting"),
+    apply_patch_approval_request: hookState("waiting"),
+    request_user_input: hookState("waiting"),
+};
+// Manual agent: used by `parasor notify` CLI and shell wrappers that want
+// to push state directly without a per-event vocabulary. The "event" here
+// is the desired status name, so the table is a 1:1 passthrough.
+const MANUAL_EVENTS = {
+    running: notifyState("running"),
+    waiting: notifyState("waiting"),
+    completed: notifyState("completed"),
+    idle: notifyState("idle"),
+};
+const AGENT_TABLES = {
+    claude: CLAUDE_EVENTS,
+    codex: CODEX_EVENTS,
+    manual: MANUAL_EVENTS,
+};
+export function isKnownAgent(name) {
+    return AGENT_NAMES.has(name);
+}
+export function mapEventType(agent, event) {
+    // Hook scripts may pass events with different casing depending on the
+    // agent's quoting / template (Claude uses PascalCase, Codex uses
+    // snake_case). Normalize before lookup so the dictionary stays small.
+    const key = event.trim().toLowerCase();
+    const table = AGENT_TABLES[agent];
+    const exact = table[key];
+    if (exact)
+        return exact;
+    // Discriminator fallback. cli/hook.ts may emit composite events like
+    // `PreToolUse:Bash` or `Notification:auth_success` for payload-driven
+    // dispatch. If the composite key isn't in the dictionary explicitly we
+    // strip the discriminator and try the bare event class, which is biased
+    // toward `running` / `noop` for Claude so unknown future subtypes don't
+    // over-alert the user.
+    const colonIdx = key.indexOf(":");
+    if (colonIdx !== -1) {
+        const bare = key.slice(0, colonIdx);
+        const fallback = table[bare];
+        if (fallback)
+            return fallback;
+    }
+    return { kind: "unknown" };
+}
+//# sourceMappingURL=event-map.js.map

package/server/agent-detector/event-map.js.map

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

package/server/agent-detector/manual-agent-tracker.d.ts

@@ -0,0 +1,19 @@
+interface ManualAgentTrackerOptions {
+    onDebug?: (sessionId: string, message: string) => void;
+}
+export declare class ManualAgentTracker {
+    private lineBuffers;
+    private hintedSessions;
+    private activeSessions;
+    private engagedSessions;
+    private onDebug?;
+    constructor(options?: ManualAgentTrackerOptions);
+    observeInput(sessionId: string, data: string): void;
+    observeOutput(sessionId: string, data: string): void;
+    shouldObserve(sessionId: string): boolean;
+    removeSession(sessionId: string): void;
+    private clear;
+    private debug;
+}
+export {};
+//# sourceMappingURL=manual-agent-tracker.d.ts.map

package/server/agent-detector/manual-agent-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manual-agent-tracker.d.ts","sourceRoot":"","sources":["../../src/agent-detector/manual-agent-tracker.ts"],"names":[],"mappings":"AAaA,UAAU,yBAAyB;IACjC,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACxD;AAsBD,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,WAAW,CAA6B;IAChD,OAAO,CAAC,cAAc,CAAmC;IACzD,OAAO,CAAC,cAAc,CAAqB;IAC3C,OAAO,CAAC,eAAe,CAAqB;IAC5C,OAAO,CAAC,OAAO,CAAC,CAA+C;gBAEnD,OAAO,CAAC,EAAE,yBAAyB;IAI/C,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IA+CnD,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAqBpD,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAIzC,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAOtC,OAAO,CAAC,KAAK;IAUb,OAAO,CAAC,KAAK;CAQd"}

package/server/agent-detector/manual-agent-tracker.js

@@ -0,0 +1,123 @@
+import { sanitizeTerminalOutput } from "./detector.js";
+const COMMAND_PATTERN = /^(claude|codex|opencode|gemini(?:-cli)?)(?:\s|$)/i;
+// biome-ignore lint/suspicious/noControlCharactersInRegex: alternate-screen enter is detected from raw terminal ESC sequences.
+const ALT_SCREEN_ENTER = /\x1b\[\?1049h|\x1b\[\?47h/;
+// biome-ignore lint/suspicious/noControlCharactersInRegex: alternate-screen exit is detected from raw terminal ESC sequences.
+const ALT_SCREEN_EXIT = /\x1b\[\?1049l|\x1b\[\?47l/;
+const TURN_COMPLETE_PATTERNS = [
+    /(?:^|\n)\s*❯\s*$/u,
+    /(?:^|\n)\s*>\s*$/u,
+    /(?:^|\n)\s*\$\s*$/u,
+];
+function normalizeTrackedAgent(value) {
+    const normalized = value.trim().toLowerCase();
+    switch (normalized) {
+        case "claude":
+        case "codex":
+        case "opencode":
+        case "gemini":
+        case "gemini-cli":
+            return normalized;
+        default:
+            return null;
+    }
+}
+function shouldActivateWithoutAltScreen(agent) {
+    return agent !== null && agent !== "claude";
+}
+export class ManualAgentTracker {
+    lineBuffers = new Map();
+    hintedSessions = new Map();
+    activeSessions = new Set();
+    engagedSessions = new Set();
+    onDebug;
+    constructor(options) {
+        this.onDebug = options?.onDebug;
+    }
+    observeInput(sessionId, data) {
+        if (data.includes("\u0003")) {
+            this.clear(sessionId, "ctrl-c");
+            return;
+        }
+        let buffer = this.lineBuffers.get(sessionId) ?? "";
+        for (const char of data) {
+            if (char === "\r" || char === "\n") {
+                const line = buffer.trim();
+                if (this.activeSessions.has(sessionId)) {
+                    if (line.length > 0) {
+                        this.engagedSessions.add(sessionId);
+                        this.debug(sessionId, `prompt submit ${line.slice(0, 32)}`);
+                    }
+                }
+                else {
+                    const hintedAgent = this.hintedSessions.get(sessionId) ?? null;
+                    if (line.length > 0 && shouldActivateWithoutAltScreen(hintedAgent)) {
+                        this.activeSessions.add(sessionId);
+                        this.engagedSessions.add(sessionId);
+                        this.debug(sessionId, `prompt submit ${line.slice(0, 32)}`);
+                    }
+                    else {
+                        const match = COMMAND_PATTERN.exec(line);
+                        const hinted = match ? normalizeTrackedAgent(match[1] ?? "") : null;
+                        if (hinted) {
+                            this.hintedSessions.set(sessionId, hinted);
+                            this.debug(sessionId, `hint ${line}`);
+                        }
+                    }
+                }
+                buffer = "";
+                continue;
+            }
+            if (char === "\u007f" || char === "\b") {
+                buffer = buffer.slice(0, -1);
+                continue;
+            }
+            if (char >= " ") {
+                buffer += char;
+            }
+        }
+        this.lineBuffers.set(sessionId, buffer);
+    }
+    observeOutput(sessionId, data) {
+        if (ALT_SCREEN_ENTER.test(data) && this.hintedSessions.has(sessionId)) {
+            this.activeSessions.add(sessionId);
+            this.lineBuffers.set(sessionId, "");
+            this.debug(sessionId, "alt-screen enter");
+        }
+        const sanitized = sanitizeTerminalOutput(data);
+        if (this.engagedSessions.has(sessionId) &&
+            TURN_COMPLETE_PATTERNS.some((pattern) => pattern.test(sanitized))) {
+            this.engagedSessions.delete(sessionId);
+            this.debug(sessionId, "turn complete");
+        }
+        if (ALT_SCREEN_EXIT.test(data)) {
+            this.clear(sessionId, "alt-screen exit");
+        }
+    }
+    shouldObserve(sessionId) {
+        return this.engagedSessions.has(sessionId);
+    }
+    removeSession(sessionId) {
+        this.lineBuffers.delete(sessionId);
+        this.hintedSessions.delete(sessionId);
+        this.activeSessions.delete(sessionId);
+        this.engagedSessions.delete(sessionId);
+    }
+    clear(sessionId, reason) {
+        const hadHint = this.hintedSessions.delete(sessionId) !== undefined;
+        const hadActive = this.activeSessions.delete(sessionId);
+        const hadEngaged = this.engagedSessions.delete(sessionId);
+        this.lineBuffers.delete(sessionId);
+        if (hadHint || hadActive || hadEngaged) {
+            this.debug(sessionId, `clear ${reason}`);
+        }
+    }
+    debug(sessionId, message) {
+        this.onDebug?.(sessionId, message);
+        if (process.env.PARASOR_AGENT_DEBUG !== "1")
+            return;
+        // eslint-disable-next-line no-console
+        console.error(`[agent-tracker] session=${sessionId.slice(0, 8)} ${message}`);
+    }
+}
+//# sourceMappingURL=manual-agent-tracker.js.map

package/server/agent-detector/manual-agent-tracker.js.map

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

package/server/agent-detector/output-eligibility.d.ts

@@ -0,0 +1,3 @@
+import type { Session } from "@parasor/shared";
+export declare function shouldObserveAgentOutput(session: Session | undefined, foregroundProcess: string | null): boolean;
+//# sourceMappingURL=output-eligibility.d.ts.map

package/server/agent-detector/output-eligibility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-eligibility.d.ts","sourceRoot":"","sources":["../../src/agent-detector/output-eligibility.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAwB/C,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,OAAO,GAAG,SAAS,EAC5B,iBAAiB,EAAE,MAAM,GAAG,IAAI,GAC/B,OAAO,CAYT"}

package/server/agent-detector/output-eligibility.js

@@ -0,0 +1,39 @@
+import { basename } from "node:path";
+const AGENT_PROCESS_NAMES = new Set([
+    "claude",
+    "codex",
+    "opencode",
+    "gemini",
+    "gemini-cli",
+]);
+function normalizeProcessName(value) {
+    return basename(value).trim().toLowerCase();
+}
+function isKnownAgentProcess(value) {
+    if (!value)
+        return false;
+    const normalized = normalizeProcessName(value);
+    if (AGENT_PROCESS_NAMES.has(normalized))
+        return true;
+    for (const name of AGENT_PROCESS_NAMES) {
+        if (normalized.startsWith(`${name}-`))
+            return true;
+    }
+    return false;
+}
+export function shouldObserveAgentOutput(session, foregroundProcess) {
+    if (!session)
+        return false;
+    if (session.command.type === "claude")
+        return true;
+    if (session.command.type === "shell")
+        return false;
+    if (session.command.type === "custom" &&
+        isKnownAgentProcess(session.command.command)) {
+        return true;
+    }
+    if (isKnownAgentProcess(foregroundProcess))
+        return true;
+    return false;
+}
+//# sourceMappingURL=output-eligibility.js.map

package/server/agent-detector/output-eligibility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-eligibility.js","sourceRoot":"","sources":["../../src/agent-detector/output-eligibility.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAGrC,MAAM,mBAAmB,GAAG,IAAI,GAAG,CAAC;IAClC,QAAQ;IACR,OAAO;IACP,UAAU;IACV,QAAQ;IACR,YAAY;CACb,CAAC,CAAC;AAEH,SAAS,oBAAoB,CAAC,KAAa;IACzC,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;AAC9C,CAAC;AAED,SAAS,mBAAmB,CAAC,KAAgC;IAC3D,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IACzB,MAAM,UAAU,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;IAC/C,IAAI,mBAAmB,CAAC,GAAG,CAAC,UAAU,CAAC;QAAE,OAAO,IAAI,CAAC;IACrD,KAAK,MAAM,IAAI,IAAI,mBAAmB,EAAE,CAAC;QACvC,IAAI,UAAU,CAAC,UAAU,CAAC,GAAG,IAAI,GAAG,CAAC;YAAE,OAAO,IAAI,CAAC;IACrD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,wBAAwB,CACtC,OAA4B,EAC5B,iBAAgC;IAEhC,IAAI,CAAC,OAAO;QAAE,OAAO,KAAK,CAAC;IAC3B,IAAI,OAAO,CAAC,OAAO,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACnD,IAAI,OAAO,CAAC,OAAO,CAAC,IAAI,KAAK,OAAO;QAAE,OAAO,KAAK,CAAC;IACnD,IACE,OAAO,CAAC,OAAO,CAAC,IAAI,KAAK,QAAQ;QACjC,mBAAmB,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,EAC5C,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,mBAAmB,CAAC,iBAAiB,CAAC;QAAE,OAAO,IAAI,CAAC;IACxD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/server/application/files/errors.d.ts

@@ -0,0 +1,28 @@
+export declare class FileAccessError extends Error {
+    constructor(message?: string);
+}
+export declare class FileReadError extends Error {
+    constructor(message: string);
+}
+export declare class FileNotFoundError extends Error {
+    constructor(message?: string);
+}
+export declare class FileTooLargeError extends Error {
+    constructor(message?: string);
+}
+export declare class FilesystemUnavailableError extends Error {
+    constructor(message?: string);
+}
+export declare class FileWriteError extends Error {
+    constructor(message: string);
+}
+export declare class FileWriteDisabledError extends Error {
+    constructor(message?: string);
+}
+export declare class FileExistsError extends Error {
+    constructor(message?: string);
+}
+export declare class UnsupportedPlatformError extends Error {
+    constructor(message?: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/server/application/files/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/application/files/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,eAAgB,SAAQ,KAAK;gBAC5B,OAAO,SAAkB;CAItC;AAED,qBAAa,aAAc,SAAQ,KAAK;gBAC1B,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,iBAAkB,SAAQ,KAAK;gBAC9B,OAAO,SAAmB;CAIvC;AAED,qBAAa,iBAAkB,SAAQ,KAAK;gBAC9B,OAAO,SAA6B;CAIjD;AAED,qBAAa,0BAA2B,SAAQ,KAAK;gBACvC,OAAO,SAA6B;CAIjD;AAED,qBAAa,cAAe,SAAQ,KAAK;gBAC3B,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,sBAAuB,SAAQ,KAAK;gBACnC,OAAO,SAAmC;CAIvD;AAED,qBAAa,eAAgB,SAAQ,KAAK;gBAC5B,OAAO,SAA+B;CAInD;AAED,qBAAa,wBAAyB,SAAQ,KAAK;gBACrC,OAAO,SAAyB;CAI7C"}

package/server/application/files/errors.js

@@ -0,0 +1,55 @@
+export class FileAccessError extends Error {
+    constructor(message = "Access denied") {
+        super(message);
+        this.name = "FileAccessError";
+    }
+}
+export class FileReadError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "FileReadError";
+    }
+}
+export class FileNotFoundError extends Error {
+    constructor(message = "File not found") {
+        super(message);
+        this.name = "FileNotFoundError";
+    }
+}
+export class FileTooLargeError extends Error {
+    constructor(message = "File too large (max 1MB)") {
+        super(message);
+        this.name = "FileTooLargeError";
+    }
+}
+export class FilesystemUnavailableError extends Error {
+    constructor(message = "Filesystem not available") {
+        super(message);
+        this.name = "FilesystemUnavailableError";
+    }
+}
+export class FileWriteError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "FileWriteError";
+    }
+}
+export class FileWriteDisabledError extends Error {
+    constructor(message = "Filesystem writes are disabled") {
+        super(message);
+        this.name = "FileWriteDisabledError";
+    }
+}
+export class FileExistsError extends Error {
+    constructor(message = "Destination already exists") {
+        super(message);
+        this.name = "FileExistsError";
+    }
+}
+export class UnsupportedPlatformError extends Error {
+    constructor(message = "Unsupported platform") {
+        super(message);
+        this.name = "UnsupportedPlatformError";
+    }
+}
+//# sourceMappingURL=errors.js.map

package/server/application/files/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/application/files/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,eAAgB,SAAQ,KAAK;IACxC,YAAY,OAAO,GAAG,eAAe;QACnC,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAED,MAAM,OAAO,aAAc,SAAQ,KAAK;IACtC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AAED,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IAC1C,YAAY,OAAO,GAAG,gBAAgB;QACpC,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IAClC,CAAC;CACF;AAED,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IAC1C,YAAY,OAAO,GAAG,0BAA0B;QAC9C,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IAClC,CAAC;CACF;AAED,MAAM,OAAO,0BAA2B,SAAQ,KAAK;IACnD,YAAY,OAAO,GAAG,0BAA0B;QAC9C,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,4BAA4B,CAAC;IAC3C,CAAC;CACF;AAED,MAAM,OAAO,cAAe,SAAQ,KAAK;IACvC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;CACF;AAED,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IAC/C,YAAY,OAAO,GAAG,gCAAgC;QACpD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;IACvC,CAAC;CACF;AAED,MAAM,OAAO,eAAgB,SAAQ,KAAK;IACxC,YAAY,OAAO,GAAG,4BAA4B;QAChD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAED,MAAM,OAAO,wBAAyB,SAAQ,KAAK;IACjD,YAAY,OAAO,GAAG,sBAAsB;QAC1C,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAC;IACzC,CAAC;CACF"}

package/server/application/files/local-filesystem.d.ts

@@ -0,0 +1,36 @@
+export interface LocalDirectoryEntry {
+    name: string;
+    path: string;
+    type: "directory";
+}
+export declare class InvalidDirectoryNameError extends Error {
+    constructor(message?: string);
+}
+interface LocalFilesystemDeps {
+    browseHomeDirectories?: (targetPath: string) => LocalDirectoryEntry[];
+    createDirectory?: (targetPath: string) => void;
+    getHomeDir?: () => string;
+    getPlatform?: () => NodeJS.Platform;
+    normalizePath?: (path: string) => string;
+    pickFolder?: (os: NodeJS.Platform) => Promise<string | null>;
+    statPath?: (targetPath: string) => {
+        isDirectory: boolean;
+    } | null;
+    checkWritable?: (targetPath: string) => boolean;
+}
+export declare function createLocalFilesystem({ browseHomeDirectories, createDirectory, getHomeDir, getPlatform, normalizePath, pickFolder, statPath, checkWritable, }?: LocalFilesystemDeps): {
+    browseDirectories(rawPath?: string): {
+        path: string;
+        parent: string | null;
+        entries: LocalDirectoryEntry[];
+    };
+    pickProjectFolder(): Promise<string | null>;
+    createProjectDirectory({ parent, name, }: {
+        parent: string;
+        name: string;
+    }): {
+        path: string;
+    };
+};
+export {};
+//# sourceMappingURL=local-filesystem.d.ts.map

package/server/application/files/local-filesystem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-filesystem.d.ts","sourceRoot":"","sources":["../../../src/application/files/local-filesystem.ts"],"names":[],"mappings":"AAwBA,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,WAAW,CAAC;CACnB;AAED,qBAAa,yBAA0B,SAAQ,KAAK;gBACtC,OAAO,SAA2B;CAI/C;AAED,UAAU,mBAAmB;IAC3B,qBAAqB,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,mBAAmB,EAAE,CAAC;IACtE,eAAe,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/C,UAAU,CAAC,EAAE,MAAM,MAAM,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,MAAM,CAAC,QAAQ,CAAC;IACpC,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IACzC,UAAU,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,CAAC,QAAQ,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC7D,QAAQ,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK;QAAE,WAAW,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;IACnE,aAAa,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC;CACjD;AAyFD,wBAAgB,qBAAqB,CAAC,EACpC,qBAAoD,EACpD,eAAwC,EACxC,UAAoB,EACpB,WAAsB,EACtB,aAAoC,EACpC,UAA8B,EAC9B,QAA0B,EAC1B,aAAoC,GACrC,GAAE,mBAAwB;gCAkBK,MAAM;;;;;;8CAwC/B;QACD,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;KACd,GAAG;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE;EAiCvB"}

package/server/application/files/local-filesystem.js

@@ -0,0 +1,171 @@
+import { execFile } from "node:child_process";
+import { accessSync, constants as fsConstants, mkdirSync, readdirSync, realpathSync, statSync, } from "node:fs";
+import { homedir, platform } from "node:os";
+import { join, resolve } from "node:path";
+import { promisify } from "node:util";
+import { expandUserHome } from "../../lib/path.js";
+import { FileAccessError, FileExistsError, FileNotFoundError, FileReadError, FileWriteError, UnsupportedPlatformError, } from "./errors.js";
+const execFileAsync = promisify(execFile);
+export class InvalidDirectoryNameError extends Error {
+    constructor(message = "Invalid directory name") {
+        super(message);
+        this.name = "InvalidDirectoryNameError";
+    }
+}
+async function defaultPickFolder(os) {
+    if (os === "darwin") {
+        const { stdout } = await execFileAsync("osascript", [
+            "-e",
+            'set theFolder to choose folder with prompt "Select project folder"',
+            "-e",
+            "POSIX path of theFolder",
+        ], { timeout: 60_000 });
+        return stdout.trim().replace(/\/$/, "") || null;
+    }
+    if (os === "linux") {
+        const { stdout } = await execFileAsync("zenity", ["--file-selection", "--directory", "--title=Select project folder"], { timeout: 60_000 });
+        return stdout.trim() || null;
+    }
+    throw new UnsupportedPlatformError();
+}
+function defaultNormalizePath(path) {
+    return realpathSync(resolve(path));
+}
+function defaultBrowseHomeDirectories(targetPath) {
+    return readdirSync(targetPath)
+        .filter((name) => !name.startsWith("."))
+        .filter((name) => {
+        try {
+            return statSync(join(targetPath, name)).isDirectory();
+        }
+        catch {
+            return false;
+        }
+    })
+        .sort()
+        .map((name) => ({
+        name,
+        path: join(targetPath, name),
+        type: "directory",
+    }));
+}
+function defaultCreateDirectory(targetPath) {
+    mkdirSync(targetPath);
+}
+function defaultStatPath(targetPath) {
+    try {
+        const s = statSync(targetPath);
+        return { isDirectory: s.isDirectory() };
+    }
+    catch {
+        return null;
+    }
+}
+function defaultCheckWritable(targetPath) {
+    try {
+        accessSync(targetPath, fsConstants.W_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+const ILLEGAL_NAME_CHARS = /[/\\]/;
+function validateDirectoryName(name) {
+    const trimmed = name.trim();
+    if (!trimmed)
+        throw new InvalidDirectoryNameError("Name is required");
+    if (trimmed === "." || trimmed === "..") {
+        throw new InvalidDirectoryNameError("Name cannot be '.' or '..'");
+    }
+    if (ILLEGAL_NAME_CHARS.test(trimmed)) {
+        throw new InvalidDirectoryNameError("Name cannot contain '/' or '\\'");
+    }
+    return trimmed;
+}
+export function createLocalFilesystem({ browseHomeDirectories = defaultBrowseHomeDirectories, createDirectory = defaultCreateDirectory, getHomeDir = homedir, getPlatform = platform, normalizePath = defaultNormalizePath, pickFolder = defaultPickFolder, statPath = defaultStatPath, checkWritable = defaultCheckWritable, } = {}) {
+    function resolveUnderHome(rawPath) {
+        const home = getHomeDir();
+        const requestedPath = expandUserHome(rawPath, home);
+        let targetPath;
+        try {
+            targetPath = normalizePath(requestedPath);
+        }
+        catch {
+            throw new FileNotFoundError("Directory not found");
+        }
+        const realHome = normalizePath(home);
+        if (targetPath !== realHome && !targetPath.startsWith(`${realHome}/`)) {
+            throw new FileAccessError();
+        }
+        return targetPath;
+    }
+    return {
+        browseDirectories(rawPath) {
+            const home = getHomeDir();
+            let targetPath;
+            const requestedPath = expandUserHome(rawPath ?? home, home);
+            try {
+                targetPath = normalizePath(requestedPath);
+            }
+            catch {
+                throw new FileReadError("Cannot read directory");
+            }
+            const realHome = normalizePath(home);
+            if (targetPath !== realHome && !targetPath.startsWith(`${realHome}/`)) {
+                throw new FileAccessError();
+            }
+            try {
+                const entries = browseHomeDirectories(targetPath);
+                const parent = targetPath === realHome ? null : resolve(targetPath, "..");
+                return { path: targetPath, parent, entries };
+            }
+            catch {
+                throw new FileReadError("Cannot read directory");
+            }
+        },
+        async pickProjectFolder() {
+            try {
+                return await pickFolder(getPlatform());
+            }
+            catch (error) {
+                if (error instanceof UnsupportedPlatformError) {
+                    throw error;
+                }
+                return null;
+            }
+        },
+        createProjectDirectory({ parent, name, }) {
+            const cleanName = validateDirectoryName(name);
+            const parentPath = resolveUnderHome(parent);
+            const parentStat = statPath(parentPath);
+            if (!parentStat?.isDirectory) {
+                throw new FileNotFoundError("Parent directory not found");
+            }
+            if (!checkWritable(parentPath)) {
+                throw new FileAccessError("Parent directory is not writable");
+            }
+            const targetPath = join(parentPath, cleanName);
+            const existing = statPath(targetPath);
+            if (existing) {
+                throw new FileExistsError("Directory already exists");
+            }
+            try {
+                createDirectory(targetPath);
+            }
+            catch (error) {
+                const code = error && typeof error === "object" && "code" in error
+                    ? error.code
+                    : undefined;
+                if (code === "EEXIST")
+                    throw new FileExistsError();
+                if (code === "EACCES" || code === "EPERM") {
+                    throw new FileAccessError("Cannot write to parent directory");
+                }
+                throw new FileWriteError(error instanceof Error ? error.message : "Cannot create directory");
+            }
+            return { path: targetPath };
+        },
+    };
+}
+//# sourceMappingURL=local-filesystem.js.map