@agentvault/agentvault 0.17.5 → 0.19.0

package/dist/types.d.ts

@@ -0,0 +1,417 @@
+export interface SecureChannelConfig {
+    inviteToken: string;
+    dataDir: string;
+    apiUrl: string;
+    agentName?: string;
+    agentVersion?: string;
+    platform?: string;
+    maxHistorySize?: number;
+    webhookUrl?: string;
+    httpPort?: number;
+    onMessage?: (plaintext: string, metadata: MessageMetadata) => void;
+    onStateChange?: (state: ChannelState) => void;
+    onA2AMessage?: (msg: A2AMessage) => void;
+    /** Called when an A2A channel becomes ready (approved or activated). */
+    onA2AChannelReady?: (info: {
+        channelId: string;
+        peerHubAddress: string;
+        role: "initiator" | "responder";
+        conversationId: string;
+        topic?: string;
+    }) => void;
+    /** Enable client-side policy scanning. If true, rules are fetched on connect. */
+    enableScanning?: boolean;
+    /** If set, auto-backup encrypted state to server after state changes. */
+    backupCode?: string;
+}
+export type ChannelState = "idle" | "enrolling" | "polling" | "activating" | "connecting" | "ready" | "disconnected" | "error";
+export interface AttachmentData {
+    filename: string;
+    mime: string;
+    size: number;
+    filePath: string;
+    /** Base64-encoded decrypted content (for images passed to LLM vision) */
+    base64?: string;
+    /** Extracted text content (for text-based files) */
+    textContent?: string;
+}
+export interface MessageMetadata {
+    messageId: string;
+    conversationId: string;
+    timestamp: string;
+    topicId?: string;
+    attachment?: AttachmentData;
+    spanId?: string;
+    parentSpanId?: string;
+    messageType?: string;
+    priority?: string;
+    envelopeVersion?: string;
+    /** Set when the message originated from a multi-agent room */
+    roomId?: string;
+    /** Device ID of the sender (room messages only) */
+    senderDeviceId?: string;
+    /** Human-readable room name (room messages only) */
+    roomName?: string;
+}
+export interface SendOptions {
+    /** Target a specific conversation instead of broadcasting to all sessions */
+    conversationId?: string;
+    topicId?: string;
+    messageType?: string;
+    priority?: string;
+    parentSpanId?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface DecisionOption {
+    option_id: string;
+    label: string;
+    risk_level: "low" | "medium" | "high" | "critical";
+    is_default?: boolean;
+}
+export interface ContextRef {
+    type: string;
+    uri: string;
+    label: string;
+}
+export interface DecisionRequest {
+    title: string;
+    description?: string;
+    options: DecisionOption[];
+    context_refs?: ContextRef[];
+    deadline?: string;
+    auto_action?: {
+        option_id: string;
+        trigger: string;
+        description?: string;
+    };
+}
+export interface DecisionResponse {
+    decision_id: string;
+    selected_option_id?: string;
+    resolved_at?: string;
+    action?: "approve" | "deny" | "defer";
+    defer_until?: string;
+    defer_reason?: string;
+}
+export interface HistoryEntry {
+    sender: "owner" | "agent";
+    text: string;
+    ts: string;
+    topicId?: string;
+}
+export interface DeviceSession {
+    ownerDeviceId: string;
+    ratchetState: string;
+    activated?: boolean;
+}
+export interface PersistedState {
+    deviceId: string;
+    deviceJwt: string;
+    primaryConversationId: string;
+    sessions: Record<string, DeviceSession>;
+    identityKeypair: {
+        publicKey: string;
+        privateKey: string;
+    };
+    ephemeralKeypair: {
+        publicKey: string;
+        privateKey: string;
+    };
+    fingerprint: string;
+    lastMessageTimestamp?: string;
+    messageHistory?: HistoryEntry[];
+    topics?: Array<{
+        id: string;
+        name: string;
+        isDefault: boolean;
+    }>;
+    defaultTopicId?: string;
+    groupId?: string;
+    hubAddress?: string;
+    hubId?: string;
+    agentHubId?: string;
+    agentRole?: "lead" | "peer";
+    ownerHubId?: string;
+    /** A2A channel state (agent-to-agent communication) */
+    a2aChannels?: Record<string, {
+        channelId: string;
+        hubAddress: string;
+        conversationId: string;
+        role?: "initiator" | "responder";
+        session?: DeviceSession;
+        pendingEphemeralPrivateKey?: string;
+        /** Observer session (agent → owner ratchet for A2A observation) */
+        observerSession?: {
+            ratchetState: string;
+        };
+        pendingObserverEphemeralPrivateKey?: string;
+    }>;
+    /** Outbound messages queued while disconnected */
+    outboundQueue?: Array<{
+        convId: string;
+        headerBlob: string;
+        ciphertext: string;
+        messageGroupId: string;
+        topicId?: string;
+    }>;
+    /** Multi-agent room state */
+    rooms?: Record<string, RoomState>;
+    /** Last inbound room ID for sticky room routing across restarts */
+    lastInboundRoomId?: string;
+    /** Shadow mode skill configurations (synced from backend via WS) */
+    shadowSkills?: Record<string, {
+        sessionId: string;
+        autonomyLevel: "shadow" | "supervised" | "autonomous";
+        decisionClass: string;
+    }>;
+}
+/** Legacy state format for backward compatibility */
+export interface LegacyPersistedState {
+    deviceId: string;
+    deviceJwt: string;
+    conversationId: string;
+    identityKeypair: {
+        publicKey: string;
+        privateKey: string;
+    };
+    ephemeralKeypair: {
+        publicKey: string;
+        privateKey: string;
+    };
+    fingerprint: string;
+    ratchetState: string;
+    lastMessageTimestamp?: string;
+}
+export interface RoomMemberInfo {
+    deviceId: string;
+    entityType: string;
+    displayName: string;
+    identityPublicKey?: string;
+    ephemeralPublicKey?: string;
+}
+export interface RoomConversationInfo {
+    id: string;
+    participantA: string;
+    participantB: string;
+}
+export interface RoomInfo {
+    roomId: string;
+    name: string;
+    members: RoomMemberInfo[];
+    conversationIds: string[];
+}
+export interface RoomState {
+    roomId: string;
+    name: string;
+    conversationIds: string[];
+    members: RoomMemberInfo[];
+    /** Encryption mode — null/undefined = pairwise, "sender_key" = O(1) Sender Key */
+    encryptionMode?: "pairwise" | "sender_key";
+    /** Serialized SenderKeyChain (own chain for this room) */
+    ownSenderKeyChain?: string;
+    /** Serialized SenderKeyState (peer chains for this room) */
+    peerSenderKeyState?: string;
+    /** Set of device IDs we've distributed our sender key to */
+    distributedTo?: string[];
+}
+export interface HeartbeatStatus {
+    agent_status: string;
+    current_task: string;
+}
+export interface StatusAlert {
+    title: string;
+    message: string;
+    severity: "info" | "warning" | "error" | "critical";
+    detail?: string;
+    detailFormat?: "markdown" | "json" | "text";
+    category?: "performance" | "security" | "error" | "info";
+}
+export interface RoomParticipantEvent {
+    roomId: string;
+    participant: {
+        deviceId: string;
+        participantType: "human" | "agent";
+        displayName?: string;
+    };
+}
+export interface A2AChannel {
+    channelId: string;
+    initiatorHubAddress: string;
+    responderHubAddress: string;
+    conversationId: string | null;
+    status: "pending" | "approved" | "active" | "rejected" | "revoked";
+    createdAt: string;
+}
+export interface A2AMessage {
+    text: string;
+    fromHubAddress: string;
+    channelId: string;
+    conversationId: string;
+    parentSpanId?: string;
+    timestamp: string;
+}
+/** Explicit routing target for outbound messages. */
+export type DeliveryTarget = {
+    kind: "owner";
+} | {
+    kind: "room";
+    roomId: string;
+} | {
+    kind: "a2a";
+    hubAddress: string;
+} | {
+    kind: "context";
+};
+export interface ShadowRecommendation {
+    sessionId: string;
+    skillName: string;
+    decisionClass: string;
+    recommendedAction: string;
+    reasoningTrace?: string;
+    observationId: string;
+}
+/** Structured message content for the deliver() dispatcher. */
+export type DeliveryContent = {
+    type: "text";
+    text: string;
+} | {
+    type: "decision_request";
+    request: DecisionRequest;
+} | {
+    type: "status_alert";
+    alert: StatusAlert;
+} | {
+    type: "action_confirmation";
+    confirmation: ActionConfirmation;
+} | {
+    type: "artifact";
+    artifact: ArtifactPayload;
+} | {
+    type: "attachment";
+    text: string;
+    filePath: string;
+} | {
+    type: "policy_alert";
+    alert: PolicyAlert;
+} | {
+    type: "approval_request";
+    request: ApprovalRequest;
+} | {
+    type: "approval_response";
+    response: ApprovalResponse;
+} | {
+    type: "shadow_recommendation";
+    recommendation: ShadowRecommendation;
+};
+export interface ActionConfirmation {
+    action: string;
+    status: "completed" | "failed" | "partial";
+    decisionId?: string;
+    detail?: string;
+    estimated_cost?: number;
+}
+export interface ArtifactPayload {
+    filePath: string;
+    filename: string;
+    mimeType: string;
+    description?: string;
+}
+/** Notify agent owner of a policy violation. */
+export interface PolicyAlert {
+    ruleId: string;
+    scope: "tool" | "model" | "rate" | "network" | "custom";
+    action: "block" | "warn" | "log";
+    violationType: string;
+    message: string;
+    skillName?: string;
+    toolName?: string;
+    model?: string;
+    timestamp?: string;
+}
+/** Human-in-the-loop gate for sensitive operations. */
+export interface ApprovalRequest {
+    approvalId: string;
+    category: string;
+    title: string;
+    description: string;
+    details?: Record<string, unknown>;
+    expiresAt?: string;
+    requiredTier?: string;
+}
+/** Owner response to an approval request. */
+export interface ApprovalResponse {
+    approvalId: string;
+    approved: boolean;
+    reason?: string;
+    conditions?: string[];
+    signature?: string;
+}
+export interface CredentialGrantPayload {
+    type: "credential_grant";
+    agreement_id: string;
+    credentials: Array<{
+        key: string;
+        value: string;
+        type: string;
+        scope: string;
+    }>;
+    timestamp: string;
+    nonce: string;
+}
+export interface CredentialRevokePayload {
+    type: "credential_revoke";
+    agreement_id: string;
+    credential_keys: string[];
+    reason?: string;
+    timestamp: string;
+}
+export interface CredentialAckPayload {
+    type: "credential_ack";
+    agreement_id: string;
+    acknowledged_keys: string[];
+    status: "stored" | "revoked";
+    timestamp: string;
+}
+export interface CredentialRequestPayload {
+    type: "credential_request";
+    agreement_id: string;
+    requested_keys: string[];
+    reason?: string;
+    timestamp: string;
+}
+export interface DeliveryOptions {
+    conversationId?: string;
+    topicId?: string;
+    priority?: string;
+    parentSpanId?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface DeliveryReceipt {
+    ok: boolean;
+    destination: {
+        kind: "owner" | "room" | "a2a";
+        id?: string;
+    };
+    error?: string;
+    queued?: boolean;
+    decisionId?: string;
+    timestamp: string;
+}
+export interface TargetInfo {
+    kind: "owner" | "room" | "a2a";
+    id: string;
+    label: string;
+    available: boolean;
+}
+/**
+ * Parse a string target into a DeliveryTarget.
+ * Handles: "owner", "default", "room:<uuid>", "a2a:<hubAddr>", "context",
+ * "agentvault:room:<uuid>" (channel-prefixed), "agent:<name>" (→ a2a).
+ */
+export declare function parseTarget(raw: string): DeliveryTarget;
+export interface TrustTokenState {
+    token: string | null;
+    tier: string | null;
+    expiresAt: string | null;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/workspace-handlers.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Workspace file handlers — upload, list, read workspace .md files.
+ *
+ * Workspace files (SOUL.md, IDENTITY.md, etc.) define agent personality
+ * and behavior. These handlers validate filenames, verify signatures,
+ * enforce size limits, and perform atomic writes.
+ */
+export interface WorkspaceFileInfo {
+    filename: string;
+    size: number;
+    modified: string;
+}
+export interface WorkspaceUploadData {
+    filename: string;
+    content: string;
+    signature: string;
+    signer_public_key: string;
+    timestamp: string;
+}
+export interface WorkspaceUploadResult {
+    status: "success" | "error";
+    error?: string;
+    written_path?: string;
+    verified_signature?: boolean;
+}
+export interface WorkspaceListResult {
+    files: WorkspaceFileInfo[];
+}
+export interface WorkspaceReadResult {
+    filename: string;
+    content: string;
+    size: number;
+}
+export interface WorkspaceReadError {
+    error: string;
+}
+/**
+ * Validate a workspace filename.
+ * Returns an error message if invalid, null if valid.
+ *
+ * Rules:
+ * - Must end in .md
+ * - No path traversal (.., /)
+ * - No backslashes or null bytes
+ * - Alphanumeric, hyphens, underscores, and dots only
+ */
+export declare function validateWorkspaceFilename(filename: string): string | null;
+/**
+ * Handle a workspace file upload — verify signature, validate, write atomically.
+ */
+export declare function handleWorkspaceUpload(data: WorkspaceUploadData, workspaceDir: string): Promise<WorkspaceUploadResult>;
+/**
+ * List .md files in the workspace directory.
+ */
+export declare function handleWorkspaceList(workspaceDir: string): Promise<WorkspaceListResult>;
+/**
+ * Read a workspace file's content.
+ */
+export declare function handleWorkspaceRead(data: {
+    filename: string;
+}, workspaceDir: string): Promise<WorkspaceReadResult | WorkspaceReadError>;
+//# sourceMappingURL=workspace-handlers.d.ts.map

package/dist/workspace-handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-handlers.d.ts","sourceRoot":"","sources":["../src/workspace-handlers.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,iBAAiB,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;CACf;AAKD;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA6BzE;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,IAAI,EAAE,mBAAmB,EACzB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,qBAAqB,CAAC,CAmEhC;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,mBAAmB,CAAC,CAkC9B;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,EAC1B,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,mBAAmB,GAAG,kBAAkB,CAAC,CAwBnD"}

package/openclaw.plugin.json

@@ -2,7 +2,7 @@
   "id": "agentvault",
   "name": "AgentVault",
   "description": "End-to-end encrypted, zero-knowledge messaging between AI agent owners and their agents.",
-  "version": "0.17.5",
+  "version": "0.19.0",
   "kind": "channel",
   "channels": [
     "agentvault"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentvault/agentvault",
-  "version": "0.17.5",
+  "version": "0.19.0",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",