@flink-app/gemini-adapter 2.0.0-alpha.100

package/LICENSE

@@ -0,0 +1,21 @@
+The MIT License
+
+Copyright (c) Frost Experience AB https://www.frost.se
+
+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,71 @@
+# @flink-app/gemini-adapter
+
+Google Gemini adapter for the [Flink AI framework](https://github.com/FrostDigital/flink-framework).
+
+## Installation
+
+```bash
+npm install @flink-app/gemini-adapter @google/generative-ai
+```
+
+## Usage
+
+```typescript
+import { GeminiAdapter } from "@flink-app/gemini-adapter";
+import { FlinkApp } from "@flink-app/flink";
+
+const app = new FlinkApp({
+  ai: {
+    llms: {
+      default: new GeminiAdapter({
+        apiKey: process.env.GOOGLE_AI_API_KEY!,
+        model: "gemini-2.0-flash",
+      }),
+    },
+  },
+});
+```
+
+## Configuration
+
+| Option  | Type      | Required | Description                                                        |
+|---------|-----------|----------|--------------------------------------------------------------------|
+| apiKey  | `string`  | Yes      | Google AI API key                                                  |
+| model   | `string`  | Yes      | Gemini model name (e.g. `"gemini-2.0-flash"`, `"gemini-1.5-pro"`) |
+| debug   | `boolean` | No       | Enable debug logging (default: `false`)                            |
+
+## Supported Models
+
+- `gemini-2.0-flash` — Fast, cost-effective (recommended default)
+- `gemini-1.5-pro` — High capability, longer context
+- `gemini-1.5-flash` — Fast, balanced capability
+- `gemini-2.5-pro-preview-03-25` — Latest preview model
+
+## Features
+
+- ✅ Tool calling support
+- ✅ Streaming responses (SSE / NDJSON)
+- ✅ Alternating turn enforcement (consecutive same-role messages are merged)
+- ✅ System instruction handling
+- ✅ JSON Schema sanitization for Gemini compatibility
+- ✅ Token usage tracking
+- ✅ Debug logging
+
+## Using with FlinkAgent
+
+```typescript
+import { FlinkAgent } from "@flink-app/flink";
+import { GeminiAdapter } from "@flink-app/gemini-adapter";
+
+export default class CarAgent extends FlinkAgent<AppContext> {
+  instructions = "You are a helpful car assistant.";
+  llm = new GeminiAdapter({
+    apiKey: process.env.GOOGLE_AI_API_KEY!,
+    model: "gemini-2.0-flash",
+  });
+}
+```
+
+## License
+
+MIT

package/dist/GeminiAdapter.d.ts

@@ -0,0 +1,125 @@
+import type { FlinkToolSchema, LLMAdapter, LLMMessage, LLMStreamChunk } from "@flink-app/flink/ai";
+export interface GeminiAdapterOptions {
+    /**
+     * Google AI API key
+     */
+    apiKey: string;
+    /**
+     * Model to use (e.g., "gemini-2.0-flash", "gemini-1.5-pro", "gemini-2.5-pro-preview-03-25")
+     */
+    model: string;
+    /**
+     * Optional: Enable debug logging for development and troubleshooting
+     *
+     * When enabled, logs:
+     * - Full request parameters sent to Gemini
+     * - Tool call decisions made by the LLM
+     * - Token usage and performance metrics
+     *
+     * @default false
+     */
+    debug?: boolean;
+}
+/**
+ * Google Gemini adapter for Flink AI framework
+ *
+ * Provides integration with Google's Gemini models via the Generative AI API.
+ * Supports tool calling, handles message formatting between Flink's standardized
+ * format and Gemini's API format, and provides streaming support.
+ *
+ * ## Architecture
+ *
+ * This adapter implements the LLMAdapter interface and handles:
+ * - Message conversion from Flink format to Gemini format (user/model roles)
+ * - System instructions passed as separate systemInstruction parameter
+ * - Tool schema sanitization for Gemini compatibility
+ * - Streaming event processing via generateContentStream()
+ * - Consecutive same-role message merging (Gemini requires alternating turns)
+ *
+ * ## Basic Usage
+ * ```typescript
+ * import { GeminiAdapter } from "@flink-app/gemini-adapter";
+ * import { FlinkApp } from "@flink-app/flink";
+ *
+ * const app = new FlinkApp({
+ *   ai: {
+ *     llms: {
+ *       default: new GeminiAdapter({
+ *         apiKey: process.env.GOOGLE_AI_API_KEY!,
+ *         model: "gemini-2.0-flash"
+ *       }),
+ *     },
+ *   },
+ * });
+ * ```
+ *
+ * ## Features
+ * - ✅ Full tool calling support
+ * - ✅ Streaming with event-based updates
+ * - ✅ Proper message conversion and system instruction handling
+ * - ✅ Schema sanitization for Gemini compatibility
+ * - ✅ Alternating turn enforcement (merges consecutive same-role messages)
+ * - ✅ Token usage tracking
+ * - ✅ Debug logging for tool calls
+ */
+export declare class GeminiAdapter implements LLMAdapter<FlinkToolSchema> {
+    private apiKey;
+    private model;
+    debug: boolean;
+    constructor(options: GeminiAdapterOptions);
+    constructor(apiKey: string, model: string);
+    stream(params: {
+        instructions: string;
+        messages: LLMMessage[];
+        tools: FlinkToolSchema[];
+        maxTokens: number;
+        temperature: number;
+        providerMetadata?: Record<string, any>;
+    }): AsyncGenerator<LLMStreamChunk>;
+    /**
+     * Convert Flink messages to Gemini format
+     *
+     * Gemini requires:
+     * 1. System instructions as separate systemInstruction parameter (not in messages)
+     * 2. Messages with role "user" or "model" (assistant → model)
+     * 3. Strictly alternating user/model turns — consecutive same-role messages must be merged
+     * 4. Tool results as user messages with functionResponse parts
+     */
+    private convertMessagesToGeminiFormat;
+    /**
+     * Convert a single Flink message's content to Gemini Part[]
+     */
+    private convertContentToGeminiParts;
+    /**
+     * Convert Flink tools to Gemini format
+     *
+     * Gemini uses:
+     * { functionDeclarations: [{ name, description, parameters: JSONSchema }] }
+     */
+    private convertToolsToGeminiFormat;
+    /**
+     * Sanitize JSON Schema for Gemini's tool use
+     *
+     * Gemini has stricter JSON Schema requirements than Anthropic/OpenAI:
+     * - Does not support $schema, $defs, $ref (must be inline)
+     * - Does not support additionalProperties
+     * - Limited format support
+     * - Does not support default values in schemas
+     */
+    private sanitizeSchemaForGemini;
+    /**
+     * Normalize Gemini finish reason to Flink format
+     *
+     * Maps Gemini's finishReason values:
+     * - "STOP" → "end_turn"
+     * - "MAX_TOKENS" → "max_tokens"
+     * - "SAFETY" / others → "end_turn"
+     */
+    private normalizeStopReason;
+    /**
+     * Generate a unique ID for tool calls
+     * Gemini doesn't provide tool call IDs natively, so we generate them
+     */
+    private generateToolCallId;
+}
+//# sourceMappingURL=GeminiAdapter.d.ts.map

package/dist/GeminiAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GeminiAdapter.d.ts","sourceRoot":"","sources":["../src/GeminiAdapter.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,UAAU,EAAmB,UAAU,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAEpH,MAAM,WAAW,oBAAoB;IACjC;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;;;;;;;;OASG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,qBAAa,aAAc,YAAW,UAAU,CAAC,eAAe,CAAC;IAC7D,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,KAAK,CAAS;IACf,KAAK,EAAE,OAAO,CAAC;gBAEV,OAAO,EAAE,oBAAoB;gBAC7B,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;IAalC,MAAM,CAAC,MAAM,EAAE;QAClB,YAAY,EAAE,MAAM,CAAC;QACrB,QAAQ,EAAE,UAAU,EAAE,CAAC;QACvB,KAAK,EAAE,eAAe,EAAE,CAAC;QACzB,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,MAAM,CAAC;QACpB,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;KAC1C,GAAG,cAAc,CAAC,cAAc,CAAC;IAsGlC;;;;;;;;OAQG;IACH,OAAO,CAAC,6BAA6B;IAwBrC;;OAEG;IACH,OAAO,CAAC,2BAA2B;IA6DnC;;;;;OAKG;IACH,OAAO,CAAC,0BAA0B;IAYlC;;;;;;;;OAQG;IACH,OAAO,CAAC,uBAAuB;IAsC/B;;;;;;;OAOG;IACH,OAAO,CAAC,mBAAmB;IAU3B;;;OAGG;IACH,OAAO,CAAC,kBAAkB;CAG7B"}

package/dist/GeminiAdapter.js

@@ -0,0 +1,329 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GeminiAdapter = void 0;
+const generative_ai_1 = require("@google/generative-ai");
+const flink_1 = require("@flink-app/flink");
+/**
+ * Google Gemini adapter for Flink AI framework
+ *
+ * Provides integration with Google's Gemini models via the Generative AI API.
+ * Supports tool calling, handles message formatting between Flink's standardized
+ * format and Gemini's API format, and provides streaming support.
+ *
+ * ## Architecture
+ *
+ * This adapter implements the LLMAdapter interface and handles:
+ * - Message conversion from Flink format to Gemini format (user/model roles)
+ * - System instructions passed as separate systemInstruction parameter
+ * - Tool schema sanitization for Gemini compatibility
+ * - Streaming event processing via generateContentStream()
+ * - Consecutive same-role message merging (Gemini requires alternating turns)
+ *
+ * ## Basic Usage
+ * ```typescript
+ * import { GeminiAdapter } from "@flink-app/gemini-adapter";
+ * import { FlinkApp } from "@flink-app/flink";
+ *
+ * const app = new FlinkApp({
+ *   ai: {
+ *     llms: {
+ *       default: new GeminiAdapter({
+ *         apiKey: process.env.GOOGLE_AI_API_KEY!,
+ *         model: "gemini-2.0-flash"
+ *       }),
+ *     },
+ *   },
+ * });
+ * ```
+ *
+ * ## Features
+ * - ✅ Full tool calling support
+ * - ✅ Streaming with event-based updates
+ * - ✅ Proper message conversion and system instruction handling
+ * - ✅ Schema sanitization for Gemini compatibility
+ * - ✅ Alternating turn enforcement (merges consecutive same-role messages)
+ * - ✅ Token usage tracking
+ * - ✅ Debug logging for tool calls
+ */
+class GeminiAdapter {
+    constructor(optionsOrApiKey, model) {
+        if (typeof optionsOrApiKey === "string") {
+            this.apiKey = optionsOrApiKey;
+            this.model = model;
+            this.debug = false;
+        }
+        else {
+            this.apiKey = optionsOrApiKey.apiKey;
+            this.model = optionsOrApiKey.model;
+            this.debug = optionsOrApiKey.debug ?? false;
+        }
+    }
+    async *stream(params) {
+        try {
+            const genAI = new generative_ai_1.GoogleGenerativeAI(this.apiKey);
+            const geminiMessages = this.convertMessagesToGeminiFormat(params.messages);
+            const geminiTools = params.tools.length > 0 ? this.convertToolsToGeminiFormat(params.tools) : undefined;
+            const geminiModel = genAI.getGenerativeModel({
+                model: this.model,
+                systemInstruction: params.instructions || undefined,
+            });
+            const result = await geminiModel.generateContentStream({
+                contents: geminiMessages,
+                tools: geminiTools,
+                generationConfig: {
+                    maxOutputTokens: params.maxTokens,
+                    temperature: params.temperature,
+                },
+            });
+            // Accumulate tool calls across chunks (Gemini may split across chunks)
+            const pendingToolCalls = [];
+            for await (const chunk of result.stream) {
+                const candidate = chunk.candidates?.[0];
+                if (!candidate?.content?.parts)
+                    continue;
+                for (const part of candidate.content.parts) {
+                    if (part.text) {
+                        yield { type: "text", delta: part.text };
+                    }
+                    else if (part.functionCall) {
+                        pendingToolCalls.push({
+                            name: part.functionCall.name,
+                            args: part.functionCall.args ?? {},
+                        });
+                    }
+                }
+            }
+            // Yield completed tool calls after stream finishes
+            for (const tc of pendingToolCalls) {
+                if (this.debug) {
+                    flink_1.log.debug(`[Gemini Stream] LLM decided to call tool:`, JSON.stringify({ name: tc.name, input: tc.args }, null, 2));
+                }
+                yield {
+                    type: "tool_call",
+                    toolCall: {
+                        id: this.generateToolCallId(),
+                        name: tc.name,
+                        input: tc.args,
+                    },
+                };
+            }
+            // Get final response for usage metadata
+            const response = await result.response;
+            const usageMeta = response.usageMetadata;
+            yield {
+                type: "usage",
+                usage: {
+                    inputTokens: usageMeta?.promptTokenCount ?? 0,
+                    outputTokens: usageMeta?.candidatesTokenCount ?? 0,
+                },
+            };
+            const finishReason = response.candidates?.[0]?.finishReason;
+            yield {
+                type: "done",
+                stopReason: this.normalizeStopReason(finishReason ?? "STOP"),
+            };
+        }
+        catch (error) {
+            if (error.status === 400) {
+                throw new Error(`Gemini API error (400 Bad Request): ${error.message || "Invalid request"}. ` +
+                    `Common causes: invalid model name, malformed messages, or invalid tool schemas. ` +
+                    `Model: ${this.model}`);
+            }
+            else if (error.status === 401 || error.status === 403) {
+                throw new Error(`Gemini API authentication error (${error.status}): Invalid API key or insufficient permissions. ` +
+                    `Verify your GOOGLE_AI_API_KEY environment variable is set correctly.`);
+            }
+            else if (error.status === 429) {
+                throw new Error(`Gemini API rate limit exceeded (429 Too Many Requests): ${error.message || "Rate limit hit"}. ` +
+                    `Consider implementing retry logic with exponential backoff or upgrading your quota.`);
+            }
+            else if (error.status === 500 || error.status === 503) {
+                throw new Error(`Gemini API server error (${error.status}): ${error.message || "Internal server error"}. ` +
+                    `This is a temporary issue with Google's servers. Please retry your request.`);
+            }
+            throw error;
+        }
+    }
+    /**
+     * Convert Flink messages to Gemini format
+     *
+     * Gemini requires:
+     * 1. System instructions as separate systemInstruction parameter (not in messages)
+     * 2. Messages with role "user" or "model" (assistant → model)
+     * 3. Strictly alternating user/model turns — consecutive same-role messages must be merged
+     * 4. Tool results as user messages with functionResponse parts
+     */
+    convertMessagesToGeminiFormat(messages) {
+        const geminiMessages = [];
+        for (const msg of messages) {
+            // System messages are handled via systemInstruction — skip here
+            if (msg.role === "system")
+                continue;
+            const role = msg.role === "assistant" ? "model" : "user";
+            const parts = this.convertContentToGeminiParts(msg);
+            if (parts.length === 0)
+                continue;
+            // Merge consecutive same-role messages (Gemini requires alternating turns)
+            const last = geminiMessages[geminiMessages.length - 1];
+            if (last && last.role === role) {
+                last.parts.push(...parts);
+            }
+            else {
+                geminiMessages.push({ role, parts });
+            }
+        }
+        return geminiMessages;
+    }
+    /**
+     * Convert a single Flink message's content to Gemini Part[]
+     */
+    convertContentToGeminiParts(msg) {
+        if (msg.role === "system")
+            return [];
+        const content = msg.content;
+        if (typeof content === "string") {
+            return [{ text: content }];
+        }
+        const parts = [];
+        const blocks = content;
+        for (const block of blocks) {
+            if (block.type === "text") {
+                parts.push({ text: block.text });
+            }
+            else if (block.type === "image") {
+                if (block.url.startsWith("data:")) {
+                    const match = block.url.match(/^data:(.+?);base64,(.+)$/);
+                    if (match) {
+                        parts.push({
+                            inlineData: {
+                                mimeType: match[1],
+                                data: match[2],
+                            },
+                        });
+                    }
+                }
+                else {
+                    // Gemini supports fileData for non-base64 URLs (Google Cloud Storage)
+                    parts.push({
+                        fileData: {
+                            mimeType: "image/jpeg", // Default; ideally caller specifies mime type
+                            fileUri: block.url,
+                        },
+                    });
+                }
+            }
+            else if (block.type === "tool_use") {
+                // Assistant tool use → functionCall part
+                parts.push({
+                    functionCall: {
+                        name: block.name,
+                        args: block.input,
+                    },
+                });
+            }
+            else if (block.type === "tool_result") {
+                // Tool result → functionResponse part (goes in user message)
+                parts.push({
+                    functionResponse: {
+                        name: block.tool_use_id, // Gemini matches by function name, not ID
+                        response: {
+                            content: block.is_error
+                                ? { error: block.content }
+                                : { result: block.content },
+                        },
+                    },
+                });
+            }
+        }
+        return parts;
+    }
+    /**
+     * Convert Flink tools to Gemini format
+     *
+     * Gemini uses:
+     * { functionDeclarations: [{ name, description, parameters: JSONSchema }] }
+     */
+    convertToolsToGeminiFormat(tools) {
+        return [
+            {
+                functionDeclarations: tools.map((tool) => ({
+                    name: tool.name,
+                    description: tool.description,
+                    parameters: this.sanitizeSchemaForGemini(tool.inputSchema),
+                })),
+            },
+        ];
+    }
+    /**
+     * Sanitize JSON Schema for Gemini's tool use
+     *
+     * Gemini has stricter JSON Schema requirements than Anthropic/OpenAI:
+     * - Does not support $schema, $defs, $ref (must be inline)
+     * - Does not support additionalProperties
+     * - Limited format support
+     * - Does not support default values in schemas
+     */
+    sanitizeSchemaForGemini(schema) {
+        const sanitized = JSON.parse(JSON.stringify(schema));
+        const sanitizeNode = (node) => {
+            if (!node || typeof node !== "object")
+                return;
+            // Remove unsupported keywords
+            delete node.$schema;
+            delete node.$defs;
+            delete node.$ref;
+            delete node.additionalProperties;
+            delete node.default;
+            delete node.$id;
+            if (node.properties) {
+                for (const key in node.properties) {
+                    sanitizeNode(node.properties[key]);
+                }
+            }
+            if (node.items) {
+                if (Array.isArray(node.items)) {
+                    node.items.forEach(sanitizeNode);
+                }
+                else {
+                    sanitizeNode(node.items);
+                }
+            }
+            if (node.allOf)
+                node.allOf.forEach(sanitizeNode);
+            if (node.anyOf)
+                node.anyOf.forEach(sanitizeNode);
+            if (node.oneOf)
+                node.oneOf.forEach(sanitizeNode);
+            if (node.not)
+                sanitizeNode(node.not);
+        };
+        sanitizeNode(sanitized);
+        return sanitized;
+    }
+    /**
+     * Normalize Gemini finish reason to Flink format
+     *
+     * Maps Gemini's finishReason values:
+     * - "STOP" → "end_turn"
+     * - "MAX_TOKENS" → "max_tokens"
+     * - "SAFETY" / others → "end_turn"
+     */
+    normalizeStopReason(finishReason) {
+        switch (finishReason) {
+            case "MAX_TOKENS":
+                return "max_tokens";
+            case "STOP":
+            default:
+                return "end_turn";
+        }
+    }
+    /**
+     * Generate a unique ID for tool calls
+     * Gemini doesn't provide tool call IDs natively, so we generate them
+     */
+    generateToolCallId() {
+        return `tc_${Date.now()}_${Math.random().toString(36).slice(2, 9)}`;
+    }
+}
+exports.GeminiAdapter = GeminiAdapter;
+//# sourceMappingURL=GeminiAdapter.js.map

package/dist/GeminiAdapter.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export { GeminiAdapter, type GeminiAdapterOptions } from "./GeminiAdapter";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,KAAK,oBAAoB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GeminiAdapter = void 0;
+var GeminiAdapter_1 = require("./GeminiAdapter");
+Object.defineProperty(exports, "GeminiAdapter", { enumerable: true, get: function () { return GeminiAdapter_1.GeminiAdapter; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,iDAA2E;AAAlE,8GAAA,aAAa,OAAA"}

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@flink-app/gemini-adapter",
+  "version": "2.0.0-alpha.100",
+  "description": "Google Gemini adapter for Flink AI framework",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "keywords": [
+    "flink",
+    "gemini",
+    "google",
+    "ai",
+    "llm",
+    "adapter"
+  ],
+  "author": "Frost Digital",
+  "license": "MIT",
+  "dependencies": {
+    "@google/generative-ai": "^0.24.0"
+  },
+  "peerDependencies": {
+    "@flink-app/flink": ">=2.0.0-alpha.100"
+  },
+  "peerDependenciesMeta": {
+    "@flink-app/flink": {
+      "optional": false
+    }
+  },
+  "devDependencies": {
+    "@types/jasmine": "^3.7.1",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.6.2",
+    "@flink-app/flink": "2.0.0-alpha.100"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/FrostDigital/flink-framework.git",
+    "directory": "packages/gemini-adapter"
+  },
+  "scripts": {
+    "build": "tsc --project tsconfig.dist.json",
+    "watch": "tsc --project tsconfig.dist.json --watch",
+    "test": "../../node_modules/.bin/jasmine-ts --config=./spec/support/jasmine.json",
+    "clean": "rm -rf dist"
+  }
+}