/**
 * Server-specific type helpers to replace `as any` casts in server.ts.
 *
 * These interfaces extend the published photon-core types with properties
 * that exist at runtime but are not part of the public API surface.
 */
import type { PhotonClassExtended } from '@portel/photon-core';
import type { ServerCapabilities } from '@modelcontextprotocol/sdk/types.js';
import type { HttpRouteDef } from '../shared/http-route-extractor.js';
import type { ExposeDef } from '../shared/expose-route-extractor.js';
/**
 * ServerCapabilities plus Photon's web-app capability extension.
 * Advertised when a photon has a GET / route or a TSX client app; detected
 * on the client side by external-mcp.ts (detectWebCapability).
 */
export type ServerCapabilitiesWithWeb = ServerCapabilities & {
    web?: {
        url: string;
        description: string;
    };
};
/**
 * Extended photon class with runtime-only metadata properties.
 * These are stamped by the loader on the result of loadFile / loadCompiled
 * but are not declared on PhotonClassExtended in photon-core.
 */
export interface PhotonClassWithMeta extends PhotonClassExtended {
    /** Photon icon emoji or name (from @icon class-level tag) */
    icon?: string;
    /** Whether the photon is stateful (from @stateful class-level tag) */
    stateful?: boolean;
    /** Convenience flag: true when settingsSchema.hasSettings is true */
    hasSettings?: boolean;
    /** Auth scheme directive from @auth class-level tag (e.g. "bearer:claim"). */
    auth?: string;
    /** Internal tool schema map used for diagnostics */
    _toolSchemas?: Record<string, unknown>;
    /** HTTP routes from @get / @post method-level tags */
    _httpRoutes?: HttpRouteDef[];
    /** Auto-RPC exposes from @expose method-level tags */
    _exposes?: ExposeDef[];
    /**
     * Cached extracted-tool schemas. Stamped by beam.ts during the load-and-mount
     * flow so subsequent result rendering can skip re-parsing the source. Shape
     * is whatever SchemaExtractor.extractAllFromSource returns for `tools`.
     */
    schemas?: unknown[];
}
/**
 * MCP tool definition returned by handleListTools.
 * Matches the MCP protocol Tool shape.
 */
export interface MCPToolDefinition {
    name: string;
    description: string;
    inputSchema: Record<string, unknown>;
    annotations?: Record<string, unknown>;
    outputSchema?: Record<string, unknown>;
    icons?: Array<{
        src: string;
        mimeType?: string;
        sizes?: string;
        theme?: string;
    }>;
    _meta?: Record<string, unknown>;
    /** Allow MCP extension properties such as x-output-format during migration. */
    [key: string]: unknown;
}
/**
 * MCP text content block with optional annotations.
 */
export interface MCPTextContent {
    type: 'text';
    text: string;
    annotations?: Record<string, unknown>;
}
/**
 * MCP tool call response.
 */
export interface MCPToolResponse {
    content: MCPTextContent[];
    isError: boolean;
    structuredContent?: Record<string, unknown>;
    _meta?: Record<string, unknown>;
    /** Extension field for format-aware clients */
    'x-output-format'?: string;
    /** Allow additional MCP extension properties */
    [key: string]: unknown;
}
//# sourceMappingURL=server-types.d.ts.map