@ariacompute/agent 0.17.1

package/README.md

@@ -0,0 +1,70 @@
+# `@ariacompute/agent`
+
+The Aria agent SDK for TypeScript/JavaScript. The API mirrors the
+[OpenAI Agents SDK](https://developers.openai.com/api/docs/guides/agents/quickstart)
+(`Agent`, `run`, `runStreamed`, `tool`, `Session`) and talks to an
+`aria-agent-cloud` deployment through its **beta Agents** REST API.
+
+```bash
+npm install @ariacompute/agent
+```
+
+```ts
+import { Agent, run, tool } from "@ariacompute/agent";
+
+const historyFunFact = tool({
+  name: "history_fun_fact",
+  description: "Return a short history fact.",
+  parameters: { type: "object", properties: {} },
+});
+
+const agent = new Agent({
+  name: "History tutor",
+  instructions: "Answer history questions clearly and concisely.",
+  model: "gpt-4o-mini",
+  tools: [historyFunFact],
+});
+
+const result = await run(agent, "When did the Roman Empire fall?");
+console.log(result.finalOutput); // -> "476 AD"
+```
+
+## Streaming
+
+```ts
+const streamed = await runStreamed(agent, "Tell me something surprising");
+for await (const ev of streamed.events) {
+  if (ev.type === "agent.turn.output_text.delta") process.stdout.write(ev.delta);
+}
+const result = await streamed.completed;
+console.log(result.finalOutput);
+```
+
+Frames use the `agent.*` envelope: `agent.turn.created`, `agent.turn.in_progress`,
+`agent.turn.item.added`, `agent.turn.item.done`, `agent.turn.output_text.delta`,
+`agent.turn.output_text.done`, `agent.turn.completed` / `agent.turn.failed`.
+`agent.turn.completed` (or `agent.turn.failed`) is the **only** terminal event —
+there is no `data: [DONE]` sentinel.
+
+## Sessions
+
+```ts
+const session = await Session.create(agent);
+await run(agent, "hello", { session });
+await run(agent, "and then?", { session }); // continues the same conversation
+```
+
+## Configuration
+
+| Option | Environment variable | Default |
+| --- | --- | --- |
+| `baseUrl` | `ARIA_AGENT_BASE_URL` | `http://localhost:3000` |
+| `apiKey` | `ARIA_AGENT_API_KEY` | _(none)_ |
+| `betaHeader` | – | `agents=v1` (`OpenAI-Beta`) |
+
+## Tests
+
+```bash
+bun test          # or: npm test
+npm run typecheck
+```

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@ariacompute/agent",
+  "version": "0.17.1",
+  "description": "Aria agent SDK — mirrors the OpenAI Agents SDK shape (Agent / run / runStreamed / tool / Session) on top of the aria-agent-cloud beta Agents API.",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "bun test",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  },
+  "keywords": [
+    "agent",
+    "agents-sdk",
+    "aria",
+    "ariacompute",
+    "openai"
+  ],
+  "devDependencies": {
+    "@types/node": "^22.10.2",
+    "typescript": "^5.6.0"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}