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

package/dist/capacity-provider/client.d.ts

@@ -45,7 +45,7 @@ export declare class ProviderProtocolClient {
     startAssignmentCloseout(assignmentId: string, request: Record<string, unknown>): Promise<Record<string, unknown>>;
     preflightAssignmentCompletion(assignmentId: string, request: Record<string, unknown>): Promise<Record<string, unknown>>;
     respondToAssignmentDiscussion(assignmentId: string, request: ProviderDiscussionResponseRequest, idempotencyKey: string): Promise<{
-        status: "responded";
+        status: "responded" | "abstained";
         schemaVersion: "treeseed.provider-discussion-response-receipt/v1";
         assignmentId: string;
         invocationId: string;

package/dist/content/validation/agent-operational-content-schemas.d.ts

@@ -45,6 +45,7 @@ export declare const agentContextQueryContentSchema: z.ZodObject<{
     revision: number;
     description: string;
     query: string;
+    depth: number;
     title: string;
     filters: Record<string, unknown>;
     target: {
@@ -52,7 +53,6 @@ export declare const agentContextQueryContentSchema: z.ZodObject<{
         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[];
@@ -85,9 +85,9 @@ export declare const agentContextQueryContentSchema: z.ZodObject<{
     };
     tokenBudget: number;
     required?: boolean | undefined;
+    depth?: number | undefined;
     scope?: string | undefined;
     filters?: Record<string, unknown> | undefined;
-    depth?: number | undefined;
     codeScopes?: string[] | undefined;
     relations?: import("../../sdk-types/support/sdk-search-request.js").SdkGraphDslRelation[] | undefined;
     format?: "map" | "summary" | "list" | "brief" | "full" | "sources" | undefined;
@@ -597,6 +597,7 @@ export declare const agentEvaluationContentSchema: z.ZodObject<{
     createdAt: Date;
     teamId: string;
     projectId: string;
+    outcome: "failed" | "passed" | "needs-revision";
     title: string;
     contextQueryRefs: {
         id: string;
@@ -611,7 +612,6 @@ export declare const agentEvaluationContentSchema: z.ZodObject<{
         revision: number;
     }[];
     agentId: string;
-    outcome: "failed" | "passed" | "needs-revision";
     agentDefinitionRef: {
         id: string;
         revision: number;
@@ -635,9 +635,9 @@ export declare const agentEvaluationContentSchema: z.ZodObject<{
     createdAt: Date;
     teamId: string;
     projectId: string;
+    outcome: "failed" | "passed" | "needs-revision";
     title: string;
     agentId: string;
-    outcome: "failed" | "passed" | "needs-revision";
     agentDefinitionRef: {
         id: string;
         revision: number;
@@ -715,6 +715,7 @@ export declare const agentOperationalContentSchemas: {
         revision: number;
         description: string;
         query: string;
+        depth: number;
         title: string;
         filters: Record<string, unknown>;
         target: {
@@ -722,7 +723,6 @@ export declare const agentOperationalContentSchemas: {
             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[];
@@ -755,9 +755,9 @@ export declare const agentOperationalContentSchemas: {
         };
         tokenBudget: number;
         required?: boolean | undefined;
+        depth?: number | undefined;
         scope?: string | undefined;
         filters?: Record<string, unknown> | undefined;
-        depth?: number | undefined;
         codeScopes?: string[] | undefined;
         relations?: import("../../sdk-types/support/sdk-search-request.js").SdkGraphDslRelation[] | undefined;
         format?: "map" | "summary" | "list" | "brief" | "full" | "sources" | undefined;
@@ -1267,6 +1267,7 @@ export declare const agentOperationalContentSchemas: {
         createdAt: Date;
         teamId: string;
         projectId: string;
+        outcome: "failed" | "passed" | "needs-revision";
         title: string;
         contextQueryRefs: {
             id: string;
@@ -1281,7 +1282,6 @@ export declare const agentOperationalContentSchemas: {
             revision: number;
         }[];
         agentId: string;
-        outcome: "failed" | "passed" | "needs-revision";
         agentDefinitionRef: {
             id: string;
             revision: number;
@@ -1305,9 +1305,9 @@ export declare const agentOperationalContentSchemas: {
         createdAt: Date;
         teamId: string;
         projectId: string;
+        outcome: "failed" | "passed" | "needs-revision";
         title: string;
         agentId: string;
-        outcome: "failed" | "passed" | "needs-revision";
         agentDefinitionRef: {
             id: string;
             revision: number;

package/dist/content/validation/content-model-schemas.d.ts

@@ -48,6 +48,7 @@ declare const schemas: {
         revision: number;
         description: string;
         query: string;
+        depth: number;
         title: string;
         filters: Record<string, unknown>;
         target: {
@@ -55,7 +56,6 @@ declare const schemas: {
             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[];
@@ -88,9 +88,9 @@ declare const schemas: {
         };
         tokenBudget: number;
         required?: boolean | undefined;
+        depth?: number | undefined;
         scope?: string | undefined;
         filters?: Record<string, unknown> | undefined;
-        depth?: number | undefined;
         codeScopes?: string[] | undefined;
         relations?: import("../../sdk-types/support/sdk-search-request.js").SdkGraphDslRelation[] | undefined;
         format?: "map" | "summary" | "list" | "brief" | "full" | "sources" | undefined;
@@ -600,6 +600,7 @@ declare const schemas: {
         createdAt: Date;
         teamId: string;
         projectId: string;
+        outcome: "failed" | "passed" | "needs-revision";
         title: string;
         contextQueryRefs: {
             id: string;
@@ -614,7 +615,6 @@ declare const schemas: {
             revision: number;
         }[];
         agentId: string;
-        outcome: "failed" | "passed" | "needs-revision";
         agentDefinitionRef: {
             id: string;
             revision: number;
@@ -638,9 +638,9 @@ declare const schemas: {
         createdAt: Date;
         teamId: string;
         projectId: string;
+        outcome: "failed" | "passed" | "needs-revision";
         title: string;
         agentId: string;
-        outcome: "failed" | "passed" | "needs-revision";
         agentDefinitionRef: {
             id: string;
             revision: number;
@@ -11529,6 +11529,7 @@ export declare function validateContentFrontmatter(model: PortableContentModel,
         revision: number;
         description: string;
         query: string;
+        depth: number;
         title: string;
         filters: Record<string, unknown>;
         target: {
@@ -11536,7 +11537,6 @@ export declare function validateContentFrontmatter(model: PortableContentModel,
             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[];
@@ -11662,6 +11662,7 @@ export declare function validateContentFrontmatter(model: PortableContentModel,
         createdAt: Date;
         teamId: string;
         projectId: string;
+        outcome: "failed" | "passed" | "needs-revision";
         title: string;
         contextQueryRefs: {
             id: string;
@@ -11676,7 +11677,6 @@ export declare function validateContentFrontmatter(model: PortableContentModel,
             revision: number;
         }[];
         agentId: string;
-        outcome: "failed" | "passed" | "needs-revision";
         agentDefinitionRef: {
             id: string;
             revision: number;
@@ -20422,6 +20422,7 @@ export declare function describeContentFrontmatterSchema(model: PortableContentM
     revision: number;
     description: string;
     query: string;
+    depth: number;
     title: string;
     filters: Record<string, unknown>;
     target: {
@@ -20429,7 +20430,6 @@ export declare function describeContentFrontmatterSchema(model: PortableContentM
         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[];
@@ -20462,9 +20462,9 @@ export declare function describeContentFrontmatterSchema(model: PortableContentM
     };
     tokenBudget: number;
     required?: boolean | undefined;
+    depth?: number | undefined;
     scope?: string | undefined;
     filters?: Record<string, unknown> | undefined;
-    depth?: number | undefined;
     codeScopes?: string[] | undefined;
     relations?: import("../../sdk-types/support/sdk-search-request.js").SdkGraphDslRelation[] | undefined;
     format?: "map" | "summary" | "list" | "brief" | "full" | "sources" | undefined;
@@ -20967,6 +20967,7 @@ export declare function describeContentFrontmatterSchema(model: PortableContentM
     createdAt: Date;
     teamId: string;
     projectId: string;
+    outcome: "failed" | "passed" | "needs-revision";
     title: string;
     contextQueryRefs: {
         id: string;
@@ -20981,7 +20982,6 @@ export declare function describeContentFrontmatterSchema(model: PortableContentM
         revision: number;
     }[];
     agentId: string;
-    outcome: "failed" | "passed" | "needs-revision";
     agentDefinitionRef: {
         id: string;
         revision: number;
@@ -21005,9 +21005,9 @@ export declare function describeContentFrontmatterSchema(model: PortableContentM
     createdAt: Date;
     teamId: string;
     projectId: string;
+    outcome: "failed" | "passed" | "needs-revision";
     title: string;
     agentId: string;
-    outcome: "failed" | "passed" | "needs-revision";
     agentDefinitionRef: {
         id: string;
         revision: number;

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

@@ -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;

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/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
+};