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

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

@@ -1 +1 @@
-{"completedAt":"2026-09-11T06:25:55.931Z"}
+{"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/operator-contracts/canonical-command-tree.js

@@ -2,6 +2,7 @@ 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",
@@ -132,7 +133,7 @@ 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()]),
@@ -457,7 +458,7 @@ const commandTree = {
     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("reconcile", "mutation", "project", "authority"), leaf("validate", "read", "file")]),
-      leaf("plan", "mutation"),
+      { ...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/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/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.116",
+  "version": "0.13.0-rc.117",
   "description": "Portable TreeSeed contracts, standards, and typed remote control-plane clients.",
   "license": "Apache-2.0",
   "repository": {