@otto-code/protocol 0.8.17 → 0.8.18

package/dist/messages.js

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import { MutableAgentBehaviorsConfigSchema, MutableLspConfigSchema, MutableDotnetSolutionConfigSchema, MutableGitHostingConfigSchema, MutableKanbanConfigSchema, MutableAgentPersonalitiesConfigSchema, MutableAgentPersonalitiesConfigPatchSchema, MutableAgentTeamsConfigSchema, MutableAgentTeamsConfigPatchSchema, MutableBrainConfigSchema, MutableBrainConfigPatchSchema, MutableGitFetchConfigSchema, DEFAULT_MUTABLE_BRAIN_CONFIG, } from "./daemon-config.js";
+import { MutableAgentBehaviorsConfigSchema, MutableLspConfigSchema, MutableDotnetSolutionConfigSchema, MutableGitHostingConfigSchema, MutableKanbanConfigSchema, MutableProjectKnowledgeConfigSchema, MutableAgentPersonalitiesConfigSchema, MutableAgentPersonalitiesConfigPatchSchema, MutableAgentTeamsConfigSchema, MutableAgentTeamsConfigPatchSchema, MutableBrainConfigSchema, MutableBrainConfigPatchSchema, MutableGitFetchConfigSchema, DEFAULT_MUTABLE_BRAIN_CONFIG, } from "./daemon-config.js";
 import { VisualizerVoiceCuesGenerateRequestSchema, VisualizerVoiceCuesGenerateResponseSchema, AgentProfileSpinnerSchema, AgentPersonalityVoiceSchema, AgentPersonalityVoiceCuesSchema, AgentPersonalitiesGetStatsRequestSchema, AgentPersonalitiesGenerateProfileRequestSchema, AgentPersonalitiesGetStatsResponseSchema, AgentPersonalitiesGenerateProfileResponseSchema, AgentProfileStatsRequestSchema, AgentProfileStatsResponseSchema, AgentProfileGeneratePromptRequestSchema, AgentProfileGeneratePromptResponseSchema, AgentProfileGenerateVoiceCuesRequestSchema, AgentProfileGenerateVoiceCuesResponseSchema, PersonalityMemoryListRequestMessageSchema, PersonalityMemoryListResponseMessageSchema, PersonalityMemoryUpdateRequestMessageSchema, PersonalityMemoryUpdateResponseMessageSchema, PersonalityMemoryTransferRequestMessageSchema, PersonalityMemoryTransferResponseMessageSchema, PersonalityMemoryStatsRequestMessageSchema, PersonalityMemoryStatsResponseMessageSchema, ProfileMemoryListRequestMessageSchema, ProfileMemoryListResponseMessageSchema, ProfileMemoryUpdateRequestMessageSchema, ProfileMemoryUpdateResponseMessageSchema, ProfileMemoryTransferRequestMessageSchema, ProfileMemoryTransferResponseMessageSchema, ProfileMemoryStatsRequestMessageSchema, ProfileMemoryStatsResponseMessageSchema, } from "./personality-schemas.js";
 import { TerminalCompatibilityDiagnosticRequestSchema, TerminalCompatibilityDiagnosticResponseSchema, } from "./terminal-compatibility.js";
 import { HostingPrAttachmentSchema, HostingIssueAttachmentSchema, HostingSearchRequestSchema, HostingAuthStatusRequestSchema, HostingListRepositoriesRequestSchema, HostingListOwnersRequestSchema, HostingListRepositoriesResponseSchema, HostingListOwnersResponseSchema, HostingAuthStatusResponseSchema, GitHostingCapabilitiesSchema, GitHostingProviderIdWireSchema, } from "./git-hosting.js";
@@ -14,7 +14,7 @@ import { FileEolSchema, FileCreateRequestSchema, FileDeleteRequestSchema, FileRe
 import { FileRefineRequestSchema, FileRefineResponseSchema } from "./refine.js";
 import { MutableSpeechConfigSchema, SpeechSettingsGetOptionsRequestSchema, SpeechTtsPreviewRequestSchema, SpeechTtsSpeakRequestSchema, SpeechTtsSpeakCancelRequestSchema, SpeechSettingsGetOptionsResponseSchema, SpeechTtsPreviewResponseSchema, SpeechTtsSpeakResponseSchema, SpeechTtsSpeakCancelResponseSchema, } from "./speech.js";
 import { ProjectLinksListRequestSchema, ProjectLinksSetRequestSchema, ProjectLinksUnsetRequestSchema, ProjectLinksListResponseSchema, ProjectLinksSetResponseSchema, ProjectLinksUnsetResponseSchema, ProjectLinksChangedSchema, } from "./project-links.js";
-import { ProjectKnowledgeListRequestMessageSchema, ProjectKnowledgeListResponseMessageSchema, ProjectKnowledgeGetRequestMessageSchema, ProjectKnowledgeGetResponseMessageSchema, ProjectKnowledgeCreateRequestMessageSchema, ProjectKnowledgeCreateResponseMessageSchema, ProjectKnowledgeApplyRequestMessageSchema, ProjectKnowledgeApplyResponseMessageSchema, ProjectKnowledgeStatusRequestMessageSchema, ProjectKnowledgeStatusResponseMessageSchema, ProjectKnowledgeProjectApplyRequestMessageSchema, ProjectKnowledgeProjectApplyResponseMessageSchema, ProjectKnowledgeReferenceApplyRequestMessageSchema, ProjectKnowledgeReferenceApplyResponseMessageSchema, ProjectKnowledgeRootApplyRequestMessageSchema, ProjectKnowledgeRootApplyResponseMessageSchema, ProjectKnowledgeDeleteRequestMessageSchema, ProjectKnowledgeDeleteResponseMessageSchema, } from "./project-knowledge.js";
+import { ProjectKnowledgeListRequestMessageSchema, ProjectKnowledgeListResponseMessageSchema, ProjectKnowledgeGetRequestMessageSchema, ProjectKnowledgeGetResponseMessageSchema, ProjectKnowledgeCreateRequestMessageSchema, ProjectKnowledgeCreateResponseMessageSchema, ProjectKnowledgeApplyRequestMessageSchema, ProjectKnowledgeApplyResponseMessageSchema, ProjectKnowledgeStatusRequestMessageSchema, ProjectKnowledgeStatusResponseMessageSchema, ProjectKnowledgeProjectApplyRequestMessageSchema, ProjectKnowledgeProjectApplyResponseMessageSchema, ProjectKnowledgeReferenceApplyRequestMessageSchema, ProjectKnowledgeReferenceApplyResponseMessageSchema, ProjectKnowledgeRootApplyRequestMessageSchema, ProjectKnowledgeRootApplyResponseMessageSchema, ProjectKnowledgeDeleteRequestMessageSchema, ProjectKnowledgeStoreLocationValueSchema, ProjectKnowledgeStoreGetRequestMessageSchema, ProjectKnowledgeStoreGetResponseMessageSchema, ProjectKnowledgeStoreSetRequestMessageSchema, ProjectKnowledgeStoreSetResponseMessageSchema, ProjectKnowledgeDeleteResponseMessageSchema, } from "./project-knowledge.js";
 import { CheckoutGitGetOperationLogRequestSchema, CheckoutGitGetOperationLogResponseSchema, CheckoutGitLogAppendedNotificationSchema, CheckoutGitCommitRequestSchema, CheckoutGitCommitAgentRequestSchema, CheckoutGitRollbackRequestSchema, CheckoutGitCommitResponseSchema, CheckoutGitCommitAgentResponseSchema, CheckoutGitRollbackResponseSchema, GitFileHistoryEntrySchema, GitBlameLineSchema, GitBlameCommitSchema, } from "./git-operations.js";
 import { LspServersListRequestSchema, LspServerStopRequestSchema, LspActivityChangedStatusPayloadSchema, LspDiagnosticsChangedStatusPayloadSchema, LspServersListResponseSchema, LspServerStopResponseSchema, CodeListFilesRequestSchema, CodeSymbolsRequestSchema, CodeOutlineRequestSchema, CodeDefinitionRequestSchema, CodeDocumentSyncRequestSchema, CodeDocumentCloseRequestSchema, CodeHoverRequestSchema, CodeReferencesRequestSchema, CodeRenamePreviewRequestSchema, CodeRenameApplyRequestSchema, CodeRenameUndoRequestSchema, CodeSolutionListRequestSchema, CodeSolutionGetTreeRequestSchema, CodeSolutionLoadProjectRequestSchema, CodeListFilesResponseSchema, CodeSymbolsResponseSchema, CodeDefinitionResponseSchema, CodeDocumentSyncResponseSchema, CodeDocumentCloseResponseSchema, CodeHoverResponseSchema, CodeReferencesResponseSchema, CodeRenamePreviewResponseSchema, CodeRenameUndoResponseSchema, CodeRenameApplyResponseSchema, CodeSolutionListResponseSchema, CodeSolutionGetTreeResponseSchema, CodeSolutionLoadProjectResponseSchema, CodeOutlineResponseSchema, } from "./code-intelligence.js";
 import { CommunicationsGetOverviewRequestSchema, CommunicationsGetOverviewResponseSchema, CommunicationsInboxGetHomeRequestSchema, CommunicationsInboxGetHomeResponseSchema, CommunicationsInboxSearchRequestSchema, CommunicationsInboxSearchResponseSchema, CommunicationsInboxSetFavoriteRequestSchema, CommunicationsInboxSetFavoriteResponseSchema, CommunicationsInboxNotificationsAcknowledgeRequestSchema, CommunicationsInboxNotificationsAcknowledgeResponseSchema, CommunicationsInboxGetPresenceRequestSchema, CommunicationsInboxGetPresenceResponseSchema, CommunicationsInboxPresenceChangedNotificationSchema, CommunicationsInboxSetPresenceRequestSchema, CommunicationsInboxSetPresenceResponseSchema, CommunicationsInboxSetEnabledRequestSchema, CommunicationsInboxSetEnabledResponseSchema, CommunicationsInboxGetMessagesRequestSchema, CommunicationsInboxGetMessagesResponseSchema, CommunicationsInboxSendMessageRequestSchema, CommunicationsInboxSendMessageResponseSchema, CommunicationsRoomGetRequestSchema, CommunicationsRoomGetResponseSchema, CommunicationsRoomThreadGetRequestSchema, CommunicationsRoomThreadGetResponseSchema, CommunicationsRoomMessageSendRequestSchema, CommunicationsRoomMessageSendResponseSchema, CommunicationsRoomReactionSetRequestSchema, CommunicationsRoomReactionSetResponseSchema, } from "./communications.js";
@@ -30,7 +30,7 @@ import { CLIENT_CAPS } from "./client-capabilities.js";
 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 { ConnectorConfigSchema, McpServerConfigSchema, OTTO_TOOL_GROUPS, STALL_GUARD_DEFAULT_THRESHOLD, } from "./provider-config.js";
+import { ConnectorConfigSchema, McpServerConfigSchema, STALL_GUARD_DEFAULT_THRESHOLD, } from "./provider-config.js";
 import { TOOL_CALL_ICON_NAMES } from "./agent-types.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";
@@ -55,7 +55,12 @@ const MutableDaemonProviderConfigSchema = z
     .object({
     enabled: z.boolean().optional(),
     additionalModels: z.array(MutableDaemonProviderModelSchema).optional(),
-    ottoToolGroups: z.array(z.enum(OTTO_TOOL_GROUPS)).optional(),
+    // COMPAT(ottoToolGroupsV2): added in v0.8.20. Legacy projection plus the
+    // authoritative v2 key; both are string[] rather than an enum so an older
+    // peer drops unknown group names instead of failing the whole config
+    // message. Read through resolveStoredOttoToolGroups.
+    ottoToolGroups: z.array(z.string().min(1)).optional(),
+    ottoToolGroupsV2: z.array(z.string().min(1)).optional(),
 })
     .passthrough();
 const MutableStructuredGenerationProviderSchema = z
@@ -151,6 +156,15 @@ export const ModelTierOverrideSchema = z
     tier: ModelTierSchema,
 })
     .passthrough();
+// A host-owned model-picker visibility choice. Stored as an array so a patch
+// replaces it wholesale and removing the final hidden-model entry sticks.
+export const ModelVisibilityOverrideSchema = z
+    .object({
+    provider: z.string().min(1),
+    modelId: z.string().min(1),
+    visible: z.boolean(),
+})
+    .passthrough();
 // A remembered provider endpoint: a base URL together with the credential it
 // was saved with, so pointing a provider back at a previous endpoint is one
 // pick instead of re-typing the key. Entries are scoped by the connection
@@ -185,7 +199,14 @@ export const MutableDaemonConfigSchema = z
         // undefined = all groups enabled (mirrors openai-compat's per-provider
         // ottoToolGroups semantics). An empty array = no Otto tools. Read by the
         // MCP catalog gating (WP-A).
-        toolGroups: z.array(z.enum(OTTO_TOOL_GROUPS)).optional(),
+        //
+        // COMPAT(ottoToolGroupsV2): added in v0.8.20. `toolGroups` is the legacy
+        // projection kept for older peers, `toolGroupsV2` is authoritative, and
+        // both are string[] rather than an enum so an older peer drops group
+        // names it does not know instead of failing the whole config message.
+        // Read through resolveStoredOttoToolGroups, never directly.
+        toolGroups: z.array(z.string().min(1)).optional(),
+        toolGroupsV2: z.array(z.string().min(1)).optional(),
     })
         .passthrough(),
     // Defaults off, matching the daemon's own resolution - browser tools are an
@@ -252,6 +273,9 @@ export const MutableDaemonConfigSchema = z
     // Gated by the modelTierOverrides feature; defaults empty so a new client
     // parsing an old daemon's config still sees a well-formed array.
     modelTierOverrides: z.array(ModelTierOverrideSchema).default([]),
+    // Per-host model-picker visibility. Gated by modelVisibilityOverrides;
+    // absent on an old host means every selectable model remains visible.
+    modelVisibilityOverrides: z.array(ModelVisibilityOverrideSchema).default([]),
     // Per-host remembered provider endpoints (base URL + credential), pooled by
     // env-var family. Gated by the savedProviderEndpoints feature; defaults
     // empty so a new client parsing an old daemon's config still sees a
@@ -287,6 +311,11 @@ export const MutableDaemonConfigSchema = z
     // Kanban board surface credentials (provider tokens). Gated by
     // server_info features.kanbanBoard; absent on older daemons.
     kanban: MutableKanbanConfigSchema.optional(),
+    // Host-wide default for where a project's Knowledge store lives. Gated by
+    // server_info features.projectKnowledgeStoreLocation. Optional rather than
+    // defaulted, matching `kanban`: absent reads as the historical repository
+    // location, which is exactly what an old daemon does.
+    projectKnowledge: MutableProjectKnowledgeConfigSchema.optional(),
     agentProfiles: z.array(AgentProfileSchema).optional(),
 })
     .passthrough();
@@ -326,6 +355,9 @@ export const MutableDaemonConfigPatchSchema = z
     speech: MutableSpeechConfigSchema.optional(),
     // Gated by server_info features.gitHostingProviders; patches deep-merge.
     gitHosting: MutableGitHostingConfigSchema.optional(),
+    // Gated by server_info features.projectKnowledgeStoreLocation; patches
+    // deep-merge.
+    projectKnowledge: MutableProjectKnowledgeConfigSchema.partial().optional(),
     // Gated by server_info features.agentPersonalities. A patch replaces the
     // full roster (read-modify-write the array), matching how terminalProfiles
     // and metadataGeneration.providers patch.
@@ -337,6 +369,9 @@ export const MutableDaemonConfigPatchSchema = z
     // Gated by server_info features.modelTierOverrides. Replaces the full array
     // (read-modify-write), so removing an entry clears that model's tag.
     modelTierOverrides: z.array(ModelTierOverrideSchema).optional(),
+    // Gated by server_info features.modelVisibilityOverrides. Replaces the
+    // full array so checking the last hidden model clears the stored policy.
+    modelVisibilityOverrides: z.array(ModelVisibilityOverrideSchema).optional(),
     // Gated by server_info features.savedProviderEndpoints. Replaces the full
     // array (read-modify-write), so forgetting an endpoint drops it from disk.
     savedProviderEndpoints: z.array(SavedProviderEndpointSchema).optional(),
@@ -440,6 +475,9 @@ const AgentModelDefinitionSchema = z.object({
     // Daemon-stamped capability tier (deep/standard/fast). Optional: absent on old
     // daemons and on models neither classified nor user-tagged.
     tier: ModelTierSchema.optional(),
+    // Host-owned model-picker visibility. Optional for backward compatibility;
+    // absent means visible.
+    isVisible: z.boolean().optional(),
     // False when the model can't run the provider's "auto" permission mode.
     // Optional: absent on old daemons and when supported/unknown.
     supportsAutoMode: z.boolean().optional(),
@@ -786,6 +824,7 @@ export const AgentTimelineItemPayloadSchema = z.union([
     z.object({
         type: z.literal("error"),
         message: z.string(),
+        details: z.array(z.string()).optional(),
     }),
     z.object({
         type: z.literal("compaction"),
@@ -3350,6 +3389,8 @@ export const SessionInboundMessageSchema = z.discriminatedUnion("type", [
     ProjectKnowledgeReferenceApplyRequestMessageSchema,
     ProjectKnowledgeRootApplyRequestMessageSchema,
     ProjectKnowledgeDeleteRequestMessageSchema,
+    ProjectKnowledgeStoreGetRequestMessageSchema,
+    ProjectKnowledgeStoreSetRequestMessageSchema,
     ContextEdgeConvertRequestMessageSchema,
     ContextFindingsFixRequestMessageSchema,
     PersonalityMemoryListRequestMessageSchema,
@@ -3926,6 +3967,11 @@ export const ServerInfoStatusPayloadSchema = z
         personalityMemory: z.boolean().optional(),
         // COMPAT(projectKnowledge): added in v0.8.5, drop the gate when daemon floor >= v0.8.5.
         projectKnowledge: z.boolean().optional(),
+        // COMPAT(projectKnowledgeStoreLocation): added in v0.8.18, drop the gate
+        // when daemon floor >= v0.8.18. A project's Knowledge store can live
+        // host-local instead of in the repository: the project.knowledge.store.*
+        // RPCs, the per-project override, and the host default setting.
+        projectKnowledgeStoreLocation: z.boolean().optional(),
         // Script discovery - the daemon scans a workspace for the Scripts its
         // project files already declare (package.json scripts, and later
         // Makefile targets, .NET launch profiles) and serves them from
@@ -4034,6 +4080,8 @@ export const ServerInfoStatusPayloadSchema = z
         agentTeams: z.boolean().optional(),
         // COMPAT(modelTierOverrides): added in v0.5.2, drop the gate when daemon floor >= v0.5.2.
         modelTierOverrides: z.boolean().optional(),
+        // COMPAT(modelVisibilityOverrides): added in v0.8.18, drop the gate when daemon floor >= v0.8.18.
+        modelVisibilityOverrides: z.boolean().optional(),
         // COMPAT(savedProviderEndpoints): added in v0.6.5, drop the gate when daemon floor >= v0.6.5.
         savedProviderEndpoints: z.boolean().optional(),
         // COMPAT(agentOrchestration): added in v0.5.3, drop the gate when daemon floor >= v0.5.3.
@@ -4744,6 +4792,13 @@ export const WorkspaceProjectDescriptorPayloadSchema = z.object({
     // COMPAT(projectKanbanTarget): added in v0.8.11, drop the optional gate when
     // floor >= v0.8.11.
     projectKanban: ProjectKanbanTargetSchema.nullable().optional(),
+    // The project's Knowledge store override. Rides the project channel for the
+    // same reason the Kanban target does: Project Settings must show it for a
+    // project with no active workspaces, where no session-scoped RPC applies.
+    // Null means "inherit the host default".
+    // COMPAT(projectKnowledgeStoreLocation): added in v0.8.18, drop the optional
+    // gate when floor >= v0.8.18.
+    projectKnowledgeLocation: ProjectKnowledgeStoreLocationValueSchema.nullable().optional(),
     // COMPAT(projectCustomIcon): added in v0.2.0, remove after 2027-01-20.
     projectCustomIconRevision: z.string().nullable().optional(),
     projectRootPath: z.string(),
@@ -7234,6 +7289,8 @@ export const SessionOutboundMessageSchema = z.discriminatedUnion("type", [
     ProjectKnowledgeReferenceApplyResponseMessageSchema,
     ProjectKnowledgeRootApplyResponseMessageSchema,
     ProjectKnowledgeDeleteResponseMessageSchema,
+    ProjectKnowledgeStoreGetResponseMessageSchema,
+    ProjectKnowledgeStoreSetResponseMessageSchema,
     ContextEdgeConvertResponseMessageSchema,
     ContextFindingsFixResponseMessageSchema,
     PersonalityMemoryListResponseMessageSchema,
@@ -7405,5 +7462,5 @@ export * from "./storage.js";
 export * from "./suggested-tasks.js";
 export * from "./worktree-ops.js";
 export * from "./terminal-compatibility.js";
-export { MutableAgentBehaviorsConfigSchema, MutableLspConfigSchema, MutableDotnetSolutionConfigSchema, MutableGitHostingBitbucketCloudConfigSchema, MutableGitHostingAtlassianConfigSchema, MutableGitHostingProvidersConfigSchema, MutableGitHostingConfigSchema, MutableKanbanConfigSchema, MutableAgentPersonalitiesConfigSchema, MutableAgentPersonalitiesConfigPatchSchema, MutableAgentTeamsConfigSchema, MutableAgentTeamsConfigPatchSchema, MutableBrainTlsConfigSchema, MutableBrainRemoteConfigSchema, MutableBrainConfigSchema, MutableBrainTlsPatchSchema, MutableBrainRemotePatchSchema, MutableBrainListenPatchSchema, MutableBrainConfigPatchSchema, MutableGitFetchConfigSchema, DEFAULT_MUTABLE_BRAIN_CONFIG, DEFAULT_MUTABLE_GIT_FETCH_CONFIG, GIT_FETCH_INTERVAL_SECONDS, } from "./daemon-config.js";
+export { MutableAgentBehaviorsConfigSchema, MutableLspConfigSchema, MutableDotnetSolutionConfigSchema, MutableGitHostingBitbucketCloudConfigSchema, MutableGitHostingAtlassianConfigSchema, MutableGitHostingProvidersConfigSchema, MutableGitHostingConfigSchema, MutableKanbanConfigSchema, ProjectKnowledgeStoreLocationSchema, MutableProjectKnowledgeConfigSchema, MutableAgentPersonalitiesConfigSchema, MutableAgentPersonalitiesConfigPatchSchema, MutableAgentTeamsConfigSchema, MutableAgentTeamsConfigPatchSchema, MutableBrainTlsConfigSchema, MutableBrainRemoteConfigSchema, MutableBrainConfigSchema, MutableBrainTlsPatchSchema, MutableBrainRemotePatchSchema, MutableBrainListenPatchSchema, MutableBrainConfigPatchSchema, MutableGitFetchConfigSchema, DEFAULT_MUTABLE_BRAIN_CONFIG, DEFAULT_MUTABLE_GIT_FETCH_CONFIG, GIT_FETCH_INTERVAL_SECONDS, } from "./daemon-config.js";
 //# sourceMappingURL=messages.js.map

package/dist/project-knowledge.d.ts

@@ -16,6 +16,22 @@ export declare const ProjectKnowledgeStatusSchema: z.ZodEnum<{
     proposed: "proposed";
     confirmed: "confirmed";
 }>;
+/**
+ * Where a project keeps its Knowledge store. `repository` is the historical
+ * `.otto/` directory in the working tree; `host` is a directory under the
+ * daemon's `$OTTO_HOME`, so the working tree stays clean. `null` on a project
+ * means "inherit the host default".
+ *
+ * Declared up here rather than beside the store RPCs at the bottom of the file:
+ * `messages.ts` composes it into the project descriptor, and the AOT validator
+ * generator evaluates these modules for real, so a schema referenced by another
+ * must already exist when that reference runs.
+ * COMPAT(projectKnowledgeStoreLocation): added in v0.8.18.
+ */
+export declare const ProjectKnowledgeStoreLocationValueSchema: z.ZodEnum<{
+    repository: "repository";
+    host: "host";
+}>;
 export declare const ProjectDeliveryStatusSchema: z.ZodEnum<{
     reference: "reference";
     charter: "charter";
@@ -92,6 +108,7 @@ export declare const ProjectKnowledgeRecordSchema: z.ZodObject<{
         affects: z.ZodOptional<z.ZodArray<z.ZodString>>;
     }, z.core.$strip>>>;
     path: z.ZodOptional<z.ZodString>;
+    absolutePath: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 /** Review health, not a persisted project-knowledge finding record. */
 export declare const ProjectKnowledgeHealthSchema: z.ZodObject<{
@@ -113,6 +130,7 @@ export declare const ProjectKnowledgeRootPageSchema: z.ZodObject<{
     slug: z.ZodString;
     title: z.ZodString;
     path: z.ZodString;
+    absolutePath: z.ZodOptional<z.ZodString>;
     body: z.ZodString;
 }, z.core.$strip>;
 export declare const ProjectKnowledgeListRequestMessageSchema: z.ZodObject<{
@@ -178,11 +196,13 @@ export declare const ProjectKnowledgeListResponseMessageSchema: z.ZodObject<{
                 affects: z.ZodOptional<z.ZodArray<z.ZodString>>;
             }, z.core.$strip>>>;
             path: z.ZodOptional<z.ZodString>;
+            absolutePath: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>;
         rootPages: z.ZodOptional<z.ZodArray<z.ZodObject<{
             slug: z.ZodString;
             title: z.ZodString;
             path: z.ZodString;
+            absolutePath: z.ZodOptional<z.ZodString>;
             body: z.ZodString;
         }, z.core.$strip>>>;
         findings: z.ZodArray<z.ZodObject<{
@@ -270,6 +290,7 @@ export declare const ProjectKnowledgeGetResponseMessageSchema: z.ZodObject<{
                 affects: z.ZodOptional<z.ZodArray<z.ZodString>>;
             }, z.core.$strip>>>;
             path: z.ZodOptional<z.ZodString>;
+            absolutePath: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>;
     }, z.core.$strip>;
 }, z.core.$strip>;
@@ -379,6 +400,7 @@ export declare const ProjectKnowledgeCreateResponseMessageSchema: z.ZodObject<{
                 affects: z.ZodOptional<z.ZodArray<z.ZodString>>;
             }, z.core.$strip>>>;
             path: z.ZodOptional<z.ZodString>;
+            absolutePath: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>;
     }, z.core.$strip>;
 }, z.core.$strip>;
@@ -453,6 +475,7 @@ export declare const ProjectKnowledgeApplyResponseMessageSchema: z.ZodObject<{
                 affects: z.ZodOptional<z.ZodArray<z.ZodString>>;
             }, z.core.$strip>>>;
             path: z.ZodOptional<z.ZodString>;
+            absolutePath: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>;
         error: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>;
@@ -527,6 +550,7 @@ export declare const ProjectKnowledgeStatusResponseMessageSchema: z.ZodObject<{
                 affects: z.ZodOptional<z.ZodArray<z.ZodString>>;
             }, z.core.$strip>>>;
             path: z.ZodOptional<z.ZodString>;
+            absolutePath: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>;
     }, z.core.$strip>;
 }, z.core.$strip>;
@@ -611,6 +635,7 @@ export declare const ProjectKnowledgeProjectApplyResponseMessageSchema: z.ZodObj
                 affects: z.ZodOptional<z.ZodArray<z.ZodString>>;
             }, z.core.$strip>>>;
             path: z.ZodOptional<z.ZodString>;
+            absolutePath: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>;
         error: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>;
@@ -689,6 +714,7 @@ export declare const ProjectKnowledgeReferenceApplyResponseMessageSchema: z.ZodO
                 affects: z.ZodOptional<z.ZodArray<z.ZodString>>;
             }, z.core.$strip>>>;
             path: z.ZodOptional<z.ZodString>;
+            absolutePath: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>;
         error: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>;
@@ -708,6 +734,7 @@ export declare const ProjectKnowledgeRootApplyResponseMessageSchema: z.ZodObject
             slug: z.ZodString;
             title: z.ZodString;
             path: z.ZodString;
+            absolutePath: z.ZodOptional<z.ZodString>;
             body: z.ZodString;
         }, z.core.$strip>>;
     }, z.core.$strip>;
@@ -737,4 +764,103 @@ export type ProjectKnowledgeProjectApplyResponseMessage = z.infer<typeof Project
 export type ProjectKnowledgeReferenceApplyResponseMessage = z.infer<typeof ProjectKnowledgeReferenceApplyResponseMessageSchema>;
 export type ProjectKnowledgeRootApplyResponseMessage = z.infer<typeof ProjectKnowledgeRootApplyResponseMessageSchema>;
 export type ProjectKnowledgeDeleteResponseMessage = z.infer<typeof ProjectKnowledgeDeleteResponseMessageSchema>;
+/** What the daemon resolved for a workspace, and why the client may act on it. */
+export declare const ProjectKnowledgeStoreDescriptorSchema: z.ZodObject<{
+    location: z.ZodEnum<{
+        repository: "repository";
+        host: "host";
+    }>;
+    override: z.ZodNullable<z.ZodEnum<{
+        repository: "repository";
+        host: "host";
+    }>>;
+    hostDefault: z.ZodEnum<{
+        repository: "repository";
+        host: "host";
+    }>;
+    basePath: z.ZodString;
+    projectId: z.ZodNullable<z.ZodString>;
+    hasPages: z.ZodBoolean;
+    otherLocationHasPages: z.ZodBoolean;
+}, z.core.$strip>;
+/**
+ * Addressed by project or by workspace. Project Settings has a project and no
+ * open workspace; the Knowledge panel has a workspace and reaches its project
+ * through it. Both are optional on the wire and the daemon rejects neither
+ * being set, rather than forcing a caller to invent an id it does not have.
+ */
+export declare const ProjectKnowledgeStoreGetRequestMessageSchema: z.ZodObject<{
+    type: z.ZodLiteral<"project.knowledge.store.get.request">;
+    requestId: z.ZodString;
+    workspaceId: z.ZodOptional<z.ZodString>;
+    projectId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const ProjectKnowledgeStoreGetResponseMessageSchema: z.ZodObject<{
+    type: z.ZodLiteral<"project.knowledge.store.get.response">;
+    payload: z.ZodObject<{
+        requestId: z.ZodString;
+        store: z.ZodNullable<z.ZodObject<{
+            location: z.ZodEnum<{
+                repository: "repository";
+                host: "host";
+            }>;
+            override: z.ZodNullable<z.ZodEnum<{
+                repository: "repository";
+                host: "host";
+            }>>;
+            hostDefault: z.ZodEnum<{
+                repository: "repository";
+                host: "host";
+            }>;
+            basePath: z.ZodString;
+            projectId: z.ZodNullable<z.ZodString>;
+            hasPages: z.ZodBoolean;
+            otherLocationHasPages: z.ZodBoolean;
+        }, z.core.$strip>>;
+        error: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export declare const ProjectKnowledgeStoreSetRequestMessageSchema: z.ZodObject<{
+    type: z.ZodLiteral<"project.knowledge.store.set.request">;
+    requestId: z.ZodString;
+    projectId: z.ZodString;
+    workspaceId: z.ZodOptional<z.ZodString>;
+    location: z.ZodNullable<z.ZodEnum<{
+        repository: "repository";
+        host: "host";
+    }>>;
+    movePages: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+export declare const ProjectKnowledgeStoreSetResponseMessageSchema: z.ZodObject<{
+    type: z.ZodLiteral<"project.knowledge.store.set.response">;
+    payload: z.ZodObject<{
+        requestId: z.ZodString;
+        projectId: z.ZodString;
+        accepted: z.ZodBoolean;
+        store: z.ZodNullable<z.ZodObject<{
+            location: z.ZodEnum<{
+                repository: "repository";
+                host: "host";
+            }>;
+            override: z.ZodNullable<z.ZodEnum<{
+                repository: "repository";
+                host: "host";
+            }>>;
+            hostDefault: z.ZodEnum<{
+                repository: "repository";
+                host: "host";
+            }>;
+            basePath: z.ZodString;
+            projectId: z.ZodNullable<z.ZodString>;
+            hasPages: z.ZodBoolean;
+            otherLocationHasPages: z.ZodBoolean;
+        }, z.core.$strip>>;
+        movedPageCount: z.ZodNumber;
+        error: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type ProjectKnowledgeStoreDescriptor = z.infer<typeof ProjectKnowledgeStoreDescriptorSchema>;
+export type ProjectKnowledgeStoreGetResponseMessage = z.infer<typeof ProjectKnowledgeStoreGetResponseMessageSchema>;
+export type ProjectKnowledgeStoreSetResponseMessage = z.infer<typeof ProjectKnowledgeStoreSetResponseMessageSchema>;
+export type ProjectKnowledgeStoreLocationValue = z.infer<typeof ProjectKnowledgeStoreLocationValueSchema>;
 //# sourceMappingURL=project-knowledge.d.ts.map

package/dist/project-knowledge.js

@@ -15,6 +15,19 @@ export const ProjectKnowledgeKindSchema = z.enum([
     "reference",
 ]);
 export const ProjectKnowledgeStatusSchema = z.enum(["proposed", "confirmed", "superseded"]);
+/**
+ * Where a project keeps its Knowledge store. `repository` is the historical
+ * `.otto/` directory in the working tree; `host` is a directory under the
+ * daemon's `$OTTO_HOME`, so the working tree stays clean. `null` on a project
+ * means "inherit the host default".
+ *
+ * Declared up here rather than beside the store RPCs at the bottom of the file:
+ * `messages.ts` composes it into the project descriptor, and the AOT validator
+ * generator evaluates these modules for real, so a schema referenced by another
+ * must already exist when that reference runs.
+ * COMPAT(projectKnowledgeStoreLocation): added in v0.8.18.
+ */
+export const ProjectKnowledgeStoreLocationValueSchema = z.enum(["repository", "host"]);
 export const ProjectDeliveryStatusSchema = z.enum([
     "charter",
     "in_build",
@@ -61,7 +74,13 @@ export const ProjectKnowledgeRecordSchema = z.object({
         affects: z.array(z.string()).optional(),
     }))
         .optional(),
+    // Relative to the store's path base: the project root for a repository
+    // store, the store directory for a host store. Prefer `absolutePath` when
+    // the client needs a path it can actually open.
     path: z.string().optional(),
+    // COMPAT(projectKnowledgeStoreLocation): added in v0.8.18; the only path a
+    // client can open for a host-local store. Absent from older daemons.
+    absolutePath: z.string().optional(),
 });
 /** Review health, not a persisted project-knowledge finding record. */
 export const ProjectKnowledgeHealthSchema = z.object({
@@ -76,6 +95,9 @@ export const ProjectKnowledgeRootPageSchema = z.object({
     slug: z.string(),
     title: z.string(),
     path: z.string(),
+    // COMPAT(projectKnowledgeStoreLocation): added in v0.8.18. See the same field
+    // on ProjectKnowledgeRecordSchema.
+    absolutePath: z.string().optional(),
     body: z.string(),
 });
 export const ProjectKnowledgeListRequestMessageSchema = z.object({
@@ -226,4 +248,71 @@ export const ProjectKnowledgeDeleteResponseMessageSchema = z.object({
         error: z.string().optional(),
     }),
 });
+// COMPAT(projectKnowledgeStoreLocation): added in v0.8.18, drop the gate when
+// floor >= v0.8.18. Gated by server_info features.projectKnowledgeStoreLocation.
+/** What the daemon resolved for a workspace, and why the client may act on it. */
+export const ProjectKnowledgeStoreDescriptorSchema = z.object({
+    location: ProjectKnowledgeStoreLocationValueSchema,
+    /** The project's own override; null means it is following the host default. */
+    override: ProjectKnowledgeStoreLocationValueSchema.nullable(),
+    /** The host default in force, so the UI can label the inherited choice. */
+    hostDefault: ProjectKnowledgeStoreLocationValueSchema,
+    /** Absolute directory holding `KNOWLEDGE.md` and the `knowledge/` tree. */
+    basePath: z.string(),
+    /** The project this store belongs to, when the workspace has a registered one. */
+    projectId: z.string().nullable(),
+    /** Whether the resolved store holds pages a switch would offer to carry over. */
+    hasPages: z.boolean(),
+    /** Whether the other location already holds pages a switch would land beside. */
+    otherLocationHasPages: z.boolean(),
+});
+/**
+ * Addressed by project or by workspace. Project Settings has a project and no
+ * open workspace; the Knowledge panel has a workspace and reaches its project
+ * through it. Both are optional on the wire and the daemon rejects neither
+ * being set, rather than forcing a caller to invent an id it does not have.
+ */
+export const ProjectKnowledgeStoreGetRequestMessageSchema = z.object({
+    type: z.literal("project.knowledge.store.get.request"),
+    requestId: z.string(),
+    workspaceId: z.string().optional(),
+    projectId: z.string().optional(),
+});
+export const ProjectKnowledgeStoreGetResponseMessageSchema = z.object({
+    type: z.literal("project.knowledge.store.get.response"),
+    payload: z.object({
+        requestId: z.string(),
+        store: ProjectKnowledgeStoreDescriptorSchema.nullable(),
+        error: z.string().nullable(),
+    }),
+});
+export const ProjectKnowledgeStoreSetRequestMessageSchema = z.object({
+    type: z.literal("project.knowledge.store.set.request"),
+    requestId: z.string(),
+    projectId: z.string().min(1),
+    /**
+     * The workspace whose context report should be refreshed. Optional because
+     * the setting is reachable from Project Settings, where no workspace is open.
+     */
+    workspaceId: z.string().optional(),
+    /** Null returns the project to inheriting the host default. */
+    location: ProjectKnowledgeStoreLocationValueSchema.nullable(),
+    /**
+     * Whether to carry the existing pages to the new location. The daemon never
+     * decides this: a silent move stages a deletion in the user's working tree.
+     */
+    movePages: z.boolean().default(false),
+});
+export const ProjectKnowledgeStoreSetResponseMessageSchema = z.object({
+    type: z.literal("project.knowledge.store.set.response"),
+    payload: z.object({
+        requestId: z.string(),
+        projectId: z.string(),
+        accepted: z.boolean(),
+        store: ProjectKnowledgeStoreDescriptorSchema.nullable(),
+        /** Pages actually carried across. Zero when `movePages` was false. */
+        movedPageCount: z.number().int().nonnegative(),
+        error: z.string().nullable(),
+    }),
+});
 //# sourceMappingURL=project-knowledge.js.map

package/dist/provider-config.d.ts

@@ -39,13 +39,77 @@ export declare const ProviderProfileModelSchema: z.ZodObject<{
  * Otto tools natively (see the openai-compat provider) can be scoped to a subset
  * of these groups; omitting the selection means all groups. Kept deliberately
  * coarse - users pick groups, not individual tools.
+ *
+ * The list is APPEND-ONLY, and the wire never carries it as a closed enum (see
+ * normalizeOttoToolGroups): an older peer must be able to parse a newer peer's
+ * selection, dropping names it does not know rather than failing the message.
  */
-export declare const OTTO_TOOL_GROUPS: readonly ["preview", "browser", "web", "agents", "terminals", "schedules", "artifacts", "widgets", "workspace"];
+export declare const OTTO_TOOL_GROUPS: readonly ["preview", "browser", "web", "agents", "terminals", "schedules", "artifacts", "widgets", "workspace", "orchestration", "knowledge", "memory", "permissions", "providers", "tasks", "voice"];
 export type OttoToolGroup = (typeof OTTO_TOOL_GROUPS)[number];
+/**
+ * The taxonomy as it stood before the "agents" split. A stored selection that
+ * uses only these names predates the split and is migrated forward by
+ * expandLegacyOttoToolGroups.
+ */
+export declare const LEGACY_OTTO_TOOL_GROUPS: readonly ["preview", "browser", "web", "agents", "terminals", "schedules", "artifacts", "widgets", "workspace"];
+/**
+ * The categories carved out of the legacy "agents" catch-all. They inherit
+ * "agents" when a pre-split selection is migrated forward, and collapse back
+ * into it when a current selection is projected back for an older peer.
+ */
+export declare const AGENTS_DERIVED_TOOL_GROUPS: readonly ["orchestration", "knowledge", "memory", "permissions", "providers", "tasks", "voice"];
+export declare function isOttoToolGroup(value: unknown): value is OttoToolGroup;
+/**
+ * Post-validation normalization for a stored or wire-carried group selection.
+ * The schemas that carry it are `string[]` on purpose - wire schemas are pure
+ * structural declarations - and this is the one place unknown names are
+ * dropped, so a group added by a newer peer degrades to "not selected" instead
+ * of failing the whole message.
+ *
+ * Returns undefined for a non-array, which every caller reads as "all groups".
+ */
+export declare function normalizeOttoToolGroups(value: unknown): OttoToolGroup[] | undefined;
+/**
+ * Migrate a pre-split selection forward: every category carved out of "agents"
+ * inherits whatever "agents" was set to. Without this, upgrading would silently
+ * strip project knowledge, orchestration, memory, permissions, provider lookups,
+ * tasks and voice from anyone who had ever touched a tool toggle.
+ */
+export declare function expandLegacyOttoToolGroups(groups: readonly OttoToolGroup[]): OttoToolGroup[];
+/**
+ * Project a current selection back into the pre-split taxonomy for the legacy
+ * key we keep writing. "agents" stands in for the whole family, so a peer that
+ * predates the split still grants the tools the user left enabled rather than
+ * withholding them.
+ */
+export declare function toLegacyOttoToolGroups(groups: readonly OttoToolGroup[]): OttoToolGroup[];
+/**
+ * Read a persisted selection that may be in either taxonomy.
+ *
+ * COMPAT(ottoToolGroupsV2): added in v0.8.20. The v2 key wins when present; the
+ * legacy key is migrated forward otherwise. A second key rather than a
+ * heuristic, because the two shapes are genuinely ambiguous - "no new groups
+ * listed" reads as "pre-split config" one way and "the user turned all seven
+ * off" the other, and silently re-enabling tools somebody disabled is the worse
+ * way to be wrong. Drop the legacy branch when the floor is >= v0.8.20.
+ */
+export declare function resolveStoredOttoToolGroups(input: {
+    v2?: unknown;
+    legacy?: unknown;
+}): OttoToolGroup[] | undefined;
+/** Both persisted shapes for one selection: the current key and its legacy projection. */
+export declare function serializeOttoToolGroups(groups: readonly OttoToolGroup[]): {
+    toolGroups: OttoToolGroup[];
+    toolGroupsV2: OttoToolGroup[];
+};
 /**
  * Map a tool name to its group. Covers both Otto's catalog tools and the
- * openai-compat builtin web tools (web_search/web_fetch → "web"). Unknown/
- * lifecycle tools fall under "agents".
+ * openai-compat builtin web tools (web_search/web_fetch → "web").
+ *
+ * "agents" is still the fallback, but it now means what it says - spawning and
+ * steering chats - instead of "everything not otherwise classified". It used to
+ * collect 43 of the catalog's 72 tools, which made it impossible to switch off
+ * one capability without losing six unrelated ones.
  */
 export declare function ottoToolGroupForName(name: string): OttoToolGroup;
 /**
@@ -378,17 +442,8 @@ export declare const ProviderOverrideSchema: z.ZodObject<{
         }, z.core.$strip>>>;
     }, z.core.$strip>>>;
     disallowedTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    ottoToolGroups: z.ZodOptional<z.ZodArray<z.ZodEnum<{
-        preview: "preview";
-        browser: "browser";
-        web: "web";
-        agents: "agents";
-        terminals: "terminals";
-        schedules: "schedules";
-        artifacts: "artifacts";
-        widgets: "widgets";
-        workspace: "workspace";
-    }>>>;
+    ottoToolGroups: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    ottoToolGroupsV2: z.ZodOptional<z.ZodArray<z.ZodString>>;
     mcpServers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodDiscriminatedUnion<[z.ZodObject<{
         type: z.ZodLiteral<"stdio">;
         command: z.ZodString;
@@ -459,17 +514,8 @@ export declare const ProviderOverridesSchema: z.ZodRecord<z.ZodString, z.ZodObje
         }, z.core.$strip>>>;
     }, z.core.$strip>>>;
     disallowedTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    ottoToolGroups: z.ZodOptional<z.ZodArray<z.ZodEnum<{
-        preview: "preview";
-        browser: "browser";
-        web: "web";
-        agents: "agents";
-        terminals: "terminals";
-        schedules: "schedules";
-        artifacts: "artifacts";
-        widgets: "widgets";
-        workspace: "workspace";
-    }>>>;
+    ottoToolGroups: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    ottoToolGroupsV2: z.ZodOptional<z.ZodArray<z.ZodString>>;
     mcpServers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodDiscriminatedUnion<[z.ZodObject<{
         type: z.ZodLiteral<"stdio">;
         command: z.ZodString;