@cats-inc/cats-platform 0.1.0

package/build/server/products/chat/shared/catProductIntentProposal.d.ts

@@ -0,0 +1,161 @@
+import { type SupervisedToolManifest } from '../../../platform/supervision/index.js';
+import type { DirectSlashModeCapabilityProfileKind } from '../api/contracts.js';
+import type { ChatNaturalProductIntentMode } from './naturalProductIntentMode.js';
+export type CatProductIntentProposalTargetProduct = 'work' | 'code';
+export type CatProductIntentProposalTransport = 'web' | 'telegram';
+export type CatProductIntentProposalTransitionEvent = 'confirmed' | 'declined' | 'expired';
+export declare const CAT_PRODUCT_INTENT_PROPOSAL_METADATA_KEY = "catProductIntentProposal";
+export declare const CAT_PRODUCT_INTENT_PROPOSAL_TRANSITION_METADATA_KEY = "catProductIntentProposalTransition";
+export declare const CAT_PRODUCT_INTENT_PROPOSAL_COMMAND_TOKEN = "(cat-proposal-confirmation)";
+export declare const CAT_PRODUCT_INTENT_PROPOSAL_TOOL_NAME = "proposeProductIntake";
+export interface CatProductIntentProposalToolInput {
+    targetProduct: CatProductIntentProposalTargetProduct;
+    sourceMessageId?: string;
+    title?: string;
+    summary: string;
+    rationale: string;
+    suggestedNextQuestion?: string;
+}
+export interface CatProductIntentProposalMetadata {
+    version: 2;
+    proposalId: string;
+    event: 'proposed';
+    source: {
+        messageId: string;
+        channelId: string;
+        conversationId: string;
+        transport: CatProductIntentProposalTransport;
+    };
+    proposedBy: {
+        catId: string;
+        actorId: string;
+        capabilityProfileKind: 'strong_agent';
+    };
+    proposal: {
+        targetProduct: CatProductIntentProposalTargetProduct;
+        title?: string;
+        summary: string;
+        rationale: string;
+        suggestedNextQuestion?: string;
+    };
+    createdAt: string;
+    expiresAt: string;
+}
+export interface ConfirmedCatProductIntentCommandMetadata {
+    sourceKind: 'cat_product_intent_proposal';
+    command: CatProductIntentProposalTargetProduct;
+    argumentText: string;
+    rawCommandToken: typeof CAT_PRODUCT_INTENT_PROPOSAL_COMMAND_TOKEN;
+    botSuffix: null;
+    proposalConfirmed: true;
+    originalProposalId: string;
+    originalMessageId: string;
+    proposedByCatId: string;
+}
+export interface CatProductIntentProposalTransitionMetadata {
+    version: 2;
+    proposalId: string;
+    event: CatProductIntentProposalTransitionEvent;
+    sourceMessageId: string;
+    proposedByCatId: string;
+    targetProduct: CatProductIntentProposalTargetProduct;
+    idempotencyKey: string;
+    confirmedCommand?: ConfirmedCatProductIntentCommandMetadata;
+}
+export interface BuildCatProductIntentProposalMetadataInput {
+    messageId: string;
+    channelId: string;
+    conversationId: string;
+    transport: CatProductIntentProposalTransport;
+    catId: string;
+    actorId: string;
+    targetProduct: CatProductIntentProposalTargetProduct;
+    title?: string | null;
+    summary: string;
+    rationale: string;
+    suggestedNextQuestion?: string | null;
+    now?: Date;
+}
+export interface BuildCatProductIntentProposalTransitionMetadataInput {
+    proposal: CatProductIntentProposalMetadata;
+    event: CatProductIntentProposalTransitionEvent;
+    originalMessageBody?: string;
+}
+export interface CatProductIntentProposalMetadataCarrier {
+    id?: string;
+    createdAt?: string;
+    metadata?: Record<string, unknown> | null;
+}
+export interface CatProductIntentProposalValidationInput {
+    toolInput: unknown;
+    effectiveMode: ChatNaturalProductIntentMode;
+    capabilityProfileKind: DirectSlashModeCapabilityProfileKind | null;
+    sourceMessage: {
+        id: string;
+        channelId: string;
+        senderKind: string;
+    } | null;
+    channelId: string;
+    cooldownActive: boolean;
+}
+export type CatProductIntentProposalValidationRejectionReason = 'feature_disabled' | 'proposal_tool_not_enabled' | 'direct_cat_not_strong' | 'cooldown_active' | 'invalid_tool_input' | 'missing_source_message' | 'source_message_not_owner' | 'source_message_wrong_lane';
+export type CatProductIntentProposalRejectionReason = CatProductIntentProposalValidationRejectionReason | 'missing_audience_cat' | 'duplicate_proposal';
+export type CatProductIntentProposalValidationResult = {
+    accepted: true;
+    toolInput: CatProductIntentProposalToolInput;
+} | {
+    accepted: false;
+    reason: CatProductIntentProposalValidationRejectionReason;
+    errors: string[];
+};
+export interface CatProductIntentProposalAcceptedResponse {
+    accepted: true;
+    proposalId: string;
+    idempotent?: false;
+}
+export interface CatProductIntentProposalIdempotentResponse {
+    accepted: true;
+    idempotent: true;
+    proposalId: string;
+}
+export interface CatProductIntentProposalRejectedResponse {
+    rejected: true;
+    reason: 'cooldown_active';
+}
+export type CatProductIntentProposalToolResponse = CatProductIntentProposalAcceptedResponse | CatProductIntentProposalIdempotentResponse | CatProductIntentProposalRejectedResponse;
+export declare function createCatProductIntentProposalToolManifest(): SupervisedToolManifest;
+export declare function buildCatProductIntentProposalId(input: {
+    messageId: string;
+    catId: string;
+    targetProduct: CatProductIntentProposalTargetProduct;
+}): string;
+export declare function buildCatProductIntentProposalTransitionIdempotencyKey(input: {
+    proposalId: string;
+    event: CatProductIntentProposalTransitionEvent;
+}): string;
+export declare function buildCatProductIntentProposalMetadata(input: BuildCatProductIntentProposalMetadataInput): CatProductIntentProposalMetadata;
+export declare function readCatProductIntentProposalMetadata(value: unknown): CatProductIntentProposalMetadata | null;
+export declare function buildCatProductIntentProposalTransitionMetadata(input: BuildCatProductIntentProposalTransitionMetadataInput): CatProductIntentProposalTransitionMetadata;
+export declare function readCatProductIntentProposalTransitionMetadata(value: unknown): CatProductIntentProposalTransitionMetadata | null;
+export declare function findCatProductIntentProposalTransition(input: {
+    messages: Iterable<CatProductIntentProposalMetadataCarrier>;
+    proposalId: string;
+}): CatProductIntentProposalTransitionMetadata | null;
+export declare function listOpenCatProductIntentProposals(messages: Iterable<CatProductIntentProposalMetadataCarrier>): CatProductIntentProposalMetadata[];
+export declare function shouldAppendCatProductIntentProposal(input: {
+    messages: Iterable<CatProductIntentProposalMetadataCarrier>;
+    proposalId: string;
+}): boolean;
+export declare function buildCatProductIntentProposalDuplicateResponse(proposalId: string): CatProductIntentProposalIdempotentResponse;
+export declare function buildCatProductIntentProposalCooldownResponse(): CatProductIntentProposalRejectedResponse;
+export declare function hasRecentCatProductIntentProposalDecline(input: {
+    messages: Iterable<CatProductIntentProposalMetadataCarrier>;
+    now: Date;
+}): boolean;
+export declare function listExpiredCatProductIntentProposals(input: {
+    messages: Iterable<CatProductIntentProposalMetadataCarrier>;
+    now: Date;
+    expireAll?: boolean;
+}): CatProductIntentProposalMetadata[];
+export declare function validateCatProductIntentProposalToolCall(input: CatProductIntentProposalValidationInput): CatProductIntentProposalValidationResult;
+//# sourceMappingURL=catProductIntentProposal.d.ts.map

package/build/server/products/chat/shared/catProductIntentProposal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catProductIntentProposal.d.ts","sourceRoot":"","sources":["../../../../../src/products/chat/shared/catProductIntentProposal.ts"],"names":[],"mappings":"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"}

package/build/server/products/chat/shared/catProductIntentProposal.js

@@ -0,0 +1,329 @@
+import { DEFAULT_SUPERVISION_SCHEMA_VERSION, } from '../../../platform/supervision/index.js';
+export const CAT_PRODUCT_INTENT_PROPOSAL_METADATA_KEY = 'catProductIntentProposal';
+export const CAT_PRODUCT_INTENT_PROPOSAL_TRANSITION_METADATA_KEY = 'catProductIntentProposalTransition';
+export const CAT_PRODUCT_INTENT_PROPOSAL_COMMAND_TOKEN = '(cat-proposal-confirmation)';
+export const CAT_PRODUCT_INTENT_PROPOSAL_TOOL_NAME = 'proposeProductIntake';
+const PROPOSAL_ID_PREFIX = 'cat-product-intent:v2';
+const TRANSITION_ID_PREFIX = 'cat-product-intent-transition:v2';
+const DEFAULT_PROPOSAL_TTL_MS = 15 * 60 * 1000;
+const PROPOSAL_DECLINE_COOLDOWN_MS = 5 * 60 * 1000;
+function normalizeOptionalText(value) {
+    const normalized = value?.replace(/\s+/gu, ' ').trim();
+    return normalized ? normalized : undefined;
+}
+function normalizeRequiredText(value) {
+    return value.replace(/\s+/gu, ' ').trim();
+}
+function readRecord(value) {
+    return value && typeof value === 'object' && !Array.isArray(value)
+        ? value
+        : null;
+}
+function readString(value) {
+    return typeof value === 'string' ? value : null;
+}
+function readTargetProduct(value) {
+    return value === 'work' || value === 'code' ? value : null;
+}
+export function createCatProductIntentProposalToolManifest() {
+    return {
+        schemaVersion: DEFAULT_SUPERVISION_SCHEMA_VERSION,
+        name: CAT_PRODUCT_INTENT_PROPOSAL_TOOL_NAME,
+        manifestVersion: '1.0',
+        description: 'Ask the owner to confirm turning this direct-chat message into Work or Code intake.',
+        sideEffect: 'local_state',
+        preflight: 'available',
+        blocking: 'blocking',
+        cancellation: 'cooperative',
+        approval: 'never',
+        evidence: 'summary',
+        failureCodes: ['E_TOOL_SCOPE_DENIED', 'E_SCHEMA_INVALID'],
+        inputSchema: {
+            id: `${CAT_PRODUCT_INTENT_PROPOSAL_TOOL_NAME}.input`,
+            version: '1.0',
+            format: 'json_schema',
+        },
+        outputSchema: {
+            id: `${CAT_PRODUCT_INTENT_PROPOSAL_TOOL_NAME}.output`,
+            version: '1.0',
+            format: 'json_schema',
+        },
+    };
+}
+export function buildCatProductIntentProposalId(input) {
+    return `${PROPOSAL_ID_PREFIX}:${input.messageId}:${input.catId}:${input.targetProduct}`;
+}
+export function buildCatProductIntentProposalTransitionIdempotencyKey(input) {
+    return `${TRANSITION_ID_PREFIX}:${input.proposalId}:${input.event}`;
+}
+export function buildCatProductIntentProposalMetadata(input) {
+    const summary = normalizeRequiredText(input.summary);
+    const rationale = normalizeRequiredText(input.rationale);
+    if (!summary) {
+        throw new Error('Cat product-intent proposal summary is required.');
+    }
+    if (!rationale) {
+        throw new Error('Cat product-intent proposal rationale is required.');
+    }
+    const now = input.now ?? new Date();
+    const title = normalizeOptionalText(input.title);
+    const suggestedNextQuestion = normalizeOptionalText(input.suggestedNextQuestion);
+    return {
+        version: 2,
+        proposalId: buildCatProductIntentProposalId({
+            messageId: input.messageId,
+            catId: input.catId,
+            targetProduct: input.targetProduct,
+        }),
+        event: 'proposed',
+        source: {
+            messageId: input.messageId,
+            channelId: input.channelId,
+            conversationId: input.conversationId,
+            transport: input.transport,
+        },
+        proposedBy: {
+            catId: input.catId,
+            actorId: input.actorId,
+            capabilityProfileKind: 'strong_agent',
+        },
+        proposal: {
+            targetProduct: input.targetProduct,
+            ...(title ? { title } : {}),
+            summary,
+            rationale,
+            ...(suggestedNextQuestion ? { suggestedNextQuestion } : {}),
+        },
+        createdAt: now.toISOString(),
+        expiresAt: new Date(now.getTime() + DEFAULT_PROPOSAL_TTL_MS).toISOString(),
+    };
+}
+export function readCatProductIntentProposalMetadata(value) {
+    const record = readRecord(value);
+    const source = readRecord(record?.source);
+    const proposedBy = readRecord(record?.proposedBy);
+    const proposal = readRecord(record?.proposal);
+    const targetProduct = readTargetProduct(proposal?.targetProduct);
+    if (record?.version !== 2
+        || record.event !== 'proposed'
+        || typeof record.proposalId !== 'string'
+        || !source
+        || typeof source.messageId !== 'string'
+        || typeof source.channelId !== 'string'
+        || typeof source.conversationId !== 'string'
+        || (source.transport !== 'web' && source.transport !== 'telegram')
+        || !proposedBy
+        || typeof proposedBy.catId !== 'string'
+        || typeof proposedBy.actorId !== 'string'
+        || proposedBy.capabilityProfileKind !== 'strong_agent'
+        || !proposal
+        || !targetProduct
+        || typeof proposal.summary !== 'string'
+        || typeof proposal.rationale !== 'string'
+        || typeof record.createdAt !== 'string'
+        || typeof record.expiresAt !== 'string') {
+        return null;
+    }
+    return record;
+}
+export function buildCatProductIntentProposalTransitionMetadata(input) {
+    const idempotencyKey = buildCatProductIntentProposalTransitionIdempotencyKey({
+        proposalId: input.proposal.proposalId,
+        event: input.event,
+    });
+    const base = {
+        version: 2,
+        proposalId: input.proposal.proposalId,
+        event: input.event,
+        sourceMessageId: input.proposal.source.messageId,
+        proposedByCatId: input.proposal.proposedBy.catId,
+        targetProduct: input.proposal.proposal.targetProduct,
+        idempotencyKey,
+    };
+    if (input.event !== 'confirmed') {
+        return base;
+    }
+    const argumentText = input.proposal.proposal.summary.trim()
+        || (input.originalMessageBody ?? '').trim();
+    return {
+        ...base,
+        confirmedCommand: {
+            sourceKind: 'cat_product_intent_proposal',
+            command: input.proposal.proposal.targetProduct,
+            argumentText,
+            rawCommandToken: CAT_PRODUCT_INTENT_PROPOSAL_COMMAND_TOKEN,
+            botSuffix: null,
+            proposalConfirmed: true,
+            originalProposalId: input.proposal.proposalId,
+            originalMessageId: input.proposal.source.messageId,
+            proposedByCatId: input.proposal.proposedBy.catId,
+        },
+    };
+}
+export function readCatProductIntentProposalTransitionMetadata(value) {
+    const record = readRecord(value);
+    const targetProduct = readTargetProduct(record?.targetProduct);
+    if (record?.version !== 2
+        || typeof record.proposalId !== 'string'
+        || (record.event !== 'confirmed'
+            && record.event !== 'declined'
+            && record.event !== 'expired')
+        || typeof record.sourceMessageId !== 'string'
+        || typeof record.proposedByCatId !== 'string'
+        || !targetProduct
+        || typeof record.idempotencyKey !== 'string') {
+        return null;
+    }
+    return record;
+}
+export function findCatProductIntentProposalTransition(input) {
+    for (const message of input.messages) {
+        const transition = readCatProductIntentProposalTransitionMetadata(message.metadata?.[CAT_PRODUCT_INTENT_PROPOSAL_TRANSITION_METADATA_KEY]);
+        if (transition?.proposalId === input.proposalId) {
+            return transition;
+        }
+    }
+    return null;
+}
+export function listOpenCatProductIntentProposals(messages) {
+    const messageList = Array.from(messages);
+    return messageList.flatMap((message) => {
+        const proposal = readCatProductIntentProposalMetadata(message.metadata?.[CAT_PRODUCT_INTENT_PROPOSAL_METADATA_KEY]);
+        if (!proposal) {
+            return [];
+        }
+        return findCatProductIntentProposalTransition({
+            messages: messageList,
+            proposalId: proposal.proposalId,
+        })
+            ? []
+            : [proposal];
+    });
+}
+export function shouldAppendCatProductIntentProposal(input) {
+    for (const message of input.messages) {
+        const proposal = readCatProductIntentProposalMetadata(message.metadata?.[CAT_PRODUCT_INTENT_PROPOSAL_METADATA_KEY]);
+        if (proposal?.proposalId === input.proposalId) {
+            return false;
+        }
+    }
+    return true;
+}
+export function buildCatProductIntentProposalDuplicateResponse(proposalId) {
+    return {
+        accepted: true,
+        idempotent: true,
+        proposalId,
+    };
+}
+export function buildCatProductIntentProposalCooldownResponse() {
+    return {
+        rejected: true,
+        reason: 'cooldown_active',
+    };
+}
+export function hasRecentCatProductIntentProposalDecline(input) {
+    for (const message of input.messages) {
+        const transition = readCatProductIntentProposalTransitionMetadata(message.metadata?.[CAT_PRODUCT_INTENT_PROPOSAL_TRANSITION_METADATA_KEY]);
+        if (transition?.event !== 'declined') {
+            continue;
+        }
+        const declinedAt = Date.parse(message.createdAt ?? '');
+        if (Number.isFinite(declinedAt)
+            && input.now.getTime() - declinedAt < PROPOSAL_DECLINE_COOLDOWN_MS) {
+            return true;
+        }
+    }
+    return false;
+}
+export function listExpiredCatProductIntentProposals(input) {
+    return listOpenCatProductIntentProposals(input.messages).filter((proposal) => {
+        if (input.expireAll) {
+            return true;
+        }
+        const expiresAt = Date.parse(proposal.expiresAt);
+        return Number.isFinite(expiresAt) && expiresAt <= input.now.getTime();
+    });
+}
+export function validateCatProductIntentProposalToolCall(input) {
+    if (input.effectiveMode === 'off') {
+        return rejectProposalToolCall('feature_disabled');
+    }
+    if (input.effectiveMode !== 'cat_tool') {
+        return rejectProposalToolCall('proposal_tool_not_enabled');
+    }
+    if (input.capabilityProfileKind !== 'strong_agent') {
+        return rejectProposalToolCall('direct_cat_not_strong');
+    }
+    if (input.cooldownActive) {
+        return rejectProposalToolCall('cooldown_active');
+    }
+    const normalized = normalizeCatProductIntentProposalToolInput(input.toolInput);
+    if (!normalized.accepted) {
+        return normalized;
+    }
+    if (!input.sourceMessage) {
+        return rejectProposalToolCall('missing_source_message');
+    }
+    if (input.sourceMessage.senderKind !== 'user') {
+        return rejectProposalToolCall('source_message_not_owner');
+    }
+    if (input.sourceMessage.channelId !== input.channelId) {
+        return rejectProposalToolCall('source_message_wrong_lane');
+    }
+    return normalized;
+}
+function normalizeCatProductIntentProposalToolInput(value) {
+    const record = readRecord(value);
+    const errors = [];
+    const targetProduct = readTargetProduct(record?.targetProduct);
+    const summary = readString(record?.summary);
+    const rationale = readString(record?.rationale);
+    if (!record) {
+        return rejectProposalToolCall('invalid_tool_input', ['tool input must be an object']);
+    }
+    if (!targetProduct) {
+        errors.push('targetProduct must be work or code');
+    }
+    if (!summary || normalizeRequiredText(summary).length === 0) {
+        errors.push('summary is required');
+    }
+    if (!rationale || normalizeRequiredText(rationale).length === 0) {
+        errors.push('rationale is required');
+    }
+    if (record.sourceMessageId !== undefined && typeof record.sourceMessageId !== 'string') {
+        errors.push('sourceMessageId must be a string when provided');
+    }
+    if (record.title !== undefined && typeof record.title !== 'string') {
+        errors.push('title must be a string when provided');
+    }
+    if (record.suggestedNextQuestion !== undefined
+        && typeof record.suggestedNextQuestion !== 'string') {
+        errors.push('suggestedNextQuestion must be a string when provided');
+    }
+    if (errors.length > 0 || !targetProduct || !summary || !rationale) {
+        return rejectProposalToolCall('invalid_tool_input', errors);
+    }
+    const sourceMessageId = normalizeOptionalText(record.sourceMessageId);
+    const title = normalizeOptionalText(record.title);
+    const suggestedNextQuestion = normalizeOptionalText(record.suggestedNextQuestion);
+    return {
+        accepted: true,
+        toolInput: {
+            targetProduct,
+            ...(sourceMessageId ? { sourceMessageId } : {}),
+            ...(title ? { title } : {}),
+            summary: normalizeRequiredText(summary),
+            rationale: normalizeRequiredText(rationale),
+            ...(suggestedNextQuestion ? { suggestedNextQuestion } : {}),
+        },
+    };
+}
+function rejectProposalToolCall(reason, errors = [reason]) {
+    return {
+        accepted: false,
+        reason,
+        errors,
+    };
+}
+//# sourceMappingURL=catProductIntentProposal.js.map

package/build/server/products/chat/shared/catProductIntentProposal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catProductIntentProposal.js","sourceRoot":"","sources":["../../../../../src/products/chat/shared/catProductIntentProposal.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kCAAkC,GAEnC,MAAM,wCAAwC,CAAC;AAahD,MAAM,CAAC,MAAM,wCAAwC,GACnD,0BAA0B,CAAC;AAC7B,MAAM,CAAC,MAAM,mDAAmD,GAC9D,oCAAoC,CAAC;AACvC,MAAM,CAAC,MAAM,yCAAyC,GACpD,6BAA6B,CAAC;AAChC,MAAM,CAAC,MAAM,qCAAqC,GAAG,sBAAsB,CAAC;AAE5E,MAAM,kBAAkB,GAAG,uBAAuB,CAAC;AACnD,MAAM,oBAAoB,GAAG,kCAAkC,CAAC;AAChE,MAAM,uBAAuB,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAC/C,MAAM,4BAA4B,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;AAoJnD,SAAS,qBAAqB,CAAC,KAAgC;IAC7D,MAAM,UAAU,GAAG,KAAK,EAAE,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IACvD,OAAO,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC;AAC7C,CAAC;AAED,SAAS,qBAAqB,CAAC,KAAa;IAC1C,OAAO,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;AAC5C,CAAC;AAED,SAAS,UAAU,CAAC,KAAc;IAChC,OAAO,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAChE,CAAC,CAAC,KAAgC;QAClC,CAAC,CAAC,IAAI,CAAC;AACX,CAAC;AAED,SAAS,UAAU,CAAC,KAAc;IAChC,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;AAClD,CAAC;AAED,SAAS,iBAAiB,CAAC,KAAc;IACvC,OAAO,KAAK,KAAK,MAAM,IAAI,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;AAC7D,CAAC;AAED,MAAM,UAAU,0CAA0C;IACxD,OAAO;QACL,aAAa,EAAE,kCAAkC;QACjD,IAAI,EAAE,qCAAqC;QAC3C,eAAe,EAAE,KAAK;QACtB,WAAW,EAAE,qFAAqF;QAClG,UAAU,EAAE,aAAa;QACzB,SAAS,EAAE,WAAW;QACtB,QAAQ,EAAE,UAAU;QACpB,YAAY,EAAE,aAAa;QAC3B,QAAQ,EAAE,OAAO;QACjB,QAAQ,EAAE,SAAS;QACnB,YAAY,EAAE,CAAC,qBAAqB,EAAE,kBAAkB,CAAC;QACzD,WAAW,EAAE;YACX,EAAE,EAAE,GAAG,qCAAqC,QAAQ;YACpD,OAAO,EAAE,KAAK;YACd,MAAM,EAAE,aAAa;SACtB;QACD,YAAY,EAAE;YACZ,EAAE,EAAE,GAAG,qCAAqC,SAAS;YACrD,OAAO,EAAE,KAAK;YACd,MAAM,EAAE,aAAa;SACtB;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,+BAA+B,CAAC,KAI/C;IACC,OAAO,GAAG,kBAAkB,IAAI,KAAK,CAAC,SAAS,IAAI,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,aAAa,EAAE,CAAC;AAC1F,CAAC;AAED,MAAM,UAAU,qDAAqD,CAAC,KAGrE;IACC,OAAO,GAAG,oBAAoB,IAAI,KAAK,CAAC,UAAU,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;AACtE,CAAC;AAED,MAAM,UAAU,qCAAqC,CACnD,KAAiD;IAEjD,MAAM,OAAO,GAAG,qBAAqB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACrD,MAAM,SAAS,GAAG,qBAAqB,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IACzD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;IACtE,CAAC;IACD,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;IACxE,CAAC;IAED,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,IAAI,IAAI,IAAI,EAAE,CAAC;IACpC,MAAM,KAAK,GAAG,qBAAqB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACjD,MAAM,qBAAqB,GAAG,qBAAqB,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC;IACjF,OAAO;QACL,OAAO,EAAE,CAAC;QACV,UAAU,EAAE,+BAA+B,CAAC;YAC1C,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,aAAa,EAAE,KAAK,CAAC,aAAa;SACnC,CAAC;QACF,KAAK,EAAE,UAAU;QACjB,MAAM,EAAE;YACN,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,cAAc,EAAE,KAAK,CAAC,cAAc;YACpC,SAAS,EAAE,KAAK,CAAC,SAAS;SAC3B;QACD,UAAU,EAAE;YACV,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,qBAAqB,EAAE,cAAc;SACtC;QACD,QAAQ,EAAE;YACR,aAAa,EAAE,KAAK,CAAC,aAAa;YAClC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC3B,OAAO;YACP,SAAS;YACT,GAAG,CAAC,qBAAqB,CAAC,CAAC,CAAC,EAAE,qBAAqB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC5D;QACD,SAAS,EAAE,GAAG,CAAC,WAAW,EAAE;QAC5B,SAAS,EAAE,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,uBAAuB,CAAC,CAAC,WAAW,EAAE;KAC3E,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,oCAAoC,CAClD,KAAc;IAEd,MAAM,MAAM,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;IACjC,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,MAAM,UAAU,GAAG,UAAU,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAClD,MAAM,QAAQ,GAAG,UAAU,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC9C,MAAM,aAAa,GAAG,iBAAiB,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;IACjE,IACE,MAAM,EAAE,OAAO,KAAK,CAAC;WAClB,MAAM,CAAC,KAAK,KAAK,UAAU;WAC3B,OAAO,MAAM,CAAC,UAAU,KAAK,QAAQ;WACrC,CAAC,MAAM;WACP,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ;WACpC,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ;WACpC,OAAO,MAAM,CAAC,cAAc,KAAK,QAAQ;WACzC,CAAC,MAAM,CAAC,SAAS,KAAK,KAAK,IAAI,MAAM,CAAC,SAAS,KAAK,UAAU,CAAC;WAC/D,CAAC,UAAU;WACX,OAAO,UAAU,CAAC,KAAK,KAAK,QAAQ;WACpC,OAAO,UAAU,CAAC,OAAO,KAAK,QAAQ;WACtC,UAAU,CAAC,qBAAqB,KAAK,cAAc;WACnD,CAAC,QAAQ;WACT,CAAC,aAAa;WACd,OAAO,QAAQ,CAAC,OAAO,KAAK,QAAQ;WACpC,OAAO,QAAQ,CAAC,SAAS,KAAK,QAAQ;WACtC,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ;WACpC,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ,EACvC,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,MAAqD,CAAC;AAC/D,CAAC;AAED,MAAM,UAAU,+CAA+C,CAC7D,KAA2D;IAE3D,MAAM,cAAc,GAAG,qDAAqD,CAAC;QAC3E,UAAU,EAAE,KAAK,CAAC,QAAQ,CAAC,UAAU;QACrC,KAAK,EAAE,KAAK,CAAC,KAAK;KACnB,CAAC,CAAC;IACH,MAAM,IAAI,GAAG;QACX,OAAO,EAAE,CAAU;QACnB,UAAU,EAAE,KAAK,CAAC,QAAQ,CAAC,UAAU;QACrC,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,eAAe,EAAE,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS;QAChD,eAAe,EAAE,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,KAAK;QAChD,aAAa,EAAE,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,aAAa;QACpD,cAAc;KACf,CAAC;IACF,IAAI,KAAK,CAAC,KAAK,KAAK,WAAW,EAAE,CAAC;QAChC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,YAAY,GAAG,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE;WACtD,CAAC,KAAK,CAAC,mBAAmB,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC9C,OAAO;QACL,GAAG,IAAI;QACP,gBAAgB,EAAE;YAChB,UAAU,EAAE,6BAA6B;YACzC,OAAO,EAAE,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,aAAa;YAC9C,YAAY;YACZ,eAAe,EAAE,yCAAyC;YAC1D,SAAS,EAAE,IAAI;YACf,iBAAiB,EAAE,IAAI;YACvB,kBAAkB,EAAE,KAAK,CAAC,QAAQ,CAAC,UAAU;YAC7C,iBAAiB,EAAE,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS;YAClD,eAAe,EAAE,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,KAAK;SACjD;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,8CAA8C,CAC5D,KAAc;IAEd,MAAM,MAAM,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;IACjC,MAAM,aAAa,GAAG,iBAAiB,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAC/D,IACE,MAAM,EAAE,OAAO,KAAK,CAAC;WAClB,OAAO,MAAM,CAAC,UAAU,KAAK,QAAQ;WACrC,CACD,MAAM,CAAC,KAAK,KAAK,WAAW;eACzB,MAAM,CAAC,KAAK,KAAK,UAAU;eAC3B,MAAM,CAAC,KAAK,KAAK,SAAS,CAC9B;WACE,OAAO,MAAM,CAAC,eAAe,KAAK,QAAQ;WAC1C,OAAO,MAAM,CAAC,eAAe,KAAK,QAAQ;WAC1C,CAAC,aAAa;WACd,OAAO,MAAM,CAAC,cAAc,KAAK,QAAQ,EAC5C,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,MAA+D,CAAC;AACzE,CAAC;AAED,MAAM,UAAU,sCAAsC,CAAC,KAGtD;IACC,KAAK,MAAM,OAAO,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;QACrC,MAAM,UAAU,GAAG,8CAA8C,CAC/D,OAAO,CAAC,QAAQ,EAAE,CAAC,mDAAmD,CAAC,CACxE,CAAC;QACF,IAAI,UAAU,EAAE,UAAU,KAAK,KAAK,CAAC,UAAU,EAAE,CAAC;YAChD,OAAO,UAAU,CAAC;QACpB,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,iCAAiC,CAC/C,QAA2D;IAE3D,MAAM,WAAW,GAAG,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACzC,OAAO,WAAW,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QACrC,MAAM,QAAQ,GAAG,oCAAoC,CACnD,OAAO,CAAC,QAAQ,EAAE,CAAC,wCAAwC,CAAC,CAC7D,CAAC;QACF,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,OAAO,sCAAsC,CAAC;YAC5C,QAAQ,EAAE,WAAW;YACrB,UAAU,EAAE,QAAQ,CAAC,UAAU;SAChC,CAAC;YACA,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;IACjB,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,oCAAoC,CAAC,KAGpD;IACC,KAAK,MAAM,OAAO,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;QACrC,MAAM,QAAQ,GAAG,oCAAoC,CACnD,OAAO,CAAC,QAAQ,EAAE,CAAC,wCAAwC,CAAC,CAC7D,CAAC;QACF,IAAI,QAAQ,EAAE,UAAU,KAAK,KAAK,CAAC,UAAU,EAAE,CAAC;YAC9C,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,8CAA8C,CAC5D,UAAkB;IAElB,OAAO;QACL,QAAQ,EAAE,IAAI;QACd,UAAU,EAAE,IAAI;QAChB,UAAU;KACX,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,6CAA6C;IAE3D,OAAO;QACL,QAAQ,EAAE,IAAI;QACd,MAAM,EAAE,iBAAiB;KAC1B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,wCAAwC,CAAC,KAGxD;IACC,KAAK,MAAM,OAAO,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;QACrC,MAAM,UAAU,GAAG,8CAA8C,CAC/D,OAAO,CAAC,QAAQ,EAAE,CAAC,mDAAmD,CAAC,CACxE,CAAC;QACF,IAAI,UAAU,EAAE,KAAK,KAAK,UAAU,EAAE,CAAC;YACrC,SAAS;QACX,CAAC;QACD,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC;QACvD,IACE,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC;eACxB,KAAK,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,UAAU,GAAG,4BAA4B,EAClE,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,oCAAoC,CAAC,KAIpD;IACC,OAAO,iCAAiC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE;QAC3E,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;YACpB,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QACjD,OAAO,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,SAAS,IAAI,KAAK,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;IACxE,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,wCAAwC,CACtD,KAA8C;IAE9C,IAAI,KAAK,CAAC,aAAa,KAAK,KAAK,EAAE,CAAC;QAClC,OAAO,sBAAsB,CAAC,kBAAkB,CAAC,CAAC;IACpD,CAAC;IACD,IAAI,KAAK,CAAC,aAAa,KAAK,UAAU,EAAE,CAAC;QACvC,OAAO,sBAAsB,CAAC,2BAA2B,CAAC,CAAC;IAC7D,CAAC;IACD,IAAI,KAAK,CAAC,qBAAqB,KAAK,cAAc,EAAE,CAAC;QACnD,OAAO,sBAAsB,CAAC,uBAAuB,CAAC,CAAC;IACzD,CAAC;IACD,IAAI,KAAK,CAAC,cAAc,EAAE,CAAC;QACzB,OAAO,sBAAsB,CAAC,iBAAiB,CAAC,CAAC;IACnD,CAAC;IAED,MAAM,UAAU,GAAG,0CAA0C,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAC/E,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC;QACzB,OAAO,UAAU,CAAC;IACpB,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,aAAa,EAAE,CAAC;QACzB,OAAO,sBAAsB,CAAC,wBAAwB,CAAC,CAAC;IAC1D,CAAC;IACD,IAAI,KAAK,CAAC,aAAa,CAAC,UAAU,KAAK,MAAM,EAAE,CAAC;QAC9C,OAAO,sBAAsB,CAAC,0BAA0B,CAAC,CAAC;IAC5D,CAAC;IACD,IAAI,KAAK,CAAC,aAAa,CAAC,SAAS,KAAK,KAAK,CAAC,SAAS,EAAE,CAAC;QACtD,OAAO,sBAAsB,CAAC,2BAA2B,CAAC,CAAC;IAC7D,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,SAAS,0CAA0C,CACjD,KAAc;IAEd,MAAM,MAAM,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;IACjC,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,aAAa,GAAG,iBAAiB,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAC/D,MAAM,OAAO,GAAG,UAAU,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC5C,MAAM,SAAS,GAAG,UAAU,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAChD,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,sBAAsB,CAAC,oBAAoB,EAAE,CAAC,8BAA8B,CAAC,CAAC,CAAC;IACxF,CAAC;IACD,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,MAAM,CAAC,IAAI,CAAC,oCAAoC,CAAC,CAAC;IACpD,CAAC;IACD,IAAI,CAAC,OAAO,IAAI,qBAAqB,CAAC,OAAO,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5D,MAAM,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;IACrC,CAAC;IACD,IAAI,CAAC,SAAS,IAAI,qBAAqB,CAAC,SAAS,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAChE,MAAM,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;IACvC,CAAC;IACD,IAAI,MAAM,CAAC,eAAe,KAAK,SAAS,IAAI,OAAO,MAAM,CAAC,eAAe,KAAK,QAAQ,EAAE,CAAC;QACvF,MAAM,CAAC,IAAI,CAAC,gDAAgD,CAAC,CAAC;IAChE,CAAC;IACD,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,IAAI,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;QACnE,MAAM,CAAC,IAAI,CAAC,sCAAsC,CAAC,CAAC;IACtD,CAAC;IACD,IACE,MAAM,CAAC,qBAAqB,KAAK,SAAS;WACvC,OAAO,MAAM,CAAC,qBAAqB,KAAK,QAAQ,EACnD,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,sDAAsD,CAAC,CAAC;IACtE,CAAC;IACD,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,aAAa,IAAI,CAAC,OAAO,IAAI,CAAC,SAAS,EAAE,CAAC;QAClE,OAAO,sBAAsB,CAAC,oBAAoB,EAAE,MAAM,CAAC,CAAC;IAC9D,CAAC;IAED,MAAM,eAAe,GAAG,qBAAqB,CAAC,MAAM,CAAC,eAAqC,CAAC,CAAC;IAC5F,MAAM,KAAK,GAAG,qBAAqB,CAAC,MAAM,CAAC,KAA2B,CAAC,CAAC;IACxE,MAAM,qBAAqB,GAAG,qBAAqB,CACjD,MAAM,CAAC,qBAA2C,CACnD,CAAC;IAEF,OAAO;QACL,QAAQ,EAAE,IAAI;QACd,SAAS,EAAE;YACT,aAAa;YACb,GAAG,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC/C,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC3B,OAAO,EAAE,qBAAqB,CAAC,OAAO,CAAC;YACvC,SAAS,EAAE,qBAAqB,CAAC,SAAS,CAAC;YAC3C,GAAG,CAAC,qBAAqB,CAAC,CAAC,CAAC,EAAE,qBAAqB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC5D;KACF,CAAC;AACJ,CAAC;AAED,SAAS,sBAAsB,CAC7B,MAAyD,EACzD,SAAmB,CAAC,MAAM,CAAC;IAE3B,OAAO;QACL,QAAQ,EAAE,KAAK;QACf,MAAM;QACN,MAAM;KACP,CAAC;AACJ,CAAC"}

package/build/server/products/chat/shared/catStatusResolution.d.ts

@@ -0,0 +1,16 @@
+import type { ChatCat, ChatChannelView } from '../api/contracts.js';
+import type { ChatOperatorView } from './operator-loop/types.js';
+import { type MessageKey } from '../../../shared/i18n/index.js';
+export type CatStatusKind = 'active' | 'blocked' | 'waiting_for_review' | 'idle' | 'sleeping' | 'error';
+export interface CatStatusIndicator {
+    catId: string;
+    catName: string;
+    avatarColor: string | null;
+    status: CatStatusKind;
+    statusLabelKey: MessageKey;
+    busy: boolean;
+}
+export type CatStatusChannelView = Pick<ChatChannelView, 'catAssignments'>;
+export type CatStatusOperatorView = Pick<ChatOperatorView, 'approvals' | 'latestRun'>;
+export declare function resolveCatStatusIndicator(cat: ChatCat, channel: CatStatusChannelView, operatorView: CatStatusOperatorView | null): CatStatusIndicator;
+//# sourceMappingURL=catStatusResolution.d.ts.map

package/build/server/products/chat/shared/catStatusResolution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catStatusResolution.d.ts","sourceRoot":"","sources":["../../../../../src/products/chat/shared/catStatusResolution.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACpE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAEjE,OAAO,EAAe,KAAK,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAE7E,MAAM,MAAM,aAAa,GACrB,QAAQ,GACR,SAAS,GACT,oBAAoB,GACpB,MAAM,GACN,UAAU,GACV,OAAO,CAAC;AAEZ,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,MAAM,EAAE,aAAa,CAAC;IACtB,cAAc,EAAE,UAAU,CAAC;IAC3B,IAAI,EAAE,OAAO,CAAC;CACf;AAED,MAAM,MAAM,oBAAoB,GAAG,IAAI,CAAC,eAAe,EAAE,gBAAgB,CAAC,CAAC;AAC3E,MAAM,MAAM,qBAAqB,GAAG,IAAI,CAAC,gBAAgB,EAAE,WAAW,GAAG,WAAW,CAAC,CAAC;AAEtF,wBAAgB,yBAAyB,CACvC,GAAG,EAAE,OAAO,EACZ,OAAO,EAAE,oBAAoB,EAC7B,YAAY,EAAE,qBAAqB,GAAG,IAAI,GACzC,kBAAkB,CAiDpB"}

package/build/server/products/chat/shared/catStatusResolution.js

@@ -0,0 +1,52 @@
+import { resolveChatLifecycleState } from './lifecycle.js';
+import { messageKeys } from '../../../shared/i18n/index.js';
+export function resolveCatStatusIndicator(cat, channel, operatorView) {
+    const assignment = channel.catAssignments?.find((a) => a.catId === cat.id);
+    const leaseStatus = assignment?.execution?.lease?.status ?? 'not_started';
+    const lifecycle = resolveChatLifecycleState(leaseStatus);
+    // Check operator-level state for blocked/review conditions
+    const hasPendingApproval = operatorView?.approvals.some((a) => a.status === 'pending') ?? false;
+    const hasBlockedRun = operatorView?.latestRun?.status === 'blocked';
+    let status;
+    let statusLabelKey;
+    let busy = false;
+    if (lifecycle === 'error') {
+        status = 'error';
+        statusLabelKey = messageKeys.chatCatStatusErrorLabel;
+    }
+    else if (hasPendingApproval) {
+        status = 'waiting_for_review';
+        statusLabelKey = messageKeys.chatCatStatusWaitingForReviewLabel;
+    }
+    else if (hasBlockedRun) {
+        status = 'blocked';
+        statusLabelKey = messageKeys.chatCatStatusBlockedLabel;
+    }
+    else if (lifecycle === 'awake') {
+        status = 'active';
+        statusLabelKey = messageKeys.chatCatStatusActiveLabel;
+        busy = true;
+    }
+    else if (lifecycle === 'waking_up') {
+        status = 'active';
+        statusLabelKey = messageKeys.chatCatStatusWakingUpLabel;
+        busy = true;
+    }
+    else if (lifecycle === 'sleeping') {
+        status = 'sleeping';
+        statusLabelKey = messageKeys.chatCatStatusSleepingLabel;
+    }
+    else {
+        status = 'idle';
+        statusLabelKey = messageKeys.chatCatStatusIdleLabel;
+    }
+    return {
+        catId: cat.id,
+        catName: cat.name,
+        avatarColor: cat.avatarColor ?? null,
+        status,
+        statusLabelKey,
+        busy,
+    };
+}
+//# sourceMappingURL=catStatusResolution.js.map

package/build/server/products/chat/shared/catStatusResolution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catStatusResolution.js","sourceRoot":"","sources":["../../../../../src/products/chat/shared/catStatusResolution.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,yBAAyB,EAA2B,MAAM,gBAAgB,CAAC;AACpF,OAAO,EAAE,WAAW,EAAmB,MAAM,+BAA+B,CAAC;AAsB7E,MAAM,UAAU,yBAAyB,CACvC,GAAY,EACZ,OAA6B,EAC7B,YAA0C;IAE1C,MAAM,UAAU,GAAG,OAAO,CAAC,cAAc,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,GAAG,CAAC,EAAE,CAAC,CAAC;IAC3E,MAAM,WAAW,GAAG,UAAU,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,IAAI,aAAa,CAAC;IAC1E,MAAM,SAAS,GAAuB,yBAAyB,CAAC,WAAW,CAAC,CAAC;IAE7E,2DAA2D;IAC3D,MAAM,kBAAkB,GAAG,YAAY,EAAE,SAAS,CAAC,IAAI,CACrD,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,CAC9B,IAAI,KAAK,CAAC;IAEX,MAAM,aAAa,GAAG,YAAY,EAAE,SAAS,EAAE,MAAM,KAAK,SAAS,CAAC;IAEpE,IAAI,MAAqB,CAAC;IAC1B,IAAI,cAA0B,CAAC;IAC/B,IAAI,IAAI,GAAG,KAAK,CAAC;IAEjB,IAAI,SAAS,KAAK,OAAO,EAAE,CAAC;QAC1B,MAAM,GAAG,OAAO,CAAC;QACjB,cAAc,GAAG,WAAW,CAAC,uBAAuB,CAAC;IACvD,CAAC;SAAM,IAAI,kBAAkB,EAAE,CAAC;QAC9B,MAAM,GAAG,oBAAoB,CAAC;QAC9B,cAAc,GAAG,WAAW,CAAC,kCAAkC,CAAC;IAClE,CAAC;SAAM,IAAI,aAAa,EAAE,CAAC;QACzB,MAAM,GAAG,SAAS,CAAC;QACnB,cAAc,GAAG,WAAW,CAAC,yBAAyB,CAAC;IACzD,CAAC;SAAM,IAAI,SAAS,KAAK,OAAO,EAAE,CAAC;QACjC,MAAM,GAAG,QAAQ,CAAC;QAClB,cAAc,GAAG,WAAW,CAAC,wBAAwB,CAAC;QACtD,IAAI,GAAG,IAAI,CAAC;IACd,CAAC;SAAM,IAAI,SAAS,KAAK,WAAW,EAAE,CAAC;QACrC,MAAM,GAAG,QAAQ,CAAC;QAClB,cAAc,GAAG,WAAW,CAAC,0BAA0B,CAAC;QACxD,IAAI,GAAG,IAAI,CAAC;IACd,CAAC;SAAM,IAAI,SAAS,KAAK,UAAU,EAAE,CAAC;QACpC,MAAM,GAAG,UAAU,CAAC;QACpB,cAAc,GAAG,WAAW,CAAC,0BAA0B,CAAC;IAC1D,CAAC;SAAM,CAAC;QACN,MAAM,GAAG,MAAM,CAAC;QAChB,cAAc,GAAG,WAAW,CAAC,sBAAsB,CAAC;IACtD,CAAC;IAED,OAAO;QACL,KAAK,EAAE,GAAG,CAAC,EAAE;QACb,OAAO,EAAE,GAAG,CAAC,IAAI;QACjB,WAAW,EAAE,GAAG,CAAC,WAAW,IAAI,IAAI;QACpC,MAAM;QACN,cAAc;QACd,IAAI;KACL,CAAC;AACJ,CAAC"}

package/build/server/products/chat/shared/channelCanonicalIdentity.d.ts

@@ -0,0 +1,6 @@
+import type { ChatState } from '../api/contracts.js';
+export declare function resolveChannelCanonicalIdentity(state: Pick<ChatState, 'parallelChatGroups'> | null | undefined, channelId: string): {
+    containerId: string;
+    conversationId: string;
+};
+//# sourceMappingURL=channelCanonicalIdentity.d.ts.map

package/build/server/products/chat/shared/channelCanonicalIdentity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"channelCanonicalIdentity.d.ts","sourceRoot":"","sources":["../../../../../src/products/chat/shared/channelCanonicalIdentity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAMrD,wBAAgB,+BAA+B,CAC7C,KAAK,EAAE,IAAI,CAAC,SAAS,EAAE,oBAAoB,CAAC,GAAG,IAAI,GAAG,SAAS,EAC/D,SAAS,EAAE,MAAM,GAChB;IACD,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;CACxB,CAQA"}

package/build/server/products/chat/shared/channelCanonicalIdentity.js

@@ -0,0 +1,11 @@
+import { buildChatConversationId, resolveChatChannelContainerId, } from '../../../shared/chatCoreIds.js';
+export function resolveChannelCanonicalIdentity(state, channelId) {
+    return {
+        containerId: resolveChatChannelContainerId({
+            channelId,
+            parallelChatGroups: state?.parallelChatGroups ?? null,
+        }),
+        conversationId: buildChatConversationId(channelId),
+    };
+}
+//# sourceMappingURL=channelCanonicalIdentity.js.map

package/build/server/products/chat/shared/channelCanonicalIdentity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"channelCanonicalIdentity.js","sourceRoot":"","sources":["../../../../../src/products/chat/shared/channelCanonicalIdentity.ts"],"names":[],"mappings":"AACA,OAAO,EACL,uBAAuB,EACvB,6BAA6B,GAC9B,MAAM,gCAAgC,CAAC;AAExC,MAAM,UAAU,+BAA+B,CAC7C,KAA+D,EAC/D,SAAiB;IAKjB,OAAO;QACL,WAAW,EAAE,6BAA6B,CAAC;YACzC,SAAS;YACT,kBAAkB,EAAE,KAAK,EAAE,kBAAkB,IAAI,IAAI;SACtD,CAAC;QACF,cAAc,EAAE,uBAAuB,CAAC,SAAS,CAAC;KACnD,CAAC;AACJ,CAAC"}

package/build/server/products/chat/shared/channelEntry.d.ts

@@ -0,0 +1,16 @@
+import type { AppShellPayload } from '../api/contracts.js';
+import type { RoomRoutingState } from '../../../shared/roomRouting.js';
+import { type ChatLifecycleState } from './lifecycle.js';
+export type SelectedChannelView = Omit<NonNullable<AppShellPayload['chat']['selectedChannel']>, 'roomRouting'> & {
+    roomRouting: RoomRoutingState;
+};
+export declare function normalizeSelectedChannelView(selectedChannel: AppShellPayload['chat']['selectedChannel']): SelectedChannelView | null;
+export declare function resolveSelectedChannelEntryLifecycle(selectedChannel: SelectedChannelView | null): ChatLifecycleState | null;
+export declare function shouldWakeRouteChannelOnEntry(input: {
+    routeChannelId: string | null;
+    routeChannelExists: boolean;
+    selectedChannelId: string | null;
+    selectedChannelViewId: string | null;
+    entryLifecycleState: ChatLifecycleState | null;
+}): boolean;
+//# sourceMappingURL=channelEntry.d.ts.map

package/build/server/products/chat/shared/channelEntry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"channelEntry.d.ts","sourceRoot":"","sources":["../../../../../src/products/chat/shared/channelEntry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAQvE,OAAO,EAEL,KAAK,kBAAkB,EACxB,MAAM,gBAAgB,CAAC;AAExB,MAAM,MAAM,mBAAmB,GAAG,IAAI,CACpC,WAAW,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,iBAAiB,CAAC,CAAC,EACvD,aAAa,CACd,GAAG;IACF,WAAW,EAAE,gBAAgB,CAAC;CAC/B,CAAC;AAEF,wBAAgB,4BAA4B,CAC1C,eAAe,EAAE,eAAe,CAAC,MAAM,CAAC,CAAC,iBAAiB,CAAC,GAC1D,mBAAmB,GAAG,IAAI,CAS5B;AAED,wBAAgB,oCAAoC,CAClD,eAAe,EAAE,mBAAmB,GAAG,IAAI,GAC1C,kBAAkB,GAAG,IAAI,CAsB3B;AAED,wBAAgB,6BAA6B,CAAC,KAAK,EAAE;IACnD,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,kBAAkB,EAAE,OAAO,CAAC;IAC5B,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,qBAAqB,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,mBAAmB,EAAE,kBAAkB,GAAG,IAAI,CAAC;CAChD,GAAG,OAAO,CAaV"}