soma-protocol 0.1.0

package/schema/postgres/006_create_learning_tables.sql

@@ -0,0 +1,119 @@
+CREATE SCHEMA IF NOT EXISTS learning;
+
+-- Learning events (append-only log of agent learning)
+CREATE TABLE learning.learning_events (
+  event_id          UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+  agent_id          TEXT NOT NULL,
+  tenant_id         TEXT NOT NULL,
+  type              TEXT NOT NULL CHECK (type IN (
+    'insight','correction','skill_transfer','pattern_recognition',
+    'feedback_response','failure_analysis','discovery','refinement'
+  )),
+  source_agent      TEXT NOT NULL,
+  episode_id        UUID,
+  interaction_id    UUID,
+  domain            TEXT NOT NULL,
+  what_learned      TEXT NOT NULL,
+  confidence        FLOAT CHECK (confidence >= 0 AND confidence <= 1),
+  evidence          JSONB DEFAULT '[]',
+  applicable_contexts JSONB DEFAULT '[]',
+  counter_examples  JSONB DEFAULT '[]',
+  behavior_change   TEXT NOT NULL,
+  performance_before FLOAT,
+  performance_after  FLOAT,
+  procedure_ids     JSONB DEFAULT '[]',
+  learning_method   TEXT NOT NULL,
+  sharing_allowed   BOOLEAN DEFAULT true,
+  priority          TEXT DEFAULT 'medium' CHECK (priority IN ('low','medium','high','critical')),
+  expires_at        TIMESTAMPTZ,
+  created_at        TIMESTAMPTZ DEFAULT now()
+);
+
+CREATE INDEX idx_learning_events_agent ON learning.learning_events(agent_id);
+CREATE INDEX idx_learning_events_domain ON learning.learning_events(domain);
+CREATE INDEX idx_learning_events_type ON learning.learning_events(type);
+CREATE INDEX idx_learning_events_created ON learning.learning_events(created_at DESC);
+
+-- Teaching offers (agent-to-agent knowledge transfer proposals)
+CREATE TABLE learning.teaching_offers (
+  offer_id          UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+  from_agent        TEXT NOT NULL,
+  to_agent          TEXT NOT NULL,
+  skill             TEXT NOT NULL,
+  description       TEXT DEFAULT '',
+  prerequisites     JSONB DEFAULT '[]',
+  estimated_time    INT DEFAULT 0,
+  confidence        FLOAT CHECK (confidence >= 0 AND confidence <= 1),
+  why_relevant      TEXT DEFAULT '',
+  expected_benefit  TEXT DEFAULT '',
+  risk_assessment   TEXT DEFAULT '',
+  status            TEXT DEFAULT 'pending' CHECK (status IN ('pending','accepted','declined','negotiated')),
+  conditions        JSONB DEFAULT '[]',
+  created_at        TIMESTAMPTZ DEFAULT now(),
+  updated_at        TIMESTAMPTZ DEFAULT now()
+);
+
+CREATE INDEX idx_teaching_offers_to ON learning.teaching_offers(to_agent) WHERE status = 'pending';
+CREATE INDEX idx_teaching_offers_from ON learning.teaching_offers(from_agent);
+
+-- Knowledge transfers (created when a teaching offer is accepted)
+CREATE TABLE learning.knowledge_transfers (
+  transfer_id       UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+  from_agent        TEXT NOT NULL,
+  to_agent          TEXT NOT NULL,
+  offer_id          UUID REFERENCES learning.teaching_offers(offer_id) ON DELETE SET NULL,
+  domain            TEXT NOT NULL,
+  what_learned      TEXT NOT NULL,
+  confidence        FLOAT CHECK (confidence >= 0 AND confidence <= 1),
+  evidence          JSONB DEFAULT '[]',
+  created_at        TIMESTAMPTZ DEFAULT now()
+);
+
+CREATE INDEX idx_knowledge_transfers_to ON learning.knowledge_transfers(to_agent);
+CREATE INDEX idx_knowledge_transfers_from ON learning.knowledge_transfers(from_agent);
+
+-- Observations (observational learning records)
+CREATE TABLE learning.observations (
+  observation_id    UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+  observer_agent    TEXT NOT NULL,
+  observed_agent    TEXT NOT NULL,
+  tenant_id         TEXT NOT NULL,
+  action            TEXT NOT NULL,
+  context           TEXT NOT NULL,
+  outcome           TEXT NOT NULL,
+  quality_assessment FLOAT CHECK (quality_assessment >= 0 AND quality_assessment <= 1),
+  extracted_procedure TEXT,
+  extracted_insight TEXT,
+  extracted_pattern TEXT,
+  extracted_confidence FLOAT CHECK (extracted_confidence >= 0 AND extracted_confidence <= 1),
+  consent_obtained  BOOLEAN DEFAULT false,
+  privacy_level     TEXT DEFAULT 'team' CHECK (privacy_level IN ('public','team','private')),
+  anonymized        BOOLEAN DEFAULT false,
+  created_at        TIMESTAMPTZ DEFAULT now()
+);
+
+CREATE INDEX idx_observations_observer ON learning.observations(observer_agent);
+CREATE INDEX idx_observations_observed ON learning.observations(observed_agent);
+CREATE INDEX idx_observations_tenant ON learning.observations(tenant_id);
+
+-- Knowledge distillations (compressed experience for transfer)
+CREATE TABLE learning.distillations (
+  distillation_id   UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+  source_agent      TEXT NOT NULL,
+  tenant_id         TEXT NOT NULL,
+  input_episodes    JSONB DEFAULT '[]',
+  input_procedures  JSONB DEFAULT '[]',
+  experience_hours  FLOAT DEFAULT 0,
+  distilled_knowledge TEXT NOT NULL,
+  key_insights      JSONB DEFAULT '[]',
+  transferable_skills JSONB DEFAULT '[]',
+  anti_patterns     JSONB DEFAULT '[]',
+  applicability     JSONB DEFAULT '{}',
+  quality_completeness FLOAT CHECK (quality_completeness >= 0 AND quality_completeness <= 1),
+  quality_accuracy  FLOAT CHECK (quality_accuracy >= 0 AND quality_accuracy <= 1),
+  quality_generalizability FLOAT CHECK (quality_generalizability >= 0 AND quality_generalizability <= 1),
+  created_at        TIMESTAMPTZ DEFAULT now()
+);
+
+CREATE INDEX idx_distillations_agent ON learning.distillations(source_agent);
+CREATE INDEX idx_distillations_created ON learning.distillations(created_at DESC);

package/schema/postgres/007_create_reputation_tables.sql

@@ -0,0 +1,27 @@
+CREATE SCHEMA IF NOT EXISTS reputation;
+
+CREATE TABLE reputation.trust_relationships (
+  tenant_id       TEXT NOT NULL,
+  truster         TEXT NOT NULL,
+  trustee         TEXT NOT NULL,
+  scores          JSONB NOT NULL,
+  dynamics        JSONB NOT NULL,
+  metadata        JSONB NOT NULL,
+  updated_at      TIMESTAMPTZ DEFAULT now(),
+  PRIMARY KEY (tenant_id, truster, trustee)
+);
+
+CREATE TABLE reputation.agent_reputations (
+  tenant_id       TEXT NOT NULL,
+  agent_id        TEXT NOT NULL,
+  overall         JSONB NOT NULL,
+  by_domain       JSONB NOT NULL DEFAULT '{}',
+  track_record    JSONB NOT NULL,
+  endorsements    JSONB DEFAULT '[]',
+  awards          JSONB DEFAULT '[]',
+  updated_at      TIMESTAMPTZ DEFAULT now(),
+  PRIMARY KEY (tenant_id, agent_id)
+);
+
+CREATE INDEX idx_reputation_score
+  ON reputation.agent_reputations(tenant_id, (overall->>'score') DESC);

package/schema/postgres/008_create_social_tables.sql

@@ -0,0 +1,43 @@
+CREATE SCHEMA IF NOT EXISTS social;
+
+CREATE TABLE social.relationships (
+  relationship_id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+  agent_a         TEXT NOT NULL,
+  agent_b         TEXT NOT NULL,
+  type            TEXT NOT NULL,
+  strength        FLOAT NOT NULL DEFAULT 0.5,
+  dynamics        JSONB NOT NULL,
+  context         JSONB NOT NULL DEFAULT '{}',
+  preferences     JSONB NOT NULL DEFAULT '{}',
+  created_at      TIMESTAMPTZ DEFAULT now(),
+  updated_at      TIMESTAMPTZ DEFAULT now()
+);
+
+CREATE UNIQUE INDEX idx_relationships_pair ON social.relationships(agent_a, agent_b);
+CREATE INDEX idx_relationships_agent ON social.relationships(agent_a);
+
+CREATE TABLE social.teams (
+  team_id         UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+  name            TEXT NOT NULL,
+  description     TEXT,
+  structure       JSONB NOT NULL DEFAULT '{}',
+  shared_context  JSONB NOT NULL DEFAULT '{}',
+  culture         JSONB NOT NULL DEFAULT '{}',
+  metrics         JSONB NOT NULL DEFAULT '{}',
+  created_at      TIMESTAMPTZ DEFAULT now(),
+  updated_at      TIMESTAMPTZ DEFAULT now()
+);
+
+CREATE TABLE social.team_members (
+  team_id         UUID REFERENCES social.teams(team_id) ON DELETE CASCADE,
+  agent_id        TEXT NOT NULL,
+  role            TEXT NOT NULL,
+  responsibilities JSONB NOT NULL DEFAULT '[]',
+  authority_level TEXT NOT NULL DEFAULT 'limited',
+  performance     JSONB NOT NULL DEFAULT '{}',
+  status          TEXT NOT NULL DEFAULT 'active',
+  joined_at       TIMESTAMPTZ DEFAULT now(),
+  PRIMARY KEY (team_id, agent_id)
+);
+
+CREATE INDEX idx_team_members_agent ON social.team_members(agent_id);

package/schema/postgres/009_create_reflection_tables.sql

@@ -0,0 +1,54 @@
+CREATE SCHEMA IF NOT EXISTS reflection;
+
+CREATE TABLE reflection.reflections (
+  reflection_id   UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+  agent_id        TEXT NOT NULL,
+  timestamp       TIMESTAMPTZ DEFAULT now(),
+  trigger         JSONB NOT NULL,
+  analysis        JSONB NOT NULL,
+  insights        JSONB NOT NULL DEFAULT '[]',
+  action_items    JSONB NOT NULL DEFAULT '[]',
+  sharing         JSONB NOT NULL DEFAULT '{}',
+  created_at      TIMESTAMPTZ DEFAULT now()
+);
+
+CREATE INDEX idx_reflections_agent ON reflection.reflections(agent_id);
+CREATE INDEX idx_reflections_trigger ON reflection.reflections USING gin(trigger);
+
+CREATE TABLE reflection.retrospectives (
+  retro_id                UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+  team_id                 TEXT NOT NULL,
+  timestamp               TIMESTAMPTZ DEFAULT now(),
+  scope                   JSONB NOT NULL,
+  individual_reflections  JSONB NOT NULL DEFAULT '[]',
+  team_analysis           JSONB NOT NULL,
+  decisions               JSONB NOT NULL,
+  commitments             JSONB NOT NULL DEFAULT '[]',
+  created_at              TIMESTAMPTZ DEFAULT now()
+);
+
+CREATE INDEX idx_retrospectives_team ON reflection.retrospectives(team_id);
+
+CREATE TABLE reflection.insights (
+  insight_id        UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+  reflection_id     UUID REFERENCES reflection.reflections(reflection_id) ON DELETE CASCADE,
+  agent_id          TEXT NOT NULL,
+  category          TEXT NOT NULL,
+  observation       TEXT NOT NULL,
+  interpretation    TEXT NOT NULL,
+  confidence        FLOAT NOT NULL CHECK (confidence >= 0 AND confidence <= 1),
+  generalizability  FLOAT NOT NULL CHECK (generalizability >= 0 AND generalizability <= 1),
+  scope             TEXT NOT NULL DEFAULT 'self',
+  actionability     TEXT NOT NULL DEFAULT 'short_term',
+  created_at        TIMESTAMPTZ DEFAULT now()
+);
+
+CREATE INDEX idx_insights_agent ON reflection.insights(agent_id);
+CREATE INDEX idx_insights_category ON reflection.insights(category);
+
+CREATE TABLE reflection.self_awareness_profiles (
+  agent_id    TEXT PRIMARY KEY,
+  profile     JSONB NOT NULL DEFAULT '{}',
+  created_at  TIMESTAMPTZ DEFAULT now(),
+  updated_at  TIMESTAMPTZ DEFAULT now()
+);

package/schema/postgres/010_create_emotional_tables.sql

@@ -0,0 +1,19 @@
+CREATE SCHEMA IF NOT EXISTS emotional;
+
+CREATE TABLE emotional.contexts (
+  agent_id    TEXT PRIMARY KEY,
+  context     JSONB NOT NULL DEFAULT '{}',
+  created_at  TIMESTAMPTZ DEFAULT now(),
+  updated_at  TIMESTAMPTZ DEFAULT now()
+);
+
+CREATE TABLE emotional.history (
+  id          UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+  agent_id    TEXT NOT NULL,
+  snapshot    JSONB NOT NULL,
+  triggers    JSONB NOT NULL DEFAULT '[]',
+  timestamp   TIMESTAMPTZ DEFAULT now()
+);
+
+CREATE INDEX idx_emotional_history_agent ON emotional.history(agent_id);
+CREATE INDEX idx_emotional_history_timestamp ON emotional.history(timestamp);