@frontmcp/sdk 0.4.1 → 0.5.1

package/src/resource/resource.registry.js

@@ -1,32 +1,468 @@
 "use strict";
+// file: libs/sdk/src/resource/resource.registry.ts
 Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+const utils_1 = require("../utils");
+const resource_events_1 = require("./resource.events");
+const resource_utils_1 = require("./resource.utils");
 const regsitry_1 = require("../regsitry");
+const resource_instance_1 = require("./resource.instance");
+const resource_types_1 = require("./resource.types");
+const read_resource_flow_1 = tslib_1.__importDefault(require("./flows/read-resource.flow"));
+const resources_list_flow_1 = tslib_1.__importDefault(require("./flows/resources-list.flow"));
+const resource_templates_list_flow_1 = tslib_1.__importDefault(require("./flows/resource-templates-list.flow"));
+const subscribe_resource_flow_1 = tslib_1.__importDefault(require("./flows/subscribe-resource.flow"));
+const unsubscribe_resource_flow_1 = tslib_1.__importDefault(require("./flows/unsubscribe-resource.flow"));
 class ResourceRegistry extends regsitry_1.RegistryAbstract {
-    constructor(providers, list) {
-        super('ResourceRegistry', providers, list);
+    /** Who owns this registry (used for provenance). */
+    owner;
+    /** Resources truly owned/constructed by THIS registry (with lineage applied) */
+    localRows = [];
+    /** Adopted resource rows from each child registry (references to the same instances) */
+    adopted = new Map();
+    /** Children registries that we track */
+    children = new Set();
+    // ---- O(1) indexes over EFFECTIVE set (local + adopted) ----
+    byQualifiedId = new Map(); // qualifiedId -> row
+    byName = new Map(); // baseName -> rows
+    byUri = new Map(); // uri -> row (static resources)
+    byUriTemplate = new Map(); // uriTemplate -> row (templates)
+    byOwnerAndName = new Map(); // "ownerKey:name" -> row
+    byOwner = new Map(); // ownerKey -> rows
+    // version + emitter
+    version = 0;
+    emitter = new resource_events_1.ResourceEmitter();
+    constructor(providers, list, owner) {
+        // disable auto so subclass fields initialize first
+        super('ResourceRegistry', providers, list, false);
+        this.owner = owner;
+        // now it's safe to run the lifecycle
+        this.buildGraph();
+        this.ready = this.initialize();
     }
+    /* -------------------- Build-time: defs + dep checks -------------------- */
     buildMap(list) {
         const tokens = new Set();
         const defs = new Map();
         const graph = new Map();
-        return {
-            tokens,
-            defs,
-            graph,
-        };
+        for (const raw of list) {
+            // Determine if it's a template or static resource
+            const isTemplate = (0, resource_utils_1.isResourceTemplate)(raw);
+            const rec = isTemplate ? (0, resource_utils_1.normalizeResourceTemplate)(raw) : (0, resource_utils_1.normalizeResource)(raw);
+            const provide = rec.provide;
+            tokens.add(provide);
+            defs.set(provide, rec);
+            graph.set(provide, new Set());
+        }
+        return { tokens, defs, graph };
     }
     buildGraph() {
-        // TODO: implement graph building
+        for (const token of this.tokens) {
+            const rec = this.defs.get(token);
+            const deps = (0, resource_utils_1.resourceDiscoveryDeps)(rec);
+            for (const d of deps) {
+                // Validate against hierarchical providers; throws early if missing
+                this.providers.get(d);
+                this.graph.get(token).add(d);
+            }
+        }
+    }
+    /* -------------------- Initialize: create ONE ResourceInstance per local resource -------------------- */
+    async initialize() {
+        // Instantiate each local resource once and store in this.instances
+        for (const token of this.tokens) {
+            const rec = this.defs.get(token);
+            // Single, authoritative instance per local resource
+            const ri = new resource_instance_1.ResourceInstance(rec, this.providers, this.owner);
+            this.instances.set(token, ri);
+            const lineage = this.owner ? [this.owner] : [];
+            const row = this.makeRow(token, ri, lineage, this);
+            this.localRows.push(row);
+        }
+        // Adopt resources from child app registries
+        const childAppRegistries = this.providers.getRegistries('AppRegistry');
+        childAppRegistries.forEach((appRegistry) => {
+            const apps = appRegistry.getApps();
+            for (const app of apps) {
+                const appResourceRegistries = app.providers.getRegistries('ResourceRegistry');
+                appResourceRegistries
+                    .filter((r) => r.owner.kind === 'app')
+                    .forEach((appResourceRegistry) => {
+                    this.adoptFromChild(appResourceRegistry, appResourceRegistry.owner);
+                });
+            }
+        });
+        // Adopt resources from other child resource registries
+        const childResourceRegistries = this.providers.getRegistries('ResourceRegistry');
+        childResourceRegistries
+            .filter((r) => r !== this)
+            .forEach((resourceRegistry) => {
+            this.adoptFromChild(resourceRegistry, resourceRegistry.owner);
+        });
+        // Build effective indexes from (locals + already adopted children)
+        this.reindex();
+        this.bump('reset');
+        // Register resource flows with the scope
+        const scope = this.providers.getActiveScope();
+        await scope.registryFlows(read_resource_flow_1.default, resources_list_flow_1.default, resource_templates_list_flow_1.default, subscribe_resource_flow_1.default, unsubscribe_resource_flow_1.default);
+    }
+    /* -------------------- Adoption: reference child instances (no cloning) -------------------- */
+    /**
+     * Adopt resources from a child registry. Parent runs after children are ready.
+     * We *reference* the child's resource instances; no duplicates are created.
+     */
+    adoptFromChild(child, _childOwner) {
+        if (this.children.has(child))
+            return;
+        const childRows = child.listAllIndexed();
+        const prepend = this.owner ? [this.owner] : [];
+        const adoptedRows = childRows.map((r) => this.relineage(r, prepend));
+        this.adopted.set(child, adoptedRows);
+        this.children.add(child);
+        // keep live if child changes
+        child.subscribe({ immediate: false }, () => {
+            const latest = child.listAllIndexed().map((r) => this.relineage(r, prepend));
+            this.adopted.set(child, latest);
+            this.reindex();
+            this.bump('reset');
+        });
+        this.reindex();
+        this.bump('reset');
     }
-    initialize() {
-        return Promise.resolve();
+    /* -------------------- Public API -------------------- */
+    /**
+     * Get all static resources (not templates)
+     */
+    getResources(includeHidden = false) {
+        const all = this.listAllIndexed();
+        return all
+            .filter((r) => !r.isTemplate)
+            .filter((r) => {
+            const meta = r.instance.metadata;
+            const hidden = 'hideFromDiscovery' in meta && meta.hideFromDiscovery === true;
+            return !hidden || includeHidden;
+        })
+            .map((r) => r.instance);
     }
-    getResources() {
-        return [];
+    /**
+     * Get all resource templates
+     */
+    getResourceTemplates() {
+        const all = this.listAllIndexed();
+        return all.filter((r) => r.isTemplate).map((r) => r.instance);
     }
+    /**
+     * Get inline resources (local only)
+     */
     getInlineResources() {
-        throw new Error('Method not implemented.');
+        return [...this.instances.values()];
+    }
+    /**
+     * Find a resource by exact URI match
+     */
+    findByUri(uri) {
+        const row = this.byUri.get(uri);
+        return row?.instance;
+    }
+    /**
+     * Match a URI against template resources and extract parameters
+     */
+    matchTemplateByUri(uri) {
+        // Try each template resource
+        for (const row of this.listAllIndexed()) {
+            if (!row.isTemplate)
+                continue;
+            const match = row.instance.matchUri(uri);
+            if (match.matches) {
+                return { instance: row.instance, params: match.params };
+            }
+        }
+        return undefined;
+    }
+    /**
+     * Find a resource by URI - tries exact match first, then template matching
+     */
+    findResourceForUri(uri) {
+        // Try exact URI match first
+        const exact = this.findByUri(uri);
+        if (exact) {
+            return { instance: exact, params: {} };
+        }
+        // Try template matching
+        return this.matchTemplateByUri(uri);
+    }
+    /** Internal snapshot of effective indexed rows (locals + adopted). */
+    listAllIndexed() {
+        return [...this.localRows, ...[...this.adopted.values()].flat()];
+    }
+    /** List all instances (locals + adopted). */
+    listAllInstances() {
+        return this.listAllIndexed().map((r) => r.instance);
+    }
+    /** List instances by owner path (e.g. "app:Portal/plugin:Okta") */
+    listByOwner(ownerPath) {
+        return (this.byOwner.get(ownerPath) ?? []).map((r) => r.instance);
+    }
+    /* -------------------- Indexing & lookups -------------------- */
+    reindex() {
+        const effective = this.listAllIndexed();
+        this.byQualifiedId.clear();
+        this.byName.clear();
+        this.byUri.clear();
+        this.byUriTemplate.clear();
+        this.byOwnerAndName.clear();
+        this.byOwner.clear();
+        for (const r of effective) {
+            this.byQualifiedId.set(r.qualifiedId, r);
+            const listByName = this.byName.get(r.baseName) ?? [];
+            listByName.push(r);
+            this.byName.set(r.baseName, listByName);
+            const byOwnerKey = this.byOwner.get(r.ownerKey) ?? [];
+            byOwnerKey.push(r);
+            this.byOwner.set(r.ownerKey, byOwnerKey);
+            const on = `${r.ownerKey}:${r.baseName}`;
+            if (!this.byOwnerAndName.has(on))
+                this.byOwnerAndName.set(on, r);
+            // Index by URI or URI template
+            if (r.isTemplate && r.uriTemplate) {
+                this.byUriTemplate.set(r.uriTemplate, r);
+            }
+            else if (r.uri) {
+                this.byUri.set(r.uri, r);
+            }
+        }
+    }
+    /* -------------------- Conflict-aware exported names -------------------- */
+    /**
+     * Produce unique, MCP-valid exported names.
+     */
+    exportResolvedNames(opts) {
+        const cfg = { ...resource_types_1.DEFAULT_RESOURCE_EXPORT_OPTS, ...(opts ?? {}) };
+        const rows = this.listAllIndexed().map((r) => {
+            const base = (0, resource_utils_1.normalizeSegment)(r.baseName, cfg.case);
+            const isLocal = r.source === this;
+            const provider = (0, resource_utils_1.normalizeProviderId)(this.providerIdOf(r.instance), cfg.case);
+            const ownerPath = (0, resource_utils_1.normalizeOwnerPath)(r.ownerKey, cfg.case);
+            return { base, row: r, isLocal, provider, ownerPath };
+        });
+        // group by standardized base
+        const byBase = new Map();
+        for (const r of rows) {
+            const list = byBase.get(r.base) ?? [];
+            list.push(r);
+            byBase.set(r.base, list);
+        }
+        const out = new Map();
+        for (const [base, group] of byBase.entries()) {
+            if (group.length === 1) {
+                const g = group[0];
+                out.set((0, resource_utils_1.ensureMaxLen)(base, cfg.maxLen), g.row.instance);
+                continue;
+            }
+            const locals = group.filter((g) => g.isLocal);
+            const children = group.filter((g) => !g.isLocal);
+            if (cfg.prefixChildrenOnConflict && locals.length > 0) {
+                // Locals
+                if (locals.length === 1) {
+                    const localName = (0, resource_utils_1.ensureMaxLen)(base, cfg.maxLen);
+                    out.set(disambiguate(localName, out, cfg), locals[0].row.instance);
+                }
+                else {
+                    for (const l of locals) {
+                        const pref = (0, resource_utils_1.normalizeOwnerPath)(l.ownerPath, cfg.case);
+                        const name = (0, resource_utils_1.ensureMaxLen)(`${pref}${(0, resource_utils_1.sepFor)(cfg.case)}${base}`, cfg.maxLen);
+                        out.set(disambiguate(name, out, cfg), l.row.instance);
+                    }
+                }
+                // Children
+                for (const c of children) {
+                    const pre = cfg.prefixSource === 'provider' ? c.provider ?? c.ownerPath : c.ownerPath;
+                    const name = (0, resource_utils_1.ensureMaxLen)(`${pre}${(0, resource_utils_1.sepFor)(cfg.case)}${base}`, cfg.maxLen);
+                    out.set(disambiguate(name, out, cfg), c.row.instance);
+                }
+            }
+            else {
+                // Prefix everyone by source
+                for (const r of group) {
+                    const pre = cfg.prefixSource === 'provider' ? r.provider ?? r.ownerPath : r.ownerPath;
+                    const name = (0, resource_utils_1.ensureMaxLen)(`${pre}${(0, resource_utils_1.sepFor)(cfg.case)}${base}`, cfg.maxLen);
+                    out.set(disambiguate(name, out, cfg), r.row.instance);
+                }
+            }
+        }
+        return [...out.entries()].sort((a, b) => a[0].localeCompare(b[0])).map(([name, instance]) => ({ name, instance }));
+        function disambiguate(candidate, pool, cfg) {
+            if (!pool.has(candidate))
+                return candidate;
+            const maxAttempts = 10000;
+            let n = 2;
+            while (n <= maxAttempts) {
+                const withN = (0, resource_utils_1.ensureMaxLen)(`${candidate}${(0, resource_utils_1.sepFor)(cfg.case)}${n}`, cfg.maxLen);
+                if (!pool.has(withN))
+                    return withN;
+                n++;
+            }
+            throw new Error(`Failed to disambiguate name "${candidate}" after ${maxAttempts} attempts`);
+        }
+    }
+    /** Lookup by the exported (resolved) name. */
+    getExported(name, opts) {
+        const pairs = this.exportResolvedNames(opts);
+        return pairs.find((p) => p.name === name)?.instance;
+    }
+    /* -------------------- Subscriptions -------------------- */
+    subscribe(opts, cb) {
+        const filter = opts.filter ?? (() => true);
+        if (opts.immediate) {
+            cb({
+                kind: 'reset',
+                changeScope: 'global',
+                version: this.version,
+                snapshot: this.listAllInstances().filter(filter),
+            });
+        }
+        return this.emitter.on((e) => cb({ ...e, snapshot: this.listAllInstances().filter(filter) }));
+    }
+    bump(kind) {
+        const version = ++this.version;
+        this.emitter.emit({ kind, changeScope: 'global', version, snapshot: this.listAllInstances() });
+    }
+    /* -------------------- Helpers -------------------- */
+    /** Build an IndexedResource row */
+    makeRow(token, instance, lineage, source) {
+        const ownerKey = (0, resource_utils_1.ownerKeyOf)(lineage);
+        const baseName = instance.name;
+        const qualifiedName = (0, resource_utils_1.qualifiedNameOf)(lineage, baseName);
+        const qualifiedId = `${ownerKey}:${(0, utils_1.tokenName)(token)}`;
+        return {
+            token,
+            instance,
+            baseName,
+            uri: instance.uri,
+            uriTemplate: instance.uriTemplate,
+            isTemplate: instance.isTemplate,
+            lineage,
+            ownerKey,
+            qualifiedName,
+            qualifiedId,
+            source,
+        };
+    }
+    /** Clone a child row and prepend lineage (with adjacent de-dup to avoid double prefixes). */
+    relineage(row, prepend) {
+        const merged = [...prepend, ...row.lineage];
+        const lineage = dedupLineage(merged);
+        const ownerKey = (0, resource_utils_1.ownerKeyOf)(lineage);
+        const qualifiedName = (0, resource_utils_1.qualifiedNameOf)(lineage, row.baseName);
+        const qualifiedId = `${ownerKey}:${(0, utils_1.tokenName)(row.token)}`;
+        return {
+            token: row.token,
+            instance: row.instance, // REFERENCE the same instance
+            baseName: row.baseName,
+            uri: row.uri,
+            uriTemplate: row.uriTemplate,
+            isTemplate: row.isTemplate,
+            lineage,
+            ownerKey,
+            qualifiedName,
+            qualifiedId,
+            source: row.source, // keep original source (who constructed instance)
+        };
+    }
+    /** Best-effort provider id used for prefixing. */
+    providerIdOf(inst) {
+        try {
+            const meta = inst.getMetadata?.();
+            if (!meta || typeof meta !== 'object')
+                return undefined;
+            const metaObj = meta;
+            const maybe = metaObj['providerId'] ?? metaObj['provider'] ?? metaObj['ownerId'];
+            if (typeof maybe === 'string' && maybe.length > 0)
+                return maybe;
+            const cls = metaObj['cls'];
+            if (cls && typeof cls === 'function') {
+                const id = (0, utils_1.getMetadata)('id', cls);
+                if (typeof id === 'string' && id.length > 0)
+                    return id;
+                if ('name' in cls && typeof cls.name === 'string')
+                    return cls.name;
+            }
+        }
+        catch {
+            /* ignore */
+        }
+        return undefined;
+    }
+    /** True if this registry (or adopted children) has any resources. */
+    hasAny() {
+        return this.listAllIndexed().length > 0 || this.tokens.size > 0;
+    }
+    /**
+     * Get the MCP capabilities for resources.
+     * These are reported to clients during initialization.
+     */
+    getCapabilities() {
+        return this.hasAny()
+            ? {
+                resources: {
+                    // Subscription support per MCP 2025-11-25 spec
+                    subscribe: true,
+                    // List change notifications are only supported when resources are registered
+                    listChanged: true,
+                },
+            }
+            : {};
+    }
+    /**
+     * Dynamically register a resource or resource template at runtime.
+     *
+     * Used for system resources like the ui:// template that should be
+     * registered when tools with UI configs exist.
+     *
+     * @param resourceDef - Resource class, function, or template to register
+     */
+    registerDynamicResource(resourceDef) {
+        const isTemplate = (0, resource_utils_1.isResourceTemplate)(resourceDef);
+        const rec = isTemplate ? (0, resource_utils_1.normalizeResourceTemplate)(resourceDef) : (0, resource_utils_1.normalizeResource)(resourceDef);
+        const token = rec.provide;
+        // Skip if already registered
+        if (this.tokens.has(token)) {
+            return;
+        }
+        // Add to registry structures
+        this.tokens.add(token);
+        this.defs.set(token, rec);
+        // Build dependency graph (same pattern as buildGraph)
+        const deps = (0, resource_utils_1.resourceDiscoveryDeps)(rec);
+        const depSet = new Set();
+        for (const d of deps) {
+            // Validate against hierarchical providers; throws early if missing
+            this.providers.get(d);
+            depSet.add(d);
+        }
+        this.graph.set(token, depSet);
+        // Create instance
+        const ri = new resource_instance_1.ResourceInstance(rec, this.providers, this.owner);
+        this.instances.set(token, ri);
+        // Add to local rows with lineage
+        const lineage = this.owner ? [this.owner] : [];
+        const row = this.makeRow(token, ri, lineage, this);
+        this.localRows.push(row);
+        // Rebuild indexes and emit change event
+        this.reindex();
+        this.bump('reset');
     }
 }
 exports.default = ResourceRegistry;
+/* -------------------- lineage utility -------------------- */
+/** Remove only adjacent duplicates like [adapter:x, adapter:x] → [adapter:x] */
+function dedupLineage(l) {
+    const out = [];
+    for (const o of l) {
+        const last = out[out.length - 1];
+        if (!last || last.kind !== o.kind || last.id !== o.id)
+            out.push(o);
+    }
+    return out;
+}
 //# sourceMappingURL=resource.registry.js.map

package/src/resource/resource.registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"resource.registry.js","sourceRoot":"","sources":["../../../src/resource/resource.registry.ts"],"names":[],"mappings":";;AAQA,0CAA+C;AAG/C,MAAqB,gBAAiB,SAAQ,2BAA+D;IAG3G,YAAY,SAA2B,EAAE,IAAgB;QACvD,KAAK,CAAC,kBAAkB,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;IAC7C,CAAC;IAGS,QAAQ,CAAC,IAAoB;QACrC,MAAM,MAAM,GAAG,IAAI,GAAG,EAAS,CAAC;QAChC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAyB,CAAC;QAC9C,MAAM,KAAK,GAAG,IAAI,GAAG,EAAqB,CAAC;QAE3C,OAAO;YACL,MAAM;YACN,IAAI;YACJ,KAAK;SACN,CAAC;IACJ,CAAC;IAED,UAAU;QACR,iCAAiC;IACnC,CAAC;IAES,UAAU;QAClB,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC3B,CAAC;IAGD,YAAY;QACV,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,kBAAkB;QAChB,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC7C,CAAC;CACF;AApCD,mCAoCC","sourcesContent":["import ProviderRegistry from '../provider/provider.registry';\nimport {\n  ResourceEntry, ResourceRecord,\n  ResourceRegistryInterface,\n  ResourceType,\n  Token,\n  ToolType,\n} from '../common';\nimport { RegistryAbstract } from '../regsitry';\n\n\nexport default class ResourceRegistry extends RegistryAbstract<ResourceEntry, ResourceRecord, ResourceType[]>\n  implements ResourceRegistryInterface {\n\n  constructor(providers: ProviderRegistry, list: ToolType[]) {\n    super('ResourceRegistry', providers, list);\n  }\n\n\n  protected buildMap(list: ResourceType[]) {\n    const tokens = new Set<Token>();\n    const defs = new Map<Token, ResourceRecord>();\n    const graph = new Map<Token, Set<Token>>();\n\n    return {\n      tokens,\n      defs,\n      graph,\n    };\n  }\n\n  buildGraph() {\n    // TODO: implement graph building\n  }\n\n  protected initialize() {\n    return Promise.resolve();\n  }\n\n\n  getResources() {\n    return [];\n  }\n\n  getInlineResources(): ResourceEntry<any, any>[] {\n    throw new Error('Method not implemented.');\n  }\n}\n"]}
+{"version":3,"file":"resource.registry.js","sourceRoot":"","sources":["../../../src/resource/resource.registry.ts"],"names":[],"mappings":"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","sourcesContent":["// file: libs/sdk/src/resource/resource.registry.ts\n\nimport {\n  EntryLineage,\n  EntryOwnerRef,\n  Token,\n  ResourceEntry,\n  ResourceRecord,\n  ResourceTemplateRecord,\n  ResourceRegistryInterface,\n  ResourceType,\n} from '../common';\nimport { getMetadata, tokenName } from '../utils';\nimport { ResourceChangeEvent, ResourceEmitter } from './resource.events';\nimport ProviderRegistry from '../provider/provider.registry';\nimport {\n  ensureMaxLen,\n  normalizeOwnerPath,\n  normalizeProviderId,\n  normalizeSegment,\n  normalizeResource,\n  normalizeResourceTemplate,\n  isResourceTemplate,\n  ownerKeyOf,\n  qualifiedNameOf,\n  sepFor,\n  resourceDiscoveryDeps,\n} from './resource.utils';\nimport { RegistryAbstract, RegistryBuildMapResult } from '../regsitry';\nimport { ResourceInstance } from './resource.instance';\nimport { DEFAULT_RESOURCE_EXPORT_OPTS, ResourceExportOptions, IndexedResource } from './resource.types';\nimport ReadResourceFlow from './flows/read-resource.flow';\nimport ResourcesListFlow from './flows/resources-list.flow';\nimport ResourceTemplatesListFlow from './flows/resource-templates-list.flow';\nimport SubscribeResourceFlow from './flows/subscribe-resource.flow';\nimport UnsubscribeResourceFlow from './flows/unsubscribe-resource.flow';\nimport type { ServerCapabilities } from '@modelcontextprotocol/sdk/types.js';\n\nexport default class ResourceRegistry\n  extends RegistryAbstract<\n    ResourceInstance, // instances map holds ResourceInstance\n    ResourceRecord | ResourceTemplateRecord,\n    ResourceType[]\n  >\n  implements ResourceRegistryInterface\n{\n  /** Who owns this registry (used for provenance). */\n  owner: EntryOwnerRef;\n\n  /** Resources truly owned/constructed by THIS registry (with lineage applied) */\n  private localRows: IndexedResource[] = [];\n\n  /** Adopted resource rows from each child registry (references to the same instances) */\n  private adopted = new Map<ResourceRegistry, IndexedResource[]>();\n\n  /** Children registries that we track */\n  private children = new Set<ResourceRegistry>();\n\n  // ---- O(1) indexes over EFFECTIVE set (local + adopted) ----\n  private byQualifiedId = new Map<string, IndexedResource>(); // qualifiedId -> row\n  private byName = new Map<string, IndexedResource[]>(); // baseName -> rows\n  private byUri = new Map<string, IndexedResource>(); // uri -> row (static resources)\n  private byUriTemplate = new Map<string, IndexedResource>(); // uriTemplate -> row (templates)\n  private byOwnerAndName = new Map<string, IndexedResource>(); // \"ownerKey:name\" -> row\n  private byOwner = new Map<string, IndexedResource[]>(); // ownerKey -> rows\n\n  // version + emitter\n  private version = 0;\n  private emitter = new ResourceEmitter();\n\n  constructor(providers: ProviderRegistry, list: ResourceType[], owner: EntryOwnerRef) {\n    // disable auto so subclass fields initialize first\n    super('ResourceRegistry', providers, list, false);\n    this.owner = owner;\n\n    // now it's safe to run the lifecycle\n    this.buildGraph();\n    this.ready = this.initialize();\n  }\n\n  /* -------------------- Build-time: defs + dep checks -------------------- */\n\n  protected override buildMap(list: ResourceType[]): RegistryBuildMapResult<ResourceRecord | ResourceTemplateRecord> {\n    const tokens = new Set<Token>();\n    const defs = new Map<Token, ResourceRecord | ResourceTemplateRecord>();\n    const graph = new Map<Token, Set<Token>>();\n\n    for (const raw of list) {\n      // Determine if it's a template or static resource\n      const isTemplate = isResourceTemplate(raw);\n      const rec = isTemplate ? normalizeResourceTemplate(raw) : normalizeResource(raw);\n\n      const provide = rec.provide;\n      tokens.add(provide);\n      defs.set(provide, rec);\n      graph.set(provide, new Set());\n    }\n    return { tokens, defs, graph };\n  }\n\n  protected buildGraph() {\n    for (const token of this.tokens) {\n      const rec = this.defs.get(token)!;\n      const deps = resourceDiscoveryDeps(rec);\n\n      for (const d of deps) {\n        // Validate against hierarchical providers; throws early if missing\n        this.providers.get(d);\n        this.graph.get(token)!.add(d);\n      }\n    }\n  }\n\n  /* -------------------- Initialize: create ONE ResourceInstance per local resource -------------------- */\n\n  protected override async initialize(): Promise<void> {\n    // Instantiate each local resource once and store in this.instances\n    for (const token of this.tokens) {\n      const rec = this.defs.get(token)!;\n\n      // Single, authoritative instance per local resource\n      const ri = new ResourceInstance(rec, this.providers, this.owner);\n      this.instances.set(token as Token<ResourceInstance>, ri);\n\n      const lineage: EntryLineage = this.owner ? [this.owner] : [];\n      const row = this.makeRow(token, ri, lineage, this);\n      this.localRows.push(row);\n    }\n\n    // Adopt resources from child app registries\n    const childAppRegistries = this.providers.getRegistries('AppRegistry');\n    childAppRegistries.forEach((appRegistry) => {\n      const apps = appRegistry.getApps();\n      for (const app of apps) {\n        const appResourceRegistries = app.providers.getRegistries('ResourceRegistry');\n        appResourceRegistries\n          .filter((r) => r.owner.kind === 'app')\n          .forEach((appResourceRegistry) => {\n            this.adoptFromChild(appResourceRegistry as ResourceRegistry, appResourceRegistry.owner);\n          });\n      }\n    });\n\n    // Adopt resources from other child resource registries\n    const childResourceRegistries = this.providers.getRegistries('ResourceRegistry');\n    childResourceRegistries\n      .filter((r) => r !== this)\n      .forEach((resourceRegistry) => {\n        this.adoptFromChild(resourceRegistry as ResourceRegistry, resourceRegistry.owner);\n      });\n\n    // Build effective indexes from (locals + already adopted children)\n    this.reindex();\n    this.bump('reset');\n\n    // Register resource flows with the scope\n    const scope = this.providers.getActiveScope();\n    await scope.registryFlows(\n      ReadResourceFlow,\n      ResourcesListFlow,\n      ResourceTemplatesListFlow,\n      SubscribeResourceFlow,\n      UnsubscribeResourceFlow,\n    );\n  }\n\n  /* -------------------- Adoption: reference child instances (no cloning) -------------------- */\n\n  /**\n   * Adopt resources from a child registry. Parent runs after children are ready.\n   * We *reference* the child's resource instances; no duplicates are created.\n   */\n  adoptFromChild(child: ResourceRegistry, _childOwner: EntryOwnerRef): void {\n    if (this.children.has(child)) return;\n\n    const childRows = child.listAllIndexed();\n    const prepend: EntryLineage = this.owner ? [this.owner] : [];\n\n    const adoptedRows = childRows.map((r) => this.relineage(r, prepend));\n\n    this.adopted.set(child, adoptedRows);\n    this.children.add(child);\n\n    // keep live if child changes\n    child.subscribe({ immediate: false }, () => {\n      const latest = child.listAllIndexed().map((r) => this.relineage(r, prepend));\n      this.adopted.set(child, latest);\n      this.reindex();\n      this.bump('reset');\n    });\n\n    this.reindex();\n    this.bump('reset');\n  }\n\n  /* -------------------- Public API -------------------- */\n\n  /**\n   * Get all static resources (not templates)\n   */\n  getResources(includeHidden = false): ResourceEntry[] {\n    const all = this.listAllIndexed();\n    return all\n      .filter((r) => !r.isTemplate)\n      .filter((r) => {\n        const meta = r.instance.metadata;\n        const hidden = 'hideFromDiscovery' in meta && meta.hideFromDiscovery === true;\n        return !hidden || includeHidden;\n      })\n      .map((r) => r.instance);\n  }\n\n  /**\n   * Get all resource templates\n   */\n  getResourceTemplates(): ResourceEntry[] {\n    const all = this.listAllIndexed();\n    return all.filter((r) => r.isTemplate).map((r) => r.instance);\n  }\n\n  /**\n   * Get inline resources (local only)\n   */\n  getInlineResources(): ResourceEntry[] {\n    return [...this.instances.values()];\n  }\n\n  /**\n   * Find a resource by exact URI match\n   */\n  findByUri(uri: string): ResourceInstance | undefined {\n    const row = this.byUri.get(uri);\n    return row?.instance;\n  }\n\n  /**\n   * Match a URI against template resources and extract parameters\n   */\n  matchTemplateByUri(uri: string): { instance: ResourceInstance; params: Record<string, string> } | undefined {\n    // Try each template resource\n    for (const row of this.listAllIndexed()) {\n      if (!row.isTemplate) continue;\n\n      const match = row.instance.matchUri(uri);\n      if (match.matches) {\n        return { instance: row.instance, params: match.params };\n      }\n    }\n    return undefined;\n  }\n\n  /**\n   * Find a resource by URI - tries exact match first, then template matching\n   */\n  findResourceForUri(uri: string): { instance: ResourceInstance; params: Record<string, string> } | undefined {\n    // Try exact URI match first\n    const exact = this.findByUri(uri);\n    if (exact) {\n      return { instance: exact, params: {} };\n    }\n\n    // Try template matching\n    return this.matchTemplateByUri(uri);\n  }\n\n  /** Internal snapshot of effective indexed rows (locals + adopted). */\n  listAllIndexed(): IndexedResource[] {\n    return [...this.localRows, ...[...this.adopted.values()].flat()];\n  }\n\n  /** List all instances (locals + adopted). */\n  listAllInstances(): readonly ResourceInstance[] {\n    return this.listAllIndexed().map((r) => r.instance);\n  }\n\n  /** List instances by owner path (e.g. \"app:Portal/plugin:Okta\") */\n  listByOwner(ownerPath: string): readonly ResourceInstance[] {\n    return (this.byOwner.get(ownerPath) ?? []).map((r) => r.instance);\n  }\n\n  /* -------------------- Indexing & lookups -------------------- */\n\n  private reindex() {\n    const effective = this.listAllIndexed();\n\n    this.byQualifiedId.clear();\n    this.byName.clear();\n    this.byUri.clear();\n    this.byUriTemplate.clear();\n    this.byOwnerAndName.clear();\n    this.byOwner.clear();\n\n    for (const r of effective) {\n      this.byQualifiedId.set(r.qualifiedId, r);\n\n      const listByName = this.byName.get(r.baseName) ?? [];\n      listByName.push(r);\n      this.byName.set(r.baseName, listByName);\n\n      const byOwnerKey = this.byOwner.get(r.ownerKey) ?? [];\n      byOwnerKey.push(r);\n      this.byOwner.set(r.ownerKey, byOwnerKey);\n\n      const on = `${r.ownerKey}:${r.baseName}`;\n      if (!this.byOwnerAndName.has(on)) this.byOwnerAndName.set(on, r);\n\n      // Index by URI or URI template\n      if (r.isTemplate && r.uriTemplate) {\n        this.byUriTemplate.set(r.uriTemplate, r);\n      } else if (r.uri) {\n        this.byUri.set(r.uri, r);\n      }\n    }\n  }\n\n  /* -------------------- Conflict-aware exported names -------------------- */\n\n  /**\n   * Produce unique, MCP-valid exported names.\n   */\n  exportResolvedNames(opts?: ResourceExportOptions): Array<{ name: string; instance: ResourceInstance }> {\n    const cfg = { ...DEFAULT_RESOURCE_EXPORT_OPTS, ...(opts ?? {}) };\n\n    const rows = this.listAllIndexed().map((r) => {\n      const base = normalizeSegment(r.baseName, cfg.case);\n      const isLocal = r.source === this;\n      const provider = normalizeProviderId(this.providerIdOf(r.instance), cfg.case);\n      const ownerPath = normalizeOwnerPath(r.ownerKey, cfg.case);\n      return { base, row: r, isLocal, provider, ownerPath };\n    });\n\n    // group by standardized base\n    const byBase = new Map<string, typeof rows>();\n    for (const r of rows) {\n      const list = byBase.get(r.base) ?? [];\n      list.push(r);\n      byBase.set(r.base, list);\n    }\n\n    const out = new Map<string, ResourceInstance>();\n\n    for (const [base, group] of byBase.entries()) {\n      if (group.length === 1) {\n        const g = group[0];\n        out.set(ensureMaxLen(base, cfg.maxLen), g.row.instance);\n        continue;\n      }\n\n      const locals = group.filter((g) => g.isLocal);\n      const children = group.filter((g) => !g.isLocal);\n\n      if (cfg.prefixChildrenOnConflict && locals.length > 0) {\n        // Locals\n        if (locals.length === 1) {\n          const localName = ensureMaxLen(base, cfg.maxLen);\n          out.set(disambiguate(localName, out, cfg), locals[0].row.instance);\n        } else {\n          for (const l of locals) {\n            const pref = normalizeOwnerPath(l.ownerPath, cfg.case);\n            const name = ensureMaxLen(`${pref}${sepFor(cfg.case)}${base}`, cfg.maxLen);\n            out.set(disambiguate(name, out, cfg), l.row.instance);\n          }\n        }\n\n        // Children\n        for (const c of children) {\n          const pre = cfg.prefixSource === 'provider' ? c.provider ?? c.ownerPath : c.ownerPath;\n          const name = ensureMaxLen(`${pre}${sepFor(cfg.case)}${base}`, cfg.maxLen);\n          out.set(disambiguate(name, out, cfg), c.row.instance);\n        }\n      } else {\n        // Prefix everyone by source\n        for (const r of group) {\n          const pre = cfg.prefixSource === 'provider' ? r.provider ?? r.ownerPath : r.ownerPath;\n          const name = ensureMaxLen(`${pre}${sepFor(cfg.case)}${base}`, cfg.maxLen);\n          out.set(disambiguate(name, out, cfg), r.row.instance);\n        }\n      }\n    }\n\n    return [...out.entries()].sort((a, b) => a[0].localeCompare(b[0])).map(([name, instance]) => ({ name, instance }));\n\n    function disambiguate(candidate: string, pool: Map<string, any>, cfg: Required<ResourceExportOptions>): string {\n      if (!pool.has(candidate)) return candidate;\n      const maxAttempts = 10000;\n      let n = 2;\n      while (n <= maxAttempts) {\n        const withN = ensureMaxLen(`${candidate}${sepFor(cfg.case)}${n}`, cfg.maxLen);\n        if (!pool.has(withN)) return withN;\n        n++;\n      }\n      throw new Error(`Failed to disambiguate name \"${candidate}\" after ${maxAttempts} attempts`);\n    }\n  }\n\n  /** Lookup by the exported (resolved) name. */\n  getExported(name: string, opts?: ResourceExportOptions): ResourceInstance | undefined {\n    const pairs = this.exportResolvedNames(opts);\n    return pairs.find((p) => p.name === name)?.instance;\n  }\n\n  /* -------------------- Subscriptions -------------------- */\n\n  subscribe(\n    opts: { immediate?: boolean; filter?: (i: ResourceInstance) => boolean },\n    cb: (evt: ResourceChangeEvent) => void,\n  ): () => void {\n    const filter = opts.filter ?? (() => true);\n    if (opts.immediate) {\n      cb({\n        kind: 'reset',\n        changeScope: 'global',\n        version: this.version,\n        snapshot: this.listAllInstances().filter(filter),\n      });\n    }\n    return this.emitter.on((e) => cb({ ...e, snapshot: this.listAllInstances().filter(filter) }));\n  }\n\n  private bump(kind: ResourceChangeEvent['kind']) {\n    const version = ++this.version;\n    this.emitter.emit({ kind, changeScope: 'global', version, snapshot: this.listAllInstances() });\n  }\n\n  /* -------------------- Helpers -------------------- */\n\n  /** Build an IndexedResource row */\n  private makeRow(\n    token: Token,\n    instance: ResourceInstance,\n    lineage: EntryLineage,\n    source: ResourceRegistry,\n  ): IndexedResource {\n    const ownerKey = ownerKeyOf(lineage);\n    const baseName = instance.name;\n    const qualifiedName = qualifiedNameOf(lineage, baseName);\n    const qualifiedId = `${ownerKey}:${tokenName(token)}`;\n    return {\n      token,\n      instance,\n      baseName,\n      uri: instance.uri,\n      uriTemplate: instance.uriTemplate,\n      isTemplate: instance.isTemplate,\n      lineage,\n      ownerKey,\n      qualifiedName,\n      qualifiedId,\n      source,\n    };\n  }\n\n  /** Clone a child row and prepend lineage (with adjacent de-dup to avoid double prefixes). */\n  private relineage(row: IndexedResource, prepend: EntryLineage): IndexedResource {\n    const merged = [...prepend, ...row.lineage];\n    const lineage = dedupLineage(merged);\n\n    const ownerKey = ownerKeyOf(lineage);\n    const qualifiedName = qualifiedNameOf(lineage, row.baseName);\n    const qualifiedId = `${ownerKey}:${tokenName(row.token)}`;\n    return {\n      token: row.token,\n      instance: row.instance, // REFERENCE the same instance\n      baseName: row.baseName,\n      uri: row.uri,\n      uriTemplate: row.uriTemplate,\n      isTemplate: row.isTemplate,\n      lineage,\n      ownerKey,\n      qualifiedName,\n      qualifiedId,\n      source: row.source, // keep original source (who constructed instance)\n    };\n  }\n\n  /** Best-effort provider id used for prefixing. */\n  private providerIdOf(inst: ResourceInstance): string | undefined {\n    try {\n      const meta: unknown = inst.getMetadata?.();\n      if (!meta || typeof meta !== 'object') return undefined;\n\n      const metaObj = meta as Record<string, unknown>;\n      const maybe = metaObj['providerId'] ?? metaObj['provider'] ?? metaObj['ownerId'];\n      if (typeof maybe === 'string' && maybe.length > 0) return maybe;\n\n      const cls = metaObj['cls'];\n      if (cls && typeof cls === 'function') {\n        const id = getMetadata('id', cls);\n        if (typeof id === 'string' && id.length > 0) return id;\n        if ('name' in cls && typeof cls.name === 'string') return cls.name;\n      }\n    } catch {\n      /* ignore */\n    }\n    return undefined;\n  }\n\n  /** True if this registry (or adopted children) has any resources. */\n  hasAny(): boolean {\n    return this.listAllIndexed().length > 0 || this.tokens.size > 0;\n  }\n\n  /**\n   * Get the MCP capabilities for resources.\n   * These are reported to clients during initialization.\n   */\n  getCapabilities(): Partial<ServerCapabilities> {\n    return this.hasAny()\n      ? {\n          resources: {\n            // Subscription support per MCP 2025-11-25 spec\n            subscribe: true,\n            // List change notifications are only supported when resources are registered\n            listChanged: true,\n          },\n        }\n      : {};\n  }\n\n  /**\n   * Dynamically register a resource or resource template at runtime.\n   *\n   * Used for system resources like the ui:// template that should be\n   * registered when tools with UI configs exist.\n   *\n   * @param resourceDef - Resource class, function, or template to register\n   */\n  registerDynamicResource(resourceDef: ResourceType): void {\n    const isTemplate = isResourceTemplate(resourceDef);\n    const rec = isTemplate ? normalizeResourceTemplate(resourceDef) : normalizeResource(resourceDef);\n    const token = rec.provide;\n\n    // Skip if already registered\n    if (this.tokens.has(token)) {\n      return;\n    }\n\n    // Add to registry structures\n    this.tokens.add(token);\n    this.defs.set(token, rec);\n\n    // Build dependency graph (same pattern as buildGraph)\n    const deps = resourceDiscoveryDeps(rec);\n    const depSet = new Set<Token>();\n    for (const d of deps) {\n      // Validate against hierarchical providers; throws early if missing\n      this.providers.get(d);\n      depSet.add(d);\n    }\n    this.graph.set(token, depSet);\n\n    // Create instance\n    const ri = new ResourceInstance(rec, this.providers, this.owner);\n    this.instances.set(token as Token<ResourceInstance>, ri);\n\n    // Add to local rows with lineage\n    const lineage: EntryLineage = this.owner ? [this.owner] : [];\n    const row = this.makeRow(token, ri, lineage, this);\n    this.localRows.push(row);\n\n    // Rebuild indexes and emit change event\n    this.reindex();\n    this.bump('reset');\n  }\n}\n\n/* -------------------- lineage utility -------------------- */\n\n/** Remove only adjacent duplicates like [adapter:x, adapter:x] → [adapter:x] */\nfunction dedupLineage(l: EntryLineage): EntryLineage {\n  const out: EntryLineage = [];\n  for (const o of l) {\n    const last = out[out.length - 1];\n    if (!last || last.kind !== o.kind || last.id !== o.id) out.push(o);\n  }\n  return out;\n}\n"]}

package/src/resource/resource.types.d.ts

@@ -0,0 +1,35 @@
+import { EntryLineage, Token, Type, FuncType } from '../common';
+import { ResourceInstance } from './resource.instance';
+import ResourceRegistry from './resource.registry';
+import type { NameCase } from '../utils/naming.utils';
+export interface ResourceTemplateInterface<In = any, Out = any> {
+    execute(uri: string, params: Record<string, string>, context: any): Promise<Out>;
+}
+export type ResourceTemplateType<In = any, Out = any> = Type<ResourceTemplateInterface<In, Out>> | FuncType<ResourceTemplateInterface<In, Out>>;
+/** Internal augmented row: instance + provenance + token */
+export type IndexedResource = {
+    token: Token;
+    instance: ResourceInstance;
+    /** base resource name from metadata (unmodified) */
+    baseName: string;
+    /** URI for static resources */
+    uri?: string;
+    /** URI template for template resources */
+    uriTemplate?: string;
+    /** Whether this is a template resource */
+    isTemplate: boolean;
+    /** lineage & qualified info */
+    lineage: EntryLineage;
+    ownerKey: string;
+    qualifiedName: string;
+    qualifiedId: string;
+    /** which registry constructed the instance (the "owner" registry) */
+    source: ResourceRegistry;
+};
+export type ResourceExportOptions = {
+    case?: NameCase;
+    maxLen?: number;
+    prefixChildrenOnConflict?: boolean;
+    prefixSource?: 'provider' | 'owner';
+};
+export declare const DEFAULT_RESOURCE_EXPORT_OPTS: Required<ResourceExportOptions>;

package/src/resource/resource.types.js

@@ -0,0 +1,11 @@
+"use strict";
+// file: libs/sdk/src/resource/resource.types.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_RESOURCE_EXPORT_OPTS = void 0;
+exports.DEFAULT_RESOURCE_EXPORT_OPTS = {
+    case: 'snake',
+    maxLen: 64,
+    prefixChildrenOnConflict: true,
+    prefixSource: 'provider',
+};
+//# sourceMappingURL=resource.types.js.map

package/src/resource/resource.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource.types.js","sourceRoot":"","sources":["../../../src/resource/resource.types.ts"],"names":[],"mappings":";AAAA,gDAAgD;;;AAuDnC,QAAA,4BAA4B,GAAoC;IAC3E,IAAI,EAAE,OAAO;IACb,MAAM,EAAE,EAAE;IACV,wBAAwB,EAAE,IAAI;IAC9B,YAAY,EAAE,UAAU;CACzB,CAAC","sourcesContent":["// file: libs/sdk/src/resource/resource.types.ts\n\nimport { EntryLineage, Token, Type, FuncType } from '../common';\nimport { ResourceInstance } from './resource.instance';\nimport ResourceRegistry from './resource.registry';\nimport type { NameCase } from '../utils/naming.utils';\n\n// ============================================================================\n// Resource Template Type (interface equivalent)\n// ============================================================================\n\nexport interface ResourceTemplateInterface<In = any, Out = any> {\n  execute(uri: string, params: Record<string, string>, context: any): Promise<Out>;\n}\n\nexport type ResourceTemplateType<In = any, Out = any> =\n  | Type<ResourceTemplateInterface<In, Out>>\n  | FuncType<ResourceTemplateInterface<In, Out>>;\n\n// ============================================================================\n// Indexed Resource (for registry internal use)\n// ============================================================================\n\n/** Internal augmented row: instance + provenance + token */\nexport type IndexedResource = {\n  token: Token;\n  instance: ResourceInstance;\n  /** base resource name from metadata (unmodified) */\n  baseName: string;\n  /** URI for static resources */\n  uri?: string;\n  /** URI template for template resources */\n  uriTemplate?: string;\n  /** Whether this is a template resource */\n  isTemplate: boolean;\n  /** lineage & qualified info */\n  lineage: EntryLineage;\n  ownerKey: string; // \"app:Portal/plugin:Okta\"\n  qualifiedName: string; // \"app:Portal/plugin:Okta:resourceName\"\n  qualifiedId: string; // \"app:Portal/plugin:Okta:tokenName(<token>)\"\n  /** which registry constructed the instance (the \"owner\" registry) */\n  source: ResourceRegistry;\n};\n\n// ============================================================================\n// Export Name Options\n// ============================================================================\n\nexport type ResourceExportOptions = {\n  case?: NameCase; // default 'snake'\n  maxLen?: number; // default 64\n  prefixChildrenOnConflict?: boolean; // default true\n  prefixSource?: 'provider' | 'owner'; // default 'provider'\n};\n\nexport const DEFAULT_RESOURCE_EXPORT_OPTS: Required<ResourceExportOptions> = {\n  case: 'snake',\n  maxLen: 64,\n  prefixChildrenOnConflict: true,\n  prefixSource: 'provider',\n};\n"]}

package/src/resource/resource.utils.d.ts

@@ -0,0 +1,30 @@
+import { ResourceMetadata, ResourceTemplateMetadata, ResourceType, Token, ResourceRecord, ResourceTemplateRecord } from '../common';
+import { ResourceTemplateType } from './resource.types';
+export { splitWords, toCase, sepFor, normalizeSegment, normalizeProviderId, normalizeOwnerPath, shortHash, ensureMaxLen, } from '../utils/naming.utils';
+export { ownerKeyOf, qualifiedNameOf } from '../utils/lineage.utils';
+export { parseUriTemplate, matchUriTemplate, expandUriTemplate, extractTemplateParams, isUriTemplate, } from '../utils/uri-template.utils';
+export { buildResourceContent as buildParsedResourceResult } from '../utils/content.utils';
+/**
+ * Collect metadata from a class decorated with @FrontMcpResource
+ */
+export declare function collectResourceMetadata(cls: ResourceType): ResourceMetadata;
+/**
+ * Collect metadata from a class decorated with @FrontMcpResourceTemplate
+ */
+export declare function collectResourceTemplateMetadata(cls: ResourceTemplateType): ResourceTemplateMetadata;
+/**
+ * Normalize any resource input (class or function) to a ResourceRecord
+ */
+export declare function normalizeResource(item: any): ResourceRecord;
+/**
+ * Normalize any resource template input (class or function) to a ResourceTemplateRecord
+ */
+export declare function normalizeResourceTemplate(item: any): ResourceTemplateRecord;
+/**
+ * Determine if an item is a resource template (vs static resource)
+ */
+export declare function isResourceTemplate(item: any): boolean;
+/**
+ * Get dependency tokens for graph/cycle detection
+ */
+export declare function resourceDiscoveryDeps(rec: ResourceRecord | ResourceTemplateRecord): Token[];