@acpfx/node-sdk 0.2.0 → 0.3.1

package/CHANGELOG.md

@@ -1,5 +1,31 @@
 # @acpfx/node-sdk
 
+## 0.3.1
+
+### Patch Changes
+
+- Updated dependencies [05c4208]
+  - @acpfx/core@0.4.1
+
+## 0.3.0
+
+### Minor Changes
+
+- 0e6838e: Add local on-device STT and TTS nodes (no API keys required). Introduces --acpfx-\* flag convention with setup phase for first-time model downloads, dynamic release pipeline with dual CPU/CUDA builds, MLX acceleration on Mac, and TUI improvements for speech event display.
+
+### Patch Changes
+
+- Updated dependencies [0e6838e]
+  - @acpfx/core@0.4.0
+
+## 0.2.1
+
+### Patch Changes
+
+- Updated dependencies [79c6694]
+- Updated dependencies [a0320a1]
+  - @acpfx/core@0.3.0
+
 ## 0.2.0
 
 ### Minor Changes

package/LICENSE

@@ -0,0 +1,15 @@
+ISC License
+
+Copyright (c) 2024-2026 acpfx contributors
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
+AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+PERFORMANCE OF THIS SOFTWARE.

package/README.md

@@ -0,0 +1,36 @@
+# @acpfx/node-sdk
+
+SDK for authoring acpfx pipeline nodes. Provides the standard primitives for emitting events, logging, and handling the NDJSON stdio protocol.
+
+## Install
+
+```bash
+npm install @acpfx/node-sdk
+```
+
+## API
+
+- **`emit(event)`** -- Send an event to stdout (NDJSON)
+- **`log.info(msg)` / `log.warn(msg)` / `log.error(msg)`** -- Structured logging via `log` events
+- **`onEvent(callback)`** -- Register a handler for incoming events on stdin
+- **`handleManifestFlag()`** -- Handle `--manifest` CLI flag (prints manifest JSON and exits)
+
+## Usage
+
+```typescript
+import { emit, log, onEvent, handleManifestFlag } from "@acpfx/node-sdk";
+
+handleManifestFlag();
+
+onEvent((event) => {
+  if (event.type === "audio.chunk") {
+    // process audio...
+  }
+});
+
+emit({ type: "lifecycle.ready" });
+```
+
+## License
+
+ISC

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "@acpfx/node-sdk",
-  "version": "0.2.0",
+  "version": "0.3.1",
   "type": "module",
   "main": "./src/index.ts",
   "types": "./src/index.ts",
   "dependencies": {
-    "@acpfx/core": "0.2.0"
+    "@acpfx/core": "0.4.1"
   }
 }

package/src/index.ts

@@ -1,16 +1,16 @@
 /**
  * Node SDK — shared helpers for acpfx TS nodes.
  *
- * Provides emit(), log(), onEvent(), and handleManifestFlag().
+ * Provides emit(), log(), onEvent(), and handleAcpfxFlags().
  * log() emits structured log events on stdout (not stderr).
  */
 
 import { createInterface, type Interface } from "node:readline";
 /**
- * Re-export handleManifestFlag from core — handles the --manifest flag.
- * If --manifest is in process.argv, prints the manifest as JSON and exits.
+ * Re-export handleAcpfxFlags from core — handles all --acpfx-* convention flags.
+ * Call at the top of your node's entry point before any async work.
  */
-export { handleManifestFlag } from "@acpfx/core";
+export { handleAcpfxFlags, handleManifestFlag } from "@acpfx/core";
 
 const NODE_NAME = process.env.ACPFX_NODE_NAME ?? "unknown";