@vauban-org/agent-sdk 0.16.0

package/dist/registry/agent-capability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-capability.d.ts","sourceRoot":"","sources":["../../src/registry/agent-capability.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,eAAO,MAAM,WAAW,yGAUd,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAIrD,MAAM,MAAM,QAAQ,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;AACjD,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;AAIpD,MAAM,WAAW,mBAAmB;IAClC,8EAA8E;IAC9E,OAAO,EAAE,MAAM,CAAC;IAChB,iDAAiD;IACjD,IAAI,EAAE,SAAS,CAAC;IAChB,wCAAwC;IACxC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1B,0CAA0C;IAC1C,QAAQ,EAAE,QAAQ,CAAC;IACnB,sCAAsC;IACtC,WAAW,EAAE,WAAW,CAAC;IACzB,kEAAkE;IAClE,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,mDAAmD;IACnD,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/dist/registry/agent-capability.js

@@ -0,0 +1,21 @@
+/**
+ * AgentCapabilityCard — multi-kind capability descriptor for CC LLM router agents.
+ *
+ * Sprint-580 / registry-multi-kind
+ *
+ * In-memory schema only. SQL persistence via migration
+ * `036_agent_capability_index.sql` (coordinator-applied).
+ */
+// ─── Kinds ────────────────────────────────────────────────────────────────────
+export const AGENT_KINDS = [
+    "ARCHITECT",
+    "BUILDER",
+    "SCRIBE",
+    "TESTER",
+    "SYNERGY",
+    "OODA",
+    "LLM_ROUTER",
+    "PLUGIN",
+    "MCP",
+];
+//# sourceMappingURL=agent-capability.js.map

package/dist/registry/agent-capability.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-capability.js","sourceRoot":"","sources":["../../src/registry/agent-capability.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,iFAAiF;AAEjF,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,WAAW;IACX,SAAS;IACT,QAAQ;IACR,QAAQ;IACR,SAAS;IACT,MAAM;IACN,YAAY;IACZ,QAAQ;IACR,KAAK;CACG,CAAC"}

package/dist/registry/agent-card.d.ts

@@ -0,0 +1,86 @@
+/**
+ * AgentCard — A2A v1.2 (Linux Foundation, 150+ orgs).
+ *
+ * Sprint-563: B8 — AgentCard + A2A v1.2 + Signed Agent Cards (CH8 activation).
+ *
+ * Converts a Vauban AgentDescriptor into an A2A v1.2-compliant AgentCard.
+ * Signed AgentCards activate CH8: Trace.agentSignature is computed from
+ * the agent's identity key.
+ */
+export interface A2AAgentCapabilities {
+    streaming?: boolean;
+    pushNotifications?: boolean;
+    stateTransitionHistory?: boolean;
+}
+export interface A2ASkill {
+    id: string;
+    name: string;
+    description: string;
+    tags?: string[];
+    inputSchema?: Record<string, unknown>;
+    outputSchema?: Record<string, unknown>;
+}
+export interface A2AAgentCard {
+    /** Agent Card spec version. */
+    protocolVersion: "1.2";
+    /** Human-readable name. */
+    name: string;
+    /** Natural language description. */
+    description: string;
+    /** Globally unique agent identifier. */
+    url: string;
+    /** Provider/org name. */
+    provider?: string;
+    /** Agent version (semver). */
+    version: string;
+    /** IANA media type for default input (default: application/json). */
+    defaultInputModes?: string[];
+    /** IANA media type for default output. */
+    defaultOutputModes?: string[];
+    /** Agent capabilities (streaming, push, state history). */
+    capabilities: A2AAgentCapabilities;
+    /** Exposed skills. */
+    skills: A2ASkill[];
+    /** Optional signature (CH8 activation). */
+    signature?: string;
+}
+export interface AgentCardOptions {
+    /** Base URL for the agent (e.g. "https://agents.vauban.tech"). */
+    baseUrl: string;
+    /** Provider/organization name. */
+    provider?: string;
+    /** Capabilities override. */
+    capabilities?: Partial<A2AAgentCapabilities>;
+    /** Signing key for CH8 Signed Agent Cards. */
+    signingKey?: {
+        sign: (payload: string) => Promise<string>;
+    };
+}
+/**
+ * Convert a Vauban AgentDescriptor into an A2A v1.2 AgentCard.
+ *
+ * Usage:
+ *   import { toAgentCard } from "@vauban-org/agent-sdk";
+ *   const card = await toAgentCard(descriptor, skills, { baseUrl: "https://agents.vauban.tech" });
+ */
+export declare function toAgentCard(descriptor: {
+    agentId: string;
+    name: string;
+    description: string;
+    version: string;
+    capabilities?: string[];
+}, skills: Array<{
+    name: string;
+    description: string;
+    inputSchema?: Record<string, unknown>;
+    outputSchema?: Record<string, unknown>;
+    tags?: string[];
+}>, opts: AgentCardOptions): Promise<A2AAgentCard>;
+/**
+ * Validate that an AgentCard has all required fields per A2A v1.2 spec.
+ */
+export declare function validateAgentCard(card: A2AAgentCard): {
+    valid: boolean;
+    errors: string[];
+};
+//# sourceMappingURL=agent-card.d.ts.map

package/dist/registry/agent-card.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-card.d.ts","sourceRoot":"","sources":["../../src/registry/agent-card.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,MAAM,WAAW,oBAAoB;IACnC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,sBAAsB,CAAC,EAAE,OAAO,CAAC;CAClC;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACxC;AAED,MAAM,WAAW,YAAY;IAC3B,+BAA+B;IAC/B,eAAe,EAAE,KAAK,CAAC;IACvB,2BAA2B;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,oCAAoC;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,wCAAwC;IACxC,GAAG,EAAE,MAAM,CAAC;IACZ,yBAAyB;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8BAA8B;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,qEAAqE;IACrE,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,0CAA0C;IAC1C,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,2DAA2D;IAC3D,YAAY,EAAE,oBAAoB,CAAC;IACnC,sBAAsB;IACtB,MAAM,EAAE,QAAQ,EAAE,CAAC;IACnB,2CAA2C;IAC3C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAID,MAAM,WAAW,gBAAgB;IAC/B,kEAAkE;IAClE,OAAO,EAAE,MAAM,CAAC;IAChB,kCAAkC;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6BAA6B;IAC7B,YAAY,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAC7C,8CAA8C;IAC9C,UAAU,CAAC,EAAE;QACX,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;KAC5C,CAAC;CACH;AAID;;;;;;GAMG;AACH,wBAAsB,WAAW,CAC/B,UAAU,EAAE;IACV,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB,EACD,MAAM,EAAE,KAAK,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB,CAAC,EACF,IAAI,EAAE,gBAAgB,GACrB,OAAO,CAAC,YAAY,CAAC,CAsCvB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,YAAY,GAAG;IACrD,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB,CAuBA"}

package/dist/registry/agent-card.js

@@ -0,0 +1,80 @@
+/**
+ * AgentCard — A2A v1.2 (Linux Foundation, 150+ orgs).
+ *
+ * Sprint-563: B8 — AgentCard + A2A v1.2 + Signed Agent Cards (CH8 activation).
+ *
+ * Converts a Vauban AgentDescriptor into an A2A v1.2-compliant AgentCard.
+ * Signed AgentCards activate CH8: Trace.agentSignature is computed from
+ * the agent's identity key.
+ */
+// ─── Builder ─────────────────────────────────────────────────────────────────
+/**
+ * Convert a Vauban AgentDescriptor into an A2A v1.2 AgentCard.
+ *
+ * Usage:
+ *   import { toAgentCard } from "@vauban-org/agent-sdk";
+ *   const card = await toAgentCard(descriptor, skills, { baseUrl: "https://agents.vauban.tech" });
+ */
+export async function toAgentCard(descriptor, skills, opts) {
+    const card = {
+        protocolVersion: "1.2",
+        name: descriptor.name,
+        description: descriptor.description,
+        url: `${opts.baseUrl}/agents/${descriptor.agentId}`,
+        provider: opts.provider ?? "vauban",
+        version: descriptor.version,
+        defaultInputModes: ["application/json"],
+        defaultOutputModes: ["application/json"],
+        capabilities: {
+            streaming: true,
+            pushNotifications: false,
+            stateTransitionHistory: true,
+            ...opts.capabilities,
+        },
+        skills: skills.map((s) => ({
+            id: `skill:${s.name}`,
+            name: s.name,
+            description: s.description,
+            tags: s.tags,
+            inputSchema: s.inputSchema,
+            outputSchema: s.outputSchema,
+        })),
+    };
+    // CH8: Sign the card if a signing key is provided
+    if (opts.signingKey) {
+        const payload = JSON.stringify({
+            name: card.name,
+            url: card.url,
+            version: card.version,
+            skills: card.skills.map((s) => s.id).sort(),
+        });
+        card.signature = await opts.signingKey.sign(payload);
+    }
+    return card;
+}
+/**
+ * Validate that an AgentCard has all required fields per A2A v1.2 spec.
+ */
+export function validateAgentCard(card) {
+    const errors = [];
+    if (card.protocolVersion !== "1.2") {
+        errors.push("protocolVersion must be '1.2'");
+    }
+    if (!card.name || card.name.trim().length === 0) {
+        errors.push("name is required");
+    }
+    if (!card.description || card.description.trim().length === 0) {
+        errors.push("description is required");
+    }
+    if (!card.url || !card.url.startsWith("https://")) {
+        errors.push("url must be a valid HTTPS URL");
+    }
+    if (!card.version) {
+        errors.push("version is required");
+    }
+    if (!card.skills || card.skills.length === 0) {
+        errors.push("at least one skill is required");
+    }
+    return { valid: errors.length === 0, errors };
+}
+//# sourceMappingURL=agent-card.js.map

package/dist/registry/agent-card.js.map

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

package/dist/registry/agent-ids.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Agent UUIDs — deterministic identifiers per agent archetype.
+ *
+ * These UUIDs attribute decisions to specific agent archetypes when calling
+ * Brain's `record_decision` MCP tool. They MUST remain stable across deploys
+ * so decision chains can be correlated over time.
+ *
+ * Derivation: UUIDv5 with a fixed namespace (`AGENT_ID_NAMESPACE`) and the
+ * archetype name as the seed. This makes them reproducible if ever lost.
+ *
+ * Namespace: `a6f9c2e4-8b5d-4e3f-a1c7-9d2b6e8f1a3c` (generated once, fixed).
+ */
+/** The five core Command Center agent archetypes. */
+export type AgentType = "ARCHITECT" | "BUILDER" | "TESTER" | "SCRIBE" | "SYNERGY";
+/** Namespace UUID used to derive agent archetype IDs. Frozen forever. */
+export declare const AGENT_ID_NAMESPACE = "a6f9c2e4-8b5d-4e3f-a1c7-9d2b6e8f1a3c";
+/**
+ * Fixed UUIDs for each Command Center agent archetype.
+ *
+ * These IDs are the `agent_id` parameter in Brain's `record_decision` MCP tool
+ * and become the foreign key on `decision_chains.agent_id`.
+ *
+ * DO NOT regenerate — any change breaks decision-chain history correlation.
+ */
+export declare const AGENT_IDS: Readonly<Record<AgentType, string>>;
+/** Resolve the deterministic UUID for an agent archetype. Throws on unknown input. */
+export declare function getAgentId(agent: AgentType): string;
+/** Reverse lookup — find the agent archetype from its UUID. Returns undefined if not found. */
+export declare function agentFromId(id: string): AgentType | undefined;
+//# sourceMappingURL=agent-ids.d.ts.map

package/dist/registry/agent-ids.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-ids.d.ts","sourceRoot":"","sources":["../../src/registry/agent-ids.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,qDAAqD;AACrD,MAAM,MAAM,SAAS,GACjB,WAAW,GACX,SAAS,GACT,QAAQ,GACR,QAAQ,GACR,SAAS,CAAC;AAEd,yEAAyE;AACzE,eAAO,MAAM,kBAAkB,yCAAyC,CAAC;AAEzE;;;;;;;GAOG;AACH,eAAO,MAAM,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAMxD,CAAC;AAEH,sFAAsF;AACtF,wBAAgB,UAAU,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAMnD;AAED,+FAA+F;AAC/F,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAK7D"}

package/dist/registry/agent-ids.js

@@ -0,0 +1,46 @@
+/**
+ * Agent UUIDs — deterministic identifiers per agent archetype.
+ *
+ * These UUIDs attribute decisions to specific agent archetypes when calling
+ * Brain's `record_decision` MCP tool. They MUST remain stable across deploys
+ * so decision chains can be correlated over time.
+ *
+ * Derivation: UUIDv5 with a fixed namespace (`AGENT_ID_NAMESPACE`) and the
+ * archetype name as the seed. This makes them reproducible if ever lost.
+ *
+ * Namespace: `a6f9c2e4-8b5d-4e3f-a1c7-9d2b6e8f1a3c` (generated once, fixed).
+ */
+/** Namespace UUID used to derive agent archetype IDs. Frozen forever. */
+export const AGENT_ID_NAMESPACE = "a6f9c2e4-8b5d-4e3f-a1c7-9d2b6e8f1a3c";
+/**
+ * Fixed UUIDs for each Command Center agent archetype.
+ *
+ * These IDs are the `agent_id` parameter in Brain's `record_decision` MCP tool
+ * and become the foreign key on `decision_chains.agent_id`.
+ *
+ * DO NOT regenerate — any change breaks decision-chain history correlation.
+ */
+export const AGENT_IDS = Object.freeze({
+    ARCHITECT: "449287f0-db80-5f95-baf7-31a7e52adac6",
+    BUILDER: "4c85dcf3-a4a9-5f8d-9b6d-b1275b799656",
+    TESTER: "bae97868-daa2-56f7-9a64-23791f62110d",
+    SCRIBE: "c371feea-bf3c-506d-92ef-f4cbf4d652f9",
+    SYNERGY: "3362a6cf-b69a-5c52-ba44-3561a4b4563c",
+});
+/** Resolve the deterministic UUID for an agent archetype. Throws on unknown input. */
+export function getAgentId(agent) {
+    const id = AGENT_IDS[agent];
+    if (!id) {
+        throw new Error(`Unknown agent archetype: ${agent}`);
+    }
+    return id;
+}
+/** Reverse lookup — find the agent archetype from its UUID. Returns undefined if not found. */
+export function agentFromId(id) {
+    for (const [agent, agentId] of Object.entries(AGENT_IDS)) {
+        if (agentId === id)
+            return agent;
+    }
+    return undefined;
+}
+//# sourceMappingURL=agent-ids.js.map

package/dist/registry/agent-ids.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-ids.js","sourceRoot":"","sources":["../../src/registry/agent-ids.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAUH,yEAAyE;AACzE,MAAM,CAAC,MAAM,kBAAkB,GAAG,sCAAsC,CAAC;AAEzE;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,SAAS,GAAwC,MAAM,CAAC,MAAM,CAAC;IAC1E,SAAS,EAAE,sCAAsC;IACjD,OAAO,EAAE,sCAAsC;IAC/C,MAAM,EAAE,sCAAsC;IAC9C,MAAM,EAAE,sCAAsC;IAC9C,OAAO,EAAE,sCAAsC;CAChD,CAAC,CAAC;AAEH,sFAAsF;AACtF,MAAM,UAAU,UAAU,CAAC,KAAgB;IACzC,MAAM,EAAE,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;IAC5B,IAAI,CAAC,EAAE,EAAE,CAAC;QACR,MAAM,IAAI,KAAK,CAAC,4BAA4B,KAAK,EAAE,CAAC,CAAC;IACvD,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,+FAA+F;AAC/F,MAAM,UAAU,WAAW,CAAC,EAAU;IACpC,KAAK,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;QACzD,IAAI,OAAO,KAAK,EAAE;YAAE,OAAO,KAAkB,CAAC;IAChD,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/registry/agent-registry.d.ts

@@ -0,0 +1,104 @@
+/**
+ * AgentRegistry — plugin registration API for Vauban agent descriptors.
+ *
+ * Phase 1: register/get/list with validation.
+ * Phase 2: discover() scans pnpm workspace packages for the
+ * "@vauban/agent-plugin" keyword, dynamically imports each one,
+ * and auto-registers its default export.
+ */
+import type { AgentCapabilityCard, AgentKind } from "./agent-capability.js";
+/** Handler context injected into every agent run. */
+export interface AgentContext {
+    runId: string;
+    traceId?: string;
+}
+/** Result returned by an agent handler. */
+export interface AgentResult {
+    output: string;
+    stopReason: "complete" | "budget_exhausted" | "error" | string;
+    inputTokens: number;
+    outputTokens: number;
+}
+/** Handler function type. */
+export type AgentHandler = (ctx: AgentContext, input: string) => Promise<AgentResult>;
+/**
+ * Descriptor for a registered agent. All fields are required except
+ * `schedule` and `featureFlag` which are only relevant for cron agents.
+ */
+export interface AgentDescriptor {
+    /** Stable slug (e.g. "market-radar"). Must be kebab-case, 1-63 chars. */
+    id: string;
+    /** Semver string (e.g. "0.2.0"). */
+    version: string;
+    /** Which loop primitive this agent uses. */
+    loop: "minimal" | "sdk";
+    /** Cron expression for scheduled agents (e.g. `0 * /6 * * *`). */
+    schedule?: string;
+    /** Env var name that gates this agent (e.g. "MARKETRADAR_CRON_ENABLED"). */
+    featureFlag?: string;
+    /** Monthly USD budget ceiling for this agent. */
+    budget_monthly_usd: number;
+    /** Human-readable description. */
+    description: string;
+    /** The async handler that runs the agent. */
+    handler: AgentHandler;
+}
+export declare class AgentRegistry {
+    private readonly agents;
+    private readonly capabilities;
+    /**
+     * Register an agent descriptor. Validates the descriptor and throws on
+     * duplicate id or invalid fields.
+     */
+    register(desc: AgentDescriptor): void;
+    /** Get a registered agent by id. Returns undefined if not found. */
+    get(id: string): AgentDescriptor | undefined;
+    /** List all registered agent descriptors. */
+    list(): AgentDescriptor[];
+    /** Number of registered agents. */
+    get size(): number;
+    /**
+     * Unregister an agent by id. Returns true if removed, false if not found.
+     */
+    unregister(id: string): boolean;
+    /**
+     * Register (or upsert) an AgentCapabilityCard keyed by agentId.
+     * Re-registering the same agentId replaces the previous card atomically.
+     */
+    registerCapability(card: AgentCapabilityCard): void;
+    /**
+     * Return all capability cards whose `kind` matches the given value.
+     * Returns shallow copies — mutations do not affect registry state.
+     */
+    discoverByKind(kind: AgentKind): AgentCapabilityCard[];
+    /**
+     * Return capability cards that match the given skill tags.
+     * Returns shallow copies — mutations do not affect registry state.
+     *
+     * @param skills - Tags to match against `card.skills` (lowercased by caller).
+     * @param opts.kind - Optional kind filter applied before skill matching.
+     * @param opts.matchAll - When true, ALL skills must be present (AND logic).
+     *   Defaults to false (OR logic: at least one skill matches).
+     */
+    discoverBySkills(skills: readonly string[], opts?: {
+        kind?: AgentKind;
+        matchAll?: boolean;
+    }): AgentCapabilityCard[];
+    /**
+     * Scan the pnpm workspace at `workspaceRoot` for packages whose
+     * `package.json` `keywords` array includes `"@vauban/agent-plugin"`,
+     * dynamically import each one, and register the default export
+     * (an `AgentDescriptor`).
+     *
+     * Idempotent: if a plugin is already registered, skips it silently.
+     * Malformed plugins (missing default export, non-descriptor shape)
+     * are skipped with a warning — discover() never throws.
+     *
+     * @param workspaceRoot  Absolute path to the workspace root containing pnpm-workspace.yaml.
+     * @returns The descriptors that were newly registered by this call.
+     */
+    discover(workspaceRoot: string): Promise<AgentDescriptor[]>;
+}
+/** Default singleton registry for process-level use. */
+export declare const agentRegistry: AgentRegistry;
+//# sourceMappingURL=agent-registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent-registry.d.ts","sourceRoot":"","sources":["../../src/registry/agent-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,OAAO,KAAK,EAAE,mBAAmB,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAI5E,qDAAqD;AACrD,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,2CAA2C;AAC3C,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,UAAU,GAAG,kBAAkB,GAAG,OAAO,GAAG,MAAM,CAAC;IAC/D,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,6BAA6B;AAC7B,MAAM,MAAM,YAAY,GAAG,CACzB,GAAG,EAAE,YAAY,EACjB,KAAK,EAAE,MAAM,KACV,OAAO,CAAC,WAAW,CAAC,CAAC;AAE1B;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,yEAAyE;IACzE,EAAE,EAAE,MAAM,CAAC;IACX,oCAAoC;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,4CAA4C;IAC5C,IAAI,EAAE,SAAS,GAAG,KAAK,CAAC;IACxB,kEAAkE;IAClE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4EAA4E;IAC5E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iDAAiD;IACjD,kBAAkB,EAAE,MAAM,CAAC;IAC3B,kCAAkC;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,6CAA6C;IAC7C,OAAO,EAAE,YAAY,CAAC;CACvB;AAmCD,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsC;IAC7D,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA0C;IAEvE;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,eAAe,GAAG,IAAI;IAUrC,oEAAoE;IACpE,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAI5C,6CAA6C;IAC7C,IAAI,IAAI,eAAe,EAAE;IAIzB,mCAAmC;IACnC,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;OAEG;IACH,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAM/B;;;OAGG;IACH,kBAAkB,CAAC,IAAI,EAAE,mBAAmB,GAAG,IAAI;IAInD;;;OAGG;IACH,cAAc,CAAC,IAAI,EAAE,SAAS,GAAG,mBAAmB,EAAE;IAQtD;;;;;;;;OAQG;IACH,gBAAgB,CACd,MAAM,EAAE,SAAS,MAAM,EAAE,EACzB,IAAI,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,SAAS,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,GAC9C,mBAAmB,EAAE;IAexB;;;;;;;;;;;;OAYG;IACG,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;CAoFlE;AAiGD,wDAAwD;AACxD,eAAO,MAAM,aAAa,eAAsB,CAAC"}