openalmanac 0.2.30 → 0.2.32

package/dist/auth.js

@@ -42,13 +42,13 @@ export async function getAuthStatus() {
     if (!key)
         return { loggedIn: false };
     try {
-        const resp = await fetch(`${API_BASE}/api/agents/me`, {
+        const resp = await fetch(`${API_BASE}/api/users/me`, {
             headers: { Authorization: `Bearer ${key}` },
             signal: AbortSignal.timeout(10_000),
         });
         if (resp.ok) {
             const data = (await resp.json());
-            return { loggedIn: true, name: data.name ?? "unknown" };
+            return { loggedIn: true, name: data.display_name ?? data.username ?? "unknown" };
         }
     }
     catch {

package/dist/login-core.js

@@ -7,7 +7,7 @@ function callbackPage(success) {
     // These values are hardcoded — never interpolate user input here.
     const title = success ? "You\u2019re connected" : "Something went wrong";
     const messageLine1 = success
-        ? "Your agent is registered and ready to go."
+        ? "Your account is connected and a personal API key is ready to go."
         : "Invalid token. Please return to your terminal and try again.";
     const messageLine2 = success
         ? "You can close this tab and return to your terminal."
@@ -160,13 +160,13 @@ export async function performLogin(options) {
         const existingKey = getApiKey();
         if (existingKey) {
             try {
-                const resp = await fetch(`${API_BASE}/api/agents/me`, {
+                const resp = await fetch(`${API_BASE}/api/users/me`, {
                     headers: { Authorization: `Bearer ${existingKey}` },
                     signal: AbortSignal.timeout(10_000),
                 });
                 if (resp.ok) {
                     const data = (await resp.json());
-                    return { status: "already_logged_in", name: data.name ?? "unknown" };
+                    return { status: "already_logged_in", name: data.display_name ?? data.username ?? "unknown" };
                 }
             }
             catch {

package/dist/login.js

@@ -6,7 +6,7 @@ export async function runLogin() {
         console.log(`Already logged in as ${result.name}.`);
     }
     else {
-        console.log("Logged in. Your agent is registered and contributions will be attributed to your account.");
+        console.log("Logged in. A personal API key was created for this installation and contributions will be attributed to your account.");
     }
 }
 export async function runLogout() {

package/dist/server.js

@@ -124,7 +124,7 @@ export function createServer() {
             "",
             "## Technical workflow",
             "",
-            "Reading and searching articles is open. Writing requires an API key (from login). Login registers an agent linked to your human user, so contributions are attributed to both.",
+            "Reading and searching articles is open. Writing requires an API key (from login). Login creates a personal API key linked to your user account, so contributions are attributed to you.",
             "",
             "Core flow: login (once) → search_articles (check if exists) → search_web + read_webpage (research) → new (scaffold) or download (existing) → edit ~/.openalmanac/articles/{slug}.md → publish (validate & publish).",
             "",

package/dist/tools/articles.js

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import { readFileSync, writeFileSync, mkdirSync, readdirSync, statSync, existsSync } from "node:fs";
+import { readFileSync, writeFileSync, mkdirSync, readdirSync, statSync, existsSync, unlinkSync } from "node:fs";
 import { join } from "node:path";
 import { stringify as yamlStringify } from "yaml";
 import { request, ARTICLES_DIR, getAuthStatus } from "../auth.js";
@@ -206,6 +206,9 @@ export function registerArticleTools(server) {
             slug: z.string().describe("Article slug (e.g. 'machine-learning')"),
         }),
         async execute({ slug }) {
+            if (!SLUG_RE.test(slug)) {
+                throw new Error(`Invalid slug "${slug}". Must be kebab-case (e.g. 'machine-learning').`);
+            }
             const resp = await request("GET", `/api/articles/${slug}`, {
                 params: { format: "md" },
             });
@@ -213,6 +216,8 @@ export function registerArticleTools(server) {
             ensureArticlesDir();
             const filePath = join(ARTICLES_DIR, `${slug}.md`);
             writeFileSync(filePath, markdown, "utf-8");
+            const originalPath = join(ARTICLES_DIR, `.${slug}.original.md`);
+            writeFileSync(originalPath, markdown, "utf-8");
             const { frontmatter, content } = parseFrontmatter(markdown);
             const title = frontmatter.title || "(untitled)";
             const wordCount = content.trim().split(/\s+/).filter(Boolean).length;
@@ -260,6 +265,9 @@ export function registerArticleTools(server) {
             change_description: z.string().optional().describe("Longer description of what changed and why"),
         }),
         async execute({ slug, change_title, change_description }) {
+            if (!SLUG_RE.test(slug)) {
+                throw new Error(`Invalid slug "${slug}". Must be kebab-case (e.g. 'machine-learning').`);
+            }
             const filePath = join(ARTICLES_DIR, `${slug}.md`);
             let raw;
             try {
@@ -293,7 +301,25 @@ export function registerArticleTools(server) {
             const data = (await resp.json());
             const articleUrl = `https://www.openalmanac.org/article/${slug}?celebrate=true`;
             openBrowser(articleUrl);
-            return `Pushed successfully.\n\nArticle URL (share this exact link with the user): ${articleUrl}\n\n${JSON.stringify(data, null, 2)}`;
+            // Clean up local files after successful publish
+            let cleanupWarning = "";
+            try {
+                unlinkSync(filePath);
+            }
+            catch (e) {
+                if (e.code !== "ENOENT") {
+                    cleanupWarning = `\nNote: could not remove local draft: ${e.message}`;
+                }
+            }
+            try {
+                unlinkSync(join(ARTICLES_DIR, `.${slug}.original.md`));
+            }
+            catch (e) {
+                if (e.code !== "ENOENT") {
+                    cleanupWarning += `\nNote: could not remove original copy: ${e.message}`;
+                }
+            }
+            return `Pushed successfully.\n\nArticle URL (share this exact link with the user): ${articleUrl}${cleanupWarning}\n\n${JSON.stringify(data, null, 2)}`;
         },
     });
     server.addTool({
@@ -352,7 +378,7 @@ export function registerArticleTools(server) {
             const authLine = auth.loggedIn
                 ? `Logged in as ${auth.name}.`
                 : "Not logged in. Use login to authenticate.";
-            const files = readdirSync(ARTICLES_DIR).filter((f) => f.endsWith(".md"));
+            const files = readdirSync(ARTICLES_DIR).filter((f) => f.endsWith(".md") && !f.startsWith("."));
             if (files.length === 0) {
                 return `${authLine}\n\nLocal articles (0 files in ${ARTICLES_DIR}):\n  (none — use download or new to get started)`;
             }

package/dist/tools/auth.js

@@ -3,7 +3,7 @@ import { performLogin } from "../login-core.js";
 export function registerAuthTools(server) {
     server.addTool({
         name: "login",
-        description: "Log in via browser to register an agent and get an API key. This is the required " +
+        description: "Log in via browser to connect your account and get a personal API key. This is the required " +
             "first step before creating or updating articles. Only needs to be called once.\n\n" +
             "If you already have a valid API key, this returns immediately without opening a browser.",
         async execute() {
@@ -11,7 +11,7 @@ export function registerAuthTools(server) {
             if (result.status === "already_logged_in") {
                 return `Already logged in as ${result.name}.`;
             }
-            return "Logged in. Your agent is registered and contributions will be attributed to your account.";
+            return "Logged in. A personal API key was created for this installation and contributions will be attributed to your account.";
         },
     });
     server.addTool({

package/dist/tools/research.js

@@ -112,4 +112,20 @@ export function registerResearchTools(server) {
             return { content };
         },
     });
+    server.addTool({
+        name: "register_sources",
+        description: "Register sources you plan to cite in your response. Call this BEFORE writing your response text. " +
+            "Each source becomes a clickable citation bubble when you use [@key] markers in your text. " +
+            "Collect sources from your read_webpage calls and any subagent results, then register them all in one call.",
+        parameters: z.object({
+            sources: z.array(z.object({
+                key: z.string().describe("Citation key — kebab-case, BibTeX-style: {domain}-{title-words} (e.g. 'nytimes-climate-report')"),
+                url: z.string().describe("Source URL"),
+                title: z.string().describe("Source title — include publication name after em dash (e.g. 'Climate Report — The New York Times')"),
+            })).min(1).describe("Sources to register for citation"),
+        }),
+        async execute({ sources }) {
+            return `Registered ${sources.length} source${sources.length === 1 ? "" : "s"}. Use [@key] markers in your response to cite them.`;
+        },
+    });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openalmanac",
-  "version": "0.2.30",
+  "version": "0.2.32",
   "description": "OpenAlmanac — pull, edit, and push articles to the open knowledge base",
   "type": "module",
   "bin": {