@aumos/agent-marketplace 0.1.0

package/dist/client.d.ts

@@ -0,0 +1,99 @@
+/**
+ * HTTP client for the agent-marketplace capability registry API.
+ *
+ * Uses the Fetch API (available natively in Node 18+, browsers, and Deno).
+ * No external dependencies required.
+ *
+ * @example
+ * ```ts
+ * import { createAgentMarketplaceClient } from "@aumos/agent-marketplace";
+ *
+ * const client = createAgentMarketplaceClient({ baseUrl: "http://localhost:8092" });
+ *
+ * const result = await client.discoverAgents({
+ *   required_capabilities: ["analysis"],
+ *   min_trust: 0.8,
+ * });
+ *
+ * if (result.ok) {
+ *   console.log("Found listings:", result.data.length);
+ * }
+ * ```
+ */
+import type { AgentListing, ApiResult, CapabilitySchema, CapabilityValidation, DiscoveryQuery, MatchResult } from "./types.js";
+/** Configuration options for the AgentMarketplaceClient. */
+export interface AgentMarketplaceClientConfig {
+    /** Base URL of the agent-marketplace server (e.g. "http://localhost:8092"). */
+    readonly baseUrl: string;
+    /** Optional request timeout in milliseconds (default: 30000). */
+    readonly timeoutMs?: number;
+    /** Optional extra HTTP headers sent with every request. */
+    readonly headers?: Readonly<Record<string, string>>;
+}
+/** Typed HTTP client for the agent-marketplace server. */
+export interface AgentMarketplaceClient {
+    /**
+     * Register a new capability schema in the marketplace.
+     *
+     * @param capability - The full capability schema to register.
+     * @returns The registered CapabilitySchema with auto-generated capability_id.
+     */
+    registerCapability(capability: Omit<CapabilitySchema, "capability_id">): Promise<ApiResult<CapabilitySchema>>;
+    /**
+     * Discover agents in the marketplace matching the given query parameters.
+     *
+     * @param query - Optional filter and ranking parameters.
+     * @returns Array of AgentListing records ranked by relevance.
+     */
+    discoverAgents(query?: DiscoveryQuery): Promise<ApiResult<readonly AgentListing[]>>;
+    /**
+     * Match a structured capability request against all registered capabilities.
+     *
+     * Returns results ranked by composite match score (capability overlap,
+     * latency fitness, trust level, cost fitness).
+     *
+     * @param query - The discovery query specifying required capabilities and constraints.
+     * @returns Array of MatchResult records sorted best-first by match_score.
+     */
+    matchCapabilities(query: DiscoveryQuery): Promise<ApiResult<readonly MatchResult[]>>;
+    /**
+     * Validate a capability schema against marketplace business rules.
+     *
+     * @param capability - The capability schema to validate.
+     * @returns A CapabilityValidation with any error messages.
+     */
+    validateCapability(capability: Omit<CapabilitySchema, "capability_id">): Promise<ApiResult<CapabilityValidation>>;
+    /**
+     * Retrieve all marketplace listings, optionally filtered by namespace.
+     *
+     * @param options - Optional filter and pagination parameters.
+     * @returns Array of AgentListing records.
+     */
+    getListings(options?: {
+        readonly namespace?: string;
+        readonly category?: string;
+        readonly limit?: number;
+    }): Promise<ApiResult<readonly AgentListing[]>>;
+    /**
+     * Retrieve a single capability by its unique identifier.
+     *
+     * @param capabilityId - The capability_id to look up.
+     * @returns The CapabilitySchema for the requested capability.
+     */
+    getCapability(capabilityId: string): Promise<ApiResult<CapabilitySchema>>;
+    /**
+     * Deregister a capability from the marketplace.
+     *
+     * @param capabilityId - The capability_id to remove.
+     * @returns An empty object on successful deregistration.
+     */
+    deregisterCapability(capabilityId: string): Promise<ApiResult<Readonly<Record<string, never>>>>;
+}
+/**
+ * Create a typed HTTP client for the agent-marketplace server.
+ *
+ * @param config - Client configuration including base URL.
+ * @returns An AgentMarketplaceClient instance.
+ */
+export declare function createAgentMarketplaceClient(config: AgentMarketplaceClientConfig): AgentMarketplaceClient;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EACV,YAAY,EAEZ,SAAS,EACT,gBAAgB,EAChB,oBAAoB,EACpB,cAAc,EACd,WAAW,EACZ,MAAM,YAAY,CAAC;AAMpB,4DAA4D;AAC5D,MAAM,WAAW,4BAA4B;IAC3C,+EAA+E;IAC/E,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,iEAAiE;IACjE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,2DAA2D;IAC3D,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACrD;AA0DD,0DAA0D;AAC1D,MAAM,WAAW,sBAAsB;IACrC;;;;;OAKG;IACH,kBAAkB,CAChB,UAAU,EAAE,IAAI,CAAC,gBAAgB,EAAE,eAAe,CAAC,GAClD,OAAO,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAC,CAAC;IAExC;;;;;OAKG;IACH,cAAc,CAAC,KAAK,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,SAAS,CAAC,SAAS,YAAY,EAAE,CAAC,CAAC,CAAC;IAEpF;;;;;;;;OAQG;IACH,iBAAiB,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,SAAS,CAAC,SAAS,WAAW,EAAE,CAAC,CAAC,CAAC;IAErF;;;;;OAKG;IACH,kBAAkB,CAChB,UAAU,EAAE,IAAI,CAAC,gBAAgB,EAAE,eAAe,CAAC,GAClD,OAAO,CAAC,SAAS,CAAC,oBAAoB,CAAC,CAAC,CAAC;IAE5C;;;;;OAKG;IACH,WAAW,CAAC,OAAO,CAAC,EAAE;QACpB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;KACzB,GAAG,OAAO,CAAC,SAAS,CAAC,SAAS,YAAY,EAAE,CAAC,CAAC,CAAC;IAEhD;;;;;OAKG;IACH,aAAa,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAC,CAAC;IAE1E;;;;;OAKG;IACH,oBAAoB,CAClB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;CACxD;AAMD;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,4BAA4B,GACnC,sBAAsB,CA2GxB"}

package/dist/client.js

@@ -0,0 +1,129 @@
+/**
+ * HTTP client for the agent-marketplace capability registry API.
+ *
+ * Uses the Fetch API (available natively in Node 18+, browsers, and Deno).
+ * No external dependencies required.
+ *
+ * @example
+ * ```ts
+ * import { createAgentMarketplaceClient } from "@aumos/agent-marketplace";
+ *
+ * const client = createAgentMarketplaceClient({ baseUrl: "http://localhost:8092" });
+ *
+ * const result = await client.discoverAgents({
+ *   required_capabilities: ["analysis"],
+ *   min_trust: 0.8,
+ * });
+ *
+ * if (result.ok) {
+ *   console.log("Found listings:", result.data.length);
+ * }
+ * ```
+ */
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+async function fetchJson(url, init, timeoutMs) {
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), timeoutMs);
+    try {
+        const response = await fetch(url, { ...init, signal: controller.signal });
+        clearTimeout(timeoutId);
+        const body = await response.json();
+        if (!response.ok) {
+            const errorBody = body;
+            return {
+                ok: false,
+                error: {
+                    error: errorBody.error ?? "Unknown error",
+                    detail: errorBody.detail ?? "",
+                },
+                status: response.status,
+            };
+        }
+        return { ok: true, data: body };
+    }
+    catch (err) {
+        clearTimeout(timeoutId);
+        const message = err instanceof Error ? err.message : String(err);
+        return {
+            ok: false,
+            error: { error: "Network error", detail: message },
+            status: 0,
+        };
+    }
+}
+function buildHeaders(extraHeaders) {
+    return {
+        "Content-Type": "application/json",
+        Accept: "application/json",
+        ...extraHeaders,
+    };
+}
+// ---------------------------------------------------------------------------
+// Client factory
+// ---------------------------------------------------------------------------
+/**
+ * Create a typed HTTP client for the agent-marketplace server.
+ *
+ * @param config - Client configuration including base URL.
+ * @returns An AgentMarketplaceClient instance.
+ */
+export function createAgentMarketplaceClient(config) {
+    const { baseUrl, timeoutMs = 30000, headers: extraHeaders } = config;
+    const baseHeaders = buildHeaders(extraHeaders);
+    return {
+        async registerCapability(capability) {
+            return fetchJson(`${baseUrl}/capabilities`, {
+                method: "POST",
+                headers: baseHeaders,
+                body: JSON.stringify(capability),
+            }, timeoutMs);
+        },
+        async discoverAgents(query) {
+            return fetchJson(`${baseUrl}/discover`, {
+                method: "POST",
+                headers: baseHeaders,
+                body: JSON.stringify(query ?? {}),
+            }, timeoutMs);
+        },
+        async matchCapabilities(query) {
+            return fetchJson(`${baseUrl}/match`, {
+                method: "POST",
+                headers: baseHeaders,
+                body: JSON.stringify(query),
+            }, timeoutMs);
+        },
+        async validateCapability(capability) {
+            return fetchJson(`${baseUrl}/capabilities/validate`, {
+                method: "POST",
+                headers: baseHeaders,
+                body: JSON.stringify(capability),
+            }, timeoutMs);
+        },
+        async getListings(options) {
+            const params = new URLSearchParams();
+            if (options?.namespace !== undefined) {
+                params.set("namespace", options.namespace);
+            }
+            if (options?.category !== undefined) {
+                params.set("category", options.category);
+            }
+            if (options?.limit !== undefined) {
+                params.set("limit", String(options.limit));
+            }
+            const queryString = params.toString();
+            const url = queryString
+                ? `${baseUrl}/listings?${queryString}`
+                : `${baseUrl}/listings`;
+            return fetchJson(url, { method: "GET", headers: baseHeaders }, timeoutMs);
+        },
+        async getCapability(capabilityId) {
+            return fetchJson(`${baseUrl}/capabilities/${encodeURIComponent(capabilityId)}`, { method: "GET", headers: baseHeaders }, timeoutMs);
+        },
+        async deregisterCapability(capabilityId) {
+            return fetchJson(`${baseUrl}/capabilities/${encodeURIComponent(capabilityId)}`, { method: "DELETE", headers: baseHeaders }, timeoutMs);
+        },
+    };
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @aumos/agent-marketplace
+ *
+ * TypeScript client for the AumOS agent-marketplace library.
+ * Provides HTTP client and capability type definitions for agent capability
+ * registration, discovery, matching, and validation.
+ */
+export type { AgentMarketplaceClient, AgentMarketplaceClientConfig } from "./client.js";
+export { createAgentMarketplaceClient } from "./client.js";
+export type { CapabilityCategory, PricingModel, ProviderInfo, QualityMetrics, LatencyProfile, CapabilitySchema, AgentListing, DiscoveryQuery, MatchResult, CapabilityValidation, ApiError, ApiResult, } from "./types.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;;;;;;GAMG;AAGH,YAAY,EAAE,sBAAsB,EAAE,4BAA4B,EAAE,MAAM,aAAa,CAAC;AACxF,OAAO,EAAE,4BAA4B,EAAE,MAAM,aAAa,CAAC;AAG3D,YAAY,EACV,kBAAkB,EAClB,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,YAAY,EACZ,cAAc,EACd,WAAW,EACX,oBAAoB,EACpB,QAAQ,EACR,SAAS,GACV,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,9 @@
+/**
+ * @aumos/agent-marketplace
+ *
+ * TypeScript client for the AumOS agent-marketplace library.
+ * Provides HTTP client and capability type definitions for agent capability
+ * registration, discovery, matching, and validation.
+ */
+export { createAgentMarketplaceClient } from "./client.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;;;;;;GAMG;AAIH,OAAO,EAAE,4BAA4B,EAAE,MAAM,aAAa,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,188 @@
+/**
+ * TypeScript interfaces for the agent-marketplace capability registry.
+ *
+ * Mirrors the Pydantic models defined in:
+ *   agent_marketplace.schema.capability
+ *   agent_marketplace.schema.provider
+ *   agent_marketplace.matching.engine
+ *   agent_marketplace.matching.request
+ *
+ * All interfaces use readonly fields to match Python's frozen Pydantic models.
+ */
+/**
+ * High-level functional category for an agent capability.
+ * Maps to CapabilityCategory enum in Python.
+ */
+export type CapabilityCategory = "analysis" | "generation" | "transformation" | "extraction" | "interaction" | "automation" | "evaluation" | "research" | "reasoning" | "specialized";
+/**
+ * How a capability charges for its use.
+ * Maps to PricingModel enum in Python.
+ */
+export type PricingModel = "per_call" | "per_token" | "per_minute" | "free" | "custom";
+/**
+ * Identity and contact information for a capability provider.
+ * Maps to ProviderInfo in Python.
+ */
+export interface ProviderInfo {
+    /** Human-readable name of the provider (person or organization). */
+    readonly name: string;
+    /** Optional formal organization name. */
+    readonly organization: string;
+    /** Email address for support or inquiries. */
+    readonly contact_email: string;
+    /** Optional provider website URL. */
+    readonly website: string;
+    /** Optional GitHub username or org handle. */
+    readonly github_handle: string;
+    /** Optional Hugging Face username or org handle. */
+    readonly huggingface_handle: string;
+    /** Whether the provider identity has been externally verified. */
+    readonly verified: boolean;
+}
+/**
+ * Quantitative quality measurements for a capability.
+ * Maps to QualityMetrics in Python.
+ */
+export interface QualityMetrics {
+    /** Mapping of metric name to numeric score (e.g. {"accuracy": 0.94}). */
+    readonly metrics: Readonly<Record<string, number>>;
+    /** Name or URL of the benchmark that produced these numbers. */
+    readonly benchmark_source: string;
+    /** ISO 8601 date string when benchmarks were last run. */
+    readonly benchmark_date: string;
+    /** Whether these metrics have been independently verified. */
+    readonly verified: boolean;
+}
+/**
+ * Latency percentile measurements in milliseconds.
+ * Maps to LatencyProfile in Python.
+ */
+export interface LatencyProfile {
+    /** Median (50th percentile) latency in milliseconds. */
+    readonly p50_ms: number;
+    /** 95th percentile latency in milliseconds. */
+    readonly p95_ms: number;
+    /** 99th percentile latency in milliseconds. */
+    readonly p99_ms: number;
+}
+/**
+ * A fully described agent capability registered in the marketplace.
+ * Maps to AgentCapability in Python.
+ */
+export interface CapabilitySchema {
+    /** Auto-generated stable identifier (SHA-256 hex prefix of name+version+provider). */
+    readonly capability_id: string;
+    /** Short, human-readable capability name (e.g. "pdf-extractor"). */
+    readonly name: string;
+    /** Semantic version string (e.g. "1.2.0"). */
+    readonly version: string;
+    /** Prose description of what the capability does. */
+    readonly description: string;
+    /** Primary functional category. */
+    readonly category: CapabilityCategory;
+    /** Free-form tags for keyword search. */
+    readonly tags: readonly string[];
+    /** MIME types or schema names accepted by the capability. */
+    readonly input_types: readonly string[];
+    /** MIME type or schema name produced by the capability. */
+    readonly output_type: string;
+    /** Benchmark and quality scores. */
+    readonly quality_metrics: QualityMetrics;
+    /** How usage is billed. */
+    readonly pricing_model: PricingModel;
+    /** Unit cost corresponding to the pricing model (USD). */
+    readonly cost: number;
+    /** Latency percentile profile. */
+    readonly latency: LatencyProfile;
+    /** Natural language codes (ISO 639-1) the capability handles. */
+    readonly supported_languages: readonly string[];
+    /** Agent framework names this capability has adapters for. */
+    readonly supported_frameworks: readonly string[];
+    /** Current computed trust score (0.0–1.0); updated by TrustScorer. */
+    readonly trust_level: number;
+    /** Identity information for the capability publisher. */
+    readonly provider: ProviderInfo;
+}
+/**
+ * A marketplace listing entry returned when browsing available capabilities.
+ * Combines the capability schema with marketplace metadata.
+ */
+export interface AgentListing {
+    /** The registered capability schema. */
+    readonly capability: CapabilitySchema;
+    /** ISO-8601 UTC timestamp when this capability was registered. */
+    readonly registered_at: string;
+    /** Total number of times this capability has been invoked. */
+    readonly usage_count: number;
+    /** Average user rating in [0.0, 5.0], or null if no ratings. */
+    readonly average_rating: number | null;
+    /** Namespace this capability belongs to (e.g. "aumos", "community"). */
+    readonly namespace: string;
+}
+/**
+ * Parameters for discovering agent capabilities in the marketplace.
+ * Maps to FilterConstraints + CapabilityRequest in Python.
+ */
+export interface DiscoveryQuery {
+    /** Required capability keywords, names, or category strings. */
+    readonly required_capabilities?: readonly string[];
+    /** Preferred median latency in milliseconds (soft preference). */
+    readonly preferred_latency_ms?: number;
+    /** Maximum acceptable cost per call in USD. */
+    readonly max_cost?: number;
+    /** Minimum acceptable trust level [0.0, 1.0]. */
+    readonly min_trust?: number;
+    /** Restrict results to a single capability category. */
+    readonly category?: CapabilityCategory;
+    /** Tags that must all be present (AND semantics). */
+    readonly required_tags?: readonly string[];
+    /** Maximum number of results to return. */
+    readonly limit?: number;
+    /** Namespace to restrict the search to. */
+    readonly namespace?: string;
+}
+/**
+ * A capability paired with its composite match score for a specific request.
+ * Maps to MatchResult in Python.
+ */
+export interface MatchResult {
+    /** The matched capability schema. */
+    readonly capability: CapabilitySchema;
+    /** Composite match quality score in [0.0, 1.0]. Higher is better. */
+    readonly match_score: number;
+    /** Fraction of required capabilities matched [0.0, 1.0]. */
+    readonly capability_overlap: number;
+    /** Latency fitness component [0.0, 1.0]. */
+    readonly latency_score: number;
+    /** Trust component (direct from capability.trust_level). */
+    readonly trust_score: number;
+    /** Cost fitness component [0.0, 1.0]. */
+    readonly cost_score: number;
+}
+/**
+ * Result of validating a capability schema against marketplace business rules.
+ * Maps to the output of AgentCapability.validate() in Python.
+ */
+export interface CapabilityValidation {
+    /** Whether the capability passes all validation rules. */
+    readonly valid: boolean;
+    /** List of human-readable error messages; empty when valid. */
+    readonly errors: readonly string[];
+    /** The capability_id that was validated. */
+    readonly capability_id: string;
+}
+/** Standard error payload returned by the agent-marketplace API. */
+export interface ApiError {
+    readonly error: string;
+    readonly detail: string;
+}
+/** Result type for all client operations. */
+export type ApiResult<T> = {
+    readonly ok: true;
+    readonly data: T;
+} | {
+    readonly ok: false;
+    readonly error: ApiError;
+    readonly status: number;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,13 @@
+/**
+ * TypeScript interfaces for the agent-marketplace capability registry.
+ *
+ * Mirrors the Pydantic models defined in:
+ *   agent_marketplace.schema.capability
+ *   agent_marketplace.schema.provider
+ *   agent_marketplace.matching.engine
+ *   agent_marketplace.matching.request
+ *
+ * All interfaces use readonly fields to match Python's frozen Pydantic models.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG"}

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@aumos/agent-marketplace",
+  "version": "0.1.0",
+  "description": "TypeScript client for the AumOS agent-marketplace — capability registration, discovery, matching, and validation",
+  "license": "Apache-2.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit"
+  },
+  "devDependencies": {
+    "typescript": "^5.3.0"
+  },
+  "keywords": [
+    "aumos",
+    "agent-marketplace",
+    "capabilities",
+    "discovery",
+    "matching",
+    "typescript"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/aumos-ai/agent-marketplace"
+  }
+}

package/src/client.ts

@@ -0,0 +1,296 @@
+/**
+ * HTTP client for the agent-marketplace capability registry API.
+ *
+ * Uses the Fetch API (available natively in Node 18+, browsers, and Deno).
+ * No external dependencies required.
+ *
+ * @example
+ * ```ts
+ * import { createAgentMarketplaceClient } from "@aumos/agent-marketplace";
+ *
+ * const client = createAgentMarketplaceClient({ baseUrl: "http://localhost:8092" });
+ *
+ * const result = await client.discoverAgents({
+ *   required_capabilities: ["analysis"],
+ *   min_trust: 0.8,
+ * });
+ *
+ * if (result.ok) {
+ *   console.log("Found listings:", result.data.length);
+ * }
+ * ```
+ */
+
+import type {
+  AgentListing,
+  ApiError,
+  ApiResult,
+  CapabilitySchema,
+  CapabilityValidation,
+  DiscoveryQuery,
+  MatchResult,
+} from "./types.js";
+
+// ---------------------------------------------------------------------------
+// Client configuration
+// ---------------------------------------------------------------------------
+
+/** Configuration options for the AgentMarketplaceClient. */
+export interface AgentMarketplaceClientConfig {
+  /** Base URL of the agent-marketplace server (e.g. "http://localhost:8092"). */
+  readonly baseUrl: string;
+  /** Optional request timeout in milliseconds (default: 30000). */
+  readonly timeoutMs?: number;
+  /** Optional extra HTTP headers sent with every request. */
+  readonly headers?: Readonly<Record<string, string>>;
+}
+
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+
+async function fetchJson<T>(
+  url: string,
+  init: RequestInit,
+  timeoutMs: number,
+): Promise<ApiResult<T>> {
+  const controller = new AbortController();
+  const timeoutId = setTimeout(() => controller.abort(), timeoutMs);
+
+  try {
+    const response = await fetch(url, { ...init, signal: controller.signal });
+    clearTimeout(timeoutId);
+
+    const body = await response.json() as unknown;
+
+    if (!response.ok) {
+      const errorBody = body as Partial<ApiError>;
+      return {
+        ok: false,
+        error: {
+          error: errorBody.error ?? "Unknown error",
+          detail: errorBody.detail ?? "",
+        },
+        status: response.status,
+      };
+    }
+
+    return { ok: true, data: body as T };
+  } catch (err: unknown) {
+    clearTimeout(timeoutId);
+    const message = err instanceof Error ? err.message : String(err);
+    return {
+      ok: false,
+      error: { error: "Network error", detail: message },
+      status: 0,
+    };
+  }
+}
+
+function buildHeaders(
+  extraHeaders: Readonly<Record<string, string>> | undefined,
+): Record<string, string> {
+  return {
+    "Content-Type": "application/json",
+    Accept: "application/json",
+    ...extraHeaders,
+  };
+}
+
+// ---------------------------------------------------------------------------
+// Client interface
+// ---------------------------------------------------------------------------
+
+/** Typed HTTP client for the agent-marketplace server. */
+export interface AgentMarketplaceClient {
+  /**
+   * Register a new capability schema in the marketplace.
+   *
+   * @param capability - The full capability schema to register.
+   * @returns The registered CapabilitySchema with auto-generated capability_id.
+   */
+  registerCapability(
+    capability: Omit<CapabilitySchema, "capability_id">,
+  ): Promise<ApiResult<CapabilitySchema>>;
+
+  /**
+   * Discover agents in the marketplace matching the given query parameters.
+   *
+   * @param query - Optional filter and ranking parameters.
+   * @returns Array of AgentListing records ranked by relevance.
+   */
+  discoverAgents(query?: DiscoveryQuery): Promise<ApiResult<readonly AgentListing[]>>;
+
+  /**
+   * Match a structured capability request against all registered capabilities.
+   *
+   * Returns results ranked by composite match score (capability overlap,
+   * latency fitness, trust level, cost fitness).
+   *
+   * @param query - The discovery query specifying required capabilities and constraints.
+   * @returns Array of MatchResult records sorted best-first by match_score.
+   */
+  matchCapabilities(query: DiscoveryQuery): Promise<ApiResult<readonly MatchResult[]>>;
+
+  /**
+   * Validate a capability schema against marketplace business rules.
+   *
+   * @param capability - The capability schema to validate.
+   * @returns A CapabilityValidation with any error messages.
+   */
+  validateCapability(
+    capability: Omit<CapabilitySchema, "capability_id">,
+  ): Promise<ApiResult<CapabilityValidation>>;
+
+  /**
+   * Retrieve all marketplace listings, optionally filtered by namespace.
+   *
+   * @param options - Optional filter and pagination parameters.
+   * @returns Array of AgentListing records.
+   */
+  getListings(options?: {
+    readonly namespace?: string;
+    readonly category?: string;
+    readonly limit?: number;
+  }): Promise<ApiResult<readonly AgentListing[]>>;
+
+  /**
+   * Retrieve a single capability by its unique identifier.
+   *
+   * @param capabilityId - The capability_id to look up.
+   * @returns The CapabilitySchema for the requested capability.
+   */
+  getCapability(capabilityId: string): Promise<ApiResult<CapabilitySchema>>;
+
+  /**
+   * Deregister a capability from the marketplace.
+   *
+   * @param capabilityId - The capability_id to remove.
+   * @returns An empty object on successful deregistration.
+   */
+  deregisterCapability(
+    capabilityId: string,
+  ): Promise<ApiResult<Readonly<Record<string, never>>>>;
+}
+
+// ---------------------------------------------------------------------------
+// Client factory
+// ---------------------------------------------------------------------------
+
+/**
+ * Create a typed HTTP client for the agent-marketplace server.
+ *
+ * @param config - Client configuration including base URL.
+ * @returns An AgentMarketplaceClient instance.
+ */
+export function createAgentMarketplaceClient(
+  config: AgentMarketplaceClientConfig,
+): AgentMarketplaceClient {
+  const { baseUrl, timeoutMs = 30_000, headers: extraHeaders } = config;
+  const baseHeaders = buildHeaders(extraHeaders);
+
+  return {
+    async registerCapability(
+      capability: Omit<CapabilitySchema, "capability_id">,
+    ): Promise<ApiResult<CapabilitySchema>> {
+      return fetchJson<CapabilitySchema>(
+        `${baseUrl}/capabilities`,
+        {
+          method: "POST",
+          headers: baseHeaders,
+          body: JSON.stringify(capability),
+        },
+        timeoutMs,
+      );
+    },
+
+    async discoverAgents(
+      query?: DiscoveryQuery,
+    ): Promise<ApiResult<readonly AgentListing[]>> {
+      return fetchJson<readonly AgentListing[]>(
+        `${baseUrl}/discover`,
+        {
+          method: "POST",
+          headers: baseHeaders,
+          body: JSON.stringify(query ?? {}),
+        },
+        timeoutMs,
+      );
+    },
+
+    async matchCapabilities(
+      query: DiscoveryQuery,
+    ): Promise<ApiResult<readonly MatchResult[]>> {
+      return fetchJson<readonly MatchResult[]>(
+        `${baseUrl}/match`,
+        {
+          method: "POST",
+          headers: baseHeaders,
+          body: JSON.stringify(query),
+        },
+        timeoutMs,
+      );
+    },
+
+    async validateCapability(
+      capability: Omit<CapabilitySchema, "capability_id">,
+    ): Promise<ApiResult<CapabilityValidation>> {
+      return fetchJson<CapabilityValidation>(
+        `${baseUrl}/capabilities/validate`,
+        {
+          method: "POST",
+          headers: baseHeaders,
+          body: JSON.stringify(capability),
+        },
+        timeoutMs,
+      );
+    },
+
+    async getListings(options?: {
+      readonly namespace?: string;
+      readonly category?: string;
+      readonly limit?: number;
+    }): Promise<ApiResult<readonly AgentListing[]>> {
+      const params = new URLSearchParams();
+      if (options?.namespace !== undefined) {
+        params.set("namespace", options.namespace);
+      }
+      if (options?.category !== undefined) {
+        params.set("category", options.category);
+      }
+      if (options?.limit !== undefined) {
+        params.set("limit", String(options.limit));
+      }
+      const queryString = params.toString();
+      const url = queryString
+        ? `${baseUrl}/listings?${queryString}`
+        : `${baseUrl}/listings`;
+      return fetchJson<readonly AgentListing[]>(
+        url,
+        { method: "GET", headers: baseHeaders },
+        timeoutMs,
+      );
+    },
+
+    async getCapability(
+      capabilityId: string,
+    ): Promise<ApiResult<CapabilitySchema>> {
+      return fetchJson<CapabilitySchema>(
+        `${baseUrl}/capabilities/${encodeURIComponent(capabilityId)}`,
+        { method: "GET", headers: baseHeaders },
+        timeoutMs,
+      );
+    },
+
+    async deregisterCapability(
+      capabilityId: string,
+    ): Promise<ApiResult<Readonly<Record<string, never>>>> {
+      return fetchJson<Readonly<Record<string, never>>>(
+        `${baseUrl}/capabilities/${encodeURIComponent(capabilityId)}`,
+        { method: "DELETE", headers: baseHeaders },
+        timeoutMs,
+      );
+    },
+  };
+}
+

package/src/index.ts

@@ -0,0 +1,27 @@
+/**
+ * @aumos/agent-marketplace
+ *
+ * TypeScript client for the AumOS agent-marketplace library.
+ * Provides HTTP client and capability type definitions for agent capability
+ * registration, discovery, matching, and validation.
+ */
+
+// Client and configuration
+export type { AgentMarketplaceClient, AgentMarketplaceClientConfig } from "./client.js";
+export { createAgentMarketplaceClient } from "./client.js";
+
+// Core types
+export type {
+  CapabilityCategory,
+  PricingModel,
+  ProviderInfo,
+  QualityMetrics,
+  LatencyProfile,
+  CapabilitySchema,
+  AgentListing,
+  DiscoveryQuery,
+  MatchResult,
+  CapabilityValidation,
+  ApiError,
+  ApiResult,
+} from "./types.js";

package/src/types.ts

@@ -0,0 +1,245 @@
+/**
+ * TypeScript interfaces for the agent-marketplace capability registry.
+ *
+ * Mirrors the Pydantic models defined in:
+ *   agent_marketplace.schema.capability
+ *   agent_marketplace.schema.provider
+ *   agent_marketplace.matching.engine
+ *   agent_marketplace.matching.request
+ *
+ * All interfaces use readonly fields to match Python's frozen Pydantic models.
+ */
+
+// ---------------------------------------------------------------------------
+// Enumerations
+// ---------------------------------------------------------------------------
+
+/**
+ * High-level functional category for an agent capability.
+ * Maps to CapabilityCategory enum in Python.
+ */
+export type CapabilityCategory =
+  | "analysis"
+  | "generation"
+  | "transformation"
+  | "extraction"
+  | "interaction"
+  | "automation"
+  | "evaluation"
+  | "research"
+  | "reasoning"
+  | "specialized";
+
+/**
+ * How a capability charges for its use.
+ * Maps to PricingModel enum in Python.
+ */
+export type PricingModel =
+  | "per_call"
+  | "per_token"
+  | "per_minute"
+  | "free"
+  | "custom";
+
+// ---------------------------------------------------------------------------
+// Provider info
+// ---------------------------------------------------------------------------
+
+/**
+ * Identity and contact information for a capability provider.
+ * Maps to ProviderInfo in Python.
+ */
+export interface ProviderInfo {
+  /** Human-readable name of the provider (person or organization). */
+  readonly name: string;
+  /** Optional formal organization name. */
+  readonly organization: string;
+  /** Email address for support or inquiries. */
+  readonly contact_email: string;
+  /** Optional provider website URL. */
+  readonly website: string;
+  /** Optional GitHub username or org handle. */
+  readonly github_handle: string;
+  /** Optional Hugging Face username or org handle. */
+  readonly huggingface_handle: string;
+  /** Whether the provider identity has been externally verified. */
+  readonly verified: boolean;
+}
+
+// ---------------------------------------------------------------------------
+// Quality metrics and latency profile
+// ---------------------------------------------------------------------------
+
+/**
+ * Quantitative quality measurements for a capability.
+ * Maps to QualityMetrics in Python.
+ */
+export interface QualityMetrics {
+  /** Mapping of metric name to numeric score (e.g. {"accuracy": 0.94}). */
+  readonly metrics: Readonly<Record<string, number>>;
+  /** Name or URL of the benchmark that produced these numbers. */
+  readonly benchmark_source: string;
+  /** ISO 8601 date string when benchmarks were last run. */
+  readonly benchmark_date: string;
+  /** Whether these metrics have been independently verified. */
+  readonly verified: boolean;
+}
+
+/**
+ * Latency percentile measurements in milliseconds.
+ * Maps to LatencyProfile in Python.
+ */
+export interface LatencyProfile {
+  /** Median (50th percentile) latency in milliseconds. */
+  readonly p50_ms: number;
+  /** 95th percentile latency in milliseconds. */
+  readonly p95_ms: number;
+  /** 99th percentile latency in milliseconds. */
+  readonly p99_ms: number;
+}
+
+// ---------------------------------------------------------------------------
+// Capability schema
+// ---------------------------------------------------------------------------
+
+/**
+ * A fully described agent capability registered in the marketplace.
+ * Maps to AgentCapability in Python.
+ */
+export interface CapabilitySchema {
+  /** Auto-generated stable identifier (SHA-256 hex prefix of name+version+provider). */
+  readonly capability_id: string;
+  /** Short, human-readable capability name (e.g. "pdf-extractor"). */
+  readonly name: string;
+  /** Semantic version string (e.g. "1.2.0"). */
+  readonly version: string;
+  /** Prose description of what the capability does. */
+  readonly description: string;
+  /** Primary functional category. */
+  readonly category: CapabilityCategory;
+  /** Free-form tags for keyword search. */
+  readonly tags: readonly string[];
+  /** MIME types or schema names accepted by the capability. */
+  readonly input_types: readonly string[];
+  /** MIME type or schema name produced by the capability. */
+  readonly output_type: string;
+  /** Benchmark and quality scores. */
+  readonly quality_metrics: QualityMetrics;
+  /** How usage is billed. */
+  readonly pricing_model: PricingModel;
+  /** Unit cost corresponding to the pricing model (USD). */
+  readonly cost: number;
+  /** Latency percentile profile. */
+  readonly latency: LatencyProfile;
+  /** Natural language codes (ISO 639-1) the capability handles. */
+  readonly supported_languages: readonly string[];
+  /** Agent framework names this capability has adapters for. */
+  readonly supported_frameworks: readonly string[];
+  /** Current computed trust score (0.0–1.0); updated by TrustScorer. */
+  readonly trust_level: number;
+  /** Identity information for the capability publisher. */
+  readonly provider: ProviderInfo;
+}
+
+// ---------------------------------------------------------------------------
+// Agent listing
+// ---------------------------------------------------------------------------
+
+/**
+ * A marketplace listing entry returned when browsing available capabilities.
+ * Combines the capability schema with marketplace metadata.
+ */
+export interface AgentListing {
+  /** The registered capability schema. */
+  readonly capability: CapabilitySchema;
+  /** ISO-8601 UTC timestamp when this capability was registered. */
+  readonly registered_at: string;
+  /** Total number of times this capability has been invoked. */
+  readonly usage_count: number;
+  /** Average user rating in [0.0, 5.0], or null if no ratings. */
+  readonly average_rating: number | null;
+  /** Namespace this capability belongs to (e.g. "aumos", "community"). */
+  readonly namespace: string;
+}
+
+// ---------------------------------------------------------------------------
+// Discovery query
+// ---------------------------------------------------------------------------
+
+/**
+ * Parameters for discovering agent capabilities in the marketplace.
+ * Maps to FilterConstraints + CapabilityRequest in Python.
+ */
+export interface DiscoveryQuery {
+  /** Required capability keywords, names, or category strings. */
+  readonly required_capabilities?: readonly string[];
+  /** Preferred median latency in milliseconds (soft preference). */
+  readonly preferred_latency_ms?: number;
+  /** Maximum acceptable cost per call in USD. */
+  readonly max_cost?: number;
+  /** Minimum acceptable trust level [0.0, 1.0]. */
+  readonly min_trust?: number;
+  /** Restrict results to a single capability category. */
+  readonly category?: CapabilityCategory;
+  /** Tags that must all be present (AND semantics). */
+  readonly required_tags?: readonly string[];
+  /** Maximum number of results to return. */
+  readonly limit?: number;
+  /** Namespace to restrict the search to. */
+  readonly namespace?: string;
+}
+
+// ---------------------------------------------------------------------------
+// Match result
+// ---------------------------------------------------------------------------
+
+/**
+ * A capability paired with its composite match score for a specific request.
+ * Maps to MatchResult in Python.
+ */
+export interface MatchResult {
+  /** The matched capability schema. */
+  readonly capability: CapabilitySchema;
+  /** Composite match quality score in [0.0, 1.0]. Higher is better. */
+  readonly match_score: number;
+  /** Fraction of required capabilities matched [0.0, 1.0]. */
+  readonly capability_overlap: number;
+  /** Latency fitness component [0.0, 1.0]. */
+  readonly latency_score: number;
+  /** Trust component (direct from capability.trust_level). */
+  readonly trust_score: number;
+  /** Cost fitness component [0.0, 1.0]. */
+  readonly cost_score: number;
+}
+
+// ---------------------------------------------------------------------------
+// Capability validation
+// ---------------------------------------------------------------------------
+
+/**
+ * Result of validating a capability schema against marketplace business rules.
+ * Maps to the output of AgentCapability.validate() in Python.
+ */
+export interface CapabilityValidation {
+  /** Whether the capability passes all validation rules. */
+  readonly valid: boolean;
+  /** List of human-readable error messages; empty when valid. */
+  readonly errors: readonly string[];
+  /** The capability_id that was validated. */
+  readonly capability_id: string;
+}
+
+// ---------------------------------------------------------------------------
+// API result wrapper
+// ---------------------------------------------------------------------------
+
+/** Standard error payload returned by the agent-marketplace API. */
+export interface ApiError {
+  readonly error: string;
+  readonly detail: string;
+}
+
+/** Result type for all client operations. */
+export type ApiResult<T> =
+  | { readonly ok: true; readonly data: T }
+  | { readonly ok: false; readonly error: ApiError; readonly status: number };

package/tsconfig.json

@@ -0,0 +1,25 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "lib": ["ES2020", "DOM"],
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "strict": true,
+    "noImplicitAny": true,
+    "strictNullChecks": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "noImplicitReturns": true,
+    "exactOptionalPropertyTypes": true,
+    "forceConsistentCasingInFileNames": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}