Skip to content

The open-source agent harness - the runtime layer that turns an LLM into a working agent.

feat: add created_by_subject in db in place of created_by (#568)

Sujai Kumar Gupta9bfcdaa90a3b
diff --git a/.changeset/created-by-subject-json.md b/.changeset/created-by-subject-json.md
new file mode 100644
index 000000000..8b6fcda62
--- /dev/null
+++ b/.changeset/created-by-subject-json.md
@@ -0,0 +1,6 @@
+---
+'@truefoundry/trueforge-core': major
+'@truefoundry/trueforge': major
+---
+
+Replace string creator fields (`created_by` / `triggered_by`) with a non-null `created_by_subject` JSON object on agent, session, schedule, and schedule_run. Ownership and list filters use `tenant_id` + `created_by_subject.subject_id`.
diff --git a/.github/fern/openapi/openapi.json b/.github/fern/openapi/openapi.json
index 9852ea08a..b694ef13f 100644
--- a/.github/fern/openapi/openapi.json
+++ b/.github/fern/openapi/openapi.json
@@ -26,6 +26,9 @@
"Agent": {
"additionalProperties": false,
"properties": {
+ "created_by_subject": {
+ "$ref": "#/components/schemas/CreatedBySubject"
+ },
"id": {
"description": "Immutable server-generated agent identifier.",
"minLength": 1,
@@ -41,7 +44,8 @@
"required": [
"id",
"name",
- "manifest"
+ "manifest",
+ "created_by_subject"
],
"type": "object"
},
@@ -1102,6 +1106,33 @@
},
"type": "object"
},
+ "CreatedBySubject": {
+ "additionalProperties": false,
+ "description": "Who created this resource.",
+ "properties": {
+ "subject_display_name": {
+ "description": "Display name.",
+ "minLength": 1,
+ "type": "string"
+ },
+ "subject_id": {
+ "description": "Subject id.",
+ "minLength": 1,
+ "type": "string"
+ },
+ "subject_type": {
+ "description": "Subject type.",
+ "minLength": 1,
+ "type": "string"
+ }
+ },
+ "required": [
+ "subject_id",
+ "subject_type",
+ "subject_display_name"
+ ],
+ "type": "object"
+ },
"CronExpression": {
"description": "Standard 5-field cron expression, evaluated in `timezone`.",
"pattern": "^[\\d*,\\-/]+(?:\\s+[\\d*,\\-/]+){4}$",
@@ -3114,8 +3145,8 @@
"format": "date-time",
"type": "string"
},
- "created_by": {
- "type": "string"
+ "created_by_subject": {
+ "$ref": "#/components/schemas/CreatedBySubject"
},
"id": {
"type": "string"
@@ -3136,7 +3167,7 @@
"agent_name",
"name",
"manifest",
- "created_by",
+ "created_by_subject",
"created_at",
"updated_at"
],
@@ -3173,6 +3204,9 @@
"format": "date-time",
"type": "string"
},
+ "created_by_subject": {
+ "$ref": "#/components/schemas/CreatedBySubject"
+ },
"id": {
"type": "string"
},
@@ -3196,9 +3230,6 @@
"null"
]
},
- "triggered_by": {
- "type": "string"
- },
"updated_at": {
"format": "date-time",
"type": "string"
@@ -3210,7 +3241,7 @@
"name",
"scheduled_for",
"status",
- "triggered_by",
+ "created_by_subject",
"triggered_at",
"created_at",
"updated_at"
@@ -3242,9 +3273,8 @@
"description": "ISO 8601 creation timestamp.",
"type": "string"
},
- "created_by": {
- "description": "Caller identity that created the session (immutable).",
- "type": "string"
+ "created_by_subject": {
+ "$ref": "#/components/schemas/CreatedBySubject"
},
"id": {
"description": "Unique session id.",
@@ -3272,7 +3302,7 @@
"id",
"agent",
"title",
- "created_by",
+ "created_by_subject",
"created_at",
"updated_at",
"metrics",
@@ -6713,7 +6743,7 @@
},
"/api/v1/sessions": {
"get": {
- "description": "List the caller's sessions (newest first by default), token-paginated. Results are scoped to the authenticated identity via the session store's `created_by` filter (not a client query param). Optional `agent_id` filters to sessions bound to that named agent. Pass `page_token` to fetch the next page, keeping the other query params constant.",
+ "description": "List the caller's sessions (newest first by default), token-paginated. Results are scoped to the authenticated identity via the session store's `created_by_subject.subject_id` filter (not a client query param). Optional `agent_id` filters to sessions bound to that named agent. Pass `page_token` to fetch the next page, keeping the other query params constant.",
"parameters": [
{
"description": "Page size. Defaults to 25, max 25.",
@@ -6884,7 +6914,7 @@
},
"/api/v1/sessions/{session_id}": {
"delete": {
- "description": "Delete a session and all related turns, events, and internal state. Only the session creator (`created_by`) may delete it. Idempotent if already gone.",
+ "description": "Delete a session and all related turns, events, and internal state. Only the session creator may delete it. Idempotent if already gone.",
"parameters": [
{
"description": "Session identifier.",
@@ -6924,7 +6954,7 @@
"x-fern-sdk-method-name": "delete"
},
"get": {
- "description": "Fetch a session by ID. Only the session creator (`created_by`) may fetch it.",
+ "description": "Fetch a session by ID. Only the session creator may fetch it.",
"parameters": [
{
"description": "Session identifier.",
@@ -6981,7 +7011,7 @@
"x-fern-sdk-method-name": "get"
},
"patch": {
- "description": "Update a session by replacing `agent` with `{ spec: AgentSpec }`. Named (reference) sessions reject agent updates. An empty body is a valid no-op that refreshes `updated_at`. Only the session creator (`created_by`) may update it.",
+ "description": "Update a session by replacing `agent` with `{ spec: AgentSpec }`. Named (reference) sessions reject agent updates. An empty body is a valid no-op that refreshes `updated_at`. Only the session creator may update it.",
"parameters": [
{
"description": "Session identifier.",
@@ -7070,7 +7100,7 @@
},
"/api/v1/sessions/{session_id}/cancel": {
"post": {
- "description": "Cancel the running last turn for a session. Only the session creator (`created_by`) may cancel.",
+ "description": "Cancel the running last turn for a session. Only the session creator may cancel.",
"parameters": [
{
"description": "Session identifier.",
@@ -7149,7 +7179,7 @@
},
"/api/v1/sessions/{session_id}/events": {
"get": {
- "description": "List session events as `{ turn_id, event }` across the active turn branch (newest first), including persisted events from a running tip. Each turn contributes turn.created, content events (model.message, tool.call, …), and turn.done when terminal; streaming deltas are not included. Use `page_token` to paginate backward toward older events while retaining the original branch anchor. Only the session creator (`created_by`) may list events.",
+ "description": "List session events as `{ turn_id, event }` across the active turn branch (newest first), including persisted events from a running tip. Each turn contributes turn.created, content events (model.message, tool.call, …), and turn.done when terminal; streaming deltas are not included. Use `page_token` to paginate backward toward older events while retaining the original branch anchor. Only the session creator may list events.",
"parameters": [
{
"description": "Session identifier.",
@@ -7256,7 +7286,7 @@
},
"/api/v1/sessions/{session_id}/turns": {
"get": {
- "description": "List turns for a session (newest first by default), token-paginated. Only the session creator (`created_by`) may list turns.",
+ "description": "List turns for a session (newest first by default), token-paginated. Only the session creator may list turns.",
"parameters": [
{
"description": "Session identifier.",
@@ -7351,7 +7381,7 @@
"x-fern-sdk-method-name": "list_turns"
},
"post": {
- "description": "Create a turn within a session and execute it.\nOnly the session creator (`created_by`) may create turns.\nWhen `stream` is true (default), respond with a Server-Sent Events stream of turn events.\nWhen `stream` is false, return the turn immediately with `state.status: \"running\"` while execution continues in the background; use get turn or subscribe to observe completion.\nUse `previous_turn_id` to chain to the session's last turn (defaults to `auto`); use `none` for a new root.",
+ "description": "Create a turn within a session and execute it.\nOnly the session creator may create turns.\nWhen `stream` is true (default), respond with a Server-Sent Events stream of turn events.\nWhen `stream` is false, return the turn immediately with `state.status: \"running\"` while execution continues in the background; use get turn or subscribe to observe completion.\nUse `previous_turn_id` to chain to the session's last turn (defaults to `auto`); use `none` for a new root.",
"parameters": [
{
"description": "Session identifier.",
@@ -7486,7 +7516,7 @@
},
"/api/v1/sessions/{session_id}/turns/{turn_id}": {
"get": {
- "description": "Fetch a single turn by ID. Only the session creator (`created_by`) may fetch it.",
+ "description": "Fetch a single turn by ID. Only the session creator may fetch it.",
"parameters": [
{
"description": "Session identifier.",
@@ -7556,7 +7586,7 @@
},
"/api/v1/sessions/{session_id}/turns/{turn_id}/download-sandbox-file": {
"get": {
- "description": "Download a file from the sandbox this turn ran in. Paths come from the assistant's `sandbox_artifacts` block. Only the session creator (`created_by`) may download.",
+ "description": "Download a file from the sandbox this turn ran in. Paths come from the assistant's `sandbox_artifacts` block. Only the session creator may download.",
"parameters": [
{
"description": "Session identifier.",
@@ -7688,7 +7718,7 @@
},
"/api/v1/sessions/{session_id}/turns/{turn_id}/events": {
"get": {
- "description": "Paginated persisted events for a turn (insertion order by default). Only the session creator (`created_by`) may list events.",
+ "description": "Paginated persisted events for a turn (insertion order by default). Only the session creator may list events.",
"parameters": [
{
"description": "Session identifier.",
@@ -7805,7 +7835,7 @@
},
"/api/v1/sessions/{session_id}/turns/{turn_id}/subscribe": {
"get": {
- "description": "Subscribe to the live SSE stream for a turn. Only the session creator (`created_by`) may subscribe. Pass `after_sequence_number` to resume after a disconnect (exclusive — events after this sequence number are replayed).",
+ "description": "Subscribe to the live SSE stream for a turn. Only the session creator may subscribe. Pass `after_sequence_number` to resume after a disconnect (exclusive — events after this sequence number are replayed).",
"parameters": [
{
"description": "Session identifier.",
diff --git a/docs/openapi.json b/docs/openapi.json
index 9852ea08a..b694ef13f 100644
--- a/docs/openapi.json
+++ b/docs/openapi.json
@@ -26,6 +26,9 @@
"Agent": {
"additionalProperties": false,
"properties": {
+ "created_by_subject": {
+ "$ref": "#/components/schemas/CreatedBySubject"
+ },
"id": {
"description": "Immutable server-generated agent identifier.",
"minLength": 1,
@@ -41,7 +44,8 @@
"required": [
"id",
"name",
- "manifest"
+ "manifest",
+ "created_by_subject"
],
"type": "object"
},
@@ -1102,6 +1106,33 @@
},
"type": "object"
},
+ "CreatedBySubject": {
+ "additionalProperties": false,
+ "description": "Who created this resource.",
+ "properties": {
+ "subject_display_name": {
+ "description": "Display name.",
+ "minLength": 1,
+ "type": "string"
+ },
+ "subject_id": {
+ "description": "Subject id.",
+ "minLength": 1,
+ "type": "string"
+ },
+ "subject_type": {
+ "description": "Subject type.",
+ "minLength": 1,
+ "type": "string"
+ }
+ },
+ "required": [
+ "subject_id",
+ "subject_type",
+ "subject_display_name"
+ ],
+ "type": "object"
+ },
"CronExpression": {
"description": "Standard 5-field cron expression, evaluated in `timezone`.",
"pattern": "^[\\d*,\\-/]+(?:\\s+[\\d*,\\-/]+){4}$",
@@ -3114,8 +3145,8 @@
"format": "date-time",
"type": "string"
},
- "created_by": {
- "type": "string"
+ "created_by_subject": {
+ "$ref": "#/components/schemas/CreatedBySubject"
},
"id": {
"type": "string"
@@ -3136,7 +3167,7 @@
"agent_name",
"name",
"manifest",
- "created_by",
+ "created_by_subject",
"created_at",
"updated_at"
],
@@ -3173,6 +3204,9 @@
"format": "date-time",
"type": "string"
},
+ "created_by_subject": {
+ "$ref": "#/components/schemas/CreatedBySubject"
+ },
"id": {
"type": "string"
},
@@ -3196,9 +3230,6 @@
"null"
]
},
- "triggered_by": {
- "type": "string"
- },
"updated_at": {
"format": "date-time",
"type": "string"
@@ -3210,7 +3241,7 @@
"name",
"scheduled_for",
"status",
- "triggered_by",
+ "created_by_subject",
"triggered_at",
"created_at",
"updated_at"
@@ -3242,9 +3273,8 @@
"description": "ISO 8601 creation timestamp.",
"type": "string"
},
- "created_by": {
- "description": "Caller identity that created the session (immutable).",
- "type": "string"
+ "created_by_subject": {
+ "$ref": "#/components/schemas/CreatedBySubject"
},
"id": {
"description": "Unique session id.",
@@ -3272,7 +3302,7 @@
"id",
"agent",
"title",
- "created_by",
+ "created_by_subject",
"created_at",
"updated_at",
"metrics",
@@ -6713,7 +6743,7 @@
},
"/api/v1/sessions": {
"get": {
- "description": "List the caller's sessions (newest first by default), token-paginated. Results are scoped to the authenticated identity via the session store's `created_by` filter (not a client query param). Optional `agent_id` filters to sessions bound to that named agent. Pass `page_token` to fetch the next page, keeping the other query params constant.",
+ "description": "List the caller's sessions (newest first by default), token-paginated. Results are scoped to the authenticated identity via the session store's `created_by_subject.subject_id` filter (not a client query param). Optional `agent_id` filters to sessions bound to that named agent. Pass `page_token` to fetch the next page, keeping the other query params constant.",
"parameters": [
{
"description": "Page size. Defaults to 25, max 25.",
@@ -6884,7 +6914,7 @@
},
"/api/v1/sessions/{session_id}": {
"delete": {
- "description": "Delete a session and all related turns, events, and internal state. Only the session creator (`created_by`) may delete it. Idempotent if already gone.",
+ "description": "Delete a session and all related turns, events, and internal state. Only the session creator may delete it. Idempotent if already gone.",
"parameters": [
{
"description": "Session identifier.",
@@ -6924,7 +6954,7 @@
"x-fern-sdk-method-name": "delete"
},
"get": {
- "description": "Fetch a session by ID. Only the session creator (`created_by`) may fetch it.",
+ "description": "Fetch a session by ID. Only the session creator may fetch it.",
"parameters": [
{
"description": "Session identifier.",
@@ -6981,7 +7011,7 @@
"x-fern-sdk-method-name": "get"
},
"patch": {
- "description": "Update a session by replacing `agent` with `{ spec: AgentSpec }`. Named (reference) sessions reject agent updates. An empty body is a valid no-op that refreshes `updated_at`. Only the session creator (`created_by`) may update it.",
+ "description": "Update a session by replacing `agent` with `{ spec: AgentSpec }`. Named (reference) sessions reject agent updates. An empty body is a valid no-op that refreshes `updated_at`. Only the session creator may update it.",
"parameters": [
{
"description": "Session identifier.",
@@ -7070,7 +7100,7 @@
},
"/api/v1/sessions/{session_id}/cancel": {
"post": {
- "description": "Cancel the running last turn for a session. Only the session creator (`created_by`) may cancel.",
+ "description": "Cancel the running last turn for a session. Only the session creator may cancel.",
"parameters": [
{
"description": "Session identifier.",
@@ -7149,7 +7179,7 @@
},
"/api/v1/sessions/{session_id}/events": {
"get": {
- "description": "List session events as `{ turn_id, event }` across the active turn branch (newest first), including persisted events from a running tip. Each turn contributes turn.created, content events (model.message, tool.call, …), and turn.done when terminal; streaming deltas are not included. Use `page_token` to paginate backward toward older events while retaining the original branch anchor. Only the session creator (`created_by`) may list events.",
+ "description": "List session events as `{ turn_id, event }` across the active turn branch (newest first), including persisted events from a running tip. Each turn contributes turn.created, content events (model.message, tool.call, …), and turn.done when terminal; streaming deltas are not included. Use `page_token` to paginate backward toward older events while retaining the original branch anchor. Only the session creator may list events.",
"parameters": [
{
"description": "Session identifier.",
@@ -7256,7 +7286,7 @@
},
"/api/v1/sessions/{session_id}/turns": {
"get": {
- "description": "List turns for a session (newest first by default), token-paginated. Only the session creator (`created_by`) may list turns.",
+ "description": "List turns for a session (newest first by default), token-paginated. Only the session creator may list turns.",
"parameters": [
{
"description": "Session identifier.",
@@ -7351,7 +7381,7 @@
"x-fern-sdk-method-name": "list_turns"
},
"post": {
- "description": "Create a turn within a session and execute it.\nOnly the session creator (`created_by`) may create turns.\nWhen `stream` is true (default), respond with a Server-Sent Events stream of turn events.\nWhen `stream` is false, return the turn immediately with `state.status: \"running\"` while execution continues in the background; use get turn or subscribe to observe completion.\nUse `previous_turn_id` to chain to the session's last turn (defaults to `auto`); use `none` for a new root.",
+ "description": "Create a turn within a session and execute it.\nOnly the session creator may create turns.\nWhen `stream` is true (default), respond with a Server-Sent Events stream of turn events.\nWhen `stream` is false, return the turn immediately with `state.status: \"running\"` while execution continues in the background; use get turn or subscribe to observe completion.\nUse `previous_turn_id` to chain to the session's last turn (defaults to `auto`); use `none` for a new root.",
"parameters": [
{
"description": "Session identifier.",
@@ -7486,7 +7516,7 @@
},
"/api/v1/sessions/{session_id}/turns/{turn_id}": {
"get": {
- "description": "Fetch a single turn by ID. Only the session creator (`created_by`) may fetch it.",
+ "description": "Fetch a single turn by ID. Only the session creator may fetch it.",
"parameters": [
{
"description": "Session identifier.",
@@ -7556,7 +7586,7 @@
},
"/api/v1/sessions/{session_id}/turns/{turn_id}/download-sandbox-file": {
"get": {
- "description": "Download a file from the sandbox this turn ran in. Paths come from the assistant's `sandbox_artifacts` block. Only the session creator (`created_by`) may download.",
+ "description": "Download a file from the sandbox this turn ran in. Paths come from the assistant's `sandbox_artifacts` block. Only the session creator may download.",
"parameters": [
{
"description": "Session identifier.",
@@ -7688,7 +7718,7 @@
},
"/api/v1/sessions/{session_id}/turns/{turn_id}/events": {
"get": {
- "description": "Paginated persisted events for a turn (insertion order by default). Only the session creator (`created_by`) may list events.",
+ "description": "Paginated persisted events for a turn (insertion order by default). Only the session creator may list events.",
"parameters": [
{
"description": "Session identifier.",
@@ -7805,7 +7835,7 @@
},
"/api/v1/sessions/{session_id}/turns/{turn_id}/subscribe": {
"get": {
- "description": "Subscribe to the live SSE stream for a turn. Only the session creator (`created_by`) may subscribe. Pass `after_sequence_number` to resume after a disconnect (exclusive — events after this sequence number are replayed).",
+ "description": "Subscribe to the live SSE stream for a turn. Only the session creator may subscribe. Pass `after_sequence_number` to resume after a disconnect (exclusive — events after this sequence number are replayed).",
"parameters": [
{
"description": "Session identifier.",
diff --git a/packages/trueforge-core/src/agent-session/index.ts b/packages/trueforge-core/src/agent-session/index.ts
index f515621c5..95a78881f 100644
--- a/packages/trueforge-core/src/agent-session/index.ts
+++ b/packages/trueforge-core/src/agent-session/index.ts
@@ -24,6 +24,9 @@ export type { TerminalTurnState, Turn, TurnInputItem, TurnMetrics, TurnState } f
export { SessionMetadataSchema, SessionMetricsSchema, SessionSchema } from './schemas/session';
export type { Session, SessionAgent, SessionMetadata, SessionMetrics } from './schemas/session';
+export { CreatedBySubjectSchema } from './schemas/subject';
+export type { CreatedBySubject } from './schemas/subject';
+
export {
EventType,
SessionEventItemSchema,
diff --git a/packages/trueforge-core/src/agent-session/models/SessionRecord.ts b/packages/trueforge-core/src/agent-session/models/SessionRecord.ts
index 0d48d08d5..28442240b 100644
--- a/packages/trueforge-core/src/agent-session/models/SessionRecord.ts
+++ b/packages/trueforge-core/src/agent-session/models/SessionRecord.ts
@@ -1,4 +1,5 @@
import type { SessionAgent, SessionMetadata, SessionMetrics } from '../schemas/session';
+import type { CreatedBySubject } from '../schemas/subject';
/**
* Session persistence record. Agent binding is a single discriminated `agent`
@@ -9,7 +10,7 @@ export interface SessionRecord<TCustom extends object = Record<string, never>> {
tenant_id: string;
session_id: string;
/** Caller identity that created the session (immutable after create). */
- created_by: string;
+ created_by_subject: CreatedBySubject;
agent: SessionAgent;
/**
* Public session title (nullable). Written via updateSession patch or createTurn's
diff --git a/packages/trueforge-core/src/agent-session/schemas/session.ts b/packages/trueforge-core/src/agent-session/schemas/session.ts
index 843736a58..e5efa4973 100644
--- a/packages/trueforge-core/src/agent-session/schemas/session.ts
+++ b/packages/trueforge-core/src/agent-session/schemas/session.ts
@@ -4,6 +4,7 @@
*/
import { z } from '@hono/zod-openapi';
import { AgentSpecSchema } from './agentSpec';
+import { CreatedBySubjectSchema } from './subject';
/** Max key length for session metadata (aligned with LLM gateway HeaderMetadata). */
const SESSION_METADATA_MAX_KEY_LENGTH = 32;
@@ -73,8 +74,7 @@ export const SessionSchema = z
id: z.string().describe('Unique session id.'),
agent: SessionAgentSchema,
title: z.string().nullable().describe('Optional human-readable title; null until set.'),
- /** Caller identity that created the session (immutable). */
- created_by: z.string().describe('Caller identity that created the session (immutable).'),
+ created_by_subject: CreatedBySubjectSchema,
created_at: z.string().describe('ISO 8601 creation timestamp.'),
updated_at: z.string().describe('ISO 8601 last-update timestamp.'),
metrics: SessionMetricsSchema,
diff --git a/packages/trueforge-core/src/agent-session/schemas/subject.ts b/packages/trueforge-core/src/agent-session/schemas/subject.ts
new file mode 100644
index 000000000..27b9df0a4
--- /dev/null
+++ b/packages/trueforge-core/src/agent-session/schemas/subject.ts
@@ -0,0 +1,14 @@
+import { z } from '@hono/zod-openapi';
+
+/** Persisted creator identity on agent, session, schedule, and schedule_run rows. */
+export const CreatedBySubjectSchema = z
+ .object({
+ subject_id: z.string().min(1).describe('Subject id.'),
+ subject_type: z.string().min(1).describe('Subject type.'),
+ subject_display_name: z.string().min(1).describe('Display name.'),
+ })
+ .strict()
+ .describe('Who created this resource.')
+ .openapi('CreatedBySubject');
+
+export type CreatedBySubject = z.infer<typeof CreatedBySubjectSchema>;
diff --git a/packages/trueforge-core/src/agent-session/store/ISessionStore.ts b/packages/trueforge-core/src/agent-session/store/ISessionStore.ts
index a19ddbcce..07ca0a7d6 100644
--- a/packages/trueforge-core/src/agent-session/store/ISessionStore.ts
+++ b/packages/trueforge-core/src/agent-session/store/ISessionStore.ts
@@ -19,7 +19,7 @@ import type { CancellationReason, TerminalTurnState } from '../schemas/turn';
*/
export type CreateSessionInput<TSessionCustom extends object = Record<string, never>> = Pick<
SessionRecord<TSessionCustom>,
- 'tenant_id' | 'session_id' | 'agent' | 'created_by' | 'external_id' | 'metadata'
+ 'tenant_id' | 'session_id' | 'agent' | 'created_by_subject' | 'external_id' | 'metadata'
> & {
custom: TSessionCustom | null;
};
@@ -64,8 +64,8 @@ export interface ListSessionsInput {
end_timestamp: Date | undefined;
/** When set, only sessions bound to this named agent id. */
agent_id: string | undefined;
- /** When set, only sessions created by this identity. */
- created_by: string | undefined;
+ /** When set, only sessions whose `created_by_subject.subject_id` matches. */
+ created_by_subject_id: string | undefined;
}
/** Turn row fields without assembled snapshot (create input / listTurns). */
@@ -222,7 +222,7 @@ export interface ISessionStore<
/**
* Persists a discriminated `agent` (ref | value). SQL backends may flatten to columns.
* `session_id` is globally unique across tenants.
- * Persists caller-supplied `created_by` (immutable after create).
+ * Persists caller-supplied `created_by_subject` (immutable after create).
* Sets `last_activity_timestamp_ms` (= now) on create.
*/
createSession(input: CreateSessionInput<TSessionCustom>): Promise<void>;
@@ -256,8 +256,9 @@ export interface ISessionStore<
* (`order` defaults to `desc`, `session_id` tie-break). `page_token` is a
* keyset cursor on `(updated_at, session_id)`. `start_timestamp` /
* `end_timestamp` are inclusive instant bounds on `created_at`. Optional
- * `agent_id` filters ref-bound sessions; optional `created_by` filters by
- * creator identity. Does **not** bump `last_activity_timestamp_ms` (read path).
+ * `agent_id` filters ref-bound sessions; optional `created_by_subject_id`
+ * filters by `created_by_subject.subject_id`. Does **not** bump
+ * `last_activity_timestamp_ms` (read path).
*/
listSessions(
input: ListSessionsInput,
diff --git a/packages/trueforge-core/src/agent-session/store/InMemorySessionStore.ts b/packages/trueforge-core/src/agent-session/store/InMemorySessionStore.ts
index 85492b46e..484f59e34 100644
--- a/packages/trueforge-core/src/agent-session/store/InMemorySessionStore.ts
+++ b/packages/trueforge-core/src/agent-session/store/InMemorySessionStore.ts
@@ -187,7 +187,7 @@ export class InMemorySessionStore<
const record: SessionRecord<TSessionCustom> = {
tenant_id: input.tenant_id,
session_id: input.session_id,
- created_by: input.created_by,
+ created_by_subject: input.created_by_subject,
agent: deepCopy(input.agent),
title: null,
last_turn_id: null,
@@ -273,7 +273,10 @@ export class InMemorySessionStore<
) {
continue;
}
- if (input.created_by !== undefined && stored.record.created_by !== input.created_by) {
+ if (
+ input.created_by_subject_id !== undefined &&
+ stored.record.created_by_subject.subject_id !== input.created_by_subject_id
+ ) {
continue;
}
const createdAt = stored.record.created_at.getTime();
diff --git a/packages/trueforge-core/tests/agent-session/capabilityState.test.ts b/packages/trueforge-core/tests/agent-session/capabilityState.test.ts
index 5cf6d74e9..f9bc70f63 100644
--- a/packages/trueforge-core/tests/agent-session/capabilityState.test.ts
+++ b/packages/trueforge-core/tests/agent-session/capabilityState.test.ts
@@ -62,7 +62,7 @@ describe('capability_state (tfy.plan fixture)', () => {
const session = await sessions.create({
tenant_id: tenant,
session_id: 's1',
- created_by: 'user-1',
+ created_by_subject: { subject_id: 'user-1', subject_type: 'user', subject_display_name: 'user-1' },
agent: { type: 'inline', spec: makeAgentSpec() },
external_id: null,
});
@@ -135,7 +135,7 @@ describe('capability_state (tfy.plan fixture)', () => {
const session = await sessions.create({
tenant_id: tenant,
session_id: 's1',
- created_by: 'user-1',
+ created_by_subject: { subject_id: 'user-1', subject_type: 'user', subject_display_name: 'user-1' },
agent: { type: 'inline', spec: makeAgentSpec() },
external_id: null,
});
@@ -229,7 +229,7 @@ describe('capability_state (tfy.plan fixture)', () => {
const session = await sessions.create({
tenant_id: tenant,
session_id: 's1',
- created_by: 'user-1',
+ created_by_subject: { subject_id: 'user-1', subject_type: 'user', subject_display_name: 'user-1' },
agent: { type: 'inline', spec: makeAgentSpec() },
external_id: null,
});
diff --git a/packages/trueforge-core/tests/agent-session/resolveAgentSpec.test.ts b/packages/trueforge-core/tests/agent-session/resolveAgentSpec.test.ts
index b2f6399df..4747b679e 100644
--- a/packages/trueforge-core/tests/agent-session/resolveAgentSpec.test.ts
+++ b/packages/trueforge-core/tests/agent-session/resolveAgentSpec.test.ts
@@ -89,7 +89,7 @@ describe('SessionHandle.createTurn named resolve', () => {
const session = await sessions.create({
tenant_id: 'tenant-1',
session_id: 's-named',
- created_by: 'user-1',
+ created_by_subject: { subject_id: 'user-1', subject_type: 'user', subject_display_name: 'user-1' },
agent: { type: 'reference', id: 'agent-abc', name: null },
external_id: null,
});
diff --git a/packages/trueforge-core/tests/agent-session/sessions.test.ts b/packages/trueforge-core/tests/agent-session/sessions.test.ts
index 1961de7e1..39e7861be 100644
--- a/packages/trueforge-core/tests/agent-session/sessions.test.ts
+++ b/packages/trueforge-core/tests/agent-session/sessions.test.ts
@@ -15,7 +15,7 @@ describe('Sessions / SessionHandle / TurnHandle (storage + createTurn)', () => {
const created = await sessions.create({
tenant_id: tenant,
session_id: 's-meta',
- created_by: 'user-1',
+ created_by_subject: { subject_id: 'user-1', subject_type: 'user', subject_display_name: 'user-1' },
agent: { type: 'inline', spec: makeAgentSpec({ instructions: 'meta' }) },
metadata: { env: 'test' },
external_id: null,
@@ -50,7 +50,7 @@ describe('Sessions / SessionHandle / TurnHandle (storage + createTurn)', () => {
const created = await sessions.create({
tenant_id: tenant,
session_id: 's1',
- created_by: 'user-1',
+ created_by_subject: { subject_id: 'user-1', subject_type: 'user', subject_display_name: 'user-1' },
agent: { type: 'inline', spec: makeAgentSpec({ instructions: 'hydrate-me' }) },
custom: { tag: 'a' },
external_id: null,
@@ -77,7 +77,7 @@ describe('Sessions / SessionHandle / TurnHandle (storage + createTurn)', () => {
const first = await sessions.getOrCreateByExternalId({
tenant_id: tenant,
- created_by: 'user-1',
+ created_by_subject: { subject_id: 'user-1', subject_type: 'user', subject_display_name: 'user-1' },
agent,
external_id: 'run-1',
});
@@ -86,13 +86,13 @@ describe('Sessions / SessionHandle / TurnHandle (storage + createTurn)', () => {
const again = await sessions.getOrCreateByExternalId({
tenant_id: tenant,
- created_by: 'other',
+ created_by_subject: { subject_id: 'other', subject_type: 'user', subject_display_name: 'other' },
agent: { type: 'inline', spec: makeAgentSpec({ instructions: 'ignored' }) },
external_id: 'run-1',
});
expect(again.created).toBe(false);
expect(again.session.session_id).toBe(first.session.session_id);
- expect(again.session.record.created_by).toBe('user-1');
+ expect(again.session.record.created_by_subject.subject_id).toBe('user-1');
expect(again.session.agent).toEqual({
type: 'inline',
spec: expect.objectContaining({ instructions: 'first' }),
@@ -107,7 +107,7 @@ describe('Sessions / SessionHandle / TurnHandle (storage + createTurn)', () => {
await sessions.create({
tenant_id: tenant,
session_id: 'winner',
- created_by: 'user-1',
+ created_by_subject: { subject_id: 'user-1', subject_type: 'user', subject_display_name: 'user-1' },
agent,
external_id: 'run-1',
});
@@ -117,7 +117,7 @@ describe('Sessions / SessionHandle / TurnHandle (storage + createTurn)', () => {
const { session, created } = await sessions.getOrCreateByExternalId({
tenant_id: tenant,
- created_by: 'user-2',
+ created_by_subject: { subject_id: 'user-2', subject_type: 'user', subject_display_name: 'user-2' },
agent,
external_id: 'run-1',
});
@@ -131,7 +131,7 @@ describe('Sessions / SessionHandle / TurnHandle (storage + createTurn)', () => {
const session = await sessions.create({
tenant_id: tenant,
session_id: 's1',
- created_by: 'user-1',
+ created_by_subject: { subject_id: 'user-1', subject_type: 'user', subject_display_name: 'user-1' },
agent: { type: 'inline', spec: makeAgentSpec() },
external_id: null,
});
@@ -162,7 +162,7 @@ describe('Sessions / SessionHandle / TurnHandle (storage + createTurn)', () => {
const session = await sessions.create({
tenant_id: tenant,
session_id: 's1',
- created_by: 'user-1',
+ created_by_subject: { subject_id: 'user-1', subject_type: 'user', subject_display_name: 'user-1' },
agent: { type: 'inline', spec: makeAgentSpec() },
external_id: null,
});
@@ -200,7 +200,7 @@ describe('Sessions / SessionHandle / TurnHandle (storage + createTurn)', () => {
const session = await sessions.create({
tenant_id: tenant,
session_id: 's1',
- created_by: 'user-1',
+ created_by_subject: { subject_id: 'user-1', subject_type: 'user', subject_display_name: 'user-1' },
agent: { type: 'inline', spec: makeAgentSpec() },
external_id: null,
});
@@ -229,7 +229,7 @@ describe('Sessions / SessionHandle / TurnHandle (storage + createTurn)', () => {
const session = await sessions.create({
tenant_id: tenant,
session_id: 's1',
- created_by: 'user-1',
+ created_by_subject: { subject_id: 'user-1', subject_type: 'user', subject_display_name: 'user-1' },
agent: { type: 'inline', spec: makeAgentSpec() },
external_id: null,
});
@@ -260,7 +260,7 @@ describe('Sessions / SessionHandle / TurnHandle (storage + createTurn)', () => {
const session = await sessions.create({
tenant_id: tenant,
session_id: 's1',
- created_by: 'user-1',
+ created_by_subject: { subject_id: 'user-1', subject_type: 'user', subject_display_name: 'user-1' },
agent: { type: 'inline', spec: makeAgentSpec() },
external_id: null,
});
@@ -293,7 +293,7 @@ describe('Sessions / SessionHandle / TurnHandle (storage + createTurn)', () => {
const session = await sessions.create({
tenant_id: tenant,
session_id: 's1',
- created_by: 'user-1',
+ created_by_subject: { subject_id: 'user-1', subject_type: 'user', subject_display_name: 'user-1' },
agent: { type: 'inline', spec: makeAgentSpec() },
external_id: null,
});
@@ -331,7 +331,7 @@ describe('Sessions / SessionHandle / TurnHandle (storage + createTurn)', () => {
const session = await sessions.create({
tenant_id: tenant,
session_id: 's1',
- created_by: 'user-1',
+ created_by_subject: { subject_id: 'user-1', subject_type: 'user', subject_display_name: 'user-1' },
agent: { type: 'inline', spec: makeAgentSpec() },
external_id: null,
});
diff --git a/packages/trueforge-core/tests/agent-session/store/storeContractSuite.ts b/packages/trueforge-core/tests/agent-session/store/storeContractSuite.ts
index 09be27fd7..2ada896e8 100644
--- a/packages/trueforge-core/tests/agent-session/store/storeContractSuite.ts
+++ b/packages/trueforge-core/tests/agent-session/store/storeContractSuite.ts
@@ -83,7 +83,7 @@ export function runStoreContractSuite(createStore: () => ISessionStore) {
await store.createSession({
tenant_id: tenant,
session_id: sessionId,
- created_by: 'user-1',
+ created_by_subject: { subject_id: 'user-1', subject_type: 'user', subject_display_name: 'user-1' },
agent: { type: 'inline', spec: agentSpec },
custom: null,
metadata: {},
@@ -171,7 +171,7 @@ export function runStoreContractSuite(createStore: () => ISessionStore) {
const session = await store.getSession({ tenant_id: tenant, session_id: sessionId });
expect(session).toBeDefined();
expect(mustGet(session).tenant_id).toBe(tenant);
- expect(mustGet(session).created_by).toBe('user-1');
+ expect(mustGet(session).created_by_subject.subject_id).toBe('user-1');
expect(mustGet(session).agent).toMatchObject({
type: 'inline',
spec: { model: { name: 'test-provider/test-model' } },
@@ -185,19 +185,27 @@ export function runStoreContractSuite(createStore: () => ISessionStore) {
});
});
- it('createSession persists created_by', async () => {
+ it('createSession persists created_by_subject', async () => {
const store = createStore();
await store.createSession({
tenant_id: tenant,
session_id: 'created-by-session',
- created_by: '[email protected]',
+ created_by_subject: {
+ subject_id: '[email protected]',
+ subject_type: 'user',
+ subject_display_name: '[email protected]',
+ },
agent: { type: 'inline', spec: makeAgentSpec() },
custom: null,
metadata: {},
external_id: null,
});
const session = mustGet(await store.getSession({ tenant_id: tenant, session_id: 'created-by-session' }));
- expect(session.created_by).toBe('[email protected]');
+ expect(session.created_by_subject).toEqual({
+ subject_id: '[email protected]',
+ subject_type: 'user',
+ subject_display_name: '[email protected]',
+ });
const listed = await store.listSessions({
tenant_id: tenant,
@@ -207,10 +215,12 @@ export function runStoreContractSuite(createStore: () => ISessionStore) {
start_timestamp: undefined,
end_timestamp: undefined,
agent_id: undefined,
- created_by: undefined,
+ created_by_subject_id: undefined,
});
expect(listed.data.map(s => s.session_id)).toContain('created-by-session');
- expect(listed.data.find(s => s.session_id === 'created-by-session')?.created_by).toBe('[email protected]');
+ expect(listed.data.find(s => s.session_id === 'created-by-session')?.created_by_subject.subject_id).toBe(
+ );
});
it('persists reference agents and listSessions filters by agent_id', async () => {
@@ -218,7 +228,7 @@ export function runStoreContractSuite(createStore: () => ISessionStore) {
await store.createSession({
tenant_id: tenant,
session_id: 'named-1',
- created_by: 'user-1',
+ created_by_subject: { subject_id: 'user-1', subject_type: 'user', subject_display_name: 'user-1' },
agent: { type: 'reference', id: 'agent-abc', name: null },
custom: null,
metadata: {},
@@ -231,7 +241,7 @@ export function runStoreContractSuite(createStore: () => ISessionStore) {
const filtered = await store.listSessions({
agent_id: 'agent-abc',
- created_by: undefined,
+ created_by_subject_id: undefined,
tenant_id: tenant,
limit: 10,
page_token: undefined,
@@ -247,7 +257,7 @@ export function runStoreContractSuite(createStore: () => ISessionStore) {
await store.createSession({
tenant_id: tenant,
session_id: 'named-1',
- created_by: 'user-1',
+ created_by_subject: { subject_id: 'user-1', subject_type: 'user', subject_display_name: 'user-1' },
agent: { type: 'reference', id: 'agent-abc', name: null },
custom: null,
metadata: {},
@@ -302,7 +312,7 @@ export function runStoreContractSuite(createStore: () => ISessionStore) {
await store.createSession({
tenant_id: tenant,
session_id: sessionId,
- created_by: 'user-1',
+ created_by_subject: { subject_id: 'user-1', subject_type: 'user', subject_display_name: 'user-1' },
agent: { type: 'inline', spec: makeAgentSpec() },
custom: null,
metadata,
@@ -317,7 +327,7 @@ export function runStoreContractSuite(createStore: () => ISessionStore) {
await store.createSession({
tenant_id: tenant,
session_id: sessionId,
- created_by: 'user-1',
+ created_by_subject: { subject_id: 'user-1', subject_type: 'user', subject_display_name: 'user-1' },
agent: { type: 'inline', spec: makeAgentSpec() },
custom: null,
metadata: { a: '1' },
@@ -369,7 +379,7 @@ export function runStoreContractSuite(createStore: () => ISessionStore) {
store.createSession({
tenant_id: 'other',
session_id: sessionId,
- created_by: 'user-1',
+ created_by_subject: { subject_id: 'user-1', subject_type: 'user', subject_display_name: 'user-1' },
agent: { type: 'inline', spec: makeAgentSpec() },
custom: null,
metadata: {},
@@ -390,7 +400,7 @@ export function runStoreContractSuite(createStore: () => ISessionStore) {
await store.createSession({
tenant_id: tenant,
session_id: sessionId,
- created_by: 'user-1',
+ created_by_subject: { subject_id: 'user-1', subject_type: 'user', subject_display_name: 'user-1' },
agent: { type: 'inline', spec: makeAgentSpec() },
custom: null,
metadata: {},
@@ -409,7 +419,7 @@ export function runStoreContractSuite(createStore: () => ISessionStore) {
await store.createSession({
tenant_id: tenant,
session_id: 's-a',
- created_by: 'user-1',
+ created_by_subject: { subject_id: 'user-1', subject_type: 'user', subject_display_name: 'user-1' },
agent: { type: 'inline', spec: makeAgentSpec() },
custom: null,
metadata: {},
@@ -421,7 +431,7 @@ export function runStoreContractSuite(createStore: () => ISessionStore) {
store.createSession({
tenant_id: tenant,
session_id: 's-b',
- created_by: 'user-1',
+ created_by_subject: { subject_id: 'user-1', subject_type: 'user', subject_display_name: 'user-1' },
agent: { type: 'inline', spec: makeAgentSpec() },
custom: null,
metadata: {},
@@ -432,7 +442,7 @@ export function runStoreContractSuite(createStore: () => ISessionStore) {
await store.createSession({
tenant_id: 'other',
session_id: 's-c',
- created_by: 'user-1',
+ created_by_subject: { subject_id: 'user-1', subject_type: 'user', subject_display_name: 'user-1' },
agent: { type: 'inline', spec: makeAgentSpec() },
custom: null,
metadata: {},
@@ -441,7 +451,7 @@ export function runStoreContractSuite(createStore: () => ISessionStore) {
await store.createSession({
tenant_id: tenant,
session_id: 's-d',
- created_by: 'user-1',
+ created_by_subject: { subject_id: 'user-1', subject_type: 'user', subject_display_name: 'user-1' },
agent: { type: 'inline', spec: makeAgentSpec() },
custom: null,
metadata: {},
@@ -450,7 +460,7 @@ export function runStoreContractSuite(createStore: () => ISessionStore) {
await store.createSession({
tenant_id: tenant,
session_id: 's-e',
- created_by: 'user-1',
+ created_by_subject: { subject_id: 'user-1', subject_type: 'user', subject_display_name: 'user-1' },
agent: { type: 'inline', spec: makeAgentSpec() },
custom: null,
metadata: {},
@@ -463,7 +473,7 @@ export function runStoreContractSuite(createStore: () => ISessionStore) {
await store.createSession({
tenant_id: tenant,
session_id: sessionId,
- created_by: 'user-1',
+ created_by_subject: { subject_id: 'user-1', subject_type: 'user', subject_display_name: 'user-1' },
agent: { type: 'inline', spec: makeAgentSpec() },
custom: null,
metadata: {},
@@ -483,7 +493,7 @@ export function runStoreContractSuite(createStore: () => ISessionStore) {
await store.createSession({
tenant_id: 'other',
session_id: 'other-session',
- created_by: 'user-1',
+ created_by_subject: { subject_id: 'user-1', subject_type: 'user', subject_display_name: 'user-1' },
agent: { type: 'inline', spec: makeAgentSpec() },
custom: null,
metadata: {},
@@ -568,7 +578,7 @@ export function runStoreContractSuite(createStore: () => ISessionStore) {
const listed = await store.listSessions({
agent_id: undefined,
- created_by: undefined,
+ created_by_subject_id: undefined,
tenant_id: tenant,
limit: 10,
page_token: undefined,
@@ -668,7 +678,7 @@ export function runStoreContractSuite(createStore: () => ISessionStore) {
await store.createSession({
tenant_id: tenant,
session_id: nested,
- created_by: 'user-1',
+ created_by_subject: { subject_id: 'user-1', subject_type: 'user', subject_display_name: 'user-1' },
agent: { type: 'inline', spec: makeAgentSpec() },
custom: null,
metadata: {},
@@ -799,7 +809,7 @@ export function runStoreContractSuite(createStore: () => ISessionStore) {
await store.createSession({
tenant_id: tenant,
session_id: id,
- created_by: 'user-1',
+ created_by_subject: { subject_id: 'user-1', subject_type: 'user', subject_display_name: 'user-1' },
agent: { type: 'inline', spec: makeAgentSpec() },
custom: null,
metadata: {},
@@ -815,7 +825,7 @@ export function runStoreContractSuite(createStore: () => ISessionStore) {
await store.createSession({
tenant_id: 'other',
session_id: 'sx',
- created_by: 'user-1',
+ created_by_subject: { subject_id: 'user-1', subject_type: 'user', subject_display_name: 'user-1' },
agent: { type: 'inline', spec: makeAgentSpec() },
custom: null,
metadata: {},
@@ -824,7 +834,7 @@ export function runStoreContractSuite(createStore: () => ISessionStore) {
const desc = await store.listSessions({
agent_id: undefined,
- created_by: undefined,
+ created_by_subject_id: undefined,
tenant_id: tenant,
limit: 10,
page_token: undefined,
@@ -836,7 +846,7 @@ export function runStoreContractSuite(createStore: () => ISessionStore) {
const asc = await store.listSessions({
agent_id: undefined,
- created_by: undefined,
+ created_by_subject_id: undefined,
tenant_id: tenant,
limit: 10,
page_token: undefined,
@@ -853,7 +863,7 @@ export function runStoreContractSuite(createStore: () => ISessionStore) {
const first = await store.listSessions({
agent_id: undefined,
- created_by: undefined,
+ created_by_subject_id: undefined,
tenant_id: tenant,
limit: 2,
page_token: undefined,
@@ -865,7 +875,7 @@ export function runStoreContractSuite(createStore: () => ISessionStore) {
expect(first.pagination.next_page_token).toBeDefined();
const second = await store.listSessions({
agent_id: undefined,
- created_by: undefined,
+ created_by_subject_id: undefined,
tenant_id: tenant,
limit: 2,
page_token: first.pagination.next_page_token,
@@ -878,7 +888,7 @@ export function runStoreContractSuite(createStore: () => ISessionStore) {
const all = await store.listSessions({
agent_id: undefined,
- created_by: undefined,
+ created_by_subject_id: undefined,
tenant_id: tenant,
limit: 10,
page_token: undefined,
@@ -893,7 +903,7 @@ export function runStoreContractSuite(createStore: () => ISessionStore) {
const middleCreatedAt = middleSession.created_at;
const bounded = await store.listSessions({
agent_id: undefined,
- created_by: undefined,
+ created_by_subject_id: undefined,
tenant_id: tenant,
limit: 10,
order: 'asc',
@@ -918,7 +928,7 @@ export function runStoreContractSuite(createStore: () => ISessionStore) {
const listArgs = {
agent_id: undefined,
- created_by: undefined,
+ created_by_subject_id: undefined,
tenant_id: tenant,
order: undefined,
start_timestamp: undefined,
@@ -944,7 +954,7 @@ export function runStoreContractSuite(createStore: () => ISessionStore) {
const listArgs = {
agent_id: undefined,
- created_by: undefined,
+ created_by_subject_id: undefined,
tenant_id: tenant,
order: 'desc' as const,
start_timestamp: undefined,
@@ -965,12 +975,12 @@ export function runStoreContractSuite(createStore: () => ISessionStore) {
expect(page2.pagination.next_page_token).toBeUndefined();
});
- it('filters by created_by', async () => {
+ it('filters by created_by_subject_id', async () => {
const store = createStore();
await store.createSession({
tenant_id: tenant,
session_id: 'alice-session',
- created_by: 'alice',
+ created_by_subject: { subject_id: 'alice', subject_type: 'user', subject_display_name: 'alice' },
agent: { type: 'inline', spec: makeAgentSpec() },
custom: null,
metadata: {},
@@ -979,7 +989,7 @@ export function runStoreContractSuite(createStore: () => ISessionStore) {
await store.createSession({
tenant_id: tenant,
session_id: 'bob-session',
- created_by: 'bob',
+ created_by_subject: { subject_id: 'bob', subject_type: 'user', subject_display_name: 'bob' },
agent: { type: 'inline', spec: makeAgentSpec() },
custom: null,
metadata: {},
@@ -988,7 +998,7 @@ export function runStoreContractSuite(createStore: () => ISessionStore) {
const aliceOnly = await store.listSessions({
agent_id: undefined,
- created_by: 'alice',
+ created_by_subject_id: 'alice',
tenant_id: tenant,
limit: 10,
page_token: undefined,
@@ -997,11 +1007,11 @@ export function runStoreContractSuite(createStore: () => ISessionStore) {
end_timestamp: undefined,
});
expect(aliceOnly.data.map(s => s.session_id)).toEqual(['alice-session']);
- expect(aliceOnly.data[0]?.created_by).toBe('alice');
+ expect(aliceOnly.data[0]?.created_by_subject.subject_id).toBe('alice');
const unmatched = await store.listSessions({
agent_id: undefined,
- created_by: 'nobody',
+ created_by_subject_id: 'nobody',
tenant_id: tenant,
limit: 10,
page_token: undefined,
diff --git a/packages/trueforge-core/tests/agent-session/turnStream.test.ts b/packages/trueforge-core/tests/agent-session/turnStream.test.ts
index 1ccd57e67..ae9be5e03 100644
--- a/packages/trueforge-core/tests/agent-session/turnStream.test.ts
+++ b/packages/trueforge-core/tests/agent-session/turnStream.test.ts
@@ -23,7 +23,7 @@ describe('TurnHandle.stream()', () => {
const session = await sessions.create({
tenant_id: tenant,
session_id: 's1',
- created_by: 'user-1',
+ created_by_subject: { subject_id: 'user-1', subject_type: 'user', subject_display_name: 'user-1' },
agent: {
type: 'inline',
spec: makeAgentSpec({
@@ -485,7 +485,7 @@ describe('TurnResourceResolver caches', () => {
const session = await sessions.create({
tenant_id: 't',
session_id: 's',
- created_by: 'user-1',
+ created_by_subject: { subject_id: 'user-1', subject_type: 'user', subject_display_name: 'user-1' },
agent: {
type: 'inline',
spec: makeAgentSpec({
diff --git a/packages/trueforge-sdk/reference.md b/packages/trueforge-sdk/reference.md
index d15745c03..969921470 100644
--- a/packages/trueforge-sdk/reference.md
+++ b/packages/trueforge-sdk/reference.md
@@ -1235,7 +1235,7 @@ await client.schedules.listRuns("schedule_id");
<dl>
<dd>
-List the caller's sessions (newest first by default), token-paginated. Results are scoped to the authenticated identity via the session store's `created_by` filter (not a client query param). Optional `agent_id` filters to sessions bound to that named agent. Pass `page_token` to fetch the next page, keeping the other query params constant.
+List the caller's sessions (newest first by default), token-paginated. Results are scoped to the authenticated identity via the session store's `created_by_subject.subject_id` filter (not a client query param). Optional `agent_id` filters to sessions bound to that named agent. Pass `page_token` to fetch the next page, keeping the other query params constant.
</dd>
</dl>
</dd>
@@ -1365,7 +1365,7 @@ await client.sessions.create({
<dl>
<dd>
-Fetch a session by ID. Only the session creator (`created_by`) may fetch it.
+Fetch a session by ID. Only the session creator may fetch it.
</dd>
</dl>
</dd>
@@ -1428,7 +1428,7 @@ await client.sessions.get("session_id");
<dl>
<dd>
-Delete a session and all related turns, events, and internal state. Only the session creator (`created_by`) may delete it. Idempotent if already gone.
+Delete a session and all related turns, events, and internal state. Only the session creator may delete it. Idempotent if already gone.
</dd>
</dl>
</dd>
@@ -1491,7 +1491,7 @@ await client.sessions.delete("session_id");
<dl>
<dd>
-Update a session by replacing `agent` with `{ spec: AgentSpec }`. Named (reference) sessions reject agent updates. An empty body is a valid no-op that refreshes `updated_at`. Only the session creator (`created_by`) may update it.
+Update a session by replacing `agent` with `{ spec: AgentSpec }`. Named (reference) sessions reject agent updates. An empty body is a valid no-op that refreshes `updated_at`. Only the session creator may update it.
</dd>
</dl>
</dd>
@@ -1562,7 +1562,7 @@ await client.sessions.update("session_id");
<dl>
<dd>
-Cancel the running last turn for a session. Only the session creator (`created_by`) may cancel.
+Cancel the running last turn for a session. Only the session creator may cancel.
</dd>
</dl>
</dd>
@@ -1633,7 +1633,7 @@ await client.sessions.cancel("session_id");
<dl>
<dd>
-List session events as `{ turn_id, event }` across the active turn branch (newest first), including persisted events from a running tip. Each turn contributes turn.created, content events (model.message, tool.call, …), and turn.done when terminal; streaming deltas are not included. Use `page_token` to paginate backward toward older events while retaining the original branch anchor. Only the session creator (`created_by`) may list events.
+List session events as `{ turn_id, event }` across the active turn branch (newest first), including persisted events from a running tip. Each turn contributes turn.created, content events (model.message, tool.call, …), and turn.done when terminal; streaming deltas are not included. Use `page_token` to paginate backward toward older events while retaining the original branch anchor. Only the session creator may list events.
</dd>
</dl>
</dd>
@@ -1704,7 +1704,7 @@ await client.sessions.listEvents("session_id");
<dl>
<dd>
-List turns for a session (newest first by default), token-paginated. Only the session creator (`created_by`) may list turns.
+List turns for a session (newest first by default), token-paginated. Only the session creator may list turns.
</dd>
</dl>
</dd>
@@ -1776,7 +1776,7 @@ await client.sessions.listTurns("session_id");
<dd>
Create a turn within a session and execute it.
-Only the session creator (`created_by`) may create turns.
+Only the session creator may create turns.
When `stream` is true (default), respond with a Server-Sent Events stream of turn events.
When `stream` is false, return the turn immediately with `state.status: "running"` while execution continues in the background; use get turn or subscribe to observe completion.
Use `previous_turn_id` to chain to the session's last turn (defaults to `auto`); use `none` for a new root.
@@ -1854,7 +1854,7 @@ for await (const item of response) {
<dd>
Create a turn within a session and execute it.
-Only the session creator (`created_by`) may create turns.
+Only the session creator may create turns.
When `stream` is true (default), respond with a Server-Sent Events stream of turn events.
When `stream` is false, return the turn immediately with `state.status: "running"` while execution continues in the background; use get turn or subscribe to observe completion.
Use `previous_turn_id` to chain to the session's last turn (defaults to `auto`); use `none` for a new root.
@@ -1928,7 +1928,7 @@ await client.sessions.createTurn("session_id", {});
<dl>
<dd>
-Fetch a single turn by ID. Only the session creator (`created_by`) may fetch it.
+Fetch a single turn by ID. Only the session creator may fetch it.
</dd>
</dl>
</dd>
@@ -1999,7 +1999,7 @@ await client.sessions.getTurn("session_id", "turn_id");
<dl>
<dd>
-Download a file from the sandbox this turn ran in. Paths come from the assistant's `sandbox_artifacts` block. Only the session creator (`created_by`) may download.
+Download a file from the sandbox this turn ran in. Paths come from the assistant's `sandbox_artifacts` block. Only the session creator may download.
</dd>
</dl>
</dd>
@@ -2080,7 +2080,7 @@ await client.sessions.downloadSandboxFile("session_id", "turn_id", {
<dl>
<dd>
-Paginated persisted events for a turn (insertion order by default). Only the session creator (`created_by`) may list events.
+Paginated persisted events for a turn (insertion order by default). Only the session creator may list events.
</dd>
</dl>
</dd>
@@ -2159,7 +2159,7 @@ await client.sessions.listTurnEvents("session_id", "turn_id");
<dl>
<dd>
-Subscribe to the live SSE stream for a turn. Only the session creator (`created_by`) may subscribe. Pass `after_sequence_number` to resume after a disconnect (exclusive — events after this sequence number are replayed).
+Subscribe to the live SSE stream for a turn. Only the session creator may subscribe. Pass `after_sequence_number` to resume after a disconnect (exclusive — events after this sequence number are replayed).
</dd>
</dl>
</dd>
diff --git a/packages/trueforge-sdk/src/api/resources/sessions/client/Client.ts b/packages/trueforge-sdk/src/api/resources/sessions/client/Client.ts
index 94792f917..d4c868844 100644
--- a/packages/trueforge-sdk/src/api/resources/sessions/client/Client.ts
+++ b/packages/trueforge-sdk/src/api/resources/sessions/client/Client.ts
@@ -24,7 +24,7 @@ export class SessionsClient {
}
/**
- * List the caller's sessions (newest first by default), token-paginated. Results are scoped to the authenticated identity via the session store's `created_by` filter (not a client query param). Optional `agent_id` filters to sessions bound to that named agent. Pass `page_token` to fetch the next page, keeping the other query params constant.
+ * List the caller's sessions (newest first by default), token-paginated. Results are scoped to the authenticated identity via the session store's `created_by_subject.subject_id` filter (not a client query param). Optional `agent_id` filters to sessions bound to that named agent. Pass `page_token` to fetch the next page, keeping the other query params constant.
*
* @param {TrueForge.ListSessionsRequest} request
* @param {SessionsClient.RequestOptions} requestOptions - Request-specific configuration.
@@ -259,7 +259,7 @@ export class SessionsClient {
}
/**
- * Fetch a session by ID. Only the session creator (`created_by`) may fetch it.
+ * Fetch a session by ID. Only the session creator may fetch it.
*
* @param {string} session_id - Session identifier.
* @param {SessionsClient.RequestOptions} requestOptions - Request-specific configuration.
@@ -354,7 +354,7 @@ export class SessionsClient {
}
/**
- * Delete a session and all related turns, events, and internal state. Only the session creator (`created_by`) may delete it. Idempotent if already gone.
+ * Delete a session and all related turns, events, and internal state. Only the session creator may delete it. Idempotent if already gone.
*
* @param {string} session_id - Session identifier.
* @param {SessionsClient.RequestOptions} requestOptions - Request-specific configuration.
@@ -430,7 +430,7 @@ export class SessionsClient {
}
/**
- * Update a session by replacing `agent` with `{ spec: AgentSpec }`. Named (reference) sessions reject agent updates. An empty body is a valid no-op that refreshes `updated_at`. Only the session creator (`created_by`) may update it.
+ * Update a session by replacing `agent` with `{ spec: AgentSpec }`. Named (reference) sessions reject agent updates. An empty body is a valid no-op that refreshes `updated_at`. Only the session creator may update it.
*
* @param {string} session_id - Session identifier.
* @param {TrueForge.UpdateSessionRequest} request
@@ -568,7 +568,7 @@ export class SessionsClient {
}
/**
- * Cancel the running last turn for a session. Only the session creator (`created_by`) may cancel.
+ * Cancel the running last turn for a session. Only the session creator may cancel.
*
* @param {string} session_id - Session identifier.
* @param {TrueForge.CancelSessionRequest} request
@@ -694,7 +694,7 @@ export class SessionsClient {
}
/**
- * List session events as `{ turn_id, event }` across the active turn branch (newest first), including persisted events from a running tip. Each turn contributes turn.created, content events (model.message, tool.call, …), and turn.done when terminal; streaming deltas are not included. Use `page_token` to paginate backward toward older events while retaining the original branch anchor. Only the session creator (`created_by`) may list events.
+ * List session events as `{ turn_id, event }` across the active turn branch (newest first), including persisted events from a running tip. Each turn contributes turn.created, content events (model.message, tool.call, …), and turn.done when terminal; streaming deltas are not included. Use `page_token` to paginate backward toward older events while retaining the original branch anchor. Only the session creator may list events.
*
* @param {string} session_id - Session identifier.
* @param {TrueForge.ListEventsSessionsRequest} request
@@ -827,7 +827,7 @@ export class SessionsClient {
}
/**
- * List turns for a session (newest first by default), token-paginated. Only the session creator (`created_by`) may list turns.
+ * List turns for a session (newest first by default), token-paginated. Only the session creator may list turns.
*
* @param {string} session_id - Session identifier.
* @param {TrueForge.ListTurnsSessionsRequest} request
@@ -960,7 +960,7 @@ export class SessionsClient {
/**
* Create a turn within a session and execute it.
- * Only the session creator (`created_by`) may create turns.
+ * Only the session creator may create turns.
* When `stream` is true (default), respond with a Server-Sent Events stream of turn events.
* When `stream` is false, return the turn immediately with `state.status: "running"` while execution continues in the background; use get turn or subscribe to observe completion.
* Use `previous_turn_id` to chain to the session's last turn (defaults to `auto`); use `none` for a new root.
@@ -1134,7 +1134,7 @@ export class SessionsClient {
/**
* Create a turn within a session and execute it.
- * Only the session creator (`created_by`) may create turns.
+ * Only the session creator may create turns.
* When `stream` is true (default), respond with a Server-Sent Events stream of turn events.
* When `stream` is false, return the turn immediately with `state.status: "running"` while execution continues in the background; use get turn or subscribe to observe completion.
* Use `previous_turn_id` to chain to the session's last turn (defaults to `auto`); use `none` for a new root.
@@ -1314,7 +1314,7 @@ export class SessionsClient {
}
/**
- * Fetch a single turn by ID. Only the session creator (`created_by`) may fetch it.
+ * Fetch a single turn by ID. Only the session creator may fetch it.
*
* @param {string} session_id - Session identifier.
* @param {string} turn_id - Turn identifier.
@@ -1417,7 +1417,7 @@ export class SessionsClient {
}
/**
- * Download a file from the sandbox this turn ran in. Paths come from the assistant's `sandbox_artifacts` block. Only the session creator (`created_by`) may download.
+ * Download a file from the sandbox this turn ran in. Paths come from the assistant's `sandbox_artifacts` block. Only the session creator may download.
*
* @throws {@link TrueForge.BadRequestError}
* @throws {@link TrueForge.ForbiddenError}
@@ -1577,7 +1577,7 @@ export class SessionsClient {
}
/**
- * Paginated persisted events for a turn (insertion order by default). Only the session creator (`created_by`) may list events.
+ * Paginated persisted events for a turn (insertion order by default). Only the session creator may list events.
*
* @param {string} session_id - Session identifier.
* @param {string} turn_id - Turn identifier.
@@ -1720,7 +1720,7 @@ export class SessionsClient {
}
/**
- * Subscribe to the live SSE stream for a turn. Only the session creator (`created_by`) may subscribe. Pass `after_sequence_number` to resume after a disconnect (exclusive — events after this sequence number are replayed).
+ * Subscribe to the live SSE stream for a turn. Only the session creator may subscribe. Pass `after_sequence_number` to resume after a disconnect (exclusive — events after this sequence number are replayed).
*/
public subscribeToTurn(
session_id: string,
diff --git a/packages/trueforge-sdk/src/api/types/Agent.ts b/packages/trueforge-sdk/src/api/types/Agent.ts
index 7e653aa70..a912c1c39 100644
--- a/packages/trueforge-sdk/src/api/types/Agent.ts
+++ b/packages/trueforge-sdk/src/api/types/Agent.ts
@@ -3,6 +3,7 @@
import type * as TrueForge from "../index.js";
export interface Agent {
+ createdBySubject: TrueForge.CreatedBySubject;
/** Immutable server-generated agent identifier. */
id: string;
manifest: TrueForge.AgentSpec;
diff --git a/packages/trueforge-sdk/src/api/types/CreatedBySubject.ts b/packages/trueforge-sdk/src/api/types/CreatedBySubject.ts
new file mode 100644
index 000000000..0add1e793
--- /dev/null
+++ b/packages/trueforge-sdk/src/api/types/CreatedBySubject.ts
@@ -0,0 +1,13 @@
+// This file was auto-generated by Fern from our API Definition.
+
+/**
+ * Who created this resource.
+ */
+export interface CreatedBySubject {
+ /** Display name. */
+ subjectDisplayName: string;
+ /** Subject id. */
+ subjectId: string;
+ /** Subject type. */
+ subjectType: string;
+}
diff --git a/packages/trueforge-sdk/src/api/types/Schedule.ts b/packages/trueforge-sdk/src/api/types/Schedule.ts
index 5d79a4fad..c20d05019 100644
--- a/packages/trueforge-sdk/src/api/types/Schedule.ts
+++ b/packages/trueforge-sdk/src/api/types/Schedule.ts
@@ -5,7 +5,7 @@ import type * as TrueForge from "../index.js";
export interface Schedule {
agentName: TrueForge.ResourceName;
createdAt: Date;
- createdBy: string;
+ createdBySubject: TrueForge.CreatedBySubject;
id: string;
manifest: TrueForge.ScheduleManifest;
name: TrueForge.ResourceName;
diff --git a/packages/trueforge-sdk/src/api/types/ScheduleRun.ts b/packages/trueforge-sdk/src/api/types/ScheduleRun.ts
index 318a21af3..8e4841b18 100644
--- a/packages/trueforge-sdk/src/api/types/ScheduleRun.ts
+++ b/packages/trueforge-sdk/src/api/types/ScheduleRun.ts
@@ -4,12 +4,12 @@ import type * as TrueForge from "../index.js";
export interface ScheduleRun {
createdAt: Date;
+ createdBySubject: TrueForge.CreatedBySubject;
id: string;
name: string;
scheduleId: string;
scheduledFor: Date;
status: TrueForge.ScheduleRunStatus;
triggeredAt: Date | null;
- triggeredBy: string;
updatedAt: Date;
}
diff --git a/packages/trueforge-sdk/src/api/types/Session.ts b/packages/trueforge-sdk/src/api/types/Session.ts
index f6c10481d..512819d8e 100644
--- a/packages/trueforge-sdk/src/api/types/Session.ts
+++ b/packages/trueforge-sdk/src/api/types/Session.ts
@@ -6,8 +6,7 @@ export interface Session {
agent: TrueForge.SessionAgent;
/** ISO 8601 creation timestamp. */
createdAt: string;
- /** Caller identity that created the session (immutable). */
- createdBy: string;
+ createdBySubject: TrueForge.CreatedBySubject;
/** Unique session id. */
id: string;
metadata: TrueForge.SessionMetadata;
diff --git a/packages/trueforge-sdk/src/api/types/index.ts b/packages/trueforge-sdk/src/api/types/index.ts
index 124434e09..727e1bd19 100644
--- a/packages/trueforge-sdk/src/api/types/index.ts
+++ b/packages/trueforge-sdk/src/api/types/index.ts
@@ -42,6 +42,7 @@ export * from "./ConfiguredModelProvider.js";
export * from "./ConfiguredSandboxProvider.js";
export * from "./ConfiguredSkill.js";
export * from "./ContextManagementConfig.js";
+export * from "./CreatedBySubject.js";
export * from "./CreateScheduleRunResponse.js";
export * from "./CreateSessionAgent.js";
export * from "./CronExpression.js";
diff --git a/packages/trueforge-sdk/src/serialization/types/Agent.ts b/packages/trueforge-sdk/src/serialization/types/Agent.ts
index 1b8a7159b..21ce3103a 100644
--- a/packages/trueforge-sdk/src/serialization/types/Agent.ts
+++ b/packages/trueforge-sdk/src/serialization/types/Agent.ts
@@ -4,10 +4,12 @@ import type * as TrueForge from "../../api/index.js";
import * as core from "../../core/index.js";
import type * as serializers from "../index.js";
import { AgentSpec } from "./AgentSpec.js";
+import { CreatedBySubject } from "./CreatedBySubject.js";
import { ResourceName } from "./ResourceName.js";
export const Agent: core.serialization.ObjectSchema<serializers.Agent.Raw, TrueForge.Agent> = core.serialization.object(
{
+ createdBySubject: core.serialization.property("created_by_subject", CreatedBySubject),
id: core.serialization.string(),
manifest: AgentSpec,
name: ResourceName,
@@ -16,6 +18,7 @@ export const Agent: core.serialization.ObjectSchema<serializers.Agent.Raw, TrueF
export declare namespace Agent {
export interface Raw {
+ created_by_subject: CreatedBySubject.Raw;
id: string;
manifest: AgentSpec.Raw;
name: ResourceName.Raw;
diff --git a/packages/trueforge-sdk/src/serialization/types/CreatedBySubject.ts b/packages/trueforge-sdk/src/serialization/types/CreatedBySubject.ts
new file mode 100644
index 000000000..0e58696b1
--- /dev/null
+++ b/packages/trueforge-sdk/src/serialization/types/CreatedBySubject.ts
@@ -0,0 +1,22 @@
+// This file was auto-generated by Fern from our API Definition.
+
+import type * as TrueForge from "../../api/index.js";
+import * as core from "../../core/index.js";
+import type * as serializers from "../index.js";
+
+export const CreatedBySubject: core.serialization.ObjectSchema<
+ serializers.CreatedBySubject.Raw,
+ TrueForge.CreatedBySubject
+> = core.serialization.object({
+ subjectDisplayName: core.serialization.property("subject_display_name", core.serialization.string()),
+ subjectId: core.serialization.property("subject_id", core.serialization.string()),
+ subjectType: core.serialization.property("subject_type", core.serialization.string()),
+});
+
+export declare namespace CreatedBySubject {
+ export interface Raw {
+ subject_display_name: string;
+ subject_id: string;
+ subject_type: string;
+ }
+}
diff --git a/packages/trueforge-sdk/src/serialization/types/Schedule.ts b/packages/trueforge-sdk/src/serialization/types/Schedule.ts
index ad0f46e3d..28ae0712a 100644
--- a/packages/trueforge-sdk/src/serialization/types/Schedule.ts
+++ b/packages/trueforge-sdk/src/serialization/types/Schedule.ts
@@ -3,6 +3,7 @@
import type * as TrueForge from "../../api/index.js";
import * as core from "../../core/index.js";
import type * as serializers from "../index.js";
+import { CreatedBySubject } from "./CreatedBySubject.js";
import { ResourceName } from "./ResourceName.js";
import { ScheduleManifest } from "./ScheduleManifest.js";
@@ -10,7 +11,7 @@ export const Schedule: core.serialization.ObjectSchema<serializers.Schedule.Raw,
core.serialization.object({
agentName: core.serialization.property("agent_name", ResourceName),
createdAt: core.serialization.property("created_at", core.serialization.date()),
- createdBy: core.serialization.property("created_by", core.serialization.string()),
+ createdBySubject: core.serialization.property("created_by_subject", CreatedBySubject),
id: core.serialization.string(),
manifest: ScheduleManifest,
name: ResourceName,
@@ -21,7 +22,7 @@ export declare namespace Schedule {
export interface Raw {
agent_name: ResourceName.Raw;
created_at: string;
- created_by: string;
+ created_by_subject: CreatedBySubject.Raw;
id: string;
manifest: ScheduleManifest.Raw;
name: ResourceName.Raw;
diff --git a/packages/trueforge-sdk/src/serialization/types/ScheduleRun.ts b/packages/trueforge-sdk/src/serialization/types/ScheduleRun.ts
index 267664ec2..d5a097c3a 100644
--- a/packages/trueforge-sdk/src/serialization/types/ScheduleRun.ts
+++ b/packages/trueforge-sdk/src/serialization/types/ScheduleRun.ts
@@ -3,31 +3,32 @@
import type * as TrueForge from "../../api/index.js";
import * as core from "../../core/index.js";
import type * as serializers from "../index.js";
+import { CreatedBySubject } from "./CreatedBySubject.js";
import { ScheduleRunStatus } from "./ScheduleRunStatus.js";
export const ScheduleRun: core.serialization.ObjectSchema<serializers.ScheduleRun.Raw, TrueForge.ScheduleRun> =
core.serialization.object({
createdAt: core.serialization.property("created_at", core.serialization.date()),
+ createdBySubject: core.serialization.property("created_by_subject", CreatedBySubject),
id: core.serialization.string(),
name: core.serialization.string(),
scheduleId: core.serialization.property("schedule_id", core.serialization.string()),
scheduledFor: core.serialization.property("scheduled_for", core.serialization.date()),
status: ScheduleRunStatus,
triggeredAt: core.serialization.property("triggered_at", core.serialization.date().nullable()),
- triggeredBy: core.serialization.property("triggered_by", core.serialization.string()),
updatedAt: core.serialization.property("updated_at", core.serialization.date()),
});
export declare namespace ScheduleRun {
export interface Raw {
created_at: string;
+ created_by_subject: CreatedBySubject.Raw;
id: string;
name: string;
schedule_id: string;
scheduled_for: string;
status: ScheduleRunStatus.Raw;
triggered_at?: string | null;
- triggered_by: string;
updated_at: string;
}
}
diff --git a/packages/trueforge-sdk/src/serialization/types/Session.ts b/packages/trueforge-sdk/src/serialization/types/Session.ts
index 923f76f27..7b69a33b6 100644
--- a/packages/trueforge-sdk/src/serialization/types/Session.ts
+++ b/packages/trueforge-sdk/src/serialization/types/Session.ts
@@ -3,6 +3,7 @@
import type * as TrueForge from "../../api/index.js";
import * as core from "../../core/index.js";
import type * as serializers from "../index.js";
+import { CreatedBySubject } from "./CreatedBySubject.js";
import { SessionAgent } from "./SessionAgent.js";
import { SessionMetadata } from "./SessionMetadata.js";
import { SessionMetrics } from "./SessionMetrics.js";
@@ -11,7 +12,7 @@ export const Session: core.serialization.ObjectSchema<serializers.Session.Raw, T
core.serialization.object({
agent: SessionAgent,
createdAt: core.serialization.property("created_at", core.serialization.string()),
- createdBy: core.serialization.property("created_by", core.serialization.string()),
+ createdBySubject: core.serialization.property("created_by_subject", CreatedBySubject),
id: core.serialization.string(),
metadata: SessionMetadata,
metrics: SessionMetrics,
@@ -23,7 +24,7 @@ export declare namespace Session {
export interface Raw {
agent: SessionAgent.Raw;
created_at: string;
- created_by: string;
+ created_by_subject: CreatedBySubject.Raw;
id: string;
metadata: SessionMetadata.Raw;
metrics: SessionMetrics.Raw;
diff --git a/packages/trueforge-sdk/src/serialization/types/index.ts b/packages/trueforge-sdk/src/serialization/types/index.ts
index 124434e09..727e1bd19 100644
--- a/packages/trueforge-sdk/src/serialization/types/index.ts
+++ b/packages/trueforge-sdk/src/serialization/types/index.ts
@@ -42,6 +42,7 @@ export * from "./ConfiguredModelProvider.js";
export * from "./ConfiguredSandboxProvider.js";
export * from "./ConfiguredSkill.js";
export * from "./ContextManagementConfig.js";
+export * from "./CreatedBySubject.js";
export * from "./CreateScheduleRunResponse.js";
export * from "./CreateSessionAgent.js";
export * from "./CronExpression.js";
diff --git a/packages/trueforge-sdk/tests/wire/agents.test.ts b/packages/trueforge-sdk/tests/wire/agents.test.ts
index 23b40e671..b154eb84f 100644
--- a/packages/trueforge-sdk/tests/wire/agents.test.ts
+++ b/packages/trueforge-sdk/tests/wire/agents.test.ts
@@ -9,7 +9,20 @@ describe("AgentsClient", () => {
const server = mockServerPool.createServer();
const client = new TrueForge({ maxRetries: 0, token: "test", baseUrl: server.baseUrl });
- const rawResponseBody = { data: [{ id: "id", manifest: { model: { name: "name" } }, name: "name" }] };
+ const rawResponseBody = {
+ data: [
+ {
+ created_by_subject: {
+ subject_display_name: "subject_display_name",
+ subject_id: "subject_id",
+ subject_type: "subject_type",
+ },
+ id: "id",
+ manifest: { model: { name: "name" } },
+ name: "name",
+ },
+ ],
+ };
server.mockEndpoint().get("/api/v1/agents").respondWith().statusCode(200).jsonBody(rawResponseBody).build();
@@ -17,6 +30,11 @@ describe("AgentsClient", () => {
expect(response).toEqual({
data: [
{
+ createdBySubject: {
+ subjectDisplayName: "subject_display_name",
+ subjectId: "subject_id",
+ subjectType: "subject_type",
+ },
id: "id",
manifest: {
model: {
@@ -48,6 +66,11 @@ describe("AgentsClient", () => {
const rawRequestBody = { manifest: { model: { name: "name" } }, name: "name" };
const rawResponseBody = {
data: {
+ created_by_subject: {
+ subject_display_name: "subject_display_name",
+ subject_id: "subject_id",
+ subject_type: "subject_type",
+ },
id: "id",
manifest: {
instructions: "instructions",
@@ -80,6 +103,11 @@ describe("AgentsClient", () => {
});
expect(response).toEqual({
data: {
+ createdBySubject: {
+ subjectDisplayName: "subject_display_name",
+ subjectId: "subject_id",
+ subjectType: "subject_type",
+ },
id: "id",
manifest: {
instructions: "instructions",
@@ -198,6 +226,11 @@ describe("AgentsClient", () => {
const rawResponseBody = {
data: {
+ created_by_subject: {
+ subject_display_name: "subject_display_name",
+ subject_id: "subject_id",
+ subject_type: "subject_type",
+ },
id: "id",
manifest: {
instructions: "instructions",
@@ -222,6 +255,11 @@ describe("AgentsClient", () => {
const response = await client.agents.get("agent_id");
expect(response).toEqual({
data: {
+ createdBySubject: {
+ subjectDisplayName: "subject_display_name",
+ subjectId: "subject_id",
+ subjectType: "subject_type",
+ },
id: "id",
manifest: {
instructions: "instructions",
@@ -278,6 +316,11 @@ describe("AgentsClient", () => {
const rawRequestBody = { manifest: { model: { name: "name" } } };
const rawResponseBody = {
data: {
+ created_by_subject: {
+ subject_display_name: "subject_display_name",
+ subject_id: "subject_id",
+ subject_type: "subject_type",
+ },
id: "id",
manifest: {
instructions: "instructions",
@@ -309,6 +352,11 @@ describe("AgentsClient", () => {
});
expect(response).toEqual({
data: {
+ createdBySubject: {
+ subjectDisplayName: "subject_display_name",
+ subjectId: "subject_id",
+ subjectType: "subject_type",
+ },
id: "id",
manifest: {
instructions: "instructions",
diff --git a/packages/trueforge-sdk/tests/wire/internal/sessions.test.ts b/packages/trueforge-sdk/tests/wire/internal/sessions.test.ts
index f8b74b8b3..a41678bbe 100644
--- a/packages/trueforge-sdk/tests/wire/internal/sessions.test.ts
+++ b/packages/trueforge-sdk/tests/wire/internal/sessions.test.ts
@@ -13,7 +13,11 @@ describe("SessionsClient", () => {
data: {
agent: { spec: { model: { name: "name" } }, type: "inline" },
created_at: "created_at",
- created_by: "created_by",
+ created_by_subject: {
+ subject_display_name: "subject_display_name",
+ subject_id: "subject_id",
+ subject_type: "subject_type",
+ },
id: "id",
metadata: { key: "value" },
metrics: { total_cost_in_usd: 1.1, total_duration_ms: 1, total_turns: 1 },
@@ -48,7 +52,11 @@ describe("SessionsClient", () => {
type: "inline",
},
createdAt: "created_at",
- createdBy: "created_by",
+ createdBySubject: {
+ subjectDisplayName: "subject_display_name",
+ subjectId: "subject_id",
+ subjectType: "subject_type",
+ },
id: "id",
metadata: {
key: "value",
diff --git a/packages/trueforge-sdk/tests/wire/schedules.test.ts b/packages/trueforge-sdk/tests/wire/schedules.test.ts
index 8cbd16e20..11627f819 100644
--- a/packages/trueforge-sdk/tests/wire/schedules.test.ts
+++ b/packages/trueforge-sdk/tests/wire/schedules.test.ts
@@ -14,7 +14,11 @@ describe("SchedulesClient", () => {
{
agent_name: "agent_name",
created_at: "2024-01-15T09:30:00Z",
- created_by: "created_by",
+ created_by_subject: {
+ subject_display_name: "subject_display_name",
+ subject_id: "subject_id",
+ subject_type: "subject_type",
+ },
id: "id",
manifest: { cron: "cron", task: "task" },
name: "name",
@@ -37,7 +41,11 @@ describe("SchedulesClient", () => {
{
agentName: "agent_name",
createdAt: new Date("2024-01-15T09:30:00.000Z"),
- createdBy: "created_by",
+ createdBySubject: {
+ subjectDisplayName: "subject_display_name",
+ subjectId: "subject_id",
+ subjectType: "subject_type",
+ },
id: "id",
manifest: {
cron: "cron",
@@ -95,7 +103,11 @@ describe("SchedulesClient", () => {
data: {
agent_name: "agent_name",
created_at: "2024-01-15T09:30:00Z",
- created_by: "created_by",
+ created_by_subject: {
+ subject_display_name: "subject_display_name",
+ subject_id: "subject_id",
+ subject_type: "subject_type",
+ },
id: "id",
manifest: { cron: "cron", status: "active", task: "task", timezone: "timezone" },
name: "name",
@@ -124,7 +136,11 @@ describe("SchedulesClient", () => {
data: {
agentName: "agent_name",
createdAt: new Date("2024-01-15T09:30:00.000Z"),
- createdBy: "created_by",
+ createdBySubject: {
+ subjectDisplayName: "subject_display_name",
+ subjectId: "subject_id",
+ subjectType: "subject_type",
+ },
id: "id",
manifest: {
cron: "cron",
@@ -199,13 +215,17 @@ describe("SchedulesClient", () => {
const rawResponseBody = {
data: {
created_at: "2024-01-15T09:30:00Z",
+ created_by_subject: {
+ subject_display_name: "subject_display_name",
+ subject_id: "subject_id",
+ subject_type: "subject_type",
+ },
id: "id",
name: "name",
schedule_id: "schedule_id",
scheduled_for: "2024-01-15T09:30:00Z",
status: "scheduled",
triggered_at: "2024-01-15T09:30:00Z",
- triggered_by: "triggered_by",
updated_at: "2024-01-15T09:30:00Z",
},
};
@@ -225,13 +245,17 @@ describe("SchedulesClient", () => {
expect(response).toEqual({
data: {
createdAt: new Date("2024-01-15T09:30:00.000Z"),
+ createdBySubject: {
+ subjectDisplayName: "subject_display_name",
+ subjectId: "subject_id",
+ subjectType: "subject_type",
+ },
id: "id",
name: "name",
scheduleId: "schedule_id",
scheduledFor: new Date("2024-01-15T09:30:00.000Z"),
status: "scheduled",
triggeredAt: new Date("2024-01-15T09:30:00.000Z"),
- triggeredBy: "triggered_by",
updatedAt: new Date("2024-01-15T09:30:00.000Z"),
},
});
@@ -355,7 +379,11 @@ describe("SchedulesClient", () => {
data: {
agent_name: "agent_name",
created_at: "2024-01-15T09:30:00Z",
- created_by: "created_by",
+ created_by_subject: {
+ subject_display_name: "subject_display_name",
+ subject_id: "subject_id",
+ subject_type: "subject_type",
+ },
id: "id",
manifest: { cron: "cron", status: "active", task: "task", timezone: "timezone" },
name: "name",
@@ -376,7 +404,11 @@ describe("SchedulesClient", () => {
data: {
agentName: "agent_name",
createdAt: new Date("2024-01-15T09:30:00.000Z"),
- createdBy: "created_by",
+ createdBySubject: {
+ subjectDisplayName: "subject_display_name",
+ subjectId: "subject_id",
+ subjectType: "subject_type",
+ },
id: "id",
manifest: {
cron: "cron",
@@ -436,7 +468,11 @@ describe("SchedulesClient", () => {
data: {
agent_name: "agent_name",
created_at: "2024-01-15T09:30:00Z",
- created_by: "created_by",
+ created_by_subject: {
+ subject_display_name: "subject_display_name",
+ subject_id: "subject_id",
+ subject_type: "subject_type",
+ },
id: "id",
manifest: { cron: "cron", status: "active", task: "task", timezone: "timezone" },
name: "name",
@@ -464,7 +500,11 @@ describe("SchedulesClient", () => {
data: {
agentName: "agent_name",
createdAt: new Date("2024-01-15T09:30:00.000Z"),
- createdBy: "created_by",
+ createdBySubject: {
+ subjectDisplayName: "subject_display_name",
+ subjectId: "subject_id",
+ subjectType: "subject_type",
+ },
id: "id",
manifest: {
cron: "cron",
@@ -646,13 +686,17 @@ describe("SchedulesClient", () => {
data: [
{
created_at: "2024-01-15T09:30:00Z",
+ created_by_subject: {
+ subject_display_name: "subject_display_name",
+ subject_id: "subject_id",
+ subject_type: "subject_type",
+ },
id: "id",
name: "name",
schedule_id: "schedule_id",
scheduled_for: "2024-01-15T09:30:00Z",
status: "scheduled",
triggered_at: "2024-01-15T09:30:00Z",
- triggered_by: "triggered_by",
updated_at: "2024-01-15T09:30:00Z",
},
],
@@ -671,13 +715,17 @@ describe("SchedulesClient", () => {
data: [
{
createdAt: new Date("2024-01-15T09:30:00.000Z"),
+ createdBySubject: {
+ subjectDisplayName: "subject_display_name",
+ subjectId: "subject_id",
+ subjectType: "subject_type",
+ },
id: "id",
name: "name",
scheduleId: "schedule_id",
scheduledFor: new Date("2024-01-15T09:30:00.000Z"),
status: "scheduled",
triggeredAt: new Date("2024-01-15T09:30:00.000Z"),
- triggeredBy: "triggered_by",
updatedAt: new Date("2024-01-15T09:30:00.000Z"),
},
],
diff --git a/packages/trueforge-sdk/tests/wire/sessions.test.ts b/packages/trueforge-sdk/tests/wire/sessions.test.ts
index 61c88dc19..8eb56f9f9 100644
--- a/packages/trueforge-sdk/tests/wire/sessions.test.ts
+++ b/packages/trueforge-sdk/tests/wire/sessions.test.ts
@@ -14,7 +14,11 @@ describe("SessionsClient", () => {
{
agent: { spec: { model: { name: "name" } }, type: "inline" },
created_at: "created_at",
- created_by: "created_by",
+ created_by_subject: {
+ subject_display_name: "subject_display_name",
+ subject_id: "subject_id",
+ subject_type: "subject_type",
+ },
id: "id",
metadata: { key: "value" },
metrics: { total_cost_in_usd: 1.1, total_duration_ms: 1, total_turns: 1 },
@@ -45,7 +49,11 @@ describe("SessionsClient", () => {
type: "inline",
},
createdAt: "created_at",
- createdBy: "created_by",
+ createdBySubject: {
+ subjectDisplayName: "subject_display_name",
+ subjectId: "subject_id",
+ subjectType: "subject_type",
+ },
id: "id",
metadata: {
key: "value",
@@ -94,7 +102,11 @@ describe("SessionsClient", () => {
data: {
agent: { spec: { model: { name: "name" } }, type: "inline" },
created_at: "created_at",
- created_by: "created_by",
+ created_by_subject: {
+ subject_display_name: "subject_display_name",
+ subject_id: "subject_id",
+ subject_type: "subject_type",
+ },
id: "id",
metadata: { key: "value" },
metrics: { total_cost_in_usd: 1.1, total_duration_ms: 1, total_turns: 1 },
@@ -128,7 +140,11 @@ describe("SessionsClient", () => {
type: "inline",
},
createdAt: "created_at",
- createdBy: "created_by",
+ createdBySubject: {
+ subjectDisplayName: "subject_display_name",
+ subjectId: "subject_id",
+ subjectType: "subject_type",
+ },
id: "id",
metadata: {
key: "value",
@@ -224,7 +240,11 @@ describe("SessionsClient", () => {
data: {
agent: { spec: { model: { name: "name" } }, type: "inline" },
created_at: "created_at",
- created_by: "created_by",
+ created_by_subject: {
+ subject_display_name: "subject_display_name",
+ subject_id: "subject_id",
+ subject_type: "subject_type",
+ },
id: "id",
metadata: { key: "value" },
metrics: { total_cost_in_usd: 1.1, total_duration_ms: 1, total_turns: 1 },
@@ -253,7 +273,11 @@ describe("SessionsClient", () => {
type: "inline",
},
createdAt: "created_at",
- createdBy: "created_by",
+ createdBySubject: {
+ subjectDisplayName: "subject_display_name",
+ subjectId: "subject_id",
+ subjectType: "subject_type",
+ },
id: "id",
metadata: {
key: "value",
@@ -344,7 +368,11 @@ describe("SessionsClient", () => {
data: {
agent: { spec: { model: { name: "name" } }, type: "inline" },
created_at: "created_at",
- created_by: "created_by",
+ created_by_subject: {
+ subject_display_name: "subject_display_name",
+ subject_id: "subject_id",
+ subject_type: "subject_type",
+ },
id: "id",
metadata: { key: "value" },
metrics: { total_cost_in_usd: 1.1, total_duration_ms: 1, total_turns: 1 },
@@ -374,7 +402,11 @@ describe("SessionsClient", () => {
type: "inline",
},
createdAt: "created_at",
- createdBy: "created_by",
+ createdBySubject: {
+ subjectDisplayName: "subject_display_name",
+ subjectId: "subject_id",
+ subjectType: "subject_type",
+ },
id: "id",
metadata: {
key: "value",
diff --git a/packages/trueforge-ui/src/plugins/trueforge-agent-server-adapter/schedules/scheduleServer.ts b/packages/trueforge-ui/src/plugins/trueforge-agent-server-adapter/schedules/scheduleServer.ts
index 895e28a9e..ea84df791 100644
--- a/packages/trueforge-ui/src/plugins/trueforge-agent-server-adapter/schedules/scheduleServer.ts
+++ b/packages/trueforge-ui/src/plugins/trueforge-agent-server-adapter/schedules/scheduleServer.ts
@@ -98,7 +98,7 @@ function toUiScheduleRun(wire: TrueForgeApi.ScheduleRun): ScheduleRun {
scheduledFor: toIsoInstant(wire.scheduledFor),
status: wire.status,
triggeredAt: wire.triggeredAt == null ? null : toIsoInstant(wire.triggeredAt),
- triggeredBy: wire.triggeredBy,
+ triggeredBy: wire.createdBySubject.subjectDisplayName || wire.createdBySubject.subjectId,
};
}
diff --git a/packages/trueforge-ui/test/plugins/trueforge-agent-server-adapter/scheduleServer.test.ts b/packages/trueforge-ui/test/plugins/trueforge-agent-server-adapter/scheduleServer.test.ts
index f2530f9e8..96a1dcc39 100644
--- a/packages/trueforge-ui/test/plugins/trueforge-agent-server-adapter/scheduleServer.test.ts
+++ b/packages/trueforge-ui/test/plugins/trueforge-agent-server-adapter/scheduleServer.test.ts
@@ -112,7 +112,11 @@ describe('createScheduleServer schedule runs', () => {
scheduledFor: new Date('2024-06-01T12:00:00.000Z'),
status: 'triggered' as const,
triggeredAt: new Date('2024-06-01T12:00:01.000Z'),
- triggeredBy: 'alice',
+ createdBySubject: {
+ subjectId: 'alice',
+ subjectType: 'user',
+ subjectDisplayName: 'alice',
+ },
createdAt: new Date('2024-06-01T12:00:00.000Z'),
updatedAt: new Date('2024-06-01T12:00:01.000Z'),
};
diff --git a/packages/trueforge/src/apis/agents.ts b/packages/trueforge/src/apis/agents.ts
index 0bf65fe21..c17152971 100644
--- a/packages/trueforge/src/apis/agents.ts
+++ b/packages/trueforge/src/apis/agents.ts
@@ -4,7 +4,7 @@
import { OpenAPIHono, type RouteHandler } from '@hono/zod-openapi';
import type { AgentSpec } from '@truefoundry/trueforge-core/agent-session';
import type { Context } from 'hono';
-import type { ResolveRequestContext } from '../auth/identity';
+import { createdBySubjectFromRequestContext, type ResolveRequestContext } from '../auth/identity';
import { AgentNameConflictError, type AgentRecord, type IAgentStore } from '../db/agentStore';
import type { IMcpServerStore } from '../db/mcpServerStore';
import type { IModelProviderStore } from '../db/modelProviderStore';
@@ -39,6 +39,7 @@ function toWireAgent(record: AgentRecord): Agent {
id: record.id,
name: record.name,
manifest: record.manifest,
+ created_by_subject: record.created_by_subject,
};
}
@@ -89,6 +90,7 @@ export function createAgentsRouter<TTransaction>(deps: AgentsRouterDeps<TTransac
name: body.name,
manifest,
external_id: null,
+ created_by_subject: createdBySubjectFromRequestContext(requestContext),
});
return c.json({ data: toWireAgent(record) }, 201);
} catch (error) {
diff --git a/packages/trueforge/src/apis/schedules.ts b/packages/trueforge/src/apis/schedules.ts
index 5f5b5a13e..4f4f8e495 100644
--- a/packages/trueforge/src/apis/schedules.ts
+++ b/packages/trueforge/src/apis/schedules.ts
@@ -3,7 +3,12 @@
*/
import { OpenAPIHono, type RouteHandler } from '@hono/zod-openapi';
import { InvalidPageTokenError, type Sessions } from '@truefoundry/trueforge-core/agent-session';
-import { hasAdminRole, type RequestContext, type ResolveRequestContext } from '../auth/identity';
+import {
+ createdBySubjectFromRequestContext,
+ hasAdminRole,
+ type RequestContext,
+ type ResolveRequestContext,
+} from '../auth/identity';
import { ScheduleAgentNotFoundError, startScheduleRun } from '../controller/scheduleDispatch';
import type { IAgentStore } from '../db/agentStore';
import {
@@ -49,7 +54,7 @@ function toWireSchedule(record: ScheduleRecord): Schedule {
agent_name: record.agent_name,
name: record.name,
manifest: record.manifest,
- created_by: record.created_by,
+ created_by_subject: record.created_by_subject,
created_at: record.created_at,
updated_at: record.updated_at,
};
@@ -62,7 +67,7 @@ function toWireScheduleRun(record: ScheduleRunRecord): ScheduleRun {
name: record.name,
scheduled_for: record.scheduled_for,
status: record.status,
- triggered_by: record.triggered_by,
+ created_by_subject: record.created_by_subject,
triggered_at: record.triggered_at,
created_at: record.created_at,
updated_at: record.updated_at,
@@ -107,8 +112,11 @@ const FORBIDDEN_SCHEDULE_ACCESS = 'Only the schedule creator can access this sch
* Standalone auth stamps `roles: ['admin']` on the sole identity, which already
* owns everything it created — so admin bypass is a no-op there.
*/
-function canAccessSchedule(requestContext: Pick<RequestContext, 'roles' | 'subject'>, createdBy: string): boolean {
- return hasAdminRole(requestContext) || requestContext.subject.id === createdBy;
+function canAccessSchedule(
+ requestContext: Pick<RequestContext, 'roles' | 'subject'>,
+ created_by_subject_id: string,
+): boolean {
+ return hasAdminRole(requestContext) || requestContext.subject.id === created_by_subject_id;
}
export function createSchedulesRouter<TTransaction>(deps: SchedulesRouterDeps<TTransaction>) {
@@ -116,14 +124,14 @@ export function createSchedulesRouter<TTransaction>(deps: SchedulesRouterDeps<TT
const { agent_names: agentNames, limit, page_token: pageToken } = c.req.valid('query');
const requestContext = deps.resolveRequestContext(c);
// Admins see every schedule; a regular user is scoped to their own via the
- // store's `created_by` filter (never a client-supplied param).
+ // store's `created_by_subject_id` filter (never a client-supplied param).
try {
const { data, pagination } = await deps.scheduleStore.listSchedules({
tenant_id: requestContext.tenant_id,
limit,
page_token: pageToken,
agent_names: agentNames,
- created_by: hasAdminRole(requestContext) ? undefined : requestContext.subject.id,
+ created_by_subject_id: hasAdminRole(requestContext) ? undefined : requestContext.subject.id,
});
return c.json({ data: data.map(toWireSchedule), pagination }, 200);
} catch (error) {
@@ -144,7 +152,7 @@ export function createSchedulesRouter<TTransaction>(deps: SchedulesRouterDeps<TT
if (schedule === undefined) {
return c.json({ error: { message: `Schedule not found: ${scheduleId}` } }, 404);
}
- if (!canAccessSchedule(requestContext, schedule.created_by)) {
+ if (!canAccessSchedule(requestContext, schedule.created_by_subject.subject_id)) {
return c.json({ error: { message: FORBIDDEN_SCHEDULE_ACCESS } }, 403);
}
const records = await deps.scheduleStore.listRuns({
@@ -165,7 +173,7 @@ export function createSchedulesRouter<TTransaction>(deps: SchedulesRouterDeps<TT
if (schedule === undefined) {
return c.json({ error: { message: `Schedule not found: ${scheduleId}` } }, 404);
}
- if (!canAccessSchedule(requestContext, schedule.created_by)) {
+ if (!canAccessSchedule(requestContext, schedule.created_by_subject.subject_id)) {
return c.json({ error: { message: FORBIDDEN_SCHEDULE_ACCESS } }, 403);
}
@@ -178,7 +186,7 @@ export function createSchedulesRouter<TTransaction>(deps: SchedulesRouterDeps<TT
name: manualRunName(),
scheduled_for: now,
status: 'triggered',
- triggered_by: requestContext.subject.id,
+ created_by_subject: createdBySubjectFromRequestContext(requestContext),
triggered_at: now,
});
} catch (error) {
@@ -244,7 +252,7 @@ export function createSchedulesRouter<TTransaction>(deps: SchedulesRouterDeps<TT
agent_name: agent.name,
name: body.name,
manifest: body.manifest,
- created_by: requestContext.subject.id,
+ created_by_subject: createdBySubjectFromRequestContext(requestContext),
runFrom: new Date(),
},
transaction,
@@ -274,7 +282,7 @@ export function createSchedulesRouter<TTransaction>(deps: SchedulesRouterDeps<TT
if (record === undefined) {
return c.json({ error: { message: `Schedule not found: ${scheduleId}` } }, 404);
}
- if (!canAccessSchedule(requestContext, record.created_by)) {
+ if (!canAccessSchedule(requestContext, record.created_by_subject.subject_id)) {
return c.json({ error: { message: FORBIDDEN_SCHEDULE_ACCESS } }, 403);
}
return c.json({ data: toWireSchedule(record) }, 200);
@@ -304,7 +312,7 @@ export function createSchedulesRouter<TTransaction>(deps: SchedulesRouterDeps<TT
if (existing === undefined) {
return c.json({ error: { message: `Schedule not found: ${scheduleId}` } }, 404);
}
- if (!canAccessSchedule(requestContext, existing.created_by)) {
+ if (!canAccessSchedule(requestContext, existing.created_by_subject.subject_id)) {
return c.json({ error: { message: FORBIDDEN_SCHEDULE_ACCESS } }, 403);
}
@@ -349,7 +357,7 @@ export function createSchedulesRouter<TTransaction>(deps: SchedulesRouterDeps<TT
if (record === undefined) {
return c.json({}, 200);
}
- if (!canAccessSchedule(requestContext, record.created_by)) {
+ if (!canAccessSchedule(requestContext, record.created_by_subject.subject_id)) {
return c.json({ error: { message: FORBIDDEN_SCHEDULE_ACCESS } }, 403);
}
await deps.scheduleStore.deleteSchedule({
diff --git a/packages/trueforge/src/apis/sessionMetrics.ts b/packages/trueforge/src/apis/sessionMetrics.ts
index c3a4181ac..fcbcf05c9 100644
--- a/packages/trueforge/src/apis/sessionMetrics.ts
+++ b/packages/trueforge/src/apis/sessionMetrics.ts
@@ -24,7 +24,7 @@ export function createInternalMetricsRouter(deps: InternalMetricsRouterDeps) {
const metrics = await deps.sessionMetricsStore.getSessionMetricsMeters({
tenant_id: requestContext.tenant_id,
agent_id: query.agent_id,
- created_by: requestContext.subject.id,
+ created_by_subject_id: requestContext.subject.id,
start_timestamp: query.start_timestamp,
end_timestamp: query.end_timestamp,
});
@@ -41,7 +41,7 @@ export function createInternalMetricsRouter(deps: InternalMetricsRouterDeps) {
const chartData = await deps.sessionMetricsStore.getSessionMetricsChartData({
tenant_id: requestContext.tenant_id,
agent_id: query.agent_id,
- created_by: requestContext.subject.id,
+ created_by_subject_id: requestContext.subject.id,
start_timestamp: query.start_timestamp,
end_timestamp: query.end_timestamp,
chart_name: query.chart_name,
diff --git a/packages/trueforge/src/apis/sessions.ts b/packages/trueforge/src/apis/sessions.ts
index d38dd691e..54e6451c3 100644
--- a/packages/trueforge/src/apis/sessions.ts
+++ b/packages/trueforge/src/apis/sessions.ts
@@ -21,7 +21,7 @@ import type { Context } from 'hono';
import type { RedisClientType } from 'redis';
import type { Logger } from 'winston';
import { z } from 'zod';
-import type { ResolveRequestContext } from '../auth/identity';
+import { createdBySubjectFromRequestContext, type ResolveRequestContext } from '../auth/identity';
import configuration from '../config';
import type { IAgentStore } from '../db/agentStore';
import type { IMcpServerStore } from '../db/mcpServerStore';
@@ -60,7 +60,7 @@ export function toWireSession(record: SessionRecord): Session {
id: record.session_id,
agent: record.agent,
title: record.title,
- created_by: record.created_by,
+ created_by_subject: record.created_by_subject,
created_at: record.created_at.toISOString(),
updated_at: record.updated_at.toISOString(),
metrics: record.metrics,
@@ -214,8 +214,14 @@ async function freezeTurnIgnoringMissing(
const FORBIDDEN_SESSION_ACCESS = 'Only the session creator can access this session';
-function checkSessionAccess({ subject_id, createdBy }: { subject_id: string; createdBy: string }): boolean {
- return subject_id === createdBy;
+function checkSessionAccess({
+ subject_id,
+ created_by_subject,
+}: {
+ subject_id: string;
+ created_by_subject: { subject_id: string };
+}): boolean {
+ return subject_id === created_by_subject.subject_id;
}
type InternalSessionsRouterDeps = Pick<
@@ -241,7 +247,12 @@ function createGetOrCreateSessionByExternalIdHandler(
external_id: body.external_id,
});
if (existing !== undefined) {
- if (!checkSessionAccess({ subject_id: requestContext.subject.id, createdBy: existing.record.created_by })) {
+ if (
+ !checkSessionAccess({
+ subject_id: requestContext.subject.id,
+ created_by_subject: existing.record.created_by_subject,
+ })
+ ) {
return c.json({ error: { message: FORBIDDEN_SESSION_ACCESS } }, 403);
}
return c.json({ data: toWireSession(existing.record) }, 200);
@@ -272,12 +283,15 @@ function createGetOrCreateSessionByExternalIdHandler(
const { session, created } = await deps.sessions.getOrCreateByExternalId({
tenant_id: requestContext.tenant_id,
external_id: body.external_id,
- created_by: requestContext.subject.id,
+ created_by_subject: createdBySubjectFromRequestContext(requestContext),
agent,
});
if (
!created &&
- !checkSessionAccess({ subject_id: requestContext.subject.id, createdBy: session.record.created_by })
+ !checkSessionAccess({
+ subject_id: requestContext.subject.id,
+ created_by_subject: session.record.created_by_subject,
+ })
) {
return c.json({ error: { message: FORBIDDEN_SESSION_ACCESS } }, 403);
}
@@ -310,7 +324,7 @@ export function createSessionsRouter(deps: SessionsRouterDeps) {
const session = await deps.sessions.create({
tenant_id: requestContext.tenant_id,
session_id: sessionId,
- created_by: requestContext.subject.id,
+ created_by_subject: createdBySubjectFromRequestContext(requestContext),
agent: { type: 'reference', id: agent.id, name: agent.name },
metadata: body.metadata,
external_id: null,
@@ -329,7 +343,7 @@ export function createSessionsRouter(deps: SessionsRouterDeps) {
const session = await deps.sessions.create({
tenant_id: requestContext.tenant_id,
session_id: sessionId,
- created_by: requestContext.subject.id,
+ created_by_subject: createdBySubjectFromRequestContext(requestContext),
agent: { type: 'inline', spec: body.agent.spec },
metadata: body.metadata,
external_id: null,
@@ -347,7 +361,12 @@ export function createSessionsRouter(deps: SessionsRouterDeps) {
if (!record) {
return c.json({ error: { message: `Session not found: ${sessionId}` } }, 404);
}
- if (!checkSessionAccess({ subject_id: requestContext.subject.id, createdBy: record.created_by })) {
+ if (
+ !checkSessionAccess({
+ subject_id: requestContext.subject.id,
+ created_by_subject: record.created_by_subject,
+ })
+ ) {
return c.json({ error: { message: FORBIDDEN_SESSION_ACCESS } }, 403);
}
return c.json({ data: toWireSession(record) }, 200);
@@ -364,7 +383,12 @@ export function createSessionsRouter(deps: SessionsRouterDeps) {
// Idempotent delete when already gone.
return c.body(null, 204);
}
- if (!checkSessionAccess({ subject_id: requestContext.subject.id, createdBy: record.created_by })) {
+ if (
+ !checkSessionAccess({
+ subject_id: requestContext.subject.id,
+ created_by_subject: record.created_by_subject,
+ })
+ ) {
return c.json({ error: { message: FORBIDDEN_SESSION_ACCESS } }, 403);
}
await deps.sessionStore.deleteSession({
@@ -385,7 +409,12 @@ export function createSessionsRouter(deps: SessionsRouterDeps) {
if (!existing) {
return c.json({ error: { message: `Session not found: ${sessionId}` } }, 404);
}
- if (!checkSessionAccess({ subject_id: requestContext.subject.id, createdBy: existing.created_by })) {
+ if (
+ !checkSessionAccess({
+ subject_id: requestContext.subject.id,
+ created_by_subject: existing.created_by_subject,
+ })
+ ) {
return c.json({ error: { message: FORBIDDEN_SESSION_ACCESS } }, 403);
}
// Inline sessions may replace their agent; named (reference) sessions
@@ -433,7 +462,7 @@ export function createSessionsRouter(deps: SessionsRouterDeps) {
try {
const { data, pagination } = await deps.sessionStore.listSessions({
agent_id: query.agent_id,
- created_by: requestContext.subject.id,
+ created_by_subject_id: requestContext.subject.id,
tenant_id: requestContext.tenant_id,
limit: query.limit,
order: query.order,
@@ -460,7 +489,12 @@ export function createSessionsRouter(deps: SessionsRouterDeps) {
if (!session) {
return c.json({ error: { message: `Session not found: ${sessionId}` } }, 404);
}
- if (!checkSessionAccess({ subject_id: requestContext.subject.id, createdBy: session.record.created_by })) {
+ if (
+ !checkSessionAccess({
+ subject_id: requestContext.subject.id,
+ created_by_subject: session.record.created_by_subject,
+ })
+ ) {
return c.json({ error: { message: FORBIDDEN_SESSION_ACCESS } }, 403);
}
const turnId = session.record.last_turn_id;
@@ -483,7 +517,12 @@ export function createSessionsRouter(deps: SessionsRouterDeps) {
if (!session) {
return c.json({ error: { message: `Session not found: ${sessionId}` } }, 404);
}
- if (!checkSessionAccess({ subject_id: requestContext.subject.id, createdBy: session.record.created_by })) {
+ if (
+ !checkSessionAccess({
+ subject_id: requestContext.subject.id,
+ created_by_subject: session.record.created_by_subject,
+ })
+ ) {
return c.json({ error: { message: FORBIDDEN_SESSION_ACCESS } }, 403);
}
try {
diff --git a/packages/trueforge/src/apis/turns.ts b/packages/trueforge/src/apis/turns.ts
index 68cb78f5e..a04b538c5 100644
--- a/packages/trueforge/src/apis/turns.ts
+++ b/packages/trueforge/src/apis/turns.ts
@@ -508,9 +508,15 @@ export function resolveAfterSequenceNumber(c: Context, bodyAfterSequenceNumber?:
return bodyAfterSequenceNumber;
}
-/** True when the subject is the session creator (`created_by`). */
-function checkTurnAccess({ subject_id, createdBy }: { subject_id: string; createdBy: string }): boolean {
- return createdBy === subject_id;
+/** True when the subject is the session creator (`created_by_subject.subject_id`). */
+function checkTurnAccess({
+ subject_id,
+ created_by_subject,
+}: {
+ subject_id: string;
+ created_by_subject: { subject_id: string };
+}): boolean {
+ return created_by_subject.subject_id === subject_id;
}
const FORBIDDEN_SESSION_ACCESS = 'Only the session creator can access this session';
@@ -532,7 +538,7 @@ export function createTurnsRouter(deps: TurnsRouterDeps) {
if (
!checkTurnAccess({
subject_id: requestContext.subject.id,
- createdBy: session.record.created_by,
+ created_by_subject: session.record.created_by_subject,
})
) {
return c.json({ error: { message: FORBIDDEN_SESSION_ACCESS } }, 403);
@@ -564,7 +570,7 @@ export function createTurnsRouter(deps: TurnsRouterDeps) {
if (
!checkTurnAccess({
subject_id: requestContext.subject.id,
- createdBy: session.record.created_by,
+ created_by_subject: session.record.created_by_subject,
})
) {
return c.json({ error: { message: FORBIDDEN_SESSION_ACCESS } }, 403);
@@ -596,7 +602,7 @@ export function createTurnsRouter(deps: TurnsRouterDeps) {
if (
!checkTurnAccess({
subject_id: requestContext.subject.id,
- createdBy: session.record.created_by,
+ created_by_subject: session.record.created_by_subject,
})
) {
return c.json({ error: { message: FORBIDDEN_SESSION_ACCESS } }, 403);
@@ -661,7 +667,7 @@ export function createTurnsRouter(deps: TurnsRouterDeps) {
if (
!checkTurnAccess({
subject_id: requestContext.subject.id,
- createdBy: session.record.created_by,
+ created_by_subject: session.record.created_by_subject,
})
) {
return c.json({ error: { message: FORBIDDEN_SESSION_ACCESS } }, 403);
@@ -700,7 +706,7 @@ export function createTurnsRouter(deps: TurnsRouterDeps) {
if (
!checkTurnAccess({
subject_id: requestContext.subject.id,
- createdBy: session.record.created_by,
+ created_by_subject: session.record.created_by_subject,
})
) {
return c.json({ error: { message: FORBIDDEN_CREATE_TURN } }, 403);
@@ -772,7 +778,7 @@ export function createTurnsRouter(deps: TurnsRouterDeps) {
if (
!checkTurnAccess({
subject_id: requestContext.subject.id,
- createdBy: session.record.created_by,
+ created_by_subject: session.record.created_by_subject,
})
) {
return c.json({ error: { message: FORBIDDEN_SESSION_ACCESS } }, 403);
diff --git a/packages/trueforge/src/auth/identity.ts b/packages/trueforge/src/auth/identity.ts
index 9761e3530..26fe48f7f 100644
--- a/packages/trueforge/src/auth/identity.ts
+++ b/packages/trueforge/src/auth/identity.ts
@@ -1,3 +1,4 @@
+import type { CreatedBySubject } from '@truefoundry/trueforge-core/agent-session';
import type { Context } from 'hono';
import configuration, { getTrueForgeMode, isOidcConfigured, TrueForgeMode } from '../config';
@@ -71,3 +72,12 @@ export function hasAdminRole(requestContext: Pick<RequestContext, 'roles'>): boo
return requestContext.roles.includes(STANDALONE_ADMIN_ROLE);
}
}
+
+/** Persistable creator snapshot derived from the authenticated request. */
+export function createdBySubjectFromRequestContext(ctx: RequestContext): CreatedBySubject {
+ return {
+ subject_id: ctx.subject.id,
+ subject_type: ctx.subject.type,
+ subject_display_name: ctx.subject.display_name,
+ };
+}
diff --git a/packages/trueforge/src/controller/scheduleDispatch.ts b/packages/trueforge/src/controller/scheduleDispatch.ts
index fa92d2f2e..a4ec54af5 100644
--- a/packages/trueforge/src/controller/scheduleDispatch.ts
+++ b/packages/trueforge/src/controller/scheduleDispatch.ts
@@ -105,7 +105,7 @@ export async function startScheduleRun(params: {
const { session } = await sessions.getOrCreateByExternalId({
tenant_id: schedule.tenant_id,
external_id: run.id,
- created_by: schedule.created_by,
+ created_by_subject: schedule.created_by_subject,
agent: { type: 'reference', id: named.id, name: named.name },
});
@@ -119,7 +119,7 @@ export async function startScheduleRun(params: {
session,
input: [{ type: 'user.message', content: schedule.manifest.task }],
previous_turn_id: 'none',
- userRef: schedule.created_by,
+ userRef: schedule.created_by_subject.subject_id,
});
}
@@ -180,7 +180,7 @@ async function finishScheduledRun<TTransaction>(params: {
name: cronRunName(nextTrigger),
scheduled_for: nextTrigger,
status: 'scheduled',
- triggered_by: latest.created_by,
+ created_by_subject: latest.created_by_subject,
},
txn,
);
diff --git a/packages/trueforge/src/db/agentStore.ts b/packages/trueforge/src/db/agentStore.ts
index abc16dd76..f043b53f3 100644
--- a/packages/trueforge/src/db/agentStore.ts
+++ b/packages/trueforge/src/db/agentStore.ts
@@ -4,7 +4,7 @@
* `AgentSpec` jsonb document.
* Implementations: PostgresAgentStore and SqliteAgentStore.
*/
-import { AgentSpecSchema, type AgentSpec } from '@truefoundry/trueforge-core/agent-session';
+import { AgentSpecSchema, type AgentSpec, type CreatedBySubject } from '@truefoundry/trueforge-core/agent-session';
import type { ResourceName } from '../schemas/common';
export interface AgentRecord {
@@ -13,6 +13,7 @@ export interface AgentRecord {
name: ResourceName;
manifest: AgentSpec;
external_id: string | null;
+ created_by_subject: CreatedBySubject;
/** ISO-8601 UTC instant. */
created_at: string;
/** ISO-8601 UTC instant. */
@@ -35,6 +36,7 @@ export interface CreateAgentInput {
name: ResourceName;
manifest: AgentSpec;
external_id: string | null;
+ created_by_subject: CreatedBySubject;
}
/**
diff --git a/packages/trueforge/src/db/createdBySubject.ts b/packages/trueforge/src/db/createdBySubject.ts
new file mode 100644
index 000000000..2ce4679c6
--- /dev/null
+++ b/packages/trueforge/src/db/createdBySubject.ts
@@ -0,0 +1,6 @@
+import { CreatedBySubjectSchema, type CreatedBySubject } from '@truefoundry/trueforge-core/agent-session';
+
+/** Re-parse persisted creator JSON so store readers validate on read. */
+export function parseStoredCreatedBySubject(value: unknown): CreatedBySubject {
+ return CreatedBySubjectSchema.parse(value);
+}
diff --git a/packages/trueforge/src/db/indexes.ts b/packages/trueforge/src/db/indexes.ts
index 06720ebb7..410c2d59f 100644
--- a/packages/trueforge/src/db/indexes.ts
+++ b/packages/trueforge/src/db/indexes.ts
@@ -3,3 +3,15 @@ export const SESSION_EXTERNAL_ID_UQ = 'session_external_id_uq';
/** Partial unique index on `agent (tenant_id, external_id) WHERE external_id IS NOT NULL`. */
export const AGENT_EXTERNAL_ID_UQ = 'agent_external_id_uq';
+
+/** `(tenant_id, created_by_subject.subject_id)` on agent. */
+export const AGENT_CREATED_BY_SUBJECT_ID_IDX = 'agent_created_by_subject_id_idx';
+
+/** `(tenant_id, created_by_subject.subject_id)` on session. */
+export const SESSION_CREATED_BY_SUBJECT_ID_IDX = 'session_created_by_subject_id_idx';
+
+/** `(tenant_id, created_by_subject.subject_id)` on schedule. */
+export const SCHEDULE_CREATED_BY_SUBJECT_ID_IDX = 'schedule_created_by_subject_id_idx';
+
+/** `(tenant_id, created_by_subject.subject_id)` on schedule_run. */
+export const SCHEDULE_RUN_CREATED_BY_SUBJECT_ID_IDX = 'schedule_run_created_by_subject_id_idx';
diff --git a/packages/trueforge/src/db/postgres/agent-store/PostgresAgentStore.ts b/packages/trueforge/src/db/postgres/agent-store/PostgresAgentStore.ts
index 629c30c79..b32e4fbdc 100644
--- a/packages/trueforge/src/db/postgres/agent-store/PostgresAgentStore.ts
+++ b/packages/trueforge/src/db/postgres/agent-store/PostgresAgentStore.ts
@@ -11,6 +11,7 @@ import {
type IAgentStore,
type UpdateAgentInput,
} from '../../agentStore';
+import { parseStoredCreatedBySubject } from '../../createdBySubject';
import { AGENT_EXTERNAL_ID_UQ } from '../../indexes';
import { isPgConstraint, isUniqueViolation } from '../client';
import { json, now } from '../sqlExpressions';
@@ -23,6 +24,7 @@ function toRecord(row: Selectable<AgentTable>): AgentRecord {
name: row.name,
manifest: parseStoredAgentSpec(row.manifest),
external_id: row.external_id,
+ created_by_subject: parseStoredCreatedBySubject(row.created_by_subject),
created_at: row.created_at.toISOString(),
updated_at: row.updated_at.toISOString(),
};
@@ -82,6 +84,7 @@ export class PostgresAgentStore implements IAgentStore<Transaction<Database>> {
name: input.name,
manifest: json(input.manifest),
external_id: input.external_id,
+ created_by_subject: json(input.created_by_subject),
created_at: now(),
updated_at: now(),
})
diff --git a/packages/trueforge/src/db/postgres/migrations/20260903_000002_created_by_subject.ts b/packages/trueforge/src/db/postgres/migrations/20260903_000002_created_by_subject.ts
new file mode 100644
index 000000000..9151bbb91
--- /dev/null
+++ b/packages/trueforge/src/db/postgres/migrations/20260903_000002_created_by_subject.ts
@@ -0,0 +1,110 @@
+import { sql, type Kysely } from 'kysely';
+import {
+ AGENT_CREATED_BY_SUBJECT_ID_IDX,
+ SCHEDULE_CREATED_BY_SUBJECT_ID_IDX,
+ SCHEDULE_RUN_CREATED_BY_SUBJECT_ID_IDX,
+ SESSION_CREATED_BY_SUBJECT_ID_IDX,
+} from '../../indexes';
+
+/**
+ * Add `created_by_subject` jsonb on agent, session, schedule, and schedule_run.
+ * Backfills session/schedule/schedule_run from created_by/triggered_by;
+ * agent backfills best-effort from its first created session (fallback: trueforge-default).
+ * Runs inside the Migrator's transaction — do not nest `db.transaction()`.
+ */
+export async function up(db: Kysely<unknown>): Promise<void> {
+ await sql`
+ SET LOCAL lock_timeout = '5s';
+
+ ALTER TABLE session
+ ADD COLUMN created_by_subject jsonb;
+ UPDATE session
+ SET created_by_subject = jsonb_build_object(
+ 'subject_id', CASE WHEN created_by = '' THEN 'trueforge-default' ELSE created_by END,
+ 'subject_type', 'user',
+ 'subject_display_name', CASE WHEN created_by = '' THEN 'trueforge-default' ELSE created_by END
+ );
+ ALTER TABLE session
+ ALTER COLUMN created_by_subject SET NOT NULL;
+ ALTER TABLE session DROP COLUMN created_by;
+ CREATE INDEX ${sql.raw(SESSION_CREATED_BY_SUBJECT_ID_IDX)}
+ ON session (tenant_id, (created_by_subject->>'subject_id'));
+
+ ALTER TABLE agent
+ ADD COLUMN created_by_subject jsonb;
+ UPDATE agent AS a
+ SET created_by_subject = COALESCE(
+ (
+ SELECT s.created_by_subject
+ FROM session AS s
+ WHERE s.tenant_id = a.tenant_id
+ AND (s.agent_id = a.id OR (s.agent_id IS NULL AND s.agent_name = a.name))
+ ORDER BY s.created_at ASC
+ LIMIT 1
+ ),
+ '{"subject_id":"trueforge-default","subject_type":"user","subject_display_name":"trueforge-default"}'::jsonb
+ );
+ ALTER TABLE agent
+ ALTER COLUMN created_by_subject SET NOT NULL;
+ CREATE INDEX ${sql.raw(AGENT_CREATED_BY_SUBJECT_ID_IDX)}
+ ON agent (tenant_id, (created_by_subject->>'subject_id'));
+
+ ALTER TABLE schedule
+ ADD COLUMN created_by_subject jsonb;
+ UPDATE schedule
+ SET created_by_subject = jsonb_build_object(
+ 'subject_id', CASE WHEN created_by = '' THEN 'trueforge-default' ELSE created_by END,
+ 'subject_type', 'user',
+ 'subject_display_name', CASE WHEN created_by = '' THEN 'trueforge-default' ELSE created_by END
+ );
+ ALTER TABLE schedule
+ ALTER COLUMN created_by_subject SET NOT NULL;
+ ALTER TABLE schedule DROP COLUMN created_by;
+ CREATE INDEX ${sql.raw(SCHEDULE_CREATED_BY_SUBJECT_ID_IDX)}
+ ON schedule (tenant_id, (created_by_subject->>'subject_id'));
+
+ ALTER TABLE schedule_run
+ ADD COLUMN created_by_subject jsonb;
+ UPDATE schedule_run
+ SET created_by_subject = jsonb_build_object(
+ 'subject_id', CASE WHEN triggered_by = '' THEN 'trueforge-default' ELSE triggered_by END,
+ 'subject_type', 'user',
+ 'subject_display_name', CASE WHEN triggered_by = '' THEN 'trueforge-default' ELSE triggered_by END
+ );
+ ALTER TABLE schedule_run
+ ALTER COLUMN created_by_subject SET NOT NULL;
+ ALTER TABLE schedule_run DROP COLUMN triggered_by;
+ CREATE INDEX ${sql.raw(SCHEDULE_RUN_CREATED_BY_SUBJECT_ID_IDX)}
+ ON schedule_run (tenant_id, (created_by_subject->>'subject_id'));
+ `.execute(db);
+}
+
+export async function down(db: Kysely<unknown>): Promise<void> {
+ await sql`
+ SET LOCAL lock_timeout = '5s';
+
+ DROP INDEX IF EXISTS ${sql.raw(SCHEDULE_RUN_CREATED_BY_SUBJECT_ID_IDX)};
+ ALTER TABLE schedule_run
+ ADD COLUMN triggered_by text NOT NULL DEFAULT '';
+ UPDATE schedule_run
+ SET triggered_by = COALESCE(created_by_subject->>'subject_id', '');
+ ALTER TABLE schedule_run DROP COLUMN created_by_subject;
+
+ DROP INDEX IF EXISTS ${sql.raw(SCHEDULE_CREATED_BY_SUBJECT_ID_IDX)};
+ ALTER TABLE schedule
+ ADD COLUMN created_by text NOT NULL DEFAULT '';
+ UPDATE schedule
+ SET created_by = COALESCE(created_by_subject->>'subject_id', '');
+ ALTER TABLE schedule DROP COLUMN created_by_subject;
+
+ DROP INDEX IF EXISTS ${sql.raw(AGENT_CREATED_BY_SUBJECT_ID_IDX)};
+ ALTER TABLE agent DROP COLUMN IF EXISTS created_by_subject;
+
+ DROP INDEX IF EXISTS ${sql.raw(SESSION_CREATED_BY_SUBJECT_ID_IDX)};
+ ALTER TABLE session
+ ADD COLUMN created_by text NOT NULL DEFAULT '';
+ UPDATE session
+ SET created_by = COALESCE(created_by_subject->>'subject_id', '');
+ ALTER TABLE session DROP COLUMN created_by_subject;
+ `.execute(db);
+}
diff --git a/packages/trueforge/src/db/postgres/schedule-store/PostgresScheduleStore.ts b/packages/trueforge/src/db/postgres/schedule-store/PostgresScheduleStore.ts
index e32a1af7f..70f1c8e6c 100644
--- a/packages/trueforge/src/db/postgres/schedule-store/PostgresScheduleStore.ts
+++ b/packages/trueforge/src/db/postgres/schedule-store/PostgresScheduleStore.ts
@@ -3,9 +3,10 @@ import {
decodeOffsetPageToken,
paginateOffsetRows,
} from '@truefoundry/trueforge-core/agent-session/store/OffsetPageToken';
-import type { Kysely, Selectable, Transaction } from 'kysely';
+import { sql, type Kysely, type Selectable, type Transaction } from 'kysely';
import { nextTriggerAfter } from '../../../runtime/cron';
import { newId } from '../../../utils/id';
+import { parseStoredCreatedBySubject } from '../../createdBySubject';
import {
cronRunName,
parseStoredScheduleManifest,
@@ -40,7 +41,7 @@ function toScheduleRecord(row: Selectable<ScheduleTable>): ScheduleRecord {
name: row.name,
manifest: parseStoredScheduleManifest(row.manifest),
status: row.status,
- created_by: row.created_by,
+ created_by_subject: parseStoredCreatedBySubject(row.created_by_subject),
created_at: row.created_at.toISOString(),
updated_at: row.updated_at.toISOString(),
};
@@ -54,7 +55,7 @@ function toRunRecord(row: Selectable<ScheduleRunTable>): ScheduleRunRecord {
name: row.name,
scheduled_for: row.scheduled_for.toISOString(),
status: row.status,
- triggered_by: row.triggered_by,
+ created_by_subject: parseStoredCreatedBySubject(row.created_by_subject),
triggered_at: row.triggered_at === null ? null : row.triggered_at.toISOString(),
created_at: row.created_at.toISOString(),
updated_at: row.updated_at.toISOString(),
@@ -96,7 +97,7 @@ export class PostgresScheduleStore implements IScheduleStore<Transaction<Databas
name: cronRunName(nextTrigger),
scheduled_for: nextTrigger,
status: 'scheduled',
- triggered_by: schedule.created_by,
+ created_by_subject: schedule.created_by_subject,
},
transaction,
);
@@ -144,7 +145,7 @@ export class PostgresScheduleStore implements IScheduleStore<Transaction<Databas
manifest: json(input.manifest),
// Column mirrors the manifest so the dispatch scan and API reads share one value.
status: input.manifest.status,
- created_by: input.created_by,
+ created_by_subject: json(input.created_by_subject),
created_at: now(),
updated_at: now(),
})
@@ -227,8 +228,8 @@ export class PostgresScheduleStore implements IScheduleStore<Transaction<Databas
if (input.agent_names !== undefined) {
query = query.where('agent_name', 'in', [...input.agent_names]);
}
- if (input.created_by !== undefined) {
- query = query.where('created_by', '=', input.created_by);
+ if (input.created_by_subject_id !== undefined) {
+ query = query.where(sql`created_by_subject->>'subject_id'`, '=', input.created_by_subject_id);
}
const rows = await query
.orderBy('created_at', 'desc')
@@ -291,7 +292,7 @@ export class PostgresScheduleStore implements IScheduleStore<Transaction<Databas
name: input.name,
scheduled_for: input.scheduled_for,
status: input.status,
- triggered_by: input.triggered_by,
+ created_by_subject: json(input.created_by_subject),
triggered_at: input.triggered_at ?? null,
created_at: now(),
updated_at: now(),
diff --git a/packages/trueforge/src/db/postgres/session-metrics/queries.ts b/packages/trueforge/src/db/postgres/session-metrics/queries.ts
index 4a24b5afa..14bfcdf3e 100644
--- a/packages/trueforge/src/db/postgres/session-metrics/queries.ts
+++ b/packages/trueforge/src/db/postgres/session-metrics/queries.ts
@@ -45,7 +45,7 @@ async function fetchSessionMetricsAggregate(
])
.where('tenant_id', '=', input.tenant_id)
.where('agent_id', '=', input.agent_id)
- .where('created_by', '=', input.created_by)
+ .where(sql`created_by_subject->>'subject_id'`, '=', input.created_by_subject_id)
.where('created_at', '>=', input.start_timestamp)
.where('created_at', '<=', input.end_timestamp)
.executeTakeFirstOrThrow();
@@ -83,7 +83,7 @@ async function fetchSessionMetricsBuckets(
])
.where('tenant_id', '=', input.tenant_id)
.where('agent_id', '=', input.agent_id)
- .where('created_by', '=', input.created_by)
+ .where(sql`created_by_subject->>'subject_id'`, '=', input.created_by_subject_id)
.where('created_at', '>=', input.start_timestamp)
.where('created_at', '<=', input.end_timestamp)
.groupBy(sql`1`)
diff --git a/packages/trueforge/src/db/postgres/session-store/queries/sessions.ts b/packages/trueforge/src/db/postgres/session-store/queries/sessions.ts
index c08821e83..49afa0ebe 100644
--- a/packages/trueforge/src/db/postgres/session-store/queries/sessions.ts
+++ b/packages/trueforge/src/db/postgres/session-store/queries/sessions.ts
@@ -1,4 +1,9 @@
-import type { AgentSpec, SessionMetadata, SessionMetrics } from '@truefoundry/trueforge-core/agent-session';
+import type {
+ AgentSpec,
+ CreatedBySubject,
+ SessionMetadata,
+ SessionMetrics,
+} from '@truefoundry/trueforge-core/agent-session';
import { SessionMetadataSchema } from '@truefoundry/trueforge-core/agent-session';
import type { SessionRecord } from '@truefoundry/trueforge-core/agent-session/models/SessionRecord';
import type {
@@ -20,6 +25,7 @@ import {
SessionStoreInvariantError,
} from '@truefoundry/trueforge-core/agent-session/store/SessionStoreErrors';
import { sql, type Kysely } from 'kysely';
+import { parseStoredCreatedBySubject } from '../../../createdBySubject';
import { SESSION_EXTERNAL_ID_UQ } from '../../../indexes';
import { sessionAgentFromColumns, sessionAgentToColumns } from '../../../sessionAgentColumns';
import { isPgConstraint, isUniqueViolation } from '../../client';
@@ -50,7 +56,7 @@ function parseSessionMetadata(value: unknown): SessionMetadata {
function mapRowToSessionRecord(row: {
tenant_id: string;
session_id: string;
- created_by: string;
+ created_by_subject: CreatedBySubject;
agent_id: string | null;
agent_name: string | null;
agent_spec: AgentSpec | null;
@@ -67,7 +73,7 @@ function mapRowToSessionRecord(row: {
return {
tenant_id: row.tenant_id,
session_id: row.session_id,
- created_by: row.created_by,
+ created_by_subject: parseStoredCreatedBySubject(row.created_by_subject),
agent: sessionAgentFromColumns({
session_id: row.session_id,
agent_id: row.agent_id,
@@ -96,7 +102,7 @@ export async function createSession(db: Kysely<Database>, input: CreateSessionIn
.values({
tenant_id: input.tenant_id,
session_id: input.session_id,
- created_by: input.created_by,
+ created_by_subject: json(input.created_by_subject),
agent_id: columns.agent_id,
agent_name: columns.agent_name,
agent_spec: columns.agent_spec !== null ? json(columns.agent_spec) : null,
@@ -240,8 +246,8 @@ export async function listSessions(
if (input.agent_id !== undefined) {
query = query.where('agent_id', '=', input.agent_id);
}
- if (input.created_by !== undefined) {
- query = query.where('created_by', '=', input.created_by);
+ if (input.created_by_subject_id !== undefined) {
+ query = query.where(sql`created_by_subject->>'subject_id'`, '=', input.created_by_subject_id);
}
if (input.start_timestamp !== undefined) {
query = query.where('created_at', '>=', input.start_timestamp);
diff --git a/packages/trueforge/src/db/postgres/types.ts b/packages/trueforge/src/db/postgres/types.ts
index c5638e3f6..0b3d35da9 100644
--- a/packages/trueforge/src/db/postgres/types.ts
+++ b/packages/trueforge/src/db/postgres/types.ts
@@ -4,6 +4,7 @@
*/
import type {
AgentSpec,
+ CreatedBySubject,
PersistedTurnEvent,
SessionMetadata,
SessionMetrics,
@@ -54,7 +55,7 @@ export interface SessionTable {
/** key */
session_id: string;
/** Caller identity that created the session (immutable after create). */
- created_by: string;
+ created_by_subject: JSONColumnType<CreatedBySubject, CreatedBySubject, CreatedBySubject>;
/**
* Named registry binding; XOR with `agent_spec`
* (CHECK session_agent_xor_check).
@@ -376,6 +377,7 @@ export interface AgentTable {
/** AgentSpec document; replaced whole on every upsert */
manifest: JSONColumnType<AgentSpec, AgentSpec, AgentSpec>;
external_id: string | null;
+ created_by_subject: JSONColumnType<CreatedBySubject, CreatedBySubject, CreatedBySubject>;
created_at: Date;
updated_at: Date;
}
@@ -398,8 +400,7 @@ export interface ScheduleTable {
manifest: JSONColumnType<ScheduleManifest, ScheduleManifest, ScheduleManifest>;
/** `paused` stops triggering and drops the pending run; in-flight runs continue */
status: ScheduleStatus;
- /** Identity every run of this schedule executes as (`RequestContext.subject.id`) */
- created_by: string;
+ created_by_subject: JSONColumnType<CreatedBySubject, CreatedBySubject, CreatedBySubject>;
created_at: Date;
updated_at: Date;
}
@@ -419,8 +420,7 @@ export interface ScheduleRunTable {
scheduled_for: Date;
/** `scheduled` | `triggered` | `failed` | `missed` — varchar(16) */
status: ScheduleRunStatus;
- /** `RequestContext.subject.id` of who triggered the run */
- triggered_by: string;
+ created_by_subject: JSONColumnType<CreatedBySubject, CreatedBySubject, CreatedBySubject>;
triggered_at: Date | null;
created_at: Date;
updated_at: Date;
diff --git a/packages/trueforge/src/db/scheduleStore.ts b/packages/trueforge/src/db/scheduleStore.ts
index a7483a9ff..ceee2d70d 100644
--- a/packages/trueforge/src/db/scheduleStore.ts
+++ b/packages/trueforge/src/db/scheduleStore.ts
@@ -13,7 +13,7 @@
*
* Implementations: PostgresScheduleStore and SqliteScheduleStore.
*/
-import type { TokenPagination } from '@truefoundry/trueforge-core/agent-session';
+import type { CreatedBySubject, TokenPagination } from '@truefoundry/trueforge-core/agent-session';
import { randomUUID } from 'node:crypto';
import {
ScheduleManifestSchema,
@@ -44,8 +44,7 @@ export interface ScheduleRecord {
name: string;
manifest: ScheduleManifest;
status: ScheduleStatus;
- /** userRef every run of this schedule executes as. */
- created_by: string;
+ created_by_subject: CreatedBySubject;
/** ISO-8601 UTC instant. */
created_at: string;
/** ISO-8601 UTC instant. */
@@ -60,8 +59,7 @@ export interface ScheduleRunRecord {
/** ISO-8601 UTC instant this run was scheduled for. Preserved even when `missed`. */
scheduled_for: string;
status: ScheduleRunStatus;
- /** userRef the run executes as. */
- triggered_by: string;
+ created_by_subject: CreatedBySubject;
triggered_at: string | null;
created_at: string;
updated_at: string;
@@ -94,7 +92,7 @@ export interface ListSchedulesInput {
page_token: string | undefined;
/** When set, only schedules for these agent names */
agent_names: readonly string[] | undefined;
- created_by?: string | undefined;
+ created_by_subject_id?: string | undefined;
}
/** User-facing run listing, scoped to one schedule. */
@@ -113,7 +111,7 @@ export interface CreateScheduleInput {
agent_name: string;
name: string;
manifest: ScheduleManifest;
- created_by: string;
+ created_by_subject: CreatedBySubject;
/** Instant used to compute the first pending run when status is active. */
runFrom: Date;
}
@@ -140,7 +138,7 @@ export interface CreateScheduleRunInput {
schedule_id: string;
name: string;
scheduled_for: Date;
- triggered_by: string;
+ created_by_subject: CreatedBySubject;
status: ScheduleRunStatus;
triggered_at?: Date | null;
}
diff --git a/packages/trueforge/src/db/sessionMetricsStore.ts b/packages/trueforge/src/db/sessionMetricsStore.ts
index 2ae4723e5..698a27ea3 100644
--- a/packages/trueforge/src/db/sessionMetricsStore.ts
+++ b/packages/trueforge/src/db/sessionMetricsStore.ts
@@ -10,7 +10,7 @@ import type {
export interface GetSessionMetricsInput {
tenant_id: string;
agent_id: string;
- created_by: string;
+ created_by_subject_id: string;
start_timestamp: Date;
end_timestamp: Date;
}
diff --git a/packages/trueforge/src/db/sqlite/agent-store/SqliteAgentStore.ts b/packages/trueforge/src/db/sqlite/agent-store/SqliteAgentStore.ts
index 722735475..3045917a0 100644
--- a/packages/trueforge/src/db/sqlite/agent-store/SqliteAgentStore.ts
+++ b/packages/trueforge/src/db/sqlite/agent-store/SqliteAgentStore.ts
@@ -1,4 +1,4 @@
-import type { AgentSpec } from '@truefoundry/trueforge-core/agent-session';
+import type { AgentSpec, CreatedBySubject } from '@truefoundry/trueforge-core/agent-session';
import type { ExpressionBuilder, Kysely, Transaction } from 'kysely';
import { newId } from '../../../utils/id';
import {
@@ -12,6 +12,7 @@ import {
type IAgentStore,
type UpdateAgentInput,
} from '../../agentStore';
+import { parseStoredCreatedBySubject } from '../../createdBySubject';
import { isUniqueViolation } from '../client';
import { jsonbBind, jsonText, nowIso } from '../sqlExpressions';
import type { Database } from '../types';
@@ -24,6 +25,7 @@ function recordColumns(eb: ExpressionBuilder<Database, 'agent'>) {
'name' as const,
jsonText<AgentSpec>(eb.ref('manifest')).as('manifest'),
'external_id' as const,
+ jsonText<CreatedBySubject>(eb.ref('created_by_subject')).as('created_by_subject'),
'created_at' as const,
'updated_at' as const,
];
@@ -35,10 +37,15 @@ function toRecord(row: {
name: AgentRecord['name'];
manifest: AgentSpec;
external_id: string | null;
+ created_by_subject: CreatedBySubject;
created_at: string;
updated_at: string;
}): AgentRecord {
- return { ...row, manifest: parseStoredAgentSpec(row.manifest) };
+ return {
+ ...row,
+ manifest: parseStoredAgentSpec(row.manifest),
+ created_by_subject: parseStoredCreatedBySubject(row.created_by_subject),
+ };
}
export class SqliteAgentStore implements IAgentStore<Transaction<Database>> {
@@ -83,6 +90,7 @@ export class SqliteAgentStore implements IAgentStore<Transaction<Database>> {
name: input.name,
manifest: jsonbBind(input.manifest),
external_id: input.external_id,
+ created_by_subject: jsonbBind(input.created_by_subject),
created_at: timestamp,
updated_at: timestamp,
})
diff --git a/packages/trueforge/src/db/sqlite/client.ts b/packages/trueforge/src/db/sqlite/client.ts
index b566ccfb4..209745d8b 100644
--- a/packages/trueforge/src/db/sqlite/client.ts
+++ b/packages/trueforge/src/db/sqlite/client.ts
@@ -145,6 +145,7 @@ const JSON_RESULT_COLUMNS = new Set([
'oauth_client',
'token',
'auth_data',
+ 'created_by_subject',
]);
/** Top-level row field only — `$[0]."body"`, not `$[0]."body"."content"`. */
diff --git a/packages/trueforge/src/db/sqlite/migrations/20260903_000002_created_by_subject.ts b/packages/trueforge/src/db/sqlite/migrations/20260903_000002_created_by_subject.ts
new file mode 100644
index 000000000..1b19625d1
--- /dev/null
+++ b/packages/trueforge/src/db/sqlite/migrations/20260903_000002_created_by_subject.ts
@@ -0,0 +1,506 @@
+import { sql, type Kysely } from 'kysely';
+import {
+ AGENT_CREATED_BY_SUBJECT_ID_IDX,
+ AGENT_EXTERNAL_ID_UQ,
+ SCHEDULE_CREATED_BY_SUBJECT_ID_IDX,
+ SCHEDULE_RUN_CREATED_BY_SUBJECT_ID_IDX,
+ SESSION_CREATED_BY_SUBJECT_ID_IDX,
+ SESSION_EXTERNAL_ID_UQ,
+} from '../../indexes';
+
+/**
+ * Add `created_by_subject` on agent, session, schedule, and schedule_run.
+ * STRICT rebuilds (cannot ADD NOT NULL with expression default / DROP DEFAULT).
+ * Backfills session/schedule/schedule_run from created_by/triggered_by;
+ * agent backfills best-effort from its first created session (fallback: trueforge-default).
+ * Agent has no metadata (dropped in 20260903_000001). FKs off for agent/schedule swaps.
+ */
+export async function up(db: Kysely<unknown>): Promise<void> {
+ await sql`PRAGMA foreign_keys = OFF`.execute(db);
+ try {
+ await db.transaction().execute(async trx => {
+ await sql`
+ CREATE TABLE session_new (
+ tenant_id TEXT NOT NULL,
+ session_id TEXT NOT NULL,
+ created_by_subject BLOB NOT NULL,
+ agent_id TEXT,
+ agent_name TEXT,
+ agent_spec BLOB,
+ title TEXT,
+ last_turn_id TEXT,
+ external_id TEXT,
+ custom BLOB,
+ metadata BLOB NOT NULL DEFAULT (jsonb('{}')),
+ metrics BLOB NOT NULL DEFAULT (jsonb('{"total_cost_in_usd":0,"total_duration_ms":0,"total_turns":0}')),
+ last_activity_timestamp_ms INTEGER NOT NULL,
+ created_at TEXT NOT NULL,
+ updated_at TEXT NOT NULL,
+ PRIMARY KEY (session_id),
+ CHECK (
+ (agent_id IS NOT NULL AND agent_spec IS NULL)
+ OR (agent_id IS NULL AND agent_spec IS NOT NULL)
+ )
+ ) STRICT
+ `.execute(trx);
+ await sql`
+ INSERT INTO session_new (
+ tenant_id,
+ session_id,
+ created_by_subject,
+ agent_id,
+ agent_name,
+ agent_spec,
+ title,
+ last_turn_id,
+ external_id,
+ custom,
+ metadata,
+ metrics,
+ last_activity_timestamp_ms,
+ created_at,
+ updated_at
+ )
+ SELECT
+ tenant_id,
+ session_id,
+ jsonb(json_object(
+ 'subject_id', CASE WHEN created_by = '' THEN 'trueforge-default' ELSE created_by END,
+ 'subject_type', 'user',
+ 'subject_display_name', CASE WHEN created_by = '' THEN 'trueforge-default' ELSE created_by END
+ )),
+ agent_id,
+ agent_name,
+ agent_spec,
+ title,
+ last_turn_id,
+ external_id,
+ custom,
+ metadata,
+ metrics,
+ last_activity_timestamp_ms,
+ created_at,
+ updated_at
+ FROM session
+ `.execute(trx);
+ await sql`DROP TABLE session`.execute(trx);
+ await sql`ALTER TABLE session_new RENAME TO session`.execute(trx);
+ await sql`
+ CREATE INDEX session_list_idx
+ ON session (tenant_id, created_at, session_id)
+ `.execute(trx);
+ await sql`
+ CREATE INDEX session_agent_id_idx
+ ON session (tenant_id, agent_id)
+ WHERE agent_id IS NOT NULL
+ `.execute(trx);
+ await sql`
+ CREATE INDEX session_list_updated_at_idx
+ ON session (tenant_id, updated_at, session_id)
+ `.execute(trx);
+ await sql`
+ CREATE INDEX session_agent_created_at_idx
+ ON session (tenant_id, agent_id, created_at)
+ WHERE agent_id IS NOT NULL
+ `.execute(trx);
+ await sql`
+ CREATE UNIQUE INDEX ${sql.raw(SESSION_EXTERNAL_ID_UQ)}
+ ON session (tenant_id, external_id)
+ WHERE external_id IS NOT NULL
+ `.execute(trx);
+ await sql`
+ CREATE INDEX ${sql.raw(SESSION_CREATED_BY_SUBJECT_ID_IDX)}
+ ON session (tenant_id, json_extract(created_by_subject, '$.subject_id'))
+ `.execute(trx);
+
+ await sql`
+ CREATE TABLE agent_new (
+ id TEXT NOT NULL,
+ tenant_id TEXT NOT NULL,
+ name TEXT NOT NULL,
+ manifest BLOB NOT NULL,
+ external_id TEXT,
+ created_by_subject BLOB NOT NULL,
+ created_at TEXT NOT NULL,
+ updated_at TEXT NOT NULL,
+ PRIMARY KEY (id),
+ UNIQUE (tenant_id, name)
+ ) STRICT
+ `.execute(trx);
+ await sql`
+ INSERT INTO agent_new (
+ id, tenant_id, name, manifest, external_id, created_by_subject, created_at, updated_at
+ )
+ SELECT
+ a.id,
+ a.tenant_id,
+ a.name,
+ a.manifest,
+ a.external_id,
+ COALESCE(
+ (
+ SELECT s.created_by_subject
+ FROM session AS s
+ WHERE s.tenant_id = a.tenant_id
+ AND (s.agent_id = a.id OR (s.agent_id IS NULL AND s.agent_name = a.name))
+ ORDER BY s.created_at ASC
+ LIMIT 1
+ ),
+ jsonb('{"subject_id":"trueforge-default","subject_type":"user","subject_display_name":"trueforge-default"}')
+ ),
+ a.created_at,
+ a.updated_at
+ FROM agent AS a
+ `.execute(trx);
+ await sql`DROP TABLE agent`.execute(trx);
+ await sql`ALTER TABLE agent_new RENAME TO agent`.execute(trx);
+ await sql`
+ CREATE UNIQUE INDEX ${sql.raw(AGENT_EXTERNAL_ID_UQ)}
+ ON agent (tenant_id, external_id)
+ WHERE external_id IS NOT NULL
+ `.execute(trx);
+ await sql`
+ CREATE INDEX ${sql.raw(AGENT_CREATED_BY_SUBJECT_ID_IDX)}
+ ON agent (tenant_id, json_extract(created_by_subject, '$.subject_id'))
+ `.execute(trx);
+
+ await sql`
+ CREATE TABLE schedule_new (
+ id TEXT NOT NULL,
+ tenant_id TEXT NOT NULL,
+ agent_name TEXT NOT NULL,
+ name TEXT NOT NULL,
+ manifest BLOB NOT NULL,
+ status TEXT NOT NULL CHECK (length(status) <= 16),
+ created_by_subject BLOB NOT NULL,
+ created_at TEXT NOT NULL,
+ updated_at TEXT NOT NULL,
+ PRIMARY KEY (id),
+ FOREIGN KEY (tenant_id, agent_name) REFERENCES agent (tenant_id, name) ON DELETE CASCADE
+ ) STRICT
+ `.execute(trx);
+ await sql`
+ INSERT INTO schedule_new (
+ id, tenant_id, agent_name, name, manifest, status, created_by_subject, created_at, updated_at
+ )
+ SELECT
+ id,
+ tenant_id,
+ agent_name,
+ name,
+ manifest,
+ status,
+ jsonb(json_object(
+ 'subject_id', CASE WHEN created_by = '' THEN 'trueforge-default' ELSE created_by END,
+ 'subject_type', 'user',
+ 'subject_display_name', CASE WHEN created_by = '' THEN 'trueforge-default' ELSE created_by END
+ )),
+ created_at,
+ updated_at
+ FROM schedule
+ `.execute(trx);
+
+ await sql`
+ CREATE TABLE schedule_run_new (
+ id TEXT NOT NULL,
+ tenant_id TEXT NOT NULL,
+ schedule_id TEXT NOT NULL REFERENCES schedule_new (id) ON DELETE CASCADE,
+ name TEXT NOT NULL,
+ scheduled_for TEXT NOT NULL,
+ status TEXT NOT NULL CHECK (length(status) <= 16),
+ created_by_subject BLOB NOT NULL,
+ triggered_at TEXT,
+ created_at TEXT NOT NULL,
+ updated_at TEXT NOT NULL,
+ PRIMARY KEY (id)
+ ) STRICT
+ `.execute(trx);
+ await sql`
+ INSERT INTO schedule_run_new (
+ id,
+ tenant_id,
+ schedule_id,
+ name,
+ scheduled_for,
+ status,
+ created_by_subject,
+ triggered_at,
+ created_at,
+ updated_at
+ )
+ SELECT
+ id,
+ tenant_id,
+ schedule_id,
+ name,
+ scheduled_for,
+ status,
+ jsonb(json_object(
+ 'subject_id', CASE WHEN triggered_by = '' THEN 'trueforge-default' ELSE triggered_by END,
+ 'subject_type', 'user',
+ 'subject_display_name', CASE WHEN triggered_by = '' THEN 'trueforge-default' ELSE triggered_by END
+ )),
+ triggered_at,
+ created_at,
+ updated_at
+ FROM schedule_run
+ `.execute(trx);
+
+ await sql`DROP TABLE schedule_run`.execute(trx);
+ await sql`DROP TABLE schedule`.execute(trx);
+ await sql`ALTER TABLE schedule_new RENAME TO schedule`.execute(trx);
+ await sql`ALTER TABLE schedule_run_new RENAME TO schedule_run`.execute(trx);
+
+ await sql`
+ CREATE INDEX schedule_agent_idx
+ ON schedule (tenant_id, agent_name)
+ `.execute(trx);
+ await sql`
+ CREATE UNIQUE INDEX schedule_name_uq
+ ON schedule (tenant_id, agent_name, name)
+ `.execute(trx);
+ await sql`
+ CREATE INDEX ${sql.raw(SCHEDULE_CREATED_BY_SUBJECT_ID_IDX)}
+ ON schedule (tenant_id, json_extract(created_by_subject, '$.subject_id'))
+ `.execute(trx);
+ await sql`
+ CREATE UNIQUE INDEX schedule_run_name_idx
+ ON schedule_run (tenant_id, schedule_id, name)
+ `.execute(trx);
+ await sql`
+ CREATE INDEX schedule_run_scheduled_for_idx
+ ON schedule_run (scheduled_for)
+ WHERE status = 'scheduled'
+ `.execute(trx);
+ await sql`
+ CREATE UNIQUE INDEX schedule_run_pending_uq
+ ON schedule_run (schedule_id)
+ WHERE status = 'scheduled'
+ `.execute(trx);
+ await sql`
+ CREATE INDEX schedule_run_list_idx
+ ON schedule_run (schedule_id, scheduled_for DESC)
+ `.execute(trx);
+ await sql`
+ CREATE INDEX ${sql.raw(SCHEDULE_RUN_CREATED_BY_SUBJECT_ID_IDX)}
+ ON schedule_run (tenant_id, json_extract(created_by_subject, '$.subject_id'))
+ `.execute(trx);
+ });
+ } finally {
+ await sql`PRAGMA foreign_keys = ON`.execute(db);
+ }
+}
+
+export async function down(db: Kysely<unknown>): Promise<void> {
+ await sql`PRAGMA foreign_keys = OFF`.execute(db);
+ try {
+ await db.transaction().execute(async trx => {
+ await sql`
+ CREATE TABLE schedule_old (
+ id TEXT NOT NULL,
+ tenant_id TEXT NOT NULL,
+ agent_name TEXT NOT NULL,
+ name TEXT NOT NULL,
+ manifest BLOB NOT NULL,
+ status TEXT NOT NULL CHECK (length(status) <= 16),
+ created_by TEXT NOT NULL,
+ created_at TEXT NOT NULL,
+ updated_at TEXT NOT NULL,
+ PRIMARY KEY (id),
+ FOREIGN KEY (tenant_id, agent_name) REFERENCES agent (tenant_id, name) ON DELETE CASCADE
+ ) STRICT
+ `.execute(trx);
+ await sql`
+ INSERT INTO schedule_old (
+ id, tenant_id, agent_name, name, manifest, status, created_by, created_at, updated_at
+ )
+ SELECT
+ id,
+ tenant_id,
+ agent_name,
+ name,
+ manifest,
+ status,
+ COALESCE(json_extract(created_by_subject, '$.subject_id'), ''),
+ created_at,
+ updated_at
+ FROM schedule
+ `.execute(trx);
+
+ await sql`
+ CREATE TABLE schedule_run_old (
+ id TEXT NOT NULL,
+ tenant_id TEXT NOT NULL,
+ schedule_id TEXT NOT NULL REFERENCES schedule_old (id) ON DELETE CASCADE,
+ name TEXT NOT NULL,
+ scheduled_for TEXT NOT NULL,
+ status TEXT NOT NULL CHECK (length(status) <= 16),
+ triggered_by TEXT NOT NULL,
+ triggered_at TEXT,
+ created_at TEXT NOT NULL,
+ updated_at TEXT NOT NULL,
+ PRIMARY KEY (id)
+ ) STRICT
+ `.execute(trx);
+ await sql`
+ INSERT INTO schedule_run_old (
+ id,
+ tenant_id,
+ schedule_id,
+ name,
+ scheduled_for,
+ status,
+ triggered_by,
+ triggered_at,
+ created_at,
+ updated_at
+ )
+ SELECT
+ id,
+ tenant_id,
+ schedule_id,
+ name,
+ scheduled_for,
+ status,
+ COALESCE(json_extract(created_by_subject, '$.subject_id'), ''),
+ triggered_at,
+ created_at,
+ updated_at
+ FROM schedule_run
+ `.execute(trx);
+
+ await sql`DROP TABLE schedule_run`.execute(trx);
+ await sql`DROP TABLE schedule`.execute(trx);
+ await sql`ALTER TABLE schedule_old RENAME TO schedule`.execute(trx);
+ await sql`ALTER TABLE schedule_run_old RENAME TO schedule_run`.execute(trx);
+ await sql`
+ CREATE INDEX schedule_agent_idx ON schedule (tenant_id, agent_name)
+ `.execute(trx);
+ await sql`
+ CREATE UNIQUE INDEX schedule_name_uq ON schedule (tenant_id, agent_name, name)
+ `.execute(trx);
+ await sql`
+ CREATE UNIQUE INDEX schedule_run_name_idx ON schedule_run (tenant_id, schedule_id, name)
+ `.execute(trx);
+ await sql`
+ CREATE INDEX schedule_run_scheduled_for_idx
+ ON schedule_run (scheduled_for) WHERE status = 'scheduled'
+ `.execute(trx);
+ await sql`
+ CREATE UNIQUE INDEX schedule_run_pending_uq
+ ON schedule_run (schedule_id) WHERE status = 'scheduled'
+ `.execute(trx);
+ await sql`
+ CREATE INDEX schedule_run_list_idx ON schedule_run (schedule_id, scheduled_for DESC)
+ `.execute(trx);
+
+ await sql`
+ CREATE TABLE agent_old (
+ id TEXT NOT NULL,
+ tenant_id TEXT NOT NULL,
+ name TEXT NOT NULL,
+ manifest BLOB NOT NULL,
+ external_id TEXT,
+ created_at TEXT NOT NULL,
+ updated_at TEXT NOT NULL,
+ PRIMARY KEY (id),
+ UNIQUE (tenant_id, name)
+ ) STRICT
+ `.execute(trx);
+ await sql`
+ INSERT INTO agent_old (id, tenant_id, name, manifest, external_id, created_at, updated_at)
+ SELECT id, tenant_id, name, manifest, external_id, created_at, updated_at
+ FROM agent
+ `.execute(trx);
+ await sql`DROP TABLE agent`.execute(trx);
+ await sql`ALTER TABLE agent_old RENAME TO agent`.execute(trx);
+ await sql`
+ CREATE UNIQUE INDEX ${sql.raw(AGENT_EXTERNAL_ID_UQ)}
+ ON agent (tenant_id, external_id) WHERE external_id IS NOT NULL
+ `.execute(trx);
+
+ await sql`
+ CREATE TABLE session_old (
+ tenant_id TEXT NOT NULL,
+ session_id TEXT NOT NULL,
+ created_by TEXT NOT NULL DEFAULT '',
+ agent_id TEXT,
+ agent_name TEXT,
+ agent_spec BLOB,
+ title TEXT,
+ last_turn_id TEXT,
+ external_id TEXT,
+ custom BLOB,
+ metadata BLOB NOT NULL DEFAULT (jsonb('{}')),
+ metrics BLOB NOT NULL DEFAULT (jsonb('{"total_cost_in_usd":0,"total_duration_ms":0,"total_turns":0}')),
+ last_activity_timestamp_ms INTEGER NOT NULL,
+ created_at TEXT NOT NULL,
+ updated_at TEXT NOT NULL,
+ PRIMARY KEY (session_id),
+ CHECK (
+ (agent_id IS NOT NULL AND agent_spec IS NULL)
+ OR (agent_id IS NULL AND agent_spec IS NOT NULL)
+ )
+ ) STRICT
+ `.execute(trx);
+ await sql`
+ INSERT INTO session_old (
+ tenant_id,
+ session_id,
+ created_by,
+ agent_id,
+ agent_name,
+ agent_spec,
+ title,
+ last_turn_id,
+ external_id,
+ custom,
+ metadata,
+ metrics,
+ last_activity_timestamp_ms,
+ created_at,
+ updated_at
+ )
+ SELECT
+ tenant_id,
+ session_id,
+ COALESCE(json_extract(created_by_subject, '$.subject_id'), ''),
+ agent_id,
+ agent_name,
+ agent_spec,
+ title,
+ last_turn_id,
+ external_id,
+ custom,
+ metadata,
+ metrics,
+ last_activity_timestamp_ms,
+ created_at,
+ updated_at
+ FROM session
+ `.execute(trx);
+ await sql`DROP TABLE session`.execute(trx);
+ await sql`ALTER TABLE session_old RENAME TO session`.execute(trx);
+ await sql`
+ CREATE INDEX session_list_idx ON session (tenant_id, created_at, session_id)
+ `.execute(trx);
+ await sql`
+ CREATE INDEX session_agent_id_idx
+ ON session (tenant_id, agent_id) WHERE agent_id IS NOT NULL
+ `.execute(trx);
+ await sql`
+ CREATE INDEX session_list_updated_at_idx ON session (tenant_id, updated_at, session_id)
+ `.execute(trx);
+ await sql`
+ CREATE INDEX session_agent_created_at_idx
+ ON session (tenant_id, agent_id, created_at) WHERE agent_id IS NOT NULL
+ `.execute(trx);
+ await sql`
+ CREATE UNIQUE INDEX ${sql.raw(SESSION_EXTERNAL_ID_UQ)}
+ ON session (tenant_id, external_id) WHERE external_id IS NOT NULL
+ `.execute(trx);
+ });
+ } finally {
+ await sql`PRAGMA foreign_keys = ON`.execute(db);
+ }
+}
diff --git a/packages/trueforge/src/db/sqlite/schedule-store/SqliteScheduleStore.ts b/packages/trueforge/src/db/sqlite/schedule-store/SqliteScheduleStore.ts
index 83c901d93..3bc89114b 100644
--- a/packages/trueforge/src/db/sqlite/schedule-store/SqliteScheduleStore.ts
+++ b/packages/trueforge/src/db/sqlite/schedule-store/SqliteScheduleStore.ts
@@ -1,12 +1,13 @@
-import type { TokenPagination } from '@truefoundry/trueforge-core/agent-session';
+import type { CreatedBySubject, TokenPagination } from '@truefoundry/trueforge-core/agent-session';
import {
decodeOffsetPageToken,
paginateOffsetRows,
} from '@truefoundry/trueforge-core/agent-session/store/OffsetPageToken';
-import type { ExpressionBuilder, Kysely, Transaction } from 'kysely';
+import { sql, type ExpressionBuilder, type Kysely, type Transaction } from 'kysely';
import { nextTriggerAfter } from '../../../runtime/cron';
import type { ScheduleManifest, ScheduleRunStatus, ScheduleStatus } from '../../../schemas/schedule';
import { newId } from '../../../utils/id';
+import { parseStoredCreatedBySubject } from '../../createdBySubject';
import {
cronRunName,
parseStoredScheduleManifest,
@@ -42,24 +43,26 @@ function scheduleColumns(eb: ExpressionBuilder<Database, 'schedule'>) {
'name' as const,
jsonText<ScheduleManifest>(eb.ref('manifest')).as('manifest'),
'status' as const,
- 'created_by' as const,
+ jsonText<CreatedBySubject>(eb.ref('created_by_subject')).as('created_by_subject'),
'created_at' as const,
'updated_at' as const,
];
}
-const RUN_COLUMNS = [
- 'id',
- 'tenant_id',
- 'schedule_id',
- 'name',
- 'scheduled_for',
- 'status',
- 'triggered_by',
- 'triggered_at',
- 'created_at',
- 'updated_at',
-] as const;
+function runColumns(eb: ExpressionBuilder<Database, 'schedule_run'>) {
+ return [
+ 'id' as const,
+ 'tenant_id' as const,
+ 'schedule_id' as const,
+ 'name' as const,
+ 'scheduled_for' as const,
+ 'status' as const,
+ jsonText<CreatedBySubject>(eb.ref('created_by_subject')).as('created_by_subject'),
+ 'triggered_at' as const,
+ 'created_at' as const,
+ 'updated_at' as const,
+ ];
+}
interface ScheduleRow {
id: string;
@@ -68,7 +71,7 @@ interface ScheduleRow {
name: string;
manifest: ScheduleManifest;
status: ScheduleStatus;
- created_by: string;
+ created_by_subject: CreatedBySubject;
created_at: string;
updated_at: string;
}
@@ -80,18 +83,25 @@ interface RunRow {
name: string;
scheduled_for: string;
status: ScheduleRunStatus;
- triggered_by: string;
+ created_by_subject: CreatedBySubject;
triggered_at: string | null;
created_at: string;
updated_at: string;
}
function toScheduleRecord(row: ScheduleRow): ScheduleRecord {
- return { ...row, manifest: parseStoredScheduleManifest(row.manifest) };
+ return {
+ ...row,
+ manifest: parseStoredScheduleManifest(row.manifest),
+ created_by_subject: parseStoredCreatedBySubject(row.created_by_subject),
+ };
}
function toRunRecord(row: RunRow): ScheduleRunRecord {
- return { ...row };
+ return {
+ ...row,
+ created_by_subject: parseStoredCreatedBySubject(row.created_by_subject),
+ };
}
export class SqliteScheduleStore implements IScheduleStore<Transaction<Database>> {
@@ -141,7 +151,7 @@ export class SqliteScheduleStore implements IScheduleStore<Transaction<Database>
manifest: jsonbBind(input.manifest),
// Column mirrors the manifest so the dispatch scan and API reads share one value.
status: input.manifest.status,
- created_by: input.created_by,
+ created_by_subject: jsonbBind(input.created_by_subject),
created_at: timestamp,
updated_at: timestamp,
})
@@ -244,7 +254,7 @@ export class SqliteScheduleStore implements IScheduleStore<Transaction<Database>
name: cronRunName(nextTrigger),
scheduled_for: nextTrigger,
status: 'scheduled',
- triggered_by: schedule.created_by,
+ created_by_subject: schedule.created_by_subject,
},
transaction,
);
@@ -265,8 +275,8 @@ export class SqliteScheduleStore implements IScheduleStore<Transaction<Database>
if (input.agent_names !== undefined) {
query = query.where('agent_name', 'in', [...input.agent_names]);
}
- if (input.created_by !== undefined) {
- query = query.where('created_by', '=', input.created_by);
+ if (input.created_by_subject_id !== undefined) {
+ query = query.where(sql`json_extract(created_by_subject, '$.subject_id')`, '=', input.created_by_subject_id);
}
const rows = await query
.orderBy('created_at', 'desc')
@@ -282,7 +292,7 @@ export class SqliteScheduleStore implements IScheduleStore<Transaction<Database>
const db = transaction ?? this.#db;
const rows = await db
.selectFrom('schedule_run')
- .select(RUN_COLUMNS)
+ .select(runColumns)
.where('tenant_id', '=', input.tenant_id)
.where('schedule_id', '=', input.schedule_id)
.orderBy('scheduled_for', 'desc')
@@ -295,7 +305,7 @@ export class SqliteScheduleStore implements IScheduleStore<Transaction<Database>
const db = transaction ?? this.#db;
const row = await db
.selectFrom('schedule_run')
- .select(RUN_COLUMNS)
+ .select(runColumns)
.where('tenant_id', '=', input.tenant_id)
.where('id', '=', input.id)
.executeTakeFirst();
@@ -309,7 +319,7 @@ export class SqliteScheduleStore implements IScheduleStore<Transaction<Database>
const db = transaction ?? this.#db;
const row = await db
.selectFrom('schedule_run')
- .select(RUN_COLUMNS)
+ .select(runColumns)
.where('tenant_id', '=', input.tenant_id)
.where('schedule_id', '=', input.schedule_id)
.where('status', '=', 'scheduled')
@@ -330,12 +340,12 @@ export class SqliteScheduleStore implements IScheduleStore<Transaction<Database>
name: input.name,
scheduled_for: input.scheduled_for.toISOString(),
status: input.status,
- triggered_by: input.triggered_by,
+ created_by_subject: jsonbBind(input.created_by_subject),
triggered_at: input.triggered_at?.toISOString() ?? null,
created_at: timestamp,
updated_at: timestamp,
})
- .returning(RUN_COLUMNS)
+ .returning(runColumns)
.executeTakeFirstOrThrow();
return toRunRecord(row);
} catch (error) {
@@ -361,7 +371,7 @@ export class SqliteScheduleStore implements IScheduleStore<Transaction<Database>
.set(patch)
.where('tenant_id', '=', input.tenant_id)
.where('id', '=', input.id)
- .returning(RUN_COLUMNS)
+ .returning(runColumns)
.executeTakeFirst();
return row === undefined ? undefined : toRunRecord(row);
}
@@ -373,7 +383,7 @@ export class SqliteScheduleStore implements IScheduleStore<Transaction<Database>
const db = transaction ?? this.#db;
const rows = await db
.selectFrom('schedule_run')
- .select(RUN_COLUMNS)
+ .select(runColumns)
.where('status', '=', 'scheduled')
.where('scheduled_for', '<=', input.until.toISOString())
.orderBy('scheduled_for')
diff --git a/packages/trueforge/src/db/sqlite/session-metrics/queries.ts b/packages/trueforge/src/db/sqlite/session-metrics/queries.ts
index bedbed28d..f15010d92 100644
--- a/packages/trueforge/src/db/sqlite/session-metrics/queries.ts
+++ b/packages/trueforge/src/db/sqlite/session-metrics/queries.ts
@@ -28,7 +28,7 @@ async function fetchSessionMetricsAggregate(
])
.where('tenant_id', '=', input.tenant_id)
.where('agent_id', '=', input.agent_id)
- .where('created_by', '=', input.created_by)
+ .where(sql`json_extract(created_by_subject, '$.subject_id')`, '=', input.created_by_subject_id)
.where('created_at', '>=', start_timestamp)
.where('created_at', '<=', end_timestamp)
.execute();
@@ -55,7 +55,7 @@ async function fetchSessionMetricsBuckets(
])
.where('tenant_id', '=', input.tenant_id)
.where('agent_id', '=', input.agent_id)
- .where('created_by', '=', input.created_by)
+ .where(sql`json_extract(created_by_subject, '$.subject_id')`, '=', input.created_by_subject_id)
.where('created_at', '>=', start_timestamp)
.where('created_at', '<=', end_timestamp)
.groupBy(sql`1`)
diff --git a/packages/trueforge/src/db/sqlite/session-store/queries/sessions.ts b/packages/trueforge/src/db/sqlite/session-store/queries/sessions.ts
index 4aac39f00..f50adbec7 100644
--- a/packages/trueforge/src/db/sqlite/session-store/queries/sessions.ts
+++ b/packages/trueforge/src/db/sqlite/session-store/queries/sessions.ts
@@ -1,4 +1,9 @@
-import type { AgentSpec, SessionMetadata, SessionMetrics } from '@truefoundry/trueforge-core/agent-session';
+import type {
+ AgentSpec,
+ CreatedBySubject,
+ SessionMetadata,
+ SessionMetrics,
+} from '@truefoundry/trueforge-core/agent-session';
import { SessionMetadataSchema } from '@truefoundry/trueforge-core/agent-session';
import type { SessionRecord } from '@truefoundry/trueforge-core/agent-session/models/SessionRecord';
import type {
@@ -20,6 +25,7 @@ import {
SessionStoreInvariantError,
} from '@truefoundry/trueforge-core/agent-session/store/SessionStoreErrors';
import { sql, type Kysely } from 'kysely';
+import { parseStoredCreatedBySubject } from '../../../createdBySubject';
import { sessionAgentFromColumns, sessionAgentToColumns } from '../../../sessionAgentColumns';
import { isUniqueViolation } from '../../client';
import { jsonbBind, jsonText, nowIso } from '../../sqlExpressions';
@@ -49,7 +55,7 @@ function parseSessionMetadata(value: unknown): SessionMetadata {
function mapRowToSessionRecord(row: {
tenant_id: string;
session_id: string;
- created_by: string;
+ created_by_subject: CreatedBySubject;
agent_id: string | null;
agent_name: string | null;
agent_spec: AgentSpec | null;
@@ -66,7 +72,7 @@ function mapRowToSessionRecord(row: {
return {
tenant_id: row.tenant_id,
session_id: row.session_id,
- created_by: row.created_by,
+ created_by_subject: parseStoredCreatedBySubject(row.created_by_subject),
agent: sessionAgentFromColumns({
session_id: row.session_id,
agent_id: row.agent_id,
@@ -89,7 +95,7 @@ function sessionSelectColumns() {
return [
'tenant_id' as const,
'session_id' as const,
- 'created_by' as const,
+ jsonText<CreatedBySubject>(sql.ref('created_by_subject')).as('created_by_subject'),
'agent_id' as const,
'agent_name' as const,
jsonText<AgentSpec | null>(sql.ref('agent_spec')).as('agent_spec'),
@@ -115,7 +121,7 @@ export async function createSession(db: Kysely<Database>, input: CreateSessionIn
.values({
tenant_id: input.tenant_id,
session_id: input.session_id,
- created_by: input.created_by,
+ created_by_subject: jsonbBind(input.created_by_subject),
agent_id: columns.agent_id,
agent_name: columns.agent_name,
agent_spec: columns.agent_spec !== null ? jsonbBind(columns.agent_spec) : null,
@@ -256,8 +262,8 @@ export async function listSessions(
if (input.agent_id !== undefined) {
query = query.where('agent_id', '=', input.agent_id);
}
- if (input.created_by !== undefined) {
- query = query.where('created_by', '=', input.created_by);
+ if (input.created_by_subject_id !== undefined) {
+ query = query.where(sql`json_extract(created_by_subject, '$.subject_id')`, '=', input.created_by_subject_id);
}
if (input.start_timestamp !== undefined) {
query = query.where('created_at', '>=', input.start_timestamp.toISOString());
diff --git a/packages/trueforge/src/db/sqlite/types.ts b/packages/trueforge/src/db/sqlite/types.ts
index 114a8814a..c6c026518 100644
--- a/packages/trueforge/src/db/sqlite/types.ts
+++ b/packages/trueforge/src/db/sqlite/types.ts
@@ -7,6 +7,7 @@
*/
import type {
AgentSpec,
+ CreatedBySubject,
PersistedTurnEvent,
SessionMetadata,
SessionMetrics,
@@ -57,7 +58,7 @@ export interface SessionTable {
tenant_id: string;
session_id: string;
/** Caller identity that created the session (immutable after create). */
- created_by: string;
+ created_by_subject: JsonbColumn<CreatedBySubject>;
/** Named registry binding; XOR with `agent_spec`. */
agent_id: string | null;
/**
@@ -222,6 +223,7 @@ export interface AgentTable {
/** AgentSpec document; replaced whole on every upsert */
manifest: JsonbColumn<AgentSpec>;
external_id: string | null;
+ created_by_subject: JsonbColumn<CreatedBySubject>;
created_at: string;
updated_at: string;
}
@@ -243,8 +245,7 @@ export interface ScheduleTable {
manifest: JsonbColumn<ScheduleManifest>;
/** `paused` stops triggering and drops the pending run; in-flight runs continue */
status: ScheduleStatus;
- /** Identity every run of this schedule executes as (`RequestContext.subject.id`) */
- created_by: string;
+ created_by_subject: JsonbColumn<CreatedBySubject>;
created_at: string;
updated_at: string;
}
@@ -264,8 +265,7 @@ export interface ScheduleRunTable {
scheduled_for: string;
/** `scheduled` | `triggered` | `failed` | `missed` — length ≤ 16 */
status: ScheduleRunStatus;
- /** `RequestContext.subject.id` of who triggered the run */
- triggered_by: string;
+ created_by_subject: JsonbColumn<CreatedBySubject>;
triggered_at: string | null;
created_at: string;
updated_at: string;
diff --git a/packages/trueforge/src/routes/sessionRoutes.ts b/packages/trueforge/src/routes/sessionRoutes.ts
index 614a8c397..0a7ad7c14 100644
--- a/packages/trueforge/src/routes/sessionRoutes.ts
+++ b/packages/trueforge/src/routes/sessionRoutes.ts
@@ -111,7 +111,7 @@ export const getSessionRoute = createRoute({
path: '/{session_id}',
tags: [OpenApiTag.AGENT_SESSIONS],
summary: 'Get a session',
- description: 'Fetch a session by ID. Only the session creator (`created_by`) may fetch it.',
+ description: 'Fetch a session by ID. Only the session creator may fetch it.',
'x-fern-sdk-group-name': ['sessions'],
'x-fern-sdk-method-name': 'get',
request: {
@@ -139,7 +139,7 @@ export const deleteSessionRoute = createRoute({
tags: [OpenApiTag.AGENT_SESSIONS],
summary: 'Delete a session',
description:
- 'Delete a session and all related turns, events, and internal state. Only the session creator (`created_by`) may delete it. Idempotent if already gone.',
+ 'Delete a session and all related turns, events, and internal state. Only the session creator may delete it. Idempotent if already gone.',
'x-fern-sdk-group-name': ['sessions'],
'x-fern-sdk-method-name': 'delete',
request: {
@@ -162,7 +162,7 @@ export const updateSessionRoute = createRoute({
tags: [OpenApiTag.AGENT_SESSIONS],
summary: 'Update a session',
description:
- 'Update a session by replacing `agent` with `{ spec: AgentSpec }`. Named (reference) sessions reject agent updates. An empty body is a valid no-op that refreshes `updated_at`. Only the session creator (`created_by`) may update it.',
+ 'Update a session by replacing `agent` with `{ spec: AgentSpec }`. Named (reference) sessions reject agent updates. An empty body is a valid no-op that refreshes `updated_at`. Only the session creator may update it.',
'x-fern-sdk-group-name': ['sessions'],
'x-fern-sdk-method-name': 'update',
request: {
@@ -203,7 +203,7 @@ export const listSessionsRoute = createRoute({
tags: [OpenApiTag.AGENT_SESSIONS],
summary: 'List sessions',
description:
- "List the caller's sessions (newest first by default), token-paginated. Results are scoped to the authenticated identity via the session store's `created_by` filter (not a client query param). Optional `agent_id` filters to sessions bound to that named agent. Pass `page_token` to fetch the next page, keeping the other query params constant.",
+ "List the caller's sessions (newest first by default), token-paginated. Results are scoped to the authenticated identity via the session store's `created_by_subject.subject_id` filter (not a client query param). Optional `agent_id` filters to sessions bound to that named agent. Pass `page_token` to fetch the next page, keeping the other query params constant.",
'x-fern-sdk-group-name': ['sessions'],
'x-fern-sdk-method-name': 'list',
'x-fern-pagination': TOKEN_PAGINATION,
@@ -227,7 +227,7 @@ export const cancelSessionRoute = createRoute({
path: '/{session_id}/cancel',
tags: [OpenApiTag.AGENT_SESSIONS],
summary: 'Cancel a running turn in a session',
- description: 'Cancel the running last turn for a session. Only the session creator (`created_by`) may cancel.',
+ description: 'Cancel the running last turn for a session. Only the session creator may cancel.',
'x-fern-sdk-group-name': ['sessions'],
'x-fern-sdk-method-name': 'cancel',
request: {
@@ -264,7 +264,7 @@ export const listSessionEventsRoute = createRoute({
tags: [OpenApiTag.AGENT_SESSIONS],
summary: 'List session events',
description:
- 'List session events as `{ turn_id, event }` across the active turn branch (newest first), including persisted events from a running tip. Each turn contributes turn.created, content events (model.message, tool.call, …), and turn.done when terminal; streaming deltas are not included. Use `page_token` to paginate backward toward older events while retaining the original branch anchor. Only the session creator (`created_by`) may list events.',
+ 'List session events as `{ turn_id, event }` across the active turn branch (newest first), including persisted events from a running tip. Each turn contributes turn.created, content events (model.message, tool.call, …), and turn.done when terminal; streaming deltas are not included. Use `page_token` to paginate backward toward older events while retaining the original branch anchor. Only the session creator may list events.',
'x-fern-sdk-group-name': ['sessions'],
'x-fern-sdk-method-name': 'list_events',
'x-fern-pagination': TOKEN_PAGINATION,
diff --git a/packages/trueforge/src/routes/turnRoutes.ts b/packages/trueforge/src/routes/turnRoutes.ts
index 7d9fe7764..af377371a 100644
--- a/packages/trueforge/src/routes/turnRoutes.ts
+++ b/packages/trueforge/src/routes/turnRoutes.ts
@@ -30,7 +30,7 @@ export const listTurnsRoute = createRoute({
tags: [OpenApiTag.AGENT_SESSIONS],
summary: 'List turns in a session',
description:
- 'List turns for a session (newest first by default), token-paginated. Only the session creator (`created_by`) may list turns.',
+ 'List turns for a session (newest first by default), token-paginated. Only the session creator may list turns.',
'x-fern-sdk-group-name': ['sessions'],
'x-fern-sdk-method-name': 'list_turns',
'x-fern-pagination': TOKEN_PAGINATION,
@@ -63,7 +63,7 @@ export const getTurnRoute = createRoute({
path: '/{session_id}/turns/{turn_id}',
tags: [OpenApiTag.AGENT_SESSIONS],
summary: 'Get a turn',
- description: 'Fetch a single turn by ID. Only the session creator (`created_by`) may fetch it.',
+ description: 'Fetch a single turn by ID. Only the session creator may fetch it.',
'x-fern-sdk-group-name': ['sessions'],
'x-fern-sdk-method-name': 'get_turn',
request: {
@@ -91,7 +91,7 @@ export const downloadSandboxFileRoute = createRoute({
tags: [OpenApiTag.AGENT_SESSIONS],
summary: 'Download a file from the turn sandbox',
description:
- "Download a file from the sandbox this turn ran in. Paths come from the assistant's `sandbox_artifacts` block. Only the session creator (`created_by`) may download.",
+ "Download a file from the sandbox this turn ran in. Paths come from the assistant's `sandbox_artifacts` block. Only the session creator may download.",
'x-fern-sdk-group-name': ['sessions'],
'x-fern-sdk-method-name': 'download_sandbox_file',
request: {
@@ -140,7 +140,7 @@ export const listTurnEventsRoute = createRoute({
tags: [OpenApiTag.AGENT_SESSIONS],
summary: 'List turn events',
description:
- 'Paginated persisted events for a turn (insertion order by default). Only the session creator (`created_by`) may list events.',
+ 'Paginated persisted events for a turn (insertion order by default). Only the session creator may list events.',
'x-fern-sdk-group-name': ['sessions'],
'x-fern-sdk-method-name': 'list_turn_events',
'x-fern-pagination': TOKEN_PAGINATION,
@@ -174,7 +174,7 @@ export const createAndExecuteTurnRoute = createRoute({
tags: [OpenApiTag.AGENT_SESSIONS],
summary: 'Create and execute a turn in a session',
description: `Create a turn within a session and execute it.
-Only the session creator (\`created_by\`) may create turns.
+Only the session creator may create turns.
When \`stream\` is true (default), respond with a Server-Sent Events stream of turn events.
When \`stream\` is false, return the turn immediately with \`state.status: "running"\` while execution continues in the background; use get turn or subscribe to observe completion.
Use \`previous_turn_id\` to chain to the session's last turn (defaults to \`auto\`); use \`none\` for a new root.`,
@@ -248,7 +248,7 @@ export const subscribeTurnRoute = createRoute({
tags: [OpenApiTag.AGENT_SESSIONS],
summary: 'Subscribe to a running turn',
description:
- 'Subscribe to the live SSE stream for a turn. Only the session creator (`created_by`) may subscribe. Pass `after_sequence_number` to resume after a disconnect (exclusive — events after this sequence number are replayed).',
+ 'Subscribe to the live SSE stream for a turn. Only the session creator may subscribe. Pass `after_sequence_number` to resume after a disconnect (exclusive — events after this sequence number are replayed).',
'x-fern-sdk-group-name': ['sessions'],
'x-fern-sdk-method-name': 'subscribe_to_turn',
'x-fern-streaming': { format: 'sse', resumable: true },
diff --git a/packages/trueforge/src/schemas/agent.ts b/packages/trueforge/src/schemas/agent.ts
index 0c484c67f..7ab0d5ebc 100644
--- a/packages/trueforge/src/schemas/agent.ts
+++ b/packages/trueforge/src/schemas/agent.ts
@@ -3,7 +3,7 @@
* AgentSpec document (JSON key `manifest`).
*/
import { z } from '@hono/zod-openapi';
-import { AgentSpecSchema } from '@truefoundry/trueforge-core/agent-session';
+import { AgentSpecSchema, CreatedBySubjectSchema } from '@truefoundry/trueforge-core/agent-session';
import { NameSchema } from './common';
/** Create body: unique immutable `name` plus manifest. `id` is never client-supplied. */
@@ -29,6 +29,7 @@ export const AgentSchema = z
id: z.string().min(1).describe('Immutable server-generated agent identifier.'),
name: NameSchema,
manifest: AgentSpecSchema,
+ created_by_subject: CreatedBySubjectSchema,
})
.strict()
.openapi('Agent');
diff --git a/packages/trueforge/src/schemas/schedule.ts b/packages/trueforge/src/schemas/schedule.ts
index bf6b0c399..d2c2d5b3b 100644
--- a/packages/trueforge/src/schemas/schedule.ts
+++ b/packages/trueforge/src/schemas/schedule.ts
@@ -1,5 +1,5 @@
import { z } from '@hono/zod-openapi';
-import { TokenPaginationSchema } from '@truefoundry/trueforge-core/agent-session';
+import { CreatedBySubjectSchema, TokenPaginationSchema } from '@truefoundry/trueforge-core/agent-session';
import { NameSchema } from './common';
/**
@@ -95,7 +95,7 @@ export const ScheduleSchema = z
agent_name: NameSchema,
name: NameSchema,
manifest: ScheduleManifestSchema,
- created_by: z.string(),
+ created_by_subject: CreatedBySubjectSchema,
created_at: IsoTimestamp,
updated_at: IsoTimestamp,
})
@@ -144,7 +144,7 @@ export const ScheduleRunSchema = z
name: z.string(),
scheduled_for: IsoTimestamp,
status: ScheduleRunStatusSchema,
- triggered_by: z.string(),
+ created_by_subject: CreatedBySubjectSchema,
triggered_at: NullableIsoTimestamp,
created_at: IsoTimestamp,
updated_at: IsoTimestamp,
diff --git a/packages/trueforge/tests/db/agentStoreContractSuite.ts b/packages/trueforge/tests/db/agentStoreContractSuite.ts
index 157ec3f8f..70cef21fc 100644
--- a/packages/trueforge/tests/db/agentStoreContractSuite.ts
+++ b/packages/trueforge/tests/db/agentStoreContractSuite.ts
@@ -2,11 +2,17 @@
* Backend-agnostic behavioural contract for IAgentStore.
* Runs under jest against a fresh store per test (see backend test files).
*/
-import { AgentSpecSchema, type AgentSpec } from '@truefoundry/trueforge-core/agent-session';
+import { AgentSpecSchema, type AgentSpec, type CreatedBySubject } from '@truefoundry/trueforge-core/agent-session';
import { AgentExternalIdConflictError, AgentNameConflictError, type IAgentStore } from '../../src/db/agentStore';
const TENANT = 'default';
+const CREATED_BY_SUBJECT: CreatedBySubject = {
+ subject_id: 'tester',
+ subject_type: 'user',
+ subject_display_name: 'tester',
+};
+
function manifest(overrides: Partial<AgentSpec> = {}): AgentSpec {
return AgentSpecSchema.parse({
model: { name: 'anthropic/claude-sonnet-4-6' },
@@ -22,6 +28,7 @@ export function runAgentStoreContractSuite(getStore: () => IAgentStore): void {
const store = getStore();
const created = await store.createAgent({
tenant_id: TENANT,
+ created_by_subject: CREATED_BY_SUBJECT,
name: 'research',
manifest: manifest(),
external_id: null,
@@ -32,6 +39,7 @@ export function runAgentStoreContractSuite(getStore: () => IAgentStore): void {
expect(created.id.length).toBeGreaterThan(0);
expect(created.manifest).toEqual(manifest());
expect(created.external_id).toBeNull();
+ expect(created.created_by_subject).toEqual(CREATED_BY_SUBJECT);
expect(created.created_at).toMatch(ISO_UTC);
expect(created.updated_at).toBe(created.created_at);
@@ -52,6 +60,7 @@ export function runAgentStoreContractSuite(getStore: () => IAgentStore): void {
const store = getStore();
const created = await store.createAgent({
tenant_id: TENANT,
+ created_by_subject: CREATED_BY_SUBJECT,
name: 'research',
manifest: manifest(),
external_id: null,
@@ -96,6 +105,7 @@ export function runAgentStoreContractSuite(getStore: () => IAgentStore): void {
const store = getStore();
await store.createAgent({
tenant_id: TENANT,
+ created_by_subject: CREATED_BY_SUBJECT,
name: 'research',
manifest: manifest(),
external_id: null,
@@ -104,6 +114,7 @@ export function runAgentStoreContractSuite(getStore: () => IAgentStore): void {
await expect(
store.createAgent({
tenant_id: TENANT,
+ created_by_subject: CREATED_BY_SUBJECT,
name: 'research',
manifest: manifest(),
external_id: null,
@@ -115,18 +126,21 @@ export function runAgentStoreContractSuite(getStore: () => IAgentStore): void {
const store = getStore();
await store.createAgent({
tenant_id: TENANT,
+ created_by_subject: CREATED_BY_SUBJECT,
name: 'zeta',
manifest: manifest(),
external_id: null,
});
await store.createAgent({
tenant_id: TENANT,
+ created_by_subject: CREATED_BY_SUBJECT,
name: 'alpha',
manifest: manifest({ instructions: 'Alpha agent.' }),
external_id: null,
});
await store.createAgent({
tenant_id: 'other-tenant',
+ created_by_subject: CREATED_BY_SUBJECT,
name: 'research',
manifest: manifest(),
external_id: null,
@@ -141,6 +155,7 @@ export function runAgentStoreContractSuite(getStore: () => IAgentStore): void {
const store = getStore();
const created = await store.createAgent({
tenant_id: TENANT,
+ created_by_subject: CREATED_BY_SUBJECT,
name: 'research',
manifest: manifest(),
external_id: null,
@@ -153,6 +168,7 @@ export function runAgentStoreContractSuite(getStore: () => IAgentStore): void {
const store = getStore();
const created = await store.createAgent({
tenant_id: TENANT,
+ created_by_subject: CREATED_BY_SUBJECT,
name: 'research',
manifest: manifest(),
external_id: 'sf-agent-1',
@@ -165,6 +181,7 @@ export function runAgentStoreContractSuite(getStore: () => IAgentStore): void {
const store = getStore();
await store.createAgent({
tenant_id: TENANT,
+ created_by_subject: CREATED_BY_SUBJECT,
name: 'alpha',
manifest: manifest(),
external_id: 'shared-key',
@@ -172,6 +189,7 @@ export function runAgentStoreContractSuite(getStore: () => IAgentStore): void {
await expect(
store.createAgent({
tenant_id: TENANT,
+ created_by_subject: CREATED_BY_SUBJECT,
name: 'beta',
manifest: manifest(),
external_id: 'shared-key',
@@ -179,18 +197,32 @@ export function runAgentStoreContractSuite(getStore: () => IAgentStore): void {
).rejects.toBeInstanceOf(AgentExternalIdConflictError);
await store.createAgent({
tenant_id: 'other-tenant',
+ created_by_subject: CREATED_BY_SUBJECT,
name: 'alpha',
manifest: manifest(),
external_id: 'shared-key',
});
- await store.createAgent({ tenant_id: TENANT, name: 'gamma', manifest: manifest(), external_id: null });
- await store.createAgent({ tenant_id: TENANT, name: 'delta', manifest: manifest(), external_id: null });
+ await store.createAgent({
+ tenant_id: TENANT,
+ created_by_subject: CREATED_BY_SUBJECT,
+ name: 'gamma',
+ manifest: manifest(),
+ external_id: null,
+ });
+ await store.createAgent({
+ tenant_id: TENANT,
+ created_by_subject: CREATED_BY_SUBJECT,
+ name: 'delta',
+ manifest: manifest(),
+ external_id: null,
+ });
});
it('updateAgent can write and clear external_id', async () => {
const store = getStore();
const created = await store.createAgent({
tenant_id: TENANT,
+ created_by_subject: CREATED_BY_SUBJECT,
name: 'research',
manifest: manifest(),
external_id: null,
@@ -213,12 +245,14 @@ export function runAgentStoreContractSuite(getStore: () => IAgentStore): void {
const store = getStore();
await store.createAgent({
tenant_id: TENANT,
+ created_by_subject: CREATED_BY_SUBJECT,
name: 'alpha',
manifest: manifest(),
external_id: 'shared-key',
});
const beta = await store.createAgent({
tenant_id: TENANT,
+ created_by_subject: CREATED_BY_SUBJECT,
name: 'beta',
manifest: manifest(),
external_id: null,
diff --git a/packages/trueforge/tests/db/scheduleDispatchContractSuite.ts b/packages/trueforge/tests/db/scheduleDispatchContractSuite.ts
index d6a9b15b6..e6e34b80e 100644
--- a/packages/trueforge/tests/db/scheduleDispatchContractSuite.ts
+++ b/packages/trueforge/tests/db/scheduleDispatchContractSuite.ts
@@ -1,4 +1,4 @@
-import { AgentSpecSchema } from '@truefoundry/trueforge-core/agent-session';
+import { AgentSpecSchema, type CreatedBySubject } from '@truefoundry/trueforge-core/agent-session';
import { createLogger } from 'winston';
import { dispatchScheduledRuns } from '../../src/controller/scheduleDispatch';
@@ -16,8 +16,18 @@ import { ScheduleManifestSchema, type ScheduleManifest } from '../../src/schemas
const TENANT = 'default';
/** Schedule creator. Every advanced run must be attributed to this identity. */
const USER = 'tester';
-/** Distinct from {@link USER}, so `triggered_by` assertions cannot pass by aliasing. */
+const USER_SUBJECT: CreatedBySubject = {
+ subject_id: USER,
+ subject_type: 'user',
+ subject_display_name: USER,
+};
+/** Distinct from {@link USER}, so `created_by_subject` assertions cannot pass by aliasing. */
const OTHER_ACTOR = 'someone-else';
+const OTHER_ACTOR_SUBJECT: CreatedBySubject = {
+ subject_id: OTHER_ACTOR,
+ subject_type: 'user',
+ subject_display_name: OTHER_ACTOR,
+};
const CRON = '0 * * * *';
/**
* Triggers every minute. Used where a past `scheduled_for` must produce a DIFFERENT
@@ -59,6 +69,7 @@ export function runScheduleDispatchContractSuite<TTransaction>(deps: {
seq += 1;
const agent = await deps.getAgentStore().createAgent({
tenant_id: TENANT,
+ created_by_subject: USER_SUBJECT,
name: `agent-${String(Date.now())}-${String(seq)}`,
manifest: AgentSpecSchema.parse({
model: { name: 'anthropic/claude-sonnet-4-6' },
@@ -90,7 +101,7 @@ export function runScheduleDispatchContractSuite<TTransaction>(deps: {
status?: 'active' | 'paused';
scheduledFor: Date;
cron?: string;
- triggeredBy?: string;
+ createdBySubject?: CreatedBySubject;
}): Promise<{ schedule: ScheduleRecord; run: ScheduleRunRecord }> {
const store = deps.getScheduleStore();
const agentName = await seedAgent();
@@ -101,7 +112,7 @@ export function runScheduleDispatchContractSuite<TTransaction>(deps: {
agent_name: agentName,
name: `sched-${String(Date.now())}-${String(seq)}`,
manifest: manifest({ status, cron }),
- created_by: USER,
+ created_by_subject: USER_SUBJECT,
// Far enough ahead so that it doesnt clash with actual test.
runFrom: new Date(Date.now() + 10 * 365 * 24 * 3600 * 1000),
});
@@ -115,7 +126,7 @@ export function runScheduleDispatchContractSuite<TTransaction>(deps: {
name: `test-${String(Date.now())}-${String(seq)}`,
scheduled_for: params.scheduledFor,
status: 'scheduled',
- triggered_by: params.triggeredBy ?? USER,
+ created_by_subject: params.createdBySubject ?? USER_SUBJECT,
});
return { schedule, run };
}
@@ -125,7 +136,7 @@ export function runScheduleDispatchContractSuite<TTransaction>(deps: {
const pastScheduledFor = new Date(Date.now() - 60_000);
const { schedule, run } = await seedSchedule({
scheduledFor: pastScheduledFor,
- triggeredBy: OTHER_ACTOR,
+ createdBySubject: OTHER_ACTOR_SUBJECT,
});
const triggered: ScheduleDispatchItem[] = [];
const before = Date.now();
@@ -160,7 +171,7 @@ export function runScheduleDispatchContractSuite<TTransaction>(deps: {
expect.objectContaining({
schedule_id: schedule.id,
status: 'scheduled',
- triggered_by: USER,
+ created_by_subject: USER_SUBJECT,
}),
);
expect(next?.id).not.toBe(run.id);
diff --git a/packages/trueforge/tests/db/scheduleStoreContractSuite.ts b/packages/trueforge/tests/db/scheduleStoreContractSuite.ts
index 7097e5657..4218e39ee 100644
--- a/packages/trueforge/tests/db/scheduleStoreContractSuite.ts
+++ b/packages/trueforge/tests/db/scheduleStoreContractSuite.ts
@@ -1,4 +1,4 @@
-import { AgentSpecSchema } from '@truefoundry/trueforge-core/agent-session';
+import { AgentSpecSchema, type CreatedBySubject } from '@truefoundry/trueforge-core/agent-session';
import type { IAgentStore } from '../../src/db/agentStore';
import { cronRunName, ScheduleNameConflictError, type IScheduleStore } from '../../src/db/scheduleStore';
import { nextTriggerAfter } from '../../src/runtime/cron';
@@ -6,6 +6,11 @@ import { ScheduleManifestSchema, type ScheduleManifest } from '../../src/schemas
const TENANT = 'default';
const USER = 'tester';
+const USER_SUBJECT: CreatedBySubject = {
+ subject_id: USER,
+ subject_type: 'user',
+ subject_display_name: USER,
+};
function manifest(overrides: Partial<ScheduleManifest> = {}): ScheduleManifest {
return ScheduleManifestSchema.parse({
@@ -24,6 +29,7 @@ export function runScheduleStoreContractSuite(deps: {
async function seedAgent(): Promise<{ id: string; name: string }> {
const agent = await deps.getAgentStore().createAgent({
tenant_id: TENANT,
+ created_by_subject: USER_SUBJECT,
name: `agent-${String(Date.now())}-${String(Math.random()).slice(2, 8)}`,
manifest: AgentSpecSchema.parse({
model: { name: 'anthropic/claude-sonnet-4-6' },
@@ -45,7 +51,7 @@ export function runScheduleStoreContractSuite(deps: {
agent_name: agent.name,
name: 'daily',
manifest: m,
- created_by: USER,
+ created_by_subject: USER_SUBJECT,
runFrom,
});
@@ -53,7 +59,7 @@ export function runScheduleStoreContractSuite(deps: {
expect.objectContaining({
schedule_id: schedule.id,
status: 'scheduled',
- triggered_by: USER,
+ created_by_subject: USER_SUBJECT,
scheduled_for: nextTriggerAfter({ cron: m.cron, timezone: m.timezone, from: runFrom }).toISOString(),
}),
);
@@ -68,7 +74,7 @@ export function runScheduleStoreContractSuite(deps: {
agent_name: agent.name,
name: 'paused-at-create',
manifest: manifest({ status: 'paused' }),
- created_by: USER,
+ created_by_subject: USER_SUBJECT,
runFrom: new Date(),
});
@@ -84,7 +90,7 @@ export function runScheduleStoreContractSuite(deps: {
agent_name: agent.name,
name: 'toggle',
manifest: manifest({ cron: '0 * * * *', timezone: 'UTC' }),
- created_by: USER,
+ created_by_subject: USER_SUBJECT,
runFrom: new Date('2026-08-27T10:15:00.000Z'),
});
expect(await store.getScheduledRunFor({ tenant_id: TENANT, schedule_id: schedule.id })).toBeDefined();
@@ -122,7 +128,7 @@ export function runScheduleStoreContractSuite(deps: {
agent_name: agent.name,
name: 'reclock',
manifest: manifest({ cron: '0 9 * * *', timezone: 'UTC' }),
- created_by: USER,
+ created_by_subject: USER_SUBJECT,
runFrom,
});
expect(first?.scheduled_for).toBe(
@@ -154,7 +160,7 @@ export function runScheduleStoreContractSuite(deps: {
agent_name: agent.name,
name: 'label-only',
manifest: manifest({ cron: '0 9 * * *', timezone: 'UTC', task: 'old task' }),
- created_by: USER,
+ created_by_subject: USER_SUBJECT,
runFrom,
});
expect(first).toBeDefined();
@@ -183,7 +189,7 @@ export function runScheduleStoreContractSuite(deps: {
agent_name: agent.name,
name,
manifest: manifest({ status: 'paused' }),
- created_by: USER,
+ created_by_subject: USER_SUBJECT,
runFrom: new Date(),
});
@@ -200,7 +206,7 @@ export function runScheduleStoreContractSuite(deps: {
agent_name: agentName,
name: 'daily-report',
manifest: manifest({ status: 'paused' }),
- created_by: USER,
+ created_by_subject: USER_SUBJECT,
runFrom: new Date(),
});
@@ -216,7 +222,7 @@ export function runScheduleStoreContractSuite(deps: {
agent_name: agent.name,
name: 'taken',
manifest: manifest({ status: 'paused' }),
- created_by: USER,
+ created_by_subject: USER_SUBJECT,
runFrom: new Date(),
});
const { schedule: other } = await store.createScheduleAndRun({
@@ -224,7 +230,7 @@ export function runScheduleStoreContractSuite(deps: {
agent_name: agent.name,
name: 'free',
manifest: manifest({ status: 'paused' }),
- created_by: USER,
+ created_by_subject: USER_SUBJECT,
runFrom: new Date(),
});
@@ -247,7 +253,7 @@ export function runScheduleStoreContractSuite(deps: {
agent_name: agent.name,
name: 'paused-edit',
manifest: manifest({ status: 'paused', cron: '0 9 * * *' }),
- created_by: USER,
+ created_by_subject: USER_SUBJECT,
runFrom: new Date('2026-08-27T08:00:00.000Z'),
});
@@ -274,7 +280,7 @@ export function runScheduleStoreContractSuite(deps: {
agent_name: agent.name,
name,
manifest: manifest({ status: 'paused' }),
- created_by: USER,
+ created_by_subject: USER_SUBJECT,
runFrom: new Date(),
});
return schedule;
@@ -290,7 +296,7 @@ export function runScheduleStoreContractSuite(deps: {
name: cronRunName(past),
scheduled_for: past,
status: 'scheduled',
- triggered_by: USER,
+ created_by_subject: USER_SUBJECT,
});
const triggeredSeed = await store.createRun({
@@ -299,7 +305,7 @@ export function runScheduleStoreContractSuite(deps: {
name: cronRunName(past),
scheduled_for: past,
status: 'scheduled',
- triggered_by: USER,
+ created_by_subject: USER_SUBJECT,
});
await store.updateRunStatus({
tenant_id: TENANT,
@@ -313,7 +319,7 @@ export function runScheduleStoreContractSuite(deps: {
name: cronRunName(future),
scheduled_for: future,
status: 'scheduled',
- triggered_by: USER,
+ created_by_subject: USER_SUBJECT,
});
// `listScheduledRuns` is deliberately unscoped — dispatch sweeps every schedule —
@@ -335,7 +341,7 @@ export function runScheduleStoreContractSuite(deps: {
agent_name: agent.name,
name: 'to-delete',
manifest: manifest({ status: 'paused' }),
- created_by: USER,
+ created_by_subject: USER_SUBJECT,
runFrom: new Date(),
});
@@ -345,7 +351,7 @@ export function runScheduleStoreContractSuite(deps: {
name: cronRunName(past),
scheduled_for: past,
status: 'scheduled',
- triggered_by: USER,
+ created_by_subject: USER_SUBJECT,
});
await store.updateRunStatus({
tenant_id: TENANT,
@@ -359,7 +365,7 @@ export function runScheduleStoreContractSuite(deps: {
name: cronRunName(future),
scheduled_for: future,
status: 'scheduled',
- triggered_by: USER,
+ created_by_subject: USER_SUBJECT,
});
await store.deleteSchedule({ tenant_id: TENANT, id: schedule.id });
@@ -378,7 +384,7 @@ export function runScheduleStoreContractSuite(deps: {
agent_name: 'no-such-agent',
name: 'orphan',
manifest: manifest(),
- created_by: USER,
+ created_by_subject: USER_SUBJECT,
runFrom: new Date(),
}),
).rejects.toThrow();
@@ -392,7 +398,7 @@ export function runScheduleStoreContractSuite(deps: {
agent_name: agent.name,
name: 'bound-to-agent',
manifest: manifest({ cron: '0 * * * *', timezone: 'UTC' }),
- created_by: USER,
+ created_by_subject: USER_SUBJECT,
runFrom: new Date('2026-08-27T10:00:00.000Z'),
});
expect(pendingRun).toBeDefined();
@@ -415,7 +421,7 @@ export function runScheduleStoreContractSuite(deps: {
agent_name: agent.name,
name: 'name-unique',
manifest: manifest({ status: 'paused' }),
- created_by: USER,
+ created_by_subject: USER_SUBJECT,
runFrom: new Date(),
});
@@ -426,7 +432,7 @@ export function runScheduleStoreContractSuite(deps: {
name: cronRunName(triggersAt),
scheduled_for: triggersAt,
status: 'scheduled',
- triggered_by: USER,
+ created_by_subject: USER_SUBJECT,
});
await store.updateRunStatus({ tenant_id: TENANT, id: first.id, status: 'triggered' });
@@ -437,7 +443,7 @@ export function runScheduleStoreContractSuite(deps: {
name: cronRunName(triggersAt),
scheduled_for: triggersAt,
status: 'scheduled',
- triggered_by: USER,
+ created_by_subject: USER_SUBJECT,
}),
).rejects.toThrow();
});
@@ -450,7 +456,7 @@ export function runScheduleStoreContractSuite(deps: {
agent_name: agent.name,
name: 'one-pending',
manifest: manifest({ status: 'paused' }),
- created_by: USER,
+ created_by_subject: USER_SUBJECT,
runFrom: new Date(),
});
@@ -462,7 +468,7 @@ export function runScheduleStoreContractSuite(deps: {
name: cronRunName(firstSlot),
scheduled_for: firstSlot,
status: 'scheduled',
- triggered_by: USER,
+ created_by_subject: USER_SUBJECT,
});
await expect(
@@ -472,7 +478,7 @@ export function runScheduleStoreContractSuite(deps: {
name: cronRunName(secondSlot),
scheduled_for: secondSlot,
status: 'scheduled',
- triggered_by: USER,
+ created_by_subject: USER_SUBJECT,
}),
).rejects.toThrow();
});
@@ -487,7 +493,7 @@ export function runScheduleStoreContractSuite(deps: {
agent_name: agentA.name,
name: 'list-older',
manifest: manifest({ status: 'paused' }),
- created_by: USER,
+ created_by_subject: USER_SUBJECT,
runFrom: new Date(),
});
// Distinct `created_at` so newest-first order is stable.
@@ -497,7 +503,7 @@ export function runScheduleStoreContractSuite(deps: {
agent_name: agentA.name,
name: 'list-newer',
manifest: manifest({ status: 'paused' }),
- created_by: USER,
+ created_by_subject: USER_SUBJECT,
runFrom: new Date(),
});
await new Promise(resolve => setTimeout(resolve, 5));
@@ -506,7 +512,7 @@ export function runScheduleStoreContractSuite(deps: {
agent_name: agentB.name,
name: 'list-other-agent',
manifest: manifest({ status: 'paused' }),
- created_by: USER,
+ created_by_subject: USER_SUBJECT,
runFrom: new Date(),
});
@@ -585,7 +591,7 @@ export function runScheduleStoreContractSuite(deps: {
agent_name: agentA.name,
name: 'runs-a',
manifest: manifest({ status: 'paused' }),
- created_by: USER,
+ created_by_subject: USER_SUBJECT,
runFrom: new Date(),
});
const older = await store.createRun({
@@ -594,7 +600,7 @@ export function runScheduleStoreContractSuite(deps: {
name: cronRunName(olderSlot),
scheduled_for: olderSlot,
status: 'triggered',
- triggered_by: USER,
+ created_by_subject: USER_SUBJECT,
});
const newer = await store.createRun({
tenant_id: TENANT,
@@ -602,7 +608,7 @@ export function runScheduleStoreContractSuite(deps: {
name: cronRunName(newerSlot),
scheduled_for: newerSlot,
status: 'scheduled',
- triggered_by: USER,
+ created_by_subject: USER_SUBJECT,
});
const { schedule: scheduleB } = await store.createScheduleAndRun({
@@ -610,7 +616,7 @@ export function runScheduleStoreContractSuite(deps: {
agent_name: agentB.name,
name: 'runs-b',
manifest: manifest({ status: 'paused' }),
- created_by: USER,
+ created_by_subject: USER_SUBJECT,
runFrom: new Date(),
});
const otherScheduleRun = await store.createRun({
@@ -619,7 +625,7 @@ export function runScheduleStoreContractSuite(deps: {
name: cronRunName(newerSlot),
scheduled_for: newerSlot,
status: 'scheduled',
- triggered_by: USER,
+ created_by_subject: USER_SUBJECT,
});
const forA = await store.listRuns({ tenant_id: TENANT, schedule_id: scheduleA.id });
@@ -638,7 +644,7 @@ export function runScheduleStoreContractSuite(deps: {
agent_name: agent.name,
name: 'run-status',
manifest: manifest({ status: 'paused' }),
- created_by: USER,
+ created_by_subject: USER_SUBJECT,
runFrom: new Date(),
});
@@ -649,7 +655,7 @@ export function runScheduleStoreContractSuite(deps: {
name: cronRunName(triggersAt),
scheduled_for: triggersAt,
status: 'scheduled',
- triggered_by: USER,
+ created_by_subject: USER_SUBJECT,
});
}
diff --git a/packages/trueforge/tests/db/session-metrics/metricsContractSuite.ts b/packages/trueforge/tests/db/session-metrics/metricsContractSuite.ts
index 52e5a2b3e..f63056a54 100644
--- a/packages/trueforge/tests/db/session-metrics/metricsContractSuite.ts
+++ b/packages/trueforge/tests/db/session-metrics/metricsContractSuite.ts
@@ -29,7 +29,7 @@ export function runSessionMetricsStoreContractSuite(
await sessionStore.createSession({
tenant_id: tenant,
session_id: 'metrics-session',
- created_by: 'user-1',
+ created_by_subject: { subject_id: 'user-1', subject_type: 'user', subject_display_name: 'user-1' },
agent: { type: 'reference', id: 'agent-abc', name: 'Agent ABC' },
custom: null,
metadata: {},
@@ -38,7 +38,7 @@ export function runSessionMetricsStoreContractSuite(
await sessionStore.createSession({
tenant_id: tenant,
session_id: 'other-user-metrics-session',
- created_by: 'user-2',
+ created_by_subject: { subject_id: 'user-2', subject_type: 'user', subject_display_name: 'user-2' },
agent: { type: 'reference', id: 'agent-abc', name: 'Agent ABC' },
custom: null,
metadata: {},
@@ -61,7 +61,7 @@ export function runSessionMetricsStoreContractSuite(
const metricsQuery = {
tenant_id: tenant,
agent_id: 'agent-abc',
- created_by: 'user-1',
+ created_by_subject_id: 'user-1',
start_timestamp: start,
end_timestamp: new Date(start.getTime() + 2 * 60 * 60 * 1000),
};
@@ -118,7 +118,7 @@ export function runSessionMetricsStoreContractSuite(
await sessionStore.createSession({
tenant_id: tenant,
session_id: definition.id,
- created_by: 'user-1',
+ created_by_subject: { subject_id: 'user-1', subject_type: 'user', subject_display_name: 'user-1' },
agent: { type: 'reference', id: 'agent-distributions', name: 'Agent Distributions' },
custom: null,
metadata: {},
@@ -144,7 +144,7 @@ export function runSessionMetricsStoreContractSuite(
const meters = await metricsStore.getSessionMetricsMeters({
tenant_id: tenant,
agent_id: 'agent-distributions',
- created_by: 'user-1',
+ created_by_subject_id: 'user-1',
start_timestamp: new Date(Date.now() - 60 * 60 * 1000),
end_timestamp: new Date(Date.now() + 60 * 60 * 1000),
});
@@ -168,7 +168,7 @@ export function runSessionMetricsStoreContractSuite(
await sessionStore.createSession({
tenant_id: tenant,
session_id: 'inflight-session',
- created_by: 'user-1',
+ created_by_subject: { subject_id: 'user-1', subject_type: 'user', subject_display_name: 'user-1' },
agent: { type: 'reference', id: 'agent-inflight', name: 'Agent InFlight' },
custom: null,
metadata: {},
@@ -177,7 +177,7 @@ export function runSessionMetricsStoreContractSuite(
await sessionStore.createSession({
tenant_id: tenant,
session_id: 'completed-session',
- created_by: 'user-1',
+ created_by_subject: { subject_id: 'user-1', subject_type: 'user', subject_display_name: 'user-1' },
agent: { type: 'reference', id: 'agent-inflight', name: 'Agent InFlight' },
custom: null,
metadata: {},
@@ -200,7 +200,7 @@ export function runSessionMetricsStoreContractSuite(
const meters = await metricsStore.getSessionMetricsMeters({
tenant_id: tenant,
agent_id: 'agent-inflight',
- created_by: 'user-1',
+ created_by_subject_id: 'user-1',
start_timestamp: start,
end_timestamp: new Date(start.getTime() + 2 * 60 * 60 * 1000),
});
diff --git a/packages/trueforge/tests/unit/apis/deletedSessionCrud.test.ts b/packages/trueforge/tests/unit/apis/deletedSessionCrud.test.ts
index fc6971e65..e0900f60a 100644
--- a/packages/trueforge/tests/unit/apis/deletedSessionCrud.test.ts
+++ b/packages/trueforge/tests/unit/apis/deletedSessionCrud.test.ts
@@ -76,7 +76,11 @@ describe('public CRUD after session deletion', () => {
await sessionStore.createSession({
tenant_id: 'default',
session_id: 's1',
- created_by: STANDALONE_REQUEST_CONTEXT.subject.id,
+ created_by_subject: {
+ subject_id: STANDALONE_REQUEST_CONTEXT.subject.id,
+ subject_type: STANDALONE_REQUEST_CONTEXT.subject.type,
+ subject_display_name: STANDALONE_REQUEST_CONTEXT.subject.display_name,
+ },
agent: {
type: 'inline',
spec: AgentSpecSchema.parse({
diff --git a/packages/trueforge/tests/unit/apis/sandboxFileDownload.test.ts b/packages/trueforge/tests/unit/apis/sandboxFileDownload.test.ts
index 1f039fa72..0ccf52b74 100644
--- a/packages/trueforge/tests/unit/apis/sandboxFileDownload.test.ts
+++ b/packages/trueforge/tests/unit/apis/sandboxFileDownload.test.ts
@@ -116,7 +116,11 @@ describe('GET /{session_id}/turns/{turn_id}/download-sandbox-file', () => {
const session = await sessions.create({
tenant_id: 'default',
session_id: 'no-turn',
- created_by: STANDALONE_REQUEST_CONTEXT.subject.id,
+ created_by_subject: {
+ subject_id: STANDALONE_REQUEST_CONTEXT.subject.id,
+ subject_type: STANDALONE_REQUEST_CONTEXT.subject.type,
+ subject_display_name: STANDALONE_REQUEST_CONTEXT.subject.display_name,
+ },
agent: { type: 'inline', spec: agentSpec() },
external_id: null,
});
diff --git a/packages/trueforge/tests/unit/apis/schedules.test.ts b/packages/trueforge/tests/unit/apis/schedules.test.ts
index b712ab23c..fc2290cf9 100644
--- a/packages/trueforge/tests/unit/apis/schedules.test.ts
+++ b/packages/trueforge/tests/unit/apis/schedules.test.ts
@@ -54,6 +54,11 @@ async function setup() {
const scheduleStore = new SqliteScheduleStore(db);
await agentStore.createAgent({
tenant_id: 'default',
+ created_by_subject: {
+ subject_id: 'alice',
+ subject_type: 'user',
+ subject_display_name: 'alice',
+ },
name: 'reporter',
manifest: AgentSpecSchema.parse({ model: { name: 'test-provider/test-model' }, instructions: 'test' }),
external_id: null,
@@ -167,6 +172,11 @@ describe('schedule RBAC — creator-scoped, admin sees all', () => {
// A second agent so both schedules can share the same name without colliding.
await agentStore.createAgent({
tenant_id: 'default',
+ created_by_subject: {
+ subject_id: 'alice',
+ subject_type: 'user',
+ subject_display_name: 'alice',
+ },
name: 'reporter-two',
manifest: AgentSpecSchema.parse({ model: { name: 'test-provider/test-model' }, instructions: 'test' }),
external_id: null,
@@ -203,6 +213,11 @@ describe('schedule list agent_names filter', () => {
const { app, asUser, agentStore, postJson } = await setup();
await agentStore.createAgent({
tenant_id: 'default',
+ created_by_subject: {
+ subject_id: 'alice',
+ subject_type: 'user',
+ subject_display_name: 'alice',
+ },
name: 'reporter-two',
manifest: AgentSpecSchema.parse({ model: { name: 'test-provider/test-model' }, instructions: 'test' }),
external_id: null,
@@ -272,7 +287,11 @@ describe('create schedule run', () => {
expect.objectContaining({
schedule_id: scheduleId,
status: 'triggered',
- triggered_by: 'alice',
+ created_by_subject: {
+ subject_id: 'alice',
+ subject_type: 'user',
+ subject_display_name: 'alice',
+ },
name: expect.stringMatching(/^manual-/),
}),
);
@@ -306,7 +325,11 @@ describe('create schedule run', () => {
const res = await postJson('/runs', 'POST', { schedule_id: scheduleId });
expect(res.status).toBe(201);
const body = CreateScheduleRunResponseSchema.parse(await res.json());
- expect(body.data.triggered_by).toBe('root');
+ expect(body.data.created_by_subject).toEqual({
+ subject_id: 'root',
+ subject_type: 'user',
+ subject_display_name: 'root',
+ });
expect(mockedStartScheduleRun).toHaveBeenCalled();
});
diff --git a/packages/trueforge/tests/unit/apis/sessionHttp.test.ts b/packages/trueforge/tests/unit/apis/sessionHttp.test.ts
index 704b9027e..d6a0ce67d 100644
--- a/packages/trueforge/tests/unit/apis/sessionHttp.test.ts
+++ b/packages/trueforge/tests/unit/apis/sessionHttp.test.ts
@@ -105,14 +105,22 @@ describe('sessions HTTP agent binding', () => {
const json = (await res.json()) as {
data: {
id: string;
- created_by: string;
+ created_by_subject: {
+ subject_id: string;
+ subject_type: string;
+ subject_display_name: string;
+ };
agent: { type: 'inline'; spec: { instructions?: string } };
metrics: unknown;
};
};
expect(json.data.agent.type).toBe('inline');
expect(json.data.agent.spec.instructions).toBe('inline');
- expect(json.data.created_by).toBe(STANDALONE_REQUEST_CONTEXT.subject.id);
+ expect(json.data.created_by_subject).toEqual({
+ subject_id: STANDALONE_REQUEST_CONTEXT.subject.id,
+ subject_type: STANDALONE_REQUEST_CONTEXT.subject.type,
+ subject_display_name: STANDALONE_REQUEST_CONTEXT.subject.display_name,
+ });
expect(json.data.metrics).toEqual({ total_cost_in_usd: 0, total_duration_ms: 0, total_turns: 0 });
});
@@ -124,6 +132,11 @@ describe('sessions HTTP agent binding', () => {
it('creates a named session and filters list by agent_id', async () => {
const agent = await agentStore.createAgent({
tenant_id: 'default',
+ created_by_subject: {
+ subject_id: STANDALONE_REQUEST_CONTEXT.subject.id,
+ subject_type: STANDALONE_REQUEST_CONTEXT.subject.type,
+ subject_display_name: STANDALONE_REQUEST_CONTEXT.subject.display_name,
+ },
name: 'named-agent',
manifest: AgentSpecSchema.parse({
model: { name: 'anthropic/claude-sonnet-4-6' },
@@ -151,6 +164,11 @@ describe('sessions HTTP agent binding', () => {
it('returns caller-scoped metrics for a named agent', async () => {
const agent = await agentStore.createAgent({
tenant_id: 'default',
+ created_by_subject: {
+ subject_id: STANDALONE_REQUEST_CONTEXT.subject.id,
+ subject_type: STANDALONE_REQUEST_CONTEXT.subject.type,
+ subject_display_name: STANDALONE_REQUEST_CONTEXT.subject.display_name,
+ },
name: 'metrics-agent',
manifest: inlineSpec,
external_id: null,
@@ -158,7 +176,11 @@ describe('sessions HTTP agent binding', () => {
await sessionStore.createSession({
tenant_id: 'default',
session_id: 'my-metrics-session',
- created_by: STANDALONE_REQUEST_CONTEXT.subject.id,
+ created_by_subject: {
+ subject_id: STANDALONE_REQUEST_CONTEXT.subject.id,
+ subject_type: STANDALONE_REQUEST_CONTEXT.subject.type,
+ subject_display_name: STANDALONE_REQUEST_CONTEXT.subject.display_name,
+ },
agent: { type: 'reference', id: agent.id, name: agent.name },
custom: null,
metadata: {},
@@ -167,7 +189,7 @@ describe('sessions HTTP agent binding', () => {
await sessionStore.createSession({
tenant_id: 'default',
session_id: 'other-user-metrics-session',
- created_by: 'someone-else',
+ created_by_subject: { subject_id: 'someone-else', subject_type: 'user', subject_display_name: 'someone-else' },
agent: { type: 'reference', id: agent.id, name: agent.name },
custom: null,
metadata: {},
@@ -229,7 +251,7 @@ describe('sessions HTTP agent binding', () => {
await sessionStore.createSession({
tenant_id: 'default',
session_id: 'other-user-session',
- created_by: 'someone-else',
+ created_by_subject: { subject_id: 'someone-else', subject_type: 'user', subject_display_name: 'someone-else' },
agent: { type: 'inline', spec: inlineSpec },
custom: null,
metadata: {},
@@ -238,14 +260,34 @@ describe('sessions HTTP agent binding', () => {
const created = await app.request('/', jsonInit('POST', { agent: { spec: inlineSpec } }));
expect(created.status).toBe(201);
- const json = (await created.json()) as { data: { id: string; created_by: string } };
- expect(json.data.created_by).toBe(STANDALONE_REQUEST_CONTEXT.subject.id);
+ const json = (await created.json()) as {
+ data: {
+ id: string;
+ created_by_subject: {
+ subject_id: string;
+ subject_type: string;
+ subject_display_name: string;
+ };
+ };
+ };
+ expect(json.data.created_by_subject).toEqual({
+ subject_id: STANDALONE_REQUEST_CONTEXT.subject.id,
+ subject_type: STANDALONE_REQUEST_CONTEXT.subject.type,
+ subject_display_name: STANDALONE_REQUEST_CONTEXT.subject.display_name,
+ });
const listed = await app.request('/');
expect(listed.status).toBe(200);
- const listedJson = (await listed.json()) as { data: Array<{ id: string; created_by: string }> };
+ const listedJson = (await listed.json()) as {
+ data: Array<{
+ id: string;
+ created_by_subject: { subject_id: string };
+ }>;
+ };
expect(listedJson.data.map(row => row.id)).toEqual([json.data.id]);
- expect(listedJson.data.every(row => row.created_by === STANDALONE_REQUEST_CONTEXT.subject.id)).toBe(true);
+ expect(
+ listedJson.data.every(row => row.created_by_subject.subject_id === STANDALONE_REQUEST_CONTEXT.subject.id),
+ ).toBe(true);
const forbiddenBody = { error: { message: 'Only the session creator can access this session' } };
@@ -276,6 +318,11 @@ describe('sessions HTTP agent binding', () => {
it('rejects PATCH agent on a named session', async () => {
const agent = await agentStore.createAgent({
tenant_id: 'default',
+ created_by_subject: {
+ subject_id: STANDALONE_REQUEST_CONTEXT.subject.id,
+ subject_type: STANDALONE_REQUEST_CONTEXT.subject.type,
+ subject_display_name: STANDALONE_REQUEST_CONTEXT.subject.display_name,
+ },
name: 'named-agent',
manifest: AgentSpecSchema.parse({
model: { name: 'anthropic/claude-sonnet-4-6' },
@@ -397,7 +444,7 @@ describe('sessions HTTP agent binding', () => {
await sessionStore.createSession({
tenant_id: 'default',
session_id: 'someone-elses-session',
- created_by: 'someone-else',
+ created_by_subject: { subject_id: 'someone-else', subject_type: 'user', subject_display_name: 'someone-else' },
agent: { type: 'inline', spec: inlineSpec },
custom: null,
metadata: {},
diff --git a/packages/trueforge/tests/unit/apis/turnHarnessErrorStatus.test.ts b/packages/trueforge/tests/unit/apis/turnHarnessErrorStatus.test.ts
index aa6aeff59..5f61487a9 100644
--- a/packages/trueforge/tests/unit/apis/turnHarnessErrorStatus.test.ts
+++ b/packages/trueforge/tests/unit/apis/turnHarnessErrorStatus.test.ts
@@ -46,7 +46,14 @@ async function postTurnRejectingWith(error: AgentHarnessError): Promise<Response
session_id: 's1',
tenant_id: STANDALONE_REQUEST_CONTEXT.tenant_id,
agent_spec: { model: { name: 'test-provider/test-model' } },
- record: { last_turn_id: null, created_by: STANDALONE_REQUEST_CONTEXT.subject.id },
+ record: {
+ last_turn_id: null,
+ created_by_subject: {
+ subject_id: STANDALONE_REQUEST_CONTEXT.subject.id,
+ subject_type: STANDALONE_REQUEST_CONTEXT.subject.type,
+ subject_display_name: STANDALONE_REQUEST_CONTEXT.subject.display_name,
+ },
+ },
createTurn: () => Promise.reject(error),
}),
} as unknown as Sessions;
diff --git a/packages/trueforge/tests/unit/apis/turns.test.ts b/packages/trueforge/tests/unit/apis/turns.test.ts
index 9e1bddc28..c8ff7f4a2 100644
--- a/packages/trueforge/tests/unit/apis/turns.test.ts
+++ b/packages/trueforge/tests/unit/apis/turns.test.ts
@@ -42,7 +42,7 @@ describe('turns', () => {
await sessionStore.createSession({
tenant_id: 'default',
session_id: 's1',
- created_by: 'someone-else',
+ created_by_subject: { subject_id: 'someone-else', subject_type: 'user', subject_display_name: 'someone-else' },
agent: {
type: 'inline',
spec: AgentSpecSchema.parse({
@@ -146,7 +146,14 @@ describe('turns', () => {
session_id: 's1',
tenant_id: STANDALONE_REQUEST_CONTEXT.tenant_id,
spec: AgentSpecSchema.parse({ model: { name: 'test-provider/test-model' } }),
- record: { last_turn_id: null, created_by: STANDALONE_REQUEST_CONTEXT.subject.id },
+ record: {
+ last_turn_id: null,
+ created_by_subject: {
+ subject_id: STANDALONE_REQUEST_CONTEXT.subject.id,
+ subject_type: STANDALONE_REQUEST_CONTEXT.subject.type,
+ subject_display_name: STANDALONE_REQUEST_CONTEXT.subject.display_name,
+ },
+ },
createTurn: () =>
Promise.resolve({
id: 'turn-non-stream',
@@ -264,7 +271,11 @@ describe('turns', () => {
record: {
session_id: 's1',
last_turn_id: null,
- created_by: STANDALONE_REQUEST_CONTEXT.subject.id,
+ created_by_subject: {
+ subject_id: STANDALONE_REQUEST_CONTEXT.subject.id,
+ subject_type: STANDALONE_REQUEST_CONTEXT.subject.type,
+ subject_display_name: STANDALONE_REQUEST_CONTEXT.subject.display_name,
+ },
agent: { type: 'inline', spec: agentSpec },
},
createTurn: () =>
diff --git a/packages/trueforge/tests/unit/controller/scheduleDispatch.test.ts b/packages/trueforge/tests/unit/controller/scheduleDispatch.test.ts
index d65f2d91b..fbc0572a4 100644
--- a/packages/trueforge/tests/unit/controller/scheduleDispatch.test.ts
+++ b/packages/trueforge/tests/unit/controller/scheduleDispatch.test.ts
@@ -15,7 +15,7 @@ function item(): ScheduleDispatchItem {
name: 'sched-1',
scheduled_for: '2026-08-31T00:00:00.000Z',
status: 'scheduled',
- triggered_by: 'tester',
+ created_by_subject: { subject_id: 'tester', subject_type: 'user', subject_display_name: 'tester' },
triggered_at: null,
created_at: '2026-08-31T00:00:00.000Z',
updated_at: '2026-08-31T00:00:00.000Z',
@@ -32,7 +32,7 @@ function item(): ScheduleDispatchItem {
status: 'active',
}),
status: 'active',
- created_by: 'tester',
+ created_by_subject: { subject_id: 'tester', subject_type: 'user', subject_display_name: 'tester' },
created_at: '2026-08-31T00:00:00.000Z',
updated_at: '2026-08-31T00:00:00.000Z',
},
@@ -151,7 +151,7 @@ describe('startScheduleRun', () => {
expect(getOrCreateByExternalId).toHaveBeenCalledWith({
tenant_id: 'default',
external_id: 'run-1',
- created_by: 'tester',
+ created_by_subject: { subject_id: 'tester', subject_type: 'user', subject_display_name: 'tester' },
agent: { type: 'reference', id: 'agent-1', name: 'reporter' },
});
expect(startTurn).toHaveBeenCalledWith({
diff --git a/packages/trueforge/tests/unit/session-metrics/sessionMetrics.test.ts b/packages/trueforge/tests/unit/session-metrics/sessionMetrics.test.ts
index a3ce36214..18887da66 100644
--- a/packages/trueforge/tests/unit/session-metrics/sessionMetrics.test.ts
+++ b/packages/trueforge/tests/unit/session-metrics/sessionMetrics.test.ts
@@ -24,7 +24,7 @@ describe('session metrics builders', () => {
const query = {
tenant_id: 'default',
agent_id: 'agent-1',
- created_by: 'user-1',
+ created_by_subject_id: 'user-1',
start_timestamp: new Date('2026-08-27T00:00:00.000Z'),
end_timestamp: new Date('2026-08-28T00:00:00.000Z'),
};
@@ -82,7 +82,7 @@ describe('session metrics builders', () => {
const query = {
tenant_id: 'default',
agent_id: 'agent-1',
- created_by: 'user-1',
+ created_by_subject_id: 'user-1',
start_timestamp: new Date('2026-08-27T00:00:00.000Z'),
end_timestamp: new Date('2026-08-27T01:00:00.000Z'),
};