@treeseed/sdk 0.13.0-rc.47 → 0.13.0-rc.49

package/dist/treeai/client.js

@@ -0,0 +1,44 @@
+import { treeAiControlPlaneOperation } from "./catalog.js";
+import { TREEAI_UPSTREAM_OPERATIONS } from "./generated/upstream.js";
+class TreeSeedTreeAiClient {
+  constructor(direct, controlPlane, nodeId) {
+    this.direct = direct;
+    this.controlPlane = controlPlane;
+    this.nodeId = nodeId;
+  }
+  direct;
+  controlPlane;
+  nodeId;
+  operations = TREEAI_UPSTREAM_OPERATIONS;
+  static direct(options) {
+    return new TreeSeedTreeAiClient(options, null, null);
+  }
+  static controlPlane(client, nodeId) {
+    return new TreeSeedTreeAiClient(null, client, nodeId);
+  }
+  async invoke(operationId, input = {}, options = {}) {
+    const operation = TREEAI_UPSTREAM_OPERATIONS.find((item) => item.operationId === operationId);
+    if (!operation) throw new Error(`Unknown TreeAI operation ${operationId}.`);
+    if (this.controlPlane) {
+      const binding = treeAiControlPlaneOperation(operationId);
+      return this.controlPlane.invoke(binding, { path: { nodeId: this.nodeId, ...input.path ?? {} }, query: input.query ?? {}, body: operation.kind === "read" ? void 0 : input.body ?? {} }, options);
+    }
+    if (!this.direct) throw new Error("TreeAI transport is not configured.");
+    let path = operation.path;
+    for (const [name, value] of Object.entries(input.path ?? {})) path = path.replace(`{${name}}`, encodeURIComponent(String(value)));
+    if (/\{[^}]+\}/u.test(path)) throw new Error(`TreeAI operation ${operationId} is missing path parameters.`);
+    const url = new URL(path, `${this.direct.endpoints[operation.service].replace(/\/$/u, "")}/`);
+    for (const [name, value] of Object.entries(input.query ?? {})) if (value !== void 0) url.searchParams.set(name, String(value));
+    const token = typeof this.direct.token === "function" ? await this.direct.token() : this.direct.token;
+    const headers = new Headers(input.headers);
+    if (token) headers.set("authorization", `Bearer ${token}`);
+    if (input.body !== void 0) headers.set("content-type", "application/json");
+    const response = await (this.direct.fetch ?? fetch)(url, { method: operation.method, headers, body: input.body === void 0 ? void 0 : JSON.stringify(input.body) });
+    const payload = (response.headers.get("content-type") ?? "").includes("json") ? await response.json() : await response.text();
+    if (!response.ok) throw Object.assign(new Error(`TreeAI ${operationId} returned ${response.status}.`), { status: response.status, payload });
+    return payload;
+  }
+}
+export {
+  TreeSeedTreeAiClient
+};

package/dist/treeai/contract.d.ts

@@ -0,0 +1,42 @@
+export declare const TREESEED_TREEAI_SERVICE_CONTRACT_SCHEMA: "treeseed.treeai-service-contract/v1";
+export declare const TREEAI_ADOPTION: {
+    readonly release: "0.11.0-rc2";
+    readonly sourceCommit: "9770c99ba3a2f91ce916b48efafa45b0e971bbf0";
+    readonly packageArtifactDigest: "sha256:90d695d499088f2788da36863128efe57079915d3999cc876888ceb091cb95f2";
+    readonly operationInventoryDigest: "sha256:dc60eb514e11a4b867b3353830d886205df6254c7c4ecfab9a06b1b4dcb4e1fc";
+};
+export declare function validateTreeAiOperationMapping(): string[];
+export declare function createTreeAiServiceContractReceipt(): Promise<{
+    readonly openapiVersion: "3.1.1";
+    readonly openapiDigests: {
+        readonly inference: "sha256:3a00f1d91635d87d0aad2c6d329f495ff210f393bc9851570aa3e3ad1f5c1db4";
+        readonly training: "sha256:89dc70cecc85079853e4f177827d681e66f4b24b93ef17713051b99f07c2fe00";
+        readonly lab: "sha256:bccafa27b00a63b9fb22b132b850f9af6e77d44047dbc8966344088266d65898";
+        readonly qualification: "sha256:3f68b78845ec19c5de389663f1cb677ab4df0683ecd113c4f5780885a89370b7";
+    };
+    readonly controlPlaneCatalogDigest: `sha256:${string}`;
+    readonly operationMapping: {
+        treeseedOperationId: `${string}.${string}`;
+        treeaiOperationId: string;
+        contractVersion: string;
+        contractDigest: `sha256:${string}`;
+        capability: string;
+        authentication: import("../operator-contracts/control-plane-operation.js").ControlPlaneAuthenticationKind;
+        oauthScopes: ("treeseed:read" | "treeseed:knowledge:write" | "treeseed:governance:write" | "treeseed:projects:write" | "treeseed:execution" | "treeseed:admin")[];
+        riskClass: import("../operator-contracts/control-plane-operation.js").ControlPlaneRiskClass;
+        idempotency: import("../operator-contracts/control-plane-operation.js").ControlPlaneIdempotencyContract;
+        concurrency: import("../operator-contracts/control-plane-operation.js").ControlPlaneConcurrencyContract;
+        surfaces: import("../operator-contracts/control-plane-operation.js").ControlPlaneOperationSurface[];
+        redactedPaths: string[];
+    }[];
+    readonly operationMappingDigest: `sha256:${string}`;
+    readonly compatibility: {
+        readonly direct: true;
+        readonly controlPlane: true;
+    };
+    readonly release: "0.11.0-rc2";
+    readonly sourceCommit: "9770c99ba3a2f91ce916b48efafa45b0e971bbf0";
+    readonly packageArtifactDigest: "sha256:90d695d499088f2788da36863128efe57079915d3999cc876888ceb091cb95f2";
+    readonly operationInventoryDigest: "sha256:dc60eb514e11a4b867b3353830d886205df6254c7c4ecfab9a06b1b4dcb4e1fc";
+    readonly schema: "treeseed.treeai-service-contract/v1";
+}>;

package/dist/treeai/contract.js

@@ -0,0 +1,51 @@
+import { CONTROL_PLANE_CATALOG } from "../operator-contracts/control-plane-operations.js";
+import { standardsSha256 } from "../standards/canonicalize.js";
+import { TREEAI_CONTROL_PLANE_OPERATION_LIST, TREEAI_OPENAPI_DIGESTS } from "./catalog.js";
+import { TREEAI_UPSTREAM_OPERATIONS } from "./generated/upstream.js";
+const TREESEED_TREEAI_SERVICE_CONTRACT_SCHEMA = "treeseed.treeai-service-contract/v1";
+const TREEAI_ADOPTION = {
+  release: "0.11.0-rc2",
+  sourceCommit: "9770c99ba3a2f91ce916b48efafa45b0e971bbf0",
+  packageArtifactDigest: "sha256:90d695d499088f2788da36863128efe57079915d3999cc876888ceb091cb95f2",
+  operationInventoryDigest: "sha256:dc60eb514e11a4b867b3353830d886205df6254c7c4ecfab9a06b1b4dcb4e1fc"
+};
+function validateTreeAiOperationMapping() {
+  const authoritative = new Set(TREEAI_UPSTREAM_OPERATIONS.map(({ operationId }) => operationId));
+  const mapped = TREEAI_CONTROL_PLANE_OPERATION_LIST.map(({ descriptor }) => descriptor.upstream?.operationId).filter(Boolean);
+  return [
+    ...mapped.filter((id) => !authoritative.has(id)).map((id) => `unknown_upstream_operation:${id}`),
+    ...TREEAI_UPSTREAM_OPERATIONS.filter(({ operationId }) => !mapped.includes(operationId)).map(({ operationId }) => `unmapped_upstream_operation:${operationId}`)
+  ].sort();
+}
+async function createTreeAiServiceContractReceipt() {
+  const mapping = TREEAI_CONTROL_PLANE_OPERATION_LIST.map(({ descriptor }) => ({
+    treeseedOperationId: descriptor.operationId,
+    treeaiOperationId: descriptor.upstream.operationId,
+    contractVersion: descriptor.upstream.contractVersion,
+    contractDigest: descriptor.upstream.contractDigest,
+    capability: descriptor.capability,
+    authentication: descriptor.authentication,
+    oauthScopes: descriptor.oauthScopes,
+    riskClass: descriptor.riskClass,
+    idempotency: descriptor.idempotency,
+    concurrency: descriptor.concurrency,
+    surfaces: descriptor.surfaces,
+    redactedPaths: descriptor.redactedPaths
+  })).sort((left, right) => left.treeseedOperationId.localeCompare(right.treeseedOperationId));
+  return {
+    schema: TREESEED_TREEAI_SERVICE_CONTRACT_SCHEMA,
+    ...TREEAI_ADOPTION,
+    openapiVersion: "3.1.1",
+    openapiDigests: TREEAI_OPENAPI_DIGESTS,
+    controlPlaneCatalogDigest: await standardsSha256(CONTROL_PLANE_CATALOG),
+    operationMapping: mapping,
+    operationMappingDigest: await standardsSha256(mapping),
+    compatibility: { direct: true, controlPlane: true }
+  };
+}
+export {
+  TREEAI_ADOPTION,
+  TREESEED_TREEAI_SERVICE_CONTRACT_SCHEMA,
+  createTreeAiServiceContractReceipt,
+  validateTreeAiOperationMapping
+};