@kokimoki/app 2.0.2 → 2.1.0

package/dist/llms.txt

@@ -330,6 +330,8 @@ const { content } = await kmClient.ai.chat({
 
 Used to generate structured JSON output with AI. Automatically ensures the response is valid JSON and parses it for you.
 
+**Important:** Your prompt must include the word "json" and should describe the expected output schema (field names, types, and structure) to ensure the AI generates properly formatted responses.
+
 **Parameters:**
 
 - **req.model**: `string` AI model to use (optional). Available models:

package/dist/services/kokimoki-ai.d.ts

@@ -69,6 +69,8 @@ export declare class KokimokiAiService {
      *                  - `gpt-5-nano`: Smallest GPT-5 variant for lightweight tasks
      *                  - `gemini-2.5-flash-lite`: Google Gemini lite variant
      *                  - `gemini-2.5-flash`: Google Gemini fast variant
+     *                  - `gemini-3-flash-preview`: Google Gemini 3 Flash preview
+     *                  - `gemini-3-pro-preview`: Google Gemini 3 Pro preview
      * @param req.systemPrompt Optional. The system message that sets the behavior and context for the AI.
      *                         This helps define the AI's role, personality, and constraints.
      * @param req.userPrompt The user's message or question to send to the AI.
@@ -96,12 +98,14 @@ export declare class KokimokiAiService {
      * ```
      */
     chat(req: {
-        model?: "gpt-4o" | "gpt-4o-mini" | "gpt-5" | "gpt-5-mini" | "gpt-5-nano" | "gemini-2.5-flash-lite" | "gemini-2.5-flash";
+        model?: "gpt-4o" | "gpt-4o-mini" | "gpt-5" | "gpt-5-mini" | "gpt-5-nano" | "gemini-2.5-flash-lite" | "gemini-2.5-flash" | "gemini-3-flash-preview" | "gemini-3-pro-preview";
         systemPrompt?: string;
         userPrompt: string;
         temperature?: number;
         maxTokens?: number;
         responseMimeType?: string;
+        /** Image URLs to include with the user prompt (Gemini models only) */
+        imageUrls?: string[];
     }): Promise<{
         content: string;
     }>;
@@ -112,6 +116,10 @@ export declare class KokimokiAiService {
      * a JSON-formatted response. This is useful for scenarios where the output
      * needs to be parsed or processed programmatically.
      *
+     * **Important:** Your prompt must include the word "json" and should describe
+     * the expected output schema (field names, types, and structure) to ensure
+     * the AI generates properly formatted responses.
+     *
      * @param req The chat request parameters.
      * @param req.model Optional. The AI model to use. Defaults to server-side default if not specified.
      *                  Available models:
@@ -122,6 +130,8 @@ export declare class KokimokiAiService {
      *                  - `gpt-5-nano`: Smallest GPT-5 variant for lightweight tasks
      *                  - `gemini-2.5-flash-lite`: Google Gemini lite variant
      *                  - `gemini-2.5-flash`: Google Gemini fast variant
+     *                  - `gemini-3-flash-preview`: Google Gemini 3 Flash preview
+     *                  - `gemini-3-pro-preview`: Google Gemini 3 Pro preview
      * @param req.systemPrompt Optional. The system message that sets the behavior and context for the AI.
      *                         This helps define the AI's role, personality, and constraints.
      * @param req.userPrompt The user's message or question to send to the AI.
@@ -130,17 +140,21 @@ export declare class KokimokiAiService {
      *                        higher values make it more creative and varied.
      * @param req.maxTokens Optional. The maximum number of tokens to generate in the response.
      *                      Controls the length of the AI's output.
+     * @param req.imageUrls Optional. Image URLs to include with the user prompt (Gemini models only).
+     *                      Allows the AI to analyze images and generate structured JSON based on them.
      *
      * @returns A promise that resolves to the parsed JSON object generated by the AI.
      *
      * @throws An error object if the API request fails or if the response is not valid JSON.
      */
     generateJson<T extends object>(req: {
-        model?: "gpt-4o" | "gpt-4o-mini" | "gpt-5" | "gpt-5-mini" | "gpt-5-nano" | "gemini-2.5-flash-lite" | "gemini-2.5-flash";
+        model?: "gpt-4o" | "gpt-4o-mini" | "gpt-5" | "gpt-5-mini" | "gpt-5-nano" | "gemini-2.5-flash-lite" | "gemini-2.5-flash" | "gemini-3-flash-preview" | "gemini-3-pro-preview";
         systemPrompt?: string;
         userPrompt: string;
         temperature?: number;
         maxTokens?: number;
+        /** Image URLs to include with the user prompt (Gemini models only) */
+        imageUrls?: string[];
     }): Promise<T>;
     /**
      * Modify an image using the AI service.

package/dist/services/kokimoki-ai.js

@@ -69,6 +69,8 @@ export class KokimokiAiService {
      *                  - `gpt-5-nano`: Smallest GPT-5 variant for lightweight tasks
      *                  - `gemini-2.5-flash-lite`: Google Gemini lite variant
      *                  - `gemini-2.5-flash`: Google Gemini fast variant
+     *                  - `gemini-3-flash-preview`: Google Gemini 3 Flash preview
+     *                  - `gemini-3-pro-preview`: Google Gemini 3 Pro preview
      * @param req.systemPrompt Optional. The system message that sets the behavior and context for the AI.
      *                         This helps define the AI's role, personality, and constraints.
      * @param req.userPrompt The user's message or question to send to the AI.
@@ -113,6 +115,10 @@ export class KokimokiAiService {
      * a JSON-formatted response. This is useful for scenarios where the output
      * needs to be parsed or processed programmatically.
      *
+     * **Important:** Your prompt must include the word "json" and should describe
+     * the expected output schema (field names, types, and structure) to ensure
+     * the AI generates properly formatted responses.
+     *
      * @param req The chat request parameters.
      * @param req.model Optional. The AI model to use. Defaults to server-side default if not specified.
      *                  Available models:
@@ -123,6 +129,8 @@ export class KokimokiAiService {
      *                  - `gpt-5-nano`: Smallest GPT-5 variant for lightweight tasks
      *                  - `gemini-2.5-flash-lite`: Google Gemini lite variant
      *                  - `gemini-2.5-flash`: Google Gemini fast variant
+     *                  - `gemini-3-flash-preview`: Google Gemini 3 Flash preview
+     *                  - `gemini-3-pro-preview`: Google Gemini 3 Pro preview
      * @param req.systemPrompt Optional. The system message that sets the behavior and context for the AI.
      *                         This helps define the AI's role, personality, and constraints.
      * @param req.userPrompt The user's message or question to send to the AI.
@@ -131,6 +139,8 @@ export class KokimokiAiService {
      *                        higher values make it more creative and varied.
      * @param req.maxTokens Optional. The maximum number of tokens to generate in the response.
      *                      Controls the length of the AI's output.
+     * @param req.imageUrls Optional. Image URLs to include with the user prompt (Gemini models only).
+     *                      Allows the AI to analyze images and generate structured JSON based on them.
      *
      * @returns A promise that resolves to the parsed JSON object generated by the AI.
      *

package/dist/version.d.ts

@@ -1 +1 @@
-export declare const KOKIMOKI_APP_VERSION = "2.0.2";
+export declare const KOKIMOKI_APP_VERSION = "2.1.0";

package/dist/version.js

@@ -1,2 +1,2 @@
 // Auto-generated file. Do not edit manually.
-export const KOKIMOKI_APP_VERSION = '2.0.2';
+export const KOKIMOKI_APP_VERSION = '2.1.0';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kokimoki/app",
-  "version": "2.0.2",
+  "version": "2.1.0",
   "type": "module",
   "description": "Kokimoki app",
   "main": "dist/index.js",