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.workflow.ingest-email-threads

Synchronises Gmail threads tagged with finance labels and indexes them into operational knowledge spaces.

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

    Synchronises Gmail threads tagged with finance labels and indexes them into operational knowledge spaces.

  • Type: workflow (workflow)
  • Version: 1.0.0
  • Tags: gmail, knowledge
  • File: packages/examples/pocket-family-office/src/workflows/ingest-email-threads.ts
  • field.tags.label
    gmail,knowledge
    field.owners.label
    field.stability.label

    Synchronises Gmail threads tagged with finance labels and indexes them into operational knowledge spaces.

    Source Definition

    export const ingestEmailThreadsWorkflow = defineWorkflow({
    	meta: {
    		key: 'pfo.workflow.ingest-email-threads',
    		version: '1.0.0',
    		title: 'Ingest Email Threads',
    		description:
    			'Synchronises Gmail threads tagged with finance labels and indexes them into operational knowledge spaces.',
    		domain: 'communications',
    		owners: [OwnersEnum.PlatformMessaging],
    		tags: ['gmail', 'knowledge', TagsEnum.Automation],
    		stability: StabilityEnum.Experimental,
    	},
    	definition: {
    		entryStepId: 'sync',
    		steps: [
    			{
    				id: 'sync',
    				type: 'automation',
    				label: 'Sync Gmail Threads',
    				description:
    					'Fetches Gmail threads and transforms them into knowledge fragments before vector indexing.',
    				action: {
    					operation: { key: 'pfo.email.sync-threads', version: '1.0.0' },
    				},
    				requiredIntegrations: ['emailInbound', 'primaryVectorDb'],
    				retry: {
    					maxAttempts: 3,
    					backoff: 'exponential',
    					delayMs: 1000,
    				},
    			},
    			{
    				id: 'triage',
    				type: 'human',
    				label: 'Triage Exceptions',
    				description:
    					'Operators can resolve sync failures or tag important threads for follow-up.',
    			},
    		],
    		transitions: [
    			{
    				from: 'sync',
    				to: 'triage',
    				condition: 'output?.syncedThreads === 0',
    				label: 'No new threads',
    			},
    		],
    	},
    });