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.mdnew file mode 100644index 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.jsonindex 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.jsonindex 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.tsindex 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 } fexport { 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.tsindex 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'sdiff --git a/packages/trueforge-core/src/agent-session/schemas/session.ts b/packages/trueforge-core/src/agent-session/schemas/session.tsindex 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 = zid: 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.tsnew file mode 100644index 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.tsindex 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.tsindex 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.tsindex 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.tsindex 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.tsindex 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.tsindex 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(+ '[email protected]',+ );});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.tsindex 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.mdindex 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.tsindex 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.tsindex 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.tsnew file mode 100644index 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.tsindex 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.tsindex 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.tsindex 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.tsindex 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.tsindex 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, TrueFexport 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.tsnew file mode 100644index 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.tsindex 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.tsindex 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.tsindex 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, Tcore.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.tsindex 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.tsindex 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.tsindex 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.tsindex 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.tsindex 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.tsindex 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.tsindex 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.tsindex 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<TTransacname: 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.tsindex 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<TTconst { 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<TTif (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<TTif (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<TTname: 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<TTagent_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<TTif (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<TTif (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<TTif (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.tsindex 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.tsindex 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.tsindex 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.tsindex 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'>): booreturn 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.tsindex 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.tsindex 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.tsnew file mode 100644index 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.tsindex 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.tsindex 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.tsnew file mode 100644index 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.tsindex 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<Databasname: 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<Databasmanifest: 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<Databasif (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<Databasname: 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.tsindex 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.tsindex 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.tsindex 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.tsindex 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.tsindex 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.tsindex 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.tsindex 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.tsnew file mode 100644index 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.tsindex 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.tsindex 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.tsindex 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.tsindex 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.tsindex 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.tsindex 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.tsindex 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 = zid: 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.tsindex 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 = zagent_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 = zname: 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.tsindex 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.tsindex 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/schemasconst 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.tsindex 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/schemasconst 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.tsindex 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.tsindex 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.tsindex 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.tsindex 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.tsindex 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.tsindex 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<Responsesession_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.tsindex 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.tsindex 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.tsindex 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'),};