@xopcai/xopc 0.0.126 → 0.0.128

package/dist/src/capabilities/store-connector.js

@@ -0,0 +1,191 @@
+import { installConnectorDefinition } from "../connectors/install.js";
+import { downloadConnectorStoreZipBuffer, fetchStoreConnectorPackageDetail, listConnectorPackages, resolveSkillsStoreBaseUrl } from "../agent/skills/marketplace/adapters/store/store-api-client.js";
+import { createHash } from "node:crypto";
+import { isIP } from "node:net";
+import AdmZip from "adm-zip";
+//#region src/capabilities/store-connector.ts
+function asRecord(value, label) {
+	if (!value || typeof value !== "object" || Array.isArray(value)) throw new Error(`${label} must be an object.`);
+	return value;
+}
+function asString(value, label) {
+	if (typeof value !== "string" || !value.trim()) throw new Error(`${label} must be a non-empty string.`);
+	return value.trim();
+}
+function asStringArray(value, label) {
+	if (!Array.isArray(value) || value.some((item) => typeof item !== "string" || !item.trim())) throw new Error(`${label} must be an array of non-empty strings.`);
+	return value.map((item) => item.trim());
+}
+const NPM_PACKAGE_NAME = /^(?:@[a-z0-9][a-z0-9._-]*\/)?[a-z0-9][a-z0-9._-]*$/;
+const EXACT_SEMVER = /^v?(?:0|[1-9]\d*)\.(?:0|[1-9]\d*)\.(?:0|[1-9]\d*)(?:-[0-9A-Za-z.-]+)?(?:\+[0-9A-Za-z.-]+)?$/;
+function assertSafeRemoteUrl(value) {
+	const urlString = asString(value, "Connector MCP endpoint");
+	let url;
+	try {
+		url = new URL(urlString);
+	} catch {
+		throw new Error("Connector MCP endpoint must be a valid URL.");
+	}
+	const hostname = url.hostname.toLowerCase().replace(/^\[|\]$/g, "");
+	if (url.protocol !== "https:" || url.username || url.password || hostname === "localhost" || hostname.endsWith(".localhost") || isIP(hostname)) throw new Error("Store connectors must use a public HTTPS MCP endpoint.");
+	return url.toString();
+}
+function readPermissions(value, isLocal) {
+	const permissions = asRecord(value, "Connector permissions");
+	if (permissions.localExec !== isLocal) {
+		if (isLocal) throw new Error("Local Store connectors must explicitly allow local command execution.");
+		throw new Error("Store connectors must explicitly deny local command execution.");
+	}
+	const filesystem = permissions.filesystem === void 0 ? [] : asStringArray(permissions.filesystem, "Connector filesystem permissions");
+	if (filesystem.length > 0) throw new Error("Store connectors cannot request filesystem access.");
+	const networkDomains = asStringArray(permissions.networkDomains, "Connector network domains");
+	if (!isLocal && networkDomains.length === 0) throw new Error("Store connectors must declare at least one network domain.");
+	return {
+		...permissions.data === void 0 ? {} : { data: asStringArray(permissions.data, "Connector data permissions") },
+		networkDomains,
+		localExec: isLocal,
+		filesystem
+	};
+}
+function readPinnedLocalRuntime(runtime, template) {
+	if (runtime.localPackage === void 0) return null;
+	const localPackage = asRecord(runtime.localPackage, "Connector localPackage");
+	if (localPackage.registry !== "npm") throw new Error("Local Store connectors must use the npm registry.");
+	const name = asString(localPackage.name, "Connector local package name");
+	const version = asString(localPackage.version, "Connector local package version");
+	if (!NPM_PACKAGE_NAME.test(name) || !EXACT_SEMVER.test(version)) throw new Error("Local Store connectors must use a valid exact npm package version.");
+	if (template.command !== "npx" || JSON.stringify(asStringArray(template.args, "Connector local MCP arguments")) !== JSON.stringify(["--yes", `${name}@${version}`])) throw new Error("Local Store connectors must use the pinned npx launch form.");
+	for (const field of [
+		"url",
+		"env",
+		"cwd",
+		"workingDirectory",
+		"headers",
+		"transport"
+	]) if (field in template) throw new Error("Local Store connectors cannot define additional MCP process fields.");
+	return {
+		registry: "npm",
+		name,
+		version
+	};
+}
+function readConnectorManifest(value, packageName, version, sha256) {
+	const manifest = asRecord(value, "Connector manifest");
+	if (asString(manifest.id, "Connector id") !== packageName) throw new Error("Connector manifest id does not match the store package name.");
+	const runtime = asRecord(manifest.runtime, "Connector runtime");
+	if (runtime.type !== "mcp") throw new Error("Store connectors must use the MCP runtime.");
+	const serverTemplate = asRecord(runtime.serverTemplate, "Connector MCP serverTemplate");
+	const localPackage = readPinnedLocalRuntime(runtime, serverTemplate);
+	const transport = serverTemplate.transport;
+	if (!localPackage && transport !== "streamable-http" && transport !== "sse") throw new Error("Store connectors must use streamable-http or sse transport.");
+	const authMode = asRecord(manifest.auth, "Connector auth").mode;
+	if (authMode !== "none" && authMode !== "apiKey" && authMode !== "oauth") throw new Error("Connector auth mode must be none, apiKey, or oauth.");
+	const category = asString(manifest.category, "Connector category");
+	if (![
+		"code",
+		"docs",
+		"browser",
+		"data",
+		"automation",
+		"custom"
+	].includes(category)) throw new Error(`Unsupported connector category: ${category}`);
+	const capabilities = asStringArray(manifest.capabilities, "Connector capabilities");
+	const allowedCapabilities = new Set([
+		"tools",
+		"resources",
+		"prompts",
+		"context",
+		"events",
+		"auth.apiKey",
+		"auth.oauth",
+		"runtime.mcp.stdio",
+		"runtime.mcp.sse",
+		"runtime.mcp.streamableHttp"
+	]);
+	if (capabilities.some((capability) => !allowedCapabilities.has(capability))) throw new Error("Connector manifest contains an unsupported capability.");
+	const setup = manifest.setup === void 0 ? {} : asRecord(manifest.setup, "Connector setup");
+	const permissions = readPermissions(manifest.permissions, Boolean(localPackage));
+	const endpoint = localPackage ? void 0 : assertSafeRemoteUrl(serverTemplate.url);
+	const hostname = endpoint ? new URL(endpoint).hostname : void 0;
+	if (hostname && permissions.networkDomains?.length && !permissions.networkDomains.includes(hostname)) throw new Error("Connector network permissions must include the MCP endpoint host.");
+	return {
+		id: packageName,
+		version,
+		displayName: asString(manifest.displayName, "Connector displayName"),
+		description: asString(manifest.description, "Connector description"),
+		category,
+		kind: "mcp",
+		source: "store",
+		capabilities,
+		...Array.isArray(manifest.tags) ? { tags: asStringArray(manifest.tags, "Connector tags") } : {},
+		auth: { mode: authMode },
+		setup,
+		runtime: {
+			type: "mcp",
+			serverId: asString(runtime.serverId, "Connector MCP serverId"),
+			serverTemplate: localPackage ? serverTemplate : {
+				...serverTemplate,
+				url: endpoint
+			},
+			...localPackage ? { localPackage } : {}
+		},
+		permissions,
+		provenance: {
+			packageName,
+			sha256
+		}
+	};
+}
+function readConnectorManifestFromArchive(buffer) {
+	let archive;
+	try {
+		archive = new AdmZip(buffer);
+	} catch {
+		throw new Error("Store connector artifact is not a valid zip archive.");
+	}
+	const entry = archive.getEntries().find((candidate) => {
+		const path = candidate.entryName.replace(/\\/g, "/").replace(/^\/+/, "");
+		return !candidate.isDirectory && (path === "xopc.connector.json" || path.endsWith("/xopc.connector.json"));
+	});
+	if (!entry) throw new Error("Store connector artifact is missing xopc.connector.json.");
+	try {
+		return JSON.parse(entry.getData().toString("utf8"));
+	} catch {
+		throw new Error("Store connector manifest is not valid JSON.");
+	}
+}
+async function listStoreConnectors(config, params) {
+	return listConnectorPackages(resolveSkillsStoreBaseUrl(config), params);
+}
+async function getStoreConnectorInstallPlan(config, packageName, version) {
+	const storeBaseUrl = resolveSkillsStoreBaseUrl(config);
+	const detail = await fetchStoreConnectorPackageDetail(storeBaseUrl, packageName, version);
+	const sha256 = detail.latestVersion.sha256;
+	if (!sha256 || !/^[a-f0-9]{64}$/i.test(sha256)) throw new Error("Store connector version is missing a valid SHA-256 checksum.");
+	const archive = await downloadConnectorStoreZipBuffer(storeBaseUrl, detail.latestVersion.downloadUrl);
+	const actualSha256 = createHash("sha256").update(archive).digest("hex");
+	if (actualSha256 !== sha256.toLowerCase()) throw new Error("Store connector artifact checksum verification failed.");
+	const definition = readConnectorManifest(readConnectorManifestFromArchive(archive), detail.name, detail.latestVersion.version, actualSha256);
+	const storeManifest = readConnectorManifest(detail.latestVersion.manifest, detail.name, detail.latestVersion.version, actualSha256);
+	if (JSON.stringify(definition.runtime) !== JSON.stringify(storeManifest.runtime)) throw new Error("Store connector metadata does not match its verified artifact.");
+	return {
+		packageName: detail.name,
+		version: detail.latestVersion.version,
+		permissions: definition.permissions ?? {},
+		requiresRestart: false,
+		requiresOAuth: definition.auth.mode === "oauth",
+		definition
+	};
+}
+async function installStoreConnector(config, packageName, input, version) {
+	const plan = await getStoreConnectorInstallPlan(config, packageName, version);
+	if (plan.requiresOAuth && plan.definition.id !== "github") throw new Error("OAuth installation for store connectors is not available yet. Use an API-key connector or the built-in GitHub connector.");
+	return {
+		instance: await installConnectorDefinition(config, plan.definition, input),
+		plan
+	};
+}
+//#endregion
+export { getStoreConnectorInstallPlan, installStoreConnector, listStoreConnectors };
+
+//# sourceMappingURL=store-connector.js.map

package/dist/src/capabilities/store-connector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store-connector.js","names":[],"sources":["../../../src/capabilities/store-connector.ts"],"sourcesContent":["import { createHash } from 'node:crypto';\nimport { isIP } from 'node:net';\n\nimport AdmZip from 'adm-zip';\n\nimport type { Config } from '../config/schema.js';\nimport { installConnectorDefinition } from '../connectors/install.js';\nimport type {\n  ConnectorDefinition,\n  ConnectorInstallInput,\n  ConnectorPermissions,\n} from '../connectors/types.js';\nimport {\n  downloadConnectorStoreZipBuffer,\n  fetchStoreConnectorPackageDetail,\n  listConnectorPackages,\n  resolveSkillsStoreBaseUrl,\n  type SkillsStoreListParams,\n} from '../agent/skills/marketplace/adapters/store/store-api-client.js';\n\ntype JsonRecord = Record<string, unknown>;\n\nexport type StoreConnectorInstallPlan = {\n  packageName: string;\n  version: string;\n  definition: ConnectorDefinition;\n  permissions: ConnectorPermissions;\n  requiresRestart: false;\n  requiresOAuth: boolean;\n};\n\nfunction asRecord(value: unknown, label: string): JsonRecord {\n  if (!value || typeof value !== 'object' || Array.isArray(value)) {\n    throw new Error(`${label} must be an object.`);\n  }\n  return value as JsonRecord;\n}\n\nfunction asString(value: unknown, label: string): string {\n  if (typeof value !== 'string' || !value.trim()) {\n    throw new Error(`${label} must be a non-empty string.`);\n  }\n  return value.trim();\n}\n\nfunction asStringArray(value: unknown, label: string): string[] {\n  if (!Array.isArray(value) || value.some((item) => typeof item !== 'string' || !item.trim())) {\n    throw new Error(`${label} must be an array of non-empty strings.`);\n  }\n  return value.map((item) => item.trim());\n}\n\nconst NPM_PACKAGE_NAME = /^(?:@[a-z0-9][a-z0-9._-]*\\/)?[a-z0-9][a-z0-9._-]*$/;\nconst EXACT_SEMVER = /^v?(?:0|[1-9]\\d*)\\.(?:0|[1-9]\\d*)\\.(?:0|[1-9]\\d*)(?:-[0-9A-Za-z.-]+)?(?:\\+[0-9A-Za-z.-]+)?$/;\n\nfunction assertSafeRemoteUrl(value: unknown): string {\n  const urlString = asString(value, 'Connector MCP endpoint');\n  let url: URL;\n  try {\n    url = new URL(urlString);\n  } catch {\n    throw new Error('Connector MCP endpoint must be a valid URL.');\n  }\n  const hostname = url.hostname.toLowerCase().replace(/^\\[|\\]$/g, '');\n  if (\n    url.protocol !== 'https:' ||\n    url.username ||\n    url.password ||\n    hostname === 'localhost' ||\n    hostname.endsWith('.localhost') ||\n    isIP(hostname)\n  ) {\n    throw new Error('Store connectors must use a public HTTPS MCP endpoint.');\n  }\n  return url.toString();\n}\n\nfunction readPermissions(value: unknown, isLocal: boolean): ConnectorPermissions {\n  const permissions = asRecord(value, 'Connector permissions');\n  if (permissions.localExec !== isLocal) {\n    if (isLocal) throw new Error('Local Store connectors must explicitly allow local command execution.');\n    throw new Error('Store connectors must explicitly deny local command execution.');\n  }\n  const filesystem = permissions.filesystem === undefined\n    ? []\n    : asStringArray(permissions.filesystem, 'Connector filesystem permissions');\n  if (filesystem.length > 0) {\n    throw new Error('Store connectors cannot request filesystem access.');\n  }\n  const networkDomains = asStringArray(permissions.networkDomains, 'Connector network domains');\n  if (!isLocal && networkDomains.length === 0) {\n    throw new Error('Store connectors must declare at least one network domain.');\n  }\n  return {\n    ...(permissions.data === undefined ? {} : { data: asStringArray(permissions.data, 'Connector data permissions') }),\n    networkDomains,\n    localExec: isLocal,\n    filesystem,\n  };\n}\n\nfunction readPinnedLocalRuntime(runtime: JsonRecord, template: JsonRecord): { registry: 'npm'; name: string; version: string } | null {\n  if (runtime.localPackage === undefined) return null;\n  const localPackage = asRecord(runtime.localPackage, 'Connector localPackage');\n  if (localPackage.registry !== 'npm') {\n    throw new Error('Local Store connectors must use the npm registry.');\n  }\n  const name = asString(localPackage.name, 'Connector local package name');\n  const version = asString(localPackage.version, 'Connector local package version');\n  if (!NPM_PACKAGE_NAME.test(name) || !EXACT_SEMVER.test(version)) {\n    throw new Error('Local Store connectors must use a valid exact npm package version.');\n  }\n  if (template.command !== 'npx' ||\n    JSON.stringify(asStringArray(template.args, 'Connector local MCP arguments')) !== JSON.stringify(['--yes', `${name}@${version}`])) {\n    throw new Error('Local Store connectors must use the pinned npx launch form.');\n  }\n  for (const field of ['url', 'env', 'cwd', 'workingDirectory', 'headers', 'transport']) {\n    if (field in template) throw new Error('Local Store connectors cannot define additional MCP process fields.');\n  }\n  return { registry: 'npm', name, version };\n}\n\nfunction readConnectorManifest(\n  value: unknown,\n  packageName: string,\n  version: string,\n  sha256: string,\n): ConnectorDefinition {\n  const manifest = asRecord(value, 'Connector manifest');\n  if (asString(manifest.id, 'Connector id') !== packageName) {\n    throw new Error('Connector manifest id does not match the store package name.');\n  }\n  const runtime = asRecord(manifest.runtime, 'Connector runtime');\n  if (runtime.type !== 'mcp') {\n    throw new Error('Store connectors must use the MCP runtime.');\n  }\n  const serverTemplate = asRecord(runtime.serverTemplate, 'Connector MCP serverTemplate');\n  const localPackage = readPinnedLocalRuntime(runtime, serverTemplate);\n  const transport = serverTemplate.transport;\n  if (!localPackage && transport !== 'streamable-http' && transport !== 'sse') {\n    throw new Error('Store connectors must use streamable-http or sse transport.');\n  }\n  const auth = asRecord(manifest.auth, 'Connector auth');\n  const authMode = auth.mode;\n  if (authMode !== 'none' && authMode !== 'apiKey' && authMode !== 'oauth') {\n    throw new Error('Connector auth mode must be none, apiKey, or oauth.');\n  }\n  const category = asString(manifest.category, 'Connector category');\n  if (!['code', 'docs', 'browser', 'data', 'automation', 'custom'].includes(category)) {\n    throw new Error(`Unsupported connector category: ${category}`);\n  }\n  const capabilities = asStringArray(manifest.capabilities, 'Connector capabilities');\n  const allowedCapabilities = new Set([\n    'tools', 'resources', 'prompts', 'context', 'events', 'auth.apiKey', 'auth.oauth',\n    'runtime.mcp.stdio', 'runtime.mcp.sse', 'runtime.mcp.streamableHttp',\n  ]);\n  if (capabilities.some((capability) => !allowedCapabilities.has(capability))) {\n    throw new Error('Connector manifest contains an unsupported capability.');\n  }\n  const setup = manifest.setup === undefined ? {} : asRecord(manifest.setup, 'Connector setup');\n  const permissions = readPermissions(manifest.permissions, Boolean(localPackage));\n  const endpoint = localPackage ? undefined : assertSafeRemoteUrl(serverTemplate.url);\n  const hostname = endpoint ? new URL(endpoint).hostname : undefined;\n  if (hostname && permissions.networkDomains?.length && !permissions.networkDomains.includes(hostname)) {\n    throw new Error('Connector network permissions must include the MCP endpoint host.');\n  }\n\n  return {\n    id: packageName,\n    version,\n    displayName: asString(manifest.displayName, 'Connector displayName'),\n    description: asString(manifest.description, 'Connector description'),\n    category: category as ConnectorDefinition['category'],\n    kind: 'mcp',\n    source: 'store',\n    capabilities: capabilities as ConnectorDefinition['capabilities'],\n    ...(Array.isArray(manifest.tags) ? { tags: asStringArray(manifest.tags, 'Connector tags') } : {}),\n    auth: { mode: authMode },\n    setup: setup as ConnectorDefinition['setup'],\n    runtime: {\n      type: 'mcp',\n      serverId: asString(runtime.serverId, 'Connector MCP serverId'),\n      serverTemplate: localPackage ? serverTemplate : { ...serverTemplate, url: endpoint },\n      ...(localPackage ? { localPackage } : {}),\n    },\n    permissions,\n    provenance: { packageName, sha256 },\n  };\n}\n\nfunction readConnectorManifestFromArchive(buffer: Buffer): unknown {\n  let archive: AdmZip;\n  try {\n    archive = new AdmZip(buffer);\n  } catch {\n    throw new Error('Store connector artifact is not a valid zip archive.');\n  }\n  const entry = archive.getEntries().find((candidate) => {\n    const path = candidate.entryName.replace(/\\\\/g, '/').replace(/^\\/+/, '');\n    return !candidate.isDirectory && (path === 'xopc.connector.json' || path.endsWith('/xopc.connector.json'));\n  });\n  if (!entry) {\n    throw new Error('Store connector artifact is missing xopc.connector.json.');\n  }\n  try {\n    return JSON.parse(entry.getData().toString('utf8'));\n  } catch {\n    throw new Error('Store connector manifest is not valid JSON.');\n  }\n}\n\nexport async function listStoreConnectors(config: Config, params: SkillsStoreListParams) {\n  return listConnectorPackages(resolveSkillsStoreBaseUrl(config), params);\n}\n\nexport async function getStoreConnectorInstallPlan(\n  config: Config,\n  packageName: string,\n  version?: string,\n): Promise<StoreConnectorInstallPlan> {\n  const storeBaseUrl = resolveSkillsStoreBaseUrl(config);\n  const detail = await fetchStoreConnectorPackageDetail(storeBaseUrl, packageName, version);\n  const sha256 = detail.latestVersion.sha256;\n  if (!sha256 || !/^[a-f0-9]{64}$/i.test(sha256)) {\n    throw new Error('Store connector version is missing a valid SHA-256 checksum.');\n  }\n  const archive = await downloadConnectorStoreZipBuffer(storeBaseUrl, detail.latestVersion.downloadUrl);\n  const actualSha256 = createHash('sha256').update(archive).digest('hex');\n  if (actualSha256 !== sha256.toLowerCase()) {\n    throw new Error('Store connector artifact checksum verification failed.');\n  }\n  const artifactManifest = readConnectorManifestFromArchive(archive);\n  const definition = readConnectorManifest(\n    artifactManifest,\n    detail.name,\n    detail.latestVersion.version,\n    actualSha256,\n  );\n  const storeManifest = readConnectorManifest(\n    detail.latestVersion.manifest,\n    detail.name,\n    detail.latestVersion.version,\n    actualSha256,\n  );\n  if (JSON.stringify(definition.runtime) !== JSON.stringify(storeManifest.runtime)) {\n    throw new Error('Store connector metadata does not match its verified artifact.');\n  }\n  return {\n    packageName: detail.name,\n    version: detail.latestVersion.version,\n    permissions: definition.permissions ?? {},\n    requiresRestart: false,\n    requiresOAuth: definition.auth.mode === 'oauth',\n    definition,\n  };\n}\n\nexport async function installStoreConnector(\n  config: Config,\n  packageName: string,\n  input: ConnectorInstallInput,\n  version?: string,\n) {\n  const plan = await getStoreConnectorInstallPlan(config, packageName, version);\n  if (plan.requiresOAuth && plan.definition.id !== 'github') {\n    throw new Error('OAuth installation for store connectors is not available yet. Use an API-key connector or the built-in GitHub connector.');\n  }\n  const instance = await installConnectorDefinition(config, plan.definition, input);\n  return { instance, plan };\n}\n"],"mappings":"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"}

package/dist/src/chat-commands/builtins/skill.d.ts

@@ -0,0 +1 @@
+export declare function registerSkillCommand(): void;

package/dist/src/chat-commands/builtins/skill.js

@@ -0,0 +1,132 @@
+import { commandRegistry } from "../registry.js";
+//#region src/chat-commands/builtins/skill.ts
+function tokenizeArgs(input) {
+	const out = [];
+	let current = "";
+	let quote = null;
+	let escaping = false;
+	for (const ch of input) {
+		if (escaping) {
+			current += ch;
+			escaping = false;
+			continue;
+		}
+		if (ch === "\\") {
+			escaping = true;
+			continue;
+		}
+		if (quote) {
+			if (ch === quote) quote = null;
+			else current += ch;
+			continue;
+		}
+		if (ch === "\"" || ch === "'") {
+			quote = ch;
+			continue;
+		}
+		if (/\s/.test(ch)) {
+			if (current) {
+				out.push(current);
+				current = "";
+			}
+			continue;
+		}
+		current += ch;
+	}
+	if (current) out.push(current);
+	return out;
+}
+function usage() {
+	return [
+		"usage: /skill install <source> [--ref <ref>] [--path <dir>] [--id <skillId>] [--workspace|--global] [--force]",
+		"",
+		"source may be a Git URL, GitHub repository URL, https .zip/.tar.gz URL, file:// URL, or local archive/path.",
+		"Default target is the current workspace. Use --global only for personal skills shared by all projects."
+	].join("\n");
+}
+function parseInstallArgs(args) {
+	const tokens = tokenizeArgs(args);
+	const source = tokens.shift();
+	if (!source) throw new Error(usage());
+	const parsed = { source };
+	for (let i = 0; i < tokens.length; i += 1) {
+		const token = tokens[i];
+		const next = () => {
+			const value = tokens[++i];
+			if (!value) throw new Error(`Missing value for ${token}`);
+			return value;
+		};
+		if (token === "--ref") parsed.ref = next();
+		else if (token === "--path") parsed.path = next();
+		else if (token === "--id" || token === "--skill-id") parsed.skillId = next();
+		else if (token === "--workspace") parsed.target = "workspace";
+		else if (token === "--global") parsed.target = "global";
+		else if (token === "--force") parsed.force = true;
+		else if (token === "--strict-scan") parsed.strictScan = true;
+		else throw new Error(`Unknown option: ${token}\n\n${usage()}`);
+	}
+	return parsed;
+}
+const skillCommand = {
+	id: "system.skill",
+	name: "skill",
+	aliases: ["skills"],
+	description: "Install skills from explicit sources. Subcommands: install <source>",
+	category: "tool",
+	scope: ["global", "private"],
+	acceptsArgs: true,
+	examples: ["/skill install https://github.com/org/repo", "/skill install https://example.com/skill.zip --id my-skill --force"],
+	handler: async (ctx, args) => {
+		const trimmed = args.trim();
+		const [subRaw, ...rest] = trimmed ? trimmed.split(/\s+/) : [];
+		const sub = subRaw?.toLowerCase();
+		if (!sub || sub === "help") return {
+			content: usage(),
+			success: true
+		};
+		if (sub !== "install") return {
+			content: `Unknown subcommand "${subRaw}". Available: install.\n\n${usage()}`,
+			success: false
+		};
+		if (!ctx.installSkillFromSource) return {
+			content: "Skill installation is not available in this context.",
+			success: false
+		};
+		let parsed;
+		try {
+			parsed = parseInstallArgs(rest.join(" "));
+		} catch (err) {
+			return {
+				content: err instanceof Error ? err.message : String(err),
+				success: false
+			};
+		}
+		await ctx.setTyping(true);
+		try {
+			const result = await ctx.installSkillFromSource(parsed);
+			return {
+				content: [
+					`Installed skill "${result.skillId}".`,
+					`Target: ${result.target ?? parsed.target ?? "workspace"}`,
+					`Source: ${result.source} (${result.kind})`,
+					`Path: ${result.path}`,
+					`Tree hash: ${result.contentHash.slice(0, 16)}`
+				].join("\n"),
+				success: true,
+				metadata: { skillInstall: result }
+			};
+		} catch (err) {
+			return {
+				content: `Skill install failed: ${err instanceof Error ? err.message : String(err)}`,
+				success: false
+			};
+		}
+	}
+};
+function registerSkillCommand() {
+	commandRegistry.register(skillCommand);
+}
+//#endregion
+export { registerSkillCommand };
+
+//# sourceMappingURL=skill.js.map

package/dist/src/chat-commands/builtins/skill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill.js","names":[],"sources":["../../../../src/chat-commands/builtins/skill.ts"],"sourcesContent":["import { commandRegistry } from '../registry.js';\nimport type { CommandContext, CommandDefinition } from '../types.js';\n\nfunction tokenizeArgs(input: string): string[] {\n  const out: string[] = [];\n  let current = '';\n  let quote: '\"' | \"'\" | null = null;\n  let escaping = false;\n  for (const ch of input) {\n    if (escaping) {\n      current += ch;\n      escaping = false;\n      continue;\n    }\n    if (ch === '\\\\') {\n      escaping = true;\n      continue;\n    }\n    if (quote) {\n      if (ch === quote) quote = null;\n      else current += ch;\n      continue;\n    }\n    if (ch === '\"' || ch === \"'\") {\n      quote = ch;\n      continue;\n    }\n    if (/\\s/.test(ch)) {\n      if (current) {\n        out.push(current);\n        current = '';\n      }\n      continue;\n    }\n    current += ch;\n  }\n  if (current) out.push(current);\n  return out;\n}\n\nfunction usage(): string {\n  return [\n    'usage: /skill install <source> [--ref <ref>] [--path <dir>] [--id <skillId>] [--workspace|--global] [--force]',\n    '',\n    'source may be a Git URL, GitHub repository URL, https .zip/.tar.gz URL, file:// URL, or local archive/path.',\n    'Default target is the current workspace. Use --global only for personal skills shared by all projects.',\n  ].join('\\n');\n}\n\ntype ParsedInstallArgs = {\n  source: string;\n  ref?: string;\n  path?: string;\n  skillId?: string;\n  target?: 'workspace' | 'global';\n  force?: boolean;\n  strictScan?: boolean;\n};\n\nfunction parseInstallArgs(args: string): ParsedInstallArgs {\n  const tokens = tokenizeArgs(args);\n  const source = tokens.shift();\n  if (!source) throw new Error(usage());\n\n  const parsed: ParsedInstallArgs = { source };\n  for (let i = 0; i < tokens.length; i += 1) {\n    const token = tokens[i];\n    const next = () => {\n      const value = tokens[++i];\n      if (!value) throw new Error(`Missing value for ${token}`);\n      return value;\n    };\n    if (token === '--ref') parsed.ref = next();\n    else if (token === '--path') parsed.path = next();\n    else if (token === '--id' || token === '--skill-id') parsed.skillId = next();\n    else if (token === '--workspace') parsed.target = 'workspace';\n    else if (token === '--global') parsed.target = 'global';\n    else if (token === '--force') parsed.force = true;\n    else if (token === '--strict-scan') parsed.strictScan = true;\n    else throw new Error(`Unknown option: ${token}\\n\\n${usage()}`);\n  }\n  return parsed;\n}\n\nconst skillCommand: CommandDefinition = {\n  id: 'system.skill',\n  name: 'skill',\n  aliases: ['skills'],\n  description: 'Install skills from explicit sources. Subcommands: install <source>',\n  category: 'tool',\n  scope: ['global', 'private'],\n  acceptsArgs: true,\n  examples: [\n    '/skill install https://github.com/org/repo',\n    '/skill install https://example.com/skill.zip --id my-skill --force',\n  ],\n  handler: async (ctx: CommandContext, args: string) => {\n    const trimmed = args.trim();\n    const [subRaw, ...rest] = trimmed ? trimmed.split(/\\s+/) : [];\n    const sub = subRaw?.toLowerCase();\n    if (!sub || sub === 'help') {\n      return { content: usage(), success: true };\n    }\n    if (sub !== 'install') {\n      return {\n        content: `Unknown subcommand \"${subRaw}\". Available: install.\\n\\n${usage()}`,\n        success: false,\n      };\n    }\n    if (!ctx.installSkillFromSource) {\n      return {\n        content: 'Skill installation is not available in this context.',\n        success: false,\n      };\n    }\n\n    let parsed: ParsedInstallArgs;\n    try {\n      parsed = parseInstallArgs(rest.join(' '));\n    } catch (err) {\n      return {\n        content: err instanceof Error ? err.message : String(err),\n        success: false,\n      };\n    }\n\n    await ctx.setTyping(true);\n    try {\n      const result = await ctx.installSkillFromSource(parsed);\n      return {\n        content: [\n          `Installed skill \"${result.skillId}\".`,\n          `Target: ${result.target ?? parsed.target ?? 'workspace'}`,\n          `Source: ${result.source} (${result.kind})`,\n          `Path: ${result.path}`,\n          `Tree hash: ${result.contentHash.slice(0, 16)}`,\n        ].join('\\n'),\n        success: true,\n        metadata: { skillInstall: result },\n      };\n    } catch (err) {\n      return {\n        content: `Skill install failed: ${err instanceof Error ? err.message : String(err)}`,\n        success: false,\n      };\n    }\n  },\n};\n\nexport function registerSkillCommand(): void {\n  commandRegistry.register(skillCommand);\n}\n"],"mappings":"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"}

package/dist/src/chat-commands/context.d.ts

@@ -44,6 +44,8 @@ export interface CommandContextDeps {
     abortCurrentTurn?: () => Promise<void>;
     /** Reload skills from disk and refresh active agent prompts. */
     reloadSkills?: () => Promise<void>;
+    /** Install a managed skill from an explicit source and refresh active agent prompts. */
+    installSkillFromSource?: CommandContext['installSkillFromSource'];
     compactSession?: (sessionKey: string, options?: {
         instructions?: string;
         force?: boolean;
@@ -68,6 +70,7 @@ export declare class CommandContextImpl implements CommandContext {
     readonly config: Config;
     readonly abortCurrentTurn?: () => Promise<void>;
     readonly reloadSkills?: () => Promise<void>;
+    readonly installSkillFromSource?: CommandContext['installSkillFromSource'];
     readonly persistentGoalApis?: PersistentGoalApis;
     readonly workflowRunApis?: CommandContext['workflowRunApis'];
     private deps;

package/dist/src/chat-commands/context.js

@@ -25,6 +25,7 @@ var CommandContextImpl = class {
 	config;
 	abortCurrentTurn;
 	reloadSkills;
+	installSkillFromSource;
 	persistentGoalApis;
 	workflowRunApis;
 	deps;
@@ -51,6 +52,7 @@ var CommandContextImpl = class {
 				await run();
 			};
 		}
+		if (deps.installSkillFromSource) this.installSkillFromSource = deps.installSkillFromSource;
 		this.persistentGoalApis = deps.persistentGoalApis;
 		if (deps.workflowRunService) this.workflowRunApis = {
 			service: deps.workflowRunService,

package/dist/src/chat-commands/context.js.map

@@ -1 +1 @@
-{"version":3,"file":"context.js","names":[],"sources":["../../../src/chat-commands/context.ts"],"sourcesContent":["/**\n * Command Context Implementation\n * \n * Provides the concrete implementation of CommandContext interface,\n * bridging commands to core services (AgentService, SessionStore, etc.)\n */\n\nimport type {\n  CommandContext,\n  ReplyOptions,\n  UIComponent,\n  SessionInfo,\n  ModelInfo,\n  UsageStats,\n  PlatformFeature,\n  MessageSource,\n  CompactSessionResult,\n} from './types.js';\nimport { getSessionDisplayName } from './session-key.js';\nimport type { Config } from '../config/schema.js';\nimport { getAgentDefaultModelRef } from '../config/schema.js';\nimport type { AgentMessage } from '@earendil-works/pi-agent-core';\nimport type { MessageBus } from '../infra/bus/index.js';\nimport type { SessionStore, SessionConfigStore } from '../session/index.js';\nimport { createLogger } from '../utils/logger.js';\nimport { saveConfig } from '../config/loader.js';\nimport type { ThinkLevel, ReasoningLevel, VerboseLevel } from '../agent/transcript/thinking-types.js';\nimport { mkdir, writeFile } from 'fs/promises';\nimport { join } from 'path';\nimport { effectiveWorkspacePathForSession } from '../session/session-workspace.js';\nimport { wrapMarkdownExportAsHtml } from '../session/chat-export.js';\nimport type { CompactionResult } from '../agent/memory/compaction.js';\nimport type { PersistentGoalApis } from '../agent/goals/persistent-goal-apis.js';\nimport type { WorkflowRunServiceLike } from '../workflows/service/workflow-run-service.types.js';\nimport { getProjectForSession } from '../projects/workspace.js';\n\nconst log = createLogger('CommandContext');\n\nexport interface CommandContextDeps {\n  sessionKey: string;\n  source: MessageSource;\n  channelId: string;\n  chatId: string;\n  senderId: string;\n  isGroup: boolean;\n  accountId?: string;\n  threadId?: string;\n  config: Config;\n  bus: MessageBus;\n  sessionStore: SessionStore;\n  sessionConfigStore?: SessionConfigStore;\n  /** After persisting session thinking, sync pi-agent in-memory state */\n  applySessionThinkingLevel?: (sessionKey: string, level: ThinkLevel) => void;\n  // Callbacks for platform-specific operations\n  replyHandler: (text: string, options?: ReplyOptions) => Promise<void>;\n  componentHandler?: (component: UIComponent) => Promise<void>;\n  typingHandler?: (typing: boolean) => Promise<void>;\n  supportedFeatures: PlatformFeature[];\n  /** Called after session files are removed so in-memory agents match disk */\n  invalidateAgentSession?: (sessionKey: string) => void;\n  /** Reset session in place (archive + new session id); optional — falls back to clearSession */\n  resetSession?: (sessionKey: string) => Promise<void>;\n  // Model management (optional, will be injected)\n  getCurrentModel?: () => string;\n  switchModel?: (modelId: string) => Promise<boolean>;\n  listModels?: () => Promise<ModelInfo[]>;\n  getUsage?: () => Promise<UsageStats>;\n  /** Stop current LLM turn and clear channel preview stream (Telegram draft, etc.) */\n  abortCurrentTurn?: () => Promise<void>;\n  /** Reload skills from disk and refresh active agent prompts. */\n  reloadSkills?: () => Promise<void>;\n\n  compactSession?: (\n    sessionKey: string,\n    options?: { instructions?: string; force?: boolean },\n  ) => Promise<CompactionResult>;\n\n  btwQuery?: (sessionKey: string, question: string) => Promise<{ text: string; error?: string }>;\n\n  getSessionContextReport?: (\n    sessionKey: string,\n    mode: 'list' | 'detail' | 'json',\n  ) => Promise<string>;\n\n  persistentGoalApis?: PersistentGoalApis;\n  workflowRunService?: WorkflowRunServiceLike;\n}\n\nexport class CommandContextImpl implements CommandContext {\n  readonly sessionKey: string;\n  readonly source: MessageSource;\n  readonly channelId: string;\n  readonly chatId: string;\n  readonly senderId: string;\n  readonly isGroup: boolean;\n  readonly accountId?: string;\n  readonly threadId?: string;\n  readonly config: Config;\n  readonly abortCurrentTurn?: () => Promise<void>;\n  readonly reloadSkills?: () => Promise<void>;\n  readonly persistentGoalApis?: PersistentGoalApis;\n  readonly workflowRunApis?: CommandContext['workflowRunApis'];\n\n  private deps: CommandContextDeps;\n\n  constructor(deps: CommandContextDeps) {\n    this.sessionKey = deps.sessionKey;\n    this.source = deps.source;\n    this.channelId = deps.channelId;\n    this.chatId = deps.chatId;\n    this.senderId = deps.senderId;\n    this.isGroup = deps.isGroup;\n    this.accountId = deps.accountId;\n    this.threadId = deps.threadId;\n    this.config = deps.config;\n    this.deps = deps;\n\n    if (deps.abortCurrentTurn) {\n      const run = deps.abortCurrentTurn;\n      this.abortCurrentTurn = async () => {\n        await run();\n      };\n    }\n\n    if (deps.reloadSkills) {\n      const run = deps.reloadSkills;\n      this.reloadSkills = async () => {\n        await run();\n      };\n    }\n\n    this.persistentGoalApis = deps.persistentGoalApis;\n    if (deps.workflowRunService) {\n      this.workflowRunApis = {\n        service: deps.workflowRunService,\n        startWorkflowRun: (params) => deps.workflowRunService!.startWorkflowRun(params),\n      };\n    }\n  }\n\n  private outboundMetadata(extra?: Record<string, unknown>): Record<string, unknown> {\n    return {\n      accountId: this.deps.accountId,\n      threadId: this.deps.threadId,\n      ...extra,\n    };\n  }\n\n  // === Reply API ===\n\n  async reply(text: string, options?: ReplyOptions): Promise<void> {\n    await this.deps.replyHandler(text, options);\n  }\n\n  async replyComponent(component: UIComponent): Promise<void> {\n    if (this.deps.componentHandler) {\n      await this.deps.componentHandler(component);\n    } else {\n      // Fallback to text representation\n      await this.reply(this.renderComponentAsText(component));\n    }\n  }\n\n  async setTyping(typing: boolean): Promise<void> {\n    if (this.deps.typingHandler) {\n      await this.deps.typingHandler(typing);\n    }\n  }\n\n  // === Session Management ===\n\n  async getSession(): Promise<AgentMessage[]> {\n    return this.deps.sessionStore.load(this.sessionKey);\n  }\n\n  async resetSession(): Promise<void> {\n    if (this.deps.resetSession) {\n      await this.deps.resetSession(this.sessionKey);\n    } else if (typeof this.deps.sessionStore.reset === 'function') {\n      const outcome = await this.deps.sessionStore.reset(this.sessionKey);\n      if (!outcome) {\n        throw new Error('Session not found');\n      }\n      this.deps.invalidateAgentSession?.(this.sessionKey);\n    } else {\n      await this.clearSession();\n      return;\n    }\n\n    await this.deps.bus.publishOutbound({\n      channel: this.source,\n      chat_id: this.chatId,\n      content: '✅ New session started. Previous transcript archived; model and session overrides kept.',\n      type: 'message',\n      metadata: this.outboundMetadata(),\n    });\n\n    log.info({ sessionKey: this.sessionKey }, 'Session reset');\n  }\n\n  async clearSession(): Promise<void> {\n    // Archive first if has messages\n    const messages = await this.getSession();\n    if (messages.length > 0) {\n      await this.deps.sessionStore.archive(this.sessionKey);\n      log.info({ sessionKey: this.sessionKey, messageCount: messages.length }, 'Session archived');\n    }\n\n    // Delete session\n    await this.deps.sessionStore.deleteSession(this.sessionKey);\n    this.deps.invalidateAgentSession?.(this.sessionKey);\n\n    // Publish outbound message to confirm\n    await this.deps.bus.publishOutbound({\n      channel: this.source,\n      chat_id: this.chatId,\n      content: '✅ Session cleared.',\n      type: 'message',\n      metadata: this.outboundMetadata(),\n    });\n\n    log.info({ sessionKey: this.sessionKey }, 'Session cleared');\n  }\n\n  async archiveSession(): Promise<void> {\n    await this.deps.sessionStore.archive(this.sessionKey);\n    log.info({ sessionKey: this.sessionKey }, 'Session archived');\n  }\n\n  async listSessions(): Promise<SessionInfo[]> {\n    // TODO: Implement listSessions in SessionStore\n    // For now, return current session only\n    const messages = await this.getSession();\n    return [{\n      key: this.sessionKey,\n      name: getSessionDisplayName(this.sessionKey),\n      messageCount: messages.length,\n      createdAt: new Date(),\n      updatedAt: new Date(),\n      isActive: true,\n    }];\n  }\n\n  async switchSession(sessionKey: string): Promise<void> {\n    // This is mainly for CLI/Web UI where you can switch between sessions\n    // For Telegram, each chat has its own session\n    log.info({ from: this.sessionKey, to: sessionKey }, 'Session switch requested');\n    \n    // Note: In the current architecture, switching session means\n    // the next message will use a different sessionKey\n    // The actual switch happens at the adapter level\n  }\n\n  // === Model Management ===\n\n  getCurrentModel(): string {\n    if (this.deps.getCurrentModel) {\n      return this.deps.getCurrentModel();\n    }\n    \n    return getAgentDefaultModelRef(this.config);\n  }\n\n  async listModels(): Promise<ModelInfo[]> {\n    if (this.deps.listModels) {\n      return this.deps.listModels();\n    }\n    \n    // Fallback to empty list\n    return [];\n  }\n\n  async switchModel(modelId: string): Promise<boolean> {\n    if (this.deps.switchModel) {\n      return this.deps.switchModel(modelId);\n    }\n    \n    // No model manager available\n    await this.reply('❌ Model switching not available in this context.');\n    return false;\n  }\n\n  async getUsage(): Promise<UsageStats> {\n    if (this.deps.getUsage) {\n      return this.deps.getUsage();\n    }\n    \n    // Fallback: calculate from session\n    const messages = await this.getSession();\n    let promptTokens = 0;\n    let completionTokens = 0;\n    \n    for (const msg of messages) {\n      if ('usage' in msg && msg.usage) {\n        promptTokens += msg.usage.input || 0;\n        completionTokens += msg.usage.output || 0;\n      }\n    }\n    \n    return {\n      promptTokens,\n      completionTokens,\n      totalTokens: promptTokens + completionTokens,\n      messageCount: messages.length,\n    };\n  }\n\n  // === Platform Features ===\n\n  supports(feature: PlatformFeature): boolean {\n    return this.deps.supportedFeatures.includes(feature);\n  }\n\n  // === Configuration ===\n\n  getConfig(): Config {\n    return this.config;\n  }\n\n  async updateConfig(path: string, value: unknown): Promise<boolean> {\n    try {\n      // Update config object using path\n      const keys = path.split('.');\n      let target: Record<string, unknown> = this.config as Record<string, unknown>;\n      \n      for (let i = 0; i < keys.length - 1; i++) {\n        const key = keys[i];\n        if (!(key in target) || typeof target[key] !== 'object' || target[key] === null) {\n          target[key] = {};\n        }\n        target = target[key] as Record<string, unknown>;\n      }\n      \n      target[keys[keys.length - 1]] = value;\n      \n      // Save to disk\n      await saveConfig(this.config);\n      \n      log.info({ path, value }, 'Config updated via command');\n      return true;\n    } catch (error) {\n      log.error({ err: error, path, value }, 'Failed to update config');\n      return false;\n    }\n  }\n\n  // === Private Helpers ===\n\n  // === Thinking Configuration ===\n\n  /**\n   * Get the session config store (if available)\n   */\n  getSessionConfigStore(): SessionConfigStore | undefined {\n    return this.deps.sessionConfigStore;\n  }\n\n  /**\n   * Get current thinking level (session override or default)\n   */\n  async getThinkingLevel(): Promise<ThinkLevel | undefined> {\n    const configStore = this.deps.sessionConfigStore;\n    if (configStore) {\n      const sessionConfig = await configStore.get(this.sessionKey);\n      if (sessionConfig?.thinkingLevel) {\n        return sessionConfig.thinkingLevel;\n      }\n    }\n    return undefined;\n  }\n\n  /**\n   * Set thinking level for this session\n   */\n  async setThinkingLevel(level: ThinkLevel): Promise<void> {\n    const configStore = this.deps.sessionConfigStore;\n    if (configStore) {\n      await configStore.update(this.sessionKey, { thinkingLevel: level });\n    }\n    this.deps.applySessionThinkingLevel?.(this.sessionKey, level);\n  }\n\n  syncAgentThinkingLevel(level: ThinkLevel): void {\n    this.deps.applySessionThinkingLevel?.(this.sessionKey, level);\n  }\n\n  async compactSession(options?: { instructions?: string; force?: boolean }): Promise<CompactSessionResult | null> {\n    if (!this.deps.compactSession) {\n      return null;\n    }\n    const r = await this.deps.compactSession(this.sessionKey, options);\n    return {\n      compacted: r.compacted,\n      tokensBefore: r.tokensBefore,\n      tokensAfter: r.tokensAfter,\n      summary: r.summary,\n    };\n  }\n\n  async btwQuery(question: string): Promise<{ text: string; error?: string }> {\n    if (!this.deps.btwQuery) {\n      return { text: '', error: 'Side questions are not available in this environment.' };\n    }\n    return this.deps.btwQuery(this.sessionKey, question);\n  }\n\n  async exportSessionToWorkspace(format: 'markdown' | 'html' | 'json'): Promise<{ path: string }> {\n    const exportFmt = format === 'json' ? 'json' : 'markdown';\n    let body = await this.deps.sessionStore.exportSession(this.sessionKey, exportFmt);\n    if (format === 'html') {\n      body = wrapMarkdownExportAsHtml(`Session ${this.sessionKey}`, body);\n    }\n    const sc = this.deps.sessionConfigStore\n      ? await this.deps.sessionConfigStore.get(this.sessionKey)\n      : null;\n    const root = effectiveWorkspacePathForSession(\n      this.config,\n      this.sessionKey,\n      sc,\n      getProjectForSession(this.sessionKey),\n    );\n    const dir = join(root, 'exports');\n    await mkdir(dir, { recursive: true });\n    const safe = this.sessionKey.replace(/[^a-zA-Z0-9._-]+/g, '_').slice(0, 96);\n    const ext = format === 'json' ? 'json' : format === 'html' ? 'html' : 'md';\n    const name = `session-${safe}-${Date.now()}.${ext}`;\n    const outPath = join(dir, name);\n    await writeFile(outPath, body, 'utf-8');\n    return { path: outPath };\n  }\n\n  async agentContextReport(mode: 'list' | 'detail' | 'json' = 'list'): Promise<string> {\n    if (!this.deps.getSessionContextReport) {\n      return 'Context report is not available in this environment.';\n    }\n    return this.deps.getSessionContextReport(this.sessionKey, mode);\n  }\n\n  /**\n   * Get current reasoning level (session override or default)\n   */\n  async getReasoningLevel(): Promise<ReasoningLevel | undefined> {\n    const configStore = this.deps.sessionConfigStore;\n    if (configStore) {\n      const sessionConfig = await configStore.get(this.sessionKey);\n      if (sessionConfig?.reasoningLevel) {\n        return sessionConfig.reasoningLevel;\n      }\n    }\n    return undefined;\n  }\n\n  /**\n   * Set reasoning level for this session\n   */\n  async setReasoningLevel(level: ReasoningLevel): Promise<void> {\n    const configStore = this.deps.sessionConfigStore;\n    if (configStore) {\n      await configStore.update(this.sessionKey, { reasoningLevel: level });\n    }\n  }\n\n  /**\n   * Get current verbose level (session override or default)\n   */\n  async getVerboseLevel(): Promise<VerboseLevel | undefined> {\n    const configStore = this.deps.sessionConfigStore;\n    if (configStore) {\n      const sessionConfig = await configStore.get(this.sessionKey);\n      if (sessionConfig?.verboseLevel) {\n        return sessionConfig.verboseLevel;\n      }\n    }\n    return undefined;\n  }\n\n  /**\n   * Set verbose level for this session\n   */\n  async setVerboseLevel(level: VerboseLevel): Promise<void> {\n    const configStore = this.deps.sessionConfigStore;\n    if (configStore) {\n      await configStore.update(this.sessionKey, { verboseLevel: level });\n    }\n  }\n\n  private renderComponentAsText(component: UIComponent): string {\n    switch (component.type) {\n      case 'buttons':\n        return component.buttons.map(b => `[${b.text}]`).join(' ');\n      \n      case 'select':\n        return component.options.map(o => `- ${o.label}`).join('\\n');\n      \n      case 'model-picker':\n        return component.providers.map(p => \n          `**${p.name}**\\n${p.models.map(m => `  - ${m.name}`).join('\\n')}`\n        ).join('\\n\\n');\n      \n      case 'usage-display':\n        return `📊 Usage Stats:\\n` +\n          `📥 Prompt: ${component.stats.promptTokens.toLocaleString()} tokens\\n` +\n          `📤 Completion: ${component.stats.completionTokens.toLocaleString()} tokens\\n` +\n          `📊 Total: ${component.stats.totalTokens.toLocaleString()} tokens`;\n      \n      case 'session-list':\n        return component.sessions.map(s => \n          `${s.isActive ? '▶️' : '  '} ${s.key} (${s.messageCount} messages)`\n        ).join('\\n');\n      \n      case 'text-input':\n        return component.placeholder || 'Enter text...';\n      \n      default:\n        return '[UI Component]';\n    }\n  }\n}\n\n/**\n * Create a command context from dependencies\n */\nexport function createCommandContext(deps: CommandContextDeps): CommandContext {\n  return new CommandContextImpl(deps);\n}\n"],"mappings":"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"}
+{"version":3,"file":"context.js","names":[],"sources":["../../../src/chat-commands/context.ts"],"sourcesContent":["/**\n * Command Context Implementation\n * \n * Provides the concrete implementation of CommandContext interface,\n * bridging commands to core services (AgentService, SessionStore, etc.)\n */\n\nimport type {\n  CommandContext,\n  ReplyOptions,\n  UIComponent,\n  SessionInfo,\n  ModelInfo,\n  UsageStats,\n  PlatformFeature,\n  MessageSource,\n  CompactSessionResult,\n} from './types.js';\nimport { getSessionDisplayName } from './session-key.js';\nimport type { Config } from '../config/schema.js';\nimport { getAgentDefaultModelRef } from '../config/schema.js';\nimport type { AgentMessage } from '@earendil-works/pi-agent-core';\nimport type { MessageBus } from '../infra/bus/index.js';\nimport type { SessionStore, SessionConfigStore } from '../session/index.js';\nimport { createLogger } from '../utils/logger.js';\nimport { saveConfig } from '../config/loader.js';\nimport type { ThinkLevel, ReasoningLevel, VerboseLevel } from '../agent/transcript/thinking-types.js';\nimport { mkdir, writeFile } from 'fs/promises';\nimport { join } from 'path';\nimport { effectiveWorkspacePathForSession } from '../session/session-workspace.js';\nimport { wrapMarkdownExportAsHtml } from '../session/chat-export.js';\nimport type { CompactionResult } from '../agent/memory/compaction.js';\nimport type { PersistentGoalApis } from '../agent/goals/persistent-goal-apis.js';\nimport type { WorkflowRunServiceLike } from '../workflows/service/workflow-run-service.types.js';\nimport { getProjectForSession } from '../projects/workspace.js';\n\nconst log = createLogger('CommandContext');\n\nexport interface CommandContextDeps {\n  sessionKey: string;\n  source: MessageSource;\n  channelId: string;\n  chatId: string;\n  senderId: string;\n  isGroup: boolean;\n  accountId?: string;\n  threadId?: string;\n  config: Config;\n  bus: MessageBus;\n  sessionStore: SessionStore;\n  sessionConfigStore?: SessionConfigStore;\n  /** After persisting session thinking, sync pi-agent in-memory state */\n  applySessionThinkingLevel?: (sessionKey: string, level: ThinkLevel) => void;\n  // Callbacks for platform-specific operations\n  replyHandler: (text: string, options?: ReplyOptions) => Promise<void>;\n  componentHandler?: (component: UIComponent) => Promise<void>;\n  typingHandler?: (typing: boolean) => Promise<void>;\n  supportedFeatures: PlatformFeature[];\n  /** Called after session files are removed so in-memory agents match disk */\n  invalidateAgentSession?: (sessionKey: string) => void;\n  /** Reset session in place (archive + new session id); optional — falls back to clearSession */\n  resetSession?: (sessionKey: string) => Promise<void>;\n  // Model management (optional, will be injected)\n  getCurrentModel?: () => string;\n  switchModel?: (modelId: string) => Promise<boolean>;\n  listModels?: () => Promise<ModelInfo[]>;\n  getUsage?: () => Promise<UsageStats>;\n  /** Stop current LLM turn and clear channel preview stream (Telegram draft, etc.) */\n  abortCurrentTurn?: () => Promise<void>;\n  /** Reload skills from disk and refresh active agent prompts. */\n  reloadSkills?: () => Promise<void>;\n  /** Install a managed skill from an explicit source and refresh active agent prompts. */\n  installSkillFromSource?: CommandContext['installSkillFromSource'];\n\n  compactSession?: (\n    sessionKey: string,\n    options?: { instructions?: string; force?: boolean },\n  ) => Promise<CompactionResult>;\n\n  btwQuery?: (sessionKey: string, question: string) => Promise<{ text: string; error?: string }>;\n\n  getSessionContextReport?: (\n    sessionKey: string,\n    mode: 'list' | 'detail' | 'json',\n  ) => Promise<string>;\n\n  persistentGoalApis?: PersistentGoalApis;\n  workflowRunService?: WorkflowRunServiceLike;\n}\n\nexport class CommandContextImpl implements CommandContext {\n  readonly sessionKey: string;\n  readonly source: MessageSource;\n  readonly channelId: string;\n  readonly chatId: string;\n  readonly senderId: string;\n  readonly isGroup: boolean;\n  readonly accountId?: string;\n  readonly threadId?: string;\n  readonly config: Config;\n  readonly abortCurrentTurn?: () => Promise<void>;\n  readonly reloadSkills?: () => Promise<void>;\n  readonly installSkillFromSource?: CommandContext['installSkillFromSource'];\n  readonly persistentGoalApis?: PersistentGoalApis;\n  readonly workflowRunApis?: CommandContext['workflowRunApis'];\n\n  private deps: CommandContextDeps;\n\n  constructor(deps: CommandContextDeps) {\n    this.sessionKey = deps.sessionKey;\n    this.source = deps.source;\n    this.channelId = deps.channelId;\n    this.chatId = deps.chatId;\n    this.senderId = deps.senderId;\n    this.isGroup = deps.isGroup;\n    this.accountId = deps.accountId;\n    this.threadId = deps.threadId;\n    this.config = deps.config;\n    this.deps = deps;\n\n    if (deps.abortCurrentTurn) {\n      const run = deps.abortCurrentTurn;\n      this.abortCurrentTurn = async () => {\n        await run();\n      };\n    }\n\n    if (deps.reloadSkills) {\n      const run = deps.reloadSkills;\n      this.reloadSkills = async () => {\n        await run();\n      };\n    }\n\n    if (deps.installSkillFromSource) {\n      this.installSkillFromSource = deps.installSkillFromSource;\n    }\n\n    this.persistentGoalApis = deps.persistentGoalApis;\n    if (deps.workflowRunService) {\n      this.workflowRunApis = {\n        service: deps.workflowRunService,\n        startWorkflowRun: (params) => deps.workflowRunService!.startWorkflowRun(params),\n      };\n    }\n  }\n\n  private outboundMetadata(extra?: Record<string, unknown>): Record<string, unknown> {\n    return {\n      accountId: this.deps.accountId,\n      threadId: this.deps.threadId,\n      ...extra,\n    };\n  }\n\n  // === Reply API ===\n\n  async reply(text: string, options?: ReplyOptions): Promise<void> {\n    await this.deps.replyHandler(text, options);\n  }\n\n  async replyComponent(component: UIComponent): Promise<void> {\n    if (this.deps.componentHandler) {\n      await this.deps.componentHandler(component);\n    } else {\n      // Fallback to text representation\n      await this.reply(this.renderComponentAsText(component));\n    }\n  }\n\n  async setTyping(typing: boolean): Promise<void> {\n    if (this.deps.typingHandler) {\n      await this.deps.typingHandler(typing);\n    }\n  }\n\n  // === Session Management ===\n\n  async getSession(): Promise<AgentMessage[]> {\n    return this.deps.sessionStore.load(this.sessionKey);\n  }\n\n  async resetSession(): Promise<void> {\n    if (this.deps.resetSession) {\n      await this.deps.resetSession(this.sessionKey);\n    } else if (typeof this.deps.sessionStore.reset === 'function') {\n      const outcome = await this.deps.sessionStore.reset(this.sessionKey);\n      if (!outcome) {\n        throw new Error('Session not found');\n      }\n      this.deps.invalidateAgentSession?.(this.sessionKey);\n    } else {\n      await this.clearSession();\n      return;\n    }\n\n    await this.deps.bus.publishOutbound({\n      channel: this.source,\n      chat_id: this.chatId,\n      content: '✅ New session started. Previous transcript archived; model and session overrides kept.',\n      type: 'message',\n      metadata: this.outboundMetadata(),\n    });\n\n    log.info({ sessionKey: this.sessionKey }, 'Session reset');\n  }\n\n  async clearSession(): Promise<void> {\n    // Archive first if has messages\n    const messages = await this.getSession();\n    if (messages.length > 0) {\n      await this.deps.sessionStore.archive(this.sessionKey);\n      log.info({ sessionKey: this.sessionKey, messageCount: messages.length }, 'Session archived');\n    }\n\n    // Delete session\n    await this.deps.sessionStore.deleteSession(this.sessionKey);\n    this.deps.invalidateAgentSession?.(this.sessionKey);\n\n    // Publish outbound message to confirm\n    await this.deps.bus.publishOutbound({\n      channel: this.source,\n      chat_id: this.chatId,\n      content: '✅ Session cleared.',\n      type: 'message',\n      metadata: this.outboundMetadata(),\n    });\n\n    log.info({ sessionKey: this.sessionKey }, 'Session cleared');\n  }\n\n  async archiveSession(): Promise<void> {\n    await this.deps.sessionStore.archive(this.sessionKey);\n    log.info({ sessionKey: this.sessionKey }, 'Session archived');\n  }\n\n  async listSessions(): Promise<SessionInfo[]> {\n    // TODO: Implement listSessions in SessionStore\n    // For now, return current session only\n    const messages = await this.getSession();\n    return [{\n      key: this.sessionKey,\n      name: getSessionDisplayName(this.sessionKey),\n      messageCount: messages.length,\n      createdAt: new Date(),\n      updatedAt: new Date(),\n      isActive: true,\n    }];\n  }\n\n  async switchSession(sessionKey: string): Promise<void> {\n    // This is mainly for CLI/Web UI where you can switch between sessions\n    // For Telegram, each chat has its own session\n    log.info({ from: this.sessionKey, to: sessionKey }, 'Session switch requested');\n    \n    // Note: In the current architecture, switching session means\n    // the next message will use a different sessionKey\n    // The actual switch happens at the adapter level\n  }\n\n  // === Model Management ===\n\n  getCurrentModel(): string {\n    if (this.deps.getCurrentModel) {\n      return this.deps.getCurrentModel();\n    }\n    \n    return getAgentDefaultModelRef(this.config);\n  }\n\n  async listModels(): Promise<ModelInfo[]> {\n    if (this.deps.listModels) {\n      return this.deps.listModels();\n    }\n    \n    // Fallback to empty list\n    return [];\n  }\n\n  async switchModel(modelId: string): Promise<boolean> {\n    if (this.deps.switchModel) {\n      return this.deps.switchModel(modelId);\n    }\n    \n    // No model manager available\n    await this.reply('❌ Model switching not available in this context.');\n    return false;\n  }\n\n  async getUsage(): Promise<UsageStats> {\n    if (this.deps.getUsage) {\n      return this.deps.getUsage();\n    }\n    \n    // Fallback: calculate from session\n    const messages = await this.getSession();\n    let promptTokens = 0;\n    let completionTokens = 0;\n    \n    for (const msg of messages) {\n      if ('usage' in msg && msg.usage) {\n        promptTokens += msg.usage.input || 0;\n        completionTokens += msg.usage.output || 0;\n      }\n    }\n    \n    return {\n      promptTokens,\n      completionTokens,\n      totalTokens: promptTokens + completionTokens,\n      messageCount: messages.length,\n    };\n  }\n\n  // === Platform Features ===\n\n  supports(feature: PlatformFeature): boolean {\n    return this.deps.supportedFeatures.includes(feature);\n  }\n\n  // === Configuration ===\n\n  getConfig(): Config {\n    return this.config;\n  }\n\n  async updateConfig(path: string, value: unknown): Promise<boolean> {\n    try {\n      // Update config object using path\n      const keys = path.split('.');\n      let target: Record<string, unknown> = this.config as Record<string, unknown>;\n      \n      for (let i = 0; i < keys.length - 1; i++) {\n        const key = keys[i];\n        if (!(key in target) || typeof target[key] !== 'object' || target[key] === null) {\n          target[key] = {};\n        }\n        target = target[key] as Record<string, unknown>;\n      }\n      \n      target[keys[keys.length - 1]] = value;\n      \n      // Save to disk\n      await saveConfig(this.config);\n      \n      log.info({ path, value }, 'Config updated via command');\n      return true;\n    } catch (error) {\n      log.error({ err: error, path, value }, 'Failed to update config');\n      return false;\n    }\n  }\n\n  // === Private Helpers ===\n\n  // === Thinking Configuration ===\n\n  /**\n   * Get the session config store (if available)\n   */\n  getSessionConfigStore(): SessionConfigStore | undefined {\n    return this.deps.sessionConfigStore;\n  }\n\n  /**\n   * Get current thinking level (session override or default)\n   */\n  async getThinkingLevel(): Promise<ThinkLevel | undefined> {\n    const configStore = this.deps.sessionConfigStore;\n    if (configStore) {\n      const sessionConfig = await configStore.get(this.sessionKey);\n      if (sessionConfig?.thinkingLevel) {\n        return sessionConfig.thinkingLevel;\n      }\n    }\n    return undefined;\n  }\n\n  /**\n   * Set thinking level for this session\n   */\n  async setThinkingLevel(level: ThinkLevel): Promise<void> {\n    const configStore = this.deps.sessionConfigStore;\n    if (configStore) {\n      await configStore.update(this.sessionKey, { thinkingLevel: level });\n    }\n    this.deps.applySessionThinkingLevel?.(this.sessionKey, level);\n  }\n\n  syncAgentThinkingLevel(level: ThinkLevel): void {\n    this.deps.applySessionThinkingLevel?.(this.sessionKey, level);\n  }\n\n  async compactSession(options?: { instructions?: string; force?: boolean }): Promise<CompactSessionResult | null> {\n    if (!this.deps.compactSession) {\n      return null;\n    }\n    const r = await this.deps.compactSession(this.sessionKey, options);\n    return {\n      compacted: r.compacted,\n      tokensBefore: r.tokensBefore,\n      tokensAfter: r.tokensAfter,\n      summary: r.summary,\n    };\n  }\n\n  async btwQuery(question: string): Promise<{ text: string; error?: string }> {\n    if (!this.deps.btwQuery) {\n      return { text: '', error: 'Side questions are not available in this environment.' };\n    }\n    return this.deps.btwQuery(this.sessionKey, question);\n  }\n\n  async exportSessionToWorkspace(format: 'markdown' | 'html' | 'json'): Promise<{ path: string }> {\n    const exportFmt = format === 'json' ? 'json' : 'markdown';\n    let body = await this.deps.sessionStore.exportSession(this.sessionKey, exportFmt);\n    if (format === 'html') {\n      body = wrapMarkdownExportAsHtml(`Session ${this.sessionKey}`, body);\n    }\n    const sc = this.deps.sessionConfigStore\n      ? await this.deps.sessionConfigStore.get(this.sessionKey)\n      : null;\n    const root = effectiveWorkspacePathForSession(\n      this.config,\n      this.sessionKey,\n      sc,\n      getProjectForSession(this.sessionKey),\n    );\n    const dir = join(root, 'exports');\n    await mkdir(dir, { recursive: true });\n    const safe = this.sessionKey.replace(/[^a-zA-Z0-9._-]+/g, '_').slice(0, 96);\n    const ext = format === 'json' ? 'json' : format === 'html' ? 'html' : 'md';\n    const name = `session-${safe}-${Date.now()}.${ext}`;\n    const outPath = join(dir, name);\n    await writeFile(outPath, body, 'utf-8');\n    return { path: outPath };\n  }\n\n  async agentContextReport(mode: 'list' | 'detail' | 'json' = 'list'): Promise<string> {\n    if (!this.deps.getSessionContextReport) {\n      return 'Context report is not available in this environment.';\n    }\n    return this.deps.getSessionContextReport(this.sessionKey, mode);\n  }\n\n  /**\n   * Get current reasoning level (session override or default)\n   */\n  async getReasoningLevel(): Promise<ReasoningLevel | undefined> {\n    const configStore = this.deps.sessionConfigStore;\n    if (configStore) {\n      const sessionConfig = await configStore.get(this.sessionKey);\n      if (sessionConfig?.reasoningLevel) {\n        return sessionConfig.reasoningLevel;\n      }\n    }\n    return undefined;\n  }\n\n  /**\n   * Set reasoning level for this session\n   */\n  async setReasoningLevel(level: ReasoningLevel): Promise<void> {\n    const configStore = this.deps.sessionConfigStore;\n    if (configStore) {\n      await configStore.update(this.sessionKey, { reasoningLevel: level });\n    }\n  }\n\n  /**\n   * Get current verbose level (session override or default)\n   */\n  async getVerboseLevel(): Promise<VerboseLevel | undefined> {\n    const configStore = this.deps.sessionConfigStore;\n    if (configStore) {\n      const sessionConfig = await configStore.get(this.sessionKey);\n      if (sessionConfig?.verboseLevel) {\n        return sessionConfig.verboseLevel;\n      }\n    }\n    return undefined;\n  }\n\n  /**\n   * Set verbose level for this session\n   */\n  async setVerboseLevel(level: VerboseLevel): Promise<void> {\n    const configStore = this.deps.sessionConfigStore;\n    if (configStore) {\n      await configStore.update(this.sessionKey, { verboseLevel: level });\n    }\n  }\n\n  private renderComponentAsText(component: UIComponent): string {\n    switch (component.type) {\n      case 'buttons':\n        return component.buttons.map(b => `[${b.text}]`).join(' ');\n      \n      case 'select':\n        return component.options.map(o => `- ${o.label}`).join('\\n');\n      \n      case 'model-picker':\n        return component.providers.map(p => \n          `**${p.name}**\\n${p.models.map(m => `  - ${m.name}`).join('\\n')}`\n        ).join('\\n\\n');\n      \n      case 'usage-display':\n        return `📊 Usage Stats:\\n` +\n          `📥 Prompt: ${component.stats.promptTokens.toLocaleString()} tokens\\n` +\n          `📤 Completion: ${component.stats.completionTokens.toLocaleString()} tokens\\n` +\n          `📊 Total: ${component.stats.totalTokens.toLocaleString()} tokens`;\n      \n      case 'session-list':\n        return component.sessions.map(s => \n          `${s.isActive ? '▶️' : '  '} ${s.key} (${s.messageCount} messages)`\n        ).join('\\n');\n      \n      case 'text-input':\n        return component.placeholder || 'Enter text...';\n      \n      default:\n        return '[UI Component]';\n    }\n  }\n}\n\n/**\n * Create a command context from dependencies\n */\nexport function createCommandContext(deps: CommandContextDeps): CommandContext {\n  return new CommandContextImpl(deps);\n}\n"],"mappings":"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"}

package/dist/src/chat-commands/index.d.ts

@@ -21,6 +21,7 @@ export { registerGoalCommand } from './builtins/goal.js';
 export { registerSubgoalCommand } from './builtins/subgoal.js';
 export { registerWorkflowCommands } from './builtins/workflow.js';
 export { registerReviewCommand } from './builtins/review.js';
+export { registerSkillCommand } from './builtins/skill.js';
 export { registerAgentEditCommand } from './agent-edit.js';
 /**
  * Initialize the command system with all built-in commands

package/dist/src/chat-commands/index.js

@@ -12,6 +12,7 @@ import { registerGoalCommand } from "./builtins/goal.js";
 import { registerSubgoalCommand } from "./builtins/subgoal.js";
 import { registerWorkflowCommands } from "./builtins/workflow.js";
 import { registerReviewCommand } from "./builtins/review.js";
+import { registerSkillCommand } from "./builtins/skill.js";
 import { registerAgentEditCommand } from "./agent-edit.js";
 import { CommandContextImpl, createCommandContext } from "./context.js";
 //#region src/chat-commands/index.ts
@@ -36,9 +37,10 @@ function initializeCommands() {
 	registerSubgoalCommand();
 	registerWorkflowCommands();
 	registerReviewCommand();
+	registerSkillCommand();
 	registerAgentEditCommand();
 }
 //#endregion
-export { CommandContextImpl, CommandRegistry, commandRegistry, createCommandContext, generateSessionKey, getSessionDisplayName, initializeCommands, normalizeTelegramCommandName, parseSlashCommand, registerAgentEditCommand, registerConfigCommand, registerContextCommands, registerGoalCommand, registerModelCommands, registerReviewCommand, registerSessionCommands, registerSubgoalCommand, registerSystemCommands, registerTTSCommands, registerThinkingCommands, registerWorkflowCommands };
+export { CommandContextImpl, CommandRegistry, commandRegistry, createCommandContext, generateSessionKey, getSessionDisplayName, initializeCommands, normalizeTelegramCommandName, parseSlashCommand, registerAgentEditCommand, registerConfigCommand, registerContextCommands, registerGoalCommand, registerModelCommands, registerReviewCommand, registerSessionCommands, registerSkillCommand, registerSubgoalCommand, registerSystemCommands, registerTTSCommands, registerThinkingCommands, registerWorkflowCommands };
 
 //# sourceMappingURL=index.js.map

package/dist/src/chat-commands/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../src/chat-commands/index.ts"],"sourcesContent":["/**\n * Unified Command System\n *\n * Provides a platform-agnostic command system that works across\n * Telegram, Feishu, Web UI, CLI, and other channel surfaces.\n */\n\n// Built-in Commands (import first to avoid circular deps)\nimport { registerSessionCommands } from './builtins/session.js';\nimport { registerModelCommands } from './builtins/model.js';\nimport { registerSystemCommands } from './builtins/system.js';\nimport { registerTTSCommands } from './builtins/tts.js';\nimport { registerThinkingCommands } from './builtins/thinking.js';\nimport { registerConfigCommand } from './builtins/config.js';\nimport { registerContextCommands } from './builtins/context.js';\nimport { registerGoalCommand } from './builtins/goal.js';\nimport { registerSubgoalCommand } from './builtins/subgoal.js';\nimport { registerWorkflowCommands } from './builtins/workflow.js';\nimport { registerReviewCommand } from './builtins/review.js';\nimport { registerAgentEditCommand } from './agent-edit.js';\n\n// Types\nexport type {\n  MessageSource,\n  UnifiedMessage,\n  PlatformMetadata,\n  MessageAttachment,\n  CommandDefinition,\n  CommandCategory,\n  CommandScope,\n  CommandHandler,\n  CommandResult,\n  CommandContext,\n  ReplyOptions,\n  UIComponent,\n  ButtonGroup,\n  SelectMenu,\n  ModelPicker,\n  UsageDisplay,\n  SessionList,\n  TextInput,\n  ProviderInfo,\n  ModelInfo,\n  UsageStats,\n  SessionInfo,\n  PlatformFeature,\n  ChannelAdapter,\n  ReplyPayload,\n} from './types.js';\n\n// Session display helpers\nexport { generateSessionKey, getSessionDisplayName, type SessionKeyContext } from './session-key.js';\n\n// Command parsing helpers\nexport { normalizeTelegramCommandName, parseSlashCommand } from './command-parse.js';\n\n// Registry\nexport { CommandRegistry, commandRegistry } from './registry.js';\nexport type { CommandRegistry as CommandRegistryType } from './types.js';\n\n// Context\nexport { CommandContextImpl, createCommandContext } from './context.js';\n\n// Built-in Commands\nexport { registerSessionCommands } from './builtins/session.js';\nexport { registerModelCommands } from './builtins/model.js';\nexport { registerSystemCommands } from './builtins/system.js';\nexport { registerTTSCommands } from './builtins/tts.js';\nexport { registerThinkingCommands } from './builtins/thinking.js';\nexport { registerConfigCommand } from './builtins/config.js';\nexport { registerContextCommands } from './builtins/context.js';\nexport { registerGoalCommand } from './builtins/goal.js';\nexport { registerSubgoalCommand } from './builtins/subgoal.js';\nexport { registerWorkflowCommands } from './builtins/workflow.js';\nexport { registerReviewCommand } from './builtins/review.js';\nexport { registerAgentEditCommand } from './agent-edit.js';\n\n/**\n * Initialize the command system with all built-in commands\n */\nexport function initializeCommands(): void {\n  registerSessionCommands();\n  registerModelCommands();\n  registerSystemCommands();\n  registerConfigCommand();\n  registerContextCommands();\n  registerTTSCommands();\n  registerThinkingCommands();\n  registerGoalCommand();\n  registerSubgoalCommand();\n  registerWorkflowCommands();\n  registerReviewCommand();\n  registerAgentEditCommand();\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAgFA,SAAgB,qBAA2B;AACzC,0BAAyB;AACzB,wBAAuB;AACvB,yBAAwB;AACxB,wBAAuB;AACvB,0BAAyB;AACzB,sBAAqB;AACrB,2BAA0B;AAC1B,sBAAqB;AACrB,yBAAwB;AACxB,2BAA0B;AAC1B,wBAAuB;AACvB,2BAA0B"}
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/chat-commands/index.ts"],"sourcesContent":["/**\n * Unified Command System\n *\n * Provides a platform-agnostic command system that works across\n * Telegram, Feishu, Web UI, CLI, and other channel surfaces.\n */\n\n// Built-in Commands (import first to avoid circular deps)\nimport { registerSessionCommands } from './builtins/session.js';\nimport { registerModelCommands } from './builtins/model.js';\nimport { registerSystemCommands } from './builtins/system.js';\nimport { registerTTSCommands } from './builtins/tts.js';\nimport { registerThinkingCommands } from './builtins/thinking.js';\nimport { registerConfigCommand } from './builtins/config.js';\nimport { registerContextCommands } from './builtins/context.js';\nimport { registerGoalCommand } from './builtins/goal.js';\nimport { registerSubgoalCommand } from './builtins/subgoal.js';\nimport { registerWorkflowCommands } from './builtins/workflow.js';\nimport { registerReviewCommand } from './builtins/review.js';\nimport { registerSkillCommand } from './builtins/skill.js';\nimport { registerAgentEditCommand } from './agent-edit.js';\n\n// Types\nexport type {\n  MessageSource,\n  UnifiedMessage,\n  PlatformMetadata,\n  MessageAttachment,\n  CommandDefinition,\n  CommandCategory,\n  CommandScope,\n  CommandHandler,\n  CommandResult,\n  CommandContext,\n  ReplyOptions,\n  UIComponent,\n  ButtonGroup,\n  SelectMenu,\n  ModelPicker,\n  UsageDisplay,\n  SessionList,\n  TextInput,\n  ProviderInfo,\n  ModelInfo,\n  UsageStats,\n  SessionInfo,\n  PlatformFeature,\n  ChannelAdapter,\n  ReplyPayload,\n} from './types.js';\n\n// Session display helpers\nexport { generateSessionKey, getSessionDisplayName, type SessionKeyContext } from './session-key.js';\n\n// Command parsing helpers\nexport { normalizeTelegramCommandName, parseSlashCommand } from './command-parse.js';\n\n// Registry\nexport { CommandRegistry, commandRegistry } from './registry.js';\nexport type { CommandRegistry as CommandRegistryType } from './types.js';\n\n// Context\nexport { CommandContextImpl, createCommandContext } from './context.js';\n\n// Built-in Commands\nexport { registerSessionCommands } from './builtins/session.js';\nexport { registerModelCommands } from './builtins/model.js';\nexport { registerSystemCommands } from './builtins/system.js';\nexport { registerTTSCommands } from './builtins/tts.js';\nexport { registerThinkingCommands } from './builtins/thinking.js';\nexport { registerConfigCommand } from './builtins/config.js';\nexport { registerContextCommands } from './builtins/context.js';\nexport { registerGoalCommand } from './builtins/goal.js';\nexport { registerSubgoalCommand } from './builtins/subgoal.js';\nexport { registerWorkflowCommands } from './builtins/workflow.js';\nexport { registerReviewCommand } from './builtins/review.js';\nexport { registerSkillCommand } from './builtins/skill.js';\nexport { registerAgentEditCommand } from './agent-edit.js';\n\n/**\n * Initialize the command system with all built-in commands\n */\nexport function initializeCommands(): void {\n  registerSessionCommands();\n  registerModelCommands();\n  registerSystemCommands();\n  registerConfigCommand();\n  registerContextCommands();\n  registerTTSCommands();\n  registerThinkingCommands();\n  registerGoalCommand();\n  registerSubgoalCommand();\n  registerWorkflowCommands();\n  registerReviewCommand();\n  registerSkillCommand();\n  registerAgentEditCommand();\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;AAkFA,SAAgB,qBAA2B;AACzC,0BAAyB;AACzB,wBAAuB;AACvB,yBAAwB;AACxB,wBAAuB;AACvB,0BAAyB;AACzB,sBAAqB;AACrB,2BAA0B;AAC1B,sBAAqB;AACrB,yBAAwB;AACxB,2BAA0B;AAC1B,wBAAuB;AACvB,uBAAsB;AACtB,2BAA0B"}

package/dist/src/chat-commands/types.d.ts

@@ -157,6 +157,23 @@ export interface CommandContext {
     updateConfig?(path: string, value: unknown): Promise<boolean>;
     /** Reload skills from disk and refresh active agent prompts. */
     reloadSkills?(): Promise<void>;
+    /** Install a managed skill from an explicit source and refresh active agent prompts. */
+    installSkillFromSource?(opts: {
+        source: string;
+        ref?: string;
+        path?: string;
+        skillId?: string;
+        target?: 'workspace' | 'global';
+        force?: boolean;
+        strictScan?: boolean;
+    }): Promise<{
+        skillId: string;
+        path: string;
+        source: string;
+        kind: 'git' | 'archive';
+        contentHash: string;
+        target?: 'workspace' | 'global';
+    }>;
     /** Persist session thinking level and sync in-memory agent (when wired) */
     setThinkingLevel?(level: ThinkLevel): Promise<void>;
     /**

package/dist/src/cli/command-loaders.js

@@ -23,6 +23,7 @@ const REGISTRY_COMMAND_MODULES = {
 	search: () => import("./commands/search.js"),
 	auth: () => import("./commands/auth.js"),
 	skills: () => import("./commands/skills.js"),
+	connectors: () => import("./commands/connectors.js"),
 	browser: () => import("./commands/browser.js"),
 	update: () => import("./commands/update.js"),
 	logs: () => import("./commands/logs.js"),