mirror of
https://github.com/n8n-io/n8n.git
synced 2026-07-27 19:15:01 +02:00
865142f5da
Co-authored-by: Danny Martini <danny@n8n.io> Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
85 lines
3.8 KiB
Markdown
85 lines
3.8 KiB
Markdown
# public.instance_ai_checkpoints
|
|
|
|
## Columns
|
|
|
|
| Name | Type | Default | Nullable | Children | Parents | Comment |
|
|
| ---- | ---- | ------- | -------- | -------- | ------- | ------- |
|
|
| createdAt | timestamp(3) with time zone | CURRENT_TIMESTAMP(3) | false | | | |
|
|
| expiredAt | timestamp(3) with time zone | | true | | | Soft-delete timestamp: null means live; non-null marks the row as a tombstone. |
|
|
| hostRunId | varchar(64) | | true | | | Host (Instance AI) run id; distinct from the agent-SDK runId parsed from the checkpoint key. |
|
|
| key | varchar(255) | | false | [public.instance_ai_pending_confirmations](public.instance_ai_pending_confirmations.md) | | Opaque checkpoint key from the agent runtime. |
|
|
| resourceId | varchar(255) | | true | | | Resource ID recorded by the agent runtime. |
|
|
| runId | varchar(255) | | true | | | Run ID parsed from the checkpoint key when available. |
|
|
| state | json | | true | | | Serializable agent state snapshot stored as JSON. |
|
|
| threadId | uuid | | false | | [public.instance_ai_threads](public.instance_ai_threads.md) | Instance AI thread that owns the checkpoint. |
|
|
| updatedAt | timestamp(3) with time zone | CURRENT_TIMESTAMP(3) | false | | | |
|
|
|
|
## Constraints
|
|
|
|
| Name | Type | Definition |
|
|
| ---- | ---- | ---------- |
|
|
| FK_2b23f3f24a70bebb990203b011e | FOREIGN KEY | FOREIGN KEY ("threadId") REFERENCES instance_ai_threads(id) ON DELETE CASCADE |
|
|
| PK_5315a45f0846d1f9d128c18a2ed | PRIMARY KEY | PRIMARY KEY (key) |
|
|
| instance_ai_checkpoints_createdAt_not_null | n | NOT NULL "createdAt" |
|
|
| instance_ai_checkpoints_key_not_null | n | NOT NULL key |
|
|
| instance_ai_checkpoints_state_tombstone_check | CHECK | CHECK (((("expiredAt" IS NOT NULL) AND (state IS NULL)) OR ("expiredAt" IS NULL))) |
|
|
| instance_ai_checkpoints_threadId_not_null | n | NOT NULL "threadId" |
|
|
| instance_ai_checkpoints_updatedAt_not_null | n | NOT NULL "updatedAt" |
|
|
|
|
## Indexes
|
|
|
|
| Name | Definition |
|
|
| ---- | ---------- |
|
|
| IDX_2b23f3f24a70bebb990203b011 | CREATE INDEX "IDX_2b23f3f24a70bebb990203b011" ON public.instance_ai_checkpoints USING btree ("threadId") |
|
|
| IDX_768189b506cc26c4fe878b87cb | CREATE INDEX "IDX_768189b506cc26c4fe878b87cb" ON public.instance_ai_checkpoints USING btree ("runId") |
|
|
| IDX_be9d0eca0b19fb93d4eb74b327 | CREATE INDEX "IDX_be9d0eca0b19fb93d4eb74b327" ON public.instance_ai_checkpoints USING btree ("resourceId") |
|
|
| PK_5315a45f0846d1f9d128c18a2ed | CREATE UNIQUE INDEX "PK_5315a45f0846d1f9d128c18a2ed" ON public.instance_ai_checkpoints USING btree (key) |
|
|
|
|
## Relations
|
|
|
|
```mermaid
|
|
erDiagram
|
|
|
|
"public.instance_ai_pending_confirmations" }o--o| "public.instance_ai_checkpoints" : "FOREIGN KEY (#quot;checkpointKey#quot;) REFERENCES instance_ai_checkpoints(key) ON DELETE CASCADE"
|
|
"public.instance_ai_checkpoints" }o--|| "public.instance_ai_threads" : "FOREIGN KEY (#quot;threadId#quot;) REFERENCES instance_ai_threads(id) ON DELETE CASCADE"
|
|
|
|
"public.instance_ai_checkpoints" {
|
|
timestamp_3__with_time_zone createdAt
|
|
timestamp_3__with_time_zone expiredAt
|
|
varchar_64_ hostRunId
|
|
varchar_255_ key
|
|
varchar_255_ resourceId
|
|
varchar_255_ runId
|
|
json state
|
|
uuid threadId FK
|
|
timestamp_3__with_time_zone updatedAt
|
|
}
|
|
"public.instance_ai_pending_confirmations" {
|
|
varchar_255_ checkpointKey FK
|
|
varchar_36_ checkpointTaskId
|
|
timestamp_3__with_time_zone createdAt
|
|
timestamp_3__with_time_zone expiresAt
|
|
varchar_16_ kind
|
|
varchar_36_ messageGroupId
|
|
varchar_36_ requestId
|
|
varchar_36_ runId
|
|
uuid threadId FK
|
|
varchar_64_ toolCallId
|
|
timestamp_3__with_time_zone updatedAt
|
|
uuid userId FK
|
|
}
|
|
"public.instance_ai_threads" {
|
|
timestamp_3__with_time_zone createdAt
|
|
uuid id
|
|
json metadata
|
|
varchar_36_ projectId FK
|
|
varchar_255_ resourceId
|
|
text title
|
|
timestamp_3__with_time_zone updatedAt
|
|
}
|
|
```
|
|
|
|
---
|
|
|
|
> Generated by [tbls](https://github.com/k1LoW/tbls)
|