@cavi-ai/api-client 0.1.0

package/dist/extensions/cavi/registry/canonical-team-registry.d.ts

@@ -0,0 +1,41 @@
+import type { OperatorRegistrySnapshot, OperatorRegistryTeam } from "../domain/index.js";
+import { normalizeTeamLookupValue, type TeamRegistryConfig, type TeamRegistryTeamConfig } from "./team-registry.js";
+export { normalizeTeamLookupValue };
+export { buildAgentMainSessionKey, normalizeSessionAgentId, normalizeSessionKey, parseAgentSessionKey, sessionKeysEqual, type ParsedAgentSessionKey, } from "./session-keys.js";
+export type CaviTeamPortalId = string;
+export declare function listCaviTeamPortalIds(): string[];
+export declare function configureCanonicalOperatorRegistry(snapshot: OperatorRegistrySnapshot | null | undefined): void;
+export declare function configureCanonicalTeamRegistry(config: TeamRegistryConfig | null | undefined): void;
+export declare function resetCanonicalOperatorRegistry(): void;
+export declare function getOperatorTeamLookupKeys(team: OperatorRegistryTeam): string[];
+export declare function matchesOperatorTeamIdentifier(team: OperatorRegistryTeam, identifier: string | null | undefined): boolean;
+export declare function resolveCompiledCanonicalTeam(identifier: string | null | undefined): OperatorRegistryTeam | null;
+export declare function resolveTeamFromCollection(teams: OperatorRegistryTeam[], identifier: string | null | undefined): OperatorRegistryTeam | null;
+export declare function backfillCanonicalTeam(team: TeamRegistryTeamConfig): OperatorRegistryTeam;
+export declare function matchesTaskTargetToTeam(target: {
+    team_id?: string | null;
+    team_slug?: string | null;
+}, team: OperatorRegistryTeam): boolean;
+export declare function getPortalTeamIdentity(portalId: CaviTeamPortalId): OperatorRegistryTeam;
+export declare function getPortalTeamCode(portalId: CaviTeamPortalId): string;
+export declare function resolveTeamSessionAgentId(params: {
+    teamId?: string | null;
+    operatorTeamId?: string | null;
+    operatorTeamSlug?: string | null;
+    agentAlias?: string | null;
+}): string | null;
+export declare function resolveTeamSessionKey(params: {
+    teamId?: string | null;
+    operatorTeamId?: string | null;
+    operatorTeamSlug?: string | null;
+    agentAlias?: string | null;
+    suffix?: string | null;
+}): string | null;
+export declare function resolvePortalPrimarySessionKey(params: {
+    portalId: CaviTeamPortalId;
+    suffix?: string | null;
+}): string | null;
+export declare function getPortalTeamSlug(portalId: CaviTeamPortalId): string;
+export declare function getPortalTeamSectorSlug(portalId: CaviTeamPortalId): string;
+export declare function listCompiledCanonicalTeams(): OperatorRegistryTeam[];
+//# sourceMappingURL=canonical-team-registry.d.ts.map

package/dist/extensions/cavi/registry/canonical-team-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canonical-team-registry.d.ts","sourceRoot":"","sources":["../../../../src/extensions/cavi/registry/canonical-team-registry.ts"],"names":[],"mappings":"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"}

package/dist/extensions/cavi/registry/canonical-team-registry.js

@@ -0,0 +1,102 @@
+import { configureTeamRegistryConfig, getConfiguredTeamRegistry, resetTeamRegistryConfig, } from "./team-registry-config.js";
+import { getTeamLookupKeys, matchesTeamIdentifier, normalizeTeamLookupValue, normalizeTeamRegistryTeam, resolveTeamFromCollection as resolveTeamFromConfiguredCollection, } from "./team-registry.js";
+import { DEFAULT_AGENT_SESSION_SUFFIX, normalizeSessionAgentId, normalizeSessionKeyPart, } from "./session-keys.js";
+export { normalizeTeamLookupValue };
+export { buildAgentMainSessionKey, normalizeSessionAgentId, normalizeSessionKey, parseAgentSessionKey, sessionKeysEqual, } from "./session-keys.js";
+export function listCaviTeamPortalIds() {
+    return getConfiguredTeamRegistry().listPortalIds();
+}
+export function configureCanonicalOperatorRegistry(snapshot) {
+    configureTeamRegistryConfig({
+        provider: "gateway",
+        snapshot: snapshot ?? null,
+    });
+}
+export function configureCanonicalTeamRegistry(config) {
+    configureTeamRegistryConfig(config);
+}
+export function resetCanonicalOperatorRegistry() {
+    resetTeamRegistryConfig();
+}
+export function getOperatorTeamLookupKeys(team) {
+    return getTeamLookupKeys(team);
+}
+export function matchesOperatorTeamIdentifier(team, identifier) {
+    if (!identifier?.trim()) {
+        return false;
+    }
+    return matchesTeamIdentifier(team, identifier);
+}
+export function resolveCompiledCanonicalTeam(identifier) {
+    return getConfiguredTeamRegistry().resolveTeam(identifier);
+}
+export function resolveTeamFromCollection(teams, identifier) {
+    return resolveTeamFromConfiguredCollection(teams, identifier);
+}
+export function backfillCanonicalTeam(team) {
+    const runtimeLegacyAliases = Array.isArray(team.legacyAliases)
+        ? team.legacyAliases
+        : [];
+    const aliasFallback = runtimeLegacyAliases.find((alias) => resolveCompiledCanonicalTeam(alias) !== null) ?? null;
+    const fallback = resolveCompiledCanonicalTeam(team.teamCode) ??
+        resolveCompiledCanonicalTeam(team.teamSlug) ??
+        resolveCompiledCanonicalTeam(team.portalId) ??
+        resolveCompiledCanonicalTeam(team.id) ??
+        resolveCompiledCanonicalTeam(aliasFallback) ??
+        null;
+    return normalizeTeamRegistryTeam(team, fallback);
+}
+export function matchesTaskTargetToTeam(target, team) {
+    const needles = new Set(getOperatorTeamLookupKeys(team));
+    const teamId = target.team_id
+        ? normalizeTeamLookupValue(target.team_id)
+        : null;
+    const teamSlug = target.team_slug
+        ? normalizeTeamLookupValue(target.team_slug)
+        : null;
+    return Boolean((teamId && needles.has(teamId)) || (teamSlug && needles.has(teamSlug)));
+}
+export function getPortalTeamIdentity(portalId) {
+    return getConfiguredTeamRegistry().getPortalTeam(portalId);
+}
+export function getPortalTeamCode(portalId) {
+    return getConfiguredTeamRegistry().getPortalTeamCode(portalId);
+}
+export function resolveTeamSessionAgentId(params) {
+    const explicitAlias = normalizeSessionAgentId(params.agentAlias);
+    if (explicitAlias) {
+        return explicitAlias;
+    }
+    const team = resolveCompiledCanonicalTeam(params.operatorTeamSlug) ??
+        resolveCompiledCanonicalTeam(params.operatorTeamId) ??
+        resolveCompiledCanonicalTeam(params.teamId);
+    if (!team) {
+        return normalizeSessionAgentId(params.operatorTeamSlug ?? params.teamId);
+    }
+    return (normalizeSessionAgentId(team.lead) ??
+        normalizeSessionAgentId(team.dispatchDefaultAlias) ??
+        normalizeSessionAgentId(team.teamSlug));
+}
+export function resolveTeamSessionKey(params) {
+    const agentId = resolveTeamSessionAgentId(params);
+    if (!agentId) {
+        return null;
+    }
+    const suffix = normalizeSessionKeyPart(params.suffix) || DEFAULT_AGENT_SESSION_SUFFIX;
+    return `agent:${agentId}:${suffix}`;
+}
+export function resolvePortalPrimarySessionKey(params) {
+    return resolveTeamSessionKey({
+        teamId: params.portalId,
+        suffix: params.suffix,
+    });
+}
+export function getPortalTeamSlug(portalId) {
+    return getConfiguredTeamRegistry().getPortalTeamSlug(portalId);
+}
+export function getPortalTeamSectorSlug(portalId) {
+    return getConfiguredTeamRegistry().getPortalTeamSectorSlug(portalId);
+}
+export function listCompiledCanonicalTeams() {
+    return getConfiguredTeamRegistry().listTeams();
+}

package/dist/extensions/cavi/registry/portal-library-registry.d.ts

@@ -0,0 +1,6 @@
+import type { PortalLibraryRef } from "../contracts/portals.js";
+export declare function getFleetLibraryRef(): PortalLibraryRef;
+export declare function resolvePortalLibraryRef(portalId: string): PortalLibraryRef | null;
+export declare function resolveLibraryRefByTeamIdentity(value: string | null | undefined): PortalLibraryRef | null;
+export declare function listPortalLibraryRefs(): PortalLibraryRef[];
+//# sourceMappingURL=portal-library-registry.d.ts.map

package/dist/extensions/cavi/registry/portal-library-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"portal-library-registry.d.ts","sourceRoot":"","sources":["../../../../src/extensions/cavi/registry/portal-library-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAGhE,wBAAgB,kBAAkB,IAAI,gBAAgB,CAQrD;AAED,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CAEjF;AAED,wBAAgB,+BAA+B,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,gBAAgB,GAAG,IAAI,CAEzG;AAED,wBAAgB,qBAAqB,IAAI,gBAAgB,EAAE,CAE1D"}

package/dist/extensions/cavi/registry/portal-library-registry.js

@@ -0,0 +1,17 @@
+import { getConfiguredTeamRegistry } from "./team-registry-config.js";
+export function getFleetLibraryRef() {
+    const ref = getConfiguredTeamRegistry().getFleetLibraryRef();
+    if (!ref) {
+        throw new Error("Team registry config does not define a fleet library ref. Load TEAM_REGISTRY_CONFIG before using library APIs.");
+    }
+    return ref;
+}
+export function resolvePortalLibraryRef(portalId) {
+    return getConfiguredTeamRegistry().resolvePortalLibraryRef(portalId);
+}
+export function resolveLibraryRefByTeamIdentity(value) {
+    return getConfiguredTeamRegistry().resolveLibraryRefByTeamIdentity(value);
+}
+export function listPortalLibraryRefs() {
+    return getConfiguredTeamRegistry().listLibraryRefs();
+}

package/dist/extensions/cavi/registry/session-keys.d.ts

@@ -0,0 +1,16 @@
+export declare const DEFAULT_AGENT_SESSION_AGENT_ID = "main";
+export declare const DEFAULT_AGENT_SESSION_SUFFIX = "main";
+export type ParsedAgentSessionKey = {
+    agentId: string;
+    rest: string;
+};
+export declare function normalizeSessionKeyPart(value: string | null | undefined): string;
+export declare function normalizeSessionAgentId(value: string | null | undefined): string | null;
+export declare function parseAgentSessionKey(sessionKey: string | null | undefined): ParsedAgentSessionKey | null;
+export declare function buildAgentMainSessionKey(params: {
+    agentId: string | null | undefined;
+    mainKey?: string | null | undefined;
+}): string;
+export declare function normalizeSessionKey(value: string | null | undefined): string | null;
+export declare function sessionKeysEqual(left: string | null | undefined, right: string | null | undefined): boolean;
+//# sourceMappingURL=session-keys.d.ts.map

package/dist/extensions/cavi/registry/session-keys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-keys.d.ts","sourceRoot":"","sources":["../../../../src/extensions/cavi/registry/session-keys.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,8BAA8B,SAAS,CAAC;AACrD,eAAO,MAAM,4BAA4B,SAAS,CAAC;AAOnD,MAAM,MAAM,qBAAqB,GAAG;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAEhF;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAgBvF;AAED,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GACpC,qBAAqB,GAAG,IAAI,CAe9B;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE;IAC/C,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACnC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;CACrC,GAAG,MAAM,CAMT;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAiBnF;AAED,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAC/B,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAC/B,OAAO,CAIT"}

package/dist/extensions/cavi/registry/session-keys.js

@@ -0,0 +1,68 @@
+export const DEFAULT_AGENT_SESSION_AGENT_ID = "main";
+export const DEFAULT_AGENT_SESSION_SUFFIX = "main";
+const VALID_AGENT_ID_RE = /^[a-z0-9][a-z0-9_-]{0,63}$/i;
+const INVALID_AGENT_ID_CHARS_RE = /[^a-z0-9_-]+/g;
+const LEADING_DASH_RE = /^-+/;
+const TRAILING_DASH_RE = /-+$/;
+export function normalizeSessionKeyPart(value) {
+    return value?.trim().toLowerCase() ?? "";
+}
+export function normalizeSessionAgentId(value) {
+    const trimmed = value?.trim() ?? "";
+    if (!trimmed) {
+        return null;
+    }
+    const normalized = normalizeSessionKeyPart(trimmed);
+    if (VALID_AGENT_ID_RE.test(trimmed)) {
+        return normalized;
+    }
+    return (normalized
+        .replace(INVALID_AGENT_ID_CHARS_RE, "-")
+        .replace(LEADING_DASH_RE, "")
+        .replace(TRAILING_DASH_RE, "")
+        .slice(0, 64) || DEFAULT_AGENT_SESSION_AGENT_ID);
+}
+export function parseAgentSessionKey(sessionKey) {
+    const raw = normalizeSessionKeyPart(sessionKey);
+    if (!raw) {
+        return null;
+    }
+    const parts = raw.split(":").filter(Boolean);
+    if (parts.length < 3 || parts[0] !== "agent") {
+        return null;
+    }
+    const agentId = normalizeSessionAgentId(parts[1]);
+    const rest = parts.slice(2).join(":");
+    if (!agentId || !rest) {
+        return null;
+    }
+    return { agentId, rest };
+}
+export function buildAgentMainSessionKey(params) {
+    const agentId = normalizeSessionAgentId(params.agentId) ?? DEFAULT_AGENT_SESSION_AGENT_ID;
+    const mainKey = normalizeSessionKeyPart(params.mainKey) || DEFAULT_AGENT_SESSION_SUFFIX;
+    return `agent:${agentId}:${mainKey}`;
+}
+export function normalizeSessionKey(value) {
+    const raw = value?.trim();
+    if (!raw) {
+        return null;
+    }
+    const lowered = normalizeSessionKeyPart(raw);
+    if (lowered === DEFAULT_AGENT_SESSION_SUFFIX) {
+        return buildAgentMainSessionKey({ agentId: DEFAULT_AGENT_SESSION_AGENT_ID });
+    }
+    const parsed = parseAgentSessionKey(raw);
+    if (parsed) {
+        return `agent:${parsed.agentId}:${parsed.rest}`;
+    }
+    if (lowered.startsWith("agent:")) {
+        return lowered;
+    }
+    return lowered;
+}
+export function sessionKeysEqual(left, right) {
+    const normalizedLeft = normalizeSessionKey(left);
+    const normalizedRight = normalizeSessionKey(right);
+    return Boolean(normalizedLeft && normalizedRight && normalizedLeft === normalizedRight);
+}

package/dist/extensions/cavi/registry/team-registry-config.d.ts

@@ -0,0 +1,6 @@
+import { type CreateTeamRegistryOptions, type TeamRegistry, type TeamRegistryConfig } from "./team-registry.js";
+export declare const TEAM_REGISTRY_CONFIG: TeamRegistryConfig;
+export declare function configureTeamRegistryConfig(config: TeamRegistryConfig | null | undefined): void;
+export declare function resetTeamRegistryConfig(): void;
+export declare function getConfiguredTeamRegistry(options?: CreateTeamRegistryOptions): TeamRegistry;
+//# sourceMappingURL=team-registry-config.d.ts.map

package/dist/extensions/cavi/registry/team-registry-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"team-registry-config.d.ts","sourceRoot":"","sources":["../../../../src/extensions/cavi/registry/team-registry-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,yBAAyB,EAC9B,KAAK,YAAY,EACjB,KAAK,kBAAkB,EACxB,MAAM,oBAAoB,CAAC;AAE5B,eAAO,MAAM,oBAAoB,EAAE,kBAMlC,CAAC;AAEF,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,kBAAkB,GAAG,IAAI,GAAG,SAAS,GAC5C,IAAI,CAQN;AAED,wBAAgB,uBAAuB,IAAI,IAAI,CAE9C;AAED,wBAAgB,yBAAyB,CACvC,OAAO,GAAE,yBAA8B,GACtC,YAAY,CAEd"}

package/dist/extensions/cavi/registry/team-registry-config.js

@@ -0,0 +1,23 @@
+import { createTeamRegistry, } from "./team-registry.js";
+export const TEAM_REGISTRY_CONFIG = {
+    manifest: null,
+    teams: [],
+    libraries: {
+        teams: [],
+    },
+};
+export function configureTeamRegistryConfig(config) {
+    Object.assign(TEAM_REGISTRY_CONFIG, {
+        provider: config?.provider ?? null,
+        manifest: config?.manifest ?? null,
+        teams: config?.teams ?? [],
+        libraries: config?.libraries ?? { teams: [] },
+        snapshot: config?.snapshot ?? null,
+    });
+}
+export function resetTeamRegistryConfig() {
+    configureTeamRegistryConfig(null);
+}
+export function getConfiguredTeamRegistry(options = {}) {
+    return createTeamRegistry(TEAM_REGISTRY_CONFIG, options);
+}

package/dist/extensions/cavi/registry/team-registry.d.ts

@@ -0,0 +1,49 @@
+import type { OperatorRegistrySnapshot, OperatorRegistryTeam } from "../domain/index.js";
+import type { PortalLibraryRef } from "../contracts/portals.js";
+import { type TeamManifest } from "../../../contracts/team-manifest.js";
+export type TeamRegistryProviderKind = "gateway" | "hermes" | "openclaw" | (string & {});
+export type TeamRegistryTeamConfig = Partial<OperatorRegistryTeam> & {
+    id: string;
+    name?: string | null;
+};
+export type TeamRegistryLibraryRefConfig = PortalLibraryRef & {
+    lookupKeys?: readonly string[];
+};
+export type TeamRegistryLibraryConfig = {
+    fleet?: TeamRegistryLibraryRefConfig | null;
+    teams?: readonly TeamRegistryLibraryRefConfig[] | null;
+};
+export type TeamRegistryConfig = {
+    provider?: TeamRegistryProviderKind | null;
+    manifest?: Partial<TeamManifest> | null;
+    teams?: readonly TeamRegistryTeamConfig[] | null;
+    libraries?: TeamRegistryLibraryConfig | null;
+    snapshot?: Pick<OperatorRegistrySnapshot, "teams"> | null;
+};
+export type CreateTeamRegistryOptions = {
+    provider?: TeamRegistryProviderKind | null;
+};
+export interface TeamRegistry {
+    readonly provider: TeamRegistryProviderKind;
+    listTeams(): OperatorRegistryTeam[];
+    listPortalIds(): string[];
+    getTeamLookupKeys(team: OperatorRegistryTeam): string[];
+    resolveTeam(identifier: string | null | undefined): OperatorRegistryTeam | null;
+    requireTeam(identifier: string | null | undefined): OperatorRegistryTeam;
+    getPortalTeam(portalId: string | null | undefined): OperatorRegistryTeam;
+    getPortalTeamCode(portalId: string | null | undefined): string;
+    getPortalTeamSlug(portalId: string | null | undefined): string;
+    getPortalTeamSectorSlug(portalId: string | null | undefined): string;
+    getFleetLibraryRef(): PortalLibraryRef | null;
+    resolvePortalLibraryRef(portalId: string | null | undefined): PortalLibraryRef | null;
+    resolveLibraryRefByTeamIdentity(value: string | null | undefined): PortalLibraryRef | null;
+    listLibraryRefs(): PortalLibraryRef[];
+}
+export declare function normalizeTeamLookupValue(value: string): string;
+export declare function getTeamLookupKeys(team: OperatorRegistryTeam): string[];
+export declare function matchesTeamIdentifier(team: OperatorRegistryTeam, identifier: string | null | undefined): boolean;
+export declare function normalizeTeamRegistryTeam(team: TeamRegistryTeamConfig, fallback?: OperatorRegistryTeam | null): OperatorRegistryTeam;
+export declare function resolveTeamFromCollection(teams: readonly OperatorRegistryTeam[], identifier: string | null | undefined): OperatorRegistryTeam | null;
+export declare function createTeamRegistry(config?: TeamRegistryConfig, options?: CreateTeamRegistryOptions): TeamRegistry;
+export declare function createTeamRegistryFromSnapshot(snapshot: OperatorRegistrySnapshot | null | undefined, options?: CreateTeamRegistryOptions): TeamRegistry;
+//# sourceMappingURL=team-registry.d.ts.map

package/dist/extensions/cavi/registry/team-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"team-registry.d.ts","sourceRoot":"","sources":["../../../../src/extensions/cavi/registry/team-registry.ts"],"names":[],"mappings":"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"}

package/dist/extensions/cavi/registry/team-registry.js

@@ -0,0 +1,290 @@
+import { normalizeTeamManifest, } from "../../../contracts/team-manifest.js";
+function uniqStrings(values) {
+    const seen = new Set();
+    const unique = [];
+    for (const value of values) {
+        if (!value) {
+            continue;
+        }
+        const trimmed = value.trim();
+        if (!trimmed) {
+            continue;
+        }
+        const key = normalizeTeamLookupValue(trimmed);
+        if (seen.has(key)) {
+            continue;
+        }
+        seen.add(key);
+        unique.push(trimmed);
+    }
+    return unique;
+}
+function coerceStringArray(value) {
+    if (Array.isArray(value)) {
+        return value.filter((entry) => typeof entry === "string");
+    }
+    if (typeof value === "string") {
+        return [value];
+    }
+    return [];
+}
+function toPortalLibraryRef(record) {
+    return {
+        scope: record.scope,
+        libraryTeamId: record.libraryTeamId,
+        ...(record.ownerPortalId ? { ownerPortalId: record.ownerPortalId } : {}),
+    };
+}
+function teamFromManifest(team) {
+    const identity = team.identity ?? {};
+    const name = identity.name ?? identity.displayName ?? team.id;
+    const teamSlug = identity.slug ?? team.id;
+    const teamCode = identity.code ?? teamSlug;
+    const sectorSlug = identity.sectorSlug ?? teamSlug;
+    const sectorCode = identity.sectorCode ?? teamCode;
+    const members = team.members?.map((member) => member.id) ?? [];
+    return {
+        id: team.id,
+        name,
+        displayName: identity.displayName ?? name,
+        teamSlug,
+        teamCode,
+        sectorSlug,
+        sectorCode,
+        portalId: identity.portalId ?? null,
+        legacyAliases: [...(identity.aliases ?? [])],
+        members,
+        memberIdentityIds: members,
+        ownsCapabilities: [...(team.capabilities ?? [])],
+        teamManifest: null,
+    };
+}
+function configuredTeams(config) {
+    if (config.snapshot?.teams?.length) {
+        return config.snapshot.teams;
+    }
+    if (config.manifest) {
+        return normalizeTeamManifest(config.manifest).teams.map(teamFromManifest);
+    }
+    return config.teams ?? [];
+}
+function missingRegistryMessage(identifier) {
+    const suffix = identifier?.trim() ? ` for "${identifier.trim()}"` : "";
+    return `Team registry is not configured${suffix}. Load TEAM_REGISTRY_CONFIG from the selected gateway/plugin before using registry-dependent APIs.`;
+}
+export function normalizeTeamLookupValue(value) {
+    return value.trim().toLowerCase().replace(/_/g, "-").replace(/\s+/g, "-");
+}
+export function getTeamLookupKeys(team) {
+    return uniqStrings([
+        team.teamCode,
+        team.teamSlug,
+        team.id,
+        team.portalId,
+        ...coerceStringArray(team.legacyAliases),
+    ]).map(normalizeTeamLookupValue);
+}
+export function matchesTeamIdentifier(team, identifier) {
+    if (!identifier?.trim()) {
+        return false;
+    }
+    return getTeamLookupKeys(team).includes(normalizeTeamLookupValue(identifier));
+}
+export function normalizeTeamRegistryTeam(team, fallback) {
+    const name = team.name?.trim() || fallback?.name || team.id;
+    const displayName = team.displayName?.trim() || fallback?.displayName || name;
+    const teamSlug = team.teamSlug?.trim() || fallback?.teamSlug || team.id;
+    const teamCode = team.teamCode?.trim() || fallback?.teamCode || team.id;
+    const sectorSlug = team.sectorSlug?.trim() ||
+        fallback?.sectorSlug ||
+        team.department?.trim() ||
+        team.kind?.trim() ||
+        teamSlug;
+    const sectorCode = team.sectorCode?.trim() || fallback?.sectorCode || teamCode;
+    return {
+        id: team.id,
+        name,
+        teamSlug,
+        teamCode,
+        sectorSlug,
+        sectorCode,
+        portalId: team.portalId ?? fallback?.portalId ?? null,
+        displayName,
+        legacyAliases: uniqStrings([
+            ...coerceStringArray(team.legacyAliases),
+            ...coerceStringArray(fallback?.legacyAliases),
+        ]),
+        department: team.department ?? fallback?.department ?? sectorSlug,
+        kind: team.kind ?? fallback?.kind ?? null,
+        parentTeamId: team.parentTeamId ?? fallback?.parentTeamId ?? null,
+        lead: team.lead ?? fallback?.lead ?? null,
+        leadKind: team.leadKind ?? fallback?.leadKind ?? null,
+        routeViaLead: team.routeViaLead ?? fallback?.routeViaLead ?? false,
+        mission: team.mission ?? fallback?.mission ?? null,
+        members: team.members ?? fallback?.members ?? [],
+        runtimeIds: team.runtimeIds ?? fallback?.runtimeIds ?? [],
+        memberIdentityIds: team.memberIdentityIds ?? fallback?.memberIdentityIds ?? [],
+        ownsCapabilities: team.ownsCapabilities ?? fallback?.ownsCapabilities ?? [],
+        maxParallel: team.maxParallel ?? fallback?.maxParallel ?? null,
+        dispatchTransport: team.dispatchTransport ?? fallback?.dispatchTransport ?? null,
+        dispatchEndpointEnv: team.dispatchEndpointEnv ?? fallback?.dispatchEndpointEnv ?? null,
+        dispatchPath: team.dispatchPath ?? fallback?.dispatchPath ?? null,
+        dispatchAuthScheme: team.dispatchAuthScheme ?? fallback?.dispatchAuthScheme ?? null,
+        dispatchAuthEnv: team.dispatchAuthEnv ?? fallback?.dispatchAuthEnv ?? null,
+        dispatchDefaultAlias: team.dispatchDefaultAlias ?? fallback?.dispatchDefaultAlias ?? null,
+        routingPolicy: team.routingPolicy ?? fallback?.routingPolicy ?? null,
+        notes: team.notes ?? fallback?.notes ?? null,
+        ancestorTeamIds: team.ancestorTeamIds ?? fallback?.ancestorTeamIds ?? [],
+        descendantTeamIds: team.descendantTeamIds ?? fallback?.descendantTeamIds ?? [],
+        teamManifest: team.teamManifest ?? fallback?.teamManifest ?? null,
+        headOwnedAliases: team.headOwnedAliases ?? fallback?.headOwnedAliases ?? [],
+        runtimeMembers: team.runtimeMembers ?? fallback?.runtimeMembers ?? [],
+    };
+}
+export function resolveTeamFromCollection(teams, identifier) {
+    if (!identifier?.trim()) {
+        return null;
+    }
+    return (teams.find((team) => matchesTeamIdentifier(team, identifier)) ?? null);
+}
+function assertUniqueTeamRegistryLookups(teams) {
+    const lookupOwners = new Map();
+    const portalOwners = new Map();
+    for (const team of teams) {
+        if (team.portalId?.trim()) {
+            const portalId = normalizeTeamLookupValue(team.portalId);
+            const owner = portalOwners.get(portalId);
+            if (owner && owner !== team.id) {
+                throw new Error(`Team registry has duplicate portal id "${portalId}" for teams "${owner}" and "${team.id}".`);
+            }
+            portalOwners.set(portalId, team.id);
+        }
+        for (const key of getTeamLookupKeys(team)) {
+            const owner = lookupOwners.get(key);
+            if (owner && owner !== team.id) {
+                throw new Error(`Team registry has ambiguous lookup key "${key}" for teams "${owner}" and "${team.id}".`);
+            }
+            lookupOwners.set(key, team.id);
+        }
+    }
+}
+export function createTeamRegistry(config = {}, options = {}) {
+    const provider = options.provider ?? config.provider ?? "gateway";
+    const teams = configuredTeams(config).map((team) => normalizeTeamRegistryTeam(team, null));
+    assertUniqueTeamRegistryLookups(teams);
+    const fleetLibrary = config.libraries?.fleet ?? null;
+    const teamLibraries = config.libraries?.teams ?? [];
+    function resolveTeam(identifier) {
+        return resolveTeamFromCollection(teams, identifier);
+    }
+    function requireTeam(identifier) {
+        const team = resolveTeam(identifier);
+        if (!team) {
+            throw new Error(missingRegistryMessage(identifier));
+        }
+        return team;
+    }
+    function getPortalTeam(portalId) {
+        if (!portalId?.trim()) {
+            throw new Error(missingRegistryMessage(portalId));
+        }
+        const team = teams.find((entry) => entry.portalId === portalId) ??
+            resolveTeam(portalId);
+        if (!team) {
+            throw new Error(missingRegistryMessage(portalId));
+        }
+        return team;
+    }
+    function buildLookupSet(portalId, record) {
+        const team = portalId ? resolveTeam(portalId) : null;
+        return new Set([
+            portalId,
+            team?.id,
+            team?.name,
+            team?.displayName,
+            team?.teamSlug,
+            team?.teamCode,
+            team?.sectorSlug,
+            team?.department,
+            ...(team?.legacyAliases ?? []),
+            ...(record.lookupKeys ?? []),
+            record.libraryTeamId,
+        ]
+            .flatMap((value) => {
+            if (!value) {
+                return [];
+            }
+            const normalized = normalizeTeamLookupValue(value);
+            return normalized ? [normalized] : [];
+        })
+            .filter(Boolean));
+    }
+    return {
+        provider,
+        listTeams() {
+            return teams.slice();
+        },
+        listPortalIds() {
+            return teams
+                .map((team) => team.portalId)
+                .filter((portalId) => Boolean(portalId));
+        },
+        getTeamLookupKeys,
+        resolveTeam,
+        requireTeam,
+        getPortalTeam,
+        getPortalTeamCode(portalId) {
+            return getPortalTeam(portalId).teamCode;
+        },
+        getPortalTeamSlug(portalId) {
+            return getPortalTeam(portalId).teamSlug;
+        },
+        getPortalTeamSectorSlug(portalId) {
+            return getPortalTeam(portalId).sectorSlug;
+        },
+        getFleetLibraryRef() {
+            return fleetLibrary ? toPortalLibraryRef(fleetLibrary) : null;
+        },
+        resolvePortalLibraryRef(portalId) {
+            if (!portalId?.trim()) {
+                return null;
+            }
+            const normalizedPortalId = normalizeTeamLookupValue(portalId);
+            if (fleetLibrary?.ownerPortalId &&
+                normalizeTeamLookupValue(fleetLibrary.ownerPortalId) === normalizedPortalId) {
+                return toPortalLibraryRef(fleetLibrary);
+            }
+            const record = teamLibraries.find((entry) => (entry.ownerPortalId &&
+                normalizeTeamLookupValue(entry.ownerPortalId) === normalizedPortalId) ||
+                buildLookupSet(entry.ownerPortalId, entry).has(normalizedPortalId));
+            return record ? toPortalLibraryRef(record) : null;
+        },
+        resolveLibraryRefByTeamIdentity(value) {
+            const normalized = normalizeTeamLookupValue(value ?? "");
+            if (!normalized) {
+                return null;
+            }
+            if (fleetLibrary && buildLookupSet(fleetLibrary.ownerPortalId, fleetLibrary).has(normalized)) {
+                return toPortalLibraryRef(fleetLibrary);
+            }
+            for (const record of teamLibraries) {
+                if (buildLookupSet(record.ownerPortalId, record).has(normalized)) {
+                    return toPortalLibraryRef(record);
+                }
+            }
+            return null;
+        },
+        listLibraryRefs() {
+            return [
+                ...(fleetLibrary ? [toPortalLibraryRef(fleetLibrary)] : []),
+                ...teamLibraries.map(toPortalLibraryRef),
+            ];
+        },
+    };
+}
+export function createTeamRegistryFromSnapshot(snapshot, options = {}) {
+    return createTeamRegistry({
+        provider: options.provider,
+        snapshot: snapshot ?? null,
+    }, options);
+}