crewly 1.6.0 → 1.6.2

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

@@ -0,0 +1,467 @@
+/**
+ * ChatV2Service — orchestrator for the Agent-First Chat MVP.
+ *
+ * Wires ChannelStore + MessageStore, enforces the authorization rules
+ * laid out in the tech spec §7.2, and maps DB rows to wire-format DTOs.
+ *
+ * WebSocket push, offline queuing, and attachment durability land in
+ * later passes of Phase 1 — see §18 rollout plan.
+ *
+ * @module services/chat-v2/chat-v2.service
+ */
+import { ChannelStore } from './sqlite/channel.store.js';
+import { MessageStore } from './sqlite/message.store.js';
+import { openChatDatabase } from './sqlite/chat-db.js';
+import { CHAT_CHANNEL_TYPES, CHAT_CONTENT_TYPES, CHAT_ERROR_CODES, ChatError, } from './types.js';
+// ---------------------------------------------------------------------------
+// Service
+// ---------------------------------------------------------------------------
+/** Default presence provider used until AgentRegistrationService is wired. */
+const DEFAULT_PRESENCE = () => ({
+    status: 'offline',
+    lastSeenAt: null,
+});
+/**
+ * Orchestrator for chat domain operations.
+ *
+ * Responsibilities:
+ * - Owns the DB handle + stores.
+ * - Enforces authorization per §7.2.
+ * - Maps rows → DTOs.
+ * - Fans out to WebSocket / adapters in later phases.
+ */
+export class ChatV2Service {
+    /** Phase A spec §3.2: max mention count per message. */
+    static MAX_MENTIONS_PER_MESSAGE = 50;
+    /** Phase A spec §3.2: max JSON-encoded byte size of the mentions array. */
+    static MAX_MENTIONS_JSON_BYTES = 1024;
+    config;
+    db;
+    channels;
+    messages;
+    presence;
+    validateTeamMembership;
+    now;
+    constructor(options) {
+        this.config = options.config;
+        this.db = options.db ?? openChatDatabase({ dbPath: options.config.storage.dbPath });
+        this.channels = new ChannelStore(this.db);
+        this.messages = new MessageStore(this.db);
+        this.presence = options.getPresence ?? DEFAULT_PRESENCE;
+        this.validateTeamMembership = options.validateTeamMembership;
+        this.now = options.now ?? Date.now;
+    }
+    /** Release the DB handle. Safe to call during graceful shutdown / in tests. */
+    close() {
+        try {
+            this.db.close();
+        }
+        catch {
+            // swallow — nothing to do if already closed
+        }
+    }
+    // -------------------------------------------------------------------------
+    // Channel operations
+    // -------------------------------------------------------------------------
+    /**
+     * Create a channel bound 1:1 to an agent session. Server always assigns
+     * `owner_user_id = principal.userId` — the body's owner fields are ignored.
+     *
+     * F2b (#333): when `type='channel'` and a `validateTeamMembership` provider
+     * is wired into the service, the principal must be authorized for the
+     * requested `teamId`. Failures throw `forbidden_team` (403) — distinct
+     * from generic `forbidden` so the FE can surface a tenant-specific
+     * message.
+     *
+     * @param args - Channel creation args
+     * @returns The created channel as a DTO
+     * @throws {ChatError} `validation_error` (400) / `forbidden_team` (403) /
+     *   `agent_already_bound` (409)
+     */
+    createChannel(args) {
+        const name = (args.name ?? '').trim();
+        if (name.length === 0) {
+            throw new ChatError(CHAT_ERROR_CODES.VALIDATION, 400, 'name is required');
+        }
+        if (name.length > this.config.maxChannelNameChars) {
+            throw new ChatError(CHAT_ERROR_CODES.VALIDATION, 400, `name exceeds ${this.config.maxChannelNameChars} characters`);
+        }
+        // Phase A: validate channel type (defaults to 'dm' for backwards compat).
+        const channelType = args.type ?? 'dm';
+        if (!CHAT_CHANNEL_TYPES.includes(channelType)) {
+            throw new ChatError(CHAT_ERROR_CODES.VALIDATION, 400, `unknown channel type: ${channelType}`);
+        }
+        // agentSession requirement is type-dependent:
+        //   - 'dm'      → required (existing Phase 1 contract).
+        //   - 'channel' → not 1:1-bound; server stores '' even if caller passed
+        //                 something. Keep this strict so the wire shape matches
+        //                 the design and we don't accidentally bind a team
+        //                 channel to a single agent.
+        const rawAgentSession = (args.agentSession ?? '').trim();
+        let agentSession;
+        if (channelType === 'dm') {
+            if (rawAgentSession.length === 0) {
+                throw new ChatError(CHAT_ERROR_CODES.VALIDATION, 400, "agentSession is required when type='dm'");
+            }
+            agentSession = rawAgentSession;
+        }
+        else {
+            // channel: discard any caller-supplied agentSession.
+            agentSession = '';
+        }
+        // Phase A: type='channel' must specify a teamId; type='dm' may
+        // optionally carry a targetMemberId. Reject the contradicting cases.
+        const teamId = args.teamId?.trim() || undefined;
+        const projectId = args.projectId?.trim() || undefined;
+        const targetMemberId = args.targetMemberId?.trim() || undefined;
+        if (channelType === 'channel' && !teamId) {
+            throw new ChatError(CHAT_ERROR_CODES.VALIDATION, 400, "teamId is required when type='channel'");
+        }
+        if (channelType === 'dm' && teamId) {
+            throw new ChatError(CHAT_ERROR_CODES.VALIDATION, 400, "teamId must be omitted when type='dm'");
+        }
+        if (channelType === 'channel' && targetMemberId) {
+            throw new ChatError(CHAT_ERROR_CODES.VALIDATION, 400, "targetMemberId must be omitted when type='channel'");
+        }
+        // F2b (#333) — outer-ring tenant defense. type='channel' bindings
+        // must pass the membership check when one is wired. Pre-checks
+        // already confirmed `teamId` is present and non-empty by here.
+        if (channelType === 'channel' && teamId && this.validateTeamMembership) {
+            const isMember = this.validateTeamMembership(args.principal, teamId);
+            if (!isMember) {
+                throw new ChatError(CHAT_ERROR_CODES.FORBIDDEN_TEAM, 403, 'caller is not a member of the requested team', { teamId, userId: args.principal.userId });
+            }
+        }
+        const purpose = args.purpose?.trim();
+        if (purpose && purpose.length > this.config.maxPurposeChars) {
+            throw new ChatError(CHAT_ERROR_CODES.VALIDATION, 400, `purpose exceeds ${this.config.maxPurposeChars} characters`);
+        }
+        const row = this.channels.create({
+            agentSession,
+            ownerUserId: args.principal.userId,
+            name,
+            purpose: purpose || null,
+            type: channelType,
+            teamId: teamId ?? null,
+            projectId: projectId ?? null,
+            targetMemberId: targetMemberId ?? null,
+            nowMs: this.now(),
+        });
+        return this.toChannelDTO(row);
+    }
+    /**
+     * List channels owned by the caller.
+     *
+     * Phase C: extended with optional `type` + `teamId` filters so the
+     * channel-rail can request a focused slice (e.g. "channels in this
+     * workspace only") without paging the full owner-scoped list. An
+     * unknown `type` value is rejected as `validation_error`. Blank
+     * `teamId` is normalized to "no filter" so callers don't need to
+     * sanitize empty query strings.
+     *
+     * @param args - List args (principal + optional filters)
+     * @returns DTO-mapped channels
+     * @throws {ChatError} `validation_error` (400) when `type` is set
+     *   to a value outside {@link CHAT_CHANNEL_TYPES}.
+     */
+    listChannels(args) {
+        if (args.type !== undefined && !CHAT_CHANNEL_TYPES.includes(args.type)) {
+            throw new ChatError(CHAT_ERROR_CODES.VALIDATION, 400, `unknown channel type: ${args.type}`);
+        }
+        // Treat blank teamId the same as omitted — saves the channel-rail FE
+        // from having to strip empty query strings before issuing the GET.
+        const teamIdFilter = args.teamId !== undefined && args.teamId.trim().length > 0
+            ? args.teamId
+            : undefined;
+        const rows = this.channels.listByOwner(args.principal.userId, {
+            includeArchived: args.includeArchived,
+            limit: args.limit,
+            type: args.type,
+            teamId: teamIdFilter,
+        });
+        return rows.map((r) => this.toChannelDTO(r));
+    }
+    /**
+     * Look up a single channel the caller owns.
+     *
+     * @param channelId - Channel id
+     * @param principal - Auth principal
+     * @returns DTO shape
+     * @throws {ChatError} `channel_not_found` (404) if the caller doesn't own it
+     */
+    getChannel(channelId, principal) {
+        const row = this.requireOwnedChannel(channelId, principal);
+        return this.toChannelDTO(row);
+    }
+    /**
+     * Archive a channel. Returns true if a row was modified.
+     *
+     * @param channelId - Channel id
+     * @param principal - Auth principal
+     * @returns True if newly archived, false if already archived
+     * @throws {ChatError} `channel_not_found` (404)
+     */
+    archiveChannel(channelId, principal) {
+        this.requireOwnedChannel(channelId, principal);
+        return this.channels.archive(channelId, this.now());
+    }
+    // -------------------------------------------------------------------------
+    // Message operations
+    // -------------------------------------------------------------------------
+    /**
+     * Persist a message sent by the caller. The server decides `sender_type`
+     * and `sender_id` from the auth principal; client fields are ignored.
+     *
+     * @param args - Send args
+     * @returns The persisted message as a DTO (fresh or deduped)
+     * @throws {ChatError} on validation, authorization, or size limit
+     */
+    sendMessage(args) {
+        const row = this.requireReadableChannel(args.channelId, args.principal);
+        const content = args.content ?? '';
+        if (content.length === 0) {
+            throw new ChatError(CHAT_ERROR_CODES.VALIDATION, 400, 'content is required');
+        }
+        const byteLen = Buffer.byteLength(content, 'utf-8');
+        if (byteLen > this.config.maxMessageBytes) {
+            throw new ChatError(CHAT_ERROR_CODES.PAYLOAD_TOO_LARGE, 413, `content exceeds max bytes (${this.config.maxMessageBytes})`, { maxBytes: this.config.maxMessageBytes, yourBytes: byteLen });
+        }
+        const contentType = args.contentType ?? 'markdown';
+        if (!CHAT_CONTENT_TYPES.includes(contentType)) {
+            throw new ChatError(CHAT_ERROR_CODES.VALIDATION, 400, `unknown contentType: ${contentType}`);
+        }
+        // Agents/users cannot self-tag as system.
+        if (contentType === 'system_note' && this.resolveSender(row, args.principal).type !== 'system') {
+            throw new ChatError(CHAT_ERROR_CODES.VALIDATION, 400, 'system_note can only be emitted server-side');
+        }
+        const { type: senderType, id: senderId } = this.resolveSender(row, args.principal);
+        // Phase A: validate mentions array. Bounded count + JSON-byte cap so
+        // a misbehaving client cannot blow past the spec §3.2 1KB ceiling.
+        const mentions = this.validateMentions(args.mentions);
+        // Phase A: validate threadId — must reference an existing message in
+        // this channel; refusing dangling thread refs prevents orphan replies
+        // and contains UX confusion if the FE composes against a stale id.
+        const threadId = this.validateThreadId(args.threadId, args.channelId);
+        const { row: persisted } = this.messages.insert({
+            channelId: args.channelId,
+            senderType,
+            senderId,
+            content,
+            contentType,
+            clientMessageId: args.clientMessageId,
+            mentions,
+            threadId,
+            nowMs: this.now(),
+        });
+        return this.toMessageDTO(persisted, args.attachments ?? []);
+    }
+    /**
+     * Phase A — validate the mentions array passed to sendMessage.
+     * Returns the cleaned array (or undefined when input is empty/missing).
+     *
+     * @param raw - The raw `mentions` field from the request body
+     * @returns Validated mention IDs (caller passes to messageStore)
+     * @throws {ChatError} `validation_error` (400) on type / size / count violation
+     */
+    validateMentions(raw) {
+        if (raw === undefined || raw === null)
+            return undefined;
+        if (!Array.isArray(raw)) {
+            throw new ChatError(CHAT_ERROR_CODES.VALIDATION, 400, 'mentions must be an array');
+        }
+        if (raw.length === 0)
+            return undefined;
+        if (raw.length > ChatV2Service.MAX_MENTIONS_PER_MESSAGE) {
+            throw new ChatError(CHAT_ERROR_CODES.VALIDATION, 400, `mentions exceeds max count (${ChatV2Service.MAX_MENTIONS_PER_MESSAGE})`);
+        }
+        const cleaned = [];
+        for (const item of raw) {
+            if (typeof item !== 'string') {
+                throw new ChatError(CHAT_ERROR_CODES.VALIDATION, 400, 'mentions entries must be strings');
+            }
+            const trimmed = item.trim();
+            if (trimmed.length === 0) {
+                throw new ChatError(CHAT_ERROR_CODES.VALIDATION, 400, 'mentions entries must be non-empty');
+            }
+            cleaned.push(trimmed);
+        }
+        // Bound the JSON size — spec §3.2 caps mentions JSON at 1KB.
+        const jsonByteLen = Buffer.byteLength(JSON.stringify(cleaned), 'utf-8');
+        if (jsonByteLen > ChatV2Service.MAX_MENTIONS_JSON_BYTES) {
+            throw new ChatError(CHAT_ERROR_CODES.PAYLOAD_TOO_LARGE, 413, `mentions JSON exceeds max bytes (${ChatV2Service.MAX_MENTIONS_JSON_BYTES})`);
+        }
+        return cleaned;
+    }
+    /**
+     * Phase A — validate the threadId passed to sendMessage.
+     *
+     * Returns the original threadId if it's a valid reference to a message
+     * in the same channel, or undefined when input is empty/missing.
+     * Refuses dangling references and cross-channel thread roots.
+     *
+     * @param raw - The raw `threadId` field from the request body
+     * @param channelId - The channel this message will be inserted into
+     * @returns Validated thread root id (caller passes to messageStore)
+     * @throws {ChatError} `validation_error` (400) when invalid
+     */
+    validateThreadId(raw, channelId) {
+        if (raw === undefined || raw === null)
+            return undefined;
+        if (typeof raw !== 'string') {
+            throw new ChatError(CHAT_ERROR_CODES.VALIDATION, 400, 'threadId must be a string');
+        }
+        const trimmed = raw.trim();
+        if (trimmed.length === 0)
+            return undefined;
+        const root = this.messages.getById(trimmed);
+        if (!root) {
+            throw new ChatError(CHAT_ERROR_CODES.VALIDATION, 400, `threadId references a non-existent message`, { threadId: trimmed });
+        }
+        if (root.channel_id !== channelId) {
+            // Returning validation_error (not channel_not_found) because the
+            // caller's intent IS valid — they're just pointing at the wrong
+            // channel's thread root. Distinct error helps debugging.
+            throw new ChatError(CHAT_ERROR_CODES.VALIDATION, 400, `threadId belongs to a different channel`, { threadId: trimmed, expectedChannelId: channelId });
+        }
+        return trimmed;
+    }
+    /**
+     * Page messages for a channel the caller may read.
+     *
+     * @param args - List args
+     * @returns A pagination envelope
+     * @throws {ChatError} on auth or invalid cursor
+     */
+    listMessages(args) {
+        this.requireReadableChannel(args.channelId, args.principal);
+        const page = this.messages.listByChannel(args.channelId, {
+            cursor: args.cursor ?? null,
+            limit: args.limit,
+            direction: args.direction,
+        });
+        return {
+            channelId: args.channelId,
+            messages: page.rows.map((r) => this.toMessageDTO(r, [])),
+            nextCursor: page.nextCursor,
+            prevCursor: page.prevCursor,
+        };
+    }
+    // -------------------------------------------------------------------------
+    // Authorization helpers (§7.2)
+    // -------------------------------------------------------------------------
+    /** Fetch the channel and enforce caller = owner. */
+    requireOwnedChannel(channelId, principal) {
+        const row = this.channels.getById(channelId);
+        if (!row) {
+            throw new ChatError(CHAT_ERROR_CODES.CHANNEL_NOT_FOUND, 404, 'Channel not found');
+        }
+        if (row.owner_user_id !== principal.userId) {
+            throw new ChatError(CHAT_ERROR_CODES.CHANNEL_NOT_FOUND, 404, 'Channel not found');
+        }
+        return row;
+    }
+    /**
+     * Fetch the channel and allow if the caller is the owner OR the bound agent.
+     * Used for read + send; agents must always be acting from their own session.
+     */
+    requireReadableChannel(channelId, principal) {
+        const row = this.channels.getById(channelId);
+        if (!row) {
+            throw new ChatError(CHAT_ERROR_CODES.CHANNEL_NOT_FOUND, 404, 'Channel not found');
+        }
+        const isOwner = row.owner_user_id === principal.userId;
+        const isBoundAgent = !!principal.agentSession && principal.agentSession === row.agent_session;
+        if (!isOwner && !isBoundAgent) {
+            throw new ChatError(CHAT_ERROR_CODES.CHANNEL_NOT_FOUND, 404, 'Channel not found');
+        }
+        if (row.archived_at) {
+            throw new ChatError(CHAT_ERROR_CODES.CHANNEL_ARCHIVED, 404, 'Channel is archived');
+        }
+        return row;
+    }
+    /** Decide sender_type + sender_id for a message based on principal + channel. */
+    resolveSender(channel, principal) {
+        if (principal.agentSession && principal.agentSession === channel.agent_session) {
+            return { type: 'agent', id: principal.agentSession };
+        }
+        if (principal.userId === channel.owner_user_id) {
+            return { type: 'user', id: principal.userId };
+        }
+        // Server-minted system messages go through an internal path, not this one.
+        throw new ChatError(CHAT_ERROR_CODES.FORBIDDEN, 403, 'Principal cannot send in this channel');
+    }
+    // -------------------------------------------------------------------------
+    // DTO mappers
+    // -------------------------------------------------------------------------
+    /** Map a channel row + live presence into the wire DTO. */
+    toChannelDTO(row) {
+        // Phase B backwards-compat: legacy rows (pre-migration) lack `type` /
+        // team scope fields. The migration backfills `type='dm'` for existing
+        // rows; here we defend the in-memory path against rows that may not
+        // yet have the column populated (e.g. mid-migration test runs).
+        const channelType = row.type ?? 'dm';
+        const presenceSource = channelType === 'dm' ? row.agent_session : '';
+        const presence = (this.presence ?? DEFAULT_PRESENCE)(presenceSource);
+        return {
+            id: row.id,
+            agentSession: row.agent_session,
+            name: row.name,
+            purpose: row.purpose ?? undefined,
+            createdAt: row.created_at,
+            archivedAt: row.archived_at ?? null,
+            lastMessageAt: row.last_message_at ?? null,
+            agentPresence: {
+                status: presence.status,
+                lastSeenAt: presence.lastSeenAt,
+            },
+            type: channelType,
+            teamId: row.team_id ?? undefined,
+            projectId: row.project_id ?? undefined,
+            targetMemberId: row.target_member_id ?? undefined,
+        };
+    }
+    /** Map a message row to the wire DTO. Attachments passed in by the caller. */
+    toMessageDTO(row, attachments) {
+        let metadata;
+        if (row.metadata) {
+            try {
+                metadata = JSON.parse(row.metadata);
+            }
+            catch {
+                metadata = undefined;
+            }
+        }
+        // Phase B backwards-compat: parse mentions from JSON-encoded array
+        // column. Legacy rows (pre-migration) have null; we surface as
+        // empty array so the wire contract `mentions: string[]` is never
+        // violated. A malformed JSON column also falls back to `[]` rather
+        // than throwing — the wire contract is the priority.
+        let mentions = [];
+        if (row.mentions) {
+            try {
+                const parsed = JSON.parse(row.mentions);
+                if (Array.isArray(parsed) && parsed.every((x) => typeof x === 'string')) {
+                    mentions = parsed;
+                }
+            }
+            catch {
+                mentions = [];
+            }
+        }
+        return {
+            id: row.id,
+            channelId: row.channel_id,
+            seq: row.seq,
+            senderType: row.sender_type,
+            senderId: row.sender_id,
+            content: row.content,
+            contentType: row.content_type,
+            createdAt: row.created_at,
+            attachments,
+            metadata,
+            mentions,
+            threadId: row.thread_id ?? undefined,
+        };
+    }
+}
+//# sourceMappingURL=chat-v2.service.js.map

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

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

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

@@ -0,0 +1,27 @@
+/**
+ * Process-wide singleton accessor for `ChatV2Service`.
+ *
+ * The server wiring layer calls `getChatV2Service()` once and holds the
+ * reference; tests can `resetChatV2Service()` to start fresh.
+ *
+ * @module services/chat-v2/chat-v2.singleton
+ */
+import { ChatV2Service, type ChatV2ServiceOptions } from './chat-v2.service.js';
+/**
+ * Return the process-wide `ChatV2Service`, constructing it on first call.
+ *
+ * @param overrides - Optional overrides passed when first constructed.
+ *   Ignored on subsequent calls.
+ * @returns The shared service instance
+ */
+export declare function getChatV2Service(overrides?: Partial<ChatV2ServiceOptions>): ChatV2Service;
+/**
+ * Replace the process-wide instance. Intended for tests and graceful
+ * shutdown paths; do not call from request handlers.
+ *
+ * @param next - Optional replacement; when omitted, the singleton is cleared
+ */
+export declare function setChatV2ServiceForTesting(next: ChatV2Service | null): void;
+/** Close the current instance (if any) and clear the singleton. */
+export declare function resetChatV2Service(): void;
+//# sourceMappingURL=chat-v2.singleton.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chat-v2.singleton.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/chat-v2/chat-v2.singleton.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,aAAa,EAAE,KAAK,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAKhF;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC,GAAG,aAAa,CAgBzF;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI,GAAG,IAAI,CAS3E;AAED,mEAAmE;AACnE,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC"}

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

@@ -0,0 +1,57 @@
+/**
+ * Process-wide singleton accessor for `ChatV2Service`.
+ *
+ * The server wiring layer calls `getChatV2Service()` once and holds the
+ * reference; tests can `resetChatV2Service()` to start fresh.
+ *
+ * @module services/chat-v2/chat-v2.singleton
+ */
+import { ChatV2Service } from './chat-v2.service.js';
+import { loadChatV2Config } from './config.js';
+let _instance = null;
+/**
+ * Return the process-wide `ChatV2Service`, constructing it on first call.
+ *
+ * @param overrides - Optional overrides passed when first constructed.
+ *   Ignored on subsequent calls.
+ * @returns The shared service instance
+ */
+export function getChatV2Service(overrides) {
+    if (!_instance) {
+        const config = overrides?.config ?? loadChatV2Config();
+        _instance = new ChatV2Service({
+            config,
+            db: overrides?.db,
+            getPresence: overrides?.getPresence,
+            // F2b (#333) — forward the validator so the production composition
+            // root in backend/src/index.ts can wire a teamId-existence /
+            // tenant-membership check on the singleton on first construction.
+            // Subsequent calls ignore overrides (existing contract).
+            validateTeamMembership: overrides?.validateTeamMembership,
+            now: overrides?.now,
+        });
+    }
+    return _instance;
+}
+/**
+ * Replace the process-wide instance. Intended for tests and graceful
+ * shutdown paths; do not call from request handlers.
+ *
+ * @param next - Optional replacement; when omitted, the singleton is cleared
+ */
+export function setChatV2ServiceForTesting(next) {
+    if (_instance && _instance !== next) {
+        try {
+            _instance.close();
+        }
+        catch {
+            // ignore — already closed
+        }
+    }
+    _instance = next;
+}
+/** Close the current instance (if any) and clear the singleton. */
+export function resetChatV2Service() {
+    setChatV2ServiceForTesting(null);
+}
+//# sourceMappingURL=chat-v2.singleton.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chat-v2.singleton.js","sourceRoot":"","sources":["../../../../../../backend/src/services/chat-v2/chat-v2.singleton.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,aAAa,EAA6B,MAAM,sBAAsB,CAAC;AAChF,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/C,IAAI,SAAS,GAAyB,IAAI,CAAC;AAE3C;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,SAAyC;IACxE,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,MAAM,GAAG,SAAS,EAAE,MAAM,IAAI,gBAAgB,EAAE,CAAC;QACvD,SAAS,GAAG,IAAI,aAAa,CAAC;YAC5B,MAAM;YACN,EAAE,EAAE,SAAS,EAAE,EAAE;YACjB,WAAW,EAAE,SAAS,EAAE,WAAW;YACnC,mEAAmE;YACnE,6DAA6D;YAC7D,kEAAkE;YAClE,yDAAyD;YACzD,sBAAsB,EAAE,SAAS,EAAE,sBAAsB;YACzD,GAAG,EAAE,SAAS,EAAE,GAAG;SACpB,CAAC,CAAC;IACL,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,0BAA0B,CAAC,IAA0B;IACnE,IAAI,SAAS,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;QACpC,IAAI,CAAC;YACH,SAAS,CAAC,KAAK,EAAE,CAAC;QACpB,CAAC;QAAC,MAAM,CAAC;YACP,0BAA0B;QAC5B,CAAC;IACH,CAAC;IACD,SAAS,GAAG,IAAI,CAAC;AACnB,CAAC;AAED,mEAAmE;AACnE,MAAM,UAAU,kBAAkB;IAChC,0BAA0B,CAAC,IAAI,CAAC,CAAC;AACnC,CAAC"}

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

@@ -0,0 +1,43 @@
+/**
+ * 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 type { ChatPrincipal } from './types.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 declare function createOssTeamMembershipValidator(deps?: {
+    /** Resolves the per-team config dir. Defaults to StorageService singleton. */
+    getTeamDir?: (teamId: string) => string;
+    /** Existence check. Override in tests to avoid touching the real FS. */
+    fileExists?: (filePath: string) => boolean;
+}): (principal: ChatPrincipal, teamId: string) => boolean;
+//# sourceMappingURL=chat-v2.team-membership.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chat-v2.team-membership.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/chat-v2/chat-v2.team-membership.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAKH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD;;;;;;;;;;;;GAYG;AACH,wBAAgB,gCAAgC,CAC9C,IAAI,GAAE;IACJ,8EAA8E;IAC9E,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,CAAC;IACxC,wEAAwE;IACxE,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC;CACvC,GACL,CAAC,SAAS,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,KAAK,OAAO,CAgBvD"}