@motebit/sdk 0.6.11 → 0.8.0

package/dist/index.d.ts

@@ -1,203 +1,15 @@
-declare const __brand: unique symbol;
-type Brand<T, B extends string> = T & {
-    readonly [__brand]?: B;
-};
-export type MotebitId = Brand<string, "MotebitId">;
-export type DeviceId = Brand<string, "DeviceId">;
-export type NodeId = Brand<string, "NodeId">;
-export type GoalId = Brand<string, "GoalId">;
-export type EventId = Brand<string, "EventId">;
-export type ConversationId = Brand<string, "ConversationId">;
-export type PlanId = Brand<string, "PlanId">;
-export type AllocationId = Brand<string, "AllocationId">;
-export type SettlementId = Brand<string, "SettlementId">;
-export type ListingId = Brand<string, "ListingId">;
-export type ProposalId = Brand<string, "ProposalId">;
-/** Brand a string as a MotebitId after validation. */
-export declare function asMotebitId(id: string): MotebitId;
-/** Brand a string as a DeviceId after validation. */
-export declare function asDeviceId(id: string): DeviceId;
-/** Brand a string as a NodeId after validation. */
-export declare function asNodeId(id: string): NodeId;
-/** Brand a string as a GoalId after validation. */
-export declare function asGoalId(id: string): GoalId;
-/** Brand a string as an EventId after validation. */
-export declare function asEventId(id: string): EventId;
-/** Brand a string as a ConversationId after validation. */
-export declare function asConversationId(id: string): ConversationId;
-/** Brand a string as a PlanId after validation. */
-export declare function asPlanId(id: string): PlanId;
-/** Brand a string as an AllocationId after validation. */
-export declare function asAllocationId(id: string): AllocationId;
-/** Brand a string as a SettlementId after validation. */
-export declare function asSettlementId(id: string): SettlementId;
-/** Brand a string as a ListingId after validation. */
-export declare function asListingId(id: string): ListingId;
-/** Brand a string as a ProposalId after validation. */
-export declare function asProposalId(id: string): ProposalId;
-export declare enum TrustMode {
-    Full = "full",
-    Guarded = "guarded",
-    Minimal = "minimal"
-}
-export declare enum BatteryMode {
-    Normal = "normal",
-    LowPower = "low_power",
-    Critical = "critical"
-}
-export declare enum AgentTrustLevel {
-    Unknown = "unknown",
-    FirstContact = "first_contact",
-    Verified = "verified",
-    Trusted = "trusted",
-    Blocked = "blocked"
-}
-export declare enum MotebitType {
-    Personal = "personal",
-    Service = "service",
-    Collaborative = "collaborative"
-}
-export declare enum ProposalStatus {
-    Pending = "pending",
-    Accepted = "accepted",
-    Countered = "countered",
-    Rejected = "rejected",
-    Withdrawn = "withdrawn",
-    Expired = "expired"
-}
-export declare enum ProposalResponseType {
-    Accept = "accept",
-    Reject = "reject",
-    Counter = "counter"
-}
-export interface AgentTrustRecord {
-    motebit_id: MotebitId;
-    remote_motebit_id: MotebitId;
-    trust_level: AgentTrustLevel;
-    public_key?: string;
-    first_seen_at: number;
-    last_seen_at: number;
-    interaction_count: number;
-    successful_tasks?: number;
-    failed_tasks?: number;
-    notes?: string;
-    /** Exponential moving average of result quality [0, 1]. */
-    avg_quality?: number;
-    /** Number of quality samples collected. */
-    quality_sample_count?: number;
-}
-/** Canonical AgentTrustLevel → [0,1] mapping (single source of truth). */
-export declare const TRUST_LEVEL_SCORES: Record<string, number>;
-/** Convert a trust level to its numeric score. */
-export declare function trustLevelToScore(level: AgentTrustLevel | string): number;
-/** Semiring zero — annihilator for ⊗, identity for ⊕. */
-export declare const TRUST_ZERO = 0;
-/** Semiring one — identity for ⊗. */
-export declare const TRUST_ONE = 1;
-/** ⊕: parallel paths — pick the best route. */
-export declare function trustAdd(a: number, b: number): number;
-/** ⊗: serial chain — discount per hop. */
-export declare function trustMultiply(a: number, b: number): number;
-/** Fold a chain of trust scores with ⊗. Empty chain → 1.0 (identity). */
-export declare function composeTrustChain(scores: number[]): number;
-/** Fold parallel route scores with ⊕. No routes → 0.0 (identity). */
-export declare function joinParallelRoutes(scores: number[]): number;
-/** Thresholds for automatic trust level promotion/demotion. */
-export interface TrustTransitionThresholds {
-    /** Min successful tasks for FirstContact → Verified (default 5) */
-    promoteToVerified_minTasks: number;
-    /** Min success rate for FirstContact → Verified (default 0.8) */
-    promoteToVerified_minRate: number;
-    /** Min successful tasks for Verified → Trusted (default 20) */
-    promoteToTrusted_minTasks: number;
-    /** Min success rate for Verified → Trusted (default 0.9) */
-    promoteToTrusted_minRate: number;
-    /** Success rate below this triggers demotion (default 0.5) */
-    demote_belowRate: number;
-    /** Min total tasks before demotion can trigger (default 3) */
-    demote_minTasks: number;
-}
-export declare const DEFAULT_TRUST_THRESHOLDS: TrustTransitionThresholds;
-/**
- * Pure: evaluate whether a trust record should transition levels.
- *
- * Promotion: sustained evidence of success (asymmetric — harder to earn).
- * Demotion: success rate dropping below threshold (faster — protect the network).
- * Blocked is never auto-assigned or auto-removed (security decision).
- *
- * Returns the new level, or null if no transition.
- */
-export declare function evaluateTrustTransition(record: AgentTrustRecord, thresholds?: Partial<TrustTransitionThresholds>): AgentTrustLevel | null;
-/** Structural type for recursive delegation receipt walking. */
-export interface DelegationReceiptLike {
-    motebit_id: string;
-    delegation_receipts?: DelegationReceiptLike[];
-}
-/**
- * Compose trust through a delegation receipt tree.
- *
- * Walks `receipt.delegation_receipts` recursively:
- * - Each sub-delegation: directTrust ⊗ getTrust(sub.motebit_id)
- * - Parallel branches joined with ⊕ (best route wins)
- * - No sub-delegations → returns directTrust unchanged.
- */
-export declare function composeDelegationTrust(directTrust: number, receipt: DelegationReceiptLike, getTrust: (motebitId: string) => number): number;
-export declare enum SensitivityLevel {
-    None = "none",
-    Personal = "personal",
-    Medical = "medical",
-    Financial = "financial",
-    Secret = "secret"
-}
-export declare enum EventType {
-    IdentityCreated = "identity_created",
-    StateUpdated = "state_updated",
-    MemoryFormed = "memory_formed",
-    MemoryDecayed = "memory_decayed",
-    MemoryDeleted = "memory_deleted",
-    MemoryAccessed = "memory_accessed",
-    ProviderSwapped = "provider_swapped",
-    ExportRequested = "export_requested",
-    DeleteRequested = "delete_requested",
-    SyncCompleted = "sync_completed",
-    AuditEntry = "audit_entry",
-    ToolUsed = "tool_used",
-    PolicyViolation = "policy_violation",
-    GoalCreated = "goal_created",
-    GoalExecuted = "goal_executed",
-    GoalRemoved = "goal_removed",
-    ApprovalRequested = "approval_requested",
-    ApprovalApproved = "approval_approved",
-    ApprovalDenied = "approval_denied",
-    ApprovalExpired = "approval_expired",
-    GoalCompleted = "goal_completed",
-    GoalProgress = "goal_progress",
-    MemoryAudit = "memory_audit",
-    MemoryPinned = "memory_pinned",
-    PlanCreated = "plan_created",
-    PlanStepStarted = "plan_step_started",
-    PlanStepCompleted = "plan_step_completed",
-    PlanStepFailed = "plan_step_failed",
-    PlanCompleted = "plan_completed",
-    PlanStepDelegated = "plan_step_delegated",
-    CredentialRevoked = "credential_revoked",
-    IdentityRevoked = "identity_revoked",
-    PlanFailed = "plan_failed",
-    HousekeepingRun = "housekeeping_run",
-    ReflectionCompleted = "reflection_completed",
-    MemoryConsolidated = "memory_consolidated",
-    AgentTaskCompleted = "agent_task_completed",
-    AgentTaskFailed = "agent_task_failed",
-    AgentTaskDenied = "agent_task_denied",
-    ProposalCreated = "proposal_created",
-    ProposalAccepted = "proposal_accepted",
-    ProposalRejected = "proposal_rejected",
-    ProposalCountered = "proposal_countered",
-    CollaborativeStepCompleted = "collaborative_step_completed",
-    ChainTrustComputed = "chain_trust_computed",
-    TrustLevelChanged = "trust_level_changed",
-    KeyRotated = "key_rotated"
-}
+export * from "@motebit/protocol";
+export * from "./models.js";
+export * from "./provider-mode.js";
+export * from "./provider-resolver.js";
+export * from "./color-presets.js";
+export * from "./approval-presets.js";
+export * from "./risk-labels.js";
+export * from "./surface-options.js";
+export * from "./governance-config.js";
+export * from "./voice-config.js";
+export * from "./appearance-config.js";
+import type { SensitivityLevel, NodeId, MotebitId, TrustMode, BatteryMode, EventLogEntry, MemoryContent, MemoryCandidate, ToolDefinition, AgentTrustRecord, EventStoreAdapter, IdentityStorage, AuditLogAdapter, StateSnapshotAdapter, AuditLogSink, ConversationStoreAdapter, PlanStoreAdapter, AgentTrustStoreAdapter, ServiceListingStoreAdapter, BudgetAllocationStoreAdapter, SettlementStoreAdapter, LatencyStatsStoreAdapter, CredentialStoreAdapter, ApprovalStoreAdapter, MotebitIdentity, AuditRecord } from "@motebit/protocol";
 export declare enum RelationType {
     Related = "related",
     CausedBy = "caused_by",
@@ -207,16 +19,6 @@ export declare enum RelationType {
     PartOf = "part_of",
     Supersedes = "supersedes"
 }
-export declare enum MemoryType {
-    Episodic = "episodic",
-    Semantic = "semantic"
-}
-export interface MotebitIdentity {
-    readonly motebit_id: MotebitId;
-    readonly created_at: number;
-    readonly owner_id: string;
-    version_clock: number;
-}
 export interface MotebitState {
     attention: number;
     processing: number;
@@ -243,15 +45,6 @@ export declare const SPECIES_CONSTRAINTS: Readonly<{
     readonly DRIFT_VARIATION_MAX: 0.1;
 }>;
 export type SpeciesConstraints = typeof SPECIES_CONSTRAINTS;
-/** Cognition-facing memory content — what the agent's mind sees. */
-export interface MemoryContent {
-    content: string;
-    confidence: number;
-    sensitivity: SensitivityLevel;
-    memory_type?: MemoryType;
-    valid_from?: number;
-    valid_until?: number | null;
-}
 /** Full memory node including persistence metadata. */
 export interface MemoryNode extends MemoryContent {
     node_id: NodeId;
@@ -271,135 +64,51 @@ export interface MemoryEdge {
     weight: number;
     confidence: number;
 }
-export interface MemoryCandidate {
-    content: string;
-    confidence: number;
-    sensitivity: SensitivityLevel;
-    memory_type?: MemoryType;
-}
-export interface EventLogEntry {
-    event_id: EventId;
-    motebit_id: MotebitId;
-    /** Device that originated this event (for multi-device conflict resolution) */
-    device_id?: DeviceId;
-    timestamp: number;
-    event_type: EventType;
-    payload: Record<string, unknown>;
-    version_clock: number;
-    tombstoned: boolean;
-}
-export declare enum RiskLevel {
-    R0_READ = 0,
-    R1_DRAFT = 1,
-    R2_WRITE = 2,
-    R3_EXECUTE = 3,
-    R4_MONEY = 4
-}
-export declare enum DataClass {
-    PUBLIC = "public",
-    PRIVATE = "private",
-    SECRET = "secret"
-}
-export declare enum SideEffect {
-    NONE = "none",
-    REVERSIBLE = "reversible",
-    IRREVERSIBLE = "irreversible"
-}
-export interface ToolRiskProfile {
-    risk: RiskLevel;
-    dataClass: DataClass;
-    sideEffect: SideEffect;
-    requiresApproval: boolean;
-}
-/** M-of-N approval quorum configuration. */
-export interface ApprovalQuorum {
-    /** Number of approvals required (M). */
-    threshold: number;
-    /** Authorized approver identifiers. */
-    approvers: string[];
-    /** Minimum risk level that triggers quorum (optional — default: all approval-required tools). */
-    risk_floor?: string;
-}
-export interface PolicyDecision {
-    allowed: boolean;
-    requiresApproval: boolean;
-    reason?: string;
-    budgetRemaining?: {
-        calls: number;
-        timeMs: number;
-        cost: number;
-    };
-    /** When quorum is required, contains the quorum metadata. */
-    quorum?: {
-        required: number;
-        approvers: string[];
-        collected: string[];
-    };
-}
-export interface TurnContext {
-    turnId: string;
-    runId?: string;
-    toolCallCount: number;
-    turnStartMs: number;
-    costAccumulated: number;
-    /** Caller motebit ID — set in MCP server mode when caller presents a signed token. */
-    callerMotebitId?: string;
-    /** Caller trust level — set in MCP server mode for identity-aware policy decisions. */
-    callerTrustLevel?: AgentTrustLevel;
-    /** Type of the remote motebit making the call (personal/service/collaborative). */
-    remoteMotebitType?: string;
-    /** Delegation scope — when set, only tools within this scope are allowed. */
-    delegationScope?: string;
+export interface MemoryQuery {
+    motebit_id: string;
+    min_confidence?: number;
+    sensitivity_filter?: SensitivityLevel[];
+    limit?: number;
+    include_tombstoned?: boolean;
+    pinned?: boolean;
 }
-export interface InjectionWarning {
-    detected: boolean;
-    patterns: string[];
-    directiveDensity?: number;
-    structuralFlags?: string[];
+export interface MemoryStorageAdapter {
+    saveNode(node: MemoryNode): Promise<void>;
+    getNode(nodeId: string): Promise<MemoryNode | null>;
+    queryNodes(query: MemoryQuery): Promise<MemoryNode[]>;
+    saveEdge(edge: MemoryEdge): Promise<void>;
+    getEdges(nodeId: string): Promise<MemoryEdge[]>;
+    tombstoneNode(nodeId: string): Promise<void>;
+    /** Tombstone with ownership check. Returns true if the node existed and belonged to motebitId. */
+    tombstoneNodeOwned?(nodeId: string, motebitId: string): Promise<boolean>;
+    pinNode(nodeId: string, pinned: boolean): Promise<void>;
+    getAllNodes(motebitId: string): Promise<MemoryNode[]>;
+    getAllEdges(motebitId: string): Promise<MemoryEdge[]>;
 }
-export interface ToolAuditEntry {
-    turnId: string;
-    runId?: string;
-    callId: string;
-    tool: string;
-    args: Record<string, unknown>;
-    decision: PolicyDecision;
-    result?: {
-        ok: boolean;
-        durationMs: number;
-    };
-    injection?: InjectionWarning;
-    costUnits?: number;
-    timestamp: number;
+export interface RenderSpec {
+    geometry: GeometrySpec;
+    material: MaterialSpec;
+    lighting: LightingSpec;
 }
-export interface ToolDefinition {
-    name: string;
-    description: string;
-    inputSchema: Record<string, unknown>;
-    requiresApproval?: boolean;
-    /** Risk hint for PolicyGate classification. If absent, inferred from name/description. */
-    riskHint?: {
-        risk?: RiskLevel;
-        dataClass?: DataClass;
-        sideEffect?: SideEffect;
-    };
+export interface GeometrySpec {
+    form: "droplet";
+    base_radius: number;
+    height: number;
 }
-export interface ToolResult {
-    ok: boolean;
-    data?: unknown;
-    error?: string;
-    /** Set by adapters that already applied boundary wrapping (e.g. MCP client). */
-    _sanitized?: boolean;
+export interface MaterialSpec {
+    ior: number;
+    subsurface: number;
+    roughness: number;
+    clearcoat: number;
+    surface_noise_amplitude: number;
+    base_color: [number, number, number];
+    emissive_intensity: number;
+    tint: [number, number, number];
 }
-export type ToolHandler = (args: Record<string, unknown>) => Promise<ToolResult>;
-export interface ToolRegistry {
-    list(): ToolDefinition[];
-    execute(name: string, args: Record<string, unknown>): Promise<ToolResult>;
-    register(tool: ToolDefinition, handler: ToolHandler): void;
-    /** Replace the handler for an existing tool, or register if new. */
-    replace?(tool: ToolDefinition, handler: ToolHandler): void;
-    /** Remove a tool from the registry. Returns true if it existed. */
-    unregister?(name: string): boolean;
+export interface LightingSpec {
+    environment: "hdri";
+    exposure: number;
+    ambient_intensity: number;
 }
 export interface ContextPack {
     recent_events: EventLogEntry[];
@@ -464,15 +173,6 @@ export interface IntelligenceProvider {
     estimateConfidence(): Promise<number>;
     extractMemoryCandidates(response: AIResponse): Promise<MemoryCandidate[]>;
 }
-export interface AuditRecord {
-    audit_id: string;
-    motebit_id: MotebitId;
-    timestamp: number;
-    action: string;
-    target_type: string;
-    target_id: string;
-    details: Record<string, unknown>;
-}
 export interface ExportManifest {
     motebit_id: MotebitId;
     exported_at: number;
@@ -482,459 +182,6 @@ export interface ExportManifest {
     events: EventLogEntry[];
     audit_log: AuditRecord[];
 }
-export interface SyncCursor {
-    motebit_id: MotebitId;
-    last_event_id: EventId;
-    last_version_clock: number;
-}
-export interface ConflictEdge {
-    local_event: EventLogEntry;
-    remote_event: EventLogEntry;
-    resolution: "local_wins" | "remote_wins" | "merged" | "unresolved";
-}
-/** Conversation metadata for sync. Matches persistence Conversation shape using snake_case for wire format. */
-export interface SyncConversation {
-    conversation_id: ConversationId;
-    motebit_id: MotebitId;
-    started_at: number;
-    last_active_at: number;
-    title: string | null;
-    summary: string | null;
-    message_count: number;
-}
-/** Conversation message for sync. Matches persistence ConversationMessage shape using snake_case for wire format. */
-export interface SyncConversationMessage {
-    message_id: string;
-    conversation_id: ConversationId;
-    motebit_id: MotebitId;
-    role: string;
-    content: string;
-    tool_calls: string | null;
-    tool_call_id: string | null;
-    created_at: number;
-    token_estimate: number;
-}
-/** Result of a conversation sync cycle. */
-export interface ConversationSyncResult {
-    conversations_pushed: number;
-    conversations_pulled: number;
-    messages_pushed: number;
-    messages_pulled: number;
-}
-export interface RenderSpec {
-    geometry: GeometrySpec;
-    material: MaterialSpec;
-    lighting: LightingSpec;
-}
-export interface GeometrySpec {
-    form: "droplet";
-    base_radius: number;
-    height: number;
-}
-export interface MaterialSpec {
-    ior: number;
-    subsurface: number;
-    roughness: number;
-    clearcoat: number;
-    surface_noise_amplitude: number;
-    base_color: [number, number, number];
-    emissive_intensity: number;
-    tint: [number, number, number];
-}
-export interface LightingSpec {
-    environment: "hdri";
-    exposure: number;
-    ambient_intensity: number;
-}
-export declare enum PlanStatus {
-    Active = "active",
-    Completed = "completed",
-    Failed = "failed",
-    Paused = "paused"
-}
-export declare enum StepStatus {
-    Pending = "pending",
-    Running = "running",
-    Completed = "completed",
-    Failed = "failed",
-    Skipped = "skipped"
-}
-export interface PlanStep {
-    step_id: string;
-    plan_id: PlanId;
-    ordinal: number;
-    description: string;
-    prompt: string;
-    depends_on: string[];
-    optional: boolean;
-    status: StepStatus;
-    required_capabilities?: DeviceCapability[];
-    /** Task ID assigned by the relay when this step was delegated to a remote device. */
-    delegation_task_id?: string;
-    /** Motebit ID of the agent assigned to execute this step in collaborative plans. */
-    assigned_motebit_id?: MotebitId;
-    result_summary: string | null;
-    error_message: string | null;
-    tool_calls_made: number;
-    started_at: number | null;
-    completed_at: number | null;
-    retry_count: number;
-    updated_at: number;
-}
-export interface Plan {
-    plan_id: PlanId;
-    goal_id: GoalId;
-    motebit_id: MotebitId;
-    title: string;
-    status: PlanStatus;
-    created_at: number;
-    updated_at: number;
-    current_step_index: number;
-    total_steps: number;
-    proposal_id?: ProposalId;
-    collaborative?: boolean;
-}
-/** Plan record for cross-device sync. Mirrors Plan but uses wire-format field names. */
-export interface SyncPlan {
-    plan_id: PlanId;
-    goal_id: GoalId;
-    motebit_id: MotebitId;
-    title: string;
-    status: PlanStatus;
-    created_at: number;
-    updated_at: number;
-    current_step_index: number;
-    total_steps: number;
-    proposal_id: string | null;
-    collaborative: number;
-}
-/** Plan step record for cross-device sync. */
-export interface SyncPlanStep {
-    step_id: string;
-    plan_id: PlanId;
-    motebit_id: MotebitId;
-    ordinal: number;
-    description: string;
-    prompt: string;
-    depends_on: string;
-    optional: boolean;
-    status: StepStatus;
-    required_capabilities: string | null;
-    delegation_task_id: string | null;
-    assigned_motebit_id: string | null;
-    result_summary: string | null;
-    error_message: string | null;
-    tool_calls_made: number;
-    started_at: number | null;
-    completed_at: number | null;
-    retry_count: number;
-    updated_at: number;
-}
-/** Result of a plan sync cycle. */
-export interface PlanSyncResult {
-    plans_pushed: number;
-    plans_pulled: number;
-    steps_pushed: number;
-    steps_pulled: number;
-}
-export declare enum DeviceCapability {
-    StdioMcp = "stdio_mcp",
-    HttpMcp = "http_mcp",
-    FileSystem = "file_system",
-    Keyring = "keyring",
-    Background = "background",
-    LocalLlm = "local_llm"
-}
-export declare enum AgentTaskStatus {
-    Pending = "pending",
-    Claimed = "claimed",
-    Running = "running",
-    Completed = "completed",
-    Failed = "failed",
-    Denied = "denied",
-    Expired = "expired"
-}
-export interface AgentTask {
-    task_id: string;
-    motebit_id: MotebitId;
-    prompt: string;
-    submitted_at: number;
-    submitted_by?: string;
-    wall_clock_ms?: number;
-    status: AgentTaskStatus;
-    claimed_by?: string;
-    required_capabilities?: DeviceCapability[];
-    step_id?: string;
-    /** Delegation scope — when set, restricts which tools the task can use. */
-    delegated_scope?: string;
-}
-export interface ExecutionReceipt {
-    task_id: string;
-    motebit_id: MotebitId;
-    /** Signer's Ed25519 public key (hex). Enables verification without relay lookup. */
-    public_key?: string;
-    device_id: DeviceId;
-    submitted_at: number;
-    completed_at: number;
-    status: "completed" | "failed" | "denied";
-    result: string;
-    tools_used: string[];
-    memories_formed: number;
-    prompt_hash: string;
-    result_hash: string;
-    delegation_receipts?: ExecutionReceipt[];
-    /**
-     * Cryptographic binding to the relay's economic identity for this task.
-     *
-     * Optional for local (non-relay) execution. **Required** for relay-mediated
-     * tasks — the relay rejects receipts without this field (HTTP 400). The value
-     * is included in the Ed25519 signature, so tampering breaks verification.
-     */
-    relay_task_id?: string;
-    /** Scope from the delegation token that authorized this execution, if any. */
-    delegated_scope?: string;
-    signature: string;
-}
-export interface DelegatedStepResult {
-    step_id: string;
-    task_id: string;
-    receipt: ExecutionReceipt;
-    result_text: string;
-    /** Routing provenance from the relay — why this agent was selected. */
-    routing_choice?: {
-        selected_agent: string;
-        composite_score: number;
-        sub_scores: Record<string, number>;
-        routing_paths: string[][];
-        alternatives_considered: number;
-    };
-}
-/**
- * A key succession record proving that one Ed25519 key has been replaced by another.
- * Both the old and new keys sign the record, creating a cryptographic chain of custody.
- * Structurally compatible with @motebit/crypto KeySuccessionRecord.
- */
-export interface KeySuccessionRecord {
-    old_public_key: string;
-    new_public_key: string;
-    timestamp: number;
-    reason?: string;
-    old_key_signature: string;
-    new_key_signature: string;
-}
-/** Result of verifying a key succession chain. */
-export interface SuccessionChainResult {
-    valid: boolean;
-    /** The original (genesis) public key. */
-    genesis_public_key: string;
-    /** The current (active) public key. */
-    current_public_key: string;
-    /** Number of key rotations. */
-    length: number;
-    /** If invalid, the index of the first broken link and error. */
-    error?: {
-        index: number;
-        message: string;
-    };
-}
-export type ExecutionTimelineType = "goal_started" | "plan_created" | "step_started" | "tool_invoked" | "tool_result" | "step_completed" | "step_failed" | "step_delegated" | "plan_completed" | "plan_failed" | "goal_completed" | "proposal_created" | "proposal_accepted" | "proposal_rejected" | "proposal_countered" | "collaborative_step_completed";
-export interface ExecutionTimelineEntry {
-    timestamp: number;
-    type: ExecutionTimelineType;
-    payload: Record<string, unknown>;
-}
-export interface ExecutionStepSummary {
-    step_id: string;
-    ordinal: number;
-    description: string;
-    status: string;
-    tools_used: string[];
-    tool_calls: number;
-    started_at: number | null;
-    completed_at: number | null;
-    delegation?: {
-        task_id: string;
-        receipt_hash?: string;
-        /** Routing provenance: why this agent was selected for delegation. */
-        routing_choice?: {
-            selected_agent: string;
-            composite_score: number;
-            sub_scores: {
-                trust: number;
-                success_rate: number;
-                latency: number;
-                price_efficiency: number;
-                capability_match: number;
-                availability: number;
-            };
-            /** Derivation paths through the agent graph. */
-            routing_paths: string[][];
-            /** Number of candidate agents that were scored. */
-            alternatives_considered: number;
-        };
-    };
-}
-export interface GoalExecutionManifest {
-    spec: "motebit/execution-ledger@1.0";
-    motebit_id: string;
-    goal_id: string;
-    plan_id: string;
-    started_at: number;
-    completed_at: number;
-    status: "completed" | "failed" | "paused" | "active";
-    timeline: ExecutionTimelineEntry[];
-    steps: ExecutionStepSummary[];
-    delegation_receipts: DelegationReceiptSummary[];
-    content_hash: string;
-    signature?: string;
-}
-export interface DelegationReceiptSummary {
-    task_id: string;
-    motebit_id: string;
-    device_id: string;
-    status: string;
-    completed_at: number;
-    tools_used: string[];
-    signature_prefix: string;
-}
-export interface AgentCapabilities {
-    motebit_id: MotebitId;
-    public_key: string;
-    /** W3C did:key URI derived from the Ed25519 public key. */
-    did?: string;
-    tools: string[];
-    governance: {
-        trust_mode: string;
-        max_risk_auto: number;
-        require_approval_above: number;
-        deny_above: number;
-    };
-    online_devices: number;
-}
-export interface CapabilityPrice {
-    capability: string;
-    unit_cost: number;
-    currency: string;
-    per: "task" | "tool_call" | "token";
-}
-export interface AgentServiceListing {
-    listing_id: ListingId;
-    motebit_id: MotebitId;
-    capabilities: string[];
-    pricing: CapabilityPrice[];
-    sla: {
-        max_latency_ms: number;
-        availability_guarantee: number;
-    };
-    description: string;
-    /** Wallet address for x402 on-chain payment settlement (e.g. "0x..." for EVM). */
-    pay_to_address?: string;
-    /**
-     * Self-declared regulatory risk score [0, ∞). 0 = no risk, higher = more risk.
-     * Accumulates along delegation chains via RegulatoryRiskSemiring (min, +).
-     * Sources: jurisdiction, data handling classification, compliance certifications,
-     * audit requirements. The score is declared by the agent; verification is via
-     * credentials (e.g. compliance attestation VCs).
-     */
-    regulatory_risk?: number;
-    updated_at: number;
-}
-export interface RouteScore {
-    motebit_id: MotebitId;
-    composite: number;
-    sub_scores: {
-        trust: number;
-        success_rate: number;
-        latency: number;
-        price_efficiency: number;
-        capability_match: number;
-        availability: number;
-    };
-    selected: boolean;
-}
-export interface BudgetAllocation {
-    allocation_id: AllocationId;
-    goal_id: GoalId;
-    candidate_motebit_id: MotebitId;
-    amount_locked: number;
-    currency: string;
-    created_at: number;
-    status: "locked" | "settled" | "released" | "disputed";
-}
-/**
- * The relay's settlement fee rate (5%).
- * Applied to every completed or partial settlement that flows through the relay.
- * This is the Stripe model: the relay proves the work happened, takes its cut.
- */
-export declare const PLATFORM_FEE_RATE = 0.05;
-export interface SettlementRecord {
-    settlement_id: SettlementId;
-    allocation_id: AllocationId;
-    receipt_hash: string;
-    ledger_hash: string | null;
-    /** Amount paid to the executing agent (after platform fee deduction). */
-    amount_settled: number;
-    /** Platform fee extracted by the relay. */
-    platform_fee: number;
-    /** Fee rate applied (e.g. 0.05 = 5%). Recorded per-settlement for auditability. */
-    platform_fee_rate: number;
-    /** x402 payment transaction hash (when paid on-chain). */
-    x402_tx_hash?: string;
-    /** x402 network used for payment (CAIP-2 identifier). */
-    x402_network?: string;
-    status: "completed" | "partial" | "refunded";
-    settled_at: number;
-}
-export interface CollaborativePlanProposal {
-    proposal_id: ProposalId;
-    plan_id: PlanId;
-    initiator_motebit_id: MotebitId;
-    participants: ProposalParticipant[];
-    status: ProposalStatus;
-    created_at: number;
-    expires_at: number;
-    updated_at: number;
-}
-export interface ProposalParticipant {
-    motebit_id: MotebitId;
-    assigned_steps: number[];
-    response: ProposalResponseType | null;
-    responded_at: number | null;
-    counter_steps?: ProposalStepCounter[];
-}
-export interface ProposalStepCounter {
-    ordinal: number;
-    description?: string;
-    prompt?: string;
-    reason: string;
-}
-export interface ProposalResponse {
-    proposal_id: ProposalId;
-    responder_motebit_id: MotebitId;
-    response: ProposalResponseType;
-    counter_steps?: ProposalStepCounter[];
-    signature: string;
-}
-export interface CollaborativeReceipt {
-    proposal_id: ProposalId;
-    plan_id: PlanId;
-    participant_receipts: ExecutionReceipt[];
-    content_hash: string;
-    initiator_signature: string;
-}
-export interface MarketConfig {
-    weight_trust: number;
-    weight_success_rate: number;
-    weight_latency: number;
-    weight_price_efficiency: number;
-    weight_capability_match: number;
-    weight_availability: number;
-    latency_norm_k: number;
-    max_candidates: number;
-    settlement_timeout_ms: number;
-    /** Exploration weight [0-1]: 0 = pure exploitation, 1 = pure exploration. Default 0. */
-    exploration_weight?: number;
-}
 /**
  * Precision weights derived from the intelligence gradient.
  *
@@ -946,41 +193,6 @@ export interface MarketConfig {
  * High gradient → high self-trust → exploit known-good routes, trust memory.
  * Low gradient → low self-trust → explore, diversify, question memory.
  */
-export declare const VC_TYPE_GRADIENT = "AgentGradientCredential";
-export declare const VC_TYPE_REPUTATION = "AgentReputationCredential";
-export declare const VC_TYPE_TRUST = "AgentTrustCredential";
-export interface GradientCredentialSubject {
-    id: string;
-    gradient: number;
-    knowledge_density: number;
-    knowledge_quality: number;
-    graph_connectivity: number;
-    temporal_stability: number;
-    retrieval_quality: number;
-    interaction_efficiency: number;
-    tool_efficiency: number;
-    curiosity_pressure: number;
-    measured_at: number;
-}
-export interface ReputationCredentialSubject {
-    id: string;
-    success_rate: number;
-    avg_latency_ms: number;
-    task_count: number;
-    trust_score: number;
-    availability: number;
-    sample_size: number;
-    measured_at: number;
-}
-export interface TrustCredentialSubject {
-    id: string;
-    trust_level: string;
-    interaction_count: number;
-    successful_tasks: number;
-    failed_tasks: number;
-    first_seen_at: number;
-    last_seen_at: number;
-}
 export interface PrecisionWeights {
     /** Overall self-trust [0-1]. Sigmoid of composite gradient. */
     selfTrust: number;
@@ -991,84 +203,6 @@ export interface PrecisionWeights {
     /** Curiosity modulation [0-1]. Fed back into state vector curiosity field. */
     curiosityModulation: number;
 }
-export interface ConversationStoreAdapter {
-    createConversation(motebitId: string): string;
-    appendMessage(conversationId: string, motebitId: string, msg: {
-        role: string;
-        content: string;
-        toolCalls?: string;
-        toolCallId?: string;
-    }): void;
-    loadMessages(conversationId: string, limit?: number): Array<{
-        messageId: string;
-        conversationId: string;
-        motebitId: string;
-        role: string;
-        content: string;
-        toolCalls: string | null;
-        toolCallId: string | null;
-        createdAt: number;
-        tokenEstimate: number;
-    }>;
-    getActiveConversation(motebitId: string): {
-        conversationId: string;
-        startedAt: number;
-        lastActiveAt: number;
-        summary: string | null;
-    } | null;
-    updateSummary(conversationId: string, summary: string): void;
-    updateTitle(conversationId: string, title: string): void;
-    listConversations(motebitId: string, limit?: number): Array<{
-        conversationId: string;
-        startedAt: number;
-        lastActiveAt: number;
-        title: string | null;
-        messageCount: number;
-    }>;
-    deleteConversation(conversationId: string): void;
-}
-export interface StateSnapshotAdapter {
-    saveState(motebitId: string, stateJson: string, versionClock?: number): void;
-    loadState(motebitId: string): string | null;
-    /** Version clock at last snapshot — used to determine what's safe to compact. */
-    getSnapshotClock?(motebitId: string): number;
-}
-export interface KeyringAdapter {
-    get(key: string): Promise<string | null>;
-    set(key: string, value: string): Promise<void>;
-    delete(key: string): Promise<void>;
-}
-export interface AgentTrustStoreAdapter {
-    getAgentTrust(motebitId: string, remoteMotebitId: string): Promise<AgentTrustRecord | null>;
-    setAgentTrust(record: AgentTrustRecord): Promise<void>;
-    listAgentTrust(motebitId: string): Promise<AgentTrustRecord[]>;
-    updateTrustLevel(motebitId: string, remoteMotebitId: string, level: AgentTrustLevel): Promise<void>;
-}
-export interface ServiceListingStoreAdapter {
-    get(motebitId: string): Promise<AgentServiceListing | null>;
-    set(listing: AgentServiceListing): Promise<void>;
-    list(): Promise<AgentServiceListing[]>;
-    delete(listingId: string): Promise<void>;
-}
-export interface BudgetAllocationStoreAdapter {
-    get(allocationId: string): Promise<BudgetAllocation | null>;
-    create(allocation: BudgetAllocation): Promise<void>;
-    updateStatus(allocationId: string, status: string): Promise<void>;
-    listByGoal(goalId: string): Promise<BudgetAllocation[]>;
-}
-export interface SettlementStoreAdapter {
-    get(settlementId: string): Promise<SettlementRecord | null>;
-    create(settlement: SettlementRecord): Promise<void>;
-    listByAllocation(allocationId: string): Promise<SettlementRecord[]>;
-}
-export interface LatencyStatsStoreAdapter {
-    record(motebitId: string, remoteMotebitId: string, latencyMs: number): Promise<void>;
-    getStats(motebitId: string, remoteMotebitId: string, limit?: number): Promise<{
-        avg_ms: number;
-        p95_ms: number;
-        sample_count: number;
-    }>;
-}
 export interface GradientSnapshot {
     motebit_id: string;
     timestamp: number;
@@ -1113,132 +247,6 @@ export interface GradientStoreAdapter {
     latest(motebitId: string): GradientSnapshot | null;
     list(motebitId: string, limit?: number): GradientSnapshot[];
 }
-export interface EventFilter {
-    motebit_id?: string;
-    event_types?: EventType[];
-    after_timestamp?: number;
-    before_timestamp?: number;
-    after_version_clock?: number;
-    limit?: number;
-}
-export interface EventStoreAdapter {
-    append(entry: EventLogEntry): Promise<void>;
-    /**
-     * Atomically assign the next version_clock and append the event.
-     * Eliminates the race condition in the getLatestClock() + clock+1 pattern.
-     * Returns the assigned version_clock.
-     */
-    appendWithClock?(entry: Omit<EventLogEntry, "version_clock">): Promise<number>;
-    query(filter: EventFilter): Promise<EventLogEntry[]>;
-    getLatestClock(motebitId: string): Promise<number>;
-    tombstone(eventId: string, motebitId: string): Promise<void>;
-    /** Delete events with version_clock <= beforeClock. Returns count deleted. */
-    compact?(motebitId: string, beforeClock: number): Promise<number>;
-    /** Count total events for a motebit. */
-    countEvents?(motebitId: string): Promise<number>;
-}
-export interface MemoryQuery {
-    motebit_id: string;
-    min_confidence?: number;
-    sensitivity_filter?: SensitivityLevel[];
-    limit?: number;
-    include_tombstoned?: boolean;
-    pinned?: boolean;
-}
-export interface MemoryStorageAdapter {
-    saveNode(node: MemoryNode): Promise<void>;
-    getNode(nodeId: string): Promise<MemoryNode | null>;
-    queryNodes(query: MemoryQuery): Promise<MemoryNode[]>;
-    saveEdge(edge: MemoryEdge): Promise<void>;
-    getEdges(nodeId: string): Promise<MemoryEdge[]>;
-    tombstoneNode(nodeId: string): Promise<void>;
-    /** Tombstone with ownership check. Returns true if the node existed and belonged to motebitId. */
-    tombstoneNodeOwned?(nodeId: string, motebitId: string): Promise<boolean>;
-    pinNode(nodeId: string, pinned: boolean): Promise<void>;
-    getAllNodes(motebitId: string): Promise<MemoryNode[]>;
-    getAllEdges(motebitId: string): Promise<MemoryEdge[]>;
-}
-export interface DeviceRegistration {
-    device_id: string;
-    motebit_id: string;
-    device_token: string;
-    public_key: string;
-    registered_at: number;
-    device_name?: string;
-}
-export interface IdentityStorage {
-    save(identity: MotebitIdentity): Promise<void>;
-    load(motebitId: string): Promise<MotebitIdentity | null>;
-    loadByOwner(ownerId: string): Promise<MotebitIdentity | null>;
-    saveDevice?(device: DeviceRegistration): Promise<void>;
-    loadDevice?(deviceId: string): Promise<DeviceRegistration | null>;
-    loadDeviceByToken?(token: string): Promise<DeviceRegistration | null>;
-    listDevices?(motebitId: string): Promise<DeviceRegistration[]>;
-}
-export interface AuditLogAdapter {
-    record(entry: AuditRecord): Promise<void>;
-    query(motebitId: string, options?: {
-        limit?: number;
-        after?: number;
-    }): Promise<AuditRecord[]>;
-}
-export interface AuditStatsSince {
-    distinctTurns: number;
-    totalToolCalls: number;
-    succeeded: number;
-    blocked: number;
-    failed: number;
-}
-export interface AuditLogSink {
-    append(entry: ToolAuditEntry): void;
-    query(turnId: string): ToolAuditEntry[];
-    getAll(): ToolAuditEntry[];
-    queryStatsSince(afterTimestamp: number): AuditStatsSince;
-    /** Query tool audit entries by run_id (plan execution). Optional — returns [] if not implemented. */
-    queryByRunId?(runId: string): ToolAuditEntry[];
-}
-export interface PlanStoreAdapter {
-    savePlan(plan: Plan): void;
-    getPlan(planId: string): Plan | null;
-    getPlanForGoal(goalId: string): Plan | null;
-    updatePlan(planId: string, updates: Partial<Plan>): void;
-    saveStep(step: PlanStep): void;
-    getStep(stepId: string): PlanStep | null;
-    getStepsForPlan(planId: string): PlanStep[];
-    updateStep(stepId: string, updates: Partial<PlanStep>): void;
-    getNextPendingStep(planId: string): PlanStep | null;
-    /** List all active plans for a motebit. Optional — returns [] if not implemented. */
-    listActivePlans?(motebitId: string): Plan[];
-}
-/** Stored credential record — JSON-serialized VC with metadata. */
-export interface StoredCredential {
-    credential_id: string;
-    /** The agent the credential is about (credentialSubject.id). */
-    subject_motebit_id: string;
-    /** did:key of the issuer. */
-    issuer_did: string;
-    /** e.g. "AgentReputationCredential", "AgentTrustCredential", "AgentGradientCredential". */
-    credential_type: string;
-    /** Full JSON-serialized VerifiableCredential. */
-    credential_json: string;
-    issued_at: number;
-}
-export interface CredentialStoreAdapter {
-    save(credential: StoredCredential): void;
-    /** List credentials about a specific subject agent. */
-    listBySubject(subjectMotebitId: string, limit?: number): StoredCredential[];
-    /** List all credentials, optionally filtered by type. */
-    list(motebitId: string, type?: string, limit?: number): StoredCredential[];
-}
-export interface ApprovalStoreAdapter {
-    /** Collect a quorum approval vote. Returns whether threshold is met and collected voter IDs. */
-    collectApproval(approvalId: string, approverId: string): {
-        met: boolean;
-        collected: string[];
-    };
-    /** Set quorum metadata on a pending approval item. */
-    setQuorum(approvalId: string, required: number, approvers: string[]): void;
-}
 export interface StorageAdapters {
     eventStore: EventStoreAdapter;
     memoryStorage: MemoryStorageAdapter;
@@ -1257,5 +265,49 @@ export interface StorageAdapters {
     credentialStore?: CredentialStoreAdapter;
     approvalStore?: ApprovalStoreAdapter;
 }
-export {};
+/** Context passed to CredentialSource when requesting a credential. */
+export interface CredentialRequest {
+    /** URL of the MCP server being called. */
+    serverUrl: string;
+    /** Tool name being invoked, if known at credential-acquisition time. */
+    toolName?: string;
+    /** Requested scope or audience for scoped credentials. */
+    scope?: string;
+    /** Motebit ID of the calling agent, if available. */
+    agentId?: string;
+}
+/**
+ * Adapter interface for obtaining credentials at tool-call time.
+ * Implementations may read from OS keyring, external vaults, or wrap static tokens.
+ */
+export interface CredentialSource {
+    getCredential(request: CredentialRequest): Promise<string | null>;
+}
+/** Config fields that server verifiers can update via VerificationResult. */
+export interface VerifierConfigUpdates {
+    toolManifestHash?: string;
+    pinnedToolNames?: string[];
+    trusted?: boolean;
+    tlsCertFingerprint?: string;
+}
+/** Result of server verification. */
+export interface VerificationResult {
+    ok: boolean;
+    error?: string;
+    configUpdates?: VerifierConfigUpdates;
+}
+/**
+ * Adapter interface for verifying an MCP server's integrity after connect.
+ * Fail-closed: ok:false or thrown errors should tear down the connection.
+ */
+export interface ServerVerifier {
+    verify(config: {
+        name: string;
+        url?: string;
+        toolManifestHash?: string;
+        pinnedToolNames?: string[];
+        trusted?: boolean;
+        tlsCertFingerprint?: string;
+    }, tools: ToolDefinition[]): Promise<VerificationResult>;
+}
 //# sourceMappingURL=index.d.ts.map