@evermore.work/shared 2026.509.0-canary.0

package/dist/issue-references.test.js

@@ -0,0 +1,56 @@
+import { describe, expect, it } from "vitest";
+import { buildIssueReferenceHref, extractIssueReferenceIdentifiers, findIssueReferenceMatches, normalizeIssueIdentifier, parseIssueReferenceHref, } from "./issue-references.js";
+describe("issue references", () => {
+    it("normalizes identifiers to uppercase", () => {
+        expect(normalizeIssueIdentifier("evr-123")).toBe("EVR-123");
+        expect(normalizeIssueIdentifier("pc1a2-7")).toBe("PC1A2-7");
+        expect(normalizeIssueIdentifier("not-an-issue")).toBeNull();
+    });
+    it("parses relative and absolute issue hrefs", () => {
+        expect(parseIssueReferenceHref("/issues/EVR-123")).toEqual({ identifier: "EVR-123" });
+        expect(parseIssueReferenceHref("/EVR/issues/evr-456")).toEqual({ identifier: "EVR-456" });
+        expect(parseIssueReferenceHref("https://evermore.work/EVR/issues/evr-789#comment-1")).toEqual({
+            identifier: "EVR-789",
+        });
+        expect(parseIssueReferenceHref("https://evermore.work/projects/EVR-789")).toBeNull();
+    });
+    it("builds canonical issue hrefs", () => {
+        expect(buildIssueReferenceHref("evr-123")).toBe("/issues/EVR-123");
+    });
+    it("finds identifiers and issue paths in plain text", () => {
+        expect(findIssueReferenceMatches("See EVR-1, /issues/PC1A2-2, and https://x.test/EVR/issues/pc1a2-3.")).toEqual([
+            { index: 4, length: 5, identifier: "EVR-1", matchedText: "EVR-1" },
+            { index: 11, length: 15, identifier: "PC1A2-2", matchedText: "/issues/PC1A2-2" },
+            {
+                index: 32,
+                length: 33,
+                identifier: "PC1A2-3",
+                matchedText: "https://x.test/EVR/issues/pc1a2-3",
+            },
+        ]);
+    });
+    it("trims unmatched square brackets from issue path tokens", () => {
+        expect(findIssueReferenceMatches("See /issues/EVR-123] for context.")).toEqual([
+            { index: 4, length: 15, identifier: "EVR-123", matchedText: "/issues/EVR-123" },
+        ]);
+    });
+    it("extracts and dedupes references from markdown", () => {
+        expect(extractIssueReferenceIdentifiers("EVR-1 [again](/issues/evr-1) EVR-2")).toEqual(["EVR-1", "EVR-2"]);
+    });
+    it("ignores inline code and fenced code blocks", () => {
+        const markdown = [
+            "Use EVR-1 here.",
+            "",
+            "`EVR-2` should not count.",
+            "",
+            "```md",
+            "EVR-3",
+            "/issues/EVR-4",
+            "```",
+            "",
+            "Final /issues/EVR-5 mention.",
+        ].join("\n");
+        expect(extractIssueReferenceIdentifiers(markdown)).toEqual(["EVR-1", "EVR-5"]);
+    });
+});
+//# sourceMappingURL=issue-references.test.js.map

package/dist/issue-references.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"issue-references.test.js","sourceRoot":"","sources":["../src/issue-references.test.ts"],"names":[],"mappings":"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"}

package/dist/issue-thread-interactions.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=issue-thread-interactions.test.d.ts.map

package/dist/issue-thread-interactions.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"issue-thread-interactions.test.d.ts","sourceRoot":"","sources":["../src/issue-thread-interactions.test.ts"],"names":[],"mappings":""}

package/dist/issue-thread-interactions.test.js

@@ -0,0 +1,118 @@
+import { describe, expect, it } from "vitest";
+import { createIssueThreadInteractionSchema } from "./validators/issue.js";
+describe("issue thread interaction schemas", () => {
+    it("parses request_confirmation payloads with default no-wake continuation", () => {
+        const parsed = createIssueThreadInteractionSchema.parse({
+            kind: "request_confirmation",
+            payload: {
+                version: 1,
+                prompt: "Apply this plan?",
+                acceptLabel: "Apply",
+                rejectLabel: "Revise",
+                rejectRequiresReason: true,
+                rejectReasonLabel: "What needs to change?",
+                declineReasonPlaceholder: "Optional: tell the agent what you'd change.",
+                detailsMarkdown: "The current plan document will be accepted as-is.",
+                supersedeOnUserComment: true,
+            },
+        });
+        expect(parsed).toMatchObject({
+            kind: "request_confirmation",
+            continuationPolicy: "none",
+            payload: {
+                prompt: "Apply this plan?",
+                acceptLabel: "Apply",
+                rejectLabel: "Revise",
+                rejectRequiresReason: true,
+                rejectReasonLabel: "What needs to change?",
+                allowDeclineReason: true,
+                declineReasonPlaceholder: "Optional: tell the agent what you'd change.",
+                supersedeOnUserComment: true,
+            },
+        });
+    });
+    it("accepts issue document targets for request_confirmation interactions", () => {
+        const parsed = createIssueThreadInteractionSchema.parse({
+            kind: "request_confirmation",
+            continuationPolicy: "wake_assignee_on_accept",
+            payload: {
+                version: 1,
+                prompt: "Accept the latest plan revision?",
+                allowDeclineReason: false,
+                target: {
+                    type: "issue_document",
+                    issueId: "11111111-1111-4111-8111-111111111111",
+                    documentId: "22222222-2222-4222-8222-222222222222",
+                    key: "plan",
+                    revisionId: "33333333-3333-4333-8333-333333333333",
+                    revisionNumber: 2,
+                    label: "Plan v2",
+                    href: "/issues/EVR-123#document-plan",
+                },
+            },
+        });
+        expect(parsed.kind).toBe("request_confirmation");
+        if (parsed.kind !== "request_confirmation")
+            return;
+        expect(parsed.payload.target).toMatchObject({
+            type: "issue_document",
+            key: "plan",
+            revisionNumber: 2,
+            label: "Plan v2",
+            href: "/issues/EVR-123#document-plan",
+        });
+    });
+    it("accepts custom targets for request_confirmation interactions", () => {
+        const parsed = createIssueThreadInteractionSchema.parse({
+            kind: "request_confirmation",
+            payload: {
+                version: 1,
+                prompt: "Proceed with the external checklist?",
+                target: {
+                    type: "custom",
+                    key: "external-checklist",
+                    revisionId: "checklist-v1",
+                    revisionNumber: 1,
+                    label: "Checklist v1",
+                    href: "https://example.com/checklist",
+                },
+            },
+        });
+        expect(parsed.kind).toBe("request_confirmation");
+        if (parsed.kind !== "request_confirmation")
+            return;
+        expect(parsed.payload.target).toMatchObject({
+            type: "custom",
+            key: "external-checklist",
+            label: "Checklist v1",
+        });
+    });
+    it("rejects unsafe request_confirmation target hrefs", () => {
+        const base = {
+            kind: "request_confirmation",
+            payload: {
+                version: 1,
+                prompt: "Proceed?",
+                target: {
+                    type: "custom",
+                    key: "external-checklist",
+                    revisionId: "checklist-v1",
+                    label: "Checklist v1",
+                },
+            },
+        };
+        for (const href of ["javascript:alert(1)", "data:text/html,hi", "//evil.example/path"]) {
+            expect(() => createIssueThreadInteractionSchema.parse({
+                ...base,
+                payload: {
+                    ...base.payload,
+                    target: {
+                        ...base.payload.target,
+                        href,
+                    },
+                },
+            })).toThrow("href must not use javascript:, data:, or protocol-relative URLs");
+        }
+    });
+});
+//# sourceMappingURL=issue-thread-interactions.test.js.map

package/dist/issue-thread-interactions.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"issue-thread-interactions.test.js","sourceRoot":"","sources":["../src/issue-thread-interactions.test.ts"],"names":[],"mappings":"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"}

package/dist/network-bind.d.ts

@@ -0,0 +1,27 @@
+import type { BindMode, DeploymentExposure, DeploymentMode } from "./constants.js";
+export declare const LOOPBACK_BIND_HOST = "127.0.0.1";
+export declare const ALL_INTERFACES_BIND_HOST = "0.0.0.0";
+export declare function isLoopbackHost(host: string | null | undefined): boolean;
+export declare function isAllInterfacesHost(host: string | null | undefined): boolean;
+export declare function inferBindModeFromHost(host: string | null | undefined, opts?: {
+    tailnetBindHost?: string | null | undefined;
+}): BindMode;
+export declare function validateConfiguredBindMode(input: {
+    deploymentMode: DeploymentMode;
+    deploymentExposure: DeploymentExposure;
+    bind?: BindMode | null | undefined;
+    host?: string | null | undefined;
+    customBindHost?: string | null | undefined;
+}): string[];
+export declare function resolveRuntimeBind(input: {
+    bind?: BindMode | null | undefined;
+    host?: string | null | undefined;
+    customBindHost?: string | null | undefined;
+    tailnetBindHost?: string | null | undefined;
+}): {
+    bind: BindMode;
+    host: string;
+    customBindHost?: string;
+    errors: string[];
+};
+//# sourceMappingURL=network-bind.d.ts.map

package/dist/network-bind.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"network-bind.d.ts","sourceRoot":"","sources":["../src/network-bind.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEnF,eAAO,MAAM,kBAAkB,cAAc,CAAC;AAC9C,eAAO,MAAM,wBAAwB,YAAY,CAAC;AAOlD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAGvE;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAG5E;AAED,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAC/B,IAAI,CAAC,EAAE;IAAE,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAA;CAAE,GACrD,QAAQ,CAQV;AAED,wBAAgB,0BAA0B,CAAC,KAAK,EAAE;IAChD,cAAc,EAAE,cAAc,CAAC;IAC/B,kBAAkB,EAAE,kBAAkB,CAAC;IACvC,IAAI,CAAC,EAAE,QAAQ,GAAG,IAAI,GAAG,SAAS,CAAC;IACnC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACjC,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;CAC5C,GAAG,MAAM,EAAE,CAqBX;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE;IACxC,IAAI,CAAC,EAAE,QAAQ,GAAG,IAAI,GAAG,SAAS,CAAC;IACnC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACjC,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAC3C,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;CAC7C,GAAG;IACF,IAAI,EAAE,QAAQ,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB,CAgCA"}

package/dist/network-bind.js

@@ -0,0 +1,75 @@
+export const LOOPBACK_BIND_HOST = "127.0.0.1";
+export const ALL_INTERFACES_BIND_HOST = "0.0.0.0";
+function normalizeHost(host) {
+    const trimmed = host?.trim();
+    return trimmed ? trimmed : undefined;
+}
+export function isLoopbackHost(host) {
+    const normalized = normalizeHost(host)?.toLowerCase();
+    return normalized === "127.0.0.1" || normalized === "localhost" || normalized === "::1";
+}
+export function isAllInterfacesHost(host) {
+    const normalized = normalizeHost(host)?.toLowerCase();
+    return normalized === "0.0.0.0" || normalized === "::";
+}
+export function inferBindModeFromHost(host, opts) {
+    const normalized = normalizeHost(host);
+    const tailnetBindHost = normalizeHost(opts?.tailnetBindHost);
+    if (!normalized || isLoopbackHost(normalized))
+        return "loopback";
+    if (isAllInterfacesHost(normalized))
+        return "lan";
+    if (tailnetBindHost && normalized === tailnetBindHost)
+        return "tailnet";
+    return "custom";
+}
+export function validateConfiguredBindMode(input) {
+    const bind = input.bind ?? inferBindModeFromHost(input.host);
+    const customBindHost = normalizeHost(input.customBindHost);
+    const errors = [];
+    if (input.deploymentMode === "local_trusted" && bind !== "loopback") {
+        errors.push("local_trusted requires server.bind=loopback");
+    }
+    if (bind === "custom" && !customBindHost) {
+        const legacyHost = normalizeHost(input.host);
+        if (!legacyHost || isLoopbackHost(legacyHost) || isAllInterfacesHost(legacyHost)) {
+            errors.push("server.customBindHost is required when server.bind=custom");
+        }
+    }
+    if (input.deploymentMode === "authenticated" && input.deploymentExposure === "public" && bind === "tailnet") {
+        errors.push("server.bind=tailnet is only supported for authenticated/private deployments");
+    }
+    return errors;
+}
+export function resolveRuntimeBind(input) {
+    const bind = input.bind ?? inferBindModeFromHost(input.host, { tailnetBindHost: input.tailnetBindHost });
+    const legacyHost = normalizeHost(input.host);
+    const customBindHost = normalizeHost(input.customBindHost) ??
+        (bind === "custom" && legacyHost && !isLoopbackHost(legacyHost) && !isAllInterfacesHost(legacyHost)
+            ? legacyHost
+            : undefined);
+    switch (bind) {
+        case "loopback":
+            return { bind, host: LOOPBACK_BIND_HOST, customBindHost, errors: [] };
+        case "lan":
+            return { bind, host: ALL_INTERFACES_BIND_HOST, customBindHost, errors: [] };
+        case "custom":
+            return customBindHost
+                ? { bind, host: customBindHost, customBindHost, errors: [] }
+                : { bind, host: legacyHost ?? LOOPBACK_BIND_HOST, errors: ["server.customBindHost is required when server.bind=custom"] };
+        case "tailnet": {
+            const tailnetBindHost = normalizeHost(input.tailnetBindHost);
+            return tailnetBindHost
+                ? { bind, host: tailnetBindHost, customBindHost, errors: [] }
+                : {
+                    bind,
+                    host: legacyHost ?? LOOPBACK_BIND_HOST,
+                    customBindHost,
+                    errors: [
+                        "server.bind=tailnet requires a detected Tailscale address or EVERMORE_TAILNET_BIND_HOST",
+                    ],
+                };
+        }
+    }
+}
+//# sourceMappingURL=network-bind.js.map

package/dist/network-bind.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"network-bind.js","sourceRoot":"","sources":["../src/network-bind.ts"],"names":[],"mappings":"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"}

package/dist/project-mentions.d.ts

@@ -0,0 +1,32 @@
+export declare const PROJECT_MENTION_SCHEME = "project://";
+export declare const AGENT_MENTION_SCHEME = "agent://";
+export declare const USER_MENTION_SCHEME = "user://";
+export declare const SKILL_MENTION_SCHEME = "skill://";
+export interface ParsedProjectMention {
+    projectId: string;
+    color: string | null;
+}
+export interface ParsedAgentMention {
+    agentId: string;
+    icon: string | null;
+}
+export interface ParsedUserMention {
+    userId: string;
+}
+export interface ParsedSkillMention {
+    skillId: string;
+    slug: string | null;
+}
+export declare function buildProjectMentionHref(projectId: string, color?: string | null): string;
+export declare function parseProjectMentionHref(href: string): ParsedProjectMention | null;
+export declare function buildAgentMentionHref(agentId: string, icon?: string | null): string;
+export declare function parseAgentMentionHref(href: string): ParsedAgentMention | null;
+export declare function buildUserMentionHref(userId: string): string;
+export declare function parseUserMentionHref(href: string): ParsedUserMention | null;
+export declare function buildSkillMentionHref(skillId: string, slug?: string | null): string;
+export declare function parseSkillMentionHref(href: string): ParsedSkillMention | null;
+export declare function extractProjectMentionIds(markdown: string): string[];
+export declare function extractAgentMentionIds(markdown: string): string[];
+export declare function extractUserMentionIds(markdown: string): string[];
+export declare function extractSkillMentionIds(markdown: string): string[];
+//# sourceMappingURL=project-mentions.d.ts.map

package/dist/project-mentions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-mentions.d.ts","sourceRoot":"","sources":["../src/project-mentions.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,sBAAsB,eAAe,CAAC;AACnD,eAAO,MAAM,oBAAoB,aAAa,CAAC;AAC/C,eAAO,MAAM,mBAAmB,YAAY,CAAC;AAC7C,eAAO,MAAM,oBAAoB,aAAa,CAAC;AAa/C,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB;AAwBD,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAOxF;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,oBAAoB,GAAG,IAAI,CAqBjF;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAOnF;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,GAAG,IAAI,CAmB7E;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI,CAgB3E;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAOnF;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,GAAG,IAAI,CAmB7E;AAED,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAUnE;AAED,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAUjE;AAED,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAUhE;AAED,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAUjE"}

package/dist/project-mentions.js

@@ -0,0 +1,210 @@
+export const PROJECT_MENTION_SCHEME = "project://";
+export const AGENT_MENTION_SCHEME = "agent://";
+export const USER_MENTION_SCHEME = "user://";
+export const SKILL_MENTION_SCHEME = "skill://";
+const HEX_COLOR_RE = /^[0-9a-f]{6}$/i;
+const HEX_COLOR_SHORT_RE = /^[0-9a-f]{3}$/i;
+const HEX_COLOR_WITH_HASH_RE = /^#[0-9a-f]{6}$/i;
+const HEX_COLOR_SHORT_WITH_HASH_RE = /^#[0-9a-f]{3}$/i;
+const PROJECT_MENTION_LINK_RE = /\[[^\]]*]\((project:\/\/[^)\s]+)\)/gi;
+const AGENT_MENTION_LINK_RE = /\[[^\]]*]\((agent:\/\/[^)\s]+)\)/gi;
+const USER_MENTION_LINK_RE = /\[[^\]]*]\((user:\/\/[^)\s]+)\)/gi;
+const SKILL_MENTION_LINK_RE = /\[[^\]]*]\((skill:\/\/[^)\s]+)\)/gi;
+const AGENT_ICON_NAME_RE = /^[a-z0-9-]+$/i;
+const SKILL_SLUG_RE = /^[a-z0-9][a-z0-9-]*$/i;
+function normalizeHexColor(input) {
+    if (!input)
+        return null;
+    const trimmed = input.trim();
+    if (!trimmed)
+        return null;
+    if (HEX_COLOR_WITH_HASH_RE.test(trimmed)) {
+        return trimmed.toLowerCase();
+    }
+    if (HEX_COLOR_RE.test(trimmed)) {
+        return `#${trimmed.toLowerCase()}`;
+    }
+    if (HEX_COLOR_SHORT_WITH_HASH_RE.test(trimmed)) {
+        const raw = trimmed.slice(1).toLowerCase();
+        return `#${raw[0]}${raw[0]}${raw[1]}${raw[1]}${raw[2]}${raw[2]}`;
+    }
+    if (HEX_COLOR_SHORT_RE.test(trimmed)) {
+        const raw = trimmed.toLowerCase();
+        return `#${raw[0]}${raw[0]}${raw[1]}${raw[1]}${raw[2]}${raw[2]}`;
+    }
+    return null;
+}
+export function buildProjectMentionHref(projectId, color) {
+    const trimmedProjectId = projectId.trim();
+    const normalizedColor = normalizeHexColor(color ?? null);
+    if (!normalizedColor) {
+        return `${PROJECT_MENTION_SCHEME}${trimmedProjectId}`;
+    }
+    return `${PROJECT_MENTION_SCHEME}${trimmedProjectId}?c=${encodeURIComponent(normalizedColor.slice(1))}`;
+}
+export function parseProjectMentionHref(href) {
+    if (!href.startsWith(PROJECT_MENTION_SCHEME))
+        return null;
+    let url;
+    try {
+        url = new URL(href);
+    }
+    catch {
+        return null;
+    }
+    if (url.protocol !== "project:")
+        return null;
+    const projectId = `${url.hostname}${url.pathname}`.replace(/^\/+/, "").trim();
+    if (!projectId)
+        return null;
+    const color = normalizeHexColor(url.searchParams.get("c") ?? url.searchParams.get("color"));
+    return {
+        projectId,
+        color,
+    };
+}
+export function buildAgentMentionHref(agentId, icon) {
+    const trimmedAgentId = agentId.trim();
+    const normalizedIcon = normalizeAgentIcon(icon ?? null);
+    if (!normalizedIcon) {
+        return `${AGENT_MENTION_SCHEME}${trimmedAgentId}`;
+    }
+    return `${AGENT_MENTION_SCHEME}${trimmedAgentId}?i=${encodeURIComponent(normalizedIcon)}`;
+}
+export function parseAgentMentionHref(href) {
+    if (!href.startsWith(AGENT_MENTION_SCHEME))
+        return null;
+    let url;
+    try {
+        url = new URL(href);
+    }
+    catch {
+        return null;
+    }
+    if (url.protocol !== "agent:")
+        return null;
+    const agentId = `${url.hostname}${url.pathname}`.replace(/^\/+/, "").trim();
+    if (!agentId)
+        return null;
+    return {
+        agentId,
+        icon: normalizeAgentIcon(url.searchParams.get("i") ?? url.searchParams.get("icon")),
+    };
+}
+export function buildUserMentionHref(userId) {
+    return `${USER_MENTION_SCHEME}${userId.trim()}`;
+}
+export function parseUserMentionHref(href) {
+    if (!href.startsWith(USER_MENTION_SCHEME))
+        return null;
+    let url;
+    try {
+        url = new URL(href);
+    }
+    catch {
+        return null;
+    }
+    if (url.protocol !== "user:")
+        return null;
+    const userId = `${url.hostname}${url.pathname}`.replace(/^\/+/, "").trim();
+    if (!userId)
+        return null;
+    return { userId };
+}
+export function buildSkillMentionHref(skillId, slug) {
+    const trimmedSkillId = skillId.trim();
+    const normalizedSlug = normalizeSkillSlug(slug ?? null);
+    if (!normalizedSlug) {
+        return `${SKILL_MENTION_SCHEME}${trimmedSkillId}`;
+    }
+    return `${SKILL_MENTION_SCHEME}${trimmedSkillId}?s=${encodeURIComponent(normalizedSlug)}`;
+}
+export function parseSkillMentionHref(href) {
+    if (!href.startsWith(SKILL_MENTION_SCHEME))
+        return null;
+    let url;
+    try {
+        url = new URL(href);
+    }
+    catch {
+        return null;
+    }
+    if (url.protocol !== "skill:")
+        return null;
+    const skillId = `${url.hostname}${url.pathname}`.replace(/^\/+/, "").trim();
+    if (!skillId)
+        return null;
+    return {
+        skillId,
+        slug: normalizeSkillSlug(url.searchParams.get("s") ?? url.searchParams.get("slug")),
+    };
+}
+export function extractProjectMentionIds(markdown) {
+    if (!markdown)
+        return [];
+    const ids = new Set();
+    const re = new RegExp(PROJECT_MENTION_LINK_RE);
+    let match;
+    while ((match = re.exec(markdown)) !== null) {
+        const parsed = parseProjectMentionHref(match[1]);
+        if (parsed)
+            ids.add(parsed.projectId);
+    }
+    return [...ids];
+}
+export function extractAgentMentionIds(markdown) {
+    if (!markdown)
+        return [];
+    const ids = new Set();
+    const re = new RegExp(AGENT_MENTION_LINK_RE);
+    let match;
+    while ((match = re.exec(markdown)) !== null) {
+        const parsed = parseAgentMentionHref(match[1]);
+        if (parsed)
+            ids.add(parsed.agentId);
+    }
+    return [...ids];
+}
+export function extractUserMentionIds(markdown) {
+    if (!markdown)
+        return [];
+    const ids = new Set();
+    const re = new RegExp(USER_MENTION_LINK_RE);
+    let match;
+    while ((match = re.exec(markdown)) !== null) {
+        const parsed = parseUserMentionHref(match[1]);
+        if (parsed)
+            ids.add(parsed.userId);
+    }
+    return [...ids];
+}
+export function extractSkillMentionIds(markdown) {
+    if (!markdown)
+        return [];
+    const ids = new Set();
+    const re = new RegExp(SKILL_MENTION_LINK_RE);
+    let match;
+    while ((match = re.exec(markdown)) !== null) {
+        const parsed = parseSkillMentionHref(match[1]);
+        if (parsed)
+            ids.add(parsed.skillId);
+    }
+    return [...ids];
+}
+function normalizeAgentIcon(input) {
+    if (!input)
+        return null;
+    const trimmed = input.trim().toLowerCase();
+    if (!trimmed || !AGENT_ICON_NAME_RE.test(trimmed))
+        return null;
+    return trimmed;
+}
+function normalizeSkillSlug(input) {
+    if (!input)
+        return null;
+    const trimmed = input.trim().toLowerCase();
+    if (!trimmed || !SKILL_SLUG_RE.test(trimmed))
+        return null;
+    return trimmed;
+}
+//# sourceMappingURL=project-mentions.js.map

package/dist/project-mentions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-mentions.js","sourceRoot":"","sources":["../src/project-mentions.ts"],"names":[],"mappings":"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"}

package/dist/project-mentions.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=project-mentions.test.d.ts.map

package/dist/project-mentions.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-mentions.test.d.ts","sourceRoot":"","sources":["../src/project-mentions.test.ts"],"names":[],"mappings":""}

package/dist/project-mentions.test.js

@@ -0,0 +1,36 @@
+import { describe, expect, it } from "vitest";
+import { buildAgentMentionHref, buildProjectMentionHref, buildSkillMentionHref, buildUserMentionHref, extractAgentMentionIds, extractProjectMentionIds, extractSkillMentionIds, extractUserMentionIds, parseAgentMentionHref, parseProjectMentionHref, parseSkillMentionHref, parseUserMentionHref, } from "./project-mentions.js";
+describe("project-mentions", () => {
+    it("round-trips project mentions with color metadata", () => {
+        const href = buildProjectMentionHref("project-123", "#336699");
+        expect(parseProjectMentionHref(href)).toEqual({
+            projectId: "project-123",
+            color: "#336699",
+        });
+        expect(extractProjectMentionIds(`[@Evermore App](${href})`)).toEqual(["project-123"]);
+    });
+    it("round-trips agent mentions with icon metadata", () => {
+        const href = buildAgentMentionHref("agent-123", "code");
+        expect(parseAgentMentionHref(href)).toEqual({
+            agentId: "agent-123",
+            icon: "code",
+        });
+        expect(extractAgentMentionIds(`[@CodexCoder](${href})`)).toEqual(["agent-123"]);
+    });
+    it("round-trips user mentions", () => {
+        const href = buildUserMentionHref("user-123");
+        expect(parseUserMentionHref(href)).toEqual({
+            userId: "user-123",
+        });
+        expect(extractUserMentionIds(`[@Taylor](${href})`)).toEqual(["user-123"]);
+    });
+    it("round-trips skill mentions with slug metadata", () => {
+        const href = buildSkillMentionHref("skill-123", "release-changelog");
+        expect(parseSkillMentionHref(href)).toEqual({
+            skillId: "skill-123",
+            slug: "release-changelog",
+        });
+        expect(extractSkillMentionIds(`[/release-changelog](${href})`)).toEqual(["skill-123"]);
+    });
+});
+//# sourceMappingURL=project-mentions.test.js.map

package/dist/project-mentions.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-mentions.test.js","sourceRoot":"","sources":["../src/project-mentions.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EACL,qBAAqB,EACrB,uBAAuB,EACvB,qBAAqB,EACrB,oBAAoB,EACpB,sBAAsB,EACtB,wBAAwB,EACxB,sBAAsB,EACtB,qBAAqB,EACrB,qBAAqB,EACrB,uBAAuB,EACvB,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,uBAAuB,CAAC;AAE/B,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;IAChC,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;QAC1D,MAAM,IAAI,GAAG,uBAAuB,CAAC,aAAa,EAAE,SAAS,CAAC,CAAC;QAC/D,MAAM,CAAC,uBAAuB,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC;YAC5C,SAAS,EAAE,aAAa;YACxB,KAAK,EAAE,SAAS;SACjB,CAAC,CAAC;QACH,MAAM,CAAC,wBAAwB,CAAC,mBAAmB,IAAI,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC;IACxF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;QACvD,MAAM,IAAI,GAAG,qBAAqB,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;QACxD,MAAM,CAAC,qBAAqB,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC;YAC1C,OAAO,EAAE,WAAW;YACpB,IAAI,EAAE,MAAM;SACb,CAAC,CAAC;QACH,MAAM,CAAC,sBAAsB,CAAC,iBAAiB,IAAI,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC;IAClF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2BAA2B,EAAE,GAAG,EAAE;QACnC,MAAM,IAAI,GAAG,oBAAoB,CAAC,UAAU,CAAC,CAAC;QAC9C,MAAM,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC;YACzC,MAAM,EAAE,UAAU;SACnB,CAAC,CAAC;QACH,MAAM,CAAC,qBAAqB,CAAC,aAAa,IAAI,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC;IAC5E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;QACvD,MAAM,IAAI,GAAG,qBAAqB,CAAC,WAAW,EAAE,mBAAmB,CAAC,CAAC;QACrE,MAAM,CAAC,qBAAqB,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC;YAC1C,OAAO,EAAE,WAAW;YACpB,IAAI,EAAE,mBAAmB;SAC1B,CAAC,CAAC;QACH,MAAM,CAAC,sBAAsB,CAAC,wBAAwB,IAAI,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC;IACzF,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/project-url-key.d.ts

@@ -0,0 +1,5 @@
+export declare function normalizeProjectUrlKey(value: string | null | undefined): string | null;
+/** Check whether a string contains non-ASCII characters that normalization would strip. */
+export declare function hasNonAsciiContent(value: string | null | undefined): boolean;
+export declare function deriveProjectUrlKey(name: string | null | undefined, fallback?: string | null): string;
+//# sourceMappingURL=project-url-key.d.ts.map

package/dist/project-url-key.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-url-key.d.ts","sourceRoot":"","sources":["../src/project-url-key.ts"],"names":[],"mappings":"AAKA,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAQtF;AAED,2FAA2F;AAC3F,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAG5E;AAQD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAQrG"}