@ouraihub/llm 0.2.0

package/dist/types/skill-loader.d.ts

@@ -0,0 +1,82 @@
+/**
+ * @ouraihub/llm — Skill Loader.
+ *
+ * Loads skill files (SKILL.md format) and assembles them into structured
+ * system prompts. Skills provide domain-specific knowledge, workflows,
+ * and behavioral constraints for LLM completions.
+ *
+ * Usage:
+ *   const loader = new SkillLoader();
+ *   loader.add('gzh-design', skillMarkdownContent);
+ *   const systemPrompt = loader.toSystemPrompt();
+ *   await llm.complete({ system: systemPrompt, user: '...' }, schema);
+ */
+import type { LLMPrompt } from './interfaces.js';
+/** A loaded skill entry */
+export interface SkillEntry {
+    /** Unique identifier (e.g. 'gzh-design') */
+    readonly id: string;
+    /** Skill name from frontmatter */
+    readonly name: string;
+    /** Skill description from frontmatter */
+    readonly description: string;
+    /** Full body content (markdown) */
+    readonly body: string;
+}
+/** Options for system prompt assembly */
+export interface SkillPromptOptions {
+    /** Max total characters for all skills combined (default: no limit) */
+    readonly maxChars?: number;
+    /** Prefix before skill content (role/persona instruction) */
+    readonly preamble?: string;
+    /** Suffix after skill content (output format instructions) */
+    readonly postamble?: string;
+}
+/**
+ * SkillLoader — manages loading and composing skills into LLM prompts.
+ *
+ * Design:
+ * - Skills are added as raw SKILL.md content (frontmatter + body)
+ * - Frontmatter is parsed for metadata (name, description)
+ * - Body becomes the instruction block in the system prompt
+ * - Multiple skills compose into sections with clear boundaries
+ */
+export declare class SkillLoader {
+    private skills;
+    /** Add a skill from raw SKILL.md content */
+    add(id: string, rawContent: string): this;
+    /** Add a skill from pre-parsed entry */
+    addEntry(entry: SkillEntry): this;
+    /** Remove a skill by id */
+    remove(id: string): this;
+    /** Check if a skill is loaded */
+    has(id: string): boolean;
+    /** Get loaded skill ids */
+    ids(): string[];
+    /** Clear all loaded skills */
+    clear(): this;
+    /**
+     * Assemble all loaded skills into a system prompt string.
+     *
+     * Format:
+     * ```
+     * {preamble}
+     *
+     * === SKILL: {name} ===
+     * {body}
+     *
+     * === SKILL: {name2} ===
+     * {body2}
+     *
+     * {postamble}
+     * ```
+     */
+    toSystemPrompt(options?: SkillPromptOptions): string;
+    /**
+     * Build a complete LLMPrompt with skills as system context.
+     *
+     * Convenience method that combines skill system prompt with user message.
+     */
+    buildPrompt(userMessage: string, options?: SkillPromptOptions): LLMPrompt;
+}
+//# sourceMappingURL=skill-loader.d.ts.map

package/dist/types/skill-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-loader.d.ts","sourceRoot":"","sources":["../../src/skill-loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD,2BAA2B;AAC3B,MAAM,WAAW,UAAU;IACzB,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,kCAAkC;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,yCAAyC;IACzC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,mCAAmC;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,yCAAyC;AACzC,MAAM,WAAW,kBAAkB;IACjC,uEAAuE;IACvE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,6DAA6D;IAC7D,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,8DAA8D;IAC9D,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;;;;GAQG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAsC;IAEpD,4CAA4C;IAC5C,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;IAMzC,wCAAwC;IACxC,QAAQ,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAKjC,2BAA2B;IAC3B,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAKxB,iCAAiC;IACjC,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAIxB,2BAA2B;IAC3B,GAAG,IAAI,MAAM,EAAE;IAIf,8BAA8B;IAC9B,KAAK,IAAI,IAAI;IAKb;;;;;;;;;;;;;;;OAeG;IACH,cAAc,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,MAAM;IA0BpD;;;;OAIG;IACH,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,SAAS;CAM1E"}

package/dist/types/tool-executor.d.ts

@@ -0,0 +1,41 @@
+/**
+ * @ouraihub/llm — Tool Executor.
+ *
+ * Manages the multi-round tool calling loop using proper multi-turn
+ * message history (assistant tool_calls → tool results → assistant response).
+ *
+ * Flow:
+ * 1. Send prompt to LLM with tool definitions
+ * 2. If model requests tool calls:
+ *    a. Execute each tool handler
+ *    b. Append assistant message (with tool_calls) + tool result messages
+ *    c. Re-send full conversation history to LLM
+ * 3. Repeat until model produces final text response (no more tool calls)
+ * 4. Validate final content against Zod schema
+ */
+import type { z } from 'zod';
+import type { ILLMProvider, IToolExecutor, LLMPrompt, ToolRegistration } from './interfaces.js';
+import type { ILogger } from './logger.js';
+/** Options for tool execution */
+export interface ToolExecutorOptions {
+    readonly maxRounds?: number;
+    readonly logger?: ILogger;
+}
+export declare class ToolExecutor implements IToolExecutor {
+    private readonly tools;
+    private readonly logger;
+    constructor(options?: {
+        logger?: ILogger;
+    });
+    register(tools: readonly ToolRegistration[]): void;
+    completeWithTools<T>(provider: ILLMProvider, prompt: LLMPrompt, schema: z.ZodSchema<T>, options?: {
+        maxRounds?: number;
+    }): Promise<T>;
+    private executeTool;
+    /**
+     * Call LLM with native multi-turn messages API.
+     */
+    private callWithMessages;
+    private validateOutput;
+}
+//# sourceMappingURL=tool-executor.d.ts.map

package/dist/types/tool-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-executor.d.ts","sourceRoot":"","sources":["../../src/tool-executor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EACV,YAAY,EACZ,aAAa,EACb,SAAS,EAKT,gBAAgB,EACjB,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAM3C,iCAAiC;AACjC,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,qBAAa,YAAa,YAAW,aAAa;IAChD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA4C;IAClE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAU;gBAErB,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE;IAI1C,QAAQ,CAAC,KAAK,EAAE,SAAS,gBAAgB,EAAE,GAAG,IAAI;IAO5C,iBAAiB,CAAC,CAAC,EACvB,QAAQ,EAAE,YAAY,EACtB,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EACtB,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAC/B,OAAO,CAAC,CAAC,CAAC;YA4DC,WAAW;IAoBzB;;OAEG;YACW,gBAAgB;IAgB9B,OAAO,CAAC,cAAc;CAwBvB"}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@ouraihub/llm",
+  "version": "0.2.0",
+  "description": "LLM provider abstraction — OpenAI-compatible & Anthropic, with structured output, tool calling, and timeout control",
+  "type": "module",
+  "main": "./dist/cjs/index.cjs",
+  "module": "./dist/esm/index.mjs",
+  "types": "./dist/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/types/index.d.ts",
+      "import": "./dist/esm/index.mjs",
+      "require": "./dist/cjs/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "llm",
+    "openai",
+    "anthropic",
+    "ai",
+    "structured-output",
+    "cloudflare-workers"
+  ],
+  "author": "OurAI Hub",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ouraihub/ui-library.git",
+    "directory": "packages/llm"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "zod": "^3.22.0"
+  },
+  "devDependencies": {
+    "esbuild": "^0.28.1",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.10",
+    "zod": "^4.4.3"
+  },
+  "scripts": {
+    "build": "node build.js && tsc --emitDeclarationOnly",
+    "dev": "node build.js --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  }
+}