@linkshell/gateway 0.4.34 → 0.4.36

package/dist/shared-protocol/src/index.d.ts

@@ -8531,6 +8531,314 @@ export declare const agentV2HistoryResultPayloadSchema: z.ZodObject<{
     nextCursor?: string | undefined;
     hasMore?: boolean | undefined;
 }>;
+export declare const agentV2UsageTotalsSchema: z.ZodObject<{
+    inputTokens: z.ZodDefault<z.ZodNumber>;
+    outputTokens: z.ZodDefault<z.ZodNumber>;
+    cacheReadTokens: z.ZodDefault<z.ZodNumber>;
+    cacheWriteTokens: z.ZodDefault<z.ZodNumber>;
+    totalTokens: z.ZodDefault<z.ZodNumber>;
+    calls: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    inputTokens: number;
+    outputTokens: number;
+    cacheReadTokens: number;
+    totalTokens: number;
+    cacheWriteTokens: number;
+    calls: number;
+}, {
+    inputTokens?: number | undefined;
+    outputTokens?: number | undefined;
+    cacheReadTokens?: number | undefined;
+    totalTokens?: number | undefined;
+    cacheWriteTokens?: number | undefined;
+    calls?: number | undefined;
+}>;
+export declare const agentV2UsageBucketSchema: z.ZodObject<{
+    inputTokens: z.ZodDefault<z.ZodNumber>;
+    outputTokens: z.ZodDefault<z.ZodNumber>;
+    cacheReadTokens: z.ZodDefault<z.ZodNumber>;
+    cacheWriteTokens: z.ZodDefault<z.ZodNumber>;
+    totalTokens: z.ZodDefault<z.ZodNumber>;
+    calls: z.ZodDefault<z.ZodNumber>;
+} & {
+    key: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    inputTokens: number;
+    outputTokens: number;
+    cacheReadTokens: number;
+    totalTokens: number;
+    cacheWriteTokens: number;
+    calls: number;
+    key: string;
+}, {
+    key: string;
+    inputTokens?: number | undefined;
+    outputTokens?: number | undefined;
+    cacheReadTokens?: number | undefined;
+    totalTokens?: number | undefined;
+    cacheWriteTokens?: number | undefined;
+    calls?: number | undefined;
+}>;
+export declare const agentV2UsageRequestPayloadSchema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+export declare const agentV2UsageReportPayloadSchema: z.ZodObject<{
+    totals: z.ZodObject<{
+        inputTokens: z.ZodDefault<z.ZodNumber>;
+        outputTokens: z.ZodDefault<z.ZodNumber>;
+        cacheReadTokens: z.ZodDefault<z.ZodNumber>;
+        cacheWriteTokens: z.ZodDefault<z.ZodNumber>;
+        totalTokens: z.ZodDefault<z.ZodNumber>;
+        calls: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        inputTokens: number;
+        outputTokens: number;
+        cacheReadTokens: number;
+        totalTokens: number;
+        cacheWriteTokens: number;
+        calls: number;
+    }, {
+        inputTokens?: number | undefined;
+        outputTokens?: number | undefined;
+        cacheReadTokens?: number | undefined;
+        totalTokens?: number | undefined;
+        cacheWriteTokens?: number | undefined;
+        calls?: number | undefined;
+    }>;
+    sessions: z.ZodDefault<z.ZodNumber>;
+    peakDayTokens: z.ZodDefault<z.ZodNumber>;
+    longestTaskMs: z.ZodDefault<z.ZodNumber>;
+    currentStreakDays: z.ZodDefault<z.ZodNumber>;
+    longestStreakDays: z.ZodDefault<z.ZodNumber>;
+    byDay: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        inputTokens: z.ZodDefault<z.ZodNumber>;
+        outputTokens: z.ZodDefault<z.ZodNumber>;
+        cacheReadTokens: z.ZodDefault<z.ZodNumber>;
+        cacheWriteTokens: z.ZodDefault<z.ZodNumber>;
+        totalTokens: z.ZodDefault<z.ZodNumber>;
+        calls: z.ZodDefault<z.ZodNumber>;
+    } & {
+        key: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        inputTokens: number;
+        outputTokens: number;
+        cacheReadTokens: number;
+        totalTokens: number;
+        cacheWriteTokens: number;
+        calls: number;
+        key: string;
+    }, {
+        key: string;
+        inputTokens?: number | undefined;
+        outputTokens?: number | undefined;
+        cacheReadTokens?: number | undefined;
+        totalTokens?: number | undefined;
+        cacheWriteTokens?: number | undefined;
+        calls?: number | undefined;
+    }>, "many">>;
+    byHourWeekday: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        weekday: z.ZodNumber;
+        hour: z.ZodNumber;
+        tokens: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        weekday: number;
+        hour: number;
+        tokens: number;
+    }, {
+        weekday: number;
+        hour: number;
+        tokens: number;
+    }>, "many">>;
+    byTool: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        inputTokens: z.ZodDefault<z.ZodNumber>;
+        outputTokens: z.ZodDefault<z.ZodNumber>;
+        cacheReadTokens: z.ZodDefault<z.ZodNumber>;
+        cacheWriteTokens: z.ZodDefault<z.ZodNumber>;
+        totalTokens: z.ZodDefault<z.ZodNumber>;
+        calls: z.ZodDefault<z.ZodNumber>;
+    } & {
+        key: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        inputTokens: number;
+        outputTokens: number;
+        cacheReadTokens: number;
+        totalTokens: number;
+        cacheWriteTokens: number;
+        calls: number;
+        key: string;
+    }, {
+        key: string;
+        inputTokens?: number | undefined;
+        outputTokens?: number | undefined;
+        cacheReadTokens?: number | undefined;
+        totalTokens?: number | undefined;
+        cacheWriteTokens?: number | undefined;
+        calls?: number | undefined;
+    }>, "many">>;
+    byModel: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        inputTokens: z.ZodDefault<z.ZodNumber>;
+        outputTokens: z.ZodDefault<z.ZodNumber>;
+        cacheReadTokens: z.ZodDefault<z.ZodNumber>;
+        cacheWriteTokens: z.ZodDefault<z.ZodNumber>;
+        totalTokens: z.ZodDefault<z.ZodNumber>;
+        calls: z.ZodDefault<z.ZodNumber>;
+    } & {
+        key: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        inputTokens: number;
+        outputTokens: number;
+        cacheReadTokens: number;
+        totalTokens: number;
+        cacheWriteTokens: number;
+        calls: number;
+        key: string;
+    }, {
+        key: string;
+        inputTokens?: number | undefined;
+        outputTokens?: number | undefined;
+        cacheReadTokens?: number | undefined;
+        totalTokens?: number | undefined;
+        cacheWriteTokens?: number | undefined;
+        calls?: number | undefined;
+    }>, "many">>;
+    byProject: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        inputTokens: z.ZodDefault<z.ZodNumber>;
+        outputTokens: z.ZodDefault<z.ZodNumber>;
+        cacheReadTokens: z.ZodDefault<z.ZodNumber>;
+        cacheWriteTokens: z.ZodDefault<z.ZodNumber>;
+        totalTokens: z.ZodDefault<z.ZodNumber>;
+        calls: z.ZodDefault<z.ZodNumber>;
+    } & {
+        key: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        inputTokens: number;
+        outputTokens: number;
+        cacheReadTokens: number;
+        totalTokens: number;
+        cacheWriteTokens: number;
+        calls: number;
+        key: string;
+    }, {
+        key: string;
+        inputTokens?: number | undefined;
+        outputTokens?: number | undefined;
+        cacheReadTokens?: number | undefined;
+        totalTokens?: number | undefined;
+        cacheWriteTokens?: number | undefined;
+        calls?: number | undefined;
+    }>, "many">>;
+    generatedAt: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    totals: {
+        inputTokens: number;
+        outputTokens: number;
+        cacheReadTokens: number;
+        totalTokens: number;
+        cacheWriteTokens: number;
+        calls: number;
+    };
+    sessions: number;
+    peakDayTokens: number;
+    longestTaskMs: number;
+    currentStreakDays: number;
+    longestStreakDays: number;
+    byDay: {
+        inputTokens: number;
+        outputTokens: number;
+        cacheReadTokens: number;
+        totalTokens: number;
+        cacheWriteTokens: number;
+        calls: number;
+        key: string;
+    }[];
+    byHourWeekday: {
+        weekday: number;
+        hour: number;
+        tokens: number;
+    }[];
+    byTool: {
+        inputTokens: number;
+        outputTokens: number;
+        cacheReadTokens: number;
+        totalTokens: number;
+        cacheWriteTokens: number;
+        calls: number;
+        key: string;
+    }[];
+    byModel: {
+        inputTokens: number;
+        outputTokens: number;
+        cacheReadTokens: number;
+        totalTokens: number;
+        cacheWriteTokens: number;
+        calls: number;
+        key: string;
+    }[];
+    byProject: {
+        inputTokens: number;
+        outputTokens: number;
+        cacheReadTokens: number;
+        totalTokens: number;
+        cacheWriteTokens: number;
+        calls: number;
+        key: string;
+    }[];
+    generatedAt: number;
+}, {
+    totals: {
+        inputTokens?: number | undefined;
+        outputTokens?: number | undefined;
+        cacheReadTokens?: number | undefined;
+        totalTokens?: number | undefined;
+        cacheWriteTokens?: number | undefined;
+        calls?: number | undefined;
+    };
+    generatedAt: number;
+    sessions?: number | undefined;
+    peakDayTokens?: number | undefined;
+    longestTaskMs?: number | undefined;
+    currentStreakDays?: number | undefined;
+    longestStreakDays?: number | undefined;
+    byDay?: {
+        key: string;
+        inputTokens?: number | undefined;
+        outputTokens?: number | undefined;
+        cacheReadTokens?: number | undefined;
+        totalTokens?: number | undefined;
+        cacheWriteTokens?: number | undefined;
+        calls?: number | undefined;
+    }[] | undefined;
+    byHourWeekday?: {
+        weekday: number;
+        hour: number;
+        tokens: number;
+    }[] | undefined;
+    byTool?: {
+        key: string;
+        inputTokens?: number | undefined;
+        outputTokens?: number | undefined;
+        cacheReadTokens?: number | undefined;
+        totalTokens?: number | undefined;
+        cacheWriteTokens?: number | undefined;
+        calls?: number | undefined;
+    }[] | undefined;
+    byModel?: {
+        key: string;
+        inputTokens?: number | undefined;
+        outputTokens?: number | undefined;
+        cacheReadTokens?: number | undefined;
+        totalTokens?: number | undefined;
+        cacheWriteTokens?: number | undefined;
+        calls?: number | undefined;
+    }[] | undefined;
+    byProject?: {
+        key: string;
+        inputTokens?: number | undefined;
+        outputTokens?: number | undefined;
+        cacheReadTokens?: number | undefined;
+        totalTokens?: number | undefined;
+        cacheWriteTokens?: number | undefined;
+        calls?: number | undefined;
+    }[] | undefined;
+}>;
 export declare const agentV2ConversationUpdatePayloadSchema: z.ZodObject<{
     conversationId: z.ZodString;
     title: z.ZodOptional<z.ZodString>;
@@ -15736,11 +16044,271 @@ export declare const protocolMessageSchemas: {
         nextCursor?: string | undefined;
         hasMore?: boolean | undefined;
     }>;
+    readonly "agent.v2.usage.request": z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+    readonly "agent.v2.usage.report": z.ZodObject<{
+        totals: z.ZodObject<{
+            inputTokens: z.ZodDefault<z.ZodNumber>;
+            outputTokens: z.ZodDefault<z.ZodNumber>;
+            cacheReadTokens: z.ZodDefault<z.ZodNumber>;
+            cacheWriteTokens: z.ZodDefault<z.ZodNumber>;
+            totalTokens: z.ZodDefault<z.ZodNumber>;
+            calls: z.ZodDefault<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            inputTokens: number;
+            outputTokens: number;
+            cacheReadTokens: number;
+            totalTokens: number;
+            cacheWriteTokens: number;
+            calls: number;
+        }, {
+            inputTokens?: number | undefined;
+            outputTokens?: number | undefined;
+            cacheReadTokens?: number | undefined;
+            totalTokens?: number | undefined;
+            cacheWriteTokens?: number | undefined;
+            calls?: number | undefined;
+        }>;
+        sessions: z.ZodDefault<z.ZodNumber>;
+        peakDayTokens: z.ZodDefault<z.ZodNumber>;
+        longestTaskMs: z.ZodDefault<z.ZodNumber>;
+        currentStreakDays: z.ZodDefault<z.ZodNumber>;
+        longestStreakDays: z.ZodDefault<z.ZodNumber>;
+        byDay: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            inputTokens: z.ZodDefault<z.ZodNumber>;
+            outputTokens: z.ZodDefault<z.ZodNumber>;
+            cacheReadTokens: z.ZodDefault<z.ZodNumber>;
+            cacheWriteTokens: z.ZodDefault<z.ZodNumber>;
+            totalTokens: z.ZodDefault<z.ZodNumber>;
+            calls: z.ZodDefault<z.ZodNumber>;
+        } & {
+            key: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            inputTokens: number;
+            outputTokens: number;
+            cacheReadTokens: number;
+            totalTokens: number;
+            cacheWriteTokens: number;
+            calls: number;
+            key: string;
+        }, {
+            key: string;
+            inputTokens?: number | undefined;
+            outputTokens?: number | undefined;
+            cacheReadTokens?: number | undefined;
+            totalTokens?: number | undefined;
+            cacheWriteTokens?: number | undefined;
+            calls?: number | undefined;
+        }>, "many">>;
+        byHourWeekday: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            weekday: z.ZodNumber;
+            hour: z.ZodNumber;
+            tokens: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            weekday: number;
+            hour: number;
+            tokens: number;
+        }, {
+            weekday: number;
+            hour: number;
+            tokens: number;
+        }>, "many">>;
+        byTool: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            inputTokens: z.ZodDefault<z.ZodNumber>;
+            outputTokens: z.ZodDefault<z.ZodNumber>;
+            cacheReadTokens: z.ZodDefault<z.ZodNumber>;
+            cacheWriteTokens: z.ZodDefault<z.ZodNumber>;
+            totalTokens: z.ZodDefault<z.ZodNumber>;
+            calls: z.ZodDefault<z.ZodNumber>;
+        } & {
+            key: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            inputTokens: number;
+            outputTokens: number;
+            cacheReadTokens: number;
+            totalTokens: number;
+            cacheWriteTokens: number;
+            calls: number;
+            key: string;
+        }, {
+            key: string;
+            inputTokens?: number | undefined;
+            outputTokens?: number | undefined;
+            cacheReadTokens?: number | undefined;
+            totalTokens?: number | undefined;
+            cacheWriteTokens?: number | undefined;
+            calls?: number | undefined;
+        }>, "many">>;
+        byModel: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            inputTokens: z.ZodDefault<z.ZodNumber>;
+            outputTokens: z.ZodDefault<z.ZodNumber>;
+            cacheReadTokens: z.ZodDefault<z.ZodNumber>;
+            cacheWriteTokens: z.ZodDefault<z.ZodNumber>;
+            totalTokens: z.ZodDefault<z.ZodNumber>;
+            calls: z.ZodDefault<z.ZodNumber>;
+        } & {
+            key: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            inputTokens: number;
+            outputTokens: number;
+            cacheReadTokens: number;
+            totalTokens: number;
+            cacheWriteTokens: number;
+            calls: number;
+            key: string;
+        }, {
+            key: string;
+            inputTokens?: number | undefined;
+            outputTokens?: number | undefined;
+            cacheReadTokens?: number | undefined;
+            totalTokens?: number | undefined;
+            cacheWriteTokens?: number | undefined;
+            calls?: number | undefined;
+        }>, "many">>;
+        byProject: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            inputTokens: z.ZodDefault<z.ZodNumber>;
+            outputTokens: z.ZodDefault<z.ZodNumber>;
+            cacheReadTokens: z.ZodDefault<z.ZodNumber>;
+            cacheWriteTokens: z.ZodDefault<z.ZodNumber>;
+            totalTokens: z.ZodDefault<z.ZodNumber>;
+            calls: z.ZodDefault<z.ZodNumber>;
+        } & {
+            key: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            inputTokens: number;
+            outputTokens: number;
+            cacheReadTokens: number;
+            totalTokens: number;
+            cacheWriteTokens: number;
+            calls: number;
+            key: string;
+        }, {
+            key: string;
+            inputTokens?: number | undefined;
+            outputTokens?: number | undefined;
+            cacheReadTokens?: number | undefined;
+            totalTokens?: number | undefined;
+            cacheWriteTokens?: number | undefined;
+            calls?: number | undefined;
+        }>, "many">>;
+        generatedAt: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        totals: {
+            inputTokens: number;
+            outputTokens: number;
+            cacheReadTokens: number;
+            totalTokens: number;
+            cacheWriteTokens: number;
+            calls: number;
+        };
+        sessions: number;
+        peakDayTokens: number;
+        longestTaskMs: number;
+        currentStreakDays: number;
+        longestStreakDays: number;
+        byDay: {
+            inputTokens: number;
+            outputTokens: number;
+            cacheReadTokens: number;
+            totalTokens: number;
+            cacheWriteTokens: number;
+            calls: number;
+            key: string;
+        }[];
+        byHourWeekday: {
+            weekday: number;
+            hour: number;
+            tokens: number;
+        }[];
+        byTool: {
+            inputTokens: number;
+            outputTokens: number;
+            cacheReadTokens: number;
+            totalTokens: number;
+            cacheWriteTokens: number;
+            calls: number;
+            key: string;
+        }[];
+        byModel: {
+            inputTokens: number;
+            outputTokens: number;
+            cacheReadTokens: number;
+            totalTokens: number;
+            cacheWriteTokens: number;
+            calls: number;
+            key: string;
+        }[];
+        byProject: {
+            inputTokens: number;
+            outputTokens: number;
+            cacheReadTokens: number;
+            totalTokens: number;
+            cacheWriteTokens: number;
+            calls: number;
+            key: string;
+        }[];
+        generatedAt: number;
+    }, {
+        totals: {
+            inputTokens?: number | undefined;
+            outputTokens?: number | undefined;
+            cacheReadTokens?: number | undefined;
+            totalTokens?: number | undefined;
+            cacheWriteTokens?: number | undefined;
+            calls?: number | undefined;
+        };
+        generatedAt: number;
+        sessions?: number | undefined;
+        peakDayTokens?: number | undefined;
+        longestTaskMs?: number | undefined;
+        currentStreakDays?: number | undefined;
+        longestStreakDays?: number | undefined;
+        byDay?: {
+            key: string;
+            inputTokens?: number | undefined;
+            outputTokens?: number | undefined;
+            cacheReadTokens?: number | undefined;
+            totalTokens?: number | undefined;
+            cacheWriteTokens?: number | undefined;
+            calls?: number | undefined;
+        }[] | undefined;
+        byHourWeekday?: {
+            weekday: number;
+            hour: number;
+            tokens: number;
+        }[] | undefined;
+        byTool?: {
+            key: string;
+            inputTokens?: number | undefined;
+            outputTokens?: number | undefined;
+            cacheReadTokens?: number | undefined;
+            totalTokens?: number | undefined;
+            cacheWriteTokens?: number | undefined;
+            calls?: number | undefined;
+        }[] | undefined;
+        byModel?: {
+            key: string;
+            inputTokens?: number | undefined;
+            outputTokens?: number | undefined;
+            cacheReadTokens?: number | undefined;
+            totalTokens?: number | undefined;
+            cacheWriteTokens?: number | undefined;
+            calls?: number | undefined;
+        }[] | undefined;
+        byProject?: {
+            key: string;
+            inputTokens?: number | undefined;
+            outputTokens?: number | undefined;
+            cacheReadTokens?: number | undefined;
+            totalTokens?: number | undefined;
+            cacheWriteTokens?: number | undefined;
+            calls?: number | undefined;
+        }[] | undefined;
+    }>;
 };
 export type ProtocolMessageType = keyof typeof protocolMessageSchemas;
-export declare const agentV2HostToClientMessageTypes: readonly ["agent.v2.capabilities", "agent.v2.conversation.opened", "agent.v2.conversation.list.result", "agent.v2.event", "agent.v2.snapshot", "agent.v2.permission.request", "agent.v2.notice", "agent.v2.history.result", "agent.v2.conversation.deleted"];
+export declare const agentV2HostToClientMessageTypes: readonly ["agent.v2.capabilities", "agent.v2.conversation.opened", "agent.v2.conversation.list.result", "agent.v2.event", "agent.v2.snapshot", "agent.v2.permission.request", "agent.v2.notice", "agent.v2.history.result", "agent.v2.conversation.deleted", "agent.v2.usage.report"];
 export declare const agentV2ClientWriteMessageTypes: readonly ["agent.v2.conversation.open", "agent.v2.conversation.update", "agent.v2.conversation.delete", "agent.v2.prompt", "agent.v2.command.execute", "agent.v2.cancel", "agent.v2.permission.respond", "agent.v2.structured_input.respond"];
-export declare const agentV2ClientReadMessageTypes: readonly ["agent.v2.capabilities.request", "agent.v2.conversation.list", "agent.v2.snapshot.request", "agent.v2.history.request"];
+export declare const agentV2ClientReadMessageTypes: readonly ["agent.v2.capabilities.request", "agent.v2.conversation.list", "agent.v2.snapshot.request", "agent.v2.history.request", "agent.v2.usage.request"];
 export type AgentV2MessageRoute = "host_to_client" | "client_write" | "client_read";
 export declare function agentV2MessageRoute(type: string): AgentV2MessageRoute | null;
 export declare function isAgentV2HostToClientMessage(type: string): boolean;

package/dist/shared-protocol/src/index.js

@@ -762,6 +762,39 @@ export const agentV2HistoryResultPayloadSchema = z.object({
     nextCursor: z.string().optional(),
     hasMore: z.boolean().default(false),
 });
+// Usage dashboard. The host aggregates ALL on-disk agent transcripts
+// (~/.claude/projects + ~/.codex/sessions) — decoupled from any live LinkShell
+// turn, so history + externally-started sessions all count. Token figures are
+// per-call sums (ccusage convention); the client renders an activity heatmap +
+// summary cards (cumulative / peak / streaks / longest task) + breakdowns.
+export const agentV2UsageTotalsSchema = z.object({
+    inputTokens: z.number().default(0),
+    outputTokens: z.number().default(0),
+    cacheReadTokens: z.number().default(0),
+    cacheWriteTokens: z.number().default(0),
+    totalTokens: z.number().default(0),
+    calls: z.number().default(0),
+});
+export const agentV2UsageBucketSchema = agentV2UsageTotalsSchema.extend({
+    key: z.string(),
+});
+export const agentV2UsageRequestPayloadSchema = z.object({});
+export const agentV2UsageReportPayloadSchema = z.object({
+    totals: agentV2UsageTotalsSchema,
+    sessions: z.number().default(0),
+    peakDayTokens: z.number().default(0),
+    longestTaskMs: z.number().default(0),
+    currentStreakDays: z.number().default(0),
+    longestStreakDays: z.number().default(0),
+    byDay: z.array(agentV2UsageBucketSchema).default([]), // key=YYYY-MM-DD, ascending
+    byHourWeekday: z
+        .array(z.object({ weekday: z.number(), hour: z.number(), tokens: z.number() }))
+        .default([]),
+    byTool: z.array(agentV2UsageBucketSchema).default([]),
+    byModel: z.array(agentV2UsageBucketSchema).default([]),
+    byProject: z.array(agentV2UsageBucketSchema).default([]),
+    generatedAt: z.number(),
+});
 // Mutate a conversation's user-facing metadata (rename / archive toggle).
 // Fields are optional: send only what changes. The host applies the patch to
 // its tracked conversation and echoes the updated record back via agent.v2.event.
@@ -859,6 +892,8 @@ export const protocolMessageSchemas = {
     "agent.v2.notice": agentV2NoticePayloadSchema,
     "agent.v2.history.request": agentV2HistoryRequestPayloadSchema,
     "agent.v2.history.result": agentV2HistoryResultPayloadSchema,
+    "agent.v2.usage.request": agentV2UsageRequestPayloadSchema,
+    "agent.v2.usage.report": agentV2UsageReportPayloadSchema,
 };
 export const agentV2HostToClientMessageTypes = [
     "agent.v2.capabilities",
@@ -870,6 +905,7 @@ export const agentV2HostToClientMessageTypes = [
     "agent.v2.notice",
     "agent.v2.history.result",
     "agent.v2.conversation.deleted",
+    "agent.v2.usage.report",
 ];
 export const agentV2ClientWriteMessageTypes = [
     "agent.v2.conversation.open",
@@ -886,6 +922,7 @@ export const agentV2ClientReadMessageTypes = [
     "agent.v2.conversation.list",
     "agent.v2.snapshot.request",
     "agent.v2.history.request",
+    "agent.v2.usage.request",
 ];
 const agentV2HostToClientSet = new Set(agentV2HostToClientMessageTypes);
 const agentV2ClientWriteSet = new Set(agentV2ClientWriteMessageTypes);