@ottochain/sdk 2.0.0 → 2.2.0

package/dist/cjs/apps/identity/constants.js

@@ -2,31 +2,45 @@
 /**
  * Identity Constants
  *
- * State machine transitions and configuration constants for agent identity.
+ * State machine transitions and configuration constants for identity types.
  *
  * @packageDocumentation
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getReputationDelta = exports.canTransition = exports.ATTESTATION_DELTAS = exports.AGENT_TRANSITIONS = void 0;
-const agent_js_1 = require("../../generated/ottochain/apps/identity/v1/agent.js");
+exports.getReputationDelta = exports.canTransition = exports.ATTESTATION_DELTAS = exports.AGENT_TRANSITIONS = exports.IDENTITY_TRANSITIONS = void 0;
+const identity_js_1 = require("../../generated/ottochain/apps/identity/v1/identity.js");
 const attestation_js_1 = require("../../generated/ottochain/apps/identity/v1/attestation.js");
 // ---------------------------------------------------------------------------
 // State Machine Transitions
 // ---------------------------------------------------------------------------
 /**
- * Valid transitions for each agent state.
+ * Valid transitions for each identity state.
  * Maps current state to allowed event names.
+ * Note: Some transitions are type-specific (agent vs oracle)
  */
-exports.AGENT_TRANSITIONS = {
-    [agent_js_1.AgentState.AGENT_STATE_UNSPECIFIED]: [],
-    [agent_js_1.AgentState.AGENT_STATE_REGISTERED]: ['activate', 'withdraw'],
-    [agent_js_1.AgentState.AGENT_STATE_ACTIVE]: ['challenge', 'withdraw'],
-    [agent_js_1.AgentState.AGENT_STATE_CHALLENGED]: ['uphold_challenge', 'dismiss_challenge'],
-    [agent_js_1.AgentState.AGENT_STATE_SUSPENDED]: ['begin_probation'],
-    [agent_js_1.AgentState.AGENT_STATE_PROBATION]: ['complete_probation'],
-    [agent_js_1.AgentState.AGENT_STATE_WITHDRAWN]: [], // Terminal state
-    [agent_js_1.AgentState.UNRECOGNIZED]: [],
+exports.IDENTITY_TRANSITIONS = {
+    [identity_js_1.IdentityState.IDENTITY_STATE_UNSPECIFIED]: [],
+    [identity_js_1.IdentityState.IDENTITY_STATE_UNREGISTERED]: ["register"],
+    [identity_js_1.IdentityState.IDENTITY_STATE_REGISTERED]: ["activate", "withdraw"],
+    [identity_js_1.IdentityState.IDENTITY_STATE_ACTIVE]: [
+        "challenge",
+        "slash",
+        "deactivate",
+        "withdraw",
+    ],
+    [identity_js_1.IdentityState.IDENTITY_STATE_CHALLENGED]: [
+        "uphold_challenge",
+        "dismiss_challenge",
+    ],
+    [identity_js_1.IdentityState.IDENTITY_STATE_SUSPENDED]: ["begin_probation"],
+    [identity_js_1.IdentityState.IDENTITY_STATE_PROBATION]: ["complete_probation"],
+    [identity_js_1.IdentityState.IDENTITY_STATE_SLASHED]: ["reactivate", "withdraw"],
+    [identity_js_1.IdentityState.IDENTITY_STATE_INACTIVE]: ["activate", "withdraw"],
+    [identity_js_1.IdentityState.IDENTITY_STATE_WITHDRAWN]: [], // Terminal state
+    [identity_js_1.IdentityState.UNRECOGNIZED]: [],
 };
+// Legacy alias
+exports.AGENT_TRANSITIONS = exports.IDENTITY_TRANSITIONS;
 // ---------------------------------------------------------------------------
 // Reputation Configuration
 // ---------------------------------------------------------------------------
@@ -46,7 +60,7 @@ exports.ATTESTATION_DELTAS = {
  * Check if a transition is valid for the given state.
  */
 function canTransition(state, event) {
-    return exports.AGENT_TRANSITIONS[state]?.includes(event) ?? false;
+    return exports.IDENTITY_TRANSITIONS[state]?.includes(event) ?? false;
 }
 exports.canTransition = canTransition;
 /**

package/dist/cjs/apps/identity/index.js

@@ -18,18 +18,32 @@
  * @packageDocumentation
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getIdentityDefinition = exports.IDENTITY_DEFINITIONS = exports.identityOracleDef = exports.identityAgentDef = exports.identityUniversalDef = exports.DEFAULT_REPUTATION_CONFIG = exports.getReputationDelta = exports.canTransition = exports.ATTESTATION_DELTAS = exports.AGENT_TRANSITIONS = exports.attestationTypeToJSON = exports.attestationTypeFromJSON = exports.ReputationConfig = exports.ChallengeRequest = exports.VouchRequest = exports.Attestation = exports.ReputationDelta = exports.AttestationType = exports.platformToJSON = exports.platformFromJSON = exports.agentStateToJSON = exports.agentStateFromJSON = exports.AgentIdentityDefinition = exports.AgentIdentity = exports.PlatformLink = exports.Platform = exports.AgentState = void 0;
+exports.getIdentityDefinition = exports.IDENTITY_DEFINITIONS = exports.identityOracleDef = exports.identityAgentDef = exports.identityUniversalDef = exports.DEFAULT_REPUTATION_CONFIG = exports.getReputationDelta = exports.canTransition = exports.ATTESTATION_DELTAS = exports.AGENT_TRANSITIONS = exports.IDENTITY_TRANSITIONS = exports.attestationTypeToJSON = exports.attestationTypeFromJSON = exports.ReputationConfig = exports.ChallengeRequest = exports.VouchRequest = exports.Attestation = exports.ReputationDelta = exports.AttestationType = exports.AgentState = exports.platformToJSON = exports.platformFromJSON = exports.identityStateToJSON = exports.identityStateFromJSON = exports.identityTypeToJSON = exports.identityTypeFromJSON = exports.IdentityDefinition = exports.WithdrawIdentityRequest = exports.AddStakeRequest = exports.ChallengeIdentityRequest = exports.LinkPlatformRequest = exports.ActivateIdentityRequest = exports.RegisterIdentityRequest = exports.Identity = exports.PenaltyEvent = exports.Reputation = exports.PlatformLink = exports.Platform = exports.IdentityState = exports.IdentityType = void 0;
 // Re-export generated protobuf types (source of truth)
-var agent_js_1 = require("../../generated/ottochain/apps/identity/v1/agent.js");
-Object.defineProperty(exports, "AgentState", { enumerable: true, get: function () { return agent_js_1.AgentState; } });
-Object.defineProperty(exports, "Platform", { enumerable: true, get: function () { return agent_js_1.Platform; } });
-Object.defineProperty(exports, "PlatformLink", { enumerable: true, get: function () { return agent_js_1.PlatformLink; } });
-Object.defineProperty(exports, "AgentIdentity", { enumerable: true, get: function () { return agent_js_1.AgentIdentity; } });
-Object.defineProperty(exports, "AgentIdentityDefinition", { enumerable: true, get: function () { return agent_js_1.AgentIdentityDefinition; } });
-Object.defineProperty(exports, "agentStateFromJSON", { enumerable: true, get: function () { return agent_js_1.agentStateFromJSON; } });
-Object.defineProperty(exports, "agentStateToJSON", { enumerable: true, get: function () { return agent_js_1.agentStateToJSON; } });
-Object.defineProperty(exports, "platformFromJSON", { enumerable: true, get: function () { return agent_js_1.platformFromJSON; } });
-Object.defineProperty(exports, "platformToJSON", { enumerable: true, get: function () { return agent_js_1.platformToJSON; } });
+var identity_js_1 = require("../../generated/ottochain/apps/identity/v1/identity.js");
+Object.defineProperty(exports, "IdentityType", { enumerable: true, get: function () { return identity_js_1.IdentityType; } });
+Object.defineProperty(exports, "IdentityState", { enumerable: true, get: function () { return identity_js_1.IdentityState; } });
+Object.defineProperty(exports, "Platform", { enumerable: true, get: function () { return identity_js_1.Platform; } });
+Object.defineProperty(exports, "PlatformLink", { enumerable: true, get: function () { return identity_js_1.PlatformLink; } });
+Object.defineProperty(exports, "Reputation", { enumerable: true, get: function () { return identity_js_1.Reputation; } });
+Object.defineProperty(exports, "PenaltyEvent", { enumerable: true, get: function () { return identity_js_1.PenaltyEvent; } });
+Object.defineProperty(exports, "Identity", { enumerable: true, get: function () { return identity_js_1.Identity; } });
+Object.defineProperty(exports, "RegisterIdentityRequest", { enumerable: true, get: function () { return identity_js_1.RegisterIdentityRequest; } });
+Object.defineProperty(exports, "ActivateIdentityRequest", { enumerable: true, get: function () { return identity_js_1.ActivateIdentityRequest; } });
+Object.defineProperty(exports, "LinkPlatformRequest", { enumerable: true, get: function () { return identity_js_1.LinkPlatformRequest; } });
+Object.defineProperty(exports, "ChallengeIdentityRequest", { enumerable: true, get: function () { return identity_js_1.ChallengeIdentityRequest; } });
+Object.defineProperty(exports, "AddStakeRequest", { enumerable: true, get: function () { return identity_js_1.AddStakeRequest; } });
+Object.defineProperty(exports, "WithdrawIdentityRequest", { enumerable: true, get: function () { return identity_js_1.WithdrawIdentityRequest; } });
+Object.defineProperty(exports, "IdentityDefinition", { enumerable: true, get: function () { return identity_js_1.IdentityDefinition; } });
+Object.defineProperty(exports, "identityTypeFromJSON", { enumerable: true, get: function () { return identity_js_1.identityTypeFromJSON; } });
+Object.defineProperty(exports, "identityTypeToJSON", { enumerable: true, get: function () { return identity_js_1.identityTypeToJSON; } });
+Object.defineProperty(exports, "identityStateFromJSON", { enumerable: true, get: function () { return identity_js_1.identityStateFromJSON; } });
+Object.defineProperty(exports, "identityStateToJSON", { enumerable: true, get: function () { return identity_js_1.identityStateToJSON; } });
+Object.defineProperty(exports, "platformFromJSON", { enumerable: true, get: function () { return identity_js_1.platformFromJSON; } });
+Object.defineProperty(exports, "platformToJSON", { enumerable: true, get: function () { return identity_js_1.platformToJSON; } });
+// Legacy aliases for backward compatibility
+var identity_js_2 = require("../../generated/ottochain/apps/identity/v1/identity.js");
+Object.defineProperty(exports, "AgentState", { enumerable: true, get: function () { return identity_js_2.IdentityState; } });
 var attestation_js_1 = require("../../generated/ottochain/apps/identity/v1/attestation.js");
 Object.defineProperty(exports, "AttestationType", { enumerable: true, get: function () { return attestation_js_1.AttestationType; } });
 Object.defineProperty(exports, "ReputationDelta", { enumerable: true, get: function () { return attestation_js_1.ReputationDelta; } });
@@ -41,6 +55,7 @@ Object.defineProperty(exports, "attestationTypeFromJSON", { enumerable: true, ge
 Object.defineProperty(exports, "attestationTypeToJSON", { enumerable: true, get: function () { return attestation_js_1.attestationTypeToJSON; } });
 // Re-export constants and utilities
 var constants_js_1 = require("./constants.js");
+Object.defineProperty(exports, "IDENTITY_TRANSITIONS", { enumerable: true, get: function () { return constants_js_1.IDENTITY_TRANSITIONS; } });
 Object.defineProperty(exports, "AGENT_TRANSITIONS", { enumerable: true, get: function () { return constants_js_1.AGENT_TRANSITIONS; } });
 Object.defineProperty(exports, "ATTESTATION_DELTAS", { enumerable: true, get: function () { return constants_js_1.ATTESTATION_DELTAS; } });
 Object.defineProperty(exports, "canTransition", { enumerable: true, get: function () { return constants_js_1.canTransition; } });
@@ -77,7 +92,7 @@ exports.IDENTITY_DEFINITIONS = {
  * Get an identity state machine definition by type.
  * @param type - 'universal' | 'agent' | 'oracle' (default: 'agent')
  */
-function getIdentityDefinition(type = 'agent') {
+function getIdentityDefinition(type = "agent") {
     return exports.IDENTITY_DEFINITIONS[type];
 }
 exports.getIdentityDefinition = getIdentityDefinition;

package/dist/cjs/apps/identity/state-machines/identity-agent.js

@@ -0,0 +1,256 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.identityAgentDef = void 0;
+const fiber_app_js_1 = require("../../../schema/fiber-app.js");
+/**
+ * Standard agent identity with reputation tracking, vouching, and lifecycle management.
+ */
+exports.identityAgentDef = (0, fiber_app_js_1.defineFiberApp)({
+    metadata: {
+        name: "IdentityAgent",
+        app: "identity",
+        type: "agent",
+        version: "1.0.0",
+        description: "Standard agent identity with reputation tracking, vouching, and lifecycle management",
+    },
+    createSchema: {
+        required: ["owner", "displayName"],
+        properties: {
+            owner: {
+                type: "address",
+                description: "Agent owner DAG address",
+                immutable: true,
+            },
+            displayName: {
+                type: "string",
+                maxLength: 64,
+                description: "Human-readable agent name",
+            },
+            bio: {
+                type: "string",
+                maxLength: 256,
+                default: "",
+            },
+            avatar: {
+                type: "uri",
+                default: null,
+            },
+            platforms: {
+                type: "array",
+                items: { $ref: "#/definitions/PlatformLink" },
+                default: [],
+            },
+        },
+    },
+    stateSchema: {
+        properties: {
+            owner: { type: "address", immutable: true },
+            displayName: { type: "string" },
+            bio: { type: "string" },
+            avatar: { type: "uri" },
+            platforms: {
+                type: "array",
+                items: { $ref: "#/definitions/PlatformLink" },
+            },
+            status: {
+                type: "string",
+                enum: [
+                    "REGISTERED",
+                    "ACTIVE",
+                    "CHALLENGED",
+                    "SUSPENDED",
+                    "PROBATION",
+                    "WITHDRAWN",
+                ],
+                computed: true,
+            },
+            reputation: { type: "integer", default: 10, 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: "Activate a registered agent",
+        },
+        receive_vouch: {
+            description: "Receive a vouch from another agent",
+            required: ["from"],
+            properties: {
+                from: { type: "address", description: "Address of vouching agent" },
+                weight: { type: "integer", minimum: 1, maximum: 10, default: 1 },
+            },
+        },
+        receive_completion: {
+            description: "Receive completion attestation from a fiber",
+        },
+        challenge: {
+            description: "Challenge an active agent's behavior",
+            required: ["challenger", "reason"],
+            properties: {
+                challenger: { type: "address" },
+                reason: { type: "string", maxLength: 512 },
+                evidence: { type: "array", items: { type: "uri" } },
+            },
+        },
+        dismiss_challenge: {
+            description: "Dismiss an active challenge",
+        },
+        uphold_challenge: {
+            description: "Uphold a challenge, suspending the agent",
+        },
+        begin_probation: {
+            description: "Move suspended agent to probation",
+        },
+        complete_probation: {
+            description: "Complete probation, reactivating the agent",
+        },
+        withdraw: {
+            description: "Permanently withdraw the agent",
+        },
+    },
+    definitions: {
+        PlatformLink: {
+            type: "object",
+            required: ["platform", "handle"],
+            properties: {
+                platform: {
+                    type: "string",
+                    enum: [
+                        "twitter",
+                        "github",
+                        "discord",
+                        "telegram",
+                        "moltbook",
+                    ],
+                },
+                handle: { type: "string" },
+                verified: { type: "boolean", default: false },
+            },
+        },
+    },
+    states: {
+        REGISTERED: { id: "REGISTERED", isFinal: false },
+        ACTIVE: { id: "ACTIVE", isFinal: false },
+        CHALLENGED: { id: "CHALLENGED", isFinal: false },
+        SUSPENDED: { id: "SUSPENDED", isFinal: false },
+        PROBATION: { id: "PROBATION", isFinal: false },
+        WITHDRAWN: { id: "WITHDRAWN", isFinal: true },
+    },
+    initialState: "REGISTERED",
+    transitions: [
+        {
+            from: "REGISTERED",
+            to: "ACTIVE",
+            eventName: "activate",
+            guard: { "==": [1, 1] },
+            effect: {
+                merge: [
+                    { var: "state" },
+                    { status: "ACTIVE", activatedAt: { var: "$timestamp" } },
+                ],
+            },
+        },
+        {
+            from: "ACTIVE",
+            to: "ACTIVE",
+            eventName: "receive_vouch",
+            guard: { "!!": [{ var: "event.from" }] },
+            effect: {
+                merge: [
+                    { var: "state" },
+                    { reputation: { "+": [{ var: "state.reputation" }, 2] } },
+                ],
+            },
+        },
+        {
+            from: "ACTIVE",
+            to: "ACTIVE",
+            eventName: "receive_completion",
+            guard: { "==": [1, 1] },
+            effect: {
+                merge: [
+                    { var: "state" },
+                    { reputation: { "+": [{ var: "state.reputation" }, 5] } },
+                ],
+            },
+        },
+        {
+            from: "ACTIVE",
+            to: "CHALLENGED",
+            eventName: "challenge",
+            guard: { "!!": [{ var: "event.challenger" }] },
+            effect: {
+                merge: [
+                    { var: "state" },
+                    { status: "CHALLENGED", challengedBy: { var: "event.challenger" } },
+                ],
+            },
+        },
+        {
+            from: "CHALLENGED",
+            to: "ACTIVE",
+            eventName: "dismiss_challenge",
+            guard: { "==": [1, 1] },
+            effect: {
+                merge: [{ var: "state" }, { status: "ACTIVE", challengedBy: null }],
+            },
+        },
+        {
+            from: "CHALLENGED",
+            to: "SUSPENDED",
+            eventName: "uphold_challenge",
+            guard: { "==": [1, 1] },
+            effect: {
+                merge: [
+                    { var: "state" },
+                    { status: "SUSPENDED", suspendedAt: { var: "$timestamp" } },
+                ],
+            },
+        },
+        {
+            from: "SUSPENDED",
+            to: "PROBATION",
+            eventName: "begin_probation",
+            guard: { "==": [1, 1] },
+            effect: {
+                merge: [
+                    { var: "state" },
+                    { status: "PROBATION", probationStartedAt: { var: "$timestamp" } },
+                ],
+            },
+        },
+        {
+            from: "PROBATION",
+            to: "ACTIVE",
+            eventName: "complete_probation",
+            guard: { "==": [1, 1] },
+            effect: {
+                merge: [
+                    { var: "state" },
+                    { status: "ACTIVE", probationStartedAt: null },
+                ],
+            },
+        },
+        {
+            from: "ACTIVE",
+            to: "WITHDRAWN",
+            eventName: "withdraw",
+            guard: { "==": [1, 1] },
+            effect: {
+                merge: [{ var: "state" }, { status: "WITHDRAWN" }],
+            },
+        },
+        {
+            from: "REGISTERED",
+            to: "WITHDRAWN",
+            eventName: "withdraw",
+            guard: { "==": [1, 1] },
+            effect: {
+                merge: [{ var: "state" }, { status: "WITHDRAWN" }],
+            },
+        },
+    ],
+});