@treeseed/sdk 0.13.0-rc.90 → 0.13.0-rc.92

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

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import { defineOperation as define, defineTreeDxProxyOperation as treedxProxy } from "./operation-builder.js";
+import { defineOperation as define, defineTreeDxProxyOperation as treedxProxy, defineReadOperation as read } from "./operation-builder.js";
 import { communicationOperations, providerCommunicationLifecycleOperations, providerDiscussionResponseOperation } from "./catalog/communication-operations.js";
 import { inboxOperations } from "./catalog/inbox-operations.js";
 import { adminAccountOperations, adminTeamOperations } from "./catalog/admin-account-team-operations.js";
@@ -8,25 +8,10 @@ import { capabilityOntologyOperations } from "./catalog/capability-ontology-oper
 import { knowledgeShareOperations } from "./catalog/knowledge-share-operations.js";
 import { PROVIDER_ENVIRONMENT_OPERATIONS } from "./catalog/provider-environment-operations.js";
 import { HOSTED_TOPOLOGY_OPERATIONS } from "./catalog/hosted-topology-operations.js";
+import { AI_INSTANCE_OPERATIONS } from "./catalog/infrastructure/ai-instance-operations.js";
 import { SECRET_OPERATIONS } from "./catalog/services/secret-operations.js";
 import { buildControlPlaneCatalog, flattenControlPlaneOperations } from "./catalog/control-plane-catalog.js";
 const empty = z.object({}).strict(), none = z.undefined(), record = z.record(z.unknown()), payload = record;
-function read(operationId, path, capability, surfaces = ["rest"]) {
-  return define({
-    operationId,
-    description: `Read ${operationId}.`,
-    rest: { method: "GET", path },
-    capability,
-    authentication: "oauth",
-    oauthScopes: ["treeseed:read"],
-    kind: "read",
-    riskClass: "ordinary",
-    confirmation: "never",
-    surfaces,
-    cacheScope: "principal",
-    pagination: "none"
-  }, { path: empty, query: empty, body: none, output: payload });
-}
 function providerPath(operationId, method, path, pathShape, options = {}) {
   const kind = options.read ? "read" : "mutation";
   return define({
@@ -101,6 +86,7 @@ function resource(operationId, method, path, pathShape, options = { capability:
   }, { path: z.object(pathShape).strict(), query: kind === "read" ? record : empty, body: kind === "read" ? none : record, output: payload });
 }
 const CONTROL_PLANE_OPERATIONS = {
+  aiInstances: AI_INSTANCE_OPERATIONS,
   infrastructure: { topology: HOSTED_TOPOLOGY_OPERATIONS },
   capabilities: capabilityOntologyOperations(),
   inbox: inboxOperations(),

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

@@ -65,9 +65,9 @@ export declare const inboxCommentSchema: z.ZodObject<{
         commitSha: string | null;
     }>;
 }, "strict", z.ZodTypeAny, {
+    kind: "comment" | "answer" | "reply";
     id: string;
     createdAt: string;
-    kind: "comment" | "answer" | "reply";
     provenance: {
         digest: string | null;
         repositoryId: string | null;
@@ -79,9 +79,9 @@ export declare const inboxCommentSchema: z.ZodObject<{
     authorId: string;
     authorLabel: string;
 }, {
+    kind: "comment" | "answer" | "reply";
     id: string;
     createdAt: string;
-    kind: "comment" | "answer" | "reply";
     provenance: {
         digest: string | null;
         repositoryId: string | null;
@@ -172,9 +172,9 @@ export declare const inboxItemSchema: z.ZodObject<{
             commitSha: string | null;
         }>;
     }, "strict", z.ZodTypeAny, {
+        kind: "comment" | "answer" | "reply";
         id: string;
         createdAt: string;
-        kind: "comment" | "answer" | "reply";
         provenance: {
             digest: string | null;
             repositoryId: string | null;
@@ -186,9 +186,9 @@ export declare const inboxItemSchema: z.ZodObject<{
         authorId: string;
         authorLabel: string;
     }, {
+        kind: "comment" | "answer" | "reply";
         id: string;
         createdAt: string;
-        kind: "comment" | "answer" | "reply";
         provenance: {
             digest: string | null;
             repositoryId: string | null;
@@ -203,13 +203,13 @@ export declare const inboxItemSchema: z.ZodObject<{
     etag: z.ZodString;
 }, "strict", z.ZodTypeAny, {
     status: "approved" | "rejected" | "outstanding" | "answered" | "closed" | "deleted";
+    kind: "proposal" | "question";
     schemaVersion: "treeseed.inbox-item/v1";
     id: string;
     version: number;
     projectId: string;
     teamId: string;
     createdAt: string;
-    kind: "proposal" | "question";
     provenance: {
         digest: string | null;
         repositoryId: string | null;
@@ -232,9 +232,9 @@ export declare const inboxItemSchema: z.ZodObject<{
         requiresFeedback: boolean;
     }[];
     comments: {
+        kind: "comment" | "answer" | "reply";
         id: string;
         createdAt: string;
-        kind: "comment" | "answer" | "reply";
         provenance: {
             digest: string | null;
             repositoryId: string | null;
@@ -249,13 +249,13 @@ export declare const inboxItemSchema: z.ZodObject<{
     etag: string;
 }, {
     status: "approved" | "rejected" | "outstanding" | "answered" | "closed" | "deleted";
+    kind: "proposal" | "question";
     schemaVersion: "treeseed.inbox-item/v1";
     id: string;
     version: number;
     projectId: string;
     teamId: string;
     createdAt: string;
-    kind: "proposal" | "question";
     provenance: {
         digest: string | null;
         repositoryId: string | null;
@@ -278,9 +278,9 @@ export declare const inboxItemSchema: z.ZodObject<{
         requiresFeedback: boolean;
     }[];
     comments: {
+        kind: "comment" | "answer" | "reply";
         id: string;
         createdAt: string;
-        kind: "comment" | "answer" | "reply";
         provenance: {
             digest: string | null;
             repositoryId: string | null;
@@ -373,9 +373,9 @@ export declare const inboxItemSummarySchema: z.ZodObject<Pick<{
             commitSha: string | null;
         }>;
     }, "strict", z.ZodTypeAny, {
+        kind: "comment" | "answer" | "reply";
         id: string;
         createdAt: string;
-        kind: "comment" | "answer" | "reply";
         provenance: {
             digest: string | null;
             repositoryId: string | null;
@@ -387,9 +387,9 @@ export declare const inboxItemSummarySchema: z.ZodObject<Pick<{
         authorId: string;
         authorLabel: string;
     }, {
+        kind: "comment" | "answer" | "reply";
         id: string;
         createdAt: string;
-        kind: "comment" | "answer" | "reply";
         provenance: {
             digest: string | null;
             repositoryId: string | null;
@@ -402,14 +402,14 @@ export declare const inboxItemSummarySchema: z.ZodObject<Pick<{
         authorLabel: string;
     }>, "many">;
     etag: z.ZodString;
-}, "status" | "id" | "version" | "projectId" | "teamId" | "createdAt" | "kind" | "projectSlug" | "updatedAt" | "authorId" | "authorLabel" | "title" | "etag">, "strict", z.ZodTypeAny, {
+}, "status" | "kind" | "id" | "version" | "projectId" | "teamId" | "createdAt" | "projectSlug" | "updatedAt" | "authorId" | "authorLabel" | "title" | "etag">, "strict", z.ZodTypeAny, {
     status: "approved" | "rejected" | "outstanding" | "answered" | "closed" | "deleted";
+    kind: "proposal" | "question";
     id: string;
     version: number;
     projectId: string;
     teamId: string;
     createdAt: string;
-    kind: "proposal" | "question";
     projectSlug: string;
     updatedAt: string;
     authorId: string;
@@ -418,12 +418,12 @@ export declare const inboxItemSummarySchema: z.ZodObject<Pick<{
     etag: string;
 }, {
     status: "approved" | "rejected" | "outstanding" | "answered" | "closed" | "deleted";
+    kind: "proposal" | "question";
     id: string;
     version: number;
     projectId: string;
     teamId: string;
     createdAt: string;
-    kind: "proposal" | "question";
     projectSlug: string;
     updatedAt: string;
     authorId: string;
@@ -512,9 +512,9 @@ export declare const inboxItemPageSchema: z.ZodObject<{
                 commitSha: string | null;
             }>;
         }, "strict", z.ZodTypeAny, {
+            kind: "comment" | "answer" | "reply";
             id: string;
             createdAt: string;
-            kind: "comment" | "answer" | "reply";
             provenance: {
                 digest: string | null;
                 repositoryId: string | null;
@@ -526,9 +526,9 @@ export declare const inboxItemPageSchema: z.ZodObject<{
             authorId: string;
             authorLabel: string;
         }, {
+            kind: "comment" | "answer" | "reply";
             id: string;
             createdAt: string;
-            kind: "comment" | "answer" | "reply";
             provenance: {
                 digest: string | null;
                 repositoryId: string | null;
@@ -541,14 +541,14 @@ export declare const inboxItemPageSchema: z.ZodObject<{
             authorLabel: string;
         }>, "many">;
         etag: z.ZodString;
-    }, "status" | "id" | "version" | "projectId" | "teamId" | "createdAt" | "kind" | "projectSlug" | "updatedAt" | "authorId" | "authorLabel" | "title" | "etag">, "strict", z.ZodTypeAny, {
+    }, "status" | "kind" | "id" | "version" | "projectId" | "teamId" | "createdAt" | "projectSlug" | "updatedAt" | "authorId" | "authorLabel" | "title" | "etag">, "strict", z.ZodTypeAny, {
         status: "approved" | "rejected" | "outstanding" | "answered" | "closed" | "deleted";
+        kind: "proposal" | "question";
         id: string;
         version: number;
         projectId: string;
         teamId: string;
         createdAt: string;
-        kind: "proposal" | "question";
         projectSlug: string;
         updatedAt: string;
         authorId: string;
@@ -557,12 +557,12 @@ export declare const inboxItemPageSchema: z.ZodObject<{
         etag: string;
     }, {
         status: "approved" | "rejected" | "outstanding" | "answered" | "closed" | "deleted";
+        kind: "proposal" | "question";
         id: string;
         version: number;
         projectId: string;
         teamId: string;
         createdAt: string;
-        kind: "proposal" | "question";
         projectSlug: string;
         updatedAt: string;
         authorId: string;
@@ -575,12 +575,12 @@ export declare const inboxItemPageSchema: z.ZodObject<{
     schemaVersion: "treeseed.inbox-page/v1";
     items: {
         status: "approved" | "rejected" | "outstanding" | "answered" | "closed" | "deleted";
+        kind: "proposal" | "question";
         id: string;
         version: number;
         projectId: string;
         teamId: string;
         createdAt: string;
-        kind: "proposal" | "question";
         projectSlug: string;
         updatedAt: string;
         authorId: string;
@@ -593,12 +593,12 @@ export declare const inboxItemPageSchema: z.ZodObject<{
     schemaVersion: "treeseed.inbox-page/v1";
     items: {
         status: "approved" | "rejected" | "outstanding" | "answered" | "closed" | "deleted";
+        kind: "proposal" | "question";
         id: string;
         version: number;
         projectId: string;
         teamId: string;
         createdAt: string;
-        kind: "proposal" | "question";
         projectSlug: string;
         updatedAt: string;
         authorId: string;
@@ -865,9 +865,9 @@ export declare const inboxMutationReceiptSchema: z.ZodObject<{
                 commitSha: string | null;
             }>;
         }, "strict", z.ZodTypeAny, {
+            kind: "comment" | "answer" | "reply";
             id: string;
             createdAt: string;
-            kind: "comment" | "answer" | "reply";
             provenance: {
                 digest: string | null;
                 repositoryId: string | null;
@@ -879,9 +879,9 @@ export declare const inboxMutationReceiptSchema: z.ZodObject<{
             authorId: string;
             authorLabel: string;
         }, {
+            kind: "comment" | "answer" | "reply";
             id: string;
             createdAt: string;
-            kind: "comment" | "answer" | "reply";
             provenance: {
                 digest: string | null;
                 repositoryId: string | null;
@@ -896,13 +896,13 @@ export declare const inboxMutationReceiptSchema: z.ZodObject<{
         etag: z.ZodString;
     }, "strict", z.ZodTypeAny, {
         status: "approved" | "rejected" | "outstanding" | "answered" | "closed" | "deleted";
+        kind: "proposal" | "question";
         schemaVersion: "treeseed.inbox-item/v1";
         id: string;
         version: number;
         projectId: string;
         teamId: string;
         createdAt: string;
-        kind: "proposal" | "question";
         provenance: {
             digest: string | null;
             repositoryId: string | null;
@@ -925,9 +925,9 @@ export declare const inboxMutationReceiptSchema: z.ZodObject<{
             requiresFeedback: boolean;
         }[];
         comments: {
+            kind: "comment" | "answer" | "reply";
             id: string;
             createdAt: string;
-            kind: "comment" | "answer" | "reply";
             provenance: {
                 digest: string | null;
                 repositoryId: string | null;
@@ -942,13 +942,13 @@ export declare const inboxMutationReceiptSchema: z.ZodObject<{
         etag: string;
     }, {
         status: "approved" | "rejected" | "outstanding" | "answered" | "closed" | "deleted";
+        kind: "proposal" | "question";
         schemaVersion: "treeseed.inbox-item/v1";
         id: string;
         version: number;
         projectId: string;
         teamId: string;
         createdAt: string;
-        kind: "proposal" | "question";
         provenance: {
             digest: string | null;
             repositoryId: string | null;
@@ -971,9 +971,9 @@ export declare const inboxMutationReceiptSchema: z.ZodObject<{
             requiresFeedback: boolean;
         }[];
         comments: {
+            kind: "comment" | "answer" | "reply";
             id: string;
             createdAt: string;
-            kind: "comment" | "answer" | "reply";
             provenance: {
                 digest: string | null;
                 repositoryId: string | null;
@@ -994,13 +994,13 @@ export declare const inboxMutationReceiptSchema: z.ZodObject<{
     schemaVersion: "treeseed.inbox-mutation-receipt/v1";
     item: {
         status: "approved" | "rejected" | "outstanding" | "answered" | "closed" | "deleted";
+        kind: "proposal" | "question";
         schemaVersion: "treeseed.inbox-item/v1";
         id: string;
         version: number;
         projectId: string;
         teamId: string;
         createdAt: string;
-        kind: "proposal" | "question";
         provenance: {
             digest: string | null;
             repositoryId: string | null;
@@ -1023,9 +1023,9 @@ export declare const inboxMutationReceiptSchema: z.ZodObject<{
             requiresFeedback: boolean;
         }[];
         comments: {
+            kind: "comment" | "answer" | "reply";
             id: string;
             createdAt: string;
-            kind: "comment" | "answer" | "reply";
             provenance: {
                 digest: string | null;
                 repositoryId: string | null;
@@ -1046,13 +1046,13 @@ export declare const inboxMutationReceiptSchema: z.ZodObject<{
     schemaVersion: "treeseed.inbox-mutation-receipt/v1";
     item: {
         status: "approved" | "rejected" | "outstanding" | "answered" | "closed" | "deleted";
+        kind: "proposal" | "question";
         schemaVersion: "treeseed.inbox-item/v1";
         id: string;
         version: number;
         projectId: string;
         teamId: string;
         createdAt: string;
-        kind: "proposal" | "question";
         provenance: {
             digest: string | null;
             repositoryId: string | null;
@@ -1075,9 +1075,9 @@ export declare const inboxMutationReceiptSchema: z.ZodObject<{
             requiresFeedback: boolean;
         }[];
         comments: {
+            kind: "comment" | "answer" | "reply";
             id: string;
             createdAt: string;
-            kind: "comment" | "answer" | "reply";
             provenance: {
                 digest: string | null;
                 repositoryId: string | null;

package/dist/operator-contracts/operation-builder.d.ts

@@ -7,6 +7,7 @@ type Definition = Omit<ControlPlaneOperationDescriptor, 'schemaVersion' | 'schem
     concurrencyRequired?: boolean;
     authentication?: ControlPlaneOperationDescriptor['authentication'];
 };
+export declare function defineReadOperation(operationId: `${string}.${string}`, path: `/v1/${string}`, capability: string, surfaces?: ControlPlaneOperationDescriptor['surfaces']): ControlPlaneOperationBinding<{}, {}, undefined, Record<string, unknown>>;
 export declare function defineOperation<TPath, TQuery, TBody, TOutput>(definition: Definition, schema: ControlPlaneOperationBinding<TPath, TQuery, TBody, TOutput>['schema']): ControlPlaneOperationBinding<TPath, TQuery, TBody, TOutput>;
 export declare function defineTreeDxProxyOperation<T extends z.ZodRawShape>(operationId: `${string}.${string}`, upstreamOperationId: string | null, method: 'DELETE' | 'GET' | 'PATCH' | 'POST' | 'PUT', path: `/v1/${string}`, pathShape: T, options?: {
     read?: boolean;

package/dist/operator-contracts/operation-builder.js

@@ -3,6 +3,22 @@ import { TREEDX_OPENAPI_CONTRACT } from "@treeseed/treedx/openapi";
 import {
   CONTROL_PLANE_OPERATION_SCHEMA_VERSION
 } from "./control-plane-operation.js";
+function defineReadOperation(operationId, path, capability, surfaces = ["rest"]) {
+  return defineOperation({
+    operationId,
+    description: `Read ${operationId}.`,
+    rest: { method: "GET", path },
+    capability,
+    authentication: "oauth",
+    oauthScopes: ["treeseed:read"],
+    kind: "read",
+    riskClass: "ordinary",
+    confirmation: "never",
+    surfaces,
+    cacheScope: "principal",
+    pagination: "none"
+  }, { path: z.object({}).strict(), query: z.object({}).strict(), body: z.undefined(), output: z.record(z.unknown()) });
+}
 function defineOperation(definition, schema) {
   const { parameters, redactedPaths = [], idempotencyRequired, concurrencyRequired, ...descriptor } = definition;
   const mutation = definition.kind === "mutation";
@@ -57,5 +73,6 @@ function defineTreeDxProxyOperation(operationId, upstreamOperationId, method, pa
 }
 export {
   defineOperation,
+  defineReadOperation,
   defineTreeDxProxyOperation
 };