@huddle-marketplace/skills 0.2.0

package/dist/compose.js

@@ -0,0 +1,119 @@
+/**
+ * @huddle-marketplace/skills — Composition Engine
+ *
+ * Stack multiple jurisdiction skills for layered validation.
+ *
+ * Typical patterns:
+ *   Federal + State:   composeSkills(["US-CFTC", "US-TX"], input, registry)
+ *   Multi-state:       composeSkills(["US-CA", "US-NY"], input, registry)
+ *   Cross-border:      composeSkills(["US-CFTC", "CA-FINTRAC", "CA-ON"], input, registry)
+ *
+ * Architecture:
+ *   - Layers run in PARALLEL (Promise.all) — O(1) latency regardless of layer count
+ *   - Federal checks first in output by convention (pass them first in the array)
+ *   - Each check is prefixed with its source jurisdiction for full traceability
+ *   - Citations are deduplicated by statute+section across layers
+ *   - compliant = ALL layers compliant (strict mode, default)
+ *
+ * Web3-native: When US-CFTC is composed with a state skill, the federal layer validates
+ * bond structure (wBTC reserve ratio, non-custodial architecture, TRAIGA logging).
+ * The state layer adds local statutory rules (deposit cap, return timeline, late fee limits).
+ * Together they form a complete, TRAIGA-ready compliance proof for any Huddle transaction.
+ */
+// ============================================================================
+// CORE FUNCTION
+// ============================================================================
+/**
+ * Compose multiple jurisdiction skills into a single layered validation result.
+ *
+ * Designed for Web3-native use: the federal CFTC layer validates the bond structure,
+ * the state layer validates local statutory rules — together they form a complete
+ * compliance proof anchored on-chain via TRAIGA.
+ *
+ * NOTE: This is the low-level function that requires an explicit registry.
+ * Use the `composeSkills()` export from the main package entry which uses the
+ * default registry automatically.
+ *
+ * @param jurisdictions - Ordered list of jurisdiction codes (federal first by convention)
+ * @param input         - Skill input shared across all layers (amounts in CENTS)
+ * @param registry      - Registry instance to resolve skills from
+ * @param options       - Composition options
+ */
+export async function composeSkillsWithRegistry(jurisdictions, input, registry, options = {}) {
+    const { mode = "strict", criticalJurisdictions } = options;
+    if (jurisdictions.length === 0) {
+        throw new Error("composeSkills: at least one jurisdiction code is required");
+    }
+    // ── Run all layers in parallel ──────────────────────────────────────────────
+    const layerPromises = jurisdictions.map(async (jcode) => {
+        const skill = registry.get(jcode);
+        if (!skill) {
+            return {
+                compliant: false,
+                confidence: 0,
+                jurisdiction: jcode,
+                skillId: `unknown::${jcode}`,
+                skillVersion: "0.0.0",
+                checks: [{
+                        name: "jurisdiction-lookup",
+                        passed: false,
+                        confidence: 1.0,
+                        note: `Jurisdiction not registered: "${jcode}". Add it to the SkillRegistry or check the code spelling.`,
+                    }],
+                remediation: [{
+                        action: "register_jurisdiction",
+                        description: `Register a skill for jurisdiction "${jcode}" in the SkillRegistry before composing.`,
+                        urgency: "required",
+                        automatable: false,
+                    }],
+                timestamp: Date.now(),
+            };
+        }
+        return skill.validate(input);
+    });
+    const layers = await Promise.all(layerPromises);
+    // ── Merge checks — prefix with source jurisdiction for full traceability ────
+    const checks = layers.flatMap((layer, i) => layer.checks.map((c) => ({
+        ...c,
+        name: `[${jurisdictions[i]}] ${c.name}`,
+    })));
+    // ── Merge citations — deduplicate by statute+section ───────────────────────
+    const citationKey = (c) => `${c.statute}::${c.section}`;
+    const citationMap = new Map();
+    for (const layer of layers) {
+        for (const c of layer.citations ?? []) {
+            // First occurrence wins — federal citations take precedence if listed first
+            if (!citationMap.has(citationKey(c))) {
+                citationMap.set(citationKey(c), c);
+            }
+        }
+    }
+    const citations = [...citationMap.values()];
+    // ── Merge remediation ──────────────────────────────────────────────────────
+    const remediation = layers.flatMap((l) => l.remediation ?? []);
+    // ── Compute overall compliance ─────────────────────────────────────────────
+    let compliant;
+    if (mode === "strict") {
+        compliant = layers.every((l) => l.compliant);
+    }
+    else {
+        const critical = criticalJurisdictions ?? jurisdictions.map(String);
+        compliant = layers
+            .filter((_, i) => critical.includes(String(jurisdictions[i])))
+            .every((l) => l.compliant);
+    }
+    const confidence = layers.length > 0
+        ? Math.min(...layers.map((l) => l.confidence))
+        : 0;
+    return {
+        compliant,
+        confidence,
+        jurisdictions: layers.map((l) => l.jurisdiction),
+        layers,
+        checks,
+        citations,
+        remediation,
+        timestamp: Date.now(),
+    };
+}
+//# sourceMappingURL=compose.js.map

package/dist/compose.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,104 @@
+/**
+ * @huddle-marketplace/skills — 63-Jurisdiction Rental Compliance for Autonomous AI Agents
+ *
+ * The definitive skill package for the renter-to-homeowner journey.
+ * OpenClaw, MCP, LangChain, and CrewAI compatible.
+ *
+ * Usage:
+ *   import { registry, validate } from "@huddle-marketplace/skills";
+ *
+ *   // Validate a deposit in Texas
+ *   const result = await validate("US-TX", {
+ *     type: "deposit-validation",
+ *     depositAmountCents: 150000,
+ *     monthlyRentCents: 200000,
+ *     currency: "USD",
+ *   });
+ *
+ *   console.log(result.compliant);      // true
+ *   console.log(result.confidence);     // 0.9
+ *   console.log(result.citations);      // [{ statute: "Texas SB-38", ... }]
+ */
+export * from "./types/index.js";
+export { BaseSkill } from "./base.js";
+export { SkillRegistry, createRegistry } from "./registry/index.js";
+export { withTraiga, withTraigaAll, ConsoleTraigaAdapter } from "./traiga/index.js";
+export { getMCPToolDefinitions, handleMCPRequest } from "./mcp/index.js";
+export { toOpenClawSkill, toOpenClawSkills, generateSkillMd } from "./adapters/openclaw.js";
+import { SkillRegistry } from "./registry/index.js";
+import type { HuddleSkill, SkillInput, SkillResult, JurisdictionCode } from "./types/index.js";
+export type { ComposedResult, ComposeOptions } from "./compose.js";
+/**
+ * All jurisdiction skills registered in the default registry.
+ *
+ * NOTE: Lifecycle skills (homeownershipReadinessSkill, activeTenancySkill) are NOT
+ * included here because they use "US-CFTC" as their jurisdiction (a design limitation)
+ * which would overwrite the real federal CFTC skill in the registry.
+ * Use them directly via their named exports instead.
+ */
+export declare const allSkills: HuddleSkill[];
+/** Pre-loaded registry with all 63+ jurisdictions */
+export declare const registry: SkillRegistry;
+/**
+ * Quick validation helper — validate input against a jurisdiction.
+ *
+ * @param jurisdiction - Jurisdiction code (e.g., "US-TX", "CA-BC")
+ * @param input - Skill input to validate
+ * @returns Validation result
+ * @throws Error if jurisdiction is not supported
+ */
+export declare function validate(jurisdiction: JurisdictionCode | string, input: SkillInput): Promise<SkillResult>;
+/**
+ * Get human-readable explanation for a validation result.
+ */
+export declare function explain(jurisdiction: JurisdictionCode | string, result: SkillResult): string;
+/**
+ * Compose multiple jurisdiction skills into a single layered validation.
+ *
+ * Stacks federal + state validation into one compliance proof.
+ * Federal checks (US-CFTC) validate the wBTC bond structure; state checks add
+ * local statutory rules (deposit caps, return timelines, late fee limits).
+ * Results are merged with full citation deduplication and TRAIGA-ready audit trails.
+ *
+ * Layers run in parallel — O(1) latency regardless of stack depth.
+ * All checks are prefixed with source jurisdiction for full traceability.
+ *
+ * @example
+ * // wBTC bond in Texas: federal preemption + state deposit rules
+ * const result = await composeSkills(["US-CFTC", "US-TX"], {
+ *   type: "deposit-validation",
+ *   depositAmountCents: 200000,
+ *   monthlyRentCents: 200000,
+ *   currency: "USDC",
+ *   collateralType: "wbtc",
+ *   instrumentType: "collateralized_lease_guarantee",
+ *   wbtcUsdcRatio: 1.05,
+ *   custodyType: "smart_contract",
+ *   sentinelMonitoring: true,
+ *   sentinelMode: "CO_PILOT",
+ *   lastSentinelCheckMs: Date.now() - 60000,
+ *   auditLogEnabled: true,
+ *   lastDecisionReasoning: "LTV nominal",
+ * });
+ *
+ * result.compliant        // true
+ * result.confidence       // 0.9 (min across both layers)
+ * result.layers.length    // 2 — [US-CFTC result, US-TX result]
+ * result.checks[0].name   // "[US-CFTC] federal-preemption"
+ * result.citations        // merged + deduplicated across both layers
+ */
+export declare function composeSkills(jurisdictions: (JurisdictionCode | string)[], input: SkillInput, options?: import("./compose.js").ComposeOptions): Promise<import("./compose.js").ComposedResult>;
+export { usCftcSkill } from "./jurisdictions/us-cftc/index.js";
+export { usTxSkill } from "./jurisdictions/us-tx/index.js";
+export { usFlSkill } from "./jurisdictions/us-fl/index.js";
+export { usCaSkill } from "./jurisdictions/us-ca/index.js";
+export { usNySkill } from "./jurisdictions/us-ny/index.js";
+export { caBcSkill } from "./jurisdictions/ca-bc/index.js";
+export { caOnSkill } from "./jurisdictions/ca-on/index.js";
+export { caQcSkill } from "./jurisdictions/ca-qc/index.js";
+export { caNsSkill } from "./jurisdictions/ca-ns/index.js";
+export { usStateSkillsArray, getUSStateSkill } from "./jurisdictions/us-state-factory.js";
+export { canadianTemplateSkills } from "./jurisdictions/canadian-template.js";
+export { homeownershipReadinessSkill } from "./jurisdictions/lifecycle/homeownership-readiness.js";
+export { activeTenancySkill, ActiveTenancySkill, activeTenancySkills } from "./jurisdictions/lifecycle/active-tenancy.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;;;;;;;;;;;;;;;;;;;;GAoBG;AAGH,cAAc,kBAAkB,CAAC;AAGjC,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAGtC,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAGpE,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAGpF,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAGzE,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAmC5F,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAE/F,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnE;;;;;;;GAOG;AACH,eAAO,MAAM,SAAS,EAAE,WAAW,EAmBlC,CAAC;AAEF,qDAAqD;AACrD,eAAO,MAAM,QAAQ,eAAsB,CAAC;AAM5C;;;;;;;GAOG;AACH,wBAAsB,QAAQ,CAC5B,YAAY,EAAE,gBAAgB,GAAG,MAAM,EACvC,KAAK,EAAE,UAAU,GAChB,OAAO,CAAC,WAAW,CAAC,CAStB;AAED;;GAEG;AACH,wBAAgB,OAAO,CACrB,YAAY,EAAE,gBAAgB,GAAG,MAAM,EACvC,MAAM,EAAE,WAAW,GAClB,MAAM,CAMR;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAsB,aAAa,CACjC,aAAa,EAAE,CAAC,gBAAgB,GAAG,MAAM,CAAC,EAAE,EAC5C,KAAK,EAAE,UAAU,EACjB,OAAO,CAAC,EAAE,OAAO,cAAc,EAAE,cAAc,GAC9C,OAAO,CAAC,OAAO,cAAc,EAAE,cAAc,CAAC,CAEhD;AAGD,OAAO,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAC/D,OAAO,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAC3D,OAAO,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAC3D,OAAO,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAC3D,OAAO,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAC3D,OAAO,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAC3D,OAAO,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAC3D,OAAO,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAC3D,OAAO,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AAC1F,OAAO,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AAC9E,OAAO,EAAE,2BAA2B,EAAE,MAAM,sDAAsD,CAAC;AACnG,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,6CAA6C,CAAC"}

package/dist/index.js

@@ -0,0 +1,167 @@
+/**
+ * @huddle-marketplace/skills — 63-Jurisdiction Rental Compliance for Autonomous AI Agents
+ *
+ * The definitive skill package for the renter-to-homeowner journey.
+ * OpenClaw, MCP, LangChain, and CrewAI compatible.
+ *
+ * Usage:
+ *   import { registry, validate } from "@huddle-marketplace/skills";
+ *
+ *   // Validate a deposit in Texas
+ *   const result = await validate("US-TX", {
+ *     type: "deposit-validation",
+ *     depositAmountCents: 150000,
+ *     monthlyRentCents: 200000,
+ *     currency: "USD",
+ *   });
+ *
+ *   console.log(result.compliant);      // true
+ *   console.log(result.confidence);     // 0.9
+ *   console.log(result.citations);      // [{ statute: "Texas SB-38", ... }]
+ */
+// Re-export all types
+export * from "./types/index.js";
+// Re-export base class
+export { BaseSkill } from "./base.js";
+// Re-export registry
+export { SkillRegistry, createRegistry } from "./registry/index.js";
+// Re-export TRAIGA
+export { withTraiga, withTraigaAll, ConsoleTraigaAdapter } from "./traiga/index.js";
+// Re-export MCP
+export { getMCPToolDefinitions, handleMCPRequest } from "./mcp/index.js";
+// Re-export OpenClaw adapter
+export { toOpenClawSkill, toOpenClawSkills, generateSkillMd } from "./adapters/openclaw.js";
+// ============================================================================
+// Import all jurisdiction skills
+// ============================================================================
+// Federal
+import { usCftcSkill } from "./jurisdictions/us-cftc/index.js";
+// US States with custom implementations
+import { usTxSkill } from "./jurisdictions/us-tx/index.js";
+import { usFlSkill } from "./jurisdictions/us-fl/index.js";
+import { usCaSkill } from "./jurisdictions/us-ca/index.js";
+import { usNySkill } from "./jurisdictions/us-ny/index.js";
+// US States from factory (46 states — TX, FL, CA, NY have custom skills)
+import { usStateSkillsArray } from "./jurisdictions/us-state-factory.js";
+// Canadian provinces with custom implementations
+import { caBcSkill } from "./jurisdictions/ca-bc/index.js";
+import { caOnSkill } from "./jurisdictions/ca-on/index.js";
+import { caQcSkill } from "./jurisdictions/ca-qc/index.js";
+import { caNsSkill } from "./jurisdictions/ca-ns/index.js";
+// Canadian provinces from template
+import { canadianTemplateSkills } from "./jurisdictions/canadian-template.js";
+// ============================================================================
+// Build and export the default registry
+// ============================================================================
+import { SkillRegistry } from "./registry/index.js";
+import { composeSkillsWithRegistry } from "./compose.js";
+/**
+ * All jurisdiction skills registered in the default registry.
+ *
+ * NOTE: Lifecycle skills (homeownershipReadinessSkill, activeTenancySkill) are NOT
+ * included here because they use "US-CFTC" as their jurisdiction (a design limitation)
+ * which would overwrite the real federal CFTC skill in the registry.
+ * Use them directly via their named exports instead.
+ */
+export const allSkills = [
+    // Federal
+    usCftcSkill,
+    // US custom (Tier 1 high-traffic states)
+    usTxSkill,
+    usFlSkill,
+    usCaSkill,
+    usNySkill,
+    // US factory (46 remaining states)
+    ...usStateSkillsArray.filter((s) => !["US-TX", "US-FL", "US-CA", "US-NY"].includes(s.jurisdiction)),
+    // CA custom
+    caBcSkill,
+    caOnSkill,
+    caQcSkill,
+    caNsSkill,
+    // CA template (9 provinces)
+    ...canadianTemplateSkills,
+];
+/** Pre-loaded registry with all 63+ jurisdictions */
+export const registry = new SkillRegistry();
+for (const skill of allSkills) {
+    registry.register(skill);
+}
+/**
+ * Quick validation helper — validate input against a jurisdiction.
+ *
+ * @param jurisdiction - Jurisdiction code (e.g., "US-TX", "CA-BC")
+ * @param input - Skill input to validate
+ * @returns Validation result
+ * @throws Error if jurisdiction is not supported
+ */
+export async function validate(jurisdiction, input) {
+    const skill = registry.get(jurisdiction);
+    if (!skill) {
+        throw new Error(`Unsupported jurisdiction: ${jurisdiction}. ` +
+            `Supported: ${registry.jurisdictions().join(", ")}`);
+    }
+    return skill.validate(input);
+}
+/**
+ * Get human-readable explanation for a validation result.
+ */
+export function explain(jurisdiction, result) {
+    const skill = registry.get(jurisdiction);
+    if (!skill) {
+        throw new Error(`Unsupported jurisdiction: ${jurisdiction}`);
+    }
+    return skill.explain(result);
+}
+/**
+ * Compose multiple jurisdiction skills into a single layered validation.
+ *
+ * Stacks federal + state validation into one compliance proof.
+ * Federal checks (US-CFTC) validate the wBTC bond structure; state checks add
+ * local statutory rules (deposit caps, return timelines, late fee limits).
+ * Results are merged with full citation deduplication and TRAIGA-ready audit trails.
+ *
+ * Layers run in parallel — O(1) latency regardless of stack depth.
+ * All checks are prefixed with source jurisdiction for full traceability.
+ *
+ * @example
+ * // wBTC bond in Texas: federal preemption + state deposit rules
+ * const result = await composeSkills(["US-CFTC", "US-TX"], {
+ *   type: "deposit-validation",
+ *   depositAmountCents: 200000,
+ *   monthlyRentCents: 200000,
+ *   currency: "USDC",
+ *   collateralType: "wbtc",
+ *   instrumentType: "collateralized_lease_guarantee",
+ *   wbtcUsdcRatio: 1.05,
+ *   custodyType: "smart_contract",
+ *   sentinelMonitoring: true,
+ *   sentinelMode: "CO_PILOT",
+ *   lastSentinelCheckMs: Date.now() - 60000,
+ *   auditLogEnabled: true,
+ *   lastDecisionReasoning: "LTV nominal",
+ * });
+ *
+ * result.compliant        // true
+ * result.confidence       // 0.9 (min across both layers)
+ * result.layers.length    // 2 — [US-CFTC result, US-TX result]
+ * result.checks[0].name   // "[US-CFTC] federal-preemption"
+ * result.citations        // merged + deduplicated across both layers
+ */
+export async function composeSkills(jurisdictions, input, options) {
+    return composeSkillsWithRegistry(jurisdictions, input, registry, options);
+}
+// Re-export individual skills for direct access
+export { usCftcSkill } from "./jurisdictions/us-cftc/index.js";
+export { usTxSkill } from "./jurisdictions/us-tx/index.js";
+export { usFlSkill } from "./jurisdictions/us-fl/index.js";
+export { usCaSkill } from "./jurisdictions/us-ca/index.js";
+export { usNySkill } from "./jurisdictions/us-ny/index.js";
+export { caBcSkill } from "./jurisdictions/ca-bc/index.js";
+export { caOnSkill } from "./jurisdictions/ca-on/index.js";
+export { caQcSkill } from "./jurisdictions/ca-qc/index.js";
+export { caNsSkill } from "./jurisdictions/ca-ns/index.js";
+export { usStateSkillsArray, getUSStateSkill } from "./jurisdictions/us-state-factory.js";
+export { canadianTemplateSkills } from "./jurisdictions/canadian-template.js";
+export { homeownershipReadinessSkill } from "./jurisdictions/lifecycle/homeownership-readiness.js";
+export { activeTenancySkill, ActiveTenancySkill, activeTenancySkills } from "./jurisdictions/lifecycle/active-tenancy.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":"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"}

package/dist/jurisdictions/ca-bc/index.d.ts

@@ -0,0 +1,49 @@
+/**
+ * CA-BC — British Columbia Residential Tenancy Act
+ *
+ * BC has stringent tenant protection laws:
+ * - Security deposits limited to 50% of monthly rent (RTA s.19(1))
+ * - Mutual written consent required for deposit investment (RTA s.19)
+ * - 100% principal protection required at all times (RTA s.20)
+ * - Tenants entitled to interest on deposits (RTA s.19(3))
+ * - RTB (Residential Tenancy Branch) compliance required
+ * - Dispute resolution must be available
+ */
+import { BaseSkill } from "../../base.js";
+import type { SkillInput, SkillResult, SkillCheck, SkillCapability, RemediationStep } from "../../types/index.js";
+export declare class CABCSkill extends BaseSkill {
+    readonly id = "huddle-compliance-ca-bc";
+    readonly name = "British Columbia Residential Tenancy Act";
+    readonly jurisdiction: "CA-BC";
+    readonly version = "1.0.0";
+    readonly capabilities: SkillCapability[];
+    validate(input: SkillInput): Promise<SkillResult>;
+    /**
+     * BC RTA Section 19: Mutual Assent Requirement
+     * Both landlord and tenant must explicitly consent to deposit investment
+     */
+    private checkMutualAssent;
+    /**
+     * BC RTA Section 20: Principal Protection Guarantee
+     * Full deposit value must be available for return at all times
+     */
+    private checkPrincipalProtection;
+    /**
+     * BC RTA Section 19(1): Deposit Limit
+     * Security deposit cannot exceed 50% of monthly rent
+     */
+    private checkDepositLimit;
+    /**
+     * BC RTA Section 19(3): Interest Sharing
+     * Tenants are entitled to interest earned on deposits
+     */
+    private checkInterestSharing;
+    /**
+     * BC RTB Compliance
+     * Agreement must comply with RTB standards and provide dispute resolution
+     */
+    private checkRTBCompliance;
+    protected checkToRemediation(check: SkillCheck): RemediationStep;
+}
+export declare const caBcSkill: CABCSkill;
+//# sourceMappingURL=index.d.ts.map

package/dist/jurisdictions/ca-bc/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/jurisdictions/ca-bc/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,KAAK,EACV,UAAU,EACV,WAAW,EACX,UAAU,EACV,eAAe,EAEf,eAAe,EAChB,MAAM,sBAAsB,CAAC;AAE9B,qBAAa,SAAU,SAAQ,SAAS;IACtC,QAAQ,CAAC,EAAE,6BAA6B;IACxC,QAAQ,CAAC,IAAI,8CAA8C;IAC3D,QAAQ,CAAC,YAAY,EAAG,OAAO,CAAU;IACzC,QAAQ,CAAC,OAAO,WAAW;IAC3B,QAAQ,CAAC,YAAY,EAAE,eAAe,EAAE,CAItC;IAEI,QAAQ,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC;IAsBvD;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IA8BzB;;;OAGG;IACH,OAAO,CAAC,wBAAwB;IA0BhC;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IA2BzB;;;OAGG;IACH,OAAO,CAAC,oBAAoB;IA2B5B;;;OAGG;IACH,OAAO,CAAC,kBAAkB;cAqBP,kBAAkB,CAAC,KAAK,EAAE,UAAU,GAAG,eAAe;CA2B1E;AAED,eAAO,MAAM,SAAS,WAAkB,CAAC"}