@wowok/agent-mcp 3.4.3 → 3.4.4

package/dist/intent/enrich.d.ts

@@ -1 +0,0 @@
-export declare function enrichEventsWithObjectText(events: Record<string, unknown>[], network?: string): Promise<Record<string, unknown>[]>;

package/dist/intent/index.d.ts

@@ -1,23 +0,0 @@
-import type { IntentMatchResult, IntentRecord, IntentTargetType } from "./types.js";
-import { ALL_INTENT_TARGET_TYPES } from "./types.js";
-import type { IndustryScenario } from "../evaluation/capability.js";
-import type { PersonaRole } from "../persona/types.js";
-export { newIntentId, getIntentStore, setIntentStore, SqliteIntentRadarStore, type IntentRadarStore } from "./store.js";
-export { matchEventsToIntents } from "./matcher.js";
-export { ALL_INTENT_TARGET_TYPES, INTENT_MAX_PER_SCOPE, type IntentRecord, type IntentTargetType, type IntentMatchResult, type IntentEventHit } from "./types.js";
-export declare function resolveIntentSignals(intentText: string): {
-    industries: IndustryScenario[];
-    keywords: string[];
-};
-export interface CreateIntentInput {
-    intent: string;
-    account?: string;
-    role?: PersonaRole;
-    target_types?: IntentTargetType[];
-}
-export declare function createIntent(input: CreateIntentInput): Promise<IntentRecord>;
-export declare function listIntents(account?: string): Promise<IntentRecord[]>;
-export declare function removeIntent(id: string): Promise<boolean>;
-export declare function matchIntent(intentId: string, events: Record<string, unknown>[]): Promise<IntentMatchResult | null>;
-export declare function matchAllIntents(events: Record<string, unknown>[], account?: string): Promise<IntentMatchResult[]>;
-export { ALL_INTENT_TARGET_TYPES as SUPPORTED_TARGET_TYPES };

package/dist/intent/matcher.d.ts

@@ -1,2 +0,0 @@
-import type { IntentMatchResult, IntentRecord } from "./types.js";
-export declare function matchEventsToIntents(events: Record<string, unknown>[], intents: IntentRecord[]): IntentMatchResult[];

package/dist/intent/store.d.ts

@@ -1,19 +0,0 @@
-import { SQLiteStorage } from "@wowok/wowok";
-import type { IntentRecord } from "./types.js";
-export interface IntentRadarStore {
-    save(record: IntentRecord): Promise<void>;
-    get(id: string): Promise<IntentRecord | null>;
-    list(account?: string): Promise<IntentRecord[]>;
-    remove(id: string): Promise<boolean>;
-}
-export declare function newIntentId(): string;
-export declare class SqliteIntentRadarStore implements IntentRadarStore {
-    private readonly kv;
-    constructor(kv?: SQLiteStorage);
-    save(record: IntentRecord): Promise<void>;
-    get(id: string): Promise<IntentRecord | null>;
-    list(account?: string): Promise<IntentRecord[]>;
-    remove(id: string): Promise<boolean>;
-}
-export declare function getIntentStore(): IntentRadarStore;
-export declare function setIntentStore(store: IntentRadarStore): void;

package/dist/intent/types.d.ts

@@ -1,32 +0,0 @@
-import type { IndustryScenario } from "../evaluation/capability.js";
-import type { PersonaRole } from "../persona/types.js";
-export type IntentTargetType = "NewOrderEvent" | "ProgressEvent" | "ThresholdPendingEvent" | "DemandPresentEvent" | "DemandFeedbackEvent" | "DemandChangedEvent" | "ServiceEvent" | "ArbitrationEvent" | "NewEntityEvent" | "ArbEvent" | "VoteEvent" | "FeedbackEvent" | "AllocationEvent" | "TreasuryEvent" | "RewardClaimEvent" | "RewardFundEvent" | "RewardWithdrawEvent" | "NewPaymentEvent" | "PermissionChangedEvent" | "RepositoryDataOverwriteEvent" | "RowRemovedEvent" | "OrderTagOverwriteEvent" | "OrderTagRemovedEvent" | "PrincipalRefundedEvent";
-export interface IntentRecord {
-    id: string;
-    intent: string;
-    account?: string;
-    role?: PersonaRole;
-    industries: IndustryScenario[];
-    keywords: string[];
-    target_types: IntentTargetType[];
-    created_at: number;
-    updated_at: number;
-}
-export interface IntentEventHit {
-    event_type: string;
-    event_id: string;
-    related_objects: string[];
-    business_meaning: string;
-    score: number;
-    matched_industries: string[];
-    matched_keywords: string[];
-    event: Record<string, unknown>;
-}
-export interface IntentMatchResult {
-    intent_id: string;
-    intent: string;
-    hits: IntentEventHit[];
-    scanned: number;
-}
-export declare const INTENT_MAX_PER_SCOPE = 50;
-export declare const ALL_INTENT_TARGET_TYPES: IntentTargetType[];

package/dist/keeper/KeeperScan.d.ts

@@ -1,41 +0,0 @@
-import type { ScopeSnapshot } from "../monitor/types.js";
-import { type PaymentDetectorDeps, type ProgressDetectorDeps, type SettlementDetectorDeps, type TimeoutDetectorDeps } from "./detectors.js";
-import { type KeeperStore } from "./KeeperStore.js";
-import { type KeeperTask } from "./types.js";
-export interface KeeperExecutionOutcome {
-    ok: boolean;
-    digest?: string;
-    error?: string;
-}
-export interface KeeperScanDeps {
-    store: KeeperStore;
-    payment: PaymentDetectorDeps;
-    progress: ProgressDetectorDeps;
-    settlement: SettlementDetectorDeps;
-    timeout: TimeoutDetectorDeps;
-    execute(input: {
-        operation_type: string;
-        data: Record<string, unknown>;
-        account: string;
-        network: string;
-        via: string;
-    }): Promise<KeeperExecutionOutcome>;
-    now(): number;
-    logger(message: string): void;
-}
-export interface KeeperScanSummary {
-    scanned: boolean;
-    reason?: string;
-    opened: number;
-    refreshed: number;
-    revived: number;
-    superseded: number;
-    auto_executed: number;
-    auto_failed: number;
-    duration_ms: number;
-}
-export declare function realKeeperScanDeps(): KeeperScanDeps;
-export declare function runKeeperScan(network: string, scope: ScopeSnapshot, deps: KeeperScanDeps, opts?: {
-    force?: boolean;
-}): Promise<KeeperScanSummary>;
-export declare function executeKeeperTask(network: string, task: KeeperTask, deps: KeeperScanDeps): Promise<KeeperExecutionOutcome>;

package/dist/keeper/KeeperStore.d.ts

@@ -1,43 +0,0 @@
-import { SQLiteStorage } from "@wowok/wowok/w/local";
-import { type KeeperConfig, type KeeperConfigPatch, type KeeperRule, type KeeperTask } from "./types.js";
-export interface KeeperDesiredItem {
-    dedupe_key: string;
-    detector: KeeperTask["detector"];
-    beneficiary: string;
-    object?: string;
-    operation?: KeeperTask["operation"];
-    title: string;
-    detail?: string;
-    benefit?: string;
-    state_fingerprint: string;
-}
-export interface KeeperReconcileResult {
-    opened: number;
-    refreshed: number;
-    revived: number;
-    superseded: number;
-}
-export declare class KeeperStore {
-    private storage;
-    constructor(storage?: SQLiteStorage);
-    getConfig(network: string): Promise<KeeperConfig>;
-    saveConfig(network: string, partial: KeeperConfigPatch): Promise<KeeperConfig>;
-    listRules(network: string): Promise<KeeperRule[]>;
-    private saveRules;
-    upsertRule(network: string, rule: KeeperRule): Promise<KeeperRule[]>;
-    removeRule(network: string, ruleId: string): Promise<KeeperRule[]>;
-    matchingAutoRules(network: string, detector: KeeperRule["detector"], beneficiary: string): Promise<KeeperRule[]>;
-    listTasks(network: string, filter?: {
-        status?: KeeperTask["status"];
-        detector?: KeeperTask["detector"];
-        beneficiary?: string;
-    }): Promise<KeeperTask[]>;
-    getTask(network: string, taskId: string): Promise<KeeperTask | undefined>;
-    private saveTasks;
-    upsertDesired(network: string, detector: KeeperTask["detector"], desired: KeeperDesiredItem[], now: number): Promise<KeeperReconcileResult>;
-    resolveTask(network: string, taskId: string, resolution: NonNullable<KeeperTask["resolution"]>, now: number, note?: string, ruleId?: string): Promise<KeeperTask | undefined>;
-    markAutoAttempt(network: string, taskId: string, now: number): Promise<void>;
-    getLastScanAt(network: string): Promise<number>;
-    setLastScanAt(network: string, at: number): Promise<void>;
-}
-export declare const keeperStore: KeeperStore;

package/dist/keeper/detectors.d.ts

@@ -1,42 +0,0 @@
-import { type OrderContext, type ParsedMachineNode, type PermissionContext } from "../graph/onchain/sdk-batch.js";
-import type { GuardJsonInput } from "../knowledge/guard-lint.js";
-import type { ScopeSnapshot } from "../monitor/types.js";
-import type { KeeperDesiredItem } from "./KeeperStore.js";
-export interface UnclaimedPayment {
-    balance: bigint;
-    count: number;
-    token_type?: string;
-}
-export interface PaymentDetectorDeps {
-    queryUnclaimed(account: string, network: string): Promise<UnclaimedPayment | null>;
-    formatAmount?(balance: bigint, tokenType: string | undefined, network: string): Promise<string | undefined>;
-}
-export declare function detectPaymentUnclaimed(accounts: string[], network: string, deps: PaymentDetectorDeps): Promise<KeeperDesiredItem[]>;
-export interface ProgressDetectorDeps {
-    fetchProgressFields(addrs: string[], network: string): Promise<Map<string, any>>;
-    fetchMachineNodes(machine: string, network: string): Promise<ParsedMachineNode[]>;
-    fetchMachinePermissionAddr(machine: string, network: string): Promise<string | undefined>;
-    fetchPermissionContext(perm: string, network: string): Promise<PermissionContext | undefined>;
-    fetchOrderContext(order: string, network: string): Promise<OrderContext | undefined>;
-    fetchGuardJson?(guard: string, network: string): Promise<GuardJsonInput | undefined>;
-}
-export declare function extractGuardSignerPins(json: GuardJsonInput): string[];
-export declare function detectProgressActionable(scope: ScopeSnapshot, network: string, deps: ProgressDetectorDeps, maxObjects: number): Promise<KeeperDesiredItem[]>;
-export interface SettlementDetectorDeps {
-    fetchOrderFields(addrs: string[], network: string): Promise<Map<string, any>>;
-    fetchAllocationFields(addrs: string[], network: string): Promise<Map<string, any>>;
-    fetchProgressFields(addrs: string[], network: string): Promise<Map<string, any>>;
-    fetchMachineNodes(machine: string, network: string): Promise<ParsedMachineNode[]>;
-    formatAmount?(balance: bigint, tokenType: string | undefined, network: string): Promise<string | undefined>;
-}
-export declare function detectSettlementPending(scope: ScopeSnapshot, network: string, deps: SettlementDetectorDeps, maxObjects: number): Promise<KeeperDesiredItem[]>;
-export interface TimeoutDetectorDeps {
-    fetchProgressFields(addrs: string[], network: string): Promise<Map<string, any>>;
-    fetchMachineNodes(machine: string, network: string): Promise<ParsedMachineNode[]>;
-    nowMs(): number;
-}
-export declare function detectTimeoutIntermediate(scope: ScopeSnapshot, network: string, deps: TimeoutDetectorDeps, maxObjects: number, timeoutMs: number): Promise<KeeperDesiredItem[]>;
-export declare function realPaymentDetectorDeps(): PaymentDetectorDeps;
-export declare function realProgressDetectorDeps(): ProgressDetectorDeps;
-export declare function realSettlementDetectorDeps(): SettlementDetectorDeps;
-export declare function realTimeoutDetectorDeps(): TimeoutDetectorDeps;

package/dist/keeper/keeper.spec.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/keeper/keeper.spec.js

@@ -1 +0,0 @@
-import{describe,expect,it}from'vitest';import{KeeperStore}from'./KeeperStore.js';import{detectPaymentUnclaimed,detectProgressActionable,detectSettlementPending}from'./detectors.js';import{executeKeeperTask,runKeeperScan}from'./KeeperScan.js';import{clampKeeperConfig,defaultKeeperConfig,KEEPER_MIN}from'./types.js';const NET='testnet',ACCT='0xaaa111',OTHER='0xbbb222';function memStorage(){const a=new Map();return{'get':async b=>a['get'](b),'put':async(b,c)=>void a['set'](b,c)};}function makeStore(){return new KeeperStore(memStorage());}function paymentItem(a,b,c=0x1){return{'dedupe_key':'payment_unclaimed:'+a,'detector':'payment_unclaimed','beneficiary':a,'operation':{'operation_type':'payment','data':{'receive':!![]}},'title':'Unclaimed\x20funds\x20—\x20'+b+'\x20waiting','state_fingerprint':c+':'+b['toString']()};}function makeScope(a){return{'version':0x1,'resolved_at':0x0,'accounts':[ACCT],'permissions':[],'managed_objects':[],'services':[],'orders':[],'order_children':[],'focus':[],'index':{},...a};}describe('keeper\x20config',()=>{it('returns\x20safe\x20defaults:\x20reminders\x20ON,\x20auto\x20rules\x20none',async()=>{const a=makeStore(),b=await a['getConfig'](NET);expect(b['enabled'])['toBe'](!![]),expect(b['detectors']['payment_unclaimed'])['toBe'](!![]),expect(b['detectors']['progress_actionable'])['toBe'](!![]),expect(await a['listRules'](NET))['toEqual']([]);}),it('config_set\x20patch\x20merges\x20detectors\x20individually',async()=>{const a=makeStore(),b=await a['saveConfig'](NET,{'detectors':{'payment_unclaimed':![]}});expect(b['detectors']['payment_unclaimed'])['toBe'](![]),expect(b['detectors']['progress_actionable'])['toBe'](!![]);const c=await a['getConfig'](NET);expect(c['detectors']['payment_unclaimed'])['toBe'](![]),expect(c['detectors']['progress_actionable'])['toBe'](!![]);}),it('clamps\x20numeric\x20bounds\x20(cost/gas\x20guards)',()=>{const a=clampKeeperConfig({...defaultKeeperConfig(),'scan_interval_ms':0x1,'max_scan_objects':0x0,'max_auto_execute_per_scan':0x0,'auto_retry_cooldown_ms':0x0});expect(a['scan_interval_ms'])['toBe'](KEEPER_MIN['scan_interval_ms']),expect(a['max_scan_objects'])['toBe'](KEEPER_MIN['max_scan_objects']),expect(a['max_auto_execute_per_scan'])['toBe'](KEEPER_MIN['max_auto_execute_per_scan']),expect(a['auto_retry_cooldown_ms'])['toBe'](KEEPER_MIN['auto_retry_cooldown_ms']);});}),describe('keeper\x20rules',()=>{const a=b=>({'id':'krule_1','enabled':!![],'detector':'payment_unclaimed','accounts':[],'auto_execute':!![],'created_at':0x0,...b});it('matchingAutoRules\x20honors\x20enabled\x20/\x20auto_execute\x20/\x20account\x20coverage',async()=>{const b=makeStore();await b['upsertRule'](NET,a()),expect(await b['matchingAutoRules'](NET,'payment_unclaimed',ACCT))['toHaveLength'](0x1),expect(await b['matchingAutoRules'](NET,'progress_actionable',ACCT))['toHaveLength'](0x0),await b['upsertRule'](NET,a({'id':'krule_2','accounts':[OTHER['toUpperCase']()]})),expect(await b['matchingAutoRules'](NET,'payment_unclaimed',ACCT))['toHaveLength'](0x1),expect(await b['matchingAutoRules'](NET,'payment_unclaimed',OTHER))['toHaveLength'](0x2),await b['upsertRule'](NET,a({'id':'krule_3','enabled':![]})),await b['upsertRule'](NET,a({'id':'krule_4','auto_execute':![]}));const c=await b['matchingAutoRules'](NET,'payment_unclaimed',OTHER);expect(c['map'](d=>d['id'])['sort']())['toEqual'](['krule_1','krule_2']);});}),describe('KeeperStore.upsertDesired',()=>{it('opens\x20new\x20tasks,\x20refreshes\x20on\x20fingerprint\x20change,\x20no\x20churn\x20when\x20identical',async()=>{const a=makeStore();let b=await a['upsertDesired'](NET,'payment_unclaimed',[paymentItem(ACCT,0x64n)],0x3e8);expect(b)['toEqual']({'opened':0x1,'refreshed':0x0,'revived':0x0,'superseded':0x0}),b=await a['upsertDesired'](NET,'payment_unclaimed',[paymentItem(ACCT,0x64n)],0x7d0),expect(b)['toEqual']({'opened':0x0,'refreshed':0x0,'revived':0x0,'superseded':0x0}),b=await a['upsertDesired'](NET,'payment_unclaimed',[paymentItem(ACCT,0xfan)],0xbb8),expect(b)['toEqual']({'opened':0x0,'refreshed':0x1,'revived':0x0,'superseded':0x0});const c=(await a['listTasks'](NET))[0x0];expect(c['title'])['toContain']('250'),expect(c['updated_at'])['toBe'](0xbb8);}),it('dismissed\x20stays\x20dismissed\x20for\x20identical\x20state,\x20revives\x20on\x20material\x20change',async()=>{const a=makeStore();await a['upsertDesired'](NET,'payment_unclaimed',[paymentItem(ACCT,0x64n)],0x3e8);const b=(await a['listTasks'](NET))[0x0];await a['resolveTask'](NET,b['id'],'dismissed',0x5dc,'not\x20now');let c=await a['upsertDesired'](NET,'payment_unclaimed',[paymentItem(ACCT,0x64n)],0x7d0);expect(c['revived'])['toBe'](0x0),expect((await a['getTask'](NET,b['id']))['status'])['toBe']('dismissed'),c=await a['upsertDesired'](NET,'payment_unclaimed',[paymentItem(ACCT,0x190n,0x2)],0xbb8),expect(c['revived'])['toBe'](0x1);const d=await a['getTask'](NET,b['id']);expect(d['status'])['toBe']('pending'),expect(d['resolution'])['toBeUndefined'](),expect(d['resolved_at'])['toBeUndefined']();}),it('executed\x20tasks\x20are\x20terminal\x20—\x20same\x20dedupe_key\x20never\x20re-opens\x20them',async()=>{const a=makeStore();await a['upsertDesired'](NET,'payment_unclaimed',[paymentItem(ACCT,0x64n)],0x3e8);const b=(await a['listTasks'](NET))[0x0];await a['resolveTask'](NET,b['id'],'auto_executed',0x5dc,'tx\x20ABC','krule_1');const c=await a['upsertDesired'](NET,'payment_unclaimed',[paymentItem(ACCT,0x1f4n)],0x7d0);expect(c)['toEqual']({'opened':0x0,'refreshed':0x0,'revived':0x0,'superseded':0x0});const d=await a['getTask'](NET,b['id']);expect(d['status'])['toBe']('executed'),expect(d['rule_id'])['toBe']('krule_1');}),it('supersedes\x20pending\x20tasks\x20of\x20THIS\x20detector\x20only',async()=>{const a=makeStore();await a['upsertDesired'](NET,'payment_unclaimed',[paymentItem(ACCT,0x64n)],0x3e8),await a['upsertDesired'](NET,'progress_actionable',[{'dedupe_key':'progress_actionable:0xp1:0xaaa111:shipped|deliver','detector':'progress_actionable','beneficiary':ACCT,'title':'Workflow\x20action\x20available','state_fingerprint':'1:1::named_operator'}],0x3e8);const b=await a['upsertDesired'](NET,'payment_unclaimed',[],0x7d0);expect(b['superseded'])['toBe'](0x1);const c=await a['listTasks'](NET),d=c['find'](f=>f['detector']==='payment_unclaimed'),e=c['find'](f=>f['detector']==='progress_actionable');expect(d['status'])['toBe']('superseded'),expect(d['resolution'])['toBe']('superseded'),expect(e['status'])['toBe']('pending');}),it('execute_failed\x20keeps\x20the\x20task\x20pending\x20with\x20failure\x20bookkeeping',async()=>{const a=makeStore();await a['upsertDesired'](NET,'payment_unclaimed',[paymentItem(ACCT,0x64n)],0x3e8);const b=(await a['listTasks'](NET))[0x0];await a['resolveTask'](NET,b['id'],'execute_failed',0x1388,'insufficient\x20gas','krule_1');const c=await a['getTask'](NET,b['id']);expect(c['status'])['toBe']('pending'),expect(c['last_auto_attempt_at'])['toBe'](0x1388),expect(c['auto_attempts'])['toBe'](0x1),expect(c['resolution_note'])['toBe']('insufficient\x20gas');});}),describe('detectPaymentUnclaimed',()=>{it('emits\x20a\x20claim-to-self\x20task\x20for\x20accounts\x20with\x20unclaimed\x20wrappers',async()=>{const a=await detectPaymentUnclaimed([ACCT['toUpperCase'](),OTHER,'0xccc333'],NET,{'queryUnclaimed':async c=>{if(c===ACCT)return{'balance':0x64n,'count':0x2,'token_type':'0x2::wow::WOW'};if(c===OTHER)return{'balance':0x0n,'count':0x0};throw new Error('rpc\x20down');},'formatAmount':async()=>'0.0000001\x20WOW'});expect(a)['toHaveLength'](0x1);const b=a[0x0];expect(b['dedupe_key'])['toBe']('payment_unclaimed:'+ACCT),expect(b['beneficiary'])['toBe'](ACCT),expect(b['operation'])['toEqual']({'operation_type':'payment','data':{'receive':!![]}}),expect(b['state_fingerprint'])['toBe']('2:100'),expect(b['title'])['toContain']('0.0000001\x20WOW');}),it('falls\x20back\x20to\x20raw\x20units\x20when\x20formatting\x20fails',async()=>{const a=await detectPaymentUnclaimed([ACCT],NET,{'queryUnclaimed':async()=>({'balance':0x2an,'count':0x1}),'formatAmount':async()=>{throw new Error('no\x20metadata');}});expect(a[0x0]['title'])['toContain']('42\x20(smallest\x20unit)');});}),describe('detectProgressActionable',()=>{const a='0xprog1',b='0xmachine1',c=[{'name':'shipped','pairs':[{'prev_node':'start','threshold':0x1,'forwards':[{'name':'deliver','weight':0x1,'namedOperator':'courier'}]}]}],d=(j=[])=>({'machine':b,'current':'start','session':j,'namedOperator':[{'name':'courier','operators':[ACCT]}]}),e=j=>({'fetchProgressFields':async()=>new Map([[a,j]]),'fetchMachineNodes':async()=>c,'fetchMachinePermissionAddr':async()=>undefined,'fetchPermissionContext':async()=>undefined,'fetchOrderContext':async()=>undefined}),f=makeScope({'order_children':[{'type':'progress','object':a}]});it('routes\x20an\x20actionable\x20forward\x20to\x20its\x20named\x20operator',async()=>{const j=await detectProgressActionable(f,NET,e(d()),0x14);expect(j)['toHaveLength'](0x1),expect(j[0x0]['dedupe_key'])['toBe']('progress_actionable:'+a+':'+ACCT+':shipped|deliver'),expect(j[0x0]['beneficiary'])['toBe'](ACCT),expect(j[0x0]['operation'])['toBeUndefined'](),expect(j[0x0]['detail'])['toContain']('workflow_operation');}),it('omits\x20accomplished\x20forwards\x20(single-operator\x20lock)',async()=>{const j=[{'next_node':'shipped','forwards':[{'forward':'deliver','who':ACCT,'accomplished':!![]}]}],k=await detectProgressActionable(f,NET,e(d(j)),0x14);expect(k)['toHaveLength'](0x0);}),it('restricts\x20a\x20held\x20forward\x20to\x20its\x20holder',async()=>{const j=[{'next_node':'shipped','forwards':[{'forward':'deliver','who':OTHER,'accomplished':![]}]}],k=await detectProgressActionable(f,NET,e(d(j)),0x14);expect(k)['toHaveLength'](0x0);}),it('returns\x20nothing\x20when\x20the\x20batch\x20read\x20fails\x20(fail-safe)',async()=>{const j=await detectProgressActionable(f,NET,{...e(d()),'fetchProgressFields':async()=>{throw new Error('rpc\x20down');}},0x14);expect(j)['toEqual']([]);});const g=[{'name':'shipped','pairs':[{'prev_node':'start','threshold':0x1,'forwards':[{'name':'deliver','weight':0x1,'namedOperator':'courier','guard':'0xguard1'}]}]}],h=(j,k=OTHER)=>({'table':[{'identifier':0x2,'b_submission':![],'value_type':'Address','value':k}],'root':j}),i=(j,k)=>({...e(j),'fetchMachineNodes':async()=>g,'fetchGuardJson':async()=>k});it('skips\x20the\x20task\x20when\x20the\x20guard\x20pins\x20the\x20Signer\x20to\x20another\x20account',async()=>{const j=h({'type':'logic_equal','nodes':[{'type':'context','context':'Signer'},{'type':'identifier','identifier':0x2}]}),k=await detectProgressActionable(f,NET,i(d(),j),0x14);expect(k)['toEqual']([]);}),it('keeps\x20the\x20task\x20when\x20the\x20guard\x20pins\x20the\x20Signer\x20to\x20the\x20beneficiary\x20itself',async()=>{const j=h({'type':'logic_equal','nodes':[{'type':'identifier','identifier':0x2},{'type':'context','context':'Signer'}]},ACCT),k=await detectProgressActionable(f,NET,i(d(),j),0x14);expect(k)['toHaveLength'](0x1);}),it('fail-open:\x20unreadable\x20guard\x20JSON\x20still\x20emits\x20the\x20task',async()=>{const j=await detectProgressActionable(f,NET,i(d(),undefined),0x14);expect(j)['toHaveLength'](0x1);}),it('fail-open:\x20a\x20Signer\x20pin\x20inside\x20a\x20logic_or\x20branch\x20is\x20only\x20an\x20alternative,\x20not\x20a\x20pin',async()=>{const j=h({'type':'logic_or','nodes':[{'type':'logic_equal','nodes':[{'type':'context','context':'Signer'},{'type':'identifier','identifier':0x2}]},{'type':'logic_equal','nodes':[{'type':'context','context':'Signer'},{'type':'identifier','identifier':0x2}]}]}),k=await detectProgressActionable(f,NET,i(d(),j),0x14);expect(k)['toHaveLength'](0x1);}),it('fail-open:\x20a\x20dynamic\x20query\x20operand\x20(order.owner\x20==\x20Signer)\x20is\x20not\x20a\x20pin',async()=>{const j={'table':[{'identifier':0x2,'b_submission':![],'value_type':'Address','value':OTHER}],'root':{'type':'logic_equal','nodes':[{'type':'context','context':'Signer'},{'type':'query','id':0x61a}]}},k=await detectProgressActionable(f,NET,i(d(),j),0x14);expect(k)['toHaveLength'](0x1);});}),describe('detectSettlementPending',()=>{const a='0xorder1',b='0xpool1',c='0xprog1',d='0xmachine1',e='0xsvc1',f=i=>[{'name':'paid','pairs':[{'prev_node':'','threshold':0x1,'forwards':[{'name':'settle','weight':0x1}]}]},{'name':i,'pairs':[{'prev_node':'paid','threshold':0x1,'forwards':[]}]}];function g(i,j,k,l){return{'fetchOrderFields':async()=>new Map([[a,{'type':'Order','object':a,'data':i}]]),'fetchAllocationFields':async()=>new Map([[b,{'type':'Allocation','object':b,'type_raw':'0x2::allocation::Allocation<0x2::coin::COIN>','data':j}]]),'fetchProgressFields':async()=>new Map([[c,k]]),'fetchMachineNodes':async()=>l};}const h={'allocation':b,'progress':c,'machine':d,'service':e,'builder':ACCT};it('routes\x20a\x20completion\x20terminal\x20with\x20an\x20unsettled\x20pool\x20to\x20the\x20merchant\x20account',async()=>{const i=makeScope({'services':[e],'orders':[{'order':a,'role':'merchant'}]}),j=await detectSettlementPending(i,NET,g(h,{'balance':'5000','payment':[],'allocators':{'allocators':[{'guard':'0xgsettle'}]}},{'current':'completed','machine':d},f('completed')),0x14);expect(j)['toHaveLength'](0x1),expect(j[0x0]['beneficiary'])['toBe'](ACCT),expect(j[0x0]['detector'])['toBe']('settlement_pending'),expect(j[0x0]['title'])['toContain']('completion'),expect(j[0x0]['detail'])['toContain']('alloc_by_guard');}),it('routes\x20a\x20refund\x20terminal\x20to\x20the\x20buyer\x20(order\x20builder)\x20account',async()=>{const i=makeScope({'orders':[{'order':a,'role':'buyer'}]}),j=await detectSettlementPending(i,NET,g(h,{'balance':'5000','payment':[],'allocators':{'allocators':[{'guard':'0xgrefund'}]}},{'current':'refunded','machine':d},f('refunded')),0x14);expect(j)['toHaveLength'](0x1),expect(j[0x0]['beneficiary'])['toBe'](ACCT),expect(j[0x0]['title'])['toContain']('refund/cancel');}),it('skips\x20a\x20pool\x20already\x20drained\x20(balance\x200)',async()=>{const i=makeScope({'services':[e],'orders':[{'order':a,'role':'merchant'}]}),j=await detectSettlementPending(i,NET,g(h,{'balance':'0','payment':[],'allocators':{'allocators':[]}},{'current':'completed','machine':d},f('completed')),0x14);expect(j)['toHaveLength'](0x0);}),it('skips\x20a\x20pool\x20that\x20already\x20emitted\x20a\x20Payment',async()=>{const i=makeScope({'services':[e],'orders':[{'order':a,'role':'merchant'}]}),j=await detectSettlementPending(i,NET,g(h,{'balance':'5000','payment':['0xpay1'],'allocators':{'allocators':[]}},{'current':'completed','machine':d},f('completed')),0x14);expect(j)['toHaveLength'](0x0);}),it('skips\x20a\x20non-terminal\x20node\x20(still\x20has\x20outgoing\x20forwards)',async()=>{const i=makeScope({'services':[e],'orders':[{'order':a,'role':'merchant'}]}),j=await detectSettlementPending(i,NET,g(h,{'balance':'5000','payment':[],'allocators':{'allocators':[]}},{'current':'paid','machine':d},f('completed')),0x14);expect(j)['toHaveLength'](0x0);}),it('returns\x20nothing\x20when\x20the\x20order\x20batch\x20read\x20fails\x20(fail-safe)',async()=>{const i=makeScope({'services':[e],'orders':[{'order':a,'role':'merchant'}]}),j=await detectSettlementPending(i,NET,{...g(h,{'balance':'5000','payment':[]},{'current':'completed','machine':d},f('completed')),'fetchOrderFields':async()=>{throw new Error('rpc\x20down');}},0x14);expect(j)['toEqual']([]);});});function scanDepsFor(a,b){let c=0x2710;const d=[],e={'store':a,'payment':{'queryUnclaimed':async()=>({'balance':0x64n,'count':0x1})},'progress':{'fetchProgressFields':async()=>new Map(),'fetchMachineNodes':async()=>[],'fetchMachinePermissionAddr':async()=>undefined,'fetchPermissionContext':async()=>undefined,'fetchOrderContext':async()=>undefined},'settlement':{'fetchOrderFields':async()=>new Map(),'fetchAllocationFields':async()=>new Map(),'fetchProgressFields':async()=>new Map(),'fetchMachineNodes':async()=>[]},'timeout':{'fetchProgressFields':async()=>new Map(),'fetchMachineNodes':async()=>[],'nowMs':()=>0x2710},'execute':async f=>{return d['push']({'operation_type':f['operation_type'],'account':f['account'],'via':f['via']}),{'ok':!![],'digest':'DIGEST1'};},'now':()=>c,'logger':()=>{},...b};return{'deps':e,'executed':d,'advance':f=>{c+=f;},'setClock':f=>{c=f;}};}describe('runKeeperScan',()=>{it('skips\x20when\x20disabled\x20and\x20when\x20inside\x20the\x20cadence\x20interval',async()=>{const a=makeStore(),{deps:b}=scanDepsFor(a);await a['saveConfig'](NET,{'enabled':![]});let c=await runKeeperScan(NET,makeScope(),b);expect(c['scanned'])['toBe'](![]),expect(c['reason'])['toBe']('disabled'),await a['saveConfig'](NET,{'enabled':!![]}),await a['setLastScanAt'](NET,0x2710),c=await runKeeperScan(NET,makeScope(),b),expect(c['scanned'])['toBe'](![]),expect(c['reason'])['toBe']('interval');}),it('auto-executes\x20a\x20payment\x20task\x20ONLY\x20with\x20a\x20covering\x20enabled\x20rule',async()=>{const a=makeStore(),{deps:b,executed:c}=scanDepsFor(a);let d=await runKeeperScan(NET,makeScope(),b,{'force':!![]});expect(d['opened'])['toBe'](0x1),expect(d['auto_executed'])['toBe'](0x0),expect(c)['toHaveLength'](0x0),await a['upsertRule'](NET,{'id':'krule_1','enabled':!![],'detector':'payment_unclaimed','accounts':[],'auto_execute':!![],'created_at':0x0}),d=await runKeeperScan(NET,makeScope(),b,{'force':!![]}),expect(d['auto_executed'])['toBe'](0x1),expect(c[0x0])['toEqual']({'operation_type':'payment','account':ACCT,'via':'rule\x20krule_1'});const e=(await a['listTasks'](NET))[0x0];expect(e['status'])['toBe']('executed'),expect(e['resolution'])['toBe']('auto_executed'),expect(e['rule_id'])['toBe']('krule_1'),expect(e['resolution_note'])['toContain']('DIGEST1');}),it('never\x20auto-executes\x20progress\x20tasks\x20(reminder-only\x20boundary)',async()=>{const a=makeStore(),{deps:b,executed:c}=scanDepsFor(a,{'payment':{'queryUnclaimed':async()=>null},'progress':{'fetchProgressFields':async()=>new Map([['0xprog1',{'machine':'0xm1','current':'start','session':[],'namedOperator':[{'name':'courier','operators':[ACCT]}]}]]),'fetchMachineNodes':async()=>[{'name':'shipped','pairs':[{'prev_node':'start','threshold':0x1,'forwards':[{'name':'deliver','weight':0x1,'namedOperator':'courier'}]}]}],'fetchMachinePermissionAddr':async()=>undefined,'fetchPermissionContext':async()=>undefined,'fetchOrderContext':async()=>undefined}});await a['upsertRule'](NET,{'id':'krule_p','enabled':!![],'detector':'progress_actionable','accounts':[],'auto_execute':!![],'created_at':0x0});const d=await runKeeperScan(NET,makeScope({'order_children':[{'type':'progress','object':'0xprog1'}]}),b,{'force':!![]});expect(d['opened'])['toBe'](0x1),expect(d['auto_executed'])['toBe'](0x0),expect(c)['toHaveLength'](0x0),expect((await a['listTasks'](NET))[0x0]['status'])['toBe']('pending');}),it('backs\x20off\x20after\x20a\x20failed\x20auto-exec\x20until\x20the\x20cooldown\x20passes',async()=>{const a=makeStore(),b=scanDepsFor(a,{'execute':async()=>({'ok':![],'error':'insufficient\x20gas'})});await a['upsertRule'](NET,{'id':'krule_1','enabled':!![],'detector':'payment_unclaimed','accounts':[],'auto_execute':!![],'created_at':0x0});let c=await runKeeperScan(NET,makeScope(),b['deps'],{'force':!![]});expect(c['auto_failed'])['toBe'](0x1);const d=(await a['listTasks'](NET))[0x0];expect(d['status'])['toBe']('pending'),expect(d['resolution_note'])['toBe']('insufficient\x20gas'),c=await runKeeperScan(NET,makeScope(),b['deps'],{'force':!![]}),expect(c['auto_failed'])['toBe'](0x0),expect(c['auto_executed'])['toBe'](0x0),b['advance'](0x1f*0xea60),c=await runKeeperScan(NET,makeScope(),b['deps'],{'force':!![]}),expect(c['auto_failed'])['toBe'](0x1);}),it('caps\x20auto-executions\x20per\x20scan\x20(gas\x20guard)',async()=>{const a=makeStore(),{deps:b,executed:c}=scanDepsFor(a);await a['saveConfig'](NET,{'max_auto_execute_per_scan':0x1}),await a['upsertRule'](NET,{'id':'krule_1','enabled':!![],'detector':'payment_unclaimed','accounts':[],'auto_execute':!![],'created_at':0x0});const d=makeScope({'accounts':[ACCT,OTHER]}),e=await runKeeperScan(NET,d,b,{'force':!![]});expect(e['opened'])['toBe'](0x2),expect(e['auto_executed'])['toBe'](0x1),expect(c)['toHaveLength'](0x1),expect(await a['listTasks'](NET,{'status':'pending'}))['toHaveLength'](0x1);});}),describe('executeKeeperTask\x20(manual)',()=>{it('resolves\x20a\x20payment\x20task\x20as\x20manual_executed',async()=>{const a=makeStore();await a['upsertDesired'](NET,'payment_unclaimed',[paymentItem(ACCT,0x64n)],0x3e8);const b=(await a['listTasks'](NET))[0x0],{deps:c}=scanDepsFor(a),d=await executeKeeperTask(NET,b,c);expect(d['ok'])['toBe'](!![]);const e=await a['getTask'](NET,b['id']);expect(e['status'])['toBe']('executed'),expect(e['resolution'])['toBe']('manual_executed');}),it('refuses\x20reminder-only\x20tasks\x20(progress)\x20with\x20guidance',async()=>{const a=makeStore(),{deps:b}=scanDepsFor(a),c={'id':'ktask_x','dedupe_key':'progress_actionable:0xp:0xaaa111:shipped|deliver','detector':'progress_actionable','network':NET,'beneficiary':ACCT,'title':'Workflow\x20action\x20available','state_fingerprint':'1:1::named_operator','status':'pending','created_at':0x0,'updated_at':0x0},d=await executeKeeperTask(NET,c,b);expect(d['ok'])['toBe'](![]),expect(d['error'])['toContain']('reminder-only');});}),describe('timeout_intermediate',()=>{const a=0xa*0x5265c00,b={'current':'awaiting_host_confirmation','current_time':a-0x1e*0x36ee80,'machine':'0xmach1','task':'0xorder1'};function c(e,f){return{'fetchProgressFields':async()=>new Map(e===undefined?[]:[['0xprog1',e]]),'fetchMachineNodes':async()=>f,'nowMs':()=>a};}function d(e,f){return{'name':e,'pairs':[{'prev_node':'paid','threshold':0x0,'forwards':Array['from']({'length':f},()=>({}))}]};}it('surfaces\x20a\x20progress\x20stuck\x20on\x20an\x20intermediate\x20node\x20past\x20the\x20threshold',async()=>{const {detectTimeoutIntermediate:e}=await import('./detectors.js'),f=await e(makeScope({'order_children':[{'type':'progress','object':'0xprog1'}]}),NET,c(b,[d('awaiting_host_confirmation',0x1)]),0x14,0x18*0x36ee80);expect(f)['toHaveLength'](0x1),expect(f[0x0]['detector'])['toBe']('timeout_intermediate'),expect(f[0x0]['beneficiary'])['toBe'](ACCT);}),it('stays\x20silent\x20below\x20the\x20threshold,\x20on\x20terminal\x20nodes,\x20and\x20on\x20missing\x20data',async()=>{const {detectTimeoutIntermediate:e}=await import('./detectors.js'),f=makeScope({'order_children':[{'type':'progress','object':'0xprog1'}]}),g={...b,'current_time':a-0x1*0x36ee80};expect(await e(f,NET,c(g,[d('awaiting_host_confirmation',0x1)]),0x14,0x18*0x36ee80))['toHaveLength'](0x0),expect(await e(f,NET,c(b,[d('awaiting_host_confirmation',0x0)]),0x14,0x18*0x36ee80))['toHaveLength'](0x0),expect(await e(f,NET,c(undefined,[d('awaiting_host_confirmation',0x1)]),0x14,0x18*0x36ee80))['toHaveLength'](0x0);}),it('the\x20scan\x20wires\x20the\x20detector:\x20a\x20stuck\x20progress\x20opens\x20a\x20reminder\x20task\x20(never\x20auto-exec)',async()=>{const e=makeStore(),f=scanDepsFor(e,{'payment':{'queryUnclaimed':async()=>null}}),{deps:g}=f;g['timeout']=c(b,[d('awaiting_host_confirmation',0x1)]),await e['upsertRule'](NET,{'id':'krule_t','enabled':!![],'detector':'timeout_intermediate','accounts':[],'auto_execute':!![],'created_at':0x0});const h=await runKeeperScan(NET,makeScope({'order_children':[{'type':'progress','object':'0xprog1'}]}),g,{'force':!![]});expect(h['opened'])['toBe'](0x1),expect(h['auto_executed'])['toBe'](0x0);const i=(await e['listTasks'](NET))[0x0];expect(i['detector'])['toBe']('timeout_intermediate'),expect(i['status'])['toBe']('pending');});});

package/dist/keeper/types.d.ts

@@ -1,67 +0,0 @@
-export type KeeperDetectorKind = "payment_unclaimed" | "progress_actionable" | "settlement_pending" | "timeout_intermediate";
-export declare const AUTO_EXECUTABLE_DETECTORS: readonly KeeperDetectorKind[];
-export type KeeperTaskStatus = "pending" | "executed" | "dismissed" | "superseded";
-export interface KeeperTask {
-    id: string;
-    dedupe_key: string;
-    detector: KeeperDetectorKind;
-    network: string;
-    beneficiary: string;
-    object?: string;
-    operation?: {
-        operation_type: string;
-        data: Record<string, unknown>;
-    };
-    title: string;
-    detail?: string;
-    benefit?: string;
-    state_fingerprint: string;
-    status: KeeperTaskStatus;
-    created_at: number;
-    updated_at: number;
-    resolved_at?: number;
-    resolution?: "auto_executed" | "manual_executed" | "dismissed" | "superseded" | "execute_failed";
-    resolution_note?: string;
-    rule_id?: string;
-    last_auto_attempt_at?: number;
-    auto_attempts?: number;
-}
-export interface KeeperRule {
-    id: string;
-    enabled: boolean;
-    detector: KeeperDetectorKind;
-    accounts: string[];
-    auto_execute: boolean;
-    created_at: number;
-    note?: string;
-}
-export interface KeeperConfig {
-    enabled: boolean;
-    detectors: Record<KeeperDetectorKind, boolean>;
-    scan_interval_ms: number;
-    max_scan_objects: number;
-    max_auto_execute_per_scan: number;
-    auto_retry_cooldown_ms: number;
-    timeout_intermediate_ms: number;
-}
-export type KeeperConfigPatch = Omit<Partial<KeeperConfig>, "detectors"> & {
-    detectors?: Partial<Record<KeeperDetectorKind, boolean>>;
-};
-export declare const KEEPER_DEFAULTS: {
-    readonly scan_interval_ms: 120000;
-    readonly max_scan_objects: 20;
-    readonly max_auto_execute_per_scan: 5;
-    readonly auto_retry_cooldown_ms: 1800000;
-    readonly timeout_intermediate_ms: 86400000;
-};
-export declare const KEEPER_MIN: {
-    readonly scan_interval_ms: 30000;
-    readonly max_scan_objects: 1;
-    readonly max_auto_execute_per_scan: 1;
-    readonly auto_retry_cooldown_ms: 60000;
-    readonly timeout_intermediate_ms: 3600000;
-};
-export declare function defaultKeeperConfig(): KeeperConfig;
-export declare function clampKeeperConfig(cfg: KeeperConfig): KeeperConfig;
-export declare function newKeeperTaskId(): string;
-export declare function newKeeperRuleId(): string;

package/dist/knowledge/account-marks.d.ts

@@ -1,36 +0,0 @@
-export interface AccountMarkRow {
-    object: string;
-    vote_kinds: string[];
-    time?: number;
-    object_type: string | null;
-    type_raw?: string;
-    name?: string;
-    description?: string;
-    tags?: string[];
-    rep?: {
-        like: number;
-        dislike: number;
-        favor: number;
-        votes?: {
-            who: string | null;
-            like: boolean;
-            dislike: boolean;
-            favor: boolean;
-        }[];
-    };
-}
-export interface AccountMarksResult {
-    action: "account_marks";
-    network?: string;
-    updated_at_ms: number;
-    cached: boolean;
-    marks: AccountMarkRow[];
-    count: number;
-    note?: string;
-}
-export declare function buildAccountMarks(opts: {
-    network?: string;
-    no_cache?: boolean;
-    account?: string;
-    light?: boolean;
-}): Promise<AccountMarksResult>;

package/dist/knowledge/allocation-ledger.d.ts

@@ -1,75 +0,0 @@
-import { MAX_ALLOCATOR_COUNT } from "@wowok/wowok";
-export type AllocationMode = "Amount" | "Rate" | "Surplus" | "RateGross" | "Formula";
-export type RecipientType = "GuardIdentifier" | "Entity" | "Signer";
-export type TriggerSource = "service_order_allocators" | "arbitration_fees" | "standalone";
-export interface AllocationScene {
-    id: string;
-    name: string;
-    trigger_source: TriggerSource;
-    distribution_strategy: "pure_rate" | "amount_plus_surplus" | "first_match_alternatives" | "tiered_by_amount" | "dynamic_recipient" | "refund_to_order" | "max_capped" | "multi_node_trigger" | "periodic_split" | "time_locked_vesting";
-    coin_type_note: string;
-    typical_allocator_count: number;
-    sharing_who_types: RecipientType[];
-    modes_used: AllocationMode[];
-    guard_requirement: "required" | "multiple_unique" | "single_relaxed" | "any";
-    non_zero_threshold: boolean;
-    uses_max: boolean;
-    common_patterns: string[];
-    dependencies: ("Service" | "Treasury" | "Guard" | "Passport" | "Order" | "Arbitration" | "Progress" | "Machine" | "Payment")[];
-    key_constraints: string[];
-    recommended_templates: string[];
-}
-export { MAX_ALLOCATOR_COUNT };
-export declare const ALLOCATION_MAX_SHARING_COUNT: 100;
-export declare const ALLOCATION_MODE_AMOUNT = 0;
-export declare const ALLOCATION_MODE_RATE = 1;
-export declare const ALLOCATION_MODE_SURPLUS = 2;
-export declare const ALLOCATION_MODE_RATE_GROSS = 3;
-export declare const ALLOCATION_MODE_FORMULA = 4;
-export declare const RATE_TOTAL_FULL = 10000;
-export declare const ALLOCATION_ERROR_CODES: {
-    readonly ERECIPIENT_IDENTIFIER_NOT_ADDRESS: 1;
-    readonly EALLOCATOR_COUNT_EXCEEDED: 2;
-    readonly ENO_ALLOCATOR: 3;
-    readonly ERATE_NOT_10000: 4;
-    readonly EMULTIPLE_SURPLUS: 5;
-    readonly ERATE_EXCEEDS_10000: 6;
-    readonly EINSUFFICIENT_BALANCE: 7;
-    readonly EALLOCATORS_EMPTY: 8;
-    readonly ENO_PAYMENT_INFO: 9;
-    readonly ESHARING_COUNT_EXCEEDED: 10;
-    readonly ESHARING_MODE_INVALID: 11;
-    readonly EAMOUNT_BELOW_THRESHOLD: 12;
-    readonly EAMOUNT_EXCEEDS_MAX: 13;
-    readonly EZERO_DISTRIBUTION: 14;
-    readonly ERECIPIENT_NOT_FOR_OBJECT: 15;
-    readonly E_ONCE_TRIGGERED: 16;
-    readonly EMIXED_RATE_BASES: 17;
-    readonly EFORMULA_SPEC_INVALID: 24;
-    readonly EEMPTY_POOL_BATCH: 26;
-};
-export declare const ORDER_ALLOCATION_ALREADY_SPECIFIED = "E_ALLOCATION_ALREADY_SPECIFIED";
-export declare const ALLOCATION_SCENES: AllocationScene[];
-export declare const ALLOCATION_LEDGER_VERSION = "1.0.0";
-export declare function getScenesByTriggerSource(source: TriggerSource): AllocationScene[];
-export declare function getScenesByMode(mode: AllocationMode): AllocationScene[];
-export declare function getScenesByStrategy(strategy: AllocationScene["distribution_strategy"]): AllocationScene[];
-export declare function findSceneById(id: string): AllocationScene | undefined;
-export declare function inferSceneFromIntent(intent: string): AllocationScene | undefined;
-export declare function getAllScenes(): AllocationScene[];
-export declare function getScenesCount(): number;
-export declare function allocationModeToNumber(mode: AllocationMode): number;
-export declare function allocationModeFromNumber(n: number): AllocationMode;
-export type Recipient = {
-    GuardIdentifier: number;
-} | {
-    Entity: string;
-} | {
-    Signer: "signer";
-};
-export declare function getRecipientType(who: Recipient): RecipientType;
-export declare function isSignerRecipient(who: Recipient): boolean;
-export declare function isEntityRecipient(who: Recipient): boolean;
-export declare function isGuardIdentifierRecipient(who: Recipient): boolean;
-export declare function getErrorName(code: number): string | undefined;
-export declare function getErrorDescription(code: number): string | undefined;

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

@@ -1,138 +0,0 @@
-import { type AllocationMode, type Recipient, type TriggerSource } from "./allocation-ledger.js";
-export interface AllocationIntentPuzzle {
-    action: "create" | "operate" | "query";
-    host_context: TriggerSource;
-    trigger_condition: string;
-    distribution_goal: string;
-    failure_conditions: string[];
-}
-export interface AllocationBindingPuzzle {
-    coin_type: string;
-    host_service?: string;
-    host_arbitration?: string;
-    bound_order?: string;
-    trigger_node?: string;
-    guard_objects: string[];
-    payment_info_source: "service" | "arbitration" | "custom";
-}
-export interface AllocatorConfig {
-    guard: string;
-    sharing: {
-        who: Recipient;
-        sharing: string | bigint;
-        mode: AllocationMode;
-    }[];
-    fix?: string | bigint;
-    max?: string | bigint | null;
-}
-export interface AllocatorsConfig {
-    description: string;
-    threshold: string | bigint;
-    allocators: AllocatorConfig[];
-}
-export interface PaymentInfoConfig {
-    for_object: string;
-    source?: "service" | "arbitration" | "custom";
-}
-export interface AllocationDataSourcePuzzle {
-    allocators_config: AllocatorsConfig;
-    payment_info: PaymentInfoConfig;
-    coin_source: "order_payment" | "arbitration_fees" | "external_deposit";
-}
-export type AllocationOperation = {
-    type: "create";
-    name: string;
-    allocators: AllocatorsConfig;
-    coin: string;
-    payment_info: PaymentInfoConfig;
-} | {
-    type: "receive";
-    received_coins: "recently" | {
-        received: {
-            id: string;
-            payment: string;
-        }[];
-        token_type: string;
-    };
-} | {
-    type: "alloc_by_guard";
-    guard: string;
-    passport?: string;
-} | {
-    type: "query_balance";
-} | {
-    type: "query_allocators";
-} | {
-    type: "query_payment_history";
-};
-export interface AllocationOperationPuzzle {
-    operations: AllocationOperation[];
-}
-export interface AllocationLogicPuzzle {
-    alloc_flow: {
-        step: 1 | 2 | 3 | 4 | 5 | 6 | 7;
-        action: "pre_check" | "guard_lookup" | "rate_base_calc" | "sharing_distribution" | "surplus_distribution" | "recipient_resolution" | "payment_creation";
-        description: string;
-    }[];
-    guard_matching_strategy: "caller_specified_guard" | "all_match";
-    recipient_resolution_rules: {
-        recipient_type: "GuardIdentifier" | "Entity" | "Signer";
-        resolution_source: "passport_table" | "static_address" | "tx_sender";
-        safety_level: "safe" | "dangerous" | "safe_with_guard_binding";
-    }[];
-}
-export interface AllocationConstraintChecklist {
-    F_A_01_allocator_count_le_100: boolean;
-    F_A_02_sharing_count_le_100: boolean;
-    F_A_03_sharing_mode_valid: boolean;
-    F_A_04_at_most_1_surplus_per_allocator: boolean;
-    F_A_05_pure_rate_sum_eq_10000: boolean;
-    F_A_06_rate_plus_surplus_sum_le_10000: boolean;
-    F_A_07_amount_sum_ge_threshold: boolean;
-    F_A_08_amount_sum_le_max: boolean;
-    F_A_09_balance_ge_threshold_at_alloc: boolean;
-    F_A_10_payment_info_present: boolean;
-    F_A_11_allocators_not_empty: boolean;
-    F_A_12_order_at_most_1_allocation: boolean;
-    F_A_13_guard_identifier_is_address: boolean;
-    F_A_14_guard_addresses_unique: boolean;
-    F_A_15_order_allocators_immutable_after_publish: boolean;
-    F_A_16_rate_gross_sum_le_10000: boolean;
-    F_A_17_no_mixed_rate_bases: boolean;
-    F_A_18_formula_coefficient_le_10000: boolean;
-}
-export type AllocationPuzzleDimension = "A" | "B" | "C" | "D" | "E" | "F";
-export interface AllocationPuzzle {
-    intent?: AllocationIntentPuzzle;
-    binding?: AllocationBindingPuzzle;
-    data_source?: AllocationDataSourcePuzzle;
-    operations?: AllocationOperationPuzzle;
-    logic?: AllocationLogicPuzzle;
-    constraints?: AllocationConstraintChecklist;
-}
-export interface AllocationPuzzleCompleteness {
-    dimensions: AllocationPuzzleDimension[];
-    missing: AllocationPuzzleDimension[];
-    missing_details: {
-        dimension: AllocationPuzzleDimension;
-        reason: string;
-    }[];
-    complete: boolean;
-    next_step: string;
-}
-export declare function initPuzzleFromIntent(intent: Partial<AllocationIntentPuzzle>): AllocationPuzzle;
-export declare function checkPuzzleCompleteness(puzzle: AllocationPuzzle): AllocationPuzzleCompleteness;
-export interface AllocationConstraintViolation {
-    constraint_id: string;
-    severity: "critical" | "high" | "medium" | "low";
-    message: string;
-    current_value?: string | number;
-    limit?: string | number;
-    related_move_error?: string;
-}
-export declare function validateConstraints(puzzle: AllocationPuzzle): AllocationConstraintViolation[];
-export declare function generateConfirmationText(puzzle: AllocationPuzzle): string;
-export declare function buildDefaultAllocFlow(): AllocationLogicPuzzle["alloc_flow"];
-export declare function buildDefaultRecipientRules(): AllocationLogicPuzzle["recipient_resolution_rules"];
-export declare function buildDefaultLogicPuzzle(): AllocationLogicPuzzle;
-export declare const ALLOCATION_PUZZLE_VERSION = "1.0.0";