@camerontaylor/paseo-protocol 0.10.2-fork.1 → 0.11.0-beta.3.fork.1

package/dist/messages.js

@@ -184,6 +184,7 @@ export const AgentFeatureSelectSchema = z.object({
     description: z.string().optional(),
     tooltip: z.string().optional(),
     icon: z.string().optional(),
+    desktopTrigger: z.enum(["icon", "label"]).optional(),
     value: z.string().nullable(),
     options: z.array(AgentSelectOptionSchema),
 });
@@ -288,7 +289,7 @@ const McpServerConfigSchema = z.discriminatedUnion("type", [
     McpHttpServerConfigSchema,
     McpSseServerConfigSchema,
 ]);
-const ProviderOptionsSchema = z.record(z.string(), z.json());
+const ProviderOptionsSchema = z.record(z.string(), z.unknown());
 const McpToolRefSchema = z
     .object({
     kind: z.literal("mcp"),
@@ -1476,6 +1477,12 @@ export const ProviderUsageListRequestMessageSchema = z.object({
     type: z.literal("provider.usage.list.request"),
     requestId: z.string(),
 });
+export const UsageListReportsRequestMessageSchema = z.object({
+    type: z.literal("usage.list_reports.request"),
+    requestId: z.string(),
+    reportIds: z.array(z.string()).optional(),
+    forceRefresh: z.boolean().optional(),
+});
 export const ResumeAgentRequestMessageSchema = z.object({
     type: z.literal("resume_agent_request"),
     handle: AgentPersistenceHandleSchema,
@@ -2791,6 +2798,7 @@ export const SessionInboundMessageSchema = z.discriminatedUnion("type", [
     RefreshProvidersSnapshotRequestMessageSchema,
     ProviderDiagnosticRequestMessageSchema,
     ProviderUsageListRequestMessageSchema,
+    UsageListReportsRequestMessageSchema,
     ResumeAgentRequestMessageSchema,
     ImportAgentRequestMessageSchema,
     RefreshAgentRequestMessageSchema,
@@ -3076,6 +3084,7 @@ export const ServerInfoStatusPayloadSchema = z
         // COMPAT(hubAgentRpc): added in v0.8.0; remove gate after 2027-03-05.
         hubAgentRpc: z.boolean().optional(),
         providersSnapshot: z.boolean().optional(),
+        usageSources: z.boolean().optional(),
         // COMPAT(providersSnapshotCwd): added in v0.3.2, remove gate after 2027-02-10.
         providersSnapshotCwd: z.boolean().optional(),
         // COMPAT(directorySync): added in v0.3.x, remove gate after 2027-02-12.
@@ -5572,6 +5581,13 @@ export const ProviderUsageStatusSchema = z.enum(["available", "unavailable", "er
 export const ProviderUsageWindowSchema = z.object({
     id: z.string(),
     label: z.string(),
+    /**
+     * A few characters naming the window where space is tight, e.g. "5h" or "wk". An empty string
+     * shows the percent alone; leaving it out shows `label`.
+     */
+    shortLabel: z.string().optional(),
+    /** Shown in the usage summary until the user pins windows of their own. */
+    summary: z.boolean().optional(),
     usedPct: z.number().nullable().optional(),
     remainingPct: z.number().nullable().optional(),
     resetsAt: z.string().nullable().optional(),
@@ -5618,6 +5634,43 @@ export const ProviderUsageListResponseMessageSchema = z.object({
         providers: z.array(ProviderUsageSchema),
     }),
 });
+export const UsageProblemSchema = z.discriminatedUnion("kind", [
+    z.object({
+        kind: z.literal("expired"),
+        expiresAt: z.iso.datetime(),
+        refreshedBy: z.string().optional(),
+    }),
+    z.object({
+        kind: z.literal("rejected"),
+        status: z.number().int(),
+        refreshedBy: z.string().optional(),
+    }),
+    z.object({ kind: z.literal("no_quota"), detail: z.string() }),
+]);
+export const UsageReportSchema = z.discriminatedUnion("status", [
+    z.object({
+        status: z.literal("available"),
+        planLabel: z.string().optional(),
+        windows: z.array(ProviderUsageWindowSchema),
+        balances: z.array(ProviderUsageBalanceSchema).optional(),
+        details: z.array(ProviderUsageDetailSchema).optional(),
+    }),
+    z.object({ status: z.literal("unavailable"), problem: UsageProblemSchema }),
+    z.object({ status: z.literal("error"), error: z.string() }),
+]);
+export const UsageReportEntrySchema = z.object({
+    id: z.string(),
+    account: z.object({ label: z.string().optional() }),
+    fetchedAt: z.string(),
+    sourceId: z.string(),
+    sourceLabel: z.string(),
+    icon: z.string().optional(),
+    report: UsageReportSchema,
+});
+export const UsageListReportsResponseMessageSchema = z.object({
+    type: z.literal("usage.list_reports.response"),
+    payload: z.object({ requestId: z.string(), reports: z.array(UsageReportEntrySchema) }),
+});
 const AgentSlashCommandSchema = z.object({
     name: z.string(),
     description: z.string(),
@@ -6225,6 +6278,7 @@ export const SessionOutboundMessageSchema = z.discriminatedUnion("type", [
     RefreshProvidersSnapshotResponseMessageSchema,
     ProviderDiagnosticResponseMessageSchema,
     ProviderUsageListResponseMessageSchema,
+    UsageListReportsResponseMessageSchema,
     ListCommandsResponseSchema,
     ListTerminalsResponseSchema,
     TerminalsChangedSchema,

package/dist/provider-config.d.ts

@@ -44,6 +44,7 @@ export declare const ProviderOverrideSchema: z.ZodObject<{
     description: z.ZodOptional<z.ZodString>;
     command: z.ZodOptional<z.ZodArray<z.ZodString>>;
     env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     models: z.ZodOptional<z.ZodArray<z.ZodObject<{
         id: z.ZodString;
@@ -83,6 +84,7 @@ export declare const ProviderOverridesSchema: z.ZodRecord<z.ZodString, z.ZodObje
     description: z.ZodOptional<z.ZodString>;
     command: z.ZodOptional<z.ZodArray<z.ZodString>>;
     env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     models: z.ZodOptional<z.ZodArray<z.ZodObject<{
         id: z.ZodString;

package/dist/provider-config.js

@@ -44,6 +44,8 @@ export const ProviderOverrideSchema = z.object({
     description: z.string().optional(),
     command: z.array(z.string().min(1)).min(1).optional(),
     env: z.record(z.string(), z.string()).optional(),
+    options: z.record(z.string(), z.unknown()).optional(),
+    // COMPAT(providerParams): added in v0.10.0, remove after 2027-03-30 once configs use options.
     params: z.record(z.string(), z.unknown()).optional(),
     models: z.array(ProviderProfileModelSchema).optional(),
     additionalModels: z.array(ProviderProfileModelSchema).optional(),
@@ -68,14 +70,10 @@ export const ProviderOverridesSchema = z
             });
         }
         const isBuiltinProvider = builtinProviderIdSet.has(providerId);
-        if (!isBuiltinProvider && !provider.extends) {
-            ctx.addIssue({
-                code: z.ZodIssueCode.custom,
-                path: [providerId, "extends"],
-                message: `Custom provider "${providerId}" must declare extends.`,
-            });
-        }
-        if (!isBuiltinProvider && !provider.label) {
+        // Config loads before plugin registration. An entry without extends is an override;
+        // registry construction decides whether its provider exists. Configurable plugin IDs
+        // use this existing config alphabet; dots/underscores remain registration-only.
+        if (!isBuiltinProvider && provider.extends && !provider.label) {
             ctx.addIssue({
                 code: z.ZodIssueCode.custom,
                 path: [providerId, "label"],

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

@@ -32,7 +32,7 @@ export declare const ScheduleCreateRequestSchema: z.ZodObject<{
                 worktree: "worktree";
             }>>;
             title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-            providerOptions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
+            providerOptions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
             featureValues: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
             systemPrompt: z.ZodOptional<z.ZodString>;
             mcpServers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
@@ -144,7 +144,7 @@ export declare const ScheduleCreateResponseSchema: z.ZodObject<{
                         worktree: "worktree";
                     }>>;
                     title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-                    providerOptions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
+                    providerOptions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
                     featureValues: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
                     systemPrompt: z.ZodOptional<z.ZodString>;
                     mcpServers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
@@ -199,7 +199,7 @@ export declare const ScheduleListResponseSchema: z.ZodObject<{
                         worktree: "worktree";
                     }>>;
                     title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-                    providerOptions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
+                    providerOptions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
                     featureValues: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
                     systemPrompt: z.ZodOptional<z.ZodString>;
                     mcpServers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
@@ -248,7 +248,7 @@ export declare const ScheduleInspectResponseSchema: z.ZodObject<{
                         worktree: "worktree";
                     }>>;
                     title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-                    providerOptions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
+                    providerOptions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
                     featureValues: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
                     systemPrompt: z.ZodOptional<z.ZodString>;
                     mcpServers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
@@ -346,7 +346,7 @@ export declare const SchedulePauseResponseSchema: z.ZodObject<{
                         worktree: "worktree";
                     }>>;
                     title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-                    providerOptions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
+                    providerOptions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
                     featureValues: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
                     systemPrompt: z.ZodOptional<z.ZodString>;
                     mcpServers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
@@ -401,7 +401,7 @@ export declare const ScheduleResumeResponseSchema: z.ZodObject<{
                         worktree: "worktree";
                     }>>;
                     title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-                    providerOptions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
+                    providerOptions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
                     featureValues: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
                     systemPrompt: z.ZodOptional<z.ZodString>;
                     mcpServers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
@@ -458,7 +458,7 @@ export declare const ScheduleRunOnceResponseSchema: z.ZodObject<{
                         worktree: "worktree";
                     }>>;
                     title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-                    providerOptions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
+                    providerOptions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
                     featureValues: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
                     systemPrompt: z.ZodOptional<z.ZodString>;
                     mcpServers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
@@ -528,7 +528,7 @@ export declare const ScheduleUpdateResponseSchema: z.ZodObject<{
                         worktree: "worktree";
                     }>>;
                     title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-                    providerOptions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
+                    providerOptions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
                     featureValues: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
                     systemPrompt: z.ZodOptional<z.ZodString>;
                     mcpServers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;

package/dist/schedule/types.d.ts

@@ -31,7 +31,7 @@ export declare const ScheduleTargetSchema: z.ZodDiscriminatedUnion<[z.ZodObject<
             worktree: "worktree";
         }>>;
         title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        providerOptions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
+        providerOptions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
         featureValues: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
         systemPrompt: z.ZodOptional<z.ZodString>;
         mcpServers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
@@ -83,7 +83,7 @@ export declare const StoredScheduleSchema: z.ZodObject<{
                 worktree: "worktree";
             }>>;
             title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-            providerOptions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
+            providerOptions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
             featureValues: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
             systemPrompt: z.ZodOptional<z.ZodString>;
             mcpServers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
@@ -153,7 +153,7 @@ export declare const ScheduleSummarySchema: z.ZodObject<{
                 worktree: "worktree";
             }>>;
             title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-            providerOptions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
+            providerOptions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
             featureValues: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
             systemPrompt: z.ZodOptional<z.ZodString>;
             mcpServers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;

package/dist/schedule/types.js

@@ -28,7 +28,7 @@ export const ScheduleTargetSchema = z.discriminatedUnion("type", [
             archiveOnFinish: z.boolean().optional(),
             isolation: z.enum(["local", "worktree"]).optional(),
             title: z.string().trim().min(1).nullable().optional(),
-            providerOptions: z.record(z.string(), z.json()).optional(),
+            providerOptions: z.record(z.string(), z.unknown()).optional(),
             featureValues: z.record(z.string(), z.unknown()).optional(),
             systemPrompt: z.string().optional(),
             mcpServers: z.record(z.string(), z.unknown()).optional(),