@vinhnt-sdk/tools 1.0.0

package/dist/domain.d.ts

@@ -0,0 +1,39 @@
+import type { ToolDefinition } from "./definitions.js";
+import type { ToolPermissionRule } from "./registry.js";
+/**
+ * ── Domain manifests (Phase 2) ────────────────────────────────────────────
+ * A domain is a named, swappable set of tools (e.g. "coding"). The agent core
+ * treats domains as opaque: it only needs each tool's id (for membership) and
+ * the set of domains an agent is allowed to use. This is the seam that lets
+ * the same core power coding, research, data, devops — differing only by which
+ * domains are mounted and which permission rules apply.
+ */
+/** A named group of tools exposed as a pluggable capability. */
+export interface DomainManifest {
+    /** Domain id used in agent config `domains: ["coding"]`. */
+    readonly id: string;
+    /** Tools belonging to this domain. Only `id`/`name` drives membership. */
+    readonly tools: readonly ToolDefinition[];
+    /** Optional domain-level system prompt (merged into the agent context). */
+    readonly systemPrompt?: string;
+    /** Domain-level permission defaults (allow/deny/ask) applied to its tools. */
+    readonly permissionDefaults?: readonly ToolPermissionRule[];
+}
+/** Summary of a domain for UI/API consumption. */
+export interface DomainSummary {
+    readonly id: string;
+    readonly toolCount: number;
+    readonly toolIds: readonly string[];
+    readonly hasSystemPrompt: boolean;
+}
+/**
+ * Group the coding toolset (file/shell/search/web/image/git/lsp) under domain
+ * "coding". Pass the tool definitions the composition root has already built.
+ */
+export declare function createCodingDomain(tools: readonly ToolDefinition[]): DomainManifest;
+/**
+ * Build a domain summary map from a list of domain manifests.
+ * Useful for API responses and UI rendering.
+ */
+export declare function summarizeDomains(domains: readonly DomainManifest[]): DomainSummary[];
+//# sourceMappingURL=domain.d.ts.map

package/dist/domain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain.d.ts","sourceRoot":"","sources":["../src/domain.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAExD;;;;;;;GAOG;AAEH,gEAAgE;AAChE,MAAM,WAAW,cAAc;IAC7B,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,0EAA0E;IAC1E,QAAQ,CAAC,KAAK,EAAE,SAAS,cAAc,EAAE,CAAC;IAC1C,2EAA2E;IAC3E,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,8EAA8E;IAC9E,QAAQ,CAAC,kBAAkB,CAAC,EAAE,SAAS,kBAAkB,EAAE,CAAC;CAC7D;AAED,kDAAkD;AAClD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;CACnC;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,SAAS,cAAc,EAAE,GAAG,cAAc,CAEnF;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,SAAS,cAAc,EAAE,GAAG,aAAa,EAAE,CAOpF"}

package/dist/domain.js

@@ -0,0 +1,20 @@
+/**
+ * Group the coding toolset (file/shell/search/web/image/git/lsp) under domain
+ * "coding". Pass the tool definitions the composition root has already built.
+ */
+export function createCodingDomain(tools) {
+    return { id: "coding", tools };
+}
+/**
+ * Build a domain summary map from a list of domain manifests.
+ * Useful for API responses and UI rendering.
+ */
+export function summarizeDomains(domains) {
+    return domains.map((d) => ({
+        id: d.id,
+        toolCount: d.tools.length,
+        toolIds: d.tools.map((t) => t.id),
+        hasSystemPrompt: !!d.systemPrompt,
+    }));
+}
+//# sourceMappingURL=domain.js.map

package/dist/domain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain.js","sourceRoot":"","sources":["../src/domain.ts"],"names":[],"mappings":"AAgCA;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAgC;IACjE,OAAO,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;AACjC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAkC;IACjE,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACzB,EAAE,EAAE,CAAC,CAAC,EAAE;QACR,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,MAAM;QACzB,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACjC,eAAe,EAAE,CAAC,CAAC,CAAC,CAAC,YAAY;KAClC,CAAC,CAAC,CAAC;AACN,CAAC"}

package/dist/file-history.d.ts

@@ -0,0 +1,43 @@
+export interface FileVersion {
+    readonly filePath: string;
+    readonly sessionId: string;
+    readonly originalContent: string;
+    readonly newContent: string;
+    readonly timestamp: number;
+    readonly toolName: string;
+}
+export interface UndoEntry {
+    readonly filePath: string;
+    readonly originalContent: string;
+    readonly newContent: string;
+    readonly toolName: string;
+    readonly timestamp: number;
+    readonly versionId: number;
+}
+export interface FileHistory {
+    recordVersion(version: Omit<FileVersion, "timestamp"> & {
+        timestamp?: number;
+    }): Promise<void>;
+    listVersions(filePath: string): Promise<readonly FileVersion[]>;
+    getLatestVersion(filePath: string): Promise<FileVersion | null>;
+    rollbackTo(filePath: string, targetVersion: number): Promise<string>;
+    getAllChanges(): Promise<readonly FileVersion[]>;
+    undo(): Promise<UndoEntry | null>;
+    redo(): Promise<UndoEntry | null>;
+}
+export declare class InMemoryFileHistory implements FileHistory {
+    private versions;
+    private undoStack;
+    private redoStack;
+    private versionCounter;
+    recordVersion(version: Omit<FileVersion, "timestamp"> & {
+        timestamp?: number;
+    }): Promise<void>;
+    listVersions(filePath: string): Promise<readonly FileVersion[]>;
+    getLatestVersion(filePath: string): Promise<FileVersion | null>;
+    rollbackTo(filePath: string, versionIndex: number): Promise<string>;
+    getAllChanges(): Promise<readonly FileVersion[]>;
+    undo(): Promise<UndoEntry | null>;
+    redo(): Promise<UndoEntry | null>;
+}
+//# sourceMappingURL=file-history.d.ts.map

package/dist/file-history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-history.d.ts","sourceRoot":"","sources":["../src/file-history.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,WAAW;IAC1B,aAAa,CAAC,OAAO,EAAE,IAAI,CAAC,WAAW,EAAE,WAAW,CAAC,GAAG;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/F,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,WAAW,EAAE,CAAC,CAAC;IAChE,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IAChE,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACrE,aAAa,IAAI,OAAO,CAAC,SAAS,WAAW,EAAE,CAAC,CAAC;IACjD,IAAI,IAAI,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC;IAClC,IAAI,IAAI,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC;CACnC;AAED,qBAAa,mBAAoB,YAAW,WAAW;IACrD,OAAO,CAAC,QAAQ,CAAqB;IACrC,OAAO,CAAC,SAAS,CAAmB;IACpC,OAAO,CAAC,SAAS,CAAmB;IACpC,OAAO,CAAC,cAAc,CAAK;IAErB,aAAa,CAAC,OAAO,EAAE,IAAI,CAAC,WAAW,EAAE,WAAW,CAAC,GAAG;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAkB9F,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,WAAW,EAAE,CAAC;IAI/D,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAK/D,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAQnE,aAAa,IAAI,OAAO,CAAC,SAAS,WAAW,EAAE,CAAC;IAIhD,IAAI,IAAI,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IAOjC,IAAI,IAAI,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;CAMxC"}

package/dist/file-history.js

@@ -0,0 +1,55 @@
+export class InMemoryFileHistory {
+    versions = [];
+    undoStack = [];
+    redoStack = [];
+    versionCounter = 0;
+    async recordVersion(version) {
+        const entry = {
+            ...version,
+            timestamp: version.timestamp ?? Date.now(),
+        };
+        entry;
+        this.versions.push(entry);
+        this.undoStack.push({
+            filePath: entry.filePath,
+            originalContent: entry.originalContent,
+            newContent: entry.newContent,
+            toolName: entry.toolName,
+            timestamp: entry.timestamp,
+            versionId: this.versionCounter++,
+        });
+        this.redoStack = [];
+    }
+    async listVersions(filePath) {
+        return this.versions.filter((v) => v.filePath === filePath);
+    }
+    async getLatestVersion(filePath) {
+        const matches = this.versions.filter((v) => v.filePath === filePath);
+        return matches.length > 0 ? matches[matches.length - 1] : null;
+    }
+    async rollbackTo(filePath, versionIndex) {
+        const matches = this.versions.filter((v) => v.filePath === filePath);
+        if (versionIndex < 0 || versionIndex >= matches.length) {
+            throw new Error(`Version index ${versionIndex} out of range (0-${matches.length - 1})`);
+        }
+        return matches[versionIndex].originalContent;
+    }
+    async getAllChanges() {
+        return [...this.versions];
+    }
+    async undo() {
+        const entry = this.undoStack.pop();
+        if (!entry)
+            return null;
+        this.redoStack.push(entry);
+        return entry;
+    }
+    async redo() {
+        const entry = this.redoStack.pop();
+        if (!entry)
+            return null;
+        this.undoStack.push(entry);
+        return entry;
+    }
+}
+//# sourceMappingURL=file-history.js.map

package/dist/file-history.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-history.js","sourceRoot":"","sources":["../src/file-history.ts"],"names":[],"mappings":"AA4BA,MAAM,OAAO,mBAAmB;IACtB,QAAQ,GAAkB,EAAE,CAAC;IAC7B,SAAS,GAAgB,EAAE,CAAC;IAC5B,SAAS,GAAgB,EAAE,CAAC;IAC5B,cAAc,GAAG,CAAC,CAAC;IAE3B,KAAK,CAAC,aAAa,CAAC,OAAgE;QAClF,MAAM,KAAK,GAAgB;YACzB,GAAG,OAAO;YACV,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,IAAI,CAAC,GAAG,EAAE;SAC5B,CAAC;QACjB,KAA2B,CAAC;QAC5B,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC1B,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;YAClB,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,eAAe,EAAE,KAAK,CAAC,eAAe;YACtC,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,SAAS,EAAE,IAAI,CAAC,cAAc,EAAE;SACjC,CAAC,CAAC;QACH,IAAI,CAAC,SAAS,GAAG,EAAE,CAAC;IACtB,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,QAAgB;QACjC,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC;IAC9D,CAAC;IAED,KAAK,CAAC,gBAAgB,CAAC,QAAgB;QACrC,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC;QACrE,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IAClE,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,QAAgB,EAAE,YAAoB;QACrD,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC;QACrE,IAAI,YAAY,GAAG,CAAC,IAAI,YAAY,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACvD,MAAM,IAAI,KAAK,CAAC,iBAAiB,YAAY,oBAAoB,OAAO,CAAC,MAAM,GAAG,CAAC,GAAG,CAAC,CAAC;QAC1F,CAAC;QACD,OAAO,OAAO,CAAC,YAAY,CAAE,CAAC,eAAe,CAAC;IAChD,CAAC;IAED,KAAK,CAAC,aAAa;QACjB,OAAO,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC5B,CAAC;IAED,KAAK,CAAC,IAAI;QACR,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC;QACnC,IAAI,CAAC,KAAK;YAAE,OAAO,IAAI,CAAC;QACxB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC3B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,KAAK,CAAC,IAAI;QACR,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC;QACnC,IAAI,CAAC,KAAK;YAAE,OAAO,IAAI,CAAC;QACxB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC3B,OAAO,KAAK,CAAC;IACf,CAAC;CACF"}

package/dist/file-tools.d.ts

@@ -0,0 +1,56 @@
+import { FileReadTracker } from "./read-tracker.js";
+import { generateDiff } from "./diff.js";
+type RootGetter = string | (() => string);
+export declare function createReadFileTool(workspaceRoot: RootGetter, tracker?: FileReadTracker, externalDirAccess?: boolean, maxFileSize?: number): import("./definitions.js").ToolDefinition<{
+    filePath: string;
+    stripTrailingNewline?: boolean;
+}, string>;
+export declare function createWriteFileTool(workspaceRoot: RootGetter, tracker?: FileReadTracker, externalDirAccess?: boolean): import("./definitions.js").ToolDefinition<{
+    filePath: string;
+    content: string;
+}, {
+    written: string;
+    bytes: number;
+    diff: ReturnType<typeof generateDiff>["diff"];
+    additions: number;
+    removals: number;
+}>;
+export declare function createEditFileTool(workspaceRoot: RootGetter, tracker?: FileReadTracker, externalDirAccess?: boolean): import("./definitions.js").ToolDefinition<{
+    filePath: string;
+    oldString?: string;
+    newString?: string;
+    edits?: readonly {
+        oldString: string;
+        newString: string;
+    }[];
+}, {
+    edited: string;
+    diff: string;
+    hunkCount?: number;
+    additions: number;
+    removals: number;
+}>;
+export declare function createApplyPatchTool(workspaceRoot: RootGetter, tracker?: FileReadTracker, externalDirAccess?: boolean): import("./definitions.js").ToolDefinition<{
+    filePath: string;
+    patch: string;
+}, {
+    patched: string;
+    blocks: number;
+    diff: string;
+    additions: number;
+    removals: number;
+}>;
+/**
+ * Default excluded directories — convenience only.
+ * User tự extend: `config.excludedDirs = [...DEFAULT_EXCLUDED_DIRS, "my-dir"]`
+ */
+export declare const DEFAULT_EXCLUDED_DIRS: string[];
+export declare function createListDirectoryTool(workspaceRoot: RootGetter, externalDirAccess?: boolean, excludedDirs?: string[]): import("./definitions.js").ToolDefinition<{
+    dirPath: string;
+}, {
+    name: string;
+    type: string;
+    path: string;
+}[]>;
+export {};
+//# sourceMappingURL=file-tools.d.ts.map

package/dist/file-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-tools.d.ts","sourceRoot":"","sources":["../src/file-tools.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAmFzC,KAAK,UAAU,GAAG,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,CAAC;AAiD1C,wBAAgB,kBAAkB,CAAC,aAAa,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,eAAe,EAAE,iBAAiB,CAAC,EAAE,OAAO,EAAE,WAAW,CAAC,EAAE,MAAM;cAC1G,MAAM;2BAAyB,OAAO;WAsBrE;AAED,wBAAgB,mBAAmB,CAAC,aAAa,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,eAAe,EAAE,iBAAiB,CAAC,EAAE,OAAO;cACrF,MAAM;aAAW,MAAM;;aAC1C,MAAM;WAAS,MAAM;UACxB,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC;eAClC,MAAM;cAAY,MAAM;GA4BtC;AAgPD,wBAAgB,kBAAkB,CAAC,aAAa,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,eAAe,EAAE,iBAAiB,CAAC,EAAE,OAAO;cACpF,MAAM;gBAAc,MAAM;gBAAc,MAAM;YAAU,SAAS;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,EAAE;;YAC/H,MAAM;UAAQ,MAAM;gBAChB,MAAM;eAAa,MAAM;cAAY,MAAM;GAuC1D;AAeD,wBAAgB,oBAAoB,CAAC,aAAa,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,eAAe,EAAE,iBAAiB,CAAC,EAAE,OAAO;cACtF,MAAM;WAAS,MAAM;;aACxC,MAAM;YAAU,MAAM;UAAQ,MAAM;eAAa,MAAM;cAAY,MAAM;GAsDrF;AAED;;;GAGG;AACH,eAAO,MAAM,qBAAqB,UAA2B,CAAC;AAE9D,wBAAgB,uBAAuB,CAAC,aAAa,EAAE,UAAU,EAAE,iBAAiB,CAAC,EAAE,OAAO,EAAE,YAAY,CAAC,EAAE,MAAM,EAAE;aAGxF,MAAM;;UAAY,MAAM;UAAQ,MAAM;UAAQ,MAAM;KAqBlF"}