arisa 4.1.14 → 4.2.0

package/AGENTS.md

@@ -23,6 +23,15 @@ Do not build runtime paths by hand. Use `src/runtime/paths.js`:
 
 Tools receive `chatId` from the registry. Any persisted or indexed user content must be scoped by chat. Avoid ad hoc roots like `~/.arisa/state/<toolName>`, `~/.arisa/state/chats`, or runtime data inside `~/.arisa/tools/<toolName>`.
 
+## Tool config rules
+Every tool has a local `config.js` that exports generic, non-user-specific defaults. Keep user credentials, deployment-specific URLs, account ids, phone numbers, and other per-user values empty or neutral there; document required values in `tool.manifest.json` `configSchema`.
+
+Tools must consume config through `src/core/tools/tool-config.js`:
+- `loadToolConfig(toolName, defaults)` for global tools and daemons that run as one shared process.
+- `loadToolConfig(toolName, defaults, request.chatId)` inside `run()` for request-scoped tools that should honor per-chat overrides.
+
+Config precedence is a shallow merge: tool defaults -> global tool config (`~/.arisa/tools/<toolName>/config.js`) -> chat tool config (`~/.arisa/chats/<chatId>/config/tools/<toolName>/config.js`). Per-request `args` may override loaded config for that invocation only; do not persist request args as config unless the user explicitly asked to set a default.
+
 ## Main rule: everything is piped through artifacts
 A pipe transforms one input artifact into one output artifact.
 Examples:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arisa",
-  "version": "4.1.14",
+  "version": "4.2.0",
   "description": "Telegram + Pi Agent modular assistant",
   "type": "module",
   "main": "src/index.js",

package/src/core/agent/agent-manager.js

@@ -1,9 +1,9 @@
 import path from "node:path";
-import { stat, unlink } from "node:fs/promises";
-import { createAgentSession, SessionManager, defineTool } from "@earendil-works/pi-coding-agent";
+import { readFile, stat, unlink } from "node:fs/promises";
+import { createAgentSession, DefaultResourceLoader, SessionManager, defineTool } from "@earendil-works/pi-coding-agent";
 import { Type } from "@sinclair/typebox";
 import { createPiRuntime, hasProviderAuth } from "./pi-runtime.js";
-import { arisaInstallDir, buildAgentRuntimeContext } from "./runtime-context.js";
+import { appendArisaAgentsFile, arisaAgentsFile, arisaInstallDir, buildAgentRuntimeContext } from "./runtime-context.js";
 import { withTimeout } from "./prompt-timeout.js";
 import { buildPiToolPolicy, getCoreCodingTools } from "./core-tools.js";
 import { createSystemShellTool } from "./system-shell-tool.js";
@@ -88,6 +88,17 @@ async function assertDirectory(dir, label) {
   }
 }
 
+async function createArisaResourceLoader({ cwd, agentDir }) {
+  const arisaAgentsContent = await readFile(arisaAgentsFile, "utf8");
+  const resourceLoader = new DefaultResourceLoader({
+    cwd,
+    agentDir,
+    agentsFilesOverride: (current) => appendArisaAgentsFile(current, arisaAgentsContent)
+  });
+  await resourceLoader.reload();
+  return resourceLoader;
+}
+
 export class AgentManager {
   constructor({ config, artifactStore, toolRegistry, taskStore, logger }) {
     this.config = config;
@@ -188,9 +199,14 @@ export class AgentManager {
       ...this.createTools(telegram, chatId, policy),
       createSystemShellTool({ workspaceDir: policy.workspaceDir, shell: policy.shell })
     ];
+    const resourceLoader = await createArisaResourceLoader({
+      cwd: policy.workspaceDir,
+      agentDir: arisaHomeDir
+    });
     const { session } = await createAgentSession({
       cwd: policy.workspaceDir,
       agentDir: arisaHomeDir,
+      resourceLoader,
       authStorage,
       modelRegistry,
       model,

package/src/core/agent/runtime-context.js

@@ -1,7 +1,19 @@
+import path from "node:path";
 import { fileURLToPath } from "node:url";
 import { arisaHomeDir, arisaPackageDir, chatsDir, stateDir, toolStateDir, toolsDir } from "../../runtime/paths.js";
 
 export const arisaInstallDir = fileURLToPath(new URL("../../..", import.meta.url));
+export const arisaAgentsFile = path.join(arisaPackageDir, "AGENTS.md");
+
+export function appendArisaAgentsFile(current, content, agentsFilePath = arisaAgentsFile) {
+  return {
+    ...current,
+    agentsFiles: [
+      ...(current.agentsFiles || []).filter((file) => path.resolve(file.path) !== path.resolve(agentsFilePath)),
+      { path: agentsFilePath, content }
+    ]
+  };
+}
 
 function formatCoreTools(coreTools = []) {
   const enabled = coreTools
@@ -20,6 +32,7 @@ export function buildAgentRuntimeContext({ workspaceDir = arisaHomeDir, coreTool
     `toolStateDir: ${toolStateDir}`,
     `chatsDir: ${chatsDir}`,
     `stateDir: ${stateDir}`,
+    `arisaAgentsFile: ${arisaAgentsFile}`,
     `enabledCoreTools: ${formatCoreTools(coreTools)}`,
     "Guidance: create or edit user tools under userToolsDir. Treat arisaPackageDir/arisaInstallDir as Arisa core and modify it only when the user explicitly asks for core changes."
   ].join("\n");

package/src/core/artifacts/artifact-store.js

@@ -7,6 +7,11 @@ function id() {
   return crypto.randomUUID();
 }
 
+function writeArtifactFile(filePath, content) {
+  if (typeof content === "string") return writeFile(filePath, content, "utf8");
+  return writeFile(filePath, content);
+}
+
 class ChatArtifactStore {
   constructor(chatId) {
     this.chatId = String(chatId);
@@ -81,7 +86,7 @@ class ChatArtifactStore {
     const dir = path.join(this.rootDir, artifactId);
     await mkdir(dir, { recursive: true });
     const destPath = path.join(dir, fileName);
-    await writeFile(destPath, content);
+    await writeArtifactFile(destPath, content);
     const artifact = {
       id: artifactId,
       chatId: this.chatId,

package/test/agent-tool-policy.test.js

@@ -4,6 +4,7 @@ import os from "node:os";
 import path from "node:path";
 import test from "node:test";
 import { buildPiToolPolicy } from "../src/core/agent/core-tools.js";
+import { appendArisaAgentsFile, arisaAgentsFile } from "../src/core/agent/runtime-context.js";
 import { createSystemShellTool } from "../src/core/agent/system-shell-tool.js";
 import { applyRuntimeOverrides } from "../src/runtime/create-app.js";
 import { arisaHomeDir } from "../src/runtime/paths.js";
@@ -89,3 +90,22 @@ test("system_shell runs commands from the configured workspace", async () => {
   assert.equal(result.details.exitCode, 0);
   assert.equal(result.details.stdout, realWorkspaceDir);
 });
+
+test("adds Arisa AGENTS.md to Pi context files without duplicating it", () => {
+  const current = {
+    agentsFiles: [
+      { path: "/workspace/AGENTS.md", content: "# Workspace" },
+      { path: arisaAgentsFile, content: "old" }
+    ],
+    diagnostics: []
+  };
+
+  const next = appendArisaAgentsFile(current, "# Arisa AGENTS");
+
+  assert.deepEqual(next.diagnostics, []);
+  assert.deepEqual(
+    next.agentsFiles.map((file) => file.path),
+    ["/workspace/AGENTS.md", arisaAgentsFile]
+  );
+  assert.equal(next.agentsFiles.at(-1).content, "# Arisa AGENTS");
+});

package/test/artifact-store.test.js

@@ -83,6 +83,20 @@ test("creates generated file artifacts", async () => {
   assert.equal(artifact.mimeType, "text/markdown");
 });
 
+test("writes generated text file artifacts as UTF-8", async () => {
+  await resetHome();
+  const content = "# Español\nÑandú\n";
+  const artifact = await new ArtifactStore().forChat("chat-1").createGeneratedFile({
+    fileName: "reply.txt",
+    content,
+    kind: "document",
+    mimeType: "text/plain",
+    source: { type: "assistant" }
+  });
+
+  assert.deepEqual(await readFile(artifact.path), Buffer.from(content, "utf8"));
+});
+
 test("keeps artifact indexes isolated by chat", async () => {
   await resetHome();
   const store = new ArtifactStore();