@wowok/agent-mcp 2.4.3 → 2.5.0

package/dist/knowledge/arbitration-ledger.js

@@ -0,0 +1,521 @@
+export const ARB_STATUS_CODE = {
+    Principal_confirming: 0,
+    Arbitrator_confirming: 1,
+    Voting: 2,
+    Arbitrated: 3,
+    Objectionable: 4,
+    Finished: 5,
+    Withdrawn: 6,
+};
+export const ARB_TERMINAL_STATUSES = ["Finished", "Withdrawn"];
+export const ARB_STATUS_ALIASES = {
+    created: "Principal_confirming",
+    voting: "Voting",
+    feedback: "Arbitrator_confirming",
+    confirmed: "Arbitrated",
+    completed: "Finished",
+    reset: "Objectionable",
+    disputed: "Withdrawn",
+};
+export const ARBITRATION_PERMISSIONS = [
+    {
+        index: 350,
+        name: "ARBITRATION_NEW",
+        description: "Create new Arbitration object",
+        governed_operations: ["arbitration::new", "arbitration::new_with_passport"],
+    },
+    {
+        index: 351,
+        name: "ARBITRATION_DESCRIPTION",
+        description: "Modify Arbitration description",
+        governed_operations: ["arbitration::description_set", "arbitration::description_set_with_passport"],
+    },
+    {
+        index: 352,
+        name: "ARBITRATION_ENDPOINT",
+        description: "Reserved placeholder — not used on-chain (SDK commented out)",
+        governed_operations: [],
+        is_reserved: true,
+    },
+    {
+        index: 353,
+        name: "ARBITRATION_LOCATION",
+        description: "Set Arbitration location",
+        governed_operations: ["arbitration::location_set", "arbitration::location_set_with_passport"],
+    },
+    {
+        index: 354,
+        name: "ARBITRATION_VOTING_GUARD",
+        description: "Manage voting_guard list (add / remove / clear) — controls vote weight",
+        governed_operations: [
+            "arbitration::voting_guard_by_id_add",
+            "arbitration::voting_guard_fixed_add",
+            "arbitration::voting_guard_remove",
+            "arbitration::voting_guard_clear",
+            "(+ _with_passport variants)",
+        ],
+    },
+    {
+        index: 355,
+        name: "ARBITRATION_USAGE_GUARD",
+        description: "Set / clear usage_guard — controls who can file disputes",
+        governed_operations: [
+            "arbitration::usage_guard_set",
+            "arbitration::usage_guard_none",
+            "(+ _with_passport variants)",
+        ],
+    },
+    {
+        index: 356,
+        name: "ARBITRATION_PAUSE",
+        description: "Pause / resume Arbitration (bPaused default true)",
+        governed_operations: ["arbitration::pause", "arbitration::pause_with_passport"],
+    },
+    {
+        index: 357,
+        name: "ARBITRATION_FEE",
+        description: "Set dispute application fee (u64)",
+        governed_operations: ["arbitration::fee_set", "arbitration::fee_set_with_passport"],
+    },
+    {
+        index: 358,
+        name: "ARBITRATION_VOTE",
+        description: "Open vote (no voting_guard configured — 1 person 1 vote)",
+        governed_operations: ["arbitration::vote", "arbitration::vote_with_passport"],
+    },
+    {
+        index: 359,
+        name: "ARBITRATION_ARBITRATION",
+        description: "Make definitive arbitration ruling (with indemnity)",
+        governed_operations: ["arbitration::arbitration", "arbitration::arbitration_with_passport"],
+    },
+    {
+        index: 360,
+        name: "ARBITRATION_FEEDBACK",
+        description: "Provide feedback on Arb case",
+        governed_operations: ["arbitration::feedback", "arbitration::feedback_with_passport"],
+    },
+    {
+        index: 361,
+        name: "ARBITRATION_CONFIRM",
+        description: "Confirm materials submitted by principal (starts voting phase)",
+        governed_operations: ["arbitration::confirm", "arbitration::confirm_with_passport"],
+    },
+    {
+        index: 362,
+        name: "ARBITRATION_VOTING_DEADLINE_CHANGE",
+        description: "Change voting deadline for an Arb case",
+        governed_operations: ["arbitration::voting_deadline_change", "arbitration::voting_deadline_change_with_passport"],
+    },
+    {
+        index: 363,
+        name: "ARBITRATION_RESET",
+        description: "Reset arbitration — principal resubmits materials, restart lifecycle",
+        governed_operations: ["arbitration::reset", "arbitration::reset_with_passport"],
+    },
+    {
+        index: 364,
+        name: "ARBITRATION_ARB_WITHDRAW",
+        description: "Withdraw arbitration fees from Arb into Arbitration.balance",
+        governed_operations: ["arbitration::arb_withdraw", "arbitration::arb_withdraw_with_passport"],
+    },
+    {
+        index: 365,
+        name: "ARBITRATION_FEES_ALLOC",
+        description: "Allocate arbitration fees to Allocation object",
+        governed_operations: ["arbitration::fees_alloc", "arbitration::fees_alloc_with_passport"],
+    },
+    {
+        index: 366,
+        name: "ARBITRATION_FEES_TRANSFER",
+        description: "Transfer arbitration fees to Treasury object",
+        governed_operations: ["arbitration::fees_transfer", "arbitration::fees_transfer_with_passport"],
+    },
+    {
+        index: 367,
+        name: "ARBITRATION_OWNER_RECEIVE",
+        description: "Owner receive (unwrap received Coin/Object and send to Permission owner)",
+        governed_operations: ["arbitration::owner_receive", "arbitration::owner_receive_object"],
+    },
+    {
+        index: 368,
+        name: "ARBITRATION_UM",
+        description: "Set / clear User Manager (Contact object)",
+        governed_operations: ["arbitration::um_set", "arbitration::um_none", "(+ _with_passport variants)"],
+    },
+];
+export const DUAL_GUARD_MATRIX = [
+    {
+        voting_guard_empty: true,
+        usage_guard_none: true,
+        dispute_method: "dispute",
+        vote_method: "vote",
+        scenario: "Open dispute + open voting (1 person 1 vote)",
+    },
+    {
+        voting_guard_empty: true,
+        usage_guard_none: false,
+        dispute_method: "dispute_with_passport",
+        vote_method: "vote",
+        scenario: "Restricted dispute + open voting",
+    },
+    {
+        voting_guard_empty: false,
+        usage_guard_none: true,
+        dispute_method: "dispute",
+        vote_method: "vote_with_voting_guard",
+        scenario: "Open dispute + weighted voting",
+    },
+    {
+        voting_guard_empty: false,
+        usage_guard_none: false,
+        dispute_method: "dispute_with_passport",
+        vote_method: "vote_with_voting_guard",
+        scenario: "Restricted dispute + weighted voting (most controlled)",
+    },
+];
+export const ARBITRATION_SCENES = [
+    {
+        id: "arbitration_create",
+        name: "Create new Arbitration service",
+        operation_category: "lifecycle",
+        permission_index: 350,
+        permission_name: "ARBITRATION_NEW",
+        requires_voting_guard: "any",
+        requires_usage_guard: "any",
+        has_passport_variant: true,
+        governed_operations: ["arbitration::new", "arbitration::new_with_passport"],
+        common_patterns: [
+            "Pre-publish config: create Arbitration + Permission together",
+            "bPaused defaults to true — must call pause(false) to enable",
+            "Generic T: choose Coin type (e.g. 0x2::wow::WOW) at creation",
+            "Registrar affiliation: permission + arbitration linked via Registrar",
+        ],
+        recommended_templates: ["T-AB-01", "T-AB-02"],
+    },
+    {
+        id: "arbitration_dispute",
+        name: "File dispute against an Order (creates Arb case)",
+        operation_category: "dispute",
+        permission_index: 0,
+        permission_name: "(order op permission — no ARBITRATION_* index)",
+        required_arb_status: [],
+        resulting_arb_status: "Principal_confirming",
+        requires_voting_guard: "any",
+        requires_usage_guard: "any",
+        has_passport_variant: true,
+        governed_operations: ["arbitration::dispute", "arbitration::dispute_with_passport"],
+        common_patterns: [
+            "Fee gate: coin::value(&fee) >= self.fee, else E_FEE_NOT_ENOUGH",
+            "Order op permission: order::assert_op_permission(order, ctx) required",
+            "Creates independent Arb<T> object with its own lifecycle",
+            "If usage_guard is Some → must use dispute_with_passport",
+            "Order.dispute list: appends new Arb (max 10 per Order)",
+        ],
+        recommended_templates: ["T-AB-01", "T-AB-03", "T-AB-04"],
+    },
+    {
+        id: "arbitration_vote",
+        name: "Vote on Arb propositions",
+        operation_category: "voting",
+        permission_index: 358,
+        permission_name: "ARBITRATION_VOTE",
+        required_arb_status: ["Voting"],
+        requires_voting_guard: "any",
+        requires_usage_guard: "not_applicable",
+        has_passport_variant: true,
+        governed_operations: [
+            "arbitration::vote",
+            "arbitration::vote_with_passport",
+            "arbitration::vote_with_voting_guard",
+        ],
+        common_patterns: [
+            "Open vote: voting_guard empty → vote() / vote_with_passport()",
+            "Weighted vote: voting_guard non-empty → vote_with_voting_guard()",
+            "votes: u8 array — index into proposition list (0..N-1)",
+            "Mismatch: vote() with non-empty voting_guard → E_VOTING_GUARD_USED",
+            "Guard not in list: E_VOTING_GUARD_NOT_FOUND",
+        ],
+        recommended_templates: ["T-AB-02", "T-AB-03"],
+    },
+    {
+        id: "arbitration_confirm",
+        name: "Confirm principal materials and start voting phase",
+        operation_category: "ruling",
+        permission_index: 361,
+        permission_name: "ARBITRATION_CONFIRM",
+        required_arb_status: ["Principal_confirming", "Arbitrator_confirming"],
+        resulting_arb_status: "Voting",
+        requires_voting_guard: "any",
+        requires_usage_guard: "not_applicable",
+        has_passport_variant: true,
+        governed_operations: ["arbitration::confirm", "arbitration::confirm_with_passport"],
+        common_patterns: [
+            "Transitions Arb from Principal_confirming → Voting",
+            "voting_deadline: u64 timestamp_ms (null = no deadline)",
+            "Once in Voting, only vote / voting_deadline_change / reset allowed",
+        ],
+        recommended_templates: ["T-AB-01", "T-AB-02"],
+    },
+    {
+        id: "arbitration_feedback",
+        name: "Provide feedback on Arb case",
+        operation_category: "ruling",
+        permission_index: 360,
+        permission_name: "ARBITRATION_FEEDBACK",
+        required_arb_status: ["Principal_confirming", "Arbitrator_confirming", "Voting", "Arbitrated", "Objectionable"],
+        requires_voting_guard: "not_applicable",
+        requires_usage_guard: "not_applicable",
+        has_passport_variant: true,
+        governed_operations: ["arbitration::feedback", "arbitration::feedback_with_passport"],
+        common_patterns: [
+            "Feedback is informational — does not change Arb status",
+            "Used by principal / arbitrator / voters to attach notes",
+            "No state transition; supplements the case record",
+        ],
+        recommended_templates: ["T-AB-01", "T-AB-07"],
+    },
+    {
+        id: "arbitration_ruling",
+        name: "Make definitive arbitration ruling with indemnity",
+        operation_category: "ruling",
+        permission_index: 359,
+        permission_name: "ARBITRATION_ARBITRATION",
+        required_arb_status: ["Voting", "Arbitrated", "Objectionable"],
+        resulting_arb_status: "Arbitrated",
+        requires_voting_guard: "any",
+        requires_usage_guard: "not_applicable",
+        has_passport_variant: true,
+        governed_operations: ["arbitration::arbitration", "arbitration::arbitration_with_passport"],
+        common_patterns: [
+            "Ruling produces: feedback (string) + indemnity (u64)",
+            "indemnity is compensation amount — paid via order::compensate",
+            "compensate is public(package) — only order.move can trigger it",
+            "Once Arbitrated, case enters Objectionable window (reset possible)",
+        ],
+        recommended_templates: ["T-AB-01", "T-AB-05"],
+    },
+    {
+        id: "arbitration_reset",
+        name: "Reset arbitration — principal resubmits materials",
+        operation_category: "ruling",
+        permission_index: 363,
+        permission_name: "ARBITRATION_RESET",
+        required_arb_status: ["Objectionable", "Arbitrated"],
+        resulting_arb_status: "Principal_confirming",
+        requires_voting_guard: "any",
+        requires_usage_guard: "not_applicable",
+        has_passport_variant: true,
+        governed_operations: ["arbitration::reset", "arbitration::reset_with_passport"],
+        common_patterns: [
+            "Resets Arb from Objectionable/Arbitrated → Principal_confirming",
+            "Used when principal objects to ruling and resubmits materials",
+            "Feedback required (string explaining reset reason)",
+            "Restart full lifecycle: Principal_confirming → ... → Finished",
+        ],
+        recommended_templates: ["T-AB-07"],
+    },
+    {
+        id: "arbitration_arb_withdraw",
+        name: "Withdraw arbitration fees from Arb into Arbitration.balance",
+        operation_category: "fund",
+        permission_index: 364,
+        permission_name: "ARBITRATION_ARB_WITHDRAW",
+        required_arb_status: ["Finished", "Withdrawn"],
+        requires_voting_guard: "not_applicable",
+        requires_usage_guard: "not_applicable",
+        has_passport_variant: true,
+        governed_operations: ["arbitration::arb_withdraw", "arbitration::arb_withdraw_with_passport"],
+        common_patterns: [
+            "Calls arb::withdraw(arb, clock) — moves fees from Arb to Arbitration",
+            "Only allowed after Arb reaches terminal state (Finished/Withdrawn)",
+            "Increases Arbitration.balance — funds available for fees_alloc/fees_transfer",
+        ],
+        recommended_templates: ["T-AB-06"],
+    },
+    {
+        id: "arbitration_fees_alloc",
+        name: "Allocate arbitration fees to Allocation object",
+        operation_category: "fund",
+        permission_index: 365,
+        permission_name: "ARBITRATION_FEES_ALLOC",
+        requires_voting_guard: "not_applicable",
+        requires_usage_guard: "not_applicable",
+        has_passport_variant: true,
+        governed_operations: ["arbitration::fees_alloc", "arbitration::fees_alloc_with_passport"],
+        common_patterns: [
+            "Destination: Allocation object (parameterized fund distribution)",
+            "payment_remark + payment_index: bookkeeping for Payment object",
+            "May create new Payment object if newPayment name provided",
+            "Triggers balance::withdraw_all — extracts ALL balance",
+        ],
+        recommended_templates: ["T-AB-06"],
+    },
+    {
+        id: "arbitration_fees_transfer",
+        name: "Transfer arbitration fees to Treasury object",
+        operation_category: "fund",
+        permission_index: 366,
+        permission_name: "ARBITRATION_FEES_TRANSFER",
+        requires_voting_guard: "not_applicable",
+        requires_usage_guard: "not_applicable",
+        has_passport_variant: true,
+        governed_operations: ["arbitration::fees_transfer", "arbitration::fees_transfer_with_passport"],
+        common_patterns: [
+            "Destination: Treasury object (general fund pool)",
+            "Same bookkeeping as fees_alloc (remark + index + newPayment)",
+            "Triggers balance::withdraw_all — extracts ALL balance",
+            "Choose Allocation vs Treasury by distribution need",
+        ],
+        recommended_templates: ["T-AB-06"],
+    },
+    {
+        id: "arbitration_voting_guard_config",
+        name: "Configure voting_guard list (add / set / remove / clear)",
+        operation_category: "guard",
+        permission_index: 354,
+        permission_name: "ARBITRATION_VOTING_GUARD",
+        requires_voting_guard: "any",
+        requires_usage_guard: "not_applicable",
+        has_passport_variant: true,
+        governed_operations: [
+            "arbitration::voting_guard_by_id_add (+ _with_passport)",
+            "arbitration::voting_guard_fixed_add (+ _with_passport)",
+            "arbitration::voting_guard_remove (+ _with_passport)",
+            "arbitration::voting_guard_clear (+ _with_passport)",
+        ],
+        common_patterns: [
+            "Max 50 guards: MAX_VOTING_GUARD_COUNT=50 (off-by-one-safe: len<50 allows add)",
+            "GuardIdentifier(u8): dynamic weight from Passport submission value",
+            "FixedValue(u32): static weight (e.g. 100 votes per holder)",
+            "Add same guard twice → updates vote_weight (no duplicate)",
+            "op='set' = clear then add; op='add' = append; op='remove' = by address",
+        ],
+        recommended_templates: ["T-AB-02", "T-AB-03"],
+    },
+    {
+        id: "arbitration_usage_guard_config",
+        name: "Configure usage_guard (set / clear)",
+        operation_category: "guard",
+        permission_index: 355,
+        permission_name: "ARBITRATION_USAGE_GUARD",
+        requires_voting_guard: "not_applicable",
+        requires_usage_guard: "any",
+        has_passport_variant: true,
+        governed_operations: [
+            "arbitration::usage_guard_set (+ _with_passport)",
+            "arbitration::usage_guard_none (+ _with_passport)",
+        ],
+        common_patterns: [
+            "Single guard (Option<address>) — not a list",
+            "Some(guard): dispute must use _with_passport variant",
+            "None: dispute can use either variant (no passport needed)",
+            "Registrar affiliation_change: updates link when guard changes",
+        ],
+        recommended_templates: ["T-AB-04"],
+    },
+    {
+        id: "arbitration_pause",
+        name: "Pause / resume Arbitration service",
+        operation_category: "lifecycle",
+        permission_index: 356,
+        permission_name: "ARBITRATION_PAUSE",
+        requires_voting_guard: "not_applicable",
+        requires_usage_guard: "not_applicable",
+        has_passport_variant: true,
+        governed_operations: ["arbitration::pause", "arbitration::pause_with_passport"],
+        common_patterns: [
+            "bPaused default true — new Arbitration cannot accept disputes",
+            "pause(false) to enable, pause(true) to disable",
+            "Paused Arbitration rejects dispute (E_PAUSED)",
+            "Does not affect already-open Arb cases",
+        ],
+        recommended_templates: ["T-AB-01"],
+    },
+];
+export const ARBITRATION_LEDGER_VERSION = "1.0.0";
+export function getScenesByCategory(category) {
+    return ARBITRATION_SCENES.filter(s => s.operation_category === category);
+}
+export function findSceneById(id) {
+    return ARBITRATION_SCENES.find(s => s.id === id);
+}
+export function findSceneByPermissionIndex(index) {
+    return ARBITRATION_SCENES.find(s => s.permission_index === index);
+}
+export function getPermissionByIndex(index) {
+    return ARBITRATION_PERMISSIONS.find(p => p.index === index);
+}
+export function getPermissionByName(name) {
+    return ARBITRATION_PERMISSIONS.find(p => p.name === name);
+}
+export function isReservedIndex(index) {
+    const entry = getPermissionByIndex(index);
+    return !!entry?.is_reserved;
+}
+export function isUsedPermissionIndex(index) {
+    const entry = getPermissionByIndex(index);
+    return !!entry && !entry.is_reserved;
+}
+export function getActivePermissionCount() {
+    return ARBITRATION_PERMISSIONS.filter(p => !p.is_reserved).length;
+}
+export function inferSceneFromIntent(intent) {
+    const lower = intent.toLowerCase();
+    const keywordMap = [
+        { keywords: ["create", "new"], sceneId: "arbitration_create" },
+        { keywords: ["dispute", "file", "complaint"], sceneId: "arbitration_dispute" },
+        { keywords: ["vote", "voting", "decide"], sceneId: "arbitration_vote" },
+        { keywords: ["confirm", "materials"], sceneId: "arbitration_confirm" },
+        { keywords: ["feedback", "opinion"], sceneId: "arbitration_feedback" },
+        { keywords: ["ruling", "arbitration", "verdict"], sceneId: "arbitration_ruling" },
+        { keywords: ["reset", "resubmit"], sceneId: "arbitration_reset" },
+        { keywords: ["arb_withdraw", "withdraw", "withdraw fees"], sceneId: "arbitration_arb_withdraw" },
+        { keywords: ["fees_alloc", "allocate", "allocate fees"], sceneId: "arbitration_fees_alloc" },
+        { keywords: ["fees_transfer", "transfer", "transfer in"], sceneId: "arbitration_fees_transfer" },
+        { keywords: ["voting_guard", "voting guard"], sceneId: "arbitration_voting_guard_config" },
+        { keywords: ["usage_guard", "usage guard"], sceneId: "arbitration_usage_guard_config" },
+        { keywords: ["pause", "enable"], sceneId: "arbitration_pause" },
+    ];
+    for (const { keywords, sceneId } of keywordMap) {
+        if (keywords.some(kw => lower.includes(kw.toLowerCase()))) {
+            const scene = findSceneById(sceneId);
+            if (scene)
+                return scene;
+        }
+    }
+    return undefined;
+}
+export function getDualGuardMatrixEntry(votingGuardEmpty, usageGuardNone) {
+    return DUAL_GUARD_MATRIX.find(m => m.voting_guard_empty === votingGuardEmpty && m.usage_guard_none === usageGuardNone);
+}
+export function isValidArbStatusTransition(from, to) {
+    const transitions = {
+        Principal_confirming: ["Arbitrator_confirming", "Voting"],
+        Arbitrator_confirming: ["Voting", "Principal_confirming"],
+        Voting: ["Arbitrated"],
+        Arbitrated: ["Objectionable", "Finished"],
+        Objectionable: ["Principal_confirming", "Finished"],
+        Finished: ["Withdrawn"],
+        Withdrawn: [],
+    };
+    return transitions[from]?.includes(to) ?? false;
+}
+export function isTerminalArbStatus(status) {
+    return ARB_TERMINAL_STATUSES.includes(status);
+}
+export function getScenesProducingStatus(status) {
+    return ARBITRATION_SCENES.filter(s => s.resulting_arb_status === status);
+}
+export function getScenesRequiringStatus(status) {
+    return ARBITRATION_SCENES.filter(s => s.required_arb_status?.includes(status));
+}
+export function getArbitrationScenesCount() {
+    return ARBITRATION_SCENES.length;
+}
+export function getAllArbitrationPermissions() {
+    return [...ARBITRATION_PERMISSIONS];
+}
+export function getActiveArbitrationPermissions() {
+    return ARBITRATION_PERMISSIONS.filter(p => !p.is_reserved);
+}

package/dist/knowledge/arbitration-puzzle.d.ts

@@ -0,0 +1,84 @@
+import { type ArbStatus, type VotingGuardEntry, type DualGuardMatrix } from "./arbitration-ledger.js";
+export interface IntentPuzzle {
+    action: "create_arbitration" | "configure" | "configure_voting_guard" | "configure_usage_guard" | "file_dispute" | "confirm_materials" | "vote" | "provide_feedback" | "make_ruling" | "reset_arbitration" | "withdraw_fees" | "allocate_fees" | "pause_resume" | "transfer_ownership";
+    target_arb?: string;
+    target_order?: string;
+    rule_sentence: string;
+    failure_conditions: string[];
+}
+export interface ArbitrationConfigPuzzle {
+    description?: string;
+    location?: string;
+    fee?: string;
+    bPaused?: boolean;
+    coin_type?: string;
+    permission_address?: string;
+    um?: string | null;
+}
+export interface VotingGuardPuzzle {
+    guards: VotingGuardEntry[];
+    weight_mode: "GuardIdentifier" | "FixedValue" | "mixed" | "none";
+    cooperation_matrix?: DualGuardMatrix;
+}
+export interface UsageGuardPuzzle {
+    guard: string | null;
+    passport_required: boolean;
+    filter_rules: string[];
+}
+export interface ArbiterConfigPuzzle {
+    arbitrators: string[];
+    vote_distribution: "open" | "weighted" | "committee";
+    ruling_authority: "single_arbiter" | "multi_arbiter_vote" | "delegated_committee";
+    fees_split?: {
+        allocation?: string;
+        treasury?: string;
+        remark?: string;
+        payment_index?: number;
+    };
+}
+export interface ConstraintChecklist {
+    F_AB_01_coin_type_valid: boolean;
+    F_AB_02_permission_address_valid: boolean;
+    F_AB_03_bPaused_default_true: boolean;
+    F_AB_04_fee_u64_nonneg: boolean;
+    F_AB_05_voting_guard_count_le_50: boolean;
+    F_AB_06_voting_guard_no_duplicate: boolean;
+    F_AB_07_usage_guard_single: boolean;
+    F_AB_08_arb_status_transition_valid: boolean;
+    F_AB_09_arb_belongs_to_arbitration: boolean;
+    F_AB_10_order_op_permission: boolean;
+    F_AB_11_dispute_fee_sufficient: boolean;
+    F_AB_12_dual_guard_coherent: boolean;
+}
+export type PuzzleDimension = "A" | "B" | "C" | "D" | "E" | "F";
+export interface ArbitrationPuzzle {
+    intent?: IntentPuzzle;
+    arbitration_config?: ArbitrationConfigPuzzle;
+    voting_guard?: VotingGuardPuzzle;
+    usage_guard?: UsageGuardPuzzle;
+    arbiter_config?: ArbiterConfigPuzzle;
+    constraints?: ConstraintChecklist;
+    current_arb_status?: ArbStatus;
+    expected_arb_status?: ArbStatus;
+}
+export interface PuzzleCompleteness {
+    dimensions: PuzzleDimension[];
+    missing: PuzzleDimension[];
+    missing_details: {
+        dimension: PuzzleDimension;
+        reason: string;
+    }[];
+    complete: boolean;
+    next_step: string;
+}
+export declare function initPuzzleFromIntent(intent: Partial<IntentPuzzle>): ArbitrationPuzzle;
+export declare function checkPuzzleCompleteness(puzzle: ArbitrationPuzzle): PuzzleCompleteness;
+export interface ConstraintViolation {
+    constraint_id: string;
+    severity: "CRITICAL" | "HIGH" | "MEDIUM" | "LOW";
+    message: string;
+    current_value?: string | number;
+    limit?: string | number;
+}
+export declare function validateConstraints(puzzle: ArbitrationPuzzle): ConstraintViolation[];
+export declare function generateConfirmationText(puzzle: ArbitrationPuzzle): string;