@treeseed/sdk 0.13.0-rc.65 → 0.13.0-rc.67

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<{

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";

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

@@ -0,0 +1,130 @@
+import { z } from 'zod';
+export declare const knowledgeShareOperationSchema: z.ZodEnum<["read", "query", "context", "graph"]>;
+export declare const knowledgeShareGrantInputSchema: z.ZodObject<{
+    targetTeamId: z.ZodString;
+    projectIds: z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], string[]>;
+    contentModels: z.ZodDefault<z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], string[]>>;
+    paths: z.ZodDefault<z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], string[]>>;
+    operations: z.ZodDefault<z.ZodEffects<z.ZodArray<z.ZodEnum<["read", "query", "context", "graph"]>, "many">, ("read" | "context" | "query" | "graph")[], ("read" | "context" | "query" | "graph")[]>>;
+    expiresAt: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+}, "strict", z.ZodTypeAny, {
+    expiresAt: string | null;
+    operations: ("read" | "context" | "query" | "graph")[];
+    paths: string[];
+    targetTeamId: string;
+    projectIds: string[];
+    contentModels: string[];
+}, {
+    targetTeamId: string;
+    projectIds: string[];
+    expiresAt?: string | null | undefined;
+    operations?: ("read" | "context" | "query" | "graph")[] | undefined;
+    paths?: string[] | undefined;
+    contentModels?: string[] | undefined;
+}>;
+export declare const knowledgeShareSchema: z.ZodEffects<z.ZodObject<{
+    targetTeamId: z.ZodString;
+    projectIds: z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], string[]>;
+    contentModels: z.ZodDefault<z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], string[]>>;
+    paths: z.ZodDefault<z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], string[]>>;
+    operations: z.ZodDefault<z.ZodEffects<z.ZodArray<z.ZodEnum<["read", "query", "context", "graph"]>, "many">, ("read" | "context" | "query" | "graph")[], ("read" | "context" | "query" | "graph")[]>>;
+    expiresAt: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+} & {
+    schemaVersion: z.ZodLiteral<"treeseed.knowledge-share/v1">;
+    id: z.ZodString;
+    sourceTeamId: z.ZodString;
+    status: z.ZodEnum<["active", "revoked", "expired"]>;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+    revokedAt: z.ZodNullable<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    status: "revoked" | "active" | "expired";
+    schemaVersion: "treeseed.knowledge-share/v1";
+    id: string;
+    createdAt: string;
+    expiresAt: string | null;
+    operations: ("read" | "context" | "query" | "graph")[];
+    paths: string[];
+    updatedAt: string;
+    targetTeamId: string;
+    projectIds: string[];
+    contentModels: string[];
+    sourceTeamId: string;
+    revokedAt: string | null;
+}, {
+    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;
+}>, {
+    status: "revoked" | "active" | "expired";
+    schemaVersion: "treeseed.knowledge-share/v1";
+    id: string;
+    createdAt: string;
+    expiresAt: string | null;
+    operations: ("read" | "context" | "query" | "graph")[];
+    paths: string[];
+    updatedAt: string;
+    targetTeamId: string;
+    projectIds: string[];
+    contentModels: string[];
+    sourceTeamId: string;
+    revokedAt: string | null;
+}, {
+    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;
+}>;
+export declare const teamKnowledgeRequestSchema: z.ZodObject<{
+    projectIds: z.ZodDefault<z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], string[]>>;
+    projectSlugs: z.ZodDefault<z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], string[]>>;
+    sharedSources: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        teamId: z.ZodString;
+        projectIds: z.ZodDefault<z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], string[]>>;
+    }, "strict", z.ZodTypeAny, {
+        teamId: string;
+        projectIds: string[];
+    }, {
+        teamId: string;
+        projectIds?: string[] | undefined;
+    }>, "many">>;
+    request: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, "strict", z.ZodTypeAny, {
+    request: Record<string, unknown>;
+    projectIds: string[];
+    projectSlugs: string[];
+    sharedSources: {
+        teamId: string;
+        projectIds: string[];
+    }[];
+}, {
+    request: Record<string, unknown>;
+    projectIds?: string[] | undefined;
+    projectSlugs?: string[] | undefined;
+    sharedSources?: {
+        teamId: string;
+        projectIds?: string[] | undefined;
+    }[] | undefined;
+}>;
+export type KnowledgeShare = z.infer<typeof knowledgeShareSchema>;
+export type KnowledgeShareGrantInput = z.infer<typeof knowledgeShareGrantInputSchema>;
+export type TeamKnowledgeRequest = z.infer<typeof teamKnowledgeRequestSchema>;

package/dist/operator-contracts/knowledge/contracts.js

@@ -0,0 +1,39 @@
+import { z } from "zod";
+const nonEmpty = z.string().trim().min(1);
+const uniqueStrings = (minimum = 0) => z.array(nonEmpty).min(minimum).superRefine((values, context) => {
+  if (new Set(values).size !== values.length) context.addIssue({ code: z.ZodIssueCode.custom, message: "Values must be unique." });
+});
+const knowledgeShareOperationSchema = z.enum(["read", "query", "context", "graph"]);
+const knowledgeShareGrantInputSchema = z.object({
+  targetTeamId: nonEmpty,
+  projectIds: uniqueStrings(1),
+  contentModels: uniqueStrings().default([]),
+  paths: uniqueStrings(1).default(["**"]),
+  operations: z.array(knowledgeShareOperationSchema).min(1).superRefine((values, context) => {
+    if (new Set(values).size !== values.length) context.addIssue({ code: z.ZodIssueCode.custom, message: "Operations must be unique." });
+  }).default(["read", "query", "context", "graph"]),
+  expiresAt: z.string().datetime({ offset: true }).nullable().default(null)
+}).strict();
+const knowledgeShareSchema = knowledgeShareGrantInputSchema.extend({
+  schemaVersion: z.literal("treeseed.knowledge-share/v1"),
+  id: nonEmpty,
+  sourceTeamId: nonEmpty,
+  status: z.enum(["active", "revoked", "expired"]),
+  createdAt: z.string().datetime({ offset: true }),
+  updatedAt: z.string().datetime({ offset: true }),
+  revokedAt: z.string().datetime({ offset: true }).nullable()
+}).strict().superRefine((value, context) => {
+  if (value.sourceTeamId === value.targetTeamId) context.addIssue({ code: z.ZodIssueCode.custom, path: ["targetTeamId"], message: "Knowledge shares are only for another team." });
+});
+const teamKnowledgeRequestSchema = z.object({
+  projectIds: uniqueStrings().default([]),
+  projectSlugs: uniqueStrings().default([]),
+  sharedSources: z.array(z.object({ teamId: nonEmpty, projectIds: uniqueStrings().default([]) }).strict()).default([]),
+  request: z.record(z.unknown())
+}).strict();
+export {
+  knowledgeShareGrantInputSchema,
+  knowledgeShareOperationSchema,
+  knowledgeShareSchema,
+  teamKnowledgeRequestSchema
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@treeseed/sdk",
-  "version": "0.13.0-rc.65",
+  "version": "0.13.0-rc.67",
   "description": "Portable TreeSeed contracts, standards, and typed remote control-plane clients.",
   "license": "Apache-2.0",
   "repository": {