@letta-ai/letta-code 0.33.7 → 0.33.8

package/letta.js

@@ -5648,7 +5648,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@letta-ai/letta-code",
-    version: "0.33.7",
+    version: "0.33.8",
     lettaStartupLogProtocol: 1,
     description: "Letta Code is a CLI tool for interacting with stateful Letta agents from the terminal.",
     type: "module",
@@ -90892,7 +90892,7 @@ var init_context = __esm(() => {
 });
 
 // src/constants.ts
-var DEFAULT_SUMMARIZATION_MODEL = "letta/auto", DEFAULT_TITLE_SUMMARIZATION_MODEL = "openai/gpt-5.6-luna", DEFAULT_AGENT_NAME = "Letta Code", INTERRUPTED_BY_USER = "Interrupted by user", TURN_DID_NOT_COMPLETE = "Turn did not complete", SYSTEM_REMINDER_TAG = "system-reminder", SYSTEM_REMINDER_OPEN, SYSTEM_REMINDER_CLOSE, SYSTEM_ALERT_TAG = "system-alert", SYSTEM_ALERT_OPEN, SYSTEM_ALERT_CLOSE, COMPACTION_SUMMARY_HEADER = "(Earlier messages in this conversation have been compacted to free up context, summarized below)", TOKEN_DISPLAY_THRESHOLD = 100, ELAPSED_DISPLAY_THRESHOLD_MS;
+var DEFAULT_SUMMARIZATION_MODEL = "letta/auto", DEFAULT_TITLE_SUMMARIZATION_MODEL = "openai/gpt-6-luna", DEFAULT_AGENT_NAME = "Letta Code", INTERRUPTED_BY_USER = "Interrupted by user", TURN_DID_NOT_COMPLETE = "Turn did not complete", SYSTEM_REMINDER_TAG = "system-reminder", SYSTEM_REMINDER_OPEN, SYSTEM_REMINDER_CLOSE, SYSTEM_ALERT_TAG = "system-alert", SYSTEM_ALERT_OPEN, SYSTEM_ALERT_CLOSE, COMPACTION_SUMMARY_HEADER = "(Earlier messages in this conversation have been compacted to free up context, summarized below)", TOKEN_DISPLAY_THRESHOLD = 100, ELAPSED_DISPLAY_THRESHOLD_MS;
 var init_constants2 = __esm(() => {
   SYSTEM_REMINDER_OPEN = `<${SYSTEM_REMINDER_TAG}>`;
   SYSTEM_REMINDER_CLOSE = `</${SYSTEM_REMINDER_TAG}>`;
@@ -107158,27 +107158,63 @@ function parseOllamaTags(data) {
     };
   }).filter((entry) => entry !== undefined);
 }
-function parseOllamaRunningContexts(data) {
-  const contexts = new Map;
+function ollamaIdentityKeys(id2) {
+  const normalized = normalizeOllamaModelId(id2);
+  return normalized === id2 ? [id2] : [id2, normalized];
+}
+function parseOllamaPsEntries(data) {
   if (!data || typeof data !== "object")
-    return contexts;
+    return [];
   const models3 = data.models;
   if (!Array.isArray(models3))
-    return contexts;
+    return [];
+  const entries = [];
   for (const entry of models3) {
     if (!entry || typeof entry !== "object")
       continue;
     const record4 = entry;
-    const id2 = record4.name ?? record4.model;
-    const contextLength = record4.context_length;
-    if (typeof id2 !== "string" || id2.length === 0)
+    const rawIds = [record4.name, record4.model].filter((id2) => typeof id2 === "string" && id2.length > 0);
+    if (rawIds.length === 0)
       continue;
-    if (typeof contextLength !== "number" || contextLength <= 0)
+    const contextLength = record4.context_length;
+    entries.push({
+      ids: [...new Set(rawIds.flatMap(ollamaIdentityKeys))],
+      displayId: rawIds[0],
+      ...typeof contextLength === "number" && contextLength > 0 ? { contextLength } : {}
+    });
+  }
+  return entries;
+}
+function parseOllamaRunningContexts(data) {
+  const contexts = new Map;
+  for (const entry of parseOllamaPsEntries(data)) {
+    if (entry.contextLength === undefined)
       continue;
-    contexts.set(id2, contextLength);
+    for (const id2 of entry.ids)
+      contexts.set(id2, entry.contextLength);
   }
   return contexts;
 }
+function readOllamaServedContextOverride(env4) {
+  const raw = env4[OLLAMA_SERVED_CONTEXT_OVERRIDE_ENV];
+  if (raw === undefined || raw.trim() === "")
+    return;
+  const trimmed = raw.trim();
+  if (!/^[1-9]\d*$/.test(trimmed) || !Number.isSafeInteger(Number(trimmed))) {
+    throw new Error(`${OLLAMA_SERVED_CONTEXT_OVERRIDE_ENV}=${JSON.stringify(trimmed)} is not a positive integer token count. ` + `Set it to the context window your Ollama daemon actually serves.`);
+  }
+  return Number(trimmed);
+}
+function missingServedContextError(modelId, data) {
+  const entries = parseOllamaPsEntries(data);
+  const match2 = entries.find((entry) => entry.ids.includes(modelId));
+  if (match2) {
+    return `Ollama lists "${modelId}" in /api/ps but did not report context_length. ` + `Refusing to send the prompt because Ollama may silently truncate it. ` + `context_length requires Ollama 0.10.0 or newer. ` + `Upgrade Ollama, or set ${OLLAMA_SERVED_CONTEXT_OVERRIDE_ENV} to the window your daemon actually serves.`;
+  }
+  const running = entries.map((entry) => entry.displayId).filter((id2) => id2 !== undefined);
+  const runningNote = running.length > 0 ? ` Running models: ${running.join(", ")}.` : ` /api/ps lists no running models.`;
+  return `Ollama loaded "${modelId}", but /api/ps does not list it. ` + `Refusing to send the prompt because Ollama may silently truncate it. ` + `If OLLAMA_KEEP_ALIVE=0, the model unloaded before this check.` + runningNote + ` Set ${OLLAMA_SERVED_CONTEXT_OVERRIDE_ENV} to the window your daemon actually serves.`;
+}
 async function fetchOllamaNative(fetchImpl, url, options) {
   const controller = new AbortController;
   const timeout = setTimeout(() => controller.abort(), options.timeoutMs);
@@ -107210,42 +107246,49 @@ async function fetchOllamaNative(fetchImpl, url, options) {
   }
 }
 async function resolveOllamaServedContext(options) {
+  const override = readOllamaServedContextOverride(options.env ?? process.env);
+  if (override !== undefined)
+    return override;
   const fetchImpl = options.fetchImpl ?? fetch;
   const modelId = normalizeOllamaModelId(options.modelId);
   const nativeBaseURL = localEndpointNativeBaseURL(options.baseURL);
   const psURL = `${nativeBaseURL}/api/ps`;
-  const runningContext = async () => {
-    const data = await fetchOllamaNative(fetchImpl, psURL, {
-      ...options.apiKey ? { apiKey: options.apiKey } : {},
-      ...options.signal ? { signal: options.signal } : {},
-      timeoutMs: OLLAMA_STATUS_TIMEOUT_MS,
-      consume: (response) => response.json()
-    });
-    return parseOllamaRunningContexts(data).get(modelId);
-  };
+  const overrideHint = `or set ${OLLAMA_SERVED_CONTEXT_OVERRIDE_ENV} to the window your daemon actually serves`;
   try {
     await fetchOllamaNative(fetchImpl, `${nativeBaseURL}/api/generate`, {
       ...options.apiKey ? { apiKey: options.apiKey } : {},
       ...options.signal ? { signal: options.signal } : {},
-      body: { model: modelId, prompt: "", stream: false },
+      body: {
+        model: modelId,
+        prompt: "",
+        stream: false,
+        keep_alive: OLLAMA_PREFLIGHT_KEEP_ALIVE
+      },
       timeoutMs: OLLAMA_MODEL_LOAD_TIMEOUT_MS,
       consume: (response) => response.text()
     });
   } catch (error4) {
     if (options.signal?.aborted)
       throw options.signal.reason ?? error4;
-    throw new Error(`Unable to load Ollama model "${modelId}" to determine its served context window. ` + `Refusing to send the prompt because Ollama may silently truncate it. ` + `Check the Ollama endpoint, model installation, and available memory. (${error4 instanceof Error ? error4.message : String(error4)})`);
+    throw new Error(`Unable to load Ollama model "${modelId}" to determine its served context window. ` + `Refusing to send the prompt because Ollama may silently truncate it. ` + `Check the Ollama endpoint, model installation, and available memory, ${overrideHint}. (${error4 instanceof Error ? error4.message : String(error4)})`);
   }
+  let running;
   try {
-    const loadedContext = await runningContext();
-    if (loadedContext !== undefined)
-      return loadedContext;
+    running = await fetchOllamaNative(fetchImpl, psURL, {
+      ...options.apiKey ? { apiKey: options.apiKey } : {},
+      ...options.signal ? { signal: options.signal } : {},
+      timeoutMs: OLLAMA_STATUS_TIMEOUT_MS,
+      consume: (response) => response.json()
+    });
   } catch (error4) {
     if (options.signal?.aborted)
       throw options.signal.reason ?? error4;
-    throw new Error(`Ollama loaded model "${modelId}", but /api/ps could not verify its served context window. ` + `Refusing to send the prompt because Ollama may silently truncate it. ` + `Check that the endpoint supports /api/ps. (${error4 instanceof Error ? error4.message : String(error4)})`);
+    throw new Error(`Ollama loaded model "${modelId}", but /api/ps could not verify its served context window. ` + `Refusing to send the prompt because Ollama may silently truncate it. ` + `Check that the endpoint supports /api/ps, ${overrideHint}. (${error4 instanceof Error ? error4.message : String(error4)})`);
   }
-  throw new Error(`Ollama did not report an exact served context window for loaded model "${modelId}" in /api/ps. ` + `Refusing to send the prompt because Ollama may silently truncate it. ` + `Check the model name and Ollama server logs.`);
+  const loadedContext = parseOllamaRunningContexts(running).get(modelId);
+  if (loadedContext !== undefined)
+    return loadedContext;
+  throw new Error(missingServedContextError(modelId, running));
 }
 function parseOllamaShow(modelId, data, runtimeContextLength) {
   if (!data || typeof data !== "object")
@@ -107275,7 +107318,7 @@ function createOllamaPiProvider(options) {
     discover: ollamaDiscover
   });
 }
-var OLLAMA_PI_PROVIDER_ID = "ollama", OLLAMA_CLOUD_PI_PROVIDER_ID = "ollama-cloud", OLLAMA_STATUS_TIMEOUT_MS = 2000, OLLAMA_MODEL_LOAD_TIMEOUT_MS = 120000, ollamaDiscover = async (context3) => {
+var OLLAMA_PI_PROVIDER_ID = "ollama", OLLAMA_CLOUD_PI_PROVIDER_ID = "ollama-cloud", OLLAMA_STATUS_TIMEOUT_MS = 2000, OLLAMA_MODEL_LOAD_TIMEOUT_MS = 120000, OLLAMA_PREFLIGHT_KEEP_ALIVE = "5m", OLLAMA_SERVED_CONTEXT_OVERRIDE_ENV = "LETTA_OLLAMA_CONTEXT_LENGTH", ollamaDiscover = async (context3) => {
   const tags = await context3.fetchJson(`${context3.nativeBaseURL}/api/tags`);
   const entries = parseOllamaTags(tags);
   const runtimeContexts = await context3.fetchJson(`${context3.nativeBaseURL}/api/ps`).then(parseOllamaRunningContexts).catch(() => new Map);
@@ -188517,6 +188560,12 @@ var init_manager = __esm(() => {
       label: "diffs",
       description: "Open browser-based worktree diff previews powered by Diffs from Pierre."
     },
+    {
+      id: "memory_palace",
+      label: "memory palace",
+      description: "Opt-in memory palace experiment flag for disposable local listener runs. Disabled by default; no behavior changes unless consumers gate on it.",
+      envVar: "LETTA_MEMORY_PALACE"
+    },
     {
       id: "reflection_arena",
       label: "reflection arena",
@@ -198050,6 +198099,7 @@ var init_protocol_inbound = __esm(() => {
   EXPERIMENT_IDS = new Set([
     "conversation_titles",
     "desktop_conversation_bootstrap",
+    "memory_palace",
     "tui_cron"
   ]);
 });
@@ -213145,7 +213195,7 @@ class CodexAppServerClient {
     await this.request("initialize", {
       clientInfo: {
         name: "letta-code",
-        version: "0.33.7"
+        version: "0.33.8"
       },
       capabilities: null
     });
@@ -218304,6 +218354,7 @@ __export(exports_skills2, {
   getBundledSkills: () => getBundledSkills,
   getAgentSkillsDir: () => getAgentSkillsDir,
   formatSkillsAsSystemReminder: () => formatSkillsAsSystemReminder,
+  enabledSkillExperiments: () => enabledSkillExperiments,
   discoverSkills: () => discoverSkills,
   compareSkills: () => compareSkills,
   SKILLS_DIR: () => SKILLS_DIR,
@@ -218359,7 +218410,14 @@ function isModelInvocableSkill(skill) {
 function isUserInvocableSkill(skill) {
   return skill.userInvocable !== false;
 }
+function enabledSkillExperiments() {
+  return [...new Set(EXPERIMENT_BUNDLED_SKILLS.values())].filter((id2) => experimentManager.isEnabled(id2)).sort().join(",");
+}
 function isSkillAvailableForAgent(skill, agentId) {
+  const experiment = skill.source === "bundled" ? EXPERIMENT_BUNDLED_SKILLS.get(skill.id) : undefined;
+  if (experiment && !experimentManager.isEnabled(experiment)) {
+    return false;
+  }
   if (skill.source === "bundled" && agentId && isLocalAgentId(agentId) && LOCAL_AGENT_EXCLUDED_BUNDLED_SKILLS.has(skill.id)) {
     return false;
   }
@@ -218423,7 +218481,7 @@ async function discoverSkills(projectSkillsPath = join61(process.cwd(), SKILLS_D
     }
   }
   return {
-    skills: Array.from(skillsById.values()).sort(compareSkills),
+    skills: Array.from(skillsById.values()).filter((skill) => isSkillAvailableForAgent(skill, agentId)).sort(compareSkills),
     errors: allErrors
   };
 }
@@ -218531,14 +218589,18 @@ ${lines.join(`
 `)}
 </system-reminder>`;
 }
-var LOCAL_AGENT_EXCLUDED_BUNDLED_SKILLS, PROJECT_SKILLS_DIR, SKILLS_DIR = ".skills", GLOBAL_SKILLS_DIR;
+var LOCAL_AGENT_EXCLUDED_BUNDLED_SKILLS, EXPERIMENT_BUNDLED_SKILLS, PROJECT_SKILLS_DIR, SKILLS_DIR = ".skills", GLOBAL_SKILLS_DIR;
 var init_skills5 = __esm(() => {
+  init_manager();
   init_skill_sources();
   LOCAL_AGENT_EXCLUDED_BUNDLED_SKILLS = new Set([
     "image-generation",
     "managing-shared-memory",
     "working-across-computers"
   ]);
+  EXPERIMENT_BUNDLED_SKILLS = new Map([
+    ["curating-memory-palace", "memory_palace"]
+  ]);
   PROJECT_SKILLS_DIR = join61(".agents", "skills");
   GLOBAL_SKILLS_DIR = join61(process.env.HOME || process.env.USERPROFILE || "~", ".letta/skills");
 });
@@ -228048,7 +228110,8 @@ function computeCacheKey(components) {
     components.primaryProjectSkillsDirectory,
     [...components.memorySkillsDirs].sort().join(","),
     [...components.sharedMemorySkillsDirs].sort().join(","),
-    components.sharedMemoryErrors.map((error4) => `${error4.path}:${error4.message}`).sort().join(",")
+    components.sharedMemoryErrors.map((error4) => `${error4.path}:${error4.message}`).sort().join(","),
+    components.skillExperiments
   ].join("|");
 }
 function getSkillRoots(components) {
@@ -228341,7 +228404,8 @@ async function buildClientSkillsPayload(options = {}) {
     primaryProjectSkillsDirectory,
     memorySkillsDirs,
     sharedMemorySkillsDirs: sharedMemoryContext.skillsDirs,
-    sharedMemoryErrors: sharedMemoryContext.errors
+    sharedMemoryErrors: sharedMemoryContext.errors,
+    skillExperiments: enabledSkillExperiments()
   };
   const cacheKey = computeCacheKey(cacheComponents);
   if (useCache) {
@@ -412478,12 +412542,12 @@ function rowToolCalls(row, index, diagnostics2) {
   }
   return calls;
 }
-function contentText3(content) {
+function contentText2(content) {
   if (typeof content === "string") {
     if (content.startsWith(CONTENT_JSON_PREFIX)) {
       const encoded = content.slice(CONTENT_JSON_PREFIX.length);
       try {
-        return contentText3(JSON.parse(encoded));
+        return contentText2(JSON.parse(encoded));
       } catch {
         return encoded;
       }
@@ -412569,7 +412633,7 @@ var init_hermes = __esm(() => {
           });
         };
         if (row.role === "user") {
-          const content = contentText3(row.content);
+          const content = contentText2(row.content);
           if (content) {
             emit({
               type: "message",
@@ -412589,7 +412653,7 @@ var init_hermes = __esm(() => {
               ...timestamp ? { timestamp } : {}
             });
           }
-          const content = contentText3(row.content);
+          const content = contentText2(row.content);
           if (content) {
             emit({
               type: "message",
@@ -412612,7 +412676,7 @@ var init_hermes = __esm(() => {
         if (row.role === "tool") {
           emit({
             type: "tool_result",
-            content: contentText3(row.content),
+            content: contentText2(row.content),
             ...typeof row.tool_call_id === "string" && row.tool_call_id ? { callId: row.tool_call_id } : {},
             ...timestamp ? { timestamp } : {}
           });
@@ -445266,7 +445330,7 @@ function createTransport2(config2, options) {
     return new StreamableHTTPClientTransport(new URL(config2.url), {
       requestInit: headersRequestInit(headers),
       authProvider: options.oauth?.authProvider,
-      fetch: abortAwareFetch(options.signal)
+      fetch: abortAwareFetch(options.signal, undefined, options.fetch)
     });
   }
   if (config2.transport === "sse") {
@@ -445275,7 +445339,7 @@ function createTransport2(config2, options) {
     return new SSEClientTransport(new URL(config2.url), {
       requestInit,
       authProvider: options.oauth?.authProvider,
-      fetch: abortAwareFetch(options.signal, headers)
+      fetch: abortAwareFetch(options.signal, headers, options.fetch)
     });
   }
   return new StdioClientTransport({
@@ -445286,13 +445350,14 @@ function createTransport2(config2, options) {
     stderr: options.stderr ?? "inherit"
   });
 }
-function abortAwareFetch(operationSignal2, headers) {
+function abortAwareFetch(operationSignal2, headers, fetchFn) {
   if (!operationSignal2 && !headers)
-    return;
+    return fetchFn;
+  const request = fetchFn ?? fetch;
   return (url2, init) => {
     const requestInit = headers ? mergeHeaders4(init, headers) : { ...init };
     const requestSignal3 = requestInit.signal ?? undefined;
-    return fetch(url2, {
+    return request(url2, {
       ...requestInit,
       signal: operationSignal2 && requestSignal3 ? AbortSignal.any([operationSignal2, requestSignal3]) : operationSignal2 ?? requestSignal3
     });
@@ -445344,7 +445409,7 @@ var init_mcp_client = __esm(() => {
   init_streamableHttp();
   DEFAULT_CLIENT_INFO = {
     name: "letta-code",
-    version: "0.33.7"
+    version: "0.33.8"
   };
 });
 
@@ -513196,4 +513261,4 @@ function registerBunOAuthFlows() {
 registerBunOAuthFlows();
 await init_src5().then(() => exports_src2);
 
-//# debugId=3195287CCD45D3B564756E2164756E21
+//# debugId=7B5F416253AF257964756E2164756E21

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@letta-ai/letta-code",
-  "version": "0.33.7",
+  "version": "0.33.8",
   "lettaStartupLogProtocol": 1,
   "description": "Letta Code is a CLI tool for interacting with stateful Letta agents from the terminal.",
   "type": "module",

package/skills/curating-memory-palace/SKILL.md

@@ -0,0 +1,105 @@
+---
+name: curating-memory-palace
+description: Curates the Memory Palace, a one-page view in palace/ where the user reviews and acts on agent state. Use whenever you have something the user should review in one place, such as tasks, suggested improvements, open questions, follow-ups, blockers, or changes in your understanding; during reflection; when asked to set up or update the Palace; and when handling a Palace action or reply.
+---
+
+# Curating the Memory Palace
+
+Treat the Memory Palace as a command center for state: make your ongoing understanding, commitments, and possibilities legible to the user, and let them influence it through actions and replies. Desktop shows it on the Palace tab of the Memory page.
+
+Choose contents that fit the agent and its relationship with the user. A companion might share relational understanding, shared interests, or unresolved questions. A work agent might surface pending work, proactively identified issues, or tasks it can resume. Neither is the universal template.
+
+Show meaningful current state, not a transcript recap or a page about maintaining the Palace itself. Keep it concise without forcing everything into a task list.
+
+## When to write to it
+
+The Palace is where you put things for the user to review. Update it as you go, not only when asked:
+
+- **During work:** when you notice a task, an improvement you could make, a question only the user can answer, a blocker, or a follow-up, add it to the right section. Mention it in the conversation too if it matters now.
+- **During reflection:** check the Palace against what happened. Add new items, update changed ones, and remove items that are done, stale, or dismissed.
+- **When the user asks** to set up or update the Palace: set up means build a first Palace from what you already know; update means bring every section current.
+- **After a Palace action or reply:** update the section it came from.
+
+Skip it for things that only matter inside the current conversation.
+
+## Files
+
+The Palace is the `palace/` folder in your memory.
+
+- Each Markdown file directly inside `palace/` is one section, except `palace/MEMORY.md`. Nested folders and other files are not shown.
+- The section title comes from the file name: `needs-attention.md` shows as "Needs Attention". Pick file names that read well as titles, and keep `name` the same as the title.
+- Frontmatter holds exactly `name` and `description`, like every memory file. MemFS rejects any other key. The description shows under the title, so write it as the section's purpose in one short line.
+- The body is Markdown. The date beside the title is the file's last commit.
+
+Example `palace/needs-attention.md`:
+
+````markdown
+---
+name: Needs Attention
+description: Decisions and follow-ups that need the user.
+---
+**The staging deploy is blocked on a secret.** `SLACK_SIGNING_SECRET` is not in 1Password yet, so the Atlantis plan fails.
+
+```palace-action
+{"actionId": "add-secret", "label": "Walk me through adding it", "instruction": "List the exact 1Password and Terraform steps"}
+```
+````
+
+## Order
+
+`palace/MEMORY.md` is the folder's index, and it sets the order. List the sections in the order you want them shown. Relative links such as `[Overview](overview.md)` work, and so do `./overview.md` and `palace/overview.md`. The first mention of a file decides its place. Sections you leave out come after, in file-name order.
+
+Like every `MEMORY.md`, it has no frontmatter:
+
+```markdown
+# Memory Palace
+
+State worth understanding, discussing, or acting on. Choose sections for this user; these are examples, not required categories.
+
+- [Needs Attention](needs-attention.md) - Decisions and follow-ups that need the user
+- [Suggestions](suggestions.md) - Next steps worth taking
+- [Recently Learned](recently-learned.md) - What changed in my understanding
+- [Overview](overview.md) - Who I am and what I am working on
+```
+
+## Icons
+
+Each section gets an icon picked from its title. Titles with "attention" or "blocker" get a flag, "overview" or "summary" a house, "learned" or "insight" a lightbulb, and "suggestions" or "next steps" a bolt. Other titles get a note icon.
+
+## Action buttons
+
+A `palace-action` code block becomes a button. It holds one strict JSON object:
+
+```palace-action
+{"actionId": "review-pr", "label": "Review the PR", "conversationId": "new", "instruction": "Review PR 123 and list the blocking issues"}
+```
+
+- `actionId` (required): 1 to 64 characters, no spaces. Unique within the section.
+- `label` (required): the button text, up to 80 characters. Start it with a verb.
+- `instruction` (optional): what you should do when it is clicked, up to 300 characters.
+- `conversationId` (optional): one of your conversation ids, or `new` for a fresh conversation. Leave it out to use the main chat.
+
+Any other key, or invalid JSON, shows the block as code with an error instead of a button. Action blocks next to each other share one row.
+
+When the user clicks a button, Desktop opens the target conversation and sends you one message. A hidden system reminder in it names the action, the section's path, and the section's current content. Do what the label and instruction ask, in that conversation.
+
+## Replies
+
+Every section has a Reply button. The user's note arrives in the main chat, or in the conversation named by the section's first action. A hidden system reminder in the message holds the section's path and content. Treat the note as feedback on that section:
+
+- **Dismissal** ("drop this", "I don't care about X"): remove that item from the file. If the section is then empty, say so in one line, such as "Nothing needs you right now.", or delete the file and its index line. Don't bring the item back unless something important changes. Note the preference in memory so later updates don't add it again.
+- **Correction**: fix the section.
+- **Question**: answer in the conversation, and update the section if the answer changes it.
+
+Then reply briefly with what you changed.
+
+## Writing a good Palace
+
+- Let sections reflect what matters in this relationship. Do not fill a fixed template or invent content to reach a section count.
+- Lead with the point and enough context to understand it. Prefer short sections; use headlines where they help scanning.
+- Keep state current. Remove stale items and empty categories unless their absence is itself useful information.
+- Distinguish what the user told you, what you infer, and what you propose. Do not present interpretations as facts or possible work as already underway.
+- Make continuation offers concrete: name the unfinished work and the next step, not just "I can continue."
+- Add a button only for a useful, specific action. Understanding or correcting your state can be the whole purpose of a section; Reply is enough.
+- Never put secrets, tokens, or keys in the Palace. It is shown in the app and sent in messages.
+- Don't repeat an item in two sections.