@xopcai/xopc 0.0.213 → 0.0.214

package/dist/src/heartbeat/index.js

@@ -1,6 +1,6 @@
 import { DEFAULT_ACK_MAX_CHARS, HEARTBEAT_OK, NO_REPLY, shouldSilence, stripHeartbeatToken } from "./tokens.js";
-import { appendCronEventLines } from "./event-prompt.js";
 import { isWithinActiveHours } from "./active-hours.js";
 import { isHeartbeatContentEmpty } from "./content-check.js";
+import { appendCronEventLines } from "./event-prompt.js";
 import { createHeartbeatWake } from "./wake.js";
 export { DEFAULT_ACK_MAX_CHARS, HEARTBEAT_OK, NO_REPLY, appendCronEventLines, createHeartbeatWake, isHeartbeatContentEmpty, isWithinActiveHours, shouldSilence, stripHeartbeatToken };

package/dist/src/providers/auth-runtime/resolve-auth.js

@@ -1,5 +1,5 @@
-import { init_sync_provider_auth, resolveProviderApiKeyForAgentSync } from "../../auth/sync-provider-auth.js";
 import { getApiKeyFromEnv, init_env_keys } from "../env-keys.js";
+import { init_sync_provider_auth, resolveProviderApiKeyForAgentSync } from "../../auth/sync-provider-auth.js";
 import { getDefaultAuthProfileStore } from "./auth-profile-store.js";
 //#region src/providers/auth-runtime/resolve-auth.ts
 init_env_keys();

package/dist/src/providers/index.js

@@ -1,11 +1,11 @@
 import { __esmMin, __exportAll } from "../../_virtual/_rolldown/runtime.js";
 import { getAgentDefaultModelRef, init_schema } from "../config/schema.js";
-import { getOAuthProviderIds, init_registry } from "../auth/oauth/registry.js";
-import { hasProviderAuthOnDiskSync, init_sync_provider_auth } from "../auth/sync-provider-auth.js";
 import { PROVIDER_ENV_MAP, getApiKeyFromEnv, init_env_keys } from "./env-keys.js";
 import { init_model_ref, splitProviderModelRef } from "./model-ref.js";
 import { ModelRegistry, getModelRegistry, init_model_registry, prewarmModelRegistry, resetModelRegistry } from "./model-registry.js";
+import { getOAuthProviderIds, init_registry } from "../auth/oauth/registry.js";
 import { CredentialResolver, hasCredentials, init_credentials } from "../auth/credentials.js";
+import { hasProviderAuthOnDiskSync, init_sync_provider_auth } from "../auth/sync-provider-auth.js";
 import { EXTENSION_PROVIDER_BASE_URL, init_constants } from "./constants.js";
 import { applyOfficialModelMetadataCorrections, getSupplementalModels, init_model_supplements } from "./model-supplements.js";
 import { getProviderRegistry, init_plugin_registry } from "./plugin-registry.js";

package/dist/src/providers/model-registry.js

@@ -1,8 +1,8 @@
 import { __esmMin } from "../../_virtual/_rolldown/runtime.js";
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
-import { resolveModelsJsonPath } from "../config/paths.js";
 import { init_resolve_config_value, resolveConfigValue, resolveHeaders } from "../config/resolve-config-value.js";
+import { resolveModelsJsonPath } from "../config/paths.js";
 import { getDefaultModelValues, init_models_json, validateModelsConfig } from "../config/models-json.js";
 import { getApiKeyFromEnv, init_env_keys } from "./env-keys.js";
 import { getModelCatalogStore, init_model_catalog_store } from "./model-catalog-store.js";

package/dist/src/providers/register-runtime-providers.js

@@ -1,6 +1,6 @@
 import { __esmMin } from "../../_virtual/_rolldown/runtime.js";
-import { getOAuthProviderDefinition, init_registry } from "../auth/oauth/registry.js";
 import { getModelCatalogStore, init_model_catalog_store } from "./model-catalog-store.js";
+import { getOAuthProviderDefinition, init_registry } from "../auth/oauth/registry.js";
 import { XOPC_CLOUD_PROVIDER_ID, init_xopc_cloud_config, resolveXopcModelRouterUrl } from "./xopc-cloud-config.js";
 //#region src/providers/register-runtime-providers.ts
 function registerRuntimeProvider(modelRuntime, source) {

package/dist/src/runtime-tools/manager.js

@@ -1,5 +1,6 @@
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
+import { applyPathPrepend } from "../infra/path-prepend.js";
 import { RuntimeError } from "./errors.js";
 import { atomicInstallRuntime, extractRuntimeArchive } from "./archive.js";
 import { runRuntimeCommand } from "./command.js";
@@ -46,6 +47,40 @@ function uvExecutables(installDir) {
 		uvx: join(installDir, executableName("uvx"))
 	};
 }
+function managedNodeProbeEnvironment(executables) {
+	const env = { ...process.env };
+	applyPathPrepend(env, [dirname(executables.node ?? executables.primary)]);
+	return env;
+}
+async function probeNodePackageManagers(executables) {
+	if (!executables.npm || !executables.npx) return null;
+	const env = managedNodeProbeEnvironment(executables);
+	const [npm, npx] = await Promise.all([runRuntimeCommand({
+		command: executables.npm,
+		args: ["--version"],
+		env
+	}), runRuntimeCommand({
+		command: executables.npx,
+		args: ["--version"],
+		env
+	})]);
+	return {
+		npm,
+		npx
+	};
+}
+function packageManagerProbeFailure(name, result) {
+	if (result.ok) return null;
+	const output = result.stderr || result.stdout;
+	if (output) return `${name}: ${output}`;
+	if (result.timedOut) return `${name}: timed out`;
+	if (result.aborted) return `${name}: aborted`;
+	return `${name}: exited with code ${result.exitCode ?? "unknown"}`;
+}
+function packageManagerProbeFailureMessage(results) {
+	if (!results) return "npm or npx executable is missing";
+	return [packageManagerProbeFailure("npm", results.npm), packageManagerProbeFailure("npx", results.npx)].filter((message) => message !== null).join("; ");
+}
 function runtimeConfig(options, runtime) {
 	if (runtime === "node") return options.config.node;
 	if (runtime === "python") return options.config.python;
@@ -125,17 +160,8 @@ var ManagedRuntimeManager = class extends EventEmitter {
 			const version = parseRuntimeVersion(`${result.stdout}\n${result.stderr}`);
 			if (!result.ok || !version || !versionSatisfies(version, requestedVersion)) return null;
 			if (runtime === "node") {
-				const npm = manifest.executables.npm;
-				const npx = manifest.executables.npx;
-				if (!npm || !npx) return null;
-				const [npmProbe, npxProbe] = await Promise.all([runRuntimeCommand({
-					command: npm,
-					args: ["--version"]
-				}), runRuntimeCommand({
-					command: npx,
-					args: ["--version"]
-				})]);
-				if (!npmProbe.ok || !npxProbe.ok) return null;
+				const packageManagers = await probeNodePackageManagers(manifest.executables);
+				if (!packageManagers?.npm.ok || !packageManagers.npx.ok) return null;
 			}
 			return {
 				runtime,
@@ -271,22 +297,15 @@ var ManagedRuntimeManager = class extends EventEmitter {
 			}
 			let packageManagerVersion;
 			if (runtime === "node") {
-				const npmProbe = await runRuntimeCommand({
-					command: executables.npm,
-					args: ["--version"]
-				});
-				const npxProbe = await runRuntimeCommand({
-					command: executables.npx,
-					args: ["--version"]
-				});
-				if (!npmProbe.ok || !npxProbe.ok) {
+				const packageManagers = await probeNodePackageManagers(executables);
+				if (!packageManagers?.npm.ok || !packageManagers.npx.ok) {
 					await rm(installDir, {
 						recursive: true,
 						force: true
 					});
-					throw new RuntimeError(`Node ${version} is missing npm or npx`, "RUNTIME_PROBE_FAILED", runtime, "probe_package_manager", true);
+					throw new RuntimeError(`Node ${version} failed its npm or npx installation probe: ${packageManagerProbeFailureMessage(packageManagers)}`, "RUNTIME_PROBE_FAILED", runtime, "probe_package_manager", true);
 				}
-				packageManagerVersion = npmProbe.stdout;
+				packageManagerVersion = packageManagers.npm.stdout;
 			}
 			const now = (/* @__PURE__ */ new Date()).toISOString();
 			const manifest = {

package/dist/src/tui/tui-startup-resources.js

@@ -1,6 +1,6 @@
 import { resolveStateDir } from "../config/paths-state.js";
-import { resolveEffectiveAgentProfileForSession } from "../config/agent-profile.js";
 import { init_paths, resolveAgentProfileDir, resolveBundledSkillsDir } from "../config/paths.js";
+import { resolveEffectiveAgentProfileForSession } from "../config/agent-profile.js";
 import { resolveBootstrapFilesSync } from "../agent/bootstrap/bootstrap-files.js";
 import { createSkillConfigManager, isSkillEnabled } from "../agent/skills/config.js";
 import { loadSkills } from "../agent/skills/index.js";

package/dist/src/tui/tui.js

@@ -2,10 +2,10 @@ import { version } from "../../package.js";
 import { resolveStateDir, resolveXopcDatabasePath } from "../config/paths-state.js";
 import { parseAgentSessionKey } from "../routing/session-key-utils.js";
 import { init_agent_session_key, normalizeAgentId } from "../routing/agent-session-key.js";
-import { resolveEffectiveAgentProfileForSession } from "../config/agent-profile.js";
 import { init_paths } from "../config/paths.js";
 import { loadConfig } from "../config/loader.js";
 import { getAllModels, getAllProviders, getApiKey, init_providers, isProviderConfiguredSync } from "../providers/index.js";
+import { resolveEffectiveAgentProfileForSession } from "../config/agent-profile.js";
 import { ProjectTrustStore, hasTrustRequiringProjectResources } from "../project-trust/trust-store.js";
 import { renderWorkflowFinalSummary, renderWorkflowPanel } from "../agent/workflow/snapshot.js";
 import { ensureStarterAgentsInitialized } from "../agent/starter-agents.js";

package/dist/src/work-discovery/analyzer.js

@@ -145,12 +145,20 @@ function snapshotForModel(snapshot) {
 		})
 	};
 }
-function lowConfidenceResult(snapshot, question) {
+function defaultConversationStarter(snapshot) {
+	const name = snapshot.root.displayName;
+	const changedPathCount = snapshot.git?.changedPaths.length ?? 0;
+	if (changedPathCount > 0) return `Review the ${changedPathCount} changed ${changedPathCount === 1 ? "path" : "paths"} in ${name}, explain what work appears to be in progress, and recommend the most important next step.`;
+	if (snapshot.root.projectKind === "coding") return `Help me understand ${name}: summarize what this project does, its current state, and the most important place to start.`;
+	return `Help me understand the contents of ${name}, what appears most important right now, and where I should start.`;
+}
+function lowConfidenceResult(snapshot, question, conversationStarter) {
 	return {
 		projectSummary: snapshot.root.projectKind === "coding" ? `${snapshot.root.displayName} appears to be a software project.` : `${snapshot.root.displayName} is a local work folder.`,
 		currentState: snapshot.git?.changedPaths.length ? `${snapshot.git.changedPaths.length} changed paths were detected, but there was not enough reliable context to recommend work.` : "There was not enough recent, readable context to determine the current objective.",
 		uncertainties: ["The current objective is not explicit in the selected files."],
 		suggestions: [],
+		conversationStarter: conversationStarter?.trim().slice(0, 2e3) || defaultConversationStarter(snapshot),
 		lowConfidence: true,
 		contextQuestion: question ?? "What are you trying to move forward in this folder?"
 	};
@@ -169,7 +177,7 @@ async function analyzeWorkContext(input) {
 		content: [
 			"You help a user resume real work in one explicitly selected local folder.",
 			"Analyze only the supplied bounded snapshot. Never claim that you ran commands, tests, or inspected anything absent from it.",
-			"Return only one JSON object with projectSummary, currentState, uncertainties, suggestions, profileCandidates, workThreads, lowConfidence, and contextQuestion.",
+			"Return only one JSON object with projectSummary, currentState, uncertainties, suggestions, profileCandidates, workThreads, conversationStarter, lowConfidence, and contextQuestion.",
 			"profileCandidates contains stable, useful facts about the user inferred from the supplied project evidence. Include every distinct fact with direct support; do not pad the list.",
 			"Each profile candidate has category (role, focus, technology, workflow, or preference), statement, confidence, and evidence.",
 			"Do not infer sensitive traits, identity, health, finances, political views, or anything not directly supported by the work evidence.",
@@ -184,6 +192,8 @@ async function analyzeWorkContext(input) {
 			"verification is a short array describing how the user can tell the task is real.",
 			"Each evidence item contains an optional exact relative path from the snapshot and one concrete observation.",
 			"actionPrompt asks the assistant to investigate or continue the step; it does not silently authorize file changes.",
+			"conversationStarter is one concise, editable first-person prompt the user can send immediately. Ground it in the most important visible project or directory signal, ask the assistant to explain before acting, and never silently authorize file changes.",
+			"Always return conversationStarter, including when confidence is low.",
 			"If the current objective is unclear or fewer than three credible suggestions exist, set lowConfidence=true, return suggestions=[], and ask one concise contextQuestion.",
 			"Use Simplified Chinese for every user-facing string when the visible snapshot documents are mainly Chinese; otherwise use English.",
 			"",
@@ -209,16 +219,17 @@ async function analyzeWorkContext(input) {
 	if (!parsed) throw invalidJsonError("Analysis", response, raw);
 	if (parsed.lowConfidence === true) return {
 		modelRef,
-		result: lowConfidenceResult(input.snapshot, typeof parsed.contextQuestion === "string" ? parsed.contextQuestion.trim().slice(0, 500) : void 0)
+		result: lowConfidenceResult(input.snapshot, typeof parsed.contextQuestion === "string" ? parsed.contextQuestion.trim().slice(0, 500) : void 0, typeof parsed.conversationStarter === "string" ? parsed.conversationStarter : void 0)
 	};
 	const allowedPaths = new Set([...input.snapshot.documents.map((document) => document.relativePath), ...input.snapshot.git?.changedPaths ?? []]);
 	const allowedThreadRefs = new Set([...allowedPaths, "git://recent-state"]);
 	const suggestions = Array.isArray(parsed.suggestions) ? parsed.suggestions.map((value) => validateSuggestion(value, allowedPaths)).filter((value) => Boolean(value)) : [];
 	if (suggestions.length !== 3) return {
 		modelRef,
-		result: lowConfidenceResult(input.snapshot)
+		result: lowConfidenceResult(input.snapshot, typeof parsed.contextQuestion === "string" ? parsed.contextQuestion.trim().slice(0, 500) : void 0, typeof parsed.conversationStarter === "string" ? parsed.conversationStarter : void 0)
 	};
 	const primarySuggestion = [...suggestions].sort((a, b) => suggestionScore(b) - suggestionScore(a))[0];
+	const conversationStarter = typeof parsed.conversationStarter === "string" ? parsed.conversationStarter.trim().slice(0, 2e3) : primarySuggestion?.actionPrompt;
 	const profileCandidates = input.candidateContext?.length && Array.isArray(parsed.profileCandidates) ? parsed.profileCandidates.map((value) => validateProfileCandidate(value)).filter((value) => Boolean(value)) : [];
 	const workThreadCandidates = Array.isArray(parsed.workThreads) ? parsed.workThreads.map((value) => validateWorkThreadCandidate(value, allowedThreadRefs)).filter((value) => Boolean(value)) : [];
 	const projectSummary = typeof parsed.projectSummary === "string" ? parsed.projectSummary.trim() : "";
@@ -231,6 +242,7 @@ async function analyzeWorkContext(input) {
 			currentState: currentState.slice(0, 1200),
 			uncertainties: strings(parsed.uncertainties, 6).map((value) => value.slice(0, 500)),
 			suggestions,
+			...conversationStarter ? { conversationStarter } : {},
 			...profileCandidates.length > 0 ? { profileCandidates } : {},
 			...workThreadCandidates.length > 0 ? { workThreadCandidates } : {},
 			...primarySuggestion ? { primarySuggestionId: primarySuggestion.id } : {}

package/dist/src/work-discovery/types.d.ts

@@ -137,6 +137,7 @@ export interface WorkDiscoveryResult {
     currentState: string;
     uncertainties: string[];
     suggestions: WorkDiscoverySuggestion[];
+    conversationStarter?: string;
     discoveredProjects?: Array<{
         rootPath: string;
         displayName: string;

package/dist/src/workflows/service/workflow-run-service.js

@@ -1,6 +1,6 @@
 import { getDefaultAgentId, init_resolve_route } from "../../routing/resolve-route.js";
-import { extractProfileAgentId, resolveEffectiveAgentProfileForSession } from "../../config/agent-profile.js";
 import { init_providers, resolveModel } from "../../providers/index.js";
+import { extractProfileAgentId, resolveEffectiveAgentProfileForSession } from "../../config/agent-profile.js";
 import { TaskRepository } from "../../tasks/task-repository.js";
 import { TaskConversationRepository } from "../../tasks/task-conversation-repository.js";
 import { TaskRunRepository } from "../../tasks/task-run-repository.js";

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@xopcai/xopc",
-  "version": "0.0.213",
-  "description": "Local-first AI system that remembers context, coordinates AI, and sustains long-term progress.",
+  "version": "0.0.214",
+  "description": "Local-first personal AI assistant with reviewable user understanding, durable tasks, workflows, automations, and local or cloud models.",
   "type": "module",
   "main": "dist/src/index.js",
   "types": "dist/src/index.d.ts",
@@ -30,26 +30,26 @@
     "access": "public"
   },
   "keywords": [
-    "agent-os",
-    "ai-agent",
+    "agentic-ai",
+    "ai-agents",
+    "ai-assistant",
+    "ai-memory",
+    "automation",
     "byok",
     "cli",
-    "cron",
-    "desktop",
-    "extensions",
-    "gateway",
-    "task-loop-os",
-    "llm",
+    "desktop-app",
+    "electron",
+    "knowledge-management",
+    "local-ai",
     "local-first",
     "mcp",
-    "multi-agent",
     "ollama",
+    "open-source",
+    "personal-ai",
     "self-hosted",
-    "telegram",
-    "tui",
-    "voice-ai",
-    "weixin",
-    "workflow"
+    "task-management",
+    "typescript",
+    "workflow-automation"
   ],
   "author": "xopcai <lyxopc.ai@gmail.com>",
   "license": "MIT",
@@ -163,9 +163,9 @@
     "vitepress": "^1.6.4",
     "vitest": "4.1.5",
     "vue": "^3.5.35",
+    "@xopcai/endpoint-tools-protocol": "0.0.0",
     "@xopcai/gateway-contract": "0.0.0",
     "@xopcai/realtime-protocol": "0.0.0",
-    "@xopcai/endpoint-tools-protocol": "0.0.0",
     "@xopcai/realtime-client": "0.0.0"
   },
   "scripts": {

package/dist/gateway/static/root/assets/channels-status-swr-DeBw3du9.js

@@ -1 +0,0 @@
-import{r as e}from"./locale-store-BYSRjM6g.js";import{n as t}from"./channel-recipient-api-9uca5kDa.js";function n(){return e(`/api/channels/status`)}var r=t;export{r as n,n as t};