@kloddy/kloddy-js 0.1.0

package/README.md

@@ -0,0 +1,156 @@
+# @kloddy/kloddy-js
+
+Kloddy is the ultimate platform for Prompt Engineering and LLM Analytics. This SDK allows you to fetch, compile, and execute prompts directly from your Node.js or React applications.
+
+## installation
+
+```bash
+# via npm
+npm install @kloddy/kloddy-js
+
+# via yarn
+yarn add @kloddy/kloddy-js
+```
+
+## Quick Start
+
+### Basic Usage (Node.js)
+
+```javascript
+import { Kloddy } from 'kloddy-js';
+
+const kloddy = new Kloddy({
+  apiKey: '<your_project_api_key>',
+  apiSecret: '<your_personal_api_key>',
+  host: 'https://api.kloddy.com' // Optional
+});
+
+// Fetch a prompt template
+const template = await kloddy.prompts.get('customer-support-agent', {
+  fallback: 'You are a helpful assistant.'
+});
+
+// Compile with variables
+const systemPrompt = kloddy.prompts.compile(template, {
+  userName: 'Alice',
+  company: 'Acme Corp'
+});
+
+console.log(systemPrompt);
+```
+
+### React Usage
+
+Wrap your app with `KloddyProvider`. For security, it is highly recommended to generate an **accessToken** on your server and pass it to the frontend instead of using your `apiSecret` in the browser.
+
+```tsx
+import { KloddyProvider, usePrompt } from '@kloddy/kloddy-js';
+
+function MyComponent() {
+  const { getPrompt, getAwnser } = usePrompt();
+
+  const handleWelcome = async () => {
+    const prompt = await getPrompt('welcome-message');
+    const response = await getAwnser('welcome-message', {
+      variables: { name: 'Alice' }
+    });
+    console.log(response.result);
+  };
+
+  return <button onClick={handleWelcome}>Say Hello</button>;
+}
+
+function App() {
+  // The token should be fetched from your own API
+  const [token, setToken] = useState('');
+
+  return (
+    <KloddyProvider apiKey="YOUR_PROJECT_ID" token={token}>
+      <MyComponent />
+    </KloddyProvider>
+  );
+}
+```
+
+## Advanced Usage
+
+### Organization & Feature Context
+You can set a default organization or feature ID during initialization to simplify your calls.
+
+```javascript
+const kloddy = new Kloddy({
+  apiKey: '...',
+  defaultOrgId: 'org_123',
+  defaultFeatureId: 'feat_456'
+});
+
+// These will now use the defaults automatically
+const prompts = await kloddy.prompts.list();
+const features = await kloddy.listFeatures();
+```
+
+### Account Information
+```javascript
+const user = await kloddy.whoAmI();
+const orgs = await kloddy.listOrganizations();
+const features = await kloddy.listFeatures(orgs[0].id);
+```
+
+### Prompts Management
+```javascript
+// List all prompts
+const allPrompts = await kloddy.prompts.list({ pageSize: 50 });
+
+// Update/Sync (alias for list)
+const synced = await kloddy.prompts.update();
+
+// Play (Direct Execution)
+const result = await kloddy.prompts.play('my-prompt', {
+  variables: { user: 'Alice' },
+  model: 'gpt-4'
+});
+```
+
+### Evaluations
+```javascript
+const evalResult = await kloddy.evaluations.evaluate({
+  name: 'model-comparison',
+  models: ['gpt-4', 'claude-3'],
+  judge: 'gpt-4-judge',
+  variables: { input: '...' },
+  temperature: 0.7
+});
+```
+
+## API Reference
+
+### `Kloddy` Client
+- `whoAmI()`: Get current user details.
+- `listOrganizations()`: List organizations.
+- `listFeatures(orgId?)`: List features.
+- `prompts.list(filters)`: List prompts with pagination and filters.
+- `prompts.get(name, options)`: Fetch a template.
+- `prompts.play(name, options)`: Execute a prompt directly.
+- `prompts.update()`: Sync all prompts.
+- `evaluations.evaluate(options)`: Run model evaluations.
+
+### React Hooks
+- `usePrompt()`: Returns `getPrompt`, `getAwnser`, `getEvaluation`, `compile`.
+
+## Integration with Vercel AI Gateway
+
+You can use Kloddy to manage your prompts and Vercel AI Gateway to route your LLM calls.
+
+```javascript
+const template = await kloddy.prompts.get('support-agent');
+const systemPrompt = kloddy.prompts.compile(template, { user: 'Alice' });
+
+// Use with OpenAI via Vercel AI Gateway
+const openai = new OpenAI({
+  baseURL: 'https://gateway.ai.cloudflare.com/v1/YOUR_ACCOUNT_ID/YOUR_GATEWAY_ID/openai'
+});
+```
+
+## License
+
+MIT © [Kloddy](https://kloddy.com)

package/dist/client.d.ts

@@ -0,0 +1,27 @@
+import { KloddyOptions, User, Organization, Feature } from './types';
+export declare class KloddyClient {
+    private apiKey;
+    private apiSecret;
+    private host;
+    defaultOrgId: string | null;
+    defaultFeatureId: string | null;
+    private token;
+    private tokenExpires;
+    constructor(apiKeyOrOptions: string | KloddyOptions, options?: KloddyOptions);
+    login(): Promise<string>;
+    getToken(): Promise<string>;
+    request<T>(path: string, options?: RequestInit): Promise<T>;
+    /**
+     * Get current user information.
+     */
+    whoAmI(): Promise<User>;
+    /**
+     * List organizations for the current user.
+     */
+    listOrganizations(): Promise<Organization[]>;
+    /**
+     * List features, optionally filtered by organization.
+     */
+    listFeatures(orgId?: string): Promise<Feature[]>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAgB,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAEnF,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,IAAI,CAAS;IACd,YAAY,EAAE,MAAM,GAAG,IAAI,CAAQ;IACnC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAQ;IAC9C,OAAO,CAAC,KAAK,CAAuB;IACpC,OAAO,CAAC,YAAY,CAAuB;gBAE/B,eAAe,EAAE,MAAM,GAAG,aAAa,EAAE,OAAO,CAAC,EAAE,aAAa;IAsBtE,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC;IA2BxB,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC;IAY3B,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,CAAC,CAAC;IAqBrE;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAI7B;;OAEG;IACG,iBAAiB,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IAIlD;;OAEG;IACG,YAAY,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;CAIvD"}

package/dist/client.js

@@ -0,0 +1,107 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KloddyClient = void 0;
+const cross_fetch_1 = __importDefault(require("cross-fetch"));
+class KloddyClient {
+    apiKey;
+    apiSecret;
+    host;
+    defaultOrgId = null;
+    defaultFeatureId = null;
+    token = null;
+    tokenExpires = null;
+    constructor(apiKeyOrOptions, options) {
+        if (typeof apiKeyOrOptions === 'string') {
+            this.apiKey = apiKeyOrOptions;
+            this.apiSecret = options?.apiSecret || options?.personalApiKey || options?.secretKey || '';
+            this.token = options?.token || null;
+            this.host = options?.host || 'https://api.kloddy.com';
+            this.defaultOrgId = options?.defaultOrgId || null;
+            this.defaultFeatureId = options?.defaultFeatureId || null;
+        }
+        else {
+            this.apiKey = apiKeyOrOptions.apiKey || apiKeyOrOptions.projectApiKey || apiKeyOrOptions.applicationId || '';
+            this.apiSecret = apiKeyOrOptions.apiSecret || apiKeyOrOptions.personalApiKey || apiKeyOrOptions.secretKey || '';
+            this.token = apiKeyOrOptions.token || null;
+            this.host = apiKeyOrOptions.host || 'https://api.kloddy.com';
+            this.defaultOrgId = apiKeyOrOptions.defaultOrgId || null;
+            this.defaultFeatureId = apiKeyOrOptions.defaultFeatureId || null;
+        }
+        if (!this.token && (!this.apiKey || !this.apiSecret)) {
+            console.warn('KloddyClient: token or credentials missing. API calls will fail.');
+        }
+    }
+    async login() {
+        if (!this.apiKey || !this.apiSecret) {
+            throw new Error('KloddyClient: Cannot login without apiKey and apiSecret.');
+        }
+        const response = await (0, cross_fetch_1.default)(`${this.host}/api/login`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({
+                applicationId: this.apiKey,
+                secretKey: this.apiSecret,
+            }),
+        });
+        if (!response.ok) {
+            const error = await response.text();
+            throw new Error(`Kloddy Auth failed: ${response.status} ${error}`);
+        }
+        const data = (await response.json());
+        this.token = data.token;
+        // Set expiry to 1 hour from now as a fallback if not provided
+        this.tokenExpires = Date.now() + (data.expiresAt ? new Date(data.expiresAt).getTime() - Date.now() : 3600000);
+        return this.token;
+    }
+    async getToken() {
+        // If we have a static token (passed in constructor) and no secretKey, don't try to refresh
+        if (this.token && !this.apiSecret) {
+            return this.token;
+        }
+        if (!this.token || (this.tokenExpires && Date.now() >= this.tokenExpires - 60000)) {
+            return this.login();
+        }
+        return this.token;
+    }
+    async request(path, options = {}) {
+        const token = await this.getToken();
+        const url = path.startsWith('http') ? path : `${this.host}${path}`;
+        const response = await (0, cross_fetch_1.default)(url, {
+            ...options,
+            headers: {
+                ...options.headers,
+                Authorization: `Bearer ${token}`,
+                'Content-Type': 'application/json',
+            },
+        });
+        if (!response.ok) {
+            const error = await response.text();
+            throw new Error(`Kloddy API error: ${response.status} ${error}`);
+        }
+        return (await response.json());
+    }
+    /**
+     * Get current user information.
+     */
+    async whoAmI() {
+        return this.request('/api/whoiam');
+    }
+    /**
+     * List organizations for the current user.
+     */
+    async listOrganizations() {
+        return this.request('/api/organizations');
+    }
+    /**
+     * List features, optionally filtered by organization.
+     */
+    async listFeatures(orgId) {
+        const path = orgId ? `/api/features?org_id=${orgId}` : '/api/features';
+        return this.request(path);
+    }
+}
+exports.KloddyClient = KloddyClient;
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/evaluations.d.ts

@@ -0,0 +1,21 @@
+import { KloddyClient } from './client';
+import { EvaluationOptions, EvaluationResult, KloddyOptions } from './types';
+export declare class Evaluations {
+    private client;
+    constructor(options: {
+        posthog?: KloddyClient;
+    } | KloddyOptions);
+    /**
+     * Run or retrieve an evaluation.
+     */
+    run(options: EvaluationOptions): Promise<EvaluationResult>;
+    /**
+     * Alias for run() as requested.
+     */
+    evaluate(options: EvaluationOptions): Promise<EvaluationResult>;
+    /**
+     * Legacy alias for run(name) as requested in the hook example.
+     */
+    get(name: string, variables?: Record<string, any>): Promise<EvaluationResult>;
+}
+//# sourceMappingURL=evaluations.d.ts.map

package/dist/evaluations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluations.d.ts","sourceRoot":"","sources":["../src/evaluations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7E,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAe;gBAEjB,OAAO,EAAE;QAAE,OAAO,CAAC,EAAE,YAAY,CAAA;KAAE,GAAG,aAAa;IAQ/D;;OAEG;IACG,GAAG,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAOhE;;OAEG;IACG,QAAQ,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAIrE;;OAEG;IACG,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAGxF"}

package/dist/evaluations.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Evaluations = void 0;
+const client_1 = require("./client");
+class Evaluations {
+    client;
+    constructor(options) {
+        if ('posthog' in options && options.posthog) {
+            this.client = options.posthog;
+        }
+        else {
+            this.client = new client_1.KloddyClient(options);
+        }
+    }
+    /**
+     * Run or retrieve an evaluation.
+     */
+    async run(options) {
+        return this.client.request('/api/evaluate', {
+            method: 'POST',
+            body: JSON.stringify(options),
+        });
+    }
+    /**
+     * Alias for run() as requested.
+     */
+    async evaluate(options) {
+        return this.run(options);
+    }
+    /**
+     * Legacy alias for run(name) as requested in the hook example.
+     */
+    async get(name, variables = {}) {
+        return this.run({ name, variables });
+    }
+}
+exports.Evaluations = Evaluations;
+//# sourceMappingURL=evaluations.js.map

package/dist/evaluations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluations.js","sourceRoot":"","sources":["../src/evaluations.ts"],"names":[],"mappings":";;;AAAA,qCAAwC;AAGxC,MAAa,WAAW;IACd,MAAM,CAAe;IAE7B,YAAY,OAAmD;QAC7D,IAAI,SAAS,IAAI,OAAO,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;YAC5C,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,OAAuB,CAAC;QAChD,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,MAAM,GAAG,IAAI,qBAAY,CAAC,OAAwB,CAAC,CAAC;QAC3D,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,GAAG,CAAC,OAA0B;QAClC,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAmB,eAAe,EAAE;YAC5D,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;SAC9B,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,QAAQ,CAAC,OAA0B;QACvC,OAAO,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,GAAG,CAAC,IAAY,EAAE,YAAiC,EAAE;QACzD,OAAO,IAAI,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;IACvC,CAAC;CACF;AAlCD,kCAkCC"}

package/dist/hooks/use-prompt.d.ts

@@ -0,0 +1,18 @@
+import React from 'react';
+import { KloddyClient } from '../client';
+import { KloddyOptions } from '../types';
+export interface KloddyProviderProps {
+    children: React.ReactNode;
+    client?: KloddyClient;
+    options?: KloddyOptions;
+    apiKey?: string;
+    token?: string;
+}
+export declare const KloddyProvider: React.FC<KloddyProviderProps>;
+export declare const usePrompt: () => {
+    getPrompt: (id: string, options?: {}) => Promise<import("../types").PromptTemplate>;
+    getAwnser: (id: string, options?: {}) => Promise<import("../types").ExecuteResult>;
+    getEvaluation: (id: string, variables?: {}) => Promise<import("../types").EvaluationResult>;
+    compile: (template: any, variables: any) => string;
+};
+//# sourceMappingURL=use-prompt.d.ts.map

package/dist/hooks/use-prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-prompt.d.ts","sourceRoot":"","sources":["../../src/hooks/use-prompt.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA6C,MAAM,OAAO,CAAC;AAGlE,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AASzC,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,eAAO,MAAM,cAAc,EAAE,KAAK,CAAC,EAAE,CAAC,mBAAmB,CAUxD,CAAC;AAEF,eAAO,MAAM,SAAS;oBASF,MAAM;oBACN,MAAM;wBACF,MAAM;wBACN,GAAG,aAAa,GAAG;CAE1C,CAAC"}

package/dist/hooks/use-prompt.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.usePrompt = exports.KloddyProvider = void 0;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const react_1 = require("react");
+const prompts_1 = require("../prompts");
+const evaluations_1 = require("../evaluations");
+const client_1 = require("../client");
+const KloddyContext = (0, react_1.createContext)(null);
+const KloddyProvider = ({ children, client, options, apiKey, token }) => {
+    const value = (0, react_1.useMemo)(() => {
+        const activeClient = client || new client_1.KloddyClient({ ...options, apiKey, token });
+        return {
+            prompts: new prompts_1.Prompts({ posthog: activeClient }),
+            evaluations: new evaluations_1.Evaluations({ posthog: activeClient }),
+        };
+    }, [client, options, token]);
+    return (0, jsx_runtime_1.jsx)(KloddyContext.Provider, { value: value, children: children });
+};
+exports.KloddyProvider = KloddyProvider;
+const usePrompt = () => {
+    const context = (0, react_1.useContext)(KloddyContext);
+    if (!context) {
+        throw new Error('usePrompt must be used within a KloddyProvider');
+    }
+    const { prompts, evaluations } = context;
+    return {
+        getPrompt: (id, options = {}) => prompts.get(id, options),
+        getAwnser: (id, options = {}) => prompts.execute(id, options), // Use user's spelling "getAwnser"
+        getEvaluation: (id, variables = {}) => evaluations.get(id, variables),
+        compile: (template, variables) => prompts.compile(template, variables),
+    };
+};
+exports.usePrompt = usePrompt;
+//# sourceMappingURL=use-prompt.js.map

package/dist/hooks/use-prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-prompt.js","sourceRoot":"","sources":["../../src/hooks/use-prompt.tsx"],"names":[],"mappings":";;;;AAAA,iCAAkE;AAClE,wCAAqC;AACrC,gDAA6C;AAC7C,sCAAyC;AAQzC,MAAM,aAAa,GAAG,IAAA,qBAAa,EAA2B,IAAI,CAAC,CAAC;AAU7D,MAAM,cAAc,GAAkC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE;IAC5G,MAAM,KAAK,GAAG,IAAA,eAAO,EAAC,GAAG,EAAE;QACzB,MAAM,YAAY,GAAG,MAAM,IAAI,IAAI,qBAAY,CAAC,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;QAC/E,OAAO;YACL,OAAO,EAAE,IAAI,iBAAO,CAAC,EAAE,OAAO,EAAE,YAAY,EAAE,CAAC;YAC/C,WAAW,EAAE,IAAI,yBAAW,CAAC,EAAE,OAAO,EAAE,YAAY,EAAE,CAAC;SACxD,CAAC;IACJ,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;IAE7B,OAAO,uBAAC,aAAa,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,YAAG,QAAQ,GAA0B,CAAC;AACnF,CAAC,CAAC;AAVW,QAAA,cAAc,kBAUzB;AAEK,MAAM,SAAS,GAAG,GAAG,EAAE;IAC5B,MAAM,OAAO,GAAG,IAAA,kBAAU,EAAC,aAAa,CAAC,CAAC;IAC1C,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;IACpE,CAAC;IAED,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC;IAEzC,OAAO;QACL,SAAS,EAAE,CAAC,EAAU,EAAE,OAAO,GAAG,EAAE,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,OAAO,CAAC;QACjE,SAAS,EAAE,CAAC,EAAU,EAAE,OAAO,GAAG,EAAE,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,EAAE,kCAAkC;QACzG,aAAa,EAAE,CAAC,EAAU,EAAE,SAAS,GAAG,EAAE,EAAE,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,EAAE,SAAS,CAAC;QAC7E,OAAO,EAAE,CAAC,QAAa,EAAE,SAAc,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,EAAE,SAAS,CAAC;KACjF,CAAC;AACJ,CAAC,CAAC;AAdW,QAAA,SAAS,aAcpB"}

package/dist/index.d.mts

@@ -0,0 +1,195 @@
+import React from 'react';
+
+interface KloddyOptions {
+    apiKey?: string;
+    apiSecret?: string;
+    token?: string;
+    personalApiKey?: string;
+    projectApiKey?: string;
+    applicationId?: string;
+    secretKey?: string;
+    host?: string;
+    cacheTtlSeconds?: number;
+    defaultOrgId?: string;
+    defaultFeatureId?: string;
+}
+interface User {
+    id: string;
+    email: string;
+    name: string;
+    [key: string]: any;
+}
+interface Organization {
+    id: string;
+    name: string;
+    [key: string]: any;
+}
+interface Feature {
+    id: string;
+    name: string;
+    org_id: string;
+    [key: string]: any;
+}
+interface PromptListOptions {
+    page?: number;
+    pageSize?: number;
+    name?: string;
+    org_id?: string;
+    feature_id?: string;
+}
+interface PromptOptions {
+    version?: number | string;
+    fallback?: string;
+    cacheTtlSeconds?: number;
+    resolve?: boolean;
+}
+interface PromptTemplate {
+    id: string;
+    name: string;
+    content: string;
+    version: number;
+    variables?: string[];
+    [key: string]: any;
+}
+interface ExecuteOptions {
+    variables?: Record<string, any>;
+    model?: string;
+    version?: string | number;
+    resolve?: boolean;
+}
+interface ExecuteResult {
+    result: string;
+    model: string;
+    version: string | number;
+    usage?: {
+        prompt_tokens: number;
+        completion_tokens: number;
+        total_tokens: number;
+    };
+}
+interface EvaluationOptions {
+    name: string;
+    models?: string[];
+    judge?: string;
+    version?: (string | number)[];
+    variables?: Record<string, any>;
+    evaluate_id?: string;
+    temperature?: number;
+}
+interface EvaluationResult {
+    result: string;
+    winner?: string;
+    answers: {
+        model: string;
+        answer: string;
+        score?: number;
+    }[];
+}
+interface AuthResponse {
+    token: string;
+    expiresAt?: string;
+}
+
+declare class KloddyClient {
+    private apiKey;
+    private apiSecret;
+    private host;
+    defaultOrgId: string | null;
+    defaultFeatureId: string | null;
+    private token;
+    private tokenExpires;
+    constructor(apiKeyOrOptions: string | KloddyOptions, options?: KloddyOptions);
+    login(): Promise<string>;
+    getToken(): Promise<string>;
+    request<T>(path: string, options?: RequestInit): Promise<T>;
+    /**
+     * Get current user information.
+     */
+    whoAmI(): Promise<User>;
+    /**
+     * List organizations for the current user.
+     */
+    listOrganizations(): Promise<Organization[]>;
+    /**
+     * List features, optionally filtered by organization.
+     */
+    listFeatures(orgId?: string): Promise<Feature[]>;
+}
+
+declare class Prompts {
+    private client;
+    constructor(options: {
+        posthog?: KloddyClient;
+    } | KloddyOptions);
+    /**
+     * List prompts with filters.
+     */
+    list(options?: PromptListOptions): Promise<PromptTemplate[]>;
+    /**
+     * Fetch a prompt template.
+     */
+    get(name: string, options?: PromptOptions): Promise<PromptTemplate>;
+    /**
+     * Execute a prompt via the Kloddy API.
+     */
+    execute(name: string, options?: ExecuteOptions): Promise<ExecuteResult>;
+    /**
+     * Play: Direct execution for a single model/version.
+     * Same as execute but follows specific naming/body requirements.
+     */
+    play(name: string, options?: Omit<ExecuteOptions, 'judge' | 'evaluate_id'>): Promise<ExecuteResult>;
+    /**
+     * Update: Download all prompts for the user/organization.
+     */
+    update(options?: PromptListOptions): Promise<PromptTemplate[]>;
+    /**
+     * Local compilation of a template string with variables.
+     */
+    compile(template: string | PromptTemplate, variables: Record<string, any>): string;
+}
+
+declare class Evaluations {
+    private client;
+    constructor(options: {
+        posthog?: KloddyClient;
+    } | KloddyOptions);
+    /**
+     * Run or retrieve an evaluation.
+     */
+    run(options: EvaluationOptions): Promise<EvaluationResult>;
+    /**
+     * Alias for run() as requested.
+     */
+    evaluate(options: EvaluationOptions): Promise<EvaluationResult>;
+    /**
+     * Legacy alias for run(name) as requested in the hook example.
+     */
+    get(name: string, variables?: Record<string, any>): Promise<EvaluationResult>;
+}
+
+interface KloddyProviderProps {
+    children: React.ReactNode;
+    client?: KloddyClient;
+    options?: KloddyOptions;
+    apiKey?: string;
+    token?: string;
+}
+declare const KloddyProvider: React.FC<KloddyProviderProps>;
+declare const usePrompt: () => {
+    getPrompt: (id: string, options?: {}) => Promise<PromptTemplate>;
+    getAwnser: (id: string, options?: {}) => Promise<ExecuteResult>;
+    getEvaluation: (id: string, variables?: {}) => Promise<EvaluationResult>;
+    compile: (template: any, variables: any) => string;
+};
+
+declare class Kloddy {
+    client: KloddyClient;
+    prompts: Prompts;
+    evaluations: Evaluations;
+    constructor(apiKeyOrOptions: string | KloddyOptions, options?: KloddyOptions);
+    whoAmI(): Promise<User>;
+    listOrganizations(): Promise<Organization[]>;
+    listFeatures(orgId?: string): Promise<Feature[]>;
+}
+
+export { type AuthResponse, type EvaluationOptions, type EvaluationResult, Evaluations, type ExecuteOptions, type ExecuteResult, type Feature, Kloddy, KloddyClient, type KloddyOptions, KloddyProvider, type KloddyProviderProps, type Organization, type PromptListOptions, type PromptOptions, type PromptTemplate, Prompts, type User, Kloddy as default, usePrompt };