@uicontract/namer 0.1.0 → 0.2.1

package/README.md

@@ -40,9 +40,36 @@ Examples:
 
 The namer is deterministic: the same element always receives the same ID across runs. It does not read source files or write anything to disk.
 
-## Part of UIC
+## AI-Assisted Naming
 
-This package is part of [UIC (UI Contracts)](https://github.com/sherifkozman/uicontract) — making web app UIs machine-readable.
+For elements lacking strong naming signals (no label or handler), enable AI naming to get context-aware IDs instead of fallback line-number names.
+
+```typescript
+import { assignNames } from '@uicontract/namer';
+import type { RawElement } from '@uicontract/core';
+
+const named = await assignNames(rawElements, {
+  projectRoot: '/path/to/my-app',
+  ai: true, // requires OPENAI_API_KEY, ANTHROPIC_API_KEY, or GOOGLE_API_KEY in env
+});
+```
+
+### AiNamerOptions
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `timeout` | `number` | `10000` | Timeout in milliseconds per AI batch |
+| `provider` | `'openai' \| 'anthropic' \| 'google'` | auto-detected | AI provider to use |
+| `model` | `string` | provider-specific | Model override |
+| `apiKey` | `string` | from env | API key override |
+
+AI naming only targets "weak" elements (no label + no handler). All other elements use deterministic naming. If the AI call fails or times out, the element falls back to its deterministic ID.
+
+See the [CLI docs](../../docs/CLI.md#ai-assisted-naming) for full setup and troubleshooting.
+
+## Part of UI Contracts
+
+This package is part of [UI Contracts](https://github.com/sherifkozman/uicontract) - making web app UIs machine-readable.
 
 ## License
 

package/dist/ai-namer.d.ts

@@ -1,30 +1,72 @@
 /**
- * AI-assisted naming engine (stub).
+ * AI-assisted naming engine.
  *
- * TODO: Connect to an AI provider (e.g., OpenAI, Anthropic) to generate
- * context-aware, human-friendly agent IDs. The AI namer should receive
- * the full element context (surrounding code, component hierarchy, route
- * structure) and produce a naming suggestion that is validated against
- * the agent ID pattern before use. When the AI namer returns null or
- * fails, the deterministic namer is used as a fallback.
+ * Connects to an AI provider (OpenAI, Anthropic, or Google) to generate
+ * context-aware, human-friendly agent ID segments for elements where
+ * deterministic naming produces weak fallback IDs (no label and no handler).
+ *
+ * When the AI namer fails or times out, the deterministic namer is used
+ * as a fallback.
+ *
+ * TODO: Investigate how AI agent skills can detect and reuse the AI
+ * environment they run within (e.g., Claude Code's API context, Gemini CLI's
+ * credentials) instead of requiring separate API keys. This would enable
+ * zero-config AI naming when invoked as a skill from an AI agent.
  */
 import type { RawElement } from '@uicontract/core';
+/** Supported AI providers. */
+export type AiProvider = 'openai' | 'anthropic' | 'google';
 /** Options for the AI naming provider. */
 export interface AiNamerOptions {
     /** Timeout in milliseconds for the AI provider call. */
     timeout?: number;
-    /** AI provider identifier (e.g., "openai", "anthropic"). */
-    provider?: string;
+    /** AI provider identifier. */
+    provider?: AiProvider;
+    /** Model override (provider-specific). */
+    model?: string;
+    /** API key override (defaults to env variable). */
+    apiKey?: string;
 }
 /**
- * Attempt to assign an AI-generated agent ID to a RawElement.
+ * Detect AI provider from environment variables.
+ * Returns null if no API key is found.
+ */
+export declare function detectProvider(): {
+    provider: AiProvider;
+    apiKey: string;
+} | null;
+/**
+ * Check whether an element would receive a weak deterministic name.
+ *
+ * A "weak" name falls to the deterministic namer's priority 5 fallback
+ * (component.type.line or unknown.type.line), which happens when the
+ * element has neither a label nor a handler.
+ */
+export declare function isWeakName(element: RawElement): boolean;
+/**
+ * Validate and sanitize an AI-suggested name.
+ * Returns null if the name is invalid or empty after sanitization.
+ */
+export declare function validateAiName(suggestion: string): string | null;
+/**
+ * Assign AI-generated agent ID segments to weak elements in a batch.
  *
- * Currently a stub that always returns null, causing the caller
- * to fall back to deterministic naming.
+ * Identifies elements that would receive weak deterministic names (no label,
+ * no handler), batches them, sends context to the configured AI provider,
+ * and returns validated name suggestions.
+ *
+ * @param elements - All raw elements to consider for AI naming.
+ * @param options - AI provider options.
+ * @returns Map from element index to AI-suggested name segment.
+ */
+export declare function assignAiNames(elements: ReadonlyArray<RawElement>, options?: AiNamerOptions): Promise<Map<number, string>>;
+/**
+ * Attempt to assign an AI-generated agent ID to a single RawElement.
  *
- * @param _element - The raw element to name.
- * @param _options - AI provider options.
- * @returns null (stub — AI naming not yet implemented).
+ * @deprecated Use assignAiNames for batch processing.
+ * @param element - The raw element to name.
+ * @param options - AI provider options.
+ * @returns AI-suggested name segment, or null on failure.
  */
-export declare function assignAiName(_element: RawElement, _options?: AiNamerOptions): Promise<string | null>;
+export declare function assignAiName(element: RawElement, options?: AiNamerOptions): Promise<string | null>;
 //# sourceMappingURL=ai-namer.d.ts.map

package/dist/ai-namer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ai-namer.d.ts","sourceRoot":"","sources":["../src/ai-namer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,0CAA0C;AAC1C,MAAM,WAAW,cAAc;IAC7B,wDAAwD;IACxD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;GASG;AACH,wBAAsB,YAAY,CAChC,QAAQ,EAAE,UAAU,EACpB,QAAQ,CAAC,EAAE,cAAc,GACxB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAOxB"}
+{"version":3,"file":"ai-namer.d.ts","sourceRoot":"","sources":["../src/ai-namer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAGnD,8BAA8B;AAC9B,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,WAAW,GAAG,QAAQ,CAAC;AAE3D,0CAA0C;AAC1C,MAAM,WAAW,cAAc;IAC7B,wDAAwD;IACxD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,UAAU,CAAC;IACtB,0CAA0C;IAC1C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mDAAmD;IACnD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAkBD;;;GAGG;AACH,wBAAgB,cAAc,IAAI;IAAE,QAAQ,EAAE,UAAU,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAWhF;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAEvD;AA6DD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAMhE;AA6HD;;;;;;;;;;GAUG;AACH,wBAAsB,aAAa,CACjC,QAAQ,EAAE,aAAa,CAAC,UAAU,CAAC,EACnC,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAkE9B;AAED;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,UAAU,EACnB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAGxB"}

package/dist/ai-namer.js

@@ -1,29 +1,282 @@
 /**
- * AI-assisted naming engine (stub).
+ * AI-assisted naming engine.
  *
- * TODO: Connect to an AI provider (e.g., OpenAI, Anthropic) to generate
- * context-aware, human-friendly agent IDs. The AI namer should receive
- * the full element context (surrounding code, component hierarchy, route
- * structure) and produce a naming suggestion that is validated against
- * the agent ID pattern before use. When the AI namer returns null or
- * fails, the deterministic namer is used as a fallback.
+ * Connects to an AI provider (OpenAI, Anthropic, or Google) to generate
+ * context-aware, human-friendly agent ID segments for elements where
+ * deterministic naming produces weak fallback IDs (no label and no handler).
+ *
+ * When the AI namer fails or times out, the deterministic namer is used
+ * as a fallback.
+ *
+ * TODO: Investigate how AI agent skills can detect and reuse the AI
+ * environment they run within (e.g., Claude Code's API context, Gemini CLI's
+ * credentials) instead of requiring separate API keys. This would enable
+ * zero-config AI naming when invoked as a skill from an AI agent.
+ */
+import { sanitizeSegment } from './naming-rules.js';
+/** Agent ID validation pattern. */
+const AGENT_ID_PATTERN = /^[a-z][a-z0-9.-]*$/;
+/** Default models per provider. */
+const DEFAULT_MODELS = {
+    openai: 'gpt-4o-mini',
+    anthropic: 'claude-haiku-4-5-20251001',
+    google: 'gemini-2.0-flash',
+};
+/** Default timeout in milliseconds. */
+const DEFAULT_TIMEOUT = 10_000;
+/** Maximum elements per API batch. */
+const BATCH_SIZE = 20;
+/**
+ * Detect AI provider from environment variables.
+ * Returns null if no API key is found.
  */
+export function detectProvider() {
+    const openaiKey = process.env['OPENAI_API_KEY'];
+    if (openaiKey)
+        return { provider: 'openai', apiKey: openaiKey };
+    const anthropicKey = process.env['ANTHROPIC_API_KEY'];
+    if (anthropicKey)
+        return { provider: 'anthropic', apiKey: anthropicKey };
+    const googleKey = process.env['GOOGLE_API_KEY'] ?? process.env['GEMINI_API_KEY'];
+    if (googleKey)
+        return { provider: 'google', apiKey: googleKey };
+    return null;
+}
 /**
- * Attempt to assign an AI-generated agent ID to a RawElement.
+ * Check whether an element would receive a weak deterministic name.
  *
- * Currently a stub that always returns null, causing the caller
- * to fall back to deterministic naming.
+ * A "weak" name falls to the deterministic namer's priority 5 fallback
+ * (component.type.line or unknown.type.line), which happens when the
+ * element has neither a label nor a handler.
+ */
+export function isWeakName(element) {
+    return element.label === null && element.handler === null;
+}
+/**
+ * Build a naming prompt for a batch of weak elements.
+ */
+function buildNamingPrompt(elements) {
+    const descriptions = elements
+        .map(({ element }, i) => {
+        const parts = [`${String(i + 1)}. Type: ${element.type}`];
+        if (element.componentName)
+            parts.push(`Component: ${element.componentName}`);
+        if (element.route)
+            parts.push(`Route: ${element.route}`);
+        if (element.filePath)
+            parts.push(`File: ${element.filePath}`);
+        parts.push(`Line: ${String(element.line)}`);
+        if (element.conditional)
+            parts.push('(conditionally rendered)');
+        if (element.dynamic)
+            parts.push('(dynamically rendered)');
+        const attrKeys = Object.keys(element.attributes);
+        if (attrKeys.length > 0)
+            parts.push(`Attributes: ${attrKeys.join(', ')}`);
+        return parts.join(', ');
+    })
+        .join('\n');
+    return [
+        'You are a naming assistant for UI elements in a web application.',
+        'Each element needs a short, descriptive kebab-case name (1-3 words) that describes its likely purpose.',
+        '',
+        'Rules:',
+        '- Use lowercase letters, digits, and hyphens only',
+        '- Must start with a letter',
+        '- Be concise: 1-3 words separated by hyphens',
+        '- Describe the element\'s purpose, not its type',
+        '',
+        'Elements:',
+        descriptions,
+        '',
+        'Respond with ONLY a JSON array of strings, one name per element, in the same order.',
+        'Example: ["search-query", "submit-form"]',
+    ].join('\n');
+}
+/**
+ * Parse the AI response to extract name suggestions.
+ */
+function parseAiResponse(text, expectedCount) {
+    const match = text.match(/\[[\s\S]*?\]/);
+    if (!match)
+        return new Array(expectedCount).fill(null);
+    try {
+        const parsed = JSON.parse(match[0]);
+        if (!Array.isArray(parsed))
+            return new Array(expectedCount).fill(null);
+        return parsed.map((item) => {
+            if (typeof item !== 'string')
+                return null;
+            return item;
+        });
+    }
+    catch {
+        return new Array(expectedCount).fill(null);
+    }
+}
+/**
+ * Validate and sanitize an AI-suggested name.
+ * Returns null if the name is invalid or empty after sanitization.
+ */
+export function validateAiName(suggestion) {
+    const sanitized = sanitizeSegment(suggestion);
+    if (sanitized.length === 0)
+        return null;
+    if (sanitized.length > 40)
+        return null;
+    if (!AGENT_ID_PATTERN.test(sanitized))
+        return null;
+    return sanitized;
+}
+async function callOpenAI(prompt, apiKey, model, signal) {
+    const response = await fetch('https://api.openai.com/v1/chat/completions', {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/json',
+            Authorization: `Bearer ${apiKey}`,
+        },
+        body: JSON.stringify({
+            model,
+            messages: [{ role: 'user', content: prompt }],
+            temperature: 0.3,
+            max_tokens: 512,
+        }),
+        signal,
+    });
+    if (!response.ok) {
+        throw new Error(`OpenAI API error: ${String(response.status)} ${response.statusText}`);
+    }
+    const data = (await response.json());
+    return data.choices?.[0]?.message?.content ?? '';
+}
+async function callAnthropic(prompt, apiKey, model, signal) {
+    const response = await fetch('https://api.anthropic.com/v1/messages', {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/json',
+            'x-api-key': apiKey,
+            'anthropic-version': '2023-06-01',
+        },
+        body: JSON.stringify({
+            model,
+            max_tokens: 512,
+            messages: [{ role: 'user', content: prompt }],
+        }),
+        signal,
+    });
+    if (!response.ok) {
+        throw new Error(`Anthropic API error: ${String(response.status)} ${response.statusText}`);
+    }
+    const data = (await response.json());
+    const textBlock = data.content?.find((b) => b.type === 'text');
+    return textBlock?.text ?? '';
+}
+async function callGoogle(prompt, apiKey, model, signal) {
+    const url = `https://generativelanguage.googleapis.com/v1beta/models/${model}:generateContent?key=${apiKey}`;
+    const response = await fetch(url, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({
+            contents: [{ parts: [{ text: prompt }] }],
+        }),
+        signal,
+    });
+    if (!response.ok) {
+        throw new Error(`Google API error: ${String(response.status)} ${response.statusText}`);
+    }
+    const data = (await response.json());
+    return data.candidates?.[0]?.content?.parts?.[0]?.text ?? '';
+}
+/**
+ * Call the configured AI provider with the given prompt.
+ */
+async function callProvider(prompt, provider, apiKey, model, signal) {
+    switch (provider) {
+        case 'openai':
+            return callOpenAI(prompt, apiKey, model, signal);
+        case 'anthropic':
+            return callAnthropic(prompt, apiKey, model, signal);
+        case 'google':
+            return callGoogle(prompt, apiKey, model, signal);
+    }
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Assign AI-generated agent ID segments to weak elements in a batch.
  *
- * @param _element - The raw element to name.
- * @param _options - AI provider options.
- * @returns null (stub — AI naming not yet implemented).
- */
-export async function assignAiName(_element, _options) {
-    // TODO: Implement AI naming. This function should:
-    // 1. Serialize the element context into a prompt
-    // 2. Call the configured AI provider
-    // 3. Validate the response matches ^[a-z][a-z0-9.-]*$
-    // 4. Return the validated name, or null on failure/timeout
-    return null;
+ * Identifies elements that would receive weak deterministic names (no label,
+ * no handler), batches them, sends context to the configured AI provider,
+ * and returns validated name suggestions.
+ *
+ * @param elements - All raw elements to consider for AI naming.
+ * @param options - AI provider options.
+ * @returns Map from element index to AI-suggested name segment.
+ */
+export async function assignAiNames(elements, options) {
+    const result = new Map();
+    // Find weak elements that would benefit from AI naming
+    const weakElements = [];
+    for (let i = 0; i < elements.length; i++) {
+        const element = elements[i];
+        if (element && isWeakName(element)) {
+            weakElements.push({ index: i, element });
+        }
+    }
+    if (weakElements.length === 0)
+        return result;
+    // Resolve provider config
+    const detected = detectProvider();
+    const provider = options?.provider ?? detected?.provider;
+    const apiKey = options?.apiKey ?? detected?.apiKey;
+    if (!provider || !apiKey) {
+        process.stderr.write('Warning: AI naming enabled but no API key found. ' +
+            'Set OPENAI_API_KEY, ANTHROPIC_API_KEY, or GOOGLE_API_KEY. ' +
+            'Falling back to deterministic naming.\n');
+        return result;
+    }
+    const model = options?.model ?? DEFAULT_MODELS[provider];
+    const timeout = options?.timeout ?? DEFAULT_TIMEOUT;
+    // Process in batches to avoid overlong prompts
+    for (let start = 0; start < weakElements.length; start += BATCH_SIZE) {
+        const batch = weakElements.slice(start, start + BATCH_SIZE);
+        const prompt = buildNamingPrompt(batch);
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), timeout);
+        try {
+            const responseText = await callProvider(prompt, provider, apiKey, model, controller.signal);
+            const suggestions = parseAiResponse(responseText, batch.length);
+            for (let j = 0; j < batch.length; j++) {
+                const suggestion = suggestions[j];
+                if (suggestion) {
+                    const validated = validateAiName(suggestion);
+                    if (validated) {
+                        result.set(batch[j].index, validated);
+                    }
+                }
+            }
+        }
+        catch {
+            // On error (timeout, network, parse failure), skip this batch.
+            // Deterministic fallback will be used for these elements.
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+    return result;
+}
+/**
+ * Attempt to assign an AI-generated agent ID to a single RawElement.
+ *
+ * @deprecated Use assignAiNames for batch processing.
+ * @param element - The raw element to name.
+ * @param options - AI provider options.
+ * @returns AI-suggested name segment, or null on failure.
+ */
+export async function assignAiName(element, options) {
+    const names = await assignAiNames([element], options);
+    return names.get(0) ?? null;
 }
 //# sourceMappingURL=ai-namer.js.map

package/dist/ai-namer.js.map

@@ -1 +1 @@
-{"version":3,"file":"ai-namer.js","sourceRoot":"","sources":["../src/ai-namer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAYH;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,QAAoB,EACpB,QAAyB;IAEzB,mDAAmD;IACnD,iDAAiD;IACjD,qCAAqC;IACrC,sDAAsD;IACtD,2DAA2D;IAC3D,OAAO,IAAI,CAAC;AACd,CAAC"}
+{"version":3,"file":"ai-namer.js","sourceRoot":"","sources":["../src/ai-namer.ts"],"names":[],"mappings":"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"}

package/dist/deterministic-namer.js

@@ -70,7 +70,7 @@ export function assignDeterministicName(element) {
     if (hasComponent && hasHandler) {
         return ensureValid(buildId([componentSeg, handlerSeg], element.type));
     }
-    // Priority 5: fallback — component (or "unknown") + type + line
+    // Priority 5: fallback - component (or "unknown") + type + line
     const base = hasComponent ? componentSeg : 'unknown';
     return ensureValid(`${base}.${element.type}.${element.line}`);
 }

package/dist/index.d.ts

@@ -1,9 +1,9 @@
 /**
- * @uicontract/namer — naming engine for UIC elements.
+ * @uicontract/namer - naming engine for UIC elements.
  *
  * Takes RawElements discovered by a parser and assigns stable,
- * hierarchical agentIds using deterministic rules (with an optional
- * AI-assisted mode for future use).
+ * hierarchical agentIds using deterministic rules with an optional
+ * AI-assisted mode for elements that lack strong context.
  */
 import type { RawElement, NamedElement } from '@uicontract/core';
 /** Options for the naming engine. */
@@ -12,21 +12,26 @@ export interface NamerOptions {
     ai?: boolean;
     /** Timeout in milliseconds for AI naming calls. */
     aiTimeout?: number;
+    /** AI provider identifier (e.g., "openai", "anthropic", "google"). */
+    aiProvider?: string;
+    /** Model override for the AI provider. */
+    aiModel?: string;
 }
 /**
  * Name a list of raw elements, producing NamedElements with unique agentIds.
  *
- * 1. Each element is named via the deterministic namer (AI stub returns null).
- * 2. Duplicate IDs are resolved with numeric suffixes.
+ * 1. Optionally batch-processes weak elements via AI for better name segments.
+ * 2. Each element is named via the deterministic namer (with AI overrides).
+ * 3. Duplicate IDs are resolved with numeric suffixes.
  *
  * @param elements - Raw elements from a parser's discovery phase.
- * @param options - Naming options (AI mode is stubbed for now).
+ * @param options - Naming options.
  * @returns Array of NamedElements with unique agentIds.
  */
-export declare function nameElements(elements: ReadonlyArray<RawElement>, options?: NamerOptions): NamedElement[];
+export declare function nameElements(elements: ReadonlyArray<RawElement>, options?: NamerOptions): Promise<NamedElement[]>;
 export { sanitizeSegment, camelToKebab, routeToSegments, labelToSegment, handlerToSegment, componentToSegment, } from './naming-rules.js';
 export { assignDeterministicName } from './deterministic-namer.js';
 export { deduplicateNames } from './deduplicator.js';
-export { assignAiName } from './ai-namer.js';
-export type { AiNamerOptions } from './ai-namer.js';
+export { assignAiName, assignAiNames } from './ai-namer.js';
+export type { AiNamerOptions, AiProvider } from './ai-namer.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAKjE,qCAAqC;AACrC,MAAM,WAAW,YAAY;IAC3B,kFAAkF;IAClF,EAAE,CAAC,EAAE,OAAO,CAAC;IACb,mDAAmD;IACnD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,aAAa,CAAC,UAAU,CAAC,EACnC,OAAO,CAAC,EAAE,YAAY,GACrB,YAAY,EAAE,CA0BhB;AAGD,OAAO,EACL,eAAe,EACf,YAAY,EACZ,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,YAAY,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAUjE,qCAAqC;AACrC,MAAM,WAAW,YAAY;IAC3B,kFAAkF;IAClF,EAAE,CAAC,EAAE,OAAO,CAAC;IACb,mDAAmD;IACnD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sEAAsE;IACtE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,0CAA0C;IAC1C,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,YAAY,CAChC,QAAQ,EAAE,aAAa,CAAC,UAAU,CAAC,EACnC,OAAO,CAAC,EAAE,YAAY,GACrB,OAAO,CAAC,YAAY,EAAE,CAAC,CAiDzB;AAGD,OAAO,EACL,eAAe,EACf,YAAY,EACZ,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC5D,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -1,48 +1,73 @@
 /**
- * @uicontract/namer — naming engine for UIC elements.
+ * @uicontract/namer - naming engine for UIC elements.
  *
  * Takes RawElements discovered by a parser and assigns stable,
- * hierarchical agentIds using deterministic rules (with an optional
- * AI-assisted mode for future use).
+ * hierarchical agentIds using deterministic rules with an optional
+ * AI-assisted mode for elements that lack strong context.
  */
 import { assignDeterministicName } from './deterministic-namer.js';
 import { deduplicateNames } from './deduplicator.js';
-import { assignAiName } from './ai-namer.js';
+import { assignAiNames } from './ai-namer.js';
+import { routeToSegments, componentToSegment, } from './naming-rules.js';
 /**
  * Name a list of raw elements, producing NamedElements with unique agentIds.
  *
- * 1. Each element is named via the deterministic namer (AI stub returns null).
- * 2. Duplicate IDs are resolved with numeric suffixes.
+ * 1. Optionally batch-processes weak elements via AI for better name segments.
+ * 2. Each element is named via the deterministic namer (with AI overrides).
+ * 3. Duplicate IDs are resolved with numeric suffixes.
  *
  * @param elements - Raw elements from a parser's discovery phase.
- * @param options - Naming options (AI mode is stubbed for now).
+ * @param options - Naming options.
  * @returns Array of NamedElements with unique agentIds.
  */
-export function nameElements(elements, options) {
+export async function nameElements(elements, options) {
     const useAi = options?.ai ?? false;
-    const aiTimeout = options?.aiTimeout;
-    // Phase 1: assign names
-    const named = elements.map((element) => {
-        let agentId = null;
-        // Attempt AI naming if enabled (currently a stub that returns null)
-        if (useAi) {
-            // AI naming is async but we handle it synchronously here since
-            // the stub always returns null. When real AI is connected, this
-            // function signature should become async.
-            void assignAiName(element, { timeout: aiTimeout });
+    // Phase 1: try AI naming for weak elements
+    let aiNames = new Map();
+    if (useAi) {
+        aiNames = await assignAiNames(elements, {
+            timeout: options?.aiTimeout,
+            provider: options?.aiProvider,
+            model: options?.aiModel,
+        });
+    }
+    // Phase 2: assign names (deterministic, with AI overrides for weak elements)
+    const named = elements.map((element, index) => {
+        const aiSuggestion = aiNames.get(index);
+        let agentId;
+        if (aiSuggestion) {
+            // AI provided a name segment — build the full ID using the same
+            // structure as the deterministic namer: prefix.suggestion.type
+            const routeSegs = element.route !== null ? routeToSegments(element.route) : [];
+            const componentSeg = element.componentName !== null ? componentToSegment(element.componentName) : '';
+            let prefix;
+            if (routeSegs.length > 0) {
+                prefix = routeSegs.join('.');
+            }
+            else if (componentSeg.length > 0) {
+                prefix = componentSeg;
+            }
+            else {
+                prefix = aiSuggestion;
+            }
+            // If prefix is the AI suggestion itself (no route/component), use suggestion.type
+            // Otherwise use prefix.suggestion.type
+            agentId =
+                prefix === aiSuggestion
+                    ? `${aiSuggestion}.${element.type}`
+                    : `${prefix}.${aiSuggestion}.${element.type}`;
         }
-        // Deterministic fallback (always used until AI is implemented)
-        if (agentId === null) {
+        else {
             agentId = assignDeterministicName(element);
         }
         return { ...element, agentId };
     });
-    // Phase 2: deduplicate
+    // Phase 3: deduplicate
     return deduplicateNames(named);
 }
 // Re-export individual modules for direct access and testing
 export { sanitizeSegment, camelToKebab, routeToSegments, labelToSegment, handlerToSegment, componentToSegment, } from './naming-rules.js';
 export { assignDeterministicName } from './deterministic-namer.js';
 export { deduplicateNames } from './deduplicator.js';
-export { assignAiName } from './ai-namer.js';
+export { assignAiName, assignAiNames } from './ai-namer.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAU7C;;;;;;;;;GASG;AACH,MAAM,UAAU,YAAY,CAC1B,QAAmC,EACnC,OAAsB;IAEtB,MAAM,KAAK,GAAG,OAAO,EAAE,EAAE,IAAI,KAAK,CAAC;IACnC,MAAM,SAAS,GAAG,OAAO,EAAE,SAAS,CAAC;IAErC,wBAAwB;IACxB,MAAM,KAAK,GAAmB,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE;QACrD,IAAI,OAAO,GAAkB,IAAI,CAAC;QAElC,oEAAoE;QACpE,IAAI,KAAK,EAAE,CAAC;YACV,+DAA+D;YAC/D,gEAAgE;YAChE,0CAA0C;YAC1C,KAAK,YAAY,CAAC,OAAO,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC;QACrD,CAAC;QAED,+DAA+D;QAC/D,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;YACrB,OAAO,GAAG,uBAAuB,CAAC,OAAO,CAAC,CAAC;QAC7C,CAAC;QAED,OAAO,EAAE,GAAG,OAAO,EAAE,OAAO,EAAE,CAAC;IACjC,CAAC,CAAC,CAAC;IAEH,uBAAuB;IACvB,OAAO,gBAAgB,CAAC,KAAK,CAAC,CAAC;AACjC,CAAC;AAED,6DAA6D;AAC7D,OAAO,EACL,eAAe,EACf,YAAY,EACZ,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE9C,OAAO,EACL,eAAe,EACf,kBAAkB,GACnB,MAAM,mBAAmB,CAAC;AAc3B;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,QAAmC,EACnC,OAAsB;IAEtB,MAAM,KAAK,GAAG,OAAO,EAAE,EAAE,IAAI,KAAK,CAAC;IAEnC,2CAA2C;IAC3C,IAAI,OAAO,GAAG,IAAI,GAAG,EAAkB,CAAC;IACxC,IAAI,KAAK,EAAE,CAAC;QACV,OAAO,GAAG,MAAM,aAAa,CAAC,QAAQ,EAAE;YACtC,OAAO,EAAE,OAAO,EAAE,SAAS;YAC3B,QAAQ,EAAE,OAAO,EAAE,UAAoC;YACvD,KAAK,EAAE,OAAO,EAAE,OAAO;SACxB,CAAC,CAAC;IACL,CAAC;IAED,6EAA6E;IAC7E,MAAM,KAAK,GAAmB,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE;QAC5D,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACxC,IAAI,OAAe,CAAC;QAEpB,IAAI,YAAY,EAAE,CAAC;YACjB,gEAAgE;YAChE,+DAA+D;YAC/D,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,eAAe,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAC/E,MAAM,YAAY,GAChB,OAAO,CAAC,aAAa,KAAK,IAAI,CAAC,CAAC,CAAC,kBAAkB,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAElF,IAAI,MAAc,CAAC;YACnB,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACzB,MAAM,GAAG,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAC/B,CAAC;iBAAM,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACnC,MAAM,GAAG,YAAY,CAAC;YACxB,CAAC;iBAAM,CAAC;gBACN,MAAM,GAAG,YAAY,CAAC;YACxB,CAAC;YAED,kFAAkF;YAClF,uCAAuC;YACvC,OAAO;gBACL,MAAM,KAAK,YAAY;oBACrB,CAAC,CAAC,GAAG,YAAY,IAAI,OAAO,CAAC,IAAI,EAAE;oBACnC,CAAC,CAAC,GAAG,MAAM,IAAI,YAAY,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACpD,CAAC;aAAM,CAAC;YACN,OAAO,GAAG,uBAAuB,CAAC,OAAO,CAAC,CAAC;QAC7C,CAAC;QAED,OAAO,EAAE,GAAG,OAAO,EAAE,OAAO,EAAE,CAAC;IACjC,CAAC,CAAC,CAAC;IAEH,uBAAuB;IACvB,OAAO,gBAAgB,CAAC,KAAK,CAAC,CAAC;AACjC,CAAC;AAED,6DAA6D;AAC7D,OAAO,EACL,eAAe,EACf,YAAY,EACZ,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uicontract/namer",
-  "version": "0.1.0",
+  "version": "0.2.1",
   "description": "Naming engine that assigns hierarchical agent IDs to UI elements",
   "type": "module",
   "license": "MIT",
@@ -41,7 +41,7 @@
     "README.md"
   ],
   "dependencies": {
-    "@uicontract/core": "0.1.0"
+    "@uicontract/core": "0.2.1"
   },
   "scripts": {
     "build": "tsc -b",