@treeseed/sdk 0.13.0-rc.50 → 0.13.0-rc.52

package/dist/deployment/schemas.js

@@ -1,4 +1,5 @@
 import { z } from "zod";
+import { AI_MODE_INTERNAL_PATH } from "./ai-mode.js";
 const identifier = z.string().regex(/^[a-z][a-z0-9.-]{1,63}$/u);
 const digest = z.string().regex(/^sha256:[a-f0-9]{64}$/u);
 const gitCommit = z.string().regex(/^[a-f0-9]{40}$/u);
@@ -131,7 +132,9 @@ const environmentName = z.string().regex(/^[A-Z][A-Z0-9_]{0,127}$/u, "Environmen
 const componentSecretPath = z.string().regex(/^\/etc\/treeseed\/credentials\/[a-z0-9][a-z0-9._-]{0,127}$/u, "Secret inputs must use manager-owned credential paths.");
 const componentConfigurationPath = z.string().regex(/^\/etc\/treeseed\/components\/[a-z][a-z0-9.-]*\/[a-z0-9][a-z0-9._-]{0,127}$/u, "Configuration inputs must use manager-owned component paths.");
 const componentRuntimeConfigurationSchema = z.object({
-  environment: z.array(z.object({ name: environmentName, required: z.boolean(), default: z.string().max(16384).optional() }).strict()).default([]),
+  environment: z.array(z.object({ name: environmentName, required: z.boolean(), source: z.enum(["configuration", "manager"]).default("configuration"), default: z.string().max(16384).optional() }).strict().superRefine((input, context) => {
+    if (input.source === "manager" && input.default !== void 0) context.addIssue({ code: z.ZodIssueCode.custom, path: ["default"], message: "Manager-derived environment inputs cannot declare configuration defaults." });
+  })).default([]),
   secretEnvironment: z.array(z.object({ name: environmentName, required: z.boolean() }).strict()).default([]),
   secretFiles: z.array(z.object({ id: identifier, path: componentSecretPath, required: z.boolean() }).strict()).default([]),
   files: z.array(z.object({ id: identifier, path: componentConfigurationPath, required: z.boolean(), sensitive: z.boolean().default(false) }).strict()).default([])
@@ -164,11 +167,36 @@ const packageRuntimeSchema = z.object({
     capability: identifier,
     locality: z.enum(["local", "remote", "either"]),
     optional: z.boolean().default(false)
-  }).strict()).default([])
+  }).strict()).default([]),
+  modeControl: z.object({
+    resource: z.literal("ai-gpu"),
+    role: z.enum(["inference", "training", "controller"]),
+    gate: z.object({
+      service: identifier,
+      executable: z.literal("/usr/local/bin/treeseed-ai-gpu-gate")
+    }).strict().optional(),
+    services: z.object({
+      base: z.array(identifier).min(1),
+      gpu: z.array(identifier).max(2),
+      warm: identifier.optional()
+    }).strict(),
+    internalControl: z.object({
+      transport: z.literal("mtls"),
+      clientCommonName: z.literal("client-ai-lab-mode"),
+      path: z.literal(AI_MODE_INTERNAL_PATH)
+    }).strict().optional()
+  }).strict().optional()
 }).strict().superRefine((runtime, context) => {
   const endpointIds = runtime.services.flatMap((service) => service.endpoints.map((endpoint) => `${service.id}.${endpoint.id}`));
   if (new Set(endpointIds).size !== endpointIds.length) context.addIssue({ code: z.ZodIssueCode.custom, path: ["services"], message: "Endpoint identities must be unique within a component." });
   for (const file of runtime.configuration.files) if (!file.path.startsWith(`/etc/treeseed/components/${runtime.componentId}/`)) context.addIssue({ code: z.ZodIssueCode.custom, path: ["configuration", "files"], message: `Configuration file ${file.id} is outside component ${runtime.componentId} custody.` });
+  if (runtime.modeControl) {
+    const services = new Set(runtime.services.map(({ composeService }) => composeService));
+    for (const service of [...runtime.modeControl.services.base, ...runtime.modeControl.services.gpu, ...runtime.modeControl.services.warm ? [runtime.modeControl.services.warm] : []]) if (!services.has(service)) context.addIssue({ code: z.ZodIssueCode.custom, path: ["modeControl", "services"], message: `AI mode service ${service} is not declared by the component runtime.` });
+    if (runtime.modeControl.gate && !services.has(runtime.modeControl.gate.service)) context.addIssue({ code: z.ZodIssueCode.custom, path: ["modeControl", "gate"], message: `AI mode gate service ${runtime.modeControl.gate.service} is not declared by the component runtime.` });
+    if (runtime.modeControl.role === "controller" && (!runtime.modeControl.internalControl || runtime.modeControl.gate || runtime.modeControl.services.gpu.length)) context.addIssue({ code: z.ZodIssueCode.custom, path: ["modeControl"], message: "The AI controller may declare only the scoped internal control surface." });
+    if (runtime.modeControl.role !== "controller" && (!runtime.modeControl.gate || runtime.modeControl.internalControl || runtime.modeControl.services.gpu.length === 0)) context.addIssue({ code: z.ZodIssueCode.custom, path: ["modeControl"], message: "AI GPU components require a fixed gate and at least one GPU service." });
+  }
 });
 const catalogPackageSchema = z.object({ name: z.string().regex(/^treeseed(?:-[a-z0-9-]+)?$/u), version: packageVersion, architecture: z.enum(["amd64", "all"]), origin: z.literal("TreeSeed Deployment"), order: z.number().int().nonnegative() }).strict();
 const catalogImageSchema = z.object({ role: identifier, repository: ociRepository, digest, platforms: z.array(z.enum(["linux/amd64", "linux/arm64"])).min(1), consumers: z.array(identifier).min(1) }).strict();

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

@@ -112,8 +112,8 @@ const operationBindings = {
   "projects treedx workspaces show": operation("treedx.workspaces.show", [field("path", "projectId", "context", "project", true), field("path", "workspaceId", "argument", "workspace", true)]),
   "projects treedx workspaces abandon": operation("treedx.workspaces.abandon", [field("path", "projectId", "context", "project", true), field("path", "workspaceId", "argument", "workspace", true)]),
   "ai status": operation("treeai.qualification.get.status", [aiNode()]),
-  "ai mode show": operation("treeai.qualification.get.mode", [aiNode()]),
-  "ai mode set": operation("treeai.qualification.post.mode", [aiNode(), field("body", "mode", "argument", "mode", true)]),
+  "ai mode show": local("local.host.ai.mode.show"),
+  "ai mode set": local("local.host.ai.mode.set"),
   "ai inference models": operation("treeai.inference.get.models", [aiNode()]),
   "ai inference jobs": operation("treeai.inference.get.jobs", [aiNode()]),
   "ai inference rollback": operation("treeai.inference.post.deployments.rollback", [aiNode()]),
@@ -178,6 +178,19 @@ function hostReset() {
   value.options = [...value.options ?? [], { name: "--confirm", description: "Confirm deletion of all manager-owned component data and receipts.", type: "boolean" }];
   return value;
 }
+function aiModeSet() {
+  const value = leaf("set", "mutation", "mode", "authority");
+  if (value.nodeType !== "leaf") throw new Error("AI mode set must be a leaf command.");
+  value.description = "Transition the exclusive AI GPU resource to awake or sleep.";
+  value.options = [
+    ...value.options ?? [],
+    { name: "--idempotency-key", description: "Replay-safe transition identity.", type: "string" },
+    { name: "--drain-timeout", description: "Maximum drain wait in seconds.", type: "number" }
+  ];
+  value.authorization = { capability: "host.ai.mode", confirmation: "authority" };
+  value.resultSchemaId = "treeseed.ai-mode-transition-receipt/v1";
+  return value;
+}
 function userCreate() {
   const value = leaf("create", "mutation");
   if (value.nodeType !== "leaf") throw new Error("User creation must be a leaf command.");
@@ -317,7 +330,7 @@ const commandTree = {
     ])]),
     branch("ai", [
       leaf("status"),
-      branch("mode", [leaf("show"), leaf("set", "mutation", "mode", "authority")]),
+      branch("mode", [leaf("show"), aiModeSet()]),
       branch("inference", [leaf("models"), leaf("jobs"), leaf("rollback", "mutation", void 0, "destructive")]),
       branch("training", [leaf("libraries"), leaf("jobs"), leaf("runs")]),
       branch("lab", [leaf("status"), leaf("agents"), leaf("libraries")]),

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

@@ -8,7 +8,7 @@ export declare function communicationOperations(): {
         timeoutSeconds?: number | undefined;
         recipients?: string[] | undefined;
     }, {
-        status: "failed" | "partial" | "complete" | "running" | "queued";
+        status: "failed" | "running" | "partial" | "complete" | "queued";
         schemaVersion: "treeseed.communication-send-receipt/v2";
         targets: {
             status: "failed" | "running" | "cancelled" | "queued" | "responded" | "abstained";
@@ -81,7 +81,7 @@ export declare function communicationOperations(): {
         teamId: string;
         sendId: string;
     }, {}, undefined, {
-        status: "failed" | "partial" | "complete" | "running" | "queued";
+        status: "failed" | "running" | "partial" | "complete" | "queued";
         schemaVersion: "treeseed.communication-send-receipt/v2";
         targets: {
             status: "failed" | "running" | "cancelled" | "queued" | "responded" | "abstained";

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

@@ -425,7 +425,7 @@ export declare const communicationSendReceiptSchema: z.ZodObject<{
     updatedAt: z.ZodString;
     replayed: z.ZodBoolean;
 }, "strict", z.ZodTypeAny, {
-    status: "failed" | "partial" | "complete" | "running" | "queued";
+    status: "failed" | "running" | "partial" | "complete" | "queued";
     schemaVersion: "treeseed.communication-send-receipt/v2";
     targets: {
         status: "failed" | "running" | "cancelled" | "queued" | "responded" | "abstained";
@@ -494,7 +494,7 @@ export declare const communicationSendReceiptSchema: z.ZodObject<{
     sourceMessage: string;
     replayed: boolean;
 }, {
-    status: "failed" | "partial" | "complete" | "running" | "queued";
+    status: "failed" | "running" | "partial" | "complete" | "queued";
     schemaVersion: "treeseed.communication-send-receipt/v2";
     targets: {
         status: "failed" | "running" | "cancelled" | "queued" | "responded" | "abstained";

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

@@ -503,7 +503,7 @@ export declare const CONTROL_PLANE_OPERATIONS: {
             timeoutSeconds?: number | undefined;
             recipients?: string[] | undefined;
         }, {
-            status: "failed" | "partial" | "complete" | "running" | "queued";
+            status: "failed" | "running" | "partial" | "complete" | "queued";
             schemaVersion: "treeseed.communication-send-receipt/v2";
             targets: {
                 status: "failed" | "running" | "cancelled" | "queued" | "responded" | "abstained";
@@ -576,7 +576,7 @@ export declare const CONTROL_PLANE_OPERATIONS: {
             teamId: string;
             sendId: string;
         }, {}, undefined, {
-            status: "failed" | "partial" | "complete" | "running" | "queued";
+            status: "failed" | "running" | "partial" | "complete" | "queued";
             schemaVersion: "treeseed.communication-send-receipt/v2";
             targets: {
                 status: "failed" | "running" | "cancelled" | "queued" | "responded" | "abstained";

package/package.json

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