@tt-a1i/hive 0.6.0-alpha.0

package/dist/src/server/dispatch-ledger-store.js

@@ -0,0 +1,196 @@
+import { randomUUID } from 'node:crypto';
+const parseArtifacts = (value) => {
+    if (!value)
+        return [];
+    try {
+        const parsed = JSON.parse(value);
+        return Array.isArray(parsed)
+            ? parsed.filter((artifact) => typeof artifact === 'string')
+            : [];
+    }
+    catch {
+        return [];
+    }
+};
+const toRecord = (row) => ({
+    artifacts: parseArtifacts(row.artifacts),
+    createdAt: row.created_at,
+    deliveredAt: row.delivered_at,
+    fromAgentId: row.from_agent_id,
+    id: row.id,
+    reportedAt: row.reported_at,
+    reportText: row.report_text,
+    sequence: row.sequence,
+    status: row.status,
+    submittedAt: row.submitted_at,
+    text: row.text,
+    toAgentId: row.to_agent_id,
+    workspaceId: row.workspace_id,
+});
+export const createDispatchLedgerStore = (db) => {
+    const memoryDispatches = new Map();
+    const createDispatch = (input) => {
+        const record = {
+            artifacts: [],
+            createdAt: Date.now(),
+            deliveredAt: null,
+            fromAgentId: input.fromAgentId ?? null,
+            id: randomUUID(),
+            reportedAt: null,
+            reportText: null,
+            sequence: null,
+            status: 'queued',
+            submittedAt: null,
+            text: input.text,
+            toAgentId: input.toAgentId,
+            workspaceId: input.workspaceId,
+        };
+        if (!db) {
+            record.sequence = memoryDispatches.size + 1;
+            memoryDispatches.set(record.id, record);
+            return record;
+        }
+        db.prepare(`INSERT INTO dispatches (
+        id,
+        workspace_id,
+        from_agent_id,
+        to_agent_id,
+        text,
+        status,
+        created_at,
+        delivered_at,
+        submitted_at,
+        reported_at,
+        report_text,
+        artifacts
+      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`).run(record.id, record.workspaceId, record.fromAgentId, record.toAgentId, record.text, record.status, record.createdAt, record.deliveredAt, record.submittedAt, record.reportedAt, record.reportText, JSON.stringify(record.artifacts));
+        return record;
+    };
+    const deleteDispatch = (dispatchId) => {
+        if (!db) {
+            memoryDispatches.delete(dispatchId);
+            return;
+        }
+        db.prepare('DELETE FROM dispatches WHERE id = ?').run(dispatchId);
+    };
+    const markSubmitted = (dispatchId) => {
+        const submittedAt = Date.now();
+        if (!db) {
+            const record = memoryDispatches.get(dispatchId);
+            if (record) {
+                record.status = 'submitted';
+                record.submittedAt = submittedAt;
+            }
+            return;
+        }
+        db.prepare(`UPDATE dispatches
+       SET status = ?, submitted_at = ?
+       WHERE id = ?`).run('submitted', submittedAt, dispatchId);
+    };
+    const findOpenDispatch = (workspaceId, toAgentId) => {
+        if (!db) {
+            return Array.from(memoryDispatches.values())
+                .filter((record) => record.workspaceId === workspaceId &&
+                record.toAgentId === toAgentId &&
+                record.status !== 'reported')
+                .sort((a, b) => (a.sequence ?? a.createdAt) - (b.sequence ?? b.createdAt))[0];
+        }
+        const row = db
+            .prepare(`SELECT *
+         FROM dispatches
+         WHERE workspace_id = ?
+           AND to_agent_id = ?
+           AND status != 'reported'
+         ORDER BY sequence ASC
+         LIMIT 1`)
+            .get(workspaceId, toAgentId);
+        return row ? toRecord(row) : undefined;
+    };
+    const markReportedByWorker = (input) => {
+        const dispatch = findOpenDispatch(input.workspaceId, input.toAgentId);
+        if (!dispatch) {
+            return undefined;
+        }
+        const reportedAt = Date.now();
+        if (!db) {
+            dispatch.status = 'reported';
+            dispatch.reportedAt = reportedAt;
+            dispatch.reportText = input.reportText;
+            dispatch.artifacts = input.artifacts;
+            return dispatch;
+        }
+        db.prepare(`UPDATE dispatches
+       SET status = ?,
+           reported_at = ?,
+           report_text = ?,
+           artifacts = ?
+       WHERE id = ?`).run('reported', reportedAt, input.reportText, JSON.stringify(input.artifacts), dispatch.id);
+        return {
+            ...dispatch,
+            artifacts: input.artifacts,
+            reportedAt,
+            reportText: input.reportText,
+            status: 'reported',
+        };
+    };
+    const listWorkspaceDispatches = (workspaceId, options = {}) => {
+        const offset = options.offset ?? 0;
+        const limit = options.limit ?? 100;
+        if (!db) {
+            return Array.from(memoryDispatches.values())
+                .filter((record) => record.workspaceId === workspaceId &&
+                (options.status === undefined || record.status === options.status))
+                .sort((a, b) => (a.sequence ?? a.createdAt) - (b.sequence ?? b.createdAt))
+                .slice(offset, offset + limit);
+        }
+        if (options.status) {
+            return db
+                .prepare(`SELECT *
+             FROM dispatches
+             WHERE workspace_id = ?
+               AND status = ?
+             ORDER BY sequence ASC
+             LIMIT ? OFFSET ?`)
+                .all(workspaceId, options.status, limit, offset).map(toRecord);
+        }
+        return db
+            .prepare(`SELECT *
+           FROM dispatches
+           WHERE workspace_id = ?
+           ORDER BY sequence ASC
+           LIMIT ? OFFSET ?`)
+            .all(workspaceId, limit, offset).map(toRecord);
+    };
+    const deleteWorkspaceDispatches = (workspaceId) => {
+        if (!db) {
+            for (const [id, record] of memoryDispatches) {
+                if (record.workspaceId === workspaceId)
+                    memoryDispatches.delete(id);
+            }
+            return;
+        }
+        db.prepare('DELETE FROM dispatches WHERE workspace_id = ?').run(workspaceId);
+    };
+    const deleteWorkerDispatches = (workspaceId, workerId) => {
+        if (!db) {
+            for (const [id, record] of memoryDispatches) {
+                if (record.workspaceId === workspaceId && record.toAgentId === workerId) {
+                    memoryDispatches.delete(id);
+                }
+            }
+            return;
+        }
+        db.prepare('DELETE FROM dispatches WHERE workspace_id = ? AND to_agent_id = ?').run(workspaceId, workerId);
+    };
+    return {
+        createDispatch,
+        deleteDispatch,
+        deleteWorkerDispatches,
+        deleteWorkspaceDispatches,
+        findOpenDispatch,
+        listWorkspaceDispatches,
+        markReportedByWorker,
+        markSubmitted,
+    };
+};
+//# sourceMappingURL=dispatch-ledger-store.js.map

package/dist/src/server/dispatch-ledger-store.js.map

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

package/dist/src/server/env-sync-message.d.ts

@@ -0,0 +1,9 @@
+import type { AgentSummary, WorkspaceSummary } from '../shared/types.js';
+import type { RecoveryMessage } from './message-log-store.js';
+export declare const buildEnvSyncMessage: ({ agent, tasksContent, workers, workspace, restartWindowMessages, }: {
+    agent: AgentSummary;
+    tasksContent: string;
+    workers: AgentSummary[];
+    workspace: WorkspaceSummary;
+    restartWindowMessages: RecoveryMessage[];
+}) => string;

package/dist/src/server/env-sync-message.js

@@ -0,0 +1,30 @@
+import { getHiveTeamRules } from './hive-team-guidance.js';
+import { wrapSystemMessage } from './system-message.js';
+import { TASKS_RELATIVE_PATH } from './tasks-file.js';
+const TASKS_HEAD_LIMIT = 1024;
+const formatWorkers = (workers) => {
+    if (workers.length === 0)
+        return ['- 当前没有其他 worker'];
+    return workers.map((worker) => `- ${worker.name} (${worker.role}, ${worker.status}, pending_task_count: ${worker.pendingTaskCount})`);
+};
+const formatRestartWindow = (messages) => {
+    const sends = messages.filter((message) => {
+        return message.type === 'send';
+    });
+    if (sends.length === 0)
+        return ['- 重启期间未派新单'];
+    return sends.slice(-5).map((message) => `- send -> ${message.to}: ${message.text}`);
+};
+export const buildEnvSyncMessage = ({ agent, tasksContent, workers, workspace, restartWindowMessages, }) => wrapSystemMessage([
+    '你刚被 Hive 重启了。期间环境变化：',
+    `- 当前 workspace: ${workspace.name}`,
+    '- 现有 worker:',
+    ...formatWorkers(workers),
+    `- ${TASKS_RELATIVE_PATH} 当前内容:`,
+    tasksContent.slice(0, TASKS_HEAD_LIMIT) || '(空)',
+    ...formatRestartWindow(restartWindowMessages),
+    agent.role === 'orchestrator' ? '- Hive worker 派单规则:' : '- Hive worker 边界:',
+    ...getHiveTeamRules(agent).map((rule) => `  - ${rule}`),
+    `请继续。如果不确定，用 team list / Read ${TASKS_RELATIVE_PATH} 自查或问 user。`,
+].join('\n'));
+//# sourceMappingURL=env-sync-message.js.map

package/dist/src/server/env-sync-message.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-sync-message.js","sourceRoot":"","sources":["../../../src/server/env-sync-message.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AAE1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AACvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AAErD,MAAM,gBAAgB,GAAG,IAAI,CAAA;AAE7B,MAAM,aAAa,GAAG,CAAC,OAAuB,EAAE,EAAE;IAChD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,iBAAiB,CAAC,CAAA;IACpD,OAAO,OAAO,CAAC,GAAG,CAChB,CAAC,MAAM,EAAE,EAAE,CACT,KAAK,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,MAAM,yBAAyB,MAAM,CAAC,gBAAgB,GAAG,CACxG,CAAA;AACH,CAAC,CAAA;AAED,MAAM,mBAAmB,GAAG,CAAC,QAA2B,EAAE,EAAE;IAC1D,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAC3B,CAAC,OAAO,EAAyD,EAAE;QACjE,OAAO,OAAO,CAAC,IAAI,KAAK,MAAM,CAAA;IAChC,CAAC,CACF,CAAA;IACD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,YAAY,CAAC,CAAA;IAC7C,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,aAAa,OAAO,CAAC,EAAE,KAAK,OAAO,CAAC,IAAI,EAAE,CAAC,CAAA;AACrF,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,EAClC,KAAK,EACL,YAAY,EACZ,OAAO,EACP,SAAS,EACT,qBAAqB,GAOtB,EAAE,EAAE,CACH,iBAAiB,CACf;IACE,sBAAsB;IACtB,mBAAmB,SAAS,CAAC,IAAI,EAAE;IACnC,cAAc;IACd,GAAG,aAAa,CAAC,OAAO,CAAC;IACzB,KAAK,mBAAmB,QAAQ;IAChC,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,gBAAgB,CAAC,IAAI,KAAK;IAChD,GAAG,mBAAmB,CAAC,qBAAqB,CAAC;IAC7C,KAAK,CAAC,IAAI,KAAK,cAAc,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,mBAAmB;IAC3E,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,IAAI,EAAE,CAAC;IACvD,gCAAgC,mBAAmB,aAAa;CACjE,CAAC,IAAI,CAAC,IAAI,CAAC,CACb,CAAA"}

package/dist/src/server/fs-browse.d.ts

@@ -0,0 +1,25 @@
+export interface FsBrowseEntry {
+    is_dir: true;
+    is_git_repository: boolean;
+    name: string;
+    path: string;
+}
+export interface FsBrowseResponse {
+    current_path: string;
+    entries: FsBrowseEntry[];
+    error: string | null;
+    ok: boolean;
+    parent_path: string | null;
+    root_path: string;
+}
+export interface FsProbeResponse {
+    current_branch: string | null;
+    exists: boolean;
+    is_dir: boolean;
+    is_git_repository: boolean;
+    ok: boolean;
+    path: string;
+    suggested_name: string;
+}
+export declare const browseDirectory: (requestedPath: string) => Promise<FsBrowseResponse>;
+export declare const probeDirectory: (requestedPath: string) => Promise<FsProbeResponse>;

package/dist/src/server/fs-browse.js

@@ -0,0 +1,130 @@
+import { execFile } from 'node:child_process';
+import { readdir, stat } from 'node:fs/promises';
+import { dirname, resolve } from 'node:path';
+import { promisify } from 'node:util';
+import { getFsBrowseRoot, isPathWithinRoot } from './fs-sandbox.js';
+const execFileP = promisify(execFile);
+const GIT_BRANCH_TIMEOUT_MS = 800;
+const detectGitRepository = async (entryPath) => {
+    try {
+        const info = await stat(resolve(entryPath, '.git'));
+        return info.isDirectory() || info.isFile();
+    }
+    catch {
+        return false;
+    }
+};
+const readCurrentBranch = async (repoPath) => {
+    try {
+        const { stdout } = await execFileP('git', ['-C', repoPath, 'rev-parse', '--abbrev-ref', 'HEAD'], {
+            timeout: GIT_BRANCH_TIMEOUT_MS,
+            windowsHide: true,
+        });
+        const branch = stdout.trim();
+        return branch.length > 0 ? branch : null;
+    }
+    catch {
+        return null;
+    }
+};
+export const browseDirectory = async (requestedPath) => {
+    const rootPath = getFsBrowseRoot();
+    const trimmed = requestedPath.trim();
+    const candidate = trimmed.length === 0 ? rootPath : resolve(rootPath, trimmed);
+    if (!isPathWithinRoot(rootPath, candidate)) {
+        return {
+            current_path: rootPath,
+            entries: [],
+            error: 'Access denied: path is outside the browse root.',
+            ok: false,
+            parent_path: null,
+            root_path: rootPath,
+        };
+    }
+    let dirStat;
+    try {
+        dirStat = await stat(candidate);
+    }
+    catch (error) {
+        return {
+            current_path: candidate,
+            entries: [],
+            error: error instanceof Error ? error.message : 'Failed to stat directory',
+            ok: false,
+            parent_path: null,
+            root_path: rootPath,
+        };
+    }
+    if (!dirStat.isDirectory()) {
+        return {
+            current_path: candidate,
+            entries: [],
+            error: 'The specified path is not a directory.',
+            ok: false,
+            parent_path: null,
+            root_path: rootPath,
+        };
+    }
+    const rawEntries = await readdir(candidate, { withFileTypes: true });
+    const directoryEntries = rawEntries
+        .filter((entry) => entry.isDirectory() && !entry.name.startsWith('.'))
+        .sort((a, b) => a.name.localeCompare(b.name));
+    const entries = await Promise.all(directoryEntries.map(async (entry) => {
+        const entryPath = resolve(candidate, entry.name);
+        return {
+            is_dir: true,
+            is_git_repository: await detectGitRepository(entryPath),
+            name: entry.name,
+            path: entryPath,
+        };
+    }));
+    const isAtRoot = candidate === rootPath;
+    const rawParent = dirname(candidate);
+    const parentIsWithinRoot = isPathWithinRoot(rootPath, rawParent);
+    const parent_path = isAtRoot ? null : parentIsWithinRoot ? rawParent : null;
+    return {
+        current_path: candidate,
+        entries,
+        error: null,
+        ok: true,
+        parent_path,
+        root_path: rootPath,
+    };
+};
+export const probeDirectory = async (requestedPath) => {
+    const rootPath = getFsBrowseRoot();
+    const candidate = resolve(rootPath, requestedPath.trim());
+    const base = {
+        current_branch: null,
+        exists: false,
+        is_dir: false,
+        is_git_repository: false,
+        ok: false,
+        path: candidate,
+        suggested_name: candidate.split(/[\\/]/).filter(Boolean).pop() ?? '',
+    };
+    if (!isPathWithinRoot(rootPath, candidate)) {
+        return base;
+    }
+    try {
+        const info = await stat(candidate);
+        if (!info.isDirectory()) {
+            return { ...base, exists: true, is_dir: false, ok: true };
+        }
+        const is_git_repository = await detectGitRepository(candidate);
+        const current_branch = is_git_repository ? await readCurrentBranch(candidate) : null;
+        return {
+            current_branch,
+            exists: true,
+            is_dir: true,
+            is_git_repository,
+            ok: true,
+            path: candidate,
+            suggested_name: base.suggested_name,
+        };
+    }
+    catch {
+        return base;
+    }
+};
+//# sourceMappingURL=fs-browse.js.map

package/dist/src/server/fs-browse.js.map

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

package/dist/src/server/fs-pick-folder.d.ts

@@ -0,0 +1,25 @@
+import { type ExecFileOptions } from 'node:child_process';
+import { type FsProbeResponse } from './fs-browse.js';
+type SpawnResult = {
+    stderr: string;
+    stdout: string;
+    status: number | null;
+    signal: string | null;
+    timedOut: boolean;
+    spawnError: NodeJS.ErrnoException | null;
+};
+export type RunPickCommand = (command: string, args: string[], options: ExecFileOptions) => Promise<SpawnResult>;
+export interface PickFolderOptions {
+    now?: () => number;
+    platform?: NodeJS.Platform;
+    runCommand?: RunPickCommand;
+}
+export interface PickFolderResponse {
+    canceled: boolean;
+    error: string | null;
+    path: string | null;
+    probe: FsProbeResponse | null;
+    supported: boolean;
+}
+export declare const pickFolder: (options?: PickFolderOptions) => Promise<PickFolderResponse>;
+export {};

package/dist/src/server/fs-pick-folder.js

@@ -0,0 +1,132 @@
+import { execFile } from 'node:child_process';
+import { probeDirectory } from './fs-browse.js';
+// macOS Cocoa returns -1743 when the user clicks Cancel in `choose folder`.
+// osascript maps that to exit code 1 with the message on stderr.
+const MACOS_CANCEL_PATTERNS = [/-128/, /-1743/, /user canceled/i, /execution error/i];
+// zenity documents exit code 1 on Cancel. kdialog uses exit code 1 as well.
+const LINUX_CANCEL_EXIT_CODES = new Set([1]);
+const defaultRunCommand = (command, args, options) => new Promise((resolve) => {
+    const child = execFile(command, args, options, (error, stdout, stderr) => {
+        const errno = error;
+        const timedOut = !!errno?.killed && errno?.signal === 'SIGTERM';
+        // execFile surfaces ENOENT when the binary is missing; keep the raw errno
+        // so the caller can distinguish "command not installed" from "user cancel".
+        resolve({
+            stderr: String(stderr ?? ''),
+            stdout: String(stdout ?? ''),
+            status: typeof errno?.code === 'number' ? errno.code : (child.exitCode ?? 0),
+            signal: typeof errno?.signal === 'string' ? errno.signal : null,
+            spawnError: errno && typeof errno.code === 'string' ? errno : null,
+            timedOut,
+        });
+    });
+});
+const emptyResponse = (overrides = {}) => ({
+    canceled: false,
+    error: null,
+    path: null,
+    probe: null,
+    supported: true,
+    ...overrides,
+});
+const finalizeWithProbe = async (path) => {
+    const probe = await probeDirectory(path);
+    if (!probe.ok || !probe.is_dir) {
+        return emptyResponse({
+            error: 'Selected path is outside the Hive browse sandbox or is not a directory.',
+            path,
+            probe,
+        });
+    }
+    return emptyResponse({ path: probe.path, probe });
+};
+const macOsPick = async (run) => {
+    const script = 'POSIX path of (choose folder with prompt "Select Hive workspace")';
+    const result = await run('osascript', ['-e', script], {});
+    if (result.spawnError?.code === 'ENOENT') {
+        return emptyResponse({ error: 'osascript is unavailable on this host.', supported: false });
+    }
+    if (result.timedOut) {
+        return emptyResponse({ error: 'Folder picker timed out before a folder was selected.' });
+    }
+    const combinedStderr = result.stderr.toLowerCase();
+    if (result.status !== 0) {
+        if (MACOS_CANCEL_PATTERNS.some((re) => re.test(combinedStderr))) {
+            return emptyResponse({ canceled: true });
+        }
+        // Any non-zero exit code without stdout is treated as cancel rather than a
+        // hard failure — the user is just closing the dialog.
+        if (result.stdout.trim().length === 0)
+            return emptyResponse({ canceled: true });
+    }
+    const picked = result.stdout.trim().replace(/\/$/, '');
+    if (picked.length === 0)
+        return emptyResponse({ canceled: true });
+    return finalizeWithProbe(picked);
+};
+const linuxPick = async (run) => {
+    const result = await run('zenity', ['--file-selection', '--directory', '--title=Select Hive workspace'], {});
+    if (result.spawnError?.code === 'ENOENT') {
+        return emptyResponse({
+            error: 'zenity not installed. Install zenity or use Advanced: paste path.',
+            supported: false,
+        });
+    }
+    if (result.timedOut) {
+        return emptyResponse({ error: 'Folder picker timed out before a folder was selected.' });
+    }
+    if (result.status !== 0 && LINUX_CANCEL_EXIT_CODES.has(result.status ?? 0)) {
+        return emptyResponse({ canceled: true });
+    }
+    const picked = result.stdout.trim();
+    if (picked.length === 0)
+        return emptyResponse({ canceled: true });
+    return finalizeWithProbe(picked);
+};
+const windowsPick = async (run) => {
+    const script = [
+        'Add-Type -AssemblyName System.Windows.Forms',
+        '$dialog = New-Object System.Windows.Forms.FolderBrowserDialog',
+        '$dialog.Description = "Select Hive workspace"',
+        '$dialog.ShowNewFolderButton = $false',
+        '$result = $dialog.ShowDialog()',
+        'if ($result -eq [System.Windows.Forms.DialogResult]::OK) { [Console]::Out.WriteLine($dialog.SelectedPath); exit 0 }',
+        'exit 1',
+    ].join('; ');
+    const result = await run('powershell.exe', ['-NoProfile', '-STA', '-ExecutionPolicy', 'Bypass', '-Command', script], {});
+    if (result.spawnError?.code === 'ENOENT') {
+        return emptyResponse({
+            error: 'PowerShell is unavailable on this host. Use Advanced: paste path.',
+            supported: false,
+        });
+    }
+    if (result.timedOut) {
+        return emptyResponse({ error: 'Folder picker timed out before a folder was selected.' });
+    }
+    if (result.status !== 0) {
+        const stderr = result.stderr.trim();
+        if (stderr.length > 0) {
+            return emptyResponse({ error: `Folder picker failed: ${stderr}` });
+        }
+        return emptyResponse({ canceled: true });
+    }
+    const picked = result.stdout.trim();
+    if (picked.length === 0)
+        return emptyResponse({ canceled: true });
+    return finalizeWithProbe(picked);
+};
+export const pickFolder = async (options = {}) => {
+    const platform = options.platform ?? process.platform;
+    const run = options.runCommand ?? defaultRunCommand;
+    if (platform === 'darwin')
+        return macOsPick(run);
+    if (platform === 'linux')
+        return linuxPick(run);
+    if (platform === 'win32')
+        return windowsPick(run);
+    return emptyResponse({
+        error: 'Native folder picker not supported on this platform. Use Advanced: paste path.',
+        supported: false,
+    });
+};
+//# sourceMappingURL=fs-pick-folder.js.map

package/dist/src/server/fs-pick-folder.js.map

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

package/dist/src/server/fs-sandbox.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Root directory the FS-browse API is allowed to reveal. We sandbox to
+ * `$HOME` (override via `HIVE_FS_BROWSE_ROOT` for tests). Anything outside
+ * this prefix is rejected before readdir/stat even runs.
+ */
+export declare const getFsBrowseRoot: () => string;
+/**
+ * True when `candidatePath` is `rootPath` itself or a descendant of it.
+ * Uses `path.relative` + separator check so Windows back-slashes and drive
+ * boundaries are handled correctly — identical shape to kanban's
+ * isPathWithinRoot so the semantics match a project we already trust.
+ */
+export declare const isPathWithinRoot: (rootPath: string, candidatePath: string) => boolean;

package/dist/src/server/fs-sandbox.js

@@ -0,0 +1,26 @@
+import { homedir } from 'node:os';
+import { isAbsolute, relative, resolve, sep } from 'node:path';
+/**
+ * Root directory the FS-browse API is allowed to reveal. We sandbox to
+ * `$HOME` (override via `HIVE_FS_BROWSE_ROOT` for tests). Anything outside
+ * this prefix is rejected before readdir/stat even runs.
+ */
+export const getFsBrowseRoot = () => {
+    const override = process.env.HIVE_FS_BROWSE_ROOT;
+    return override && override.length > 0 ? resolve(override) : resolve(homedir());
+};
+/**
+ * True when `candidatePath` is `rootPath` itself or a descendant of it.
+ * Uses `path.relative` + separator check so Windows back-slashes and drive
+ * boundaries are handled correctly — identical shape to kanban's
+ * isPathWithinRoot so the semantics match a project we already trust.
+ */
+export const isPathWithinRoot = (rootPath, candidatePath) => {
+    const resolvedRoot = resolve(rootPath);
+    const resolvedCandidate = resolve(candidatePath);
+    if (resolvedCandidate === resolvedRoot)
+        return true;
+    const rel = relative(resolvedRoot, resolvedCandidate);
+    return rel !== '..' && !rel.startsWith(`..${sep}`) && !isAbsolute(rel);
+};
+//# sourceMappingURL=fs-sandbox.js.map

package/dist/src/server/fs-sandbox.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-sandbox.js","sourceRoot":"","sources":["../../../src/server/fs-sandbox.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AACjC,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAA;AAE9D;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,GAAW,EAAE;IAC1C,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAA;IAChD,OAAO,QAAQ,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,CAAA;AACjF,CAAC,CAAA;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,QAAgB,EAAE,aAAqB,EAAW,EAAE;IACnF,MAAM,YAAY,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;IACtC,MAAM,iBAAiB,GAAG,OAAO,CAAC,aAAa,CAAC,CAAA;IAChD,IAAI,iBAAiB,KAAK,YAAY;QAAE,OAAO,IAAI,CAAA;IACnD,MAAM,GAAG,GAAG,QAAQ,CAAC,YAAY,EAAE,iBAAiB,CAAC,CAAA;IACrD,OAAO,GAAG,KAAK,IAAI,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,GAAG,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAA;AACxE,CAAC,CAAA"}

package/dist/src/server/hive-team-guidance.d.ts

@@ -0,0 +1,2 @@
+import type { AgentSummary } from '../shared/types.js';
+export declare const getHiveTeamRules: (agent: Pick<AgentSummary, "role">) => string[];

package/dist/src/server/hive-team-guidance.js

@@ -0,0 +1,14 @@
+const ORCHESTRATOR_RULES = [
+    'Hive worker 是右侧卡片里的真实 CLI agent，不是 Claude Code 内置的 Task / Explore / subagent。',
+    '当 user 要你“让 worker ... / 给 worker 找活 / 让成员处理”时，先执行 `team list` 确认真实 Hive worker。',
+    '如果只有一个可用 worker，直接用 `team send <worker-name> "<task>"` 派给它；不要把选择题丢回给 user。',
+    '当 user 要你“让 worker ...”时，必须用 `team send <worker-name> "<task>"` 派给 Hive worker。',
+    '不要使用 Claude Code 内置的 Task / Explore / subagent 来代替 Hive worker；它们不会出现在 Hive UI，也不会触发 pending_task_count / team report。',
+];
+const WORKER_RULES = [
+    '你是 Hive 右侧卡片里的真实 CLI worker，不是 Claude Code 内置 subagent。',
+    '不要调用 team send，也不要再启动 Claude Code 内置的 Task / Explore / subagent 来替你完成派单。',
+    '完成或阻塞时必须用 `team report` 汇报给 Orchestrator。',
+];
+export const getHiveTeamRules = (agent) => agent.role === 'orchestrator' ? ORCHESTRATOR_RULES : WORKER_RULES;
+//# sourceMappingURL=hive-team-guidance.js.map