@musebook/discovery 0.0.0-stage → 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 The Musebook
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,11 @@
-# Temporary Holding Version
+# @musebook/discovery
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Musebook Agent Kit — directory/registry search, provider inspection, x402m discovery + contentProfiles.
+
+```sh
+npm install @musebook/discovery
+```
+
+Part of [Musebook Agent Kit](https://github.com/themusebook/agent-kit). Every write builds an **unsigned** transaction that you sign in your own wallet; this package never holds or reads private keys.
+
+MIT licensed.

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./registry.js";
+export * from "./provider.js";
+export * from "./messaging.js";
+export * from "./skills.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+export * from "./registry.js";
+export * from "./provider.js";
+export * from "./messaging.js";
+export * from "./skills.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC"}

package/dist/messaging.d.ts

@@ -0,0 +1,57 @@
+/**
+ * x402m discovery + content-profile negotiation.
+ *
+ * Delivery is not intelligibility: the mailbox spec answers "did the bytes
+ * arrive, from an authenticated agent?" — content profiles answer "will
+ * the recipient understand what the quote MEANS?" Services advertise
+ * `contentProfiles` in their discovery descriptor; envelopes name the
+ * profile they use (`<name>/v<major>`); a recipient that cannot interpret
+ * one replies with a typed `unsupported_profile` refusal instead of
+ * silently misreading an offer. (Reserved upstream in spec commit 022e006,
+ * x402-foundation PR #3944.)
+ */
+export interface MessagingDescriptor {
+    /** Mailbox execute endpoint base. */
+    endpoint: string;
+    /** Agent directory URL for this messaging service. */
+    directory?: string;
+    deliveryGuarantee?: string;
+    retention?: string;
+    federation?: boolean;
+    capabilities?: string[];
+    authProfiles?: string[];
+    /** Content profile identifiers this service's agents accept. Absent = none. */
+    contentProfiles: string[];
+    raw: unknown;
+}
+export declare function getMessagingDescriptor(baseUrl: string): Promise<MessagingDescriptor>;
+/** Parse `<name>/v<major>` — names may be short names or absolute URIs. */
+export declare function parseContentProfile(id: string): {
+    name: string;
+    major: number;
+} | null;
+export declare function isProfileSupported(descriptor: MessagingDescriptor, profile: string): boolean;
+export type ProfileNegotiation = {
+    supported: true;
+    profile: string;
+} | {
+    supported: false;
+    code: "unsupported_profile";
+    profile: string;
+    /** Profiles the counterparty DOES accept (the wire reply calls this `supported`). */
+    supportedProfiles: string[];
+    /** Same name, highest major the other side offers — a hint, never a silent downgrade. */
+    closest: string | null;
+};
+/**
+ * Decide whether `profile` can be used with a counterparty descriptor.
+ * Fail closed on major-version mismatch; never downgrade silently.
+ */
+export declare function negotiateContentProfile(descriptor: MessagingDescriptor, profile: string): ProfileNegotiation;
+/** Build the wire shape of an unsupported_profile error reply (kind: "error"). */
+export declare function unsupportedProfileReply(profile: string, supported: string[]): {
+    code: "unsupported_profile";
+    profile: string;
+    supported: string[];
+};
+//# sourceMappingURL=messaging.d.ts.map

package/dist/messaging.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messaging.d.ts","sourceRoot":"","sources":["../src/messaging.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,MAAM,WAAW,mBAAmB;IAClC,qCAAqC;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,sDAAsD;IACtD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,+EAA+E;IAC/E,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,GAAG,EAAE,OAAO,CAAC;CACd;AAED,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,mBAAmB,CAAC,CAmB9B;AAED,2EAA2E;AAC3E,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAItF;AAED,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,mBAAmB,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAE5F;AAED,MAAM,MAAM,kBAAkB,GAC1B;IAAE,SAAS,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACpC;IACE,SAAS,EAAE,KAAK,CAAC;IACjB,IAAI,EAAE,qBAAqB,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,qFAAqF;IACrF,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,yFAAyF;IACzF,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB,CAAC;AAEN;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,mBAAmB,EAC/B,OAAO,EAAE,MAAM,GACd,kBAAkB,CAoBpB;AAED,kFAAkF;AAClF,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG;IAC7E,IAAI,EAAE,qBAAqB,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB,CAEA"}

package/dist/messaging.js

@@ -0,0 +1,73 @@
+/**
+ * x402m discovery + content-profile negotiation.
+ *
+ * Delivery is not intelligibility: the mailbox spec answers "did the bytes
+ * arrive, from an authenticated agent?" — content profiles answer "will
+ * the recipient understand what the quote MEANS?" Services advertise
+ * `contentProfiles` in their discovery descriptor; envelopes name the
+ * profile they use (`<name>/v<major>`); a recipient that cannot interpret
+ * one replies with a typed `unsupported_profile` refusal instead of
+ * silently misreading an offer. (Reserved upstream in spec commit 022e006,
+ * x402-foundation PR #3944.)
+ */
+export async function getMessagingDescriptor(baseUrl) {
+    const base = baseUrl.replace(/\/$/, "");
+    const res = await fetch(`${base}/.well-known/x402m`);
+    if (!res.ok)
+        throw new Error(`x402m discovery failed: HTTP ${res.status}`);
+    const body = (await res.json());
+    const str = (v) => (typeof v === "string" ? v : undefined);
+    return {
+        endpoint: str(body.endpoint) ?? str(body.execute_endpoint) ?? base,
+        directory: str(body.directory),
+        deliveryGuarantee: str(body.deliveryGuarantee) ?? str(body.delivery_guarantee),
+        retention: str(body.retention),
+        federation: typeof body.federation === "boolean" ? body.federation : undefined,
+        capabilities: Array.isArray(body.capabilities) ? body.capabilities : undefined,
+        authProfiles: Array.isArray(body.authProfiles) ? body.authProfiles : undefined,
+        contentProfiles: Array.isArray(body.contentProfiles)
+            ? body.contentProfiles
+            : [],
+        raw: body,
+    };
+}
+/** Parse `<name>/v<major>` — names may be short names or absolute URIs. */
+export function parseContentProfile(id) {
+    const m = /^(.+)\/v(\d+)$/.exec(id);
+    if (!m)
+        return null;
+    return { name: m[1], major: Number(m[2]) };
+}
+export function isProfileSupported(descriptor, profile) {
+    return descriptor.contentProfiles.includes(profile);
+}
+/**
+ * Decide whether `profile` can be used with a counterparty descriptor.
+ * Fail closed on major-version mismatch; never downgrade silently.
+ */
+export function negotiateContentProfile(descriptor, profile) {
+    if (isProfileSupported(descriptor, profile)) {
+        return { supported: true, profile };
+    }
+    const wanted = parseContentProfile(profile);
+    let closest = null;
+    if (wanted) {
+        const sameName = descriptor.contentProfiles
+            .map((id) => ({ id, parsed: parseContentProfile(id) }))
+            .filter((x) => x.parsed && x.parsed.name === wanted.name)
+            .sort((a, b) => (b.parsed?.major ?? 0) - (a.parsed?.major ?? 0));
+        closest = sameName[0]?.id ?? null;
+    }
+    return {
+        supported: false,
+        code: "unsupported_profile",
+        profile,
+        supportedProfiles: descriptor.contentProfiles,
+        closest,
+    };
+}
+/** Build the wire shape of an unsupported_profile error reply (kind: "error"). */
+export function unsupportedProfileReply(profile, supported) {
+    return { code: "unsupported_profile", profile, supported };
+}
+//# sourceMappingURL=messaging.js.map

package/dist/messaging.js.map

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

package/dist/provider.d.ts

@@ -0,0 +1,16 @@
+import type { AgentConfiguration } from "@musebook/auth";
+/**
+ * Agent Auth provider inspection — the same read registry.musebook.trade's
+ * /discover page performs: fetch a provider's agent-configuration and
+ * summarize what an agent is walking into.
+ */
+export interface ProviderSummary {
+    providerName: string | null;
+    issuer: string;
+    modes: string[];
+    approval: string[];
+    endpointCount: number;
+    raw: AgentConfiguration;
+}
+export declare function inspectProvider(providerBaseUrl: string): Promise<ProviderSummary>;
+//# sourceMappingURL=provider.d.ts.map

package/dist/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEzD;;;;GAIG;AAEH,MAAM,WAAW,eAAe;IAC9B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,GAAG,EAAE,kBAAkB,CAAC;CACzB;AAED,wBAAsB,eAAe,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAavF"}

package/dist/provider.js

@@ -0,0 +1,16 @@
+export async function inspectProvider(providerBaseUrl) {
+    const base = providerBaseUrl.replace(/\/$/, "");
+    const res = await fetch(`${base}/.well-known/agent-configuration`);
+    if (!res.ok)
+        throw new Error(`Provider discovery failed: HTTP ${res.status}`);
+    const config = (await res.json());
+    return {
+        providerName: config.provider_name ?? null,
+        issuer: config.issuer,
+        modes: config.modes ?? [],
+        approval: config.approval ?? [],
+        endpointCount: config.endpoints ? Object.keys(config.endpoints).length : 0,
+        raw: config,
+    };
+}
+//# sourceMappingURL=provider.js.map

package/dist/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":"AAiBA,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,eAAuB;IAC3D,MAAM,IAAI,GAAG,eAAe,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAChD,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,kCAAkC,CAAC,CAAC;IACnE,IAAI,CAAC,GAAG,CAAC,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,mCAAmC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;IAC9E,MAAM,MAAM,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAuB,CAAC;IACxD,OAAO;QACL,YAAY,EAAE,MAAM,CAAC,aAAa,IAAI,IAAI;QAC1C,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,EAAE;QACzB,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,EAAE;QAC/B,aAAa,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAC1E,GAAG,EAAE,MAAM;KACZ,CAAC;AACJ,CAAC"}

package/dist/registry.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Directory / registry search.
+ *
+ * The population layer today is the Musebook DIRECTORY on the hub
+ * (musebook.trade); registry.musebook.trade renders it but has NO JSON API
+ * of its own (GAPS #1) — so the kit queries hub APIs and treats the
+ * registry host as the human surface. When the registry API lands, only
+ * the base URL changes.
+ *
+ * Two machine-readable shapes exist in the wild, and BOTH are supported:
+ *
+ *  1. The hub directory API: GET {hub}/api/v2/agents?search=&limit=&offset=
+ *     answering an array or { agents: [...] }.
+ *  2. The published directory snapshot: GET {hub}/live/agents.json —
+ *     { generated_at, total_agents, by_network, agents: [...] } where each
+ *     record is the DAS-shaped directory entry:
+ *       { assetId, name, network, metadataUri, assetSigner, interface,
+ *         update_authority, json_uri?, description?, image?,
+ *         external_url?, agentToken? }
+ *     The agents repo (themusebook/agents, `musebook/agents.json`) carries
+ *     the same records in a camelCase envelope
+ *     { $schema, apiVersion, generatedAt, source, stats, agents } with
+ *     `identifier` + `updateAuthority` instead of `update_authority`.
+ *     normalizeAgent() accepts all of these spellings.
+ *
+ * searchDirectory tries the API first and falls back to the snapshot, so
+ * directory reads keep working even when the API route is unavailable.
+ */
+export interface DiscoveryConfig {
+    hub: string;
+    registry: string;
+}
+export interface DirectoryAgent {
+    /** Directory/API id when one exists; the asset id for snapshot records. */
+    id: string;
+    /** MPL Core asset address (snapshot spelling: assetId). */
+    assetId: string | null;
+    name: string | null;
+    description: string | null;
+    /** Owner wallet — snapshot spelling is update_authority (the update authority wallet). */
+    wallet: string | null;
+    ownerWallet: string | null;
+    updateAuthority: string | null;
+    /** Keyless Asset Signer PDA, when the record carries it. */
+    assetSigner: string | null;
+    network: string | null;
+    image: string | null;
+    metadataUri: string | null;
+    externalUrl: string | null;
+    /** Canonical bound token mint (agent_token binding), when present. */
+    agentToken: string | null;
+    assetAddress: string | null;
+    raw: unknown;
+}
+export declare function normalizeAgent(raw: Record<string, unknown>): DirectoryAgent;
+/** The snapshot envelope, as published at {hub}/live/agents.json. */
+export interface DirectorySnapshot {
+    generatedAt: string | null;
+    totalAgents: number | null;
+    byNetwork: Record<string, number> | null;
+    agents: DirectoryAgent[];
+}
+export declare function normalizeSnapshot(body: unknown): DirectorySnapshot;
+/** Fetch + normalize the published directory snapshot. */
+export declare function fetchDirectorySnapshot(config: DiscoveryConfig): Promise<DirectorySnapshot>;
+/** Search the snapshot client-side (fallback path / offline reads). */
+export declare function searchDirectorySnapshot(config: DiscoveryConfig, query: string, options?: {
+    limit?: number;
+    offset?: number;
+}): Promise<DirectoryAgent[]>;
+export declare function searchDirectory(config: DiscoveryConfig, query: string, options?: {
+    limit?: number;
+    offset?: number;
+}): Promise<DirectoryAgent[]>;
+export declare function getDirectoryAgent(config: DiscoveryConfig, idOrWallet: string): Promise<DirectoryAgent | null>;
+//# sourceMappingURL=registry.d.ts.map

package/dist/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,2EAA2E;IAC3E,EAAE,EAAE,MAAM,CAAC;IACX,2DAA2D;IAC3D,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,0FAA0F;IAC1F,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,4DAA4D;IAC5D,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,sEAAsE;IACtE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,GAAG,EAAE,OAAO,CAAC;CACd;AAID,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,cAAc,CAyB3E;AAED,qEAAqE;AACrE,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;IACzC,MAAM,EAAE,cAAc,EAAE,CAAC;CAC1B;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,OAAO,GAAG,iBAAiB,CAmBlE;AAED,0DAA0D;AAC1D,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,eAAe,GACtB,OAAO,CAAC,iBAAiB,CAAC,CAI5B;AAUD,uEAAuE;AACvE,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,eAAe,EACvB,KAAK,EAAE,MAAM,EACb,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAO,GAChD,OAAO,CAAC,cAAc,EAAE,CAAC,CAO3B;AAED,wBAAsB,eAAe,CACnC,MAAM,EAAE,eAAe,EACvB,KAAK,EAAE,MAAM,EACb,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAO,GAChD,OAAO,CAAC,cAAc,EAAE,CAAC,CAmB3B;AAED,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,eAAe,EACvB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAUhC"}

package/dist/registry.js

@@ -0,0 +1,124 @@
+/**
+ * Directory / registry search.
+ *
+ * The population layer today is the Musebook DIRECTORY on the hub
+ * (musebook.trade); registry.musebook.trade renders it but has NO JSON API
+ * of its own (GAPS #1) — so the kit queries hub APIs and treats the
+ * registry host as the human surface. When the registry API lands, only
+ * the base URL changes.
+ *
+ * Two machine-readable shapes exist in the wild, and BOTH are supported:
+ *
+ *  1. The hub directory API: GET {hub}/api/v2/agents?search=&limit=&offset=
+ *     answering an array or { agents: [...] }.
+ *  2. The published directory snapshot: GET {hub}/live/agents.json —
+ *     { generated_at, total_agents, by_network, agents: [...] } where each
+ *     record is the DAS-shaped directory entry:
+ *       { assetId, name, network, metadataUri, assetSigner, interface,
+ *         update_authority, json_uri?, description?, image?,
+ *         external_url?, agentToken? }
+ *     The agents repo (themusebook/agents, `musebook/agents.json`) carries
+ *     the same records in a camelCase envelope
+ *     { $schema, apiVersion, generatedAt, source, stats, agents } with
+ *     `identifier` + `updateAuthority` instead of `update_authority`.
+ *     normalizeAgent() accepts all of these spellings.
+ *
+ * searchDirectory tries the API first and falls back to the snapshot, so
+ * directory reads keep working even when the API route is unavailable.
+ */
+const str = (v) => (typeof v === "string" && v.length > 0 ? v : null);
+export function normalizeAgent(raw) {
+    const assetId = str(raw.assetId) ?? str(raw.assetAddress) ?? str(raw.asset) ?? str(raw.mint);
+    const owner = str(raw.update_authority) ??
+        str(raw.updateAuthority) ??
+        str(raw.ownerWallet) ??
+        str(raw.wallet);
+    return {
+        id: str(raw.id) ?? str(raw.agentId) ?? str(raw.identifier) ?? assetId ?? "",
+        assetId,
+        name: str(raw.name),
+        description: str(raw.description),
+        wallet: owner,
+        ownerWallet: owner,
+        updateAuthority: owner,
+        assetSigner: str(raw.assetSigner) ?? str(raw.asset_signer),
+        network: str(raw.network),
+        image: str(raw.image),
+        metadataUri: str(raw.metadataUri) ?? str(raw.metadata_uri) ?? str(raw.json_uri),
+        externalUrl: str(raw.external_url) ?? str(raw.externalUrl),
+        agentToken: str(raw.agentToken) ?? str(raw.agent_token),
+        assetAddress: assetId,
+        raw,
+    };
+}
+export function normalizeSnapshot(body) {
+    const env = (body ?? {});
+    const list = Array.isArray(body)
+        ? body
+        : (env.agents ?? []);
+    return {
+        generatedAt: str(env.generated_at) ?? str(env.generatedAt),
+        totalAgents: typeof env.total_agents === "number"
+            ? env.total_agents
+            : typeof env.totalAgents === "number"
+                ? env.totalAgents
+                : list.length,
+        byNetwork: env.by_network && typeof env.by_network === "object"
+            ? env.by_network
+            : null,
+        agents: list.map(normalizeAgent),
+    };
+}
+/** Fetch + normalize the published directory snapshot. */
+export async function fetchDirectorySnapshot(config) {
+    const res = await fetch(`${config.hub.replace(/\/$/, "")}/live/agents.json`);
+    if (!res.ok)
+        throw new Error(`Directory snapshot failed: HTTP ${res.status}`);
+    return normalizeSnapshot(await res.json());
+}
+function matchesQuery(agent, query) {
+    const q = query.trim().toLowerCase();
+    if (!q)
+        return true;
+    return [agent.id, agent.name, agent.description, agent.wallet, agent.assetId]
+        .filter((v) => typeof v === "string")
+        .some((v) => v.toLowerCase().includes(q));
+}
+/** Search the snapshot client-side (fallback path / offline reads). */
+export async function searchDirectorySnapshot(config, query, options = {}) {
+    const snapshot = await fetchDirectorySnapshot(config);
+    const offset = options.offset ?? 0;
+    const limit = options.limit ?? 25;
+    return snapshot.agents
+        .filter((a) => matchesQuery(a, query))
+        .slice(offset, offset + limit);
+}
+export async function searchDirectory(config, query, options = {}) {
+    const params = new URLSearchParams({
+        search: query,
+        limit: String(options.limit ?? 25),
+        offset: String(options.offset ?? 0),
+    });
+    try {
+        const res = await fetch(`${config.hub.replace(/\/$/, "")}/api/v2/agents?${params}`);
+        if (!res.ok)
+            throw new Error(`Directory search failed: HTTP ${res.status}`);
+        const body = (await res.json());
+        const list = Array.isArray(body)
+            ? body
+            : (body.agents ?? []);
+        return list.map(normalizeAgent);
+    }
+    catch {
+        // The snapshot is the same population in published form — fall back to
+        // it rather than failing the read.
+        return searchDirectorySnapshot(config, query, options);
+    }
+}
+export async function getDirectoryAgent(config, idOrWallet) {
+    const results = await searchDirectory(config, idOrWallet, { limit: 10 });
+    return (results.find((a) => a.id === idOrWallet || a.wallet === idOrWallet || a.assetId === idOrWallet) ??
+        results[0] ??
+        null);
+}
+//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

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

package/dist/skills.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Skills catalog discovery.
+ *
+ * Canonical home: the skills repo — github.com/themusebook/skills
+ * (transferred from Solizardking/skills; the old path redirects). The repo
+ * publishes a flat catalog at catalog.json:
+ *   [ { slug, name, description, category }, ... ]   (599 entries)
+ * and one folder per skill under skills/<slug>/SKILL.md whose YAML
+ * frontmatter follows the standard skill shape:
+ *   ---
+ *   name: ask-mcp
+ *   description: "..."
+ *   metadata:            # optional
+ *     source: https://github.com/<upstream>
+ *     documentation: https://…
+ *     openclaw:
+ *       requires: { env: [], bins: [] }
+ *   allowed-tools:       # optional
+ *     - Read
+ *   ---
+ *
+ * The live site surface is musebook.trade/skills, and the hub serves the
+ * live catalog at GET {hub}/api/skills — a flat list of
+ *   { slug, name, description, category, path, version }
+ * (272 entries, verified 2026-10-29; `path` is the SKILL.md path inside
+ * the install tarball, e.g. "1password/SKILL.md"). fetchSkillsCatalog
+ * prefers that live endpoint and falls back to the repo's catalog.json.
+ * The install tarball itself is at {hub}/clawd-skills.tar.gz
+ * (layout: skills/<slug>/SKILL.md + references). Note /live/skills.json
+ * and /skills.json are NOT endpoints (404) — /api/skills is the live one.
+ */
+export interface SkillsConfig {
+    hub: string;
+    /** Live catalog endpoint override. Default: {hub}/api/skills. */
+    apiUrl?: string;
+    /** Fallback catalog.json URL. Default: the canonical skills repo on GitHub. */
+    catalogUrl?: string;
+}
+export declare const DEFAULT_SKILLS_CATALOG_URL = "https://raw.githubusercontent.com/themusebook/skills/main/catalog.json";
+export declare const SKILLS_REPO_URL = "https://github.com/themusebook/skills";
+export interface SkillCatalogEntry {
+    slug: string;
+    name: string;
+    description: string | null;
+    category: string | null;
+    /** SKILL.md path inside the install tarball (live API entries only). */
+    path: string | null;
+    /** Catalog version string, when the source provides one. */
+    version: string | null;
+    raw: unknown;
+}
+export declare function normalizeSkillEntry(raw: Record<string, unknown>): SkillCatalogEntry;
+/**
+ * Fetch the full skills catalog. Prefers the LIVE hub endpoint
+ * ({hub}/api/skills — the catalog musebook.trade/skills renders); falls
+ * back to the skills repo's catalog.json when the API is unavailable.
+ */
+export declare function fetchSkillsCatalog(config: SkillsConfig): Promise<SkillCatalogEntry[]>;
+/** Search the catalog by slug/name/description/category (client-side). */
+export declare function searchSkills(config: SkillsConfig, query: string, options?: {
+    limit?: number;
+}): Promise<SkillCatalogEntry[]>;
+/** URL of the install tarball the hub serves for the skills catalog. */
+export declare function skillsTarballUrl(config: SkillsConfig): string;
+/** Parsed SKILL.md frontmatter, aligned with the skills repo's format. */
+export interface SkillFrontmatter {
+    name: string;
+    description: string | null;
+    /** metadata.source — upstream repo the skill was vendored from, if any. */
+    source: string | null;
+    /** metadata.documentation URL, if present. */
+    documentation: string | null;
+    /** metadata.openclaw.requires — { env: string[], bins: string[] }. */
+    requires: {
+        env: string[];
+        bins: string[];
+    } | null;
+    /** allowed-tools list, when the skill restricts its tool surface. */
+    allowedTools: string[] | null;
+    /** Every frontmatter key, unparsed values as raw strings. */
+    raw: Record<string, string>;
+}
+/**
+ * Parse the YAML frontmatter of a SKILL.md file. Deliberately minimal —
+ * it covers the shapes the skills repo actually uses (top-level scalars,
+ * the nested metadata.source / metadata.documentation scalars, the
+ * metadata.openclaw.requires env/bins lists, and the allowed-tools list)
+ * without taking a YAML dependency. Unknown keys are preserved in `raw`.
+ */
+export declare function parseSkillFrontmatter(markdown: string): SkillFrontmatter | null;
+//# sourceMappingURL=skills.d.ts.map

package/dist/skills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../src/skills.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,iEAAiE;IACjE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,+EAA+E;IAC/E,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,eAAO,MAAM,0BAA0B,2EACmC,CAAC;AAE3E,eAAO,MAAM,eAAe,0CAA0C,CAAC;AAEvE,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,wEAAwE;IACxE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,4DAA4D;IAC5D,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,GAAG,EAAE,OAAO,CAAC;CACd;AAED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,iBAAiB,CAWnF;AASD;;;;GAIG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,YAAY,GACnB,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAY9B;AAED,0EAA0E;AAC1E,wBAAsB,YAAY,CAChC,MAAM,EAAE,YAAY,EACpB,KAAK,EAAE,MAAM,EACb,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,GAC/B,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAW9B;AAED,wEAAwE;AACxE,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAE7D;AAED,0EAA0E;AAC1E,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,2EAA2E;IAC3E,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,8CAA8C;IAC9C,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,sEAAsE;IACtE,QAAQ,EAAE;QAAE,GAAG,EAAE,MAAM,EAAE,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,IAAI,CAAC;IACnD,qEAAqE;IACrE,YAAY,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAC9B,6DAA6D;IAC7D,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC7B;AAaD;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CAwE/E"}

package/dist/skills.js

@@ -0,0 +1,186 @@
+/**
+ * Skills catalog discovery.
+ *
+ * Canonical home: the skills repo — github.com/themusebook/skills
+ * (transferred from Solizardking/skills; the old path redirects). The repo
+ * publishes a flat catalog at catalog.json:
+ *   [ { slug, name, description, category }, ... ]   (599 entries)
+ * and one folder per skill under skills/<slug>/SKILL.md whose YAML
+ * frontmatter follows the standard skill shape:
+ *   ---
+ *   name: ask-mcp
+ *   description: "..."
+ *   metadata:            # optional
+ *     source: https://github.com/<upstream>
+ *     documentation: https://…
+ *     openclaw:
+ *       requires: { env: [], bins: [] }
+ *   allowed-tools:       # optional
+ *     - Read
+ *   ---
+ *
+ * The live site surface is musebook.trade/skills, and the hub serves the
+ * live catalog at GET {hub}/api/skills — a flat list of
+ *   { slug, name, description, category, path, version }
+ * (272 entries, verified 2026-10-29; `path` is the SKILL.md path inside
+ * the install tarball, e.g. "1password/SKILL.md"). fetchSkillsCatalog
+ * prefers that live endpoint and falls back to the repo's catalog.json.
+ * The install tarball itself is at {hub}/clawd-skills.tar.gz
+ * (layout: skills/<slug>/SKILL.md + references). Note /live/skills.json
+ * and /skills.json are NOT endpoints (404) — /api/skills is the live one.
+ */
+export const DEFAULT_SKILLS_CATALOG_URL = "https://raw.githubusercontent.com/themusebook/skills/main/catalog.json";
+export const SKILLS_REPO_URL = "https://github.com/themusebook/skills";
+export function normalizeSkillEntry(raw) {
+    const s = (v) => (typeof v === "string" && v.length > 0 ? v : null);
+    return {
+        slug: s(raw.slug) ?? s(raw.name) ?? "",
+        name: s(raw.name) ?? s(raw.slug) ?? "",
+        description: s(raw.description),
+        category: s(raw.category),
+        path: s(raw.path),
+        version: s(raw.version),
+        raw,
+    };
+}
+function toEntries(body) {
+    const list = Array.isArray(body)
+        ? body
+        : (body.skills ?? []);
+    return list.map(normalizeSkillEntry);
+}
+/**
+ * Fetch the full skills catalog. Prefers the LIVE hub endpoint
+ * ({hub}/api/skills — the catalog musebook.trade/skills renders); falls
+ * back to the skills repo's catalog.json when the API is unavailable.
+ */
+export async function fetchSkillsCatalog(config) {
+    const apiUrl = config.apiUrl ?? `${config.hub.replace(/\/$/, "")}/api/skills`;
+    try {
+        const res = await fetch(apiUrl);
+        if (!res.ok)
+            throw new Error(`Skills API failed: HTTP ${res.status}`);
+        return toEntries(await res.json());
+    }
+    catch {
+        const url = config.catalogUrl ?? DEFAULT_SKILLS_CATALOG_URL;
+        const res = await fetch(url);
+        if (!res.ok)
+            throw new Error(`Skills catalog failed: HTTP ${res.status}`);
+        return toEntries(await res.json());
+    }
+}
+/** Search the catalog by slug/name/description/category (client-side). */
+export async function searchSkills(config, query, options = {}) {
+    const catalog = await fetchSkillsCatalog(config);
+    const q = query.trim().toLowerCase();
+    const hits = q
+        ? catalog.filter((e) => [e.slug, e.name, e.description, e.category]
+            .filter((v) => typeof v === "string")
+            .some((v) => v.toLowerCase().includes(q)))
+        : catalog;
+    return hits.slice(0, options.limit ?? 25);
+}
+/** URL of the install tarball the hub serves for the skills catalog. */
+export function skillsTarballUrl(config) {
+    return `${config.hub.replace(/\/$/, "")}/clawd-skills.tar.gz`;
+}
+function unquote(value) {
+    const v = value.trim();
+    if ((v.startsWith('"') && v.endsWith('"')) ||
+        (v.startsWith("'") && v.endsWith("'"))) {
+        return v.slice(1, -1);
+    }
+    return v;
+}
+/**
+ * Parse the YAML frontmatter of a SKILL.md file. Deliberately minimal —
+ * it covers the shapes the skills repo actually uses (top-level scalars,
+ * the nested metadata.source / metadata.documentation scalars, the
+ * metadata.openclaw.requires env/bins lists, and the allowed-tools list)
+ * without taking a YAML dependency. Unknown keys are preserved in `raw`.
+ */
+export function parseSkillFrontmatter(markdown) {
+    const match = /^---\r?\n([\s\S]*?)\r?\n---/.exec(markdown);
+    if (!match)
+        return null;
+    const lines = match[1].split(/\r?\n/);
+    const raw = {};
+    let name = "";
+    let description = null;
+    let source = null;
+    let documentation = null;
+    let requires = null;
+    let allowedTools = null;
+    let section = ""; // "", "metadata", "openclaw", "requires", "allowed-tools"
+    let listKey = null;
+    for (const line of lines) {
+        const top = /^([A-Za-z0-9_-]+):\s*(.*)$/.exec(line);
+        const item = /^\s+-\s+(.*)$/.exec(line);
+        if (top && !/^\s/.test(line)) {
+            const [, key, value] = top;
+            listKey = null;
+            if (key === "name") {
+                name = unquote(value);
+                section = "";
+            }
+            else if (key === "description") {
+                description = unquote(value);
+                section = "";
+            }
+            else if (key === "metadata") {
+                section = "metadata";
+            }
+            else if (key === "allowed-tools") {
+                allowedTools = [];
+                section = "allowed-tools";
+            }
+            else {
+                section = "";
+            }
+            if (value)
+                raw[key] = value;
+            continue;
+        }
+        if (item) {
+            const value = unquote(item[1]);
+            if (section === "allowed-tools" && allowedTools) {
+                allowedTools.push(value);
+            }
+            else if (section === "requires" && requires && listKey) {
+                requires[listKey].push(value);
+            }
+            continue;
+        }
+        const nested = /^\s+([A-Za-z0-9_-]+):\s*(.*)$/.exec(line);
+        if (nested) {
+            const [, key, value] = nested;
+            if (section === "metadata" && key === "source")
+                source = unquote(value);
+            else if (section === "metadata" && key === "documentation") {
+                documentation = unquote(value);
+            }
+            else if (section === "metadata" && key === "openclaw")
+                section = "openclaw";
+            else if (section === "openclaw" && key === "requires") {
+                requires = { env: [], bins: [] };
+                section = "requires";
+            }
+            else if (section === "requires" && (key === "env" || key === "bins")) {
+                listKey = key;
+                const inline = value.trim();
+                if (inline.startsWith("[") && inline.endsWith("]")) {
+                    const inner = inline.slice(1, -1).trim();
+                    if (inner && requires) {
+                        requires[listKey] = inner.split(",").map((v) => unquote(v.trim()));
+                    }
+                    listKey = null;
+                }
+            }
+        }
+    }
+    if (!name)
+        return null;
+    return { name, description, source, documentation, requires, allowedTools, raw };
+}
+//# sourceMappingURL=skills.js.map

package/dist/skills.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.js","sourceRoot":"","sources":["../src/skills.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAUH,MAAM,CAAC,MAAM,0BAA0B,GACrC,wEAAwE,CAAC;AAE3E,MAAM,CAAC,MAAM,eAAe,GAAG,uCAAuC,CAAC;AAcvE,MAAM,UAAU,mBAAmB,CAAC,GAA4B;IAC9D,MAAM,CAAC,GAAG,CAAC,CAAU,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAC7E,OAAO;QACL,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE;QACtC,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE;QACtC,WAAW,EAAE,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC;QAC/B,QAAQ,EAAE,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC;QACzB,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC;QACjB,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC;QACvB,GAAG;KACJ,CAAC;AACJ,CAAC;AAED,SAAS,SAAS,CAAC,IAAa;IAC9B,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;QAC9B,CAAC,CAAC,IAAI;QACN,CAAC,CAAC,CAAE,IAA+B,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;IACpD,OAAQ,IAAkC,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;AACtE,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,MAAoB;IAEpB,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,aAAa,CAAC;IAC9E,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,CAAC;QAChC,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,2BAA2B,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;QACtE,OAAO,SAAS,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;IACrC,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,GAAG,GAAG,MAAM,CAAC,UAAU,IAAI,0BAA0B,CAAC;QAC5D,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC;QAC7B,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,+BAA+B,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;QAC1E,OAAO,SAAS,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;IACrC,CAAC;AACH,CAAC;AAED,0EAA0E;AAC1E,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,MAAoB,EACpB,KAAa,EACb,UAA8B,EAAE;IAEhC,MAAM,OAAO,GAAG,MAAM,kBAAkB,CAAC,MAAM,CAAC,CAAC;IACjD,MAAM,CAAC,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACrC,MAAM,IAAI,GAAG,CAAC;QACZ,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CACnB,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,QAAQ,CAAC;aACxC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC;aACjD,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAC5C;QACH,CAAC,CAAC,OAAO,CAAC;IACZ,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;AAC5C,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,gBAAgB,CAAC,MAAoB;IACnD,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,sBAAsB,CAAC;AAChE,CAAC;AAkBD,SAAS,OAAO,CAAC,KAAa;IAC5B,MAAM,CAAC,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IACvB,IACE,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QACtC,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,EACtC,CAAC;QACD,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACxB,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CAAC,QAAgB;IACpD,MAAM,KAAK,GAAG,6BAA6B,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC3D,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACtC,MAAM,GAAG,GAA2B,EAAE,CAAC;IACvC,IAAI,IAAI,GAAG,EAAE,CAAC;IACd,IAAI,WAAW,GAAkB,IAAI,CAAC;IACtC,IAAI,MAAM,GAAkB,IAAI,CAAC;IACjC,IAAI,aAAa,GAAkB,IAAI,CAAC;IACxC,IAAI,QAAQ,GAA6C,IAAI,CAAC;IAC9D,IAAI,YAAY,GAAoB,IAAI,CAAC;IAEzC,IAAI,OAAO,GAAG,EAAE,CAAC,CAAC,0DAA0D;IAC5E,IAAI,OAAO,GAA0B,IAAI,CAAC;IAE1C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,GAAG,GAAG,4BAA4B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpD,MAAM,IAAI,GAAG,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACxC,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC7B,MAAM,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,GAAG,CAAC;YAC3B,OAAO,GAAG,IAAI,CAAC;YACf,IAAI,GAAG,KAAK,MAAM,EAAE,CAAC;gBACnB,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;gBACtB,OAAO,GAAG,EAAE,CAAC;YACf,CAAC;iBAAM,IAAI,GAAG,KAAK,aAAa,EAAE,CAAC;gBACjC,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;gBAC7B,OAAO,GAAG,EAAE,CAAC;YACf,CAAC;iBAAM,IAAI,GAAG,KAAK,UAAU,EAAE,CAAC;gBAC9B,OAAO,GAAG,UAAU,CAAC;YACvB,CAAC;iBAAM,IAAI,GAAG,KAAK,eAAe,EAAE,CAAC;gBACnC,YAAY,GAAG,EAAE,CAAC;gBAClB,OAAO,GAAG,eAAe,CAAC;YAC5B,CAAC;iBAAM,CAAC;gBACN,OAAO,GAAG,EAAE,CAAC;YACf,CAAC;YACD,IAAI,KAAK;gBAAE,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;YAC5B,SAAS;QACX,CAAC;QACD,IAAI,IAAI,EAAE,CAAC;YACT,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;YAC/B,IAAI,OAAO,KAAK,eAAe,IAAI,YAAY,EAAE,CAAC;gBAChD,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC3B,CAAC;iBAAM,IAAI,OAAO,KAAK,UAAU,IAAI,QAAQ,IAAI,OAAO,EAAE,CAAC;gBACzD,QAAQ,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAChC,CAAC;YACD,SAAS;QACX,CAAC;QACD,MAAM,MAAM,GAAG,+BAA+B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1D,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,MAAM,CAAC;YAC9B,IAAI,OAAO,KAAK,UAAU,IAAI,GAAG,KAAK,QAAQ;gBAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;iBACnE,IAAI,OAAO,KAAK,UAAU,IAAI,GAAG,KAAK,eAAe,EAAE,CAAC;gBAC3D,aAAa,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;YACjC,CAAC;iBAAM,IAAI,OAAO,KAAK,UAAU,IAAI,GAAG,KAAK,UAAU;gBAAE,OAAO,GAAG,UAAU,CAAC;iBACzE,IAAI,OAAO,KAAK,UAAU,IAAI,GAAG,KAAK,UAAU,EAAE,CAAC;gBACtD,QAAQ,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;gBACjC,OAAO,GAAG,UAAU,CAAC;YACvB,CAAC;iBAAM,IAAI,OAAO,KAAK,UAAU,IAAI,CAAC,GAAG,KAAK,KAAK,IAAI,GAAG,KAAK,MAAM,CAAC,EAAE,CAAC;gBACvE,OAAO,GAAG,GAAG,CAAC;gBACd,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;gBAC5B,IAAI,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;oBACnD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;oBACzC,IAAI,KAAK,IAAI,QAAQ,EAAE,CAAC;wBACtB,QAAQ,CAAC,OAAO,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;oBACrE,CAAC;oBACD,OAAO,GAAG,IAAI,CAAC;gBACjB,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IACD,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IACvB,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,QAAQ,EAAE,YAAY,EAAE,GAAG,EAAE,CAAC;AACnF,CAAC"}

package/package.json

@@ -1,6 +1,41 @@
 {
   "name": "@musebook/discovery",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.1",
+  "description": "Musebook Agent Kit — directory/registry search, provider inspection, x402m discovery + contentProfiles.",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "dependencies": {
+    "@musebook/auth": "0.1.1"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/themusebook/agent-kit.git",
+    "directory": "packages/discovery"
+  },
+  "homepage": "https://github.com/themusebook/agent-kit/tree/main/packages/discovery#readme",
+  "bugs": {
+    "url": "https://github.com/themusebook/agent-kit/issues"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json && node ../../scripts/release/fix-esm.mjs"
+  }
 }