pi-note 0.23.0 → 0.25.0

package/README.md

@@ -10,6 +10,9 @@ The extension and Python app share a repository but install separately.
 For server-provided UI instead of this Pinote-specific extension, see the opt-in
 [native MCP UI alternative](mcp/README.md). It uses a generic gateway host and has
 explicit initial-version limits; it is not activated by installing this extension.
+MCP users can separately enable the [optional Ctrl+D exit companion](mcp/README.md#optional-ctrld-exit-confirmation).
+It ships as `exit-confirm.ts` but is not loaded by default; do not load `index.ts`
+alongside MCP.
 
 ## Install
 

package/dist-mcp/icons/external-link.txt

@@ -0,0 +1 @@
+↗

package/dist-mcp/icons/open-app.txt

@@ -0,0 +1 @@
+▤

package/dist-mcp/mcp/server.js

@@ -10,13 +10,17 @@ import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { CallToolRequestSchema, ListToolsRequestSchema, ListResourcesRequestSchema, ReadResourceRequestSchema, McpError } from '@modelcontextprotocol/sdk/types.js';
 import { z } from 'zod';
+import { truncateToWidth, visibleWidth } from '@earendil-works/pi-tui';
+import { stripVTControlCharacters } from 'node:util';
 import { defaultFooterField, defaultHandoffPrompt, defaultNewSessionPrompt, effectiveFooterFields, parseFooterConfig, parseHandoffPrompt, parseNewSessionPrompt, readFooterDocument, saveFooterConfig } from "../footer-config.js";
 const URI = 'pinote://ui';
 const MIME = 'application/vnd.mcp-native-ui+json';
 const CONTEXT = 'native-ui/context';
 const exec = promisify(execFile);
 const noteCommand = process.env.PINOTE_NOTE_COMMAND || 'note';
-const icons = Object.fromEntries(['add', 'check', 'cross', 'note'].map((name) => [name, readFileSync(new URL(`../icons/${name}.txt`, import.meta.url), 'utf8').trim()]));
+const dataHome = process.env.XDG_DATA_HOME;
+const database = join(dataHome && isAbsolute(dataHome) ? dataHome : join(homedir(), '.local/share'), 'pinote/notes.db');
+const icons = Object.fromEntries(['add', 'check', 'cross', 'note', 'open-app', 'external-link'].map((name) => [name, readFileSync(new URL(`../icons/${name}.txt`, import.meta.url), 'utf8').trim()]));
 const Proposal = z.object({ id: z.string().uuid(), text: z.string().min(1).max(4000), tag: z.string().trim().min(1).max(64).optional() }).strict();
 const Context = z.object({ conversationId: z.string().min(1).max(256), contextId: z.string().min(1).max(256).optional(), state: z.object({
         proposal: Proposal.nullable().optional(),
@@ -27,7 +31,7 @@ const Action = z.object({ method: z.literal('native-ui/action'), params: z.objec
         uri: z.literal(URI), revision: z.string().min(1).max(256), action: z.string().min(1).max(256),
         value: z.union([z.string().max(20_000), z.number().finite(), z.boolean(), z.null()]).optional(), _meta: z.record(z.unknown()).optional(),
     }) });
-const server = new Server({ name: 'pinote', version: '0.23.0' }, { capabilities: { tools: {}, resources: {}, experimental: { 'native-ui-v1': {} } } });
+const server = new Server({ name: 'pinote', version: '0.25.0' }, { capabilities: { tools: {}, resources: {}, experimental: { 'native-ui-v1': {} } } });
 // Serialize complete read/check/write cycles even when a host sends parallel calls.
 let queue = Promise.resolve();
 function serial(run) {
@@ -139,6 +143,7 @@ function secondaryActions(meta) {
 }
 function footerFeatures(meta) {
     return {
+        footerNativeActions: z.object({ footerNativeActions: z.literal(true) }).safeParse(meta?.['native-ui/features']).success,
         footerStyles: z.object({ footerStyles: z.literal(true) }).safeParse(meta?.['native-ui/features']).success,
         footerDoubleActions: z.object({ footerDoubleActions: z.literal(true) }).safeParse(meta?.['native-ui/features']).success,
     };
@@ -153,10 +158,10 @@ function view(data, scoped = false, secondary = false, features = {}) {
     // Footer actions remain valid on every screen, including Settings.
     if (task) {
         action('preview', 'Preview full task', { description: 'Display only; never sent to the model' });
-        action('done', 'Complete task', { icon: icons.check });
+        action('done', 'Complete task', { icon: icons.check, ...(features.footerNativeActions ? { description: 'Complete task; keep this conversation and draft' } : {}) });
     }
     else if (state.proposal) {
-        action('proposal:accept', 'Accept suggestion', { icon: icons.add, description: `Left-click to create/start/select; right-click to dismiss.\n${state.proposal.text}` });
+        action('proposal:accept', 'Accept suggestion', { icon: icons.add, description: features.footerNativeActions ? `Create, start, and select this suggestion. Double-click the suggested footer title to accept; use Dismiss suggestion to dismiss.\n${state.proposal.text}` : `Left-click to create/start/select; right-click to dismiss.\n${state.proposal.text}` });
         action('proposal:dismiss', 'Dismiss suggestion', { icon: icons.cross });
     }
     action('screen:tasks', 'Tasks', { icon: icons.note });
@@ -199,8 +204,18 @@ function view(data, scoped = false, secondary = false, features = {}) {
         if (matches.length > 200)
             body += '\nShowing the first 200 matches; use Filter tasks to narrow the list.';
     }
-    const footer = [{ text: `${icons.note} `, width: 3 }];
-    if (task) {
+    const footer = features.footerNativeActions
+        ? [{ text: `${icons['open-app']} `, openApp: true, width: 3 }]
+        : [{ text: `${icons.note} `, width: 3 }];
+    if (features.footerNativeActions) {
+        if (task)
+            footer.push({ text: `${task.tag ? `[${task.tag}] ` : ''}${task.text.split('\n')[0].slice(0, 2000)}`, action: 'preview', ...(task.state === 'in_progress' ? { doubleAction: 'done' } : {}), width: config.config.titleWidth });
+        else if (state.proposal)
+            footer.push({ text: `? ${state.proposal.tag ? `[${state.proposal.tag}] ` : ''}${state.proposal.text.split('\n')[0].slice(0, 2000)}`, doubleAction: 'proposal:accept', ...(features.footerStyles ? { style: { italic: true, color: 'accent' } } : {}), width: config.config.titleWidth });
+        else
+            footer.push({ text: 'Pinote · No task', width: config.config.titleWidth });
+    }
+    else if (task) {
         footer.push({ text: `${icons.check} `, action: 'done', width: 3 });
         footer.push({ text: `${task.tag ? `[${task.tag}] ` : ''}${task.text.split('\n')[0].slice(0, 2000)}`, action: 'preview', ...(features.footerDoubleActions ? { doubleAction: 'done' } : {}), width: config.config.titleWidth });
     }
@@ -210,10 +225,10 @@ function view(data, scoped = false, secondary = false, features = {}) {
     }
     else
         footer.push({ text: 'Pinote · no task', width: config.config.titleWidth });
-    const titleParts = footer.length;
+    let fieldCount = 0;
     if (task) {
         for (const field of fields(config.config, task.agent_notes)) {
-            if (footer.length - titleParts >= config.config.maxFields)
+            if (fieldCount >= config.config.maxFields)
                 break;
             const raw = task.agent_notes[field.name];
             if (!raw)
@@ -226,7 +241,22 @@ function view(data, scoped = false, secondary = false, features = {}) {
                 continue;
             const substitutions = { value, url: url ?? '', number: number ?? '' };
             const rendered = ` · ${field.label ? `${field.label}: ` : ''}${field.format.replace(/<(value|url|number)>/g, (_match, key) => substitutions[key])}`;
-            footer.push({ text: rendered.slice(0, 20_000), ...(field.link && url && url.length <= 2048 ? { url } : {}), width: field.width ?? config.config.fieldWidth });
+            const target = field.link && url && url.length <= 2048 ? url : undefined;
+            const width = field.width ?? config.config.fieldWidth;
+            if (features.footerNativeActions) {
+                if (footer.length + (target ? 2 : 1) > 128)
+                    break;
+                // Clip before splitting: each field still consumes one field slot, and
+                // the icon (including its space) shares the field's cell budget.
+                const icon = target ? ` ${icons['external-link']}` : '';
+                const plain = stripVTControlCharacters(rendered).replace(/[\u0000-\u001f\u007f-\u009f]/g, ' ');
+                footer.push({ text: truncateToWidth(plain.slice(0, 20_000), Math.max(0, width - visibleWidth(icon)), ''), width });
+                if (target)
+                    footer.push({ text: icon, url: target });
+            }
+            else
+                footer.push({ text: rendered.slice(0, 20_000), ...(target ? { url: target } : {}), width });
+            fieldCount++;
         }
     }
     const editable = controls.filter((control) => {
@@ -269,7 +299,7 @@ server.setRequestHandler(Action, (request, extra) => serial(async () => {
     const before = await snapshot(state, extra.signal);
     const scoped = scopedActions(request.params._meta);
     const { action, value } = request.params;
-    const control = view(before, scoped).controls.find((item) => item.id === action);
+    const control = view(before, scoped, secondaryActions(request.params._meta), footerFeatures(request.params._meta)).controls.find((item) => item.id === action);
     if (!control || (control.revision ?? before.revision) !== request.params.revision)
         staleAction();
     const next = { ...before.state };
@@ -403,7 +433,7 @@ server.setRequestHandler(CallToolRequestSchema, (request, extra) => serial(async
         }
         else
             throw new Error('Unknown tool');
-        return { content: [{ type: 'text', text: JSON.stringify(result) }], ...(outgoing ? { _meta: { 'native-ui/state': outgoing } } : {}) };
+        return { content: [{ type: 'text', text: JSON.stringify(result) }], ...(outgoing ? { _meta: { 'native-ui/state': outgoing } } : request.params.name === 'get_current' ? { _meta: { 'pinote/database': database } } : {}) };
     }
     catch (error) {
         return { isError: true, content: [{ type: 'text', text: String(error) }] };
@@ -413,8 +443,6 @@ server.setRequestHandler(CallToolRequestSchema, (request, extra) => serial(async
 // sessions. Stat polling survives missing files and atomic config replacement.
 server.oninitialized = () => {
     server.oninitialized = undefined;
-    const dataHome = process.env.XDG_DATA_HOME;
-    const database = join(dataHome && isAbsolute(dataHome) ? dataHome : join(homedir(), '.local/share'), 'pinote/notes.db');
     const paths = [database, `${database}-wal`, join(getAgentDir(), 'pi-note.json'), receiptDir];
     let timer;
     let closed = false;

package/exit-confirm.ts

@@ -0,0 +1,127 @@
+import { CustomEditor, type ExtensionAPI } from "@earendil-works/pi-coding-agent";
+import { truncateToWidth } from "@earendil-works/pi-tui";
+import { realpath } from "node:fs/promises";
+import { homedir } from "node:os";
+import { isAbsolute, join } from "node:path";
+import { stripVTControlCharacters } from "node:util";
+
+type Task = { id: number; text: string; updated_at: string; state: string };
+type Current = { task: Task | null; database?: string };
+const complete = "Complete task and exit";
+const leave = "Exit without completing";
+const clean = (value: string) => stripVTControlCharacters(value).replace(/[\x00-\x1f\x7f-\x9f]/gu, " ");
+function task(value: unknown): Task | null {
+  if (value === null) return null;
+  const item = value as Task | undefined;
+  if (!item || !Number.isSafeInteger(item.id) || item.id < 1 || typeof item.text !== "string" ||
+      typeof item.updated_at !== "string" || !item.updated_at ||
+      !["active", "in_progress", "done"].includes(item.state)) throw new Error("Invalid Pinote task response");
+  return item;
+}
+function same(left: Task | null, right: Task): boolean {
+  return left?.id === right.id && left.updated_at === right.updated_at && left.text === right.text && left.state === right.state;
+}
+
+// Optional MCP companion: deliberately absent from package.json's default extensions.
+export default function (pi: ExtensionAPI) {
+  let invalidate: (() => void) | undefined;
+  let stop: (() => void) | undefined;
+  const readCurrent = async (): Promise<Current> => {
+    const replies: { handled?: boolean; error?: string; result?: Promise<unknown> }[] = [];
+    pi.events.emit("gateway:query-service-tool", {
+      service: "pinote", tool: "get_current",
+      respond: (reply: typeof replies[number]) => {
+        if (reply.handled) { replies.push(reply); void reply.result?.catch(() => {}); }
+      },
+    });
+    if (replies.length !== 1 || replies[0].error || !replies[0].result) {
+      throw new Error(replies[0]?.error || "Pinote gateway service unavailable; use /quit to exit without completing");
+    }
+    const result = await replies[0].result as {
+      isError?: boolean; content?: { type: string; text?: string }[]; _meta?: Record<string, unknown>;
+    };
+    if (result.isError) throw new Error(result.content?.find((item) => item.type === "text")?.text || "Pinote query failed");
+    const raw = result.content?.find((item) => item.type === "text")?.text;
+    if (raw === undefined) throw new Error("Missing Pinote task response");
+    const value = task(JSON.parse(raw));
+    if (value && !["active", "in_progress"].includes(value.state)) throw new Error("Pinote task is no longer active");
+    const database = result._meta?.["pinote/database"];
+    return { task: value, database: typeof database === "string" ? database : undefined };
+  };
+  pi.on("session_start", (_event, ctx) => {
+    if (ctx.mode !== "tui" || !ctx.hasUI) return;
+    const previous = ctx.ui.getEditorComponent();
+    let alive = true, pending = false, epoch = 0;
+    let controller: AbortController | undefined;
+    invalidate = () => { epoch++; controller?.abort(); };
+    const exit = async () => {
+      if (pending || !alive) return;
+      pending = true;
+      const generation = epoch;
+      const operation = controller = new AbortController();
+      const current = () => alive && generation === epoch && !operation.signal.aborted &&
+        ctx.ui.getEditorText().length === 0;
+      const shutdown = () => { if (!ctx.isIdle()) ctx.abort(); ctx.shutdown(); };
+      const run = async (args: string[]) => {
+        if (!current() || !ctx.isIdle()) throw new Error("Pinote exit cancelled: session changed or became busy");
+        const result = await pi.exec(process.env.PINOTE_NOTE_COMMAND || "note", args, { timeout: 10_000, signal: operation.signal });
+        if (result.killed || result.code !== 0) throw new Error(clean(result.stderr || result.stdout || "Pinote CLI failed or timed out"));
+        return result.stdout;
+      };
+      try {
+        const selected = await readCurrent();
+        if (!current()) return;
+        if (!selected.task) { shutdown(); return; }
+        const approved = selected.task;
+        const title = truncateToWidth(clean(approved.text.split("\n", 1)[0]), 70);
+        const choice = await ctx.ui.select(`Pinote · ${title}`, [complete, leave, "Cancel"], { signal: operation.signal });
+        if (!current()) return;
+        if (choice === leave) { shutdown(); return; }
+        if (choice !== complete) return;
+        if (!ctx.isIdle()) throw new Error("Wait for Pi to become idle before completing a task");
+        const dataHome = process.env.XDG_DATA_HOME;
+        const localDatabase = join(dataHome && isAbsolute(dataHome) ? dataHome : join(homedir(), ".local/share"), "pinote/notes.db");
+        if (!selected.database || !isAbsolute(selected.database) ||
+            await realpath(selected.database) !== await realpath(localDatabase)) {
+          throw new Error("Pinote database mismatch: update the MCP server and use the same XDG_DATA_HOME in Pi and the service");
+        }
+        const version = (await run(["--version"])).trim();
+        const match = /^pinote (\d+)\.(\d+)\.(\d+)$/.exec(version);
+        if (!match || Number(match[1]) === 0 && Number(match[2]) < 12) throw new Error("Pinote exit confirmation requires note 0.12.0+");
+        const local = task(JSON.parse(await run(["--no-notify", "agent", "get", String(approved.id)])));
+        const fresh = await readCurrent();
+        if (!same(local, approved) || !same(fresh.task, approved) || fresh.database !== selected.database) {
+          throw new Error("Pinote task changed; inspect it before retrying");
+        }
+        const done = task(JSON.parse(await run(["--no-notify", "agent", "done", String(approved.id), "--expected-updated-at", approved.updated_at])));
+        if (done?.id !== approved.id || done.state !== "done") throw new Error("Unexpected completion response; inspect the task before retrying");
+        if (current() && !(await readCurrent()).task && current()) shutdown();
+        else if (current()) ctx.ui.notify("Task completed; Pi stayed open because the selection changed", "info");
+      } catch (error) {
+        if (alive && generation === epoch) ctx.ui.notify(`Pinote: ${clean(String(error))}. Pi stayed open; inspect the task before retrying. /quit exits without completing.`, "error");
+      } finally { pending = false; }
+    };
+    const factory: NonNullable<ReturnType<typeof ctx.ui.getEditorComponent>> = (tui, theme, keybindings) => {
+      const editor = previous ? previous(tui, theme, keybindings) : new CustomEditor(tui, theme, keybindings);
+      const handleInput = editor.handleInput.bind(editor);
+      editor.handleInput = (data) => {
+        if (keybindings.matches(data, "app.exit") && editor.getText().length === 0) { void exit(); return; }
+        handleInput(data);
+      };
+      return editor;
+    };
+    ctx.ui.setEditorComponent(factory);
+    stop = () => {
+      alive = false;
+      invalidate?.();
+      if (ctx.ui.getEditorComponent() === factory) ctx.ui.setEditorComponent(previous);
+    };
+  });
+  pi.on("session_shutdown", () => { stop?.(); stop = invalidate = undefined; });
+  // Retire in-flight dialogs/reads before navigation or a new agent run can act.
+  const interrupted = () => { invalidate?.(); };
+  pi.on("session_before_switch", interrupted);
+  pi.on("session_before_fork", interrupted);
+  pi.on("session_before_tree", interrupted);
+  pi.on("agent_start", interrupted);
+}

package/icons/external-link.txt

@@ -0,0 +1 @@
+↗

package/icons/open-app.txt

@@ -0,0 +1 @@
+▤

package/mcp/README.md

@@ -6,7 +6,8 @@ the generic [gateway UI host](https://github.com/kvidzibo/mcp-session-gateway)
 only renders and routes them. No model turn is needed for UI actions.
 
 This uses the gateway's **private native UI v1 protocol**, not browser MCP Apps or
-the built-in Pi MCP resource renderer. Use gateway 0.12.0+ with its Pi adapter.
+the built-in Pi MCP resource renderer. Use gateway 0.12.0+ with its Pi adapter;
+see below for features requiring newer gateways.
 
 ## Setup
 
@@ -54,7 +55,22 @@ normal personal data. No desktop notifications are sent.
   so whitespace round-trips exactly. Saves are confirmed, validated, and atomic; concurrent
   edits are rejected and unrelated settings are preserved. Invalid configuration
   fails closed; repair it manually rather than replacing it with defaults.
-- **Footer:** selected task plus configured fields; safe HTTP(S) links are clickable.
+- **Fullscreen native footer (gateway 0.30.0+):** enabled only when the host
+  negotiates `native-ui/features.footerNativeActions=true` (the gateway advertises
+  `experimental.native-ui-v1.footerNativeActions=true`). **▤** opens the Pinote app;
+  there are no separate complete/accept buttons. Idle status reads “Pinote · No task”.
+  Task titles are plain text, not terminal links: single-click previews without changing state;
+  double-click completes an in-progress task immediately, with no extra confirmation.
+  Suggestions have a `? ` prefix and italic/accent styling when supported;
+  single-click is inert, double-click creates/starts/selects. Use the app menu to
+  dismiss a suggestion. Handoff labels are plain text with a separate **↗** link;
+  label and icon share the configured field width and count as one field. Very large
+  footers omit fields beyond the 128-segment protocol limit, keeping label/icon pairs intact.
+  Clicks/double-clicks are handled locally by the fullscreen host. Completion never
+  resets the conversation or editor; app menus remain the accessible keyboard fallback.
+- **Regular/older-host footer:** unchanged when native footer actions are not
+  negotiated (the regular host never sends that feature). Selected task plus
+  configured fields; safe HTTP(S) links are clickable.
   Single-click the active title to preview; double-click it to complete. **✔** also
   completes and clears the selection without resetting the conversation or editor.
   Suggested titles use italic accent text; double-click to accept/start, then the
@@ -87,6 +103,40 @@ have saved the session for resume persistence. Existing extension selections are
 not imported. Changing the gateway config path or service name starts a separate
 selection namespace.
 
+## Optional Ctrl+D exit confirmation
+
+`pi-note` 0.25.0 ships `pi/exit-confirm.ts`, a disabled-by-default **companion** to this
+MCP setup, not the old `pi/index.ts` extension. It requires Pi 0.99.1+, a gateway
+supporting `gateway:query-service-tool`, and this version of the Pinote MCP server
+registered as `pinote`. Enable it for one launch:
+
+```bash
+PINOTE_NOTE_COMMAND=/absolute/path/to/pinote/.venv/bin/note \
+  pi -e /absolute/path/to/pinote/pi/exit-confirm.ts
+```
+
+For persistent use, add that absolute extension path to `extensions` in Pi's
+user `settings.json`, preserving other entries, then `/reload`. Remove the path
+and `/reload` to disable it. Installing `pi-note` does not enable the companion.
+Load it after other editor extensions so it can wrap their editor without replacing
+its normal input behavior.
+
+With an empty editor, Ctrl+D (or your configured `app.exit` key) offers **Complete
+task and exit**, **Exit without completing**, or **Cancel**. Escape cancels. With
+no selected task Pi exits immediately; nonempty text keeps normal editing behavior.
+Completion requires idle Pi, rechecks the selection and displayed revision, and
+uses the local CLI without notifications. Query/completion failures leave Pi open;
+inspect the task before retrying because a failed write may have committed. `/quit`
+and other exit paths bypass the companion and never complete a task.
+
+Pi and the MCP service must use the **same local database**: match `XDG_DATA_HOME`
+(and HOME when using defaults). Set `PINOTE_NOTE_COMMAND` in Pi's environment if
+`note` is not on PATH; its executable must use that same database. The companion
+compares the server's database path and task revision before writing; it does not
+fall back to a folder selection or create another selection store. Remote Pinote
+services are unsupported. RPC/print mode is unaffected; no Pi/gateway patch or
+personal configuration change is made by installation.
+
 ## Task-offer guidance
 
 Before multi-step implementation or configuration migrations, agents should call

package/mcp/server.ts

@@ -10,6 +10,8 @@ import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { CallToolRequestSchema, ListToolsRequestSchema, ListResourcesRequestSchema, ReadResourceRequestSchema, McpError } from '@modelcontextprotocol/sdk/types.js';
 import { z } from 'zod';
+import { truncateToWidth, visibleWidth } from '@earendil-works/pi-tui';
+import { stripVTControlCharacters } from 'node:util';
 import { defaultFooterField, defaultHandoffPrompt, defaultNewSessionPrompt, effectiveFooterFields, parseFooterConfig, parseHandoffPrompt, parseNewSessionPrompt, readFooterDocument, saveFooterConfig } from '../footer-config.ts';
 
 const URI = 'pinote://ui';
@@ -17,7 +19,9 @@ const MIME = 'application/vnd.mcp-native-ui+json';
 const CONTEXT = 'native-ui/context';
 const exec = promisify(execFile);
 const noteCommand = process.env.PINOTE_NOTE_COMMAND || 'note';
-const icons = Object.fromEntries(['add', 'check', 'cross', 'note'].map((name) => [name, readFileSync(new URL(`../icons/${name}.txt`, import.meta.url), 'utf8').trim()]));
+const dataHome = process.env.XDG_DATA_HOME;
+const database = join(dataHome && isAbsolute(dataHome) ? dataHome : join(homedir(), '.local/share'), 'pinote/notes.db');
+const icons = Object.fromEntries(['add', 'check', 'cross', 'note', 'open-app', 'external-link'].map((name) => [name, readFileSync(new URL(`../icons/${name}.txt`, import.meta.url), 'utf8').trim()]));
 const Proposal = z.object({ id: z.string().uuid(), text: z.string().min(1).max(4000), tag: z.string().trim().min(1).max(64).optional() }).strict();
 const Context = z.object({ conversationId: z.string().min(1).max(256), contextId: z.string().min(1).max(256).optional(), state: z.object({
   proposal: Proposal.nullable().optional(),
@@ -32,7 +36,7 @@ const Action = z.object({ method: z.literal('native-ui/action'), params: z.objec
   uri: z.literal(URI), revision: z.string().min(1).max(256), action: z.string().min(1).max(256),
   value: z.union([z.string().max(20_000), z.number().finite(), z.boolean(), z.null()]).optional(), _meta: z.record(z.unknown()).optional(),
 }) });
-const server = new Server({ name: 'pinote', version: '0.23.0' }, { capabilities: { tools: {}, resources: {}, experimental: { 'native-ui-v1': {} } } });
+const server = new Server({ name: 'pinote', version: '0.25.0' }, { capabilities: { tools: {}, resources: {}, experimental: { 'native-ui-v1': {} } } });
 // Serialize complete read/check/write cycles even when a host sends parallel calls.
 let queue = Promise.resolve();
 function serial<T>(run: () => Promise<T>): Promise<T> {
@@ -120,11 +124,12 @@ function secondaryActions(meta: Record<string, unknown> | undefined): boolean {
 }
 function footerFeatures(meta: Record<string, unknown> | undefined) {
   return {
+    footerNativeActions: z.object({ footerNativeActions: z.literal(true) }).safeParse(meta?.['native-ui/features']).success,
     footerStyles: z.object({ footerStyles: z.literal(true) }).safeParse(meta?.['native-ui/features']).success,
     footerDoubleActions: z.object({ footerDoubleActions: z.literal(true) }).safeParse(meta?.['native-ui/features']).success,
   };
 }
-function view(data: Snapshot, scoped = false, secondary = false, features: { footerStyles?: boolean; footerDoubleActions?: boolean } = {}) {
+function view(data: Snapshot, scoped = false, secondary = false, features: { footerNativeActions?: boolean; footerStyles?: boolean; footerDoubleActions?: boolean } = {}) {
   const { tasks, task, config, revision } = data;
   const state = Context.parse({ conversationId: 'outgoing-state', state: { ...data.state, selectedId: task?.id ?? null } }).state;
   const controls: Control[] = [];
@@ -134,9 +139,9 @@ function view(data: Snapshot, scoped = false, secondary = false, features: { foo
   // Footer actions remain valid on every screen, including Settings.
   if (task) {
     action('preview', 'Preview full task', { description: 'Display only; never sent to the model' });
-    action('done', 'Complete task', { icon: icons.check });
+    action('done', 'Complete task', { icon: icons.check, ...(features.footerNativeActions ? { description: 'Complete task; keep this conversation and draft' } : {}) });
   } else if (state.proposal) {
-    action('proposal:accept', 'Accept suggestion', { icon: icons.add, description: `Left-click to create/start/select; right-click to dismiss.\n${state.proposal.text}` });
+    action('proposal:accept', 'Accept suggestion', { icon: icons.add, description: features.footerNativeActions ? `Create, start, and select this suggestion. Double-click the suggested footer title to accept; use Dismiss suggestion to dismiss.\n${state.proposal.text}` : `Left-click to create/start/select; right-click to dismiss.\n${state.proposal.text}` });
     action('proposal:dismiss', 'Dismiss suggestion', { icon: icons.cross });
   }
   action('screen:tasks', 'Tasks', { icon: icons.note });
@@ -170,18 +175,24 @@ function view(data: Snapshot, scoped = false, secondary = false, features: { foo
     for (const candidate of matches.slice(0, 200)) action(`select:${candidate.id}`, `${candidate.tag ? `[${candidate.tag}] ` : ''}${candidate.text.split('\n')[0]}`, { description: `#${candidate.id} · ${candidate.state}`, confirm: 'Select and start this task for this conversation?' });
     if (matches.length > 200) body += '\nShowing the first 200 matches; use Filter tasks to narrow the list.';
   }
-  const footer: { text: string; url?: string; action?: string; secondaryAction?: string; doubleAction?: string; style?: { italic: boolean; color: 'accent' }; width?: number }[] = [{ text: `${icons.note} `, width: 3 }];
-  if (task) {
+  const footer: { text: string; openApp?: true; url?: string; action?: string; secondaryAction?: string; doubleAction?: string; style?: { italic: boolean; color: 'accent' }; width?: number }[] = features.footerNativeActions
+    ? [{ text: `${icons['open-app']} `, openApp: true, width: 3 }]
+    : [{ text: `${icons.note} `, width: 3 }];
+  if (features.footerNativeActions) {
+    if (task) footer.push({ text: `${task.tag ? `[${task.tag}] ` : ''}${task.text.split('\n')[0].slice(0, 2000)}`, action: 'preview', ...(task.state === 'in_progress' ? { doubleAction: 'done' } : {}), width: config.config.titleWidth });
+    else if (state.proposal) footer.push({ text: `? ${state.proposal.tag ? `[${state.proposal.tag}] ` : ''}${state.proposal.text.split('\n')[0].slice(0, 2000)}`, doubleAction: 'proposal:accept', ...(features.footerStyles ? { style: { italic: true, color: 'accent' } as const } : {}), width: config.config.titleWidth });
+    else footer.push({ text: 'Pinote · No task', width: config.config.titleWidth });
+  } else if (task) {
     footer.push({ text: `${icons.check} `, action: 'done', width: 3 });
     footer.push({ text: `${task.tag ? `[${task.tag}] ` : ''}${task.text.split('\n')[0].slice(0, 2000)}`, action: 'preview', ...(features.footerDoubleActions ? { doubleAction: 'done' } : {}), width: config.config.titleWidth });
   } else if (state.proposal) {
     footer.push({ text: `${icons.add} `, action: 'proposal:accept', ...(secondary ? { secondaryAction: 'proposal:dismiss' } : {}), width: 3 });
     footer.push({ text: `${state.proposal.tag ? `[${state.proposal.tag}] ` : ''}${state.proposal.text.split('\n')[0].slice(0, 2000)}`, ...(features.footerDoubleActions ? { doubleAction: 'proposal:accept' } : {}), ...(features.footerStyles ? { style: { italic: true, color: 'accent' } as const } : {}), width: config.config.titleWidth });
   } else footer.push({ text: 'Pinote · no task', width: config.config.titleWidth });
-  const titleParts = footer.length;
+  let fieldCount = 0;
   if (task) {
     for (const field of fields(config.config, task.agent_notes)) {
-      if (footer.length - titleParts >= config.config.maxFields) break;
+      if (fieldCount >= config.config.maxFields) break;
       const raw = task.agent_notes[field.name];
       if (!raw) continue;
       const link = /^\[([^\n]*)\]\((https?:\/\/[^\s]+)\)$/.exec(raw);
@@ -191,7 +202,18 @@ function view(data: Snapshot, scoped = false, secondary = false, features: { foo
       if (field.format.includes('<url>') && !url || field.format.includes('<number>') && !number) continue;
       const substitutions: Record<string, string> = { value, url: url ?? '', number: number ?? '' };
       const rendered = ` · ${field.label ? `${field.label}: ` : ''}${field.format.replace(/<(value|url|number)>/g, (_match, key: string) => substitutions[key])}`;
-      footer.push({ text: rendered.slice(0, 20_000), ...(field.link && url && url.length <= 2048 ? { url } : {}), width: field.width ?? config.config.fieldWidth });
+      const target = field.link && url && url.length <= 2048 ? url : undefined;
+      const width = field.width ?? config.config.fieldWidth;
+      if (features.footerNativeActions) {
+        if (footer.length + (target ? 2 : 1) > 128) break;
+        // Clip before splitting: each field still consumes one field slot, and
+        // the icon (including its space) shares the field's cell budget.
+        const icon = target ? ` ${icons['external-link']}` : '';
+        const plain = stripVTControlCharacters(rendered).replace(/[\u0000-\u001f\u007f-\u009f]/g, ' ');
+        footer.push({ text: truncateToWidth(plain.slice(0, 20_000), Math.max(0, width - visibleWidth(icon)), ''), width });
+        if (target) footer.push({ text: icon, url: target });
+      } else footer.push({ text: rendered.slice(0, 20_000), ...(target ? { url: target } : {}), width });
+      fieldCount++;
     }
   }
   const editable = controls.filter((control) => {
@@ -224,7 +246,7 @@ server.setRequestHandler(Action, (request, extra) => serial(async () => {
   const before = await snapshot(state, extra.signal);
   const scoped = scopedActions(request.params._meta);
   const { action, value } = request.params;
-  const control = view(before, scoped).controls.find((item) => item.id === action);
+  const control = view(before, scoped, secondaryActions(request.params._meta), footerFeatures(request.params._meta)).controls.find((item) => item.id === action);
   if (!control || (control.revision ?? before.revision) !== request.params.revision) staleAction();
   const next: State = { ...before.state };
   let draft: string | undefined, preview: string | undefined;
@@ -314,15 +336,13 @@ server.setRequestHandler(CallToolRequestSchema, (request, extra) => serial(async
       result = JSON.parse(await note(['agent', 'update', String(task.id), '--expected-updated-at', args.expected_updated_at, '--set-json', JSON.stringify(args.set), ...args.remove.map((key) => `--remove=${key}`)], extra.signal));
       await server.notification({ method: 'notifications/native-ui/changed', params: { uri: URI } });
     } else throw new Error('Unknown tool');
-    return { content: [{ type: 'text', text: JSON.stringify(result) }], ...(outgoing ? { _meta: { 'native-ui/state': outgoing } } : {}) };
+    return { content: [{ type: 'text', text: JSON.stringify(result) }], ...(outgoing ? { _meta: { 'native-ui/state': outgoing } } : request.params.name === 'get_current' ? { _meta: { 'pinote/database': database } } : {}) };
   } catch (error) { return { isError: true, content: [{ type: 'text', text: String(error) }] }; }
 }));
 // Every MCP process observes shared storage, including writes by CLI/GTK/other
 // sessions. Stat polling survives missing files and atomic config replacement.
 server.oninitialized = () => {
   server.oninitialized = undefined;
-  const dataHome = process.env.XDG_DATA_HOME;
-  const database = join(dataHome && isAbsolute(dataHome) ? dataHome : join(homedir(), '.local/share'), 'pinote/notes.db');
   const paths = [database, `${database}-wal`, join(getAgentDir(), 'pi-note.json'), receiptDir];
   let timer: ReturnType<typeof setTimeout> | undefined;
   let closed = false;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-note",
-  "version": "0.23.0",
+  "version": "0.25.0",
   "description": "Persistent pinote tasks, Markdown handoffs, and task status for Pi",
   "license": "MIT",
   "type": "module",
@@ -27,6 +27,7 @@
   },
   "files": [
     "index.ts",
+    "exit-confirm.ts",
     "footer-status.ts",
     "footer-links.ts",
     "footer-config.ts",