@agentprojectcontext/apx 1.81.0 → 1.89.1

package/src/core/http-tools/catalog.js

@@ -64,6 +64,26 @@ export const TOOL_DEFINITIONS = Object.freeze([
     },
     examples: [{ path: "src" }],
   },
+  {
+    // Native loop tool. Listed so the agent picker can toggle it; HTTP /call
+    // is 501 — the exec_agent loop runs the in-process handler.
+    name: "edit_file",
+    category: "file",
+    description: "Replace one exact string with another inside a project file. Prefer this over write_file for small edits.",
+    endpoint: null,
+    parameters: {
+      type: "object",
+      properties: {
+        path: { type: "string", description: "Relative path inside the project" },
+        search: { type: "string", description: "Exact text to replace" },
+        replace: { type: "string", description: "Replacement text" },
+        all: { type: "boolean", description: "Replace every match; default false" },
+        project: { type: "string" },
+      },
+      required: ["path", "search", "replace"],
+    },
+    examples: [{ path: "README.md", search: "old", replace: "new" }],
+  },
 
   // ── shell ─────────────────────────────────────────────────────────────────
   {
@@ -339,7 +359,7 @@ export const TOOL_DEFINITIONS = Object.freeze([
   {
     name: "browser_navigate",
     category: "browser",
-    description: "Navigate the headless browser to a URL. Launches Chromium lazily on first call. Auto-retries and falls back to a more permissive wait strategy on redirect-heavy sites.",
+    description: "Navigate the headless browser to a URL. Launches Chromium lazily on first call. Auto-retries and falls back to a more permissive wait strategy on redirect-heavy sites. Pass snapshot:true to get the page's accessibility tree back in the same call — that is the normal way to drive a page: navigate → read refs → act on refs.",
     endpoint: { method: "POST", path: "/api/tools/browser/navigate" },
     parameters: {
       type: "object",
@@ -350,12 +370,28 @@ export const TOOL_DEFINITIONS = Object.freeze([
           enum: ["load", "domcontentloaded", "networkidle0", "networkidle2"],
           description: "Puppeteer wait strategy (default networkidle2). Use 'domcontentloaded' for slow/redirect-heavy sites; navigate auto-falls back to it on failure anyway.",
         },
+        snapshot: { type: "boolean", description: "Also return the accessibility snapshot (with refs) after the page settles. Saves a round trip." },
         launch_options: { type: "object", description: "Puppeteer launch overrides (headless, args, defaultViewport, etc.)." },
         allow_dangerous: { type: "boolean", description: "Allow dangerous launch args (--no-sandbox, --single-process, etc.)." },
       },
       required: ["url"],
     },
-    examples: [{ url: "https://example.com" }],
+    examples: [{ url: "https://example.com", snapshot: true }],
+  },
+  {
+    name: "browser_snapshot",
+    category: "browser",
+    description: "Read the current page as an accessibility tree: role, accessible name, state, one line per element, with every interactive control stamped [ref_N]. THIS is how you see a page — call it after navigating and after any action that changes the DOM, then pass a ref to browser_click / browser_type / browser_select / browser_hover instead of guessing a CSS selector from HTML. Refs are invalidated by navigation or re-render; take a fresh snapshot when an action reports a stale ref.",
+    endpoint: { method: "POST", path: "/api/tools/browser/snapshot" },
+    parameters: {
+      type: "object",
+      properties: {
+        selector:         { type: "string",  description: "Limit the snapshot to a subtree (e.g. \"main\", \"#results\"). Use it on big pages." },
+        interactive_only: { type: "boolean", description: "Only controls — drop headings and page copy. Smallest output.", default: false },
+        max_nodes:        { type: "number",  description: "Node cap before truncation (default 400, max 1500).", default: 400 },
+      },
+    },
+    examples: [{}, { selector: "form" }, { interactive_only: true }],
   },
   {
     name: "browser_screenshot",
@@ -366,6 +402,7 @@ export const TOOL_DEFINITIONS = Object.freeze([
       type: "object",
       properties: {
         selector:    { type: "string",  description: "CSS selector of element to capture. Omit for full viewport/page." },
+        ref:         { type: "string",  description: "Snapshot ref (e.g. \"ref_12\") of the element to capture. Wins over selector." },
         full_page:   { type: "boolean", default: false },
         width:       { type: "number",  description: "Viewport width (capped at 1920)." },
         height:      { type: "number",  description: "Viewport height (capped at 1080)." },
@@ -379,57 +416,66 @@ export const TOOL_DEFINITIONS = Object.freeze([
   {
     name: "browser_click",
     category: "browser",
-    description: "Click a CSS selector on the current browser page.",
+    description: "Click an element on the current browser page. Prefer `ref` from browser_snapshot — a CSS selector guessed from HTML is what makes browsing brittle.",
     endpoint: { method: "POST", path: "/api/tools/browser/click" },
     parameters: {
       type: "object",
-      properties: { selector: { type: "string" } },
-      required: ["selector"],
+      properties: {
+        ref:      { type: "string",  description: "Snapshot ref (e.g. \"ref_12\"). Preferred." },
+        selector: { type: "string",  description: "CSS selector, when no snapshot ref applies." },
+        snapshot: { type: "boolean", description: "Return the accessibility snapshot after the click. Saves a round trip." },
+      },
     },
-    examples: [{ selector: "button#submit" }],
+    examples: [{ ref: "ref_12" }, { ref: "ref_12", snapshot: true }, { selector: "button#submit" }],
   },
   {
     name: "browser_type",
     category: "browser",
-    description: "Type text into a CSS selector. Uses focus + Ctrl+A + Backspace to clear, then types with realistic delay.",
+    description: "Type text into a field. Prefer `ref` from browser_snapshot. Uses focus + Ctrl+A + Backspace to clear, then types with realistic delay.",
     endpoint: { method: "POST", path: "/api/tools/browser/type" },
     parameters: {
       type: "object",
       properties: {
-        selector: { type: "string" },
-        text: { type: "string" },
-        clear: { type: "boolean", default: true },
+        ref:      { type: "string",  description: "Snapshot ref (e.g. \"ref_3\"). Preferred." },
+        selector: { type: "string",  description: "CSS selector, when no snapshot ref applies." },
+        text:     { type: "string" },
+        clear:    { type: "boolean", default: true },
+        snapshot: { type: "boolean", description: "Return the accessibility snapshot after typing." },
       },
-      required: ["selector", "text"],
+      required: ["text"],
     },
-    examples: [{ selector: "input#search", text: "hello world" }],
+    examples: [{ ref: "ref_3", text: "hello world" }, { selector: "input#search", text: "hello world" }],
   },
   {
     name: "browser_select",
     category: "browser",
-    description: "Choose an option in a <select> element by its value.",
+    description: "Choose an option in a <select> element by its value. Prefer `ref` from browser_snapshot.",
     endpoint: { method: "POST", path: "/api/tools/browser/select" },
     parameters: {
       type: "object",
       properties: {
-        selector: { type: "string" },
-        value: { type: "string" },
+        ref:      { type: "string",  description: "Snapshot ref of the <select>. Preferred." },
+        selector: { type: "string",  description: "CSS selector, when no snapshot ref applies." },
+        value:    { type: "string" },
+        snapshot: { type: "boolean", description: "Return the accessibility snapshot after selecting." },
       },
-      required: ["selector", "value"],
+      required: ["value"],
     },
-    examples: [{ selector: "select#country", value: "AR" }],
+    examples: [{ ref: "ref_7", value: "AR" }, { selector: "select#country", value: "AR" }],
   },
   {
     name: "browser_hover",
     category: "browser",
-    description: "Hover the cursor over an element (triggers tooltips, dropdowns, hover states).",
+    description: "Hover the cursor over an element (triggers tooltips, dropdowns, hover states). Prefer `ref` from browser_snapshot.",
     endpoint: { method: "POST", path: "/api/tools/browser/hover" },
     parameters: {
       type: "object",
-      properties: { selector: { type: "string" } },
-      required: ["selector"],
+      properties: {
+        ref:      { type: "string", description: "Snapshot ref. Preferred." },
+        selector: { type: "string", description: "CSS selector, when no snapshot ref applies." },
+      },
     },
-    examples: [{ selector: "nav .menu-item" }],
+    examples: [{ ref: "ref_5" }, { selector: "nav .menu-item" }],
   },
   {
     name: "browser_evaluate",
@@ -457,7 +503,7 @@ export const TOOL_DEFINITIONS = Object.freeze([
   {
     name: "browser_get_content",
     category: "browser",
-    description: "Return raw innerHTML of the page or a single element (truncated at 1MB).",
+    description: "Return raw innerHTML of the page or a single element (truncated at 1MB). Expensive — prefer browser_snapshot to find elements and browser_get_text to read copy; reach for raw HTML only when you need the markup itself.",
     endpoint: { method: "POST", path: "/api/tools/browser/get_content" },
     parameters: {
       type: "object",
@@ -548,4 +594,142 @@ export const TOOL_DEFINITIONS = Object.freeze([
     parameters: { type: "object", properties: {} },
     examples: [{}],
   },
+
+  // ── skills (native) ───────────────────────────────────────────────────────
+  {
+    name: "list_skills",
+    category: "skill",
+    description: "List available skills (slug + one-line description). Call load_skill to fetch a body.",
+    endpoint: null,
+    parameters: {
+      type: "object",
+      properties: {
+        project_path: { type: "string", description: "Optional project root to also scan .apc/skills" },
+      },
+    },
+    examples: [{}],
+  },
+  {
+    name: "load_skill",
+    category: "skill",
+    description: "Load the full body of a named skill into this turn.",
+    endpoint: null,
+    parameters: {
+      type: "object",
+      properties: {
+        slug: { type: "string", description: "Skill slug from list_skills" },
+        project_path: { type: "string" },
+      },
+      required: ["slug"],
+    },
+    examples: [{ slug: "apx-routine" }],
+  },
+
+  // ── telegram (native) ─────────────────────────────────────────────────────
+  {
+    name: "send_telegram",
+    category: "telegram",
+    description: "Send a Telegram message (text; optional photo/document). Dangerous — confirm or run under total.",
+    endpoint: null,
+    parameters: {
+      type: "object",
+      properties: {
+        text: { type: "string" },
+        chat_id: { type: "string" },
+      },
+      required: ["text"],
+    },
+    examples: [{ text: "Magui: listo el lote de ideas." }],
+  },
+
+  // ── asana (native plugin) ─────────────────────────────────────────────────
+  {
+    name: "asana_list_projects",
+    category: "integrations",
+    description: "List Asana projects visible to the configured token.",
+    endpoint: null,
+    parameters: { type: "object", properties: { project: { type: "string" } } },
+    examples: [{}],
+  },
+  {
+    name: "asana_list_tasks",
+    category: "integrations",
+    description: "List tasks in an Asana project.",
+    endpoint: null,
+    parameters: {
+      type: "object",
+      properties: {
+        project_gid: { type: "string" },
+        completed: { type: "boolean" },
+        project: { type: "string" },
+      },
+      required: ["project_gid"],
+    },
+    examples: [{ project_gid: "123" }],
+  },
+  {
+    name: "asana_create_task",
+    category: "integrations",
+    description: "Create a task in an Asana project.",
+    endpoint: null,
+    parameters: {
+      type: "object",
+      properties: {
+        project_gid: { type: "string" },
+        name: { type: "string" },
+        notes: { type: "string" },
+        project: { type: "string" },
+      },
+      required: ["project_gid", "name"],
+    },
+    examples: [{ project_gid: "123", name: "Reel agro" }],
+  },
+  {
+    name: "asana_update_task",
+    category: "integrations",
+    description: "Update an Asana task (name, notes, completed, section).",
+    endpoint: null,
+    parameters: {
+      type: "object",
+      properties: {
+        task_gid: { type: "string" },
+        name: { type: "string" },
+        completed: { type: "boolean" },
+        project: { type: "string" },
+      },
+      required: ["task_gid"],
+    },
+    examples: [{ task_gid: "456", completed: true }],
+  },
+]);
+
+// Tools a freshly created agent gets out of the box. Read/search the project,
+// keep its own memory, and look itself up in the org — everything with a side
+// effect (shell, write, browser, MCP, network) stays opt-in per agent.
+// One source of truth: the daemon applies these on create, and the web
+// preselects them so the create dialog needs no tool picker at all.
+export const DEFAULT_AGENT_TOOLS = Object.freeze([
+  "read_file",
+  "list_files",
+  "glob",
+  "grep",
+  "memory_get",
+  "memory_set",
+  "memory_append",
+  "memory_list",
+  "agent_list",
+  "agent_get",
+  "project_info",
+]);
+
+// Worker / editor agents (Magui and friends): the safe default PLUS write,
+// surgical edit, shell, and on-demand skills. Browser, HTTP, MCP, and
+// session tools stay opt-in. Asana / Telegram are extra per-agent.
+export const EDITOR_AGENT_TOOLS = Object.freeze([
+  ...DEFAULT_AGENT_TOOLS,
+  "write_file",
+  "edit_file",
+  "run_command",
+  "list_skills",
+  "load_skill",
 ]);

package/src/core/http-tools/grep.js

@@ -15,7 +15,19 @@ const execFileAsync = promisify(execFile);
 // ripgrep backend
 // ---------------------------------------------------------------------------
 
-async function grepWithRg({ pattern, searchPath, glob, caseSensitive, context = 0, limit }) {
+/**
+ * What to call a hit, relative to what was searched.
+ *
+ * `path.relative(searchPath, file)` is the answer for a directory search and
+ * the empty string when the search path IS the file — which is how a grep of
+ * one file reported its match against a file named "". A single file is still
+ * a file, so it gets its name.
+ */
+function fileLabel(searchPath, file, searchPathIsFile) {
+  return searchPathIsFile ? path.basename(file) : path.relative(searchPath, file);
+}
+
+async function grepWithRg({ pattern, searchPath, searchPathIsFile, glob, caseSensitive, context = 0, limit }) {
   const fullArgs = [
     "--json",
     "--max-filesize", "1M",
@@ -45,10 +57,20 @@ async function grepWithRg({ pattern, searchPath, glob, caseSensitive, context =
       const lineNum = obj.data?.line_number;
       const text = obj.data?.lines?.text?.replace(/\n$/, "") || "";
       const last = matches[matches.length - 1];
-      if (last && last.file === file) {
+      // Grouped on the ABSOLUTE path, which is what `file` holds. Comparing it
+      // to `last.file` — the RELATIVE label stored below — never matched, so
+      // every hit opened a new group and `files_with_matches` was really a
+      // second copy of `total_matches`: four hits in two files reported four
+      // files. rg emits a file's matches consecutively, so comparing against
+      // the last group is enough.
+      if (last && last.absolute === file) {
         last.matches.push({ line: lineNum, text });
       } else {
-        matches.push({ file: path.relative(searchPath, file), absolute: file, matches: [{ line: lineNum, text }] });
+        matches.push({
+          file: fileLabel(searchPath, file, searchPathIsFile),
+          absolute: file,
+          matches: [{ line: lineNum, text }],
+        });
       }
       if (matches.reduce((s, m) => s + m.matches.length, 0) >= limit) break;
     }
@@ -72,9 +94,28 @@ function globToRegex(g) {
   );
 }
 
+/**
+ * Every file under `dir` — or `dir` itself when it IS a file.
+ *
+ * That second case is not an edge: `grep(path: "work/marketing/magui/brain.md")`
+ * is how an agent reads one known file, and it is what ripgrep does without
+ * being asked. Here the walk began with `readdirSync` on the path, which throws
+ * ENOTDIR for a file; the catch below swallowed it, the queue emptied, and the
+ * search returned NO MATCHES — not an error, an empty answer, to a question
+ * about a file sitting right there with the word in it.
+ *
+ * It only ever happened without ripgrep installed, which is why it survived: a
+ * dev machine with `brew install ripgrep` never reaches this backend, and the
+ * CI runner reaches nothing else.
+ */
 function walkFiles(dir, { globPattern, dot = false, maxFiles = 2000 } = {}) {
   const globRe = globPattern ? globToRegex(globPattern) : null;
   const result = [];
+  try {
+    if (fs.statSync(dir).isFile()) return [dir];
+  } catch {
+    return result;
+  }
   const queue = [dir];
   while (queue.length && result.length < maxFiles) {
     const current = queue.shift();
@@ -93,7 +134,7 @@ function walkFiles(dir, { globPattern, dot = false, maxFiles = 2000 } = {}) {
   return result;
 }
 
-async function grepWithNode({ pattern, searchPath, glob, caseSensitive, context = 0, limit }) {
+async function grepWithNode({ pattern, searchPath, searchPathIsFile, glob, caseSensitive, context = 0, limit }) {
   const re = new RegExp(pattern, caseSensitive ? "" : "i");
   const files = walkFiles(searchPath, { globPattern: glob, dot: false });
   const matches = [];
@@ -121,7 +162,7 @@ async function grepWithNode({ pattern, searchPath, glob, caseSensitive, context
 
     if (fileMatches.length > 0) {
       matches.push({
-        file: path.relative(searchPath, file),
+        file: fileLabel(searchPath, file, searchPathIsFile),
         absolute: file,
         matches: fileMatches,
       });
@@ -144,8 +185,20 @@ export async function grepFiles({
   cwd,
 }) {
   if (!pattern) throw new Error("pattern required");
-  const basePath = path.resolve(searchPathArg || cwd || process.cwd());
-  if (!fs.existsSync(basePath)) throw new Error(`path does not exist: ${basePath}`);
+  // A relative `path` is relative TO `cwd` — the caller's project, when one was
+  // sent. It used to be `path.resolve(searchPathArg || cwd || …)`, where any
+  // path at all short-circuited `cwd` and the relative one then resolved against
+  // the DAEMON's own directory: an agent searching `work/marketing/…` in its
+  // project was answered "path does not exist" with the apx checkout prefixed to
+  // it. An absolute path is unaffected — path.resolve ignores the base then.
+  const basePath = path.resolve(cwd || process.cwd(), searchPathArg || ".");
+  // Answers "does it exist" and "is it one file" in a single stat, and both
+  // backends are told: searching ONE file is a normal thing to ask for, and
+  // each of them gets it wrong in its own way without being told. See
+  // walkFiles() and fileLabel().
+  let baseStat;
+  try { baseStat = fs.statSync(basePath); } catch { throw new Error(`path does not exist: ${basePath}`); }
+  const baseIsFile = baseStat.isFile();
 
   const lim = Math.min(parseInt(limit, 10) || 100, 1000);
   const ctx = Math.min(parseInt(context, 10) || 0, 10);
@@ -158,6 +211,7 @@ export async function grepFiles({
     result = await grepWithRg({
       pattern,
       searchPath: basePath,
+      searchPathIsFile: baseIsFile,
       glob,
       caseSensitive: !!case_sensitive,
       context: ctx,
@@ -167,6 +221,7 @@ export async function grepFiles({
     result = await grepWithNode({
       pattern,
       searchPath: basePath,
+      searchPathIsFile: baseIsFile,
       glob,
       caseSensitive: !!case_sensitive,
       context: ctx,

package/src/core/http-tools/registry.js

@@ -7,7 +7,7 @@
 //
 // The catalog itself lives in ./catalog.js and the in-process executors in
 // ./inline-handlers.js. This module only indexes and serves them.
-import { TOOL_DEFINITIONS } from "./catalog.js";
+import { TOOL_DEFINITIONS, DEFAULT_AGENT_TOOLS } from "./catalog.js";
 import { makeInlineHandlers } from "./inline-handlers.js";
 
 
@@ -22,6 +22,8 @@ function listTools() {
     name,
     description,
     category,
+    // Whether a new agent gets this tool by default (see DEFAULT_AGENT_TOOLS).
+    default_for_agents: DEFAULT_AGENT_TOOLS.includes(name),
     schema_url: `/api/tools/${name}`,
     endpoint_method: endpoint?.method || "inline",
     endpoint_path: endpoint?.path || null,

package/src/core/i18n/en.js

@@ -1,11 +1,42 @@
 // Backend strings — English (en). This is also the default fallback locale.
 export default {
-  "telegram.heads_up": "On it — working on that… 🛠️",
+  // Floors, not copy: the model writes the ack and the closing itself
+  // (core/agent/author-line.js); these go out only when it couldn't. The two
+  // `reply.*` ones are every surface's floor, not just Telegram's — see
+  // core/agent/closing-floor.js.
   "telegram.reset_ack": "Done, context cleared. Starting fresh. What do you need?",
-  "telegram.fallback_listo": "Done.",
-  "telegram.fallback_continue": "Made some headway. Want me to keep going?",
+  "reply.fallback_done": "Done.",
+  "reply.fallback_continue": "Made some headway. Want me to keep going?",
   // Host-emitted error floors (the model itself failed, so it can't author
   // these — they stay templated, but at least follow the user's language).
   "telegram.error_agent": "⚠️ The agent hit an error ({error}).",
   "telegram.error_generic": "⚠️ Couldn't reply right now ({error}).",
+  // Mobility — the buttons and one-line reminders the DAEMON sends while a trip
+  // is running (core/mobility/geofence.js). Host-emitted, not model-authored:
+  // a driver reads these at a glance, so they stay fixed and short.
+  "mobility.near": "You're near {place}, {distance} away.",
+  "mobility.near_bare": "You're {distance} away.",
+  "mobility.unit_m": "metres",
+  "mobility.unit_km": "kilometres",
+  "mobility.task": "Task",
+  "mobility.address": "Address",
+  // The native card's four answers, in the order they are offered. No emoji:
+  // Android Auto hands the card to Assistant, which reads it out loud.
+  "mobility.navigate": "Navigate now",
+  "mobility.add_stop": "Add to route",
+  "mobility.later": "Later",
+  "mobility.dismiss": "Not now",
+  "mobility.ack_dismissed": "Fine — nothing more about this one on this trip.",
+  "mobility.going": "I'll go",
+  "mobility.not_today": "Not today",
+  "mobility.alert_next": "Tell me at the next one",
+  "mobility.followup": "Did you make it to {place}?",
+  "mobility.done": "Done",
+  "mobility.still_open": "Not yet",
+  "mobility.ack_going": "Noted — you're going.",
+  "mobility.ack_skipped": "Fine, not today.",
+  "mobility.ack_next": "Fine, I'll tell you at the next one.",
+  "mobility.ack_done": "Closed the task.",
+  "mobility.ack_still_open": "Leaving it open.",
+  "mobility.transcript": "[Transcript]",
 };

package/src/core/i18n/es.js

@@ -1,13 +1,45 @@
 // Backend strings — Spanish (es). Keep this file flat dot-paths only; the
 // web admin has its own i18n tree.
 export default {
-  // Telegram channel
-  "telegram.heads_up": "Dale, estoy con eso… 🛠️",
+  // Pisos, no copy: el ack y los cierres los escribe el modelo
+  // (core/agent/author-line.js) y estos textos salen solo si no pudo. Los dos
+  // `reply.*` son el piso de TODAS las superficies, no solo el de Telegram —
+  // ver core/agent/closing-floor.js.
   "telegram.reset_ack": "Listo, contexto borrado. Arranco un hilo nuevo, ¿qué necesitás?",
-  "telegram.fallback_listo": "Listo.",
-  "telegram.fallback_continue": "Avancé con eso. ¿Querés que siga?",
+  "reply.fallback_done": "Listo.",
+  "reply.fallback_continue": "Avancé con eso. ¿Querés que siga?",
   // Pisos de error emitidos por el host (el modelo falló, no puede redactarlos
   // él mismo — quedan fijos, pero al menos respetan el idioma del usuario).
   "telegram.error_agent": "⚠️ El agente tuvo un error ({error}).",
   "telegram.error_generic": "⚠️ No pude responder ahora mismo ({error}).",
+  // Movilidad — los botones y recordatorios de una línea que manda el DAEMON
+  // durante un viaje (core/mobility/geofence.js). Los emite el host, no el
+  // modelo: se leen manejando, así que quedan fijos y cortos.
+  "mobility.near": "Estás cerca de {place}, a {distance}.",
+  // Sin lugar con nombre propio: el título ya lo dijo, así que la línea sólo
+  // aporta la distancia.
+  "mobility.near_bare": "Estás a {distance}.",
+  "mobility.unit_m": "metros",
+  "mobility.unit_km": "kilómetros",
+  "mobility.task": "Tarea",
+  "mobility.address": "Dirección",
+  // Las cuatro respuestas de la tarjeta nativa, en el orden en que se ofrecen.
+  // Sin emojis: Android Auto se las da al Assistant y las lee en voz alta.
+  "mobility.navigate": "Navegar ahora",
+  "mobility.add_stop": "Sumar a la ruta",
+  "mobility.later": "Para después",
+  "mobility.dismiss": "No ahora",
+  "mobility.ack_dismissed": "Listo, no te aviso más de esta en este viaje.",
+  "mobility.going": "Voy",
+  "mobility.not_today": "Hoy no",
+  "mobility.alert_next": "Avisar en la siguiente",
+  "mobility.followup": "¿Pasaste por {place}?",
+  "mobility.done": "Hecho",
+  "mobility.still_open": "Todavía no",
+  "mobility.ack_going": "Anotado: vas.",
+  "mobility.ack_skipped": "Listo, hoy no.",
+  "mobility.ack_next": "Listo, te aviso en la siguiente.",
+  "mobility.ack_done": "Cerré la tarea.",
+  "mobility.ack_still_open": "La dejo abierta.",
+  "mobility.transcript": "[Transcripción]",
 };

package/src/core/i18n/index.js

@@ -1,12 +1,12 @@
-// Backend i18n for daemon-side messages (Telegram heads-up, system replies,
-// any other user-facing string emitted from the host/core layer). The web
-// admin has its own dict tree under src/interfaces/web/src/i18n/ — that one
-// stays separate, this is for what the daemon sends back.
+// Backend i18n for daemon-side messages (command acks, error floors, any other
+// user-facing string emitted from the host/core layer). The web admin has its
+// own dict tree under src/interfaces/web/src/i18n/ — that one stays separate,
+// this is for what the daemon sends back.
 //
 // Usage:
 //   import { t, resolveLang } from "#core/i18n/index.js";
 //   const lang = resolveLang(globalConfig);
-//   await sendTelegram(t("telegram.heads_up", { lang }));
+//   await sendTelegram(t("telegram.reset_ack", { lang }));
 //
 // Adding a key: pick a clear dotted path, add it to every locale dict, and
 // the unit test in tests/i18n.test.js will assert parity (no missing

package/src/core/i18n/pt.js

@@ -1,11 +1,40 @@
 // Backend strings — Portuguese (pt).
 export default {
-  "telegram.heads_up": "Já estou nisso… 🛠️",
+  // Pisos, não copy: o ack e o fecho são escritos pelo modelo
+  // (core/agent/author-line.js); estes só saem quando ele não conseguiu. Os
+  // dois `reply.*` são o piso de todas as superfícies, não só o do Telegram —
+  // ver core/agent/closing-floor.js.
   "telegram.reset_ack": "Pronto, contexto limpo. Começando do zero — do que você precisa?",
-  "telegram.fallback_listo": "Pronto.",
-  "telegram.fallback_continue": "Avancei com isso. Quer que eu continue?",
+  "reply.fallback_done": "Pronto.",
+  "reply.fallback_continue": "Avancei com isso. Quer que eu continue?",
   // Pisos de erro emitidos pelo host (o modelo falhou, não pode redigi-los —
   // ficam fixos, mas ao menos seguem o idioma do usuário).
   "telegram.error_agent": "⚠️ O agente encontrou um erro ({error}).",
   "telegram.error_generic": "⚠️ Não consegui responder agora ({error}).",
+  // Mobilidade — os botões e lembretes de uma linha que o DAEMON envia durante
+  // uma viagem (core/mobility/geofence.js). Emitidos pelo host, não pelo
+  // modelo: são lidos dirigindo, então ficam fixos e curtos.
+  "mobility.near": "Você está perto de {place}, a {distance}.",
+  "mobility.near_bare": "Você está a {distance}.",
+  "mobility.unit_m": "metros",
+  "mobility.unit_km": "quilômetros",
+  "mobility.task": "Tarefa",
+  "mobility.address": "Endereço",
+  "mobility.navigate": "Navegar agora",
+  "mobility.add_stop": "Adicionar parada",
+  "mobility.later": "Mais tarde",
+  "mobility.dismiss": "Agora não",
+  "mobility.ack_dismissed": "Certo, não aviso mais sobre esta nesta viagem.",
+  "mobility.going": "Vou",
+  "mobility.not_today": "Hoje não",
+  "mobility.alert_next": "Avisar na próxima",
+  "mobility.followup": "Você passou em {place}?",
+  "mobility.done": "Feito",
+  "mobility.still_open": "Ainda não",
+  "mobility.ack_going": "Anotado: você vai.",
+  "mobility.ack_skipped": "Certo, hoje não.",
+  "mobility.ack_next": "Certo, aviso na próxima.",
+  "mobility.ack_done": "Fechei a tarefa.",
+  "mobility.ack_still_open": "Deixo em aberto.",
+  "mobility.transcript": "[Transcrição]",
 };

package/src/core/identity/self.js

@@ -20,7 +20,7 @@ export function readIdentity() {
 }
 
 // Resolve the super-agent's DISPLAY name (the persona shown to users). Order:
-// identity.json persona → legacy super_agent.name → "APX". This is the single
+// identity.json agent_name → super_agent.name → "APX". This is the single
 // source of truth for "what is the super-agent called"; callers must not read
 // super_agent.name directly. The stable id for storage is SUPERAGENT_ACTOR_ID.
 export function resolveAgentName(globalConfig = {}) {
@@ -32,6 +32,19 @@ export function resolveAgentName(globalConfig = {}) {
   );
 }
 
+// Shown when the owner has not told the agent their name. Neutral on purpose:
+// a name written into a shipped prompt is ONE install's owner introducing
+// himself in everybody else's.
+export const OWNER_DISPLAY_FALLBACK = "the owner";
+
+// Resolve the OWNER's display name — the person the super-agent works for —
+// from identity.json (`owner_name`, written by `set_identity`). Every prompt
+// that addresses the owner by name goes through here; none may hardcode one.
+export function resolveOwnerName() {
+  const identity = readIdentity();
+  return identity?.owner_name || OWNER_DISPLAY_FALLBACK;
+}
+
 export function writeIdentity(fields) {
   const existing = readIdentity() || {};
   const now = new Date().toISOString();