@synadia-ai/agent-fabric 0.0.0-stage → 0.2.0

package/examples/answer-questions.mjs

@@ -0,0 +1,33 @@
+// An agent may ask a question before it answers. onQuery answers it: here
+// from the terminal, one line per question.
+//
+//   NATS_URL=<the URL the console showed> NATS_CREDS=./my.creds node answer-questions.mjs writer "Write me a poem."
+//
+// Install first: npm install @synadia-ai/agent-fabric
+
+import { createInterface } from "node:readline";
+import { fabricCallerFromEnv } from "@synadia-ai/agent-fabric";
+
+const [who, ...words] = process.argv.slice(2);
+if (who === undefined || words.length === 0) {
+  console.error('usage: node answer-questions.mjs <address or kind> "<text>"');
+  process.exit(2);
+}
+
+// One line per answer, read as it comes: stdin may be a terminal or a pipe.
+const terminal = createInterface({ input: process.stdin });
+const lines = terminal[Symbol.asyncIterator]();
+const caller = await fabricCallerFromEnv();
+try {
+  const { text } = await caller.ask(who, words.join(" "), {
+    onQuery: async (query) => {
+      process.stderr.write(`${query.prompt}\n> `);
+      const next = await lines.next();
+      return next.done ? "" : next.value;
+    },
+  });
+  console.log(text);
+} finally {
+  terminal.close();
+  await caller.close();
+}

package/examples/ask.mjs

@@ -0,0 +1,22 @@
+// A reply as a string, for a script: ask() waits for the whole reply and
+// returns it with the task's root id.
+//
+//   NATS_URL=<the URL the console showed> NATS_CREDS=./my.creds node ask.mjs writer "Name three rivers."
+//
+// Install first: npm install @synadia-ai/agent-fabric
+
+import { fabricCallerFromEnv } from "@synadia-ai/agent-fabric";
+
+const [who, ...words] = process.argv.slice(2);
+if (who === undefined || words.length === 0) {
+  console.error('usage: node ask.mjs <address or kind> "<text>"');
+  process.exit(2);
+}
+
+const caller = await fabricCallerFromEnv();
+try {
+  const { text, rootId } = await caller.ask(who, words.join(" "));
+  console.log(JSON.stringify({ root: rootId, words: text.split(/\s+/).length, text }));
+} finally {
+  await caller.close();
+}

package/examples/every.mjs

@@ -0,0 +1,28 @@
+// A list of topics, prompted one after another on an interval: each prompt
+// a task of its own, its root id printed with the topic.
+//
+//   NATS_URL=<the URL the console showed> NATS_CREDS=./my.creds node every.mjs writer 60 "the sea" "the moon"
+//
+// Install first: npm install @synadia-ai/agent-fabric
+
+import { setTimeout as sleep } from "node:timers/promises";
+import { fabricCallerFromEnv } from "@synadia-ai/agent-fabric";
+
+const [who, seconds, ...topics] = process.argv.slice(2);
+if (who === undefined || !(Number(seconds) > 0) || topics.length === 0) {
+  console.error('usage: node every.mjs <address or kind> <seconds> "<topic>" ...');
+  process.exit(2);
+}
+
+const caller = await fabricCallerFromEnv();
+process.on("SIGINT", () => void caller.close().then(() => process.exit(0)));
+for (let i = 0; ; i++) {
+  const topic = topics[i % topics.length];
+  try {
+    const { text, rootId } = await caller.ask(who, `Write two lines about ${topic}.`);
+    console.log(`[${topic}] root ${rootId}\n${text}\n`);
+  } catch (err) {
+    console.error(`[${topic}] no reply: ${err.message}`);
+  }
+  await sleep(Number(seconds) * 1000);
+}

package/examples/list-agents.mjs

@@ -0,0 +1,21 @@
+// The agents your creds file can reach: address, kind, and whether the
+// agent's identity is verified.
+//
+//   NATS_URL=<the URL the console showed> NATS_CREDS=./my.creds node list-agents.mjs
+//
+// Install first: npm install @synadia-ai/agent-fabric
+
+import { fabricCallerFromEnv } from "@synadia-ai/agent-fabric";
+
+const caller = await fabricCallerFromEnv();
+try {
+  for (const agent of await caller.list()) {
+    const identity =
+      agent.identity === undefined ? "agent identity: none" : `agent ${agent.identity}`;
+    console.log(
+      `${agent.promptSubject}\t${agent.agent}\t${identity}${agent.idSigVerified ? ", verified" : ""}`,
+    );
+  }
+} finally {
+  await caller.close();
+}

package/examples/prompt.mjs

@@ -0,0 +1,25 @@
+// One prompt: the reply streamed as it comes, then the root id of the task
+// it started, which is how the console finds that task.
+//
+//   NATS_URL=<the URL the console showed> NATS_CREDS=./my.creds node prompt.mjs writer "Say hello."
+//
+// Install first: npm install @synadia-ai/agent-fabric
+
+import { fabricCallerFromEnv } from "@synadia-ai/agent-fabric";
+
+const [who, ...words] = process.argv.slice(2);
+if (who === undefined || words.length === 0) {
+  console.error('usage: node prompt.mjs <address or kind> "<text>"');
+  process.exit(2);
+}
+
+const caller = await fabricCallerFromEnv();
+try {
+  const { stream, rootId } = await caller.prompt(who, words.join(" "));
+  for await (const msg of stream) {
+    if (msg.type === "response") process.stdout.write(msg.text);
+  }
+  console.log(`\nroot ${await rootId}`);
+} finally {
+  await caller.close();
+}

package/package.json

@@ -1,6 +1,89 @@
 {
   "name": "@synadia-ai/agent-fabric",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.2.0",
+  "description": "The SDK for agents on the Synadia Agent Fabric — tracing and the agent tools' ScratchPad extension, on the hooks of the Synadia Agent Protocol SDK.",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "agent-fabric": "./dist/cli.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "examples",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE",
+    "THIRD_PARTY_NOTICES"
+  ],
+  "sideEffects": false,
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "test": "vitest run",
+    "test:unit": "vitest run test/unit",
+    "test:integration": "vitest run test/integration",
+    "test:watch": "vitest",
+    "check": "npm run typecheck && npm run lint && npm run format:check && npm run test",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "nats",
+    "ai",
+    "agents",
+    "agent-fabric",
+    "tracing",
+    "scratchpad",
+    "synadia",
+    "sdk"
+  ],
+  "license": "Apache-2.0",
+  "author": "Synadia Communications",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/synadia-ai/agent-fabric-sdk.git",
+    "directory": "typescript"
+  },
+  "homepage": "https://github.com/synadia-ai/agent-fabric-sdk/tree/main/typescript",
+  "bugs": {
+    "url": "https://github.com/synadia-ai/agent-fabric-sdk/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@nats-io/nats-core": "^3.4.0",
+    "@nats-io/transport-node": "^3.4.0",
+    "@synadia-ai/agent-service": "^0.6.0",
+    "@synadia-ai/agents": "^0.6.0"
+  },
+  "devDependencies": {
+    "@unicode/unicode-15.0.0": "2.0.7",
+    "@types/node": "^22.0.0",
+    "ajv": "^8.17.0",
+    "eslint": "^9.0.0",
+    "eslint-config-prettier": "^9.1.0",
+    "prettier": "3.9.5",
+    "tsup": "^8.3.0",
+    "typescript": "~5.6.0",
+    "typescript-eslint": "^8.10.0",
+    "vitest": "^3.2.0"
+  }
+}