import "@azure-tools/typespec-azure-core";
import "@typespec/rest";
import "./models-service.tsp";

using TypeSpec.Http;
using TypeSpec.Versioning;
using Azure.ClientGenerator.Core;

namespace Search;

interface DataSources {
  /** Creates a new datasource or updates a datasource if it already exists. */
  #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "Pre-existing API contract"
  #suppress "@azure-tools/typespec-azure-core/use-standard-names" "Pre-existing API contract"
  @route("/datasources('{dataSourceName}')")
  @put
  createOrUpdate is SearchDataSourceOperation<
    {
      ...acceptHeaderMinimal;
      ...matchingHeader;
      ...preferHeader;

      /** Ignores cache reset requirements. */
      @added(Versions.v2026_07_01_preview)
      @removed(Versions.v2026_04_01)
      @query("ignoreResetRequirements")
      skipIndexerResetRequirementForCache?: boolean;

      /** The definition of the datasource to create or update. */
      @body
      dataSource: SearchIndexerDataSource;
    },
    SearchIndexerDataSource & {
      /** A process exit code. */
      #suppress "@azure-tools/typespec-azure-core/no-closed-literal-union" "return status code"
      @statusCode
      code: "200" | "201";
    }
  >;

  /** Deletes a datasource. */
  #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "Pre-existing API contract"
  @route("/datasources('{dataSourceName}')")
  @delete
  delete is SearchDataSourceOperation<
    {
      ...acceptHeaderMinimal;
      ...matchingHeader;
    },
    {
      /** A process exit code. */
      #suppress "@azure-tools/typespec-azure-core/no-closed-literal-union" "return status code"
      @statusCode
      code: "204" | "404";
    }
  >;

  /** Retrieves a datasource definition. */
  #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "Pre-existing API contract"
  @route("/datasources('{dataSourceName}')")
  @get
  get is SearchDataSourceOperation<
    {
      ...acceptHeaderMinimal;
    },
    SearchIndexerDataSource
  >;

  /** Lists all datasources available for a search service. */
  #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "Pre-existing API contract"
  #suppress "@azure-tools/typespec-azure-core/use-standard-names" "Pre-existing API contract"
  @route("/datasources")
  @get
  list is SearchOperation<
    {
      ...acceptHeaderMinimal;
      ...selectQuery;
    },
    ListDataSourcesResult
  >;

  /** Creates a new datasource. */
  #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "Pre-existing API contract"
  @route("/datasources")
  @post
  create is SearchOperation<
    {
      ...acceptHeaderMinimal;

      /** The definition of the datasource to create. */
      @clientName("dataSourceConnection")
      @body
      dataSource: SearchIndexerDataSource;
    },
    SearchIndexerDataSource & {
      /** A process exit code. */
      @statusCode
      code: "201";
    }
  >;
}

interface Indexers {
  /** Resets the change tracking state associated with an indexer. */
  #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "Pre-existing API contract"
  @route("/indexers('{indexerName}')/search.reset")
  @post
  reset is SearchIndexerOperation<
    {
      ...acceptHeaderMinimal;
    },
    {
      /** A process exit code. */
      @statusCode
      code: "204";
    }
  >;

  /** Resync selective options from the datasource to be re-ingested by the indexer." */
  #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "Pre-existing API contract"
  @added(Versions.v2026_07_01_preview)
  @removed(Versions.v2026_04_01)
  @route("/indexers('{indexerName}')/search.resync")
  @post
  resync is SearchIndexerOperation<
    {
      ...acceptHeaderMinimal;

      /** The definition of the indexer resync options. */
      @body
      indexerResync: IndexerResyncBody;
    },
    {
      /** A process exit code. */
      @statusCode
      code: "204";
    }
  >;

  /** Resets specific documents in the datasource to be selectively re-ingested by the indexer. */
  #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "Pre-existing API contract"
  @added(Versions.v2026_07_01_preview)
  @removed(Versions.v2026_04_01)
  @route("/indexers('{indexerName}')/search.resetdocs")
  @post
  resetDocs is SearchIndexerOperation<
    {
      ...acceptHeaderMinimal;

      /** If false, keys or ids will be appended to existing ones. If true, only the keys or ids in this payload will be queued to be re-ingested. */
      @query
      overwrite?: boolean = false;

      /** The keys or ids of the documents to be re-ingested. If keys are provided, the document key field must be specified in the indexer configuration. If ids are provided, the document key field is ignored. */
      @body
      keysOrIds?: DocumentKeysOrIds;
    },
    {
      /** A process exit code. */
      @statusCode
      code: "204";
    }
  >;

  /** Runs an indexer on-demand. */
  #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "Pre-existing API contract"
  @route("/indexers('{indexerName}')/search.run")
  @post
  run is SearchIndexerOperation<
    {
      ...acceptHeaderMinimal;
    },
    {
      /** A process exit code. */
      @statusCode
      code: "202";
    }
  >;

  /** Creates a new indexer or updates an indexer if it already exists. */
  #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "Pre-existing API contract"
  #suppress "@azure-tools/typespec-azure-core/use-standard-names" "Pre-existing API contract"
  @route("/indexers('{indexerName}')")
  @put
  createOrUpdate is SearchIndexerOperation<
    {
      ...acceptHeaderMinimal;
      ...matchingHeader;
      ...preferHeader;

      /** Ignores cache reset requirements. */
      @added(Versions.v2026_07_01_preview)
      @removed(Versions.v2026_04_01)
      @query("ignoreResetRequirements")
      skipIndexerResetRequirementForCache?: boolean;

      /** Disables cache reprocessing change detection. */
      @added(Versions.v2026_07_01_preview)
      @removed(Versions.v2026_04_01)
      @query("disableCacheReprocessingChangeDetection")
      disableCacheReprocessingChangeDetection?: boolean;

      /** The definition of the indexer to create or update. */
      @body
      indexer: SearchIndexer;
    },
    SearchIndexer & {
      /** A process exit code. */
      #suppress "@azure-tools/typespec-azure-core/no-closed-literal-union" "return status code"
      @statusCode
      code: "200" | "201";
    }
  >;

  /** Deletes an indexer. */
  #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "Pre-existing API contract"
  @route("/indexers('{indexerName}')")
  @delete
  delete is SearchIndexerOperation<
    {
      ...acceptHeaderMinimal;
      ...matchingHeader;
    },
    {
      /** A process exit code. */
      #suppress "@azure-tools/typespec-azure-core/no-closed-literal-union" "return status code"
      @statusCode
      code: "204" | "404";
    }
  >;

  /** Retrieves an indexer definition. */
  #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "Pre-existing API contract"
  #suppress "@azure-tools/typespec-azure-core/use-standard-names" "Pre-existing API contract"
  @route("/indexers('{indexerName}')")
  @get
  get is SearchIndexerOperation<
    {
      ...acceptHeaderMinimal;
    },
    SearchIndexer
  >;

  /** Lists all indexers available for a search service. */
  #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "Pre-existing API contract"
  #suppress "@azure-tools/typespec-azure-core/use-standard-names" "Pre-existing API contract"
  @route("/indexers")
  @get
  list is SearchOperation<
    {
      ...acceptHeaderMinimal;
      ...selectQuery;
    },
    ListIndexersResult
  >;

  /** Creates a new indexer. */
  #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "Pre-existing API contract"
  #suppress "@azure-tools/typespec-azure-core/use-standard-names" "Pre-existing API contract"
  @route("/indexers")
  @post
  create is SearchOperation<
    {
      ...acceptHeaderMinimal;

      /** The definition of the indexer to create. */
      @body
      indexer: SearchIndexer;
    },
    SearchIndexer & {
      /** A process exit code. */
      @statusCode
      code: "201";
    }
  >;

  /** Returns the current status and execution history of an indexer. */
  #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "Pre-existing API contract"
  @route("/indexers('{indexerName}')/search.status")
  @get
  getStatus is SearchIndexerOperation<
    {
      ...acceptHeaderMinimal;
    },
    SearchIndexerStatus
  >;
}

interface Skillsets {
  /** Creates a new skillset in a search service or updates the skillset if it already exists. */
  #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "Pre-existing API contract"
  #suppress "@azure-tools/typespec-azure-core/use-standard-names" "Pre-existing API contract"
  @route("/skillsets('{skillsetName}')")
  @put
  createOrUpdate is SearchSkillsetOperation<
    {
      ...acceptHeaderMinimal;
      ...matchingHeader;
      ...preferHeader;

      /** Ignores cache reset requirements. */
      @added(Versions.v2026_07_01_preview)
      @removed(Versions.v2026_04_01)
      @query("ignoreResetRequirements")
      skipIndexerResetRequirementForCache?: boolean;

      /** Disables cache reprocessing change detection. */
      @added(Versions.v2026_07_01_preview)
      @removed(Versions.v2026_04_01)
      @query("disableCacheReprocessingChangeDetection")
      disableCacheReprocessingChangeDetection?: boolean;

      /** The skillset containing one or more skills to create or update in a search service. */
      @body
      skillset: SearchIndexerSkillset;
    },
    SearchIndexerSkillset & {
      /** A process exit code. */
      #suppress "@azure-tools/typespec-azure-core/no-closed-literal-union" "return status code"
      @statusCode
      code: "200" | "201";
    }
  >;

  /** Deletes a skillset in a search service. */
  #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "Pre-existing API contract"
  #suppress "@azure-tools/typespec-azure-core/use-standard-names" "Pre-existing API contract"
  @route("/skillsets('{skillsetName}')")
  @delete
  delete is SearchSkillsetOperation<
    {
      ...acceptHeaderMinimal;
      ...matchingHeader;
    },
    {
      /** A process exit code. */
      #suppress "@azure-tools/typespec-azure-core/no-closed-literal-union" "return status code"
      @statusCode
      code: "204" | "404";
    }
  >;

  /** Retrieves a skillset in a search service. */
  #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "Pre-existing API contract"
  @route("/skillsets('{skillsetName}')")
  @get
  get is SearchSkillsetOperation<
    {
      ...acceptHeaderMinimal;
    },
    SearchIndexerSkillset
  >;

  /** List all skillsets in a search service. */
  #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "Pre-existing API contract"
  #suppress "@azure-tools/typespec-azure-core/use-standard-names" "Pre-existing API contract"
  @route("/skillsets")
  @get
  list is SearchOperation<
    {
      ...acceptHeaderMinimal;
      ...selectQuery;
    },
    ListSkillsetsResult
  >;

  /** Creates a new skillset in a search service. */
  #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "Pre-existing API contract"
  @route("/skillsets")
  @post
  create is SearchOperation<
    {
      ...acceptHeaderMinimal;

      /** The skillset containing one or more skills to create in a search service. */
      @body
      skillset: SearchIndexerSkillset;
    },
    SearchIndexerSkillset & {
      /** A process exit code. */
      @statusCode
      code: "201";
    }
  >;

  /** Reset an existing skillset in a search service. */
  #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "Pre-existing API contract"
  @added(Versions.v2026_07_01_preview)
  @removed(Versions.v2026_04_01)
  @route("/skillsets('{skillsetName}')/search.resetskills")
  @post
  resetSkills is SearchSkillsetOperation<
    {
      ...acceptHeaderMinimal;

      /** The names of the skills to reset. If not specified, all skills in the skillset will be reset. */
      @body
      skillNames: SkillNames;
    },
    void
  >;
}

interface SynonymMaps {
  /** Creates a new synonym map or updates a synonym map if it already exists. */
  #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "Pre-existing API contract"
  #suppress "@azure-tools/typespec-azure-core/use-standard-names" "Pre-existing API contract"
  @route("/synonymmaps('{synonymMapName}')")
  @put
  createOrUpdate is SearchSynonymMapOperation<
    {
      ...acceptHeaderMinimal;
      ...matchingHeader;
      ...preferHeader;

      /** The definition of the synonym map to create or update. */
      @body
      synonymMap: SynonymMap;
    },
    SynonymMap & {
      /** A process exit code. */
      #suppress "@azure-tools/typespec-azure-core/no-closed-literal-union" "return status code"
      @statusCode
      code: "200" | "201";
    }
  >;

  /** Deletes a synonym map. */
  #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "Pre-existing API contract"
  @route("/synonymmaps('{synonymMapName}')")
  @delete
  delete is SearchSynonymMapOperation<
    {
      ...acceptHeaderMinimal;
      ...matchingHeader;
    },
    {
      /** A process exit code. */
      #suppress "@azure-tools/typespec-azure-core/no-closed-literal-union" "return status code"
      @statusCode
      code: "204" | "404";
    }
  >;

  /** Retrieves a synonym map definition. */
  #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "Pre-existing API contract"
  #suppress "@azure-tools/typespec-azure-core/use-standard-names" "Pre-existing API contract"
  @route("/synonymmaps('{synonymMapName}')")
  @get
  get is SearchSynonymMapOperation<
    {
      ...acceptHeaderMinimal;
    },
    SynonymMap
  >;

  /** Lists all synonym maps available for a search service. */
  #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "Pre-existing API contract"
  #suppress "@azure-tools/typespec-azure-core/use-standard-names" "Pre-existing API contract"
  @route("/synonymmaps")
  @get
  list is SearchOperation<
    {
      ...acceptHeaderMinimal;
      ...selectQuery;
    },
    ListSynonymMapsResult
  >;

  /** Creates a new synonym map. */
  #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "Pre-existing API contract"
  @route("/synonymmaps")
  @post
  create is SearchOperation<
    {
      ...acceptHeaderMinimal;

      /** The definition of the synonym map to create. */
      @body
      synonymMap: SynonymMap;
    },
    SynonymMap & {
      /** A process exit code. */
      @statusCode
      code: "201";
    }
  >;
}

interface Indexes {
  /** Creates a new search index. */
  #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "Pre-existing API contract"
  @route("/indexes")
  @post
  create is SearchOperation<
    {
      ...acceptHeaderMinimal;

      /** The definition of the index to create. */
      @body
      index: SearchIndex;
    },
    SearchIndex & {
      /** A process exit code. */
      @statusCode
      code: "201";
    }
  >;

  /** Lists all indexes available for a search service. */
  #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "Pre-existing API contract"
  #suppress "@azure-tools/typespec-azure-core/use-standard-names" "Pre-existing API contract"
  @route("/indexes")
  @sharedRoute
  @list
  @get
  list is SearchOperation<
    {
      ...acceptHeaderMinimal;
    },
    ListIndexesResult
  >;

  /** Lists all indexes available for a search service. */
  #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "Pre-existing API contract"
  #suppress "@azure-tools/typespec-azure-core/use-standard-names" "Pre-existing API contract"
  @route("/indexes")
  @sharedRoute
  @list
  @get
  listWithSelectedProperties is SearchOperation<
    {
      ...acceptHeaderMinimal;
      ...selectQuery;
    },
    ListIndexesSelectedResult
  >;

  /** Creates a new search index or updates an index if it already exists. */
  #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "Pre-existing API contract"
  #suppress "@azure-tools/typespec-azure-core/use-standard-names" "Pre-existing API contract"
  @route("/indexes('{indexName}')")
  @put
  createOrUpdate is SearchIndexOperation<
    {
      ...acceptHeaderMinimal;
      ...matchingHeader;

      /** Allows new analyzers, tokenizers, token filters, or char filters to be added to an index by taking the index offline for at least a few seconds. This temporarily causes indexing and query requests to fail. Performance and write availability of the index can be impaired for several minutes after the index is updated, or longer for very large indexes. */
      @query
      allowIndexDowntime?: boolean;

      ...preferHeader;

      /** The definition of the index to create or update. */
      @body
      index: SearchIndex;
    },
    SearchIndex & {
      /** A process exit code. */
      #suppress "@azure-tools/typespec-azure-core/no-closed-literal-union" "return status code"
      @statusCode
      code: "200" | "201";
    }
  >;

  /** Deletes a search index and all the documents it contains. This operation is permanent, with no recovery option. Make sure you have a master copy of your index definition, data ingestion code, and a backup of the primary data source in case you need to re-build the index. */
  #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "Pre-existing API contract"
  @route("/indexes('{indexName}')")
  @delete
  delete is SearchIndexOperation<
    {
      ...acceptHeaderMinimal;
      ...matchingHeader;
    },
    {
      /** A process exit code. */
      #suppress "@azure-tools/typespec-azure-core/no-closed-literal-union" "return status code"
      @statusCode
      code: "204" | "404";
    }
  >;

  /** Retrieves an index definition. */
  #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "Pre-existing API contract"
  @route("/indexes('{indexName}')")
  @get
  get is SearchIndexOperation<
    {
      ...acceptHeaderMinimal;
    },
    SearchIndex
  >;

  /** Returns statistics for the given index, including a document count and storage usage. */
  #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "Pre-existing API contract"
  @route("/indexes('{indexName}')/search.stats")
  @get
  getStatistics is SearchIndexOperation<
    {
      ...acceptHeaderMinimal;
    },
    GetIndexStatisticsResult
  >;

  /** Shows how an analyzer breaks text into tokens. */
  #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "Pre-existing API contract"
  @route("/indexes('{indexName}')/search.analyze")
  @post
  analyze is SearchIndexOperation<
    {
      ...acceptHeaderMinimal;

      /** The text and analyzer or analysis components to test. */
      @body
      request: AnalyzeRequest;
    },
    AnalyzeResult
  >;
}

interface Aliases {
  /** Creates a new search alias. */
  #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "Pre-existing API contract"
  @route("/aliases")
  @post
  create is SearchOperation<
    {
      ...acceptHeaderMinimal;

      /** The definition of the alias to create. */
      @body
      `alias`: SearchAlias;
    },
    SearchAlias & {
      /** A process exit code. */
      @statusCode
      code: "201";
    }
  >;
  /** Lists all aliases available for a search service. */
  #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "Pre-existing API contract"
  #suppress "@azure-tools/typespec-azure-core/use-standard-names" "Pre-existing API contract"
  @route("/aliases")
  @list
  @get
  list is SearchOperation<
    {
      ...acceptHeaderMinimal;
    },
    ListAliasesResult
  >;

  /** Creates a new search alias or updates an alias if it already exists. */
  #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "Pre-existing API contract"
  #suppress "@azure-tools/typespec-azure-core/use-standard-names" "Pre-existing API contract"
  @route("/aliases('{aliasName}')")
  @put
  createOrUpdate is SearchAliasOperation<
    {
      ...acceptHeaderMinimal;
      ...matchingHeader;
      ...preferHeader;

      /** The definition of the alias to create or update. */
      @body
      `alias`: SearchAlias;
    },
    SearchAlias & {
      /** A process exit code. */
      #suppress "@azure-tools/typespec-azure-core/no-closed-literal-union" "return status code"
      @statusCode
      code: "200" | "201";
    }
  >;

  /** Deletes a search alias and its associated mapping to an index. This operation is permanent, with no recovery option. The mapped index is untouched by this operation. */
  #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "Pre-existing API contract"
  @route("/aliases('{aliasName}')")
  @delete
  delete is SearchAliasOperation<
    {
      ...acceptHeaderMinimal;
      ...matchingHeader;
    },
    {
      /** A process exit code. */
      #suppress "@azure-tools/typespec-azure-core/no-closed-literal-union" "return status code"
      @statusCode
      code: "204" | "404";
    }
  >;

  /** Retrieves an alias definition. */
  #suppress "@azure-tools/typespec-azure-core/use-standard-names" "Pre-existing API contract"
  #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "Pre-existing API contract"
  @route("/aliases('{aliasName}')")
  @get
  get is SearchAliasOperation<
    {
      ...acceptHeaderMinimal;
    },
    SearchAlias
  >;
}

interface KnowledgeBases {
  /** Creates a new knowledge base. */
  #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "Pre-existing API contract"
  @route("/knowledgebases")
  @post
  create is SearchOperation<
    {
      ...acceptHeaderMinimal;

      /** The definition of the knowledge base to create. */
      @body
      knowledgeBase: KnowledgeBase;
    },
    KnowledgeBase & {
      /** A process exit code. */
      @statusCode
      code: "201";
    }
  >;

  /** Lists all knowledge bases available for a search service. */
  #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "Pre-existing API contract"
  #suppress "@azure-tools/typespec-azure-core/use-standard-names" "Pre-existing API contract"
  @route("/knowledgebases")
  @list
  @get
  list is SearchOperation<
    {
      ...acceptHeaderMinimal;
    },
    ListKnowledgeBasesResult
  >;

  /** Creates a new knowledge base or updates a knowledge base if it already exists. */
  #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "Pre-existing API contract"
  #suppress "@azure-tools/typespec-azure-core/use-standard-names" "Pre-existing API contract"
  @route("/knowledgebases('{knowledgeBaseName}')")
  @put
  createOrUpdate is SearchKnowledgeBaseOperation<
    {
      ...acceptHeaderMinimal;
      ...matchingHeader;
      ...preferHeader;

      /** The definition of the knowledge base to create or update. */
      @body
      knowledgeBase: KnowledgeBase;
    },
    KnowledgeBase & {
      /** A process exit code. */
      #suppress "@azure-tools/typespec-azure-core/no-closed-literal-union" "return status code"
      @statusCode
      code: "200" | "201";
    }
  >;

  /** Deletes a knowledge base. */
  #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "Pre-existing API contract"
  @route("/knowledgebases('{knowledgeBaseName}')")
  @delete
  delete is SearchKnowledgeBaseOperation<
    {
      ...acceptHeaderMinimal;
      ...matchingHeader;
    },
    {
      /** A process exit code. */
      #suppress "@azure-tools/typespec-azure-core/no-closed-literal-union" "return status code"
      @statusCode
      code: "204" | "404";
    }
  >;

  /** Retrieves a knowledge base definition. */
  #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "Pre-existing API contract"
  @route("/knowledgebases('{knowledgeBaseName}')")
  @get
  get is SearchKnowledgeBaseOperation<
    {
      ...acceptHeaderMinimal;
    },
    KnowledgeBase
  >;
}

interface KnowledgeSources {
  /** Creates a new knowledge source. */
  #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "Pre-existing API contract"
  @route("/knowledgesources")
  @post
  create is SearchOperation<
    {
      ...acceptHeaderMinimal;

      /** The definition of the knowledge source to create. */
      @body
      knowledgeSource: KnowledgeSource;
    },
    KnowledgeSource & {
      /** A process exit code. */
      @statusCode
      code: "201";
    }
  >;

  /** Lists all knowledge sources available for a search service. */
  #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "Pre-existing API contract"
  #suppress "@azure-tools/typespec-azure-core/use-standard-names" "Pre-existing API contract"
  @route("/knowledgesources")
  @list
  @get
  list is SearchOperation<
    {
      ...acceptHeaderMinimal;
    },
    ListKnowledgeSourcesResult
  >;

  /** Creates a new knowledge source or updates an knowledge source if it already exists. */
  #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "Pre-existing API contract"
  #suppress "@azure-tools/typespec-azure-core/use-standard-names" "Pre-existing API contract"
  @route("/knowledgesources('{sourceName}')")
  @put
  createOrUpdate is SearchSourceOperation<
    {
      ...acceptHeaderMinimal;
      ...matchingHeader;
      ...preferHeader;

      /** The definition of the knowledge source to create or update. */
      @body
      knowledgeSource: KnowledgeSource;
    },
    KnowledgeSource & {
      /** A process exit code. */
      #suppress "@azure-tools/typespec-azure-core/no-closed-literal-union" "return status code"
      @statusCode
      code: "200" | "201";
    }
  >;

  /** Deletes an existing knowledge source. */
  #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "Pre-existing API contract"
  @route("/knowledgesources('{sourceName}')")
  @delete
  delete is SearchSourceOperation<
    {
      ...acceptHeaderMinimal;
      ...matchingHeader;
    },
    {
      /** A process exit code. */
      #suppress "@azure-tools/typespec-azure-core/no-closed-literal-union" "return status code"
      @statusCode
      code: "204" | "404";
    }
  >;

  /** Retrieves a knowledge source definition. */
  #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "Pre-existing API contract"
  @route("/knowledgesources('{sourceName}')")
  @get
  get is SearchSourceOperation<
    {
      ...acceptHeaderMinimal;
    },
    KnowledgeSource
  >;

  /** Retrieves the status of a knowledge source. */
  #suppress "@azure-tools/typespec-azure-core/use-standard-operations" "Pre-existing API contract"
  @route("/knowledgesources('{sourceName}')/status")
  @get
  getStatus is SearchSourceOperation<
    {
      ...acceptHeaderMinimal;
    },
    KnowledgeSourceStatus
  >;
}

/** Gets service level statistics for a search service. */
#suppress "@azure-tools/typespec-azure-core/use-standard-operations" "Pre-existing API contract"
@route("/servicestats")
@get
op getServiceStatistics is SearchOperation<
  {
    ...acceptHeaderMinimal;
  },
  SearchServiceStatistics
>;

/** Retrieves a summary of statistics for all indexes in the search service. */
#suppress "@azure-tools/typespec-azure-core/use-standard-operations" "Pre-existing API contract"
#suppress "@azure-tools/typespec-azure-core/use-standard-names" "Pre-existing API contract"
@added(Versions.v2026_07_01_preview)
@removed(Versions.v2026_04_01)
@route("/indexstats")
@list
@get
op getIndexStatsSummary is SearchOperation<
  {
    ...acceptHeaderMinimal;
  },
  ListIndexStatsSummary
>;

/** Gets usage metrics for the search service including query counts and latency. */
#suppress "@azure-tools/typespec-azure-core/use-standard-operations" "Pre-existing API contract"
@added(Versions.v2026_07_01_preview)
@route("/usagemetrics")
@get
op getUsageMetrics is SearchOperation<
  {
    ...acceptHeaderMinimal;

    /** The start date for the metrics collection period in ISO 8601 format. */
    @query("startDate")
    startDate?: utcDateTime;

    /** The end date for the metrics collection period in ISO 8601 format. */
    @query("endDate")
    endDate?: utcDateTime;
  },
  SearchServiceUsageMetrics
>;