crewly 1.20.327 → 1.20.330

package/dist/backend/backend/src/services/file-handoff/file-handoff.service.js

@@ -0,0 +1,454 @@
+/**
+ * Automatic cross-machine file hand-off.
+ *
+ * Agents on different machines cannot open each other's local paths. This
+ * service moves the file through Cloud's file-handoff relay (the same one the
+ * `send-file` / `receive-file` skills use) so nobody has to paste an
+ * instruction by hand:
+ *
+ *  - Sender: {@link FileHandoffService.attachToMessage} uploads the files an
+ *    agent attached (`--file`) or mentioned by path, and appends one compact
+ *    marker line per file to the message text.
+ *  - Receiver: {@link FileHandoffService.expandInbound} finds the markers in
+ *    a delivered message, downloads each file into the project inbox, and
+ *    rewrites the marker to the local path.
+ *
+ * Marker format (readable in Slack): `📎 report.pdf (2.1 MB) · crewly-file:hf_xxx`.
+ *
+ * @module services/file-handoff/file-handoff.service
+ */
+import * as fs from 'fs';
+import * as http from 'http';
+import * as https from 'https';
+import * as os from 'os';
+import * as path from 'path';
+import { FILE_HANDOFF_CONSTANTS as C } from '../../constants.js';
+import { redactSecretsWithCount } from '../../utils/secret-redactor.js';
+// ---------------------------------------------------------------------------
+// Pure helpers
+// ---------------------------------------------------------------------------
+const MARKER_ID_RE = new RegExp(`${escapeRe(C.MARKER_PREFIX)}(${C.ID_PATTERN})`, 'g');
+const MARKER_TOKEN_RE = new RegExp(`(?:${escapeRe(C.MARKER_GLYPH)}[^\\n]*?·\\s*)?${escapeRe(C.MARKER_PREFIX)}(${C.ID_PATTERN})`, 'g');
+const KIB = 1024;
+const SIZE_UNITS = ['B', 'KB', 'MB', 'GB'];
+/** Characters that end a path written in prose */
+const PATH_TRAILING_PUNCT = /[.,;:!?)\]}>'"`]+$/;
+/** Absolute or `./relative` paths in free text */
+const PATH_IN_TEXT_RE = /(?:^|[\s"'`(<[])((?:\/|\.\/)[^\s"'`)>\]]+)/g;
+function escapeRe(s) {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+/**
+ * Human size, e.g. `2.1 MB`.
+ *
+ * @param bytes - Size in bytes
+ * @returns Short size string
+ */
+export function formatSize(bytes) {
+    let value = bytes;
+    let unit = 0;
+    while (value >= KIB && unit < SIZE_UNITS.length - 1) {
+        value /= KIB;
+        unit += 1;
+    }
+    const text = unit === 0 || value >= 10 ? String(Math.round(value)) : value.toFixed(1);
+    return `${text} ${SIZE_UNITS[unit]}`;
+}
+/**
+ * The marker line for one uploaded file.
+ *
+ * @param fileName - Name the receiver sees
+ * @param sizeBytes - File size
+ * @param handoffId - Cloud handoff id
+ * @returns `📎 report.pdf (2.1 MB) · crewly-file:hf_xxx`
+ */
+export function formatMarker(fileName, sizeBytes, handoffId) {
+    const safeName = fileName.replace(/[\r\n]+/g, ' ').trim() || 'file';
+    return `${C.MARKER_GLYPH} ${safeName} (${formatSize(sizeBytes)}) · ${C.MARKER_PREFIX}${handoffId}`;
+}
+/**
+ * Handoff ids named by markers in a text, first occurrence order, no repeats.
+ *
+ * @param text - Message text
+ * @returns Handoff ids
+ */
+export function findMarkerIds(text) {
+    const ids = [];
+    for (const m of text.matchAll(MARKER_ID_RE)) {
+        if (!ids.includes(m[1]))
+            ids.push(m[1]);
+    }
+    return ids;
+}
+/**
+ * Absolute (`/x/y`) and `./relative` paths written in a text.
+ *
+ * @param text - Message text
+ * @returns Candidate paths in order, without duplicates
+ */
+export function extractPathCandidates(text) {
+    const found = [];
+    for (const m of text.matchAll(PATH_IN_TEXT_RE)) {
+        const p = m[1].replace(PATH_TRAILING_PUNCT, '');
+        if (p.length > 2 && !found.includes(p))
+            found.push(p);
+    }
+    return found;
+}
+/**
+ * Whether a file name or path is one that must never leave the machine
+ * (`.env*`, keys, credentials, anything under `.ssh` / `.aws` / `.git`).
+ *
+ * @param file - File path
+ * @returns True for an obvious secret
+ */
+export function isSecretPath(file) {
+    const parts = file.split(path.sep).filter(Boolean).map((s) => s.toLowerCase());
+    const name = parts[parts.length - 1] ?? '';
+    if (C.SECRET_NAME_PATTERNS.some((re) => re.test(name)))
+        return true;
+    return parts.slice(0, -1).some((d) => C.SECRET_DIR_NAMES.includes(d));
+}
+function within(child, parent) {
+    return child === parent || child.startsWith(parent.endsWith(path.sep) ? parent : parent + path.sep);
+}
+function real(p) {
+    try {
+        return fs.realpathSync(p);
+    }
+    catch {
+        return null;
+    }
+}
+/** A safe local file name (last segment, no leading dots or control characters). */
+function safeName(name) {
+    // eslint-disable-next-line no-control-regex
+    const base = name.replace(/\\/g, '/').split('/').pop().replace(/[\u0000-\u001f]/g, '').replace(/^[.\s]+/, '').trim();
+    return base || 'file';
+}
+// ---------------------------------------------------------------------------
+// Network (streamed from / to disk, never buffered)
+// ---------------------------------------------------------------------------
+/** Default {@link PutFileFn}: a streamed `PUT` with an exact Content-Length. */
+export const putFileStreamed = (target, file, sizeBytes, timeoutMs) => new Promise((resolve, reject) => {
+    const url = new URL(target.url);
+    const lib = url.protocol === 'http:' ? http : https;
+    const req = lib.request(url, { method: 'PUT', headers: { ...target.headers, 'Content-Length': String(sizeBytes) }, timeout: timeoutMs }, (res) => {
+        res.resume();
+        res.on('end', () => (res.statusCode === 200 ? resolve() : reject(new Error(`upload failed (HTTP ${res.statusCode ?? 0})`))));
+    });
+    req.on('timeout', () => req.destroy(new Error('upload timed out')));
+    req.on('error', reject);
+    const src = fs.createReadStream(file);
+    src.on('error', (e) => req.destroy(e));
+    src.pipe(req);
+});
+/** Default {@link GetFileFn}: a streamed `GET` written to `dest`. */
+export const getFileStreamed = (url, dest, timeoutMs) => new Promise((resolve, reject) => {
+    const target = new URL(url);
+    const lib = target.protocol === 'http:' ? http : https;
+    const req = lib.get(target, { timeout: timeoutMs }, (res) => {
+        if (res.statusCode !== 200) {
+            res.resume();
+            reject(new Error(`download failed (HTTP ${res.statusCode ?? 0})`));
+            return;
+        }
+        const out = fs.createWriteStream(dest);
+        res.pipe(out);
+        out.on('finish', () => out.close(() => resolve()));
+        out.on('error', reject);
+        res.on('error', reject);
+    });
+    req.on('timeout', () => req.destroy(new Error('download timed out')));
+    req.on('error', reject);
+});
+// ---------------------------------------------------------------------------
+// Service
+// ---------------------------------------------------------------------------
+/**
+ * Uploads files for outgoing messages and downloads them for incoming ones.
+ */
+export class FileHandoffService {
+    deps;
+    putFile;
+    getFile;
+    constructor(deps) {
+        this.deps = deps;
+        this.putFile = deps.putFile ?? putFileStreamed;
+        this.getFile = deps.getFile ?? getFileStreamed;
+    }
+    log(level, message, meta) {
+        this.deps.log?.(level, message, meta);
+    }
+    homes() {
+        const configured = this.deps.crewlyHomes?.() ?? [path.join(os.homedir(), '.crewly')];
+        return configured.map((h) => real(h) ?? path.resolve(h));
+    }
+    /**
+     * Check a candidate file against every guard.
+     *
+     * Refuses: missing, symlink, not a regular file, empty, over the cap, outside
+     * the project, inside Crewly's home, an obvious secret name, or text that
+     * the secret redactor flags.
+     *
+     * @param candidate - Path as written
+     * @param projectDir - The agent's project directory
+     * @returns The real path and size, or the reason
+     */
+    vetFile(candidate, projectDir) {
+        const abs = path.resolve(projectDir, candidate);
+        let st;
+        try {
+            st = fs.lstatSync(abs);
+        }
+        catch {
+            return { ok: false, reason: 'file not found' };
+        }
+        if (st.isSymbolicLink())
+            return { ok: false, reason: 'is a symbolic link; pass the real file' };
+        if (!st.isFile())
+            return { ok: false, reason: 'is not a regular file' };
+        if (st.size === 0)
+            return { ok: false, reason: 'is empty' };
+        if (st.size > C.MAX_FILE_BYTES)
+            return { ok: false, reason: `is larger than the ${formatSize(C.MAX_FILE_BYTES)} limit` };
+        const r = real(abs);
+        const project = real(projectDir);
+        if (!r || !project)
+            return { ok: false, reason: 'cannot resolve the project directory' };
+        if (!within(r, project))
+            return { ok: false, reason: 'is outside your project directory; copy it there first' };
+        if (this.homes().some((h) => within(r, h)))
+            return { ok: false, reason: "is inside Crewly's home directory" };
+        // Check the path below the project root, so a project that lives under e.g. node_modules still works.
+        if (isSecretPath(path.relative(project, r)))
+            return { ok: false, reason: 'looks like a secret (credentials or key file) and is never sent' };
+        if (st.size <= C.SECRET_SCAN_MAX_BYTES && looksLikeText(r)) {
+            try {
+                if (redactSecretsWithCount(fs.readFileSync(r, 'utf8')).count > 0) {
+                    return { ok: false, reason: 'contains what looks like a secret and is never sent' };
+                }
+            }
+            catch {
+                return { ok: false, reason: 'could not be read' };
+            }
+        }
+        return { ok: true, real: r, size: st.size };
+    }
+    /**
+     * Upload one vetted file as a handoff.
+     *
+     * @param file - Real path
+     * @param sizeBytes - Size
+     * @param agent - Agent session to attribute the upload to
+     * @returns The handoff
+     * @throws When Cloud or the storage upload fails (the half-made handoff is withdrawn)
+     */
+    async uploadFile(file, sizeBytes, agent) {
+        const api = this.deps.api();
+        const attr = agent ? { agent } : { asOwner: true };
+        const fileName = safeName(path.basename(file));
+        const created = await api.request('POST', '/handoffs', {
+            body: { fileName, sizeBytes, contentType: C.DEFAULT_CONTENT_TYPE },
+            ...attr,
+        });
+        const id = created.handoffId;
+        const url = created.upload?.url;
+        if (!id || !url)
+            throw new Error('Cloud answered without an upload URL');
+        try {
+            await this.putFile({ url, headers: created.upload?.headers ?? {} }, file, sizeBytes, C.UPLOAD_TIMEOUT_MS);
+            await api.request('POST', `/handoffs/${id}/complete`, attr);
+        }
+        catch (err) {
+            await api.request('DELETE', `/handoffs/${id}`, attr).catch(() => undefined);
+            throw err;
+        }
+        return { fileName, sizeBytes, handoffId: id };
+    }
+    /**
+     * Upload the files of one outgoing message and append their marker lines.
+     * Never throws: a file that cannot go is reported in `failed` and the text
+     * is still returned so the message can be posted anyway.
+     *
+     * @param input - Text, explicit files, auto-detect switch, project dir
+     * @returns New text plus what went and what did not
+     */
+    async attachToMessage(input) {
+        const attached = [];
+        const failed = [];
+        const tried = new Set();
+        const attempt = async (candidate, explicit) => {
+            const key = path.resolve(input.projectDir, candidate);
+            if (tried.has(key))
+                return;
+            tried.add(key);
+            if (attached.length >= C.MAX_FILES_PER_MESSAGE) {
+                if (explicit)
+                    failed.push({ file: candidate, reason: `more than ${C.MAX_FILES_PER_MESSAGE} files in one message` });
+                return;
+            }
+            const vetted = this.vetFile(candidate, input.projectDir);
+            if (!vetted.ok) {
+                // A path merely mentioned in prose that is not a sendable file is not an error.
+                if (explicit)
+                    failed.push({ file: candidate, reason: vetted.reason });
+                return;
+            }
+            try {
+                attached.push(await this.uploadFile(vetted.real, vetted.size, input.agent));
+            }
+            catch (err) {
+                const reason = err instanceof Error ? err.message : String(err);
+                this.log('warn', 'File handoff upload failed', { file: path.basename(candidate), reason });
+                failed.push({ file: candidate, reason });
+            }
+        };
+        for (const f of input.explicit ?? [])
+            await attempt(f, true);
+        if (input.auto) {
+            for (const f of extractPathCandidates(input.content)) {
+                if (attached.length >= C.MAX_FILES_PER_MESSAGE)
+                    break;
+                await attempt(f, false);
+            }
+        }
+        const lines = attached.map((a) => formatMarker(a.fileName, a.sizeBytes, a.handoffId));
+        const content = lines.length > 0 ? `${input.content.replace(/\s+$/, '')}\n${lines.join('\n')}` : input.content;
+        return { content, attached, failed };
+    }
+    /**
+     * Download one handoff into `<inboxRoot>/<handoffId>/<fileName>`.
+     *
+     * Not acknowledged: a room message reaches every machine (and every agent)
+     * in the room, and an ack deletes the Cloud copy, so the first receiver
+     * would take it from all the others. Cloud removes it after 24 h. A file
+     * already in this inbox is reused, and two local agents fetching the same
+     * one share a single download.
+     *
+     * @param handoffId - Id from a marker
+     * @param inboxRoot - The inbox folder (`<project data dir>/inbox`)
+     * @param agent - Receiving agent session
+     * @param timeoutMs - Ceiling for the transfer
+     * @returns Where the file is now
+     * @throws When the handoff is not ready, the transfer fails, or the size differs
+     */
+    async downloadToInbox(handoffId, inboxRoot, agent, timeoutMs = C.DOWNLOAD_TIMEOUT_MS) {
+        const key = path.join(inboxRoot, handoffId);
+        const existing = this.inboxFileIn(key);
+        if (existing)
+            return existing;
+        const running = this.inFlight.get(key);
+        if (running)
+            return running;
+        const job = this.fetchToInbox(handoffId, inboxRoot, agent, timeoutMs).finally(() => this.inFlight.delete(key));
+        this.inFlight.set(key, job);
+        return job;
+    }
+    /** Downloads in progress, by `<inboxRoot>/<handoffId>`. */
+    inFlight = new Map();
+    /**
+     * The finished file in a handoff's inbox folder, if there is one.
+     *
+     * @param dir - `<inboxRoot>/<handoffId>`
+     * @returns The file, or null
+     */
+    inboxFileIn(dir) {
+        try {
+            const name = fs.readdirSync(dir).find((n) => !n.startsWith('.'));
+            if (!name)
+                return null;
+            const dest = path.join(dir, name);
+            return { path: dest, fileName: name, sizeBytes: fs.statSync(dest).size };
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * The transfer itself, for {@link downloadToInbox}.
+     *
+     * @param handoffId - Id from a marker
+     * @param inboxRoot - The inbox folder
+     * @param agent - Receiving agent session
+     * @param timeoutMs - Ceiling for the transfer
+     * @returns Where the file is now
+     */
+    async fetchToInbox(handoffId, inboxRoot, agent, timeoutMs) {
+        const api = this.deps.api();
+        const attr = agent ? { agent } : { asOwner: true };
+        const meta = await api.request('GET', `/handoffs/${handoffId}`, { ...attr, timeoutMs });
+        if (meta.status !== 'ready' || !meta.download?.url)
+            throw new Error('the sender has not finished uploading');
+        const size = Number(meta.sizeBytes);
+        const name = safeName(meta.fileName ?? 'file');
+        const dir = path.join(inboxRoot, handoffId);
+        fs.mkdirSync(dir, { recursive: true });
+        const dest = path.join(dir, name);
+        const part = path.join(dir, `.${handoffId}.part`);
+        try {
+            await this.getFile(meta.download.url, part, timeoutMs);
+            const got = fs.statSync(part).size;
+            if (Number.isFinite(size) && got !== size)
+                throw new Error(`size mismatch (got ${got} bytes, expected ${size})`);
+            fs.renameSync(part, dest);
+        }
+        catch (err) {
+            fs.rmSync(part, { force: true });
+            throw err;
+        }
+        return { path: dest, fileName: name, sizeBytes: fs.statSync(dest).size };
+    }
+    /**
+     * Replace every marker in a delivered message with the local path of the
+     * downloaded file (`File from <sender>: <path>`). A file that cannot be
+     * fetched in time stays in the text with a note and the manual command.
+     * Downloads run in parallel under one overall deadline.
+     *
+     * @param text - Message text as delivered
+     * @param sender - Who sent it (display name)
+     * @param inboxRoot - The receiving agent's inbox folder
+     * @param agent - Receiving agent session
+     * @returns Text with the markers rewritten (unchanged when it has none)
+     */
+    async expandInbound(text, sender, inboxRoot, agent) {
+        const ids = findMarkerIds(text);
+        if (ids.length === 0)
+            return text;
+        const deadline = Date.now() + C.DOWNLOAD_TOTAL_TIMEOUT_MS;
+        const results = new Map();
+        await Promise.all(ids.slice(0, C.MAX_FILES_PER_MESSAGE).map(async (id) => {
+            try {
+                const budget = Math.max(1, Math.min(C.DOWNLOAD_TIMEOUT_MS, deadline - Date.now()));
+                const file = await this.downloadToInbox(id, inboxRoot, agent, budget);
+                results.set(id, `File from ${sender}: ${file.path}`);
+                this.log('info', 'File handoff received', { handoffId: id, bytes: file.sizeBytes });
+            }
+            catch (err) {
+                const reason = err instanceof Error ? err.message : String(err);
+                this.log('warn', 'File handoff download failed', { handoffId: id, reason });
+                results.set(id, `File from ${sender} could not be fetched (${reason}). Fetch it yourself: receive-file --id ${id}`);
+            }
+        }));
+        return text.replace(MARKER_TOKEN_RE, (whole, id) => results.get(id) ?? whole);
+    }
+}
+/** Whether the first bytes look like text (no NUL byte). */
+function looksLikeText(file) {
+    const probeBytes = 4096;
+    let fd = null;
+    try {
+        fd = fs.openSync(file, 'r');
+        const buf = Buffer.alloc(probeBytes);
+        const n = fs.readSync(fd, buf, 0, probeBytes, 0);
+        return !buf.subarray(0, n).includes(0);
+    }
+    catch {
+        return false;
+    }
+    finally {
+        if (fd !== null)
+            fs.closeSync(fd);
+    }
+}
+//# sourceMappingURL=file-handoff.service.js.map

package/dist/backend/backend/src/services/file-handoff/file-handoff.service.js.map

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

package/dist/backend/backend/src/services/file-handoff/file-handoff.wiring.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Wiring of the automatic file hand-off to the running backend: the Cloud
+ * client, the agent -> project lookup, and the "does this room reach another
+ * machine" test.
+ *
+ * @module services/file-handoff/file-handoff.wiring
+ */
+import { FileHandoffService } from './file-handoff.service.js';
+/**
+ * The process-wide service, built on first use.
+ *
+ * @returns The service
+ */
+export declare function getFileHandoffService(): FileHandoffService;
+/** Replace the service (tests). */
+export declare function setFileHandoffService(next: FileHandoffService | null): void;
+/**
+ * The project directory an agent works in: its team's first project, else
+ * the path the agent's own shell reports (`hint`, from `CREWLY_PROJECT_PATH`).
+ * The server's knowledge wins, so a client cannot widen the project root.
+ *
+ * @param agentSession - Agent session name
+ * @param hint - Project path the caller reported
+ * @returns Absolute directory, or null when neither is usable
+ */
+export declare function projectDirForAgent(agentSession: string | undefined, hint?: string): Promise<string | null>;
+/**
+ * The inbox folder for files delivered to a project's agents.
+ *
+ * @param projectDir - Project root
+ * @returns `<project data dir>/inbox`
+ */
+export declare function inboxRootFor(projectDir: string): string;
+/**
+ * Whether a chat room is a Slack room with at least one Crewly agent that runs
+ * on ANOTHER machine of this account.
+ *
+ * @param chatChannelId - chat-v2 channel id
+ * @returns True when a file mentioned there should be attached automatically
+ */
+export declare function roomHasRemoteColleague(chatChannelId: string): Promise<boolean>;
+//# sourceMappingURL=file-handoff.wiring.d.ts.map

package/dist/backend/backend/src/services/file-handoff/file-handoff.wiring.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-handoff.wiring.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/file-handoff/file-handoff.wiring.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAUH,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAI/D;;;;GAIG;AACH,wBAAgB,qBAAqB,IAAI,kBAAkB,CAO1D;AAED,mCAAmC;AACnC,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,kBAAkB,GAAG,IAAI,GAAG,IAAI,CAE3E;AAED;;;;;;;;GAQG;AACH,wBAAsB,kBAAkB,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAehH;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED;;;;;;GAMG;AACH,wBAAsB,sBAAsB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAWpF"}

package/dist/backend/backend/src/services/file-handoff/file-handoff.wiring.js

@@ -0,0 +1,92 @@
+/**
+ * Wiring of the automatic file hand-off to the running backend: the Cloud
+ * client, the agent -> project lookup, and the "does this room reach another
+ * machine" test.
+ *
+ * @module services/file-handoff/file-handoff.wiring
+ */
+import * as os from 'os';
+import * as path from 'path';
+import * as fs from 'fs';
+import { getAppsParts } from '../apps/apps.wiring.js';
+import { StorageService } from '../core/storage.service.js';
+import { getCrewlyHomePath, resolveProjectDataDir } from '../core/crewly-home.utils.js';
+import { LoggerService } from '../core/logger.service.js';
+import { FILE_HANDOFF_CONSTANTS } from '../../constants.js';
+import { FileHandoffService } from './file-handoff.service.js';
+let instance = null;
+/**
+ * The process-wide service, built on first use.
+ *
+ * @returns The service
+ */
+export function getFileHandoffService() {
+    instance ??= new FileHandoffService({
+        api: () => getAppsParts().client,
+        crewlyHomes: () => [path.join(os.homedir(), '.crewly'), getCrewlyHomePath(), process.env.CREWLY_HOME ?? ''].filter(Boolean),
+        log: (level, message, meta) => LoggerService.getInstance().createComponentLogger('FileHandoff')[level](message, meta),
+    });
+    return instance;
+}
+/** Replace the service (tests). */
+export function setFileHandoffService(next) {
+    instance = next;
+}
+/**
+ * The project directory an agent works in: its team's first project, else
+ * the path the agent's own shell reports (`hint`, from `CREWLY_PROJECT_PATH`).
+ * The server's knowledge wins, so a client cannot widen the project root.
+ *
+ * @param agentSession - Agent session name
+ * @param hint - Project path the caller reported
+ * @returns Absolute directory, or null when neither is usable
+ */
+export async function projectDirForAgent(agentSession, hint) {
+    if (agentSession) {
+        try {
+            const storage = StorageService.getInstance();
+            const team = (await storage.getTeams()).find((t) => (t.members ?? []).some((m) => m.sessionName === agentSession));
+            const projectId = team?.projectIds?.[0];
+            if (projectId) {
+                const project = (await storage.getProjects()).find((p) => p.id === projectId);
+                if (project?.path && fs.existsSync(project.path))
+                    return project.path;
+            }
+        }
+        catch {
+            /* fall through to the hint */
+        }
+    }
+    return hint && path.isAbsolute(hint) && fs.existsSync(hint) ? hint : null;
+}
+/**
+ * The inbox folder for files delivered to a project's agents.
+ *
+ * @param projectDir - Project root
+ * @returns `<project data dir>/inbox`
+ */
+export function inboxRootFor(projectDir) {
+    return path.join(resolveProjectDataDir(projectDir), FILE_HANDOFF_CONSTANTS.INBOX_DIR);
+}
+/**
+ * Whether a chat room is a Slack room with at least one Crewly agent that runs
+ * on ANOTHER machine of this account.
+ *
+ * @param chatChannelId - chat-v2 channel id
+ * @returns True when a file mentioned there should be attached automatically
+ */
+export async function roomHasRemoteColleague(chatChannelId) {
+    try {
+        const { getSlackTeamChannelService } = await import('../slack/slack-team-channel.service.js');
+        const mapping = getSlackTeamChannelService()?.findByChatChannelId(chatChannelId);
+        if (!mapping)
+            return false;
+        const { getSlackDirectoryService } = await import('../slack/slack-directory.service.js');
+        const entries = (await getSlackDirectoryService()?.list(mapping.slackChannelId)) ?? [];
+        return entries.some((e) => e.kind === 'agent' && e.inChannel && e.source === 'this-account');
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=file-handoff.wiring.js.map

package/dist/backend/backend/src/services/file-handoff/file-handoff.wiring.js.map

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

package/dist/backend/backend/src/services/project-tickets/ticket-tracking.d.ts

@@ -7,7 +7,10 @@
  * nothing inside it can be re-included. When (and only when) git reports the
  * tickets folder as ignored, this appends a small block to the project's
  * `.gitignore` that re-includes `.crewly/`, re-ignores everything in it, then
- * re-includes `tickets/`. Existing lines are never touched.
+ * re-includes `tickets/`. Existing lines are never touched, and any existing
+ * `!.crewly/...` negations (e.g. `!.crewly/wiki/`) are re-emitted after the
+ * block's `.crewly/*` so the block cannot re-ignore what the project already
+ * tracks.
  *
  * @module services/project-tickets/ticket-tracking
  */
@@ -26,6 +29,16 @@ export type TicketTrackingOutcome =
  | 'still-ignored';
 /** Git runner (injectable for tests). */
 export type GitRunner = (cwd: string, args: string[]) => Promise<GitResult>;
+/**
+ * Build the block to append: the header, `!.crewly/` and `.crewly/*`, then the
+ * project's existing `.crewly` negations, then the tickets re-includes. The
+ * block's own `.crewly/*` comes after the project's rules, so without the
+ * re-emitted negations it would hide everything they had re-included.
+ *
+ * @param current - Current `.gitignore` text
+ * @returns Block lines, in order
+ */
+export declare function buildTicketsBlock(current: string): string[];
 /**
  * Make sure git tracks the project's tickets folder, appending the
  * re-include block to `<project>/.gitignore` when it is ignored.