callkaro-cli-unofficial 0.9.2 → 0.9.4

package/dist/commands/skills.js

@@ -12,6 +12,7 @@ const os_1 = require("os");
 const child_process_1 = require("child_process");
 const ui_1 = require("../lib/ui");
 const config_1 = require("../lib/config");
+const updateCheck_1 = require("../lib/updateCheck");
 /**
  * Skills live in their own public repo (Mail-Daddy-AI/callkaro-skills), NOT in
  * this package — so a skills update never requires a CLI release. Install and
@@ -157,15 +158,15 @@ function restoreOwnershipIfSudo(dest) {
 /** Codex has no skills system — wire a pointer block into ~/.codex/AGENTS.md. */
 function wireCodexPointer() {
     const codexHome = (0, path_1.join)((0, os_1.homedir)(), '.codex');
-    const block = `${CODEX_MARK_START}
-## CallKaro voice agents
-For ANY task involving CallKaro (voice agents, calls, batch campaigns,
-simulations, phone numbers, analytics): FIRST read
-~/.codex/skills/callkaro/SKILL.md and follow the files it routes to
-(INSTRUCTIONS.md for how to operate; authoring-pipeline/ when building agents).
-All operations run through the \`cku\` CLI (this fork) — it must be logged in (\`cku login\`).
-If you have the official CLI instead, substitute \`ck\` for \`cku\` throughout.
-Prefer \`--json\` output and never invent ids — list first.
+    const block = `${CODEX_MARK_START}
+## CallKaro voice agents
+For ANY task involving CallKaro (voice agents, calls, batch campaigns,
+simulations, phone numbers, analytics): FIRST read
+~/.codex/skills/callkaro/SKILL.md and follow the files it routes to
+(INSTRUCTIONS.md for how to operate; authoring-pipeline/ when building agents).
+All operations run through the \`cku\` CLI (this fork) — it must be logged in (\`cku login\`).
+If you have the official CLI instead, substitute \`ck\` for \`cku\` throughout.
+Prefer \`--json\` output and never invent ids — list first.
 ${CODEX_MARK_END}`;
     const agentsMd = (0, path_1.join)(codexHome, 'AGENTS.md');
     let content = (0, fs_1.existsSync)(agentsMd) ? (0, fs_1.readFileSync)(agentsMd, 'utf8') : '';
@@ -209,6 +210,9 @@ async function installOrUpdate(opts, verb, pack) {
         (0, ui_1.info)(`\nPack: ${which}`);
         (0, ui_1.info)('Open a new agent session and ask it anything about CallKaro.');
         (0, ui_1.info)('Requires the `cku` CLI to be logged in (`cku login`) — the skill pack documents that CLI.');
+        // A shared pack serves several targets; its caller records the install once.
+        if (!pack)
+            await (0, updateCheck_1.recordSkillsInstalled)(repo, (0, config_1.skillsBranch)());
     }
     finally {
         cleanup();
@@ -299,6 +303,7 @@ async function skillsUpdateCommand(opts) {
             try {
                 for (const t of targets)
                     await installOrUpdate(t.opts, 'Updated', shared);
+                await (0, updateCheck_1.recordSkillsInstalled)(repo, (0, config_1.skillsBranch)());
             }
             finally {
                 pack.cleanup();

package/dist/data/catalog.json

@@ -1206,7 +1206,6 @@
                 "transcriber_provider",
                 "transcriber_language",
                 "transcriber_general_context",
-                "transcriber_text_context",
                 "transcriber_translation_terms",
                 "keywords"
             ],
@@ -1720,7 +1719,6 @@
                 "transcriber_provider",
                 "transcriber_language",
                 "transcriber_general_context",
-                "transcriber_text_context",
                 "transcriber_translation_terms",
                 "keywords"
             ],

package/dist/lib/updateCheck.js

@@ -3,6 +3,8 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.skillsOutdated = skillsOutdated;
+exports.recordSkillsInstalled = recordSkillsInstalled;
 exports.isNewer = isNewer;
 exports.notifyIfOutdated = notifyIfOutdated;
 const os_1 = require("os");
@@ -10,9 +12,56 @@ const path_1 = require("path");
 const fs_1 = require("fs");
 const child_process_1 = require("child_process");
 const chalk_1 = __importDefault(require("chalk"));
+const config_1 = require("./config");
 const CACHE = (0, path_1.join)(process.env.CK_CONFIG_DIR || (0, path_1.join)((0, os_1.homedir)(), '.config', 'callkaro-unofficial'), 'update-check.json');
+/** Which commit of each skill pack was installed, keyed `<repo>@<branch>`. */
+const SKILLS_INSTALLED = (0, path_1.join)((0, path_1.dirname)(CACHE), 'skills-installed.json');
 const DAY = 24 * 60 * 60 * 1000;
 const REGISTRY = 'https://registry.npmjs.org/callkaro-cli-unofficial/latest';
+// With this Accept header GitHub answers with the bare commit sha as text.
+const SHA_HEADERS = { Accept: 'application/vnd.github.sha', 'User-Agent': 'cku' };
+const SHA = /^[0-9a-f]{40}$/;
+const shaUrl = (repo, branch) => `https://api.github.com/repos/${repo}/commits/${branch}`;
+const skillsKey = () => `${(0, config_1.skillsRepo)()}@${(0, config_1.skillsBranch)()}`;
+const readJson = (file) => {
+    try {
+        return JSON.parse((0, fs_1.readFileSync)(file, 'utf8'));
+    }
+    catch {
+        return {};
+    }
+};
+/**
+ * True when the skill pack recorded at install time is not the repo's current
+ * head. Without a recorded install there is nothing to compare, so no notice.
+ */
+function skillsOutdated(installed, latest) {
+    return Boolean(installed && latest && installed !== latest);
+}
+/**
+ * Record which commit of the skill pack was just installed, so a later run can
+ * tell when the repo has moved on. The tarball does not carry its sha, so this
+ * asks GitHub for the branch head right after the install. Best effort: a
+ * failure only means no notice until the next `cku skills update`.
+ */
+async function recordSkillsInstalled(repo, branch) {
+    try {
+        const res = await fetch(shaUrl(repo, branch), { headers: SHA_HEADERS, signal: AbortSignal.timeout(5000) });
+        const sha = res.ok ? (await res.text()).trim() : '';
+        if (!SHA.test(sha))
+            return;
+        const key = `${repo}@${branch}`;
+        (0, fs_1.mkdirSync)((0, path_1.dirname)(CACHE), { recursive: true });
+        (0, fs_1.writeFileSync)(SKILLS_INSTALLED, JSON.stringify({ ...readJson(SKILLS_INSTALLED), [key]: sha }));
+        // Keep the cached head in step, or a head cached before this install would
+        // report the pack outdated until the next daily check.
+        if (key === skillsKey())
+            (0, fs_1.writeFileSync)(CACHE, JSON.stringify({ ...readJson(CACHE), skillsSha: sha }));
+    }
+    catch {
+        /* recording the install must never break it */
+    }
+}
 /** True when `latest` is a higher x.y.z than `current` (pre-release tags ignored). */
 function isNewer(latest, current) {
     const n = (v) => v.split('-')[0].split('.').map((x) => parseInt(x, 10) || 0);
@@ -29,6 +78,7 @@ function isNewer(latest, current) {
  * Reads the answer cached by an earlier run and prints it to stderr after the
  * command's own output, so stdout / --json stay clean. The npm lookup runs in a
  * detached child at most once a day, so it never delays or breaks a command.
+ * The same child reads the skill repo's head, for the skill-pack notice.
  * Opt out with CK_NO_UPDATE_CHECK=1 (or when running under `node --test`).
  */
 function notifyIfOutdated(current, argv) {
@@ -37,12 +87,15 @@ function notifyIfOutdated(current, argv) {
             return;
         if (argv.some((a) => ['update', '-v', '--version', '-h', '--help'].includes(a)))
             return;
-        let cache = {};
-        try {
-            cache = JSON.parse((0, fs_1.readFileSync)(CACHE, 'utf8'));
-        }
-        catch {
-            /* first run */
+        const cache = readJson(CACHE);
+        if (cache.skillsSha) {
+            process.on('exit', () => {
+                // Read at exit, not at start: `cku skills install` moves both records during this very run.
+                if (!skillsOutdated(readJson(SKILLS_INSTALLED)[skillsKey()], readJson(CACHE).skillsSha))
+                    return;
+                process.stderr.write(chalk_1.default.yellow(`\nThe CallKaro skill pack (${(0, config_1.skillsRepo)()}) has changed since it was installed.\n` +
+                    `AI agents: tell the user the skills are outdated and ask if they want to refresh; if yes, run \`cku skills update\`.\n`));
+            });
         }
         if (cache.latest && isNewer(cache.latest, current)) {
             process.on('exit', () => {
@@ -53,14 +106,18 @@ function notifyIfOutdated(current, argv) {
         if (!cache.checkedAt || Date.now() - cache.checkedAt > DAY) {
             const script = `
         const fs = require('fs'), path = require('path');
-        const file = process.argv[1];
+        const [, file, shaUrl] = process.argv;
         (async () => {
-          let latest;
+          let latest, skillsSha;
           try { latest = (await (await fetch(${JSON.stringify(REGISTRY)}, { signal: AbortSignal.timeout(5000) })).json()).version; } catch {}
+          try {
+            const sha = (await (await fetch(shaUrl, { headers: ${JSON.stringify(SHA_HEADERS)}, signal: AbortSignal.timeout(5000) })).text()).trim();
+            if (${String(SHA)}.test(sha)) skillsSha = sha;
+          } catch {}
           fs.mkdirSync(path.dirname(file), { recursive: true });
-          fs.writeFileSync(file, JSON.stringify({ checkedAt: Date.now(), latest }));
+          fs.writeFileSync(file, JSON.stringify({ checkedAt: Date.now(), latest, skillsSha }));
         })();`;
-            (0, child_process_1.spawn)(process.execPath, ['-e', script, CACHE], { detached: true, stdio: 'ignore' }).unref();
+            (0, child_process_1.spawn)(process.execPath, ['-e', script, CACHE, shaUrl((0, config_1.skillsRepo)(), (0, config_1.skillsBranch)())], { detached: true, stdio: 'ignore' }).unref();
         }
     }
     catch {

package/package.json

@@ -1,52 +1,52 @@
-{
-  "name": "callkaro-cli-unofficial",
-  "version": "0.9.2",
-  "license": "Apache-2.0",
-  "description": "Unofficial fork of the CallKaro CLI — manage your voice AI agents from the terminal",
-  "bin": {
-    "cku": "dist/index.js"
-  },
-  "files": [
-    "dist"
-  ],
-  "scripts": {
-    "build": "npm run clean && tsc -p tsconfig.json && node -e \"require('fs').copyFileSync('src/endpoints.json','dist/endpoints.json')\" && node -e \"try{require('fs').chmodSync('dist/index.js',0o755)}catch(e){}\"",
-    "dev": "npm run build && node dist/index.js",
-    "test": "npm run build && node --test tests/*.test.js",
-    "test:only": "node --test tests/*.test.js",
-    "clean": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\"",
-    "catalog:sync": "node scripts/sync-catalog.js",
-    "catalog:check": "node scripts/check-catalog-drift.js",
-    "catalog:check:live": "node scripts/check-catalog-drift.js --live"
-  },
-  "dependencies": {
-    "chalk": "^4.1.2",
-    "cli-table3": "^0.6.5",
-    "commander": "^12.0.0",
-    "just-bash": "^3.4.2",
-    "prompts": "^2.4.2"
-  },
-  "devDependencies": {
-    "@types/node": "^20.0.0",
-    "@types/prompts": "^2.4.9",
-    "typescript": "^5.4.0"
-  },
-  "engines": {
-    "node": ">=18"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/TejasLamba2006/callkaro-cli-unofficial.git"
-  },
-  "homepage": "https://github.com/TejasLamba2006/callkaro-cli-unofficial#readme",
-  "bugs": {
-    "url": "https://github.com/TejasLamba2006/callkaro-cli-unofficial/issues"
-  },
-  "keywords": [
-    "callkaro",
-    "voice-ai",
-    "cli",
-    "agents",
-    "telephony"
-  ]
-}
+{
+  "name": "callkaro-cli-unofficial",
+  "version": "0.9.4",
+  "license": "Apache-2.0",
+  "description": "Unofficial fork of the CallKaro CLI — manage your voice AI agents from the terminal",
+  "bin": {
+    "cku": "dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "npm run clean && tsc -p tsconfig.json && node -e \"require('fs').copyFileSync('src/endpoints.json','dist/endpoints.json')\" && node -e \"try{require('fs').chmodSync('dist/index.js',0o755)}catch(e){}\"",
+    "dev": "npm run build && node dist/index.js",
+    "test": "npm run build && node --test tests/*.test.js",
+    "test:only": "node --test tests/*.test.js",
+    "clean": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\"",
+    "catalog:sync": "node scripts/sync-catalog.js",
+    "catalog:check": "node scripts/check-catalog-drift.js",
+    "catalog:check:live": "node scripts/check-catalog-drift.js --live"
+  },
+  "dependencies": {
+    "chalk": "^4.1.2",
+    "cli-table3": "^0.6.5",
+    "commander": "^12.0.0",
+    "just-bash": "^3.4.2",
+    "prompts": "^2.4.2"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "@types/prompts": "^2.4.9",
+    "typescript": "^5.4.0"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/TejasLamba2006/callkaro-cli-unofficial.git"
+  },
+  "homepage": "https://github.com/TejasLamba2006/callkaro-cli-unofficial#readme",
+  "bugs": {
+    "url": "https://github.com/TejasLamba2006/callkaro-cli-unofficial/issues"
+  },
+  "keywords": [
+    "callkaro",
+    "voice-ai",
+    "cli",
+    "agents",
+    "telephony"
+  ]
+}