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.

meeting-recorder.transcripts.sync

Trigger a transcript sync from the meeting recorder provider.

  • Type: operation (command)
  • Version: 1.0.0
  • Stability: experimental
  • Owners: @platform.integrations
  • Tags: meeting-recorder, transcripts, sync
  • field.key.label
    meeting-recorder.transcripts.sync
    field.version.label
    1.0.0
    field.type.label
    operation (command)
    field.title.label
    meeting-recorder.transcripts.sync
    field.description.label

    Trigger a transcript sync from the meeting recorder provider.

  • Type: operation (command)
  • Version: 1.0.0
  • Stability: experimental
  • Owners: @platform.integrations
  • Tags: meeting-recorder, transcripts, sync
  • field.tags.label
    meeting-recorder,transcripts,sync
    field.owners.label
    @platform.integrations
    field.stability.label
    experimental

    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'),
    				};
    			},
    		},
    	},
    });