openalmanac 0.2.31 → 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/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.31",
+  "version": "0.2.32",
   "description": "OpenAlmanac — pull, edit, and push articles to the open knowledge base",
   "type": "module",
   "bin": {