simple-agents-node 0.2.2

package/README.md

@@ -0,0 +1,66 @@
+# simple-agents-napi
+
+Node.js bindings for SimpleAgents using napi-rs.
+
+## Build
+
+```sh
+npm install
+npm run build
+```
+
+## Usage
+
+```javascript
+const { Client } = require('./index.js');
+
+const client = new Client('openai');
+
+async function main() {
+  const response = await client.complete(
+    'gpt-4',
+    [
+      { role: 'system', content: 'You are concise.' },
+      { role: 'user', content: 'Say hi from Node.' },
+    ],
+    { max_tokens: 64, temperature: 0.7 },
+  );
+
+  console.log(response.content);
+  console.log(response.usage);
+  console.log(response.healed); // present when using healed_json/schema mode
+
+  // Streaming
+  const streamed = await client.stream(
+    'gpt-4',
+    'Say hello in two words.',
+    {},
+    (chunk) => {
+      if (chunk.content) process.stdout.write(chunk.content);
+      if (chunk.finish_reason) console.log('\nfinish:', chunk.finish_reason);
+    },
+  );
+  console.log('streamed content:', streamed.content);
+
+  // Healed JSON
+  const healed = await client.complete(
+    'gpt-4',
+    'Respond with JSON: {"message": "hello"}',
+    { mode: 'healed_json' },
+  );
+  console.log('parsed JSON value:', healed.healed?.value);
+}
+
+main().catch((err) => {
+  console.error(err);
+  process.exit(1);
+});
+```
+
+## Notes
+
+- Canonical env contract for examples/tests is: `CUSTOM_API_BASE`, `CUSTOM_API_KEY`, `CUSTOM_API_MODEL`, `PROVIDER`.
+- For OpenAI provider compatibility, map `CUSTOM_API_*` to `OPENAI_API_*` when needed (`OPENAI_API_KEY`, `OPENAI_API_BASE`, `OPENAI_MODEL`).
+- `max_tokens`, `temperature`, and `top_p` are optional. Use `mode: "healed_json"` for parsed JSON or `mode: "schema"` with a schema object to coerce/validate.
+- `complete` resolves with the first choice, usage metadata, and optional `healed`/`coerced` metadata. `stream` invokes a chunk callback and resolves with aggregated content (healing/schema not yet supported for streams).
+- Set `CUSTOM_API_BASE`, `CUSTOM_API_KEY`, `CUSTOM_API_MODEL`, and `PROVIDER` to run tests/examples consistently across bindings.

package/index.d.ts

@@ -0,0 +1,66 @@
+/* tslint:disable */
+/* eslint-disable */
+
+/* auto-generated by NAPI-RS */
+
+export interface CompleteOptions {
+  maxTokens?: number
+  temperature?: number
+  topP?: number
+  stream?: boolean
+  /** "standard" | "healed_json" | "schema" */
+  mode?: string
+  schema?: Schema
+}
+export interface MessageInput {
+  role: string
+  content: string
+  name?: string
+  toolCallId?: string
+  toolCalls?: Array<JsToolCall>
+}
+export interface JsToolCallFunction {
+  name: string
+  arguments: string
+}
+export interface JsToolCall {
+  id: string
+  toolType: string
+  function: JsToolCallFunction
+}
+export interface CompletionUsage {
+  promptTokens: number
+  completionTokens: number
+  totalTokens: number
+}
+export interface HealingData {
+  value?: unknown
+  flags: Array<string>
+  confidence: number
+}
+export interface CompletionResult {
+  id: string
+  model: string
+  role: string
+  content?: string
+  toolCalls?: Array<JsToolCall>
+  finishReason?: string
+  usage: CompletionUsage
+  latencyMs: number
+  raw?: string
+  healed?: HealingData
+  coerced?: HealingData
+}
+export interface StreamChunk {
+  id: string
+  model: string
+  content?: string
+  finishReason?: string
+  error?: string
+  raw?: string
+}
+export declare class Client {
+  constructor(provider: string)
+  complete(model: string, promptOrMessages: string | MessageInput[], options?: CompleteOptions): Promise<unknown>
+  stream(model: string, promptOrMessages: string | MessageInput[], options?: CompleteOptions, onChunk: (chunk: StreamChunk) => void): Promise<unknown>
+}

package/index.js

@@ -0,0 +1,7 @@
+"use strict";
+
+// Load the native addon built by napi-rs.
+const native = require("./index.node");
+
+module.exports = native;
+module.exports.default = native;

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "simple-agents-node",
+  "version": "0.2.2",
+  "description": "Node.js bindings for SimpleAgents using napi-rs",
+  "main": "index.js",
+  "types": "index.d.ts",
+  "files": [
+    "index.js",
+    "index.d.ts",
+    "README.md",
+    "index.node"
+  ],
+  "scripts": {
+    "build": "napi build --release",
+    "build:debug": "napi build",
+    "pretest": "npm run build:debug",
+    "test": "node --test test/*.test.js",
+    "prepublishOnly": "npm run build"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "napi": {
+    "name": "index"
+  },
+  "devDependencies": {
+    "@napi-rs/cli": "^2.16.0",
+    "typescript": "^5.4.0"
+  }
+}