agent-state-machine 1.0.1 → 1.0.3

package/README.md

@@ -11,14 +11,28 @@ You write normal `async/await` code. The runtime handles:
 
 ## Install
 
+You need to install the package **globally** to get the CLI, and **locally** in your project so your workflow can import the library.
+
+### Global CLI
+Provides the `state-machine` command.
+
 ```bash
-npm i agent-state-machine
+# npm
+npm i -g agent-state-machine
+
+# pnpm
+pnpm add -g agent-state-machine
 ```
 
-Global CLI:
+### Local Library
+Required so your `workflow.js` can `import { agent, memory } from 'agent-state-machine'`.
 
 ```bash
-npm i -g agent-state-machine
+# npm
+npm i agent-state-machine
+
+# pnpm (for monorepos/turbo, install in root)
+pnpm add agent-state-machine -w
 ```
 
 Requirements: Node.js >= 16.

package/bin/cli.js

@@ -2,16 +2,29 @@
 
 import path from 'path';
 import fs from 'fs';
-import { pathToFileURL } from 'url';
+import { pathToFileURL, fileURLToPath } from 'url';
 import { WorkflowRuntime } from '../lib/index.js';
 import { setup } from '../lib/setup.js';
 
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
 const args = process.argv.slice(2);
 const command = args[0];
 
+function getVersion() {
+  try {
+    const pkgPath = path.join(__dirname, '../package.json');
+    const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));
+    return pkg.version;
+  } catch {
+    return 'unknown';
+  }
+}
+
 function printHelp() {
   console.log(`
-Agent State Machine CLI (Native JS Workflows Only)
+Agent State Machine CLI (Native JS Workflows Only) v${getVersion()}
 
 Usage:
   state-machine --setup <workflow-name>    Create a new workflow project
@@ -27,6 +40,7 @@ Usage:
 Options:
   --setup, -s     Initialize a new workflow with directory structure
   --help, -h      Show help
+  --version, -v   Show version
 
 Workflow Structure:
   workflows/<name>/
@@ -143,6 +157,11 @@ async function runOrResume(workflowName) {
 }
 
 async function main() {
+  if (command === '--version' || command === '-v') {
+    console.log(getVersion());
+    process.exit(0);
+  }
+
   if (!command || command === 'help' || command === '--help' || command === '-h') {
     printHelp();
     process.exit(0);

package/lib/runtime/runtime.js

@@ -12,18 +12,19 @@ import readline from 'readline';
 import { createMemoryProxy } from './memory.js';
 
 // Global runtime reference for agent() and memory access
-let currentRuntime = null;
+// stored on globalThis to ensure singleton access across different module instances (CLI vs local)
+const RUNTIME_KEY = Symbol.for('agent-state-machine.runtime');
 
 export function getCurrentRuntime() {
-  return currentRuntime;
+  return globalThis[RUNTIME_KEY];
 }
 
 export function setCurrentRuntime(runtime) {
-  currentRuntime = runtime;
+  globalThis[RUNTIME_KEY] = runtime;
 }
 
 export function clearCurrentRuntime() {
-  currentRuntime = null;
+  globalThis[RUNTIME_KEY] = null;
 }
 
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-state-machine",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "type": "module",
   "description": "A workflow orchestrator for running agents and scripts in sequence with state management",
   "main": "lib/index.js",