> ## Documentation Index
> Fetch the complete documentation index at: https://docs.idun-group.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create From Detection

> Materialize a detection picked by the wizard.



## OpenAPI

````yaml /standalone/openapi.json post /admin/api/v1/onboarding/create-from-detection
openapi: 3.1.0
info:
  title: Idun Agent Engine Server
  description: A production-ready server for conversational AI agents
  version: 0.6.1
servers: []
security: []
tags:
  - name: Runtime
    description: >-
      Public agent run endpoints, engine operations, and chat-channel webhooks.
      SSE streaming via the AG-UI protocol.
  - name: Agent Configuration
    description: >-
      Singleton admin endpoints for the agent, prompts, memory, guardrails, and
      onboarding wizard.
  - name: Auth & SSO
    description: >-
      Login, sessions, password change, SSO config, and the public SSO discovery
      endpoint.
  - name: Integrations & Tools
    description: MCP server registry and external integration credentials.
  - name: Observability
    description: Tracing/logging provider configuration.
  - name: Traces
    description: >-
      Trace and span storage admin endpoints — list, detail, delete, and
      pipeline-health for the standalone trace store.
  - name: Dashboard
    description: >-
      Operator dashboard widgets — KPIs, time-series, top errors, and
      configuration summary.
paths:
  /admin/api/v1/onboarding/create-from-detection:
    post:
      tags:
        - Agent Configuration
      summary: Create From Detection
      description: Materialize a detection picked by the wizard.
      operationId: create_from_detection_admin_api_v1_onboarding_create_from_detection_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateFromDetectionBody'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/StandaloneMutationResponse_StandaloneAgentRead_
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    CreateFromDetectionBody:
      properties:
        framework:
          type: string
          enum:
            - LANGGRAPH
            - ADK
          title: Framework
        filePath:
          type: string
          title: Filepath
        variableName:
          type: string
          title: Variablename
      type: object
      required:
        - framework
        - filePath
        - variableName
      title: CreateFromDetectionBody
      description: |-
        Body for ``POST /admin/api/v1/onboarding/create-from-detection``.

        The triple ``(framework, file_path, variable_name)`` is the lookup
        key for re-validation against a fresh scan inside the handler.
        ``inferred_name`` is intentionally not on the wire — the server
        computes it from the fresh scan, not from the body.
    StandaloneMutationResponse_StandaloneAgentRead_:
      properties:
        data:
          $ref: '#/components/schemas/StandaloneAgentRead'
        reload:
          $ref: '#/components/schemas/StandaloneReloadResult'
      type: object
      required:
        - data
        - reload
      title: StandaloneMutationResponse[StandaloneAgentRead]
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    StandaloneAgentRead:
      properties:
        id:
          type: string
          format: uuid
          title: Id
        slug:
          anyOf:
            - type: string
            - type: 'null'
          title: Slug
        name:
          type: string
          title: Name
        description:
          anyOf:
            - type: string
            - type: 'null'
          title: Description
        version:
          anyOf:
            - type: string
            - type: 'null'
          title: Version
        status:
          $ref: '#/components/schemas/AgentStatus'
        baseUrl:
          anyOf:
            - type: string
            - type: 'null'
          title: Baseurl
        baseEngineConfig:
          $ref: '#/components/schemas/EngineConfig'
        createdAt:
          type: string
          format: date-time
          title: Createdat
        updatedAt:
          type: string
          format: date-time
          title: Updatedat
      type: object
      required:
        - id
        - name
        - status
        - baseEngineConfig
        - createdAt
        - updatedAt
      title: StandaloneAgentRead
      description: GET response and the data payload of PATCH responses.
    StandaloneReloadResult:
      properties:
        status:
          $ref: '#/components/schemas/StandaloneReloadStatus'
        message:
          type: string
          title: Message
        error:
          anyOf:
            - type: string
            - type: 'null'
          title: Error
      type: object
      required:
        - status
        - message
      title: StandaloneReloadResult
      description: |-
        Reload outcome attached to every admin mutation response.

        ``reloaded`` means DB committed and runtime now uses the new config.
        ``restart_required`` means DB committed and process restart is needed.
        ``reload_failed`` means DB rolled back and runtime is unchanged.
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
    AgentStatus:
      type: string
      enum:
        - draft
        - active
        - inactive
        - deprecated
        - error
      title: AgentStatus
      description: Agent status enumeration.
    EngineConfig:
      properties:
        server:
          $ref: '#/components/schemas/ServerConfig'
        agent:
          $ref: '#/components/schemas/AgentConfig'
        mcpServers:
          anyOf:
            - items:
                $ref: '#/components/schemas/MCPServer'
              type: array
            - type: 'null'
          title: Mcpservers
        guardrails:
          anyOf:
            - $ref: '#/components/schemas/GuardrailsV2'
            - type: 'null'
        observability:
          anyOf:
            - items:
                $ref: >-
                  #/components/schemas/idun_agent_schema__engine__observability_v2__ObservabilityConfig
              type: array
            - type: 'null'
          title: Observability
        sso:
          anyOf:
            - $ref: '#/components/schemas/SSOConfig'
            - type: 'null'
        integrations:
          anyOf:
            - items:
                $ref: '#/components/schemas/IntegrationConfig'
              type: array
            - type: 'null'
          title: Integrations
        prompts:
          anyOf:
            - items:
                $ref: '#/components/schemas/PromptConfig'
              type: array
            - type: 'null'
          title: Prompts
      type: object
      required:
        - agent
      title: EngineConfig
      description: Main engine configuration model for the entire Idun Agent Engine.
    StandaloneReloadStatus:
      type: string
      enum:
        - reloaded
        - restart_required
        - reload_failed
      title: StandaloneReloadStatus
      description: Outcome of a reload triggered by an admin mutation.
    ServerConfig:
      properties:
        api:
          $ref: '#/components/schemas/ServerAPIConfig'
      type: object
      title: ServerConfig
      description: Configuration for the Engine's universal settings.
    AgentConfig:
      properties:
        type:
          $ref: '#/components/schemas/AgentFramework'
        config:
          anyOf:
            - $ref: '#/components/schemas/LangGraphAgentConfig'
            - $ref: '#/components/schemas/AdkAgentConfig'
            - $ref: '#/components/schemas/TranslationAgentConfig'
            - $ref: '#/components/schemas/CorrectionAgentConfig'
            - $ref: '#/components/schemas/DeepResearchAgentConfig'
            - $ref: '#/components/schemas/BaseAgentConfig'
          title: Config
      type: object
      required:
        - type
        - config
      title: AgentConfig
      description: Configuration for agent specification and settings.
    MCPServer:
      properties:
        name:
          type: string
          title: Name
          description: Unique identifier for this MCP server.
        transport:
          type: string
          enum:
            - stdio
            - sse
            - streamable_http
            - websocket
          title: Transport
          description: Transport type used to reach the MCP server.
          default: streamable_http
        url:
          anyOf:
            - type: string
            - type: 'null'
          title: Url
          description: >-
            Endpoint URL for HTTP/S based transports (SSE, streamable_http,
            websocket).
        command:
          anyOf:
            - type: string
            - type: 'null'
          title: Command
          description: Executable to run when using stdio transport.
        args:
          items:
            type: string
          type: array
          title: Args
          description: Arguments to pass to the command for stdio transport.
        headers:
          additionalProperties:
            type: string
          type: object
          title: Headers
          description: Optional headers for HTTP/S transports.
        env:
          additionalProperties:
            type: string
          type: object
          title: Env
          description: Environment variables to set when spawning stdio servers.
        cwd:
          anyOf:
            - type: string
            - type: 'null'
          title: Cwd
          description: Working directory for stdio transports.
        encoding:
          anyOf:
            - type: string
            - type: 'null'
          title: Encoding
          description: Encoding used for stdio transport.
        encodingErrorHandler:
          anyOf:
            - type: string
              enum:
                - strict
                - ignore
                - replace
            - type: 'null'
          title: Encodingerrorhandler
          description: Encoding error handler for stdio transport.
        timeoutSeconds:
          anyOf:
            - type: number
            - type: 'null'
          title: Timeoutseconds
          description: Timeout in seconds for HTTP/S transports (maps to `timeout`).
        sseReadTimeoutSeconds:
          anyOf:
            - type: number
            - type: 'null'
          title: Ssereadtimeoutseconds
          description: >-
            Timeout in seconds waiting for SSE events (maps to
            `sse_read_timeout`).
        terminateOnClose:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Terminateonclose
          description: Whether to terminate Streamable HTTP sessions on close.
        sessionKwargs:
          additionalProperties: true
          type: object
          title: Sessionkwargs
          description: Extra keyword arguments forwarded to MCP ClientSession.
      type: object
      required:
        - name
      title: MCPServer
      description: Configuration for a single MCP server connection.
    GuardrailsV2:
      properties:
        input:
          items:
            anyOf:
              - $ref: '#/components/schemas/BanListConfig'
              - $ref: '#/components/schemas/DetectPIIConfig'
              - $ref: '#/components/schemas/BiasCheckConfig'
              - $ref: '#/components/schemas/CompetitionCheckConfig'
              - $ref: '#/components/schemas/CorrectLanguageConfig'
              - $ref: '#/components/schemas/GibberishTextConfig'
              - $ref: '#/components/schemas/NSFWTextConfig'
              - $ref: '#/components/schemas/DetectJailbreakConfig'
              - $ref: '#/components/schemas/PromptInjectionConfig'
              - $ref: '#/components/schemas/RagHallucinationConfig'
              - $ref: '#/components/schemas/RestrictToTopicConfig'
              - $ref: '#/components/schemas/ToxicLanguageConfig'
              - $ref: '#/components/schemas/CodeScannerConfig'
          type: array
          title: Input
          description: List of input guardrails
        output:
          items:
            anyOf:
              - $ref: '#/components/schemas/BanListConfig'
              - $ref: '#/components/schemas/DetectPIIConfig'
              - $ref: '#/components/schemas/BiasCheckConfig'
              - $ref: '#/components/schemas/CompetitionCheckConfig'
              - $ref: '#/components/schemas/CorrectLanguageConfig'
              - $ref: '#/components/schemas/GibberishTextConfig'
              - $ref: '#/components/schemas/NSFWTextConfig'
              - $ref: '#/components/schemas/DetectJailbreakConfig'
              - $ref: '#/components/schemas/PromptInjectionConfig'
              - $ref: '#/components/schemas/RagHallucinationConfig'
              - $ref: '#/components/schemas/RestrictToTopicConfig'
              - $ref: '#/components/schemas/ToxicLanguageConfig'
              - $ref: '#/components/schemas/CodeScannerConfig'
          type: array
          title: Output
          description: List of output guardrails
      type: object
      title: GuardrailsV2
      description: Guardrails V2 configuration.
    idun_agent_schema__engine__observability_v2__ObservabilityConfig:
      properties:
        provider:
          $ref: '#/components/schemas/ObservabilityProvider'
          default: LANGFUSE
        enabled:
          type: boolean
          title: Enabled
          default: true
        config:
          oneOf:
            - $ref: '#/components/schemas/LangfuseConfig'
            - $ref: '#/components/schemas/PhoenixConfig'
            - $ref: '#/components/schemas/GCPLoggingConfig'
            - $ref: '#/components/schemas/GCPTraceConfig'
            - $ref: '#/components/schemas/LangsmithConfig'
          title: Config
          discriminator:
            propertyName: provider
            mapping:
              GCP_LOGGING:
                $ref: '#/components/schemas/GCPLoggingConfig'
              GCP_TRACE:
                $ref: '#/components/schemas/GCPTraceConfig'
              LANGFUSE:
                $ref: '#/components/schemas/LangfuseConfig'
              LANGSMITH:
                $ref: '#/components/schemas/LangsmithConfig'
              PHOENIX:
                $ref: '#/components/schemas/PhoenixConfig'
      type: object
      required:
        - config
      title: ObservabilityConfig
      description: Observability configuration.
    SSOConfig:
      properties:
        enabled:
          type: boolean
          title: Enabled
          description: Toggle SSO enforcement on protected routes.
          default: true
        issuer:
          type: string
          title: Issuer
          description: >-
            OIDC issuer URL (e.g. https://accounts.google.com). Used to discover
            the JWKS endpoint via .well-known/openid-configuration.
        clientId:
          type: string
          title: Clientid
          description: >-
            OAuth 2.0 client ID. Used as the default audience for JWT validation
            when 'audience' is not set.
        audience:
          anyOf:
            - type: string
            - type: 'null'
          title: Audience
          description: >-
            Expected JWT 'aud' claim. Defaults to client_id if not set. Okta
            client credentials tokens use 'api://default'.
        allowedDomains:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
          title: Alloweddomains
          description: >-
            Optional list of allowed email domains (e.g. ['company.com']). When
            set, only tokens whose email claim matches one of these domains are
            accepted.
        allowedEmails:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
          title: Allowedemails
          description: >-
            Optional list of specific email addresses allowed access. When set,
            only tokens whose email claim exactly matches one of these values
            are accepted.
      type: object
      required:
        - issuer
        - clientId
      title: SSOConfig
      description: |-
        OIDC Single Sign-On configuration.

        When enabled, the engine validates JWT tokens on protected routes
        (``/agent/invoke``, ``/agent/stream``, ``/agent/copilotkit/stream``)
        against the configured OIDC provider's JWKS endpoint, discovered via
        ``{issuer}/.well-known/openid-configuration``.
    IntegrationConfig:
      properties:
        provider:
          $ref: '#/components/schemas/IntegrationProvider'
          description: The messaging provider type.
        enabled:
          type: boolean
          title: Enabled
          description: Toggle this integration on or off.
          default: true
        config:
          anyOf:
            - $ref: '#/components/schemas/WhatsAppIntegrationConfig'
            - $ref: '#/components/schemas/DiscordIntegrationConfig'
            - $ref: '#/components/schemas/SlackIntegrationConfig'
            - $ref: '#/components/schemas/GoogleChatIntegrationConfig'
            - $ref: '#/components/schemas/TeamsIntegrationConfig'
          title: Config
          description: Provider-specific configuration.
      type: object
      required:
        - provider
        - config
      title: IntegrationConfig
      description: |-
        Top-level integration configuration.

        Each integration binds an external messaging provider to the agent.
        When the engine starts, it registers webhook endpoints for each
        enabled integration.
    PromptConfig:
      properties:
        promptId:
          type: string
          title: Promptid
          description: Logical prompt identifier
        version:
          type: integer
          title: Version
          description: Prompt version number
        content:
          type: string
          title: Content
          description: Prompt text, supports Jinja2 variables
        tags:
          items:
            type: string
          type: array
          title: Tags
          description: Prompt tags
      type: object
      required:
        - promptId
        - version
        - content
      title: PromptConfig
      description: Engine-level prompt configuration.
    ServerAPIConfig:
      properties:
        port:
          type: integer
          title: Port
          default: 8000
      type: object
      title: ServerAPIConfig
      description: API server configuration.
    AgentFramework:
      type: string
      enum:
        - LANGGRAPH
        - ADK
        - CREWAI
        - CUSTOM
        - TRANSLATION_AGENT
        - CORRECTION_AGENT
        - DEEP_RESEARCH_AGENT
      title: AgentFramework
      description: Supported agent frameworks for engine.
    LangGraphAgentConfig:
      properties:
        name:
          type: string
          title: Name
        observability:
          anyOf:
            - $ref: >-
                #/components/schemas/idun_agent_schema__engine__observability__ObservabilityConfig
            - type: 'null'
          description: >-
            (Deprecated) Observability config is deprecated and will be removed
            in a future release.
          deprecated: true
        graph_definition:
          type: string
          title: Graph Definition
        checkpointer:
          anyOf:
            - $ref: '#/components/schemas/SqliteCheckpointConfig'
            - $ref: '#/components/schemas/InMemoryCheckpointConfig'
            - $ref: '#/components/schemas/PostgresCheckpointConfig'
            - type: 'null'
          title: Checkpointer
        store:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: Store
      type: object
      required:
        - name
        - graph_definition
      title: LangGraphAgentConfig
      description: Configuration model for LangGraph agents.
    AdkAgentConfig:
      properties:
        name:
          type: string
          title: Name
        observability:
          anyOf:
            - $ref: >-
                #/components/schemas/idun_agent_schema__engine__observability__ObservabilityConfig
            - type: 'null'
          description: >-
            (Deprecated) Observability config is deprecated and will be removed
            in a future release.
          deprecated: true
        agent:
          type: string
          title: Agent
          description: Agent definition (e.g. module.path:agent_instance)
        app_name:
          type: string
          title: App Name
          description: Application name for the agent
          default: ''
        session_service:
          anyOf:
            - oneOf:
                - $ref: '#/components/schemas/AdkInMemorySessionConfig'
                - $ref: '#/components/schemas/AdkVertexAiSessionConfig'
                - $ref: '#/components/schemas/AdkDatabaseSessionConfig'
              discriminator:
                propertyName: type
                mapping:
                  database:
                    $ref: '#/components/schemas/AdkDatabaseSessionConfig'
                  in_memory:
                    $ref: '#/components/schemas/AdkInMemorySessionConfig'
                  vertex_ai:
                    $ref: '#/components/schemas/AdkVertexAiSessionConfig'
            - type: 'null'
          title: Session Service
          description: Session service configuration
        memory_service:
          anyOf:
            - oneOf:
                - $ref: '#/components/schemas/AdkInMemoryMemoryConfig'
                - $ref: '#/components/schemas/AdkVertexAiMemoryConfig'
              discriminator:
                propertyName: type
                mapping:
                  in_memory:
                    $ref: '#/components/schemas/AdkInMemoryMemoryConfig'
                  vertex_ai:
                    $ref: '#/components/schemas/AdkVertexAiMemoryConfig'
            - type: 'null'
          title: Memory Service
          description: Memory service configuration
      type: object
      required:
        - name
        - agent
      title: AdkAgentConfig
      description: Configuration model for ADK agents.
    TranslationAgentConfig:
      properties:
        name:
          type: string
          title: Name
        observability:
          anyOf:
            - $ref: >-
                #/components/schemas/idun_agent_schema__engine__observability__ObservabilityConfig
            - type: 'null'
          description: >-
            (Deprecated) Observability config is deprecated and will be removed
            in a future release.
          deprecated: true
        graph_definition:
          type: string
          title: Graph Definition
        checkpointer:
          anyOf:
            - $ref: '#/components/schemas/SqliteCheckpointConfig'
            - $ref: '#/components/schemas/InMemoryCheckpointConfig'
            - $ref: '#/components/schemas/PostgresCheckpointConfig'
            - type: 'null'
          title: Checkpointer
        store:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: Store
        source_lang:
          type: string
          title: Source Lang
          description: Source language to translate from
          default: English
        target_lang:
          type: string
          title: Target Lang
          description: Target language to translate to
          default: French
        model_name:
          type: string
          title: Model Name
          description: LLM model to use
          default: gpt-3.5-turbo
      type: object
      required:
        - name
        - graph_definition
      title: TranslationAgentConfig
      description: Configuration model for the Translation Agent Template.
    CorrectionAgentConfig:
      properties:
        name:
          type: string
          title: Name
        observability:
          anyOf:
            - $ref: >-
                #/components/schemas/idun_agent_schema__engine__observability__ObservabilityConfig
            - type: 'null'
          description: >-
            (Deprecated) Observability config is deprecated and will be removed
            in a future release.
          deprecated: true
        language:
          type: string
          title: Language
          description: Language to correct text in
          default: French
        model_name:
          type: string
          title: Model Name
          description: LLM model to use
          default: gemini-2.5-flash
        checkpointer:
          anyOf:
            - $ref: '#/components/schemas/SqliteCheckpointConfig'
            - $ref: '#/components/schemas/InMemoryCheckpointConfig'
            - $ref: '#/components/schemas/PostgresCheckpointConfig'
            - type: 'null'
          title: Checkpointer
      type: object
      required:
        - name
      title: CorrectionAgentConfig
      description: Configuration model for the Correction Agent Template.
    DeepResearchAgentConfig:
      properties:
        name:
          type: string
          title: Name
        observability:
          anyOf:
            - $ref: >-
                #/components/schemas/idun_agent_schema__engine__observability__ObservabilityConfig
            - type: 'null'
          description: >-
            (Deprecated) Observability config is deprecated and will be removed
            in a future release.
          deprecated: true
        model_name:
          type: string
          title: Model Name
          description: LLM model to use
          default: gemini-2.5-flash
        project:
          type: string
          title: Project
          description: Project identifier
        region:
          type: string
          title: Region
          description: Region identifier
        tavily_api_key:
          type: string
          title: Tavily Api Key
          description: Tavily API key for web search
        system_prompt:
          type: string
          title: System Prompt
          description: System prompt for the agent
          default: Conduct research and write a polished report.
        checkpointer:
          anyOf:
            - $ref: '#/components/schemas/SqliteCheckpointConfig'
            - $ref: '#/components/schemas/InMemoryCheckpointConfig'
            - $ref: '#/components/schemas/PostgresCheckpointConfig'
            - type: 'null'
          title: Checkpointer
      type: object
      required:
        - name
        - project
        - region
        - tavily_api_key
      title: DeepResearchAgentConfig
      description: Configuration model for the Deep Research Agent Template.
    BaseAgentConfig:
      properties:
        name:
          type: string
          title: Name
        observability:
          anyOf:
            - $ref: >-
                #/components/schemas/idun_agent_schema__engine__observability__ObservabilityConfig
            - type: 'null'
          description: >-
            (Deprecated) Observability config is deprecated and will be removed
            in a future release.
          deprecated: true
      type: object
      required:
        - name
      title: BaseAgentConfig
      description: Base model for agent configurations. Extend for specific frameworks.
    BanListConfig:
      properties:
        config_id:
          type: string
          const: ban_list
          title: Config Id
          default: ban_list
        api_key:
          type: string
          title: Api Key
          default: ''
        reject_message:
          type: string
          title: Reject Message
          default: ban!!
        guard_url:
          type: string
          title: Guard Url
          default: hub://guardrails/ban_list
        banned_words:
          items:
            type: string
          type: array
          title: Banned Words
          description: A list of strings (words or phrases) to block
      type: object
      required:
        - banned_words
      title: BanListConfig
      description: Ban List configuration.
    DetectPIIConfig:
      properties:
        config_id:
          type: string
          const: detect_pii
          title: Config Id
          default: detect_pii
        api_key:
          type: string
          title: Api Key
          default: ''
        reject_message:
          type: string
          title: Reject Message
          default: PII detected
        guard_url:
          type: string
          title: Guard Url
          default: hub://guardrails/detect_pii
        pii_entities:
          items:
            type: string
          type: array
          title: Pii Entities
          description: List of PII entity types to detect
        on_fail:
          type: string
          title: On Fail
          default: exception
      type: object
      required:
        - pii_entities
      title: DetectPIIConfig
      description: Detect PII configuration.
    BiasCheckConfig:
      properties:
        config_id:
          type: string
          const: bias_check
          title: Config Id
          default: bias_check
        api_key:
          type: string
          title: Api Key
          default: ''
        guard_url:
          type: string
          title: Guard Url
          default: hub://guardrails/bias_check
        reject_message:
          type: string
          title: Reject Message
          default: Bias detected
        threshold:
          type: number
          maximum: 1
          minimum: 0
          title: Threshold
          description: Sensitivity level for bias detection
      type: object
      required:
        - threshold
      title: BiasCheckConfig
      description: Bias Check configuration.
    CompetitionCheckConfig:
      properties:
        config_id:
          type: string
          const: competition_check
          title: Config Id
          default: competition_check
        api_key:
          type: string
          title: Api Key
          default: ''
        guard_url:
          type: string
          title: Guard Url
          default: hub://guardrails/competitor_check
        reject_message:
          type: string
          title: Reject Message
          default: Competitor mentioned
        competitors:
          items:
            type: string
          type: array
          title: Competitors
          description: Names of competitor companies or products
      type: object
      required:
        - competitors
      title: CompetitionCheckConfig
      description: Competition Check configuration.
    CorrectLanguageConfig:
      properties:
        config_id:
          type: string
          const: correct_language
          title: Config Id
          default: correct_language
        api_key:
          type: string
          title: Api Key
          default: ''
        guard_url:
          type: string
          title: Guard Url
          default: hub://scb-10x/correct_language
        reject_message:
          type: string
          title: Reject Message
          default: Incorrect language detected
        expected_languages:
          items:
            type: string
          type: array
          title: Expected Languages
          description: Valid ISO language codes (e.g., en, fr, es)
      type: object
      required:
        - expected_languages
      title: CorrectLanguageConfig
      description: Correct Language configuration.
    GibberishTextConfig:
      properties:
        config_id:
          type: string
          const: gibberish_text
          title: Config Id
          default: gibberish_text
        api_key:
          type: string
          title: Api Key
          default: ''
        guard_url:
          type: string
          title: Guard Url
          default: hub://guardrails/gibberish_text
        reject_message:
          type: string
          title: Reject Message
          default: Gibberish text detected
        threshold:
          type: number
          maximum: 1
          minimum: 0
          title: Threshold
          description: Sensitivity level for gibberish detection
      type: object
      required:
        - threshold
      title: GibberishTextConfig
      description: Gibberish Text configuration.
    NSFWTextConfig:
      properties:
        config_id:
          type: string
          const: nsfw_text
          title: Config Id
          default: nsfw_text
        api_key:
          type: string
          title: Api Key
          default: ''
        guard_url:
          type: string
          title: Guard Url
          default: hub://guardrails/nsfw_text
        reject_message:
          type: string
          title: Reject Message
          default: NSFW content detected
        threshold:
          type: number
          maximum: 1
          minimum: 0
          title: Threshold
          description: Sensitivity level for NSFW content
      type: object
      required:
        - threshold
      title: NSFWTextConfig
      description: NSFW Text configuration.
    DetectJailbreakConfig:
      properties:
        config_id:
          type: string
          const: detect_jailbreak
          title: Config Id
          default: detect_jailbreak
        api_key:
          type: string
          title: Api Key
          default: ''
        guard_url:
          type: string
          title: Guard Url
          default: hub://guardrails/detect_pii
        reject_message:
          type: string
          title: Reject Message
          default: Jailbreak attempt detected
        threshold:
          type: number
          maximum: 1
          minimum: 0
          title: Threshold
          description: Sensitivity level for jailbreak detection
      type: object
      required:
        - threshold
      title: DetectJailbreakConfig
      description: Detect Jailbreak configuration.
    PromptInjectionConfig:
      properties:
        config_id:
          type: string
          const: prompt_injection
          title: Config Id
          default: prompt_injection
        api_key:
          type: string
          title: Api Key
          default: ''
        guard_url:
          type: string
          title: Guard Url
          default: hub://guardrails/detect_pii
        reject_message:
          type: string
          title: Reject Message
          default: Prompt injection detected
        threshold:
          type: number
          maximum: 1
          minimum: 0
          title: Threshold
          description: Sensitivity level for prompt injection
      type: object
      required:
        - threshold
      title: PromptInjectionConfig
      description: Prompt Injection configuration.
    RagHallucinationConfig:
      properties:
        config_id:
          type: string
          const: rag_hallucination
          title: Config Id
          default: rag_hallucination
        api_key:
          type: string
          title: Api Key
          default: ''
        guard_url:
          type: string
          title: Guard Url
          default: hub://guardrails/rag_hallucination
        reject_message:
          type: string
          title: Reject Message
          default: Hallucination detected
        threshold:
          type: number
          maximum: 1
          minimum: 0
          title: Threshold
          description: Sensitivity level for hallucination detection
      type: object
      required:
        - threshold
      title: RagHallucinationConfig
      description: RAG Hallucination configuration.
    RestrictToTopicConfig:
      properties:
        config_id:
          type: string
          const: restrict_to_topic
          title: Config Id
          default: restrict_to_topic
        api_key:
          type: string
          title: Api Key
          default: ''
        guard_url:
          type: string
          title: Guard Url
          default: hub://tryolabs/restricttotopic
        reject_message:
          type: string
          title: Reject Message
          default: Off-topic content detected
        valid_topics:
          items:
            type: string
          type: array
          title: Valid Topics
          description: Topics the agent is allowed to discuss
        invalid_topics:
          items:
            type: string
          type: array
          title: Invalid Topics
          description: Topics the agent must refuse
      type: object
      title: RestrictToTopicConfig
      description: Restrict To Topic configuration.
    ToxicLanguageConfig:
      properties:
        config_id:
          type: string
          const: toxic_language
          title: Config Id
          default: toxic_language
        api_key:
          type: string
          title: Api Key
          default: ''
        guard_url:
          type: string
          title: Guard Url
          default: hub://guardrails/toxic_language
        reject_message:
          type: string
          title: Reject Message
          default: Toxic language detected
        threshold:
          type: number
          maximum: 1
          minimum: 0
          title: Threshold
          description: Sensitivity level for toxic language
      type: object
      required:
        - threshold
      title: ToxicLanguageConfig
      description: Toxic Language configuration.
    CodeScannerConfig:
      properties:
        config_id:
          type: string
          const: code_scanner
          title: Config Id
          default: code_scanner
        api_key:
          type: string
          title: Api Key
          default: ''
        guard_url:
          type: string
          title: Guard Url
          default: hub://guardrails/code_scanner
        reject_message:
          type: string
          title: Reject Message
          default: Unauthorized code detected
        allowed_languages:
          items:
            type: string
          type: array
          title: Allowed Languages
          description: List of allowed programming languages
      type: object
      required:
        - allowed_languages
      title: CodeScannerConfig
      description: Code Scanner configuration.
    ObservabilityProvider:
      type: string
      enum:
        - LANGFUSE
        - PHOENIX
        - GCP_LOGGING
        - GCP_TRACE
        - LANGSMITH
      title: ObservabilityProvider
      description: Supported observability providers.
    LangfuseConfig:
      properties:
        provider:
          type: string
          const: LANGFUSE
          title: Provider
          default: LANGFUSE
        host:
          type: string
          title: Host
          default: https://cloud.langfuse.com
        publicKey:
          type: string
          title: Publickey
          default: ''
        secretKey:
          type: string
          title: Secretkey
          default: ''
        runName:
          type: string
          title: Runname
          default: ''
      type: object
      title: LangfuseConfig
      description: Langfuse configuration.
    PhoenixConfig:
      properties:
        provider:
          type: string
          const: PHOENIX
          title: Provider
          default: PHOENIX
        collectorEndpoint:
          type: string
          title: Collectorendpoint
          default: https://collector.phoenix.com
        projectName:
          type: string
          title: Projectname
          default: ''
      type: object
      title: PhoenixConfig
      description: Phoenix configuration.
    GCPLoggingConfig:
      properties:
        provider:
          type: string
          const: GCP_LOGGING
          title: Provider
          default: GCP_LOGGING
        gcpProjectId:
          type: string
          title: Gcpprojectid
          description: The project identifier where logs and traces will be sent.
          default: ''
        region:
          type: string
          title: Region
          description: >-
            (Optional) The specific region/zone associated with the resource
            (e.g., us-central1).
          default: ''
        logName:
          type: string
          title: Logname
          description: The identifier for the log stream (e.g., application-log).
          default: ''
        resourceType:
          type: string
          title: Resourcetype
          description: >-
            The resource type label (e.g., global, gce_instance,
            cloud_run_revision).
          default: ''
        severity:
          type: string
          title: Severity
          description: Minimum level to record (e.g., INFO, WARNING, ERROR, CRITICAL).
          default: INFO
        transport:
          type: string
          title: Transport
          description: >-
            Selection for delivery method (e.g., BackgroundThread vs
            Synchronous).
          default: BackgroundThread
      type: object
      title: GCPLoggingConfig
      description: GCP Logging configuration.
    GCPTraceConfig:
      properties:
        provider:
          type: string
          const: GCP_TRACE
          title: Provider
          default: GCP_TRACE
        gcpProjectId:
          type: string
          title: Gcpprojectid
          description: The project identifier where logs and traces will be sent.
          default: ''
        region:
          type: string
          title: Region
          description: >-
            (Optional) The specific region/zone associated with the resource
            (e.g., us-central1).
          default: ''
        traceName:
          type: string
          title: Tracename
          description: The name for the trace or tracing session.
          default: ''
        samplingRate:
          type: number
          maximum: 1
          minimum: 0
          title: Samplingrate
          description: >-
            A number between 0.0 and 1.0 indicating the probability of a request
            being traced (e.g., 1.0 for 100%, 0.1 for 10%).
          default: 1
        flushInterval:
          type: integer
          minimum: 0
          title: Flushinterval
          description: Time in seconds to wait before sending buffered traces to the cloud.
          default: 5
        ignoreUrls:
          type: string
          title: Ignoreurls
          description: >-
            A list or comma-separated string of URL paths to exclude from
            tracing (e.g., /health, /metrics).
          default: ''
      type: object
      title: GCPTraceConfig
      description: GCP Trace configuration.
    LangsmithConfig:
      properties:
        provider:
          type: string
          const: LANGSMITH
          title: Provider
          default: LANGSMITH
        apiKey:
          type: string
          title: Apikey
          description: The unique authentication key from the LangSmith settings page.
          default: ''
        projectName:
          type: string
          title: Projectname
          description: >-
            The name of the project in LangSmith to bucket these traces under
            (e.g., prod-chatbot-v1).
          default: ''
        endpoint:
          type: string
          title: Endpoint
          description: >-
            The URL endpoint, used primarily if you are self-hosting LangSmith
            or using a specific enterprise instance. (e.g.,
            https://api.smith.langchain.com)
          default: ''
        runName:
          type: string
          title: Runname
          description: The display name for each trace run in LangSmith (e.g., my-agent).
          default: ''
      type: object
      title: LangsmithConfig
      description: Langsmith configuration.
    IntegrationProvider:
      type: string
      enum:
        - WHATSAPP
        - DISCORD
        - SLACK
        - GOOGLE_CHAT
        - TEAMS
      title: IntegrationProvider
      description: Supported integration providers.
    WhatsAppIntegrationConfig:
      properties:
        accessToken:
          type: string
          title: Accesstoken
          description: Meta Graph API permanent access token.
        phoneNumberId:
          type: string
          title: Phonenumberid
          description: WhatsApp Business phone number ID.
        verifyToken:
          type: string
          title: Verifytoken
          description: >-
            Webhook verification token. Must match the token configured in the
            Meta App Dashboard webhook settings.
        apiVersion:
          type: string
          title: Apiversion
          description: Meta Graph API version.
          default: v21.0
      type: object
      required:
        - accessToken
        - phoneNumberId
        - verifyToken
      title: WhatsAppIntegrationConfig
      description: |-
        WhatsApp Business Cloud API configuration.

        Requires a Meta Business account with a WhatsApp Business API setup.
        The ``verify_token`` is used by Meta to validate the webhook endpoint
        during initial registration.
    DiscordIntegrationConfig:
      properties:
        botToken:
          type: string
          title: Bottoken
          description: Discord bot token (used for REST API calls).
        applicationId:
          type: string
          title: Applicationid
          description: Discord application ID.
        publicKey:
          type: string
          title: Publickey
          description: >-
            Ed25519 public key from the Discord application settings. Used to
            verify interaction webhook signatures.
        guildId:
          anyOf:
            - type: string
            - type: 'null'
          title: Guildid
          description: Optional guild (server) ID to restrict the integration to.
      type: object
      required:
        - botToken
        - applicationId
        - publicKey
      title: DiscordIntegrationConfig
      description: |-
        Discord bot configuration for the Interactions Endpoint webhook.

        Requires a Discord application with a bot user created at
        https://discord.com/developers/applications.  The ``public_key`` is used
        to verify Ed25519 signatures on incoming interaction payloads.
    SlackIntegrationConfig:
      properties:
        botToken:
          type: string
          title: Bottoken
          description: Slack bot token (xoxb-...).
        signingSecret:
          type: string
          title: Signingsecret
          description: Signing secret for verifying webhook requests.
      type: object
      required:
        - botToken
        - signingSecret
      title: SlackIntegrationConfig
      description: |-
        Slack Events API configuration.

        Requires a Slack app with a bot token and signing secret.
        The ``signing_secret`` is used to verify incoming webhook requests
        via HMAC-SHA256.
    GoogleChatIntegrationConfig:
      properties:
        serviceAccountCredentialsJson:
          type: string
          title: Serviceaccountcredentialsjson
          description: Service account credentials JSON for calling the Chat API.
        projectNumber:
          type: string
          title: Projectnumber
          description: GCP project number used to verify inbound JWT tokens.
        localMode:
          type: boolean
          title: Localmode
          description: >-
            When enabled, rewrites the webhook URL from http to https for JWT
            audience verification. Use this when developing behind a
            TLS-terminating proxy like ngrok.
          default: false
      type: object
      required:
        - serviceAccountCredentialsJson
        - projectNumber
      title: GoogleChatIntegrationConfig
      description: |-
        Google Chat app configuration.

        Requires a GCP project with the Google Chat API enabled,
        a service account for sending messages, and the project number
        for verifying inbound JWT bearer tokens.
    TeamsIntegrationConfig:
      properties:
        appId:
          type: string
          title: Appid
          description: Microsoft App ID from the Azure AD app registration.
        appPassword:
          type: string
          title: Apppassword
          description: Client secret from the Azure AD app registration.
        appTenantId:
          type: string
          title: Apptenantid
          description: Azure AD tenant ID that owns the app registration.
      type: object
      required:
        - appId
        - appPassword
        - appTenantId
      title: TeamsIntegrationConfig
      description: >-
        Microsoft Teams integration configuration.


        Single-tenant only: each customer registers their own Microsoft app

        in their own Azure AD and runs their own engine instance against it.

        Authentication uses Bot Framework's
        ``ConfigurationBotFrameworkAuthentication``

        with ``MicrosoftAppType=SingleTenant`` hardcoded.
    idun_agent_schema__engine__observability__ObservabilityConfig:
      properties:
        provider:
          anyOf:
            - type: string
            - type: 'null'
          title: Provider
        enabled:
          type: boolean
          title: Enabled
          default: false
        options:
          additionalProperties: true
          type: object
          title: Options
      type: object
      title: ObservabilityConfig
      description: |-
        Provider-agnostic observability configuration based on Pydantic.

        Example YAML:
          observability:
            provider: "langfuse"  # or "phoenix"
            enabled: true
            options:
              host: ${LANGFUSE_HOST}
              public_key: ${LANGFUSE_PUBLIC_KEY}
              secret_key: ${LANGFUSE_SECRET_KEY}
              run_name: "my-run"
    SqliteCheckpointConfig:
      properties:
        type:
          type: string
          const: sqlite
          title: Type
        db_url:
          type: string
          title: Db Url
      type: object
      required:
        - type
        - db_url
      title: SqliteCheckpointConfig
      description: Configuration for SQLite checkpointer.
    InMemoryCheckpointConfig:
      properties:
        type:
          type: string
          const: memory
          title: Type
      type: object
      required:
        - type
      title: InMemoryCheckpointConfig
      description: Configuration for In-Memory checkpointer.
    PostgresCheckpointConfig:
      properties:
        type:
          type: string
          const: postgres
          title: Type
        db_url:
          type: string
          title: Db Url
      type: object
      required:
        - type
        - db_url
      title: PostgresCheckpointConfig
      description: Configuration for Postgres checkpointer.
    AdkInMemorySessionConfig:
      properties:
        type:
          type: string
          const: in_memory
          title: Type
          default: in_memory
      type: object
      title: AdkInMemorySessionConfig
      description: Configuration for In-Memory Session Service.
    AdkVertexAiSessionConfig:
      properties:
        type:
          type: string
          const: vertex_ai
          title: Type
          default: vertex_ai
        project_id:
          type: string
          title: Project Id
          description: Google Cloud Project ID
        location:
          type: string
          title: Location
          description: Google Cloud Location (e.g. us-central1)
        reasoning_engine_app_name:
          type: string
          title: Reasoning Engine App Name
          description: Reasoning Engine Application Name or ID
      type: object
      required:
        - project_id
        - location
        - reasoning_engine_app_name
      title: AdkVertexAiSessionConfig
      description: Configuration for Vertex AI Session Service.
    AdkDatabaseSessionConfig:
      properties:
        type:
          type: string
          const: database
          title: Type
          default: database
        db_url:
          type: string
          title: Db Url
          description: Database URL (e.g. postgresql+psycopg://...)
      type: object
      required:
        - db_url
      title: AdkDatabaseSessionConfig
      description: Configuration for Database Session Service.
    AdkInMemoryMemoryConfig:
      properties:
        type:
          type: string
          const: in_memory
          title: Type
          default: in_memory
      type: object
      title: AdkInMemoryMemoryConfig
      description: Configuration for In-Memory Memory Service.
    AdkVertexAiMemoryConfig:
      properties:
        type:
          type: string
          const: vertex_ai
          title: Type
          default: vertex_ai
        project_id:
          type: string
          title: Project Id
          description: Google Cloud Project ID
        location:
          type: string
          title: Location
          description: Google Cloud Location
        memory_bank_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Memory Bank Id
          description: Vertex AI Memory Bank Resource ID
      type: object
      required:
        - project_id
        - location
      title: AdkVertexAiMemoryConfig
      description: Configuration for Vertex AI Memory Service.

````