@antaif3ng/til-work 0.1.0

package/dist/core/skills.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Skill loading and formatting.
+ *
+ * A skill is a SKILL.md file (with optional YAML frontmatter) that provides
+ * specialised instructions for the agent. Skills are discovered from
+ * well-known directories and injected into the system prompt so the LLM can
+ * `read` them on demand.
+ *
+ * Directory conventions (searched in order):
+ *   ~/.til/skills/          — user-global skills
+ *   .til/skills/            — project-local skills
+ *   CLI --skill <path>      — explicit paths
+ *
+ * Layout inside a skills directory:
+ *   my-skill/
+ *     SKILL.md              — required (contains frontmatter + instructions)
+ */
+export interface SkillFrontmatter {
+    name?: string;
+    description?: string;
+    "disable-model-invocation"?: boolean;
+    [key: string]: unknown;
+}
+export interface Skill {
+    name: string;
+    description: string;
+    filePath: string;
+    baseDir: string;
+    source: "user" | "project" | "path";
+    disableModelInvocation: boolean;
+}
+export interface LoadSkillsResult {
+    skills: Skill[];
+    diagnostics: SkillDiagnostic[];
+}
+export interface SkillDiagnostic {
+    type: "warning" | "collision";
+    message: string;
+    path: string;
+}
+export declare function loadSkillsFromDir(dir: string, source: Skill["source"]): LoadSkillsResult;
+export interface LoadSkillsOptions {
+    cwd?: string;
+    skillPaths?: string[];
+    includeDefaults?: boolean;
+}
+export declare function loadSkills(options?: LoadSkillsOptions): LoadSkillsResult;
+export declare function formatSkillsForPrompt(skills: Skill[]): string;
+//# sourceMappingURL=skills.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../../src/core/skills.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAQH,MAAM,WAAW,gBAAgB;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0BAA0B,CAAC,EAAE,OAAO,CAAC;IACrC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,KAAK;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC;IACpC,sBAAsB,EAAE,OAAO,CAAC;CAChC;AAED,MAAM,WAAW,gBAAgB;IAChC,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,WAAW,EAAE,eAAe,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,eAAe;IAC/B,IAAI,EAAE,SAAS,GAAG,WAAW,CAAC;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACb;AAiID,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,QAAQ,CAAC,GAAG,gBAAgB,CAExF;AAID,MAAM,WAAW,iBAAiB;IACjC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC1B;AASD,wBAAgB,UAAU,CAAC,OAAO,GAAE,iBAAsB,GAAG,gBAAgB,CA+D5E;AAaD,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,CAsB7D"}

package/dist/core/skills.js

@@ -0,0 +1,232 @@
+/**
+ * Skill loading and formatting.
+ *
+ * A skill is a SKILL.md file (with optional YAML frontmatter) that provides
+ * specialised instructions for the agent. Skills are discovered from
+ * well-known directories and injected into the system prompt so the LLM can
+ * `read` them on demand.
+ *
+ * Directory conventions (searched in order):
+ *   ~/.til/skills/          — user-global skills
+ *   .til/skills/            — project-local skills
+ *   CLI --skill <path>      — explicit paths
+ *
+ * Layout inside a skills directory:
+ *   my-skill/
+ *     SKILL.md              — required (contains frontmatter + instructions)
+ */
+import { existsSync, readdirSync, readFileSync, realpathSync, statSync } from "node:fs";
+import { basename, dirname, isAbsolute, join, resolve } from "node:path";
+import { homedir } from "node:os";
+// ── Frontmatter parsing ──
+function parseFrontmatter(raw) {
+    const match = raw.match(/^---\r?\n([\s\S]*?)\r?\n---\r?\n?([\s\S]*)$/);
+    if (!match)
+        return { frontmatter: {}, body: raw };
+    const yamlBlock = match[1];
+    const body = match[2];
+    const fm = {};
+    for (const line of yamlBlock.split(/\r?\n/)) {
+        const kv = line.match(/^\s*([a-zA-Z0-9_-]+)\s*:\s*(.*)$/);
+        if (!kv)
+            continue;
+        const key = kv[1].trim();
+        let value = kv[2].trim();
+        // Strip surrounding quotes
+        if (typeof value === "string" && /^(['"]).*\1$/.test(value)) {
+            value = value.slice(1, -1);
+        }
+        if (value === "true")
+            value = true;
+        if (value === "false")
+            value = false;
+        fm[key] = value;
+    }
+    return { frontmatter: fm, body };
+}
+// ── Single-file loader ──
+function loadSkillFromFile(filePath, source) {
+    const diagnostics = [];
+    try {
+        const rawContent = readFileSync(filePath, "utf-8");
+        const { frontmatter } = parseFrontmatter(rawContent);
+        const skillDir = dirname(filePath);
+        const parentDirName = basename(skillDir);
+        const name = frontmatter.name || parentDirName;
+        const description = frontmatter.description || "";
+        if (!description) {
+            diagnostics.push({ type: "warning", message: "description is required", path: filePath });
+            return { skill: null, diagnostics };
+        }
+        if (name.length > 64) {
+            diagnostics.push({ type: "warning", message: `name exceeds 64 characters (${name.length})`, path: filePath });
+        }
+        return {
+            skill: {
+                name,
+                description,
+                filePath,
+                baseDir: skillDir,
+                source,
+                disableModelInvocation: frontmatter["disable-model-invocation"] === true,
+            },
+            diagnostics,
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : "failed to parse skill file";
+        diagnostics.push({ type: "warning", message, path: filePath });
+        return { skill: null, diagnostics };
+    }
+}
+// ── Directory scanner ──
+function loadSkillsFromDirInternal(dir, source, includeRootFiles) {
+    const skills = [];
+    const diagnostics = [];
+    if (!existsSync(dir))
+        return { skills, diagnostics };
+    try {
+        const entries = readdirSync(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            if (entry.name.startsWith(".") || entry.name === "node_modules")
+                continue;
+            const fullPath = join(dir, entry.name);
+            let isDirectory = entry.isDirectory();
+            let isFile = entry.isFile();
+            if (entry.isSymbolicLink()) {
+                try {
+                    const stats = statSync(fullPath);
+                    isDirectory = stats.isDirectory();
+                    isFile = stats.isFile();
+                }
+                catch {
+                    continue;
+                }
+            }
+            if (isDirectory) {
+                const subResult = loadSkillsFromDirInternal(fullPath, source, false);
+                skills.push(...subResult.skills);
+                diagnostics.push(...subResult.diagnostics);
+                continue;
+            }
+            if (!isFile)
+                continue;
+            const isRootMd = includeRootFiles && entry.name.endsWith(".md");
+            const isSkillMd = !includeRootFiles && entry.name === "SKILL.md";
+            if (!isRootMd && !isSkillMd)
+                continue;
+            const result = loadSkillFromFile(fullPath, source);
+            if (result.skill)
+                skills.push(result.skill);
+            diagnostics.push(...result.diagnostics);
+        }
+    }
+    catch {
+        /* directory unreadable */
+    }
+    return { skills, diagnostics };
+}
+export function loadSkillsFromDir(dir, source) {
+    return loadSkillsFromDirInternal(dir, source, true);
+}
+function normalizePath(input) {
+    const trimmed = input.trim();
+    if (trimmed === "~")
+        return homedir();
+    if (trimmed.startsWith("~/"))
+        return join(homedir(), trimmed.slice(2));
+    return trimmed;
+}
+export function loadSkills(options = {}) {
+    const { cwd = process.cwd(), skillPaths = [], includeDefaults = true } = options;
+    const skillMap = new Map();
+    const realPathSet = new Set();
+    const allDiagnostics = [];
+    function addSkills(result) {
+        allDiagnostics.push(...result.diagnostics);
+        for (const skill of result.skills) {
+            let realPath;
+            try {
+                realPath = realpathSync(skill.filePath);
+            }
+            catch {
+                realPath = skill.filePath;
+            }
+            if (realPathSet.has(realPath))
+                continue;
+            if (skillMap.has(skill.name)) {
+                allDiagnostics.push({
+                    type: "collision",
+                    message: `name "${skill.name}" collision`,
+                    path: skill.filePath,
+                });
+            }
+            else {
+                skillMap.set(skill.name, skill);
+                realPathSet.add(realPath);
+            }
+        }
+    }
+    if (includeDefaults) {
+        addSkills(loadSkillsFromDirInternal(join(homedir(), ".til", "skills"), "user", true));
+        addSkills(loadSkillsFromDirInternal(resolve(cwd, ".til", "skills"), "project", true));
+    }
+    for (const rawPath of skillPaths) {
+        const resolvedPath = isAbsolute(normalizePath(rawPath))
+            ? normalizePath(rawPath)
+            : resolve(cwd, normalizePath(rawPath));
+        if (!existsSync(resolvedPath)) {
+            allDiagnostics.push({ type: "warning", message: "skill path does not exist", path: resolvedPath });
+            continue;
+        }
+        try {
+            const stats = statSync(resolvedPath);
+            if (stats.isDirectory()) {
+                addSkills(loadSkillsFromDirInternal(resolvedPath, "path", true));
+            }
+            else if (stats.isFile() && resolvedPath.endsWith(".md")) {
+                const result = loadSkillFromFile(resolvedPath, "path");
+                if (result.skill)
+                    addSkills({ skills: [result.skill], diagnostics: result.diagnostics });
+                else
+                    allDiagnostics.push(...result.diagnostics);
+            }
+        }
+        catch (error) {
+            const msg = error instanceof Error ? error.message : "failed to read skill path";
+            allDiagnostics.push({ type: "warning", message: msg, path: resolvedPath });
+        }
+    }
+    return { skills: Array.from(skillMap.values()), diagnostics: allDiagnostics };
+}
+// ── System prompt formatting ──
+function escapeXml(str) {
+    return str
+        .replace(/&/g, "&amp;")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;")
+        .replace(/"/g, "&quot;")
+        .replace(/'/g, "&apos;");
+}
+export function formatSkillsForPrompt(skills) {
+    const visible = skills.filter((s) => !s.disableModelInvocation);
+    if (visible.length === 0)
+        return "";
+    const lines = [
+        "\n\nThe following skills provide specialized instructions for specific tasks.",
+        "Use the read tool to load a skill's file when the task matches its description.",
+        "When a skill file references a relative path, resolve it against the skill directory (parent of SKILL.md) and use that absolute path in tool commands.",
+        "",
+        "<available_skills>",
+    ];
+    for (const skill of visible) {
+        lines.push("  <skill>");
+        lines.push(`    <name>${escapeXml(skill.name)}</name>`);
+        lines.push(`    <description>${escapeXml(skill.description)}</description>`);
+        lines.push(`    <location>${escapeXml(skill.filePath)}</location>`);
+        lines.push("  </skill>");
+    }
+    lines.push("</available_skills>");
+    return lines.join("\n");
+}
+//# sourceMappingURL=skills.js.map

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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"}

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

@@ -0,0 +1,17 @@
+/**
+ * System prompt builder for the personal computer assistant.
+ */
+import { type Skill } from "./skills.js";
+import { type MemoryContent, type ContextFile } from "./memory.js";
+export interface SystemPromptOptions {
+    cwd: string;
+    tools: string[];
+    skills?: Skill[];
+    customInstructions?: string;
+    /** Pre-loaded memory (if not provided, loaded fresh from disk) */
+    memory?: MemoryContent;
+    /** Pre-loaded context files (if not provided, loaded fresh from disk) */
+    contextFiles?: ContextFile[];
+}
+export declare function buildSystemPrompt(options: SystemPromptOptions): 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;AAGH,OAAO,EAAyB,KAAK,KAAK,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,EAKN,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,MAAM,aAAa,CAAC;AAErB,MAAM,WAAW,mBAAmB;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC;IACjB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,kEAAkE;IAClE,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,yEAAyE;IACzE,YAAY,CAAC,EAAE,WAAW,EAAE,CAAC;CAC7B;AAaD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,mBAAmB,GAAG,MAAM,CAoEtE"}

package/dist/core/system-prompt.js

@@ -0,0 +1,77 @@
+/**
+ * System prompt builder for the personal computer assistant.
+ */
+import * as os from "node:os";
+import { formatSkillsForPrompt } from "./skills.js";
+import { loadMemory, formatMemoryForPrompt, loadProjectContextFiles, formatContextFilesForPrompt, } from "./memory.js";
+const toolDescriptions = {
+    bash: "Execute bash commands (ls, grep, find, git, etc.)",
+    read: "Read file contents (text files, with offset/limit support)",
+    write: "Create or overwrite files",
+    edit: "Make precise edits to files (find exact text and replace)",
+    system_info: "Get system information (OS, CPU, memory, network, env)",
+    file_manager: "Advanced file operations (copy, move, delete, list, mkdir, info)",
+    web_search: "Search the web for real-time information (supports Brave, Google, DuckDuckGo)",
+    web_fetch: "Fetch and read the content of a web page as text",
+};
+export function buildSystemPrompt(options) {
+    const { cwd, tools, customInstructions } = options;
+    const toolsList = tools
+        .map((t) => `- **${t}**: ${toolDescriptions[t] || t}`)
+        .join("\n");
+    const sections = [];
+    sections.push(`You are TIL, a personal computer assistant running directly on the user's machine.
+You help with a wide range of tasks including:
+- File and directory management
+- System administration and monitoring
+- Software development and code editing
+- Information lookup and research
+- Task automation and scripting
+- Troubleshooting and debugging
+
+You have direct access to the user's filesystem and can execute commands.`);
+    sections.push(`## Available Tools
+
+${toolsList}`);
+    sections.push(`## Guidelines
+
+1. **Be concise**: Give short, direct answers. Explain only when asked.
+2. **Safety first**: For destructive operations (delete, overwrite, system changes), explain what you're about to do and proceed carefully.
+3. **Use the right tool**: Prefer edit over write when modifying existing files. Use bash for complex operations that tools don't cover directly.
+4. **Respect the user's system**: Don't install software or make system-level changes without being asked. Don't modify files outside the working directory unless instructed.
+5. **Error handling**: If a command or operation fails, explain what went wrong and suggest alternatives.
+6. **File paths**: Always resolve relative paths from the current working directory. Support ~ for home directory.
+7. **Large outputs**: When output is truncated, inform the user and suggest how to see more.
+8. **Code changes**: When editing code, preserve the existing style and conventions. Make minimal, targeted changes.
+9. **Security**: Never output API keys, passwords, or other secrets. Warn if you detect credentials in files.
+10. **Chinese support**: Respond in the user's language. Support Chinese filenames and content.`);
+    if (customInstructions) {
+        sections.push(`## Custom Instructions\n\n${customInstructions}`);
+    }
+    // Memory — re-read from disk each time to pick up LLM writes
+    const memory = options.memory ?? loadMemory(cwd);
+    sections.push(formatMemoryForPrompt(memory, cwd));
+    // Project context (AGENTS.md)
+    const contextFiles = options.contextFiles ?? loadProjectContextFiles(cwd);
+    const contextBlock = formatContextFilesForPrompt(contextFiles);
+    if (contextBlock)
+        sections.push(contextBlock);
+    // Skills (only if the read tool is available so the LLM can load them)
+    const hasRead = tools.includes("read");
+    if (hasRead && options.skills && options.skills.length > 0) {
+        const skillsBlock = formatSkillsForPrompt(options.skills);
+        if (skillsBlock)
+            sections.push(skillsBlock);
+    }
+    sections.push(`## Environment
+
+- Current date: ${new Date().toISOString().split("T")[0]}
+- Current time: ${new Date().toLocaleTimeString()}
+- Working directory: ${cwd}
+- OS: ${os.platform()} ${os.arch()} (${os.release()})
+- Node.js: ${process.version}
+- User: ${os.userInfo().username}
+- Shell: ${process.env.SHELL || "unknown"}`);
+    return sections.join("\n\n");
+}
+//# 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":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,EAAE,qBAAqB,EAAc,MAAM,aAAa,CAAC;AAChE,OAAO,EACN,UAAU,EACV,qBAAqB,EACrB,uBAAuB,EACvB,2BAA2B,GAG3B,MAAM,aAAa,CAAC;AAarB,MAAM,gBAAgB,GAA2B;IAChD,IAAI,EAAE,mDAAmD;IACzD,IAAI,EAAE,4DAA4D;IAClE,KAAK,EAAE,2BAA2B;IAClC,IAAI,EAAE,2DAA2D;IACjE,WAAW,EAAE,wDAAwD;IACrE,YAAY,EAAE,kEAAkE;IAChF,UAAU,EAAE,+EAA+E;IAC3F,SAAS,EAAE,kDAAkD;CAC7D,CAAC;AAEF,MAAM,UAAU,iBAAiB,CAAC,OAA4B;IAC7D,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,kBAAkB,EAAE,GAAG,OAAO,CAAC;IAEnD,MAAM,SAAS,GAAG,KAAK;SACrB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,gBAAgB,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;SACrD,IAAI,CAAC,IAAI,CAAC,CAAC;IAEb,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,QAAQ,CAAC,IAAI,CAAC;;;;;;;;;0EAS2D,CAAC,CAAC;IAE3E,QAAQ,CAAC,IAAI,CAAC;;EAEb,SAAS,EAAE,CAAC,CAAC;IAEd,QAAQ,CAAC,IAAI,CAAC;;;;;;;;;;;gGAWiF,CAAC,CAAC;IAEjG,IAAI,kBAAkB,EAAE,CAAC;QACxB,QAAQ,CAAC,IAAI,CAAC,6BAA6B,kBAAkB,EAAE,CAAC,CAAC;IAClE,CAAC;IAED,6DAA6D;IAC7D,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,UAAU,CAAC,GAAG,CAAC,CAAC;IACjD,QAAQ,CAAC,IAAI,CAAC,qBAAqB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC;IAElD,8BAA8B;IAC9B,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,uBAAuB,CAAC,GAAG,CAAC,CAAC;IAC1E,MAAM,YAAY,GAAG,2BAA2B,CAAC,YAAY,CAAC,CAAC;IAC/D,IAAI,YAAY;QAAE,QAAQ,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAE9C,uEAAuE;IACvE,MAAM,OAAO,GAAG,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IACvC,IAAI,OAAO,IAAI,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5D,MAAM,WAAW,GAAG,qBAAqB,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAC1D,IAAI,WAAW;YAAE,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC7C,CAAC;IAED,QAAQ,CAAC,IAAI,CAAC;;kBAEG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;kBACtC,IAAI,IAAI,EAAE,CAAC,kBAAkB,EAAE;uBAC1B,GAAG;QAClB,EAAE,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,OAAO,EAAE;aACtC,OAAO,CAAC,OAAO;UAClB,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ;WACrB,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,SAAS,EAAE,CAAC,CAAC;IAE5C,OAAO,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC9B,CAAC"}

package/dist/core/tool-permissions.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Tool permission system.
+ * Detects dangerous commands and provides an approval flow.
+ */
+export declare const DANGEROUS_PATTERNS: RegExp[];
+export declare function isDangerousCommand(command: string): boolean;
+export declare function getDangerReason(command: string): string | undefined;
+export declare function createToolCallRequestHandler(hasUI: boolean, promptUser?: (question: string) => Promise<string>): (toolName: string, args: Record<string, any>) => Promise<{
+    block: boolean;
+    reason?: string;
+}>;
+//# sourceMappingURL=tool-permissions.d.ts.map

package/dist/core/tool-permissions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-permissions.d.ts","sourceRoot":"","sources":["../../src/core/tool-permissions.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,eAAO,MAAM,kBAAkB,EAAE,MAAM,EAgBtC,CAAC;AAEF,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAE3D;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAkBnE;AAED,wBAAgB,4BAA4B,CAC3C,KAAK,EAAE,OAAO,EACd,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,GAChD,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,OAAO,CAAC;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAoB/F"}

package/dist/core/tool-permissions.js

@@ -0,0 +1,71 @@
+/**
+ * Tool permission system.
+ * Detects dangerous commands and provides an approval flow.
+ */
+export const DANGEROUS_PATTERNS = [
+    /\brm\s+(-[a-zA-Z]*r[a-zA-Z]*f|--recursive)\b/i,
+    /\brm\s+-[a-zA-Z]*f[a-zA-Z]*r\b/i,
+    /\bsudo\b/i,
+    /\b(chmod|chown)\b.*\b777\b/,
+    /\bmkfs\b/i,
+    /\bdd\s+if=/i,
+    />\s*\/dev\//,
+    /:\(\)\s*\{/,
+    /\bkill\s+-9\b/,
+    /\bshutdown\b/i,
+    /\breboot\b/i,
+    /\bformat\s+[a-z]:/i,
+    /\bnpx\s.*\b(rimraf|del-cli)\b.*\//,
+    /\bgit\s+push\s+.*--force\b/i,
+    /\bgit\s+reset\s+--hard\b/i,
+];
+export function isDangerousCommand(command) {
+    return DANGEROUS_PATTERNS.some((p) => p.test(command));
+}
+export function getDangerReason(command) {
+    for (const pattern of DANGEROUS_PATTERNS) {
+        if (pattern.test(command)) {
+            if (/\brm\s/.test(command))
+                return "递归/强制删除文件";
+            if (/\bsudo\b/.test(command))
+                return "以超级用户权限执行";
+            if (/\b(chmod|chown)\b/.test(command))
+                return "修改文件权限为完全开放";
+            if (/\bmkfs\b/.test(command))
+                return "格式化磁盘分区";
+            if (/\bdd\s/.test(command))
+                return "底层磁盘操作";
+            if (/\/dev\//.test(command))
+                return "写入系统设备文件";
+            if (/:\(\)/.test(command))
+                return "Fork 炸弹";
+            if (/\bkill\s/.test(command))
+                return "强制终止进程";
+            if (/\bshutdown\b/.test(command) || /\breboot\b/.test(command))
+                return "系统关机/重启";
+            if (/--force/.test(command))
+                return "强制推送可能覆盖远程历史";
+            if (/--hard/.test(command))
+                return "硬重置将丢失未提交的更改";
+            return "潜在的危险操作";
+        }
+    }
+    return undefined;
+}
+export function createToolCallRequestHandler(hasUI, promptUser) {
+    return async (toolName, args) => {
+        if (toolName !== "bash")
+            return { block: false };
+        const command = args.command;
+        if (!command || !isDangerousCommand(command))
+            return { block: false };
+        const reason = getDangerReason(command) || "危险命令";
+        if (!hasUI || !promptUser) {
+            return { block: true, reason: `${reason} — 非交互模式下自动拒绝` };
+        }
+        const answer = await promptUser(`⚠️  危险命令检测: ${reason}\n   $ ${command}\n   允许执行? [y/N] `);
+        const allowed = answer.trim().toLowerCase() === "y";
+        return allowed ? { block: false } : { block: true, reason: `${reason} — 用户拒绝` };
+    };
+}
+//# sourceMappingURL=tool-permissions.js.map

package/dist/core/tool-permissions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-permissions.js","sourceRoot":"","sources":["../../src/core/tool-permissions.ts"],"names":[],"mappings":"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"}

package/dist/core/types.d.ts

@@ -0,0 +1,157 @@
+/**
+ * Core type definitions for the agent runtime.
+ * Inspired by pi-mono's architecture (pi-ai + pi-agent-core).
+ */
+export interface TextContent {
+    type: "text";
+    text: string;
+}
+export interface ImageContent {
+    type: "image";
+    data: string;
+    mimeType: string;
+}
+export interface ThinkingContent {
+    type: "thinking";
+    thinking: string;
+}
+export interface ToolCall {
+    type: "toolCall";
+    id: string;
+    name: string;
+    arguments: Record<string, any>;
+}
+export interface UserMessage {
+    role: "user";
+    content: string | (TextContent | ImageContent)[];
+    timestamp: number;
+}
+export interface Usage {
+    input: number;
+    output: number;
+    cacheRead: number;
+    cacheWrite: number;
+    totalTokens?: number;
+    cost?: {
+        input: number;
+        output: number;
+        cacheRead: number;
+        cacheWrite: number;
+        total: number;
+    };
+}
+export declare function createEmptyUsage(): Usage;
+export declare function addUsage(target: Usage, source: Usage): void;
+export interface AssistantMessage {
+    role: "assistant";
+    content: (TextContent | ThinkingContent | ToolCall)[];
+    model?: string;
+    provider?: string;
+    stopReason?: "end" | "toolCall" | "aborted" | "error";
+    errorMessage?: string;
+    usage?: Usage;
+    timestamp: number;
+}
+export interface ToolResultMessage {
+    role: "toolResult";
+    toolCallId: string;
+    toolName: string;
+    content: (TextContent | ImageContent)[];
+    isError: boolean;
+    timestamp: number;
+}
+export type Message = UserMessage | AssistantMessage | ToolResultMessage;
+export interface ToolParameter {
+    type: string;
+    description?: string;
+    required?: boolean;
+    enum?: string[];
+    properties?: Record<string, ToolParameter>;
+    items?: ToolParameter;
+}
+export interface ToolSchema {
+    type: "object";
+    properties: Record<string, ToolParameter>;
+    required?: string[];
+}
+export interface Tool {
+    name: string;
+    description: string;
+    parameters: ToolSchema;
+}
+export interface AgentToolResult {
+    content: (TextContent | ImageContent)[];
+    details?: any;
+}
+export type AgentToolUpdateCallback = (partialResult: AgentToolResult) => void;
+export interface AgentTool extends Tool {
+    label: string;
+    execute: (toolCallId: string, params: Record<string, any>, signal?: AbortSignal, onUpdate?: AgentToolUpdateCallback) => Promise<AgentToolResult>;
+}
+export type ThinkingLevel = "off" | "low" | "medium" | "high";
+export interface AgentState {
+    systemPrompt: string;
+    model: ModelConfig;
+    thinkingLevel: ThinkingLevel;
+    tools: AgentTool[];
+    messages: Message[];
+    isStreaming: boolean;
+    error?: string;
+}
+export interface ModelConfig {
+    provider: "anthropic" | "openai" | "openai-compatible" | "google" | string;
+    id: string;
+    name: string;
+    apiKey?: string;
+    baseUrl?: string;
+    maxTokens?: number;
+    contextWindow?: number;
+    /** Extra headers sent with every LLM request (e.g. org-id, auth tokens) */
+    headers?: Record<string, string>;
+}
+export type AgentEvent = {
+    type: "agent_start";
+} | {
+    type: "agent_end";
+    messages: Message[];
+} | {
+    type: "turn_start";
+} | {
+    type: "turn_end";
+    message: Message;
+    toolResults: ToolResultMessage[];
+} | {
+    type: "message_start";
+    message: Message;
+} | {
+    type: "message_update";
+    message: AssistantMessage;
+    delta: string;
+} | {
+    type: "message_end";
+    message: Message;
+} | {
+    type: "tool_execution_start";
+    toolCallId: string;
+    toolName: string;
+    args: any;
+} | {
+    type: "tool_execution_update";
+    toolCallId: string;
+    toolName: string;
+    partialResult: any;
+} | {
+    type: "tool_execution_end";
+    toolCallId: string;
+    toolName: string;
+    result: any;
+    isError: boolean;
+} | {
+    type: "compaction_start";
+    reason: "overflow" | "threshold";
+} | {
+    type: "compaction_end";
+    tokensBefore: number;
+    tokensAfter: number;
+};
+//# sourceMappingURL=types.d.ts.map