synomem 0.1.0 → 0.2.0

package/dist/storage.d.ts

@@ -1,7 +1,7 @@
 import { DatabaseSync } from 'node:sqlite';
 import type { SynomemRepository } from './ports/repository.js';
 import { SynomemError } from './errors.js';
-import type { ActorIdentity, SynomemConfig, SynomemConfigOverrides, AgentProfile, ChangePage, SynomemEvent, ItemListInput, ItemSummary, RecordKind, KudosListInput, KudosSummary, Page } from './types.js';
+import type { ActorIdentity, SynomemConfig, SynomemConfigOverrides, AgentProfile, AgentRuntimeBinding, ChangePage, JsonValue, SynomemEvent, ItemListInput, ItemSummary, RecordKind, KudosListInput, KudosSummary, Page } from './types.js';
 interface EventRow {
     id: string;
     payload: string;
@@ -80,6 +80,46 @@ export declare class SynomemStorage implements SynomemRepository {
     insertAgent(profile: AgentProfile): void;
     updateAgent(profile: AgentProfile, updatedAt: string): void;
     getAgent(idOrAlias: string): AgentProfile | undefined;
+    /**
+     * Resolves a name to a canonical agent, reporting ambiguity rather than
+     * guessing.
+     *
+     * The plan is specific: `mycroft`, `Mycroft` and `Mike` may all resolve to one
+     * agent, but a name two visible agents both claim must return candidates. An
+     * alias that collides with a different agent's canonical ID is exactly that
+     * case — silently preferring the ID would attribute work to the wrong agent,
+     * and the person who typed the name would never know.
+     */
+    resolveAgent(query: string): {
+        match?: AgentProfile;
+        candidates: AgentProfile[];
+    };
+    listRuntimeBindings(agentId: string): AgentRuntimeBinding[];
+    bindRuntime(binding: {
+        id: string;
+        agentId: string;
+        installationId?: string;
+        runtime: string;
+        profile?: string;
+        capabilities?: Record<string, JsonValue>;
+        boundAt: string;
+    }): void;
+    unbindRuntime(bindingId: string): boolean;
+    /**
+     * Advisory only. Records that Synomem observed this binding act — never that
+     * the runtime is reachable now, and never that a delivery succeeded.
+     */
+    touchRuntimeBinding(agentId: string, runtime: string, at: string): void;
+    /**
+     * Writes an agent's aliases, refusing any that would make a name ambiguous.
+     *
+     * Two collisions matter and both are rejected here rather than at lookup: an
+     * alias another agent already claims, and an alias equal to a different
+     * agent's canonical ID. Catching them at write means the person adding the
+     * alias sees the conflict, instead of a later reader silently getting one of
+     * two possible agents.
+     */
+    private insertAliases;
     listAgents(): AgentProfile[];
     replaceProjectionManifest(paths: string[], generatedAt: string): void;
     replaceAgentProjectionManifest(agentId: string, paths: string[], generatedAt: string): void;

package/dist/storage.d.ts.map

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

package/dist/storage.js

@@ -5,6 +5,7 @@ import { DatabaseSync } from 'node:sqlite';
 import { defaultConfig, mergeConfig } from './config.js';
 import { asSynomemError, SynomemError } from './errors.js';
 import { assertNoSymlinkEscape, atomicWriteFile, ensureDirectory, readJsonFile, } from './fs-utils.js';
+import { dueInstant } from './projections.js';
 import { actorSchema, eventSchema, profileSchema } from './schemas.js';
 const migrationV1 = `
 CREATE TABLE IF NOT EXISTS schema_migrations (
@@ -96,6 +97,52 @@ CREATE INDEX kudos_current_recipient ON kudos_current(recipient_agent_id, given_
 CREATE INDEX kudos_current_actor ON kudos_current(actor_kind, actor_id, given_sequence DESC);
 CREATE INDEX kudos_current_status ON kudos_current(status, revocation_status, given_sequence DESC);
 `;
+/**
+ * v4 records a task's or todo's deadline on the item index.
+ *
+ * The plan asks for "accepted Tasks past their due date" as a bounded query.
+ * Answering that from the event log means replaying every task on every call,
+ * so the deadline is projected alongside the rest of the summary. It is stored
+ * as an ISO instant: a date-only due date resolves to the end of that day, so
+ * "overdue" means the day has actually passed rather than merely started.
+ */
+const migrationV4 = `
+ALTER TABLE items_current ADD COLUMN due_at TEXT;
+CREATE INDEX items_current_due ON items_current(kind, status, due_at);
+`;
+/**
+ * v5 makes alias lookup case-insensitive and unambiguous.
+ *
+ * The plan requires that `mycroft`, `Mycroft` and `Mike` may all resolve to one
+ * canonical agent, while a name two agents both claim must return candidates
+ * rather than guessing. A normalized column with a unique index enforces the
+ * second half at write time: the collision is refused when the alias is added,
+ * not discovered later by whoever happens to look it up first.
+ *
+ * Runtime bindings arrive here too. An agent is not one harness forever —
+ * Mycroft may run Hermes on two machines, or move between harnesses — so the
+ * binding is its own row keyed by agent, installation, runtime and profile
+ * rather than a field on the agent.
+ */
+const migrationV5 = `
+ALTER TABLE aliases ADD COLUMN normalized_alias TEXT;
+UPDATE aliases SET normalized_alias = lower(alias);
+CREATE UNIQUE INDEX aliases_normalized ON aliases(normalized_alias);
+
+CREATE TABLE agent_runtime_bindings (
+  id TEXT PRIMARY KEY,
+  agent_id TEXT NOT NULL REFERENCES agents(id) ON DELETE CASCADE,
+  installation_id TEXT,
+  runtime TEXT NOT NULL,
+  profile TEXT,
+  capabilities_json TEXT NOT NULL DEFAULT '{}' CHECK (json_valid(capabilities_json)),
+  bound_at TEXT NOT NULL,
+  last_seen_at TEXT
+) STRICT;
+CREATE UNIQUE INDEX agent_runtime_bindings_unique
+  ON agent_runtime_bindings(agent_id, runtime, COALESCE(profile, ''), COALESCE(installation_id, ''));
+CREATE INDEX agent_runtime_bindings_agent ON agent_runtime_bindings(agent_id);
+`;
 const migrationV3 = `
 DROP TRIGGER IF EXISTS events_append_only_update;
 DROP TRIGGER IF EXISTS events_append_only_delete;
@@ -203,6 +250,13 @@ function itemSummaryFromRow(row) {
         ...(row.assignee_agent_id ? { assigneeAgentId: row.assignee_agent_id } : {}),
     };
 }
+/**
+ * Resolves a due value to a comparable instant.
+ *
+ * A date-only deadline resolves to the END of that day, so "overdue" means the
+ * day has passed rather than merely begun. Treating 2026-09-15 as midnight
+ * would report a task due today as already late.
+ */
 function eventKind(event) {
     if (event.type.startsWith('kudos.'))
         return 'kudos';
@@ -210,6 +264,8 @@ function eventKind(event) {
         return 'memo';
     if (event.type.startsWith('note.'))
         return 'note';
+    if (event.type.startsWith('task.'))
+        return 'task';
     if (event.type.startsWith('todo.'))
         return 'todo';
     return undefined;
@@ -321,7 +377,7 @@ export class SynomemStorage {
     migrate() {
         const db = this.db();
         const version = Number(db.prepare('PRAGMA user_version').get().user_version);
-        if (version > 3) {
+        if (version > 5) {
             throw new SynomemError('UNSUPPORTED_SCHEMA', `Database schema version ${version} is newer than this package supports.`);
         }
         if (version === 0) {
@@ -344,19 +400,38 @@ export class SynomemStorage {
         if (afterV2 === 2) {
             this.transactionSync(() => {
                 db.exec(migrationV3);
-                this.rebuildItemsCurrentIndex();
+                // The item index is left empty here and populated by v4, which adds the
+                // due-date column the projection writes. Rebuilding before that column
+                // exists fails on the first task.
                 db.prepare('INSERT OR IGNORE INTO schema_migrations(version, applied_at) VALUES (?, ?)').run(3, new Date().toISOString());
                 db.exec('PRAGMA user_version = 3');
             });
         }
+        const afterV3 = Number(db.prepare('PRAGMA user_version').get().user_version);
+        if (afterV3 === 3) {
+            this.transactionSync(() => {
+                db.exec(migrationV4);
+                this.rebuildItemsCurrentIndex();
+                db.prepare('INSERT OR IGNORE INTO schema_migrations(version, applied_at) VALUES (?, ?)').run(4, new Date().toISOString());
+                db.exec('PRAGMA user_version = 4');
+            });
+        }
+        const afterV4 = Number(db.prepare('PRAGMA user_version').get().user_version);
+        if (afterV4 === 4) {
+            this.transactionSync(() => {
+                db.exec(migrationV5);
+                db.prepare('INSERT OR IGNORE INTO schema_migrations(version, applied_at) VALUES (?, ?)').run(5, new Date().toISOString());
+                db.exec('PRAGMA user_version = 5');
+            });
+        }
     }
     assertSchemaSupported() {
         const version = Number(this.db().prepare('PRAGMA user_version').get().user_version);
-        if (version !== 3) {
-            if (version === 1 || version === 2) {
-                throw new SynomemError('UNSUPPORTED_SCHEMA', 'Database schema version 1 requires migration. Open this home once with readOnly: false, then retry the read-only client.');
+        if (version !== 5) {
+            if (version >= 1 && version <= 4) {
+                throw new SynomemError('UNSUPPORTED_SCHEMA', `Database schema version ${version} requires migration. Open this home once with readOnly: false, then retry the read-only client.`);
             }
-            throw new SynomemError('UNSUPPORTED_SCHEMA', `Expected database schema version 3; found ${version}.`);
+            throw new SynomemError('UNSUPPORTED_SCHEMA', `Expected database schema version 5; found ${version}.`);
         }
     }
     db() {
@@ -477,9 +552,9 @@ export class SynomemStorage {
           item_id, kind, created_sequence, updated_sequence, created_at, updated_at,
           actor_kind, actor_id, actor_display_name, title, tags_json, visibility, status,
           recipient_agent_id, recipient_display_name, owner_agent_id, owner_display_name,
-          assignee_agent_id, assignee_display_name
-        ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`)
-                .run(event.aggregateId, values.kind, sequence, sequence, event.createdAt, event.createdAt, event.actor.kind, event.actor.id, event.actor.displayName ?? null, values.title, JSON.stringify(values.tags ?? []), values.visibility, values.status, values.recipientAgentId ?? null, values.recipientDisplayName ?? null, values.ownerAgentId ?? null, values.ownerDisplayName ?? null, values.assigneeAgentId ?? null, values.assigneeDisplayName ?? null);
+          assignee_agent_id, assignee_display_name, due_at
+        ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`)
+                .run(event.aggregateId, values.kind, sequence, sequence, event.createdAt, event.createdAt, event.actor.kind, event.actor.id, event.actor.displayName ?? null, values.title, JSON.stringify(values.tags ?? []), values.visibility, values.status, values.recipientAgentId ?? null, values.recipientDisplayName ?? null, values.ownerAgentId ?? null, values.ownerDisplayName ?? null, values.assigneeAgentId ?? null, values.assigneeDisplayName ?? null, values.dueAt ?? null);
         };
         const updateStatus = (status) => {
             this.db()
@@ -535,33 +610,63 @@ export class SynomemStorage {
         }
         else if (event.type === 'note.archived')
             updateStatus('archived');
-        else if (event.type === 'todo.created') {
+        else if (event.type === 'task.created') {
             insert({
-                kind: 'todo',
+                kind: 'task',
                 title: event.title,
                 tags: event.tags,
                 visibility: event.visibility,
                 status: event.requiresAcceptance ? 'assigned' : 'open',
                 assigneeAgentId: event.assigneeAgentId,
                 assigneeDisplayName: event.assigneeDisplayName,
+                ...((due) => (due ? { dueAt: due } : {}))(dueInstant(event.due)),
             });
         }
-        else if (event.type === 'todo.updated') {
+        else if (event.type === 'task.updated') {
             this.db()
-                .prepare(`UPDATE items_current SET title = ?, tags_json = ?, visibility = ?,
+                .prepare(`UPDATE items_current SET title = ?, tags_json = ?, visibility = ?, due_at = ?,
          updated_sequence = ?, updated_at = ? WHERE item_id = ?`)
-                .run(event.title, JSON.stringify(event.tags ?? []), event.visibility, sequence, event.createdAt, event.aggregateId);
+                .run(event.title, JSON.stringify(event.tags ?? []), event.visibility, dueInstant(event.due) ?? null, sequence, event.createdAt, event.aggregateId);
         }
-        else if (event.type === 'todo.accepted')
+        else if (event.type === 'task.accepted')
             updateStatus('open');
-        else if (event.type === 'todo.rejected')
+        else if (event.type === 'task.rejected')
             updateStatus('rejected');
+        else if (event.type === 'task.completed')
+            updateStatus('completed');
+        else if (event.type === 'task.reopened')
+            updateStatus('open');
+        else if (event.type === 'task.canceled')
+            updateStatus('canceled');
+        else if (event.type === 'todo.created') {
+            // A Todo's owner IS its author, and it is always private. Recording the
+            // owner explicitly rather than inferring it from the actor keeps the
+            // owner-scoped read filters uniform across notes and todos.
+            insert({
+                kind: 'todo',
+                title: event.title,
+                tags: event.tags,
+                visibility: 'private',
+                status: 'open',
+                ownerAgentId: event.actor.id,
+                ...(event.actor.displayName ? { ownerDisplayName: event.actor.displayName } : {}),
+                ...((due) => (due ? { dueAt: due } : {}))(dueInstant(event.due)),
+            });
+        }
+        else if (event.type === 'todo.updated') {
+            this.db()
+                .prepare(`UPDATE items_current SET title = ?, tags_json = ?, due_at = ?,
+         updated_sequence = ?, updated_at = ? WHERE item_id = ?`)
+                .run(event.title, JSON.stringify(event.tags ?? []), dueInstant(event.due) ?? null, sequence, event.createdAt, event.aggregateId);
+        }
         else if (event.type === 'todo.completed')
             updateStatus('completed');
         else if (event.type === 'todo.reopened')
             updateStatus('open');
         else if (event.type === 'todo.canceled')
             updateStatus('canceled');
+        else if (event.type === 'todo.archived')
+            updateStatus('archived');
     }
     rebuildItemsCurrentIndex() {
         this.db().prepare('DELETE FROM items_current').run();
@@ -776,7 +881,7 @@ export class SynomemStorage {
         if (input.pending) {
             add(`((kind = 'kudos' AND status = 'unacknowledged') OR
         (kind = 'memo' AND status = 'unread') OR
-        (kind = 'todo' AND status IN ('assigned', 'open')))`);
+        (kind = 'task' AND status IN ('assigned', 'open')))`);
         }
         if (input.visibility)
             add('visibility = ?', input.visibility);
@@ -784,6 +889,31 @@ export class SynomemStorage {
             add('created_at >= ?', input.from);
         if (input.to)
             add('created_at <= ?', input.to);
+        // Unanswered discovery: items still waiting for somebody to respond. Kept
+        // distinct from `pending`, which also counts accepted-and-in-progress work.
+        if (input.awaitingResponse) {
+            add(`((kind = 'kudos' AND status = 'unacknowledged') OR
+        (kind = 'memo' AND status = 'unread') OR
+        (kind = 'task' AND status = 'assigned'))`);
+        }
+        if (input.awaitingSince)
+            add('created_at <= ?', input.awaitingSince);
+        // Overdue discovery: a deadline that has passed, on work still open. A
+        // completed or canceled item is not overdue, however late it was.
+        if (input.overdueAsOf) {
+            add(`(due_at IS NOT NULL AND due_at < ? AND status IN ('assigned', 'open'))`, input.overdueAsOf);
+        }
+        /*
+         * Private todos are owner-only for EVERY viewer, including a human.
+         *
+         * The visibility rules below exempt human actors, on the reasoning that a
+         * person operating a local home is its operator. That does not extend to
+         * todos: the plan is explicit that a todo is visible only to its owner
+         * except through an explicitly authorized administrative capability, and
+         * this release has no such capability. Without this clause a human actor
+         * would see every agent's private reminders in an item list.
+         */
+        add(`(kind != 'todo' OR (owner_agent_id = ? AND ? = 'agent') OR (actor_id = ? AND actor_kind = ?))`, viewer.id, viewer.kind, viewer.id, viewer.kind);
         if (viewer.kind !== 'human') {
             if (viewer.kind === 'agent') {
                 add(`(visibility != 'private' OR (actor_kind = ? AND actor_id = ?) OR
@@ -954,7 +1084,7 @@ export class SynomemStorage {
     itemIndexHealth() {
         const created = Number(this.db()
             .prepare(`SELECT COUNT(*) AS count FROM events WHERE type IN
-       ('kudos.given', 'memo.sent', 'note.created', 'todo.created')`)
+       ('kudos.given', 'memo.sent', 'note.created', 'task.created')`)
             .get().count);
         const indexed = Number(this.db().prepare('SELECT COUNT(*) AS count FROM items_current').get()
             .count);
@@ -1071,13 +1201,19 @@ export class SynomemStorage {
                     'note.created',
                     'note.revised',
                     'note.archived',
+                    'task.created',
+                    'task.updated',
+                    'task.completed',
+                    'task.reopened',
+                    'task.accepted',
+                    'task.rejected',
+                    'task.canceled',
                     'todo.created',
                     'todo.updated',
                     'todo.completed',
                     'todo.reopened',
-                    'todo.accepted',
-                    'todo.rejected',
                     'todo.canceled',
+                    'todo.archived',
                 ]);
                 if ((typeof candidate.schemaVersion === 'number' && candidate.schemaVersion > 1) ||
                     (typeof candidate.type === 'string' && !supportedTypes.has(candidate.type))) {
@@ -1091,7 +1227,7 @@ export class SynomemStorage {
                         legacy.kudosId ??
                             legacy.memoId ??
                             legacy.noteId ??
-                            legacy.todoId ??
+                            legacy.taskId ??
                             (typeof legacy.agentId === 'string' ? legacy.agentId : undefined) ??
                             (typeof legacy.agent === 'object' && legacy.agent !== null
                                 ? legacy.agent.id
@@ -1125,9 +1261,7 @@ export class SynomemStorage {
         this.db()
             .prepare('INSERT INTO agents(id, display_name, profile_json, created_at, updated_at) VALUES (?, ?, ?, ?, ?)')
             .run(parsed.id, parsed.displayName, JSON.stringify(parsed), parsed.createdAt, parsed.createdAt);
-        for (const alias of parsed.aliases ?? []) {
-            this.db().prepare('INSERT INTO aliases(alias, agent_id) VALUES (?, ?)').run(alias, parsed.id);
-        }
+        this.insertAliases(parsed.id, parsed.aliases ?? []);
     }
     updateAgent(profile, updatedAt) {
         const parsed = profileSchema.parse(profile);
@@ -1135,20 +1269,104 @@ export class SynomemStorage {
             .prepare('UPDATE agents SET display_name = ?, profile_json = ?, updated_at = ? WHERE id = ?')
             .run(parsed.displayName, JSON.stringify(parsed), updatedAt, parsed.id);
         this.db().prepare('DELETE FROM aliases WHERE agent_id = ?').run(parsed.id);
-        for (const alias of parsed.aliases ?? []) {
-            this.db().prepare('INSERT INTO aliases(alias, agent_id) VALUES (?, ?)').run(alias, parsed.id);
-        }
+        this.insertAliases(parsed.id, parsed.aliases ?? []);
     }
     getAgent(idOrAlias) {
-        const direct = this.db()
-            .prepare('SELECT profile_json FROM agents WHERE id = ?')
-            .get(idOrAlias);
-        if (direct)
-            return profileSchema.parse(JSON.parse(direct.profile_json));
-        const alias = this.db()
-            .prepare('SELECT a.profile_json FROM agents a JOIN aliases x ON x.agent_id = a.id WHERE x.alias = ?')
-            .get(idOrAlias);
-        return alias ? profileSchema.parse(JSON.parse(alias.profile_json)) : undefined;
+        const resolved = this.resolveAgent(idOrAlias);
+        return resolved.match;
+    }
+    /**
+     * Resolves a name to a canonical agent, reporting ambiguity rather than
+     * guessing.
+     *
+     * The plan is specific: `mycroft`, `Mycroft` and `Mike` may all resolve to one
+     * agent, but a name two visible agents both claim must return candidates. An
+     * alias that collides with a different agent's canonical ID is exactly that
+     * case — silently preferring the ID would attribute work to the wrong agent,
+     * and the person who typed the name would never know.
+     */
+    resolveAgent(query) {
+        const normalized = query.trim().toLowerCase();
+        const rows = this.db()
+            .prepare(`SELECT DISTINCT a.profile_json
+           FROM agents a
+           LEFT JOIN aliases x ON x.agent_id = a.id
+          WHERE lower(a.id) = ? OR x.normalized_alias = ?
+          ORDER BY a.id ASC`)
+            .all(normalized, normalized);
+        const candidates = rows.map((row) => profileSchema.parse(JSON.parse(row.profile_json)));
+        return candidates.length === 1 ? { match: candidates[0], candidates } : { candidates };
+    }
+    /* ------------------------------------------------------- runtime bindings */
+    listRuntimeBindings(agentId) {
+        const rows = this.db()
+            .prepare(`SELECT id, agent_id, installation_id, runtime, profile, capabilities_json,
+                bound_at, last_seen_at
+           FROM agent_runtime_bindings WHERE agent_id = ? ORDER BY bound_at ASC`)
+            .all(agentId);
+        return rows.map((row) => ({
+            id: row.id,
+            agentId: row.agent_id,
+            ...(row.installation_id ? { installationId: row.installation_id } : {}),
+            runtime: row.runtime,
+            ...(row.profile ? { profile: row.profile } : {}),
+            capabilities: JSON.parse(row.capabilities_json),
+            boundAt: row.bound_at,
+            ...(row.last_seen_at ? { lastSeenAt: row.last_seen_at } : {}),
+        }));
+    }
+    bindRuntime(binding) {
+        this.db()
+            .prepare(`INSERT INTO agent_runtime_bindings(
+           id, agent_id, installation_id, runtime, profile, capabilities_json, bound_at
+         ) VALUES (?, ?, ?, ?, ?, ?, ?)
+         ON CONFLICT(agent_id, runtime, COALESCE(profile, ''), COALESCE(installation_id, ''))
+         DO UPDATE SET capabilities_json = excluded.capabilities_json`)
+            .run(binding.id, binding.agentId, binding.installationId ?? null, binding.runtime, binding.profile ?? null, JSON.stringify(binding.capabilities ?? {}), binding.boundAt);
+    }
+    unbindRuntime(bindingId) {
+        const result = this.db()
+            .prepare('DELETE FROM agent_runtime_bindings WHERE id = ?')
+            .run(bindingId);
+        return Number(result.changes) > 0;
+    }
+    /**
+     * Advisory only. Records that Synomem observed this binding act — never that
+     * the runtime is reachable now, and never that a delivery succeeded.
+     */
+    touchRuntimeBinding(agentId, runtime, at) {
+        this.db()
+            .prepare('UPDATE agent_runtime_bindings SET last_seen_at = ? WHERE agent_id = ? AND runtime = ?')
+            .run(at, agentId, runtime);
+    }
+    /**
+     * Writes an agent's aliases, refusing any that would make a name ambiguous.
+     *
+     * Two collisions matter and both are rejected here rather than at lookup: an
+     * alias another agent already claims, and an alias equal to a different
+     * agent's canonical ID. Catching them at write means the person adding the
+     * alias sees the conflict, instead of a later reader silently getting one of
+     * two possible agents.
+     */
+    insertAliases(agentId, aliases) {
+        for (const alias of aliases) {
+            const normalized = alias.trim().toLowerCase();
+            const conflictingAgent = this.db()
+                .prepare('SELECT id FROM agents WHERE lower(id) = ? AND id != ?')
+                .get(normalized, agentId);
+            if (conflictingAgent) {
+                throw new SynomemError('ALIAS_CONFLICT', `Alias "${alias}" is already the canonical ID of agent ${conflictingAgent.id}. Aliases must resolve to exactly one agent.`);
+            }
+            const conflictingAlias = this.db()
+                .prepare('SELECT agent_id FROM aliases WHERE normalized_alias = ? AND agent_id != ?')
+                .get(normalized, agentId);
+            if (conflictingAlias) {
+                throw new SynomemError('ALIAS_CONFLICT', `Alias "${alias}" already belongs to agent ${conflictingAlias.agent_id}. Aliases must resolve to exactly one agent.`);
+            }
+            this.db()
+                .prepare('INSERT INTO aliases(alias, agent_id, normalized_alias) VALUES (?, ?, ?)')
+                .run(alias, agentId, normalized);
+        }
     }
     listAgents() {
         const rows = this.db()