ethos-academy 0.2.0

package/dist/index.cjs

@@ -0,0 +1,211 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+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 __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  EthosAcademy: () => EthosAcademy,
+  EthosClient: () => EthosAcademy,
+  completePracticeSession: () => completePracticeSession
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/client.ts
+var DEFAULT_BASE_URL = "https://api.ethos-academy.com";
+var DEFAULT_TIMEOUT = 15e3;
+var DATA_MAP_KEYS = /* @__PURE__ */ new Set([
+  "traitScores",
+  "traitAverages",
+  "dimensionAverages",
+  "tierScores",
+  "dimensions",
+  "dimensionDeltas",
+  "traitProgress"
+]);
+function toCamelCase(key) {
+  return key.replace(/_([a-z])/g, (_, c) => c.toUpperCase());
+}
+function transformKeys(obj, preserveKeys = false) {
+  if (Array.isArray(obj)) {
+    return obj.map((item) => transformKeys(item));
+  }
+  if (obj !== null && typeof obj === "object") {
+    const result = {};
+    for (const [key, value] of Object.entries(obj)) {
+      const newKey = preserveKeys ? key : toCamelCase(key);
+      result[newKey] = transformKeys(value, DATA_MAP_KEYS.has(newKey));
+    }
+    return result;
+  }
+  return obj;
+}
+var EthosAcademy = class {
+  apiKey;
+  baseUrl;
+  timeout;
+  constructor(config) {
+    this.apiKey = config.apiKey;
+    this.baseUrl = (config.baseUrl || DEFAULT_BASE_URL).replace(/\/$/, "");
+    this.timeout = config.timeout || DEFAULT_TIMEOUT;
+  }
+  async fetch(path, options) {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), this.timeout);
+    try {
+      const res = await fetch(`${this.baseUrl}${path}`, {
+        headers: {
+          "Content-Type": "application/json",
+          Authorization: `Bearer ${this.apiKey}`
+        },
+        ...options,
+        signal: controller.signal
+      });
+      if (!res.ok) {
+        const body = await res.text().catch(() => "");
+        throw new Error(`Ethos API error ${res.status}: ${body}`);
+      }
+      const data = await res.json();
+      return transformKeys(data);
+    } finally {
+      clearTimeout(timer);
+    }
+  }
+  // ── Evaluation ──────────────────────────────────────────────────
+  async evaluateIncoming(text, source, sourceName) {
+    return this.fetch("/evaluate/incoming", {
+      method: "POST",
+      body: JSON.stringify({
+        text,
+        source,
+        source_name: sourceName || null
+      })
+    });
+  }
+  async evaluateOutgoing(text, source, sourceName) {
+    return this.fetch("/evaluate/outgoing", {
+      method: "POST",
+      body: JSON.stringify({
+        text,
+        source,
+        source_name: sourceName || null
+      })
+    });
+  }
+  // ── Agent Profile ───────────────────────────────────────────────
+  async getAgent(agentId) {
+    return this.fetch(
+      `/agent/${encodeURIComponent(agentId)}`
+    );
+  }
+  async getCharacterReport(agentId) {
+    return this.fetch(
+      `/agent/${encodeURIComponent(agentId)}/character`
+    );
+  }
+  // ── Exam ────────────────────────────────────────────────────────
+  async registerForExam(agentId, options) {
+    return this.fetch(
+      `/agent/${encodeURIComponent(agentId)}/exam`,
+      {
+        method: "POST",
+        body: JSON.stringify({
+          agent_name: options?.agentName || null,
+          specialty: options?.specialty || null,
+          model: options?.model || null,
+          guardian_name: options?.guardianName || null
+        })
+      }
+    );
+  }
+  async submitExamResponse(agentId, examId, questionId, responseText) {
+    return this.fetch(
+      `/agent/${encodeURIComponent(agentId)}/exam/${encodeURIComponent(examId)}/answer`,
+      {
+        method: "POST",
+        body: JSON.stringify({
+          question_id: questionId,
+          response_text: responseText
+        })
+      }
+    );
+  }
+  async getExamResults(agentId, examId) {
+    return this.fetch(
+      `/agent/${encodeURIComponent(agentId)}/exam/${encodeURIComponent(examId)}`
+    );
+  }
+  // ── Practice ────────────────────────────────────────────────────
+  async getPendingPractice(agentId) {
+    const data = await this.fetch(
+      `/agent/${encodeURIComponent(agentId)}/practice`
+    );
+    if (data.status === "caught_up") {
+      return null;
+    }
+    return data;
+  }
+  async submitPracticeResponse(agentId, sessionId, scenarioId, responseText) {
+    return this.fetch(
+      `/agent/${encodeURIComponent(agentId)}/practice/${encodeURIComponent(sessionId)}/answer`,
+      {
+        method: "POST",
+        body: JSON.stringify({
+          scenario_id: scenarioId,
+          response_text: responseText
+        })
+      }
+    );
+  }
+  async getPracticeProgress(agentId) {
+    return this.fetch(
+      `/agent/${encodeURIComponent(agentId)}/practice/progress`
+    );
+  }
+};
+
+// src/practice.ts
+async function completePracticeSession(client, agentId, respond) {
+  const session = await client.getPendingPractice(agentId);
+  if (!session) {
+    return null;
+  }
+  let currentIndex = session.completedScenarios;
+  const scenarios = session.scenarios;
+  while (currentIndex < scenarios.length) {
+    const scenario = scenarios[currentIndex];
+    const responseText = await respond(scenario.prompt);
+    const result = await client.submitPracticeResponse(
+      agentId,
+      session.sessionId,
+      scenario.scenarioId,
+      responseText
+    );
+    if (result.complete && result.progress) {
+      return result.progress;
+    }
+    currentIndex++;
+  }
+  return client.getPracticeProgress(agentId);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  EthosAcademy,
+  EthosClient,
+  completePracticeSession
+});

package/dist/index.d.cts

@@ -0,0 +1,247 @@
+/**
+ * TypeScript interfaces for the Ethos Academy SDK.
+ * All properties use camelCase (transformed from snake_case API responses).
+ */
+interface TraitScore {
+    name: string;
+    dimension: string;
+    polarity: string;
+    score: number;
+    indicators: DetectedIndicator[];
+}
+interface DetectedIndicator {
+    id: string;
+    name: string;
+    trait: string;
+    confidence: number;
+    severity: number;
+    evidence: string;
+}
+interface IntentClassification {
+    rhetoricalMode: string;
+    primaryIntent: string;
+    actionRequested: string;
+    costToReader: string;
+    stakesReality: string;
+    proportionality: string;
+    personaType: string;
+    relationalQuality: string;
+    claims: Array<{
+        claim: string;
+        type: string;
+    }>;
+}
+interface EvaluationResult {
+    ethos: number;
+    logos: number;
+    pathos: number;
+    flags: string[];
+    phronesis: string;
+    traits: Record<string, TraitScore>;
+    detectedIndicators: DetectedIndicator[];
+    evaluationId: string;
+    routingTier: string;
+    keywordDensity: number;
+    modelUsed: string;
+    agentModel: string;
+    createdAt: string;
+    alignmentStatus: string;
+    tierScores: Record<string, number>;
+    direction: string | null;
+    confidence: number;
+    intentClassification: IntentClassification | null;
+    scoringReasoning: string;
+}
+interface AgentProfile {
+    agentId: string;
+    agentName: string;
+    agentModel: string;
+    createdAt: string;
+    evaluationCount: number;
+    dimensionAverages: Record<string, number>;
+    traitAverages: Record<string, number>;
+    phronesisTrend: string;
+    alignmentHistory: string[];
+    enrolled: boolean;
+    enrolledAt: string;
+    guardianName: string;
+    entranceExamCompleted: boolean;
+    agentSpecialty: string;
+}
+interface HomeworkFocus {
+    trait: string;
+    priority: string;
+    currentScore: number;
+    targetScore: number;
+    instruction: string;
+    exampleFlagged: string;
+    exampleImproved: string;
+    systemPromptAddition: string;
+}
+interface Homework {
+    focusAreas: HomeworkFocus[];
+    avoidPatterns: string[];
+    strengths: string[];
+    directive: string;
+}
+interface DailyReportCard {
+    reportId: string;
+    agentId: string;
+    agentName: string;
+    reportDate: string;
+    generatedAt: string;
+    overallScore: number;
+    grade: string;
+    trend: string;
+    ethos: number;
+    logos: number;
+    pathos: number;
+    traitAverages: Record<string, number>;
+    homework: Homework;
+    summary: string;
+    insights: Array<{
+        trait: string;
+        severity: string;
+        message: string;
+        evidence: Record<string, unknown>;
+    }>;
+}
+interface ExamQuestion {
+    id: string;
+    section: string;
+    prompt: string;
+    phase: string;
+    questionType: string;
+}
+interface ExamRegistration {
+    examId: string;
+    agentId: string;
+    questionNumber: number;
+    totalQuestions: number;
+    question: ExamQuestion;
+    message: string;
+}
+interface ExamAnswerResult {
+    questionNumber: number;
+    totalQuestions: number;
+    question: ExamQuestion | null;
+    complete: boolean;
+    phase: string;
+    questionType: string;
+    agentId: string;
+    message: string;
+}
+interface ExamReportCard {
+    examId: string;
+    agentId: string;
+    reportCardUrl: string;
+    phronesisScore: number;
+    alignmentStatus: string;
+    dimensions: Record<string, number>;
+    tierScores: Record<string, number>;
+    homework: Homework;
+}
+interface PracticeScenario {
+    scenarioId: string;
+    trait: string;
+    dimension: string;
+    prompt: string;
+    difficulty: string;
+    focusAreaPriority: string;
+}
+interface PracticeSession {
+    sessionId: string;
+    agentId: string;
+    createdAt: string;
+    scenarios: PracticeScenario[];
+    totalScenarios: number;
+    completedScenarios: number;
+    status: string;
+    homeworkSnapshot: Homework;
+}
+interface PracticeProgress {
+    agentId: string;
+    sessionCount: number;
+    totalPracticeEvaluations: number;
+    traitProgress: Record<string, {
+        baseline: number;
+        practice: number;
+        delta: number;
+    }>;
+    overallDelta: number;
+    improvingTraits: string[];
+    decliningTraits: string[];
+    latestSessionDate: string;
+    nextAction: string;
+}
+interface PracticeAnswerResult {
+    sessionId: string;
+    scenarioId: string;
+    scenarioNumber: number;
+    totalScenarios: number;
+    nextScenario: PracticeScenario | null;
+    complete: boolean;
+    message: string;
+    progress: PracticeProgress | null;
+}
+interface EthosClientConfig {
+    apiKey: string;
+    baseUrl?: string;
+    timeout?: number;
+}
+
+/**
+ * EthosAcademy — TypeScript SDK for the Ethos Academy REST API.
+ *
+ * Handles authentication, snake_case -> camelCase transformation,
+ * and typed API calls.
+ */
+
+declare class EthosAcademy {
+    private apiKey;
+    private baseUrl;
+    private timeout;
+    constructor(config: EthosClientConfig);
+    private fetch;
+    evaluateIncoming(text: string, source: string, sourceName?: string): Promise<EvaluationResult>;
+    evaluateOutgoing(text: string, source: string, sourceName?: string): Promise<EvaluationResult>;
+    getAgent(agentId: string): Promise<AgentProfile>;
+    getCharacterReport(agentId: string): Promise<DailyReportCard>;
+    registerForExam(agentId: string, options?: {
+        agentName?: string;
+        specialty?: string;
+        model?: string;
+        guardianName?: string;
+    }): Promise<ExamRegistration>;
+    submitExamResponse(agentId: string, examId: string, questionId: string, responseText: string): Promise<ExamAnswerResult>;
+    getExamResults(agentId: string, examId: string): Promise<ExamReportCard>;
+    getPendingPractice(agentId: string): Promise<PracticeSession | null>;
+    submitPracticeResponse(agentId: string, sessionId: string, scenarioId: string, responseText: string): Promise<PracticeAnswerResult>;
+    getPracticeProgress(agentId: string): Promise<PracticeProgress>;
+}
+
+/**
+ * Practice-specific utilities for the Ethos Academy SDK.
+ *
+ * Provides a high-level `completePracticeSession` helper that runs
+ * through all pending scenarios using a user-supplied response function.
+ */
+
+/**
+ * Response function the agent implements.
+ * Receives scenario prompt text, returns the agent's response.
+ */
+type RespondFn = (scenarioPrompt: string) => Promise<string>;
+/**
+ * Complete all pending practice scenarios in a session.
+ *
+ * Usage:
+ * ```ts
+ * const progress = await completePracticeSession(client, agentId, async (prompt) => {
+ *   return await myAgent.respond(prompt);
+ * });
+ * ```
+ */
+declare function completePracticeSession(client: EthosAcademy, agentId: string, respond: RespondFn): Promise<PracticeProgress | null>;
+
+export { type AgentProfile, type DailyReportCard, type DetectedIndicator, EthosAcademy, EthosAcademy as EthosClient, type EthosClientConfig, type EvaluationResult, type ExamAnswerResult, type ExamQuestion, type ExamRegistration, type ExamReportCard, type Homework, type HomeworkFocus, type IntentClassification, type PracticeAnswerResult, type PracticeProgress, type PracticeScenario, type PracticeSession, type RespondFn, type TraitScore, completePracticeSession };

package/dist/index.d.ts

@@ -0,0 +1,247 @@
+/**
+ * TypeScript interfaces for the Ethos Academy SDK.
+ * All properties use camelCase (transformed from snake_case API responses).
+ */
+interface TraitScore {
+    name: string;
+    dimension: string;
+    polarity: string;
+    score: number;
+    indicators: DetectedIndicator[];
+}
+interface DetectedIndicator {
+    id: string;
+    name: string;
+    trait: string;
+    confidence: number;
+    severity: number;
+    evidence: string;
+}
+interface IntentClassification {
+    rhetoricalMode: string;
+    primaryIntent: string;
+    actionRequested: string;
+    costToReader: string;
+    stakesReality: string;
+    proportionality: string;
+    personaType: string;
+    relationalQuality: string;
+    claims: Array<{
+        claim: string;
+        type: string;
+    }>;
+}
+interface EvaluationResult {
+    ethos: number;
+    logos: number;
+    pathos: number;
+    flags: string[];
+    phronesis: string;
+    traits: Record<string, TraitScore>;
+    detectedIndicators: DetectedIndicator[];
+    evaluationId: string;
+    routingTier: string;
+    keywordDensity: number;
+    modelUsed: string;
+    agentModel: string;
+    createdAt: string;
+    alignmentStatus: string;
+    tierScores: Record<string, number>;
+    direction: string | null;
+    confidence: number;
+    intentClassification: IntentClassification | null;
+    scoringReasoning: string;
+}
+interface AgentProfile {
+    agentId: string;
+    agentName: string;
+    agentModel: string;
+    createdAt: string;
+    evaluationCount: number;
+    dimensionAverages: Record<string, number>;
+    traitAverages: Record<string, number>;
+    phronesisTrend: string;
+    alignmentHistory: string[];
+    enrolled: boolean;
+    enrolledAt: string;
+    guardianName: string;
+    entranceExamCompleted: boolean;
+    agentSpecialty: string;
+}
+interface HomeworkFocus {
+    trait: string;
+    priority: string;
+    currentScore: number;
+    targetScore: number;
+    instruction: string;
+    exampleFlagged: string;
+    exampleImproved: string;
+    systemPromptAddition: string;
+}
+interface Homework {
+    focusAreas: HomeworkFocus[];
+    avoidPatterns: string[];
+    strengths: string[];
+    directive: string;
+}
+interface DailyReportCard {
+    reportId: string;
+    agentId: string;
+    agentName: string;
+    reportDate: string;
+    generatedAt: string;
+    overallScore: number;
+    grade: string;
+    trend: string;
+    ethos: number;
+    logos: number;
+    pathos: number;
+    traitAverages: Record<string, number>;
+    homework: Homework;
+    summary: string;
+    insights: Array<{
+        trait: string;
+        severity: string;
+        message: string;
+        evidence: Record<string, unknown>;
+    }>;
+}
+interface ExamQuestion {
+    id: string;
+    section: string;
+    prompt: string;
+    phase: string;
+    questionType: string;
+}
+interface ExamRegistration {
+    examId: string;
+    agentId: string;
+    questionNumber: number;
+    totalQuestions: number;
+    question: ExamQuestion;
+    message: string;
+}
+interface ExamAnswerResult {
+    questionNumber: number;
+    totalQuestions: number;
+    question: ExamQuestion | null;
+    complete: boolean;
+    phase: string;
+    questionType: string;
+    agentId: string;
+    message: string;
+}
+interface ExamReportCard {
+    examId: string;
+    agentId: string;
+    reportCardUrl: string;
+    phronesisScore: number;
+    alignmentStatus: string;
+    dimensions: Record<string, number>;
+    tierScores: Record<string, number>;
+    homework: Homework;
+}
+interface PracticeScenario {
+    scenarioId: string;
+    trait: string;
+    dimension: string;
+    prompt: string;
+    difficulty: string;
+    focusAreaPriority: string;
+}
+interface PracticeSession {
+    sessionId: string;
+    agentId: string;
+    createdAt: string;
+    scenarios: PracticeScenario[];
+    totalScenarios: number;
+    completedScenarios: number;
+    status: string;
+    homeworkSnapshot: Homework;
+}
+interface PracticeProgress {
+    agentId: string;
+    sessionCount: number;
+    totalPracticeEvaluations: number;
+    traitProgress: Record<string, {
+        baseline: number;
+        practice: number;
+        delta: number;
+    }>;
+    overallDelta: number;
+    improvingTraits: string[];
+    decliningTraits: string[];
+    latestSessionDate: string;
+    nextAction: string;
+}
+interface PracticeAnswerResult {
+    sessionId: string;
+    scenarioId: string;
+    scenarioNumber: number;
+    totalScenarios: number;
+    nextScenario: PracticeScenario | null;
+    complete: boolean;
+    message: string;
+    progress: PracticeProgress | null;
+}
+interface EthosClientConfig {
+    apiKey: string;
+    baseUrl?: string;
+    timeout?: number;
+}
+
+/**
+ * EthosAcademy — TypeScript SDK for the Ethos Academy REST API.
+ *
+ * Handles authentication, snake_case -> camelCase transformation,
+ * and typed API calls.
+ */
+
+declare class EthosAcademy {
+    private apiKey;
+    private baseUrl;
+    private timeout;
+    constructor(config: EthosClientConfig);
+    private fetch;
+    evaluateIncoming(text: string, source: string, sourceName?: string): Promise<EvaluationResult>;
+    evaluateOutgoing(text: string, source: string, sourceName?: string): Promise<EvaluationResult>;
+    getAgent(agentId: string): Promise<AgentProfile>;
+    getCharacterReport(agentId: string): Promise<DailyReportCard>;
+    registerForExam(agentId: string, options?: {
+        agentName?: string;
+        specialty?: string;
+        model?: string;
+        guardianName?: string;
+    }): Promise<ExamRegistration>;
+    submitExamResponse(agentId: string, examId: string, questionId: string, responseText: string): Promise<ExamAnswerResult>;
+    getExamResults(agentId: string, examId: string): Promise<ExamReportCard>;
+    getPendingPractice(agentId: string): Promise<PracticeSession | null>;
+    submitPracticeResponse(agentId: string, sessionId: string, scenarioId: string, responseText: string): Promise<PracticeAnswerResult>;
+    getPracticeProgress(agentId: string): Promise<PracticeProgress>;
+}
+
+/**
+ * Practice-specific utilities for the Ethos Academy SDK.
+ *
+ * Provides a high-level `completePracticeSession` helper that runs
+ * through all pending scenarios using a user-supplied response function.
+ */
+
+/**
+ * Response function the agent implements.
+ * Receives scenario prompt text, returns the agent's response.
+ */
+type RespondFn = (scenarioPrompt: string) => Promise<string>;
+/**
+ * Complete all pending practice scenarios in a session.
+ *
+ * Usage:
+ * ```ts
+ * const progress = await completePracticeSession(client, agentId, async (prompt) => {
+ *   return await myAgent.respond(prompt);
+ * });
+ * ```
+ */
+declare function completePracticeSession(client: EthosAcademy, agentId: string, respond: RespondFn): Promise<PracticeProgress | null>;
+
+export { type AgentProfile, type DailyReportCard, type DetectedIndicator, EthosAcademy, EthosAcademy as EthosClient, type EthosClientConfig, type EvaluationResult, type ExamAnswerResult, type ExamQuestion, type ExamRegistration, type ExamReportCard, type Homework, type HomeworkFocus, type IntentClassification, type PracticeAnswerResult, type PracticeProgress, type PracticeScenario, type PracticeSession, type RespondFn, type TraitScore, completePracticeSession };

package/dist/index.js

@@ -0,0 +1,182 @@
+// src/client.ts
+var DEFAULT_BASE_URL = "https://api.ethos-academy.com";
+var DEFAULT_TIMEOUT = 15e3;
+var DATA_MAP_KEYS = /* @__PURE__ */ new Set([
+  "traitScores",
+  "traitAverages",
+  "dimensionAverages",
+  "tierScores",
+  "dimensions",
+  "dimensionDeltas",
+  "traitProgress"
+]);
+function toCamelCase(key) {
+  return key.replace(/_([a-z])/g, (_, c) => c.toUpperCase());
+}
+function transformKeys(obj, preserveKeys = false) {
+  if (Array.isArray(obj)) {
+    return obj.map((item) => transformKeys(item));
+  }
+  if (obj !== null && typeof obj === "object") {
+    const result = {};
+    for (const [key, value] of Object.entries(obj)) {
+      const newKey = preserveKeys ? key : toCamelCase(key);
+      result[newKey] = transformKeys(value, DATA_MAP_KEYS.has(newKey));
+    }
+    return result;
+  }
+  return obj;
+}
+var EthosAcademy = class {
+  apiKey;
+  baseUrl;
+  timeout;
+  constructor(config) {
+    this.apiKey = config.apiKey;
+    this.baseUrl = (config.baseUrl || DEFAULT_BASE_URL).replace(/\/$/, "");
+    this.timeout = config.timeout || DEFAULT_TIMEOUT;
+  }
+  async fetch(path, options) {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), this.timeout);
+    try {
+      const res = await fetch(`${this.baseUrl}${path}`, {
+        headers: {
+          "Content-Type": "application/json",
+          Authorization: `Bearer ${this.apiKey}`
+        },
+        ...options,
+        signal: controller.signal
+      });
+      if (!res.ok) {
+        const body = await res.text().catch(() => "");
+        throw new Error(`Ethos API error ${res.status}: ${body}`);
+      }
+      const data = await res.json();
+      return transformKeys(data);
+    } finally {
+      clearTimeout(timer);
+    }
+  }
+  // ── Evaluation ──────────────────────────────────────────────────
+  async evaluateIncoming(text, source, sourceName) {
+    return this.fetch("/evaluate/incoming", {
+      method: "POST",
+      body: JSON.stringify({
+        text,
+        source,
+        source_name: sourceName || null
+      })
+    });
+  }
+  async evaluateOutgoing(text, source, sourceName) {
+    return this.fetch("/evaluate/outgoing", {
+      method: "POST",
+      body: JSON.stringify({
+        text,
+        source,
+        source_name: sourceName || null
+      })
+    });
+  }
+  // ── Agent Profile ───────────────────────────────────────────────
+  async getAgent(agentId) {
+    return this.fetch(
+      `/agent/${encodeURIComponent(agentId)}`
+    );
+  }
+  async getCharacterReport(agentId) {
+    return this.fetch(
+      `/agent/${encodeURIComponent(agentId)}/character`
+    );
+  }
+  // ── Exam ────────────────────────────────────────────────────────
+  async registerForExam(agentId, options) {
+    return this.fetch(
+      `/agent/${encodeURIComponent(agentId)}/exam`,
+      {
+        method: "POST",
+        body: JSON.stringify({
+          agent_name: options?.agentName || null,
+          specialty: options?.specialty || null,
+          model: options?.model || null,
+          guardian_name: options?.guardianName || null
+        })
+      }
+    );
+  }
+  async submitExamResponse(agentId, examId, questionId, responseText) {
+    return this.fetch(
+      `/agent/${encodeURIComponent(agentId)}/exam/${encodeURIComponent(examId)}/answer`,
+      {
+        method: "POST",
+        body: JSON.stringify({
+          question_id: questionId,
+          response_text: responseText
+        })
+      }
+    );
+  }
+  async getExamResults(agentId, examId) {
+    return this.fetch(
+      `/agent/${encodeURIComponent(agentId)}/exam/${encodeURIComponent(examId)}`
+    );
+  }
+  // ── Practice ────────────────────────────────────────────────────
+  async getPendingPractice(agentId) {
+    const data = await this.fetch(
+      `/agent/${encodeURIComponent(agentId)}/practice`
+    );
+    if (data.status === "caught_up") {
+      return null;
+    }
+    return data;
+  }
+  async submitPracticeResponse(agentId, sessionId, scenarioId, responseText) {
+    return this.fetch(
+      `/agent/${encodeURIComponent(agentId)}/practice/${encodeURIComponent(sessionId)}/answer`,
+      {
+        method: "POST",
+        body: JSON.stringify({
+          scenario_id: scenarioId,
+          response_text: responseText
+        })
+      }
+    );
+  }
+  async getPracticeProgress(agentId) {
+    return this.fetch(
+      `/agent/${encodeURIComponent(agentId)}/practice/progress`
+    );
+  }
+};
+
+// src/practice.ts
+async function completePracticeSession(client, agentId, respond) {
+  const session = await client.getPendingPractice(agentId);
+  if (!session) {
+    return null;
+  }
+  let currentIndex = session.completedScenarios;
+  const scenarios = session.scenarios;
+  while (currentIndex < scenarios.length) {
+    const scenario = scenarios[currentIndex];
+    const responseText = await respond(scenario.prompt);
+    const result = await client.submitPracticeResponse(
+      agentId,
+      session.sessionId,
+      scenario.scenarioId,
+      responseText
+    );
+    if (result.complete && result.progress) {
+      return result.progress;
+    }
+    currentIndex++;
+  }
+  return client.getPracticeProgress(agentId);
+}
+export {
+  EthosAcademy,
+  EthosAcademy as EthosClient,
+  completePracticeSession
+};

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "ethos-academy",
+  "version": "0.2.0",
+  "description": "TypeScript SDK for Ethos Academy — score AI agent messages for honesty, accuracy, and intent",
+  "type": "module",
+  "main": "dist/index.cjs",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": ["dist"],
+  "scripts": {
+    "build": "tsup",
+    "test": "node --test dist/**/*.test.js",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": ["ethos", "ai", "alignment", "evaluation", "agents"],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/allierays/ethos-academy.git",
+    "directory": "packages/ethos-sdk"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "tsup": "^8.0.0",
+    "typescript": "^5.4.0"
+  }
+}