@treeseed/sdk 0.13.0-rc.37 → 0.13.0-rc.39

package/dist/content/validation/portable-content-data.d.ts

@@ -114,12 +114,12 @@ export declare function validatePortableContentData(model: string, value: unknow
                 templates: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodString>>;
             }, "strict", import("zod").ZodTypeAny, {
                 system: string;
-                task?: string | undefined;
                 templates?: Record<string, string> | undefined;
+                task?: string | undefined;
             }, {
                 system: string;
-                task?: string | undefined;
                 templates?: Record<string, string> | undefined;
+                task?: string | undefined;
             }>;
             branchPolicy: import("zod").ZodObject<{
                 kind: import("zod").ZodEnum<["read-only", "main-planning-content", "staging-content", "assignment-feature", "staging-release"]>;
@@ -853,8 +853,8 @@ export declare function validatePortableContentData(model: string, value: unknow
             enabled: boolean;
             prompt: {
                 system: string;
-                task?: string | undefined;
                 templates?: Record<string, string> | undefined;
+                task?: string | undefined;
             };
             branchPolicy: {
                 kind: "read-only" | "main-planning-content" | "staging-content" | "assignment-feature" | "staging-release";
@@ -1026,8 +1026,8 @@ export declare function validatePortableContentData(model: string, value: unknow
             enabled: boolean;
             prompt: {
                 system: string;
-                task?: string | undefined;
                 templates?: Record<string, string> | undefined;
+                task?: string | undefined;
             };
             branchPolicy: {
                 kind: "read-only" | "main-planning-content" | "staging-content" | "assignment-feature" | "staging-release";
@@ -1199,8 +1199,8 @@ export declare function validatePortableContentData(model: string, value: unknow
             enabled: boolean;
             prompt: {
                 system: string;
-                task?: string | undefined;
                 templates?: Record<string, string> | undefined;
+                task?: string | undefined;
             };
             branchPolicy: {
                 kind: "read-only" | "main-planning-content" | "staging-content" | "assignment-feature" | "staging-release";
@@ -1372,8 +1372,8 @@ export declare function validatePortableContentData(model: string, value: unknow
             enabled: boolean;
             prompt: {
                 system: string;
-                task?: string | undefined;
                 templates?: Record<string, string> | undefined;
+                task?: string | undefined;
             };
             branchPolicy: {
                 kind: "read-only" | "main-planning-content" | "staging-content" | "assignment-feature" | "staging-release";
@@ -1550,8 +1550,8 @@ export declare function validatePortableContentData(model: string, value: unknow
         projectId: string;
         slug: string;
         metadata: Record<string, unknown>;
-        title: string;
         startedAt: Date;
+        title: string;
         changedFiles: string[];
         workDayId: string;
         reportVersion: string;
@@ -1585,8 +1585,8 @@ export declare function validatePortableContentData(model: string, value: unknow
             createdAt?: Date | undefined;
             state?: string | undefined;
             completedAt?: Date | undefined;
-            priority?: number | undefined;
             startedAt?: Date | undefined;
+            priority?: number | undefined;
             agentId?: string | undefined;
             idempotencyKey?: string | undefined;
             lastErrorCode?: string | null | undefined;
@@ -1599,8 +1599,8 @@ export declare function validatePortableContentData(model: string, value: unknow
             deploymentKind: string;
             id?: string | undefined;
             createdAt?: Date | undefined;
-            commitSha?: string | null | undefined;
             startedAt?: Date | undefined;
+            commitSha?: string | null | undefined;
             finishedAt?: Date | undefined;
             releaseTag?: string | null | undefined;
             sourceRef?: string | null | undefined;
@@ -1652,7 +1652,7 @@ export declare function validatePortableContentData(model: string, value: unknow
             supportsReconcile: boolean;
         };
         offer: {
-            priceModel: "external" | "private" | "subscription" | "free" | "contact" | "one_time" | "one_time_current_version" | "subscription_updates" | "professional_hosting" | "scoped_contract";
+            priceModel: "external" | "private" | "free" | "contact" | "one_time" | "one_time_current_version" | "subscription" | "subscription_updates" | "professional_hosting" | "scoped_contract";
             support?: string | undefined;
             license?: string | undefined;
         };
@@ -1662,7 +1662,7 @@ export declare function validatePortableContentData(model: string, value: unknow
         teamId?: string | undefined;
         sourceRef?: string | undefined;
     } | {
-        kind: "workday" | "handler" | "spec" | "message_chain" | "manager_worker" | "api" | "ui" | "context-query" | "context-query-set";
+        kind: "workday" | "api" | "handler" | "spec" | "message_chain" | "manager_worker" | "ui" | "context-query" | "context-query-set";
         id: string;
         trigger: Record<string, unknown>;
         agent: string;
@@ -1711,6 +1711,7 @@ export declare function validatePortableContentData(model: string, value: unknow
         revision: number;
         description: string;
         query: string;
+        depth: number;
         title: string;
         filters: Record<string, unknown>;
         target: {
@@ -1718,7 +1719,6 @@ export declare function validatePortableContentData(model: string, value: unknow
             paths?: string[] | undefined;
             models?: string[] | undefined;
         };
-        depth: number;
         purpose: string;
         maturity: "draft" | "validated" | "simulated" | "proven";
         relations: import("../../sdk-types/support/sdk-search-request.js").SdkGraphDslRelation[];
@@ -1844,6 +1844,7 @@ export declare function validatePortableContentData(model: string, value: unknow
         createdAt: Date;
         teamId: string;
         projectId: string;
+        outcome: "failed" | "passed" | "needs-revision";
         title: string;
         contextQueryRefs: {
             id: string;
@@ -1858,7 +1859,6 @@ export declare function validatePortableContentData(model: string, value: unknow
             revision: number;
         }[];
         agentId: string;
-        outcome: "failed" | "passed" | "needs-revision";
         agentDefinitionRef: {
             id: string;
             revision: number;
@@ -2003,7 +2003,7 @@ export declare function validatePortableContentData(model: string, value: unknow
         status: "review" | "archived" | "draft" | "published";
         schemaVersion: "treeseed.book/v2";
         id: string;
-        visibility: "team" | "project" | "public" | "authenticated" | "admin";
+        visibility: "team" | "project" | "public" | "admin" | "authenticated";
         order: number;
         summary: string;
         slug: string;
@@ -2016,7 +2016,7 @@ export declare function validatePortableContentData(model: string, value: unknow
         status: "review" | "archived" | "draft" | "published";
         schemaVersion: "treeseed.knowledge-page/v1";
         id: string;
-        visibility: "team" | "project" | "public" | "authenticated" | "admin";
+        visibility: "team" | "project" | "public" | "admin" | "authenticated";
         summary: string;
         slug: string;
         title: string;

package/dist/entrypoints/clients/control-plane-client.d.ts

@@ -15,6 +15,11 @@ export interface ControlPlaneServerSession {
     refreshToken?: string;
     expiresAt?: string;
     principal?: ApiPrincipal | null;
+    activeTeam?: {
+        id: string;
+        slug: string;
+        name: string;
+    } | null;
 }
 export interface ControlPlaneServerRegistry {
     version: 1;

package/dist/guarantees/index.d.ts

@@ -0,0 +1,96 @@
+export type GuaranteeRunStatus = 'passed' | 'failed' | 'skipped' | 'blocked';
+export type GuaranteeFilter = Record<string, unknown>;
+export interface GuaranteeDiagnostic {
+    severity: 'error' | 'warning' | 'info';
+    code: string;
+    message: string;
+    path?: string;
+    sourcePath?: string;
+}
+export interface GuaranteeRunStep {
+    id: string;
+    kind: string;
+    status: GuaranteeRunStatus;
+    evidence?: string[];
+    diagnostics?: GuaranteeDiagnostic[];
+    [key: string]: unknown;
+}
+export interface GuaranteePlanEntry {
+    id: string;
+    journey: string;
+    ownerPackage: string;
+    type: string;
+    subtype: string;
+    status: string;
+    gates: string[];
+    sourcePath: string;
+    selected: boolean;
+    dependency: boolean;
+    [key: string]: unknown;
+}
+export interface GuaranteePlanReport {
+    ok: boolean;
+    entries: GuaranteePlanEntry[];
+    diagnostics: GuaranteeDiagnostic[];
+    [key: string]: unknown;
+}
+export interface GuaranteeRunResult {
+    id: string;
+    journey: string;
+    ownerPackage: string;
+    type: string;
+    subtype: string;
+    status: GuaranteeRunStatus;
+    selected: boolean;
+    dependency: boolean;
+    sourcePath: string;
+    steps: GuaranteeRunStep[];
+    diagnostics: GuaranteeDiagnostic[];
+    evidence: string[];
+    [key: string]: unknown;
+}
+export interface GuaranteeRunReport {
+    runId: string;
+    environment: string;
+    startedAt: string;
+    completedAt?: string;
+    ok: boolean;
+    filter: GuaranteeFilter;
+    counts: {
+        passed: number;
+        failed: number;
+        skipped: number;
+        blocked: number;
+        releaseBlockingFailures: number;
+    };
+    results: GuaranteeRunResult[];
+    diagnostics?: GuaranteeDiagnostic[];
+    [key: string]: unknown;
+}
+interface GuaranteeManifest {
+    id: string;
+    journey: string;
+    ownerPackage: string;
+    type: string;
+    subtype: string;
+    status: string;
+    gates: string[];
+    [key: string]: unknown;
+}
+interface LoadedGuarantee {
+    sourcePath: string;
+    relativePath: string;
+    manifest: GuaranteeManifest | null;
+}
+export declare function discoverGuarantees(input: {
+    workspaceRoot: string;
+    filter?: GuaranteeFilter;
+}): {
+    ok: boolean;
+    guarantees: LoadedGuarantee[];
+    diagnostics: GuaranteeDiagnostic[];
+    counts: {
+        total: number;
+    };
+};
+export {};

package/dist/guarantees/index.js

@@ -0,0 +1,41 @@
+import { existsSync, readdirSync, readFileSync, statSync } from "node:fs";
+import { relative, resolve } from "node:path";
+import { parse } from "yaml";
+function walk(root, out = []) {
+  if (!existsSync(root)) return out;
+  for (const name of readdirSync(root)) {
+    if ([".git", "node_modules", "dist"].includes(name)) continue;
+    const path = resolve(root, name);
+    const stat = statSync(path);
+    if (stat.isDirectory()) walk(path, out);
+    else if (name.endsWith(".guarantee.yaml") || name.endsWith(".guarantee.yml")) out.push(path);
+  }
+  return out;
+}
+function discoverGuarantees(input) {
+  const diagnostics = [];
+  const guarantees = walk(resolve(input.workspaceRoot)).map((sourcePath) => {
+    try {
+      const value = parse(readFileSync(sourcePath, "utf8"));
+      const manifest = {
+        ...value,
+        id: String(value.id ?? ""),
+        journey: String(value.journey ?? value.id ?? ""),
+        ownerPackage: String(value.ownerPackage ?? ""),
+        type: String(value.type ?? ""),
+        subtype: String(value.subtype ?? ""),
+        status: String(value.status ?? "planned"),
+        gates: Array.isArray(value.gates) ? value.gates.map(String) : []
+      };
+      if (!manifest.id) throw new Error("id is required");
+      return { sourcePath, relativePath: relative(input.workspaceRoot, sourcePath).replaceAll("\\", "/"), manifest };
+    } catch (cause) {
+      diagnostics.push({ severity: "error", code: "guarantee.invalid_manifest", message: cause instanceof Error ? cause.message : "Invalid guarantee manifest.", sourcePath });
+      return { sourcePath, relativePath: relative(input.workspaceRoot, sourcePath).replaceAll("\\", "/"), manifest: null };
+    }
+  });
+  return { ok: diagnostics.every((entry) => entry.severity !== "error"), guarantees, diagnostics, counts: { total: guarantees.length } };
+}
+export {
+  discoverGuarantees
+};

package/dist/operator-contracts/canonical-command-tree.js

@@ -13,7 +13,10 @@ const operationBindings = {
   "auth logout": protocol("protocol.oauth.revoke"),
   "auth status": operation("accounts.current.show"),
   "users create": protocol("protocol.accounts.create"),
-  "send": operation("communications.send", [field("path", "teamId", "context", "team", true), field("path", "channel", "argument", "channel", true), field("body", "message", "argument", "message", true), field("body", "projectId", "context", "project"), field("body", "recipients", "option", "to"), field("body", "topic", "option"), field("body", "waitSeconds", "option", "wait", false, "integer")]),
+  "send": operation("communications.send", [field("path", "teamId", "context", "team", true), field("path", "channel", "argument", "channel", true), field("body", "message", "argument", "message", true), field("body", "projectId", "context", "project", true), field("body", "recipients", "option", "to"), field("body", "timeoutSeconds", "option", "timeout", false, "integer")]),
+  "teams list": operation("teams.list", page()),
+  "teams current": local("local.teams.current"),
+  "teams use": local("local.teams.use"),
   "secrets list": local("local.secrets.list"),
   "secrets status": local("local.secrets.status"),
   "secrets unlock": local("local.secrets.unlock"),
@@ -192,9 +195,10 @@ const commandTree = {
   schemaVersion: "treeseed.command-tree/v1",
   executable: "trsd",
   commands: [
-    { nodeType: "leaf", segment: "send", description: "Send a message to project agents through a team discussion channel.", kind: "mutation", arguments: [{ name: "channel", description: "Team discussion channel.", required: true }, { name: "message", description: "Markdown message to send.", required: true }], options: [planOption, { name: "--team", description: "Team identity or slug.", type: "string" }, { name: "--project", description: "Default project for unqualified agent names.", type: "string" }, { name: "--to", description: "Agent target; use project/agent when names may be ambiguous.", type: "string[]" }, { name: "--topic", description: "Optional discussion topic.", type: "string" }, { name: "--wait", description: "Seconds to wait for durable responses.", type: "number", defaultValue: 0 }], authorization: { capability: "agents.execute", confirmation: "never" }, resultSchemaId: "treeseed.communication-send-receipt/v1", execution: unavailable() },
+    { nodeType: "leaf", segment: "send", description: "Send a message to addressed project agents in a team discussion topic.", kind: "mutation", arguments: [{ name: "channel", description: "Team discussion-topic channel.", required: true }, { name: "message", description: "Markdown message containing agent addresses.", required: true }], options: [planOption, { name: "--team", description: "One-command team override.", type: "string" }, { name: "--project", description: "Project for agent resolution and the topic stream.", type: "string", required: true }, { name: "--to", description: "Deprecated validation-only address list.", type: "string[]" }, { name: "--timeout", description: "Maximum seconds to wait for the complete response chain.", type: "number", defaultValue: 1800 }, { name: "--no-wait", description: "Return immediately after durable admission.", type: "boolean" }, { name: "--wait", description: "Deprecated wait duration in seconds.", type: "number" }], authorization: { capability: "agents.execute", confirmation: "never" }, resultSchemaId: "treeseed.communication-send-receipt/v2", execution: unavailable() },
     branch("auth", [authLogin(), leaf("logout", "mutation"), leaf("status")]),
     branch("users", [userCreate()]),
+    branch("teams", [leaf("list"), { nodeType: "leaf", segment: "current", description: "Show the active team for this authenticated server session.", kind: "read", resultSchemaId: "treeseed.command.teams.current/v1", execution: unavailable() }, { nodeType: "leaf", segment: "use", description: "Select the active team for this authenticated server session.", kind: "mutation", arguments: [{ name: "team", description: "Team UUID or unambiguous slug.", required: true }], options: [planOption], authorization: { capability: "teams.read", confirmation: "never" }, resultSchemaId: "treeseed.command.teams.use/v1", execution: unavailable() }]),
     branch("secrets", [leaf("list"), leaf("status"), leaf("unlock", "mutation", void 0, "credential"), leaf("lock", "mutation"), leaf("rotate", "mutation", void 0, "credential")]),
     branch("host", [
       leaf("status"),

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

@@ -4,84 +4,164 @@ export declare function communicationOperations(): {
         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;
     }>;
     sendStatus: import("../control-plane-operation.js").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;
     }>;
 };
 export declare function providerDiscussionResponseOperation(): import("../control-plane-operation.js").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/catalog/communication-operations.js

@@ -10,7 +10,7 @@ const empty = z.object({}).strict();
 const none = z.undefined();
 function communicationOperations() {
   return {
-    send: defineOperation({ operationId: "communications.send", description: "Post a team-channel message and admit the selected project agents to the communication lane.", rest: { method: "POST", path: "/v1/teams/{teamId}/channels/{channel}/messages" }, parameters: "treeseed.communications.send.parameters/v1", capability: "agents.execute", authentication: "oauth", oauthScopes: ["treeseed:execution"], kind: "mutation", riskClass: "ordinary", confirmation: "never", surfaces: ["rest", "cli", "mcp_tool"], cacheScope: "none", pagination: "none" }, {
+    send: defineOperation({ operationId: "communications.send", description: "Post a team discussion-topic message and admit its addressed project agents to the communication lane.", rest: { method: "POST", path: "/v1/teams/{teamId}/discussion-topics/{channel}/messages" }, parameters: "treeseed.communications.send.parameters/v2", capability: "agents.execute", authentication: "oauth", oauthScopes: ["treeseed:execution"], kind: "mutation", riskClass: "ordinary", confirmation: "never", surfaces: ["rest", "cli", "mcp_tool"], cacheScope: "none", pagination: "none" }, {
       path: z.object({ teamId: z.string().min(1), channel: z.string().trim().min(1).max(120) }).strict(),
       query: empty,
       body: communicationSendRequestSchema,

package/dist/operator-contracts/communication/addressing.d.ts

@@ -0,0 +1,8 @@
+export type CommunicationAddressRequirement = 'required' | 'optional';
+export interface CommunicationAddress {
+    projectSlug: string | null;
+    agentSlug: string;
+    requirement: CommunicationAddressRequirement;
+    address: string;
+}
+export declare function parseCommunicationAddresses(markdown: string): CommunicationAddress[];

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

@@ -0,0 +1,57 @@
+const ADDRESS = /(^|[^\p{L}\p{N}._%+-])@([a-z0-9][a-z0-9-]*)(?:\/([a-z0-9][a-z0-9-]*))?/giu;
+function visibleMarkdown(markdown) {
+  const lines = markdown.replace(/\r\n?/gu, "\n").split("\n");
+  let fenced = false;
+  return lines.map((line) => {
+    if (/^\s*```/u.test(line)) {
+      fenced = !fenced;
+      return "";
+    }
+    if (fenced || /^\s*>/u.test(line)) return "";
+    return line.replace(/`[^`]*`/gu, "").replace(/!?\[[^\]]*\]\([^)]*\)/gu, "").replace(/\b[\w.+-]+@[\w.-]+\.[a-z]{2,}\b/giu, "");
+  }).join("\n");
+}
+function initialAddressLines(markdown) {
+  const lines = visibleMarkdown(markdown).split("\n");
+  let started = false;
+  const requiredThrough = /* @__PURE__ */ new Map();
+  for (let index = 0; index < lines.length; index += 1) {
+    const source = lines[index];
+    const line = source.trim();
+    if (!line && !started) continue;
+    if (!line) break;
+    started = true;
+    const leading = source.match(/^\s*(?:@[a-z0-9][a-z0-9-]*(?:\/[a-z0-9][a-z0-9-]*)?[\s,;:—–-]*)+/iu);
+    if (!leading) break;
+    requiredThrough.set(index, leading[0].length);
+    if (source.slice(leading[0].length).trim()) break;
+  }
+  return { markdown: visibleMarkdown(markdown), requiredThrough };
+}
+function parseCommunicationAddresses(markdown) {
+  const visible = initialAddressLines(markdown);
+  const addresses = /* @__PURE__ */ new Map();
+  for (const [lineIndex, line] of visible.markdown.split("\n").entries()) {
+    ADDRESS.lastIndex = 0;
+    for (const match of line.matchAll(ADDRESS)) {
+      const first = match[2].toLowerCase();
+      const second = match[3]?.toLowerCase() ?? null;
+      const projectSlug = second ? first : null;
+      const agentSlug = second ?? first;
+      const key = `${projectSlug ?? ""}/${agentSlug}`;
+      const addressIndex = (match.index ?? 0) + match[1].length;
+      const requirement = addressIndex < (visible.requiredThrough.get(lineIndex) ?? 0) ? "required" : "optional";
+      const existing = addresses.get(key);
+      if (!existing || requirement === "required") addresses.set(key, {
+        projectSlug,
+        agentSlug,
+        requirement,
+        address: `@${projectSlug ? `${projectSlug}/` : ""}${agentSlug}`
+      });
+    }
+  }
+  return [...addresses.values()];
+}
+export {
+  parseCommunicationAddresses
+};