n8n/docs/generated/sqlite-schema/agent_session_lease.md
Robin Braumann 04805d2203
feat(core): Add agent session lease table (no-changelog)
Add the agent_session_lease table with one row for each agent session.
A turn will take the lease in the transaction that records its execution,
so that only one turn runs on a session at a time.

The row keeps its epoch after release and after session deletion, so the
epoch of a thread ID only increases.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
2026-09-23 11:56:07 +02:00

2.6 KiB
Generated

agent_session_lease

Description

Table Definition
CREATE TABLE "agent_session_lease" ("threadId" varchar(128) PRIMARY KEY NOT NULL, "agentId" varchar(36) NOT NULL, "ownerToken" varchar, "ownerHostId" varchar(255), "epoch" integer NOT NULL DEFAULT (0), "executionId" varchar(36), "expiresAt" datetime(3), "createdAt" datetime(3) NOT NULL DEFAULT (STRFTIME('%Y-%m-%d %H:%M:%f', 'NOW')), "updatedAt" datetime(3) NOT NULL DEFAULT (STRFTIME('%Y-%m-%d %H:%M:%f', 'NOW')), CONSTRAINT "FK_d638dff52c334190c7407c22d9b" FOREIGN KEY ("agentId") REFERENCES "agents" ("id") ON DELETE CASCADE)

Columns

Name Type Default Nullable Children Parents Comment
agentId varchar(36) false agents
createdAt datetime(3) STRFTIME('%Y-%m-%d %H:%M:%f', 'NOW') false
epoch INTEGER 0 false
executionId varchar(36) true
expiresAt datetime(3) true
ownerHostId varchar(255) true
ownerToken varchar true
threadId varchar(128) false
updatedAt datetime(3) STRFTIME('%Y-%m-%d %H:%M:%f', 'NOW') false

Constraints

Name Type Definition
- (Foreign key ID: 0) FOREIGN KEY FOREIGN KEY (agentId) REFERENCES agents (id) ON UPDATE NO ACTION ON DELETE CASCADE MATCH NONE
sqlite_autoindex_agent_session_lease_1 PRIMARY KEY PRIMARY KEY (threadId)
threadId PRIMARY KEY PRIMARY KEY (threadId)

Indexes

Name Definition
IDX_d638dff52c334190c7407c22d9 CREATE INDEX "IDX_d638dff52c334190c7407c22d9" ON "agent_session_lease" ("agentId")
sqlite_autoindex_agent_session_lease_1 PRIMARY KEY (threadId)

Relations

erDiagram

"agent_session_lease" }o--|| "agents" : "FOREIGN KEY (agentId) REFERENCES agents (id) ON UPDATE NO ACTION ON DELETE CASCADE MATCH NONE"

"agent_session_lease" {
  varchar_36_ agentId FK
  datetime_3_ createdAt
  INTEGER epoch
  varchar_36_ executionId
  datetime_3_ expiresAt
  varchar_255_ ownerHostId
  varchar ownerToken
  varchar_128_ threadId PK
  datetime_3_ updatedAt
}
"agents" {
  varchar_36_ activeVersionId FK
  boolean availableInMCP
  datetime_3_ createdAt
  varchar_36_ id PK
  TEXT integrations
  varchar_128_ name
  varchar_255_ projectId FK
  INTEGER revision
  TEXT schema
  datetime_3_ setupCompletedAt
  TEXT skills
  TEXT tools
  datetime_3_ updatedAt
  varchar_36_ versionId
}

Generated by tbls