@inspecto-dev/types 0.2.0-alpha.0

package/README.md

@@ -0,0 +1,14 @@
+# @inspecto/types
+
+`@inspecto/types` contains all shared TypeScript definitions for the Inspecto monorepo.
+
+## Overview
+
+This package serves as the single source of truth for all types and interfaces used across the Inspecto ecosystem, ensuring strict type safety between the build plugin, local server, browser client, and IDE extension.
+
+## Core Implementation
+
+- **Protocol Types**: Defines the request/response shapes for the local HTTP server (`OpenFileRequest`, `SnippetResponse`, `SendToAiRequest`).
+- **Configuration Types**: Defines the user configuration structure (`InspectoUserConfig`, `UnpluginOptions`, `InspectorOptions`).
+- **Domain Models**: Contains definitions for AI targets (`AiTool`), tool modes (`ToolMode`), and IDE types (`IdeType`).
+- **Constants**: Provides shared constants like `DEFAULT_INTENTS` and tool mode mappings to keep behavior consistent across packages.

package/dist/index.cjs

@@ -0,0 +1,54 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  AI_TARGET_TYPE: () => AI_TARGET_TYPE,
+  DEFAULT_TOOL_MODE: () => DEFAULT_TOOL_MODE,
+  VALID_MODES: () => VALID_MODES
+});
+module.exports = __toCommonJS(index_exports);
+var AI_TARGET_TYPE = {
+  "github-copilot": "plugin",
+  "claude-code": "plugin",
+  gemini: "plugin",
+  codex: "plugin",
+  coco: "cli"
+};
+var DEFAULT_TOOL_MODE = {
+  "github-copilot": "plugin",
+  "claude-code": "plugin",
+  gemini: "plugin",
+  codex: "plugin",
+  coco: "cli"
+};
+var VALID_MODES = {
+  "github-copilot": ["plugin"],
+  "claude-code": ["plugin", "cli"],
+  gemini: ["plugin", "cli"],
+  codex: ["plugin", "cli"],
+  coco: ["cli"]
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  AI_TARGET_TYPE,
+  DEFAULT_TOOL_MODE,
+  VALID_MODES
+});

package/dist/index.d.cts

@@ -0,0 +1,308 @@
+/** Modifier keys that can be used as inspector activation hotkeys */
+type HotKey = 'ctrlKey' | 'altKey' | 'metaKey' | 'shiftKey';
+/**
+ * Hotkey configuration.
+ * - Array of HotKey: all specified keys must be held simultaneously to activate
+ * - false: disable hotkey activation entirely (use programmatic toggle only)
+ * @default ['altKey']
+ * @example ['ctrlKey', 'shiftKey'] — Ctrl+Shift to activate
+ */
+type HotKeys = HotKey[] | false;
+/** Parsed source location from the data-inspecto attribute */
+interface SourceLocation {
+    /** Absolute or relative file path depending on pathType config */
+    file: string;
+    /** 1-based line number */
+    line: number;
+    /** 1-based column number */
+    column: number;
+    /** Optional: component or element name for display */
+    name?: string;
+}
+/** Format of the data-inspecto attribute value: "filepath:line:col" */
+type SourceAttrValue = string;
+/**
+ * Path type injected into data-inspecto attributes.
+ * - 'absolute': full filesystem path (default) — safe across monorepo aliases
+ * - 'relative': path relative to project root — shorter, but may break with pnpm virtual store
+ */
+type PathType = 'relative' | 'absolute';
+/** Configuration for the @inspecto/plugin build plugin */
+interface UnpluginOptions {
+    /**
+     * Additional file extensions to transform beyond .jsx/.tsx/.js/.ts
+     * @default []
+     */
+    include?: string[];
+    /**
+     * File path patterns to exclude from transform
+     * Matched against absolute file path using picomatch
+     * node_modules and dist are always excluded
+     * @default []
+     */
+    exclude?: string[];
+    /**
+     * Element tag names to skip source injection.
+     * Useful for framework-internal elements that should not carry source data.
+     * @default ['template', 'script', 'style', 'Transition', 'TransitionGroup',
+     *           'KeepAlive', 'Teleport', 'Suspense', 'Fragment']
+     */
+    escapeTags?: string[];
+    /**
+     * Path type for the injected data-inspecto attribute value.
+     * Use 'absolute' (default) to avoid issues with monorepo path aliases
+     * and pnpm virtual store symlinks.
+     * @default 'absolute'
+     */
+    pathType?: PathType;
+    /**
+     * The attribute name injected on JSX elements.
+     * Change only if 'data-inspecto' conflicts with another tool.
+     * @default 'data-inspecto'
+     */
+    attributeName?: string;
+}
+/** Supported IDEs */
+type IdeType = 'vscode' | 'unknown';
+/** All supported AI tools */
+type AiTool = 'github-copilot' | 'claude-code' | 'gemini' | 'codex' | 'coco';
+/** Backward compatibility alias */
+type AiTarget = AiTool;
+/** Whether the AI target is an editor plugin or a CLI tool */
+type ToolMode = 'plugin' | 'cli' | 'clipboard';
+/** Backward compatibility alias */
+type AiTargetType = ToolMode;
+interface ProviderConfig {
+    type?: ToolMode;
+    autoSend?: boolean;
+    bin?: string;
+    args?: string[];
+    cwd?: string;
+}
+interface InspectoSettings {
+    ide?: IdeType;
+    prefer?: string;
+    hotKeys?: HotKeys;
+    providers?: Record<string, ProviderConfig>;
+    /**
+     * Whether to inject the raw code snippet into the prompt.
+     * Default is false (saves tokens, lets IDE AI read the file directly).
+     */
+    includeSnippet?: boolean;
+}
+/** Legacy configuration structure (for backward compatibility during migration) */
+interface LegacyInspectoUserConfig {
+    defaultTarget?: AiTool;
+    tools: Partial<Record<AiTool, {
+        mode: ToolMode;
+        cliBinary?: string;
+        cliArgs?: string[];
+    }>>;
+    menuOrder?: AiTool[];
+}
+/** Static mapping: target → type (DEPRECATED: Use config resolution instead) */
+declare const AI_TARGET_TYPE: Record<AiTool, ToolMode>;
+declare const DEFAULT_TOOL_MODE: Record<AiTool, ToolMode>;
+/** Which modes each tool actually supports */
+declare const VALID_MODES: Record<AiTool, ToolMode[]>;
+interface ToolOverrides {
+    type?: ToolMode;
+    binaryPath?: string;
+    args?: string[];
+    cwd?: string;
+    autoSend?: boolean;
+    coldStartDelay?: number;
+}
+interface AiPayload {
+    ide: IdeType;
+    target: AiTarget;
+    targetType: AiTargetType;
+    prompt: string;
+    filePath?: string;
+    line?: number;
+    column?: number;
+    snippet?: string;
+    overrides?: ToolOverrides;
+}
+interface ChannelDef {
+    type: ToolMode;
+    execute: (payload: AiPayload) => Promise<void>;
+}
+interface IntentLabels {
+    copilot?: string;
+    claude?: string;
+    /** Label for the "copy to clipboard only" fallback */
+    clipboard?: string;
+}
+/**
+ * Configuration for a custom intent in the AI menu.
+ */
+interface IntentConfig {
+    /** Unique identifier for this intent */
+    id?: string;
+    /** The text displayed on the intent button */
+    label?: string;
+    /**
+     * Prepend text to the prompt template.
+     * Useful for extending built-in prompts without rewriting the whole template.
+     */
+    prependPrompt?: string;
+    /**
+     * Append text to the prompt template.
+     * Useful for extending built-in prompts (e.g. "Please reply in Chinese").
+     */
+    appendPrompt?: string;
+    prompt?: string;
+    /**
+     * If true, this intent doesn't send a prompt to AI,
+     * but rather triggers a built-in action (like 'open-in-editor').
+     * @internal For built-in intents only.
+     */
+    isAction?: boolean;
+    /**
+     * Enabled status.
+     * If false, this item is explicitly hidden from the menu without having to remove its configuration.
+     */
+    enabled?: boolean;
+}
+type InspectoPromptsConfig = (string | IntentConfig)[] | {
+    $replace: true;
+    items: (string | IntentConfig)[];
+};
+/** Configuration for the browser-side inspector component */
+interface InspectorOptions {
+    /**
+     * Hotkeys to hold while clicking to activate inspector.
+     * Pass false to disable hotkey activation.
+     * @default ['altKey']
+     */
+    hotKeys?: HotKeys;
+    /**
+     * Custom labels for each AI target button.
+     * Useful for localization or branding.
+     */
+    labels?: IntentLabels;
+    /**
+     * Placeholder text for the "Ask AI" input box.
+     */
+    askPlaceholder?: string;
+    /**
+     * Base URL of the local HTTP server spun up by the unplugin.
+     * Usually auto-detected via the injected __AI_INSPECTOR_PORT__ global.
+     * Override only if running in a non-standard setup.
+     */
+    serverUrl?: string;
+    /**
+     * Maximum number of lines to include in the extracted code snippet.
+     * Larger values provide more context but may hit AI token limits.
+     * @default 100
+     */
+    maxSnippetLines?: number;
+    /**
+     * Whether the inspector panel is visible/active on mount.
+     * @default false
+     */
+    defaultActive?: boolean;
+    /**
+     * Theme for the inspector panel.
+     * If 'auto' or undefined, it relies on CSS media queries (prefers-color-scheme)
+     * or inherits from the host environment if manually managed.
+     */
+    theme?: 'light' | 'dark' | 'auto';
+    /**
+     * Whether to inject the raw code snippet into the prompt.
+     * Default is false (saves tokens, lets IDE AI read the file directly).
+     */
+    includeSnippet?: boolean;
+}
+/** POST /open — browser asks server to open file in IDE */
+interface OpenFileRequest {
+    file: string;
+    line: number;
+    column: number;
+}
+/** GET /snippet — browser asks server for source code context */
+interface SnippetRequest {
+    file: string;
+    line: number;
+    column: number;
+    /** Max lines to return in snippet, default 100 */
+    maxLines?: number;
+}
+interface SnippetResponse {
+    /** Extracted code snippet (trimmed to maxSnippetLines) */
+    snippet: string;
+    /** Actual start line of the returned snippet (1-based) */
+    startLine: number;
+    /** File path echoed back */
+    file: string;
+    /** Component or element name if detectable */
+    name?: string;
+}
+/** POST /send-to-ai — browser asks server to dispatch context to an AI tool */
+interface SendToAiRequest {
+    location: SourceLocation;
+    snippet: string;
+    /** Prompt template. Server may override with its own template. */
+    prompt?: string;
+    /** Target AI tool. If not provided, server will resolve it based on config */
+    target?: string;
+}
+interface SendToAiResponse {
+    success: boolean;
+    error?: string;
+    /** Error code for structured error handling in the browser */
+    errorCode?: AiErrorCode;
+}
+/** Standard error codes returned by the local HTTP server */
+type AiErrorCode = 'IDE_NOT_FOUND' | 'EXTENSION_NOT_INSTALLED' | 'CLIPBOARD_WRITE_FAILED' | 'SNIPPET_TOO_LARGE' | 'FILE_NOT_FOUND' | 'UNKNOWN';
+interface ProviderInfo {
+    mode: ToolMode;
+    installed: boolean;
+}
+interface IdeInfo {
+    ide: IdeType;
+    scheme: string;
+    providers: Record<AiTool, ProviderInfo>;
+}
+/** GET /config response — browser-facing runtime configuration */
+interface InspectoConfig {
+    ide: IdeType;
+    providers: Record<AiTool, ProviderInfo>;
+    providerOverrides?: Partial<Record<AiTool, ToolOverrides>>;
+    prompts?: InspectoPromptsConfig;
+    hotKeys?: HotKeys;
+    includeSnippet?: boolean;
+}
+/** Shared mutable state managed by the local HTTP server module */
+interface ServerState {
+    /** Port the HTTP server is currently listening on */
+    port: number | null;
+    /** Whether the server is currently running */
+    running: boolean;
+    /** Absolute path to project root (from git rev-parse or process.cwd()) */
+    projectRoot: string;
+    /** Absolute path to the config root (where .inspecto lives) */
+    configRoot: string;
+    /** The directory where the bundler is running (process.cwd()) */
+    cwd: string;
+    /** Cached IDE info pushed from the extension */
+    ideInfo?: IdeInfo | null;
+}
+/** Context passed to each AI strategy when sending code context */
+interface AiStrategyContext {
+    location: SourceLocation;
+    snippet: string;
+    /** Resolved absolute file URI (file:///...) */
+    fileUri: string;
+    /** Human-readable prompt constructed from location + snippet */
+    prompt: string;
+}
+/** Result of executing an AI strategy */
+interface AiStrategyResult {
+    success: boolean;
+    error?: string;
+    errorCode?: AiErrorCode;
+}
+
+export { AI_TARGET_TYPE, type AiErrorCode, type AiPayload, type AiStrategyContext, type AiStrategyResult, type AiTarget, type AiTargetType, type AiTool, type ChannelDef, DEFAULT_TOOL_MODE, type HotKey, type HotKeys, type IdeInfo, type IdeType, type InspectoConfig, type InspectoPromptsConfig, type InspectoSettings, type InspectorOptions, type IntentConfig, type IntentLabels, type LegacyInspectoUserConfig, type OpenFileRequest, type PathType, type ProviderConfig, type ProviderInfo, type SendToAiRequest, type SendToAiResponse, type ServerState, type SnippetRequest, type SnippetResponse, type SourceAttrValue, type SourceLocation, type ToolMode, type ToolOverrides, type UnpluginOptions, VALID_MODES };

package/dist/index.d.ts

@@ -0,0 +1,308 @@
+/** Modifier keys that can be used as inspector activation hotkeys */
+type HotKey = 'ctrlKey' | 'altKey' | 'metaKey' | 'shiftKey';
+/**
+ * Hotkey configuration.
+ * - Array of HotKey: all specified keys must be held simultaneously to activate
+ * - false: disable hotkey activation entirely (use programmatic toggle only)
+ * @default ['altKey']
+ * @example ['ctrlKey', 'shiftKey'] — Ctrl+Shift to activate
+ */
+type HotKeys = HotKey[] | false;
+/** Parsed source location from the data-inspecto attribute */
+interface SourceLocation {
+    /** Absolute or relative file path depending on pathType config */
+    file: string;
+    /** 1-based line number */
+    line: number;
+    /** 1-based column number */
+    column: number;
+    /** Optional: component or element name for display */
+    name?: string;
+}
+/** Format of the data-inspecto attribute value: "filepath:line:col" */
+type SourceAttrValue = string;
+/**
+ * Path type injected into data-inspecto attributes.
+ * - 'absolute': full filesystem path (default) — safe across monorepo aliases
+ * - 'relative': path relative to project root — shorter, but may break with pnpm virtual store
+ */
+type PathType = 'relative' | 'absolute';
+/** Configuration for the @inspecto/plugin build plugin */
+interface UnpluginOptions {
+    /**
+     * Additional file extensions to transform beyond .jsx/.tsx/.js/.ts
+     * @default []
+     */
+    include?: string[];
+    /**
+     * File path patterns to exclude from transform
+     * Matched against absolute file path using picomatch
+     * node_modules and dist are always excluded
+     * @default []
+     */
+    exclude?: string[];
+    /**
+     * Element tag names to skip source injection.
+     * Useful for framework-internal elements that should not carry source data.
+     * @default ['template', 'script', 'style', 'Transition', 'TransitionGroup',
+     *           'KeepAlive', 'Teleport', 'Suspense', 'Fragment']
+     */
+    escapeTags?: string[];
+    /**
+     * Path type for the injected data-inspecto attribute value.
+     * Use 'absolute' (default) to avoid issues with monorepo path aliases
+     * and pnpm virtual store symlinks.
+     * @default 'absolute'
+     */
+    pathType?: PathType;
+    /**
+     * The attribute name injected on JSX elements.
+     * Change only if 'data-inspecto' conflicts with another tool.
+     * @default 'data-inspecto'
+     */
+    attributeName?: string;
+}
+/** Supported IDEs */
+type IdeType = 'vscode' | 'unknown';
+/** All supported AI tools */
+type AiTool = 'github-copilot' | 'claude-code' | 'gemini' | 'codex' | 'coco';
+/** Backward compatibility alias */
+type AiTarget = AiTool;
+/** Whether the AI target is an editor plugin or a CLI tool */
+type ToolMode = 'plugin' | 'cli' | 'clipboard';
+/** Backward compatibility alias */
+type AiTargetType = ToolMode;
+interface ProviderConfig {
+    type?: ToolMode;
+    autoSend?: boolean;
+    bin?: string;
+    args?: string[];
+    cwd?: string;
+}
+interface InspectoSettings {
+    ide?: IdeType;
+    prefer?: string;
+    hotKeys?: HotKeys;
+    providers?: Record<string, ProviderConfig>;
+    /**
+     * Whether to inject the raw code snippet into the prompt.
+     * Default is false (saves tokens, lets IDE AI read the file directly).
+     */
+    includeSnippet?: boolean;
+}
+/** Legacy configuration structure (for backward compatibility during migration) */
+interface LegacyInspectoUserConfig {
+    defaultTarget?: AiTool;
+    tools: Partial<Record<AiTool, {
+        mode: ToolMode;
+        cliBinary?: string;
+        cliArgs?: string[];
+    }>>;
+    menuOrder?: AiTool[];
+}
+/** Static mapping: target → type (DEPRECATED: Use config resolution instead) */
+declare const AI_TARGET_TYPE: Record<AiTool, ToolMode>;
+declare const DEFAULT_TOOL_MODE: Record<AiTool, ToolMode>;
+/** Which modes each tool actually supports */
+declare const VALID_MODES: Record<AiTool, ToolMode[]>;
+interface ToolOverrides {
+    type?: ToolMode;
+    binaryPath?: string;
+    args?: string[];
+    cwd?: string;
+    autoSend?: boolean;
+    coldStartDelay?: number;
+}
+interface AiPayload {
+    ide: IdeType;
+    target: AiTarget;
+    targetType: AiTargetType;
+    prompt: string;
+    filePath?: string;
+    line?: number;
+    column?: number;
+    snippet?: string;
+    overrides?: ToolOverrides;
+}
+interface ChannelDef {
+    type: ToolMode;
+    execute: (payload: AiPayload) => Promise<void>;
+}
+interface IntentLabels {
+    copilot?: string;
+    claude?: string;
+    /** Label for the "copy to clipboard only" fallback */
+    clipboard?: string;
+}
+/**
+ * Configuration for a custom intent in the AI menu.
+ */
+interface IntentConfig {
+    /** Unique identifier for this intent */
+    id?: string;
+    /** The text displayed on the intent button */
+    label?: string;
+    /**
+     * Prepend text to the prompt template.
+     * Useful for extending built-in prompts without rewriting the whole template.
+     */
+    prependPrompt?: string;
+    /**
+     * Append text to the prompt template.
+     * Useful for extending built-in prompts (e.g. "Please reply in Chinese").
+     */
+    appendPrompt?: string;
+    prompt?: string;
+    /**
+     * If true, this intent doesn't send a prompt to AI,
+     * but rather triggers a built-in action (like 'open-in-editor').
+     * @internal For built-in intents only.
+     */
+    isAction?: boolean;
+    /**
+     * Enabled status.
+     * If false, this item is explicitly hidden from the menu without having to remove its configuration.
+     */
+    enabled?: boolean;
+}
+type InspectoPromptsConfig = (string | IntentConfig)[] | {
+    $replace: true;
+    items: (string | IntentConfig)[];
+};
+/** Configuration for the browser-side inspector component */
+interface InspectorOptions {
+    /**
+     * Hotkeys to hold while clicking to activate inspector.
+     * Pass false to disable hotkey activation.
+     * @default ['altKey']
+     */
+    hotKeys?: HotKeys;
+    /**
+     * Custom labels for each AI target button.
+     * Useful for localization or branding.
+     */
+    labels?: IntentLabels;
+    /**
+     * Placeholder text for the "Ask AI" input box.
+     */
+    askPlaceholder?: string;
+    /**
+     * Base URL of the local HTTP server spun up by the unplugin.
+     * Usually auto-detected via the injected __AI_INSPECTOR_PORT__ global.
+     * Override only if running in a non-standard setup.
+     */
+    serverUrl?: string;
+    /**
+     * Maximum number of lines to include in the extracted code snippet.
+     * Larger values provide more context but may hit AI token limits.
+     * @default 100
+     */
+    maxSnippetLines?: number;
+    /**
+     * Whether the inspector panel is visible/active on mount.
+     * @default false
+     */
+    defaultActive?: boolean;
+    /**
+     * Theme for the inspector panel.
+     * If 'auto' or undefined, it relies on CSS media queries (prefers-color-scheme)
+     * or inherits from the host environment if manually managed.
+     */
+    theme?: 'light' | 'dark' | 'auto';
+    /**
+     * Whether to inject the raw code snippet into the prompt.
+     * Default is false (saves tokens, lets IDE AI read the file directly).
+     */
+    includeSnippet?: boolean;
+}
+/** POST /open — browser asks server to open file in IDE */
+interface OpenFileRequest {
+    file: string;
+    line: number;
+    column: number;
+}
+/** GET /snippet — browser asks server for source code context */
+interface SnippetRequest {
+    file: string;
+    line: number;
+    column: number;
+    /** Max lines to return in snippet, default 100 */
+    maxLines?: number;
+}
+interface SnippetResponse {
+    /** Extracted code snippet (trimmed to maxSnippetLines) */
+    snippet: string;
+    /** Actual start line of the returned snippet (1-based) */
+    startLine: number;
+    /** File path echoed back */
+    file: string;
+    /** Component or element name if detectable */
+    name?: string;
+}
+/** POST /send-to-ai — browser asks server to dispatch context to an AI tool */
+interface SendToAiRequest {
+    location: SourceLocation;
+    snippet: string;
+    /** Prompt template. Server may override with its own template. */
+    prompt?: string;
+    /** Target AI tool. If not provided, server will resolve it based on config */
+    target?: string;
+}
+interface SendToAiResponse {
+    success: boolean;
+    error?: string;
+    /** Error code for structured error handling in the browser */
+    errorCode?: AiErrorCode;
+}
+/** Standard error codes returned by the local HTTP server */
+type AiErrorCode = 'IDE_NOT_FOUND' | 'EXTENSION_NOT_INSTALLED' | 'CLIPBOARD_WRITE_FAILED' | 'SNIPPET_TOO_LARGE' | 'FILE_NOT_FOUND' | 'UNKNOWN';
+interface ProviderInfo {
+    mode: ToolMode;
+    installed: boolean;
+}
+interface IdeInfo {
+    ide: IdeType;
+    scheme: string;
+    providers: Record<AiTool, ProviderInfo>;
+}
+/** GET /config response — browser-facing runtime configuration */
+interface InspectoConfig {
+    ide: IdeType;
+    providers: Record<AiTool, ProviderInfo>;
+    providerOverrides?: Partial<Record<AiTool, ToolOverrides>>;
+    prompts?: InspectoPromptsConfig;
+    hotKeys?: HotKeys;
+    includeSnippet?: boolean;
+}
+/** Shared mutable state managed by the local HTTP server module */
+interface ServerState {
+    /** Port the HTTP server is currently listening on */
+    port: number | null;
+    /** Whether the server is currently running */
+    running: boolean;
+    /** Absolute path to project root (from git rev-parse or process.cwd()) */
+    projectRoot: string;
+    /** Absolute path to the config root (where .inspecto lives) */
+    configRoot: string;
+    /** The directory where the bundler is running (process.cwd()) */
+    cwd: string;
+    /** Cached IDE info pushed from the extension */
+    ideInfo?: IdeInfo | null;
+}
+/** Context passed to each AI strategy when sending code context */
+interface AiStrategyContext {
+    location: SourceLocation;
+    snippet: string;
+    /** Resolved absolute file URI (file:///...) */
+    fileUri: string;
+    /** Human-readable prompt constructed from location + snippet */
+    prompt: string;
+}
+/** Result of executing an AI strategy */
+interface AiStrategyResult {
+    success: boolean;
+    error?: string;
+    errorCode?: AiErrorCode;
+}
+
+export { AI_TARGET_TYPE, type AiErrorCode, type AiPayload, type AiStrategyContext, type AiStrategyResult, type AiTarget, type AiTargetType, type AiTool, type ChannelDef, DEFAULT_TOOL_MODE, type HotKey, type HotKeys, type IdeInfo, type IdeType, type InspectoConfig, type InspectoPromptsConfig, type InspectoSettings, type InspectorOptions, type IntentConfig, type IntentLabels, type LegacyInspectoUserConfig, type OpenFileRequest, type PathType, type ProviderConfig, type ProviderInfo, type SendToAiRequest, type SendToAiResponse, type ServerState, type SnippetRequest, type SnippetResponse, type SourceAttrValue, type SourceLocation, type ToolMode, type ToolOverrides, type UnpluginOptions, VALID_MODES };

package/dist/index.js

@@ -0,0 +1,27 @@
+// src/index.ts
+var AI_TARGET_TYPE = {
+  "github-copilot": "plugin",
+  "claude-code": "plugin",
+  gemini: "plugin",
+  codex: "plugin",
+  coco: "cli"
+};
+var DEFAULT_TOOL_MODE = {
+  "github-copilot": "plugin",
+  "claude-code": "plugin",
+  gemini: "plugin",
+  codex: "plugin",
+  coco: "cli"
+};
+var VALID_MODES = {
+  "github-copilot": ["plugin"],
+  "claude-code": ["plugin", "cli"],
+  gemini: ["plugin", "cli"],
+  codex: ["plugin", "cli"],
+  coco: ["cli"]
+};
+export {
+  AI_TARGET_TYPE,
+  DEFAULT_TOOL_MODE,
+  VALID_MODES
+};

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@inspecto-dev/types",
+  "version": "0.2.0-alpha.0",
+  "description": "Shared TypeScript definitions for the Inspecto monorepo",
+  "license": "MIT",
+  "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/inspecto-dev/inspecto.git",
+    "directory": "packages/types"
+  },
+  "homepage": "https://github.com/inspecto-dev/inspecto/tree/main/packages/types#readme",
+  "bugs": {
+    "url": "https://github.com/inspecto-dev/inspecto/issues"
+  },
+  "author": "Inspecto Contributors",
+  "keywords": [
+    "ai",
+    "devtools",
+    "inspector",
+    "types"
+  ],
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "scripts": {
+    "build": "tsup src/index.ts --format esm,cjs --dts",
+    "dev": "tsup src/index.ts --format esm,cjs --dts --watch",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  }
+}