@renai-labs/sdk 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ren Labs, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,90 @@
+# @renai-labs/sdk
+
+TypeScript SDK for the Ren API.
+
+## Install
+
+```bash
+npm install @renai-labs/sdk
+```
+
+## Quick start
+
+```ts
+import { createRenClient, pat } from "@renai-labs/sdk"
+
+const client = createRenClient({
+  baseUrl: "https://api.ren.example",
+  auth: pat(process.env.REN_PAT_TOKEN!),
+})
+
+const { data: skills } = await client.skill.list()
+```
+
+Calls are grouped by resource — `client.skill`, `client.agent`, `client.pod`, `client.routines`, `client.session`, `client.mcp`, `client.vault`, `client.credential`, `client.fileStore`, `client.memoryStore`, `client.environment`, `client.replay`, `client.registry`, `client.pat`. Each exposes the operations available on that resource.
+
+Every method returns `{ data, error, request, response }`. `data` is typed to the success payload; `error` is the typed error body for non-2xx responses.
+
+## Authentication
+
+Pass an auth strategy to `createRenClient`:
+
+```ts
+import { createRenClient, pat } from "@renai-labs/sdk"
+
+// Personal Access Token (server-side, CLIs, CI)
+createRenClient({ baseUrl, auth: pat(token) })
+```
+
+Custom strategies implement `AuthStrategy`:
+
+```ts
+import type { AuthStrategy } from "@renai-labs/sdk"
+
+const apiKey: AuthStrategy = {
+  apply: ({ headers }) => headers.set("X-Api-Key", process.env.MY_KEY!),
+}
+
+createRenClient({ baseUrl, auth: apiKey })
+```
+
+## Types
+
+For apps that only need the shapes (form validators, type exports), use the `/types` subpath to avoid pulling in the client runtime:
+
+```ts
+import type { Skill, SkillCreateData } from "@renai-labs/sdk/types"
+```
+
+## Errors
+
+Non-2xx responses don't throw by default — check `error` or opt into throwing:
+
+```ts
+const { data, error } = await client.skill.get({ path: { id } })
+if (error) {
+  // error is typed to the operation's error schema
+}
+
+const { data } = await client.skill.get({
+  path: { id },
+  throwOnError: true,
+})
+```
+
+## Configuration
+
+`createRenClient` accepts any `@hey-api/client-fetch` `Config` option — `baseUrl`, `headers`, `fetch`, `credentials`, interceptors, etc.
+
+```ts
+createRenClient({
+  baseUrl: "https://api.ren.example",
+  auth: pat(token),
+  headers: { "X-Request-Id": crypto.randomUUID() },
+  fetch: customFetch,
+})
+```
+
+## License
+
+MIT

package/dist/auth.d.ts

@@ -0,0 +1,8 @@
+export interface AuthStrategy {
+    apply(req: {
+        headers: Headers;
+        url: URL;
+    }): void | Promise<void>;
+}
+export declare const pat: (token: string) => AuthStrategy;
+export declare const session: (cookie: string) => AuthStrategy;

package/dist/auth.js

@@ -0,0 +1,10 @@
+export const pat = (token) => ({
+    apply: ({ headers }) => {
+        headers.set("Authorization", `Bearer ${token}`);
+    },
+});
+export const session = (cookie) => ({
+    apply: ({ headers }) => {
+        headers.set("Cookie", cookie);
+    },
+});

package/dist/client.d.ts

@@ -0,0 +1,8 @@
+import type { Config } from "./generated/client";
+import { RenClient } from "./generated/sdk.gen";
+import type { AuthStrategy } from "./auth";
+export type RenClientConfig = Omit<Config, "auth"> & {
+    auth?: AuthStrategy;
+};
+export declare function createRenClient(config?: RenClientConfig): RenClient;
+export { RenClient };

package/dist/client.js

@@ -0,0 +1,14 @@
+import { createClient } from "./generated/client";
+import { RenClient } from "./generated/sdk.gen";
+export function createRenClient(config = {}) {
+    const { auth, ...rest } = config;
+    const client = createClient(rest);
+    if (auth) {
+        client.interceptors.request.use(async (req) => {
+            await auth.apply({ headers: req.headers, url: new URL(req.url) });
+            return req;
+        });
+    }
+    return new RenClient({ client });
+}
+export { RenClient };