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

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

@@ -0,0 +1,134 @@
+import { z } from "zod";
+const inboxItemKindSchema = z.enum(["proposal", "question"]);
+const inboxItemStatusSchema = z.enum(["outstanding", "answered", "approved", "rejected", "closed", "deleted"]);
+const inboxActionKindSchema = z.enum(["publish_revision", "approve", "reject", "comment", "answer", "reply", "reopen"]);
+const inboxProvenanceSchema = z.object({
+  repositoryId: z.string().nullable(),
+  contentPath: z.string().nullable(),
+  commitSha: z.string().nullable(),
+  digest: z.string().nullable()
+}).strict();
+const inboxActionDescriptorSchema = z.object({
+  action: inboxActionKindSchema,
+  label: z.string(),
+  enabled: z.boolean(),
+  reason: z.string().nullable(),
+  requiresFeedback: z.boolean(),
+  confirmation: z.enum(["never", "input_required"])
+}).strict();
+const inboxCommentSchema = z.object({
+  id: z.string(),
+  parentId: z.string().nullable(),
+  kind: z.enum(["comment", "answer", "reply"]),
+  authorId: z.string(),
+  authorLabel: z.string(),
+  markdown: z.string(),
+  createdAt: z.string().datetime(),
+  provenance: inboxProvenanceSchema
+}).strict();
+const inboxItemSchema = z.object({
+  schemaVersion: z.literal("treeseed.inbox-item/v1"),
+  id: z.string(),
+  teamId: z.string(),
+  projectId: z.string(),
+  projectSlug: z.string(),
+  kind: inboxItemKindSchema,
+  title: z.string(),
+  markdown: z.string(),
+  status: inboxItemStatusSchema,
+  authorId: z.string(),
+  authorLabel: z.string(),
+  version: z.number().int().positive(),
+  discussionId: z.string().nullable(),
+  createdAt: z.string().datetime(),
+  updatedAt: z.string().datetime(),
+  provenance: inboxProvenanceSchema,
+  availableActions: z.array(inboxActionDescriptorSchema),
+  comments: z.array(inboxCommentSchema),
+  etag: z.string()
+}).strict();
+const inboxItemSummarySchema = inboxItemSchema.pick({
+  id: true,
+  teamId: true,
+  projectId: true,
+  projectSlug: true,
+  kind: true,
+  title: true,
+  status: true,
+  authorId: true,
+  authorLabel: true,
+  version: true,
+  createdAt: true,
+  updatedAt: true,
+  etag: true
+});
+const inboxItemPageSchema = z.object({
+  schemaVersion: z.literal("treeseed.inbox-page/v1"),
+  items: z.array(inboxItemSummarySchema),
+  cursor: z.string().nullable()
+}).strict();
+const inboxEventSchema = z.object({
+  schemaVersion: z.literal("treeseed.inbox-event/v1"),
+  sequence: z.string(),
+  id: z.string(),
+  teamId: z.string(),
+  itemId: z.string().nullable(),
+  type: z.enum(["item.created", "item.updated", "item.deleted", "draft.updated", "comment.created", "question.answered", "question.reopened", "proposal.revised", "proposal.decided"]),
+  actorId: z.string(),
+  occurredAt: z.string().datetime(),
+  summary: z.string(),
+  payload: z.record(z.unknown())
+}).strict();
+const inboxTimelineSchema = z.object({ events: z.array(inboxEventSchema), cursor: z.string() }).strict();
+const inboxDraftPurposeSchema = z.enum(["feedback", "proposal_revision"]);
+const inboxDraftSchema = z.object({
+  schemaVersion: z.literal("treeseed.inbox-draft/v1"),
+  itemId: z.string(),
+  purpose: inboxDraftPurposeSchema,
+  markdown: z.string(),
+  baseVersion: z.number().int().positive(),
+  revision: z.number().int().nonnegative(),
+  updatedAt: z.string().datetime(),
+  etag: z.string()
+}).strict();
+const inboxDraftWriteSchema = z.object({ markdown: z.string().max(1e5), baseVersion: z.number().int().positive() }).strict();
+const inboxQuestionCreateSchema = z.object({
+  projectId: z.string(),
+  title: z.string().trim().min(1).max(180),
+  markdown: z.string().trim().min(1).max(1e5),
+  recipients: z.array(z.string()).max(64).default([]),
+  relatedObjectives: z.array(z.string()).max(64).default([])
+}).strict();
+const inboxActionRequestSchema = z.object({
+  action: inboxActionKindSchema,
+  markdown: z.string().max(1e5).optional(),
+  parentId: z.string().optional(),
+  changeReason: z.string().max(2e3).optional(),
+  draftRevision: z.number().int().nonnegative().optional()
+}).strict();
+const inboxMutationReceiptSchema = z.object({
+  schemaVersion: z.literal("treeseed.inbox-mutation-receipt/v1"),
+  item: inboxItemSchema,
+  action: inboxActionKindSchema.optional(),
+  replayed: z.boolean(),
+  receipts: z.array(z.record(z.unknown())).default([])
+}).strict();
+export {
+  inboxActionDescriptorSchema,
+  inboxActionKindSchema,
+  inboxActionRequestSchema,
+  inboxCommentSchema,
+  inboxDraftPurposeSchema,
+  inboxDraftSchema,
+  inboxDraftWriteSchema,
+  inboxEventSchema,
+  inboxItemKindSchema,
+  inboxItemPageSchema,
+  inboxItemSchema,
+  inboxItemStatusSchema,
+  inboxItemSummarySchema,
+  inboxMutationReceiptSchema,
+  inboxProvenanceSchema,
+  inboxQuestionCreateSchema,
+  inboxTimelineSchema
+};

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

@@ -8,4 +8,5 @@ export * from './mcp.js';
 export * from './oauth.js';
 export * from './communication/contracts.js';
 export * from './communication/addressing.js';
+export * from './inbox/contracts.js';
 export * from './seed/seed-bundle.js';

package/dist/operator-contracts/index.js

@@ -8,4 +8,5 @@ export * from "./mcp.js";
 export * from "./oauth.js";
 export * from "./communication/contracts.js";
 export * from "./communication/addressing.js";
+export * from "./inbox/contracts.js";
 export * from "./seed/seed-bundle.js";

package/dist/operator-contracts/mcp.js

@@ -10,7 +10,7 @@ const TREESEED_MCP_PROMPTS = [
   { name: "research", description: "Research a governed TreeSeed question and accumulate knowledge.", argumentSchemaId: "treeseed.prompt.objective/v1", requiredScopes: ["treeseed:read"] },
   { name: "governance-review", description: "Review a proposal or decision using current governance evidence.", argumentSchemaId: "treeseed.prompt.objective/v1", requiredScopes: ["treeseed:read"] },
   { name: "workday-planning", description: "Plan a time-based workday without bypassing API authority.", argumentSchemaId: "treeseed.prompt.objective/v1", requiredScopes: ["treeseed:read"] },
-  { name: "project-agent-chat", description: "Prepare an explicit governed project-agent chat invocation.", argumentSchemaId: "treeseed.prompt.objective/v1", requiredScopes: ["treeseed:read"] }
+  { name: "project-agent-chat", description: "Prepare an explicit governed team-topic chat invocation for project agents.", argumentSchemaId: "treeseed.prompt.objective/v1", requiredScopes: ["treeseed:read"] }
 ];
 function resourcePath(restPath) {
   const [root, version, ...segments] = restPath.split("/");

package/package.json

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