@xopcai/xopc 0.0.323 → 0.0.325

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

@@ -2,23 +2,23 @@ import { resolveStateDir } from "../config/paths-state.js";
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
 import { isXopcDatabaseOpen } from "../storage/sqlite/connection.js";
-import { consumeClarificationApproval } from "../storage/sqlite/clarification-wait-repository.js";
+import { consumeClarificationApproval, init_clarification_wait_repository } from "../storage/sqlite/clarification-wait-repository.js";
 import { getInteractionState } from "../storage/sqlite/interaction-state-repository.js";
 import { getSessionMetadata } from "../storage/sqlite/session-read-repository.js";
-import "../storage/sqlite/index.js";
+import { init_sqlite } from "../storage/sqlite/index.js";
+import { expandWorkspacePathString, init_workspace_path } from "../config/workspace-path.js";
+import { init_agent_scope, listAgentEntries, resolveAgentProfileDir } from "./agent-scope.js";
+import { init_paths, resolveBundledSkillsDir } from "../config/paths.js";
+import { extractTextContent } from "./context/workspace.js";
 import { getAgentDefaultModelRef, init_schema } from "../config/schema.js";
 import { applyConfigOverrides } from "../config/runtime-overrides.js";
-import { expandWorkspacePathString, init_workspace_path } from "../config/workspace-path.js";
-import { init_agent_scope, resolveAgentProfileDir } from "./agent-scope.js";
 import { getConversationRouting } from "../storage/sqlite/conversation-repository.js";
 import { init_session_key } from "../routing/session-key.js";
 import { resolveEffectiveAgentProfile, resolveEffectiveAgentProfileForSession } from "../config/agent-profile.js";
-import { init_paths, resolveBundledSkillsDir } from "../config/paths.js";
 import { init_sync_provider_auth, resolveProviderApiKeySync } from "../auth/sync-provider-auth.js";
 import { CredentialResolver, init_credentials } from "../auth/credentials.js";
 import { getApiKeySync, getDefaultModelSync, init_providers, resolveModel } from "../providers/index.js";
 import { createExtensionAwareStreamFn } from "../providers/extension-stream-bridge.js";
-import { extractTextContent } from "./context/workspace.js";
 import { buildExecutionScopeContextForPrompt } from "./context/execution-scope.js";
 import { clearBootstrapSnapshot } from "./bootstrap/bootstrap-cache.js";
 import { resolveBootstrapContextSync } from "./bootstrap/bootstrap-files.js";
@@ -68,6 +68,8 @@ init_sync_provider_auth();
 init_providers();
 init_credentials();
 init_paths();
+init_clarification_wait_repository();
+init_sqlite();
 init_session_key();
 const log = createLogger("AgentManager");
 var AgentManager = class {
@@ -173,22 +175,20 @@ var AgentManager = class {
 		return resolveUserContextSessionAccess(this.config.config, conversationId).userModel;
 	}
 	computeBaseWorkspacePath() {
-		const cfg = this.config.config;
-		if (!cfg) return expandWorkspacePathString(this.config.workspace);
-		return resolveEffectiveAgentProfileForSession(cfg, null).resolvedWorkspacePath;
+		if (!this.config.config) return expandWorkspacePathString(this.config.workspace);
+		return resolveEffectiveAgentProfileForSession(null).resolvedWorkspacePath;
 	}
 	/**
 	* Workspace root for inbound attachments / side effects for this session's agent id.
 	* Uses in-memory session workspace overrides when the session has a persisted `workingDirectoryOverride`.
 	*/
 	getResolvedWorkspaceForSession(conversationId) {
-		const cfg = this.config.config;
 		const fromMap = this.sessionWorkspaceOverrides.get(conversationId);
 		if (fromMap !== void 0) return fromMap;
-		return resolveEffectiveAgentProfileForSession(cfg, conversationId).resolvedWorkspacePath;
+		return resolveEffectiveAgentProfileForSession(conversationId).resolvedWorkspacePath;
 	}
 	getWorkspaceRuntimeForSession(conversationId) {
-		const profile = resolveEffectiveAgentProfileForSession(this.config.config, conversationId);
+		const profile = resolveEffectiveAgentProfileForSession(conversationId);
 		const resolvedPath = conversationId ? this.getResolvedWorkspaceForSession(conversationId) : this.baseWorkspacePath;
 		return this.workspaceRuntimes.getOrCreate(resolvedPath, profile.agentId);
 	}
@@ -205,7 +205,7 @@ var AgentManager = class {
 	}
 	pickDefaultModelRef() {
 		const cfg = this.mergedConfig();
-		return getAgentDefaultModelRef(cfg)?.trim() || getDefaultModelSync(cfg);
+		return getAgentDefaultModelRef()?.trim() || getDefaultModelSync(cfg);
 	}
 	resolveModelStringToModel(modelRef) {
 		try {
@@ -220,7 +220,7 @@ var AgentManager = class {
 		}
 	}
 	/**
-	* Keep defaults in sync when config is hot-reloaded or saved from the UI.
+	* Refresh config-backed services and SQLite-backed Agent defaults after a settings change.
 	*
 	* The previous implementation rebuilt the entire `AgentToolsFactory` (80+ lines
 	* of dependency wiring) on every reload. The factory's deps are now built from
@@ -229,9 +229,9 @@ var AgentManager = class {
 	* reconstruction. The browser is still shut down because its cached settings
 	* (headless mode, backend choice) come from the config snapshot at connect time.
 	*/
-	updateAgentDefaults(config) {
+	updateRuntimeConfiguration(config) {
 		this.config.config = config;
-		const ref = getAgentDefaultModelRef(config);
+		const ref = getAgentDefaultModelRef();
 		this.config.model = ref;
 		this.defaultModel = ref || getDefaultModelSync(config);
 		this.baseWorkspacePath = this.computeBaseWorkspacePath();
@@ -252,9 +252,8 @@ var AgentManager = class {
 			hookRunner: this.config.hookRunner,
 			bus: this.config.bus,
 			toolExecutorConfig: { resolveTimeoutMs: (toolName) => {
-				const config = this.mergedConfig();
 				const conversationId = this.config.getCurrentContext?.()?.conversationId;
-				return resolveEffectiveAgentProfileForSession(config, conversationId).config.tools[toolName]?.timeoutMs;
+				return resolveEffectiveAgentProfileForSession(conversationId).config.tools[toolName]?.timeoutMs;
 			} },
 			getConfig: () => this.mergedConfig(),
 			getPrimaryModel: () => this.resolveModelStringToModel(this.pickDefaultModelRef()),
@@ -273,6 +272,7 @@ var AgentManager = class {
 			getChatPreviewService: this.config.getChatPreviewService,
 			dispatchTaskEvents: this.config.dispatchTaskEvents,
 			dispatchTaskRuns: this.config.dispatchTaskRuns,
+			onAgentCatalogMutate: this.config.onAgentCatalogMutate,
 			getWorkflowRunService: this.config.getWorkflowRunService,
 			getSkillIndexingContext: () => {
 				const ctx = this.config.getCurrentContext?.();
@@ -313,11 +313,11 @@ var AgentManager = class {
 		const cfg = this.config.config;
 		if (!cfg || !isMemorySubsystemEnabled(cfg)) return;
 		const resolvedPath = this.getResolvedWorkspaceForSession(conversationId);
-		const profile = resolveEffectiveAgentProfileForSession(cfg, conversationId);
+		const profile = resolveEffectiveAgentProfileForSession(conversationId);
 		const runtime = this.workspaceRuntimes.getOrCreate(resolvedPath, profile.agentId);
 		await runtime.memoryManager.initializeAll(conversationId, {
 			workspace: resolvedPath,
-			agentWorkspace: resolveAgentProfileDir(cfg, profile.agentId),
+			agentWorkspace: resolveAgentProfileDir(profile.agentId),
 			agentId: profile.agentId,
 			sessionId: conversationId
 		});
@@ -436,7 +436,6 @@ var AgentManager = class {
 		}
 	}
 	buildSystemPromptForInstance(instance, registeredToolNames = instance.registeredToolNames, activeCapabilityNames = this.activeCapabilityNames(instance)) {
-		const cfg = this.config.config;
 		const resolvedWorkspacePath = this.getResolvedWorkspaceForSession(instance.conversationId);
 		const rt = this.workspaceRuntimes.getOrCreate(resolvedWorkspacePath, instance.effectiveProfile.agentId);
 		const contextFiles = this.resolveContextFilesForSession(instance.conversationId, instance.effectiveProfile);
@@ -445,7 +444,7 @@ var AgentManager = class {
 		return rt.systemPromptBuilder.build(contextFiles, {
 			externalMemoryInstructions: this.buildExternalMemoryInstructions(instance.conversationId, rt),
 			workspaceOverride: resolvedWorkspacePath,
-			profileMarkdownPathRoot: resolveAgentProfileDir(cfg, instance.effectiveProfile.agentId),
+			profileMarkdownPathRoot: resolveAgentProfileDir(instance.effectiveProfile.agentId),
 			customInstructions: instance.effectiveProfile.customInstructions,
 			skillAllowlist: instance.effectiveProfile.skillsAllowlist,
 			registeredToolNames,
@@ -489,7 +488,7 @@ var AgentManager = class {
 	}
 	resolveContextFilesForSession(conversationId, profile, excludeHeartbeat) {
 		const cfg = this.config.config;
-		const profileDir = resolveAgentProfileDir(cfg, profile.agentId);
+		const profileDir = resolveAgentProfileDir(profile.agentId);
 		const heartbeatEnabled = cfg.gateway?.heartbeat?.includeSystemPromptSection ?? false;
 		const contextInjection = "always";
 		const { contextFiles } = resolveBootstrapContextSync({
@@ -553,17 +552,16 @@ var AgentManager = class {
 		};
 	}
 	buildAgentSkillAvailability(unresolvedProfile, workspaceDir, registeredToolNames) {
-		const cfg = this.config.config;
 		const rt = this.workspaceRuntimes.getOrCreate(workspaceDir, unresolvedProfile.agentId);
 		const profile = this.materializeSkillAllowlist(unresolvedProfile, rt);
-		const entry = Array.isArray(cfg.agents?.list) ? cfg.agents.list.find((a) => a && a.enabled !== false && a.id.toLowerCase() === profile.agentId.toLowerCase()) : void 0;
+		const entry = listAgentEntries().find((agent) => agent.enabled !== false && agent.id.toLowerCase() === profile.agentId.toLowerCase());
 		const skillsConfig = createSkillConfigManager(resolveStateDir()).load();
 		const lock = loadSkillsLock();
 		const workspaceLock = loadSkillsLock(resolveWorkspaceSkillsLockPath(workspaceDir));
 		const allow = profile.skillsAllowlist === void 0 ? void 0 : new Set(profile.skillsAllowlist.map((s) => s.toLowerCase()));
 		const tools = registeredToolNames ?? this.toolsFactory.createAllTools({
 			workspace: workspaceDir,
-			profileMarkdownRoot: resolveAgentProfileDir(cfg, profile.agentId),
+			profileMarkdownRoot: resolveAgentProfileDir(profile.agentId),
 			agentId: profile.agentId,
 			disabledTools: profile.tools.denied,
 			getMemoryManager: () => rt.memoryManager,
@@ -607,11 +605,11 @@ var AgentManager = class {
 		};
 	}
 	getAgentSkillAvailability(agentId) {
-		const profile = resolveEffectiveAgentProfile(this.config.config, agentId);
+		const profile = resolveEffectiveAgentProfile(agentId);
 		return this.buildAgentSkillAvailability(profile, profile.resolvedWorkspacePath);
 	}
 	getSessionSkillAvailability(conversationId) {
-		const profile = resolveEffectiveAgentProfileForSession(this.config.config, conversationId);
+		const profile = resolveEffectiveAgentProfileForSession(conversationId);
 		return this.buildAgentSkillAvailability(profile, this.getResolvedWorkspaceForSession(conversationId), this.agents.get(conversationId)?.registeredToolNames);
 	}
 	getSessionWorkspaceTrust(conversationId) {
@@ -644,7 +642,6 @@ var AgentManager = class {
 	* After ~/.xopc/skills.json changes (enable/disable), refresh `<available_skills>` on active agents.
 	*/
 	refreshSkillsAfterSkillConfigChange() {
-		const cfg = this.config.config;
 		for (const rt of this.workspaceRuntimes.values()) rt.skillManager.refreshPromptFromConfig();
 		for (const instance of this.agents.values()) {
 			const resolvedWorkspacePath = this.getResolvedWorkspaceForSession(instance.conversationId);
@@ -654,7 +651,7 @@ var AgentManager = class {
 			const newPrompt = rt.systemPromptBuilder.build(contextFiles, {
 				externalMemoryInstructions: this.buildExternalMemoryInstructions(instance.conversationId, rt),
 				workspaceOverride: resolvedWorkspacePath,
-				profileMarkdownPathRoot: resolveAgentProfileDir(cfg, instance.effectiveProfile.agentId),
+				profileMarkdownPathRoot: resolveAgentProfileDir(instance.effectiveProfile.agentId),
 				customInstructions: instance.effectiveProfile.customInstructions,
 				skillAllowlist: instance.effectiveProfile.skillsAllowlist,
 				registeredToolNames: instance.registeredToolNames,
@@ -719,7 +716,6 @@ var AgentManager = class {
 		}, 250);
 	}
 	applySkillsAfterDiskChange(reason = "disk") {
-		const cfg = this.config.config;
 		for (const rt of this.workspaceRuntimes.values()) rt.skillManager.reload(reason);
 		for (const instance of this.agents.values()) {
 			const resolvedWorkspacePath = this.getResolvedWorkspaceForSession(instance.conversationId);
@@ -729,7 +725,7 @@ var AgentManager = class {
 			const newPrompt = rt.systemPromptBuilder.rebuild(contextFiles, {
 				externalMemoryInstructions: this.buildExternalMemoryInstructions(instance.conversationId, rt),
 				workspaceOverride: resolvedWorkspacePath,
-				profileMarkdownPathRoot: resolveAgentProfileDir(cfg, instance.effectiveProfile.agentId),
+				profileMarkdownPathRoot: resolveAgentProfileDir(instance.effectiveProfile.agentId),
 				customInstructions: instance.effectiveProfile.customInstructions,
 				skillAllowlist: instance.effectiveProfile.skillsAllowlist,
 				registeredToolNames: instance.registeredToolNames,
@@ -747,7 +743,6 @@ var AgentManager = class {
 	* Get or create an Agent instance for a session
 	*/
 	getOrCreateAgent(conversationId) {
-		const cfg = this.config.config;
 		const targetPath = this.getResolvedWorkspaceForSession(conversationId);
 		const existing = this.agents.get(conversationId);
 		if (existing) if (existing.resolvedWorkspacePath !== targetPath) this.removeAgent(conversationId);
@@ -757,7 +752,7 @@ var AgentManager = class {
 			log.debug({ conversationId }, "Reusing existing agent instance");
 			return existing.agent;
 		}
-		let profile = resolveEffectiveAgentProfileForSession(cfg, conversationId);
+		let profile = resolveEffectiveAgentProfileForSession(conversationId);
 		const resolvedPath = targetPath;
 		const rt = this.workspaceRuntimes.getOrCreate(resolvedPath, profile.agentId);
 		profile = this.materializeSkillAllowlist(profile, rt);
@@ -795,7 +790,7 @@ var AgentManager = class {
 		return agent;
 	}
 	createAgentTurnPolicy(conversationId) {
-		const profile = this.agents.get(conversationId)?.effectiveProfile ?? resolveEffectiveAgentProfileForSession(this.config.config, conversationId);
+		const profile = this.agents.get(conversationId)?.effectiveProfile ?? resolveEffectiveAgentProfileForSession(conversationId);
 		return this.buildAgentTurnPolicy(conversationId, profile);
 	}
 	/**
@@ -856,7 +851,6 @@ var AgentManager = class {
 		if (!trimmed) return;
 		const instance = this.agents.get(conversationId);
 		if (!instance) return;
-		const cfg = this.config.config;
 		const resolvedWorkspacePath = this.getResolvedWorkspaceForSession(conversationId);
 		const rt = this.workspaceRuntimes.getOrCreate(resolvedWorkspacePath, instance.effectiveProfile.agentId);
 		const contextFiles = this.resolveContextFilesForSession(conversationId, instance.effectiveProfile);
@@ -866,7 +860,7 @@ var AgentManager = class {
 		replaceAgentSystemPrompt(instance.agent, rt.systemPromptBuilder.build(contextFiles, {
 			externalMemoryInstructions: this.buildExternalMemoryInstructions(conversationId, rt),
 			workspaceOverride: resolvedWorkspacePath,
-			profileMarkdownPathRoot: resolveAgentProfileDir(cfg, instance.effectiveProfile.agentId),
+			profileMarkdownPathRoot: resolveAgentProfileDir(instance.effectiveProfile.agentId),
 			customInstructions: instance.effectiveProfile.customInstructions,
 			skillAllowlist: instance.effectiveProfile.skillsAllowlist,
 			registeredToolNames: instance.registeredToolNames,
@@ -966,7 +960,7 @@ var AgentManager = class {
 		const contextFiles = this.resolveContextFilesForSession(conversationId, profile);
 		const tools = this.toolsFactory.createAllTools({
 			workspace: resolvedWorkspacePath,
-			profileMarkdownRoot: resolveAgentProfileDir(this.config.config, profile.agentId),
+			profileMarkdownRoot: resolveAgentProfileDir(profile.agentId),
 			agentId: profile.agentId,
 			conversationId,
 			disabledTools: profile.tools.denied,
@@ -984,7 +978,7 @@ var AgentManager = class {
 				systemPrompt: rt.systemPromptBuilder.build(contextFiles, {
 					externalMemoryInstructions: this.buildExternalMemoryInstructions(conversationId, rt),
 					workspaceOverride: resolvedWorkspacePath,
-					profileMarkdownPathRoot: resolveAgentProfileDir(this.config.config, profile.agentId),
+					profileMarkdownPathRoot: resolveAgentProfileDir(profile.agentId),
 					customInstructions: profile.customInstructions,
 					skillAllowlist: profile.skillsAllowlist,
 					registeredToolNames,
@@ -1015,7 +1009,7 @@ var AgentManager = class {
 		};
 	}
 	buildAgentTurnPolicy(conversationId, profile) {
-		const currentProfile = () => resolveEffectiveAgentProfileForSession(this.config.config, conversationId);
+		const currentProfile = () => resolveEffectiveAgentProfileForSession(conversationId);
 		return createAgentTurnPolicy({
 			maxTurns: profile.config.runtime.maxTurns,
 			maxToolFailures: profile.config.runtime.maxToolFailuresPerTurn,
@@ -1156,7 +1150,6 @@ var AgentManager = class {
 		const interactionStateVersion = this.getInteractionStateVersion(instance.conversationId);
 		const userContextAccessVersion = this.getUserContextAccessVersion(instance.conversationId);
 		if (!force && nextProjectContext === instance.activeProjectContext && interactionStateVersion === instance.interactionStateVersion && userContextAccessVersion === instance.userContextAccessVersion) return;
-		const cfg = this.config.config;
 		const resolvedWorkspacePath = this.getResolvedWorkspaceForSession(instance.conversationId);
 		const rt = this.workspaceRuntimes.getOrCreate(resolvedWorkspacePath, instance.effectiveProfile.agentId);
 		const contextFiles = this.resolveContextFilesForSession(instance.conversationId, instance.effectiveProfile);
@@ -1165,7 +1158,7 @@ var AgentManager = class {
 		replaceAgentSystemPrompt(instance.agent, rt.systemPromptBuilder.build(contextFiles, {
 			externalMemoryInstructions: this.buildExternalMemoryInstructions(instance.conversationId, rt),
 			workspaceOverride: resolvedWorkspacePath,
-			profileMarkdownPathRoot: resolveAgentProfileDir(cfg, instance.effectiveProfile.agentId),
+			profileMarkdownPathRoot: resolveAgentProfileDir(instance.effectiveProfile.agentId),
 			customInstructions: instance.effectiveProfile.customInstructions,
 			skillAllowlist: instance.effectiveProfile.skillsAllowlist,
 			registeredToolNames: instance.registeredToolNames,
@@ -1196,7 +1189,6 @@ var AgentManager = class {
 		try {
 			const model = resolveModel(modelId);
 			instance.agent.state.model = model;
-			const cfg = this.config.config;
 			const resolvedWorkspacePath = this.getResolvedWorkspaceForSession(conversationId);
 			const rt = this.workspaceRuntimes.getOrCreate(resolvedWorkspacePath, instance.effectiveProfile.agentId);
 			const contextFiles = this.resolveContextFilesForSession(conversationId, instance.effectiveProfile);
@@ -1205,7 +1197,7 @@ var AgentManager = class {
 			replaceAgentSystemPrompt(instance.agent, rt.systemPromptBuilder.build(contextFiles, {
 				externalMemoryInstructions: this.buildExternalMemoryInstructions(conversationId, rt),
 				workspaceOverride: resolvedWorkspacePath,
-				profileMarkdownPathRoot: resolveAgentProfileDir(cfg, instance.effectiveProfile.agentId),
+				profileMarkdownPathRoot: resolveAgentProfileDir(instance.effectiveProfile.agentId),
 				customInstructions: instance.effectiveProfile.customInstructions,
 				skillAllowlist: instance.effectiveProfile.skillsAllowlist,
 				registeredToolNames: instance.registeredToolNames,

package/dist/src/agent/agent-scope.d.ts

@@ -1,54 +1,25 @@
-/**
- * Agent path and list resolution (config is the single source of truth).
- */
-import type { Config } from '../config/schema.js';
-export declare const DEFAULT_AGENT_ID = "main";
-/** Normalized id segment safe for directory names under `agents/<id>/`. */
-export declare const STRICT_AGENT_ID_RE: RegExp;
-/** Path-safe agent id. */
-export declare function normalizeAgentId(value: string | undefined | null): string;
-/** Derive a folder-safe id, including for display names with no ASCII characters. */
-export declare function deriveAgentIdFromDisplayName(displayName: string): string;
-/**
- * Validate agent id for new agents (folder-safe path segment).
- * When `explicitId` is set, it must already match {@link STRICT_AGENT_ID_RE} (case-insensitive input, stored lowercase).
- * When omitted, id is derived from `displayNameForDerivation`, with a stable hashed fallback
- * for names that contain no ASCII id characters.
- */
-export declare function validateAgentIdForNewAgent(explicitId: string | undefined | null, displayNameForDerivation: string): {
-    ok: true;
-    agentId: string;
-} | {
-    ok: false;
-    error: string;
-};
+/** Agent path and list resolution backed by the SQLite Agent catalog. */
+import type { AgentEntry } from '../agent-config/index.js';
+import { DEFAULT_AGENT_ID, deriveAgentIdFromDisplayName, normalizeAgentId, STRICT_AGENT_ID_RE, validateAgentIdForNewAgent } from '../agent-catalog/id.js';
+export { DEFAULT_AGENT_ID, deriveAgentIdFromDisplayName, normalizeAgentId, STRICT_AGENT_ID_RE, validateAgentIdForNewAgent, };
 /** Expand `~` and resolve to an absolute path. */
 export declare function resolveUserPath(raw: string): string;
-type AgentEntry = NonNullable<NonNullable<Config['agents']>['list']>[number];
-export declare function listAgentEntries(cfg: Config): AgentEntry[];
-export declare function resolveDefaultAgentId(cfg: Config): string;
-/**
- * Markdown workspace root for an agent.
- */
-export declare function resolveAgentWorkspaceDir(cfg: Config, agentId: string): string;
-/**
- * Internal agent state dir: credentials, `agent.json`, pid, inbox (`…/agent/`).
- */
-export declare function resolveAgentDir(cfg: Config, agentId: string): string;
+export declare function listAgentEntries(): AgentEntry[];
+export declare function resolveDefaultAgentId(): string;
+/** Markdown workspace root for an Agent. */
+export declare function resolveAgentWorkspaceDir(agentId: string): string;
+/** Internal Agent state dir: credentials, `agent.json`, pid, inbox (`…/agent/`). */
+export declare function resolveAgentDir(agentId: string): string;
 /** Parent of `sessions/` and `agent/`: `<stateDir>/agents/<id>/`. */
-export declare function resolveAgentHomeDir(cfg: Config, agentId: string): string;
+export declare function resolveAgentHomeDir(agentId: string): string;
 /** Profile Markdown + gateway avatar files: `<stateDir>/agents/<id>/profile/`. */
-export declare function resolveAgentProfileDir(cfg: Config, agentId: string): string;
+export declare function resolveAgentProfileDir(agentId: string): string;
 /** Resolved path for a single profile Markdown basename (e.g. `SOUL.md`). */
-export declare function resolveAgentProfileMarkdownPath(cfg: Config, agentId: string, filename: string): string;
+export declare function resolveAgentProfileMarkdownPath(agentId: string, filename: string): string;
 /** Agent ids whose workspace root contains `workspacePath` (longest match first). */
-export declare function resolveAgentIdsByWorkspacePath(cfg: Config, workspacePath: string): string[];
-/** Best-matching agent id for cwd, or `undefined` when no workspace contains the path. */
-export declare function resolveAgentIdByWorkspacePath(cfg: Config, workspacePath: string): string | undefined;
-/**
- * Find the agent id whose resolved markdown workspace matches `resolvedWorkspacePath`.
- * Falls back to {@link resolveDefaultAgentId} when no list entry matches.
- */
-export declare function resolveAgentIdForWorkspacePath(cfg: Config, resolvedWorkspacePath: string): string;
-export declare function getDefaultWorkspacePath(cfg: Config): string;
-export {};
+export declare function resolveAgentIdsByWorkspacePath(workspacePath: string): string[];
+/** Best-matching Agent id for cwd, or `undefined` when no workspace contains the path. */
+export declare function resolveAgentIdByWorkspacePath(workspacePath: string): string | undefined;
+/** Resolve an Agent from a workspace, falling back to the catalog default. */
+export declare function resolveAgentIdForWorkspacePath(resolvedWorkspacePath: string): string;
+export declare function getDefaultWorkspacePath(): string;