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.

knowledge.source.triggerSync

Trigger an immediate sync for a knowledge source.

  • Type: operation (command)
  • Version: 1.0.0
  • Stability: experimental
  • Owners: @platform.knowledge
  • Tags: knowledge, sources
  • File: packages/libs/contracts-spec/src/knowledge/operations.ts
  • field.key.label
    knowledge.source.triggerSync
    field.version.label
    1.0.0
    field.type.label
    operation (command)
    field.title.label
    knowledge.source.triggerSync
    field.description.label

    Trigger an immediate sync for a knowledge source.

  • Type: operation (command)
  • Version: 1.0.0
  • Stability: experimental
  • Owners: @platform.knowledge
  • Tags: knowledge, sources
  • File: packages/libs/contracts-spec/src/knowledge/operations.ts
  • field.tags.label
    knowledge,sources
    field.owners.label
    @platform.knowledge
    field.stability.label
    experimental

    Trigger an immediate sync for a knowledge source.

    Goal

    Support manual or automated sync retries for knowledge ingestion.

    Context

    Invoked by Ops tooling or monitors when knowledge content must be refreshed or reprocessed.

    Source Definition

    export const TriggerKnowledgeSourceSync = defineCommand({
      meta: {
        key: 'knowledge.source.triggerSync',
        title: 'Trigger Knowledge Source Sync',
        version: '1.0.0',
        description: 'Trigger an immediate sync for a knowledge source.',
        goal: 'Support manual or automated sync retries for knowledge ingestion.',
        context:
          'Invoked by Ops tooling or monitors when knowledge content must be refreshed or reprocessed.',
        owners: ['@platform.knowledge'],
        tags: ['knowledge', 'sources'],
        stability: 'experimental',
      },
      io: {
        input: TriggerKnowledgeSyncInput,
        output: TriggerKnowledgeSyncOutput,
      },
      policy: {
        auth: 'admin',
        policies: [{ key: 'platform.knowledge.manage', version: '1.0.0' }],
      },
    });