npm - @xopcai/xopc - Versions diffs - 0.0.171 → 0.0.173 - Mend

@xopcai/xopc 0.0.171 → 0.0.173

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (228) hide show

package/dist/gateway/static/root/index.html CHANGED Viewed

@@ -11,7 +11,7 @@
     <link rel="apple-touch-icon" sizes="180x180" href="/apple-touch-icon.png?v=20260713-1" />
     <link rel="manifest" href="/site.webmanifest?v=20260713-1" />
     <title>XOPC — Turn goals into loops. Keep what matters moving.</title>
-    <script type="module" crossorigin src="/assets/index-vHb2z7VS.js"></script>
+    <script type="module" crossorigin src="/assets/index-CAZ9343h.js"></script>
     <link rel="modulepreload" crossorigin href="/assets/rolldown-runtime-aKtaBQYM.js">
     <link rel="modulepreload" crossorigin href="/assets/preload-helper-zJ_50EbN.js">
     <link rel="modulepreload" crossorigin href="/assets/vendor-react-BOUWij0V.js">
@@ -24,17 +24,17 @@
     <link rel="modulepreload" crossorigin href="/assets/check-DUBLcKHA.js">
     <link rel="modulepreload" crossorigin href="/assets/circle-alert-BEjgurr2.js">
     <link rel="modulepreload" crossorigin href="/assets/middleware-Pd0e8Igk.js">
-    <link rel="modulepreload" crossorigin href="/assets/messages-CKZuaOeG.js">
-    <link rel="modulepreload" crossorigin href="/assets/locale-store-CzIfXqm8.js">
+    <link rel="modulepreload" crossorigin href="/assets/messages-DWrg3c4K.js">
+    <link rel="modulepreload" crossorigin href="/assets/locale-store-Ccv7tH8B.js">
     <link rel="modulepreload" crossorigin href="/assets/cn-JdwAhgNB.js">
     <link rel="modulepreload" crossorigin href="/assets/schemas-DgQq6Z5S.js">
     <link rel="modulepreload" crossorigin href="/assets/product-delivery-BTRT9kCS.js">
     <link rel="modulepreload" crossorigin href="/assets/config-reload-event-Bjh2zoKp.js">
     <link rel="modulepreload" crossorigin href="/assets/copy-to-clipboard-HOJ79TWv.js">
-    <link rel="modulepreload" crossorigin href="/assets/gateway-startup-retry-mcMq_uu_.js">
-    <link rel="modulepreload" crossorigin href="/assets/activity-store-BLz30jWq.js">
-    <link rel="modulepreload" crossorigin href="/assets/theme-store-1OkdVC8l.js">
-    <link rel="stylesheet" crossorigin href="/assets/index-DEdyUjxM.css">
+    <link rel="modulepreload" crossorigin href="/assets/gateway-startup-retry-C2JXXtwg.js">
+    <link rel="modulepreload" crossorigin href="/assets/activity-store-ByVA0N5n.js">
+    <link rel="modulepreload" crossorigin href="/assets/theme-store-DCKDVPFF.js">
+    <link rel="stylesheet" crossorigin href="/assets/index-BCkNJ5cR.css">
   </head>
   <body>
     <div id="root"></div>

package/dist/package.js CHANGED Viewed

@@ -1,4 +1,4 @@
 //#region package.json
-var version = "0.0.171";
+var version = "0.0.173";
 //#endregion
 export { version };

package/dist/src/agent/agent-manager.d.ts CHANGED Viewed

@@ -9,7 +9,7 @@ import type { AgentInstanceGateway } from './agent-instance-gateway.js';
 import { type Config } from '../config/schema.js';
 import { type EffectiveAgentProfile } from '../config/agent-profile.js';
 import type { ModelManager } from './models/manager.js';
-import type { SkillInstallToolOptions, SkillInstallToolResult } from './tools/skill-install-tool.js';
+import type { SkillInstallToolOptions, SkillInstallToolResult, MarketplaceSkillInstallToolOptions, MarketplaceSkillInstallToolResult } from './tools/skill-install-tool.js';
 import { type AgentCapabilityCatalogEntry, type AgentCapabilitySessionState } from './capabilities/index.js';
 import type { GatewayClarifyRequestFn } from './tools/clarify-tool.js';
 import type { ExtensionRegistryImpl as ExtensionRegistry } from '../extensions/index.js';
@@ -98,6 +98,8 @@ export interface AgentManagerConfig {
     }) => void;
     /** Install a managed skill from an explicit source and refresh runtime state. */
     installSkillFromSource?: (opts: SkillInstallToolOptions) => Promise<SkillInstallToolResult>;
+    /** Install a managed skill from Store or ClawHub and refresh runtime state. */
+    installSkillFromMarketplace?: (opts: MarketplaceSkillInstallToolOptions) => Promise<MarketplaceSkillInstallToolResult>;
     /** Dynamic workspace verification context injected into the system prompt when edits are pending. */
     getSelfVerifyPromptContext?: (sessionKey: string, agentId?: string) => string;
     /**

package/dist/src/agent/agent-manager.js CHANGED Viewed

@@ -18,6 +18,9 @@ import { resolveBootstrapContextSync } from "./bootstrap/bootstrap-files.js";
 import { loadProjectAgentsContextFile } from "./bootstrap/project-agents-context.js";
 import { createSkillConfigManager, isSkillEnabled, resolveSkillConfig } from "./skills/config.js";
 import { resolveWorkspaceSkillsDir, resolveWorkspaceSkillsLockPath } from "./skills/workspace-skills-dir.js";
+import { isValidSkillEnvVarName } from "./skills/required-env-vars.js";
+import { loadSkillsLock } from "./skills/hub-lock.js";
+import { isUnderManagedSkillsDir } from "./skills/managed-store.js";
 import { isMemorySubsystemEnabled, shouldRegisterCuratedMemoryTool } from "./memory/memory-config.js";
 import { resolveDreamingRoot } from "./memory/dreaming/scope.js";
 import { createAgentCapabilitySessionState, resolveAgentCapabilityCatalog } from "./capabilities/registry.js";
@@ -27,9 +30,6 @@ import { parseMcpToolName } from "./mcp/bundle-mcp-policy.js";
 import { disposeAllSessionMcpRuntimes, retireSessionMcpRuntimeForSessionKey } from "./mcp/bundle-mcp-runtime.js";
 import "./mcp/bundle-mcp-tools.js";
 import { evictAllEmbeddedSessionRunners, evictEmbeddedSessionRunner } from "./embedded/session-runner.js";
-import { isValidSkillEnvVarName } from "./skills/required-env-vars.js";
-import { loadSkillsLock } from "./skills/hub-lock.js";
-import { isUnderManagedSkillsDir } from "./skills/managed-store.js";
 import { UserContextCoordinator } from "./memory/user-context-coordinator.js";
 import { WorkspaceRuntimeRegistry } from "./workspace-runtime/registry.js";
 import { BackgroundReviewCoordinator } from "./background-review/coordinator.js";
@@ -262,6 +262,7 @@ var AgentManager = class {
 				for (const n of names) if (isValidSkillEnvVarName(n)) inst.skillEnvPassthroughKeys.add(n.trim());
 			},
 			installSkillFromSource: this.config.installSkillFromSource,
+			installSkillFromMarketplace: this.config.installSkillFromMarketplace,
 			getCodeIntelligenceRuntime: (workspace) => this.workspaceRuntimes.getOrCreate(workspace, resolveEffectiveAgentProfileForSession(this.config.config, this.config.getCurrentContext?.()?.sessionKey).agentId).codeIntelligence
 		};
 	}

package/dist/src/agent/capabilities/definitions.d.ts CHANGED Viewed

@@ -113,7 +113,7 @@ export declare const AGENT_CAPABILITY_DEFINITIONS: readonly [{
     readonly label: "Skill installation";
     readonly description: "Find, install, and update xopc skills from explicit sources.";
     readonly category: "authoring";
-    readonly tools: readonly ["skills_list", "skill_view", "skill_install"];
+    readonly tools: readonly ["skills_list", "skill_view", "skills_marketplace_search", "skill_install"];
     readonly activation: {
         readonly mode: "explicit";
         readonly ttl: "turn";
@@ -121,6 +121,7 @@ export declare const AGENT_CAPABILITY_DEFINITIONS: readonly [{
     readonly permissions: {
         readonly writesFiles: true;
         readonly usesNetwork: true;
+        readonly requiresConfirm: true;
     };
 }, {
     readonly id: "visual-asset-authoring";

package/dist/src/agent/capabilities/definitions.js CHANGED Viewed

@@ -96,6 +96,7 @@ const AGENT_CAPABILITY_DEFINITIONS = [
 		tools: [
 			"skills_list",
 			"skill_view",
+			"skills_marketplace_search",
 			"skill_install"
 		],
 		activation: {
@@ -104,7 +105,8 @@ const AGENT_CAPABILITY_DEFINITIONS = [
 		},
 		permissions: {
 			writesFiles: true,
-			usesNetwork: true
+			usesNetwork: true,
+			requiresConfirm: true
 		}
 	},
 	{

package/dist/src/agent/memory/builtin-provider.js CHANGED Viewed

@@ -170,8 +170,8 @@ var BuiltinMemoryProvider = class {
 				projectId: request.scope?.projectId,
 				content: request.content,
 				source: {
-					...request.source ?? {},
-					provider: this.id
+					provider: this.id,
+					...request.source ?? {}
 				},
 				confidence: request.confidence,
 				tags: request.tags,
@@ -208,9 +208,9 @@ var BuiltinMemoryProvider = class {
 				sessionKey: request.scope?.sessionKey,
 				content: request.content,
 				source: {
-					...request.source ?? {},
 					provider: this.id,
-					path: sourcePathForTarget(target)
+					path: sourcePathForTarget(target),
+					...request.source ?? {}
 				},
 				tags: request.tags,
 				canonicalKey: request.canonicalKey,

package/dist/src/agent/memory/manager.d.ts CHANGED Viewed

@@ -53,9 +53,12 @@ export declare class MemoryManager {
     applyUnderstandingCandidates(candidates: UnderstandingCandidate[], context?: {
         agentId?: string;
         sessionKey?: string;
+        sourceItemId?: string;
+        sourceItemIds?: string[];
         sourceText?: string;
+        source?: MemoryRecord['source'];
         reviewSource?: 'turn' | 'background';
-    }): Promise<void>;
+    }): Promise<import('./understanding/types.js').UnderstandingReviewResult>;
     getAdditionalTools(): AgentTool[];
     handleToolCall(toolName: string, args: Record<string, unknown>): Promise<string>;
     search(request: MemorySearchRequest): Promise<MemorySearchResult[]>;

package/dist/src/agent/memory/manager.js CHANGED Viewed

@@ -130,13 +130,18 @@ var MemoryManager = class {
 		}
 	}
 	async applyUnderstandingCandidates(candidates, context = {}) {
-		const sourceItemId = context.sessionKey ? this.lastTurnSourceItem.get(context.sessionKey) : void 0;
-		await this.understanding.applyCandidates(candidates, {
+		const sourceItemId = context.sourceItemId ?? (context.sessionKey ? this.lastTurnSourceItem.get(context.sessionKey) : void 0);
+		const result = await this.understanding.applyCandidates(candidates, {
 			...context,
 			agentId: context.agentId ?? this.understandingAgentId,
 			sourceItemId
 		});
-		if (sourceItemId) setKnowledgeSourceItemSynthesisStatus([sourceItemId], "completed");
+		const sourceItemIds = [...new Set([...sourceItemId ? [sourceItemId] : [], ...context.sourceItemIds ?? []])];
+		if (sourceItemIds.length) setKnowledgeSourceItemSynthesisStatus(sourceItemIds, "completed");
+		return {
+			...result,
+			...sourceItemId ? { sourceItemId } : {}
+		};
 	}
 	getAdditionalTools() {
 		const out = [];

package/dist/src/agent/memory/understanding/service.d.ts CHANGED Viewed

@@ -19,7 +19,9 @@ export declare class UserUnderstandingService {
         agentId?: string;
         sessionKey?: string;
         sourceItemId?: string;
+        sourceItemIds?: string[];
         sourceText?: string;
+        source?: MemoryRecord['source'];
         reviewSource?: 'turn' | 'background';
         supersedesRecordIds?: string[];
     }): Promise<Omit<UnderstandingReviewResult, 'sourceItemId'>>;

package/dist/src/agent/memory/understanding/service.js CHANGED Viewed

@@ -92,6 +92,7 @@ var UserUnderstandingService = class {
 		const contentHash = createHash("sha256").update(sourceText).digest("hex");
 		const sourceItemId = upsertKnowledgeSourceItems([{
 			sourceInstanceId: params.sessionKey ? `session:${params.sessionKey}` : "session:unknown",
+			collectionScope: "conversation",
 			externalId: contentHash,
 			itemType: "conversation_turn",
 			authorRole: "user",
@@ -136,20 +137,21 @@ var UserUnderstandingService = class {
 			const key = candidate.canonicalKey ?? canonicalKey(candidate.kind, content);
 			const supersedesRecordId = correctionTargets.length === 1 ? correctionTargets[0] : void 0;
 			const existing = await this.options.list(key);
-			const evidence = {
-				...context.sourceItemId ? { sourceItemId: context.sourceItemId } : {},
+			const sourceItemIds = [...new Set([...context.sourceItemId ? [context.sourceItemId] : [], ...context.sourceItemIds ?? []])];
+			const evidence = (sourceItemIds.length ? sourceItemIds : [void 0]).map((sourceItemId) => ({
+				...sourceItemId ? { sourceItemId } : {},
 				relation: "supports",
 				...context.sessionKey ? { sessionKey: context.sessionKey } : {},
 				...evidenceText ? { sourceText: evidenceText } : {},
 				observedAt: (/* @__PURE__ */ new Date()).toISOString(),
 				confidence: candidate.confidence
-			};
+			}));
 			if (existing[0]) {
 				deduplicated += 1;
 				recordIds.push(existing[0].id);
-				if (context.sourceItemId) attachMemoryEvidence({
+				for (const sourceItemId of sourceItemIds) attachMemoryEvidence({
 					recordId: existing[0].id,
-					sourceItemId: context.sourceItemId,
+					sourceItemId,
 					relation: "supports",
 					excerpt: evidenceText,
 					confidence: candidate.confidence
@@ -166,7 +168,7 @@ var UserUnderstandingService = class {
 				} : void 0,
 				target: candidate.kind === "preference" ? "user" : "memory",
 				tags: [...new Set(["user-understanding", ...candidate.tags ?? []])],
-				source: { provider: "user-understanding" },
+				source: context.source ?? { provider: "user-understanding" },
 				confidence: candidate.confidence,
 				status: "candidate",
 				sensitivity,
@@ -174,7 +176,7 @@ var UserUnderstandingService = class {
 				durability: candidate.durability,
 				importance: candidate.importance,
 				disclosurePolicy: candidate.disclosurePolicy,
-				evidence: [evidence],
+				evidence,
 				validFrom: candidate.validFrom,
 				validTo: candidate.validTo,
 				reviewAfter: nextMemoryReviewAt({
@@ -194,9 +196,9 @@ var UserUnderstandingService = class {
 						kind: write.record.kind
 					});
 				}
-				if (write.record && context.sourceItemId) attachMemoryEvidence({
+				for (const sourceItemId of write.record ? sourceItemIds : []) attachMemoryEvidence({
 					recordId: write.record.id,
-					sourceItemId: context.sourceItemId,
+					sourceItemId,
 					relation: "supports",
 					excerpt: evidenceText,
 					confidence: candidate.confidence

package/dist/src/agent/prompt/sections/tooling.js CHANGED Viewed

@@ -31,6 +31,8 @@ const CORE_TOOL_ORDER = [
 	"skills_list",
 	"skill_view",
 	"skill_manage",
+	"skills_marketplace_search",
+	"skill_install",
 	"todo",
 	"clarify",
 	"text_to_speech",
@@ -71,6 +73,8 @@ const CORE_TOOL_SUMMARIES = {
 	skills_list: "List available skills",
 	skill_view: "Load a skill SKILL.md or sub-documents",
 	skill_manage: "Create or update skills on disk",
+	skills_marketplace_search: "Search and rank skills across Store, ClawHub, and skills.sh without installing",
+	skill_install: "Install a skill from an explicit Git, archive, file, or local source after confirmation",
 	todo: "Manage in-session todo items",
 	clarify: "Ask the user a blocking clarification question",
 	text_to_speech: "Send a standalone voice message",

package/dist/src/agent/service.d.ts CHANGED Viewed

@@ -10,7 +10,7 @@ import type { SkillMarkdownPreviewPayload } from './skills/types.js';
 import type { AgentCapabilityCatalogEntry } from './capabilities/index.js';
 import type { AgentServiceConfig, StreamHandle } from './service.types.js';
 import { PersistentGoalService } from './goals/persistent-goal-service.js';
-import type { SkillInstallToolOptions, SkillInstallToolResult } from './tools/skill-install-tool.js';
+import type { SkillInstallToolOptions, SkillInstallToolResult, MarketplaceSkillInstallToolOptions, MarketplaceSkillInstallToolResult } from './tools/skill-install-tool.js';
 import { type InboundAttachmentInput, type MediaRef } from '../channels/attachments/inbound-persist.js';
 export type { AgentServiceConfig, AgentContext, StreamHandle } from './service.types.js';
 export declare class AgentService {
@@ -114,9 +114,11 @@ export declare class AgentService {
     getSkillMarkdownSource(skillName: string): SkillMarkdownPreviewPayload | null;
     refreshSkillsAfterDiskChange(): void;
     installSkillFromSource(opts: SkillInstallToolOptions): Promise<SkillInstallToolResult>;
+    installSkillFromMarketplace(opts: MarketplaceSkillInstallToolOptions): Promise<MarketplaceSkillInstallToolResult>;
     refreshSkillsAfterSkillConfigChange(): void;
     refreshActionTrustPolicy(): void;
     refreshUserProfileContext(): void;
+    getMemoryManager(): import("./memory/manager.js").MemoryManager;
     getModelForSession(sessionKey: string): string;
     switchModelForSession(sessionKey: string, modelId: string): Promise<boolean>;
     /**

package/dist/src/agent/service.js CHANGED Viewed

@@ -10,6 +10,8 @@ import { extractTextContent } from "./context/workspace.js";
 import { effectiveWorkspacePathForSession } from "../session/session-workspace.js";
 import { getProjectForSession } from "../projects/workspace.js";
 import { resolveWorkspaceSkillsDir, resolveWorkspaceSkillsLockPath } from "./skills/workspace-skills-dir.js";
+import { removeSkillsLockEntry } from "./skills/hub-lock.js";
+import { installSkillFromZip } from "./skills/managed-store.js";
 import { normalizeSkillInstallTarget } from "./skills/install-target.js";
 import { onSessionTranscriptUpdate } from "../session/transcript-events.js";
 import { persistInboundAttachments } from "../channels/attachments/inbound-persist.js";
@@ -246,6 +248,7 @@ var AgentService = class {
 			getWorkflowRunService: config.getWorkflowRunService,
 			onSkillsUpdated: config.onSkillsUpdated,
 			installSkillFromSource: (opts) => this.installSkillFromSource(opts),
+			installSkillFromMarketplace: (opts) => this.installSkillFromMarketplace(opts),
 			isWorkspaceTrusted: config.isWorkspaceTrusted,
 			getSelfVerifyPromptContext: (sessionKey, agentId) => [this.selfVerifyMiddleware.getPendingVerificationContext(sessionKey, agentId), this.turnDiffTracker.buildFinalGuardContext(sessionKey)].filter(Boolean).join("\n\n")
 		});
@@ -547,6 +550,29 @@ var AgentService = class {
 			target
 		};
 	}
+	async installSkillFromMarketplace(opts) {
+		const config = this.effectiveAppConfig();
+		const target = normalizeSkillInstallTarget(opts.target);
+		const workspace = (opts.sessionKey ? this.agentManager.getResolvedWorkspaceForSession(opts.sessionKey) : void 0) || this.workspaceDir;
+		const rootDir = target === "workspace" ? resolveWorkspaceSkillsDir(workspace) : void 0;
+		const lockPath = target === "workspace" ? resolveWorkspaceSkillsLockPath(workspace) : void 0;
+		const { downloadFromMarketplace } = await import("./skills/skills-marketplace.js");
+		const downloaded = await downloadFromMarketplace(config, opts.name, opts.version, opts.provider);
+		const result = installSkillFromZip(downloaded.buffer, {
+			skillId: downloaded.skillId,
+			overwrite: opts.force ?? false,
+			rootDir
+		});
+		removeSkillsLockEntry(result.skillId, lockPath);
+		this.refreshSkillsAfterDiskChange();
+		return {
+			...result,
+			provider: opts.provider,
+			name: opts.name,
+			version: downloaded.version,
+			target
+		};
+	}
 	refreshSkillsAfterSkillConfigChange() {
 		this.agentManager.refreshSkillsAfterSkillConfigChange();
 	}
@@ -556,6 +582,9 @@ var AgentService = class {
 	refreshUserProfileContext() {
 		this.agentManager.refreshUserProfileContext();
 	}
+	getMemoryManager() {
+		return this.agentManager.getMemoryManager();
+	}
 	getModelForSession(sessionKey) {
 		return this.modelManager.getModelForSession(sessionKey);
 	}

package/dist/src/agent/skills/hub-pull.js CHANGED Viewed

@@ -8,8 +8,8 @@ import { basename, dirname, join, normalize, resolve, sep } from "node:path";
 import { cpSync, existsSync, mkdirSync, mkdtempSync, readFileSync, readdirSync, rmSync, statSync, writeFileSync } from "node:fs";
 import { fileURLToPath } from "node:url";
 import { execFileSync } from "node:child_process";
-import { fetch } from "undici";
 import AdmZip from "adm-zip";
+import { fetch } from "undici";
 //#region src/agent/skills/hub-pull.ts
 /**
 * CLI / hub: install or update skills from git or archive (zip / tar.gz) into ~/.xopc/skills.

package/dist/src/agent/skills/index.js CHANGED Viewed

@@ -9,8 +9,8 @@ import { collectSkillInstallWarnings, formatScanSummary, scanSkillDirectory } fr
 import { resolveWorkspaceSkillsDir } from "./workspace-skills-dir.js";
 import { parseSkillToolConditions } from "./skill-tool-gating.js";
 import { parseRequiredEnvVarNames } from "./required-env-vars.js";
-import { formatSkillsForPrompt } from "./format-skills-prompt.js";
 import { parseSkillMetadata } from "./parse-skill-metadata.js";
+import { formatSkillsForPrompt } from "./format-skills-prompt.js";
 import { SkillTestFramework, SkillTestRunner, formatTestResults, formatTestResultsJson, formatTestResultsTap } from "./test-framework.js";
 import { basename, dirname, join, relative, sep } from "path";
 import { existsSync, readFileSync, readdirSync } from "fs";

package/dist/src/agent/skills/install-target.js CHANGED Viewed

@@ -1,6 +1,6 @@
 //#region src/agent/skills/install-target.ts
 function normalizeSkillInstallTarget(value) {
-	return value === "global" ? "global" : "workspace";
+	return value === "workspace" ? "workspace" : "global";
 }
 function isSkillInstallTarget(value) {
 	return value === "workspace" || value === "global";

package/dist/src/agent/skills/marketplace/adapters/clawhub/adapter.d.ts CHANGED Viewed

@@ -2,4 +2,68 @@
  * ClawHub (clawhub.ai) skills marketplace adapter.
  */
 import type { SkillsMarketplaceAdapter } from '../../adapter.types.js';
+export interface ClawHubSearchResultItem {
+    id?: string;
+    score?: number;
+    slug: string;
+    source?: string;
+    downloads?: number;
+    canonicalUrl?: string;
+    install?: {
+        kind?: string;
+        reference?: string;
+        sourceUrl?: string | null;
+    };
+    links?: {
+        canonical?: string | null;
+        source?: string | null;
+    };
+    sourceIdentity?: {
+        owner?: string | null;
+        repo?: string | null;
+    };
+    publisher?: {
+        handle?: string | null;
+        displayName?: string | null;
+        avatarUrl?: string | null;
+    };
+    metrics?: {
+        bookmarks?: number;
+        updatedAt?: number;
+    };
+    trust?: {
+        clawHubVerdict?: string | null;
+        installability?: string | null;
+        upstreamScanners?: Record<string, {
+            status?: string | null;
+            sourceCheckedAt?: string | null;
+            sourceUrl?: string | null;
+        }>;
+    };
+    native?: {
+        skill?: {
+            stats?: {
+                downloads?: number;
+                stars?: number;
+            };
+            tags?: Record<string, string>;
+            categories?: string[];
+        };
+    } | null;
+    displayName?: string;
+    summary?: string;
+    version?: string | null;
+    updatedAt?: number;
+    ownerHandle?: string;
+    owner?: {
+        handle: string;
+        displayName: string;
+        image: string | null;
+    };
+}
+export interface ClawHubSearchResponse {
+    results: ClawHubSearchResultItem[];
+}
+/** Public federated search used by the read-only marketplace discovery tool. */
+export declare function searchClawHubFederatedSkills(query: string, limit?: number): Promise<ClawHubSearchResponse>;
 export declare const clawHubMarketplaceAdapter: SkillsMarketplaceAdapter;

package/dist/src/agent/skills/marketplace/adapters/clawhub/adapter.js CHANGED Viewed

@@ -53,6 +53,10 @@ async function searchClawHubSkills(query, limit) {
 	assertOk(res, "search");
 	return await res.json();
 }
+/** Public federated search used by the read-only marketplace discovery tool. */
+async function searchClawHubFederatedSkills(query, limit) {
+	return cachedSearchClawHubSkills(query, limit);
+}
 async function getClawHubSkillDetail(slug) {
 	const res = await clawHubFetch(`/api/v1/skills/${encodeURIComponent(slug.trim())}`);
 	assertOk(res, `skill detail [${slug}]`);
@@ -73,10 +77,15 @@ async function getClawHubSkillFileText(slug, filePath, version) {
 	const text = await res.text();
 	return text.length > MAX_CLAWHUB_FILE_BYTES ? text.slice(0, MAX_CLAWHUB_FILE_BYTES) : text;
 }
-async function downloadClawHubSkillZip(slug, version) {
-	const enc = encodeURIComponent(slug.trim());
-	const sp = version?.trim() ? `?version=${encodeURIComponent(version.trim())}` : "";
-	const url = `${resolveClawHubBaseUrl()}/api/v1/packages/${enc}/download${sp}`;
+async function downloadClawHubSkillZip(reference, version) {
+	const parts = reference.trim().replace(/^@/, "").split("/").filter(Boolean);
+	const ownerHandle = parts.length === 2 ? parts[0] : void 0;
+	const slug = parts.length === 2 ? parts[1] : parts.length === 1 ? parts[0] : "";
+	if (!isValidSkillId(slug) || ownerHandle && !isValidSkillId(ownerHandle)) throw new Error(`Invalid ClawHub install reference: ${reference}`);
+	const sp = new URLSearchParams({ slug });
+	if (ownerHandle) sp.set("ownerHandle", ownerHandle);
+	if (version?.trim()) sp.set("version", version.trim());
+	const url = `${resolveClawHubBaseUrl()}/api/v1/download?${sp.toString()}`;
 	const res = await fetch(url, { redirect: "follow" });
 	if (!res.ok) {
 		const body = await res.text().catch(() => "");
@@ -88,7 +97,8 @@ async function downloadClawHubSkillZip(slug, version) {
 	if (arrayBuf.byteLength > MAX_SKILL_ZIP_BYTES) throw new Error(`ClawHub download [${slug}] exceeds size limit (${arrayBuf.byteLength} > ${MAX_SKILL_ZIP_BYTES})`);
 	return {
 		buffer: Buffer.from(arrayBuf),
-		version: version?.trim() || "latest"
+		version: version?.trim() || "latest",
+		slug
 	};
 }
 function pickClawHubDocFilePath(files) {
@@ -192,20 +202,20 @@ function convertListItemToPackageItem(item) {
 }
 function convertSearchResultToPackageItem(item, enrichment) {
 	return {
-		id: item.slug,
+		id: item.id ?? item.install?.reference ?? item.slug,
 		name: item.displayName || item.slug,
 		type: "skill",
 		description: item.summary || "",
-		downloads: enrichment?.stats.downloads ?? 0,
+		downloads: item.downloads ?? item.native?.skill?.stats?.downloads ?? enrichment?.stats.downloads ?? 0,
 		author: {
-			username: item.owner?.handle ?? item.ownerHandle ?? "clawhub",
-			avatarUrl: item.owner?.image ?? null
+			username: item.publisher?.handle ?? item.sourceIdentity?.owner ?? item.owner?.handle ?? item.ownerHandle ?? "clawhub",
+			avatarUrl: item.publisher?.avatarUrl ?? item.owner?.image ?? null
 		},
 		latestVersion: item.version ?? enrichment?.latestVersion?.version ?? "1.0.0",
-		updatedAt: String(item.updatedAt),
-		categories: enrichment?.metadata?.os ?? [],
-		stars: enrichment?.stats.stars ?? 0,
-		sourceLabel: "ClawHub"
+		updatedAt: String(item.metrics?.updatedAt ?? item.updatedAt ?? ""),
+		categories: item.native?.skill?.categories ?? enrichment?.metadata?.os ?? [],
+		stars: item.native?.skill?.stats?.stars ?? item.metrics?.bookmarks ?? enrichment?.stats.stars ?? 0,
+		sourceLabel: item.source === "skills-sh" ? "skills.sh" : "ClawHub"
 	};
 }
 function mapSortParam(sort) {
@@ -230,7 +240,7 @@ const clawHubMarketplaceAdapter = {
 			if (searchResponse.status === "rejected") throw searchResponse.reason;
 			const enrichmentBySlug = /* @__PURE__ */ new Map();
 			if (listSettled.status === "fulfilled") for (const it of listSettled.value.items) enrichmentBySlug.set(it.slug, it);
-			let rows = searchResponse.value.results.map((r) => convertSearchResultToPackageItem(r, enrichmentBySlug.get(r.slug)));
+			let rows = searchResponse.value.results.filter((r) => !r.source || r.source === "clawhub").map((r) => convertSearchResultToPackageItem(r, enrichmentBySlug.get(r.slug)));
 			if (params.sort === "downloads") rows = [...rows].sort((a, b) => b.downloads - a.downloads);
 			else if (params.sort === "newest") rows = [...rows].sort((a, b) => Number(b.updatedAt) - Number(a.updatedAt));
 			const total = rows.length;
@@ -304,11 +314,10 @@ const clawHubMarketplaceAdapter = {
 		};
 	},
 	async downloadPackage(_config, packageName, version) {
-		const slug = packageName.trim();
-		const result = await downloadClawHubSkillZip(slug, version);
+		const result = await downloadClawHubSkillZip(packageName, version);
 		return {
 			buffer: result.buffer,
-			skillId: isValidSkillId(slug) ? slug : "unknown",
+			skillId: result.slug,
 			version: result.version
 		};
 	}
@@ -318,4 +327,4 @@ registerMarketplaceAdapter({
 	displayName: "ClawHub"
 });
 //#endregion
-export { clawHubMarketplaceAdapter };
+export { clawHubMarketplaceAdapter, searchClawHubFederatedSkills };

package/dist/src/agent/skills/marketplace/adapters/store/adapter.js CHANGED Viewed

@@ -1,6 +1,6 @@
 import { registerMarketplaceAdapter } from "../../registry.js";
-import { downloadSkillZipBuffer, fetchMarketplacePackageDetail, listSkillPackages, resolveSkillZipDownloadUrl, resolveSkillsStoreBaseUrl, skillIdForMarketplaceInstall, verifyStoreArtifactSha256 } from "./store-api-client.js";
 import { buildSkillMarkdownPreviewFromRaw } from "../../../skill-markdown-preview-from-raw.js";
+import { downloadSkillZipBuffer, fetchMarketplacePackageDetail, listSkillPackages, resolveSkillZipDownloadUrl, resolveSkillsStoreBaseUrl, skillIdForMarketplaceInstall, verifyStoreArtifactSha256 } from "./store-api-client.js";
 //#region src/agent/skills/marketplace/adapters/store/adapter.ts
 const storeMarketplaceAdapter = {
 	id: "store",

package/dist/src/agent/skills/marketplace/adapters/store/store-api-client.js CHANGED Viewed

@@ -1,5 +1,5 @@
-import { MAX_SKILL_ZIP_BYTES, isValidSkillId } from "../../../managed-store.js";
 import { MAX_EXTENSION_STORE_ZIP_BYTES } from "../../../../../extensions/store-zip-limits.js";
+import { MAX_SKILL_ZIP_BYTES, isValidSkillId } from "../../../managed-store.js";
 import { createHash } from "node:crypto";
 //#region src/agent/skills/marketplace/adapters/store/store-api-client.ts
 /**

package/dist/src/agent/skills/marketplace/search.d.ts ADDED Viewed

@@ -0,0 +1,46 @@
+import type { Config } from '../../../config/schema.js';
+export declare const SKILL_MARKETPLACE_SEARCH_SOURCES: readonly ["store", "clawhub", "skills-sh"];
+export type SkillsMarketplaceSearchSource = (typeof SKILL_MARKETPLACE_SEARCH_SOURCES)[number];
+export interface SkillsMarketplaceSearchResult {
+    id: string;
+    provider: 'store' | 'clawhub';
+    source: SkillsMarketplaceSearchSource;
+    name: string;
+    description: string;
+    author: string;
+    downloads: number;
+    stars: number;
+    updatedAt: string | null;
+    canonicalUrl: string | null;
+    install: {
+        kind: string;
+        reference: string;
+        sourceUrl: string | null;
+    };
+    security: {
+        status: 'pass' | 'warn' | 'fail' | 'unknown';
+        scanners: Array<{
+            name: string;
+            status: 'pass' | 'warn' | 'fail' | 'unknown';
+            checkedAt: string | null;
+            url: string | null;
+        }>;
+    };
+    valueScore: number;
+}
+export interface SkillMarketplaceSourceStatus {
+    source: SkillsMarketplaceSearchSource;
+    ok: boolean;
+    count: number;
+    via?: 'clawhub';
+    error?: string;
+}
+export declare function searchSkillMarketplaces(params: {
+    config: Config;
+    query: string;
+    sources?: SkillsMarketplaceSearchSource[];
+    limit?: number;
+}): Promise<{
+    results: SkillsMarketplaceSearchResult[];
+    sources: SkillMarketplaceSourceStatus[];
+}>;