Self-hosted, Self-Improving, Federated Everything App — dev management, agent orchestration, persistent mind, digital twin, second brain, and creative pipeline from a single dashboard over Tailscale to port the user into the OS
JavaScript ai-agentsdashboarddeveloper-toolsdigital-twinquantified-selfsecond-brainself-hostedtailscale
/** Runtime-backed payload contracts for modeled Socket.IO events. */
import { zodToOpenApiSchema } from './apiContractSchemas.js';
import { generatedPreviewPlaybackSchema } from './generatedPreviewPlaybackSchema.js';
import {
appDeploySchema,
appStandardizeSchema,
appUpdateSchema,
detectStartSchema,
errorRecoverSchema,
itermInputSchema,
itermSessionRefSchema,
logsSubscribeSchema,
logsUnsubscribeSchema,
shellAttachSchema,
shellCdSchema,
shellInputSchema,
shellResizeSchema,
shellStopSchema,
standardizeStartSchema,
} from './socketValidation.js';
const input = (schema, summary) => Object.freeze({
direction: 'client-to-server',
summary,
payloadSchema: zodToOpenApiSchema(schema),
});
const loomRunSnapshot = (production) => Object.freeze({
direction: 'server-to-client',
summary: 'Revisioned public FableLoom run snapshot after an authoritative transition; no runtime handles.',
payloadSchema: {
type: 'object',
required: ['id', 'loomId', 'status', 'revision', 'createdAt', 'updatedAt', ...(production ? ['episodeId', 'attempt', 'assets', 'summary'] : [])],
properties: {
id: { type: 'string' },
loomId: { type: 'string' },
...(production ? { episodeId: { type: 'string' }, attempt: { type: 'integer' }, assets: { type: 'array', items: { type: 'object' } }, summary: { type: 'object' } } : {}),
status: { type: 'string', enum: production ? ['in_progress', 'completed', 'failed', 'canceled'] : ['running', 'canceling', 'completed', 'paused', 'failed', 'canceled'] },
revision: { type: 'integer' },
createdAt: { type: 'string' },
updatedAt: { type: 'string' },
},
},
});
export const SOCKET_EVENT_CONTRACTS = Object.freeze({
'generated-preview:playback': input(generatedPreviewPlaybackSchema, 'Calibrate or control an advertised cooperative document preview; audio remains in the client.'),
'generated-preview:playback-state': {
direction: 'server-to-client',
summary: 'Correlated preview clock, preparation, playback and synchronization result.',
payloadSchema: {
type: 'object', required: ['requestId', 'sessionId', 'action'],
properties: {
requestId: { type: 'string', format: 'uuid' }, sessionId: { type: 'string', format: 'uuid' },
action: { type: 'string', enum: ['clock', 'prepare', 'play', 'sync'] },
probeId: { type: 'integer', minimum: 0 }, clientTime: { type: 'number' }, workerTime: { type: 'number' },
epoch: { type: 'integer', minimum: 0 }, sequence: { type: 'integer', minimum: 0 },
status: { type: 'string', enum: ['ready', 'playing', 'accepted', 'stale', 'resync-required', 'error'] },
message: { type: 'string' },
reason: { type: 'string', enum: ['controls', 'clock'] },
},
},
},
'messages:sync:completed': {
direction: 'server-to-client',
summary: 'Account cache persisted after sync; visible inbox consumers reconcile a bounded summary page. No message bodies.',
payloadSchema: {
type: 'object', required: ['accountId', 'newMessages', 'pruned', 'status'], additionalProperties: false,
properties: {
accountId: { type: 'string' }, newMessages: { type: 'integer', minimum: 0 },
pruned: { type: 'integer', minimum: 0 }, status: { type: 'string' }, reason: { type: 'string' },
},
},
},
'cos:agent:feedback': {
direction: 'server-to-client',
summary: 'Persisted agent feedback after the pending-feedback index has been updated; CoS subscribers only.',
payloadSchema: {
type: 'object', required: ['agentId', 'feedback'],
properties: {
agentId: { type: 'string' },
feedback: {
type: 'object', required: ['rating', 'comment', 'submittedAt'],
properties: {
rating: { type: 'string', enum: ['positive', 'negative', 'neutral'] },
comment: { type: ['string', 'null'] },
submittedAt: { type: 'string' },
},
},
},
},
},
'peer-execution:changed': Object.freeze({ direction: 'server-to-client', summary: 'Invalidate authenticated peer execution setup and status; no credentials or operation data.', payloadSchema: { type: 'null' } }),
'genome:clinvar-progress': {
direction: 'server-to-client', summary: 'ClinVar download and indexing progress for an optional client request ID.',
payloadSchema: { type: 'object', required: ['message'], properties: { message: { type: 'string' }, requestId: { type: 'string', format: 'uuid' } } },
},
'music-video:render-cleanup': {
direction: 'server-to-client', summary: 'Derived render cleanup changed; refresh the project render inventory.',
payloadSchema: { type: 'object', required: ['projectId'], properties: { projectId: { type: 'string' } }, additionalProperties: false },
},
'music-video:song-revision': {
direction: 'server-to-client', summary: 'A song revision changed; apply the persisted project snapshot.',
payloadSchema: { type: 'object', required: ['projectId', 'project'], properties: { projectId: { type: 'string' }, project: { type: 'object' } } },
},
'voice-studio:changed': {
direction: 'server-to-client', summary: 'Voice library or runtime setup changed; refetch authenticated state.',
payloadSchema: { type: 'object', properties: {}, additionalProperties: false },
},
'voice:fine-tune:updated': {
direction: 'server-to-client',
summary: 'One voice fine-tuning job after a status change, a sealed checkpoint, or throttled training progress.',
payloadSchema: {
type: 'object',
required: ['profileId', 'job'],
properties: {
profileId: { type: 'string' },
job: {
type: 'object',
required: ['id', 'profileId', 'status', 'checkpoints'],
properties: {
id: { type: 'string', format: 'uuid' },
profileId: { type: 'string' },
status: { type: 'string', enum: ['running', 'completed', 'failed', 'cancelled', 'interrupted'] },
progress: { type: ['number', 'null'] },
step: { type: ['integer', 'null'] },
totalSteps: { type: ['integer', 'null'] },
error: { type: ['string', 'null'] },
processActive: { type: 'boolean' },
checkpoints: { type: 'array', items: { type: 'object' } },
},
},
},
},
},
'fleet-host:subscribe': {
direction: 'client-to-server', summary: 'Observe local fleet host readiness while this operator socket is subscribed.',
payloadSchema: { type: 'object', properties: {}, additionalProperties: false },
},
'fleet-host:unsubscribe': {
direction: 'client-to-server', summary: 'Release this operator socket; stop external probes after the last subscriber leaves.',
payloadSchema: { type: 'object', properties: {}, additionalProperties: false },
},
'fleet-host:changed': {
direction: 'server-to-client', summary: 'Local host readiness or setup changed; no credentials or records.',
payloadSchema: { type: 'object', properties: {}, additionalProperties: false },
},
'fleet-host:usage:changed': {
direction: 'server-to-client', summary: 'Local queue or usage ledger changed; read the authenticated usage report.',
payloadSchema: { type: 'object', properties: {}, additionalProperties: false },
},
'tailcat:serve:changed': {
direction: 'server-to-client',
summary: 'Invalidate machine-local Tailcat serve status after persistence or process lifecycle changes; no address or diagnostics.',
payloadSchema: { type: 'object', properties: {}, additionalProperties: false },
},
'reference-sheet:changed': {
direction: 'server-to-client',
summary: 'Correlated sheet publication outcome after the image copy and character pointer write finish.',
payloadSchema: {
type: 'object', required: ['universeId', 'entryId', 'jobId', 'variant', 'status'],
properties: {
universeId: { type: 'string' }, entryId: { type: 'string' },
jobId: { type: 'string' }, variant: { type: 'string' },
status: { type: 'string', enum: ['ready', 'failed', 'superseded'] },
},
additionalProperties: false,
},
},
'eidoverse:projection': {
direction: 'server-to-client',
summary: 'Payload-free invalidation after persisted Eidoverse world changes; clients read projection progress through the authenticated API.',
payloadSchema: { type: 'object', additionalProperties: false, properties: {} },
},
'jev:status': {
direction: 'server-to-client',
summary: 'JEV install or sidecar lifecycle changed; reread status without loading a model.',
payloadSchema: { type: 'object', properties: {}, additionalProperties: false },
},
'jev:stats': {
direction: 'server-to-client',
summary: 'JEV decision counters persisted; reread aggregate statistics.',
payloadSchema: { type: 'object', properties: {}, additionalProperties: false },
},
'jev:heads': {
direction: 'server-to-client',
summary: 'JEV head artifacts or training state changed; reread head metadata.',
payloadSchema: { type: 'object', properties: {}, additionalProperties: false },
},
'jev:policy': {
direction: 'server-to-client',
summary: 'Invalidate Jev integration policy after settings persistence or restore invalidation; no settings content.',
payloadSchema: { type: 'object', properties: {}, additionalProperties: false },
},
'laya:status': {
direction: 'server-to-client',
summary: 'Invalidate Laya runtime status after install progress, completion, failure or scoring transitions; no experiment content.',
payloadSchema: { type: 'object', properties: {}, additionalProperties: false },
},
'usage-backfill:updated': {
direction: 'server-to-client',
summary: 'Invalidate historical usage backfill status after progress or a durable terminal transition.',
payloadSchema: { type: 'object', properties: {}, additionalProperties: false },
},
'cos:day:changed': {
direction: 'server-to-client',
summary: 'Invalidate UTC-day aggregates when the current activity-calendar day expires.',
payloadSchema: { type: 'object', properties: {}, additionalProperties: false },
},
'goals:changed': {
direction: 'server-to-client',
summary: 'Invalidate goals after a local write or peer merge.',
payloadSchema: { type: 'object', properties: {}, additionalProperties: false },
},
'backup:changed': {
direction: 'server-to-client',
summary: 'Invalidate backup status and snapshots after lifecycle or configuration changes.',
payloadSchema: { type: 'object', properties: {}, additionalProperties: false },
},
'cos:decisions:changed': {
direction: 'server-to-client',
summary: 'Invalidate the decision summary after an appended or collapsed decision.',
payloadSchema: { type: 'object', properties: {}, additionalProperties: false },
},
'cos:schedule:changed': {
direction: 'server-to-client',
summary: 'Invalidate upcoming tasks after schedule persistence.',
payloadSchema: { type: 'object', properties: {}, additionalProperties: false },
},
'cos:scheduler:changed': {
direction: 'server-to-client',
summary: 'Invalidate upcoming tasks after scheduler registration, cancellation or execution.',
payloadSchema: { type: 'object', properties: {}, additionalProperties: false },
},
'cos:storage:changed': {
direction: 'server-to-client',
summary: 'Invalidate CoS recording maintenance progress and policy.',
payloadSchema: { type: 'object', properties: {}, additionalProperties: false },
},
'cos:agents:changed': {
direction: 'server-to-client',
summary: 'Invalidate agent aggregates after deletion or cleanup.',
payloadSchema: { type: 'object', properties: {}, additionalProperties: false },
},
'cos:learning:changed': {
direction: 'server-to-client',
summary: 'Invalidate learning aggregates and upcoming estimates after persistence.',
payloadSchema: { type: 'object', properties: {}, additionalProperties: false },
},
'agent-processes:subscribe': {
direction: 'client-to-server',
summary: 'Subscribe to shared agent process snapshots while the page is mounted.',
payloadSchema: { type: 'null' },
},
'agent-processes:unsubscribe': {
direction: 'client-to-server',
summary: 'Release agent process snapshots; the last subscriber stops host scans.',
payloadSchema: { type: 'null' },
},
'agent-processes:changed': {
direction: 'server-to-client',
summary: 'Agent process snapshot after process or resource usage changes.',
payloadSchema: {
type: 'object', required: ['agents'],
properties: { agents: { type: 'array', items: { type: 'object' } } },
},
},
'digital-twin:changed': {
direction: 'server-to-client',
summary: 'Invalidate Digital Twin status/settings after persistence or completed peer sync; contains no personal data.',
payloadSchema: { type: 'object', properties: {}, additionalProperties: false },
},
'meatspace:death-clock:changed': {
direction: 'server-to-client',
summary: 'Invalidate death-clock projection after local or federated inputs change.',
payloadSchema: { type: 'object', properties: {}, additionalProperties: false },
},
'cos:mind:visibility': {
direction: 'server-to-client',
summary: 'Coalesced environment visibility invalidation for subscribed CoS views; no private records.',
payloadSchema: { type: 'object', required: ['invalidated'], properties: { invalidated: { type: 'boolean', enum: [true] } }, additionalProperties: false },
},
'cos:goals:changed': {
direction: 'server-to-client',
summary: 'Invalidate operational goal progress after learning statistics persist.',
payloadSchema: { type: 'object', properties: {}, additionalProperties: false },
},
'meatspace:changed': {
direction: 'server-to-client',
summary: 'Overview resource invalidation after persisted local or mirrored health changes.',
payloadSchema: { type: 'object', required: ['resources'], additionalProperties: false,
properties: { resources: { type: 'array', items: { type: 'string', enum: ['overview', 'alcohol', 'body', 'healthBody', 'blood', 'epigenetic', 'eyes', 'calendar'] } } } },
},
'portos:auto-update:changed': {
direction: 'server-to-client',
summary: 'Invalidate updater status after runtime, configuration or external git ref changes.',
payloadSchema: { type: 'object', properties: {}, additionalProperties: false },
},
'system:health:changed': {
direction: 'server-to-client',
summary: 'Invalidate health after a service change or changed shared readiness sample.',
payloadSchema: { type: 'object', properties: {}, additionalProperties: false },
},
'capabilities:changed': {
direction: 'server-to-client',
summary: 'Invalidate capabilities after a persisted change or changed readiness sample.',
payloadSchema: { type: 'object', properties: {}, additionalProperties: false },
},
'browser:changed': {
direction: 'server-to-client',
summary: 'Shared browser snapshot or read failure changed; reread the cached status.',
payloadSchema: { type: 'object', properties: {}, additionalProperties: false },
},
'browser:subscribe': {
direction: 'client-to-server',
summary: 'Observe external browser state while the Browser view is mounted; never launches or navigates.',
payloadSchema: { type: 'object', properties: {}, additionalProperties: false },
},
'browser:unsubscribe': {
direction: 'client-to-server',
summary: 'Release browser observation; the last subscriber stops the observer.',
payloadSchema: { type: 'object', properties: {}, additionalProperties: false },
},
'loaded-models:subscribe': {
direction: 'client-to-server',
summary: 'Start shared observation while a viewer is mounted.',
payloadSchema: { type: 'object', properties: {}, additionalProperties: false },
},
'loaded-models:unsubscribe': {
direction: 'client-to-server',
summary: 'Release observation; the last viewer stops sampling.',
payloadSchema: { type: 'object', properties: {}, additionalProperties: false },
},
'loaded-models:changed': {
direction: 'server-to-client',
summary: 'Shared sample changed or failed; reconcile through the existing status endpoint.',
payloadSchema: { type: 'object', properties: {}, additionalProperties: false },
},
'voice-readiness:subscribe': {
direction: 'client-to-server',
summary: 'Start shared observation while a viewer is mounted.',
payloadSchema: { type: 'object', properties: {}, additionalProperties: false },
},
'voice-readiness:unsubscribe': {
direction: 'client-to-server',
summary: 'Release observation; the last viewer stops sampling.',
payloadSchema: { type: 'object', properties: {}, additionalProperties: false },
},
'voice-readiness:changed': {
direction: 'server-to-client',
summary: 'Shared sample changed or failed; reconcile through the existing status endpoint.',
payloadSchema: { type: 'object', properties: {}, additionalProperties: false },
},
'provider-readiness:subscribe': {
direction: 'client-to-server',
summary: 'Start shared observation while a viewer is mounted.',
payloadSchema: { type: 'object', properties: {}, additionalProperties: false },
},
'provider-readiness:unsubscribe': {
direction: 'client-to-server',
summary: 'Release observation; the last viewer stops sampling.',
payloadSchema: { type: 'object', properties: {}, additionalProperties: false },
},
'provider-readiness:changed': {
direction: 'server-to-client',
summary: 'Shared sample changed or failed; reconcile through the existing status endpoint.',
payloadSchema: { type: 'object', properties: {}, additionalProperties: false },
},
'provider-status:subscribe': {
direction: 'client-to-server',
summary: 'Start shared observation while a viewer is mounted.',
payloadSchema: { type: 'object', properties: {}, additionalProperties: false },
},
'provider-status:unsubscribe': {
direction: 'client-to-server',
summary: 'Release observation; the last viewer stops sampling.',
payloadSchema: { type: 'object', properties: {}, additionalProperties: false },
},
'provider-status:changed': {
direction: 'server-to-client',
summary: 'Shared sample changed or failed; reconcile through the existing status endpoint.',
payloadSchema: { type: 'object', properties: {}, additionalProperties: false },
},
'codex-account:subscribe': {
direction: 'client-to-server',
summary: 'Start shared observation while a viewer is mounted.',
payloadSchema: { type: 'object', properties: {}, additionalProperties: false },
},
'codex-account:unsubscribe': {
direction: 'client-to-server',
summary: 'Release observation; the last viewer stops sampling.',
payloadSchema: { type: 'object', properties: {}, additionalProperties: false },
},
'codex-account:changed': {
direction: 'server-to-client',
summary: 'Shared sample changed or failed; reconcile through the existing status endpoint.',
payloadSchema: { type: 'object', properties: {}, additionalProperties: false },
},
'readiness:subscribe': {
direction: 'client-to-server',
summary: 'Observe health and capability readiness while a view is mounted.',
payloadSchema: { type: 'object', properties: {}, additionalProperties: false },
},
'readiness:unsubscribe': {
direction: 'client-to-server',
summary: 'Release readiness observation; the last subscriber stops the observer.',
payloadSchema: { type: 'object', properties: {}, additionalProperties: false },
},
'catalog:identity-changed': {
direction: 'server-to-client',
summary: 'Invalidate matching catalog identity receipt and detail views after a durable local change.',
payloadSchema: { type: 'object', properties: { operationId: { type: 'string' }, sourceId: { type: 'string' }, survivorId: { type: 'string' } },
required: ['operationId', 'sourceId', 'survivorId'], additionalProperties: false },
},
'github:notifications:changed': {
direction: 'server-to-client',
summary: 'Invalidate the GitHub notifications inbox, thread drawer and Automations tab after a sync, triage or action changed stored rows.',
payloadSchema: { type: 'object', properties: { accountId: { type: 'string' } }, required: ['accountId'], additionalProperties: false },
},
'code-animation:changed': {
direction: 'server-to-client',
summary: 'Invalidate bounded Code Animation job/project galleries and matching details after a durable change; kind "poster" means only the gallery thumbnail changed.',
payloadSchema: { type: 'object', properties: { id: { type: 'string' }, kind: { type: 'string', enum: ['poster'] } }, required: ['id'], additionalProperties: false },
},
'mood-board:analyze': {
direction: 'server-to-client',
summary: 'Progress of a mood board analyze run (prompt-from-media over pins, then style compose) so a reopened board page can resume showing it.',
payloadSchema: {
type: 'object',
properties: {
boardId: { type: 'string' },
status: { type: 'string', enum: ['running', 'done', 'failed'] },
phase: { type: ['string', 'null'] },
total: { type: 'integer' },
done: { type: 'integer' },
failures: { type: 'integer' },
error: { type: ['string', 'null'] },
startedAt: { type: 'string' },
finishedAt: { type: ['string', 'null'] },
},
required: ['boardId', 'status'],
additionalProperties: false,
},
},
'mood-board:generate': {
direction: 'server-to-client',
summary: 'Mood board prompt-writing and image enqueue progress; render progress uses media jobs.',
payloadSchema: {
type: 'object',
properties: {
boardId: { type: 'string' }, requestId: { type: 'string' },
status: { type: 'string', enum: ['running', 'queued', 'failed'] },
phase: { type: ['string', 'null'] }, total: { type: 'integer' },
error: { type: ['string', 'null'] }, revision: { type: 'integer' }, epoch: { type: 'string' },
items: { type: 'array', items: { type: 'object', properties: {
itemId: { type: ['string', 'null'] }, jobId: { type: ['string', 'null'] },
}, required: ['itemId', 'jobId'], additionalProperties: false } },
// The exact prompt-writing request and the blocks PortOS added (#11317).
sentInput: { type: 'object', properties: {
sentPrompt: { type: 'string' },
promptAdditions: { type: 'array', items: { type: 'object', properties: {
id: { type: 'string' }, label: { type: 'string' }, text: { type: 'string' },
}, required: ['id', 'label', 'text'], additionalProperties: false } },
}, required: ['sentPrompt', 'promptAdditions'], additionalProperties: false },
},
required: ['boardId', 'requestId', 'status', 'revision', 'epoch', 'items'], additionalProperties: false,
},
},
'storyboard:make': {
direction: 'server-to-client',
summary: 'A storyboard panel maker node started, finished, failed, or received a frame; reload the board.',
payloadSchema: {
type: 'object',
properties: {
storyboardId: { type: 'string' },
panelId: { type: 'string' },
nodeId: { type: 'string' },
status: { type: 'string', enum: ['running', 'queued', 'frame', 'done', 'failed'] },
error: { type: 'string' },
},
required: ['storyboardId', 'panelId', 'nodeId', 'status'],
additionalProperties: false,
},
},
'storyboard:make-batch': {
direction: 'server-to-client',
summary: 'Make empty panels progress on a storyboard: panels finished of the total, and when the batch is done.',
payloadSchema: {
type: 'object',
properties: {
storyboardId: { type: 'string' },
status: { type: 'string', enum: ['running', 'done'] },
total: { type: 'number' },
done: { type: 'number' },
failed: { type: 'number' },
startedAt: { type: 'string' },
},
required: ['storyboardId', 'status', 'total', 'done', 'failed'],
additionalProperties: false,
},
},
'mood-board:item-render': {
direction: 'server-to-client',
summary: 'A mood board text note render was queued, finished (the note is now an image item) or failed; reload the board.',
payloadSchema: {
type: 'object',
properties: {
boardId: { type: 'string' },
itemId: { type: 'string' },
status: { type: 'string', enum: ['queued', 'done', 'failed'] },
error: { type: 'string' },
},
required: ['boardId', 'itemId', 'status'],
additionalProperties: false,
},
},
'brain:changed': {
direction: 'server-to-client',
summary: 'Invalidate Brain summary/settings after a persisted change.',
payloadSchema: { type: 'object', properties: { type: { type: 'string' }, id: { type: 'string' } }, required: ['type'], additionalProperties: false },
},
'brain:links:changed': {
direction: 'server-to-client',
summary: 'Invalidate one link including clone progress and scan-report completion.',
payloadSchema: { type: 'object', properties: { id: { type: 'string' } }, required: ['id'], additionalProperties: false },
},
'creative-director:project:changed': Object.freeze({
direction: 'server-to-client',
summary: 'A Creative Director project changed after persistence; fetch only a referenced project.',
payloadSchema: { type: 'object', required: ['id'], properties: { id: { type: 'string' } }, additionalProperties: false },
}),
'commission:changed': Object.freeze({
direction: 'server-to-client',
summary: 'A creative commission changed after persistence.',
payloadSchema: { type: 'object', required: ['id'], properties: { id: { type: 'string' } }, additionalProperties: false },
}),
'fableloom:export:job': Object.freeze({
direction: 'server-to-client',
summary: 'Persisted export job snapshot scoped to its loom and job identifier.',
payloadSchema: { type: 'object', required: ['loomId', 'jobId', 'status', 'revision', 'progress', 'findings'],
properties: { loomId: { type: 'string' }, jobId: { type: 'string' }, status: { type: 'string' },
revision: { type: 'integer' }, progress: { type: 'object' }, findings: { type: 'array', items: { type: 'object' } } } },
}),
'fableloom:editorial:run': loomRunSnapshot(false),
'fableloom:production:run': loomRunSnapshot(true),
'fableloom:shots:run': loomRunSnapshot(false),
'app:deploy': input(appDeploySchema, 'Deploy a managed app with allowlisted flags.'),
'app:standardize': input(appStandardizeSchema, 'Standardize one registered app.'),
'app:update': input(appUpdateSchema, 'Run the update lifecycle for one registered app.'),
'detect:start': input(detectStartSchema, 'Start streamed application detection.'),
'eidoverse-travel:subscribe': {
direction: 'client-to-server',
summary: 'Watch guest destinations while an operator travel panel is visible.',
payloadSchema: { type: 'null' },
},
'eidoverse-travel:unsubscribe': {
direction: 'client-to-server',
summary: 'Stop watching guest destinations; the last subscriber stops external probes.',
payloadSchema: { type: 'null' },
},
'eidoverse-travel:destinations': {
direction: 'server-to-client',
summary: 'Changed guest destination snapshot for subscribed operator panels only.',
payloadSchema: {
type: 'object', required: ['destinations'], additionalProperties: false,
properties: {
destinations: {
type: 'array',
items: {
type: 'object', required: ['peerId', 'label'], additionalProperties: false,
properties: { peerId: { type: 'string' }, label: { type: 'string' } },
},
},
},
},
},
'error:recover': input(errorRecoverSchema, 'Request a bounded recovery task for a reported error.'),
'fableloom:fal-video:changed': Object.freeze({
direction: 'server-to-client',
summary: 'Public browser video job snapshot on queue, progress and terminal transitions; completion follows durable gallery and scene attachment.',
payloadSchema: {
type: 'object',
required: ['id', 'source', 'loomId', 'episodeId', 'nodeId', 'status', 'statusMsg', 'progress',
'createdAt', 'startedAt', 'completedAt', 'error', 'videoHistoryId', 'filename'],
properties: {
id: { type: 'string' },
source: { type: 'string', enum: ['fal-browser'] },
loomId: { type: 'string' },
episodeId: { type: 'string' },
nodeId: { type: 'string' },
status: { type: 'string', enum: ['queued', 'running', 'completed', 'failed'] },
statusMsg: { type: 'string' },
progress: { type: 'number', minimum: 0, maximum: 1 },
createdAt: { type: 'string' },
startedAt: { type: ['string', 'null'] },
completedAt: { type: ['string', 'null'] },
error: { type: ['string', 'null'] },
videoHistoryId: { type: ['string', 'null'] },
filename: { type: ['string', 'null'] },
},
additionalProperties: false,
},
}),
'iterm:attach': input(itermSessionRefSchema, 'Start viewing one live iTerm2 session.'),
'iterm:detach': input(itermSessionRefSchema, 'Stop viewing one live iTerm2 session.'),
'iterm:input': input(itermInputSchema, 'Type bytes into one live iTerm2 session.'),
'localLlm:sweep:changed': Object.freeze({
direction: 'server-to-client',
summary: 'Public assessment sweep snapshot after a queue state change, including cancellation and final runtime restoration.',
payloadSchema: {
type: 'object',
required: ['status', 'settled', 'total', 'completed', 'results', 'cancelRequested'],
properties: {
status: { type: 'string', enum: ['idle', 'running', 'cancelled', 'failed', 'complete'] },
mode: { type: ['string', 'null'], enum: ['models', 'tunings', null] },
scope: { type: ['string', 'null'] },
target: { type: ['object', 'null'], properties: { backend: { type: 'string' }, modelId: { type: 'string' } } },
settled: { type: 'boolean' },
startedAt: { type: ['string', 'null'] },
finishedAt: { type: ['string', 'null'] },
total: { type: 'integer' },
completed: { type: 'integer' },
current: { type: ['object', 'null'], properties: {
backend: { type: 'string' }, modelId: { type: 'string' },
tuningLabel: { type: ['string', 'null'] }, startedAt: { type: 'string' },
} },
results: { type: 'array', items: { type: 'object', properties: {
backend: { type: 'string' }, modelId: { type: 'string' },
tuningLabel: { type: ['string', 'null'] }, finishedAt: { type: 'string' },
verdict: { type: ['string', 'null'] }, error: { type: ['string', 'null'] },
meanTokensPerSecond: { type: ['number', 'null'] }, meanCharsPerSecond: { type: ['number', 'null'] },
tokensEstimated: { type: ['boolean', 'null'] }, tuningApplied: { type: ['boolean', 'null'] },
tuningNotApplied: { type: ['string', 'null'] },
} } },
cancelRequested: { type: 'boolean' },
error: { type: ['string', 'null'] },
restoreError: { type: ['string', 'null'] },
},
additionalProperties: false,
},
}),
'sprites:changed': {
direction: 'server-to-client',
summary: 'A sprite run, reference manifest or candidate was persisted; reread this record.',
payloadSchema: { type: 'object', properties: { recordId: { type: 'string' } }, required: ['recordId'], additionalProperties: false },
},
'sprites:jobs-changed': {
direction: 'server-to-client',
summary: 'A sprite media job changed lifecycle state; reconcile this record and render lane.',
payloadSchema: {
type: 'object',
properties: { recordId: { type: 'string' }, kind: { type: 'string' }, tagKey: { type: 'string' } },
required: ['recordId', 'kind', 'tagKey'], additionalProperties: false,
},
},
'media-prompt-history:changed': {
direction: 'server-to-client',
summary: 'A media examination was saved; reconcile history without exposing prompt content.',
payloadSchema: { type: 'object', properties: {}, additionalProperties: false },
},
'media-jobs:changed': {
direction: 'server-to-client',
summary: 'Invalidate queue snapshots after job, progress, archive or hold changes.',
payloadSchema: { type: 'object', properties: {}, additionalProperties: false },
},
'training:dataset:changed': {
direction: 'server-to-client',
summary: 'Dataset changes were persisted; reread this dataset.',
payloadSchema: { type: 'object', properties: { datasetId: { type: 'string' } }, required: ['datasetId'], additionalProperties: false },
},
'training:checkpoints:changed': {
direction: 'server-to-client',
summary: 'Training checkpoints or samples were persisted; reread this run.',
payloadSchema: { type: 'object', properties: { runId: { type: 'string' } }, required: ['runId'], additionalProperties: false },
},
'logs:subscribe': input(logsSubscribeSchema, 'Subscribe to a bounded process-log tail.'),
'logs:unsubscribe': input(logsUnsubscribeSchema, 'Release one process-log subscription or all legacy subscriptions.'),
'processes:changed': Object.freeze({
direction: 'server-to-client',
summary: 'PM2 snapshot for registered apps sharing a home; null means the probe failed.',
payloadSchema: {
type: 'object', required: ['appIds', 'defaultHome', 'processes'],
properties: {
appIds: { type: 'array', items: { type: 'string' } },
defaultHome: { type: 'boolean' },
processes: { type: ['array', 'null'], items: { type: 'object', properties: {
name: { type: 'string' }, status: { type: 'string' }, pid: { type: 'number' },
pm_id: { type: 'number' }, cpu: { type: 'number' }, memory: { type: 'number' },
uptime: { type: ['number', 'null'] }, restarts: { type: 'number' }, unstableRestarts: { type: 'number' }
} } }
}
}
}),
'image-to-3d:changed': {
direction: 'server-to-client',
summary: 'Invalidate one model after a persisted lifecycle change, including progress and deletion.',
payloadSchema: { type: 'object', required: ['id'], properties: { id: { type: 'string' } }, additionalProperties: false },
},
'threejs-model:changed': {
direction: 'server-to-client',
summary: 'Invalidate one model after a persisted lifecycle change, including progress and deletion.',
payloadSchema: { type: 'object', required: ['id'], properties: { id: { type: 'string' } }, additionalProperties: false },
},
'provider-quota:updated': {
direction: 'server-to-client',
summary: 'Invalidate quota cards after a background scrape settles, including failures; no account or quota data.',
payloadSchema: { type: 'object', properties: {}, additionalProperties: false },
},
'shell:attach': input(shellAttachSchema, 'Attach this socket to an existing terminal session.'),
'shell:cd': input(shellCdSchema, 'Change an existing terminal session directory.'),
'shell:input': input(shellInputSchema, 'Write bytes to an existing terminal session.'),
'shell:resize': input(shellResizeSchema, 'Resize an existing terminal session.'),
'shell:stop': input(shellStopSchema, 'Stop an existing terminal session.'),
'standardize:start': input(standardizeStartSchema, 'Start streamed PM2 standardization for a repository.'),
});
export const socketEventContract = (event, direction) => {
const contract = SOCKET_EVENT_CONTRACTS[event];
return contract?.direction === direction ? contract : null;
};