diff --git a/packages/backend/src/routes/__tests__/events.contract.test.ts b/packages/backend/src/routes/__tests__/events.contract.test.ts index a0c5b1d..06bc122 100644 --- a/packages/backend/src/routes/__tests__/events.contract.test.ts +++ b/packages/backend/src/routes/__tests__/events.contract.test.ts @@ -268,6 +268,19 @@ function transformPluginSetup(raw: Record) { }); } +function transformModelFirstUse(raw: Record) { + // Mirrors scripts/model-first-use.sh on PostModelSwitch (the fixture's shape). + // The script lowercases ids and drops a trailing `[1m]`-style suffix. + const norm = (m: unknown) => String(m ?? "").toLowerCase().replace(/\[[^\]]*\]$/, ""); + const previous = norm(raw.from_model); + return envelope("model.first_use", { + model: norm(raw.to_model), + trigger: "model_switch", + ...(previous ? { previousModel: previous } : {}), + ...baseFields(raw), + }); +} + // --------------------------------------------------------------------------- // Tests // --------------------------------------------------------------------------- @@ -300,6 +313,8 @@ describe("plugin↔backend wire contract (DEV-88)", () => { { file: "cwd-changed.json", transform: transformCwdChanged, eventType: "cwd.change" }, { file: "directory-added.json", transform: transformDirectoryAdded, eventType: "directory.added" }, { file: "setup-hook.json", transform: transformPluginSetup, eventType: "plugin.setup" }, + // Added in plugin 0.35.0. + { file: "model-first-use.json", transform: transformModelFirstUse, eventType: "model.first_use" }, ]; for (const { file, transform, eventType } of fixtureCases) { @@ -353,6 +368,8 @@ describe("plugin↔backend wire contract (DEV-88)", () => { "cwd.change", "directory.added", "plugin.setup", + // Added in plugin 0.35.0. + "model.first_use", ].sort(), ); }); diff --git a/packages/backend/src/routes/__tests__/events.test.ts b/packages/backend/src/routes/__tests__/events.test.ts index 8bc3e9e..eb14dc3 100644 --- a/packages/backend/src/routes/__tests__/events.test.ts +++ b/packages/backend/src/routes/__tests__/events.test.ts @@ -284,6 +284,19 @@ describe("POST /events", () => { expect(res.status).not.toBe(400); }); + test("accepts eventType model.first_use (added in plugin 0.35.0)", async () => { + const sql = makeMockSql(); + const app = buildApp(sql); + + const res = await app.request("/", { + method: "POST", + headers: { "Content-Type": "application/json" }, + body: JSON.stringify(validEvent({ eventType: "model.first_use" })), + }); + + expect(res.status).not.toBe(400); + }); + // Pre-0.15.0 plugins stay installed and keep sending these; dropping them // from the enum would turn their events into 400s. test.each(["worktree.create", "worktree.remove"])( diff --git a/packages/backend/src/routes/events.ts b/packages/backend/src/routes/events.ts index e677141..f7d53f3 100644 --- a/packages/backend/src/routes/events.ts +++ b/packages/backend/src/routes/events.ts @@ -59,6 +59,8 @@ const eventSchema = z.object({ "tool.batch", "prompt.expansion", "response.failed", "model.switch", "permission.denied", "task.created", "cwd.change", "directory.added", "plugin.setup", + // Added in plugin 0.35.0. + "model.first_use", ]), payload: z.record(z.unknown()), }); diff --git a/packages/backend/src/utils/eventSchemas.ts b/packages/backend/src/utils/eventSchemas.ts index df9aad1..0c9f381 100644 --- a/packages/backend/src/utils/eventSchemas.ts +++ b/packages/backend/src/utils/eventSchemas.ts @@ -347,6 +347,19 @@ const modelSwitchPayloadSchema = z }) .strict(); +/** + * `model-first-use.sh` — SessionStart / PostModelSwitch, the first time a model + * is used on the developer's machine. `trigger` says which of the two saw it. + */ +const modelFirstUsePayloadSchema = z + .object({ + model: z.string(), + trigger: z.string(), + previousModel: z.string().optional(), + ...privacyAnnotations, + }) + .strict(); + /** `permission-denied.sh` — PermissionDenied. */ const permissionDeniedPayloadSchema = z .object({ @@ -428,6 +441,8 @@ export const payloadSchemasByEventType = { "cwd.change": cwdChangePayloadSchema, "directory.added": directoryAddedPayloadSchema, "plugin.setup": pluginSetupPayloadSchema, + // Added in plugin 0.35.0. + "model.first_use": modelFirstUsePayloadSchema, } as const; export type EventTypeKey = keyof typeof payloadSchemasByEventType; diff --git a/packages/dashboard/src/components/LiveFeed.tsx b/packages/dashboard/src/components/LiveFeed.tsx index 263f8ef..0f0eaa9 100644 --- a/packages/dashboard/src/components/LiveFeed.tsx +++ b/packages/dashboard/src/components/LiveFeed.tsx @@ -205,6 +205,7 @@ function buildFeedItems(events: FeedEvent[]): FeedItem[] { case "cwd.change": case "directory.added": case "plugin.setup": + case "model.first_use": flushTools(); items.push({ kind: "event", key: event.id, event }); break; diff --git a/packages/dashboard/src/lib/eventDisplay.ts b/packages/dashboard/src/lib/eventDisplay.ts index 0579394..32bb8b6 100644 --- a/packages/dashboard/src/lib/eventDisplay.ts +++ b/packages/dashboard/src/lib/eventDisplay.ts @@ -42,6 +42,8 @@ export const EVENT_COLORS: Record = { "cwd.change": "border-slate-500/30 bg-slate-500/5", "directory.added": "border-slate-500/30 bg-slate-500/5", "plugin.setup": "border-sky-500/30 bg-sky-500/5", + // Added in plugin 0.35.0 + "model.first_use": "border-fuchsia-500/50 bg-fuchsia-500/10", }; export const EVENT_LABELS: Record = { @@ -76,6 +78,8 @@ export const EVENT_LABELS: Record = { "cwd.change": "Directory Changed", "directory.added": "Directory Added", "plugin.setup": "Plugin Setup", + // Added in plugin 0.35.0 + "model.first_use": "New Model", }; export function getEventSummary(event: FeedEvent): string { @@ -169,6 +173,11 @@ export function getEventSummary(event: FeedEvent): string { return String(p.directory ?? "directory"); case "plugin.setup": return "Trigger: " + String(p.trigger ?? "init"); + case "model.first_use": { + const model = String(p.model ?? ""); + const prev = p.previousModel ? ` (from ${String(p.previousModel)})` : ""; + return model ? `First use of ${model}${prev}` : "First use of a model"; + } default: return event.eventType; } diff --git a/packages/shared/src/events.ts b/packages/shared/src/events.ts index c0b60f2..29d1f69 100644 --- a/packages/shared/src/events.ts +++ b/packages/shared/src/events.ts @@ -32,7 +32,9 @@ export type EventType = | "task.created" | "cwd.change" | "directory.added" - | "plugin.setup"; + | "plugin.setup" + // Added in plugin 0.35.0: the first time a model is used on a machine. + | "model.first_use"; export interface DevscopeEvent { id: string;