@molroo-io/sdk 0.5.2

package/dist/esm/world/world.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"world.d.ts","sourceRoot":"","sources":["../../../src/world/world.ts"],"names":[],"mappings":"AACA,OAAO,EAA6B,KAAK,SAAS,EAAE,MAAM,UAAU,CAAC;AACrE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,KAAK,EACV,WAAW,EACX,oBAAoB,EACpB,iBAAiB,EAClB,MAAM,SAAS,CAAC;AAiCjB,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAQD;;;;;;;;;;;GAWG;AACH,qBAAa,KAAK;IAChB,iDAAiD;IACjD,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC;gBAEhB,OAAO,EAAE,YAAY;IAOjC;;OAEG;IACG,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC;IAwBpE;;OAEG;IACG,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAmB9C;;;OAGG;IACG,YAAY,CAChB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC;QAAE,QAAQ,EAAE,WAAW,EAAE,CAAC;QAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;CA6BnE"}

package/dist/esm/world/world.js

@@ -0,0 +1,87 @@
+// INFO: @F001 Top-level domain class — see plan step 4
+import { createWorldClient, unwrap } from './client';
+import { Village } from './village';
+// ---------------------------------------------------------------------------
+// Internal helper
+// ---------------------------------------------------------------------------
+/** Map raw snake_case API village object to camelCase VillageData. */
+function toVillageData(raw) {
+    return {
+        id: raw.id,
+        tenantId: raw.tenant_id,
+        name: raw.name,
+        description: raw.description,
+        accessPolicy: raw.access_policy,
+        responseRule: raw.response_rule,
+        createdAt: raw.created_at,
+        updatedAt: raw.updated_at,
+    };
+}
+const DEFAULT_BASE_URL = 'https://api.molroo.io';
+// ---------------------------------------------------------------------------
+// World class
+// ---------------------------------------------------------------------------
+/**
+ * Entry point for the World SDK.
+ *
+ * @example
+ * ```typescript
+ * import { World } from '@molroo-io/sdk';
+ *
+ * const world = new World({ apiKey: 'mk_live_...' });
+ * const village = await world.createVillage({ name: 'My Village' });
+ * const result = await village.interact({ target: 'sera', action: 'greet' });
+ * ```
+ */
+export class World {
+    constructor(options) {
+        this._client = createWorldClient({
+            baseUrl: options.baseUrl ?? DEFAULT_BASE_URL,
+            apiKey: options.apiKey,
+        });
+    }
+    /**
+     * Create a new village and return a {@link Village} instance.
+     */
+    async createVillage(options) {
+        const { data } = await this._client.POST('/villages', {
+            body: {
+                name: options.name,
+                description: options.description,
+                access_policy: options.accessPolicy,
+                response_rule: options.responseRule,
+            },
+        });
+        const raw = unwrap(data);
+        return new Village(this._client, toVillageData(raw));
+    }
+    /**
+     * Fetch an existing village by ID and return a {@link Village} instance.
+     */
+    async getVillage(id) {
+        const { data } = await this._client.GET('/villages/{id}', {
+            params: { path: { id } },
+        });
+        const raw = unwrap(data);
+        return new Village(this._client, toVillageData(raw));
+    }
+    /**
+     * List villages. Returns raw data objects (not Village instances) for
+     * efficiency when only metadata is needed.
+     */
+    async listVillages(options) {
+        const { data } = await this._client.GET('/villages', {
+            params: {
+                query: {
+                    limit: options?.limit?.toString(),
+                    cursor: options?.cursor,
+                },
+            },
+        });
+        const raw = unwrap(data);
+        return {
+            villages: (raw.villages ?? []).map(toVillageData),
+            nextCursor: raw.nextCursor ?? null,
+        };
+    }
+}

package/package.json

@@ -0,0 +1,207 @@
+{
+  "name": "@molroo-io/sdk",
+  "version": "0.5.2",
+  "description": "Unified SDK for molroo emotion engine — persona, world, memory adapters, LLM integration",
+  "main": "./dist/cjs/index.js",
+  "module": "./dist/esm/index.js",
+  "types": "./dist/cjs/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/esm/index.d.ts",
+        "default": "./dist/esm/index.js"
+      },
+      "require": {
+        "types": "./dist/cjs/index.d.ts",
+        "default": "./dist/cjs/index.js"
+      }
+    },
+    "./world": {
+      "import": {
+        "types": "./dist/esm/world/index.d.ts",
+        "default": "./dist/esm/world/index.js"
+      },
+      "require": {
+        "types": "./dist/cjs/world/index.d.ts",
+        "default": "./dist/cjs/world/index.js"
+      }
+    },
+    "./memory/sqlite": {
+      "import": {
+        "types": "./dist/esm/memory/sqlite/index.d.ts",
+        "default": "./dist/esm/memory/sqlite/index.js"
+      },
+      "require": {
+        "types": "./dist/cjs/memory/sqlite/index.d.ts",
+        "default": "./dist/cjs/memory/sqlite/index.js"
+      }
+    },
+    "./memory/supabase": {
+      "import": {
+        "types": "./dist/esm/memory/supabase/index.d.ts",
+        "default": "./dist/esm/memory/supabase/index.js"
+      },
+      "require": {
+        "types": "./dist/cjs/memory/supabase/index.d.ts",
+        "default": "./dist/cjs/memory/supabase/index.js"
+      }
+    },
+    "./memory/pinecone": {
+      "import": {
+        "types": "./dist/esm/memory/pinecone/index.d.ts",
+        "default": "./dist/esm/memory/pinecone/index.js"
+      },
+      "require": {
+        "types": "./dist/cjs/memory/pinecone/index.d.ts",
+        "default": "./dist/cjs/memory/pinecone/index.js"
+      }
+    },
+    "./memory/cloudflare": {
+      "import": {
+        "types": "./dist/esm/memory/cloudflare/index.d.ts",
+        "default": "./dist/esm/memory/cloudflare/index.js"
+      },
+      "require": {
+        "types": "./dist/cjs/memory/cloudflare/index.d.ts",
+        "default": "./dist/cjs/memory/cloudflare/index.js"
+      }
+    },
+    "./embedding": {
+      "import": {
+        "types": "./dist/esm/embedding/index.d.ts",
+        "default": "./dist/esm/embedding/index.js"
+      },
+      "require": {
+        "types": "./dist/cjs/embedding/index.d.ts",
+        "default": "./dist/cjs/embedding/index.js"
+      }
+    }
+  },
+  "typesVersions": {
+    "*": {
+      "world": [
+        "./dist/cjs/world/index.d.ts"
+      ],
+      "memory/sqlite": [
+        "./dist/cjs/memory/sqlite/index.d.ts"
+      ],
+      "memory/supabase": [
+        "./dist/cjs/memory/supabase/index.d.ts"
+      ],
+      "memory/pinecone": [
+        "./dist/cjs/memory/pinecone/index.d.ts"
+      ],
+      "memory/cloudflare": [
+        "./dist/cjs/memory/cloudflare/index.d.ts"
+      ],
+      "embedding": [
+        "./dist/cjs/embedding/index.d.ts"
+      ]
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "rm -rf dist && tsc -p tsconfig.build.json && tsc -p tsconfig.esm.json",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "lint": "eslint src/",
+    "lint:fix": "eslint src/ --fix",
+    "format": "prettier --write 'src/**/*.ts'",
+    "format:check": "prettier --check 'src/**/*.ts'",
+    "clean": "rm -rf dist",
+    "docs": "typedoc",
+    "gen:types": "node ../../molroo-io/api/persona/scripts/dump-spec.mjs && openapi-typescript ../../molroo-io/api/persona/dist/openapi.json -o src/generated/api.d.ts"
+  },
+  "keywords": [
+    "emotion",
+    "persona",
+    "psychology",
+    "llm",
+    "sdk",
+    "ai",
+    "character",
+    "npc",
+    "world",
+    "village"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/molroo-io/sdk.git"
+  },
+  "homepage": "https://docs.molroo.io/sdk",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
+  "license": "MIT",
+  "dependencies": {
+    "jsonrepair": "^3.13.2",
+    "openapi-fetch": "^0.16.0",
+    "zod": "^4.3.6"
+  },
+  "peerDependencies": {
+    "@ai-sdk/anthropic": "^3.0.38",
+    "@ai-sdk/google-vertex": "^4.0.0",
+    "@ai-sdk/openai": "^3.0.25",
+    "@huggingface/transformers": "^3.0.0",
+    "@pinecone-database/pinecone": "^4.0.0",
+    "@supabase/supabase-js": "^2.0.0",
+    "ai": "^6.0.70",
+    "better-sqlite3": "^11.0.0",
+    "sqlite-vec": "^0.1.0"
+  },
+  "peerDependenciesMeta": {
+    "ai": {
+      "optional": true
+    },
+    "@ai-sdk/openai": {
+      "optional": true
+    },
+    "@ai-sdk/anthropic": {
+      "optional": true
+    },
+    "@ai-sdk/google-vertex": {
+      "optional": true
+    },
+    "better-sqlite3": {
+      "optional": true
+    },
+    "sqlite-vec": {
+      "optional": true
+    },
+    "@supabase/supabase-js": {
+      "optional": true
+    },
+    "@pinecone-database/pinecone": {
+      "optional": true
+    },
+    "@huggingface/transformers": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@ai-sdk/anthropic": "^3.0.50",
+    "@ai-sdk/google-vertex": "^4.0.68",
+    "@ai-sdk/openai": "^3.0.37",
+    "@eslint/js": "^9.39.3",
+    "@huggingface/transformers": "^3.8.1",
+    "@pinecone-database/pinecone": "^4.1.0",
+    "@supabase/supabase-js": "^2.98.0",
+    "@types/better-sqlite3": "^7.6.0",
+    "@types/node": "^20.0.0",
+    "@vitest/coverage-v8": "^4.0.18",
+    "ai": "^6.0.105",
+    "better-sqlite3": "^11.10.0",
+    "eslint": "^9.39.3",
+    "eslint-config-prettier": "^10.1.8",
+    "openapi-typescript": "^7.13.0",
+    "prettier": "^3.2.0",
+    "typedoc": "^0.28.17",
+    "typescript": "^5.3.3",
+    "typescript-eslint": "^8.56.0",
+    "vitest": "^4.0.18"
+  }
+}