@hyperdrive.bot/paseo-protocol 0.3.67 → 0.3.68

package/dist/messages.d.ts

@@ -51,6 +51,28 @@ export declare const KanbanBoardConfigSchema: z.ZodObject<{
     defaultBucketId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
 }, z.core.$loose>;
 export type KanbanBoardConfig = z.infer<typeof KanbanBoardConfigSchema>;
+/**
+ * MARRA CUSTOMIZATION - workspace-wide tag colors.
+ *
+ * A LIST, not a record, because `DaemonConfigStore.patch` deep-merges: it recurses
+ * into plain objects and skips `undefined`, so a key could never be deleted from a
+ * record and "reset this tag to Auto" would silently do nothing. Arrays are
+ * replaced wholesale, which makes un-pinning an ordinary write. Same constraint,
+ * and same solution, as `kanbanBoard.buckets`.
+ */
+export declare const TagColorOverrideSchema: z.ZodObject<{
+    tag: z.ZodString;
+    color: z.ZodEnum<{
+        red: "red";
+        orange: "orange";
+        amber: "amber";
+        green: "green";
+        teal: "teal";
+        blue: "blue";
+        purple: "purple";
+        pink: "pink";
+    }>;
+}, z.core.$strip>;
 export declare const MutableDaemonConfigSchema: z.ZodObject<{
     mcp: z.ZodObject<{
         injectIntoAgents: z.ZodBoolean;
@@ -92,6 +114,19 @@ export declare const MutableDaemonConfigSchema: z.ZodObject<{
         }, z.core.$loose>>>;
         defaultBucketId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
     }, z.core.$loose>>;
+    tagColors: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        tag: z.ZodString;
+        color: z.ZodEnum<{
+            red: "red";
+            orange: "orange";
+            amber: "amber";
+            green: "green";
+            teal: "teal";
+            blue: "blue";
+            purple: "purple";
+            pink: "pink";
+        }>;
+    }, z.core.$strip>>>;
 }, z.core.$loose>;
 export declare const MutableDaemonConfigPatchSchema: z.ZodObject<{
     mcp: z.ZodOptional<z.ZodOptional<z.ZodObject<{
@@ -134,6 +169,19 @@ export declare const MutableDaemonConfigPatchSchema: z.ZodObject<{
         }, z.core.$loose>>>;
         defaultBucketId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
     }, z.core.$loose>>>;
+    tagColors: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodObject<{
+        tag: z.ZodString;
+        color: z.ZodEnum<{
+            red: "red";
+            orange: "orange";
+            amber: "amber";
+            green: "green";
+            teal: "teal";
+            blue: "blue";
+            purple: "purple";
+            pink: "pink";
+        }>;
+    }, z.core.$strip>>>>;
 }, z.core.$loose>;
 export type MutableDaemonConfig = z.infer<typeof MutableDaemonConfigSchema>;
 export type MutableDaemonConfigPatch = z.infer<typeof MutableDaemonConfigPatchSchema>;
@@ -2131,6 +2179,19 @@ export declare const SetDaemonConfigRequestMessageSchema: z.ZodObject<{
             }, z.core.$loose>>>;
             defaultBucketId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
         }, z.core.$loose>>>;
+        tagColors: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodObject<{
+            tag: z.ZodString;
+            color: z.ZodEnum<{
+                red: "red";
+                orange: "orange";
+                amber: "amber";
+                green: "green";
+                teal: "teal";
+                blue: "blue";
+                purple: "purple";
+                pink: "pink";
+            }>;
+        }, z.core.$strip>>>>;
     }, z.core.$loose>;
 }, z.core.$strip>;
 export declare const ReadProjectConfigRequestMessageSchema: z.ZodObject<{
@@ -4506,6 +4567,19 @@ export declare const SessionInboundMessageSchema: z.ZodDiscriminatedUnion<[z.Zod
             }, z.core.$loose>>>;
             defaultBucketId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
         }, z.core.$loose>>>;
+        tagColors: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodObject<{
+            tag: z.ZodString;
+            color: z.ZodEnum<{
+                red: "red";
+                orange: "orange";
+                amber: "amber";
+                green: "green";
+                teal: "teal";
+                blue: "blue";
+                purple: "purple";
+                pink: "pink";
+            }>;
+        }, z.core.$strip>>>>;
     }, z.core.$loose>;
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"read_project_config_request">;
@@ -6517,6 +6591,19 @@ export declare const DaemonConfigChangedStatusPayloadSchema: z.ZodObject<{
             }, z.core.$loose>>>;
             defaultBucketId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
         }, z.core.$loose>>;
+        tagColors: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            tag: z.ZodString;
+            color: z.ZodEnum<{
+                red: "red";
+                orange: "orange";
+                amber: "amber";
+                green: "green";
+                teal: "teal";
+                blue: "blue";
+                purple: "purple";
+                pink: "pink";
+            }>;
+        }, z.core.$strip>>>;
     }, z.core.$loose>;
 }, z.core.$loose>;
 export declare const KnownStatusPayloadSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -6854,6 +6941,19 @@ export declare const KnownStatusPayloadSchema: z.ZodDiscriminatedUnion<[z.ZodObj
             }, z.core.$loose>>>;
             defaultBucketId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
         }, z.core.$loose>>;
+        tagColors: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            tag: z.ZodString;
+            color: z.ZodEnum<{
+                red: "red";
+                orange: "orange";
+                amber: "amber";
+                green: "green";
+                teal: "teal";
+                blue: "blue";
+                purple: "purple";
+                pink: "pink";
+            }>;
+        }, z.core.$strip>>>;
     }, z.core.$loose>;
 }, z.core.$loose>], "status">;
 export type KnownStatusPayload = z.infer<typeof KnownStatusPayloadSchema>;
@@ -11388,6 +11488,19 @@ export declare const GetDaemonConfigResponseMessageSchema: z.ZodObject<{
                 }, z.core.$loose>>>;
                 defaultBucketId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
             }, z.core.$loose>>;
+            tagColors: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                tag: z.ZodString;
+                color: z.ZodEnum<{
+                    red: "red";
+                    orange: "orange";
+                    amber: "amber";
+                    green: "green";
+                    teal: "teal";
+                    blue: "blue";
+                    purple: "purple";
+                    pink: "pink";
+                }>;
+            }, z.core.$strip>>>;
         }, z.core.$loose>;
     }, z.core.$loose>;
 }, z.core.$strip>;
@@ -11476,6 +11589,19 @@ export declare const SetDaemonConfigResponseMessageSchema: z.ZodObject<{
                 }, z.core.$loose>>>;
                 defaultBucketId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
             }, z.core.$loose>>;
+            tagColors: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                tag: z.ZodString;
+                color: z.ZodEnum<{
+                    red: "red";
+                    orange: "orange";
+                    amber: "amber";
+                    green: "green";
+                    teal: "teal";
+                    blue: "blue";
+                    purple: "purple";
+                    pink: "pink";
+                }>;
+            }, z.core.$strip>>>;
         }, z.core.$loose>;
     }, z.core.$loose>;
 }, z.core.$strip>;
@@ -17773,6 +17899,19 @@ export declare const SessionOutboundMessageSchema: z.ZodDiscriminatedUnion<[z.Zo
                 }, z.core.$loose>>>;
                 defaultBucketId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
             }, z.core.$loose>>;
+            tagColors: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                tag: z.ZodString;
+                color: z.ZodEnum<{
+                    red: "red";
+                    orange: "orange";
+                    amber: "amber";
+                    green: "green";
+                    teal: "teal";
+                    blue: "blue";
+                    purple: "purple";
+                    pink: "pink";
+                }>;
+            }, z.core.$strip>>>;
         }, z.core.$loose>;
     }, z.core.$loose>;
 }, z.core.$strip>, z.ZodObject<{
@@ -17820,6 +17959,19 @@ export declare const SessionOutboundMessageSchema: z.ZodDiscriminatedUnion<[z.Zo
                 }, z.core.$loose>>>;
                 defaultBucketId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
             }, z.core.$loose>>;
+            tagColors: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                tag: z.ZodString;
+                color: z.ZodEnum<{
+                    red: "red";
+                    orange: "orange";
+                    amber: "amber";
+                    green: "green";
+                    teal: "teal";
+                    blue: "blue";
+                    purple: "purple";
+                    pink: "pink";
+                }>;
+            }, z.core.$strip>>>;
         }, z.core.$loose>;
     }, z.core.$loose>;
 }, z.core.$strip>, z.ZodObject<{
@@ -22920,6 +23072,19 @@ export declare const WSSessionInboundSchema: z.ZodObject<{
                 }, z.core.$loose>>>;
                 defaultBucketId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
             }, z.core.$loose>>>;
+            tagColors: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodObject<{
+                tag: z.ZodString;
+                color: z.ZodEnum<{
+                    red: "red";
+                    orange: "orange";
+                    amber: "amber";
+                    green: "green";
+                    teal: "teal";
+                    blue: "blue";
+                    purple: "purple";
+                    pink: "pink";
+                }>;
+            }, z.core.$strip>>>>;
         }, z.core.$loose>;
     }, z.core.$strip>, z.ZodObject<{
         type: z.ZodLiteral<"read_project_config_request">;
@@ -28256,6 +28421,19 @@ export declare const WSSessionOutboundSchema: z.ZodObject<{
                     }, z.core.$loose>>>;
                     defaultBucketId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
                 }, z.core.$loose>>;
+                tagColors: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    tag: z.ZodString;
+                    color: z.ZodEnum<{
+                        red: "red";
+                        orange: "orange";
+                        amber: "amber";
+                        green: "green";
+                        teal: "teal";
+                        blue: "blue";
+                        purple: "purple";
+                        pink: "pink";
+                    }>;
+                }, z.core.$strip>>>;
             }, z.core.$loose>;
         }, z.core.$loose>;
     }, z.core.$strip>, z.ZodObject<{
@@ -28303,6 +28481,19 @@ export declare const WSSessionOutboundSchema: z.ZodObject<{
                     }, z.core.$loose>>>;
                     defaultBucketId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
                 }, z.core.$loose>>;
+                tagColors: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    tag: z.ZodString;
+                    color: z.ZodEnum<{
+                        red: "red";
+                        orange: "orange";
+                        amber: "amber";
+                        green: "green";
+                        teal: "teal";
+                        blue: "blue";
+                        purple: "purple";
+                        pink: "pink";
+                    }>;
+                }, z.core.$strip>>>;
             }, z.core.$loose>;
         }, z.core.$loose>;
     }, z.core.$strip>, z.ZodObject<{
@@ -33059,6 +33250,19 @@ export declare const WSInboundMessageSchema: z.ZodDiscriminatedUnion<[z.ZodObjec
                 }, z.core.$loose>>>;
                 defaultBucketId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
             }, z.core.$loose>>>;
+            tagColors: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodObject<{
+                tag: z.ZodString;
+                color: z.ZodEnum<{
+                    red: "red";
+                    orange: "orange";
+                    amber: "amber";
+                    green: "green";
+                    teal: "teal";
+                    blue: "blue";
+                    purple: "purple";
+                    pink: "pink";
+                }>;
+            }, z.core.$strip>>>>;
         }, z.core.$loose>;
     }, z.core.$strip>, z.ZodObject<{
         type: z.ZodLiteral<"read_project_config_request">;
@@ -38397,6 +38601,19 @@ export declare const WSOutboundMessageSchema: z.ZodDiscriminatedUnion<[z.ZodObje
                     }, z.core.$loose>>>;
                     defaultBucketId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
                 }, z.core.$loose>>;
+                tagColors: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    tag: z.ZodString;
+                    color: z.ZodEnum<{
+                        red: "red";
+                        orange: "orange";
+                        amber: "amber";
+                        green: "green";
+                        teal: "teal";
+                        blue: "blue";
+                        purple: "purple";
+                        pink: "pink";
+                    }>;
+                }, z.core.$strip>>>;
             }, z.core.$loose>;
         }, z.core.$loose>;
     }, z.core.$strip>, z.ZodObject<{
@@ -38444,6 +38661,19 @@ export declare const WSOutboundMessageSchema: z.ZodDiscriminatedUnion<[z.ZodObje
                     }, z.core.$loose>>>;
                     defaultBucketId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
                 }, z.core.$loose>>;
+                tagColors: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    tag: z.ZodString;
+                    color: z.ZodEnum<{
+                        red: "red";
+                        orange: "orange";
+                        amber: "amber";
+                        green: "green";
+                        teal: "teal";
+                        blue: "blue";
+                        purple: "purple";
+                        pink: "pink";
+                    }>;
+                }, z.core.$strip>>>;
             }, z.core.$loose>;
         }, z.core.$loose>;
     }, z.core.$strip>, z.ZodObject<{

package/dist/messages.js

@@ -5,6 +5,7 @@ import { AGENT_LIFECYCLE_STATUSES } from "./agent-lifecycle.js";
 import { MAX_EXPLICIT_AGENT_TITLE_CHARS } from "./agent-title-limits.js";
 import { AgentProviderSchema } from "./provider-manifest.js";
 import { TOOL_CALL_ICON_NAMES } from "./agent-types.js";
+import { TAG_COLOR_NAMES } from "./tag-color.js";
 import { FileBeginMetadataSchema } from "./binary-frames/file-transfer.js";
 import { ChatCreateRequestSchema, ChatListRequestSchema, ChatInspectRequestSchema, ChatDeleteRequestSchema, ChatPostRequestSchema, ChatReadRequestSchema, ChatWaitRequestSchema, ChatCreateResponseSchema, ChatListResponseSchema, ChatInspectResponseSchema, ChatDeleteResponseSchema, ChatPostResponseSchema, ChatReadResponseSchema, ChatWaitResponseSchema, } from "./chat/rpc-schemas.js";
 import { ScheduleCreateRequestSchema, ScheduleListRequestSchema, ScheduleInspectRequestSchema, ScheduleLogsRequestSchema, SchedulePauseRequestSchema, ScheduleResumeRequestSchema, ScheduleDeleteRequestSchema, ScheduleRunOnceRequestSchema, ScheduleUpdateRequestSchema, ScheduleCreateResponseSchema, ScheduleListResponseSchema, ScheduleInspectResponseSchema, ScheduleLogsResponseSchema, SchedulePauseResponseSchema, ScheduleResumeResponseSchema, ScheduleDeleteResponseSchema, ScheduleRunOnceResponseSchema, ScheduleUpdateResponseSchema, } from "./schedule/rpc-schemas.js";
@@ -92,6 +93,19 @@ const MutableBrowserToolsConfigSchema = z
     enabled: z.boolean().default(false),
 })
     .passthrough();
+/**
+ * MARRA CUSTOMIZATION - workspace-wide tag colors.
+ *
+ * A LIST, not a record, because `DaemonConfigStore.patch` deep-merges: it recurses
+ * into plain objects and skips `undefined`, so a key could never be deleted from a
+ * record and "reset this tag to Auto" would silently do nothing. Arrays are
+ * replaced wholesale, which makes un-pinning an ordinary write. Same constraint,
+ * and same solution, as `kanbanBoard.buckets`.
+ */
+export const TagColorOverrideSchema = z.object({
+    tag: z.string().min(1),
+    color: z.enum(TAG_COLOR_NAMES),
+});
 export const MutableDaemonConfigSchema = z
     .object({
     mcp: z
@@ -112,6 +126,11 @@ export const MutableDaemonConfigSchema = z
     // Optional so an old daemon (which never sends it) and an old client (which
     // ignores it) both keep parsing this config unchanged.
     kanbanBoard: KanbanBoardConfigSchema.optional(),
+    // COMPAT(tagColors): optional for the same reason kanbanBoard is. An old
+    // daemon never sends it and the app falls back to the per-tag hash, which is
+    // exactly the behaviour that shipped in v0.3.65 - so there is nothing to
+    // migrate and nothing to backfill.
+    tagColors: z.array(TagColorOverrideSchema).optional(),
 })
     .passthrough();
 export const MutableDaemonConfigPatchSchema = z
@@ -131,6 +150,10 @@ export const MutableDaemonConfigPatchSchema = z
     // carrying `kanbanBoard` must carry the complete board. That is exactly what
     // the client sends (it owns the full board in memory before every write).
     kanbanBoard: KanbanBoardConfigSchema.optional(),
+    // Patched wholesale for the same reason kanbanBoard is: deepMerge replaces
+    // arrays but can never delete a record key, so the client always sends the
+    // COMPLETE override list. That is what makes "reset to Auto" expressible.
+    tagColors: z.array(TagColorOverrideSchema).optional(),
 })
     .partial()
     .passthrough();

package/dist/tag-color.d.ts

@@ -14,9 +14,17 @@
  *
  * Resolution order, deliberately in that order:
  *   1. An explicit, recognized color name in the label value wins.
- *   2. Anything else (including the legacy "true", and any unrecognized name)
+ *   2. A workspace-wide override for that tag name (the daemon config's
+ *      `tagColors`, edited from Settings > Appearance) comes next.
+ *   3. Anything else (including the legacy "true", and any unrecognized name)
  *      falls through to a stable hash of the tag name.
  *
+ * WHY THE LABEL STILL OUTRANKS THE GLOBAL MAP: the label value is the per-session
+ * exception - one agent deliberately painted odd, and the hand-edit escape hatch
+ * for `$PASEO_HOME/agents/*.json`. A global default that could silently overrule a
+ * value someone typed into a specific session's file would make that file a lie.
+ * The global map is a better DEFAULT, not a bigger hammer.
+ *
  * Consequence worth stating: every session stored before this shipped lights up
  * correctly on first render, because the color is a function of data we already
  * have. Nothing backfills, nothing rewrites "true".
@@ -56,6 +64,41 @@ export declare function isTagColorName(value: string | null | undefined): value
  * keeps the accumulator unsigned after Math.imul, so the index is never negative.
  */
 export declare function hashTagToColorIndex(tag: string): number;
+/**
+ * One workspace-wide pin: "every tag named `monumenta` is teal, unless a specific
+ * session says otherwise".
+ *
+ * Stored as a LIST rather than a record, and that is load-bearing rather than
+ * stylistic. The daemon config is patched through `deepMerge`, which recurses into
+ * plain objects and skips `undefined` - so a record could never have a key
+ * REMOVED by a patch, and "reset this tag back to Auto" would silently no-op
+ * forever. `deepMerge` replaces arrays wholesale, so a list makes un-pinning a
+ * normal write. `kanbanBoard.buckets` carries the same constraint for the same
+ * reason.
+ */
+export interface TagColorOverride {
+    tag: string;
+    color: TagColorName;
+}
+/** The resolved lookup form. Built once, then handed to every resolve call. */
+export type TagColorOverrides = ReadonlyMap<string, TagColorName>;
+/**
+ * The canonical key for a tag name. Must stay identical to the normalization in
+ * `hashTagToColorIndex`, or a tag would hash under one spelling and be pinned
+ * under another.
+ */
+export declare function normalizeTagKey(tag: string): string;
+/**
+ * Fold an override list into a lookup map, dropping anything malformed.
+ *
+ * Unknown color names and blank tags are SKIPPED rather than thrown on, matching
+ * this module's standing contract that a hand-edited config can never break the
+ * UI - the worst a bad entry does is fall through to the hash. Later entries win,
+ * so a list that somehow carries a tag twice still resolves deterministically.
+ */
+export declare function buildTagColorOverrides(list: readonly TagColorOverride[] | null | undefined): TagColorOverrides;
+/** An empty override map. Shared so callers do not allocate one per render. */
+export declare const NO_TAG_COLOR_OVERRIDES: TagColorOverrides;
 /**
  * The color name for a tag, given the raw label value stored alongside it.
  *
@@ -65,7 +108,7 @@ export declare function hashTagToColorIndex(tag: string): number;
  * a human editing ~/.paseo/agents/*.json by hand without being able to break the
  * UI.
  */
-export declare function resolveTagColorName(tag: string, labelValue?: string | null): TagColorName;
+export declare function resolveTagColorName(tag: string, labelValue?: string | null, overrides?: TagColorOverrides | null): TagColorName;
 /** One tag paired with the color it resolves to. */
 export interface ColoredTag {
     tag: string;
@@ -78,7 +121,7 @@ export interface ColoredTag {
  * an unsorted map iteration would let the same session paint its bands in a
  * different order on desktop than on mobile.
  */
-export declare function coloredTagsFromLabels(labels: Record<string, string> | null | undefined, tagPrefix?: string): ColoredTag[];
+export declare function coloredTagsFromLabels(labels: Record<string, string> | null | undefined, tagPrefix?: string, overrides?: TagColorOverrides | null): ColoredTag[];
 /** Re-exported so callers can write the legacy value without hardcoding it. */
 export declare const TAG_LABEL_PRESENT_VALUE = "true";
 //# sourceMappingURL=tag-color.d.ts.map

package/dist/tag-color.js

@@ -14,9 +14,17 @@
  *
  * Resolution order, deliberately in that order:
  *   1. An explicit, recognized color name in the label value wins.
- *   2. Anything else (including the legacy "true", and any unrecognized name)
+ *   2. A workspace-wide override for that tag name (the daemon config's
+ *      `tagColors`, edited from Settings > Appearance) comes next.
+ *   3. Anything else (including the legacy "true", and any unrecognized name)
  *      falls through to a stable hash of the tag name.
  *
+ * WHY THE LABEL STILL OUTRANKS THE GLOBAL MAP: the label value is the per-session
+ * exception - one agent deliberately painted odd, and the hand-edit escape hatch
+ * for `$PASEO_HOME/agents/*.json`. A global default that could silently overrule a
+ * value someone typed into a specific session's file would make that file a lie.
+ * The global map is a better DEFAULT, not a bigger hammer.
+ *
  * Consequence worth stating: every session stored before this shipped lights up
  * correctly on first render, because the color is a function of data we already
  * have. Nothing backfills, nothing rewrites "true".
@@ -79,6 +87,38 @@ export function hashTagToColorIndex(tag) {
     }
     return hash % TAG_COLOR_NAMES.length;
 }
+/**
+ * The canonical key for a tag name. Must stay identical to the normalization in
+ * `hashTagToColorIndex`, or a tag would hash under one spelling and be pinned
+ * under another.
+ */
+export function normalizeTagKey(tag) {
+    return tag.trim().toLowerCase();
+}
+/**
+ * Fold an override list into a lookup map, dropping anything malformed.
+ *
+ * Unknown color names and blank tags are SKIPPED rather than thrown on, matching
+ * this module's standing contract that a hand-edited config can never break the
+ * UI - the worst a bad entry does is fall through to the hash. Later entries win,
+ * so a list that somehow carries a tag twice still resolves deterministically.
+ */
+export function buildTagColorOverrides(list) {
+    const map = new Map();
+    if (!list)
+        return map;
+    for (const entry of list) {
+        if (!entry || typeof entry.tag !== "string" || !isTagColorName(entry.color))
+            continue;
+        const key = normalizeTagKey(entry.tag);
+        if (key.length === 0)
+            continue;
+        map.set(key, entry.color.trim().toLowerCase());
+    }
+    return map;
+}
+/** An empty override map. Shared so callers do not allocate one per render. */
+export const NO_TAG_COLOR_OVERRIDES = new Map();
 /**
  * The color name for a tag, given the raw label value stored alongside it.
  *
@@ -88,10 +128,13 @@ export function hashTagToColorIndex(tag) {
  * a human editing ~/.paseo/agents/*.json by hand without being able to break the
  * UI.
  */
-export function resolveTagColorName(tag, labelValue) {
+export function resolveTagColorName(tag, labelValue, overrides) {
     if (isTagColorName(labelValue)) {
         return labelValue.trim().toLowerCase();
     }
+    const pinned = overrides?.get(normalizeTagKey(tag));
+    if (pinned)
+        return pinned;
     return TAG_COLOR_NAMES[hashTagToColorIndex(tag)];
 }
 /**
@@ -101,7 +144,7 @@ export function resolveTagColorName(tag, labelValue) {
  * an unsorted map iteration would let the same session paint its bands in a
  * different order on desktop than on mobile.
  */
-export function coloredTagsFromLabels(labels, tagPrefix = TAG_LABEL_PREFIX) {
+export function coloredTagsFromLabels(labels, tagPrefix = TAG_LABEL_PREFIX, overrides) {
     if (!labels)
         return [];
     const result = [];
@@ -112,7 +155,7 @@ export function coloredTagsFromLabels(labels, tagPrefix = TAG_LABEL_PREFIX) {
         if (value === ABSENT_VALUE)
             continue;
         const tag = key.slice(tagPrefix.length);
-        result.push({ tag, color: resolveTagColorName(tag, value) });
+        result.push({ tag, color: resolveTagColorName(tag, value, overrides) });
     }
     result.sort((a, b) => a.tag.localeCompare(b.tag));
     return result;

package/dist/validation/ws-outbound-schema-metadata.d.ts

@@ -3999,6 +3999,19 @@ export declare const WSOutboundMessageSchema: {
                         }, import("zod/v4/core").$loose>>>;
                         defaultBucketId: import("zod").ZodDefault<import("zod").ZodNullable<import("zod").ZodString>>;
                     }, import("zod/v4/core").$loose>>;
+                    tagColors: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodObject<{
+                        tag: import("zod").ZodString;
+                        color: import("zod").ZodEnum<{
+                            red: "red";
+                            orange: "orange";
+                            amber: "amber";
+                            green: "green";
+                            teal: "teal";
+                            blue: "blue";
+                            purple: "purple";
+                            pink: "pink";
+                        }>;
+                    }, import("zod/v4/core").$strip>>>;
                 }, import("zod/v4/core").$loose>;
             }, import("zod/v4/core").$loose>;
         }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
@@ -4046,6 +4059,19 @@ export declare const WSOutboundMessageSchema: {
                         }, import("zod/v4/core").$loose>>>;
                         defaultBucketId: import("zod").ZodDefault<import("zod").ZodNullable<import("zod").ZodString>>;
                     }, import("zod/v4/core").$loose>>;
+                    tagColors: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodObject<{
+                        tag: import("zod").ZodString;
+                        color: import("zod").ZodEnum<{
+                            red: "red";
+                            orange: "orange";
+                            amber: "amber";
+                            green: "green";
+                            teal: "teal";
+                            blue: "blue";
+                            purple: "purple";
+                            pink: "pink";
+                        }>;
+                    }, import("zod/v4/core").$strip>>>;
                 }, import("zod/v4/core").$loose>;
             }, import("zod/v4/core").$loose>;
         }, import("zod/v4/core").$strip>, import("zod").ZodObject<{

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperdrive.bot/paseo-protocol",
-  "version": "0.3.67",
+  "version": "0.3.68",
   "description": "Paseo shared protocol schemas and wire types",
   "files": [
     "dist",