@otto-code/protocol 0.7.0 → 0.7.2

package/dist/messages.js

@@ -432,6 +432,13 @@ export const MutableDaemonConfigSchema = z
     // Defaults false so a new client parsing an old daemon's config keeps the
     // action visible. Gated by server_info features.hideMergeIntoBaseSetting.
     hideMergeIntoBaseAction: z.boolean().default(false),
+    // Retention for the images agents produce (docs/attachment-lifecycle.md).
+    // Host-level, because the store they govern is the daemon's. Defaults match
+    // the constants the daemon shipped with, so a client parsing an old daemon's
+    // config sees the policy actually in force rather than zeros. 0 on either
+    // disables that lever. Gated by server_info features.attachmentStorage.
+    attachmentImageMaxAgeDays: z.number().int().min(0).default(30),
+    attachmentImageMaxTotalMb: z.number().int().min(0).default(512),
     enableTerminalAgentHooks: z.boolean().default(false),
     appendSystemPrompt: z.string().default(""),
     terminalProfiles: z.array(TerminalProfileSchema).optional(),
@@ -492,6 +499,9 @@ export const MutableDaemonConfigPatchSchema = z
     autoArchiveAfterMerge: z.boolean().optional(),
     // Gated by server_info features.hideMergeIntoBaseSetting.
     hideMergeIntoBaseAction: z.boolean().optional(),
+    // Gated by server_info features.attachmentStorage.
+    attachmentImageMaxAgeDays: z.number().int().min(0).optional(),
+    attachmentImageMaxTotalMb: z.number().int().min(0).optional(),
     enableTerminalAgentHooks: z.boolean().optional(),
     appendSystemPrompt: z.string().optional(),
     terminalProfiles: z.array(TerminalProfileSchema).optional(),
@@ -1251,6 +1261,58 @@ export const UpdateAgentRequestMessageSchema = z.object({
     labels: z.record(z.string(), z.string()).optional(),
     requestId: z.string(),
 });
+// ── Attachment storage ──────────────────────────────────────────────────────
+// Agents produce image bytes continuously (browser screenshots above all), and
+// the daemon materializes each one to $OTTO_HOME/attachments so the timeline has
+// a file to point at. These two RPCs are the user's window into that store: how
+// much is there, and give it back. See docs/attachment-lifecycle.md.
+//
+// Scope is deliberately global, not per-chat or per-workspace. Filenames are a
+// content hash, so the same bytes may be referenced from several transcripts and
+// "this workspace's images" is a fiction we would have to invent and maintain.
+// Gated by server_info.features.attachmentStorage.
+export const AttachmentsImagesStatsRequestSchema = z.object({
+    type: z.literal("attachments.images.get_stats.request"),
+    requestId: z.string(),
+});
+export const AttachmentsImagesStatsResponseSchema = z.object({
+    type: z.literal("attachments.images.get_stats.response"),
+    payload: z.object({
+        fileCount: z.number().int().nonnegative(),
+        totalBytes: z.number().nonnegative(),
+        // ISO timestamp of the oldest image, or null when the store is empty. The
+        // readout quotes it so "512 MB" comes with "since March".
+        oldestAt: z.string().nullable(),
+        // The policy currently in force, so the settings row shows real numbers
+        // rather than the client's idea of the defaults.
+        maxAgeDays: z.number().int().nonnegative(),
+        maxTotalMb: z.number().int().nonnegative(),
+        error: z.string().nullable(),
+        requestId: z.string(),
+    }),
+});
+export const AttachmentsImagesClearRequestSchema = z.object({
+    type: z.literal("attachments.images.clear.request"),
+    // 0 = every stored image. N = only images untouched for at least N days.
+    olderThanDays: z.number().int().min(0).default(0),
+    // Safe by default: a request that omits the flag previews instead of deleting.
+    // The client always sends it explicitly. Same contract as
+    // history.agents.clear_archived, and for the same reason — the client cannot
+    // enumerate the set, and there is no undo.
+    dryRun: z.boolean().default(true),
+    requestId: z.string(),
+});
+export const AttachmentsImagesClearResponseSchema = z.object({
+    type: z.literal("attachments.images.clear.response"),
+    payload: z.object({
+        matched: z.number().int().nonnegative(),
+        deleted: z.number().int().nonnegative(),
+        freedBytes: z.number().nonnegative(),
+        dryRun: z.boolean(),
+        error: z.string().nullable(),
+        requestId: z.string(),
+    }),
+});
 export const ProjectRenameRequestSchema = z.object({
     type: z.literal("project.rename.request"),
     projectId: z.string(),
@@ -1970,6 +2032,13 @@ export const ImportAgentRequestMessageSchema = z.object({
     sessionId: z.string().optional(),
     providerHandleId: z.string().optional(),
     cwd: z.string().optional(),
+    // The workspace the import was requested from. Present when the client has a
+    // workspace context (a chat tab); absent from the home screen, where the
+    // daemon resolves a workspace for the cwd instead.
+    // COMPAT(importAgentWorkspaceId): added in v0.7.1, drop the optionality when
+    // the floor is >= v0.7.1. An older client omits it and keeps the
+    // resolve-by-directory behaviour.
+    workspaceId: z.string().optional(),
     labels: z.record(z.string(), z.string()).optional(),
     requestId: z.string(),
 });
@@ -2196,6 +2265,16 @@ export const ContextCategorySchema = z.enum([
 export const ContextCostClassSchema = z.enum(["fixed", "conditional", "referenced"]);
 export const ContextSeveritySchema = z.enum(["ok", "notice", "warn", "critical"]);
 export const ContextConfidenceSchema = z.enum(["exact", "convention", "unverified"]);
+// Per-category disclosure of how well the daemon can see a provider's payload.
+// `not_visible` is the reason this exists: a CLI-backed provider composes its
+// own preset and hands MCP servers to a subprocess, so those categories are
+// unmeasurable rather than empty, and the row has to be able to say which.
+export const ContextCategoryVisibilitySchema = z.enum([
+    "exact",
+    "convention",
+    "unverified",
+    "not_visible",
+]);
 export const ContextFindingKindSchema = z.enum([
     "dead_import",
     "dead_reference",
@@ -2265,6 +2344,10 @@ export const ContextCategoryTotalSchema = z.object({
     estTokens: z.number(),
     sharePercent: z.number(),
     severity: ContextSeveritySchema,
+    // COMPAT(contextCategoryVisibility): added in v0.7.1, drop the optionality
+    // when the floor is >= v0.7.1. An older client ignores the field and still
+    // gets correct totals; a newer client seeing it absent renders no badge.
+    visibility: ContextCategoryVisibilitySchema.optional(),
 });
 export const ContextReportSchema = z.object({
     workspaceId: z.string(),
@@ -2325,6 +2408,43 @@ export const ContextReportGetResponseMessageSchema = z.object({
         report: ContextReportSchema.nullable(),
     }),
 });
+// One readable block of the assembled prompt. `text` is absent exactly when
+// `visibility` is "not_visible" — the provider composes that part internally and
+// Otto has nothing to show, which the section states rather than hides.
+export const ContextPromptSectionSchema = z.object({
+    category: ContextCategorySchema,
+    label: z.string(),
+    visibility: ContextCategoryVisibilitySchema,
+    text: z.string().optional(),
+    estTokens: z.number(),
+});
+export const ContextPromptPreviewSchema = z.object({
+    sections: z.array(ContextPromptSectionSchema),
+    estTokens: z.number(),
+});
+// Read-only by design: there is no matching write RPC. Editing happens per file
+// through the existing file pane, against the real file rather than a
+// concatenation of several.
+export const ContextPromptPreviewGetRequestMessageSchema = z.object({
+    type: z.literal("context.prompt.preview.get.request"),
+    requestId: z.string(),
+    workspaceId: z.string(),
+    provider: z.string().optional(),
+    windowTokens: z.number().optional(),
+    personalityId: z.string().optional(),
+    // Assemble only this category. The tab reads one section at a time — the user
+    // clicked a row in the tree — and assembling the rest would re-read every
+    // context file on disk to build text nobody asked to see. Omitted means all,
+    // which is what an older client sends.
+    category: ContextCategorySchema.optional(),
+});
+export const ContextPromptPreviewGetResponseMessageSchema = z.object({
+    type: z.literal("context.prompt.preview.get.response"),
+    payload: z.object({
+        requestId: z.string(),
+        preview: ContextPromptPreviewSchema.nullable(),
+    }),
+});
 // Converts one edge between "always loaded" and "link only". Server-side
 // because the parent file may live outside the workspace root.
 export const ContextEdgeConvertRequestMessageSchema = z.object({
@@ -4108,6 +4228,8 @@ export const SessionInboundMessageSchema = z.discriminatedUnion("type", [
     ArchiveAgentRequestMessageSchema,
     CloseItemsRequestMessageSchema,
     HistoryAgentsClearArchivedRequestSchema,
+    AttachmentsImagesStatsRequestSchema,
+    AttachmentsImagesClearRequestSchema,
     UpdateAgentRequestMessageSchema,
     ProjectRenameRequestSchema,
     ProjectRemoveRequestSchema,
@@ -4146,6 +4268,7 @@ export const SessionInboundMessageSchema = z.discriminatedUnion("type", [
     ProviderUsageListRequestMessageSchema,
     StatsActivityGetRequestMessageSchema,
     ContextReportGetRequestMessageSchema,
+    ContextPromptPreviewGetRequestMessageSchema,
     ContextEdgeConvertRequestMessageSchema,
     ContextFindingsFixRequestMessageSchema,
     PersonalityMemoryListRequestMessageSchema,
@@ -4721,6 +4844,14 @@ export const ServerInfoStatusPayloadSchema = z
         // There is no client-side substitute (the client never touches the
         // filesystem), so an old daemon simply does not get the menu items.
         fileMutations: z.boolean().optional(),
+        // COMPAT(attachmentStorage): added in v0.7.1, drop the gate when daemon floor >= v0.7.1.
+        // Set when the daemon serves `attachments.images.get_stats` and
+        // `attachments.images.clear` — the readout and reclaim for the images it
+        // materializes on the agent's behalf. The client has no way to size or
+        // clear a directory on the host, so an old daemon simply does not get
+        // the daemon half of the Storage section; the app-side preview cache row
+        // is local and always shown.
+        attachmentStorage: z.boolean().optional(),
     })
         .optional(),
 })
@@ -7842,6 +7973,8 @@ export const SessionOutboundMessageSchema = z.discriminatedUnion("type", [
     AgentPermissionResolvedMessageSchema,
     AgentDeletedMessageSchema,
     HistoryAgentsClearArchivedResponseSchema,
+    AttachmentsImagesStatsResponseSchema,
+    AttachmentsImagesClearResponseSchema,
     AgentArchivedMessageSchema,
     CloseItemsResponseSchema,
     CheckoutStatusResponseSchema,
@@ -7947,6 +8080,7 @@ export const SessionOutboundMessageSchema = z.discriminatedUnion("type", [
     ProviderUsageListResponseMessageSchema,
     StatsActivityGetResponseMessageSchema,
     ContextReportGetResponseMessageSchema,
+    ContextPromptPreviewGetResponseMessageSchema,
     ContextEdgeConvertResponseMessageSchema,
     ContextFindingsFixResponseMessageSchema,
     PersonalityMemoryListResponseMessageSchema,

package/dist/model-tiers.js

@@ -24,17 +24,24 @@ export const KNOWN_MODEL_TIERS = {
     // Opus variants are "deep", non-1M Opus and Sonnet are "standard", Haiku is
     // "fast". Fable (1M, most powerful) is "deep".
     "claude-fable-5": "deep",
+    // Opus 4.7/4.8/5 are natively 1M, so the plain ids are "deep" and the manifest
+    // ships no `[1m]` row for them. The decorated ids stay mapped here because the
+    // CLI still accepts them and a user's settings.json or an older agent record
+    // may carry one.
     "claude-opus-5[1m]": "deep",
-    "claude-opus-5": "standard",
+    "claude-opus-5": "deep",
     "claude-opus-4-8[1m]": "deep",
-    "claude-opus-4-8": "standard",
+    "claude-opus-4-8": "deep",
     "claude-opus-4-7[1m]": "deep",
-    "claude-opus-4-7": "standard",
+    "claude-opus-4-7": "deep",
     "claude-opus-4-6[1m]": "deep",
     "claude-opus-4-6": "standard",
+    "claude-opus-4-5": "standard",
     "claude-sonnet-5": "standard",
     "claude-sonnet-4-6[1m]": "standard",
     "claude-sonnet-4-6": "standard",
+    "claude-sonnet-4-5[1m]": "standard",
+    "claude-sonnet-4-5": "standard",
     "claude-haiku-4-5": "fast",
     "claude-haiku-4-5-20251001": "fast",
     // OpenAI (GPT / o-series)

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

@@ -4118,6 +4118,8 @@ export declare const WSOutboundMessageSchema: {
                     }, import("zod/v4/core").$loose>>;
                     autoArchiveAfterMerge: import("zod").ZodDefault<import("zod").ZodBoolean>;
                     hideMergeIntoBaseAction: import("zod").ZodDefault<import("zod").ZodBoolean>;
+                    attachmentImageMaxAgeDays: import("zod").ZodDefault<import("zod").ZodNumber>;
+                    attachmentImageMaxTotalMb: import("zod").ZodDefault<import("zod").ZodNumber>;
                     enableTerminalAgentHooks: import("zod").ZodDefault<import("zod").ZodBoolean>;
                     appendSystemPrompt: import("zod").ZodDefault<import("zod").ZodString>;
                     terminalProfiles: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodObject<{
@@ -4290,6 +4292,8 @@ export declare const WSOutboundMessageSchema: {
                     }, import("zod/v4/core").$loose>>;
                     autoArchiveAfterMerge: import("zod").ZodDefault<import("zod").ZodBoolean>;
                     hideMergeIntoBaseAction: import("zod").ZodDefault<import("zod").ZodBoolean>;
+                    attachmentImageMaxAgeDays: import("zod").ZodDefault<import("zod").ZodNumber>;
+                    attachmentImageMaxTotalMb: import("zod").ZodDefault<import("zod").ZodNumber>;
                     enableTerminalAgentHooks: import("zod").ZodDefault<import("zod").ZodBoolean>;
                     appendSystemPrompt: import("zod").ZodDefault<import("zod").ZodString>;
                     terminalProfiles: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodObject<{
@@ -4851,6 +4855,12 @@ export declare const WSOutboundMessageSchema: {
                             warn: "warn";
                             critical: "critical";
                         }>;
+                        visibility: import("zod").ZodOptional<import("zod").ZodEnum<{
+                            exact: "exact";
+                            convention: "convention";
+                            unverified: "unverified";
+                            not_visible: "not_visible";
+                        }>>;
                     }, import("zod/v4/core").$strip>>;
                     fixedTotal: import("zod").ZodNumber;
                     conditionalTotal: import("zod").ZodNumber;
@@ -5133,6 +5143,27 @@ export declare const WSOutboundMessageSchema: {
                 error: import("zod").ZodNullable<import("zod").ZodString>;
                 requestId: import("zod").ZodString;
             }, import("zod/v4/core").$strip>;
+        }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+            type: import("zod").ZodLiteral<"attachments.images.get_stats.response">;
+            payload: import("zod").ZodObject<{
+                fileCount: import("zod").ZodNumber;
+                totalBytes: import("zod").ZodNumber;
+                oldestAt: import("zod").ZodNullable<import("zod").ZodString>;
+                maxAgeDays: import("zod").ZodNumber;
+                maxTotalMb: import("zod").ZodNumber;
+                error: import("zod").ZodNullable<import("zod").ZodString>;
+                requestId: import("zod").ZodString;
+            }, import("zod/v4/core").$strip>;
+        }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+            type: import("zod").ZodLiteral<"attachments.images.clear.response">;
+            payload: import("zod").ZodObject<{
+                matched: import("zod").ZodNumber;
+                deleted: import("zod").ZodNumber;
+                freedBytes: import("zod").ZodNumber;
+                dryRun: import("zod").ZodBoolean;
+                error: import("zod").ZodNullable<import("zod").ZodString>;
+                requestId: import("zod").ZodString;
+            }, import("zod/v4/core").$strip>;
         }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
             type: import("zod").ZodLiteral<"agent_archived">;
             payload: import("zod").ZodObject<{
@@ -8346,6 +8377,12 @@ export declare const WSOutboundMessageSchema: {
                             warn: "warn";
                             critical: "critical";
                         }>;
+                        visibility: import("zod").ZodOptional<import("zod").ZodEnum<{
+                            exact: "exact";
+                            convention: "convention";
+                            unverified: "unverified";
+                            not_visible: "not_visible";
+                        }>>;
                     }, import("zod/v4/core").$strip>>;
                     fixedTotal: import("zod").ZodNumber;
                     conditionalTotal: import("zod").ZodNumber;
@@ -8383,6 +8420,33 @@ export declare const WSOutboundMessageSchema: {
                     personalityMemoryTokens: import("zod").ZodOptional<import("zod").ZodNumber>;
                 }, import("zod/v4/core").$strip>>;
             }, import("zod/v4/core").$strip>;
+        }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+            type: import("zod").ZodLiteral<"context.prompt.preview.get.response">;
+            payload: import("zod").ZodObject<{
+                requestId: import("zod").ZodString;
+                preview: import("zod").ZodNullable<import("zod").ZodObject<{
+                    sections: import("zod").ZodArray<import("zod").ZodObject<{
+                        category: import("zod").ZodEnum<{
+                            context_files: "context_files";
+                            memory_index: "memory_index";
+                            skills_roster: "skills_roster";
+                            mcp_tools: "mcp_tools";
+                            otto_injected: "otto_injected";
+                            system_prompt: "system_prompt";
+                        }>;
+                        label: import("zod").ZodString;
+                        visibility: import("zod").ZodEnum<{
+                            exact: "exact";
+                            convention: "convention";
+                            unverified: "unverified";
+                            not_visible: "not_visible";
+                        }>;
+                        text: import("zod").ZodOptional<import("zod").ZodString>;
+                        estTokens: import("zod").ZodNumber;
+                    }, import("zod/v4/core").$strip>>;
+                    estTokens: import("zod").ZodNumber;
+                }, import("zod/v4/core").$strip>>;
+            }, import("zod/v4/core").$strip>;
         }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
             type: import("zod").ZodLiteral<"context.edge.convert.response">;
             payload: import("zod").ZodObject<{

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@otto-code/protocol",
-  "version": "0.7.0",
+  "version": "0.7.2",
   "description": "Otto shared protocol schemas and wire types",
   "license": "AGPL-3.0-or-later",
   "files": [