@alint-js/agent-apeira 0.0.4

package/README.md

@@ -0,0 +1,32 @@
+# `@alint-js/agent-apeira`
+
+> [!IMPORTANT]
+> This package is a WIP. APIs may be subject to major changes.
+
+An [Apeira](https://github.com/moeru-ai/apeira)-backed `AgentAdapter` for alint. One of the swappable vendor adapters behind `@alint-js/agent`.
+
+## What it does
+
+`createApeiraAdapter()` returns an `AgentAdapter` that runs a rule's request through
+Apeira's `chat` runner: it translates the framework-agnostic `AgentTool`s to xsai tools,
+runs the tool loop (capped at 8 steps), and reads back the final answer and usage.
+
+## How to use
+
+```ts
+import { createApeiraAdapter } from '@alint-js/agent-apeira'
+
+const adapter = createApeiraAdapter()
+```
+
+Pass `{ createRunner }` to inject a custom Apeira runner.
+
+## When to use
+
+- You want tool-using rules powered by Apeira on the xsai stack.
+
+## When not to use
+
+- You use a different agent framework. Pick that vendor's adapter (e.g.
+  `@alint-js/agent-pi`) or write your own `AgentAdapter`.
+- Your rule needs no tools. Keep it on the plain `@alint-js/core` rule DSL.

package/dist/index.d.mts

@@ -0,0 +1,12 @@
+import { Runner } from "apeira";
+import { AgentAdapter } from "@alint-js/agent";
+import { ResolvedModel } from "@alint-js/core";
+
+//#region src/index.d.ts
+interface ApeiraAdapterOptions {
+  createRunner: (model: ResolvedModel) => Runner;
+}
+declare function createApeiraAdapter(options?: Partial<ApeiraAdapterOptions>): AgentAdapter;
+declare function createApeiraRunner(model: ResolvedModel): Runner;
+//#endregion
+export { ApeiraAdapterOptions, createApeiraAdapter, createApeiraRunner };

package/dist/index.mjs

@@ -0,0 +1,64 @@
+import { chat, stepCountAtLeast, user } from "apeira";
+import { rawTool } from "xsai";
+//#region src/index.ts
+const maxSteps = 8;
+function createApeiraAdapter(options = {}) {
+	const createRunner = options.createRunner ?? createApeiraRunner;
+	return async (request) => {
+		const result = await createRunner(request.model)(buildRunnerContext(request));
+		return {
+			answer: extractAnswer(result.output),
+			usage: mapUsage(result.usage)
+		};
+	};
+}
+function createApeiraRunner(model) {
+	return chat({
+		baseURL: model.provider.endpoint,
+		headers: model.provider.headers,
+		model: model.id,
+		stopWhen: stepCountAtLeast(maxSteps)
+	});
+}
+function buildRunnerContext(request) {
+	return {
+		channel: noopChannel(),
+		input: [user(request.prompt)],
+		instructions: request.instructions,
+		tools: toRunnerTools(request.tools),
+		turnId: "alint"
+	};
+}
+function extractAnswer(output) {
+	for (let index = output.length - 1; index >= 0; index -= 1) {
+		const item = output[index];
+		if (item.role === "assistant" && typeof item.content === "string") return item.content;
+	}
+	return "";
+}
+function mapUsage(usage) {
+	if (!usage) return;
+	return {
+		inputTokens: usage.inputTokens,
+		outputTokens: usage.outputTokens,
+		totalTokens: usage.totalTokens
+	};
+}
+function noopChannel() {
+	return {
+		emit: () => {},
+		subscribe: () => () => {}
+	};
+}
+function toRunnerTools(tools) {
+	return tools.map((agentTool) => rawTool({
+		description: agentTool.description,
+		execute: async (input) => {
+			return await agentTool.execute(input) ?? "";
+		},
+		name: agentTool.name,
+		parameters: agentTool.parameters
+	}));
+}
+//#endregion
+export { createApeiraAdapter, createApeiraRunner };

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@alint-js/agent-apeira",
+  "type": "module",
+  "version": "0.0.4",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.mts",
+      "default": "./dist/index.mjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "apeira": "^0.0.6",
+    "xsai": "^0.5.0-beta.6",
+    "@alint-js/core": "0.0.4",
+    "@alint-js/agent": "0.0.4"
+  },
+  "devDependencies": {
+    "@types/node": "^26.0.1",
+    "tsdown": "^0.22.3",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.9"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run --config vitest.config.ts"
+  }
+}