lampson 0.2.6 → 0.2.7

package/lib/tools/memo.syn

@@ -7,9 +7,22 @@
 -- El system prompt lleva SOLO el índice (nombre + primera línea de cada nota); el contenido entra al
 -- contexto cuando el agente llama `memory(read)`. Son archivos: el humano los lee/edita a mano y la
 -- UI web los muestra.
+--
+-- Cómo llega el proceso hasta ahí: el cwd del workspace es .lampson/ws/<slug>/, y `memory` es un link
+-- (junction/symlink) a <home>/memory. La capability file("memory/*") es léxica sobre ese link, así que ESTA
+-- tool es la única puerta: read/ls/grep/bash están confinadas a workspace/ y no ven la carpeta. Si el link
+-- está roto (destino inexistente), write_file falla con "No such file or directory": `available()` lo
+-- detecta, el prompt lo dice, y los errores de escritura explican qué hacer (correr `lampson` de nuevo
+-- repara los links — workspaces.ensure_link) en vez de dejar que el modelo improvise notas con bash.
 use "./common.syn" as c
 
 export let ROOT be "memory"
+let HOW_TO_FIX be "The memory folder is a link to Lampson's install (outside the project) and it is not reachable from this workspace — probably a broken link. Ask the user to run `lampson` again in this project (it repairs the links). Do NOT write notes with bash or inside the repo instead."
+
+-- ¿se puede llegar a la carpeta de memoria? (false = link roto o inexistente)
+export task available()
+    require file.read("memory")
+    give file_exists(ROOT)
 
 task valid_name(name)
     when name == nothing or name == ""
@@ -75,9 +88,16 @@ export task note_write(name, content)
     require file("memory/*")
     when not valid_name(name)
         raise("invalid note name '" + text(name) + "' (letters, digits, - or _)")
-    write_file(path(name), content)
+    save(name, content)
     give "saved memory/" + slug() + "/" + name + ".md (" + text(length(content)) + " chars)"
 
+-- escribe una nota; un fallo del sistema de archivos se explica (link roto) en vez de salir crudo
+task save(name, content)
+    try
+        write_file(path(name), content)
+    recover err
+        raise("cannot write " + path(name) + ": " + text(err) + ". " + HOW_TO_FIX)
+
 export task note_append(name, content)
     require env("LAMPSON_*")
     require file("memory")
@@ -90,7 +110,7 @@ export task note_append(name, content)
     recover err
         set prev to ""
     let joined be when prev == "" then content otherwise prev + "\n\n" + content
-    write_file(path(name), joined)
+    save(name, joined)
     give "appended to " + name + ".md (" + text(length(joined)) + " chars total)"
 
 export task note_clear(name)
@@ -99,7 +119,7 @@ export task note_clear(name)
     require file("memory/*")
     when not valid_name(name)
         raise("invalid note name")
-    write_file(path(name), "")
+    save(name, "")
     give "cleared " + name + ".md (the file stays empty; the user can delete it)"
 
 -- sección del system prompt
@@ -107,8 +127,10 @@ export task prompt_section()
     require env("LAMPSON_*")
     require file.read("memory")
     require file.read("memory/*")
+    let head be "\n\n# Project memory (your own notes about THIS project, in memory/" + slug() + "/ — a folder OUTSIDE the project, reachable ONLY through the memory tool: read/ls/grep/bash are confined to the workspace and will not find it. Read with memory(read), keep notes current with memory(write|append).)"
+    when not available()
+        give head + "\n(UNAVAILABLE right now: the memory folder is not reachable from this workspace — a broken link in Lampson's install. Do not look for it with ls/bash and do not write notes inside the repo; tell the user to run `lampson` again in this project to repair it.)"
     let items be list()
-    let head be "\n\n# Project memory (your own notes about THIS project, in memory/" + slug() + "/ — read with memory(read), keep them current with memory(write|append))"
     when length(items) == 0
         give head + "\n(empty — when you discover something non-obvious about this project: how to run/test it, gotchas, decisions, where things live — save it with memory(write). Keep notes short and factual.)"
     let lines be [head]
@@ -139,7 +161,7 @@ export task tool(action, name, content)
 
 export let SPEC be {
     "name": "memory",
-    "description": "Your persistent notes about THIS project, kept across sessions (Markdown files in Lampson's memory folder, never inside the repo). Use `write` to save non-obvious facts you discovered and will need again: how to run/build/test, environment quirks, architecture decisions, where things live, bugs and their causes, what the user prefers. `append` adds to an existing note, `read` loads one, `list` shows them, `delete` clears one. The system prompt shows the index of notes — read the relevant ones before repeating an investigation. Keep notes short, factual and current: update a note instead of writing a contradictory one.",
+    "description": "Your persistent notes about THIS project, kept across sessions (Markdown files in Lampson's memory folder: OUTSIDE the project and outside the reach of your other tools — read/ls/grep/bash are confined to the workspace, so this tool is the ONLY way to those notes; never keep notes with bash or inside the repo). Use `write` to save non-obvious facts you discovered and will need again: how to run/build/test, environment quirks, architecture decisions, where things live, bugs and their causes, what the user prefers. `append` adds to an existing note, `read` loads one, `list` shows them, `delete` clears one. The system prompt shows the index of notes — read the relevant ones before repeating an investigation. Keep notes short, factual and current: update a note instead of writing a contradictory one.",
     "parameters": {"type": "object", "properties": {
         "action": {"type": "string", "enum": ["list", "read", "write", "append", "delete"]},
         "name": {"type": "string", "description": "Note id: letters, digits, - or _ (e.g. how-to-run, db-schema, gotchas)"},

package/lib/tools.syn

@@ -25,7 +25,7 @@ use "./tools/memo.syn" as t_memo
 use "./tools/todo.syn" as t_todo
 use "./skills.syn" as skills
 use "./mcp.syn" as mcp
-use "./lamps.syn" as lamps
+use "./plugins.syn" as plugins
 use "./lsp.syn" as lsp
 use "./schedule.syn" as schedule
 
@@ -86,40 +86,40 @@ let MCP_SPEC be {
     }, "required": ["action"]}
 }
 
--- la task de la tool lamp (lamps.syn vive un nivel arriba de tools/, como mcp). enable/disable piden humano
+-- la task de la tool plugin (plugins.syn vive un nivel arriba de tools/, como mcp). enable/disable piden humano
 -- SIEMPRE (permission.syn): encender = autorizar código a correr con las capacidades de su manifiesto.
-task lamp_tool(action, name, manifest, files)
+task plugin_tool(action, name, manifest, files)
     require exec
     require time
     require env("LAMPSON_*")
     require file(".lampson")
     require file(".lampson/*")
-    require file.read("lamps")
-    require file.read("lamps/*")
+    require file.read("plugins")
+    require file.read("plugins/*")
     require file("workspace")
     require file("workspace/*")
     when action == "create"
-        give lamps.create(name, manifest, files)
+        give plugins.create(name, manifest, files)
     when action == "enable"
-        give lamps.set_enabled(name, true)
+        give plugins.set_enabled(name, true)
     when action == "disable"
-        give lamps.set_enabled(name, false)
-    let sm be lamps.summary()
+        give plugins.set_enabled(name, false)
+    let sm be plugins.summary()
     when length(sm) == 0
-        give "no lamps found. A lamp is a folder with a lamp.json manifest: " + lamps.GLOBAL_DIR + "/<name>/ (global) or " + lamps.PROJECT_DIR + "/<name>/ (this project; you can create it with write). See the lampson skill for the manifest format."
+        give "no plugins found. A plugin is a folder with a plugin.json manifest: " + plugins.GLOBAL_DIR + "/<name>/ (global) or " + plugins.PROJECT_DIR + "/<name>/ (this project; you can create it with write). See the lampson skill for the manifest format."
     let lines be []
     each l in sm
-        set lines to append(lines, l["name"] + " (" + l["scope"] + ", " + l["kind"] + ", " + (when l["enabled"] then "ON" otherwise "off") + "): " + (when l["error"] != nothing then "BROKEN — " + text(l["error"]) otherwise text(length(l["tools"])) + " tools [" + join(l["tools"], ", ") + "]" + (when l["description"] != "" then " — " + l["description"] otherwise "")))
+        set lines to append(lines, l["name"] + " (" + l["scope"] + ", " + l["kind"] + ", " + (when l["enabled"] then "ON" otherwise "off") + "): " + (when l["error"] != nothing then "BROKEN — " + text(l["error"]) otherwise text(length(l["tools"])) + " tools [" + join(l["tools"], ", ") + "]" + (when l["description"] != "" then " — " + l["description"] otherwise "")) + (when l["legacy"] then " [" + plugins.LEGACY_HINT + "]" otherwise ""))
     give join(lines, "\n")
 
-let LAMP_SPEC be {
-    "name": "lamp",
-    "description": "Lamps are tool plugins you can build for this project: a folder with a lamp.json manifest plus code — a Synsema program (kind=syn) run under a capability ceiling, or any executable (kind=exec). Consider one when a task needs a reusable custom tool (a project-specific query, generator, checker) that plain bash would repeat clumsily. action=list (default): every lamp found, on/off, its tools. action=create: write a PROJECT lamp (name + manifest + files) — it validates the manifest and runs `synsema check` on a syn entry, but does NOT run or enable it. action=enable / disable: turn one on or off — ALWAYS asks the user (enabling authorizes its code to run with the manifest's capabilities). An enabled lamp's tools appear in your catalog as lamp_<lamp>_<tool> from the NEXT turn. Manifest: {\"description\", \"kind\": \"syn\"|\"exec\", \"entry\": \"lamp.syn\" (syn) | \"command\": \"python lamp.py\" (exec), \"caps\": \"file.read=workspace/*\" (syn, optional extra ceiling over stdout,time,env=LAMP_*), \"timeout\": 60, \"tools\": [{\"name\", \"description\", \"parameters\": JSON Schema, \"readonly\": bool}]}. Inside the code read LAMP_TOOL and LAMP_ARGS (JSON) from env and print the result to stdout (a .syn needs `require env(\"LAMP_*\")`). Lamp names: letters, digits, - (no _).",
+let PLUGIN_SPEC be {
+    "name": "plugin",
+    "description": "Plugins are tools you can build for this project (they were called 'lamps' until 0.2.6; the user may still say lamp/lámpara): a folder with a plugin.json manifest plus code — a Synsema program (kind=syn) run under a capability ceiling, or any executable (kind=exec, any language, no ceiling). Consider one when a task needs a reusable custom tool (a project-specific query, generator, checker) that plain bash would repeat clumsily. action=list (default): every plugin found, on/off, its tools. action=create: write a PROJECT plugin (name + manifest + files) — it validates the manifest and runs `synsema check` on a syn entry, but does NOT run or enable it. action=enable / disable: turn one on or off — ALWAYS asks the user (enabling authorizes its code to run with the manifest's capabilities). An enabled plugin's tools appear in your catalog as plugin_<plugin>_<tool> from the NEXT turn. Manifest: {\"description\", \"kind\": \"syn\"|\"exec\", \"entry\": \"plugin.syn\" (syn) | \"command\": \"python plugin.py\" (exec), \"caps\": \"file.read=workspace/*\" (syn, optional extra ceiling over stdout,time,env=PLUGIN_*), \"timeout\": 60, \"tools\": [{\"name\", \"description\", \"parameters\": JSON Schema, \"readonly\": bool}]}. Inside the code read PLUGIN_TOOL and PLUGIN_ARGS (JSON) from env and print the result to stdout (a .syn needs `require env(\"PLUGIN_*\")`). Plugin names: letters, digits, - (no _). Not the same as a lamp from lamps.sh (a portable, ceiling-enforced capability unit for any MCP agent): those are installed with `lamp add` and reach you as MCP tools via `lamp mcp`.",
     "parameters": {"type": "object", "properties": {
         "action": {"type": "string", "enum": ["list", "create", "enable", "disable"], "description": "Default: list"},
-        "name": {"type": "string", "description": "create/enable/disable: lamp name"},
-        "manifest": {"type": "object", "description": "create only: the lamp.json content (name is filled in)"},
-        "files": {"type": "object", "description": "create only: {\"lamp.syn\": \"<code>\", …} — files written into the lamp folder", "additionalProperties": {"type": "string"}}
+        "name": {"type": "string", "description": "create/enable/disable: plugin name"},
+        "manifest": {"type": "object", "description": "create only: the plugin.json content (name is filled in)"},
+        "files": {"type": "object", "description": "create only: {\"plugin.syn\": \"<code>\", …} — files written into the plugin folder", "additionalProperties": {"type": "string"}}
     }, "required": ["action"]}
 }
 
@@ -158,8 +158,8 @@ let LSP_SPEC be {
 
 -- la tool schedule (lib/schedule.syn): tareas programadas. add/remove/enable/run piden humano SIEMPRE (permission.syn):
 -- crear una tarea = autorizar de una vez todo lo que va a hacer sin nadie mirando. Las corridas las hace el daemon
--- (web.syn); desde acá solo se corren en el acto las lamp/bash (una prompt anidaría un loop dentro del turno).
-task schedule_tool(action, id, name, at, kind, lamp, tool, args, command, prompt, agent, permission, approval_timeout, notify)
+-- (web.syn); desde acá solo se corren en el acto las plugin/bash (una prompt anidaría un loop dentro del turno).
+task schedule_tool(action, id, name, at, kind, plugin, tool, args, command, prompt, agent, permission, approval_timeout, notify)
     require exec
     require time
     require net
@@ -167,15 +167,15 @@ task schedule_tool(action, id, name, at, kind, lamp, tool, args, command, prompt
     require env("OS")
     require file(".lampson")
     require file(".lampson/*")
-    require file.read("lamps")
-    require file.read("lamps/*")
+    require file.read("plugins")
+    require file.read("plugins/*")
     require file("workspace")
     require file("workspace/*")
     let act be when action == nothing then "list" otherwise action
     when act == "add"
         let a be {"type": kind}
-        when kind == "lamp"
-            set a to {"type": "lamp", "lamp": lamp, "tool": tool, "args": when args == nothing then {} otherwise args}
+        when kind == "plugin"
+            set a to {"type": "plugin", "plugin": plugin, "tool": tool, "args": when args == nothing then {} otherwise args}
         otherwise when kind == "bash"
             set a to {"type": "bash", "command": command}
         otherwise when kind == "prompt"
@@ -227,16 +227,16 @@ task daemon_note()
 
 let SCHEDULE_SPEC be {
     "name": "schedule",
-    "description": "Scheduled tasks: run something on a schedule with nobody watching — a lamp tool, a fixed shell command, or a full agent run from a prompt (kind=prompt: the agent works unattended with the chosen profile and writes a report; its session appears as ⏰ <name>). `at` formats — recurring: 'every 6h' | 'every 30m' | 'daily 09:00' | 'mon,wed 08:30' | 'weekdays 09:00'; ONE-TIME (runs once, then turns itself off): 'today 15:14' | 'tomorrow 09:00' | 'once 2026-08-29 15:14' | 'in 2h'. Times are the USER'S LOCAL time (the machine's timezone): write the hour exactly as the user says it — NEVER convert to UTC. Tasks belong to the current workspace. permission = what a prompt run may do without asking: strict (dangerous actions denied), ask (default: a dangerous action sends the user an approval link/notification and waits up to approval_timeout seconds, denied if unanswered), yolo (allowed). notify = optional webhook URL that receives the result as JSON (for 'search and send me' tasks). action=add ALWAYS asks the user (it authorizes future unattended runs); remove/enable/disable/run also ask; list and log do not. The tasks are executed by Lampson's resident process (`lampson --daemon start` or the open web UI) — say so if the list shows no scheduler running. Use it when the user says 'every day at', 'each N hours', 'on Mondays', 'periodically', 'remind me', 'send me'.",
+    "description": "Scheduled tasks: run something on a schedule with nobody watching — a plugin tool, a fixed shell command, or a full agent run from a prompt (kind=prompt: the agent works unattended with the chosen profile and writes a report; its session appears as ⏰ <name>). `at` formats — recurring: 'every 6h' | 'every 30m' | 'daily 09:00' | 'mon,wed 08:30' | 'weekdays 09:00'; ONE-TIME (runs once, then turns itself off): 'today 15:14' | 'tomorrow 09:00' | 'once 2026-08-29 15:14' | 'in 2h'. Times are the USER'S LOCAL time (the machine's timezone): write the hour exactly as the user says it — NEVER convert to UTC. Tasks belong to the current workspace. permission = what a prompt run may do without asking: strict (dangerous actions denied), ask (default: a dangerous action sends the user an approval link/notification and waits up to approval_timeout seconds, denied if unanswered), yolo (allowed). notify = optional webhook URL that receives the result as JSON (for 'search and send me' tasks). action=add ALWAYS asks the user (it authorizes future unattended runs); remove/enable/disable/run also ask; list and log do not. The tasks are executed by Lampson's resident process (`lampson --daemon start` or the open web UI) — say so if the list shows no scheduler running. Use it when the user says 'every day at', 'each N hours', 'on Mondays', 'periodically', 'remind me', 'send me'.",
     "parameters": {"type": "object", "properties": {
         "action": {"type": "string", "enum": ["list", "add", "remove", "enable", "disable", "run", "log"], "description": "Default: list"},
         "id": {"type": "string", "description": "remove/enable/disable/run/log: the task id (from list)"},
         "name": {"type": "string", "description": "add: short human name"},
         "at": {"type": "string", "description": "add: the schedule — 'every 6h' | 'daily 09:00' | 'mon,wed 08:30' | 'weekdays 09:00'"},
-        "kind": {"type": "string", "enum": ["lamp", "bash", "prompt"], "description": "add: what runs"},
-        "lamp": {"type": "string", "description": "add kind=lamp: lamp name (must be ON)"},
-        "tool": {"type": "string", "description": "add kind=lamp: tool of that lamp"},
-        "args": {"type": "object", "description": "add kind=lamp: arguments for the tool"},
+        "kind": {"type": "string", "enum": ["plugin", "bash", "prompt"], "description": "add: what runs"},
+        "plugin": {"type": "string", "description": "add kind=plugin: plugin name (must be ON)"},
+        "tool": {"type": "string", "description": "add kind=plugin: tool of that plugin"},
+        "args": {"type": "object", "description": "add kind=plugin: arguments for the tool"},
         "command": {"type": "string", "description": "add kind=bash: the shell command (must finish on its own; no servers)"},
         "prompt": {"type": "string", "description": "add kind=prompt: self-contained instructions for the unattended agent run (what to do, how to verify, what to report)"},
         "agent": {"type": "string", "enum": ["build", "plan", "review", "explore"], "description": "add kind=prompt: profile (default build)"},
@@ -261,12 +261,12 @@ export task registry()
         "todo": t_todo.tool,
         "skill": skill_tool,
         "mcp": mcp_tool,
-        "lamp": lamp_tool,
+        "plugin": plugin_tool,
         "lsp": lsp_tool,
         "schedule": schedule_tool
     }
 
-export let CATALOG be [t_read.SPEC, t_write.SPEC, t_edit.SPEC, t_ls.SPEC, t_find.SPEC, t_grep.SPEC, LSP_SPEC, t_bash.SPEC, t_process.SPEC, t_memo.SPEC, t_todo.SPEC, t_skill.SPEC, MCP_SPEC, LAMP_SPEC, SCHEDULE_SPEC]
+export let CATALOG be [t_read.SPEC, t_write.SPEC, t_edit.SPEC, t_ls.SPEC, t_find.SPEC, t_grep.SPEC, LSP_SPEC, t_bash.SPEC, t_process.SPEC, t_memo.SPEC, t_todo.SPEC, t_skill.SPEC, MCP_SPEC, PLUGIN_SPEC, SCHEDULE_SPEC]
 
 -- Subconjuntos (para perfiles de agente): registry/catálogo filtrados por nombre.
 export task registry_subset(names)

package/lib/workspaces.syn

@@ -3,7 +3,7 @@
 -- Por qué así (ver ../SPEC-WORKSPACES.md): en Synsema las capabilities de archivo Y los `use "./lib/…"` se resuelven
 -- relativos al CWD del proceso, y `proxy to` es estático (se evalúa al arrancar y anexa el path entero). Entonces:
 --   * cada workspace tiene su propio directorio  .lampson/ws/<slug>/  que ES el cwd de su proceso:
---       workspace → junction al proyecto        lib public skills lamps memory → junctions a la instalación
+--       workspace → junction al proyecto        lib public skills plugins memory → junctions a la instalación
 --       web.syn chat.syn → copias (refrescadas al arrancar)        .lampson/ → estado propio (sesiones, tareas…)
 --       .lampson/global → junction a <home>/.lampson (config.json con keys, mcp/lsp globales, skills-*)
 --     con eso `file("workspace/*")`, `use "./lib/x.syn"` y todo el código de siempre funcionan SIN cambios.
@@ -26,7 +26,7 @@ export let HUB_FILE be "hub.syn"
 export let HUB_TEMPLATE be "hub.tpl.syn"
 -- rango alto para no chocar con lo que usan las apps (3000, 5173, 8000, 8080-8090…): solo el hub queda en 8080
 let FIRST_PORT be 47101
-let LINKS be ["lib", "public", "skills", "lamps", "memory"]
+let LINKS be ["lib", "public", "skills", "plugins", "memory"]
 let COPIES be ["web.syn", "chat.syn"]
 
 task is_win()
@@ -182,6 +182,31 @@ task unlink(where_)
 task is_link_dir(p)
     give file_exists(p)
 
+-- crea una carpeta de la instalación (ruta absoluta: fuera del alcance de write_file, así que por exec)
+task ensure_dir(p)
+    when is_win()
+        -- argumentos separados, como mklink: una línea entera con comillas dentro de `cmd /c` se rompe al citarla.
+        -- mkdir de cmd crea los intermedios y falla (sin daño) si ya existe.
+        run("cmd", ["/c", "mkdir", replace_text(p, "/", "\\")], 10)
+    otherwise
+        run("mkdir", ["-p", p], 10)
+    give true
+
+-- un link a la instalación (lib, public, skills, plugins, memory): se crea si falta y se REHACE si quedó colgante.
+-- file_exists da false tanto si no hay nada como si el link apunta a un destino que no existe (npm no trae
+-- memory/ ni plugins/; un `ln -s` a una carpeta inexistente nace roto y después memory(write) muere con
+-- "No such file or directory" — visto en un VPS el 2026-09-02). Por eso: destino primero, link después, y si
+-- sigue sin resolverse es un error del workspace, no un silencio.
+export task ensure_link(where_, target)
+    when file_exists(where_)
+        give true
+    unlink(where_)
+    ensure_dir(target)
+    link(where_, target)
+    when not file_exists(where_)
+        raise("could not link " + where_ + " → " + target + " (the workspace needs it: memory, plugins and the code live there)")
+    give true
+
 -- crea/repara .lampson/ws/<slug>: junctions al proyecto y a la instalación, copias de los entries
 export task prepare(w)
     require exec
@@ -209,16 +234,14 @@ export task prepare(w)
         when not link(ws_link, w["path"])
             raise("could not link " + ws_link + " → " + w["path"])
     each n in LINKS
-        when not file_exists(d + "/" + n)
-            link(d + "/" + n, h + sep + n)
-    when not file_exists(d + "/.lampson/global")
-        link(d + "/.lampson/global", h + sep + ".lampson")
+        ensure_link(d + "/" + n, h + sep + n)
+    ensure_link(d + "/.lampson/global", h + sep + ".lampson")
     each f in COPIES
         write_file(d + "/" + f, read_file(f))
     give d
 
 -- estado guardado ANTES de los workspaces (en <home>/.lampson, separado por slug en cada registro): sesiones y trazas
--- del proyecto, sus tareas programadas y el encendido de lámparas se mueven a <ws>/.lampson la primera vez
+-- del proyecto, sus tareas programadas y el encendido de plugins se mueven a <ws>/.lampson la primera vez
 task migrate(w, d)
     let slug be w["slug"]
     let moved be 0
@@ -248,8 +271,10 @@ task migrate(w, d)
     recover err
         set moved to moved
     try
-        when file_exists(".lampson/lamps.json")
-            write_file(d + "/.lampson/lamps.json", read_file(".lampson/lamps.json"))
+        when file_exists(".lampson/plugins.json")
+            write_file(d + "/.lampson/plugins.json", read_file(".lampson/plugins.json"))
+        otherwise when file_exists(".lampson/lamps.json")
+            write_file(d + "/.lampson/plugins.json", read_file(".lampson/lamps.json"))
     recover err
         set moved to moved
     give moved

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "lampson",
-  "version": "0.2.6",
-  "description": "A coding agent written in Synsema: terminal + web, tools confined to the mounted project, lamps (your own tool plugins), LSP, MCP, sub-agents.",
+  "version": "0.2.7",
+  "description": "A coding agent written in Synsema: terminal + web, tools confined to the mounted project, plugins (your own tools, any language), LSP, MCP, sub-agents.",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -18,7 +18,7 @@
     "lib/",
     "public/",
     "skills/",
-    "lamps/",
+    "plugins/",
     "chat.syn",
     "web.syn",
     "hub.tpl.syn",

package/{lamps/example-hello/lamp.json → plugins/example-hello/plugin.json}

@@ -1,8 +1,8 @@
 {
   "name": "example-hello",
-  "description": "Example lamp: a Synsema program run under a capability ceiling. Copy this folder to make your own.",
+  "description": "Example plugin: a Synsema program run under a capability ceiling. Copy this folder to make your own.",
   "kind": "syn",
-  "entry": "lamp.syn",
+  "entry": "plugin.syn",
   "caps": "",
   "timeout": 20,
   "tools": [

package/plugins/example-hello/plugin.syn

@@ -0,0 +1,19 @@
+-- plugins/example-hello/plugin.syn — el plugin de ejemplo
+--
+-- Lampson lo corre así por cada llamada: synsema run --cap-set stdout,time,env=PLUGIN_*,env=LAMP_* plugin.syn
+-- El techo (--cap-set) sale del manifiesto (plugin.json → "caps") que el humano aprobó al encenderlo;
+-- pedir más acá (p. ej. `require net`) falla con "above the host ceiling".
+-- Entrada por env: PLUGIN_TOOL (qué tool), PLUGIN_ARGS (sus args en JSON), PLUGIN_DIR, PLUGIN_WORKSPACE.
+-- Salida: lo que imprimas por stdout vuelve al modelo como resultado de la tool.
+intent: "example plugin for lampson: greet"
+
+require env("PLUGIN_*")
+
+let tool be env("PLUGIN_TOOL", "")
+let args be json_decode(env("PLUGIN_ARGS", "{}"))
+
+when tool == "greet"
+    let who be when contains(args, "who") then text(args["who"]) otherwise "world"
+    print("hello, " + who + "! (from the example-hello plugin, running under a capability ceiling)")
+otherwise
+    print("ERROR: unknown tool '" + tool + "'")

package/public/css/panel.css

@@ -1,6 +1,6 @@
 /* panel: EL componente modal de la app (js/panel.js). Un cascarón (overlay, cabecera, ✕/Esc/clic afuera) y
    tres layouts: browse (buscador + lista + detalle), tabs (pestañas con formularios) y form (un formulario).
-   Cada vista (sesiones, lámparas, configuración, programar…) solo aporta su contenido; nada de esto se repite. */
+   Cada vista (sesiones, plugins, configuración, programar…) solo aporta su contenido; nada de esto se repite. */
 .modal { position:fixed; inset:0; background:rgba(0,0,0,.45); display:flex; align-items:center; justify-content:center; z-index:50; }
 .panel { background:var(--paper); border:1px solid var(--rule-2); border-radius:var(--r); box-shadow:0 10px 30px rgba(0,0,0,.35); display:flex; flex-direction:column; min-height:0; max-height:92vh; }
 .panel.lg { width:min(1100px, 94vw); height:min(760px, 90vh); padding:14px 18px 12px; }
@@ -94,11 +94,11 @@
 .panel .dfoot .del.ask .yes { color:var(--rubric); cursor:pointer; font-weight:600; }
 .panel .dfoot .del.ask .no { cursor:pointer; }
 .panel .none { color:var(--ink-3); font:400 13px/1.6 var(--serif); max-width:520px; }
-/* switch encendido/apagado (lámparas) */
+/* switch encendido/apagado (plugins) */
 .panel label.sw { display:inline-flex; align-items:center; margin:0 0 0 auto; gap:6px; cursor:pointer; user-select:none; font:400 11.5px/1 var(--mono); text-transform:none; letter-spacing:0; color:var(--ink-3); }
 .panel label.sw input { flex:none; width:16px; height:16px; padding:0; margin:0; accent-color:var(--accent); }
 .panel label.sw.on { color:var(--accent); }
-/* formulario generado desde un JSON Schema (tools de una lámpara) */
+/* formulario generado desde un JSON Schema (tools de un plugin) */
 .panel .tool { border:1px solid var(--rule); border-radius:var(--r); padding:10px 12px; margin-bottom:10px; }
 .panel .tool .th { display:grid; grid-template-columns:auto 1fr auto; gap:8px 10px; align-items:baseline; }
 .panel .tool .th code { font-weight:600; color:var(--ink); }

package/public/hub.html

@@ -25,7 +25,7 @@
     <div class="empty">
       <p class="eyebrow">workspaces</p>
       <h1>¿En qué proyecto trabajamos?</h1>
-      <p class="lead">Cada workspace es una carpeta de tu disco con su propio agente: sesiones, tareas programadas, lámparas, MCP. Corren en procesos separados, así podés tener varios abiertos a la vez. Los que tienen tareas encendidas siguen vivos aunque cierres todo.</p>
+      <p class="lead">Cada workspace es una carpeta de tu disco con su propio agente: sesiones, tareas programadas, plugins, MCP. Corren en procesos separados, así podés tener varios abiertos a la vez. Los que tienen tareas encendidas siguen vivos aunque cierres todo.</p>
       <div class="wsgrid" id="wsGrid"></div>
       <p class="lead" style="margin-top:22px">Desde una terminal: <code>cd mi-proyecto &amp;&amp; lampson</code> (terminal) o <code>lampson --web</code> (esta web, en ese workspace).</p>
     </div>

package/public/index.html

@@ -33,7 +33,7 @@
     <select id="agent" title="perfil de agente: qué tools puede usar"></select>
     <select id="perm" title="qué pasa con un comando peligroso (rm -rf, git push --force, sudo…)"><option value="ask">permisos: preguntar</option><option value="yolo">permisos: permitir todo</option><option value="strict">permisos: denegar</option></select>
     <span class="pill on" id="wsPill" style="display:none" title="cambiar de workspace">workspace ▾</span>
-    <span class="pill" id="lamps" title="lámparas: plugins de tools que vos encendés · clic para ver y activar">lámparas</span>
+    <span class="pill" id="plugins" title="plugins: tools propias que vos encendés · clic para ver y activar">plugins</span>
     <span class="pill" id="model" title="proveedor y modelo · clic para cambiarlos o cargar una API key">…</span>
   </div>
 </header>
@@ -77,7 +77,7 @@
     <div class="body" id="apprBox"></div>
   </section>
   <section class="sec" data-sec="sched">
-    <h2 title="tareas programadas (cada 6 h, todos los días a las 9, lunes 8:30…): una lámpara, un comando o una corrida del agente. Corren mientras lampson esté abierto, o con lampson --daemon start"><span class="caret">▸</span>Programadas<span class="cnt" id="schedCount"></span><button class="h2act" id="schedAddBtn" title="programar una tarea">+</button></h2>
+    <h2 title="tareas programadas (cada 6 h, todos los días a las 9, lunes 8:30…): un plugin, un comando o una corrida del agente. Corren mientras lampson esté abierto, o con lampson --daemon start"><span class="caret">▸</span>Programadas<span class="cnt" id="schedCount"></span><button class="h2act" id="schedAddBtn" title="programar una tarea">+</button></h2>
     <div class="body" id="schedBox"></div>
   </section>
 </aside>
@@ -119,7 +119,7 @@
 <script src="/js/todo.js"></script>
 <script src="/js/mcp.js"></script>
 <script src="/js/lsp.js"></script>
-<script src="/js/lamps.js"></script>
+<script src="/js/plugins.js"></script>
 <script src="/js/schedules.js"></script>
 <script src="/js/approvals.js"></script>
 <script src="/js/config.js"></script>

package/public/js/app.js

@@ -14,7 +14,7 @@ async function loadCfg() {
   sel.onchange = () => { localStorage.setItem('lampson.agent', sel.value); hint(); }; hint();
   if (!log.children.length) empty();
 }
-loadCfg().then(() => { loadTree(); loadSessions(); loadProcs(); loadMemory(); loadAgents(); loadMcp(); loadLsp(); loadLamps(); loadTodo(); loadSched(); loadApprovals(); checkUpdate(); const pq = new URLSearchParams(location.search).get('proc'); if (pq) openProc(pq); else if (session) openSession(session); });
+loadCfg().then(() => { loadTree(); loadSessions(); loadProcs(); loadMemory(); loadAgents(); loadMcp(); loadLsp(); loadPlugins(); loadTodo(); loadSched(); loadApprovals(); checkUpdate(); const pq = new URLSearchParams(location.search).get('proc'); if (pq) openProc(pq); else if (session) openSession(session); });
 // respaldos lentos por si el stream de eventos se cae
 setInterval(loadProcs, events ? 60000 : 10000);
 setInterval(() => { loadSched(); if (!events) loadApprovals(); }, events ? 60000 : 15000);

package/public/js/chat.js

@@ -69,13 +69,13 @@ function handle(chunk, thinking) {
   const k = ev.kind, d = ev.data;
   if (k === 'session') { const changed = d !== session; session = d; localStorage.setItem('lampson.session', d); if (changed) loadTodo(); }
   else if (k === 'assistant') add('assistant', md(d));
-  else if (k === 'tool_call') { thinking.querySelector('span:last-child').textContent = 'ejecutando ' + esc(d.name) + '…'; pending = add('step', `<span class="ic">⚙</span>${cmdHtml(describe(d))}`); wireMore(pending); if (d.name === 'process') setTimeout(loadProcs, 2500); if (d.name === 'delegate') { setTimeout(loadAgents, 800); setTimeout(loadAgents, 4000); } if (d.name === 'todo') setTimeout(loadTodo, 300); if (d.name === 'lamp') setTimeout(loadLamps, 300); if (d.name === 'lsp') setTimeout(loadLsp, 1500); }
+  else if (k === 'tool_call') { thinking.querySelector('span:last-child').textContent = 'ejecutando ' + esc(d.name) + '…'; pending = add('step', `<span class="ic">⚙</span>${cmdHtml(describe(d))}`); wireMore(pending); if (d.name === 'process') setTimeout(loadProcs, 2500); if (d.name === 'delegate') { setTimeout(loadAgents, 800); setTimeout(loadAgents, 4000); } if (d.name === 'todo') setTimeout(loadTodo, 300); if (d.name === 'plugin') setTimeout(loadPlugins, 300); if (d.name === 'lsp') setTimeout(loadLsp, 1500); }
   else if (k === 'inbox') { add('meta', '✉ ' + esc(String(d).split('\n')[0].slice(0, 160))); loadAgents(); }
   else if (k === 'tool_result') { const out = String(d.output); const bad = /^(ERROR|DENIED)/.test(out);
-    if (!bad && d.call && /^(write|edit|bash|process|delegate|lamp|skill)$/.test(d.call.name)) treeChanged();
+    if (!bad && d.call && /^(write|edit|bash|process|delegate|plugin|skill)$/.test(d.call.name)) treeChanged();
     if (d.call && d.call.name === 'schedule') { setTimeout(loadSched, 300); if (/^scheduled '/.test(out)) setSec('sched', true); }
-    // lámpara recién creada: avisar en el chat con un acceso directo al switch (el modelo no sabe cómo se enciende en esta UI)
-    if (d.call && d.call.name === 'lamp' && /^lamp '([^']+)' created/.test(out)) { const nm = out.match(/^lamp '([^']+)' created/)[1]; const m = add('meta', `☼ lámpara <b>${esc(nm)}</b> creada — está apagada: <a href="#" class="lampgo">encenderla en «lámparas»</a>`); m.querySelector('.lampgo').onclick = (ev) => { ev.preventDefault(); openLamps(nm); }; $('#lamps').classList.add('new'); setTimeout(() => $('#lamps').classList.remove('new'), 4000); }
+    // plugin recién creado: avisar en el chat con un acceso directo al switch (el modelo no sabe cómo se enciende en esta UI)
+    if (d.call && d.call.name === 'plugin' && /^plugin '([^']+)' created/.test(out)) { const nm = out.match(/^plugin '([^']+)' created/)[1]; const m = add('meta', `☼ plugin <b>${esc(nm)}</b> creado — está apagado: <a href="#" class="plugingo">encenderlo en «plugins»</a>`); m.querySelector('.plugingo').onclick = (ev) => { ev.preventDefault(); openPlugins(nm); }; $('#plugins').classList.add('new'); setTimeout(() => $('#plugins').classList.remove('new'), 4000); }
     const el = pending || add('step', '<span class="ic">→</span>'); pending = null; thinking.querySelector('span:last-child').textContent = 'pensando…'; const ic = el.querySelector('.ic'); if (ic) { ic.textContent = bad ? '✗' : '✓'; ic.className = 'ic ' + (bad ? 'bad' : 'ok'); } el.insertAdjacentHTML('beforeend', resultHtml(out, bad)); }
   else if (k === 'approval_request') { const el = add('approval', `<div class="card"><div class="why">⚠ ${esc(d.why)}</div><code>${esc(describe({name: d.name, args: d.args}))}</code><div class="btns"><button class="primary" data-ok="1">Permitir</button><button data-ok="0">Denegar</button></div></div>`); el.querySelectorAll('button').forEach(b => b.onclick = async () => { el.querySelectorAll('button').forEach(x => x.disabled = true); await api(BASE + '/api/approve', { id: d.id, decision: b.dataset.ok === '1' }); }); el.dataset.id = d.id; }
   else if (k === 'approval_result') { const el = [...log.querySelectorAll('.approval')].find(x => x.dataset.id === d.id); if (el) el.querySelector('.btns').innerHTML = d.approved ? '<span style="color:var(--str)">✓ permitido</span>' : (d.timeout ? '<span class="denied">✗ sin respuesta, denegado</span>' : '<span class="denied">✗ denegado</span>'); }

package/public/js/memory.js

@@ -4,7 +4,8 @@ async function loadMemory() {
   let r; try { r = await (await fetch(BASE + '/api/memory')).json(); } catch (e) { return; }
   const box = $('#memory'); box.innerHTML = '';
   const notes = r.notes || [];
-  $('#memCount').textContent = notes.length || ''; autoSec('memory', notes.length > 0);
+  $('#memCount').textContent = notes.length || ''; autoSec('memory', notes.length > 0 || r.ok === false);
+  if (r.ok === false) { box.innerHTML = '<div class="m none" title="el enlace memory/ del workspace no resuelve: volvé a correr lampson en este proyecto para repararlo">⚠ carpeta de memoria no accesible — corré <code>lampson</code> de nuevo en este proyecto</div>'; return; }
   if (!notes.length) { box.innerHTML = '<div class="m none">sin notas todavía</div>'; return; }
   for (const n of notes) { const d = document.createElement('div'); d.className = 'm' + (memOpen === n.name ? ' active' : ''); d.title = n.title; d.innerHTML = `<b>${esc(n.name)}</b><span class="t">${esc(n.title)}</span>`; d.onclick = () => openMemory(n.name); box.appendChild(d); }
 }