eric-sdk 0.0.1

package/README.md

@@ -0,0 +1,235 @@
+📘 Eric SDK (JavaScript + TypeScript)
+
+Official SDK for interacting with the Eric AI Policy Engine.
+Eric routes user input to the correct AI flow (or a restricted subset of flows) and returns structured, domain-aware results.
+
+🚀 Features
+
+Agentic routing with eric.decide()
+
+Manual flow calls with eric.call(flowName, data)
+
+Restricted routing with allowedFlows
+
+Flow-specific structured responses
+
+Domain-aware behavior (wellness, events, workplace)
+
+Full TypeScript typing
+
+Production-ready — used in Ingomu, EventInterface, and enterprise pilots
+
+📦 Installation
+npm install eric-sdk
+
+🔑 Quick Start — Automatic Flow Selection
+import { EricSDK } from "eric-sdk";
+
+const eric = new EricSDK({
+  apiKey: process.env.ERIC_API_KEY!,
+  client: "eventinterface",
+});
+
+const result = await eric.decide({
+  text: "I'm overwhelmed today.",
+});
+
+Example output:
+
+{
+  "flow": "dailyNudgeGenerator",
+  "type": "structured",
+  "data": {
+    "nudge": "You're building momentum — take a breath and trust your progress."
+  }
+}
+
+🎯 Auto-Routing (Advanced)
+🔹 Decide automatically
+const result = await eric.decide({
+  text: "Can you rewrite this announcement?",
+});
+
+
+Eric chooses the correct flow (announcementRewriter, shortTextSummary, etc.)
+
+🔒 Restricting Auto-Routing (allowedFlows)
+
+You can force Eric to only pick from certain flows.
+
+Example: only allow announcement rewriting:
+
+const result = await eric.decide({
+  text: this.form.body,
+  allowedFlows: ["announcementRewriter"],
+  userState: {
+    tone: "energetic",
+    length: 150
+  }
+});
+
+
+This guarantees:
+
+Eric does not pick shortTextSummary
+
+Eric must choose announcementRewriter
+
+If allowedFlows has only one item, it will always choose that one
+
+Example output:
+
+{
+  "flow": "announcementRewriter",
+  "type": "structured",
+  "data": {
+    "rewritten": "Heads up! The pool party is now at the yacht club...",
+    "toneUsed": "energetic"
+  }
+}
+
+🔧 Manual Flow Execution
+
+Use .call() to skip routing and directly invoke any flow:
+
+const result = await eric.call("announcementRewriter", {
+  announcement: "We moved the meeting.",
+  tone: "friendly",
+  length: 200
+});
+
+
+Useful for admin panels, batch processing, and scheduled tasks.
+
+🧠 When to Use What
+Method	Use When
+eric.decide()	You want Eric to choose the correct flow automatically
+eric.decide({ allowedFlows: [...] })	You want Eric to choose, but only within a safe controlled list
+eric.call()	You already know which flow to use (like admin tools, backend tasks)
+🧱 Full SDK API
+eric.decide(options)
+eric.decide({
+  text?: string;
+  userState?: Record<string, any>;
+  topic?: string;
+  allowedFlows?: string[];
+});
+
+
+Returns:
+
+{
+  flow: string;
+  type: "structured" | "text";
+  data: any;
+}
+
+eric.call(flowName, data)
+const out = await eric.call("shortTextSummary", {
+  text: "Make this clearer."
+});
+
+
+Equivalent to:
+
+eric.runFlow({ flow: "shortTextSummary", data: {...} })
+
+💬 Examples
+Example 1 — Clean up an announcement (EventInterface admin)
+const result = await eric.decide({
+  text: this.form.body,
+  allowedFlows: ["announcementRewriter"],
+  userState: {
+    tone: "energetic",
+    length: 150,
+  }
+});
+
+this.aiSummary = result.data.rewritten;
+
+Example 2 — Generate a summary (default)
+const result = await eric.decide({
+  text: "Here is a long announcement, please make it shorter."
+});
+
+
+May produce:
+
+shortTextSummary
+
+announcementRewriter
+(depends on the text)
+
+Example 3 — Force a specific flow
+await eric.call("speakerPerformanceAnalyzer", {
+  speakerName: "Jane Doe",
+  feedbackComments: ["Loved the energy!", "Slides were unclear"]
+});
+
+🧩 Supported Flows
+Common
+
+shortTextSummary
+
+questionAnswerHelper
+
+dailyNudgeGenerator
+
+Wellness
+
+aiCoachFeedback
+
+personalizedSessionRecommender
+
+wellnessProgressReporter
+
+trendInsightReporter
+
+Events
+
+eventSummaryDigest
+
+speakerPerformanceAnalyzer
+
+networkingMatchmaker
+
+attendeeEngagementReporter
+
+eventPulseReport
+
+sessionRecapGenerator
+
+sponsorValueSummary
+
+announcementRewriter
+
+Business / Workplace
+
+leadershipInsight
+
+feedbackInsightAnalyzer
+
+performanceReviewAssistant
+
+teamDynamicsAnalyzer
+
+productivityCoach
+
+🌐 Configuration
+new EricSDK({
+  apiKey: "YOUR_API_KEY",
+  client: "your-client-id",
+  baseUrl: "https://us-central1-eric-ai-prod.cloudfunctions.net/runFlow"
+});
+
+🔧 Local Development
+npm link
+
+
+In your other project:
+
+npm link eric-sdk
+
+📄 License
+
+MIT © 2025

package/dist/index.cjs

@@ -0,0 +1,198 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  EricSDK: () => EricSDK,
+  isAICoachFeedback: () => isAICoachFeedback,
+  isAnnouncementRewrite: () => isAnnouncementRewrite,
+  isAttendeeEngagement: () => isAttendeeEngagement,
+  isEventPulse: () => isEventPulse,
+  isEventSummary: () => isEventSummary,
+  isFeedbackInsight: () => isFeedbackInsight,
+  isLeadershipInsight: () => isLeadershipInsight,
+  isNetworkingMatches: () => isNetworkingMatches,
+  isNudge: () => isNudge,
+  isPerformanceReview: () => isPerformanceReview,
+  isProductivityInsight: () => isProductivityInsight,
+  isQA: () => isQA,
+  isRecommendation: () => isRecommendation,
+  isSessionRecap: () => isSessionRecap,
+  isSpeakerPerformance: () => isSpeakerPerformance,
+  isSponsorSummary: () => isSponsorSummary,
+  isSummary: () => isSummary,
+  isTeamDynamics: () => isTeamDynamics,
+  isTrendInsight: () => isTrendInsight,
+  isWellnessProgress: () => isWellnessProgress
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/client.ts
+var import_axios = __toESM(require("axios"), 1);
+var EricSDK = class {
+  constructor(options) {
+    this.apiKey = options.apiKey;
+    this.client = options.client;
+    this.appId = options.appId;
+    this.baseUrl = options.baseUrl ?? "https://us-central1-eric-ai-prod.cloudfunctions.net/runFlow";
+  }
+  /* -------------------------------------------------------------
+   * 1) DIRECT CALL — developer explicitly chooses the flow
+   * ------------------------------------------------------------- */
+  async call(flowName, data) {
+    const payload = {
+      flow: flowName,
+      data: {
+        ...data,
+        client: this.client,
+        appId: this.appId
+      }
+    };
+    const res = await import_axios.default.post(this.baseUrl, payload, {
+      headers: {
+        "x-api-key": this.apiKey,
+        "x-api-client": this.client,
+        "Content-Type": "application/json"
+      }
+    });
+    return res.data.output;
+  }
+  /* -------------------------------------------------------------
+   * 2) DECIDE — agentic routing with optional allowedFlows
+   * ------------------------------------------------------------- */
+  async decide(data) {
+    const { allowedFlows, ...rest } = data;
+    const payload = {
+      flow: "policyDecisionMaker",
+      data: {
+        ...rest,
+        client: this.client,
+        appId: this.appId
+      }
+    };
+    if (allowedFlows) {
+      payload.data.allowedFlows = allowedFlows;
+    }
+    const res = await import_axios.default.post(this.baseUrl, payload, {
+      headers: {
+        "x-api-key": this.apiKey,
+        "x-api-client": this.client,
+        "Content-Type": "application/json"
+      }
+    });
+    return res.data.output;
+  }
+};
+
+// src/flows/helper.ts
+function isSummary(result) {
+  return result.flow === "shortTextSummary";
+}
+function isQA(result) {
+  return result.flow === "questionAnswerHelper";
+}
+function isNudge(result) {
+  return result.flow === "dailyNudgeGenerator";
+}
+function isRecommendation(result) {
+  return result.flow === "personalizedSessionRecommender";
+}
+function isAICoachFeedback(result) {
+  return result.flow === "aiCoachFeedback";
+}
+function isWellnessProgress(result) {
+  return result.flow === "wellnessProgressReporter";
+}
+function isTrendInsight(result) {
+  return result.flow === "trendInsightReporter";
+}
+function isEventSummary(result) {
+  return result.flow === "eventSummaryDigest";
+}
+function isSpeakerPerformance(result) {
+  return result.flow === "speakerPerformanceAnalyzer";
+}
+function isNetworkingMatches(result) {
+  return result.flow === "networkingMatchmaker";
+}
+function isAttendeeEngagement(result) {
+  return result.flow === "attendeeEngagementReporter";
+}
+function isEventPulse(result) {
+  return result.flow === "eventPulseReport";
+}
+function isSessionRecap(result) {
+  return result.flow === "sessionRecapGenerator";
+}
+function isSponsorSummary(result) {
+  return result.flow === "sponsorValueSummary";
+}
+function isAnnouncementRewrite(result) {
+  return result.flow === "announcementRewriter";
+}
+function isLeadershipInsight(result) {
+  return result.flow === "leadershipInsight";
+}
+function isFeedbackInsight(result) {
+  return result.flow === "feedbackInsightAnalyzer";
+}
+function isProductivityInsight(result) {
+  return result.flow === "productivityCoach";
+}
+function isTeamDynamics(result) {
+  return result.flow === "teamDynamicsAnalyzer";
+}
+function isPerformanceReview(result) {
+  return result.flow === "performanceReviewAssistant";
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  EricSDK,
+  isAICoachFeedback,
+  isAnnouncementRewrite,
+  isAttendeeEngagement,
+  isEventPulse,
+  isEventSummary,
+  isFeedbackInsight,
+  isLeadershipInsight,
+  isNetworkingMatches,
+  isNudge,
+  isPerformanceReview,
+  isProductivityInsight,
+  isQA,
+  isRecommendation,
+  isSessionRecap,
+  isSpeakerPerformance,
+  isSponsorSummary,
+  isSummary,
+  isTeamDynamics,
+  isTrendInsight,
+  isWellnessProgress
+});

package/dist/index.d.cts

@@ -0,0 +1,199 @@
+interface EricClientOptions {
+    apiKey: string;
+    client: string;
+    appId: "wellness" | "events" | "business";
+    baseUrl?: string;
+}
+interface EricResponse {
+    flow: string;
+    type: string;
+    data: any;
+}
+declare class EricSDK {
+    private apiKey;
+    private client;
+    private appId;
+    private baseUrl;
+    constructor(options: EricClientOptions);
+    call(flowName: string, data: any): Promise<EricResponse>;
+    decide(data: {
+        text: string;
+        topic?: string;
+        userState?: any;
+        allowedFlows?: string[];
+    }): Promise<EricResponse>;
+}
+
+interface ShortTextSummary {
+    summary: string;
+}
+interface QAItem {
+    question: string;
+    answer: string;
+}
+interface QuestionAnswerSummary {
+    summary: string;
+    questions: QAItem[];
+}
+interface DailyNudge {
+    nudge: string;
+}
+interface RecommendationItem {
+    id: string;
+    title: string;
+    reason: string;
+}
+interface SessionRecommendation {
+    recommendations: RecommendationItem[];
+    rationale: string;
+}
+interface AICoachFeedback {
+    summary: string;
+    encouragement: string;
+    suggestedNextFocus: string;
+    tone: string;
+}
+interface WellnessProgress {
+    summary: string;
+    encouragement: string;
+    tone: string;
+}
+interface TrendInsight {
+    trendSummary: string;
+    emotionalPattern: string;
+    recommendation: string;
+    tone: string;
+}
+interface EventSummaryDigest {
+    summary: string;
+    highlights: string[];
+    tone: string;
+}
+interface SpeakerPerformance {
+    overview: string;
+    strengths: string[];
+    areasForImprovement: string[];
+    tone: string;
+}
+interface NetworkingMatches {
+    matches: string[];
+    rationale: string;
+}
+interface AttendeeEngagement {
+    overview: string;
+    topSessions: string[];
+    recommendations: string[];
+    tone: string;
+}
+interface EventPulse {
+    trendSummary: string;
+    sentimentOverview: string;
+    engagementInsights: string;
+    recommendation: string;
+    tone: string;
+}
+interface SessionRecap {
+    recap: string;
+    takeaways: string[];
+    tone: string;
+}
+interface SponsorValueSummary {
+    overview: string;
+    highlights: string[];
+    tone: string;
+}
+interface AnnouncementRewrite {
+    rewritten: string;
+    toneUsed: string;
+}
+interface LeadershipInsight {
+    insight: string;
+    rootCause: string;
+    practicalSteps: string[];
+    tone: string;
+}
+interface FeedbackInsight {
+    sentiment: string;
+    summary: string;
+    highlights: string[];
+}
+interface PerformanceReview {
+    summaryParagraph: string;
+    strengthsSection: string[];
+    growthSection: string[];
+    tone: string;
+}
+interface TeamDynamics {
+    diagnosis: string;
+    risks: string[];
+    suggestedMoves: string[];
+    tone: string;
+}
+interface ProductivityInsight {
+    insight: string;
+    suggestions: string[];
+    tone: string;
+}
+
+declare function isSummary(result: any): result is {
+    data: ShortTextSummary;
+};
+declare function isQA(result: any): result is {
+    data: QuestionAnswerSummary;
+};
+declare function isNudge(result: any): result is {
+    data: DailyNudge;
+};
+declare function isRecommendation(result: any): result is {
+    data: SessionRecommendation;
+};
+declare function isAICoachFeedback(result: any): result is {
+    data: AICoachFeedback;
+};
+declare function isWellnessProgress(result: any): result is {
+    data: WellnessProgress;
+};
+declare function isTrendInsight(result: any): result is {
+    data: TrendInsight;
+};
+declare function isEventSummary(result: any): result is {
+    data: EventSummaryDigest;
+};
+declare function isSpeakerPerformance(result: any): result is {
+    data: SpeakerPerformance;
+};
+declare function isNetworkingMatches(result: any): result is {
+    data: NetworkingMatches;
+};
+declare function isAttendeeEngagement(result: any): result is {
+    data: AttendeeEngagement;
+};
+declare function isEventPulse(result: any): result is {
+    data: EventPulse;
+};
+declare function isSessionRecap(result: any): result is {
+    data: SessionRecap;
+};
+declare function isSponsorSummary(result: any): result is {
+    data: SponsorValueSummary;
+};
+declare function isAnnouncementRewrite(result: any): result is {
+    data: AnnouncementRewrite;
+};
+declare function isLeadershipInsight(result: any): result is {
+    data: LeadershipInsight;
+};
+declare function isFeedbackInsight(result: any): result is {
+    data: FeedbackInsight;
+};
+declare function isProductivityInsight(result: any): result is {
+    data: ProductivityInsight;
+};
+declare function isTeamDynamics(result: any): result is {
+    data: TeamDynamics;
+};
+declare function isPerformanceReview(result: any): result is {
+    data: PerformanceReview;
+};
+
+export { type AICoachFeedback, type AnnouncementRewrite, type AttendeeEngagement, type DailyNudge, type EricClientOptions, type EricResponse, EricSDK, type EventPulse, type EventSummaryDigest, type FeedbackInsight, type LeadershipInsight, type NetworkingMatches, type PerformanceReview, type ProductivityInsight, type QAItem, type QuestionAnswerSummary, type RecommendationItem, type SessionRecap, type SessionRecommendation, type ShortTextSummary, type SpeakerPerformance, type SponsorValueSummary, type TeamDynamics, type TrendInsight, type WellnessProgress, isAICoachFeedback, isAnnouncementRewrite, isAttendeeEngagement, isEventPulse, isEventSummary, isFeedbackInsight, isLeadershipInsight, isNetworkingMatches, isNudge, isPerformanceReview, isProductivityInsight, isQA, isRecommendation, isSessionRecap, isSpeakerPerformance, isSponsorSummary, isSummary, isTeamDynamics, isTrendInsight, isWellnessProgress };

package/dist/index.d.ts

@@ -0,0 +1,199 @@
+interface EricClientOptions {
+    apiKey: string;
+    client: string;
+    appId: "wellness" | "events" | "business";
+    baseUrl?: string;
+}
+interface EricResponse {
+    flow: string;
+    type: string;
+    data: any;
+}
+declare class EricSDK {
+    private apiKey;
+    private client;
+    private appId;
+    private baseUrl;
+    constructor(options: EricClientOptions);
+    call(flowName: string, data: any): Promise<EricResponse>;
+    decide(data: {
+        text: string;
+        topic?: string;
+        userState?: any;
+        allowedFlows?: string[];
+    }): Promise<EricResponse>;
+}
+
+interface ShortTextSummary {
+    summary: string;
+}
+interface QAItem {
+    question: string;
+    answer: string;
+}
+interface QuestionAnswerSummary {
+    summary: string;
+    questions: QAItem[];
+}
+interface DailyNudge {
+    nudge: string;
+}
+interface RecommendationItem {
+    id: string;
+    title: string;
+    reason: string;
+}
+interface SessionRecommendation {
+    recommendations: RecommendationItem[];
+    rationale: string;
+}
+interface AICoachFeedback {
+    summary: string;
+    encouragement: string;
+    suggestedNextFocus: string;
+    tone: string;
+}
+interface WellnessProgress {
+    summary: string;
+    encouragement: string;
+    tone: string;
+}
+interface TrendInsight {
+    trendSummary: string;
+    emotionalPattern: string;
+    recommendation: string;
+    tone: string;
+}
+interface EventSummaryDigest {
+    summary: string;
+    highlights: string[];
+    tone: string;
+}
+interface SpeakerPerformance {
+    overview: string;
+    strengths: string[];
+    areasForImprovement: string[];
+    tone: string;
+}
+interface NetworkingMatches {
+    matches: string[];
+    rationale: string;
+}
+interface AttendeeEngagement {
+    overview: string;
+    topSessions: string[];
+    recommendations: string[];
+    tone: string;
+}
+interface EventPulse {
+    trendSummary: string;
+    sentimentOverview: string;
+    engagementInsights: string;
+    recommendation: string;
+    tone: string;
+}
+interface SessionRecap {
+    recap: string;
+    takeaways: string[];
+    tone: string;
+}
+interface SponsorValueSummary {
+    overview: string;
+    highlights: string[];
+    tone: string;
+}
+interface AnnouncementRewrite {
+    rewritten: string;
+    toneUsed: string;
+}
+interface LeadershipInsight {
+    insight: string;
+    rootCause: string;
+    practicalSteps: string[];
+    tone: string;
+}
+interface FeedbackInsight {
+    sentiment: string;
+    summary: string;
+    highlights: string[];
+}
+interface PerformanceReview {
+    summaryParagraph: string;
+    strengthsSection: string[];
+    growthSection: string[];
+    tone: string;
+}
+interface TeamDynamics {
+    diagnosis: string;
+    risks: string[];
+    suggestedMoves: string[];
+    tone: string;
+}
+interface ProductivityInsight {
+    insight: string;
+    suggestions: string[];
+    tone: string;
+}
+
+declare function isSummary(result: any): result is {
+    data: ShortTextSummary;
+};
+declare function isQA(result: any): result is {
+    data: QuestionAnswerSummary;
+};
+declare function isNudge(result: any): result is {
+    data: DailyNudge;
+};
+declare function isRecommendation(result: any): result is {
+    data: SessionRecommendation;
+};
+declare function isAICoachFeedback(result: any): result is {
+    data: AICoachFeedback;
+};
+declare function isWellnessProgress(result: any): result is {
+    data: WellnessProgress;
+};
+declare function isTrendInsight(result: any): result is {
+    data: TrendInsight;
+};
+declare function isEventSummary(result: any): result is {
+    data: EventSummaryDigest;
+};
+declare function isSpeakerPerformance(result: any): result is {
+    data: SpeakerPerformance;
+};
+declare function isNetworkingMatches(result: any): result is {
+    data: NetworkingMatches;
+};
+declare function isAttendeeEngagement(result: any): result is {
+    data: AttendeeEngagement;
+};
+declare function isEventPulse(result: any): result is {
+    data: EventPulse;
+};
+declare function isSessionRecap(result: any): result is {
+    data: SessionRecap;
+};
+declare function isSponsorSummary(result: any): result is {
+    data: SponsorValueSummary;
+};
+declare function isAnnouncementRewrite(result: any): result is {
+    data: AnnouncementRewrite;
+};
+declare function isLeadershipInsight(result: any): result is {
+    data: LeadershipInsight;
+};
+declare function isFeedbackInsight(result: any): result is {
+    data: FeedbackInsight;
+};
+declare function isProductivityInsight(result: any): result is {
+    data: ProductivityInsight;
+};
+declare function isTeamDynamics(result: any): result is {
+    data: TeamDynamics;
+};
+declare function isPerformanceReview(result: any): result is {
+    data: PerformanceReview;
+};
+
+export { type AICoachFeedback, type AnnouncementRewrite, type AttendeeEngagement, type DailyNudge, type EricClientOptions, type EricResponse, EricSDK, type EventPulse, type EventSummaryDigest, type FeedbackInsight, type LeadershipInsight, type NetworkingMatches, type PerformanceReview, type ProductivityInsight, type QAItem, type QuestionAnswerSummary, type RecommendationItem, type SessionRecap, type SessionRecommendation, type ShortTextSummary, type SpeakerPerformance, type SponsorValueSummary, type TeamDynamics, type TrendInsight, type WellnessProgress, isAICoachFeedback, isAnnouncementRewrite, isAttendeeEngagement, isEventPulse, isEventSummary, isFeedbackInsight, isLeadershipInsight, isNetworkingMatches, isNudge, isPerformanceReview, isProductivityInsight, isQA, isRecommendation, isSessionRecap, isSpeakerPerformance, isSponsorSummary, isSummary, isTeamDynamics, isTrendInsight, isWellnessProgress };

package/dist/index.js

@@ -0,0 +1,141 @@
+// src/client.ts
+import axios from "axios";
+var EricSDK = class {
+  constructor(options) {
+    this.apiKey = options.apiKey;
+    this.client = options.client;
+    this.appId = options.appId;
+    this.baseUrl = options.baseUrl ?? "https://us-central1-eric-ai-prod.cloudfunctions.net/runFlow";
+  }
+  /* -------------------------------------------------------------
+   * 1) DIRECT CALL — developer explicitly chooses the flow
+   * ------------------------------------------------------------- */
+  async call(flowName, data) {
+    const payload = {
+      flow: flowName,
+      data: {
+        ...data,
+        client: this.client,
+        appId: this.appId
+      }
+    };
+    const res = await axios.post(this.baseUrl, payload, {
+      headers: {
+        "x-api-key": this.apiKey,
+        "x-api-client": this.client,
+        "Content-Type": "application/json"
+      }
+    });
+    return res.data.output;
+  }
+  /* -------------------------------------------------------------
+   * 2) DECIDE — agentic routing with optional allowedFlows
+   * ------------------------------------------------------------- */
+  async decide(data) {
+    const { allowedFlows, ...rest } = data;
+    const payload = {
+      flow: "policyDecisionMaker",
+      data: {
+        ...rest,
+        client: this.client,
+        appId: this.appId
+      }
+    };
+    if (allowedFlows) {
+      payload.data.allowedFlows = allowedFlows;
+    }
+    const res = await axios.post(this.baseUrl, payload, {
+      headers: {
+        "x-api-key": this.apiKey,
+        "x-api-client": this.client,
+        "Content-Type": "application/json"
+      }
+    });
+    return res.data.output;
+  }
+};
+
+// src/flows/helper.ts
+function isSummary(result) {
+  return result.flow === "shortTextSummary";
+}
+function isQA(result) {
+  return result.flow === "questionAnswerHelper";
+}
+function isNudge(result) {
+  return result.flow === "dailyNudgeGenerator";
+}
+function isRecommendation(result) {
+  return result.flow === "personalizedSessionRecommender";
+}
+function isAICoachFeedback(result) {
+  return result.flow === "aiCoachFeedback";
+}
+function isWellnessProgress(result) {
+  return result.flow === "wellnessProgressReporter";
+}
+function isTrendInsight(result) {
+  return result.flow === "trendInsightReporter";
+}
+function isEventSummary(result) {
+  return result.flow === "eventSummaryDigest";
+}
+function isSpeakerPerformance(result) {
+  return result.flow === "speakerPerformanceAnalyzer";
+}
+function isNetworkingMatches(result) {
+  return result.flow === "networkingMatchmaker";
+}
+function isAttendeeEngagement(result) {
+  return result.flow === "attendeeEngagementReporter";
+}
+function isEventPulse(result) {
+  return result.flow === "eventPulseReport";
+}
+function isSessionRecap(result) {
+  return result.flow === "sessionRecapGenerator";
+}
+function isSponsorSummary(result) {
+  return result.flow === "sponsorValueSummary";
+}
+function isAnnouncementRewrite(result) {
+  return result.flow === "announcementRewriter";
+}
+function isLeadershipInsight(result) {
+  return result.flow === "leadershipInsight";
+}
+function isFeedbackInsight(result) {
+  return result.flow === "feedbackInsightAnalyzer";
+}
+function isProductivityInsight(result) {
+  return result.flow === "productivityCoach";
+}
+function isTeamDynamics(result) {
+  return result.flow === "teamDynamicsAnalyzer";
+}
+function isPerformanceReview(result) {
+  return result.flow === "performanceReviewAssistant";
+}
+export {
+  EricSDK,
+  isAICoachFeedback,
+  isAnnouncementRewrite,
+  isAttendeeEngagement,
+  isEventPulse,
+  isEventSummary,
+  isFeedbackInsight,
+  isLeadershipInsight,
+  isNetworkingMatches,
+  isNudge,
+  isPerformanceReview,
+  isProductivityInsight,
+  isQA,
+  isRecommendation,
+  isSessionRecap,
+  isSpeakerPerformance,
+  isSponsorSummary,
+  isSummary,
+  isTeamDynamics,
+  isTrendInsight,
+  isWellnessProgress
+};

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "eric-sdk",
+  "version": "0.0.1",
+  "description": "Official SDK for interacting with the Eric AI Policy Engine",
+  "author": "Rod Bridges",
+  "license": "MIT",
+
+  "type": "module",
+
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+
+  "exports": {
+    ".": {
+      "require": "./dist/index.cjs",
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+
+  "scripts": {
+    "build": "tsup src/index.ts --format esm,cjs --dts",
+    "prepare": "npm run build",
+    "test": "echo \"No tests yet\""
+  },
+
+  "dependencies": {
+    "axios": "^1.13.2",
+    "zod": "^4.1.13"
+  },
+
+  "devDependencies": {
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3"
+  }
+}

package/src/client.ts

@@ -0,0 +1,89 @@
+import axios from "axios";
+
+export interface EricClientOptions {
+  apiKey: string;
+  client: string;               // ingomu, eventinterface, etc.
+  appId: "wellness" | "events" | "business"; // REQUIRED for policy engine
+  baseUrl?: string;
+}
+
+export interface EricResponse {
+  flow: string;
+  type: string;
+  data: any;
+}
+
+export class EricSDK {
+  private apiKey: string;
+  private client: string;
+  private appId: string;
+  private baseUrl: string;
+
+  constructor(options: EricClientOptions) {
+    this.apiKey = options.apiKey;
+    this.client = options.client;
+    this.appId = options.appId;   // <-- FIXED: needed for policy input
+    this.baseUrl =
+      options.baseUrl ??
+      "https://us-central1-eric-ai-prod.cloudfunctions.net/runFlow";
+  }
+
+  /* -------------------------------------------------------------
+   * 1) DIRECT CALL — developer explicitly chooses the flow
+   * ------------------------------------------------------------- */
+  async call(flowName: string, data: any): Promise<EricResponse> {
+    const payload = {
+      flow: flowName,
+      data: {
+        ...data,
+        client: this.client,
+        appId: this.appId
+      }
+    };
+
+    const res = await axios.post(this.baseUrl, payload, {
+      headers: {
+        "x-api-key": this.apiKey,
+        "x-api-client": this.client,
+        "Content-Type": "application/json",
+      }
+    });
+
+    return res.data.output;
+  }
+
+  /* -------------------------------------------------------------
+   * 2) DECIDE — agentic routing with optional allowedFlows
+   * ------------------------------------------------------------- */
+  async decide(data: {
+    text: string;
+    topic?: string;
+    userState?: any;
+    allowedFlows?: string[];
+  }): Promise<EricResponse> {
+    const { allowedFlows, ...rest } = data;
+
+    const payload: any = {
+      flow: "policyDecisionMaker",
+      data: {
+        ...rest,
+        client: this.client,
+        appId: this.appId
+      }
+    };
+
+    if (allowedFlows) {
+      payload.data.allowedFlows = allowedFlows;
+    }
+
+    const res = await axios.post(this.baseUrl, payload, {
+      headers: {
+        "x-api-key": this.apiKey,
+        "x-api-client": this.client,
+        "Content-Type": "application/json",
+      }
+    });
+
+    return res.data.output;
+  }
+}

package/src/flows/helper.ts

@@ -0,0 +1,110 @@
+import {
+  ShortTextSummary,
+  QuestionAnswerSummary,
+  DailyNudge,
+  SessionRecommendation,
+  AICoachFeedback,
+  WellnessProgress,
+  TrendInsight,
+  EventSummaryDigest,
+  SpeakerPerformance,
+  NetworkingMatches,
+  AttendeeEngagement,
+  EventPulse,
+  SessionRecap,
+  SponsorValueSummary,
+  AnnouncementRewrite,
+  LeadershipInsight,
+  FeedbackInsight,
+  PerformanceReview,
+  TeamDynamics,
+  ProductivityInsight
+} from "../types/flow";
+
+// COMMON ---------------------------------------------------
+
+export function isSummary(result: any): result is { data: ShortTextSummary } {
+  return result.flow === "shortTextSummary";
+}
+
+export function isQA(result: any): result is { data: QuestionAnswerSummary } {
+  return result.flow === "questionAnswerHelper";
+}
+
+export function isNudge(result: any): result is { data: DailyNudge } {
+  return result.flow === "dailyNudgeGenerator";
+}
+
+// WELLNESS --------------------------------------------------
+
+export function isRecommendation(result: any): result is { data: SessionRecommendation } {
+  return result.flow === "personalizedSessionRecommender";
+}
+
+export function isAICoachFeedback(result: any): result is { data: AICoachFeedback } {
+  return result.flow === "aiCoachFeedback";
+}
+
+export function isWellnessProgress(result: any): result is { data: WellnessProgress } {
+  return result.flow === "wellnessProgressReporter";
+}
+
+export function isTrendInsight(result: any): result is { data: TrendInsight } {
+  return result.flow === "trendInsightReporter";
+}
+
+// EVENTS ----------------------------------------------------
+
+export function isEventSummary(result: any): result is { data: EventSummaryDigest } {
+  return result.flow === "eventSummaryDigest";
+}
+
+export function isSpeakerPerformance(result: any): result is { data: SpeakerPerformance } {
+  return result.flow === "speakerPerformanceAnalyzer";
+}
+
+export function isNetworkingMatches(result: any): result is { data: NetworkingMatches } {
+  return result.flow === "networkingMatchmaker";
+}
+
+export function isAttendeeEngagement(result: any): result is { data: AttendeeEngagement } {
+  return result.flow === "attendeeEngagementReporter";
+}
+
+export function isEventPulse(result: any): result is { data: EventPulse } {
+  return result.flow === "eventPulseReport";
+}
+
+export function isSessionRecap(result: any): result is { data: SessionRecap } {
+  return result.flow === "sessionRecapGenerator";
+}
+
+export function isSponsorSummary(result: any): result is { data: SponsorValueSummary } {
+  return result.flow === "sponsorValueSummary";
+}
+
+export function isAnnouncementRewrite(result: any): result is { data: AnnouncementRewrite } {
+  return result.flow === "announcementRewriter";
+}
+
+// BUSINESS --------------------------------------------------
+
+export function isLeadershipInsight(result: any): result is { data: LeadershipInsight } {
+  return result.flow === "leadershipInsight";
+}
+
+export function isFeedbackInsight(result: any): result is { data: FeedbackInsight } {
+  return result.flow === "feedbackInsightAnalyzer";
+}
+
+export function isProductivityInsight(result: any): result is { data: ProductivityInsight } {
+  return result.flow === "productivityCoach";
+}
+
+export function isTeamDynamics(result: any): result is { data: TeamDynamics } {
+  return result.flow === "teamDynamicsAnalyzer";
+}
+
+export function isPerformanceReview(result: any): result is { data: PerformanceReview } {
+  return result.flow === "performanceReviewAssistant";
+}

package/src/index.ts

@@ -0,0 +1,3 @@
+export * from "./client";
+export * from "./flows/helper";
+export * from "./types/flow";

package/src/types/flow.ts

@@ -0,0 +1,139 @@
+// COMMON --------------------------------------------------
+
+export interface ShortTextSummary {
+  summary: string;
+}
+
+export interface QAItem {
+  question: string;
+  answer: string;
+}
+
+export interface QuestionAnswerSummary {
+  summary: string;
+  questions: QAItem[];
+}
+
+export interface DailyNudge {
+  nudge: string;
+}
+
+// WELLNESS --------------------------------------------------
+
+export interface RecommendationItem {
+  id: string;
+  title: string;
+  reason: string;
+}
+
+export interface SessionRecommendation {
+  recommendations: RecommendationItem[];
+  rationale: string;
+}
+
+export interface AICoachFeedback {
+  summary: string;
+  encouragement: string;
+  suggestedNextFocus: string;
+  tone: string;
+}
+
+export interface WellnessProgress {
+  summary: string;
+  encouragement: string;
+  tone: string;
+}
+
+export interface TrendInsight {
+  trendSummary: string;
+  emotionalPattern: string;
+  recommendation: string;
+  tone: string;
+}
+
+// EVENTS ----------------------------------------------------
+
+export interface EventSummaryDigest {
+  summary: string;
+  highlights: string[];
+  tone: string;
+}
+
+export interface SpeakerPerformance {
+  overview: string;
+  strengths: string[];
+  areasForImprovement: string[];
+  tone: string;
+}
+
+export interface NetworkingMatches {
+  matches: string[];
+  rationale: string;
+}
+
+export interface AttendeeEngagement {
+  overview: string;
+  topSessions: string[];
+  recommendations: string[];
+  tone: string;
+}
+
+export interface EventPulse {
+  trendSummary: string;
+  sentimentOverview: string;
+  engagementInsights: string;
+  recommendation: string;
+  tone: string;
+}
+
+export interface SessionRecap {
+  recap: string;
+  takeaways: string[];
+  tone: string;
+}
+
+export interface SponsorValueSummary {
+  overview: string;
+  highlights: string[];
+  tone: string;
+}
+
+export interface AnnouncementRewrite {
+  rewritten: string;
+  toneUsed: string;
+}
+
+// BUSINESS --------------------------------------------------
+
+export interface LeadershipInsight {
+  insight: string;
+  rootCause: string;
+  practicalSteps: string[];
+  tone: string;
+}
+
+export interface FeedbackInsight {
+  sentiment: string;
+  summary: string;
+  highlights: string[];
+}
+
+export interface PerformanceReview {
+  summaryParagraph: string;
+  strengthsSection: string[];
+  growthSection: string[];
+  tone: string;
+}
+
+export interface TeamDynamics {
+  diagnosis: string;
+  risks: string[];
+  suggestedMoves: string[];
+  tone: string;
+}
+
+export interface ProductivityInsight {
+  insight: string;
+  suggestions: string[];
+  tone: string;
+}

package/tsconfig.json

@@ -0,0 +1,13 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "ES2020",
+    "moduleResolution": "node",
+    "outDir": "dist",
+    "strict": true,
+    "declaration": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true
+  },
+  "include": ["src"]
+}