@sixb/sqlite 0.1.0 → 0.1.2

package/src/migrations/007-split-overrides.sql

@@ -0,0 +1,154 @@
+CREATE TABLE ontology_object_overrides (
+  project_id TEXT NOT NULL,
+  object_type_id TEXT NOT NULL,
+  primary_id TEXT NOT NULL,
+  value TEXT NOT NULL CHECK (json_valid(value) AND json_type(value) = 'object'),
+  last_commit_id TEXT NOT NULL,
+  updated_at TEXT NOT NULL,
+  PRIMARY KEY (project_id, object_type_id, primary_id),
+  CHECK (COALESCE(json_extract(value, '$.kind') IN ('create', 'patch', 'delete'), 0))
+);
+
+CREATE TABLE ontology_link_overrides (
+  project_id TEXT NOT NULL,
+  identity_kind TEXT NOT NULL CHECK (identity_kind IN ('edge', 'slot')),
+  identity_key TEXT NOT NULL CHECK (json_valid(identity_key)),
+  source_type_id TEXT NOT NULL,
+  source_primary_id TEXT NOT NULL,
+  link_id TEXT NOT NULL,
+  target_type_id TEXT NOT NULL,
+  target_primary_id TEXT NOT NULL,
+  value TEXT NOT NULL CHECK (json_valid(value) AND json_type(value) = 'object'),
+  last_commit_id TEXT NOT NULL,
+  updated_at TEXT NOT NULL,
+  PRIMARY KEY (project_id, identity_kind, identity_key),
+  CHECK (
+    identity_key = CASE identity_kind
+      WHEN 'edge' THEN json_array(
+        source_type_id, source_primary_id, link_id, target_type_id, target_primary_id
+      )
+      WHEN 'slot' THEN json_array(source_type_id, source_primary_id, link_id)
+    END
+  ),
+  CHECK (
+    (identity_kind = 'edge'
+      AND COALESCE(json_extract(value, '$.kind') IN ('upsert', 'delete'), 0))
+    OR
+    (identity_kind = 'slot'
+      AND COALESCE(json_extract(value, '$.kind') IN ('set', 'clear', 'legacy-conflict'), 0)
+      AND (
+        json_extract(value, '$.kind') = 'legacy-conflict'
+        OR (
+          target_type_id = json_extract(value, '$.target.objectTypeId')
+          AND target_primary_id = json_extract(value, '$.target.primaryId')
+        )
+      ))
+  )
+);
+
+CREATE INDEX idx_ontology_link_overrides_source
+  ON ontology_link_overrides(
+    project_id, identity_kind, source_type_id, source_primary_id, link_id,
+    target_type_id, target_primary_id
+  );
+
+CREATE INDEX idx_ontology_link_overrides_target
+  ON ontology_link_overrides(project_id, target_type_id, target_primary_id);
+
+INSERT INTO ontology_object_overrides (
+  project_id, object_type_id, primary_id, value, last_commit_id, updated_at
+)
+SELECT project_id, object_type_id, primary_id, value, last_commit_id, updated_at
+FROM ontology_overrides
+WHERE entity_kind = 'object';
+
+INSERT INTO ontology_link_overrides (
+  project_id, identity_kind, identity_key,
+  source_type_id, source_primary_id, link_id, target_type_id, target_primary_id,
+  value, last_commit_id, updated_at
+)
+SELECT project_id, 'edge', entity_key,
+  source_type_id, source_primary_id, link_id, target_type_id, target_primary_id,
+  value, last_commit_id, updated_at
+FROM ontology_overrides
+WHERE entity_kind = 'link';
+
+-- Storage migrations do not have access to the ontology cardinality. Derive a slot candidate for
+-- every legacy link scope; the runtime selects edge or slot authority from the registered ontology.
+-- A single upsert is an unambiguous set and a delete-only scope is an unambiguous clear. Multiple
+-- upserts are preserved as an explicit conflict instead of selecting a target arbitrarily.
+WITH scopes AS (
+  SELECT project_id, source_type_id, source_primary_id, link_id,
+    SUM(CASE WHEN json_extract(value, '$.kind') = 'upsert' THEN 1 ELSE 0 END) AS upsert_count
+  FROM ontology_overrides
+  WHERE entity_kind = 'link'
+  GROUP BY project_id, source_type_id, source_primary_id, link_id
+), selected AS (
+  SELECT scopes.*,
+    COALESCE(
+      (
+        SELECT entity_key FROM ontology_overrides AS candidate
+        WHERE candidate.project_id = scopes.project_id
+          AND candidate.entity_kind = 'link'
+          AND candidate.source_type_id = scopes.source_type_id
+          AND candidate.source_primary_id = scopes.source_primary_id
+          AND candidate.link_id = scopes.link_id
+          AND json_extract(candidate.value, '$.kind') = 'upsert'
+        ORDER BY candidate.updated_at DESC, candidate.entity_sort_key DESC
+        LIMIT 1
+      ),
+      (
+        SELECT entity_key FROM ontology_overrides AS candidate
+        WHERE candidate.project_id = scopes.project_id
+          AND candidate.entity_kind = 'link'
+          AND candidate.source_type_id = scopes.source_type_id
+          AND candidate.source_primary_id = scopes.source_primary_id
+          AND candidate.link_id = scopes.link_id
+        ORDER BY candidate.updated_at DESC, candidate.entity_sort_key DESC
+        LIMIT 1
+      )
+    ) AS selected_key
+  FROM scopes
+)
+INSERT INTO ontology_link_overrides (
+  project_id, identity_kind, identity_key,
+  source_type_id, source_primary_id, link_id, target_type_id, target_primary_id,
+  value, last_commit_id, updated_at
+)
+SELECT selected.project_id, 'slot',
+  json_array(selected.source_type_id, selected.source_primary_id, selected.link_id),
+  selected.source_type_id, selected.source_primary_id, selected.link_id,
+  overrides.target_type_id, overrides.target_primary_id,
+  CASE
+    WHEN selected.upsert_count > 1 THEN json_object('kind', 'legacy-conflict')
+    WHEN selected.upsert_count = 1 THEN json_patch(
+      json_object(
+        'kind', 'set',
+        'target', json_object(
+          'objectTypeId', overrides.target_type_id,
+          'primaryId', overrides.target_primary_id
+        )
+      ),
+      CASE
+        WHEN json_type(overrides.value, '$.properties') IS NOT NULL
+          THEN json_object('properties', json_extract(overrides.value, '$.properties'))
+        ELSE json('{}')
+      END
+    )
+    ELSE json_object(
+      'kind', 'clear',
+      'target', json_object(
+        'objectTypeId', overrides.target_type_id,
+        'primaryId', overrides.target_primary_id
+      )
+    )
+  END,
+  overrides.last_commit_id,
+  overrides.updated_at
+FROM selected
+JOIN ontology_overrides AS overrides
+  ON overrides.project_id = selected.project_id
+ AND overrides.entity_kind = 'link'
+ AND overrides.entity_key = selected.selected_key;
+
+DROP TABLE ontology_overrides;

package/src/migrations/008-action-executions.sql

@@ -0,0 +1,4 @@
+ALTER TABLE action_runs ADD COLUMN execution_id TEXT NOT NULL;
+
+CREATE UNIQUE INDEX idx_action_runs_project_execution
+  ON action_runs(project_id, execution_id);

package/src/migrations/009-agent-executions.sql

@@ -0,0 +1,115 @@
+-- Existing rows cannot be assigned an honest authority retroactively. These NOT NULL additions
+-- intentionally fail on non-empty legacy tables instead of inventing execution provenance.
+ALTER TABLE agent_runs ADD COLUMN execution_id TEXT NOT NULL;
+ALTER TABLE workflow_agent_node_runs ADD COLUMN execution_id TEXT NOT NULL;
+
+CREATE TABLE agent_runs_v2 (
+  project_id TEXT NOT NULL,
+  id TEXT NOT NULL,
+  execution_id TEXT NOT NULL,
+  thread_id TEXT NOT NULL,
+  agent_id TEXT NOT NULL,
+  trigger_message_id TEXT NOT NULL,
+  status TEXT NOT NULL CHECK (
+    status IN ('queued', 'running', 'succeeded', 'failed', 'cancelled')
+  ),
+  model_id TEXT,
+  finish_reason TEXT,
+  usage_input_tokens INTEGER CHECK (usage_input_tokens IS NULL OR usage_input_tokens >= 0),
+  usage_output_tokens INTEGER CHECK (usage_output_tokens IS NULL OR usage_output_tokens >= 0),
+  usage_total_tokens INTEGER CHECK (usage_total_tokens IS NULL OR usage_total_tokens >= 0),
+  usage_reasoning_tokens INTEGER CHECK (
+    usage_reasoning_tokens IS NULL OR usage_reasoning_tokens >= 0
+  ),
+  usage_cached_input_tokens INTEGER CHECK (
+    usage_cached_input_tokens IS NULL OR usage_cached_input_tokens >= 0
+  ),
+  error TEXT,
+  diagnostics TEXT,
+  attempt INTEGER NOT NULL DEFAULT 0 CHECK (attempt >= 0),
+  execution_token TEXT,
+  execution_queue_lease_expires_at TEXT,
+  created_at TEXT NOT NULL,
+  started_at TEXT,
+  completed_at TEXT,
+  PRIMARY KEY (project_id, id),
+  UNIQUE (project_id, execution_id),
+  FOREIGN KEY (project_id, execution_id)
+    REFERENCES executions (project_id, id)
+    ON DELETE RESTRICT,
+  CHECK ((execution_token IS NULL) = (execution_queue_lease_expires_at IS NULL))
+);
+
+INSERT INTO agent_runs_v2 (
+  project_id, id, execution_id, thread_id, agent_id, trigger_message_id, status, model_id,
+  finish_reason, usage_input_tokens, usage_output_tokens, usage_total_tokens,
+  usage_reasoning_tokens, usage_cached_input_tokens, error, diagnostics, attempt, execution_token,
+  execution_queue_lease_expires_at, created_at, started_at, completed_at
+)
+SELECT
+  project_id, id, execution_id, thread_id, agent_id, trigger_message_id, status, model_id,
+  finish_reason, usage_input_tokens, usage_output_tokens, usage_total_tokens,
+  usage_reasoning_tokens, usage_cached_input_tokens, error, diagnostics, attempt, execution_token,
+  execution_queue_lease_expires_at, created_at, started_at, completed_at
+FROM agent_runs;
+
+DROP TABLE agent_runs;
+ALTER TABLE agent_runs_v2 RENAME TO agent_runs;
+
+CREATE INDEX idx_agent_runs_project_started
+  ON agent_runs(project_id, COALESCE(started_at, created_at) DESC);
+CREATE INDEX idx_agent_runs_project_thread_started
+  ON agent_runs(project_id, thread_id, COALESCE(started_at, created_at) DESC);
+CREATE INDEX idx_agent_runs_project_agent_started
+  ON agent_runs(project_id, agent_id, COALESCE(started_at, created_at) DESC);
+CREATE INDEX idx_agent_runs_project_status_started
+  ON agent_runs(project_id, status, COALESCE(started_at, created_at) DESC);
+
+CREATE TABLE workflow_agent_node_runs_v2 (
+  project_id TEXT NOT NULL,
+  node_run_id TEXT NOT NULL,
+  execution_id TEXT NOT NULL,
+  agent_id TEXT NOT NULL,
+  status TEXT NOT NULL CHECK (status IN ('queued', 'running', 'succeeded', 'failed', 'cancelled')),
+  prompt TEXT NOT NULL,
+  model_id TEXT,
+  finish_reason TEXT,
+  usage TEXT,
+  trace TEXT,
+  diagnostics TEXT,
+  error TEXT,
+  attempt INTEGER NOT NULL DEFAULT 0 CHECK (attempt >= 0),
+  execution_token TEXT,
+  execution_queue_lease_expires_at TEXT,
+  created_at TEXT NOT NULL,
+  started_at TEXT,
+  completed_at TEXT,
+  PRIMARY KEY (project_id, node_run_id),
+  UNIQUE (project_id, execution_id),
+  FOREIGN KEY (project_id, node_run_id)
+    REFERENCES workflow_node_runs (project_id, id)
+    ON DELETE CASCADE,
+  FOREIGN KEY (project_id, execution_id)
+    REFERENCES executions (project_id, id)
+    ON DELETE RESTRICT,
+  CHECK ((execution_token IS NULL) = (execution_queue_lease_expires_at IS NULL))
+);
+
+INSERT INTO workflow_agent_node_runs_v2 (
+  project_id, node_run_id, execution_id, agent_id, status, prompt, model_id, finish_reason, usage,
+  trace, diagnostics, error, attempt, execution_token, execution_queue_lease_expires_at, created_at,
+  started_at, completed_at
+)
+SELECT
+  project_id, node_run_id, execution_id, agent_id, status, prompt, model_id, finish_reason, usage,
+  trace, diagnostics, error, attempt, execution_token, execution_queue_lease_expires_at, created_at,
+  started_at, completed_at
+FROM workflow_agent_node_runs;
+
+DROP TABLE workflow_agent_node_runs;
+ALTER TABLE workflow_agent_node_runs_v2 RENAME TO workflow_agent_node_runs;
+
+CREATE INDEX idx_workflow_agent_node_runs_project_agent_created
+  ON workflow_agent_node_runs(project_id, agent_id, created_at DESC);
+CREATE INDEX idx_workflow_agent_node_runs_project_status_created
+  ON workflow_agent_node_runs(project_id, status, created_at DESC);

package/src/migrations/010-ai-usage-accounting-foundation.sql

@@ -0,0 +1,74 @@
+ALTER TABLE agent_runs
+  ADD COLUMN requester_group_ids TEXT NOT NULL DEFAULT '[]'
+  CHECK (json_valid(requester_group_ids) AND json_type(requester_group_ids) = 'array');
+
+ALTER TABLE workflow_runs
+  ADD COLUMN requester_group_ids TEXT NOT NULL DEFAULT '[]'
+  CHECK (json_valid(requester_group_ids) AND json_type(requester_group_ids) = 'array');
+
+CREATE TABLE ai_model_call_usage (
+  project_id TEXT NOT NULL CHECK (length(trim(project_id)) > 0),
+  id TEXT NOT NULL CHECK (length(trim(id)) > 0),
+  execution_id TEXT NOT NULL CHECK (length(trim(execution_id)) > 0),
+  attempt INTEGER NOT NULL CHECK (attempt >= 1),
+  call_id TEXT NOT NULL CHECK (length(trim(call_id)) > 0),
+  provider_id TEXT NOT NULL CHECK (length(trim(provider_id)) > 0),
+  requested_model_id TEXT NOT NULL CHECK (length(trim(requested_model_id)) > 0),
+  response_model_id TEXT CHECK (
+    response_model_id IS NULL OR length(trim(response_model_id)) > 0
+  ),
+  response_id TEXT NOT NULL CHECK (length(trim(response_id)) > 0),
+  input_tokens INTEGER CHECK (input_tokens IS NULL OR input_tokens >= 0),
+  output_tokens INTEGER CHECK (output_tokens IS NULL OR output_tokens >= 0),
+  total_tokens INTEGER CHECK (total_tokens IS NULL OR total_tokens >= 0),
+  uncached_input_tokens INTEGER CHECK (
+    uncached_input_tokens IS NULL OR uncached_input_tokens >= 0
+  ),
+  cache_read_input_tokens INTEGER CHECK (
+    cache_read_input_tokens IS NULL OR cache_read_input_tokens >= 0
+  ),
+  cache_write_input_tokens INTEGER CHECK (
+    cache_write_input_tokens IS NULL OR cache_write_input_tokens >= 0
+  ),
+  text_output_tokens INTEGER CHECK (
+    text_output_tokens IS NULL OR text_output_tokens >= 0
+  ),
+  reasoning_output_tokens INTEGER CHECK (
+    reasoning_output_tokens IS NULL OR reasoning_output_tokens >= 0
+  ),
+  reporting_status TEXT NOT NULL CHECK (
+    reporting_status IN ('complete', 'partial', 'unavailable')
+  ),
+  raw_usage TEXT CHECK (
+    raw_usage IS NULL OR (json_valid(raw_usage) AND json_type(raw_usage) = 'object')
+  ),
+  occurred_at TEXT NOT NULL,
+  recorded_at TEXT NOT NULL,
+  PRIMARY KEY (project_id, id),
+  FOREIGN KEY (project_id, execution_id)
+    REFERENCES executions(project_id, id)
+    ON DELETE RESTRICT
+);
+
+CREATE UNIQUE INDEX idx_ai_model_call_usage_idempotency
+  ON ai_model_call_usage (project_id, execution_id, attempt, call_id, response_id);
+CREATE INDEX idx_ai_model_call_usage_execution
+  ON ai_model_call_usage (project_id, execution_id, occurred_at, id);
+CREATE INDEX idx_ai_model_call_usage_project_time
+  ON ai_model_call_usage (project_id, occurred_at, id);
+CREATE INDEX idx_ai_model_call_usage_provider_response
+  ON ai_model_call_usage (project_id, provider_id, response_id);
+
+CREATE TABLE ai_model_call_usage_groups (
+  project_id TEXT NOT NULL,
+  usage_record_id TEXT NOT NULL,
+  group_id TEXT NOT NULL,
+  occurred_at TEXT NOT NULL,
+  PRIMARY KEY (project_id, usage_record_id, group_id),
+  FOREIGN KEY (project_id, usage_record_id)
+    REFERENCES ai_model_call_usage(project_id, id)
+    ON DELETE CASCADE
+);
+
+CREATE INDEX idx_ai_model_call_usage_groups_group_time
+  ON ai_model_call_usage_groups (project_id, group_id, occurred_at, usage_record_id);

package/src/migrations/011-sync-failure-record.sql

@@ -0,0 +1,22 @@
+ALTER TABLE sync_runs ADD COLUMN error TEXT CHECK (error IS NULL OR json_valid(error));
+
+UPDATE sync_runs
+SET error = json_object(
+  'code', CASE WHEN status = 'cancelled' THEN 'runtime.cancelled' ELSE 'internal.unexpected' END,
+  'message', CASE
+    WHEN status = 'cancelled' THEN 'Execution was cancelled.'
+    ELSE 'An unexpected internal error occurred.'
+  END,
+  'retryable', json('false'),
+  'at', COALESCE(finished_at, started_at),
+  'details', json_object(
+    'syncId', sync_id,
+    'runId', id,
+    'datasetId', dataset_id,
+    'migratedFromLegacyError', json('true')
+  )
+)
+WHERE error_name IS NOT NULL OR error_message IS NOT NULL;
+
+ALTER TABLE sync_runs DROP COLUMN error_name;
+ALTER TABLE sync_runs DROP COLUMN error_message;

package/src/migrations/012-pipeline-failure-record.sql

@@ -0,0 +1,45 @@
+ALTER TABLE pipeline_runs ADD COLUMN error TEXT CHECK (error IS NULL OR json_valid(error));
+
+UPDATE pipeline_runs
+SET error = json_object(
+  'code', CASE WHEN status = 'cancelled' THEN 'runtime.cancelled' ELSE 'internal.unexpected' END,
+  'message', CASE
+    WHEN status = 'cancelled' THEN 'Execution was cancelled.'
+    ELSE 'An unexpected internal error occurred.'
+  END,
+  'retryable', json('false'),
+  'at', COALESCE(finished_at, started_at),
+  'details', json_object(
+    'pipelineId', pipeline_id,
+    'runId', id,
+    'migratedFromLegacyError', json('true')
+  )
+)
+WHERE error_name IS NOT NULL OR error_message IS NOT NULL;
+
+ALTER TABLE pipeline_runs DROP COLUMN error_name;
+ALTER TABLE pipeline_runs DROP COLUMN error_message;
+
+ALTER TABLE pipeline_step_runs ADD COLUMN error TEXT CHECK (error IS NULL OR json_valid(error));
+
+UPDATE pipeline_step_runs
+SET error = json_object(
+  'code', CASE WHEN status = 'cancelled' THEN 'runtime.cancelled' ELSE 'internal.unexpected' END,
+  'message', CASE
+    WHEN status = 'cancelled' THEN 'Execution was cancelled.'
+    ELSE 'An unexpected internal error occurred.'
+  END,
+  'retryable', json('false'),
+  'at', COALESCE(finished_at, started_at),
+  'details', json_object(
+    'pipelineId', pipeline_id,
+    'pipelineRunId', pipeline_run_id,
+    'stepId', step_id,
+    'stepRunId', id,
+    'migratedFromLegacyError', json('true')
+  )
+)
+WHERE error_name IS NOT NULL OR error_message IS NOT NULL;
+
+ALTER TABLE pipeline_step_runs DROP COLUMN error_name;
+ALTER TABLE pipeline_step_runs DROP COLUMN error_message;

package/src/migrations/013-workflow-failure-record.sql

@@ -0,0 +1,45 @@
+ALTER TABLE workflow_runs RENAME COLUMN error TO legacy_error;
+ALTER TABLE workflow_runs ADD COLUMN error TEXT CHECK (error IS NULL OR json_valid(error));
+
+UPDATE workflow_runs
+SET error = json_object(
+  'code', CASE WHEN status = 'cancelled' THEN 'runtime.cancelled' ELSE 'internal.unexpected' END,
+  'message', CASE
+    WHEN status = 'cancelled' THEN 'Execution was cancelled.'
+    ELSE 'An unexpected internal error occurred.'
+  END,
+  'retryable', json('false'),
+  'at', COALESCE(finished_at, started_at),
+  'details', json_object(
+    'workflowId', workflow_id,
+    'workflowRunId', id,
+    'migratedFromLegacyError', json('true')
+  )
+)
+WHERE legacy_error IS NOT NULL;
+
+ALTER TABLE workflow_runs DROP COLUMN legacy_error;
+
+ALTER TABLE workflow_node_runs RENAME COLUMN error TO legacy_error;
+ALTER TABLE workflow_node_runs ADD COLUMN error TEXT CHECK (error IS NULL OR json_valid(error));
+
+UPDATE workflow_node_runs
+SET error = json_object(
+  'code', CASE WHEN status = 'cancelled' THEN 'runtime.cancelled' ELSE 'internal.unexpected' END,
+  'message', CASE
+    WHEN status = 'cancelled' THEN 'Execution was cancelled.'
+    ELSE 'An unexpected internal error occurred.'
+  END,
+  'retryable', json('false'),
+  'at', COALESCE(finished_at, started_at),
+  'details', json_object(
+    'workflowId', workflow_id,
+    'workflowRunId', workflow_run_id,
+    'nodeId', node_id,
+    'nodeRunId', id,
+    'migratedFromLegacyError', json('true')
+  )
+)
+WHERE legacy_error IS NOT NULL;
+
+ALTER TABLE workflow_node_runs DROP COLUMN legacy_error;

package/src/migrations/014-agent-failure-record.sql

@@ -0,0 +1,59 @@
+ALTER TABLE agent_runs RENAME COLUMN error TO legacy_error;
+ALTER TABLE agent_runs ADD COLUMN error TEXT CHECK (error IS NULL OR json_valid(error));
+
+UPDATE agent_runs
+SET error = json_object(
+  'code', CASE WHEN status = 'cancelled' THEN 'runtime.cancelled' ELSE 'internal.unexpected' END,
+  'message', CASE
+    WHEN status = 'cancelled' THEN 'Execution was cancelled.'
+    ELSE 'An unexpected internal error occurred.'
+  END,
+  'retryable', json('false'),
+  'at', COALESCE(completed_at, started_at, created_at),
+  'details', json_object(
+    'agentId', agent_id,
+    'runId', id,
+    'threadId', thread_id,
+    'migratedFromLegacyError', json('true')
+  )
+)
+WHERE legacy_error IS NOT NULL;
+
+ALTER TABLE agent_runs DROP COLUMN legacy_error;
+
+ALTER TABLE workflow_agent_node_runs RENAME COLUMN error TO legacy_error;
+ALTER TABLE workflow_agent_node_runs ADD COLUMN error TEXT CHECK (error IS NULL OR json_valid(error));
+
+UPDATE workflow_agent_node_runs
+SET error = json_object(
+  'code', CASE WHEN status = 'cancelled' THEN 'runtime.cancelled' ELSE 'internal.unexpected' END,
+  'message', CASE
+    WHEN status = 'cancelled' THEN 'Execution was cancelled.'
+    ELSE 'An unexpected internal error occurred.'
+  END,
+  'retryable', json('false'),
+  'at', COALESCE(completed_at, started_at, created_at),
+  'details', json_object(
+    'agentId', agent_id,
+    'workflowId', (
+      SELECT workflow_id FROM workflow_node_runs AS node
+      WHERE node.project_id = workflow_agent_node_runs.project_id
+        AND node.id = workflow_agent_node_runs.node_run_id
+    ),
+    'workflowRunId', (
+      SELECT workflow_run_id FROM workflow_node_runs AS node
+      WHERE node.project_id = workflow_agent_node_runs.project_id
+        AND node.id = workflow_agent_node_runs.node_run_id
+    ),
+    'nodeId', (
+      SELECT node_id FROM workflow_node_runs AS node
+      WHERE node.project_id = workflow_agent_node_runs.project_id
+        AND node.id = workflow_agent_node_runs.node_run_id
+    ),
+    'nodeRunId', node_run_id,
+    'migratedFromLegacyError', json('true')
+  )
+)
+WHERE legacy_error IS NOT NULL;
+
+ALTER TABLE workflow_agent_node_runs DROP COLUMN legacy_error;

package/src/migrations/015-projection-failure-record.sql

@@ -0,0 +1,20 @@
+ALTER TABLE projection_runs ADD COLUMN error TEXT CHECK (error IS NULL OR json_valid(error));
+
+UPDATE projection_runs
+SET error = json_object(
+  'code', CASE WHEN status = 'cancelled' THEN 'runtime.cancelled' ELSE 'internal.unexpected' END,
+  'message', CASE
+    WHEN status = 'cancelled' THEN 'Execution was cancelled.'
+    ELSE 'An unexpected internal error occurred.'
+  END,
+  'retryable', json('false'),
+  'at', COALESCE(finished_at, started_at),
+  'details', json_object(
+    'projectionId', projection_id,
+    'runId', id,
+    'migratedFromLegacyError', json('true')
+  )
+)
+WHERE error_message IS NOT NULL;
+
+ALTER TABLE projection_runs DROP COLUMN error_message;

package/src/migrations/016-webhook-run-failure-record.sql

@@ -0,0 +1,19 @@
+ALTER TABLE webhook_runs RENAME COLUMN error TO legacy_error;
+ALTER TABLE webhook_runs ADD COLUMN error TEXT CHECK (error IS NULL OR json_valid(error));
+
+UPDATE webhook_runs
+SET error = json_object(
+  'code', 'internal.unexpected',
+  'message', 'An unexpected internal error occurred.',
+  'retryable', json('false'),
+  'at', COALESCE(finished_at, started_at),
+  'details', json_object(
+    'connectorId', connector_id,
+    'webhookId', webhook_id,
+    'runId', id,
+    'migratedFromLegacyError', json('true')
+  )
+)
+WHERE legacy_error IS NOT NULL;
+
+ALTER TABLE webhook_runs DROP COLUMN legacy_error;

package/src/migrations/017-action-failure-record.sql

@@ -0,0 +1,65 @@
+ALTER TABLE action_runs ADD COLUMN writeback_error TEXT
+  CHECK (writeback_error IS NULL OR json_valid(writeback_error));
+ALTER TABLE action_runs ADD COLUMN effects_error TEXT
+  CHECK (effects_error IS NULL OR json_valid(effects_error));
+ALTER TABLE action_runs ADD COLUMN error TEXT CHECK (error IS NULL OR json_valid(error));
+
+UPDATE action_runs
+SET writeback_error = json_object(
+  'code', 'internal.unexpected',
+  'message', 'An unexpected internal error occurred.',
+  'retryable', json('false'),
+  'at', COALESCE(writeback_completed_at, finished_at, queued_at),
+  'details', json_object(
+    'actionId', action_id,
+    'runId', id,
+    'phase', 'writeback'
+  )
+)
+WHERE writeback_error_name IS NOT NULL OR writeback_error_message IS NOT NULL;
+
+UPDATE action_runs
+SET effects_error = json_object(
+  'code', 'internal.unexpected',
+  'message', 'An unexpected internal error occurred.',
+  'retryable', json('false'),
+  'at', COALESCE(effects_completed_at, finished_at, queued_at),
+  'details', json_object(
+    'actionId', action_id,
+    'runId', id,
+    'phase', 'effects'
+  )
+)
+WHERE effects_error_name IS NOT NULL OR effects_error_message IS NOT NULL;
+
+UPDATE action_runs
+SET error = json_object(
+  'code', CASE
+    WHEN error_phase = 'enqueue' THEN 'queue.enqueue_failed'
+    WHEN error_phase = 'cancelled' OR status = 'cancelled' THEN 'runtime.cancelled'
+    ELSE 'internal.unexpected'
+  END,
+  'message', CASE
+    WHEN error_phase = 'enqueue' THEN 'The job could not be enqueued.'
+    WHEN error_phase = 'cancelled' OR status = 'cancelled' THEN 'Execution was cancelled.'
+    ELSE 'An unexpected internal error occurred.'
+  END,
+  'retryable', json(CASE WHEN error_phase = 'enqueue' THEN 'true' ELSE 'false' END),
+  'at', COALESCE(finished_at, queued_at),
+  'details', json_object(
+    'actionId', action_id,
+    'runId', id,
+    'phase', COALESCE(error_phase, phase, 'request')
+  )
+)
+WHERE error_name IS NOT NULL OR error_message IS NOT NULL;
+
+ALTER TABLE action_runs DROP COLUMN writeback_error_name;
+ALTER TABLE action_runs DROP COLUMN writeback_error_message;
+ALTER TABLE action_runs DROP COLUMN writeback_error_phase;
+ALTER TABLE action_runs DROP COLUMN effects_error_name;
+ALTER TABLE action_runs DROP COLUMN effects_error_message;
+ALTER TABLE action_runs DROP COLUMN effects_error_phase;
+ALTER TABLE action_runs DROP COLUMN error_name;
+ALTER TABLE action_runs DROP COLUMN error_message;
+ALTER TABLE action_runs DROP COLUMN error_phase;