memax-cli 0.1.0-alpha.4 → 0.1.0-alpha.40

package/dist/commands/topic.test.js

@@ -0,0 +1,114 @@
+import { describe, expect, it } from "vitest";
+import { buildTopicPathMap, flattenTopics, resolveTopicReference, topicDisplayCount, topicDisplayID, } from "./topic.js";
+describe("topicDisplayCount", () => {
+    it("prefers subtree totals over direct counts", () => {
+        expect(topicDisplayCount({ memory_count: 0, total_memory_count: 7 })).toBe(7);
+    });
+    it("falls back to direct count when subtree total is zero", () => {
+        expect(topicDisplayCount({ memory_count: 3, total_memory_count: 0 })).toBe(0);
+    });
+});
+describe("buildTopicPathMap", () => {
+    it("builds slash-delimited topic paths from the tree", () => {
+        const map = buildTopicPathMap([
+            {
+                id: "root",
+                owner_id: "u1",
+                hub_id: "h1",
+                parent_id: null,
+                name: "Engineering",
+                description: "",
+                icon: "folder",
+                position: 0,
+                pinned: false,
+                user_modified: false,
+                created_at: "",
+                updated_at: "",
+                memory_count: 1,
+                total_memory_count: 2,
+                category_dots: [],
+                children: [
+                    {
+                        id: "child",
+                        owner_id: "u1",
+                        hub_id: "h1",
+                        parent_id: "root",
+                        name: "Caching",
+                        description: "",
+                        icon: "folder",
+                        position: 0,
+                        pinned: false,
+                        user_modified: false,
+                        created_at: "",
+                        updated_at: "",
+                        memory_count: 1,
+                        total_memory_count: 1,
+                        category_dots: [],
+                        children: [],
+                    },
+                ],
+            },
+        ]);
+        expect(map.get("root")).toBe("Engineering");
+        expect(map.get("child")).toBe("Engineering / Caching");
+    });
+});
+describe("topicDisplayID", () => {
+    it("shortens IDs by default", () => {
+        expect(topicDisplayID("12345678-1234-1234-1234-123456789abc")).toBe("12345678");
+    });
+    it("shows full IDs in verbose mode", () => {
+        expect(topicDisplayID("12345678-1234-1234-1234-123456789abc", true)).toBe("12345678-1234-1234-1234-123456789abc");
+    });
+});
+describe("resolveTopicReference", () => {
+    const topics = [
+        {
+            id: "12345678-1234-1234-1234-123456789abc",
+            owner_id: "u1",
+            hub_id: "h1",
+            parent_id: null,
+            name: "Engineering",
+            description: "",
+            icon: "folder",
+            position: 0,
+            pinned: false,
+            user_modified: false,
+            created_at: "",
+            updated_at: "",
+            memory_count: 1,
+            total_memory_count: 2,
+            category_dots: [],
+            children: [
+                {
+                    id: "abcdef12-1234-1234-1234-123456789abc",
+                    owner_id: "u1",
+                    hub_id: "h1",
+                    parent_id: "12345678-1234-1234-1234-123456789abc",
+                    name: "Caching",
+                    description: "",
+                    icon: "folder",
+                    position: 0,
+                    pinned: false,
+                    user_modified: false,
+                    created_at: "",
+                    updated_at: "",
+                    memory_count: 1,
+                    total_memory_count: 1,
+                    category_dots: [],
+                    children: [],
+                },
+            ],
+        },
+    ];
+    it("resolves exact IDs", () => {
+        expect(resolveTopicReference(topics, "12345678-1234-1234-1234-123456789abc")).toBe("12345678-1234-1234-1234-123456789abc");
+    });
+    it("resolves unique ID prefixes", () => {
+        expect(resolveTopicReference(topics, "abcdef12")).toBe("abcdef12-1234-1234-1234-123456789abc");
+    });
+    it("flattens nested topics for resolution", () => {
+        expect(flattenTopics(topics)).toHaveLength(2);
+    });
+});
+//# sourceMappingURL=topic.test.js.map

package/dist/commands/topic.test.js.map

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

package/dist/index.js

@@ -3,18 +3,23 @@ import { Command } from "commander";
 import { readFileSync } from "node:fs";
 import { fileURLToPath } from "node:url";
 import { join, dirname } from "node:path";
-import { pushCommand } from "./commands/push.js";
-import { recallCommand } from "./commands/recall.js";
-import { listCommand } from "./commands/list.js";
-import { showCommand } from "./commands/show.js";
-import { deleteCommand } from "./commands/delete.js";
-import { syncCommand, syncAgentMemoryCommand } from "./commands/sync.js";
-import { hookCommand } from "./commands/hook.js";
-import { configGetCommand, configSetCommand } from "./commands/config.js";
-import { loginCommand, logoutCommand, whoamiCommand, } from "./commands/login.js";
-import { createKeyCommand, listKeysCommand, revokeKeyCommand, } from "./commands/auth.js";
+import { registerPushCommand } from "./commands/push.js";
+import { registerRecallCommand } from "./commands/recall.js";
+import { registerListCommand } from "./commands/list.js";
+import { registerShowCommand } from "./commands/show.js";
+import { registerDeleteCommand } from "./commands/delete.js";
+import { registerSyncCommands } from "./commands/sync.js";
+import { registerAgentsCommands } from "./commands/agents.js";
+import { registerHookCommand } from "./commands/hook.js";
+import { registerConfigCommand } from "./commands/config.js";
+import { registerLoginCommands } from "./commands/login.js";
+import { registerAuthCommand } from "./commands/auth.js";
 import { registerMcpCommand } from "./commands/mcp.js";
-import { setupCommand, teardownCommand } from "./commands/setup.js";
+import { registerSetupCommands } from "./commands/setup.js";
+import { registerHubCommands } from "./commands/hub.js";
+import { registerTopicCommands } from "./commands/topic.js";
+import { registerCaptureSessionCommand } from "./commands/capture.js";
+import { registerDreamsCommands } from "./commands/dreams.js";
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const pkg = JSON.parse(readFileSync(join(__dirname, "..", "package.json"), "utf-8"));
 const program = new Command();
@@ -22,120 +27,23 @@ program
     .name("memax")
     .description("Universal context & memory hub for AI agents")
     .version(pkg.version);
-// --- Core commands ---
-program
-    .command("push")
-    .description("Save knowledge to your Memax workspace")
-    .option("-f, --file <path>", "File to push")
-    .option("-c, --category <category>", "Category (auto-detected if omitted)")
-    .option("-t, --tags <tags>", "Comma-separated tags")
-    .option("--title <title>", "Note title")
-    .option("--ttl <duration>", "Auto-archive after duration (e.g., 7d, 30d)")
-    .option("--stdin", "Read content from stdin")
-    .action(pushCommand);
-program
-    .command("recall [query]")
-    .description("Ask your knowledge a question")
-    .option("-c, --category <category>", "Filter by category")
-    .option("-t, --tags <tags>", "Filter by tags")
-    .option("-l, --limit <n>", "Max results", "5")
-    .option("--format <format>", "Output format: text, json", "text")
-    .option("--hook", "Output in agent-injectable format")
-    .option("--max-tokens <number>", "Maximum tokens to output (approximate)")
-    .option("--include-archived", "Include archived notes")
-    .action(recallCommand);
-program
-    .command("list")
-    .description("List your knowledge notes")
-    .option("-c, --category <category>", "Filter by category")
-    .option("--state <state>", "Filter by state: active, cooling, archived")
-    .option("-l, --limit <n>", "Max results", "20")
-    .action(listCommand);
-program
-    .command("show <id>")
-    .description("Show a specific note")
-    .action(showCommand);
-program
-    .command("delete <id>")
-    .description("Delete a note")
-    .option("--confirm", "Skip confirmation")
-    .action(deleteCommand);
-// --- Sync ---
-const syncCmd = program
-    .command("sync [directory]")
-    .description("Sync a directory or agent memory to your Memax workspace")
-    .option("-w, --watch", "Watch for changes (coming soon)")
-    .option("-b, --boundary <level>", "Visibility level: private, team, org", "private")
-    .option("-c, --category <category>", "Default category (auto-detected if omitted)")
-    .option("--ignore <patterns>", "Comma-separated directories to ignore")
-    .option("--agent-memory", "Sync native AI agent memory files (Claude Code, Cursor, Codex)")
-    .action(syncCommand);
-syncCmd
-    .command("agents")
-    .description("Sync native AI agent memory files to Memax")
-    .action(syncAgentMemoryCommand);
-// --- Agent integration setup ---
-program
-    .command("setup")
-    .description("Set up AI agent integrations (auto-detects installed agents)")
-    .option("--mcp", "Enable MCP server (agent tools)")
-    .option("--hooks", "Enable context injection hooks")
-    .option("--all", "Enable both MCP and hooks")
-    .option("--only <agents>", "Only configure these agents (comma-separated)")
-    .option("--skip <agents>", "Skip these agents (comma-separated)")
-    .action(setupCommand);
-program
-    .command("teardown")
-    .description("Remove Memax integrations from agents")
-    .option("--only <agents>", "Only remove from these agents (comma-separated)")
-    .action(teardownCommand);
-program
-    .command("hook <action> <agent>")
-    .description("Manage agent hooks (install/uninstall claude-code)")
-    .action(hookCommand);
-// --- Auth ---
-program
-    .command("login")
-    .description("Log in to Memax via GitHub")
-    .action(loginCommand);
-program
-    .command("logout")
-    .description("Clear saved credentials")
-    .action(logoutCommand);
-program
-    .command("whoami")
-    .description("Show current user")
-    .action(whoamiCommand);
-// --- API Keys ---
-const authCmd = program
-    .command("auth")
-    .description("Manage authentication and API keys");
-authCmd
-    .command("create-key <name>")
-    .description("Create an API key for CI/CD or non-interactive use")
-    .option("--expires <days>", "Expire after N days (default: never)")
-    .action(createKeyCommand);
-authCmd
-    .command("list-keys")
-    .description("List your API keys")
-    .action(listKeysCommand);
-authCmd
-    .command("revoke-key <id>")
-    .description("Revoke an API key")
-    .action(revokeKeyCommand);
-// --- MCP Server ---
+// --- Command registration (order defines help layout) ---
+registerPushCommand(program);
+registerRecallCommand(program);
+registerListCommand(program);
+registerShowCommand(program);
+registerDeleteCommand(program);
+registerCaptureSessionCommand(program);
+registerTopicCommands(program);
+registerDreamsCommands(program);
+registerHubCommands(program);
+registerAgentsCommands(program);
+registerSyncCommands(program);
+registerSetupCommands(program);
+registerHookCommand(program);
 registerMcpCommand(program);
-// --- Config ---
-const configCmd = program
-    .command("config")
-    .description("Manage Memax configuration");
-configCmd
-    .command("get [key]")
-    .description("Get config value (or all values)")
-    .action(configGetCommand);
-configCmd
-    .command("set <key> <value>")
-    .description("Set a config value")
-    .action(configSetCommand);
+registerLoginCommands(program);
+registerAuthCommand(program);
+registerConfigCommand(program);
 program.parse();
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,6BAA6B,EAAE,MAAM,uBAAuB,CAAC;AACtE,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAE9D,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAC1D,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CACpB,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,cAAc,CAAC,EAAE,OAAO,CAAC,CAC7D,CAAC;AAEF,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,OAAO,CAAC;KACb,WAAW,CAAC,8CAA8C,CAAC;KAC3D,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AAExB,2DAA2D;AAE3D,mBAAmB,CAAC,OAAO,CAAC,CAAC;AAC7B,qBAAqB,CAAC,OAAO,CAAC,CAAC;AAC/B,mBAAmB,CAAC,OAAO,CAAC,CAAC;AAC7B,mBAAmB,CAAC,OAAO,CAAC,CAAC;AAC7B,qBAAqB,CAAC,OAAO,CAAC,CAAC;AAC/B,6BAA6B,CAAC,OAAO,CAAC,CAAC;AACvC,qBAAqB,CAAC,OAAO,CAAC,CAAC;AAC/B,sBAAsB,CAAC,OAAO,CAAC,CAAC;AAChC,mBAAmB,CAAC,OAAO,CAAC,CAAC;AAC7B,sBAAsB,CAAC,OAAO,CAAC,CAAC;AAChC,oBAAoB,CAAC,OAAO,CAAC,CAAC;AAC9B,qBAAqB,CAAC,OAAO,CAAC,CAAC;AAC/B,mBAAmB,CAAC,OAAO,CAAC,CAAC;AAC7B,kBAAkB,CAAC,OAAO,CAAC,CAAC;AAC5B,qBAAqB,CAAC,OAAO,CAAC,CAAC;AAC/B,mBAAmB,CAAC,OAAO,CAAC,CAAC;AAC7B,qBAAqB,CAAC,OAAO,CAAC,CAAC;AAE/B,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/dist/lib/client.d.ts

@@ -0,0 +1,9 @@
+import { Memax } from "memax-sdk";
+/** Get the shared SDK client instance (lazily created) */
+export declare function getClient(): Memax;
+/** Get an unauthenticated SDK client for auth bootstrap/refresh flows */
+export declare function getPublicClient(): Memax;
+/** Reset the cached client (useful after login/logout) */
+export declare function resetClient(): void;
+export declare function getAuthHeaders(): Promise<Record<string, string>>;
+//# sourceMappingURL=client.d.ts.map

package/dist/lib/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/lib/client.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAWlC,0DAA0D;AAC1D,wBAAgB,SAAS,IAAI,KAAK,CASjC;AAED,yEAAyE;AACzE,wBAAgB,eAAe,IAAI,KAAK,CAQvC;AAED,0DAA0D;AAC1D,wBAAgB,WAAW,IAAI,IAAI,CAGlC;AAED,wBAAsB,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAEtE"}

package/dist/lib/client.js

@@ -0,0 +1,77 @@
+// =============================================================================
+// CLI API client — configures memax-sdk with CLI-specific auth
+//
+// All CLI commands should use `getClient()` instead of raw fetch.
+// Auth flow: MEMAX_API_KEY env var → stored credentials (with auto-refresh).
+// =============================================================================
+import { Memax } from "memax-sdk";
+import { loadConfig } from "./config.js";
+import { loadCredentials, saveCredentials, isTokenExpired, } from "./credentials.js";
+let instance = null;
+let publicInstance = null;
+/** Get the shared SDK client instance (lazily created) */
+export function getClient() {
+    if (!instance) {
+        const config = loadConfig();
+        instance = new Memax({
+            apiUrl: config.api_url,
+            auth: cliAuthProvider,
+        });
+    }
+    return instance;
+}
+/** Get an unauthenticated SDK client for auth bootstrap/refresh flows */
+export function getPublicClient() {
+    if (!publicInstance) {
+        const config = loadConfig();
+        publicInstance = new Memax({
+            apiUrl: config.api_url,
+        });
+    }
+    return publicInstance;
+}
+/** Reset the cached client (useful after login/logout) */
+export function resetClient() {
+    instance = null;
+    publicInstance = null;
+}
+export async function getAuthHeaders() {
+    return cliAuthProvider();
+}
+/**
+ * CLI auth provider — resolves authorization headers.
+ *
+ * Priority:
+ * 1. MEMAX_API_KEY env var (CI/CD, non-interactive)
+ * 2. Stored credentials with automatic token refresh
+ */
+async function cliAuthProvider() {
+    // 1. Env var takes priority
+    const envKey = process.env.MEMAX_API_KEY;
+    if (envKey) {
+        return { Authorization: `Bearer ${envKey}` };
+    }
+    // 2. Stored credentials
+    const creds = loadCredentials();
+    if (!creds?.access_token)
+        return {};
+    // Auto-refresh if expired
+    if (isTokenExpired() && creds.refresh_token) {
+        try {
+            const tokens = await getPublicClient().auth.refresh(creds.refresh_token);
+            if (tokens.access_token) {
+                saveCredentials({
+                    access_token: tokens.access_token,
+                    refresh_token: tokens.refresh_token,
+                    expires_at: Date.now() + tokens.expires_in * 1000,
+                });
+                return { Authorization: `Bearer ${tokens.access_token}` };
+            }
+        }
+        catch {
+            // Refresh failed — fall through to stale token
+        }
+    }
+    return { Authorization: `Bearer ${creds.access_token}` };
+}
+//# sourceMappingURL=client.js.map

package/dist/lib/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/lib/client.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,+DAA+D;AAC/D,EAAE;AACF,kEAAkE;AAClE,6EAA6E;AAC7E,gFAAgF;AAEhF,OAAO,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EACL,eAAe,EACf,eAAe,EACf,cAAc,GACf,MAAM,kBAAkB,CAAC;AAE1B,IAAI,QAAQ,GAAiB,IAAI,CAAC;AAClC,IAAI,cAAc,GAAiB,IAAI,CAAC;AAExC,0DAA0D;AAC1D,MAAM,UAAU,SAAS;IACvB,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;QAC5B,QAAQ,GAAG,IAAI,KAAK,CAAC;YACnB,MAAM,EAAE,MAAM,CAAC,OAAO;YACtB,IAAI,EAAE,eAAe;SACtB,CAAC,CAAC;IACL,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,eAAe;IAC7B,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;QAC5B,cAAc,GAAG,IAAI,KAAK,CAAC;YACzB,MAAM,EAAE,MAAM,CAAC,OAAO;SACvB,CAAC,CAAC;IACL,CAAC;IACD,OAAO,cAAc,CAAC;AACxB,CAAC;AAED,0DAA0D;AAC1D,MAAM,UAAU,WAAW;IACzB,QAAQ,GAAG,IAAI,CAAC;IAChB,cAAc,GAAG,IAAI,CAAC;AACxB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc;IAClC,OAAO,eAAe,EAAE,CAAC;AAC3B,CAAC;AAED;;;;;;GAMG;AACH,KAAK,UAAU,eAAe;IAC5B,4BAA4B;IAC5B,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC;IACzC,IAAI,MAAM,EAAE,CAAC;QACX,OAAO,EAAE,aAAa,EAAE,UAAU,MAAM,EAAE,EAAE,CAAC;IAC/C,CAAC;IAED,wBAAwB;IACxB,MAAM,KAAK,GAAG,eAAe,EAAE,CAAC;IAChC,IAAI,CAAC,KAAK,EAAE,YAAY;QAAE,OAAO,EAAE,CAAC;IAEpC,0BAA0B;IAC1B,IAAI,cAAc,EAAE,IAAI,KAAK,CAAC,aAAa,EAAE,CAAC;QAC5C,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,eAAe,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;YACzE,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;gBACxB,eAAe,CAAC;oBACd,YAAY,EAAE,MAAM,CAAC,YAAY;oBACjC,aAAa,EAAE,MAAM,CAAC,aAAa;oBACnC,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,UAAU,GAAG,IAAI;iBAClD,CAAC,CAAC;gBACH,OAAO,EAAE,aAAa,EAAE,UAAU,MAAM,CAAC,YAAY,EAAE,EAAE,CAAC;YAC5D,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,+CAA+C;QACjD,CAAC;IACH,CAAC;IAED,OAAO,EAAE,aAAa,EAAE,UAAU,KAAK,CAAC,YAAY,EAAE,EAAE,CAAC;AAC3D,CAAC"}

package/dist/lib/config.d.ts

@@ -1,10 +1,55 @@
 export interface MemaxConfig {
     api_url: string;
     default_hub: string;
+    active_hub_id?: string;
     default_boundary: string;
     auto_categorize: boolean;
+    device_id?: string;
+    sync_sources?: SyncSourceState[];
+    agent_session_roots?: AgentSessionRoot[];
+}
+export interface AgentSessionRoot {
+    id?: string;
+    agent: string;
+    root_path: string;
+    scope: string;
+    session_type?: string;
+    include_extensions?: string[];
+}
+export interface SyncSourceState {
+    id: string;
+    root_path: string;
+    kind: "directory";
+    ignore_patterns: string[];
+    default_category?: string;
+    default_boundary?: string;
+    deletion_policy: "retain";
+    last_sync_at?: string;
+    last_mode?: "manual" | "watch";
+    last_scan_count?: number;
+    last_pushed?: number;
+    last_skipped?: number;
+    last_errors?: number;
 }
 export declare function getConfigDir(): string;
 export declare function loadConfig(): MemaxConfig;
 export declare function saveConfig(config: Partial<MemaxConfig>): void;
+export declare function getActiveHubID(): string;
+export declare function setActiveHubID(hubID: string): void;
+export declare function getOrCreateDeviceID(): string;
+export declare function makeSyncSourceID(rootPath: string): string;
+export declare function listSyncSources(): SyncSourceState[];
+export declare function upsertSyncSource(source: Omit<SyncSourceState, "id"> & {
+    id?: string;
+}): SyncSourceState;
+export declare function updateSyncSourceRun(rootPath: string, update: {
+    ignorePatterns: string[];
+    defaultCategory?: string;
+    defaultBoundary?: string;
+    mode: "manual" | "watch";
+    scanCount: number;
+    pushed: number;
+    skipped: number;
+    errors: number;
+}): SyncSourceState;
 //# sourceMappingURL=config.d.ts.map

package/dist/lib/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/lib/config.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,OAAO,CAAC;CAC1B;AASD,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED,wBAAgB,UAAU,IAAI,WAAW,CAgBxC;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,IAAI,CAiB7D"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/lib/config.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,OAAO,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,eAAe,EAAE,CAAC;IACjC,mBAAmB,CAAC,EAAE,gBAAgB,EAAE,CAAC;CAC1C;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,WAAW,CAAC;IAClB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,eAAe,EAAE,QAAQ,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC;IAC/B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AASD,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED,wBAAgB,UAAU,IAAI,WAAW,CAmBxC;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,IAAI,CAiB7D;AAED,wBAAgB,cAAc,IAAI,MAAM,CAGvC;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAElD;AAED,wBAAgB,mBAAmB,IAAI,MAAM,CAQ5C;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED,wBAAgB,eAAe,IAAI,eAAe,EAAE,CAInD;AAED,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,IAAI,CAAC,eAAe,EAAE,IAAI,CAAC,GAAG;IAAE,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,GACpD,eAAe,CA6BjB;AAED,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE;IACN,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB,GACA,eAAe,CAmBjB"}

package/dist/lib/config.js

@@ -1,11 +1,12 @@
 import { readFileSync, writeFileSync, mkdirSync, existsSync } from "node:fs";
 import { join } from "node:path";
 import { homedir } from "node:os";
+import { randomUUID, createHash } from "node:crypto";
 const CONFIG_DIR = join(homedir(), ".memax");
 const CONFIG_FILE = join(CONFIG_DIR, "config.json");
 const DEFAULT_CONFIG = {
     api_url: "http://localhost:8080",
-    default_hub: "default",
+    default_hub: "",
     default_boundary: "private",
     auto_categorize: true,
 };
@@ -21,6 +22,9 @@ export function loadConfig() {
     try {
         const raw = readFileSync(CONFIG_FILE, "utf-8");
         const config = { ...DEFAULT_CONFIG, ...JSON.parse(raw) };
+        if (!config.active_hub_id && config.default_hub) {
+            config.active_hub_id = config.default_hub;
+        }
         if (envUrl)
             config.api_url = envUrl;
         return config;
@@ -46,4 +50,73 @@ export function saveConfig(config) {
     const merged = { ...existing, ...config };
     writeFileSync(CONFIG_FILE, JSON.stringify(merged, null, 2) + "\n");
 }
+export function getActiveHubID() {
+    const config = loadConfig();
+    return config.active_hub_id?.trim() || config.default_hub?.trim() || "";
+}
+export function setActiveHubID(hubID) {
+    saveConfig({ active_hub_id: hubID });
+}
+export function getOrCreateDeviceID() {
+    const config = loadConfig();
+    if (config.device_id && config.device_id.trim()) {
+        return config.device_id;
+    }
+    const deviceID = randomUUID();
+    saveConfig({ device_id: deviceID });
+    return deviceID;
+}
+export function makeSyncSourceID(rootPath) {
+    return createHash("sha256").update(rootPath).digest("hex").slice(0, 12);
+}
+export function listSyncSources() {
+    return [...(loadConfig().sync_sources ?? [])].sort((a, b) => a.root_path.localeCompare(b.root_path));
+}
+export function upsertSyncSource(source) {
+    const config = loadConfig();
+    const syncSources = [...(config.sync_sources ?? [])];
+    const id = source.id ?? makeSyncSourceID(source.root_path);
+    const next = {
+        id,
+        root_path: source.root_path,
+        kind: source.kind,
+        ignore_patterns: [...source.ignore_patterns],
+        default_category: source.default_category,
+        default_boundary: source.default_boundary,
+        deletion_policy: source.deletion_policy,
+        last_sync_at: source.last_sync_at,
+        last_mode: source.last_mode,
+        last_scan_count: source.last_scan_count,
+        last_pushed: source.last_pushed,
+        last_skipped: source.last_skipped,
+        last_errors: source.last_errors,
+    };
+    const existingIndex = syncSources.findIndex((item) => item.id === id);
+    if (existingIndex >= 0) {
+        syncSources[existingIndex] = next;
+    }
+    else {
+        syncSources.push(next);
+    }
+    saveConfig({ sync_sources: syncSources });
+    return next;
+}
+export function updateSyncSourceRun(rootPath, update) {
+    const existing = listSyncSources().find((item) => item.root_path === rootPath);
+    return upsertSyncSource({
+        id: existing?.id,
+        root_path: rootPath,
+        kind: "directory",
+        ignore_patterns: update.ignorePatterns,
+        default_category: update.defaultCategory,
+        default_boundary: update.defaultBoundary,
+        deletion_policy: "retain",
+        last_sync_at: new Date().toISOString(),
+        last_mode: update.mode,
+        last_scan_count: update.scanCount,
+        last_pushed: update.pushed,
+        last_skipped: update.skipped,
+        last_errors: update.errors,
+    });
+}
 //# sourceMappingURL=config.js.map

package/dist/lib/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/lib/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAElC,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,QAAQ,CAAC,CAAC;AAC7C,MAAM,WAAW,GAAG,IAAI,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;AASpD,MAAM,cAAc,GAAgB;IAClC,OAAO,EAAE,uBAAuB;IAChC,WAAW,EAAE,SAAS;IACtB,gBAAgB,EAAE,SAAS;IAC3B,eAAe,EAAE,IAAI;CACtB,CAAC;AAEF,MAAM,UAAU,YAAY;IAC1B,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,+BAA+B;IAC/B,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC;IAEzC,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QAC7B,OAAO,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,cAAc,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,cAAc,CAAC;IAC1E,CAAC;IAED,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QAC/C,MAAM,MAAM,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QACzD,IAAI,MAAM;YAAE,MAAM,CAAC,OAAO,GAAG,MAAM,CAAC;QACpC,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,cAAc,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,cAAc,CAAC;IAC1E,CAAC;AACH,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,MAA4B;IACrD,SAAS,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE3C,IAAI,QAAQ,GAAG,cAAc,CAAC;IAC9B,IAAI,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QAC5B,IAAI,CAAC;YACH,QAAQ,GAAG;gBACT,GAAG,cAAc;gBACjB,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;aAClD,CAAC;QACJ,CAAC;QAAC,MAAM,CAAC;YACP,sBAAsB;QACxB,CAAC;IACH,CAAC;IAED,MAAM,MAAM,GAAG,EAAE,GAAG,QAAQ,EAAE,GAAG,MAAM,EAAE,CAAC;IAC1C,aAAa,CAAC,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;AACrE,CAAC"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/lib/config.ts"],"names":[],"mappings":"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"}

package/dist/lib/hubs.d.ts

@@ -0,0 +1,7 @@
+import type { Hub, HubWithRole } from "memax-sdk";
+export declare const PERSONAL_HUB_ALIAS = "personal";
+export declare function getHubReference(hub: Hub): string;
+export declare function findHubMatch(hubs: HubWithRole[], ref: string): HubWithRole | undefined;
+export declare function resolveHubID(ref: string | undefined): Promise<string | undefined>;
+export declare function requireHub(ref: string): Promise<HubWithRole>;
+//# sourceMappingURL=hubs.d.ts.map

package/dist/lib/hubs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hubs.d.ts","sourceRoot":"","sources":["../../src/lib/hubs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAGlD,eAAO,MAAM,kBAAkB,aAAa,CAAC;AAM7C,wBAAgB,eAAe,CAAC,GAAG,EAAE,GAAG,GAAG,MAAM,CAEhD;AAED,wBAAgB,YAAY,CAC1B,IAAI,EAAE,WAAW,EAAE,EACnB,GAAG,EAAE,MAAM,GACV,WAAW,GAAG,SAAS,CAWzB;AAED,wBAAsB,YAAY,CAChC,GAAG,EAAE,MAAM,GAAG,SAAS,GACtB,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAI7B;AAED,wBAAsB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CASlE"}

package/dist/lib/hubs.js

@@ -0,0 +1,33 @@
+import { getClient } from "./client.js";
+export const PERSONAL_HUB_ALIAS = "personal";
+function normalizeHubRef(value) {
+    return value.trim().toLowerCase();
+}
+export function getHubReference(hub) {
+    return hub.hub_type === "personal" ? PERSONAL_HUB_ALIAS : hub.slug;
+}
+export function findHubMatch(hubs, ref) {
+    const normalized = normalizeHubRef(ref);
+    if (normalized === PERSONAL_HUB_ALIAS) {
+        return hubs.find(({ hub }) => hub.hub_type === "personal");
+    }
+    return hubs.find(({ hub }) => {
+        return (normalizeHubRef(hub.id) === normalized ||
+            normalizeHubRef(hub.slug) === normalized);
+    });
+}
+export async function resolveHubID(ref) {
+    if (!ref)
+        return undefined;
+    const hubs = await getClient().hubs.list();
+    return findHubMatch(hubs, ref)?.hub.id;
+}
+export async function requireHub(ref) {
+    const hubs = await getClient().hubs.list();
+    const match = findHubMatch(hubs, ref);
+    if (!match) {
+        throw new Error("Hub not found or not accessible. Run `memax hub list` to see available hubs.");
+    }
+    return match;
+}
+//# sourceMappingURL=hubs.js.map

package/dist/lib/hubs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hubs.js","sourceRoot":"","sources":["../../src/lib/hubs.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,MAAM,CAAC,MAAM,kBAAkB,GAAG,UAAU,CAAC;AAE7C,SAAS,eAAe,CAAC,KAAa;IACpC,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,GAAQ;IACtC,OAAO,GAAG,CAAC,QAAQ,KAAK,UAAU,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC;AACrE,CAAC;AAED,MAAM,UAAU,YAAY,CAC1B,IAAmB,EACnB,GAAW;IAEX,MAAM,UAAU,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC;IACxC,IAAI,UAAU,KAAK,kBAAkB,EAAE,CAAC;QACtC,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC,QAAQ,KAAK,UAAU,CAAC,CAAC;IAC7D,CAAC;IACD,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE;QAC3B,OAAO,CACL,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC,KAAK,UAAU;YACtC,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,UAAU,CACzC,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,GAAuB;IAEvB,IAAI,CAAC,GAAG;QAAE,OAAO,SAAS,CAAC;IAC3B,MAAM,IAAI,GAAG,MAAM,SAAS,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;IAC3C,OAAO,YAAY,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;AACzC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,GAAW;IAC1C,MAAM,IAAI,GAAG,MAAM,SAAS,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;IAC3C,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IACtC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CACb,8EAA8E,CAC/E,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}