catalist-support-agent 1.0.0

package/gmail-knowledge-migration.sql

@@ -0,0 +1,149 @@
+-- Gmail Knowledge Base Migration (corrected order)
+-- Apply this in Supabase Dashboard -> SQL Editor
+
+-- 1. Enable pgvector extension
+CREATE EXTENSION IF NOT EXISTS vector;
+
+-- 2. Create enum types
+DO $$ BEGIN
+  CREATE TYPE gmail_knowledge_review_status AS ENUM (
+    'pending', 'approved', 'rejected', 'needs_revision'
+  );
+EXCEPTION WHEN duplicate_object THEN NULL;
+END $$;
+
+DO $$ BEGIN
+  CREATE TYPE gmail_import_batch_status AS ENUM (
+    'pending', 'in_progress', 'completed', 'failed', 'partial'
+  );
+EXCEPTION WHEN duplicate_object THEN NULL;
+END $$;
+
+-- 3. Create gmail_import_batches FIRST (no FK dependencies)
+CREATE TABLE IF NOT EXISTS gmail_import_batches (
+  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+  email_account TEXT NOT NULL,
+  date_range_start TIMESTAMPTZ NOT NULL,
+  date_range_end TIMESTAMPTZ NOT NULL,
+  status gmail_import_batch_status NOT NULL DEFAULT 'pending',
+  total_threads_found INTEGER DEFAULT 0,
+  threads_processed INTEGER DEFAULT 0,
+  entries_created INTEGER DEFAULT 0,
+  entries_skipped INTEGER DEFAULT 0,
+  errors_encountered INTEGER DEFAULT 0,
+  started_at TIMESTAMPTZ,
+  completed_at TIMESTAMPTZ,
+  error_log JSONB DEFAULT '[]',
+  config_used JSONB DEFAULT '{}',
+  created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+  updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
+);
+
+-- 4. Create gmail_extraction_state
+CREATE TABLE IF NOT EXISTS gmail_extraction_state (
+  id SERIAL PRIMARY KEY,
+  email_address TEXT NOT NULL UNIQUE,
+  last_history_id TEXT,
+  last_extracted_at TIMESTAMPTZ,
+  total_entries_extracted INTEGER DEFAULT 0,
+  last_batch_id UUID REFERENCES gmail_import_batches(id) ON DELETE SET NULL,
+  consecutive_errors INTEGER DEFAULT 0,
+  last_error TEXT,
+  last_error_at TIMESTAMPTZ,
+  created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+  updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
+);
+
+-- 5. Create gmail_knowledge_entries
+CREATE TABLE IF NOT EXISTS gmail_knowledge_entries (
+  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+  gmail_thread_id TEXT NOT NULL,
+  gmail_message_id TEXT NOT NULL,
+  question_subject TEXT,
+  question_text TEXT NOT NULL,
+  response_text TEXT NOT NULL,
+  customer_email TEXT NOT NULL,
+  customer_user_id INTEGER REFERENCES public."User"(id) ON DELETE SET NULL,
+  responder_email TEXT NOT NULL,
+  intent_category intent_category,
+  quality_score DECIMAL(4,3) DEFAULT 0.5,
+  review_status gmail_knowledge_review_status NOT NULL DEFAULT 'pending',
+  reviewed_by TEXT,
+  reviewed_at TIMESTAMPTZ,
+  review_notes TEXT,
+  embedding vector(1536),
+  tsv tsvector GENERATED ALWAYS AS (
+    setweight(to_tsvector('english', coalesce(question_subject, '')), 'A') ||
+    setweight(to_tsvector('english', coalesce(question_text, '')), 'B') ||
+    setweight(to_tsvector('english', coalesce(response_text, '')), 'C')
+  ) STORED,
+  response_time_ms INTEGER,
+  resolution_indicator TEXT,
+  content_hash TEXT NOT NULL,
+  extracted_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+  batch_id UUID REFERENCES gmail_import_batches(id) ON DELETE SET NULL,
+  pii_redacted BOOLEAN NOT NULL DEFAULT false,
+  pii_types_found TEXT[] DEFAULT '{}',
+  email_received_at TIMESTAMPTZ NOT NULL,
+  email_responded_at TIMESTAMPTZ,
+  created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+  updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
+);
+
+-- 6. Create junction table
+CREATE TABLE IF NOT EXISTS gmail_knowledge_order_links (
+  id SERIAL PRIMARY KEY,
+  knowledge_entry_id UUID NOT NULL REFERENCES gmail_knowledge_entries(id) ON DELETE CASCADE,
+  order_id TEXT,
+  invoice_number TEXT,
+  reference_type TEXT NOT NULL CHECK (reference_type IN ('order', 'invoice')),
+  confidence DECIMAL(4,3) DEFAULT 0.9,
+  created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+  CONSTRAINT has_reference CHECK (order_id IS NOT NULL OR invoice_number IS NOT NULL)
+);
+
+-- 7. Create indexes
+CREATE UNIQUE INDEX IF NOT EXISTS idx_gmail_knowledge_message_id ON gmail_knowledge_entries(gmail_message_id);
+CREATE INDEX IF NOT EXISTS idx_gmail_knowledge_content_hash ON gmail_knowledge_entries(content_hash);
+CREATE INDEX IF NOT EXISTS idx_gmail_knowledge_tsv ON gmail_knowledge_entries USING gin(tsv);
+CREATE INDEX IF NOT EXISTS idx_gmail_knowledge_customer_email ON gmail_knowledge_entries(customer_email);
+CREATE INDEX IF NOT EXISTS idx_gmail_knowledge_review_status ON gmail_knowledge_entries(review_status);
+CREATE INDEX IF NOT EXISTS idx_gmail_import_batches_email ON gmail_import_batches(email_account);
+CREATE INDEX IF NOT EXISTS idx_gmail_import_batches_status ON gmail_import_batches(status);
+
+-- 8. Enable RLS
+ALTER TABLE gmail_knowledge_entries ENABLE ROW LEVEL SECURITY;
+ALTER TABLE gmail_import_batches ENABLE ROW LEVEL SECURITY;
+ALTER TABLE gmail_knowledge_order_links ENABLE ROW LEVEL SECURITY;
+ALTER TABLE gmail_extraction_state ENABLE ROW LEVEL SECURITY;
+
+-- 9. Create RLS policies for service_role
+CREATE POLICY "Service role full access gmail_knowledge_entries" ON gmail_knowledge_entries FOR ALL USING (true);
+CREATE POLICY "Service role full access gmail_import_batches" ON gmail_import_batches FOR ALL USING (true);
+CREATE POLICY "Service role full access gmail_knowledge_order_links" ON gmail_knowledge_order_links FOR ALL USING (true);
+CREATE POLICY "Service role full access gmail_extraction_state" ON gmail_extraction_state FOR ALL USING (true);
+
+-- 10. Create stats function
+CREATE OR REPLACE FUNCTION get_gmail_knowledge_stats()
+RETURNS TABLE (
+  total_entries BIGINT,
+  approved_entries BIGINT,
+  pending_entries BIGINT,
+  entries_with_embeddings BIGINT
+)
+LANGUAGE plpgsql
+SECURITY DEFINER
+AS $$
+BEGIN
+  RETURN QUERY
+  SELECT
+    COUNT(*)::BIGINT as total_entries,
+    COUNT(*) FILTER (WHERE review_status = 'approved')::BIGINT as approved_entries,
+    COUNT(*) FILTER (WHERE review_status = 'pending')::BIGINT as pending_entries,
+    COUNT(*) FILTER (WHERE embedding IS NOT NULL)::BIGINT as entries_with_embeddings
+  FROM gmail_knowledge_entries;
+END;
+$$;
+
+GRANT EXECUTE ON FUNCTION get_gmail_knowledge_stats() TO authenticated;
+GRANT EXECUTE ON FUNCTION get_gmail_knowledge_stats() TO service_role;

package/nul

@@ -0,0 +1 @@
+dir: cannot access 'distindex.js': No such file or directory

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "catalist-support-agent",
+  "version": "1.0.0",
+  "description": "AI Support Agent SDK for autonomous customer support with strict brand compliance",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./admin-portal": {
+      "import": "./dist/admin-portal.js",
+      "types": "./dist/admin-portal.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "tsc && npm run copy-prompts",
+    "copy-prompts": "node -e \"const fs=require('fs');const path=require('path');fs.mkdirSync('dist/prompts',{recursive:true});fs.readdirSync('src/prompts').forEach(f=>fs.copyFileSync(path.join('src/prompts',f),path.join('dist/prompts',f)))\"",
+    "start": "node dist/index.js",
+    "dev": "tsx src/index.ts",
+    "watch": "tsx watch src/index.ts",
+    "lint": "eslint src/**/*.ts",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:unit": "vitest run --dir src/__tests__/unit",
+    "test:integration": "vitest run --dir src/__tests__/integration",
+    "test:coverage": "vitest run --coverage",
+    "test:watch": "vitest",
+    "test:live": "tsx test/live/runners/run-validation-standalone.ts",
+    "test:live:verbose": "tsx test/live/runners/run-validation-standalone.ts --verbose",
+    "test:live:full": "tsx test/live/runners/run-live-validation.ts"
+  },
+  "dependencies": {
+    "@anthropic-ai/claude-agent-sdk": "^0.2.9",
+    "@anthropic-ai/sdk": "^0.71.2",
+    "@supabase/supabase-js": "^2.90.0",
+    "dotenv": "^16.4.5",
+    "zod": "^4.3.5"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.0",
+    "@typescript-eslint/eslint-plugin": "^6.19.0",
+    "@typescript-eslint/parser": "^6.19.0",
+    "@vitest/coverage-v8": "^2.1.0",
+    "eslint": "^8.56.0",
+    "tsx": "^4.7.0",
+    "typescript": "^5.3.3",
+    "vitest": "^2.1.0"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  }
+}