@taiga-ai/mcp-server 0.26.0-dev.527 → 0.26.0-dev.528

package/dist/index.js

@@ -1488,6 +1488,59 @@ const INBOX_ITEM_KINDS = [
 	"setup_cloud_permission",
 	"setup_manual"
 ];
+/** The kind of manual setup the agents identified. */
+const INBOX_TASK_CATEGORIES = [
+	"env_var",
+	"secret",
+	"third_party_account",
+	"api_key",
+	"oauth_app",
+	"dns_record",
+	"billing_approval",
+	"cloud_permission",
+	"manual_config"
+];
+/** Where the produced value ultimately lands. */
+const INBOX_TASK_TARGETS = [
+	"github_secret",
+	"github_env",
+	"cloud_env",
+	"secrets_manager",
+	"local_env",
+	"external"
+];
+/**
+* Setup-task lifecycle phase. Two-level grouping for the setup-task inbox:
+* - prereq:   needed before the first build can run (credentials, accounts)
+* - wiring:   connect build outputs to providers (paste ARN into GitHub, DNS)
+* - followup: optional polish after first deploy (billing alerts, observability)
+*
+* The API derives phase from category at ingest via {@link phaseForCategory};
+* the agent CAN override by emitting an explicit phase, but the derivation is
+* the floor so a missing/garbled phase never breaks grouping.
+*/
+const INBOX_TASK_PHASES = [
+	"prereq",
+	"wiring",
+	"followup"
+];
+//#endregion
+//#region ../../packages/types/dist/build-narrative.js
+/**
+* The build narrative: the project-owner-facing timeline a coding agent posts
+* while it builds (decisions, tradeoffs, setup it needs, quality findings).
+*
+* The agent posts each entry to `POST /v1/builds/:id/progress` as a
+* `narrative` callback; the API validates it with {@link buildNarrativeBody},
+* stores it as a `stream_events` row and publishes it over SSE. The run page
+* reads the timeline either live (SSE) or on page load
+* (`GET /v1/builds/:id/narrative`, which queries the same rows), so this one
+* schema is the source of the callback contract, the stored payload type and
+* the list of kinds every reader accepts.
+*/
+/** A moment as factory-vm records it: ISO 8601, with its offset. */
+const moment = z.iso.datetime({ offset: true });
+const optionalMoment = moment.optional();
 z.discriminatedUnion("kind", [
 	z.object({
 		type: z.literal("narrative"),
@@ -1544,6 +1597,41 @@ z.discriminatedUnion("kind", [
 		state: z.string().min(1).max(60),
 		activity: z.string().max(200).optional(),
 		message: z.string().max(2e3).optional(),
+		at: optionalMoment,
+		stepId: optionalUuid
+	}),
+	z.object({
+		type: z.literal("narrative"),
+		kind: z.literal("agent_stage"),
+		agent: z.string().min(1).max(120),
+		stage: z.string().min(1).max(60),
+		outcome: z.string().max(60).optional(),
+		startedAt: moment,
+		endedAt: moment,
+		summary: z.string().max(400).optional(),
+		report: z.string().max(6e3).optional(),
+		commands: z.array(z.object({
+			text: z.string().min(1).max(200),
+			ms: z.number().int().min(0),
+			failed: z.boolean().optional()
+		})).max(40).optional(),
+		moreCommands: z.number().int().min(0).optional(),
+		checks: z.array(z.object({
+			name: z.string().min(1).max(300),
+			passed: z.boolean().optional(),
+			evidence: z.string().max(600).optional()
+		})).max(30).optional(),
+		moreChecks: z.number().int().min(0).optional(),
+		checksPassed: z.number().int().min(0).optional(),
+		edits: z.array(z.string().min(1).max(300)).max(30).optional(),
+		moreEdits: z.number().int().min(0).optional(),
+		threads: z.array(z.object({
+			resolution: z.string().min(1).max(60),
+			reply: z.string().max(1e3).optional()
+		})).max(20).optional(),
+		moreThreads: z.number().int().min(0).optional(),
+		sentBack: z.array(z.string().min(1).max(500)).max(5).optional(),
+		moreSentBack: z.number().int().min(0).optional(),
 		stepId: optionalUuid
 	}),
 	z.object({
@@ -1562,36 +1650,15 @@ z.discriminatedUnion("kind", [
 	z.object({
 		type: z.literal("narrative"),
 		kind: z.literal("setup_required"),
-		category: z.enum([
-			"env_var",
-			"secret",
-			"third_party_account",
-			"api_key",
-			"oauth_app",
-			"dns_record",
-			"billing_approval",
-			"cloud_permission",
-			"manual_config"
-		]),
+		category: z.enum(INBOX_TASK_CATEGORIES),
 		title: z.string().min(1).max(300),
 		instructions: z.string().min(1).max(2e3),
 		key: z.string().regex(/^[A-Za-z_][A-Za-z0-9_.]*$/).max(255).optional(),
 		isSecret: z.boolean().default(false),
-		target: z.enum([
-			"github_secret",
-			"github_env",
-			"cloud_env",
-			"secrets_manager",
-			"local_env",
-			"external"
-		]).optional(),
+		target: z.enum(INBOX_TASK_TARGETS).optional(),
 		providerDocUrl: z.string().url().max(1e3).refine((u) => /^https?:\/\//i.test(u), { message: "providerDocUrl must use http or https scheme" }).optional(),
 		providerActionUrl: z.string().url().max(1e3).refine((u) => /^https?:\/\//i.test(u), { message: "providerActionUrl must use http or https scheme" }).optional(),
-		phase: z.enum([
-			"prereq",
-			"wiring",
-			"followup"
-		]).optional(),
+		phase: z.enum(INBOX_TASK_PHASES).optional(),
 		suggestedValue: z.string().max(2e3).optional(),
 		stepId: optionalUuid
 	}),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@taiga-ai/mcp-server",
-  "version": "0.26.0-dev.527",
+  "version": "0.26.0-dev.528",
   "description": "Taiga for AI coding assistants: read products, policies, initiatives and runs, and operate the line, over MCP",
   "mcpName": "ga.tai/mcp-server",
   "type": "module",