@apilift/cli 1.4.15 → 1.4.18

package/dist/apilift.js

@@ -34327,12 +34327,21 @@ function command5(binary, args) {
   }
 }
 function active(agent2, expected) {
+  const args = agent2 === "codex" ? ["plugin", "list", "--marketplace", "personal", "--json"] : ["plugin", "list", "--json"];
   try {
-    const listed = command5(agent2, ["plugin", "list", "--json"]);
-    const entries = agent2 === "codex" ? listed.installed : listed;
-    return Array.isArray(entries) && entries.some((entry2) => typeof entry2 === "object" && entry2 !== null && (agent2 === "codex" ? entry2.pluginId : entry2.id) === "apilift@personal" && entry2.enabled === true && entry2.version === expected);
-  } catch {
-    return false;
+    const listed = command5(agent2, args);
+    const entries = agent2 === "codex" ? listed?.installed : listed;
+    if (!Array.isArray(entries) || entries.some((entry2) => typeof entry2 !== "object" || entry2 === null || typeof (agent2 === "codex" ? entry2.pluginId : entry2.id) !== "string")) return { ready: false, known: false, detail: `${agent2} plugin status could not be checked: plugin list returned an unexpected response` };
+    const plugin = entries.find((entry2) => (agent2 === "codex" ? entry2.pluginId : entry2.id) === "apilift@personal");
+    if (!plugin) return { ready: false, known: true, detail: "Apilift is not installed in this agent" };
+    if (typeof plugin.enabled !== "boolean" || typeof plugin.version !== "string") return { ready: false, known: false, detail: `${agent2} plugin status could not be checked: Apilift status is incomplete` };
+    if (!plugin.enabled) return { ready: false, known: true, detail: "Apilift is disabled in this agent" };
+    if (plugin.version !== expected) return { ready: false, known: true, detail: "The active Apilift plugin does not match the packaged version" };
+    return { ready: true, known: true, detail: "Agent setup skill is active" };
+  } catch (error62) {
+    const code = typeof error62 === "object" && error62 && "code" in error62 ? error62.code : void 0;
+    const reason = code === "ETIMEDOUT" ? "plugin list timed out after 10 seconds" : code === "ENOENT" ? `${agent2} executable was not found` : "plugin list failed";
+    return { ready: false, known: false, detail: `${agent2} plugin status could not be checked: ${reason}` };
   }
 }
 function inspectAgentPlugin(agent2, env, sourceOverride) {
@@ -34349,7 +34358,8 @@ function inspectAgentPlugin(agent2, env, sourceOverride) {
   const staged = marker?.package === "apilift" && marker.bundleDigest === bundleDigest && marker.version === version2 && existsSync4(join12(plugin, "skills", "setup", "SKILL.md"));
   if (!staged) return { ready: false, version: expected, detail: "Agent setup skill is missing or stale" };
   if (env.APILIFT_AGENT_HOME || env.APILIFT_AGENT_NO_ACTIVATE === "1") return { ready: false, version: expected, detail: "Agent setup skill is staged; activation is unverified" };
-  return active(agent2, expected) ? { ready: true, version: expected, detail: "Agent setup skill is active" } : { ready: false, version: expected, detail: "Agent setup skill is not active at the expected version" };
+  const activation = active(agent2, expected);
+  return { ready: activation.ready, version: expected, detail: activation.detail, checkFailed: !activation.known };
 }
 function ensureAgentPlugin(agent2, env, sourceOverride) {
   if (env.APILIFT_DEV_PLUGIN_ROOT) {
@@ -34400,7 +34410,10 @@ function ensureAgentPlugin(agent2, env, sourceOverride) {
   writeJson(marketplacePath, document);
   writeJson(join12(marketplace, ".claude-plugin", "marketplace.json"), { "$schema": "https://anthropic.com/claude-code/marketplace.schema.json", name: "personal", description: "Personal agent plugins", owner: { name: "Local" }, plugins: [{ name: "apilift", description: "Apilift setup", source: "./plugins/apilift", category: "development" }] });
   if (env.APILIFT_AGENT_HOME || env.APILIFT_AGENT_NO_ACTIVATE === "1") return { ready: false, version: expected, detail: `Plugin staged at ${plugin}; activation is disabled` };
-  if (!active(agent2, expected)) {
+  const initial = active(agent2, expected);
+  if (!initial.known) return { ready: false, version: expected, detail: initial.detail, checkFailed: true };
+  if (initial.ready) return { ready: true, version: expected, detail: initial.detail };
+  {
     if (agent2 === "codex") command5("codex", ["plugin", "add", "apilift@personal"]);
     else {
       let marketplaces;
@@ -34416,8 +34429,8 @@ function ensureAgentPlugin(agent2, env, sourceOverride) {
       command5("claude", ["plugin", "enable", "apilift@personal", "--scope", "user"]);
     }
   }
-  if (!active(agent2, expected)) return { ready: false, version: expected, detail: `${agent2} did not report the expected active plugin version` };
-  return { ready: true, version: expected, detail: "Setup skill is active" };
+  const activation = active(agent2, expected);
+  return { ready: activation.ready, version: expected, detail: activation.detail, checkFailed: !activation.known };
 }
 var markerName;
 var init_plugin = __esm({
@@ -37304,6 +37317,37 @@ var init_setup_check = __esm({
   }
 });
 
+// src/setup-guidance.ts
+function extensionUserMessage(extensionPath) {
+  const installation = extensionPath ? `1. In Chrome, open \`chrome://extensions\`.
+2. Turn on **Developer mode**, click **Load unpacked**, and select \`${extensionPath}\`.` : `1. In Chrome, open [Apilift in the Chrome Web Store](${extensionUrl}).
+2. Click **Add to Chrome**, then **Add extension**.`;
+  return `Add Apilift to Chrome so it can work with the apps you\u2019re signed in to.
+
+${installation}
+3. Keep Chrome open in that profile.
+4. Return to this chat and say **Continue Apilift setup**.
+
+If Apilift is already installed, open \`chrome://extensions\`, turn on its switch, then return here and say **Continue Apilift setup**.`;
+}
+function browserUserMessage(agent2) {
+  const instructions = agent2 === "codex" ? "1. In Codex, click **Settings \u2192 Computer Use \u2192 Google Chrome** (under **More browsers** if needed).\n2. Click **Install**. In Chrome, click **Add to Chrome**, then **Add extension** for ChatGPT. If Chrome already shows **Manage**, skip this step.\n3. Return to **Computer Use**, confirm Chrome shows **Manage**, and turn on its toggle. Use the Chrome profile where Apilift is installed." : "1. In Claude Code, enter `/chrome`.\n2. Choose **Install extension**. In Chrome, click **Add to Chrome**, then **Add extension**. If it is already installed, choose **Reconnect extension** instead.\n3. Run `/chrome` again and confirm **Status: Enabled** and **Extension: Installed**.";
+  const docs = agent2 === "codex" ? "https://learn.chatgpt.com/docs/chrome-extension" : "https://code.claude.com/docs/en/chrome";
+  return `Connect Chrome to ${agent2 === "codex" ? "Codex" : "Claude Code"} so your agent can finish the setup check.
+
+${instructions}
+4. Keep Chrome open, return to this chat, and ${agent2 === "codex" ? "select **@Chrome** and send **Continue Apilift setup**" : "say **Continue Apilift setup**"}.
+
+[Official instructions](${docs}).`;
+}
+var extensionUrl;
+var init_setup_guidance = __esm({
+  "src/setup-guidance.ts"() {
+    "use strict";
+    extensionUrl = "https://chromewebstore.google.com/detail/fcndhdoedflmfmckkgpkdhmglgepbhnd";
+  }
+});
+
 // src/cli.ts
 var cli_exports = {};
 __export(cli_exports, {
@@ -37443,11 +37487,16 @@ Fix the agent plugin installation and retry:
   ${prefix} setup continue
 `);
       }
-      if (!plugin.ready) return result2(`The Apilift installation is linked and the registry responded.
-${plugin.detail}.
-Agent setup skill readiness has not been recorded. Fix the plugin installation, then retry:
+      if (!plugin.ready) {
+        const checkCommand = session.agent === "codex" ? "codex plugin list --marketplace personal --json" : "claude plugin list --json";
+        const next = plugin.checkFailed ? `Activation is unknown. Diagnose the check before changing the installation:
+  ${checkCommand}
+Then retry:` : "Agent setup skill readiness has not been recorded. Activate the installed Apilift plugin, then retry:";
+        return result2("", 5, `${plugin.checkFailed ? "plugin-check-failed" : "plugin-not-ready"} \u2014 ${plugin.detail}.
+${next}
   ${prefix} setup continue
 `);
+      }
       await api.call("updateReadiness", { body: { agent: session.agent, agentState: { skillsReady: true, skillsVersion: plugin.version } } });
       try {
         await hostRegistrar(dataRoot(env), site, env);
@@ -37458,11 +37507,8 @@ Fix the local Chrome registration and retry:
 `);
       }
       const readiness2 = await api.call("updateReadiness", { body: {} });
-      if (!readiness2.machine.nativeHostReady || !readiness2.machine.extensionReady) return result2(`The installation and agent skill are ready. The native host is registered.
-Connect the Apilift extension in Chrome and leave Chrome running. A compatible extension handshake is required.
-Then run:
-  ${prefix} setup continue
-`);
+      if (!readiness2.machine.nativeHostReady || !readiness2.machine.extensionReady) return { ...result2(`${JSON.stringify({ action: "user", userMessage: extensionUserMessage(env.APILIFT_DEV_EXTENSION_PATH), resumeCommand: `${prefix} setup continue` })}
+`), stdoutJson: true };
       const agentState = readiness2.agents[session.agent];
       if (agentState?.verified) return result2(`Setup is verified for this agent. Continue the app work you were working on.
 `);
@@ -37473,14 +37519,8 @@ Then run:
       } catch (error62) {
         check2 = { ok: false, reason: `Browser bridge check failed (${typeof error62 === "object" && error62 && "code" in error62 ? String(error62.code) : "unavailable"})` };
       }
-      if (!check2.ok) return result2(`The installation, agent skill, native host, and extension are ready.
-${check2.reason}.
-Use this agent's browser tool to open this exact check URL in Chrome and keep the tab open:
-  ${challenge.url}
-Then run:
-  ${prefix} setup continue
-The check uses one safe GET request and changes no app state.
-`);
+      if (!check2.ok) return { ...result2(`${JSON.stringify({ action: "agent", reason: check2.reason, instruction: "Use this agent's browser tool to open the exact check URL in Chrome, wait for it to load, keep the tab open, then run resumeCommand. The check uses one safe GET request and changes no app state.", browserUrl: challenge.url, resumeCommand: `${prefix} setup continue`, onBrowserUnavailable: { action: "user", userMessage: browserUserMessage(session.agent) } })}
+`), stdoutJson: true };
       await recordVerified(api, session.agent);
       return result2(`The exact check tab responded to a safe browser replay. Setup is verified for this agent. Continue the app work you were working on.
 `);
@@ -37624,6 +37664,7 @@ var init_cli = __esm({
     init_update();
     init_version();
     init_setup_check();
+    init_setup_guidance();
   }
 });
 

package/dist/plugin/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "apilift",
-  "version": "1.4.15",
+  "version": "1.4.18",
   "description": "Set up Apilift and use authenticated app interfaces.",
   "author": {
     "name": "Apilift"

package/dist/plugin/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "apilift",
-  "version": "1.4.15",
+  "version": "1.4.18",
   "description": "Set up Apilift and use authenticated app interfaces.",
   "author": {
     "name": "Apilift"

package/dist/plugin/skills/setup/SKILL.md

@@ -7,4 +7,6 @@ description: Link Apilift to this agent and check installation readiness.
 
 Run `apilift` and follow the commands it prints. If it reports that linking is needed, run `apilift setup` and follow its returned step. Only a person can sign in, enter a one-time link code, provision a credential, or complete browser login. Use `apilift doctor` when setup or a selected app reports an installation problem.
 
+Only a person installs or enables browser extensions and configures the agent’s Chrome connection. Never attempt those actions through browser tools. When setup returns `action: "user"`, send its `userMessage` unchanged as your entire response and wait. Resume with its `resumeCommand` when the user returns. For `action: "agent"`, perform the browser check yourself; if Chrome tools are unavailable, send `onBrowserUnavailable.userMessage` unchanged and wait.
+
 Keep the user's authorized outcome as the completion condition. Use a first-party CLI, SDK, MCP server, or documented API when it already covers the work. Do not copy credential values into commands, definitions, files, or messages. Do not repeat a possibly dispatched mutation after lost output; follow the exact recovery command and inspect app state through an authorized read. If the runtime lacks a stable agent identity, put the same root `--session <worker-label>` before every command in this worker's session; independent workers need different labels.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@apilift/cli",
-  "version": "1.4.15",
+  "version": "1.4.18",
   "private": false,
   "type": "module",
   "bin": {
@@ -36,7 +36,7 @@
   "engines": {
     "node": ">=24.16.0 <27"
   },
-  "gitHead": "4907c9fb9f03f7679f41e57b4014e41fc5b982a9",
+  "gitHead": "9e58defbcf686d3c286905b6d1e24cc20b09ce08",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/egor-sergeev/apilift.git",