actient 1.0.0

package/LICENSE

@@ -0,0 +1,7 @@
+Copyright © 2026 <copyright holders>
+
+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,165 @@
+# Actient
+
+Connect and run your functions with your favorite AI easier.
+
+### In this page
+
+- [Get Started](#get-started)
+- [How it's work](#how-its-work)
+- [References](#references)
+  - [Supported SDK](#our-supported-sdk)
+  - [AI Agent](#ai-agent)
+  - [registerAction()](#registeraction)
+  - [execute()](#execute)
+- [Best Practices](#best-practices)
+  - [Unknown action](#unknown-action)
+  - [Specific rules](#specific-rules)
+- [Typescript Support](#typescript-support)
+
+## Get started
+
+Install package:
+
+```bash
+npm install actient zod openai
+```
+
+## How it's work?
+
+```js
+import { AIAgent } from "actient";
+import { OpenAIIntentParser } from "actient/providers/openai";
+import { z } from "zod";
+
+// define ai agent
+const agent = new AIAgent({
+  ai: new OpenAIIntentParser({
+    apiKey: "your_api_key",
+    model: "ai-model",
+  }),
+});
+
+// register your function as action
+agent.registerAction("increase_stock", {
+  description: "Add product stock",
+  schema: z.object({
+    name: z.string(),
+    amount: z.number().positive(),
+  }),
+  handler: async ({ name, amount }) => {
+    // you can create simple or complex logic here
+    return prisma.product.updateMany({
+      where: { name: { contains: name, mode: "insensitive" } },
+      data: { stock: { increment: amount } },
+    });
+  },
+});
+
+// it will execute action to update your product stock
+agent.execute("Can you add 5 units of stock to my product named monitor?");
+```
+
+## References
+
+This section documents the main function provided by `actient`, including the core agent, intent parser, and available AI providers.
+
+### Our supported SDK:
+
+You need to install the SDK before using this library. Use the intent parser importing from `actient/providers/*` to setup your AI.
+
+| Provider | SDK             | Intent Parser                                                  |
+| -------- | --------------- | -------------------------------------------------------------- |
+| Open AI  | `openai`        | `OpenAIIntentParser`, imported from `actient/providers/openai` |
+| Groq     | `grok-sdk`      | `GroqIntentParser`, imported from `actient/providers/groq`     |
+| Gemini   | `@google/genai` | `GeminiIntentParser`, imported from `actient/providers/gemini` |
+
+### AI Agent
+
+You can define and select your ai agent using `AIAgent` instance.
+
+```js
+const agent = new AIAgent({
+  ai: new OpenAIIntentParser({
+    apiKey: "your_api_key", // api key from ai provider
+    model: "ai-model",
+  }),
+});
+```
+
+#### Options
+
+| Name | Desciption                                                                               |
+| ---- | ---------------------------------------------------------------------------------------- |
+| ai   | Define your selected ai intent parser. See our supported intent parser to get the detail |
+
+### registerAction()
+
+Registers actions that can be executed by the agent.
+
+```js
+agent.registerAction("action_identifier", {
+  description: "Action description",
+  rules: ["specific rule"],
+  schema: z.object({
+    params: z.string(),
+  }),
+  handler: async ({ params }) => {
+    // you can create simple or complex logic here
+    return `Success to execute: ${params}`;
+  },
+});
+```
+
+#### Options
+
+| Name         | Type            | Required | Desciption                                                           |
+| ------------ | --------------- | -------- | -------------------------------------------------------------------- |
+| \_identifier | string          | ✅       | Unique action identifier (used by AI to recognize the functions)     |
+| description  | string          | ✅       | Brief explanation of the action function (used in the system prompt) |
+| rules        | array of string | ❌       | Specific rules for the action                                        |
+| schema       | ZodSchema       | ✅       | Zod schema for action parameter validation                           |
+| handler      | function        | ✅       | Async function that will be executed by AI                           |
+
+### execute()
+
+Runs agent based on user input.
+
+```js
+const result = await agent.execute("User prompt");
+```
+
+## Best Practices
+
+This section outlines recommended best practices to help you build reliable, maintainable, and predictable AI-driven actions using this library.
+
+### Unknown Action
+
+The AI ​​will only execute the appropriate action. If no appropriate action is found, it will treat it as `UNKNOWN`. You can handle this by defining a register with the identifier as `UNKNOWN`.
+
+```js
+agent.registerAction("UNKNOWN", {
+  description: "Default handler for unknown intents",
+  rules: ["Handle unknown intents gracefully and inform the user."],
+  schema: z.object({
+    message: z.string(),
+  }),
+  handler: async ({ message }) => {
+    return { message };
+  },
+});
+```
+
+### Specific rules
+
+Add specific rules to ensure the AI ​​works properly and prevent the AI ​​from deviating from its task.
+
+```js
+agent.registerAction("action", {
+  rules: ["rule 1", "rule 2"],
+  // ...
+});
+```
+
+## Typescript Support
+
+This library is completely written and maintained using typescript.

package/dist/chunk-UNGR3PLJ.js

@@ -0,0 +1,72 @@
+// src/utils/prompt.ts
+var generateSystemPrompt = (actions) => {
+  return `
+You are an intent parser.
+
+Your task is to translate user input into a structured JSON intent.
+
+Available actions:
+${actions.map(
+    (a) => `- ${a.name}: ${a.description}
+  Parameters:
+${Object.entries(a.parameters).map(([key, type]) => `    - ${key}: ${type}`).join("\n")}
+  Specific rules: ${a.rules?.length ? a.rules.map((r) => `    - ${r}`).join("\n") : "    - None"}
+  `
+  ).join("\n")}
+
+  
+Rules:
+- Respond ONLY with valid JSON
+- Do NOT include markdown
+- Do NOT explain anything
+- Do NOT invent actions
+- Only use actions listed above
+- Parameter names MUST exactly match the schema
+- Do NOT rename parameters
+- Do NOT invent parameters
+- JSON format:
+{
+  "action": "action_name",
+  "params": { ... }
+}
+
+If no action matches, return:
+{
+  "action": "UNKNOWN",
+  "params": {}
+}
+`.trim();
+};
+
+// src/utils/loader.ts
+async function loadGemini() {
+  try {
+    return await import('@google/genai');
+  } catch {
+    throw new Error(
+      "Gemini support requires `@google/genai`. Install it with:\nnpm install @google/genai"
+    );
+  }
+}
+async function loadOpenAI() {
+  try {
+    return await import('openai');
+  } catch {
+    throw new Error(
+      "OpenAI support requires `openai`. Install it with:\nnpm install openai"
+    );
+  }
+}
+async function loadGroq() {
+  try {
+    return await import('groq-sdk');
+  } catch {
+    throw new Error(
+      "Groq support requires `groq-sdk`. Install it with:\nnpm install groq-sdk"
+    );
+  }
+}
+
+export { generateSystemPrompt, loadGemini, loadGroq, loadOpenAI };
+//# sourceMappingURL=chunk-UNGR3PLJ.js.map
+//# sourceMappingURL=chunk-UNGR3PLJ.js.map

package/dist/chunk-UNGR3PLJ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/utils/prompt.ts","../src/utils/loader.ts"],"names":[],"mappings":";AAEO,IAAM,oBAAA,GAAuB,CAAC,OAAA,KAAuC;AAC1E,EAAA,OAAO;AAAA;;AAAA;;AAAA;AAAA,EAMP,OAAA,CACC,GAAA;AAAA,IACC,CAAC,CAAA,KAAM,CAAA,EAAA,EAAK,EAAE,IAAI,CAAA,EAAA,EAAK,EAAE,WAAW;AAAA;AAAA,EAEtC,OAAO,OAAA,CAAQ,CAAA,CAAE,UAAU,CAAA,CAC1B,GAAA,CAAI,CAAC,CAAC,GAAA,EAAK,IAAI,CAAA,KAAM,CAAA,MAAA,EAAS,GAAG,CAAA,EAAA,EAAK,IAAI,EAAE,CAAA,CAC5C,IAAA,CAAK,IAAI,CAAC;AAAA,kBAAA,EAET,CAAA,CAAE,KAAA,EAAO,MAAA,GAAS,CAAA,CAAE,MAAM,GAAA,CAAI,CAAC,CAAA,KAAM,CAAA,MAAA,EAAS,CAAC,CAAA,CAAE,CAAA,CAAE,IAAA,CAAK,IAAI,IAAI,YAClE;AAAA,EAAA;AAAA,GAEA,CACC,IAAA,CAAK,IAAI,CAAC;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,CAAA,CAuBX,IAAA,EAAK;AACP;;;AC7CA,eAAsB,UAAA,GAAa;AACjC,EAAA,IAAI;AACF,IAAA,OAAO,MAAM,OAAO,eAAe,CAAA;AAAA,EACrC,CAAA,CAAA,MAAQ;AACN,IAAA,MAAM,IAAI,KAAA;AAAA,MACR;AAAA,KAEF;AAAA,EACF;AACF;AAEA,eAAsB,UAAA,GAAa;AACjC,EAAA,IAAI;AACF,IAAA,OAAO,MAAM,OAAO,QAAQ,CAAA;AAAA,EAC9B,CAAA,CAAA,MAAQ;AACN,IAAA,MAAM,IAAI,KAAA;AAAA,MACR;AAAA,KAEF;AAAA,EACF;AACF;AAEA,eAAsB,QAAA,GAAW;AAC/B,EAAA,IAAI;AACF,IAAA,OAAO,MAAM,OAAO,UAAU,CAAA;AAAA,EAChC,CAAA,CAAA,MAAQ;AACN,IAAA,MAAM,IAAI,KAAA;AAAA,MACR;AAAA,KAEF;AAAA,EACF;AACF","file":"chunk-UNGR3PLJ.js","sourcesContent":["import type { AvailableAction } from \"../intent/intent-parser\";\r\n\r\nexport const generateSystemPrompt = (actions: AvailableAction[]): string => {\r\n  return `\r\nYou are an intent parser.\r\n\r\nYour task is to translate user input into a structured JSON intent.\r\n\r\nAvailable actions:\r\n${actions\r\n  .map(\r\n    (a) => `- ${a.name}: ${a.description}\r\n  Parameters:\r\n${Object.entries(a.parameters)\r\n  .map(([key, type]) => `    - ${key}: ${type}`)\r\n  .join(\"\\n\")}\r\n  Specific rules: ${\r\n    a.rules?.length ? a.rules.map((r) => `    - ${r}`).join(\"\\n\") : \"    - None\"\r\n  }\r\n  `\r\n  )\r\n  .join(\"\\n\")}\r\n\r\n  \r\nRules:\r\n- Respond ONLY with valid JSON\r\n- Do NOT include markdown\r\n- Do NOT explain anything\r\n- Do NOT invent actions\r\n- Only use actions listed above\r\n- Parameter names MUST exactly match the schema\r\n- Do NOT rename parameters\r\n- Do NOT invent parameters\r\n- JSON format:\r\n{\r\n  \"action\": \"action_name\",\r\n  \"params\": { ... }\r\n}\r\n\r\nIf no action matches, return:\r\n{\r\n  \"action\": \"UNKNOWN\",\r\n  \"params\": {}\r\n}\r\n`.trim();\r\n};\r\n","export async function loadGemini() {\r\n  try {\r\n    return await import(\"@google/genai\");\r\n  } catch {\r\n    throw new Error(\r\n      \"Gemini support requires `@google/genai`. Install it with:\\n\" +\r\n        \"npm install @google/genai\"\r\n    );\r\n  }\r\n}\r\n\r\nexport async function loadOpenAI() {\r\n  try {\r\n    return await import(\"openai\");\r\n  } catch {\r\n    throw new Error(\r\n      \"OpenAI support requires `openai`. Install it with:\\n\" +\r\n        \"npm install openai\"\r\n    );\r\n  }\r\n}\r\n\r\nexport async function loadGroq() {\r\n  try {\r\n    return await import(\"groq-sdk\");\r\n  } catch {\r\n    throw new Error(\r\n      \"Groq support requires `groq-sdk`. Install it with:\\n\" +\r\n        \"npm install groq-sdk\"\r\n    );\r\n  }\r\n}\r\n"]}

package/dist/index.d.ts

@@ -0,0 +1,22 @@
+import { I as Intent, a as IntentParser } from './intent-parser-tPkUA2YT.js';
+import { ZodSchema } from 'zod';
+
+interface AIProvider {
+    parseIntent(prompt: string, availableActions: any[]): Promise<Intent>;
+}
+declare class AIAgent {
+    private registry;
+    private intentParser;
+    constructor(options: {
+        ai: IntentParser;
+    });
+    registerAction<TParams, TResult>(name: string, config: {
+        description: string;
+        rules?: string[];
+        schema: ZodSchema<TParams>;
+        handler: (params: TParams) => Promise<TResult>;
+    }): void;
+    execute(prompt: string): Promise<any>;
+}
+
+export { AIAgent, type AIProvider };

package/dist/index.js

@@ -0,0 +1,86 @@
+import { z } from 'zod';
+
+// src/registry/action-registry.ts
+var ActionRegistry = class {
+  actions = /* @__PURE__ */ new Map();
+  register(name, action) {
+    if (this.actions.has(name)) {
+      throw new Error(`Action "${name}" already registered`);
+    }
+    this.actions.set(name, action);
+  }
+  get(name) {
+    const action = this.actions.get(name);
+    if (!action) {
+      throw new Error(`Action "${name}" is not registered`);
+    }
+    return action;
+  }
+  list() {
+    return Array.from(this.actions.entries()).map(([name, action]) => ({
+      name,
+      rules: action.rules || [],
+      description: action.description,
+      parameters: this.zodToSimpleSchema(action.schema)
+    }));
+  }
+  has(name) {
+    return this.actions.has(name);
+  }
+  zodToSimpleSchema(schema) {
+    if (!(schema instanceof z.ZodObject)) {
+      return {};
+    }
+    const shape = schema.shape;
+    const result = {};
+    for (const key in shape) {
+      const field = shape[key];
+      result[key] = this.mapZodType(field);
+    }
+    return result;
+  }
+  mapZodType(field) {
+    if (field instanceof z.ZodOptional || field instanceof z.ZodNullable) {
+      return this.mapZodType(field.unwrap());
+    }
+    if (field instanceof z.ZodString) return "string";
+    if (field instanceof z.ZodNumber) return "number";
+    if (field instanceof z.ZodBoolean) return "boolean";
+    if (field instanceof z.ZodArray) return "array";
+    if (field instanceof z.ZodEnum) return "enum";
+    if (field instanceof z.ZodObject) return "object";
+    return "unknown";
+  }
+};
+
+// src/agent.ts
+var AIAgent = class {
+  registry;
+  intentParser;
+  constructor(options) {
+    this.registry = new ActionRegistry();
+    this.intentParser = options.ai;
+  }
+  registerAction(name, config) {
+    this.registry.register(name, config);
+  }
+  async execute(prompt) {
+    const availableActions = this.registry.list();
+    const intent = await this.intentParser.parse(prompt, availableActions);
+    if (!intent?.action) {
+      throw new Error("Invalid intent: missing action");
+    }
+    const action = this.registry.get(intent.action);
+    if (intent.action === "UNKNOWN" && !action) {
+      throw new Error(
+        "Unable to determine user intent, please define a default action."
+      );
+    }
+    const validatedParams = action.schema.parse(intent.params);
+    return action.handler(validatedParams);
+  }
+};
+
+export { AIAgent };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/registry/action-registry.ts","../src/agent.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import type { ZodSchema } from \"zod\";\r\nimport { z } from \"zod\";\r\n\r\nexport type ActionHandler<TParams = any, TResult = any> = (\r\n  params: TParams\r\n) => Promise<TResult>;\r\n\r\nexport interface ActionDefinition<TParams = any, TResult = any> {\r\n  description: string;\r\n  rules?: string[];\r\n  schema: ZodSchema<TParams>;\r\n  handler: ActionHandler<TParams, TResult>;\r\n}\r\n\r\nexport class ActionRegistry {\r\n  private actions = new Map<string, ActionDefinition>();\r\n\r\n  register<TParams, TResult>(\r\n    name: string,\r\n    action: ActionDefinition<TParams, TResult>\r\n  ) {\r\n    if (this.actions.has(name)) {\r\n      throw new Error(`Action \"${name}\" already registered`);\r\n    }\r\n\r\n    this.actions.set(name, action);\r\n  }\r\n\r\n  get(name: string): ActionDefinition {\r\n    const action = this.actions.get(name);\r\n\r\n    if (!action) {\r\n      throw new Error(`Action \"${name}\" is not registered`);\r\n    }\r\n\r\n    return action;\r\n  }\r\n\r\n  list(): Array<{\r\n    name: string;\r\n    rules: string[];\r\n    description: string;\r\n    parameters: Record<string, string>;\r\n  }> {\r\n    return Array.from(this.actions.entries()).map(([name, action]) => ({\r\n      name,\r\n      rules: action.rules || [],\r\n      description: action.description,\r\n      parameters: this.zodToSimpleSchema(action.schema),\r\n    }));\r\n  }\r\n\r\n  has(name: string): boolean {\r\n    return this.actions.has(name);\r\n  }\r\n\r\n  private zodToSimpleSchema(schema: ZodSchema<any>) {\r\n    if (!(schema instanceof z.ZodObject)) {\r\n      return {};\r\n    }\r\n\r\n    const shape = schema.shape;\r\n    const result: Record<string, string> = {};\r\n\r\n    for (const key in shape) {\r\n      const field = shape[key];\r\n\r\n      result[key] = this.mapZodType(field);\r\n    }\r\n\r\n    return result;\r\n  }\r\n\r\n  private mapZodType(field: any): string {\r\n    // unwrap optional / nullable\r\n    if (field instanceof z.ZodOptional || field instanceof z.ZodNullable) {\r\n      return this.mapZodType(field.unwrap());\r\n    }\r\n\r\n    if (field instanceof z.ZodString) return \"string\";\r\n    if (field instanceof z.ZodNumber) return \"number\";\r\n    if (field instanceof z.ZodBoolean) return \"boolean\";\r\n    if (field instanceof z.ZodArray) return \"array\";\r\n    if (field instanceof z.ZodEnum) return \"enum\";\r\n    if (field instanceof z.ZodObject) return \"object\";\r\n\r\n    return \"unknown\";\r\n  }\r\n}\r\n","import {\r\n  ActionRegistry,\r\n  // ActionDefinition,\r\n} from \"./registry/action-registry\";\r\nimport type { IntentParser } from \"./intent/intent-parser\";\r\nimport type { ZodSchema } from \"zod\";\r\nimport type { Intent } from \"./types/intent\";\r\n\r\nexport interface AIProvider {\r\n  parseIntent(prompt: string, availableActions: any[]): Promise<Intent>;\r\n}\r\n\r\nexport class AIAgent {\r\n  private registry: ActionRegistry;\r\n  private intentParser: IntentParser;\r\n\r\n  constructor(options: { ai: IntentParser }) {\r\n    this.registry = new ActionRegistry();\r\n    this.intentParser = options.ai;\r\n  }\r\n\r\n  registerAction<TParams, TResult>(\r\n    name: string,\r\n    config: {\r\n      description: string;\r\n      rules?: string[];\r\n      schema: ZodSchema<TParams>;\r\n      handler: (params: TParams) => Promise<TResult>;\r\n    }\r\n  ) {\r\n    this.registry.register(name, config);\r\n  }\r\n\r\n  async execute(prompt: string): Promise<any> {\r\n    const availableActions = this.registry.list();\r\n    const intent = await this.intentParser.parse(prompt, availableActions);\r\n\r\n    if (!intent?.action) {\r\n      throw new Error(\"Invalid intent: missing action\");\r\n    }\r\n\r\n    const action = this.registry.get(intent.action);\r\n\r\n    if (intent.action === \"UNKNOWN\" && !action) {\r\n      throw new Error(\r\n        \"Unable to determine user intent, please define a default action.\"\r\n      );\r\n    }\r\n\r\n    const validatedParams = action.schema.parse(intent.params);\r\n    return action.handler(validatedParams);\r\n  }\r\n}\r\n"]}

package/dist/intent-parser-tPkUA2YT.d.ts

@@ -0,0 +1,16 @@
+interface Intent {
+    action: string;
+    params: Record<string, any>;
+}
+
+interface AvailableAction {
+    name: string;
+    rules?: string[];
+    description: string;
+    parameters: Record<string, string>;
+}
+interface IntentParser {
+    parse(prompt: string, actions: AvailableAction[]): Promise<Intent>;
+}
+
+export type { AvailableAction as A, Intent as I, IntentParser as a };

package/dist/providers/gemini.d.ts

@@ -0,0 +1,16 @@
+import { a as IntentParser, A as AvailableAction, I as Intent } from '../intent-parser-tPkUA2YT.js';
+
+declare class GeminiIntentParser implements IntentParser {
+    private client?;
+    private readonly apiKey;
+    private readonly model;
+    constructor(options: {
+        apiKey: string;
+        model?: string;
+    });
+    private getClient;
+    parse(prompt: string, actions: AvailableAction[]): Promise<Intent>;
+    private safeParseJSON;
+}
+
+export { GeminiIntentParser };

package/dist/providers/gemini.js

@@ -0,0 +1,51 @@
+import { loadGemini, generateSystemPrompt } from '../chunk-UNGR3PLJ.js';
+
+// src/providers/gemini.ts
+var GeminiIntentParser = class {
+  client;
+  apiKey;
+  model;
+  constructor(options) {
+    this.apiKey = options.apiKey;
+    this.model = options.model ?? "gemini-2.5-flash";
+  }
+  // lazy loader
+  async getClient() {
+    if (this.client) return this.client;
+    const { GoogleGenAI } = await loadGemini();
+    this.client = new GoogleGenAI({ apiKey: this.apiKey });
+    return this.client;
+  }
+  async parse(prompt, actions) {
+    const client = await this.getClient();
+    const systemPrompt = generateSystemPrompt(actions);
+    const result = await client.models.generateContent({
+      model: this.model,
+      contents: [
+        {
+          role: "user",
+          parts: [{ text: systemPrompt + "\n\nUser input:\n" + prompt }]
+        }
+      ]
+    });
+    const content = result.text;
+    if (!content) {
+      throw new Error("Gemini returned empty response");
+    }
+    return this.safeParseJSON(content);
+  }
+  // json guard
+  safeParseJSON(text) {
+    try {
+      const cleaned = text.replace(/```json/g, "").replace(/```/g, "").trim();
+      return JSON.parse(cleaned);
+    } catch {
+      throw new Error(`Invalid JSON returned by Gemini:
+${text}`);
+    }
+  }
+};
+
+export { GeminiIntentParser };
+//# sourceMappingURL=gemini.js.map
+//# sourceMappingURL=gemini.js.map

package/dist/providers/gemini.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/providers/gemini.ts"],"names":[],"mappings":";;;AAMO,IAAM,qBAAN,MAAiD;AAAA,EAC9C,MAAA;AAAA,EACS,MAAA;AAAA,EACA,KAAA;AAAA,EAEjB,YAAY,OAAA,EAA6C;AACvD,IAAA,IAAA,CAAK,SAAS,OAAA,CAAQ,MAAA;AACtB,IAAA,IAAA,CAAK,KAAA,GAAQ,QAAQ,KAAA,IAAS,kBAAA;AAAA,EAChC;AAAA;AAAA,EAGA,MAAc,SAAA,GAAkC;AAC9C,IAAA,IAAI,IAAA,CAAK,MAAA,EAAQ,OAAO,IAAA,CAAK,MAAA;AAE7B,IAAA,MAAM,EAAE,WAAA,EAAY,GAAI,MAAM,UAAA,EAAW;AACzC,IAAA,IAAA,CAAK,SAAS,IAAI,WAAA,CAAY,EAAE,MAAA,EAAQ,IAAA,CAAK,QAAQ,CAAA;AAErD,IAAA,OAAO,IAAA,CAAK,MAAA;AAAA,EACd;AAAA,EAEA,MAAM,KAAA,CAAM,MAAA,EAAgB,OAAA,EAA6C;AACvE,IAAA,MAAM,MAAA,GAAS,MAAM,IAAA,CAAK,SAAA,EAAU;AACpC,IAAA,MAAM,YAAA,GAAe,qBAAqB,OAAO,CAAA;AAEjD,IAAA,MAAM,MAAA,GAAS,MAAM,MAAA,CAAO,MAAA,CAAO,eAAA,CAAgB;AAAA,MACjD,OAAO,IAAA,CAAK,KAAA;AAAA,MACZ,QAAA,EAAU;AAAA,QACR;AAAA,UACE,IAAA,EAAM,MAAA;AAAA,UACN,OAAO,CAAC,EAAE,MAAM,YAAA,GAAe,mBAAA,GAAsB,QAAQ;AAAA;AAC/D;AACF,KACD,CAAA;AAED,IAAA,MAAM,UAAU,MAAA,CAAO,IAAA;AAEvB,IAAA,IAAI,CAAC,OAAA,EAAS;AACZ,MAAA,MAAM,IAAI,MAAM,gCAAgC,CAAA;AAAA,IAClD;AAEA,IAAA,OAAO,IAAA,CAAK,cAAc,OAAO,CAAA;AAAA,EACnC;AAAA;AAAA,EAGQ,cAAc,IAAA,EAAsB;AAC1C,IAAA,IAAI;AACF,MAAA,MAAM,OAAA,GAAU,IAAA,CACb,OAAA,CAAQ,UAAA,EAAY,EAAE,EACtB,OAAA,CAAQ,MAAA,EAAQ,EAAE,CAAA,CAClB,IAAA,EAAK;AAER,MAAA,OAAO,IAAA,CAAK,MAAM,OAAO,CAAA;AAAA,IAC3B,CAAA,CAAA,MAAQ;AACN,MAAA,MAAM,IAAI,KAAA,CAAM,CAAA;AAAA,EAAqC,IAAI,CAAA,CAAE,CAAA;AAAA,IAC7D;AAAA,EACF;AACF","file":"gemini.js","sourcesContent":["import type { Intent } from \"../types/intent\";\r\nimport type { AvailableAction, IntentParser } from \"../intent/intent-parser\";\r\nimport { generateSystemPrompt } from \"../utils/prompt\";\r\nimport { loadGemini } from \"../utils/loader\";\r\nimport type { GoogleGenAI } from \"@google/genai\"; // just for type import\r\n\r\nexport class GeminiIntentParser implements IntentParser {\r\n  private client?: GoogleGenAI;\r\n  private readonly apiKey: string;\r\n  private readonly model: string;\r\n\r\n  constructor(options: { apiKey: string; model?: string }) {\r\n    this.apiKey = options.apiKey;\r\n    this.model = options.model ?? \"gemini-2.5-flash\";\r\n  }\r\n\r\n  // lazy loader\r\n  private async getClient(): Promise<GoogleGenAI> {\r\n    if (this.client) return this.client;\r\n\r\n    const { GoogleGenAI } = await loadGemini();\r\n    this.client = new GoogleGenAI({ apiKey: this.apiKey });\r\n\r\n    return this.client;\r\n  }\r\n\r\n  async parse(prompt: string, actions: AvailableAction[]): Promise<Intent> {\r\n    const client = await this.getClient();\r\n    const systemPrompt = generateSystemPrompt(actions);\r\n\r\n    const result = await client.models.generateContent({\r\n      model: this.model,\r\n      contents: [\r\n        {\r\n          role: \"user\",\r\n          parts: [{ text: systemPrompt + \"\\n\\nUser input:\\n\" + prompt }],\r\n        },\r\n      ],\r\n    });\r\n\r\n    const content = result.text;\r\n\r\n    if (!content) {\r\n      throw new Error(\"Gemini returned empty response\");\r\n    }\r\n\r\n    return this.safeParseJSON(content);\r\n  }\r\n\r\n  // json guard\r\n  private safeParseJSON(text: string): Intent {\r\n    try {\r\n      const cleaned = text\r\n        .replace(/```json/g, \"\")\r\n        .replace(/```/g, \"\")\r\n        .trim();\r\n\r\n      return JSON.parse(cleaned);\r\n    } catch {\r\n      throw new Error(`Invalid JSON returned by Gemini:\\n${text}`);\r\n    }\r\n  }\r\n}\r\n"]}

package/dist/providers/groq.d.ts

@@ -0,0 +1,16 @@
+import { a as IntentParser, A as AvailableAction, I as Intent } from '../intent-parser-tPkUA2YT.js';
+
+declare class GroqIntentParser implements IntentParser {
+    private client?;
+    private readonly apiKey;
+    private readonly model;
+    constructor(options: {
+        apiKey: string;
+        model?: string;
+    });
+    private getClient;
+    parse(prompt: string, actions: AvailableAction[]): Promise<Intent>;
+    private safeParseJSON;
+}
+
+export { GroqIntentParser };

package/dist/providers/groq.js

@@ -0,0 +1,47 @@
+import { loadGroq, generateSystemPrompt } from '../chunk-UNGR3PLJ.js';
+
+// src/providers/groq.ts
+var GroqIntentParser = class {
+  client;
+  apiKey;
+  model;
+  constructor(options) {
+    this.apiKey = options.apiKey;
+    this.model = options.model ?? "llama3-70b-8192";
+  }
+  async getClient() {
+    if (this.client) return this.client;
+    const { default: Groq } = await loadGroq();
+    this.client = new Groq({ apiKey: this.apiKey });
+    return this.client;
+  }
+  async parse(prompt, actions) {
+    const systemPrompt = generateSystemPrompt(actions);
+    const client = await this.getClient();
+    const response = await client.chat.completions.create({
+      model: this.model,
+      temperature: 0,
+      messages: [
+        { role: "system", content: systemPrompt },
+        { role: "user", content: prompt }
+      ]
+    });
+    const content = response.choices[0]?.message?.content;
+    if (!content) {
+      throw new Error("Groq returned empty response");
+    }
+    return this.safeParseJSON(content);
+  }
+  safeParseJSON(text) {
+    try {
+      return JSON.parse(text);
+    } catch {
+      throw new Error(`Invalid JSON returned by Groq:
+${text}`);
+    }
+  }
+};
+
+export { GroqIntentParser };
+//# sourceMappingURL=groq.js.map
+//# sourceMappingURL=groq.js.map

package/dist/providers/groq.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/providers/groq.ts"],"names":[],"mappings":";;;AAMO,IAAM,mBAAN,MAA+C;AAAA,EAC5C,MAAA;AAAA,EACS,MAAA;AAAA,EACA,KAAA;AAAA,EAEjB,YAAY,OAAA,EAA6C;AACvD,IAAA,IAAA,CAAK,SAAS,OAAA,CAAQ,MAAA;AACtB,IAAA,IAAA,CAAK,KAAA,GAAQ,QAAQ,KAAA,IAAS,iBAAA;AAAA,EAChC;AAAA,EAEA,MAAc,SAAA,GAA2B;AACvC,IAAA,IAAI,IAAA,CAAK,MAAA,EAAQ,OAAO,IAAA,CAAK,MAAA;AAE7B,IAAA,MAAM,EAAE,OAAA,EAAS,IAAA,EAAK,GAAI,MAAM,QAAA,EAAS;AACzC,IAAA,IAAA,CAAK,SAAS,IAAI,IAAA,CAAK,EAAE,MAAA,EAAQ,IAAA,CAAK,QAAQ,CAAA;AAE9C,IAAA,OAAO,IAAA,CAAK,MAAA;AAAA,EACd;AAAA,EAEA,MAAM,KAAA,CAAM,MAAA,EAAgB,OAAA,EAA6C;AACvE,IAAA,MAAM,YAAA,GAAe,qBAAqB,OAAO,CAAA;AACjD,IAAA,MAAM,MAAA,GAAS,MAAM,IAAA,CAAK,SAAA,EAAU;AAEpC,IAAA,MAAM,QAAA,GAAW,MAAM,MAAA,CAAO,IAAA,CAAK,YAAY,MAAA,CAAO;AAAA,MACpD,OAAO,IAAA,CAAK,KAAA;AAAA,MACZ,WAAA,EAAa,CAAA;AAAA,MACb,QAAA,EAAU;AAAA,QACR,EAAE,IAAA,EAAM,QAAA,EAAU,OAAA,EAAS,YAAA,EAAa;AAAA,QACxC,EAAE,IAAA,EAAM,MAAA,EAAQ,OAAA,EAAS,MAAA;AAAO;AAClC,KACD,CAAA;AAED,IAAA,MAAM,OAAA,GAAU,QAAA,CAAS,OAAA,CAAQ,CAAC,GAAG,OAAA,EAAS,OAAA;AAE9C,IAAA,IAAI,CAAC,OAAA,EAAS;AACZ,MAAA,MAAM,IAAI,MAAM,8BAA8B,CAAA;AAAA,IAChD;AAEA,IAAA,OAAO,IAAA,CAAK,cAAc,OAAO,CAAA;AAAA,EACnC;AAAA,EAEQ,cAAc,IAAA,EAAsB;AAC1C,IAAA,IAAI;AACF,MAAA,OAAO,IAAA,CAAK,MAAM,IAAI,CAAA;AAAA,IACxB,CAAA,CAAA,MAAQ;AACN,MAAA,MAAM,IAAI,KAAA,CAAM,CAAA;AAAA,EAAmC,IAAI,CAAA,CAAE,CAAA;AAAA,IAC3D;AAAA,EACF;AACF","file":"groq.js","sourcesContent":["import type { Intent } from \"../types/intent\";\r\nimport type { AvailableAction, IntentParser } from \"../intent/intent-parser\";\r\nimport { generateSystemPrompt } from \"../utils/prompt\";\r\nimport { loadGroq } from \"../utils/loader\";\r\nimport type Groq from \"groq-sdk\";\r\n\r\nexport class GroqIntentParser implements IntentParser {\r\n  private client?: Groq;\r\n  private readonly apiKey: string;\r\n  private readonly model: string;\r\n\r\n  constructor(options: { apiKey: string; model?: string }) {\r\n    this.apiKey = options.apiKey;\r\n    this.model = options.model ?? \"llama3-70b-8192\";\r\n  }\r\n\r\n  private async getClient(): Promise<Groq> {\r\n    if (this.client) return this.client;\r\n\r\n    const { default: Groq } = await loadGroq();\r\n    this.client = new Groq({ apiKey: this.apiKey });\r\n\r\n    return this.client;\r\n  }\r\n\r\n  async parse(prompt: string, actions: AvailableAction[]): Promise<Intent> {\r\n    const systemPrompt = generateSystemPrompt(actions);\r\n    const client = await this.getClient();\r\n\r\n    const response = await client.chat.completions.create({\r\n      model: this.model,\r\n      temperature: 0,\r\n      messages: [\r\n        { role: \"system\", content: systemPrompt },\r\n        { role: \"user\", content: prompt },\r\n      ],\r\n    });\r\n\r\n    const content = response.choices[0]?.message?.content;\r\n\r\n    if (!content) {\r\n      throw new Error(\"Groq returned empty response\");\r\n    }\r\n\r\n    return this.safeParseJSON(content);\r\n  }\r\n\r\n  private safeParseJSON(text: string): Intent {\r\n    try {\r\n      return JSON.parse(text);\r\n    } catch {\r\n      throw new Error(`Invalid JSON returned by Groq:\\n${text}`);\r\n    }\r\n  }\r\n}\r\n"]}

package/dist/providers/openai.d.ts

@@ -0,0 +1,16 @@
+import { a as IntentParser, A as AvailableAction, I as Intent } from '../intent-parser-tPkUA2YT.js';
+
+declare class OpenAIIntentParser implements IntentParser {
+    private client?;
+    private readonly apiKey;
+    private readonly model;
+    constructor(options: {
+        apiKey: string;
+        model?: string;
+    });
+    private getClient;
+    parse(prompt: string, actions: AvailableAction[]): Promise<Intent>;
+    private safeParseJSON;
+}
+
+export { OpenAIIntentParser };

package/dist/providers/openai.js

@@ -0,0 +1,46 @@
+import { loadOpenAI, generateSystemPrompt } from '../chunk-UNGR3PLJ.js';
+
+// src/providers/openai.ts
+var OpenAIIntentParser = class {
+  client;
+  apiKey;
+  model;
+  constructor(options) {
+    this.apiKey = options.apiKey;
+    this.model = options.model ?? "gpt-4o-mini";
+  }
+  async getClient() {
+    if (this.client) return this.client;
+    const { default: OpenAI } = await loadOpenAI();
+    this.client = new OpenAI({ apiKey: this.apiKey });
+    return this.client;
+  }
+  async parse(prompt, actions) {
+    const systemPrompt = generateSystemPrompt(actions);
+    const client = await this.getClient();
+    const response = await client.chat.completions.create({
+      model: this.model,
+      temperature: 0,
+      messages: [
+        { role: "system", content: systemPrompt },
+        { role: "user", content: prompt }
+      ]
+    });
+    const content = response.choices[0]?.message?.content;
+    if (!content) {
+      throw new Error("AI returned empty response");
+    }
+    return this.safeParseJSON(content);
+  }
+  safeParseJSON(text) {
+    try {
+      return JSON.parse(text);
+    } catch (err) {
+      throw new Error(`Invalid JSON returned by AI: ${text}`);
+    }
+  }
+};
+
+export { OpenAIIntentParser };
+//# sourceMappingURL=openai.js.map
+//# sourceMappingURL=openai.js.map

package/dist/providers/openai.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/providers/openai.ts"],"names":[],"mappings":";;;AAMO,IAAM,qBAAN,MAAiD;AAAA,EAC9C,MAAA;AAAA,EACS,MAAA;AAAA,EACA,KAAA;AAAA,EAEjB,YAAY,OAAA,EAA6C;AACvD,IAAA,IAAA,CAAK,SAAS,OAAA,CAAQ,MAAA;AACtB,IAAA,IAAA,CAAK,KAAA,GAAQ,QAAQ,KAAA,IAAS,aAAA;AAAA,EAChC;AAAA,EAEA,MAAc,SAAA,GAA6B;AACzC,IAAA,IAAI,IAAA,CAAK,MAAA,EAAQ,OAAO,IAAA,CAAK,MAAA;AAE7B,IAAA,MAAM,EAAE,OAAA,EAAS,MAAA,EAAO,GAAI,MAAM,UAAA,EAAW;AAC7C,IAAA,IAAA,CAAK,SAAS,IAAI,MAAA,CAAO,EAAE,MAAA,EAAQ,IAAA,CAAK,QAAQ,CAAA;AAEhD,IAAA,OAAO,IAAA,CAAK,MAAA;AAAA,EACd;AAAA,EAEA,MAAM,KAAA,CAAM,MAAA,EAAgB,OAAA,EAA6C;AACvE,IAAA,MAAM,YAAA,GAAe,qBAAqB,OAAO,CAAA;AACjD,IAAA,MAAM,MAAA,GAAS,MAAM,IAAA,CAAK,SAAA,EAAU;AAEpC,IAAA,MAAM,QAAA,GAAW,MAAM,MAAA,CAAO,IAAA,CAAK,YAAY,MAAA,CAAO;AAAA,MACpD,OAAO,IAAA,CAAK,KAAA;AAAA,MACZ,WAAA,EAAa,CAAA;AAAA,MACb,QAAA,EAAU;AAAA,QACR,EAAE,IAAA,EAAM,QAAA,EAAU,OAAA,EAAS,YAAA,EAAa;AAAA,QACxC,EAAE,IAAA,EAAM,MAAA,EAAQ,OAAA,EAAS,MAAA;AAAO;AAClC,KACD,CAAA;AAED,IAAA,MAAM,OAAA,GAAU,QAAA,CAAS,OAAA,CAAQ,CAAC,GAAG,OAAA,EAAS,OAAA;AAE9C,IAAA,IAAI,CAAC,OAAA,EAAS;AACZ,MAAA,MAAM,IAAI,MAAM,4BAA4B,CAAA;AAAA,IAC9C;AAEA,IAAA,OAAO,IAAA,CAAK,cAAc,OAAO,CAAA;AAAA,EACnC;AAAA,EAEQ,cAAc,IAAA,EAAsB;AAC1C,IAAA,IAAI;AACF,MAAA,OAAO,IAAA,CAAK,MAAM,IAAI,CAAA;AAAA,IACxB,SAAS,GAAA,EAAK;AACZ,MAAA,MAAM,IAAI,KAAA,CAAM,CAAA,6BAAA,EAAgC,IAAI,CAAA,CAAE,CAAA;AAAA,IACxD;AAAA,EACF;AACF","file":"openai.js","sourcesContent":["import type { Intent } from \"../types/intent\";\r\nimport type { AvailableAction, IntentParser } from \"../intent/intent-parser\";\r\nimport { loadOpenAI } from \"../utils/loader\";\r\nimport { generateSystemPrompt } from \"../utils/prompt\";\r\nimport type OpenAI from \"openai\";\r\n\r\nexport class OpenAIIntentParser implements IntentParser {\r\n  private client?: OpenAI;\r\n  private readonly apiKey;\r\n  private readonly model: string;\r\n\r\n  constructor(options: { apiKey: string; model?: string }) {\r\n    this.apiKey = options.apiKey;\r\n    this.model = options.model ?? \"gpt-4o-mini\";\r\n  }\r\n\r\n  private async getClient(): Promise<OpenAI> {\r\n    if (this.client) return this.client;\r\n\r\n    const { default: OpenAI } = await loadOpenAI();\r\n    this.client = new OpenAI({ apiKey: this.apiKey });\r\n\r\n    return this.client;\r\n  }\r\n\r\n  async parse(prompt: string, actions: AvailableAction[]): Promise<Intent> {\r\n    const systemPrompt = generateSystemPrompt(actions);\r\n    const client = await this.getClient();\r\n\r\n    const response = await client.chat.completions.create({\r\n      model: this.model,\r\n      temperature: 0,\r\n      messages: [\r\n        { role: \"system\", content: systemPrompt },\r\n        { role: \"user\", content: prompt },\r\n      ],\r\n    });\r\n\r\n    const content = response.choices[0]?.message?.content;\r\n\r\n    if (!content) {\r\n      throw new Error(\"AI returned empty response\");\r\n    }\r\n\r\n    return this.safeParseJSON(content);\r\n  }\r\n\r\n  private safeParseJSON(text: string): Intent {\r\n    try {\r\n      return JSON.parse(text);\r\n    } catch (err) {\r\n      throw new Error(`Invalid JSON returned by AI: ${text}`);\r\n    }\r\n  }\r\n}\r\n"]}

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "actient",
+  "version": "1.0.0",
+  "description": "",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "type": "module",
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "keywords": [
+    "actient",
+    "action-bot",
+    "ai-action-agents"
+  ],
+  "author": "Andrian004",
+  "license": "MIT",
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "zod": "^4.2.1"
+  },
+  "peerDependencies": {
+    "openai": "^4.0.0 || ^6.0.0",
+    "groq-sdk": "^0.37.0",
+    "@google/genai": "^1.0.0"
+  },
+  "peerDependenciesMeta": {
+    "openai": {
+      "optional": true
+    },
+    "groq-sdk": {
+      "optional": true
+    },
+    "@google/genai": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3",
+    "openai": "^4.0.0 || ^6.0.0",
+    "groq-sdk": "^0.37.0",
+    "@google/genai": "^1.0.0"
+  }
+}