@treeseed/sdk 0.13.0-rc.115 → 0.13.0-rc.117

package/dist/.treeseed-build-complete.json

@@ -1 +1 @@
-{"completedAt":"2026-09-11T00:53:42.630Z"}
+{"completedAt":"2026-09-11T13:05:00.879Z"}

package/dist/agent-capacity/validation/agent-lab-forensics-schema.d.ts

@@ -157,6 +157,7 @@ export declare const agentForensicPayloadSchema: z.ZodObject<{
         severity: "error" | "warning" | "info";
     }>, "many">>;
 }, "strict", z.ZodTypeAny, {
+    activity: AgentActivityEvent;
     diagnostics: {
         code: string;
         path: string;
@@ -164,7 +165,6 @@ export declare const agentForensicPayloadSchema: z.ZodObject<{
         severity: "error" | "warning" | "info";
     }[];
     contract: "treeseed.agent-forensic-payload/v1";
-    activity: AgentActivityEvent;
     payload?: Record<string, unknown> | undefined;
     transcript?: {
         entries: Record<string, unknown>[];
@@ -177,8 +177,8 @@ export declare const agentForensicPayloadSchema: z.ZodObject<{
         redactionStatus: "sanitized" | "partially-redacted" | "withheld";
     } | undefined;
 }, {
-    contract: "treeseed.agent-forensic-payload/v1";
     activity: AgentActivityEvent;
+    contract: "treeseed.agent-forensic-payload/v1";
     payload?: Record<string, unknown> | undefined;
     diagnostics?: {
         code: string;

package/dist/content/validation/content-model-schemas.d.ts

@@ -2090,7 +2090,7 @@ declare const schemas: {
         related_books?: string[] | undefined;
         primary_contributor?: string | undefined;
         related_notes?: string[] | undefined;
-        decision_type?: "approved" | "rejected" | "deferred" | "superseded" | "request_changes" | undefined;
+        decision_type?: "approved" | "rejected" | "superseded" | "deferred" | "request_changes" | undefined;
         rationale?: string | undefined;
     }, {
         title: string;
@@ -2108,7 +2108,7 @@ declare const schemas: {
         related_books?: string[] | undefined;
         primary_contributor?: string | undefined;
         related_notes?: string[] | undefined;
-        decision_type?: "approved" | "rejected" | "deferred" | "superseded" | "request_changes" | undefined;
+        decision_type?: "approved" | "rejected" | "superseded" | "deferred" | "request_changes" | undefined;
         rationale?: string | undefined;
     }>;
     book: z.ZodObject<{
@@ -11915,7 +11915,7 @@ export declare function validateContentFrontmatter(model: PortableContentModel,
         related_books?: string[] | undefined;
         primary_contributor?: string | undefined;
         related_notes?: string[] | undefined;
-        decision_type?: "approved" | "rejected" | "deferred" | "superseded" | "request_changes" | undefined;
+        decision_type?: "approved" | "rejected" | "superseded" | "deferred" | "request_changes" | undefined;
         rationale?: string | undefined;
     } | {
         status: "review" | "archived" | "draft" | "published";
@@ -21630,7 +21630,7 @@ export declare function describeContentFrontmatterSchema(model: PortableContentM
     related_books?: string[] | undefined;
     primary_contributor?: string | undefined;
     related_notes?: string[] | undefined;
-    decision_type?: "approved" | "rejected" | "deferred" | "superseded" | "request_changes" | undefined;
+    decision_type?: "approved" | "rejected" | "superseded" | "deferred" | "request_changes" | undefined;
     rationale?: string | undefined;
 }, {
     title: string;
@@ -21648,7 +21648,7 @@ export declare function describeContentFrontmatterSchema(model: PortableContentM
     related_books?: string[] | undefined;
     primary_contributor?: string | undefined;
     related_notes?: string[] | undefined;
-    decision_type?: "approved" | "rejected" | "deferred" | "superseded" | "request_changes" | undefined;
+    decision_type?: "approved" | "rejected" | "superseded" | "deferred" | "request_changes" | undefined;
     rationale?: string | undefined;
 }> | z.ZodObject<{
     schemaVersion: z.ZodLiteral<"treeseed.book/v2">;

package/dist/content/validation/portable-content-data.d.ts

@@ -2001,7 +2001,7 @@ export declare function validatePortableContentData(model: string, value: unknow
         related_books?: string[] | undefined;
         primary_contributor?: string | undefined;
         related_notes?: string[] | undefined;
-        decision_type?: "approved" | "rejected" | "deferred" | "superseded" | "request_changes" | undefined;
+        decision_type?: "approved" | "rejected" | "superseded" | "deferred" | "request_changes" | undefined;
         rationale?: string | undefined;
     } | {
         status: "review" | "archived" | "draft" | "published";

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

@@ -1,6 +1,8 @@
 import { commandPaths } from "./catalog/infrastructure/command-tree-paths.js";
 import { managedSecretCommands } from "./catalog/services/secret-commands.js";
 import { identityLoginCommand } from "./catalog/services/identity-commands.js";
+import { WORKDAY_PROFILE_COMMAND_BINDINGS } from "./catalog/workdays/profile-commands.js";
+import { WORKDAY_PLAN_OPTIONS, WORKDAY_SELECTION_INPUTS } from "./catalog/workdays/selection-commands.js";
 import { hostProviderEnvironmentBranch, PROVIDER_ENVIRONMENT_COMMAND_BINDINGS, providerEnvironmentBranches } from "./catalog/provider-environment-commands.js";
 const unavailable = (reason = "This capability is not enabled until its control-plane operation is accepted.") => ({
   kind: "unavailable",
@@ -131,7 +133,8 @@ const operationBindings = {
   "seeds verify": operation("seeds.verify", [field("path", "name", "argument", "seed", true)]),
   "plans list": operation("plans.list", [field("path", "decisionId", "option", "decision", true), ...page()]),
   "plans show": operation("plans.show", [field("path", "capacityPlanId", "argument", "plan", true)]),
-  "workdays plan": operation("workdays.plan", [field("path", "teamId", "context", "team", true), field("body", "profileId", "option", "profile"), field("body", "projects", "option", "projects", false, "csv"), field("body", "startsAt", "option", "start"), field("body", "endsAt", "option", "end"), field("body", "durationSeconds", "option", "duration", false, "integer"), field("body", "objectiveFilters", "option", "objective", false, "csv")]),
+  "workdays plan": operation("workdays.plan", [field("path", "teamId", "context", "team", true), field("body", "profileId", "option", "profile"), field("body", "projects", "option", "projects", false, "csv"), field("body", "startsAt", "option", "start"), field("body", "endsAt", "option", "end"), field("body", "durationSeconds", "option", "duration", false, "integer"), field("body", "objectiveFilters", "option", "objective", false, "csv"), ...WORKDAY_SELECTION_INPUTS]),
+  ...WORKDAY_PROFILE_COMMAND_BINDINGS,
   "workdays start": operation("workdays.start", [field("path", "teamId", "context", "team", true), field("body", "preflightId", "option", "preflight", true), field("body", "preflightDigest", "option", "digest", true)]),
   "workdays list": operation("workdays.list", [field("path", "teamId", "context", "team", true), ...page()]),
   "workdays show": operation("workdays.show", [field("path", "teamId", "context", "team", true), field("path", "runId", "argument", "workday", true)]),
@@ -454,8 +457,8 @@ const commandTree = {
     branch("capacity", [leaf("status"), leaf("explain"), leaf("usage"), leaf("ledger"), leaf("audit")]),
     branch("plans", [leaf("list"), leaf("show", "read", "plan"), leaf("explain", "read", "plan"), { nodeType: "leaf", segment: "diff", description: "Compare two API-derived plans.", kind: "read", arguments: [{ name: "left", description: "Left plan identity.", required: true }, { name: "right", description: "Right plan identity.", required: true }], resultSchemaId: "treeseed.command.plans.diff/v1", execution: unavailable() }]),
     branch("workdays", [
-      branch("profiles", [leaf("list"), leaf("show", "read", "profile"), leaf("validate", "read", "file")]),
-      leaf("plan", "mutation"),
+      branch("profiles", [leaf("list"), leaf("show", "read", "profile"), leaf("reconcile", "mutation", "project", "authority"), leaf("validate", "read", "file")]),
+      { ...leaf("plan", "mutation"), nodeType: "leaf", segment: "plan", kind: "mutation", description: "Plan a workday with optional targeted cooperative planning; acting stays decision-governed.", resultSchemaId: "treeseed.command.workdays.plan/v1", options: WORKDAY_PLAN_OPTIONS },
       leaf("start", "mutation", void 0, "authority"),
       leaf("list"),
       leaf("show", "read", "workday"),

package/dist/operator-contracts/catalog/workdays/profile-commands.d.ts

@@ -0,0 +1,4 @@
+import type { CommandLeafDescriptor } from '../../command-tree.js';
+type Execution = CommandLeafDescriptor['execution'];
+export declare const WORKDAY_PROFILE_COMMAND_BINDINGS: Record<string, Execution>;
+export {};

package/dist/operator-contracts/catalog/workdays/profile-commands.js

@@ -0,0 +1,20 @@
+const team = { target: "path", field: "teamId", source: "context", name: "team", required: true, transform: "identity" };
+const WORKDAY_PROFILE_COMMAND_BINDINGS = {
+  "workdays profiles list": { kind: "operation", operationId: "workdays.profiles.list", input: [
+    team,
+    { target: "query", field: "limit", source: "option", name: "limit", transform: "integer" },
+    { target: "query", field: "cursor", source: "option", name: "cursor", transform: "identity" },
+    { target: "query", field: "status", source: "option", name: "status", transform: "identity" }
+  ] },
+  "workdays profiles show": { kind: "operation", operationId: "workdays.profiles.show", input: [
+    team,
+    { target: "path", field: "profileId", source: "argument", name: "profile", required: true, transform: "identity" }
+  ] },
+  "workdays profiles reconcile": { kind: "operation", operationId: "workdays.profiles.reconcile", input: [
+    team,
+    { target: "path", field: "projectId", source: "argument", name: "project", required: true, transform: "identity" }
+  ] }
+};
+export {
+  WORKDAY_PROFILE_COMMAND_BINDINGS
+};

package/dist/operator-contracts/catalog/workdays/profile-operations.d.ts

@@ -0,0 +1,16 @@
+export declare const WORKDAY_PROFILE_OPERATIONS: {
+    profilesList: import("../../control-plane-operation.js").ControlPlaneOperationBinding<{
+        [x: string]: any;
+    }, {
+        [x: string]: any;
+    }, undefined, Record<string, unknown>>;
+    profilesShow: import("../../control-plane-operation.js").ControlPlaneOperationBinding<{
+        [x: string]: any;
+    }, {
+        [x: string]: any;
+    }, undefined, Record<string, unknown>>;
+    profilesReconcile: import("../../control-plane-operation.js").ControlPlaneOperationBinding<{
+        projectId: string;
+        teamId: string;
+    }, {}, {}, Record<string, unknown>>;
+};

package/dist/operator-contracts/catalog/workdays/profile-operations.js

@@ -0,0 +1,48 @@
+import { z } from "zod";
+import { defineOperation } from "../../operation-builder.js";
+const team = z.object({ teamId: z.string().min(1) }).strict();
+const empty = z.object({}).strict();
+const output = z.record(z.unknown());
+const read = (operationId, path, parameters, query, pagination) => defineOperation({
+  operationId,
+  description: "Read accepted repository workday profile generations.",
+  rest: { method: "GET", path },
+  parameters: `treeseed.${operationId}.parameters/v1`,
+  capability: "workdays.read",
+  authentication: "oauth",
+  oauthScopes: ["treeseed:read"],
+  kind: "read",
+  riskClass: "ordinary",
+  confirmation: "never",
+  surfaces: ["rest", "cli"],
+  cacheScope: "principal",
+  pagination
+}, { path: parameters, query, body: z.undefined(), output });
+const WORKDAY_PROFILE_OPERATIONS = {
+  profilesList: read(
+    "workdays.profiles.list",
+    "/v1/teams/{teamId}/workday-profiles",
+    team,
+    z.object({ limit: z.coerce.number().int().min(1).max(100).optional(), cursor: z.string().optional(), status: z.enum(["active", "archived", "superseded"]).optional() }).strict(),
+    "cursor"
+  ),
+  profilesShow: read("workdays.profiles.show", "/v1/teams/{teamId}/workday-profiles/{profileId}", team.extend({ profileId: z.string().min(1) }), empty, "none"),
+  profilesReconcile: defineOperation({
+    operationId: "workdays.profiles.reconcile",
+    description: "Reconcile a bound repository profile after exact successful source verification.",
+    rest: { method: "POST", path: "/v1/teams/{teamId}/projects/{projectId}/workday-profiles/reconcile" },
+    parameters: "treeseed.workdays.profiles.reconcile.parameters/v1",
+    capability: "workdays.execute",
+    authentication: "oauth",
+    oauthScopes: ["treeseed:execution"],
+    kind: "mutation",
+    riskClass: "authority",
+    confirmation: "input_required",
+    surfaces: ["rest", "cli"],
+    cacheScope: "none",
+    pagination: "none"
+  }, { path: team.extend({ projectId: z.string().min(1) }), query: empty, body: empty, output })
+};
+export {
+  WORKDAY_PROFILE_OPERATIONS
+};

package/dist/operator-contracts/catalog/workdays/selection-commands.d.ts

@@ -0,0 +1,3 @@
+import type { CommandInputBinding, CommandLeafDescriptor } from '../../command-tree.js';
+export declare const WORKDAY_SELECTION_INPUTS: CommandInputBinding[];
+export declare const WORKDAY_PLAN_OPTIONS: NonNullable<CommandLeafDescriptor['options']>;

package/dist/operator-contracts/catalog/workdays/selection-commands.js

@@ -0,0 +1,15 @@
+const WORKDAY_SELECTION_INPUTS = [
+  { target: "body", field: "agentSelection.agentSlugs", source: "option", name: "agent", transform: "csv" },
+  { target: "body", field: "agentSelection.activityTypes", source: "option", name: "activity", transform: "csv" },
+  { target: "body", field: "agentSelection.classSlugs", source: "option", name: "class", transform: "csv" }
+];
+const WORKDAY_PLAN_OPTIONS = [
+  { name: "--plan", description: "Return the request without creating a preflight.", type: "boolean" },
+  { name: "--agent", description: "Planning agent slug; repeat or comma-separate. Intersects with class/activity selectors.", type: "string[]" },
+  { name: "--activity", description: "Planning activity: planning, estimating, reviewing, reporting, or chat; repeat or comma-separate.", type: "string[]" },
+  { name: "--class", description: "Planning class slug; repeat or comma-separate. Acting remains governed by accepted decisions.", type: "string[]" }
+];
+export {
+  WORKDAY_PLAN_OPTIONS,
+  WORKDAY_SELECTION_INPUTS
+};

package/dist/operator-contracts/command-tree.d.ts

@@ -23,6 +23,7 @@ export interface CommandAuthorizationDescriptor {
 export type CommandInputSource = 'argument' | 'context' | 'option';
 export type CommandInputTarget = 'path' | 'query' | 'body';
 export interface CommandInputBinding {
+    /** Dot-separated object path in the selected target; unsafe prototype keys are forbidden. */
     field: string;
     source: CommandInputSource;
     name: string;

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

@@ -2004,6 +2004,20 @@ export declare const CONTROL_PLANE_OPERATIONS: {
             teamId: string;
             scheduleId: string;
         }, {}, Record<string, unknown> | undefined, Record<string, unknown>>;
+        readonly profilesList: import("./control-plane-operation.js").ControlPlaneOperationBinding<{
+            [x: string]: any;
+        }, {
+            [x: string]: any;
+        }, undefined, Record<string, unknown>>;
+        readonly profilesShow: import("./control-plane-operation.js").ControlPlaneOperationBinding<{
+            [x: string]: any;
+        }, {
+            [x: string]: any;
+        }, undefined, Record<string, unknown>>;
+        readonly profilesReconcile: import("./control-plane-operation.js").ControlPlaneOperationBinding<{
+            projectId: string;
+            teamId: string;
+        }, {}, {}, Record<string, unknown>>;
     };
     readonly assignments: {
         readonly list: import("./control-plane-operation.js").ControlPlaneOperationBinding<{

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

@@ -2,6 +2,7 @@ import { z } from "zod";
 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 { WORKDAY_PROFILE_OPERATIONS } from "./catalog/workdays/profile-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";
@@ -305,6 +306,7 @@ const CONTROL_PLANE_OPERATIONS = {
     show: resource("plans.show", "GET", "/v1/capacity-plans/{capacityPlanId}", { capacityPlanId: z.string().min(1) }, { capability: "plans.read", surfaces: ["rest", "cli", "mcp_resource"] })
   },
   workdays: {
+    ...WORKDAY_PROFILE_OPERATIONS,
     list: resource("workdays.list", "GET", "/v1/teams/{teamId}/workday-runs", { teamId: z.string().min(1) }, { capability: "workdays.read", surfaces: ["rest", "cli", "mcp_tool"], pagination: "cursor" }),
     preflight: resource("workdays.plan", "POST", "/v1/teams/{teamId}/workday-runs/preflight", { teamId: z.string().min(1) }, { capability: "workdays.execute", scopes: ["treeseed:execution"], surfaces: ["rest", "cli", "mcp_tool"] }),
     start: resource("workdays.start", "POST", "/v1/teams/{teamId}/workday-runs", { teamId: z.string().min(1) }, { capability: "workdays.execute", scopes: ["treeseed:execution"], surfaces: ["rest", "cli", "mcp_tool"], risk: "authority" }),

package/dist/operator-contracts/workday-lifecycle.d.ts

@@ -1,4 +1,6 @@
 import { type WorkdayBorrowingEvidence } from './workday-profile.js';
+import type { WorkdayAgentSelection } from '../agent-capacity/workday.js';
+export { normalizeWorkdayAgentSelection } from '../agent-capacity/workday.js';
 export type WorkdayDemandMode = 'planning' | 'acting';
 export interface WorkdayIntent {
     schemaVersion: 'treeseed.workday-intent/v1';
@@ -9,6 +11,8 @@ export interface WorkdayIntent {
     endsAt?: string;
     durationSeconds?: number;
     objectiveFilters?: string[];
+    /** Limits cooperative planning; acting still requires accepted decision/estimate authority. */
+    agentSelection?: Partial<WorkdayAgentSelection>;
     operatorConstraints?: {
         providerIds?: string[];
         maxConcurrency?: number;
@@ -151,6 +155,7 @@ export interface WorkdayLifecycleDiagnostic {
     message: string;
 }
 export declare function validateWorkdayIntent(intent: WorkdayIntent): WorkdayLifecycleDiagnostic[];
+export declare function validateWorkdayIntentSelection(value: unknown): WorkdayLifecycleDiagnostic[];
 export declare function validateSelectedDemand(demand: WorkdaySelectedDemand): WorkdayLifecycleDiagnostic[];
 export declare function validateWorkdayPreflight(receipt: WorkdayPreflightReceipt, now?: Date): WorkdayLifecycleDiagnostic[];
 export declare function validateWorkdayPreflightFreshness(receipt: WorkdayPreflightReceipt, observed: WorkdayPreflightObservation): WorkdayLifecycleDiagnostic[];

package/dist/operator-contracts/workday-lifecycle.js

@@ -1,4 +1,5 @@
 import { validateWorkdayBorrowingEvidence } from "./workday-profile.js";
+import { normalizeWorkdayAgentSelection } from "../agent-capacity/workday.js";
 function validateWorkdayIntent(intent) {
   const diagnostics = [];
   if (intent.schemaVersion !== "treeseed.workday-intent/v1") diagnostics.push({ code: "schema_version_invalid", path: "schemaVersion", message: "Unsupported workday intent schema." });
@@ -9,6 +10,28 @@ function validateWorkdayIntent(intent) {
   if (!Number.isFinite(start)) diagnostics.push({ code: "start_invalid", path: "startsAt", message: "startsAt must be an ISO timestamp." });
   if (intent.endsAt !== void 0 && (!Number.isFinite(Date.parse(intent.endsAt)) || Date.parse(intent.endsAt) <= start)) diagnostics.push({ code: "end_invalid", path: "endsAt", message: "endsAt must be a valid timestamp after startsAt." });
   if (intent.durationSeconds !== void 0 && (!Number.isInteger(intent.durationSeconds) || intent.durationSeconds <= 0)) diagnostics.push({ code: "duration_invalid", path: "durationSeconds", message: "durationSeconds must be a positive integer." });
+  if (intent.agentSelection !== void 0) diagnostics.push(...validateWorkdayIntentSelection(intent.agentSelection));
+  return diagnostics;
+}
+function validateWorkdayIntentSelection(value) {
+  const invalid = (path, message) => ({ code: "agent_selection_invalid", path: `agentSelection${path ? `.${path}` : ""}`, message });
+  if (!value || typeof value !== "object" || Array.isArray(value)) return [invalid("", "Agent selection must be an object.")];
+  const selection = value, diagnostics = [];
+  const fields = ["classIds", "classSlugs", "agentSlugs", "activityTypes"];
+  for (const key of Object.keys(selection)) if (![...fields, "mode"].includes(key)) diagnostics.push(invalid(key, "Unknown selection field."));
+  if (selection.mode !== void 0 && !["intersection", "union"].includes(String(selection.mode))) diagnostics.push(invalid("mode", "Select intersection or union."));
+  let selected = 0;
+  for (const field of fields) {
+    const entries = selection[field];
+    if (entries === void 0) continue;
+    if (!Array.isArray(entries) || entries.length > 128 || entries.some((entry) => typeof entry !== "string" || !entry.trim() || entry.length > 128)) {
+      diagnostics.push(invalid(field, "Selectors must be a bounded array of nonempty strings."));
+      continue;
+    }
+    selected += entries.length;
+    if (field === "activityTypes" && entries.some((entry) => !["planning", "estimating", "reviewing", "reporting", "chat"].includes(String(entry).trim()))) diagnostics.push(invalid(field, "Select a planning activity; acting is controlled by accepted decisions and estimates."));
+  }
+  if (!selected) diagnostics.push(invalid("", "Explicit selection must select an agent, class, or activity; omit it to select all."));
   return diagnostics;
 }
 function validateSelectedDemand(demand) {
@@ -57,8 +80,10 @@ function validateWorkdaySettlement(settlement) {
   return diagnostics;
 }
 export {
+  normalizeWorkdayAgentSelection,
   validateSelectedDemand,
   validateWorkdayIntent,
+  validateWorkdayIntentSelection,
   validateWorkdayPreflight,
   validateWorkdayPreflightFreshness,
   validateWorkdaySettlement

package/package.json

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