@aibyzero/byz 0.1.6 → 0.1.7

package/CHANGELOG.md

@@ -2,6 +2,17 @@
 
 ## Unreleased
 
+## 0.1.7 - 2026-08-29
+
+### Added
+
+- Added same-session routing and collaboration preferences that classify common requests, inject minimal per-turn guidance, and show route details only on demand.
+- Added the default BYZ conversation shell with a goal-first welcome, low-noise progress, on-demand details, and natural-language confirmation input.
+
+### Changed
+
+- Changed the default interactive shell to hide internal resources, tool rows, model metadata, and advanced controls until requested.
+
 ## 0.1.6 - 2026-08-28
 
 ### Added

package/dist/cli.js

@@ -1,5 +1,6 @@
 #!/usr/bin/env node
 
+import { createConversationExtension } from "./conversation/conversation-extension.js";
 import { createFastSessionController, prepareFastRuntimeArgs, selectFastRuntimeArgs } from "./fast.js";
 import { createPrewalkExtension } from "./prewalk.js";
 import { main } from "./runtime/bundle/index.js";
@@ -25,16 +26,6 @@ try {
 	const fastRuntime = prepareFastRuntimeArgs(args);
 	const parsedWorkflow = parseWorkflowOption(fastRuntime.commandArgs);
 	const commandArgs = parsedWorkflow.forwardedArgs;
-	const isRootHelp = commandArgs.length === 1 && (commandArgs[0] === "--help" || commandArgs[0] === "-h");
-	if (isRootHelp) {
-		console.error("BYZ updates: byz update (npm-managed global installations only)");
-		console.error("BYZ Fast: --fast (thinking=low; optional model: BYZ_FAST_MODEL)");
-		console.error("BYZ Prewalk: /prewalk (one-time handoff after the first successful workspace edit/write)");
-		console.error("BYZ workflows: --workflow <cm|cm-plugin|none> (default: BYZ_WORKFLOW or cm)");
-		console.error(
-			"Commands: byz workflow list | byz workflow status [cm|cm-plugin|none] | byz workflow check <cm|cm-plugin>",
-		);
-	}
 
 	if (await handleWorkflowCommand(commandArgs, { workflowId: parsedWorkflow.workflowId })) {
 		// BYZ-owned command handled without starting the Pi runtime.
@@ -47,12 +38,6 @@ try {
 			stdoutIsTTY: process.stdout.isTTY,
 		});
 		const runtimeArgs = selectFastRuntimeArgs(fastRuntime, { isInteractive, loadWorkflow });
-		if (fastRuntime.enabled && loadWorkflow && isInteractive) {
-			console.error(
-				`BYZ Fast: model=${fastRuntime.model}, thinking=${fastRuntime.thinking}, workflow=${parsedWorkflow.workflowId}`,
-			);
-		}
-
 		if (loadWorkflow && isInteractive) {
 			const parsedRuntimeWorkflow = parseWorkflowOption(runtimeArgs);
 			const resolveResources = (workflowId) =>
@@ -68,7 +53,9 @@ try {
 				initialUseLowThinking: fastRuntime.useLowThinking,
 			});
 			const prewalkExtension = createPrewalkExtension({ fastController });
+			const conversationExtension = createConversationExtension();
 			const byzExtension = (pi) => {
+				conversationExtension(pi);
 				workflowExtension(pi);
 				fastController.extension(pi);
 				prewalkExtension(pi);

package/dist/conversation/conversation-extension.js

@@ -0,0 +1,85 @@
+import { createInteractionPolicy, formatDecision, parseConversationControl } from "./interaction-policy.js";
+import { createRoutingPolicy } from "./routing-policy.js";
+
+const WELCOME = "BYZ\n\n你想让我帮你做什么？";
+
+export function createConversationExtension() {
+	const policy = createInteractionPolicy();
+	const routingPolicy = createRoutingPolicy();
+
+	return function conversationExtension(pi) {
+		let progressTimer;
+
+		function clearProgressTimer() {
+			if (progressTimer) clearTimeout(progressTimer);
+			progressTimer = undefined;
+		}
+
+		pi.on("session_start", (_event, ctx) => {
+			routingPolicy.reset();
+			ctx.ui.setTitle?.("BYZ");
+			ctx.ui.setMessagePresenter?.((message) => policy.presentAssistantMessage(message));
+			ctx.ui.setToolExecutionVisible?.(false);
+			ctx.ui.setFooter?.(() => ({
+				invalidate() {},
+				render() {
+					return [];
+				},
+			}));
+			ctx.ui.setConfirmationPresenter?.(async ({ title, message, confirm }) => {
+				const prompt = formatDecision({
+					impact: message,
+					recommendation: "确认",
+					alternative: "取消",
+					onReject: "不会执行此操作",
+				});
+				const answer = await ctx.ui.input(prompt, `${title}：输入“确认”或“取消”`);
+				const choice = answer ? parseConversationControl(answer) : undefined;
+				if (choice === "accept" || choice === "proceed") return true;
+				if (choice === "reject") return false;
+				return confirm();
+			});
+			ctx.ui.notify(WELCOME, "info");
+		});
+		pi.on("agent_start", (_event, ctx) => {
+			policy.resetProgress();
+			clearProgressTimer();
+			progressTimer = setTimeout(() => {
+				const message = policy.present("progress", "");
+				if (message) ctx.ui.setWorkingMessage?.(message);
+			}, 30_000);
+		});
+		pi.on("agent_end", () => {
+			clearProgressTimer();
+		});
+		pi.on("session_shutdown", () => {
+			routingPolicy.reset();
+			clearProgressTimer();
+		});
+		function showDetails(ctx) {
+			policy.setDetailEnabled(true);
+			ctx.ui.setToolExecutionVisible?.(true);
+			ctx.ui.notify("已展开细节。高级控制：/fast、/prewalk、/workflow。", "info");
+		}
+
+		pi.registerCommand("details", {
+			description: "Show BYZ advanced controls",
+			handler: async (_args, ctx) => showDetails(ctx),
+		});
+		pi.on("before_agent_start", async (event, ctx) => {
+			const route = routingPolicy.route(event.prompt);
+			if (route.details || parseConversationControl(event.prompt) === "detail") showDetails(ctx);
+			if (policy.isDetailEnabled()) {
+				ctx.ui.notify(
+					`当前类别：${route.kind}。当前偏好：主动程度 ${route.preferences.autonomy}，交付 ${route.preferences.delivery}。`,
+					"info",
+				);
+			}
+			return {
+				systemPrompt: `${event.systemPrompt ?? ""}\n\nBYZ collaboration guidance for this turn:\n${route.instructions}`,
+			};
+		});
+	};
+}
+
+export { WELCOME };

package/dist/conversation/interaction-policy.js

@@ -0,0 +1,53 @@
+const INTERNAL_TERMS = /\b(?:model|skill|workflow|fast|prewalk|token|tool|step\s*\d+)\b/gi;
+
+export function createInteractionPolicy() {
+	let progressShown = false;
+	let detailEnabled = false;
+
+	function present(kind, message, { detail = false } = {}) {
+		if (kind === "progress") {
+			if (progressShown) return undefined;
+			progressShown = true;
+			return "正在处理，稍后给你结果。";
+		}
+		if (kind === "advanced-control" && !detailEnabled && !detail) return undefined;
+		if (detail || detailEnabled) return message;
+		return message.replace(INTERNAL_TERMS, "内部设置");
+	}
+
+	function presentAssistantMessage(message) {
+		if (detailEnabled) return message;
+		const content = message.content
+			.filter((part) => part.type === "text")
+			.map((part) => ({ ...part, text: part.text.replace(INTERNAL_TERMS, "内部设置") }));
+		return { ...message, content };
+	}
+
+	return {
+		present,
+		presentAssistantMessage,
+		setDetailEnabled(enabled) {
+			detailEnabled = enabled;
+		},
+		isDetailEnabled() {
+			return detailEnabled;
+		},
+		resetProgress() {
+			progressShown = false;
+		},
+	};
+}
+
+export function parseConversationControl(input) {
+	const value = input.trim();
+	if (/^(展开细节|查看细节|显示细节)$/.test(value)) return "detail";
+	if (/^(少问一点|直接做)$/.test(value)) return "proceed";
+	if (/^(关键动作先问我|先问我)$/.test(value)) return "confirm";
+	if (/^(取消|不要|拒绝)$/.test(value)) return "reject";
+	if (/^(确认|继续|同意|可以)$/.test(value)) return "accept";
+	return undefined;
+}
+
+export function formatDecision({ impact, recommendation, alternative, onReject }) {
+	return `需要你决定\n影响：${impact}\n建议：${recommendation}\n其他选择：${alternative}\n如果拒绝：${onReject}`;
+}

package/dist/conversation/routing-policy.js

@@ -0,0 +1,102 @@
+const DEFAULT_PREFERENCES = Object.freeze({
+	autonomy: "balanced",
+	delivery: "normal",
+});
+
+const CONTROL_PATTERNS = [
+	[/关键动作先问我|先问我/, { autonomy: "confirm-key-actions" }],
+	[/少问一点/, { autonomy: "fewer-questions" }],
+	[/直接做/, { autonomy: "direct" }],
+	[/先给三个方向/, { delivery: "three-directions" }],
+	[/展开细节|查看细节|显示细节/, {}],
+];
+
+const FALLBACKS = Object.freeze({
+	research: {
+		missingInput: "需要可访问链接、正文、关键词或目标来源。",
+		fallback: "可先基于你提供的摘要做初步判断，或请你补充正文、截图、链接。",
+	},
+	"bug-fix": {
+		missingInput: "需要复现步骤、报错信息、相关输入或运行环境。",
+		fallback: "可先根据现象列排查清单，等你补充日志后再定位。",
+	},
+	"project-recovery": {
+		missingInput: "需要当前项目路径、上次进度、任务状态或错误现场。",
+		fallback: "可先读取本地项目状态并汇总可恢复线索。",
+	},
+	general: {
+		missingInput: "需要更明确的目标、输入材料或期望输出。",
+		fallback: "可先给出可选方向或最小可执行下一步。",
+	},
+});
+
+function classify(goal) {
+	if (/https?:\/\/|链接|帖子|查一下|调研|研究/.test(goal)) return "research";
+	if (/三个方向|创意|设计|文案|写作|起个名字/.test(goal)) return "creative";
+	if (/报错|bug|缺陷|无法复现|修复/.test(goal)) return "bug-fix";
+	if (/新功能|实现|开发|增加.*功能|添加.*功能/.test(goal)) return "feature";
+	if (/继续.*项目|恢复.*项目|上次.*停/.test(goal)) return "project-recovery";
+	return "general";
+}
+
+function instructionsFor(kind, preferences) {
+	const collaboration = [
+		preferences.autonomy === "direct" ? "在安全且可逆的范围内直接推进，不要先要求用户选择内部模式。" : undefined,
+		preferences.autonomy === "fewer-questions" ? "仅在缺少会明显改变结果的关键信息时提一个问题。" : undefined,
+		preferences.autonomy === "confirm-key-actions" ? "关键动作前说明影响并请求确认。" : undefined,
+		preferences.delivery === "three-directions" ? "先给出三个可区分的方向，再建议一个推荐方向。" : undefined,
+	].filter(Boolean);
+	const task = {
+		research: "优先说明来源是否可访问；无法取得内容时说明缺失并建议用户提供正文或替代来源。",
+		creative: "先给出可见的创作骨架或方向，避免暴露内部能力名称。",
+		"bug-fix": "先以可复现证据定位；无法复现时说明缺少的环境、输入或日志。",
+		feature: "先确认目标与范围；涉及高影响动作时保持既有确认边界。",
+		"project-recovery": "只在当前会话可见信息足够时恢复上下文；否则说明需要的项目状态。",
+		general: "直接用自然语言处理目标；资料不足时说明未完成部分和可行替代路径。",
+	}[kind];
+	return [...collaboration, task].join("\n");
+}
+
+export function classifyRequest(prompt, preferences = DEFAULT_PREFERENCES) {
+	const kind = classify(prompt.trim());
+	return {
+		fallback: FALLBACKS[kind]?.fallback,
+		instructions: instructionsFor(kind, preferences),
+		kind,
+		missingInput: FALLBACKS[kind]?.missingInput,
+	};
+}
+
+export function parseSessionPreference(input) {
+	const preferences = {};
+	const details = /展开细节|查看细节|显示细节/.test(input);
+	let goal = input;
+	for (const [pattern, changes] of CONTROL_PATTERNS) {
+		if (pattern.test(goal)) Object.assign(preferences, changes);
+		goal = goal.replace(pattern, "");
+	}
+	return { details, goal: goal.replace(/[，,。；;]+/g, " ").trim(), preferences };
+}
+
+export const parseSessionPreferences = parseSessionPreference;
+
+export function createRoutingPolicy() {
+	let preferences = { ...DEFAULT_PREFERENCES };
+
+	return {
+		route(input) {
+			const parsed = parseSessionPreference(input);
+			preferences = { ...preferences, ...parsed.preferences };
+			const route = classifyRequest(parsed.goal, preferences);
+			return {
+				...route,
+				details: parsed.details,
+				goal: parsed.goal,
+				preferences: { ...preferences },
+			};
+		},
+		reset() {
+			preferences = { ...DEFAULT_PREFERENCES };
+		},
+	};
+}