@xopcai/xopc 0.0.397 → 0.0.398

package/dist/src/extensions/agent-plugins/setup-contract.d.ts

@@ -52,3 +52,23 @@ export declare function pluginAuthorizations(manifest: {
     extensions?: Record<string, unknown>;
 }): PluginAuthorization[];
 export declare function safeAuthorizationUrl(value: string): string;
+export declare const pluginPermissionIssueSchema: z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodString;
+    scopes: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    instructions: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    method: z.ZodOptional<z.ZodString>;
+    helpUrl: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type PluginPermissionIssue = z.infer<typeof pluginPermissionIssueSchema>;
+export declare function parsePluginAuthorizationCheck(output: string, methodIds: string[]): {
+    authenticated: boolean;
+    issues: {
+        id: string;
+        title: string;
+        scopes: string[];
+        instructions: string[];
+        method?: string;
+        helpUrl?: string;
+    }[];
+};

package/dist/src/extensions/agent-plugins/setup-contract.js

@@ -54,5 +54,24 @@ function safeAuthorizationUrl(value) {
 	].includes(url.hostname))) throw new Error("Authorization requires an HTTPS or loopback URL");
 	return url.href;
 }
+const pluginPermissionIssueSchema = z.strictObject({
+	id,
+	title: z.string().min(1).max(100),
+	scopes: z.array(z.string().min(1).max(200).regex(/^[a-zA-Z0-9_.:-]+$/)).max(30).default([]),
+	instructions: z.array(z.string().min(1).max(1e3)).max(6).default([]),
+	method: id.optional(),
+	helpUrl: z.string().url().optional()
+});
+function parsePluginAuthorizationCheck(output, methodIds) {
+	const result = z.object({
+		authenticated: z.boolean(),
+		issues: z.array(pluginPermissionIssueSchema).max(20).default([])
+	}).parse(JSON.parse(output.trim().split("\n").at(-1)));
+	for (const issue of result.issues) {
+		if (issue.method && !methodIds.includes(issue.method)) throw new Error("Unknown permission recovery method");
+		if (issue.helpUrl) safeAuthorizationUrl(issue.helpUrl);
+	}
+	return result;
+}
 //#endregion
-export { pluginAuthorizationSchema, pluginAuthorizations, safeAuthorizationUrl, setupCommandSchema };
+export { parsePluginAuthorizationCheck, pluginAuthorizationSchema, pluginAuthorizations, pluginPermissionIssueSchema, safeAuthorizationUrl, setupCommandSchema };

package/dist/src/extensions/agent-plugins/setup.d.ts

@@ -45,6 +45,14 @@ declare const schema: z.ZodObject<{
             skipped: "skipped";
             connected: "connected";
         }>;
+        issues: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            title: z.ZodString;
+            scopes: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            instructions: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            method: z.ZodOptional<z.ZodString>;
+            helpUrl: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>>;
         method: z.ZodOptional<z.ZodString>;
         attemptId: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>>;

package/dist/src/extensions/agent-plugins/setup.js

@@ -1,7 +1,7 @@
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
 import { init_write_file_atomic, writeTextAtomicSync } from "../../infra/write-file-atomic.js";
-import { pluginAuthorizations } from "./setup-contract.js";
+import { pluginAuthorizations, pluginPermissionIssueSchema } from "./setup-contract.js";
 import { preparePluginResources } from "./resources.js";
 import { pluginName, pluginServerId } from "./validation.js";
 import { AgentPluginStore } from "./store.js";
@@ -12,7 +12,7 @@ import { pluginConfigMissing, readPluginUserConfig, savePluginUserConfig } from
 import { materializePluginServers } from "./mcp-adapter.js";
 import { getNativePiAgentDir } from "../../agent/mcp/native-mcp.js";
 import { cancelMcpAuthorization, getMcpAuthorization, probeMcpConnection, startMcpAuthorization, submitMcpRedirect } from "../../agent/mcp/connection-setup.js";
-import { cancelPluginCliAuthorizations, checkPluginCliAuthorization, getPluginCliAuthorization, startPluginCliAuthorization } from "./cli-authorization.js";
+import { cancelPluginCliAuthorizations, getPluginCliAuthorization, inspectPluginCliAuthorization, startPluginCliAuthorization } from "./cli-authorization.js";
 import { join } from "node:path";
 import { existsSync, readFileSync } from "node:fs";
 import { randomUUID } from "node:crypto";
@@ -66,6 +66,7 @@ const schema = z.object({
 			"skipped",
 			"error"
 		]),
+		issues: z.array(pluginPermissionIssueSchema).max(20).default([]),
 		method: z.string().optional(),
 		attemptId: z.string().optional()
 	})).default([]),
@@ -171,7 +172,8 @@ var PluginSetupService = class {
 			deferred: false,
 			authorizations: pluginAuthorizations(plugin.manifest).map((value) => ({
 				id: value.id,
-				state: "pending"
+				state: "pending",
+				issues: []
 			})),
 			operations: [],
 			missingConfig: pluginConfigMissing(this.store, plugin),
@@ -435,8 +437,11 @@ var PluginSetupService = class {
 			} else {
 				for (const target of job.authorizations) {
 					const method = declarations.find((value) => value.id === target.id).methods.find((value) => value.id === target.method);
-					if (method?.type === "cli") target.state = await checkPluginCliAuthorization(this.store, plugin, target.id, method, controller.signal) ? "connected" : "pending";
-					else if (method?.type === "form") {
+					if (method?.type === "cli") {
+						const check = await inspectPluginCliAuthorization(this.store, plugin, target.id, method, controller.signal);
+						target.state = check.authenticated ? "connected" : "pending";
+						target.issues = check.issues;
+					} else if (method?.type === "form") {
 						const values = readPluginUserConfig(this.store, id, plugin.receipt.revision);
 						target.state = method.fields.every((key) => values[key] !== void 0 && values[key] !== "") ? "connected" : "pending";
 					}

package/dist/src/extensions/agent-plugins/skill-catalog.d.ts

@@ -0,0 +1,14 @@
+import type { SkillCatalogEntry } from '../../agent/agent-manager.js';
+import { AgentPluginStore } from './store.js';
+export declare function pluginSkillName(plugin: ReturnType<AgentPluginStore['list']>[number], name: string): string;
+/** Browse installed content without enabling it in the Agent runtime. */
+export declare function withPluginSkillCatalog(catalog: SkillCatalogEntry[], store?: AgentPluginStore): SkillCatalogEntry[];
+export declare function pluginSkillPreview(name: string, store?: AgentPluginStore): {
+    name: string;
+    description: string;
+    bodyMarkdown: string;
+    disableModelInvocation: boolean;
+    metadata: import("../../agent/skills/types.js").SkillMetadata;
+    toolConditions?: import("../../agent/skills/types.js").SkillToolConditions;
+    requiredEnvVarNames?: string[];
+};

package/dist/src/extensions/agent-plugins/skill-catalog.js

@@ -0,0 +1,95 @@
+import { parseFrontmatter } from "../../markdown/frontmatter.js";
+import { createSkillConfigManager } from "../../agent/skills/config.js";
+import { parseSkillLocalizations } from "../../agent/skills/parse-skill-metadata.js";
+import { containedPath } from "./validation.js";
+import { AgentPluginStore } from "./store.js";
+import { buildSkillMarkdownPreviewFromRaw } from "../../agent/skills/skill-markdown-preview-from-raw.js";
+import { agentPluginInventoryRow } from "./inventory.js";
+import { basename, dirname } from "node:path";
+import { readFileSync } from "node:fs";
+//#region src/extensions/agent-plugins/skill-catalog.ts
+function pluginSkillName(plugin, name) {
+	return plugin.layout?.dialect !== "portable" ? `${plugin.id}.${name}` : name;
+}
+/** Browse installed content without enabling it in the Agent runtime. */
+function withPluginSkillCatalog(catalog, store = new AgentPluginStore()) {
+	const rows = [...catalog];
+	const config = createSkillConfigManager(store.stateDir).load();
+	for (const plugin of store.list()) {
+		const inventory = agentPluginInventoryRow(plugin, store);
+		const owner = {
+			id: plugin.id,
+			name: plugin.manifest.name,
+			title: inventory.setup.authorizations.length === 1 ? inventory.setup.authorizations[0].title : plugin.manifest.name,
+			authorizationStatus: inventory.authorizationStatus,
+			active: inventory.active,
+			readiness: plugin.readiness
+		};
+		for (const skill of plugin.skills) {
+			const name = pluginSkillName(plugin, skill.name);
+			const index = rows.findIndex((row) => row.origin === `plugin:${plugin.id}` && row.name === name);
+			try {
+				const raw = readFileSync(containedPath(plugin.rootDir, skill.filePath), "utf8");
+				const preview = buildSkillMarkdownPreviewFromRaw(raw, {
+					name,
+					description: ""
+				});
+				const { frontmatter } = parseFrontmatter(raw);
+				const fm = frontmatter;
+				const localizations = parseSkillLocalizations(fm).localizations ?? {
+					en: {
+						displayName: skill.name,
+						description: preview.description
+					},
+					"zh-CN": {
+						displayName: typeof fm.displayName === "string" ? fm.displayName : skill.name,
+						description: typeof fm.displayDescription === "string" ? fm.displayDescription : preview.description
+					}
+				};
+				if (index >= 0) {
+					rows[index] = {
+						...rows[index],
+						localizations,
+						plugin: owner
+					};
+					continue;
+				}
+				rows.push({
+					localizations,
+					directoryId: basename(dirname(skill.filePath)),
+					name,
+					description: preview.description,
+					source: "global",
+					origin: `plugin:${plugin.id}`,
+					path: dirname(skill.filePath),
+					managed: false,
+					writable: false,
+					enabled: config.entries?.[name]?.enabled !== false,
+					disableModelInvocation: preview.disableModelInvocation,
+					plugin: owner
+				});
+			} catch {}
+		}
+	}
+	return rows;
+}
+function pluginSkillPreview(name, store = new AgentPluginStore()) {
+	for (const plugin of store.list()) {
+		const skill = plugin.skills.find((skill) => pluginSkillName(plugin, skill.name) === name);
+		if (!skill) continue;
+		try {
+			return {
+				...buildSkillMarkdownPreviewFromRaw(readFileSync(containedPath(plugin.rootDir, skill.filePath), "utf8"), {
+					name,
+					description: ""
+				}),
+				name
+			};
+		} catch {
+			return null;
+		}
+	}
+	return null;
+}
+//#endregion
+export { pluginSkillName, pluginSkillPreview, withPluginSkillCatalog };

package/dist/src/extensions/agent-plugins/store.js

@@ -127,7 +127,7 @@ var AgentPluginStore = class {
 			});
 			const setupPath = join(this.stateDir, "plugin-setup", `${id}.json`);
 			const setup = existsSync(setupPath) ? JSON.parse(readFileSync(setupPath, "utf8")) : void 0;
-			const readiness = !valid || adapterChanged || capabilityChanged || inspection.layout?.compatibility.some((item) => item.component === "hooks" || item.component === "authorizations" && item.support === "invalid") ? "blocked" : setup?.packageRevision === receipt.revision && setup.state !== "completed" && !setup.installed ? "setup_required" : inspection.diagnostics.length || setup?.packageRevision === receipt.revision && (setup.partial || setup.installed && (setup.missingConfig?.length || setup.connections?.some((value) => value.state !== "connected") || setup.authorizations?.some((value) => value.state !== "connected"))) ? "degraded" : "ready";
+			const readiness = !valid || adapterChanged || capabilityChanged || inspection.layout?.compatibility.some((item) => item.component === "hooks" || item.component === "authorizations" && item.support === "invalid") ? "blocked" : setup?.packageRevision === receipt.revision && setup.state !== "completed" && !setup.installed ? "setup_required" : inspection.diagnostics.length || setup?.packageRevision === receipt.revision && (setup.partial || setup.installed && (setup.missingConfig?.length || setup.connections?.some((value) => value.state !== "connected") || setup.authorizations?.some((value) => value.state !== "connected" || !!value.issues?.length))) ? "degraded" : "ready";
 			return {
 				...inspection,
 				id,

package/dist/src/extensions/agent-plugins/validation.js

@@ -7,8 +7,8 @@ import { dirname, isAbsolute, join, relative, resolve } from "node:path";
 import { existsSync, lstatSync, readFileSync, readdirSync, realpathSync, statSync } from "node:fs";
 import { createHash } from "node:crypto";
 import { z } from "zod";
-import yaml from "js-yaml";
 import { validateHeaderName, validateHeaderValue } from "node:http";
+import yaml from "js-yaml";
 //#region src/extensions/agent-plugins/validation.ts
 init_schema();
 const PLUGIN_SCHEMA = "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json";

package/dist/src/extensions/sdk/index.js

@@ -7,8 +7,8 @@ import { DEFAULT_SECURITY_CONFIG, checkExtensionDirSafety, checkExtensionPathSaf
 import { SlotRegistry, getSlotRegistry, registerSlotType } from "../slots.js";
 import { ExtensionDiagnostics, ExtensionLoaderCacheImpl, getExtensionCache, getExtensionDiagnostics } from "../diagnostics.js";
 import { ExtensionHookRunner, createHookContext, isHookEvent } from "../hooks.js";
-import { registerExtensionCliProgram } from "./channel-helpers.js";
 import { defineChannelPluginEntry } from "./channel-entry.js";
+import { registerExtensionCliProgram } from "./channel-helpers.js";
 import { lazyFunction, lazyModule } from "./lazy.js";
 import { createMockExtensionApi, createTestGateway } from "./testing.js";
 //#region src/extensions/sdk/index.ts

package/dist/src/gateway/agents-admin.js

@@ -1,10 +1,10 @@
 import { normalizeAgentId, validateAgentIdForNewAgent } from "../agent-catalog/id.js";
 import { AgentCatalogRepository, init_repository } from "../agent-catalog/repository.js";
 import { init_agent_scope, listAgentEntries, resolveAgentProfileDir, resolveAgentWorkspaceDir, resolveDefaultAgentId, resolveUserPath } from "../agent/agent-scope.js";
-import { AGENT_PROFILE_MARKDOWN_SYSTEM_FILES, REQUIRED_AGENT_PROFILE_MARKDOWN_FILE_SET } from "../agent/context/workspace.js";
-import { AgentCatalogService } from "../agent-catalog/service.js";
 import { resolveEffectiveAgentProfile } from "../config/agent-profile.js";
+import { AGENT_PROFILE_MARKDOWN_SYSTEM_FILES, REQUIRED_AGENT_PROFILE_MARKDOWN_FILE_SET } from "../agent/context/workspace.js";
 import { isPathUnderWorkspace, resolveWorkspaceSafePath } from "./workspace-editor-path.js";
+import { AgentCatalogService } from "../agent-catalog/service.js";
 import { GATEWAY_BUILTIN_TOOL_IDS } from "./agent-builtin-tools.js";
 import { resolve } from "node:path";
 import { mkdir, readFile, realpath, stat, unlink, writeFile } from "node:fs/promises";

package/dist/src/gateway/hono/app.js

@@ -7,10 +7,10 @@ import { resolveGatewayEffectiveHost } from "../../config/gateway-bind.js";
 import { loadTunnelState } from "../../tunnel/tunnel-state.js";
 import { resolveReverseProxyPublicUrl } from "../public-url.js";
 import { maxSessionInputRequestBodyBytes } from "../chat-limits.js";
+import { BROWSER_EXTENSION_ID } from "../../browser/extension-identity.js";
 import { isLoopbackIpAddress, isTrustedProxyAddress } from "../client-ip.js";
 import { buildGatewayConsoleCspHeader } from "../security/csp.js";
 import { checkBrowserOrigin, isChromeExtensionOrigin } from "../security/origin-check.js";
-import { BROWSER_EXTENSION_ID } from "../../browser/extension-identity.js";
 import { auth } from "./middleware/auth.js";
 import { gatewayScopes } from "./middleware/scopes.js";
 import { createChannelRateLimitMiddleware, createChatRateLimitMiddleware, createMediaRateLimitMiddleware, createStrictRateLimitMiddleware, createTaskRateLimitMiddleware, createXopcCloudPollRateLimitMiddleware } from "./middleware/strict-rate-limit.js";

package/dist/src/gateway/hono/lib/config-payload.js

@@ -1,7 +1,7 @@
+import { ContextPlanningConfigSchema, KnowledgeMemoryConfigSchema, UserModelConfigSchema, init_config } from "../../../user-context/config.js";
 import { normalizeAgentId } from "../../../agent-catalog/id.js";
 import { AgentCatalogRepository, init_repository } from "../../../agent-catalog/repository.js";
 import { init_agent_scope, listAgentEntries, resolveDefaultAgentId } from "../../../agent/agent-scope.js";
-import { ContextPlanningConfigSchema, KnowledgeMemoryConfigSchema, UserModelConfigSchema, init_config } from "../../../user-context/config.js";
 import { resolveModelsJsonPath } from "../../../config/paths.js";
 import { init_models_json, loadModelsJson } from "../../../config/models-json.js";
 import { CredentialResolver, init_credentials } from "../../../auth/credentials.js";

package/dist/src/gateway/hono/routes/agent-plugins.js

@@ -3,9 +3,9 @@ import { PluginSelectionRequired } from "../../../extensions/agent-plugins/sourc
 import { AgentPluginStore } from "../../../extensions/agent-plugins/store.js";
 import { savePluginAuthBinding } from "../../../extensions/agent-plugins/auth.js";
 import { evictAllEmbeddedSessionRunners } from "../../../agent/embedded/session-runner.js";
+import { agentPluginInventoryRow } from "../../../extensions/agent-plugins/inventory.js";
 import { withAgentPluginSource } from "../../../extensions/agent-plugins/sources.js";
 import { getGatewayPrincipal } from "../../security/gateway-principal.js";
-import { agentPluginInventoryRow } from "../../../extensions/agent-plugins/inventory.js";
 import { cancelPluginCliAuthorizations } from "../../../extensions/agent-plugins/cli-authorization.js";
 import { PluginSetupService, setupActionSchema } from "../../../extensions/agent-plugins/setup.js";
 import { removePluginCredentials } from "../../../extensions/agent-plugins/credentials.js";

package/dist/src/gateway/hono/routes/auth-registry-extensions.js

@@ -3,11 +3,11 @@ import { ActivationPlanner } from "../../../extensions/activation-planner.js";
 import { mergeActivationContext } from "../../../extensions/activation-context.js";
 import { validateExtensionConfig } from "../../../extensions/config-validation.js";
 import { fetchRegistry, listExtensions, searchExtensions } from "../../../extensions/marketplace.js";
+import { listAgentPluginInventory } from "../../../extensions/agent-plugins/inventory.js";
 import { createOAuthAsyncHandler } from "../oauth-async.js";
 import { createOAuthHandler } from "../oauth.js";
 import { extensionAssetMimeType } from "../lib/extension-assets.js";
 import { loadExtensionStore, saveExtensionStore } from "../lib/extension-store.js";
-import { listAgentPluginInventory } from "../../../extensions/agent-plugins/inventory.js";
 import { relative, resolve } from "node:path";
 import { existsSync, readFileSync, statSync } from "node:fs";
 //#region src/gateway/hono/routes/auth-registry-extensions.ts

package/dist/src/gateway/hono/routes/browser-install.js

@@ -1,5 +1,5 @@
-import { createGatewayRouteLogger } from "../lib/route-logger.js";
 import { acquireBrowserInstallLock, cancelBrowserInstall } from "../../../browser/install-lock.js";
+import { createGatewayRouteLogger } from "../lib/route-logger.js";
 import { runPlaywrightChromiumInstallWithProgress } from "../../../browser/providers/playwright-install.js";
 import { streamSSE } from "hono/streaming";
 //#region src/gateway/hono/routes/browser-install.ts

package/dist/src/gateway/hono/routes/config-patch/misc.js

@@ -1,10 +1,10 @@
-import { BindingsSchema, init_binding_schema } from "../../../../routing/binding-schema.js";
-import { AgentCatalogService } from "../../../../agent-catalog/service.js";
 import { ContextPlanningConfigSchema, HomeIntelligenceConfigSchema, KnowledgeMemoryConfigSchema, UserContextConfigSchema, UserModelConfigSchema, init_config } from "../../../../user-context/config.js";
+import { BindingsSchema, init_binding_schema } from "../../../../routing/binding-schema.js";
 import { ComputerConfigSchema, init_config as init_config$1 } from "../../../../computer/config.js";
 import { BrowserConfigSchema, McpConfigSchema, VoiceConfigSchema, init_schema } from "../../../../config/schema.js";
 import { CredentialResolver, init_credentials } from "../../../../auth/credentials.js";
 import { canonicalizeConfiguredMcpServer } from "../../../../config/mcp-config-normalize.js";
+import { AgentCatalogService } from "../../../../agent-catalog/service.js";
 import { mergeGatewaySkillsMarketplacePatch, mergeSessionConfigPatch, mergeUpdateConfigPatch } from "../../../../config/web-patch.js";
 import { assertGatewayAuthConfigured, resolveGatewayAuth } from "../../../auth.js";
 import { isMaskedSecretPatchValue } from "../../lib/mask-secret-length.js";

package/dist/src/gateway/hono/routes/connectors.js

@@ -6,9 +6,9 @@ import { getConnectorAccount, init_connector_account_repository, listConnectorAc
 import { decideConnectorApproval, getConnectorApproval, listConnectorApprovals, listConnectorConnections } from "../../../storage/sqlite/connector-repository.js";
 import { getConnectorSyncPolicy, upsertConnectorSyncPolicy } from "../../../storage/sqlite/connector-sync-policy-repository.js";
 import { init_sqlite } from "../../../storage/sqlite/index.js";
+import { listUnderstandingSourceGrants, revokeUnderstandingSourceGrant } from "../../../user-context/sources/repository.js";
 import { AgentCatalogRepository, init_repository } from "../../../agent-catalog/repository.js";
 import { init_agent_scope, resolveDefaultAgentId } from "../../../agent/agent-scope.js";
-import { listUnderstandingSourceGrants, revokeUnderstandingSourceGrant } from "../../../user-context/sources/repository.js";
 import { activateComposioBackend, addComposioBackend, ensureComposioBackend, getComposioBackend, listComposioBackends, removeComposioBackend } from "../../../connectors/composio-backends.js";
 import { getAuthorizationAttempt } from "../../../connectors/authorization-attempts.js";
 import { ComposioSessionsAdapter, resolveComposioApiKey } from "../../../connectors/composio-sessions.js";

package/dist/src/gateway/hono/routes/context-sources.js

@@ -2,9 +2,9 @@ import { getSqliteDatabase, init_transaction } from "../../../storage/sqlite/tra
 import { getConnectorAccount } from "../../../storage/sqlite/connector-account-repository.js";
 import { countKnowledgeSourceItems, deleteKnowledgeSourceItems } from "../../../storage/sqlite/knowledge-repository.js";
 import { init_sqlite } from "../../../storage/sqlite/index.js";
-import { init_agent_scope, resolveDefaultAgentId } from "../../../agent/agent-scope.js";
 import { getActiveUnderstandingConsent } from "../../../user-context/sources/consent-repository.js";
 import { getUnderstandingSourceGrant, listUnderstandingSourceGrants, listUnderstandingSourceRuns, revokeUnderstandingSourceGrant, updateUnderstandingSourceGrantPolicies } from "../../../user-context/sources/repository.js";
+import { init_agent_scope, resolveDefaultAgentId } from "../../../agent/agent-scope.js";
 import { listUserModelObservations } from "../../../user-model/observation-repository.js";
 import "../../../user-model/index.js";
 import { listConnectedContentCandidates, readConnectedContent } from "../../../connectors/content-enrichment.js";

package/dist/src/gateway/hono/routes/notes.js

@@ -1,9 +1,9 @@
 import { NoteDeleteOutputSchema, NoteGetOutputSchema, ProductReadContracts } from "../../../../packages/gateway-contract/src/capabilities.js";
 import { init_src } from "../../../../packages/gateway-contract/src/index.js";
-import { CapabilityError } from "../../../capabilities/runtime/errors.js";
-import "../../../capabilities/runtime/dispatcher.js";
 import { init_session_key, resolveConversationId } from "../../../routing/session-key.js";
 import { agentExists, getDefaultAgentId, init_resolve_route } from "../../../routing/resolve-route.js";
+import { CapabilityError } from "../../../capabilities/runtime/errors.js";
+import "../../../capabilities/runtime/dispatcher.js";
 import { resolveGatewayEffectiveHost } from "../../../config/gateway-bind.js";
 import { getShareStore } from "../../../share/share-store.js";
 import { resolveShareUrl } from "../../../share/share-url.js";

package/dist/src/gateway/hono/routes/projects.js

@@ -7,12 +7,12 @@ import { loadTranscriptRowsForSession } from "../../../storage/sqlite/transcript
 import { init_sqlite } from "../../../storage/sqlite/index.js";
 import { ActivityService } from "../../../activity/service.js";
 import "../../../activity/index.js";
-import { CapabilityError } from "../../../capabilities/runtime/errors.js";
-import "../../../capabilities/runtime/dispatcher.js";
 import { listKnowledgeItems, writeKnowledgeItem } from "../../../knowledge-memory/repository.js";
 import "../../../knowledge-memory/index.js";
 import { resolveEffectiveAgentProfile } from "../../../config/agent-profile.js";
 import { TaskReadModelProjector } from "../../../tasks/task-read-model-projector.js";
+import { CapabilityError } from "../../../capabilities/runtime/errors.js";
+import "../../../capabilities/runtime/dispatcher.js";
 import { ProjectWorkspaceConflictError, ProjectWorkspaceMissingError } from "../../../projects/workspace-project.js";
 import { inferProjectExecutionMode, inferProjectKind } from "../../../projects/project-kind.js";
 import { ProjectDeletionBlockedError, ProjectWorkspaceInUseError } from "../../../projects/project-service.js";

package/dist/src/gateway/hono/routes/session-input-handler.js

@@ -5,9 +5,9 @@ import { endpointContextSchema } from "../../../../packages/gateway-contract/src
 import { parseUserTurnDocument, userTurnDocumentRefIds } from "../../../../packages/gateway-contract/src/user-turn-document.js";
 import { init_src } from "../../../../packages/gateway-contract/src/index.js";
 import { endpointTurnClaimSchema, init_src as init_src$1 } from "../../../../packages/endpoint-tools-protocol/src/index.js";
+import { init_providers, resolveModel } from "../../../providers/index.js";
 import { CapabilityError } from "../../../capabilities/runtime/errors.js";
 import "../../../capabilities/runtime/dispatcher.js";
-import { init_providers, resolveModel } from "../../../providers/index.js";
 import { getModelThinking } from "../../../providers/model-thinking.js";
 import { parseTurnContextRefs } from "../../../agent/source-context/types.js";
 import { validateWebchatAttachments, validateWebchatContent } from "../../chat-limits.js";

package/dist/src/gateway/hono/routes/tasks.js

@@ -6,9 +6,9 @@ import { hasGatewayScope, init_gateway_scopes } from "../../security/gateway-sco
 import { enqueueTaskChangedEvent, init_task_change_events } from "../../../tasks/task-change-events.js";
 import { TaskRepository, init_task_repository } from "../../../tasks/task-repository.js";
 import { TaskRunRepository, init_task_run_repository } from "../../../tasks/task-run-repository.js";
+import { TaskConversationRepository } from "../../../tasks/task-conversation-repository.js";
 import { CapabilityError } from "../../../capabilities/runtime/errors.js";
 import "../../../capabilities/runtime/dispatcher.js";
-import { TaskConversationRepository } from "../../../tasks/task-conversation-repository.js";
 import { TaskCollaborationRepository } from "../../../tasks/task-collaboration-repository.js";
 import { TaskCriterionReviewRepository } from "../../../tasks/task-criterion-review-repository.js";
 import { TaskContextMutationOutputSchema } from "../../../tasks/capabilities/relations.js";

package/dist/src/gateway/image-generation-setup.js

@@ -1,11 +1,11 @@
 import { normalizeAgentId } from "../agent-catalog/id.js";
 import { AgentCatalogRepository, init_repository } from "../agent-catalog/repository.js";
 import { init_agent_scope } from "../agent/agent-scope.js";
-import { AgentCatalogService } from "../agent-catalog/service.js";
 import { resolveEffectiveAgentConfigForAgent } from "../config/agent-profile.js";
 import { ConfigSchema, init_schema } from "../config/schema.js";
 import { fetchWithTimeoutGuarded } from "../media-shared/http/provider-http.js";
 import "../media-shared/http/index.js";
+import { AgentCatalogService } from "../agent-catalog/service.js";
 import { getImageGenerationProvider, listImageGenerationProvidersSummary } from "../agent/image/generation/provider-registry.js";
 //#region src/gateway/image-generation-setup.ts
 init_repository();

package/dist/src/gateway/lock.js

@@ -1,8 +1,8 @@
 import path from "node:path";
 import fs from "node:fs";
 import { createHash } from "node:crypto";
-import fs$1 from "node:fs/promises";
 import net from "node:net";
+import fs$1 from "node:fs/promises";
 import { homedir } from "os";
 //#region src/gateway/lock.ts
 /**

package/dist/src/gateway/service/marketplace-service.js

@@ -10,6 +10,7 @@ import { resolveWorkspaceSkillsDir, resolveWorkspaceSkillsLockPath } from "../..
 import { getExtensionLockfileManager } from "../../extensions/lockfile.js";
 import { AgentPluginStore } from "../../extensions/agent-plugins/store.js";
 import { normalizeSkillInstallTarget } from "../../agent/skills/install-target.js";
+import { pluginSkillPreview, withPluginSkillCatalog } from "../../extensions/agent-plugins/skill-catalog.js";
 import { isAgentPluginArchive, withAgentPluginArchive } from "../../extensions/agent-plugins/sources.js";
 import { existsSync, rmSync } from "node:fs";
 //#region src/gateway/service/marketplace-service.ts
@@ -52,7 +53,7 @@ var GatewayMarketplaceService = class {
 	getSkillsApi() {
 		const snapshot = this.opts.getAgentService().getSkillCatalogSnapshot();
 		return {
-			catalog: snapshot.catalog,
+			catalog: withPluginSkillCatalog(snapshot.catalog),
 			managed: listManagedSkillDirs(),
 			version: snapshot.version,
 			loadedAt: snapshot.loadedAt,
@@ -82,9 +83,10 @@ var GatewayMarketplaceService = class {
 		return this.opts.getAgentService().setSessionWorkspaceTrust(conversationId, trusted);
 	}
 	getSkillMarkdownSource(skillName) {
-		return this.opts.getAgentService().getSkillMarkdownSource(skillName);
+		return this.opts.getAgentService().getSkillMarkdownSource(skillName) ?? pluginSkillPreview(skillName);
 	}
 	deleteSkill(skillId, target) {
+		if (this.getSkillsApi().catalog.find((row) => row.name === skillId)?.origin.startsWith("plugin:")) throw new Error("This skill belongs to a plugin. Manage or uninstall the owning plugin instead.");
 		const requestedTarget = target ? this.resolveInstallTarget(target) : void 0;
 		const workspaceTarget = requestedTarget ?? this.resolveInstallTarget("workspace");
 		try {

package/dist/src/gateway/service.js

@@ -20,13 +20,13 @@ import { getSessionMetadata } from "../storage/sqlite/session-read-repository.js
 import { init_session_repository, listSessionMetadata, patchSessionMetadata } from "../storage/sqlite/session-repository.js";
 import { getSessionConfig, init_config_repository } from "../storage/sqlite/config-repository.js";
 import { init_sqlite } from "../storage/sqlite/index.js";
-import { normalizeAgentId } from "../agent-catalog/id.js";
-import { init_agent_scope, listAgentEntries, resolveAgentWorkspaceDir, resolveDefaultAgentId } from "../agent/agent-scope.js";
 import { listKnowledgeItems } from "../knowledge-memory/repository.js";
 import { init_config, resolveKnowledgeReadPolicy } from "../user-context/config.js";
 import { init_agent_session_key, resolveAgentMainConversationId } from "../routing/agent-session-key.js";
 import { init_session_key, resolveConversationId, sanitizeSegment } from "../routing/session-key.js";
 import "../knowledge-memory/index.js";
+import { normalizeAgentId } from "../agent-catalog/id.js";
+import { init_agent_scope, listAgentEntries, resolveAgentWorkspaceDir, resolveDefaultAgentId } from "../agent/agent-scope.js";
 import { getDefaultAgentId, init_resolve_route } from "../routing/resolve-route.js";
 import { resolveEffectiveAgentProfileForSession } from "../config/agent-profile.js";
 import { getAgentDefaultModelRef, init_schema } from "../config/schema.js";
@@ -81,6 +81,9 @@ import "../infra/bus/index.js";
 import { collectMediaUrisFromMessages, deleteMediaUris } from "../media/session-references.js";
 import { AgentService } from "../agent/service.js";
 import { bootstrapApplicationStateSync } from "../bootstrap/application-state.js";
+import { setPairingBroadcastSink } from "../channels/pairing/pairing-events.js";
+import { registerClarificationChannelRuntime } from "./clarify-runtime.js";
+import { ChannelManager } from "../channels/manager.js";
 import { ChatPreviewService } from "../chat-previews/service.js";
 import "../chat-previews/index.js";
 import { configureGatewayHttpProxy } from "../infra/http-proxy-env.js";
@@ -100,13 +103,8 @@ import { DiscussionSealer } from "../discussions/sealer.js";
 import "../discussions/index.js";
 import { EndpointToolRuntime } from "../endpoint-tools/runtime.js";
 import "../endpoint-tools/index.js";
-import { HomeCapabilityPreflightService } from "../home-intelligence/capability-preflight.js";
-import { HomeAdviceGenerator } from "../home-intelligence/generator.js";
-import { HomeIntelligenceHost } from "../home-intelligence/host.js";
-import { HomeSnapshotBuilder } from "../home-intelligence/snapshot.js";
 import { assertGatewayAuthConfigured, extractToken, resolveGatewayAuth, validateToken } from "./auth.js";
 import { prepareAutomationAgentSession } from "./automation-agent-session.js";
-import { registerClarificationChannelRuntime } from "./clarify-runtime.js";
 import { stopTailscaleExposure } from "./tailscale-lifecycle.js";
 import { getGatewayFileSpaceService } from "./file-space-service.js";
 import { reconcileHomeIntelligenceAutomation } from "./home-intelligence-automation-reconciler.js";
@@ -120,8 +118,6 @@ import { WorkDiscoveryService } from "../work-discovery/service.js";
 import { buildVoiceMemoryContext } from "../voice/realtime/memory-context.js";
 import { buildVoicePersonaContext } from "../voice/realtime/persona-context.js";
 import { voiceMemoryBudget, voicePersonaBudget } from "../voice/realtime/conversation-context.js";
-import { setPairingBroadcastSink } from "../channels/pairing/pairing-events.js";
-import { ChannelManager } from "../channels/manager.js";
 import "../notes/index.js";
 import { buildWorkflowChildTools } from "../agent/workflow/workflow-child-tools.js";
 import { WorkflowRunService } from "../workflows/service/workflow-run-service.js";
@@ -167,6 +163,10 @@ import { TaskMainUpdateDecisionService } from "../tasks/task-main-update-decisio
 import { selectTaskMainUpdateAttempt, submitAndConfirmTaskMainUpdate } from "../tasks/task-main-update-input.js";
 import { checkAppContextAccess, prepareAppContext } from "./service/app-context-access.js";
 import { applyAutomaticVoiceLanguage, inferProductLanguageFromEnvironment, initializeVoiceDefaults } from "../voice/language-profile.js";
+import { HomeAdviceGenerator } from "../home-intelligence/generator.js";
+import { HomeIntelligenceHost } from "../home-intelligence/host.js";
+import { HomeSnapshotBuilder } from "../home-intelligence/snapshot.js";
+import { HomeCapabilityPreflightService } from "../home-intelligence/capability-preflight.js";
 import crypto from "node:crypto";
 //#region src/gateway/service.ts
 init_session_repository();

package/dist/src/gateway/xopc-cloud-capability-setup.js

@@ -1,13 +1,13 @@
 import "../agent-config/schema.js";
 import { init_agent_config } from "../agent-config/index.js";
 import { AgentCatalogRepository, init_repository } from "../agent-catalog/repository.js";
-import { AgentCatalogService } from "../agent-catalog/service.js";
 import { ConfigSchema, init_schema } from "../config/schema.js";
 import { init_model_policy, isComputerModel, isDedicatedComputerProfile } from "../computer/model-policy.js";
 import { voiceSupportsMode } from "../../packages/realtime-protocol/src/voice-catalog.js";
 import { init_voice } from "../../packages/realtime-protocol/src/voice.js";
 import { getModelCatalogStore, init_model_catalog_store } from "../providers/model-catalog-store.js";
 import { compareCatalogModels } from "../providers/model-catalog-ranking.js";
+import { AgentCatalogService } from "../agent-catalog/service.js";
 import { prepareUpdateGlobalDefaults } from "./global-defaults-admin.js";
 //#region src/gateway/xopc-cloud-capability-setup.ts
 init_voice();

package/dist/src/home-intelligence/host.js

@@ -1,10 +1,10 @@
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
+import { HomeAdviceBudgetExceededError, isHomeProseLocalized } from "./generator.js";
 import { homePatternKey } from "./strategy.js";
+import { HomeAdvicePolicy } from "./policy.js";
 import { HomeIntelligenceRepository } from "./repository.js";
 import { HomeOpportunityApplicationService } from "./application-service.js";
-import { HomeAdvicePolicy } from "./policy.js";
-import { HomeAdviceBudgetExceededError, isHomeProseLocalized } from "./generator.js";
 import { buildHomeOpportunityNotification } from "./notification.js";
 import { createHash } from "node:crypto";
 //#region src/home-intelligence/host.ts

package/dist/src/local-apps/service.js

@@ -5,10 +5,10 @@ import { currentOperationId, init_operation_context } from "../infra/operation-c
 import { afterSqliteCommit, init_transaction, runSqliteWriteTransaction } from "../storage/sqlite/transaction.js";
 import { ExtensionCapabilityBindingsSchema, extensionCapabilityPermissions } from "../../packages/gateway-contract/src/extension-capabilities.js";
 import { init_src } from "../../packages/gateway-contract/src/index.js";
-import { CapabilityError } from "../capabilities/runtime/errors.js";
 import { init_paths, resolveExtensionsDir } from "../config/paths.js";
 import { slugifyProjectName } from "../projects/project-store.js";
 import { LocalAppStore } from "./store.js";
+import { CapabilityError } from "../capabilities/runtime/errors.js";
 import { DomainOutboxDispatcher } from "../infra/domain-outbox-dispatcher.js";
 import { validateLocalAppCapabilityContracts } from "./capabilities/contracts.js";
 import { buildLocalAppFixGuidance } from "./fix-guidance.js";

package/dist/src/personal-agent/proactivity/service.js

@@ -5,8 +5,8 @@ import { PersonalProactiveMessageSchema } from "../../../packages/gateway-contra
 import { init_src } from "../../../packages/gateway-contract/src/index.js";
 import { init_session_instance_repository, readCurrentTranscriptId } from "../../storage/sqlite/session-instance-repository.js";
 import { appendTranscriptEntry, init_transcript_repository } from "../../storage/sqlite/transcript-repository.js";
-import { AgentCatalogRepository, init_repository } from "../../agent-catalog/repository.js";
 import { resolveUserContextSessionAccess } from "../../user-context/access-policy.js";
+import { AgentCatalogRepository, init_repository } from "../../agent-catalog/repository.js";
 import { init_providers, resolveModel } from "../../providers/index.js";
 import { completeWithResolvedCredentials } from "../../providers/model-call.js";
 import { extractAssistantText, getAssistantMessageErrorReason, stripCodeFences } from "../../providers/model-response.js";