feat: support direct code deployment

[anchenyi]

Description

1. Support direct code deployment.
2. Fixes the eval CI by pinning vally-cli to the version that supports the current lint --eval command.

Checklist

• Tests pass locally (cd tests && npm test)
• If modifying skill descriptions: verified routing correctness with integration tests (npm run test:skills:integration -- <skill>)
• If modifying skill USE FOR / DO NOT USE FOR / PREFER OVER clauses: confirmed no routing regressions for competing skills

Related Issues

[github-actions]

Details

# 🔍 Token Analysis Report

@github-copilot-for-azure/scripts@1.0.0 tokens
node --import tsx src/tokens/cli.ts compare --base origin/main --head HEAD --markdown

fatal: path 'plugin/skills/microsoft-foundry/foundry-agent/deploy/references/direct-code-deployment.md' exists on disk, but not in 'origin/main'
fatal: path 'plugin/skills/microsoft-foundry/foundry-agent/invoke/references/direct-code-invocation.md' exists on disk, but not in 'origin/main'
fatal: path 'plugin/skills/microsoft-foundry/foundry-agent/troubleshoot/references/direct-code-troubleshooting.md' exists on disk, but not in 'origin/main'

📊 Token Change Report

Comparing origin/main → HEAD

Summary

Metric	Value
📈 Total Change	+8,950 tokens (+73%)
Before	12,271 tokens
After	21,221 tokens
Files Changed	7

Changed Files

File	Before	After	Change
plugin/skills/microsoft-foundry/foundry-agent/deploy/references/direct-code-deployment.md	-	4,412	+4412
plugin/skills/microsoft-foundry/foundry-agent/troubleshoot/references/direct-code-troubleshooting.md	-	2,214	+2214
plugin/skills/microsoft-foundry/foundry-agent/invoke/references/direct-code-invocation.md	-	1,697	+1697
plugin/skills/microsoft-foundry/foundry-agent/deploy/deploy.md	6,203	6,589	+386 (+6%)
plugin/skills/microsoft-foundry/foundry-agent/invoke/invoke.md	1,980	2,122	+142 (+7%)
plugin/skills/microsoft-foundry/foundry-agent/troubleshoot/troubleshoot.md	1,715	1,806	+91 (+5%)
plugin/skills/microsoft-foundry/references/agent-metadata-contract.md	2,373	2,381	+8 (0%)

@github-copilot-for-azure/scripts@1.0.0 tokens
node --import tsx src/tokens/cli.ts check --markdown

📊 Token Limit Check Report

Checked: 648 files
Exceeded: 97 files

⚠️ Files Exceeding Token Limits

File	Tokens	Limit	Over By
.github/skills/analyze-skill-issues/SKILL.md	2109	500	+1609
.github/skills/analyze-test-run/SKILL.md	2471	500	+1971
.github/skills/file-test-bug/SKILL.md	628	500	+128
.github/skills/sensei/README.md	3531	2000	+1531
.github/skills/sensei/SKILL.md	3026	500	+2526
.github/skills/sensei/references/EXAMPLES.md	3701	2000	+1701
.github/skills/sensei/references/LOOP.md	4169	2000	+2169
.github/skills/sensei/references/SCORING.md	4299	2000	+2299
.github/skills/skill-authoring/SKILL.md	839	500	+339
plugin/skills/airunway-aks-setup/SKILL.md	1025	500	+525
plugin/skills/appinsights-instrumentation/SKILL.md	937	500	+437
plugin/skills/azure-ai/SKILL.md	820	500	+320
plugin/skills/azure-aigateway/SKILL.md	1261	500	+761
plugin/skills/azure-aigateway/references/policies.md	2342	2000	+342
plugin/skills/azure-cloud-migrate/SKILL.md	1085	500	+585
plugin/skills/azure-cloud-migrate/references/services/container-apps/cloudrun-deployment-guide.md	2029	2000	+29
plugin/skills/azure-cloud-migrate/references/services/container-apps/deployment-guide.md	2458	2000	+458
plugin/skills/azure-cloud-migrate/references/services/container-apps/fargate-deployment-guide.md	2587	2000	+587
plugin/skills/azure-cloud-migrate/references/services/container-apps/spring-deployment-guide.md	3871	2000	+1871
plugin/skills/azure-cloud-migrate/references/services/functions/lambda-to-functions.md	2600	2000	+600
plugin/skills/azure-cloud-migrate/references/services/functions/runtimes/javascript.md	2181	2000	+181
plugin/skills/azure-compliance/SKILL.md	1188	500	+688
plugin/skills/azure-compute/SKILL.md	1370	500	+870
plugin/skills/azure-compute/workflows/essential-machine-management/references/emm-enable-flow.md	2344	2000	+344
plugin/skills/azure-compute/workflows/vm-recommender/vm-recommender.md	2631	2000	+631
plugin/skills/azure-compute/workflows/vm-troubleshooter/vm-troubleshooter.md	2509	2000	+509
plugin/skills/azure-cost/SKILL.md	1980	500	+1480
plugin/skills/azure-deploy/SKILL.md	1645	500	+1145
plugin/skills/azure-deploy/references/pre-deploy-checklist.md	4692	2000	+2692
plugin/skills/azure-deploy/references/recipes/azd/errors.md	4004	2000	+2004
plugin/skills/azure-deploy/references/troubleshooting.md	2038	2000	+38
plugin/skills/azure-diagnostics/SKILL.md	1423	500	+923
plugin/skills/azure-enterprise-infra-planner/SKILL.md	1002	500	+502
plugin/skills/azure-enterprise-infra-planner/references/constraints/compute-apps.md	2022	2000	+22
plugin/skills/azure-hosted-copilot-sdk/SKILL.md	1332	500	+832
plugin/skills/azure-kubernetes/SKILL.md	2606	500	+2106
plugin/skills/azure-kubernetes/azure-kubernetes-automatic-readiness/SKILL.md	3609	500	+3109
plugin/skills/azure-kusto/SKILL.md	2152	500	+1652
plugin/skills/azure-messaging/SKILL.md	821	500	+321
plugin/skills/azure-prepare/SKILL.md	3375	500	+2875
plugin/skills/azure-prepare/references/aspire.md	4617	2000	+2617
plugin/skills/azure-prepare/references/plan-template.md	2617	2000	+617
plugin/skills/azure-prepare/references/recipes/azd/aspire.md	2275	2000	+275
plugin/skills/azure-prepare/references/recipes/azd/terraform.md	3555	2000	+1555
plugin/skills/azure-prepare/references/research.md	2274	2000	+274
plugin/skills/azure-prepare/references/resources-limits-quotas.md	3322	2000	+1322
plugin/skills/azure-prepare/references/security.md	2147	2000	+147
plugin/skills/azure-prepare/references/services/functions/bicep.md	3127	2000	+1127
plugin/skills/azure-prepare/references/services/functions/templates/recipes/composition.md	2813	2000	+813
plugin/skills/azure-prepare/references/services/functions/terraform.md	3404	2000	+1404
plugin/skills/azure-prepare/references/services/sql-database/bicep.md	2037	2000	+37
plugin/skills/azure-quotas/SKILL.md	2821	500	+2321
plugin/skills/azure-quotas/references/commands.md	2644	2000	+644
plugin/skills/azure-reliability/SKILL.md	5659	500	+5159
plugin/skills/azure-reliability/references/configure-multi-region.md	4729	2000	+2729
plugin/skills/azure-resource-lookup/SKILL.md	1394	500	+894
plugin/skills/azure-resource-visualizer/SKILL.md	2122	500	+1622
plugin/skills/azure-storage/SKILL.md	1228	500	+728
plugin/skills/azure-upgrade/SKILL.md	1542	500	+1042
plugin/skills/azure-upgrade/references/languages/java/INSTRUCTION.md	2724	2000	+724
plugin/skills/azure-upgrade/references/languages/java/package-specific/com.microsoft.azure.management.md	2215	2000	+215
plugin/skills/azure-upgrade/references/languages/java/templates/PLAN_TEMPLATE.md	2411	2000	+411
plugin/skills/azure-upgrade/references/languages/java/templates/PROGRESS_TEMPLATE.md	2315	2000	+315
plugin/skills/azure-upgrade/references/languages/java/templates/SUMMARY_TEMPLATE.md	2190	2000	+190
plugin/skills/azure-upgrade/references/services/functions/automation.md	3463	2000	+1463
plugin/skills/azure-upgrade/references/services/functions/consumption-to-flex.md	2773	2000	+773
plugin/skills/azure-validate/SKILL.md	950	500	+450
plugin/skills/entra-agent-id/SKILL.md	4001	500	+3501
plugin/skills/entra-app-registration/SKILL.md	2070	500	+1570
plugin/skills/entra-app-registration/references/api-permissions.md	2545	2000	+545
plugin/skills/entra-app-registration/references/cli-commands.md	2211	2000	+211
plugin/skills/entra-app-registration/references/console-app-example.md	2752	2000	+752
plugin/skills/entra-app-registration/references/oauth-flows.md	2375	2000	+375
plugin/skills/microsoft-foundry/SKILL.md	3955	500	+3455
plugin/skills/microsoft-foundry/foundry-agent/create/create-hosted.md	4824	2000	+2824
plugin/skills/microsoft-foundry/foundry-agent/deploy/deploy.md	6589	2000	+4589
plugin/skills/microsoft-foundry/foundry-agent/deploy/references/direct-code-deployment.md	4412	2000	+2412
plugin/skills/microsoft-foundry/foundry-agent/eval-datasets/eval-datasets.md	2494	2000	+494
plugin/skills/microsoft-foundry/foundry-agent/eval-datasets/references/generate-seed-dataset.md	2088	2000	+88
plugin/skills/microsoft-foundry/foundry-agent/eval-datasets/references/trace-to-dataset.md	4325	2000	+2325
plugin/skills/microsoft-foundry/foundry-agent/faos-optimize/faos-optimize.md	3436	2000	+1436
plugin/skills/microsoft-foundry/foundry-agent/invoke/invoke.md	2122	2000	+122
plugin/skills/microsoft-foundry/foundry-agent/observe/observe.md	3190	2000	+1190
plugin/skills/microsoft-foundry/foundry-agent/observe/references/continuous-eval.md	3860	2000	+1860
plugin/skills/microsoft-foundry/foundry-agent/observe/references/deploy-and-setup.md	2072	2000	+72
plugin/skills/microsoft-foundry/foundry-agent/trace/references/kql-templates.md	2701	2000	+701
plugin/skills/microsoft-foundry/foundry-agent/troubleshoot/references/direct-code-troubleshooting.md	2214	2000	+214
plugin/skills/microsoft-foundry/models/deploy-model/SKILL.md	1640	500	+1140
plugin/skills/microsoft-foundry/models/deploy-model/capacity/SKILL.md	1739	500	+1239
plugin/skills/microsoft-foundry/models/deploy-model/customize/SKILL.md	2235	500	+1735
plugin/skills/microsoft-foundry/models/deploy-model/customize/references/customize-workflow.md	3335	2000	+1335
plugin/skills/microsoft-foundry/models/deploy-model/preset/SKILL.md	1226	500	+726
plugin/skills/microsoft-foundry/models/deploy-model/preset/references/preset-workflow.md	5534	2000	+3534
plugin/skills/microsoft-foundry/quota/quota.md	2288	2000	+288
plugin/skills/microsoft-foundry/quota/references/capacity-planning.md	2080	2000	+80
plugin/skills/microsoft-foundry/references/agent-metadata-contract.md	2381	2000	+381
plugin/skills/microsoft-foundry/references/sdk/foundry-sdk-py.md	2162	2000	+162

Consider moving content to references/ subdirectories.

---

Automated token analysis. See skill authoring guidelines for best practices.

[Copilot]

Pull request overview

Adds Azure AI Foundry “direct code deployment” support to the microsoft-foundry/foundry-agent documentation and tests, introducing explicit routing/selection guidance and detailed REST-based deploy/invoke/troubleshoot references alongside the existing Docker/ACR flow.

Changes:

• Adds new direct-code deploy/invoke/troubleshoot reference docs and updates existing deploy/invoke/troubleshoot workflows to gate direct-code paths behind explicit user intent.
• Updates agent metadata contract wording to scope ACR usage specifically to the Docker/ACR deployment flow.
• Extends trigger tests and adds a new unit test suite to lock down direct-code documentation invariants.

Reviewed changes

Copilot reviewed 11 out of 11 changed files in this pull request and generated 1 comment.

Show a summary per file

File	Description
tests/microsoft-foundry/foundry-agent/troubleshoot/triggers.test.ts	Adds trigger prompts covering direct-code troubleshooting scenarios.
tests/microsoft-foundry/foundry-agent/invoke/triggers.test.ts	Adds trigger prompts covering direct-code invocation scenarios.
tests/microsoft-foundry/foundry-agent/direct-code.unit.test.ts	New unit tests to assert key direct-code documentation constraints and links.
tests/microsoft-foundry/foundry-agent/deploy/triggers.test.ts	Adds trigger prompts covering direct-code deployment scenarios.
plugin/skills/microsoft-foundry/references/agent-metadata-contract.md	Clarifies azureContainerRegistry applies to Docker/ACR deploy flow hosted agents.
plugin/skills/microsoft-foundry/foundry-agent/troubleshoot/troubleshoot.md	Adds explicit method-selection gating for direct-code troubleshooting.
plugin/skills/microsoft-foundry/foundry-agent/troubleshoot/references/direct-code-troubleshooting.md	New direct-code troubleshooting reference (REST/session/logstream/RBAC guidance).
plugin/skills/microsoft-foundry/foundry-agent/invoke/references/direct-code-invocation.md	New direct-code invocation reference (concrete version sessions + REST protocols).
plugin/skills/microsoft-foundry/foundry-agent/invoke/invoke.md	Adds explicit method-selection gating for direct-code invocation.
plugin/skills/microsoft-foundry/foundry-agent/deploy/references/direct-code-deployment.md	New direct-code deployment reference (REST upload/version polling/prewarm/invoke).
plugin/skills/microsoft-foundry/foundry-agent/deploy/deploy.md	Adds deployment method selection section and direct-code guidance entry points.