@alint-js/agent-pi 0.0.4

package/README.md

@@ -0,0 +1,32 @@
+# `@alint-js/agent-pi`
+
+> [!IMPORTANT]
+> This package is a WIP. APIs may be subject to major changes.
+
+A [Pi](https://github.com/earendil-works/pi)-backed `AgentAdapter` for alint. One of the swappable vendor adapters behind `@alint-js/agent`.
+
+## What it does
+
+`createPiAdapter()` returns an `AgentAdapter` that runs a rule's request through a Pi
+`Agent`: it translates the framework-agnostic `AgentTool`s to Pi's TypeBox tools, runs
+the tool loop, and reads back the final assistant message.
+
+## How to use
+
+```ts
+import { createPiAdapter } from '@alint-js/agent-pi'
+
+const adapter = createPiAdapter()
+```
+
+Pass `{ run }` to inject a custom Pi run.
+
+## When to use
+
+- You want tool-using rules powered by Pi (`pi-ai` and `pi-agent-core`).
+
+## When not to use
+
+- You use a different agent framework. Pick that vendor's adapter (e.g.
+  `@alint-js/agent-apeira`) 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,20 @@
+import { AgentTool } from "@earendil-works/pi-agent-core";
+import { Model } from "@earendil-works/pi-ai";
+import { AgentAdapter, AgentRequest, AgentTool as AgentTool$1 } from "@alint-js/agent";
+import { ResolvedModel } from "@alint-js/core";
+
+//#region src/index.d.ts
+interface PiAdapterOptions {
+  run: (request: AgentRequest) => Promise<PiMessage[]>;
+}
+interface PiMessage {
+  content?: unknown;
+  role?: unknown;
+}
+declare function apiKeyFromModel(model: ResolvedModel): string;
+declare function createPiAdapter(options?: Partial<PiAdapterOptions>): AgentAdapter;
+declare function createPiModel(model: ResolvedModel): Model<'openai-completions'>;
+declare function extractPiText(message?: PiMessage): string;
+declare function toPiTools(tools: AgentTool$1[]): AgentTool[];
+//#endregion
+export { PiAdapterOptions, apiKeyFromModel, createPiAdapter, createPiModel, extractPiText, toPiTools };

package/dist/index.mjs

@@ -0,0 +1,74 @@
+import { Agent } from "@earendil-works/pi-agent-core";
+import { Type } from "@earendil-works/pi-ai";
+//#region src/index.ts
+function apiKeyFromModel(model) {
+	return (model.provider.headers.Authorization ?? model.provider.headers.authorization)?.replace(/^Bearer\s+/i, "") ?? "unused";
+}
+function createPiAdapter(options = {}) {
+	const run = options.run ?? runPiAgent;
+	return async (request) => {
+		return {
+			answer: extractPiText([...await run(request)].reverse().find((message) => message.role === "assistant")),
+			usage: void 0
+		};
+	};
+}
+function createPiModel(model) {
+	return {
+		api: "openai-completions",
+		baseUrl: model.provider.endpoint,
+		contextWindow: model.contextWindow ?? 32768,
+		cost: {
+			cacheRead: 0,
+			cacheWrite: 0,
+			input: 0,
+			output: 0
+		},
+		id: model.id,
+		input: ["text"],
+		maxTokens: 4096,
+		name: model.name,
+		provider: model.provider.id,
+		reasoning: false
+	};
+}
+function extractPiText(message) {
+	if (!message) return "";
+	const { content } = message;
+	if (typeof content === "string") return content;
+	if (Array.isArray(content)) return content.filter((part) => isTextPart(part)).map((part) => part.text).join("");
+	return "";
+}
+function toPiTools(tools) {
+	return tools.map((agentTool) => ({
+		description: agentTool.description,
+		execute: async (_toolCallId, params) => ({
+			content: [{
+				text: String(await agentTool.execute(params)),
+				type: "text"
+			}],
+			details: void 0
+		}),
+		label: agentTool.name,
+		name: agentTool.name,
+		parameters: Type.Unsafe(agentTool.parameters)
+	}));
+}
+function isTextPart(part) {
+	return typeof part === "object" && part !== null && part.type === "text" && typeof part.text === "string";
+}
+async function runPiAgent(request) {
+	const agent = new Agent({
+		getApiKey: () => apiKeyFromModel(request.model),
+		initialState: {
+			model: createPiModel(request.model),
+			systemPrompt: request.instructions,
+			tools: toPiTools(request.tools)
+		}
+	});
+	await agent.prompt(request.prompt);
+	await agent.waitForIdle();
+	return agent.state.messages;
+}
+//#endregion
+export { apiKeyFromModel, createPiAdapter, createPiModel, extractPiText, toPiTools };

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@alint-js/agent-pi",
+  "type": "module",
+  "version": "0.0.4",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.mts",
+      "default": "./dist/index.mjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@earendil-works/pi-agent-core": "^0.80.2",
+    "@earendil-works/pi-ai": "^0.80.2",
+    "@smithy/node-http-handler": "^4.9.1",
+    "@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"
+  }
+}