anbaric-services-client 1.8.0

package/README.md

@@ -0,0 +1,57 @@
+# anbaric-services-client
+
+Client for the Anbaric **additional-services** agentic API. It exposes
+`AnbaricServicesAgent` — a light `Agent` (an actor) whose LLM output is generated
+by a hosted additional-services instance rather than by calling a model provider
+directly. Use it the same way you would `OpenAIAgent`, when your app should reach
+the model through the shared Anbaric service (the legacy-agent path) instead of
+holding provider credentials itself.
+
+The additional-services process is closed-source; **this client is not**. It
+depends only on `anbaric-tsapi`.
+
+## Install
+
+```bash
+npm install anbaric-services-client
+```
+
+## Usage
+
+Pair the agent with `RemoteLLMAgenticAction`: when the action runs, the agent
+generates the job's property changes against a JSON Schema.
+
+```ts
+import {PropertyDefinition, State, StateMachine, Transition} from "anbaric";
+import {RemoteLLMAgenticAction} from "anbaric-state-machine";
+import {AnbaricServicesAgent} from "anbaric-services-client";
+
+// baseUrl / apiKey default from ANBARIC_SERVICES_URL / ANBARIC_SERVICES_API_KEY,
+// which Anbaric Cloud injects into deployed app tasks. Locally they default to
+// http://localhost:8790 with no key.
+const agent = new AnbaricServicesAgent("triager", "assistant");
+
+const triage = new RemoteLLMAgenticAction(
+    "Triage the ticket",
+    agent,
+    [{ role: "system", content: "Decide the priority of the support ticket." }],
+    {
+        type: "object",
+        properties: { priority: { type: "string", enum: ["low", "high"] } },
+    },
+);
+
+const support = new StateMachine("support", [
+    new State("open", [triage], [new Transition("prioritised", (job) => job.properties.has("priority"))]),
+    new State("prioritised"),
+], "open", [new PropertyDefinition("priority")]);
+```
+
+## Configuration
+
+| Variable | Purpose | Default |
+| --- | --- | --- |
+| `ANBARIC_SERVICES_URL` | Base URL of the additional-services instance | `http://localhost:8790` |
+| `ANBARIC_SERVICES_API_KEY` | Bearer token for the service (if it requires one) | unset |
+
+The constructor's `connection` argument (`{ baseUrl, apiKey }`) overrides both.

package/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "anbaric-services-client",
+  "version": "1.8.0",
+  "description": "Client for the Anbaric additional-services agentic API: a light Agent whose property changes are generated by a hosted additional-services instance",
+  "license": "MIT",
+  "author": "chris@anbaric.ai",
+  "type": "module",
+  "main": "src/index.ts",
+  "types": "src/index.ts",
+  "dependencies": {
+    "anbaric-tsapi": "^1.8.0"
+  },
+  "devDependencies": {
+    "@types/node": "^26.2.0",
+    "typescript": "^7.0.2"
+  },
+  "files": [
+    "src"
+  ]
+}

package/src/AnbaricServicesAgent.ts

@@ -0,0 +1,66 @@
+import {Agent, AgentRequest} from "anbaric-tsapi";
+
+type FetchFn = (url : string, init : RequestInit) => Promise<Response>;
+
+type AnbaricServicesConnection = {
+    baseUrl? : string,
+    apiKey? : string,
+};
+
+const DEFAULT_SERVICES_URL = "http://localhost:8790";
+
+/* The functional half of a legacy Anbaric agent: hands the request to the
+   additional-services agentic API, which runs the completion against the
+   JSON Schema and returns the conforming output. The service URL and API key
+   default from the environment (ANBARIC_SERVICES_URL, ANBARIC_SERVICES_API_KEY),
+   falling back to localhost so an app co-located with the service works with
+   no configuration. */
+class AnbaricServicesClient extends Agent.Client {
+
+    private baseUrl : string;
+    private apiKey? : string;
+
+    constructor(connection : AnbaricServicesConnection = {},
+                private fetchFn : FetchFn = (url, init) => fetch(url, init)) {
+        super();
+        this.baseUrl = connection.baseUrl ?? process.env.ANBARIC_SERVICES_URL ?? DEFAULT_SERVICES_URL;
+        this.apiKey = connection.apiKey ?? process.env.ANBARIC_SERVICES_API_KEY;
+    }
+
+    async generate(request : AgentRequest) : Promise<Record<string, any>> {
+        const instructions = request.messages.filter(message => message.role === "system")
+            .map(message => message.content).join("\n\n") || "Produce output conforming to the schema.";
+        const input = request.messages.filter(message => message.role !== "system");
+
+        const response = await this.fetchFn(`${this.baseUrl}/agentic-actions`, {
+            method: "POST",
+            headers: {
+                "content-type": "application/json",
+                ...(this.apiKey ? { authorization: `Bearer ${this.apiKey}` } : {}),
+            },
+            body: JSON.stringify({ instructions, input, outputSchema: request.outputSchema }),
+        });
+
+        if (!response.ok) {
+            const problem = await response.json().catch(() => ({}));
+            throw new Error(`The Anbaric agent service failed with status ${response.status}${problem.error ? `: ${problem.error}` : ""}`);
+        }
+
+        return (await response.json()).output;
+    }
+
+}
+
+/* A light agent backed by the legacy Anbaric agents, reached through the
+   additional-services API. */
+class AnbaricServicesAgent extends Agent {
+
+    constructor(id : string, role : string, connection : AnbaricServicesConnection = {},
+                fetchFn : FetchFn = (url, init) => fetch(url, init)) {
+        super(id, role, new AnbaricServicesClient(connection, fetchFn));
+    }
+
+}
+
+export { AnbaricServicesAgent, AnbaricServicesClient }
+export type { AnbaricServicesConnection }

package/src/index.ts

@@ -0,0 +1 @@
+export * from "./AnbaricServicesAgent"