@sykeclone/kage-sdk 1.0.0

package/README.md

@@ -0,0 +1,177 @@
+# Kage — Onchain Agent Memory Protocol
+
+> *影 (Kage) — Shadow. What an agent remembers is its shadow on the chain.*
+
+Kage is the missing memory layer for autonomous AI agents on Sui.
+Not just persistent storage — queryable, conflict-aware, event-driven,
+temporally-snapshotted, cross-graph agent cognition infrastructure.
+
+Built for **Sui Overflow 2026 — Walrus Track**.
+
+---
+
+## The Problem
+
+Agents today forget. They rely on fragile local memory, can't share context
+across workflows, and produce zero verifiable audit trail. When a trade goes
+wrong, there is no record of what the agent knew, or why it decided.
+
+LangGraph, Mastra, ElizaOS — none of them solve this. They're all offchain.
+
+## Kage Solves It With 5 Primitives
+
+| # | Feature | What it does |
+|---|---------|-------------|
+| 1 | **Associative Memory Index** | Tag-based semantic query — find memories by asset, action, namespace, confidence |
+| 2 | **Conflict Detection** | Two agents disagree on BTC? Flagged automatically onchain |
+| 3 | **Memory Inheritance** | Child agent bootstraps from parent memory — linked provenance chain |
+| 4 | **Temporal Snapshots** | Freeze namespace state at any point — full time travel audit |
+| 5 | **Cross-graph Sharing** | Two separate agent graphs share a memory namespace via a permissioned bridge |
+
+Plus **event-driven triggers** — subscriptions that fire a Sui event when
+a matching memory is written, waking the next agent automatically.
+
+---
+
+## Architecture
+
+```
+Your Agent (TypeScript/Python)
+        │
+        ▼
+   Kage Runtime SDK
+   ┌──────────────────────────────┐
+   │  write() / inherit()         │
+   │  snapshot() / share()        │
+   │  subscribe() / recall()      │
+   └──────────┬───────────────────┘
+              │
+      ┌───────┴────────┐
+      ▼                ▼
+  Walrus            Sui Move
+  (blob storage)    (truth layer)
+  blob_id ──────────► memory index
+  state JSON         conflict detection
+  persistent         subscriptions
+  verifiable         snapshots
+                     cross-graph bridges
+```
+
+---
+
+## Quick Start
+
+### 1. Deploy the contract
+
+```bash
+chmod +x deploy.sh
+./deploy.sh          # mainnet
+./deploy.sh --testnet
+```
+
+### 2. Configure
+
+```bash
+cp .env.example .env
+# Fill in SUI_PRIVATE_KEY_B64
+# KAGE_PACKAGE_ID and KAGE_PROTOCOL_ID are filled by deploy.sh
+```
+
+### 3. Install and run the demo
+
+```bash
+npm install
+npm run demo
+```
+
+---
+
+## SDK Usage
+
+```typescript
+import { Kage } from './src/kage.js';
+
+const kage = new Kage({
+  suiRpcUrl:           'https://fullnode.mainnet.sui.io:443',
+  privateKeyB64:       process.env.SUI_PRIVATE_KEY_B64!,
+  packageId:           process.env.KAGE_PACKAGE_ID!,
+  protocolId:          process.env.KAGE_PROTOCOL_ID!,
+  walrusAggregatorUrl: process.env.WALRUS_AGGREGATOR_URL!,
+  walrusPublisherUrl:  process.env.WALRUS_PUBLISHER_URL!,
+  agentName:           'MyAgent',
+  namespace:           'myapp',
+});
+
+await kage.init();
+
+// Write a memory
+const result = await kage.write({
+  state:      { signal: 'UP', price: 67420 },
+  tags:       ['BTC', 'SCOUT', 'UP'],
+  asset:      'BTC',
+  action:     'BUY',
+  confidence: 78,
+});
+
+// Inherit from parent
+const child = await kage.inherit(result.memoryId, newState, 'EXECUTE', ['BTC', 'RISK'], 65);
+
+// Snapshot the namespace
+await kage.snapshot('Pre-trade state captured');
+
+// Cross-graph share
+await kage.createBridge(otherProtocolId, 'shared-signals');
+await kage.shareMemory(bridgeId, otherProtocolId, result.memoryId);
+
+// Subscribe to BUY signals
+await kage.subscribe(['BUY'], 'BTC', 'BUY', 'myapp');
+
+// Recall a blob from Walrus
+const state = await kage.recall(result.blobId);
+
+// Report outcome (updates reputation)
+await kage.reportOutcome(result.memoryId, 'SUCCESS');
+```
+
+---
+
+## AlphaLoop Demo
+
+AlphaLoop is a live 4-node trading agent that uses Kage as its memory layer.
+It pulls signals from Trend Pilot (X Layer) and runs Scout → Risk → Decide → Execute.
+
+Every node writes to Walrus, inherits from the previous node,
+and the full decision trail is anchored onchain.
+
+```bash
+npm run demo
+```
+
+---
+
+## File Structure
+
+```
+kage/
+├── move/
+│   ├── Move.toml
+│   └── sources/
+│       └── kage.move          # The full protocol contract
+├── src/
+│   ├── kage.ts                # Main SDK
+│   ├── walrus.ts              # Walrus client
+│   ├── sui.ts                 # Sui Move client
+│   ├── types/
+│   │   └── index.ts           # All TypeScript types
+│   └── demo/
+│       └── alphaloop.ts       # Live trading agent demo
+├── deploy.sh                  # One-command deploy
+├── .env.example
+├── package.json
+└── tsconfig.json
+```
+
+---
+
+## Built by Semideus / @syke0x
+Sui Overflow 2026 — Walrus Track — $70K prize pool

package/dist/demo/alphaloop.d.ts

@@ -0,0 +1,13 @@
+/**
+ * AlphaLoop — Kage Demo Agent
+ *
+ * 4 nodes: Scout → Risk → Decide → Execute
+ * Each node writes memory to Walrus, anchors onchain via Kage protocol.
+ * Demonstrates: associative index, conflict detection, inheritance,
+ * temporal snapshots, and cross-graph sharing.
+ *
+ * Signal source: Trend Pilot API (X Layer)
+ * Protocol: Kage on Sui Mainnet
+ */
+export {};
+//# sourceMappingURL=alphaloop.d.ts.map

package/dist/demo/alphaloop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"alphaloop.d.ts","sourceRoot":"","sources":["../../src/demo/alphaloop.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG"}

package/dist/demo/alphaloop.js

@@ -0,0 +1,238 @@
+/**
+ * AlphaLoop — Kage Demo Agent
+ *
+ * 4 nodes: Scout → Risk → Decide → Execute
+ * Each node writes memory to Walrus, anchors onchain via Kage protocol.
+ * Demonstrates: associative index, conflict detection, inheritance,
+ * temporal snapshots, and cross-graph sharing.
+ *
+ * Signal source: Trend Pilot API (X Layer)
+ * Protocol: Kage on Sui Mainnet
+ */
+import { config } from "dotenv";
+import { resolve, dirname } from "path";
+import { fileURLToPath } from "url";
+const __dirname = dirname(fileURLToPath(import.meta.url));
+config({ path: resolve(__dirname, "../../.env") });
+import { Kage } from '../kage.js';
+import crypto from 'crypto';
+// ─── Config ───────────────────────────────────────────────────────────────────
+const TREND_PILOT_URL = process.env.TREND_PILOT_URL ?? 'http://108.61.91.153:8000';
+const ASSETS = ['BTC', 'ETH', 'XAUT'];
+const CYCLE_DELAY_MS = Number(process.env.CYCLE_DELAY_MS ?? 60_000); // 1 min default
+const NAMESPACE = 'alphaloop';
+// ─── Kage Instance ────────────────────────────────────────────────────────────
+function buildKage() {
+    const required = [
+        'SUI_PRIVATE_KEY_B64',
+        'KAGE_PACKAGE_ID',
+        'KAGE_PROTOCOL_ID',
+        'WALRUS_AGGREGATOR_URL',
+        'WALRUS_PUBLISHER_URL',
+    ];
+    for (const key of required) {
+        if (!process.env[key])
+            throw new Error(`Missing env: ${key}`);
+    }
+    return new Kage({
+        suiRpcUrl: process.env.SUI_RPC_URL ?? 'https://fullnode.mainnet.sui.io:443',
+        privateKeyB64: process.env.SUI_PRIVATE_KEY_B64,
+        packageId: process.env.KAGE_PACKAGE_ID,
+        protocolId: process.env.KAGE_PROTOCOL_ID,
+        walrusAggregatorUrl: process.env.WALRUS_AGGREGATOR_URL,
+        walrusPublisherUrl: process.env.WALRUS_PUBLISHER_URL,
+        agentName: 'AlphaLoop',
+        namespace: NAMESPACE,
+        defaultTtlEpochs: 10,
+        cycleDelayMs: CYCLE_DELAY_MS,
+    });
+}
+// ─── Node: Scout ──────────────────────────────────────────────────────────────
+async function nodeScout(kage, asset, cycleId) {
+    console.log(`\n[Scout] Fetching signal for ${asset}`);
+    const url = `${TREND_PILOT_URL}/signal/${asset}/free`;
+    const res = await fetch(url);
+    if (!res.ok)
+        throw new Error(`Trend Pilot free signal failed [${res.status}]`);
+    const free = await res.json();
+    // Build partial signal from free endpoint
+    const signal = {
+        asset,
+        direction: free.direction ?? 'HOLD',
+        confidence: Number(free.confidence ?? 50),
+        rsi: 0,
+        vwap: 0,
+        bollinger_upper: 0,
+        bollinger_lower: 0,
+        momentum: 0,
+        order_book_pressure: 0,
+        price: Number(free.price ?? 0),
+        timestamp: new Date().toISOString(),
+    };
+    const state = {
+        cycleId,
+        asset,
+        scoutSignal: signal,
+        startedAt: Date.now(),
+    };
+    const action = signal.direction === 'UP'
+        ? 'BUY'
+        : signal.direction === 'DOWN' ? 'SELL' : 'OBSERVE';
+    const writeResult = await kage.write({
+        state,
+        tags: [asset, 'SCOUT', signal.direction, `CONF_${Math.floor(signal.confidence)}`],
+        asset,
+        action,
+        confidence: Math.floor(signal.confidence),
+        namespace: NAMESPACE,
+    });
+    state.scoutBlobId = writeResult.blobId;
+    console.log(`[Scout] Memory #${writeResult.memoryId} | blob: ${writeResult.blobId}`);
+    if (writeResult.conflictDetected) {
+        console.warn(`[Scout] ⚠️  Conflict detected with existing memory`);
+    }
+    return { state, writeResult };
+}
+// ─── Node: Risk ───────────────────────────────────────────────────────────────
+async function nodeRisk(kage, state, scoutMemoryId) {
+    console.log(`[Risk] Evaluating risk for ${state.asset}`);
+    let risk;
+    try {
+        const res = await fetch(`${TREND_PILOT_URL}/signal/${state.asset}/free`);
+        const data = await res.json();
+        risk = {
+            asset: state.asset,
+            risk_level: data.confidence > 70 ? 'LOW' : data.confidence > 40 ? 'MEDIUM' : 'HIGH',
+            volatility: Math.random() * 5,
+            trend: data.direction ?? 'HOLD',
+            momentum: data.confidence ?? 50,
+        };
+    }
+    catch {
+        risk = {
+            asset: state.asset,
+            risk_level: 'MEDIUM',
+            volatility: 2.5,
+            trend: 'UNKNOWN',
+            momentum: 50,
+        };
+    }
+    state.riskAssessment = risk;
+    // Inherit from scout memory — demonstrates feature 3
+    const writeResult = await kage.inherit(scoutMemoryId, { ...state, node: 'risk', risk }, 'OBSERVE', [state.asset, 'RISK', risk.risk_level], Math.floor(state.scoutSignal?.confidence ?? 50));
+    state.riskBlobId = writeResult.blobId;
+    console.log(`[Risk] Memory #${writeResult.childMemoryId} (inherited from #${scoutMemoryId})`);
+    return { state, writeResult: { ...writeResult, memoryId: writeResult.childMemoryId, blobHash: writeResult.blobId, conflictDetected: false } };
+}
+// ─── Node: Decide ─────────────────────────────────────────────────────────────
+async function nodeDecide(kage, state) {
+    console.log(`[Decide] Making decision for ${state.asset}`);
+    const signal = state.scoutSignal;
+    const risk = state.riskAssessment;
+    let decision;
+    let reason;
+    if (risk.risk_level === 'HIGH') {
+        decision = 'HOLD';
+        reason = 'Risk too high — standing down';
+    }
+    else if (signal.direction === 'UP' && risk.risk_level === 'LOW') {
+        decision = 'BUY';
+        reason = `Strong uptrend, low risk — buying ${state.asset}`;
+    }
+    else if (signal.direction === 'DOWN' && risk.risk_level === 'LOW') {
+        decision = 'SELL';
+        reason = `Downtrend confirmed, low risk — selling ${state.asset}`;
+    }
+    else {
+        decision = 'HOLD';
+        reason = 'Mixed signals — holding position';
+    }
+    state.decision = decision;
+    state.decisionReason = reason;
+    console.log(`[Decide] → ${decision}: ${reason}`);
+    const writeResult = await kage.write({
+        state: { ...state, node: 'decide' },
+        tags: [state.asset, 'DECISION', decision, risk.risk_level],
+        asset: state.asset,
+        action: decision,
+        confidence: Math.floor(signal.confidence),
+        namespace: NAMESPACE,
+    });
+    state.decisionBlobId = writeResult.blobId;
+    return { state, writeResult };
+}
+// ─── Node: Execute ────────────────────────────────────────────────────────────
+async function nodeExecute(kage, state, decisionMemoryId) {
+    console.log(`[Execute] Executing ${state.decision} on ${state.asset}`);
+    // In production: submit actual trade via DEX SDK
+    // Here: log execution intent with full provenance
+    const executionNote = state.decision === 'HOLD'
+        ? `No trade — HOLD signal on ${state.asset} @ cycle ${state.cycleId}`
+        : `${state.decision} order intent on ${state.asset} — reason: ${state.decisionReason}`;
+    state.executionNote = executionNote;
+    state.completedAt = Date.now();
+    const writeResult = await kage.write({
+        state: { ...state, node: 'execute' },
+        tags: [state.asset, 'EXECUTION', state.decision, 'CYCLE_COMPLETE'],
+        asset: state.asset,
+        action: 'EXECUTE',
+        confidence: 100,
+        namespace: NAMESPACE,
+    });
+    state.executionBlobId = writeResult.blobId;
+    console.log(`[Execute] ✅ ${executionNote}`);
+    console.log(`[Execute] Memory #${writeResult.memoryId} | blob: ${writeResult.blobId}`);
+    // Report outcome as PENDING (updated after trade settles)
+    // await kage.reportOutcome(writeResult.memoryId, 'PENDING');
+    return { state, writeResult };
+}
+// ─── Main Loop ────────────────────────────────────────────────────────────────
+async function main() {
+    console.log('╔════════════════════════════════════════╗');
+    console.log('║     AlphaLoop — Kage Demo Agent        ║');
+    console.log('║     Sui Mainnet + Walrus               ║');
+    console.log('╚════════════════════════════════════════╝\n');
+    const kage = buildKage();
+    await kage.init();
+    // Subscribe to BUY signals from any agent (event-driven triggers demo)
+    await kage.subscribe(['BUY'], '', 'BUY', NAMESPACE);
+    console.log('[AlphaLoop] Subscribed to BUY signals');
+    const stats = await kage.stats();
+    console.log(`[AlphaLoop] Protocol stats:`, stats);
+    let cycle = 0;
+    while (true) {
+        cycle++;
+        console.log(`\n${'═'.repeat(50)}`);
+        console.log(`[AlphaLoop] Cycle #${cycle} — ${new Date().toISOString()}`);
+        for (const asset of ASSETS) {
+            try {
+                const cycleId = `${asset}-${cycle}-${crypto.randomBytes(4).toString('hex')}`;
+                // Node 1: Scout
+                const { state: s1, writeResult: r1 } = await nodeScout(kage, asset, cycleId);
+                // Node 2: Risk (inherits from Scout — feature 3)
+                const { state: s2, writeResult: r2 } = await nodeRisk(kage, s1, r1.memoryId);
+                // Node 3: Decide
+                const { state: s3, writeResult: r3 } = await nodeDecide(kage, s2);
+                // Node 4: Execute
+                const { state: s4, writeResult: r4 } = await nodeExecute(kage, s3, r3.memoryId);
+                // Feature 4: Snapshot after each asset cycle
+                await kage.snapshot(`Cycle ${cycle} — ${asset} complete. Decision: ${s4.decision}`, NAMESPACE);
+                console.log(`[AlphaLoop] ✓ ${asset} cycle complete | decision: ${s4.decision}`);
+            }
+            catch (err) {
+                console.error(`[AlphaLoop] ✗ ${asset} cycle failed:`, err);
+            }
+            await sleep(5_000); // 5s between assets
+        }
+        const finalStats = await kage.stats();
+        console.log(`\n[AlphaLoop] Protocol after cycle ${cycle}:`, finalStats);
+        console.log(`[AlphaLoop] Sleeping ${CYCLE_DELAY_MS / 1000}s until next cycle...`);
+        await sleep(CYCLE_DELAY_MS);
+    }
+}
+function sleep(ms) { return new Promise(r => setTimeout(r, ms)); }
+main().catch(err => {
+    console.error('[AlphaLoop] Fatal:', err);
+    process.exit(1);
+});
+//# sourceMappingURL=alphaloop.js.map

package/dist/demo/alphaloop.js.map

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

package/dist/kage.d.ts

@@ -0,0 +1,28 @@
+import { KageConfig, WriteMemoryParams, WriteResult, InheritResult, SnapshotResult, Action, Outcome } from './types/index.js';
+export declare class Kage {
+    private walrus;
+    private sui;
+    private config;
+    private registered;
+    constructor(config: KageConfig);
+    get address(): string;
+    init(): Promise<void>;
+    write(params: WriteMemoryParams): Promise<WriteResult>;
+    inherit(parentMemoryId: number, newState: Record<string, unknown>, action: Action, tags: string[], confidence: number, ttlEpochs?: number): Promise<InheritResult>;
+    snapshot(description: string, namespace?: string): Promise<SnapshotResult>;
+    createBridge(targetProtocolId: string, sharedNamespace: string): Promise<string>;
+    shareMemory(bridgeId: string, targetProtocolId: string, memoryId: number): Promise<string>;
+    subscribe(watchTags: string[], watchAsset?: string, watchAction?: string, watchNamespace?: string): Promise<string>;
+    reportOutcome(memoryId: number, outcome: Outcome): Promise<string>;
+    recall(blobId: string): Promise<Record<string, unknown>>;
+    verify(blobId: string, hash: string): Promise<boolean>;
+    stats(): Promise<{
+        walletBalance: string;
+        address: string;
+        totalMemories: number;
+        totalConflicts: number;
+        totalSnapshots: number;
+        totalSubscriptions: number;
+    }>;
+}
+//# sourceMappingURL=kage.d.ts.map

package/dist/kage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kage.d.ts","sourceRoot":"","sources":["../src/kage.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,UAAU,EAAE,iBAAiB,EAAE,WAAW,EAC1C,aAAa,EAAE,cAAc,EAAE,MAAM,EAAE,OAAO,EAC/C,MAAM,kBAAkB,CAAC;AAE1B,qBAAa,IAAI;IACf,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,GAAG,CAAmB;IAC9B,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,UAAU,CAAS;gBAEf,MAAM,EAAE,UAAU;IAM9B,IAAI,OAAO,IAAI,MAAM,CAA6B;IAI5C,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAUrB,KAAK,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,WAAW,CAAC;IAsCtD,OAAO,CACX,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EAAE,EACd,UAAU,EAAE,MAAM,EAClB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,aAAa,CAAC;IAuBnB,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAc1E,YAAY,CAAC,gBAAgB,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAUhF,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAa1F,SAAS,CACb,SAAS,EAAE,MAAM,EAAE,EACnB,UAAU,SAAK,EACf,WAAW,SAAK,EAChB,cAAc,SAAK,GAClB,OAAO,CAAC,MAAM,CAAC;IAYZ,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC;IAMlE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAIxD,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAMtD,KAAK;;;;;;;;CAOZ"}

package/dist/kage.js

@@ -0,0 +1,100 @@
+import { WalrusClient } from './walrus.js';
+import { KageSuiClient } from './sui.js';
+export class Kage {
+    walrus;
+    sui;
+    config;
+    registered = false;
+    constructor(config) {
+        this.config = config;
+        this.walrus = new WalrusClient(config.walrusAggregatorUrl, config.walrusPublisherUrl);
+        this.sui = new KageSuiClient(config.suiRpcUrl, config.privateKeyB64, config.packageId);
+    }
+    get address() { return this.sui.address; }
+    // ─── Bootstrap ──────────────────────────────────────────────────────────────
+    async init() {
+        if (this.registered)
+            return;
+        console.log(`[Kage] Registering agent ${this.config.agentName} in namespace ${this.config.namespace}`);
+        await this.sui.registerAgent(this.config.protocolId, this.config.agentName, this.config.namespace);
+        this.registered = true;
+        console.log(`[Kage] Agent registered. Address: ${this.address}`);
+    }
+    // ─── 1. Write Memory ────────────────────────────────────────────────────────
+    async write(params) {
+        const namespace = params.namespace ?? this.config.namespace;
+        const ttlEpochs = params.ttlEpochs ?? this.config.defaultTtlEpochs ?? 10;
+        // 1. Upload state blob to Walrus
+        console.log(`[Kage] Uploading state to Walrus — asset=${params.asset} action=${params.action}`);
+        const { blobId, blobHash, size } = await this.walrus.upload(params.state, ttlEpochs);
+        console.log(`[Kage] Blob uploaded: ${blobId} (${size}b)`);
+        // 2. Wait for blob propagation
+        await this.walrus.waitForBlob(blobId);
+        // 3. Anchor to Sui with full semantic metadata
+        const { txDigest, memoryId } = await this.sui.writeMemory(this.config.protocolId, blobId, blobHash, params.tags, params.asset, params.action, params.confidence, ttlEpochs, namespace);
+        console.log(`[Kage] Memory #${memoryId} anchored onchain — tx: ${txDigest}`);
+        return {
+            memoryId,
+            blobId,
+            blobHash,
+            txDigest,
+            conflictDetected: false, // resolved from event in advanced usage
+        };
+    }
+    // ─── 3. Inherit Memory ──────────────────────────────────────────────────────
+    async inherit(parentMemoryId, newState, action, tags, confidence, ttlEpochs) {
+        const epochs = ttlEpochs ?? this.config.defaultTtlEpochs ?? 10;
+        const { blobId, blobHash } = await this.walrus.upload(newState, epochs);
+        await this.walrus.waitForBlob(blobId);
+        const { txDigest, childId } = await this.sui.inheritMemory(this.config.protocolId, parentMemoryId, blobId, blobHash, tags, action, confidence, epochs);
+        console.log(`[Kage] Memory #${childId} inherited from #${parentMemoryId} — tx: ${txDigest}`);
+        return { childMemoryId: childId, parentMemoryId, blobId, txDigest };
+    }
+    // ─── 4. Snapshot ────────────────────────────────────────────────────────────
+    async snapshot(description, namespace) {
+        const ns = namespace ?? this.config.namespace;
+        const txDigest = await this.sui.takeSnapshot(this.config.protocolId, ns, description);
+        const state = await this.sui.getProtocolState(this.config.protocolId);
+        console.log(`[Kage] Snapshot taken — tx: ${txDigest}`);
+        return {
+            snapshotId: state.totalSnapshots - 1,
+            takenAtSequence: state.totalMemories,
+            txDigest,
+        };
+    }
+    // ─── 5. Cross-graph Bridge ──────────────────────────────────────────────────
+    async createBridge(targetProtocolId, sharedNamespace) {
+        const txDigest = await this.sui.createBridge(this.config.protocolId, targetProtocolId, sharedNamespace);
+        console.log(`[Kage] Bridge created to ${targetProtocolId} — namespace: ${sharedNamespace}`);
+        return txDigest;
+    }
+    async shareMemory(bridgeId, targetProtocolId, memoryId) {
+        const txDigest = await this.sui.shareMemoryAcross(bridgeId, this.config.protocolId, targetProtocolId, memoryId);
+        console.log(`[Kage] Memory #${memoryId} shared across bridge ${bridgeId}`);
+        return txDigest;
+    }
+    // ─── Subscriptions ──────────────────────────────────────────────────────────
+    async subscribe(watchTags, watchAsset = '', watchAction = '', watchNamespace = '') {
+        return this.sui.subscribe(this.config.protocolId, watchTags, watchAsset, watchAction, watchNamespace);
+    }
+    // ─── Outcome Feedback ───────────────────────────────────────────────────────
+    async reportOutcome(memoryId, outcome) {
+        return this.sui.recordOutcome(this.config.protocolId, memoryId, outcome);
+    }
+    // ─── Recall (Walrus fetch by blob_id) ───────────────────────────────────────
+    async recall(blobId) {
+        return this.walrus.download(blobId);
+    }
+    async verify(blobId, hash) {
+        return this.walrus.verify(blobId, hash);
+    }
+    // ─── Protocol State ─────────────────────────────────────────────────────────
+    async stats() {
+        const [state, balance] = await Promise.all([
+            this.sui.getProtocolState(this.config.protocolId),
+            this.sui.getBalance(),
+        ]);
+        return { ...state, walletBalance: balance, address: this.address };
+    }
+}
+//# sourceMappingURL=kage.js.map

package/dist/kage.js.map

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

package/dist/sui.d.ts

@@ -0,0 +1,30 @@
+export declare class KageSuiClient {
+    private client;
+    private keypair;
+    private packageId;
+    constructor(rpcUrl: string, privateKey: string, packageId: string);
+    get address(): string;
+    registerAgent(protocolId: string, name: string, namespace: string): Promise<string>;
+    writeMemory(protocolId: string, blobId: string, blobHash: string, tags: string[], asset: string, action: string, confidence: number, ttlEpochs: number, namespace: string): Promise<{
+        txDigest: string;
+        memoryId: number;
+    }>;
+    inheritMemory(protocolId: string, parentId: number, blobId: string, blobHash: string, tags: string[], action: string, confidence: number, ttlEpochs: number): Promise<{
+        txDigest: string;
+        childId: number;
+    }>;
+    takeSnapshot(protocolId: string, namespace: string, description: string): Promise<string>;
+    createBridge(protocolAId: string, protocolBId: string, sharedNamespace: string): Promise<string>;
+    shareMemoryAcross(bridgeId: string, sourceProtocolId: string, targetProtocolId: string, memoryId: number): Promise<string>;
+    subscribe(protocolId: string, watchTags: string[], watchAsset: string, watchAction: string, watchNamespace: string): Promise<string>;
+    recordOutcome(protocolId: string, memoryId: number, outcome: string): Promise<string>;
+    getProtocolState(protocolId: string): Promise<{
+        totalMemories: number;
+        totalConflicts: number;
+        totalSnapshots: number;
+        totalSubscriptions: number;
+    }>;
+    getBalance(): Promise<string>;
+    private exec;
+}
+//# sourceMappingURL=sui.d.ts.map

package/dist/sui.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sui.d.ts","sourceRoot":"","sources":["../src/sui.ts"],"names":[],"mappings":"AAOA,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,OAAO,CAAmB;IAClC,OAAO,CAAC,SAAS,CAAS;gBAEd,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;IAMjE,IAAI,OAAO,IAAI,MAAM,CAAuD;IAEtE,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAanF,WAAW,CACf,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EAAE,EACd,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAqB5C,aAAa,CACjB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EAAE,EACd,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAoB3C,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAazF,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAahG,iBAAiB,CACrB,QAAQ,EAAE,MAAM,EAChB,gBAAgB,EAAE,MAAM,EACxB,gBAAgB,EAAE,MAAM,EACxB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,CAAC;IAcZ,SAAS,CACb,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EAAE,EACnB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,MAAM,CAAC;IAeZ,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAarF,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC;QAClD,aAAa,EAAE,MAAM,CAAC;QACtB,cAAc,EAAE,MAAM,CAAC;QACvB,cAAc,EAAE,MAAM,CAAC;QACvB,kBAAkB,EAAE,MAAM,CAAC;KAC5B,CAAC;IAWI,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;YAMrB,IAAI;CAWnB"}

package/dist/sui.js

@@ -0,0 +1,161 @@
+import { SuiClient } from '@mysten/sui/client';
+import { Ed25519Keypair } from '@mysten/sui/keypairs/ed25519';
+import { Transaction } from '@mysten/sui/transactions';
+export class KageSuiClient {
+    client;
+    keypair;
+    packageId;
+    constructor(rpcUrl, privateKey, packageId) {
+        this.client = new SuiClient({ url: rpcUrl });
+        this.keypair = Ed25519Keypair.fromSecretKey(privateKey);
+        this.packageId = packageId;
+    }
+    get address() { return this.keypair.getPublicKey().toSuiAddress(); }
+    async registerAgent(protocolId, name, namespace) {
+        const tx = new Transaction();
+        tx.moveCall({
+            target: `${this.packageId}::kage::register_agent`,
+            arguments: [
+                tx.object(protocolId),
+                tx.pure.vector('u8', enc(name)),
+                tx.pure.vector('u8', enc(namespace)),
+            ],
+        });
+        return this.exec(tx);
+    }
+    async writeMemory(protocolId, blobId, blobHash, tags, asset, action, confidence, ttlEpochs, namespace) {
+        const tx = new Transaction();
+        tx.moveCall({
+            target: `${this.packageId}::kage::write_memory`,
+            arguments: [
+                tx.object(protocolId),
+                tx.pure.vector('u8', enc(blobId)),
+                tx.pure.vector('u8', hexToBytes(blobHash)),
+                tx.pure.vector('vector<u8>', tags.map(enc)),
+                tx.pure.vector('u8', enc(asset)),
+                tx.pure.vector('u8', enc(action)),
+                tx.pure.u64(confidence),
+                tx.pure.u64(ttlEpochs),
+                tx.pure.vector('u8', enc(namespace)),
+            ],
+        });
+        const digest = await this.exec(tx);
+        const state = await this.getProtocolState(protocolId);
+        return { txDigest: digest, memoryId: state.totalMemories - 1 };
+    }
+    async inheritMemory(protocolId, parentId, blobId, blobHash, tags, action, confidence, ttlEpochs) {
+        const tx = new Transaction();
+        tx.moveCall({
+            target: `${this.packageId}::kage::inherit_memory`,
+            arguments: [
+                tx.object(protocolId),
+                tx.pure.u64(parentId),
+                tx.pure.vector('u8', enc(blobId)),
+                tx.pure.vector('u8', hexToBytes(blobHash)),
+                tx.pure.vector('vector<u8>', tags.map(enc)),
+                tx.pure.vector('u8', enc(action)),
+                tx.pure.u64(confidence),
+                tx.pure.u64(ttlEpochs),
+            ],
+        });
+        const digest = await this.exec(tx);
+        const state = await this.getProtocolState(protocolId);
+        return { txDigest: digest, childId: state.totalMemories - 1 };
+    }
+    async takeSnapshot(protocolId, namespace, description) {
+        const tx = new Transaction();
+        tx.moveCall({
+            target: `${this.packageId}::kage::take_snapshot`,
+            arguments: [
+                tx.object(protocolId),
+                tx.pure.vector('u8', enc(namespace)),
+                tx.pure.vector('u8', enc(description)),
+            ],
+        });
+        return this.exec(tx);
+    }
+    async createBridge(protocolAId, protocolBId, sharedNamespace) {
+        const tx = new Transaction();
+        tx.moveCall({
+            target: `${this.packageId}::kage::create_bridge`,
+            arguments: [
+                tx.object(protocolAId),
+                tx.object(protocolBId),
+                tx.pure.vector('u8', enc(sharedNamespace)),
+            ],
+        });
+        return this.exec(tx);
+    }
+    async shareMemoryAcross(bridgeId, sourceProtocolId, targetProtocolId, memoryId) {
+        const tx = new Transaction();
+        tx.moveCall({
+            target: `${this.packageId}::kage::share_memory_across`,
+            arguments: [
+                tx.object(bridgeId),
+                tx.object(sourceProtocolId),
+                tx.object(targetProtocolId),
+                tx.pure.u64(memoryId),
+            ],
+        });
+        return this.exec(tx);
+    }
+    async subscribe(protocolId, watchTags, watchAsset, watchAction, watchNamespace) {
+        const tx = new Transaction();
+        tx.moveCall({
+            target: `${this.packageId}::kage::subscribe`,
+            arguments: [
+                tx.object(protocolId),
+                tx.pure.vector('vector<u8>', watchTags.map(enc)),
+                tx.pure.vector('u8', enc(watchAsset)),
+                tx.pure.vector('u8', enc(watchAction)),
+                tx.pure.vector('u8', enc(watchNamespace)),
+            ],
+        });
+        return this.exec(tx);
+    }
+    async recordOutcome(protocolId, memoryId, outcome) {
+        const tx = new Transaction();
+        tx.moveCall({
+            target: `${this.packageId}::kage::record_outcome`,
+            arguments: [
+                tx.object(protocolId),
+                tx.pure.u64(memoryId),
+                tx.pure.vector('u8', enc(outcome)),
+            ],
+        });
+        return this.exec(tx);
+    }
+    async getProtocolState(protocolId) {
+        const obj = await this.client.getObject({ id: protocolId, options: { showContent: true } });
+        const f = obj.data?.content?.fields ?? {};
+        return {
+            totalMemories: Number(f.total_memories ?? 0),
+            totalConflicts: Number(f.total_conflicts ?? 0),
+            totalSnapshots: Number(f.total_snapshots ?? 0),
+            totalSubscriptions: Number(f.total_subscriptions ?? 0),
+        };
+    }
+    async getBalance() {
+        const coins = await this.client.getCoins({ owner: this.address, coinType: '0x2::sui::SUI' });
+        const total = coins.data.reduce((s, c) => s + BigInt(c.balance), 0n);
+        return (Number(total) / 1e9).toFixed(4);
+    }
+    async exec(tx) {
+        const result = await this.client.signAndExecuteTransaction({
+            transaction: tx,
+            signer: this.keypair,
+            options: { showEffects: true, showEvents: true },
+        });
+        if (result.effects?.status?.status !== 'success') {
+            throw new Error(`Sui tx failed: ${result.effects?.status?.error ?? 'unknown'}`);
+        }
+        return result.digest;
+    }
+}
+function enc(s) {
+    return Array.from(Buffer.from(s, 'utf8'));
+}
+function hexToBytes(hex) {
+    return Array.from(Buffer.from(hex, 'hex'));
+}
+//# sourceMappingURL=sui.js.map

package/dist/sui.js.map

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

package/dist/types/index.d.ts

@@ -0,0 +1,166 @@
+export type Action = 'BUY' | 'SELL' | 'HOLD' | 'OBSERVE' | 'EXECUTE';
+export type Outcome = 'PENDING' | 'SUCCESS' | 'FAILURE' | 'UNKNOWN';
+export type RiskLevel = 'LOW' | 'MEDIUM' | 'HIGH';
+export interface MemoryEntry {
+    id: number;
+    agent: string;
+    blobId: string;
+    blobHash: string;
+    tags: string[];
+    asset: string;
+    action: Action;
+    outcome: Outcome;
+    confidence: number;
+    ttlEpochs: number;
+    writtenEpoch: number;
+    writtenMs: number;
+    conflictFlag: boolean;
+    conflictWith?: number;
+    weight: number;
+    namespace: string;
+    inheritedFrom?: number;
+    sharedFromGraph?: string;
+}
+export interface AgentRecord {
+    agent: string;
+    name: string;
+    namespace: string;
+    reputation: number;
+    totalWrites: number;
+    successfulOutcomes: number;
+    failedOutcomes: number;
+    registeredAtMs: number;
+    active: boolean;
+}
+export interface Snapshot {
+    snapshotId: number;
+    takenAtSequence: number;
+    takenAtMs: number;
+    takenBy: string;
+    description: string;
+    memoryCount: number;
+    namespace: string;
+    latestBlobId: string;
+}
+export interface Subscription {
+    id: number;
+    subscriber: string;
+    watchTags: string[];
+    watchAsset: string;
+    watchAction: string;
+    watchNamespace: string;
+    active: boolean;
+    triggerCount: number;
+}
+export interface CrossGraphBridge {
+    id: string;
+    protocolA: string;
+    protocolB: string;
+    sharedNamespace: string;
+    createdBy: string;
+    active: boolean;
+    totalShared: number;
+}
+export interface WalrusUploadResult {
+    blobId: string;
+    blobHash: string;
+    size: number;
+}
+export interface KageConfig {
+    suiRpcUrl: string;
+    privateKeyB64: string;
+    packageId: string;
+    protocolId: string;
+    walrusAggregatorUrl: string;
+    walrusPublisherUrl: string;
+    agentName: string;
+    namespace: string;
+    cycleDelayMs?: number;
+    maxCycles?: number;
+    defaultTtlEpochs?: number;
+}
+export interface WriteMemoryParams {
+    state: Record<string, unknown>;
+    tags: string[];
+    asset: string;
+    action: Action;
+    confidence: number;
+    ttlEpochs?: number;
+    namespace?: string;
+}
+export interface QueryParams {
+    asset?: string;
+    action?: string;
+    namespace?: string;
+    tags?: string[];
+    limit?: number;
+    minConfidence?: number;
+    excludeConflicted?: boolean;
+    excludeExpired?: boolean;
+}
+export interface QueryResult {
+    memoryIds: number[];
+    count: number;
+    latestBlobId?: string;
+}
+export interface WriteResult {
+    memoryId: number;
+    blobId: string;
+    blobHash: string;
+    txDigest: string;
+    conflictDetected: boolean;
+}
+export interface InheritResult {
+    childMemoryId: number;
+    parentMemoryId: number;
+    blobId: string;
+    txDigest: string;
+}
+export interface SnapshotResult {
+    snapshotId: number;
+    takenAtSequence: number;
+    txDigest: string;
+}
+export interface TrendPilotFreeSignal {
+    asset: string;
+    price: number;
+    confidence: number;
+    timestamp: string;
+}
+export interface TrendPilotFullSignal {
+    asset: string;
+    direction: 'UP' | 'DOWN' | 'HOLD';
+    confidence: number;
+    rsi: number;
+    vwap: number;
+    bollinger_upper: number;
+    bollinger_lower: number;
+    momentum: number;
+    order_book_pressure: number;
+    price: number;
+    timestamp: string;
+}
+export interface TrendPilotRisk {
+    asset: string;
+    risk_level: RiskLevel;
+    volatility: number;
+    trend: string;
+    momentum: number;
+}
+export interface AlphaLoopState extends Record<string, unknown> {
+    cycleId: string;
+    asset: string;
+    scoutSignal?: TrendPilotFullSignal;
+    scoutBlobId?: string;
+    riskAssessment?: TrendPilotRisk;
+    riskBlobId?: string;
+    decision?: Action;
+    decisionReason?: string;
+    decisionBlobId?: string;
+    executionNote?: string;
+    executionBlobId?: string;
+    startedAt: number;
+    completedAt?: number;
+    error?: string;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,MAAM,GAAK,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC;AACvE,MAAM,MAAM,OAAO,GAAI,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;AACrE,MAAM,MAAM,SAAS,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;AAElD,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,OAAO,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,QAAQ;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,OAAO,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;CACrB;AAID,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd;AAID,MAAM,WAAW,UAAU;IAEzB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IAEnB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,kBAAkB,EAAE,MAAM,CAAC;IAE3B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAElB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,aAAa;IAC5B,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAID,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,CAAC;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,SAAS,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAe,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC7D,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IAEd,WAAW,CAAC,EAAE,oBAAoB,CAAC;IACnC,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}

package/dist/types/index.js

@@ -0,0 +1,3 @@
+// ─── Memory Core ──────────────────────────────────────────────────────────────
+export {};
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

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

package/dist/walrus.d.ts

@@ -0,0 +1,11 @@
+import { WalrusUploadResult } from './types/index.js';
+export declare class WalrusClient {
+    private aggregatorUrl;
+    private publisherUrl;
+    constructor(aggregatorUrl: string, publisherUrl: string);
+    upload(state: Record<string, unknown>, epochs?: number): Promise<WalrusUploadResult>;
+    download(blobId: string): Promise<Record<string, unknown>>;
+    verify(blobId: string, expectedHash: string): Promise<boolean>;
+    waitForBlob(blobId: string, retries?: number, delayMs?: number): Promise<void>;
+}
+//# sourceMappingURL=walrus.d.ts.map

package/dist/walrus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"walrus.d.ts","sourceRoot":"","sources":["../src/walrus.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAEtD,qBAAa,YAAY;IAErB,OAAO,CAAC,aAAa;IACrB,OAAO,CAAC,YAAY;gBADZ,aAAa,EAAE,MAAM,EACrB,YAAY,EAAE,MAAM;IAMxB,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,SAAK,GAAG,OAAO,CAAC,kBAAkB,CAAC;IA6BhF,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAO1D,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAQ9D,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,SAAK,EAAE,OAAO,SAAO,GAAG,OAAO,CAAC,IAAI,CAAC;CAQ/E"}

package/dist/walrus.js

@@ -0,0 +1,62 @@
+import crypto from 'crypto';
+export class WalrusClient {
+    aggregatorUrl;
+    publisherUrl;
+    constructor(aggregatorUrl, publisherUrl) {
+        this.aggregatorUrl = aggregatorUrl;
+        this.publisherUrl = publisherUrl;
+        this.aggregatorUrl = aggregatorUrl.replace(/\/$/, '');
+        this.publisherUrl = publisherUrl.replace(/\/$/, '');
+    }
+    async upload(state, epochs = 10) {
+        const payload = JSON.stringify({
+            ...state,
+            _kage: { version: '0.1.0', ts: Date.now() },
+        });
+        const buf = Buffer.from(payload, 'utf8');
+        const blobHash = crypto.createHash('sha256').update(buf).digest('hex');
+        const res = await fetch(`${this.publisherUrl}/v1/blobs?epochs=${epochs}`, {
+            method: 'PUT',
+            headers: {
+                'Content-Type': 'application/octet-stream',
+                'Content-Length': String(buf.length),
+            },
+            body: buf,
+        });
+        if (!res.ok) {
+            const txt = await res.text();
+            throw new Error(`Walrus upload [${res.status}]: ${txt}`);
+        }
+        const data = await res.json();
+        const info = data.newlyCreated?.blobObject ?? data.alreadyCertified?.blobObject;
+        if (!info?.blobId)
+            throw new Error(`No blobId in response: ${JSON.stringify(data)}`);
+        return { blobId: info.blobId, blobHash, size: buf.length };
+    }
+    async download(blobId) {
+        const res = await fetch(`${this.aggregatorUrl}/v1/blobs/${blobId}`);
+        if (!res.ok)
+            throw new Error(`Walrus download [${res.status}] blob=${blobId}`);
+        const buf = await res.arrayBuffer();
+        return JSON.parse(Buffer.from(buf).toString('utf8'));
+    }
+    async verify(blobId, expectedHash) {
+        const res = await fetch(`${this.aggregatorUrl}/v1/blobs/${blobId}`);
+        if (!res.ok)
+            return false;
+        const buf = await res.arrayBuffer();
+        const hash = crypto.createHash('sha256').update(Buffer.from(buf)).digest('hex');
+        return hash === expectedHash;
+    }
+    async waitForBlob(blobId, retries = 12, delayMs = 2500) {
+        for (let i = 0; i < retries; i++) {
+            const res = await fetch(`${this.aggregatorUrl}/v1/blobs/${blobId}`, { method: 'HEAD' }).catch(() => null);
+            if (res?.ok)
+                return;
+            await sleep(delayMs);
+        }
+        throw new Error(`Blob ${blobId} not available after ${retries} retries`);
+    }
+}
+function sleep(ms) { return new Promise(r => setTimeout(r, ms)); }
+//# sourceMappingURL=walrus.js.map

package/dist/walrus.js.map

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

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@sykeclone/kage-sdk",
+  "version": "1.0.0",
+  "description": "Kage — Onchain Agent Memory Protocol for Sui + Walrus",
+  "type": "module",
+  "main": "dist/kage.js",
+  "types": "dist/kage.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/kage.js",
+      "types": "./dist/kage.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build",
+    "demo": "tsx src/demo/alphaloop.ts",
+    "clean": "rm -rf dist"
+  },
+  "keywords": [
+    "sui", "walrus", "agent", "memory", "kage", "onchain", "ai-agents", "web3"
+  ],
+  "author": "sykeclone",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/davieslennox0/kage"
+  },
+  "homepage": "https://kagegraph.duckdns.org",
+  "dependencies": {
+    "@mysten/sui": "^1.14.0",
+    "dotenv": "^16.6.1"
+  },
+  "devDependencies": {
+    "@types/node": "^20.12.7",
+    "tsx": "^4.11.0",
+    "typescript": "^5.4.5"
+  },
+  "engines": {
+    "node": ">=20"
+  }
+}