PromptRegistry

import { PromptRegistry } from '@frontmcp/sdk';

// Access via scope
const prompts = scope.prompts;

// List all prompts
const allPrompts = prompts.getPrompts();

// Find a specific prompt
const prompt = prompts.findByName('code_review');

getPrompts(includeHidden?: boolean): ReadonlyArray<PromptEntry>

// Get all visible prompts
const prompts = registry.getPrompts();

// Include hidden prompts
const allPrompts = registry.getPrompts(true);

findByName(name: string): PromptEntry | undefined

const prompt = registry.findByName('code_review');
if (prompt) {
  console.log(`Found: ${prompt.description}`);
}

findAllByName(name: string): ReadonlyArray<PromptEntry>

// When multiple apps define 'greeting' prompt
const prompts = registry.findAllByName('greeting');
for (const prompt of prompts) {
  console.log(`${prompt.qualifiedId}: ${prompt.description}`);
}

findByQualifiedName(qualifiedName: string): PromptEntry | undefined

const prompt = registry.findByQualifiedName('my-app:code_review');

getExported(name: string, opts?: { ignoreCase?: boolean }): PromptEntry | undefined

const prompt = registry.getExported('Code_Review');

exportResolvedNames(opts?: ExportResolvedNamesOptions): Map<string, PromptEntry>

const exportedNames = registry.exportResolvedNames();
// code_review → app1:code_review
// app2_code_review → app2:code_review (conflict resolved)

getInlinePrompts(): ReadonlyArray<PromptEntry>

listAllInstances(): ReadonlyArray<PromptEntry>

listByOwner(ownerPath: string): ReadonlyArray<PromptEntry>

const appPrompts = registry.listByOwner('my-app');

registerPromptInstance(prompt: PromptInstance): void

subscribe(
  opts: SubscribeOptions,
  cb: (event: PromptChangeEvent) => void
): () => void

const unsubscribe = registry.subscribe({}, (event) => {
  console.log(`Prompt ${event.kind}:`, event.entry?.name);
});

// Later
unsubscribe();

getCapabilities(): { listChanged: boolean }

const caps = registry.getCapabilities();
// { listChanged: true }

hasAny(): boolean

adoptFromChild(child: PromptRegistry, childOwner: Owner): void

interface PromptChangeEvent {
  kind: 'added' | 'updated' | 'removed' | 'reset';
  changeScope: 'global' | 'session';
  version: number;
  snapshot: ReadonlyArray<PromptEntry>;
  entry?: PromptEntry;
  sessionId?: string;
  relatedRequestId?: string;
}

@Prompt({
  name: 'code_review',
  description: 'Review code for best practices',
  arguments: [
    { name: 'language', description: 'Programming language', required: true },
    { name: 'style', description: 'Review style', required: false },
  ],
})
class CodeReviewPrompt extends PromptContext { }

const entry = registry.findByName('code_review');
// entry.arguments contains the argument definitions