OSS-first docs
These docs teach the open system first: contracts, generated surfaces, runtimes, governance, and incremental adoption. Studio shows up as the operating layer on top, not as the source of truth.
Trigger a transcript sync from the meeting recorder provider.
Goal
Keep canonical transcripts aligned with external meeting providers.
Context
Invoked by scheduled jobs or webhooks when new transcripts are ready.
Source Definition
import {
type AnyOperationSpec,
defineCommand,
defineQuery,
} from '@lssm-tech/lib.contracts-spec/operations';
import type { OperationSpecRegistry } from '@lssm-tech/lib.contracts-spec/operations/registry';
import { ScalarTypeEnum, SchemaModel } from '@lssm-tech/lib.schema';
import { MeetingTranscriptRecord } from '../models';
import { MEETING_RECORDER_TELEMETRY_EVENTS } from '../telemetry';
export const MeetingRecorderSyncTranscript = defineCommand({
meta: {
key: 'meeting-recorder.transcripts.sync',
version: '1.0.0',
description:
'Trigger a transcript sync from the meeting recorder provider.',
goal: 'Keep canonical transcripts aligned with external meeting providers.',
context:
'Invoked by scheduled jobs or webhooks when new transcripts are ready.',
owners: ['@platform.integrations'],
tags: ['meeting-recorder', 'transcripts', 'sync'],
stability: 'experimental',
},
io: {
input: MeetingRecorderSyncTranscriptInput,
output: MeetingRecorderSyncTranscriptOutput,
},
policy: {
auth: 'admin',
},
telemetry: {
success: {
event: { key: MEETING_RECORDER_TELEMETRY_EVENTS.transcriptsSynced },
properties: ({ input, output }) => {
const payload = input as {
tenantId?: string;
meetingId?: string;
};
const result = output as {
synced?: number;
failed?: number;
} | null;
return {
tenantId: payload?.tenantId,
meetingId: payload?.meetingId,
synced: result?.synced,
failed: result?.failed,
};
},
},
failure: {
event: { key: MEETING_RECORDER_TELEMETRY_EVENTS.transcriptsSyncFailed },
properties: ({ input, error }) => {
const payload = input as {
tenantId?: string;
meetingId?: string;
};
return {
tenantId: payload?.tenantId,
meetingId: payload?.meetingId,
error:
error instanceof Error ? error.message : String(error ?? 'unknown'),
};
},
},
},
});