nod-shout 0.1.2 → 0.2.0

package/dist/index.js

@@ -5,6 +5,8 @@ import { registerCollectionTools } from "./tools/collections.js";
 import { registerSocialTools } from "./tools/social.js";
 import { registerSettingsTools } from "./tools/settings.js";
 import { registerPostTools } from "./tools/posts.js";
+import { registerLinkQueueTools } from "./tools/link-queue.js";
+import { registerTextPostTools } from "./tools/text-posts.js";
 // agent curate tool is registered inside registerLinkTools
 // accept username: npx nod-shout makaeel  OR  npx nod-shout --user makaeel
 const args = process.argv.slice(2);
@@ -22,7 +24,7 @@ if (!process.env.NOD_USER_ID) {
 }
 const server = new McpServer({
     name: "nod-shout",
-    version: "0.1.1",
+    version: "0.2.0",
 });
 // register all tools
 registerLinkTools(server);
@@ -30,6 +32,8 @@ registerCollectionTools(server);
 registerSocialTools(server);
 registerSettingsTools(server);
 registerPostTools(server);
+registerLinkQueueTools(server);
+registerTextPostTools(server);
 // start the server on stdio transport
 async function main() {
     const transport = new StdioServerTransport();

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,2DAA2D;AAE3D,2EAA2E;AAC3E,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACnC,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;AAC3C,IAAI,WAAW,KAAK,CAAC,CAAC,IAAI,IAAI,CAAC,WAAW,GAAG,CAAC,CAAC,EAAE,CAAC;IAChD,OAAO,CAAC,GAAG,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC;AAClD,CAAC;KAAM,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;IACvD,OAAO,CAAC,GAAG,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;AACpC,CAAC;AAED,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC;IAC7B,OAAO,CAAC,KAAK,CAAC,iCAAiC,CAAC,CAAC;IACjD,OAAO,CAAC,KAAK,CAAC,8BAA8B,CAAC,CAAC;IAC9C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;IAC3B,IAAI,EAAE,WAAW;IACjB,OAAO,EAAE,OAAO;CACjB,CAAC,CAAC;AAEH,qBAAqB;AACrB,iBAAiB,CAAC,MAAM,CAAC,CAAC;AAC1B,uBAAuB,CAAC,MAAM,CAAC,CAAC;AAChC,mBAAmB,CAAC,MAAM,CAAC,CAAC;AAC5B,qBAAqB,CAAC,MAAM,CAAC,CAAC;AAC9B,iBAAiB,CAAC,MAAM,CAAC,CAAC;AAE1B,sCAAsC;AACtC,KAAK,UAAU,IAAI;IACjB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,OAAO,CAAC,KAAK,CAAC,+BAA+B,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC;AAC1E,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,GAAG,CAAC,CAAC;IACnC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,2DAA2D;AAE3D,2EAA2E;AAC3E,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACnC,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;AAC3C,IAAI,WAAW,KAAK,CAAC,CAAC,IAAI,IAAI,CAAC,WAAW,GAAG,CAAC,CAAC,EAAE,CAAC;IAChD,OAAO,CAAC,GAAG,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC;AAClD,CAAC;KAAM,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;IACvD,OAAO,CAAC,GAAG,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;AACpC,CAAC;AAED,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC;IAC7B,OAAO,CAAC,KAAK,CAAC,iCAAiC,CAAC,CAAC;IACjD,OAAO,CAAC,KAAK,CAAC,8BAA8B,CAAC,CAAC;IAC9C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;IAC3B,IAAI,EAAE,WAAW;IACjB,OAAO,EAAE,OAAO;CACjB,CAAC,CAAC;AAEH,qBAAqB;AACrB,iBAAiB,CAAC,MAAM,CAAC,CAAC;AAC1B,uBAAuB,CAAC,MAAM,CAAC,CAAC;AAChC,mBAAmB,CAAC,MAAM,CAAC,CAAC;AAC5B,qBAAqB,CAAC,MAAM,CAAC,CAAC;AAC9B,iBAAiB,CAAC,MAAM,CAAC,CAAC;AAC1B,sBAAsB,CAAC,MAAM,CAAC,CAAC;AAC/B,qBAAqB,CAAC,MAAM,CAAC,CAAC;AAE9B,sCAAsC;AACtC,KAAK,UAAU,IAAI;IACjB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,OAAO,CAAC,KAAK,CAAC,+BAA+B,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC;AAC1E,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,GAAG,CAAC,CAAC;IACnC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/tools/link-queue.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerLinkQueueTools(server: McpServer): void;
+//# sourceMappingURL=link-queue.d.ts.map

package/dist/tools/link-queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"link-queue.d.ts","sourceRoot":"","sources":["../../src/tools/link-queue.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIzE,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,QA+MvD"}

package/dist/tools/link-queue.js

@@ -0,0 +1,171 @@
+import { z } from "zod";
+import { supabase } from "../lib/supabase.js";
+const USER_ID = process.env.NOD_USER_ID || "anonymous";
+export function registerLinkQueueTools(server) {
+    // queue_link - agent spots a link in conversation and queues it for later
+    server.tool("queue_link", "queue a link spotted in conversation for the user to review later. use this when a user shares or discusses a link but doesn't explicitly ask to shout it. the agent collects these throughout the day and prompts the user to review them later.", {
+        url: z.string().url().describe("the url to queue"),
+        title: z.string().optional().describe("page title if known"),
+        context: z.string().optional().describe("what the user said about this link or why they shared it"),
+        agent_note: z.string().optional().describe("why the agent thinks this link is worth saving — be specific about what makes it interesting"),
+        source: z.enum(["conversation", "browsing", "research"]).default("conversation").describe("where the link came from"),
+    }, async ({ url, title, context, agent_note, source }) => {
+        // look up user
+        const { data: profile } = await supabase
+            .from("profiles")
+            .select("id")
+            .eq("username", USER_ID)
+            .single();
+        if (!profile) {
+            return {
+                content: [{ type: "text", text: `no profile found for user ${USER_ID}. run get_profile first to set up.` }],
+            };
+        }
+        // check for duplicate url in pending queue
+        const { data: existing } = await supabase
+            .from("link_queue")
+            .select("id")
+            .eq("user_id", profile.id)
+            .eq("url", url)
+            .eq("status", "pending")
+            .single();
+        if (existing) {
+            return {
+                content: [{ type: "text", text: `this link is already in the queue.` }],
+            };
+        }
+        const { data, error } = await supabase
+            .from("link_queue")
+            .insert({
+            user_id: profile.id,
+            url,
+            title: title || null,
+            context: context || null,
+            agent_note: agent_note || null,
+            source,
+        })
+            .select()
+            .single();
+        if (error) {
+            return {
+                content: [{ type: "text", text: `error queuing link: ${error.message}` }],
+            };
+        }
+        return {
+            content: [{ type: "text", text: `queued "${title || url}" for later review. i'll remind you to review your queued links later.` }],
+        };
+    });
+    // review_queue - show pending links for the user to approve/dismiss
+    server.tool("review_queue", "show the user their pending queued links from today's conversations. use this to prompt them to shout, dismiss, or save links for later. call this at natural pauses in conversation or end of day.", {
+        limit: z.number().min(1).max(50).default(10).describe("max links to show"),
+        since_hours: z.number().min(1).max(168).default(24).describe("show links from the last N hours"),
+    }, async ({ limit, since_hours }) => {
+        const { data: profile } = await supabase
+            .from("profiles")
+            .select("id")
+            .eq("username", USER_ID)
+            .single();
+        if (!profile) {
+            return {
+                content: [{ type: "text", text: `no profile found for user ${USER_ID}.` }],
+            };
+        }
+        const since = new Date(Date.now() - since_hours * 60 * 60 * 1000).toISOString();
+        const { data: links, error } = await supabase
+            .from("link_queue")
+            .select("*")
+            .eq("user_id", profile.id)
+            .eq("status", "pending")
+            .gte("spotted_at", since)
+            .order("spotted_at", { ascending: false })
+            .limit(limit);
+        if (error) {
+            return {
+                content: [{ type: "text", text: `error fetching queue: ${error.message}` }],
+            };
+        }
+        if (!links || links.length === 0) {
+            return {
+                content: [{ type: "text", text: `no pending links in the queue. all caught up!` }],
+            };
+        }
+        const summary = links.map((l, i) => {
+            let line = `${i + 1}. ${l.title || l.url}`;
+            if (l.title)
+                line += `\n   ${l.url}`;
+            if (l.context)
+                line += `\n   you said: "${l.context}"`;
+            if (l.agent_note)
+                line += `\n   why it's interesting: ${l.agent_note}`;
+            line += `\n   spotted: ${new Date(l.spotted_at).toLocaleString()}`;
+            line += `\n   id: ${l.id}`;
+            return line;
+        }).join("\n\n");
+        return {
+            content: [{
+                    type: "text",
+                    text: `you have ${links.length} link${links.length === 1 ? "" : "s"} from the last ${since_hours} hours:\n\n${summary}\n\nwant to shout any of these? you can say "shout #1" or "dismiss #3" or "shout all".`,
+                }],
+        };
+    });
+    // resolve_queue_item - mark a queued link as shouted or dismissed
+    server.tool("resolve_queue_item", "mark a queued link as shouted or dismissed. use after the user decides what to do with a queued link.", {
+        queue_id: z.string().uuid().describe("the queue item id"),
+        action: z.enum(["shouted", "dismissed"]).describe("what happened to the link"),
+    }, async ({ queue_id, action }) => {
+        const { error } = await supabase
+            .from("link_queue")
+            .update({
+            status: action,
+            resolved_at: new Date().toISOString(),
+        })
+            .eq("id", queue_id);
+        if (error) {
+            return {
+                content: [{ type: "text", text: `error updating queue item: ${error.message}` }],
+            };
+        }
+        return {
+            content: [{ type: "text", text: `link ${action}.` }],
+        };
+    });
+    // queue_stats - quick summary of queue activity
+    server.tool("queue_stats", "get a quick summary of queued links — how many pending, shouted today, dismissed.", {}, async () => {
+        const { data: profile } = await supabase
+            .from("profiles")
+            .select("id")
+            .eq("username", USER_ID)
+            .single();
+        if (!profile) {
+            return {
+                content: [{ type: "text", text: `no profile found for user ${USER_ID}.` }],
+            };
+        }
+        const today = new Date();
+        today.setHours(0, 0, 0, 0);
+        const { data: pending } = await supabase
+            .from("link_queue")
+            .select("id", { count: "exact" })
+            .eq("user_id", profile.id)
+            .eq("status", "pending");
+        const { data: shoutedToday } = await supabase
+            .from("link_queue")
+            .select("id", { count: "exact" })
+            .eq("user_id", profile.id)
+            .eq("status", "shouted")
+            .gte("resolved_at", today.toISOString());
+        const { data: dismissedToday } = await supabase
+            .from("link_queue")
+            .select("id", { count: "exact" })
+            .eq("user_id", profile.id)
+            .eq("status", "dismissed")
+            .gte("resolved_at", today.toISOString());
+        return {
+            content: [{
+                    type: "text",
+                    text: `queue stats:\n- pending: ${pending?.length || 0}\n- shouted today: ${shoutedToday?.length || 0}\n- dismissed today: ${dismissedToday?.length || 0}`,
+                }],
+        };
+    });
+}
+//# sourceMappingURL=link-queue.js.map

package/dist/tools/link-queue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"link-queue.js","sourceRoot":"","sources":["../../src/tools/link-queue.ts"],"names":[],"mappings":"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"}

package/dist/tools/settings.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../../src/tools/settings.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAMzE,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,QA+CtD"}
+{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../../src/tools/settings.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIzE,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,QAwHtD"}

package/dist/tools/settings.js

@@ -1,45 +1,119 @@
 import { z } from "zod";
-// in-memory settings store for v1
-// TODO: persist to supabase user_settings table
-const userSettings = new Map();
+import { supabase } from "../lib/supabase.js";
+const USER_ID = process.env.NOD_USER_ID || "anonymous";
 export function registerSettingsTools(server) {
-    // shout_settings - configure behavior
-    server.tool("shout_settings", "configure your shout behavior preferences.", {
-        user_id: z.string().uuid().describe("the user's id"),
-        auto_detect: z
-            .boolean()
-            .optional()
-            .describe("auto-detect links in conversation"),
-        default_visibility: z
-            .enum(["public", "private", "unlisted"])
-            .optional()
-            .describe("default visibility for new shouts"),
-        digest_frequency: z
-            .enum(["daily", "weekly", "monthly", "never"])
-            .optional()
-            .describe("how often to generate digests"),
-    }, async ({ user_id, auto_detect, default_visibility, digest_frequency }) => {
-        const current = userSettings.get(user_id) || {
-            auto_detect: true,
-            default_visibility: "public",
-            digest_frequency: "weekly",
-        };
-        if (auto_detect !== undefined)
-            current.auto_detect = auto_detect;
+    // shout_settings - configure behavior (now persisted to supabase)
+    server.tool("shout_settings", "view or update your shout preferences — link detection, digest schedule, agent posting permissions, auto-post rules.", {
+        auto_detect_links: z.boolean().optional().describe("should the agent auto-detect links in conversation and queue them?"),
+        default_visibility: z.enum(["public", "private", "unlisted"]).optional().describe("default visibility for new shouts"),
+        digest_frequency: z.enum(["daily", "weekly", "never"]).optional().describe("how often to prompt you to review queued links"),
+        digest_time: z.string().optional().describe("preferred time for daily digest prompt (HH:MM format, e.g. '20:00')"),
+        digest_timezone: z.string().optional().describe("your timezone (e.g. 'America/New_York')"),
+        agent_post_mode: z.enum(["ask", "auto", "curated"]).optional().describe("'ask' = agent always asks before posting. 'auto' = agent posts freely. 'curated' = auto-post for certain tags, ask for others."),
+        auto_post_tags: z.array(z.string()).optional().describe("when agent_post_mode is 'curated', auto-post for these tags without asking"),
+        agent_text_posts: z.boolean().optional().describe("can the agent draft text posts (status updates, observations)?"),
+        agent_text_auto_post: z.boolean().optional().describe("can the agent auto-publish text posts without asking?"),
+    }, async ({ auto_detect_links, default_visibility, digest_frequency, digest_time, digest_timezone, agent_post_mode, auto_post_tags, agent_text_posts, agent_text_auto_post }) => {
+        // look up user
+        const { data: profile } = await supabase
+            .from("profiles")
+            .select("id")
+            .eq("username", USER_ID)
+            .single();
+        if (!profile) {
+            return {
+                content: [{ type: "text", text: `no profile found for user ${USER_ID}.` }],
+            };
+        }
+        // get current settings or create defaults
+        const { data: current } = await supabase
+            .from("user_settings")
+            .select("*")
+            .eq("user_id", profile.id)
+            .single();
+        const updates = { updated_at: new Date().toISOString() };
+        if (auto_detect_links !== undefined)
+            updates.auto_detect_links = auto_detect_links;
         if (default_visibility !== undefined)
-            current.default_visibility = default_visibility;
+            updates.default_visibility = default_visibility;
         if (digest_frequency !== undefined)
-            current.digest_frequency = digest_frequency;
-        userSettings.set(user_id, current);
+            updates.digest_frequency = digest_frequency;
+        if (digest_time !== undefined)
+            updates.digest_time = digest_time;
+        if (digest_timezone !== undefined)
+            updates.digest_timezone = digest_timezone;
+        if (agent_post_mode !== undefined)
+            updates.agent_post_mode = agent_post_mode;
+        if (auto_post_tags !== undefined)
+            updates.auto_post_tags = auto_post_tags;
+        if (agent_text_posts !== undefined)
+            updates.agent_text_posts = agent_text_posts;
+        if (agent_text_auto_post !== undefined)
+            updates.agent_text_auto_post = agent_text_auto_post;
+        // no fields to update — just show current settings
+        const hasUpdates = Object.keys(updates).length > 1; // more than just updated_at
+        if (!hasUpdates && current) {
+            return {
+                content: [{
+                        type: "text",
+                        text: `your current shout settings:\n\n` +
+                            `- auto-detect links: ${current.auto_detect_links}\n` +
+                            `- default visibility: ${current.default_visibility}\n` +
+                            `- digest: ${current.digest_frequency} at ${current.digest_time} (${current.digest_timezone})\n` +
+                            `- agent post mode: ${current.agent_post_mode}\n` +
+                            `- auto-post tags: ${(current.auto_post_tags || []).join(", ") || "none"}\n` +
+                            `- agent text posts: ${current.agent_text_posts}\n` +
+                            `- agent text auto-post: ${current.agent_text_auto_post}`,
+                    }],
+            };
+        }
+        if (current) {
+            // update existing
+            const { error } = await supabase
+                .from("user_settings")
+                .update(updates)
+                .eq("user_id", profile.id);
+            if (error) {
+                return {
+                    content: [{ type: "text", text: `error updating settings: ${error.message}` }],
+                };
+            }
+        }
+        else {
+            // insert new with defaults
+            const { error } = await supabase
+                .from("user_settings")
+                .insert({ user_id: profile.id, ...updates });
+            if (error) {
+                return {
+                    content: [{ type: "text", text: `error creating settings: ${error.message}` }],
+                };
+            }
+        }
+        // fetch final state
+        const { data: final } = await supabase
+            .from("user_settings")
+            .select("*")
+            .eq("user_id", profile.id)
+            .single();
+        if (!final) {
+            return {
+                content: [{ type: "text", text: `settings saved.` }],
+            };
+        }
         return {
-            content: [
-                {
+            content: [{
                     type: "text",
-                    text: `settings updated:\n- auto_detect: ${current.auto_detect}\n- default_visibility: ${current.default_visibility}\n- digest_frequency: ${current.digest_frequency}`,
-                },
-            ],
+                    text: `settings updated:\n\n` +
+                        `- auto-detect links: ${final.auto_detect_links}\n` +
+                        `- default visibility: ${final.default_visibility}\n` +
+                        `- digest: ${final.digest_frequency} at ${final.digest_time} (${final.digest_timezone})\n` +
+                        `- agent post mode: ${final.agent_post_mode}\n` +
+                        `- auto-post tags: ${(final.auto_post_tags || []).join(", ") || "none"}\n` +
+                        `- agent text posts: ${final.agent_text_posts}\n` +
+                        `- agent text auto-post: ${final.agent_text_auto_post}`,
+                }],
         };
     });
-    // shout_generate_digest is registered in links.ts
 }
 //# sourceMappingURL=settings.js.map

package/dist/tools/settings.js.map

@@ -1 +1 @@
-{"version":3,"file":"settings.js","sourceRoot":"","sources":["../../src/tools/settings.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,kCAAkC;AAClC,gDAAgD;AAChD,MAAM,YAAY,GAAyC,IAAI,GAAG,EAAE,CAAC;AAErE,MAAM,UAAU,qBAAqB,CAAC,MAAiB;IACrD,sCAAsC;IACtC,MAAM,CAAC,IAAI,CACT,gBAAgB,EAChB,4CAA4C,EAC5C;QACE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,eAAe,CAAC;QACpD,WAAW,EAAE,CAAC;aACX,OAAO,EAAE;aACT,QAAQ,EAAE;aACV,QAAQ,CAAC,mCAAmC,CAAC;QAChD,kBAAkB,EAAE,CAAC;aAClB,IAAI,CAAC,CAAC,QAAQ,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;aACvC,QAAQ,EAAE;aACV,QAAQ,CAAC,mCAAmC,CAAC;QAChD,gBAAgB,EAAE,CAAC;aAChB,IAAI,CAAC,CAAC,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;aAC7C,QAAQ,EAAE;aACV,QAAQ,CAAC,+BAA+B,CAAC;KAC7C,EACD,KAAK,EAAE,EAAE,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,EAAE,EAAE;QACvE,MAAM,OAAO,GAAG,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI;YAC3C,WAAW,EAAE,IAAI;YACjB,kBAAkB,EAAE,QAAQ;YAC5B,gBAAgB,EAAE,QAAQ;SAC3B,CAAC;QAEF,IAAI,WAAW,KAAK,SAAS;YAAE,OAAO,CAAC,WAAW,GAAG,WAAW,CAAC;QACjE,IAAI,kBAAkB,KAAK,SAAS;YAClC,OAAO,CAAC,kBAAkB,GAAG,kBAAkB,CAAC;QAClD,IAAI,gBAAgB,KAAK,SAAS;YAChC,OAAO,CAAC,gBAAgB,GAAG,gBAAgB,CAAC;QAE9C,YAAY,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAEnC,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,qCAAqC,OAAO,CAAC,WAAW,2BAA2B,OAAO,CAAC,kBAAkB,yBAAyB,OAAO,CAAC,gBAAgB,EAAE;iBACvK;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;IAEF,kDAAkD;AACpD,CAAC"}
+{"version":3,"file":"settings.js","sourceRoot":"","sources":["../../src/tools/settings.ts"],"names":[],"mappings":"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"}

package/dist/tools/text-posts.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerTextPostTools(server: McpServer): void;
+//# sourceMappingURL=text-posts.d.ts.map

package/dist/tools/text-posts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-posts.d.ts","sourceRoot":"","sources":["../../src/tools/text-posts.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIzE,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,QAwKtD"}

package/dist/tools/text-posts.js

@@ -0,0 +1,148 @@
+import { z } from "zod";
+import { supabase } from "../lib/supabase.js";
+import { filterShoutContentFull } from "../lib/content-filter.js";
+const USER_ID = process.env.NOD_USER_ID || "anonymous";
+export function registerTextPostTools(server) {
+    // draft_text_post - agent writes a text post about what's going on
+    server.tool("draft_text_post", "draft a text post (not a link share) for the user's shout page. these are status updates, observations, quick takes, or notes about what the user/agent has been working on. always drafts first — user approves before publishing unless they've enabled auto-post for text.", {
+        text: z.string().min(1).max(2000).describe("the post content. write in the agent's voice if it's the agent's page, or the user's voice if it's the user's page. be specific and interesting, not generic."),
+        tags: z.array(z.string()).optional().describe("tags for the post"),
+        category: z.string().optional().describe("category like 'building', 'reading', 'thinking', 'shipping'"),
+        collection_slug: z.string().optional().describe("collection to add this to"),
+    }, async ({ text, tags, category, collection_slug }) => {
+        const { data: profile } = await supabase
+            .from("profiles")
+            .select("id")
+            .eq("username", USER_ID)
+            .single();
+        if (!profile) {
+            return {
+                content: [{ type: "text", text: `no profile found for user ${USER_ID}.` }],
+            };
+        }
+        // check user settings for auto-post permission
+        const { data: settings } = await supabase
+            .from("user_settings")
+            .select("agent_text_auto_post, auto_post_tags")
+            .eq("user_id", profile.id)
+            .single();
+        // PII filter
+        const filtered = await filterShoutContentFull({ take: text, skipLLMForMetadata: true });
+        if (filtered.blocked) {
+            return {
+                content: [{ type: "text", text: `blocked by content filter: ${filtered.blockReason}` }],
+            };
+        }
+        const finalText = filtered.take || text;
+        // resolve collection
+        let collectionId = null;
+        if (collection_slug) {
+            const { data: col } = await supabase
+                .from("collections")
+                .select("id")
+                .eq("user_id", profile.id)
+                .eq("slug", collection_slug)
+                .single();
+            if (col)
+                collectionId = col.id;
+        }
+        // check if auto-post is enabled
+        const autoPost = settings?.agent_text_auto_post || false;
+        const autoTags = settings?.auto_post_tags || [];
+        const shouldAutoPost = autoPost || (tags && tags.some(t => autoTags.includes(t)));
+        if (shouldAutoPost) {
+            // auto-publish directly
+            const { data: shout, error } = await supabase
+                .from("shouts")
+                .insert({
+                user_id: profile.id,
+                url: null,
+                title: null,
+                description: finalText,
+                summary: finalText,
+                tags: tags || [],
+                category: category || "status",
+                collection_id: collectionId,
+                post_type: "text",
+                source: "agent",
+                visibility: "public",
+            })
+                .select()
+                .single();
+            if (error) {
+                return {
+                    content: [{ type: "text", text: `error publishing: ${error.message}` }],
+                };
+            }
+            return {
+                content: [{
+                        type: "text",
+                        text: `auto-published text post to your shout page:\n\n"${finalText}"\n\ntags: ${(tags || []).join(", ") || "none"}\nview: https://nodsocial.com/shout/${USER_ID}`,
+                    }],
+            };
+        }
+        // draft mode — save as draft for approval
+        const { data: draft, error } = await supabase
+            .from("draft_posts")
+            .insert({
+            user_id: profile.id,
+            text: finalText,
+            tags: tags || [],
+            category: category || "status",
+            collection_id: collectionId,
+            status: "pending",
+            post_type: "text",
+        })
+            .select()
+            .single();
+        if (error) {
+            return {
+                content: [{ type: "text", text: `error creating draft: ${error.message}` }],
+            };
+        }
+        return {
+            content: [{
+                    type: "text",
+                    text: `drafted a text post for your shout page:\n\n"${finalText}"\n\ntags: ${(tags || []).join(", ") || "none"}\n\nwant me to publish it? say "publish" or "edit" or "drop it".`,
+                }],
+        };
+    });
+    // agent_observe - agent logs an observation about the day for potential text post
+    server.tool("agent_observe", "log something interesting the agent noticed during conversation — a pattern, a milestone, a shift in what the user is working on. these observations can be turned into text posts later. use this throughout the day as you notice things worth noting.", {
+        observation: z.string().describe("what the agent noticed. be specific."),
+        mood: z.enum(["building", "shipping", "thinking", "learning", "debugging", "celebrating", "grinding"]).optional().describe("what kind of moment this is"),
+        could_post: z.boolean().default(true).describe("is this interesting enough to potentially post about?"),
+    }, async ({ observation, mood, could_post }) => {
+        const { data: profile } = await supabase
+            .from("profiles")
+            .select("id")
+            .eq("username", USER_ID)
+            .single();
+        if (!profile) {
+            return {
+                content: [{ type: "text", text: `no profile found for user ${USER_ID}.` }],
+            };
+        }
+        // store as a queued item with no url
+        const { error } = await supabase
+            .from("link_queue")
+            .insert({
+            user_id: profile.id,
+            url: `observation://${Date.now()}`,
+            title: mood ? `[${mood}] observation` : "observation",
+            context: observation,
+            agent_note: could_post ? "could make a good text post" : "just noting for context",
+            source: "conversation",
+            status: could_post ? "pending" : "dismissed",
+        });
+        if (error) {
+            return {
+                content: [{ type: "text", text: `error logging observation: ${error.message}` }],
+            };
+        }
+        return {
+            content: [{ type: "text", text: `noted${mood ? ` [${mood}]` : ""}: "${observation}"` }],
+        };
+    });
+}
+//# sourceMappingURL=text-posts.js.map

package/dist/tools/text-posts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-posts.js","sourceRoot":"","sources":["../../src/tools/text-posts.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nod-shout",
-  "version": "0.1.2",
+  "version": "0.2.0",
   "description": "mcp server for nod social - turn links into curated public pages",
   "type": "module",
   "main": "dist/index.js",

package/src/index.ts

@@ -5,6 +5,8 @@ import { registerCollectionTools } from "./tools/collections.js";
 import { registerSocialTools } from "./tools/social.js";
 import { registerSettingsTools } from "./tools/settings.js";
 import { registerPostTools } from "./tools/posts.js";
+import { registerLinkQueueTools } from "./tools/link-queue.js";
+import { registerTextPostTools } from "./tools/text-posts.js";
 // agent curate tool is registered inside registerLinkTools
 
 // accept username: npx nod-shout makaeel  OR  npx nod-shout --user makaeel
@@ -24,7 +26,7 @@ if (!process.env.NOD_USER_ID) {
 
 const server = new McpServer({
   name: "nod-shout",
-  version: "0.1.1",
+  version: "0.2.0",
 });
 
 // register all tools
@@ -33,6 +35,8 @@ registerCollectionTools(server);
 registerSocialTools(server);
 registerSettingsTools(server);
 registerPostTools(server);
+registerLinkQueueTools(server);
+registerTextPostTools(server);
 
 // start the server on stdio transport
 async function main() {

package/src/tools/link-queue.ts

@@ -0,0 +1,214 @@
+import { z } from "zod";
+import { supabase } from "../lib/supabase.js";
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+
+const USER_ID = process.env.NOD_USER_ID || "anonymous";
+
+export function registerLinkQueueTools(server: McpServer) {
+  // queue_link - agent spots a link in conversation and queues it for later
+  server.tool(
+    "queue_link",
+    "queue a link spotted in conversation for the user to review later. use this when a user shares or discusses a link but doesn't explicitly ask to shout it. the agent collects these throughout the day and prompts the user to review them later.",
+    {
+      url: z.string().url().describe("the url to queue"),
+      title: z.string().optional().describe("page title if known"),
+      context: z.string().optional().describe("what the user said about this link or why they shared it"),
+      agent_note: z.string().optional().describe("why the agent thinks this link is worth saving — be specific about what makes it interesting"),
+      source: z.enum(["conversation", "browsing", "research"]).default("conversation").describe("where the link came from"),
+    },
+    async ({ url, title, context, agent_note, source }) => {
+      // look up user
+      const { data: profile } = await supabase
+        .from("profiles")
+        .select("id")
+        .eq("username", USER_ID)
+        .single();
+
+      if (!profile) {
+        return {
+          content: [{ type: "text" as const, text: `no profile found for user ${USER_ID}. run get_profile first to set up.` }],
+        };
+      }
+
+      // check for duplicate url in pending queue
+      const { data: existing } = await supabase
+        .from("link_queue")
+        .select("id")
+        .eq("user_id", profile.id)
+        .eq("url", url)
+        .eq("status", "pending")
+        .single();
+
+      if (existing) {
+        return {
+          content: [{ type: "text" as const, text: `this link is already in the queue.` }],
+        };
+      }
+
+      const { data, error } = await supabase
+        .from("link_queue")
+        .insert({
+          user_id: profile.id,
+          url,
+          title: title || null,
+          context: context || null,
+          agent_note: agent_note || null,
+          source,
+        })
+        .select()
+        .single();
+
+      if (error) {
+        return {
+          content: [{ type: "text" as const, text: `error queuing link: ${error.message}` }],
+        };
+      }
+
+      return {
+        content: [{ type: "text" as const, text: `queued "${title || url}" for later review. i'll remind you to review your queued links later.` }],
+      };
+    }
+  );
+
+  // review_queue - show pending links for the user to approve/dismiss
+  server.tool(
+    "review_queue",
+    "show the user their pending queued links from today's conversations. use this to prompt them to shout, dismiss, or save links for later. call this at natural pauses in conversation or end of day.",
+    {
+      limit: z.number().min(1).max(50).default(10).describe("max links to show"),
+      since_hours: z.number().min(1).max(168).default(24).describe("show links from the last N hours"),
+    },
+    async ({ limit, since_hours }) => {
+      const { data: profile } = await supabase
+        .from("profiles")
+        .select("id")
+        .eq("username", USER_ID)
+        .single();
+
+      if (!profile) {
+        return {
+          content: [{ type: "text" as const, text: `no profile found for user ${USER_ID}.` }],
+        };
+      }
+
+      const since = new Date(Date.now() - since_hours * 60 * 60 * 1000).toISOString();
+
+      const { data: links, error } = await supabase
+        .from("link_queue")
+        .select("*")
+        .eq("user_id", profile.id)
+        .eq("status", "pending")
+        .gte("spotted_at", since)
+        .order("spotted_at", { ascending: false })
+        .limit(limit);
+
+      if (error) {
+        return {
+          content: [{ type: "text" as const, text: `error fetching queue: ${error.message}` }],
+        };
+      }
+
+      if (!links || links.length === 0) {
+        return {
+          content: [{ type: "text" as const, text: `no pending links in the queue. all caught up!` }],
+        };
+      }
+
+      const summary = links.map((l, i) => {
+        let line = `${i + 1}. ${l.title || l.url}`;
+        if (l.title) line += `\n   ${l.url}`;
+        if (l.context) line += `\n   you said: "${l.context}"`;
+        if (l.agent_note) line += `\n   why it's interesting: ${l.agent_note}`;
+        line += `\n   spotted: ${new Date(l.spotted_at).toLocaleString()}`;
+        line += `\n   id: ${l.id}`;
+        return line;
+      }).join("\n\n");
+
+      return {
+        content: [{
+          type: "text" as const,
+          text: `you have ${links.length} link${links.length === 1 ? "" : "s"} from the last ${since_hours} hours:\n\n${summary}\n\nwant to shout any of these? you can say "shout #1" or "dismiss #3" or "shout all".`,
+        }],
+      };
+    }
+  );
+
+  // resolve_queue_item - mark a queued link as shouted or dismissed
+  server.tool(
+    "resolve_queue_item",
+    "mark a queued link as shouted or dismissed. use after the user decides what to do with a queued link.",
+    {
+      queue_id: z.string().uuid().describe("the queue item id"),
+      action: z.enum(["shouted", "dismissed"]).describe("what happened to the link"),
+    },
+    async ({ queue_id, action }) => {
+      const { error } = await supabase
+        .from("link_queue")
+        .update({
+          status: action,
+          resolved_at: new Date().toISOString(),
+        })
+        .eq("id", queue_id);
+
+      if (error) {
+        return {
+          content: [{ type: "text" as const, text: `error updating queue item: ${error.message}` }],
+        };
+      }
+
+      return {
+        content: [{ type: "text" as const, text: `link ${action}.` }],
+      };
+    }
+  );
+
+  // queue_stats - quick summary of queue activity
+  server.tool(
+    "queue_stats",
+    "get a quick summary of queued links — how many pending, shouted today, dismissed.",
+    {},
+    async () => {
+      const { data: profile } = await supabase
+        .from("profiles")
+        .select("id")
+        .eq("username", USER_ID)
+        .single();
+
+      if (!profile) {
+        return {
+          content: [{ type: "text" as const, text: `no profile found for user ${USER_ID}.` }],
+        };
+      }
+
+      const today = new Date();
+      today.setHours(0, 0, 0, 0);
+
+      const { data: pending } = await supabase
+        .from("link_queue")
+        .select("id", { count: "exact" })
+        .eq("user_id", profile.id)
+        .eq("status", "pending");
+
+      const { data: shoutedToday } = await supabase
+        .from("link_queue")
+        .select("id", { count: "exact" })
+        .eq("user_id", profile.id)
+        .eq("status", "shouted")
+        .gte("resolved_at", today.toISOString());
+
+      const { data: dismissedToday } = await supabase
+        .from("link_queue")
+        .select("id", { count: "exact" })
+        .eq("user_id", profile.id)
+        .eq("status", "dismissed")
+        .gte("resolved_at", today.toISOString());
+
+      return {
+        content: [{
+          type: "text" as const,
+          text: `queue stats:\n- pending: ${pending?.length || 0}\n- shouted today: ${shoutedToday?.length || 0}\n- dismissed today: ${dismissedToday?.length || 0}`,
+        }],
+      };
+    }
+  );
+}

package/src/tools/settings.ts

@@ -1,55 +1,127 @@
 import { z } from "zod";
+import { supabase } from "../lib/supabase.js";
 import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 
-// in-memory settings store for v1
-// TODO: persist to supabase user_settings table
-const userSettings: Map<string, Record<string, unknown>> = new Map();
+const USER_ID = process.env.NOD_USER_ID || "anonymous";
 
 export function registerSettingsTools(server: McpServer) {
-  // shout_settings - configure behavior
+  // shout_settings - configure behavior (now persisted to supabase)
   server.tool(
     "shout_settings",
-    "configure your shout behavior preferences.",
+    "view or update your shout preferences — link detection, digest schedule, agent posting permissions, auto-post rules.",
     {
-      user_id: z.string().uuid().describe("the user's id"),
-      auto_detect: z
-        .boolean()
-        .optional()
-        .describe("auto-detect links in conversation"),
-      default_visibility: z
-        .enum(["public", "private", "unlisted"])
-        .optional()
-        .describe("default visibility for new shouts"),
-      digest_frequency: z
-        .enum(["daily", "weekly", "monthly", "never"])
-        .optional()
-        .describe("how often to generate digests"),
+      auto_detect_links: z.boolean().optional().describe("should the agent auto-detect links in conversation and queue them?"),
+      default_visibility: z.enum(["public", "private", "unlisted"]).optional().describe("default visibility for new shouts"),
+      digest_frequency: z.enum(["daily", "weekly", "never"]).optional().describe("how often to prompt you to review queued links"),
+      digest_time: z.string().optional().describe("preferred time for daily digest prompt (HH:MM format, e.g. '20:00')"),
+      digest_timezone: z.string().optional().describe("your timezone (e.g. 'America/New_York')"),
+      agent_post_mode: z.enum(["ask", "auto", "curated"]).optional().describe("'ask' = agent always asks before posting. 'auto' = agent posts freely. 'curated' = auto-post for certain tags, ask for others."),
+      auto_post_tags: z.array(z.string()).optional().describe("when agent_post_mode is 'curated', auto-post for these tags without asking"),
+      agent_text_posts: z.boolean().optional().describe("can the agent draft text posts (status updates, observations)?"),
+      agent_text_auto_post: z.boolean().optional().describe("can the agent auto-publish text posts without asking?"),
     },
-    async ({ user_id, auto_detect, default_visibility, digest_frequency }) => {
-      const current = userSettings.get(user_id) || {
-        auto_detect: true,
-        default_visibility: "public",
-        digest_frequency: "weekly",
-      };
+    async ({ auto_detect_links, default_visibility, digest_frequency, digest_time, digest_timezone, agent_post_mode, auto_post_tags, agent_text_posts, agent_text_auto_post }) => {
+      // look up user
+      const { data: profile } = await supabase
+        .from("profiles")
+        .select("id")
+        .eq("username", USER_ID)
+        .single();
 
-      if (auto_detect !== undefined) current.auto_detect = auto_detect;
-      if (default_visibility !== undefined)
-        current.default_visibility = default_visibility;
-      if (digest_frequency !== undefined)
-        current.digest_frequency = digest_frequency;
+      if (!profile) {
+        return {
+          content: [{ type: "text" as const, text: `no profile found for user ${USER_ID}.` }],
+        };
+      }
 
-      userSettings.set(user_id, current);
+      // get current settings or create defaults
+      const { data: current } = await supabase
+        .from("user_settings")
+        .select("*")
+        .eq("user_id", profile.id)
+        .single();
 
-      return {
-        content: [
-          {
+      const updates: Record<string, unknown> = { updated_at: new Date().toISOString() };
+      if (auto_detect_links !== undefined) updates.auto_detect_links = auto_detect_links;
+      if (default_visibility !== undefined) updates.default_visibility = default_visibility;
+      if (digest_frequency !== undefined) updates.digest_frequency = digest_frequency;
+      if (digest_time !== undefined) updates.digest_time = digest_time;
+      if (digest_timezone !== undefined) updates.digest_timezone = digest_timezone;
+      if (agent_post_mode !== undefined) updates.agent_post_mode = agent_post_mode;
+      if (auto_post_tags !== undefined) updates.auto_post_tags = auto_post_tags;
+      if (agent_text_posts !== undefined) updates.agent_text_posts = agent_text_posts;
+      if (agent_text_auto_post !== undefined) updates.agent_text_auto_post = agent_text_auto_post;
+
+      // no fields to update — just show current settings
+      const hasUpdates = Object.keys(updates).length > 1; // more than just updated_at
+
+      if (!hasUpdates && current) {
+        return {
+          content: [{
             type: "text" as const,
-            text: `settings updated:\n- auto_detect: ${current.auto_detect}\n- default_visibility: ${current.default_visibility}\n- digest_frequency: ${current.digest_frequency}`,
-          },
-        ],
+            text: `your current shout settings:\n\n` +
+              `- auto-detect links: ${current.auto_detect_links}\n` +
+              `- default visibility: ${current.default_visibility}\n` +
+              `- digest: ${current.digest_frequency} at ${current.digest_time} (${current.digest_timezone})\n` +
+              `- agent post mode: ${current.agent_post_mode}\n` +
+              `- auto-post tags: ${(current.auto_post_tags || []).join(", ") || "none"}\n` +
+              `- agent text posts: ${current.agent_text_posts}\n` +
+              `- agent text auto-post: ${current.agent_text_auto_post}`,
+          }],
+        };
+      }
+
+      if (current) {
+        // update existing
+        const { error } = await supabase
+          .from("user_settings")
+          .update(updates)
+          .eq("user_id", profile.id);
+
+        if (error) {
+          return {
+            content: [{ type: "text" as const, text: `error updating settings: ${error.message}` }],
+          };
+        }
+      } else {
+        // insert new with defaults
+        const { error } = await supabase
+          .from("user_settings")
+          .insert({ user_id: profile.id, ...updates });
+
+        if (error) {
+          return {
+            content: [{ type: "text" as const, text: `error creating settings: ${error.message}` }],
+          };
+        }
+      }
+
+      // fetch final state
+      const { data: final } = await supabase
+        .from("user_settings")
+        .select("*")
+        .eq("user_id", profile.id)
+        .single();
+
+      if (!final) {
+        return {
+          content: [{ type: "text" as const, text: `settings saved.` }],
+        };
+      }
+
+      return {
+        content: [{
+          type: "text" as const,
+          text: `settings updated:\n\n` +
+            `- auto-detect links: ${final.auto_detect_links}\n` +
+            `- default visibility: ${final.default_visibility}\n` +
+            `- digest: ${final.digest_frequency} at ${final.digest_time} (${final.digest_timezone})\n` +
+            `- agent post mode: ${final.agent_post_mode}\n` +
+            `- auto-post tags: ${(final.auto_post_tags || []).join(", ") || "none"}\n` +
+            `- agent text posts: ${final.agent_text_posts}\n` +
+            `- agent text auto-post: ${final.agent_text_auto_post}`,
+        }],
       };
     }
   );
-
-  // shout_generate_digest is registered in links.ts
 }

package/src/tools/text-posts.ts

@@ -0,0 +1,176 @@
+import { z } from "zod";
+import { supabase } from "../lib/supabase.js";
+import { filterPII, filterShoutContentFull } from "../lib/content-filter.js";
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+
+const USER_ID = process.env.NOD_USER_ID || "anonymous";
+
+export function registerTextPostTools(server: McpServer) {
+  // draft_text_post - agent writes a text post about what's going on
+  server.tool(
+    "draft_text_post",
+    "draft a text post (not a link share) for the user's shout page. these are status updates, observations, quick takes, or notes about what the user/agent has been working on. always drafts first — user approves before publishing unless they've enabled auto-post for text.",
+    {
+      text: z.string().min(1).max(2000).describe("the post content. write in the agent's voice if it's the agent's page, or the user's voice if it's the user's page. be specific and interesting, not generic."),
+      tags: z.array(z.string()).optional().describe("tags for the post"),
+      category: z.string().optional().describe("category like 'building', 'reading', 'thinking', 'shipping'"),
+      collection_slug: z.string().optional().describe("collection to add this to"),
+    },
+    async ({ text, tags, category, collection_slug }) => {
+      const { data: profile } = await supabase
+        .from("profiles")
+        .select("id")
+        .eq("username", USER_ID)
+        .single();
+
+      if (!profile) {
+        return {
+          content: [{ type: "text" as const, text: `no profile found for user ${USER_ID}.` }],
+        };
+      }
+
+      // check user settings for auto-post permission
+      const { data: settings } = await supabase
+        .from("user_settings")
+        .select("agent_text_auto_post, auto_post_tags")
+        .eq("user_id", profile.id)
+        .single();
+
+      // PII filter
+      const filtered = await filterShoutContentFull({ take: text, skipLLMForMetadata: true });
+      if (filtered.blocked) {
+        return {
+          content: [{ type: "text" as const, text: `blocked by content filter: ${filtered.blockReason}` }],
+        };
+      }
+
+      const finalText = filtered.take || text;
+
+      // resolve collection
+      let collectionId: string | null = null;
+      if (collection_slug) {
+        const { data: col } = await supabase
+          .from("collections")
+          .select("id")
+          .eq("user_id", profile.id)
+          .eq("slug", collection_slug)
+          .single();
+        if (col) collectionId = col.id;
+      }
+
+      // check if auto-post is enabled
+      const autoPost = settings?.agent_text_auto_post || false;
+      const autoTags = settings?.auto_post_tags || [];
+      const shouldAutoPost = autoPost || (tags && tags.some(t => autoTags.includes(t)));
+
+      if (shouldAutoPost) {
+        // auto-publish directly
+        const { data: shout, error } = await supabase
+          .from("shouts")
+          .insert({
+            user_id: profile.id,
+            url: null,
+            title: null,
+            description: finalText,
+            summary: finalText,
+            tags: tags || [],
+            category: category || "status",
+            collection_id: collectionId,
+            post_type: "text",
+            source: "agent",
+            visibility: "public",
+          })
+          .select()
+          .single();
+
+        if (error) {
+          return {
+            content: [{ type: "text" as const, text: `error publishing: ${error.message}` }],
+          };
+        }
+
+        return {
+          content: [{
+            type: "text" as const,
+            text: `auto-published text post to your shout page:\n\n"${finalText}"\n\ntags: ${(tags || []).join(", ") || "none"}\nview: https://nodsocial.com/shout/${USER_ID}`,
+          }],
+        };
+      }
+
+      // draft mode — save as draft for approval
+      const { data: draft, error } = await supabase
+        .from("draft_posts")
+        .insert({
+          user_id: profile.id,
+          text: finalText,
+          tags: tags || [],
+          category: category || "status",
+          collection_id: collectionId,
+          status: "pending",
+          post_type: "text",
+        })
+        .select()
+        .single();
+
+      if (error) {
+        return {
+          content: [{ type: "text" as const, text: `error creating draft: ${error.message}` }],
+        };
+      }
+
+      return {
+        content: [{
+          type: "text" as const,
+          text: `drafted a text post for your shout page:\n\n"${finalText}"\n\ntags: ${(tags || []).join(", ") || "none"}\n\nwant me to publish it? say "publish" or "edit" or "drop it".`,
+        }],
+      };
+    }
+  );
+
+  // agent_observe - agent logs an observation about the day for potential text post
+  server.tool(
+    "agent_observe",
+    "log something interesting the agent noticed during conversation — a pattern, a milestone, a shift in what the user is working on. these observations can be turned into text posts later. use this throughout the day as you notice things worth noting.",
+    {
+      observation: z.string().describe("what the agent noticed. be specific."),
+      mood: z.enum(["building", "shipping", "thinking", "learning", "debugging", "celebrating", "grinding"]).optional().describe("what kind of moment this is"),
+      could_post: z.boolean().default(true).describe("is this interesting enough to potentially post about?"),
+    },
+    async ({ observation, mood, could_post }) => {
+      const { data: profile } = await supabase
+        .from("profiles")
+        .select("id")
+        .eq("username", USER_ID)
+        .single();
+
+      if (!profile) {
+        return {
+          content: [{ type: "text" as const, text: `no profile found for user ${USER_ID}.` }],
+        };
+      }
+
+      // store as a queued item with no url
+      const { error } = await supabase
+        .from("link_queue")
+        .insert({
+          user_id: profile.id,
+          url: `observation://${Date.now()}`,
+          title: mood ? `[${mood}] observation` : "observation",
+          context: observation,
+          agent_note: could_post ? "could make a good text post" : "just noting for context",
+          source: "conversation",
+          status: could_post ? "pending" : "dismissed",
+        });
+
+      if (error) {
+        return {
+          content: [{ type: "text" as const, text: `error logging observation: ${error.message}` }],
+        };
+      }
+
+      return {
+        content: [{ type: "text" as const, text: `noted${mood ? ` [${mood}]` : ""}: "${observation}"` }],
+      };
+    }
+  );
+}

package/supabase/migrations/20260320200000_proactive_shout.sql

@@ -0,0 +1,48 @@
+-- proactive shout features: link queue, text posts, permission tiers
+
+-- link_queue: links spotted in conversation, not yet shouted
+create table if not exists link_queue (
+  id uuid primary key default gen_random_uuid(),
+  user_id uuid not null references profiles(id) on delete cascade,
+  url text not null,
+  title text,
+  context text,  -- what the user said when sharing
+  source text default 'conversation',  -- conversation, browsing, research
+  agent_note text,  -- why the agent thinks this is interesting
+  status text default 'pending' check (status in ('pending', 'shouted', 'dismissed', 'expired')),
+  spotted_at timestamptz default now(),
+  resolved_at timestamptz
+);
+
+create index if not exists idx_link_queue_user_status on link_queue(user_id, status);
+create index if not exists idx_link_queue_spotted on link_queue(spotted_at);
+
+-- text_posts: agent-authored status updates (not link shares)
+-- these go through draft_posts table which already exists
+-- adding post_type to distinguish link shouts from text posts
+alter table shouts add column if not exists post_type text default 'link' check (post_type in ('link', 'text', 'status'));
+
+-- user_settings: persisted settings (replacing in-memory store)
+create table if not exists user_settings (
+  user_id uuid primary key references profiles(id) on delete cascade,
+  auto_detect_links boolean default true,
+  default_visibility text default 'public' check (default_visibility in ('public', 'private', 'unlisted')),
+  digest_frequency text default 'daily' check (digest_frequency in ('daily', 'weekly', 'never')),
+  digest_time text default '20:00',  -- preferred time for daily digest (HH:MM in user's tz)
+  digest_timezone text default 'America/New_York',
+  
+  -- permission tiers for agent posting
+  agent_post_mode text default 'ask' check (agent_post_mode in ('ask', 'auto', 'curated')),
+  -- for 'curated' mode: auto-post for these tags, ask for everything else
+  auto_post_tags text[] default '{}',
+  
+  -- text post permissions (separate from link shouts)
+  agent_text_posts boolean default true,  -- can agent draft text posts?
+  agent_text_auto_post boolean default false,  -- can agent auto-publish text posts?
+  
+  created_at timestamptz default now(),
+  updated_at timestamptz default now()
+);
+
+-- add post_type to draft_posts if it exists
+alter table draft_posts add column if not exists post_type text default 'link' check (post_type in ('link', 'text', 'status'));