fix(orchestration): start a remote chat worker only for a home that knows one

A new federated protocol version 5, sent only when the server advertises
orchestration.federation-chat-workers.v1, says the home understands a chat
worker. An older home gets a terminal, exactly as before, so its receipt
never calls a chat a terminal.
This commit is contained in:
Jinwoo-H
2026-11-09 03:28:35 -05:00
parent b399ba20cd
commit ba767ed682
5 changed files with 46 additions and 7 deletions
@@ -37,9 +37,14 @@ export const ORCHESTRATION_ASK_RETURNS_AT_ONCE_RUNTIME_CAPABILITY =
/** A finished remote worker takes follow-ups here and can still mail and ask its Run home. */
export const ORCHESTRATION_FEDERATION_FOLLOW_UP_RUNTIME_CAPABILITY =
'orchestration.federation-follow-up.v1' as const
/** This server starts a remote worker as a chat when its own settings prefer chats and the home asks for it. */
export const ORCHESTRATION_FEDERATION_CHAT_WORKERS_RUNTIME_CAPABILITY =
'orchestration.federation-chat-workers.v1' as const
export const ORCHESTRATION_FEDERATION_CONTROL_MAIL_PROTOCOL_VERSION = 2 as const
export const ORCHESTRATION_FEDERATION_LIFECYCLE_SETTLEMENT_PROTOCOL_VERSION = 3 as const
export const ORCHESTRATION_FEDERATION_FOLLOW_UP_PROTOCOL_VERSION = 4 as const
/** The home understands a chat worker in the receipt; an older home always gets a terminal. */
export const ORCHESTRATION_FEDERATION_CHAT_WORKERS_PROTOCOL_VERSION = 5 as const
export const ORCHESTRATION_CONTRACT_VERSION = 1 as const
export const ORCHESTRATION_CONTRACT_RUNTIME_CAPABILITY = 'orchestration.contract.v1' as const
@@ -60,13 +65,14 @@ export const ORCHESTRATION_RUNTIME_CAPABILITIES = [
ORCHESTRATION_WORKER_TURN_STOP_REPORTS_RUNTIME_CAPABILITY,
ORCHESTRATION_ASK_RETURNS_AT_ONCE_RUNTIME_CAPABILITY,
ORCHESTRATION_FEDERATION_FOLLOW_UP_RUNTIME_CAPABILITY,
ORCHESTRATION_FEDERATION_CHAT_WORKERS_RUNTIME_CAPABILITY,
ORCHESTRATION_CONTRACT_RUNTIME_CAPABILITY
] as const
/** The newest federated protocol both sides speak; each version needs every earlier one's capability. */
export function federationProtocolVersionFor(
capabilities: readonly string[] | undefined
): 1 | 2 | 3 | 4 {
): 1 | 2 | 3 | 4 | 5 {
const ladder = [
[
ORCHESTRATION_FEDERATION_CONTROL_MAIL_RUNTIME_CAPABILITY,
@@ -79,9 +85,13 @@ export function federationProtocolVersionFor(
[
ORCHESTRATION_FEDERATION_FOLLOW_UP_RUNTIME_CAPABILITY,
ORCHESTRATION_FEDERATION_FOLLOW_UP_PROTOCOL_VERSION
],
[
ORCHESTRATION_FEDERATION_CHAT_WORKERS_RUNTIME_CAPABILITY,
ORCHESTRATION_FEDERATION_CHAT_WORKERS_PROTOCOL_VERSION
]
] as const
let version: 1 | 2 | 3 | 4 = 1
let version: 1 | 2 | 3 | 4 | 5 = 1
for (const [capability, next] of ladder) {
if (!capabilities?.includes(capability)) {
break