@agentuity/core 2.0.11 → 2.0.13

package/src/services/coder/types.ts

@@ -113,13 +113,40 @@ export const CoderWorkspaceDetailSchema = z
 		ownerUserId: z.string().describe('Owner user ID'),
 		repos: z.array(CoderSessionRepositoryRefSchema).describe('Repositories in workspace'),
 		repoCount: z.number().describe('Number of repositories'),
+		dependencies: z
+			.array(z.string())
+			.optional()
+			.default([])
+			.describe('APT package dependencies installed into workspace snapshots'),
+		setupScript: z
+			.string()
+			.optional()
+			.default('')
+			.describe('Shell script run while preparing workspace snapshots'),
+		snapshot: z
+			.object({
+				status: z.string().describe('Workspace snapshot build status'),
+				snapshotId: z.string().optional().describe('Created sandbox snapshot ID'),
+				snapshotRef: z.string().optional().describe('Snapshot reference used for sessions'),
+				baseSnapshotRef: z.string().optional().describe('Base session snapshot reference'),
+				baseDriverVersion: z.string().optional().describe('Base driver version stamp'),
+				configHash: z.string().optional().describe('Workspace snapshot input hash'),
+				buildId: z.string().optional().describe('Workspace snapshot build identifier'),
+				requestedAt: z.string().optional().describe('Snapshot build request timestamp'),
+				updatedAt: z.string().optional().describe('Snapshot build update timestamp'),
+				createdAt: z.string().optional().describe('Snapshot creation timestamp'),
+				error: z.string().optional().describe('Snapshot build error message'),
+			})
+			.passthrough()
+			.optional()
+			.describe('Workspace snapshot metadata'),
 		savedSkillIds: z.array(z.string()).describe('Saved skill IDs in workspace'),
 		skillBucketIds: z.array(z.string()).describe('Skill bucket IDs in workspace'),
-		agentSlugs: z
+		enabledAgents: z
 			.array(z.string())
 			.optional()
 			.default([])
-			.describe('Published custom agent slugs in workspace'),
+			.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)'),
@@ -133,7 +160,7 @@ export const CoderCustomAgentThinkingLevelSchema = z
 	.describe('Thinking level override for a custom agent');
 export type CoderCustomAgentThinkingLevel = z.infer<typeof CoderCustomAgentThinkingLevelSchema>;
 
-export const CODER_CUSTOM_AGENT_PI_TOOLS = [
+export const CODER_CUSTOM_AGENT_TOOLS = [
 	'read',
 	'ls',
 	'find',
@@ -143,17 +170,17 @@ export const CODER_CUSTOM_AGENT_PI_TOOLS = [
 	'edit',
 ] as const;
 
-export const CoderCustomAgentPiToolSchema = z
-	.enum(CODER_CUSTOM_AGENT_PI_TOOLS)
+export const CoderCustomAgentToolSchema = z
+	.enum(CODER_CUSTOM_AGENT_TOOLS)
 	.describe('Workspace tool available to a standalone custom agent');
-export type CoderCustomAgentPiTool = z.infer<typeof CoderCustomAgentPiToolSchema>;
+export type CoderCustomAgentTool = z.infer<typeof CoderCustomAgentToolSchema>;
 
-export const CoderCustomAgentPiToolResponseSchema = z
-	.union([CoderCustomAgentPiToolSchema, z.string()])
-	.describe('Pi workspace tool granted to a standalone custom agent');
-export type CoderCustomAgentPiToolResponse = z.infer<typeof CoderCustomAgentPiToolResponseSchema>;
+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_HUB_TOOLS = [
+export const CODER_CUSTOM_AGENT_SERVICE_TOOLS = [
 	'session_dashboard',
 	'memory_service_search',
 	'memory_service_store',
@@ -198,15 +225,17 @@ export const CODER_CUSTOM_AGENT_HUB_TOOLS = [
 	'coord_spawn_workers',
 ] as const;
 
-export const CoderCustomAgentHubToolSchema = z
-	.enum(CODER_CUSTOM_AGENT_HUB_TOOLS)
-	.describe('Hub-managed tool available to a standalone custom agent');
-export type CoderCustomAgentHubTool = z.infer<typeof CoderCustomAgentHubToolSchema>;
+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 CoderCustomAgentHubToolResponseSchema = z
-	.union([CoderCustomAgentHubToolSchema, z.string()])
-	.describe('Hub-managed tool granted to a standalone custom agent');
-export type CoderCustomAgentHubToolResponse = z.infer<typeof CoderCustomAgentHubToolResponseSchema>;
+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({
@@ -221,15 +250,19 @@ export const CoderCustomAgentSnapshotSchema = z
 		headlessCompatible: z
 			.boolean()
 			.describe('Whether the custom agent is safe for non-interactive callers'),
-		piTools: z
-			.array(CoderCustomAgentPiToolResponseSchema)
-			.describe('Pi workspace tools granted to the custom agent'),
-		hubToolNames: z
-			.array(CoderCustomAgentHubToolResponseSchema)
-			.describe('Hub-managed tools granted to the custom agent'),
+		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');
@@ -316,19 +349,105 @@ export const CoderWorkspaceListResponseSchema = z
 	.describe('Response payload for listing workspaces');
 export type CoderWorkspaceListResponse = z.infer<typeof CoderWorkspaceListResponseSchema>;
 
+function hasWorkspaceSelections(input: {
+	repos?: unknown[];
+	dependencies?: unknown[];
+	setupScript?: string;
+	savedSkillIds?: unknown[];
+	skillBucketIds?: unknown[];
+	enabledAgents?: unknown[];
+}): boolean {
+	return (
+		(input.repos?.length ?? 0) > 0 ||
+		(input.dependencies?.length ?? 0) > 0 ||
+		Boolean(input.setupScript?.trim()) ||
+		(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'),
 		description: z.string().optional().describe('Workspace description'),
 		scope: z.enum(['user', 'org']).optional().describe('Workspace scope'),
 		repos: z.array(CoderSessionRepositoryRefSchema).optional().describe('Repositories'),
+		dependencies: z
+			.array(z.string())
+			.optional()
+			.describe('APT package dependencies installed into workspace snapshots'),
+		setupScript: z
+			.string()
+			.optional()
+			.describe('Shell script run while preparing workspace snapshots'),
 		savedSkillIds: z.array(z.string()).optional().describe('Saved skill IDs'),
 		skillBucketIds: z.array(z.string()).optional().describe('Skill bucket IDs'),
-		agentSlugs: z.array(z.string()).optional().describe('Published custom agent slugs'),
+		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, dependency, setup script, saved skill, skill bucket, or agent',
 	})
 	.describe('Request body for creating a workspace');
 export type CoderCreateWorkspaceRequest = z.infer<typeof CoderCreateWorkspaceRequestSchema>;
 
+export const CoderUpdateWorkspaceRequestSchema = z
+	.object({
+		name: z.string().optional().describe('Workspace name'),
+		description: z.string().optional().describe('Workspace description'),
+		scope: z.enum(['user', 'org']).optional().describe('Workspace scope'),
+		repos: z.array(CoderSessionRepositoryRefSchema).optional().describe('Repositories'),
+		dependencies: z
+			.array(z.string())
+			.optional()
+			.describe('APT package dependencies installed into workspace snapshots'),
+		setupScript: z
+			.string()
+			.optional()
+			.describe('Shell script run while preparing workspace snapshots'),
+		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((input) => Object.keys(input).length > 0, {
+		message: 'At least one workspace field must be provided',
+	})
+	.describe('Request body for updating a workspace');
+export type CoderUpdateWorkspaceRequest = z.infer<typeof CoderUpdateWorkspaceRequestSchema>;
+
+export const CoderWorkspaceDependencyValidationResponseSchema = z
+	.object({
+		valid: z.array(z.string()).describe('Valid dependency package specs'),
+		invalid: z
+			.array(
+				z
+					.object({
+						package: z.string().describe('Invalid dependency package spec'),
+						error: z.string().describe('Validation error'),
+						requestedVersion: z.string().optional().describe('Requested package version'),
+						availableVersions: z
+							.array(z.string())
+							.optional()
+							.describe('Available package versions returned by validation'),
+						searchUrl: z.string().describe('Package search URL'),
+					})
+					.passthrough()
+			)
+			.describe('Invalid dependency package specs'),
+	})
+	.passthrough()
+	.describe('Workspace dependency validation result');
+export type CoderWorkspaceDependencyValidationResponse = z.infer<
+	typeof CoderWorkspaceDependencyValidationResponseSchema
+>;
+
 export const CoderCreateCustomAgentRequestSchema = z
 	.object({
 		slug: z.string().describe('Stable custom agent slug'),
@@ -343,18 +462,22 @@ export const CoderCreateCustomAgentRequestSchema = z
 			.boolean()
 			.optional()
 			.describe('Whether the custom agent is safe for non-interactive callers'),
-		piTools: z
-			.array(CoderCustomAgentPiToolSchema)
+		tools: z
+			.array(CoderCustomAgentToolSchema)
 			.optional()
-			.describe('Pi workspace tools to grant to the custom agent'),
-		hubToolNames: z
-			.array(CoderCustomAgentHubToolSchema)
+			.describe('Workspace tools to grant to the custom agent'),
+		serviceTools: z
+			.array(CoderCustomAgentServiceToolSchema)
 			.optional()
-			.describe('Hub-managed tools to grant to the custom agent'),
+			.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>;
@@ -373,18 +496,22 @@ export const CoderUpdateCustomAgentRequestSchema = z
 			.boolean()
 			.optional()
 			.describe('Whether the custom agent is safe for non-interactive callers'),
-		piTools: z
-			.array(CoderCustomAgentPiToolSchema)
+		tools: z
+			.array(CoderCustomAgentToolSchema)
 			.optional()
-			.describe('Pi workspace tools to grant to the custom agent'),
-		hubToolNames: z
-			.array(CoderCustomAgentHubToolSchema)
+			.describe('Workspace tools to grant to the custom agent'),
+		serviceTools: z
+			.array(CoderCustomAgentServiceToolSchema)
 			.optional()
-			.describe('Hub-managed tools to grant to the custom agent'),
+			.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>;
@@ -447,10 +574,10 @@ export const CoderCreateSessionRequestSchema = z
 		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'),
-		agentSlugs: z
+		enabledAgents: z
 			.array(z.string())
 			.optional()
-			.describe('Published custom agent slugs to include in the session'),
+			.describe('Enabled agent roster to include in the session'),
 		savedSkillIds: z
 			.array(z.string())
 			.optional()
@@ -486,6 +613,59 @@ 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'),
@@ -495,10 +675,10 @@ export const CoderUpdateSessionRequestSchema = z
 		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'),
-		agentSlugs: z
+		enabledAgents: z
 			.array(z.string())
 			.optional()
-			.describe('Updated published custom agent slugs included in the session'),
+			.describe('Updated enabled agent roster for the session'),
 		skills: z
 			.array(CoderSkillRefSchema)
 			.optional()
@@ -540,6 +720,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'),
@@ -580,11 +880,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'),
-		agentSlugs: z
+		enabledAgents: z
 			.array(z.string())
 			.optional()
 			.default([])
-			.describe('Published custom agent slugs attached to the session'),
+			.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'),
@@ -616,6 +919,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'),