Skip to content

Update declarative agent templates to schema/version v1.8 - #16439

Draft
HuihuiWu-Microsoft with Copilot wants to merge 2 commits into
devfrom
copilot/update-declarative-agent-manifest-version
Draft

Update declarative agent templates to schema/version v1.8#16439
HuihuiWu-Microsoft with Copilot wants to merge 2 commits into
devfrom
copilot/update-declarative-agent-manifest-version

Conversation

Copilot AI commented Jul 23, 2026

Copy link
Copy Markdown
Contributor

The declarative agent scaffolding templates were still pinned to manifest schema v1.7. This updates template outputs to v1.8 consistently across all DA template families, with no behavioral/template-shape changes beyond versioning.

  • Scope: declarative agent template manifests

    • Updated all DA manifest template files that emit declarativeAgent.json / repairDeclarativeAgent.json.
    • Applied uniformly across:
      • templates/vsc/** (common/js/ts)
      • templates/vs/** (csharp)
      • templates/v4/create/da/**
  • What changed

    • Bumped schema URL from .../declarative-agent/v1.7/schema.json to .../declarative-agent/v1.8/schema.json.
    • Bumped manifest version field from "v1.7" to "v1.8".
  • Representative diff

{
  "$schema": "https://developer.microsoft.com/json-schemas/copilot/declarative-agent/v1.8/schema.json",
  "version": "v1.8"
}

Copilot AI changed the title [WIP] Update declarative agent manifest version to v1.8 in templates Update declarative agent templates to schema/version v1.8 Jul 23, 2026
Copilot AI requested a review from HuihuiWu-Microsoft July 23, 2026 08:08
@HuihuiWu-Microsoft

Copy link
Copy Markdown
Contributor

@copilot help me summarize why agent skill feature still works while agent_skill is removed from v1.8 schema when the agent skill template is marked at v1.8 and v1.9 manifest

Copilot AI commented Jul 29, 2026

Copy link
Copy Markdown
Contributor Author

@copilot help me summarize why agent skill feature still works while agent_skill is removed from v1.8 schema when the agent skill template is marked at v1.8 and v1.9 manifest

It still works for two reasons:

  1. In this repo, DA schema v1.8 still includes agent_skills (packages/manifest/src/json-schemas/copilot/declarative-agent/v1.8/schema.json), so the skill template at v1.8 is valid.

  2. Runtime packaging has compatibility paths:

  • DA path reads both agent_skills and x-agent_skills when zipping app package (packages/fx-core/src/component/driver/teamsApp/createAppPackage.ts).
  • Add-skill flow also writes top-level Teams manifest agentSkills (packages/fx-core/src/core/FxCore.ts), and packaging processes that as well.

So even if a newer DA schema version removes agent_skills, skill packaging can still work via the Teams manifest agentSkills path/back-compat handling.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Update Declarative Agent Manifest Version to v1.8 in each template

2 participants