ultracontext 1.2.0 → 1.3.0

package/README.md

@@ -4,7 +4,12 @@
   </a>
 </p>
 
-<h3 align="center">Context infrastructure for AI agents.</h3>
+<h3 align="center">Same context. Everywhere.</h3>
+
+<p align="center">
+  Start on Claude Code. Continue on Codex.<br/>
+  Open source, realtime and invisible context infrastructure for the ones shipping at inference speed.
+</p>
 
 <p align="center">
   <a href="https://ultracontext.ai/docs">Documentation</a> ·
@@ -38,50 +43,54 @@
 
 ---
 
-<h2 align="center">All agents. One context.</h2>
+![ultracontext-gif](https://github.com/user-attachments/assets/be73afe5-161d-4fa3-8f4d-c4987fe63cb4)
 
-Auto-capture and share your agents' context everywhere. Realtime. Open source.
+What Claude Code knows, Codex doesn't. What your teammate is shipping right now? Your agent has no idea.
 
-![ultracontext-gif](https://github.com/user-attachments/assets/be73afe5-161d-4fa3-8f4d-c4987fe63cb4)
+UltraContext captures every agent's context in realtime and makes it available to all of them. It's like having a personal context engineer everywhere. Continue a session in a different agent, or just ask what's happeming.
 
-Everyone is shipping with agents. Few are shipping with agents together. 
+For example:
 
-Multiple people, multiple agents, multiple machines. Our contexts are spread everywhere. There's no standard for context engineering. No infrastructure to build on. No fundamental building blocks to agree on. So we decided to make it.
+- *"Codex, grab the last plan Claude Code made and implement it."*
+- *"What's the team building today?"*
+- *"What is Alex working on in Codex right now?"*
 
-UltraContext is the context infrastructure. The API gives you git-like primitives for context engineering. The Hub lets you auto-capture, share, and collaborate across agents in realtime.
+Open source. Framework-agnostic. Customizable via the git-like Context API.
 
-## Install
+## Features
 
-Requires Node >= 22.
+| CLI | Auto-ingest Claude Code, Codex, and OpenClaw sessions with a terminal dashboard. |
+| --- | --- |
+| MCP Server | Share context everywhere. Built into the API, or run standalone via stdio. |
+| Context API | Git-like context engineering API. Store, version, and retrieve agent context with zero complexity. |
 
-```bash
-npm install -g ultracontext
-```
+---
 
-## The Hub
+## How it works
 
-**All agents. One context.**
+1. **Start the daemon.** It captures all your agents' context in realtime.
 
-The Hub lets you auto-capture, share, and collaborate across agents in realtime.
+2. **Add the MCP server.** Any agent gets full awareness of every other agent.
 
-### Features
+3. **That's it.** Ask questions, continue sessions, fork — your context is everywhere.
 
-- **Auto-capture** — Ingests your agents' context in realtime. Zero config.
-- **Switch between agents** — Pick up where one agent left off with another.
-- **Collaborate** — Share contexts across your team. See what everyone sees. Realtime.
-- **Fork & clone** — Continue contexts while preserving the full history.
-- **Own your data** — Open source. Your contexts. Your rules.
+## Install
 
-### How it works
+Requires Node >= 22.
 
-1. A daemon runs in the background, watching your agents.
-2. Contexts are ingested in realtime.
-3. Your dashboard gets updated.
+```bash
+npm install -g ultracontext
+```
 
-### Quick Start
+## Quick Start
 
 ```bash
 ultracontext          # start daemon + open dashboard
+```
+
+That's it. The daemon watches your agents, ingests context in realtime, and the dashboard shows everything.
+
+```bash
 ultracontext config   # run setup wizard
 ultracontext start    # start daemon only
 ultracontext stop     # stop daemon
@@ -89,36 +98,22 @@ ultracontext status   # check if daemon is running
 ultracontext tui      # open dashboard only
 ```
 
-The default `ultracontext` command does everything: checks the daemon, starts it if needed, and opens the dashboard.
-
-When you open an existing session, it forks the context — the original is always preserved and automatically versioned. A local caching layer prevents duplicate context creations and appends.
-
-Add your own agents and extend behavior with the Context API. ([Docs here](https://ultracontext.ai/docs/))
+## Context API
 
-## The API
-
-**Context engineering built like Git.**
-
-The API gives you git-like primitives for context engineering, without the complexity.
-
-### Features
+For builders who want to go deeper. Git-like primitives for context engineering.
 
 - **Five methods** — Create, get, append, update, delete. That's it.
 - **Automatic versioning** — Every change creates a new version. Full history out of the box.
 - **Time-travel** — Jump to any point in your context history.
 - **Framework-agnostic** — Works with any LLM framework. No vendor lock-in.
 
-The simplest way to control what your agents see. Replace messages, compact long context, replay decisions and roll back mistakes — all with a single API call.
-
-Use the API standalone to build your own agents, or to extend existing ones in UltraContext.
-
+Use the API standalone to build your own agents, or extend existing ones in UltraContext.
 
 | SDK                   | Install                    | Source                               |
 | --------------------- | -------------------------- | ------------------------------------ |
 | JavaScript/TypeScript | `npm install ultracontext` | [apps/js-sdk](./apps/js-sdk)         |
 | Python                | `pip install ultracontext` | [apps/python-sdk](./apps/python-sdk) |
 
-
 ### JavaScript/TypeScript
 
 ```bash
@@ -170,9 +165,8 @@ response = generate_text(model=model, messages=uc.get(ctx["id"])["data"])
 
 [![Star History Chart](https://api.star-history.com/svg?repos=ultracontext/ultracontext-node&type=date&legend=top-left)](https://www.star-history.com/#ultracontext/ultracontext-node&type=date&legend=top-left)
 
-
 ## Documentation
 
-- [Quickstart](https://ultracontext.ai/docs/quickstart/nodejs) — Get running in 2 minutes
+- [Quickstart](https://ultracontext.ai/docs/quickstart) — Get running in 2 minutes
 - [Guides](https://ultracontext.ai/docs/guides/store-retrieve-contexts) — Practical patterns for common use cases
-- [API Reference](https://ultracontext.ai/docs/api-reference/introduction) — Full endpoint documentation
+- [API Reference](https://ultracontext.ai/docs/api-reference/introduction) — Full endpoint documentation

package/dist/cli/entry.mjs

@@ -313,18 +313,18 @@ async function checkForUpdate() {
 	if (latest && isNewer(latest, current)) printUpdateNotice(current, latest);
 }
 async function launchDaemonSDK() {
-	const { launchDaemon } = await import("../launcher-VTbHuuaQ.mjs");
+	const { launchDaemon } = await import("../launcher-DXUM0K-z.mjs");
 	await launchDaemon({
 		entryPath: fileURLToPath(new URL("./sdk-daemon.mjs", import.meta.url)),
 		diagnosticsHint: "DAEMON_VERBOSE=1 ultracontext start"
 	});
 }
 async function runCtlSDK() {
-	const { runCtl } = await import("../ctl-DaIi3tUU.mjs");
+	const { runCtl } = await import("../ctl-9dwvaRrC.mjs");
 	await runCtl();
 }
 async function launchTuiSDK() {
-	const { tuiBoot } = await import("../tui-BwpUi10R.mjs");
+	const { tuiBoot } = await import("../tui-DNqvslCq.mjs");
 	await tuiBoot({
 		assetsRoot: path.resolve(__dirname, "..", ".."),
 		offlineNotice: "Daemon offline. Run: ultracontext start"

package/dist/cli/sdk-daemon.mjs

@@ -1,5 +1,5 @@
-import { a as extractSessionIdFromPath, c as toInt, i as expandHome, l as truncateString, n as resolveLockPath, o as safeJsonParse, r as boolFromEnv, s as sha256, t as acquireFileLock } from "../lock-H7LKrRSb.mjs";
-import { a as parseDaemonWsMessage, c as resolveDaemonWsInfoFile, i as normalizeBootstrapMode, l as resolveDaemonWsPort, n as buildDaemonWsMessage, o as parseProtocolJson, r as createBootstrapStateKey, s as resolveDaemonWsHost, t as DAEMON_WS_MESSAGE_TYPES } from "../src-NyDFgJXL.mjs";
+import { a as extractProjectPathFromFile, c as sha256, i as expandHome, l as toInt, n as resolveLockPath, o as extractSessionIdFromPath, r as boolFromEnv, s as safeJsonParse, t as acquireFileLock, u as truncateString } from "../lock-Q6z0l6Mr.mjs";
+import { a as parseDaemonWsMessage, c as resolveDaemonWsInfoFile, i as normalizeBootstrapMode, l as resolveDaemonWsPort, n as buildDaemonWsMessage, o as parseProtocolJson, r as createBootstrapStateKey, s as resolveDaemonWsHost, t as DAEMON_WS_MESSAGE_TYPES } from "../src-Xh68VkBy.mjs";
 import process$1 from "node:process";
 import path from "node:path";
 import fs from "node:fs";
@@ -255,32 +255,69 @@ function normalizeKind(kind, fallback = "system") {
 	].includes(lowered)) return "assistant";
 	return fallback;
 }
-function toMessage(raw) {
+function toMessage(raw, maxLen = 12e3) {
 	if (!raw) return "";
-	if (typeof raw === "string") return truncateString(raw, 3e3);
-	if (typeof raw === "object") return truncateString(JSON.stringify(raw), 3e3);
-	return truncateString(String(raw), 3e3);
+	if (typeof raw === "string") return truncateString(raw, maxLen);
+	if (typeof raw === "object") return truncateString(JSON.stringify(raw), maxLen);
+	return truncateString(String(raw), maxLen);
 }
 function normalizeWhitespace(value) {
 	return String(value ?? "").replace(/\s+/g, " ").trim();
 }
+function preserveText(value) {
+	return String(value ?? "").split("\n").map((l) => l.trimEnd()).join("\n").replace(/\n{3,}/g, "\n\n").trim();
+}
+function formatToolUse(item) {
+	const name = (item.name ?? "unknown").toLowerCase();
+	const input = item.input ?? {};
+	const filePath = input.file_path ?? input.path ?? "";
+	if (name === "write") return `[Write] ${filePath}\n${preserveText(input.content ?? input.file_text ?? "")}`;
+	if (name === "edit") {
+		const parts = [`[Edit] ${filePath}`];
+		if (input.old_string) parts.push(`- ${preserveText(input.old_string)}`);
+		if (input.new_string) parts.push(`+ ${preserveText(input.new_string)}`);
+		return parts.join("\n");
+	}
+	if (name === "read") return `[Read] ${filePath}`;
+	if (name === "bash") return `[Bash] ${preserveText(input.command ?? "")}`;
+	if (name === "grep" || name === "glob") {
+		const loc = filePath ? ` in ${filePath}` : "";
+		return `[${item.name}] ${input.pattern ?? ""}${loc}`;
+	}
+	const compact = JSON.stringify(input);
+	return `[${item.name ?? name}] ${compact.length > 500 ? compact.slice(0, 500) + "..." : compact}`;
+}
+function formatToolResult(item) {
+	const content = item.content ?? "";
+	if (typeof content === "string") {
+		const text = preserveText(content);
+		return text ? `[result] ${truncateString(text, 1e3)}` : "[result] ok";
+	}
+	if (Array.isArray(content)) {
+		const text = content.filter((c) => c?.type === "text" && typeof c.text === "string").map((c) => preserveText(c.text)).filter(Boolean).join("\n");
+		return text ? `[result] ${truncateString(text, 1e3)}` : "[result] ok";
+	}
+	return "[result] ok";
+}
 function extractClaudeTextContent(content) {
 	if (!content) return "";
-	if (typeof content === "string") return normalizeWhitespace(content);
+	if (typeof content === "string") return preserveText(content);
 	if (Array.isArray(content)) {
-		const textParts = [];
+		const parts = [];
 		for (const item of content) {
 			if (!item || typeof item !== "object") continue;
 			if (item.type === "text" && typeof item.text === "string") {
-				const chunk = normalizeWhitespace(item.text);
-				if (chunk) textParts.push(chunk);
+				const chunk = preserveText(item.text);
+				if (chunk) parts.push(chunk);
 			}
+			if (item.type === "tool_use") parts.push(formatToolUse(item));
+			if (item.type === "tool_result") parts.push(formatToolResult(item));
 		}
-		return textParts.join("\n");
+		return parts.join("\n\n");
 	}
 	if (typeof content === "object") {
-		if (typeof content.text === "string") return normalizeWhitespace(content.text);
-		if (typeof content.content === "string") return normalizeWhitespace(content.content);
+		if (typeof content.text === "string") return preserveText(content.text);
+		if (typeof content.content === "string") return preserveText(content.content);
 	}
 	return "";
 }
@@ -765,7 +802,7 @@ async function daemonBoot({ createStore, resolveDbPath }) {
 	const cfg = {
 		apiKey: normalizeApiKey(process$1.env.ULTRACONTEXT_API_KEY),
 		baseUrl: (process$1.env.ULTRACONTEXT_BASE_URL ?? "https://api.ultracontext.ai").trim(),
-		engineerId: process$1.env.DAEMON_ENGINEER_ID ?? process$1.env.USER ?? "unknown-engineer",
+		userId: process$1.env.DAEMON_USER_ID ?? process$1.env.USER ?? "unknown-user",
 		host: (process$1.env.DAEMON_HOST || os.hostname() || "unknown-host").trim(),
 		pollMs: toInt(process$1.env.DAEMON_POLL_MS, 1500),
 		logLevel: process$1.env.DAEMON_LOG_LEVEL ?? "info",
@@ -781,7 +818,6 @@ async function daemonBoot({ createStore, resolveDbPath }) {
 		wsInfoFile: resolveDaemonWsInfoFile(process$1.env),
 		dedupeTtlSec: toInt(process$1.env.DAEMON_DEDUPE_TTL_SEC, 3600 * 24 * 30),
 		maxReadBytes: toInt(process$1.env.DAEMON_MAX_READ_BYTES, 512 * 1024),
-		enableDailyContext: boolFromEnv(process$1.env.DAEMON_ENABLE_DAILY_CONTEXT, false),
 		bootstrapMode: normalizeBootstrapModeWithPrompt(process$1.env.DAEMON_BOOTSTRAP_MODE ?? "prompt") || "prompt",
 		bootstrapReset: boolFromEnv(process$1.env.DAEMON_BOOTSTRAP_RESET, false),
 		claudeIncludeSubagents: boolFromEnv(process$1.env.CLAUDE_INCLUDE_SUBAGENTS, false),
@@ -892,8 +928,7 @@ async function daemonBoot({ createStore, resolveDbPath }) {
 	}
 	function pushRecentLog(level, message, data) {
 		let line = String(message ?? "");
-		if (line.startsWith("Appended event to session context")) line = "context append (session)";
-		if (line.startsWith("Appended event to daily context")) line = "context append (daily)";
+		if (line.startsWith("Appended event to session context")) line = "context append";
 		if (line.startsWith("Context created")) line = "Context created";
 		if (line.startsWith("Context created without metadata fallback")) line = "Context created (fallback)";
 		if (line.startsWith("UltraContext daemon started")) line = "Daemon started";
@@ -969,23 +1004,6 @@ async function daemonBoot({ createStore, resolveDbPath }) {
 		if ("bodyText" in error) details.bodyText = error.bodyText;
 		return details;
 	}
-	function parseBool(value, fallback = false) {
-		if (value === null || value === void 0) return fallback;
-		const normalized = String(value).trim().toLowerCase();
-		if ([
-			"1",
-			"true",
-			"yes",
-			"on"
-		].includes(normalized)) return true;
-		if ([
-			"0",
-			"false",
-			"no",
-			"off"
-		].includes(normalized)) return false;
-		return fallback;
-	}
 	function serializeConfigPrefs() {
 		return {
 			bootstrapMode: normalizeBootstrapModeWithPrompt(cfg.bootstrapMode) || "prompt",
@@ -1139,7 +1157,7 @@ async function daemonBoot({ createStore, resolveDbPath }) {
 			running: Boolean(runtime.daemonRunning),
 			pid: process$1.pid,
 			host: cfg.host,
-			engineerId: cfg.engineerId,
+			userId: cfg.userId,
 			stats: { ...stats },
 			sourceStats: state.sourceOrder.map((name) => ({
 				name,
@@ -1189,7 +1207,7 @@ async function daemonBoot({ createStore, resolveDbPath }) {
 	function bootstrapStateStoreKey(sources) {
 		return createBootstrapStateKey({
 			host: cfg.host,
-			engineerId: cfg.engineerId,
+			userId: cfg.userId,
 			sourceNames: sources.map((s) => s.name)
 		});
 	}
@@ -1209,10 +1227,7 @@ async function daemonBoot({ createStore, resolveDbPath }) {
 		return `seen:${sourceName}:${eventId}`;
 	}
 	function sessionContextStoreKey(sourceName, sessionId) {
-		return `ctx:session:${sourceName}:${cfg.host}:${cfg.engineerId}:${sessionId}`;
-	}
-	function dailyContextStoreKey(sourceName, dayKey) {
-		return `ctx:daily:${sourceName}:${cfg.host}:${cfg.engineerId}:${dayKey}`;
+		return `ctx:session:${sourceName}:${cfg.host}:${cfg.userId}:${sessionId}`;
 	}
 	async function primeOffsetsToEof(store, source, shouldStop = () => false) {
 		if (shouldStop()) return;
@@ -1329,15 +1344,12 @@ async function daemonBoot({ createStore, resolveDbPath }) {
 				action: "created",
 				source: sourceName,
 				sessionId: String(metadata?.session_id ?? ""),
-				contextKind: String(metadata?.context_kind ?? "session"),
 				contextId: created.id
 			});
 			if (cfg.logAppends) log("info", "Context created", {
 				source: sourceName,
 				context_id: created.id,
-				kind: metadata?.context_kind ?? "session",
-				session_id: metadata?.session_id ?? "",
-				day: metadata?.day ?? ""
+				session_id: metadata?.session_id ?? ""
 			});
 			return created.id;
 		} catch (error) {
@@ -1354,40 +1366,28 @@ async function daemonBoot({ createStore, resolveDbPath }) {
 					action: "created",
 					source: sourceName,
 					sessionId: String(metadata?.session_id ?? ""),
-					contextKind: String(metadata?.context_kind ?? "session"),
 					contextId: created.id
 				});
 				if (cfg.logAppends) log("warn", "Context created without metadata fallback", {
 					source: sourceName,
-					context_id: created.id,
-					kind: metadata?.context_kind ?? "session"
+					context_id: created.id
 				});
 				return created.id;
 			}
 			throw error;
 		}
 	}
-	function toDayKey(timestamp) {
-		if (timestamp === void 0 || timestamp === null) return (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
-		if (typeof timestamp === "number" || /^\d+$/.test(String(timestamp))) {
-			const asNum = Number(timestamp);
-			const ms = asNum > 0xe8d4a51000 ? asNum : asNum * 1e3;
-			const d = new Date(ms);
-			if (!Number.isNaN(d.getTime())) return d.toISOString().slice(0, 10);
-		}
-		const d = new Date(String(timestamp));
-		if (!Number.isNaN(d.getTime())) return d.toISOString().slice(0, 10);
-		return (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
-	}
 	async function appendToUltraContext({ store, uc, sourceName, normalized, eventId, filePath, lineOffset }) {
-		const dayKey = toDayKey(normalized.timestamp);
-		const sessionContextId = await getOrCreateContext(store, uc, sessionContextStoreKey(sourceName, normalized.sessionId), {
+		const contextMeta = {
 			source: sourceName,
 			host: cfg.host,
-			engineer_id: cfg.engineerId,
+			user_id: cfg.userId,
 			session_id: normalized.sessionId,
-			context_kind: "session"
-		}, sourceName);
+			started_at: normalized.timestamp
+		};
+		const projectPath = extractProjectPathFromFile(filePath);
+		if (projectPath) contextMeta.project_path = projectPath;
+		const sessionContextId = await getOrCreateContext(store, uc, sessionContextStoreKey(sourceName, normalized.sessionId), contextMeta, sourceName);
 		const safeRaw = redact(normalized.raw);
 		const payload = {
 			role: normalized.kind,
@@ -1400,12 +1400,11 @@ async function daemonBoot({ createStore, resolveDbPath }) {
 			metadata: {
 				source: sourceName,
 				host: cfg.host,
-				engineer_id: cfg.engineerId,
+				user_id: cfg.userId,
 				session_id: normalized.sessionId,
 				event_id: eventId,
 				file_path: filePath,
-				file_offset: lineOffset,
-				day: dayKey
+				file_offset: lineOffset
 			}
 		};
 		await uc.append(sessionContextId, payload);
@@ -1415,7 +1414,6 @@ async function daemonBoot({ createStore, resolveDbPath }) {
 			action: "appended",
 			source: sourceName,
 			sessionId: normalized.sessionId,
-			contextKind: "session",
 			contextId: sessionContextId
 		});
 		noteSourceActivity(sourceName, {
@@ -1431,25 +1429,6 @@ async function daemonBoot({ createStore, resolveDbPath }) {
 			role: normalized.kind,
 			event_id: eventId
 		});
-		if (!cfg.enableDailyContext) return;
-		const dailyContextId = await getOrCreateContext(store, uc, dailyContextStoreKey(sourceName, dayKey), {
-			source: sourceName,
-			host: cfg.host,
-			engineer_id: cfg.engineerId,
-			day: dayKey,
-			context_kind: "daily"
-		}, sourceName);
-		await uc.append(dailyContextId, payload);
-		bumpStat("appended");
-		bumpSourceStat(sourceName, "appended");
-		if (cfg.logAppends) log("info", "Appended event to daily context", {
-			source: sourceName,
-			day: dayKey,
-			context_id: dailyContextId,
-			event_type: normalized.eventType,
-			session_id: normalized.sessionId,
-			event_id: eventId
-		});
 	}
 	async function readNewLines(filePath, offset) {
 		const handle = await fs$1.open(filePath, "r");
@@ -1526,7 +1505,7 @@ async function daemonBoot({ createStore, resolveDbPath }) {
 					lastSessionId: normalized.sessionId,
 					lastAt: Date.now()
 				});
-				const eventId = sha256(`${source.name}|${cfg.host}|${cfg.engineerId}|${normalized.sessionId}|${fileId}|${lineOffset}|${sha256(line)}`);
+				const eventId = sha256(`${source.name}|${cfg.host}|${cfg.userId}|${normalized.sessionId}|${fileId}|${lineOffset}|${sha256(line)}`);
 				if (!markEventSeen(store, source.name, eventId)) {
 					bumpStat("deduped");
 					bumpSourceStat(source.name, "deduped");
@@ -1593,7 +1572,7 @@ async function daemonBoot({ createStore, resolveDbPath }) {
 			const value = message?.data?.value;
 			if (!key) throw new Error("config key is required");
 			if (key === "claudeIncludeSubagents") {
-				cfg.claudeIncludeSubagents = parseBool(value, cfg.claudeIncludeSubagents);
+				cfg.claudeIncludeSubagents = boolFromEnv(value, cfg.claudeIncludeSubagents);
 				applyRuntimeSources(buildSources());
 				await persistDaemonConfigEverywhere();
 				log("info", "Config updated via TUI", {
@@ -1615,7 +1594,7 @@ async function daemonBoot({ createStore, resolveDbPath }) {
 				return { config: serializeConfigPrefs() };
 			}
 			if (key === "bootstrapReset") {
-				cfg.bootstrapReset = parseBool(value, false);
+				cfg.bootstrapReset = boolFromEnv(value, false);
 				if (cfg.bootstrapReset) await resetBootstrapState();
 				await persistDaemonConfigEverywhere();
 				log("info", "Config updated via TUI", {
@@ -1721,7 +1700,7 @@ async function daemonBoot({ createStore, resolveDbPath }) {
 		applyRuntimeSources(sources);
 		runtime.lockHandle = await acquireFileLock({
 			lockPath: cfg.lockFile,
-			engineerId: cfg.engineerId,
+			userId: cfg.userId,
 			host: cfg.host
 		});
 		const uc = new UltraContext({
@@ -1748,7 +1727,7 @@ async function daemonBoot({ createStore, resolveDbPath }) {
 		runtime.wsServer = wsServer;
 		const wsInfo = await wsServer.start();
 		log("info", "UltraContext daemon started", {
-			engineer_id: cfg.engineerId,
+			user_id: cfg.userId,
 			host: cfg.host,
 			poll_ms: cfg.pollMs,
 			mode: "headless",