@engramx/client 0.1.0

package/dist/schema.d.ts

@@ -0,0 +1,54 @@
+/**
+ * EngramX Memory Schema — shared path conventions for all integrations.
+ *
+ * Formalises the memory layout so that Claude, OpenClaw, and any future
+ * MCP-compatible platform share the same vocabulary for what files mean
+ * and where they live inside an engram canister.
+ */
+export declare const IDENTITY: {
+    /** Agent personality & principles (owner-write-only) */
+    readonly SOUL: "identity/soul.md";
+    /** Human profile — name, role, preferences (owner-write-only) */
+    readonly USER: "identity/user.md";
+    /** Communication style, formatting, tool preferences */
+    readonly PREFERENCES: "identity/preferences.md";
+};
+export declare const KNOWLEDGE: {
+    /** Cross-platform accumulated lessons and insights */
+    readonly LESSONS: "knowledge/lessons.md";
+    /** Decision log with rationale */
+    readonly DECISIONS: "knowledge/decisions.md";
+    /** Domain-specific knowledge file */
+    readonly domain: (topic: string) => string;
+};
+export declare const SESSIONS: {
+    /** Session summary for a specific platform and date */
+    readonly summary: (platform: string, date: string) => string;
+    /** Session directory prefix for a platform */
+    readonly platformDir: (platform: string) => string;
+};
+export declare const CONFIG: {
+    /** Platform-specific config file */
+    readonly platform: (name: string) => string;
+    readonly OPENCLAW: "config/openclaw.json";
+    readonly CLAUDE: "config/claude.json";
+};
+/** Default protected paths (owner-write-only). */
+export declare const DEFAULT_PROTECTED_PATHS: readonly ["identity/soul.md", "identity/user.md"];
+/** All well-known identity paths for batch reads. */
+export declare const IDENTITY_PATHS: readonly ["identity/soul.md", "identity/user.md", "identity/preferences.md"];
+/** All well-known knowledge paths for batch reads. */
+export declare const KNOWLEDGE_PATHS: readonly ["knowledge/lessons.md", "knowledge/decisions.md"];
+/** All well-known profile paths (identity + lessons). */
+export declare const PROFILE_PATHS: readonly ["identity/soul.md", "identity/user.md", "identity/preferences.md", "knowledge/lessons.md"];
+export declare const PLATFORMS: readonly ["claude", "openclaw", "cursor", "windsurf"];
+export type Platform = (typeof PLATFORMS)[number];
+/** Check whether a path falls under a schema namespace. */
+export declare function isIdentityPath(path: string): boolean;
+export declare function isKnowledgePath(path: string): boolean;
+export declare function isSessionPath(path: string): boolean;
+export declare function isConfigPath(path: string): boolean;
+/** Extract the platform name from a session path, or null. */
+export declare function sessionPlatform(path: string): string | null;
+/** Today's date as YYYY-MM-DD. */
+export declare function today(): string;

package/dist/schema.js

@@ -0,0 +1,101 @@
+/**
+ * EngramX Memory Schema — shared path conventions for all integrations.
+ *
+ * Formalises the memory layout so that Claude, OpenClaw, and any future
+ * MCP-compatible platform share the same vocabulary for what files mean
+ * and where they live inside an engram canister.
+ */
+// ── Path constants ─────────────────────────────────────────────
+export const IDENTITY = {
+    /** Agent personality & principles (owner-write-only) */
+    SOUL: 'identity/soul.md',
+    /** Human profile — name, role, preferences (owner-write-only) */
+    USER: 'identity/user.md',
+    /** Communication style, formatting, tool preferences */
+    PREFERENCES: 'identity/preferences.md',
+};
+export const KNOWLEDGE = {
+    /** Cross-platform accumulated lessons and insights */
+    LESSONS: 'knowledge/lessons.md',
+    /** Decision log with rationale */
+    DECISIONS: 'knowledge/decisions.md',
+    /** Domain-specific knowledge file */
+    domain: (topic) => {
+        validateTopic(topic);
+        return `knowledge/domains/${topic}.md`;
+    },
+};
+export const SESSIONS = {
+    /** Session summary for a specific platform and date */
+    summary: (platform, date) => {
+        validatePlatform(platform);
+        validateDate(date);
+        return `sessions/${platform}/${date}.md`;
+    },
+    /** Session directory prefix for a platform */
+    platformDir: (platform) => {
+        validatePlatform(platform);
+        return `sessions/${platform}/`;
+    },
+};
+export const CONFIG = {
+    /** Platform-specific config file */
+    platform: (name) => {
+        validatePlatform(name);
+        return `config/${name}.json`;
+    },
+    OPENCLAW: 'config/openclaw.json',
+    CLAUDE: 'config/claude.json',
+};
+/** Default protected paths (owner-write-only). */
+export const DEFAULT_PROTECTED_PATHS = [IDENTITY.SOUL, IDENTITY.USER];
+/** All well-known identity paths for batch reads. */
+export const IDENTITY_PATHS = [IDENTITY.SOUL, IDENTITY.USER, IDENTITY.PREFERENCES];
+/** All well-known knowledge paths for batch reads. */
+export const KNOWLEDGE_PATHS = [KNOWLEDGE.LESSONS, KNOWLEDGE.DECISIONS];
+/** All well-known profile paths (identity + lessons). */
+export const PROFILE_PATHS = [...IDENTITY_PATHS, KNOWLEDGE.LESSONS];
+// ── Known platforms ────────────────────────────────────────────
+export const PLATFORMS = ['claude', 'openclaw', 'cursor', 'windsurf'];
+// ── Validators ─────────────────────────────────────────────────
+const SAFE_NAME_RE = /^[a-z0-9][a-z0-9_-]{0,62}$/;
+const DATE_RE = /^\d{4}-\d{2}-\d{2}$/;
+function validateTopic(topic) {
+    if (!SAFE_NAME_RE.test(topic)) {
+        throw new Error(`Invalid topic "${topic}": must be lowercase alphanumeric with hyphens/underscores, 1-63 chars`);
+    }
+}
+function validatePlatform(platform) {
+    if (!SAFE_NAME_RE.test(platform)) {
+        throw new Error(`Invalid platform "${platform}": must be lowercase alphanumeric with hyphens/underscores, 1-63 chars`);
+    }
+}
+function validateDate(date) {
+    if (!DATE_RE.test(date)) {
+        throw new Error(`Invalid date "${date}": expected YYYY-MM-DD format`);
+    }
+}
+// ── Helpers ────────────────────────────────────────────────────
+/** Check whether a path falls under a schema namespace. */
+export function isIdentityPath(path) {
+    return path.startsWith('identity/');
+}
+export function isKnowledgePath(path) {
+    return path.startsWith('knowledge/');
+}
+export function isSessionPath(path) {
+    return path.startsWith('sessions/');
+}
+export function isConfigPath(path) {
+    return path.startsWith('config/');
+}
+/** Extract the platform name from a session path, or null. */
+export function sessionPlatform(path) {
+    const match = path.match(/^sessions\/([a-z0-9_-]+)\//);
+    return match ? match[1] : null;
+}
+/** Today's date as YYYY-MM-DD. */
+export function today() {
+    return new Date().toISOString().slice(0, 10);
+}
+//# sourceMappingURL=schema.js.map

package/dist/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,kEAAkE;AAElE,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,wDAAwD;IACxD,IAAI,EAAE,kBAAkB;IACxB,iEAAiE;IACjE,IAAI,EAAE,kBAAkB;IACxB,wDAAwD;IACxD,WAAW,EAAE,yBAAyB;CAC9B,CAAC;AAEX,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,sDAAsD;IACtD,OAAO,EAAE,sBAAsB;IAC/B,kCAAkC;IAClC,SAAS,EAAE,wBAAwB;IACnC,qCAAqC;IACrC,MAAM,EAAE,CAAC,KAAa,EAAU,EAAE;QAChC,aAAa,CAAC,KAAK,CAAC,CAAC;QACrB,OAAO,qBAAqB,KAAK,KAAK,CAAC;IACzC,CAAC;CACO,CAAC;AAEX,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,uDAAuD;IACvD,OAAO,EAAE,CAAC,QAAgB,EAAE,IAAY,EAAU,EAAE;QAClD,gBAAgB,CAAC,QAAQ,CAAC,CAAC;QAC3B,YAAY,CAAC,IAAI,CAAC,CAAC;QACnB,OAAO,YAAY,QAAQ,IAAI,IAAI,KAAK,CAAC;IAC3C,CAAC;IACD,8CAA8C;IAC9C,WAAW,EAAE,CAAC,QAAgB,EAAU,EAAE;QACxC,gBAAgB,CAAC,QAAQ,CAAC,CAAC;QAC3B,OAAO,YAAY,QAAQ,GAAG,CAAC;IACjC,CAAC;CACO,CAAC;AAEX,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,oCAAoC;IACpC,QAAQ,EAAE,CAAC,IAAY,EAAU,EAAE;QACjC,gBAAgB,CAAC,IAAI,CAAC,CAAC;QACvB,OAAO,UAAU,IAAI,OAAO,CAAC;IAC/B,CAAC;IACD,QAAQ,EAAE,sBAAsB;IAChC,MAAM,EAAE,oBAAoB;CACpB,CAAC;AAEX,kDAAkD;AAClD,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAU,CAAC;AAE/E,qDAAqD;AACrD,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,WAAW,CAAU,CAAC;AAE5F,sDAAsD;AACtD,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,SAAS,CAAC,OAAO,EAAE,SAAS,CAAC,SAAS,CAAU,CAAC;AAEjF,yDAAyD;AACzD,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,GAAG,cAAc,EAAE,SAAS,CAAC,OAAO,CAAU,CAAC;AAE7E,kEAAkE;AAElE,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,CAAU,CAAC;AAG/E,kEAAkE;AAElE,MAAM,YAAY,GAAG,4BAA4B,CAAC;AAClD,MAAM,OAAO,GAAG,qBAAqB,CAAC;AAEtC,SAAS,aAAa,CAAC,KAAa;IAClC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CACb,kBAAkB,KAAK,wEAAwE,CAChG,CAAC;IACJ,CAAC;AACH,CAAC;AAED,SAAS,gBAAgB,CAAC,QAAgB;IACxC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CACb,qBAAqB,QAAQ,wEAAwE,CACtG,CAAC;IACJ,CAAC;AACH,CAAC;AAED,SAAS,YAAY,CAAC,IAAY;IAChC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,iBAAiB,IAAI,+BAA+B,CAAC,CAAC;IACxE,CAAC;AACH,CAAC;AAED,kEAAkE;AAElE,2DAA2D;AAC3D,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAO,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,OAAO,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,OAAO,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,OAAO,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;AACpC,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,4BAA4B,CAAC,CAAC;IACvD,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AAClC,CAAC;AAED,kCAAkC;AAClC,MAAM,UAAU,KAAK;IACnB,OAAO,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAC/C,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,452 @@
+import { Principal } from '@icp-sdk/core/principal';
+export type Role = {
+    Owner: null;
+} | {
+    Operator: null;
+} | {
+    Guardian: null;
+};
+export type OperatorStatus = {
+    Active: null;
+} | {
+    Revoked: null;
+} | {
+    Expired: null;
+};
+export interface OperatorPermissions {
+    canReadMemory: boolean;
+    canAppendMemory: boolean;
+    canReadWallet: boolean;
+    callsPerMinute: bigint;
+    /** Bulk backup export (pull/list/metadata). Candid opt: [] = none. */
+    canReadBackup: [] | [boolean];
+}
+export interface OperatorRecord {
+    principal: Principal;
+    name: string;
+    registeredAt: bigint;
+    lastSeen: bigint;
+    permissions: OperatorPermissions;
+    status: OperatorStatus;
+    publicKeyHash: string | null;
+    keyRotatedAt: bigint;
+    keyRotationCount: bigint;
+}
+/** Internal wire type — raw bytes as stored on-canister (plaintext; see encryption.ts) */
+export interface RawMemoryFile {
+    path: string;
+    content: Uint8Array;
+    version: bigint;
+    lastModifiedBy: Principal;
+    lastModifiedAt: bigint;
+}
+/** Public type — content decoded to a UTF-8 string (no decryption; see encryption.ts) */
+export interface MemoryFile {
+    path: string;
+    content: string;
+    version: bigint;
+    lastModifiedBy: Principal;
+    lastModifiedAt: bigint;
+}
+export interface MemoryFileInfo {
+    path: string;
+    version: bigint;
+    lastModifiedAt: bigint;
+}
+/** Internal wire type — raw snapshot bytes from canister (plaintext; see encryption.ts) */
+export interface RawMemoryVersion {
+    version: bigint;
+    modifiedBy: Principal;
+    modifiedAt: bigint;
+    operation: {
+        Set: null;
+    } | {
+        Append: null;
+    } | {
+        Rollback: null;
+    };
+    contentSnapshot: Uint8Array;
+}
+/** Public type — snapshot decoded to a UTF-8 string (no decryption; see encryption.ts) */
+export interface MemoryVersion {
+    version: bigint;
+    modifiedBy: Principal;
+    modifiedAt: bigint;
+    operation: {
+        Set: null;
+    } | {
+        Append: null;
+    } | {
+        Rollback: null;
+    };
+    contentSnapshot: string;
+}
+export interface Account {
+    owner: Principal;
+    subaccount: Uint8Array | null;
+}
+export interface AuditEntry {
+    id: bigint;
+    timestamp: bigint;
+    caller: Principal;
+    callerRole: Role;
+    operation: string;
+    details: string;
+    success: boolean;
+}
+export interface EngramStatus {
+    owner: Principal | null;
+    memoryFileCount: bigint;
+    auditLogSize: bigint;
+    operatorCount: bigint;
+    cyclesBalance: bigint;
+    version: string;
+    guardianCount: bigint;
+    paymentsFrozen: boolean;
+    writesPaused: boolean;
+    backupCount: bigint;
+    totalBackupSize: bigint;
+}
+/** @deprecated Use EngramStatus instead */
+export type VaultStatus = EngramStatus;
+export type EngramRecordStatus = {
+    Active: null;
+} | {
+    Frozen: null;
+} | {
+    Deleted: null;
+};
+/** @deprecated Use EngramRecordStatus instead */
+export type VaultRecordStatus = EngramRecordStatus;
+export interface EngramRecord {
+    owner: Principal;
+    canisterId: Principal;
+    createdAt: bigint;
+    lastTopUp: bigint;
+    status: EngramRecordStatus;
+}
+/** @deprecated Use EngramRecord instead */
+export type VaultRecord = EngramRecord;
+export interface RegistryStatus {
+    totalEngrams: bigint;
+    activeEngrams: bigint;
+    registryVersion: string;
+    engramWasmHash: string;
+}
+export interface GuardianPermissions {
+    canRevokeOperators: boolean;
+    canFreezePayments: boolean;
+    canPauseWrites: boolean;
+}
+export interface GuardianRecord {
+    principal: Principal;
+    name: string;
+    addedAt: bigint;
+    permissions: GuardianPermissions;
+}
+export type SessionStatus = {
+    open: null;
+} | {
+    closing: null;
+} | {
+    closed: null;
+} | {
+    expired: null;
+};
+export interface Eip3009Authorization {
+    from: string;
+    to: string;
+    value: bigint;
+    validAfter: bigint;
+    validBefore: bigint;
+    nonce: Uint8Array;
+    v: number;
+    r: Uint8Array;
+    s: Uint8Array;
+}
+export interface PaymentRequirement {
+    scheme: string;
+    network: string;
+    token: string;
+    amount: bigint;
+    recipient: string;
+    nonce: Uint8Array;
+    expiry: bigint;
+    tokenName: string | null;
+    tokenVersion: string | null;
+}
+export interface PaymentSignature {
+    scheme: string;
+    network: string;
+    signature: Uint8Array;
+    asset: string | null;
+    publicKey: Uint8Array | null;
+    sender: string;
+    nonce: Uint8Array;
+    authorization: Eip3009Authorization | null;
+}
+export interface SessionIntent {
+    network: string;
+    token: string;
+    recipient: string;
+    suggestedDeposit: bigint;
+    minDeposit: bigint | null;
+    expiry: bigint;
+    costPerCall: bigint | null;
+    description: string | null;
+}
+export interface SessionConfig {
+    maxDeposit: bigint;
+    autoClose: boolean;
+    idleTimeout: bigint | null;
+}
+export interface SessionState {
+    id: string;
+    payer: Principal;
+    deposited: bigint;
+    consumed: bigint;
+    remaining: bigint;
+    voucherCount: bigint;
+    status: SessionStatus;
+    openedAt: bigint;
+    lastActivityAt: bigint;
+}
+export interface Voucher {
+    sessionId: string;
+    cumulativeAmount: bigint;
+    sequence: bigint;
+    signature: Uint8Array;
+}
+export interface SpendingPolicy {
+    maxPerTransaction: bigint | null;
+    maxPerDay: bigint | null;
+    rateLimitPerMinute: bigint | null;
+    maxSessionDeposit: bigint | null;
+    maxConcurrentSessions: bigint | null;
+    maxSessionDuration: bigint | null;
+    sessionIdleTimeout: bigint | null;
+    allowedCallers: Principal[] | null;
+    blockedCallers: Principal[] | null;
+}
+export interface ContentEntry {
+    id: string;
+    mimeType: string;
+    totalSize: bigint;
+    chunkCount: bigint;
+    createdAt: bigint;
+}
+export interface ContentRef {
+    id: string;
+    mimeType: string | null;
+    sizeBytes: bigint | null;
+    metadata: Array<[string, string]> | null;
+}
+export interface AccessGrant {
+    grantId: string;
+    contentRef: ContentRef;
+    grantee: Principal;
+    receiptId: string;
+    issuedAt: bigint;
+    expiresAt: bigint;
+    hmac: Uint8Array;
+}
+export type AccessGrantResult = {
+    ok: null;
+} | {
+    expired: string;
+} | {
+    revoked: string;
+} | {
+    invalidGrant: string;
+};
+export interface ContentDelivery {
+    grant: AccessGrant;
+    delivery: {
+        inline: Uint8Array;
+    } | {
+        canisterQuery: {
+            method: string;
+            chunkCount: bigint;
+        };
+    } | {
+        httpUrl: string;
+    } | {
+        assetCanister: {
+            canisterId: Principal;
+            path: string;
+        };
+    };
+}
+export type PaymentResult = {
+    ok: PaymentReceipt;
+} | {
+    insufficientFunds: string;
+} | {
+    invalidSignature: string;
+} | {
+    expired: string;
+} | {
+    policyDenied: string;
+} | {
+    tokenNotAccepted: string;
+} | {
+    networkNotSupported: string;
+} | {
+    settlementFailed: string;
+} | {
+    reputationTooLow: bigint;
+} | {
+    depositBelowMinimum: bigint;
+};
+export interface PaymentReceipt {
+    id: string;
+    amount: bigint;
+    token: string;
+    sender: string;
+    recipient: string;
+    network: string;
+    timestamp: bigint;
+    txHash: string | null;
+    sessionId: string | null;
+    refunded: bigint | null;
+}
+export interface AgentCard {
+    name: string;
+    description: string;
+    services: ServiceEntry[];
+    x402Support: boolean;
+}
+export interface ServiceEntry {
+    name: string;
+    endpoint: string;
+    version: string;
+    skills: string[];
+    domains: string[];
+}
+export type VerificationLevel = {
+    Orb: null;
+} | {
+    Device: null;
+} | {
+    Document: null;
+};
+export interface WorldIdProof {
+    nullifierHash: string;
+    merkleRoot: string;
+    proof: string;
+    verificationLevel: VerificationLevel;
+    verifiedAt: bigint;
+}
+export type BackupType = {
+    FullSnapshot: null;
+} | {
+    PartialSnapshot: null;
+} | {
+    IncrementalDiff: null;
+};
+export type BackupStatus = {
+    Uploading: null;
+} | {
+    Finalized: null;
+} | {
+    Failed: null;
+};
+export type ApprovalStatus = {
+    Pending: null;
+} | {
+    Approved: null;
+} | {
+    Denied: null;
+} | {
+    Used: null;
+} | {
+    Expired: null;
+};
+export interface ApprovalRequest {
+    id: string;
+    caller: Principal;
+    operation: string;
+    amount: bigint;
+    policyLimit: bigint;
+    policyField: string;
+    rationale: string;
+    createdAt: bigint;
+    expiresAt: bigint;
+    status: ApprovalStatus;
+    approvedBy: Principal | null;
+    approvedAt: bigint | null;
+    denialReason: string | null;
+}
+export type EndpointType = {
+    Content: null;
+};
+export type EndpointStatus = {
+    Disabled: null;
+} | {
+    Enabled: null;
+} | {
+    Deleted: null;
+};
+export interface X402Endpoint {
+    id: string;
+    name: string;
+    description: string;
+    endpointType: EndpointType;
+    contentId: string | null;
+    suggestedPrice: bigint;
+    price: bigint;
+    createdBy: Principal;
+    createdAt: bigint;
+    status: EndpointStatus;
+    enabledBy: Principal | null;
+    enabledAt: bigint | null;
+    totalRevenue: bigint;
+    totalPurchases: bigint;
+}
+export interface PurchaseRecord {
+    id: string;
+    endpointId: string;
+    buyer: string;
+    amount: bigint;
+    network: string;
+    timestamp: bigint;
+    receiptId: string;
+    txHash: string | null;
+}
+export interface RevenueSummary {
+    totalRevenue: bigint;
+    totalPurchases: bigint;
+    endpointBreakdown: Array<{
+        endpointId: string;
+        name: string;
+        revenue: bigint;
+        purchases: bigint;
+    }>;
+}
+export interface StorageStats {
+    totalFiles: bigint;
+    totalContentSize: bigint;
+    memoryFilesSize: bigint;
+    memoryFilesCount: bigint;
+    sessionFilesSize: bigint;
+    sessionFilesCount: bigint;
+    versionHistorySize: bigint;
+    versionHistoryCount: bigint;
+    backupSize: bigint;
+    backupCount: bigint;
+    fileLimit: bigint;
+    auditLogSize: bigint;
+}
+export interface BackupMetadata {
+    backupId: string;
+    dbType: string;
+    backupType: BackupType;
+    parentBackupId: string | null;
+    totalSize: bigint;
+    chunkCount: bigint;
+    sha256: string;
+    createdAt: bigint;
+    createdBy: Principal;
+    backupLabel: string | null;
+    status: BackupStatus;
+}

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/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "@engramx/client",
+  "version": "0.1.0",
+  "description": "Client SDK for EngramX — persistent, decentralized memory for AI agents on ICP",
+  "license": "MIT",
+  "author": "EngramX <developer@engramx.ai>",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/vhew/engramx",
+    "directory": "packages/client"
+  },
+  "homepage": "https://github.com/vhew/engramx#readme",
+  "bugs": {
+    "url": "https://github.com/vhew/engramx/issues"
+  },
+  "keywords": [
+    "icp",
+    "internet-computer",
+    "ai-agent",
+    "engram",
+    "memory",
+    "decentralized",
+    "openclaw",
+    "engram"
+  ],
+  "type": "module",
+  "engines": {
+    "node": ">=22.12.0"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "engramx": "./dist/cli.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist/",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "@icp-sdk/core": "^5.4.0"
+  },
+  "dependencies": {
+    "@ic402/client": "^2.5.4",
+    "@icp-sdk/core": "^5.4.0",
+    "@icp-sdk/vetkeys": "0.5.0-beta.0",
+    "cborg": "^5.1.1"
+  },
+  "devDependencies": {
+    "@types/node": "^25.9.2",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.8"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run"
+  }
+}