agent-sin 0.1.0

package/dist/core/builtin-skills.d.ts

@@ -0,0 +1,27 @@
+export interface BuiltinMigrationReport {
+    /** ids whose workspace copy matched the packaged version and was silently removed. */
+    deleted: string[];
+    /** ids whose workspace copy differed from the packaged version and was moved aside. */
+    archived: Array<{
+        id: string;
+        archivePath: string;
+    }>;
+    /** ids whose workspace copy is kept as an explicit override (`override: true`). */
+    retained: string[];
+}
+/**
+ * Migrate legacy in-workspace copies of builtin skills.
+ *
+ * Builtin skills are now loaded directly from the packaged `builtin-skills/`
+ * directory; the user's workspace `skills/` is for user-authored skills only.
+ * Existing installs may still have stale copies of builtin skills under
+ * `<skills_dir>/<builtin-id>/`. For each such directory we:
+ *
+ *   - Skip it if its `skill.yaml` has `override: true` (deliberate override).
+ *   - Delete it silently if every file matches the packaged version byte-for-byte.
+ *   - Move it to `<skills_dir>/.archived-builtin-overrides/<id>/<timestamp>/`
+ *     otherwise, so user customisation is never silently lost.
+ *
+ * Safe to call repeatedly; returns a report describing what happened.
+ */
+export declare function migrateLegacyBuiltinCopies(skillsDir: string): Promise<BuiltinMigrationReport>;

package/dist/core/builtin-skills.js

@@ -0,0 +1,120 @@
+import { createHash } from "node:crypto";
+import { mkdir, readFile, readdir, rename, rm, stat } from "node:fs/promises";
+import path from "node:path";
+import YAML from "yaml";
+import { builtinSkillsDir, listBuiltinSkillIds } from "./skill-registry.js";
+/**
+ * Migrate legacy in-workspace copies of builtin skills.
+ *
+ * Builtin skills are now loaded directly from the packaged `builtin-skills/`
+ * directory; the user's workspace `skills/` is for user-authored skills only.
+ * Existing installs may still have stale copies of builtin skills under
+ * `<skills_dir>/<builtin-id>/`. For each such directory we:
+ *
+ *   - Skip it if its `skill.yaml` has `override: true` (deliberate override).
+ *   - Delete it silently if every file matches the packaged version byte-for-byte.
+ *   - Move it to `<skills_dir>/.archived-builtin-overrides/<id>/<timestamp>/`
+ *     otherwise, so user customisation is never silently lost.
+ *
+ * Safe to call repeatedly; returns a report describing what happened.
+ */
+export async function migrateLegacyBuiltinCopies(skillsDir) {
+    const report = { deleted: [], archived: [], retained: [] };
+    const builtinIds = await listBuiltinSkillIds();
+    if (builtinIds.size === 0) {
+        return report;
+    }
+    const builtinRoot = builtinSkillsDir();
+    for (const id of builtinIds) {
+        const workspacePath = path.join(skillsDir, id);
+        const workspaceManifest = path.join(workspacePath, "skill.yaml");
+        try {
+            await stat(workspaceManifest);
+        }
+        catch {
+            continue;
+        }
+        if (await hasOverrideFlag(workspaceManifest)) {
+            report.retained.push(id);
+            continue;
+        }
+        const builtinPath = path.join(builtinRoot, id);
+        const identical = await directoriesIdentical(workspacePath, builtinPath);
+        if (identical) {
+            await rm(workspacePath, { recursive: true, force: true });
+            report.deleted.push(id);
+            continue;
+        }
+        const archiveRoot = path.join(skillsDir, ".archived-builtin-overrides", id);
+        await mkdir(archiveRoot, { recursive: true });
+        const stamp = new Date().toISOString().replace(/[:.]/g, "-");
+        const archivePath = path.join(archiveRoot, stamp);
+        await rename(workspacePath, archivePath);
+        report.archived.push({ id, archivePath });
+    }
+    return report;
+}
+async function hasOverrideFlag(manifestPath) {
+    try {
+        const raw = await readFile(manifestPath, "utf8");
+        const parsed = YAML.parse(raw);
+        return parsed?.override === true;
+    }
+    catch {
+        return false;
+    }
+}
+async function directoriesIdentical(a, b) {
+    let filesA;
+    let filesB;
+    try {
+        filesA = (await collectFiles(a)).sort();
+        filesB = (await collectFiles(b)).sort();
+    }
+    catch {
+        return false;
+    }
+    if (filesA.length !== filesB.length) {
+        return false;
+    }
+    for (let i = 0; i < filesA.length; i += 1) {
+        if (filesA[i] !== filesB[i]) {
+            return false;
+        }
+    }
+    for (const relative of filesA) {
+        const hashA = await hashFile(path.join(a, relative));
+        const hashB = await hashFile(path.join(b, relative));
+        if (hashA !== hashB) {
+            return false;
+        }
+    }
+    return true;
+}
+async function collectFiles(root) {
+    const out = [];
+    await walk(root, root, out);
+    return out;
+}
+async function walk(root, current, out) {
+    let entries;
+    try {
+        entries = await readdir(current, { withFileTypes: true });
+    }
+    catch {
+        return;
+    }
+    for (const entry of entries) {
+        const full = path.join(current, entry.name);
+        if (entry.isDirectory()) {
+            await walk(root, full, out);
+        }
+        else if (entry.isFile()) {
+            out.push(path.relative(root, full));
+        }
+    }
+}
+async function hashFile(file) {
+    const data = await readFile(file);
+    return createHash("sha256").update(data).digest("hex");
+}

package/dist/core/chat-engine.d.ts

@@ -0,0 +1,70 @@
+import { type AppConfig } from "./config.js";
+import { type EventLogSource } from "./logger.js";
+import { type AiImagePart, type AiMessage, type AiProgressEvent, type AiProgressHandler } from "./ai-provider.js";
+import { type SkillManifest } from "./skill-registry.js";
+import { type ProfileMemoryFiles } from "./profile-memory.js";
+export type ChatRole = "user" | "assistant" | "tool";
+export interface ChatTurn {
+    role: ChatRole;
+    content: string;
+}
+export interface SkillCall {
+    id: string;
+    args: Record<string, unknown>;
+}
+export interface ChatBuildSuggestion {
+    type: "create" | "edit";
+    skill_id: string;
+    reason?: string;
+}
+export interface SpinnerLike {
+    isActive(): boolean;
+    start(label: string): void;
+    update(label: string): void;
+    stop(): void;
+}
+export type ChatProgressEvent = {
+    kind: "thinking";
+    iteration: number;
+} | {
+    kind: "tool_running";
+    skill_id: string;
+} | {
+    kind: "tool_repairing";
+    skill_id: string;
+} | {
+    kind: "tool_done";
+    skill_id: string;
+    status: string;
+} | {
+    kind: "model_failed";
+    message: string;
+};
+export interface ChatRespondOptions {
+    formatNarrative?: (text: string) => string;
+    spinner?: SpinnerLike;
+    eventSource?: EventLogSource;
+    onChatProgress?: (event: ChatProgressEvent) => void;
+    onAiProgress?: AiProgressHandler;
+    onBuildSuggestion?: (suggestion: ChatBuildSuggestion) => void;
+    preferredSkillId?: string;
+    userImages?: AiImagePart[];
+}
+export declare const HISTORY_LIMIT = 20;
+export declare const TOOL_CALL_MAX_ITERATIONS = 3;
+export declare function chatRespond(config: AppConfig, userText: string, history: ChatTurn[], options?: ChatRespondOptions): Promise<string[]>;
+export declare function makeSpinnerProgress(spinner: SpinnerLike, baseLabel: string): (event: AiProgressEvent) => void;
+export declare function formatProgressLabel(baseLabel: string, event: AiProgressEvent): string | null;
+export declare function isToolEligible(skill: SkillManifest): boolean;
+export declare function buildSystemPrompt(skills: SkillManifest[], preferredSkillId?: string, profileMemory?: ProfileMemoryFiles): string;
+export declare function parseSkillCalls(text: string): SkillCall[];
+export declare function stripSkillCalls(text: string): string;
+export declare function extractSkillCallBlocks(text: string): string;
+export declare function parseBuildSuggestion(text: string): ChatBuildSuggestion | null;
+export declare function stripBuildSuggestions(text: string): string;
+export declare function toolResultJson(id: string, status: string, summary: string, saved?: string[], data?: unknown): string;
+export declare function toAiMessages(history: ChatTurn[], multimodalTurn?: {
+    index: number;
+    images: AiImagePart[];
+}): AiMessage[];
+export declare function appendHistory(history: ChatTurn[], turn: ChatTurn): void;