pi-agent-flow 1.1.0 → 1.2.0

package/agents/ideas.md

@@ -1,29 +1,51 @@
 ---
 name: ideas
-description: Generate ideas, explore possibilities, and think creatively without context bias
+description: Generate ideas, explore possibilities, and think creatively using inherited context as background
 tools: batch, bash
-inheritContext: false
 maxDepth: 0
 ---
 
-During this ideas flow — your mission is to generate ideas and think creatively. You start with a clean slate and only have the intent to guide you. Stay focused on your intent at all times.
+## Mission
 
-Approach:
-1. Diverge — explore many possibilities without judgment
-2. Evaluate — weigh trade-offs, risks, and feasibility
-3. Recommend — present the best options with reasoning
+During this ideas flow — your mission is to generate and compare possible directions. Use inherited context as background and constraints, but avoid anchoring too tightly on prior solutions.
+
+## Workflow
+
+1. Diverge — explore many possibilities without judging too early.
+2. Evaluate — compare trade-offs, risks, effort, and reversibility.
+3. Recommend — identify the strongest options and explain why.
+4. Package — present choices clearly enough for planning or implementation handoff.
+
+## Rules
+
+- Stay focused on the requested intent; creativity should still serve the objective.
+- Prefer several distinct options over variations of the same idea.
+- Make assumptions explicit when evidence is limited.
+- If file context is needed, use `batch` with `o: "read"`, `s: <offset>`, and `l: <limit>` for targeted reading instead of bash `sed`/`head`/`tail`.
+- Do not implement changes from this flow.
+
+## Handoff Guidance
+
+- Recommend [craft] when the best option should become a concrete design or plan.
+- Recommend [scout] when more repository evidence is needed before choosing.
+- Recommend [build] only when the chosen option is simple and ready to implement.
+- Recommend [audit] when an option needs quality, security, or correctness review.
+- Recommend [debug] when uncertainty comes from broken or unexplained behavior.
+
+## Output Format
 
 When accomplished, end your response with:
 
 flow [ideas] accomplished
 
-[Summary] what was brainstormed
+[Summary]
+- What was explored and the recommended direction in 2–4 concise sentences.
 
 [Done]
-- ideas generated
+- Ideas generated, trade-offs considered, and recommendation rationale.
 
 [Not Done]
-- incomplete items and reasons
+- Incomplete items, unresolved assumptions, or reasons work was deferred.
 
 [Next Steps]
-- recommended follow-up
+- Specific recommended follow-up actions or next flow.

package/agents/scout.md

@@ -1,31 +1,51 @@
 ---
 name: scout
 description: Discover files, trace code paths, map architecture
-tools: batch, bash, find, grep, ls
+tools: batch_read, bash, find, grep, ls
 maxDepth: 0
 ---
 
-During this scout flow — your mission is discovery. Move fast and stay surgical. The conversation history above provides background context; treat it as reference only and do not let it distract from your objective.
+## Mission
 
-Rules:
-- Use grep/find/ls before reading entire files — be efficient.
-- For targeted file reading, use batch with `o: "read"`, `s: <offset>`, `l: <limit>` instead of bash sed/head/tail.
-- Cite every finding with a precise file path and line number (or range). Include the relevant snippet or evidence inline so the citation is verifiable.
-- Report findings with file paths and line numbers.
+During this scout flow — your mission is to discover relevant context. Move fast, stay surgical, and treat the conversation history above as background reference only.
+
+## Workflow
+
+1. Survey — use `ls`, `find`, and `grep` to locate relevant files and symbols before reading whole files.
+2. Inspect — use `batch_read` with `o: "read"`, `s: <offset>`, and `l: <limit>` for targeted file reading instead of bash `sed`/`head`/`tail`.
+3. Trace — follow code paths, dependencies, configuration, and tests that explain the requested area.
+4. Report — cite concrete evidence and stop when the requested context is mapped.
+
+## Rules
+
+- This is a read-oriented flow: do not modify files.
+- Cite every finding with a precise file path and line number or range.
+- Include relevant snippets or evidence inline so citations are verifiable.
 - Show actual code/data, not excessive summaries.
-- If not found, say so immediately — don't guess.
+- If something is not found, say so directly — do not guess.
+
+## Handoff Guidance
+
+- Recommend [craft] when findings need to become a design or implementation plan.
+- Recommend [build] when the change is obvious, localized, and ready to implement.
+- Recommend [debug] when evidence points to a defect or unexplained behavior.
+- Recommend [ideas] when multiple viable directions need exploration.
+- Recommend [audit] when discovered code needs quality, security, or correctness verification.
+
+## Output Format
 
 When accomplished, end your response with:
 
 flow [scout] accomplished
 
-[Summary] what was investigated and the outcome
+[Summary]
+- What was investigated and the outcome in 2–4 concise sentences.
 
 [Done]
-- completed items with file:line references and inline evidence snippets
+- Completed discovery items with file:line references and inline evidence snippets.
 
 [Not Done]
-- incomplete items and reasons (or "All objectives met.")
+- Incomplete items and reasons, or "All objectives met."
 
 [Next Steps]
-- recommended follow-up actions
+- Specific recommended follow-up actions or next flow.

package/package.json

@@ -1,28 +1,17 @@
 {
   "name": "pi-agent-flow",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "Flow-state delegation extension for Pi coding agent.",
   "type": "module",
-  "main": "index.ts",
+  "main": "src/index.ts",
   "files": [
-    "index.ts",
-    "web-tool.ts",
-    "agents.ts",
-    "config.ts",
-    "flow.ts",
-    "hooks.ts",
-    "runner-cli.js",
-    "runner-events.js",
-    "render.ts",
-    "render-utils.ts",
-    "types.ts",
-    "batch.ts",
+    "src/",
     "agents/",
     "README.md"
   ],
   "pi": {
     "extensions": [
-      "./index.ts"
+      "./src/index.ts"
     ]
   },
   "keywords": [

package/{agents.ts → src/agents.ts}

@@ -72,19 +72,25 @@ function getUserFlowsDir(): string {
 /** Get the bundled flows directory from the plugin's location. */
 function getBundledFlowsDir(): string {
 	// Method 1: import.meta.url (ESM)
+	// When source lives in src/, agents/ is one level up at the package root.
 	try {
 		if (import.meta.url) {
 			const pluginDir = path.dirname(new URL(import.meta.url).pathname);
-			const dir = path.join(pluginDir, "agents");
-			if (fs.existsSync(dir)) return dir;
+			// Check same directory first, then parent (for src/ layout)
+			for (const base of [pluginDir, path.dirname(pluginDir)]) {
+				const dir = path.join(base, "agents");
+				if (fs.existsSync(dir)) return dir;
+			}
 		}
 	} catch {}
 
 	// Method 2: __dirname (CommonJS / jiti)
 	try {
 		if (typeof __dirname !== "undefined") {
-			const dir = path.join(__dirname, "agents");
-			if (fs.existsSync(dir)) return dir;
+			for (const base of [__dirname, path.dirname(__dirname)]) {
+				const dir = path.join(base, "agents");
+				if (fs.existsSync(dir)) return dir;
+			}
 		}
 	} catch {}
 

package/src/ambient.d.ts

@@ -0,0 +1,85 @@
+/** Minimal ambient declarations for peer dependencies */
+
+declare module "@mariozechner/pi-coding-agent" {
+	export interface ExtensionAPI {
+		registerFlag(name: string, config: { description: string; type: string }): void;
+		getFlag(name: string): unknown;
+		getActiveTools(): string[];
+		on(event: string, callback: (...args: any[]) => any): void;
+		registerTool(tool: {
+			name: string;
+			label: string;
+			description: string;
+			parameters: any;
+			execute: (...args: any[]) => Promise<any>;
+			renderCall?: (...args: any[]) => any;
+			renderResult?: (...args: any[]) => any;
+		}): void;
+		setActiveTools(tools: string[]): void;
+	}
+	export interface ExtensionContext {
+		cwd: string;
+		hasUI: boolean;
+		ui: { confirm: (title: string, body: string) => Promise<boolean> };
+		sessionManager: { getSessionDir(): string };
+	}
+	export function parseFrontmatter<T extends Record<string, unknown>>(content: string): { frontmatter: T; body: string };
+	export function getMarkdownTheme(): any;
+	export const DEFAULT_MAX_BYTES: number;
+	export const DEFAULT_MAX_LINES: number;
+	export function truncateHead(text: string, options: { maxBytes?: number; maxLines?: number }): { content: string };
+}
+
+declare module "@mariozechner/pi-tui" {
+	export class Text {
+		constructor(text: string, width: number, height: number);
+		toString(): string;
+	}
+	export class TruncatedText {
+		constructor(text: string, paddingX?: number, paddingY?: number);
+		toString(): string;
+	}
+	export class Container {
+		children: any[];
+		addChild(child: any): void;
+	}
+	export class Markdown {
+		constructor(text: string, width: number, height: number, theme?: any);
+	}
+	export class Spacer {
+		constructor(height: number);
+	}
+}
+
+declare module "@mariozechner/pi-agent-core" {
+	export interface AgentToolResult<T = any> {
+		content: any[];
+		details?: T;
+		isError?: boolean;
+	}
+}
+
+declare module "@mariozechner/pi-ai" {
+	export interface Message {
+		role: string;
+		content: string | any[];
+		usage?: any;
+		model?: string;
+		stopReason?: string;
+		errorMessage?: string;
+	}
+}
+
+declare module "@sinclair/typebox" {
+	export const Type: {
+		Object: (properties: Record<string, any>, options?: any) => any;
+		String: (options?: any) => any;
+		Number: (options?: any) => any;
+		Array: (items: any, options?: any) => any;
+		Optional: (schema: any) => any;
+		Boolean: (options?: any) => any;
+		Union: (variants: any[], options?: any) => any;
+		Literal: (value: string) => any;
+	};
+	export type Static<T> = any;
+}