@frontmcp/sdk 0.6.3 → 0.7.2

package/agent/agent.registry.d.ts

@@ -0,0 +1,137 @@
+import { Token } from '@frontmcp/di';
+import { EntryLineage, EntryOwnerRef, AgentEntry, AgentRecord, AgentType } from '../common';
+import { AgentChangeEvent } from './agent.events';
+import ProviderRegistry from '../provider/provider.registry';
+import { RegistryAbstract, RegistryBuildMapResult } from '../regsitry';
+import { AgentInstance } from './agent.instance';
+import type { Tool, ServerCapabilities } from '@modelcontextprotocol/sdk/types.js';
+/**
+ * Indexed agent for lookups.
+ */
+export interface IndexedAgent {
+    token: Token;
+    instance: AgentInstance;
+    baseName: string;
+    lineage: EntryLineage;
+    ownerKey: string;
+    qualifiedName: string;
+    qualifiedId: string;
+    source: AgentRegistry;
+}
+/**
+ * Registry for managing agents within a scope.
+ *
+ * AgentRegistry:
+ * - Creates and manages AgentInstance objects
+ * - Provides lookup by ID, name, or qualified name
+ * - Generates tool definitions for agent invocation
+ * - Manages agent visibility in swarms
+ * - Supports nested registries (agents inside agents/plugins/apps)
+ */
+export default class AgentRegistry extends RegistryAbstract<AgentInstance, AgentRecord, AgentType[]> {
+    /** Who owns this registry (used for provenance). */
+    owner: EntryOwnerRef;
+    /** Agents owned/constructed by THIS registry (with lineage applied) */
+    private localRows;
+    /** Adopted agent rows from each child registry */
+    private adopted;
+    /** Children registries that we track */
+    private children;
+    /** Unsubscribe functions for child registry subscriptions */
+    private childSubscriptions;
+    private byQualifiedId;
+    private byName;
+    private byOwnerAndName;
+    private byOwner;
+    private byId;
+    private version;
+    private emitter;
+    constructor(providers: ProviderRegistry, list: AgentType[], owner: EntryOwnerRef);
+    protected buildMap(list: AgentType[]): RegistryBuildMapResult<AgentRecord>;
+    protected buildGraph(): void;
+    protected initialize(): Promise<void>;
+    /**
+     * Register each agent's ToolInstance in the parent scope's ToolRegistry.
+     *
+     * This enables:
+     * - Agents to be called like any other tool through tools:call-tool flow
+     * - Plugin metadata extensions (cache, codecall) to work on agents
+     * - CodeCall to discover and search for agent tools
+     * - Unified hook/plugin execution for all tools including agents
+     *
+     * NOTE: This method registers ALL agents (local + adopted), not just local ones.
+     * It should only be called by scope-level registries after all apps are initialized.
+     */
+    private registerAgentToolsInParentScope;
+    /**
+     * Adopt agents from a child registry.
+     */
+    adoptFromChild(child: AgentRegistry, _childOwner: EntryOwnerRef): void;
+    /**
+     * Remove a child registry and clean up its subscription.
+     */
+    removeChild(child: AgentRegistry): void;
+    /**
+     * Dispose the registry and clean up all child subscriptions.
+     * Call this when the registry is no longer needed to prevent memory leaks.
+     */
+    dispose(): void;
+    /**
+     * Get all agents (local + adopted).
+     */
+    getAgents(includeHidden?: boolean): AgentEntry<any, any>[];
+    /**
+     * Get only agents defined inline in this registry.
+     */
+    getInlineAgents(): AgentEntry<any, any>[];
+    /**
+     * Internal snapshot of effective indexed rows (locals + adopted).
+     */
+    private listAllIndexed;
+    /**
+     * List all instances (locals + adopted).
+     */
+    listAllInstances(): readonly AgentInstance[];
+    /**
+     * Find an agent by ID.
+     */
+    findById(id: string): AgentInstance | undefined;
+    /**
+     * Find an agent by name.
+     */
+    findByName(name: string): AgentInstance | undefined;
+    /**
+     * Get agents visible to a specific agent.
+     *
+     * @param agentId - The ID of the agent that wants to see others
+     * @returns Array of agents visible to the specified agent
+     */
+    getVisibleAgentsFor(agentId: string): AgentInstance[];
+    /**
+     * Get tool definitions for all agents.
+     *
+     * Each agent is exposed as a tool with name `use-agent:<agent_id>`.
+     */
+    getAgentsAsTools(): Tool[];
+    /**
+     * Get tool definitions for agents visible to a specific agent.
+     */
+    getAgentToolsFor(agentId: string): Tool[];
+    private reindex;
+    subscribe(opts: {
+        immediate?: boolean;
+        filter?: (i: AgentInstance) => boolean;
+    }, cb: (evt: AgentChangeEvent) => void): () => void;
+    private bump;
+    private makeRow;
+    private relineage;
+    /**
+     * True if this registry (or adopted children) has any agents.
+     */
+    hasAny(): boolean;
+    /**
+     * Get the MCP capabilities for agents.
+     */
+    getCapabilities(): Partial<ServerCapabilities>;
+}
+//# sourceMappingURL=agent.registry.d.ts.map

package/agent/agent.registry.d.ts.map

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

package/agent/agent.scope.d.ts

@@ -0,0 +1,333 @@
+import 'reflect-metadata';
+import { Token, Type } from '@frontmcp/di';
+import { FlowInputOf, FlowName, FlowOutputOf, FlowType, FrontMcpLogger, AgentMetadata } from '../common';
+import ProviderRegistry from '../provider/provider.registry';
+import ToolRegistry from '../tool/tool.registry';
+import ResourceRegistry from '../resource/resource.registry';
+import PromptRegistry from '../prompt/prompt.registry';
+import HookRegistry from '../hooks/hook.registry';
+import PluginRegistry from '../plugin/plugin.registry';
+import AdapterRegistry from '../adapter/adapter.regsitry';
+import AgentRegistry from './agent.registry';
+import { Scope } from '../scope';
+/**
+ * AgentScope provides an isolated, private scope for agent execution.
+ *
+ * Each agent acts as a "private app" with its own registries that are not
+ * exposed to the parent scope. This enables:
+ *
+ * 1. **Complete Isolation**: Agent's tools, plugins, adapters, providers,
+ *    resources, prompts, and nested agents are private.
+ *
+ * 2. **Flow Integration**: Tool calls route through the standard `tools:call-tool`
+ *    flow, enabling hooks, plugins, authorization, and other flow features.
+ *
+ * 3. **Plugin/Adapter Support**: Agent can define its own plugins and adapters
+ *    for custom functionality.
+ *
+ * 4. **Parent Delegation**: For scope-level functionality (auth, notifications,
+ *    toolUI), delegates to the parent scope.
+ *
+ * @example
+ * ```typescript
+ * // AgentScope is created internally by AgentInstance
+ * const agentScope = new AgentScope(parentScope, agentId, agentMetadata);
+ * await agentScope.ready;
+ *
+ * // Execute tool through flow
+ * const result = await agentScope.runFlowForOutput('tools:call-tool', {
+ *   request: { method: 'tools/call', params: { name: 'myTool', arguments: {} } },
+ *   ctx: { authInfo },
+ * });
+ * ```
+ */
+export declare class AgentScope {
+    private readonly metadata;
+    readonly id: string;
+    readonly entryPath: string;
+    readonly routeBase: string;
+    readonly fullPath: string;
+    readonly logger: FrontMcpLogger;
+    readonly ready: Promise<void>;
+    private readonly parentScope;
+    private readonly agentOwner;
+    private agentProviders;
+    private agentPlugins;
+    private agentAdapters;
+    private agentTools;
+    private agentResources;
+    private agentPrompts;
+    private agentAgents;
+    private agentHooks;
+    private agentFlows;
+    constructor(parentScope: Scope, agentId: string, metadata: AgentMetadata, agentToken: Token);
+    private initialize;
+    get tools(): ToolRegistry;
+    get hooks(): HookRegistry;
+    get providers(): ProviderRegistry;
+    get plugins(): PluginRegistry;
+    get adapters(): AdapterRegistry;
+    get resources(): ResourceRegistry;
+    get prompts(): PromptRegistry;
+    get agents(): AgentRegistry;
+    get auth(): import("../common").FrontMcpAuth<{
+        mode: "public";
+        sessionTtl: number;
+        anonymousScopes: string[];
+        issuer?: string | undefined;
+        publicAccess?: {
+            tools: string[] | "all";
+            prompts: string[] | "all";
+            rateLimit: number;
+        } | undefined;
+        jwks?: {
+            keys: import("../common").JWK[];
+        } | undefined;
+        signKey?: import("../common").JWK | Uint8Array<ArrayBuffer> | undefined;
+        transport?: {
+            enableLegacySSE: boolean;
+            enableSseListener: boolean;
+            enableStreamableHttp: boolean;
+            enableStatelessHttp: boolean;
+            enableStatefulHttp: boolean;
+            requireSessionForStreamable: boolean;
+            recreation?: {
+                enabled: boolean;
+                defaultTtlMs: number;
+                redis?: {
+                    host: string;
+                    port: number;
+                    db: number;
+                    tls: boolean;
+                    keyPrefix: string;
+                    defaultTtlMs: number;
+                    password?: string | undefined;
+                } | undefined;
+            } | undefined;
+        } | undefined;
+    } | {
+        mode: "transparent";
+        remote: {
+            provider: string;
+            dcrEnabled: boolean;
+            name?: string | undefined;
+            id?: string | undefined;
+            jwks?: {
+                keys: import("../common").JWK[];
+            } | undefined;
+            jwksUri?: string | undefined;
+            clientId?: string | undefined;
+            clientSecret?: string | undefined;
+            scopes?: string[] | undefined;
+            authEndpoint?: string | undefined;
+            tokenEndpoint?: string | undefined;
+            registrationEndpoint?: string | undefined;
+            userInfoEndpoint?: string | undefined;
+        };
+        requiredScopes: string[];
+        allowAnonymous: boolean;
+        anonymousScopes: string[];
+        expectedAudience?: string | string[] | undefined;
+        publicAccess?: {
+            tools: string[] | "all";
+            prompts: string[] | "all";
+            rateLimit: number;
+        } | undefined;
+        transport?: {
+            enableLegacySSE: boolean;
+            enableSseListener: boolean;
+            enableStreamableHttp: boolean;
+            enableStatelessHttp: boolean;
+            enableStatefulHttp: boolean;
+            requireSessionForStreamable: boolean;
+            recreation?: {
+                enabled: boolean;
+                defaultTtlMs: number;
+                redis?: {
+                    host: string;
+                    port: number;
+                    db: number;
+                    tls: boolean;
+                    keyPrefix: string;
+                    defaultTtlMs: number;
+                    password?: string | undefined;
+                } | undefined;
+            } | undefined;
+        } | undefined;
+    } | {
+        tokenStorage: {
+            type: "memory";
+        } | {
+            type: "redis";
+            config: {
+                host: string;
+                port: number;
+                db: number;
+                tls: boolean;
+                keyPrefix: string;
+                defaultTtlMs: number;
+                password?: string | undefined;
+            };
+        };
+        sessionMode: "stateful" | "stateless";
+        allowDefaultPublic: boolean;
+        anonymousScopes: string[];
+        mode: "orchestrated";
+        type: "local";
+        local?: {
+            signKey?: import("../common").JWK | Uint8Array<ArrayBuffer> | undefined;
+            jwks?: {
+                keys: import("../common").JWK[];
+            } | undefined;
+            issuer?: string | undefined;
+        } | undefined;
+        publicAccess?: {
+            tools: string[] | "all";
+            prompts: string[] | "all";
+            rateLimit: number;
+        } | undefined;
+        consent?: {
+            enabled: boolean;
+            groupByApp: boolean;
+            showDescriptions: boolean;
+            allowSelectAll: boolean;
+            requireSelection: boolean;
+            rememberConsent: boolean;
+            customMessage?: string | undefined;
+            excludedTools?: string[] | undefined;
+            defaultSelectedTools?: string[] | undefined;
+        } | undefined;
+        refresh?: {
+            enabled: boolean;
+            skewSeconds: number;
+        } | undefined;
+        expectedAudience?: string | string[] | undefined;
+        incrementalAuth?: {
+            enabled: boolean;
+            skippedAppBehavior: "anonymous" | "require-auth";
+            allowSkip: boolean;
+            showAllAppsAtOnce: boolean;
+        } | undefined;
+        transport?: {
+            enableLegacySSE: boolean;
+            enableSseListener: boolean;
+            enableStreamableHttp: boolean;
+            enableStatelessHttp: boolean;
+            enableStatefulHttp: boolean;
+            requireSessionForStreamable: boolean;
+            recreation?: {
+                enabled: boolean;
+                defaultTtlMs: number;
+                redis?: {
+                    host: string;
+                    port: number;
+                    db: number;
+                    tls: boolean;
+                    keyPrefix: string;
+                    defaultTtlMs: number;
+                    password?: string | undefined;
+                } | undefined;
+            } | undefined;
+        } | undefined;
+    } | {
+        tokenStorage: {
+            type: "memory";
+        } | {
+            type: "redis";
+            config: {
+                host: string;
+                port: number;
+                db: number;
+                tls: boolean;
+                keyPrefix: string;
+                defaultTtlMs: number;
+                password?: string | undefined;
+            };
+        };
+        sessionMode: "stateful" | "stateless";
+        allowDefaultPublic: boolean;
+        anonymousScopes: string[];
+        mode: "orchestrated";
+        type: "remote";
+        remote: {
+            provider: string;
+            dcrEnabled: boolean;
+            name?: string | undefined;
+            id?: string | undefined;
+            jwks?: {
+                keys: import("../common").JWK[];
+            } | undefined;
+            jwksUri?: string | undefined;
+            clientId?: string | undefined;
+            clientSecret?: string | undefined;
+            scopes?: string[] | undefined;
+            authEndpoint?: string | undefined;
+            tokenEndpoint?: string | undefined;
+            registrationEndpoint?: string | undefined;
+            userInfoEndpoint?: string | undefined;
+        };
+        local?: {
+            signKey?: import("../common").JWK | Uint8Array<ArrayBuffer> | undefined;
+            jwks?: {
+                keys: import("../common").JWK[];
+            } | undefined;
+            issuer?: string | undefined;
+        } | undefined;
+        publicAccess?: {
+            tools: string[] | "all";
+            prompts: string[] | "all";
+            rateLimit: number;
+        } | undefined;
+        consent?: {
+            enabled: boolean;
+            groupByApp: boolean;
+            showDescriptions: boolean;
+            allowSelectAll: boolean;
+            requireSelection: boolean;
+            rememberConsent: boolean;
+            customMessage?: string | undefined;
+            excludedTools?: string[] | undefined;
+            defaultSelectedTools?: string[] | undefined;
+        } | undefined;
+        refresh?: {
+            enabled: boolean;
+            skewSeconds: number;
+        } | undefined;
+        expectedAudience?: string | string[] | undefined;
+        incrementalAuth?: {
+            enabled: boolean;
+            skippedAppBehavior: "anonymous" | "require-auth";
+            allowSkip: boolean;
+            showAllAppsAtOnce: boolean;
+        } | undefined;
+        transport?: {
+            enableLegacySSE: boolean;
+            enableSseListener: boolean;
+            enableStreamableHttp: boolean;
+            enableStatelessHttp: boolean;
+            enableStatefulHttp: boolean;
+            requireSessionForStreamable: boolean;
+            recreation?: {
+                enabled: boolean;
+                defaultTtlMs: number;
+                redis?: {
+                    host: string;
+                    port: number;
+                    db: number;
+                    tls: boolean;
+                    keyPrefix: string;
+                    defaultTtlMs: number;
+                    password?: string | undefined;
+                } | undefined;
+            } | undefined;
+        } | undefined;
+    }>;
+    get authProviders(): import("../auth/auth.registry").AuthRegistry;
+    get apps(): import("../app/app.registry").default;
+    get notifications(): import("../notification").NotificationService;
+    get toolUI(): import("@frontmcp/uipack/registry").ToolUIRegistry;
+    registryFlows(...flows: FlowType[]): Promise<void>;
+    runFlow<Name extends FlowName>(name: Name, input: FlowInputOf<Name>, deps?: Map<Token, Type>): Promise<FlowOutputOf<Name> | undefined>;
+    runFlowForOutput<Name extends FlowName>(name: Name, input: FlowInputOf<Name>, deps?: Map<Token, Type>): Promise<FlowOutputOf<Name>>;
+}
+//# sourceMappingURL=agent.scope.d.ts.map

package/agent/agent.scope.d.ts.map

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

package/agent/agent.utils.d.ts

@@ -0,0 +1,72 @@
+import 'reflect-metadata';
+import { Token } from '@frontmcp/di';
+import { AgentMetadata, AgentType, AgentRecord } from '../common';
+/**
+ * Check if a value is a class decorated with @Agent.
+ */
+export declare function isAgentClass(value: unknown): value is new (...args: unknown[]) => unknown;
+/**
+ * Check if a value is a function-based agent created with agent().
+ */
+export declare function isAgentFunction(value: unknown): value is (() => void) & {
+    [key: symbol]: unknown;
+};
+/**
+ * Extract metadata from a class decorated with @Agent.
+ */
+export declare function extractAgentClassMetadata(cls: Function): AgentMetadata;
+/**
+ * Extract metadata from a function-based agent.
+ */
+export declare function extractAgentFunctionMetadata(fn: (() => void) & {
+    [key: symbol]: unknown;
+}): AgentMetadata;
+/**
+ * Normalize an agent type into an AgentRecord.
+ *
+ * Handles:
+ * - Class decorated with @Agent
+ * - Function created with agent()
+ * - Value/Factory objects
+ */
+export declare function normalizeAgent(agent: AgentType): AgentRecord;
+/**
+ * Get dependencies needed for agent discovery.
+ *
+ * Returns the tokens that should be resolved before the agent can be instantiated.
+ */
+export declare function agentDiscoveryDeps(record: AgentRecord): Token[];
+/**
+ * Generate the tool name for an agent.
+ * Agents are exposed as callable tools with the `invoke_` prefix.
+ *
+ * @param agentId The agent's ID
+ * @returns Tool name in format `invoke_<sanitized-agent-id>`
+ */
+export declare function agentToolName(agentId: string): string;
+/**
+ * Generate the full name for an agent including owner path.
+ *
+ * @param agentName The agent's name
+ * @param ownerPath Array of owner names (e.g., ['app', 'plugin'])
+ * @returns Full name like 'app.plugin.agent'
+ */
+export declare function agentFullName(agentName: string, ownerPath: string[]): string;
+/**
+ * Validate agent metadata for required fields.
+ */
+export declare function validateAgentMetadata(metadata: AgentMetadata): void;
+/**
+ * Check if an agent is visible to swarm.
+ */
+export declare function isAgentVisibleToSwarm(metadata: AgentMetadata): boolean;
+/**
+ * Check if an agent can see other agents in swarm.
+ */
+export declare function canAgentSeeSwarm(metadata: AgentMetadata): boolean;
+/**
+ * Get the list of visible agent IDs for an agent.
+ * Returns empty array if agent cannot see swarm or has no specific visibility list.
+ */
+export declare function getVisibleAgentIds(metadata: AgentMetadata): string[];
+//# sourceMappingURL=agent.utils.d.ts.map

package/agent/agent.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.utils.d.ts","sourceRoot":"","sources":["../../src/agent/agent.utils.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EAAE,KAAK,EAAQ,MAAM,cAAc,CAAC;AAC3C,OAAO,EACL,aAAa,EACb,SAAS,EAGT,WAAW,EAEZ,MAAM,WAAW,CAAC;AAOnB;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,KAAK,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAGzF;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,CAAC,MAAM,IAAI,CAAC,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,CAIlG;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,QAAQ,GAAG,aAAa,CA8BtE;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAAC,EAAE,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,GAAG,aAAa,CAGzG;AAMD;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,SAAS,GAAG,WAAW,CA2D5D;AAMD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,WAAW,GAAG,KAAK,EAAE,CAoB/D;AAMD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAgBrD;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,MAAM,CAE5E;AAMD;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI,CAQnE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,CAEtE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,CAEjE;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,aAAa,GAAG,MAAM,EAAE,CAGpE"}