@otto-code/protocol 0.5.4 → 0.5.6

package/dist/messages.js

@@ -796,7 +796,7 @@ export const AgentSnapshotPayloadSchema = z.object({
     // cost-less local models. Observed subagents source it from the provider's
     // per-task usage.total_tokens (already cumulative-per-subagent). Purely
     // additive; absent ⇒ no readout. Old clients ignore it.
-    // See projects/subagents-cleanup/subagents-cleanup.md (Item 3).
+    // See docs/agent-lifecycle.md (Item 3).
     cumulativeTokens: z.number().optional(),
     lastError: z.string().optional(),
     title: z.string().nullable(),
@@ -815,17 +815,17 @@ export const AgentSnapshotPayloadSchema = z.object({
     // Spinner colors from the Agent Personality this agent was spawned from, so
     // its live thinking indicator renders in the personality's identity. Absent ⇒
     // the client falls back to the theme's default spinner colors. Purely additive
-    // (no daemon floor needed). See projects/agent-personalities/.
+    // (no daemon floor needed). See docs/agent-personalities.md.
     personalitySpinner: AgentPersonalitySpinnerSchema.optional(),
     // Name of the Agent Personality this agent was spawned from, so the running
     // agent's controls keep showing the personality identity (trigger label +
     // effort hidden) instead of reverting to the raw model. Absent ⇒ no bound
-    // personality. Purely additive. See projects/agent-personalities/.
+    // personality. Purely additive. See docs/agent-personalities.md.
     personalityName: z.string().optional(),
     // Stable id of the bound Agent Personality. The client keys roster selection
     // on this (names can be renamed/duplicated); personalityName remains for
     // display and as the selection fallback against daemons that predate this
-    // field. Purely additive. See projects/agent-personalities/.
+    // field. Purely additive. See docs/agent-personalities.md.
     personalityId: z.string().optional(),
 });
 export const AgentListItemPayloadSchema = z.object({
@@ -917,6 +917,30 @@ export const ProjectRemoveRequestSchema = z.object({
     projectId: z.string(),
     requestId: z.string(),
 });
+// An unordered pair of linked projects. The daemon stores the pair in a
+// canonical order, but clients treat it as undirected: a link between A and B
+// permits opening files across both projects. See the gated-multi-root project.
+export const ProjectLinkSchema = z.object({
+    projectAId: z.string(),
+    projectBId: z.string(),
+});
+export const ProjectLinksListRequestSchema = z.object({
+    type: z.literal("project.links.list.request"),
+    requestId: z.string(),
+});
+export const ProjectLinksSetRequestSchema = z.object({
+    type: z.literal("project.links.set.request"),
+    // Order is irrelevant; the daemon canonicalizes. Linking is idempotent.
+    projectId: z.string(),
+    otherProjectId: z.string(),
+    requestId: z.string(),
+});
+export const ProjectLinksUnsetRequestSchema = z.object({
+    type: z.literal("project.links.unset.request"),
+    projectId: z.string(),
+    otherProjectId: z.string(),
+    requestId: z.string(),
+});
 export const WorkspaceTitleSetRequestSchema = z.object({
     type: z.literal("workspace.title.set.request"),
     workspaceId: z.string(),
@@ -1546,6 +1570,71 @@ export const AgentBackgroundTaskClearResponseMessageSchema = z.object({
     type: z.literal("agent.background_task.clear.response"),
     payload: AgentActionResponsePayloadSchema,
 });
+// A suggested task an agent surfaced via the `spawn_task` tool (Claude Desktop
+// parity). Renders as a chip in the parent agent's session; the user starts it
+// (new worktree / local / this session) or dismisses it. The `prompt` is
+// deliberately NOT part of this wire shape — it stays server-side and is only
+// used when the task is started ("not shown directly" in Claude Desktop).
+// COMPAT(suggestedTasks): added in v0.5.6, drop the gate when daemon floor >= v0.5.6.
+export const SuggestedTaskStateSchema = z.enum(["pending", "started", "dismissed"]);
+export const SuggestedTaskInfoSchema = z.object({
+    taskId: z.string(),
+    parentAgentId: z.string(),
+    title: z.string(),
+    tldr: z.string(),
+    cwd: z.string().optional(),
+    state: SuggestedTaskStateSchema,
+    createdAt: z.string(),
+    updatedAt: z.string(),
+});
+// Pushed with the full current set of pending suggested tasks for a parent
+// agent whenever any of them changes (spawn/start/dismiss) — same full-list
+// reconciliation shape as BackgroundShellTasksChangedSchema.
+export const SuggestedTasksChangedSchema = z.object({
+    type: z.literal("suggested_tasks_changed"),
+    payload: z.object({
+        parentAgentId: z.string(),
+        tasks: z.array(SuggestedTaskInfoSchema),
+    }),
+});
+// Aggregate outcome for a start/dismiss over one or more tasks. `succeeded`/
+// `failed` count the tasks acted on so the client can report "Started 3 tasks";
+// `error` collects any per-task failure messages (the failed tasks' chips stay).
+const SuggestedTaskActionResponsePayloadSchema = z.object({
+    requestId: z.string(),
+    parentAgentId: z.string(),
+    accepted: z.boolean(),
+    succeeded: z.number(),
+    failed: z.number(),
+    error: z.string().nullable(),
+});
+// Start one or more suggested tasks, applying the SAME mode to each — no
+// combining. `worktree` spins a new worktree-backed workspace per task, `local`
+// a new session in the same repo/cwd per task, `in_session` steers the parent
+// agent with the task prompt. The daemon resolves the parent agent's brain
+// (provider/model/personality) so a started task continues the suggesting agent.
+export const TasksSuggestedStartModeSchema = z.enum(["worktree", "local", "in_session"]);
+export const TasksSuggestedStartRequestMessageSchema = z.object({
+    type: z.literal("tasks.suggested.start.request"),
+    parentAgentId: z.string(),
+    taskIds: z.array(z.string()),
+    mode: TasksSuggestedStartModeSchema,
+    requestId: z.string(),
+});
+export const TasksSuggestedStartResponseMessageSchema = z.object({
+    type: z.literal("tasks.suggested.start.response"),
+    payload: SuggestedTaskActionResponsePayloadSchema,
+});
+export const TasksSuggestedDismissRequestMessageSchema = z.object({
+    type: z.literal("tasks.suggested.dismiss.request"),
+    parentAgentId: z.string(),
+    taskIds: z.array(z.string()),
+    requestId: z.string(),
+});
+export const TasksSuggestedDismissResponseMessageSchema = z.object({
+    type: z.literal("tasks.suggested.dismiss.response"),
+    payload: SuggestedTaskActionResponsePayloadSchema,
+});
 // Switch a running agent to an Agent Personality (or clear with null). The
 // daemon re-resolves the id against the roster + the agent's cwd provider
 // snapshot and applies the full personality live — system prompt, identity
@@ -1606,6 +1695,39 @@ export const ProjectRemoveResponseSchema = z.object({
     type: z.literal("project.remove.response"),
     payload: ProjectRemoveResponsePayloadSchema,
 });
+export const ProjectLinksListResponsePayloadSchema = z.object({
+    requestId: z.string(),
+    links: z.array(ProjectLinkSchema).default([]),
+    error: z.string().nullable(),
+});
+export const ProjectLinksListResponseSchema = z.object({
+    type: z.literal("project.links.list.response"),
+    payload: ProjectLinksListResponsePayloadSchema,
+});
+export const ProjectLinksMutationResponsePayloadSchema = z.object({
+    requestId: z.string(),
+    accepted: z.boolean(),
+    // The full link set after the mutation, so the client refreshes in one hop.
+    links: z.array(ProjectLinkSchema).default([]),
+    error: z.string().nullable(),
+});
+export const ProjectLinksSetResponseSchema = z.object({
+    type: z.literal("project.links.set.response"),
+    payload: ProjectLinksMutationResponsePayloadSchema,
+});
+export const ProjectLinksUnsetResponseSchema = z.object({
+    type: z.literal("project.links.unset.response"),
+    payload: ProjectLinksMutationResponsePayloadSchema,
+});
+// Pushed to the session whenever the link set changes (mutation or cascade on
+// project removal) so open UIs re-evaluate cross-project access without polling.
+export const ProjectLinksChangedPayloadSchema = z.object({
+    links: z.array(ProjectLinkSchema).default([]),
+});
+export const ProjectLinksChangedSchema = z.object({
+    type: z.literal("project.links.changed"),
+    payload: ProjectLinksChangedPayloadSchema,
+});
 export const WorkspaceTitleSetResponsePayloadSchema = z.object({
     requestId: z.string(),
     workspaceId: z.string(),
@@ -1818,6 +1940,10 @@ export const CheckoutGitRollbackRequestSchema = z.object({
     cwd: z.string(),
     // Repo-relative paths whose uncommitted changes should be discarded.
     paths: z.array(z.string()),
+    // Set after the user confirms rolling back while agents are running in this
+    // workspace; without it the daemon refuses with kind "agents_running", since
+    // discarding a live agent's uncommitted edits mid-run can destroy its work.
+    allowWithRunningAgents: z.boolean().optional(),
     requestId: z.string(),
 });
 export const CheckoutMergeRequestSchema = z.object({
@@ -2457,6 +2583,9 @@ export const SessionInboundMessageSchema = z.discriminatedUnion("type", [
     UpdateAgentRequestMessageSchema,
     ProjectRenameRequestSchema,
     ProjectRemoveRequestSchema,
+    ProjectLinksListRequestSchema,
+    ProjectLinksSetRequestSchema,
+    ProjectLinksUnsetRequestSchema,
     WorkspaceTitleSetRequestSchema,
     SetVoiceModeMessageSchema,
     SendAgentMessageRequestSchema,
@@ -2503,6 +2632,8 @@ export const SessionInboundMessageSchema = z.discriminatedUnion("type", [
     AgentSubagentStopRequestMessageSchema,
     AgentBackgroundTaskStopRequestMessageSchema,
     AgentBackgroundTaskClearRequestMessageSchema,
+    TasksSuggestedStartRequestMessageSchema,
+    TasksSuggestedDismissRequestMessageSchema,
     AgentPersonalitySetRequestMessageSchema,
     AgentRewindRequestMessageSchema,
     AgentPermissionResponseMessageSchema,
@@ -2796,6 +2927,8 @@ export const ServerInfoStatusPayloadSchema = z
         observedSubagents: z.boolean().optional(),
         // COMPAT(backgroundShellTasks): added in v0.5.3, drop the gate when daemon floor >= v0.5.3.
         backgroundShellTasks: z.boolean().optional(),
+        // COMPAT(suggestedTasks): added in v0.5.6, drop the gate when daemon floor >= v0.5.6.
+        suggestedTasks: z.boolean().optional(),
         // COMPAT(textEditor): added in v0.4.4, drop the gate when daemon floor >= v0.4.4.
         textEditor: z.boolean().optional(),
         // COMPAT(projectSearch): added in v0.4.4, drop the gate when daemon floor >= v0.4.4.
@@ -2832,6 +2965,8 @@ export const ServerInfoStatusPayloadSchema = z
         activityStats: z.boolean().optional(),
         // COMPAT(runsClear): added in v0.5.3, drop the gate when daemon floor >= v0.5.3.
         runsClear: z.boolean().optional(),
+        // COMPAT(projectLinks): added in v0.5.6, drop the gate when daemon floor >= v0.5.6.
+        projectLinks: z.boolean().optional(),
     })
         .optional(),
 })
@@ -3392,7 +3527,7 @@ export const CancelAgentResponseMessageSchema = z.object({
         // Whether an in-flight run was actually interrupted. False when the agent
         // had nothing running (already finished, still initializing), so clients
         // can say "nothing to stop" instead of silently no-oping. Purely additive;
-        // absent ⇒ unknown (old daemon). See projects/subagents-cleanup/subagents-cleanup.md (Item 2).
+        // absent ⇒ unknown (old daemon). See docs/agent-lifecycle.md (Item 2).
         cancelled: z.boolean().optional(),
     }),
 });
@@ -3951,6 +4086,13 @@ export const CheckoutGitRollbackErrorSchema = z.discriminatedUnion("kind", [
         kind: z.literal("git_failed"),
         detail: z.string(),
     }),
+    // Refused because agents are running in this workspace; discarding their
+    // uncommitted edits mid-run risks destroying work. The client re-sends with
+    // allowWithRunningAgents after confirming, mirroring the commit flow.
+    z.object({
+        kind: z.literal("agents_running"),
+        agents: z.array(CheckoutGitCommitRunningAgentSchema),
+    }),
 ]);
 export const CheckoutGitRollbackResponseSchema = z.object({
     type: z.literal("checkout.git.rollback.response"),
@@ -4989,11 +5131,18 @@ export const SessionOutboundMessageSchema = z.discriminatedUnion("type", [
     AgentBackgroundTaskStopResponseMessageSchema,
     AgentBackgroundTaskClearResponseMessageSchema,
     BackgroundShellTasksChangedSchema,
+    TasksSuggestedStartResponseMessageSchema,
+    TasksSuggestedDismissResponseMessageSchema,
+    SuggestedTasksChangedSchema,
     AgentPersonalitySetResponseMessageSchema,
     AgentRewindResponseMessageSchema,
     UpdateAgentResponseMessageSchema,
     ProjectRenameResponseSchema,
     ProjectRemoveResponseSchema,
+    ProjectLinksListResponseSchema,
+    ProjectLinksSetResponseSchema,
+    ProjectLinksUnsetResponseSchema,
+    ProjectLinksChangedSchema,
     WorkspaceTitleSetResponseSchema,
     WaitForFinishResponseMessageSchema,
     AgentPermissionRequestMessageSchema,

package/dist/schedule/rpc-schemas.d.ts

@@ -175,6 +175,9 @@ export declare const ScheduleCreateResponseSchema: z.ZodObject<{
                 succeeded: "succeeded";
             }>>>;
             lastRunError: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            lastRunPersonalityName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            lastRunProvider: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            lastRunModel: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             pausedAt: z.ZodNullable<z.ZodString>;
             expiresAt: z.ZodNullable<z.ZodString>;
             maxRuns: z.ZodNullable<z.ZodNumber>;
@@ -243,6 +246,9 @@ export declare const ScheduleListResponseSchema: z.ZodObject<{
                 succeeded: "succeeded";
             }>>>;
             lastRunError: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            lastRunPersonalityName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            lastRunProvider: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            lastRunModel: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             pausedAt: z.ZodNullable<z.ZodString>;
             expiresAt: z.ZodNullable<z.ZodString>;
             maxRuns: z.ZodNullable<z.ZodNumber>;
@@ -311,6 +317,9 @@ export declare const ScheduleInspectResponseSchema: z.ZodObject<{
                 succeeded: "succeeded";
             }>>>;
             lastRunError: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            lastRunPersonalityName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            lastRunProvider: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            lastRunModel: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             pausedAt: z.ZodNullable<z.ZodString>;
             expiresAt: z.ZodNullable<z.ZodString>;
             maxRuns: z.ZodNullable<z.ZodNumber>;
@@ -326,6 +335,9 @@ export declare const ScheduleInspectResponseSchema: z.ZodObject<{
                 }>;
                 agentId: z.ZodNullable<z.ZodGUID>;
                 workspaceId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                personalityName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                provider: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                model: z.ZodOptional<z.ZodNullable<z.ZodString>>;
                 output: z.ZodNullable<z.ZodString>;
                 error: z.ZodNullable<z.ZodString>;
             }, z.core.$strip>>;
@@ -349,6 +361,9 @@ export declare const ScheduleLogsResponseSchema: z.ZodObject<{
             }>;
             agentId: z.ZodNullable<z.ZodGUID>;
             workspaceId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            personalityName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            provider: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            model: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             output: z.ZodNullable<z.ZodString>;
             error: z.ZodNullable<z.ZodString>;
         }, z.core.$strip>>;
@@ -416,6 +431,9 @@ export declare const SchedulePauseResponseSchema: z.ZodObject<{
                 succeeded: "succeeded";
             }>>>;
             lastRunError: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            lastRunPersonalityName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            lastRunProvider: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            lastRunModel: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             pausedAt: z.ZodNullable<z.ZodString>;
             expiresAt: z.ZodNullable<z.ZodString>;
             maxRuns: z.ZodNullable<z.ZodNumber>;
@@ -484,6 +502,9 @@ export declare const ScheduleResumeResponseSchema: z.ZodObject<{
                 succeeded: "succeeded";
             }>>>;
             lastRunError: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            lastRunPersonalityName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            lastRunProvider: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            lastRunModel: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             pausedAt: z.ZodNullable<z.ZodString>;
             expiresAt: z.ZodNullable<z.ZodString>;
             maxRuns: z.ZodNullable<z.ZodNumber>;
@@ -560,6 +581,9 @@ export declare const ScheduleRunOnceResponseSchema: z.ZodObject<{
                 succeeded: "succeeded";
             }>>>;
             lastRunError: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            lastRunPersonalityName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            lastRunProvider: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            lastRunModel: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             pausedAt: z.ZodNullable<z.ZodString>;
             expiresAt: z.ZodNullable<z.ZodString>;
             maxRuns: z.ZodNullable<z.ZodNumber>;
@@ -575,6 +599,9 @@ export declare const ScheduleRunOnceResponseSchema: z.ZodObject<{
                 }>;
                 agentId: z.ZodNullable<z.ZodGUID>;
                 workspaceId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                personalityName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                provider: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                model: z.ZodOptional<z.ZodNullable<z.ZodString>>;
                 output: z.ZodNullable<z.ZodString>;
                 error: z.ZodNullable<z.ZodString>;
             }, z.core.$strip>>;
@@ -643,6 +670,9 @@ export declare const ScheduleUpdateResponseSchema: z.ZodObject<{
                 succeeded: "succeeded";
             }>>>;
             lastRunError: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            lastRunPersonalityName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            lastRunProvider: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            lastRunModel: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             pausedAt: z.ZodNullable<z.ZodString>;
             expiresAt: z.ZodNullable<z.ZodString>;
             maxRuns: z.ZodNullable<z.ZodNumber>;
@@ -658,6 +688,9 @@ export declare const ScheduleUpdateResponseSchema: z.ZodObject<{
                 }>;
                 agentId: z.ZodNullable<z.ZodGUID>;
                 workspaceId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                personalityName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                provider: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                model: z.ZodOptional<z.ZodNullable<z.ZodString>>;
                 output: z.ZodNullable<z.ZodString>;
                 error: z.ZodNullable<z.ZodString>;
             }, z.core.$strip>>;

package/dist/schedule/types.d.ts

@@ -58,6 +58,9 @@ export declare const ScheduleRunSchema: z.ZodObject<{
     }>;
     agentId: z.ZodNullable<z.ZodGUID>;
     workspaceId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    personalityName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    provider: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    model: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     output: z.ZodNullable<z.ZodString>;
     error: z.ZodNullable<z.ZodString>;
 }, z.core.$strip>;
@@ -119,6 +122,9 @@ export declare const StoredScheduleSchema: z.ZodObject<{
         succeeded: "succeeded";
     }>>>;
     lastRunError: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    lastRunPersonalityName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    lastRunProvider: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    lastRunModel: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     pausedAt: z.ZodNullable<z.ZodString>;
     expiresAt: z.ZodNullable<z.ZodString>;
     maxRuns: z.ZodNullable<z.ZodNumber>;
@@ -134,6 +140,9 @@ export declare const StoredScheduleSchema: z.ZodObject<{
         }>;
         agentId: z.ZodNullable<z.ZodGUID>;
         workspaceId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        personalityName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        provider: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        model: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         output: z.ZodNullable<z.ZodString>;
         error: z.ZodNullable<z.ZodString>;
     }, z.core.$strip>>;
@@ -196,6 +205,9 @@ export declare const ScheduleSummarySchema: z.ZodObject<{
         succeeded: "succeeded";
     }>>>;
     lastRunError: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    lastRunPersonalityName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    lastRunProvider: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    lastRunModel: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     pausedAt: z.ZodNullable<z.ZodString>;
     expiresAt: z.ZodNullable<z.ZodString>;
     maxRuns: z.ZodNullable<z.ZodNumber>;

package/dist/schedule/types.js

@@ -57,6 +57,13 @@ export const ScheduleRunSchema = z.object({
     status: z.enum(["running", "succeeded", "failed"]),
     agentId: z.guid().nullable(),
     workspaceId: z.string().nullable().optional(),
+    // Who actually executed this run — the resolved personality (if any),
+    // provider, and model. Stamped when the run starts (so a failed run still
+    // records its executor). Optional for back-compat: runs written before these
+    // fields existed omit them.
+    personalityName: z.string().nullable().optional(),
+    provider: z.string().nullable().optional(),
+    model: z.string().nullable().optional(),
     output: z.string().nullable(),
     error: z.string().nullable(),
 });
@@ -73,6 +80,14 @@ export const StoredScheduleSchema = z.object({
     lastRunAt: z.string().nullable(),
     lastRunStatus: z.enum(["succeeded", "failed"]).nullable().optional(),
     lastRunError: z.string().nullable().optional(),
+    // Executor of the most recent run — mirrors the run-level fields above so the
+    // schedule card can show "who ran it last" (personality · provider · model)
+    // without loading the full run history (ScheduleSummary omits `runs`).
+    // Optional for back-compat: schedules that never ran, or predate these
+    // fields, omit them.
+    lastRunPersonalityName: z.string().nullable().optional(),
+    lastRunProvider: z.string().nullable().optional(),
+    lastRunModel: z.string().nullable().optional(),
     pausedAt: z.string().nullable(),
     expiresAt: z.string().nullable(),
     maxRuns: z.number().int().positive().nullable(),