npm - @xopcai/xopc - Versions diffs - 0.0.126 → 0.0.128 - Mend

@xopcai/xopc 0.0.126 → 0.0.128

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 (366) hide show

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

@@ -10,24 +10,25 @@
     <link rel="icon" type="image/png" sizes="16x16" href="/favicon-16x16.pngv=20260623-2" />
     <link rel="apple-touch-icon" sizes="180x180" href="/apple-touch-icon.png?v=20260623-2" />
     <title>xopc</title>
-    <script type="module" crossorigin src="/assets/index-CA2tR2vm.js"></script>
+    <script type="module" crossorigin src="/assets/index-38TSE7ng.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">
     <link rel="modulepreload" crossorigin href="/assets/dist-DokQNVMQ.js">
     <link rel="modulepreload" crossorigin href="/assets/Combination-BzaXOLd9.js">
     <link rel="modulepreload" crossorigin href="/assets/dist-CkobR7mk.js">
-    <link rel="modulepreload" crossorigin href="/assets/cn-BQ_8x0bT.js">
     <link rel="modulepreload" crossorigin href="/assets/vendor-swr-BIWyz7Rc.js">
+    <link rel="modulepreload" crossorigin href="/assets/cn-BQ_8x0bT.js">
     <link rel="modulepreload" crossorigin href="/assets/middleware-Pd0e8Igk.js">
     <link rel="modulepreload" crossorigin href="/assets/locale-store-Ba72bFmP.js">
     <link rel="modulepreload" crossorigin href="/assets/config-reload-event-Bjh2zoKp.js">
-    <link rel="modulepreload" crossorigin href="/assets/messages-C22hxE1N.js">
-    <link rel="modulepreload" crossorigin href="/assets/fetch-5V96dUz3.js">
-    <link rel="modulepreload" crossorigin href="/assets/gateway-startup-retry-DEMad2wt.js">
+    <link rel="modulepreload" crossorigin href="/assets/messages-YzjnURPJ.js">
+    <link rel="modulepreload" crossorigin href="/assets/fetch-BMjlW0g1.js">
+    <link rel="modulepreload" crossorigin href="/assets/gateway-startup-retry-CY5W2Pp4.js">
     <link rel="modulepreload" crossorigin href="/assets/toast-z0toXu32.js">
+    <link rel="modulepreload" crossorigin href="/assets/url-DFGNSBNT.js">
     <link rel="modulepreload" crossorigin href="/assets/theme-store-Bt6vAkSB.js">
-    <link rel="stylesheet" crossorigin href="/assets/index-Ds3u0LOk.css">
+    <link rel="stylesheet" crossorigin href="/assets/index-EKmpPvZj.css">
   </head>
   <body>
     <div id="root"></div>

package/dist/package.js CHANGED Viewed

@@ -1,5 +1,5 @@
 //#region package.json
-var version = "0.0.126";
+var version = "0.0.128";
 //#endregion
 export { version };

package/dist/src/agent/agent-instance-gateway.d.ts CHANGED Viewed

@@ -47,4 +47,9 @@ export interface AgentInstanceGateway {
     /** Fire-and-forget review (memory + skill nudges) once the main turn finishes. */
     scheduleBackgroundReviewAfterUserTurn(sessionKey: string): void;
     expandSkillUserText(text: string): string;
+    prepareSkillTurn(sessionKey: string, text: string): {
+        text: string;
+        activatedCapabilityNames: string[];
+    };
+    withSkillCapabilities<T>(sessionKey: string, capabilityNames: readonly string[], run: () => Promise<T>): Promise<T>;
 }

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

@@ -9,6 +9,8 @@ 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 AgentCapabilityCatalogEntry, type AgentCapabilitySessionState } from './capabilities/index.js';
 import type { GatewayClarifyRequestFn } from './tools/clarify-tool.js';
 import type { ExtensionRegistryImpl as ExtensionRegistry } from '../extensions/index.js';
 import type { MessageBus } from '../infra/bus/index.js';
@@ -91,6 +93,8 @@ export interface AgentManagerConfig {
     onSkillsUpdated?: (payload: {
         reason: 'disk' | 'config';
     }) => void;
+    /** Install a managed skill from an explicit source and refresh runtime state. */
+    installSkillFromSource?: (opts: SkillInstallToolOptions) => Promise<SkillInstallToolResult>;
     /** Dynamic workspace verification context injected into the system prompt when edits are pending. */
     getSelfVerifyPromptContext?: (sessionKey: string, agentId?: string) => string;
     /**
@@ -107,16 +111,25 @@ export interface AgentInstance {
     resolvedWorkspacePath: string;
     /** Tool names registered on this agent (for skill indexing / tool gating). */
     registeredToolNames: string[];
+    /** Capability packs activated by explicit skills or UI entry points in this session. */
+    activeCapabilities: Map<string, AgentCapabilitySessionState>;
     activeProjectContext?: string;
     activeSelfVerifyContext?: string;
     /** Declared env var names from skill_view; exec_command reads values from process.env at spawn time. */
     skillEnvPassthroughKeys: Set<string>;
 }
+export interface PreparedSkillTurn {
+    text: string;
+    activatedCapabilityNames: string[];
+}
 export declare class AgentManager implements AgentInstanceGateway {
     private agents;
     private config;
     private toolsFactory;
     private mergedConfig;
+    private activeCapabilityNames;
+    private buildActiveCapabilityContext;
+    private resolveCapabilityCatalogForInstance;
     /** Default agent workspace (effective profile for `getDefaultAgentId`). */
     private baseWorkspacePath;
     /** Per-session absolute markdown workspace when `SessionAgentConfig.workingDirectoryOverride` is set. */
@@ -194,6 +207,9 @@ export declare class AgentManager implements AgentInstanceGateway {
      * Expand `/skill:name` user text into the full skill block for the current turn (WebChat, channels).
      */
     expandSkillUserText(text: string): string;
+    prepareSkillTurn(sessionKey: string, text: string): PreparedSkillTurn;
+    withSkillCapabilities<T>(sessionKey: string, capabilityNames: readonly string[], run: () => Promise<T>): Promise<T>;
+    private buildSystemPromptForInstance;
     /** Structured SKILL.md preview for the gateway console. */
     getSkillMarkdownSource(skillName: string): SkillMarkdownPreviewPayload | null;
     private isProjectWorkspaceTrusted;
@@ -253,6 +269,7 @@ export declare class AgentManager implements AgentInstanceGateway {
     private resolveApiKeyWithCache;
     private getSelfVerifyPromptContext;
     private composeDynamicProjectContext;
+    getCapabilityCatalogForSession(sessionKey?: string): AgentCapabilityCatalogEntry[];
     private createAgentForProfile;
     private refreshActiveProjectContextIfChanged;
     /**

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

@@ -17,7 +17,10 @@ import { clearBootstrapSnapshot } from "./bootstrap/bootstrap-cache.js";
 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 { isMemorySubsystemEnabled, shouldRegisterCuratedMemoryTool } from "./memory/memory-config.js";
+import { createAgentCapabilitySessionState, resolveAgentCapabilityCatalog } from "./capabilities/registry.js";
+import "./capabilities/index.js";
 import { AgentToolsFactory } from "./tools/factory.js";
 import { parseMcpToolName } from "./mcp/bundle-mcp-policy.js";
 import { disposeAllSessionMcpRuntimes, retireSessionMcpRuntimeForSessionKey } from "./mcp/bundle-mcp-runtime.js";
@@ -58,6 +61,33 @@ var AgentManager = class {
 		const base = this.config.config;
 		return base ? applyConfigOverrides(base) : void 0;
 	}
+	activeCapabilityNames(inst) {
+		return inst ? [...inst.activeCapabilities.keys()] : [];
+	}
+	buildActiveCapabilityContext(instance, capabilityNames, registeredToolNames) {
+		const availableCatalog = this.resolveCapabilityCatalogForInstance(instance, registeredToolNames).filter((definition) => definition.availableTools.length > 0);
+		const definitionsById = new Map(availableCatalog.map((definition) => [definition.id, definition]));
+		const definitions = [...new Set(capabilityNames)].map((name) => definitionsById.get(name)).filter((definition) => Boolean(definition));
+		if (definitions.length === 0) return void 0;
+		return [
+			"# Active Capability Packs",
+			"",
+			"These capability packs are active for the current task. Use their tools only when they directly help satisfy the user request.",
+			"",
+			...definitions.map((definition) => {
+				const tools = definition.availableTools.join(", ");
+				const hint = definition.promptHint?.trim() ? `\n  Guidance: ${definition.promptHint.trim()}` : "";
+				return `- ${definition.id} (${definition.label}): ${definition.description}\n  Tools: ${tools}${hint}`;
+			})
+		].join("\n");
+	}
+	resolveCapabilityCatalogForInstance(instance, registeredToolNames = instance?.registeredToolNames ?? []) {
+		return resolveAgentCapabilityCatalog({
+			registeredToolNames,
+			lazyToolNames: this.toolsFactory.getLazyCapabilityToolNames(),
+			deniedToolNames: instance ? [...instance.effectiveProfile.tools.denied] : []
+		});
+	}
 	/** Default agent workspace (effective profile for `getDefaultAgentId`). */
 	baseWorkspacePath;
 	/** Per-session absolute markdown workspace when `SessionAgentConfig.workingDirectoryOverride` is set. */
@@ -227,7 +257,8 @@ var AgentManager = class {
 				const inst = this.agents.get(ctx.sessionKey);
 				if (!inst) return;
 				for (const n of names) if (isValidSkillEnvVarName(n)) inst.skillEnvPassthroughKeys.add(n.trim());
-			}
+			},
+			installSkillFromSource: this.config.installSkillFromSource
 		};
 	}
 	getMemoryManager() {
@@ -287,6 +318,81 @@ var AgentManager = class {
 			registeredToolNames: inst?.registeredToolNames
 		});
 	}
+	prepareSkillTurn(sessionKey, text) {
+		this.getOrCreateAgent(sessionKey);
+		const inst = this.agents.get(sessionKey);
+		if (!text.includes("/skill:")) return {
+			text,
+			activatedCapabilityNames: this.activeCapabilityNames(inst)
+		};
+		const rt = this.getWorkspaceRuntimeForSession(sessionKey);
+		const options = {
+			skillAllowlist: inst?.effectiveProfile.skillsAllowlist,
+			registeredToolNames: inst?.registeredToolNames
+		};
+		const expanded = text.trimStart().startsWith("/skill:") ? rt.skillManager.expandCommand(text, options) : text;
+		const selectedCapabilities = rt.skillManager.getActivatedCapabilitiesForText(text, options);
+		const turnOnlyCapabilities = [];
+		const now = Date.now();
+		for (const capabilityName of selectedCapabilities) {
+			const state = createAgentCapabilitySessionState(capabilityName, "skill", now);
+			if (!state) continue;
+			if (state.ttl === "turn") {
+				turnOnlyCapabilities.push(state.id);
+				continue;
+			}
+			inst?.activeCapabilities.set(state.id, state);
+		}
+		return {
+			text: expanded,
+			activatedCapabilityNames: [...new Set([...this.activeCapabilityNames(inst), ...turnOnlyCapabilities])]
+		};
+	}
+	async withSkillCapabilities(sessionKey, capabilityNames, run) {
+		const requested = [...new Set(capabilityNames.map((name) => name.trim()).filter(Boolean))];
+		if (requested.length === 0) return run();
+		this.getOrCreateAgent(sessionKey);
+		const inst = this.agents.get(sessionKey);
+		if (!inst) return run();
+		const activatedTools = this.toolsFactory.createCapabilityTools(requested, { disabledTools: inst.effectiveProfile.tools.denied });
+		const existingNames = new Set(inst.registeredToolNames);
+		const newTools = activatedTools.filter((tool) => !existingNames.has(tool.name));
+		const originalTools = inst.agent.state.tools;
+		const originalRegisteredToolNames = inst.registeredToolNames;
+		const originalSystemPrompt = inst.agent.state.systemPrompt;
+		const nextRegisteredToolNames = [...originalRegisteredToolNames, ...newTools.map((tool) => tool.name)];
+		inst.agent.state.tools = newTools.length > 0 ? [...originalTools, ...newTools] : originalTools;
+		inst.registeredToolNames = nextRegisteredToolNames;
+		inst.agent.state.systemPrompt = this.buildSystemPromptForInstance(inst, nextRegisteredToolNames, requested);
+		try {
+			return await run();
+		} finally {
+			inst.agent.state.tools = originalTools;
+			inst.registeredToolNames = originalRegisteredToolNames;
+			inst.agent.state.systemPrompt = originalSystemPrompt;
+		}
+	}
+	buildSystemPromptForInstance(instance, registeredToolNames = instance.registeredToolNames, activeCapabilityNames = this.activeCapabilityNames(instance)) {
+		const cfg = this.config.config;
+		const resolvedWorkspacePath = this.getResolvedWorkspaceForSession(instance.sessionKey);
+		const rt = this.workspaceRuntimes.getOrCreate(resolvedWorkspacePath);
+		const contextFiles = this.resolveContextFilesForSession(instance.sessionKey, instance.effectiveProfile);
+		const modelRef = instance.effectiveProfile.primaryModelRef?.trim() || this.defaultModel;
+		const thinkingLevel = instance.agent.state.thinkingLevel ?? instance.effectiveProfile.thinkingDefault ?? this.config.thinkingLevel ?? "medium";
+		return rt.systemPromptBuilder.build(contextFiles, {
+			externalMemoryInstructions: rt.memoryManager.buildExternalSystemPrompt(),
+			workspaceOverride: resolvedWorkspacePath,
+			profileMarkdownPathRoot: resolveAgentProfileDir(cfg, instance.effectiveProfile.agentId),
+			systemPromptOverride: instance.effectiveProfile.systemPromptOverride,
+			skillAllowlist: instance.effectiveProfile.skillsAllowlist,
+			registeredToolNames,
+			sessionKey: instance.sessionKey,
+			modelRef,
+			agentId: instance.effectiveProfile.agentId,
+			thinkingLevel,
+			activeProjectContext: this.composeDynamicProjectContext(instance.activeProjectContext, instance.activeSelfVerifyContext, this.buildActiveCapabilityContext(instance, activeCapabilityNames, registeredToolNames))
+		});
+	}
 	/** Structured SKILL.md preview for the gateway console. */
 	getSkillMarkdownSource(skillName) {
 		const skill = this.getCurrentWorkspaceRuntime().skillManager.findSkill(skillName);
@@ -339,13 +445,15 @@ var AgentManager = class {
 		}
 		return contextFiles;
 	}
-	skillCatalogEntryFromSkill(s, skillsConfig = createSkillConfigManager(resolveStateDir()).load(), lock = loadSkillsLock()) {
+	skillCatalogEntryFromSkill(s, skillsConfig = createSkillConfigManager(resolveStateDir()).load(), lock = loadSkillsLock(), workspaceLock, workspaceDir) {
 		const base = resolve(s.baseDir);
-		const managed = isUnderManagedSkillsDir(s.baseDir);
+		const workspaceRoot = workspaceDir ? resolveWorkspaceSkillsDir(workspaceDir) : "";
+		const workspaceManaged = workspaceRoot ? s.source === "workspace" && base.startsWith(resolve(workspaceRoot) + sep) : false;
+		const managed = isUnderManagedSkillsDir(s.baseDir) || workspaceManaged;
 		const directoryId = base.split(sep).filter(Boolean).pop() || s.name;
 		const enabled = !(skillsConfig.entries?.[s.name]?.enabled === false);
 		const hubKey = managed ? basename(base) : "";
-		const hub = managed && hubKey ? lock.entries[hubKey] : void 0;
+		const hub = managed && hubKey ? (workspaceManaged ? workspaceLock : lock)?.entries[hubKey] : void 0;
 		return {
 			directoryId,
 			name: s.name,
@@ -365,9 +473,12 @@ var AgentManager = class {
 	getSkillCatalogSnapshot() {
 		const skillsConfig = createSkillConfigManager(resolveStateDir()).load();
 		const lock = loadSkillsLock();
+		const sessionKey = this.config.getCurrentContext?.()?.sessionKey;
+		const workspaceDir = sessionKey ? this.getResolvedWorkspaceForSession(sessionKey) : this.baseWorkspacePath;
+		const workspaceLock = loadSkillsLock(resolveWorkspaceSkillsLockPath(workspaceDir));
 		const rt = this.getCurrentWorkspaceRuntime();
 		return {
-			catalog: rt.skillManager.getSkills().map((s) => this.skillCatalogEntryFromSkill(s, skillsConfig, lock)),
+			catalog: rt.skillManager.getSkills().map((s) => this.skillCatalogEntryFromSkill(s, skillsConfig, lock, workspaceLock, workspaceDir)),
 			version: rt.skillManager.getVersion(),
 			loadedAt: rt.skillManager.getLoadedAt(),
 			diagnostics: rt.skillManager.getDiagnostics(),
@@ -381,6 +492,7 @@ var AgentManager = class {
 		const rt = this.workspaceRuntimes.getOrCreate(profile.resolvedWorkspacePath);
 		const skillsConfig = createSkillConfigManager(resolveStateDir()).load();
 		const lock = loadSkillsLock();
+		const workspaceLock = loadSkillsLock(resolveWorkspaceSkillsLockPath(profile.resolvedWorkspacePath));
 		const allow = profile.skillsAllowlist === void 0 ? void 0 : new Set(profile.skillsAllowlist.map((s) => s.toLowerCase()));
 		const skills = rt.skillManager.getSkills().map((s) => {
 			let unavailableReason = null;
@@ -389,7 +501,7 @@ var AgentManager = class {
 			else if (!isSkillEnabled(s, skillsConfig)) unavailableReason = "requirements-unmet";
 			else if (allow !== void 0 && !allow.has(s.name.toLowerCase())) unavailableReason = "agent-denied";
 			return {
-				...this.skillCatalogEntryFromSkill(s, skillsConfig, lock),
+				...this.skillCatalogEntryFromSkill(s, skillsConfig, lock, workspaceLock, profile.resolvedWorkspacePath),
 				availableForCurrentAgent: unavailableReason === null,
 				unavailableReason
 			};
@@ -544,6 +656,7 @@ var AgentManager = class {
 			effectiveProfile: profile,
 			resolvedWorkspacePath: resolvedPath,
 			registeredToolNames,
+			activeCapabilities: /* @__PURE__ */ new Map(),
 			activeProjectContext,
 			activeSelfVerifyContext,
 			skillEnvPassthroughKeys: /* @__PURE__ */ new Set()
@@ -701,8 +814,12 @@ var AgentManager = class {
 	getSelfVerifyPromptContext(sessionKey, agentId) {
 		return this.config.getSelfVerifyPromptContext?.(sessionKey, agentId).trim() ?? "";
 	}
-	composeDynamicProjectContext(activeProjectContext, selfVerifyContext) {
-		return [activeProjectContext?.trim(), selfVerifyContext?.trim()].filter((section) => Boolean(section)).join("\n\n") || void 0;
+	composeDynamicProjectContext(...sections) {
+		return sections.map((section) => section?.trim()).filter((section) => Boolean(section)).join("\n\n") || void 0;
+	}
+	getCapabilityCatalogForSession(sessionKey) {
+		const inst = sessionKey?.trim() ? this.agents.get(sessionKey.trim()) : void 0;
+		return this.resolveCapabilityCatalogForInstance(inst);
 	}
 	createAgentForProfile(sessionKey, profile, resolvedWorkspacePath, rt, activeProjectContext, activeSelfVerifyContext) {
 		const modelRef = profile.primaryModelRef?.trim() || this.defaultModel;