relayflows 2.0.1

package/README.md

@@ -0,0 +1,20 @@
+# relayflows
+
+The `flows` CLI, published under the unscoped name so the install is just:
+
+```sh
+npm install -g relayflows
+```
+
+This package carries no logic of its own. It declares `@relayflows/sdk` as a
+normal dependency and `bin/flows.js` forwards argv and stdio straight to that
+dependency's `dist/cli.js`, resolved by filesystem path from this package's
+own `node_modules` rather than by import specifier — the SDK's package
+`exports` doesn't list that subpath, so a bare `import` would be refused.
+
+Versioned and released in lockstep with `@relayflows/sdk`: the two always
+carry the same version number, and this package pins its dependency to that
+exact version rather than a range, so `npm install -g relayflows` always
+resolves the SDK build it shipped with.
+
+See `@relayflows/sdk` and `docs/SURFACE.md` for what the CLI actually does.

package/bin/flows.js

@@ -0,0 +1,23 @@
+#!/usr/bin/env node
+import { spawnSync } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+// Not `import '@relayflows/sdk/dist/cli.js'`: that subpath isn't in the
+// SDK's package "exports", so specifier resolution would refuse it. Locating
+// the installed dependency's real CLI file directly sidesteps that — this
+// package's only job is finding it and forwarding argv/stdio.
+const packageRoot = join(dirname(fileURLToPath(import.meta.url)), '..');
+const sdkCli = join(packageRoot, 'node_modules', '@relayflows', 'sdk', 'dist', 'cli.js');
+
+if (!existsSync(sdkCli)) {
+  process.stderr.write(
+    `relayflows: could not find @relayflows/sdk at ${sdkCli}\n` +
+      'Reinstall with `npm install -g relayflows`.\n',
+  );
+  process.exit(1);
+}
+
+const result = spawnSync(process.execPath, [sdkCli, ...process.argv.slice(2)], { stdio: 'inherit' });
+process.exit(result.status ?? 1);

package/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "relayflows",
+  "version": "2.0.1",
+  "description": "Relayflow v2 CLI. Installs the `flows` command — a thin wrapper around @relayflows/sdk, published under the unscoped name for `npm install -g relayflows`.",
+  "type": "module",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/AgentWorkforce/flows.git",
+    "directory": "packages/relayflows"
+  },
+  "files": [
+    "bin"
+  ],
+  "bin": {
+    "flows": "./bin/flows.js"
+  },
+  "dependencies": {
+    "@relayflows/sdk": "2.0.1"
+  },
+  "engines": {
+    "node": ">=20"
+  }
+}