@treeseed/sdk 0.13.0-rc.121 → 0.13.0-rc.122

package/dist/knowledge/contracts.d.ts

@@ -1,5 +1,5 @@
-export declare const BOOK_SCHEMA_VERSION: "treeseed.book/v2";
-export declare const KNOWLEDGE_PAGE_SCHEMA_VERSION: "treeseed.knowledge-page/v1";
+export declare const BOOK_SCHEMA_VERSION: "treeseed.book/v3";
+export declare const KNOWLEDGE_PAGE_SCHEMA_VERSION: "treeseed.knowledge-page/v2";
 export declare const BOOK_COLLECTION_SCHEMA_VERSION: "treeseed.book-collection/v1";
 export declare const KNOWLEDGE_PACK_SCHEMA_VERSION: "treeseed.knowledge-pack/v2";
 export declare const EDITORIAL_CONTEXT_SCHEMA_VERSION: "treeseed.editorial-context/v1";
@@ -13,6 +13,10 @@ export type SanitizedKnowledgeHtml = string & {
 export interface BookDefinition {
     schemaVersion: typeof BOOK_SCHEMA_VERSION;
     id: string;
+    projectId: string;
+    revision: number;
+    sourceDigest?: string;
+    sourcePath?: string;
     slug: string;
     title: string;
     summary: string;
@@ -46,6 +50,8 @@ export interface KnowledgeContextBindings {
 export interface KnowledgePageDefinition {
     schemaVersion: typeof KNOWLEDGE_PAGE_SCHEMA_VERSION;
     id: string;
+    projectId: string;
+    bookRef: import('../agent-capacity/contracts/capacity/assignments/agent-execution.js').ExactEntityReference;
     bookId: string;
     slug: string;
     title: string;
@@ -63,6 +69,7 @@ export interface KnowledgePageDefinition {
     relatedObjectiveIds: string[];
     relatedProposalIds: string[];
     relatedDecisionIds: string[];
+    relatedRefs?: import('../agent-capacity/contracts/capacity/assignments/agent-execution.js').ExactEntityReference[];
     guaranteeIds: string[];
     audiences: KnowledgeAudienceDeclaration;
     context: KnowledgeContextBindings;

package/dist/knowledge/contracts.js

@@ -1,5 +1,5 @@
-const BOOK_SCHEMA_VERSION = "treeseed.book/v2";
-const KNOWLEDGE_PAGE_SCHEMA_VERSION = "treeseed.knowledge-page/v1";
+const BOOK_SCHEMA_VERSION = "treeseed.book/v3";
+const KNOWLEDGE_PAGE_SCHEMA_VERSION = "treeseed.knowledge-page/v2";
 const BOOK_COLLECTION_SCHEMA_VERSION = "treeseed.book-collection/v1";
 const KNOWLEDGE_PACK_SCHEMA_VERSION = "treeseed.knowledge-pack/v2";
 const EDITORIAL_CONTEXT_SCHEMA_VERSION = "treeseed.editorial-context/v1";

package/dist/model-registry/discussion-models.js

@@ -61,7 +61,6 @@ function buildDiscussionModelRegistry(repoRoot) {
     sequence: field("sequence", { filterable: true, sortable: true, comparableAs: "number", contentKeys: ["sequence"], writeContentKey: "sequence" }),
     agent_id: field("agent_id", { aliases: ["agentId"], filterable: true, contentKeys: ["agent_id", "agentId"], writeContentKey: "agent_id" }),
     assignment_id: field("assignment_id", { aliases: ["assignmentId"], filterable: true, contentKeys: ["assignment_id", "assignmentId"], writeContentKey: "assignment_id" }),
-    mode_run_id: field("mode_run_id", { aliases: ["modeRunId"], filterable: true, contentKeys: ["mode_run_id", "modeRunId"], writeContentKey: "mode_run_id" }),
     provider_id: field("provider_id", { aliases: ["providerId"], filterable: true, contentKeys: ["provider_id", "providerId"], writeContentKey: "provider_id" }),
     group_ids: field("group_ids", { aliases: ["groupIds"], filterable: true, comparableAs: "string_array", contentKeys: ["group_ids", "groupIds"], writeContentKey: "groupIds" }),
     occurred_at: field("occurred_at", { aliases: ["occurredAt"], filterable: true, sortable: true, comparableAs: "date", contentKeys: ["occurred_at", "occurredAt"], writeContentKey: "occurred_at" }),

package/dist/operator-contracts/canonical-command-tree.js

@@ -356,7 +356,9 @@ const commandTree = {
       leaf("audit")
     ]),
     branch("workdays", [
-      branch("profiles", [leaf("list"), leaf("show", "read", "profile"), leaf("update", "mutation", "profile", "authority")]),
+      branch("profiles", [leaf("list"), leaf("show", "read", "profile"), addOptions(leaf("update", "mutation", "profile", "authority"), [
+        { name: "--input", description: "YAML or JSON workday policy document.", type: "string", required: true }
+      ])]),
       { ...leaf("plan", "mutation"), nodeType: "leaf", segment: "plan", kind: "mutation", description: "Plan a workday with optional targeted cooperative planning; acting stays decision-governed.", resultSchemaId: "treeseed.command.workdays.plan/v1", options: WORKDAY_PLAN_OPTIONS },
       leaf("start", "mutation", void 0, "authority"),
       leaf("list"),

package/dist/operator-contracts/catalog/agents/agent-team-clone-operations.d.ts

@@ -16,8 +16,8 @@ export declare const AGENT_TEAM_CLONE_OPERATIONS: {
             projectId: string;
             definitions: {
                 path: string;
-                desiredDigest: string;
                 agentClass: string;
+                desiredDigest: string;
                 sourceDigest: string;
             }[];
         }[];
@@ -44,8 +44,8 @@ export declare const AGENT_TEAM_CLONE_OPERATIONS: {
             projectId: string;
             definitions: {
                 path: string;
-                desiredDigest: string;
                 agentClass: string;
+                desiredDigest: string;
                 sourceDigest: string;
             }[];
         }[];

package/dist/operator-contracts/catalog/capability-ontology-operations.d.ts

@@ -20,13 +20,16 @@ export declare function capabilityOntologyOperations(): {
                 mediaTypes?: string[] | undefined;
             }[];
             createdAt: string;
+            title: string;
+            description: string;
+            family: "research" | "coordination" | "data" | "engineering" | "publishing" | "external-work";
+            features: string[];
             outputs: {
                 id: string;
                 version: string;
                 digest: string;
                 mediaTypes?: string[] | undefined;
             }[];
-            description: string;
             configuration: {
                 key: string;
                 description: string;
@@ -34,9 +37,6 @@ export declare function capabilityOntologyOperations(): {
                 requirementSupport: ("required" | "preferred")[];
                 securityCritical?: boolean | undefined;
             }[];
-            family: "research" | "coordination" | "data" | "engineering" | "publishing" | "external-work";
-            title: string;
-            features: string[];
             permissionClasses: string[];
             contextModes: string[];
             interactionModes: string[];
@@ -72,13 +72,16 @@ export declare function capabilityOntologyOperations(): {
             mediaTypes?: string[] | undefined;
         }[];
         createdAt: string;
+        title: string;
+        description: string;
+        family: "research" | "coordination" | "data" | "engineering" | "publishing" | "external-work";
+        features: string[];
         outputs: {
             id: string;
             version: string;
             digest: string;
             mediaTypes?: string[] | undefined;
         }[];
-        description: string;
         configuration: {
             key: string;
             description: string;
@@ -86,9 +89,6 @@ export declare function capabilityOntologyOperations(): {
             requirementSupport: ("required" | "preferred")[];
             securityCritical?: boolean | undefined;
         }[];
-        family: "research" | "coordination" | "data" | "engineering" | "publishing" | "external-work";
-        title: string;
-        features: string[];
         permissionClasses: string[];
         contextModes: string[];
         interactionModes: string[];
@@ -109,11 +109,6 @@ export declare function capabilityOntologyOperations(): {
         digest: string;
         createdAt: string;
         generation: number;
-        signature: {
-            value: string;
-            algorithm: "Ed25519" | "release-catalog";
-            keyId: string;
-        };
         definitions: {
             status: "active" | "revoked" | "deprecated";
             id: string;
@@ -127,13 +122,16 @@ export declare function capabilityOntologyOperations(): {
                 mediaTypes?: string[] | undefined;
             }[];
             createdAt: string;
+            title: string;
+            description: string;
+            family: "research" | "coordination" | "data" | "engineering" | "publishing" | "external-work";
+            features: string[];
             outputs: {
                 id: string;
                 version: string;
                 digest: string;
                 mediaTypes?: string[] | undefined;
             }[];
-            description: string;
             configuration: {
                 key: string;
                 description: string;
@@ -141,9 +139,6 @@ export declare function capabilityOntologyOperations(): {
                 requirementSupport: ("required" | "preferred")[];
                 securityCritical?: boolean | undefined;
             }[];
-            family: "research" | "coordination" | "data" | "engineering" | "publishing" | "external-work";
-            title: string;
-            features: string[];
             permissionClasses: string[];
             contextModes: string[];
             interactionModes: string[];
@@ -159,5 +154,10 @@ export declare function capabilityOntologyOperations(): {
             }[];
             qualificationTier: "signed-attestation" | "automated-suite" | "reviewed-certification";
         }[];
+        signature: {
+            value: string;
+            keyId: string;
+            algorithm: "Ed25519" | "release-catalog";
+        };
     }>;
 };

package/dist/operator-contracts/catalog/commands/command-tree-builders.d.ts

@@ -6,7 +6,7 @@ export declare const local: (handlerId: `local.${string}`) => Execution;
 export declare const field: (target: "path" | "query" | "body", name: string, source: "argument" | "context" | "option", sourceName?: string, required?: boolean, transform?: "identity" | "integer" | "csv") => {
     target: "path" | "query" | "body";
     field: string;
-    source: "argument" | "context" | "option";
+    source: "context" | "argument" | "option";
     name: string;
     required: boolean;
     transform: "integer" | "identity" | "csv";
@@ -15,7 +15,7 @@ export declare const operation: (operationId: `${string}.${string}`, input?: Ret
 export declare const page: () => {
     target: "path" | "query" | "body";
     field: string;
-    source: "argument" | "context" | "option";
+    source: "context" | "argument" | "option";
     name: string;
     required: boolean;
     transform: "integer" | "identity" | "csv";
@@ -23,7 +23,7 @@ export declare const page: () => {
 export declare const aiNode: () => {
     target: "path" | "query" | "body";
     field: string;
-    source: "argument" | "context" | "option";
+    source: "context" | "argument" | "option";
     name: string;
     required: boolean;
     transform: "integer" | "identity" | "csv";
@@ -31,7 +31,7 @@ export declare const aiNode: () => {
 export declare const aiInstance: () => {
     target: "path" | "query" | "body";
     field: string;
-    source: "argument" | "context" | "option";
+    source: "context" | "argument" | "option";
     name: string;
     required: boolean;
     transform: "integer" | "identity" | "csv";

package/dist/operator-contracts/catalog/communication-operations.d.ts

@@ -4,33 +4,20 @@ export declare function communicationOperations(): {
         channel: string;
     }, {}, {
         message: string;
+        parentWorkdayId?: string | undefined;
         timeoutSeconds?: number | undefined;
         recipients?: string[] | undefined;
         proposalId?: string | undefined;
-        parentWorkdayId?: string | undefined;
     }, {
-        status: "failed" | "running" | "partial" | "complete" | "queued";
+        status: "failed" | "running" | "partial" | "queued" | "complete";
         schemaVersion: "treeseed.communication-send-receipt/v4";
         targets: {
             status: "failed" | "running" | "cancelled" | "queued" | "responded" | "abstained";
             projectId: string;
-            invocationId: string | null;
-            completedAt: string | null;
-            requirement: "required" | "optional";
+            updatedAt: string;
             agentSlug: string;
-            capacity: {
-                status: string | null;
-                providerId: string | null;
-                assignmentId: string | null;
-                completedAt: string | null;
-                executionProviderId: string | null;
-                laneId: string | null;
-                lanePurpose: string | null;
-                assignedAt: string | null;
-                claimedAt: string | null;
-                returnedAt: string | null;
-                failedAt: string | null;
-            };
+            requirement: "required" | "optional";
+            depth: number;
             diagnostics: {
                 provider: {
                     providerId: string | null;
@@ -43,15 +30,30 @@ export declare function communicationOperations(): {
                     model: string | null;
                     parameters: Record<string, unknown>;
                 };
-                reason: string | null;
                 usage: Record<string, unknown>[];
-                availability: "available" | "unavailable" | "partial";
+                reason: string | null;
+                availability: "available" | "partial" | "unavailable";
                 identityManifest: Record<string, unknown>;
                 contextManifest: Record<string, unknown>[];
                 timing: Record<string, unknown>;
                 traceEvents: Record<string, unknown>[];
                 fullPayload?: Record<string, unknown> | undefined;
             };
+            completedAt: string | null;
+            invocationId: string | null;
+            capacity: {
+                status: string | null;
+                providerId: string | null;
+                assignmentId: string | null;
+                claimedAt: string | null;
+                executionProviderId: string | null;
+                completedAt: string | null;
+                laneId: string | null;
+                lanePurpose: string | null;
+                assignedAt: string | null;
+                returnedAt: string | null;
+                failedAt: string | null;
+            };
             projectSlug: string;
             definitionRevision: string;
             revisions: {
@@ -61,9 +63,7 @@ export declare function communicationOperations(): {
                 chatProfile: string;
             };
             parentInvocationId: string | null;
-            depth: number;
             requestedAt: string;
-            updatedAt: string;
             failure: {
                 code: string;
                 message: string | null;
@@ -73,50 +73,50 @@ export declare function communicationOperations(): {
         }[];
         teamId: string;
         createdAt: string;
-        sendId: string;
+        updatedAt: string;
         responses: {
             status: "failed" | "cancelled" | "responded" | "abstained";
             projectId: string;
             createdAt: string;
             assignmentId: string | null;
-            invocationId: string;
-            requirement: "required" | "optional";
             agentSlug: string;
+            requirement: "required" | "optional";
+            invocationId: string;
             projectSlug: string;
             messageRef: string;
             markdown: string;
         }[];
-        channel: string;
-        topic: {
-            id: string;
-            slug: string;
-        };
         events: {
             type: "message.posted" | "mention.acknowledged" | "response_lease.accepted" | "agent.progress" | "agent.response" | "agent.abstained" | "agent.failed";
             actor: {
-                kind: "provider" | "agent" | "control-plane" | "user";
+                kind: "provider" | "agent" | "user" | "control-plane";
                 id: string;
                 handle: string | null;
             };
             id: string;
             teamId: string;
             assignmentId: string | null;
+            summary: string;
+            sequence: number;
             topicId: string;
             sendId: string | null;
             invocationId: string | null;
-            sequence: number;
             payload: Record<string, unknown>;
-            summary: string;
             channel: string;
             occurredAt: string;
         }[];
-        updatedAt: string;
+        topic: {
+            id: string;
+            slug: string;
+        };
+        sendId: string;
+        channel: string;
         projectStreams: {
             id: string;
             projectId: string;
+            discussionId: string;
             projectSlug: string;
             messageRef: string;
-            discussionId: string;
         }[];
         replayed: boolean;
     }>;
@@ -126,28 +126,15 @@ export declare function communicationOperations(): {
     }, {
         diagnostics?: "metadata" | "full" | undefined;
     }, undefined, {
-        status: "failed" | "running" | "partial" | "complete" | "queued";
+        status: "failed" | "running" | "partial" | "queued" | "complete";
         schemaVersion: "treeseed.communication-send-receipt/v4";
         targets: {
             status: "failed" | "running" | "cancelled" | "queued" | "responded" | "abstained";
             projectId: string;
-            invocationId: string | null;
-            completedAt: string | null;
-            requirement: "required" | "optional";
+            updatedAt: string;
             agentSlug: string;
-            capacity: {
-                status: string | null;
-                providerId: string | null;
-                assignmentId: string | null;
-                completedAt: string | null;
-                executionProviderId: string | null;
-                laneId: string | null;
-                lanePurpose: string | null;
-                assignedAt: string | null;
-                claimedAt: string | null;
-                returnedAt: string | null;
-                failedAt: string | null;
-            };
+            requirement: "required" | "optional";
+            depth: number;
             diagnostics: {
                 provider: {
                     providerId: string | null;
@@ -160,15 +147,30 @@ export declare function communicationOperations(): {
                     model: string | null;
                     parameters: Record<string, unknown>;
                 };
-                reason: string | null;
                 usage: Record<string, unknown>[];
-                availability: "available" | "unavailable" | "partial";
+                reason: string | null;
+                availability: "available" | "partial" | "unavailable";
                 identityManifest: Record<string, unknown>;
                 contextManifest: Record<string, unknown>[];
                 timing: Record<string, unknown>;
                 traceEvents: Record<string, unknown>[];
                 fullPayload?: Record<string, unknown> | undefined;
             };
+            completedAt: string | null;
+            invocationId: string | null;
+            capacity: {
+                status: string | null;
+                providerId: string | null;
+                assignmentId: string | null;
+                claimedAt: string | null;
+                executionProviderId: string | null;
+                completedAt: string | null;
+                laneId: string | null;
+                lanePurpose: string | null;
+                assignedAt: string | null;
+                returnedAt: string | null;
+                failedAt: string | null;
+            };
             projectSlug: string;
             definitionRevision: string;
             revisions: {
@@ -178,9 +180,7 @@ export declare function communicationOperations(): {
                 chatProfile: string;
             };
             parentInvocationId: string | null;
-            depth: number;
             requestedAt: string;
-            updatedAt: string;
             failure: {
                 code: string;
                 message: string | null;
@@ -190,50 +190,50 @@ export declare function communicationOperations(): {
         }[];
         teamId: string;
         createdAt: string;
-        sendId: string;
+        updatedAt: string;
         responses: {
             status: "failed" | "cancelled" | "responded" | "abstained";
             projectId: string;
             createdAt: string;
             assignmentId: string | null;
-            invocationId: string;
-            requirement: "required" | "optional";
             agentSlug: string;
+            requirement: "required" | "optional";
+            invocationId: string;
             projectSlug: string;
             messageRef: string;
             markdown: string;
         }[];
-        channel: string;
-        topic: {
-            id: string;
-            slug: string;
-        };
         events: {
             type: "message.posted" | "mention.acknowledged" | "response_lease.accepted" | "agent.progress" | "agent.response" | "agent.abstained" | "agent.failed";
             actor: {
-                kind: "provider" | "agent" | "control-plane" | "user";
+                kind: "provider" | "agent" | "user" | "control-plane";
                 id: string;
                 handle: string | null;
             };
             id: string;
             teamId: string;
             assignmentId: string | null;
+            summary: string;
+            sequence: number;
             topicId: string;
             sendId: string | null;
             invocationId: string | null;
-            sequence: number;
             payload: Record<string, unknown>;
-            summary: string;
             channel: string;
             occurredAt: string;
         }[];
-        updatedAt: string;
+        topic: {
+            id: string;
+            slug: string;
+        };
+        sendId: string;
+        channel: string;
         projectStreams: {
             id: string;
             projectId: string;
+            discussionId: string;
             projectSlug: string;
             messageRef: string;
-            discussionId: string;
         }[];
         replayed: boolean;
     }>;
@@ -254,16 +254,16 @@ export declare function communicationOperations(): {
             streams: {
                 id: string;
                 projectId: string;
-                projectSlug: string;
                 discussionId: string;
+                projectSlug: string;
             }[];
             listeners: {
                 status: "active" | "removed";
                 projectId: string;
                 source: "seed" | "operator" | "mention";
+                updatedAt: string;
                 agentSlug: string;
                 projectSlug: string;
-                updatedAt: string;
                 agentHandle: string;
                 subscribedAt: string;
             }[];
@@ -283,16 +283,16 @@ export declare function communicationOperations(): {
         streams: {
             id: string;
             projectId: string;
-            projectSlug: string;
             discussionId: string;
+            projectSlug: string;
         }[];
         listeners: {
             status: "active" | "removed";
             projectId: string;
             source: "seed" | "operator" | "mention";
+            updatedAt: string;
             agentSlug: string;
             projectSlug: string;
-            updatedAt: string;
             agentHandle: string;
             subscribedAt: string;
         }[];
@@ -301,12 +301,30 @@ export declare function communicationOperations(): {
         teamId: string;
         channel: string;
     }, {
+        diagnostics?: "metadata" | "full" | undefined;
         limit?: number | undefined;
         waitSeconds?: number | undefined;
-        diagnostics?: "metadata" | "full" | undefined;
         after?: string | undefined;
     }, undefined, {
-        cursor: string | null;
+        events: {
+            type: "message.posted" | "mention.acknowledged" | "response_lease.accepted" | "agent.progress" | "agent.response" | "agent.abstained" | "agent.failed";
+            actor: {
+                kind: "provider" | "agent" | "user" | "control-plane";
+                id: string;
+                handle: string | null;
+            };
+            id: string;
+            teamId: string;
+            assignmentId: string | null;
+            summary: string;
+            sequence: number;
+            topicId: string;
+            sendId: string | null;
+            invocationId: string | null;
+            payload: Record<string, unknown>;
+            channel: string;
+            occurredAt: string;
+        }[];
         topic: {
             status: "active" | "archived";
             id: string;
@@ -317,39 +335,21 @@ export declare function communicationOperations(): {
             streams: {
                 id: string;
                 projectId: string;
-                projectSlug: string;
                 discussionId: string;
+                projectSlug: string;
             }[];
             listeners: {
                 status: "active" | "removed";
                 projectId: string;
                 source: "seed" | "operator" | "mention";
+                updatedAt: string;
                 agentSlug: string;
                 projectSlug: string;
-                updatedAt: string;
                 agentHandle: string;
                 subscribedAt: string;
             }[];
         };
-        events: {
-            type: "message.posted" | "mention.acknowledged" | "response_lease.accepted" | "agent.progress" | "agent.response" | "agent.abstained" | "agent.failed";
-            actor: {
-                kind: "provider" | "agent" | "control-plane" | "user";
-                id: string;
-                handle: string | null;
-            };
-            id: string;
-            teamId: string;
-            assignmentId: string | null;
-            topicId: string;
-            sendId: string | null;
-            invocationId: string | null;
-            sequence: number;
-            payload: Record<string, unknown>;
-            summary: string;
-            channel: string;
-            occurredAt: string;
-        }[];
+        cursor: string | null;
     }>;
     topicsSubscribe: import("../control-plane-operation.js").ControlPlaneOperationBinding<{
         teamId: string;
@@ -363,9 +363,9 @@ export declare function communicationOperations(): {
             status: "active" | "removed";
             projectId: string;
             source: "seed" | "operator" | "mention";
+            updatedAt: string;
             agentSlug: string;
             projectSlug: string;
-            updatedAt: string;
             agentHandle: string;
             subscribedAt: string;
         };
@@ -382,9 +382,9 @@ export declare function communicationOperations(): {
             status: "active" | "removed";
             projectId: string;
             source: "seed" | "operator" | "mention";
+            updatedAt: string;
             agentSlug: string;
             projectSlug: string;
-            updatedAt: string;
             agentHandle: string;
             subscribedAt: string;
         };
@@ -397,8 +397,8 @@ export declare function providerDiscussionResponseOperation(): import("../contro
     leaseToken: string;
     summary?: string | undefined;
     usage?: Record<string, unknown> | undefined;
-    markdown?: string | undefined;
     outcome?: "responded" | "abstained" | undefined;
+    markdown?: string | undefined;
 }, {
     status: "responded" | "abstained";
     schemaVersion: "treeseed.provider-discussion-response-receipt/v1";
@@ -423,9 +423,9 @@ export declare function providerCommunicationLifecycleOperations(): {
         assignmentId: string;
     }, {}, {
         type: string;
+        summary: string;
         sequence: number;
         payload: Record<string, unknown>;
-        summary: string;
         occurredAt: string;
         runnerId: string;
         leaseToken: string;