@almadar/llm 1.0.0

package/dist/structured-output.d.ts

@@ -0,0 +1,113 @@
+import { a as RateLimiterOptions, b as TokenUsage } from './rate-limiter-9XAWfHwe.js';
+import { z } from 'zod';
+
+/**
+ * JSON Schema type used for OpenAI structured outputs.
+ */
+interface JsonSchema {
+    type?: string | string[];
+    properties?: Record<string, JsonSchema>;
+    required?: string[];
+    items?: JsonSchema;
+    enum?: unknown[];
+    const?: unknown;
+    anyOf?: JsonSchema[];
+    oneOf?: JsonSchema[];
+    allOf?: JsonSchema[];
+    $ref?: string;
+    $defs?: Record<string, JsonSchema>;
+    definitions?: Record<string, JsonSchema>;
+    additionalProperties?: boolean | JsonSchema;
+    description?: string;
+    default?: unknown;
+    minItems?: number;
+    maxItems?: number;
+    minLength?: number;
+}
+interface StructuredOutputOptions {
+    model?: string;
+    temperature?: number;
+    maxTokens?: number;
+    rateLimiter?: RateLimiterOptions;
+    useGlobalRateLimiter?: boolean;
+    trackTokens?: boolean;
+}
+interface StructuredGenerationOptions {
+    /** User's natural language request */
+    userRequest: string;
+    /** Model to use (overrides client default) */
+    model?: string;
+    /** Temperature (overrides client default) */
+    temperature?: number;
+    /** Maximum tokens (overrides client default) */
+    maxTokens?: number;
+    /** JSON Schema for structured output */
+    jsonSchema?: JsonSchema;
+    /** Schema name for the json_schema response format */
+    schemaName?: string;
+    /** System prompt override */
+    systemPrompt?: string;
+    /** System prompt builder function (called dynamically) */
+    buildSystemPrompt?: () => string;
+    /** Additional system prompt instructions */
+    additionalInstructions?: string;
+    /** Existing context for updates (e.g., existing schema JSON) */
+    existingContext?: string;
+    /** Skip post-generation validation (default: false) */
+    skipValidation?: boolean;
+}
+interface StructuredGenerationResult<T = unknown> {
+    /** Generated data (guaranteed to match JSON Schema structure) */
+    data: T;
+    /** Raw JSON string from API */
+    raw: string;
+    /** Token usage statistics */
+    usage: {
+        promptTokens: number;
+        completionTokens: number;
+        totalTokens: number;
+    };
+    /** Generation latency in milliseconds */
+    latencyMs: number;
+    /** Model used for generation */
+    model: string;
+    /** Zod validation result (if not skipped) */
+    zodValidation?: {
+        success: boolean;
+        errors?: z.ZodError['errors'];
+    };
+}
+declare const STRUCTURED_OUTPUT_MODELS: {
+    readonly GPT5_MINI: "gpt-5-mini";
+    readonly GPT4O_MINI: "gpt-4o-mini";
+    readonly GPT4O: "gpt-4o";
+    readonly GPT4O_2024_08_06: "gpt-4o-2024-08-06";
+};
+declare class StructuredOutputClient {
+    private openai;
+    private rateLimiter;
+    private tokenTracker;
+    private defaultModel;
+    private defaultTemperature;
+    private defaultMaxTokens;
+    constructor(options?: StructuredOutputOptions);
+    private usesMaxCompletionTokens;
+    /**
+     * Generate structured output with guaranteed JSON Schema compliance.
+     */
+    generate<T = unknown>(options: StructuredGenerationOptions): Promise<StructuredGenerationResult<T>>;
+    getModel(): string;
+    getRateLimiterStatus(): {
+        queueLength: number;
+        activeRequests: number;
+        minuteTokens: number;
+        secondTokens: number;
+        backoffMs: number;
+    };
+    getTokenUsage(): TokenUsage | null;
+}
+declare function getStructuredOutputClient(options?: StructuredOutputOptions): StructuredOutputClient;
+declare function resetStructuredOutputClient(): void;
+declare function isStructuredOutputAvailable(): boolean;
+
+export { type JsonSchema, STRUCTURED_OUTPUT_MODELS, type StructuredGenerationOptions, type StructuredGenerationResult, StructuredOutputClient, type StructuredOutputOptions, getStructuredOutputClient, isStructuredOutputAvailable, resetStructuredOutputClient };

package/dist/structured-output.js

@@ -0,0 +1,16 @@
+import {
+  STRUCTURED_OUTPUT_MODELS,
+  StructuredOutputClient,
+  getStructuredOutputClient,
+  isStructuredOutputAvailable,
+  resetStructuredOutputClient
+} from "./chunk-KH4JNOLT.js";
+import "./chunk-MJS33AAS.js";
+export {
+  STRUCTURED_OUTPUT_MODELS,
+  StructuredOutputClient,
+  getStructuredOutputClient,
+  isStructuredOutputAvailable,
+  resetStructuredOutputClient
+};
+//# sourceMappingURL=structured-output.js.map

package/dist/structured-output.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@almadar/llm",
+  "version": "1.0.0",
+  "description": "Multi-provider LLM client with rate limiting, token tracking, structured outputs, and continuation handling",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./client": {
+      "types": "./dist/client.d.ts",
+      "import": "./dist/client.js"
+    },
+    "./json-parser": {
+      "types": "./dist/json-parser.d.ts",
+      "import": "./dist/json-parser.js"
+    },
+    "./structured-output": {
+      "types": "./dist/structured-output.d.ts",
+      "import": "./dist/structured-output.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "dependencies": {
+    "@anthropic-ai/sdk": "^0.52.0",
+    "@langchain/anthropic": "^0.3.0",
+    "@langchain/openai": "^0.3.0",
+    "openai": "^4.0.0",
+    "zod": "^3.22.0"
+  },
+  "peerDependencies": {
+    "@almadar/core": "1.0.1"
+  },
+  "peerDependenciesMeta": {
+    "@almadar/core": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "tsup": "^8.0.0",
+    "typescript": "^5.3.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  }
+}