@salesforce/afv-skills 1.56.0 → 1.57.0

package/skills/service-agentforce-human-escalation-configure/scripts/tests/_bootstrap.py

@@ -6,12 +6,30 @@ import subprocess
 import tempfile
 from pathlib import Path
 
-# skills/ root is three levels up (.../<skill>/scripts/tests/_bootstrap.py).
+# skills/ root is three levels up (.../<skill>/scripts/tests/_bootstrap.py). In the flat copy
+# this is the repo's skills/ directory; in a plugin mirror it is that plugin's own bundled
+# skills/ directory, which only contains its own roster.
 SKILLS_ROOT = Path(__file__).resolve().parents[3]
 
+
+def _find_flat_skills_root(start: Path) -> Path:
+    """Walk up from this file to the repo's flat skills/ root, which bundles every skill
+    exactly once. Cross-skill references that aren't part of this skill's own plugin roster
+    (like the ITSM coordinator's verdict script below) must resolve here, not under
+    SKILLS_ROOT, since a plugin mirror's SKILLS_ROOT only contains its own bundled skills."""
+    for parent in start.parents:
+        candidate = parent / "skills" / "service-itsm-agentic-setup-agentforce-coordinate"
+        if candidate.is_dir():
+            return parent / "skills"
+    raise RuntimeError("could not locate the repo's flat skills/ root")
+
+
+FLAT_SKILLS_ROOT = _find_flat_skills_root(Path(__file__).resolve())
+
 SKILL_DIR = "service-agentforce-human-escalation-configure"
 SCRIPT = f"{SKILL_DIR}/scripts/verify-and-configure.sh"
-# The ITSM coordinator's advancement gate - exercised for the escalation verdict mapping.
+# The ITSM coordinator's advancement gate - exercised for the escalation verdict mapping. Not
+# bundled per-plugin, so resolved against FLAT_SKILLS_ROOT (see run_node's root parameter).
 VERDICT_SCRIPT = "service-itsm-agentic-setup-agentforce-coordinate/scripts/verify-child-verdict.mjs"
 
 # A fake `sf` that reports a PRODUCTION customer org so the safe_to_write guard must refuse.
@@ -220,11 +238,13 @@ def run(args, path_prefix=None, scrub_sf=False, extra_env=None):
     return proc.returncode, (proc.stdout or "") + (proc.stderr or "")
 
 
-def run_node(script_rel, args):
-    """Run a bundled Node helper; return (returncode, stdout)."""
+def run_node(script_rel, args, root=None):
+    """Run a bundled Node helper; return (returncode, stdout). Pass `root=FLAT_SKILLS_ROOT`
+    for cross-skill scripts not bundled in this skill's own plugin roster."""
+    base = root if root is not None else SKILLS_ROOT
     proc = subprocess.run(
-        ["node", str(SKILLS_ROOT / script_rel), *args],
-        capture_output=True, text=True, cwd=str(SKILLS_ROOT),
+        ["node", str(base / script_rel), *args],
+        capture_output=True, text=True, cwd=str(base),
     )
     return proc.returncode, (proc.stdout or "")
 

package/skills/service-agentforce-human-escalation-configure/scripts/tests/test_escalation_contracts.py

@@ -17,6 +17,7 @@ from pathlib import Path
 sys.path.insert(0, str(Path(__file__).resolve().parent))
 from _bootstrap import (  # noqa: E402
     SKILLS_ROOT,
+    FLAT_SKILLS_ROOT,
     SKILL_DIR,
     SCRIPT,
     VERDICT_SCRIPT,
@@ -700,13 +701,13 @@ class NgaClassifierHardeningTests(unittest.TestCase):
 
 class CoordinatorGateTests(unittest.TestCase):
     def test_escalation_verdict_mapping(self):
-        rc, out = run_node(VERDICT_SCRIPT, ["escalation", "CONFIGURED"])
+        rc, out = run_node(VERDICT_SCRIPT, ["escalation", "CONFIGURED"], root=FLAT_SKILLS_ROOT)
         self.assertEqual(rc, 0, out)
-        rc, _ = run_node(VERDICT_SCRIPT, ["escalation", "ALREADY-CONFIGURED"])
+        rc, _ = run_node(VERDICT_SCRIPT, ["escalation", "ALREADY-CONFIGURED"], root=FLAT_SKILLS_ROOT)
         self.assertEqual(rc, 0)
-        rc, _ = run_node(VERDICT_SCRIPT, ["escalation", "INCOMPLETE"])
+        rc, _ = run_node(VERDICT_SCRIPT, ["escalation", "INCOMPLETE"], root=FLAT_SKILLS_ROOT)
         self.assertEqual(rc, 1)
-        rc, _ = run_node(VERDICT_SCRIPT, ["escalation", "BLOCKED"])
+        rc, _ = run_node(VERDICT_SCRIPT, ["escalation", "BLOCKED"], root=FLAT_SKILLS_ROOT)
         self.assertEqual(rc, 1)
 
 

package/skills/service-de-waba-integrate/SKILL.md

@@ -1,12 +1,13 @@
 ---
 name: service-de-waba-integrate
-description: "Confirm the customer's WhatsApp Business Account is shared with Salesforce on Meta's side. Pure instruction + one user-confirmation prompt — no API calls, no token handling. The actual sharing happens in Meta Business Suite (UI-only; Meta provides no Graph endpoint to automate this step). Renders step-by-step instructions with Salesforce's Business Manager ID substituted in, then asks the user to confirm whether \"Salesforce\" appears in the WABA's Partners list."
+description: "Confirm the customer's WhatsApp Business Account is shared with Salesforce on Meta's side. TRIGGER when the user asks to link, share, or confirm sharing of a WhatsApp Business Account with Salesforce, or to verify Salesforce appears in the WABA's Partners list. Pure instruction + one user-confirmation prompt — no API calls, no token handling. Sharing happens in Meta Business Suite (UI-only; Meta has no Graph endpoint for this). Renders step-by-step instructions with Salesforce's Business Manager ID substituted in, then asks the user to confirm whether \"Salesforce\" appears in the WABA's Partners list. DO NOT TRIGGER when the user needs full end-to-end WhatsApp setup (use `service-de-headless-channel-configure`) or to insert the channel record itself (use `service-de-channel-create`)."
 metadata:
   version: "1.0"
   minApiVersion: "67.0"
   domains: ["Service"]
   relatedSkills:
     - "service-de-channel-create"
+    - "service-de-headless-channel-configure"
 ---
 
 # Linking a WABA to Salesforce

package/skills/service-digital-engagement-deployment-configure/SKILL.md

@@ -10,6 +10,8 @@ metadata:
     - "platform-permission-set-generate"
     - "service-digital-engagement-channel-configure"
   cliTools:
+    - tool: ["python3"]
+      semver: ">=3.8"
     - tool: ["sf"]
       semver: ">=2.0.0"
 ---

package/skills/service-digital-engagement-deployment-configure/scripts/check-api-version.sh

@@ -0,0 +1,29 @@
+#!/bin/bash
+# Verifies the target org's API version meets the minimum requirement.
+# Usage: check-api-version.sh <min-version> <org-alias>
+# Exits 0 if version >= min-version, exits 1 with error message otherwise.
+
+MIN_VERSION="${1:?Usage: check-api-version.sh <min-version> <org-alias>}"
+ORG_ALIAS="${2:?Usage: check-api-version.sh <min-version> <org-alias>}"
+
+API_VERSION=$(sf org display --target-org "$ORG_ALIAS" --json 2>/dev/null | python3 -c "
+import json, sys
+try:
+    data = json.load(sys.stdin)
+    print(data.get('result', {}).get('apiVersion', ''))
+except Exception:
+    print('')
+")
+
+if [ -z "$API_VERSION" ]; then
+  echo "ERROR: Could not determine API version for org '$ORG_ALIAS'."
+  exit 1
+fi
+
+if python3 -c "import sys; sys.exit(0 if float(sys.argv[1]) >= float(sys.argv[2]) else 1)" "$API_VERSION" "$MIN_VERSION"; then
+  echo "OK: Org API version $API_VERSION meets minimum $MIN_VERSION."
+  exit 0
+else
+  echo "ERROR: Org API version $API_VERSION is below minimum $MIN_VERSION. Generate a sfdx-project.json with \"sourceApiVersion\": \"$MIN_VERSION\" in the metadata output folder."
+  exit 1
+fi

package/skills/service-email-to-case-configure/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: service-email-to-case-configure
-description: "Use to configure Salesforce Email-to-Case in a headless flow via the Metadata API. Reads the current CaseSettings, applies the desired emailToCase configuration with the updateMetadata CRUD call, and verifies by re-reading. Also the entry point when the user wants an Agentforce service agent on Email-to-Case: this skill configures the E2C base, then delegates agent creation and channel wiring. Start here even when no agent exists yet. TRIGGER when the user says set up Email-to-Case, configure email to case, enable Email-to-Case routing addresses, add an email routing address, Email-to-Case Metadata API, or set up Email-to-Case with an Agentforce service agent (attach an agent to an email routing address). DO NOT TRIGGER when the user needs the interactive Service Easy Setup wizard for E2cEasy addresses, when configuring On-Demand Email-to-Case only, for general Case object or web-to-case setup, or when only creating an Agentforce agent with no Email-to-Case involved."
+description: "Use to configure Salesforce Email-to-Case headlessly via the Metadata API. Reads CaseSettings, applies the emailToCase config with updateMetadata, and verifies by re-reading. Also the entry point for attaching an Agentforce agent to Email-to-Case: configures the E2C base, then delegates agent creation and channel wiring. TRIGGER on set up/configure Email-to-Case, enable E2C routing addresses, add a routing address, or E2C with an Agentforce agent. DO NOT TRIGGER for the interactive Easy Setup wizard, On-Demand E2C only, general Case/web-to-case setup, or an agent with no E2C involved."
 metadata:
   version: "1.1"
   domains: ["Service", "Agentforce"]