@huddle-marketplace/skills 0.2.0

package/dist/types/index.d.ts

@@ -0,0 +1,814 @@
+/**
+ * @huddle-marketplace/skills — Canonical Type Definitions
+ *
+ * These types define the interface contract for all Huddle compliance skills.
+ * Every skill, adapter, and registry implementation depends on these types.
+ */
+import { z } from "zod";
+/** US state codes */
+export type USStateCode = "US-AL" | "US-AK" | "US-AZ" | "US-AR" | "US-CA" | "US-CO" | "US-CT" | "US-DE" | "US-FL" | "US-GA" | "US-HI" | "US-ID" | "US-IL" | "US-IN" | "US-IA" | "US-KS" | "US-KY" | "US-LA" | "US-ME" | "US-MD" | "US-MA" | "US-MI" | "US-MN" | "US-MS" | "US-MO" | "US-MT" | "US-NE" | "US-NV" | "US-NH" | "US-NJ" | "US-NM" | "US-NY" | "US-NC" | "US-ND" | "US-OH" | "US-OK" | "US-OR" | "US-PA" | "US-RI" | "US-SC" | "US-SD" | "US-TN" | "US-TX" | "US-UT" | "US-VT" | "US-VA" | "US-WA" | "US-WV" | "US-WI" | "US-WY";
+/** Canadian province/territory codes */
+export type CAProvinceCode = "CA-AB" | "CA-BC" | "CA-MB" | "CA-NB" | "CA-NL" | "CA-NS" | "CA-NT" | "CA-NU" | "CA-ON" | "CA-PE" | "CA-QC" | "CA-SK" | "CA-YT";
+/** Federal overlay codes */
+export type FederalCode = "US-CFTC" | "US-CFPB" | "US-OFAC" | "CA-FINTRAC";
+/** All supported jurisdiction codes */
+export type JurisdictionCode = USStateCode | CAProvinceCode | FederalCode;
+/** What a skill can validate */
+export type SkillCapability = "deposit-validation" | "payment-compliance" | "rent-increase-validation" | "late-fee-validation" | "deposit-return" | "deposit-interest" | "lease-clause-validation" | "tenant-screening" | "rent-reasonableness" | "homeownership-readiness" | "buyer-program-matching" | "closing-cost-estimation" | "yield-compliance" | "tax-reporting" | "regulatory-reporting" | "federal-preemption";
+export declare const LegalCitationSchema: z.ZodObject<{
+    statute: z.ZodString;
+    section: z.ZodString;
+    summary: z.ZodString;
+    url: z.ZodOptional<z.ZodString>;
+    effectiveDate: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    statute: string;
+    section: string;
+    summary: string;
+    url?: string | undefined;
+    effectiveDate?: string | undefined;
+}, {
+    statute: string;
+    section: string;
+    summary: string;
+    url?: string | undefined;
+    effectiveDate?: string | undefined;
+}>;
+export type LegalCitation = z.infer<typeof LegalCitationSchema>;
+export declare const RemediationStepSchema: z.ZodObject<{
+    action: z.ZodString;
+    description: z.ZodString;
+    urgency: z.ZodEnum<["required", "recommended", "optional"]>;
+    automatable: z.ZodBoolean;
+}, "strip", z.ZodTypeAny, {
+    action: string;
+    description: string;
+    urgency: "required" | "recommended" | "optional";
+    automatable: boolean;
+}, {
+    action: string;
+    description: string;
+    urgency: "required" | "recommended" | "optional";
+    automatable: boolean;
+}>;
+export type RemediationStep = z.infer<typeof RemediationStepSchema>;
+export declare const SkillCheckSchema: z.ZodObject<{
+    name: z.ZodString;
+    passed: z.ZodBoolean;
+    confidence: z.ZodNumber;
+    note: z.ZodString;
+    citation: z.ZodOptional<z.ZodObject<{
+        statute: z.ZodString;
+        section: z.ZodString;
+        summary: z.ZodString;
+        url: z.ZodOptional<z.ZodString>;
+        effectiveDate: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        statute: string;
+        section: string;
+        summary: string;
+        url?: string | undefined;
+        effectiveDate?: string | undefined;
+    }, {
+        statute: string;
+        section: string;
+        summary: string;
+        url?: string | undefined;
+        effectiveDate?: string | undefined;
+    }>>;
+    details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    passed: boolean;
+    confidence: number;
+    note: string;
+    citation?: {
+        statute: string;
+        section: string;
+        summary: string;
+        url?: string | undefined;
+        effectiveDate?: string | undefined;
+    } | undefined;
+    details?: Record<string, unknown> | undefined;
+}, {
+    name: string;
+    passed: boolean;
+    confidence: number;
+    note: string;
+    citation?: {
+        statute: string;
+        section: string;
+        summary: string;
+        url?: string | undefined;
+        effectiveDate?: string | undefined;
+    } | undefined;
+    details?: Record<string, unknown> | undefined;
+}>;
+export type SkillCheck = z.infer<typeof SkillCheckSchema>;
+export declare const SkillResultSchema: z.ZodObject<{
+    compliant: z.ZodBoolean;
+    confidence: z.ZodNumber;
+    jurisdiction: z.ZodString;
+    skillId: z.ZodString;
+    skillVersion: z.ZodString;
+    checks: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        passed: z.ZodBoolean;
+        confidence: z.ZodNumber;
+        note: z.ZodString;
+        citation: z.ZodOptional<z.ZodObject<{
+            statute: z.ZodString;
+            section: z.ZodString;
+            summary: z.ZodString;
+            url: z.ZodOptional<z.ZodString>;
+            effectiveDate: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            statute: string;
+            section: string;
+            summary: string;
+            url?: string | undefined;
+            effectiveDate?: string | undefined;
+        }, {
+            statute: string;
+            section: string;
+            summary: string;
+            url?: string | undefined;
+            effectiveDate?: string | undefined;
+        }>>;
+        details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        passed: boolean;
+        confidence: number;
+        note: string;
+        citation?: {
+            statute: string;
+            section: string;
+            summary: string;
+            url?: string | undefined;
+            effectiveDate?: string | undefined;
+        } | undefined;
+        details?: Record<string, unknown> | undefined;
+    }, {
+        name: string;
+        passed: boolean;
+        confidence: number;
+        note: string;
+        citation?: {
+            statute: string;
+            section: string;
+            summary: string;
+            url?: string | undefined;
+            effectiveDate?: string | undefined;
+        } | undefined;
+        details?: Record<string, unknown> | undefined;
+    }>, "many">;
+    explanation: z.ZodOptional<z.ZodString>;
+    remediation: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        action: z.ZodString;
+        description: z.ZodString;
+        urgency: z.ZodEnum<["required", "recommended", "optional"]>;
+        automatable: z.ZodBoolean;
+    }, "strip", z.ZodTypeAny, {
+        action: string;
+        description: string;
+        urgency: "required" | "recommended" | "optional";
+        automatable: boolean;
+    }, {
+        action: string;
+        description: string;
+        urgency: "required" | "recommended" | "optional";
+        automatable: boolean;
+    }>, "many">>;
+    citations: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        statute: z.ZodString;
+        section: z.ZodString;
+        summary: z.ZodString;
+        url: z.ZodOptional<z.ZodString>;
+        effectiveDate: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        statute: string;
+        section: string;
+        summary: string;
+        url?: string | undefined;
+        effectiveDate?: string | undefined;
+    }, {
+        statute: string;
+        section: string;
+        summary: string;
+        url?: string | undefined;
+        effectiveDate?: string | undefined;
+    }>, "many">>;
+    timestamp: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    confidence: number;
+    compliant: boolean;
+    jurisdiction: string;
+    skillId: string;
+    skillVersion: string;
+    checks: {
+        name: string;
+        passed: boolean;
+        confidence: number;
+        note: string;
+        citation?: {
+            statute: string;
+            section: string;
+            summary: string;
+            url?: string | undefined;
+            effectiveDate?: string | undefined;
+        } | undefined;
+        details?: Record<string, unknown> | undefined;
+    }[];
+    timestamp: number;
+    explanation?: string | undefined;
+    remediation?: {
+        action: string;
+        description: string;
+        urgency: "required" | "recommended" | "optional";
+        automatable: boolean;
+    }[] | undefined;
+    citations?: {
+        statute: string;
+        section: string;
+        summary: string;
+        url?: string | undefined;
+        effectiveDate?: string | undefined;
+    }[] | undefined;
+}, {
+    confidence: number;
+    compliant: boolean;
+    jurisdiction: string;
+    skillId: string;
+    skillVersion: string;
+    checks: {
+        name: string;
+        passed: boolean;
+        confidence: number;
+        note: string;
+        citation?: {
+            statute: string;
+            section: string;
+            summary: string;
+            url?: string | undefined;
+            effectiveDate?: string | undefined;
+        } | undefined;
+        details?: Record<string, unknown> | undefined;
+    }[];
+    timestamp: number;
+    explanation?: string | undefined;
+    remediation?: {
+        action: string;
+        description: string;
+        urgency: "required" | "recommended" | "optional";
+        automatable: boolean;
+    }[] | undefined;
+    citations?: {
+        statute: string;
+        section: string;
+        summary: string;
+        url?: string | undefined;
+        effectiveDate?: string | undefined;
+    }[] | undefined;
+}>;
+export type SkillResult = z.infer<typeof SkillResultSchema>;
+export declare const DepositValidationInputSchema: z.ZodObject<{
+    type: z.ZodLiteral<"deposit-validation">;
+    depositAmountCents: z.ZodNumber;
+    monthlyRentCents: z.ZodNumber;
+    currency: z.ZodEnum<["USD", "CAD", "USDC"]>;
+    leaseTermMonths: z.ZodOptional<z.ZodNumber>;
+    landlordConsentSignature: z.ZodOptional<z.ZodString>;
+    tenantConsentSignature: z.ZodOptional<z.ZodString>;
+    mutualAssentTimestamp: z.ZodOptional<z.ZodNumber>;
+    collateralType: z.ZodOptional<z.ZodString>;
+    collateralValueCents: z.ZodOptional<z.ZodNumber>;
+    originalDepositValueCents: z.ZodOptional<z.ZodNumber>;
+    yieldShareActive: z.ZodOptional<z.ZodBoolean>;
+    tenantYieldPercentage: z.ZodOptional<z.ZodNumber>;
+    instrumentType: z.ZodOptional<z.ZodString>;
+    custodyType: z.ZodOptional<z.ZodString>;
+    sentinelMonitoring: z.ZodOptional<z.ZodBoolean>;
+    sentinelMode: z.ZodOptional<z.ZodString>;
+    lastSentinelCheckMs: z.ZodOptional<z.ZodNumber>;
+    auditLogEnabled: z.ZodOptional<z.ZodBoolean>;
+    lastDecisionReasoning: z.ZodOptional<z.ZodString>;
+    multiSigEnabled: z.ZodOptional<z.ZodBoolean>;
+    rtbCompliantAgreement: z.ZodOptional<z.ZodBoolean>;
+    disputeResolutionEnabled: z.ZodOptional<z.ZodBoolean>;
+    wbtcUsdcRatio: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    type: "deposit-validation";
+    depositAmountCents: number;
+    monthlyRentCents: number;
+    currency: "USD" | "CAD" | "USDC";
+    leaseTermMonths?: number | undefined;
+    landlordConsentSignature?: string | undefined;
+    tenantConsentSignature?: string | undefined;
+    mutualAssentTimestamp?: number | undefined;
+    collateralType?: string | undefined;
+    collateralValueCents?: number | undefined;
+    originalDepositValueCents?: number | undefined;
+    yieldShareActive?: boolean | undefined;
+    tenantYieldPercentage?: number | undefined;
+    instrumentType?: string | undefined;
+    custodyType?: string | undefined;
+    sentinelMonitoring?: boolean | undefined;
+    sentinelMode?: string | undefined;
+    lastSentinelCheckMs?: number | undefined;
+    auditLogEnabled?: boolean | undefined;
+    lastDecisionReasoning?: string | undefined;
+    multiSigEnabled?: boolean | undefined;
+    rtbCompliantAgreement?: boolean | undefined;
+    disputeResolutionEnabled?: boolean | undefined;
+    wbtcUsdcRatio?: number | undefined;
+}, {
+    type: "deposit-validation";
+    depositAmountCents: number;
+    monthlyRentCents: number;
+    currency: "USD" | "CAD" | "USDC";
+    leaseTermMonths?: number | undefined;
+    landlordConsentSignature?: string | undefined;
+    tenantConsentSignature?: string | undefined;
+    mutualAssentTimestamp?: number | undefined;
+    collateralType?: string | undefined;
+    collateralValueCents?: number | undefined;
+    originalDepositValueCents?: number | undefined;
+    yieldShareActive?: boolean | undefined;
+    tenantYieldPercentage?: number | undefined;
+    instrumentType?: string | undefined;
+    custodyType?: string | undefined;
+    sentinelMonitoring?: boolean | undefined;
+    sentinelMode?: string | undefined;
+    lastSentinelCheckMs?: number | undefined;
+    auditLogEnabled?: boolean | undefined;
+    lastDecisionReasoning?: string | undefined;
+    multiSigEnabled?: boolean | undefined;
+    rtbCompliantAgreement?: boolean | undefined;
+    disputeResolutionEnabled?: boolean | undefined;
+    wbtcUsdcRatio?: number | undefined;
+}>;
+export type DepositValidationInput = z.infer<typeof DepositValidationInputSchema>;
+export declare const PaymentComplianceInputSchema: z.ZodObject<{
+    type: z.ZodLiteral<"payment-compliance">;
+    paymentAmountCents: z.ZodNumber;
+    monthlyRentCents: z.ZodNumber;
+    currency: z.ZodEnum<["USD", "CAD", "USDC"]>;
+    dueDate: z.ZodString;
+    paymentDate: z.ZodString;
+    lateFeeAmountCents: z.ZodOptional<z.ZodNumber>;
+    gracePeriodDays: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    type: "payment-compliance";
+    monthlyRentCents: number;
+    currency: "USD" | "CAD" | "USDC";
+    paymentAmountCents: number;
+    dueDate: string;
+    paymentDate: string;
+    lateFeeAmountCents?: number | undefined;
+    gracePeriodDays?: number | undefined;
+}, {
+    type: "payment-compliance";
+    monthlyRentCents: number;
+    currency: "USD" | "CAD" | "USDC";
+    paymentAmountCents: number;
+    dueDate: string;
+    paymentDate: string;
+    lateFeeAmountCents?: number | undefined;
+    gracePeriodDays?: number | undefined;
+}>;
+export type PaymentComplianceInput = z.infer<typeof PaymentComplianceInputSchema>;
+export declare const RentIncreaseInputSchema: z.ZodObject<{
+    type: z.ZodLiteral<"rent-increase-validation">;
+    currentRentCents: z.ZodNumber;
+    proposedRentCents: z.ZodNumber;
+    currency: z.ZodEnum<["USD", "CAD", "USDC"]>;
+    noticeDateDays: z.ZodNumber;
+    leaseType: z.ZodOptional<z.ZodEnum<["fixed", "month-to-month", "rent-controlled"]>>;
+}, "strip", z.ZodTypeAny, {
+    type: "rent-increase-validation";
+    currency: "USD" | "CAD" | "USDC";
+    currentRentCents: number;
+    proposedRentCents: number;
+    noticeDateDays: number;
+    leaseType?: "fixed" | "month-to-month" | "rent-controlled" | undefined;
+}, {
+    type: "rent-increase-validation";
+    currency: "USD" | "CAD" | "USDC";
+    currentRentCents: number;
+    proposedRentCents: number;
+    noticeDateDays: number;
+    leaseType?: "fixed" | "month-to-month" | "rent-controlled" | undefined;
+}>;
+export type RentIncreaseInput = z.infer<typeof RentIncreaseInputSchema>;
+export declare const DepositReturnInputSchema: z.ZodObject<{
+    type: z.ZodLiteral<"deposit-return">;
+    originalDepositCents: z.ZodNumber;
+    proposedReturnCents: z.ZodNumber;
+    deductionsCents: z.ZodOptional<z.ZodNumber>;
+    currency: z.ZodEnum<["USD", "CAD", "USDC"]>;
+    leaseEndDate: z.ZodString;
+    returnDate: z.ZodString;
+    itemizedDeductions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        description: z.ZodString;
+        amountCents: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        description: string;
+        amountCents: number;
+    }, {
+        description: string;
+        amountCents: number;
+    }>, "many">>;
+    interestOwedCents: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    type: "deposit-return";
+    currency: "USD" | "CAD" | "USDC";
+    originalDepositCents: number;
+    proposedReturnCents: number;
+    leaseEndDate: string;
+    returnDate: string;
+    deductionsCents?: number | undefined;
+    itemizedDeductions?: {
+        description: string;
+        amountCents: number;
+    }[] | undefined;
+    interestOwedCents?: number | undefined;
+}, {
+    type: "deposit-return";
+    currency: "USD" | "CAD" | "USDC";
+    originalDepositCents: number;
+    proposedReturnCents: number;
+    leaseEndDate: string;
+    returnDate: string;
+    deductionsCents?: number | undefined;
+    itemizedDeductions?: {
+        description: string;
+        amountCents: number;
+    }[] | undefined;
+    interestOwedCents?: number | undefined;
+}>;
+export type DepositReturnInput = z.infer<typeof DepositReturnInputSchema>;
+export declare const HomeownershipReadinessInputSchema: z.ZodObject<{
+    type: z.ZodLiteral<"homeownership-readiness">;
+    annualIncomeCents: z.ZodNumber;
+    monthlyDebtCents: z.ZodNumber;
+    creditScore: z.ZodOptional<z.ZodNumber>;
+    currentSavingsCents: z.ZodNumber;
+    targetDownPaymentCents: z.ZodNumber;
+    targetPurchaseDate: z.ZodOptional<z.ZodString>;
+    employmentMonths: z.ZodOptional<z.ZodNumber>;
+    firstTimeBuyer: z.ZodOptional<z.ZodBoolean>;
+    veteranStatus: z.ZodOptional<z.ZodBoolean>;
+    ruralArea: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    type: "homeownership-readiness";
+    annualIncomeCents: number;
+    monthlyDebtCents: number;
+    currentSavingsCents: number;
+    targetDownPaymentCents: number;
+    creditScore?: number | undefined;
+    targetPurchaseDate?: string | undefined;
+    employmentMonths?: number | undefined;
+    firstTimeBuyer?: boolean | undefined;
+    veteranStatus?: boolean | undefined;
+    ruralArea?: boolean | undefined;
+}, {
+    type: "homeownership-readiness";
+    annualIncomeCents: number;
+    monthlyDebtCents: number;
+    currentSavingsCents: number;
+    targetDownPaymentCents: number;
+    creditScore?: number | undefined;
+    targetPurchaseDate?: string | undefined;
+    employmentMonths?: number | undefined;
+    firstTimeBuyer?: boolean | undefined;
+    veteranStatus?: boolean | undefined;
+    ruralArea?: boolean | undefined;
+}>;
+export type HomeownershipReadinessInput = z.infer<typeof HomeownershipReadinessInputSchema>;
+/** Union of all skill input types */
+export declare const SkillInputSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+    type: z.ZodLiteral<"deposit-validation">;
+    depositAmountCents: z.ZodNumber;
+    monthlyRentCents: z.ZodNumber;
+    currency: z.ZodEnum<["USD", "CAD", "USDC"]>;
+    leaseTermMonths: z.ZodOptional<z.ZodNumber>;
+    landlordConsentSignature: z.ZodOptional<z.ZodString>;
+    tenantConsentSignature: z.ZodOptional<z.ZodString>;
+    mutualAssentTimestamp: z.ZodOptional<z.ZodNumber>;
+    collateralType: z.ZodOptional<z.ZodString>;
+    collateralValueCents: z.ZodOptional<z.ZodNumber>;
+    originalDepositValueCents: z.ZodOptional<z.ZodNumber>;
+    yieldShareActive: z.ZodOptional<z.ZodBoolean>;
+    tenantYieldPercentage: z.ZodOptional<z.ZodNumber>;
+    instrumentType: z.ZodOptional<z.ZodString>;
+    custodyType: z.ZodOptional<z.ZodString>;
+    sentinelMonitoring: z.ZodOptional<z.ZodBoolean>;
+    sentinelMode: z.ZodOptional<z.ZodString>;
+    lastSentinelCheckMs: z.ZodOptional<z.ZodNumber>;
+    auditLogEnabled: z.ZodOptional<z.ZodBoolean>;
+    lastDecisionReasoning: z.ZodOptional<z.ZodString>;
+    multiSigEnabled: z.ZodOptional<z.ZodBoolean>;
+    rtbCompliantAgreement: z.ZodOptional<z.ZodBoolean>;
+    disputeResolutionEnabled: z.ZodOptional<z.ZodBoolean>;
+    wbtcUsdcRatio: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    type: "deposit-validation";
+    depositAmountCents: number;
+    monthlyRentCents: number;
+    currency: "USD" | "CAD" | "USDC";
+    leaseTermMonths?: number | undefined;
+    landlordConsentSignature?: string | undefined;
+    tenantConsentSignature?: string | undefined;
+    mutualAssentTimestamp?: number | undefined;
+    collateralType?: string | undefined;
+    collateralValueCents?: number | undefined;
+    originalDepositValueCents?: number | undefined;
+    yieldShareActive?: boolean | undefined;
+    tenantYieldPercentage?: number | undefined;
+    instrumentType?: string | undefined;
+    custodyType?: string | undefined;
+    sentinelMonitoring?: boolean | undefined;
+    sentinelMode?: string | undefined;
+    lastSentinelCheckMs?: number | undefined;
+    auditLogEnabled?: boolean | undefined;
+    lastDecisionReasoning?: string | undefined;
+    multiSigEnabled?: boolean | undefined;
+    rtbCompliantAgreement?: boolean | undefined;
+    disputeResolutionEnabled?: boolean | undefined;
+    wbtcUsdcRatio?: number | undefined;
+}, {
+    type: "deposit-validation";
+    depositAmountCents: number;
+    monthlyRentCents: number;
+    currency: "USD" | "CAD" | "USDC";
+    leaseTermMonths?: number | undefined;
+    landlordConsentSignature?: string | undefined;
+    tenantConsentSignature?: string | undefined;
+    mutualAssentTimestamp?: number | undefined;
+    collateralType?: string | undefined;
+    collateralValueCents?: number | undefined;
+    originalDepositValueCents?: number | undefined;
+    yieldShareActive?: boolean | undefined;
+    tenantYieldPercentage?: number | undefined;
+    instrumentType?: string | undefined;
+    custodyType?: string | undefined;
+    sentinelMonitoring?: boolean | undefined;
+    sentinelMode?: string | undefined;
+    lastSentinelCheckMs?: number | undefined;
+    auditLogEnabled?: boolean | undefined;
+    lastDecisionReasoning?: string | undefined;
+    multiSigEnabled?: boolean | undefined;
+    rtbCompliantAgreement?: boolean | undefined;
+    disputeResolutionEnabled?: boolean | undefined;
+    wbtcUsdcRatio?: number | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"payment-compliance">;
+    paymentAmountCents: z.ZodNumber;
+    monthlyRentCents: z.ZodNumber;
+    currency: z.ZodEnum<["USD", "CAD", "USDC"]>;
+    dueDate: z.ZodString;
+    paymentDate: z.ZodString;
+    lateFeeAmountCents: z.ZodOptional<z.ZodNumber>;
+    gracePeriodDays: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    type: "payment-compliance";
+    monthlyRentCents: number;
+    currency: "USD" | "CAD" | "USDC";
+    paymentAmountCents: number;
+    dueDate: string;
+    paymentDate: string;
+    lateFeeAmountCents?: number | undefined;
+    gracePeriodDays?: number | undefined;
+}, {
+    type: "payment-compliance";
+    monthlyRentCents: number;
+    currency: "USD" | "CAD" | "USDC";
+    paymentAmountCents: number;
+    dueDate: string;
+    paymentDate: string;
+    lateFeeAmountCents?: number | undefined;
+    gracePeriodDays?: number | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"rent-increase-validation">;
+    currentRentCents: z.ZodNumber;
+    proposedRentCents: z.ZodNumber;
+    currency: z.ZodEnum<["USD", "CAD", "USDC"]>;
+    noticeDateDays: z.ZodNumber;
+    leaseType: z.ZodOptional<z.ZodEnum<["fixed", "month-to-month", "rent-controlled"]>>;
+}, "strip", z.ZodTypeAny, {
+    type: "rent-increase-validation";
+    currency: "USD" | "CAD" | "USDC";
+    currentRentCents: number;
+    proposedRentCents: number;
+    noticeDateDays: number;
+    leaseType?: "fixed" | "month-to-month" | "rent-controlled" | undefined;
+}, {
+    type: "rent-increase-validation";
+    currency: "USD" | "CAD" | "USDC";
+    currentRentCents: number;
+    proposedRentCents: number;
+    noticeDateDays: number;
+    leaseType?: "fixed" | "month-to-month" | "rent-controlled" | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"deposit-return">;
+    originalDepositCents: z.ZodNumber;
+    proposedReturnCents: z.ZodNumber;
+    deductionsCents: z.ZodOptional<z.ZodNumber>;
+    currency: z.ZodEnum<["USD", "CAD", "USDC"]>;
+    leaseEndDate: z.ZodString;
+    returnDate: z.ZodString;
+    itemizedDeductions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        description: z.ZodString;
+        amountCents: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        description: string;
+        amountCents: number;
+    }, {
+        description: string;
+        amountCents: number;
+    }>, "many">>;
+    interestOwedCents: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    type: "deposit-return";
+    currency: "USD" | "CAD" | "USDC";
+    originalDepositCents: number;
+    proposedReturnCents: number;
+    leaseEndDate: string;
+    returnDate: string;
+    deductionsCents?: number | undefined;
+    itemizedDeductions?: {
+        description: string;
+        amountCents: number;
+    }[] | undefined;
+    interestOwedCents?: number | undefined;
+}, {
+    type: "deposit-return";
+    currency: "USD" | "CAD" | "USDC";
+    originalDepositCents: number;
+    proposedReturnCents: number;
+    leaseEndDate: string;
+    returnDate: string;
+    deductionsCents?: number | undefined;
+    itemizedDeductions?: {
+        description: string;
+        amountCents: number;
+    }[] | undefined;
+    interestOwedCents?: number | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"homeownership-readiness">;
+    annualIncomeCents: z.ZodNumber;
+    monthlyDebtCents: z.ZodNumber;
+    creditScore: z.ZodOptional<z.ZodNumber>;
+    currentSavingsCents: z.ZodNumber;
+    targetDownPaymentCents: z.ZodNumber;
+    targetPurchaseDate: z.ZodOptional<z.ZodString>;
+    employmentMonths: z.ZodOptional<z.ZodNumber>;
+    firstTimeBuyer: z.ZodOptional<z.ZodBoolean>;
+    veteranStatus: z.ZodOptional<z.ZodBoolean>;
+    ruralArea: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    type: "homeownership-readiness";
+    annualIncomeCents: number;
+    monthlyDebtCents: number;
+    currentSavingsCents: number;
+    targetDownPaymentCents: number;
+    creditScore?: number | undefined;
+    targetPurchaseDate?: string | undefined;
+    employmentMonths?: number | undefined;
+    firstTimeBuyer?: boolean | undefined;
+    veteranStatus?: boolean | undefined;
+    ruralArea?: boolean | undefined;
+}, {
+    type: "homeownership-readiness";
+    annualIncomeCents: number;
+    monthlyDebtCents: number;
+    currentSavingsCents: number;
+    targetDownPaymentCents: number;
+    creditScore?: number | undefined;
+    targetPurchaseDate?: string | undefined;
+    employmentMonths?: number | undefined;
+    firstTimeBuyer?: boolean | undefined;
+    veteranStatus?: boolean | undefined;
+    ruralArea?: boolean | undefined;
+}>]>;
+export type SkillInput = z.infer<typeof SkillInputSchema>;
+export interface SkillMetadata {
+    id: string;
+    name: string;
+    description: string;
+    jurisdiction: JurisdictionCode;
+    version: string;
+    capabilities: SkillCapability[];
+    permissions: string[];
+    tags: string[];
+    author: string;
+    effectiveDate?: string;
+    federalPreemption?: boolean;
+    applicableJurisdictions?: JurisdictionCode[];
+}
+export interface HuddleSkill {
+    /** Unique identifier for this skill */
+    readonly id: string;
+    /** Human-readable name */
+    readonly name: string;
+    /** Primary jurisdiction this skill covers */
+    readonly jurisdiction: JurisdictionCode;
+    /** Semantic version */
+    readonly version: string;
+    /** What this skill can validate */
+    readonly capabilities: SkillCapability[];
+    /** Validate input against jurisdictional rules */
+    validate(input: SkillInput): Promise<SkillResult>;
+    /** Return human-readable explanation of a validation result */
+    explain(result: SkillResult): string;
+    /** Return remediation steps for a failed validation */
+    remediate(result: SkillResult): RemediationStep[];
+    /** Return full skill metadata */
+    getMetadata(): SkillMetadata;
+}
+export interface SkillRegistryInterface {
+    /** Register a skill */
+    register(skill: HuddleSkill): void;
+    /** Get a skill by jurisdiction code */
+    get(jurisdiction: JurisdictionCode): HuddleSkill | undefined;
+    /** List all registered skills */
+    list(): HuddleSkill[];
+    /** Search by capabilities */
+    search(capabilities: SkillCapability[]): HuddleSkill[];
+    /** Get all supported jurisdiction codes */
+    jurisdictions(): JurisdictionCode[];
+    /** Check if a jurisdiction is supported */
+    isSupported(jurisdiction: string): boolean;
+}
+export declare const TraigaDecisionLogSchema: z.ZodObject<{
+    timestamp: z.ZodNumber;
+    skillId: z.ZodString;
+    jurisdiction: z.ZodString;
+    inputHash: z.ZodString;
+    outputHash: z.ZodString;
+    decision: z.ZodEnum<["compliant", "non-compliant", "error"]>;
+    confidence: z.ZodNumber;
+    explanation: z.ZodOptional<z.ZodString>;
+    citations: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        statute: z.ZodString;
+        section: z.ZodString;
+        summary: z.ZodString;
+        url: z.ZodOptional<z.ZodString>;
+        effectiveDate: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        statute: string;
+        section: string;
+        summary: string;
+        url?: string | undefined;
+        effectiveDate?: string | undefined;
+    }, {
+        statute: string;
+        section: string;
+        summary: string;
+        url?: string | undefined;
+        effectiveDate?: string | undefined;
+    }>, "many">>;
+    agentId: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    confidence: number;
+    jurisdiction: string;
+    skillId: string;
+    timestamp: number;
+    inputHash: string;
+    outputHash: string;
+    decision: "compliant" | "non-compliant" | "error";
+    explanation?: string | undefined;
+    citations?: {
+        statute: string;
+        section: string;
+        summary: string;
+        url?: string | undefined;
+        effectiveDate?: string | undefined;
+    }[] | undefined;
+    agentId?: string | undefined;
+}, {
+    confidence: number;
+    jurisdiction: string;
+    skillId: string;
+    timestamp: number;
+    inputHash: string;
+    outputHash: string;
+    decision: "compliant" | "non-compliant" | "error";
+    explanation?: string | undefined;
+    citations?: {
+        statute: string;
+        section: string;
+        summary: string;
+        url?: string | undefined;
+        effectiveDate?: string | undefined;
+    }[] | undefined;
+    agentId?: string | undefined;
+}>;
+export type TraigaDecisionLog = z.infer<typeof TraigaDecisionLogSchema>;
+/** Pluggable storage adapter for TRAIGA logs */
+export interface TraigaAdapter {
+    log(entry: TraigaDecisionLog): Promise<void>;
+    query?(filters: Partial<TraigaDecisionLog>): Promise<TraigaDecisionLog[]>;
+}
+//# sourceMappingURL=index.d.ts.map