@supernal/interface 1.0.2 → 1.0.4

package/dist/esm/src/background/navigation/ContentResolver.d.ts

@@ -0,0 +1,139 @@
+/**
+ * ContentResolver - Interface for content-aware navigation
+ *
+ * Enables fuzzy navigation within a context by providing searchable content.
+ * When a user says "open blog contracts", the ContentResolver fetches blog posts,
+ * searches them, and returns the best match for navigation.
+ *
+ * Separation of Concerns:
+ * - NavigationGraph: Knows routes and contexts
+ * - ContentResolver: Knows how to search content within a context (pluggable)
+ * - FuzzyMatcher: Generic string matching (reused)
+ *
+ * @example
+ * ```typescript
+ * // Register blog context with content resolver
+ * NavigationGraph.getInstance().registerContext({
+ *   id: 'blog',
+ *   name: 'Blog',
+ *   metadata: {
+ *     route: '/blog',
+ *     contentResolver: {
+ *       fetch: () => fetch('/api/blog-posts').then(r => r.json()),
+ *       searchFields: (post) => [post.title, post.slug, ...post.tags],
+ *       toRoute: (post) => `/blog/${post.slug}`,
+ *       toDisplay: (post) => ({ title: post.title, description: post.excerpt }),
+ *     }
+ *   }
+ * });
+ *
+ * // Auto-generates tool that handles:
+ * // - "go to blog" → /blog
+ * // - "open blog contracts" → fuzzy search → /blog/matching-post
+ * ```
+ */
+/**
+ * Content item display info for suggestions
+ */
+export interface ContentDisplayInfo {
+    /** Title to show in suggestions */
+    title: string;
+    /** Optional description/excerpt */
+    description?: string;
+}
+/**
+ * ContentResolver interface for fuzzy navigation within a context
+ *
+ * @template T - Type of content items (e.g., BlogPost, Product, User)
+ */
+export interface ContentResolver<T = any> {
+    /**
+     * Fetch searchable content
+     *
+     * This is called when a user searches within this context.
+     * Results may be cached by the implementation.
+     *
+     * @returns Promise resolving to array of content items
+     *
+     * @example
+     * ```typescript
+     * fetch: () => fetch('/api/blog-posts').then(r => r.json())
+     * fetch: async () => db.products.findMany()
+     * ```
+     */
+    fetch: () => Promise<T[]>;
+    /**
+     * Extract searchable fields from an item
+     *
+     * Returns strings that will be matched against the user's query.
+     * Order matters - first fields are weighted higher.
+     *
+     * @param item - Content item
+     * @returns Array of searchable strings
+     *
+     * @example
+     * ```typescript
+     * searchFields: (post) => [post.title, post.slug, ...post.tags]
+     * searchFields: (product) => [product.name, product.sku, product.brand]
+     * ```
+     */
+    searchFields: (item: T) => string[];
+    /**
+     * Convert matched item to a navigation route
+     *
+     * @param item - Matched content item
+     * @returns Route path to navigate to
+     *
+     * @example
+     * ```typescript
+     * toRoute: (post) => `/blog/${post.slug}`
+     * toRoute: (product) => `/products/${product.id}`
+     * ```
+     */
+    toRoute: (item: T) => string;
+    /**
+     * Optional: Custom display info for suggestions
+     *
+     * Used when showing "Did you mean..." suggestions.
+     * If not provided, route path is used as title.
+     *
+     * @param item - Content item
+     * @returns Display info for UI
+     *
+     * @example
+     * ```typescript
+     * toDisplay: (post) => ({ title: post.title, description: post.excerpt })
+     * toDisplay: (product) => ({ title: product.name, description: `$${product.price}` })
+     * ```
+     */
+    toDisplay?: (item: T) => ContentDisplayInfo;
+}
+/**
+ * Result of a content-aware navigation
+ */
+export interface ContentNavigationResult<T = any> {
+    /** Whether navigation was successful */
+    success: boolean;
+    /** Human-readable message */
+    message: string;
+    /** The matched item (if any) */
+    item?: T;
+    /** Suggestions if no exact match found */
+    suggestions?: ContentDisplayInfo[];
+}
+/**
+ * Navigation context extended with optional content resolver
+ */
+export interface NavigationContextMetadata {
+    /** Route path for this context */
+    route?: string;
+    /** Content resolver for fuzzy navigation */
+    contentResolver?: ContentResolver;
+    /** Whether this context was auto-created */
+    autoCreated?: boolean;
+    /** Context type (page, modal, etc.) */
+    type?: string;
+    /** Additional metadata */
+    [key: string]: any;
+}
+//# sourceMappingURL=ContentResolver.d.ts.map

package/dist/esm/src/background/navigation/ContentResolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ContentResolver.d.ts","sourceRoot":"","sources":["../../../../../src/background/navigation/ContentResolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,mCAAmC;IACnC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe,CAAC,CAAC,GAAG,GAAG;IACtC;;;;;;;;;;;;;OAaG;IACH,KAAK,EAAE,MAAM,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;IAE1B;;;;;;;;;;;;;;OAcG;IACH,YAAY,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,EAAE,CAAC;IAEpC;;;;;;;;;;;OAWG;IACH,OAAO,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,CAAC;IAE7B;;;;;;;;;;;;;;OAcG;IACH,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,kBAAkB,CAAC;CAC7C;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB,CAAC,CAAC,GAAG,GAAG;IAC9C,wCAAwC;IACxC,OAAO,EAAE,OAAO,CAAC;IACjB,6BAA6B;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,gCAAgC;IAChC,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,0CAA0C;IAC1C,WAAW,CAAC,EAAE,kBAAkB,EAAE,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,kCAAkC;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4CAA4C;IAC5C,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,4CAA4C;IAC5C,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,uCAAuC;IACvC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0BAA0B;IAC1B,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB"}

package/dist/esm/src/background/navigation/ContentResolver.js

@@ -0,0 +1,36 @@
+/**
+ * ContentResolver - Interface for content-aware navigation
+ *
+ * Enables fuzzy navigation within a context by providing searchable content.
+ * When a user says "open blog contracts", the ContentResolver fetches blog posts,
+ * searches them, and returns the best match for navigation.
+ *
+ * Separation of Concerns:
+ * - NavigationGraph: Knows routes and contexts
+ * - ContentResolver: Knows how to search content within a context (pluggable)
+ * - FuzzyMatcher: Generic string matching (reused)
+ *
+ * @example
+ * ```typescript
+ * // Register blog context with content resolver
+ * NavigationGraph.getInstance().registerContext({
+ *   id: 'blog',
+ *   name: 'Blog',
+ *   metadata: {
+ *     route: '/blog',
+ *     contentResolver: {
+ *       fetch: () => fetch('/api/blog-posts').then(r => r.json()),
+ *       searchFields: (post) => [post.title, post.slug, ...post.tags],
+ *       toRoute: (post) => `/blog/${post.slug}`,
+ *       toDisplay: (post) => ({ title: post.title, description: post.excerpt }),
+ *     }
+ *   }
+ * });
+ *
+ * // Auto-generates tool that handles:
+ * // - "go to blog" → /blog
+ * // - "open blog contracts" → fuzzy search → /blog/matching-post
+ * ```
+ */
+export {};
+//# sourceMappingURL=ContentResolver.js.map

package/dist/esm/src/background/navigation/ContentResolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ContentResolver.js","sourceRoot":"","sources":["../../../../../src/background/navigation/ContentResolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG"}

package/dist/esm/src/background/navigation/INavigationGraph.d.ts

@@ -43,6 +43,7 @@ export interface INavigationGraph {
     getAllEdges?(): any[];
     registerToolInContext(toolId: string, contextId?: string, extra?: unknown): void;
     getToolContext?(toolId: string): string | null;
+    navigate?(path: string | RouteInfo): void;
     navigateToContext?(contextId: string): Promise<boolean>;
     trackComponent?(id: string, parent?: string): void;
     getTree?(): NavigationNode[];

package/dist/esm/src/background/navigation/INavigationGraph.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"INavigationGraph.d.ts","sourceRoot":"","sources":["../../../../../src/background/navigation/INavigationGraph.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"INavigationGraph.d.ts","sourceRoot":"","sources":["../../../../../src/background/navigation/INavigationGraph.ts"],"names":[],"mappings":"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"}

package/dist/esm/src/background/navigation/NavigationGraph.d.ts

@@ -4,6 +4,9 @@
  * This is a stub implementation for the open source edition.
  * Full runtime navigation tracking available in @supernal/interface-enterprise.
  *
+ * Context tracking is unified with LocationContext - NavigationGraph delegates
+ * to LocationContext for the single source of truth about current location.
+ *
  * Visit https://supernal.ai/enterprise for more information.
  */
 import { INavigationGraph, NavigationNode, RouteInfo, ContextData } from './INavigationGraph';
@@ -17,7 +20,17 @@ export { NavigationNode, RouteInfo, ContextData } from './INavigationGraph';
 export declare class NavigationGraph implements INavigationGraph {
     private static instance;
     private warned;
+    private currentContext;
+    private contextTools;
+    private navigationHandler;
+    private contextListeners;
+    private locationUnsubscribe;
     private warnOnce;
+    /**
+     * Set up synchronization with LocationContext
+     * This ensures NavigationGraph stays in sync when LocationContext changes
+     */
+    private setupLocationSync;
     static getInstance(): NavigationGraph;
     trackComponent(id: string, parent?: string): void;
     getTree(): NavigationNode[];
@@ -29,8 +42,19 @@ export declare class NavigationGraph implements INavigationGraph {
     registerToolInContext(toolId: string, contextId?: string, extra?: unknown): void;
     getRouteByName(name: string): RouteInfo | undefined;
     setCurrentContext(contextId: string | RouteInfo): void;
+    /**
+     * Subscribe to context changes
+     * @param fn Callback invoked when context changes
+     * @returns Unsubscribe function
+     */
+    onContextChange(fn: (ctx: string) => void): () => void;
     setNavigationHandler(handler: (path: string | RouteInfo) => void | Promise<void>): void;
     getNavigationHandler(): ((pageName: string) => void | Promise<void>) | null;
+    /**
+     * Navigate to a path using the registered navigation handler
+     * This is the method tools should call to trigger navigation
+     */
+    navigate(path: string | RouteInfo): void;
     navigateToContext(contextId: string): Promise<boolean>;
     getRouteForContext(contextId: string): string | undefined;
     getAllRoutes(): Record<string, string>;

package/dist/esm/src/background/navigation/NavigationGraph.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NavigationGraph.d.ts","sourceRoot":"","sources":["../../../../../src/background/navigation/NavigationGraph.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAG9F,QAAA,MAAM,oBAAoB,kCAAkC,CAAC;AAG7D,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,CAAC,oBAAoB,CAAC,CAAC,EAAE,gBAAgB,CAAC;KAC3C;CACF;AAED,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAE5E,qBAAa,eAAgB,YAAW,gBAAgB;IACtD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAgC;IACvD,OAAO,CAAC,MAAM,CAAS;IAEvB,OAAO,CAAC,QAAQ;IAUhB,MAAM,CAAC,WAAW,IAAI,eAAe;IAmBrC,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAIjD,OAAO,IAAI,cAAc,EAAE;IAK3B,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI;IAI/C,KAAK,IAAI,IAAI;IAKb,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI;IAKrE,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,EAAE,CAAC,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,CAAC,EAAE,OAAO,GAAG,IAAI;IAIzF,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,WAAW;IAKnC,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,IAAI;IAIhF,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAKnD,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAItD,oBAAoB,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAIvF,oBAAoB,IAAI,CAAC,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI;IAKrE,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAK5D,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAKzD,YAAY,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAKtC,iBAAiB,IAAI,MAAM;IAK3B,cAAc,IAAI,GAAG,EAAE;IAKvB,WAAW,IAAI,GAAG,EAAE;IAKpB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAK7C,KAAK,IAAI,IAAI;IAIb,cAAc,IAAI,IAAI;IAItB,SAAS,IAAI,MAAM;IAKnB,MAAM,IAAI,GAAG;CAId"}
+{"version":3,"file":"NavigationGraph.d.ts","sourceRoot":"","sources":["../../../../../src/background/navigation/NavigationGraph.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAW9F,QAAA,MAAM,oBAAoB,kCAAkC,CAAC;AAG7D,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,CAAC,oBAAoB,CAAC,CAAC,EAAE,gBAAgB,CAAC;KAC3C;CACF;AAED,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAE5E,qBAAa,eAAgB,YAAW,gBAAgB;IACtD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAgC;IACvD,OAAO,CAAC,MAAM,CAAS;IAGvB,OAAO,CAAC,cAAc,CAAqB;IAC3C,OAAO,CAAC,YAAY,CAAkC;IACtD,OAAO,CAAC,iBAAiB,CAAqE;IAG9F,OAAO,CAAC,gBAAgB,CAAoC;IAC5D,OAAO,CAAC,mBAAmB,CAA6B;IAExD,OAAO,CAAC,QAAQ;IAUhB;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAwBzB,MAAM,CAAC,WAAW,IAAI,eAAe;IAsBrC,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAIjD,OAAO,IAAI,cAAc,EAAE;IAK3B,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI;IAI/C,KAAK,IAAI,IAAI;IAKb,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI;IAKrE,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,EAAE,CAAC,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,CAAC,EAAE,OAAO,GAAG,IAAI;IAIzF,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,WAAW;IAKnC,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,IAAI;IAOhF,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAKnD,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAmCtD;;;;OAIG;IACH,eAAe,CAAC,EAAE,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,GAAG,MAAM,IAAI;IAKtD,oBAAoB,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAIvF,oBAAoB,IAAI,CAAC,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI;IAI3E;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAclC,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAK5D,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAKzD,YAAY,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAKtC,iBAAiB,IAAI,MAAM;IAgB3B,cAAc,IAAI,GAAG,EAAE;IAKvB,WAAW,IAAI,GAAG,EAAE;IAKpB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAK7C,KAAK,IAAI,IAAI;IAIb,cAAc,IAAI,IAAI;IAItB,SAAS,IAAI,MAAM;IAKnB,MAAM,IAAI,GAAG;CAId"}

package/dist/esm/src/background/navigation/NavigationGraph.js

@@ -4,27 +4,68 @@
  * This is a stub implementation for the open source edition.
  * Full runtime navigation tracking available in @supernal/interface-enterprise.
  *
+ * Context tracking is unified with LocationContext - NavigationGraph delegates
+ * to LocationContext for the single source of truth about current location.
+ *
  * Visit https://supernal.ai/enterprise for more information.
  */
+// Lazy getter for LocationContext to avoid circular dependency at module load
+function getLocationContext() {
+    return require('../location/LocationContext').LocationContext;
+}
 // Global singleton key to ensure cross-package singleton behavior
 const GLOBAL_SINGLETON_KEY = '__SUPERNAL_NAVIGATION_GRAPH__';
 export class NavigationGraph {
     constructor() {
         this.warned = false;
+        this.contextTools = new Map(); // toolId -> contextId
+        this.navigationHandler = null;
+        // Context change listeners
+        this.contextListeners = new Set();
+        this.locationUnsubscribe = null;
     }
     warnOnce() {
         if (!this.warned && typeof console !== 'undefined') {
-            console.warn('⚠️  NavigationGraph is an enterprise feature. ' +
+            console.warn('⚠️  Advanced NavigationGraph features are enterprise-only. ' +
                 'Full runtime tracking available at https://supernal.ai/enterprise');
             this.warned = true;
         }
     }
+    /**
+     * Set up synchronization with LocationContext
+     * This ensures NavigationGraph stays in sync when LocationContext changes
+     */
+    setupLocationSync() {
+        if (this.locationUnsubscribe)
+            return; // Already set up
+        try {
+            const LocationContext = getLocationContext();
+            this.locationUnsubscribe = LocationContext.onLocationChange((old, newLoc) => {
+                const ctx = newLoc.page || 'global';
+                this.currentContext = ctx; // Keep in sync
+                this.contextListeners.forEach(fn => {
+                    try {
+                        fn(ctx);
+                    }
+                    catch (e) {
+                        console.error('[NavigationGraph] Context listener error:', e);
+                    }
+                });
+            });
+        }
+        catch (e) {
+            // LocationContext may not be available in all environments
+            console.warn('[NavigationGraph] Could not set up LocationContext sync:', e);
+        }
+    }
     static getInstance() {
         // Check global singleton first (browser environment)
         // If enterprise version already created a singleton, use that!
         if (typeof window !== 'undefined') {
             if (!window[GLOBAL_SINGLETON_KEY]) {
-                window[GLOBAL_SINGLETON_KEY] = new NavigationGraph();
+                const instance = new NavigationGraph();
+                window[GLOBAL_SINGLETON_KEY] = instance;
+                instance.setupLocationSync();
                 console.log('🌍 [NavigationGraph] Created GLOBAL singleton instance (open-source stub)');
             }
             return window[GLOBAL_SINGLETON_KEY];
@@ -32,6 +73,7 @@ export class NavigationGraph {
         // Fallback to module-level singleton (Node.js/SSR environment)
         if (!this.instance) {
             this.instance = new NavigationGraph();
+            this.instance.setupLocationSync();
         }
         return this.instance;
     }
@@ -62,21 +104,82 @@ export class NavigationGraph {
         return { id, tools: [] };
     }
     registerToolInContext(toolId, contextId, extra) {
-        this.warnOnce();
+        // Basic implementation: store tool-to-context mapping
+        if (contextId) {
+            this.contextTools.set(toolId, contextId);
+        }
     }
     getRouteByName(name) {
         this.warnOnce();
         return undefined;
     }
     setCurrentContext(contextId) {
-        this.warnOnce();
+        // Extract context ID from string or RouteInfo
+        let id;
+        if (typeof contextId === 'string') {
+            id = contextId;
+        }
+        else if (contextId && typeof contextId === 'object' && 'path' in contextId && contextId.path) {
+            id = contextId.path;
+        }
+        else {
+            id = 'global';
+        }
+        // Update LocationContext (single source of truth)
+        try {
+            const LocationContext = getLocationContext();
+            LocationContext.setCurrent({
+                page: id,
+                route: id,
+            });
+        }
+        catch (e) {
+            // LocationContext may not be available in all environments
+        }
+        // Keep local state for backward compat (redundant but safe)
+        this.currentContext = id;
+        // Notify listeners
+        this.contextListeners.forEach(fn => {
+            try {
+                fn(id);
+            }
+            catch (e) {
+                console.error('[NavigationGraph] Context listener error:', e);
+            }
+        });
+    }
+    /**
+     * Subscribe to context changes
+     * @param fn Callback invoked when context changes
+     * @returns Unsubscribe function
+     */
+    onContextChange(fn) {
+        this.contextListeners.add(fn);
+        return () => this.contextListeners.delete(fn);
     }
     setNavigationHandler(handler) {
-        this.warnOnce();
+        this.navigationHandler = handler;
     }
     getNavigationHandler() {
-        this.warnOnce();
-        return null;
+        return this.navigationHandler;
+    }
+    /**
+     * Navigate to a path using the registered navigation handler
+     * This is the method tools should call to trigger navigation
+     */
+    navigate(path) {
+        if (this.navigationHandler) {
+            const result = this.navigationHandler(path);
+            // Handle async handlers
+            if (result && typeof result.then === 'function') {
+                result.catch((error) => {
+                    console.error('[NavigationGraph] Navigation failed:', error);
+                });
+            }
+        }
+        else {
+            console.warn('[NavigationGraph] No navigation handler registered. Call setNavigationHandler() first.');
+        }
     }
     async navigateToContext(contextId) {
         this.warnOnce();
@@ -91,8 +194,19 @@ export class NavigationGraph {
         return {};
     }
     getCurrentContext() {
-        this.warnOnce();
-        return 'global';
+        // Read from LocationContext as authoritative source
+        try {
+            const LocationContext = getLocationContext();
+            const location = LocationContext.getCurrent();
+            if (location?.page) {
+                return location.page;
+            }
+        }
+        catch (e) {
+            // LocationContext may not be available in all environments
+        }
+        // Fallback to local state or 'global' as default
+        return this.currentContext !== undefined ? this.currentContext : 'global';
     }
     getAllContexts() {
         this.warnOnce();
@@ -103,8 +217,8 @@ export class NavigationGraph {
         return [];
     }
     getToolContext(toolId) {
-        this.warnOnce();
-        return null;
+        // Return the context for a tool, or null if not registered (matches interface)
+        return this.contextTools.get(toolId) || null;
     }
     clear() {
         this.warnOnce();

package/dist/esm/src/background/navigation/NavigationGraph.js.map

@@ -1 +1 @@
-{"version":3,"file":"NavigationGraph.js","sourceRoot":"","sources":["../../../../../src/background/navigation/NavigationGraph.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"NavigationGraph.js","sourceRoot":"","sources":["../../../../../src/background/navigation/NavigationGraph.ts"],"names":[],"mappings":"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"}

package/dist/esm/src/background/registry/ToolRegistry.d.ts

@@ -228,5 +228,53 @@ export declare class ToolRegistry {
      * }
      */
     static getToolsGroupedByComponentAndContainer(): Record<string, Record<string, ToolMetadata[]>>;
+    /**
+     * Get tools filtered by current location
+     *
+     * Uses LocationContext to filter tools based on their @LocationScope decorators.
+     * Returns only tools that are available at the current location.
+     *
+     * @param location - Optional location to check against (defaults to LocationContext.getCurrent())
+     * @returns Array of tools available at the specified location
+     *
+     * @example
+     * ```typescript
+     * // Get tools available at current location
+     * const tools = ToolRegistry.getToolsByLocation();
+     *
+     * // Get tools for specific location
+     * const blogTools = ToolRegistry.getToolsByLocation({
+     *   page: '/blog',
+     *   components: ['blog-editor']
+     * });
+     * ```
+     */
+    static getToolsByLocation(location?: import('../location/LocationContext').AppLocation | null): ToolMetadata[];
+    /**
+     * Get tools for a specific context ID
+     *
+     * Convenience method that wraps getToolsByLocation with a simple context string.
+     *
+     * @param contextId - Context ID (e.g., '/blog', '/examples')
+     * @returns Tools available in that context
+     */
+    static getToolsForContext(contextId: string): ToolMetadata[];
+    /**
+     * Get tools for the current context
+     *
+     * Reads current location from LocationContext and returns matching tools.
+     *
+     * @returns Tools available at current location
+     */
+    static getToolsForCurrentContext(): ToolMetadata[];
+    /**
+     * Get tools grouped by container, filtered by location
+     *
+     * Combines location filtering with container grouping.
+     *
+     * @param location - Optional location to filter by
+     * @returns Tools grouped by container, filtered by location
+     */
+    static getToolsGroupedByContainerForLocation(location?: import('../location/LocationContext').AppLocation | null): Record<string, ToolMetadata[]>;
 }
 //# sourceMappingURL=ToolRegistry.d.ts.map

package/dist/esm/src/background/registry/ToolRegistry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ToolRegistry.d.ts","sourceRoot":"","sources":["../../../../../src/background/registry/ToolRegistry.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ToolRegistry.d.ts","sourceRoot":"","sources":["../../../../../src/background/registry/ToolRegistry.ts"],"names":[],"mappings":"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"}

package/dist/esm/src/background/registry/ToolRegistry.js

@@ -660,5 +660,103 @@ export class ToolRegistry {
         }
         return grouped;
     }
+    /**
+     * Get tools filtered by current location
+     *
+     * Uses LocationContext to filter tools based on their @LocationScope decorators.
+     * Returns only tools that are available at the current location.
+     *
+     * @param location - Optional location to check against (defaults to LocationContext.getCurrent())
+     * @returns Array of tools available at the specified location
+     *
+     * @example
+     * ```typescript
+     * // Get tools available at current location
+     * const tools = ToolRegistry.getToolsByLocation();
+     *
+     * // Get tools for specific location
+     * const blogTools = ToolRegistry.getToolsByLocation({
+     *   page: '/blog',
+     *   components: ['blog-editor']
+     * });
+     * ```
+     */
+    static getToolsByLocation(location) {
+        // Lazy import to avoid circular dependencies
+        const { LocationContext } = require('../location/LocationContext');
+        const currentLocation = location !== undefined ? location : LocationContext.getCurrent();
+        return Array.from(this.tools.values()).filter(tool => {
+            // Check 1: LocationScope decorator (rich matching)
+            if (tool.locationScope) {
+                return LocationContext.matchesScope(tool.locationScope, currentLocation);
+            }
+            // Check 2: containerId-based scoping (unified with LocationScope)
+            if (tool.containerId) {
+                // Global container tools are always available
+                if (tool.containerId === 'global')
+                    return true;
+                // Only treat containerId as scoping if it looks like a route (starts with /)
+                // Non-route containerIds (like 'TestContainer') are for grouping only, not scoping
+                if (!tool.containerId.startsWith('/'))
+                    return true;
+                // No location set = global context, only global tools available
+                if (!currentLocation)
+                    return false;
+                // Match containerId against current page/route
+                const currentPage = currentLocation.page || currentLocation.route || '';
+                // Exact match or hierarchical match (e.g., containerId='/blog' matches page='/blog/post')
+                return currentPage === tool.containerId ||
+                    currentPage.startsWith(tool.containerId + '/') ||
+                    currentPage.startsWith('/' + tool.containerId) ||
+                    currentPage === '/' + tool.containerId;
+            }
+            // No scope defined = available everywhere (global)
+            return true;
+        });
+    }
+    /**
+     * Get tools for a specific context ID
+     *
+     * Convenience method that wraps getToolsByLocation with a simple context string.
+     *
+     * @param contextId - Context ID (e.g., '/blog', '/examples')
+     * @returns Tools available in that context
+     */
+    static getToolsForContext(contextId) {
+        return this.getToolsByLocation({ page: contextId, route: contextId });
+    }
+    /**
+     * Get tools for the current context
+     *
+     * Reads current location from LocationContext and returns matching tools.
+     *
+     * @returns Tools available at current location
+     */
+    static getToolsForCurrentContext() {
+        const { LocationContext } = require('../location/LocationContext');
+        return this.getToolsByLocation(LocationContext.getCurrent());
+    }
+    /**
+     * Get tools grouped by container, filtered by location
+     *
+     * Combines location filtering with container grouping.
+     *
+     * @param location - Optional location to filter by
+     * @returns Tools grouped by container, filtered by location
+     */
+    static getToolsGroupedByContainerForLocation(location) {
+        const tools = this.getToolsByLocation(location);
+        const grouped = {
+            global: [],
+        };
+        for (const tool of tools) {
+            const container = tool.containerId || 'global';
+            if (!grouped[container]) {
+                grouped[container] = [];
+            }
+            grouped[container].push(tool);
+        }
+        return grouped;
+    }
 }
 //# sourceMappingURL=ToolRegistry.js.map