@inkeep/agents-core 0.71.0 → 0.72.1

package/dist/data-access/manage/subAgentTeamAgentRelations.d.ts

@@ -11,9 +11,9 @@ declare const getSubAgentTeamAgentRelationById: (db: AgentsManageDatabaseClient)
 }) => Promise<{
   tenantId: string;
   projectId: string;
+  id: string;
   agentId: string;
   subAgentId: string;
-  id: string;
   createdAt: string;
   updatedAt: string;
   headers: Record<string, string> | null;
@@ -46,9 +46,9 @@ declare const getSubAgentTeamAgentRelations: (db: AgentsManageDatabaseClient) =>
 }) => Promise<{
   tenantId: string;
   projectId: string;
+  id: string;
   agentId: string;
   subAgentId: string;
-  id: string;
   createdAt: string;
   updatedAt: string;
   headers: Record<string, string> | null;
@@ -59,9 +59,9 @@ declare const getSubAgentTeamAgentRelationsByAgent: (db: AgentsManageDatabaseCli
 }) => Promise<{
   tenantId: string;
   projectId: string;
+  id: string;
   agentId: string;
   subAgentId: string;
-  id: string;
   createdAt: string;
   updatedAt: string;
   headers: Record<string, string> | null;
@@ -224,9 +224,9 @@ declare const createSubAgentTeamAgentRelation: (db: AgentsManageDatabaseClient)
 }) => Promise<{
   tenantId: string;
   projectId: string;
+  id: string;
   agentId: string;
   subAgentId: string;
-  id: string;
   createdAt: string;
   updatedAt: string;
   headers: Record<string, string> | null;
@@ -241,9 +241,9 @@ declare const getSubAgentTeamAgentRelationByParams: (db: AgentsManageDatabaseCli
 }) => Promise<{
   tenantId: string;
   projectId: string;
+  id: string;
   agentId: string;
   subAgentId: string;
-  id: string;
   createdAt: string;
   updatedAt: string;
   headers: Record<string, string> | null;
@@ -262,9 +262,9 @@ declare const upsertSubAgentTeamAgentRelation: (db: AgentsManageDatabaseClient)
 }) => Promise<{
   tenantId: string;
   projectId: string;
+  id: string;
   agentId: string;
   subAgentId: string;
-  id: string;
   createdAt: string;
   updatedAt: string;
   headers: Record<string, string> | null;

package/dist/data-access/manage/subAgents.d.ts

@@ -11,12 +11,13 @@ declare const getSubAgentById: (db: AgentsManageDatabaseClient) => (params: {
 }) => Promise<{
   tenantId: string;
   projectId: string;
-  agentId: string;
   id: string;
   name: string;
+  description: string | null;
+  agentId: string;
   createdAt: string;
   updatedAt: string;
-  description: string | null;
+  prompt: string | null;
   models: {
     base?: {
       model?: string | undefined;
@@ -40,7 +41,6 @@ declare const getSubAgentById: (db: AgentsManageDatabaseClient) => (params: {
   stopWhen: {
     stepCountIs?: number | undefined;
   } | null;
-  prompt: string | null;
   conversationHistoryConfig: ConversationHistoryConfig | null;
 } | undefined>;
 declare const listSubAgents: (db: AgentsManageDatabaseClient) => (params: {
@@ -48,12 +48,13 @@ declare const listSubAgents: (db: AgentsManageDatabaseClient) => (params: {
 }) => Promise<{
   tenantId: string;
   projectId: string;
-  agentId: string;
   id: string;
   name: string;
+  description: string | null;
+  agentId: string;
   createdAt: string;
   updatedAt: string;
-  description: string | null;
+  prompt: string | null;
   models: {
     base?: {
       model?: string | undefined;
@@ -77,7 +78,6 @@ declare const listSubAgents: (db: AgentsManageDatabaseClient) => (params: {
   stopWhen: {
     stepCountIs?: number | undefined;
   } | null;
-  prompt: string | null;
   conversationHistoryConfig: ConversationHistoryConfig | null;
 }[]>;
 declare const listSubAgentsPaginated: (db: AgentsManageDatabaseClient) => (params: {
@@ -129,12 +129,13 @@ declare const listSubAgentsPaginated: (db: AgentsManageDatabaseClient) => (param
 declare const createSubAgent: (db: AgentsManageDatabaseClient) => (params: SubAgentInsert) => Promise<{
   tenantId: string;
   projectId: string;
-  agentId: string;
   id: string;
   name: string;
+  description: string | null;
+  agentId: string;
   createdAt: string;
   updatedAt: string;
-  description: string | null;
+  prompt: string | null;
   models: {
     base?: {
       model?: string | undefined;
@@ -158,7 +159,6 @@ declare const createSubAgent: (db: AgentsManageDatabaseClient) => (params: SubAg
   stopWhen: {
     stepCountIs?: number | undefined;
   } | null;
-  prompt: string | null;
   conversationHistoryConfig: ConversationHistoryConfig | null;
 }>;
 declare const updateSubAgent: (db: AgentsManageDatabaseClient) => (params: {

package/dist/data-access/manage/tools.d.ts

@@ -24,16 +24,16 @@ declare const getToolById: (db: AgentsManageDatabaseClient) => (params: {
   projectId: string;
   id: string;
   name: string;
+  description: string | null;
   createdAt: string;
   updatedAt: string;
-  description: string | null;
+  headers: Record<string, string> | null;
   config: {
     type: "mcp";
     mcp: ToolMcpConfig;
   };
   credentialReferenceId: string | null;
   credentialScope: string;
-  headers: Record<string, string> | null;
   imageUrl: string | null;
   capabilities: ToolServerCapabilities | null;
   lastError: string | null;
@@ -82,16 +82,16 @@ declare const createTool: (db: AgentsManageDatabaseClient) => (params: ToolInser
   projectId: string;
   id: string;
   name: string;
+  description: string | null;
   createdAt: string;
   updatedAt: string;
-  description: string | null;
+  headers: Record<string, string> | null;
   config: {
     type: "mcp";
     mcp: ToolMcpConfig;
   };
   credentialReferenceId: string | null;
   credentialScope: string;
-  headers: Record<string, string> | null;
   imageUrl: string | null;
   capabilities: ToolServerCapabilities | null;
   lastError: string | null;
@@ -137,17 +137,17 @@ declare const addToolToAgent: (db: AgentsManageDatabaseClient) => (params: {
 }) => Promise<{
   tenantId: string;
   projectId: string;
+  id: string;
   agentId: string;
   subAgentId: string;
   toolId: string;
-  id: string;
   createdAt: string;
   updatedAt: string;
   headers: Record<string, string> | null;
-  selectedTools: string[] | null;
   toolPolicies: Record<string, {
     needsApproval?: boolean;
   }> | null;
+  selectedTools: string[] | null;
 }>;
 declare const removeToolFromAgent: (db: AgentsManageDatabaseClient) => (params: {
   scopes: AgentScopeConfig;
@@ -156,17 +156,17 @@ declare const removeToolFromAgent: (db: AgentsManageDatabaseClient) => (params:
 }) => Promise<{
   tenantId: string;
   projectId: string;
+  id: string;
   agentId: string;
   subAgentId: string;
   toolId: string;
-  id: string;
   createdAt: string;
   updatedAt: string;
   headers: Record<string, string> | null;
-  selectedTools: string[] | null;
   toolPolicies: Record<string, {
     needsApproval?: boolean;
   }> | null;
+  selectedTools: string[] | null;
 }>;
 /**
  * Upsert agent-tool relation (create if it doesn't exist, update if it does)
@@ -184,17 +184,17 @@ declare const upsertSubAgentToolRelation: (db: AgentsManageDatabaseClient) => (p
 }) => Promise<{
   tenantId: string;
   projectId: string;
+  id: string;
   agentId: string;
   subAgentId: string;
   toolId: string;
-  id: string;
   createdAt: string;
   updatedAt: string;
   headers: Record<string, string> | null;
-  selectedTools: string[] | null;
   toolPolicies: Record<string, {
     needsApproval?: boolean;
   }> | null;
+  selectedTools: string[] | null;
 }>;
 /**
  * Upsert a tool (create if it doesn't exist, update if it does)
@@ -206,16 +206,16 @@ declare const upsertTool: (db: AgentsManageDatabaseClient) => (params: {
   projectId: string;
   id: string;
   name: string;
+  description: string | null;
   createdAt: string;
   updatedAt: string;
-  description: string | null;
+  headers: Record<string, string> | null;
   config: {
     type: "mcp";
     mcp: ToolMcpConfig;
   };
   credentialReferenceId: string | null;
   credentialScope: string;
-  headers: Record<string, string> | null;
   imageUrl: string | null;
   capabilities: ToolServerCapabilities | null;
   lastError: string | null;

package/dist/data-access/runtime/apiKeys.d.ts

@@ -10,9 +10,9 @@ declare const getApiKeyById: (db: AgentsRunDatabaseClient) => (params: {
 }) => Promise<{
   tenantId: string;
   projectId: string;
-  agentId: string;
   id: string;
   name: string | null;
+  agentId: string;
   createdAt: string;
   updatedAt: string;
   expiresAt: string | null;
@@ -24,9 +24,9 @@ declare const getApiKeyById: (db: AgentsRunDatabaseClient) => (params: {
 declare const getApiKeyByPublicId: (db: AgentsRunDatabaseClient) => (publicId: string) => Promise<{
   tenantId: string;
   projectId: string;
-  agentId: string;
   id: string;
   name: string | null;
+  agentId: string;
   createdAt: string;
   updatedAt: string;
   expiresAt: string | null;
@@ -41,9 +41,9 @@ declare const listApiKeys: (db: AgentsRunDatabaseClient) => (params: {
 }) => Promise<{
   tenantId: string;
   projectId: string;
-  agentId: string;
   id: string;
   name: string | null;
+  agentId: string;
   createdAt: string;
   updatedAt: string;
   expiresAt: string | null;
@@ -68,9 +68,9 @@ declare const listApiKeysPaginated: (db: AgentsRunDatabaseClient) => (params: {
 declare const createApiKey: (db: AgentsRunDatabaseClient) => (params: ApiKeyInsert) => Promise<{
   tenantId: string;
   projectId: string;
-  agentId: string;
   id: string;
   name: string | null;
+  agentId: string;
   createdAt: string;
   updatedAt: string;
   expiresAt: string | null;

package/dist/data-access/runtime/apps.d.ts

@@ -7,12 +7,14 @@ import { AppInsert, AppSelect, AppUpdate } from "../../types/entities.js";
 declare const getAppById: (db: AgentsRunDatabaseClient) => (id: string) => Promise<{
   tenantId: string | null;
   projectId: string | null;
-  type: AppType;
   id: string;
   name: string;
+  description: string | null;
+  type: AppType;
   createdAt: string;
   updatedAt: string;
-  description: string | null;
+  enabled: boolean;
+  prompt: string | null;
   config: {
     type: "web_client";
     webClient: {
@@ -43,8 +45,6 @@ declare const getAppById: (db: AgentsRunDatabaseClient) => (id: string) => Promi
       }[] | undefined;
     };
   };
-  prompt: string | null;
-  enabled: boolean;
   lastUsedAt: string | null;
   defaultProjectId: string | null;
   defaultAgentId: string | null;
@@ -76,12 +76,14 @@ declare const listAppsPaginated: (db: AgentsRunDatabaseClient) => (params: {
 declare const createApp: (db: AgentsRunDatabaseClient) => (params: AppInsert) => Promise<{
   tenantId: string | null;
   projectId: string | null;
-  type: AppType;
   id: string;
   name: string;
+  description: string | null;
+  type: AppType;
   createdAt: string;
   updatedAt: string;
-  description: string | null;
+  enabled: boolean;
+  prompt: string | null;
   config: {
     type: "web_client";
     webClient: {
@@ -112,8 +114,6 @@ declare const createApp: (db: AgentsRunDatabaseClient) => (params: AppInsert) =>
       }[] | undefined;
     };
   };
-  prompt: string | null;
-  enabled: boolean;
   lastUsedAt: string | null;
   defaultProjectId: string | null;
   defaultAgentId: string | null;

package/dist/data-access/runtime/cascade-delete.d.ts

@@ -3,8 +3,16 @@ import { AgentsRunDatabaseClient } from "../../db/runtime/runtime-client.js";
 import "../../types/index.js";
 
 //#region src/data-access/runtime/cascade-delete.d.ts
+
 /**
- * Result of a cascade delete operation
+ * Result of a cascade delete operation.
+ *
+ * Conversation-child cleanup strategies in this module (taxonomy):
+ *  - DB-level FK cascade only: feedback
+ *  - DB-level FK cascade plus app-level explicit delete: messages, contextCache
+ *  - App-level only (no FK): events — forward-anchored events may reference
+ *    conversation/message IDs that don't yet exist, so an FK is incompatible
+ *    with the table's analytics-stream semantics (see specs/2026-05-11-events-drop-fk/SPEC.md).
  */
 type CascadeDeleteResult = {
   conversationsDeleted: number;
@@ -20,10 +28,12 @@ type CascadeDeleteResult = {
   appsDeleted: number;
   appDefaultsCleared: number;
   scheduledTriggersDeleted: number;
+  eventsDeleted: number;
 };
 /**
  * Delete all runtime entities for a specific branch.
- * PostgreSQL cascades handle: messages, taskRelations, ledgerArtifacts
+ * PostgreSQL cascades handle: messages, taskRelations, ledgerArtifacts.
+ * Events are deleted explicitly before conversations (no FK cascade).
  *
  * @param db - Runtime database client
  * @returns Function that performs the cascade delete
@@ -36,7 +46,8 @@ declare const cascadeDeleteByBranch: (db: AgentsRunDatabaseClient) => (params: {
 /**
  * Delete all runtime entities for a project across all branches.
  * Used when deleting a project entirely.
- * PostgreSQL cascades handle: messages, taskRelations, ledgerArtifacts
+ * PostgreSQL cascades handle: messages, taskRelations, ledgerArtifacts.
+ * Events are deleted explicitly before conversations (no FK cascade).
  *
  * @param db - Runtime database client
  * @returns Function that performs the cascade delete

package/dist/data-access/runtime/cascade-delete.js

@@ -1,6 +1,7 @@
-import { apiKeys, contextCache, conversations, datasetRun, evaluationRun, scheduledTriggerInvocations, scheduledTriggers, tasks, triggerInvocations, workAppGitHubMcpToolAccessMode, workAppGitHubMcpToolRepositoryAccess, workAppGitHubProjectAccessMode, workAppGitHubProjectRepositoryAccess } from "../../db/runtime/runtime-schema.js";
+import { apiKeys, contextCache, conversations, datasetRun, evaluationRun, events, scheduledTriggerInvocations, scheduledTriggers, tasks, triggerInvocations, workAppGitHubMcpToolAccessMode, workAppGitHubMcpToolRepositoryAccess, workAppGitHubProjectAccessMode, workAppGitHubProjectRepositoryAccess } from "../../db/runtime/runtime-schema.js";
 import { projectScopedWhere } from "../manage/scope-helpers.js";
 import { clearAppDefaultsByAgent, clearAppDefaultsByProject, deleteAppsByProject } from "./apps.js";
+import { deleteEventsByConversationIds } from "./events.js";
 import { deleteSlackMcpToolAccessConfig } from "./slack-work-app-mcp.js";
 import { clearDevConfigWorkspaceDefaultsByAgent, clearDevConfigWorkspaceDefaultsByProject, clearWorkspaceDefaultsByAgent, clearWorkspaceDefaultsByProject, deleteWorkAppSlackChannelAgentConfigsByAgent, deleteWorkAppSlackChannelAgentConfigsByProject } from "./workAppSlack.js";
 import { and, eq, inArray, sql } from "drizzle-orm";
@@ -8,7 +9,8 @@ import { and, eq, inArray, sql } from "drizzle-orm";
 //#region src/data-access/runtime/cascade-delete.ts
 /**
 * Delete all runtime entities for a specific branch.
-* PostgreSQL cascades handle: messages, taskRelations, ledgerArtifacts
+* PostgreSQL cascades handle: messages, taskRelations, ledgerArtifacts.
+* Events are deleted explicitly before conversations (no FK cascade).
 *
 * @param db - Runtime database client
 * @returns Function that performs the cascade delete
@@ -16,6 +18,11 @@ import { and, eq, inArray, sql } from "drizzle-orm";
 const cascadeDeleteByBranch = (db) => async (params) => {
 	const { scopes, fullBranchName, ref } = params;
 	const contextCacheResult = await db.delete(contextCache).where(and(projectScopedWhere(contextCache, scopes), sql`${contextCache.ref}->>'name' = ${fullBranchName}`)).returning();
+	const branchConversationIds = (await db.select({ id: conversations.id }).from(conversations).where(and(projectScopedWhere(conversations, scopes), sql`${conversations.ref}->>'name' = ${fullBranchName}`))).map((c) => c.id);
+	const eventsDeleted = await deleteEventsByConversationIds(db)({
+		scopes,
+		conversationIds: branchConversationIds
+	});
 	const conversationsResult = await db.delete(conversations).where(and(projectScopedWhere(conversations, scopes), sql`${conversations.ref}->>'name' = ${fullBranchName}`)).returning();
 	const tasksResult = await db.delete(tasks).where(and(projectScopedWhere(tasks, scopes), sql`${tasks.ref}->>'name' = ${fullBranchName}`)).returning();
 	const triggerInvocationsResult = await db.delete(triggerInvocations).where(and(eq(triggerInvocations.tenantId, scopes.tenantId), eq(triggerInvocations.projectId, scopes.projectId), sql`${triggerInvocations.ref}->>'name' = ${fullBranchName}`)).returning();
@@ -36,13 +43,15 @@ const cascadeDeleteByBranch = (db) => async (params) => {
 		slackWorkspaceDefaultsCleared: 0,
 		appsDeleted: 0,
 		appDefaultsCleared: 0,
-		scheduledTriggersDeleted: scheduledTriggersResult.length
+		scheduledTriggersDeleted: scheduledTriggersResult.length,
+		eventsDeleted
 	};
 };
 /**
 * Delete all runtime entities for a project across all branches.
 * Used when deleting a project entirely.
-* PostgreSQL cascades handle: messages, taskRelations, ledgerArtifacts
+* PostgreSQL cascades handle: messages, taskRelations, ledgerArtifacts.
+* Events are deleted explicitly before conversations (no FK cascade).
 *
 * @param db - Runtime database client
 * @returns Function that performs the cascade delete
@@ -50,6 +59,7 @@ const cascadeDeleteByBranch = (db) => async (params) => {
 const cascadeDeleteByProject = (db) => async (params) => {
 	const { scopes } = params;
 	const contextCacheResult = await db.delete(contextCache).where(projectScopedWhere(contextCache, scopes)).returning();
+	const eventsResult = await db.delete(events).where(projectScopedWhere(events, scopes)).returning();
 	const conversationsResult = await db.delete(conversations).where(projectScopedWhere(conversations, scopes)).returning();
 	const tasksResult = await db.delete(tasks).where(projectScopedWhere(tasks, scopes)).returning();
 	const triggerInvocationsResult = await db.delete(triggerInvocations).where(and(eq(triggerInvocations.tenantId, scopes.tenantId), eq(triggerInvocations.projectId, scopes.projectId))).returning();
@@ -80,7 +90,8 @@ const cascadeDeleteByProject = (db) => async (params) => {
 		slackWorkspaceDefaultsCleared,
 		appsDeleted,
 		appDefaultsCleared,
-		scheduledTriggersDeleted: scheduledTriggersResult.length
+		scheduledTriggersDeleted: scheduledTriggersResult.length,
+		eventsDeleted: eventsResult.length
 	};
 };
 /**
@@ -97,10 +108,15 @@ const cascadeDeleteByAgent = (db) => async (params) => {
 	let conversationsDeleted = 0;
 	let tasksDeleted = 0;
 	let apiKeysDeleted = 0;
+	let eventsDeleted = 0;
 	if (subAgentIds.length > 0) {
 		const conversationIds = (await db.select({ id: conversations.id }).from(conversations).where(and(projectScopedWhere(conversations, scopes), inArray(conversations.activeSubAgentId, subAgentIds), sql`${conversations.ref}->>'name' = ${fullBranchName}`))).map((c) => c.id);
 		if (conversationIds.length > 0) {
 			contextCacheDeleted = (await db.delete(contextCache).where(and(projectScopedWhere(contextCache, scopes), inArray(contextCache.conversationId, conversationIds))).returning()).length;
+			eventsDeleted = await deleteEventsByConversationIds(db)({
+				scopes,
+				conversationIds
+			});
 			conversationsDeleted = (await db.delete(conversations).where(and(projectScopedWhere(conversations, scopes), inArray(conversations.id, conversationIds))).returning()).length;
 		}
 	}
@@ -126,7 +142,8 @@ const cascadeDeleteByAgent = (db) => async (params) => {
 		slackWorkspaceDefaultsCleared,
 		appsDeleted: 0,
 		appDefaultsCleared,
-		scheduledTriggersDeleted: scheduledTriggersResult.length
+		scheduledTriggersDeleted: scheduledTriggersResult.length,
+		eventsDeleted
 	};
 };
 /**
@@ -140,8 +157,13 @@ const cascadeDeleteBySubAgent = (db) => async (params) => {
 	const conversationIds = (await db.select({ id: conversations.id }).from(conversations).where(and(projectScopedWhere(conversations, scopes), eq(conversations.activeSubAgentId, subAgentId), sql`${conversations.ref}->>'name' = ${fullBranchName}`))).map((c) => c.id);
 	let contextCacheDeleted = 0;
 	let conversationsDeleted = 0;
+	let eventsDeleted = 0;
 	if (conversationIds.length > 0) {
 		contextCacheDeleted = (await db.delete(contextCache).where(and(projectScopedWhere(contextCache, scopes), inArray(contextCache.conversationId, conversationIds))).returning()).length;
+		eventsDeleted = await deleteEventsByConversationIds(db)({
+			scopes,
+			conversationIds
+		});
 		conversationsDeleted = (await db.delete(conversations).where(and(projectScopedWhere(conversations, scopes), inArray(conversations.id, conversationIds))).returning()).length;
 	}
 	const tasksResult = await db.delete(tasks).where(and(projectScopedWhere(tasks, scopes), eq(tasks.subAgentId, subAgentId), sql`${tasks.ref}->>'name' = ${fullBranchName}`)).returning();
@@ -158,7 +180,8 @@ const cascadeDeleteBySubAgent = (db) => async (params) => {
 		slackWorkspaceDefaultsCleared: 0,
 		appsDeleted: 0,
 		appDefaultsCleared: 0,
-		scheduledTriggersDeleted: 0
+		scheduledTriggersDeleted: 0,
+		eventsDeleted
 	};
 };
 /**

package/dist/data-access/runtime/conversations.d.ts

@@ -17,18 +17,20 @@ declare const listConversations: (db: AgentsRunDatabaseClient) => (params: {
 declare const createConversation: (db: AgentsRunDatabaseClient) => (params: ConversationInsert) => Promise<{
   tenantId: string;
   projectId: string;
-  agentId: string | null;
   id: string;
-  createdAt: string;
-  updatedAt: string;
   metadata: ConversationMetadata | null;
+  properties: Record<string, unknown> | null;
   title: string | null;
-  userId: string | null;
+  agentId: string | null;
+  createdAt: string;
+  updatedAt: string;
   ref: {
     type: "commit" | "tag" | "branch";
     name: string;
     hash: string;
   } | null;
+  userId: string | null;
+  userProperties: Record<string, unknown> | null;
   activeSubAgentId: string;
   lastContextResolution: string | null;
 }>;
@@ -50,6 +52,8 @@ declare const updateConversation: (db: AgentsRunDatabaseClient) => (params: {
   title: string | null;
   lastContextResolution: string | null;
   metadata: ConversationMetadata | null;
+  userProperties: Record<string, unknown> | null;
+  properties: Record<string, unknown> | null;
   projectId: string;
   tenantId: string;
   id: string;
@@ -76,6 +80,8 @@ declare const updateConversationActiveSubAgent: (db: AgentsRunDatabaseClient) =>
   title: string | null;
   lastContextResolution: string | null;
   metadata: ConversationMetadata | null;
+  userProperties: Record<string, unknown> | null;
+  properties: Record<string, unknown> | null;
   projectId: string;
   tenantId: string;
   id: string;
@@ -86,18 +92,20 @@ declare const getConversation: (db: AgentsRunDatabaseClient) => (params: {
 }) => Promise<{
   tenantId: string;
   projectId: string;
-  agentId: string | null;
   id: string;
-  createdAt: string;
-  updatedAt: string;
   metadata: ConversationMetadata | null;
+  properties: Record<string, unknown> | null;
   title: string | null;
-  userId: string | null;
+  agentId: string | null;
+  createdAt: string;
+  updatedAt: string;
   ref: {
     type: "commit" | "tag" | "branch";
     name: string;
     hash: string;
   } | null;
+  userId: string | null;
+  userProperties: Record<string, unknown> | null;
   activeSubAgentId: string;
   lastContextResolution: string | null;
 } | undefined>;
@@ -119,21 +127,25 @@ declare const createOrGetConversation: (db: AgentsRunDatabaseClient) => (input:
   lastContextResolution?: string | null | undefined;
   metadata?: ConversationMetadata | null | undefined;
   contextConfigId?: string | undefined;
+  userProperties?: Record<string, unknown> | null | undefined;
+  properties?: Record<string, unknown> | null | undefined;
 } | {
   tenantId: string;
   projectId: string;
-  agentId: string | null;
   id: string;
-  createdAt: string;
-  updatedAt: string;
   metadata: ConversationMetadata | null;
+  properties: Record<string, unknown> | null;
   title: string | null;
-  userId: string | null;
+  agentId: string | null;
+  createdAt: string;
+  updatedAt: string;
   ref: {
     type: "commit" | "tag" | "branch";
     name: string;
     hash: string;
   } | null;
+  userId: string | null;
+  userProperties: Record<string, unknown> | null;
   activeSubAgentId: string;
   lastContextResolution: string | null;
 }>;
@@ -154,18 +166,20 @@ declare const getActiveAgentForConversation: (db: AgentsRunDatabaseClient) => (p
 }) => Promise<{
   tenantId: string;
   projectId: string;
-  agentId: string | null;
   id: string;
-  createdAt: string;
-  updatedAt: string;
   metadata: ConversationMetadata | null;
+  properties: Record<string, unknown> | null;
   title: string | null;
-  userId: string | null;
+  agentId: string | null;
+  createdAt: string;
+  updatedAt: string;
   ref: {
     type: "commit" | "tag" | "branch";
     name: string;
     hash: string;
   } | null;
+  userId: string | null;
+  userProperties: Record<string, unknown> | null;
   activeSubAgentId: string;
   lastContextResolution: string | null;
 } | undefined>;
@@ -180,6 +194,8 @@ declare const setActiveAgentForConversation: (db: AgentsRunDatabaseClient) => (p
   ref: ResolvedRef;
   userId?: string;
   metadata?: ConversationMetadata;
+  userProperties?: Record<string, unknown> | null;
+  properties?: Record<string, unknown> | null;
 }) => Promise<void>;
 declare const setActiveAgentForThread: (db: AgentsRunDatabaseClient) => ({
   scopes,