Self-hosted, Self-Improving, Federated Everything App — dev management, agent orchestration, persistent mind, digital twin, second brain, and creative pipeline from a single dashboard over Tailscale to port the user into the OS
JavaScript ai-agentsdashboarddeveloper-toolsdigital-twinquantified-selfsecond-brainself-hostedtailscale
/**
* GET /api/media/annotations
* → { annotations: { [key]: { own: { authorName, starred, note, updatedAt } | null,
* others: [{ instanceId, authorName, starred, note, updatedAt }] } } }
* PATCH /api/media/annotations/:key
* body: { starred?: boolean, note?: string } — writes the local-author entry
* → { key, entry: { own, others } }
*
* Key shape: `<kind>:<ref>` where kind ∈ {image, video} and ref has no `:`.
* Matches the convention enforced by mediaCollections.js and produced by the
* client-side normalize.js (`item.key`).
*/
import { Router } from 'express';
import { z } from 'zod';
import { asyncHandler, createServiceErrorMapper } from '../lib/errorHandler.js';
import { validateRequest } from '../lib/validation.js';
import * as svc from '../services/mediaAnnotations.js';
const router = Router();
const SERVICE_ERROR_STATUS = {
[svc.ERR_VALIDATION]: 400,
};
const mapServiceError = createServiceErrorMapper(SERVICE_ERROR_STATUS);
const patchSchema = z.object({
starred: z.boolean().optional(),
note: z.string().max(svc.NOTE_MAX_LENGTH).optional(),
}).refine((p) => Object.keys(p).length > 0, { message: 'patch must include starred and/or note' });
router.get('/', asyncHandler(async (_req, res) => {
res.json({ annotations: await svc.listAnnotations() });
}));
router.patch('/:key', asyncHandler(async (req, res) => {
const body = validateRequest(patchSchema, req.body ?? {});
// Express decodes the path param, but the key still has to round-trip through
// svc validation so a hand-rolled curl can't sneak past.
const entry = await svc.setAnnotation(req.params.key, body).catch((err) => { throw mapServiceError(err); });
// Broadcast so every other open view (History, Collections, Pipeline, other
// browser tabs) reflects the change without a manual refresh. Payload mirrors
// the GET shape: `entry` is `{ own, others }` (with own=null when the local
// author cleared their entry but peer notes remain).
req.app.get('io')?.emit('media:annotation:updated', { key: req.params.key, entry });
res.json({ key: req.params.key, entry });
}));
export default router;