@otto-code/protocol 0.8.18 → 0.8.19

package/dist/messages.js

@@ -2,7 +2,7 @@ import { z } from "zod";
 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";
+import { HostingPrAttachmentSchema, HostingIssueAttachmentSchema, HostingSearchRequestSchema, HostingAuthStatusRequestSchema, HostingListRepositoriesRequestSchema, HostingListOwnersRequestSchema, HostingListRepositoriesResponseSchema, HostingListOwnersResponseSchema, HostingAuthStatusResponseSchema, HostingPullRequestThreadSetResolvedRequestSchema, HostingPullRequestThreadSetResolvedResponseSchema, HostingPullRequestCommentSetReactionRequestSchema, HostingPullRequestCommentSetReactionResponseSchema, GitHostingCapabilitiesSchema, GitHostingProviderIdWireSchema, } from "./git-hosting.js";
 import { ProjectKanbanTargetSchema, KanbanProjectTargetSetRequestSchema, KanbanProjectTargetSetResponseSchema, KanbanBoardsListRequestSchema, KanbanBoardsListResponseSchema, KanbanBoardGetRequestSchema, KanbanBoardGetResponseSchema, KanbanCardMoveRequestSchema, KanbanCardMoveResponseSchema, KanbanCardCreateRequestSchema, KanbanCardCreateResponseSchema, KanbanTaskLinkRequestSchema, KanbanTaskLinkResponseSchema, } from "./kanban.js";
 import { WorkspaceArchivePreflightRequestSchema, CheckoutBaseSourceSchema, WorktreeBaseRefSetRequestSchema, WorkspaceArchivePreflightResponseSchema, WorktreeBaseRefSetResponseSchema, } from "./worktree-ops.js";
 import { SuggestedTasksChangedSchema, TasksSuggestedStartRequestMessageSchema, TasksSuggestedStartResponseMessageSchema, TasksSuggestedDismissRequestMessageSchema, TasksSuggestedDismissResponseMessageSchema, } from "./suggested-tasks.js";
@@ -13,8 +13,7 @@ import { QueuedAgentMessagePayloadSchema, AgentQueueRemoveRequestMessageSchema,
 import { FileEolSchema, FileCreateRequestSchema, FileDeleteRequestSchema, FileRenameRequestSchema, FileWatchSubscribeRequestSchema, FileWatchUnsubscribeRequestSchema, FileSearchRequestSchema, FileReplaceRequestSchema, FileCreateResponseSchema, FileDeleteResponseSchema, FileRenameResponseSchema, FileWatchSubscribeResponseSchema, FileWatchUnsubscribeResponseSchema, FileSearchResultEventSchema, FileSearchResponseSchema, FileReplaceResponseSchema, FileWatchEventSchema, } from "./file-operations.js";
 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, ProjectKnowledgeStoreLocationValueSchema, ProjectKnowledgeStoreGetRequestMessageSchema, ProjectKnowledgeStoreGetResponseMessageSchema, ProjectKnowledgeStoreSetRequestMessageSchema, ProjectKnowledgeStoreSetResponseMessageSchema, ProjectKnowledgeDeleteResponseMessageSchema, } from "./project-knowledge.js";
+import { ProjectKnowledgeListRequestMessageSchema, ProjectKnowledgeListResponseMessageSchema, ProjectKnowledgeGetRequestMessageSchema, ProjectKnowledgeGetResponseMessageSchema, ProjectKnowledgeCreateRequestMessageSchema, ProjectKnowledgeCreateResponseMessageSchema, ProjectKnowledgeApplyRequestMessageSchema, ProjectKnowledgeApplyResponseMessageSchema, ProjectKnowledgeStatusRequestMessageSchema, ProjectKnowledgeStatusResponseMessageSchema, ProjectKnowledgeProjectApplyRequestMessageSchema, ProjectKnowledgeProjectApplyResponseMessageSchema, ProjectKnowledgeReferenceApplyRequestMessageSchema, ProjectKnowledgeReferenceApplyResponseMessageSchema, ProjectKnowledgeRootApplyRequestMessageSchema, ProjectKnowledgeRootApplyResponseMessageSchema, ProjectKnowledgeRefineApplyRequestMessageSchema, ProjectKnowledgeRefineApplyResponseMessageSchema, ProjectKnowledgeRefinementProposeRequestMessageSchema, ProjectKnowledgeRefinementProposeResponseMessageSchema, 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";
@@ -3307,9 +3306,6 @@ export const SessionInboundMessageSchema = z.discriminatedUnion("type", [
     KanbanProjectTargetSetRequestSchema,
     ProjectIconSetRequestSchema,
     ProjectRemoveRequestSchema,
-    ProjectLinksListRequestSchema,
-    ProjectLinksSetRequestSchema,
-    ProjectLinksUnsetRequestSchema,
     WorkspaceTitleSetRequestSchema,
     WorkspacePinSetRequestSchema,
     WorkspaceRecoveryInspectRequestSchema,
@@ -3388,6 +3384,8 @@ export const SessionInboundMessageSchema = z.discriminatedUnion("type", [
     ProjectKnowledgeProjectApplyRequestMessageSchema,
     ProjectKnowledgeReferenceApplyRequestMessageSchema,
     ProjectKnowledgeRootApplyRequestMessageSchema,
+    ProjectKnowledgeRefineApplyRequestMessageSchema,
+    ProjectKnowledgeRefinementProposeRequestMessageSchema,
     ProjectKnowledgeDeleteRequestMessageSchema,
     ProjectKnowledgeStoreGetRequestMessageSchema,
     ProjectKnowledgeStoreSetRequestMessageSchema,
@@ -3481,6 +3479,8 @@ export const SessionInboundMessageSchema = z.discriminatedUnion("type", [
     PreviewStopRequestSchema,
     CheckoutPrStatusRequestSchema,
     PullRequestTimelineRequestSchema,
+    HostingPullRequestThreadSetResolvedRequestSchema,
+    HostingPullRequestCommentSetReactionRequestSchema,
     CheckoutSwitchBranchRequestSchema,
     CheckoutRenameBranchRequestSchema,
     StashSaveRequestSchema,
@@ -3773,6 +3773,9 @@ export const ServerInfoStatusPayloadSchema = z
         githubCheckDetails: z.boolean().optional(),
         // COMPAT(forgeCheckDetails): added in v0.1.106, remove githubCheckDetails fallback after 2026-12-28.
         forgeCheckDetails: z.boolean().optional(),
+        // COMPAT(forgeReviewThreads): added in v0.8.15, remove gate after 2027-02-27.
+        // The daemon accepts the provider-neutral discussion mutations.
+        forgeReviewThreads: z.boolean().optional(),
         // COMPAT(forgeSearch): added in v0.1.106, remove github_search fallback after 2026-12-28.
         forgeSearch: z.boolean().optional(),
         // COMPAT(daemonStatusRpc): added in v0.1.76, remove gate after 2026-11-18.
@@ -3967,6 +3970,19 @@ 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(projectKnowledgeRefinement): added in v0.8.19, drop the gate
+        // when floor >= v0.8.19.
+        projectKnowledgeRefinement: z.boolean().optional(),
+        // COMPAT(projectKnowledgeReviewedRefinement): added in v0.8.20, remove
+        // the gate after 2027-02-26. The dedicated reviewed-Knowledge proposal
+        // RPC is not supported by hosts that only expose the original apply RPC.
+        projectKnowledgeReviewedRefinement: z.boolean().optional(),
+        // COMPAT(projectKnowledgeAnchoredRefinement): added in v0.8.21, remove
+        // the gate after 2027-02-27.
+        projectKnowledgeAnchoredRefinement: z.boolean().optional(),
+        // COMPAT(projectKnowledgeTagEditing): added in v0.8.21, remove the
+        // gate after 2027-02-27.
+        projectKnowledgeTagEditing: 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.*
@@ -4098,13 +4114,11 @@ export const ServerInfoStatusPayloadSchema = z
         runsDraftEdit: z.boolean().optional(),
         // COMPAT(orchestrationGraphs): added in v0.6.7, drop the gate when daemon floor >= v0.6.7.
         orchestrationGraphs: z.boolean().optional(),
-        // COMPAT(projectLinks): added in v0.5.6, drop the gate when daemon floor >= v0.5.6.
-        projectLinks: z.boolean().optional(),
         // COMPAT(fileOutsideWorkspace): added in v0.5.8, drop the gate when daemon floor >= v0.5.8.
         // Set when the daemon will serve single-file read/write/watch for paths
         // outside every known workspace (bounded only by OS filesystem
-        // permissions). The client gates this behind an "edit anyway" warning;
-        // an old daemon leaves the flag unset and out-of-project files are not offered.
+        // permissions). An old daemon leaves the flag unset, so the client does
+        // not route external files through this access path.
         fileOutsideWorkspace: z.boolean().optional(),
         // COMPAT(promptSuggestions): added in v0.6.3, drop the gate when daemon floor >= v0.6.3.
         // Set when the daemon emits agent_stream `prompt_suggestion` events (native
@@ -6168,6 +6182,24 @@ const PullRequestTimelineCommentItemSchema = z.object({
     body: z.string().optional().default(""),
     createdAt: z.number().optional().default(0),
     url: z.string().optional().default(""),
+    // Provider-neutral aggregate reaction state. Absent on forges that do not
+    // expose comment reactions and on daemons that predate discussion support.
+    reactions: z
+        .array(z.object({
+        content: z.enum([
+            "THUMBS_UP",
+            "THUMBS_DOWN",
+            "LAUGH",
+            "HOORAY",
+            "CONFUSED",
+            "HEART",
+            "ROCKET",
+            "EYES",
+        ]),
+        count: z.number().int().nonnegative(),
+        viewerHasReacted: z.boolean(),
+    }))
+        .optional(),
     // GitHub review id this inline comment belongs to; lets clients nest review
     // threads under their parent review. Absent on issue comments and on
     // timelines from daemons that predate the field.
@@ -6213,6 +6245,7 @@ export const PullRequestTimelineResponseSchema = z.object({
         cwd: z.string().optional().default(""),
         prNumber: z.number().nullable().optional().default(null),
         items: z.array(PullRequestTimelineItemSchema).optional().default([]),
+        commentReactionsSupported: z.boolean().optional(),
         truncated: z.boolean().optional().default(false),
         error: PullRequestTimelineErrorSchema.nullable().optional().default(null),
         requestId: z.string().optional().default(""),
@@ -7101,10 +7134,6 @@ export const SessionOutboundMessageSchema = z.discriminatedUnion("type", [
     ProjectUpdatedNotificationSchema,
     ProjectIconSetResponseSchema,
     ProjectRemoveResponseSchema,
-    ProjectLinksListResponseSchema,
-    ProjectLinksSetResponseSchema,
-    ProjectLinksUnsetResponseSchema,
-    ProjectLinksChangedSchema,
     WorkspaceTitleSetResponseSchema,
     WorkspacePinSetResponseSchema,
     WorkspaceRecoveryInspectResponseSchema,
@@ -7205,6 +7234,8 @@ export const SessionOutboundMessageSchema = z.discriminatedUnion("type", [
     PreviewStopResponseSchema,
     CheckoutPrStatusResponseSchema,
     PullRequestTimelineResponseSchema,
+    HostingPullRequestThreadSetResolvedResponseSchema,
+    HostingPullRequestCommentSetReactionResponseSchema,
     CheckoutSwitchBranchResponseSchema,
     CheckoutRenameBranchResponseSchema,
     StashSaveResponseSchema,
@@ -7288,6 +7319,8 @@ export const SessionOutboundMessageSchema = z.discriminatedUnion("type", [
     ProjectKnowledgeProjectApplyResponseMessageSchema,
     ProjectKnowledgeReferenceApplyResponseMessageSchema,
     ProjectKnowledgeRootApplyResponseMessageSchema,
+    ProjectKnowledgeRefineApplyResponseMessageSchema,
+    ProjectKnowledgeRefinementProposeResponseMessageSchema,
     ProjectKnowledgeDeleteResponseMessageSchema,
     ProjectKnowledgeStoreGetResponseMessageSchema,
     ProjectKnowledgeStoreSetResponseMessageSchema,
@@ -7452,7 +7485,6 @@ export * from "./context.js";
 export * from "./code-intelligence.js";
 export * from "./git-operations.js";
 export * from "./project-knowledge.js";
-export * from "./project-links.js";
 export * from "./speech.js";
 export * from "./refine.js";
 export * from "./file-operations.js";

package/dist/project-knowledge.d.ts

@@ -132,6 +132,7 @@ export declare const ProjectKnowledgeRootPageSchema: z.ZodObject<{
     path: z.ZodString;
     absolutePath: z.ZodOptional<z.ZodString>;
     body: z.ZodString;
+    bodyDigest: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export declare const ProjectKnowledgeListRequestMessageSchema: z.ZodObject<{
     type: z.ZodLiteral<"project.knowledge.list.request">;
@@ -204,6 +205,7 @@ export declare const ProjectKnowledgeListResponseMessageSchema: z.ZodObject<{
             path: z.ZodString;
             absolutePath: z.ZodOptional<z.ZodString>;
             body: z.ZodString;
+            bodyDigest: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>>;
         findings: z.ZodArray<z.ZodObject<{
             kind: z.ZodEnum<{
@@ -412,6 +414,7 @@ export declare const ProjectKnowledgeApplyRequestMessageSchema: z.ZodObject<{
     title: z.ZodOptional<z.ZodString>;
     statement: z.ZodOptional<z.ZodString>;
     evidence: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
     provenanceText: z.ZodOptional<z.ZodString>;
     provenanceSource: z.ZodOptional<z.ZodString>;
     provenanceAffects: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -736,7 +739,174 @@ export declare const ProjectKnowledgeRootApplyResponseMessageSchema: z.ZodObject
             path: z.ZodString;
             absolutePath: z.ZodOptional<z.ZodString>;
             body: z.ZodString;
+            bodyDigest: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+/**
+ * A reviewed refinement commits an accepted proposal, not an ordinary edit.
+ * Confirmed atomic Knowledge is demoted atomically with its new truth; root
+ * pages use a body digest because they have no review state.
+ */
+export declare const ProjectKnowledgeRefineApplyRequestMessageSchema: z.ZodObject<{
+    type: z.ZodLiteral<"project.knowledge.refine.apply.request">;
+    requestId: z.ZodString;
+    workspaceId: z.ZodString;
+    target: z.ZodEnum<{
+        record: "record";
+        root: "root";
+    }>;
+    id: z.ZodOptional<z.ZodString>;
+    slug: z.ZodOptional<z.ZodString>;
+    statement: z.ZodOptional<z.ZodString>;
+    evidence: z.ZodOptional<z.ZodString>;
+    body: z.ZodOptional<z.ZodString>;
+    expectedUpdatedAt: z.ZodOptional<z.ZodString>;
+    expectedBodyDigest: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const ProjectKnowledgeRefineApplyResponseMessageSchema: z.ZodObject<{
+    type: z.ZodLiteral<"project.knowledge.refine.apply.response">;
+    payload: z.ZodObject<{
+        requestId: z.ZodString;
+        record: z.ZodNullable<z.ZodObject<{
+            id: z.ZodString;
+            kind: z.ZodEnum<{
+                project: "project";
+                reference: "reference";
+                decision: "decision";
+                constraint: "constraint";
+                requirement: "requirement";
+                architecture: "architecture";
+                finding: "finding";
+            }>;
+            title: z.ZodString;
+            statement: z.ZodString;
+            statementDigest: z.ZodOptional<z.ZodString>;
+            evidence: z.ZodOptional<z.ZodString>;
+            tags: z.ZodArray<z.ZodString>;
+            status: z.ZodEnum<{
+                superseded: "superseded";
+                proposed: "proposed";
+                confirmed: "confirmed";
+            }>;
+            deliveryStatus: z.ZodOptional<z.ZodEnum<{
+                reference: "reference";
+                charter: "charter";
+                in_build: "in_build";
+                partial: "partial";
+                blocked: "blocked";
+                complete: "complete";
+                deferred: "deferred";
+                cancelled: "cancelled";
+            }>>;
+            progress: z.ZodOptional<z.ZodObject<{
+                completed: z.ZodNumber;
+                total: z.ZodNumber;
+                unit: z.ZodString;
+            }, z.core.$strip>>;
+            referenceDisposition: z.ZodOptional<z.ZodEnum<{
+                read: "read";
+                unevaluated: "unevaluated";
+                adopted: "adopted";
+                rejected: "rejected";
+                dependency: "dependency";
+            }>>;
+            sourceUrl: z.ZodOptional<z.ZodString>;
+            createdAt: z.ZodString;
+            updatedAt: z.ZodString;
+            provenance: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                text: z.ZodString;
+                recordedAt: z.ZodString;
+                source: z.ZodOptional<z.ZodString>;
+                kind: z.ZodOptional<z.ZodString>;
+                affects: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            }, z.core.$strip>>>;
+            path: z.ZodOptional<z.ZodString>;
+            absolutePath: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        page: z.ZodNullable<z.ZodObject<{
+            slug: z.ZodString;
+            title: z.ZodString;
+            path: z.ZodString;
+            absolutePath: z.ZodOptional<z.ZodString>;
+            body: z.ZodString;
+            bodyDigest: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>;
+        demoted: z.ZodBoolean;
+        error: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+/** An exact source span inside an editable Project Knowledge title or body. */
+export declare const ProjectKnowledgeRefinementAnchorSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"text">;
+    start: z.ZodNumber;
+    end: z.ZodNumber;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"fence">;
+    start: z.ZodNumber;
+    end: z.ZodNumber;
+    language: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>], "kind">;
+/** A temporary source-bound instruction sent to the dedicated Knowledge writer. */
+export declare const ProjectKnowledgeRefinementDirectiveSchema: z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    kind: z.ZodEnum<{
+        replace: "replace";
+        refine: "refine";
+    }>;
+    selectedText: z.ZodOptional<z.ZodString>;
+    beforeContext: z.ZodOptional<z.ZodString>;
+    afterContext: z.ZodOptional<z.ZodString>;
+    anchor: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"text">;
+        start: z.ZodNumber;
+        end: z.ZodNumber;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"fence">;
+        start: z.ZodNumber;
+        end: z.ZodNumber;
+        language: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>], "kind">>;
+    value: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Produces one inert Knowledge proposal. Direct replacements have already been
+ * applied by the caller; this request carries only the remaining refinement
+ * instructions and never writes the store.
+ */
+export declare const ProjectKnowledgeRefinementProposeRequestMessageSchema: z.ZodObject<{
+    type: z.ZodLiteral<"project.knowledge.refinement.propose.request">;
+    requestId: z.ZodString;
+    workspaceId: z.ZodString;
+    content: z.ZodString;
+    directives: z.ZodArray<z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        kind: z.ZodEnum<{
+            replace: "replace";
+            refine: "refine";
+        }>;
+        selectedText: z.ZodOptional<z.ZodString>;
+        beforeContext: z.ZodOptional<z.ZodString>;
+        afterContext: z.ZodOptional<z.ZodString>;
+        anchor: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"text">;
+            start: z.ZodNumber;
+            end: z.ZodNumber;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"fence">;
+            start: z.ZodNumber;
+            end: z.ZodNumber;
+            language: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>], "kind">>;
+        value: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const ProjectKnowledgeRefinementProposeResponseMessageSchema: z.ZodObject<{
+    type: z.ZodLiteral<"project.knowledge.refinement.propose.response">;
+    payload: z.ZodObject<{
+        requestId: z.ZodString;
+        content: z.ZodNullable<z.ZodString>;
+        error: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>;
 }, z.core.$strip>;
 export declare const ProjectKnowledgeDeleteRequestMessageSchema: z.ZodObject<{
@@ -759,10 +929,12 @@ export type ProjectKnowledgeListResponseMessage = z.infer<typeof ProjectKnowledg
 export type ProjectKnowledgeGetResponseMessage = z.infer<typeof ProjectKnowledgeGetResponseMessageSchema>;
 export type ProjectKnowledgeCreateResponseMessage = z.infer<typeof ProjectKnowledgeCreateResponseMessageSchema>;
 export type ProjectKnowledgeApplyResponseMessage = z.infer<typeof ProjectKnowledgeApplyResponseMessageSchema>;
+export type ProjectKnowledgeRefinementProposeResponseMessage = z.infer<typeof ProjectKnowledgeRefinementProposeResponseMessageSchema>;
 export type ProjectKnowledgeStatusResponseMessage = z.infer<typeof ProjectKnowledgeStatusResponseMessageSchema>;
 export type ProjectKnowledgeProjectApplyResponseMessage = z.infer<typeof ProjectKnowledgeProjectApplyResponseMessageSchema>;
 export type ProjectKnowledgeReferenceApplyResponseMessage = z.infer<typeof ProjectKnowledgeReferenceApplyResponseMessageSchema>;
 export type ProjectKnowledgeRootApplyResponseMessage = z.infer<typeof ProjectKnowledgeRootApplyResponseMessageSchema>;
+export type ProjectKnowledgeRefineApplyResponseMessage = z.infer<typeof ProjectKnowledgeRefineApplyResponseMessageSchema>;
 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<{

package/dist/project-knowledge.js

@@ -99,6 +99,8 @@ export const ProjectKnowledgeRootPageSchema = z.object({
     // on ProjectKnowledgeRecordSchema.
     absolutePath: z.string().optional(),
     body: z.string(),
+    /** Conditional-write precondition for a reviewed root-page refinement. */
+    bodyDigest: z.string().optional(),
 });
 export const ProjectKnowledgeListRequestMessageSchema = z.object({
     type: z.literal("project.knowledge.list.request"),
@@ -157,6 +159,9 @@ export const ProjectKnowledgeApplyRequestMessageSchema = z.object({
     title: z.string().max(160).optional(),
     statement: z.string().optional(),
     evidence: z.string().optional(),
+    // COMPAT(projectKnowledgeTagEditing): added in v0.8.21, accepted through
+    // 2027-02-27 for clients before tag editing.
+    tags: z.array(z.string().max(48)).max(32).optional(),
     provenanceText: z.string().optional(),
     provenanceSource: z.string().max(160).optional(),
     provenanceAffects: z.array(z.string()).optional(),
@@ -232,6 +237,78 @@ export const ProjectKnowledgeRootApplyResponseMessageSchema = z.object({
         page: ProjectKnowledgeRootPageSchema.nullable(),
     }),
 });
+/**
+ * A reviewed refinement commits an accepted proposal, not an ordinary edit.
+ * Confirmed atomic Knowledge is demoted atomically with its new truth; root
+ * pages use a body digest because they have no review state.
+ */
+export const ProjectKnowledgeRefineApplyRequestMessageSchema = z.object({
+    type: z.literal("project.knowledge.refine.apply.request"),
+    requestId: z.string(),
+    workspaceId: z.string(),
+    target: z.enum(["record", "root"]),
+    id: z.string().optional(),
+    slug: z.string().optional(),
+    statement: z.string().optional(),
+    // COMPAT(projectKnowledgeEvidenceRefinement): added in v0.8.18, accepted
+    // through 2027-02-27 for clients before multi-field record review.
+    evidence: z.string().optional(),
+    body: z.string().optional(),
+    expectedUpdatedAt: z.string().optional(),
+    expectedBodyDigest: z.string().optional(),
+});
+export const ProjectKnowledgeRefineApplyResponseMessageSchema = z.object({
+    type: z.literal("project.knowledge.refine.apply.response"),
+    payload: z.object({
+        requestId: z.string(),
+        record: ProjectKnowledgeRecordSchema.nullable(),
+        page: ProjectKnowledgeRootPageSchema.nullable(),
+        demoted: z.boolean(),
+        error: z.string().optional(),
+    }),
+});
+/** An exact source span inside an editable Project Knowledge title or body. */
+export const ProjectKnowledgeRefinementAnchorSchema = z.discriminatedUnion("kind", [
+    z.object({ kind: z.literal("text"), start: z.number().int(), end: z.number().int() }),
+    z.object({
+        kind: z.literal("fence"),
+        start: z.number().int(),
+        end: z.number().int(),
+        language: z.string().nullable(),
+    }),
+]);
+/** A temporary source-bound instruction sent to the dedicated Knowledge writer. */
+export const ProjectKnowledgeRefinementDirectiveSchema = z.object({
+    id: z.string().optional(),
+    kind: z.enum(["replace", "refine"]),
+    // COMPAT(projectKnowledgePhraseRefinement): accepted through 2027-02-27 for
+    // clients before source-owned review anchors.
+    selectedText: z.string().optional(),
+    beforeContext: z.string().optional(),
+    afterContext: z.string().optional(),
+    anchor: ProjectKnowledgeRefinementAnchorSchema.optional(),
+    value: z.string(),
+});
+/**
+ * Produces one inert Knowledge proposal. Direct replacements have already been
+ * applied by the caller; this request carries only the remaining refinement
+ * instructions and never writes the store.
+ */
+export const ProjectKnowledgeRefinementProposeRequestMessageSchema = z.object({
+    type: z.literal("project.knowledge.refinement.propose.request"),
+    requestId: z.string(),
+    workspaceId: z.string(),
+    content: z.string(),
+    directives: z.array(ProjectKnowledgeRefinementDirectiveSchema),
+});
+export const ProjectKnowledgeRefinementProposeResponseMessageSchema = z.object({
+    type: z.literal("project.knowledge.refinement.propose.response"),
+    payload: z.object({
+        requestId: z.string(),
+        content: z.string().nullable(),
+        error: z.string().optional(),
+    }),
+});
 export const ProjectKnowledgeDeleteRequestMessageSchema = z.object({
     type: z.literal("project.knowledge.delete.request"),
     requestId: z.string(),

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

@@ -341,6 +341,39 @@ export declare const ScheduleInspectResponseSchema: z.ZodObject<{
                     failed: "failed";
                     succeeded: "succeeded";
                 }>;
+                target: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    type: z.ZodLiteral<"agent">;
+                    agentId: z.ZodGUID;
+                }, z.core.$strip>, z.ZodObject<{
+                    type: z.ZodLiteral<"new-agent">;
+                    config: z.ZodObject<{
+                        provider: z.ZodString;
+                        cwd: z.ZodString;
+                        personality: z.ZodOptional<z.ZodString>;
+                        agentProfile: z.ZodOptional<z.ZodString>;
+                        modeId: z.ZodOptional<z.ZodString>;
+                        model: z.ZodOptional<z.ZodString>;
+                        thinkingOptionId: z.ZodOptional<z.ZodString>;
+                        archiveOnFinish: z.ZodOptional<z.ZodBoolean>;
+                        isolation: z.ZodOptional<z.ZodEnum<{
+                            worktree: "worktree";
+                            local: "local";
+                        }>>;
+                        title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                        providerOptions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
+                        approvalPolicy: z.ZodOptional<z.ZodString>;
+                        sandboxMode: z.ZodOptional<z.ZodString>;
+                        networkAccess: z.ZodOptional<z.ZodBoolean>;
+                        webSearch: z.ZodOptional<z.ZodBoolean>;
+                        extra: z.ZodOptional<z.ZodObject<{
+                            codex: z.ZodOptional<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+                            claude: z.ZodOptional<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+                        }, z.core.$strip>>;
+                        featureValues: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                        systemPrompt: z.ZodOptional<z.ZodString>;
+                        mcpServers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                    }, z.core.$strip>;
+                }, z.core.$strip>], "type">>;
                 agentId: z.ZodNullable<z.ZodGUID>;
                 workspaceId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
                 personalityName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -367,6 +400,39 @@ export declare const ScheduleLogsResponseSchema: z.ZodObject<{
                 failed: "failed";
                 succeeded: "succeeded";
             }>;
+            target: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                type: z.ZodLiteral<"agent">;
+                agentId: z.ZodGUID;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"new-agent">;
+                config: z.ZodObject<{
+                    provider: z.ZodString;
+                    cwd: z.ZodString;
+                    personality: z.ZodOptional<z.ZodString>;
+                    agentProfile: z.ZodOptional<z.ZodString>;
+                    modeId: z.ZodOptional<z.ZodString>;
+                    model: z.ZodOptional<z.ZodString>;
+                    thinkingOptionId: z.ZodOptional<z.ZodString>;
+                    archiveOnFinish: z.ZodOptional<z.ZodBoolean>;
+                    isolation: z.ZodOptional<z.ZodEnum<{
+                        worktree: "worktree";
+                        local: "local";
+                    }>>;
+                    title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    providerOptions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
+                    approvalPolicy: z.ZodOptional<z.ZodString>;
+                    sandboxMode: z.ZodOptional<z.ZodString>;
+                    networkAccess: z.ZodOptional<z.ZodBoolean>;
+                    webSearch: z.ZodOptional<z.ZodBoolean>;
+                    extra: z.ZodOptional<z.ZodObject<{
+                        codex: z.ZodOptional<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+                        claude: z.ZodOptional<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+                    }, z.core.$strip>>;
+                    featureValues: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                    systemPrompt: z.ZodOptional<z.ZodString>;
+                    mcpServers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                }, z.core.$strip>;
+            }, z.core.$strip>], "type">>;
             agentId: z.ZodNullable<z.ZodGUID>;
             workspaceId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             personalityName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -611,6 +677,39 @@ export declare const ScheduleRunOnceResponseSchema: z.ZodObject<{
                     failed: "failed";
                     succeeded: "succeeded";
                 }>;
+                target: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    type: z.ZodLiteral<"agent">;
+                    agentId: z.ZodGUID;
+                }, z.core.$strip>, z.ZodObject<{
+                    type: z.ZodLiteral<"new-agent">;
+                    config: z.ZodObject<{
+                        provider: z.ZodString;
+                        cwd: z.ZodString;
+                        personality: z.ZodOptional<z.ZodString>;
+                        agentProfile: z.ZodOptional<z.ZodString>;
+                        modeId: z.ZodOptional<z.ZodString>;
+                        model: z.ZodOptional<z.ZodString>;
+                        thinkingOptionId: z.ZodOptional<z.ZodString>;
+                        archiveOnFinish: z.ZodOptional<z.ZodBoolean>;
+                        isolation: z.ZodOptional<z.ZodEnum<{
+                            worktree: "worktree";
+                            local: "local";
+                        }>>;
+                        title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                        providerOptions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
+                        approvalPolicy: z.ZodOptional<z.ZodString>;
+                        sandboxMode: z.ZodOptional<z.ZodString>;
+                        networkAccess: z.ZodOptional<z.ZodBoolean>;
+                        webSearch: z.ZodOptional<z.ZodBoolean>;
+                        extra: z.ZodOptional<z.ZodObject<{
+                            codex: z.ZodOptional<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+                            claude: z.ZodOptional<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+                        }, z.core.$strip>>;
+                        featureValues: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                        systemPrompt: z.ZodOptional<z.ZodString>;
+                        mcpServers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                    }, z.core.$strip>;
+                }, z.core.$strip>], "type">>;
                 agentId: z.ZodNullable<z.ZodGUID>;
                 workspaceId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
                 personalityName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -702,6 +801,39 @@ export declare const ScheduleUpdateResponseSchema: z.ZodObject<{
                     failed: "failed";
                     succeeded: "succeeded";
                 }>;
+                target: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    type: z.ZodLiteral<"agent">;
+                    agentId: z.ZodGUID;
+                }, z.core.$strip>, z.ZodObject<{
+                    type: z.ZodLiteral<"new-agent">;
+                    config: z.ZodObject<{
+                        provider: z.ZodString;
+                        cwd: z.ZodString;
+                        personality: z.ZodOptional<z.ZodString>;
+                        agentProfile: z.ZodOptional<z.ZodString>;
+                        modeId: z.ZodOptional<z.ZodString>;
+                        model: z.ZodOptional<z.ZodString>;
+                        thinkingOptionId: z.ZodOptional<z.ZodString>;
+                        archiveOnFinish: z.ZodOptional<z.ZodBoolean>;
+                        isolation: z.ZodOptional<z.ZodEnum<{
+                            worktree: "worktree";
+                            local: "local";
+                        }>>;
+                        title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                        providerOptions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
+                        approvalPolicy: z.ZodOptional<z.ZodString>;
+                        sandboxMode: z.ZodOptional<z.ZodString>;
+                        networkAccess: z.ZodOptional<z.ZodBoolean>;
+                        webSearch: z.ZodOptional<z.ZodBoolean>;
+                        extra: z.ZodOptional<z.ZodObject<{
+                            codex: z.ZodOptional<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+                            claude: z.ZodOptional<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+                        }, z.core.$strip>>;
+                        featureValues: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                        systemPrompt: z.ZodOptional<z.ZodString>;
+                        mcpServers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                    }, z.core.$strip>;
+                }, z.core.$strip>], "type">>;
                 agentId: z.ZodNullable<z.ZodGUID>;
                 workspaceId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
                 personalityName: z.ZodOptional<z.ZodNullable<z.ZodString>>;