@agentuity/core 2.0.10 → 2.0.12

package/src/services/coder/types.ts

@@ -55,7 +55,7 @@ export type CoderSkillRef = z.infer<typeof CoderSkillRefSchema>;
 export const CoderSessionRepositoryRefSchema = z
 	.object({
 		repoId: z.string().optional().describe('Repository identifier when available'),
-		type: z.string().optional().describe('Repository type (e.g., github, gitlab)'),
+		type: z.string().optional().describe('Repository type (e.g., GitHub, GitLab)'),
 		provider: z.string().optional().describe('Git provider identifier'),
 		owner: z.string().optional().describe('Repository owner or organization'),
 		name: z.string().optional().describe('Repository name'),
@@ -115,6 +115,11 @@ export const CoderWorkspaceDetailSchema = z
 		repoCount: z.number().describe('Number of repositories'),
 		savedSkillIds: z.array(z.string()).describe('Saved skill IDs in workspace'),
 		skillBucketIds: z.array(z.string()).describe('Skill bucket IDs in workspace'),
+		enabledAgents: z
+			.array(z.string())
+			.optional()
+			.default([])
+			.describe('Effective agent roster stored on the workspace'),
 		selectionCount: z.number().describe('Total number of selections'),
 		createdAt: z.string().describe('Creation timestamp (ISO-8601)'),
 		updatedAt: z.string().describe('Last update timestamp (ISO-8601)'),
@@ -123,6 +128,176 @@ export const CoderWorkspaceDetailSchema = z
 	.describe('Workspace detail returned by coder hub');
 export type CoderWorkspaceDetail = z.infer<typeof CoderWorkspaceDetailSchema>;
 
+export const CoderCustomAgentThinkingLevelSchema = z
+	.enum(['off', 'minimal', 'low', 'medium', 'high', 'xhigh'])
+	.describe('Thinking level override for a custom agent');
+export type CoderCustomAgentThinkingLevel = z.infer<typeof CoderCustomAgentThinkingLevelSchema>;
+
+export const CODER_CUSTOM_AGENT_TOOLS = [
+	'read',
+	'ls',
+	'find',
+	'grep',
+	'bash',
+	'write',
+	'edit',
+] as const;
+
+export const CoderCustomAgentToolSchema = z
+	.enum(CODER_CUSTOM_AGENT_TOOLS)
+	.describe('Workspace tool available to a standalone custom agent');
+export type CoderCustomAgentTool = z.infer<typeof CoderCustomAgentToolSchema>;
+
+export const CoderCustomAgentToolResponseSchema = z
+	.union([CoderCustomAgentToolSchema, z.string()])
+	.describe('Workspace tool granted to a standalone custom agent');
+export type CoderCustomAgentToolResponse = z.infer<typeof CoderCustomAgentToolResponseSchema>;
+
+export const CODER_CUSTOM_AGENT_SERVICE_TOOLS = [
+	'session_dashboard',
+	'memory_service_search',
+	'memory_service_store',
+	'memory_service_get',
+	'memory_service_update',
+	'memory_service_delete',
+	'memory_service_list',
+	'memory_service_schema',
+	'memory_service_facets',
+	'context7_search',
+	'grep_app_search',
+	'web_search',
+	'fetch_content',
+	'product_prd_create',
+	'product_prd_get',
+	'product_prd_update',
+	'product_prd_list',
+	'product_task_comment',
+	'session_todo_create',
+	'session_todo_update',
+	'session_todo_list',
+	'session_todo_comment',
+	'session_todo_attach',
+	'product_generate_deck',
+	'sandbox_exec',
+	'loop_get_state',
+	'loop_update_state',
+	'coord_create_job',
+	'coord_add_task',
+	'coord_claim_task',
+	'coord_complete_task',
+	'coord_fail_task',
+	'coord_list_tasks',
+	'coord_job_status',
+	'coord_reserve_file',
+	'coord_release_file',
+	'coord_provide_contract',
+	'coord_check_contract',
+	'coord_send_message',
+	'coord_read_messages',
+	'coord_heartbeat',
+	'coord_spawn_workers',
+] as const;
+
+export const CoderCustomAgentServiceToolSchema = z
+	.enum(CODER_CUSTOM_AGENT_SERVICE_TOOLS)
+	.describe('Service tool available to a standalone custom agent');
+export type CoderCustomAgentServiceTool = z.infer<typeof CoderCustomAgentServiceToolSchema>;
+
+export const CoderCustomAgentServiceToolResponseSchema = z
+	.union([CoderCustomAgentServiceToolSchema, z.string()])
+	.describe('Service tool granted to a standalone custom agent');
+export type CoderCustomAgentServiceToolResponse = z.infer<
+	typeof CoderCustomAgentServiceToolResponseSchema
+>;
+
+export const CoderCustomAgentSnapshotSchema = z
+	.object({
+		slug: z.string().describe('Stable custom agent slug'),
+		displayName: z.string().describe('Human-readable custom agent name'),
+		description: z.string().optional().describe('Optional custom agent description'),
+		instructions: z.string().describe('Standalone custom-agent system prompt'),
+		model: z.string().optional().describe('Optional model override'),
+		thinkingLevel: CoderCustomAgentThinkingLevelSchema.optional().describe(
+			'Optional thinking level override'
+		),
+		headlessCompatible: z
+			.boolean()
+			.describe('Whether the custom agent is safe for non-interactive callers'),
+		tools: z
+			.array(CoderCustomAgentToolResponseSchema)
+			.describe('Workspace tools granted to the custom agent'),
+		serviceTools: z
+			.array(CoderCustomAgentServiceToolResponseSchema)
+			.describe('Service tools granted to the custom agent'),
+		savedSkills: z
+			.array(CoderSkillRefSchema)
+			.describe('Frozen saved-skill refs attached to the custom agent snapshot'),
+		companionAgents: z
+			.array(z.string())
+			.default([])
+			.describe('Companion agents auto-included alongside this custom agent'),
+	})
+	.passthrough()
+	.describe('Custom agent snapshot returned by coder hub');
+export type CoderCustomAgentSnapshot = z.infer<typeof CoderCustomAgentSnapshotSchema>;
+
+export const CoderCustomAgentVersionSchema = CoderCustomAgentSnapshotSchema.extend({
+	id: z.string().describe('Published custom agent version identifier'),
+	agentId: z.string().describe('Parent custom agent identifier'),
+	version: z.number().int().describe('Published version number'),
+	createdByUserId: z.string().describe('User who published the version'),
+	createdAt: z.string().describe('Version creation timestamp (ISO-8601)'),
+})
+	.passthrough()
+	.describe('Published custom agent version returned by coder hub');
+export type CoderCustomAgentVersion = z.infer<typeof CoderCustomAgentVersionSchema>;
+
+export const CoderCustomAgentSchema = CoderCustomAgentSnapshotSchema.extend({
+	id: z.string().describe('Custom agent record identifier'),
+	ownerUserId: z.string().describe('Owner user identifier'),
+	lifecycle: z
+		.enum(['draft', 'published', 'archived'])
+		.describe('Current lifecycle state for the custom agent'),
+	visibility: z.enum(['org', 'private_draft']).describe('Visibility tier for the custom agent'),
+	createdAt: z.string().describe('Creation timestamp (ISO-8601)'),
+	updatedAt: z.string().describe('Last update timestamp (ISO-8601)'),
+	hasPublishedVersion: z
+		.boolean()
+		.describe('Whether the agent has at least one published version'),
+	hasUnpublishedChanges: z
+		.boolean()
+		.describe('Whether the current draft differs from the latest published version'),
+	latestPublishedVersion: z.number().int().optional().describe('Latest published version number'),
+	latestPublishedAt: z.string().optional().describe('Latest published timestamp (ISO-8601)'),
+	published: CoderCustomAgentVersionSchema.optional().describe(
+		'Latest published version snapshot'
+	),
+	draft: CoderCustomAgentSnapshotSchema.optional().describe('Owner-visible draft snapshot'),
+})
+	.passthrough()
+	.describe('Custom agent record returned by coder hub');
+export type CoderCustomAgent = z.infer<typeof CoderCustomAgentSchema>;
+
+export const CoderCustomAgentListResponseSchema = z
+	.object({
+		agents: z.array(CoderCustomAgentSchema).describe('Custom agents returned by coder hub'),
+	})
+	.passthrough()
+	.describe('Response payload for listing custom agents');
+export type CoderCustomAgentListResponse = z.infer<typeof CoderCustomAgentListResponseSchema>;
+
+export const CoderCustomAgentVersionListResponseSchema = z
+	.object({
+		versions: z
+			.array(CoderCustomAgentVersionSchema)
+			.describe('Published custom agent versions returned by coder hub'),
+	})
+	.passthrough()
+	.describe('Response payload for listing custom agent versions');
+export type CoderCustomAgentVersionListResponse = z.infer<
+	typeof CoderCustomAgentVersionListResponseSchema
+>;
+
 export const CoderSavedSkillListResponseSchema = z
 	.object({
 		skills: z.array(CoderSavedSkillSchema).describe('Saved skills returned by coder hub'),
@@ -147,6 +322,20 @@ export const CoderWorkspaceListResponseSchema = z
 	.describe('Response payload for listing workspaces');
 export type CoderWorkspaceListResponse = z.infer<typeof CoderWorkspaceListResponseSchema>;
 
+function hasWorkspaceSelections(input: {
+	repos?: unknown[];
+	savedSkillIds?: unknown[];
+	skillBucketIds?: unknown[];
+	enabledAgents?: unknown[];
+}): boolean {
+	return (
+		(input.repos?.length ?? 0) > 0 ||
+		(input.savedSkillIds?.length ?? 0) > 0 ||
+		(input.skillBucketIds?.length ?? 0) > 0 ||
+		(input.enabledAgents?.length ?? 0) > 0
+	);
+}
+
 export const CoderCreateWorkspaceRequestSchema = z
 	.object({
 		name: z.string().describe('Workspace name'),
@@ -155,10 +344,85 @@ export const CoderCreateWorkspaceRequestSchema = z
 		repos: z.array(CoderSessionRepositoryRefSchema).optional().describe('Repositories'),
 		savedSkillIds: z.array(z.string()).optional().describe('Saved skill IDs'),
 		skillBucketIds: z.array(z.string()).optional().describe('Skill bucket IDs'),
+		enabledAgents: z
+			.array(z.string())
+			.optional()
+			.describe('Effective agent roster to store on the workspace'),
+	})
+	.refine(hasWorkspaceSelections, {
+		message: 'A workspace needs at least one repo, saved skill, skill bucket, or agent',
 	})
 	.describe('Request body for creating a workspace');
 export type CoderCreateWorkspaceRequest = z.infer<typeof CoderCreateWorkspaceRequestSchema>;
 
+export const CoderCreateCustomAgentRequestSchema = z
+	.object({
+		slug: z.string().describe('Stable custom agent slug'),
+		displayName: z.string().describe('Human-readable custom agent name'),
+		description: z.string().optional().describe('Optional custom agent description'),
+		instructions: z.string().describe('Standalone custom-agent system prompt'),
+		model: z.string().optional().describe('Optional model override'),
+		thinkingLevel: CoderCustomAgentThinkingLevelSchema.optional().describe(
+			'Optional thinking level override'
+		),
+		headlessCompatible: z
+			.boolean()
+			.optional()
+			.describe('Whether the custom agent is safe for non-interactive callers'),
+		tools: z
+			.array(CoderCustomAgentToolSchema)
+			.optional()
+			.describe('Workspace tools to grant to the custom agent'),
+		serviceTools: z
+			.array(CoderCustomAgentServiceToolSchema)
+			.optional()
+			.describe('Service tools to grant to the custom agent'),
+		savedSkillIds: z
+			.array(z.string())
+			.optional()
+			.describe('Saved skill row ids to snapshot onto the custom agent'),
+		companionAgents: z
+			.array(z.string())
+			.optional()
+			.describe('Agent names to auto-include alongside this custom agent'),
+	})
+	.describe('Request body for creating a custom agent draft');
+export type CoderCreateCustomAgentRequest = z.infer<typeof CoderCreateCustomAgentRequestSchema>;
+
+export const CoderUpdateCustomAgentRequestSchema = z
+	.object({
+		slug: z.string().optional().describe('Stable custom agent slug'),
+		displayName: z.string().optional().describe('Human-readable custom agent name'),
+		description: z.string().nullable().optional().describe('Optional custom agent description'),
+		instructions: z.string().optional().describe('Standalone custom-agent system prompt'),
+		model: z.string().nullable().optional().describe('Optional model override'),
+		thinkingLevel: CoderCustomAgentThinkingLevelSchema.nullable()
+			.optional()
+			.describe('Optional thinking level override'),
+		headlessCompatible: z
+			.boolean()
+			.optional()
+			.describe('Whether the custom agent is safe for non-interactive callers'),
+		tools: z
+			.array(CoderCustomAgentToolSchema)
+			.optional()
+			.describe('Workspace tools to grant to the custom agent'),
+		serviceTools: z
+			.array(CoderCustomAgentServiceToolSchema)
+			.optional()
+			.describe('Service tools to grant to the custom agent'),
+		savedSkillIds: z
+			.array(z.string())
+			.optional()
+			.describe('Saved skill row ids to snapshot onto the custom agent'),
+		companionAgents: z
+			.array(z.string())
+			.optional()
+			.describe('Agent names to auto-include alongside this custom agent'),
+	})
+	.describe('Request body for updating a custom agent draft');
+export type CoderUpdateCustomAgentRequest = z.infer<typeof CoderUpdateCustomAgentRequestSchema>;
+
 export const CoderSaveSkillRequestSchema = z
 	.object({
 		repo: z.string().describe('Repository identifier'),
@@ -209,10 +473,18 @@ export const CoderCreateSessionRequestSchema = z
 		task: z.string().describe('Primary task prompt for the session'),
 		label: z.string().optional().describe('Human-readable session label'),
 		agent: z.string().optional().describe('Default agent identifier to use for execution'),
+		defaultAgent: z
+			.string()
+			.optional()
+			.describe('Preferred default agent identifier for routing session prompts'),
 		visibility: CoderSessionVisibilitySchema.optional().describe('Session visibility setting'),
 		workflowMode: CoderWorkflowModeSchema.optional().describe('Workflow execution mode'),
 		loop: CoderSessionLoopConfigSchema.optional().describe('Loop mode settings for the session'),
 		tags: z.array(z.string()).optional().describe('Tags applied to the session for filtering'),
+		enabledAgents: z
+			.array(z.string())
+			.optional()
+			.describe('Enabled agent roster to include in the session'),
 		savedSkillIds: z
 			.array(z.string())
 			.optional()
@@ -248,14 +520,72 @@ export const CoderCreateSessionRequestSchema = z
 	.describe('Request body for creating a coder session');
 export type CoderCreateSessionRequest = z.infer<typeof CoderCreateSessionRequestSchema>;
 
+function inferCoderAgentBuilderSessionMode(input: {
+	mode?: 'new' | 'edit' | 'from_session';
+	sourceSessionId?: string;
+	targetAgentId?: string;
+	targetAgentSlug?: string;
+}): 'new' | 'edit' | 'from_session' {
+	if (input.mode) return input.mode;
+	if (input.sourceSessionId) return 'from_session';
+	if (input.targetAgentId || input.targetAgentSlug) return 'edit';
+	return 'new';
+}
+
+export const CoderCreateAgentBuilderSessionRequestSchema = z
+	.object({
+		label: z.string().optional().describe('Builder session label override'),
+		prompt: z.string().optional().describe('Optional user focus for the builder session kickoff'),
+		mode: z
+			.enum(['new', 'edit', 'from_session'])
+			.optional()
+			.describe('Builder launch mode override'),
+		visibility: CoderSessionVisibilitySchema.optional().describe('Builder session visibility'),
+		sourceSessionId: z
+			.string()
+			.optional()
+			.describe('Source session identifier for build-from-session launches'),
+		targetAgentId: z
+			.string()
+			.optional()
+			.describe('Target custom-agent identifier for edit launches'),
+		targetAgentSlug: z.string().optional().describe('Target custom-agent slug for edit launches'),
+	})
+	.superRefine((value, ctx) => {
+		const mode = inferCoderAgentBuilderSessionMode(value);
+		if (mode === 'from_session' && !value.sourceSessionId?.trim()) {
+			ctx.addIssue({
+				code: z.ZodIssueCode.custom,
+				path: ['sourceSessionId'],
+				message: 'sourceSessionId is required for from-session builder launches.',
+			});
+		}
+		if (mode === 'edit' && !value.targetAgentId?.trim() && !value.targetAgentSlug?.trim()) {
+			ctx.addIssue({
+				code: z.ZodIssueCode.custom,
+				path: ['targetAgentId'],
+				message: 'targetAgentId or targetAgentSlug is required for edit launches.',
+			});
+		}
+	})
+	.describe('Request body for creating an agent-builder session');
+export type CoderCreateAgentBuilderSessionRequest = z.infer<
+	typeof CoderCreateAgentBuilderSessionRequestSchema
+>;
+
 export const CoderUpdateSessionRequestSchema = z
 	.object({
 		label: z.string().optional().describe('Updated session label'),
 		agent: z.string().optional().describe('Updated default agent identifier'),
+		defaultAgent: z.string().optional().describe('Updated preferred default agent identifier'),
 		visibility: CoderSessionVisibilitySchema.optional().describe('Updated visibility setting'),
 		workflowMode: CoderWorkflowModeSchema.optional().describe('Updated workflow mode'),
 		loop: CoderSessionLoopConfigSchema.optional().describe('Updated loop mode configuration'),
 		tags: z.array(z.string()).optional().describe('Updated set of tags for the session'),
+		enabledAgents: z
+			.array(z.string())
+			.optional()
+			.describe('Updated enabled agent roster for the session'),
 		skills: z
 			.array(CoderSkillRefSchema)
 			.optional()
@@ -297,6 +627,126 @@ export const CoderSessionWorkspaceSchema = z
 	.describe('Workspace associated with a coder session');
 export type CoderSessionWorkspace = z.infer<typeof CoderSessionWorkspaceSchema>;
 
+export const CoderAgentBuilderSessionModeSchema = z
+	.enum(['new', 'edit', 'from_session'])
+	.describe('Agent-builder launch mode for a builder session');
+export type CoderAgentBuilderSessionMode = z.infer<typeof CoderAgentBuilderSessionModeSchema>;
+
+export const CoderAgentBuilderActionKindSchema = z
+	.enum(['create_draft', 'update_draft', 'publish'])
+	.describe('Durable builder action emitted by an agent-builder session');
+export type CoderAgentBuilderActionKind = z.infer<typeof CoderAgentBuilderActionKindSchema>;
+
+export const CoderAgentBuilderSourceSessionSchema = z
+	.object({
+		sessionId: z.string().describe('Source session identifier linked to the builder session'),
+		label: z.string().optional().describe('Source session label when available'),
+	})
+	.describe('Source session reference used by agent-builder flows');
+export type CoderAgentBuilderSourceSession = z.infer<typeof CoderAgentBuilderSourceSessionSchema>;
+
+export const CoderAgentBuilderTargetAgentSchema = z
+	.object({
+		agentId: z.string().optional().describe('Target custom-agent identifier when editing'),
+		slug: z.string().describe('Target custom-agent slug'),
+		displayName: z.string().optional().describe('Target custom-agent display name'),
+	})
+	.describe('Target custom-agent reference for agent-builder edit flows');
+export type CoderAgentBuilderTargetAgent = z.infer<typeof CoderAgentBuilderTargetAgentSchema>;
+
+export const CoderAgentBuilderProposalSchema = z
+	.object({
+		slug: z.string().optional().describe('Proposed custom-agent slug'),
+		displayName: z.string().optional().describe('Proposed custom-agent name'),
+		description: z.string().optional().describe('Proposed custom-agent description'),
+		instructions: z.string().optional().describe('Proposed custom-agent system prompt'),
+		model: z.string().optional().describe('Proposed model override'),
+		thinkingLevel: CoderCustomAgentThinkingLevelSchema.optional().describe(
+			'Proposed thinking level override'
+		),
+		headlessCompatible: z
+			.boolean()
+			.optional()
+			.describe('Whether the proposed agent is safe for non-interactive callers'),
+		tools: z
+			.array(CoderCustomAgentToolResponseSchema)
+			.default([])
+			.describe('Proposed workspace tools for the agent'),
+		serviceTools: z
+			.array(CoderCustomAgentServiceToolResponseSchema)
+			.default([])
+			.describe('Proposed service tools for the agent'),
+		savedSkills: z
+			.array(CoderSkillRefSchema)
+			.default([])
+			.describe('Proposed frozen skill refs to attach'),
+		companionAgents: z
+			.array(z.string())
+			.default([])
+			.describe('Proposed companion agents to auto-include'),
+	})
+	.passthrough()
+	.describe('Session-scoped agent-builder proposal state');
+export type CoderAgentBuilderProposal = z.infer<typeof CoderAgentBuilderProposalSchema>;
+
+export const CoderAgentBuilderDurableStateSchema = z
+	.object({
+		draftAgentId: z.string().optional().describe('Linked draft custom-agent identifier'),
+		draftAgentSlug: z.string().optional().describe('Linked draft custom-agent slug'),
+		lastPublishedVersion: z
+			.number()
+			.int()
+			.optional()
+			.describe('Latest published version created through the builder flow'),
+	})
+	.describe('Durable agent-library state associated with a builder session');
+export type CoderAgentBuilderDurableState = z.infer<typeof CoderAgentBuilderDurableStateSchema>;
+
+export const CoderAgentBuilderActionStateSchema = z
+	.object({
+		kind: CoderAgentBuilderActionKindSchema.describe('Last durable builder action'),
+		status: z.enum(['completed', 'failed']).describe('Result of the last durable builder action'),
+		occurredAt: z.string().describe('Timestamp of the last durable builder action'),
+		message: z.string().optional().describe('Human-readable builder action result summary'),
+		agentId: z.string().optional().describe('Affected custom-agent identifier'),
+		agentSlug: z.string().optional().describe('Affected custom-agent slug'),
+		publishedVersion: z
+			.number()
+			.int()
+			.optional()
+			.describe('Published version number when publish succeeded'),
+	})
+	.describe('Latest durable action emitted by a builder session');
+export type CoderAgentBuilderActionState = z.infer<typeof CoderAgentBuilderActionStateSchema>;
+
+export const CoderAgentBuilderSessionSummarySchema = z
+	.object({
+		mode: CoderAgentBuilderSessionModeSchema.describe('Builder session mode'),
+		sourceSession: CoderAgentBuilderSourceSessionSchema.optional().describe(
+			'Linked source session when the builder was launched from an existing session'
+		),
+		targetAgent: CoderAgentBuilderTargetAgentSchema.optional().describe(
+			'Target agent baseline when the builder is editing an existing custom agent'
+		),
+		durable: CoderAgentBuilderDurableStateSchema.optional().describe(
+			'Linked durable draft/publish state'
+		),
+		lastAction: CoderAgentBuilderActionStateSchema.optional().describe(
+			'Most recent durable builder action'
+		),
+	})
+	.describe('Projected builder-session summary returned in session listings');
+export type CoderAgentBuilderSessionSummary = z.infer<typeof CoderAgentBuilderSessionSummarySchema>;
+
+export const CoderAgentBuilderSessionStateSchema = CoderAgentBuilderSessionSummarySchema.extend({
+	proposal: CoderAgentBuilderProposalSchema.optional().describe(
+		'Full builder proposal state projected in session detail responses'
+	),
+})
+	.passthrough()
+	.describe('Full builder-session state returned in session details');
+export type CoderAgentBuilderSessionState = z.infer<typeof CoderAgentBuilderSessionStateSchema>;
+
 export const CoderSessionListItemSchema = z
 	.object({
 		sessionId: z.string().describe('Unique session identifier'),
@@ -337,6 +787,14 @@ export const CoderSessionListItemSchema = z
 		participantCount: z.number().describe('Total number of participants in the session'),
 		tags: z.array(z.string()).describe('Tag values attached to the session'),
 		skills: z.array(CoderSkillRefSchema).describe('Skills attached to the session'),
+		enabledAgents: z
+			.array(z.string())
+			.optional()
+			.default([])
+			.describe('Enabled agent roster attached to the session'),
+		builder: CoderAgentBuilderSessionSummarySchema.optional().describe(
+			'Projected builder-session summary when this session is an agent-builder flow'
+		),
 		defaultAgent: z.string().optional().describe('Default agent assigned to session operations'),
 		bucket: CoderSessionBucketSchema.describe('Derived bucket for session listing'),
 		runtimeAvailable: z.boolean().describe('Whether runtime is currently reachable'),
@@ -368,6 +826,9 @@ export const CoderSessionSchema = CoderSessionListItemSchema.extend({
 		.string()
 		.optional()
 		.describe('Last update timestamp for session metadata (ISO-8601)'),
+	builder: CoderAgentBuilderSessionStateSchema.optional().describe(
+		'Full builder-session state when this session is an agent-builder flow'
+	),
 	// These fields are present in list items but may be absent in detail responses
 	lastActivityAt: z.string().optional().describe('Timestamp of most recent activity (ISO-8601)'),
 	taskCount: z.number().optional().describe('Number of tasks associated with the session'),