@aumos/agent-sense 0.1.0

package/dist/client.d.ts

@@ -0,0 +1,118 @@
+/**
+ * HTTP client for the agent-sense transparency API.
+ *
+ * Uses the Fetch API (available natively in Node 18+, browsers, and Deno).
+ * No external dependencies required.
+ *
+ * @example
+ * ```ts
+ * import { createAgentSenseClient } from "@aumos/agent-sense";
+ *
+ * const client = createAgentSenseClient({ baseUrl: "http://localhost:8091" });
+ *
+ * const intent = await client.parseIntent({
+ *   utterance: "Show me my account balance",
+ *   session_id: "sess-001",
+ * });
+ *
+ * if (intent.ok) {
+ *   console.log("Parsed intent:", intent.data.intent);
+ * }
+ * ```
+ */
+import type { AccessibilityCheckResult, AccessibilityConfig, ApiResult, DetectedContext, DialogueState, FeedbackEntry, FeedbackSubmitRequest, FeedbackSummary, ResponseCandidate, TransparencyIndicator, UserIntent } from "./types.js";
+/** Configuration options for the AgentSenseClient. */
+export interface AgentSenseClientConfig {
+    /** Base URL of the agent-sense server (e.g. "http://localhost:8091"). */
+    readonly baseUrl: string;
+    /** Optional request timeout in milliseconds (default: 30000). */
+    readonly timeoutMs?: number;
+    /** Optional extra HTTP headers sent with every request. */
+    readonly headers?: Readonly<Record<string, string>>;
+}
+/** Typed HTTP client for the agent-sense server. */
+export interface AgentSenseClient {
+    /**
+     * Parse the intent from a user utterance.
+     *
+     * @param options - Utterance and optional session context.
+     * @returns A UserIntent record with intent label, confidence, and entities.
+     */
+    parseIntent(options: {
+        utterance: string;
+        session_id?: string;
+        context?: Readonly<Record<string, unknown>>;
+    }): Promise<ApiResult<UserIntent>>;
+    /**
+     * Rank a list of response candidates for the given context.
+     *
+     * @param options - Candidates, user text, and optional history.
+     * @returns The candidates re-ordered by composite score.
+     */
+    rankResponses(options: {
+        candidates: readonly {
+            candidate_id: string;
+            text: string;
+            relevance_score: number;
+        }[];
+        user_text: string;
+        history?: readonly string[];
+        recent_shown?: readonly string[];
+    }): Promise<ApiResult<readonly ResponseCandidate[]>>;
+    /**
+     * Submit structured feedback for an agent interaction.
+     *
+     * @param request - Feedback submission payload.
+     * @returns The stored FeedbackEntry record.
+     */
+    collectFeedback(request: FeedbackSubmitRequest): Promise<ApiResult<FeedbackEntry>>;
+    /**
+     * Retrieve the current dialogue state for a session.
+     *
+     * @param sessionId - The session identifier.
+     * @returns The DialogueState record for this session.
+     */
+    getDialogueState(sessionId: string): Promise<ApiResult<DialogueState>>;
+    /**
+     * Check HTML content for WCAG 2.1 accessibility violations.
+     *
+     * @param config - Accessibility check configuration including HTML markup.
+     * @returns The check result with any violations found.
+     */
+    checkAccessibility(config: AccessibilityConfig): Promise<ApiResult<AccessibilityCheckResult>>;
+    /**
+     * Get the transparency indicator (confidence + disclosure) for an agent.
+     *
+     * @param options - Agent ID and optional session context.
+     * @returns A TransparencyIndicator combining confidence and disclosure.
+     */
+    getTransparencyIndicator(options: {
+        agent_id: string;
+        session_id?: string;
+    }): Promise<ApiResult<TransparencyIndicator>>;
+    /**
+     * Detect the client context from a User-Agent string and HTTP headers.
+     *
+     * @param options - User-Agent string and optional HTTP hint headers.
+     * @returns A DetectedContext with device type, network quality, and capabilities.
+     */
+    detectContext(options: {
+        user_agent: string;
+        headers?: Readonly<Record<string, string>>;
+    }): Promise<ApiResult<DetectedContext>>;
+    /**
+     * Get aggregated feedback summary for an agent.
+     *
+     * @param agentId - The agent identifier.
+     * @returns A FeedbackSummary with satisfaction score and category breakdown.
+     */
+    getFeedbackSummary(agentId: string): Promise<ApiResult<FeedbackSummary>>;
+}
+/**
+ * Create a typed HTTP client for the agent-sense server.
+ *
+ * @param config - Client configuration including base URL.
+ * @returns An AgentSenseClient instance.
+ */
+export declare function createAgentSenseClient(config: AgentSenseClientConfig): AgentSenseClient;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EACV,wBAAwB,EACxB,mBAAmB,EAEnB,SAAS,EACT,eAAe,EACf,aAAa,EACb,aAAa,EACb,qBAAqB,EACrB,eAAe,EACf,iBAAiB,EACjB,qBAAqB,EACrB,UAAU,EACX,MAAM,YAAY,CAAC;AAMpB,sDAAsD;AACtD,MAAM,WAAW,sBAAsB;IACrC,yEAAyE;IACzE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,iEAAiE;IACjE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,2DAA2D;IAC3D,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACrD;AA0DD,oDAAoD;AACpD,MAAM,WAAW,gBAAgB;IAC/B;;;;;OAKG;IACH,WAAW,CAAC,OAAO,EAAE;QACnB,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;KAC7C,GAAG,OAAO,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC;IAEnC;;;;;OAKG;IACH,aAAa,CAAC,OAAO,EAAE;QACrB,UAAU,EAAE,SAAS;YAAE,YAAY,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAC;YAAC,eAAe,EAAE,MAAM,CAAA;SAAE,EAAE,CAAC;QACvF,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;QAC5B,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;KAClC,GAAG,OAAO,CAAC,SAAS,CAAC,SAAS,iBAAiB,EAAE,CAAC,CAAC,CAAC;IAErD;;;;;OAKG;IACH,eAAe,CACb,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,CAAC;IAErC;;;;;OAKG;IACH,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,CAAC;IAEvE;;;;;OAKG;IACH,kBAAkB,CAChB,MAAM,EAAE,mBAAmB,GAC1B,OAAO,CAAC,SAAS,CAAC,wBAAwB,CAAC,CAAC,CAAC;IAEhD;;;;;OAKG;IACH,wBAAwB,CAAC,OAAO,EAAE;QAChC,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,GAAG,OAAO,CAAC,SAAS,CAAC,qBAAqB,CAAC,CAAC,CAAC;IAE9C;;;;;OAKG;IACH,aAAa,CAAC,OAAO,EAAE;QACrB,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;KAC5C,GAAG,OAAO,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC,CAAC;IAExC;;;;;OAKG;IACH,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC,CAAC;CAC1E;AAMD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,sBAAsB,GAC7B,gBAAgB,CAiHlB"}

package/dist/client.js

@@ -0,0 +1,127 @@
+/**
+ * HTTP client for the agent-sense transparency API.
+ *
+ * Uses the Fetch API (available natively in Node 18+, browsers, and Deno).
+ * No external dependencies required.
+ *
+ * @example
+ * ```ts
+ * import { createAgentSenseClient } from "@aumos/agent-sense";
+ *
+ * const client = createAgentSenseClient({ baseUrl: "http://localhost:8091" });
+ *
+ * const intent = await client.parseIntent({
+ *   utterance: "Show me my account balance",
+ *   session_id: "sess-001",
+ * });
+ *
+ * if (intent.ok) {
+ *   console.log("Parsed intent:", intent.data.intent);
+ * }
+ * ```
+ */
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+async function fetchJson(url, init, timeoutMs) {
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), timeoutMs);
+    try {
+        const response = await fetch(url, { ...init, signal: controller.signal });
+        clearTimeout(timeoutId);
+        const body = await response.json();
+        if (!response.ok) {
+            const errorBody = body;
+            return {
+                ok: false,
+                error: {
+                    error: errorBody.error ?? "Unknown error",
+                    detail: errorBody.detail ?? "",
+                },
+                status: response.status,
+            };
+        }
+        return { ok: true, data: body };
+    }
+    catch (err) {
+        clearTimeout(timeoutId);
+        const message = err instanceof Error ? err.message : String(err);
+        return {
+            ok: false,
+            error: { error: "Network error", detail: message },
+            status: 0,
+        };
+    }
+}
+function buildHeaders(extraHeaders) {
+    return {
+        "Content-Type": "application/json",
+        Accept: "application/json",
+        ...extraHeaders,
+    };
+}
+// ---------------------------------------------------------------------------
+// Client factory
+// ---------------------------------------------------------------------------
+/**
+ * Create a typed HTTP client for the agent-sense server.
+ *
+ * @param config - Client configuration including base URL.
+ * @returns An AgentSenseClient instance.
+ */
+export function createAgentSenseClient(config) {
+    const { baseUrl, timeoutMs = 30_000, headers: extraHeaders } = config;
+    const baseHeaders = buildHeaders(extraHeaders);
+    return {
+        async parseIntent(options) {
+            return fetchJson(`${baseUrl}/sense/intent`, {
+                method: "POST",
+                headers: baseHeaders,
+                body: JSON.stringify(options),
+            }, timeoutMs);
+        },
+        async rankResponses(options) {
+            return fetchJson(`${baseUrl}/sense/rank`, {
+                method: "POST",
+                headers: baseHeaders,
+                body: JSON.stringify(options),
+            }, timeoutMs);
+        },
+        async collectFeedback(request) {
+            return fetchJson(`${baseUrl}/sense/feedback`, {
+                method: "POST",
+                headers: baseHeaders,
+                body: JSON.stringify(request),
+            }, timeoutMs);
+        },
+        async getDialogueState(sessionId) {
+            return fetchJson(`${baseUrl}/sense/sessions/${encodeURIComponent(sessionId)}/state`, { method: "GET", headers: baseHeaders }, timeoutMs);
+        },
+        async checkAccessibility(config) {
+            return fetchJson(`${baseUrl}/sense/accessibility/check`, {
+                method: "POST",
+                headers: baseHeaders,
+                body: JSON.stringify(config),
+            }, timeoutMs);
+        },
+        async getTransparencyIndicator(options) {
+            const params = new URLSearchParams();
+            params.set("agent_id", options.agent_id);
+            if (options.session_id !== undefined) {
+                params.set("session_id", options.session_id);
+            }
+            return fetchJson(`${baseUrl}/sense/transparency?${params.toString()}`, { method: "GET", headers: baseHeaders }, timeoutMs);
+        },
+        async detectContext(options) {
+            return fetchJson(`${baseUrl}/sense/context/detect`, {
+                method: "POST",
+                headers: baseHeaders,
+                body: JSON.stringify(options),
+            }, timeoutMs);
+        },
+        async getFeedbackSummary(agentId) {
+            return fetchJson(`${baseUrl}/sense/feedback/${encodeURIComponent(agentId)}/summary`, { method: "GET", headers: baseHeaders }, timeoutMs);
+        },
+    };
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @aumos/agent-sense
+ *
+ * TypeScript client for the AumOS agent-sense transparency layer.
+ * Provides HTTP client, intent parsing, response ranking, feedback collection,
+ * accessibility checking, and confidence/disclosure type definitions.
+ */
+export type { AgentSenseClient, AgentSenseClientConfig } from "./client.js";
+export { createAgentSenseClient } from "./client.js";
+export type { AccessibilityCheckResult, AccessibilityConfig, AIDisclosureCard, ApiError, ApiResult, BrowserCapabilities, ConfidenceIndicator, ConfidenceLevel, DetectedContext, DeviceType, DialogueState, DisclosureLevel, FeedbackCategory, FeedbackEntry, FeedbackSubmitRequest, FeedbackSummary, NetworkQuality, ResponseCandidate, TransparencyIndicator, UserIntent, WCAGLevel, WCAGViolation, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,YAAY,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAC5E,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAGrD,YAAY,EACV,wBAAwB,EACxB,mBAAmB,EACnB,gBAAgB,EAChB,QAAQ,EACR,SAAS,EACT,mBAAmB,EACnB,mBAAmB,EACnB,eAAe,EACf,eAAe,EACf,UAAU,EACV,aAAa,EACb,eAAe,EACf,gBAAgB,EAChB,aAAa,EACb,qBAAqB,EACrB,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,qBAAqB,EACrB,UAAU,EACV,SAAS,EACT,aAAa,GACd,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,9 @@
+/**
+ * @aumos/agent-sense
+ *
+ * TypeScript client for the AumOS agent-sense transparency layer.
+ * Provides HTTP client, intent parsing, response ranking, feedback collection,
+ * accessibility checking, and confidence/disclosure type definitions.
+ */
+export { createAgentSenseClient } from "./client.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,258 @@
+/**
+ * TypeScript interfaces for the agent-sense transparency layer.
+ *
+ * Mirrors the Python dataclasses and Pydantic models defined in:
+ *   agent_sense.indicators.confidence   (ConfidenceLevel, ConfidenceIndicator)
+ *   agent_sense.indicators.disclosure   (DisclosureLevel, AIDisclosureCard)
+ *   agent_sense.feedback.collector      (FeedbackCategory, FeedbackEntry, FeedbackSummary)
+ *   agent_sense.context.detector        (DeviceType, NetworkQuality, BrowserCapabilities, DetectedContext)
+ *   agent_sense.accessibility.wcag      (WCAGLevel, WCAGViolation)
+ *   agent_sense.disclosure.transparency (SessionStats)
+ *
+ * All interfaces use readonly fields to match Python frozen dataclasses.
+ */
+/**
+ * Five-tier categorical confidence classification.
+ * Maps to ConfidenceLevel enum in Python.
+ * Score bands: very_low [0,0.2), low [0.2,0.4), medium [0.4,0.6),
+ *              high [0.6,0.8), very_high [0.8,1.0].
+ */
+export type ConfidenceLevel = "very_low" | "low" | "medium" | "high" | "very_high";
+/** Structured confidence measurement for an AI agent response. */
+export interface ConfidenceIndicator {
+    /** Raw numeric confidence in [0.0, 1.0]. */
+    readonly score: number;
+    /** Categorical tier derived from score. */
+    readonly level: ConfidenceLevel;
+    /** Human-readable explanation of the confidence assessment. */
+    readonly reasoning: string;
+    /** Map of contributing factor names to their individual scores [0, 1]. */
+    readonly factors: Readonly<Record<string, number>>;
+}
+/**
+ * Controls the verbosity of disclosure card rendering.
+ * Maps to DisclosureLevel enum in Python.
+ */
+export type DisclosureLevel = "minimal" | "standard" | "detailed" | "full";
+/** Immutable disclosure card for an AI agent deployment. */
+export interface AIDisclosureCard {
+    /** Human-readable name of the agent. */
+    readonly agent_name: string;
+    /** Semantic version or build identifier. */
+    readonly agent_version: string;
+    /** Organisation that produced the underlying model. */
+    readonly model_provider: string;
+    /** Identifier of the specific model being used. */
+    readonly model_name: string;
+    /** Ordered list of things this agent can do well. */
+    readonly capabilities: readonly string[];
+    /** Ordered list of known constraints or failure modes. */
+    readonly limitations: readonly string[];
+    /** Plain-language description of how conversation data is handled. */
+    readonly data_handling: string;
+    /** ISO-8601 UTC datetime at which this card was last revised. */
+    readonly last_updated: string;
+    /** Verbosity level used when rendering this card. */
+    readonly disclosure_level: DisclosureLevel;
+}
+/** Full transparency indicator combining confidence and disclosure. */
+export interface TransparencyIndicator {
+    /** The confidence measurement for a response. */
+    readonly confidence: ConfidenceIndicator;
+    /** The AI disclosure card for this deployment. */
+    readonly disclosure: AIDisclosureCard;
+    /** ISO-8601 UTC timestamp when this indicator was generated. */
+    readonly generated_at: string;
+}
+/**
+ * Category labels for user feedback.
+ * Maps to FeedbackCategory enum in Python.
+ */
+export type FeedbackCategory = "helpful" | "unhelpful" | "harmful" | "irrelevant" | "inaccurate" | "too_long" | "too_short" | "other";
+/** A single structured feedback submission from a user. */
+export interface FeedbackEntry {
+    /** Unique identifier for this feedback entry. */
+    readonly feedback_id: string;
+    /** Satisfaction rating from 1 (very poor) to 5 (excellent). */
+    readonly rating: number;
+    /** Structured category label for quick classification. */
+    readonly category: FeedbackCategory;
+    /** The agent that produced the response being rated. */
+    readonly agent_id: string;
+    /** Optional session identifier for grouping feedback. */
+    readonly session_id: string;
+    /** Optional identifier for the specific interaction being rated. */
+    readonly interaction_id: string;
+    /** Optional free-form user comment. */
+    readonly free_text: string;
+    /** ISO-8601 UTC datetime when feedback was submitted. */
+    readonly submitted_at: string;
+    /** Whether this is positive feedback (rating >= 4 or category = helpful). */
+    readonly is_positive: boolean;
+    /** Whether this is negative feedback (rating <= 2 or category = harmful/unhelpful). */
+    readonly is_negative: boolean;
+    /** Arbitrary additional key-value metadata. */
+    readonly metadata: Readonly<Record<string, string>>;
+}
+/** Request payload for submitting feedback. */
+export interface FeedbackSubmitRequest {
+    /** Satisfaction rating from 1 to 5. */
+    readonly rating: number;
+    /** Structured category label. */
+    readonly category: FeedbackCategory;
+    /** The agent being rated. */
+    readonly agent_id: string;
+    /** Optional session identifier. */
+    readonly session_id?: string;
+    /** Optional interaction identifier. */
+    readonly interaction_id?: string;
+    /** Optional free-form comment. */
+    readonly free_text?: string;
+    /** Optional additional metadata. */
+    readonly metadata?: Readonly<Record<string, string>>;
+}
+/** Aggregated feedback statistics for an agent. */
+export interface FeedbackSummary {
+    /** The agent this summary covers. */
+    readonly agent_id: string;
+    /** Total number of feedback entries processed. */
+    readonly total_feedback: number;
+    /** Mean rating across all entries (1–5). */
+    readonly average_rating: number;
+    /** Normalised satisfaction score in [0, 1]. */
+    readonly satisfaction_score: number;
+    /** Count of feedback entries per category. */
+    readonly category_distribution: Readonly<Record<string, number>>;
+    /** Number of positive feedback entries. */
+    readonly positive_count: number;
+    /** Number of negative feedback entries. */
+    readonly negative_count: number;
+    /** Number of neutral feedback entries (rating = 3). */
+    readonly neutral_count: number;
+    /** Most frequent words from free-text comments. */
+    readonly top_free_text_keywords: readonly string[];
+    /** ISO-8601 UTC datetime when this summary was computed. */
+    readonly computed_at: string;
+}
+/**
+ * Canonical device categories.
+ * Maps to DeviceType enum in Python.
+ */
+export type DeviceType = "desktop" | "mobile" | "tablet" | "voice" | "unknown";
+/**
+ * Inferred network quality tiers.
+ * Maps to NetworkQuality enum in Python.
+ */
+export type NetworkQuality = "high" | "medium" | "low" | "unknown";
+/** Feature flags inferred from User-Agent and hints headers. */
+export interface BrowserCapabilities {
+    readonly javascript_enabled: boolean;
+    readonly webgl_supported: boolean;
+    readonly touch_supported: boolean;
+    readonly screen_reader_likely: boolean;
+    readonly reduced_motion_preferred: boolean;
+}
+/** Full result of a context detection call. */
+export interface DetectedContext {
+    readonly device_type: DeviceType;
+    readonly network_quality: NetworkQuality;
+    readonly browser_capabilities: BrowserCapabilities;
+    readonly user_agent: string;
+    readonly raw_headers: Readonly<Record<string, string>>;
+}
+/** Intent parsed from a user utterance. */
+export interface UserIntent {
+    /** The raw user utterance. */
+    readonly utterance: string;
+    /** Primary intent label (e.g. "question", "command", "clarification"). */
+    readonly intent: string;
+    /** Confidence score for this intent classification in [0, 1]. */
+    readonly confidence: number;
+    /** Extracted named entities. */
+    readonly entities: Readonly<Record<string, string>>;
+    /** ISO-8601 UTC timestamp when this intent was parsed. */
+    readonly parsed_at: string;
+}
+/** Ranked response candidate with score. */
+export interface ResponseCandidate {
+    /** Unique identifier for this candidate. */
+    readonly candidate_id: string;
+    /** The response text. */
+    readonly text: string;
+    /** Composite ranking score in [0, 1] (higher = preferred). */
+    readonly score: number;
+    /** Context match contribution to the score. */
+    readonly context_match_score: number;
+    /** Relevance contribution to the score. */
+    readonly relevance_score: number;
+}
+/** Current state of a dialogue session. */
+export interface DialogueState {
+    /** Unique session identifier. */
+    readonly session_id: string;
+    /** Current turn number (1-indexed). */
+    readonly turn_number: number;
+    /** Detected context for this session. */
+    readonly detected_context: DetectedContext;
+    /** Current confidence level for the session. */
+    readonly confidence_level: ConfidenceLevel;
+    /** ISO-8601 UTC timestamp of the last activity. */
+    readonly last_activity_at: string;
+    /** Whether a human handoff has been triggered. */
+    readonly handoff_triggered: boolean;
+}
+/**
+ * WCAG 2.1 conformance level.
+ * Maps to WCAGLevel enum in Python.
+ */
+export type WCAGLevel = "A" | "AA" | "AAA";
+/** A single WCAG 2.1 violation found in inspected content. */
+export interface WCAGViolation {
+    /** WCAG success criterion number (e.g. "1.1.1"). */
+    readonly criterion: string;
+    /** Conformance level of the criterion. */
+    readonly level: WCAGLevel;
+    /** Human-readable description of the violation. */
+    readonly description: string;
+    /** Short snippet of the problematic markup or text. */
+    readonly element_snippet: string;
+    /** Recommended remediation for the violation. */
+    readonly suggestion: string;
+}
+/** Result of an accessibility check. */
+export interface AccessibilityCheckResult {
+    /** Whether the content passed all WCAG checks. */
+    readonly passed: boolean;
+    /** List of WCAG violations found. */
+    readonly violations: readonly WCAGViolation[];
+    /** Per-criterion violation counts. */
+    readonly violation_counts: Readonly<Record<string, number>>;
+}
+/** Configuration for an accessibility check request. */
+export interface AccessibilityConfig {
+    /** HTML markup or text content to check. */
+    readonly html: string;
+    /** Whether to check color contrast. */
+    readonly check_color_contrast?: boolean;
+    /** Whether to check text alternatives for images. */
+    readonly check_text_alternatives?: boolean;
+    /** Whether to check heading hierarchy. */
+    readonly check_heading_hierarchy?: boolean;
+    /** Whether to check link text descriptiveness. */
+    readonly check_link_text?: boolean;
+}
+/** Standard error payload returned by the agent-sense API. */
+export interface ApiError {
+    readonly error: string;
+    readonly detail: string;
+}
+/** Result type for all client operations. */
+export type ApiResult<T> = {
+    readonly ok: true;
+    readonly data: T;
+} | {
+    readonly ok: false;
+    readonly error: ApiError;
+    readonly status: number;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAMH;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GACvB,UAAU,GACV,KAAK,GACL,QAAQ,GACR,MAAM,GACN,WAAW,CAAC;AAEhB,kEAAkE;AAClE,MAAM,WAAW,mBAAmB;IAClC,4CAA4C;IAC5C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,2CAA2C;IAC3C,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC;IAChC,+DAA+D;IAC/D,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,0EAA0E;IAC1E,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACpD;AAMD;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,UAAU,GAAG,UAAU,GAAG,MAAM,CAAC;AAE3E,4DAA4D;AAC5D,MAAM,WAAW,gBAAgB;IAC/B,wCAAwC;IACxC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,4CAA4C;IAC5C,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,uDAAuD;IACvD,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,mDAAmD;IACnD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,qDAAqD;IACrD,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,0DAA0D;IAC1D,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,sEAAsE;IACtE,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,iEAAiE;IACjE,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,qDAAqD;IACrD,QAAQ,CAAC,gBAAgB,EAAE,eAAe,CAAC;CAC5C;AAMD,uEAAuE;AACvE,MAAM,WAAW,qBAAqB;IACpC,iDAAiD;IACjD,QAAQ,CAAC,UAAU,EAAE,mBAAmB,CAAC;IACzC,kDAAkD;IAClD,QAAQ,CAAC,UAAU,EAAE,gBAAgB,CAAC;IACtC,gEAAgE;IAChE,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAMD;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GACxB,SAAS,GACT,WAAW,GACX,SAAS,GACT,YAAY,GACZ,YAAY,GACZ,UAAU,GACV,WAAW,GACX,OAAO,CAAC;AAEZ,2DAA2D;AAC3D,MAAM,WAAW,aAAa;IAC5B,iDAAiD;IACjD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,+DAA+D;IAC/D,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,0DAA0D;IAC1D,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IACpC,wDAAwD;IACxD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,yDAAyD;IACzD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,oEAAoE;IACpE,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,uCAAuC;IACvC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,yDAAyD;IACzD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,6EAA6E;IAC7E,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,uFAAuF;IACvF,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,+CAA+C;IAC/C,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACrD;AAED,+CAA+C;AAC/C,MAAM,WAAW,qBAAqB;IACpC,uCAAuC;IACvC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,iCAAiC;IACjC,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IACpC,6BAA6B;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,mCAAmC;IACnC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,uCAAuC;IACvC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,kCAAkC;IAClC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,oCAAoC;IACpC,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACtD;AAED,mDAAmD;AACnD,MAAM,WAAW,eAAe;IAC9B,qCAAqC;IACrC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,kDAAkD;IAClD,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,4CAA4C;IAC5C,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,+CAA+C;IAC/C,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,8CAA8C;IAC9C,QAAQ,CAAC,qBAAqB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACjE,2CAA2C;IAC3C,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,2CAA2C;IAC3C,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,uDAAuD;IACvD,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,mDAAmD;IACnD,QAAQ,CAAC,sBAAsB,EAAE,SAAS,MAAM,EAAE,CAAC;IACnD,4DAA4D;IAC5D,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAMD;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAC;AAE/E;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,GAAG,SAAS,CAAC;AAEnE,gEAAgE;AAChE,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,kBAAkB,EAAE,OAAO,CAAC;IACrC,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;IAClC,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;IAClC,QAAQ,CAAC,oBAAoB,EAAE,OAAO,CAAC;IACvC,QAAQ,CAAC,wBAAwB,EAAE,OAAO,CAAC;CAC5C;AAED,+CAA+C;AAC/C,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,WAAW,EAAE,UAAU,CAAC;IACjC,QAAQ,CAAC,eAAe,EAAE,cAAc,CAAC;IACzC,QAAQ,CAAC,oBAAoB,EAAE,mBAAmB,CAAC;IACnD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACxD;AAED,2CAA2C;AAC3C,MAAM,WAAW,UAAU;IACzB,8BAA8B;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,0EAA0E;IAC1E,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,iEAAiE;IACjE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,gCAAgC;IAChC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACpD,0DAA0D;IAC1D,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,4CAA4C;AAC5C,MAAM,WAAW,iBAAiB;IAChC,4CAA4C;IAC5C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,yBAAyB;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,8DAA8D;IAC9D,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,+CAA+C;IAC/C,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,2CAA2C;IAC3C,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;CAClC;AAED,2CAA2C;AAC3C,MAAM,WAAW,aAAa;IAC5B,iCAAiC;IACjC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,uCAAuC;IACvC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,yCAAyC;IACzC,QAAQ,CAAC,gBAAgB,EAAE,eAAe,CAAC;IAC3C,gDAAgD;IAChD,QAAQ,CAAC,gBAAgB,EAAE,eAAe,CAAC;IAC3C,mDAAmD;IACnD,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,kDAAkD;IAClD,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAC;CACrC;AAMD;;;GAGG;AACH,MAAM,MAAM,SAAS,GAAG,GAAG,GAAG,IAAI,GAAG,KAAK,CAAC;AAE3C,8DAA8D;AAC9D,MAAM,WAAW,aAAa;IAC5B,oDAAoD;IACpD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,0CAA0C;IAC1C,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B,mDAAmD;IACnD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,uDAAuD;IACvD,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,iDAAiD;IACjD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,wCAAwC;AACxC,MAAM,WAAW,wBAAwB;IACvC,kDAAkD;IAClD,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,qCAAqC;IACrC,QAAQ,CAAC,UAAU,EAAE,SAAS,aAAa,EAAE,CAAC;IAC9C,sCAAsC;IACtC,QAAQ,CAAC,gBAAgB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CAC7D;AAED,wDAAwD;AACxD,MAAM,WAAW,mBAAmB;IAClC,4CAA4C;IAC5C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,uCAAuC;IACvC,QAAQ,CAAC,oBAAoB,CAAC,EAAE,OAAO,CAAC;IACxC,qDAAqD;IACrD,QAAQ,CAAC,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAC3C,0CAA0C;IAC1C,QAAQ,CAAC,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAC3C,kDAAkD;IAClD,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAC;CACpC;AAMD,8DAA8D;AAC9D,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,6CAA6C;AAC7C,MAAM,MAAM,SAAS,CAAC,CAAC,IACnB;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAA;CAAE,GACvC;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC"}

package/dist/types.js

@@ -0,0 +1,15 @@
+/**
+ * TypeScript interfaces for the agent-sense transparency layer.
+ *
+ * Mirrors the Python dataclasses and Pydantic models defined in:
+ *   agent_sense.indicators.confidence   (ConfidenceLevel, ConfidenceIndicator)
+ *   agent_sense.indicators.disclosure   (DisclosureLevel, AIDisclosureCard)
+ *   agent_sense.feedback.collector      (FeedbackCategory, FeedbackEntry, FeedbackSummary)
+ *   agent_sense.context.detector        (DeviceType, NetworkQuality, BrowserCapabilities, DetectedContext)
+ *   agent_sense.accessibility.wcag      (WCAGLevel, WCAGViolation)
+ *   agent_sense.disclosure.transparency (SessionStats)
+ *
+ * All interfaces use readonly fields to match Python frozen dataclasses.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG"}

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@aumos/agent-sense",
+  "version": "0.1.0",
+  "description": "TypeScript client for the AumOS agent-sense transparency layer — dialogue context, intent parsing, response ranking, feedback collection, and accessibility",
+  "license": "Apache-2.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit"
+  },
+  "devDependencies": {
+    "typescript": "^5.3.0"
+  },
+  "keywords": [
+    "aumos",
+    "agent-sense",
+    "transparency",
+    "accessibility",
+    "confidence",
+    "intent",
+    "typescript"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/aumos-ai/agent-sense"
+  }
+}

package/src/client.ts

@@ -0,0 +1,321 @@
+/**
+ * HTTP client for the agent-sense transparency API.
+ *
+ * Uses the Fetch API (available natively in Node 18+, browsers, and Deno).
+ * No external dependencies required.
+ *
+ * @example
+ * ```ts
+ * import { createAgentSenseClient } from "@aumos/agent-sense";
+ *
+ * const client = createAgentSenseClient({ baseUrl: "http://localhost:8091" });
+ *
+ * const intent = await client.parseIntent({
+ *   utterance: "Show me my account balance",
+ *   session_id: "sess-001",
+ * });
+ *
+ * if (intent.ok) {
+ *   console.log("Parsed intent:", intent.data.intent);
+ * }
+ * ```
+ */
+
+import type {
+  AccessibilityCheckResult,
+  AccessibilityConfig,
+  ApiError,
+  ApiResult,
+  DetectedContext,
+  DialogueState,
+  FeedbackEntry,
+  FeedbackSubmitRequest,
+  FeedbackSummary,
+  ResponseCandidate,
+  TransparencyIndicator,
+  UserIntent,
+} from "./types.js";
+
+// ---------------------------------------------------------------------------
+// Client configuration
+// ---------------------------------------------------------------------------
+
+/** Configuration options for the AgentSenseClient. */
+export interface AgentSenseClientConfig {
+  /** Base URL of the agent-sense server (e.g. "http://localhost:8091"). */
+  readonly baseUrl: string;
+  /** Optional request timeout in milliseconds (default: 30000). */
+  readonly timeoutMs?: number;
+  /** Optional extra HTTP headers sent with every request. */
+  readonly headers?: Readonly<Record<string, string>>;
+}
+
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+
+async function fetchJson<T>(
+  url: string,
+  init: RequestInit,
+  timeoutMs: number,
+): Promise<ApiResult<T>> {
+  const controller = new AbortController();
+  const timeoutId = setTimeout(() => controller.abort(), timeoutMs);
+
+  try {
+    const response = await fetch(url, { ...init, signal: controller.signal });
+    clearTimeout(timeoutId);
+
+    const body = await response.json() as unknown;
+
+    if (!response.ok) {
+      const errorBody = body as Partial<ApiError>;
+      return {
+        ok: false,
+        error: {
+          error: errorBody.error ?? "Unknown error",
+          detail: errorBody.detail ?? "",
+        },
+        status: response.status,
+      };
+    }
+
+    return { ok: true, data: body as T };
+  } catch (err: unknown) {
+    clearTimeout(timeoutId);
+    const message = err instanceof Error ? err.message : String(err);
+    return {
+      ok: false,
+      error: { error: "Network error", detail: message },
+      status: 0,
+    };
+  }
+}
+
+function buildHeaders(
+  extraHeaders: Readonly<Record<string, string>> | undefined,
+): Record<string, string> {
+  return {
+    "Content-Type": "application/json",
+    Accept: "application/json",
+    ...extraHeaders,
+  };
+}
+
+// ---------------------------------------------------------------------------
+// Client interface
+// ---------------------------------------------------------------------------
+
+/** Typed HTTP client for the agent-sense server. */
+export interface AgentSenseClient {
+  /**
+   * Parse the intent from a user utterance.
+   *
+   * @param options - Utterance and optional session context.
+   * @returns A UserIntent record with intent label, confidence, and entities.
+   */
+  parseIntent(options: {
+    utterance: string;
+    session_id?: string;
+    context?: Readonly<Record<string, unknown>>;
+  }): Promise<ApiResult<UserIntent>>;
+
+  /**
+   * Rank a list of response candidates for the given context.
+   *
+   * @param options - Candidates, user text, and optional history.
+   * @returns The candidates re-ordered by composite score.
+   */
+  rankResponses(options: {
+    candidates: readonly { candidate_id: string; text: string; relevance_score: number }[];
+    user_text: string;
+    history?: readonly string[];
+    recent_shown?: readonly string[];
+  }): Promise<ApiResult<readonly ResponseCandidate[]>>;
+
+  /**
+   * Submit structured feedback for an agent interaction.
+   *
+   * @param request - Feedback submission payload.
+   * @returns The stored FeedbackEntry record.
+   */
+  collectFeedback(
+    request: FeedbackSubmitRequest,
+  ): Promise<ApiResult<FeedbackEntry>>;
+
+  /**
+   * Retrieve the current dialogue state for a session.
+   *
+   * @param sessionId - The session identifier.
+   * @returns The DialogueState record for this session.
+   */
+  getDialogueState(sessionId: string): Promise<ApiResult<DialogueState>>;
+
+  /**
+   * Check HTML content for WCAG 2.1 accessibility violations.
+   *
+   * @param config - Accessibility check configuration including HTML markup.
+   * @returns The check result with any violations found.
+   */
+  checkAccessibility(
+    config: AccessibilityConfig,
+  ): Promise<ApiResult<AccessibilityCheckResult>>;
+
+  /**
+   * Get the transparency indicator (confidence + disclosure) for an agent.
+   *
+   * @param options - Agent ID and optional session context.
+   * @returns A TransparencyIndicator combining confidence and disclosure.
+   */
+  getTransparencyIndicator(options: {
+    agent_id: string;
+    session_id?: string;
+  }): Promise<ApiResult<TransparencyIndicator>>;
+
+  /**
+   * Detect the client context from a User-Agent string and HTTP headers.
+   *
+   * @param options - User-Agent string and optional HTTP hint headers.
+   * @returns A DetectedContext with device type, network quality, and capabilities.
+   */
+  detectContext(options: {
+    user_agent: string;
+    headers?: Readonly<Record<string, string>>;
+  }): Promise<ApiResult<DetectedContext>>;
+
+  /**
+   * Get aggregated feedback summary for an agent.
+   *
+   * @param agentId - The agent identifier.
+   * @returns A FeedbackSummary with satisfaction score and category breakdown.
+   */
+  getFeedbackSummary(agentId: string): Promise<ApiResult<FeedbackSummary>>;
+}
+
+// ---------------------------------------------------------------------------
+// Client factory
+// ---------------------------------------------------------------------------
+
+/**
+ * Create a typed HTTP client for the agent-sense server.
+ *
+ * @param config - Client configuration including base URL.
+ * @returns An AgentSenseClient instance.
+ */
+export function createAgentSenseClient(
+  config: AgentSenseClientConfig,
+): AgentSenseClient {
+  const { baseUrl, timeoutMs = 30_000, headers: extraHeaders } = config;
+  const baseHeaders = buildHeaders(extraHeaders);
+
+  return {
+    async parseIntent(options: {
+      utterance: string;
+      session_id?: string;
+      context?: Readonly<Record<string, unknown>>;
+    }): Promise<ApiResult<UserIntent>> {
+      return fetchJson<UserIntent>(
+        `${baseUrl}/sense/intent`,
+        {
+          method: "POST",
+          headers: baseHeaders,
+          body: JSON.stringify(options),
+        },
+        timeoutMs,
+      );
+    },
+
+    async rankResponses(options: {
+      candidates: readonly { candidate_id: string; text: string; relevance_score: number }[];
+      user_text: string;
+      history?: readonly string[];
+      recent_shown?: readonly string[];
+    }): Promise<ApiResult<readonly ResponseCandidate[]>> {
+      return fetchJson<readonly ResponseCandidate[]>(
+        `${baseUrl}/sense/rank`,
+        {
+          method: "POST",
+          headers: baseHeaders,
+          body: JSON.stringify(options),
+        },
+        timeoutMs,
+      );
+    },
+
+    async collectFeedback(
+      request: FeedbackSubmitRequest,
+    ): Promise<ApiResult<FeedbackEntry>> {
+      return fetchJson<FeedbackEntry>(
+        `${baseUrl}/sense/feedback`,
+        {
+          method: "POST",
+          headers: baseHeaders,
+          body: JSON.stringify(request),
+        },
+        timeoutMs,
+      );
+    },
+
+    async getDialogueState(sessionId: string): Promise<ApiResult<DialogueState>> {
+      return fetchJson<DialogueState>(
+        `${baseUrl}/sense/sessions/${encodeURIComponent(sessionId)}/state`,
+        { method: "GET", headers: baseHeaders },
+        timeoutMs,
+      );
+    },
+
+    async checkAccessibility(
+      config: AccessibilityConfig,
+    ): Promise<ApiResult<AccessibilityCheckResult>> {
+      return fetchJson<AccessibilityCheckResult>(
+        `${baseUrl}/sense/accessibility/check`,
+        {
+          method: "POST",
+          headers: baseHeaders,
+          body: JSON.stringify(config),
+        },
+        timeoutMs,
+      );
+    },
+
+    async getTransparencyIndicator(options: {
+      agent_id: string;
+      session_id?: string;
+    }): Promise<ApiResult<TransparencyIndicator>> {
+      const params = new URLSearchParams();
+      params.set("agent_id", options.agent_id);
+      if (options.session_id !== undefined) {
+        params.set("session_id", options.session_id);
+      }
+      return fetchJson<TransparencyIndicator>(
+        `${baseUrl}/sense/transparency?${params.toString()}`,
+        { method: "GET", headers: baseHeaders },
+        timeoutMs,
+      );
+    },
+
+    async detectContext(options: {
+      user_agent: string;
+      headers?: Readonly<Record<string, string>>;
+    }): Promise<ApiResult<DetectedContext>> {
+      return fetchJson<DetectedContext>(
+        `${baseUrl}/sense/context/detect`,
+        {
+          method: "POST",
+          headers: baseHeaders,
+          body: JSON.stringify(options),
+        },
+        timeoutMs,
+      );
+    },
+
+    async getFeedbackSummary(agentId: string): Promise<ApiResult<FeedbackSummary>> {
+      return fetchJson<FeedbackSummary>(
+        `${baseUrl}/sense/feedback/${encodeURIComponent(agentId)}/summary`,
+        { method: "GET", headers: baseHeaders },
+        timeoutMs,
+      );
+    },
+  };
+}
+

package/src/index.ts

@@ -0,0 +1,37 @@
+/**
+ * @aumos/agent-sense
+ *
+ * TypeScript client for the AumOS agent-sense transparency layer.
+ * Provides HTTP client, intent parsing, response ranking, feedback collection,
+ * accessibility checking, and confidence/disclosure type definitions.
+ */
+
+// Client and configuration
+export type { AgentSenseClient, AgentSenseClientConfig } from "./client.js";
+export { createAgentSenseClient } from "./client.js";
+
+// Core types
+export type {
+  AccessibilityCheckResult,
+  AccessibilityConfig,
+  AIDisclosureCard,
+  ApiError,
+  ApiResult,
+  BrowserCapabilities,
+  ConfidenceIndicator,
+  ConfidenceLevel,
+  DetectedContext,
+  DeviceType,
+  DialogueState,
+  DisclosureLevel,
+  FeedbackCategory,
+  FeedbackEntry,
+  FeedbackSubmitRequest,
+  FeedbackSummary,
+  NetworkQuality,
+  ResponseCandidate,
+  TransparencyIndicator,
+  UserIntent,
+  WCAGLevel,
+  WCAGViolation,
+} from "./types.js";

package/src/types.ts

@@ -0,0 +1,315 @@
+/**
+ * TypeScript interfaces for the agent-sense transparency layer.
+ *
+ * Mirrors the Python dataclasses and Pydantic models defined in:
+ *   agent_sense.indicators.confidence   (ConfidenceLevel, ConfidenceIndicator)
+ *   agent_sense.indicators.disclosure   (DisclosureLevel, AIDisclosureCard)
+ *   agent_sense.feedback.collector      (FeedbackCategory, FeedbackEntry, FeedbackSummary)
+ *   agent_sense.context.detector        (DeviceType, NetworkQuality, BrowserCapabilities, DetectedContext)
+ *   agent_sense.accessibility.wcag      (WCAGLevel, WCAGViolation)
+ *   agent_sense.disclosure.transparency (SessionStats)
+ *
+ * All interfaces use readonly fields to match Python frozen dataclasses.
+ */
+
+// ---------------------------------------------------------------------------
+// Confidence types
+// ---------------------------------------------------------------------------
+
+/**
+ * Five-tier categorical confidence classification.
+ * Maps to ConfidenceLevel enum in Python.
+ * Score bands: very_low [0,0.2), low [0.2,0.4), medium [0.4,0.6),
+ *              high [0.6,0.8), very_high [0.8,1.0].
+ */
+export type ConfidenceLevel =
+  | "very_low"
+  | "low"
+  | "medium"
+  | "high"
+  | "very_high";
+
+/** Structured confidence measurement for an AI agent response. */
+export interface ConfidenceIndicator {
+  /** Raw numeric confidence in [0.0, 1.0]. */
+  readonly score: number;
+  /** Categorical tier derived from score. */
+  readonly level: ConfidenceLevel;
+  /** Human-readable explanation of the confidence assessment. */
+  readonly reasoning: string;
+  /** Map of contributing factor names to their individual scores [0, 1]. */
+  readonly factors: Readonly<Record<string, number>>;
+}
+
+// ---------------------------------------------------------------------------
+// Disclosure types
+// ---------------------------------------------------------------------------
+
+/**
+ * Controls the verbosity of disclosure card rendering.
+ * Maps to DisclosureLevel enum in Python.
+ */
+export type DisclosureLevel = "minimal" | "standard" | "detailed" | "full";
+
+/** Immutable disclosure card for an AI agent deployment. */
+export interface AIDisclosureCard {
+  /** Human-readable name of the agent. */
+  readonly agent_name: string;
+  /** Semantic version or build identifier. */
+  readonly agent_version: string;
+  /** Organisation that produced the underlying model. */
+  readonly model_provider: string;
+  /** Identifier of the specific model being used. */
+  readonly model_name: string;
+  /** Ordered list of things this agent can do well. */
+  readonly capabilities: readonly string[];
+  /** Ordered list of known constraints or failure modes. */
+  readonly limitations: readonly string[];
+  /** Plain-language description of how conversation data is handled. */
+  readonly data_handling: string;
+  /** ISO-8601 UTC datetime at which this card was last revised. */
+  readonly last_updated: string;
+  /** Verbosity level used when rendering this card. */
+  readonly disclosure_level: DisclosureLevel;
+}
+
+// ---------------------------------------------------------------------------
+// Transparency indicator (combined type requested by spec)
+// ---------------------------------------------------------------------------
+
+/** Full transparency indicator combining confidence and disclosure. */
+export interface TransparencyIndicator {
+  /** The confidence measurement for a response. */
+  readonly confidence: ConfidenceIndicator;
+  /** The AI disclosure card for this deployment. */
+  readonly disclosure: AIDisclosureCard;
+  /** ISO-8601 UTC timestamp when this indicator was generated. */
+  readonly generated_at: string;
+}
+
+// ---------------------------------------------------------------------------
+// Feedback types
+// ---------------------------------------------------------------------------
+
+/**
+ * Category labels for user feedback.
+ * Maps to FeedbackCategory enum in Python.
+ */
+export type FeedbackCategory =
+  | "helpful"
+  | "unhelpful"
+  | "harmful"
+  | "irrelevant"
+  | "inaccurate"
+  | "too_long"
+  | "too_short"
+  | "other";
+
+/** A single structured feedback submission from a user. */
+export interface FeedbackEntry {
+  /** Unique identifier for this feedback entry. */
+  readonly feedback_id: string;
+  /** Satisfaction rating from 1 (very poor) to 5 (excellent). */
+  readonly rating: number;
+  /** Structured category label for quick classification. */
+  readonly category: FeedbackCategory;
+  /** The agent that produced the response being rated. */
+  readonly agent_id: string;
+  /** Optional session identifier for grouping feedback. */
+  readonly session_id: string;
+  /** Optional identifier for the specific interaction being rated. */
+  readonly interaction_id: string;
+  /** Optional free-form user comment. */
+  readonly free_text: string;
+  /** ISO-8601 UTC datetime when feedback was submitted. */
+  readonly submitted_at: string;
+  /** Whether this is positive feedback (rating >= 4 or category = helpful). */
+  readonly is_positive: boolean;
+  /** Whether this is negative feedback (rating <= 2 or category = harmful/unhelpful). */
+  readonly is_negative: boolean;
+  /** Arbitrary additional key-value metadata. */
+  readonly metadata: Readonly<Record<string, string>>;
+}
+
+/** Request payload for submitting feedback. */
+export interface FeedbackSubmitRequest {
+  /** Satisfaction rating from 1 to 5. */
+  readonly rating: number;
+  /** Structured category label. */
+  readonly category: FeedbackCategory;
+  /** The agent being rated. */
+  readonly agent_id: string;
+  /** Optional session identifier. */
+  readonly session_id?: string;
+  /** Optional interaction identifier. */
+  readonly interaction_id?: string;
+  /** Optional free-form comment. */
+  readonly free_text?: string;
+  /** Optional additional metadata. */
+  readonly metadata?: Readonly<Record<string, string>>;
+}
+
+/** Aggregated feedback statistics for an agent. */
+export interface FeedbackSummary {
+  /** The agent this summary covers. */
+  readonly agent_id: string;
+  /** Total number of feedback entries processed. */
+  readonly total_feedback: number;
+  /** Mean rating across all entries (1–5). */
+  readonly average_rating: number;
+  /** Normalised satisfaction score in [0, 1]. */
+  readonly satisfaction_score: number;
+  /** Count of feedback entries per category. */
+  readonly category_distribution: Readonly<Record<string, number>>;
+  /** Number of positive feedback entries. */
+  readonly positive_count: number;
+  /** Number of negative feedback entries. */
+  readonly negative_count: number;
+  /** Number of neutral feedback entries (rating = 3). */
+  readonly neutral_count: number;
+  /** Most frequent words from free-text comments. */
+  readonly top_free_text_keywords: readonly string[];
+  /** ISO-8601 UTC datetime when this summary was computed. */
+  readonly computed_at: string;
+}
+
+// ---------------------------------------------------------------------------
+// Dialogue / context types
+// ---------------------------------------------------------------------------
+
+/**
+ * Canonical device categories.
+ * Maps to DeviceType enum in Python.
+ */
+export type DeviceType = "desktop" | "mobile" | "tablet" | "voice" | "unknown";
+
+/**
+ * Inferred network quality tiers.
+ * Maps to NetworkQuality enum in Python.
+ */
+export type NetworkQuality = "high" | "medium" | "low" | "unknown";
+
+/** Feature flags inferred from User-Agent and hints headers. */
+export interface BrowserCapabilities {
+  readonly javascript_enabled: boolean;
+  readonly webgl_supported: boolean;
+  readonly touch_supported: boolean;
+  readonly screen_reader_likely: boolean;
+  readonly reduced_motion_preferred: boolean;
+}
+
+/** Full result of a context detection call. */
+export interface DetectedContext {
+  readonly device_type: DeviceType;
+  readonly network_quality: NetworkQuality;
+  readonly browser_capabilities: BrowserCapabilities;
+  readonly user_agent: string;
+  readonly raw_headers: Readonly<Record<string, string>>;
+}
+
+/** Intent parsed from a user utterance. */
+export interface UserIntent {
+  /** The raw user utterance. */
+  readonly utterance: string;
+  /** Primary intent label (e.g. "question", "command", "clarification"). */
+  readonly intent: string;
+  /** Confidence score for this intent classification in [0, 1]. */
+  readonly confidence: number;
+  /** Extracted named entities. */
+  readonly entities: Readonly<Record<string, string>>;
+  /** ISO-8601 UTC timestamp when this intent was parsed. */
+  readonly parsed_at: string;
+}
+
+/** Ranked response candidate with score. */
+export interface ResponseCandidate {
+  /** Unique identifier for this candidate. */
+  readonly candidate_id: string;
+  /** The response text. */
+  readonly text: string;
+  /** Composite ranking score in [0, 1] (higher = preferred). */
+  readonly score: number;
+  /** Context match contribution to the score. */
+  readonly context_match_score: number;
+  /** Relevance contribution to the score. */
+  readonly relevance_score: number;
+}
+
+/** Current state of a dialogue session. */
+export interface DialogueState {
+  /** Unique session identifier. */
+  readonly session_id: string;
+  /** Current turn number (1-indexed). */
+  readonly turn_number: number;
+  /** Detected context for this session. */
+  readonly detected_context: DetectedContext;
+  /** Current confidence level for the session. */
+  readonly confidence_level: ConfidenceLevel;
+  /** ISO-8601 UTC timestamp of the last activity. */
+  readonly last_activity_at: string;
+  /** Whether a human handoff has been triggered. */
+  readonly handoff_triggered: boolean;
+}
+
+// ---------------------------------------------------------------------------
+// Accessibility types
+// ---------------------------------------------------------------------------
+
+/**
+ * WCAG 2.1 conformance level.
+ * Maps to WCAGLevel enum in Python.
+ */
+export type WCAGLevel = "A" | "AA" | "AAA";
+
+/** A single WCAG 2.1 violation found in inspected content. */
+export interface WCAGViolation {
+  /** WCAG success criterion number (e.g. "1.1.1"). */
+  readonly criterion: string;
+  /** Conformance level of the criterion. */
+  readonly level: WCAGLevel;
+  /** Human-readable description of the violation. */
+  readonly description: string;
+  /** Short snippet of the problematic markup or text. */
+  readonly element_snippet: string;
+  /** Recommended remediation for the violation. */
+  readonly suggestion: string;
+}
+
+/** Result of an accessibility check. */
+export interface AccessibilityCheckResult {
+  /** Whether the content passed all WCAG checks. */
+  readonly passed: boolean;
+  /** List of WCAG violations found. */
+  readonly violations: readonly WCAGViolation[];
+  /** Per-criterion violation counts. */
+  readonly violation_counts: Readonly<Record<string, number>>;
+}
+
+/** Configuration for an accessibility check request. */
+export interface AccessibilityConfig {
+  /** HTML markup or text content to check. */
+  readonly html: string;
+  /** Whether to check color contrast. */
+  readonly check_color_contrast?: boolean;
+  /** Whether to check text alternatives for images. */
+  readonly check_text_alternatives?: boolean;
+  /** Whether to check heading hierarchy. */
+  readonly check_heading_hierarchy?: boolean;
+  /** Whether to check link text descriptiveness. */
+  readonly check_link_text?: boolean;
+}
+
+// ---------------------------------------------------------------------------
+// API result wrapper (shared pattern)
+// ---------------------------------------------------------------------------
+
+/** Standard error payload returned by the agent-sense API. */
+export interface ApiError {
+  readonly error: string;
+  readonly detail: string;
+}
+
+/** Result type for all client operations. */
+export type ApiResult<T> =
+  | { readonly ok: true; readonly data: T }
+  | { readonly ok: false; readonly error: ApiError; readonly status: number };

package/tsconfig.json

@@ -0,0 +1,25 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "lib": ["ES2022", "DOM"],
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "strict": true,
+    "noImplicitAny": true,
+    "strictNullChecks": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "noImplicitReturns": true,
+    "exactOptionalPropertyTypes": true,
+    "forceConsistentCasingInFileNames": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}