@xopcai/xopcbot 0.1.0

package/dist/agent/skills/types.d.ts

@@ -0,0 +1,181 @@
+/**
+ * Skill System Types
+ *
+ * Inspired by openclaw's skill architecture
+ */
+export type SkillInstallKind = 'pnpm' | 'npm' | 'yarn' | 'bun' | 'brew' | 'go' | 'uv' | 'download';
+export interface SkillInstallSpec {
+    /** Unique identifier for this install spec */
+    id?: string;
+    /** Installation method */
+    kind: SkillInstallKind;
+    /** Package name (for node/uv) */
+    package?: string;
+    /** Formula name (for brew) */
+    formula?: string;
+    /** Go module path (for go) */
+    module?: string;
+    /** Download URL (for download) */
+    url?: string;
+    /** Expected binaries after installation */
+    bins?: string[];
+    /** Human-readable label */
+    label?: string;
+    /** Platform restrictions */
+    os?: Array<'darwin' | 'linux' | 'win32'>;
+}
+export interface SkillRequires {
+    /** Required binaries */
+    bins?: string[];
+    /** Required environment variables */
+    env?: string[];
+    /** Any of these binaries (OR condition) */
+    anyBins?: string[];
+}
+export interface SkillMetadata {
+    /** Skill name (from frontmatter) */
+    name: string;
+    /** Skill description (from frontmatter) */
+    description: string;
+    /** Emoji icon for UI */
+    emoji?: string;
+    /** Homepage URL */
+    homepage?: string;
+    /** Platform restrictions */
+    os?: Array<'darwin' | 'linux' | 'win32'>;
+    /** Requirements */
+    requires?: SkillRequires;
+    /** Installation specs */
+    install?: SkillInstallSpec[];
+    /** OpenClaw compatibility metadata */
+    openclaw?: {
+        emoji?: string;
+        requires?: SkillRequires;
+        install?: SkillInstallSpec[];
+        os?: Array<'darwin' | 'linux' | 'win32'>;
+    };
+}
+export interface SkillConfig {
+    /** Whether the skill is enabled */
+    enabled?: boolean;
+    /** API key for the skill */
+    apiKey?: string;
+    /** Environment variables */
+    env?: Record<string, string>;
+    /** Custom configuration */
+    config?: Record<string, unknown>;
+}
+export interface SkillsLoadConfig {
+    /** Additional skill folders to scan */
+    extraDirs?: string[];
+    /** Watch skill folders for changes */
+    watch?: boolean;
+    /** Debounce for the skills watcher (ms) */
+    watchDebounceMs?: number;
+}
+export interface SkillsInstallConfig {
+    /** Prefer brew for package installation */
+    preferBrew?: boolean;
+    /** Node package manager preference */
+    nodeManager?: 'pnpm' | 'npm' | 'yarn' | 'bun';
+}
+export interface SkillsLimitsConfig {
+    /** Max number of immediate child directories to consider */
+    maxCandidatesPerRoot?: number;
+    /** Max number of skills to load per source */
+    maxSkillsLoadedPerSource?: number;
+    /** Max number of skills to include in prompt */
+    maxSkillsInPrompt?: number;
+    /** Max characters for skills prompt */
+    maxSkillsPromptChars?: number;
+    /** Max size (bytes) for SKILL.md file */
+    maxSkillFileBytes?: number;
+}
+export interface SkillsConfig {
+    /** Bundled skill allowlist */
+    allowBundled?: string[];
+    /** Load configuration */
+    load?: SkillsLoadConfig;
+    /** Install configuration */
+    install?: SkillsInstallConfig;
+    /** Limits configuration */
+    limits?: SkillsLimitsConfig;
+    /** Per-skill configuration */
+    entries?: Record<string, SkillConfig>;
+}
+export interface Skill {
+    /** Skill name */
+    name: string;
+    /** Skill description */
+    description: string;
+    /** Path to SKILL.md file */
+    filePath: string;
+    /** Base directory of the skill */
+    baseDir: string;
+    /** Source of the skill */
+    source: 'builtin' | 'workspace' | 'global' | 'extra';
+    /** Disable model invocation for this skill */
+    disableModelInvocation: boolean;
+    /** Parsed metadata */
+    metadata: SkillMetadata;
+    /** Raw content of SKILL.md */
+    content: string;
+}
+export interface SkillEntry {
+    skill: Skill;
+    metadata: SkillMetadata;
+    enabled: boolean;
+    config?: SkillConfig;
+}
+export interface SkillEligibilityContext {
+    /** Current platform */
+    platform: string;
+    /** Available binaries */
+    hasBin: (bin: string) => boolean;
+    /** Has any of these binaries */
+    hasAnyBin: (bins: string[]) => boolean;
+    /** Remote node context */
+    remote?: {
+        platforms: string[];
+        hasBin: (bin: string) => boolean;
+        hasAnyBin: (bins: string[]) => boolean;
+        note?: string;
+    };
+}
+export interface SkillInstallRequest {
+    workspaceDir: string;
+    skillName: string;
+    installId: string;
+    timeoutMs?: number;
+}
+export interface SkillInstallResult {
+    /** Whether installation succeeded */
+    ok: boolean;
+    /** Human-readable message */
+    message: string;
+    /** stdout from install command */
+    stdout: string;
+    /** stderr from install command */
+    stderr: string;
+    /** Exit code */
+    code: number | null;
+    /** Warnings (e.g., security scan findings) */
+    warnings?: string[];
+}
+export interface LoadSkillsResult {
+    skills: Skill[];
+    prompt: string;
+    diagnostics: SkillDiagnostic[];
+}
+export interface SkillDiagnostic {
+    type: 'warning' | 'collision' | 'error';
+    skillName?: string;
+    message: string;
+    path?: string;
+}
+export interface SkillSnapshot {
+    version: string;
+    skills: SkillEntry[];
+    loadedAt: number;
+    workspaceDir: string;
+}

package/dist/agent/skills/types.js

@@ -0,0 +1,7 @@
+/**
+ * Skill System Types
+ *
+ * Inspired by openclaw's skill architecture
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/agent/skills/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/agent/skills/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/agent/skills/watcher.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Skill Watcher
+ *
+ * Watches skill directories for changes and triggers reloads.
+ * Inspired by openclaw's skills refresh system
+ */
+import type { SkillLoader } from './index.js';
+export interface SkillWatcherOptions {
+    /** Debounce time in milliseconds */
+    debounceMs?: number;
+    /** Watch these directories */
+    watchDirs: string[];
+}
+export interface SkillWatcher {
+    /** Start watching */
+    start: () => void;
+    /** Stop watching */
+    stop: () => void;
+    /** Check if watching is active */
+    isWatching: () => boolean;
+    /** Get last refresh time */
+    getLastRefreshTime: () => number;
+}
+/**
+ * Create a skill watcher
+ */
+export declare function createSkillWatcher(loader: SkillLoader, options: SkillWatcherOptions): SkillWatcher;
+/**
+ * Create a skill watcher from loader configuration
+ */
+export declare function createWatcherFromLoader(loader: SkillLoader, options: {
+    workspaceDir?: string;
+    builtinDir?: string;
+    globalDirs?: string[];
+    extraDirs?: string[];
+    debounceMs?: number;
+}): SkillWatcher | null;

package/dist/agent/skills/watcher.js

@@ -0,0 +1,124 @@
+/**
+ * Skill Watcher
+ *
+ * Watches skill directories for changes and triggers reloads.
+ * Inspired by openclaw's skills refresh system
+ */
+import { watch } from 'fs';
+import { join } from 'path';
+import { createLogger } from '../../utils/logger.js';
+const log = createLogger('SkillWatcher');
+/**
+ * Create a debounced reload function
+ */
+function createDebouncedReload(loader, debounceMs) {
+    let timeout = null;
+    let pendingReload = false;
+    return () => {
+        if (timeout) {
+            pendingReload = true;
+            return;
+        }
+        timeout = setTimeout(() => {
+            timeout = null;
+            if (pendingReload) {
+                pendingReload = false;
+                loader.reload();
+                log.info('Skills reloaded after directory changes');
+            }
+        }, debounceMs);
+    };
+}
+/**
+ * Create a skill watcher
+ */
+export function createSkillWatcher(loader, options) {
+    const { watchDirs, debounceMs = 1000 } = options;
+    const watchers = [];
+    const debouncedReload = createDebouncedReload(loader, debounceMs);
+    let isWatching = false;
+    let lastRefreshTime = Date.now();
+    function watchDirectory(dir) {
+        try {
+            const watcher = watch(dir, { recursive: true }, (eventType, filename) => {
+                if (!filename)
+                    return;
+                // Only care about SKILL.md files
+                if (filename.toLowerCase() === 'skill.md') {
+                    log.debug({ eventType, filename, dir }, 'Skill file changed');
+                    lastRefreshTime = Date.now();
+                    debouncedReload();
+                }
+                // Also watch for new directories (potential new skills)
+                if (eventType === 'rename') {
+                    log.debug({ eventType, filename, dir }, 'Directory changed, may be new skill');
+                    lastRefreshTime = Date.now();
+                    debouncedReload();
+                }
+            });
+            watchers.push({ watcher, dir });
+            log.info({ dir }, 'Watching skill directory');
+        }
+        catch (err) {
+            log.warn({ dir, error: err }, 'Failed to watch skill directory');
+        }
+    }
+    return {
+        start: () => {
+            if (isWatching) {
+                log.warn('Watcher already started');
+                return;
+            }
+            for (const dir of watchDirs) {
+                watchDirectory(dir);
+            }
+            isWatching = true;
+            log.info({ dirs: watchDirs }, 'Skill watcher started');
+        },
+        stop: () => {
+            if (!isWatching) {
+                return;
+            }
+            for (const { watcher } of watchers) {
+                watcher.close();
+            }
+            watchers.length = 0;
+            isWatching = false;
+            log.info('Skill watcher stopped');
+        },
+        isWatching: () => isWatching,
+        getLastRefreshTime: () => lastRefreshTime,
+    };
+}
+/**
+ * Create a skill watcher from loader configuration
+ */
+export function createWatcherFromLoader(loader, options) {
+    const watchDirs = [];
+    // Add workspace skills directory
+    if (options.workspaceDir) {
+        const workspaceSkillsDir = join(options.workspaceDir, 'skills');
+        watchDirs.push(workspaceSkillsDir);
+    }
+    // Add builtin directory
+    if (options.builtinDir) {
+        watchDirs.push(options.builtinDir);
+    }
+    // Add global directories
+    if (options.globalDirs) {
+        watchDirs.push(...options.globalDirs);
+    }
+    // Add extra directories
+    if (options.extraDirs) {
+        watchDirs.push(...options.extraDirs);
+    }
+    if (watchDirs.length === 0) {
+        log.warn('No directories to watch');
+        return null;
+    }
+    return createSkillWatcher(loader, {
+        watchDirs,
+        debounceMs: options.debounceMs ?? 1000,
+    });
+}
+//# sourceMappingURL=watcher.js.map

package/dist/agent/skills/watcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"watcher.js","sourceRoot":"","sources":["../../../src/agent/skills/watcher.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,IAAI,CAAC;AAC3B,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAGrD,MAAM,GAAG,GAAG,YAAY,CAAC,cAAc,CAAC,CAAC;AAoBzC;;GAEG;AACH,SAAS,qBAAqB,CAC5B,MAAmB,EACnB,UAAkB;IAElB,IAAI,OAAO,GAA0B,IAAI,CAAC;IAC1C,IAAI,aAAa,GAAG,KAAK,CAAC;IAE1B,OAAO,GAAG,EAAE;QACV,IAAI,OAAO,EAAE,CAAC;YACZ,aAAa,GAAG,IAAI,CAAC;YACrB,OAAO;QACT,CAAC;QAED,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE;YACxB,OAAO,GAAG,IAAI,CAAC;YAEf,IAAI,aAAa,EAAE,CAAC;gBAClB,aAAa,GAAG,KAAK,CAAC;gBACtB,MAAM,CAAC,MAAM,EAAE,CAAC;gBAChB,GAAG,CAAC,IAAI,CAAC,yCAAyC,CAAC,CAAC;YACtD,CAAC;QACH,CAAC,EAAE,UAAU,CAAC,CAAC;IACjB,CAAC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAChC,MAAmB,EACnB,OAA4B;IAE5B,MAAM,EAAE,SAAS,EAAE,UAAU,GAAG,IAAI,EAAE,GAAG,OAAO,CAAC;IAEjD,MAAM,QAAQ,GAA8D,EAAE,CAAC;IAC/E,MAAM,eAAe,GAAG,qBAAqB,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAClE,IAAI,UAAU,GAAG,KAAK,CAAC;IACvB,IAAI,eAAe,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAEjC,SAAS,cAAc,CAAC,GAAW;QACjC,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,CAAC,SAAS,EAAE,QAAQ,EAAE,EAAE;gBACtE,IAAI,CAAC,QAAQ;oBAAE,OAAO;gBAEtB,iCAAiC;gBACjC,IAAI,QAAQ,CAAC,WAAW,EAAE,KAAK,UAAU,EAAE,CAAC;oBAC1C,GAAG,CAAC,KAAK,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,EAAE,EAAE,oBAAoB,CAAC,CAAC;oBAC9D,eAAe,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;oBAC7B,eAAe,EAAE,CAAC;gBACpB,CAAC;gBAED,wDAAwD;gBACxD,IAAI,SAAS,KAAK,QAAQ,EAAE,CAAC;oBAC3B,GAAG,CAAC,KAAK,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,EAAE,EAAE,qCAAqC,CAAC,CAAC;oBAC/E,eAAe,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;oBAC7B,eAAe,EAAE,CAAC;gBACpB,CAAC;YACH,CAAC,CAAC,CAAC;YAEH,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC;YAChC,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,EAAE,0BAA0B,CAAC,CAAC;QAChD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,iCAAiC,CAAC,CAAC;QACnE,CAAC;IACH,CAAC;IAED,OAAO;QACL,KAAK,EAAE,GAAG,EAAE;YACV,IAAI,UAAU,EAAE,CAAC;gBACf,GAAG,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;gBACpC,OAAO;YACT,CAAC;YAED,KAAK,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC;gBAC5B,cAAc,CAAC,GAAG,CAAC,CAAC;YACtB,CAAC;YAED,UAAU,GAAG,IAAI,CAAC;YAClB,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,uBAAuB,CAAC,CAAC;QACzD,CAAC;QAED,IAAI,EAAE,GAAG,EAAE;YACT,IAAI,CAAC,UAAU,EAAE,CAAC;gBAChB,OAAO;YACT,CAAC;YAED,KAAK,MAAM,EAAE,OAAO,EAAE,IAAI,QAAQ,EAAE,CAAC;gBACnC,OAAO,CAAC,KAAK,EAAE,CAAC;YAClB,CAAC;YAED,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;YACpB,UAAU,GAAG,KAAK,CAAC;YACnB,GAAG,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;QACpC,CAAC;QAED,UAAU,EAAE,GAAG,EAAE,CAAC,UAAU;QAE5B,kBAAkB,EAAE,GAAG,EAAE,CAAC,eAAe;KAC1C,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB,CACrC,MAAmB,EACnB,OAMC;IAED,MAAM,SAAS,GAAa,EAAE,CAAC;IAE/B,iCAAiC;IACjC,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;QACzB,MAAM,kBAAkB,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;QAChE,SAAS,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;IACrC,CAAC;IAED,wBAAwB;IACxB,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;QACvB,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IACrC,CAAC;IAED,yBAAyB;IACzB,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;QACvB,SAAS,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IACxC,CAAC;IAED,wBAAwB;IACxB,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;QACtB,SAAS,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IACvC,CAAC;IAED,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3B,GAAG,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;QACpC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,kBAAkB,CAAC,MAAM,EAAE;QAChC,SAAS;QACT,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,IAAI;KACvC,CAAC,CAAC;AACL,CAAC"}

package/dist/agent/tools/communication.d.ts

@@ -0,0 +1,18 @@
+import type { AgentTool } from '@mariozechner/pi-agent-core';
+import type { MessageBus } from '../../bus/index.js';
+declare const MessageSendSchema: import("@sinclair/typebox/build/cjs/index.js").TObject<{
+    content: import("@sinclair/typebox/build/cjs/index.js").TString;
+    mediaUrl: import("@sinclair/typebox/build/cjs/index.js").TOptional<import("@sinclair/typebox/build/cjs/index.js").TString>;
+    mediaType: import("@sinclair/typebox/build/cjs/index.js").TOptional<import("@sinclair/typebox/build/cjs/index.js").TEnum<{
+        photo: "photo";
+        video: "video";
+        audio: "audio";
+        document: "document";
+    }>>;
+}>;
+interface MessageContext {
+    channel: string;
+    chatId: string;
+}
+export declare function createMessageTool(bus: MessageBus, getContext: () => MessageContext | null): AgentTool<typeof MessageSendSchema, {}>;
+export {};

package/dist/agent/tools/communication.js

@@ -0,0 +1,56 @@
+// Message tool
+import { Type } from '@sinclair/typebox';
+const MessageSendSchema = Type.Object({
+    content: Type.String({ description: 'The message content to send' }),
+    mediaUrl: Type.Optional(Type.String({ description: 'URL of the media to send (photo, video, audio, document)' })),
+    mediaType: Type.Optional(Type.Enum({
+        photo: 'photo',
+        video: 'video',
+        audio: 'audio',
+        document: 'document',
+    }, { description: 'Type of media to send' })),
+});
+export function createMessageTool(bus, getContext) {
+    return {
+        name: 'send_message',
+        description: 'Send a message to the current conversation.',
+        parameters: MessageSendSchema,
+        label: '💬 Send Message',
+        async execute(toolCallId, params, _signal) {
+            const ctx = getContext();
+            if (!ctx) {
+                return {
+                    content: [{ type: 'text', text: 'Error: No active conversation context' }],
+                    details: {},
+                };
+            }
+            try {
+                const msg = {
+                    channel: ctx.channel,
+                    chat_id: ctx.chatId,
+                    content: params.content,
+                    mediaUrl: params.mediaUrl,
+                    mediaType: params.mediaType,
+                };
+                await bus.publishOutbound(msg);
+                const mediaInfo = params.mediaUrl ? ` (with ${params.mediaType || 'media'})` : '';
+                return {
+                    content: [{ type: 'text', text: `Message sent successfully${mediaInfo}` }],
+                    details: {},
+                };
+            }
+            catch (error) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `Send error: ${error instanceof Error ? error.message : String(error)}`,
+                        },
+                    ],
+                    details: {},
+                };
+            }
+        },
+    };
+}
+//# sourceMappingURL=communication.js.map

package/dist/agent/tools/communication.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"communication.js","sourceRoot":"","sources":["../../../src/agent/tools/communication.ts"],"names":[],"mappings":"AAAA,eAAe;AACf,OAAO,EAAE,IAAI,EAAe,MAAM,mBAAmB,CAAC;AAItD,MAAM,iBAAiB,GAAG,IAAI,CAAC,MAAM,CAAC;IACpC,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,6BAA6B,EAAE,CAAC;IACpE,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,0DAA0D,EAAE,CAAC,CAAC;IACjH,SAAS,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC;QACjC,KAAK,EAAE,OAAO;QACd,KAAK,EAAE,OAAO;QACd,KAAK,EAAE,OAAO;QACd,QAAQ,EAAE,UAAU;KACrB,EAAE,EAAE,WAAW,EAAE,uBAAuB,EAAE,CAAC,CAAC;CAC9C,CAAC,CAAC;AAOH,MAAM,UAAU,iBAAiB,CAC/B,GAAe,EACf,UAAuC;IAEvC,OAAO;QACL,IAAI,EAAE,cAAc;QACpB,WAAW,EAAE,6CAA6C;QAC1D,UAAU,EAAE,iBAAiB;QAC7B,KAAK,EAAE,iBAAiB;QAExB,KAAK,CAAC,OAAO,CACX,UAAkB,EAClB,MAAwC,EACxC,OAAqB;YAErB,MAAM,GAAG,GAAG,UAAU,EAAE,CAAC;YACzB,IAAI,CAAC,GAAG,EAAE,CAAC;gBACT,OAAO;oBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,uCAAuC,EAAE,CAAC;oBAC1E,OAAO,EAAE,EAAE;iBACZ,CAAC;YACJ,CAAC;YAED,IAAI,CAAC;gBACH,MAAM,GAAG,GAAoB;oBAC3B,OAAO,EAAE,GAAG,CAAC,OAAO;oBACpB,OAAO,EAAE,GAAG,CAAC,MAAM;oBACnB,OAAO,EAAE,MAAM,CAAC,OAAO;oBACvB,QAAQ,EAAE,MAAM,CAAC,QAAQ;oBACzB,SAAS,EAAE,MAAM,CAAC,SAAiE;iBACpF,CAAC;gBAEF,MAAM,GAAG,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC;gBAE/B,MAAM,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU,MAAM,CAAC,SAAS,IAAI,OAAO,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;gBAClF,OAAO;oBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,4BAA4B,SAAS,EAAE,EAAE,CAAC;oBAC1E,OAAO,EAAE,EAAE;iBACZ,CAAC;YACJ,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,eAAe,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;yBAC9E;qBACF;oBACD,OAAO,EAAE,EAAE;iBACZ,CAAC;YACJ,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/agent/tools/edit-diff.d.ts

@@ -0,0 +1,21 @@
+export declare function detectLineEnding(content: string): '\r\n' | '\n';
+export declare function normalizeToLF(text: string): string;
+export declare function restoreLineEndings(text: string, ending: '\r\n' | '\n'): string;
+export declare function normalizeForFuzzyMatch(text: string): string;
+export interface FuzzyMatchResult {
+    found: boolean;
+    index: number;
+    matchLength: number;
+    usedFuzzyMatch: boolean;
+    originalText: string;
+    matchedText: string;
+    contentForReplacement: string;
+}
+export declare function fuzzyFindText(original: string, search: string, options?: {
+    ignoreWhitespace?: boolean;
+    ignoreCase?: boolean;
+}): FuzzyMatchResult;
+export declare function stripBom(text: string): string;
+export declare function generateDiffString(oldText: string, newText: string, filePath: string, options?: {
+    contextLines?: number;
+}): string;

package/dist/agent/tools/edit-diff.js

@@ -0,0 +1,69 @@
+// Diff utilities for edit tool
+export function detectLineEnding(content) {
+    const crlfIdx = content.indexOf('\r\n');
+    const lfIdx = content.indexOf('\n');
+    if (lfIdx === -1)
+        return '\n';
+    if (crlfIdx === -1)
+        return '\n';
+    return crlfIdx < lfIdx ? '\r\n' : '\n';
+}
+export function normalizeToLF(text) {
+    return text.replace(/\r\n/g, '\n').replace(/\r/g, '\n');
+}
+export function restoreLineEndings(text, ending) {
+    return ending === '\r\n' ? text.replace(/\n/g, '\r\n') : text;
+}
+export function normalizeForFuzzyMatch(text) {
+    return text
+        .split('\n').map(line => line.trimEnd()).join('\n')
+        .replace(/[\u2018\u2019\u201A\u201B]/g, "'")
+        .replace(/[\u201C\u201D\u201E\u201F]/g, '"')
+        .replace(/[\u2010\u2011\u2012\u2013\u2014\u2015\u2212]/g, '-')
+        .replace(/[\u00A0\u2002-\u200A\u202F\u205F\u3000]/g, ' ');
+}
+export function fuzzyFindText(original, search, options = {}) {
+    const { ignoreWhitespace = true, ignoreCase = false } = options;
+    // Exact match first
+    const exactIdx = ignoreCase
+        ? original.toLowerCase().indexOf(search.toLowerCase())
+        : original.indexOf(search);
+    if (exactIdx !== -1) {
+        return { found: true, index: exactIdx, matchLength: search.length, usedFuzzyMatch: false, originalText: search, matchedText: search, contentForReplacement: original };
+    }
+    // Fuzzy match
+    const normalizedOriginal = ignoreWhitespace ? normalizeForFuzzyMatch(original) : original;
+    const normalizedSearch = ignoreWhitespace ? normalizeForFuzzyMatch(search) : search;
+    const fuzzyIdx = ignoreCase
+        ? normalizedOriginal.toLowerCase().indexOf(normalizedSearch.toLowerCase())
+        : normalizedOriginal.indexOf(normalizedSearch);
+    if (fuzzyIdx !== -1) {
+        return { found: true, index: fuzzyIdx, matchLength: search.length, usedFuzzyMatch: true, originalText: search, matchedText: search, contentForReplacement: original };
+    }
+    return { found: false, index: -1, matchLength: 0, usedFuzzyMatch: false, originalText: search, matchedText: '', contentForReplacement: '' };
+}
+export function stripBom(text) {
+    return text.replace(/^\uFEFF/, '');
+}
+export function generateDiffString(oldText, newText, filePath, options = {}) {
+    const oldLines = oldText.split('\n');
+    const newLines = newText.split('\n');
+    const _contextLines = options.contextLines ?? 0;
+    let diff = `--- ${filePath}\n+++ ${filePath}\n`;
+    // Simple diff: show before/after
+    if (oldLines.length === 0) {
+        diff += '@@ -0,0 +1,' + newLines.length + ' @@\n';
+        newLines.forEach((line, _i) => diff += '+' + line + '\n');
+    }
+    else if (newLines.length === 0) {
+        diff += '@@ -1,' + oldLines.length + ' +0,0 @@\n';
+        oldLines.forEach((line) => diff += '-' + line + '\n');
+    }
+    else {
+        diff += '@@ -1,' + oldLines.length + ' +1,' + newLines.length + ' @@\n';
+        oldLines.forEach((line) => diff += '-' + line + '\n');
+        newLines.forEach((line) => diff += '+' + line + '\n');
+    }
+    return diff;
+}
+//# sourceMappingURL=edit-diff.js.map

package/dist/agent/tools/edit-diff.js.map

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

package/dist/agent/tools/edit.d.ts

@@ -0,0 +1,13 @@
+import type { AgentTool } from '@mariozechner/pi-agent-core';
+declare const EditFileSchema: import("@sinclair/typebox/build/cjs/index.js").TObject<{
+    path: import("@sinclair/typebox/build/cjs/index.js").TString;
+    oldText: import("@sinclair/typebox/build/cjs/index.js").TString;
+    newText: import("@sinclair/typebox/build/cjs/index.js").TString;
+}>;
+export interface EditToolDetails {
+    diff?: string;
+    firstChangedLine?: number;
+    fuzzyMatchUsed?: boolean;
+}
+export declare const editFileTool: AgentTool<typeof EditFileSchema, EditToolDetails>;
+export {};

package/dist/agent/tools/edit.js

@@ -0,0 +1,65 @@
+// Edit file tool
+import { Type } from '@sinclair/typebox';
+import { readFile, writeFile, stat } from 'fs/promises';
+import { normalize } from 'path';
+import { checkFileSafety } from '../prompt/safety.js';
+import { normalizeToLF, restoreLineEndings, normalizeForFuzzyMatch, fuzzyFindText, stripBom, generateDiffString } from './edit-diff.js';
+const MAX_FILE_SIZE = 10 * 1024 * 1024;
+const EditFileSchema = Type.Object({
+    path: Type.String({ description: 'File path to edit' }),
+    oldText: Type.String({ description: 'Text to replace' }),
+    newText: Type.String({ description: 'Replacement text' }),
+});
+export const editFileTool = {
+    name: 'edit_file',
+    description: 'Edit file by replacing text.',
+    parameters: EditFileSchema,
+    label: '✏️ Edit',
+    async execute(toolCallId, params, _signal) {
+        try {
+            const safety = checkFileSafety('write', params.path);
+            if (!safety.allowed)
+                return { content: [{ type: 'text', text: `🚫 ${safety.message}` }], details: {} };
+            const normalized = normalize(params.path);
+            const stats = await stat(normalized);
+            if (stats.size > MAX_FILE_SIZE)
+                return { content: [{ type: 'text', text: `🚫 File too large` }], details: {} };
+            const rawContent = await readFile(normalized, 'utf-8');
+            const content = stripBom(rawContent);
+            const lineEnding = detectLineEnding(rawContent);
+            const normalizedContent = normalizeToLF(content);
+            const normalizedOldText = normalizeToLF(params.oldText);
+            const normalizedNewText = normalizeToLF(params.newText);
+            const matchResult = fuzzyFindText(normalizedContent, normalizedOldText);
+            if (!matchResult.found)
+                return { content: [{ type: 'text', text: `Error: oldText not found` }], details: {} };
+            const fuzzyContent = normalizeForFuzzyMatch(normalizedContent);
+            const fuzzyOldText = normalizeForFuzzyMatch(normalizedOldText);
+            const occurrences = fuzzyContent.split(fuzzyOldText).length - 1;
+            if (occurrences > 1)
+                return { content: [{ type: 'text', text: `Error: ${occurrences} occurrences found, text must be unique` }], details: {} };
+            const baseContent = matchResult.contentForReplacement;
+            const newContent = baseContent.substring(0, matchResult.index) + normalizedNewText + baseContent.substring(matchResult.index + matchResult.matchLength);
+            const finalContent = restoreLineEndings(newContent, lineEnding);
+            const originalWithReplacement = restoreLineEndings(baseContent, lineEnding);
+            if (originalWithReplacement === finalContent)
+                return { content: [{ type: 'text', text: `Error: No changes` }], details: {} };
+            const diffResult = generateDiffString(originalWithReplacement, finalContent, params.path);
+            await writeFile(params.path, finalContent, 'utf-8');
+            return { content: [{ type: 'text', text: `File edited: ${params.path}` }], details: { diff: diffResult, fuzzyMatchUsed: matchResult.usedFuzzyMatch } };
+        }
+        catch (error) {
+            return { content: [{ type: 'text', text: `Error: ${error instanceof Error ? error.message : String(error)}` }], details: {} };
+        }
+    },
+};
+function detectLineEnding(content) {
+    const crlfIdx = content.indexOf('\r\n');
+    const lfIdx = content.indexOf('\n');
+    if (lfIdx === -1)
+        return '\n';
+    if (crlfIdx === -1)
+        return '\n';
+    return crlfIdx < lfIdx ? '\r\n' : '\n';
+}
+//# sourceMappingURL=edit.js.map

package/dist/agent/tools/edit.js.map

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

package/dist/agent/tools/find.d.ts

@@ -0,0 +1,24 @@
+import { type Static } from '@sinclair/typebox';
+import type { AgentTool } from '@mariozechner/pi-agent-core';
+import { type TruncationResult } from './truncate.js';
+declare const findSchema: import("@sinclair/typebox/build/cjs/index.js").TObject<{
+    pattern: import("@sinclair/typebox/build/cjs/index.js").TString;
+    path: import("@sinclair/typebox/build/cjs/index.js").TOptional<import("@sinclair/typebox/build/cjs/index.js").TString>;
+    limit: import("@sinclair/typebox/build/cjs/index.js").TOptional<import("@sinclair/typebox/build/cjs/index.js").TNumber>;
+}>;
+export type FindToolInput = Static<typeof findSchema>;
+export interface FindToolDetails {
+    truncation?: TruncationResult;
+    resultLimitReached?: number;
+}
+/**
+ * Find tool - Search for files by glob pattern
+ */
+export declare function createFindTool(cwd: string): AgentTool<typeof findSchema>;
+/** Default find tool using process.cwd() */
+export declare const findTool: AgentTool<import("@sinclair/typebox/build/cjs/index.js").TObject<{
+    pattern: import("@sinclair/typebox/build/cjs/index.js").TString;
+    path: import("@sinclair/typebox/build/cjs/index.js").TOptional<import("@sinclair/typebox/build/cjs/index.js").TString>;
+    limit: import("@sinclair/typebox/build/cjs/index.js").TOptional<import("@sinclair/typebox/build/cjs/index.js").TNumber>;
+}>, any>;
+export {};