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

package/dist/operator-contracts/catalog/inbox-operations.d.ts

@@ -0,0 +1,261 @@
+export declare function inboxOperations(): {
+    list: import("../control-plane-operation.js").ControlPlaneOperationBinding<{
+        teamId: string;
+    }, {
+        kind?: "all" | "proposal" | "question" | undefined;
+        projectId?: string | undefined;
+        state?: "all" | "outstanding" | undefined;
+        cursor?: string | undefined;
+        limit?: number | undefined;
+    }, undefined, {
+        schemaVersion: "treeseed.inbox-page/v1";
+        items: {
+            status: "approved" | "rejected" | "outstanding" | "answered" | "closed" | "deleted";
+            kind: "proposal" | "question";
+            id: string;
+            projectId: string;
+            createdAt: string;
+            version: number;
+            teamId: string;
+            projectSlug: string;
+            updatedAt: string;
+            authorId: string;
+            authorLabel: string;
+            title: string;
+            etag: string;
+        }[];
+        cursor: string | null;
+    }>;
+    show: import("../control-plane-operation.js").ControlPlaneOperationBinding<{
+        teamId: string;
+        itemId: string;
+    }, {}, undefined, {
+        status: "approved" | "rejected" | "outstanding" | "answered" | "closed" | "deleted";
+        kind: "proposal" | "question";
+        id: string;
+        schemaVersion: "treeseed.inbox-item/v1";
+        projectId: string;
+        createdAt: string;
+        provenance: {
+            digest: string | null;
+            repositoryId: string | null;
+            contentPath: string | null;
+            commitSha: string | null;
+        };
+        version: number;
+        teamId: string;
+        projectSlug: string;
+        updatedAt: string;
+        markdown: string;
+        discussionId: string | null;
+        authorId: string;
+        authorLabel: string;
+        title: string;
+        availableActions: {
+            reason: string | null;
+            enabled: boolean;
+            action: "approve" | "reject" | "publish_revision" | "comment" | "answer" | "reply" | "reopen";
+            confirmation: "never" | "input_required";
+            label: string;
+            requiresFeedback: boolean;
+        }[];
+        comments: {
+            kind: "comment" | "answer" | "reply";
+            id: string;
+            createdAt: string;
+            provenance: {
+                digest: string | null;
+                repositoryId: string | null;
+                contentPath: string | null;
+                commitSha: string | null;
+            };
+            markdown: string;
+            parentId: string | null;
+            authorId: string;
+            authorLabel: string;
+        }[];
+        etag: string;
+    }>;
+    events: import("../control-plane-operation.js").ControlPlaneOperationBinding<{
+        teamId: string;
+    }, {
+        limit?: number | undefined;
+        after?: string | undefined;
+        waitSeconds?: number | undefined;
+    }, undefined, {
+        cursor: string;
+        events: {
+            type: "item.created" | "item.updated" | "item.deleted" | "draft.updated" | "comment.created" | "question.answered" | "question.reopened" | "proposal.revised" | "proposal.decided";
+            id: string;
+            schemaVersion: "treeseed.inbox-event/v1";
+            summary: string;
+            teamId: string;
+            sequence: string;
+            occurredAt: string;
+            payload: Record<string, unknown>;
+            itemId: string | null;
+            actorId: string;
+        }[];
+    }>;
+    createQuestion: import("../control-plane-operation.js").ControlPlaneOperationBinding<{
+        teamId: string;
+    }, {}, {
+        projectId: string;
+        markdown: string;
+        title: string;
+        recipients?: string[] | undefined;
+        relatedObjectives?: string[] | undefined;
+    }, {
+        schemaVersion: "treeseed.inbox-mutation-receipt/v1";
+        replayed: boolean;
+        item: {
+            status: "approved" | "rejected" | "outstanding" | "answered" | "closed" | "deleted";
+            kind: "proposal" | "question";
+            id: string;
+            schemaVersion: "treeseed.inbox-item/v1";
+            projectId: string;
+            createdAt: string;
+            provenance: {
+                digest: string | null;
+                repositoryId: string | null;
+                contentPath: string | null;
+                commitSha: string | null;
+            };
+            version: number;
+            teamId: string;
+            projectSlug: string;
+            updatedAt: string;
+            markdown: string;
+            discussionId: string | null;
+            authorId: string;
+            authorLabel: string;
+            title: string;
+            availableActions: {
+                reason: string | null;
+                enabled: boolean;
+                action: "approve" | "reject" | "publish_revision" | "comment" | "answer" | "reply" | "reopen";
+                confirmation: "never" | "input_required";
+                label: string;
+                requiresFeedback: boolean;
+            }[];
+            comments: {
+                kind: "comment" | "answer" | "reply";
+                id: string;
+                createdAt: string;
+                provenance: {
+                    digest: string | null;
+                    repositoryId: string | null;
+                    contentPath: string | null;
+                    commitSha: string | null;
+                };
+                markdown: string;
+                parentId: string | null;
+                authorId: string;
+                authorLabel: string;
+            }[];
+            etag: string;
+        };
+        action?: "approve" | "reject" | "publish_revision" | "comment" | "answer" | "reply" | "reopen" | undefined;
+        receipts?: Record<string, unknown>[] | undefined;
+    }>;
+    getDraft: import("../control-plane-operation.js").ControlPlaneOperationBinding<{
+        teamId: string;
+        itemId: string;
+        purpose: "feedback" | "proposal_revision";
+    }, {}, undefined, {
+        schemaVersion: "treeseed.inbox-draft/v1";
+        revision: number;
+        updatedAt: string;
+        markdown: string;
+        etag: string;
+        itemId: string;
+        purpose: "feedback" | "proposal_revision";
+        baseVersion: number;
+    } | null>;
+    putDraft: import("../control-plane-operation.js").ControlPlaneOperationBinding<{
+        teamId: string;
+        itemId: string;
+        purpose: "feedback" | "proposal_revision";
+    }, {}, {
+        markdown: string;
+        baseVersion: number;
+    }, {
+        schemaVersion: "treeseed.inbox-draft/v1";
+        revision: number;
+        updatedAt: string;
+        markdown: string;
+        etag: string;
+        itemId: string;
+        purpose: "feedback" | "proposal_revision";
+        baseVersion: number;
+    }>;
+    deleteDraft: import("../control-plane-operation.js").ControlPlaneOperationBinding<{
+        teamId: string;
+        itemId: string;
+        purpose: "feedback" | "proposal_revision";
+    }, {}, {}, {
+        deleted: boolean;
+    }>;
+    action: import("../control-plane-operation.js").ControlPlaneOperationBinding<{
+        teamId: string;
+        itemId: string;
+    }, {}, {
+        action: "approve" | "reject" | "publish_revision" | "comment" | "answer" | "reply" | "reopen";
+        markdown?: string | undefined;
+        parentId?: string | undefined;
+        changeReason?: string | undefined;
+        draftRevision?: number | undefined;
+    }, {
+        schemaVersion: "treeseed.inbox-mutation-receipt/v1";
+        replayed: boolean;
+        item: {
+            status: "approved" | "rejected" | "outstanding" | "answered" | "closed" | "deleted";
+            kind: "proposal" | "question";
+            id: string;
+            schemaVersion: "treeseed.inbox-item/v1";
+            projectId: string;
+            createdAt: string;
+            provenance: {
+                digest: string | null;
+                repositoryId: string | null;
+                contentPath: string | null;
+                commitSha: string | null;
+            };
+            version: number;
+            teamId: string;
+            projectSlug: string;
+            updatedAt: string;
+            markdown: string;
+            discussionId: string | null;
+            authorId: string;
+            authorLabel: string;
+            title: string;
+            availableActions: {
+                reason: string | null;
+                enabled: boolean;
+                action: "approve" | "reject" | "publish_revision" | "comment" | "answer" | "reply" | "reopen";
+                confirmation: "never" | "input_required";
+                label: string;
+                requiresFeedback: boolean;
+            }[];
+            comments: {
+                kind: "comment" | "answer" | "reply";
+                id: string;
+                createdAt: string;
+                provenance: {
+                    digest: string | null;
+                    repositoryId: string | null;
+                    contentPath: string | null;
+                    commitSha: string | null;
+                };
+                markdown: string;
+                parentId: string | null;
+                authorId: string;
+                authorLabel: string;
+            }[];
+            etag: string;
+        };
+        action?: "approve" | "reject" | "publish_revision" | "comment" | "answer" | "reply" | "reopen" | undefined;
+        receipts?: Record<string, unknown>[] | undefined;
+    }>;
+};

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

@@ -0,0 +1,36 @@
+import { z } from "zod";
+import { defineOperation } from "../operation-builder.js";
+import {
+  inboxActionRequestSchema,
+  inboxDraftPurposeSchema,
+  inboxDraftSchema,
+  inboxDraftWriteSchema,
+  inboxItemPageSchema,
+  inboxItemSchema,
+  inboxMutationReceiptSchema,
+  inboxQuestionCreateSchema,
+  inboxTimelineSchema
+} from "../inbox/contracts.js";
+const empty = z.object({}).strict();
+const none = z.undefined();
+const itemPath = z.object({ teamId: z.string().min(1), itemId: z.string().min(1) }).strict();
+function inboxOperations() {
+  return {
+    list: defineOperation({ operationId: "inbox.items.list", description: "List the active team governance inbox.", rest: { method: "GET", path: "/v1/teams/{teamId}/inbox/items" }, parameters: "treeseed.inbox.items.list.parameters/v1", capability: "governance.read", authentication: "oauth", oauthScopes: ["treeseed:read"], kind: "read", riskClass: "ordinary", confirmation: "never", surfaces: ["rest", "cli", "mcp_tool", "mcp_resource"], cacheScope: "principal", pagination: "cursor" }, {
+      path: z.object({ teamId: z.string().min(1) }).strict(),
+      query: z.object({ projectId: z.string().optional(), kind: z.enum(["proposal", "question", "all"]).optional(), state: z.enum(["outstanding", "all"]).optional(), limit: z.coerce.number().int().min(1).max(500).optional(), cursor: z.string().optional() }).strict(),
+      body: none,
+      output: inboxItemPageSchema
+    }),
+    show: defineOperation({ operationId: "inbox.items.show", description: "Read one inbox item and its thread.", rest: { method: "GET", path: "/v1/teams/{teamId}/inbox/items/{itemId}" }, parameters: "treeseed.inbox.items.show.parameters/v1", capability: "governance.read", authentication: "oauth", oauthScopes: ["treeseed:read"], kind: "read", riskClass: "ordinary", confirmation: "never", surfaces: ["rest", "cli", "mcp_resource"], cacheScope: "principal", pagination: "none" }, { path: itemPath, query: empty, body: none, output: inboxItemSchema }),
+    events: defineOperation({ operationId: "inbox.events.list", description: "Long-poll ordered inbox events.", rest: { method: "GET", path: "/v1/teams/{teamId}/inbox/events" }, parameters: "treeseed.inbox.events.list.parameters/v1", capability: "governance.read", authentication: "oauth", oauthScopes: ["treeseed:read"], kind: "read", riskClass: "ordinary", confirmation: "never", surfaces: ["rest", "cli", "mcp_resource"], cacheScope: "principal", pagination: "cursor" }, { path: z.object({ teamId: z.string() }).strict(), query: z.object({ after: z.string().optional(), waitSeconds: z.coerce.number().int().min(0).max(30).optional(), limit: z.coerce.number().int().min(1).max(500).optional() }).strict(), body: none, output: inboxTimelineSchema }),
+    createQuestion: defineOperation({ operationId: "inbox.questions.create", description: "Create and route a TreeDX-backed project question.", rest: { method: "POST", path: "/v1/teams/{teamId}/inbox/questions" }, parameters: "treeseed.inbox.questions.create.parameters/v1", capability: "governance.write", authentication: "oauth", oauthScopes: ["treeseed:knowledge:write", "treeseed:execution"], kind: "mutation", riskClass: "ordinary", confirmation: "never", surfaces: ["rest", "cli", "mcp_tool"], cacheScope: "none", pagination: "none" }, { path: z.object({ teamId: z.string() }).strict(), query: empty, body: inboxQuestionCreateSchema, output: inboxMutationReceiptSchema }),
+    getDraft: defineOperation({ operationId: "inbox.drafts.show", description: "Read the current principal private inbox draft.", rest: { method: "GET", path: "/v1/teams/{teamId}/inbox/items/{itemId}/drafts/{purpose}" }, parameters: "treeseed.inbox.drafts.show.parameters/v1", capability: "governance.read", authentication: "oauth", oauthScopes: ["treeseed:read"], kind: "read", riskClass: "ordinary", confirmation: "never", surfaces: ["rest", "cli"], cacheScope: "principal", pagination: "none" }, { path: itemPath.extend({ purpose: inboxDraftPurposeSchema }), query: empty, body: none, output: inboxDraftSchema.nullable() }),
+    putDraft: defineOperation({ operationId: "inbox.drafts.put", description: "Save a private inbox draft.", rest: { method: "PUT", path: "/v1/teams/{teamId}/inbox/items/{itemId}/drafts/{purpose}" }, parameters: "treeseed.inbox.drafts.put.parameters/v1", capability: "governance.write", authentication: "oauth", oauthScopes: ["treeseed:governance:write"], kind: "mutation", riskClass: "ordinary", confirmation: "never", surfaces: ["rest", "cli"], cacheScope: "none", pagination: "none", concurrencyRequired: true }, { path: itemPath.extend({ purpose: inboxDraftPurposeSchema }), query: empty, body: inboxDraftWriteSchema, output: inboxDraftSchema }),
+    deleteDraft: defineOperation({ operationId: "inbox.drafts.delete", description: "Delete a private inbox draft.", rest: { method: "DELETE", path: "/v1/teams/{teamId}/inbox/items/{itemId}/drafts/{purpose}" }, parameters: "treeseed.inbox.drafts.delete.parameters/v1", capability: "governance.write", authentication: "oauth", oauthScopes: ["treeseed:governance:write"], kind: "mutation", riskClass: "ordinary", confirmation: "never", surfaces: ["rest", "cli"], cacheScope: "none", pagination: "none" }, { path: itemPath.extend({ purpose: inboxDraftPurposeSchema }), query: empty, body: empty, output: z.object({ deleted: z.boolean() }).strict() }),
+    action: defineOperation({ operationId: "inbox.items.action", description: "Apply an exact-version inbox action.", rest: { method: "POST", path: "/v1/teams/{teamId}/inbox/items/{itemId}/actions" }, parameters: "treeseed.inbox.items.action.parameters/v1", capability: "governance.write", authentication: "oauth", oauthScopes: ["treeseed:governance:write"], kind: "mutation", riskClass: "ordinary", confirmation: "never", surfaces: ["rest", "cli", "mcp_tool"], cacheScope: "none", pagination: "none", concurrencyRequired: true }, { path: itemPath, query: empty, body: inboxActionRequestSchema, output: inboxMutationReceiptSchema })
+  };
+}
+export {
+  inboxOperations
+};