crewly 1.6.0 → 1.6.2

package/dist/backend/backend/src/services/chat-v2/chat-v2.team-membership.js

@@ -0,0 +1,54 @@
+/**
+ * OSS team-membership validator for `ChatV2Service.validateTeamMembership`.
+ *
+ * Phase C F2b (issue #333) — outer-ring tenant defense for type='channel'
+ * channel creation. The chat service's optional `validateTeamMembership`
+ * dependency is invoked when a caller binds a channel to a `teamId`; if
+ * the principal is not authorized for that team, the service throws
+ * `forbidden_team` (HTTP 403) before persisting the row.
+ *
+ * In OSS single-user mode there is no per-user tenant binding — the
+ * single user owns every team in their workspace. The right semantic is
+ * therefore "the team must exist" (you cannot bind a channel to a team
+ * id you fabricated). Cloud Portal Phase E swaps in a tenant-aware
+ * validator that checks the user's tenant membership against the team's
+ * tenant.
+ *
+ * Implementation: `existsSync` of `<teamsDir>/<teamId>/config.json`. Sync
+ * by design — `ChatV2Service.createChannel` runs inside the synchronous
+ * `runHandler` controller wrapper. Async refactors are a Phase E concern.
+ *
+ * @module services/chat-v2/chat-v2.team-membership
+ */
+import { existsSync } from 'fs';
+import * as path from 'path';
+import { StorageService } from '../core/storage.service.js';
+/**
+ * Build the OSS validator. Captures the StorageService instance lazily so
+ * the singleton resolves correctly even when `getInstance()` lands later
+ * in module-init order (matches the existing `loadTeams` injection
+ * pattern in chat-v2 wiring).
+ *
+ * @param deps - Optional dependency overrides for tests.
+ * @returns A sync validator suitable for `ChatV2ServiceOptions.validateTeamMembership`.
+ *
+ * @example
+ *   const validator = createOssTeamMembershipValidator();
+ *   const service = getChatV2Service({ validateTeamMembership: validator });
+ */
+export function createOssTeamMembershipValidator(deps = {}) {
+    const getTeamDir = deps.getTeamDir ??
+        ((teamId) => StorageService.getInstance().getTeamDir(teamId));
+    const fileExists = deps.fileExists ?? existsSync;
+    return (_principal, teamId) => {
+        // Defensive: a blank teamId never points to a real team. The service
+        // already rejects with VALIDATION before reaching the validator, so
+        // this is belt-and-suspenders.
+        if (typeof teamId !== 'string' || teamId.trim().length === 0) {
+            return false;
+        }
+        const configPath = path.join(getTeamDir(teamId), 'config.json');
+        return fileExists(configPath);
+    };
+}
+//# sourceMappingURL=chat-v2.team-membership.js.map

package/dist/backend/backend/src/services/chat-v2/chat-v2.team-membership.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-v2.team-membership.js","sourceRoot":"","sources":["../../../../../../backend/src/services/chat-v2/chat-v2.team-membership.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAChC,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAG5D;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,gCAAgC,CAC9C,OAKI,EAAE;IAEN,MAAM,UAAU,GACd,IAAI,CAAC,UAAU;QACf,CAAC,CAAC,MAAc,EAAE,EAAE,CAAC,cAAc,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;IACxE,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,IAAI,UAAU,CAAC;IAEjD,OAAO,CAAC,UAAyB,EAAE,MAAc,EAAW,EAAE;QAC5D,qEAAqE;QACrE,oEAAoE;QACpE,+BAA+B;QAC/B,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC7D,OAAO,KAAK,CAAC;QACf,CAAC;QACD,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,aAAa,CAAC,CAAC;QAChE,OAAO,UAAU,CAAC,UAAU,CAAC,CAAC;IAChC,CAAC,CAAC;AACJ,CAAC"}

package/dist/backend/backend/src/services/chat-v2/config.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Chat V2 — Configuration constants.
+ *
+ * Loads Phase 1 defaults (from spec §15) and honors
+ * `CREWLY_CHAT_*` environment overrides. Pure functions;
+ * no disk I/O here.
+ *
+ * @module services/chat-v2/config
+ */
+/** Full Chat V2 runtime config. All durations in ms, sizes in bytes. */
+export interface ChatV2Config {
+    enabled: boolean;
+    /** Hard cap on message body size in UTF-8 bytes after NFC normalization. */
+    maxMessageBytes: number;
+    maxAttachmentBytes: number;
+    maxAttachmentsPerMessage: number;
+    allowedAttachmentMimes: readonly string[];
+    /** Max chars on channel name (validated at controller). */
+    maxChannelNameChars: number;
+    /** Max chars on optional channel purpose. */
+    maxPurposeChars: number;
+    /** Max bytes in message metadata JSON blob. */
+    maxMetadataBytes: number;
+    rateLimits: {
+        messagesPerSec: number;
+        messagesPerMin: number;
+        uploadsPerSec: number;
+        uploadsPerMin: number;
+        wsFramesPerSec: number;
+    };
+    websocket: {
+        heartbeatIntervalMs: number;
+        idleTimeoutMs: number;
+        pongTimeoutMs: number;
+        replayCap: number;
+        maxFrameBytes: number;
+    };
+    offlineQueue: {
+        maxPendingPerAgent: number;
+        maxAgeMs: number;
+        drainBatchSize: number;
+        drainPauseMs: number;
+    };
+    presence: {
+        pollIntervalMs: number;
+    };
+    portal: {
+        /** Name of the env var holding the Cloud-OSS shared service token. */
+        sharedSecretEnv: string;
+    };
+    storage: {
+        dbPath: string;
+        attachmentsDir: string;
+        uploadsStagingDir: string;
+    };
+}
+/**
+ * Resolve a path containing a leading `~` or `~/` to the user's home directory.
+ *
+ * @param input - Path possibly prefixed with `~` or `~/`
+ * @returns Absolute path with `~` expanded
+ */
+export declare function expandHomePath(input: string): string;
+/** Phase 1 defaults — source of truth is the tech spec §15. */
+export declare const CHAT_V2_DEFAULTS: ChatV2Config;
+/**
+ * Parse a positive integer from an env-string, falling back to a default.
+ *
+ * @param raw - Raw env-var value or undefined
+ * @param fallback - Default if raw is missing/invalid/non-positive
+ * @returns The parsed positive integer
+ */
+export declare function parsePositiveInt(raw: string | undefined, fallback: number): number;
+/**
+ * Parse a boolean env-var supporting `true`/`false`/`1`/`0` (case-insensitive).
+ *
+ * @param raw - Raw env-var value or undefined
+ * @param fallback - Default if raw is missing
+ * @returns The parsed boolean
+ */
+export declare function parseBoolean(raw: string | undefined, fallback: boolean): boolean;
+/**
+ * Build a fully-resolved config from defaults + environment overrides.
+ *
+ * Env vars honored (all optional):
+ * - `CREWLY_CHAT_ENABLED` — master switch
+ * - `CREWLY_CHAT_MAX_MESSAGE_BYTES` — per-message byte cap
+ * - `CREWLY_CHAT_MAX_ATTACHMENT_BYTES` — per-attachment byte cap
+ * - `CREWLY_CHAT_WS_HEARTBEAT_MS` — client-ping interval
+ * - `CREWLY_CHAT_WS_IDLE_TIMEOUT_MS` — server idle close
+ * - `CREWLY_CHAT_DB_PATH` — SQLite DB path (expands `~`)
+ * - `CREWLY_CHAT_ATTACHMENTS_DIR` — committed attachment dir (expands `~`)
+ * - `CREWLY_CHAT_UPLOADS_STAGING_DIR` — pre-commit upload dir (expands `~`)
+ * - `CREWLY_HOME` — when set and DB/path env vars are not, rebases storage under this dir
+ *
+ * @param env - The environment object to read from (defaults to `process.env`)
+ * @returns A fully-resolved, immutable ChatV2Config
+ */
+export declare function loadChatV2Config(env?: NodeJS.ProcessEnv): ChatV2Config;
+//# sourceMappingURL=config.d.ts.map

package/dist/backend/backend/src/services/chat-v2/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/chat-v2/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AASH,wEAAwE;AACxE,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,4EAA4E;IAC5E,eAAe,EAAE,MAAM,CAAC;IACxB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,wBAAwB,EAAE,MAAM,CAAC;IACjC,sBAAsB,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,2DAA2D;IAC3D,mBAAmB,EAAE,MAAM,CAAC;IAC5B,6CAA6C;IAC7C,eAAe,EAAE,MAAM,CAAC;IACxB,+CAA+C;IAC/C,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE;QACV,cAAc,EAAE,MAAM,CAAC;QACvB,cAAc,EAAE,MAAM,CAAC;QACvB,aAAa,EAAE,MAAM,CAAC;QACtB,aAAa,EAAE,MAAM,CAAC;QACtB,cAAc,EAAE,MAAM,CAAC;KACxB,CAAC;IACF,SAAS,EAAE;QACT,mBAAmB,EAAE,MAAM,CAAC;QAC5B,aAAa,EAAE,MAAM,CAAC;QACtB,aAAa,EAAE,MAAM,CAAC;QACtB,SAAS,EAAE,MAAM,CAAC;QAClB,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC;IACF,YAAY,EAAE;QACZ,kBAAkB,EAAE,MAAM,CAAC;QAC3B,QAAQ,EAAE,MAAM,CAAC;QACjB,cAAc,EAAE,MAAM,CAAC;QACvB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,QAAQ,EAAE;QACR,cAAc,EAAE,MAAM,CAAC;KACxB,CAAC;IACF,MAAM,EAAE;QACN,sEAAsE;QACtE,eAAe,EAAE,MAAM,CAAC;KACzB,CAAC;IACF,OAAO,EAAE;QACP,MAAM,EAAE,MAAM,CAAC;QACf,cAAc,EAAE,MAAM,CAAC;QACvB,iBAAiB,EAAE,MAAM,CAAC;KAC3B,CAAC;CACH;AAMD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAIpD;AAED,+DAA+D;AAC/D,eAAO,MAAM,gBAAgB,EAAE,YA6Cb,CAAC;AAMnB;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAKlF;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,EAAE,OAAO,GAAG,OAAO,CAMhF;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,YAAY,CA6DnF"}

package/dist/backend/backend/src/services/chat-v2/config.js

@@ -0,0 +1,174 @@
+/**
+ * Chat V2 — Configuration constants.
+ *
+ * Loads Phase 1 defaults (from spec §15) and honors
+ * `CREWLY_CHAT_*` environment overrides. Pure functions;
+ * no disk I/O here.
+ *
+ * @module services/chat-v2/config
+ */
+import * as os from 'os';
+import * as path from 'path';
+// ---------------------------------------------------------------------------
+// Defaults (spec §15)
+// ---------------------------------------------------------------------------
+/**
+ * Resolve a path containing a leading `~` or `~/` to the user's home directory.
+ *
+ * @param input - Path possibly prefixed with `~` or `~/`
+ * @returns Absolute path with `~` expanded
+ */
+export function expandHomePath(input) {
+    if (input === '~')
+        return os.homedir();
+    if (input.startsWith('~/'))
+        return path.join(os.homedir(), input.slice(2));
+    return input;
+}
+/** Phase 1 defaults — source of truth is the tech spec §15. */
+export const CHAT_V2_DEFAULTS = Object.freeze({
+    enabled: true,
+    maxMessageBytes: 32768,
+    maxAttachmentBytes: 10 * 1024 * 1024,
+    maxAttachmentsPerMessage: 4,
+    allowedAttachmentMimes: Object.freeze([
+        'image/png',
+        'image/jpeg',
+        'image/gif',
+        'image/webp',
+    ]),
+    maxChannelNameChars: 128,
+    maxPurposeChars: 512,
+    maxMetadataBytes: 2048,
+    rateLimits: Object.freeze({
+        messagesPerSec: 10,
+        messagesPerMin: 60,
+        uploadsPerSec: 3,
+        uploadsPerMin: 20,
+        wsFramesPerSec: 20,
+    }),
+    websocket: Object.freeze({
+        heartbeatIntervalMs: 30000,
+        idleTimeoutMs: 60000,
+        pongTimeoutMs: 5000,
+        replayCap: 200,
+        maxFrameBytes: 65536,
+    }),
+    offlineQueue: Object.freeze({
+        maxPendingPerAgent: 100,
+        maxAgeMs: 24 * 60 * 60 * 1000,
+        drainBatchSize: 50,
+        drainPauseMs: 2000,
+    }),
+    presence: Object.freeze({
+        pollIntervalMs: 10000,
+    }),
+    portal: Object.freeze({
+        sharedSecretEnv: 'CREWLY_CLOUD_OSS_SERVICE_TOKEN',
+    }),
+    storage: Object.freeze({
+        dbPath: '~/.crewly/chat.db',
+        attachmentsDir: '~/.crewly/chat-attachments',
+        uploadsStagingDir: '~/.crewly/chat-uploads-staging',
+    }),
+});
+// ---------------------------------------------------------------------------
+// Env-override loader
+// ---------------------------------------------------------------------------
+/**
+ * Parse a positive integer from an env-string, falling back to a default.
+ *
+ * @param raw - Raw env-var value or undefined
+ * @param fallback - Default if raw is missing/invalid/non-positive
+ * @returns The parsed positive integer
+ */
+export function parsePositiveInt(raw, fallback) {
+    if (raw === undefined || raw === '')
+        return fallback;
+    const n = Number.parseInt(raw, 10);
+    if (!Number.isFinite(n) || n <= 0)
+        return fallback;
+    return n;
+}
+/**
+ * Parse a boolean env-var supporting `true`/`false`/`1`/`0` (case-insensitive).
+ *
+ * @param raw - Raw env-var value or undefined
+ * @param fallback - Default if raw is missing
+ * @returns The parsed boolean
+ */
+export function parseBoolean(raw, fallback) {
+    if (raw === undefined)
+        return fallback;
+    const trimmed = raw.trim().toLowerCase();
+    if (trimmed === 'true' || trimmed === '1')
+        return true;
+    if (trimmed === 'false' || trimmed === '0')
+        return false;
+    return fallback;
+}
+/**
+ * Build a fully-resolved config from defaults + environment overrides.
+ *
+ * Env vars honored (all optional):
+ * - `CREWLY_CHAT_ENABLED` — master switch
+ * - `CREWLY_CHAT_MAX_MESSAGE_BYTES` — per-message byte cap
+ * - `CREWLY_CHAT_MAX_ATTACHMENT_BYTES` — per-attachment byte cap
+ * - `CREWLY_CHAT_WS_HEARTBEAT_MS` — client-ping interval
+ * - `CREWLY_CHAT_WS_IDLE_TIMEOUT_MS` — server idle close
+ * - `CREWLY_CHAT_DB_PATH` — SQLite DB path (expands `~`)
+ * - `CREWLY_CHAT_ATTACHMENTS_DIR` — committed attachment dir (expands `~`)
+ * - `CREWLY_CHAT_UPLOADS_STAGING_DIR` — pre-commit upload dir (expands `~`)
+ * - `CREWLY_HOME` — when set and DB/path env vars are not, rebases storage under this dir
+ *
+ * @param env - The environment object to read from (defaults to `process.env`)
+ * @returns A fully-resolved, immutable ChatV2Config
+ */
+export function loadChatV2Config(env = process.env) {
+    const defaults = CHAT_V2_DEFAULTS;
+    // Optionally rebase storage paths under CREWLY_HOME when explicit storage envs are absent.
+    const crewlyHome = env['CREWLY_HOME'];
+    const crewlyHomeResolved = crewlyHome ? expandHomePath(crewlyHome) : null;
+    const rebase = (defaultRelative) => {
+        // `defaults.storage.*` are `~/.crewly/...` style; strip `~/.crewly/` → relative.
+        if (!crewlyHomeResolved)
+            return expandHomePath(defaultRelative);
+        const marker = '~/.crewly/';
+        if (defaultRelative.startsWith(marker)) {
+            return path.join(crewlyHomeResolved, defaultRelative.slice(marker.length));
+        }
+        return expandHomePath(defaultRelative);
+    };
+    const dbPathEnv = env['CREWLY_CHAT_DB_PATH'];
+    const attachmentsDirEnv = env['CREWLY_CHAT_ATTACHMENTS_DIR'];
+    const stagingDirEnv = env['CREWLY_CHAT_UPLOADS_STAGING_DIR'];
+    return Object.freeze({
+        enabled: parseBoolean(env['CREWLY_CHAT_ENABLED'], defaults.enabled),
+        maxMessageBytes: parsePositiveInt(env['CREWLY_CHAT_MAX_MESSAGE_BYTES'], defaults.maxMessageBytes),
+        maxAttachmentBytes: parsePositiveInt(env['CREWLY_CHAT_MAX_ATTACHMENT_BYTES'], defaults.maxAttachmentBytes),
+        maxAttachmentsPerMessage: defaults.maxAttachmentsPerMessage,
+        allowedAttachmentMimes: defaults.allowedAttachmentMimes,
+        maxChannelNameChars: defaults.maxChannelNameChars,
+        maxPurposeChars: defaults.maxPurposeChars,
+        maxMetadataBytes: defaults.maxMetadataBytes,
+        rateLimits: defaults.rateLimits,
+        websocket: Object.freeze({
+            ...defaults.websocket,
+            heartbeatIntervalMs: parsePositiveInt(env['CREWLY_CHAT_WS_HEARTBEAT_MS'], defaults.websocket.heartbeatIntervalMs),
+            idleTimeoutMs: parsePositiveInt(env['CREWLY_CHAT_WS_IDLE_TIMEOUT_MS'], defaults.websocket.idleTimeoutMs),
+        }),
+        offlineQueue: defaults.offlineQueue,
+        presence: defaults.presence,
+        portal: defaults.portal,
+        storage: Object.freeze({
+            dbPath: dbPathEnv ? expandHomePath(dbPathEnv) : rebase(defaults.storage.dbPath),
+            attachmentsDir: attachmentsDirEnv
+                ? expandHomePath(attachmentsDirEnv)
+                : rebase(defaults.storage.attachmentsDir),
+            uploadsStagingDir: stagingDirEnv
+                ? expandHomePath(stagingDirEnv)
+                : rebase(defaults.storage.uploadsStagingDir),
+        }),
+    });
+}
+//# sourceMappingURL=config.js.map

package/dist/backend/backend/src/services/chat-v2/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../../../../backend/src/services/chat-v2/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAsD7B,8EAA8E;AAC9E,sBAAsB;AACtB,8EAA8E;AAE9E;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,KAAa;IAC1C,IAAI,KAAK,KAAK,GAAG;QAAE,OAAO,EAAE,CAAC,OAAO,EAAE,CAAC;IACvC,IAAI,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3E,OAAO,KAAK,CAAC;AACf,CAAC;AAED,+DAA+D;AAC/D,MAAM,CAAC,MAAM,gBAAgB,GAAiB,MAAM,CAAC,MAAM,CAAC;IAC1D,OAAO,EAAE,IAAI;IACb,eAAe,EAAE,KAAK;IACtB,kBAAkB,EAAE,EAAE,GAAG,IAAI,GAAG,IAAI;IACpC,wBAAwB,EAAE,CAAC;IAC3B,sBAAsB,EAAE,MAAM,CAAC,MAAM,CAAC;QACpC,WAAW;QACX,YAAY;QACZ,WAAW;QACX,YAAY;KACb,CAAC;IACF,mBAAmB,EAAE,GAAG;IACxB,eAAe,EAAE,GAAG;IACpB,gBAAgB,EAAE,IAAI;IACtB,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC;QACxB,cAAc,EAAE,EAAE;QAClB,cAAc,EAAE,EAAE;QAClB,aAAa,EAAE,CAAC;QAChB,aAAa,EAAE,EAAE;QACjB,cAAc,EAAE,EAAE;KACnB,CAAC;IACF,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC;QACvB,mBAAmB,EAAE,KAAK;QAC1B,aAAa,EAAE,KAAK;QACpB,aAAa,EAAE,IAAI;QACnB,SAAS,EAAE,GAAG;QACd,aAAa,EAAE,KAAK;KACrB,CAAC;IACF,YAAY,EAAE,MAAM,CAAC,MAAM,CAAC;QAC1B,kBAAkB,EAAE,GAAG;QACvB,QAAQ,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI;QAC7B,cAAc,EAAE,EAAE;QAClB,YAAY,EAAE,IAAI;KACnB,CAAC;IACF,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC;QACtB,cAAc,EAAE,KAAK;KACtB,CAAC;IACF,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC;QACpB,eAAe,EAAE,gCAAgC;KAClD,CAAC;IACF,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC;QACrB,MAAM,EAAE,mBAAmB;QAC3B,cAAc,EAAE,4BAA4B;QAC5C,iBAAiB,EAAE,gCAAgC;KACpD,CAAC;CACH,CAAiB,CAAC;AAEnB,8EAA8E;AAC9E,sBAAsB;AACtB,8EAA8E;AAE9E;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAuB,EAAE,QAAgB;IACxE,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,EAAE;QAAE,OAAO,QAAQ,CAAC;IACrD,MAAM,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IACnC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,QAAQ,CAAC;IACnD,OAAO,CAAC,CAAC;AACX,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAC,GAAuB,EAAE,QAAiB;IACrE,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,QAAQ,CAAC;IACvC,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACzC,IAAI,OAAO,KAAK,MAAM,IAAI,OAAO,KAAK,GAAG;QAAE,OAAO,IAAI,CAAC;IACvD,IAAI,OAAO,KAAK,OAAO,IAAI,OAAO,KAAK,GAAG;QAAE,OAAO,KAAK,CAAC;IACzD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAyB,OAAO,CAAC,GAAG;IACnE,MAAM,QAAQ,GAAG,gBAAgB,CAAC;IAElC,2FAA2F;IAC3F,MAAM,UAAU,GAAG,GAAG,CAAC,aAAa,CAAC,CAAC;IACtC,MAAM,kBAAkB,GAAG,UAAU,CAAC,CAAC,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAE1E,MAAM,MAAM,GAAG,CAAC,eAAuB,EAAU,EAAE;QACjD,iFAAiF;QACjF,IAAI,CAAC,kBAAkB;YAAE,OAAO,cAAc,CAAC,eAAe,CAAC,CAAC;QAChE,MAAM,MAAM,GAAG,YAAY,CAAC;QAC5B,IAAI,eAAe,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YACvC,OAAO,IAAI,CAAC,IAAI,CAAC,kBAAkB,EAAE,eAAe,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;QAC7E,CAAC;QACD,OAAO,cAAc,CAAC,eAAe,CAAC,CAAC;IACzC,CAAC,CAAC;IAEF,MAAM,SAAS,GAAG,GAAG,CAAC,qBAAqB,CAAC,CAAC;IAC7C,MAAM,iBAAiB,GAAG,GAAG,CAAC,6BAA6B,CAAC,CAAC;IAC7D,MAAM,aAAa,GAAG,GAAG,CAAC,iCAAiC,CAAC,CAAC;IAE7D,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,OAAO,EAAE,YAAY,CAAC,GAAG,CAAC,qBAAqB,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC;QACnE,eAAe,EAAE,gBAAgB,CAC/B,GAAG,CAAC,+BAA+B,CAAC,EACpC,QAAQ,CAAC,eAAe,CACzB;QACD,kBAAkB,EAAE,gBAAgB,CAClC,GAAG,CAAC,kCAAkC,CAAC,EACvC,QAAQ,CAAC,kBAAkB,CAC5B;QACD,wBAAwB,EAAE,QAAQ,CAAC,wBAAwB;QAC3D,sBAAsB,EAAE,QAAQ,CAAC,sBAAsB;QACvD,mBAAmB,EAAE,QAAQ,CAAC,mBAAmB;QACjD,eAAe,EAAE,QAAQ,CAAC,eAAe;QACzC,gBAAgB,EAAE,QAAQ,CAAC,gBAAgB;QAC3C,UAAU,EAAE,QAAQ,CAAC,UAAU;QAC/B,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC;YACvB,GAAG,QAAQ,CAAC,SAAS;YACrB,mBAAmB,EAAE,gBAAgB,CACnC,GAAG,CAAC,6BAA6B,CAAC,EAClC,QAAQ,CAAC,SAAS,CAAC,mBAAmB,CACvC;YACD,aAAa,EAAE,gBAAgB,CAC7B,GAAG,CAAC,gCAAgC,CAAC,EACrC,QAAQ,CAAC,SAAS,CAAC,aAAa,CACjC;SACF,CAAC;QACF,YAAY,EAAE,QAAQ,CAAC,YAAY;QACnC,QAAQ,EAAE,QAAQ,CAAC,QAAQ;QAC3B,MAAM,EAAE,QAAQ,CAAC,MAAM;QACvB,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC;YACrB,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC;YAC/E,cAAc,EAAE,iBAAiB;gBAC/B,CAAC,CAAC,cAAc,CAAC,iBAAiB,CAAC;gBACnC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,cAAc,CAAC;YAC3C,iBAAiB,EAAE,aAAa;gBAC9B,CAAC,CAAC,cAAc,CAAC,aAAa,CAAC;gBAC/B,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,iBAAiB,CAAC;SAC/C,CAAC;KACH,CAAiB,CAAC;AACrB,CAAC"}

package/dist/backend/backend/src/services/chat-v2/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Chat V2 service module barrel.
+ *
+ * @module services/chat-v2
+ */
+export { ChatV2Service, type ChatV2ServiceOptions } from './chat-v2.service.js';
+export { loadChatV2Config, CHAT_V2_DEFAULTS, type ChatV2Config } from './config.js';
+export { openChatDatabase, type ChatDatabase } from './sqlite/chat-db.js';
+export { CHAT_ERROR_CODES, CHAT_CONTENT_TYPES, CHAT_SENDER_TYPES, ChatError, type ChatChannelDTO, type ChatMessageDTO, type ChatAttachmentDTO, type ChatPrincipal, type ChatContentType, type ChatSenderType, type ChatAgentPresenceStatus, type ChatErrorCode, } from './types.js';
+export { ChatV2MentionResolver, type MentionTarget, type MentionTargetKind, type MentionResolverContext, type MentionResolverDeps, } from './chat-v2.mention-resolver.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/backend/backend/src/services/chat-v2/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/chat-v2/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,KAAK,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAChF,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AACpF,OAAO,EAAE,gBAAgB,EAAE,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAC1E,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,EACjB,SAAS,EACT,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,uBAAuB,EAC5B,KAAK,aAAa,GACnB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,qBAAqB,EACrB,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,KAAK,sBAAsB,EAC3B,KAAK,mBAAmB,GACzB,MAAM,+BAA+B,CAAC"}

package/dist/backend/backend/src/services/chat-v2/index.js

@@ -0,0 +1,12 @@
+/**
+ * Chat V2 service module barrel.
+ *
+ * @module services/chat-v2
+ */
+export { ChatV2Service } from './chat-v2.service.js';
+export { loadChatV2Config, CHAT_V2_DEFAULTS } from './config.js';
+export { openChatDatabase } from './sqlite/chat-db.js';
+export { CHAT_ERROR_CODES, CHAT_CONTENT_TYPES, CHAT_SENDER_TYPES, ChatError, } from './types.js';
+// Phase C BE.2 — mention dispatch routing scaffolding.
+export { ChatV2MentionResolver, } from './chat-v2.mention-resolver.js';
+//# sourceMappingURL=index.js.map

package/dist/backend/backend/src/services/chat-v2/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../backend/src/services/chat-v2/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAA6B,MAAM,sBAAsB,CAAC;AAChF,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAqB,MAAM,aAAa,CAAC;AACpF,OAAO,EAAE,gBAAgB,EAAqB,MAAM,qBAAqB,CAAC;AAC1E,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,EACjB,SAAS,GASV,MAAM,YAAY,CAAC;AACpB,uDAAuD;AACvD,OAAO,EACL,qBAAqB,GAKtB,MAAM,+BAA+B,CAAC"}

package/dist/backend/backend/src/services/chat-v2/sqlite/channel.store.d.ts

@@ -0,0 +1,114 @@
+/**
+ * ChannelStore — CRUD for `chat_channels`.
+ *
+ * All authorization is handled at a higher layer (`ChatV2Service`);
+ * this store only enforces DB-level invariants (FKs, unique indexes).
+ *
+ * @module services/chat-v2/sqlite/channel.store
+ */
+import { type ChatChannelRow, type ChatChannelType } from '../types.js';
+import type { ChatDatabase } from './chat-db.js';
+/** Payload for `ChannelStore.create`. */
+export interface ChannelCreateInput {
+    /**
+     * Wire-level session binding. For `type='dm'` (default), this is the
+     * agent's session ID and the partial unique index enforces 1:1 binding.
+     * For `type='channel'`, callers should pass the empty string `''` —
+     * channel rows are excluded from the dm-binding unique index by design.
+     */
+    agentSession: string;
+    ownerUserId: string;
+    name: string;
+    purpose?: string | null;
+    /**
+     * Phase A (SEALED §3.1) — channel type. Defaults to `'dm'` to preserve
+     * the Phase 1 / Week 2 contract for callers that omit this field.
+     */
+    type?: ChatChannelType;
+    /** Phase A — required when `type='channel'`; null/empty for DMs. */
+    teamId?: string | null;
+    /** Phase A — optional project link for project-scoped channels. */
+    projectId?: string | null;
+    /** Phase A — for `type='dm'`, the resolved member-ID being DM'd. */
+    targetMemberId?: string | null;
+    /** Override the clock (tests). */
+    nowMs?: number;
+    /** Override the generated id (tests / deterministic callers). */
+    id?: string;
+}
+/** SQLite-backed store for chat channels. */
+export declare class ChannelStore {
+    private readonly db;
+    constructor(db: ChatDatabase);
+    /**
+     * Create a new channel. Enforces the 1:1 agent-binding by catching
+     * the SQLite unique-constraint error and surfacing it as a
+     * `ChatError(agent_already_bound, 409)`.
+     *
+     * @param input - The channel creation payload
+     * @returns The inserted channel row
+     * @throws {ChatError} `agent_already_bound` (409) if the agent is already bound
+     *   to another active channel.
+     */
+    create(input: ChannelCreateInput): ChatChannelRow;
+    /**
+     * Look up a channel by its id (active or archived).
+     *
+     * @param id - The channel id
+     * @returns The row, or null if not found
+     */
+    getById(id: string): ChatChannelRow | null;
+    /**
+     * Find the single active channel bound to an agent session, if any.
+     * Uses the partial unique index, so at most one row is returned.
+     *
+     * @param agentSession - The agent session id
+     * @returns The active channel row, or null
+     */
+    findActiveByAgentSession(agentSession: string): ChatChannelRow | null;
+    /**
+     * List channels owned by a user.
+     *
+     * Phase C — extended with `type` + `teamId` filter options so the
+     * `GET /api/chat/channels` endpoint can serve the channel-rail's
+     * grouped/workspace-scoped views without shipping every row to the
+     * client. Filters compose with AND; passing `undefined` for either is
+     * a no-op (the existing all-channels behavior).
+     *
+     * @param ownerUserId - The user_id whose channels to return
+     * @param options - Listing options
+     * @param options.includeArchived - When false (default), filter out archived rows
+     * @param options.limit - Max rows to return (capped at 100)
+     * @param options.type - Phase C: when set, filter rows to this channel type
+     *   (`'dm'` or `'channel'`). Useful for the channel-rail's "DMs only" /
+     *   "Channels only" views.
+     * @param options.teamId - Phase C: when set, filter rows whose `team_id`
+     *   matches. Used by the workspace-scoped Channels group; empty / null
+     *   `team_id` rows are excluded by this filter on purpose (DMs and
+     *   workspace-less rows belong to no team).
+     * @returns Channel rows sorted by `last_message_at DESC, created_at DESC`
+     */
+    listByOwner(ownerUserId: string, options?: {
+        includeArchived?: boolean;
+        limit?: number;
+        type?: ChatChannelType;
+        teamId?: string;
+    }): ChatChannelRow[];
+    /**
+     * Mark a channel as archived (soft-delete). No-op if already archived.
+     *
+     * @param id - The channel id
+     * @param nowMs - Optional override for the archive timestamp
+     * @returns True if a row was updated (was active), false otherwise
+     */
+    archive(id: string, nowMs?: number): boolean;
+    /**
+     * Bump `last_message_at` to a provided timestamp if it is greater than
+     * the current value. Safe to call many times.
+     *
+     * @param id - The channel id
+     * @param timestampMs - The timestamp to record
+     */
+    touchLastMessageAt(id: string, timestampMs: number): void;
+}
+//# sourceMappingURL=channel.store.d.ts.map

package/dist/backend/backend/src/services/chat-v2/sqlite/channel.store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel.store.d.ts","sourceRoot":"","sources":["../../../../../../../backend/src/services/chat-v2/sqlite/channel.store.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAGL,KAAK,cAAc,EACnB,KAAK,eAAe,EACrB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAqBjD,yCAAyC;AACzC,MAAM,WAAW,kBAAkB;IACjC;;;;;OAKG;IACH,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB;;;OAGG;IACH,IAAI,CAAC,EAAE,eAAe,CAAC;IACvB,oEAAoE;IACpE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,mEAAmE;IACnE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,oEAAoE;IACpE,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,kCAAkC;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iEAAiE;IACjE,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAMD,6CAA6C;AAC7C,qBAAa,YAAY;IACX,OAAO,CAAC,QAAQ,CAAC,EAAE;gBAAF,EAAE,EAAE,YAAY;IAE7C;;;;;;;;;OASG;IACH,MAAM,CAAC,KAAK,EAAE,kBAAkB,GAAG,cAAc;IA6DjD;;;;;OAKG;IACH,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI;IAW1C;;;;;;OAMG;IACH,wBAAwB,CAAC,YAAY,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI;IAgBrE;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,WAAW,CACT,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE;QACR,eAAe,CAAC,EAAE,OAAO,CAAC;QAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,eAAe,CAAC;QACvB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,GACA,cAAc,EAAE;IAgCnB;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO;IAW5C;;;;;;OAMG;IACH,kBAAkB,CAAC,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI;CAU1D"}