crossfire/node/packages/contracts/src/runtime.ts

implementedRuntime = check.choice(...implementedRuntimes)

runtimeState = check.choice('idle', 'working', 'waiting-approval', 'waiting-answer', 'failed', 'unavailable', 'sleeping', 'waking')

nativeRuntimeSummary = check.object({ state: check.choice('idle', 'working', 'waiting-approval', 'waiting-answer', 'failed', 'unavailable', 'sleeping', 'waking', 'stopped'), observedAt: check.integer(),
    lastActivityAt: check.nullable(check.integer()), historyAvailable: check.nullable(check.boolean) })

listenerOptions = check.object({ history_mode: check.optional(check.choice('shared', 'per-room')) })

option = check.object({ id: check.text(255), label: check.text(1000), description: check.plainText(4000) })

decisionQuestion = check.object({ id: check.text(255), title: check.text(1000), prompt: check.plainText(16000),
    secret: check.boolean, allowText: check.boolean, options: check.list(option, 100) })

decisionFields = { id: check.identifier, runId: check.identifier, runtime: check.name,
    sessionId: check.text(255), requestId: check.text(255), turnId: check.text(255), itemId: check.text(255),
    kind: check.choice('permission', 'question'), action: check.text(255), review: check.refine(check.plainText(MAX_REVIEW_BYTES), value => new TextEncoder().encode(value).byteLength <= MAX_REVIEW_BYTES, 'Native review exceeds the separate UTF-8 resource bound'),
    blocking: check.boolean, expiresAt: check.nullable(check.integer()), questions: check.list(decisionQuestion, 100, 1) }

decisionCreation = check.object({ ...decisionFields, runtime: implementedRuntime }) satisfies check.Parser<DecisionCreation>

decisionAnswer = check.object({ questionId: check.text(255), optionId: check.nullable(check.text(255)), text: check.nullable(check.plainText(16000)) }) satisfies check.Parser<DecisionAnswer>

decisionSubmission = check.object({ answers: check.list(decisionAnswer, 100, 1) })

decisionStatus = check.choice('pending', 'answered', 'responded', 'cancelled', 'expired')

decisionView = check.object({ ...decisionFields, agentId: check.identifier, status: decisionStatus, createdAt: check.integer() }) satisfies check.Parser<DecisionView>

{ review: _review, questions: _questions, ...summaryFields } = decisionFields

decisionSummary = check.object({ ...summaryFields, agentId: check.identifier, status: decisionStatus, createdAt: check.integer() }) satisfies check.Parser<DecisionSummary>

decisionReceipt = check.object({ status: check.choice('responded', 'cancelled') })

decisionPoll = check.object({ status: decisionStatus, answers: check.list(decisionAnswer, 100) })

setting = check.object({ name: check.text(100), configured: check.nullable(check.text(1000)), effective: check.nullable(check.text(1000)) })

observationFields = { sessionId: check.text(255), roomId: check.nullable(check.roomId), runtime: check.name, state: runtimeState,
    observedAt: check.integer(), lastActivityAt: check.nullable(check.integer()), historyAvailable: check.nullable(check.boolean),
    historyMode: check.choice('shared', 'per-room'), maxInputBytes: check.integer(1024, MAX_INPUT_BYTES),
    settings: check.list(setting, 100), errorMessage: check.nullable(check.plainText(4000)) }

observation = check.object({ ...observationFields, runtime: implementedRuntime }) satisfies check.Parser<RuntimeObservation>

observationView = check.object({ runId: check.identifier, ...observationFields }) satisfies check.Parser<RuntimeObservationView>

observations = check.list(observationView, 2002)

failureReport = check.object({ episodeId: check.identifier, agentId: check.identifier, sessionId: check.nullable(check.text(255)), message: check.plainText(4000) })