@cats-inc/cats-platform 0.1.0

package/build/server/products/chat/state/providerAgentObservation.js

@@ -0,0 +1,130 @@
+import { PROVIDER_AGENT_DECISION_CONTRACT_VERSION } from '../../../platform/orchestration/index.js';
+import { DEFAULT_SUPERVISION_SCHEMA_VERSION } from '../../../platform/supervision/index.js';
+import { requireChannel } from './model/index.js';
+import { isDirectLaneChannel, isProviderDefaultChatChannel, isDefaultChatChannel, supportsParticipantAudienceSelection, } from '../shared/channelTopology.js';
+function resolveChannelIntentRef(channel) {
+    if (isDirectLaneChannel(channel)) {
+        return 'direct_message';
+    }
+    if (supportsParticipantAudienceSelection(channel)) {
+        return 'participant_chat';
+    }
+    if (isProviderDefaultChatChannel(channel)) {
+        return 'provider_default_chat';
+    }
+    if (isDefaultChatChannel(channel)) {
+        return 'default_chat';
+    }
+    return 'unknown';
+}
+export const CHAT_PROVIDER_AGENT_DECISION_TOOL = 'chat.provider_agent.semantic_decision';
+export function createChatProviderAgentDecisionManifest() {
+    return {
+        schemaVersion: DEFAULT_SUPERVISION_SCHEMA_VERSION,
+        name: CHAT_PROVIDER_AGENT_DECISION_TOOL,
+        manifestVersion: '1.0',
+        description: 'Prepare a bounded provider-agent semantic decision for a Chat turn.',
+        sideEffect: 'none',
+        preflight: 'available',
+        blocking: 'blocking',
+        cancellation: 'cooperative',
+        approval: 'never',
+        evidence: 'summary',
+        failureCodes: ['E_TOOL_SCOPE_DENIED', 'E_SCHEMA_INVALID'],
+        inputSchema: {
+            id: `${CHAT_PROVIDER_AGENT_DECISION_TOOL}.input`,
+            version: '1.0',
+            format: 'json_schema',
+        },
+        outputSchema: {
+            id: `${CHAT_PROVIDER_AGENT_DECISION_TOOL}.output`,
+            version: '1.0',
+            format: 'json_schema',
+        },
+    };
+}
+export function buildChatProviderAgentObservation(input) {
+    const now = input.now ?? new Date();
+    const channel = requireChannel(input.state, input.channelId);
+    return {
+        contractVersion: PROVIDER_AGENT_DECISION_CONTRACT_VERSION,
+        observationId: `chat-provider-agent:${channel.id}:${now.toISOString()}`,
+        runId: `chat:${channel.id}`,
+        goal: 'Handle the next Chat turn using deterministic routing metadata and bounded tools.',
+        task: {
+            kind: 'chat_turn',
+            risk: input.routing.targetCount > 1 ? 'medium' : 'low',
+        },
+        actor: {
+            actorRef: input.actorRef,
+            target: {
+                kind: 'execution_target',
+                provider: input.capabilityProfile.provider,
+                model: input.capabilityProfile.model,
+                control: input.capabilityProfile.control ?? undefined,
+            },
+            capabilityProfileRef: input.capabilityProfile.profileId,
+            providerRef: input.capabilityProfile.profileId,
+        },
+        policy: {
+            dials: structuredClone(input.policy),
+            allowedFallbacks: structuredClone(input.allowedFallbacks ?? [input.policy.fallbackPolicy]),
+        },
+        availableTools: structuredClone(input.availableTools ?? []),
+        contextRefs: [
+            `chat-channel:${channel.id}`,
+            `chat-room-mode:${channel.roomRouting?.mode ?? 'chat_channel'}`,
+            `chat-channel-intent:${resolveChannelIntentRef(channel)}`,
+            ...uniqueStrings(input.additionalContextRefs ?? []),
+        ],
+        summaries: buildRoutingSummaries(input),
+        budget: {
+            maxDurationMs: 30_000,
+            hardStop: true,
+        },
+        invariants: [
+            'Chat deterministic routing stays product-owned.',
+            'Do not infer additional audience targets outside the routing summary.',
+            'Do not request tools outside the bounded tool surface.',
+            ...(input.invariants ?? []),
+        ],
+    };
+}
+function uniqueStrings(values) {
+    return values.filter((value, index, list) => list.indexOf(value) === index);
+}
+function buildRoutingSummaries(input) {
+    return [
+        {
+            key: 'input_character_count',
+            kind: 'count',
+            value: Math.max(0, input.messageCharacterCount),
+        },
+        {
+            key: 'routing_target_count',
+            kind: 'count',
+            value: input.routing.targetCount,
+        },
+        {
+            key: 'routing_unresolved_count',
+            kind: 'count',
+            value: input.routing.unresolvedCount,
+        },
+        {
+            key: 'routing_mention_count',
+            kind: 'count',
+            value: input.routing.mentionCount,
+        },
+        {
+            key: 'routing_trigger',
+            kind: 'enumerated_outcome',
+            value: input.routing.trigger,
+        },
+        {
+            key: 'routing_selection_kind',
+            kind: 'enumerated_outcome',
+            value: input.routing.resolution.selectionKind,
+        },
+    ];
+}
+//# sourceMappingURL=providerAgentObservation.js.map

package/build/server/products/chat/state/providerAgentObservation.js.map

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

package/build/server/products/chat/state/room-routing/continuationContext.d.ts

@@ -0,0 +1,17 @@
+import type { CoreRecordMetadata } from '../../../../core/types.js';
+import type { RoomRoutingParticipantRef, RoomWorkflowTurn } from '../../../../shared/roomRouting.js';
+export interface WorkflowContinuationContext {
+    event: RoomWorkflowTurn['events'][number];
+    metadata: CoreRecordMetadata;
+    targets: WorkflowContinuationContextTarget[];
+}
+export interface WorkflowContinuationContextTarget extends RoomRoutingParticipantRef {
+    laneId: string | null;
+    sessionId: string | null;
+}
+export declare function hasWorkflowContinuationContextMetadata(metadata: CoreRecordMetadata | null | undefined): boolean;
+export declare function mergeWorkflowContinuationTargets(targets: ReadonlyArray<RoomRoutingParticipantRef>, metadata: CoreRecordMetadata | null | undefined): WorkflowContinuationContextTarget[];
+export declare function readLatestWorkflowContinuationContext(turn: RoomWorkflowTurn | null, options?: {
+    excludeEventId?: string | null;
+}): WorkflowContinuationContext | null;
+//# sourceMappingURL=continuationContext.d.ts.map

package/build/server/products/chat/state/room-routing/continuationContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"continuationContext.d.ts","sourceRoot":"","sources":["../../../../../../src/products/chat/state/room-routing/continuationContext.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,KAAK,EACV,yBAAyB,EACzB,gBAAgB,EACjB,MAAM,mCAAmC,CAAC;AAQ3C,MAAM,WAAW,2BAA2B;IAC1C,KAAK,EAAE,gBAAgB,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC;IAC1C,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,OAAO,EAAE,iCAAiC,EAAE,CAAC;CAC9C;AAED,MAAM,WAAW,iCAAkC,SAAQ,yBAAyB;IAClF,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,wBAAgB,sCAAsC,CACpD,QAAQ,EAAE,kBAAkB,GAAG,IAAI,GAAG,SAAS,GAC9C,OAAO,CAQT;AAqCD,wBAAgB,gCAAgC,CAC9C,OAAO,EAAE,aAAa,CAAC,yBAAyB,CAAC,EACjD,QAAQ,EAAE,kBAAkB,GAAG,IAAI,GAAG,SAAS,GAC9C,iCAAiC,EAAE,CAqBrC;AAED,wBAAgB,qCAAqC,CACnD,IAAI,EAAE,gBAAgB,GAAG,IAAI,EAC7B,OAAO,GAAE;IACP,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B,GACL,2BAA2B,GAAG,IAAI,CAuBpC"}

package/build/server/products/chat/state/room-routing/continuationContext.js

@@ -0,0 +1,73 @@
+import { readMetadataRecord, readMetadataString, readMetadataStringArray, readParticipantRefs, } from '../core-projection/entityMetadata.js';
+export function hasWorkflowContinuationContextMetadata(metadata) {
+    return (readMetadataString(metadata, 'continuationSource') !== null
+        || readMetadataRecord(metadata?.workflowRecommendation) !== null
+        || readMetadataStringArray(metadata, 'unresolvedTargets').length > 0
+        || readMetadataStringArray(metadata, 'mentionNames').length > 0
+        || readMetadataString(metadata, 'branchStrategy') !== null);
+}
+function readWorkflowContinuationTargetIdentities(metadata) {
+    const rawTargetIdentities = metadata?.targetIdentities;
+    if (!Array.isArray(rawTargetIdentities)) {
+        return [];
+    }
+    return rawTargetIdentities.flatMap((value) => {
+        const record = readMetadataRecord(value);
+        if (!record) {
+            return [];
+        }
+        const participantKind = record.participantKind === 'orchestrator' || record.participantKind === 'cat'
+            ? record.participantKind
+            : null;
+        const participantId = readMetadataString(record, 'participantId');
+        if (!participantKind || !participantId) {
+            return [];
+        }
+        return [{
+                participantKind,
+                participantId,
+                laneId: readMetadataString(record, 'laneId'),
+                sessionId: readMetadataString(record, 'sessionId'),
+            }];
+    });
+}
+export function mergeWorkflowContinuationTargets(targets, metadata) {
+    const targetIdentities = readWorkflowContinuationTargetIdentities(metadata);
+    return targets.map((target, targetIndex) => {
+        const indexedIdentity = targetIdentities[targetIndex] ?? null;
+        const matchingIdentity = (indexedIdentity?.participantKind === target.participantKind
+            && indexedIdentity.participantId === target.participantId)
+            ? indexedIdentity
+            : targetIdentities.find((candidate) => candidate.participantKind === target.participantKind
+                && candidate.participantId === target.participantId)
+                ?? null;
+        return {
+            participantKind: target.participantKind,
+            participantId: target.participantId,
+            participantName: target.participantName,
+            laneId: matchingIdentity?.laneId ?? null,
+            sessionId: matchingIdentity?.sessionId ?? null,
+        };
+    });
+}
+export function readLatestWorkflowContinuationContext(turn, options = {}) {
+    if (!turn) {
+        return null;
+    }
+    for (const event of [...turn.events].reverse()) {
+        if (options.excludeEventId && event.id === options.excludeEventId) {
+            continue;
+        }
+        const metadata = readMetadataRecord(event.metadata);
+        if (!metadata || !hasWorkflowContinuationContextMetadata(metadata)) {
+            continue;
+        }
+        return {
+            event,
+            metadata,
+            targets: mergeWorkflowContinuationTargets(readParticipantRefs(event.targets), metadata),
+        };
+    }
+    return null;
+}
+//# sourceMappingURL=continuationContext.js.map

package/build/server/products/chat/state/room-routing/continuationContext.js.map

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

package/build/server/products/chat/state/room-routing/continuationReplay.d.ts

@@ -0,0 +1,19 @@
+import type { RoomRoutingTrigger, RoomWorkflowShape } from '../../../../shared/roomRouting.js';
+export declare const REPLAYABLE_CONTINUATION_GUARD_REASONS: readonly ["max_continuations", "max_dispatches", "max_target_visits", "anti_ping_pong"];
+export type ReplayableContinuationGuardReason = typeof REPLAYABLE_CONTINUATION_GUARD_REASONS[number];
+export declare function isReplayableContinuationGuardReason(value: unknown): value is ReplayableContinuationGuardReason;
+export declare function buildContinuationReplayMetadata(input: {
+    sourceMessageId: string;
+    sourceTurnId?: string | null;
+    sourceLaneId?: string | null;
+    sourceAssistantTurnId?: string | null;
+    mentionNames: string[];
+    trigger: RoomRoutingTrigger;
+    workflowStageId: string | null;
+    workflowShape: RoomWorkflowShape;
+    reviewRequired: boolean;
+    continuationSource: 'explicit_mentions' | 'workflow_recommendation' | null;
+    workflowRecommendation: Record<string, unknown> | null;
+    unresolvedTargets: string[];
+}): Record<string, unknown>;
+//# sourceMappingURL=continuationReplay.d.ts.map

package/build/server/products/chat/state/room-routing/continuationReplay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"continuationReplay.d.ts","sourceRoot":"","sources":["../../../../../../src/products/chat/state/room-routing/continuationReplay.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAClB,iBAAiB,EAClB,MAAM,mCAAmC,CAAC;AAE3C,eAAO,MAAM,qCAAqC,yFAKxC,CAAC;AAEX,MAAM,MAAM,iCAAiC,GAC3C,OAAO,qCAAqC,CAAC,MAAM,CAAC,CAAC;AAEvD,wBAAgB,mCAAmC,CACjD,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,iCAAiC,CAK5C;AAED,wBAAgB,+BAA+B,CAAC,KAAK,EAAE;IACrD,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,qBAAqB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,OAAO,EAAE,kBAAkB,CAAC;IAC5B,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,aAAa,EAAE,iBAAiB,CAAC;IACjC,cAAc,EAAE,OAAO,CAAC;IACxB,kBAAkB,EAAE,mBAAmB,GAAG,yBAAyB,GAAG,IAAI,CAAC;IAC3E,sBAAsB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACvD,iBAAiB,EAAE,MAAM,EAAE,CAAC;CAC7B,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAiB1B"}

package/build/server/products/chat/state/room-routing/continuationReplay.js

@@ -0,0 +1,29 @@
+export const REPLAYABLE_CONTINUATION_GUARD_REASONS = [
+    'max_continuations',
+    'max_dispatches',
+    'max_target_visits',
+    'anti_ping_pong',
+];
+export function isReplayableContinuationGuardReason(value) {
+    return typeof value === 'string'
+        && REPLAYABLE_CONTINUATION_GUARD_REASONS.includes(value);
+}
+export function buildContinuationReplayMetadata(input) {
+    return {
+        continuationSourceMessageId: input.sourceMessageId,
+        continuationSourceTurnId: input.sourceTurnId ?? null,
+        continuationSourceLaneId: input.sourceLaneId ?? null,
+        continuationSourceAssistantTurnId: input.sourceAssistantTurnId ?? null,
+        mentionNames: structuredClone(input.mentionNames),
+        trigger: input.trigger,
+        workflowStageId: input.workflowStageId,
+        workflowShape: input.workflowShape,
+        reviewRequired: input.reviewRequired,
+        continuationSource: input.continuationSource,
+        workflowRecommendation: input.workflowRecommendation
+            ? structuredClone(input.workflowRecommendation)
+            : null,
+        unresolvedTargets: structuredClone(input.unresolvedTargets),
+    };
+}
+//# sourceMappingURL=continuationReplay.js.map

package/build/server/products/chat/state/room-routing/continuationReplay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"continuationReplay.js","sourceRoot":"","sources":["../../../../../../src/products/chat/state/room-routing/continuationReplay.ts"],"names":[],"mappings":"AAKA,MAAM,CAAC,MAAM,qCAAqC,GAAG;IACnD,mBAAmB;IACnB,gBAAgB;IAChB,mBAAmB;IACnB,gBAAgB;CACR,CAAC;AAKX,MAAM,UAAU,mCAAmC,CACjD,KAAc;IAEd,OAAO,OAAO,KAAK,KAAK,QAAQ;WAC3B,qCAAqC,CAAC,QAAQ,CAC/C,KAA0C,CAC3C,CAAC;AACN,CAAC;AAED,MAAM,UAAU,+BAA+B,CAAC,KAa/C;IACC,OAAO;QACL,2BAA2B,EAAE,KAAK,CAAC,eAAe;QAClD,wBAAwB,EAAE,KAAK,CAAC,YAAY,IAAI,IAAI;QACpD,wBAAwB,EAAE,KAAK,CAAC,YAAY,IAAI,IAAI;QACpD,iCAAiC,EAAE,KAAK,CAAC,qBAAqB,IAAI,IAAI;QACtE,YAAY,EAAE,eAAe,CAAC,KAAK,CAAC,YAAY,CAAC;QACjD,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,eAAe,EAAE,KAAK,CAAC,eAAe;QACtC,aAAa,EAAE,KAAK,CAAC,aAAa;QAClC,cAAc,EAAE,KAAK,CAAC,cAAc;QACpC,kBAAkB,EAAE,KAAK,CAAC,kBAAkB;QAC5C,sBAAsB,EAAE,KAAK,CAAC,sBAAsB;YAClD,CAAC,CAAC,eAAe,CAAC,KAAK,CAAC,sBAAsB,CAAC;YAC/C,CAAC,CAAC,IAAI;QACR,iBAAiB,EAAE,eAAe,CAAC,KAAK,CAAC,iBAAiB,CAAC;KAC5D,CAAC;AACJ,CAAC"}

package/build/server/products/chat/state/room-routing/index.d.ts

@@ -0,0 +1,22 @@
+import type { RoomRouteBlockedReason, RoomRouteDefaultTargetReason, RoomRouteResolutionMode, RoomRouteSelectionKind, RoomRoutingCheckpointKind, RoomRoutingDispatchStatus, RoomRoutingGuardReason, RoomRoutingMode, RoomRoutingTrigger, RoomRoutingTurnStatus, RoomWorkflowEventKind, RoomWorkflowBranchStrategy, RoomWorkflowHandoffReason, RoomWorkflowShape, RoomWorkflowStatus, RoomWorkflowTargetStatus, RoomWakeReason, RoomWakeRequestStatus, RoomWakeTrigger } from '../../../../shared/roomRouting.js';
+export { DEFAULT_MAX_ROUTING_CONTINUATIONS, DEFAULT_MAX_ROUTING_DISPATCHES, DEFAULT_MAX_ROUTING_TARGET_VISITS, DEFAULT_WORKFLOW_EVENT_HISTORY_LIMIT, DEFAULT_WORKFLOW_TURN_HISTORY_LIMIT, DEFAULT_WAKE_HISTORY_LIMIT, createDefaultRoomRoutingState, createDefaultRoomWorkflowState, resolveRoomRoutingState, resolveRoomWorkflowState, } from '../../../../core/roomRoutingState.js';
+export declare function normalizeRoomRoutingMode(value: unknown, fallback?: RoomRoutingMode): RoomRoutingMode;
+export declare function normalizeRoomRouteResolutionMode(value: unknown, fallback?: RoomRouteResolutionMode): RoomRouteResolutionMode;
+export declare function normalizeRoomRouteSelectionKind(value: unknown, fallback?: RoomRouteSelectionKind): RoomRouteSelectionKind;
+export declare function normalizeRoomRouteBlockedReason(value: unknown): RoomRouteBlockedReason | null;
+export declare function normalizeRoomRouteDefaultTargetReason(value: unknown): RoomRouteDefaultTargetReason | null;
+export declare function normalizeRoomRoutingTrigger(value: unknown, fallback?: RoomRoutingTrigger): RoomRoutingTrigger;
+export declare function normalizeRoomRoutingTurnStatus(value: unknown, fallback?: RoomRoutingTurnStatus): RoomRoutingTurnStatus;
+export declare function normalizeRoomRoutingDispatchStatus(value: unknown, fallback?: RoomRoutingDispatchStatus): RoomRoutingDispatchStatus;
+export declare function normalizeRoomRoutingCheckpointKind(value: unknown, fallback?: RoomRoutingCheckpointKind): RoomRoutingCheckpointKind;
+export declare function normalizeRoomRoutingGuardReason(value: unknown): RoomRoutingGuardReason;
+export declare function normalizeRoomWorkflowStatus(value: unknown, fallback?: RoomWorkflowStatus): RoomWorkflowStatus;
+export declare function normalizeRoomWorkflowTargetStatus(value: unknown, fallback?: RoomWorkflowTargetStatus): RoomWorkflowTargetStatus;
+export declare function normalizeRoomWorkflowShape(value: unknown, fallback?: RoomWorkflowShape): RoomWorkflowShape;
+export declare function normalizeRoomWorkflowBranchStrategy(value: unknown, fallback?: RoomWorkflowBranchStrategy | null): RoomWorkflowBranchStrategy | null;
+export declare function normalizeRoomWorkflowHandoffReason(value: unknown, fallback?: RoomWorkflowHandoffReason | null): RoomWorkflowHandoffReason | null;
+export declare function normalizeRoomWorkflowEventKind(value: unknown, fallback?: RoomWorkflowEventKind): RoomWorkflowEventKind;
+export declare function normalizeRoomWakeTrigger(value: unknown, fallback?: RoomWakeTrigger): RoomWakeTrigger;
+export declare function normalizeRoomWakeReason(value: unknown, fallback?: RoomWakeReason): RoomWakeReason;
+export declare function normalizeRoomWakeRequestStatus(value: unknown, fallback?: RoomWakeRequestStatus): RoomWakeRequestStatus;
+//# sourceMappingURL=index.d.ts.map

package/build/server/products/chat/state/room-routing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/products/chat/state/room-routing/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,sBAAsB,EACtB,4BAA4B,EAC5B,uBAAuB,EACvB,sBAAsB,EACtB,yBAAyB,EACzB,yBAAyB,EACzB,sBAAsB,EACtB,eAAe,EAEf,kBAAkB,EAClB,qBAAqB,EACrB,qBAAqB,EACrB,0BAA0B,EAC1B,yBAAyB,EACzB,iBAAiB,EAEjB,kBAAkB,EAClB,wBAAwB,EACxB,cAAc,EACd,qBAAqB,EACrB,eAAe,EAChB,MAAM,mCAAmC,CAAC;AAc3C,OAAO,EACL,iCAAiC,EACjC,8BAA8B,EAC9B,iCAAiC,EACjC,oCAAoC,EACpC,mCAAmC,EACnC,0BAA0B,EAC1B,6BAA6B,EAC7B,8BAA8B,EAC9B,uBAAuB,EACvB,wBAAwB,GACzB,MAAM,sCAAsC,CAAC;AAgJ9C,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,OAAO,EACd,QAAQ,GAAE,eAAgC,GACzC,eAAe,CAIjB;AAED,wBAAgB,gCAAgC,CAC9C,KAAK,EAAE,OAAO,EACd,QAAQ,GAAE,uBAAwC,GACjD,uBAAuB,CAKzB;AAED,wBAAgB,+BAA+B,CAC7C,KAAK,EAAE,OAAO,EACd,QAAQ,GAAE,sBAAkC,GAC3C,sBAAsB,CAKxB;AAED,wBAAgB,+BAA+B,CAC7C,KAAK,EAAE,OAAO,GACb,sBAAsB,GAAG,IAAI,CAM/B;AAED,wBAAgB,qCAAqC,CACnD,KAAK,EAAE,OAAO,GACb,4BAA4B,GAAG,IAAI,CAMrC;AAED,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,OAAO,EACd,QAAQ,GAAE,kBAAmC,GAC5C,kBAAkB,CAIpB;AAED,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,OAAO,EACd,QAAQ,GAAE,qBAA8B,GACvC,qBAAqB,CAKvB;AAED,wBAAgB,kCAAkC,CAChD,KAAK,EAAE,OAAO,EACd,QAAQ,GAAE,yBAAqC,GAC9C,yBAAyB,CAK3B;AAED,wBAAgB,kCAAkC,CAChD,KAAK,EAAE,OAAO,EACd,QAAQ,GAAE,yBAA0C,GACnD,yBAAyB,CAK3B;AAED,wBAAgB,+BAA+B,CAC7C,KAAK,EAAE,OAAO,GACb,sBAAsB,CAKxB;AAED,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,OAAO,EACd,QAAQ,GAAE,kBAA2B,GACpC,kBAAkB,CAKpB;AAED,wBAAgB,iCAAiC,CAC/C,KAAK,EAAE,OAAO,EACd,QAAQ,GAAE,wBAAoC,GAC7C,wBAAwB,CAK1B;AAED,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,OAAO,EACd,QAAQ,GAAE,iBAAgC,GACzC,iBAAiB,CAOnB;AAED,wBAAgB,mCAAmC,CACjD,KAAK,EAAE,OAAO,EACd,QAAQ,GAAE,0BAA0B,GAAG,IAAW,GACjD,0BAA0B,GAAG,IAAI,CAQnC;AAED,wBAAgB,kCAAkC,CAChD,KAAK,EAAE,OAAO,EACd,QAAQ,GAAE,yBAAyB,GAAG,IAAW,GAChD,yBAAyB,GAAG,IAAI,CAQlC;AAED,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,OAAO,EACd,QAAQ,GAAE,qBAAsC,GAC/C,qBAAqB,CAKvB;AAED,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,OAAO,EACd,QAAQ,GAAE,eAAgC,GACzC,eAAe,CAKjB;AAED,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,OAAO,EACd,QAAQ,GAAE,cAA+B,GACxC,cAAc,CAKhB;AAED,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,OAAO,EACd,QAAQ,GAAE,qBAAmC,GAC5C,qBAAqB,CAKvB"}

package/build/server/products/chat/state/room-routing/index.js

@@ -0,0 +1,247 @@
+export { DEFAULT_MAX_ROUTING_CONTINUATIONS, DEFAULT_MAX_ROUTING_DISPATCHES, DEFAULT_MAX_ROUTING_TARGET_VISITS, DEFAULT_WORKFLOW_EVENT_HISTORY_LIMIT, DEFAULT_WORKFLOW_TURN_HISTORY_LIMIT, DEFAULT_WAKE_HISTORY_LIMIT, createDefaultRoomRoutingState, createDefaultRoomWorkflowState, resolveRoomRoutingState, resolveRoomWorkflowState, } from '../../../../core/roomRoutingState.js';
+const ROOM_ROUTING_MODES = new Set([
+    'chat_channel',
+    'direct_message',
+]);
+const ROOM_ROUTING_TRIGGERS = new Set([
+    'room_default',
+    'explicit_mention',
+    'continuation_mention',
+]);
+const ROOM_ROUTE_RESOLUTION_MODES = new Set([
+    'room_default',
+    'explicit_single',
+    'explicit_multi',
+]);
+const ROOM_ROUTE_SELECTION_KINDS = new Set([
+    'default_target',
+    'explicit_mentions',
+    'blocked',
+]);
+const ROOM_ROUTE_BLOCKED_REASONS = new Set([
+    'missing_direct_message_recipient',
+    'missing_default_recipient',
+    'no_valid_targets',
+    'user_cancelled',
+]);
+const ROOM_ROUTE_DEFAULT_TARGET_REASONS = new Set([
+    'chat_channel_default',
+    'direct_message_recipient',
+    'default_recipient',
+]);
+const ROOM_ROUTING_TURN_STATUSES = new Set([
+    'idle',
+    'running',
+    'completed',
+    'blocked',
+    'error',
+]);
+const ROOM_ROUTING_DISPATCH_STATUSES = new Set([
+    'pending',
+    'running',
+    'completed',
+    'skipped',
+    'error',
+    'blocked',
+]);
+const ROOM_ROUTING_CHECKPOINT_KINDS = new Set([
+    'turn_started',
+    'fan_out',
+    'continuation',
+    'loop_guard',
+    'anti_ping_pong',
+    'no_targets',
+    'completed',
+    'runtime_error',
+]);
+const ROOM_ROUTING_GUARDS = new Set([
+    'max_continuations',
+    'max_dispatches',
+    'max_target_visits',
+    'anti_ping_pong',
+]);
+const ROOM_WORKFLOW_STATUSES = new Set([
+    'idle',
+    'pending',
+    'running',
+    'completed',
+    'blocked',
+    'failed',
+]);
+const ROOM_WORKFLOW_TARGET_STATUSES = new Set([
+    'pending',
+    'running',
+    'completed',
+    'failed',
+    'blocked',
+    'cancelled',
+    'waiting_for_converge',
+]);
+const ROOM_WORKFLOW_SHAPES = new Set([
+    'sequential',
+    'concurrent',
+    'converge',
+]);
+const ROOM_WORKFLOW_BRANCH_STRATEGIES = new Set([
+    'fork_if_possible',
+    'transplant_context',
+    'fresh_no_parent',
+]);
+const ROOM_WORKFLOW_HANDOFF_REASONS = new Set([
+    'room_entry',
+    'room_default',
+    'explicit_mention',
+    'workflow_continuation',
+    'operator_reroute',
+    'runtime_retry',
+]);
+const ROOM_WORKFLOW_EVENT_KINDS = new Set([
+    'turn_started',
+    'fan_out',
+    'target_pending',
+    'target_running',
+    'target_completed',
+    'target_failed',
+    'target_blocked',
+    'checkpoint',
+    'guard_blocked',
+    'outcome',
+]);
+const ROOM_WAKE_TRIGGERS = new Set([
+    'room_entry',
+    'route_target',
+]);
+const ROOM_WAKE_REASONS = new Set([
+    'room_entry',
+    'room_default',
+    'explicit_mention',
+    'workflow_continuation',
+]);
+const ROOM_WAKE_REQUEST_STATUSES = new Set([
+    'skipped',
+    'completed',
+    'failed',
+]);
+export function normalizeRoomRoutingMode(value, fallback = 'chat_channel') {
+    return typeof value === 'string' && ROOM_ROUTING_MODES.has(value)
+        ? value
+        : fallback;
+}
+export function normalizeRoomRouteResolutionMode(value, fallback = 'room_default') {
+    return typeof value === 'string'
+        && ROOM_ROUTE_RESOLUTION_MODES.has(value)
+        ? value
+        : fallback;
+}
+export function normalizeRoomRouteSelectionKind(value, fallback = 'blocked') {
+    return typeof value === 'string'
+        && ROOM_ROUTE_SELECTION_KINDS.has(value)
+        ? value
+        : fallback;
+}
+export function normalizeRoomRouteBlockedReason(value) {
+    if (value === 'missing_direct_chat_lead')
+        return 'missing_direct_message_recipient';
+    return typeof value === 'string'
+        && ROOM_ROUTE_BLOCKED_REASONS.has(value)
+        ? value
+        : null;
+}
+export function normalizeRoomRouteDefaultTargetReason(value) {
+    if (value === 'direct_chat_lead')
+        return 'direct_message_recipient';
+    return typeof value === 'string'
+        && ROOM_ROUTE_DEFAULT_TARGET_REASONS.has(value)
+        ? value
+        : null;
+}
+export function normalizeRoomRoutingTrigger(value, fallback = 'room_default') {
+    return typeof value === 'string' && ROOM_ROUTING_TRIGGERS.has(value)
+        ? value
+        : fallback;
+}
+export function normalizeRoomRoutingTurnStatus(value, fallback = 'idle') {
+    return typeof value === 'string'
+        && ROOM_ROUTING_TURN_STATUSES.has(value)
+        ? value
+        : fallback;
+}
+export function normalizeRoomRoutingDispatchStatus(value, fallback = 'pending') {
+    return typeof value === 'string'
+        && ROOM_ROUTING_DISPATCH_STATUSES.has(value)
+        ? value
+        : fallback;
+}
+export function normalizeRoomRoutingCheckpointKind(value, fallback = 'turn_started') {
+    return typeof value === 'string'
+        && ROOM_ROUTING_CHECKPOINT_KINDS.has(value)
+        ? value
+        : fallback;
+}
+export function normalizeRoomRoutingGuardReason(value) {
+    return typeof value === 'string'
+        && ROOM_ROUTING_GUARDS.has(value)
+        ? value
+        : null;
+}
+export function normalizeRoomWorkflowStatus(value, fallback = 'idle') {
+    return typeof value === 'string'
+        && ROOM_WORKFLOW_STATUSES.has(value)
+        ? value
+        : fallback;
+}
+export function normalizeRoomWorkflowTargetStatus(value, fallback = 'pending') {
+    return typeof value === 'string'
+        && ROOM_WORKFLOW_TARGET_STATUSES.has(value)
+        ? value
+        : fallback;
+}
+export function normalizeRoomWorkflowShape(value, fallback = 'sequential') {
+    if (value === 'parallel') {
+        return 'concurrent';
+    }
+    return typeof value === 'string' && ROOM_WORKFLOW_SHAPES.has(value)
+        ? value
+        : fallback;
+}
+export function normalizeRoomWorkflowBranchStrategy(value, fallback = null) {
+    if (typeof value !== 'string') {
+        return fallback;
+    }
+    return ROOM_WORKFLOW_BRANCH_STRATEGIES.has(value)
+        ? value
+        : fallback;
+}
+export function normalizeRoomWorkflowHandoffReason(value, fallback = null) {
+    if (typeof value !== 'string') {
+        return fallback;
+    }
+    return ROOM_WORKFLOW_HANDOFF_REASONS.has(value)
+        ? value
+        : fallback;
+}
+export function normalizeRoomWorkflowEventKind(value, fallback = 'turn_started') {
+    return typeof value === 'string'
+        && ROOM_WORKFLOW_EVENT_KINDS.has(value)
+        ? value
+        : fallback;
+}
+export function normalizeRoomWakeTrigger(value, fallback = 'route_target') {
+    return typeof value === 'string'
+        && ROOM_WAKE_TRIGGERS.has(value)
+        ? value
+        : fallback;
+}
+export function normalizeRoomWakeReason(value, fallback = 'room_default') {
+    return typeof value === 'string'
+        && ROOM_WAKE_REASONS.has(value)
+        ? value
+        : fallback;
+}
+export function normalizeRoomWakeRequestStatus(value, fallback = 'completed') {
+    return typeof value === 'string'
+        && ROOM_WAKE_REQUEST_STATUSES.has(value)
+        ? value
+        : fallback;
+}
+//# sourceMappingURL=index.js.map

package/build/server/products/chat/state/room-routing/index.js.map

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

package/build/server/products/chat/state/room-routing/recommendations.d.ts

@@ -0,0 +1,29 @@
+import type { ChatState } from '../../api/contracts.js';
+import type { RoomWorkflowBranchStrategy, RoomWorkflowShape } from '../../../../shared/roomRouting.js';
+import type { RoutingTarget } from '../mentionRouter.js';
+export interface WorkflowRecommendationTarget {
+    participantKind: 'orchestrator' | 'cat' | null;
+    participantId: string | null;
+    participantName: string | null;
+}
+export interface WorkflowRecommendation {
+    source: 'checkpoint' | 'boss_replan' | 'system_inference';
+    workflowShape: RoomWorkflowShape;
+    candidateTargets: WorkflowRecommendationTarget[];
+    branchStrategy: RoomWorkflowBranchStrategy | null;
+    rationale: string | null;
+    reviewRequired: boolean;
+}
+export interface WorkflowRecommendationResolution {
+    targets: RoutingTarget[];
+    unresolved: string[];
+    mentionNames: string[];
+}
+export declare function readWorkflowRecommendation(value: unknown): WorkflowRecommendation | null;
+export declare function serializeWorkflowRecommendation(recommendation: WorkflowRecommendation): Record<string, unknown>;
+export declare function extractWorkflowRecommendationFromBody(body: string): {
+    body: string;
+    recommendation: WorkflowRecommendation | null;
+};
+export declare function resolveWorkflowRecommendationTargets(state: ChatState, channelId: string, recommendation: WorkflowRecommendation): WorkflowRecommendationResolution;
+//# sourceMappingURL=recommendations.d.ts.map

package/build/server/products/chat/state/room-routing/recommendations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recommendations.d.ts","sourceRoot":"","sources":["../../../../../../src/products/chat/state/room-routing/recommendations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,SAAS,EACV,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EACV,0BAA0B,EAC1B,iBAAiB,EAClB,MAAM,mCAAmC,CAAC;AAU3C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGzD,MAAM,WAAW,4BAA4B;IAC3C,eAAe,EAAE,cAAc,GAAG,KAAK,GAAG,IAAI,CAAC;IAC/C,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,YAAY,GAAG,aAAa,GAAG,kBAAkB,CAAC;IAC1D,aAAa,EAAE,iBAAiB,CAAC;IACjC,gBAAgB,EAAE,4BAA4B,EAAE,CAAC;IACjD,cAAc,EAAE,0BAA0B,GAAG,IAAI,CAAC;IAClD,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,cAAc,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,gCAAgC;IAC/C,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAoJD,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,OAAO,GACb,sBAAsB,GAAG,IAAI,CAE/B;AAYD,wBAAgB,+BAA+B,CAC7C,cAAc,EAAE,sBAAsB,GACrC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAazB;AAED,wBAAgB,qCAAqC,CACnD,IAAI,EAAE,MAAM,GACX;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,sBAAsB,GAAG,IAAI,CAAA;CAAE,CAoCjE;AAiBD,wBAAgB,oCAAoC,CAClD,KAAK,EAAE,SAAS,EAChB,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,sBAAsB,GACrC,gCAAgC,CA8ElC"}