@aumos/agent-vertical 0.1.0

package/dist/client.d.ts

@@ -0,0 +1,101 @@
+/**
+ * HTTP client for the agent-vertical domain template API.
+ *
+ * Uses the Fetch API (available natively in Node 18+, browsers, and Deno).
+ * No external dependencies required.
+ *
+ * @example
+ * ```ts
+ * import { createAgentVerticalClient } from "@aumos/agent-vertical";
+ *
+ * const client = createAgentVerticalClient({ baseUrl: "http://localhost:8093" });
+ *
+ * const templates = await client.getTemplates({ domain: "healthcare" });
+ *
+ * if (templates.ok) {
+ *   console.log("Available templates:", templates.data.map(t => t.metadata.name));
+ * }
+ * ```
+ */
+import type { ApiResult, DomainConfig, DomainTemplate, PromptPattern, TemplateConfig, TemplateValidationResult, ToolCollection } from "./types.js";
+/** Configuration options for the AgentVerticalClient. */
+export interface AgentVerticalClientConfig {
+    /** Base URL of the agent-vertical server (e.g. "http://localhost:8093"). */
+    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-vertical server. */
+export interface AgentVerticalClient {
+    /**
+     * List all registered domain templates, optionally filtered by domain.
+     *
+     * @param options - Optional domain filter.
+     * @returns Array of DomainTemplate records sorted by full name.
+     */
+    getTemplates(options?: {
+        domain?: string;
+        limit?: number;
+    }): Promise<ApiResult<readonly DomainTemplate[]>>;
+    /**
+     * Apply a named template to an agent deployment configuration.
+     *
+     * @param config - Template name and optional parameter overrides.
+     * @returns The resolved DomainTemplate with applied configuration.
+     */
+    applyTemplate(config: TemplateConfig): Promise<ApiResult<DomainTemplate>>;
+    /**
+     * Validate a domain template for compliance and structural correctness.
+     *
+     * @param templateName - The machine-readable template name to validate.
+     * @returns A TemplateValidationResult with any warnings found.
+     */
+    validateTemplate(templateName: string): Promise<ApiResult<TemplateValidationResult>>;
+    /**
+     * Get the tool collection for a specific domain or template.
+     *
+     * @param options - Domain or template name to retrieve tools for.
+     * @returns A ToolCollection with all available tool configs.
+     */
+    getToolCollection(options: {
+        domain?: string;
+        template_name?: string;
+    }): Promise<ApiResult<ToolCollection>>;
+    /**
+     * Get the domain configuration including templates and compliance rules.
+     *
+     * @param domain - The domain identifier (e.g. "healthcare", "finance").
+     * @returns A DomainConfig with templates and compliance rules.
+     */
+    getDomainConfig(domain: string): Promise<ApiResult<DomainConfig>>;
+    /**
+     * Get the compliance prompt patterns (rules) for a domain.
+     *
+     * @param domain - The domain identifier.
+     * @returns A PromptPattern with all ComplianceRule records for that domain.
+     */
+    getPromptPattern(domain: string): Promise<ApiResult<PromptPattern>>;
+    /**
+     * List all registered domains.
+     *
+     * @returns Array of domain identifier strings.
+     */
+    listDomains(): Promise<ApiResult<readonly string[]>>;
+    /**
+     * Retrieve a single template by name.
+     *
+     * @param templateName - The machine-readable template name.
+     * @returns The DomainTemplate record.
+     */
+    getTemplate(templateName: string): Promise<ApiResult<DomainTemplate>>;
+}
+/**
+ * Create a typed HTTP client for the agent-vertical server.
+ *
+ * @param config - Client configuration including base URL.
+ * @returns An AgentVerticalClient instance.
+ */
+export declare function createAgentVerticalClient(config: AgentVerticalClientConfig): AgentVerticalClient;
+//# 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;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAEV,SAAS,EACT,YAAY,EACZ,cAAc,EACd,aAAa,EACb,cAAc,EACd,wBAAwB,EACxB,cAAc,EACf,MAAM,YAAY,CAAC;AAMpB,yDAAyD;AACzD,MAAM,WAAW,yBAAyB;IACxC,4EAA4E;IAC5E,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,uDAAuD;AACvD,MAAM,WAAW,mBAAmB;IAClC;;;;;OAKG;IACH,YAAY,CAAC,OAAO,CAAC,EAAE;QACrB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,GAAG,OAAO,CAAC,SAAS,CAAC,SAAS,cAAc,EAAE,CAAC,CAAC,CAAC;IAElD;;;;;OAKG;IACH,aAAa,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC,CAAC;IAE1E;;;;;OAKG;IACH,gBAAgB,CACd,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,SAAS,CAAC,wBAAwB,CAAC,CAAC,CAAC;IAEhD;;;;;OAKG;IACH,iBAAiB,CAAC,OAAO,EAAE;QACzB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB,GAAG,OAAO,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC,CAAC;IAEvC;;;;;OAKG;IACH,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC,CAAC;IAElE;;;;;OAKG;IACH,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,CAAC;IAEpE;;;;OAIG;IACH,WAAW,IAAI,OAAO,CAAC,SAAS,CAAC,SAAS,MAAM,EAAE,CAAC,CAAC,CAAC;IAErD;;;;;OAKG;IACH,WAAW,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC,CAAC;CACvE;AAMD;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,yBAAyB,GAChC,mBAAmB,CAkGrB"}

package/dist/client.js

@@ -0,0 +1,118 @@
+/**
+ * HTTP client for the agent-vertical domain template API.
+ *
+ * Uses the Fetch API (available natively in Node 18+, browsers, and Deno).
+ * No external dependencies required.
+ *
+ * @example
+ * ```ts
+ * import { createAgentVerticalClient } from "@aumos/agent-vertical";
+ *
+ * const client = createAgentVerticalClient({ baseUrl: "http://localhost:8093" });
+ *
+ * const templates = await client.getTemplates({ domain: "healthcare" });
+ *
+ * if (templates.ok) {
+ *   console.log("Available templates:", templates.data.map(t => t.metadata.name));
+ * }
+ * ```
+ */
+// ---------------------------------------------------------------------------
+// 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-vertical server.
+ *
+ * @param config - Client configuration including base URL.
+ * @returns An AgentVerticalClient instance.
+ */
+export function createAgentVerticalClient(config) {
+    const { baseUrl, timeoutMs = 30_000, headers: extraHeaders } = config;
+    const baseHeaders = buildHeaders(extraHeaders);
+    return {
+        async getTemplates(options) {
+            const params = new URLSearchParams();
+            if (options?.domain !== undefined) {
+                params.set("domain", options.domain);
+            }
+            if (options?.limit !== undefined) {
+                params.set("limit", String(options.limit));
+            }
+            const query = params.toString();
+            return fetchJson(`${baseUrl}/vertical/templates${query ? `?${query}` : ""}`, { method: "GET", headers: baseHeaders }, timeoutMs);
+        },
+        async applyTemplate(templateConfig) {
+            return fetchJson(`${baseUrl}/vertical/templates/apply`, {
+                method: "POST",
+                headers: baseHeaders,
+                body: JSON.stringify(templateConfig),
+            }, timeoutMs);
+        },
+        async validateTemplate(templateName) {
+            return fetchJson(`${baseUrl}/vertical/templates/${encodeURIComponent(templateName)}/validate`, { method: "GET", headers: baseHeaders }, timeoutMs);
+        },
+        async getToolCollection(options) {
+            const params = new URLSearchParams();
+            if (options.domain !== undefined) {
+                params.set("domain", options.domain);
+            }
+            if (options.template_name !== undefined) {
+                params.set("template_name", options.template_name);
+            }
+            return fetchJson(`${baseUrl}/vertical/tools?${params.toString()}`, { method: "GET", headers: baseHeaders }, timeoutMs);
+        },
+        async getDomainConfig(domain) {
+            return fetchJson(`${baseUrl}/vertical/domains/${encodeURIComponent(domain)}/config`, { method: "GET", headers: baseHeaders }, timeoutMs);
+        },
+        async getPromptPattern(domain) {
+            return fetchJson(`${baseUrl}/vertical/domains/${encodeURIComponent(domain)}/rules`, { method: "GET", headers: baseHeaders }, timeoutMs);
+        },
+        async listDomains() {
+            return fetchJson(`${baseUrl}/vertical/domains`, { method: "GET", headers: baseHeaders }, timeoutMs);
+        },
+        async getTemplate(templateName) {
+            return fetchJson(`${baseUrl}/vertical/templates/${encodeURIComponent(templateName)}`, { 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-vertical
+ *
+ * TypeScript client for the AumOS agent-vertical domain template system.
+ * Provides HTTP client, certified domain templates, safety rules, tool collections,
+ * compliance rules, and evaluation metric type definitions.
+ */
+export type { AgentVerticalClient, AgentVerticalClientConfig } from "./client.js";
+export { createAgentVerticalClient } from "./client.js";
+export type { ApiError, ApiResult, ComplianceFramework, ComplianceRule, DomainConfig, DomainTemplate, EvaluationMetric, PromptPattern, RiskLevel, RuleType, SafetyRule, TemplateConfig, TemplateMetadata, TemplateValidationResult, ToolCollection, ToolConfig, } 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,mBAAmB,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC;AAClF,OAAO,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC;AAGxD,YAAY,EACV,QAAQ,EACR,SAAS,EACT,mBAAmB,EACnB,cAAc,EACd,YAAY,EACZ,cAAc,EACd,gBAAgB,EAChB,aAAa,EACb,SAAS,EACT,QAAQ,EACR,UAAU,EACV,cAAc,EACd,gBAAgB,EAChB,wBAAwB,EACxB,cAAc,EACd,UAAU,GACX,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,9 @@
+/**
+ * @aumos/agent-vertical
+ *
+ * TypeScript client for the AumOS agent-vertical domain template system.
+ * Provides HTTP client, certified domain templates, safety rules, tool collections,
+ * compliance rules, and evaluation metric type definitions.
+ */
+export { createAgentVerticalClient } 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,yBAAyB,EAAE,MAAM,aAAa,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,190 @@
+/**
+ * TypeScript interfaces for the agent-vertical domain template system.
+ *
+ * Mirrors the Python dataclasses and Pydantic models defined in:
+ *   agent_vertical.templates.base          (DomainTemplate, TemplateRegistry)
+ *   agent_vertical.certified.schema        (SafetyRule, ToolConfig, EvalBenchmark, TemplateMetadata, DomainTemplate)
+ *   agent_vertical.compliance.domain_rules (RuleType, ComplianceRule, DomainComplianceRules)
+ *   agent_vertical.certification.risk_tier (RiskTier)
+ *
+ * All interfaces use readonly fields to match Python frozen dataclasses.
+ */
+/**
+ * Risk classification tiers for domain templates.
+ * Maps to RiskTier / RiskLevel enums in Python.
+ */
+export type RiskLevel = "LOW" | "MEDIUM" | "HIGH" | "CRITICAL";
+/**
+ * Recognised compliance and regulatory frameworks.
+ * Maps to ComplianceFramework enum in Python.
+ */
+export type ComplianceFramework = "HIPAA" | "SOX" | "GDPR" | "SOC2" | "PCI_DSS" | "NONE";
+/**
+ * The type of compliance rule.
+ * Maps to RuleType enum in Python.
+ */
+export type RuleType = "PROHIBITED_PHRASE" | "REQUIRED_DISCLAIMER" | "PROHIBITED_PATTERN" | "REQUIRED_PATTERN";
+/**
+ * A single safety constraint applied to agent output at runtime.
+ * Maps to SafetyRule frozen dataclass in Python.
+ */
+export interface SafetyRule {
+    /** Unique dot-notation identifier (e.g. "hipaa.no_phi_exposure"). */
+    readonly rule_id: string;
+    /** Human-readable description of the constraint. */
+    readonly description: string;
+    /** Impact level: "warning", "error", or "critical". */
+    readonly severity: string;
+    /** Python regex pattern used to test agent output. */
+    readonly check_pattern: string;
+}
+/**
+ * Configuration for a single tool available to the agent.
+ * Maps to ToolConfig frozen dataclass in Python.
+ */
+export interface ToolConfig {
+    /** Machine-readable tool name (e.g. "audit_logger"). */
+    readonly name: string;
+    /** Human-readable description of what the tool does. */
+    readonly description: string;
+    /** When true, the tool must be wired up before the template is deployable. */
+    readonly required: boolean;
+    /** Parameter schema for the tool. */
+    readonly parameters: Readonly<Record<string, unknown>>;
+}
+/**
+ * A named collection of tool configurations for a domain.
+ * Corresponds to the tools tuple on DomainTemplate in Python.
+ */
+export interface ToolCollection {
+    /** Name of this tool collection (typically matching the template domain). */
+    readonly collection_name: string;
+    /** The tool configurations in this collection. */
+    readonly tools: readonly ToolConfig[];
+}
+/**
+ * A single evaluation benchmark specification.
+ * Maps to EvalBenchmark frozen dataclass in Python.
+ */
+export interface EvaluationMetric {
+    /** Short identifier for the benchmark (e.g. "phi_redaction_rate"). */
+    readonly name: string;
+    /** The measurement being tracked (e.g. "precision", "recall"). */
+    readonly metric: string;
+    /** Minimum acceptable value on a 0.0–1.0 scale. */
+    readonly threshold: number;
+    /** Human-readable description of what this benchmark verifies. */
+    readonly description: string;
+}
+/** Provenance and classification metadata for a DomainTemplate. */
+export interface TemplateMetadata {
+    /** Unique machine-readable template name. */
+    readonly name: string;
+    /** Semantic version string (e.g. "1.0.0"). */
+    readonly version: string;
+    /** Domain this template belongs to (e.g. "healthcare"). */
+    readonly domain: string;
+    /** Compliance frameworks the template is designed to satisfy. */
+    readonly compliance_frameworks: readonly ComplianceFramework[];
+    /** Risk classification for this template. */
+    readonly risk_level: RiskLevel;
+    /** Human-readable description of the template's purpose. */
+    readonly description: string;
+    /** Author or team identifier. */
+    readonly author: string;
+    /** ISO-8601 UTC datetime of initial template creation. */
+    readonly created_at: string;
+    /** Free-form tags for search and filtering. */
+    readonly tags: readonly string[];
+}
+/**
+ * A compliance-certified, self-describing agent template.
+ * Maps to DomainTemplate Pydantic model in Python (certified.schema).
+ */
+export interface DomainTemplate {
+    /** Provenance and classification metadata. */
+    readonly metadata: TemplateMetadata;
+    /** Full system prompt for the LLM context. */
+    readonly system_prompt: string;
+    /** Tool declarations with required/optional flags. */
+    readonly tool_configs: readonly ToolConfig[];
+    /** Runtime safety constraints with regex patterns. */
+    readonly safety_rules: readonly SafetyRule[];
+    /** Free-form governance policies (key/value). */
+    readonly governance_policies: Readonly<Record<string, unknown>>;
+    /** Evaluation benchmarks with numeric thresholds. */
+    readonly eval_benchmarks: readonly EvaluationMetric[];
+    /** Mapping of framework name to compliance evidence description. */
+    readonly compliance_evidence: Readonly<Record<string, string>>;
+}
+/** Configuration options for applying a template to an agent. */
+export interface TemplateConfig {
+    /** The template name to apply. */
+    readonly template_name: string;
+    /** Optional parameter overrides for this deployment. */
+    readonly parameter_overrides?: Readonly<Record<string, unknown>>;
+    /** Whether to perform pre-apply validation. */
+    readonly validate_before_apply?: boolean;
+}
+/**
+ * A single domain compliance rule.
+ * Maps to ComplianceRule frozen dataclass in Python.
+ */
+export interface ComplianceRule {
+    /** Unique identifier in dot notation (e.g. "hipaa.no_diagnosis"). */
+    readonly rule_id: string;
+    /** Whether this rule prohibits or requires content. */
+    readonly rule_type: RuleType;
+    /** The phrase or regex pattern to test against agent responses. */
+    readonly pattern: string;
+    /** Human-readable description of what this rule enforces. */
+    readonly description: string;
+    /** Impact level: "critical", "high", "medium", or "low". */
+    readonly severity: string;
+    /** Suggested fix when this rule is violated. */
+    readonly remediation: string;
+    /** When true, pattern is treated as a regular expression. */
+    readonly is_regex: boolean;
+}
+/** A collection of compliance rules for a specific domain. */
+export interface PromptPattern {
+    /** Domain identifier (e.g. "healthcare"). */
+    readonly domain: string;
+    /** Ordered list of rules to enforce. */
+    readonly rules: readonly ComplianceRule[];
+}
+/** Result of validating a domain template. */
+export interface TemplateValidationResult {
+    /** Whether the template passed all validation checks. */
+    readonly valid: boolean;
+    /** Human-readable warning messages (non-empty means issues found). */
+    readonly warnings: readonly string[];
+    /** The template name that was validated. */
+    readonly template_name: string;
+}
+/** Summary configuration for a specific domain. */
+export interface DomainConfig {
+    /** Domain identifier. */
+    readonly domain: string;
+    /** Available templates in this domain. */
+    readonly templates: readonly string[];
+    /** Compliance rules applicable to this domain. */
+    readonly compliance_rules: readonly ComplianceRule[];
+    /** Supported compliance frameworks for this domain. */
+    readonly supported_frameworks: readonly ComplianceFramework[];
+}
+/** Standard error payload returned by the agent-vertical 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":"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"}

package/dist/types.js

@@ -0,0 +1,13 @@
+/**
+ * TypeScript interfaces for the agent-vertical domain template system.
+ *
+ * Mirrors the Python dataclasses and Pydantic models defined in:
+ *   agent_vertical.templates.base          (DomainTemplate, TemplateRegistry)
+ *   agent_vertical.certified.schema        (SafetyRule, ToolConfig, EvalBenchmark, TemplateMetadata, DomainTemplate)
+ *   agent_vertical.compliance.domain_rules (RuleType, ComplianceRule, DomainComplianceRules)
+ *   agent_vertical.certification.risk_tier (RiskTier)
+ *
+ * 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;;;;;;;;;;GAUG"}

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@aumos/agent-vertical",
+  "version": "0.1.0",
+  "description": "TypeScript client for the AumOS agent-vertical domain templates — certified domain templates, safety rules, tool collections, and compliance validation",
+  "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-vertical",
+    "domain-templates",
+    "compliance",
+    "healthcare",
+    "finance",
+    "legal",
+    "typescript"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/aumos-ai/agent-vertical"
+  }
+}

package/src/client.ts

@@ -0,0 +1,287 @@
+/**
+ * HTTP client for the agent-vertical domain template API.
+ *
+ * Uses the Fetch API (available natively in Node 18+, browsers, and Deno).
+ * No external dependencies required.
+ *
+ * @example
+ * ```ts
+ * import { createAgentVerticalClient } from "@aumos/agent-vertical";
+ *
+ * const client = createAgentVerticalClient({ baseUrl: "http://localhost:8093" });
+ *
+ * const templates = await client.getTemplates({ domain: "healthcare" });
+ *
+ * if (templates.ok) {
+ *   console.log("Available templates:", templates.data.map(t => t.metadata.name));
+ * }
+ * ```
+ */
+
+import type {
+  ApiError,
+  ApiResult,
+  DomainConfig,
+  DomainTemplate,
+  PromptPattern,
+  TemplateConfig,
+  TemplateValidationResult,
+  ToolCollection,
+} from "./types.js";
+
+// ---------------------------------------------------------------------------
+// Client configuration
+// ---------------------------------------------------------------------------
+
+/** Configuration options for the AgentVerticalClient. */
+export interface AgentVerticalClientConfig {
+  /** Base URL of the agent-vertical server (e.g. "http://localhost:8093"). */
+  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-vertical server. */
+export interface AgentVerticalClient {
+  /**
+   * List all registered domain templates, optionally filtered by domain.
+   *
+   * @param options - Optional domain filter.
+   * @returns Array of DomainTemplate records sorted by full name.
+   */
+  getTemplates(options?: {
+    domain?: string;
+    limit?: number;
+  }): Promise<ApiResult<readonly DomainTemplate[]>>;
+
+  /**
+   * Apply a named template to an agent deployment configuration.
+   *
+   * @param config - Template name and optional parameter overrides.
+   * @returns The resolved DomainTemplate with applied configuration.
+   */
+  applyTemplate(config: TemplateConfig): Promise<ApiResult<DomainTemplate>>;
+
+  /**
+   * Validate a domain template for compliance and structural correctness.
+   *
+   * @param templateName - The machine-readable template name to validate.
+   * @returns A TemplateValidationResult with any warnings found.
+   */
+  validateTemplate(
+    templateName: string,
+  ): Promise<ApiResult<TemplateValidationResult>>;
+
+  /**
+   * Get the tool collection for a specific domain or template.
+   *
+   * @param options - Domain or template name to retrieve tools for.
+   * @returns A ToolCollection with all available tool configs.
+   */
+  getToolCollection(options: {
+    domain?: string;
+    template_name?: string;
+  }): Promise<ApiResult<ToolCollection>>;
+
+  /**
+   * Get the domain configuration including templates and compliance rules.
+   *
+   * @param domain - The domain identifier (e.g. "healthcare", "finance").
+   * @returns A DomainConfig with templates and compliance rules.
+   */
+  getDomainConfig(domain: string): Promise<ApiResult<DomainConfig>>;
+
+  /**
+   * Get the compliance prompt patterns (rules) for a domain.
+   *
+   * @param domain - The domain identifier.
+   * @returns A PromptPattern with all ComplianceRule records for that domain.
+   */
+  getPromptPattern(domain: string): Promise<ApiResult<PromptPattern>>;
+
+  /**
+   * List all registered domains.
+   *
+   * @returns Array of domain identifier strings.
+   */
+  listDomains(): Promise<ApiResult<readonly string[]>>;
+
+  /**
+   * Retrieve a single template by name.
+   *
+   * @param templateName - The machine-readable template name.
+   * @returns The DomainTemplate record.
+   */
+  getTemplate(templateName: string): Promise<ApiResult<DomainTemplate>>;
+}
+
+// ---------------------------------------------------------------------------
+// Client factory
+// ---------------------------------------------------------------------------
+
+/**
+ * Create a typed HTTP client for the agent-vertical server.
+ *
+ * @param config - Client configuration including base URL.
+ * @returns An AgentVerticalClient instance.
+ */
+export function createAgentVerticalClient(
+  config: AgentVerticalClientConfig,
+): AgentVerticalClient {
+  const { baseUrl, timeoutMs = 30_000, headers: extraHeaders } = config;
+  const baseHeaders = buildHeaders(extraHeaders);
+
+  return {
+    async getTemplates(options?: {
+      domain?: string;
+      limit?: number;
+    }): Promise<ApiResult<readonly DomainTemplate[]>> {
+      const params = new URLSearchParams();
+      if (options?.domain !== undefined) {
+        params.set("domain", options.domain);
+      }
+      if (options?.limit !== undefined) {
+        params.set("limit", String(options.limit));
+      }
+      const query = params.toString();
+      return fetchJson<readonly DomainTemplate[]>(
+        `${baseUrl}/vertical/templates${query ? `?${query}` : ""}`,
+        { method: "GET", headers: baseHeaders },
+        timeoutMs,
+      );
+    },
+
+    async applyTemplate(
+      templateConfig: TemplateConfig,
+    ): Promise<ApiResult<DomainTemplate>> {
+      return fetchJson<DomainTemplate>(
+        `${baseUrl}/vertical/templates/apply`,
+        {
+          method: "POST",
+          headers: baseHeaders,
+          body: JSON.stringify(templateConfig),
+        },
+        timeoutMs,
+      );
+    },
+
+    async validateTemplate(
+      templateName: string,
+    ): Promise<ApiResult<TemplateValidationResult>> {
+      return fetchJson<TemplateValidationResult>(
+        `${baseUrl}/vertical/templates/${encodeURIComponent(templateName)}/validate`,
+        { method: "GET", headers: baseHeaders },
+        timeoutMs,
+      );
+    },
+
+    async getToolCollection(options: {
+      domain?: string;
+      template_name?: string;
+    }): Promise<ApiResult<ToolCollection>> {
+      const params = new URLSearchParams();
+      if (options.domain !== undefined) {
+        params.set("domain", options.domain);
+      }
+      if (options.template_name !== undefined) {
+        params.set("template_name", options.template_name);
+      }
+      return fetchJson<ToolCollection>(
+        `${baseUrl}/vertical/tools?${params.toString()}`,
+        { method: "GET", headers: baseHeaders },
+        timeoutMs,
+      );
+    },
+
+    async getDomainConfig(domain: string): Promise<ApiResult<DomainConfig>> {
+      return fetchJson<DomainConfig>(
+        `${baseUrl}/vertical/domains/${encodeURIComponent(domain)}/config`,
+        { method: "GET", headers: baseHeaders },
+        timeoutMs,
+      );
+    },
+
+    async getPromptPattern(domain: string): Promise<ApiResult<PromptPattern>> {
+      return fetchJson<PromptPattern>(
+        `${baseUrl}/vertical/domains/${encodeURIComponent(domain)}/rules`,
+        { method: "GET", headers: baseHeaders },
+        timeoutMs,
+      );
+    },
+
+    async listDomains(): Promise<ApiResult<readonly string[]>> {
+      return fetchJson<readonly string[]>(
+        `${baseUrl}/vertical/domains`,
+        { method: "GET", headers: baseHeaders },
+        timeoutMs,
+      );
+    },
+
+    async getTemplate(templateName: string): Promise<ApiResult<DomainTemplate>> {
+      return fetchJson<DomainTemplate>(
+        `${baseUrl}/vertical/templates/${encodeURIComponent(templateName)}`,
+        { method: "GET", headers: baseHeaders },
+        timeoutMs,
+      );
+    },
+  };
+}
+

package/src/index.ts

@@ -0,0 +1,31 @@
+/**
+ * @aumos/agent-vertical
+ *
+ * TypeScript client for the AumOS agent-vertical domain template system.
+ * Provides HTTP client, certified domain templates, safety rules, tool collections,
+ * compliance rules, and evaluation metric type definitions.
+ */
+
+// Client and configuration
+export type { AgentVerticalClient, AgentVerticalClientConfig } from "./client.js";
+export { createAgentVerticalClient } from "./client.js";
+
+// Core types
+export type {
+  ApiError,
+  ApiResult,
+  ComplianceFramework,
+  ComplianceRule,
+  DomainConfig,
+  DomainTemplate,
+  EvaluationMetric,
+  PromptPattern,
+  RiskLevel,
+  RuleType,
+  SafetyRule,
+  TemplateConfig,
+  TemplateMetadata,
+  TemplateValidationResult,
+  ToolCollection,
+  ToolConfig,
+} from "./types.js";

package/src/types.ts

@@ -0,0 +1,250 @@
+/**
+ * TypeScript interfaces for the agent-vertical domain template system.
+ *
+ * Mirrors the Python dataclasses and Pydantic models defined in:
+ *   agent_vertical.templates.base          (DomainTemplate, TemplateRegistry)
+ *   agent_vertical.certified.schema        (SafetyRule, ToolConfig, EvalBenchmark, TemplateMetadata, DomainTemplate)
+ *   agent_vertical.compliance.domain_rules (RuleType, ComplianceRule, DomainComplianceRules)
+ *   agent_vertical.certification.risk_tier (RiskTier)
+ *
+ * All interfaces use readonly fields to match Python frozen dataclasses.
+ */
+
+// ---------------------------------------------------------------------------
+// Risk and compliance enums
+// ---------------------------------------------------------------------------
+
+/**
+ * Risk classification tiers for domain templates.
+ * Maps to RiskTier / RiskLevel enums in Python.
+ */
+export type RiskLevel = "LOW" | "MEDIUM" | "HIGH" | "CRITICAL";
+
+/**
+ * Recognised compliance and regulatory frameworks.
+ * Maps to ComplianceFramework enum in Python.
+ */
+export type ComplianceFramework =
+  | "HIPAA"
+  | "SOX"
+  | "GDPR"
+  | "SOC2"
+  | "PCI_DSS"
+  | "NONE";
+
+/**
+ * The type of compliance rule.
+ * Maps to RuleType enum in Python.
+ */
+export type RuleType =
+  | "PROHIBITED_PHRASE"
+  | "REQUIRED_DISCLAIMER"
+  | "PROHIBITED_PATTERN"
+  | "REQUIRED_PATTERN";
+
+// ---------------------------------------------------------------------------
+// Safety rule
+// ---------------------------------------------------------------------------
+
+/**
+ * A single safety constraint applied to agent output at runtime.
+ * Maps to SafetyRule frozen dataclass in Python.
+ */
+export interface SafetyRule {
+  /** Unique dot-notation identifier (e.g. "hipaa.no_phi_exposure"). */
+  readonly rule_id: string;
+  /** Human-readable description of the constraint. */
+  readonly description: string;
+  /** Impact level: "warning", "error", or "critical". */
+  readonly severity: string;
+  /** Python regex pattern used to test agent output. */
+  readonly check_pattern: string;
+}
+
+// ---------------------------------------------------------------------------
+// Tool collection / config
+// ---------------------------------------------------------------------------
+
+/**
+ * Configuration for a single tool available to the agent.
+ * Maps to ToolConfig frozen dataclass in Python.
+ */
+export interface ToolConfig {
+  /** Machine-readable tool name (e.g. "audit_logger"). */
+  readonly name: string;
+  /** Human-readable description of what the tool does. */
+  readonly description: string;
+  /** When true, the tool must be wired up before the template is deployable. */
+  readonly required: boolean;
+  /** Parameter schema for the tool. */
+  readonly parameters: Readonly<Record<string, unknown>>;
+}
+
+/**
+ * A named collection of tool configurations for a domain.
+ * Corresponds to the tools tuple on DomainTemplate in Python.
+ */
+export interface ToolCollection {
+  /** Name of this tool collection (typically matching the template domain). */
+  readonly collection_name: string;
+  /** The tool configurations in this collection. */
+  readonly tools: readonly ToolConfig[];
+}
+
+// ---------------------------------------------------------------------------
+// Evaluation metric
+// ---------------------------------------------------------------------------
+
+/**
+ * A single evaluation benchmark specification.
+ * Maps to EvalBenchmark frozen dataclass in Python.
+ */
+export interface EvaluationMetric {
+  /** Short identifier for the benchmark (e.g. "phi_redaction_rate"). */
+  readonly name: string;
+  /** The measurement being tracked (e.g. "precision", "recall"). */
+  readonly metric: string;
+  /** Minimum acceptable value on a 0.0–1.0 scale. */
+  readonly threshold: number;
+  /** Human-readable description of what this benchmark verifies. */
+  readonly description: string;
+}
+
+// ---------------------------------------------------------------------------
+// Template metadata
+// ---------------------------------------------------------------------------
+
+/** Provenance and classification metadata for a DomainTemplate. */
+export interface TemplateMetadata {
+  /** Unique machine-readable template name. */
+  readonly name: string;
+  /** Semantic version string (e.g. "1.0.0"). */
+  readonly version: string;
+  /** Domain this template belongs to (e.g. "healthcare"). */
+  readonly domain: string;
+  /** Compliance frameworks the template is designed to satisfy. */
+  readonly compliance_frameworks: readonly ComplianceFramework[];
+  /** Risk classification for this template. */
+  readonly risk_level: RiskLevel;
+  /** Human-readable description of the template's purpose. */
+  readonly description: string;
+  /** Author or team identifier. */
+  readonly author: string;
+  /** ISO-8601 UTC datetime of initial template creation. */
+  readonly created_at: string;
+  /** Free-form tags for search and filtering. */
+  readonly tags: readonly string[];
+}
+
+// ---------------------------------------------------------------------------
+// Domain template (the central entity)
+// ---------------------------------------------------------------------------
+
+/**
+ * A compliance-certified, self-describing agent template.
+ * Maps to DomainTemplate Pydantic model in Python (certified.schema).
+ */
+export interface DomainTemplate {
+  /** Provenance and classification metadata. */
+  readonly metadata: TemplateMetadata;
+  /** Full system prompt for the LLM context. */
+  readonly system_prompt: string;
+  /** Tool declarations with required/optional flags. */
+  readonly tool_configs: readonly ToolConfig[];
+  /** Runtime safety constraints with regex patterns. */
+  readonly safety_rules: readonly SafetyRule[];
+  /** Free-form governance policies (key/value). */
+  readonly governance_policies: Readonly<Record<string, unknown>>;
+  /** Evaluation benchmarks with numeric thresholds. */
+  readonly eval_benchmarks: readonly EvaluationMetric[];
+  /** Mapping of framework name to compliance evidence description. */
+  readonly compliance_evidence: Readonly<Record<string, string>>;
+}
+
+/** Configuration options for applying a template to an agent. */
+export interface TemplateConfig {
+  /** The template name to apply. */
+  readonly template_name: string;
+  /** Optional parameter overrides for this deployment. */
+  readonly parameter_overrides?: Readonly<Record<string, unknown>>;
+  /** Whether to perform pre-apply validation. */
+  readonly validate_before_apply?: boolean;
+}
+
+// ---------------------------------------------------------------------------
+// Compliance rule
+// ---------------------------------------------------------------------------
+
+/**
+ * A single domain compliance rule.
+ * Maps to ComplianceRule frozen dataclass in Python.
+ */
+export interface ComplianceRule {
+  /** Unique identifier in dot notation (e.g. "hipaa.no_diagnosis"). */
+  readonly rule_id: string;
+  /** Whether this rule prohibits or requires content. */
+  readonly rule_type: RuleType;
+  /** The phrase or regex pattern to test against agent responses. */
+  readonly pattern: string;
+  /** Human-readable description of what this rule enforces. */
+  readonly description: string;
+  /** Impact level: "critical", "high", "medium", or "low". */
+  readonly severity: string;
+  /** Suggested fix when this rule is violated. */
+  readonly remediation: string;
+  /** When true, pattern is treated as a regular expression. */
+  readonly is_regex: boolean;
+}
+
+/** A collection of compliance rules for a specific domain. */
+export interface PromptPattern {
+  /** Domain identifier (e.g. "healthcare"). */
+  readonly domain: string;
+  /** Ordered list of rules to enforce. */
+  readonly rules: readonly ComplianceRule[];
+}
+
+// ---------------------------------------------------------------------------
+// Template validation result
+// ---------------------------------------------------------------------------
+
+/** Result of validating a domain template. */
+export interface TemplateValidationResult {
+  /** Whether the template passed all validation checks. */
+  readonly valid: boolean;
+  /** Human-readable warning messages (non-empty means issues found). */
+  readonly warnings: readonly string[];
+  /** The template name that was validated. */
+  readonly template_name: string;
+}
+
+// ---------------------------------------------------------------------------
+// Domain config summary
+// ---------------------------------------------------------------------------
+
+/** Summary configuration for a specific domain. */
+export interface DomainConfig {
+  /** Domain identifier. */
+  readonly domain: string;
+  /** Available templates in this domain. */
+  readonly templates: readonly string[];
+  /** Compliance rules applicable to this domain. */
+  readonly compliance_rules: readonly ComplianceRule[];
+  /** Supported compliance frameworks for this domain. */
+  readonly supported_frameworks: readonly ComplianceFramework[];
+}
+
+// ---------------------------------------------------------------------------
+// API result wrapper (shared pattern)
+// ---------------------------------------------------------------------------
+
+/** Standard error payload returned by the agent-vertical 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"]
+}