@imdigitalashish/zpi 0.1.1

package/dist/core/skills.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.js","sourceRoot":"","sources":["../../src/core/skills.ts"],"names":[],"mappings":"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","sourcesContent":["import { existsSync, readdirSync, readFileSync, realpathSync, statSync } from \"fs\";\r\nimport ignore from \"ignore\";\r\nimport { homedir } from \"os\";\r\nimport { basename, dirname, isAbsolute, join, relative, resolve, sep } from \"path\";\r\nimport { CONFIG_DIR_NAME, getAgentDir } from \"../config.js\";\r\nimport { parseFrontmatter } from \"../utils/frontmatter.js\";\r\nimport type { ResourceDiagnostic } from \"./diagnostics.js\";\r\n\r\n/** Max name length per spec */\r\nconst MAX_NAME_LENGTH = 64;\r\n\r\n/** Max description length per spec */\r\nconst MAX_DESCRIPTION_LENGTH = 1024;\r\n\r\nconst IGNORE_FILE_NAMES = [\".gitignore\", \".ignore\", \".fdignore\"];\r\n\r\ntype IgnoreMatcher = ReturnType<typeof ignore>;\r\n\r\nfunction toPosixPath(p: string): string {\r\n\treturn p.split(sep).join(\"/\");\r\n}\r\n\r\nfunction prefixIgnorePattern(line: string, prefix: string): string | null {\r\n\tconst trimmed = line.trim();\r\n\tif (!trimmed) return null;\r\n\tif (trimmed.startsWith(\"#\") && !trimmed.startsWith(\"\\\\#\")) return null;\r\n\r\n\tlet pattern = line;\r\n\tlet negated = false;\r\n\r\n\tif (pattern.startsWith(\"!\")) {\r\n\t\tnegated = true;\r\n\t\tpattern = pattern.slice(1);\r\n\t} else if (pattern.startsWith(\"\\\\!\")) {\r\n\t\tpattern = pattern.slice(1);\r\n\t}\r\n\r\n\tif (pattern.startsWith(\"/\")) {\r\n\t\tpattern = pattern.slice(1);\r\n\t}\r\n\r\n\tconst prefixed = prefix ? `${prefix}${pattern}` : pattern;\r\n\treturn negated ? `!${prefixed}` : prefixed;\r\n}\r\n\r\nfunction addIgnoreRules(ig: IgnoreMatcher, dir: string, rootDir: string): void {\r\n\tconst relativeDir = relative(rootDir, dir);\r\n\tconst prefix = relativeDir ? `${toPosixPath(relativeDir)}/` : \"\";\r\n\r\n\tfor (const filename of IGNORE_FILE_NAMES) {\r\n\t\tconst ignorePath = join(dir, filename);\r\n\t\tif (!existsSync(ignorePath)) continue;\r\n\t\ttry {\r\n\t\t\tconst content = readFileSync(ignorePath, \"utf-8\");\r\n\t\t\tconst patterns = content\r\n\t\t\t\t.split(/\\r?\\n/)\r\n\t\t\t\t.map((line) => prefixIgnorePattern(line, prefix))\r\n\t\t\t\t.filter((line): line is string => Boolean(line));\r\n\t\t\tif (patterns.length > 0) {\r\n\t\t\t\tig.add(patterns);\r\n\t\t\t}\r\n\t\t} catch {}\r\n\t}\r\n}\r\n\r\nexport interface SkillFrontmatter {\r\n\tname?: string;\r\n\tdescription?: string;\r\n\t\"disable-model-invocation\"?: boolean;\r\n\t[key: string]: unknown;\r\n}\r\n\r\nexport interface Skill {\r\n\tname: string;\r\n\tdescription: string;\r\n\tfilePath: string;\r\n\tbaseDir: string;\r\n\tsource: string;\r\n\tdisableModelInvocation: boolean;\r\n}\r\n\r\nexport interface LoadSkillsResult {\r\n\tskills: Skill[];\r\n\tdiagnostics: ResourceDiagnostic[];\r\n}\r\n\r\n/**\r\n * Validate skill name per Agent Skills spec.\r\n * Returns array of validation error messages (empty if valid).\r\n */\r\nfunction validateName(name: string, parentDirName: string): string[] {\r\n\tconst errors: string[] = [];\r\n\r\n\tif (name !== parentDirName) {\r\n\t\terrors.push(`name \"${name}\" does not match parent directory \"${parentDirName}\"`);\r\n\t}\r\n\r\n\tif (name.length > MAX_NAME_LENGTH) {\r\n\t\terrors.push(`name exceeds ${MAX_NAME_LENGTH} characters (${name.length})`);\r\n\t}\r\n\r\n\tif (!/^[a-z0-9-]+$/.test(name)) {\r\n\t\terrors.push(`name contains invalid characters (must be lowercase a-z, 0-9, hyphens only)`);\r\n\t}\r\n\r\n\tif (name.startsWith(\"-\") || name.endsWith(\"-\")) {\r\n\t\terrors.push(`name must not start or end with a hyphen`);\r\n\t}\r\n\r\n\tif (name.includes(\"--\")) {\r\n\t\terrors.push(`name must not contain consecutive hyphens`);\r\n\t}\r\n\r\n\treturn errors;\r\n}\r\n\r\n/**\r\n * Validate description per Agent Skills spec.\r\n */\r\nfunction validateDescription(description: string | undefined): string[] {\r\n\tconst errors: string[] = [];\r\n\r\n\tif (!description || description.trim() === \"\") {\r\n\t\terrors.push(\"description is required\");\r\n\t} else if (description.length > MAX_DESCRIPTION_LENGTH) {\r\n\t\terrors.push(`description exceeds ${MAX_DESCRIPTION_LENGTH} characters (${description.length})`);\r\n\t}\r\n\r\n\treturn errors;\r\n}\r\n\r\nexport interface LoadSkillsFromDirOptions {\r\n\t/** Directory to scan for skills */\r\n\tdir: string;\r\n\t/** Source identifier for these skills */\r\n\tsource: string;\r\n}\r\n\r\n/**\r\n * Load skills from a directory.\r\n *\r\n * Discovery rules:\r\n * - direct .md children in the root\r\n * - recursive SKILL.md under subdirectories\r\n */\r\nexport function loadSkillsFromDir(options: LoadSkillsFromDirOptions): LoadSkillsResult {\r\n\tconst { dir, source } = options;\r\n\treturn loadSkillsFromDirInternal(dir, source, true);\r\n}\r\n\r\nfunction loadSkillsFromDirInternal(\r\n\tdir: string,\r\n\tsource: string,\r\n\tincludeRootFiles: boolean,\r\n\tignoreMatcher?: IgnoreMatcher,\r\n\trootDir?: string,\r\n): LoadSkillsResult {\r\n\tconst skills: Skill[] = [];\r\n\tconst diagnostics: ResourceDiagnostic[] = [];\r\n\r\n\tif (!existsSync(dir)) {\r\n\t\treturn { skills, diagnostics };\r\n\t}\r\n\r\n\tconst root = rootDir ?? dir;\r\n\tconst ig = ignoreMatcher ?? ignore();\r\n\taddIgnoreRules(ig, dir, root);\r\n\r\n\ttry {\r\n\t\tconst entries = readdirSync(dir, { withFileTypes: true });\r\n\r\n\t\tfor (const entry of entries) {\r\n\t\t\tif (entry.name.startsWith(\".\")) {\r\n\t\t\t\tcontinue;\r\n\t\t\t}\r\n\r\n\t\t\t// Skip node_modules to avoid scanning dependencies\r\n\t\t\tif (entry.name === \"node_modules\") {\r\n\t\t\t\tcontinue;\r\n\t\t\t}\r\n\r\n\t\t\tconst fullPath = join(dir, entry.name);\r\n\r\n\t\t\t// For symlinks, check if they point to a directory and follow them\r\n\t\t\tlet isDirectory = entry.isDirectory();\r\n\t\t\tlet isFile = entry.isFile();\r\n\t\t\tif (entry.isSymbolicLink()) {\r\n\t\t\t\ttry {\r\n\t\t\t\t\tconst stats = statSync(fullPath);\r\n\t\t\t\t\tisDirectory = stats.isDirectory();\r\n\t\t\t\t\tisFile = stats.isFile();\r\n\t\t\t\t} catch {\r\n\t\t\t\t\t// Broken symlink, skip it\r\n\t\t\t\t\tcontinue;\r\n\t\t\t\t}\r\n\t\t\t}\r\n\r\n\t\t\tconst relPath = toPosixPath(relative(root, fullPath));\r\n\t\t\tconst ignorePath = isDirectory ? `${relPath}/` : relPath;\r\n\t\t\tif (ig.ignores(ignorePath)) {\r\n\t\t\t\tcontinue;\r\n\t\t\t}\r\n\r\n\t\t\tif (isDirectory) {\r\n\t\t\t\tconst subResult = loadSkillsFromDirInternal(fullPath, source, false, ig, root);\r\n\t\t\t\tskills.push(...subResult.skills);\r\n\t\t\t\tdiagnostics.push(...subResult.diagnostics);\r\n\t\t\t\tcontinue;\r\n\t\t\t}\r\n\r\n\t\t\tif (!isFile) {\r\n\t\t\t\tcontinue;\r\n\t\t\t}\r\n\r\n\t\t\tconst isRootMd = includeRootFiles && entry.name.endsWith(\".md\");\r\n\t\t\tconst isSkillMd = !includeRootFiles && entry.name === \"SKILL.md\";\r\n\t\t\tif (!isRootMd && !isSkillMd) {\r\n\t\t\t\tcontinue;\r\n\t\t\t}\r\n\r\n\t\t\tconst result = loadSkillFromFile(fullPath, source);\r\n\t\t\tif (result.skill) {\r\n\t\t\t\tskills.push(result.skill);\r\n\t\t\t}\r\n\t\t\tdiagnostics.push(...result.diagnostics);\r\n\t\t}\r\n\t} catch {}\r\n\r\n\treturn { skills, diagnostics };\r\n}\r\n\r\nfunction loadSkillFromFile(\r\n\tfilePath: string,\r\n\tsource: string,\r\n): { skill: Skill | null; diagnostics: ResourceDiagnostic[] } {\r\n\tconst diagnostics: ResourceDiagnostic[] = [];\r\n\r\n\ttry {\r\n\t\tconst rawContent = readFileSync(filePath, \"utf-8\");\r\n\t\tconst { frontmatter } = parseFrontmatter<SkillFrontmatter>(rawContent);\r\n\t\tconst skillDir = dirname(filePath);\r\n\t\tconst parentDirName = basename(skillDir);\r\n\r\n\t\t// Validate description\r\n\t\tconst descErrors = validateDescription(frontmatter.description);\r\n\t\tfor (const error of descErrors) {\r\n\t\t\tdiagnostics.push({ type: \"warning\", message: error, path: filePath });\r\n\t\t}\r\n\r\n\t\t// Use name from frontmatter, or fall back to parent directory name\r\n\t\tconst name = frontmatter.name || parentDirName;\r\n\r\n\t\t// Validate name\r\n\t\tconst nameErrors = validateName(name, parentDirName);\r\n\t\tfor (const error of nameErrors) {\r\n\t\t\tdiagnostics.push({ type: \"warning\", message: error, path: filePath });\r\n\t\t}\r\n\r\n\t\t// Still load the skill even with warnings (unless description is completely missing)\r\n\t\tif (!frontmatter.description || frontmatter.description.trim() === \"\") {\r\n\t\t\treturn { skill: null, diagnostics };\r\n\t\t}\r\n\r\n\t\treturn {\r\n\t\t\tskill: {\r\n\t\t\t\tname,\r\n\t\t\t\tdescription: frontmatter.description,\r\n\t\t\t\tfilePath,\r\n\t\t\t\tbaseDir: skillDir,\r\n\t\t\t\tsource,\r\n\t\t\t\tdisableModelInvocation: frontmatter[\"disable-model-invocation\"] === true,\r\n\t\t\t},\r\n\t\t\tdiagnostics,\r\n\t\t};\r\n\t} catch (error) {\r\n\t\tconst message = error instanceof Error ? error.message : \"failed to parse skill file\";\r\n\t\tdiagnostics.push({ type: \"warning\", message, path: filePath });\r\n\t\treturn { skill: null, diagnostics };\r\n\t}\r\n}\r\n\r\n/**\r\n * Format skills for inclusion in a system prompt.\r\n * Uses XML format per Agent Skills standard.\r\n * See: https://agentskills.io/integrate-skills\r\n *\r\n * Skills with disableModelInvocation=true are excluded from the prompt\r\n * (they can only be invoked explicitly via /skill:name commands).\r\n */\r\nexport function formatSkillsForPrompt(skills: Skill[]): string {\r\n\tconst visibleSkills = skills.filter((s) => !s.disableModelInvocation);\r\n\r\n\tif (visibleSkills.length === 0) {\r\n\t\treturn \"\";\r\n\t}\r\n\r\n\tconst lines = [\r\n\t\t\"\\n\\nThe following skills provide specialized instructions for specific tasks.\",\r\n\t\t\"Use the read tool to load a skill's file when the task matches its description.\",\r\n\t\t\"When a skill file references a relative path, resolve it against the skill directory (parent of SKILL.md / dirname of the path) and use that absolute path in tool commands.\",\r\n\t\t\"\",\r\n\t\t\"<available_skills>\",\r\n\t];\r\n\r\n\tfor (const skill of visibleSkills) {\r\n\t\tlines.push(\"  <skill>\");\r\n\t\tlines.push(`    <name>${escapeXml(skill.name)}</name>`);\r\n\t\tlines.push(`    <description>${escapeXml(skill.description)}</description>`);\r\n\t\tlines.push(`    <location>${escapeXml(skill.filePath)}</location>`);\r\n\t\tlines.push(\"  </skill>\");\r\n\t}\r\n\r\n\tlines.push(\"</available_skills>\");\r\n\r\n\treturn lines.join(\"\\n\");\r\n}\r\n\r\nfunction escapeXml(str: string): string {\r\n\treturn str\r\n\t\t.replace(/&/g, \"&amp;\")\r\n\t\t.replace(/</g, \"&lt;\")\r\n\t\t.replace(/>/g, \"&gt;\")\r\n\t\t.replace(/\"/g, \"&quot;\")\r\n\t\t.replace(/'/g, \"&apos;\");\r\n}\r\n\r\nexport interface LoadSkillsOptions {\r\n\t/** Working directory for project-local skills. Default: process.cwd() */\r\n\tcwd?: string;\r\n\t/** Agent config directory for global skills. Default: ~/.pi/agent */\r\n\tagentDir?: string;\r\n\t/** Explicit skill paths (files or directories) */\r\n\tskillPaths?: string[];\r\n\t/** Include default skills directories. Default: true */\r\n\tincludeDefaults?: boolean;\r\n}\r\n\r\nfunction normalizePath(input: string): string {\r\n\tconst trimmed = input.trim();\r\n\tif (trimmed === \"~\") return homedir();\r\n\tif (trimmed.startsWith(\"~/\")) return join(homedir(), trimmed.slice(2));\r\n\tif (trimmed.startsWith(\"~\")) return join(homedir(), trimmed.slice(1));\r\n\treturn trimmed;\r\n}\r\n\r\nfunction resolveSkillPath(p: string, cwd: string): string {\r\n\tconst normalized = normalizePath(p);\r\n\treturn isAbsolute(normalized) ? normalized : resolve(cwd, normalized);\r\n}\r\n\r\n/**\r\n * Load skills from all configured locations.\r\n * Returns skills and any validation diagnostics.\r\n */\r\nexport function loadSkills(options: LoadSkillsOptions = {}): LoadSkillsResult {\r\n\tconst { cwd = process.cwd(), agentDir, skillPaths = [], includeDefaults = true } = options;\r\n\r\n\t// Resolve agentDir - if not provided, use default from config\r\n\tconst resolvedAgentDir = agentDir ?? getAgentDir();\r\n\r\n\tconst skillMap = new Map<string, Skill>();\r\n\tconst realPathSet = new Set<string>();\r\n\tconst allDiagnostics: ResourceDiagnostic[] = [];\r\n\tconst collisionDiagnostics: ResourceDiagnostic[] = [];\r\n\r\n\tfunction addSkills(result: LoadSkillsResult) {\r\n\t\tallDiagnostics.push(...result.diagnostics);\r\n\t\tfor (const skill of result.skills) {\r\n\t\t\t// Resolve symlinks to detect duplicate files\r\n\t\t\tlet realPath: string;\r\n\t\t\ttry {\r\n\t\t\t\trealPath = realpathSync(skill.filePath);\r\n\t\t\t} catch {\r\n\t\t\t\trealPath = skill.filePath;\r\n\t\t\t}\r\n\r\n\t\t\t// Skip silently if we've already loaded this exact file (via symlink)\r\n\t\t\tif (realPathSet.has(realPath)) {\r\n\t\t\t\tcontinue;\r\n\t\t\t}\r\n\r\n\t\t\tconst existing = skillMap.get(skill.name);\r\n\t\t\tif (existing) {\r\n\t\t\t\tcollisionDiagnostics.push({\r\n\t\t\t\t\ttype: \"collision\",\r\n\t\t\t\t\tmessage: `name \"${skill.name}\" collision`,\r\n\t\t\t\t\tpath: skill.filePath,\r\n\t\t\t\t\tcollision: {\r\n\t\t\t\t\t\tresourceType: \"skill\",\r\n\t\t\t\t\t\tname: skill.name,\r\n\t\t\t\t\t\twinnerPath: existing.filePath,\r\n\t\t\t\t\t\tloserPath: skill.filePath,\r\n\t\t\t\t\t},\r\n\t\t\t\t});\r\n\t\t\t} else {\r\n\t\t\t\tskillMap.set(skill.name, skill);\r\n\t\t\t\trealPathSet.add(realPath);\r\n\t\t\t}\r\n\t\t}\r\n\t}\r\n\r\n\tif (includeDefaults) {\r\n\t\taddSkills(loadSkillsFromDirInternal(join(resolvedAgentDir, \"skills\"), \"user\", true));\r\n\t\taddSkills(loadSkillsFromDirInternal(resolve(cwd, CONFIG_DIR_NAME, \"skills\"), \"project\", true));\r\n\t}\r\n\r\n\tconst userSkillsDir = join(resolvedAgentDir, \"skills\");\r\n\tconst projectSkillsDir = resolve(cwd, CONFIG_DIR_NAME, \"skills\");\r\n\r\n\tconst isUnderPath = (target: string, root: string): boolean => {\r\n\t\tconst normalizedRoot = resolve(root);\r\n\t\tif (target === normalizedRoot) {\r\n\t\t\treturn true;\r\n\t\t}\r\n\t\tconst prefix = normalizedRoot.endsWith(sep) ? normalizedRoot : `${normalizedRoot}${sep}`;\r\n\t\treturn target.startsWith(prefix);\r\n\t};\r\n\r\n\tconst getSource = (resolvedPath: string): \"user\" | \"project\" | \"path\" => {\r\n\t\tif (!includeDefaults) {\r\n\t\t\tif (isUnderPath(resolvedPath, userSkillsDir)) return \"user\";\r\n\t\t\tif (isUnderPath(resolvedPath, projectSkillsDir)) return \"project\";\r\n\t\t}\r\n\t\treturn \"path\";\r\n\t};\r\n\r\n\tfor (const rawPath of skillPaths) {\r\n\t\tconst resolvedPath = resolveSkillPath(rawPath, cwd);\r\n\t\tif (!existsSync(resolvedPath)) {\r\n\t\t\tallDiagnostics.push({ type: \"warning\", message: \"skill path does not exist\", path: resolvedPath });\r\n\t\t\tcontinue;\r\n\t\t}\r\n\r\n\t\ttry {\r\n\t\t\tconst stats = statSync(resolvedPath);\r\n\t\t\tconst source = getSource(resolvedPath);\r\n\t\t\tif (stats.isDirectory()) {\r\n\t\t\t\taddSkills(loadSkillsFromDirInternal(resolvedPath, source, true));\r\n\t\t\t} else if (stats.isFile() && resolvedPath.endsWith(\".md\")) {\r\n\t\t\t\tconst result = loadSkillFromFile(resolvedPath, source);\r\n\t\t\t\tif (result.skill) {\r\n\t\t\t\t\taddSkills({ skills: [result.skill], diagnostics: result.diagnostics });\r\n\t\t\t\t} else {\r\n\t\t\t\t\tallDiagnostics.push(...result.diagnostics);\r\n\t\t\t\t}\r\n\t\t\t} else {\r\n\t\t\t\tallDiagnostics.push({ type: \"warning\", message: \"skill path is not a markdown file\", path: resolvedPath });\r\n\t\t\t}\r\n\t\t} catch (error) {\r\n\t\t\tconst message = error instanceof Error ? error.message : \"failed to read skill path\";\r\n\t\t\tallDiagnostics.push({ type: \"warning\", message, path: resolvedPath });\r\n\t\t}\r\n\t}\r\n\r\n\treturn {\r\n\t\tskills: Array.from(skillMap.values()),\r\n\t\tdiagnostics: [...allDiagnostics, ...collisionDiagnostics],\r\n\t};\r\n}\r\n"]}

package/dist/core/slash-commands.d.ts

@@ -0,0 +1,15 @@
+export type SlashCommandSource = "extension" | "prompt" | "skill";
+export type SlashCommandLocation = "user" | "project" | "path";
+export interface SlashCommandInfo {
+    name: string;
+    description?: string;
+    source: SlashCommandSource;
+    location?: SlashCommandLocation;
+    path?: string;
+}
+export interface BuiltinSlashCommand {
+    name: string;
+    description: string;
+}
+export declare const BUILTIN_SLASH_COMMANDS: ReadonlyArray<BuiltinSlashCommand>;
+//# sourceMappingURL=slash-commands.d.ts.map

package/dist/core/slash-commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slash-commands.d.ts","sourceRoot":"","sources":["../../src/core/slash-commands.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,kBAAkB,GAAG,WAAW,GAAG,QAAQ,GAAG,OAAO,CAAC;AAElE,MAAM,MAAM,oBAAoB,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC;AAE/D,MAAM,WAAW,gBAAgB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,kBAAkB,CAAC;IAC3B,QAAQ,CAAC,EAAE,oBAAoB,CAAC;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,mBAAmB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACpB;AAED,eAAO,MAAM,sBAAsB,EAAE,aAAa,CAAC,mBAAmB,CAqBrE,CAAC","sourcesContent":["export type SlashCommandSource = \"extension\" | \"prompt\" | \"skill\";\r\n\r\nexport type SlashCommandLocation = \"user\" | \"project\" | \"path\";\r\n\r\nexport interface SlashCommandInfo {\r\n\tname: string;\r\n\tdescription?: string;\r\n\tsource: SlashCommandSource;\r\n\tlocation?: SlashCommandLocation;\r\n\tpath?: string;\r\n}\r\n\r\nexport interface BuiltinSlashCommand {\r\n\tname: string;\r\n\tdescription: string;\r\n}\r\n\r\nexport const BUILTIN_SLASH_COMMANDS: ReadonlyArray<BuiltinSlashCommand> = [\r\n\t{ name: \"settings\", description: \"Open settings menu\" },\r\n\t{ name: \"model\", description: \"Select model (opens selector UI)\" },\r\n\t{ name: \"scoped-models\", description: \"Enable/disable models for Ctrl+P cycling\" },\r\n\t{ name: \"export\", description: \"Export session to HTML file\" },\r\n\t{ name: \"share\", description: \"Share session as a secret GitHub gist\" },\r\n\t{ name: \"copy\", description: \"Copy last agent message to clipboard\" },\r\n\t{ name: \"name\", description: \"Set session display name\" },\r\n\t{ name: \"session\", description: \"Show session info and stats\" },\r\n\t{ name: \"changelog\", description: \"Show changelog entries\" },\r\n\t{ name: \"hotkeys\", description: \"Show all keyboard shortcuts\" },\r\n\t{ name: \"fork\", description: \"Create a new fork from a previous message\" },\r\n\t{ name: \"tree\", description: \"Navigate session tree (switch branches)\" },\r\n\t{ name: \"login\", description: \"Login with OAuth provider\" },\r\n\t{ name: \"logout\", description: \"Logout from OAuth provider\" },\r\n\t{ name: \"new\", description: \"Start a new session\" },\r\n\t{ name: \"compact\", description: \"Manually compact the session context\" },\r\n\t{ name: \"resume\", description: \"Resume a different session\" },\r\n\t{ name: \"reload\", description: \"Reload extensions, skills, prompts, and themes\" },\r\n\t{ name: \"memory\", description: \"View, search, delete, or compact project memories\" },\r\n\t{ name: \"quit\", description: \"Quit pi\" },\r\n];\r\n"]}

package/dist/core/slash-commands.js

@@ -0,0 +1,23 @@
+export const BUILTIN_SLASH_COMMANDS = [
+    { name: "settings", description: "Open settings menu" },
+    { name: "model", description: "Select model (opens selector UI)" },
+    { name: "scoped-models", description: "Enable/disable models for Ctrl+P cycling" },
+    { name: "export", description: "Export session to HTML file" },
+    { name: "share", description: "Share session as a secret GitHub gist" },
+    { name: "copy", description: "Copy last agent message to clipboard" },
+    { name: "name", description: "Set session display name" },
+    { name: "session", description: "Show session info and stats" },
+    { name: "changelog", description: "Show changelog entries" },
+    { name: "hotkeys", description: "Show all keyboard shortcuts" },
+    { name: "fork", description: "Create a new fork from a previous message" },
+    { name: "tree", description: "Navigate session tree (switch branches)" },
+    { name: "login", description: "Login with OAuth provider" },
+    { name: "logout", description: "Logout from OAuth provider" },
+    { name: "new", description: "Start a new session" },
+    { name: "compact", description: "Manually compact the session context" },
+    { name: "resume", description: "Resume a different session" },
+    { name: "reload", description: "Reload extensions, skills, prompts, and themes" },
+    { name: "memory", description: "View, search, delete, or compact project memories" },
+    { name: "quit", description: "Quit pi" },
+];
+//# sourceMappingURL=slash-commands.js.map

package/dist/core/slash-commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slash-commands.js","sourceRoot":"","sources":["../../src/core/slash-commands.ts"],"names":[],"mappings":"AAiBA,MAAM,CAAC,MAAM,sBAAsB,GAAuC;IACzE,EAAE,IAAI,EAAE,UAAU,EAAE,WAAW,EAAE,oBAAoB,EAAE;IACvD,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,kCAAkC,EAAE;IAClE,EAAE,IAAI,EAAE,eAAe,EAAE,WAAW,EAAE,0CAA0C,EAAE;IAClF,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,6BAA6B,EAAE;IAC9D,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,uCAAuC,EAAE;IACvE,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,sCAAsC,EAAE;IACrE,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,0BAA0B,EAAE;IACzD,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,6BAA6B,EAAE;IAC/D,EAAE,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,wBAAwB,EAAE;IAC5D,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,6BAA6B,EAAE;IAC/D,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,2CAA2C,EAAE;IAC1E,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,yCAAyC,EAAE;IACxE,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,2BAA2B,EAAE;IAC3D,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,4BAA4B,EAAE;IAC7D,EAAE,IAAI,EAAE,KAAK,EAAE,WAAW,EAAE,qBAAqB,EAAE;IACnD,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,sCAAsC,EAAE;IACxE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,4BAA4B,EAAE;IAC7D,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,gDAAgD,EAAE;IACjF,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,mDAAmD,EAAE;IACpF,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE;CACxC,CAAC","sourcesContent":["export type SlashCommandSource = \"extension\" | \"prompt\" | \"skill\";\r\n\r\nexport type SlashCommandLocation = \"user\" | \"project\" | \"path\";\r\n\r\nexport interface SlashCommandInfo {\r\n\tname: string;\r\n\tdescription?: string;\r\n\tsource: SlashCommandSource;\r\n\tlocation?: SlashCommandLocation;\r\n\tpath?: string;\r\n}\r\n\r\nexport interface BuiltinSlashCommand {\r\n\tname: string;\r\n\tdescription: string;\r\n}\r\n\r\nexport const BUILTIN_SLASH_COMMANDS: ReadonlyArray<BuiltinSlashCommand> = [\r\n\t{ name: \"settings\", description: \"Open settings menu\" },\r\n\t{ name: \"model\", description: \"Select model (opens selector UI)\" },\r\n\t{ name: \"scoped-models\", description: \"Enable/disable models for Ctrl+P cycling\" },\r\n\t{ name: \"export\", description: \"Export session to HTML file\" },\r\n\t{ name: \"share\", description: \"Share session as a secret GitHub gist\" },\r\n\t{ name: \"copy\", description: \"Copy last agent message to clipboard\" },\r\n\t{ name: \"name\", description: \"Set session display name\" },\r\n\t{ name: \"session\", description: \"Show session info and stats\" },\r\n\t{ name: \"changelog\", description: \"Show changelog entries\" },\r\n\t{ name: \"hotkeys\", description: \"Show all keyboard shortcuts\" },\r\n\t{ name: \"fork\", description: \"Create a new fork from a previous message\" },\r\n\t{ name: \"tree\", description: \"Navigate session tree (switch branches)\" },\r\n\t{ name: \"login\", description: \"Login with OAuth provider\" },\r\n\t{ name: \"logout\", description: \"Logout from OAuth provider\" },\r\n\t{ name: \"new\", description: \"Start a new session\" },\r\n\t{ name: \"compact\", description: \"Manually compact the session context\" },\r\n\t{ name: \"resume\", description: \"Resume a different session\" },\r\n\t{ name: \"reload\", description: \"Reload extensions, skills, prompts, and themes\" },\r\n\t{ name: \"memory\", description: \"View, search, delete, or compact project memories\" },\r\n\t{ name: \"quit\", description: \"Quit pi\" },\r\n];\r\n"]}

package/dist/core/system-prompt.d.ts

@@ -0,0 +1,26 @@
+/**
+ * System prompt construction and project context loading
+ */
+import { type Skill } from "./skills.js";
+export interface BuildSystemPromptOptions {
+    /** Custom system prompt (replaces default). */
+    customPrompt?: string;
+    /** Tools to include in prompt. Default: [read, bash, edit, write] */
+    selectedTools?: string[];
+    /** Text to append to system prompt. */
+    appendSystemPrompt?: string;
+    /** Working directory. Default: process.cwd() */
+    cwd?: string;
+    /** Pre-loaded context files. */
+    contextFiles?: Array<{
+        path: string;
+        content: string;
+    }>;
+    /** Pre-loaded skills. */
+    skills?: Skill[];
+    /** Whether the memory system is enabled. Default: true */
+    memoryEnabled?: boolean;
+}
+/** Build the system prompt with tools, guidelines, and context */
+export declare function buildSystemPrompt(options?: BuildSystemPromptOptions): string;
+//# sourceMappingURL=system-prompt.d.ts.map

package/dist/core/system-prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-prompt.d.ts","sourceRoot":"","sources":["../../src/core/system-prompt.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAAyB,KAAK,KAAK,EAAE,MAAM,aAAa,CAAC;AAiBhE,MAAM,WAAW,wBAAwB;IACxC,+CAA+C;IAC/C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,qEAAqE;IACrE,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,uCAAuC;IACvC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,gDAAgD;IAChD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,gCAAgC;IAChC,YAAY,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACxD,yBAAyB;IACzB,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC;IACjB,0DAA0D;IAC1D,aAAa,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,kEAAkE;AAClE,wBAAgB,iBAAiB,CAAC,OAAO,GAAE,wBAA6B,GAAG,MAAM,CAoKhF","sourcesContent":["/**\r\n * System prompt construction and project context loading\r\n */\r\n\r\nimport { getDocsPath, getExamplesPath, getReadmePath } from \"../config.js\";\r\nimport { buildMemoryPromptSection } from \"./memory.js\";\r\nimport { formatSkillsForPrompt, type Skill } from \"./skills.js\";\r\n\r\n/** Tool descriptions for system prompt */\r\nconst toolDescriptions: Record<string, string> = {\r\n\tread: \"Read file contents\",\r\n\tbash: \"Execute bash commands (ls, grep, find, etc.)\",\r\n\tedit: \"Make surgical edits to files (find exact text and replace)\",\r\n\twrite: \"Create or overwrite files\",\r\n\tgrep: \"Search file contents for patterns (respects .gitignore)\",\r\n\tfind: \"Find files by glob pattern (respects .gitignore)\",\r\n\tls: \"List directory contents\",\r\n\tmemory_write: \"Save a memory (procedural workflow, preference, or session summary)\",\r\n\tmemory_read: \"Read stored memories by type, ID, or search query\",\r\n\tmemory_update: \"Update an existing memory\",\r\n\tmemory_delete: \"Delete a memory by ID\",\r\n};\r\n\r\nexport interface BuildSystemPromptOptions {\r\n\t/** Custom system prompt (replaces default). */\r\n\tcustomPrompt?: string;\r\n\t/** Tools to include in prompt. Default: [read, bash, edit, write] */\r\n\tselectedTools?: string[];\r\n\t/** Text to append to system prompt. */\r\n\tappendSystemPrompt?: string;\r\n\t/** Working directory. Default: process.cwd() */\r\n\tcwd?: string;\r\n\t/** Pre-loaded context files. */\r\n\tcontextFiles?: Array<{ path: string; content: string }>;\r\n\t/** Pre-loaded skills. */\r\n\tskills?: Skill[];\r\n\t/** Whether the memory system is enabled. Default: true */\r\n\tmemoryEnabled?: boolean;\r\n}\r\n\r\n/** Build the system prompt with tools, guidelines, and context */\r\nexport function buildSystemPrompt(options: BuildSystemPromptOptions = {}): string {\r\n\tconst {\r\n\t\tcustomPrompt,\r\n\t\tselectedTools,\r\n\t\tappendSystemPrompt,\r\n\t\tcwd,\r\n\t\tcontextFiles: providedContextFiles,\r\n\t\tskills: providedSkills,\r\n\t\tmemoryEnabled = true,\r\n\t} = options;\r\n\tconst resolvedCwd = cwd ?? process.cwd();\r\n\r\n\tconst now = new Date();\r\n\tconst dateTime = now.toLocaleString(\"en-US\", {\r\n\t\tweekday: \"long\",\r\n\t\tyear: \"numeric\",\r\n\t\tmonth: \"long\",\r\n\t\tday: \"numeric\",\r\n\t\thour: \"2-digit\",\r\n\t\tminute: \"2-digit\",\r\n\t\tsecond: \"2-digit\",\r\n\t\ttimeZoneName: \"short\",\r\n\t});\r\n\r\n\tconst appendSection = appendSystemPrompt ? `\\n\\n${appendSystemPrompt}` : \"\";\r\n\r\n\tconst contextFiles = providedContextFiles ?? [];\r\n\tconst skills = providedSkills ?? [];\r\n\r\n\tif (customPrompt) {\r\n\t\tlet prompt = customPrompt;\r\n\r\n\t\tif (appendSection) {\r\n\t\t\tprompt += appendSection;\r\n\t\t}\r\n\r\n\t\t// Append project context files\r\n\t\tif (contextFiles.length > 0) {\r\n\t\t\tprompt += \"\\n\\n# Project Context\\n\\n\";\r\n\t\t\tprompt += \"Project-specific instructions and guidelines:\\n\\n\";\r\n\t\t\tfor (const { path: filePath, content } of contextFiles) {\r\n\t\t\t\tprompt += `## ${filePath}\\n\\n${content}\\n\\n`;\r\n\t\t\t}\r\n\t\t}\r\n\r\n\t\t// Append skills section (only if read tool is available)\r\n\t\tconst customPromptHasRead = !selectedTools || selectedTools.includes(\"read\");\r\n\t\tif (customPromptHasRead && skills.length > 0) {\r\n\t\t\tprompt += formatSkillsForPrompt(skills);\r\n\t\t}\r\n\r\n\t\t// Append memory system context\r\n\t\tif (memoryEnabled) {\r\n\t\t\tprompt += buildMemoryPromptSection(resolvedCwd);\r\n\t\t}\r\n\r\n\t\t// Add date/time and working directory last\r\n\t\tprompt += `\\nCurrent date and time: ${dateTime}`;\r\n\t\tprompt += `\\nCurrent working directory: ${resolvedCwd}`;\r\n\r\n\t\treturn prompt;\r\n\t}\r\n\r\n\t// Get absolute paths to documentation and examples\r\n\tconst readmePath = getReadmePath();\r\n\tconst docsPath = getDocsPath();\r\n\tconst examplesPath = getExamplesPath();\r\n\r\n\t// Build tools list based on selected tools (only built-in tools with known descriptions)\r\n\tconst tools = (selectedTools || [\"read\", \"bash\", \"edit\", \"write\"]).filter((t) => t in toolDescriptions);\r\n\tconst toolsList = tools.length > 0 ? tools.map((t) => `- ${t}: ${toolDescriptions[t]}`).join(\"\\n\") : \"(none)\";\r\n\r\n\t// Build guidelines based on which tools are actually available\r\n\tconst guidelinesList: string[] = [];\r\n\r\n\tconst hasBash = tools.includes(\"bash\");\r\n\tconst hasEdit = tools.includes(\"edit\");\r\n\tconst hasWrite = tools.includes(\"write\");\r\n\tconst hasGrep = tools.includes(\"grep\");\r\n\tconst hasFind = tools.includes(\"find\");\r\n\tconst hasLs = tools.includes(\"ls\");\r\n\tconst hasRead = tools.includes(\"read\");\r\n\r\n\t// File exploration guidelines\r\n\tif (hasBash && !hasGrep && !hasFind && !hasLs) {\r\n\t\tguidelinesList.push(\"Use bash for file operations like ls, rg, find\");\r\n\t} else if (hasBash && (hasGrep || hasFind || hasLs)) {\r\n\t\tguidelinesList.push(\"Prefer grep/find/ls tools over bash for file exploration (faster, respects .gitignore)\");\r\n\t}\r\n\r\n\t// Read before edit guideline\r\n\tif (hasRead && hasEdit) {\r\n\t\tguidelinesList.push(\"Use read to examine files before editing. You must use this tool instead of cat or sed.\");\r\n\t}\r\n\r\n\t// Edit guideline\r\n\tif (hasEdit) {\r\n\t\tguidelinesList.push(\"Use edit for precise changes (old text must match exactly)\");\r\n\t}\r\n\r\n\t// Write guideline\r\n\tif (hasWrite) {\r\n\t\tguidelinesList.push(\"Use write only for new files or complete rewrites\");\r\n\t}\r\n\r\n\t// Output guideline (only when actually writing or executing)\r\n\tif (hasEdit || hasWrite) {\r\n\t\tguidelinesList.push(\r\n\t\t\t\"When summarizing your actions, output plain text directly - do NOT use cat or bash to display what you did\",\r\n\t\t);\r\n\t}\r\n\r\n\t// Always include these\r\n\tguidelinesList.push(\"Be concise in your responses\");\r\n\tguidelinesList.push(\"Show file paths clearly when working with files\");\r\n\r\n\tconst guidelines = guidelinesList.map((g) => `- ${g}`).join(\"\\n\");\r\n\r\n\tlet prompt = `You are an expert coding assistant operating inside pi, a coding agent harness. You help users by reading files, executing commands, editing code, and writing new files.\r\n\r\nAvailable tools:\r\n${toolsList}\r\n\r\nIn addition to the tools above, you may have access to other custom tools depending on the project.\r\n\r\nGuidelines:\r\n${guidelines}\r\n\r\nPi documentation (read only when the user asks about pi itself, its SDK, extensions, themes, skills, or TUI):\r\n- Main documentation: ${readmePath}\r\n- Additional docs: ${docsPath}\r\n- Examples: ${examplesPath} (extensions, custom tools, SDK)\r\n- When asked about: extensions (docs/extensions.md, examples/extensions/), themes (docs/themes.md), skills (docs/skills.md), prompt templates (docs/prompt-templates.md), TUI components (docs/tui.md), keybindings (docs/keybindings.md), SDK integrations (docs/sdk.md), custom providers (docs/custom-provider.md), adding models (docs/models.md), pi packages (docs/packages.md)\r\n- When working on pi topics, read the docs and examples, and follow .md cross-references before implementing\r\n- Always read pi .md files completely and follow links to related docs (e.g., tui.md for TUI API details)`;\r\n\r\n\tif (appendSection) {\r\n\t\tprompt += appendSection;\r\n\t}\r\n\r\n\t// Append project context files\r\n\tif (contextFiles.length > 0) {\r\n\t\tprompt += \"\\n\\n# Project Context\\n\\n\";\r\n\t\tprompt += \"Project-specific instructions and guidelines:\\n\\n\";\r\n\t\tfor (const { path: filePath, content } of contextFiles) {\r\n\t\t\tprompt += `## ${filePath}\\n\\n${content}\\n\\n`;\r\n\t\t}\r\n\t}\r\n\r\n\t// Append skills section (only if read tool is available)\r\n\tif (hasRead && skills.length > 0) {\r\n\t\tprompt += formatSkillsForPrompt(skills);\r\n\t}\r\n\r\n\t// Append memory system context\r\n\tif (memoryEnabled) {\r\n\t\tprompt += buildMemoryPromptSection(resolvedCwd);\r\n\t}\r\n\r\n\t// Add date/time and working directory last\r\n\tprompt += `\\nCurrent date and time: ${dateTime}`;\r\n\tprompt += `\\nCurrent working directory: ${resolvedCwd}`;\r\n\r\n\treturn prompt;\r\n}\r\n"]}

package/dist/core/system-prompt.js

@@ -0,0 +1,150 @@
+/**
+ * System prompt construction and project context loading
+ */
+import { getDocsPath, getExamplesPath, getReadmePath } from "../config.js";
+import { buildMemoryPromptSection } from "./memory.js";
+import { formatSkillsForPrompt } from "./skills.js";
+/** Tool descriptions for system prompt */
+const toolDescriptions = {
+    read: "Read file contents",
+    bash: "Execute bash commands (ls, grep, find, etc.)",
+    edit: "Make surgical edits to files (find exact text and replace)",
+    write: "Create or overwrite files",
+    grep: "Search file contents for patterns (respects .gitignore)",
+    find: "Find files by glob pattern (respects .gitignore)",
+    ls: "List directory contents",
+    memory_write: "Save a memory (procedural workflow, preference, or session summary)",
+    memory_read: "Read stored memories by type, ID, or search query",
+    memory_update: "Update an existing memory",
+    memory_delete: "Delete a memory by ID",
+};
+/** Build the system prompt with tools, guidelines, and context */
+export function buildSystemPrompt(options = {}) {
+    const { customPrompt, selectedTools, appendSystemPrompt, cwd, contextFiles: providedContextFiles, skills: providedSkills, memoryEnabled = true, } = options;
+    const resolvedCwd = cwd ?? process.cwd();
+    const now = new Date();
+    const dateTime = now.toLocaleString("en-US", {
+        weekday: "long",
+        year: "numeric",
+        month: "long",
+        day: "numeric",
+        hour: "2-digit",
+        minute: "2-digit",
+        second: "2-digit",
+        timeZoneName: "short",
+    });
+    const appendSection = appendSystemPrompt ? `\n\n${appendSystemPrompt}` : "";
+    const contextFiles = providedContextFiles ?? [];
+    const skills = providedSkills ?? [];
+    if (customPrompt) {
+        let prompt = customPrompt;
+        if (appendSection) {
+            prompt += appendSection;
+        }
+        // Append project context files
+        if (contextFiles.length > 0) {
+            prompt += "\n\n# Project Context\n\n";
+            prompt += "Project-specific instructions and guidelines:\n\n";
+            for (const { path: filePath, content } of contextFiles) {
+                prompt += `## ${filePath}\n\n${content}\n\n`;
+            }
+        }
+        // Append skills section (only if read tool is available)
+        const customPromptHasRead = !selectedTools || selectedTools.includes("read");
+        if (customPromptHasRead && skills.length > 0) {
+            prompt += formatSkillsForPrompt(skills);
+        }
+        // Append memory system context
+        if (memoryEnabled) {
+            prompt += buildMemoryPromptSection(resolvedCwd);
+        }
+        // Add date/time and working directory last
+        prompt += `\nCurrent date and time: ${dateTime}`;
+        prompt += `\nCurrent working directory: ${resolvedCwd}`;
+        return prompt;
+    }
+    // Get absolute paths to documentation and examples
+    const readmePath = getReadmePath();
+    const docsPath = getDocsPath();
+    const examplesPath = getExamplesPath();
+    // Build tools list based on selected tools (only built-in tools with known descriptions)
+    const tools = (selectedTools || ["read", "bash", "edit", "write"]).filter((t) => t in toolDescriptions);
+    const toolsList = tools.length > 0 ? tools.map((t) => `- ${t}: ${toolDescriptions[t]}`).join("\n") : "(none)";
+    // Build guidelines based on which tools are actually available
+    const guidelinesList = [];
+    const hasBash = tools.includes("bash");
+    const hasEdit = tools.includes("edit");
+    const hasWrite = tools.includes("write");
+    const hasGrep = tools.includes("grep");
+    const hasFind = tools.includes("find");
+    const hasLs = tools.includes("ls");
+    const hasRead = tools.includes("read");
+    // File exploration guidelines
+    if (hasBash && !hasGrep && !hasFind && !hasLs) {
+        guidelinesList.push("Use bash for file operations like ls, rg, find");
+    }
+    else if (hasBash && (hasGrep || hasFind || hasLs)) {
+        guidelinesList.push("Prefer grep/find/ls tools over bash for file exploration (faster, respects .gitignore)");
+    }
+    // Read before edit guideline
+    if (hasRead && hasEdit) {
+        guidelinesList.push("Use read to examine files before editing. You must use this tool instead of cat or sed.");
+    }
+    // Edit guideline
+    if (hasEdit) {
+        guidelinesList.push("Use edit for precise changes (old text must match exactly)");
+    }
+    // Write guideline
+    if (hasWrite) {
+        guidelinesList.push("Use write only for new files or complete rewrites");
+    }
+    // Output guideline (only when actually writing or executing)
+    if (hasEdit || hasWrite) {
+        guidelinesList.push("When summarizing your actions, output plain text directly - do NOT use cat or bash to display what you did");
+    }
+    // Always include these
+    guidelinesList.push("Be concise in your responses");
+    guidelinesList.push("Show file paths clearly when working with files");
+    const guidelines = guidelinesList.map((g) => `- ${g}`).join("\n");
+    let prompt = `You are an expert coding assistant operating inside pi, a coding agent harness. You help users by reading files, executing commands, editing code, and writing new files.
+
+Available tools:
+${toolsList}
+
+In addition to the tools above, you may have access to other custom tools depending on the project.
+
+Guidelines:
+${guidelines}
+
+Pi documentation (read only when the user asks about pi itself, its SDK, extensions, themes, skills, or TUI):
+- Main documentation: ${readmePath}
+- Additional docs: ${docsPath}
+- Examples: ${examplesPath} (extensions, custom tools, SDK)
+- When asked about: extensions (docs/extensions.md, examples/extensions/), themes (docs/themes.md), skills (docs/skills.md), prompt templates (docs/prompt-templates.md), TUI components (docs/tui.md), keybindings (docs/keybindings.md), SDK integrations (docs/sdk.md), custom providers (docs/custom-provider.md), adding models (docs/models.md), pi packages (docs/packages.md)
+- When working on pi topics, read the docs and examples, and follow .md cross-references before implementing
+- Always read pi .md files completely and follow links to related docs (e.g., tui.md for TUI API details)`;
+    if (appendSection) {
+        prompt += appendSection;
+    }
+    // Append project context files
+    if (contextFiles.length > 0) {
+        prompt += "\n\n# Project Context\n\n";
+        prompt += "Project-specific instructions and guidelines:\n\n";
+        for (const { path: filePath, content } of contextFiles) {
+            prompt += `## ${filePath}\n\n${content}\n\n`;
+        }
+    }
+    // Append skills section (only if read tool is available)
+    if (hasRead && skills.length > 0) {
+        prompt += formatSkillsForPrompt(skills);
+    }
+    // Append memory system context
+    if (memoryEnabled) {
+        prompt += buildMemoryPromptSection(resolvedCwd);
+    }
+    // Add date/time and working directory last
+    prompt += `\nCurrent date and time: ${dateTime}`;
+    prompt += `\nCurrent working directory: ${resolvedCwd}`;
+    return prompt;
+}
+//# sourceMappingURL=system-prompt.js.map

package/dist/core/system-prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-prompt.js","sourceRoot":"","sources":["../../src/core/system-prompt.ts"],"names":[],"mappings":"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","sourcesContent":["/**\r\n * System prompt construction and project context loading\r\n */\r\n\r\nimport { getDocsPath, getExamplesPath, getReadmePath } from \"../config.js\";\r\nimport { buildMemoryPromptSection } from \"./memory.js\";\r\nimport { formatSkillsForPrompt, type Skill } from \"./skills.js\";\r\n\r\n/** Tool descriptions for system prompt */\r\nconst toolDescriptions: Record<string, string> = {\r\n\tread: \"Read file contents\",\r\n\tbash: \"Execute bash commands (ls, grep, find, etc.)\",\r\n\tedit: \"Make surgical edits to files (find exact text and replace)\",\r\n\twrite: \"Create or overwrite files\",\r\n\tgrep: \"Search file contents for patterns (respects .gitignore)\",\r\n\tfind: \"Find files by glob pattern (respects .gitignore)\",\r\n\tls: \"List directory contents\",\r\n\tmemory_write: \"Save a memory (procedural workflow, preference, or session summary)\",\r\n\tmemory_read: \"Read stored memories by type, ID, or search query\",\r\n\tmemory_update: \"Update an existing memory\",\r\n\tmemory_delete: \"Delete a memory by ID\",\r\n};\r\n\r\nexport interface BuildSystemPromptOptions {\r\n\t/** Custom system prompt (replaces default). */\r\n\tcustomPrompt?: string;\r\n\t/** Tools to include in prompt. Default: [read, bash, edit, write] */\r\n\tselectedTools?: string[];\r\n\t/** Text to append to system prompt. */\r\n\tappendSystemPrompt?: string;\r\n\t/** Working directory. Default: process.cwd() */\r\n\tcwd?: string;\r\n\t/** Pre-loaded context files. */\r\n\tcontextFiles?: Array<{ path: string; content: string }>;\r\n\t/** Pre-loaded skills. */\r\n\tskills?: Skill[];\r\n\t/** Whether the memory system is enabled. Default: true */\r\n\tmemoryEnabled?: boolean;\r\n}\r\n\r\n/** Build the system prompt with tools, guidelines, and context */\r\nexport function buildSystemPrompt(options: BuildSystemPromptOptions = {}): string {\r\n\tconst {\r\n\t\tcustomPrompt,\r\n\t\tselectedTools,\r\n\t\tappendSystemPrompt,\r\n\t\tcwd,\r\n\t\tcontextFiles: providedContextFiles,\r\n\t\tskills: providedSkills,\r\n\t\tmemoryEnabled = true,\r\n\t} = options;\r\n\tconst resolvedCwd = cwd ?? process.cwd();\r\n\r\n\tconst now = new Date();\r\n\tconst dateTime = now.toLocaleString(\"en-US\", {\r\n\t\tweekday: \"long\",\r\n\t\tyear: \"numeric\",\r\n\t\tmonth: \"long\",\r\n\t\tday: \"numeric\",\r\n\t\thour: \"2-digit\",\r\n\t\tminute: \"2-digit\",\r\n\t\tsecond: \"2-digit\",\r\n\t\ttimeZoneName: \"short\",\r\n\t});\r\n\r\n\tconst appendSection = appendSystemPrompt ? `\\n\\n${appendSystemPrompt}` : \"\";\r\n\r\n\tconst contextFiles = providedContextFiles ?? [];\r\n\tconst skills = providedSkills ?? [];\r\n\r\n\tif (customPrompt) {\r\n\t\tlet prompt = customPrompt;\r\n\r\n\t\tif (appendSection) {\r\n\t\t\tprompt += appendSection;\r\n\t\t}\r\n\r\n\t\t// Append project context files\r\n\t\tif (contextFiles.length > 0) {\r\n\t\t\tprompt += \"\\n\\n# Project Context\\n\\n\";\r\n\t\t\tprompt += \"Project-specific instructions and guidelines:\\n\\n\";\r\n\t\t\tfor (const { path: filePath, content } of contextFiles) {\r\n\t\t\t\tprompt += `## ${filePath}\\n\\n${content}\\n\\n`;\r\n\t\t\t}\r\n\t\t}\r\n\r\n\t\t// Append skills section (only if read tool is available)\r\n\t\tconst customPromptHasRead = !selectedTools || selectedTools.includes(\"read\");\r\n\t\tif (customPromptHasRead && skills.length > 0) {\r\n\t\t\tprompt += formatSkillsForPrompt(skills);\r\n\t\t}\r\n\r\n\t\t// Append memory system context\r\n\t\tif (memoryEnabled) {\r\n\t\t\tprompt += buildMemoryPromptSection(resolvedCwd);\r\n\t\t}\r\n\r\n\t\t// Add date/time and working directory last\r\n\t\tprompt += `\\nCurrent date and time: ${dateTime}`;\r\n\t\tprompt += `\\nCurrent working directory: ${resolvedCwd}`;\r\n\r\n\t\treturn prompt;\r\n\t}\r\n\r\n\t// Get absolute paths to documentation and examples\r\n\tconst readmePath = getReadmePath();\r\n\tconst docsPath = getDocsPath();\r\n\tconst examplesPath = getExamplesPath();\r\n\r\n\t// Build tools list based on selected tools (only built-in tools with known descriptions)\r\n\tconst tools = (selectedTools || [\"read\", \"bash\", \"edit\", \"write\"]).filter((t) => t in toolDescriptions);\r\n\tconst toolsList = tools.length > 0 ? tools.map((t) => `- ${t}: ${toolDescriptions[t]}`).join(\"\\n\") : \"(none)\";\r\n\r\n\t// Build guidelines based on which tools are actually available\r\n\tconst guidelinesList: string[] = [];\r\n\r\n\tconst hasBash = tools.includes(\"bash\");\r\n\tconst hasEdit = tools.includes(\"edit\");\r\n\tconst hasWrite = tools.includes(\"write\");\r\n\tconst hasGrep = tools.includes(\"grep\");\r\n\tconst hasFind = tools.includes(\"find\");\r\n\tconst hasLs = tools.includes(\"ls\");\r\n\tconst hasRead = tools.includes(\"read\");\r\n\r\n\t// File exploration guidelines\r\n\tif (hasBash && !hasGrep && !hasFind && !hasLs) {\r\n\t\tguidelinesList.push(\"Use bash for file operations like ls, rg, find\");\r\n\t} else if (hasBash && (hasGrep || hasFind || hasLs)) {\r\n\t\tguidelinesList.push(\"Prefer grep/find/ls tools over bash for file exploration (faster, respects .gitignore)\");\r\n\t}\r\n\r\n\t// Read before edit guideline\r\n\tif (hasRead && hasEdit) {\r\n\t\tguidelinesList.push(\"Use read to examine files before editing. You must use this tool instead of cat or sed.\");\r\n\t}\r\n\r\n\t// Edit guideline\r\n\tif (hasEdit) {\r\n\t\tguidelinesList.push(\"Use edit for precise changes (old text must match exactly)\");\r\n\t}\r\n\r\n\t// Write guideline\r\n\tif (hasWrite) {\r\n\t\tguidelinesList.push(\"Use write only for new files or complete rewrites\");\r\n\t}\r\n\r\n\t// Output guideline (only when actually writing or executing)\r\n\tif (hasEdit || hasWrite) {\r\n\t\tguidelinesList.push(\r\n\t\t\t\"When summarizing your actions, output plain text directly - do NOT use cat or bash to display what you did\",\r\n\t\t);\r\n\t}\r\n\r\n\t// Always include these\r\n\tguidelinesList.push(\"Be concise in your responses\");\r\n\tguidelinesList.push(\"Show file paths clearly when working with files\");\r\n\r\n\tconst guidelines = guidelinesList.map((g) => `- ${g}`).join(\"\\n\");\r\n\r\n\tlet prompt = `You are an expert coding assistant operating inside pi, a coding agent harness. You help users by reading files, executing commands, editing code, and writing new files.\r\n\r\nAvailable tools:\r\n${toolsList}\r\n\r\nIn addition to the tools above, you may have access to other custom tools depending on the project.\r\n\r\nGuidelines:\r\n${guidelines}\r\n\r\nPi documentation (read only when the user asks about pi itself, its SDK, extensions, themes, skills, or TUI):\r\n- Main documentation: ${readmePath}\r\n- Additional docs: ${docsPath}\r\n- Examples: ${examplesPath} (extensions, custom tools, SDK)\r\n- When asked about: extensions (docs/extensions.md, examples/extensions/), themes (docs/themes.md), skills (docs/skills.md), prompt templates (docs/prompt-templates.md), TUI components (docs/tui.md), keybindings (docs/keybindings.md), SDK integrations (docs/sdk.md), custom providers (docs/custom-provider.md), adding models (docs/models.md), pi packages (docs/packages.md)\r\n- When working on pi topics, read the docs and examples, and follow .md cross-references before implementing\r\n- Always read pi .md files completely and follow links to related docs (e.g., tui.md for TUI API details)`;\r\n\r\n\tif (appendSection) {\r\n\t\tprompt += appendSection;\r\n\t}\r\n\r\n\t// Append project context files\r\n\tif (contextFiles.length > 0) {\r\n\t\tprompt += \"\\n\\n# Project Context\\n\\n\";\r\n\t\tprompt += \"Project-specific instructions and guidelines:\\n\\n\";\r\n\t\tfor (const { path: filePath, content } of contextFiles) {\r\n\t\t\tprompt += `## ${filePath}\\n\\n${content}\\n\\n`;\r\n\t\t}\r\n\t}\r\n\r\n\t// Append skills section (only if read tool is available)\r\n\tif (hasRead && skills.length > 0) {\r\n\t\tprompt += formatSkillsForPrompt(skills);\r\n\t}\r\n\r\n\t// Append memory system context\r\n\tif (memoryEnabled) {\r\n\t\tprompt += buildMemoryPromptSection(resolvedCwd);\r\n\t}\r\n\r\n\t// Add date/time and working directory last\r\n\tprompt += `\\nCurrent date and time: ${dateTime}`;\r\n\tprompt += `\\nCurrent working directory: ${resolvedCwd}`;\r\n\r\n\treturn prompt;\r\n}\r\n"]}

package/dist/core/timings.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Central timing instrumentation for startup profiling.
+ * Enable with PI_TIMING=1 environment variable.
+ */
+export declare function time(label: string): void;
+export declare function printTimings(): void;
+//# sourceMappingURL=timings.d.ts.map

package/dist/core/timings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timings.d.ts","sourceRoot":"","sources":["../../src/core/timings.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,wBAAgB,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAKxC;AAED,wBAAgB,YAAY,IAAI,IAAI,CAQnC","sourcesContent":["/**\r\n * Central timing instrumentation for startup profiling.\r\n * Enable with PI_TIMING=1 environment variable.\r\n */\r\n\r\nconst ENABLED = process.env.PI_TIMING === \"1\";\r\nconst timings: Array<{ label: string; ms: number }> = [];\r\nlet lastTime = Date.now();\r\n\r\nexport function time(label: string): void {\r\n\tif (!ENABLED) return;\r\n\tconst now = Date.now();\r\n\ttimings.push({ label, ms: now - lastTime });\r\n\tlastTime = now;\r\n}\r\n\r\nexport function printTimings(): void {\r\n\tif (!ENABLED || timings.length === 0) return;\r\n\tconsole.error(\"\\n--- Startup Timings ---\");\r\n\tfor (const t of timings) {\r\n\t\tconsole.error(`  ${t.label}: ${t.ms}ms`);\r\n\t}\r\n\tconsole.error(`  TOTAL: ${timings.reduce((a, b) => a + b.ms, 0)}ms`);\r\n\tconsole.error(\"------------------------\\n\");\r\n}\r\n"]}

package/dist/core/timings.js

@@ -0,0 +1,25 @@
+/**
+ * Central timing instrumentation for startup profiling.
+ * Enable with PI_TIMING=1 environment variable.
+ */
+const ENABLED = process.env.PI_TIMING === "1";
+const timings = [];
+let lastTime = Date.now();
+export function time(label) {
+    if (!ENABLED)
+        return;
+    const now = Date.now();
+    timings.push({ label, ms: now - lastTime });
+    lastTime = now;
+}
+export function printTimings() {
+    if (!ENABLED || timings.length === 0)
+        return;
+    console.error("\n--- Startup Timings ---");
+    for (const t of timings) {
+        console.error(`  ${t.label}: ${t.ms}ms`);
+    }
+    console.error(`  TOTAL: ${timings.reduce((a, b) => a + b.ms, 0)}ms`);
+    console.error("------------------------\n");
+}
+//# sourceMappingURL=timings.js.map

package/dist/core/timings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timings.js","sourceRoot":"","sources":["../../src/core/timings.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,SAAS,KAAK,GAAG,CAAC;AAC9C,MAAM,OAAO,GAAyC,EAAE,CAAC;AACzD,IAAI,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;AAE1B,MAAM,UAAU,IAAI,CAAC,KAAa,EAAQ;IACzC,IAAI,CAAC,OAAO;QAAE,OAAO;IACrB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,GAAG,GAAG,QAAQ,EAAE,CAAC,CAAC;IAC5C,QAAQ,GAAG,GAAG,CAAC;AAAA,CACf;AAED,MAAM,UAAU,YAAY,GAAS;IACpC,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IAC7C,OAAO,CAAC,KAAK,CAAC,2BAA2B,CAAC,CAAC;IAC3C,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACzB,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;IAC1C,CAAC;IACD,OAAO,CAAC,KAAK,CAAC,YAAY,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;IACrE,OAAO,CAAC,KAAK,CAAC,4BAA4B,CAAC,CAAC;AAAA,CAC5C","sourcesContent":["/**\r\n * Central timing instrumentation for startup profiling.\r\n * Enable with PI_TIMING=1 environment variable.\r\n */\r\n\r\nconst ENABLED = process.env.PI_TIMING === \"1\";\r\nconst timings: Array<{ label: string; ms: number }> = [];\r\nlet lastTime = Date.now();\r\n\r\nexport function time(label: string): void {\r\n\tif (!ENABLED) return;\r\n\tconst now = Date.now();\r\n\ttimings.push({ label, ms: now - lastTime });\r\n\tlastTime = now;\r\n}\r\n\r\nexport function printTimings(): void {\r\n\tif (!ENABLED || timings.length === 0) return;\r\n\tconsole.error(\"\\n--- Startup Timings ---\");\r\n\tfor (const t of timings) {\r\n\t\tconsole.error(`  ${t.label}: ${t.ms}ms`);\r\n\t}\r\n\tconsole.error(`  TOTAL: ${timings.reduce((a, b) => a + b.ms, 0)}ms`);\r\n\tconsole.error(\"------------------------\\n\");\r\n}\r\n"]}

package/dist/core/tools/bash.d.ts

@@ -0,0 +1,55 @@
+import type { AgentTool } from "@mariozechner/pi-agent-core";
+import { type Static } from "@sinclair/typebox";
+import { type TruncationResult } from "./truncate.js";
+declare const bashSchema: import("@sinclair/typebox").TObject<{
+    command: import("@sinclair/typebox").TString;
+    timeout: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+}>;
+export type BashToolInput = Static<typeof bashSchema>;
+export interface BashToolDetails {
+    truncation?: TruncationResult;
+    fullOutputPath?: string;
+}
+/**
+ * Pluggable operations for the bash tool.
+ * Override these to delegate command execution to remote systems (e.g., SSH).
+ */
+export interface BashOperations {
+    /**
+     * Execute a command and stream output.
+     * @param command - The command to execute
+     * @param cwd - Working directory
+     * @param options - Execution options
+     * @returns Promise resolving to exit code (null if killed)
+     */
+    exec: (command: string, cwd: string, options: {
+        onData: (data: Buffer) => void;
+        signal?: AbortSignal;
+        timeout?: number;
+        env?: NodeJS.ProcessEnv;
+    }) => Promise<{
+        exitCode: number | null;
+    }>;
+}
+export interface BashSpawnContext {
+    command: string;
+    cwd: string;
+    env: NodeJS.ProcessEnv;
+}
+export type BashSpawnHook = (context: BashSpawnContext) => BashSpawnContext;
+export interface BashToolOptions {
+    /** Custom operations for command execution. Default: local shell */
+    operations?: BashOperations;
+    /** Command prefix prepended to every command (e.g., "shopt -s expand_aliases" for alias support) */
+    commandPrefix?: string;
+    /** Hook to adjust command, cwd, or env before execution */
+    spawnHook?: BashSpawnHook;
+}
+export declare function createBashTool(cwd: string, options?: BashToolOptions): AgentTool<typeof bashSchema>;
+/** Default bash tool using process.cwd() - for backwards compatibility */
+export declare const bashTool: AgentTool<import("@sinclair/typebox").TObject<{
+    command: import("@sinclair/typebox").TString;
+    timeout: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+}>, any>;
+export {};
+//# sourceMappingURL=bash.d.ts.map

package/dist/core/tools/bash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bash.d.ts","sourceRoot":"","sources":["../../../src/core/tools/bash.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,KAAK,MAAM,EAAQ,MAAM,mBAAmB,CAAC;AAGtD,OAAO,EAAoD,KAAK,gBAAgB,EAAgB,MAAM,eAAe,CAAC;AAUtH,QAAA,MAAM,UAAU;;;EAGd,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,OAAO,UAAU,CAAC,CAAC;AAEtD,MAAM,WAAW,eAAe;IAC/B,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,cAAc,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC9B;;;;;;OAMG;IACH,IAAI,EAAE,CACL,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM,EACX,OAAO,EAAE;QACR,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;QAC/B,MAAM,CAAC,EAAE,WAAW,CAAC;QACrB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;KACxB,KACG,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC,CAAC;CAC1C;AAsFD,MAAM,WAAW,gBAAgB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;CACvB;AAED,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,EAAE,gBAAgB,KAAK,gBAAgB,CAAC;AAY5E,MAAM,WAAW,eAAe;IAC/B,oEAAoE;IACpE,UAAU,CAAC,EAAE,cAAc,CAAC;IAC5B,oGAAoG;IACpG,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,2DAA2D;IAC3D,SAAS,CAAC,EAAE,aAAa,CAAC;CAC1B;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,SAAS,CAAC,OAAO,UAAU,CAAC,CAwJnG;AAED,0EAA0E;AAC1E,eAAO,MAAM,QAAQ;;;QAAgC,CAAC","sourcesContent":["import { randomBytes } from \"node:crypto\";\r\nimport { createWriteStream, existsSync } from \"node:fs\";\r\nimport { tmpdir } from \"node:os\";\r\nimport { join } from \"node:path\";\r\nimport type { AgentTool } from \"@mariozechner/pi-agent-core\";\r\nimport { type Static, Type } from \"@sinclair/typebox\";\r\nimport { spawn } from \"child_process\";\r\nimport { getShellConfig, getShellEnv, killProcessTree } from \"../../utils/shell.js\";\r\nimport { DEFAULT_MAX_BYTES, DEFAULT_MAX_LINES, formatSize, type TruncationResult, truncateTail } from \"./truncate.js\";\r\n\r\n/**\r\n * Generate a unique temp file path for bash output\r\n */\r\nfunction getTempFilePath(): string {\r\n\tconst id = randomBytes(8).toString(\"hex\");\r\n\treturn join(tmpdir(), `pi-bash-${id}.log`);\r\n}\r\n\r\nconst bashSchema = Type.Object({\r\n\tcommand: Type.String({ description: \"Bash command to execute\" }),\r\n\ttimeout: Type.Optional(Type.Number({ description: \"Timeout in seconds (optional, no default timeout)\" })),\r\n});\r\n\r\nexport type BashToolInput = Static<typeof bashSchema>;\r\n\r\nexport interface BashToolDetails {\r\n\ttruncation?: TruncationResult;\r\n\tfullOutputPath?: string;\r\n}\r\n\r\n/**\r\n * Pluggable operations for the bash tool.\r\n * Override these to delegate command execution to remote systems (e.g., SSH).\r\n */\r\nexport interface BashOperations {\r\n\t/**\r\n\t * Execute a command and stream output.\r\n\t * @param command - The command to execute\r\n\t * @param cwd - Working directory\r\n\t * @param options - Execution options\r\n\t * @returns Promise resolving to exit code (null if killed)\r\n\t */\r\n\texec: (\r\n\t\tcommand: string,\r\n\t\tcwd: string,\r\n\t\toptions: {\r\n\t\t\tonData: (data: Buffer) => void;\r\n\t\t\tsignal?: AbortSignal;\r\n\t\t\ttimeout?: number;\r\n\t\t\tenv?: NodeJS.ProcessEnv;\r\n\t\t},\r\n\t) => Promise<{ exitCode: number | null }>;\r\n}\r\n\r\n/**\r\n * Default bash operations using local shell\r\n */\r\nconst defaultBashOperations: BashOperations = {\r\n\texec: (command, cwd, { onData, signal, timeout, env }) => {\r\n\t\treturn new Promise((resolve, reject) => {\r\n\t\t\tconst { shell, args } = getShellConfig();\r\n\r\n\t\t\tif (!existsSync(cwd)) {\r\n\t\t\t\treject(new Error(`Working directory does not exist: ${cwd}\\nCannot execute bash commands.`));\r\n\t\t\t\treturn;\r\n\t\t\t}\r\n\r\n\t\t\tconst child = spawn(shell, [...args, command], {\r\n\t\t\t\tcwd,\r\n\t\t\t\tdetached: true,\r\n\t\t\t\tenv: env ?? getShellEnv(),\r\n\t\t\t\tstdio: [\"ignore\", \"pipe\", \"pipe\"],\r\n\t\t\t});\r\n\r\n\t\t\tlet timedOut = false;\r\n\r\n\t\t\t// Set timeout if provided\r\n\t\t\tlet timeoutHandle: NodeJS.Timeout | undefined;\r\n\t\t\tif (timeout !== undefined && timeout > 0) {\r\n\t\t\t\ttimeoutHandle = setTimeout(() => {\r\n\t\t\t\t\ttimedOut = true;\r\n\t\t\t\t\tif (child.pid) {\r\n\t\t\t\t\t\tkillProcessTree(child.pid);\r\n\t\t\t\t\t}\r\n\t\t\t\t}, timeout * 1000);\r\n\t\t\t}\r\n\r\n\t\t\t// Stream stdout and stderr\r\n\t\t\tif (child.stdout) {\r\n\t\t\t\tchild.stdout.on(\"data\", onData);\r\n\t\t\t}\r\n\t\t\tif (child.stderr) {\r\n\t\t\t\tchild.stderr.on(\"data\", onData);\r\n\t\t\t}\r\n\r\n\t\t\t// Handle shell spawn errors\r\n\t\t\tchild.on(\"error\", (err) => {\r\n\t\t\t\tif (timeoutHandle) clearTimeout(timeoutHandle);\r\n\t\t\t\tif (signal) signal.removeEventListener(\"abort\", onAbort);\r\n\t\t\t\treject(err);\r\n\t\t\t});\r\n\r\n\t\t\t// Handle abort signal - kill entire process tree\r\n\t\t\tconst onAbort = () => {\r\n\t\t\t\tif (child.pid) {\r\n\t\t\t\t\tkillProcessTree(child.pid);\r\n\t\t\t\t}\r\n\t\t\t};\r\n\r\n\t\t\tif (signal) {\r\n\t\t\t\tif (signal.aborted) {\r\n\t\t\t\t\tonAbort();\r\n\t\t\t\t} else {\r\n\t\t\t\t\tsignal.addEventListener(\"abort\", onAbort, { once: true });\r\n\t\t\t\t}\r\n\t\t\t}\r\n\r\n\t\t\t// Handle process exit\r\n\t\t\tchild.on(\"close\", (code) => {\r\n\t\t\t\tif (timeoutHandle) clearTimeout(timeoutHandle);\r\n\t\t\t\tif (signal) signal.removeEventListener(\"abort\", onAbort);\r\n\r\n\t\t\t\tif (signal?.aborted) {\r\n\t\t\t\t\treject(new Error(\"aborted\"));\r\n\t\t\t\t\treturn;\r\n\t\t\t\t}\r\n\r\n\t\t\t\tif (timedOut) {\r\n\t\t\t\t\treject(new Error(`timeout:${timeout}`));\r\n\t\t\t\t\treturn;\r\n\t\t\t\t}\r\n\r\n\t\t\t\tresolve({ exitCode: code });\r\n\t\t\t});\r\n\t\t});\r\n\t},\r\n};\r\n\r\nexport interface BashSpawnContext {\r\n\tcommand: string;\r\n\tcwd: string;\r\n\tenv: NodeJS.ProcessEnv;\r\n}\r\n\r\nexport type BashSpawnHook = (context: BashSpawnContext) => BashSpawnContext;\r\n\r\nfunction resolveSpawnContext(command: string, cwd: string, spawnHook?: BashSpawnHook): BashSpawnContext {\r\n\tconst baseContext: BashSpawnContext = {\r\n\t\tcommand,\r\n\t\tcwd,\r\n\t\tenv: { ...getShellEnv() },\r\n\t};\r\n\r\n\treturn spawnHook ? spawnHook(baseContext) : baseContext;\r\n}\r\n\r\nexport interface BashToolOptions {\r\n\t/** Custom operations for command execution. Default: local shell */\r\n\toperations?: BashOperations;\r\n\t/** Command prefix prepended to every command (e.g., \"shopt -s expand_aliases\" for alias support) */\r\n\tcommandPrefix?: string;\r\n\t/** Hook to adjust command, cwd, or env before execution */\r\n\tspawnHook?: BashSpawnHook;\r\n}\r\n\r\nexport function createBashTool(cwd: string, options?: BashToolOptions): AgentTool<typeof bashSchema> {\r\n\tconst ops = options?.operations ?? defaultBashOperations;\r\n\tconst commandPrefix = options?.commandPrefix;\r\n\tconst spawnHook = options?.spawnHook;\r\n\r\n\treturn {\r\n\t\tname: \"bash\",\r\n\t\tlabel: \"bash\",\r\n\t\tdescription: `Execute a bash command in the current working directory. Returns stdout and stderr. Output is truncated to last ${DEFAULT_MAX_LINES} lines or ${DEFAULT_MAX_BYTES / 1024}KB (whichever is hit first). If truncated, full output is saved to a temp file. Optionally provide a timeout in seconds.`,\r\n\t\tparameters: bashSchema,\r\n\t\texecute: async (\r\n\t\t\t_toolCallId: string,\r\n\t\t\t{ command, timeout }: { command: string; timeout?: number },\r\n\t\t\tsignal?: AbortSignal,\r\n\t\t\tonUpdate?,\r\n\t\t) => {\r\n\t\t\t// Apply command prefix if configured (e.g., \"shopt -s expand_aliases\" for alias support)\r\n\t\t\tconst resolvedCommand = commandPrefix ? `${commandPrefix}\\n${command}` : command;\r\n\t\t\tconst spawnContext = resolveSpawnContext(resolvedCommand, cwd, spawnHook);\r\n\r\n\t\t\treturn new Promise((resolve, reject) => {\r\n\t\t\t\t// We'll stream to a temp file if output gets large\r\n\t\t\t\tlet tempFilePath: string | undefined;\r\n\t\t\t\tlet tempFileStream: ReturnType<typeof createWriteStream> | undefined;\r\n\t\t\t\tlet totalBytes = 0;\r\n\r\n\t\t\t\t// Keep a rolling buffer of the last chunk for tail truncation\r\n\t\t\t\tconst chunks: Buffer[] = [];\r\n\t\t\t\tlet chunksBytes = 0;\r\n\t\t\t\t// Keep more than we need so we have enough for truncation\r\n\t\t\t\tconst maxChunksBytes = DEFAULT_MAX_BYTES * 2;\r\n\r\n\t\t\t\tconst handleData = (data: Buffer) => {\r\n\t\t\t\t\ttotalBytes += data.length;\r\n\r\n\t\t\t\t\t// Start writing to temp file once we exceed the threshold\r\n\t\t\t\t\tif (totalBytes > DEFAULT_MAX_BYTES && !tempFilePath) {\r\n\t\t\t\t\t\ttempFilePath = getTempFilePath();\r\n\t\t\t\t\t\ttempFileStream = createWriteStream(tempFilePath);\r\n\t\t\t\t\t\t// Write all buffered chunks to the file\r\n\t\t\t\t\t\tfor (const chunk of chunks) {\r\n\t\t\t\t\t\t\ttempFileStream.write(chunk);\r\n\t\t\t\t\t\t}\r\n\t\t\t\t\t}\r\n\r\n\t\t\t\t\t// Write to temp file if we have one\r\n\t\t\t\t\tif (tempFileStream) {\r\n\t\t\t\t\t\ttempFileStream.write(data);\r\n\t\t\t\t\t}\r\n\r\n\t\t\t\t\t// Keep rolling buffer of recent data\r\n\t\t\t\t\tchunks.push(data);\r\n\t\t\t\t\tchunksBytes += data.length;\r\n\r\n\t\t\t\t\t// Trim old chunks if buffer is too large\r\n\t\t\t\t\twhile (chunksBytes > maxChunksBytes && chunks.length > 1) {\r\n\t\t\t\t\t\tconst removed = chunks.shift()!;\r\n\t\t\t\t\t\tchunksBytes -= removed.length;\r\n\t\t\t\t\t}\r\n\r\n\t\t\t\t\t// Stream partial output to callback (truncated rolling buffer)\r\n\t\t\t\t\tif (onUpdate) {\r\n\t\t\t\t\t\tconst fullBuffer = Buffer.concat(chunks);\r\n\t\t\t\t\t\tconst fullText = fullBuffer.toString(\"utf-8\");\r\n\t\t\t\t\t\tconst truncation = truncateTail(fullText);\r\n\t\t\t\t\t\tonUpdate({\r\n\t\t\t\t\t\t\tcontent: [{ type: \"text\", text: truncation.content || \"\" }],\r\n\t\t\t\t\t\t\tdetails: {\r\n\t\t\t\t\t\t\t\ttruncation: truncation.truncated ? truncation : undefined,\r\n\t\t\t\t\t\t\t\tfullOutputPath: tempFilePath,\r\n\t\t\t\t\t\t\t},\r\n\t\t\t\t\t\t});\r\n\t\t\t\t\t}\r\n\t\t\t\t};\r\n\r\n\t\t\t\tops.exec(spawnContext.command, spawnContext.cwd, {\r\n\t\t\t\t\tonData: handleData,\r\n\t\t\t\t\tsignal,\r\n\t\t\t\t\ttimeout,\r\n\t\t\t\t\tenv: spawnContext.env,\r\n\t\t\t\t})\r\n\t\t\t\t\t.then(({ exitCode }) => {\r\n\t\t\t\t\t\t// Close temp file stream\r\n\t\t\t\t\t\tif (tempFileStream) {\r\n\t\t\t\t\t\t\ttempFileStream.end();\r\n\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\t// Combine all buffered chunks\r\n\t\t\t\t\t\tconst fullBuffer = Buffer.concat(chunks);\r\n\t\t\t\t\t\tconst fullOutput = fullBuffer.toString(\"utf-8\");\r\n\r\n\t\t\t\t\t\t// Apply tail truncation\r\n\t\t\t\t\t\tconst truncation = truncateTail(fullOutput);\r\n\t\t\t\t\t\tlet outputText = truncation.content || \"(no output)\";\r\n\r\n\t\t\t\t\t\t// Build details with truncation info\r\n\t\t\t\t\t\tlet details: BashToolDetails | undefined;\r\n\r\n\t\t\t\t\t\tif (truncation.truncated) {\r\n\t\t\t\t\t\t\tdetails = {\r\n\t\t\t\t\t\t\t\ttruncation,\r\n\t\t\t\t\t\t\t\tfullOutputPath: tempFilePath,\r\n\t\t\t\t\t\t\t};\r\n\r\n\t\t\t\t\t\t\t// Build actionable notice\r\n\t\t\t\t\t\t\tconst startLine = truncation.totalLines - truncation.outputLines + 1;\r\n\t\t\t\t\t\t\tconst endLine = truncation.totalLines;\r\n\r\n\t\t\t\t\t\t\tif (truncation.lastLinePartial) {\r\n\t\t\t\t\t\t\t\t// Edge case: last line alone > 30KB\r\n\t\t\t\t\t\t\t\tconst lastLineSize = formatSize(Buffer.byteLength(fullOutput.split(\"\\n\").pop() || \"\", \"utf-8\"));\r\n\t\t\t\t\t\t\t\toutputText += `\\n\\n[Showing last ${formatSize(truncation.outputBytes)} of line ${endLine} (line is ${lastLineSize}). Full output: ${tempFilePath}]`;\r\n\t\t\t\t\t\t\t} else if (truncation.truncatedBy === \"lines\") {\r\n\t\t\t\t\t\t\t\toutputText += `\\n\\n[Showing lines ${startLine}-${endLine} of ${truncation.totalLines}. Full output: ${tempFilePath}]`;\r\n\t\t\t\t\t\t\t} else {\r\n\t\t\t\t\t\t\t\toutputText += `\\n\\n[Showing lines ${startLine}-${endLine} of ${truncation.totalLines} (${formatSize(DEFAULT_MAX_BYTES)} limit). Full output: ${tempFilePath}]`;\r\n\t\t\t\t\t\t\t}\r\n\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\tif (exitCode !== 0 && exitCode !== null) {\r\n\t\t\t\t\t\t\toutputText += `\\n\\nCommand exited with code ${exitCode}`;\r\n\t\t\t\t\t\t\treject(new Error(outputText));\r\n\t\t\t\t\t\t} else {\r\n\t\t\t\t\t\t\tresolve({ content: [{ type: \"text\", text: outputText }], details });\r\n\t\t\t\t\t\t}\r\n\t\t\t\t\t})\r\n\t\t\t\t\t.catch((err: Error) => {\r\n\t\t\t\t\t\t// Close temp file stream\r\n\t\t\t\t\t\tif (tempFileStream) {\r\n\t\t\t\t\t\t\ttempFileStream.end();\r\n\t\t\t\t\t\t}\r\n\r\n\t\t\t\t\t\t// Combine all buffered chunks for error output\r\n\t\t\t\t\t\tconst fullBuffer = Buffer.concat(chunks);\r\n\t\t\t\t\t\tlet output = fullBuffer.toString(\"utf-8\");\r\n\r\n\t\t\t\t\t\tif (err.message === \"aborted\") {\r\n\t\t\t\t\t\t\tif (output) output += \"\\n\\n\";\r\n\t\t\t\t\t\t\toutput += \"Command aborted\";\r\n\t\t\t\t\t\t\treject(new Error(output));\r\n\t\t\t\t\t\t} else if (err.message.startsWith(\"timeout:\")) {\r\n\t\t\t\t\t\t\tconst timeoutSecs = err.message.split(\":\")[1];\r\n\t\t\t\t\t\t\tif (output) output += \"\\n\\n\";\r\n\t\t\t\t\t\t\toutput += `Command timed out after ${timeoutSecs} seconds`;\r\n\t\t\t\t\t\t\treject(new Error(output));\r\n\t\t\t\t\t\t} else {\r\n\t\t\t\t\t\t\treject(err);\r\n\t\t\t\t\t\t}\r\n\t\t\t\t\t});\r\n\t\t\t});\r\n\t\t},\r\n\t};\r\n}\r\n\r\n/** Default bash tool using process.cwd() - for backwards compatibility */\r\nexport const bashTool = createBashTool(process.cwd());\r\n"]}