@postman/postman-plugin 0.1.2-rc.0 → 0.2.0-rc.0

package/README.md

@@ -24,9 +24,9 @@ Install Postman in every compatible coding agent detected on your machine:
 npx @postman/postman-plugin
 ```
 
-One command configures **Claude Code, Codex, Cursor, Kimi Code, OpenCode and Pi**.
-Run it again to update, `status` to see what's installed, and `remove` to
-uninstall; `--agent <id>` limits any of them to one agent.
+One command configures **Claude Code, Codex, Cursor, Factory Droid, Kimi Code,
+OpenCode and Pi**. Run it again to update, `status` to see what's installed,
+and `remove` to uninstall; `--agent <id>` limits any of them to one agent.
 
 You can also use the following commands to install individually:
 
@@ -54,6 +54,17 @@ claude plugin install postman@postman
 codex plugin add postman@postman
 ```
 
+### Factory Droid
+
+```bash
+droid plugin marketplace add postmanlabs/postman-plugin
+droid plugin install postman@postman-plugin --scope user
+```
+
+`droid plugin marketplace update postman-plugin`, then
+`droid plugin update postman@postman-plugin --scope user`, updates it. Sign in
+to Postman's MCP server with `/mcp` inside a Droid session.
+
 ### Pi
 
 [View Postman in Pi's package gallery](https://pi.dev/packages/@postman/postman-plugin)

package/dist/hosts/factory.js

@@ -0,0 +1,67 @@
+import { GIT_URL, REPO, isSameRepo, redact } from '../source.js';
+import { blocked, guard, mustProbeText, mustRun } from './shared.js';
+import { result } from './types.js';
+const MARKETPLACE = 'postman-plugin', PLUGIN_ID = `postman@${MARKETPLACE}`, SCOPE = 'user', NEXT = 'Restart Droid for the change to take effect.';
+function hasInstalledPlugin(text) {
+    return text.split('\n').some((line) => new RegExp(`^${PLUGIN_ID}\\s+\\[${SCOPE}\\]`).test(line.trimStart()));
+}
+function marketplaceSource(text) {
+    for (const line of text.split('\n')) {
+        const match = /^\s*(\S+)\s+\(\d+ plugins?\)\s+(.+?)(?:\s+"[^"]*")?\s*$/.exec(line);
+        if (match && match[1] === MARKETPLACE) {
+            return match[2];
+        }
+    }
+    return null;
+}
+function sourceWithoutFactoryPrefix(source) {
+    return source.replace(/^(?:github|url):/, '');
+}
+async function listPlugins(system) {
+    return mustProbeText(system, 'droid', ['plugin', 'list', '--scope', SCOPE]);
+}
+async function refreshMarketplace(system) {
+    const source = marketplaceSource(await mustProbeText(system, 'droid', ['plugin', 'marketplace', 'list']));
+    if (!source) {
+        await mustRun(system, 'droid', ['plugin', 'marketplace', 'add', GIT_URL]);
+        return;
+    }
+    if (!isSameRepo(sourceWithoutFactoryPrefix(source), REPO)) {
+        blocked(`marketplace ${MARKETPLACE} is registered from ${redact(source)}, not ${REPO}`);
+    }
+    await mustRun(system, 'droid', ['plugin', 'marketplace', 'update', MARKETPLACE]);
+}
+export const factory = {
+    id: 'factory',
+    name: 'Factory Droid',
+    route: '.factory-plugin',
+    async detect(system) {
+        return (await system.which('droid')) !== null;
+    },
+    async status(system) {
+        const exec = await system.probe('droid', ['plugin', 'list', '--scope', SCOPE]);
+        if (exec.code !== 0) {
+            return { installed: null, detail: 'could not read `droid plugin list --scope user`', notes: [] };
+        }
+        return hasInstalledPlugin(exec.stdout) ?
+            { installed: true, detail: PLUGIN_ID, notes: [] } :
+            { installed: false, detail: 'not installed', notes: [] };
+    },
+    install(system) {
+        return guard(async () => {
+            await refreshMarketplace(system);
+            const wasInstalled = hasInstalledPlugin(await listPlugins(system)), verb = wasInstalled ? 'update' : 'install';
+            await mustRun(system, 'droid', ['plugin', verb, PLUGIN_ID, '--scope', SCOPE]);
+            return result('done', `${wasInstalled ? 'updated' : 'installed'} ${PLUGIN_ID}`, NEXT);
+        });
+    },
+    remove(system) {
+        return guard(async () => {
+            if (!hasInstalledPlugin(await listPlugins(system))) {
+                return result('skipped', 'not installed');
+            }
+            await mustRun(system, 'droid', ['plugin', 'uninstall', PLUGIN_ID, '--scope', SCOPE]);
+            return result('done', `uninstalled ${PLUGIN_ID}`, NEXT);
+        });
+    }
+};

package/dist/hosts/index.js

@@ -1,7 +1,8 @@
 import { claudeCode } from './claude-code.js';
 import { codex } from './codex.js';
 import { cursor } from './cursor.js';
+import { factory } from './factory.js';
 import { kimi } from './kimi.js';
 import { opencode } from './opencode.js';
 import { pi } from './pi.js';
-export const HOSTS = [claudeCode, codex, cursor, kimi, opencode, pi];
+export const HOSTS = [claudeCode, codex, cursor, factory, kimi, opencode, pi];

package/dist/hosts/shared.js

@@ -41,6 +41,14 @@ export async function mustProbeJson(system, command, args) {
     }
     return parsed;
 }
+/** Runs a read-only listing with no JSON mode; throws `StepFailed` if it fails. */
+export async function mustProbeText(system, command, args) {
+    const exec = await system.probe(command, args);
+    if (exec.code !== 0) {
+        throw new StepFailed(result('failed', describeFailure(command, args, exec)));
+    }
+    return exec.stdout;
+}
 export function blocked(message) {
     throw new StepFailed(result('blocked', message));
 }

package/mcp.pi.json

@@ -6,8 +6,8 @@
       "description": "Postman workspaces, collections, specs, environments, mocks and monitors",
       "headers": {
         "X-Source": "postman-pi-plugin",
-        "X-Plugin-Version": "0.1.2-rc.0",
-        "User-Agent": "postman-pi-plugin/0.1.2-rc.0"
+        "X-Plugin-Version": "0.2.0-rc.0",
+        "User-Agent": "postman-pi-plugin/0.2.0-rc.0"
       }
     }
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@postman/postman-plugin",
-  "version": "0.1.2-rc.0",
+  "version": "0.2.0-rc.0",
   "description": "Postman's API engineering skills for coding agents: a Pi package, and an npx installer that sets up Claude Code, Codex, Cursor, Kimi Code, OpenCode and Pi.",
   "type": "module",
   "license": "Apache-2.0",
@@ -23,6 +23,7 @@
     "claude-code",
     "codex",
     "cursor",
+    "factory.ai",
     "kimi",
     "opencode",
     "agent-plugin"