@treeseed/sdk 0.13.0-rc.11 → 0.13.0-rc.111

package/dist/operator-contracts/catalog/admin-account-team-operations.d.ts

@@ -0,0 +1,36 @@
+export declare const adminAccountOperations: {
+    readonly publicProfile: import("../control-plane-operation.js").ControlPlaneOperationBinding<{
+        username: string;
+    }, {}, Record<string, unknown> | undefined, Record<string, unknown>>;
+    readonly updateUsername: import("../control-plane-operation.js").ControlPlaneOperationBinding<{}, {}, Record<string, unknown> | undefined, Record<string, unknown>>;
+    readonly notificationPreferences: import("../control-plane-operation.js").ControlPlaneOperationBinding<{}, {}, Record<string, unknown> | undefined, Record<string, unknown>>;
+    readonly updateNotificationPreferences: import("../control-plane-operation.js").ControlPlaneOperationBinding<{}, {}, Record<string, unknown> | undefined, Record<string, unknown>>;
+    readonly themes: import("../control-plane-operation.js").ControlPlaneOperationBinding<{}, {}, Record<string, unknown> | undefined, Record<string, unknown>>;
+    readonly createTheme: import("../control-plane-operation.js").ControlPlaneOperationBinding<{}, {}, Record<string, unknown> | undefined, Record<string, unknown>>;
+    readonly updateTheme: import("../control-plane-operation.js").ControlPlaneOperationBinding<{
+        themeId: string;
+    }, {}, Record<string, unknown> | undefined, Record<string, unknown>>;
+    readonly deleteTheme: import("../control-plane-operation.js").ControlPlaneOperationBinding<{
+        themeId: string;
+    }, {}, Record<string, unknown> | undefined, Record<string, unknown>>;
+    readonly unlinkProvider: import("../control-plane-operation.js").ControlPlaneOperationBinding<{
+        identityId: string;
+    }, {}, Record<string, unknown> | undefined, Record<string, unknown>>;
+};
+export declare const adminTeamOperations: {
+    readonly revokeInvite: import("../control-plane-operation.js").ControlPlaneOperationBinding<{
+        teamId: string;
+        inviteId: string;
+    }, {}, Record<string, unknown> | undefined, Record<string, unknown>>;
+    readonly resendInvite: import("../control-plane-operation.js").ControlPlaneOperationBinding<{
+        teamId: string;
+        inviteId: string;
+    }, {}, Record<string, unknown> | undefined, Record<string, unknown>>;
+    readonly memberRemovalBlockers: import("../control-plane-operation.js").ControlPlaneOperationBinding<{
+        teamId: string;
+        membershipId: string;
+    }, {}, Record<string, unknown> | undefined, Record<string, unknown>>;
+    readonly remove: import("../control-plane-operation.js").ControlPlaneOperationBinding<{
+        teamId: string;
+    }, {}, Record<string, unknown> | undefined, Record<string, unknown>>;
+};

package/dist/operator-contracts/catalog/admin-account-team-operations.js

@@ -0,0 +1,52 @@
+import { z } from "zod";
+import { defineOperation } from "../operation-builder.js";
+const empty = z.object({}).strict();
+const none = z.undefined();
+const record = z.record(z.unknown());
+function operation(operationId, method, path, pathShape, options) {
+  const read = method === "GET";
+  const riskClass = options.risk ?? "ordinary";
+  return defineOperation({
+    operationId,
+    description: `${read ? "Read" : "Apply"} ${operationId}.`,
+    rest: { method, path },
+    ...Object.keys(pathShape).length ? { parameters: `treeseed.${operationId}.parameters/v1` } : {},
+    capability: options.capability,
+    authentication: options.authentication ?? "oauth",
+    oauthScopes: options.authentication === "anonymous" ? [] : [read ? "treeseed:read" : "treeseed:projects:write"],
+    kind: read ? "read" : "mutation",
+    riskClass,
+    confirmation: riskClass === "ordinary" ? "never" : "input_required",
+    surfaces: options.surfaces ?? ["rest"],
+    cacheScope: options.cacheScope ?? (read ? "principal" : "none"),
+    pagination: options.pagination ?? "none",
+    concurrencyRequired: options.concurrency,
+    redactedPaths: options.redactedPaths
+  }, {
+    path: z.object(pathShape).strict(),
+    query: read ? record : empty,
+    body: read ? none : record,
+    output: record
+  });
+}
+const adminAccountOperations = {
+  publicProfile: operation("accounts.profile.public.show", "GET", "/v1/users/by-username/{username}/profile", { username: z.string().min(1) }, { capability: "accounts.public.read", authentication: "anonymous", cacheScope: "public", surfaces: ["rest", "mcp_resource"] }),
+  updateUsername: operation("accounts.username.update", "PATCH", "/v1/auth/web/username", {}, { capability: "accounts.write", concurrency: true }),
+  notificationPreferences: operation("accounts.notification.preferences.show", "GET", "/v1/auth/web/notifications/preferences", {}, { capability: "accounts.read" }),
+  updateNotificationPreferences: operation("accounts.notification.preferences.update", "PUT", "/v1/auth/web/notifications/preferences", {}, { capability: "accounts.write", concurrency: true }),
+  themes: operation("accounts.themes.list", "GET", "/v1/auth/web/themes", {}, { capability: "accounts.read", pagination: "cursor" }),
+  createTheme: operation("accounts.themes.create", "POST", "/v1/auth/web/themes", {}, { capability: "accounts.write" }),
+  updateTheme: operation("accounts.themes.update", "PUT", "/v1/auth/web/themes/{themeId}", { themeId: z.string().min(1) }, { capability: "accounts.write", concurrency: true }),
+  deleteTheme: operation("accounts.themes.delete", "DELETE", "/v1/auth/web/themes/{themeId}", { themeId: z.string().min(1) }, { capability: "accounts.write", risk: "destructive", concurrency: true }),
+  unlinkProvider: operation("accounts.providers.unlink", "DELETE", "/v1/auth/web/providers/{identityId}", { identityId: z.string().min(1) }, { capability: "accounts.write", risk: "credential" })
+};
+const adminTeamOperations = {
+  revokeInvite: operation("teams.invites.revoke", "DELETE", "/v1/teams/{teamId}/invites/{inviteId}", { teamId: z.string().min(1), inviteId: z.string().min(1) }, { capability: "teams.write", risk: "destructive", concurrency: true }),
+  resendInvite: operation("teams.invites.resend", "POST", "/v1/teams/{teamId}/invites/{inviteId}/resend", { teamId: z.string().min(1), inviteId: z.string().min(1) }, { capability: "teams.write" }),
+  memberRemovalBlockers: operation("teams.members.removal.blockers", "GET", "/v1/teams/{teamId}/members/{membershipId}/removal-blockers", { teamId: z.string().min(1), membershipId: z.string().min(1) }, { capability: "teams.read" }),
+  remove: operation("teams.delete", "DELETE", "/v1/teams/{teamId}/permanent-delete", { teamId: z.string().min(1) }, { capability: "teams.delete", risk: "irreversible", concurrency: true, redactedPaths: ["body.confirmation", "body.currentPassword", "body.reauthenticationGrantId"] })
+};
+export {
+  adminAccountOperations,
+  adminTeamOperations
+};

package/dist/operator-contracts/catalog/capability-ontology-operations.d.ts

@@ -0,0 +1,163 @@
+export declare function capabilityOntologyOperations(): {
+    list: import("../control-plane-operation.js").ControlPlaneOperationBinding<{}, {
+        status?: "active" | "revoked" | "deprecated" | undefined;
+        family?: string | undefined;
+        cursor?: string | undefined;
+        limit?: number | undefined;
+        namespace?: string | undefined;
+    }, undefined, {
+        generation: number;
+        items: {
+            status: "active" | "revoked" | "deprecated";
+            id: string;
+            version: string;
+            schemaVersion: "treeseed.capability-definition/v1";
+            digest: string;
+            inputs: {
+                id: string;
+                version: string;
+                digest: string;
+                mediaTypes?: string[] | undefined;
+            }[];
+            createdAt: string;
+            outputs: {
+                id: string;
+                version: string;
+                digest: string;
+                mediaTypes?: string[] | undefined;
+            }[];
+            description: string;
+            configuration: {
+                key: string;
+                description: string;
+                schema: Record<string, unknown>;
+                requirementSupport: ("required" | "preferred")[];
+                securityCritical?: boolean | undefined;
+            }[];
+            family: "research" | "coordination" | "data" | "engineering" | "publishing" | "external-work";
+            title: string;
+            features: string[];
+            permissionClasses: string[];
+            contextModes: string[];
+            interactionModes: string[];
+            implies: {
+                id: string;
+                version: string;
+                digest: string;
+            }[];
+            conflicts: {
+                id: string;
+                version: string;
+                digest: string;
+            }[];
+            qualificationTier: "signed-attestation" | "automated-suite" | "reviewed-certification";
+        }[];
+        ontologyDigest: string;
+        nextCursor: string | null;
+    }>;
+    show: import("../control-plane-operation.js").ControlPlaneOperationBinding<{
+        capabilityId: string;
+    }, {
+        version?: string | undefined;
+    }, undefined, {
+        status: "active" | "revoked" | "deprecated";
+        id: string;
+        version: string;
+        schemaVersion: "treeseed.capability-definition/v1";
+        digest: string;
+        inputs: {
+            id: string;
+            version: string;
+            digest: string;
+            mediaTypes?: string[] | undefined;
+        }[];
+        createdAt: string;
+        outputs: {
+            id: string;
+            version: string;
+            digest: string;
+            mediaTypes?: string[] | undefined;
+        }[];
+        description: string;
+        configuration: {
+            key: string;
+            description: string;
+            schema: Record<string, unknown>;
+            requirementSupport: ("required" | "preferred")[];
+            securityCritical?: boolean | undefined;
+        }[];
+        family: "research" | "coordination" | "data" | "engineering" | "publishing" | "external-work";
+        title: string;
+        features: string[];
+        permissionClasses: string[];
+        contextModes: string[];
+        interactionModes: string[];
+        implies: {
+            id: string;
+            version: string;
+            digest: string;
+        }[];
+        conflicts: {
+            id: string;
+            version: string;
+            digest: string;
+        }[];
+        qualificationTier: "signed-attestation" | "automated-suite" | "reviewed-certification";
+    }>;
+    generation: import("../control-plane-operation.js").ControlPlaneOperationBinding<{}, {}, undefined, {
+        schemaVersion: "treeseed.capability-ontology/v1";
+        digest: string;
+        createdAt: string;
+        generation: number;
+        signature: {
+            value: string;
+            algorithm: "Ed25519" | "release-catalog";
+            keyId: string;
+        };
+        definitions: {
+            status: "active" | "revoked" | "deprecated";
+            id: string;
+            version: string;
+            schemaVersion: "treeseed.capability-definition/v1";
+            digest: string;
+            inputs: {
+                id: string;
+                version: string;
+                digest: string;
+                mediaTypes?: string[] | undefined;
+            }[];
+            createdAt: string;
+            outputs: {
+                id: string;
+                version: string;
+                digest: string;
+                mediaTypes?: string[] | undefined;
+            }[];
+            description: string;
+            configuration: {
+                key: string;
+                description: string;
+                schema: Record<string, unknown>;
+                requirementSupport: ("required" | "preferred")[];
+                securityCritical?: boolean | undefined;
+            }[];
+            family: "research" | "coordination" | "data" | "engineering" | "publishing" | "external-work";
+            title: string;
+            features: string[];
+            permissionClasses: string[];
+            contextModes: string[];
+            interactionModes: string[];
+            implies: {
+                id: string;
+                version: string;
+                digest: string;
+            }[];
+            conflicts: {
+                id: string;
+                version: string;
+                digest: string;
+            }[];
+            qualificationTier: "signed-attestation" | "automated-suite" | "reviewed-certification";
+        }[];
+    }>;
+};

package/dist/operator-contracts/catalog/capability-ontology-operations.js

@@ -0,0 +1,24 @@
+import { z } from "zod";
+import { capabilityDefinitionSchema, capabilityOntologySchema } from "../../capacity-provider/capability-ontology.js";
+import { defineOperation } from "../operation-builder.js";
+const none = z.undefined(), empty = z.object({}).strict();
+function capabilityOntologyOperations() {
+  return {
+    list: defineOperation({ operationId: "capabilities.list", description: "List standardized execution capabilities from the active ontology generation.", rest: { method: "GET", path: "/v1/capability-ontology" }, parameters: "treeseed.capabilities.list.parameters/v1", capability: "capabilities.read", authentication: "oauth", oauthScopes: ["treeseed:read"], kind: "read", riskClass: "ordinary", confirmation: "never", surfaces: ["rest", "cli", "mcp_tool", "mcp_resource"], cacheScope: "principal", pagination: "cursor" }, {
+      path: empty,
+      query: z.object({ family: z.string().optional(), status: z.enum(["active", "deprecated", "revoked"]).optional(), namespace: z.string().optional(), limit: z.coerce.number().int().min(1).max(500).optional(), cursor: z.string().optional() }).strict(),
+      body: none,
+      output: z.object({ generation: z.number().int().positive(), ontologyDigest: z.string(), items: z.array(capabilityDefinitionSchema), nextCursor: z.string().nullable() }).strict()
+    }),
+    show: defineOperation({ operationId: "capabilities.show", description: "Read one exact standardized execution capability.", rest: { method: "GET", path: "/v1/capability-ontology/{capabilityId}" }, parameters: "treeseed.capabilities.show.parameters/v1", capability: "capabilities.read", authentication: "oauth", oauthScopes: ["treeseed:read"], kind: "read", riskClass: "ordinary", confirmation: "never", surfaces: ["rest", "cli", "mcp_tool", "mcp_resource"], cacheScope: "principal", pagination: "none" }, {
+      path: z.object({ capabilityId: z.string().min(1) }).strict(),
+      query: z.object({ version: z.string().optional() }).strict(),
+      body: none,
+      output: capabilityDefinitionSchema
+    }),
+    generation: defineOperation({ operationId: "capabilities.generation.show", description: "Read the complete active immutable capability ontology.", rest: { method: "GET", path: "/v1/capability-ontology/generations/active" }, capability: "capabilities.read", authentication: "oauth", oauthScopes: ["treeseed:read"], kind: "read", riskClass: "ordinary", confirmation: "never", surfaces: ["rest", "mcp_resource"], cacheScope: "principal", pagination: "none" }, { path: empty, query: empty, body: none, output: capabilityOntologySchema })
+  };
+}
+export {
+  capabilityOntologyOperations
+};