{"name":"surface","slug":"surface","family":"setting","title":"Settings keys","noun":"settings key","description":"Upgrade links now include tracking parameters so each entry point is attributable.","description_source":"entry","described_by":{"version":"2.1.219","anchor":"upgrade-links-now-carry-a-per-surface-utm-campaign"},"presence":{"first_seen":null,"removed_in":null,"in_current_build":false,"newest_mined":"2.1.319","builds":0,"mined_builds":159,"first_cited":null},"aliases":[],"entries":[{"version":"2.1.292","anchor":"new-promptautocomplete-hook-surface-plugin-supplied-rows-u","heading":"Plugins can add their own suggestions under the prompt box","line":"A new `prompt.autocomplete` plugin hook lets plugins add completion rows under the prompt, including for desktop, mobile and VS Code composers","released_at":"2026-10-06 17:10:31","reason":"found in this entry's text"},{"version":"2.1.281","anchor":"plugin-browser-marketplace-filter-and-matching-on-the-also","heading":"Plugin browser: marketplace filter and matching on the \"also listed in\" marketplaces","line":"The plugin list can now be filtered by marketplace, including the extra marketplaces a plugin is also listed in","released_at":"2026-09-23 17:01:17","reason":"found in this entry's text"},{"version":"2.1.281","anchor":"plugin-discover-screen-marketplace-filter-pre-filled-searc","heading":"Plugin Discover screen: marketplace filter, pre-filled search, and blocked-marketplace handling","line":"The Discover plugins screen can open pre-filled with a search or marketplace, filter by marketplace, and handles blocked marketplaces","released_at":"2026-09-23 17:01:17","reason":"found in this entry's text"},{"version":"2.1.281","anchor":"plugin-install-ui-new-error-messages-and-telemetry-surface","heading":"Plugin install UI: new error messages and telemetry 'surface'","line":"The plugin install screen now shows messages for the new install failures, and its success message can mention copies in other projects","released_at":"2026-09-23 17:01:17","reason":"found in this entry's text"},{"version":"2.1.281","anchor":"plugin-install-new-replaceswitch-options-and-directory-rel","heading":"Plugin install: new replace\/switch options and directory-related failure reasons","line":"Plugin install gains unfinished options for replacing an installed copy and four new failure reasons, all reported as a generic failure","released_at":"2026-09-23 17:01:17","reason":"found in this entry's text"},{"version":"2.1.277","anchor":"promo-banner-telemetry-gains-an-entry-point-dimension","heading":"Promo banner telemetry gains an entry_point dimension","line":"Promo banner clicks and opens now record which entry point triggered them","released_at":"2026-09-18 16:22:26","reason":"found in this entry's text"},{"version":"2.1.277","anchor":"fleet-command-bar-and-fleet-reply-composer-now-strip-invisib","heading":"Fleet command bar and fleet reply composer now strip invisible\/injected characters before dispatch","line":"Fleet's command bar and reply composer now strip invisible characters and block sending if any are found","released_at":"2026-09-18 16:22:26","reason":"found in this entry's text"},{"version":"2.1.277","anchor":"plugin-ui-test-api-uipress-now-supports-non-terminal-su","heading":"Plugin UI test API $.ui.press now supports non-terminal surfaces","line":"Plugin test helper `$.ui.press` can now press buttons on non-terminal surfaces","released_at":"2026-09-18 16:22:26","reason":"found in this entry's text"},{"version":"2.1.277","anchor":"plugin-component-events-generalized-beyond-terminal-via-a-ne","heading":"Plugin component events generalized beyond terminal via a new 'surface' field","line":"Plugin UI component events can now report a surface other than 'terminal'","released_at":"2026-09-18 16:22:26","reason":"found in this entry's text, named in this entry"},{"version":"2.1.269","anchor":"hooksjson-surface-field-removed-in-favor-of-inline-client","heading":"hooks.json surface field removed in favor of inline Client module references","line":"hooks.json drops its surface field; plugins now name their display module directly on each Client element","released_at":"2026-09-11 18:12:49","reason":"found in this entry's text"}],"entries_total":36,"docs":[{"source":"api","path":"about-claude\/models\/migration-guide","title":"Or, for the model with the same capabilities and no access approval requirement:","documented":false},{"source":"api","path":"agents-and-tools\/agent-skills\/claude-api-skill","title":"claude-api-skill","documented":false},{"source":"api","path":"agents-and-tools\/agent-skills\/enterprise","title":"enterprise","documented":false},{"source":"api","path":"agents-and-tools\/agent-skills\/overview","title":"PDF Processing","documented":false},{"source":"api","path":"agents-and-tools\/mcp-connector","title":"mcp-connector","documented":false},{"source":"api","path":"agents-and-tools\/mcp-tunnels\/reference","title":"reference","documented":false},{"source":"api","path":"agents-and-tools\/tool-use\/advisor-tool","title":"advisor-tool","documented":false},{"source":"api","path":"agents-and-tools\/tool-use\/browser-use-tool","title":"browser-use-tool","documented":false},{"source":"api","path":"agents-and-tools\/tool-use\/define-tools","title":"define-tools","documented":false},{"source":"api","path":"agents-and-tools\/tool-use\/memory-tool","title":"memory-tool","documented":false}],"docs_total":12,"gates":[],"related":[],"url":"https:\/\/changelogs.core-directive.com\/reference\/setting\/surface","family_url":"https:\/\/changelogs.core-directive.com\/reference\/setting.json"}