@treeseed/sdk 0.13.0-rc.36 → 0.13.0-rc.38

package/dist/operator-contracts/communication/contracts.js

@@ -5,52 +5,84 @@ const communicationRecipientSchema = z.object({
 }).strict();
 const communicationSendRequestSchema = z.object({
   message: z.string().trim().min(1).max(1e5),
-  topic: z.string().trim().min(1).max(240).optional(),
-  projectId: z.string().min(1).optional(),
+  projectId: z.string().min(1),
   recipients: z.array(z.string().trim().min(1)).max(100).optional(),
-  waitSeconds: z.number().int().min(0).max(3600).optional()
+  timeoutSeconds: z.number().int().min(1).max(3600).optional()
 }).strict();
 const communicationTargetSchema = communicationRecipientSchema.extend({
   projectSlug: z.string().min(1),
   definitionRevision: z.string().min(1),
+  revisions: z.object({
+    project: z.string().min(1),
+    library: z.string().min(1),
+    agentDefinition: z.string().min(1),
+    chatProfile: z.string().min(1)
+  }).strict(),
   invocationId: z.string().min(1).nullable(),
-  status: z.enum(["queued", "running", "responded", "failed", "cancelled"])
+  requirement: z.enum(["required", "optional"]),
+  parentInvocationId: z.string().min(1).nullable(),
+  depth: z.number().int().nonnegative(),
+  status: z.enum(["queued", "running", "responded", "abstained", "failed", "cancelled"]),
+  requestedAt: z.string().datetime(),
+  updatedAt: z.string().datetime(),
+  completedAt: z.string().datetime().nullable(),
+  failure: z.object({ code: z.string().min(1), message: z.string().nullable() }).strict().nullable(),
+  capacity: z.object({
+    assignmentId: z.string().min(1).nullable(),
+    providerId: z.string().min(1).nullable(),
+    executionProviderId: z.string().min(1).nullable(),
+    laneId: z.string().min(1).nullable(),
+    lanePurpose: z.string().min(1).nullable(),
+    status: z.string().min(1).nullable(),
+    assignedAt: z.string().datetime().nullable(),
+    claimedAt: z.string().datetime().nullable(),
+    completedAt: z.string().datetime().nullable(),
+    returnedAt: z.string().datetime().nullable(),
+    failedAt: z.string().datetime().nullable()
+  }).strict()
 });
 const communicationResponseSchema = communicationRecipientSchema.extend({
   invocationId: z.string().min(1),
   assignmentId: z.string().min(1).nullable(),
   messageRef: z.string().min(1),
   markdown: z.string(),
-  status: z.enum(["responded", "failed", "cancelled"]),
+  requirement: z.enum(["required", "optional"]),
+  status: z.enum(["responded", "abstained", "failed", "cancelled"]),
   createdAt: z.string().datetime()
 });
 const communicationSendReceiptSchema = z.object({
-  schemaVersion: z.literal("treeseed.communication-send-receipt/v1"),
+  schemaVersion: z.literal("treeseed.communication-send-receipt/v2"),
   sendId: z.string().min(1),
   teamId: z.string().min(1),
   channel: z.string().min(1),
-  topic: z.string().nullable(),
+  topic: z.object({ id: z.string().min(1), slug: z.string().min(1) }).strict(),
+  projectStream: z.object({ id: z.string().min(1), projectId: z.string().min(1), projectSlug: z.string().min(1) }).strict(),
   discussionId: z.string().min(1),
   messageRef: z.string().min(1),
+  sourceMessage: z.string(),
   status: z.enum(["queued", "running", "complete", "partial", "failed"]),
   targets: z.array(communicationTargetSchema),
   responses: z.array(communicationResponseSchema),
   createdAt: z.string().datetime(),
-  updatedAt: z.string().datetime()
+  updatedAt: z.string().datetime(),
+  replayed: z.boolean()
 }).strict();
 const providerDiscussionResponseRequestSchema = z.object({
   leaseToken: z.string().min(1),
   runnerId: z.string().min(1),
-  markdown: z.string().trim().min(1).max(1e5),
+  outcome: z.enum(["responded", "abstained"]).default("responded"),
+  markdown: z.string().trim().min(1).max(1e5).optional(),
   summary: z.string().trim().min(1).max(4e3).optional(),
   usage: z.record(z.unknown()).optional()
-}).strict();
+}).strict().superRefine((value, context) => {
+  if (value.outcome === "responded" && !value.markdown) context.addIssue({ code: z.ZodIssueCode.custom, path: ["markdown"], message: "A response requires Markdown." });
+});
 const providerDiscussionResponseReceiptSchema = z.object({
   schemaVersion: z.literal("treeseed.provider-discussion-response-receipt/v1"),
   assignmentId: z.string().min(1),
   invocationId: z.string().min(1),
   messageRef: z.string().min(1),
-  status: z.literal("responded"),
+  status: z.enum(["responded", "abstained"]),
   settledAt: z.string().datetime()
 }).strict();
 export {

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

@@ -466,72 +466,151 @@ export declare const CONTROL_PLANE_OPERATIONS: {
             channel: string;
         }, {}, {
             message: string;
-            projectId?: string | undefined;
+            projectId: string;
+            timeoutSeconds?: number | undefined;
             recipients?: string[] | undefined;
-            topic?: string | undefined;
-            waitSeconds?: number | undefined;
         }, {
             status: "partial" | "failed" | "complete" | "running" | "queued";
-            schemaVersion: "treeseed.communication-send-receipt/v1";
+            schemaVersion: "treeseed.communication-send-receipt/v2";
             createdAt: string;
             responses: {
-                status: "failed" | "cancelled" | "responded";
+                status: "failed" | "cancelled" | "responded" | "abstained";
                 createdAt: string;
                 projectId: string;
                 agentSlug: string;
                 assignmentId: string | null;
                 invocationId: string;
+                requirement: "required" | "optional";
                 messageRef: string;
                 markdown: string;
             }[];
             teamId: string;
             channel: string;
-            topic: string | null;
+            updatedAt: string;
             messageRef: string;
             sendId: string;
+            topic: {
+                id: string;
+                slug: string;
+            };
+            projectStream: {
+                id: string;
+                projectId: string;
+                projectSlug: string;
+            };
             discussionId: string;
+            sourceMessage: string;
             targets: {
-                status: "failed" | "running" | "cancelled" | "queued" | "responded";
+                status: "failed" | "running" | "cancelled" | "queued" | "responded" | "abstained";
+                completedAt: string | null;
                 projectId: string;
                 agentSlug: string;
+                capacity: {
+                    status: string | null;
+                    completedAt: string | null;
+                    providerId: string | null;
+                    assignmentId: string | null;
+                    executionProviderId: string | null;
+                    laneId: string | null;
+                    lanePurpose: string | null;
+                    assignedAt: string | null;
+                    claimedAt: string | null;
+                    returnedAt: string | null;
+                    failedAt: string | null;
+                };
                 projectSlug: string;
                 definitionRevision: string;
+                revisions: {
+                    project: string;
+                    library: string;
+                    agentDefinition: string;
+                    chatProfile: string;
+                };
                 invocationId: string | null;
+                requirement: "required" | "optional";
+                parentInvocationId: string | null;
+                depth: number;
+                requestedAt: string;
+                updatedAt: string;
+                failure: {
+                    code: string;
+                    message: string | null;
+                } | null;
             }[];
-            updatedAt: string;
+            replayed: boolean;
         }>;
         readonly sendStatus: ControlPlaneOperationBinding<{
             teamId: string;
             sendId: string;
         }, {}, undefined, {
             status: "partial" | "failed" | "complete" | "running" | "queued";
-            schemaVersion: "treeseed.communication-send-receipt/v1";
+            schemaVersion: "treeseed.communication-send-receipt/v2";
             createdAt: string;
             responses: {
-                status: "failed" | "cancelled" | "responded";
+                status: "failed" | "cancelled" | "responded" | "abstained";
                 createdAt: string;
                 projectId: string;
                 agentSlug: string;
                 assignmentId: string | null;
                 invocationId: string;
+                requirement: "required" | "optional";
                 messageRef: string;
                 markdown: string;
             }[];
             teamId: string;
             channel: string;
-            topic: string | null;
+            updatedAt: string;
             messageRef: string;
             sendId: string;
+            topic: {
+                id: string;
+                slug: string;
+            };
+            projectStream: {
+                id: string;
+                projectId: string;
+                projectSlug: string;
+            };
             discussionId: string;
+            sourceMessage: string;
             targets: {
-                status: "failed" | "running" | "cancelled" | "queued" | "responded";
+                status: "failed" | "running" | "cancelled" | "queued" | "responded" | "abstained";
+                completedAt: string | null;
                 projectId: string;
                 agentSlug: string;
+                capacity: {
+                    status: string | null;
+                    completedAt: string | null;
+                    providerId: string | null;
+                    assignmentId: string | null;
+                    executionProviderId: string | null;
+                    laneId: string | null;
+                    lanePurpose: string | null;
+                    assignedAt: string | null;
+                    claimedAt: string | null;
+                    returnedAt: string | null;
+                    failedAt: string | null;
+                };
                 projectSlug: string;
                 definitionRevision: string;
+                revisions: {
+                    project: string;
+                    library: string;
+                    agentDefinition: string;
+                    chatProfile: string;
+                };
                 invocationId: string | null;
+                requirement: "required" | "optional";
+                parentInvocationId: string | null;
+                depth: number;
+                requestedAt: string;
+                updatedAt: string;
+                failure: {
+                    code: string;
+                    message: string | null;
+                } | null;
             }[];
-            updatedAt: string;
+            replayed: boolean;
         }>;
     };
     readonly capacity: {
@@ -1068,13 +1147,14 @@ export declare const CONTROL_PLANE_OPERATIONS: {
         readonly discussionResponse: ControlPlaneOperationBinding<{
             assignmentId: string;
         }, {}, {
-            markdown: string;
             leaseToken: string;
             runnerId: string;
             summary?: string | undefined;
             usage?: Record<string, unknown> | undefined;
+            markdown?: string | undefined;
+            outcome?: "responded" | "abstained" | undefined;
         }, {
-            status: "responded";
+            status: "responded" | "abstained";
             schemaVersion: "treeseed.provider-discussion-response-receipt/v1";
             assignmentId: string;
             invocationId: string;

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

@@ -115,7 +115,7 @@ const CONTROL_PLANE_OPERATIONS = {
       surfaces: ["rest", "cli", "mcp_tool"],
       cacheScope: "principal",
       pagination: "cursor"
-    }, { path: empty, query: z.object({ teamId: z.string().min(1).optional(), limit: z.number().int().positive().max(200).optional(), cursor: z.string().min(1).optional() }).strict(), body: none, output: payload }),
+    }, { path: empty, query: z.object({ teamId: z.string().min(1).optional(), limit: z.coerce.number().int().positive().max(200).optional(), cursor: z.string().min(1).optional() }).strict(), body: none, output: payload }),
     show: resource("projects.show", "GET", "/v1/projects/{projectId}", { projectId: z.string().min(1) }, { capability: "projects.read", surfaces: ["rest", "cli", "mcp_tool", "mcp_resource"] }),
     create: resource("projects.create", "POST", "/v1/teams/{teamId}/projects", { teamId: z.string().min(1) }, { capability: "projects.write", surfaces: ["rest", "cli", "mcp_tool"] }),
     update: resource("projects.update", "PUT", "/v1/projects/{projectId}", { projectId: z.string().min(1) }, { capability: "projects.write", surfaces: ["rest", "cli", "mcp_tool"], concurrency: true }),

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

@@ -7,4 +7,5 @@ export * from './control-plane-operations.js';
 export * from './mcp.js';
 export * from './oauth.js';
 export * from './communication/contracts.js';
+export * from './communication/addressing.js';
 export * from './seed/seed-bundle.js';

package/dist/operator-contracts/index.js

@@ -7,4 +7,5 @@ export * from "./control-plane-operations.js";
 export * from "./mcp.js";
 export * from "./oauth.js";
 export * from "./communication/contracts.js";
+export * from "./communication/addressing.js";
 export * from "./seed/seed-bundle.js";

package/package.json

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