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.

pfo.email.sync-threads

Triggers ingestion of Gmail threads into the operational knowledge space.

  • Type: operation (command)
  • Version: 1.0.0
  • Tags: gmail, knowledge
  • File: packages/examples/pocket-family-office/src/operations/index.ts
  • field.key.label
    pfo.email.sync-threads
    field.version.label
    1.0.0
    field.type.label
    operation (command)
    field.title.label
    pfo.email.sync-threads
    field.description.label

    Triggers ingestion of Gmail threads into the operational knowledge space.

  • Type: operation (command)
  • Version: 1.0.0
  • Tags: gmail, knowledge
  • File: packages/examples/pocket-family-office/src/operations/index.ts
  • field.tags.label
    gmail,knowledge
    field.owners.label
    field.stability.label

    Triggers ingestion of Gmail threads into the operational knowledge space.

    Goal

    Keep knowledge base up to date with email communications.

    Context

    Syncs from Gmail integration. Only includes threads matching configured labels.

    Source Definition

    import { OPENBANKING_TELEMETRY_EVENTS } from '@lssm-tech/lib.contracts-integrations';
    import {
    	defineCommand,
    	defineQuery,
    	type OperationSpec,
    } from '@lssm-tech/lib.contracts-spec';
    import {
    	OwnersEnum,
    	StabilityEnum,
    	TagsEnum,
    } from '@lssm-tech/lib.contracts-spec/ownership';
    import {
    	defineEnum,
    	defineSchemaModel,
    	ScalarTypeEnum,
    	type ZodSchemaModel,
    } from '@lssm-tech/lib.schema';
    
    export const syncEmailThreadsContract = defineCommand({
    	meta: {
    		key: 'pfo.email.sync-threads',
    		version: '1.0.0',
    		description:
    			'Triggers ingestion of Gmail threads into the operational knowledge space.',
    		goal: 'Keep knowledge base up to date with email communications.',
    		context:
    			'Syncs from Gmail integration. Only includes threads matching configured labels.',
    		owners: [OwnersEnum.PlatformMessaging],
    		tags: ['gmail', 'knowledge', TagsEnum.Automation],
    		stability: StabilityEnum.Beta,
    	},
    	io: {
    		input: SyncEmailThreadsInputModel,
    		output: SyncEmailThreadsOutputModel,
    	},
    	policy: {
    		auth: 'user',
    	},
    });