@treeseed/sdk 0.13.0-rc.64 → 0.13.0-rc.66

package/dist/model-registry/agent-operational-models.js

@@ -23,7 +23,7 @@ const data = (key, alias = key) => field(key, { aliases: alias === key ? [] : [a
 function buildAgentOperationalModelRegistry(repoRoot) {
   const lifecycle = { id: id(), title: title(), status: field("status", { filterable: true, contentKeys: ["status"], writeContentKey: "status" }), team_id: ref("team_id", "teamId"), project_id: ref("project_id", "projectId"), workday_id: ref("workday_id", "workdayId"), assignment_id: ref("assignment_id", "assignmentId"), updated_at: updated() };
   return {
-    agent_context_query: model({ name: "agent_context_query", aliases: ["agent_context_queries"], collection: "agent-context-queries", entityType: "AgentContextQuery", repoRoot, fields: { id: id(), title: title(), description: data("description"), revision: data("revision"), maturity: data("maturity"), purpose: data("purpose"), query: data("query"), target: data("target"), scope: data("scope"), code_scopes: data("code_scopes", "codeScopes"), relations: refs("relations", "relations"), depth: data("depth"), result_limit: data("result_limit", "resultLimit"), context_budget: data("context_budget", "contextBudget"), token_budget: data("token_budget", "tokenBudget"), format: data("format"), filters: data("filters"), required: data("required") } }),
+    agent_context_query: model({ name: "agent_context_query", aliases: ["agent_context_queries"], collection: "agent-context-queries", entityType: "AgentContextQuery", repoRoot, fields: { id: id(), title: title(), description: data("description"), revision: data("revision"), maturity: data("maturity"), purpose: data("purpose"), query: data("query"), target: data("target"), scope: data("scope"), code_scopes: data("code_scopes", "codeScopes"), relations: refs("relations", "relations"), depth: data("depth"), result_limit: data("result_limit", "resultLimit"), context_budget: data("context_budget", "contextBudget"), token_budget: data("token_budget", "tokenBudget"), format: data("format"), filters: data("filters"), sources: data("sources"), requirement: data("requirement"), priority: data("priority"), minimum_budget: data("minimum_budget", "minimumBudget"), maximum_budget: data("maximum_budget", "maximumBudget"), summarization: data("summarization") } }),
     agent_context_query_set: model({ name: "agent_context_query_set", aliases: ["agent_context_query_sets"], collection: "agent-context-query-sets", entityType: "AgentContextQuerySet", repoRoot, fields: { id: id(), title: title(), description: data("description"), revision: data("revision"), query_refs: refs("query_refs", "queryRefs"), merge_policy: data("merge_policy", "mergePolicy") }, references: [{ field: "query_refs", edgeType: "REFERENCES", targetModels: ["agent_context_query"], multiple: true }] }),
     agent_instruction_template: model({ name: "agent_instruction_template", aliases: ["agent_instruction_templates"], collection: "agent-instruction-templates", entityType: "AgentInstructionTemplate", repoRoot, fields: { id: id(), title: title(), description: data("description"), revision: data("revision"), kind: data("kind"), instructions: data("instructions"), output_skeleton: data("output_skeleton", "outputSkeleton"), variables: refs("variables", "variables"), applies_to_profiles: refs("applies_to_profiles", "appliesToProfiles") } }),
     discussion_topic: model({ name: "discussion_topic", aliases: ["discussion_topics"], collection: "discussion-topics", entityType: "DiscussionTopic", repoRoot, fields: { id: id(), title: title(), description: data("description"), slug: field("slug", { filterable: true, contentKeys: ["slug"], writeContentKey: "slug" }), group_ids: refs("group_ids", "groupIds"), parent_topic_id: ref("parent_topic_id", "parentTopicId"), status: field("status", { filterable: true, contentKeys: ["status"], writeContentKey: "status" }) }, references: [{ field: "parent_topic_id", edgeType: "PARENT_OF", targetModels: ["discussion_topic"] }] }),

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

@@ -80,6 +80,7 @@ const operationBindings = {
   "host bootstrap enroll": local("local.host.bootstrap.enroll"),
   "host reset": local("local.host.reset"),
   "host uninstall": local("local.host.uninstall"),
+  "host initialize": local("local.host.initialize"),
   "dev session start": local("local.dev.session.start"),
   "dev session stop": local("local.dev.session.stop"),
   "dev use": local("local.dev.use"),
@@ -217,6 +218,19 @@ function hostUninstall() {
   value.resultSchemaId = "treeseed.host-uninstall-result/v1";
   return value;
 }
+function hostInitialize() {
+  const value = leaf("initialize", "mutation", void 0, "authority");
+  if (value.nodeType !== "leaf") throw new Error("Host initialize must be a leaf command.");
+  value.description = "Initialize the generic host foundation from an immutable catalog-bound profile.";
+  value.options = [
+    ...value.options ?? [],
+    { name: "--profile", description: "Catalog-bound host initialization profile.", type: "string", required: true },
+    { name: "--confirm", description: "Confirm installation of the reviewed profile plan.", type: "boolean" },
+    { name: "--yes", description: "Confirm non-interactive execution after reviewing the plan.", type: "boolean" }
+  ];
+  value.resultSchemaId = "treeseed.host-initialization-result/v1";
+  return value;
+}
 function hostSecurityInitialize() {
   const value = leaf("initialize", "mutation", void 0, "credential");
   if (value.nodeType !== "leaf") throw new Error("Host security initialization must be a leaf command.");
@@ -295,7 +309,7 @@ function libraryRead(segment, extraArguments = [], extraOptions = []) {
     description: `${segment[0].toUpperCase()}${segment.slice(1)} project library knowledge.`,
     kind: "read",
     arguments: ["project", ...extraArguments].map((name) => ({ name, description: `${name} value.`, required: true })),
-    options: [{ name: "--ref", description: "Exact commit or protected library ref.", type: "string" }, ...extraOptions],
+    options: [{ name: "--ref", description: "Earlier historical revision; omit for the current library.", type: "string" }, ...extraOptions],
     resultSchemaId: `treeseed.command.library.${segment}/v1`,
     execution: local(`local.library.${segment}`)
   };
@@ -369,6 +383,7 @@ const commandTree = {
       developmentCommand("verify", "mutation", void 0, [{ name: "--session", description: "Development session identity.", type: "string" }, { name: "--candidate", description: "Candidate identity.", type: "string" }])
     ]),
     branch("host", [
+      hostInitialize(),
       leaf("status"),
       leaf("doctor"),
       leaf("plan"),

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

@@ -14,6 +14,7 @@ export declare function communicationOperations(): {
             projectId: string;
             invocationId: string | null;
             completedAt: string | null;
+            requirement: "required" | "optional";
             agentSlug: string;
             capacity: {
                 status: string | null;
@@ -57,7 +58,6 @@ export declare function communicationOperations(): {
                 agentDefinition: string;
                 chatProfile: string;
             };
-            requirement: "required" | "optional";
             parentInvocationId: string | null;
             depth: number;
             requestedAt: string;
@@ -78,9 +78,9 @@ export declare function communicationOperations(): {
             createdAt: string;
             assignmentId: string | null;
             invocationId: string;
+            requirement: "required" | "optional";
             agentSlug: string;
             projectSlug: string;
-            requirement: "required" | "optional";
             messageRef: string;
             markdown: string;
         }[];
@@ -131,6 +131,7 @@ export declare function communicationOperations(): {
             projectId: string;
             invocationId: string | null;
             completedAt: string | null;
+            requirement: "required" | "optional";
             agentSlug: string;
             capacity: {
                 status: string | null;
@@ -174,7 +175,6 @@ export declare function communicationOperations(): {
                 agentDefinition: string;
                 chatProfile: string;
             };
-            requirement: "required" | "optional";
             parentInvocationId: string | null;
             depth: number;
             requestedAt: string;
@@ -195,9 +195,9 @@ export declare function communicationOperations(): {
             createdAt: string;
             assignmentId: string | null;
             invocationId: string;
+            requirement: "required" | "optional";
             agentSlug: string;
             projectSlug: string;
-            requirement: "required" | "optional";
             messageRef: string;
             markdown: string;
         }[];

package/dist/operator-contracts/catalog/knowledge-share-operations.d.ts

@@ -0,0 +1,127 @@
+export declare function knowledgeShareOperations(): {
+    shares: {
+        list: import("../control-plane-operation.js").ControlPlaneOperationBinding<{
+            teamId: string;
+        }, {}, undefined, {
+            items: {
+                status: "revoked" | "active" | "expired";
+                schemaVersion: "treeseed.knowledge-share/v1";
+                id: string;
+                createdAt: string;
+                updatedAt: string;
+                targetTeamId: string;
+                projectIds: string[];
+                sourceTeamId: string;
+                revokedAt: string | null;
+                expiresAt?: string | null | undefined;
+                operations?: ("read" | "context" | "query" | "graph")[] | undefined;
+                paths?: string[] | undefined;
+                contentModels?: string[] | undefined;
+            }[];
+        }>;
+        show: import("../control-plane-operation.js").ControlPlaneOperationBinding<{
+            teamId: string;
+            shareId: string;
+        }, {}, undefined, {
+            status: "revoked" | "active" | "expired";
+            schemaVersion: "treeseed.knowledge-share/v1";
+            id: string;
+            createdAt: string;
+            updatedAt: string;
+            targetTeamId: string;
+            projectIds: string[];
+            sourceTeamId: string;
+            revokedAt: string | null;
+            expiresAt?: string | null | undefined;
+            operations?: ("read" | "context" | "query" | "graph")[] | undefined;
+            paths?: string[] | undefined;
+            contentModels?: string[] | undefined;
+        }>;
+        grant: import("../control-plane-operation.js").ControlPlaneOperationBinding<{
+            teamId: string;
+        }, {}, {
+            targetTeamId: string;
+            projectIds: string[];
+            expiresAt?: string | null | undefined;
+            operations?: ("read" | "context" | "query" | "graph")[] | undefined;
+            paths?: string[] | undefined;
+            contentModels?: string[] | undefined;
+        }, {
+            status: "revoked" | "active" | "expired";
+            schemaVersion: "treeseed.knowledge-share/v1";
+            id: string;
+            createdAt: string;
+            updatedAt: string;
+            targetTeamId: string;
+            projectIds: string[];
+            sourceTeamId: string;
+            revokedAt: string | null;
+            expiresAt?: string | null | undefined;
+            operations?: ("read" | "context" | "query" | "graph")[] | undefined;
+            paths?: string[] | undefined;
+            contentModels?: string[] | undefined;
+        }>;
+        revoke: import("../control-plane-operation.js").ControlPlaneOperationBinding<{
+            teamId: string;
+            shareId: string;
+        }, {}, {}, {
+            status: "revoked" | "active" | "expired";
+            schemaVersion: "treeseed.knowledge-share/v1";
+            id: string;
+            createdAt: string;
+            updatedAt: string;
+            targetTeamId: string;
+            projectIds: string[];
+            sourceTeamId: string;
+            revokedAt: string | null;
+            expiresAt?: string | null | undefined;
+            operations?: ("read" | "context" | "query" | "graph")[] | undefined;
+            paths?: string[] | undefined;
+            contentModels?: string[] | undefined;
+        }>;
+    };
+    teamSearch: import("../control-plane-operation.js").ControlPlaneOperationBinding<{
+        teamId: string;
+    }, {}, {
+        request: Record<string, unknown>;
+        projectIds?: string[] | undefined;
+        projectSlugs?: string[] | undefined;
+        sharedSources?: {
+            teamId: string;
+            projectIds?: string[] | undefined;
+        }[] | undefined;
+    }, Record<string, unknown>>;
+    teamQuery: import("../control-plane-operation.js").ControlPlaneOperationBinding<{
+        teamId: string;
+    }, {}, {
+        request: Record<string, unknown>;
+        projectIds?: string[] | undefined;
+        projectSlugs?: string[] | undefined;
+        sharedSources?: {
+            teamId: string;
+            projectIds?: string[] | undefined;
+        }[] | undefined;
+    }, Record<string, unknown>>;
+    teamContext: import("../control-plane-operation.js").ControlPlaneOperationBinding<{
+        teamId: string;
+    }, {}, {
+        request: Record<string, unknown>;
+        projectIds?: string[] | undefined;
+        projectSlugs?: string[] | undefined;
+        sharedSources?: {
+            teamId: string;
+            projectIds?: string[] | undefined;
+        }[] | undefined;
+    }, Record<string, unknown>>;
+    teamGraph: import("../control-plane-operation.js").ControlPlaneOperationBinding<{
+        teamId: string;
+    }, {}, {
+        request: Record<string, unknown>;
+        projectIds?: string[] | undefined;
+        projectSlugs?: string[] | undefined;
+        sharedSources?: {
+            teamId: string;
+            projectIds?: string[] | undefined;
+        }[] | undefined;
+    }, Record<string, unknown>>;
+};

package/dist/operator-contracts/catalog/knowledge-share-operations.js

@@ -0,0 +1,25 @@
+import { z } from "zod";
+import { defineOperation as define } from "../operation-builder.js";
+import { knowledgeShareGrantInputSchema, knowledgeShareSchema, teamKnowledgeRequestSchema } from "../knowledge/contracts.js";
+const none = z.undefined(), empty = z.object({}).strict(), teamPath = z.object({ teamId: z.string().min(1) }).strict();
+const sharePath = z.object({ teamId: z.string().min(1), shareId: z.string().min(1) }).strict();
+const parameters = (operationId) => `treeseed.${operationId}.parameters/v1`;
+const readDescriptor = (operationId, path) => ({ operationId, description: `Read ${operationId}.`, rest: { method: "GET", path }, parameters: parameters(operationId), capability: "knowledge.read", authentication: "oauth", oauthScopes: ["treeseed:read"], kind: "read", riskClass: "ordinary", confirmation: "never", surfaces: ["rest", "cli", "mcp_tool"], cacheScope: "principal", pagination: "none" });
+const execute = (operationId, path) => define({ operationId, description: `Execute ${operationId} across authorized team knowledge.`, rest: { method: "POST", path }, parameters: parameters(operationId), capability: "knowledge.read", authentication: "oauth", oauthScopes: ["treeseed:read"], kind: "read", riskClass: "ordinary", confirmation: "never", surfaces: ["rest", "mcp_tool"], cacheScope: "none", pagination: "none" }, { path: teamPath, query: empty, body: teamKnowledgeRequestSchema, output: z.record(z.unknown()) });
+function knowledgeShareOperations() {
+  return {
+    shares: {
+      list: define(readDescriptor("knowledge.shares.list", "/v1/teams/{teamId}/knowledge/shares"), { path: teamPath, query: empty, body: none, output: z.object({ items: z.array(knowledgeShareSchema) }).strict() }),
+      show: define(readDescriptor("knowledge.shares.show", "/v1/teams/{teamId}/knowledge/shares/{shareId}"), { path: sharePath, query: empty, body: none, output: knowledgeShareSchema }),
+      grant: define({ operationId: "knowledge.shares.grant", description: "Grant bounded read-only knowledge access to another team.", rest: { method: "POST", path: "/v1/teams/{teamId}/knowledge/shares" }, parameters: parameters("knowledge.shares.grant"), capability: "knowledge.share", authentication: "oauth", oauthScopes: ["treeseed:projects:write"], kind: "mutation", riskClass: "authority", confirmation: "input_required", surfaces: ["rest", "cli", "mcp_tool"], cacheScope: "none", pagination: "none" }, { path: teamPath, query: empty, body: knowledgeShareGrantInputSchema, output: knowledgeShareSchema }),
+      revoke: define({ operationId: "knowledge.shares.revoke", description: "Revoke a cross-team knowledge share.", rest: { method: "DELETE", path: "/v1/teams/{teamId}/knowledge/shares/{shareId}" }, parameters: parameters("knowledge.shares.revoke"), capability: "knowledge.share", authentication: "oauth", oauthScopes: ["treeseed:projects:write"], kind: "mutation", riskClass: "authority", confirmation: "input_required", surfaces: ["rest", "cli", "mcp_tool"], cacheScope: "none", pagination: "none" }, { path: sharePath, query: empty, body: empty, output: knowledgeShareSchema })
+    },
+    teamSearch: execute("knowledge.team.search", "/v1/teams/{teamId}/knowledge/search"),
+    teamQuery: execute("knowledge.team.query", "/v1/teams/{teamId}/knowledge/query"),
+    teamContext: execute("knowledge.team.context", "/v1/teams/{teamId}/knowledge/context"),
+    teamGraph: execute("knowledge.team.graph", "/v1/teams/{teamId}/knowledge/graph")
+  };
+}
+export {
+  knowledgeShareOperations
+};

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

@@ -324,6 +324,7 @@ export declare const communicationTargetSchema: z.ZodObject<{
     projectId: string;
     invocationId: string | null;
     completedAt: string | null;
+    requirement: "required" | "optional";
     agentSlug: string;
     capacity: {
         status: string | null;
@@ -367,7 +368,6 @@ export declare const communicationTargetSchema: z.ZodObject<{
         agentDefinition: string;
         chatProfile: string;
     };
-    requirement: "required" | "optional";
     parentInvocationId: string | null;
     depth: number;
     requestedAt: string;
@@ -383,6 +383,7 @@ export declare const communicationTargetSchema: z.ZodObject<{
     projectId: string;
     invocationId: string | null;
     completedAt: string | null;
+    requirement: "required" | "optional";
     agentSlug: string;
     capacity: {
         status: string | null;
@@ -426,7 +427,6 @@ export declare const communicationTargetSchema: z.ZodObject<{
         agentDefinition: string;
         chatProfile: string;
     };
-    requirement: "required" | "optional";
     parentInvocationId: string | null;
     depth: number;
     requestedAt: string;
@@ -456,9 +456,9 @@ export declare const communicationResponseSchema: z.ZodObject<{
     createdAt: string;
     assignmentId: string | null;
     invocationId: string;
+    requirement: "required" | "optional";
     agentSlug: string;
     projectSlug: string;
-    requirement: "required" | "optional";
     messageRef: string;
     markdown: string;
 }, {
@@ -467,9 +467,9 @@ export declare const communicationResponseSchema: z.ZodObject<{
     createdAt: string;
     assignmentId: string | null;
     invocationId: string;
+    requirement: "required" | "optional";
     agentSlug: string;
     projectSlug: string;
-    requirement: "required" | "optional";
     messageRef: string;
     markdown: string;
 }>;
@@ -669,6 +669,7 @@ export declare const communicationSendReceiptSchema: z.ZodObject<{
         projectId: string;
         invocationId: string | null;
         completedAt: string | null;
+        requirement: "required" | "optional";
         agentSlug: string;
         capacity: {
             status: string | null;
@@ -712,7 +713,6 @@ export declare const communicationSendReceiptSchema: z.ZodObject<{
             agentDefinition: string;
             chatProfile: string;
         };
-        requirement: "required" | "optional";
         parentInvocationId: string | null;
         depth: number;
         requestedAt: string;
@@ -728,6 +728,7 @@ export declare const communicationSendReceiptSchema: z.ZodObject<{
         projectId: string;
         invocationId: string | null;
         completedAt: string | null;
+        requirement: "required" | "optional";
         agentSlug: string;
         capacity: {
             status: string | null;
@@ -771,7 +772,6 @@ export declare const communicationSendReceiptSchema: z.ZodObject<{
             agentDefinition: string;
             chatProfile: string;
         };
-        requirement: "required" | "optional";
         parentInvocationId: string | null;
         depth: number;
         requestedAt: string;
@@ -801,9 +801,9 @@ export declare const communicationSendReceiptSchema: z.ZodObject<{
         createdAt: string;
         assignmentId: string | null;
         invocationId: string;
+        requirement: "required" | "optional";
         agentSlug: string;
         projectSlug: string;
-        requirement: "required" | "optional";
         messageRef: string;
         markdown: string;
     }, {
@@ -812,9 +812,9 @@ export declare const communicationSendReceiptSchema: z.ZodObject<{
         createdAt: string;
         assignmentId: string | null;
         invocationId: string;
+        requirement: "required" | "optional";
         agentSlug: string;
         projectSlug: string;
-        requirement: "required" | "optional";
         messageRef: string;
         markdown: string;
     }>, "many">;
@@ -892,6 +892,7 @@ export declare const communicationSendReceiptSchema: z.ZodObject<{
         projectId: string;
         invocationId: string | null;
         completedAt: string | null;
+        requirement: "required" | "optional";
         agentSlug: string;
         capacity: {
             status: string | null;
@@ -935,7 +936,6 @@ export declare const communicationSendReceiptSchema: z.ZodObject<{
             agentDefinition: string;
             chatProfile: string;
         };
-        requirement: "required" | "optional";
         parentInvocationId: string | null;
         depth: number;
         requestedAt: string;
@@ -956,9 +956,9 @@ export declare const communicationSendReceiptSchema: z.ZodObject<{
         createdAt: string;
         assignmentId: string | null;
         invocationId: string;
+        requirement: "required" | "optional";
         agentSlug: string;
         projectSlug: string;
-        requirement: "required" | "optional";
         messageRef: string;
         markdown: string;
     }[];
@@ -1003,6 +1003,7 @@ export declare const communicationSendReceiptSchema: z.ZodObject<{
         projectId: string;
         invocationId: string | null;
         completedAt: string | null;
+        requirement: "required" | "optional";
         agentSlug: string;
         capacity: {
             status: string | null;
@@ -1046,7 +1047,6 @@ export declare const communicationSendReceiptSchema: z.ZodObject<{
             agentDefinition: string;
             chatProfile: string;
         };
-        requirement: "required" | "optional";
         parentInvocationId: string | null;
         depth: number;
         requestedAt: string;
@@ -1067,9 +1067,9 @@ export declare const communicationSendReceiptSchema: z.ZodObject<{
         createdAt: string;
         assignmentId: string | null;
         invocationId: string;
+        requirement: "required" | "optional";
         agentSlug: string;
         projectSlug: string;
-        requirement: "required" | "optional";
         messageRef: string;
         markdown: string;
     }[];

package/dist/operator-contracts/control-plane-operations.d.ts

@@ -645,6 +645,131 @@ export declare const CONTROL_PLANE_OPERATIONS: {
         readonly publishReview: import("./control-plane-operation.js").ControlPlaneOperationBinding<{
             reviewId: string;
         }, {}, Record<string, unknown> | undefined, Record<string, unknown>>;
+        readonly shares: {
+            list: import("./control-plane-operation.js").ControlPlaneOperationBinding<{
+                teamId: string;
+            }, {}, undefined, {
+                items: {
+                    status: "revoked" | "active" | "expired";
+                    schemaVersion: "treeseed.knowledge-share/v1";
+                    id: string;
+                    createdAt: string;
+                    updatedAt: string;
+                    targetTeamId: string;
+                    projectIds: string[];
+                    sourceTeamId: string;
+                    revokedAt: string | null;
+                    expiresAt?: string | null | undefined;
+                    operations?: ("read" | "context" | "query" | "graph")[] | undefined;
+                    paths?: string[] | undefined;
+                    contentModels?: string[] | undefined;
+                }[];
+            }>;
+            show: import("./control-plane-operation.js").ControlPlaneOperationBinding<{
+                teamId: string;
+                shareId: string;
+            }, {}, undefined, {
+                status: "revoked" | "active" | "expired";
+                schemaVersion: "treeseed.knowledge-share/v1";
+                id: string;
+                createdAt: string;
+                updatedAt: string;
+                targetTeamId: string;
+                projectIds: string[];
+                sourceTeamId: string;
+                revokedAt: string | null;
+                expiresAt?: string | null | undefined;
+                operations?: ("read" | "context" | "query" | "graph")[] | undefined;
+                paths?: string[] | undefined;
+                contentModels?: string[] | undefined;
+            }>;
+            grant: import("./control-plane-operation.js").ControlPlaneOperationBinding<{
+                teamId: string;
+            }, {}, {
+                targetTeamId: string;
+                projectIds: string[];
+                expiresAt?: string | null | undefined;
+                operations?: ("read" | "context" | "query" | "graph")[] | undefined;
+                paths?: string[] | undefined;
+                contentModels?: string[] | undefined;
+            }, {
+                status: "revoked" | "active" | "expired";
+                schemaVersion: "treeseed.knowledge-share/v1";
+                id: string;
+                createdAt: string;
+                updatedAt: string;
+                targetTeamId: string;
+                projectIds: string[];
+                sourceTeamId: string;
+                revokedAt: string | null;
+                expiresAt?: string | null | undefined;
+                operations?: ("read" | "context" | "query" | "graph")[] | undefined;
+                paths?: string[] | undefined;
+                contentModels?: string[] | undefined;
+            }>;
+            revoke: import("./control-plane-operation.js").ControlPlaneOperationBinding<{
+                teamId: string;
+                shareId: string;
+            }, {}, {}, {
+                status: "revoked" | "active" | "expired";
+                schemaVersion: "treeseed.knowledge-share/v1";
+                id: string;
+                createdAt: string;
+                updatedAt: string;
+                targetTeamId: string;
+                projectIds: string[];
+                sourceTeamId: string;
+                revokedAt: string | null;
+                expiresAt?: string | null | undefined;
+                operations?: ("read" | "context" | "query" | "graph")[] | undefined;
+                paths?: string[] | undefined;
+                contentModels?: string[] | undefined;
+            }>;
+        };
+        readonly teamSearch: import("./control-plane-operation.js").ControlPlaneOperationBinding<{
+            teamId: string;
+        }, {}, {
+            request: Record<string, unknown>;
+            projectIds?: string[] | undefined;
+            projectSlugs?: string[] | undefined;
+            sharedSources?: {
+                teamId: string;
+                projectIds?: string[] | undefined;
+            }[] | undefined;
+        }, Record<string, unknown>>;
+        readonly teamQuery: import("./control-plane-operation.js").ControlPlaneOperationBinding<{
+            teamId: string;
+        }, {}, {
+            request: Record<string, unknown>;
+            projectIds?: string[] | undefined;
+            projectSlugs?: string[] | undefined;
+            sharedSources?: {
+                teamId: string;
+                projectIds?: string[] | undefined;
+            }[] | undefined;
+        }, Record<string, unknown>>;
+        readonly teamContext: import("./control-plane-operation.js").ControlPlaneOperationBinding<{
+            teamId: string;
+        }, {}, {
+            request: Record<string, unknown>;
+            projectIds?: string[] | undefined;
+            projectSlugs?: string[] | undefined;
+            sharedSources?: {
+                teamId: string;
+                projectIds?: string[] | undefined;
+            }[] | undefined;
+        }, Record<string, unknown>>;
+        readonly teamGraph: import("./control-plane-operation.js").ControlPlaneOperationBinding<{
+            teamId: string;
+        }, {}, {
+            request: Record<string, unknown>;
+            projectIds?: string[] | undefined;
+            projectSlugs?: string[] | undefined;
+            sharedSources?: {
+                teamId: string;
+                projectIds?: string[] | undefined;
+            }[] | undefined;
+        }, Record<string, unknown>>;
     };
     readonly governance: {
         readonly proposals: import("./control-plane-operation.js").ControlPlaneOperationBinding<{
@@ -933,6 +1058,7 @@ export declare const CONTROL_PLANE_OPERATIONS: {
                 projectId: string;
                 invocationId: string | null;
                 completedAt: string | null;
+                requirement: "required" | "optional";
                 agentSlug: string;
                 capacity: {
                     status: string | null;
@@ -976,7 +1102,6 @@ export declare const CONTROL_PLANE_OPERATIONS: {
                     agentDefinition: string;
                     chatProfile: string;
                 };
-                requirement: "required" | "optional";
                 parentInvocationId: string | null;
                 depth: number;
                 requestedAt: string;
@@ -997,9 +1122,9 @@ export declare const CONTROL_PLANE_OPERATIONS: {
                 createdAt: string;
                 assignmentId: string | null;
                 invocationId: string;
+                requirement: "required" | "optional";
                 agentSlug: string;
                 projectSlug: string;
-                requirement: "required" | "optional";
                 messageRef: string;
                 markdown: string;
             }[];
@@ -1050,6 +1175,7 @@ export declare const CONTROL_PLANE_OPERATIONS: {
                 projectId: string;
                 invocationId: string | null;
                 completedAt: string | null;
+                requirement: "required" | "optional";
                 agentSlug: string;
                 capacity: {
                     status: string | null;
@@ -1093,7 +1219,6 @@ export declare const CONTROL_PLANE_OPERATIONS: {
                     agentDefinition: string;
                     chatProfile: string;
                 };
-                requirement: "required" | "optional";
                 parentInvocationId: string | null;
                 depth: number;
                 requestedAt: string;
@@ -1114,9 +1239,9 @@ export declare const CONTROL_PLANE_OPERATIONS: {
                 createdAt: string;
                 assignmentId: string | null;
                 invocationId: string;
+                requirement: "required" | "optional";
                 agentSlug: string;
                 projectSlug: string;
-                requirement: "required" | "optional";
                 messageRef: string;
                 markdown: string;
             }[];

package/dist/operator-contracts/control-plane-operations.js

@@ -5,6 +5,7 @@ import { inboxOperations } from "./catalog/inbox-operations.js";
 import { adminAccountOperations, adminTeamOperations } from "./catalog/admin-account-team-operations.js";
 import { TREEAI_CONTROL_PLANE_OPERATIONS } from "./catalog/treeai-operations.js";
 import { capabilityOntologyOperations } from "./catalog/capability-ontology-operations.js";
+import { knowledgeShareOperations } from "./catalog/knowledge-share-operations.js";
 import { buildControlPlaneCatalog, flattenControlPlaneOperations } from "./catalog/control-plane-catalog.js";
 const empty = z.object({}).strict();
 const none = z.undefined();
@@ -187,6 +188,7 @@ const CONTROL_PLANE_OPERATIONS = {
     updateStatus: resource("discussions.status.update", "POST", "/v1/discussions/{discussionId}/status", { discussionId: z.string().min(1) }, { capability: "discussions.write", scopes: ["treeseed:knowledge:write"], concurrency: true })
   },
   knowledge: {
+    ...knowledgeShareOperations(),
     library: resource("knowledge.library.list", "GET", "/v1/knowledge/library", {}, { capability: "knowledge.read", surfaces: ["rest", "mcp_tool", "mcp_resource"], pagination: "cursor" }),
     reader: resource("knowledge.reader.show", "GET", "/v1/knowledge/reader", {}, { capability: "knowledge.read", surfaces: ["rest", "mcp_resource"] }),
     context: resource("knowledge.context.show", "GET", "/v1/knowledge/context", {}, { capability: "knowledge.read", surfaces: ["rest", "mcp_tool"] }),

package/dist/operator-contracts/index.d.ts

@@ -9,5 +9,6 @@ export * from './oauth.js';
 export * from './communication/contracts.js';
 export * from './communication/addressing.js';
 export * from './inbox/contracts.js';
+export * from './knowledge/contracts.js';
 export * from '../capacity-provider/capability-ontology.js';
 export * from './seed/seed-bundle.js';

package/dist/operator-contracts/index.js

@@ -9,5 +9,6 @@ export * from "./oauth.js";
 export * from "./communication/contracts.js";
 export * from "./communication/addressing.js";
 export * from "./inbox/contracts.js";
+export * from "./knowledge/contracts.js";
 export * from "../capacity-provider/capability-ontology.js";
 export * from "./seed/seed-bundle.js";