Add update functionality and Docker API client integration

- Introduced the `bollard` crate for Docker API interactions, enabling self-update capabilities via the Docker socket.
- Implemented update checking and applying mechanisms in the API, allowing for programmatic version checks and updates.
- Enhanced the API server with new routes for update status and application, improving user experience for managing updates.
- Updated the documentation to include instructions for manual and one-click updates, ensuring users are informed about the new features.
- Added a background update checker to monitor for new releases, enhancing the system's responsiveness to updates.

Author: jamiepine

.github/workflows/release.yml

@@ -55,6 +55,19 @@ jobs:
           tags: |
             ${{ env.IMAGE }}:${{ steps.version.outputs.version }}-slim
             ${{ env.IMAGE }}:slim
+            ${{ env.IMAGE }}:latest
+          cache-from: type=gha
+          cache-to: type=gha,mode=max
+
+      - name: Build and push full
+        uses: docker/build-push-action@v6
+        with:
+          context: .
+          target: full
+          push: true
+          tags: |
+            ${{ env.IMAGE }}:${{ steps.version.outputs.version }}-full
+            ${{ env.IMAGE }}:full
           cache-from: type=gha
           cache-to: type=gha,mode=max
 

Cargo.lock

@@ -104,6 +104,12 @@ chromiumoxide_cdp = "0.8"
 # Templating for prompts
 minijinja = "2.8"
 
+# Docker API client (for self-update via Docker socket)
+bollard = "0.18"
+
+# Semver parsing (for update version comparison)
+semver = "1"
+
 [lints.clippy]
 dbg_macro = "forbid"
 todo = "forbid"

Cargo.toml

@@ -52,6 +52,7 @@ COPY docker-entrypoint.sh /usr/local/bin/docker-entrypoint.sh
 RUN chmod +x /usr/local/bin/docker-entrypoint.sh
 
 ENV SPACEBOT_DIR=/data
+ENV SPACEBOT_DEPLOYMENT=docker
 EXPOSE 19898 18789
 
 VOLUME /data

Dockerfile

@@ -202,6 +202,55 @@ healthcheck:
 - Graceful shutdown on `SIGTERM` (what `docker stop` sends). Drains active channels, closes database connections.
 - The PID file and Unix socket (used in daemon mode) are not created.
 
+## Updates
+
+Spacebot checks for new releases on startup and every hour. When a new version is available, a banner appears in the web UI.
+
+### Manual Update
+
+```bash
+docker pull ghcr.io/spacedriveapp/spacebot:slim
+docker compose up -d
+```
+
+### One-Click Update
+
+Mount the Docker socket to enable updating directly from the web UI:
+
+```yaml
+services:
+  spacebot:
+    image: ghcr.io/spacedriveapp/spacebot:slim
+    container_name: spacebot
+    restart: unless-stopped
+    ports:
+      - "19898:19898"
+    volumes:
+      - spacebot-data:/data
+      - /var/run/docker.sock:/var/run/docker.sock
+    environment:
+      - ANTHROPIC_API_KEY=${ANTHROPIC_API_KEY}
+```
+
+When the socket is mounted, the update banner shows an **Update now** button that pulls the new image and recreates the container automatically. Your `/data` volume is preserved across updates.
+
+Without the socket mount, the banner still notifies you of new versions but you'll need to update manually.
+
+### Update API
+
+You can also check for and trigger updates programmatically:
+
+```bash
+# Check for updates
+curl http://localhost:19898/api/update/check
+
+# Force a fresh check
+curl -X POST http://localhost:19898/api/update/check
+
+# Apply update (requires Docker socket)
+curl -X POST http://localhost:19898/api/update/apply
+```
+
 ## CI / Releases
 
 Images are built and pushed to `ghcr.io/spacedriveapp/spacebot` via GitHub Actions (`.github/workflows/release.yml`).
@@ -217,12 +266,9 @@ Images are built and pushed to `ghcr.io/spacedriveapp/spacebot` via GitHub Actio
 |-----|-------------|
 | `v0.1.0-slim` | Versioned slim |
 | `v0.1.0-full` | Versioned full |
-| `v0.1.0` | Versioned (points to full) |
 | `slim` | Rolling slim |
 | `full` | Rolling full |
-| `latest` | Rolling (points to full) |
-
-The `latest` tag always points to the `full` variant.
+| `latest` | Rolling (points to slim) |
 
 ## Fly.io Deployment
 

docs/content/docs/(getting-started)/docker.mdx

@@ -2,6 +2,7 @@ const API_BASE = "/api";
 
 export interface StatusResponse {
 	status: string;
+	version: string;
 	pid: number;
 	uptime_seconds: number;
 }
@@ -236,11 +237,31 @@ export interface AgentSummary {
 }
 
 export interface InstanceOverviewResponse {
+	version: string;
 	uptime_seconds: number;
 	pid: number;
 	agents: AgentSummary[];
 }
 
+export type Deployment = "docker" | "native";
+
+export interface UpdateStatus {
+	current_version: string;
+	latest_version: string | null;
+	update_available: boolean;
+	release_url: string | null;
+	release_notes: string | null;
+	deployment: Deployment;
+	can_apply: boolean;
+	checked_at: string | null;
+	error: string | null;
+}
+
+export interface UpdateApplyResponse {
+	status: "updating" | "error";
+	error?: string;
+}
+
 export type MemoryType =
 	| "fact"
 	| "preference"
@@ -955,5 +976,22 @@ export const api = {
 		return response.json() as Promise<DeleteBindingResponse>;
 	},
 
+	// Update API
+	updateCheck: () => fetchJson<UpdateStatus>("/update/check"),
+	updateCheckNow: async () => {
+		const response = await fetch(`${API_BASE}/update/check`, { method: "POST" });
+		if (!response.ok) {
+			throw new Error(`API error: ${response.status}`);
+		}
+		return response.json() as Promise<UpdateStatus>;
+	},
+	updateApply: async () => {
+		const response = await fetch(`${API_BASE}/update/apply`, { method: "POST" });
+		if (!response.ok) {
+			throw new Error(`API error: ${response.status}`);
+		}
+		return response.json() as Promise<UpdateApplyResponse>;
+	},
+
 	eventsUrl: `${API_BASE}/events`,
 };

interface/src/api/client.ts

@@ -0,0 +1,83 @@
+import {useState} from "react";
+import {useQuery, useMutation} from "@tanstack/react-query";
+import {api} from "@/api/client";
+
+export function UpdateBanner() {
+	const [dismissed, setDismissed] = useState(false);
+
+	const {data} = useQuery({
+		queryKey: ["updateCheck"],
+		queryFn: api.updateCheck,
+		staleTime: 60_000,
+		refetchInterval: 300_000,
+	});
+
+	const applyMutation = useMutation({
+		mutationFn: api.updateApply,
+		onSuccess: (result) => {
+			if (result.status === "error") {
+				setApplyError(result.error ?? "Update failed");
+			}
+		},
+	});
+
+	const [applyError, setApplyError] = useState<string | null>(null);
+
+	if (!data || !data.update_available || dismissed) return null;
+
+	const isApplying = applyMutation.isPending;
+
+	return (
+		<div className="border-b border-cyan-500/20 bg-cyan-500/10 px-4 py-2 text-sm text-cyan-400">
+			<div className="flex items-center justify-between">
+				<div className="flex items-center gap-2">
+					<div className="h-1.5 w-1.5 rounded-full bg-current" />
+					<span>
+						Version <strong>{data.latest_version}</strong> is available
+						<span className="text-ink-faint ml-1">(current: {data.current_version})</span>
+					</span>
+					{data.release_url && (
+						<a
+							href={data.release_url}
+							target="_blank"
+							rel="noopener noreferrer"
+							className="underline hover:text-cyan-300"
+						>
+							Release notes
+						</a>
+					)}
+				</div>
+				<div className="flex items-center gap-2">
+					{data.can_apply && (
+						<button
+							onClick={() => {
+								setApplyError(null);
+								applyMutation.mutate();
+							}}
+							disabled={isApplying}
+							className="rounded bg-cyan-500/20 px-2.5 py-1 text-xs font-medium text-cyan-300 hover:bg-cyan-500/30 disabled:opacity-50"
+						>
+							{isApplying ? "Updating..." : "Update now"}
+						</button>
+					)}
+					{!data.can_apply && data.deployment === "docker" && (
+						<span className="text-xs text-ink-faint">
+							Mount docker.sock for one-click updates
+						</span>
+					)}
+					<button
+						onClick={() => setDismissed(true)}
+						className="text-ink-faint hover:text-ink ml-1"
+					>
+						<svg width="14" height="14" viewBox="0 0 14 14" fill="none">
+							<path d="M3.5 3.5l7 7M10.5 3.5l-7 7" stroke="currentColor" strokeWidth="1.5" strokeLinecap="round" />
+						</svg>
+					</button>
+				</div>
+			</div>
+			{applyError && (
+				<div className="mt-1 text-xs text-red-400">{applyError}</div>
+			)}
+		</div>
+	);
+}