@commandkit/ai 0.1.0-dev.20250609135507

package/LICENSE

@@ -0,0 +1,5 @@
+Copyright 2025 Avraj Sahota
+
+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.
+
+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,19 @@
+# `@commandkit/ai`
+
+Supercharge your CommandKit project with AI capabilities.
+
+## Installation
+
+```bash
+npm install @commandkit/ai
+```
+
+## Usage
+
+```ts
+import { ai } from '@commandkit/ai';
+
+export default defineConfig({
+  plugins: [ai()],
+})
+```

package/dist/ai-context-worker.d.ts

@@ -0,0 +1,7 @@
+import { Message } from 'discord.js';
+import { AiContext } from './context';
+export declare function getAiWorkerContext(): {
+    message: Message;
+    ctx: AiContext;
+};
+export declare function runInAiWorkerContext<R, F extends (...args: any[]) => R>(ctx: AiContext, message: Message, callback: F): R;

package/dist/ai-context-worker.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getAiWorkerContext = getAiWorkerContext;
+exports.runInAiWorkerContext = runInAiWorkerContext;
+const node_async_hooks_1 = require("node:async_hooks");
+const worker = new node_async_hooks_1.AsyncLocalStorage();
+function getAiWorkerContext() {
+    const ctx = worker.getStore();
+    if (!ctx) {
+        throw new Error('AI context is not available. Ensure you are using AI in a CommandKit environment.');
+    }
+    return ctx;
+}
+function runInAiWorkerContext(ctx, message, callback) {
+    return worker.run({ message, ctx }, callback);
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYWktY29udGV4dC13b3JrZXIuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zcmMvYWktY29udGV4dC13b3JrZXIudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7QUFNQSxnREFVQztBQUVELG9EQU1DO0FBdkJELHVEQUFxRDtBQUdyRCxNQUFNLE1BQU0sR0FBRyxJQUFJLG9DQUFpQixFQUF3QyxDQUFDO0FBRTdFLFNBQWdCLGtCQUFrQjtJQUNoQyxNQUFNLEdBQUcsR0FBRyxNQUFNLENBQUMsUUFBUSxFQUFFLENBQUM7SUFFOUIsSUFBSSxDQUFDLEdBQUcsRUFBRSxDQUFDO1FBQ1QsTUFBTSxJQUFJLEtBQUssQ0FDYixtRkFBbUYsQ0FDcEYsQ0FBQztJQUNKLENBQUM7SUFFRCxPQUFPLEdBQUcsQ0FBQztBQUNiLENBQUM7QUFFRCxTQUFnQixvQkFBb0IsQ0FDbEMsR0FBYyxFQUNkLE9BQWdCLEVBQ2hCLFFBQVc7SUFFWCxPQUFPLE1BQU0sQ0FBQyxHQUFHLENBQUMsRUFBRSxPQUFPLEVBQUUsR0FBRyxFQUFFLEVBQUUsUUFBUSxDQUFDLENBQUM7QUFDaEQsQ0FBQyJ9

package/dist/context.d.ts

@@ -0,0 +1,15 @@
+import type { CommandKit } from 'commandkit';
+import { Client, Message } from 'discord.js';
+export interface AiContextOptions<T extends Record<string, unknown> = Record<string, unknown>> {
+    message: Message;
+    params: T;
+    commandkit: CommandKit;
+}
+export declare class AiContext<T extends Record<string, unknown> = Record<string, unknown>> {
+    params: T;
+    message: Message;
+    client: Client;
+    commandkit: CommandKit;
+    constructor(options: AiContextOptions<T>);
+    setParams(params: T): void;
+}

package/dist/context.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AiContext = void 0;
+class AiContext {
+    constructor(options) {
+        this.params = options.params;
+        this.message = options.message;
+        this.commandkit = options.commandkit;
+        this.client = options.commandkit.client;
+    }
+    setParams(params) {
+        this.params = params;
+    }
+}
+exports.AiContext = AiContext;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY29udGV4dC5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3NyYy9jb250ZXh0LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7OztBQVdBLE1BQWEsU0FBUztJQVFwQixZQUFtQixPQUE0QjtRQUM3QyxJQUFJLENBQUMsTUFBTSxHQUFHLE9BQU8sQ0FBQyxNQUFNLENBQUM7UUFDN0IsSUFBSSxDQUFDLE9BQU8sR0FBRyxPQUFPLENBQUMsT0FBTyxDQUFDO1FBQy9CLElBQUksQ0FBQyxVQUFVLEdBQUcsT0FBTyxDQUFDLFVBQVUsQ0FBQztRQUNyQyxJQUFJLENBQUMsTUFBTSxHQUFHLE9BQU8sQ0FBQyxVQUFVLENBQUMsTUFBTSxDQUFDO0lBQzFDLENBQUM7SUFFTSxTQUFTLENBQUMsTUFBUztRQUN4QixJQUFJLENBQUMsTUFBTSxHQUFHLE1BQU0sQ0FBQztJQUN2QixDQUFDO0NBQ0Y7QUFsQkQsOEJBa0JDIn0=

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+import { AiPlugin } from './plugin';
+import { AiPluginOptions } from './types';
+export declare function ai(options?: AiPluginOptions): AiPlugin;
+export * from './types';
+export * from './plugin';
+export * from './context';

package/dist/index.js

@@ -0,0 +1,25 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ai = ai;
+const plugin_1 = require("./plugin");
+function ai(options) {
+    return new plugin_1.AiPlugin(options ?? {});
+}
+__exportStar(require("./types"), exports);
+__exportStar(require("./plugin"), exports);
+__exportStar(require("./context"), exports);
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zcmMvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7Ozs7Ozs7Ozs7Ozs7OztBQUdBLGdCQUVDO0FBTEQscUNBQW9DO0FBR3BDLFNBQWdCLEVBQUUsQ0FBQyxPQUF5QjtJQUMxQyxPQUFPLElBQUksaUJBQVEsQ0FBQyxPQUFPLElBQUksRUFBRSxDQUFDLENBQUM7QUFDckMsQ0FBQztBQUVELDBDQUF3QjtBQUN4QiwyQ0FBeUI7QUFDekIsNENBQTBCIn0=

package/dist/plugin.d.ts

@@ -0,0 +1,27 @@
+import { CommandKitPluginRuntime, RuntimePlugin } from 'commandkit/plugin';
+import { AiPluginOptions, MessageFilter, SelectAiModel } from './types';
+import { Message } from 'discord.js';
+export interface AiConfig {
+    description?: string;
+    parameters: any;
+}
+export interface ConfigureAI {
+    messageFilter?: MessageFilter;
+    selectAiModel?: SelectAiModel;
+    systemPrompt?: (message: Message) => Promise<string>;
+}
+export declare function configureAI(config: ConfigureAI): void;
+export declare class AiPlugin extends RuntimePlugin<AiPluginOptions> {
+    readonly name = "AiPlugin";
+    private toolsRecord;
+    private defaultTools;
+    private onMessageFunc;
+    constructor(options: AiPluginOptions);
+    activate(ctx: CommandKitPluginRuntime): Promise<void>;
+    private createDefaultTools;
+    deactivate(ctx: CommandKitPluginRuntime): Promise<void>;
+    private handleMessage;
+    private startTyping;
+    onBeforeCommandsLoad(ctx: CommandKitPluginRuntime): Promise<void>;
+    onAfterCommandsLoad(ctx: CommandKitPluginRuntime): Promise<void>;
+}

package/dist/plugin.js

@@ -0,0 +1,254 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AiPlugin = void 0;
+exports.configureAI = configureAI;
+const plugin_1 = require("commandkit/plugin");
+const commandkit_1 = require("commandkit");
+const context_1 = require("./context");
+const discord_js_1 = require("discord.js");
+const ai_1 = require("ai");
+const zod_1 = require("zod");
+const ai_context_worker_1 = require("./ai-context-worker");
+let messageFilter = null;
+let selectAiModel = null;
+let generateSystemPrompt;
+function configureAI(config) {
+    if (config.messageFilter) {
+        messageFilter = config.messageFilter;
+    }
+    if (config.selectAiModel) {
+        selectAiModel = config.selectAiModel;
+    }
+    if (config.systemPrompt) {
+        generateSystemPrompt = config.systemPrompt;
+    }
+}
+class AiPlugin extends plugin_1.RuntimePlugin {
+    constructor(options) {
+        super(options);
+        this.name = 'AiPlugin';
+        this.toolsRecord = {};
+        this.defaultTools = {};
+        this.onMessageFunc = null;
+    }
+    async activate(ctx) {
+        this.onMessageFunc = (message) => this.handleMessage(ctx, message);
+        ctx.commandkit.client.on(discord_js_1.Events.MessageCreate, this.onMessageFunc);
+        this.createDefaultTools(ctx);
+        commandkit_1.Logger.info(`Plugin ${this.name} activated`);
+    }
+    createDefaultTools(ctx) {
+        const { commandkit } = ctx;
+        const client = commandkit.client;
+        this.defaultTools.getUserById = (0, ai_1.tool)({
+            description: 'Get user information by ID',
+            parameters: zod_1.z.object({
+                userId: zod_1.z
+                    .string()
+                    .describe('The ID of the user to retrieve. This is a Discord snowflake string.'),
+            }),
+            execute: async (params) => {
+                const user = await client.users.fetch(params.userId, {
+                    force: false,
+                    cache: true,
+                });
+                return user.toJSON();
+            },
+        });
+        this.defaultTools.getChannelById = (0, ai_1.tool)({
+            description: 'Get channel information by ID',
+            parameters: zod_1.z.object({
+                channelId: zod_1.z
+                    .string()
+                    .describe('The ID of the channel to retrieve. This is a Discord snowflake string.'),
+            }),
+            execute: async (params) => {
+                const channel = await client.channels.fetch(params.channelId, {
+                    force: false,
+                    cache: true,
+                });
+                if (!channel) {
+                    throw new Error(`Channel with ID ${params.channelId} not found.`);
+                }
+                return channel.toJSON();
+            },
+        });
+        this.defaultTools.getGuildById = (0, ai_1.tool)({
+            description: 'Get guild information by ID',
+            parameters: zod_1.z.object({
+                guildId: zod_1.z
+                    .string()
+                    .describe('The ID of the guild to retrieve. This is a Discord snowflake string.'),
+            }),
+            execute: async (params) => {
+                const guild = await client.guilds.fetch({
+                    guild: params.guildId,
+                    force: false,
+                    cache: true,
+                });
+                if (!guild) {
+                    throw new Error(`Guild with ID ${params.guildId} not found.`);
+                }
+                return {
+                    id: guild.id,
+                    name: guild.name,
+                    icon: guild.iconURL(),
+                    memberCount: guild.memberCount,
+                };
+            },
+        });
+        this.defaultTools.getCurrentUser = (0, ai_1.tool)({
+            description: 'Get information about the current discord bot user',
+            parameters: zod_1.z.object({}),
+            execute: async () => {
+                const user = client.user;
+                if (!user) {
+                    throw new Error('Bot user is not available.');
+                }
+                return user.toJSON();
+            },
+        });
+        this.defaultTools.getAvailableCommands = (0, ai_1.tool)({
+            description: 'Get all available commands',
+            parameters: zod_1.z.object({}),
+            execute: async () => {
+                return ctx.commandkit.commandHandler.getCommandsArray().map((cmd) => ({
+                    name: cmd.data.command.name,
+                    description: cmd.data.command.description,
+                    category: cmd.command.category,
+                }));
+            },
+        });
+    }
+    async deactivate(ctx) {
+        this.toolsRecord = {};
+        if (this.onMessageFunc) {
+            ctx.commandkit.client.off(discord_js_1.Events.MessageCreate, this.onMessageFunc);
+            this.onMessageFunc = null;
+        }
+        commandkit_1.Logger.info(`Plugin ${this.name} deactivated`);
+    }
+    async handleMessage(pluginContext, message) {
+        if (message.author.bot || !Object.keys(this.toolsRecord).length)
+            return;
+        const aiModelSelector = selectAiModel;
+        if (!message.content?.length || !aiModelSelector)
+            return;
+        if (!message.channel.isTextBased() || !message.channel.isSendable())
+            return;
+        const shouldContinue = messageFilter ? await messageFilter(message) : true;
+        if (!shouldContinue)
+            return;
+        const ctx = new context_1.AiContext({
+            message,
+            params: {},
+            commandkit: pluginContext.commandkit,
+        });
+        const systemPrompt = (await generateSystemPrompt?.(message)) ||
+            `You are a helpful AI discord bot. Your name is ${message.client.user.username} and your id is ${message.client.user.id}.
+      You are designed to assist users with their questions and tasks. You also have access to various tools that can help you perform tasks.
+      Tools are basically like commands that you can execute to perform specific actions based on user input.
+      Keep the response short and concise, and only use tools when necessary. Keep the response length under 2000 characters.
+      Do not include your own text in the response unless necessary. For text formatting, you can use discord's markdown syntax.
+      ${message.inGuild() ? `\nYou are currently in a guild named ${message.guild.name} whose id is ${message.guildId}. While in guild, you can fetch member information if needed.` : '\nYou are currently in a direct message with the user.'}`;
+        const userInfo = `<user>
+    <id>${message.author.id}</id>
+    <name>${message.author.username}</name>
+    <displayName>${message.author.displayName}</displayName>
+    <avatar>${message.author.avatarURL()}</avatar>
+    </user>`;
+        await (0, ai_context_worker_1.runInAiWorkerContext)(ctx, message, async () => {
+            const channel = message.channel;
+            const stopTyping = await this.startTyping(channel);
+            try {
+                const { model, options } = await aiModelSelector(message);
+                const result = await (0, ai_1.generateText)({
+                    abortSignal: AbortSignal.timeout(60000),
+                    model,
+                    tools: { ...this.toolsRecord, ...this.defaultTools },
+                    prompt: `${userInfo}\nUser: ${message.content}\nAI:`,
+                    system: systemPrompt,
+                    maxSteps: 5,
+                    providerOptions: options,
+                });
+                stopTyping();
+                if (!!result.text) {
+                    await message.reply({
+                        content: result.text,
+                        allowedMentions: { parse: [] },
+                    });
+                }
+            }
+            catch (e) {
+                commandkit_1.Logger.error(`Error processing AI message: ${e}`);
+                const channel = message.channel;
+                if (channel.isSendable()) {
+                    await message
+                        .reply({
+                        content: 'An error occurred while processing your request.',
+                        allowedMentions: { parse: [] },
+                    })
+                        .catch((e) => commandkit_1.Logger.error(`Failed to send error message: ${e}`));
+                }
+            }
+            finally {
+                stopTyping();
+            }
+        });
+    }
+    async startTyping(channel) {
+        let stopped = false;
+        const runner = async () => {
+            if (stopped)
+                return clearInterval(typingInterval);
+            if (channel.isSendable()) {
+                await channel.sendTyping().catch(Object);
+            }
+        };
+        const typingInterval = setInterval(runner, 3000).unref();
+        await runner();
+        return () => {
+            stopped = true;
+            clearInterval(typingInterval);
+        };
+    }
+    async onBeforeCommandsLoad(ctx) {
+        this.toolsRecord = {};
+    }
+    async onAfterCommandsLoad(ctx) {
+        const commands = ctx.commandkit.commandHandler
+            .getCommandsArray()
+            .filter((command) => 'ai' in command.data &&
+            typeof command.data.ai === 'function' &&
+            'aiConfig' in command.data);
+        if (!commands.length) {
+            commandkit_1.Logger.warn('No commands with AI functionality found. Ensure commands are properly configured.');
+            return;
+        }
+        const tools = new discord_js_1.Collection();
+        for (const command of commands) {
+            const cmd = command;
+            if (!cmd.data.ai || !cmd.data.aiConfig) {
+                continue;
+            }
+            const description = cmd.data.aiConfig.description || cmd.data.command.description;
+            const cmdTool = (0, ai_1.tool)({
+                description,
+                type: 'function',
+                parameters: cmd.data.aiConfig.parameters,
+                async execute(params) {
+                    const ctx = (0, ai_context_worker_1.getAiWorkerContext)();
+                    ctx.ctx.setParams(params);
+                    return cmd.data.ai(ctx.ctx);
+                },
+            });
+            cmd.tool = cmdTool;
+            tools.set(cmd.command.name, cmd);
+        }
+        this.toolsRecord = Object.fromEntries(tools.map((toolCmd) => {
+            return [toolCmd.command.name, toolCmd.tool];
+        }));
+    }
+}
+exports.AiPlugin = AiPlugin;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicGx1Z2luLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vc3JjL3BsdWdpbi50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7QUFnQ0Esa0NBWUM7QUE1Q0QsOENBQTJFO0FBRTNFLDJDQUFtRDtBQUNuRCx1Q0FBc0M7QUFDdEMsMkNBQXNFO0FBQ3RFLDJCQUE4QztBQUM5Qyw2QkFBd0I7QUFDeEIsMkRBQStFO0FBZS9FLElBQUksYUFBYSxHQUF5QixJQUFJLENBQUM7QUFDL0MsSUFBSSxhQUFhLEdBQXlCLElBQUksQ0FBQztBQUMvQyxJQUFJLG9CQUF5RSxDQUFDO0FBUTlFLFNBQWdCLFdBQVcsQ0FBQyxNQUFtQjtJQUM3QyxJQUFJLE1BQU0sQ0FBQyxhQUFhLEVBQUUsQ0FBQztRQUN6QixhQUFhLEdBQUcsTUFBTSxDQUFDLGFBQWEsQ0FBQztJQUN2QyxDQUFDO0lBRUQsSUFBSSxNQUFNLENBQUMsYUFBYSxFQUFFLENBQUM7UUFDekIsYUFBYSxHQUFHLE1BQU0sQ0FBQyxhQUFhLENBQUM7SUFDdkMsQ0FBQztJQUVELElBQUksTUFBTSxDQUFDLFlBQVksRUFBRSxDQUFDO1FBQ3hCLG9CQUFvQixHQUFHLE1BQU0sQ0FBQyxZQUFZLENBQUM7SUFDN0MsQ0FBQztBQUNILENBQUM7QUFFRCxNQUFhLFFBQVMsU0FBUSxzQkFBOEI7SUFNMUQsWUFBbUIsT0FBd0I7UUFDekMsS0FBSyxDQUFDLE9BQU8sQ0FBQyxDQUFDO1FBTkQsU0FBSSxHQUFHLFVBQVUsQ0FBQztRQUMxQixnQkFBVyxHQUF5QixFQUFFLENBQUM7UUFDdkMsaUJBQVksR0FBeUIsRUFBRSxDQUFDO1FBQ3hDLGtCQUFhLEdBQWlELElBQUksQ0FBQztJQUkzRSxDQUFDO0lBRU0sS0FBSyxDQUFDLFFBQVEsQ0FBQyxHQUE0QjtRQUNoRCxJQUFJLENBQUMsYUFBYSxHQUFHLENBQUMsT0FBTyxFQUFFLEVBQUUsQ0FBQyxJQUFJLENBQUMsYUFBYSxDQUFDLEdBQUcsRUFBRSxPQUFPLENBQUMs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

package/dist/types.d.ts

@@ -0,0 +1,12 @@
+import { LanguageModelV1, ProviderMetadata } from 'ai';
+import { Message } from 'discord.js';
+import { AiContext } from './context';
+export type CommandFilterFunction = (commandName: string) => boolean;
+export type MessageFilter = (message: Message) => Promise<boolean>;
+export type SelectAiModel = (message: Message) => Promise<{
+    model: LanguageModelV1;
+    options?: ProviderMetadata;
+}>;
+export interface AiPluginOptions {
+}
+export type AiCommand<T extends Record<string, unknown>> = (ctx: AiContext<T>) => Promise<unknown> | unknown;

package/dist/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidHlwZXMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zcmMvdHlwZXMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IiJ9

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@commandkit/ai",
+  "version": "0.1.0-dev.20250609135507",
+  "description": "Supercharge your CommandKit bot with AI capabilities",
+  "files": [
+    "dist"
+  ],
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/underctrl-io/commandkit.git"
+  },
+  "keywords": [
+    "commandkit",
+    "ai"
+  ],
+  "author": "twilight <hello@twlite.dev>",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/underctrl-io/commandkit/issues"
+  },
+  "homepage": "https://github.com/underctrl-io/commandkit#readme",
+  "devDependencies": {
+    "discord.js": "^14.19.3",
+    "typescript": "^5.7.3",
+    "commandkit": "1.0.0-dev.20250609135507",
+    "tsconfig": "0.0.0-dev.20250609135507"
+  },
+  "dependencies": {
+    "ai": "^4.3.16",
+    "zod": "^3.25.48"
+  },
+  "scripts": {
+    "lint": "tsc --noEmit",
+    "build": "tsc"
+  }
+}