eric-sdk 0.1.3 → 0.1.5

package/CHANGELOG.md

@@ -1,75 +1,96 @@
-# Changelog
-
-All notable changes to the Eric SDK are documented here.
-
-This project follows semantic versioning.
-Pre-1.0 releases may introduce intentional breaking changes as the API surface evolves.
-
----
-
-## [0.1.3] – 2026-02-06
-
-### Changed:
-
-* **Removed `client` from request payload**: The SDK no longer includes `client` in the request body when calling `decide()`.
-
-### Rationale:
-
-`client` is infrastructure identity and is now treated as authoritative header-only metadata (`x-api-client`).  
-This change removes ambiguity, prevents spoofing, and aligns the SDK with Eric’s control-plane model, where execution authority lives outside user-provided input.
-
-### Notes:
-
-* Applications must continue to provide `x-api-client` and `x-api-key` headers.
-* Requests that previously included `client` in the body may be rejected by strict API validation.
-
----
-
-## [0.1.2] – 2026-02-03
-
-### What's New:
-
-* **Updated API Endpoint**: The SDK now calls the API endpoint at `https://us-central1-eric-ai-prod.cloudfunctions.net/decide` for decision-making flows.
-
-### Breaking Changes:
-
-* **Endpoint Change**: If you were using the previous `decide` endpoint, please update the SDK configuration to use the new endpoint.
-
----
-
-## [0.1.1] – 2026-01-30
-
-### Changed:
-
-* Removed explicit `flow: "decisionRouter"` from SDK requests.
-
-### Rationale:
-
-The Eric API no longer accepts direct flow invocations.
-All requests are now treated as intent submissions and are routed through the internal decision router by default. This change simplifies the SDK payload and prevents accidental coupling to internal execution details.
-
----
-
-## [0.1.0] – 2026-01-27
-
-### Changed:
-
-* Removed `client.call()` to prevent direct flow invocation.
-* All executions must now be routed through `decide()`.
-
-### Rationale:
-
-Direct flow execution allowed applications to bypass policy enforcement. Eric is designed as a governance and control layer, and all execution must pass through policy evaluation to ensure deterministic, auditable outcomes. This release intentionally narrows the public API to reflect Eric’s execution model.
-
----
-
-## [0.0.5] – 2025-12-14
-
-### Added:
-
-* Initial public SDK release.
-* `decide()` with policy-based routing and optional execution bounds.
-
----
-
-This version ensures clarity and consistency across all sections while providing users with the necessary context on each update.
+# Changelog
+
+All notable changes to the Eric SDK are documented here.
+
+This project follows semantic versioning.
+Pre-1.0 releases may introduce intentional breaking changes as the API surface evolves.
+
+---
+
+## [0.1.5] – 2026-02-24
+
+### Changed
+
+* Narrowed `type` in response shape from `string` to `"structured" | "text"`.
+
+### Rationale
+
+Response format classification is now explicitly constrained.
+This prevents accidental drift in output types and strengthens the SDK’s deterministic contract.
+
+---
+
+## [0.1.4] – 2026-02-13
+
+### Changed
+
+- Added `engines` field specifying Node.js >=20.
+
+---
+
+## [0.1.3] – 2026-02-06
+
+### Changed:
+
+* **Removed `client` from request payload**: The SDK no longer includes `client` in the request body when calling `decide()`.
+
+### Rationale:
+
+`client` is infrastructure identity and is now treated as authoritative header-only metadata (`x-api-client`).  
+This change removes ambiguity, prevents spoofing, and aligns the SDK with Eric’s control-plane model, where execution authority lives outside user-provided input.
+
+### Notes:
+
+* Applications must continue to provide `x-api-client` and `x-api-key` headers.
+* Requests that previously included `client` in the body may be rejected by strict API validation.
+
+---
+
+## [0.1.2] – 2026-02-03
+
+### What's New:
+
+* **Updated API Endpoint**: The SDK now calls the API endpoint at `https://us-central1-eric-ai-prod.cloudfunctions.net/decide` for decision-making flows.
+
+### Breaking Changes:
+
+* **Endpoint Change**: If you were using the previous `decide` endpoint, please update the SDK configuration to use the new endpoint.
+
+---
+
+## [0.1.1] – 2026-01-30
+
+### Changed:
+
+* Removed explicit `flow: "decisionRouter"` from SDK requests.
+
+### Rationale:
+
+The Eric API no longer accepts direct flow invocations.
+All requests are now treated as intent submissions and are routed through the internal decision router by default. This change simplifies the SDK payload and prevents accidental coupling to internal execution details.
+
+---
+
+## [0.1.0] – 2026-01-27
+
+### Changed:
+
+* Removed `client.call()` to prevent direct flow invocation.
+* All executions must now be routed through `decide()`.
+
+### Rationale:
+
+Direct flow execution allowed applications to bypass policy enforcement. Eric is designed as a governance and control layer, and all execution must pass through policy evaluation to ensure deterministic, auditable outcomes. This release intentionally narrows the public API to reflect Eric’s execution model.
+
+---
+
+## [0.0.5] – 2025-12-14
+
+### Added:
+
+* Initial public SDK release.
+* `decide()` with policy-based routing and optional execution bounds.
+
+---
+
+This version ensures clarity and consistency across all sections while providing users with the necessary context on each update.

package/README.md

@@ -1,125 +1,126 @@
-# Eric SDK (JavaScript / TypeScript)
-
-Official SDK for interacting with **Eric AI**, a policy-governed execution layer for AI systems.
-
-Eric is designed for environments where AI behavior must be **controlled, deterministic, and auditable**.  
-All requests are evaluated against configured policy before any capability is executed.
-
-This SDK exposes a single, safe interaction model that enforces those guarantees by default.
-
----
-
-## Installation
-
-```bash
-npm install eric-sdk
-```
-
----
-
-## Authentication
-
-You will need an Eric-issued API key.
-
-```ts
-import { EricSDK } from "eric-sdk";
-
-const eric = new EricSDK({
-  apiKey: process.env.ERIC_API_KEY!,
-  client: "your-app-id",
-});
-```
-
-API keys are scoped and governed server-side.
-Keys should be treated as secrets and stored securely.
-
----
-
-## Security Notice
-
-This SDK enforces server-side policy and execution controls.
-
-API keys must be stored securely and never embedded in public repositories.
-
----
-
-## Usage
-
-### Policy-Governed Execution
-
-All interactions with Eric are routed through `decide()`.
-
-Eric evaluates each request against policy, routing constraints, and execution bounds before selecting and invoking an approved capability.
-
-```ts
-const result = await eric.decide({
-  text: "summarize the provided content",
-  requestType: "summary",
-});
-```
-
----
-
-### Optional Execution Bounds
-
-You may optionally restrict which capabilities are eligible for execution.
-
-```ts
-await eric.decide({
-  text: "Generate a structured daily summary for the provided input",
-  allowedFlows: ["dailySummary"],
-});
-```
-
-When bounds are provided:
-
-* Only approved capabilities may execute
-* No out-of-scope behavior is permitted
-* Results remain deterministic and auditable
-
----
-
-## Response Shape
-
-```ts
-{
-  flow: string;
-  type: string;
-  data: unknown;
-}
-```
-
-All responses conform to pre-approved output contracts.
-
-All fields are guaranteed to be present according to the executed capability’s contract.
-
----
-
-## Design Principles
-
-* **Policy-first execution** — no direct or bypassed calls
-* **Deterministic behavior** — predictable outputs by design
-* **Auditability** — every decision and execution is logged
-* **Infrastructure-grade** — built for production systems, not chatbots
-* **Intend-base API** — clients describe what they want, not what to run
-
----
-
-## Versioning
-
-The Eric SDK follows semantic versioning.
-
-Breaking changes reflect deliberate enforcement of governance and safety guarantees.
-
-Pre-1.0 versions were experimental and are not supported.
-
-See `CHANGELOG.md` for details.
-
----
-
-## Support
-
-For access, onboarding, or documentation:
-[https://ericaicontrol.dev](https://ericaicontrol.dev)
-
-
+# Eric SDK (JavaScript / TypeScript)
+
+Official SDK for interacting with **Eric AI**, a policy-governed execution layer for AI systems.
+
+Eric is designed for environments where AI behavior must be **controlled, deterministic, and auditable**.  
+All requests are evaluated against configured policy before any capability is executed.
+
+This SDK exposes a single, safe interaction model that enforces those guarantees by default.
+
+---
+
+## Installation
+
+```bash
+npm install eric-sdk
+```
+
+---
+
+## Authentication
+
+You will need an Eric-issued API key.
+
+```ts
+import { EricSDK } from "eric-sdk";
+
+const eric = new EricSDK({
+  apiKey: process.env.ERIC_API_KEY!,
+  client: "your-app-id",
+});
+```
+
+API keys are scoped and governed server-side.
+Keys should be treated as secrets and stored securely.
+
+---
+
+## Security Notice
+
+This SDK enforces server-side policy and execution controls.
+
+API keys must be stored securely and never embedded in public repositories.
+
+---
+
+## Usage
+
+### Policy-Governed Execution
+
+All interactions with Eric are routed through `decide()`.
+
+Eric evaluates each request against policy, routing constraints, and execution bounds before selecting and invoking an approved capability.
+
+```ts
+const result = await eric.decide({
+  text: "summarize the provided content",
+  requestType: "summary",
+});
+```
+
+---
+
+### Optional Execution Bounds
+
+You may optionally restrict which capabilities are eligible for execution.
+
+```ts
+await eric.decide({
+  text: "Generate a structured daily summary for the provided input",
+  allowedFlows: ["dailySummary"],
+});
+```
+
+When `allowedFlows` is provided:
+
+- Only capabilities in the allowed set are eligible for execution.
+- If resolution falls outside the allowed set, execution is denied.
+- No fallback or automatic substitution occurs.
+
+---
+
+## Response Shape
+
+```ts
+{
+  flow: string;                     // resolved capability
+  type: "structured" | "text";      // output format classification
+  data: unknown;                    // structured object or text result
+}
+
+```
+
+All responses conform to pre-approved output contracts.
+
+All fields are guaranteed to be present according to the executed capability’s contract.
+
+---
+
+## Design Principles
+
+* **Policy-first execution** — no direct or bypassed calls
+* **Deterministic behavior** — predictable outputs by design
+* **Auditability** — every decision and execution is logged
+* **Infrastructure-grade** — built for production systems, not chatbots
+* **Intent-based API** — clients describe what they want, not what to run
+
+---
+
+## Versioning
+
+The Eric SDK follows semantic versioning.
+
+Breaking changes reflect deliberate enforcement of governance and safety guarantees.
+
+Pre-1.0 versions were experimental and are not supported.
+
+See `CHANGELOG.md` for details.
+
+---
+
+## Support
+
+For access, onboarding, or documentation:
+[https://ericaicontrol.dev](https://ericaicontrol.dev)
+
+

package/dist/index.cjs

@@ -30,27 +30,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // 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
+  EricSDK: () => EricSDK
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -89,89 +69,7 @@ var EricSDK = class {
     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
+  EricSDK
 });