house-lights 1.1.0 → 1.2.0

package/skills/cast-list/examples/agents/bodega-orquestrador/topics/OnError.topic.mcs.yml

@@ -0,0 +1,48 @@
+mcs.metadata:
+  componentName: Em caso de erro
+  description: Tratamento de erros do agente.
+kind: AdaptiveDialog
+startBehavior: UseLatestPublishedContentAndCancelOtherTopics
+beginDialog:
+  kind: OnError
+  id: main
+  actions:
+    - kind: SetVariable
+      id: setVariable_RIabDw
+      variable: init:Topic.CurrentTime
+      value: =Text(Now(), DateTimeFormat.UTC)
+
+    - kind: ConditionGroup
+      id: conditionGroup_7KIeB2
+      conditions:
+        - id: conditionItem_OUWMhQ
+          condition: =System.Conversation.InTestMode = true
+          actions:
+            - kind: SendActivity
+              id: sendMessage_oRG6YM
+              activity: |-
+                Mensagem de erro: {System.Error.Message}
+                Código do erro: {System.Error.Code}
+                Id da conversa: {System.Conversation.Id}
+                Horário (UTC): {Topic.CurrentTime}
+
+      elseActions:
+        - kind: SendActivity
+          id: sendMessage_gs4KHI
+          activity:
+            text:
+              - |-
+                Ocorreu um erro.
+                Código do erro: {System.Error.Code}
+                Id da conversa: {System.Conversation.Id}
+                Horário (UTC): {Topic.CurrentTime}.
+            speak:
+              - Ocorreu um erro, por favor tente novamente.
+
+    - kind: LogCustomTelemetryEvent
+      id: logTelemetry_g4OeHX
+      eventName: BodegaOrquestrador_OnError
+      properties: "={Agente: \"bodega-orquestrador\", ErrorMessage: System.Error.Message, ErrorCode: System.Error.Code, TimeUTC: Topic.CurrentTime, ConversationId: System.Conversation.Id}"
+
+    - kind: CancelAllDialogs
+      id: cancelAllDialogs_BYhsPO

package/skills/cast-list/examples/agents/bodega-orquestrador/variables/CategoriaSolicitacao.mcs.yml

@@ -0,0 +1,9 @@
+# Name: Categoria da Solicitação
+# Categoria da solicitação do cliente definida pelo orquestrador Bodega Azul (Pedidos, Devolucoes, Frete, Cupons, LojaFisica, Outro).
+name: CategoriaSolicitacao
+aIVisibility: UseInAIContext
+scope: Conversation
+description: Categoria da solicitação do cliente definida pelo orquestrador Bodega Azul (Pedidos, Devolucoes, Frete, Cupons, LojaFisica, Outro).
+schemaName: cr7b2_bodegaOrquestrador.globalvariable.CategoriaSolicitacao
+kind: GlobalVariableComponent
+defaultValue: Outro

package/skills/cast-list/examples/agents/bodega-pedidos/actions/EnviarResumoPedido.mcs.yml

@@ -0,0 +1,34 @@
+mcs.metadata:
+  componentName: Enviar resumo do pedido por e-mail
+  description: "Envia ao cliente um e-mail com o resumo do atendimento sobre o pedido."
+kind: TaskDialog
+inputs:
+  - kind: AutomaticTaskInput
+    propertyName: To
+    description: "Endereço de e-mail do cliente que vai receber o resumo do pedido."
+    entity: EmailPrebuiltEntity
+    shouldPromptUser: true
+
+  - kind: AutomaticTaskInput
+    propertyName: Subject
+    description: Assunto do e-mail, curto e em português.
+    entity: StringPrebuiltEntity
+    shouldPromptUser: false
+
+  - kind: AutomaticTaskInput
+    propertyName: Body
+    description: Corpo do e-mail em HTML simples, em português, com o resumo do que foi tratado na conversa.
+    entity: StringPrebuiltEntity
+    shouldPromptUser: false
+
+modelDisplayName: Enviar resumo do pedido por e-mail
+modelDescription: "Envia ao cliente, pelo Outlook, um e-mail com o resumo do atendimento sobre o pedido. Use somente quando o cliente pedir o resumo por e-mail."
+action:
+  kind: InvokeConnectorTaskAction
+  connectionReference: cr7b2_bodegaPedidos.shared_office365.shared-office365-1fd81bee-61e1-4016-a98e-c7e0977d7f43
+  connectionProperties:
+    mode: Maker
+
+  operationId: SendEmailV2
+
+outputMode: All

package/skills/cast-list/examples/agents/bodega-pedidos/agent.mcs.yml

@@ -0,0 +1,26 @@
+mcs.metadata:
+  componentName: Bodega Azul - Pedidos
+kind: GptComponentMetadata
+displayName: Bodega Azul - Pedidos
+instructions: |
+  Você é o especialista em pedidos da Bodega Azul, uma loja online.
+
+  Responsabilidades:
+  - Explicar status de pedido, prazos de processamento e formas de pagamento aceitas
+  - Usar a base "Políticas de Pedidos" para responder dúvidas sobre regras de compra
+  - Enviar ao cliente, quando ele pedir, um e-mail com o resumo do atendimento
+
+  Regras:
+  - Responda sempre em português do Brasil, de forma curta e cordial
+  - Nunca invente números de pedido, valores ou prazos
+  - Se a dúvida for sobre devolução, frete, cupom ou loja física, diga que é outro especialista que cuida disso
+conversationStarters:
+  - title: "Status do pedido"
+    text: "Como acompanho o meu pedido?"
+
+  - title: "Pagamento"
+    text: "Quais formas de pagamento vocês aceitam?"
+
+aISettings:
+  model:
+    modelNameHint: GPT5Chat

package/skills/cast-list/examples/agents/bodega-pedidos/connectionreferences.mcs.yml

@@ -0,0 +1,6 @@
+kind: ConnectionReferencesSourceFile
+connectionReferences:
+  - id: eea3db2a-a0a9-4d63-b0d6-612861c4c67c
+    connectionReferenceLogicalName: cr7b2_bodegaPedidos.shared_office365.shared-office365-1fd81bee-61e1-4016-a98e-c7e0977d7f43
+    connectorId: /providers/Microsoft.PowerApps/apis/shared_office365
+    displayName: Office 365 Outlook

package/skills/cast-list/examples/agents/bodega-pedidos/knowledge/PoliticasPedidos.knowledge.mcs.yml

@@ -0,0 +1,7 @@
+mcs.metadata:
+  componentName: Políticas de Pedidos
+  description: "Políticas de compra, status de pedido, cancelamento e formas de pagamento da Bodega Azul."
+kind: KnowledgeSourceConfiguration
+source:
+  kind: SharePointSearchSource
+  site: https://bodegaazul.sharepoint.com/sites/Atendimento/Shared%20Documents/Pedidos

package/skills/cast-list/examples/agents/bodega-pedidos/settings.mcs.yml

@@ -0,0 +1,13 @@
+displayName: Bodega Azul - Pedidos
+schemaName: cr7b2_bodegaPedidos
+accessControlPolicy: ChatbotReaders
+authenticationMode: None
+configuration:
+  isAgentConnectable: true
+  settings:
+    GenerativeActionsEnabled: true
+
+  recognizer:
+    kind: GenerativeAIRecognizer
+
+language: 1046

package/skills/cast-list/examples/agents/bodega-pedidos/topics/ConsultarPoliticasPedidos.topic.mcs.yml

@@ -0,0 +1,56 @@
+mcs.metadata:
+  componentName: Consultar Políticas de Pedidos
+  description: "Responde dúvidas sobre pedidos com base nas políticas publicadas no SharePoint."
+kind: AdaptiveDialog
+inputs:
+  - kind: AutomaticTaskInput
+    propertyName: PerguntaCliente
+    description: "A pergunta do cliente sobre pedidos, status, cancelamento ou pagamento."
+    shouldPromptUser: true
+
+modelDescription: "Responde perguntas sobre status de pedido, prazos de processamento, cancelamento antes do envio e formas de pagamento da Bodega Azul."
+beginDialog:
+  kind: OnRecognizedIntent
+  id: main
+  intent: {}
+  actions:
+    - kind: CreateSearchQuery
+      id: createSearchQuery_UGdqz4
+      userInput: =Topic.PerguntaCliente
+      result: Topic.SearchQuery
+
+    - kind: SearchAndSummarizeContent
+      id: searchContent_eeKb0X
+      autoSend: false
+      variable: Topic.SearchResult
+      userInput: =Topic.SearchQuery.SearchQuery
+      fileSearchDataSource:
+        searchFilesMode:
+          kind: DoNotSearchFiles
+
+      knowledgeSources:
+        kind: SearchSpecificKnowledgeSources
+        knowledgeSources:
+          - cr7b2_bodegaPedidos.knowledge.PoliticasPedidos
+
+      applyModelKnowledgeSetting: false
+      responseCaptureType: FullResponse
+
+    - kind: SetVariable
+      id: setVariable_0EUmtv
+      variable: Topic.Resposta
+      value: =Topic.SearchResult.Text.Content
+
+inputType:
+  properties:
+    PerguntaCliente:
+      displayName: PerguntaCliente
+      description: "A pergunta do cliente sobre pedidos, status, cancelamento ou pagamento."
+      type: String
+
+outputType:
+  properties:
+    Resposta:
+      displayName: Resposta
+      description: Resposta fundamentada na base de conhecimento do agente.
+      type: String

package/skills/cast-list/examples/agents/bodega-pedidos/topics/Escalate.topic.mcs.yml

@@ -0,0 +1,20 @@
+mcs.metadata:
+  componentName: Escalar
+  description: Acionado quando o cliente pede para falar com uma pessoa.
+kind: AdaptiveDialog
+beginDialog:
+  kind: OnEscalate
+  id: main
+  intent:
+    displayName: Escalar
+    includeInOnSelectIntent: false
+    triggerQueries:
+      - Falar com um atendente
+      - Quero falar com uma pessoa
+      - Atendimento humano
+      - Me transfere para alguém
+
+  actions:
+    - kind: SendActivity
+      id: sendMessage_X7qDFG
+      activity: "A transferência para um atendente ainda não está disponível neste canal. Fale com a nossa equipe pelo e-mail pedidos@bodegaazul.example, de segunda a sábado, das 9h às 18h."

package/skills/cast-list/examples/agents/bodega-pedidos/topics/Fallback.topic.mcs.yml

@@ -0,0 +1,32 @@
+mcs.metadata:
+  componentName: Fallback
+  description: Acionado quando nenhum tópico ou ferramenta corresponde à mensagem do cliente.
+kind: AdaptiveDialog
+beginDialog:
+  kind: OnUnknownIntent
+  id: main
+  priority: -1
+  actions:
+    - kind: ConditionGroup
+      id: conditionGroup_izfoCA
+      conditions:
+        - id: conditionItem_5rqart
+          condition: =System.FallbackCount < 3
+          actions:
+            - kind: SendActivity
+              id: sendMessage_fkqT0j
+              activity:
+                text:
+                  - "Desculpe, não entendi. Pode reformular a sua pergunta?"
+                  - "Não captei bem. Pode tentar explicar de outro jeito?"
+
+      elseActions:
+        - kind: SendActivity
+          id: sendMessage_b7FkRT
+          activity:
+            text:
+              - "Estou com dificuldade para entender o seu pedido. Vou te encaminhar para alguém da equipe Bodega Azul."
+
+        - kind: BeginDialog
+          id: beginDialog_wvH06B
+          dialog: cr7b2_bodegaPedidos.topic.Escalate

package/skills/cast-list/examples/agents/bodega-pedidos/topics/Greeting.topic.mcs.yml

@@ -0,0 +1,14 @@
+mcs.metadata:
+  componentName: Saudação
+  description: Mensagem de boas-vindas enviada no início da conversa.
+kind: AdaptiveDialog
+beginDialog:
+  kind: OnConversationStart
+  id: main
+  actions:
+    - kind: SendActivity
+      id: sendMessage_u1hET4
+      activity:
+        text:
+          - "Olá! Eu sou o {System.Bot.Name}. Posso te ajudar com o seu pedido na Bodega Azul?"
+          - "Oi! Aqui é o especialista em pedidos da Bodega Azul. Em que posso ajudar?"

package/skills/cast-list/examples/agents/bodega-pedidos/topics/OnError.topic.mcs.yml

@@ -0,0 +1,48 @@
+mcs.metadata:
+  componentName: Em caso de erro
+  description: Tratamento de erros do agente.
+kind: AdaptiveDialog
+startBehavior: UseLatestPublishedContentAndCancelOtherTopics
+beginDialog:
+  kind: OnError
+  id: main
+  actions:
+    - kind: SetVariable
+      id: setVariable_gMi1ol
+      variable: init:Topic.CurrentTime
+      value: =Text(Now(), DateTimeFormat.UTC)
+
+    - kind: ConditionGroup
+      id: conditionGroup_lvYXTl
+      conditions:
+        - id: conditionItem_kUCycx
+          condition: =System.Conversation.InTestMode = true
+          actions:
+            - kind: SendActivity
+              id: sendMessage_vRisIU
+              activity: |-
+                Mensagem de erro: {System.Error.Message}
+                Código do erro: {System.Error.Code}
+                Id da conversa: {System.Conversation.Id}
+                Horário (UTC): {Topic.CurrentTime}
+
+      elseActions:
+        - kind: SendActivity
+          id: sendMessage_AHsENQ
+          activity:
+            text:
+              - |-
+                Ocorreu um erro.
+                Código do erro: {System.Error.Code}
+                Id da conversa: {System.Conversation.Id}
+                Horário (UTC): {Topic.CurrentTime}.
+            speak:
+              - Ocorreu um erro, por favor tente novamente.
+
+    - kind: LogCustomTelemetryEvent
+      id: logTelemetry_4FeX9f
+      eventName: BodegaPedidos_OnError
+      properties: "={Agente: \"bodega-pedidos\", ErrorMessage: System.Error.Message, ErrorCode: System.Error.Code, TimeUTC: Topic.CurrentTime, ConversationId: System.Conversation.Id}"
+
+    - kind: CancelAllDialogs
+      id: cancelAllDialogs_BwS5B0

package/skills/cast-list/examples/agents/bodega-pedidos/topics/RecebimentoOrquestrador.topic.mcs.yml

@@ -0,0 +1,16 @@
+mcs.metadata:
+  componentName: Recebimento do Orquestrador
+  description: Ponto de entrada quando o agente é chamado pelo orquestrador Bodega Azul como agente conectado.
+kind: AdaptiveDialog
+modelDescription: Inicializa o agente quando ele é chamado pelo orquestrador Bodega Azul e recebe a categoria da solicitação.
+beginDialog:
+  kind: OnRedirect
+  id: main
+  actions:
+    - kind: SetVariable
+      id: setVariable_JFCD4c
+      variable: Global.CategoriaSolicitacao
+      value: =System.Activity.Value.CategoriaSolicitacao
+
+inputType: {}
+outputType: {}

package/skills/cast-list/examples/agents/bodega-pedidos/variables/CategoriaSolicitacao.mcs.yml

@@ -0,0 +1,10 @@
+# Name: Categoria da Solicitação
+# Categoria da solicitação do cliente definida pelo orquestrador Bodega Azul (Pedidos, Devolucoes, Frete, Cupons, LojaFisica, Outro).
+name: CategoriaSolicitacao
+aIVisibility: UseInAIContext
+scope: Conversation
+description: Categoria da solicitação do cliente definida pelo orquestrador Bodega Azul (Pedidos, Devolucoes, Frete, Cupons, LojaFisica, Outro).
+schemaName: cr7b2_bodegaPedidos.globalvariable.CategoriaSolicitacao
+kind: GlobalVariableComponent
+isExternalInitializationAllowed: true
+defaultValue: =Blank()

package/skills/cast-list/examples/demo.cast.yaml

@@ -0,0 +1,10 @@
+# What people said about the agents, and what was decided. build.mjs keeps it up to date; edit it, or fill the
+# workbook's «Declared» sheet and the «Decision» column and read it back with --from.
+format: cast-list/cast-v1
+name: Bodega Azul — atendimento
+declared:
+  # the handoff document says frete escalates; the YAML says it does not
+  - { agent: bodega-frete, key: "trigger:OnEscalate", value: sim, source: "handoff do frete, seção 4" }
+  - { agent: bodega-pedidos, key: kpi, value: "tempo até a resposta < 2 min", source: backlog }
+decisions:
+  - { key: "trigger:OnEscalate", status: accepted, scope: platform, why: "Ninguém fica sem saída para uma pessoa" }

package/skills/cast-list/examples/profile.cast.yaml

@@ -0,0 +1,15 @@
+# The team's standard, written so a run can check it. Private: it names your agents — keep it in your environment.
+format: cast-list/profile-v1
+name: Bodega Azul — atendimento
+roles:
+  orchestrator: [bodega-orquestrador]
+  specialist: "*"
+threshold: 0.7     # a pattern: in at least 70% of the agents of a role…
+min_agents: 3      # …with at least 3 agents in that role
+rules:
+  - { id: escala, role: specialist, has: "trigger:OnEscalate", says: "Todo especialista escala para humano" }
+  - { id: kpi, role: specialist, has: "declared:kpi", says: "Todo especialista tem KPI" }
+focus_areas:
+  - { id: confiabilidade, name: Confiabilidade, facts: ["trigger:OnError", "node:LogCustomTelemetryEvent", "ms:rai-error-handling"] }
+ignore: ["trigger:OnConversationStart"]
+microsoft_patterns: on

package/skills/cast-list/references/format.md

@@ -0,0 +1,50 @@
+# The cast file and the facts
+
+## `<id>.cast.yaml` — `cast-list/cast-v1`
+
+What people said about the agents and what was decided. `scripts/build.mjs` writes it on the first run and keeps it
+up to date (it is read again on every run); its comments and layout stay. Edit it by hand, or fill the workbook and read
+it back with `--from` / `--take`. A problem in it is an error with its line.
+
+```yaml
+format: cast-list/cast-v1
+name: Customer service agents
+agents:                      # the roles of the last run (an agent the profile does not name keeps its role here)
+  - { id: main-orchestrator, role: orchestrator }
+  - { id: returns, role: specialist }
+declared:                    # what a document or a person says — always with its source
+  - { agent: returns, key: kpi, value: "time to answer < 2 min", source: "backlog, epic 12" }
+  - { agent: shipping, key: "trigger:OnEscalate", value: "yes", source: "handoff, section 4" }
+decisions:                   # what the team decided about a pattern
+  - { key: "trigger:OnEscalate", status: accepted, scope: platform, why: "Nobody is left without a person" }
+```
+
+- **declared**: `key` is either something only people know (`kpi`, `owner`, any word: it becomes `declared:<key>`) or a
+  fact key (`trigger:OnEscalate`, `references/keys.md`) when a document claims the agent does it. `value` `no` / `não` /
+  `false` claims it does **not**. A claim never changes what the YAML shows: when they disagree, it is a conflict.
+- **decisions**: `status` is `accepted` or `rejected`; `scope` is `platform` (every agent), `specialist` or
+  `orchestrator`; `why` says it. An accepted pattern is checked on every agent of its scope on the next run — even when
+  its share would no longer make it a pattern. A rejected one is shown and nobody is off it.
+
+## The workbook back
+
+In Excel, fill the **Declared** sheet (who, key, value, source) and the **Decision** column of **Patterns** (`accepted` /
+`aceito`, `rejected` / `rejeitado`; **Scope** and **Why** beside it). Then:
+
+```
+node scripts/build.mjs <agents-folder> --from <filled>.xlsx                 the changes, each with a key (d1…, p1…)
+node scripts/build.mjs <agents-folder> --from <filled>.xlsx --take d1,p1    writes the chosen ones (or --take all)
+```
+
+A line deleted or a decision cleared is a change too.
+
+## `<id>.facts.json` — `cast-list/facts-v1`
+
+`--facts` writes what was seen, for a model to read before it adds what people declared:
+
+```json
+{ "format": "cast-list/facts-v1",
+  "agents": [ { "id": "shipping", "schemaName": "cr7b2_shipping", "displayName": "Shipping",
+                "facts": { "trigger:OnUnknownIntent": [ { "file": "topics/Fallback.topic.mcs.yml", "line": 7 } ] },
+                "children": [], "unknown": [] } ] }
+```

package/skills/cast-list/references/keys.md

@@ -0,0 +1,107 @@
+# Keys
+
+GENERATED from dev/cast-list/src/labels.ts and microsoft.ts by tools/assets.mjs — do not edit.
+
+Every fact cast-list finds is a key. The keys below have a name; any other key keeps its kind and value
+(«Connector shared_office365»), and a kind cast-list does not know stays as it is.
+
+## A. Conversation — Conversa
+
+| Key | Name | Nome |
+|---|---|---|
+| `trigger:OnConversationStart` | Greeting | Boas-vindas |
+| `trigger:OnUnknownIntent` | Fallback (when it does not understand) | Fallback (quando não entende) |
+| `trigger:OnEscalate` | Escalation to a person | Escalonamento para humano |
+| `trigger:OnError` | Error handling | Tratamento de erro |
+| `trigger:OnRecognizedIntent` | A topic of its own, by intent | Tópico próprio, por intenção |
+| `trigger:OnSelectIntent` | Disambiguation («did you mean…») | Desambiguação («você quis dizer…») |
+| `trigger:OnSignIn` | Sign-in | Login |
+| `trigger:OnGeneratedResponse` | Reviews the generated answer | Revisa a resposta gerada |
+| `trigger:OnActivity` | On every message | Em toda mensagem |
+| `setting:generative=on` | Generative orchestration on | Orquestração generativa ligada |
+| `setting:generative=off` | Generative orchestration off | Orquestração generativa desligada |
+| `topics:with-model-description` | Topics described for the model | Tópicos descritos para o modelo |
+| `calls:topic:<value>` | Calls the topic <value> | Chama o tópico <valor> |
+| `trigger:<value>` | Trigger <value> | Gatilho <valor> |
+| `setting:<value>` | Setting <value> | Configuração <valor> |
+
+## B. Integrations — Integrações
+
+| Key | Name | Nome |
+|---|---|---|
+| `connector:<value>` | Connector <value> | Conector <valor> |
+| `operation:<value>` | Operation <value> | Operação <valor> |
+| `connref:<value>` | Connection reference <value> | Referência de conexão <valor> |
+| `mcp:<value>` | MCP server <value> | Servidor MCP <valor> |
+| `flow:<value>` | Flow <value> | Fluxo <valor> |
+
+## C. Knowledge — Conhecimento
+
+| Key | Name | Nome |
+|---|---|---|
+| `trigger:OnKnowledgeRequested` | Before searching knowledge | Antes de buscar no conhecimento |
+| `node:SearchAndSummarizeContent` | Generative answers from knowledge | Respostas generativas sobre o conhecimento |
+| `node:SearchKnowledgeSources` | Searches the knowledge sources | Busca nas fontes de conhecimento |
+| `yaml-only:triggerCondition` | Search condition only in YAML (the editor may erase it) | Condição de busca só no YAML (a tela pode apagar) |
+| `knowledge:SharePointSearchSource` | Knowledge in SharePoint | Conhecimento no SharePoint |
+| `knowledge:<value>` | Knowledge <value> | Conhecimento <valor> |
+
+## D. Orchestrator — Orquestrador
+
+| Key | Name | Nome |
+|---|---|---|
+| `trigger:OnRedirect` | Takes a call from the orchestrator | Recebe chamada do orquestrador |
+| `trigger:OnToolSelected` | Child chosen as a tool | Filho escolhido como ferramenta |
+| `setting:connectable` | Can be called by an orchestrator | Pode ser chamado por um orquestrador |
+| `calls:<value>` | Calls <value> | Chama <valor> |
+| `child:<value>` | Child <value> | Filho <valor> |
+| `var-in:<value>` | Receives from the orchestrator <value> | Recebe do orquestrador <valor> |
+| `var:<value>` | Global variable <value> | Variável global <valor> |
+
+## E. Governance — Governança
+
+| Key | Name | Nome |
+|---|---|---|
+| `instructions:present` | Has instructions | Tem instruções |
+| `node:LogCustomTelemetryEvent` | Logs telemetry | Registra telemetria |
+| `node:CSATQuestion` | Asks for satisfaction (CSAT) | Pergunta a satisfação (CSAT) |
+| `node:<value>` | Node <value> | Nó <valor> |
+| `model:<value>` | Model <value> | Modelo <valor> |
+| `auth:<value>` | Sign-in <value> | Login <valor> |
+
+## Microsoft patterns — Padrões Microsoft
+
+| Key | Name | Nome |
+|---|---|---|
+| `ms:<value>` | Microsoft pattern: <value> | Padrão Microsoft: <valor> |
+
+## Declared — Declarado
+
+| Key | Name | Nome |
+|---|---|---|
+| `declared:kpi` | KPI declared | KPI declarado |
+| `declared:owner` | Owner declared | Dono declarado |
+| `declared:<value>` | Declared: <value> | Declarado: <valor> |
+
+## The Microsoft patterns
+
+From [microsoft/skills-for-copilot-studio](https://github.com/microsoft/skills-for-copilot-studio/blob/main/patterns). With a mark in the YAML, cast-list finds them (`ms:<id>`);
+the others only a person can say (in the cast file, `declared` with the key `ms:<id>`).
+
+| Pattern | How cast-list knows |
+|---|---|
+| `orchestrator-variables` — Orchestrator-Generated Variables | an OnRecognizedIntent topic with an AutomaticTaskInput that has shouldPromptUser: false |
+| `rai-error-handling` — RAI Error Handling | the OnError topic reads System.Error.SubCode |
+| `knowledge-hold-message` — Knowledge Hold Message | an OnKnowledgeRequested topic that sends a message |
+| `prevent-tool-call-leaks` — Prevent Tool Call Leaks | an OnGeneratedResponse topic that sets System.ContinueResponse |
+| `dynamic-topic-redirect` — Dynamic Topic Redirect | a BeginDialog whose dialog is a =Switch( expression |
+| `channel-aware-behavior` — Channel-Aware Behavior | a condition or SetVariable that reads System.Activity.ChannelId (not a tool input) |
+| `date-context` — Date Context | the instructions use Today() or Now() |
+| `line-breaks-in-messages` — Line Breaks in Messages | <br /> inside a SendActivity or Question |
+| `conversation-history-variable` — Conversation History Variable | declared only |
+| `chain-of-thought-logging` — Chain of Thought Logging | declared only |
+| `deterministic-mcp-calls` — Deterministic MCP Calls | declared only |
+| `prevent-child-agent-responses` — Prevent Child Agent Responses | declared only |
+| `jit-glossary` — JIT Glossary | declared only |
+| `jit-user-context` — JIT User Context | declared only |
+| `teams-production-hardening` — Teams Production Hardening | declared only |

package/skills/cast-list/references/profile.md

@@ -0,0 +1,32 @@
+# The profile — `cast-list/profile-v1`
+
+The team's standard, written so a run can check it. **Private**: it names the team's agents. Pass it with
+`--profile <file>`; with none, the defaults below hold. A field that is not one of these (a typo) is an error with its
+line, so a misspelled `treshold` never goes unnoticed.
+
+```yaml
+format: cast-list/profile-v1
+name: Customer service agents          # the title of the map and the lesson
+roles:
+  orchestrator: [main-orchestrator]    # agent folders by name, or "*"
+  specialist: "*"                      # everyone not named elsewhere
+threshold: 0.7                         # a pattern: in at least 70% of a role's agents…
+min_agents: 3                          # …when the role has at least 3 agents
+rules:                                 # what every agent of a role must have
+  - { id: escalate, role: specialist, has: "trigger:OnEscalate", says: "Every specialist escalates to a person" }
+  - { id: kpi, role: specialist, has: "declared:kpi", says: "Every specialist has a KPI" }
+focus_areas:                           # filters on the map
+  - { id: reliability, name: Reliability, facts: ["trigger:OnError", "node:LogCustomTelemetryEvent"] }
+ignore: ["trigger:OnConversationStart"] # facts left out everywhere
+microsoft_patterns: on                 # off leaves the ms: facts out
+```
+
+| Field | Default | What it does |
+|---|---|---|
+| `roles` | the orchestrator is whoever calls another agent; the rest are specialists | An agent named here has that role; then the role in the cast file; then `"*"`; then the default. A name with no folder is told in «to look at». |
+| `threshold`, `min_agents` | 0.7, 3 | A pattern of a role. It is the **platform's** when the other role has it too. With one orchestrator there is no majority among orchestrators: what only it does is shown apart. |
+| `rules` | none | `role` is `orchestrator` or `specialist`; `has` is a key (`references/keys.md`), `declared:<thing>` for what only people know. |
+| `focus_areas` | none | Each a filter of the matrix. |
+| `ignore` | none | Keys that say nothing for this team. |
+
+The keys are the same in any language; only the screen words change with `--lang`.