@agent-native/core-corpus 0.205.0 → 0.205.1-nightly-20261008213122

package/corpus/README.md

@@ -32,4 +32,4 @@ rg -n "defineAction|useActionQuery" node_modules/@agent-native/core-corpus/corpu
 
 ## Generated Counts
 
-- template files: 11555
+- template files: 11564

package/corpus/templates/analytics/changelog/2026-10-08-onboarding-journeys-use-the-current-builder-setup-label.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-10-08
+---
+
+Onboarding journeys use the current Builder setup label

package/corpus/templates/analytics/seeds/dashboards/agent-native-templates-first-party.json

@@ -859,7 +859,7 @@
       "chartType": "table",
       "source": "first-party",
       "width": 3,
-      "sql": "WITH auth_identity_bridge AS (\n  SELECT linked_email, MIN(auth_user_id) AS auth_user_id\n  FROM (\n    SELECT lower(COALESCE(\n      CASE WHEN NULLIF(e.user_key, '') LIKE '%@%.%' THEN e.user_key END,\n      CASE WHEN NULLIF(e.user_id, '') LIKE '%@%.%' THEN e.user_id END\n    )) AS linked_email,\n    NULLIF(e.properties::jsonb ->> 'auth_user_id', '') AS auth_user_id\n    FROM analytics_events e\n    WHERE (event_date <= to_char(CURRENT_DATE, 'YYYY-MM-DD') AND ('{{timeRange}}' IN ('', 'all') OR ('{{timeRange}}' = '7d' AND event_date >= to_char(CURRENT_DATE - INTERVAL '7 days', 'YYYY-MM-DD')) OR ('{{timeRange}}' = '30d' AND event_date >= to_char(CURRENT_DATE - INTERVAL '30 days', 'YYYY-MM-DD')) OR ('{{timeRange}}' = '90d' AND event_date >= to_char(CURRENT_DATE - INTERVAL '90 days', 'YYYY-MM-DD')) OR ('{{timeRange}}' = '180d' AND event_date >= to_char(CURRENT_DATE - INTERVAL '180 days', 'YYYY-MM-DD')) OR ('{{timeRange}}' = '365d' AND event_date >= to_char(CURRENT_DATE - INTERVAL '365 days', 'YYYY-MM-DD')) OR ('{{timeRange}}' = 'custom' AND event_date >= '{{timeRangeStart}}' AND event_date <= '{{timeRangeEnd}}')))\n      AND ('{{appFilter}}' IN ('', 'all') OR lower(COALESCE(NULLIF(template, ''), NULLIF(properties::jsonb ->> 'templateId', ''), NULLIF(properties::jsonb ->> 'agent_native_template', ''), NULLIF(properties::jsonb ->> 'agentNativeTemplate', ''), NULLIF(app, ''), NULLIF(properties::jsonb ->> 'agent_native_app', ''), NULLIF(properties::jsonb ->> 'agentNativeApp', ''), 'unknown')) = lower('{{appFilter}}'))\n      AND lower(COALESCE(NULLIF(template, ''), NULLIF(properties::jsonb ->> 'templateId', ''), NULLIF(properties::jsonb ->> 'agent_native_template', ''), NULLIF(properties::jsonb ->> 'agentNativeTemplate', ''), NULLIF(app, ''), NULLIF(properties::jsonb ->> 'agent_native_app', ''), NULLIF(properties::jsonb ->> 'agentNativeApp', ''), 'unknown')) IN ('analytics', 'assets', 'brain', 'calendar', 'chat', 'clips', 'content', 'design', 'dispatch', 'forms', 'mail', 'plan', 'slides')\n  ) AS identities\n  WHERE linked_email IS NOT NULL\n    AND auth_user_id IS NOT NULL\n  GROUP BY linked_email\n  HAVING COUNT(DISTINCT auth_user_id) = 1\n), scoped_onboarding_events AS (\n  SELECT e.*,\n    COALESCE(\n      NULLIF(e.properties::jsonb ->> 'auth_user_id', ''),\n      auth_identity_bridge.auth_user_id,\n      NULLIF(e.user_key, ''),\n      NULLIF(e.user_id, ''),\n      NULLIF(e.anonymous_id, '')\n    ) AS funnel_user_key,\n    COALESCE(\n      CASE WHEN NULLIF(e.user_id, '') LIKE '%@%.%' THEN e.user_id END,\n      CASE WHEN NULLIF(e.user_key, '') LIKE '%@%.%' THEN e.user_key END,\n      CASE WHEN NULLIF(e.properties::jsonb ->> 'auth_user_id', '') LIKE '%@%.%' THEN e.properties::jsonb ->> 'auth_user_id' END\n    ) AS funnel_user_email\n  FROM analytics_events e\n  LEFT JOIN auth_identity_bridge ON auth_identity_bridge.linked_email = lower(COALESCE(\n    CASE WHEN NULLIF(e.user_key, '') LIKE '%@%.%' THEN e.user_key END,\n    CASE WHEN NULLIF(e.user_id, '') LIKE '%@%.%' THEN e.user_id END\n  ))\n  WHERE (event_date <= to_char(CURRENT_DATE, 'YYYY-MM-DD') AND ('{{timeRange}}' IN ('', 'all') OR ('{{timeRange}}' = '7d' AND event_date >= to_char(CURRENT_DATE - INTERVAL '7 days', 'YYYY-MM-DD')) OR ('{{timeRange}}' = '30d' AND event_date >= to_char(CURRENT_DATE - INTERVAL '30 days', 'YYYY-MM-DD')) OR ('{{timeRange}}' = '90d' AND event_date >= to_char(CURRENT_DATE - INTERVAL '90 days', 'YYYY-MM-DD')) OR ('{{timeRange}}' = '180d' AND event_date >= to_char(CURRENT_DATE - INTERVAL '180 days', 'YYYY-MM-DD')) OR ('{{timeRange}}' = '365d' AND event_date >= to_char(CURRENT_DATE - INTERVAL '365 days', 'YYYY-MM-DD')) OR ('{{timeRange}}' = 'custom' AND event_date >= '{{timeRangeStart}}' AND event_date <= '{{timeRangeEnd}}')))\n    AND ('{{appFilter}}' IN ('', 'all') OR lower(COALESCE(NULLIF(template, ''), NULLIF(properties::jsonb ->> 'templateId', ''), NULLIF(properties::jsonb ->> 'agent_native_template', ''), NULLIF(properties::jsonb ->> 'agentNativeTemplate', ''), NULLIF(app, ''), NULLIF(properties::jsonb ->> 'agent_native_app', ''), NULLIF(properties::jsonb ->> 'agentNativeApp', ''), 'unknown')) = lower('{{appFilter}}'))\n    AND lower(COALESCE(NULLIF(template, ''), NULLIF(properties::jsonb ->> 'templateId', ''), NULLIF(properties::jsonb ->> 'agent_native_template', ''), NULLIF(properties::jsonb ->> 'agentNativeTemplate', ''), NULLIF(app, ''), NULLIF(properties::jsonb ->> 'agent_native_app', ''), NULLIF(properties::jsonb ->> 'agentNativeApp', ''), 'unknown')) IN ('analytics', 'assets', 'brain', 'calendar', 'chat', 'clips', 'content', 'design', 'dispatch', 'forms', 'mail', 'plan', 'slides')\n), onboarding_events AS (\n  SELECT * FROM scoped_onboarding_events\n  WHERE ('{{emailFilter}}' IN ('', 'all') OR ('{{emailFilter}}' = 'exclude_builder' AND lower(coalesce(funnel_user_email, '')) NOT LIKE '%@builder.io') OR ('{{emailFilter}}' = 'only_builder' AND lower(coalesce(funnel_user_email, '')) LIKE '%@builder.io'))\n    AND NOT (strpos(lower(trim(coalesce(funnel_user_email, ''))), '@') > 1 AND (strpos(lower(trim(coalesce(funnel_user_email, ''))), '+autoz') > 0 OR strpos(lower(trim(coalesce(funnel_user_email, ''))), '+qa-test-bot-') > 0 OR left(lower(trim(coalesce(funnel_user_email, ''))), 12) = 'qa-test-bot-' OR left(lower(trim(coalesce(funnel_user_email, ''))), 13) = 'an-e2e-probe-' OR (left(lower(trim(coalesce(funnel_user_email, ''))), 4) = 'e2e-' AND right(lower(trim(coalesce(funnel_user_email, ''))), 12) = '@example.com') OR (left(lower(trim(coalesce(funnel_user_email, ''))), 4) = 'e2e-' AND right(lower(trim(coalesce(funnel_user_email, ''))), 12) = '@example.net') OR (left(lower(trim(coalesce(funnel_user_email, ''))), 4) = 'e2e-' AND right(lower(trim(coalesce(funnel_user_email, ''))), 12) = '@example.org') OR right(lower(trim(coalesce(funnel_user_email, ''))), 5) = '@test' OR right(lower(trim(coalesce(funnel_user_email, ''))), 5) = '.test' OR right(lower(trim(coalesce(funnel_user_email, ''))), 8) = '@invalid' OR right(lower(trim(coalesce(funnel_user_email, ''))), 8) = '.invalid' OR right(lower(trim(coalesce(funnel_user_email, ''))), 10) = '@localhost' OR right(lower(trim(coalesce(funnel_user_email, ''))), 10) = '.localhost' OR right(lower(trim(coalesce(funnel_user_email, ''))), 8) = '@example' OR right(lower(trim(coalesce(funnel_user_email, ''))), 8) = '.example'))\n), choice_viewers AS (\n  SELECT DISTINCT funnel_user_key\n  FROM onboarding_events\n  WHERE event_name = 'onboarding_step_viewed'\n    AND COALESCE(NULLIF(properties::jsonb ->> 'flow', ''), '') = 'first_run'\n    AND COALESCE(NULLIF(properties::jsonb ->> 'step_id', ''), '') = 'choice'\n    AND funnel_user_key IS NOT NULL\n), choices AS (\n  SELECT funnel_user_key,\n    COALESCE(NULLIF(properties::jsonb ->> 'method_id', ''), 'unknown') AS method_id,\n    NULLIF(properties::jsonb ->> 'onboarding_attempt_id', '') AS attempt_id,\n    timestamp::timestamptz AS clicked_at,\n    id\n  FROM onboarding_events\n  WHERE event_name = 'onboarding_method_clicked'\n    AND COALESCE(NULLIF(properties::jsonb ->> 'flow', ''), '') = 'first_run'\n    AND COALESCE(NULLIF(properties::jsonb ->> 'step_id', ''), '') = 'choice'\n    AND funnel_user_key IS NOT NULL\n), ranked_choices AS (\n  SELECT choices.*,\n    ROW_NUMBER() OVER (PARTITION BY funnel_user_key ORDER BY clicked_at, id) AS choice_number\n  FROM choices\n  JOIN choice_viewers USING (funnel_user_key)\n), first_choice_summary AS (\n  SELECT method_id, COUNT(DISTINCT funnel_user_key) AS first_choice_users\n  FROM ranked_choices\n  WHERE choice_number = 1\n  GROUP BY method_id\n), selection_summary AS (\n  SELECT method_id,\n    COUNT(DISTINCT funnel_user_key) AS selected_users,\n    COUNT(*) AS method_clicks,\n    COUNT(DISTINCT attempt_id) AS selection_attempts\n  FROM choices\n  GROUP BY method_id\n), starts AS (\n  SELECT funnel_user_key,\n    COALESCE(NULLIF(properties::jsonb ->> 'method_id', ''), 'unknown') AS method_id,\n    NULLIF(properties::jsonb ->> 'onboarding_attempt_id', '') AS attempt_id\n  FROM onboarding_events\n  WHERE event_name = 'onboarding_method_started'\n    AND COALESCE(NULLIF(properties::jsonb ->> 'flow', ''), '') = 'first_run'\n    AND COALESCE(NULLIF(properties::jsonb ->> 'step_id', ''), '') = 'choice'\n    AND funnel_user_key IS NOT NULL\n), method_outcomes AS (\n  SELECT funnel_user_key,\n    COALESCE(NULLIF(properties::jsonb ->> 'method_id', ''), 'unknown') AS method_id,\n    NULLIF(properties::jsonb ->> 'onboarding_attempt_id', '') AS attempt_id,\n    COALESCE(NULLIF(properties::jsonb ->> 'outcome', ''), 'unknown') AS outcome\n  FROM onboarding_events\n  WHERE event_name = 'onboarding_method_outcome'\n    AND COALESCE(NULLIF(properties::jsonb ->> 'flow', ''), '') = 'first_run'\n    AND COALESCE(NULLIF(properties::jsonb ->> 'step_id', ''), '') = 'choice'\n    AND funnel_user_key IS NOT NULL\n), attempts AS (\n  SELECT starts.funnel_user_key, starts.method_id, starts.attempt_id,\n    MAX(CASE WHEN method_outcomes.outcome IN ('connected', 'already_connected') THEN 1 ELSE 0 END) AS connected,\n    MAX(CASE WHEN method_outcomes.outcome = 'failed' THEN 1 ELSE 0 END) AS failed,\n    MAX(CASE WHEN method_outcomes.outcome = 'handoff_failed' THEN 1 ELSE 0 END) AS handoff_failed,\n    MAX(CASE WHEN method_outcomes.outcome = 'settings_opened' THEN 1 ELSE 0 END) AS settings_opened,\n    MAX(CASE WHEN method_outcomes.outcome IS NOT NULL THEN 1 ELSE 0 END) AS has_outcome\n  FROM starts\n  LEFT JOIN method_outcomes\n    ON method_outcomes.funnel_user_key = starts.funnel_user_key\n    AND method_outcomes.method_id = starts.method_id\n    AND method_outcomes.attempt_id = starts.attempt_id\n  GROUP BY starts.funnel_user_key, starts.method_id, starts.attempt_id\n), attempt_summary AS (\n  SELECT method_id,\n    COUNT(DISTINCT CASE WHEN connected = 1 THEN attempt_id END) AS connection_success_attempts,\n    COUNT(DISTINCT CASE WHEN failed = 1 THEN attempt_id END) AS connection_failure_attempts,\n    COUNT(DISTINCT CASE WHEN handoff_failed = 1 THEN attempt_id END) AS handoff_failure_attempts,\n    COUNT(DISTINCT CASE WHEN connected = 1 THEN funnel_user_key END) AS connection_success_users,\n    COUNT(DISTINCT CASE WHEN failed = 1 THEN funnel_user_key END) AS connection_failure_users,\n    COUNT(DISTINCT CASE WHEN connected = 0 AND failed = 0 AND has_outcome = 0 THEN attempt_id END) AS connection_no_outcome_attempts,\n    COUNT(DISTINCT CASE WHEN settings_opened = 1 THEN attempt_id END) AS settings_handoff_attempts\n  FROM attempts\n  GROUP BY method_id\n), method_list AS (\n  SELECT 'builder_create_account' AS method_id, 'Create Builder.io account' AS method_label\n  UNION ALL SELECT 'builder_sign_in', 'Sign in with Builder.io account'\n  UNION ALL SELECT 'custom_keys', 'Configure custom keys'\n)\nSELECT method_list.method_id, method_list.method_label,\n  (SELECT COUNT(DISTINCT funnel_user_key) FROM choice_viewers) AS choice_screen_viewers,\n  COALESCE(first_choice_summary.first_choice_users, 0) AS first_choice_users,\n  COALESCE(first_choice_summary.first_choice_users::float / NULLIF((SELECT COUNT(DISTINCT funnel_user_key) FROM choice_viewers), 0), 0) AS first_choice_rate,\n  COALESCE(selection_summary.selected_users, 0) AS selected_users,\n  COALESCE(selection_summary.method_clicks, 0) AS method_clicks,\n  COALESCE(selection_summary.selection_attempts, 0) AS selection_attempts,\n  COALESCE(attempt_summary.connection_success_attempts, 0) AS connection_success_attempts,\n  COALESCE(attempt_summary.connection_failure_attempts, 0) AS connection_failure_attempts,\n  COALESCE(attempt_summary.handoff_failure_attempts, 0) AS handoff_failure_attempts,\n  COALESCE(attempt_summary.connection_success_users, 0) AS connection_success_users,\n  COALESCE(attempt_summary.connection_failure_users, 0) AS connection_failure_users,\n  COALESCE(attempt_summary.connection_no_outcome_attempts, 0) AS connection_no_outcome_attempts,\n  COALESCE(attempt_summary.settings_handoff_attempts, 0) AS settings_handoff_attempts,\n  attempt_summary.connection_success_attempts::float / NULLIF(attempt_summary.connection_success_attempts + attempt_summary.connection_failure_attempts, 0) AS connection_success_rate\nFROM method_list\nLEFT JOIN first_choice_summary ON first_choice_summary.method_id = method_list.method_id\nLEFT JOIN selection_summary ON selection_summary.method_id = method_list.method_id\nLEFT JOIN attempt_summary ON attempt_summary.method_id = method_list.method_id\nORDER BY method_list.method_id",
+      "sql": "WITH auth_identity_bridge AS (\n  SELECT linked_email, MIN(auth_user_id) AS auth_user_id\n  FROM (\n    SELECT lower(COALESCE(\n      CASE WHEN NULLIF(e.user_key, '') LIKE '%@%.%' THEN e.user_key END,\n      CASE WHEN NULLIF(e.user_id, '') LIKE '%@%.%' THEN e.user_id END\n    )) AS linked_email,\n    NULLIF(e.properties::jsonb ->> 'auth_user_id', '') AS auth_user_id\n    FROM analytics_events e\n    WHERE (event_date <= to_char(CURRENT_DATE, 'YYYY-MM-DD') AND ('{{timeRange}}' IN ('', 'all') OR ('{{timeRange}}' = '7d' AND event_date >= to_char(CURRENT_DATE - INTERVAL '7 days', 'YYYY-MM-DD')) OR ('{{timeRange}}' = '30d' AND event_date >= to_char(CURRENT_DATE - INTERVAL '30 days', 'YYYY-MM-DD')) OR ('{{timeRange}}' = '90d' AND event_date >= to_char(CURRENT_DATE - INTERVAL '90 days', 'YYYY-MM-DD')) OR ('{{timeRange}}' = '180d' AND event_date >= to_char(CURRENT_DATE - INTERVAL '180 days', 'YYYY-MM-DD')) OR ('{{timeRange}}' = '365d' AND event_date >= to_char(CURRENT_DATE - INTERVAL '365 days', 'YYYY-MM-DD')) OR ('{{timeRange}}' = 'custom' AND event_date >= '{{timeRangeStart}}' AND event_date <= '{{timeRangeEnd}}')))\n      AND ('{{appFilter}}' IN ('', 'all') OR lower(COALESCE(NULLIF(template, ''), NULLIF(properties::jsonb ->> 'templateId', ''), NULLIF(properties::jsonb ->> 'agent_native_template', ''), NULLIF(properties::jsonb ->> 'agentNativeTemplate', ''), NULLIF(app, ''), NULLIF(properties::jsonb ->> 'agent_native_app', ''), NULLIF(properties::jsonb ->> 'agentNativeApp', ''), 'unknown')) = lower('{{appFilter}}'))\n      AND lower(COALESCE(NULLIF(template, ''), NULLIF(properties::jsonb ->> 'templateId', ''), NULLIF(properties::jsonb ->> 'agent_native_template', ''), NULLIF(properties::jsonb ->> 'agentNativeTemplate', ''), NULLIF(app, ''), NULLIF(properties::jsonb ->> 'agent_native_app', ''), NULLIF(properties::jsonb ->> 'agentNativeApp', ''), 'unknown')) IN ('analytics', 'assets', 'brain', 'calendar', 'chat', 'clips', 'content', 'design', 'dispatch', 'forms', 'mail', 'plan', 'slides')\n  ) AS identities\n  WHERE linked_email IS NOT NULL\n    AND auth_user_id IS NOT NULL\n  GROUP BY linked_email\n  HAVING COUNT(DISTINCT auth_user_id) = 1\n), scoped_onboarding_events AS (\n  SELECT e.*,\n    COALESCE(\n      NULLIF(e.properties::jsonb ->> 'auth_user_id', ''),\n      auth_identity_bridge.auth_user_id,\n      NULLIF(e.user_key, ''),\n      NULLIF(e.user_id, ''),\n      NULLIF(e.anonymous_id, '')\n    ) AS funnel_user_key,\n    COALESCE(\n      CASE WHEN NULLIF(e.user_id, '') LIKE '%@%.%' THEN e.user_id END,\n      CASE WHEN NULLIF(e.user_key, '') LIKE '%@%.%' THEN e.user_key END,\n      CASE WHEN NULLIF(e.properties::jsonb ->> 'auth_user_id', '') LIKE '%@%.%' THEN e.properties::jsonb ->> 'auth_user_id' END\n    ) AS funnel_user_email\n  FROM analytics_events e\n  LEFT JOIN auth_identity_bridge ON auth_identity_bridge.linked_email = lower(COALESCE(\n    CASE WHEN NULLIF(e.user_key, '') LIKE '%@%.%' THEN e.user_key END,\n    CASE WHEN NULLIF(e.user_id, '') LIKE '%@%.%' THEN e.user_id END\n  ))\n  WHERE (event_date <= to_char(CURRENT_DATE, 'YYYY-MM-DD') AND ('{{timeRange}}' IN ('', 'all') OR ('{{timeRange}}' = '7d' AND event_date >= to_char(CURRENT_DATE - INTERVAL '7 days', 'YYYY-MM-DD')) OR ('{{timeRange}}' = '30d' AND event_date >= to_char(CURRENT_DATE - INTERVAL '30 days', 'YYYY-MM-DD')) OR ('{{timeRange}}' = '90d' AND event_date >= to_char(CURRENT_DATE - INTERVAL '90 days', 'YYYY-MM-DD')) OR ('{{timeRange}}' = '180d' AND event_date >= to_char(CURRENT_DATE - INTERVAL '180 days', 'YYYY-MM-DD')) OR ('{{timeRange}}' = '365d' AND event_date >= to_char(CURRENT_DATE - INTERVAL '365 days', 'YYYY-MM-DD')) OR ('{{timeRange}}' = 'custom' AND event_date >= '{{timeRangeStart}}' AND event_date <= '{{timeRangeEnd}}')))\n    AND ('{{appFilter}}' IN ('', 'all') OR lower(COALESCE(NULLIF(template, ''), NULLIF(properties::jsonb ->> 'templateId', ''), NULLIF(properties::jsonb ->> 'agent_native_template', ''), NULLIF(properties::jsonb ->> 'agentNativeTemplate', ''), NULLIF(app, ''), NULLIF(properties::jsonb ->> 'agent_native_app', ''), NULLIF(properties::jsonb ->> 'agentNativeApp', ''), 'unknown')) = lower('{{appFilter}}'))\n    AND lower(COALESCE(NULLIF(template, ''), NULLIF(properties::jsonb ->> 'templateId', ''), NULLIF(properties::jsonb ->> 'agent_native_template', ''), NULLIF(properties::jsonb ->> 'agentNativeTemplate', ''), NULLIF(app, ''), NULLIF(properties::jsonb ->> 'agent_native_app', ''), NULLIF(properties::jsonb ->> 'agentNativeApp', ''), 'unknown')) IN ('analytics', 'assets', 'brain', 'calendar', 'chat', 'clips', 'content', 'design', 'dispatch', 'forms', 'mail', 'plan', 'slides')\n), onboarding_events AS (\n  SELECT * FROM scoped_onboarding_events\n  WHERE ('{{emailFilter}}' IN ('', 'all') OR ('{{emailFilter}}' = 'exclude_builder' AND lower(coalesce(funnel_user_email, '')) NOT LIKE '%@builder.io') OR ('{{emailFilter}}' = 'only_builder' AND lower(coalesce(funnel_user_email, '')) LIKE '%@builder.io'))\n    AND NOT (strpos(lower(trim(coalesce(funnel_user_email, ''))), '@') > 1 AND (strpos(lower(trim(coalesce(funnel_user_email, ''))), '+autoz') > 0 OR strpos(lower(trim(coalesce(funnel_user_email, ''))), '+qa-test-bot-') > 0 OR left(lower(trim(coalesce(funnel_user_email, ''))), 12) = 'qa-test-bot-' OR left(lower(trim(coalesce(funnel_user_email, ''))), 13) = 'an-e2e-probe-' OR (left(lower(trim(coalesce(funnel_user_email, ''))), 4) = 'e2e-' AND right(lower(trim(coalesce(funnel_user_email, ''))), 12) = '@example.com') OR (left(lower(trim(coalesce(funnel_user_email, ''))), 4) = 'e2e-' AND right(lower(trim(coalesce(funnel_user_email, ''))), 12) = '@example.net') OR (left(lower(trim(coalesce(funnel_user_email, ''))), 4) = 'e2e-' AND right(lower(trim(coalesce(funnel_user_email, ''))), 12) = '@example.org') OR right(lower(trim(coalesce(funnel_user_email, ''))), 5) = '@test' OR right(lower(trim(coalesce(funnel_user_email, ''))), 5) = '.test' OR right(lower(trim(coalesce(funnel_user_email, ''))), 8) = '@invalid' OR right(lower(trim(coalesce(funnel_user_email, ''))), 8) = '.invalid' OR right(lower(trim(coalesce(funnel_user_email, ''))), 10) = '@localhost' OR right(lower(trim(coalesce(funnel_user_email, ''))), 10) = '.localhost' OR right(lower(trim(coalesce(funnel_user_email, ''))), 8) = '@example' OR right(lower(trim(coalesce(funnel_user_email, ''))), 8) = '.example'))\n), choice_viewers AS (\n  SELECT DISTINCT funnel_user_key\n  FROM onboarding_events\n  WHERE event_name = 'onboarding_step_viewed'\n    AND COALESCE(NULLIF(properties::jsonb ->> 'flow', ''), '') = 'first_run'\n    AND COALESCE(NULLIF(properties::jsonb ->> 'step_id', ''), '') = 'choice'\n    AND funnel_user_key IS NOT NULL\n), choices AS (\n  SELECT funnel_user_key,\n    COALESCE(NULLIF(properties::jsonb ->> 'method_id', ''), 'unknown') AS method_id,\n    NULLIF(properties::jsonb ->> 'onboarding_attempt_id', '') AS attempt_id,\n    timestamp::timestamptz AS clicked_at,\n    id\n  FROM onboarding_events\n  WHERE event_name = 'onboarding_method_clicked'\n    AND COALESCE(NULLIF(properties::jsonb ->> 'flow', ''), '') = 'first_run'\n    AND COALESCE(NULLIF(properties::jsonb ->> 'step_id', ''), '') = 'choice'\n    AND funnel_user_key IS NOT NULL\n), ranked_choices AS (\n  SELECT choices.*,\n    ROW_NUMBER() OVER (PARTITION BY funnel_user_key ORDER BY clicked_at, id) AS choice_number\n  FROM choices\n  JOIN choice_viewers USING (funnel_user_key)\n), first_choice_summary AS (\n  SELECT method_id, COUNT(DISTINCT funnel_user_key) AS first_choice_users\n  FROM ranked_choices\n  WHERE choice_number = 1\n  GROUP BY method_id\n), selection_summary AS (\n  SELECT method_id,\n    COUNT(DISTINCT funnel_user_key) AS selected_users,\n    COUNT(*) AS method_clicks,\n    COUNT(DISTINCT attempt_id) AS selection_attempts\n  FROM choices\n  GROUP BY method_id\n), starts AS (\n  SELECT funnel_user_key,\n    COALESCE(NULLIF(properties::jsonb ->> 'method_id', ''), 'unknown') AS method_id,\n    NULLIF(properties::jsonb ->> 'onboarding_attempt_id', '') AS attempt_id\n  FROM onboarding_events\n  WHERE event_name = 'onboarding_method_started'\n    AND COALESCE(NULLIF(properties::jsonb ->> 'flow', ''), '') = 'first_run'\n    AND COALESCE(NULLIF(properties::jsonb ->> 'step_id', ''), '') = 'choice'\n    AND funnel_user_key IS NOT NULL\n), method_outcomes AS (\n  SELECT funnel_user_key,\n    COALESCE(NULLIF(properties::jsonb ->> 'method_id', ''), 'unknown') AS method_id,\n    NULLIF(properties::jsonb ->> 'onboarding_attempt_id', '') AS attempt_id,\n    COALESCE(NULLIF(properties::jsonb ->> 'outcome', ''), 'unknown') AS outcome\n  FROM onboarding_events\n  WHERE event_name = 'onboarding_method_outcome'\n    AND COALESCE(NULLIF(properties::jsonb ->> 'flow', ''), '') = 'first_run'\n    AND COALESCE(NULLIF(properties::jsonb ->> 'step_id', ''), '') = 'choice'\n    AND funnel_user_key IS NOT NULL\n), attempts AS (\n  SELECT starts.funnel_user_key, starts.method_id, starts.attempt_id,\n    MAX(CASE WHEN method_outcomes.outcome IN ('connected', 'already_connected') THEN 1 ELSE 0 END) AS connected,\n    MAX(CASE WHEN method_outcomes.outcome = 'failed' THEN 1 ELSE 0 END) AS failed,\n    MAX(CASE WHEN method_outcomes.outcome = 'handoff_failed' THEN 1 ELSE 0 END) AS handoff_failed,\n    MAX(CASE WHEN method_outcomes.outcome = 'settings_opened' THEN 1 ELSE 0 END) AS settings_opened,\n    MAX(CASE WHEN method_outcomes.outcome IS NOT NULL THEN 1 ELSE 0 END) AS has_outcome\n  FROM starts\n  LEFT JOIN method_outcomes\n    ON method_outcomes.funnel_user_key = starts.funnel_user_key\n    AND method_outcomes.method_id = starts.method_id\n    AND method_outcomes.attempt_id = starts.attempt_id\n  GROUP BY starts.funnel_user_key, starts.method_id, starts.attempt_id\n), attempt_summary AS (\n  SELECT method_id,\n    COUNT(DISTINCT CASE WHEN connected = 1 THEN attempt_id END) AS connection_success_attempts,\n    COUNT(DISTINCT CASE WHEN failed = 1 THEN attempt_id END) AS connection_failure_attempts,\n    COUNT(DISTINCT CASE WHEN handoff_failed = 1 THEN attempt_id END) AS handoff_failure_attempts,\n    COUNT(DISTINCT CASE WHEN connected = 1 THEN funnel_user_key END) AS connection_success_users,\n    COUNT(DISTINCT CASE WHEN failed = 1 THEN funnel_user_key END) AS connection_failure_users,\n    COUNT(DISTINCT CASE WHEN connected = 0 AND failed = 0 AND has_outcome = 0 THEN attempt_id END) AS connection_no_outcome_attempts,\n    COUNT(DISTINCT CASE WHEN settings_opened = 1 THEN attempt_id END) AS settings_handoff_attempts\n  FROM attempts\n  GROUP BY method_id\n), method_list AS (\n  SELECT 'builder_create_account' AS method_id, 'Use Builder.io' AS method_label\n  UNION ALL SELECT 'builder_sign_in', 'Sign in with Builder.io account'\n  UNION ALL SELECT 'custom_keys', 'Configure custom keys'\n)\nSELECT method_list.method_id, method_list.method_label,\n  (SELECT COUNT(DISTINCT funnel_user_key) FROM choice_viewers) AS choice_screen_viewers,\n  COALESCE(first_choice_summary.first_choice_users, 0) AS first_choice_users,\n  COALESCE(first_choice_summary.first_choice_users::float / NULLIF((SELECT COUNT(DISTINCT funnel_user_key) FROM choice_viewers), 0), 0) AS first_choice_rate,\n  COALESCE(selection_summary.selected_users, 0) AS selected_users,\n  COALESCE(selection_summary.method_clicks, 0) AS method_clicks,\n  COALESCE(selection_summary.selection_attempts, 0) AS selection_attempts,\n  COALESCE(attempt_summary.connection_success_attempts, 0) AS connection_success_attempts,\n  COALESCE(attempt_summary.connection_failure_attempts, 0) AS connection_failure_attempts,\n  COALESCE(attempt_summary.handoff_failure_attempts, 0) AS handoff_failure_attempts,\n  COALESCE(attempt_summary.connection_success_users, 0) AS connection_success_users,\n  COALESCE(attempt_summary.connection_failure_users, 0) AS connection_failure_users,\n  COALESCE(attempt_summary.connection_no_outcome_attempts, 0) AS connection_no_outcome_attempts,\n  COALESCE(attempt_summary.settings_handoff_attempts, 0) AS settings_handoff_attempts,\n  attempt_summary.connection_success_attempts::float / NULLIF(attempt_summary.connection_success_attempts + attempt_summary.connection_failure_attempts, 0) AS connection_success_rate\nFROM method_list\nLEFT JOIN first_choice_summary ON first_choice_summary.method_id = method_list.method_id\nLEFT JOIN selection_summary ON selection_summary.method_id = method_list.method_id\nLEFT JOIN attempt_summary ON attempt_summary.method_id = method_list.method_id\nORDER BY method_list.method_id",
       "config": {
         "description": "Choice-screen viewers, first selected setup path, repeat selections, and linked Builder connection outcomes. Rates use choice-screen viewers or resolved Builder outcomes as their denominator; started attempts with no outcome are unknown or abandoned, not assumed failures. Handoff failures are reported separately from Builder connection failures. A successful Builder outcome confirms credentials connected, not that a new external account was created. Account-exists is counted as a failed create-account attempt. Test identities are excluded.",
         "columns": [

package/corpus/templates/analytics/server/lib/canonical-first-party-dashboard-repair.ts

@@ -634,6 +634,16 @@ function repairFingerprintedPanelQueries(
 
 const CANONICAL_CUSTOM_PANEL_REPLACEMENTS: readonly ExactFirstPartyPanelReplacement[] =
   [
+    {
+      id: "onboarding-setup-choice",
+      legacySql: [
+        buildPanel("onboarding-setup-choice")!.sql.replace(
+          "'Use Builder.io' AS method_label",
+          "'Create Builder.io account' AS method_label",
+        ),
+      ],
+      sql: buildPanel("onboarding-setup-choice")!.sql,
+    },
     {
       id: "signups-over-time",
       legacySql: [

package/corpus/templates/analytics/server/lib/first-party-metric-catalog.ts

@@ -1309,7 +1309,7 @@ const ONBOARDING_SETUP_CHOICE_SQL = `${ONBOARDING_EVENTS_CTE}, choice_viewers AS
   FROM attempts
   GROUP BY method_id
 ), method_list AS (
-  SELECT 'builder_create_account' AS method_id, 'Create Builder.io account' AS method_label
+  SELECT 'builder_create_account' AS method_id, 'Use Builder.io' AS method_label
   UNION ALL SELECT 'builder_sign_in', 'Sign in with Builder.io account'
   UNION ALL SELECT 'custom_keys', 'Configure custom keys'
 )

package/corpus/templates/analytics/server/lib/journey-steps.ts

@@ -29,7 +29,7 @@ export interface JourneyStep {
 
 /** Display names match the `onboarding-setup-choice` metric's method list. */
 const METHOD_LABELS: Record<string, string> = {
-  builder_create_account: "Create Builder.io account",
+  builder_create_account: "Use Builder.io",
   builder_sign_in: "Sign in with Builder.io account",
   custom_keys: "Configure custom keys",
 };

package/corpus/templates/clips/app/components/recorder/storage-setup-card.tsx

@@ -62,12 +62,22 @@ export function StorageSetupCard({
   const [retryingBuilderStatus, setRetryingBuilderStatus] = useState(false);
   const retryingBuilderStatusAtCountRef = useRef<number | null>(null);
   const pollRef = useRef<ReturnType<typeof setInterval> | null>(null);
+  const configuredTimeoutRef = useRef<ReturnType<typeof setTimeout> | null>(
+    null,
+  );
   const mountedRef = useRef(true);
   const inFlightRef = useRef(false);
   const visibilityHandlerRef = useRef<(() => void) | null>(null);
   const connectRequestedRef = useRef(false);
   const connectIntentExpiresAtRef = useRef<number | null>(null);
 
+  const clearConfiguredTimeout = useCallback(() => {
+    if (configuredTimeoutRef.current !== null) {
+      clearTimeout(configuredTimeoutRef.current);
+      configuredTimeoutRef.current = null;
+    }
+  }, []);
+
   const stopVisibilityHandler = useCallback(() => {
     if (visibilityHandlerRef.current) {
       document.removeEventListener(
@@ -79,6 +89,7 @@ export function StorageSetupCard({
   }, []);
 
   const startFileUploadPoll = useCallback(() => {
+    clearConfiguredTimeout();
     if (pollRef.current) {
       clearInterval(pollRef.current);
       pollRef.current = null;
@@ -135,7 +146,11 @@ export function StorageSetupCard({
           stop();
           setConnecting(false);
           setConnected(true);
-          setTimeout(() => void onConfigured(), 800);
+          clearConfiguredTimeout();
+          configuredTimeoutRef.current = setTimeout(() => {
+            configuredTimeoutRef.current = null;
+            if (mountedRef.current) void onConfigured();
+          }, 800);
         } else if (status.state === "unavailable") {
           stop();
           setConnecting(false);
@@ -162,7 +177,7 @@ export function StorageSetupCard({
       if (!document.hidden) void tick();
     };
     document.addEventListener("visibilitychange", visibilityHandlerRef.current);
-  }, [onConfigured, stopVisibilityHandler, t]);
+  }, [clearConfiguredTimeout, onConfigured, stopVisibilityHandler, t]);
 
   const handleBuilderConnected = useCallback(() => {
     if (!connectRequestedRef.current) return;
@@ -232,6 +247,10 @@ export function StorageSetupCard({
       Date.now() + CANCELLED_SETUP_RECOVERY_MS;
     builderConnect.cancel();
   }, [builderConnect.cancel]);
+  const handleSkip = useCallback(() => {
+    clearConfiguredTimeout();
+    onSkip?.();
+  }, [clearConfiguredTimeout, onSkip]);
   const builderConnectErrorMessage = builderConnect.error
     ? builderConnect.errorKind === "launch"
       ? t("storageSetup.builderConnectPopupError")
@@ -250,13 +269,14 @@ export function StorageSetupCard({
     mountedRef.current = true;
     return () => {
       mountedRef.current = false;
+      clearConfiguredTimeout();
       if (pollRef.current) {
         clearInterval(pollRef.current);
         pollRef.current = null;
       }
       stopVisibilityHandler();
     };
-  }, [stopVisibilityHandler]);
+  }, [clearConfiguredTimeout, stopVisibilityHandler]);
 
   return (
     <div className="mx-auto flex w-full max-w-md flex-col gap-5 rounded-2xl border border-border bg-card p-6 shadow-lg">
@@ -379,7 +399,7 @@ export function StorageSetupCard({
           variant="ghost"
           size="sm"
           className="self-center text-muted-foreground"
-          onClick={onSkip}
+          onClick={handleSkip}
         >
           {t("agentChat.onboarding.skipForNow")}
         </Button>

package/corpus/templates/clips/changelog/2026-10-08-clips-respects-skip-after-storage-connects-and-gives-accurat.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-10-08
+---
+
+Clips respects Skip after storage connects and gives accurate guidance when Builder does not respond

package/corpus/templates/slides/.agents/skills/apply-slide-comments/SKILL.md

@@ -0,0 +1,55 @@
+---
+name: apply-slide-comments
+description: >-
+  Turn open slide comments into edits and resolve them. Use when the user asks
+  to apply, address, resolve, or work through comments, review notes, or
+  feedback left on a deck or slide.
+---
+
+# Apply Slide Comments
+
+Comments are instructions anchored to a slide. Edits follow `slide-editing`;
+this skill is the loop around them.
+
+## Procedure
+
+1. **Collect.** `list-slide-comments` with `deckId` (add `slideId` only when the
+   user scoped the request; page with `next_cursor` while `has_more`). Keep
+   threads with `resolved: false`. A thread is the root comment plus replies
+   (`thread_id`, `parent_id`); read the whole thread, and treat the latest
+   instruction as current.
+2. **Group by slide** and note each comment's anchor: `anchor.objectId` is the
+   `data-slide-object-id` element, `quoted_text` / `anchor.targetText` and the
+   text offsets locate the words, and an anchor with only `x` / `y` is a
+   position on the slide.
+3. **Read each affected slide** once: `view-screen` for the open slide,
+   `get-deck` with `slideIds` and `compact=false` for the rest. Interpret the
+   comment against its anchor object, not the whole slide.
+4. **Apply every edit for one slide in a single `patch-deck` `patch-slide`
+   operation** with that slide's `baseContentHash`. Preserve ids and
+   `left`/`top`/`width`, and change only what the comment asks for.
+5. **Verify.** When text length changed, call `get-layout-overflows` once after
+   all slides are written, and `audit-contrast` last (see `slide-editing`). Read
+   the persisted slide back before resolving anything.
+6. **Resolve** each applied thread: `update-slide-comment` with `id`, `deckId`,
+   `resolved: true` (resolving applies to the full thread). Never delete a
+   user's comment.
+7. **Leave open** any comment you skipped, that is ambiguous, or that asks for
+   something outside the deck (new data, an image only the user has). Say why
+   in the summary; reply with `add-slide-comment` (`threadId` + `parentId`)
+   only if the user asked you to.
+
+## Judgment
+
+- Ambiguous but low-risk: apply the smallest reasonable reading and state the
+  assumption. Ambiguous and costly to undo (cuts content, changes numbers,
+  conflicts with another comment): skip it.
+- Conflicting comments on one element: apply neither, name both.
+- A comment about a fact needs the source; follow `creative-context`, do not
+  guess.
+- Leave no TODO or "per comment" text in slide HTML.
+
+## Summary
+
+Finish with one line, `N applied, M skipped`, then one line per change
+(slide number, what changed) and one per skipped comment with its reason.

package/corpus/templates/slides/.agents/skills/create-deck/SKILL.md

@@ -36,6 +36,8 @@ Context, reference deck, or source material that the app already provides.
 
 When speaker notes are requested, put presenter-only text in each slide's
    `notes` field on `create-deck` or `add-slide`; keep it out of the slide HTML.
+Write notes as speech, not a summary of the slide: the opener, the transition
+to the next slide, numbers to cite, a timing cue.
 Preserve existing notes when editing or importing a source deck.
 
 When the UI has already created the empty deck, keep its id and rename it before
@@ -62,7 +64,12 @@ and slide chrome. Read `slide-design` for visual craft; it works inside the
 active system and reference deck, never as a competing theme. If the
 request is open-ended and no approved direction exists, ask one targeted guided
 question or present a bounded choice before writing; do not silently pick a new
-brand language.
+brand language. Write a direction choice for this topic: three options, each a
+vibe word plus one concrete visual cue (palette, type, motif; for example "rust
+technical editorial: warm rust on charcoal, mono headings, code-grid layout"),
+clearly different from each other, the best fit marked recommended. Never offer
+generic labels such as "minimal" or "corporate" alone. Take everything else
+(density, slide count, structure) from the request and do the work.
 
 Before the first slide, lock a deck-level visual contract: background family,
 text and surface roles, accent treatment, heading/body type pairing, spacing
@@ -232,13 +239,24 @@ component language as a substitute for choosing.
 
 The canvas is fixed at its aspect-ratio dimensions. With the standard 16:9
 canvas (960x540) and `padding: 64px 80px`, the usable content area is only
-800x412px. Treat that as a hard budget for the main flow: use at most two title
-lines, three short bullets or cards, and two or three short items per column.
-Split dense source material across slides instead of shrinking it into a dense
-stack. Keep body text at or above 16px. Never hide overflow with zoom,
-`transform: scale()`, clipping, or scroll overflow. A later structural repair
-may reduce the slide's explicit padding, and that padding must remain intact
-when the saved HTML is rendered.
+800x412px (usable height is canvas height minus both vertical paddings). Treat
+that as a hard budget for the main flow: use at most two title lines, three
+short bullets or cards, and two or three short items per column. A content slide
+carries about 40 words besides its title. A bullet fits on one line (about 70
+characters at 18px); only a card may wrap, to two lines. Split dense source
+material across slides instead of shrinking it into a dense stack. Keep body
+text at or above 16px. Never hide overflow with zoom, `transform: scale()`,
+clipping, or scroll overflow. A later structural repair may reduce the slide's
+explicit padding, and that padding must remain intact when the saved HTML is
+rendered.
+
+Before writing a slide, total its flow height: per text block, font-size x
+line-height x wrapped lines (average glyph width is about 0.5 x font-size), plus
+padding and gaps. Count every wrapped line and keep about 10% slack for the
+measured check. Example: a two-line 34px/1.12 heading (76) + 18 gap + three
+cards of two 18px/1.4 lines plus 24 padding (3 x 74 = 223) + two 14px gaps (28)
+= 345, inside 412; a fourth card adds 88 and does not fit. When the total
+exceeds the budget, split the slide; do not shrink type, padding, or gaps.
 
 Build an intentional composition beyond a text dump: use a title block,
 two-column split, metric treatment, rule, callout, visual placeholder, or
@@ -249,6 +267,9 @@ with nothing real to show is complete with type, spacing, and a rule. A
 built-in template's signature art belongs to that template; do not carry it
 into other decks.
 
+Author in normal flex/grid flow; the card, wrapper, height, and `contain` rules
+are in `slide-editing` (Flow Layout and the Editor).
+
 ## Bounded visual QA
 
 Before calling the deck complete, render every changed slide at its canonical
@@ -306,8 +327,11 @@ short rule, or callout should support the message, not fill empty space.
 
 ## Image Placeholders
 
-When a slide needs a visual, use this div. It renders as a styled placeholder
-and can later be replaced with a generated image:
+When a slide needs a specific visual, use this div. It renders as a styled
+placeholder and can later be replaced with a generated image. Describe the
+content the image must show ("Q3 revenue by region, bar chart"), not its role
+("hero image"). If type, layout, and color can carry the slide, use no
+placeholder:
 
 ```html
 <div class="fmd-img-placeholder" style="width: 100%; min-height: 220px; border-radius: var(--deck-radius);">[Description of what image should show]</div>

package/corpus/templates/slides/.agents/skills/slide-design/SKILL.md

@@ -90,8 +90,11 @@ Type does most of the work.
   for related, far for unrelated; equal gaps everywhere read as amateur.
 - **Optical alignment:** nudge large type to look flush with small text.
 - **One focal point.** Squint; one thing should land first.
-- Keep generated layout in normal flex/grid flow and never clip or scale
-  overflow; `slide-editing` owns those constraints.
+- **One idea per slide; split, do not shrink.** Total the flow height and word
+  count before writing (Fit budget in `create-deck`); a slide that does not fit
+  becomes two slides, not smaller type, tighter padding, or clipped overflow.
+- Flow, card, and fixed-height constraints: `slide-editing` (Flow Layout and the
+  Editor).
 
 ## Color
 
@@ -117,7 +120,7 @@ With a system or reference, use only its colors; these rules govern how.
 - **Screenshots as hero shots:** crop to the region the headline is about,
   scale it up, set it on a surface that fits the direction.
 - **One graphic vocabulary:** 1-2px rules, large index numbers ("01"), one
-  repeated shape motif. Every shape needs a semantic role; no inline SVG.
+  repeated shape motif. Every shape needs a semantic role.
 - **Charts in the deck's type and palette:** thin strokes, direct labels, the
   key series in the accent, the rest in a tinted neutral, no gridline or
   legend clutter.
@@ -128,8 +131,9 @@ With a system or reference, use only its colors; these rules govern how.
   headline + image, split, grid of 3, quote, closing. Alternate dense and
   sparse; avoid three identical layouts in a row.
 - Fixed chrome in the exact same place on every slide: a small running head,
-  a page number like `04 / 12`, maybe a hairline. Quiet repetition is what
-  makes a deck feel designed.
+  maybe a hairline. Quiet repetition is what makes a deck feel designed. Do not
+  type page numbers such as `04 / 12`: inserting or reordering slides makes
+  them wrong everywhere, and the renderer provides no page-number token.
 - Title and section slides carry the strongest expression of the direction.
 
 ## What reads as generic

package/corpus/templates/slides/.agents/skills/slide-editing/SKILL.md

@@ -85,14 +85,10 @@ panels, fake logos, and filler bullets.
 
 ## Fit and Density
 
-Fit the main content to the native content area, not merely to the outer
-wrapper. For the default 16:9 canvas, the standard `64px 80px` padding leaves
-800x412px. Keep titles to two lines, content slides to three short bullets or
-three compact cards, and two-column slides to two or three short items per
-column. If the source is denser, split it across slides. Never use zoom,
-`transform: scale()`, clipping, or scroll overflow to hide a fit issue; body
-text must remain at least 16px. Explicitly reduced slide padding is allowed when
-the content still needs the space.
+Edits obey the Fit budget in `create-deck`, measured against the slide's own
+padding and aspect ratio. When an edit adds or lengthens text, redo the height
+arithmetic for that slide and split it instead of shrinking. Explicitly reduced
+slide padding is allowed when the content still needs the space.
 
 After all deck edits, call `get-layout-overflows` once. If you repair a
 measured overflow, call it once more; do not check between writes. If status is
@@ -139,6 +135,12 @@ To edit a slide's content:
    For a targeted persisted read, pass that stable `slideId` to `get-deck` so
    only the target slide is returned; use `compact=false` when you need its
    full HTML.
+   The user navigates and reselects between turns. On any turn that says
+   this, here, that slide, these, or the selected one (including a follow-up
+   like "now make it bigger"), call `view-screen` again before acting; never
+   reuse the previous turn's slide ID or selection. If it shows nothing
+   selected or the target is unclear, ask which slide rather than guessing from
+   recent edits.
 2. **Retrieve before generating**: when the edit changes facts, brand language,
    or layout, follow the `creative-context` skill and query those roles
    separately. Respect opt-out, pinned packs, and the exact reuse ladder.
@@ -259,6 +261,10 @@ same operations.
 ## Click-to-reveal animations
 
 Animations are metadata over the final slide HTML, not alternate slide markup.
+Reveal only where the order of ideas carries the argument (a list whose payoff
+is the last item, a build to a conclusion, before/after); a title, single
+quote, or diagram the audience should take in at a glance is stronger shown
+whole. Do not add reveals by default.
 Read the full target slide, keep its existing visual structure, and patch the
 complete ordered `animations` list with `elementPath` values from that exact
 HTML. Elements omitted from the list remain visible immediately, so labels and
@@ -300,23 +306,42 @@ children of `.fmd-slide`. Give each one a stable `data-slide-object-id`:
 </div>
 ```
 
-- Preserve `data-slide-object-id` when updating, moving, resizing, or styling an
-  existing object.
+- Preserve `data-slide-object-id` and the `left`/`top`/`width` of hand-placed
+  objects when updating, moving, resizing, or styling them.
 - Mint a new unique object ID when duplicating an object.
 - Do not use runtime-only `data-builder-id` values in saved slide HTML.
-- Keep generated flex and grid content in normal flow. Do not silently
-  absolute-position a nested layout child just to make it draggable; create a
-  deliberate freeform object instead.
+- A text box (`.fmd-text-box`) with no inline `height` auto-grows with its text
+  from the top edge.
 - Build editable shapes with styled HTML elements such as `div`. Do not use
   inline SVG, which the slide sanitizer removes.
 
+## Flow Layout and the Editor
+
+Keep generated flex and grid content in normal flow. Do not silently
+absolute-position a nested layout child just to make it draggable; create a
+deliberate freeform object instead. The editor presents flow content as flat
+objects the way Google Slides does, so write markup that maps cleanly:
+
+- A card is one painted box (background, border, or shadow on a single element)
+  that owns its text. Never stack separately positioned text over a card
+  background.
+- Text containers, including `.fmd-text-box`, have no fixed `height`
+  (`min-height` only for a deliberate minimum), so text grows instead of
+  overflowing. Never write `contain` or `contain-intrinsic-size`.
+- Keep nesting shallow. Unpainted wrappers with no direct text (grid rows,
+  columns) are fine; the pointer skips them.
+- Ids belong to freeform objects only. Never stamp `data-slide-object-id` on a
+  flow region: any id marks an object freeform and `export-pptx` rejects it.
+  Preserve existing ids when rewriting a slide.
+
 ## Image Placeholders
 
-For visual elements (diagrams, charts, photos), use placeholder divs:
+For visual elements (diagrams, charts, photos), use placeholder divs whose text
+names the content to show, not its role (see `create-deck` Image Placeholders):
 
 ```html
 <div class="fmd-img-placeholder" style="width: 100%; height: 300px; border-radius: 12px;">
-  Description of the image
+  Q3 revenue by region, bar chart
 </div>
 ```
 

package/corpus/templates/slides/AGENTS.md

@@ -13,6 +13,7 @@ Read relevant guides before deeper work:
 - `.agents/skills/image-generation-via-a2a/SKILL.md` — for A2A image generation.
 - `.agents/skills/design-systems/SKILL.md` — for deck design systems.
 - `.agents/skills/slide-design/SKILL.md` — for visual-craft requests.
+- `.agents/skills/apply-slide-comments/SKILL.md` — for applying/resolving comments.
 - `.agents/skills/creative-context/SKILL.md` — for source reuse and context.
 - `.agents/skills/analytics-data-for-decks/SKILL.md` — for delegated data requests.
 
@@ -45,8 +46,8 @@ Use local framework docs, not web research: `pnpm action docs-search --query "<t
 - UI feedback: target 100 ms, never exceed 400 ms; acknowledge before network work.
 - Use actions for deck/slide writes; keep large files in configured file storage, not SQL/settings/resources. Never hardcode secrets or private/customer data; use obvious placeholders.
 - For external integrations, inspect the workspace/provider connection catalog first; reuse its scoped resolver.
-- Use `view-screen` when the active deck/slide/layout is unclear. Preserve requested structure; do not restyle imports marked partial or with `imagesSkipped` without reporting the warning.
-- Preserve freeform objects and their ids. Keep generated flex/grid in normal flow and use styled HTML, not inline SVG; see `slide-editing`.
+- Use `view-screen` when the active deck/slide/layout is unclear, and on every turn that says "this"/"here"/"selected". Preserve requested structure; do not restyle imports marked partial or with `imagesSkipped` without reporting the warning.
+- Slide HTML layout, card, no-SVG, and freeform-id rules: `slide-editing`.
 - Import attachments only on request or via Import. `sourceImport` records provenance; structural edits clear it. Read preloaded new-deck attachments before deciding whether to import.
 - Provider API actions are shortcuts, not limits. For exact Drive API needs use `provider-api-catalog` / `-docs` / `-request` with the user's Google Docs OAuth. Preserve imported PPTX timing metadata.
 - For data requests, follow `analytics-data-for-decks` and delegate via Analytics/A2A; never query SQL or providers directly. Without a reference deck or design system, read `get-workspace-defaults` before generation; use `creative-context` for source order and context submission.

package/corpus/templates/slides/agent-native.app-skill.json

@@ -42,6 +42,11 @@
       "visibility": "both",
       "exportAs": "slide-editing"
     },
+    {
+      "path": ".agents/skills/apply-slide-comments",
+      "visibility": "both",
+      "exportAs": "apply-slide-comments"
+    },
     {
       "path": ".agents/skills/deck-management",
       "visibility": "internal"

package/corpus/templates/slides/app/components/editor/AlignmentGuides.tsx

@@ -32,8 +32,8 @@ export function AlignmentGuides({
     position: "fixed",
     pointerEvents: "none",
     zIndex: 70,
-    backgroundColor: "hsl(var(--destructive))",
-    boxShadow: "0 0 0 1px hsl(var(--destructive) / 0.2)",
+    // guard:allow-raw-color — Google Slides guides are literal #ff0000, theme-independent (interaction-oracle.md 9.2)
+    backgroundColor: "#ff0000",
   };
 
   return createPortal(