@ottochain/sdk 2.0.0 → 2.1.0

package/dist/types/apps/identity/state-machines/identity-agent.d.ts

@@ -0,0 +1,401 @@
+/**
+ * Standard agent identity with reputation tracking, vouching, and lifecycle management.
+ */
+export declare const identityAgentDef: {
+    metadata: {
+        name: string;
+        app: string;
+        type: string;
+        version: string;
+        description: string;
+    };
+    createSchema: {
+        required: readonly ["owner", "displayName"];
+        properties: {
+            owner: {
+                type: "address";
+                description: string;
+                immutable: true;
+            };
+            displayName: {
+                type: "string";
+                maxLength: number;
+                description: string;
+            };
+            bio: {
+                type: "string";
+                maxLength: number;
+                default: string;
+            };
+            avatar: {
+                type: "uri";
+                default: null;
+            };
+            platforms: {
+                type: "array";
+                items: {
+                    $ref: string;
+                };
+                default: never[];
+            };
+        };
+    };
+    stateSchema: {
+        properties: {
+            owner: {
+                type: "address";
+                immutable: true;
+            };
+            displayName: {
+                type: "string";
+            };
+            bio: {
+                type: "string";
+            };
+            avatar: {
+                type: "uri";
+            };
+            platforms: {
+                type: "array";
+                items: {
+                    $ref: string;
+                };
+            };
+            status: {
+                type: "string";
+                enum: readonly ["REGISTERED", "ACTIVE", "CHALLENGED", "SUSPENDED", "PROBATION", "WITHDRAWN"];
+                computed: true;
+            };
+            reputation: {
+                type: "integer";
+                default: number;
+                computed: true;
+            };
+            activatedAt: {
+                type: "timestamp";
+                computed: true;
+            };
+            suspendedAt: {
+                type: "timestamp";
+                computed: true;
+            };
+            probationStartedAt: {
+                type: "timestamp";
+                computed: true;
+            };
+            challengedBy: {
+                type: "address";
+                computed: true;
+            };
+        };
+    };
+    eventSchemas: {
+        activate: {
+            description: string;
+        };
+        receive_vouch: {
+            description: string;
+            required: readonly ["from"];
+            properties: {
+                from: {
+                    type: "address";
+                    description: string;
+                };
+                weight: {
+                    type: "integer";
+                    minimum: number;
+                    maximum: number;
+                    default: number;
+                };
+            };
+        };
+        receive_completion: {
+            description: string;
+        };
+        challenge: {
+            description: string;
+            required: readonly ["challenger", "reason"];
+            properties: {
+                challenger: {
+                    type: "address";
+                };
+                reason: {
+                    type: "string";
+                    maxLength: number;
+                };
+                evidence: {
+                    type: "array";
+                    items: {
+                        type: "uri";
+                    };
+                };
+            };
+        };
+        dismiss_challenge: {
+            description: string;
+        };
+        uphold_challenge: {
+            description: string;
+        };
+        begin_probation: {
+            description: string;
+        };
+        complete_probation: {
+            description: string;
+        };
+        withdraw: {
+            description: string;
+        };
+    };
+    definitions: {
+        PlatformLink: {
+            type: "object";
+            required: readonly ["platform", "handle"];
+            properties: {
+                platform: {
+                    type: "string";
+                    enum: readonly ["twitter", "github", "discord", "telegram", "moltbook"];
+                };
+                handle: {
+                    type: "string";
+                };
+                verified: {
+                    type: "boolean";
+                    default: boolean;
+                };
+            };
+        };
+    };
+    states: {
+        REGISTERED: {
+            id: string;
+            isFinal: false;
+        };
+        ACTIVE: {
+            id: string;
+            isFinal: false;
+        };
+        CHALLENGED: {
+            id: string;
+            isFinal: false;
+        };
+        SUSPENDED: {
+            id: string;
+            isFinal: false;
+        };
+        PROBATION: {
+            id: string;
+            isFinal: false;
+        };
+        WITHDRAWN: {
+            id: string;
+            isFinal: true;
+        };
+    };
+    initialState: "REGISTERED";
+    transitions: ({
+        from: "REGISTERED";
+        to: "ACTIVE";
+        eventName: "activate";
+        guard: {
+            "==": number[];
+            "!!"?: undefined;
+        };
+        effect: {
+            merge: ({
+                var: string;
+                status?: undefined;
+                activatedAt?: undefined;
+            } | {
+                status: string;
+                activatedAt: {
+                    var: string;
+                };
+                var?: undefined;
+            })[];
+        };
+    } | {
+        from: "ACTIVE";
+        to: "ACTIVE";
+        eventName: "receive_vouch";
+        guard: {
+            "!!": {
+                var: string;
+            }[];
+            "=="?: undefined;
+        };
+        effect: {
+            merge: ({
+                var: string;
+                reputation?: undefined;
+            } | {
+                reputation: {
+                    "+": (number | {
+                        var: string;
+                    })[];
+                };
+                var?: undefined;
+            })[];
+        };
+    } | {
+        from: "ACTIVE";
+        to: "ACTIVE";
+        eventName: "receive_completion";
+        guard: {
+            "==": number[];
+            "!!"?: undefined;
+        };
+        effect: {
+            merge: ({
+                var: string;
+                reputation?: undefined;
+            } | {
+                reputation: {
+                    "+": (number | {
+                        var: string;
+                    })[];
+                };
+                var?: undefined;
+            })[];
+        };
+    } | {
+        from: "ACTIVE";
+        to: "CHALLENGED";
+        eventName: "challenge";
+        guard: {
+            "!!": {
+                var: string;
+            }[];
+            "=="?: undefined;
+        };
+        effect: {
+            merge: ({
+                var: string;
+                status?: undefined;
+                challengedBy?: undefined;
+            } | {
+                status: string;
+                challengedBy: {
+                    var: string;
+                };
+                var?: undefined;
+            })[];
+        };
+    } | {
+        from: "CHALLENGED";
+        to: "ACTIVE";
+        eventName: "dismiss_challenge";
+        guard: {
+            "==": number[];
+            "!!"?: undefined;
+        };
+        effect: {
+            merge: ({
+                var: string;
+                status?: undefined;
+                challengedBy?: undefined;
+            } | {
+                status: string;
+                challengedBy: null;
+                var?: undefined;
+            })[];
+        };
+    } | {
+        from: "CHALLENGED";
+        to: "SUSPENDED";
+        eventName: "uphold_challenge";
+        guard: {
+            "==": number[];
+            "!!"?: undefined;
+        };
+        effect: {
+            merge: ({
+                var: string;
+                status?: undefined;
+                suspendedAt?: undefined;
+            } | {
+                status: string;
+                suspendedAt: {
+                    var: string;
+                };
+                var?: undefined;
+            })[];
+        };
+    } | {
+        from: "SUSPENDED";
+        to: "PROBATION";
+        eventName: "begin_probation";
+        guard: {
+            "==": number[];
+            "!!"?: undefined;
+        };
+        effect: {
+            merge: ({
+                var: string;
+                status?: undefined;
+                probationStartedAt?: undefined;
+            } | {
+                status: string;
+                probationStartedAt: {
+                    var: string;
+                };
+                var?: undefined;
+            })[];
+        };
+    } | {
+        from: "PROBATION";
+        to: "ACTIVE";
+        eventName: "complete_probation";
+        guard: {
+            "==": number[];
+            "!!"?: undefined;
+        };
+        effect: {
+            merge: ({
+                var: string;
+                status?: undefined;
+                probationStartedAt?: undefined;
+            } | {
+                status: string;
+                probationStartedAt: null;
+                var?: undefined;
+            })[];
+        };
+    } | {
+        from: "ACTIVE";
+        to: "WITHDRAWN";
+        eventName: "withdraw";
+        guard: {
+            "==": number[];
+            "!!"?: undefined;
+        };
+        effect: {
+            merge: ({
+                var: string;
+                status?: undefined;
+            } | {
+                status: string;
+                var?: undefined;
+            })[];
+        };
+    } | {
+        from: "REGISTERED";
+        to: "WITHDRAWN";
+        eventName: "withdraw";
+        guard: {
+            "==": number[];
+            "!!"?: undefined;
+        };
+        effect: {
+            merge: ({
+                var: string;
+                status?: undefined;
+            } | {
+                status: string;
+                var?: undefined;
+            })[];
+        };
+    })[];
+};
+export type AgentState = keyof typeof identityAgentDef.states;
+export type AgentEvent = (typeof identityAgentDef.transitions)[number]["eventName"];