@nebutra/play-marketplace 0.1.1

package/README.md

@@ -0,0 +1,28 @@
+# @nebutra/play-marketplace
+
+Status: **WIP**
+
+Controlled Play registry surface for validating, publishing, searching, and
+installing SKILL.md Plays.
+
+## Boundary
+
+SKILL.md parsing belongs to `@nebutra/play-loader`. This package consumes that
+parser and writes local registry/install artifacts. It does not own billing
+deduction, remote registry transport, or verified review operations.
+
+## Commands
+
+```bash
+pnpm play-marketplace:doctor
+pnpm play-marketplace:quickstart
+pnpm play-marketplace:debug
+```
+
+## Current Closure
+
+- Play validation through play-loader.
+- Controlled paid publishing gate.
+- Local signed registry artifact.
+- Search and install handoff.
+- Quality metrics placeholders kept honest.

package/dist/chunk-2SUUBIJC.js

@@ -0,0 +1,189 @@
+// src/index.ts
+import { mkdir } from "fs/promises";
+import { join } from "path";
+import { appendCapabilityDebug, readCapabilityDebug } from "@nebutra/capability-kit/debug";
+import { ContentStore } from "@nebutra/content-store";
+import { CapabilityError as CapabilityError2 } from "@nebutra/errors";
+import { EventLog } from "@nebutra/event-log";
+
+// ../generation-context/src/index.ts
+import { CapabilityError } from "@nebutra/errors";
+function assetId(prefix, seed) {
+  return `${prefix}_${seed.toLowerCase().replace(/[^a-z0-9]+/g, "_").replace(/^_+|_+$/g, "").slice(0, 40)}_${Date.now().toString(36)}`;
+}
+
+// src/index.ts
+import { parsePlayMarkdown } from "@nebutra/play-loader";
+function requireTenant(value) {
+  if (!value?.trim()) {
+    throw new CapabilityError2("play-marketplace", "Play Marketplace requires tenant context", {
+      suggestion: "Pass tenantId so registry and install artifacts stay tenant-scoped.",
+      statusCode: 400
+    });
+  }
+  return value;
+}
+function isPaid(pricing) {
+  return pricing.model !== "free";
+}
+function validatePlayPackage(request) {
+  const play = parsePlayMarkdown(request.skillMarkdown);
+  return {
+    ok: true,
+    playName: play.meta.name,
+    version: play.meta.version,
+    requiredSkills: play.requiredSkills,
+    subAgents: play.subAgents.map((agent) => agent.role)
+  };
+}
+var PlayMarketplace = class _PlayMarketplace {
+  #tenantId;
+  #debugRoot;
+  #contentStore;
+  #eventLog;
+  #plays = /* @__PURE__ */ new Map();
+  constructor(options) {
+    this.#tenantId = requireTenant(options.tenantId);
+    this.#debugRoot = options.debugRoot ?? process.cwd();
+    this.#contentStore = options.contentStore;
+    this.#eventLog = options.eventLog;
+  }
+  static async open(root = ".nebutra/play-marketplace", options = {}) {
+    const tenantId = options.tenantId ?? "local";
+    await mkdir(root, { recursive: true });
+    const contentStore = await ContentStore.open(join(root, "content"), { tenantId });
+    const eventLog = await EventLog.open(join(root, "event-log"), { tenantId });
+    return new _PlayMarketplace({ ...options, tenantId, contentStore, eventLog });
+  }
+  async publish(request) {
+    if (isPaid(request.pricing) && !request.invitedAuthor) {
+      throw new CapabilityError2(
+        "play-marketplace",
+        "Paid Play publishing is limited during controlled launch",
+        {
+          suggestion: "Use an invited author account or publish a free Play until paid publishing opens.",
+          statusCode: 403
+        }
+      );
+    }
+    const validation = validatePlayPackage({ skillMarkdown: request.skillMarkdown });
+    const playId = validation.playName;
+    const registryPath = `marketplace/plays/${playId}@${validation.version}.json`;
+    const record = {
+      playId,
+      version: validation.version,
+      visibility: request.visibility,
+      pricing: request.pricing,
+      quality: {
+        verified: false,
+        successRate: 0,
+        avgCostUsd: 0,
+        avgDurationMinutes: 0
+      },
+      requiredSkills: validation.requiredSkills,
+      subAgents: validation.subAgents,
+      signature: assetId("play_sig", `${playId}_${validation.version}`)
+    };
+    const snapshot = `${JSON.stringify(record, null, 2)}
+`;
+    await this.#contentStore.write(registryPath, snapshot);
+    const eventId = await this.#eventLog.commit({
+      traceId: assetId("play_marketplace_publish", `${playId}_${validation.version}`),
+      kind: "content_write",
+      affected: [registryPath],
+      parent: null,
+      snapshot: { [registryPath]: snapshot }
+    });
+    const published = {
+      playId,
+      version: validation.version,
+      registryPath,
+      visibility: request.visibility,
+      pricing: request.pricing,
+      quality: record.quality,
+      eventId,
+      skillMarkdown: request.skillMarkdown
+    };
+    this.#plays.set(`${playId}@${validation.version}`, published);
+    await this.#debug({
+      type: "publish",
+      tenantId: this.#tenantId,
+      playId,
+      version: validation.version
+    });
+    return published;
+  }
+  async search(request) {
+    const probe = request.query.toLowerCase();
+    const items = [...this.#plays.values()].filter(
+      (play) => play.playId.toLowerCase().includes(probe) || play.skillMarkdown.toLowerCase().includes(probe)
+    ).sort(
+      (left, right) => request.sort === "success_rate" ? right.quality.successRate - left.quality.successRate || left.playId.localeCompare(right.playId) : right.eventId.localeCompare(left.eventId)
+    );
+    await this.#debug({
+      type: "search",
+      tenantId: this.#tenantId,
+      query: request.query,
+      hits: items.length
+    });
+    return { items };
+  }
+  async install(playId, version) {
+    const key = `${playId}@${version}`;
+    const play = this.#plays.get(key);
+    if (!play) {
+      throw new CapabilityError2("play-marketplace", "Play registry record not found", {
+        suggestion: "Search the marketplace and install an available version.",
+        metadata: { playId, version },
+        statusCode: 404
+      });
+    }
+    const installPath = `marketplace/installed/${playId}@${version}.json`;
+    const install = {
+      playId,
+      version,
+      status: "installed",
+      registeredSkill: playId,
+      installPath
+    };
+    const snapshot = `${JSON.stringify(install, null, 2)}
+`;
+    await this.#contentStore.write(installPath, snapshot);
+    await this.#eventLog.commit({
+      traceId: assetId("play_marketplace_install", `${playId}_${version}`),
+      kind: "content_write",
+      affected: [installPath],
+      parent: play.eventId,
+      snapshot: { [installPath]: snapshot }
+    });
+    await this.#debug({ type: "install", tenantId: this.#tenantId, playId, version });
+    return install;
+  }
+  async doctor() {
+    const report = {
+      capability: "play-marketplace",
+      ok: true,
+      checkedAt: (/* @__PURE__ */ new Date()).toISOString(),
+      features: ["validate-skill", "publish", "search", "install", "paid-launch-gate"],
+      suggestion: "Local registry artifacts are active; remote registry, billing, and verified review queues remain handoffs."
+    };
+    await this.#debug({ type: "doctor", tenantId: this.#tenantId, plays: this.#plays.size });
+    return report;
+  }
+  async close() {
+    await this.#contentStore.close();
+  }
+  async #debug(entry) {
+    await appendCapabilityDebug("play-marketplace", entry, { root: this.#debugRoot });
+  }
+};
+async function readPlayMarketplaceDebug(root = process.cwd(), limit = 20) {
+  return readCapabilityDebug("play-marketplace", { root, limit });
+}
+
+export {
+  validatePlayPackage,
+  PlayMarketplace,
+  readPlayMarketplaceDebug
+};
+//# sourceMappingURL=chunk-2SUUBIJC.js.map

package/dist/chunk-2SUUBIJC.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../../generation-context/src/index.ts"],"sourcesContent":["import { mkdir } from \"node:fs/promises\";\nimport { join } from \"node:path\";\nimport { appendCapabilityDebug, readCapabilityDebug } from \"@nebutra/capability-kit/debug\";\nimport { ContentStore } from \"@nebutra/content-store\";\nimport { CapabilityError } from \"@nebutra/errors\";\nimport { EventLog } from \"@nebutra/event-log\";\nimport { assetId } from \"@nebutra/generation-context\";\nimport { parsePlayMarkdown } from \"@nebutra/play-loader\";\n\nexport type Visibility = \"private\" | \"public\";\nexport type Pricing =\n  | { readonly model: \"free\" }\n  | { readonly model: \"one_time\"; readonly amountUsd: number }\n  | {\n      readonly model: \"subscription\";\n      readonly amountUsd: number;\n      readonly interval: \"month\" | \"year\";\n    }\n  | { readonly model: \"per_run\"; readonly amountUsd: number };\n\nexport interface ValidatePlayPackageRequest {\n  readonly skillMarkdown: string;\n}\n\nexport interface PlayValidationReport {\n  readonly ok: boolean;\n  readonly playName: string;\n  readonly version: string;\n  readonly requiredSkills: readonly string[];\n  readonly subAgents: readonly string[];\n}\n\nexport interface PublishPlayRequest {\n  readonly skillMarkdown: string;\n  readonly visibility: Visibility;\n  readonly pricing: Pricing;\n  readonly invitedAuthor: boolean;\n}\n\nexport interface PublishedPlay {\n  readonly playId: string;\n  readonly version: string;\n  readonly registryPath: string;\n  readonly visibility: Visibility;\n  readonly pricing: Pricing;\n  readonly quality: {\n    readonly verified: boolean;\n    readonly successRate: number;\n    readonly avgCostUsd: number;\n    readonly avgDurationMinutes: number;\n  };\n  readonly eventId: string;\n}\n\nexport interface MarketplaceSearchRequest {\n  readonly query: string;\n  readonly sort: \"success_rate\" | \"new\";\n}\n\nexport interface MarketplaceSearchResult {\n  readonly items: readonly PublishedPlay[];\n}\n\nexport interface InstalledPlay {\n  readonly playId: string;\n  readonly version: string;\n  readonly status: \"installed\";\n  readonly registeredSkill: string;\n  readonly installPath: string;\n}\n\nexport interface PlayMarketplaceDoctorReport {\n  readonly capability: \"play-marketplace\";\n  readonly ok: boolean;\n  readonly checkedAt: string;\n  readonly features: readonly string[];\n  readonly suggestion?: string;\n}\n\nexport interface PlayMarketplaceOptions {\n  readonly tenantId?: string;\n  readonly debugRoot?: string;\n  readonly contentStore?: ContentStore;\n  readonly eventLog?: EventLog;\n}\n\nfunction requireTenant(value: string | undefined): string {\n  if (!value?.trim()) {\n    throw new CapabilityError(\"play-marketplace\", \"Play Marketplace requires tenant context\", {\n      suggestion: \"Pass tenantId so registry and install artifacts stay tenant-scoped.\",\n      statusCode: 400,\n    });\n  }\n  return value;\n}\n\nfunction isPaid(pricing: Pricing): boolean {\n  return pricing.model !== \"free\";\n}\n\nexport function validatePlayPackage(request: ValidatePlayPackageRequest): PlayValidationReport {\n  const play = parsePlayMarkdown(request.skillMarkdown);\n  return {\n    ok: true,\n    playName: play.meta.name,\n    version: play.meta.version,\n    requiredSkills: play.requiredSkills,\n    subAgents: play.subAgents.map((agent) => agent.role),\n  };\n}\n\nexport class PlayMarketplace {\n  readonly #tenantId: string;\n  readonly #debugRoot: string;\n  readonly #contentStore: ContentStore;\n  readonly #eventLog: EventLog;\n  readonly #plays = new Map<string, PublishedPlay & { readonly skillMarkdown: string }>();\n\n  private constructor(\n    options: Required<Pick<PlayMarketplaceOptions, \"tenantId\" | \"contentStore\" | \"eventLog\">> &\n      Pick<PlayMarketplaceOptions, \"debugRoot\">,\n  ) {\n    this.#tenantId = requireTenant(options.tenantId);\n    this.#debugRoot = options.debugRoot ?? process.cwd();\n    this.#contentStore = options.contentStore;\n    this.#eventLog = options.eventLog;\n  }\n\n  static async open(\n    root = \".nebutra/play-marketplace\",\n    options: Omit<PlayMarketplaceOptions, \"contentStore\" | \"eventLog\"> = {},\n  ): Promise<PlayMarketplace> {\n    const tenantId = options.tenantId ?? \"local\";\n    await mkdir(root, { recursive: true });\n    const contentStore = await ContentStore.open(join(root, \"content\"), { tenantId });\n    const eventLog = await EventLog.open(join(root, \"event-log\"), { tenantId });\n    return new PlayMarketplace({ ...options, tenantId, contentStore, eventLog });\n  }\n\n  async publish(request: PublishPlayRequest): Promise<PublishedPlay> {\n    if (isPaid(request.pricing) && !request.invitedAuthor) {\n      throw new CapabilityError(\n        \"play-marketplace\",\n        \"Paid Play publishing is limited during controlled launch\",\n        {\n          suggestion:\n            \"Use an invited author account or publish a free Play until paid publishing opens.\",\n          statusCode: 403,\n        },\n      );\n    }\n\n    const validation = validatePlayPackage({ skillMarkdown: request.skillMarkdown });\n    const playId = validation.playName;\n    const registryPath = `marketplace/plays/${playId}@${validation.version}.json`;\n    const record = {\n      playId,\n      version: validation.version,\n      visibility: request.visibility,\n      pricing: request.pricing,\n      quality: {\n        verified: false,\n        successRate: 0,\n        avgCostUsd: 0,\n        avgDurationMinutes: 0,\n      },\n      requiredSkills: validation.requiredSkills,\n      subAgents: validation.subAgents,\n      signature: assetId(\"play_sig\", `${playId}_${validation.version}`),\n    };\n    const snapshot = `${JSON.stringify(record, null, 2)}\\n`;\n    await this.#contentStore.write(registryPath, snapshot);\n    const eventId = await this.#eventLog.commit({\n      traceId: assetId(\"play_marketplace_publish\", `${playId}_${validation.version}`),\n      kind: \"content_write\",\n      affected: [registryPath],\n      parent: null,\n      snapshot: { [registryPath]: snapshot },\n    });\n    const published: PublishedPlay & { readonly skillMarkdown: string } = {\n      playId,\n      version: validation.version,\n      registryPath,\n      visibility: request.visibility,\n      pricing: request.pricing,\n      quality: record.quality,\n      eventId,\n      skillMarkdown: request.skillMarkdown,\n    };\n    this.#plays.set(`${playId}@${validation.version}`, published);\n    await this.#debug({\n      type: \"publish\",\n      tenantId: this.#tenantId,\n      playId,\n      version: validation.version,\n    });\n    return published;\n  }\n\n  async search(request: MarketplaceSearchRequest): Promise<MarketplaceSearchResult> {\n    const probe = request.query.toLowerCase();\n    const items = [...this.#plays.values()]\n      .filter(\n        (play) =>\n          play.playId.toLowerCase().includes(probe) ||\n          play.skillMarkdown.toLowerCase().includes(probe),\n      )\n      .sort((left, right) =>\n        request.sort === \"success_rate\"\n          ? right.quality.successRate - left.quality.successRate ||\n            left.playId.localeCompare(right.playId)\n          : right.eventId.localeCompare(left.eventId),\n      );\n    await this.#debug({\n      type: \"search\",\n      tenantId: this.#tenantId,\n      query: request.query,\n      hits: items.length,\n    });\n    return { items };\n  }\n\n  async install(playId: string, version: string): Promise<InstalledPlay> {\n    const key = `${playId}@${version}`;\n    const play = this.#plays.get(key);\n    if (!play) {\n      throw new CapabilityError(\"play-marketplace\", \"Play registry record not found\", {\n        suggestion: \"Search the marketplace and install an available version.\",\n        metadata: { playId, version },\n        statusCode: 404,\n      });\n    }\n    const installPath = `marketplace/installed/${playId}@${version}.json`;\n    const install: InstalledPlay = {\n      playId,\n      version,\n      status: \"installed\",\n      registeredSkill: playId,\n      installPath,\n    };\n    const snapshot = `${JSON.stringify(install, null, 2)}\\n`;\n    await this.#contentStore.write(installPath, snapshot);\n    await this.#eventLog.commit({\n      traceId: assetId(\"play_marketplace_install\", `${playId}_${version}`),\n      kind: \"content_write\",\n      affected: [installPath],\n      parent: play.eventId,\n      snapshot: { [installPath]: snapshot },\n    });\n    await this.#debug({ type: \"install\", tenantId: this.#tenantId, playId, version });\n    return install;\n  }\n\n  async doctor(): Promise<PlayMarketplaceDoctorReport> {\n    const report: PlayMarketplaceDoctorReport = {\n      capability: \"play-marketplace\",\n      ok: true,\n      checkedAt: new Date().toISOString(),\n      features: [\"validate-skill\", \"publish\", \"search\", \"install\", \"paid-launch-gate\"],\n      suggestion:\n        \"Local registry artifacts are active; remote registry, billing, and verified review queues remain handoffs.\",\n    };\n    await this.#debug({ type: \"doctor\", tenantId: this.#tenantId, plays: this.#plays.size });\n    return report;\n  }\n\n  async close(): Promise<void> {\n    await this.#contentStore.close();\n  }\n\n  async #debug(entry: Record<string, unknown>): Promise<void> {\n    await appendCapabilityDebug(\"play-marketplace\", entry, { root: this.#debugRoot });\n  }\n}\n\nexport async function readPlayMarketplaceDebug(\n  root = process.cwd(),\n  limit = 20,\n): Promise<unknown[]> {\n  return readCapabilityDebug(\"play-marketplace\", { root, limit });\n}\n","import { CapabilityError } from \"@nebutra/errors\";\n\nexport interface PathRef {\n  readonly path: string;\n  readonly tenantId?: string;\n  readonly mediaType?: string;\n}\n\nexport interface BrandColor {\n  readonly name: string;\n  readonly hex: string;\n  readonly role?: \"primary\" | \"secondary\" | \"accent\" | \"neutral\" | \"background\";\n}\n\nexport interface TypographySpec {\n  readonly heading: string;\n  readonly body: string;\n  readonly accent?: string;\n}\n\nexport interface VisualStyle {\n  readonly name: string;\n  readonly keywords: readonly string[];\n  readonly avoid?: readonly string[];\n}\n\nexport interface BrandContext {\n  readonly tenantId: string;\n  readonly brandId: string;\n  readonly name: string;\n  readonly palette: readonly BrandColor[];\n  readonly typography: TypographySpec;\n  readonly visualStyle: VisualStyle;\n  readonly referenceImages: readonly PathRef[];\n  readonly forbidden: readonly string[];\n  readonly toneKeywords: readonly string[];\n  readonly sourcePath: string;\n}\n\nexport type LicenseStatus = \"commercial-ok\" | \"non-commercial\" | \"requires-attribution\" | \"unknown\";\n\nexport interface LicenseMetadata {\n  readonly status: LicenseStatus;\n  readonly source: string;\n  readonly suggestion?: string;\n}\n\nexport interface GeneratedAsset {\n  readonly id: string;\n  readonly tenantId: string;\n  readonly kind: \"image\" | \"video\" | \"audio\" | \"voice\" | \"mesh\";\n  readonly path: string;\n  readonly brandId: string;\n  readonly provider: string;\n  readonly model: string;\n  readonly createdAt: string;\n  readonly license: LicenseMetadata;\n  readonly metadata?: Record<string, unknown>;\n}\n\nexport function requireBrandContext(\n  brand: BrandContext | undefined,\n  capability: string,\n): BrandContext {\n  if (!brand) {\n    throw new CapabilityError(capability, \"BrandContext is required for generation\", {\n      suggestion:\n        \"Load company/BRAND.md through content-store and pass the parsed BrandContext into this call.\",\n      statusCode: 400,\n    });\n  }\n\n  const missing: string[] = [];\n  if (!brand.tenantId) missing.push(\"tenantId\");\n  if (!brand.brandId) missing.push(\"brandId\");\n  if (!brand.name) missing.push(\"name\");\n  if (brand.palette.length === 0) missing.push(\"palette\");\n  if (!brand.typography.heading || !brand.typography.body) missing.push(\"typography\");\n  if (!brand.visualStyle.name || brand.visualStyle.keywords.length === 0) {\n    missing.push(\"visualStyle\");\n  }\n  if (brand.toneKeywords.length === 0) missing.push(\"toneKeywords\");\n  if (!brand.sourcePath) missing.push(\"sourcePath\");\n\n  if (missing.length > 0) {\n    throw new CapabilityError(capability, \"BrandContext is incomplete\", {\n      suggestion: `Fill these BrandContext fields before generation: ${missing.join(\", \")}.`,\n      metadata: { missing },\n      statusCode: 400,\n    });\n  }\n\n  return brand;\n}\n\nexport function summarizeBrandContext(brand: BrandContext): string {\n  return [\n    brand.name,\n    `style=${brand.visualStyle.name}`,\n    `tone=${brand.toneKeywords.join(\", \")}`,\n    `palette=${brand.palette.map((color) => `${color.name}:${color.hex}`).join(\", \")}`,\n  ].join(\"; \");\n}\n\nexport function createDemoBrandContext(overrides: Partial<BrandContext> = {}): BrandContext {\n  return {\n    tenantId: \"demo_tenant\",\n    brandId: \"loop\",\n    name: \"Loop\",\n    palette: [\n      { name: \"signal\", hex: \"#00A693\", role: \"primary\" },\n      { name: \"ink\", hex: \"#151719\", role: \"neutral\" },\n      { name: \"spark\", hex: \"#F3C14B\", role: \"accent\" },\n    ],\n    typography: { heading: \"Geist Sans\", body: \"Geist Sans Mono\" },\n    visualStyle: {\n      name: \"focused technical optimism\",\n      keywords: [\"precise\", \"calm\", \"developer-native\"],\n      avoid: [\"dark horror\", \"generic stock\"],\n    },\n    referenceImages: [],\n    forbidden: [\"dark horror\", \"skeletal imagery\"],\n    toneKeywords: [\"technical\", \"warm\", \"direct\"],\n    sourcePath: \"company/BRAND.md\",\n    ...overrides,\n  };\n}\n\nexport function assetId(prefix: string, seed: string): string {\n  return `${prefix}_${seed\n    .toLowerCase()\n    .replace(/[^a-z0-9]+/g, \"_\")\n    .replace(/^_+|_+$/g, \"\")\n    .slice(0, 40)}_${Date.now().toString(36)}`;\n}\n"],"mappings":"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","names":["CapabilityError","CapabilityError"]}

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+
+export {  }

package/dist/cli.js

@@ -0,0 +1,36 @@
+import {
+  PlayMarketplace,
+  readPlayMarketplaceDebug
+} from "./chunk-2SUUBIJC.js";
+
+// src/cli.ts
+var command = process.argv[2] ?? "doctor";
+var root = process.env.PLAY_MARKETPLACE_ROOT ?? ".nebutra/play-marketplace";
+var tenantId = process.env.NEBUTRA_TENANT_ID ?? "local";
+if (command === "doctor") {
+  const marketplace = await PlayMarketplace.open(root, { tenantId });
+  try {
+    process.stdout.write(`${JSON.stringify(await marketplace.doctor(), null, 2)}
+`);
+  } finally {
+    await marketplace.close();
+  }
+} else if (command === "quickstart") {
+  const marketplace = await PlayMarketplace.open(root, { tenantId });
+  try {
+    process.stdout.write(`${JSON.stringify(await marketplace.doctor(), null, 2)}
+`);
+  } finally {
+    await marketplace.close();
+  }
+} else if (command === "debug") {
+  process.stdout.write(
+    `${JSON.stringify({ capability: "play-marketplace", entries: await readPlayMarketplaceDebug() }, null, 2)}
+`
+  );
+} else {
+  process.stderr.write(`Unknown play-marketplace command: ${command}
+`);
+  process.exitCode = 1;
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli.ts"],"sourcesContent":["import { PlayMarketplace, readPlayMarketplaceDebug } from \"./index\";\n\nconst command = process.argv[2] ?? \"doctor\";\nconst root = process.env.PLAY_MARKETPLACE_ROOT ?? \".nebutra/play-marketplace\";\nconst tenantId = process.env.NEBUTRA_TENANT_ID ?? \"local\";\n\nif (command === \"doctor\") {\n  const marketplace = await PlayMarketplace.open(root, { tenantId });\n  try {\n    process.stdout.write(`${JSON.stringify(await marketplace.doctor(), null, 2)}\\n`);\n  } finally {\n    await marketplace.close();\n  }\n} else if (command === \"quickstart\") {\n  const marketplace = await PlayMarketplace.open(root, { tenantId });\n  try {\n    process.stdout.write(`${JSON.stringify(await marketplace.doctor(), null, 2)}\\n`);\n  } finally {\n    await marketplace.close();\n  }\n} else if (command === \"debug\") {\n  process.stdout.write(\n    `${JSON.stringify({ capability: \"play-marketplace\", entries: await readPlayMarketplaceDebug() }, null, 2)}\\n`,\n  );\n} else {\n  process.stderr.write(`Unknown play-marketplace command: ${command}\\n`);\n  process.exitCode = 1;\n}\n"],"mappings":";;;;;;AAEA,IAAM,UAAU,QAAQ,KAAK,CAAC,KAAK;AACnC,IAAM,OAAO,QAAQ,IAAI,yBAAyB;AAClD,IAAM,WAAW,QAAQ,IAAI,qBAAqB;AAElD,IAAI,YAAY,UAAU;AACxB,QAAM,cAAc,MAAM,gBAAgB,KAAK,MAAM,EAAE,SAAS,CAAC;AACjE,MAAI;AACF,YAAQ,OAAO,MAAM,GAAG,KAAK,UAAU,MAAM,YAAY,OAAO,GAAG,MAAM,CAAC,CAAC;AAAA,CAAI;AAAA,EACjF,UAAE;AACA,UAAM,YAAY,MAAM;AAAA,EAC1B;AACF,WAAW,YAAY,cAAc;AACnC,QAAM,cAAc,MAAM,gBAAgB,KAAK,MAAM,EAAE,SAAS,CAAC;AACjE,MAAI;AACF,YAAQ,OAAO,MAAM,GAAG,KAAK,UAAU,MAAM,YAAY,OAAO,GAAG,MAAM,CAAC,CAAC;AAAA,CAAI;AAAA,EACjF,UAAE;AACA,UAAM,YAAY,MAAM;AAAA,EAC1B;AACF,WAAW,YAAY,SAAS;AAC9B,UAAQ,OAAO;AAAA,IACb,GAAG,KAAK,UAAU,EAAE,YAAY,oBAAoB,SAAS,MAAM,yBAAyB,EAAE,GAAG,MAAM,CAAC,CAAC;AAAA;AAAA,EAC3G;AACF,OAAO;AACL,UAAQ,OAAO,MAAM,qCAAqC,OAAO;AAAA,CAAI;AACrE,UAAQ,WAAW;AACrB;","names":[]}

package/dist/index.d.ts

@@ -0,0 +1,88 @@
+import { ContentStore } from '@nebutra/content-store';
+import { EventLog } from '@nebutra/event-log';
+
+type Visibility = "private" | "public";
+type Pricing = {
+    readonly model: "free";
+} | {
+    readonly model: "one_time";
+    readonly amountUsd: number;
+} | {
+    readonly model: "subscription";
+    readonly amountUsd: number;
+    readonly interval: "month" | "year";
+} | {
+    readonly model: "per_run";
+    readonly amountUsd: number;
+};
+interface ValidatePlayPackageRequest {
+    readonly skillMarkdown: string;
+}
+interface PlayValidationReport {
+    readonly ok: boolean;
+    readonly playName: string;
+    readonly version: string;
+    readonly requiredSkills: readonly string[];
+    readonly subAgents: readonly string[];
+}
+interface PublishPlayRequest {
+    readonly skillMarkdown: string;
+    readonly visibility: Visibility;
+    readonly pricing: Pricing;
+    readonly invitedAuthor: boolean;
+}
+interface PublishedPlay {
+    readonly playId: string;
+    readonly version: string;
+    readonly registryPath: string;
+    readonly visibility: Visibility;
+    readonly pricing: Pricing;
+    readonly quality: {
+        readonly verified: boolean;
+        readonly successRate: number;
+        readonly avgCostUsd: number;
+        readonly avgDurationMinutes: number;
+    };
+    readonly eventId: string;
+}
+interface MarketplaceSearchRequest {
+    readonly query: string;
+    readonly sort: "success_rate" | "new";
+}
+interface MarketplaceSearchResult {
+    readonly items: readonly PublishedPlay[];
+}
+interface InstalledPlay {
+    readonly playId: string;
+    readonly version: string;
+    readonly status: "installed";
+    readonly registeredSkill: string;
+    readonly installPath: string;
+}
+interface PlayMarketplaceDoctorReport {
+    readonly capability: "play-marketplace";
+    readonly ok: boolean;
+    readonly checkedAt: string;
+    readonly features: readonly string[];
+    readonly suggestion?: string;
+}
+interface PlayMarketplaceOptions {
+    readonly tenantId?: string;
+    readonly debugRoot?: string;
+    readonly contentStore?: ContentStore;
+    readonly eventLog?: EventLog;
+}
+declare function validatePlayPackage(request: ValidatePlayPackageRequest): PlayValidationReport;
+declare class PlayMarketplace {
+    #private;
+    private constructor();
+    static open(root?: string, options?: Omit<PlayMarketplaceOptions, "contentStore" | "eventLog">): Promise<PlayMarketplace>;
+    publish(request: PublishPlayRequest): Promise<PublishedPlay>;
+    search(request: MarketplaceSearchRequest): Promise<MarketplaceSearchResult>;
+    install(playId: string, version: string): Promise<InstalledPlay>;
+    doctor(): Promise<PlayMarketplaceDoctorReport>;
+    close(): Promise<void>;
+}
+declare function readPlayMarketplaceDebug(root?: string, limit?: number): Promise<unknown[]>;
+
+export { type InstalledPlay, type MarketplaceSearchRequest, type MarketplaceSearchResult, PlayMarketplace, type PlayMarketplaceDoctorReport, type PlayMarketplaceOptions, type PlayValidationReport, type Pricing, type PublishPlayRequest, type PublishedPlay, type ValidatePlayPackageRequest, type Visibility, readPlayMarketplaceDebug, validatePlayPackage };

package/dist/index.js

@@ -0,0 +1,11 @@
+import {
+  PlayMarketplace,
+  readPlayMarketplaceDebug,
+  validatePlayPackage
+} from "./chunk-2SUUBIJC.js";
+export {
+  PlayMarketplace,
+  readPlayMarketplaceDebug,
+  validatePlayPackage
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/examples/doctor.ts

@@ -0,0 +1,11 @@
+import { PlayMarketplace } from "../src/index";
+
+const marketplace = await PlayMarketplace.open(".nebutra/play-marketplace-example", {
+  tenantId: "local",
+});
+
+try {
+  process.stdout.write(`${JSON.stringify(await marketplace.doctor(), null, 2)}\n`);
+} finally {
+  await marketplace.close();
+}

package/examples/paid-gate.ts

@@ -0,0 +1,31 @@
+import { PlayMarketplace } from "../src/index";
+
+const skillMarkdown = `---
+name: paid_demo
+kind: play
+version: 1.0.0
+description: Paid demo play
+required_skills: []
+sub_agents: []
+---
+
+## What this play does
+
+Demonstrates the paid publish gate.`;
+
+const marketplace = await PlayMarketplace.open(".nebutra/play-marketplace-paid-gate-example", {
+  tenantId: "local",
+});
+
+try {
+  await marketplace.publish({
+    skillMarkdown,
+    visibility: "public",
+    pricing: { model: "subscription", amountUsd: 29, interval: "month" },
+    invitedAuthor: false,
+  });
+} catch (error) {
+  process.stdout.write(`${JSON.stringify(error, null, 2)}\n`);
+} finally {
+  await marketplace.close();
+}

package/examples/quickstart.ts

@@ -0,0 +1,33 @@
+import { PlayMarketplace } from "../src/index";
+
+const skillMarkdown = `---
+name: cold_email_pro
+kind: play
+version: 1.0.0
+description: Cold email draft play
+required_skills:
+  - content_store.write
+sub_agents: []
+---
+
+## What this play does
+
+Drafts a reviewed campaign.`;
+
+const marketplace = await PlayMarketplace.open(".nebutra/play-marketplace-example", {
+  tenantId: "local",
+});
+
+try {
+  const play = await marketplace.publish({
+    skillMarkdown,
+    visibility: "public",
+    pricing: { model: "free" },
+    invitedAuthor: true,
+  });
+  process.stdout.write(
+    `${JSON.stringify(await marketplace.install(play.playId, play.version), null, 2)}\n`,
+  );
+} finally {
+  await marketplace.close();
+}

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@nebutra/play-marketplace",
+  "version": "0.1.1",
+  "description": "Local registry, publishing, install, metrics, and billing handoff surface for SKILL.md Plays",
+  "private": false,
+  "license": "MIT",
+  "type": "module",
+  "nebutra": {
+    "status": "wip",
+    "productionReady": false,
+    "surface": "ecosystem-product",
+    "requires": [
+      "@nebutra/play-loader for SKILL.md validation",
+      "@nebutra/content-store for registry artifacts",
+      "@nebutra/event-log for publish and install checkpoints"
+    ],
+    "gaps": [
+      "Remote registry transport is represented as a local signed index",
+      "Paid billing is represented as a provider-neutral handoff manifest",
+      "Verified review queues are metadata-only until marketplace operations exist"
+    ],
+    "featureId": "play-marketplace",
+    "category": "ai",
+    "summary": "SKILL.md Play marketplace surface with quality gates and real usage stats"
+  },
+  "main": "./src/index.ts",
+  "types": "./src/index.ts",
+  "exports": {
+    ".": "./src/index.ts"
+  },
+  "dependencies": {
+    "@nebutra/capability-kit": "0.2.0",
+    "@nebutra/content-store": "0.1.0",
+    "@nebutra/errors": "0.1.0",
+    "@nebutra/event-log": "0.1.0",
+    "@nebutra/play-loader": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.19.15",
+    "tsup": "^8.5.1",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3",
+    "vitest": "^4.1.4"
+  },
+  "homepage": "https://github.com/Nebutra/Nebutra-Sailor/tree/main/packages/ai/play-marketplace#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Nebutra/Nebutra-Sailor.git",
+    "directory": "packages/ai/play-marketplace"
+  },
+  "bugs": {
+    "url": "https://github.com/Nebutra/Nebutra-Sailor/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
+  }
+}

package/plays/publish_play/SKILL.md

@@ -0,0 +1,24 @@
+---
+name: publish_play
+kind: play
+version: 1.0.0
+description: Validate and publish a SKILL.md Play into the controlled marketplace registry
+required_skills:
+  - play_loader.parse
+  - content_store.write
+  - event_log.commit
+sub_agents:
+  - role: registry_reviewer
+    allowed_skills: [play_loader.parse, content_store.write]
+depends_on_plays: []
+---
+
+## What this play does
+
+Validates a Play declaration, writes a signed registry artifact, and prepares install metadata.
+
+## Boundaries
+
+- SKILL.md parsing belongs to play-loader.
+- Paid publishing stays gated during controlled launch.
+- Billing and remote registry transport are explicit handoffs.

package/src/cli.ts

@@ -0,0 +1,28 @@
+import { PlayMarketplace, readPlayMarketplaceDebug } from "./index";
+
+const command = process.argv[2] ?? "doctor";
+const root = process.env.PLAY_MARKETPLACE_ROOT ?? ".nebutra/play-marketplace";
+const tenantId = process.env.NEBUTRA_TENANT_ID ?? "local";
+
+if (command === "doctor") {
+  const marketplace = await PlayMarketplace.open(root, { tenantId });
+  try {
+    process.stdout.write(`${JSON.stringify(await marketplace.doctor(), null, 2)}\n`);
+  } finally {
+    await marketplace.close();
+  }
+} else if (command === "quickstart") {
+  const marketplace = await PlayMarketplace.open(root, { tenantId });
+  try {
+    process.stdout.write(`${JSON.stringify(await marketplace.doctor(), null, 2)}\n`);
+  } finally {
+    await marketplace.close();
+  }
+} else if (command === "debug") {
+  process.stdout.write(
+    `${JSON.stringify({ capability: "play-marketplace", entries: await readPlayMarketplaceDebug() }, null, 2)}\n`,
+  );
+} else {
+  process.stderr.write(`Unknown play-marketplace command: ${command}\n`);
+  process.exitCode = 1;
+}