From 26eeb2c7f6146093fdc8631bccd69ff2d07ff4ec Mon Sep 17 00:00:00 2001 From: Esteban Chavez Date: Tue, 3 Nov 2026 11:55:57 -0800 Subject: [PATCH 1/3] Update public Vite template to CMR packages Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> --- README.md | 8 ++++---- templates/vite8/package.json | 4 ++-- templates/vite8/src/App.tsx | 2 +- templates/vite8/vite.config.ts | 2 +- 4 files changed, 8 insertions(+), 8 deletions(-) diff --git a/README.md b/README.md index f143265..f630a1d 100644 --- a/README.md +++ b/README.md @@ -5,13 +5,13 @@ Copilot Managed Runtime hosts Microsoft 365 line-of-business applications that automatically inherit organizational governance, security, and compliance controls from the moment they're created. -This repository hosts the official first-party project **templates** and is the home for **public issues**. The tooling itself ships as npm packages under the `@microsoft/managed-apps` scope: +This repository hosts the official first-party project **templates** and is the home for **public issues**. The tooling itself ships as npm packages under the `@microsoft` scope: | Package | Description | | --- | --- | -| [`@microsoft/managed-apps`](https://www.npmjs.com/package/@microsoft/managed-apps) | SDK for building apps hosted on Copilot Managed Runtime | -| [`@microsoft/managed-apps-cli`](https://www.npmjs.com/package/@microsoft/managed-apps-cli) | Command-line interface for building and managing apps hosted on Copilot Managed Runtime | -| [`@microsoft/managed-apps-vite-plugin`](https://www.npmjs.com/package/@microsoft/managed-apps-vite-plugin) | Vite plugin for apps hosted on Copilot Managed Runtime | +| [`@microsoft/cmr-apps`](https://www.npmjs.com/package/@microsoft/cmr-apps) | SDK for building apps hosted on Copilot Managed Runtime | +| [`@microsoft/cmr-cli`](https://www.npmjs.com/package/@microsoft/cmr-cli) | Command-line interface for building and managing apps hosted on Copilot Managed Runtime | +| [`@microsoft/cmr-apps-vite-plugin`](https://www.npmjs.com/package/@microsoft/cmr-apps-vite-plugin) | Vite plugin for apps hosted on Copilot Managed Runtime | ## Getting started diff --git a/templates/vite8/package.json b/templates/vite8/package.json index dea730b..73f308b 100644 --- a/templates/vite8/package.json +++ b/templates/vite8/package.json @@ -10,13 +10,13 @@ "preview": "vite preview" }, "dependencies": { - "@microsoft/managed-apps": "^0.6.3", + "@microsoft/cmr-apps": "^0.6.3", "react": "^19.2.6", "react-dom": "^19.2.6" }, "devDependencies": { "@eslint/js": "^10.0.1", - "@microsoft/managed-apps-vite-plugin": "^0.4.8", + "@microsoft/cmr-apps-vite-plugin": "^0.4.8", "@types/node": "^24.12.3", "@types/react": "^19.2.14", "@types/react-dom": "^19.2.3", diff --git a/templates/vite8/src/App.tsx b/templates/vite8/src/App.tsx index f92487c..8704843 100644 --- a/templates/vite8/src/App.tsx +++ b/templates/vite8/src/App.tsx @@ -93,7 +93,7 @@ function App() {
  • Date: Tue, 3 Nov 2026 18:04:31 -0800 Subject: [PATCH 2/3] Update public repository wording to Copilot Managed Runtime Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> --- .claude-plugin/marketplace.json | 6 +++--- .github/ISSUE_TEMPLATE/bug_report.md | 2 +- SUPPORT.md | 6 +++--- github-actions/AGENTS.md | 4 ++-- github-actions/CHANGELOG.md | 4 ++-- github-actions/README.md | 6 +++--- github-actions/agent-skills/architecture.md | 8 ++++---- github-actions/install-ms-cli/action.yml | 4 ++-- github-actions/ms-app-deploy/action.yml | 8 ++++---- github-actions/ms-app-pack/action.yml | 6 +++--- github-actions/package.json | 2 +- github-actions/src/actions/install-ms-cli/index.ts | 2 +- github-actions/src/actions/ms-app-deploy/index.ts | 2 +- github-actions/src/actions/ms-app-pack/index.ts | 2 +- .../.claude-plugin/plugin.json | 4 ++-- plugins/microsoft-managed-apps/AGENTS.md | 6 +++--- plugins/microsoft-managed-apps/QUICKSTART.md | 4 ++-- plugins/microsoft-managed-apps/README.md | 8 ++++---- .../agents/microsoft-apps-architect.md | 12 ++++++------ .../agents/microsoft-apps-architect.agent.md | 12 ++++++------ .../microsoft-managed-apps/hooks/session-start.sh | 2 +- plugins/microsoft-managed-apps/plugin.json | 4 ++-- .../microsoft-managed-apps/shared/allowed-actions.md | 4 ++-- .../shared/connector-decision-guide.md | 2 +- .../shared/development-standards.md | 4 ++-- .../shared/shared-instructions.md | 6 +++--- .../skills/add-data-source/SKILL.md | 2 +- .../skills/add-office365-users/SKILL.md | 2 +- .../skills/create-app/SKILL.md | 2 +- .../create-app/references/prerequisites-reference.md | 2 +- .../microsoft-managed-apps/skills/list-apps/SKILL.md | 2 +- plugins/microsoft-managed-apps/skills/state/SKILL.md | 4 ++-- scripts/plugin-hooks.test.mjs | 2 +- templates/vite8/src/App.tsx | 6 +++--- 34 files changed, 76 insertions(+), 76 deletions(-) diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json index 105a81b..7d63cd3 100644 --- a/.claude-plugin/marketplace.json +++ b/.claude-plugin/marketplace.json @@ -1,7 +1,7 @@ { "name": "Managed-Apps", "metadata": { - "description": "Microsoft Managed Apps plugin marketplace β€” wraps the @microsoft/managed-apps-cli (ms) toolchain for coding agents (GitHub Copilot CLI, Claude Code).", + "description": "Copilot Managed Runtime plugin marketplace β€” wraps the @microsoft/managed-apps-cli (ms) toolchain for coding agents (GitHub Copilot CLI, Claude Code).", "version": "0.1.0" }, "owner": { @@ -12,8 +12,8 @@ { "name": "microsoft-managed-apps", "source": "./plugins/microsoft-managed-apps", - "description": "[Preview] Create and manage Microsoft Managed Apps using the @microsoft/managed-apps-cli (ms) toolchain.", - "version": "2.1.7" + "description": "[Preview] Create and manage apps on Copilot Managed Runtime using the @microsoft/managed-apps-cli (ms) toolchain.", + "version": "2.1.8" } ] } diff --git a/.github/ISSUE_TEMPLATE/bug_report.md b/.github/ISSUE_TEMPLATE/bug_report.md index ff30f19..8d0f084 100644 --- a/.github/ISSUE_TEMPLATE/bug_report.md +++ b/.github/ISSUE_TEMPLATE/bug_report.md @@ -1,6 +1,6 @@ --- name: "🐞 Bug Report" -about: "Report a bug with Microsoft Managed Apps" +about: "Report a bug with Copilot Managed Runtime" title: "[Bug] " labels: bug --- diff --git a/SUPPORT.md b/SUPPORT.md index 1efe5a6..7299af6 100644 --- a/SUPPORT.md +++ b/SUPPORT.md @@ -2,13 +2,13 @@ ## How to file issues and get help -Microsoft Managed Apps uses GitHub Issues to track bugs. Please search the existing issues before +Copilot Managed Runtime uses GitHub Issues to track bugs. Please search the existing issues before filing new issues to avoid duplicates. For new issues, file your bug as a new Issue in this repository. -For how-to questions and product guidance, see the [Microsoft Managed Apps documentation](https://go.microsoft.com/fwlink/?LinkId=2369054). +For how-to questions and product guidance, see the [Copilot Managed Runtime documentation](https://go.microsoft.com/fwlink/?LinkId=2369054). ## Microsoft Support Policy -Microsoft Managed Apps is currently in **public preview**. Support is limited to the resources +Copilot Managed Runtime is currently in **public preview**. Support is limited to the resources listed above. diff --git a/github-actions/AGENTS.md b/github-actions/AGENTS.md index 11a6286..a837cfa 100644 --- a/github-actions/AGENTS.md +++ b/github-actions/AGENTS.md @@ -1,8 +1,8 @@ # Agent guide β€” github-actions This directory holds the **`install-ms-cli`**, **`ms-app-pack`**, and -**`ms-app-deploy`** GitHub Actions for building and deploying Microsoft Managed -Apps from CI. +**`ms-app-deploy`** GitHub Actions for building and deploying apps on Copilot Managed Runtime +from CI. If you're an agent (GitHub Copilot CLI, Claude Code, or any other) helping with this component, the reusable skills below are plain Markdown runbooks β€” read the diff --git a/github-actions/CHANGELOG.md b/github-actions/CHANGELOG.md index bbf3b20..ac3d223 100644 --- a/github-actions/CHANGELOG.md +++ b/github-actions/CHANGELOG.md @@ -1,6 +1,6 @@ # Changelog -All notable changes to the Managed Apps GitHub Actions (under `github-actions/`) +All notable changes to the Copilot Managed Runtime GitHub Actions (under `github-actions/`) are documented here. This project follows [Semantic Versioning](https://semver.org) and the format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/). @@ -12,7 +12,7 @@ the new version **in the same PR that bumps the version**, before it merges to ## [1.0.1] - 2026-06-22 -Initial release of the Managed Apps GitHub Actions. +Initial release of the Copilot Managed Runtime GitHub Actions. ### Added - `install-ms-cli` β€” installs `@microsoft/managed-apps-cli` (binary: `ms`) on the diff --git a/github-actions/README.md b/github-actions/README.md index 884d0d2..0803f59 100644 --- a/github-actions/README.md +++ b/github-actions/README.md @@ -1,6 +1,6 @@ -# Managed Apps GitHub Actions +# Copilot Managed Runtime GitHub Actions -GitHub Actions for building and deploying [Microsoft Managed Apps](https://www.npmjs.com/package/@microsoft/managed-apps-cli) from CI. +GitHub Actions for building and deploying apps on [Copilot Managed Runtime](https://www.npmjs.com/package/@microsoft/managed-apps-cli) from CI. ## Actions @@ -53,7 +53,7 @@ See each action's `action.yml` for the full input/output reference. Step-by-step guides any operator β€” or coding-agent CLI (GitHub Copilot CLI, Claude Code, etc.) β€” can follow. See [`AGENTS.md`](AGENTS.md) for the index. -- [Architecture & Flow](agent-skills/architecture.md) β€” the end-to-end managed apps lifecycle (setup, local dev, CI loops), the `ms-app-deploy` sequence with service rejection points, and the release/versioning flow, with diagrams. +- [Architecture & Flow](agent-skills/architecture.md) β€” the end-to-end Copilot Managed Runtime lifecycle (setup, local dev, CI loops), the `ms-app-deploy` sequence with service rejection points, and the release/versioning flow, with diagrams. - [Release guide](agent-skills/release-guide.md) β€” how to cut a release PR (version bump + changelog + dist rebuild). ## Prerequisites diff --git a/github-actions/agent-skills/architecture.md b/github-actions/agent-skills/architecture.md index 3fe34da..3a247e9 100644 --- a/github-actions/agent-skills/architecture.md +++ b/github-actions/agent-skills/architecture.md @@ -1,6 +1,6 @@ -# Managed Apps GitHub Actions β€” Architecture & Flow +# Copilot Managed Runtime GitHub Actions β€” Architecture & Flow -How the actions under `github-actions/` fit into the end-to-end managed apps lifecycle: +How the actions under `github-actions/` fit into the end-to-end Copilot Managed Runtime lifecycle: one-time app setup, the local dev loop, the CI/CD deploy loop, and how this repo releases the actions themselves. Diagrams are Mermaid (render on GitHub). @@ -63,7 +63,7 @@ sequenceDiagram participant WF as Workflow participant ACT as ms-app-deploy participant CLI as ms CLI - participant RP as Managed Apps service + participant RP as Copilot Managed Runtime service WF->>ACT: with working-directory, app-id, client-secret, tenant-id ACT->>ACT: require MS_MANAGED_APPS_INSTALLED == true @@ -127,7 +127,7 @@ flowchart LR - **Auth:** interactive sign-in (`ms auth login`) works for local dev. For CI, supply all three Service Principal inputs (`app-id`, `client-secret`, `tenant-id`) β€” the actions set `MS_CLI_USE_SP_AUTH` + `MS_CLI_SP_*`, and the service - accepts the SPN for managed apps operations, so the deploy runs with no developer in + accepts the SPN for Copilot Managed Runtime operations, so the deploy runs with no developer in the loop. - **Sharing:** for `repoType: none` apps (no platform-managed repo), `ms app share --access edit` grants contributor access at the **app scope** diff --git a/github-actions/install-ms-cli/action.yml b/github-actions/install-ms-cli/action.yml index fabe0df..ac2ae1b 100644 --- a/github-actions/install-ms-cli/action.yml +++ b/github-actions/install-ms-cli/action.yml @@ -3,7 +3,7 @@ # # install-ms-cli/action.yml # -# Installs the managed apps `ms` CLI (@microsoft/managed-apps-cli) on the GitHub Actions runner. +# Installs the Copilot Managed Runtime `ms` CLI (@microsoft/managed-apps-cli) on the GitHub Actions runner. # # Defaults to the public npm registry β€” @microsoft/managed-apps-cli is published there # (since 2026-05-14). No inputs are required for standard usage: @@ -20,7 +20,7 @@ # registry-auth-token: ${{ secrets.AZURE_DEVOPS_PAT }} # name: 'install-ms-cli' -description: 'Install the Microsoft managed apps CLI (@microsoft/managed-apps-cli, binary: ms)' +description: 'Install the Copilot Managed Runtime CLI (@microsoft/managed-apps-cli, binary: ms)' inputs: version: diff --git a/github-actions/ms-app-deploy/action.yml b/github-actions/ms-app-deploy/action.yml index b1ef2c0..9b5fa5f 100644 --- a/github-actions/ms-app-deploy/action.yml +++ b/github-actions/ms-app-deploy/action.yml @@ -3,7 +3,7 @@ # # ms-app-deploy/action.yml # -# Deploys a Microsoft managed apps code app via `ms app deploy`. Three deploy modes are +# Deploys a Copilot Managed Runtime code app via `ms app deploy`. Three deploy modes are # supported, selected based on inputs and the app's repoType from # ms.config.json: # @@ -35,7 +35,7 @@ # Service Principal auth: # The auth inputs (`app-id`, `client-secret`, `tenant-id`) are wired to the # CLI's SPN env vars (MS_CLI_SP_* + MS_CLI_USE_SP_AUTH). The service -# accepts Service Principal identities for managed apps operations. Provide all three +# accepts Service Principal identities for Copilot Managed Runtime operations. Provide all three # inputs together to deploy as the SPN with no developer in the loop. # --------------------------------------------------------------------------- # @@ -74,7 +74,7 @@ # tenant-id: ${{ secrets.PP_SP_TENANT_ID }} # name: 'ms-app-deploy' -description: 'Deploy a Microsoft managed apps code app for the given commit' +description: 'Deploy a Copilot Managed Runtime code app for the given commit' inputs: # ── App context ─────────────────────────────────────────────────────────── @@ -98,7 +98,7 @@ inputs: cloud: description: > Cloud instance to target. One of: prod, test, preview, - gccmoderate, dev. The managed apps end-to-end flow is currently supported only + gccmoderate, dev. The Copilot Managed Runtime end-to-end flow is currently supported only in 'test'. Maps to MS_CLI_CLOUD_INSTANCE. required: false default: 'test' diff --git a/github-actions/ms-app-pack/action.yml b/github-actions/ms-app-pack/action.yml index 3eec30d..6a5968f 100644 --- a/github-actions/ms-app-pack/action.yml +++ b/github-actions/ms-app-pack/action.yml @@ -3,14 +3,14 @@ # # ms-app-pack/action.yml # -# Packs a Microsoft managed apps code app into a deployable artifact by invoking `ms app pack`. +# Packs a Copilot Managed Runtime code app into a deployable artifact by invoking `ms app pack`. # Pack runs the `buildCommand` from ms.config.json (default `npm run build`) # and copies the build output to the canonical packed layout at # /.ms/packed/apps//client/ # # After pack, `ms-app-deploy` picks up the artifact automatically. # -# This action is a transitional step. The managed apps CLI is adding a `--artifact` +# This action is a transitional step. The Copilot Managed Runtime CLI is adding a `--artifact` # flag to `ms app deploy` that will fold pack into deploy for repoType:'none' # apps. Once that ships, you can drop the `- uses: ms-app-pack` step from # your workflow. @@ -43,7 +43,7 @@ # tenant-id: ${{ secrets.PP_SP_TENANT_ID }} # name: 'ms-app-pack' -description: 'Build and pack a Microsoft managed apps code app into a deployable artifact' +description: 'Build and pack a Copilot Managed Runtime code app into a deployable artifact' inputs: working-directory: diff --git a/github-actions/package.json b/github-actions/package.json index d6ba915..ab05d3e 100644 --- a/github-actions/package.json +++ b/github-actions/package.json @@ -2,7 +2,7 @@ "name": "@microsoft/managed-apps-github-actions", "version": "1.0.1", "private": true, - "description": "GitHub Actions for building and deploying Microsoft Managed Apps from CI", + "description": "GitHub Actions for building and deploying apps on Copilot Managed Runtime from CI", "main": "index.js", "scripts": { "clean": "node node_modules/gulp/bin/gulp.js clean", diff --git a/github-actions/src/actions/install-ms-cli/index.ts b/github-actions/src/actions/install-ms-cli/index.ts index d994f35..bbd5d0f 100644 --- a/github-actions/src/actions/install-ms-cli/index.ts +++ b/github-actions/src/actions/install-ms-cli/index.ts @@ -3,7 +3,7 @@ // src/actions/install-ms-cli/index.ts // -// Installs the managed apps `ms` CLI (@microsoft/managed-apps-cli) on the GitHub Actions runner +// Installs the Copilot Managed Runtime `ms` CLI (@microsoft/managed-apps-cli) on the GitHub Actions runner // via npm. The package's `bin` field maps to the `ms` executable. import * as core from '@actions/core'; diff --git a/github-actions/src/actions/ms-app-deploy/index.ts b/github-actions/src/actions/ms-app-deploy/index.ts index 1594c13..5d38ecc 100644 --- a/github-actions/src/actions/ms-app-deploy/index.ts +++ b/github-actions/src/actions/ms-app-deploy/index.ts @@ -3,7 +3,7 @@ // src/actions/ms-app-deploy/index.ts // -// Deploys a Microsoft managed apps code app via `ms app deploy`. Three modes: +// Deploys a Copilot Managed Runtime code app via `ms app deploy`. Three modes: // // 1. repoType:'none' + artifact-path supplied β†’ --artifact // Uploads a pre-built zip and deploys it. diff --git a/github-actions/src/actions/ms-app-pack/index.ts b/github-actions/src/actions/ms-app-pack/index.ts index dc51ce6..b75534f 100644 --- a/github-actions/src/actions/ms-app-pack/index.ts +++ b/github-actions/src/actions/ms-app-pack/index.ts @@ -3,7 +3,7 @@ // src/actions/ms-app-pack/index.ts // -// Packs a Microsoft managed apps code app via `ms app pack`. Pack runs the `buildCommand` from +// Packs a Copilot Managed Runtime code app via `ms app pack`. Pack runs the `buildCommand` from // ms.config.json (default: `npm run build`) and copies the result into the // canonical packed layout `/.ms/packed/apps//client/`. // diff --git a/plugins/microsoft-managed-apps/.claude-plugin/plugin.json b/plugins/microsoft-managed-apps/.claude-plugin/plugin.json index a78891d..5c5848f 100644 --- a/plugins/microsoft-managed-apps/.claude-plugin/plugin.json +++ b/plugins/microsoft-managed-apps/.claude-plugin/plugin.json @@ -1,7 +1,7 @@ { "name": "microsoft-managed-apps", - "version": "2.1.7", - "description": "[Preview] Create and manage Microsoft Managed Apps using the @microsoft/managed-apps-cli (ms) toolchain.", + "version": "2.1.8", + "description": "[Preview] Create and manage apps on Copilot Managed Runtime using the @microsoft/managed-apps-cli (ms) toolchain.", "author": { "name": "Microsoft", "url": "https://github.com/microsoft/Managed-Apps" diff --git a/plugins/microsoft-managed-apps/AGENTS.md b/plugins/microsoft-managed-apps/AGENTS.md index 03bf68c..8c029e2 100644 --- a/plugins/microsoft-managed-apps/AGENTS.md +++ b/plugins/microsoft-managed-apps/AGENTS.md @@ -1,10 +1,10 @@ -# Microsoft Managed Apps Plugin β€” Development Guidelines +# Copilot Managed Runtime Plugin β€” Development Guidelines -This file provides instructions for assistants working on the managed apps plugin itself (not for end-users of the plugin). +This file provides instructions for assistants working on the Copilot Managed Runtime plugin itself (not for end-users of the plugin). ## Overview -The managed apps plugin wraps `@microsoft/managed-apps-cli` (binary `ms`) to scaffold, develop, and ship managed apps end-to-end. It provides skills for: +The Copilot Managed Runtime plugin wraps `@microsoft/managed-apps-cli` (binary `ms`) to scaffold, develop, and ship apps on Copilot Managed Runtime end-to-end. It provides skills for: - Creating a new app (`/create-app`) β€” global install of the CLI, scaffold, local dev loop. - Iterating locally (`/dev`) β€” `ms app dev`, hot reload against the App Player. diff --git a/plugins/microsoft-managed-apps/QUICKSTART.md b/plugins/microsoft-managed-apps/QUICKSTART.md index 459c89a..a87ac6d 100644 --- a/plugins/microsoft-managed-apps/QUICKSTART.md +++ b/plugins/microsoft-managed-apps/QUICKSTART.md @@ -1,6 +1,6 @@ # Quick Start Guide -Build and run a Microsoft App using just your coding copilot. No prior managed apps knowledge needed. +Build and run a Microsoft App using just your coding copilot. No prior Copilot Managed Runtime knowledge needed. --- @@ -15,7 +15,7 @@ node --version # should print v22.x.x or higher ``` **Git** -Managed apps store app code in a remote git repository, and `ms app create` initializes the local repo. Install from [git-scm.com](https://git-scm.com). Git for Windows includes Git Credential Manager, which the first `ms app create` will exercise. +Apps on Copilot Managed Runtime store app code in a remote git repository, and `ms app create` initializes the local repo. Install from [git-scm.com](https://git-scm.com). Git for Windows includes Git Credential Manager, which the first `ms app create` will exercise. That's it for now β€” `/create-app` installs the `ms` CLI itself globally on its first run. diff --git a/plugins/microsoft-managed-apps/README.md b/plugins/microsoft-managed-apps/README.md index 4d0e959..7b95e3c 100644 --- a/plugins/microsoft-managed-apps/README.md +++ b/plugins/microsoft-managed-apps/README.md @@ -1,10 +1,10 @@ -# Microsoft Managed Apps Plugin `Preview` +# Copilot Managed Runtime Plugin `Preview` > **Preview** β€” this plugin is in preview and under active development. Behavior may change. -Copilot plugin for building **managed apps** using `@microsoft/managed-apps-cli` (binary `ms`), React, and Vite. Works with both Claude Code and GitHub Copilot. +Copilot plugin for building apps on **Copilot Managed Runtime** using `@microsoft/managed-apps-cli` (binary `ms`), React, and Vite. Works with both Claude Code and GitHub Copilot. -Managed apps run locally against the App Player with hot reload (`ms app dev`) and deploy to the cloud only when you choose to. +Apps on Copilot Managed Runtime run locally against the App Player with hot reload (`ms app dev`) and deploy to the cloud only when you choose to. ## What's Included @@ -34,7 +34,7 @@ as the rest of the app, not a separate Rayfin workflow. - [Node.js v22+](https://nodejs.org/) - Git + Git Credential Manager - [Claude Code](https://code.claude.com/docs/en/getting-started) or [GitHub Copilot CLI](https://github.com/features/copilot/cli/) -- Access to a managed apps-enabled tenant. The `@microsoft/managed-apps-cli` package is published on the public npm registry: [`@microsoft/managed-apps-cli`](https://www.npmjs.com/package/@microsoft/managed-apps-cli). +- Access to a Copilot Managed Runtime-enabled tenant. The `@microsoft/managed-apps-cli` package is published on the public npm registry: [`@microsoft/managed-apps-cli`](https://www.npmjs.com/package/@microsoft/managed-apps-cli). The `/create-app` skill handles the global install of `@microsoft/managed-apps-cli@latest` on its own β€” you don't need to set that up by hand. diff --git a/plugins/microsoft-managed-apps/agents/microsoft-apps-architect.md b/plugins/microsoft-managed-apps/agents/microsoft-apps-architect.md index 5a574d5..a2467fa 100644 --- a/plugins/microsoft-managed-apps/agents/microsoft-apps-architect.md +++ b/plugins/microsoft-managed-apps/agents/microsoft-apps-architect.md @@ -1,13 +1,13 @@ --- name: microsoft-apps-architect -description: Managed apps Architect specializing in React/Vite architecture, the @microsoft/managed-apps-cli (ms) toolchain, connector and data-source patterns, and local-dev-first iteration. Use when making architecture decisions, designing data models, selecting connectors, or troubleshooting `ms app create` / `ms app dev` / build issues. +description: Copilot Managed Runtime Architect specializing in React/Vite architecture, the @microsoft/managed-apps-cli (ms) toolchain, connector and data-source patterns, and local-dev-first iteration. Use when making architecture decisions, designing data models, selecting connectors, or troubleshooting `ms app create` / `ms app dev` / build issues. --- **πŸ“‹ Shared Instructions: [shared-instructions.md](../shared/shared-instructions.md)** - Cross-cutting concerns (CLI install, env vars, planning, memory bank, execution style). -# Managed apps Architect +# Copilot Managed Runtime Architect -You are a managed apps Architect with deep expertise in building web apps on the managed apps platform. Your toolchain is `@microsoft/managed-apps-cli` (binary `ms`). +You are a Copilot Managed Runtime Architect with deep expertise in building web apps on the Copilot Managed Runtime platform. Your toolchain is `@microsoft/managed-apps-cli` (binary `ms`). ## Execution Guardrails @@ -18,7 +18,7 @@ You are a managed apps Architect with deep expertise in building web apps on the ## Your Expertise - **React + Vite**: Component architecture, state management, TypeScript strict mode. -- **Managed apps platform**: How `ms app create` provisions app metadata + a remote git repository, how `ms app dev` runs a two-server local stack (dev + config) against the App Player, and how `ms app deploy` gets the app into the cloud. +- **Copilot Managed Runtime platform**: How `ms app create` provisions app metadata + a remote git repository, how `ms app dev` runs a two-server local stack (dev + config) against the App Player, and how `ms app deploy` gets the app into the cloud. - **Connector patterns**: Understanding all available connectors (Office 365 Outlook, Office 365 Users, Teams, SharePoint, OneDrive, Excel, Azure DevOps, Dataverse) and intelligently selecting them based on app requirements using the Connector Decision Guide. - **Connector Decision Guide** ([shared/connector-decision-guide.md](../shared/connector-decision-guide.md)): You must reference this guide when recommending connectors. Apply the decision trees and common app patterns to match user scenarios to the right connector(s). - **Shared connection policies** ([shared/allowed-actions.md](../shared/allowed-actions.md)): When a connection reference is shared (`sharedConnectionId` set in `ms.config.json`), the app must declare `allowedActions` or the deploy fails validation. Raise this while recommending a connector, not after β€” it shapes what the app is permitted to do at runtime. @@ -46,7 +46,7 @@ ms --version # Bin name has flipped between dev builds - **Missing `ms`**: Direct the user to `/create-app`, which installs `@microsoft/managed-apps-cli@latest` globally from the public npm registry. Never instruct them to `npm install --save-dev` per-workspace β€” install globally so the `ms` binary is on PATH and the workspace stays clean. - **All present**: Report versions and proceed. -## Key Considerations for managed apps +## Key Considerations for Copilot Managed Runtime ### App backend database @@ -61,7 +61,7 @@ When the gate passes and the user explicitly requests an app backend database ### Connector-First Principle -**For external integrations, use Power Platform connectors rather than raw HTTP calls.** Managed apps run in the App Player sandbox, which blocks arbitrary outbound HTTP. +**For external integrations, use Power Platform connectors rather than raw HTTP calls.** Apps on Copilot Managed Runtime run in the App Player sandbox, which blocks arbitrary outbound HTTP. **When recommending connectors, always:** 1. Start with the user's app goal (not available connectors) diff --git a/plugins/microsoft-managed-apps/com.github.copilot/agents/microsoft-apps-architect.agent.md b/plugins/microsoft-managed-apps/com.github.copilot/agents/microsoft-apps-architect.agent.md index b0881fd..9e96bc7 100644 --- a/plugins/microsoft-managed-apps/com.github.copilot/agents/microsoft-apps-architect.agent.md +++ b/plugins/microsoft-managed-apps/com.github.copilot/agents/microsoft-apps-architect.agent.md @@ -1,13 +1,13 @@ --- name: microsoft-apps-architect -description: Managed apps Architect specializing in React/Vite architecture, the @microsoft/managed-apps-cli (ms) toolchain, connector and data-source patterns, and local-dev-first iteration. Use when making architecture decisions, designing data models, selecting connectors, or troubleshooting `ms app create` / `ms app dev` / build issues. +description: Copilot Managed Runtime Architect specializing in React/Vite architecture, the @microsoft/managed-apps-cli (ms) toolchain, connector and data-source patterns, and local-dev-first iteration. Use when making architecture decisions, designing data models, selecting connectors, or troubleshooting `ms app create` / `ms app dev` / build issues. --- **πŸ“‹ Shared Instructions: [shared-instructions.md](../../shared/shared-instructions.md)** - Cross-cutting concerns (CLI install, env vars, planning, memory bank, execution style). -# Managed apps Architect +# Copilot Managed Runtime Architect -You are a managed apps Architect with deep expertise in building web apps on the managed apps platform. Your toolchain is `@microsoft/managed-apps-cli` (binary `ms`). +You are a Copilot Managed Runtime Architect with deep expertise in building web apps on the Copilot Managed Runtime platform. Your toolchain is `@microsoft/managed-apps-cli` (binary `ms`). ## Execution Guardrails @@ -18,7 +18,7 @@ You are a managed apps Architect with deep expertise in building web apps on the ## Your Expertise - **React + Vite**: Component architecture, state management, TypeScript strict mode. -- **Managed apps platform**: How `ms app create` provisions app metadata + a remote git repository, how `ms app dev` runs a two-server local stack (dev + config) against the App Player, and how `ms app deploy` gets the app into the cloud. +- **Copilot Managed Runtime platform**: How `ms app create` provisions app metadata + a remote git repository, how `ms app dev` runs a two-server local stack (dev + config) against the App Player, and how `ms app deploy` gets the app into the cloud. - **Connector patterns**: Understanding all available connectors (Office 365 Outlook, Office 365 Users, Teams, SharePoint, OneDrive, Excel, Azure DevOps, Dataverse) and intelligently selecting them based on app requirements using the Connector Decision Guide. - **Connector Decision Guide** ([shared/connector-decision-guide.md](../../shared/connector-decision-guide.md)): You must reference this guide when recommending connectors. Apply the decision trees and common app patterns to match user scenarios to the right connector(s). - **Shared connection policies** ([shared/allowed-actions.md](../../shared/allowed-actions.md)): When a connection reference is shared (`sharedConnectionId` set in `ms.config.json`), the app must declare `allowedActions` or the deploy fails validation. Raise this while recommending a connector, not after β€” it shapes what the app is permitted to do at runtime. @@ -46,7 +46,7 @@ ms --version # Bin name has flipped between dev builds - **Missing `ms`**: Direct the user to `/create-app`, which installs `@microsoft/managed-apps-cli@latest` globally from the public npm registry. Never instruct them to `npm install --save-dev` per-workspace β€” install globally so the `ms` binary is on PATH and the workspace stays clean. - **All present**: Report versions and proceed. -## Key Considerations for managed apps +## Key Considerations for Copilot Managed Runtime ### App backend database @@ -61,7 +61,7 @@ When the gate passes and the user explicitly requests an app backend database ### Connector-First Principle -**For external integrations, use Power Platform connectors rather than raw HTTP calls.** Managed apps run in the App Player sandbox, which blocks arbitrary outbound HTTP. +**For external integrations, use Power Platform connectors rather than raw HTTP calls.** Apps on Copilot Managed Runtime run in the App Player sandbox, which blocks arbitrary outbound HTTP. **When recommending connectors, always:** 1. Start with the user's app goal (not available connectors) diff --git a/plugins/microsoft-managed-apps/hooks/session-start.sh b/plugins/microsoft-managed-apps/hooks/session-start.sh index b32c7df..126f9d5 100644 --- a/plugins/microsoft-managed-apps/hooks/session-start.sh +++ b/plugins/microsoft-managed-apps/hooks/session-start.sh @@ -1,5 +1,5 @@ #!/usr/bin/env bash -# SessionStart hook: inform the agent that the Microsoft Managed Apps plugin +# SessionStart hook: inform the agent that the Copilot Managed Runtime plugin # automatically attributes every `ms` CLI invocation via MS_CLI_ORIGIN. # The PreToolUse hook (pre-tool-use.sh) enforces this transparently β€” this # message just makes the behavior visible to the agent so it isn't surprised diff --git a/plugins/microsoft-managed-apps/plugin.json b/plugins/microsoft-managed-apps/plugin.json index 0053bb7..f0ab745 100644 --- a/plugins/microsoft-managed-apps/plugin.json +++ b/plugins/microsoft-managed-apps/plugin.json @@ -1,8 +1,8 @@ { "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json", "name": "microsoft-managed-apps", - "version": "2.1.7", - "description": "[Preview] Create and manage Microsoft Managed Apps using the @microsoft/managed-apps-cli (ms) toolchain.", + "version": "2.1.8", + "description": "[Preview] Create and manage apps on Copilot Managed Runtime using the @microsoft/managed-apps-cli (ms) toolchain.", "author": { "name": "Microsoft", "url": "https://github.com/microsoft/Managed-Apps" diff --git a/plugins/microsoft-managed-apps/shared/allowed-actions.md b/plugins/microsoft-managed-apps/shared/allowed-actions.md index 3636040..32b8537 100644 --- a/plugins/microsoft-managed-apps/shared/allowed-actions.md +++ b/plugins/microsoft-managed-apps/shared/allowed-actions.md @@ -36,8 +36,8 @@ ms.config.json ──► RP at deploy time ──► executionRestrictions p policy and allows or refuses it ``` -Enforcement lives in the **Connectors infrastructure**, not in the app and not in the managed -apps host. APIHub runs every connector request through the runtime policy and refuses anything +Enforcement lives in the **Connectors infrastructure**, not in the app and not in the Copilot +Managed Runtime host. APIHub runs every connector request through the runtime policy and refuses anything the policy doesn't permit. The host's part is only addressing: it rewrites the outgoing connector URL to point at the policy rather than the connection, and stamps an `x-ms-shared-connection-id` header. diff --git a/plugins/microsoft-managed-apps/shared/connector-decision-guide.md b/plugins/microsoft-managed-apps/shared/connector-decision-guide.md index ec512dd..a24ce9f 100644 --- a/plugins/microsoft-managed-apps/shared/connector-decision-guide.md +++ b/plugins/microsoft-managed-apps/shared/connector-decision-guide.md @@ -293,7 +293,7 @@ This skill handles ANY connector, including those not listed in this guide. When **This guide covers the most common cases, but `/add-data-source` works with any Microsoft connector β€” not just the commonly listed connectors above.** -### **For managed apps Architect Agent** +### **For Copilot Managed Runtime Architect Agent** When recommending connectors for an app design: 1. Always start with the user's end goal (not available connectors) diff --git a/plugins/microsoft-managed-apps/shared/development-standards.md b/plugins/microsoft-managed-apps/shared/development-standards.md index 2f58434..a6c1260 100644 --- a/plugins/microsoft-managed-apps/shared/development-standards.md +++ b/plugins/microsoft-managed-apps/shared/development-standards.md @@ -1,6 +1,6 @@ # Development Standards -Standards that apply to all managed apps skills. +Standards that apply to all Copilot Managed Runtime skills. ## Theme @@ -42,7 +42,7 @@ The upgrade prompt satisfies the global-install confirmation requirement; do not ## Build & Deploy -- **Default loop is `ms app dev`**, not deploy. Managed apps run locally against the App Player with hot reload; deploy only when the user asks. +- **Default loop is `ms app dev`**, not deploy. Apps on Copilot Managed Runtime run locally against the App Player with hot reload; deploy only when the user asks. - When the user does want to ship: - Local-built (primary): `npm run build`, then `git add -A && git commit && git push`, then `ms app deploy`. - Cloud-built: `git add -A && git commit && git push`, then `ms app deploy [--commit ]`. diff --git a/plugins/microsoft-managed-apps/shared/shared-instructions.md b/plugins/microsoft-managed-apps/shared/shared-instructions.md index e87de35..a51724f 100644 --- a/plugins/microsoft-managed-apps/shared/shared-instructions.md +++ b/plugins/microsoft-managed-apps/shared/shared-instructions.md @@ -1,6 +1,6 @@ # Shared Instructions -**This file aggregates all cross-cutting instructions that apply to every skill in the managed apps plugin.** +**This file aggregates all cross-cutting instructions that apply to every skill in the Copilot Managed Runtime plugin.** All skills reference this single file. When new shared instructions are added, update this file only β€” no changes needed to individual skills. @@ -162,7 +162,7 @@ By default, `ms app create` resolves and uses an environment automatically β€” p **For external integrations, use Power Platform connectors. Never make direct API calls (fetch, axios, Graph API, Azure REST, etc.).** -Managed apps run inside a sandbox. Direct HTTP calls to external APIs will fail at runtime because the sandbox does not allow arbitrary outbound network requests β€” only connector-proxied calls work. +Apps on Copilot Managed Runtime run inside a sandbox. Direct HTTP calls to external APIs will fail at runtime because the sandbox does not allow arbitrary outbound network requests β€” only connector-proxied calls work. **If a connector exists for the service, use it β€” no exceptions.** @@ -210,7 +210,7 @@ This availability check does not establish runtime authorization. With the gate passed, Rayfin provides the app backend database, not an external integration. Follow `/add-backend` and its local modeling/CRUD references, -then use the existing managed apps build and deploy workflow. +then use the existing Copilot Managed Runtime build and deploy workflow. --- diff --git a/plugins/microsoft-managed-apps/skills/add-data-source/SKILL.md b/plugins/microsoft-managed-apps/skills/add-data-source/SKILL.md index 343f05a..224bdf5 100644 --- a/plugins/microsoft-managed-apps/skills/add-data-source/SKILL.md +++ b/plugins/microsoft-managed-apps/skills/add-data-source/SKILL.md @@ -1,6 +1,6 @@ --- name: add-data-source -description: Canonical add flow for Microsoft Managed Apps. Use when adding any data source through `ms app add data-source` (with `--as table` or `--as action`), or when the user wants help discovering which connector / api-id to use. +description: Canonical add flow for Copilot Managed Runtime. Use when adding any data source through `ms app add data-source` (with `--as table` or `--as action`), or when the user wants help discovering which connector / api-id to use. allowed-tools: Read Edit Write Grep Glob Bash AskUserQuestion Skill --- diff --git a/plugins/microsoft-managed-apps/skills/add-office365-users/SKILL.md b/plugins/microsoft-managed-apps/skills/add-office365-users/SKILL.md index ec26487..77009ea 100644 --- a/plugins/microsoft-managed-apps/skills/add-office365-users/SKILL.md +++ b/plugins/microsoft-managed-apps/skills/add-office365-users/SKILL.md @@ -92,7 +92,7 @@ Call `UserPhotoMetadata` before downloading the photo. `HasPhoto: false` is a va no-photo state; render initials or another accessible fallback. Image responses are a special runtime contract: the generated `UserPhoto_V2` signature may -declare `IOperationResult`, but the Managed Apps SDK decodes an `image/*` response into +declare `IOperationResult`, but the Copilot Managed Runtime SDK decodes an `image/*` response into a `Uint8Array`. Do not interpolate that byte array directly into a base64 URL, and do not use a `blob:` URLβ€”the deployed App Player content security policy may block `blob:` under `img-src`. diff --git a/plugins/microsoft-managed-apps/skills/create-app/SKILL.md b/plugins/microsoft-managed-apps/skills/create-app/SKILL.md index d71a2d4..e0d0a94 100644 --- a/plugins/microsoft-managed-apps/skills/create-app/SKILL.md +++ b/plugins/microsoft-managed-apps/skills/create-app/SKILL.md @@ -1,6 +1,6 @@ --- name: create-app -description: Creates managed apps using React and Vite. Use when scaffolding a new app with `ms app create` and ending on local dev with `ms app dev`. +description: Creates apps on Copilot Managed Runtime using React and Vite. Use when scaffolding a new app with `ms app create` and ending on local dev with `ms app dev`. allowed-tools: Read Edit Write Grep Glob Bash AskUserQuestion EnterPlanMode ExitPlanMode Skill --- diff --git a/plugins/microsoft-managed-apps/skills/create-app/references/prerequisites-reference.md b/plugins/microsoft-managed-apps/skills/create-app/references/prerequisites-reference.md index e176871..89e775b 100644 --- a/plugins/microsoft-managed-apps/skills/create-app/references/prerequisites-reference.md +++ b/plugins/microsoft-managed-apps/skills/create-app/references/prerequisites-reference.md @@ -11,7 +11,7 @@ ## Required Account -- A Microsoft work/school account with access to a managed apps-enabled tenant. +- A Microsoft work/school account with access to a Copilot Managed Runtime-enabled tenant. - `ms app create` resolves an environment automatically β€” you do not need to know or provide one. (Advanced users who already have a specific environment ID can pass it via `--environment-id`.) ## Installing `@microsoft/managed-apps-cli` diff --git a/plugins/microsoft-managed-apps/skills/list-apps/SKILL.md b/plugins/microsoft-managed-apps/skills/list-apps/SKILL.md index bfeaec9..b0c1deb 100644 --- a/plugins/microsoft-managed-apps/skills/list-apps/SKILL.md +++ b/plugins/microsoft-managed-apps/skills/list-apps/SKILL.md @@ -1,6 +1,6 @@ --- name: list-apps -description: Discovers managed apps in the active environment via `ms app list --json` and optional `ms app show --json`. Use when listing or locating apps. +description: Discovers apps on Copilot Managed Runtime in the active environment via `ms app list --json` and optional `ms app show --json`. Use when listing or locating apps. allowed-tools: Read Grep Bash AskUserQuestion --- diff --git a/plugins/microsoft-managed-apps/skills/state/SKILL.md b/plugins/microsoft-managed-apps/skills/state/SKILL.md index e136579..8354e32 100644 --- a/plugins/microsoft-managed-apps/skills/state/SKILL.md +++ b/plugins/microsoft-managed-apps/skills/state/SKILL.md @@ -6,7 +6,7 @@ allowed-tools: Read Edit Write Grep Glob Bash AskUserQuestion **πŸ“‹ Shared Instructions: [shared-instructions.md](../../shared/shared-instructions.md)** β€” Cross-cutting concerns. -# Managed Apps State with CLI schema + generated client +# Copilot Managed Runtime State with CLI schema + generated client Every Microsoft Managed App can use built-in app state when the `state` feature is enabled for the current CLI/environment: a NoSQL store the app calls directly (no middle-tier function, connector, @@ -50,7 +50,7 @@ feature. ## ⚠️ Local testing requires local gateway mode -Generated state services require the Managed Apps local gateway path during local development. +Generated state services require the Copilot Managed Runtime local gateway path during local development. Before testing data behavior locally, make sure the app has `@microsoft/managed-apps-vite-plugin` 0.4.2 or later (the version that added `devMode: 'localGateway'`; older versions won't start the local gateway), then opt the app into local gateway mode. diff --git a/scripts/plugin-hooks.test.mjs b/scripts/plugin-hooks.test.mjs index 927588b..3a8cdde 100644 --- a/scripts/plugin-hooks.test.mjs +++ b/scripts/plugin-hooks.test.mjs @@ -9,7 +9,7 @@ import test from 'node:test'; const root = resolve(dirname(fileURLToPath(import.meta.url)), '..'); const windows = process.platform === 'win32'; const shell = windows ? 'powershell' : 'bash'; -const directory = mkdtempSync(join(tmpdir(), 'managed apps hooks ')); +const directory = mkdtempSync(join(tmpdir(), 'Copilot Managed Runtime hooks ')); cpSync(join(root, 'plugins/microsoft-managed-apps/hooks'), join(directory, 'hooks'), { recursive: true }); test.after(() => rmSync(directory, { recursive: true, force: true })); diff --git a/templates/vite8/src/App.tsx b/templates/vite8/src/App.tsx index 8704843..4e162c0 100644 --- a/templates/vite8/src/App.tsx +++ b/templates/vite8/src/App.tsx @@ -37,8 +37,8 @@ function App() { -

    Microsoft managed apps Documentation

    -

    Build and ship managed apps

    +

    Copilot Managed Runtime Documentation

    +

    Build and ship apps on Copilot Managed Runtime