@jmoyers/harness 0.1.0

package/src/control-plane/stream-command-parser.ts

@@ -0,0 +1,1673 @@
+import type { StreamCommand } from './stream-protocol.ts';
+
+type StreamCommandType = StreamCommand['type'];
+type CommandRecord = Record<string, unknown>;
+type CommandParser = (record: CommandRecord) => StreamCommand | null;
+type ParsedTaskLinearInput = NonNullable<Extract<StreamCommand, { type: 'task.create' }>['linear']>;
+const INVALID_OPTIONAL = Symbol('invalid-optional');
+
+function asRecord(value: unknown): CommandRecord | null {
+  if (typeof value !== 'object' || value === null || Array.isArray(value)) {
+    return null;
+  }
+  return value as CommandRecord;
+}
+
+function readString(value: unknown): string | null {
+  return typeof value === 'string' ? value : null;
+}
+
+function readNumber(value: unknown): number | null {
+  return typeof value === 'number' && Number.isFinite(value) ? value : null;
+}
+
+function readBoolean(value: unknown): boolean | null {
+  return typeof value === 'boolean' ? value : null;
+}
+
+function readStringRecord(value: unknown): Record<string, string> | null {
+  const record = asRecord(value);
+  if (record === null) {
+    return null;
+  }
+  const normalized: Record<string, string> = {};
+  for (const [key, entryValue] of Object.entries(record)) {
+    if (typeof entryValue !== 'string') {
+      return null;
+    }
+    normalized[key] = entryValue;
+  }
+  return normalized;
+}
+
+function isStringArray(value: unknown): value is string[] {
+  return Array.isArray(value) && value.every((entry) => typeof entry === 'string');
+}
+
+function readOptionalString(record: CommandRecord, field: string): string | null | undefined {
+  const value = readString(record[field]);
+  if (record[field] !== undefined && value === null) {
+    return undefined;
+  }
+  return value;
+}
+
+function readOptionalBoolean(record: CommandRecord, field: string): boolean | null | undefined {
+  const value = readBoolean(record[field]);
+  if (record[field] !== undefined && value === null) {
+    return undefined;
+  }
+  return value;
+}
+
+function readOptionalInteger(
+  record: CommandRecord,
+  field: string,
+  minInclusive: number,
+): number | null | undefined {
+  const value = readNumber(record[field]);
+  if (record[field] !== undefined && value === null) {
+    return undefined;
+  }
+  if (value === null) {
+    return null;
+  }
+  if (!Number.isInteger(value) || value < minInclusive) {
+    return undefined;
+  }
+  return value;
+}
+
+function readOptionalNullableString(
+  record: CommandRecord,
+  field: string,
+): string | null | undefined | typeof INVALID_OPTIONAL {
+  const value = record[field];
+  if (value === undefined) {
+    return undefined;
+  }
+  if (value === null) {
+    return null;
+  }
+  if (typeof value !== 'string') {
+    return INVALID_OPTIONAL;
+  }
+  return value;
+}
+
+function readOptionalNullableNonNegativeInteger(
+  record: CommandRecord,
+  field: string,
+): number | null | undefined | typeof INVALID_OPTIONAL {
+  const value = record[field];
+  if (value === undefined) {
+    return undefined;
+  }
+  if (value === null) {
+    return null;
+  }
+  if (typeof value !== 'number' || !Number.isInteger(value) || value < 0) {
+    return INVALID_OPTIONAL;
+  }
+  return value;
+}
+
+function parseTaskLinearInput(value: unknown): ParsedTaskLinearInput | null {
+  const record = asRecord(value);
+  if (record === null) {
+    return null;
+  }
+  const issueId = readOptionalNullableString(record, 'issueId');
+  const identifier = readOptionalNullableString(record, 'identifier');
+  const url = readOptionalNullableString(record, 'url');
+  const teamId = readOptionalNullableString(record, 'teamId');
+  const projectId = readOptionalNullableString(record, 'projectId');
+  const projectMilestoneId = readOptionalNullableString(record, 'projectMilestoneId');
+  const cycleId = readOptionalNullableString(record, 'cycleId');
+  const stateId = readOptionalNullableString(record, 'stateId');
+  const assigneeId = readOptionalNullableString(record, 'assigneeId');
+  const dueDate = readOptionalNullableString(record, 'dueDate');
+  const priority = readOptionalNullableNonNegativeInteger(record, 'priority');
+  const estimate = readOptionalNullableNonNegativeInteger(record, 'estimate');
+  const labelsRaw = record['labelIds'];
+  let labelIds: string[] | null | undefined;
+  if (labelsRaw !== undefined) {
+    if (labelsRaw === null) {
+      labelIds = null;
+    } else if (Array.isArray(labelsRaw) && labelsRaw.every((entry) => typeof entry === 'string')) {
+      labelIds = [...labelsRaw];
+    } else {
+      return null;
+    }
+  }
+
+  if (
+    issueId === INVALID_OPTIONAL ||
+    identifier === INVALID_OPTIONAL ||
+    url === INVALID_OPTIONAL ||
+    teamId === INVALID_OPTIONAL ||
+    projectId === INVALID_OPTIONAL ||
+    projectMilestoneId === INVALID_OPTIONAL ||
+    cycleId === INVALID_OPTIONAL ||
+    stateId === INVALID_OPTIONAL ||
+    assigneeId === INVALID_OPTIONAL ||
+    dueDate === INVALID_OPTIONAL ||
+    priority === INVALID_OPTIONAL ||
+    estimate === INVALID_OPTIONAL
+  ) {
+    return null;
+  }
+  if (priority !== undefined && priority !== null && priority > 4) {
+    return null;
+  }
+
+  const out: ParsedTaskLinearInput = {};
+  if (issueId !== undefined) {
+    out.issueId = issueId;
+  }
+  if (identifier !== undefined) {
+    out.identifier = identifier;
+  }
+  if (url !== undefined) {
+    out.url = url;
+  }
+  if (teamId !== undefined) {
+    out.teamId = teamId;
+  }
+  if (projectId !== undefined) {
+    out.projectId = projectId;
+  }
+  if (projectMilestoneId !== undefined) {
+    out.projectMilestoneId = projectMilestoneId;
+  }
+  if (cycleId !== undefined) {
+    out.cycleId = cycleId;
+  }
+  if (stateId !== undefined) {
+    out.stateId = stateId;
+  }
+  if (assigneeId !== undefined) {
+    out.assigneeId = assigneeId;
+  }
+  if (priority !== undefined) {
+    out.priority = priority as 0 | 1 | 2 | 3 | 4 | null;
+  }
+  if (estimate !== undefined) {
+    out.estimate = estimate;
+  }
+  if (dueDate !== undefined) {
+    out.dueDate = dueDate;
+  }
+  if (labelIds !== undefined) {
+    out.labelIds = labelIds;
+  }
+  return out;
+}
+
+function parseSessionControllerType(value: unknown): 'human' | 'agent' | 'automation' | null {
+  if (value === 'human' || value === 'agent' || value === 'automation') {
+    return value;
+  }
+  return null;
+}
+
+function parseDirectoryUpsert(record: CommandRecord): StreamCommand | null {
+  const path = readString(record['path']);
+  if (path === null) {
+    return null;
+  }
+  const directoryId = readOptionalString(record, 'directoryId');
+  const tenantId = readOptionalString(record, 'tenantId');
+  const userId = readOptionalString(record, 'userId');
+  const workspaceId = readOptionalString(record, 'workspaceId');
+  if (
+    directoryId === undefined ||
+    tenantId === undefined ||
+    userId === undefined ||
+    workspaceId === undefined
+  ) {
+    return null;
+  }
+  const command: StreamCommand = {
+    type: 'directory.upsert',
+    path,
+  };
+  if (directoryId !== null) {
+    command.directoryId = directoryId;
+  }
+  if (tenantId !== null) {
+    command.tenantId = tenantId;
+  }
+  if (userId !== null) {
+    command.userId = userId;
+  }
+  if (workspaceId !== null) {
+    command.workspaceId = workspaceId;
+  }
+  return command;
+}
+
+function parseDirectoryList(record: CommandRecord): StreamCommand | null {
+  const tenantId = readOptionalString(record, 'tenantId');
+  const userId = readOptionalString(record, 'userId');
+  const workspaceId = readOptionalString(record, 'workspaceId');
+  const includeArchived = readOptionalBoolean(record, 'includeArchived');
+  const limit = readOptionalInteger(record, 'limit', 1);
+  if (
+    tenantId === undefined ||
+    userId === undefined ||
+    workspaceId === undefined ||
+    includeArchived === undefined ||
+    limit === undefined
+  ) {
+    return null;
+  }
+  const command: StreamCommand = {
+    type: 'directory.list',
+  };
+  if (tenantId !== null) {
+    command.tenantId = tenantId;
+  }
+  if (userId !== null) {
+    command.userId = userId;
+  }
+  if (workspaceId !== null) {
+    command.workspaceId = workspaceId;
+  }
+  if (includeArchived !== null) {
+    command.includeArchived = includeArchived;
+  }
+  if (limit !== null) {
+    command.limit = limit;
+  }
+  return command;
+}
+
+function parseDirectoryArchive(record: CommandRecord): StreamCommand | null {
+  const directoryId = readString(record['directoryId']);
+  if (directoryId === null) {
+    return null;
+  }
+  return {
+    type: 'directory.archive',
+    directoryId,
+  };
+}
+
+function parseDirectoryGitStatusList(record: CommandRecord): StreamCommand | null {
+  const tenantId = readOptionalString(record, 'tenantId');
+  const userId = readOptionalString(record, 'userId');
+  const workspaceId = readOptionalString(record, 'workspaceId');
+  const directoryId = readOptionalString(record, 'directoryId');
+  if (
+    tenantId === undefined ||
+    userId === undefined ||
+    workspaceId === undefined ||
+    directoryId === undefined
+  ) {
+    return null;
+  }
+  const command: StreamCommand = {
+    type: 'directory.git-status',
+  };
+  if (tenantId !== null) {
+    command.tenantId = tenantId;
+  }
+  if (userId !== null) {
+    command.userId = userId;
+  }
+  if (workspaceId !== null) {
+    command.workspaceId = workspaceId;
+  }
+  if (directoryId !== null) {
+    command.directoryId = directoryId;
+  }
+  return command;
+}
+
+function parseConversationCreate(record: CommandRecord): StreamCommand | null {
+  const directoryId = readString(record['directoryId']);
+  const title = readString(record['title']);
+  const agentType = readString(record['agentType']);
+  if (directoryId === null || title === null || agentType === null) {
+    return null;
+  }
+  const conversationId = readOptionalString(record, 'conversationId');
+  if (conversationId === undefined) {
+    return null;
+  }
+  const command: StreamCommand = {
+    type: 'conversation.create',
+    directoryId,
+    title,
+    agentType,
+  };
+  const adapterState = record['adapterState'];
+  if (adapterState !== undefined) {
+    const parsedAdapterState = asRecord(adapterState);
+    if (parsedAdapterState === null) {
+      return null;
+    }
+    command.adapterState = parsedAdapterState;
+  }
+  if (conversationId !== null) {
+    command.conversationId = conversationId;
+  }
+  return command;
+}
+
+function parseConversationList(record: CommandRecord): StreamCommand | null {
+  const directoryId = readOptionalString(record, 'directoryId');
+  const tenantId = readOptionalString(record, 'tenantId');
+  const userId = readOptionalString(record, 'userId');
+  const workspaceId = readOptionalString(record, 'workspaceId');
+  const includeArchived = readOptionalBoolean(record, 'includeArchived');
+  const limit = readOptionalInteger(record, 'limit', 1);
+  if (
+    directoryId === undefined ||
+    tenantId === undefined ||
+    userId === undefined ||
+    workspaceId === undefined ||
+    includeArchived === undefined ||
+    limit === undefined
+  ) {
+    return null;
+  }
+  const command: StreamCommand = {
+    type: 'conversation.list',
+  };
+  if (directoryId !== null) {
+    command.directoryId = directoryId;
+  }
+  if (tenantId !== null) {
+    command.tenantId = tenantId;
+  }
+  if (userId !== null) {
+    command.userId = userId;
+  }
+  if (workspaceId !== null) {
+    command.workspaceId = workspaceId;
+  }
+  if (includeArchived !== null) {
+    command.includeArchived = includeArchived;
+  }
+  if (limit !== null) {
+    command.limit = limit;
+  }
+  return command;
+}
+
+function parseConversationArchive(record: CommandRecord): StreamCommand | null {
+  const conversationId = readString(record['conversationId']);
+  if (conversationId === null) {
+    return null;
+  }
+  return {
+    type: 'conversation.archive',
+    conversationId,
+  };
+}
+
+function parseConversationUpdate(record: CommandRecord): StreamCommand | null {
+  const conversationId = readString(record['conversationId']);
+  const title = readString(record['title']);
+  if (conversationId === null || title === null) {
+    return null;
+  }
+  return {
+    type: 'conversation.update',
+    conversationId,
+    title,
+  };
+}
+
+function parseConversationDelete(record: CommandRecord): StreamCommand | null {
+  const conversationId = readString(record['conversationId']);
+  if (conversationId === null) {
+    return null;
+  }
+  return {
+    type: 'conversation.delete',
+    conversationId,
+  };
+}
+
+function parseRepositoryUpsert(record: CommandRecord): StreamCommand | null {
+  const name = readString(record['name']);
+  const remoteUrl = readString(record['remoteUrl']);
+  if (name === null || remoteUrl === null) {
+    return null;
+  }
+  const repositoryId = readOptionalString(record, 'repositoryId');
+  const tenantId = readOptionalString(record, 'tenantId');
+  const userId = readOptionalString(record, 'userId');
+  const workspaceId = readOptionalString(record, 'workspaceId');
+  const defaultBranch = readOptionalString(record, 'defaultBranch');
+  if (
+    repositoryId === undefined ||
+    tenantId === undefined ||
+    userId === undefined ||
+    workspaceId === undefined ||
+    defaultBranch === undefined
+  ) {
+    return null;
+  }
+  const command: StreamCommand = {
+    type: 'repository.upsert',
+    name,
+    remoteUrl,
+  };
+  if (repositoryId !== null) {
+    command.repositoryId = repositoryId;
+  }
+  if (tenantId !== null) {
+    command.tenantId = tenantId;
+  }
+  if (userId !== null) {
+    command.userId = userId;
+  }
+  if (workspaceId !== null) {
+    command.workspaceId = workspaceId;
+  }
+  if (defaultBranch !== null) {
+    command.defaultBranch = defaultBranch;
+  }
+  if (record['metadata'] !== undefined) {
+    const metadata = asRecord(record['metadata']);
+    if (metadata === null) {
+      return null;
+    }
+    command.metadata = metadata;
+  }
+  return command;
+}
+
+function parseRepositoryGet(record: CommandRecord): StreamCommand | null {
+  const repositoryId = readString(record['repositoryId']);
+  if (repositoryId === null) {
+    return null;
+  }
+  return {
+    type: 'repository.get',
+    repositoryId,
+  };
+}
+
+function parseRepositoryList(record: CommandRecord): StreamCommand | null {
+  const tenantId = readOptionalString(record, 'tenantId');
+  const userId = readOptionalString(record, 'userId');
+  const workspaceId = readOptionalString(record, 'workspaceId');
+  const includeArchived = readOptionalBoolean(record, 'includeArchived');
+  const limit = readOptionalInteger(record, 'limit', 1);
+  if (
+    tenantId === undefined ||
+    userId === undefined ||
+    workspaceId === undefined ||
+    includeArchived === undefined ||
+    limit === undefined
+  ) {
+    return null;
+  }
+  const command: StreamCommand = {
+    type: 'repository.list',
+  };
+  if (tenantId !== null) {
+    command.tenantId = tenantId;
+  }
+  if (userId !== null) {
+    command.userId = userId;
+  }
+  if (workspaceId !== null) {
+    command.workspaceId = workspaceId;
+  }
+  if (includeArchived !== null) {
+    command.includeArchived = includeArchived;
+  }
+  if (limit !== null) {
+    command.limit = limit;
+  }
+  return command;
+}
+
+function parseRepositoryUpdate(record: CommandRecord): StreamCommand | null {
+  const repositoryId = readString(record['repositoryId']);
+  if (repositoryId === null) {
+    return null;
+  }
+  const name = readOptionalString(record, 'name');
+  const remoteUrl = readOptionalString(record, 'remoteUrl');
+  const defaultBranch = readOptionalString(record, 'defaultBranch');
+  if (name === undefined || remoteUrl === undefined || defaultBranch === undefined) {
+    return null;
+  }
+  const command: StreamCommand = {
+    type: 'repository.update',
+    repositoryId,
+  };
+  if (name !== null) {
+    command.name = name;
+  }
+  if (remoteUrl !== null) {
+    command.remoteUrl = remoteUrl;
+  }
+  if (defaultBranch !== null) {
+    command.defaultBranch = defaultBranch;
+  }
+  if (record['metadata'] !== undefined) {
+    const metadata = asRecord(record['metadata']);
+    if (metadata === null) {
+      return null;
+    }
+    command.metadata = metadata;
+  }
+  return command;
+}
+
+function parseRepositoryArchive(record: CommandRecord): StreamCommand | null {
+  const repositoryId = readString(record['repositoryId']);
+  if (repositoryId === null) {
+    return null;
+  }
+  return {
+    type: 'repository.archive',
+    repositoryId,
+  };
+}
+
+function parseTaskCreate(record: CommandRecord): StreamCommand | null {
+  const title = readString(record['title']);
+  if (title === null) {
+    return null;
+  }
+  const taskId = readOptionalString(record, 'taskId');
+  const tenantId = readOptionalString(record, 'tenantId');
+  const userId = readOptionalString(record, 'userId');
+  const workspaceId = readOptionalString(record, 'workspaceId');
+  const repositoryId = readOptionalString(record, 'repositoryId');
+  const projectId = readOptionalString(record, 'projectId');
+  const description = readOptionalString(record, 'description');
+  if (
+    taskId === undefined ||
+    tenantId === undefined ||
+    userId === undefined ||
+    workspaceId === undefined ||
+    repositoryId === undefined ||
+    projectId === undefined ||
+    description === undefined
+  ) {
+    return null;
+  }
+  const command: StreamCommand = {
+    type: 'task.create',
+    title,
+  };
+  if (taskId !== null) {
+    command.taskId = taskId;
+  }
+  if (tenantId !== null) {
+    command.tenantId = tenantId;
+  }
+  if (userId !== null) {
+    command.userId = userId;
+  }
+  if (workspaceId !== null) {
+    command.workspaceId = workspaceId;
+  }
+  if (repositoryId !== null) {
+    command.repositoryId = repositoryId;
+  }
+  if (projectId !== null) {
+    command.projectId = projectId;
+  }
+  if (description !== null) {
+    command.description = description;
+  }
+  if (record['linear'] !== undefined) {
+    const linear = parseTaskLinearInput(record['linear']);
+    if (linear === null) {
+      return null;
+    }
+    command.linear = linear;
+  }
+  return command;
+}
+
+function parseTaskGet(record: CommandRecord): StreamCommand | null {
+  const taskId = readString(record['taskId']);
+  if (taskId === null) {
+    return null;
+  }
+  return {
+    type: 'task.get',
+    taskId,
+  };
+}
+
+function parseTaskList(record: CommandRecord): StreamCommand | null {
+  const tenantId = readOptionalString(record, 'tenantId');
+  const userId = readOptionalString(record, 'userId');
+  const workspaceId = readOptionalString(record, 'workspaceId');
+  const repositoryId = readOptionalString(record, 'repositoryId');
+  const projectId = readOptionalString(record, 'projectId');
+  const scopeKind = readOptionalString(record, 'scopeKind');
+  const status = readOptionalString(record, 'status');
+  const limit = readOptionalInteger(record, 'limit', 1);
+  if (
+    tenantId === undefined ||
+    userId === undefined ||
+    workspaceId === undefined ||
+    repositoryId === undefined ||
+    projectId === undefined ||
+    scopeKind === undefined ||
+    status === undefined ||
+    limit === undefined
+  ) {
+    return null;
+  }
+  if (
+    scopeKind !== null &&
+    scopeKind !== 'global' &&
+    scopeKind !== 'repository' &&
+    scopeKind !== 'project'
+  ) {
+    return null;
+  }
+  if (
+    status !== null &&
+    status !== 'draft' &&
+    status !== 'ready' &&
+    status !== 'queued' &&
+    status !== 'in-progress' &&
+    status !== 'completed'
+  ) {
+    return null;
+  }
+  const command: StreamCommand = {
+    type: 'task.list',
+  };
+  if (tenantId !== null) {
+    command.tenantId = tenantId;
+  }
+  if (userId !== null) {
+    command.userId = userId;
+  }
+  if (workspaceId !== null) {
+    command.workspaceId = workspaceId;
+  }
+  if (repositoryId !== null) {
+    command.repositoryId = repositoryId;
+  }
+  if (projectId !== null) {
+    command.projectId = projectId;
+  }
+  if (scopeKind !== null) {
+    command.scopeKind = scopeKind;
+  }
+  if (status !== null) {
+    command.status = status === 'queued' ? 'ready' : status;
+  }
+  if (limit !== null) {
+    command.limit = limit;
+  }
+  return command;
+}
+
+function parseTaskUpdate(record: CommandRecord): StreamCommand | null {
+  const taskId = readString(record['taskId']);
+  if (taskId === null) {
+    return null;
+  }
+  const title = readOptionalString(record, 'title');
+  const description = readOptionalString(record, 'description');
+  if (title === undefined || description === undefined) {
+    return null;
+  }
+  let repositoryId: string | null | undefined;
+  let projectId: string | null | undefined;
+  if (record['repositoryId'] === undefined) {
+    repositoryId = undefined;
+  } else if (record['repositoryId'] === null) {
+    repositoryId = null;
+  } else if (typeof record['repositoryId'] === 'string') {
+    repositoryId = record['repositoryId'];
+  } else {
+    return null;
+  }
+  if (record['projectId'] === undefined) {
+    projectId = undefined;
+  } else if (record['projectId'] === null) {
+    projectId = null;
+  } else if (typeof record['projectId'] === 'string') {
+    projectId = record['projectId'];
+  } else {
+    return null;
+  }
+
+  const command: StreamCommand = {
+    type: 'task.update',
+    taskId,
+  };
+  if (title !== null) {
+    command.title = title;
+  }
+  if (description !== null) {
+    command.description = description;
+  }
+  if (repositoryId !== undefined) {
+    command.repositoryId = repositoryId;
+  }
+  if (projectId !== undefined) {
+    command.projectId = projectId;
+  }
+  if (record['linear'] !== undefined) {
+    if (record['linear'] === null) {
+      command.linear = null;
+    } else {
+      const linear = parseTaskLinearInput(record['linear']);
+      if (linear === null) {
+        return null;
+      }
+      command.linear = linear;
+    }
+  }
+  return command;
+}
+
+function parseTaskDelete(record: CommandRecord): StreamCommand | null {
+  const taskId = readString(record['taskId']);
+  if (taskId === null) {
+    return null;
+  }
+  return {
+    type: 'task.delete',
+    taskId,
+  };
+}
+
+function parseTaskClaim(record: CommandRecord): StreamCommand | null {
+  const taskId = readString(record['taskId']);
+  const controllerId = readString(record['controllerId']);
+  if (taskId === null || controllerId === null) {
+    return null;
+  }
+  const directoryId = readOptionalString(record, 'directoryId');
+  const branchName = readOptionalString(record, 'branchName');
+  const baseBranch = readOptionalString(record, 'baseBranch');
+  if (directoryId === undefined || branchName === undefined || baseBranch === undefined) {
+    return null;
+  }
+  const command: StreamCommand = {
+    type: 'task.claim',
+    taskId,
+    controllerId,
+  };
+  if (directoryId !== null) {
+    command.directoryId = directoryId;
+  }
+  if (branchName !== null) {
+    command.branchName = branchName;
+  }
+  if (baseBranch !== null) {
+    command.baseBranch = baseBranch;
+  }
+  return command;
+}
+
+function parseTaskPull(record: CommandRecord): StreamCommand | null {
+  const tenantId = readOptionalString(record, 'tenantId');
+  const userId = readOptionalString(record, 'userId');
+  const workspaceId = readOptionalString(record, 'workspaceId');
+  const controllerId = readString(record['controllerId']);
+  const directoryId = readOptionalString(record, 'directoryId');
+  const repositoryId = readOptionalString(record, 'repositoryId');
+  const branchName = readOptionalString(record, 'branchName');
+  const baseBranch = readOptionalString(record, 'baseBranch');
+  if (
+    tenantId === undefined ||
+    userId === undefined ||
+    workspaceId === undefined ||
+    controllerId === null ||
+    directoryId === undefined ||
+    repositoryId === undefined ||
+    branchName === undefined ||
+    baseBranch === undefined
+  ) {
+    return null;
+  }
+  const command: StreamCommand = {
+    type: 'task.pull',
+    controllerId,
+  };
+  if (tenantId !== null) {
+    command.tenantId = tenantId;
+  }
+  if (userId !== null) {
+    command.userId = userId;
+  }
+  if (workspaceId !== null) {
+    command.workspaceId = workspaceId;
+  }
+  if (directoryId !== null) {
+    command.directoryId = directoryId;
+  }
+  if (repositoryId !== null) {
+    command.repositoryId = repositoryId;
+  }
+  if (branchName !== null) {
+    command.branchName = branchName;
+  }
+  if (baseBranch !== null) {
+    command.baseBranch = baseBranch;
+  }
+  return command;
+}
+
+function parseTaskComplete(record: CommandRecord): StreamCommand | null {
+  const taskId = readString(record['taskId']);
+  if (taskId === null) {
+    return null;
+  }
+  return {
+    type: 'task.complete',
+    taskId,
+  };
+}
+
+function parseTaskQueue(record: CommandRecord): StreamCommand | null {
+  const taskId = readString(record['taskId']);
+  if (taskId === null) {
+    return null;
+  }
+  return {
+    type: 'task.queue',
+    taskId,
+  };
+}
+
+function parseTaskReady(record: CommandRecord): StreamCommand | null {
+  const taskId = readString(record['taskId']);
+  if (taskId === null) {
+    return null;
+  }
+  return {
+    type: 'task.ready',
+    taskId,
+  };
+}
+
+function parseTaskDraft(record: CommandRecord): StreamCommand | null {
+  const taskId = readString(record['taskId']);
+  if (taskId === null) {
+    return null;
+  }
+  return {
+    type: 'task.draft',
+    taskId,
+  };
+}
+
+function parseTaskReorder(record: CommandRecord): StreamCommand | null {
+  const tenantId = readString(record['tenantId']);
+  const userId = readString(record['userId']);
+  const workspaceId = readString(record['workspaceId']);
+  const orderedTaskIds = record['orderedTaskIds'];
+  if (
+    tenantId === null ||
+    userId === null ||
+    workspaceId === null ||
+    !isStringArray(orderedTaskIds)
+  ) {
+    return null;
+  }
+  return {
+    type: 'task.reorder',
+    tenantId,
+    userId,
+    workspaceId,
+    orderedTaskIds,
+  };
+}
+
+function parseProjectSettingsGet(record: CommandRecord): StreamCommand | null {
+  const directoryId = readString(record['directoryId']);
+  if (directoryId === null) {
+    return null;
+  }
+  return {
+    type: 'project.settings-get',
+    directoryId,
+  };
+}
+
+function parseProjectSettingsUpdate(record: CommandRecord): StreamCommand | null {
+  const directoryId = readString(record['directoryId']);
+  if (directoryId === null) {
+    return null;
+  }
+  const pinnedBranch = readOptionalNullableString(record, 'pinnedBranch');
+  const taskFocusMode = readOptionalString(record, 'taskFocusMode');
+  const threadSpawnMode = readOptionalString(record, 'threadSpawnMode');
+  if (
+    pinnedBranch === INVALID_OPTIONAL ||
+    taskFocusMode === undefined ||
+    threadSpawnMode === undefined
+  ) {
+    return null;
+  }
+  if (taskFocusMode !== null && taskFocusMode !== 'balanced' && taskFocusMode !== 'own-only') {
+    return null;
+  }
+  if (
+    threadSpawnMode !== null &&
+    threadSpawnMode !== 'new-thread' &&
+    threadSpawnMode !== 'reuse-thread'
+  ) {
+    return null;
+  }
+  const command: StreamCommand = {
+    type: 'project.settings-update',
+    directoryId,
+  };
+  if (pinnedBranch !== undefined) {
+    command.pinnedBranch = pinnedBranch;
+  }
+  if (taskFocusMode !== null) {
+    command.taskFocusMode = taskFocusMode;
+  }
+  if (threadSpawnMode !== null) {
+    command.threadSpawnMode = threadSpawnMode;
+  }
+  return command;
+}
+
+function parseProjectStatus(record: CommandRecord): StreamCommand | null {
+  const directoryId = readString(record['directoryId']);
+  if (directoryId === null) {
+    return null;
+  }
+  return {
+    type: 'project.status',
+    directoryId,
+  };
+}
+
+function parseAutomationPolicyGet(record: CommandRecord): StreamCommand | null {
+  const tenantId = readOptionalString(record, 'tenantId');
+  const userId = readOptionalString(record, 'userId');
+  const workspaceId = readOptionalString(record, 'workspaceId');
+  const scope = readString(record['scope']);
+  const scopeId = readOptionalString(record, 'scopeId');
+  if (
+    tenantId === undefined ||
+    userId === undefined ||
+    workspaceId === undefined ||
+    scope === null ||
+    scopeId === undefined
+  ) {
+    return null;
+  }
+  if (scope !== 'global' && scope !== 'repository' && scope !== 'project') {
+    return null;
+  }
+  if (scope === 'global' && scopeId !== null) {
+    return null;
+  }
+  if (scope !== 'global' && scopeId === null) {
+    return null;
+  }
+  const command: StreamCommand = {
+    type: 'automation.policy-get',
+    scope,
+  };
+  if (tenantId !== null) {
+    command.tenantId = tenantId;
+  }
+  if (userId !== null) {
+    command.userId = userId;
+  }
+  if (workspaceId !== null) {
+    command.workspaceId = workspaceId;
+  }
+  if (scopeId !== null) {
+    command.scopeId = scopeId;
+  }
+  return command;
+}
+
+function parseAutomationPolicySet(record: CommandRecord): StreamCommand | null {
+  const tenantId = readOptionalString(record, 'tenantId');
+  const userId = readOptionalString(record, 'userId');
+  const workspaceId = readOptionalString(record, 'workspaceId');
+  const scope = readString(record['scope']);
+  const scopeId = readOptionalString(record, 'scopeId');
+  const automationEnabled = readOptionalBoolean(record, 'automationEnabled');
+  const frozen = readOptionalBoolean(record, 'frozen');
+  if (
+    tenantId === undefined ||
+    userId === undefined ||
+    workspaceId === undefined ||
+    scope === null ||
+    scopeId === undefined ||
+    automationEnabled === undefined ||
+    frozen === undefined
+  ) {
+    return null;
+  }
+  if (scope !== 'global' && scope !== 'repository' && scope !== 'project') {
+    return null;
+  }
+  if (scope === 'global' && scopeId !== null) {
+    return null;
+  }
+  if (scope !== 'global' && scopeId === null) {
+    return null;
+  }
+  const command: StreamCommand = {
+    type: 'automation.policy-set',
+    scope,
+  };
+  if (tenantId !== null) {
+    command.tenantId = tenantId;
+  }
+  if (userId !== null) {
+    command.userId = userId;
+  }
+  if (workspaceId !== null) {
+    command.workspaceId = workspaceId;
+  }
+  if (scopeId !== null) {
+    command.scopeId = scopeId;
+  }
+  if (automationEnabled !== null) {
+    command.automationEnabled = automationEnabled;
+  }
+  if (frozen !== null) {
+    command.frozen = frozen;
+  }
+  return command;
+}
+
+function parseGitHubProjectPr(record: CommandRecord): StreamCommand | null {
+  const directoryId = readString(record['directoryId']);
+  if (directoryId === null) {
+    return null;
+  }
+  return {
+    type: 'github.project-pr',
+    directoryId,
+  };
+}
+
+function parseGitHubPrList(record: CommandRecord): StreamCommand | null {
+  const tenantId = readOptionalString(record, 'tenantId');
+  const userId = readOptionalString(record, 'userId');
+  const workspaceId = readOptionalString(record, 'workspaceId');
+  const repositoryId = readOptionalString(record, 'repositoryId');
+  const directoryId = readOptionalString(record, 'directoryId');
+  const headBranch = readOptionalString(record, 'headBranch');
+  const state = readOptionalString(record, 'state');
+  const limit = readOptionalInteger(record, 'limit', 1);
+  if (
+    tenantId === undefined ||
+    userId === undefined ||
+    workspaceId === undefined ||
+    repositoryId === undefined ||
+    directoryId === undefined ||
+    headBranch === undefined ||
+    state === undefined ||
+    limit === undefined
+  ) {
+    return null;
+  }
+  if (state !== null && state !== 'open' && state !== 'closed') {
+    return null;
+  }
+  const command: StreamCommand = {
+    type: 'github.pr-list',
+  };
+  if (tenantId !== null) {
+    command.tenantId = tenantId;
+  }
+  if (userId !== null) {
+    command.userId = userId;
+  }
+  if (workspaceId !== null) {
+    command.workspaceId = workspaceId;
+  }
+  if (repositoryId !== null) {
+    command.repositoryId = repositoryId;
+  }
+  if (directoryId !== null) {
+    command.directoryId = directoryId;
+  }
+  if (headBranch !== null) {
+    command.headBranch = headBranch;
+  }
+  if (state !== null) {
+    command.state = state;
+  }
+  if (limit !== null) {
+    command.limit = limit;
+  }
+  return command;
+}
+
+function parseGitHubPrCreate(record: CommandRecord): StreamCommand | null {
+  const directoryId = readString(record['directoryId']);
+  if (directoryId === null) {
+    return null;
+  }
+  const title = readOptionalString(record, 'title');
+  const body = readOptionalString(record, 'body');
+  const baseBranch = readOptionalString(record, 'baseBranch');
+  const headBranch = readOptionalString(record, 'headBranch');
+  const draft = readOptionalBoolean(record, 'draft');
+  if (
+    title === undefined ||
+    body === undefined ||
+    baseBranch === undefined ||
+    headBranch === undefined ||
+    draft === undefined
+  ) {
+    return null;
+  }
+  const command: StreamCommand = {
+    type: 'github.pr-create',
+    directoryId,
+  };
+  if (title !== null) {
+    command.title = title;
+  }
+  if (body !== null) {
+    command.body = body;
+  }
+  if (baseBranch !== null) {
+    command.baseBranch = baseBranch;
+  }
+  if (headBranch !== null) {
+    command.headBranch = headBranch;
+  }
+  if (draft !== null) {
+    command.draft = draft;
+  }
+  return command;
+}
+
+function parseGitHubPrJobsList(record: CommandRecord): StreamCommand | null {
+  const tenantId = readOptionalString(record, 'tenantId');
+  const userId = readOptionalString(record, 'userId');
+  const workspaceId = readOptionalString(record, 'workspaceId');
+  const repositoryId = readOptionalString(record, 'repositoryId');
+  const prRecordId = readOptionalString(record, 'prRecordId');
+  const limit = readOptionalInteger(record, 'limit', 1);
+  if (
+    tenantId === undefined ||
+    userId === undefined ||
+    workspaceId === undefined ||
+    repositoryId === undefined ||
+    prRecordId === undefined ||
+    limit === undefined
+  ) {
+    return null;
+  }
+  const command: StreamCommand = {
+    type: 'github.pr-jobs-list',
+  };
+  if (tenantId !== null) {
+    command.tenantId = tenantId;
+  }
+  if (userId !== null) {
+    command.userId = userId;
+  }
+  if (workspaceId !== null) {
+    command.workspaceId = workspaceId;
+  }
+  if (repositoryId !== null) {
+    command.repositoryId = repositoryId;
+  }
+  if (prRecordId !== null) {
+    command.prRecordId = prRecordId;
+  }
+  if (limit !== null) {
+    command.limit = limit;
+  }
+  return command;
+}
+
+function parseGitHubRepoMyPrsUrl(record: CommandRecord): StreamCommand | null {
+  const repositoryId = readString(record['repositoryId']);
+  if (repositoryId === null) {
+    return null;
+  }
+  return {
+    type: 'github.repo-my-prs-url',
+    repositoryId,
+  };
+}
+
+function parseStreamSubscribe(record: CommandRecord): StreamCommand | null {
+  const tenantId = readOptionalString(record, 'tenantId');
+  const userId = readOptionalString(record, 'userId');
+  const workspaceId = readOptionalString(record, 'workspaceId');
+  const repositoryId = readOptionalString(record, 'repositoryId');
+  const taskId = readOptionalString(record, 'taskId');
+  const directoryId = readOptionalString(record, 'directoryId');
+  const conversationId = readOptionalString(record, 'conversationId');
+  const includeOutput = readOptionalBoolean(record, 'includeOutput');
+  const afterCursor = readOptionalInteger(record, 'afterCursor', 0);
+  if (
+    tenantId === undefined ||
+    userId === undefined ||
+    workspaceId === undefined ||
+    repositoryId === undefined ||
+    taskId === undefined ||
+    directoryId === undefined ||
+    conversationId === undefined ||
+    includeOutput === undefined ||
+    afterCursor === undefined
+  ) {
+    return null;
+  }
+  const command: StreamCommand = {
+    type: 'stream.subscribe',
+  };
+  if (tenantId !== null) {
+    command.tenantId = tenantId;
+  }
+  if (userId !== null) {
+    command.userId = userId;
+  }
+  if (workspaceId !== null) {
+    command.workspaceId = workspaceId;
+  }
+  if (repositoryId !== null) {
+    command.repositoryId = repositoryId;
+  }
+  if (taskId !== null) {
+    command.taskId = taskId;
+  }
+  if (directoryId !== null) {
+    command.directoryId = directoryId;
+  }
+  if (conversationId !== null) {
+    command.conversationId = conversationId;
+  }
+  if (includeOutput !== null) {
+    command.includeOutput = includeOutput;
+  }
+  if (afterCursor !== null) {
+    command.afterCursor = afterCursor;
+  }
+  return command;
+}
+
+function parseStreamUnsubscribe(record: CommandRecord): StreamCommand | null {
+  const subscriptionId = readString(record['subscriptionId']);
+  if (subscriptionId === null) {
+    return null;
+  }
+  return {
+    type: 'stream.unsubscribe',
+    subscriptionId,
+  };
+}
+
+function parseSessionList(record: CommandRecord): StreamCommand | null {
+  const tenantId = readOptionalString(record, 'tenantId');
+  const userId = readOptionalString(record, 'userId');
+  const workspaceId = readOptionalString(record, 'workspaceId');
+  const worktreeId = readOptionalString(record, 'worktreeId');
+  const status = readOptionalString(record, 'status');
+  const live = readOptionalBoolean(record, 'live');
+  const sort = readOptionalString(record, 'sort');
+  const limit = readOptionalInteger(record, 'limit', 1);
+  if (
+    tenantId === undefined ||
+    userId === undefined ||
+    workspaceId === undefined ||
+    worktreeId === undefined ||
+    status === undefined ||
+    live === undefined ||
+    sort === undefined ||
+    limit === undefined
+  ) {
+    return null;
+  }
+  if (
+    status !== null &&
+    status !== 'running' &&
+    status !== 'needs-input' &&
+    status !== 'completed' &&
+    status !== 'exited'
+  ) {
+    return null;
+  }
+  if (
+    sort !== null &&
+    sort !== 'attention-first' &&
+    sort !== 'started-desc' &&
+    sort !== 'started-asc'
+  ) {
+    return null;
+  }
+  const command: StreamCommand = {
+    type: 'session.list',
+  };
+  if (tenantId !== null) {
+    command.tenantId = tenantId;
+  }
+  if (userId !== null) {
+    command.userId = userId;
+  }
+  if (workspaceId !== null) {
+    command.workspaceId = workspaceId;
+  }
+  if (worktreeId !== null) {
+    command.worktreeId = worktreeId;
+  }
+  if (status !== null) {
+    command.status = status;
+  }
+  if (live !== null) {
+    command.live = live;
+  }
+  if (sort !== null) {
+    command.sort = sort;
+  }
+  if (limit !== null) {
+    command.limit = limit;
+  }
+  return command;
+}
+
+function parseAttentionList(): StreamCommand {
+  return {
+    type: 'attention.list',
+  };
+}
+
+function parseSessionIdCommand(type: 'session.status' | 'session.interrupt' | 'session.remove') {
+  return (record: CommandRecord): StreamCommand | null => {
+    const sessionId = readString(record['sessionId']);
+    if (sessionId === null) {
+      return null;
+    }
+    return {
+      type,
+      sessionId,
+    };
+  };
+}
+
+function parseSessionSnapshot(record: CommandRecord): StreamCommand | null {
+  const sessionId = readString(record['sessionId']);
+  const tailLines = readOptionalInteger(record, 'tailLines', 1);
+  if (sessionId === null || tailLines === undefined) {
+    return null;
+  }
+  const command: Extract<StreamCommand, { type: 'session.snapshot' }> = {
+    type: 'session.snapshot',
+    sessionId,
+  };
+  if (tailLines !== null) {
+    command.tailLines = tailLines;
+  }
+  return command;
+}
+
+function parseSessionRespond(record: CommandRecord): StreamCommand | null {
+  const sessionId = readString(record['sessionId']);
+  const text = readString(record['text']);
+  if (sessionId === null || text === null) {
+    return null;
+  }
+  return {
+    type: 'session.respond',
+    sessionId,
+    text,
+  };
+}
+
+function parseSessionClaim(record: CommandRecord): StreamCommand | null {
+  const sessionId = readString(record['sessionId']);
+  const controllerId = readString(record['controllerId']);
+  const controllerType = parseSessionControllerType(record['controllerType']);
+  if (sessionId === null || controllerId === null || controllerType === null) {
+    return null;
+  }
+  const controllerLabel = readOptionalString(record, 'controllerLabel');
+  const reason = readOptionalString(record, 'reason');
+  const takeover = readOptionalBoolean(record, 'takeover');
+  if (controllerLabel === undefined || reason === undefined || takeover === undefined) {
+    return null;
+  }
+  const command: StreamCommand = {
+    type: 'session.claim',
+    sessionId,
+    controllerId,
+    controllerType,
+  };
+  if (controllerLabel !== null) {
+    command.controllerLabel = controllerLabel;
+  }
+  if (reason !== null) {
+    command.reason = reason;
+  }
+  if (takeover !== null) {
+    command.takeover = takeover;
+  }
+  return command;
+}
+
+function parseSessionRelease(record: CommandRecord): StreamCommand | null {
+  const sessionId = readString(record['sessionId']);
+  if (sessionId === null) {
+    return null;
+  }
+  const reason = readOptionalString(record, 'reason');
+  if (reason === undefined) {
+    return null;
+  }
+  const command: StreamCommand = {
+    type: 'session.release',
+    sessionId,
+  };
+  if (reason !== null) {
+    command.reason = reason;
+  }
+  return command;
+}
+
+function parsePtyStart(record: CommandRecord): StreamCommand | null {
+  const sessionId = readString(record['sessionId']);
+  if (sessionId === null) {
+    return null;
+  }
+  const argsValue = record['args'];
+  if (!isStringArray(argsValue)) {
+    return null;
+  }
+  const initialCols = readNumber(record['initialCols']);
+  const initialRows = readNumber(record['initialRows']);
+  if (initialCols === null || initialRows === null) {
+    return null;
+  }
+  const envValue = record['env'];
+  let env: Record<string, string> | undefined;
+  if (envValue !== undefined) {
+    const parsedEnv = readStringRecord(envValue);
+    if (parsedEnv === null) {
+      return null;
+    }
+    env = parsedEnv;
+  }
+  const cwd = readOptionalString(record, 'cwd');
+  if (cwd === undefined) {
+    return null;
+  }
+  const tenantId = readOptionalString(record, 'tenantId');
+  const userId = readOptionalString(record, 'userId');
+  const workspaceId = readOptionalString(record, 'workspaceId');
+  const worktreeId = readOptionalString(record, 'worktreeId');
+  if (
+    tenantId === undefined ||
+    userId === undefined ||
+    workspaceId === undefined ||
+    worktreeId === undefined
+  ) {
+    return null;
+  }
+  const terminalForegroundHex = record['terminalForegroundHex'];
+  if (terminalForegroundHex !== undefined && typeof terminalForegroundHex !== 'string') {
+    return null;
+  }
+  const terminalBackgroundHex = record['terminalBackgroundHex'];
+  if (terminalBackgroundHex !== undefined && typeof terminalBackgroundHex !== 'string') {
+    return null;
+  }
+  const command: StreamCommand = {
+    type: 'pty.start',
+    sessionId,
+    args: argsValue,
+    initialCols,
+    initialRows,
+  };
+  if (env !== undefined) {
+    command.env = env;
+  }
+  if (cwd !== null) {
+    command.cwd = cwd;
+  }
+  if (terminalForegroundHex !== undefined) {
+    command.terminalForegroundHex = terminalForegroundHex;
+  }
+  if (terminalBackgroundHex !== undefined) {
+    command.terminalBackgroundHex = terminalBackgroundHex;
+  }
+  if (tenantId !== null) {
+    command.tenantId = tenantId;
+  }
+  if (userId !== null) {
+    command.userId = userId;
+  }
+  if (workspaceId !== null) {
+    command.workspaceId = workspaceId;
+  }
+  if (worktreeId !== null) {
+    command.worktreeId = worktreeId;
+  }
+  return command;
+}
+
+function parsePtyAttach(record: CommandRecord): StreamCommand | null {
+  const sessionId = readString(record['sessionId']);
+  if (sessionId === null) {
+    return null;
+  }
+  const sinceCursor = readNumber(record['sinceCursor']);
+  if (record['sinceCursor'] !== undefined && sinceCursor === null) {
+    return null;
+  }
+  const command: StreamCommand = {
+    type: 'pty.attach',
+    sessionId,
+  };
+  if (sinceCursor !== null) {
+    command.sinceCursor = sinceCursor;
+  }
+  return command;
+}
+
+function parsePtySimple(
+  type: 'pty.detach' | 'pty.subscribe-events' | 'pty.unsubscribe-events' | 'pty.close',
+) {
+  return (record: CommandRecord): StreamCommand | null => {
+    const sessionId = readString(record['sessionId']);
+    if (sessionId === null) {
+      return null;
+    }
+    return {
+      type,
+      sessionId,
+    };
+  };
+}
+
+export interface StreamCommandParserRegistry {
+  readonly [type: string]: CommandParser;
+}
+
+export const DEFAULT_STREAM_COMMAND_PARSERS: StreamCommandParserRegistry = {
+  'directory.upsert': parseDirectoryUpsert,
+  'directory.list': parseDirectoryList,
+  'directory.archive': parseDirectoryArchive,
+  'directory.git-status': parseDirectoryGitStatusList,
+  'conversation.create': parseConversationCreate,
+  'conversation.list': parseConversationList,
+  'conversation.archive': parseConversationArchive,
+  'conversation.update': parseConversationUpdate,
+  'conversation.delete': parseConversationDelete,
+  'repository.upsert': parseRepositoryUpsert,
+  'repository.get': parseRepositoryGet,
+  'repository.list': parseRepositoryList,
+  'repository.update': parseRepositoryUpdate,
+  'repository.archive': parseRepositoryArchive,
+  'task.create': parseTaskCreate,
+  'task.get': parseTaskGet,
+  'task.list': parseTaskList,
+  'task.update': parseTaskUpdate,
+  'task.delete': parseTaskDelete,
+  'task.claim': parseTaskClaim,
+  'task.pull': parseTaskPull,
+  'task.complete': parseTaskComplete,
+  'task.queue': parseTaskQueue,
+  'task.ready': parseTaskReady,
+  'task.draft': parseTaskDraft,
+  'task.reorder': parseTaskReorder,
+  'project.settings-get': parseProjectSettingsGet,
+  'project.settings-update': parseProjectSettingsUpdate,
+  'project.status': parseProjectStatus,
+  'automation.policy-get': parseAutomationPolicyGet,
+  'automation.policy-set': parseAutomationPolicySet,
+  'github.project-pr': parseGitHubProjectPr,
+  'github.pr-list': parseGitHubPrList,
+  'github.pr-create': parseGitHubPrCreate,
+  'github.pr-jobs-list': parseGitHubPrJobsList,
+  'github.repo-my-prs-url': parseGitHubRepoMyPrsUrl,
+  'stream.subscribe': parseStreamSubscribe,
+  'stream.unsubscribe': parseStreamUnsubscribe,
+  'session.list': parseSessionList,
+  'attention.list': () => parseAttentionList(),
+  'session.status': parseSessionIdCommand('session.status'),
+  'session.snapshot': parseSessionSnapshot,
+  'session.respond': parseSessionRespond,
+  'session.claim': parseSessionClaim,
+  'session.release': parseSessionRelease,
+  'session.interrupt': parseSessionIdCommand('session.interrupt'),
+  'session.remove': parseSessionIdCommand('session.remove'),
+  'pty.start': parsePtyStart,
+  'pty.attach': parsePtyAttach,
+  'pty.detach': parsePtySimple('pty.detach'),
+  'pty.subscribe-events': parsePtySimple('pty.subscribe-events'),
+  'pty.unsubscribe-events': parsePtySimple('pty.unsubscribe-events'),
+  'pty.close': parsePtySimple('pty.close'),
+};
+
+export function parseStreamCommand(
+  value: unknown,
+  parsers: StreamCommandParserRegistry = DEFAULT_STREAM_COMMAND_PARSERS,
+): StreamCommand | null {
+  const record = asRecord(value);
+  if (record === null) {
+    return null;
+  }
+  const type = readString(record['type']);
+  if (type === null) {
+    return null;
+  }
+  const parser = parsers[type as StreamCommandType];
+  if (parser === undefined) {
+    return null;
+  }
+  return parser(record);
+}