@tickernelz/paperclip-pro-shared 2026.925.0

package/dist/agent-eligibility.d.ts

@@ -0,0 +1,67 @@
+import type { AgentStatus } from "./constants.js";
+export type AgentEligibilityLifecycleReason = "eligible" | "terminated" | "pending_approval" | "paused" | "invalid_org_chain" | "unknown_status";
+export interface AgentEligibilityAgent {
+    id: string;
+    companyId: string;
+    name: string;
+    status: AgentStatus | string;
+    reportsTo?: string | null;
+}
+export interface AgentOrgChainEntry {
+    id: string;
+    companyId: string;
+    name: string;
+    status: AgentStatus | string;
+    reportsTo: string | null;
+    depth: number;
+    relation: "self" | "ancestor";
+}
+export interface AgentInvalidOrgChainAncestor {
+    id: string;
+    name: string;
+    status: AgentStatus | string;
+}
+export type AgentOrgChainInvalidReason = "healthy" | "terminated_ancestor" | "missing_manager" | "cycle";
+export interface AgentOrgChainHealth {
+    status: "healthy" | "invalid_org_chain";
+    reason: AgentOrgChainInvalidReason;
+    fullChain: AgentOrgChainEntry[];
+    firstInvalidAncestor: AgentInvalidOrgChainAncestor | null;
+    invalidAncestors: AgentInvalidOrgChainAncestor[];
+    repairGuidance: string | null;
+    /**
+     * Paused ancestors of a non-paused agent. A paused manager does not make
+     * the chain invalid (the agent stays invokable), but escalations routed to
+     * it dead-letter: assigned work never runs and nothing surfaces it. This is
+     * a warning, not a block.
+     */
+    pausedAncestors?: AgentInvalidOrgChainAncestor[];
+    /** Human-readable warning when the escalation path routes to a paused agent. */
+    escalationWarning?: string | null;
+}
+export interface AgentWorkEligibility {
+    assignable: boolean;
+    invokable: boolean;
+    assignabilityReason: AgentEligibilityLifecycleReason;
+    invokabilityReason: AgentEligibilityLifecycleReason;
+    orgChainHealth: AgentOrgChainHealth;
+}
+export declare function isAgentStatusAssignableToWork(status: AgentStatus | string): boolean;
+export declare function isAgentStatusInvokable(status: AgentStatus | string): boolean;
+export declare function getAgentOrgChainHealth(input: {
+    agent: AgentEligibilityAgent;
+    agents: AgentEligibilityAgent[];
+}): AgentOrgChainHealth;
+export declare function getAgentWorkEligibility(input: {
+    agent: AgentEligibilityAgent;
+    agents: AgentEligibilityAgent[];
+}): AgentWorkEligibility;
+export declare function isAgentAssignableToWork(input: {
+    agent: AgentEligibilityAgent;
+    agents: AgentEligibilityAgent[];
+}): boolean;
+export declare function isAgentInvokable(input: {
+    agent: AgentEligibilityAgent;
+    agents: AgentEligibilityAgent[];
+}): boolean;
+//# sourceMappingURL=agent-eligibility.d.ts.map

package/dist/agent-eligibility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-eligibility.d.ts","sourceRoot":"","sources":["../src/agent-eligibility.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD,MAAM,MAAM,+BAA+B,GACvC,UAAU,GACV,YAAY,GACZ,kBAAkB,GAClB,QAAQ,GACR,mBAAmB,GACnB,gBAAgB,CAAC;AAErB,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,WAAW,GAAG,MAAM,CAAC;IAC7B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,WAAW,GAAG,MAAM,CAAC;IAC7B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,GAAG,UAAU,CAAC;CAC/B;AAED,MAAM,WAAW,4BAA4B;IAC3C,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,WAAW,GAAG,MAAM,CAAC;CAC9B;AAED,MAAM,MAAM,0BAA0B,GAClC,SAAS,GACT,qBAAqB,GACrB,iBAAiB,GACjB,OAAO,CAAC;AAEZ,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,SAAS,GAAG,mBAAmB,CAAC;IACxC,MAAM,EAAE,0BAA0B,CAAC;IACnC,SAAS,EAAE,kBAAkB,EAAE,CAAC;IAChC,oBAAoB,EAAE,4BAA4B,GAAG,IAAI,CAAC;IAC1D,gBAAgB,EAAE,4BAA4B,EAAE,CAAC;IACjD,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B;;;;;OAKG;IACH,eAAe,CAAC,EAAE,4BAA4B,EAAE,CAAC;IACjD,gFAAgF;IAChF,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACnC;AAED,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,mBAAmB,EAAE,+BAA+B,CAAC;IACrD,kBAAkB,EAAE,+BAA+B,CAAC;IACpD,cAAc,EAAE,mBAAmB,CAAC;CACrC;AAOD,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,GAAG,OAAO,CAEnF;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,GAAG,OAAO,CAE5E;AAgDD,wBAAgB,sBAAsB,CAAC,KAAK,EAAE;IAC5C,KAAK,EAAE,qBAAqB,CAAC;IAC7B,MAAM,EAAE,qBAAqB,EAAE,CAAC;CACjC,GAAG,mBAAmB,CA4FtB;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE;IAC7C,KAAK,EAAE,qBAAqB,CAAC;IAC7B,MAAM,EAAE,qBAAqB,EAAE,CAAC;CACjC,GAAG,oBAAoB,CA8BvB;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE;IAC7C,KAAK,EAAE,qBAAqB,CAAC;IAC7B,MAAM,EAAE,qBAAqB,EAAE,CAAC;CACjC,GAAG,OAAO,CAEV;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE;IACtC,KAAK,EAAE,qBAAqB,CAAC;IAC7B,MAAM,EAAE,qBAAqB,EAAE,CAAC;CACjC,GAAG,OAAO,CAEV"}

package/dist/agent-eligibility.js

@@ -0,0 +1,171 @@
+const NON_ASSIGNABLE_AGENT_STATUSES = new Set(["terminated", "pending_approval"]);
+const NON_INVOKABLE_AGENT_STATUSES = new Set(["terminated", "pending_approval", "paused"]);
+const ASSIGNABLE_AGENT_STATUSES = new Set(["active", "paused", "idle", "running", "error"]);
+const INVOKABLE_AGENT_STATUSES = new Set(["active", "idle", "running", "error"]);
+export function isAgentStatusAssignableToWork(status) {
+    return ASSIGNABLE_AGENT_STATUSES.has(status) && !NON_ASSIGNABLE_AGENT_STATUSES.has(status);
+}
+export function isAgentStatusInvokable(status) {
+    return INVOKABLE_AGENT_STATUSES.has(status) && !NON_INVOKABLE_AGENT_STATUSES.has(status);
+}
+function chainEntry(agent, depth, relation) {
+    return {
+        id: agent.id,
+        companyId: agent.companyId,
+        name: agent.name,
+        status: agent.status,
+        reportsTo: agent.reportsTo ?? null,
+        depth,
+        relation,
+    };
+}
+function invalidAncestor(agent) {
+    return {
+        id: agent.id,
+        name: agent.name,
+        status: agent.status,
+    };
+}
+function buildRepairGuidance(agent, firstInvalidAncestor) {
+    if (firstInvalidAncestor.status === "missing") {
+        return [
+            `${agent.name} reports to missing manager ${firstInvalidAncestor.id}.`,
+            `Reassign ${agent.name} or the nearest affected ancestor under an active manager/root, or explicitly pause or terminate the invalid subtree before assigning work or starting runs.`,
+        ].join(" ");
+    }
+    if (firstInvalidAncestor.status === "cycle") {
+        return [
+            `${agent.name} has a cycle in its reporting chain at ${firstInvalidAncestor.name}.`,
+            `Break the cycle by assigning one affected agent to an active manager/root, or explicitly pause or terminate the invalid subtree before assigning work or starting runs.`,
+        ].join(" ");
+    }
+    return [
+        `${agent.name} reports through terminated ancestor ${firstInvalidAncestor.name}.`,
+        `Reassign ${agent.name} or the nearest affected ancestor under an active manager/root, or explicitly pause or terminate the invalid subtree before assigning work or starting runs.`,
+    ].join(" ");
+}
+export function getAgentOrgChainHealth(input) {
+    const byId = new Map(input.agents.map((agent) => [agent.id, agent]));
+    const fullChain = [chainEntry(input.agent, 0, "self")];
+    const invalidAncestors = [];
+    const pausedAncestors = [];
+    const seen = new Set([input.agent.id]);
+    let current = input.agent;
+    let depth = 1;
+    while (current.reportsTo) {
+        if (seen.has(current.reportsTo)) {
+            const cycleAgent = byId.get(current.reportsTo);
+            const invalid = {
+                id: current.reportsTo,
+                name: cycleAgent?.name ?? current.reportsTo,
+                status: "cycle",
+            };
+            fullChain.push({
+                id: invalid.id,
+                companyId: input.agent.companyId,
+                name: invalid.name,
+                status: invalid.status,
+                reportsTo: cycleAgent?.reportsTo ?? null,
+                depth,
+                relation: "ancestor",
+            });
+            invalidAncestors.push(invalid);
+            break;
+        }
+        seen.add(current.reportsTo);
+        const parent = byId.get(current.reportsTo);
+        if (!parent || parent.companyId !== input.agent.companyId) {
+            const invalid = {
+                id: current.reportsTo,
+                name: current.reportsTo,
+                status: "missing",
+            };
+            fullChain.push({
+                id: invalid.id,
+                companyId: input.agent.companyId,
+                name: invalid.name,
+                status: invalid.status,
+                reportsTo: null,
+                depth,
+                relation: "ancestor",
+            });
+            invalidAncestors.push(invalid);
+            break;
+        }
+        fullChain.push(chainEntry(parent, depth, "ancestor"));
+        if (parent.status === "terminated") {
+            invalidAncestors.push(invalidAncestor(parent));
+        }
+        if (parent.status === "paused") {
+            pausedAncestors.push({ id: parent.id, name: parent.name, status: "paused" });
+        }
+        current = parent;
+        depth += 1;
+    }
+    const firstInvalidAncestor = invalidAncestors[0] ?? null;
+    // Only warn for agents that can themselves receive and run work: a paused,
+    // terminated, or unknown-status agent's escalation path is moot until it is
+    // invokable again. Allowlist on purpose — a denylist complement would treat
+    // unrecognized statuses as workable and warn misleadingly.
+    const agentCanWork = isAgentStatusInvokable(input.agent.status);
+    const firstPausedAncestor = pausedAncestors[0] ?? null;
+    const escalationWarning = agentCanWork && firstPausedAncestor
+        ? `Escalations from ${input.agent.name} route to paused agent ${firstPausedAncestor.name}. ` +
+            `Work assigned to a paused agent never runs; unpause ${firstPausedAncestor.name} or change who this agent reports to.`
+        : null;
+    return {
+        status: firstInvalidAncestor ? "invalid_org_chain" : "healthy",
+        reason: firstInvalidAncestor
+            ? firstInvalidAncestor.status === "missing"
+                ? "missing_manager"
+                : firstInvalidAncestor.status === "cycle"
+                    ? "cycle"
+                    : "terminated_ancestor"
+            : "healthy",
+        fullChain,
+        firstInvalidAncestor,
+        invalidAncestors,
+        repairGuidance: firstInvalidAncestor
+            ? buildRepairGuidance(input.agent, firstInvalidAncestor)
+            : null,
+        pausedAncestors,
+        escalationWarning,
+    };
+}
+export function getAgentWorkEligibility(input) {
+    const orgChainHealth = getAgentOrgChainHealth(input);
+    const assignabilityReason = !isAgentStatusAssignableToWork(input.agent.status)
+        ? input.agent.status === "terminated"
+            ? "terminated"
+            : input.agent.status === "pending_approval"
+                ? "pending_approval"
+                : "unknown_status"
+        : orgChainHealth.status === "invalid_org_chain"
+            ? "invalid_org_chain"
+            : "eligible";
+    const invokabilityReason = !isAgentStatusInvokable(input.agent.status)
+        ? input.agent.status === "terminated"
+            ? "terminated"
+            : input.agent.status === "pending_approval"
+                ? "pending_approval"
+                : input.agent.status === "paused"
+                    ? "paused"
+                    : "unknown_status"
+        : orgChainHealth.status === "invalid_org_chain"
+            ? "invalid_org_chain"
+            : "eligible";
+    return {
+        assignable: assignabilityReason === "eligible",
+        invokable: invokabilityReason === "eligible",
+        assignabilityReason,
+        invokabilityReason,
+        orgChainHealth,
+    };
+}
+export function isAgentAssignableToWork(input) {
+    return getAgentWorkEligibility(input).assignable;
+}
+export function isAgentInvokable(input) {
+    return getAgentWorkEligibility(input).invokable;
+}
+//# sourceMappingURL=agent-eligibility.js.map

package/dist/agent-eligibility.js.map

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

package/dist/agent-eligibility.test.d.ts

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

package/dist/agent-eligibility.test.d.ts.map

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

package/dist/agent-eligibility.test.js

@@ -0,0 +1,187 @@
+import { describe, expect, it } from "vitest";
+import { getAgentOrgChainHealth, getAgentWorkEligibility, isAgentAssignableToWork, isAgentInvokable, } from "./agent-eligibility.js";
+const companyId = "company-1";
+function agent(overrides = {}) {
+    return {
+        id: "agent-1",
+        companyId,
+        name: "Coder",
+        status: "active",
+        reportsTo: "manager-1",
+        ...overrides,
+    };
+}
+describe("agent work eligibility", () => {
+    it("allows healthy active agents to accept work and be invoked", () => {
+        const agents = [
+            agent(),
+            agent({ id: "manager-1", name: "CTO", status: "active", reportsTo: null }),
+        ];
+        expect(isAgentAssignableToWork({ agent: agents[0], agents })).toBe(true);
+        expect(isAgentInvokable({ agent: agents[0], agents })).toBe(true);
+        expect(getAgentWorkEligibility({ agent: agents[0], agents })).toMatchObject({
+            assignable: true,
+            invokable: true,
+            assignabilityReason: "eligible",
+            invokabilityReason: "eligible",
+            orgChainHealth: { status: "healthy" },
+        });
+    });
+    it("blocks terminated and pending approval agents from assignment and invocation", () => {
+        const manager = agent({ id: "manager-1", name: "CTO", status: "active", reportsTo: null });
+        for (const status of ["terminated", "pending_approval"]) {
+            const target = agent({ status });
+            const eligibility = getAgentWorkEligibility({ agent: target, agents: [target, manager] });
+            expect(eligibility.assignable).toBe(false);
+            expect(eligibility.invokable).toBe(false);
+            expect(eligibility.assignabilityReason).toBe(status);
+            expect(eligibility.invokabilityReason).toBe(status);
+        }
+    });
+    it("allows paused agents to keep assignments but blocks invocation", () => {
+        const target = agent({ status: "paused" });
+        const manager = agent({ id: "manager-1", name: "CTO", status: "active", reportsTo: null });
+        expect(getAgentWorkEligibility({ agent: target, agents: [target, manager] })).toMatchObject({
+            assignable: true,
+            invokable: false,
+            assignabilityReason: "eligible",
+            invokabilityReason: "paused",
+        });
+    });
+    it("reports unknown lifecycle statuses explicitly", () => {
+        const target = agent({ status: "sabbatical" });
+        const manager = agent({ id: "manager-1", name: "CTO", status: "active", reportsTo: null });
+        expect(getAgentWorkEligibility({ agent: target, agents: [target, manager] })).toMatchObject({
+            assignable: false,
+            invokable: false,
+            assignabilityReason: "unknown_status",
+            invokabilityReason: "unknown_status",
+            orgChainHealth: { status: "healthy" },
+        });
+    });
+    it("blocks active descendants of terminated ancestors and reports repair details", () => {
+        const target = agent({ id: "qa-2", name: "QA 2", status: "active", reportsTo: "cto-2" });
+        const terminatedManager = agent({
+            id: "cto-2",
+            name: "CTO 2",
+            status: "terminated",
+            reportsTo: "ceo-2",
+        });
+        const terminatedRoot = agent({
+            id: "ceo-2",
+            name: "CEO 2",
+            status: "terminated",
+            reportsTo: null,
+        });
+        const agents = [target, terminatedManager, terminatedRoot];
+        const health = getAgentOrgChainHealth({ agent: target, agents });
+        expect(health.status).toBe("invalid_org_chain");
+        expect(health.reason).toBe("terminated_ancestor");
+        expect(health.fullChain).toEqual([
+            expect.objectContaining({ id: "qa-2", name: "QA 2", relation: "self", depth: 0 }),
+            expect.objectContaining({ id: "cto-2", name: "CTO 2", status: "terminated", relation: "ancestor", depth: 1 }),
+            expect.objectContaining({ id: "ceo-2", name: "CEO 2", status: "terminated", relation: "ancestor", depth: 2 }),
+        ]);
+        expect(health.firstInvalidAncestor).toEqual({ id: "cto-2", name: "CTO 2", status: "terminated" });
+        expect(health.invalidAncestors).toEqual([
+            { id: "cto-2", name: "CTO 2", status: "terminated" },
+            { id: "ceo-2", name: "CEO 2", status: "terminated" },
+        ]);
+        expect(health.repairGuidance).toContain("QA 2 reports through terminated ancestor CTO 2");
+        const eligibility = getAgentWorkEligibility({ agent: target, agents });
+        expect(eligibility.assignable).toBe(false);
+        expect(eligibility.invokable).toBe(false);
+        expect(eligibility.assignabilityReason).toBe("invalid_org_chain");
+        expect(eligibility.invokabilityReason).toBe("invalid_org_chain");
+    });
+    it("blocks agents whose manager is missing from the company org", () => {
+        const target = agent({ id: "qa-3", name: "QA 3", status: "active", reportsTo: "missing-manager" });
+        const health = getAgentOrgChainHealth({ agent: target, agents: [target] });
+        expect(health.status).toBe("invalid_org_chain");
+        expect(health.reason).toBe("missing_manager");
+        expect(health.fullChain).toEqual([
+            expect.objectContaining({ id: "qa-3", relation: "self", depth: 0 }),
+            expect.objectContaining({ id: "missing-manager", status: "missing", relation: "ancestor", depth: 1 }),
+        ]);
+        expect(health.repairGuidance).toContain("QA 3 reports to missing manager missing-manager");
+        const eligibility = getAgentWorkEligibility({ agent: target, agents: [target] });
+        expect(eligibility.assignable).toBe(false);
+        expect(eligibility.invokable).toBe(false);
+        expect(eligibility.assignabilityReason).toBe("invalid_org_chain");
+        expect(eligibility.invokabilityReason).toBe("invalid_org_chain");
+    });
+    it("blocks agents with reporting cycles", () => {
+        const target = agent({ id: "qa-4", name: "QA 4", status: "active", reportsTo: "cto-4" });
+        const manager = agent({ id: "cto-4", name: "CTO 4", status: "active", reportsTo: "qa-4" });
+        const agents = [target, manager];
+        const health = getAgentOrgChainHealth({ agent: target, agents });
+        expect(health.status).toBe("invalid_org_chain");
+        expect(health.reason).toBe("cycle");
+        expect(health.fullChain).toEqual([
+            expect.objectContaining({ id: "qa-4", relation: "self", depth: 0 }),
+            expect.objectContaining({ id: "cto-4", relation: "ancestor", depth: 1 }),
+            expect.objectContaining({ id: "qa-4", status: "cycle", relation: "ancestor", depth: 2 }),
+        ]);
+        expect(health.repairGuidance).toContain("QA 4 has a cycle in its reporting chain");
+        const eligibility = getAgentWorkEligibility({ agent: target, agents });
+        expect(eligibility.assignable).toBe(false);
+        expect(eligibility.invokable).toBe(false);
+        expect(eligibility.assignabilityReason).toBe("invalid_org_chain");
+        expect(eligibility.invokabilityReason).toBe("invalid_org_chain");
+    });
+});
+describe("paused escalation path warning", () => {
+    it("warns when an active agent's manager is paused", () => {
+        const manager = agent({ id: "manager-1", name: "CTO", status: "paused", reportsTo: null });
+        const coder = agent({ id: "agent-1", name: "Coder", status: "active", reportsTo: "manager-1" });
+        const result = getAgentWorkEligibility({ agent: coder, agents: [coder, manager] });
+        expect(result.invokable).toBe(true);
+        expect(result.orgChainHealth.status).toBe("healthy");
+        expect(result.orgChainHealth.pausedAncestors).toEqual([
+            { id: "manager-1", name: "CTO", status: "paused" },
+        ]);
+        expect(result.orgChainHealth.escalationWarning).toContain("route to paused agent CTO");
+        expect(result.orgChainHealth.escalationWarning).toContain("never runs");
+    });
+    it("warns about a paused grandparent through a healthy manager", () => {
+        const executive = agent({ id: "exec-1", name: "CEO", status: "paused", reportsTo: null });
+        const manager = agent({ id: "manager-1", name: "CTO", status: "active", reportsTo: "exec-1" });
+        const coder = agent({ id: "agent-1", name: "Coder", status: "active", reportsTo: "manager-1" });
+        const result = getAgentWorkEligibility({ agent: coder, agents: [coder, manager, executive] });
+        expect(result.orgChainHealth.pausedAncestors).toEqual([
+            { id: "exec-1", name: "CEO", status: "paused" },
+        ]);
+        expect(result.orgChainHealth.escalationWarning).toContain("CEO");
+    });
+    it("does not warn when the agent itself is paused", () => {
+        const manager = agent({ id: "manager-1", name: "CTO", status: "paused", reportsTo: null });
+        const coder = agent({ id: "agent-1", name: "Coder", status: "paused", reportsTo: "manager-1" });
+        const result = getAgentWorkEligibility({ agent: coder, agents: [coder, manager] });
+        expect(result.orgChainHealth.escalationWarning).toBeNull();
+        expect(result.orgChainHealth.pausedAncestors).toEqual([
+            { id: "manager-1", name: "CTO", status: "paused" },
+        ]);
+    });
+    it("does not warn for agents with unknown statuses", () => {
+        const manager = agent({ id: "manager-1", name: "CTO", status: "paused", reportsTo: null });
+        const coder = agent({ id: "agent-1", name: "Coder", status: "mystery", reportsTo: "manager-1" });
+        const result = getAgentWorkEligibility({ agent: coder, agents: [coder, manager] });
+        expect(result.invokable).toBe(false);
+        expect(result.orgChainHealth.escalationWarning).toBeNull();
+    });
+    it("does not warn on a fully active chain", () => {
+        const manager = agent({ id: "manager-1", name: "CTO", status: "active", reportsTo: null });
+        const coder = agent({ id: "agent-1", name: "Coder", status: "active", reportsTo: "manager-1" });
+        const result = getAgentWorkEligibility({ agent: coder, agents: [coder, manager] });
+        expect(result.orgChainHealth.escalationWarning).toBeNull();
+        expect(result.orgChainHealth.pausedAncestors).toEqual([]);
+    });
+    it("keeps invalid-chain classification for terminated ancestors, without duplicating them as paused", () => {
+        const manager = agent({ id: "manager-1", name: "CTO", status: "terminated", reportsTo: null });
+        const coder = agent({ id: "agent-1", name: "Coder", status: "active", reportsTo: "manager-1" });
+        const result = getAgentWorkEligibility({ agent: coder, agents: [coder, manager] });
+        expect(result.orgChainHealth.status).toBe("invalid_org_chain");
+        expect(result.orgChainHealth.pausedAncestors).toEqual([]);
+    });
+});
+//# sourceMappingURL=agent-eligibility.test.js.map

package/dist/agent-eligibility.test.js.map

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

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

@@ -0,0 +1,4 @@
+export declare function isUuidLike(value: string | null | undefined): boolean;
+export declare function normalizeAgentUrlKey(value: string | null | undefined): string | null;
+export declare function deriveAgentUrlKey(name: string | null | undefined, fallback?: string | null): string;
+//# sourceMappingURL=agent-url-key.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent-url-key.d.ts","sourceRoot":"","sources":["../src/agent-url-key.ts"],"names":[],"mappings":"AAIA,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAGpE;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAQpF;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAEnG"}

package/dist/agent-url-key.js

@@ -0,0 +1,22 @@
+const AGENT_URL_KEY_DELIM_RE = /[^a-z0-9]+/g;
+const AGENT_URL_KEY_TRIM_RE = /^-+|-+$/g;
+const UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
+export function isUuidLike(value) {
+    if (typeof value !== "string")
+        return false;
+    return UUID_RE.test(value.trim());
+}
+export function normalizeAgentUrlKey(value) {
+    if (typeof value !== "string")
+        return null;
+    const normalized = value
+        .trim()
+        .toLowerCase()
+        .replace(AGENT_URL_KEY_DELIM_RE, "-")
+        .replace(AGENT_URL_KEY_TRIM_RE, "");
+    return normalized.length > 0 ? normalized : null;
+}
+export function deriveAgentUrlKey(name, fallback) {
+    return normalizeAgentUrlKey(name) ?? normalizeAgentUrlKey(fallback) ?? "agent";
+}
+//# sourceMappingURL=agent-url-key.js.map

package/dist/agent-url-key.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-url-key.js","sourceRoot":"","sources":["../src/agent-url-key.ts"],"names":[],"mappings":"AAAA,MAAM,sBAAsB,GAAG,aAAa,CAAC;AAC7C,MAAM,qBAAqB,GAAG,UAAU,CAAC;AACzC,MAAM,OAAO,GAAG,4EAA4E,CAAC;AAE7F,MAAM,UAAU,UAAU,CAAC,KAAgC;IACzD,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5C,OAAO,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,KAAgC;IACnE,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC3C,MAAM,UAAU,GAAG,KAAK;SACrB,IAAI,EAAE;SACN,WAAW,EAAE;SACb,OAAO,CAAC,sBAAsB,EAAE,GAAG,CAAC;SACpC,OAAO,CAAC,qBAAqB,EAAE,EAAE,CAAC,CAAC;IACtC,OAAO,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC;AACnD,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,IAA+B,EAAE,QAAwB;IACzF,OAAO,oBAAoB,CAAC,IAAI,CAAC,IAAI,oBAAoB,CAAC,QAAQ,CAAC,IAAI,OAAO,CAAC;AACjF,CAAC"}