Files
thinkloom-openai-hackathon/schemas/provenance/v1/invocation-request.schema.json
T

238 lines
6.2 KiB
JSON

{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://thinkloom.app/schemas/provenance/1.0/invocation-request.schema.json",
"title": "Invocation request",
"description": "Credential-free immutable provider request evidence; minimal mode may omit messages.",
"type": "object",
"properties": {
"schema_version": {
"const": "1.0"
},
"invocation_id": {
"type": "string",
"pattern": "^invocation_[0-9A-HJKMNP-TV-Z]{26}$"
},
"project_id": {
"type": "string",
"pattern": "^project_[0-9A-HJKMNP-TV-Z]{26}$"
},
"purpose": {
"type": "string",
"pattern": "^[a-z][a-z0-9_]+$"
},
"initiated_by_event_id": {
"type": "string",
"pattern": "^event_[0-9A-HJKMNP-TV-Z]{26}$"
},
"retention_mode": {
"enum": [
"minimal",
"full_private"
]
},
"provider": {
"type": "object",
"properties": {
"provider_id": {
"type": "string",
"minLength": 1
},
"model_id": {
"type": "string",
"minLength": 1
},
"processing_mode": {
"enum": [
"local",
"cloud"
]
}
},
"required": [
"provider_id",
"model_id",
"processing_mode"
],
"additionalProperties": false
},
"model_configuration_sha256": {
"type": "string",
"pattern": "^sha256:[a-f0-9]{64}$"
},
"prompt_template": {
"$ref": "https://thinkloom.app/schemas/provenance/1.0/prompt-template-reference.schema.json"
},
"messages": {
"type": "array",
"items": {
"type": "object",
"properties": {
"role": {
"enum": [
"system",
"user",
"assistant",
"tool"
]
},
"content": {
"type": "string",
"minLength": 1
}
},
"required": [
"role",
"content"
],
"additionalProperties": false
}
},
"context_references": {
"type": "array",
"items": {
"$ref": "https://thinkloom.app/schemas/provenance/1.0/content-reference.schema.json"
}
},
"manuscript_revision_id": {
"anyOf": [
{
"type": "string",
"pattern": "^revision_[0-9A-HJKMNP-TV-Z]{26}$"
},
{
"type": "null"
}
]
},
"idea_revision_ids": {
"type": "array",
"items": {
"type": "string",
"pattern": "^revision_[0-9A-HJKMNP-TV-Z]{26}$"
},
"uniqueItems": true
},
"conversation_head": {
"anyOf": [
{
"type": "string",
"pattern": "^turn_[0-9A-HJKMNP-TV-Z]{26}$"
},
{
"type": "null"
}
]
},
"submitted_at": {
"type": "string",
"format": "date-time",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}\\.\\d{3}Z$"
},
"redactions": {
"type": "array",
"items": {
"type": "object",
"properties": {
"category": {
"enum": [
"credential",
"personal_identifier",
"signed_url",
"policy_omission",
"other"
]
},
"replacement": {
"type": "string",
"minLength": 1
}
},
"required": [
"category",
"replacement"
],
"additionalProperties": false
}
}
},
"required": [
"schema_version",
"invocation_id",
"project_id",
"purpose",
"initiated_by_event_id",
"retention_mode",
"provider",
"model_configuration_sha256",
"prompt_template",
"messages",
"context_references",
"manuscript_revision_id",
"idea_revision_ids",
"conversation_head",
"submitted_at",
"redactions"
],
"additionalProperties": false,
"examples": [
{
"schema_version": "1.0",
"invocation_id": "invocation_01J00000000000000000000008",
"project_id": "project_01J00000000000000000000001",
"purpose": "draft_from_selected_ideas",
"initiated_by_event_id": "event_01J00000000000000000000003",
"retention_mode": "full_private",
"provider": {
"provider_id": "ollama",
"model_id": "llama3.2",
"processing_mode": "local"
},
"model_configuration_sha256": "sha256:8888888888888888888888888888888888888888888888888888888888888888",
"prompt_template": {
"schema_version": "1.0",
"template_id": "template_01J0000000000000000000000F",
"version": 1,
"path": "records/prompt-templates/drafting/template.json",
"template_sha256": "sha256:7777777777777777777777777777777777777777777777777777777777777777"
},
"messages": [
{
"role": "user",
"content": "Use the selected ideas to draft a passage."
}
],
"context_references": [
{
"schema_version": "1.0",
"record_id": "record_01J00000000000000000000005",
"record_type": "manuscript_revision",
"sha256": "sha256:2222222222222222222222222222222222222222222222222222222222222222",
"path": "manuscript/revisions/revision.json",
"revision_id": "revision_01J0000000000000000000000A",
"range": {
"schema_version": "1.0",
"document_revision_id": "revision_01J0000000000000000000000A",
"coordinate_system": "utf8_byte",
"start": 0,
"end": 12,
"preimage_sha256": "sha256:1111111111111111111111111111111111111111111111111111111111111111",
"text_fragment_id": "fragment_01J0000000000000000000000C"
}
}
],
"manuscript_revision_id": "revision_01J0000000000000000000000A",
"idea_revision_ids": [
"revision_01J0000000000000000000000B"
],
"conversation_head": "turn_01J00000000000000000000007",
"submitted_at": "2026-07-17T18:42:10.123Z",
"redactions": [
{
"category": "personal_identifier",
"replacement": "[redacted]"
}
]
}
]
}