soma-protocol 0.1.0

package/dist/utils/embedder.js

@@ -0,0 +1,97 @@
+export function createEmbedder(config) {
+    const dims = config.dimensions ?? 1536;
+    switch (config.provider) {
+        case 'openai':
+            return createOpenAIEmbedder(config, dims);
+        case 'cohere':
+            return createCohereEmbedder(config, dims);
+        case 'voyage':
+            return createVoyageEmbedder(config, dims);
+        case 'custom':
+            return createCustomEmbedder(config, dims);
+        default:
+            throw new Error(`Unknown embedder provider: ${config.provider}`);
+    }
+}
+function createOpenAIEmbedder(config, dims) {
+    const baseUrl = config.baseUrl ?? 'https://api.openai.com/v1';
+    const model = config.model ?? 'text-embedding-3-small';
+    return {
+        dimensions: () => dims,
+        async embed(texts) {
+            const res = await fetch(`${baseUrl}/embeddings`, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    Authorization: `Bearer ${config.apiKey}`,
+                },
+                body: JSON.stringify({ model, input: texts, dimensions: dims }),
+            });
+            if (!res.ok) {
+                const detail = await res.text().catch(() => '');
+                throw new Error(`OpenAI embed failed (${res.status}): ${detail.slice(0, 200)}`);
+            }
+            const json = (await res.json());
+            return json.data.map(d => d.embedding);
+        },
+    };
+}
+function createCohereEmbedder(config, dims) {
+    const model = config.model ?? 'embed-english-v3.0';
+    return {
+        dimensions: () => dims,
+        async embed(texts) {
+            const res = await fetch('https://api.cohere.ai/v1/embed', {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    Authorization: `Bearer ${config.apiKey}`,
+                },
+                body: JSON.stringify({ model, texts, input_type: 'search_document', embedding_types: ['float'] }),
+            });
+            if (!res.ok)
+                throw new Error(`Cohere embed failed (${res.status})`);
+            const json = (await res.json());
+            return json.embeddings.float;
+        },
+    };
+}
+function createVoyageEmbedder(config, dims) {
+    const model = config.model ?? 'voyage-3';
+    return {
+        dimensions: () => dims,
+        async embed(texts) {
+            const res = await fetch('https://api.voyageai.com/v1/embeddings', {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    Authorization: `Bearer ${config.apiKey}`,
+                },
+                body: JSON.stringify({ model, input: texts }),
+            });
+            if (!res.ok)
+                throw new Error(`Voyage embed failed (${res.status})`);
+            const json = (await res.json());
+            return json.data.map(d => d.embedding);
+        },
+    };
+}
+function createCustomEmbedder(config, dims) {
+    if (!config.baseUrl)
+        throw new Error('Custom embedder requires baseUrl');
+    return {
+        dimensions: () => dims,
+        async embed(texts) {
+            const res = await fetch(config.baseUrl, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({ texts }),
+            });
+            if (!res.ok)
+                throw new Error(`Custom embed failed (${res.status})`);
+            const json = (await res.json());
+            return json.embeddings;
+        },
+    };
+}
+//# sourceMappingURL=embedder.js.map

package/dist/utils/embedder.js.map

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

package/dist/utils/forgetting.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Recall probability via exponential decay.
+ * importance=1 -> half-life 30 days. importance=0.1 -> half-life ~3 hours.
+ */
+export declare function calculateRecallProbability(timestamp: string, importance: number): number;
+/**
+ * Recency score: exponential decay over days.
+ * 1.0 for now, ~0.37 after 1 day, ~0.01 after 3 days.
+ */
+export declare function recencyScore(timestamp: string, decayDays?: number): number;
+/**
+ * Composite relevance: recency + importance + confidence.
+ */
+export declare function relevanceScore(opts: {
+    timestamp: string;
+    importance: number;
+    confidence: number;
+    recencyWeight?: number;
+    importanceWeight?: number;
+    confidenceWeight?: number;
+}): number;
+//# sourceMappingURL=forgetting.d.ts.map

package/dist/utils/forgetting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"forgetting.d.ts","sourceRoot":"","sources":["../../src/utils/forgetting.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAKxF;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,GAAE,MAAU,GAAG,MAAM,CAG7E;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B,GAAG,MAAM,CAKT"}

package/dist/utils/forgetting.js

@@ -0,0 +1,29 @@
+/**
+ * Recall probability via exponential decay.
+ * importance=1 -> half-life 30 days. importance=0.1 -> half-life ~3 hours.
+ */
+export function calculateRecallProbability(timestamp, importance) {
+    const hoursSince = (Date.now() - new Date(timestamp).getTime()) / 3_600_000;
+    const halfLife = importance * 30 * 24;
+    if (halfLife <= 0)
+        return 0;
+    return Math.pow(0.5, hoursSince / halfLife);
+}
+/**
+ * Recency score: exponential decay over days.
+ * 1.0 for now, ~0.37 after 1 day, ~0.01 after 3 days.
+ */
+export function recencyScore(timestamp, decayDays = 1) {
+    const daysSince = (Date.now() - new Date(timestamp).getTime()) / 86_400_000;
+    return Math.exp(-daysSince / decayDays);
+}
+/**
+ * Composite relevance: recency + importance + confidence.
+ */
+export function relevanceScore(opts) {
+    const rw = opts.recencyWeight ?? 0.4;
+    const iw = opts.importanceWeight ?? 0.35;
+    const cw = opts.confidenceWeight ?? 0.25;
+    return rw * recencyScore(opts.timestamp) + iw * opts.importance + cw * opts.confidence;
+}
+//# sourceMappingURL=forgetting.js.map

package/dist/utils/forgetting.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"forgetting.js","sourceRoot":"","sources":["../../src/utils/forgetting.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,0BAA0B,CAAC,SAAiB,EAAE,UAAkB;IAC9E,MAAM,UAAU,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC,GAAG,SAAS,CAAC;IAC5E,MAAM,QAAQ,GAAG,UAAU,GAAG,EAAE,GAAG,EAAE,CAAC;IACtC,IAAI,QAAQ,IAAI,CAAC;QAAE,OAAO,CAAC,CAAC;IAC5B,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,UAAU,GAAG,QAAQ,CAAC,CAAC;AAC9C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,SAAiB,EAAE,YAAoB,CAAC;IACnE,MAAM,SAAS,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC,GAAG,UAAU,CAAC;IAC5E,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,SAAS,GAAG,SAAS,CAAC,CAAC;AAC1C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,IAO9B;IACC,MAAM,EAAE,GAAG,IAAI,CAAC,aAAa,IAAI,GAAG,CAAC;IACrC,MAAM,EAAE,GAAG,IAAI,CAAC,gBAAgB,IAAI,IAAI,CAAC;IACzC,MAAM,EAAE,GAAG,IAAI,CAAC,gBAAgB,IAAI,IAAI,CAAC;IACzC,OAAO,EAAE,GAAG,YAAY,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,UAAU,GAAG,EAAE,GAAG,IAAI,CAAC,UAAU,CAAC;AACzF,CAAC"}

package/dist/utils/index.d.ts

@@ -0,0 +1,4 @@
+export { validateSchema, type ValidationResult } from './validation';
+export { calculateRecallProbability, recencyScore, relevanceScore } from './forgetting';
+export { createEmbedder, type Embedder, type EmbedderConfig } from './embedder';
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,KAAK,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACrE,OAAO,EAAE,0BAA0B,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACxF,OAAO,EAAE,cAAc,EAAE,KAAK,QAAQ,EAAE,KAAK,cAAc,EAAE,MAAM,YAAY,CAAC"}

package/dist/utils/index.js

@@ -0,0 +1,4 @@
+export { validateSchema } from './validation';
+export { calculateRecallProbability, recencyScore, relevanceScore } from './forgetting';
+export { createEmbedder } from './embedder';
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAyB,MAAM,cAAc,CAAC;AACrE,OAAO,EAAE,0BAA0B,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACxF,OAAO,EAAE,cAAc,EAAsC,MAAM,YAAY,CAAC"}

package/dist/utils/json.d.ts

@@ -0,0 +1,2 @@
+export declare function parseJson<T>(value: string | unknown): T;
+//# sourceMappingURL=json.d.ts.map

package/dist/utils/json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../../src/utils/json.ts"],"names":[],"mappings":"AAAA,wBAAgB,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,CAAC,CASvD"}

package/dist/utils/json.js

@@ -0,0 +1,12 @@
+export function parseJson(value) {
+    if (typeof value === 'string') {
+        try {
+            return JSON.parse(value);
+        }
+        catch {
+            return {};
+        }
+    }
+    return value;
+}
+//# sourceMappingURL=json.js.map

package/dist/utils/json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.js","sourceRoot":"","sources":["../../src/utils/json.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,SAAS,CAAI,KAAuB;IAClD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAiB,CAAC;QAC3C,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAkB,CAAC;QAC5B,CAAC;IACH,CAAC;IACD,OAAO,KAAqB,CAAC;AAC/B,CAAC"}

package/dist/utils/validation.d.ts

@@ -0,0 +1,10 @@
+import type { z } from 'zod';
+export type ValidationResult<T> = {
+    success: true;
+    data: T;
+} | {
+    success: false;
+    error: string;
+};
+export declare function validateSchema<T>(schema: z.ZodType<T>, data: unknown): ValidationResult<T>;
+//# sourceMappingURL=validation.d.ts.map

package/dist/utils/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/utils/validation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B,MAAM,MAAM,gBAAgB,CAAC,CAAC,IAC1B;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,CAAC,CAAA;CAAE,GAC1B;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtC,wBAAgB,cAAc,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAO1F"}

package/dist/utils/validation.js

@@ -0,0 +1,9 @@
+export function validateSchema(schema, data) {
+    const result = schema.safeParse(data);
+    if (result.success) {
+        return { success: true, data: result.data };
+    }
+    const messages = result.error.issues.map(i => `${i.path.join('.')}: ${i.message}`);
+    return { success: false, error: messages.join('; ') };
+}
+//# sourceMappingURL=validation.js.map

package/dist/utils/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../src/utils/validation.ts"],"names":[],"mappings":"AAMA,MAAM,UAAU,cAAc,CAAI,MAAoB,EAAE,IAAa;IACnE,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IACtC,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;IAC9C,CAAC;IACD,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;IACnF,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;AACxD,CAAC"}

package/package.json

@@ -0,0 +1,111 @@
+{
+  "name": "soma-protocol",
+  "version": "0.1.0",
+  "description": "Soma — AI agent identity, memory, learning, reputation, and social dynamics protocol",
+  "type": "module",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/tensai-os/soma-protocol"
+  },
+  "keywords": [
+    "ai",
+    "agents",
+    "protocol",
+    "memory",
+    "identity",
+    "typescript",
+    "bun",
+    "mcp"
+  ],
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./identity": {
+      "types": "./dist/extensions/identity/index.d.ts",
+      "import": "./dist/extensions/identity/index.js"
+    },
+    "./memory": {
+      "types": "./dist/extensions/memory/index.d.ts",
+      "import": "./dist/extensions/memory/index.js"
+    },
+    "./learning": {
+      "types": "./dist/extensions/learning/index.d.ts",
+      "import": "./dist/extensions/learning/index.js"
+    },
+    "./reputation": {
+      "types": "./dist/extensions/reputation/index.d.ts",
+      "import": "./dist/extensions/reputation/index.js"
+    },
+    "./emotional": {
+      "types": "./dist/extensions/emotional/index.d.ts",
+      "import": "./dist/extensions/emotional/index.js"
+    },
+    "./reflection": {
+      "types": "./dist/extensions/reflection/index.d.ts",
+      "import": "./dist/extensions/reflection/index.js"
+    },
+    "./social": {
+      "types": "./dist/extensions/social/index.d.ts",
+      "import": "./dist/extensions/social/index.js"
+    },
+    "./events": {
+      "types": "./dist/extensions/events/index.d.ts",
+      "import": "./dist/extensions/events/index.js"
+    },
+    "./utils": {
+      "types": "./dist/utils/index.d.ts",
+      "import": "./dist/utils/index.js"
+    },
+    "./adapters": {
+      "types": "./dist/adapters/index.d.ts",
+      "import": "./dist/adapters/index.js"
+    },
+    "./migrator": {
+      "types": "./dist/migrator/index.d.ts",
+      "import": "./dist/migrator/index.js"
+    },
+    "./types": {
+      "types": "./dist/types/index.d.ts",
+      "import": "./dist/types/index.js"
+    },
+    "./agent": {
+      "types": "./dist/agent/index.d.ts",
+      "import": "./dist/agent/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "schema",
+    "LICENSE",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json && tsc-alias -p tsconfig.build.json",
+    "prepublishOnly": "bun test tests/unit && bun run build",
+    "test": "bun test tests/unit",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "zod": "^4.4.3"
+  },
+  "peerDependencies": {
+    "typescript": "^5"
+  },
+  "devDependencies": {
+    "@types/bun": "latest",
+    "tsc-alias": "^1.8.16",
+    "typescript": "^5"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=18",
+    "bun": ">=1.0"
+  }
+}

package/schema/clickhouse/01-episodes.sql

@@ -0,0 +1,50 @@
+-- ClickHouse DDL for episodic memory (append-only)
+
+CREATE TABLE IF NOT EXISTS episodes (
+  episode_id      String,
+  agent_id        String,
+  tenant_id       String,
+  project_id      String DEFAULT '',
+  timestamp       DateTime64(3, 'UTC'),
+
+  -- context
+  trigger         String,
+  participants    Array(String),
+  environment     String DEFAULT '{}',
+
+  -- event
+  event_type      LowCardinality(String),
+  description     String,
+  actions_taken   String,
+  tools_used      Array(String),
+  outcome_status  LowCardinality(String),
+  quality_score   Float32,
+  outcome_impact  String DEFAULT '',
+  lessons_learned Array(String),
+
+  -- emotional
+  emotional_valence Float32,
+  arousal           Float32,
+  dominant_emotion  LowCardinality(String),
+
+  -- metadata
+  importance      Float32,
+  confidence      Float32,
+  tags            Array(String),
+  source          LowCardinality(String),
+
+  -- embeddings for semantic search
+  embedding       Array(Float32),
+
+  -- computed
+  recall_probability Float32 DEFAULT 1.0,
+
+  created_at      DateTime64(3, 'UTC') DEFAULT now()
+)
+ENGINE = ReplacingMergeTree(created_at)
+ORDER BY (agent_id, timestamp, episode_id)
+PARTITION BY toYYYYMM(timestamp);
+
+ALTER TABLE episodes ADD INDEX idx_timestamp (timestamp) TYPE minmax GRANULARITY 1;
+ALTER TABLE episodes ADD INDEX idx_event_type (event_type) TYPE set(0) GRANULARITY 1;
+ALTER TABLE episodes ADD INDEX idx_importance (importance) TYPE minmax GRANULARITY 1;

package/schema/clickhouse/02-learning-events.sql

@@ -0,0 +1,37 @@
+CREATE TABLE IF NOT EXISTS learning_events (
+  event_id          String,
+  agent_id          String,
+  tenant_id         String,
+  type              LowCardinality(String),
+  source_agent      String,
+  domain            String,
+  what_learned      String,
+  confidence        Float32,
+  behavior_change   String,
+  priority          LowCardinality(String),
+  sharing_allowed   UInt8,
+  learning_method   LowCardinality(String),
+  created_at        DateTime64(3, 'UTC') DEFAULT now()
+)
+ENGINE = ReplacingMergeTree(created_at)
+ORDER BY (agent_id, created_at, event_id)
+PARTITION BY toYYYYMM(created_at);
+
+CREATE TABLE IF NOT EXISTS observations (
+  observation_id    String,
+  observer_agent    String,
+  observed_agent    String,
+  tenant_id         String,
+  action            String,
+  context           String,
+  outcome           String,
+  quality_assessment Float32,
+  extracted_insight String,
+  extracted_confidence Float32,
+  consent_obtained  UInt8,
+  privacy_level     LowCardinality(String),
+  created_at        DateTime64(3, 'UTC') DEFAULT now()
+)
+ENGINE = ReplacingMergeTree(created_at)
+ORDER BY (observer_agent, created_at, observation_id)
+PARTITION BY toYYYYMM(created_at);

package/schema/clickhouse/03-trust-history.sql

@@ -0,0 +1,15 @@
+CREATE TABLE trust_history (
+  truster          String,
+  trustee          String,
+  tenant_id        String,
+  old_score        Float32,
+  new_score        Float32,
+  delta            Float32,
+  domain           Nullable(String),
+  reason           String,
+  interaction_id   Nullable(UUID),
+  created_at       DateTime64(3) DEFAULT now64(3)
+) ENGINE = MergeTree()
+ORDER BY (tenant_id, truster, trustee, created_at)
+PARTITION BY toYYYYMM(created_at)
+TTL created_at + INTERVAL 365 DAY;

package/schema/clickhouse/04-reflection-events.sql

@@ -0,0 +1,12 @@
+CREATE TABLE IF NOT EXISTS reflection_events (
+  event_id        String,
+  agent_id        String,
+  event_type      LowCardinality(String),
+  reflection_id   String,
+  category        LowCardinality(String),
+  timestamp       DateTime DEFAULT now(),
+  payload         String
+) ENGINE = MergeTree()
+ORDER BY (agent_id, timestamp)
+PARTITION BY toYYYYMM(timestamp)
+TTL timestamp + INTERVAL 365 DAY;

package/schema/clickhouse/05-emotional-events.sql

@@ -0,0 +1,14 @@
+CREATE TABLE IF NOT EXISTS emotional_events (
+  event_id        String,
+  agent_id        String,
+  event_type      LowCardinality(String),
+  mood            LowCardinality(String),
+  valence         Float32,
+  arousal         Float32,
+  stress_level    Float32,
+  timestamp       DateTime DEFAULT now(),
+  payload         String
+) ENGINE = MergeTree()
+ORDER BY (agent_id, timestamp)
+PARTITION BY toYYYYMM(timestamp)
+TTL timestamp + INTERVAL 365 DAY;

package/schema/postgres/001_create_schema.sql

@@ -0,0 +1,11 @@
+-- Migration: 001_create_schema
+-- Description: Creates soma schema and migration tracker
+-- Created: 2026-06-13
+
+CREATE SCHEMA IF NOT EXISTS soma;
+
+CREATE TABLE IF NOT EXISTS soma.migrations (
+    id          SERIAL PRIMARY KEY,
+    name        TEXT NOT NULL UNIQUE,
+    applied_at  TIMESTAMPTZ DEFAULT NOW()
+);

package/schema/postgres/002_create_agent_identities.sql

@@ -0,0 +1,63 @@
+-- Migration: 002_create_agent_identities
+-- Description: Creates agent_identities with normalized tables
+-- Created: 2026-06-13
+
+CREATE EXTENSION IF NOT EXISTS vector;
+
+-- Main agent identities table
+CREATE TABLE soma.agent_identities (
+    agent_id        TEXT PRIMARY KEY,
+    name            TEXT NOT NULL,
+    description     TEXT NOT NULL DEFAULT '',
+    created_at      TIMESTAMPTZ DEFAULT NOW(),
+    updated_at      TIMESTAMPTZ DEFAULT NOW()
+);
+
+-- Persona details (1:1)
+CREATE TABLE soma.agent_persona (
+    agent_id                TEXT PRIMARY KEY REFERENCES soma.agent_identities(agent_id) ON DELETE CASCADE,
+    communication_style     TEXT NOT NULL DEFAULT 'adaptive',
+    personality_vector      vector(128)
+);
+
+-- State details (1:1)
+CREATE TABLE soma.agent_state (
+    agent_id            TEXT PRIMARY KEY REFERENCES soma.agent_identities(agent_id) ON DELETE CASCADE,
+    current_mood        TEXT NOT NULL DEFAULT 'neutral',
+    energy_level        FLOAT NOT NULL DEFAULT 1.0 CHECK (energy_level >= 0 AND energy_level <= 1),
+    confidence_score    FLOAT NOT NULL DEFAULT 0.5 CHECK (confidence_score >= 0 AND confidence_score <= 1),
+    learning_rate       FLOAT NOT NULL DEFAULT 0.1 CHECK (learning_rate >= 0 AND learning_rate <= 1),
+    interaction_count   INTEGER NOT NULL DEFAULT 0,
+    last_active         TIMESTAMPTZ DEFAULT NOW()
+);
+
+-- Meta details (1:1)
+CREATE TABLE soma.agent_meta (
+    agent_id        TEXT PRIMARY KEY REFERENCES soma.agent_identities(agent_id) ON DELETE CASCADE,
+    version         INTEGER NOT NULL DEFAULT 1,
+    parent_agent    TEXT
+);
+
+-- Core values (1:many)
+CREATE TABLE soma.agent_core_values (
+    id          SERIAL PRIMARY KEY,
+    agent_id    TEXT NOT NULL REFERENCES soma.agent_identities(agent_id) ON DELETE CASCADE,
+    value       TEXT NOT NULL,
+    UNIQUE(agent_id, value)
+);
+
+-- Expertise domains (1:many)
+CREATE TABLE soma.agent_expertise_domains (
+    id          SERIAL PRIMARY KEY,
+    agent_id    TEXT NOT NULL REFERENCES soma.agent_identities(agent_id) ON DELETE CASCADE,
+    domain      TEXT NOT NULL,
+    UNIQUE(agent_id, domain)
+);
+
+-- Indexes
+CREATE INDEX idx_agent_identities_agent_id ON soma.agent_identities(agent_id);
+CREATE INDEX idx_agent_persona_vector ON soma.agent_persona USING ivfflat (personality_vector vector_cosine_ops);
+CREATE INDEX idx_agent_state_mood ON soma.agent_state(current_mood);
+CREATE INDEX idx_agent_state_last_active ON soma.agent_state(last_active DESC);
+CREATE INDEX idx_agent_core_values_agent_id ON soma.agent_core_values(agent_id);
+CREATE INDEX idx_agent_expertise_domains_agent_id ON soma.agent_expertise_domains(agent_id);

package/schema/postgres/003_create_identity_evolution_log.sql

@@ -0,0 +1,21 @@
+-- Migration: 003_create_identity_evolution_log
+-- Description: Creates identity_evolution_log with typed columns
+-- Created: 2026-06-13
+
+CREATE TABLE soma.identity_evolution_log (
+    id              UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+    agent_id        TEXT NOT NULL REFERENCES soma.agent_identities(agent_id) ON DELETE CASCADE,
+    timestamp       TIMESTAMPTZ DEFAULT NOW(),
+    change_type     TEXT NOT NULL,
+    description     TEXT NOT NULL DEFAULT '',
+    previous_version INTEGER NOT NULL DEFAULT 0,
+    new_version     INTEGER NOT NULL DEFAULT 0,
+    trigger_type    TEXT,
+    confidence      FLOAT CHECK (confidence >= 0 AND confidence <= 1)
+);
+
+-- Indexes
+CREATE INDEX idx_identity_evolution_log_agent_id ON soma.identity_evolution_log(agent_id);
+CREATE INDEX idx_identity_evolution_log_timestamp ON soma.identity_evolution_log(timestamp DESC);
+CREATE INDEX idx_identity_evolution_log_change_type ON soma.identity_evolution_log(change_type);
+CREATE INDEX idx_identity_evolution_log_agent_time ON soma.identity_evolution_log(agent_id, timestamp DESC);

package/schema/postgres/004_create_agent_cards.sql

@@ -0,0 +1,29 @@
+-- Migration: 004_create_agent_cards
+-- Description: Creates agent_cards with normalized tables
+-- Created: 2026-06-13
+
+-- Agent cards table
+CREATE TABLE soma.agent_cards (
+    agent_id        TEXT PRIMARY KEY,
+    identity_id     TEXT REFERENCES soma.agent_identities(agent_id) ON DELETE SET NULL,
+    url             TEXT NOT NULL DEFAULT '',
+    version         TEXT NOT NULL DEFAULT '1.0',
+    documentation_url TEXT NOT NULL DEFAULT '',
+    is_active       BOOLEAN DEFAULT TRUE,
+    created_at      TIMESTAMPTZ DEFAULT NOW(),
+    updated_at      TIMESTAMPTZ DEFAULT NOW()
+);
+
+-- Agent capabilities (1:many)
+CREATE TABLE soma.agent_capabilities (
+    id              SERIAL PRIMARY KEY,
+    agent_id        TEXT NOT NULL REFERENCES soma.agent_cards(agent_id) ON DELETE CASCADE,
+    name            TEXT NOT NULL,
+    description     TEXT NOT NULL DEFAULT '',
+    UNIQUE(agent_id, name)
+);
+
+-- Indexes
+CREATE INDEX idx_agent_cards_agent_id ON soma.agent_cards(agent_id);
+CREATE INDEX idx_agent_cards_is_active ON soma.agent_cards(is_active) WHERE is_active = TRUE;
+CREATE INDEX idx_agent_capabilities_agent_id ON soma.agent_capabilities(agent_id);

package/schema/postgres/005_create_memory_tables.sql

@@ -0,0 +1,32 @@
+-- Procedural + Social memory tables
+
+-- Layer 3: Procedural Memory
+CREATE TABLE IF NOT EXISTS soma.procedures (
+  procedure_id    UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+  agent_id        TEXT NOT NULL,
+  pattern         JSONB NOT NULL,
+  performance     JSONB NOT NULL,
+  origin          JSONB NOT NULL,
+  metadata        JSONB NOT NULL,
+  created_at      TIMESTAMPTZ DEFAULT now(),
+  updated_at      TIMESTAMPTZ DEFAULT now()
+);
+
+CREATE INDEX IF NOT EXISTS idx_procedures_agent ON soma.procedures(agent_id);
+CREATE INDEX IF NOT EXISTS idx_procedures_domain ON soma.procedures((metadata->>'domain'));
+
+-- Layer 4: Social Memory
+CREATE TABLE IF NOT EXISTS soma.social_memories (
+  agent_id        TEXT NOT NULL,
+  target_agent_id TEXT NOT NULL,
+  trust           JSONB NOT NULL,
+  preferences     JSONB NOT NULL,
+  history         JSONB NOT NULL,
+  notes           TEXT[] DEFAULT '{}',
+  created_at      TIMESTAMPTZ DEFAULT now(),
+  updated_at      TIMESTAMPTZ DEFAULT now(),
+  PRIMARY KEY (agent_id, target_agent_id)
+);
+
+CREATE INDEX IF NOT EXISTS idx_social_agent ON soma.social_memories(agent_id);
+CREATE INDEX IF NOT EXISTS idx_social_trust ON soma.social_memories(((trust->>'overall')::float) DESC);