@hanhnd/agent-kit 1.0.30 → 1.0.32

package/dist/utils/args.js

@@ -0,0 +1,31 @@
+export function parseArgs(args) {
+    const flags = new Map();
+    const positionals = [];
+    for (let index = 0; index < args.length; index += 1) {
+        const arg = args[index];
+        if (!arg.startsWith('--')) {
+            positionals.push(arg);
+            continue;
+        }
+        const key = arg.slice(2);
+        const next = args[index + 1];
+        if (!next || next.startsWith('--')) {
+            flags.set(key, true);
+            continue;
+        }
+        flags.set(key, next);
+        index += 1;
+    }
+    return { flags, positionals };
+}
+export function stringFlag(flags, key) {
+    const value = flags.get(key);
+    return typeof value === 'string' ? value : undefined;
+}
+export function numberFlag(flags, key, defaultValue) {
+    const value = Number(stringFlag(flags, key) ?? defaultValue);
+    if (!Number.isFinite(value)) {
+        throw new Error(`--${key} must be a finite number`);
+    }
+    return value;
+}

package/dist/utils/async.d.ts

@@ -0,0 +1 @@
+export declare function withTimeout<T>(promise: Promise<T>, timeoutMs: number, createError: () => Error): Promise<T>;

package/dist/utils/async.js

@@ -0,0 +1,15 @@
+export async function withTimeout(promise, timeoutMs, createError) {
+    let timer;
+    const timeout = new Promise((_resolve, reject) => {
+        timer = setTimeout(() => {
+            reject(createError());
+        }, timeoutMs);
+    });
+    try {
+        return await Promise.race([promise, timeout]);
+    }
+    finally {
+        if (timer)
+            clearTimeout(timer);
+    }
+}

package/dist/utils/credentials.d.ts

@@ -1,9 +1,9 @@
 /**
- * Credential loader — reads ~/.claude/credentials (INI format, like ~/.aws/credentials)
+ * Credential loader — reads ~/.agent-kit/credentials (INI format, like ~/.aws/credentials)
  *
  * Resolution order per key:
  *   1. process.env.KEY  (explicit override / CI)
- *   2. ~/.claude/credentials [profile] section
+ *   2. ~/.agent-kit/credentials [profile] section
  *   3. undefined
  *
  * File format:
@@ -15,6 +15,6 @@
  */
 /**
  * Resolve a credential key using the priority chain:
- *   process.env.KEY → ~/.claude/credentials [profile] → undefined
+ *   process.env.KEY → ~/.agent-kit/credentials [profile] → undefined
  */
 export declare function getCredential(key: string): string | undefined;

package/dist/utils/credentials.js

@@ -1,9 +1,9 @@
 /**
- * Credential loader — reads ~/.claude/credentials (INI format, like ~/.aws/credentials)
+ * Credential loader — reads ~/.agent-kit/credentials (INI format, like ~/.aws/credentials)
  *
  * Resolution order per key:
  *   1. process.env.KEY  (explicit override / CI)
- *   2. ~/.claude/credentials [profile] section
+ *   2. ~/.agent-kit/credentials [profile] section
  *   3. undefined
  *
  * File format:
@@ -14,9 +14,7 @@
  * Active profile: KIT_PROFILE env var (defaults to "default")
  */
 import * as fs from 'fs';
-import * as os from 'os';
-import * as path from 'path';
-const CREDENTIALS_FILE = path.join(os.homedir(), '.claude', 'credentials');
+import { CREDENTIALS_FILE } from './paths.js';
 let cachedCredentials = null;
 /**
  * Parse a simple INI file into a map of profiles.
@@ -47,7 +45,7 @@ function parseIni(content) {
     return result;
 }
 /**
- * Load credentials from ~/.claude/credentials for the active profile.
+ * Load credentials from ~/.agent-kit/credentials for the active profile.
  * Result is cached for the lifetime of the MCP server process.
  */
 function loadCredentials() {
@@ -79,7 +77,7 @@ function loadCredentials() {
 }
 /**
  * Resolve a credential key using the priority chain:
- *   process.env.KEY → ~/.claude/credentials [profile] → undefined
+ *   process.env.KEY → ~/.agent-kit/credentials [profile] → undefined
  */
 export function getCredential(key) {
     if (process.env[key]) {

package/dist/utils/files.d.ts

@@ -0,0 +1,8 @@
+export declare function atomicWriteTextFile(filePath: string, content: string): void;
+export declare function atomicWriteJsonFile(filePath: string, value: unknown): void;
+export declare function tryWriteFileExclusive(filePath: string, content: string): boolean;
+export declare function acquireLock(lockPath: string, timeoutMs: number, retryMs: number): Promise<boolean>;
+export declare function releaseLock(lockPath: string, opts?: {
+    ignoreErrors?: boolean;
+}): void;
+export declare function tryAcquireProcessLock(lockPath: string): boolean;

package/dist/utils/files.js

@@ -0,0 +1,77 @@
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+export function atomicWriteTextFile(filePath, content) {
+    fs.mkdirSync(path.dirname(filePath), { recursive: true });
+    const tempPath = `${filePath}.${process.pid}.${Date.now()}.tmp`;
+    fs.writeFileSync(tempPath, content, 'utf8');
+    fs.renameSync(tempPath, filePath);
+}
+export function atomicWriteJsonFile(filePath, value) {
+    atomicWriteTextFile(filePath, `${JSON.stringify(value, null, 2)}\n`);
+}
+export function tryWriteFileExclusive(filePath, content) {
+    fs.mkdirSync(path.dirname(filePath), { recursive: true });
+    try {
+        fs.writeFileSync(filePath, content, { flag: 'wx' });
+        return true;
+    }
+    catch (err) {
+        if (err.code === 'EEXIST')
+            return false;
+        throw err;
+    }
+}
+export async function acquireLock(lockPath, timeoutMs, retryMs) {
+    const deadline = Date.now() + timeoutMs;
+    while (Date.now() < deadline) {
+        try {
+            if (tryWriteFileExclusive(lockPath, String(process.pid)))
+                return true;
+        }
+        catch {
+            // Preserve fail-open retry behavior for transient lock-file write errors.
+        }
+        await new Promise((r) => setTimeout(r, retryMs));
+    }
+    return false;
+}
+export function releaseLock(lockPath, opts = {}) {
+    try {
+        fs.unlinkSync(lockPath);
+    }
+    catch (err) {
+        if (opts.ignoreErrors || err.code === 'ENOENT')
+            return;
+        throw err;
+    }
+}
+export function tryAcquireProcessLock(lockPath) {
+    const lockContent = JSON.stringify({ pid: process.pid });
+    if (tryWriteFileExclusive(lockPath, lockContent))
+        return true;
+    let pid;
+    try {
+        const raw = fs.readFileSync(lockPath, 'utf8');
+        pid = JSON.parse(raw).pid;
+    }
+    catch {
+        // Unparseable lockfiles are treated as stale.
+    }
+    if (pid !== undefined) {
+        try {
+            process.kill(pid, 0);
+            return false;
+        }
+        catch (err) {
+            if (err.code !== 'ESRCH')
+                return false;
+        }
+    }
+    try {
+        fs.unlinkSync(lockPath);
+    }
+    catch {
+        // Ignore if another process already removed the stale lock.
+    }
+    return tryWriteFileExclusive(lockPath, lockContent);
+}

package/dist/utils/hash.d.ts

@@ -0,0 +1 @@
+export declare function sha256Hex(content: string): string;

package/dist/utils/hash.js

@@ -0,0 +1,4 @@
+import { createHash } from 'node:crypto';
+export function sha256Hex(content) {
+    return createHash('sha256').update(content).digest('hex');
+}

package/dist/utils/json.d.ts

@@ -0,0 +1,2 @@
+export declare function isRecord(value: unknown): value is Record<string, unknown>;
+export declare function readJsonObjectFile(filePath: string): Record<string, unknown>;

package/dist/utils/json.js

@@ -0,0 +1,13 @@
+import * as fs from 'node:fs';
+export function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+export function readJsonObjectFile(filePath) {
+    if (!fs.existsSync(filePath))
+        return {};
+    const parsed = JSON.parse(fs.readFileSync(filePath, 'utf8'));
+    if (!isRecord(parsed)) {
+        throw new Error(`${filePath} must contain a JSON object`);
+    }
+    return parsed;
+}

package/dist/utils/parser.js

@@ -17,8 +17,7 @@ export function adfToMarkdown(adf) {
                 }
                 case 'heading': {
                     const level = node.attrs?.level || 1;
-                    result +=
-                        '#'.repeat(level) + ' ' + renderNodes(node.content, listDepth, node.type) + '\n\n';
+                    result += '#'.repeat(level) + ' ' + renderNodes(node.content, listDepth, node.type) + '\n\n';
                     break;
                 }
                 case 'text': {
@@ -61,10 +60,7 @@ export function adfToMarkdown(adf) {
                     break;
                 }
                 case 'blockquote':
-                    result +=
-                        '> ' +
-                            renderNodes(node.content, listDepth, node.type).trim().replace(/\n/g, '\n> ') +
-                            '\n\n';
+                    result += '> ' + renderNodes(node.content, listDepth, node.type).trim().replace(/\n/g, '\n> ') + '\n\n';
                     break;
                 case 'codeBlock':
                     result += `\`\`\`${node.attrs?.language || ''}\n${renderNodes(node.content, listDepth, node.type).trim()}\n\`\`\`\n\n`;

package/dist/utils/paths.d.ts

@@ -0,0 +1,4 @@
+export declare const AGENT_KIT_HOME: string;
+export declare const CREDENTIALS_FILE: string;
+export declare const MODEL_CACHE_DIR: string;
+export declare const FASTEMBED_CACHE_DIR: string;

package/dist/utils/paths.js

@@ -0,0 +1,6 @@
+import * as os from 'os';
+import * as path from 'path';
+export const AGENT_KIT_HOME = path.join(os.homedir(), '.agent-kit');
+export const CREDENTIALS_FILE = path.join(AGENT_KIT_HOME, 'credentials');
+export const MODEL_CACHE_DIR = path.join(AGENT_KIT_HOME, 'cache', 'models');
+export const FASTEMBED_CACHE_DIR = path.join(MODEL_CACHE_DIR, 'fastembed');

package/package.json

@@ -1,11 +1,12 @@
 {
   "name": "@hanhnd/agent-kit",
-  "version": "1.0.30",
+  "version": "1.0.32",
   "description": "Agent Kit MCP server for software development agent workflows",
   "type": "module",
   "main": "dist/kit-server.js",
   "bin": {
-    "agent-kit": "dist/kit-server.js"
+    "agent-kit": "dist/kit-server.js",
+    "agent-kit-cli": "dist/kit-cli.js"
   },
   "files": [
     "dist",
@@ -20,13 +21,14 @@
     "directory": "mcp"
   },
   "scripts": {
-    "build": "tsc && npm run bundle",
-    "bundle": "esbuild src/kit-server.ts --bundle --platform=node --format=esm --outfile=dist/kit-server.js --external:node:* --external:better-sqlite3 --external:sqlite-vec --external:fastembed --banner:js=\"import { createRequire } from 'module'; const require = createRequire(import.meta.url);\"",
+    "build": "rm -rf dist && tsc && npm run bundle",
+    "bundle": "esbuild src/kit-server.ts src/kit-cli.ts --bundle --platform=node --format=esm --outdir=dist --external:node:* --external:better-sqlite3 --external:sqlite-vec --external:fastembed --external:node-llama-cpp --banner:js=\"import { createRequire } from 'module'; const require = createRequire(import.meta.url);\"",
     "dev": "tsc --watch",
     "prepublishOnly": "npm run build",
-    "test": "tsc && node --test $(find dist/src/memory/__tests__ dist/src/tools/__tests__ -name '*.test.js' 2>/dev/null | tr '\\n' ' ')"
+    "test": "tsc && node --test $(find src/memory/__tests__ src/tools/__tests__ -name '*.test.ts' | sed 's#^src/#dist/#; s#\\.ts$#.js#' | tr '\\n' ' ')"
   },
   "dependencies": {
+    "node-llama-cpp": "^3.0.0",
     "@modelcontextprotocol/sdk": "^1.13.1",
     "better-sqlite3": "^11.0.0",
     "dedent": "^1.5.3",