ai-site-pilot 0.1.0

package/dist/tools/index.mjs

@@ -0,0 +1,119 @@
+// src/tools/registry.ts
+function defineTool(config) {
+  return config;
+}
+function defineSimpleTool(name, description, handler) {
+  return {
+    name,
+    description,
+    parameters: {
+      type: "object",
+      properties: {},
+      required: []
+    },
+    handler
+  };
+}
+var ToolRegistry = class {
+  constructor(tools = []) {
+    this.tools = /* @__PURE__ */ new Map();
+    for (const tool of tools) {
+      this.register(tool);
+    }
+  }
+  /**
+   * Register a tool
+   */
+  register(tool) {
+    this.tools.set(tool.name, tool);
+  }
+  /**
+   * Unregister a tool
+   */
+  unregister(name) {
+    this.tools.delete(name);
+  }
+  /**
+   * Get a tool by name
+   */
+  get(name) {
+    return this.tools.get(name);
+  }
+  /**
+   * Get all tools
+   */
+  getAll() {
+    return Array.from(this.tools.values());
+  }
+  /**
+   * Execute a tool by name with given arguments
+   */
+  async execute(execution) {
+    const tool = this.tools.get(execution.name);
+    if (!tool) {
+      console.warn(`Tool not found: ${execution.name}`);
+      return;
+    }
+    if (tool.handler) {
+      await tool.handler(execution.args);
+    }
+  }
+  /**
+   * Execute multiple tools in sequence
+   */
+  async executeAll(executions, delayMs = 300) {
+    for (const execution of executions) {
+      await this.execute(execution);
+      if (delayMs > 0 && executions.indexOf(execution) < executions.length - 1) {
+        await new Promise((resolve) => setTimeout(resolve, delayMs));
+      }
+    }
+  }
+  /**
+   * Convert to Vercel AI SDK tool format
+   */
+  toVercelAITools() {
+    const result = {};
+    for (const tool of this.tools.values()) {
+      result[tool.name] = {
+        description: tool.description,
+        parameters: {
+          type: "object",
+          properties: tool.parameters.properties,
+          required: tool.parameters.required
+        }
+      };
+    }
+    return result;
+  }
+  /**
+   * Convert to Gemini function declarations format
+   */
+  toGeminiFunctionDeclarations() {
+    return this.getAll().map((tool) => ({
+      name: tool.name,
+      description: tool.description,
+      parameters: {
+        type: "object",
+        properties: Object.fromEntries(
+          Object.entries(tool.parameters.properties).map(([key, value]) => [
+            key,
+            {
+              type: value.type,
+              description: value.description,
+              enum: value.enum
+            }
+          ])
+        ),
+        required: tool.parameters.required
+      }
+    }));
+  }
+};
+function createToolRegistry(tools) {
+  return new ToolRegistry(tools);
+}
+
+export { ToolRegistry, createToolRegistry, defineSimpleTool, defineTool };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/tools/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/tools/registry.ts"],"names":[],"mappings":"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","file":"index.mjs","sourcesContent":["/**\n * Tool registry for managing and converting tool definitions\n */\n\nimport type { ToolDefinition, ToolParameters, ToolExecution } from './types';\n\n/**\n * Helper function to define a tool with type safety\n */\nexport function defineTool<TParams extends Record<string, unknown>>(\n  config: ToolDefinition<TParams>\n): ToolDefinition<TParams> {\n  return config;\n}\n\n/**\n * Create a simple tool with no parameters\n */\nexport function defineSimpleTool(\n  name: string,\n  description: string,\n  handler?: () => void | Promise<void>\n): ToolDefinition {\n  return {\n    name,\n    description,\n    parameters: {\n      type: 'object',\n      properties: {},\n      required: [],\n    },\n    handler,\n  };\n}\n\n/**\n * Tool registry for managing multiple tools\n */\nexport class ToolRegistry {\n  private tools: Map<string, ToolDefinition> = new Map();\n\n  constructor(tools: ToolDefinition[] = []) {\n    for (const tool of tools) {\n      this.register(tool);\n    }\n  }\n\n  /**\n   * Register a tool\n   */\n  register(tool: ToolDefinition): void {\n    this.tools.set(tool.name, tool);\n  }\n\n  /**\n   * Unregister a tool\n   */\n  unregister(name: string): void {\n    this.tools.delete(name);\n  }\n\n  /**\n   * Get a tool by name\n   */\n  get(name: string): ToolDefinition | undefined {\n    return this.tools.get(name);\n  }\n\n  /**\n   * Get all tools\n   */\n  getAll(): ToolDefinition[] {\n    return Array.from(this.tools.values());\n  }\n\n  /**\n   * Execute a tool by name with given arguments\n   */\n  async execute(execution: ToolExecution): Promise<void> {\n    const tool = this.tools.get(execution.name);\n    if (!tool) {\n      console.warn(`Tool not found: ${execution.name}`);\n      return;\n    }\n    if (tool.handler) {\n      await tool.handler(execution.args);\n    }\n  }\n\n  /**\n   * Execute multiple tools in sequence\n   */\n  async executeAll(executions: ToolExecution[], delayMs = 300): Promise<void> {\n    for (const execution of executions) {\n      await this.execute(execution);\n      if (delayMs > 0 && executions.indexOf(execution) < executions.length - 1) {\n        await new Promise(resolve => setTimeout(resolve, delayMs));\n      }\n    }\n  }\n\n  /**\n   * Convert to Vercel AI SDK tool format\n   */\n  toVercelAITools(): Record<string, { description: string; parameters: unknown }> {\n    const result: Record<string, { description: string; parameters: unknown }> = {};\n\n    for (const tool of this.tools.values()) {\n      result[tool.name] = {\n        description: tool.description,\n        parameters: {\n          type: 'object',\n          properties: tool.parameters.properties,\n          required: tool.parameters.required,\n        },\n      };\n    }\n\n    return result;\n  }\n\n  /**\n   * Convert to Gemini function declarations format\n   */\n  toGeminiFunctionDeclarations(): Array<{\n    name: string;\n    description: string;\n    parameters: {\n      type: 'object';\n      properties: Record<string, unknown>;\n      required: string[];\n    };\n  }> {\n    return this.getAll().map(tool => ({\n      name: tool.name,\n      description: tool.description,\n      parameters: {\n        type: 'object' as const,\n        properties: Object.fromEntries(\n          Object.entries(tool.parameters.properties).map(([key, value]) => [\n            key,\n            {\n              type: value.type,\n              description: value.description,\n              enum: value.enum,\n            },\n          ])\n        ),\n        required: tool.parameters.required,\n      },\n    }));\n  }\n}\n\n/**\n * Create a tool registry from an array of tools\n */\nexport function createToolRegistry(tools: ToolDefinition[]): ToolRegistry {\n  return new ToolRegistry(tools);\n}\n"]}

package/dist/types--7jDyUM6.d.mts

@@ -0,0 +1,32 @@
+/**
+ * Tool system types
+ */
+interface ToolParameterProperty {
+    type: 'string' | 'number' | 'boolean' | 'array';
+    description: string;
+    enum?: string[];
+    items?: {
+        type: string;
+    };
+}
+interface ToolParameters {
+    type: 'object';
+    properties: Record<string, ToolParameterProperty>;
+    required: string[];
+}
+interface ToolDefinition<TParams extends Record<string, unknown> = Record<string, unknown>> {
+    /** Unique name for the tool */
+    name: string;
+    /** Description shown to the AI - be specific about when to use it */
+    description: string;
+    /** Parameter schema */
+    parameters: ToolParameters;
+    /** Handler function executed when the AI calls this tool */
+    handler?: (params: TParams) => void | Promise<void>;
+}
+interface ToolExecution {
+    name: string;
+    args: Record<string, unknown>;
+}
+
+export type { ToolDefinition as T, ToolExecution as a, ToolParameters as b, ToolParameterProperty as c };

package/dist/types--7jDyUM6.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Tool system types
+ */
+interface ToolParameterProperty {
+    type: 'string' | 'number' | 'boolean' | 'array';
+    description: string;
+    enum?: string[];
+    items?: {
+        type: string;
+    };
+}
+interface ToolParameters {
+    type: 'object';
+    properties: Record<string, ToolParameterProperty>;
+    required: string[];
+}
+interface ToolDefinition<TParams extends Record<string, unknown> = Record<string, unknown>> {
+    /** Unique name for the tool */
+    name: string;
+    /** Description shown to the AI - be specific about when to use it */
+    description: string;
+    /** Parameter schema */
+    parameters: ToolParameters;
+    /** Handler function executed when the AI calls this tool */
+    handler?: (params: TParams) => void | Promise<void>;
+}
+interface ToolExecution {
+    name: string;
+    args: Record<string, unknown>;
+}
+
+export type { ToolDefinition as T, ToolExecution as a, ToolParameters as b, ToolParameterProperty as c };

package/dist/types-DAvVRuXd.d.mts

@@ -0,0 +1,71 @@
+/**
+ * Core types for ai-site-pilot
+ */
+interface ChatMessage {
+    id: string;
+    role: 'user' | 'assistant';
+    content: string;
+    timestamp: Date;
+    toolCalls?: ToolExecution[];
+}
+interface ToolExecution {
+    name: string;
+    args: Record<string, unknown>;
+}
+type StreamEvent = {
+    type: 'text';
+    content: string;
+} | {
+    type: 'tool';
+    name: string;
+    args: Record<string, unknown>;
+} | {
+    type: 'done';
+} | {
+    type: 'error';
+    message: string;
+};
+interface Suggestion {
+    text: string;
+    icon?: string;
+}
+interface SitePilotTheme {
+    /** Accent color name (e.g., 'amber', 'blue', 'green') or CSS color */
+    accent?: string;
+    /** Position of the chat panel */
+    position?: 'bottom-right' | 'bottom-left' | 'top-right' | 'top-left';
+    /** Border radius in pixels */
+    borderRadius?: number;
+}
+interface SitePilotFeatures {
+    /** Enable speech recognition input */
+    speech?: boolean;
+    /** Enable text-to-speech for responses */
+    tts?: boolean;
+    /** Enable fullscreen mode toggle */
+    fullscreen?: boolean;
+    /** Show suggestion chips */
+    suggestions?: boolean;
+}
+interface SitePilotProps {
+    /** API endpoint for chat (e.g., '/api/chat') */
+    apiEndpoint: string;
+    /** Theme configuration */
+    theme?: SitePilotTheme;
+    /** Suggestion prompts to show */
+    suggestions?: Suggestion[];
+    /** Feature toggles */
+    features?: SitePilotFeatures;
+    /** Callback when a tool is called by the AI */
+    onToolCall?: (toolName: string, args: Record<string, unknown>) => void | Promise<void>;
+    /** Initial open state */
+    defaultOpen?: boolean;
+    /** Placeholder text for input */
+    placeholder?: string;
+    /** Welcome message shown before first interaction */
+    welcomeMessage?: string;
+    /** Custom class name for the container */
+    className?: string;
+}
+
+export type { ChatMessage as C, StreamEvent as S, ToolExecution as T, SitePilotProps as a, Suggestion as b, SitePilotTheme as c, SitePilotFeatures as d };

package/dist/types-DAvVRuXd.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Core types for ai-site-pilot
+ */
+interface ChatMessage {
+    id: string;
+    role: 'user' | 'assistant';
+    content: string;
+    timestamp: Date;
+    toolCalls?: ToolExecution[];
+}
+interface ToolExecution {
+    name: string;
+    args: Record<string, unknown>;
+}
+type StreamEvent = {
+    type: 'text';
+    content: string;
+} | {
+    type: 'tool';
+    name: string;
+    args: Record<string, unknown>;
+} | {
+    type: 'done';
+} | {
+    type: 'error';
+    message: string;
+};
+interface Suggestion {
+    text: string;
+    icon?: string;
+}
+interface SitePilotTheme {
+    /** Accent color name (e.g., 'amber', 'blue', 'green') or CSS color */
+    accent?: string;
+    /** Position of the chat panel */
+    position?: 'bottom-right' | 'bottom-left' | 'top-right' | 'top-left';
+    /** Border radius in pixels */
+    borderRadius?: number;
+}
+interface SitePilotFeatures {
+    /** Enable speech recognition input */
+    speech?: boolean;
+    /** Enable text-to-speech for responses */
+    tts?: boolean;
+    /** Enable fullscreen mode toggle */
+    fullscreen?: boolean;
+    /** Show suggestion chips */
+    suggestions?: boolean;
+}
+interface SitePilotProps {
+    /** API endpoint for chat (e.g., '/api/chat') */
+    apiEndpoint: string;
+    /** Theme configuration */
+    theme?: SitePilotTheme;
+    /** Suggestion prompts to show */
+    suggestions?: Suggestion[];
+    /** Feature toggles */
+    features?: SitePilotFeatures;
+    /** Callback when a tool is called by the AI */
+    onToolCall?: (toolName: string, args: Record<string, unknown>) => void | Promise<void>;
+    /** Initial open state */
+    defaultOpen?: boolean;
+    /** Placeholder text for input */
+    placeholder?: string;
+    /** Welcome message shown before first interaction */
+    welcomeMessage?: string;
+    /** Custom class name for the container */
+    className?: string;
+}
+
+export type { ChatMessage as C, StreamEvent as S, ToolExecution as T, SitePilotProps as a, Suggestion as b, SitePilotTheme as c, SitePilotFeatures as d };

package/package.json

@@ -0,0 +1,81 @@
+{
+  "name": "ai-site-pilot",
+  "version": "0.1.0",
+  "description": "AI chat widget that can control and navigate your website. Full-stack solution with streaming, tool system, and polished UI.",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    },
+    "./api": {
+      "types": "./dist/api/index.d.ts",
+      "import": "./dist/api/index.mjs",
+      "require": "./dist/api/index.js"
+    },
+    "./tools": {
+      "types": "./dist/tools/index.d.ts",
+      "import": "./dist/tools/index.mjs",
+      "require": "./dist/tools/index.js"
+    },
+    "./hooks": {
+      "types": "./dist/hooks/index.d.ts",
+      "import": "./dist/hooks/index.mjs",
+      "require": "./dist/hooks/index.js"
+    },
+    "./styles.css": "./dist/styles.css"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsup && cp src/styles.css dist/styles.css",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "ai",
+    "chat",
+    "chatbot",
+    "site-pilot",
+    "navigation",
+    "react",
+    "nextjs",
+    "vercel-ai-sdk",
+    "streaming",
+    "tools",
+    "function-calling"
+  ],
+  "author": "Ben.Builds",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/xBenJamminx/ai-site-pilot"
+  },
+  "homepage": "https://github.com/xBenJamminx/ai-site-pilot#readme",
+  "bugs": {
+    "url": "https://github.com/xBenJamminx/ai-site-pilot/issues"
+  },
+  "peerDependencies": {
+    "react": "^18.0.0 || ^19.0.0",
+    "react-dom": "^18.0.0 || ^19.0.0"
+  },
+  "dependencies": {
+    "ai": "^4.0.0",
+    "framer-motion": "^11.0.0",
+    "lucide-react": "^0.400.0",
+    "react-markdown": "^9.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "@types/react": "^18.0.0",
+    "@types/react-dom": "^18.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.0.0"
+  }
+}