@sekuire/sdk 0.1.10 → 0.1.11

package/dist/memory/base.d.ts

@@ -10,11 +10,18 @@ export interface MemoryStorage {
     clear(sessionId: string): Promise<void>;
     delete(sessionId: string): Promise<void>;
     exists(sessionId: string): Promise<boolean>;
+    connect?(): Promise<void>;
+    disconnect?(): Promise<void>;
+    isConnected?(): boolean;
 }
 export declare abstract class BaseMemoryStorage implements MemoryStorage {
+    protected _connected: boolean;
     abstract add(sessionId: string, message: MemoryMessage): Promise<void>;
     abstract get(sessionId: string, limit?: number): Promise<MemoryMessage[]>;
     abstract clear(sessionId: string): Promise<void>;
     abstract delete(sessionId: string): Promise<void>;
     abstract exists(sessionId: string): Promise<boolean>;
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    isConnected(): boolean;
 }

package/dist/memory/cloudflare-d1.d.ts

@@ -0,0 +1,24 @@
+import { BaseMemoryStorage, type MemoryMessage } from './base';
+export interface CloudflareD1Config {
+    binding?: any;
+    accountId?: string;
+    databaseId?: string;
+    apiToken?: string;
+    tableName?: string;
+}
+export declare class CloudflareD1Storage extends BaseMemoryStorage {
+    private binding;
+    private config;
+    private tableName;
+    private useRestApi;
+    private tableInitialized;
+    constructor(config: CloudflareD1Config);
+    private executeQuery;
+    private ensureTableExists;
+    add(sessionId: string, message: MemoryMessage): Promise<void>;
+    get(sessionId: string, limit?: number): Promise<MemoryMessage[]>;
+    clear(sessionId: string): Promise<void>;
+    delete(sessionId: string): Promise<void>;
+    exists(sessionId: string): Promise<boolean>;
+    disconnect(): Promise<void>;
+}

package/dist/memory/cloudflare-kv.d.ts

@@ -0,0 +1,25 @@
+import { BaseMemoryStorage, type MemoryMessage } from './base';
+export interface CloudflareKVConfig {
+    binding?: any;
+    accountId?: string;
+    namespaceId?: string;
+    apiToken?: string;
+    keyPrefix?: string;
+}
+export declare class CloudflareKVStorage extends BaseMemoryStorage {
+    private binding;
+    private config;
+    private keyPrefix;
+    private useRestApi;
+    constructor(config: CloudflareKVConfig);
+    private getKey;
+    private kvGet;
+    private kvPut;
+    private kvDelete;
+    add(sessionId: string, message: MemoryMessage): Promise<void>;
+    get(sessionId: string, limit?: number): Promise<MemoryMessage[]>;
+    clear(sessionId: string): Promise<void>;
+    delete(sessionId: string): Promise<void>;
+    exists(sessionId: string): Promise<boolean>;
+    disconnect(): Promise<void>;
+}

package/dist/memory/convex.d.ts

@@ -0,0 +1,21 @@
+import { BaseMemoryStorage, type MemoryMessage } from './base';
+export interface ConvexConfig {
+    url: string;
+    adminKey?: string;
+}
+export declare class ConvexStorage extends BaseMemoryStorage {
+    private client;
+    private config;
+    private connectionPromise;
+    constructor(config: ConvexConfig);
+    connect(): Promise<void>;
+    private ensureConnected;
+    add(sessionId: string, message: MemoryMessage): Promise<void>;
+    get(sessionId: string, limit?: number): Promise<MemoryMessage[]>;
+    clear(sessionId: string): Promise<void>;
+    delete(sessionId: string): Promise<void>;
+    exists(sessionId: string): Promise<boolean>;
+    disconnect(): Promise<void>;
+}
+export declare const CONVEX_SCHEMA_TEMPLATE = "\n// convex/schema.ts\nimport { defineSchema, defineTable } from \"convex/server\";\nimport { v } from \"convex/values\";\n\nexport default defineSchema({\n  sekuireMemory: defineTable({\n    sessionId: v.string(),\n    role: v.union(v.literal(\"user\"), v.literal(\"assistant\"), v.literal(\"system\")),\n    content: v.string(),\n    timestamp: v.number(),\n    metadata: v.optional(v.any()),\n  }).index(\"by_session\", [\"sessionId\", \"timestamp\"]),\n});\n";
+export declare const CONVEX_FUNCTIONS_TEMPLATE = "\n// convex/sekuireMemory.ts\nimport { mutation, query } from \"./_generated/server\";\nimport { v } from \"convex/values\";\n\nexport const add = mutation({\n  args: {\n    sessionId: v.string(),\n    role: v.union(v.literal(\"user\"), v.literal(\"assistant\"), v.literal(\"system\")),\n    content: v.string(),\n    timestamp: v.number(),\n    metadata: v.optional(v.any()),\n  },\n  handler: async (ctx, args) => {\n    await ctx.db.insert(\"sekuireMemory\", args);\n  },\n});\n\nexport const get = query({\n  args: {\n    sessionId: v.string(),\n    limit: v.optional(v.number()),\n  },\n  handler: async (ctx, args) => {\n    let query = ctx.db\n      .query(\"sekuireMemory\")\n      .withIndex(\"by_session\", (q) => q.eq(\"sessionId\", args.sessionId))\n      .order(\"asc\");\n\n    const messages = await query.collect();\n\n    if (args.limit) {\n      return messages.slice(-args.limit);\n    }\n    return messages;\n  },\n});\n\nexport const clear = mutation({\n  args: {\n    sessionId: v.string(),\n  },\n  handler: async (ctx, args) => {\n    const messages = await ctx.db\n      .query(\"sekuireMemory\")\n      .withIndex(\"by_session\", (q) => q.eq(\"sessionId\", args.sessionId))\n      .collect();\n\n    for (const message of messages) {\n      await ctx.db.delete(message._id);\n    }\n  },\n});\n\nexport const exists = query({\n  args: {\n    sessionId: v.string(),\n  },\n  handler: async (ctx, args) => {\n    const message = await ctx.db\n      .query(\"sekuireMemory\")\n      .withIndex(\"by_session\", (q) => q.eq(\"sessionId\", args.sessionId))\n      .first();\n    return message !== null;\n  },\n});\n";

package/dist/memory/dynamodb.d.ts

@@ -0,0 +1,28 @@
+import { BaseMemoryStorage, type MemoryMessage } from './base';
+export interface DynamoDBConfig {
+    tableName: string;
+    region?: string;
+    endpoint?: string;
+    credentials?: {
+        accessKeyId: string;
+        secretAccessKey: string;
+    };
+    createTable?: boolean;
+}
+export declare class DynamoDBStorage extends BaseMemoryStorage {
+    private client;
+    private docClient;
+    private config;
+    private connectionPromise;
+    private tableReady;
+    constructor(config: DynamoDBConfig);
+    connect(): Promise<void>;
+    private ensureTableExists;
+    private ensureConnected;
+    add(sessionId: string, message: MemoryMessage): Promise<void>;
+    get(sessionId: string, limit?: number): Promise<MemoryMessage[]>;
+    clear(sessionId: string): Promise<void>;
+    delete(sessionId: string): Promise<void>;
+    exists(sessionId: string): Promise<boolean>;
+    disconnect(): Promise<void>;
+}

package/dist/memory/in-memory.d.ts

@@ -1,6 +1,7 @@
 import { BaseMemoryStorage, type MemoryMessage } from './base';
 export declare class InMemoryStorage extends BaseMemoryStorage {
     private storage;
+    constructor();
     add(sessionId: string, message: MemoryMessage): Promise<void>;
     get(sessionId: string, limit?: number): Promise<MemoryMessage[]>;
     clear(sessionId: string): Promise<void>;

package/dist/memory/index.d.ts

@@ -2,13 +2,40 @@ export * from './base';
 export * from './in-memory';
 export * from './postgres';
 export * from './redis';
+export * from './sqlite';
+export * from './upstash';
+export * from './cloudflare-kv';
+export * from './cloudflare-d1';
+export * from './dynamodb';
+export * from './turso';
+export * from './convex';
+export * from './registry';
 import type { MemoryStorage } from './base';
 import { type PostgresConfig } from './postgres';
 import { type RedisConfig } from './redis';
-export type MemoryType = 'in-memory' | 'redis' | 'postgres' | 'buffer';
+import { type SQLiteConfig } from './sqlite';
+import { type UpstashConfig } from './upstash';
+import { type CloudflareKVConfig } from './cloudflare-kv';
+import { type CloudflareD1Config } from './cloudflare-d1';
+import { type DynamoDBConfig } from './dynamodb';
+import { type TursoConfig } from './turso';
+import { type ConvexConfig } from './convex';
+import { registerStorage, hasStorage, listStorageTypes, getStorageInfo } from './registry';
+export type BuiltInMemoryType = 'in-memory' | 'buffer' | 'redis' | 'postgres' | 'sqlite' | 'upstash' | 'cloudflare-kv' | 'cloudflare-d1' | 'dynamodb' | 'turso' | 'convex';
+export type MemoryType = BuiltInMemoryType | string;
 export interface MemoryFactoryConfig {
     type: MemoryType;
     redis?: RedisConfig;
     postgres?: PostgresConfig;
+    sqlite?: SQLiteConfig;
+    upstash?: UpstashConfig;
+    cloudflareKV?: CloudflareKVConfig;
+    cloudflareD1?: CloudflareD1Config;
+    dynamodb?: DynamoDBConfig;
+    turso?: TursoConfig;
+    convex?: ConvexConfig;
+    options?: Record<string, unknown>;
+    instance?: MemoryStorage;
 }
 export declare function createMemoryStorage(config: MemoryFactoryConfig): MemoryStorage;
+export { registerStorage, hasStorage, listStorageTypes, getStorageInfo, };

package/dist/memory/postgres.d.ts

@@ -7,13 +7,17 @@ export interface PostgresConfig {
     user?: string;
     password?: string;
     tableName?: string;
+    lazyConnect?: boolean;
 }
 export declare class PostgresStorage extends BaseMemoryStorage {
     private pool;
     private tableName;
-    private initialized;
+    private config;
+    private connectionPromise;
     constructor(config: PostgresConfig);
+    connect(): Promise<void>;
     private initPool;
+    private ensureConnected;
     private createTableIfNotExists;
     add(sessionId: string, message: MemoryMessage): Promise<void>;
     get(sessionId: string, limit?: number): Promise<MemoryMessage[]>;

package/dist/memory/redis.d.ts

@@ -6,13 +6,17 @@ export interface RedisConfig {
     db?: number;
     url?: string;
     keyPrefix?: string;
+    lazyConnect?: boolean;
 }
 export declare class RedisStorage extends BaseMemoryStorage {
     private client;
     private keyPrefix;
-    private connected;
+    private config;
+    private connectionPromise;
     constructor(config: RedisConfig);
+    connect(): Promise<void>;
     private initClient;
+    private ensureConnected;
     private getKey;
     add(sessionId: string, message: MemoryMessage): Promise<void>;
     get(sessionId: string, limit?: number): Promise<MemoryMessage[]>;

package/dist/memory/registry.d.ts

@@ -0,0 +1,12 @@
+import type { MemoryStorage } from './base';
+export type StorageFactory = (config: any) => MemoryStorage;
+export declare function registerStorage(type: string, factory: StorageFactory, description?: string): void;
+export declare function getStorageFactory(type: string): StorageFactory | undefined;
+export declare function hasStorage(type: string): boolean;
+export declare function listStorageTypes(): string[];
+export declare function getStorageInfo(): Array<{
+    type: string;
+    description?: string;
+}>;
+export declare function unregisterStorage(type: string): boolean;
+export declare function clearRegistry(): void;

package/dist/memory/sqlite.d.ts

@@ -0,0 +1,22 @@
+import { BaseMemoryStorage, type MemoryMessage } from './base';
+export interface SQLiteConfig {
+    filename: string;
+    tableName?: string;
+    readonly?: boolean;
+}
+export declare class SQLiteStorage extends BaseMemoryStorage {
+    private db;
+    private config;
+    private tableName;
+    private connectionPromise;
+    constructor(config: SQLiteConfig);
+    connect(): Promise<void>;
+    private ensureTableExists;
+    private ensureConnected;
+    add(sessionId: string, message: MemoryMessage): Promise<void>;
+    get(sessionId: string, limit?: number): Promise<MemoryMessage[]>;
+    clear(sessionId: string): Promise<void>;
+    delete(sessionId: string): Promise<void>;
+    exists(sessionId: string): Promise<boolean>;
+    disconnect(): Promise<void>;
+}

package/dist/memory/turso.d.ts

@@ -0,0 +1,23 @@
+import { BaseMemoryStorage, type MemoryMessage } from './base';
+export interface TursoConfig {
+    url: string;
+    authToken?: string;
+    tableName?: string;
+}
+export declare class TursoStorage extends BaseMemoryStorage {
+    private client;
+    private config;
+    private tableName;
+    private connectionPromise;
+    private tableInitialized;
+    constructor(config: TursoConfig);
+    connect(): Promise<void>;
+    private ensureTableExists;
+    private ensureConnected;
+    add(sessionId: string, message: MemoryMessage): Promise<void>;
+    get(sessionId: string, limit?: number): Promise<MemoryMessage[]>;
+    clear(sessionId: string): Promise<void>;
+    delete(sessionId: string): Promise<void>;
+    exists(sessionId: string): Promise<boolean>;
+    disconnect(): Promise<void>;
+}

package/dist/memory/upstash.d.ts

@@ -0,0 +1,22 @@
+import { BaseMemoryStorage, type MemoryMessage } from './base';
+export interface UpstashConfig {
+    url: string;
+    token: string;
+    keyPrefix?: string;
+}
+export declare class UpstashStorage extends BaseMemoryStorage {
+    private client;
+    private keyPrefix;
+    private config;
+    private connectionPromise;
+    constructor(config: UpstashConfig);
+    connect(): Promise<void>;
+    private ensureConnected;
+    private getKey;
+    add(sessionId: string, message: MemoryMessage): Promise<void>;
+    get(sessionId: string, limit?: number): Promise<MemoryMessage[]>;
+    clear(sessionId: string): Promise<void>;
+    delete(sessionId: string): Promise<void>;
+    exists(sessionId: string): Promise<boolean>;
+    disconnect(): Promise<void>;
+}

package/dist/sdk.d.ts

@@ -13,11 +13,16 @@ export interface SekuireSDKConfig {
     agentName?: string;
     apiUrl?: string;
     apiKey?: string;
+    /** Install token from dashboard (preferred for BYOC deployments) */
+    installToken?: string;
     workspaceId?: string;
     environment?: string;
     autoHeartbeat?: boolean;
-    heartbeatInterval?: number;
+    /** Heartbeat interval in seconds (default: 60) */
+    heartbeatIntervalSeconds?: number;
     loggingEnabled?: boolean;
+    /** Capabilities this agent provides */
+    capabilities?: string[];
 }
 export declare class SekuireSDK {
     private config;
@@ -32,10 +37,11 @@ export declare class SekuireSDK {
      *
      * Required env vars:
      *   SEKUIRE_AGENT_ID - The agent's sekuire_id
+     *   SEKUIRE_INSTALL_TOKEN - Install token from dashboard (required for heartbeat)
      *
      * Optional env vars:
      *   SEKUIRE_API_KEY - API key for authentication (X-API-Key header)
-     *   SEKUIRE_PRIVATE_KEY - Private key for signing (required for heartbeat)
+     *   SEKUIRE_PRIVATE_KEY - Private key for signing
      *   SEKUIRE_AGENT_NAME - Human-readable agent name
      *   SEKUIRE_API_URL - API base URL (default: https://api.sekuire.ai)
      *   SEKUIRE_WORKSPACE_ID - Workspace ID for policy enforcement
@@ -48,19 +54,18 @@ export declare class SekuireSDK {
     /**
      * Start the SDK.
      *
-     * - Sends initial heartbeat
+     * - Bootstraps with Sekuire using the install token
      * - Starts auto-heartbeat loop if enabled
+     *
+     * Requires SEKUIRE_INSTALL_TOKEN to be set (from dashboard or CLI).
      */
     start(): Promise<void>;
     /**
-     * Send a signed heartbeat to the registry.
-     *
-     * The heartbeat proves the agent is running and has access to the private key.
+     * Check if the beacon is connected and sending heartbeats.
      *
-     * @param url Optional public URL where the agent can be reached
-     * @returns True if heartbeat was acknowledged, False otherwise
+     * @returns True if the beacon has successfully bootstrapped
      */
-    heartbeat(url?: string): Promise<boolean>;
+    isConnected(): boolean;
     /**
      * Log an event to Sekuire.
      *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sekuire/sdk",
-  "version": "0.1.10",
+  "version": "0.1.11",
   "description": "Sekuire Identity Protocol SDK for TypeScript/JavaScript",
   "type": "module",
   "main": "dist/index.js",
@@ -73,7 +73,12 @@
     "zod": "^3.22.4"
   },
   "devDependencies": {
+    "@aws-sdk/client-dynamodb": "^3.700.0",
+    "@aws-sdk/lib-dynamodb": "^3.700.0",
     "@biomejs/biome": "^1.9.4",
+    "@libsql/client": "^0.14.0",
+    "@types/better-sqlite3": "^7.6.0",
+    "better-sqlite3": "^11.0.0",
     "@rollup/plugin-commonjs": "^25.0.8",
     "@rollup/plugin-json": "^6.1.0",
     "@rollup/plugin-node-resolve": "^15.3.1",
@@ -82,7 +87,9 @@
     "@types/js-yaml": "^4.0.9",
     "@types/node": "^20.19.27",
     "@types/uuid": "^9.0.8",
+    "@upstash/redis": "^1.34.0",
     "@vitest/coverage-v8": "^1.6.1",
+    "convex": "^1.17.0",
     "jsdom": "^23.2.0",
     "rollup": "^4.54.0",
     "rollup-plugin-dts": "^6.3.0",
@@ -93,7 +100,13 @@
   "peerDependencies": {
     "node-fetch": "^2.6.0",
     "pg": "^8.11.0",
-    "redis": "^4.6.0"
+    "redis": "^4.6.0",
+    "better-sqlite3": "^11.0.0",
+    "@upstash/redis": "^1.28.0",
+    "@aws-sdk/client-dynamodb": "^3.500.0",
+    "@aws-sdk/lib-dynamodb": "^3.500.0",
+    "@libsql/client": "^0.5.0",
+    "convex": "^1.10.0"
   },
   "peerDependenciesMeta": {
     "node-fetch": {
@@ -104,6 +117,24 @@
     },
     "pg": {
       "optional": true
+    },
+    "better-sqlite3": {
+      "optional": true
+    },
+    "@upstash/redis": {
+      "optional": true
+    },
+    "@aws-sdk/client-dynamodb": {
+      "optional": true
+    },
+    "@aws-sdk/lib-dynamodb": {
+      "optional": true
+    },
+    "@libsql/client": {
+      "optional": true
+    },
+    "convex": {
+      "optional": true
     }
   },
   "optionalDependencies": {