@vitos-pizza/vitos-pizza 0.1.0

package/node_modules/@vitos-pizza/session-title/tests/extension.test.ts

@@ -0,0 +1,198 @@
+import type { ExtensionContext } from "@earendil-works/pi-coding-agent";
+import { describe, expect, it, vi } from "vitest";
+import { registerSessionTitle } from "../extensions/index.ts";
+import { DEFAULT_AUTO_TITLE_SETTINGS } from "../src/types.ts";
+
+function flushPromises() {
+	return new Promise((resolve) => setTimeout(resolve, 0));
+}
+
+function createMockPi() {
+	const handlers = new Map<
+		string,
+		(event: unknown, ctx: ExtensionContext) => void
+	>();
+	return {
+		handlers,
+		on: vi.fn(
+			(
+				event: string,
+				handler: (event: unknown, ctx: ExtensionContext) => void,
+			) => {
+				handlers.set(event, handler);
+			},
+		),
+		getSessionName: vi.fn(() => undefined),
+		setSessionName: vi.fn(),
+	};
+}
+
+function createMockCtx(): ExtensionContext {
+	return {
+		cwd: process.cwd(),
+		model: { provider: "test", id: "test-model" } as ExtensionContext["model"],
+		modelRegistry: {
+			find: vi.fn(),
+			getApiKeyAndHeaders: vi.fn(async () => ({
+				ok: true,
+				apiKey: "test-key",
+			})),
+		} as unknown as ExtensionContext["modelRegistry"],
+	} as ExtensionContext;
+}
+
+const agentEndEvent = {
+	type: "agent_end",
+	messages: [
+		{
+			role: "user",
+			content: [{ type: "text", text: "fix login bug" }],
+			timestamp: 1,
+		},
+		{
+			role: "assistant",
+			content: [{ type: "text", text: "I'll inspect the auth module first." }],
+			api: "openai-responses",
+			provider: "openai",
+			model: "gpt-4o",
+			usage: {
+				input: 1,
+				output: 1,
+				cacheRead: 0,
+				cacheWrite: 0,
+				totalTokens: 2,
+				cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, total: 0 },
+			},
+			stopReason: "stop",
+			timestamp: 2,
+		},
+	],
+};
+
+describe("registerSessionTitle", () => {
+	it("does not block agent_end while title agent is pending", async () => {
+		const pi = createMockPi();
+		let resolveRun: ((value: string | null) => void) | undefined;
+		const run = vi.fn(
+			() =>
+				new Promise<string | null>((resolve) => {
+					resolveRun = resolve;
+				}),
+		);
+
+		const harness = registerSessionTitle(pi as never, {
+			loadSettings: () => DEFAULT_AUTO_TITLE_SETTINGS,
+			createAgent: () => ({ run }),
+		});
+
+		const ctx = createMockCtx();
+		harness.handlers.agent_end?.(agentEndEvent, ctx);
+
+		expect(pi.setSessionName).not.toHaveBeenCalled();
+		expect(run).toHaveBeenCalledOnce();
+
+		resolveRun?.("Fix login bug");
+		await flushPromises();
+
+		expect(pi.setSessionName).toHaveBeenCalledWith("Fix login bug");
+	});
+
+	it("skips setSessionName for fast-rejected input", () => {
+		const pi = createMockPi();
+		const run = vi.fn(async () => "Should not run");
+
+		const harness = registerSessionTitle(pi as never, {
+			loadSettings: () => DEFAULT_AUTO_TITLE_SETTINGS,
+			createAgent: () => ({ run }),
+		});
+
+		harness.handlers.agent_end?.(
+			{
+				...agentEndEvent,
+				messages: [
+					{
+						role: "user",
+						content: [{ type: "text", text: "你好" }],
+						timestamp: 1,
+					},
+					{
+						role: "assistant",
+						content: [{ type: "text", text: "你好！" }],
+						api: "openai-responses",
+						provider: "openai",
+						model: "gpt-4o",
+						usage: {
+							input: 1,
+							output: 1,
+							cacheRead: 0,
+							cacheWrite: 0,
+							totalTokens: 2,
+							cost: {
+								input: 0,
+								output: 0,
+								cacheRead: 0,
+								cacheWrite: 0,
+								total: 0,
+							},
+						},
+						stopReason: "stop",
+						timestamp: 2,
+					},
+				],
+			},
+			createMockCtx(),
+		);
+		expect(run).not.toHaveBeenCalled();
+		expect(pi.setSessionName).not.toHaveBeenCalled();
+	});
+
+	it("allows a later task message after fast reject", () => {
+		const pi = createMockPi();
+		const run = vi.fn(async () => "Later title");
+		const harness = registerSessionTitle(pi as never, {
+			loadSettings: () => DEFAULT_AUTO_TITLE_SETTINGS,
+			createAgent: () => ({ run }),
+		});
+		const ctx = createMockCtx();
+
+		harness.handlers.agent_end?.(
+			{
+				...agentEndEvent,
+				messages: [
+					{
+						role: "user",
+						content: [{ type: "text", text: "你好" }],
+						timestamp: 1,
+					},
+					{
+						role: "assistant",
+						content: [{ type: "text", text: "你好！" }],
+						api: "openai-responses",
+						provider: "openai",
+						model: "gpt-4o",
+						usage: {
+							input: 1,
+							output: 1,
+							cacheRead: 0,
+							cacheWrite: 0,
+							totalTokens: 2,
+							cost: {
+								input: 0,
+								output: 0,
+								cacheRead: 0,
+								cacheWrite: 0,
+								total: 0,
+							},
+						},
+						stopReason: "stop",
+						timestamp: 2,
+					},
+				],
+			},
+			ctx,
+		);
+		harness.handlers.agent_end?.(agentEndEvent, ctx);
+
+		expect(run).toHaveBeenCalledOnce();
+	});
+});

package/node_modules/@vitos-pizza/session-title/tests/extract-title-context.test.ts

@@ -0,0 +1,48 @@
+import { describe, expect, it } from "vitest";
+import { extractTitleContext } from "../src/extract-title-context.ts";
+
+describe("extractTitleContext", () => {
+	it("extracts the last user message and assistant reply", () => {
+		const context = extractTitleContext([
+			{
+				role: "user",
+				content: [{ type: "text", text: "修复登录 bug" }],
+				timestamp: 1,
+			},
+			{
+				role: "assistant",
+				content: [{ type: "text", text: "我先检查 auth 模块。" }],
+				api: "openai-responses",
+				provider: "openai",
+				model: "gpt-4o",
+				usage: {
+					input: 1,
+					output: 1,
+					cacheRead: 0,
+					cacheWrite: 0,
+					totalTokens: 2,
+					cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, total: 0 },
+				},
+				stopReason: "stop",
+				timestamp: 2,
+			},
+		] as never);
+
+		expect(context).toEqual({
+			userMessage: "修复登录 bug",
+			assistantReply: "我先检查 auth 模块。",
+		});
+	});
+
+	it("returns null when assistant reply is missing", () => {
+		expect(
+			extractTitleContext([
+				{
+					role: "user",
+					content: "hello",
+					timestamp: 1,
+				},
+			] as never),
+		).toBeNull();
+	});
+});

package/node_modules/@vitos-pizza/session-title/tests/fast-rules.test.ts

@@ -0,0 +1,43 @@
+import { describe, expect, it } from "vitest";
+import {
+	isEmojiOnly,
+	isPurePunctuation,
+	isRepeatedSingleChar,
+	isTooShort,
+	matchesFastReject,
+} from "../src/fast-rules.ts";
+
+describe("fast-rules", () => {
+	it("flags short greetings", () => {
+		expect(isTooShort("你好", 4)).toBe(true);
+		expect(isTooShort("hi", 4)).toBe(true);
+		expect(isTooShort("修复 auth", 4)).toBe(false);
+	});
+
+	it("flags punctuation-only input", () => {
+		expect(isPurePunctuation("???")).toBe(true);
+		expect(isPurePunctuation("fix bug")).toBe(false);
+	});
+
+	it("flags emoji-only input", () => {
+		expect(isEmojiOnly("👋")).toBe(true);
+		expect(isEmojiOnly("👋🙂")).toBe(true);
+	});
+
+	it("flags repeated single characters", () => {
+		expect(isRepeatedSingleChar("aaa")).toBe(true);
+		expect(isRepeatedSingleChar("abc")).toBe(false);
+	});
+
+	it("matches fast reject cases", () => {
+		expect(
+			matchesFastReject("你好", { minCharsForLlm: 4, fastRules: true }),
+		).toBe(true);
+		expect(
+			matchesFastReject("修复登录 bug", { minCharsForLlm: 4, fastRules: true }),
+		).toBe(false);
+		expect(
+			matchesFastReject("hi", { minCharsForLlm: 4, fastRules: false }),
+		).toBe(false);
+	});
+});

package/node_modules/@vitos-pizza/session-title/tests/parse-title-response.test.ts

@@ -0,0 +1,34 @@
+import { describe, expect, it } from "vitest";
+import {
+	fallbackTitleFromPrompt,
+	normalizeTitle,
+} from "../src/normalize-title.ts";
+import { parseTitleResponse } from "../src/parse-title-response.ts";
+
+describe("parseTitleResponse", () => {
+	it("returns null for SKIP", () => {
+		expect(parseTitleResponse("SKIP")).toBeNull();
+		expect(parseTitleResponse(" skip ")).toBeNull();
+	});
+
+	it("returns title text", () => {
+		expect(parseTitleResponse("Fix login bug")).toBe("Fix login bug");
+	});
+});
+
+describe("normalizeTitle", () => {
+	it("strips quotes and collapses whitespace", () => {
+		expect(normalizeTitle('"  hello world  "')).toBe("hello world");
+	});
+
+	it("truncates long titles", () => {
+		const long = "a".repeat(80);
+		expect([...normalizeTitle(long, 48)].length).toBeLessThanOrEqual(48);
+	});
+
+	it("builds fallback titles from prompts", () => {
+		expect(fallbackTitleFromPrompt("  fix login bug  ", 48)).toBe(
+			"fix login bug",
+		);
+	});
+});

package/node_modules/@vitos-pizza/session-title/tests/should-schedule.test.ts

@@ -0,0 +1,30 @@
+import { describe, expect, it } from "vitest";
+import { decideSchedule } from "../src/should-schedule.ts";
+
+const baseCtx = {
+	hasSessionName: false,
+	inFlight: false,
+	fastRules: true,
+	minCharsForLlm: 4,
+};
+
+describe("decideSchedule", () => {
+	it("skips commands and existing names", () => {
+		expect(decideSchedule("/hello", baseCtx)).toBe("skip");
+		expect(
+			decideSchedule("fix bug", { ...baseCtx, hasSessionName: true }),
+		).toBe("skip");
+	});
+
+	it("fast-rejects short greetings", () => {
+		expect(decideSchedule("你好", baseCtx)).toBe("fastReject");
+	});
+
+	it("schedules task-like prompts", () => {
+		expect(decideSchedule("修复登录 bug", baseCtx)).toBe("schedule");
+	});
+
+	it("fast-rejects punctuation-only prompts", () => {
+		expect(decideSchedule("???", baseCtx)).toBe("fastReject");
+	});
+});

package/node_modules/@vitos-pizza/session-title/tests/title-agent.test.ts

@@ -0,0 +1,154 @@
+import { beforeEach, describe, expect, it, vi } from "vitest";
+import type { TitleModelContext } from "../src/resolve-title-model.ts";
+import {
+	resolveTitleModel,
+	resolveTitleModelRef,
+} from "../src/resolve-title-model.ts";
+import { createTitleAgent } from "../src/title-agent.ts";
+import { DEFAULT_AUTO_TITLE_SETTINGS } from "../src/types.ts";
+
+const requestSubagentRun = vi.hoisted(() => vi.fn());
+
+vi.mock("@vitos-pizza/subagents/rpc/client", () => ({
+	requestSubagentRun,
+}));
+
+const sampleContext = {
+	userMessage: "修复登录 bug",
+	assistantReply: "我先检查 auth 模块。",
+};
+
+function createMockEvents() {
+	const handlers = new Map<string, Array<(payload: unknown) => void>>();
+	return {
+		emit(channel: string, payload: unknown) {
+			for (const handler of handlers.get(channel) ?? []) handler(payload);
+		},
+		on(channel: string, handler: (payload: unknown) => void) {
+			const list = handlers.get(channel) ?? [];
+			list.push(handler);
+			handlers.set(channel, list);
+			return () => {
+				handlers.set(
+					channel,
+					(handlers.get(channel) ?? []).filter((entry) => entry !== handler),
+				);
+			};
+		},
+	};
+}
+
+describe("resolveTitleModel", () => {
+	it("prefers configured model over session model", () => {
+		const sessionModel = { id: "session-model", provider: "test" };
+		const configuredModel = { id: "configured-model", provider: "google" };
+		const find = vi.fn(() => configuredModel);
+		const ctx: TitleModelContext = {
+			model: sessionModel as TitleModelContext["model"],
+			modelRegistry: { find } as unknown as TitleModelContext["modelRegistry"],
+		};
+
+		expect(resolveTitleModel(ctx, "google/gemini-2.5-flash")).toBe(
+			configuredModel,
+		);
+		expect(find).toHaveBeenCalledWith("google", "gemini-2.5-flash");
+	});
+
+	it("falls back to session model", () => {
+		const sessionModel = { id: "session-model", provider: "openai" };
+		const ctx: TitleModelContext = {
+			model: sessionModel as TitleModelContext["model"],
+			modelRegistry: {
+				find: vi.fn(() => undefined),
+			} as unknown as TitleModelContext["modelRegistry"],
+		};
+
+		expect(resolveTitleModel(ctx, "missing/model")).toBe(sessionModel);
+		expect(resolveTitleModel(ctx)).toBe(sessionModel);
+	});
+});
+
+describe("resolveTitleModelRef", () => {
+	it("returns configured model ref when set", () => {
+		const ctx: TitleModelContext = {
+			model: { id: "gpt-4o", provider: "openai" } as TitleModelContext["model"],
+		};
+		expect(resolveTitleModelRef(ctx, "google/gemini-2.5-flash")).toBe(
+			"google/gemini-2.5-flash",
+		);
+	});
+
+	it("falls back to session provider/id", () => {
+		const ctx: TitleModelContext = {
+			model: { id: "gpt-4o", provider: "openai" } as TitleModelContext["model"],
+		};
+		expect(resolveTitleModelRef(ctx)).toBe("openai/gpt-4o");
+	});
+});
+
+describe("createTitleAgent", () => {
+	beforeEach(() => {
+		requestSubagentRun.mockReset();
+	});
+
+	it("returns null for SKIP responses", async () => {
+		requestSubagentRun.mockResolvedValue({
+			content: [{ type: "text", text: "SKIP" }],
+			details: {
+				mode: "single",
+				agentScope: "both",
+				projectAgentsDir: null,
+				results: [],
+			},
+		});
+
+		const agent = createTitleAgent({
+			events: createMockEvents(),
+			resolveModelRef: () => "openai/gpt-4o",
+			settings: DEFAULT_AUTO_TITLE_SETTINGS,
+		});
+
+		await expect(agent.run(sampleContext)).resolves.toBeNull();
+		expect(requestSubagentRun).toHaveBeenCalledWith(
+			expect.anything(),
+			expect.objectContaining({
+				agent: "title",
+				agentScope: "both",
+				model: "openai/gpt-4o",
+			}),
+			expect.objectContaining({ timeoutMs: DEFAULT_AUTO_TITLE_SETTINGS.timeoutMs }),
+		);
+	});
+
+	it("returns normalized titles within 20 chars", async () => {
+		requestSubagentRun.mockResolvedValue({
+			content: [{ type: "text", text: "修复登录问题" }],
+			details: {
+				mode: "single",
+				agentScope: "both",
+				projectAgentsDir: null,
+				results: [],
+			},
+		});
+
+		const agent = createTitleAgent({
+			events: createMockEvents(),
+			resolveModelRef: () => "openai/gpt-4o",
+			settings: DEFAULT_AUTO_TITLE_SETTINGS,
+		});
+
+		await expect(agent.run(sampleContext)).resolves.toBe("修复登录问题");
+	});
+
+	it("returns null when RPC times out", async () => {
+		requestSubagentRun.mockResolvedValue(null);
+
+		const agent = createTitleAgent({
+			events: createMockEvents(),
+			resolveModelRef: () => undefined,
+			settings: DEFAULT_AUTO_TITLE_SETTINGS,
+		});
+
+		await expect(agent.run(sampleContext)).resolves.toBeNull();
+	});
+});

package/node_modules/@vitos-pizza/session-title/tests/truncate-input.test.ts

@@ -0,0 +1,15 @@
+import { describe, expect, it } from "vitest";
+import { truncateInput } from "../src/truncate-input.ts";
+
+describe("truncateInput", () => {
+	it("returns trimmed text unchanged when short enough", () => {
+		expect(truncateInput("  fix login bug  ", 280)).toBe("fix login bug");
+	});
+
+	it("truncates long text near word boundaries", () => {
+		const long = `${"word ".repeat(80)}tail`;
+		const result = truncateInput(long, 120);
+		expect(result.length).toBeLessThanOrEqual(120);
+		expect(result.endsWith("tail")).toBe(false);
+	});
+});

package/node_modules/@vitos-pizza/session-title/tsconfig.json

@@ -0,0 +1,13 @@
+{
+	"extends": "../../tsconfig.base.json",
+	"compilerOptions": {
+		"allowImportingTsExtensions": true
+	},
+	"include": [
+		"extensions/**/*.ts",
+		"src/**/*.ts",
+		"tests/**/*.ts",
+		"vitest.config.ts"
+	],
+	"exclude": ["node_modules"]
+}

package/node_modules/@vitos-pizza/session-title/vitest.config.ts

@@ -0,0 +1,8 @@
+import { defineConfig } from "vitest/config";
+
+export default defineConfig({
+	test: {
+		environment: "node",
+		include: ["tests/**/*.test.ts"],
+	},
+});

package/node_modules/@vitos-pizza/subagents/agents/planner.md

@@ -0,0 +1,43 @@
+---
+name: planner
+description: Creates implementation plans from context and requirements
+tools: read, grep, find, ls, write, question, web_search, web_read
+thinking: high
+systemPromptMode: replace
+---
+
+You are a planning subagent.
+
+Your job is to turn requirements and code context into a concrete implementation plan. Do not make code changes. Read, analyze, and write the plan only.
+
+Working rules:
+- Read the provided context before planning.
+- Read any additional code you need in order to make the plan concrete.
+- Name exact files whenever you can.
+- Prefer small, ordered, actionable tasks over vague phases.
+- Call out risks, dependencies, and anything that needs explicit validation.
+- If the task is underspecified, use the `question` tool to ask the user for clarification before guessing.
+
+Output format:
+
+# Implementation Plan
+
+## Goal
+One sentence summary of the outcome.
+
+## Tasks
+Numbered steps, each small and actionable.
+
+## Files to Modify
+- `path/to/file.ts` - what changes there
+
+## New Files
+- `path/to/new.ts` - purpose
+
+## Dependencies
+Which tasks depend on others.
+
+## Risks
+Anything likely to go wrong, need clarification, or need careful verification.
+
+Keep the plan concrete. Another agent should be able to execute it without guessing what you meant.

package/node_modules/@vitos-pizza/subagents/agents/scout.md

@@ -0,0 +1,40 @@
+---
+name: scout
+description: Fast codebase recon that returns compressed context for handoff
+tools: read, grep, find, ls, bash, write, question, web_search, web_read
+thinking: low
+systemPromptMode: replace
+---
+
+You are a scouting subagent running inside pi.
+
+Use the provided tools directly. Move fast, but do not guess. Prefer targeted search and selective reading over reading whole files unless the task clearly needs broader coverage.
+
+Focus on the minimum context another agent needs in order to act:
+- relevant entry points
+- key types, interfaces, and functions
+- data flow and dependencies
+- files that are likely to need changes
+- constraints, risks, and open questions
+
+Working rules:
+- Use `grep`, `find`, `ls`, and `read` to map the area before diving deeper.
+- Use `bash` only for non-interactive inspection commands.
+- When you cite code, use exact file paths and line ranges.
+- When running solo, summarize what you found in the final response.
+
+Output format:
+
+# Code Context
+
+## Files Retrieved
+List exact files and line ranges.
+
+## Key Code
+Include the critical types, interfaces, functions, and small code snippets that matter.
+
+## Architecture
+Explain how the pieces connect.
+
+## Start Here
+Name the first file another agent should open and why.

package/node_modules/@vitos-pizza/subagents/agents/title.md

@@ -0,0 +1,13 @@
+---
+name: title
+description: Generates a short session title from user intent and assistant reply
+thinking: minimal
+systemPromptMode: replace
+---
+
+You analyze the user's intent together with the assistant's last reply and produce a short session title.
+
+Rules:
+- Output only the title text — no quotes, no explanation, no markdown.
+- If there is no clear task intent, output exactly `SKIP`.
+- Respect the maximum title length given in the task.

package/node_modules/@vitos-pizza/subagents/agents/worker.md

@@ -0,0 +1,36 @@
+---
+name: worker
+description: Implementation agent for approved plans and focused tasks
+tools: read, grep, find, ls, bash, edit, write
+thinking: high
+systemPromptMode: replace
+---
+
+You are `worker`: the implementation subagent.
+
+You are the single writer thread. Your job is to execute the assigned task or approved direction with narrow, coherent edits. The main agent and user remain the decision authority.
+
+Use the provided tools directly. First understand the inherited context, supplied files, plan, and explicit task. Then implement carefully and minimally.
+
+Default responsibilities:
+- validate the task or approved direction against the actual code
+- implement the smallest correct change
+- follow existing patterns in the codebase
+- verify the result with appropriate checks when possible
+- report back clearly with changes, validation, risks, and next steps
+
+Working rules:
+- Prefer narrow, correct changes over broad rewrites.
+- Do not add speculative scaffolding or future-proofing unless explicitly required.
+- Do not leave placeholder code, TODOs, or silent scope changes.
+- Use `bash` for inspection, validation, and relevant tests.
+- If there is supplied context or a plan, read it first.
+- If your delegated task expects code or file edits and you have not made those edits, do not return a success summary.
+
+Your final response should follow this shape:
+
+Implemented X.
+Changed files: Y.
+Validation: Z.
+Open risks/questions: R.
+Recommended next step: N.