@xopcai/xopc 0.0.230 → 0.0.232

package/dist/src/agent-runtime/workflow-runtime.js

@@ -1,32 +0,0 @@
-//#region src/agent-runtime/workflow-runtime.ts
-function resolveWorkflow(params) {
-	const catalog = new Map([...params.catalog].map((workflow) => [workflow.id, workflow]));
-	const intent = params.intent?.trim().toLowerCase();
-	const suggested = intent ? params.manifest.workflows.suggested?.find((entry) => entry.intent.toLowerCase() === intent) : void 0;
-	const id = suggested?.workflow ?? params.manifest.workflows.default;
-	if (!id) return { reason: "no workflow configured" };
-	if (params.manifest.workflows.allowed && !params.manifest.workflows.allowed.includes(id)) return { reason: `workflow "${id}" is not allowed by manifest` };
-	const workflow = catalog.get(id);
-	if (!workflow) return { reason: `workflow "${id}" is not in the workflow catalog` };
-	return {
-		workflow,
-		reason: suggested ? `matched intent "${suggested.intent}"` : "using default workflow"
-	};
-}
-function validateWorkflowForRuntime(params) {
-	const issues = [];
-	const availableTools = new Set(params.tools.tools.map((entry) => entry.name));
-	for (const [phaseIndex, phase] of params.workflow.phases.entries()) {
-		if (phase.modelRole && !params.manifest.models.roles[phase.modelRole]) issues.push({
-			path: `phases.${phaseIndex}.modelRole`,
-			message: `model role "${phase.modelRole}" is not configured`
-		});
-		for (const toolName of phase.requiredTools ?? []) if (!availableTools.has(toolName)) issues.push({
-			path: `phases.${phaseIndex}.requiredTools`,
-			message: `required tool "${toolName}" is not available at runtime`
-		});
-	}
-	return issues;
-}
-//#endregion
-export { resolveWorkflow, validateWorkflowForRuntime };

package/dist/src/config/agent-typed-models.d.ts

@@ -1,13 +0,0 @@
-/**
- * Named model roles from the selected agent manifest.
- */
-import type { AgentTypedModel, Config } from './schema.js';
-export type { AgentTypedModel };
-export declare function resolveEffectiveTypedModels(config: Config, agentId: string): Map<string, AgentTypedModel>;
-/** Resolve a typed model id to `provider/model`, or undefined when not configured. */
-export declare function resolveTypedModelRef(config: Config, agentId: string, typeId: string): string | undefined;
-/**
- * Resolve a model reference: `provider/model`, typed id (`small`), or `@small`.
- * Throws when the ref is invalid or the typed id is unknown.
- */
-export declare function resolveModelRef(config: Config, agentId: string, ref: string): string;

package/dist/src/config/agent-typed-models.js

@@ -1,48 +0,0 @@
-import { init_schema, parseModelRef } from "./schema.js";
-import { resolveEffectiveAgentManifestForAgent } from "./agent-profile.js";
-//#region src/config/agent-typed-models.ts
-init_schema();
-function rolesToEntries(roles) {
-	return Object.entries(roles ?? {}).map(([id, role]) => ({
-		id,
-		...role
-	}));
-}
-function resolveEffectiveTypedModels(config, agentId) {
-	const out = /* @__PURE__ */ new Map();
-	const manifest = resolveEffectiveAgentManifestForAgent(config, agentId);
-	for (const modelRole of rolesToEntries(manifest.models.roles)) out.set(modelRole.id, modelRole);
-	return out;
-}
-/** Resolve a typed model id to `provider/model`, or undefined when not configured. */
-function resolveTypedModelRef(config, agentId, typeId) {
-	return resolveEffectiveTypedModels(config, agentId).get(typeId)?.model?.trim() || void 0;
-}
-function parseModelRefInput(ref) {
-	const trimmed = ref.trim();
-	if (!trimmed) return {};
-	if (trimmed.includes("/")) return { directRef: trimmed };
-	const typeId = trimmed.startsWith("@") ? trimmed.slice(1).trim() : trimmed;
-	return typeId ? { typeId } : {};
-}
-/**
-* Resolve a model reference: `provider/model`, typed id (`small`), or `@small`.
-* Throws when the ref is invalid or the typed id is unknown.
-*/
-function resolveModelRef(config, agentId, ref) {
-	const { directRef, typeId } = parseModelRefInput(ref);
-	if (directRef) {
-		if (!parseModelRef(directRef)) throw new Error(`model ref must be provider/model format (got '${directRef}')`);
-		return directRef;
-	}
-	if (typeId) {
-		const resolved = resolveTypedModelRef(config, agentId, typeId);
-		if (resolved) return resolved;
-		const available = [...resolveEffectiveTypedModels(config, agentId).keys()];
-		const hint = available.length > 0 ? ` (available: ${available.join(", ")})` : " (none configured)";
-		throw new Error(`Unknown typed model id '${typeId}' for agent '${agentId}'${hint}`);
-	}
-	throw new Error("model ref must not be empty");
-}
-//#endregion
-export { resolveEffectiveTypedModels, resolveModelRef, resolveTypedModelRef };

package/dist/src/gateway/capability-presets-admin.d.ts

@@ -1,88 +0,0 @@
-import { type CapabilityPreset } from '../agent-manifest/schema.js';
-import { resolveCapabilityPresetLayer } from '../agent-manifest/resolver.js';
-import type { Config } from '../config/schema.js';
-export type CapabilityPresetAdminResult<T> = {
-    ok: true;
-    data: T;
-} | {
-    ok: false;
-    error: string;
-    status?: 400 | 404 | 409 | 500;
-};
-export type CapabilityPresetAgentUsage = {
-    agentId: string;
-    agentName?: string;
-    direct: boolean;
-};
-export type CapabilityPresetRow = CapabilityPreset & {
-    usage: CapabilityPresetAgentUsage[];
-    inherited: ReturnType<typeof resolveCapabilityPresetLayer>['patch'];
-    inheritedSources: Record<string, string>;
-};
-export type CapabilityPresetsListResponse = {
-    defaultPresetId: string;
-    presets: CapabilityPresetRow[];
-    agents: Array<{
-        id: string;
-        name?: string;
-        extends: string[];
-    }>;
-    builtinToolIds: string[];
-    mcpServerIds: string[];
-    workflows: Array<{
-        id: string;
-        title: string;
-        description: string;
-    }>;
-};
-export type CapabilityPresetPreviewDiff = {
-    path: string;
-    before?: unknown;
-    after?: unknown;
-};
-export type CapabilityPresetPreviewAgent = {
-    agentId: string;
-    agentName?: string;
-    diffs: CapabilityPresetPreviewDiff[];
-};
-export type CreateCapabilityPresetBody = {
-    id?: string;
-    name?: string;
-    description?: string;
-    version?: number;
-    extends?: CapabilityPreset['extends'];
-    models?: CapabilityPreset['models'];
-    tools?: CapabilityPreset['tools'];
-    skills?: CapabilityPreset['skills'];
-    workflows?: CapabilityPreset['workflows'];
-    boundaries?: CapabilityPreset['boundaries'];
-    runtime?: CapabilityPreset['runtime'];
-    locks?: CapabilityPreset['locks'];
-};
-export type UpdateCapabilityPresetBody = {
-    name?: string;
-    description?: string | null;
-    version?: number;
-    extends?: string[] | null;
-    models?: CapabilityPreset['models'] | null;
-    tools?: CapabilityPreset['tools'] | null;
-    skills?: CapabilityPreset['skills'] | null;
-    workflows?: CapabilityPreset['workflows'] | null;
-    boundaries?: CapabilityPreset['boundaries'] | null;
-    runtime?: CapabilityPreset['runtime'] | null;
-    locks?: string[] | null;
-};
-export declare function listCapabilityPresets(cfg: Config): CapabilityPresetsListResponse;
-export declare function prepareCreateCapabilityPreset(cfg: Config, body: CreateCapabilityPresetBody): CapabilityPresetAdminResult<{
-    nextConfig: Config;
-    presetId: string;
-}>;
-export declare function prepareUpdateCapabilityPreset(cfg: Config, presetIdRaw: string, body: UpdateCapabilityPresetBody): CapabilityPresetAdminResult<{
-    nextConfig: Config;
-}>;
-export declare function previewCapabilityPresetUpdate(cfg: Config, presetIdRaw: string, body: UpdateCapabilityPresetBody): CapabilityPresetAdminResult<{
-    agents: CapabilityPresetPreviewAgent[];
-}>;
-export declare function prepareDeleteCapabilityPreset(cfg: Config, presetIdRaw: string): CapabilityPresetAdminResult<{
-    nextConfig: Config;
-}>;

package/dist/src/gateway/capability-presets-admin.js

@@ -1,303 +0,0 @@
-import { CapabilityPresetSchema, init_schema } from "../agent-manifest/schema.js";
-import { init_preset_chain, linearizePresetIds } from "../agent-manifest/preset-chain.js";
-import { resolveCapabilityPresetLayer, resolveEffectiveAgentManifest } from "../agent-manifest/resolver.js";
-import { normalizeConfiguredMcpServers } from "../config/mcp-config-normalize.js";
-import { GATEWAY_BUILTIN_TOOL_IDS } from "./agent-builtin-tools.js";
-import { createWorkflowCatalog } from "../agent/workflow/catalog.js";
-//#region src/gateway/capability-presets-admin.ts
-init_schema();
-init_preset_chain();
-function presetMap(cfg) {
-	return cfg.agents.capabilityPresets ?? {};
-}
-function normalizePresetId(id) {
-	return id.trim().toLowerCase();
-}
-function flattenPolicy(value, path = "", out = /* @__PURE__ */ new Map()) {
-	if (Array.isArray(value) || value === null || typeof value !== "object") {
-		if (path) out.set(path, value);
-		return out;
-	}
-	for (const [key, child] of Object.entries(value)) flattenPolicy(child, path ? `${path}.${key}` : key, out);
-	return out;
-}
-function manifestDiff(before, after) {
-	const beforeFlat = flattenPolicy(before);
-	const afterFlat = flattenPolicy(after);
-	return [...new Set([...beforeFlat.keys(), ...afterFlat.keys()])].filter((path) => JSON.stringify(beforeFlat.get(path)) !== JSON.stringify(afterFlat.get(path))).sort((a, b) => a.localeCompare(b)).map((path) => ({
-		path,
-		...beforeFlat.has(path) ? { before: beforeFlat.get(path) } : {},
-		...afterFlat.has(path) ? { after: afterFlat.get(path) } : {}
-	}));
-}
-function agentUsage(cfg, presetId) {
-	const defaultPresetId = cfg.agents.defaultPreset || "default";
-	return cfg.agents.list.filter((agent) => {
-		return linearizePresetIds([...cfg.agents.capabilityPresets[defaultPresetId] ? [defaultPresetId] : [], ...(agent.extends ?? []).filter((id) => id !== defaultPresetId)], cfg.agents.capabilityPresets).includes(presetId);
-	}).map((agent) => ({
-		agentId: agent.id,
-		...agent.identity.name ? { agentName: agent.identity.name } : {},
-		direct: presetId === defaultPresetId || (agent.extends ?? []).includes(presetId)
-	})).sort((a, b) => a.agentId.localeCompare(b.agentId));
-}
-function validatePresetReferences(presets) {
-	for (const [id, preset] of Object.entries(presets)) for (const parent of preset.extends ?? []) if (!presets[parent]) return {
-		ok: false,
-		error: `capability preset "${id}" extends missing preset "${parent}"`,
-		status: 400
-	};
-	const visiting = /* @__PURE__ */ new Set();
-	const visited = /* @__PURE__ */ new Set();
-	const visit = (id, stack) => {
-		if (visiting.has(id)) return {
-			ok: false,
-			error: `capability preset cycle detected: ${[...stack, id].join(" -> ")}`,
-			status: 400
-		};
-		if (visited.has(id)) return {
-			ok: true,
-			data: void 0
-		};
-		visiting.add(id);
-		for (const parent of presets[id]?.extends ?? []) {
-			const res = visit(parent, [...stack, id]);
-			if (!res.ok) return res;
-		}
-		visiting.delete(id);
-		visited.add(id);
-		return {
-			ok: true,
-			data: void 0
-		};
-	};
-	for (const id of Object.keys(presets)) {
-		const res = visit(id, []);
-		if (!res.ok) return res;
-	}
-	return {
-		ok: true,
-		data: void 0
-	};
-}
-function validateAgentPresetReferences(cfg) {
-	const presets = presetMap(cfg);
-	for (const agent of cfg.agents.list) for (const presetId of agent.extends ?? []) if (!presets[presetId]) return {
-		ok: false,
-		error: `agent "${agent.id}" extends missing preset "${presetId}"`,
-		status: 400
-	};
-	return {
-		ok: true,
-		data: void 0
-	};
-}
-function nextConfigWithPresets(cfg, presets) {
-	const refs = validatePresetReferences(presets);
-	if (refs.ok === false) return {
-		ok: false,
-		error: refs.error,
-		status: refs.status
-	};
-	const nextConfig = {
-		...cfg,
-		agents: {
-			...cfg.agents,
-			capabilityPresets: presets
-		}
-	};
-	const agentRefs = validateAgentPresetReferences(nextConfig);
-	if (agentRefs.ok === false) return {
-		ok: false,
-		error: agentRefs.error,
-		status: agentRefs.status
-	};
-	for (const agent of nextConfig.agents.list) try {
-		resolveEffectiveAgentManifest({
-			agent,
-			presets,
-			defaultPresetId: nextConfig.agents.defaultPreset
-		});
-	} catch (error) {
-		const message = error instanceof Error ? error.message : String(error);
-		return {
-			ok: false,
-			error: `agent "${agent.id}" effective manifest is invalid: ${message}`,
-			status: 400
-		};
-	}
-	return {
-		ok: true,
-		data: { nextConfig }
-	};
-}
-function listCapabilityPresets(cfg) {
-	const presets = Object.values(presetMap(cfg)).map((preset) => {
-		const inherited = resolveCapabilityPresetLayer({
-			presetIds: preset.extends,
-			presets: cfg.agents.capabilityPresets,
-			defaultPresetId: preset.id === cfg.agents.defaultPreset ? "__none__" : cfg.agents.defaultPreset
-		});
-		return {
-			...preset,
-			usage: agentUsage(cfg, preset.id),
-			inherited: inherited.patch,
-			inheritedSources: inherited.sources
-		};
-	}).sort((a, b) => a.id.localeCompare(b.id));
-	const agents = cfg.agents.list.map((agent) => ({
-		id: agent.id,
-		...agent.identity.name ? { name: agent.identity.name } : {},
-		extends: [...agent.extends ?? []]
-	})).sort((a, b) => a.id.localeCompare(b.id));
-	const workflows = createWorkflowCatalog().list().map((entry) => ({
-		id: entry.name,
-		title: entry.title,
-		description: entry.description
-	}));
-	return {
-		defaultPresetId: cfg.agents.defaultPreset,
-		presets,
-		agents,
-		builtinToolIds: [...GATEWAY_BUILTIN_TOOL_IDS],
-		mcpServerIds: Object.keys(normalizeConfiguredMcpServers(cfg.mcp?.servers)).sort(),
-		workflows
-	};
-}
-function prepareCreateCapabilityPreset(cfg, body) {
-	const id = normalizePresetId(body.id ?? "");
-	const name = body.name?.trim() || id;
-	const description = body.description?.trim();
-	const { id: _id, name: _name, description: _description, ...policy } = body;
-	const parsed = CapabilityPresetSchema.safeParse({
-		...policy,
-		id,
-		name,
-		version: body.version ?? 1,
-		...description ? { description } : {}
-	});
-	if (!parsed.success) return {
-		ok: false,
-		error: parsed.error.issues[0]?.message ?? "capability preset is invalid",
-		status: 400
-	};
-	const presets = presetMap(cfg);
-	if (presets[id]) return {
-		ok: false,
-		error: `capability preset "${id}" already exists`,
-		status: 409
-	};
-	const next = nextConfigWithPresets(cfg, {
-		...presets,
-		[id]: parsed.data
-	});
-	if (next.ok === false) return {
-		ok: false,
-		error: next.error,
-		status: next.status
-	};
-	return {
-		ok: true,
-		data: {
-			...next.data,
-			presetId: id
-		}
-	};
-}
-function prepareUpdateCapabilityPreset(cfg, presetIdRaw, body) {
-	const presetId = normalizePresetId(presetIdRaw);
-	const presets = presetMap(cfg);
-	const current = presets[presetId];
-	if (!current) return {
-		ok: false,
-		error: `capability preset "${presetId}" not found`,
-		status: 404
-	};
-	const nextPreset = { ...current };
-	if (body.name !== void 0) {
-		const name = body.name.trim();
-		if (!name) return {
-			ok: false,
-			error: "name must be a non-empty string",
-			status: 400
-		};
-		nextPreset.name = name;
-	}
-	if (body.description !== void 0) if (body.description === null || !body.description.trim()) delete nextPreset.description;
-	else nextPreset.description = body.description.trim();
-	nextPreset.version = body.version ?? current.version + 1;
-	for (const key of [
-		"extends",
-		"models",
-		"tools",
-		"skills",
-		"workflows",
-		"boundaries",
-		"runtime",
-		"locks"
-	]) {
-		if (body[key] === void 0) continue;
-		if (body[key] === null) delete nextPreset[key];
-		else nextPreset[key] = body[key];
-	}
-	const parsed = CapabilityPresetSchema.safeParse(nextPreset);
-	if (!parsed.success) return {
-		ok: false,
-		error: parsed.error.issues[0]?.message ?? "capability preset is invalid",
-		status: 400
-	};
-	return nextConfigWithPresets(cfg, {
-		...presets,
-		[presetId]: parsed.data
-	});
-}
-function previewCapabilityPresetUpdate(cfg, presetIdRaw, body) {
-	const prepared = prepareUpdateCapabilityPreset(cfg, presetIdRaw, body);
-	if (prepared.ok === false) return prepared;
-	return {
-		ok: true,
-		data: { agents: cfg.agents.list.flatMap((agent) => {
-			const before = resolveEffectiveAgentManifest({
-				agent,
-				presets: cfg.agents.capabilityPresets,
-				defaultPresetId: cfg.agents.defaultPreset
-			}).manifest;
-			const after = resolveEffectiveAgentManifest({
-				agent,
-				presets: prepared.data.nextConfig.agents.capabilityPresets,
-				defaultPresetId: prepared.data.nextConfig.agents.defaultPreset
-			}).manifest;
-			const diffs = manifestDiff(before, after);
-			if (diffs.length === 0) return [];
-			return [{
-				agentId: agent.id,
-				...agent.identity.name ? { agentName: agent.identity.name } : {},
-				diffs
-			}];
-		}) }
-	};
-}
-function prepareDeleteCapabilityPreset(cfg, presetIdRaw) {
-	const presetId = normalizePresetId(presetIdRaw);
-	const presets = presetMap(cfg);
-	if (!presets[presetId]) return {
-		ok: false,
-		error: `capability preset "${presetId}" not found`,
-		status: 404
-	};
-	if (presetId === cfg.agents.defaultPreset) return {
-		ok: false,
-		error: `capability preset "${presetId}" is the global default and cannot be deleted`,
-		status: 409
-	};
-	const usage = agentUsage(cfg, presetId);
-	if (usage.length > 0) return {
-		ok: false,
-		error: `capability preset "${presetId}" is used by agents: ${usage.map((u) => u.agentId).join(", ")}`,
-		status: 409
-	};
-	const nextPresets = { ...presets };
-	delete nextPresets[presetId];
-	return nextConfigWithPresets(cfg, nextPresets);
-}
-//#endregion
-export { listCapabilityPresets, prepareCreateCapabilityPreset, prepareDeleteCapabilityPreset, prepareUpdateCapabilityPreset, previewCapabilityPresetUpdate };

package/dist/src/gateway/file-path-classifier.d.ts

@@ -1,30 +0,0 @@
-import type { Config } from '../config/schema.js';
-import type { FileReferenceLocationKind, FileReferenceScope } from './file-reference-registry.js';
-export type { FileReferenceLocationKind };
-export interface FilePathClassifierContext {
-    workspaceRoot: string;
-    profileMarkdownRoot?: string;
-    stateDir: string;
-    skillsDir: string;
-    configFilePath: string;
-    agentsHomeDir: string;
-    agentId: string;
-}
-export declare function buildFilePathClassifierContext(cfg: Config, sessionKeyRaw?: string): FilePathClassifierContext;
-export declare function looksLikeHostAbsolutePath(pathRaw: string): boolean;
-export declare function fileRefSessionKeysMatch(registered?: string, query?: string): boolean;
-export interface ClassifiedFileLocation {
-    scope: FileReferenceScope;
-    locationKind?: FileReferenceLocationKind;
-    manageRoute?: string;
-}
-export declare function classifyFileLocation(absPath: string, ctx: FilePathClassifierContext): ClassifiedFileLocation;
-export interface ResolveFileReferenceCandidateResult {
-    candidate: string | null;
-    invalid: boolean;
-}
-/**
- * Resolve user path to an absolute candidate (workspace, absolute host, or profile fallback).
- */
-export declare function resolveFileReferenceCandidate(rawPath: string, workspaceRoot: string, ctx: FilePathClassifierContext): Promise<ResolveFileReferenceCandidateResult>;
-export declare function displayNameForPath(rawPath: string): string;

package/dist/src/gateway/file-path-classifier.js

@@ -1,105 +0,0 @@
-import { init_paths_state, resolveStateDir } from "../config/paths-state.js";
-import { init_agent_scope, resolveAgentProfileDir } from "../agent/agent-scope.js";
-import { extractProfileAgentId } from "../config/agent-profile.js";
-import { init_paths, resolveConfigPath, resolveSkillsDir } from "../config/paths.js";
-import { isBareProfileMarkdownFileName, resolveProfileMarkdownPathIfBareName } from "../agent/tools/tool-paths.js";
-import { isPathUnderWorkspace, resolveWorkspaceSafePath } from "./workspace-editor-path.js";
-import { basename, isAbsolute, resolve } from "node:path";
-import { stat } from "node:fs/promises";
-//#region src/gateway/file-path-classifier.ts
-init_agent_scope();
-init_paths();
-init_paths_state();
-function buildFilePathClassifierContext(cfg, sessionKeyRaw) {
-	const agentId = extractProfileAgentId(sessionKeyRaw, cfg);
-	const stateDir = resolveStateDir();
-	return {
-		workspaceRoot: "",
-		profileMarkdownRoot: resolveAgentProfileDir(cfg, agentId),
-		stateDir,
-		skillsDir: resolveSkillsDir(),
-		configFilePath: resolveConfigPath(),
-		agentsHomeDir: resolve(stateDir, "agents"),
-		agentId
-	};
-}
-function looksLikeHostAbsolutePath(pathRaw) {
-	const p = pathRaw.trim();
-	if (!p) return false;
-	if (/^[a-z][a-z0-9+.-]*:/i.test(p) && !/^[A-Za-z]:[\\/]/.test(p)) return false;
-	return isAbsolute(p) || /^[A-Za-z]:[\\/]/.test(p) || p.startsWith("\\\\");
-}
-function fileRefSessionKeysMatch(registered, query) {
-	return (registered ?? "").trim() === (query ?? "").trim();
-}
-function classifyFileLocation(absPath, ctx) {
-	const p = resolve(absPath);
-	if (isPathUnderWorkspace(resolve(ctx.workspaceRoot), p)) return { scope: "workspace" };
-	if (ctx.profileMarkdownRoot) {
-		if (isPathUnderWorkspace(resolve(ctx.profileMarkdownRoot), p)) return {
-			scope: "agent-profile",
-			locationKind: "agent-profile",
-			manageRoute: "/settings/agents"
-		};
-	}
-	if (isPathUnderWorkspace(resolve(ctx.skillsDir), p)) return {
-		scope: "external",
-		locationKind: "xopc-skills",
-		manageRoute: "/settings/skills"
-	};
-	if (isPathUnderWorkspace(resolve(ctx.agentsHomeDir), p)) return {
-		scope: "external",
-		locationKind: "xopc-agents",
-		manageRoute: "/settings/agents"
-	};
-	const stateRoot = resolve(ctx.stateDir);
-	if (p === resolve(ctx.configFilePath) || isPathUnderWorkspace(stateRoot, p)) return {
-		scope: "external",
-		locationKind: "xopc-config",
-		manageRoute: "/settings/gateway"
-	};
-	return {
-		scope: "external",
-		locationKind: "host"
-	};
-}
-/**
-* Resolve user path to an absolute candidate (workspace, absolute host, or profile fallback).
-*/
-async function resolveFileReferenceCandidate(rawPath, workspaceRoot, ctx) {
-	const displayRoot = workspaceRoot;
-	ctx = {
-		...ctx,
-		workspaceRoot: displayRoot
-	};
-	if (looksLikeHostAbsolutePath(rawPath)) return {
-		candidate: resolve(rawPath),
-		invalid: false
-	};
-	const wsPath = resolveWorkspaceSafePath(workspaceRoot, rawPath);
-	if (!wsPath) return {
-		candidate: null,
-		invalid: true
-	};
-	try {
-		await stat(wsPath);
-		return {
-			candidate: wsPath,
-			invalid: false
-		};
-	} catch (e) {
-		if (e?.code === "ENOENT" && ctx.profileMarkdownRoot && isBareProfileMarkdownFileName(rawPath)) return {
-			candidate: resolveProfileMarkdownPathIfBareName(rawPath, ctx.profileMarkdownRoot),
-			invalid: false
-		};
-		return {
-			candidate: wsPath,
-			invalid: false
-		};
-	}
-}
-function displayNameForPath(rawPath) {
-	return basename(rawPath.replace(/\\/g, "/")) || rawPath;
-}
-//#endregion
-export { buildFilePathClassifierContext, classifyFileLocation, displayNameForPath, fileRefSessionKeysMatch, looksLikeHostAbsolutePath, resolveFileReferenceCandidate };

package/dist/src/gateway/file-reference-errors.d.ts

@@ -1,6 +0,0 @@
-export type FileReferenceFsError = {
-    code: 'FILE_NOT_FOUND' | 'FILE_ACCESS_DENIED' | 'FILE_ACCESS_FAILED';
-    message: string;
-    status: 404 | 403 | 500;
-};
-export declare function classifyFileReferenceFsError(err: unknown): FileReferenceFsError;

package/dist/src/gateway/file-reference-errors.js

@@ -1,21 +0,0 @@
-//#region src/gateway/file-reference-errors.ts
-function classifyFileReferenceFsError(err) {
-	const code = err?.code;
-	if (code === "ENOENT" || code === "ENOTDIR") return {
-		code: "FILE_NOT_FOUND",
-		message: "File not found",
-		status: 404
-	};
-	if (code === "EACCES" || code === "EPERM") return {
-		code: "FILE_ACCESS_DENIED",
-		message: "Gateway does not have permission to access this file",
-		status: 403
-	};
-	return {
-		code: "FILE_ACCESS_FAILED",
-		message: "Gateway could not access this file",
-		status: 500
-	};
-}
-//#endregion
-export { classifyFileReferenceFsError };

package/dist/src/gateway/file-reference-registry.d.ts

@@ -1,34 +0,0 @@
-export type FileReferenceScope = 'workspace' | 'external' | 'agent-profile' | 'session-artifact' | 'missing' | 'invalid';
-/** Where an off-workspace file lives (UI badge + manage deep link). */
-export type FileReferenceLocationKind = 'agent-profile' | 'xopc-skills' | 'xopc-config' | 'xopc-agents' | 'xopc-sessions' | 'host';
-export type FileReferenceCapability = 'preview' | 'edit' | 'openExternal' | 'revealInFolder' | 'copyPath' | 'importToWorkspace';
-export interface RegisteredFileReference {
-    id: string;
-    absolutePath: string;
-    sessionKey?: string;
-    scope: FileReferenceScope;
-    locationKind?: FileReferenceLocationKind;
-    capabilities: FileReferenceCapability[];
-    expiresAt: number;
-}
-export interface RegisterFileReferenceInput {
-    absolutePath: string;
-    sessionKey?: string;
-    scope: FileReferenceScope;
-    locationKind?: FileReferenceLocationKind;
-    capabilities: FileReferenceCapability[];
-    ttlMs?: number;
-}
-export declare class FileReferenceRegistry {
-    private readonly refs;
-    register(input: RegisterFileReferenceInput): RegisteredFileReference;
-    resolve(id: string): RegisteredFileReference | null;
-    /**
-     * Remove a specific reference (used after a one-shot action like
-     * import-to-workspace completes so the source card can't be re-triggered).
-     * Returns true if the reference existed and was removed.
-     */
-    expireById(id: string): boolean;
-    expire(now?: number): void;
-}
-export declare const fileReferenceRegistry: FileReferenceRegistry;